Solidity语言学习(7) —— 单位和全局变量

以太币单位

以太币单位之间的换算就是在数字后边加上 wei、finney、 szabo、或ether来实现的，如果后面没有单位，缺省为Wei。例如 2ether == 200finney 的逻辑判断为true。

时间单位

秒是缺省时间单位，在时间单位之间，数字后面带有 seconds、minutes、hours、days、weeks和years的可以进行换算。
由于闰秒造成的每年不都是365天，每天不都是24小时，所以如果要使用这些单位计算日期和事件，需要注意这个问题。因为闰秒是无法预测的，所以需要借助外部的语言及（oracle，是一种链外数据服务）来对一个精确的日期库进行更新。

note：
基于上述原因 years 前缀已经不再推荐使用了。

这些后缀不能直接用在变量后边。如果想用时间单位（例如 days）来将输入变量换算为时间，你可以用如下方式来完成：

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

特殊变量和函数

在全局命名空间中已经存在了（预设了）一些特殊的变量和函数，他们主要用来提供关于区块链的信息。

区块和交易属性

• block.blockhash(uint blockNumber) returns (butes32):给定区块的哈希 —— 仅对最近的256个区块有效而不包括当前区块
• block.coinbase (address): 挖出当前区块的矿工地址（括号里的不是参数而是该值的类型，下同）
• block.difficulty (uint):当前区块难度
• block.gaslimit (uint): 当前区块的gas限额
• block.number (uint):当前区块号
• block.timestamp (uint): 自 unix epoch起始当前区块以秒记的时间戳
• gasleft() returns(uint256):剩余的gas
• msg.data (bytes): 完整的 calldata
• msg.gas (uint):剩余的gas
• msg.sender (address):消息发送者（当前调用）
• msg.sig (uint): calldata的前四字节（也就是函数标识符）
• msg.value (uint):随消息发送的 wei 数量
• now (uint):目前区块时间戳（ block.timestamp)
• tx.gasprice (uint): 交易的 gas 价格
• tx.origin (address): 交易发起者（完全的调用链）

注意：
1.对于每一个 外部函数 调用，包括 msg.sender和 msg.value 在内所有 msg 成员都会变化。这里包括对库函数的调用。
2.不要依赖 block.timestamp、now 和 block.blockhash(uint blockNumber) 产生随机数，除非你知道自己在做什么。
时间戳和区块哈希在一定程度上都可能收到挖矿矿工的影响。比如说，挖矿社区中的恶意矿工可以用某个给定的哈希来运行赌场合约中的payout函数，而如果他们没收到钱，还可以用一个不同的哈希重新尝试。
当前区块的时间戳必须严格大于最后一个区块的时间戳，但这里唯一能确保的只是它会是在权威链上的两个连续区块的时间戳之间的数值
3.基于可扩展的因素，区块哈希不是对所有区块都有效。你仅仅可以访问最近的256个区块的哈希，其余的哈希均为0

ABI编码函数

• abi.encode(...) returns (bytes):返回给定参数的ABI编码
• abi.encodePacked(...) returns (bytes): 对给定参数进行打包的编码
• abi.encodeWithSelector(bytes4 selector,...) returns (bytes):对从第二个参数开始的给定参数进行ABI编码，并以第一个参数作为返回结果的前4字节——即用第一个参数作为函数选择器（function selector），仅对其余参数进行ABI 编码。
• abi.encodeWithSignature(string signature,..) returns (bytes): 作用等同于abi.encodeWithSelector(bytes4 selector,...) returns (bytes)

note：
以上的编码函数均可以用于基于函数调用的数据产生ABI编码，而不会实际调用一个函数。此外，keccak256(abi.encodePacked(a, b)) 是计算 keccak256(a, b) 的更明确的方式，后者在未来的版本中不再推荐使用。
后面还会涉及到关于ABI编码的部分

错误处理

• asser（bool condition):如果条件不满足则是交易不产生实际效果 ——　用于内部错误。
• require(bool condition): 如果条件不满足则恢复（revert） —— 用于输入或者外部组件引起的错误，同时提供一个错误消息。
• require（bool condition,string message): 如果条件不满足则恢复（revert） —— 用于输入或者外部组件引起的错误，同时提供一个错误信息。
• revert():终止运行并恢复（revert）状态（state） 变动
• revert(string reason):终止运行并恢复状态变动，并提供一个字符信息来解释原因。

