チートシート
演算子の優先順位
演算子の優先順位を評価順に並べると以下のようになります。
優先順位 |
説明 |
演算子 |
---|---|---|
1 |
後置インクリメントとデクリメント |
|
New式 |
|
|
配列添字アクセス |
|
|
メンバアクセス |
|
|
関数的呼び出し |
|
|
括弧 |
|
|
2 |
前置インクリメントとデクリメント |
|
単項マイナス |
|
|
単項演算子 |
|
|
論理否定 |
|
|
ビット単位の否定 |
|
|
3 |
累乗 |
|
4 |
乗算、除算、剰余 |
|
5 |
加算、減算 |
|
6 |
ビット単位のシフト演算 |
|
7 |
ビット単位のAND |
|
8 |
ビット単位のXOR |
|
9 |
ビット単位のOR |
|
10 |
不等号演算子 |
|
11 |
等号演算子 |
|
12 |
論理AND |
|
13 |
論理OR |
|
14 |
三項演算子 |
|
代入演算子 |
|
|
15 |
カンマ演算子 |
|
ABIのエンコード関数とデコード関数
abi.decode(bytes memory encodedData, (...)) returns (...)
: 与えたデータを ABI デコードします。 型は第2引数として括弧内に与えられます。 例(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)
: 与えた引数を2番目から順に ABI エンコードし、与えた4バイトのセレクタを前に付加します。abi.encodeCall(function functionPointer, (...)) returns (bytes memory)
: タプルに含まれる引数を用いてfunctionPointer
の呼び出しをABIエンコードします。 完全な型チェックを行い、型が関数のシグネチャと一致することを保証します。 結果はabi.encodeWithSelector(functionPointer.selector, (...))
に等くなります。abi.encodeWithSignature(string memory signature, ...) returns (bytes memory)
:abi.encodeWithSelector(bytes4(keccak256(bytes(signature))), ...)
と同等です。
bytes
と string
のメンバー
bytes.concat(...) returns (bytes memory)
: 可変個の引数を1つのバイト配列に連結します 。string.concat(...) returns (string memory)
: 可変個の引数を1つの文字列に連結します 。
address
のメンバー
<address>.balance
(uint256
): アドレス の残高(Wei)<address>.code
(bytes memory
): アドレス のコード(空にもなり得る)<address>.codehash
(bytes32
): アドレス のコードハッシュ<address payable>.send(uint256 amount) returns (bool)
: 指定した量のWeiを アドレス に送り、失敗したらfalse
を返します。<address payable>.transfer(uint256 amount)
: 指定した量のWeiを アドレス に送り、失敗したらリバートします。
ブロックとトランザクションのプロパティ
blockhash(uint blockNumber) returns (bytes32)
: 指定したブロックのハッシュ。最新の256ブロックに対してのみ動作します。block.basefee
(uint
): カレントブロックのベースフィー(base fee)( EIP-3198 と EIP-1559 )。block.chainid
(uint
): カレントブロックのチェーンID。block.coinbase
(address payable
): カレントブロックのマイナーのアドレス。block.difficulty
(uint
): カレントブロックの難易度(EVM < Paris
)。 EVMの他のバージョンでは、block.prevrandao
の非推奨のエイリアスとして動作し、次のブレーキングリリースで削除される予定です。block.gaslimit
(uint
): カレントブロックのガスリミット。block.number
(uint
): カレントブロックの番号。block.prevrandao
(uint
): ビーコンチェーンが提供する乱数(EVM < Paris
)。 EIP-4399 を参照してください。block.timestamp
(uint
): Unixエポックからのカレントブロックのタイムスタンプ(秒)。gasleft() returns (uint256)
: 残りのガス。msg.data
(bytes
): 完全なコールデータ。msg.sender
(address
): メッセージの送信者(現在のコール)。msg.sig
(bytes4
): コールデータの最初の4バイト(すなわち関数識別子)。msg.value
(uint
): メッセージと一緒に送られたweiの数。tx.gasprice
(uint
): トランザクションのガスプライス。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)
: 楕円曲線署名から公開鍵に関連したアドレスをリカバリーします。エラー時は0を返します。addmod(uint x, uint y, uint k) returns (uint)
: 任意の精度で加算が実行され、2**256
で切り捨てられない(x + y) % k
を計算します。バージョン0.5.0からk != 0
であることをアサートします。mulmod(uint x, uint y, uint k) returns (uint)
: 任意の精度で乗算が実行され、2**256
で切り捨てられない(x * y) % k
を計算します。バージョン0.5.0からk != 0
であることをアサートします。
コントラクト関連
this
(現在のコントラクトの型): 現在のコントラクトで、address
またはaddress payable
に明示的に変換できるもの。super
: 継承階層の1つ上の階層のコントラクト。selfdestruct(address payable recipient)
: 現在のコントラクトを破棄し、その資金を指定されたアドレスに送ります。
型情報
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
: 外部にも内部にも見えます(ストレージ/状態変数の ゲッター関数 を作成する)。private
: 現在のコントラクトでのみ見えます。external
: 外部にしか見えません(関数のみ)。つまり、メッセージコールしかできません(this.func
経由)。internal
: 内部でのみ見えます。
モディファイア
関数の
pure
: 状態の変更やアクセスを禁止します。関数の
view
: 状態の変更を不可とします。関数の
payable
: コールと同時にEtherを受信できるようにします。状態変数の
constant
: 初期化を除き、代入を禁止し、ストレージスロットを占有しません。状態変数の
immutable
: コンストラクション時に正確に1つの代入を可能にし、その後は一定です。コードに格納されます。イベントの
anonymous
: イベントのシグネチャをトピックとして保存しません。イベントパラメータの
indexed
: パラメータをトピックとして保存します。関数やモディファイアの
virtual
: 関数やモディファイアの動作を派生コントラクトで変更できるようにします。override
: この関数、モディファイア、パブリックの状態変数が、ベースコントラクト内の関数やモディファイアの動作を変更することを示します。