跳至主要内容
Change page

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 為前綴)

預設區塊參數

下列方法有一個額外的預設區塊參數:

  • eth_getBalance
  • eth_getCode
  • eth_getTransactionCount
  • eth_getStorageAt
  • eth_call

當發出對以太坊狀態進行動作的請求時,最後一個預設區塊參數決定了區塊的高度。

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 方法

這些方法用於追蹤鏈頭。 這就是交易如何在網路中傳播、進入區塊以及用戶端如何發現新區塊的方式。

  • eth_blockNumber
  • eth_sendRawTransaction

State 方法

報告所有已存儲資料的目前狀態的方法。 「狀態」像是一大塊可分享的隨機存取記憶體,包含帳戶餘額、合約資料和燃料預估。

  • eth_getBalance
  • eth_getStorageAt
  • eth_getTransactionCount
  • eth_getCode
  • eth_call
  • eth_estimateGas

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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
3// Result
4{
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)。

參數

  1. DATA - 要轉換為 SHA3 雜湊值的資料
1params: ["0x68656c6c6f20776f726c64"]
複製

返回

DATA - 給定字串的 SHA3 結果。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
3// Result
4{
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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
3// Result
4{
5 "id":67,
6 "jsonrpc": "2.0",
7 "result": "3"
8}
複製

net_listening

如果用戶端正在主動偵聽網路連結,則傳回 true

參數

返回

Boolean - 偵聽時為 true,否則為 false

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
3// Result
4{
5 "id":67,
6 "jsonrpc":"2.0",
7 "result":true
8}
複製

net_peerCount

傳回目前連線到用戶端的對等點數量。

參數

返回

QUANTITY - 表示連結的對等點數量的整數。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
3// Result
4{
5 "id":74,
6 "jsonrpc": "2.0",
7 "result": "0x2" // 2
8}
複製

eth_protocolVersion

傳回目前的以太坊協定版本。 請注意此方法在 Geth 中不可用(opens in a new tab)

參數

返回

String - 目前的以太坊協定版本

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
3// Result
4{
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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": {
8 startingBlock: '0x384',
9 currentBlock: '0x386',
10 highestBlock: '0x454'
11 }
12}
13// Or when not syncing
14{
15 "id":1,
16 "jsonrpc": "2.0",
17 "result": false
18}
顯示全部
複製

eth_coinbase

傳回用戶端的 coinbase 地址。

參數

傳回

DATA,20 位元組 - 目前 coinbase 地址。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
3// Result
4{
5 "id":64,
6 "jsonrpc": "2.0",
7 "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
8}
複製

eth_chainId

傳回用來簽署重新執行攻擊保護交易的區塊鏈 ID。

參數

傳回

chainId,十六進位數值字串,表示目前區塊鏈 ID 的整數值。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
3// Result
4{
5 "id":67,
6 "jsonrpc": "2.0",
7 "result": "0x1"
8}
複製

eth_mining

如果用戶端正活躍地開採新區塊,則傳回 true。 這方法只對工作量證明網路傳回 true 且自合併後這方法不可用在某些用戶端。

參數

傳回

Boolean - 如果用戶端正在挖礦,則傳回 true,否則傳回 false

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
3//
4{
5 "id":71,
6 "jsonrpc": "2.0",
7 "result": true
8}
複製

eth_hashrate

傳回正在挖礦的節點每秒的雜湊值數量。 這方法只對工作量證明網路傳回 true 且自合併後這方法不可用在某些用戶端。

參數

傳回

QUANTITY - 每秒的雜湊數。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
3// Result
4{
5 "id":71,
6 "jsonrpc": "2.0",
7 "result": "0x38a"
8}
複製

eth_gasPrice

傳回預估的目前燃料價格,以 wei 為單位。 例如:Besu 用戶端檢查最後面 100 個區塊並預設傳回燃料單價中位數。

參數

傳回

