单位和全局变量

原文链接
date:20170706

以太单位

一个整数字面量可以添加wei，finney，szabo或者ether单位，用于ether面值之间的转换。以太货币数字没有添加后缀的时候，默认是Wei。2 ehter == 2000 finney表达式为true.

时间单位

时间单位，如seconds，minutes，hours，days，weeks和years，用来进行时间转换。seconds是基本单位，各单位之间的转换如下所示：

• 1 == 1 seconds
• 1 minutes == 60 seconds
• 1 hours == 60 minutes
• 1 days = 24 hours
• 1 weeks == 7 days
• 1 years == 365 days

如果你要对日历进行操作的时候，要特别小心了。因为不是每一年都是365天，而且如果有闰秒的时候，每天也不是24小时。由于闰秒不可以预测，日历库应该根据权威信息来更新。（？Due to the fact that leap seconds cannot be predicted, an exact calendar library has to be updated by an external oracle.）

这些单位不能用在变量中。如果你想要对输入变量通过某个单位-比如说是days-来解释，可以通过下面的方法：

function f(uint start, uint daysAfter) {
    if (now >= start + daysAfter * 1 days) { ... }
}

特殊变量和函数

在全局环境中，存在一些特殊变量和函数，主要用于提供区块链的信息。

区块和交易特性

• block.blockhash(uint blockNumber) returns (bytes32):所给的区块的hash，只能在最近的256块(包括当前块)有用。
• block.coinbasse(address):当前块矿工地址
• block.difficulty(address）:当前块难度
• block.gaslimit(uint):当前块gas限制
• block.number（uint）:当前块序号
• block.timestamp（uint）:当前块unix时间戳，单位为秒
• msg.data（bytes）:所有calldata
• msg.gas(uint):剩余gas
• msg.sender(address):当前块的消息发送者
• msg.sig(bytes4):calldata的前四个字节（例如： 函数识别码）
• msg.value(uint):与消息一同发送的wei数量
• now(uint)：当前的区块链时间（是block.timestamp的别名）
• tx.gasprice(uint):交易的gas价格
• tx.origin（address）：获得交易的发起方（full call chain）

**注意：msg的所有成员函数的值，包括msg.sender和msg.value可以被外部函数调用所改变。包括调用库函数。
如果你想实现库函数对msg.sender的访问限制，你只能作为参数返回msg.sender的值。（？If you want to implement access restrictions in library functions using msg.sender, you have to manually supply the value of msg.sender as an argument.）
**

注意：由于可测量性原因，并不能获取所有区块的哈希值。只能获取到最近的256个区块。其他值将会是0

错误处理

assert(bool condition):
如果条件不满足会抛出异常，用于内部错误处理。
require(bool condition):
如果条件不满足会抛出异常，用于输入和外部组件。
revert()：
终止代码执行，并回滚状态改变。

数学和加密函数

addmod(uint x,uint y, uintk) returns (uint):
计算(x + y) % k，其中加法采用任意精度的，and dos not wrap around at 2**256。

mulmod(uint x, uint y, uint k) returns (uint):
计算(x * y) % k，其中乘法采用任意精度的，and dos not wrap around at 2**256。

keccak256(...) returns (bytes32):
计算（打包好的 ？tightly packed）参数的以太坊SHA-3（Keccak-256）hash。

sha3(...) returns (bytes32):
keccak256()的别名

sha256(...) returns (bytes32):
计算（打包好的 ？tightly packed）参数的SHA-256 hash。

ripemd160(...) returns (bytes20):
计算（打包好的 ？tightly packed）参数的RIPEMD-160 hash。

ecrecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) returns (address):
返回与椭圆曲线签名后的key相关的地址，如果错误返回0（使用案例）
（？recover the address associated with the public key from elliptic curve signature or return zero on error）

以上所述，“打包好的（？tighly packed）”的意思是参数没有填充的串联起来。意味着以下的语句都是一致的：

keccak256("ab", "c")
keccak256("abc")
keccak256(0x616263)
keccak256(6382179)
keccak256(97, 98, 99)

如果需要填充，可以使用特定类型转换:keccak256("\x00\x12")和keccak256(uint16(0x12))是一致的。

注意常量会使用最小字节的存储来打包。这意味着keccak256(0) == keccak256(uint8(0))和keccak256(0x12345678) == keccak256(uint32(0x12345678))。

如果在私有链中使用sha256，ripemd160或者ecrecover函数可能导致gas不足。这个问题的原因是因为这些函数是通过预编译合约来实现的。这些合约只是会在它们收到第一次信息之后生效（尽管这些代码是硬代码）。如果给不存在的合约发送信息的代价是很昂贵的，可能会引起gas不足错误。一个变通的方法是在使用合约之前首先发送1Wei给每个合约。这个问题在测试网络和正式网络中并不存在。

地址相关

<address>.balance(uint256):给定[地址][adress]的余额，单位为Wei
<address>.transfer(uint256 amount):
发送给定的金额给给定的地址，如果失败抛出异常。
<address>.send(uint256 amount) returns (bool):
发送给定的金额给给定的地址，如果失败返回false。
<address>.call(...) returns (bool):
发布低级别CALL，执行失败返回false.
<address>.callcode(...) returns (bool):
发布低级别CALLCODE，执行失败返回false.
<address>.delegatecall(...) returns (bool)
发布低级别DELEGATECALL，执行失败返回false.

更多信息，参看地址章节。

警告：使用send的时候会有些危险：如果栈深度大于1024的时候（this can always be forced by the caller）会交易失败，并且如果gas不足也会导致失败。所以如果要进行安全的以太币交易，要检查函数返回值。或者使用transfer，或者使用更好的方法：使用一种模式，接受者可以取回以太币

合约相关

this(当前合约类型)：
当前合约，可以显式转换为地址。
selfdestruct(address recipient):取消当前合约，并将剩余金额发送给给定地址。

另外，当前合约的所有函数可以在当前合约中直接调用。