以太坊虛擬機的作業碼
頁面最後更新時間： 2025年9月11日
概覽
這是 wolflo/evm-opcodes (opens in a new tab) 上 EVM 參考頁面的更新版本。 內容也參考自 黃皮書 (opens in a new tab)、Jello Paper (opens in a new tab) 和 geth (opens in a new tab) 的實作。 本文意圖成為方便參考的頁面，但並非特別嚴謹。 若你想確定正確性並了解每種邊界案例（指僅在極端工作參數下才會發生的問題或情況），建議使用 Jello Paper 或用戶端實作。
正在尋找互動式參考資料？ 請查看 evm.codes (opens in a new tab)。
關於動態 gas 成本的操作，請參閱 gas.md (opens in a new tab)。
💡 快速提示：若要檢視完整一行，請使用 [shift] + scroll 在桌上型電腦上水平捲動。
| 堆疊 | 名稱 | 燃料 | 初始堆疊 | 最終堆疊 | 記憶體/儲存空間 | 注釋 | |
|---|---|---|---|---|---|---|---|
| 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 (opens in a new tab) | a, b | a ** b | uint256 冪，模數為 2**256 | ||
| 0B | SIGNEXTEND | 5 | b, x | SIGNEXTEND(x, b) | 對 x 進行符號擴充 (opens in a new tab)，從 (b+1) 位元組擴充為 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` | |
| 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 (opens in a new tab) | ost, len | keccak256(mem[ost:ost+len-1]) | keccak256 | ||
| 21-2F | 無效 | ||||||
| 30 | ADDRESS | 2 | . | address(this) | 執行合約的地址 | ||
| 31 | BALANCE | A5 (opens in a new tab) | 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 (opens in a new tab) | dstOst, ost, len | . | mem[dstOst:dstOst+len-1] := msg.data[ost:ost+len-1] | 複製訊息資料 | |
| 38 | CODESIZE | 2 | . | len(this.code) | 執行合約的程式碼長度，以位元組計 | ||
| 39 | CODECOPY | A3 (opens in a new tab) | dstOst, ost, len | . | mem[dstOst:dstOst+len-1] := this.code[ost:ost+len-1] | 複製執行合約的位元組碼 | |
| 3A | GASPRICE | 2 | . | tx.gasprice | 交易的 gas 價格，以 wei/單位 gas 計 ** (opens in a new tab) | ||
| 3B | EXTCODESIZE | A5 (opens in a new tab) | addr | len(addr.code) | 地址處程式碼的大小，以位元組計 | ||
| 3C | EXTCODECOPY | A4 (opens in a new tab) | addr, dstOst, ost, len | . | mem[dstOst:dstOst+len-1] := addr.code[ost:ost+len-1] | 從 addr 複製程式碼 | |
| 3D | RETURNDATASIZE | 2 | . | size | 上次外部呼叫所回傳資料的大小，以位元組計 | ||
| 3E | RETURNDATACOPY | A3 (opens in a new tab) | dstOst, ost, len | . | mem[dstOst:dstOst+len-1] := returndata[ost:ost+len-1] | 複製上次外部呼叫所回傳的資料 | |
| 3F | EXTCODEHASH | A5 (opens in a new tab) | addr | 雜湊值 | 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 (opens in a new tab) 推入堆疊 | ||
| 47 | SELFBALANCE | 5 | . | address(this).balance | 執行中合約的餘額，以 wei 計 | ||
| 48 | BASEFEE | 2 | . | block.basefee | 目前區塊的基本費用 | ||
| 49 | BLOBHASH | 3 | idx | tx.blob_versioned_hashes[idx] | EIP-4844 (opens in a new tab) | ||
| 4A | BLOBBASEFEE | 2 | . | block.blobbasefee | 目前區塊的 Blob 基本費用 (EIP-7516 (opens in a new tab)) | ||
| 4B-4F | 無效 | ||||||
| 50 | POP | 2 | _anon | . | 從堆疊頂端移除項目並捨棄 | ||
| 51 | MLOAD | 3* (opens in a new tab) | ost | mem[ost:ost+32] | 從偏移量 ost 的記憶體讀取字 | ||
| 52 | MSTORE | 3* (opens in a new tab) | ost, val | . | mem[ost:ost+32] := val | 將一個字寫入記憶體 | |
| 53 | MSTORE8 | 3* (opens in a new tab) | ost, val | . | mem[ost] := val && 0xFF | 將單一位元組寫入記憶體 | |
| 54 | SLOAD | A6 (opens in a new tab) | key | storage[key] | 從儲存體讀取字 | ||
| 55 | SSTORE | A7 (opens in a new tab) | key, val | . | storage[key] := val | 將字寫入儲存體 | |
| 56 | JUMP | 8 | dst | . | $pc := dst 標示 pc 僅在 dst 為有效跳轉目的地時才會被指派 | ||
| 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 | 標記有效的跳轉目的地 | 有效的跳轉目的地，例如不在推送資料內的跳轉目的地 | |||
| 5C | TLOAD | 100 | key | tstorage[key] | 從暫時性儲存體讀取字 (EIP-1153 (opens in a new tab)) | ||
| 5D | TSTORE | 100 | key, val | . | tstorage[key] := val | 將字寫入暫時性儲存體 (EIP-1153 (opens in a new tab)) | |
| 5E | MCOPY | 3+3*words+A0 (opens in a new tab) | dstOst, ost, len | . | mem[dstOst] := mem[ost:ost+len] | 將記憶體從一個區域複製到另一個區域 (EIP-5656 (opens in a new tab)) | |
| 5E | 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 (opens in a new tab) | ost, len | . | LOG0(memory[ost:ost+len-1]) | ||
| A1 | LOG1 | A8 (opens in a new tab) | ost, len, topic0 | . | LOG1(memory[ost:ost+len-1], topic0) | ||
| A2 | LOG2 | A8 (opens in a new tab) | ost, len, topic0, topic1 | . | LOG2(memory[ost:ost+len-1], topic0, topic1) | ||
| A3 | LOG3 | A8 (opens in a new tab) | ost, len, topic0, topic1, topic2 | . | LOG3(memory[ost:ost+len-1], topic0, topic1, topic2) | ||
| A4 | LOG4 | A8 (opens in a new tab) | ost, len, topic0, topic1, topic2, topic3 | . | LOG4(memory[ost:ost+len-1], topic0, topic1, topic2, topic3) | ||
| A5-EF | 無效 | ||||||
| F0 | CREATE | A9 (opens in a new tab) | val, ost, len | addr | addr = keccak256(rlp([address(this), this.nonce])) | ||
| F1 | CALL | AA (opens in a new tab) | gas, addr, val, argOst, argLen, retOst, retLen | success | mem[retOst:retOst+retLen-1] := returndata | ||
| F2 | CALLCODE | AA (opens in a new tab) | gas, addr, val, argOst, argLen, retOst, retLen | success | mem[retOst:retOst+retLen-1] = returndata | 與 DELEGATECALL 相同，但不傳播原始的 msg.sender 和 msg.value | |
| F3 | RETURN | 0* (opens in a new tab) | ost, len | . | 回傳 mem[ost:ost+len-1] | ||
| F4 | DELEGATECALL | AA (opens in a new tab) | gas, addr, argOst, argLen, retOst, retLen | success | mem[retOst:retOst+retLen-1] := returndata | ||
| F5 | CREATE2 | A9 (opens in a new tab) | val, ost, len, salt | addr | addr = keccak256(0xff ++ address(this) ++ salt ++ keccak256(mem[ost:ost+len-1]))[12:] | ||
| F6-F9 | 無效 | ||||||
| FA | STATICCALL | AA (opens in a new tab) | gas, addr, argOst, argLen, retOst, retLen | success | mem[retOst:retOst+retLen-1] := returndata | ||
| FB-FC | 無效 | ||||||
| FD | REVERT | 0* (opens in a new tab) | ost, len | . | 還原 (mem[ost:ost+len-1]) | ||
| FE | INVALID | AF (opens in a new tab) | 指定的無效操作碼 - EIP-141 (opens in a new tab) | ||||
| FF | SELFDESTRUCT | AB (opens in a new tab) | addr | . | 將所有 ETH 傳送到 addr；如果在建立合約的同筆交易中執行，就會銷毀該合約 |