速查表

运算符的优先级

以下是运算符的优先级顺序,按求值顺序列出。

Precedence

Description

Operator

1

Postfix increment and decrement

++, --

New expression

new <typename>

Array subscripting

<array>[<index>]

Member access

<object>.<member>

Function-like call

<func>(<args...>)

Parentheses

(<statement>)

2

Prefix increment and decrement

++, --

Unary minus

-

Unary operations

delete

Logical NOT

!

Bitwise NOT

~

3

Exponentiation

**

4

Multiplication, division and modulo

*, /, %

5

Addition and subtraction

+, -

6

Bitwise shift operators

<<, >>

7

Bitwise AND

&

8

Bitwise XOR

^

9

Bitwise OR

|

10

Inequality operators

<, >, <=, >=

11

Equality operators

==, !=

12

Logical AND

&&

13

Logical OR

||

14

Ternary operator

<conditional> ? <if-true> : <if-false>

Assignment operators

=, |=, ^=, &=, <<=, >>=, +=, -=, *=, /=, %=

15

Comma operator

,

ABI 编码和解码函数

  • abi.decode(bytes memory encodedData, (...)) returns (...): ABI-解码提供的数据。类型在括号中作为第二个参数给出。 示例: (uint a, uint[2] memory b, bytes memory c) = abi.decode(data, (uint, uint[2], bytes))

  • abi.encode(...) returns (bytes memory): ABI-编码给定的参数

  • abi.encodePacked(...) returns (bytes memory): 对给定参数执行 packed encoding。请注意,这种编码可能会产生歧义!

  • abi.encodeWithSelector(bytes4 selector, ...) returns (bytes memory): ABI-编码给定的参数,从第二个参数开始,并在前面添加给定的四字节选择器

  • abi.encodeCall(function functionPointer, (...)) returns (bytes memory): ABI-编码对 functionPointer 的调用,参数在元组中找到。执行完整的类型检查,确保类型与函数签名匹配。结果等于 abi.encodeWithSelector(functionPointer.selector, ...)

  • abi.encodeWithSignature(string memory signature, ...) returns (bytes memory): 等同于 abi.encodeWithSelector(bytes4(keccak256(bytes(signature))), ...)

bytesstring 的成员

address 的成员

  • <address>.balance (uint256): 地址类型 的余额,以 Wei 为单位

  • <address>.code (bytes memory): 地址类型 的代码(可以为空)

  • <address>.codehash (bytes32): 地址类型 的代码哈希

  • <address>.call(bytes memory) returns (bool, bytes memory): 使用给定有效载荷发出低级 CALL,返回成功条件和返回数据

  • <address>.delegatecall(bytes memory) returns (bool, bytes memory): 使用给定有效载荷发出低级 DELEGATECALL,返回成功条件和返回数据

  • <address>.staticcall(bytes memory) returns (bool, bytes memory): 使用给定有效载荷发出低级 STATICCALL,返回成功条件和返回数据

  • <address payable>.send(uint256 amount) returns (bool): 向 地址类型 发送给定数量的 Wei,失败时返回 false

  • <address payable>.transfer(uint256 amount): 向 地址类型 发送给定数量的 Wei,失败时抛出异常

