单位和全局变量

原文链接
date:20170706

以太单位

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

时间单位

时间单位,如secondsminuteshoursdaysweeksyears,用来进行时间转换。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.numberuint):当前块序号
  • block.timestampuint):当前块unix时间戳,单位为秒
  • msg.databytes):所有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.originaddress):获得交易的发起方(full call chain)

**注意:msg的所有成员函数的值,包括msg.sendermsg.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))

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

地址相关

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

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

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

合约相关

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

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

你可能感兴趣的:(单位和全局变量)