原文链接
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)
:取消当前合约,并将剩余金额发送给给定地址。
另外,当前合约的所有函数可以在当前合约中直接调用。