QUANTITY - 表示目前燃料價格的整數,以 wei 為單位。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
3// Result
4{
5 "id":73,
6 "jsonrpc": "2.0",
7 "result": "0x1dfd14000" // 8049999872 Wei
8}
複製

eth_accounts

傳回用戶端擁有的地址清單。

參數

傳回

Array of DATA,20 位元組 - 用戶端擁有的地址。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
8}
複製

eth_blockNumber

傳回最近的區塊編號。

參數

傳回

QUANTITY - 表示用戶端目前所在區塊編號的整數。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
3// Result
4{
5 "id":83,
6 "jsonrpc": "2.0",
7 "result": "0x4b7" // 1207
8}
複製

eth_getBalance

傳回給定地址的帳戶餘額。

參數

  1. DATA,20 位元組 - 要檢查餘額的地址。
  2. QUANTITY|TAG - 整數區塊編號,或字串 "latest""earliest""pending""safe""finalized",請參閱預設區塊參數
1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]
複製

傳回

QUANTITY - 表示目前餘額的整數,以 wei 為單位。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x0234c8a3397aab58" // 158972490234375000
8}
複製

eth_getStorageAt

從給定地址的存儲位置傳回值。

參數

  1. DATA,20 位元組 - 存儲地址。
  2. QUANTITY - 表示存儲中的位置的整數。
  3. 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:8545
2{"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"
2undefined
3> web3.sha3(key, {"encoding": "hex"})
4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"
複製

現在擷取存儲:

1curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
2{"jsonrpc":"2.0","id":1,"result":"0x000000000000000000000000000000000000000000000000000000000000162e"}
複製

eth_getTransactionCount

傳回從一個地址發送的交易數量。

參數

  1. DATA,20 位元組 - 地址。
  2. QUANTITY|TAG - 整數區塊編號,或字串 "latest""earliest""pending""safe""finalized",請參閱預設區塊參數
1params: [
2 "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
3 "latest", // state at the latest block
4]
複製

傳回

QUANTITY - 表示從該地址發送的交易數量的整數。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x1" // 1
8}
複製

eth_getBlockTransactionCountByHash

傳回區塊中從符合給定區塊雜湊值的交易數量。

參數

  1. 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" // 139
8}
複製

eth_getBlockTransactionCountByNumber

傳回與給定區塊編號相符的區塊中的交易數量。

參數

  1. QUANTITY|TAG - 整數區塊編號,或字串 "earliest""latest""pending""safe""finalized",如預設區塊參數所示。
1params: [
2 "0x13738ca", // 20396234
3]
複製

傳回

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" // 139
8}
複製

eth_getUncleCountByBlockHash

傳回區塊中符合給定區塊雜湊值的叔塊數量。

參數

  1. 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" // 1
8}
複製

eth_getUncleCountByBlockNumber

傳回區塊中符合給定區塊編號的叔塊數量。

參數

  1. QUANTITY|TAG - 整數區塊編號,或字串 "latest""earliest""pending""safe""finalized",請參閱預設區塊參數
1params: [
2 "0xe8", // 232
3]
複製

傳回

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" // 0
8}
複製

eth_getCode

傳回給定地址的程式碼。

參數

  1. DATA,20 位元組 - 地址
  2. QUANTITY|TAG - 整數區塊編號,或字串 "latest""earliest""pending""safe""finalized",請參閱預設區塊參數
1params: [
2 "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
3 "0x5daf3b", // 6139707
4]
複製

傳回

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)))

透過在訊息中加入前綴,可以將計算出的簽章識別為以太坊特定簽章。 這可以防止濫用,即惡意去中心化應用程式簽署任意資料(例如交易)並使用簽章來冒充受害者。

注意:要簽章的地址必須解鎖。

參數

  1. DATA,20 位元組 - 地址
  2. DATA,N 位元組 - 要簽署的訊息。

傳回

DATA:簽章

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
複製

eth_signTransaction

簽署交易,稍後可使用 eth_sendRawTransaction 將交易提交到網路。

