JSON-RPC 應用程式介面
最後編輯: @ntiunn(opens in a new tab), 2024年10月3日
為了讓軟體應用程式能夠和以太坊區塊鏈互動(例如:讀取區塊鏈資料,發送交易到網路),必須先連結以太坊節點。
為此,每個以太坊用戶端都實作 JSON-RPC 規範(opens in a new tab),因此無論特定節點或用戶端實作如何,應用程式都可以依賴一組統一的方法。
JSON-RPC(opens in a new tab) 是一種無狀態、輕量級的遠端程序呼叫 (RPC) 協定。 該協定定義了幾種資料結構及其處理規則。 它與傳輸無關,因為這些概念可以在同一進程中、透過通訊端、透過超文字傳輸協定或在許多不同的訊息傳遞環境中使用。 它使用 JSON (RFC 4627) 作為資料格式。
用戶端實作
每個以太坊用戶端在實作 JSON-RPC 規範時可能會使用不同的程式設計語言。 有關特定程式設計語言的更多詳細資料,請參閱各個用戶端文件。 我們建議檢查每個用戶端的文件以取得最新的應用程式介面支援資訊。
便利程式庫
雖然可以選擇透過 JSON-RPC 應用程式介面直接與以太坊用戶端互動,但對於去中心化應用程式開發者來說通常有更簡單的選擇。 許多 JavaScript 和後端應用程式介面 程式庫都是為了在 JSON-RPC 應用程式介面之上提供包裝函式。 借助這些程式庫,開發者可以用自己選擇的程式語言編寫直覺的單行方法,以初始化與以太坊互動的 JSON-RPC 請求(在後台)。
共識用戶端應用程式介面
本頁面主要討論以太坊執行用戶端使用的 JSON-RPC 應用程式介面。 然而,共識用戶端也有一個遠端程序呼叫應用程式介面,讓使用者能夠直接從節點查詢有關節點的資訊、請求信標區塊、信標狀態和其他共識相關資訊。 信標應用程式介面網頁(opens in a new tab)上記錄了此應用程式介面。
內部應用程式介面也用於節點內的用戶端間通訊 - 也就是說,它讓共識用戶端和執行用戶端能夠交換資料。 這被稱為「引擎應用程式介面」,其規範可在 GitHub(opens in a new tab) 上取得。
執行用戶端規範
在 GitHub 上閱讀完整的 JSON-RPC 應用程式介面規範(opens in a new tab)。 此應用程式介面記錄在執行應用程式介面網頁(opens in a new tab)上,並包含一個檢查器來嘗試所有可用的方法。
慣例
十六進位值編碼
透過 JSON 傳遞兩種關鍵資料類型:未格式化的位元組陣列和數量。 兩者都以十六進位編碼傳遞,但對格式有不同的要求。
數量
編碼數量(整數、數字)時:編碼為十六進位,前綴為「0x」,最緊湊的表示形式(輕微例外:零應表示為「0x0」)。
下面有些範例:
- 0x41(在十進位中是 65)
- 0x400(在十進位中是 1024)
- 錯誤:0x(應始終至少有一位數字,零是「0x0」)
- 錯誤:0x0400(不允許有前導零)
- 錯誤:ff(必須有前綴 0x)
無格式資料
編碼無格式資料(位元組陣列、帳戶位址、雜湊值、位元組碼陣列)時:編碼為十六進位,前綴為「0x」,每個位元組兩個十六進位數字。
這裡有些範例:
- 0x41(大小為 1,「A」)
- 0x004200(大小為 3,「0B0」)
- 0x(大小為 0,"")
- 錯誤:0xf0f0f(位數必須為偶數)
- 錯誤:004200(必須以 0x 為前綴)
預設區塊參數
下列方法有一個額外的預設區塊參數:
當發出對以太坊狀態進行動作的請求時,最後一個預設區塊參數決定了區塊的高度。
defaultBlock 參數可以使用以下選項:
HEX String
- 表示整數區塊編號String "earliest"
表示最早的/創世區塊String "latest"
- 表示最新提議的區塊String "safe"
- 表示最新安全的頭部區塊String "finalized"
- 表示最新最終確定的區塊String "pending"
- 表示未決的狀態/交易
範例
在此頁面上,我們提供了有關如何透過命令列工具 curl(opens in a new tab) 使用各 JSON_RPC 應用程式介面端點的範例。 這些單獨的端點範例位於下面的 Curl 範例部分。 在頁面下方,我們還提供了一個使用 Geth 節點、JSON_RPC 應用程式介面和 curl 來編譯和部署智慧型合約的端到端範例。
Curl 範例
下面提供了使用 JSON_RPC 應用程式介面向以太坊節點發出 curl(opens in a new tab) 請求的範例。 每個範例包含對特定端點的描述、其參數、傳回類型,以及應該如何使用的可行範例。
curl 請求可能會傳回與內容類型相關的錯誤訊息。 這是因為 --data
選項將內容類型設定為 application/x-www-form-urlencoded
。 如果你的節點確實抱怨這一點,請手動在呼叫程式開始處放置 -H "Content-Type: application/json"
來設定標頭。 這些範例也不包括 URL/IP 和通訊埠組合,該組合必須是給 curl 的最後一個引數(例如 127.0.0.1:8545
)。 完整的 curl 請求包含採用以下形式的附加資料:
1curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545
Gossip、State、History
少數重要的 JSON-RPC 方法需要來自以太坊網路的資料,這些資料分屬於三個種類:<0>Gossip、State 和 History</0>。 利用這些章節中的連結移動至每個方法,或利用目錄探索完整的方法清單。
Gossip 方法
這些方法用於追蹤鏈頭。 這就是交易如何在網路中傳播、進入區塊以及用戶端如何發現新區塊的方式。
State 方法
報告所有已存儲資料的目前狀態的方法。 「狀態」像是一大塊可分享的隨機存取記憶體,包含帳戶餘額、合約資料和燃料預估。
History 方法
取得包括創世區塊在內的每一區塊的歷史記錄。 這像一個大型只能附加資料的檔案,包括所有區塊頭、區塊體、叔塊和交易收據。
- eth_getBlockTransactionCountByHash
- eth_getBlockTransactionCountByNumber
- eth_getUncleCountByBlockHash
- eth_getUncleCountByBlockNumber
- eth_getBlockByHash
- eth_getBlockByNumber
- eth_getTransactionByHash
- eth_getTransactionByBlockHashAndIndex
- eth_getTransactionByBlockNumberAndIndex
- eth_getTransactionReceipt
- eth_getUncleByBlockHashAndIndex
- eth_getUncleByBlockNumberAndIndex
JSON-RPC 應用程式介面訓練場
你可以使用訓練場工具(opens in a new tab)去發掘和試用應用程式介面方法。 訓練場也顯示不同的節點提供者支援的方法和網路。
JSON-RPC 應用程式介面方法
web3_clientVersion
傳回目前用戶端版本。
參數
無
傳回
String
- 目前用戶端版本
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc":"2.0",7 "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"8}複製
web3_sha3
傳回給定資料的 Keccak-256(不是 標準化的 SHA3-256)。
參數
DATA
- 要轉換為 SHA3 雜湊值的資料
1params: ["0x68656c6c6f20776f726c64"]複製
返回
DATA
- 給定字串的 SHA3 結果。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'3// Result4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"8}複製
net_version
傳回目前網路 ID。
參數
無
返回
String
- 目前網路 ID。
目前網路 ID 的完整清單可在 chainlist.org(opens in a new tab) 上找到。 一些常用的如下:
1
:以太坊主網5
:Goerli 測試網11155111
:Sepolia 測試網
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "3"8}複製
net_listening
如果用戶端正在主動偵聽網路連結,則傳回 true
。
參數
無
返回
Boolean
- 偵聽時為 true
,否則為 false
。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc":"2.0",7 "result":true8}複製
net_peerCount
傳回目前連線到用戶端的對等點數量。
參數
無
返回
QUANTITY
- 表示連結的對等點數量的整數。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'3// Result4{5 "id":74,6 "jsonrpc": "2.0",7 "result": "0x2" // 28}複製
eth_protocolVersion
傳回目前的以太坊協定版本。 請注意此方法在 Geth 中不可用(opens in a new tab)。
參數
無
返回
String
- 目前的以太坊協定版本
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "54"8}複製
eth_syncing
傳回一個物件,其中包含有關同步狀態的資料或傳回 false
。
參數
無
返回
準確的傳回資料因用戶端實作而異。 當節點未同步時,所有用戶端傳回 False
,並且所有用戶端傳回下列欄位。
Object|Boolean
,具有同步狀態資料的物件,或不同步時為 FALSE
:
startingBlock
:QUANTITY
- 匯入之開始區塊(僅在同步到達其頭部後才會重設)currentBlock
:QUANTITY
- 目前區塊,與 eth_blockNumber 相同highestBlock
:QUANTITY
- 估計的最高區塊
然而,個別用戶端也可以提供額外的資料。 例如 Geth 傳回如下資料:
1{2 "jsonrpc": "2.0",3 "id": 1,4 "result": {5 "currentBlock": "0x3cf522",6 "healedBytecodeBytes": "0x0",7 "healedBytecodes": "0x0",8 "healedTrienodes": "0x0",9 "healingBytecode": "0x0",10 "healingTrienodes": "0x0",11 "highestBlock": "0x3e0e41",12 "startingBlock": "0x3cbed5",13 "syncedAccountBytes": "0x0",14 "syncedAccounts": "0x0",15 "syncedBytecodeBytes": "0x0",16 "syncedBytecodes": "0x0",17 "syncedStorage": "0x0",18 "syncedStorageBytes": "0x0"19 }20}顯示全部複製
而 Besu 傳回:
1{2 "jsonrpc": "2.0",3 "id": 51,4 "result": {5 "startingBlock": "0x0",6 "currentBlock": "0x1518",7 "highestBlock": "0x9567a3",8 "pulledStates": "0x203ca",9 "knownStates": "0x200636"10 }11}顯示全部複製
請參閱特定用戶端的文檔以獲得更多詳細資料。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": {8 startingBlock: '0x384',9 currentBlock: '0x386',10 highestBlock: '0x454'11 }12}13// Or when not syncing14{15 "id":1,16 "jsonrpc": "2.0",17 "result": false18}顯示全部複製
eth_coinbase
傳回用戶端的 coinbase 地址。
參數
無
傳回
DATA
,20 位元組 - 目前 coinbase 地址。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'3// Result4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"8}複製
eth_chainId
傳回用來簽署重新執行攻擊保護交易的區塊鏈 ID。
參數
無
傳回
chainId
,十六進位數值字串,表示目前區塊鏈 ID 的整數值。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'3// Result4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "0x1"8}複製
eth_mining
如果用戶端正活躍地開採新區塊,則傳回 true
。 這方法只對工作量證明網路傳回 true
且自合併後這方法不可用在某些用戶端。
參數
無
傳回
Boolean
- 如果用戶端正在挖礦,則傳回 true
,否則傳回 false
。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'3//4{5 "id":71,6 "jsonrpc": "2.0",7 "result": true8}複製
eth_hashrate
傳回正在挖礦的節點每秒的雜湊值數量。 這方法只對工作量證明網路傳回 true
且自合併後這方法不可用在某些用戶端。
參數
無
傳回
QUANTITY
- 每秒的雜湊數。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'3// Result4{5 "id":71,6 "jsonrpc": "2.0",7 "result": "0x38a"8}複製
eth_gasPrice
傳回預估的目前燃料價格,以 wei 為單位。 例如:Besu 用戶端檢查最後面 100 個區塊並預設傳回燃料單價中位數。
參數
無
傳回
QUANTITY
- 表示目前燃料價格的整數,以 wei 為單位。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'3// Result4{5 "id":73,6 "jsonrpc": "2.0",7 "result": "0x1dfd14000" // 8049999872 Wei8}複製
eth_accounts
傳回用戶端擁有的地址清單。
參數
無
傳回
Array of DATA
,20 位元組 - 用戶端擁有的地址。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]8}複製
eth_blockNumber
傳回最近的區塊編號。
參數
無
傳回
QUANTITY
- 表示用戶端目前所在區塊編號的整數。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'3// Result4{5 "id":83,6 "jsonrpc": "2.0",7 "result": "0x4b7" // 12078}複製
eth_getBalance
傳回給定地址的帳戶餘額。
參數
DATA
,20 位元組 - 要檢查餘額的地址。QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
或"finalized"
,請參閱預設區塊參數
1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]複製
傳回
QUANTITY
- 表示目前餘額的整數,以 wei 為單位。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0234c8a3397aab58" // 1589724902343750008}複製
eth_getStorageAt
從給定地址的存儲位置傳回值。
參數
DATA
,20 位元組 - 存儲地址。QUANTITY
- 表示存儲中的位置的整數。QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
、"finalized"
,請參閱預設區塊參數
傳回
DATA
- 此存儲位置的值。
範例 正確的位置計算取決於要擷取的存儲。 考慮透過地址 0x391694e7e0b0cce554cb130d723a9d27458f9298
部署在 0x295a70b2de5e3953354a6a8344e616ed314d7251
的以下合約。
1contract Storage {2 uint pos0;3 mapping(address => uint) pos1;4 function Storage() {5 pos0 = 1234;6 pos1[msg.sender] = 5678;7 }8}
擷取 pos0 的值很簡單。
1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:85452{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}複製
擷取對應的元素較困難。 對應中元素位置是依照下列方式計算的:
1keccak(LeftPad32(key, 0), LeftPad32(map position, 0))複製
這意味著要擷取 pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"] 處的存儲,我們需要以下列方式計算位置:
1keccak(2 decodeHex(3 "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +4 "0000000000000000000000000000000000000000000000000000000000000001"5 )6)複製
可以使用 web3 程式庫的 Geth 控制台進行計算:
1> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"2undefined3> web3.sha3(key, {"encoding": "hex"})4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"複製
現在擷取存儲:
1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:85452{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}複製
eth_getTransactionCount
傳回從一個地址發送的交易數量。
參數
DATA
,20 位元組 - 地址。QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
或"finalized"
,請參閱預設區塊參數
1params: [2 "0x407d73d8a49eeb85d32cf465507dd71d507100c1",3 "latest", // state at the latest block4]複製
傳回
QUANTITY
- 表示從該地址發送的交易數量的整數。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}複製
eth_getBlockTransactionCountByHash
傳回區塊中從符合給定區塊雜湊值的交易數量。
參數
DATA
,32 位元組 - 區塊的雜湊值
1params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]複製
傳回
QUANTITY
- 表示該區塊中交易數量的整數。
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'3// 結果4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}複製
eth_getBlockTransactionCountByNumber
傳回與給定區塊編號相符的區塊中的交易數量。
參數
QUANTITY|TAG
- 整數區塊編號,或字串"earliest"
、"latest"
、"pending"
、"safe"
或"finalized"
,如預設區塊參數所示。
1params: [2 "0x13738ca", // 203962343]複製
傳回
QUANTITY
- 表示該區塊中交易數量的整數。
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'3// 結果4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}複製
eth_getUncleCountByBlockHash
傳回區塊中符合給定區塊雜湊值的叔塊數量。
參數
DATA
,32 位元組 - 區塊的雜湊值
1params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]複製
傳回
QUANTITY
- 表示該區塊中叔塊數量的整數。
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'3// 結果4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}複製
eth_getUncleCountByBlockNumber
傳回區塊中符合給定區塊編號的叔塊數量。
參數
QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
或"finalized"
,請參閱預設區塊參數
1params: [2 "0xe8", // 2323]複製
傳回
QUANTITY
- 表示該區塊中叔塊數量的整數。
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'3// 結果4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0" // 08}複製
eth_getCode
傳回給定地址的程式碼。
參數
DATA
,20 位元組 - 地址QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
或"finalized"
,請參閱預設區塊參數
1params: [2 "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",3 "0x5daf3b", // 61397074]複製
傳回
DATA
- 來自給定地址的程式碼。
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'3// 結果4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"8}複製
eth_sign
Sign 方法按以下方式計算以太坊特定簽章:sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message)))
。
透過在訊息中加入前綴,可以將計算出的簽章識別為以太坊特定簽章。 這可以防止濫用,即惡意去中心化應用程式簽署任意資料(例如交易)並使用簽章來冒充受害者。
注意:要簽章的地址必須解鎖。
參數
DATA
,20 位元組 - 地址DATA
,N 位元組 - 要簽署的訊息。
傳回
DATA
:簽章
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}複製
eth_signTransaction
簽署交易,稍後可使用 eth_sendRawTransaction 將交易提交到網路。
參數
Object
- 交易物件
type
:from
:DATA
,20 位元組 - 發送交易的地址。to
:DATA
20 位元組 -(建立新合約時可選)交易指向的地址。gas
:QUANTITY
-(可選,預設:90000)表示為交易執行提供的燃料的整數。 將傳回未使用的燃料。gasPrice
:QUANTITY
-(可選,預設:尚未決定)表示每次支付燃料時的燃料價格的整數(單位為 Wei)。value
:QUANTITY
-(可選)表示與此交易一起傳送的值的整數(單位為 Wei)。data
:DATA
- 合約的編譯程式碼,或叫用的方法簽章和編碼參數的雜湊。nonce
:QUANTITY
-(可選)表示隨機數的整數。 這允許覆寫你自己的使用相同隨機數的待處理交易。
傳回
DATA
,特定帳戶簽署的遞迴長度前綴編碼的交易物件。
範例
1// Request2curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'3// Result4{5 "id": 1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}複製
eth_sendTransaction
如果資料欄位包含程式碼,則建立新的訊息呼叫交易或建立合約,並使用 from
中指定的帳戶對其進行簽署。
參數
Object
- 交易物件
from
:DATA
,20 位元組 - 發送交易的地址。to
:DATA
20 位元組 -(建立新合約時可選)交易指向的地址。gas
:QUANTITY
-(可選,預設:90000)表示為交易執行提供的燃料的整數。 將傳回未使用的燃料。gasPrice
:QUANTITY
-(可選,預設:尚未決定)表示每次支付燃料時的燃料價格的整數。value
:QUANTITY
-(可選)表示與此交易一起傳送的值的整數。input
:DATA
- 合約的編譯程式碼,或叫用的方法簽章和編碼參數的雜湊值。nonce
:QUANTITY
-(可選)表示隨機數的整數。 這允許覆寫你自己的使用相同隨機數的待處理交易。
1params: [2 {3 from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",4 to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",5 gas: "0x76c0", // 304006 gasPrice: "0x9184e72a000", // 100000000000007 value: "0x9184e72a", // 24414062508 input:9 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",10 },11]顯示全部複製
傳回
DATA
,32 位元組 - 交易雜湊值,如果交易尚未可用則為零雜湊值。
建立合約時,在區塊中提議交易後,使用 eth_getTransactionReceipt 取得合約地址。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}複製
eth_sendRawTransaction
建立新的訊息呼叫交易或為簽署的交易建立合約。
參數
DATA
,簽署的交易資料。
1params: [2 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",3]複製
傳回
DATA
,32 位元組 - 交易雜湊值,如果交易尚未可用則為零雜湊值。
建立合約時,在區塊中提議交易後,使用 eth_getTransactionReceipt 取得合約地址。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}複製
eth_call
立即執行一個新的訊息呼叫,但不在區塊鏈上建立交易。 通常用於執行唯讀智慧型合約函式,例如 ERC-20 合約的 balanceOf
。
參數
Object
- 交易呼叫物件
from
:DATA
,20 位元組 -(可選)發送交易的地址。to
:DATA
,20 位元組 - 交易指向的地址。gas
:QUANTITY
-(可選)表示為交易執行提供的燃料的整數。 eth_call 消耗零燃料,但某些執行可能需要此參數。gasPrice
:QUANTITY
-(可選)表示每次支付燃料時的燃料價格的整數value
:QUANTITY
-(可選)表示與此交易一起傳送的值的整數input
:DATA
-(可選)方法簽章和編碼參數的雜湊值。 詳細資料請參考 Solidity 文檔中的以太坊合約應用程式二進位介面(opens in a new tab)。
QUANTITY|TAG
- 整數區塊編號,或字串"latest"
、"earliest"
、"pending"
、"safe"
或"finalized"
,請參閱預設區塊參數
傳回
DATA
- 已執行合約的傳回值。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x"8}複製
eth_estimateGas
產生和傳回完成交易所必需的燃料量預估值。 交易將不會新增至區塊鏈。 請注意,由於以太坊虛擬機機制和節點效能等種種原因,預估值可能明顯地大於交易實際使用的燃料量。
參數
請參閱 <0>eth_call</0> 參數,但所有屬性都是可選的。 假如沒有明確說明燃料限制,Geth 將使用來自待處理區塊的區塊燃料限制作為上限。 因此,當燃料量高於待處理區塊燃料限制時,傳回的預估值可能不足以執行呼叫或交易。
傳回
QUANTITY
- 使用的燃料數量。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x5208" // 210008}複製
eth_getBlockByHash
根據雜湊值傳回區塊資訊。
參數
DATA
,32 位元組 - 區塊的雜湊值。Boolean
- 如果為true
,傳回完整交易物件,如果為false
,只傳回交易的雜湊值。
1params: [2 "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",3 false,4]複製
傳回
Object
- 區塊物件,或如果未找到區塊,則為 null
:
number
:QUANTITY
- 區塊編號。 當為待處理區塊時,為null
。hash
:DATA
,32 位元組 - 區塊的雜湊值。 當為待處理區塊時,為null
。parentHash
:DATA
,32 位元組 - 父區塊的雜湊值。nonce
:DATA
,8 位元組 - 產生的工作量證明的雜湊值。 當為待處理區塊時,為null
。sha3Uncles
:DATA
,32 位元組 - 區塊中叔塊資料的第三代安全雜湊演算法。logsBloom
:DATA
,256 位元組 - 區塊日誌的布隆篩選器。 當為待處理區塊時,為null
。transactionsRoot
:DATA
,32 位元組 - 區塊交易樹的根。stateRoot
:DATA
,32 位元組 - 區塊最終狀態樹的根。receiptsRoot
:DATA
,32 位元組 - 區塊收據樹的根。miner
:DATA
,20 位元組 - 挖礦獎勵受款人的地址。difficulty
:QUANTITY
- 表示區塊難度的整數。totalDifficulty
:QUANTITY
- 表示此區塊前的區塊鏈的總難度的整數。extraData
:DATA
- 該區塊的「額外資料」欄位。size
:QUANTITY
- 表示此區塊大小的整數,以位元組為單位。gasLimit
:QUANTITY
- 此區塊允許的最大燃料量。gasUsed
:QUANTITY
- 此區塊所有交易所使用的總燃料量。timestamp
:QUANTITY
- 整理區塊時的 unix 時間戳。transactions
:Array
- 交易物件陣列,或是 32 位元組交易雜湊值,取決於最後一個給定的參數。uncles
:Array
- 叔塊雜湊值陣列。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'3// Result4{5{6"jsonrpc": "2.0",7"id": 1,8"result": {9 "difficulty": "0x4ea3f27bc",10 "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",11 "gasLimit": "0x1388",12 "gasUsed": "0x0",13 "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",14 "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",15 "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",16 "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",17 "nonce": "0x689056015818adbe",18 "number": "0x1b4",19 "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",20 "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",21 "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",22 "size": "0x220",23 "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",24 "timestamp": "0x55ba467c",25 "totalDifficulty": "0x78ed983323d",26 "transactions": [27 ],28 "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",29 "uncles": [30 ]31}32}顯示全部複製
eth_getBlockByNumber
根據區塊編號傳回關於區塊的資訊。
參數
QUANTITY|TAG
- 整數區塊編號,或字串"earliest"
、"latest"
、"pending"
、"safe"
或"finalized"
,如預設區塊參數所示。Boolean
- 如果為true
,傳回完整交易物件,如果為false
,只傳回交易的雜湊值。
1params: [2 "0x1b4", // 4363 true,4]複製
傳回 請參與 eth_getBlockByHash
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'複製
結果請參閱 eth_getBlockByHash
eth_getTransactionByHash
傳回有關按交易雜湊值請求的交易的資訊。
參數
DATA
,32 位元組 - 交易的雜湊值
1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]複製
傳回
Object
- 交易物件,或當找不到交易時為 null
:
blockHash
:DATA
,32 位元組 - 此交易所在區塊的雜湊值。 當為待處理時,為null
。blockNumber
:QUANTITY
- 此交易所在的區塊編號。 當為待處理時,為null
。from
:DATA
,20 位元組 - 發送者的地址。gas
:QUANTITY
- 發送者提供的燃料。gasPrice
:QUANTITY
- 發送者提供的燃料價格,以 Wei 為單位。hash
:DATA
,32 位元組 - 交易的雜湊值。input
:DATA
- 隨交易一起傳送的資料。nonce
:QUANTITY
- 發送者在這之前所進行的交易數量。to
:DATA
,20 位元組 - 接收者的地址。 如果是合約建立交易,則為null
。transactionIndex
:QUANTITY
- 表示區塊中交易索引位置的整數。 當為待處理時,為null
。value
:QUANTITY
- 傳輸的值,以 Wei 為單位。v
:QUANTITY
- 橢圓曲線數位簽章演算法復原 IDr
:QUANTITY
- 橢圓曲線數位簽章演算法簽章 rs
:QUANTITY
- 橢圓曲線數位簽章演算法簽章 s
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'3// Result4{5 "jsonrpc":"2.0",6 "id":1,7 "result":{8 "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",9 "blockNumber":"0x5daf3b", // 613970710 "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",11 "gas":"0xc350", // 5000012 "gasPrice":"0x4a817c800", // 2000000000013 "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",14 "input":"0x68656c6c6f21",15 "nonce":"0x15", // 2116 "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",17 "transactionIndex":"0x41", // 6518 "value":"0xf3dbb76162000", // 429000000000000019 "v":"0x25", // 3720 "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",21 "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"22 }23}顯示全部複製
eth_getTransactionByBlockHashAndIndex
按區塊雜湊值和交易索引位置傳回有關交易的資訊。
參數
DATA
,32 位元組 - 區塊的雜湊值。QUANTITY
- 表示交易索引位置的整數。
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]複製
傳回 請參閱 eth_getTransactionByHash
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'複製
結果請參閱 eth_getTransactionByHash
eth_getTransactionByBlockNumberAndIndex
按區塊編號和交易索引位置傳回有關交易的資訊。
參數
QUANTITY|TAG
- 區塊編號,或字串"earliest"
、"latest"
、"pending"
、"safe"
或"finalized"
,如預設區塊參數所示。QUANTITY
- 交易索引位置。
1params: [2 "0x9c47cf", // 102419993 "0x24", // 364]複製
傳回 請參閱 eth_getTransactionByHash
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'複製
結果請參閱 eth_getTransactionByHash
eth_getTransactionReceipt
按交易雜湊值返回交易的收據。
注意待處理交易沒有收據。
參數
DATA
,32 位元組 - 交易的雜湊值
1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]複製
傳回 Object
- 交易收據物件,或當找不到收據時為 null
:
transactionHash
:DATA
,32 位元組 - 交易的雜湊值。transactionIndex
:QUANTITY
- 表示區塊中交易索引位置的整數。blockHash
:DATA
,32 位元組 - 此交易所在區塊的雜湊值。blockNumber
:QUANTITY
- 此交易所在的區塊編號。from
:DATA
,20 位元組 - 發送者的地址。to
:DATA
,20 位元組 - 接收者的地址。 如果是合約建立交易,則為 null。cumulativeGasUsed
:QUANTITY
- 當區塊執行此交易時所使用的總燃料量。effectiveGasPrice
:QUANTITY
- 每單位燃料支付的基本費用和小費的總和。gasUsed
:QUANTITY
- 僅此特定交易所使用的燃料量。contractAddress
:DATA
,20 位元組 - 如果交易為建立合約,則為建立的合約地址,否則為null
。logs
:Array
- 此交易產生的日誌物件陣列。logsBloom
:DATA
,256 位元組 - 給輕量用戶端快速擷取相關日誌的布隆篩選器。type
:QUANTITY
- 表示交易類型的整數,0x0
表示傳統交易,0x1
表示存取清單類型,0x2
表示動態費用。
它也傳回 以下兩者之一:
root
:DATA
32 位元組的交易後狀態根(拜占庭升級之前)status
:QUANTITY
要麼1
(成功)要麼0
(失敗)
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'3// Result4{5 "jsonrpc": "2.0",6 "id": 1,7 "result": {8 "blockHash":9 "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",10 "blockNumber": "0xeff35f",11 "contractAddress": null, // string of the address if it was created12 "cumulativeGasUsed": "0xa12515",13 "effectiveGasPrice": "0x5a9c688d4",14 "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",15 "gasUsed": "0xb4c8",16 "logs": [{17 // logs as returned by getFilterLogs, etc.18 }],19 "logsBloom": "0x00...0", // 256 byte bloom filter20 "status": "0x1",21 "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",22 "transactionHash":23 "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",24 "transactionIndex": "0x66",25 "type": "0x2"26 }27}顯示全部複製
eth_getUncleByBlockHashAndIndex
按雜湊值和叔塊索引位置傳回關於區塊的叔塊資訊。
參數
DATA
,32 位元組 - 區塊的雜湊值。QUANTITY
- 叔塊的索引位置。
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]複製
傳回 請參與 eth_getBlockByHash
範例
1// 請求2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'複製
結果請參閱 eth_getBlockByHash
注意:叔塊不包含單獨交易。
eth_getUncleByBlockNumberAndIndex
按編號和叔塊索引位置傳回關於區塊的叔塊資訊。
參數
QUANTITY|TAG
- 區塊編號,或字串"earliest"
、"latest"
、"pending"
、"safe"
或"finalized"
,如預設區塊參數所示。QUANTITY
- 叔塊的索引位置。
1params: [2 "0x29c", // 6683 "0x0", // 04]複製
傳回 請參與 eth_getBlockByHash
注意:叔塊不包含單獨交易。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'複製
結果請參閱 eth_getBlockByHash
eth_newFilter
根據篩選條件選項建立一個篩選條件物件,以在狀態改變時發出通知(日誌)。 檢查狀態是否改變,呼叫 eth_getFilterChanges。
關於指定主題篩選條件的說明: 主題跟順序相關。 以下主題篩選條件將匹配日誌中包含主題 [A, B] 的交易:
[]
「任意值」[A]
「第一個位置為 A(其後為任意值)」[null, B]
「第一位置為任意值,且第二位置為 B(其後為任意值)」[A, B]
「第一位置為 A,且第二位置為 B(其後為任意值)」[[A, B], [A, B]]
「第一位置為(A 或 B)且第二位置為(A 或 B)(其後為任意值)」- 參數
Object
- 篩選條件選項:
fromBlock
:QUANTITY|TAG
-(可選,預設:"latest"
)整數區塊編號,或"latest"
表示最近提議的區塊,"safe"
表示最新的安全區塊,"finalized"
表示最新的最終確定區塊,或"pending"
,"earliest"
表示尚未在區塊中的交易。toBlock
:QUANTITY|TAG
-(可選,預設:"latest"
)整數區塊編號,或"latest"
表示最近提議的區塊,"safe"
表示最新的安全區塊,"finalized"
表示最新的最終確定區塊,或"pending"
,"earliest"
表示尚未在區塊中的交易。address
:DATA|Array
,20 位元組 - (可選)合約地址或日誌起源的地址清單。topics
:Array of DATA
,(可選)32 位元組陣列DATA
主題。 主題與順序相關。 每個主題也可以為帶有「或」選項的 DATA 陣列。
1params: [2 {3 fromBlock: "0x1",4 toBlock: "0x2",5 address: "0x8888f1f195afa192cfee860698584c030f4c9db1",6 topics: [7 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",8 null,9 [10 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",11 "0x0000000000000000000000000aff3454fce5edbc8cca8697c15331677e6ebccc",12 ],13 ],14 },15]顯示全部複製
傳回 QUANTITY
- 篩選條件 ID。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}複製
eth_newBlockFilter
在節點中建立一個篩選條件,以在新區塊到達時發出通知。 檢查狀態是否改變,呼叫 eth_getFilterChanges。
參數 無
傳回 QUANTITY
- 篩選條件 ID。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}複製
eth_newPendingTransactionFilter
在節點中建立一個篩選條件,以在新的待處理交易到達時發出通知。 檢查狀態是否改變,呼叫 eth_getFilterChanges。
參數 無
傳回 QUANTITY
- 篩選條件 ID。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}複製
eth_uninstallFilter
根據給定 ID 解除安裝篩選條件。 當不再需要監視時,應始終對其進行呼叫。 另外,當在一段時間內未使用 eth_getFilterChanges 請求篩選條件時,篩選條件會逾時。
參數
QUANTITY
- 篩選條件 ID。
1params: [2 "0xb", // 113]複製
傳回 Boolean
- 如果成功解除安裝篩選條件,則為 true
,否則為 false
。
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'3// Result4{5 "id":1,6 "jsonrpc": "2.0",7 "result": true8}複製
eth_getFilterChanges
篩選條件輪詢方法,傳回自從上次輪詢後產生的日誌陣列。
參數
QUANTITY
- 篩選條件 ID。
1params: [2 "0x16", // 223]複製
傳回 Array
- 日誌物件陣列,或如果自上次輪詢沒有任何變更,則為空陣列。
- 對於使用
eth_newBlockFilter
建立的篩選條件,傳回值是區塊雜湊值(DATA
,32 位元組),例如["0x3454645634534..."]
。 - 對於使用
eth_newPendingTransactionFilter
建立的篩選條件,傳回值是交易雜湊值(DATA
,32 位元組),例如["0x6345343454645..."]
。 - 對於使用
eth_newFilter
建立的篩選條件,日誌是包含下列參數的物件:removed
:TAG
- 當日誌由於鏈重組被移除時,為true
。 如果是有效日誌,則為false
。logIndex
:QUANTITY
- 表示區塊內日誌索引位置的整數。 當為待處理日誌時,為null
。transactionIndex
:QUANTITY
- 表示從中建立日誌的交易索引位置的整數。 當為待處理日誌時,為null
。transactionHash
:DATA
,32 位元組 - 從中建立此日誌的交易的雜湊值。 當為待處理日誌時,為null
。blockHash
:DATA
,32 位元組 - 此日誌所在區塊的雜湊值。 當為待處理時,為null
。 當為待處理日誌時,為null
。blockNumber
:QUANTITY
- 此日誌所在的區塊編號。 當為待處理時,為null
。 當為待處理日誌時,為null
。address
:DATA
,20 位元組 -此日誌的來源地址。data
:DATA
- 包含零個或多個 32 位元組非索引日誌引數。topics
:Array of DATA
- 索引日誌引數的 0 到 4 個 32 位元組DATA
陣列。 (在 solidity:第一個主題是事件簽章的雜湊值(例如Deposit(address,bytes32,uint256)
),除非你使用說明符anonymous
宣告了該事件)。
- 範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'3// Result4{5 "id":1,6 "jsonrpc":"2.0",7 "result": [{8 "logIndex": "0x1", // 19 "blockNumber":"0x1b4", // 43610 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",11 "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",12 "transactionIndex": "0x0", // 013 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",14 "data":"0x0000000000000000000000000000000000000000000000000000000000000000",15 "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]16 },{17 ...18 }]19}顯示全部複製
eth_getFilterLogs
傳回與給定 ID 之篩選條件相符的所有日誌的陣列。
參數
QUANTITY
- 篩選條件 ID。
1params: [2 "0x16", // 223]複製
傳回 請參閱 eth_getFilterChanges
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'複製
結果請參閱 eth_getFilterChanges
eth_getLogs
傳回與給定篩選條件物件相符的所有日誌的陣列。
參數
Object
- 篩選條件選項:
fromBlock
:QUANTITY|TAG
-(可選,預設:"latest"
)整數區塊編號,或"latest"
表示最近提議的區塊,"safe"
表示最新的安全區塊,"finalized"
表示最新的最終確定區塊,或"pending"
,"earliest"
表示尚未在區塊中的交易。toBlock
:QUANTITY|TAG
-(可選,預設:"latest"
)整數區塊編號,或"latest"
表示最近提議的區塊,"safe"
表示最新的安全區塊,"finalized"
表示最新的最終確定區塊,或"pending"
,"earliest"
表示尚未在區塊中的交易。address
:DATA|Array
,20 位元組 - (可選)合約地址或日誌起源的地址清單。topics
:Array of DATA
,(可選)32 位元組陣列DATA
主題。 主題與順序相關。 每個主題也可以為帶有「或」選項的 DATA 陣列。blockhash
:DATA
,32 位元組 - (可選,future),新增 EIP-234 後,blockHash
將是一個新的篩選條件選項,會將傳回的日誌限制為具有 32 位元組雜湊值blockHash
的單一區塊。 使用blockHash
等於fromBlock
=toBlock
= 具有雜湊值blockHash
的區塊編號。 如果blockHash
出現在篩選條件中,則fromBlock
和toBlock
都不允許使用。
1params: [2 {3 topics: [4 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",5 ],6 },7]複製
傳回 請參閱 eth_getFilterChanges
範例
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'複製
結果請參閱 eth_getFilterChanges
使用範例
使用 JSON_RPC 部署合約
這部分示範如何只使用遠端程序呼叫介面部署合約。 有其他的部署合約方法可以消除這種複雜性,例如,使用建置在遠端程序呼叫介面之上的程式庫,例如 web3.js(opens in a new tab) 和 web3.py(opens in a new tab)。 雖然在抽象化之後,一般來說比較容易理解和較不易出錯,但理解在後台發生了什麼是有益的。
下面是一個名為 Multiply7
的簡單智慧型合約,將使用 JSON-RPC 介面把其部署到以太坊節點。 本教學假設讀者已經執行一個 Geth 節點。 更多節點和用戶端的資訊可以在這裡獲得。 請參考個別的用戶端文件瞭解如何為非 Geth 用戶端開啟 HTTP JSON-RPC。 大多數用戶端預設在 localhost:8545
上提供服務。
1contract Multiply7 {2 event Print(uint);3 function multiply(uint input) returns (uint) {4 Print(input * 7);5 return input * 7;6 }7}
首先,確定啟用了 HTTP 遠端程序呼叫介面。 也就是說,在啟動時我們為 Geth 提供 --http
旗標。 在這個例子中,我們使用私有開發鏈的 Geth 節點。 使用這個方法,將不需要真實網路上的以太幣。
geth --http --dev console 2>>geth.log
這將在 http://localhost:8545
上啟動 HTTP 遠端程序呼叫介面。
我們可以使用 curl(opens in a new tab) 擷取 Coinbase 地址和餘額來驗證介面正在執行。 請注意,這些範例中的資料與你的本地節點有所不同。 如果你想嘗試這些命令,請將第二個 curl 請求中的請求參數替換為第一個請求返回的結果。
curl --data '{"jsonrpc":"2.0","method":"eth_coinbase", "id":1}' -H "Content-Type: application/json" localhost:8545{"id":1,"jsonrpc":"2.0","result":["0x9b1d35635cc34752ca54713bb99d38614f63c955"]}curl --data '{"jsonrpc":"2.0","method":"eth_getBalance", "params": ["0x9b1d35635cc34752ca54713bb99d38614f63c955", "latest"], "id":2}' -H "Content-Type: application/json" localhost:8545{"id":2,"jsonrpc":"2.0","result":"0x1639e49bba16280000"}
由於數字是十六進位編碼的,因此餘額以十六進位字串形式形式傳回(單位為 wei)。 如果想要以數位形式獲得以太幣餘額,可以使用 Geth 控制台中的 web3。
1web3.fromWei("0x1639e49bba16280000", "ether")2// "410"
現在我們的私有開發鏈上有一些以太幣,我們可以部署合約了。 第一步是把 Multiply7 合約編譯成可以傳送到以太坊虛擬機的字元組程式碼。 要安裝 Solidity 編譯器 solc,請參考 Solidity 文件(opens in a new tab)。 (為符合我們的範例中使用的編譯器版本(opens in a new tab),你可能想要使用較舊的 solc
版本。)
下一步是把 Multiply7 合約編譯成可以傳送到以太坊虛擬機的字元組程式碼。
echo 'pragma solidity ^0.4.16; contract Multiply7 { event Print(uint); function multiply(uint input) public returns (uint) { Print(input * 7); return input * 7; } }' | solc --bin======= <stdin>:Multiply7 =======Binary:6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029
現在我們有了編譯後的程式碼,我們需要確定部署程式碼需要花費多少燃料。 遠端程序呼叫介面有 eth_estimateGas
方法可以給我們預估值。
curl --data '{"jsonrpc":"2.0","method": "eth_estimateGas", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 5}' -H "Content-Type: application/json" localhost:8545{"jsonrpc":"2.0","id":5,"result":"0x1c31e"}
最後部署合約。
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0x9b1d35635cc34752ca54713bb99d38614f63c955", "gas": "0x1c31e", "data": "0x6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029"}], "id": 6}' -H "Content-Type: application/json" localhost:8545{"id":6,"jsonrpc":"2.0","result":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"}
交易被節點接受且傳回交易雜湊值。 雜湊值可以用來追蹤交易。 下一步是確定將合約部署至的地址。 每一個被執行的交易將會產生一份收據。 此收據包含各種關於交易的資訊,例如:交易包含在哪一個區塊中,以及以太坊虛擬機使用多少燃料。 假如交易建立一個合約,交易也將包含合約地址。 我們可以用 eth_getTransactionReceipt
遠端程序呼叫方法擷取收據。
curl --data '{"jsonrpc":"2.0","method": "eth_getTransactionReceipt", "params": ["0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf"], "id": 7}' -H "Content-Type: application/json" localhost:8545{"jsonrpc":"2.0","id":7,"result":{"blockHash":"0x77b1a4f6872b9066312de3744f60020cbd8102af68b1f6512a05b7619d527a4f","blockNumber":"0x1","contractAddress":"0x4d03d617d700cf81935d7f797f4e2ae719648262","cumulativeGasUsed":"0x1c31e","from":"0x9b1d35635cc34752ca54713bb99d38614f63c955","gasUsed":"0x1c31e","logs":[],"logsBloom":"0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","status":"0x1","to":null,"transactionHash":"0xe1f3095770633ab2b18081658bad475439f6a08c902d0915903bafff06e6febf","transactionIndex":"0x0"}}
我們的合約是建立在 0x4d03d617d700cf81935d7f797f4e2ae719648262
。 結果為 null 而不是收據時,表示交易尚未列入區塊中。 稍等一下,並檢查你的共識用戶端是否正常執行,然後重試一次。
與智能合約互動
在此範例中,我們將使用 eth_sendTransaction
向合約的 multiply
方法傳送交易。
eth_sendTransaction
需要若干引數,特別是 from
、to
和 data
。 From
是我們帳戶的公共地址,to
是合約地址。 data
引數包含有效負載,定義了必須呼叫哪個方法以及使用哪些引數。 這是 ABI(應用程式二進位介面)(opens in a new tab)發揮作用的地方。 應用程式二進位介面是定義如何為以太坊虛擬機定義和編碼資料的 JSON 檔案。
有效負載中的位元組定義要呼叫合約中的哪個方法。 這是函式名稱及其引數類型的 Keccak 雜湊值的前 4 個位元組(十六進位編碼)。 Multiply 函式接受 uint,它是 uint256 的別名。 我們得到以下結果:
1web3.sha3("multiply(uint256)").substring(0, 10)2// "0xc6888fa1"
下一步是對引數進行編碼。 只有一個 uint256,例如值 6。 應用程式二進制介面有一個部分指定如何對 uint256 類型進行編碼。
int<M>: enc(X)
是 X 的高位元組在前二進位補碼編碼,對於負 X 在高位(左側)填充 0xff,對於正 X 填充零 > 位元組,使得長度為 32 位元組的倍數。
這編碼為 000000000000000000000000000000000000000000000000000000000000006
。
結合函式選擇器和已編碼的引數,我們的資料如下:0xc6888fa10000000000000000000000000000000000000000000000000000000000000006
。
現在可將其傳送到節點:
curl --data '{"jsonrpc":"2.0","method": "eth_sendTransaction", "params": [{"from": "0xeb85a5557e5bdc18ee1934a89d8bb402398ee26a", "to": "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d", "data": "0xc6888fa10000000000000000000000000000000000000000000000000000000000000006"}], "id": 8}' -H "Content-Type: application/json" localhost:8545{"id":8,"jsonrpc":"2.0","result":"0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74"}
由於傳送了交易,因此傳回了交易雜湊值。 擷取收據得到以下內容:
1{2 blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",3 blockNumber: 268,4 contractAddress: null,5 cumulativeGasUsed: 22631,6 gasUsed: 22631,7 logs: [{8 address: "0x6ff93b4b46b41c0c3c9baee01c255d3b4675963d",9 blockHash: "0xbf0a347307b8c63dd8c1d3d7cbdc0b463e6e7c9bf0a35be40393588242f01d55",10 blockNumber: 268,11 data: "0x000000000000000000000000000000000000000000000000000000000000002a",12 logIndex: 0,13 topics: ["0x24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"],14 transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",15 transactionIndex: 016 }],17 transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",18 transactionIndex: 019}顯示全部
收據包含了日誌。 此日誌由以太坊虛擬機在交易執行時產生並包含在收據中。 multiply
函式顯示 Print
事件在輸入乘以 7 時觸發。 由於 Print
事件的引數是 uint256,我們可以根據應用程式二進位介面規則對其進行解碼,得到預期的十進位數 42。 除了資料之外,值得注意的是,主題可用於確定哪個事件建立了日誌:
1web3.sha3("Print(uint256)")2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"
這只是對一些最常見任務的簡要介紹,演示了 JSON-RPC 的直接使用。