--- title: "EVM 操作碼" description: "以太坊虛擬機所有可用操作碼的列表。" lang: zh-tw --- ## 概覽 這是 [wolflo/evm-opcodes](https://github.com/wolflo/evm-opcodes) EVM 參考頁面的更新版本。 內容也取材自[黃皮書](https://ethereum.github.io/yellowpaper/paper.pdf)、[Jello Paper](https://jellopaper.org/evm/) 以及 [geth](https://github.com/ethereum/go-ethereum) 實作。 這旨在成為一份易於理解的參考資料，但並非特別嚴謹。 如果你想確保正確性並了解每個邊緣情況，建議使用 Jello Paper 或客戶端實作。 正在尋找互動式參考資料？請查看 [evm.codes](https://www.evm.codes/)。 對於具有動態燃料成本的操作，請參閱 [gas.md](https://github.com/wolflo/evm-opcodes/blob/main/gas.md)。 💡 小提示：若要檢視完整行，請在桌上型電腦上使用 `[shift] + 捲動` 進行水平捲動。 | 堆疊 | 名稱 | 燃料 | 初始堆疊 | 結果堆疊 | 記憶體 / 儲存空間 | 備註 | | :---: | :------------- | :---------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------- | :------------------------------ | :---------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------- | | 00 | STOP | 0 | | | | 停止執行 | | 01 | ADD | 3 | `a, b` | `a + b` | | (u)int256 加法，對 2**256 取模 | | 02 | MUL | 5 | `a, b` | `a * b` | | (u)int256 乘法，對 2**256 取模 | | 03 | SUB | 3 | `a, b` | `a - b` | | (u)int256 減法，對 2**256 取模 | | 04 | DIV | 5 | `a, b` | `a // b` | | uint256 除法 | | 05 | SDIV | 5 | `a, b` | `a // b` | | int256 除法 | | 06 | MOD | 5 | `a, b` | `a % b` | | uint256 取模 | | 07 | SMOD | 5 | `a, b` | `a % b` | | int256 取模 | | 08 | ADDMOD | 8 | `a, b, N` | `(a + b) % N` | | (u)int256 加法，對 N 取模 | | 09 | MULMOD | 8 | `a, b, N` | `(a * b) % N` | | (u)int256 乘法，對 N 取模 | | 0A | EXP | [A1](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a1-exp) | `a, b` | `a ** b` | | uint256 指數，對 2**256 取模 | | 0B | SIGNEXTEND | 5 | `b, x` | `SIGNEXTEND(x, b)` | | 將 `x` 從 `(b+1)` 個位元組[符號擴展](https://wikipedia.org/wiki/Sign_extension)至 32 個位元組 | | 0C-0F | _無效_ | | 10 | LT | 3 | `a, b` | `a < b` | | uint256 小於 | | 11 | GT | 3 | `a, b` | `a > b` | | uint256 大於 | | 12 | SLT | 3 | `a, b` | `a < b` | | int256 小於 | | 13 | SGT | 3 | `a, b` | `a > b` | | int256 大於 | | 14 | EQ | 3 | `a, b` | `a == b` | | (u)int256 等於 | | 15 | ISZERO | 3 | `a` | `a == 0` | | (u)int256 為零 | | 16 | AND | 3 | `a, b` | `a && b` | | 位元 AND | | 17 | OR | 3 | `a, b` | `a || b` | | 位元 OR | | 18 | XOR | 3 | `a, b` | `a ^ b` | | 位元 XOR | | 19 | NOT | 3 | `a` | `~a` | | 位元 NOT | | 1A | BYTE | 3 | `i, x` | `(x >> (248 - i * 8)) && 0xFF` | | (u)int256 `x` 從左邊算起的第 `i` 個位元組 | | 1B | SHL | 3 | `shift, val` | `val << shift` | | 左移 | | 1C | SHR | 3 | `shift, val` | `val >> shift` | | 邏輯右移 | | 1D | SAR | 3 | `shift, val` | `val >> shift` | | 算術右移 | | 1E-1F | _無效_ | | 20 | KECCAK256 | [A2](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a2-sha3) | `ost, len` | `keccak256(mem[ost:ost+len-1])` | | keccak256 | | 21-2F | _無效_ | | 30 | ADDRESS | 2 | `.` | `address(this)` | | 執行中合約的地址 | | 31 | BALANCE | [A5](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a5-balance-extcodesize-extcodehash) | `addr` | `addr.balance` | | 餘額，單位為 Wei | | 32 | ORIGIN | 2 | `.` | `tx.origin` | | 發起交易的地址 | | 33 | CALLER | 2 | `.` | `msg.sender` | | 訊息發送者的地址 | | 34 | CALLVALUE | 2 | `.` | `msg.value` | | 訊息值，單位為 Wei | | 35 | CALLDATALOAD | 3 | `idx` | `msg.data[idx:idx+32]` | | 從索引 `idx` 處的訊息資料讀取字組 | | 36 | CALLDATASIZE | 2 | `.` | `len(msg.data)` | | 訊息資料長度，單位為位元組 | | 37 | CALLDATACOPY | [A3](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a3-copy-operations) | `dstOst, ost, len` | `.` | mem[dstOst:dstOst+len-1] := msg.data[ost:ost+len-1] | 複製訊息資料 | | 38 | CODESIZE | 2 | `.` | `len(this.code)` | | 執行中合約的程式碼長度，單位為位元組 | | 39 | CODECOPY | [A3](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a3-copy-operations) | `dstOst, ost, len` | `.` | | mem[dstOst:dstOst+len-1] := this.code[ost:ost+len-1] | 複製執行中合約的位元組碼 | | 3A | GASPRICE | 2 | `.` | `tx.gasprice` | | 交易的 Gas 價格，單位為每單位燃料的 Wei [**](https://eips.ethereum.org/EIPS/eip-1559#gasprice) | | 3B | EXTCODESIZE | [A5](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a5-balance-extcodesize-extcodehash) | `addr` | `len(addr.code)` | | addr 處的程式碼大小，單位為位元組 | | 3C | EXTCODECOPY | [A4](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a4-extcodecopy) | `addr, dstOst, ost, len` | `.` | mem[dstOst:dstOst+len-1] := addr.code[ost:ost+len-1] | 從 `addr` 複製程式碼 | | 3D | RETURNDATASIZE | 2 | `.` | `size` | | 上次外部呼叫回傳資料的大小，單位為位元組 | | 3E | RETURNDATACOPY | [A3](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a3-copy-operations) | `dstOst, ost, len` | `.` | mem[dstOst:dstOst+len-1] := returndata[ost:ost+len-1] | 複製上次外部呼叫的回傳資料 | | 3F | EXTCODEHASH | [A5](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a5-balance-extcodesize-extcodehash) | `addr` | `hash` | | hash = addr.exists ? keccak256(addr.code) : 0 | | 40 | BLOCKHASH | 20 | `blockNum` | `blockHash(blockNum)` | | | 41 | COINBASE | 2 | `.` | `block.coinbase` | | 當前區塊提案者的地址 | | 42 | TIMESTAMP | 2 | `.` | `block.timestamp` | | 當前區塊的時間戳記 | | 43 | NUMBER | 2 | `.` | `block.number` | | 當前區塊的編號 | | 44 | PREVRANDAO | 2 | `.` | `randomness beacon` | | 隨機性信標 | | 45 | GASLIMIT | 2 | `.` | `block.gaslimit` | | 當前區塊的 Gas 限制 | | 46 | CHAINID | 2 | `.` | `chain_id` | | 將當前[鏈 ID](https://eips.ethereum.org/EIPS/eip-155) 推入堆疊 | | 47 | SELFBALANCE | 5 | `.` | `address(this).balance` | | 執行中合約的餘額，單位為 Wei | | 48 | BASEFEE | 2 | `.` | `block.basefee` | | 當前區塊的基礎費用 | | 49 | BLOBHASH | 3 | `idx` | `tx.blob_versioned_hashes[idx]` | | [EIP-4844](https://eips.ethereum.org/EIPS/eip-4844) | | 4A | BLOBBASEFEE | 2 | `.` | `block.blobbasefee` | | 當前區塊的資料塊基礎費用 ([EIP-7516](https://eips.ethereum.org/EIPS/eip-7516)) | | 4B-4F | _無效_ | | 50 | POP | 2 | `_anon` | `.` | | 從堆疊頂部移除項目並丟棄 | | 51 | MLOAD | 3[*](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `ost` | `mem[ost:ost+32]` | | 從記憶體偏移量 `ost` 處讀取字組 | | 52 | MSTORE | 3[*](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `ost, val` | `.` | mem[ost:ost+32] := val | 將字組寫入記憶體 | | 53 | MSTORE8 | 3[*](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `ost, val` | `.` | mem[ost] := val && 0xFF | 將單一位元組寫入記憶體 | | 54 | SLOAD | [A6](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a6-sload) | `key` | `storage[key]` | | 從儲存空間讀取字組 | | 55 | SSTORE | [A7](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a7-sstore) | `key, val` | `.` | storage[key] := val | 將字組寫入儲存空間 | | 56 | JUMP | 8 | `dst` | `.` | | `$pc := dst` 標記僅當 `dst` 是有效的 jumpdest 時才賦值給 `pc` | | 57 | JUMPI | 10 | `dst, condition` | `.` | | `$pc := condition ? dst : $pc + 1` | | 58 | PC | 2 | `.` | `$pc` | | 程式計數器 | | 59 | MSIZE | 2 | `.` | `len(mem)` | | 當前執行環境中的記憶體大小，單位為位元組 | | 5A | GAS | 2 | `.` | `gasRemaining` | | | 5B | JUMPDEST | 1 | | | 標記有效的跳轉目標 | 有效的跳轉目標，例如不在 push 資料內的跳轉目標 | | 5C | TLOAD | 100 | `key` | `tstorage[key]` | | 從暫時儲存空間讀取字組 ([EIP-1153](https://eips.ethereum.org/EIPS/eip-1153)) | | 5D | TSTORE | 100 | `key, val` | `.` | tstorage[key] := val | 將字組寫入暫時儲存空間 ([EIP-1153](https://eips.ethereum.org/EIPS/eip-1153)) | | 5E | MCOPY | 3+3*words+[A0](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `dstOst, ost, len` | `.` | mem[dstOst] := mem[ost:ost+len] | 將記憶體從一個區域複製到另一個區域 ([EIP-5656](https://eips.ethereum.org/EIPS/eip-5656)) | | 5F | PUSH0 | 2 | `.` | `uint8` | | 將常數值 0 推入堆疊 | | 60 | PUSH1 | 3 | `.` | `uint8` | | 將 1 位元組的值推入堆疊 | | 61 | PUSH2 | 3 | `.` | `uint16` | | 將 2 位元組的值推入堆疊 | | 62 | PUSH3 | 3 | `.` | `uint24` | | 將 3 位元組的值推入堆疊 | | 63 | PUSH4 | 3 | `.` | `uint32` | | 將 4 位元組的值推入堆疊 | | 64 | PUSH5 | 3 | `.` | `uint40` | | 將 5 位元組的值推入堆疊 | | 65 | PUSH6 | 3 | `.` | `uint48` | | 將 6 位元組的值推入堆疊 | | 66 | PUSH7 | 3 | `.` | `uint56` | | 將 7 位元組的值推入堆疊 | | 67 | PUSH8 | 3 | `.` | `uint64` | | 將 8 位元組的值推入堆疊 | | 68 | PUSH9 | 3 | `.` | `uint72` | | 將 9 位元組的值推入堆疊 | | 69 | PUSH10 | 3 | `.` | `uint80` | | 將 10 位元組的值推入堆疊 | | 6A | PUSH11 | 3 | `.` | `uint88` | | 將 11 位元組的值推入堆疊 | | 6B | PUSH12 | 3 | `.` | `uint96` | | 將 12 位元組的值推入堆疊 | | 6C | PUSH13 | 3 | `.` | `uint104` | | 將 13 位元組的值推入堆疊 | | 6D | PUSH14 | 3 | `.` | `uint112` | | 將 14 位元組的值推入堆疊 | | 6E | PUSH15 | 3 | `.` | `uint120` | | 將 15 位元組的值推入堆疊 | | 6F | PUSH16 | 3 | `.` | `uint128` | | 將 16 位元組的值推入堆疊 | | 70 | PUSH17 | 3 | `.` | `uint136` | | 將 17 位元組的值推入堆疊 | | 71 | PUSH18 | 3 | `.` | `uint144` | | 將 18 位元組的值推入堆疊 | | 72 | PUSH19 | 3 | `.` | `uint152` | | 將 19 位元組的值推入堆疊 | | 73 | PUSH20 | 3 | `.` | `uint160` | | 將 20 位元組的值推入堆疊 | | 74 | PUSH21 | 3 | `.` | `uint168` | | 將 21 位元組的值推入堆疊 | | 75 | PUSH22 | 3 | `.` | `uint176` | | 將 22 位元組的值推入堆疊 | | 76 | PUSH23 | 3 | `.` | `uint184` | | 將 23 位元組的值推入堆疊 | | 77 | PUSH24 | 3 | `.` | `uint192` | | 將 24 位元組的值推入堆疊 | | 78 | PUSH25 | 3 | `.` | `uint200` | | 將 25 位元組的值推入堆疊 | | 79 | PUSH26 | 3 | `.` | `uint208` | | 將 26 位元組的值推入堆疊 | | 7A | PUSH27 | 3 | `.` | `uint216` | | 將 27 位元組的值推入堆疊 | | 7B | PUSH28 | 3 | `.` | `uint224` | | 將 28 位元組的值推入堆疊 | | 7C | PUSH29 | 3 | `.` | `uint232` | | 將 29 位元組的值推入堆疊 | | 7D | PUSH30 | 3 | `.` | `uint240` | | 將 30 位元組的值推入堆疊 | | 7E | PUSH31 | 3 | `.` | `uint248` | | 將 31 位元組的值推入堆疊 | | 7F | PUSH32 | 3 | `.` | `uint256` | | 將 32 位元組的值推入堆疊 | | 80 | DUP1 | 3 | `a` | `a, a` | | 複製堆疊上的第 1 個值 | | 81 | DUP2 | 3 | `_, a` | `a, _, a` | | 複製堆疊上的第 2 個值 | | 82 | DUP3 | 3 | `_, _, a` | `a, _, _, a` | | 複製堆疊上的第 3 個值 | | 83 | DUP4 | 3 | `_, _, _, a` | `a, _, _, _, a` | | 複製堆疊上的第 4 個值 | | 84 | DUP5 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 5 個值 | | 85 | DUP6 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 6 個值 | | 86 | DUP7 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 7 個值 | | 87 | DUP8 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 8 個值 | | 88 | DUP9 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 9 個值 | | 89 | DUP10 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 10 個值 | | 8A | DUP11 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 11 個值 | | 8B | DUP12 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 12 個值 | | 8C | DUP13 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 13 個值 | | 8D | DUP14 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 14 個值 | | 8E | DUP15 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 15 個值 | | 8F | DUP16 | 3 | `..., a` | `a, ..., a` | | 複製堆疊上的第 16 個值 | | 90 | SWAP1 | 3 | `a, b` | `b, a` | | | | 91 | SWAP2 | 3 | `a, _, b` | `b, _, a` | | | | 92 | SWAP3 | 3 | `a, _, _, b` | `b, _, _, a` | | | | 93 | SWAP4 | 3 | `a, _, _, _, b` | `b, _, _, _, a` | | | | 94 | SWAP5 | 3 | `a, ..., b` | `b, ..., a` | | | | 95 | SWAP6 | 3 | `a, ..., b` | `b, ..., a` | | | | 96 | SWAP7 | 3 | `a, ..., b` | `b, ..., a` | | | | 97 | SWAP8 | 3 | `a, ..., b` | `b, ..., a` | | | | 98 | SWAP9 | 3 | `a, ..., b` | `b, ..., a` | | | | 99 | SWAP10 | 3 | `a, ..., b` | `b, ..., a` | | | | 9A | SWAP11 | 3 | `a, ..., b` | `b, ..., a` | | | | 9B | SWAP12 | 3 | `a, ..., b` | `b, ..., a` | | | | 9C | SWAP13 | 3 | `a, ..., b` | `b, ..., a` | | | | 9D | SWAP14 | 3 | `a, ..., b` | `b, ..., a` | | | | 9E | SWAP15 | 3 | `a, ..., b` | `b, ..., a` | | | | 9F | SWAP16 | 3 | `a, ..., b` | `b, ..., a` | | | | A0 | LOG0 | [A8](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a8-log-operations) | `ost, len` | `.` | | LOG0(memory[ost:ost+len-1]) | | A1 | LOG1 | [A8](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a8-log-operations) | `ost, len, topic0` | `.` | | LOG1(memory[ost:ost+len-1], topic0) | | A2 | LOG2 | [A8](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a8-log-operations) | `ost, len, topic0, topic1` | `.` | | LOG2(memory[ost:ost+len-1], topic0, topic1) | | A3 | LOG3 | [A8](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a8-log-operations) | `ost, len, topic0, topic1, topic2` | `.` | | LOG3(memory[ost:ost+len-1], topic0, topic1, topic2) | | A4 | LOG4 | [A8](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a8-log-operations) | `ost, len, topic0, topic1, topic2, topic3` | `.` | | LOG4(memory[ost:ost+len-1], topic0, topic1, topic2, topic3) | | A5-EF | _無效_ | | F0 | CREATE | [A9](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a9-create-operations) | `val, ost, len` | `addr` | | addr = keccak256(rlp([address(this), this.nonce])) | | F1 | CALL | [AA](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#aa-call-operations) | gas, addr, val, argOst, argLen, retOst, retLen | `success` | mem[retOst:retOst+retLen-1] := returndata | | | F2 | CALLCODE | [AA](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#aa-call-operations) | `gas, addr, val, argOst, argLen, retOst, retLen` | `success` | mem[retOst:retOst+retLen-1] = returndata | 與 DELEGATECALL 相同，但不傳遞原始的 msg.sender 和 msg.value | | F3 | RETURN | 0[*](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `ost, len` | `.` | | return mem[ost:ost+len-1] | | F4 | DELEGATECALL | [AA](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#aa-call-operations) | `gas, addr, argOst, argLen, retOst, retLen` | `success` | mem[retOst:retOst+retLen-1] := returndata | | | F5 | CREATE2 | [A9](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a9-create-operations) | `val, ost, len, salt` | `addr` | | addr = keccak256(0xff ++ address(this) ++ salt ++ keccak256(mem[ost:ost+len-1]))[12:] | | F6-F9 | _無效_ | | FA | STATICCALL | [AA](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#aa-call-operations) | `gas, addr, argOst, argLen, retOst, retLen` | `success` | mem[retOst:retOst+retLen-1] := returndata | | | FB-FC | _無效_ | | FD | REVERT | 0[*](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#a0-1-memory-expansion) | `ost, len` | `.` | | revert(mem[ost:ost+len-1]) | | FE | INVALID | [AF](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#af-invalid) | | | 指定的無效操作碼 - [EIP-141](https://eips.ethereum.org/EIPS/eip-141) | | FF | SELFDESTRUCT | [AB](https://github.com/wolflo/evm-opcodes/blob/main/gas.md#ab-selfdestruct) | `addr` | `.` | | 將所有 ETH 傳送至 `addr`；如果與建立合約在同一筆交易中執行，則會銷毀該合約 |