參數

  1. Object - 交易物件
  • type:
  • from: DATA,20 位元組 - 發送交易的地址。
  • to: DATA 20 位元組 -(建立新合約時可選)交易指向的地址。
  • gas: QUANTITY -(可選,預設:90000)表示為交易執行提供的燃料的整數。 將傳回未使用的燃料。
  • gasPrice: QUANTITY -(可選,預設:尚未決定)表示每次支付燃料時的燃料價格的整數(單位為 Wei)。
  • value: QUANTITY -(可選)表示與此交易一起傳送的值的整數(單位為 Wei)。
  • data: DATA - 合約的編譯程式碼,或叫用的方法簽章和編碼參數的雜湊。
  • nonce: QUANTITY -(可選)表示隨機數的整數。 這允許覆寫你自己的使用相同隨機數的待處理交易。

傳回

DATA,特定帳戶簽署的遞迴長度前綴編碼的交易物件。

範例

1// Request
2curl -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// Result
4{
5 "id": 1,
6 "jsonrpc": "2.0",
7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
8}
複製

eth_sendTransaction

如果資料欄位包含程式碼,則建立新的訊息呼叫交易或建立合約,並使用 from 中指定的帳戶對其進行簽署。

參數

  1. 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", // 30400
6 gasPrice: "0x9184e72a000", // 10000000000000
7 value: "0x9184e72a", // 2441406250
8 input:
9 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
10 },
11]
顯示全部
複製

傳回

DATA,32 位元組 - 交易雜湊值,如果交易尚未可用則為零雜湊值。

建立合約時,在區塊中提議交易後,使用 eth_getTransactionReceipt 取得合約地址。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
複製

eth_sendRawTransaction

建立新的訊息呼叫交易或為簽署的交易建立合約。

參數

  1. DATA,簽署的交易資料。
1params: [
2 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
3]
複製

傳回

DATA,32 位元組 - 交易雜湊值,如果交易尚未可用則為零雜湊值。

建立合約時,在區塊中提議交易後,使用 eth_getTransactionReceipt 取得合約地址。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
8}
複製

eth_call

立即執行一個新的訊息呼叫,但不在區塊鏈上建立交易。 通常用於執行唯讀智慧型合約函式,例如 ERC-20 合約的 balanceOf

參數

  1. Object - 交易呼叫物件
  1. QUANTITY|TAG - 整數區塊編號,或字串 "latest""earliest""pending""safe""finalized",請參閱預設區塊參數

傳回

DATA - 已執行合約的傳回值。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x"
8}
複製

eth_estimateGas

產生和傳回完成交易所必需的燃料量預估值。 交易將不會新增至區塊鏈。 請注意,由於以太坊虛擬機機制和節點效能等種種原因,預估值可能明顯地大於交易實際使用的燃料量。

參數

請參閱 <0>eth_call</0> 參數,但所有屬性都是可選的。 假如沒有明確說明燃料限制,Geth 將使用來自待處理區塊的區塊燃料限制作為上限。 因此,當燃料量高於待處理區塊燃料限制時,傳回的預估值可能不足以執行呼叫或交易。

傳回

QUANTITY - 使用的燃料數量。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x5208" // 21000
8}
複製

eth_getBlockByHash

根據雜湊值傳回區塊資訊。

參數

  1. DATA,32 位元組 - 區塊的雜湊值。
  2. 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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'
