API JSON-RPC
Lần cập nhật trang lần cuối: 23 tháng 2, 2026
Để một ứng dụng phần mềm có thể tương tác với chuỗi khối Ethereum - bằng cách đọc dữ liệu chuỗi khối hoặc gửi giao dịch tới mạng - nó phải kết nối với một nút Ethereum.
Vì mục đích này, mọi máy khách Ethereum đều triển khai một đặc tả JSON-RPCopens in a new tab, do đó có một bộ phương thức thống nhất mà các ứng dụng có thể dựa vào bất kể việc triển khai nút hoặc máy khách cụ thể nào.
JSON-RPCopens in a new tab là một giao thức gọi thủ tục từ xa (RPC) không trạng thái, nhẹ. Nó xác định một số cấu trúc dữ liệu và các quy tắc xung quanh việc xử lý chúng. Nó không phụ thuộc vào phương tiện truyền tải ở chỗ các khái niệm có thể được sử dụng trong cùng một quy trình, qua các ổ cắm, qua HTTP, hoặc trong nhiều môi trường truyền thông điệp khác nhau. Nó sử dụng JSON (RFC 4627) làm định dạng dữ liệu.
Triển khai máy khách
Mỗi máy khách Ethereum có thể sử dụng các ngôn ngữ lập trình khác nhau khi triển khai đặc tả JSON-RPC. Xem tài liệu tham khảo của từng máy khách để biết thêm chi tiết liên quan đến các ngôn ngữ lập trình cụ thể. Chúng tôi khuyên bạn nên kiểm tra tài liệu tham khảo của từng máy khách để biết thông tin hỗ trợ Giao diện Lập trình Ứng dụng mới nhất.
Thư viện tiện lợi
Mặc dù bạn có thể chọn tương tác trực tiếp với các máy khách Ethereum thông qua Giao diện Lập trình Ứng dụng JSON-RPC, nhưng thường có các tùy chọn dễ dàng hơn cho các nhà phát triển ứng dụng phi tập trung. Nhiều thư viện JavaScript và Giao diện Lập trình Ứng dụng backend tồn tại để cung cấp các trình bao bọc trên Giao diện Lập trình Ứng dụng JSON-RPC. Với các thư viện này, các nhà phát triển có thể viết các phương thức trực quan, một dòng bằng ngôn ngữ lập trình mà họ chọn để khởi tạo các yêu cầu JSON-RPC (ngầm) tương tác với Ethereum.
Các Giao diện Lập trình Ứng dụng của máy khách đồng thuận
Trang này chủ yếu đề cập đến Giao diện Lập trình Ứng dụng JSON-RPC được sử dụng bởi các máy khách thực thi Ethereum. Tuy nhiên, các máy khách đồng thuận cũng có một Giao diện Lập trình Ứng dụng RPC cho phép người dùng truy vấn thông tin về nút, yêu cầu các khối Beacon, trạng thái Beacon và các thông tin khác liên quan đến sự đồng thuận trực tiếp từ một nút. Giao diện Lập trình Ứng dụng này được ghi lại trên trang web Giao diện Lập trình Ứng dụng Beaconopens in a new tab.
Một Giao diện Lập trình Ứng dụng nội bộ cũng được sử dụng để liên lạc giữa các máy khách trong một nút - nghĩa là nó cho phép máy khách đồng thuận và máy khách thực thi hoán đổi dữ liệu. Đây được gọi là 'Engine API' và các thông số kỹ thuật có sẵn trên GitHubopens in a new tab.
Đặc tả máy khách thực thi
Đọc toàn bộ đặc tả Giao diện Lập trình Ứng dụng JSON-RPC trên GitHubopens in a new tab. Giao diện Lập trình Ứng dụng này được ghi lại trên trang web Giao diện Lập trình Ứng dụng Thực thiopens in a new tab và bao gồm một Trình kiểm tra để dùng thử tất cả các phương thức có sẵn.
Quy ước
Mã hóa giá trị hex
Hai loại dữ liệu chính được chuyển qua JSON: mảng byte chưa định dạng và số lượng. Cả hai đều được chuyển bằng mã hóa hex nhưng với các yêu cầu định dạng khác nhau.
Số lượng
Khi mã hóa số lượng (số nguyên, số): mã hóa dưới dạng hex, có tiền tố "0x", dạng biểu diễn nhỏ gọn nhất (ngoại lệ nhỏ: số không phải được biểu diễn dưới dạng "0x0").
Đây là một vài ví dụ:
- 0x41 (65 trong hệ thập phân)
- 0x400 (1024 trong hệ thập phân)
- SAI: 0x (phải luôn có ít nhất một chữ số - số không là "0x0")
- SAI: 0x0400 (không cho phép số không ở đầu)
- SAI: ff (phải có tiền tố 0x)
Dữ liệu chưa được định dạng
Khi mã hóa dữ liệu chưa định dạng (mảng byte, địa chỉ tài khoản, hàm băm, mảng bytecode): mã hóa dưới dạng hex, có tiền tố "0x", hai chữ số hex trên mỗi byte.
Đây là một vài ví dụ:
- 0x41 (kích thước 1, "A")
- 0x004200 (kích thước 3, "0B0")
- 0x (kích thước 0, "")
- SAI: 0xf0f0f (phải là số chẵn các chữ số)
- SAI: 004200 (phải có tiền tố 0x)
Thông số khối
Các phương thức sau có thông số khối:
Khi các yêu cầu được thực hiện để truy vấn trạng thái của Ethereum, thông số khối được cung cấp sẽ xác định chiều cao của khối.
Các tùy chọn sau đây có thể có cho thông số khối:
Chuỗi HEX- một số khối nguyênChuỗi "earliest"cho khối sớm nhất/khối khởi nguyênChuỗi "latest"- cho khối được đề xuất mới nhấtChuỗi "safe"- cho khối tiêu đề an toàn mới nhấtChuỗi "finalized"- cho khối đã hoàn tất mới nhấtChuỗi "pending"- cho trạng thái/giao dịch đang chờ xử lý
Ví dụ
Trên trang này, chúng tôi cung cấp các ví dụ về cách sử dụng các điểm cuối API JSON_RPC riêng lẻ bằng công cụ dòng lệnh, curlopens in a new tab. Các ví dụ điểm cuối riêng lẻ này được tìm thấy bên dưới trong phần Ví dụ về Curl. Ở phần sau của trang, chúng tôi cũng cung cấp một ví dụ từ đầu đến cuối để biên dịch và triển khai một hợp đồng thông minh bằng cách sử dụng một nút Geth, Giao diện Lập trình Ứng dụng JSON_RPC và curl.
Ví dụ về Curl
Các ví dụ về việc sử dụng Giao diện Lập trình Ứng dụng JSON_RPC bằng cách thực hiện các yêu cầu curlopens in a new tab tới một nút Ethereum được cung cấp bên dưới. Mỗi ví dụ bao gồm mô tả về điểm cuối cụ thể, các tham số, loại trả về của nó và một ví dụ đã thực hiện về cách sử dụng nó.
Các yêu cầu curl có thể trả về một thông điệp lỗi liên quan đến loại nội dung. Điều này là do tùy chọn --data đặt loại nội dung thành application/x-www-form-urlencoded. Nếu nút của bạn phàn nàn về điều này, hãy đặt tiêu đề theo cách thủ công bằng cách đặt -H "Content-Type: application/json" ở đầu cuộc gọi. Các ví dụ cũng không bao gồm tổ hợp URL/IP & cổng phải là đối số cuối cùng được cung cấp cho curl (ví dụ: 127.0.0.1:8545). Một yêu cầu curl hoàn chỉnh bao gồm các dữ liệu bổ sung này có dạng sau:
1curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545Gossip, Trạng thái, Lịch sử
Một số phương pháp JSON-RPC cốt lõi yêu cầu dữ liệu từ mạng Ethereum và được phân loại gọn gàng thành ba loại chính: Gossip, Trạng thái và Lịch sử. Sử dụng các liên kết trong các phần này để chuyển đến từng phương thức hoặc sử dụng bảng mục lục để khám phá toàn bộ danh sách các phương thức.
Phương pháp Gossip
Các phương pháp này theo dõi phần đầu của chuỗi. Đây là cách các giao dịch đi vòng quanh mạng, tìm đường vào các khối và cách các máy khách tìm hiểu về các khối mới.
Phương pháp Trạng thái
Các phương pháp báo cáo trạng thái hiện tại của tất cả dữ liệu được lưu trữ. "Trạng thái" giống như một phần RAM lớn được chia sẻ và bao gồm số dư tài khoản, dữ liệu hợp đồng và ước tính gas.
Các phương pháp lịch sử
Truy xuất các bản ghi lịch sử của mọi khối trở lại khối khởi nguyên. Đây giống như một tệp chỉ có thể nối thêm lớn và bao gồm tất cả các tiêu đề khối, nội dung khối, khối chú và biên lai giao dịch.
- eth_getBlockTransactionCountByHash
- eth_getBlockTransactionCountByNumber
- eth_getUncleCountByBlockHash
- eth_getUncleCountByBlockNumber
- eth_getBlockByHash
- eth_getBlockByNumber
- eth_getTransactionByHash
- eth_getTransactionByBlockHashAndIndex
- eth_getTransactionByBlockNumberAndIndex
- eth_getTransactionReceipt
- eth_getUncleByBlockHashAndIndex
- eth_getUncleByBlockNumberAndIndex
Sân chơi API JSON-RPC
Bạn có thể sử dụng công cụ sân chơiopens in a new tab để khám phá và dùng thử các phương thức Giao diện Lập trình Ứng dụng. Nó cũng cho bạn thấy những phương pháp và mạng nào được hỗ trợ bởi các nhà cung cấp nút khác nhau.
Các phương thức Giao diện Lập trình Ứng dụng JSON-RPC
web3_clientVersion
Trả về phiên bản máy khách hiện tại.
Tham số
Không
Trả về
Chuỗi - Phiên bản máy khách hiện tại
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'3// Kết quả4{5 "id":67,6 "jsonrpc":"2.0",7 "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"8}web3_sha3
Trả về Keccak-256 (không phải SHA3-256 được tiêu chuẩn hóa) của dữ liệu đã cho.
Tham số
DATA- Dữ liệu để chuyển đổi thành một hàm băm SHA3
1params: ["0x68656c6c6f20776f726c64"]Trả về
DATA - Kết quả SHA3 của chuỗi đã cho.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'3// Kết quả4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"8}net_version
Trả về id mạng hiện tại.
Tham số
Không
Trả về
Chuỗi - Id mạng hiện tại.
Danh sách đầy đủ các ID mạng hiện tại có tại chainlist.orgopens in a new tab. Một số cái phổ biến là:
1: Ethereum Mainnet11155111: Mạng thử nghiệm Sepolia560048: Mạng thử nghiệm Hoodi
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'3// Kết quả4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "3"8}net_listening
Trả về true nếu máy khách đang tích cực lắng nghe các kết nối mạng.
Tham số
Không
Trả về
Boolean - true khi đang lắng nghe, nếu không thì là false.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'3// Kết quả4{5 "id":67,6 "jsonrpc":"2.0",7 "result":true8}net_peerCount
Trả về số lượng peer hiện đang được kết nối với máy khách.
Tham số
Không
Trả về
QUANTITY - số nguyên của số peer đã kết nối.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'3// Kết quả4{5 "id":74,6 "jsonrpc": "2.0",7 "result": "0x2" // 28}eth_protocolVersion
Trả về phiên bản giao thức Ethereum hiện tại. Lưu ý rằng phương pháp này không có sẵn trong Gethopens in a new tab.
Tham số
Không
Trả về
Chuỗi - Phiên bản giao thức Ethereum hiện tại
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'3// Kết quả4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "54"8}eth_syncing
Trả về một đối tượng có dữ liệu về trạng thái đồng bộ hóa hoặc false.
Tham số
Không
Trả về
Dữ liệu trả về chính xác khác nhau giữa các lần triển khai máy khách. Tất cả các máy khách đều trả về False khi nút không đồng bộ hóa và tất cả các máy khách đều trả về các trường sau.
Object|Boolean, Một đối tượng có dữ liệu trạng thái đồng bộ hóa hoặc FALSE, khi không đồng bộ hóa:
startingBlock:QUANTITY- Khối mà tại đó quá trình nhập bắt đầu (sẽ chỉ được đặt lại sau khi quá trình đồng bộ hóa đạt đến phần đầu của nó)currentBlock:QUANTITY- Khối hiện tại, giống như eth_blockNumberhighestBlock:QUANTITY- Khối cao nhất ước tính
Tuy nhiên, các máy khách riêng lẻ cũng có thể cung cấp dữ liệu bổ sung. Ví dụ: Geth trả về như sau:
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}Hiện tất cảTrong khi đó Besu trả về:
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}Hiện tất cảTham khảo tài liệu tham khảo cho máy khách cụ thể của bạn để biết thêm chi tiết.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_syncing","params":[],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": {8 startingBlock: '0x384',9 currentBlock: '0x386',10 highestBlock: '0x454'11 }12}13// Hoặc khi không đồng bộ hóa14{15 "id":1,16 "jsonrpc": "2.0",17 "result": false18}Hiện tất cảeth_coinbase
Trả về địa chỉ coinbase của máy khách.
Thử điểm cuối trong sân chơiopens in a new tabLưu ý: Phương pháp này đã không được dùng nữa kể từ v1.14.0 và không còn được hỗ trợ. Cố gắng sử dụng phương pháp này sẽ dẫn đến lỗi "Phương pháp không được hỗ trợ".
Tham số
Không
Trả về
DATA, 20 byte - địa chỉ coinbase hiện tại.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'3// Kết quả4{5 "id":64,6 "jsonrpc": "2.0",7 "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"8}eth_chainId
Trả về ID chuỗi được sử dụng để ký các giao dịch được bảo vệ chống phát lại.
Thử điểm cuối trong sân chơiopens in a new tabTham số
Không
Trả về
chainId, giá trị thập lục phân dưới dạng một chuỗi đại diện cho số nguyên của id chuỗi hiện tại.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'3// Kết quả4{5 "id":67,6 "jsonrpc": "2.0",7 "result": "0x1"8}eth_mining
Trả về true nếu máy khách đang tích cực khai thác các khối mới. Điều này chỉ có thể trả về true cho các mạng bằng chứng công việc và có thể không có sẵn trong một số máy khách kể từ khi có The Merge.
Tham số
Không
Trả về
Boolean - trả về true nếu máy khách đang khai thác, ngược lại là false.
Ví dụ
1// Yêu cầu2curl -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
Trả về số lượng hàm băm mỗi giây mà nút đang khai thác. Điều này chỉ có thể trả về true cho các mạng bằng chứng công việc và có thể không có sẵn trong một số máy khách kể từ khi có The Merge.
Tham số
Không
Trả về
QUANTITY - số lượng hàm băm mỗi giây.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'3// Kết quả4{5 "id":71,6 "jsonrpc": "2.0",7 "result": "0x38a"8}eth_gasPrice
Trả về ước tính giá hiện tại cho mỗi gas tính bằng wei. Ví dụ, máy khách Besu kiểm tra 100 khối cuối cùng và trả về giá đơn vị gas trung bình theo mặc định.
Thử điểm cuối trong sân chơiopens in a new tabTham số
Không
Trả về
QUANTITY - số nguyên của giá gas hiện tại tính bằng wei.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'3// Kết quả4{5 "id":73,6 "jsonrpc": "2.0",7 "result": "0x1dfd14000" // 8049999872 Wei8}eth_accounts
Trả về một danh sách các địa chỉ thuộc sở hữu của máy khách.
Thử điểm cuối trong sân chơiopens in a new tabTham số
Không
Trả về
Mảng DATA, 20 Byte - các địa chỉ thuộc sở hữu của máy khách.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]8}eth_blockNumber
Trả về số của khối gần đây nhất.
Thử điểm cuối trong sân chơiopens in a new tabTham số
Không
Trả về
QUANTITY - số nguyên của số khối hiện tại mà máy khách đang ở.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'3// Kết quả4{5 "id":83,6 "jsonrpc": "2.0",7 "result": "0x4b7" // 12078}eth_getBalance
Trả về số dư của tài khoản tại một địa chỉ nhất định.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 20 Byte - địa chỉ để kiểm tra số dư.QUANTITY|TAG- số khối nguyên, hoặc chuỗi"latest","earliest","pending","safe", hoặc"finalized", xem thông số khối
1params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]Trả về
QUANTITY - số nguyên của số dư hiện tại tính bằng wei.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0234c8a3397aab58" // 1589724902343750008}eth_getStorageAt
Trả về giá trị từ một vị trí lưu trữ tại một địa chỉ đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 20 Byte - địa chỉ của kho lưu trữ.QUANTITY- số nguyên của vị trí trong kho lưu trữ.QUANTITY|TAG- số khối nguyên, hoặc chuỗi"latest","earliest","pending","safe","finalized", xem thông số khối
Trả về
DATA - giá trị tại vị trí lưu trữ này.
Ví dụ
Việc tính toán vị trí chính xác phụ thuộc vào kho lưu trữ cần truy xuất. Hãy xem xét hợp đồng sau đây được triển khai tại 0x295a70b2de5e3953354a6a8344e616ed314d7251 bởi địa chỉ 0x391694e7e0b0cce554cb130d723a9d27458f9298.
1contract Storage {2 uint pos0;3 mapping(address => uint) pos1;4 constructor() {5 pos0 = 1234;6 pos1[msg.sender] = 5678;7 }8}Việc truy xuất giá trị của pos0 rất đơn giản:
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"}Việc truy xuất một phần tử của bản đồ khó hơn. Vị trí của một phần tử trong bản đồ được tính bằng:
1keccak(LeftPad32(key, 0), LeftPad32(map position, 0))Điều này có nghĩa là để truy xuất kho lưu trữ trên pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"], chúng ta cần tính toán vị trí với:
1keccak(2 decodeHex(3 "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +4 "0000000000000000000000000000000000000000000000000000000000000001"5 )6)Bảng điều khiển geth đi kèm với thư viện web3 có thể được sử dụng để thực hiện tính toán:
1> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"2undefined3> web3.sha3(key, {"encoding": "hex"})4"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"Bây giờ để tìm nạp kho lưu trữ:
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
Trả về số lượng giao dịch đã gửi từ một địa chỉ.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 20 Byte - địa chỉ.QUANTITY|TAG- số khối nguyên, hoặc chuỗi"latest","earliest","pending","safe"hoặc"finalized", xem thông số khối
1params: [2 "0x407d73d8a49eeb85d32cf465507dd71d507100c1",3 "latest", // trạng thái ở khối mới nhất4]Trả về
QUANTITY - số nguyên của số lượng giao dịch được gửi từ địa chỉ này.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}eth_getBlockTransactionCountByHash
Trả về số lượng giao dịch trong một khối từ một khối khớp với hàm băm khối đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - hàm băm của một khối
1params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]Trả về
QUANTITY - số nguyên của số lượng giao dịch trong khối này.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}eth_getBlockTransactionCountByNumber
Trả về số lượng giao dịch trong một khối khớp với số khối đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
QUANTITY|TAG- số nguyên của một số khối, hoặc chuỗi"earliest","latest","pending","safe"hoặc"finalized", như trong thông số khối.
1params: [2 "0x13738ca", // 203962343]Trả về
QUANTITY - số nguyên của số lượng giao dịch trong khối này.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x8b" // 1398}eth_getUncleCountByBlockHash
Trả về số lượng khối chú trong một khối từ một khối khớp với hàm băm khối đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - hàm băm của một khối
1params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]Trả về
QUANTITY - số nguyên của số lượng khối chú trong khối này.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}eth_getUncleCountByBlockNumber
Trả về số lượng khối chú trong một khối từ một khối khớp với số khối đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
QUANTITY|TAG- số nguyên của một số khối, hoặc chuỗi"latest","earliest","pending","safe"hoặc"finalized", xem thông số khối
1params: [2 "0xe8", // 2323]Trả về
QUANTITY - số nguyên của số lượng khối chú trong khối này.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x0" // 08}eth_getCode
Trả về mã tại một địa chỉ đã cho.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 20 Byte - địa chỉQUANTITY|TAG- số khối nguyên, hoặc chuỗi"latest","earliest","pending","safe"hoặc"finalized", xem thông số khối
1params: [2 "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",3 "0x5daf3b", // 61397074]Trả về
DATA - mã từ địa chỉ đã cho.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"8}eth_sign
Phương pháp ký tính toán một chữ ký cụ thể của Ethereum với: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).
Bằng cách thêm một tiền tố vào thông điệp, chữ ký được tính toán có thể được nhận dạng là một chữ ký cụ thể của Ethereum. Điều này ngăn chặn việc lạm dụng khi một ứng dụng phi tập trung độc hại có thể ký dữ liệu tùy ý (ví dụ: giao dịch) và sử dụng chữ ký để mạo danh nạn nhân.
Lưu ý: địa chỉ để ký phải được mở khóa.
Tham số
DATA, 20 Byte - địa chỉDATA, N Byte - thông điệp cần ký
Trả về
DATA: Chữ ký
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}eth_signTransaction
Ký một giao dịch có thể được gửi đến mạng sau này bằng eth_sendRawTransaction.
Tham số
Object- Đối tượng giao dịch
type:from:DATA, 20 Byte - Địa chỉ mà giao dịch được gửi từ đó.to:DATA, 20 Byte - (tùy chọn khi tạo hợp đồng mới) Địa chỉ mà giao dịch được chuyển đến.gas:QUANTITY- (tùy chọn, mặc định: 90000) Số nguyên của gas được cung cấp cho việc thực hiện giao dịch. Nó sẽ trả lại lượng gas không sử dụng.gasPrice:QUANTITY- (tùy chọn, mặc định: Sẽ được xác định) Số nguyên của gasPrice được sử dụng cho mỗi gas đã thanh toán, tính bằng Wei.value:QUANTITY- (tùy chọn) Số nguyên của giá trị được gửi cùng với giao dịch này, tính bằng Wei.data:DATA- Mã đã biên dịch của hợp đồng HOẶC hàm băm của chữ ký phương thức được gọi và các tham số được mã hóa.nonce:QUANTITY- (tùy chọn) Số nguyên của một nonce. Điều này cho phép ghi đè các giao dịch đang chờ xử lý của chính bạn sử dụng cùng một nonce.
Trả về
DATA, Đối tượng giao dịch được mã hóa RLP do tài khoản đã chỉ định ký.
Ví dụ
1// Yêu cầu2curl -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// Kết quả4{5 "id": 1,6 "jsonrpc": "2.0",7 "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"8}eth_sendTransaction
Tạo giao dịch gọi hàm nhắn tin mới hoặc tạo hợp đồng, nếu trường dữ liệu chứa mã và ký bằng tài khoản được chỉ định trong from.
Tham số
Object- Đối tượng giao dịch
from:DATA, 20 Byte - Địa chỉ mà giao dịch được gửi từ đó.to:DATA, 20 Byte - (tùy chọn khi tạo hợp đồng mới) Địa chỉ mà giao dịch được chuyển đến.gas:QUANTITY- (tùy chọn, mặc định: 90000) Số nguyên của gas được cung cấp cho việc thực hiện giao dịch. Nó sẽ trả lại lượng gas không sử dụng.gasPrice:QUANTITY- (tùy chọn, mặc định: Sẽ được xác định) Số nguyên của gasPrice được sử dụng cho mỗi gas đã thanh toán.value:QUANTITY- (tùy chọn) Số nguyên của giá trị được gửi cùng với giao dịch này.input:DATA- Mã đã biên dịch của hợp đồng HOẶC hàm băm của chữ ký phương thức được gọi và các tham số được mã hóa.nonce:QUANTITY- (tùy chọn) Số nguyên của một nonce. Điều này cho phép ghi đè các giao dịch đang chờ xử lý của chính bạn sử dụng cùng một nonce.
1params: [2 {3 from: "0xb60e8dd61c5d32be8058bb8eb970870f07233155",4 to: "0xd46e8dd67c5d32be8058bb8eb970870f07244567",5 gas: "0x76c0", // 304006 gasPrice: "0x9184e72a000", // 100000000000007 value: "0x9184e72a", // 24414062508 input:9 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",10 },11]Hiện tất cảTrả về
DATA, 32 Byte - hàm băm giao dịch hoặc hàm băm không nếu giao dịch chưa có sẵn.
Sử dụng eth_getTransactionReceipt để lấy địa chỉ hợp đồng, sau khi giao dịch được đề xuất trong một khối, khi bạn tạo một hợp đồng.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}eth_sendRawTransaction
Tạo giao dịch gọi hàm nhắn tin mới hoặc tạo hợp đồng cho các giao dịch đã ký.
Tham số
DATA, Dữ liệu giao dịch đã ký.
1params: [2 "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",3]Trả về
DATA, 32 Byte - hàm băm giao dịch hoặc hàm băm không nếu giao dịch chưa có sẵn.
Sử dụng eth_getTransactionReceipt để lấy địa chỉ hợp đồng, sau khi giao dịch được đề xuất trong một khối, khi bạn tạo một hợp đồng.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"8}eth_call
Thực hiện một gọi hàm nhắn tin mới ngay lập tức mà không cần tạo một giao dịch trên chuỗi khối. Thường được sử dụng để thực thi các hàm hợp đồng thông minh chỉ đọc, ví dụ như balanceOf cho hợp đồng ERC-20.
Tham số
Object- Đối tượng gọi giao dịch
from:DATA, 20 Byte - (tùy chọn) Địa chỉ mà giao dịch được gửi từ đó.to:DATA, 20 Byte - Địa chỉ mà giao dịch được chuyển đến.gas:QUANTITY- (tùy chọn) Số nguyên của gas được cung cấp cho việc thực hiện giao dịch. eth_call tiêu thụ không gas, nhưng tham số này có thể cần thiết cho một số lần thực hiện.gasPrice:QUANTITY- (tùy chọn) Số nguyên của gasPrice được sử dụng cho mỗi gas đã thanh toánvalue:QUANTITY- (tùy chọn) Số nguyên của giá trị được gửi cùng với giao dịch nàyinput:DATA- (tùy chọn) Hàm băm của chữ ký phương thức và các tham số được mã hóa. Để biết chi tiết, xem Giao diện nhị phân ứng dụng Hợp đồng Ethereum trong tài liệu tham khảo Solidityopens in a new tab.
QUANTITY|TAG- số khối nguyên, hoặc chuỗi"latest","earliest","pending","safe"hoặc"finalized", xem thông số khối
Trả về
DATA - giá trị trả về của hợp đồng đã thực hiện.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x"8}eth_estimateGas
Tạo và trả về một ước tính về lượng gas cần thiết để cho phép giao dịch hoàn tất. Giao dịch sẽ không được thêm vào chuỗi khối. Lưu ý rằng ước tính có thể lớn hơn đáng kể so với lượng gas thực sự được sử dụng bởi giao dịch, vì nhiều lý do bao gồm cơ chế Máy ảo Ethereum và hiệu suất nút.
Thử điểm cuối trong sân chơiopens in a new tabTham số
Xem tham số eth_call, ngoại trừ tất cả các thuộc tính đều là tùy chọn. Nếu không có giới hạn gas nào được chỉ định, geth sử dụng giới hạn gas khối từ khối đang chờ xử lý làm giới hạn trên. Do đó, ước tính được trả về có thể không đủ để thực hiện lệnh gọi/giao dịch khi lượng gas cao hơn giới hạn gas của khối đang chờ xử lý.
Trả về
QUANTITY - lượng gas đã sử dụng.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x5208" // 210008}eth_getBlockByHash
Trả về thông tin về một khối bằng hàm băm.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - Hàm băm của một khối.Boolean- Nếutrue, nó sẽ trả về các đối tượng giao dịch đầy đủ, nếufalsechỉ trả về hàm băm của các giao dịch.
1params: [2 "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",3 false,4]Trả về
Object - Một đối tượng khối, hoặc null khi không tìm thấy khối nào:
number:QUANTITY- số khối.nullkhi đó là khối đang chờ xử lý.hash:DATA, 32 Byte - hàm băm của khối.nullkhi đó là khối đang chờ xử lý.parentHash:DATA, 32 Byte - hàm băm của khối cha.nonce:DATA, 8 Byte - hàm băm của bằng chứng công việc được tạo ra.nullkhi đó là khối đang chờ xử lý,0x0cho các khối bằng chứng cổ phần (kể từ The Merge)sha3Uncles:DATA, 32 Byte - SHA3 của dữ liệu khối chú trong khối.logsBloom:DATA, 256 Byte - bộ lọc bloom cho nhật ký của khối.nullkhi đó là khối đang chờ xử lý.transactionsRoot:DATA, 32 Byte - gốc của cây trie giao dịch của khối.stateRoot:DATA, 32 Byte - gốc của cây trie trạng thái cuối cùng của khối.receiptsRoot:DATA, 32 Byte - gốc của cây trie biên lai của khối.miner:DATA, 20 Byte - địa chỉ của người hưởng lợi mà phần thưởng khối được trao.difficulty:QUANTITY- số nguyên của độ khó cho khối này.totalDifficulty:QUANTITY- số nguyên của tổng độ khó của chuỗi cho đến khối này.extraData:DATA- trường "dữ liệu bổ sung" của khối này.size:QUANTITY- số nguyên kích thước của khối này tính bằng byte.gasLimit:QUANTITY- lượng gas tối đa được phép trong khối này.gasUsed:QUANTITY- tổng lượng gas được sử dụng bởi tất cả các giao dịch trong khối này.timestamp:QUANTITY- dấu thời gian unix khi khối được đối chiếu.transactions:Array- Mảng các đối tượng giao dịch, hoặc hàm băm giao dịch 32 Byte tùy thuộc vào tham số cuối cùng được đưa ra.uncles:Array- Mảng các hàm băm của khối chú.
Ví dụ
1// Request2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByHash","params":["0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae", false],"id":1}'3// Result4{5 "jsonrpc": "2.0",6 "id": 1,7 "result": {8 "difficulty": "0x4ea3f27bc",9 "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",10 "gasLimit": "0x1388",11 "gasUsed": "0x0",12 "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",13 "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",14 "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",15 "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",16 "nonce": "0x689056015818adbe",17 "number": "0x1b4",18 "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",19 "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",20 "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",21 "size": "0x220",22 "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",23 "timestamp": "0x55ba467c",24 "totalDifficulty": "0x78ed983323d",25 "transactions": [26 ],27 "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",28 "uncles": [29 ]30 }31}Hiện tất cảeth_getBlockByNumber
Trả về thông tin về một khối theo số khối.
Thử điểm cuối trong sân chơiopens in a new tabTham số
QUANTITY|TAG- số nguyên của một số khối, hoặc chuỗi"earliest","latest","pending","safe"hoặc"finalized", như trong thông số khối.Boolean- Nếutrue, nó sẽ trả về các đối tượng giao dịch đầy đủ, nếufalsechỉ trả về hàm băm của các giao dịch.
1params: [2 "0x1b4", // 4363 true,4]Trả về Xem eth_getBlockByHash
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockByNumber","params":["0x1b4", true],"id":1}'Kết quả xem eth_getBlockByHash
eth_getTransactionByHash
Trả về thông tin về một giao dịch được yêu cầu bằng hàm băm giao dịch.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - hàm băm của một giao dịch
1params: ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"]Trả về
Object - Một đối tượng giao dịch, hoặc null khi không tìm thấy giao dịch nào:
blockHash:DATA, 32 Byte - hàm băm của khối nơi giao dịch này diễn ra.nullkhi đang chờ xử lý.blockNumber:QUANTITY- số khối nơi giao dịch này diễn ra.nullkhi đang chờ xử lý.from:DATA, 20 Byte - địa chỉ của người gửi.gas:QUANTITY- gas do người gửi cung cấp.gasPrice:QUANTITY- giá gas do người gửi cung cấp tính bằng Wei.hash:DATA, 32 Byte - hàm băm của giao dịch.input:DATA- dữ liệu được gửi cùng với giao dịch.nonce:QUANTITY- số lượng giao dịch được thực hiện bởi người gửi trước giao dịch này.to:DATA, 20 Byte - địa chỉ của người nhận.nullkhi đó là một giao dịch tạo hợp đồng.transactionIndex:QUANTITY- số nguyên của vị trí chỉ mục giao dịch trong khối.nullkhi đang chờ xử lý.value:QUANTITY- giá trị được chuyển bằng Wei.v:QUANTITY- id phục hồi ECDSAr:QUANTITY- chữ ký ECDSA rs:QUANTITY- chữ ký ECDSA s
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByHash","params":["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],"id":1}'3// Kết quả4{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}Hiện tất cảeth_getTransactionByBlockHashAndIndex
Trả về thông tin về một giao dịch theo hàm băm khối và vị trí chỉ mục giao dịch.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - hàm băm của một khối.QUANTITY- số nguyên của vị trí chỉ mục giao dịch.
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]Trả về Xem eth_getTransactionByHash
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'Kết quả xem eth_getTransactionByHash
eth_getTransactionByBlockNumberAndIndex
Trả về thông tin về một giao dịch theo số khối và vị trí chỉ mục giao dịch.
Thử điểm cuối trong sân chơiopens in a new tabTham số
QUANTITY|TAG- một số khối, hoặc chuỗi"earliest","latest","pending","safe"hoặc"finalized", như trong thông số khối.QUANTITY- vị trí chỉ mục giao dịch.
1params: [2 "0x9c47cf", // 102419993 "0x24", // 364]Trả về Xem eth_getTransactionByHash
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionByBlockNumberAndIndex","params":["0x9c47cf", "0x24"],"id":1}'Kết quả xem eth_getTransactionByHash
eth_getTransactionReceipt
Trả về biên lai của một giao dịch bằng hàm băm giao dịch.
Lưu ý Rằng biên lai không có sẵn cho các giao dịch đang chờ xử lý.
Tham số
DATA, 32 Byte - hàm băm của một giao dịch
1params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]Trả về
Object - Một đối tượng biên lai giao dịch, hoặc null khi không tìm thấy biên lai nào:
transactionHash:DATA, 32 Byte - hàm băm của giao dịch.transactionIndex:QUANTITY- số nguyên của vị trí chỉ mục giao dịch trong khối.blockHash:DATA, 32 Byte - hàm băm của khối nơi giao dịch này diễn ra.blockNumber:QUANTITY- số khối nơi giao dịch này diễn ra.from:DATA, 20 Byte - địa chỉ của người gửi.to:DATA, 20 Byte - địa chỉ của người nhận. null khi đó là một giao dịch tạo hợp đồng.cumulativeGasUsed:QUANTITY- Tổng lượng gas được sử dụng khi giao dịch này được thực hiện trong khối.effectiveGasPrice:QUANTITY- Tổng của phí cơ bản và tiền boa được trả cho mỗi đơn vị gas.gasUsed:QUANTITY- Lượng gas chỉ được sử dụng bởi giao dịch cụ thể này.contractAddress:DATA, 20 Byte - Địa chỉ hợp đồng được tạo, nếu giao dịch là tạo hợp đồng, ngược lại lànull.logs:Array- Mảng các đối tượng nhật ký mà giao dịch này đã tạo.logsBloom:DATA, 256 Byte - Bộ lọc Bloom cho các máy khách chế độ sáng để truy xuất nhanh các nhật ký liên quan.type:QUANTITY- số nguyên của loại giao dịch,0x0cho các giao dịch cũ,0x1cho các loại danh sách truy cập,0x2cho phí động.
Nó cũng trả về một trong hai :
root:DATA32 byte của gốc trạng thái sau giao dịch (trước Byzantium)status:QUANTITYlà1(thành công) hoặc0(thất bại)
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionReceipt","params":["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"],"id":1}'3// Kết quả4{5 "jsonrpc": "2.0",6 "id": 1,7 "result": {8 "blockHash":9 "0xa957d47df264a31badc3ae823e10ac1d444b098d9b73d204c40426e57f47e8c3",10 "blockNumber": "0xeff35f",11 "contractAddress": null, // chuỗi địa chỉ nếu nó được tạo12 "cumulativeGasUsed": "0xa12515",13 "effectiveGasPrice": "0x5a9c688d4",14 "from": "0x6221a9c005f6e47eb398fd867784cacfdcfff4e7",15 "gasUsed": "0xb4c8",16 "logs": [{17 // nhật ký được trả về bởi getFilterLogs, v.v.18 }],19 "logsBloom": "0x00...0", // bộ lọc bloom 256 byte20 "status": "0x1",21 "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",22 "transactionHash":23 "0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5",24 "transactionIndex": "0x66",25 "type": "0x2"26 }27}Hiện tất cảeth_getUncleByBlockHashAndIndex
Trả về thông tin về một khối uncle của một khối theo hàm băm và vị trí chỉ mục uncle.
Thử điểm cuối trong sân chơiopens in a new tabTham số
DATA, 32 Byte - Hàm băm của một khối.QUANTITY- Vị trí chỉ mục của khối chú.
1params: [2 "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",3 "0x0", // 04]Trả về Xem eth_getBlockByHash
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'Kết quả xem eth_getBlockByHash
Lưu ý: Một khối chú không chứa các giao dịch riêng lẻ.
eth_getUncleByBlockNumberAndIndex
Trả về thông tin về một khối uncle của một khối theo số và vị trí chỉ mục uncle.
Thử điểm cuối trong sân chơiopens in a new tabTham số
QUANTITY|TAG- một số khối, hoặc chuỗi"earliest","latest","pending","safe","finalized", như trong thông số khối.QUANTITY- vị trí chỉ mục của khối chú.
1params: [2 "0x29c", // 6683 "0x0", // 04]Trả về Xem eth_getBlockByHash
Lưu ý: Một khối chú không chứa các giao dịch riêng lẻ.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockNumberAndIndex","params":["0x29c", "0x0"],"id":1}'Kết quả xem eth_getBlockByHash
eth_newFilter
Tạo một đối tượng bộ lọc, dựa trên các tùy chọn bộ lọc, để thông báo khi trạng thái thay đổi (nhật ký). Để kiểm tra xem trạng thái đã thay đổi chưa, hãy gọi eth_getFilterChanges.
Lưu ý về việc chỉ định các bộ lọc chủ đề: Các chủ đề phụ thuộc vào thứ tự. Một giao dịch với một nhật ký có các chủ đề [A, B] sẽ được khớp bởi các bộ lọc chủ đề sau:
[]"bất cứ điều gì"[A]"A ở vị trí đầu tiên (và bất cứ điều gì sau đó)"[null, B]"bất cứ điều gì ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và bất cứ điều gì sau đó)"[A, B]"A ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và bất cứ điều gì sau đó)"[[A, B], [A, B]]"(A HOẶC B) ở vị trí đầu tiên VÀ (A HOẶC B) ở vị trí thứ hai (và bất cứ điều gì sau đó)"- Tham số
Object- Các tùy chọn bộ lọc:
fromBlock:QUANTITY|TAG- (tùy chọn, mặc định:"latest") Số khối nguyên, hoặc"latest"cho khối được đề xuất cuối cùng,"safe"cho khối an toàn cuối cùng,"finalized"cho khối đã hoàn tất cuối cùng, hoặc"pending","earliest"cho các giao dịch chưa có trong khối.toBlock:QUANTITY|TAG- (tùy chọn, mặc định:"latest") Số khối nguyên, hoặc"latest"cho khối được đề xuất cuối cùng,"safe"cho khối an toàn cuối cùng,"finalized"cho khối đã hoàn tất cuối cùng, hoặc"pending","earliest"cho các giao dịch chưa có trong khối.address:DATA|Array, 20 Byte - (tùy chọn) Địa chỉ hợp đồng hoặc danh sách các địa chỉ mà từ đó các nhật ký sẽ bắt nguồn.topics:Array of DATA, - (tùy chọn) Mảng 32 ByteDATAchủ đề. Các chủ đề phụ thuộc vào thứ tự. Mỗi chủ đề cũng có thể là một mảng DATA với các tùy chọn "hoặc".
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]Hiện tất cảTrả về
QUANTITY - Một id bộ lọc.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}eth_newBlockFilter
Tạo một bộ lọc trong nút, để thông báo khi có một khối mới đến. Để kiểm tra xem trạng thái đã thay đổi chưa, hãy gọi eth_getFilterChanges.
Tham số Không có
Trả về
QUANTITY - Một id bộ lọc.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}eth_newPendingTransactionFilter
Tạo một bộ lọc trong nút, để thông báo khi có các giao dịch đang chờ xử lý mới. Để kiểm tra xem trạng thái đã thay đổi chưa, hãy gọi eth_getFilterChanges.
Tham số Không có
Trả về
QUANTITY - Một id bộ lọc.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": "0x1" // 18}eth_uninstallFilter
Gỡ cài đặt một bộ lọc với id đã cho. Luôn luôn nên được gọi khi không còn cần theo dõi. Ngoài ra, Bộ lọc sẽ hết thời gian chờ khi chúng không được yêu cầu với eth_getFilterChanges trong một khoảng thời gian.
Tham số
QUANTITY- Id bộ lọc.
1params: [2 "0xb", // 113]Trả về
Boolean - true nếu bộ lọc được gỡ cài đặt thành công, ngược lại là false.
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'3// Kết quả4{5 "id":1,6 "jsonrpc": "2.0",7 "result": true8}eth_getFilterChanges
Phương pháp bỏ phiếu cho một bộ lọc, trả về một mảng các nhật ký đã xảy ra kể từ lần bỏ phiếu cuối cùng.
Tham số
QUANTITY- id bộ lọc.
1params: [2 "0x16", // 223]Trả về
Array - Mảng các đối tượng nhật ký, hoặc một mảng trống nếu không có gì thay đổi kể từ lần bỏ phiếu cuối cùng.
-
Đối với các bộ lọc được tạo bằng
eth_newBlockFilter, giá trị trả về là các hàm băm khối (DATA, 32 Byte), ví dụ:["0x3454645634534..."]. -
Đối với các bộ lọc được tạo bằng
eth_newPendingTransactionFilter, giá trị trả về là các hàm băm giao dịch (DATA, 32 Byte), ví dụ:["0x6345343454645..."]. -
Đối với các bộ lọc được tạo bằng
eth_newFilter, nhật ký là các đối tượng có các tham số sau:removed:TAG-truekhi nhật ký bị xóa, do tổ chức lại chuỗi.falsenếu đó là một nhật ký hợp lệ.logIndex:QUANTITY- số nguyên của vị trí chỉ mục nhật ký trong khối.nullkhi đó là nhật ký đang chờ xử lý.transactionIndex:QUANTITY- số nguyên của vị trí chỉ mục giao dịch mà nhật ký được tạo từ đó.nullkhi đó là nhật ký đang chờ xử lý.transactionHash:DATA, 32 Byte - hàm băm của các giao dịch mà nhật ký này được tạo từ đó.nullkhi đó là nhật ký đang chờ xử lý.blockHash:DATA, 32 Byte - hàm băm của khối nơi nhật ký này diễn ra.nullkhi đang chờ xử lý.nullkhi đó là nhật ký đang chờ xử lý.blockNumber:QUANTITY- số khối nơi nhật ký này diễn ra.nullkhi đang chờ xử lý.nullkhi đó là nhật ký đang chờ xử lý.address:DATA, 20 Byte - địa chỉ mà nhật ký này bắt nguồn.data:DATA- dữ liệu nhật ký không được lập chỉ mục có độ dài thay đổi. (Trong solidity: không hoặc nhiều hơn 32 Byte đối số nhật ký không được lập chỉ mục.)topics:Array of DATA- Mảng từ 0 đến 4 32 ByteDATAcủa các đối số nhật ký được lập chỉ mục. (Trong solidity: Chủ đề đầu tiên là hàm băm của chữ ký của sự kiện (ví dụ:Deposit(address,bytes32,uint256)), trừ khi bạn đã khai báo sự kiện với bộ chỉ địnhanonymous.)
-
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterChanges","params":["0x16"],"id":73}'3// Kết quả4{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}Hiện tất cảeth_getFilterLogs
Trả về một mảng gồm tất cả các nhật ký khớp với bộ lọc có id đã cho.
Tham số
QUANTITY- Id bộ lọc.
1params: [2 "0x16", // 223]Trả về Xem eth_getFilterChanges
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getFilterLogs","params":["0x16"],"id":74}'Kết quả xem eth_getFilterChanges
eth_getLogs
Trả về một mảng gồm tất cả các nhật ký khớp với một đối tượng bộ lọc đã cho.
Tham số
Object- Các tùy chọn bộ lọc:
fromBlock:QUANTITY|TAG- (tùy chọn, mặc định:"latest") Số khối nguyên, hoặc"latest"cho khối được đề xuất cuối cùng,"safe"cho khối an toàn cuối cùng,"finalized"cho khối đã hoàn tất cuối cùng, hoặc"pending","earliest"cho các giao dịch chưa có trong khối.toBlock:QUANTITY|TAG- (tùy chọn, mặc định:"latest") Số khối nguyên, hoặc"latest"cho khối được đề xuất cuối cùng,"safe"cho khối an toàn cuối cùng,"finalized"cho khối đã hoàn tất cuối cùng, hoặc"pending","earliest"cho các giao dịch chưa có trong khối.address:DATA|Array, 20 Byte - (tùy chọn) Địa chỉ hợp đồng hoặc danh sách các địa chỉ mà từ đó các nhật ký sẽ bắt nguồn.topics:Array of DATA, - (tùy chọn) Mảng 32 ByteDATAchủ đề. Các chủ đề phụ thuộc vào thứ tự. Mỗi chủ đề cũng có thể là một mảng DATA với các tùy chọn "hoặc".blockHash:DATA, 32 Byte - (tùy chọn, tương lai) Với việc bổ sung EIP-234,blockHashsẽ là một tùy chọn bộ lọc mới giới hạn các nhật ký trả về cho một khối duy nhất có hàm băm 32 byteblockHash. Việc sử dụngblockHashtương đương vớifromBlock=toBlock= số khối có hàm bămblockHash. NếublockHashcó trong tiêu chí bộ lọc, thì cảfromBlockvàtoBlockđều không được phép.
1params: [2 {3 topics: [4 "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",5 ],6 },7]Trả về Xem eth_getFilterChanges
Ví dụ
1// Yêu cầu2curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'Kết quả xem eth_getFilterChanges
Ví dụ về cách sử dụng
Triển khai hợp đồng bằng JSON_RPC
Phần này bao gồm một minh họa về cách triển khai một hợp đồng chỉ bằng giao diện RPC. Có các tuyến thay thế để triển khai các hợp đồng trong đó sự phức tạp này được trừu tượng hóa — ví dụ, sử dụng các thư viện được xây dựng trên giao diện RPC như web3.jsopens in a new tab và web3.pyopens in a new tab. Các bản tóm tắt này thường dễ hiểu hơn và ít bị lỗi hơn, nhưng vẫn hữu ích khi hiểu những gì đang xảy ra bên dưới.
Sau đây là một hợp đồng thông minh đơn giản có tên là Multiply7 sẽ được triển khai bằng giao diện JSON-RPC cho một nút Ethereum. Hướng dẫn này giả định rằng người đọc đã chạy một nút Geth. Thông tin thêm về các nút và máy khách có tại đây. Vui lòng tham khảo tài liệu tham khảo của máy khách cá nhân để xem cách bắt đầu JSON-RPC HTTP cho các máy khách không phải Geth. Hầu hết các máy khách mặc định phục vụ trên 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}Điều đầu tiên cần làm là đảm bảo giao diện RPC HTTP được bật. Điều này có nghĩa là chúng tôi cung cấp cho Geth cờ --http khi khởi động. Trong ví dụ này, chúng tôi sử dụng nút Geth trên một chuỗi phát triển riêng. Sử dụng phương pháp này, chúng ta không cần ether trên mạng thực.
geth --http --dev console 2>>geth.logThao tác này sẽ khởi động giao diện HTTP RPC trên http://localhost:8545.
Chúng tôi có thể xác minh rằng giao diện đang chạy bằng cách truy xuất địa chỉ coinbase (bằng cách lấy địa chỉ đầu tiên từ mảng tài khoản) và số dư bằng curlopens in a new tab. Xin lưu ý rằng dữ liệu trong các ví dụ này sẽ khác trên nút cục bộ của bạn. Nếu bạn muốn thử các lệnh này, hãy thay thế các tham số yêu cầu trong yêu cầu curl thứ hai bằng kết quả trả về từ yêu cầu đầu tiên.
curl --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[], "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"}Vì các số được mã hóa bằng hex, số dư được trả về bằng wei dưới dạng một chuỗi hex. Nếu chúng ta muốn có số dư bằng ether dưới dạng một con số, chúng ta có thể sử dụng web3 từ bảng điều khiển Geth.
1web3.fromWei("0x1639e49bba16280000", "ether")2// "410"Bây giờ có một số ether trên chuỗi phát triển riêng của chúng tôi, chúng tôi có thể triển khai hợp đồng. Bước đầu tiên là biên dịch hợp đồng Multiply7 thành mã byte có thể được gửi đến EVM. Để cài đặt solc, trình biên dịch Solidity, hãy làm theo tài liệu tham khảo Solidityopens in a new tab. (Bạn có thể muốn sử dụng bản phát hành solc cũ hơn để khớp với phiên bản trình biên dịch được sử dụng cho ví dụ của chúng tôiopens in a new tab.)
Bước tiếp theo là biên dịch hợp đồng Multiply7 thành mã byte có thể được gửi đến Máy ảo Ethereum.
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:6060604052341561000f57600080fd5b60eb8061001d6000396000f300606060405260043610603f576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff168063c6888fa1146044575b600080fd5b3415604e57600080fd5b606260048080359060200190919050506078565b6040518082815260200191505060405180910390f35b60007f24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da600783026040518082815260200191505060405180910390a16007820290509190505600a165627a7a7230582040383f19d9f65246752244189b02f56e8d0980ed44e7a56c0b200458caad20bb0029Bây giờ chúng ta đã có mã đã biên dịch, chúng ta cần xác định chi phí gas để triển khai nó. Giao diện RPC có một phương thức eth_estimateGas sẽ cho chúng ta một ước tính.
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"}Và cuối cùng triển khai hợp đồng.
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"}Giao dịch được chấp nhận bởi nút và một hàm băm giao dịch được trả về. Hàm băm này có thể được sử dụng để theo dõi giao dịch. Bước tiếp theo là xác định địa chỉ nơi hợp đồng của chúng ta được triển khai. Mỗi giao dịch được thực thi sẽ tạo ra một biên nhận. Biên nhận này chứa nhiều thông tin khác nhau về giao dịch, chẳng hạn như giao dịch được bao gồm trong khối nào và Máy ảo Ethereum đã sử dụng bao nhiêu gas. Nếu một giao dịch
tạo ra một hợp đồng, nó cũng sẽ chứa địa chỉ hợp đồng. Chúng ta có thể truy xuất biên nhận bằng phương thức RPC 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"}}Hợp đồng của chúng ta được tạo trên 0x4d03d617d700cf81935d7f797f4e2ae719648262. Kết quả rỗng thay vì biên nhận có nghĩa là giao dịch chưa được đưa vào một khối. Hãy đợi một lát và kiểm tra xem máy khách đồng thuận của bạn có đang chạy không và thử lại.
Tương tác với các hợp đồng thông minh
Trong ví dụ này, chúng ta sẽ gửi một giao dịch bằng cách sử dụng eth_sendTransaction đến phương thức multiply của hợp đồng.
eth_sendTransaction yêu cầu một số đối số, cụ thể là from, to và data. From là địa chỉ công khai của tài khoản của chúng ta và to là địa chỉ hợp đồng. Đối số data chứa một tải trọng xác định phương thức nào phải được gọi và với đối số nào. Đây là lúc ABI (giao diện nhị phân ứng dụng)opens in a new tab phát huy tác dụng. ABI là một tệp JSON xác định cách định nghĩa và mã hóa dữ liệu cho Máy ảo Ethereum.
Các byte của tải trọng xác định phương thức nào trong hợp đồng được gọi. Đây là 4 byte đầu tiên từ hàm băm Keccak trên tên hàm và các loại đối số của nó, được mã hóa dưới dạng hex. Hàm nhân chấp nhận một uint là bí danh cho uint256. Điều này cho chúng ta:
1web3.sha3("multiply(uint256)").substring(0, 10)2// "0xc6888fa1"Bước tiếp theo là mã hóa các đối số. Chỉ có một uint256, ví dụ, giá trị 6. ABI có một phần chỉ định cách mã hóa các loại uint256.
int<M>: enc(X) là mã hóa bù hai của X theo kiểu big-endian, được đệm ở phía bậc cao (bên trái) bằng 0xff cho X âm và bằng các byte không cho X dương sao cho độ dài là bội số của 32 byte.
Giá trị này mã hóa thành 0000000000000000000000000000000000000000000000000000000000000006.
Kết hợp bộ chọn hàm và đối số đã mã hóa, dữ liệu của chúng ta sẽ là 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006.
Bây giờ có thể gửi giá trị này đến nút:
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"}Vì một giao dịch đã được gửi, một hàm băm giao dịch đã được trả về. Truy xuất biên nhận cho ra kết quả:
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}Hiện tất cảBiên nhận có chứa một nhật ký. Nhật ký này được tạo bởi Máy ảo Ethereum khi thực thi giao dịch và được bao gồm trong biên nhận. Hàm multiply cho thấy sự kiện Print đã được đưa ra với đầu vào nhân với 7. Vì đối số cho sự kiện Print là một uint256, chúng ta có thể giải mã nó theo các quy tắc ABI, điều này sẽ cho chúng ta kết quả thập phân 42 như mong đợi. Ngoài dữ liệu, cần lưu ý rằng các chủ đề có thể được sử dụng để xác định sự kiện nào đã tạo ra nhật ký:
1web3.sha3("Print(uint256)")2// "24abdb5865df5079dcc5ac590ff6f01d5c16edbc5fab4e195d9febd1114503da"Đây chỉ là một giới thiệu ngắn gọn về một số tác vụ phổ biến nhất, minh họa việc sử dụng trực tiếp JSON-RPC.