数学和密码学函数

• addmod(uint x ,uint y,uint k) returns (uint):计算 （x+y）% k，加法会在任意精度下执行，并且加法的结果即使超过 2**256 也不会截取。从 0.5.0 版本的编译器开始会加入对 k ！= 0 的校验。
• mulmod(uint x,uint y,uint k) returns (uin):计算 （x * y） %k，乘法会在任意精度下执行，并且乘法的结果即使超过 2**256 也不会被截取。
• keccak256(...) returns (bytes32):计算“紧打包”参数（参加后续的“应用二进制编码说明”一章）的Ethereum-SHA-3 （keccak-256）哈希。
• sha256(...) returns (bytes32):计算“紧打包”参数的SHA-256哈希。
• sha3(...) returns (bytes32):等价于 keccak256.
• ripemd160(...) returns (bytes20):计算“紧打包”参数的RIPEMD-160哈希。
• ecrecover(bytes32 hash, uint8 v, bytes32 r,bytew32 s) returns (address):利用椭圆曲线签名恢复与公钥相关的地址，错误返回0值。

上文中的紧打包（tightly packed） “是指不会把参数值进行padding处理（就是说所有参数值的字节码是连续存放的，中间不保留为把长度补充为一个”字“，即32字节，而追加的若干0值字节数据）这意味着下面的这些调用是等价的：

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

如果需要 padding，可以使用显示类型转换：keccak256（”\x00\x12") 和 keccak256(uint6(0x12))是一样的.

请注意,常量值会使用存储他们所需要的最少字节数进行打包.比如:keccak256(0) == keccak256(uint8(0)),keccak256(0x12345678) == keccak256(uint32(0x12345678)).

在一个私链上,你很有可能碰到由于 sha256, ripemd160 或者 ecrecover 引起的gas用尽问题.这个原因就是他们被当做所谓的预编译合约而执行,并且第一次收到消息后这些合约才真正存在(尽管合约代码是硬编码).发送到不存在的合约的消息非常昂贵,所以实际的执行会导致out - of - gas错误.在你的合约中实际使用他们之前,给每个合约发送一点儿以太币,比如 1 wei.这在官方网络或测试网络上 都不是问题.(读不懂)

地址相关

• .balance (uint256): 以Wei为单位的某个地址(address)的余额.
• .transfer(uint256 amount):向某个地址(address)发送数量为amount的Wei,失败时抛出异常,且将额外发送2300 gas的旷工费,不可调整.
• .send(uint256 amount) returns (bool):想某个地址(address)发送数量为amount的Wei,失败时返回false,且将额外发送2300gas的矿工费用,不可调整.
• .call(...) returns (bool): 执行低级函数CALL ,失败时返回 false,会发送所有可用的 gas,不可调整.
• .callcode(...) returns (bool):执行低级函数 CALLCODE,失败时返回 false,会发送所有可用的gas,不可调整.
• .delegatecall(...) returns (bool)：执行低级函数 DELEGATECALL, 失败是返回 false,会发送所有可用的gas,不可调整.

warning:
使用send会有很多危险:如果调用栈深度已经达到1024(这总是可以由调用者所强制指定),转账会失败;并且如果接受者用光了gas,转账同样会失败.为了保证以太币转账安全,总是检查 send 的返回值,利用 transfer 或者后文中更好的方式:使用一种由接受者取回资金的模式.

note:
如果通过一个低级函数 delegatecall 来访问一个storage 变量,两个合约存储中的数据布局(位置)必须一致,以保证可以在调用的合约中通过变量名正确地访问到调用合约中的存储变量.这当然不是在高级的库中通过函数参数传递存储指针那种情况.
不鼓励使用callcode,并且将来他会被移除.

合约相关

• this (current contract’s type):当前合约,可以明确转换为某个地址(address).
• selfdestruct(address recipient):销毁合约,并把余额发送到指定的地址(address)
• suicide(address recipient):等价于 selfdestruct.

此外,当前合约内地所有函数都可以被直接调用,包括当前函数.