3// Result
4{
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

根據區塊編號傳回關於區塊的資訊。

參數

  1. QUANTITY|TAG - 整數區塊編號,或字串 "earliest""latest""pending""safe""finalized",如預設區塊參數所示。
  2. Boolean - 如果為 true,傳回完整交易物件,如果為 false,只傳回交易的雜湊值。
1params: [
2 "0x1b4", // 436
3 true,
4]
複製

傳回 請參與 eth_getBlockByHash

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'
複製

結果請參閱 eth_getBlockByHash

eth_getTransactionByHash

傳回有關按交易雜湊值請求的交易的資訊。

參數

  1. 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 - 橢圓曲線數位簽章演算法復原 ID
  • r: QUANTITY - 橢圓曲線數位簽章演算法簽章 r
  • s: QUANTITY - 橢圓曲線數位簽章演算法簽章 s

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'
3// Result
4{
5 "jsonrpc":"2.0",
6 "id":1,
7 "result":{
8 "blockHash":"0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
9 "blockNumber":"0x5daf3b", // 6139707
10 "from":"0xa7d9ddbe1f17865597fbd27ec712455208b6b76d",
11 "gas":"0xc350", // 50000
12 "gasPrice":"0x4a817c800", // 20000000000
13 "hash":"0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b",
14 "input":"0x68656c6c6f21",
15 "nonce":"0x15", // 21
16 "to":"0xf02c1c8e6114b1dbe8937a39260b5b0a374432bb",
17 "transactionIndex":"0x41", // 65
18 "value":"0xf3dbb76162000", // 4290000000000000
19 "v":"0x25", // 37
20 "r":"0x1b5e176d927f8e9ab405058b2d2457392da3e20f328b16ddabcebc33eaac5fea",
21 "s":"0x4ba69724e8f69de52f0125ad8b3c5c2cef33019bac3249e2c0a2192766d1721c"
22 }
23}
顯示全部
複製

eth_getTransactionByBlockHashAndIndex

按區塊雜湊值和交易索引位置傳回有關交易的資訊。

參數

  1. DATA,32 位元組 - 區塊的雜湊值。
  2. QUANTITY - 表示交易索引位置的整數。
1params: [
2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3 "0x0", // 0
4]
複製

傳回 請參閱 eth_getTransactionByHash

範例

1// 請求
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
複製

結果請參閱 eth_getTransactionByHash

eth_getTransactionByBlockNumberAndIndex

按區塊編號和交易索引位置傳回有關交易的資訊。

參數

  1. QUANTITY|TAG - 區塊編號,或字串 "earliest""latest""pending""safe""finalized",如預設區塊參數所示。
  2. QUANTITY - 交易索引位置。
1params: [
2 "0x9c47cf", // 10241999
3 "0x24", // 36
4]
複製

傳回 請參閱 eth_getTransactionByHash

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'
複製

結果請參閱 eth_getTransactionByHash

eth_getTransactionReceipt

按交易雜湊值返回交易的收據。

注意待處理交易沒有收據。

參數

  1. 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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'
3// Result
4{
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 created
12 "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 filter
20 "status": "0x1",
21 "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
22 "transactionHash":
23 "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",
24 "transactionIndex": "0x66",
25 "type": "0x2"
26 }
27}
顯示全部
複製

eth_getUncleByBlockHashAndIndex

按雜湊值和叔塊索引位置傳回關於區塊的叔塊資訊。

參數

  1. DATA,32 位元組 - 區塊的雜湊值。
  2. QUANTITY - 叔塊的索引位置。
1params: [
2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
3 "0x0", // 0
4]
複製

傳回 請參與 eth_getBlockByHash

範例

1// 請求
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'
複製

結果請參閱 eth_getBlockByHash

注意:叔塊不包含單獨交易。

eth_getUncleByBlockNumberAndIndex

按編號和叔塊索引位置傳回關於區塊的叔塊資訊。

參數

  1. QUANTITY|TAG - 區塊編號,或字串 "earliest""latest""pending""safe""finalized",如預設區塊參數所示。
  2. QUANTITY - 叔塊的索引位置。
1params: [
2 "0x29c", // 668
3 "0x0", // 0
4]
複製

傳回 請參與 eth_getBlockByHash

注意:叔塊不包含單獨交易。

範例

1// Request
2curl -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)(其後為任意值)」
  • 參數
  1. 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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x1" // 1
8}
複製

eth_newBlockFilter