区块和交易属性

  • blockhash(uint blockNumber) returns (bytes32): 给定区块的哈希 - 仅适用于最近的 256 个区块

  • blobhash(uint index) returns (bytes32): 与当前交易关联的 index-th blob 的版本哈希。 版本哈希由一个表示版本的单字节(当前为 0x01)和 KZG 承诺的 SHA256 哈希的最后 31 字节组成(EIP-4844)。 如果不存在具有给定索引的 blob,则返回零。

  • block.basefee (uint): 当前区块的基础费用(EIP-3198EIP-1559

  • block.blobbasefee (uint): 当前区块的 blob 基础费用(EIP-7516EIP-4844

  • block.chainid (uint): 当前链 ID

  • block.coinbase (address payable): 当前区块矿工的地址

  • block.difficulty (uint): 当前区块的难度(EVM < Paris)。对于其他 EVM 版本,它作为 block.prevrandao 的已弃用别名,将在下一个重大版本中删除

  • block.gaslimit (uint): 当前区块的 gas 限制

  • block.number (uint): 当前区块编号

  • block.prevrandao (uint): 由信标链提供的随机数(EVM >= Paris)(见 EIP-4399

  • block.timestamp (uint): 自 Unix 纪元以来的当前区块时间戳(以秒为单位)

  • gasleft() returns (uint256): 剩余 gas

  • msg.data (bytes): 完整的 calldata

  • msg.sender (address): 消息的发送者(当前调用)

  • msg.sig (bytes4): calldata 的前四个字节(即函数标识符)

  • msg.value (uint): 随消息发送的 wei 数量

  • tx.gasprice (uint): 交易的 gas 价格

  • tx.origin (address): 交易的发送者(完整调用链)

验证和断言

  • assert(bool condition): 如果条件为 false,则中止执行并回滚状态更改(用于内部错误)

  • require(bool condition): 如果条件为 false,则中止执行并回滚状态更改(用于格式错误的输入或外部组件中的错误)

  • require(bool condition, string memory message): 如果条件为 false,则中止执行并回滚状态更改(用于格式错误的输入或外部组件中的错误)。同时提供错误消息。

  • revert(): 中止执行并回滚状态更改

  • revert(string memory message): 中止执行并回滚状态更改,提供解释字符串

数学和加密函数

  • keccak256(bytes memory) returns (bytes32): 计算输入的 Keccak-256 哈希

  • sha256(bytes memory) returns (bytes32): 计算输入的 SHA-256 哈希

  • ripemd160(bytes memory) returns (bytes20): 计算输入的 RIPEMD-160 哈希

  • ecrecover(bytes32 hash, uint8 v, bytes32 r, bytes32 s) returns (address): 从椭圆曲线签名中恢复与公钥关联的地址,出错时返回零

  • 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 (uint): 计算 (x * y) % k,其中乘法以任意精度执行,并且在 2**256 时不会溢出。从版本 0.5.0 开始,断言 k != 0

与合约相关

  • this (当前合约的类型): 当前合约,显式可转换为 addressaddress payable

  • super: 继承层次结构中一个级别更高的合约

  • selfdestruct(address payable recipient): 将所有资金发送到给定地址,并(仅在 Cancun 之前的 EVM 或在创建合约的交易中调用时)销毁合约。

类型信息

  • type(C).name (string): 合约的名称

  • type(C).creationCode (bytes memory): 给定合约的创建字节码,见 类型信息

  • type(C).runtimeCode (bytes memory): 给定合约的运行时字节码,见 类型信息

  • type(I).interfaceId (bytes4): 包含给定接口的 EIP-165 接口标识符的值,见 类型信息

  • type(T).min (T): 整数类型 T 可表示的最小值,见 类型信息

  • type(T).max (T): 整数类型 T 可表示的最大值,见 类型信息

函数可见性说明符

function myFunction() <visibility specifier> returns (bool) {
    return true;
}
  • public: 在外部和内部可见(为存储/状态变量创建 getter 函数

  • private: 仅在当前合约中可见

  • external: 仅在外部可见(仅适用于函数) - 即只能通过消息调用(通过 this.func

  • internal: 仅在内部可见

修改器

  • pure 用于函数: 不允许修改或访问状态。

  • view 用于函数: 不允许修改状态。

  • payable 用于函数: 允许它们在调用时接收以太币。

  • constant 用于状态变量: 不允许赋值(除初始化外),不占用存储槽。

  • immutable 用于状态变量: 允许在构造时赋值,并在部署时保持不变。存储在代码中。

  • anonymous 用于事件: 不将事件签名存储为主题。

  • indexed 用于事件参数: 将参数存储为主题。

  • virtual 用于函数和修改器: 允许在派生合约中更改函数或修改器的行为。

  • override: 表示此函数、修改器或公共状态变量更改了基合约中函数或修改器的行为。