在節點中建立一個篩選條件,以在新區塊到達時發出通知。 檢查狀態是否改變,呼叫 eth_getFilterChanges

參數

傳回 QUANTITY - 篩選條件 ID。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x1" // 1
8}
複製

eth_newPendingTransactionFilter

在節點中建立一個篩選條件,以在新的待處理交易到達時發出通知。 檢查狀態是否改變,呼叫 eth_getFilterChanges

參數

傳回 QUANTITY - 篩選條件 ID。

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": "0x1" // 1
8}
複製

eth_uninstallFilter

根據給定 ID 解除安裝篩選條件。 當不再需要監視時,應始終對其進行呼叫。 另外,當在一段時間內未使用 eth_getFilterChanges 請求篩選條件時,篩選條件會逾時。

參數

  1. QUANTITY - 篩選條件 ID。
1params: [
2 "0xb", // 11
3]
複製

傳回 Boolean - 如果成功解除安裝篩選條件,則為 true,否則為 false

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
3// Result
4{
5 "id":1,
6 "jsonrpc": "2.0",
7 "result": true
8}
複製

eth_getFilterChanges

篩選條件輪詢方法,傳回自從上次輪詢後產生的日誌陣列。

參數

  1. QUANTITY - 篩選條件 ID。
1params: [
2 "0x16", // 22
3]
複製

傳回 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// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'
3// Result
4{
5 "id":1,
6 "jsonrpc":"2.0",
7 "result": [{
8 "logIndex": "0x1", // 1
9 "blockNumber":"0x1b4", // 436
10 "blockHash": "0x8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcfdf829c5a142f1fccd7d",
11 "transactionHash": "0xdf829c5a142f1fccd7d8216c5785ac562ff41e2dcfdf5785ac562ff41e2dcf",
12 "transactionIndex": "0x0", // 0
13 "address": "0x16c5785ac562ff41e2dcfdf829c5a142f1fccd7d",
14 "data":"0x0000000000000000000000000000000000000000000000000000000000000000",
15 "topics": ["0x59ebeb90bc63057b6515673c3ecf9438e5058bca0f92585014eced636878c9a5"]
16 },{
17 ...
18 }]
19}
顯示全部
複製

eth_getFilterLogs

傳回與給定 ID 之篩選條件相符的所有日誌的陣列。

參數

  1. QUANTITY - 篩選條件 ID。
1params: [
2 "0x16", // 22
3]
複製

傳回 請參閱 eth_getFilterChanges

範例

1// Request
2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'
複製

結果請參閱 eth_getFilterChanges

eth_getLogs

傳回與給定篩選條件物件相符的所有日誌的陣列。

參數

  1. 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 出現在篩選條件中,則 fromBlocktoBlock 都不允許使用。
1params: [
2 {
3 topics: [
4 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
5 ],
6 },
7]
複製

傳回 請參閱 eth_getFilterChanges

範例

1// Request
2curl -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 需要若干引數,特別是 fromtodataFrom 是我們帳戶的公共地址,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: 0
16 }],
17 transactionHash: "0x759cf065cbc22e9d779748dc53763854e5376eea07409e590c990eafc0869d74",
18 transactionIndex: 0
19}
顯示全部

收據包含了日誌。 此日誌由以太坊虛擬機在交易執行時產生並包含在收據中。 multiply 函式顯示 Print 事件在輸入乘以 7 時觸發。 由於 Print 事件的引數是 uint256,我們可以根據應用程式二進位介面規則對其進行解碼,得到預期的十進位數 42。 除了資料之外,值得注意的是,主題可用於確定哪個事件建立了日誌:

1web3.sha3("Print(uint256)")
2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"

這只是對一些最常見任務的簡要介紹,演示了 JSON-RPC 的直接使用。

  • JSON-RPC 規範(opens in a new tab)
  • 節點和用戶端
  • Javascript 應用程式介面
  • 後端應用程式介面
  • 執行用戶端

這篇文章對你有幫助嗎?