Chuyển đến nội dung chính
Change page

JSON-RPC API

Để một ứng dụng phần mềm 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 đến mạng lưới - nó phải kết nối với một nút Ethereum.

Vì mục đích này, mọi ứng dụng khách Ethereum đều triển khai một đặc tả JSON-RPC (opens in a new tab), do đó có một tập hợp các 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 ứng dụng khách cụ thể nào.

JSON-RPC (opens in a new tab) là một giao thức gọi thủ tục từ xa (RPC) không trạng thái, gọn nhẹ. Nó định nghĩa 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 thức truyền tải ở chỗ các khái niệm có thể được sử dụng trong cùng một tiến trình, qua socket, 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.

Các bản triển khai ứng dụng khách

Các ứng dụng 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 của từng ứng dụng 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 của từng ứng dụng khách để có thông tin hỗ trợ API mới nhất.

Các thư viện tiện ích

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 API JSON-RPC, thường có những lựa chọn dễ dàng hơn cho các nhà phát triển ứng dụng phi tập trung (dapp). Có nhiều thư viện JavaScript và API backend cung cấp các trình bao bọc (wrapper) trên API 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 một dòng, trực quan 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 (ẩn bên dưới) nhằm tương tác với Ethereum.

Các API của ứng dụng khách đồng thuận

Trang này chủ yếu đề cập đến API JSON-RPC được sử dụng bởi các máy khách thực thi Ethereum. Tuy nhiên, các ứng dụng khách đồng thuận cũng có một API 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 liên quan đến đồng thuận khác trực tiếp từ một nút. API này được ghi chép trên trang web API Beacon (opens in a new tab).

Một API nội bộ cũng được sử dụng cho giao tiếp giữa các máy khách trong một nút - nghĩa là, nó cho phép ứng dụng 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 GitHub (opens in a new tab).

Đặc tả máy khách thực thi

Đọc toàn bộ đặc tả API JSON-RPC trên GitHub (opens in a new tab). API này được ghi chép trên trang web API Thực thi (opens in a new tab) và bao gồm một công cụ Inspector để dùng thử tất cả các phương thức có sẵn.

Các quy ước

Mã hóa giá trị hex

Hai loại dữ liệu chính được truyền qua JSON: mảng byte không định dạng và số lượng. Cả hai đều được truyền bằng mã hóa hex nhưng có 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, thêm tiền tố "0x", biểu diễn nhỏ gọn nhất (ngoại lệ nhỏ: số không nên được biểu diễn là "0x0").

Dưới đây là một số ví dụ:

  • 0x41 (65 trong hệ thập phân)
  • 0x400 (1024 trong hệ thập phân)
  • SAI: 0x (luôn phải có ít nhất một chữ số - số không là "0x0")
  • SAI: 0x0400 (không được phép có các số không ở đầu)
  • SAI: ff (phải có tiền tố 0x)

Dữ liệu không định dạng

Khi mã hóa dữ liệu không định dạng (mảng byte, địa chỉ tài khoản, mã băm, mảng mã byte): mã hóa dưới dạng hex, thêm tiền tố "0x", hai chữ số hex cho mỗi byte.

Dưới đây là một số 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ố lượng chữ số chẵn)
  • SAI: 004200 (phải có tiền tố 0x)

Tham số khối

Các phương thức sau có một tham số khối:

Khi thực hiện các yêu cầu truy vấn trạng thái của Ethereum, tham 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 có thể sử dụng cho tham số khối:

  • HEX String - một số khối nguyên
  • String "earliest" cho khối sớm nhất/khối nguyên thủy
  • String "latest" - cho khối được đề xuất mới nhất
  • String "safe" - cho khối an toàn mới nhất ở đầu chuỗi
  • String "finalized" - cho khối đã chung cuộc mới nhất
  • String "pending" - cho trạng thái/giao dịch đang chờ xử lý

Các ví dụ

Trên trang này, chúng tôi cung cấp các ví dụ về cách sử dụng từng điểm cuối API JSON_RPC bằng công cụ dòng lệnh, curl (opens in a new tab). Các ví dụ về từng điểm cuối này được tìm thấy bên dưới trong phần Ví dụ về Curl. Ở phần tiếp theo của trang, chúng tôi cũng cung cấp một ví dụ từ đầu đến cuối về việc biên dịch và triển khai một hợp đồng thông minh sử dụng một nút Geth, API JSON_RPC và curl.

Các ví dụ về Curl

Dưới đây là các ví dụ về việc sử dụng API JSON_RPC bằng cách thực hiện các yêu cầu curl (opens in a new tab) tới một nút Ethereum. Mỗi ví dụ bao gồm mô tả về điểm cuối cụ thể, các tham số, kiểu trả về và một ví dụ minh họa về cách sử dụng nó.

Các yêu cầu curl có thể trả về thông báo 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 báo lỗi về điều này, hãy thiết lập tiêu đề theo cách thủ công bằng cách đặt -H "Content-Type: application/json" ở đầu lời gọi. Các ví dụ cũng không bao gồm sự kết hợp URL/IP & cổng, vốn 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 như sau:

curl -H "Content-Type: application/json" -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}' 127.0.0.1:8545

Gossip, Trạng thái, Lịch sử

Một số phương thức JSON-RPC cốt lõi yêu cầu dữ liệu từ mạng lưới Ethereum và được chia gọn gàng thành ba danh mục 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 mục lục để khám phá toàn bộ danh sách các phương thức.

Các phương thức Gossip

Các phương thức này theo dõi phần đầu của chuỗi. Đây là cách các giao dịch di chuyển xung quanh mạng lưới, tìm đường vào các khối và cách các ứng dụng khách tìm hiểu về các khối mới.

Các phương thức Trạng thái

Các phương thức 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 dùng chung lớn và bao gồm số dư tài khoản, dữ liệu hợp đồng và các ước tính gas.

Các phương thức Lịch sử

Truy xuất các bản ghi lịch sử của mọi khối trở về khối nguyên thủy. Điều này giống như một tệp lớn chỉ cho phép nối thêm (append-only) và bao gồm tất cả các tiêu đề khối, phần thân khối, các khối uncle và biên lai giao dịch.

Sân chơi JSON-RPC API

Bạn có thể sử dụng công cụ sân chơi (opens in a new tab) để khám phá và dùng thử các phương thức API. Công cụ này cũng cho bạn biết các phương thức và mạng lưới nào được hỗ trợ bởi các nhà cung cấp nút khác nhau.

Các phương thức API JSON-RPC

web3_clientVersion

Trả về phiên bản ứng dụng khách hiện tại.

Tham số

Không có

Trả về

String - Phiên bản ứng dụng khách hiện tại

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_clientVersion","params":[],"id":67}'
// Kết quả
{
  "id":67,
  "jsonrpc":"2.0",
  "result": "Geth/v1.12.1-stable/linux-amd64/go1.19.1"
}

web3_sha3

Trả về Keccak-256 (không phải SHA3-256 tiêu chuẩn) của dữ liệu đã cho.

Các tham số

  1. DATA - Dữ liệu để chuyển đổi thành mã băm SHA3
params: ["0x68656c6c6f20776f726c64"]

Trả về

DATA - Kết quả SHA3 của chuỗi đã cho.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"web3_sha3","params":["0x68656c6c6f20776f726c64"],"id":64}'
// Kết quả
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x47173285a8d7341e5e972fc677286384f802f8ef42a5ec5f03bbfa254cb01fad"
}

net_version

Trả về id mạng lưới hiện tại.

Các tham số

Không có

Kết quả trả về

String - Id mạng lưới hiện tại.

Danh sách đầy đủ các ID mạng lưới hiện tại có sẵn tại chainlist.org (opens in a new tab). Một số ID phổ biến là:

  • 1: Mạng chính Ethereum
  • 11155111: mạng thử nghiệm Sepolia
  • 560048 : mạng thử nghiệm Hoodi

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"net_version","params":[],"id":67}'
// Kết quả
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "3"
}

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 lưới.

Tham số

Không có

Trả về

Boolean - true khi đang lắng nghe, ngược lại là false.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"net_listening","params":[],"id":67}'
// Kết quả
{
  "id":67,
  "jsonrpc":"2.0",
  "result":true
}

net_peerCount

Trả về số lượng các nút ngang hàng hiện đang kết nối với ứng dụng khách.

Tham số

Không có

Trả về

QUANTITY - số nguyên chỉ số lượng các nút ngang hàng đã kết nối.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"net_peerCount","params":[],"id":74}'
// Kết quả
{
  "id":74,
  "jsonrpc": "2.0",
  "result": "0x2" // 2
}

eth_protocolVersion

Trả về phiên bản giao thức Ethereum hiện tại. Lưu ý rằng phương thức này không khả dụng trong Geth (opens in a new tab).

Tham số

Không có

Trả về

String - Phiên bản giao thức Ethereum hiện tại

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_protocolVersion","params":[],"id":67}'
// Kết quả
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "54"
}

eth_syncing

Trả về một đối tượng chứa dữ liệu về trạng thái đồng bộ hóa hoặc false.

Thử điểm cuối trong playground (opens in a new tab)

Tham số

Không có

Trả về

Dữ liệu trả về chính xác thay đổi tùy theo các bản triển khai ứng dụng khách. Tất cả các ứng dụng khách đều trả về False khi nút không đồng bộ hóa, và tất cả các ứng dụng khách đều trả về các trường sau.

Object|Boolean, Một đối tượng chứa 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à 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 khối đầu chuỗi)
  • currentBlock: QUANTITY - Khối hiện tại, giống như eth_blockNumber
  • highestBlock: QUANTITY - Khối cao nhất ước tính

Tuy nhiên, từng ứng dụng khách riêng lẻ cũng có thể cung cấp dữ liệu bổ sung. Ví dụ: Geth trả về như sau:

Trong khi đó Besu trả về:

Tham khảo tài liệu cho ứng dụng khách cụ thể của bạn để biết thêm chi tiết.

Ví dụ

eth_coinbase

Trả về địa chỉ coinbase của ứng dụng khách.

Thử nghiệm endpoint trong playground (opens in a new tab)

Lưu ý: Phương thức này đã không còn được dùng kể từ v1.14.0 và không còn được hỗ trợ. Việc cố gắng sử dụng phương thức này sẽ dẫn đến lỗi "Method not supported".

Các tham số

Không có

Kết quả trả về

DATA, 20 byte - địa chỉ coinbase hiện tại.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_coinbase","params":[],"id":64}'
// Kết quả
{
  "id":64,
  "jsonrpc": "2.0",
  "result": "0x407d73d8a49eeb85d32cf465507dd71d507100c1"
}

eth_chainId

Trả về ID chuỗi được sử dụng cho việc ký các giao dịch được bảo vệ chống phát lại.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

Không có

Kết quả trả về

chainId, giá trị thập lục phân dưới dạng chuỗi đại diện cho số nguyên của ID chuỗi hiện tại.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_chainId","params":[],"id":67}'
// Kết quả
{
  "id":67,
  "jsonrpc": "2.0",
  "result": "0x1"
}

eth_mining

Trả về true nếu ứng dụng 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 đối với các mạng lưới Bằng chứng công việc và có thể không khả dụng trong một số ứng dụng khách kể từ The Merge.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Tham số

Không có

Trả về

Boolean - trả về true nếu ứng dụng khách đang khai thác, nếu không thì trả về false.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_mining","params":[],"id":71}'
//
{
  "id":71,
  "jsonrpc": "2.0",
  "result": true
}

eth_hashrate

Trả về số lượng mã băm mỗi giây mà nút đang sử dụng để khai thác. Phương thức này chỉ có thể trả về true đối với các mạng lưới Bằng chứng công việc và có thể không khả dụng trong một số ứng dụng khách kể từ The Merge.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Tham số

Không có

Kết quả trả về

QUANTITY - số lượng mã băm mỗi giây.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_hashrate","params":[],"id":71}'
// Kết quả
{
  "id":71,
  "jsonrpc": "2.0",
  "result": "0x38a"
}

eth_gasPrice

Trả về ước tính giá hiện tại cho mỗi Gas tính bằng Wei. Ví dụ: theo mặc định, máy khách Besu kiểm tra 100 khối gần nhất và trả về giá trị trung vị của giá đơn vị Gas.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

Không có

Kết quả trả về

QUANTITY - số nguyên của giá gas hiện tại tính bằng Wei.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_gasPrice","params":[],"id":73}'
// Kết quả
{
  "id":73,
  "jsonrpc": "2.0",
  "result": "0x1dfd14000" // 8049999872 Wei
}

eth_accounts

Trả về một danh sách các địa chỉ do ứng dụng khách sở hữu.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Tham số

Không có

Trả về

Array of DATA, 20 Byte - các địa chỉ do ứng dụng khách sở hữu.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_accounts","params":[],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]
}

eth_blockNumber

Trả về số của khối gần đây nhất.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

Không có

Kết quả trả về

QUANTITY - số nguyên của số khối hiện tại mà ứng dụng khách đang ở.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":83}'
// Kết quả
{
  "id":83,
  "jsonrpc": "2.0",
  "result": "0x4b7" // 1207
}

eth_getBalance

Trả về số dư của tài khoản tại một địa chỉ nhất định.

Thử endpoint trong playground (opens in a new tab)

Các tham số

  1. DATA, 20 Byte - địa chỉ để kiểm tra số dư.
  2. QUANTITY|TAG - số nguyên đại diện cho số khối, hoặc chuỗi "latest", "earliest", "pending", "safe", hoặc "finalized", xem tham số khối
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"]

Trả về

QUANTITY - số nguyên của số dư hiện tại tính bằng Wei.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBalance","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1", "latest"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0234c8a3397aab58" // 158972490234375000
}

eth_getStorageAt

Trả về giá trị từ một vị trí lưu trữ tại một địa chỉ nhất định.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

  1. DATA, 20 Byte - địa chỉ của bộ lưu trữ.
  2. QUANTITY - số nguyên chỉ vị trí trong bộ lưu trữ.
  3. QUANTITY|TAG - số khối dưới dạng số nguyên, hoặc chuỗi "latest", "earliest", "pending", "safe", "finalized", xem tham 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 bộ lưu trữ cần truy xuất. Hãy xem xét hợp đồng sau được triển khai tại 0x295a70b2de5e3953354a6a8344e616ed314d7251 bởi địa chỉ 0x391694e7e0b0cce554cb130d723a9d27458f9298.

contract Storage {
    uint pos0;
    mapping(address => uint) pos1;
    constructor() {
        pos0 = 1234;
        pos1[msg.sender] = 5678;
    }
}

Việc truy xuất giá trị của pos0 rất đơn giản:

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x0", "latest"], "id": 1}' localhost:8545
{"jsonrpc":"2.0","id":1,"result":"0x00000000000000000000000000000000000000000000000000000000000004d2"}

Việc truy xuất một phần tử của map khó hơn. Vị trí của một phần tử trong map được tính bằng:

keccak(LeftPad32(key, 0), LeftPad32(map position, 0))

Điều này có nghĩa là để truy xuất bộ lưu trữ trên pos1["0x391694e7e0b0cce554cb130d723a9d27458f9298"], chúng ta cần tính toán vị trí bằng:

keccak(
  decodeHex(
    "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" +
      "0000000000000000000000000000000000000000000000000000000000000001"
  )
)

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:

> var key = "000000000000000000000000391694e7e0b0cce554cb130d723a9d27458f9298" + "0000000000000000000000000000000000000000000000000000000000000001"
undefined
> web3.sha3(key, {"encoding": "hex"})
"0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9"

Bây giờ để lấy bộ lưu trữ:

curl -X POST --data '{"jsonrpc":"2.0", "method": "eth_getStorageAt", "params": ["0x295a70b2de5e3953354a6a8344e616ed314d7251", "0x6661e9d6d8b923d5bbaab1b96e1dd51ff6ea2a93520fdc9eb75d059238b8c5e9", "latest"], "id": 1}' localhost:8545
{"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 playground (opens in a new tab)

Tham số

  1. DATA, 20 Byte - địa chỉ.
  2. QUANTITY|TAG - số khối dưới dạng số nguyên, hoặc chuỗi "latest", "earliest", "pending", "safe" hoặc "finalized", xem tham số khối
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "latest", // trạng thái tại khối mới nhất
]

Kết quả trả về

QUANTITY - số nguyên thể hiện số lượng giao dịch đã gửi từ địa chỉ này.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getTransactionCount","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1","latest"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getBlockTransactionCountByHash

Trả về số lượng giao dịch trong một khối từ khối khớp với mã băm khối đã cho.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - mã băm của một khối
params: ["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"]

Kết quả trả về

QUANTITY - số nguyên thể hiện số lượng giao dịch trong khối này.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByHash","params":["0xd03ededb7415d22ae8bac30f96b2d1de83119632693b963642318d87d1bece5b"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getBlockTransactionCountByNumber

Trả về số lượng giao dịch trong một khối khớp với số khối đã cho.

Thử endpoint trong playground (opens in a new tab)

Các tham số

  1. 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 tham số khối.
params: [
  "0x13738ca", // 20396234
]

Kết quả trả về

QUANTITY - số nguyên thể hiện số lượng giao dịch trong khối này.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getBlockTransactionCountByNumber","params":["0x13738ca"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x8b" // 139
}

eth_getUncleCountByBlockHash

Trả về số lượng uncle trong một khối khớp với mã băm khối đã cho.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - mã băm của một khối
params: ["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"]

Kết quả trả về

QUANTITY - số nguyên thể hiện số lượng uncle trong khối này.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockHash","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

eth_getUncleCountByBlockNumber

Trả về số lượng uncle trong một khối từ một khối khớp với số khối được cung cấp.

Thử endpoint trong playground (opens in a new tab)

Tham số

  1. QUANTITY|TAG - số nguyên của một số khối, hoặc chuỗi "latest", "earliest", "pending", "safe" hoặc "finalized", xem tham số khối
params: [
  "0xe8", // 232
]

Kết quả trả về

QUANTITY - số nguyên thể hiện số lượng uncle trong khối này.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleCountByBlockNumber","params":["0xe8"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x0" // 0
}

eth_getCode

Trả về mã tại một địa chỉ đã cho.

Thử endpoint trong playground (opens in a new tab)

Tham số

  1. DATA, 20 Byte - địa chỉ
  2. QUANTITY|TAG - số khối dưới dạng số nguyên, hoặc chuỗi "latest", "earliest", "pending", "safe" hoặc "finalized", xem tham số khối
params: [
  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "0x5daf3b", // 6139707
]

Trả về

DATA - mã từ địa chỉ đã cho.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getCode","params":["0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2", "0x5daf3b"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x6060604052600436106100af576000357c0100000000000000000000000000000000000000000000000000000000900463ffffffff16806306fdde03146100b9578063095ea7b31461014757806318160ddd146101a157806323b872dd146101ca5780632e1a7d4d14610243578063313ce5671461026657806370a082311461029557806395d89b41146102e2578063a9059cbb14610370578063d0e30db0146103ca578063dd62ed3e146103d4575b6100b7610440565b005b34156100c457600080fd5b6100cc6104dd565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561010c5780820151818401526020810190506100f1565b50505050905090810190601f1680156101395780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561015257600080fd5b610187600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061057b565b604051808215151515815260200191505060405180910390f35b34156101ac57600080fd5b6101b461066d565b6040518082815260200191505060405180910390f35b34156101d557600080fd5b610229600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803590602001909190505061068c565b604051808215151515815260200191505060405180910390f35b341561024e57600080fd5b61026460048080359060200190919050506109d9565b005b341561027157600080fd5b610279610b05565b604051808260ff1660ff16815260200191505060405180910390f35b34156102a057600080fd5b6102cc600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610b18565b6040518082815260200191505060405180910390f35b34156102ed57600080fd5b6102f5610b30565b6040518080602001828103825283818151815260200191508051906020019080838360005b8381101561033557808201518184015260208101905061031a565b50505050905090810190601f1680156103625780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b341561037b57600080fd5b6103b0600480803573ffffffffffffffffffffffffffffffffffffffff16906020019091908035906020019091905050610bce565b604051808215151515815260200191505060405180910390f35b6103d2610440565b005b34156103df57600080fd5b61042a600480803573ffffffffffffffffffffffffffffffffffffffff1690602001909190803573ffffffffffffffffffffffffffffffffffffffff16906020019091905050610be3565b6040518082815260200191505060405180910390f35b34600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055503373ffffffffffffffffffffffffffffffffffffffff167fe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c346040518082815260200191505060405180910390a2565b60008054600181600116156101000203166002900480601f0160208091040260200160405190810160405280929190818152602001828054600181600116156101000203166002900480156105735780601f1061054857610100808354040283529160200191610573565b820191906000526020600020905b81548152906001019060200180831161055657829003601f168201915b505050505081565b600081600460003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020819055508273ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff167f8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925846040518082815260200191505060405180910390a36001905092915050565b60003073ffffffffffffffffffffffffffffffffffffffff1631905090565b600081600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002054101515156106dc57600080fd5b3373ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff16141580156107b457507fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205414155b156108cf5781600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020541015151561084457600080fd5b81600460008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff16815260200190815260200160002060003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055505b81600360008673ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000206000828254039250508190555081600360008573ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825401925050819055508273ffffffffffffffffffffffffffffffffffffffff168473ffffffffffffffffffffffffffffffffffffffff167fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef846040518082815260200191505060405180910390a3600190509392505050565b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff1681526020019081526020016000205410151515610a2757600080fd5b80600360003373ffffffffffffffffffffffffffffffffffffffff1673ffffffffffffffffffffffffffffffffffffffff168152602001908152602001600020600082825403925050819055503373ffffffffffffffffffffffffffffffffffffffff166108fc829081150290604051600060405180830381858888f193505050501515610ab457600080fd5b3373ffffffffffffffffffffffffffffffffffffffff167f7fcf532c15f0a6db0bd6d0e038bea71d30d808c7d98cb3bf7268a95bf5081b65826040518082815260200191505060405180910390a250565b600260009054906101000a900460ff1681565b60036020528060005260406000206000915090505481565b60018054600181600116156101000203166002900480601f016020809104026020016040519081016040528092919081815260200182805460018160011615610100020316600290048015610bc65780601f10610b9b57610100808354040283529160200191610bc6565b820191906000526020600020905b815481529060010190602001808311610ba957829003601f168201915b505050505081565b6000610bdb33848461068c565b905092915050565b60046020528160005260406000206020528060005260406000206000915091505054815600a165627a7a72305820deb4c2ccab3c2fdca32ab3f46728389c2fe2c165d5fafa07661e4e004f6c344a0029"
}

eth_sign

Phương thức sign tính toán một chữ ký dành riêng cho Ethereum bằng: sign(keccak256("\x19Ethereum Signed Message:\n" + len(message) + message))).

Việc thêm một tiền tố vào thông điệp giúp chữ ký được tính toán có thể nhận diện là một chữ ký dành riêng cho Ethereum. Điều này ngăn chặn việc lạm dụng nơi một ứng dụng phi tập trung (dapp) độ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ỉ dùng để ký phải được mở khóa.

Các tham số

  1. DATA, 20 Byte - địa chỉ
  2. DATA, N Byte - thông điệp cần ký

Kết quả trả về

DATA: Chữ ký

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sign","params":["0x9b2055d370f73ec7d8a03e965129118dc8f5bf83", "0xdeadbeaf"],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_signTransaction

Ký một giao dịch có thể được gửi đến mạng lưới vào một thời điểm sau đó bằng cách sử dụng eth_sendRawTransaction.

Các tham số

  1. Object - Đối tượng giao dịch
  • type:
  • from: DATA, 20 Byte - Địa chỉ mà giao dịch được gửi đi.
  • to: DATA, 20 Byte - (tùy chọn khi tạo hợp đồng mới) Địa chỉ mà giao dịch hướng tới.
  • gas: QUANTITY - (tùy chọn, mặc định: 90000) Số nguyên của lượng Gas được cung cấp cho việc thực thi giao dịch. Nó sẽ hoàn trả lại lượng Gas chưa sử dụng.
  • gasPrice: QUANTITY - (tùy chọn, mặc định: Chưa xác định) Số nguyên của gasPrice được sử dụng cho mỗi đơn vị Gas được trả, tính bằng Wei.
  • value: QUANTITY - (tùy chọn) Số nguyên của giá trị được gửi kèm theo giao dịch này, tính bằng Wei.
  • data: DATA - Mã đã biên dịch của một hợp đồng HOẶC mã băm của chữ ký phương thức được gọi và các tham số đã 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.

Kết quả trả về

DATA, Đối tượng giao dịch được mã hóa RLP đã được ký bởi tài khoản được chỉ định.

Ví dụ

// Yêu cầu
curl -X POST --data '{"id": 1,"jsonrpc": "2.0","method": "eth_signTransaction","params": [{"data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155","gas": "0x76c0","gasPrice": "0x9184e72a000","to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567","value": "0x9184e72a"}]}'
// Kết quả
{
    "id": 1,
    "jsonrpc": "2.0",
    "result": "0xa3f20717a250c2b0b729b7e5becbff67fdaef7e0699da4de7ca5895b02a170a12d887fd3b17bfdce3481f10bea41f45ba9f709d39ce8325427b57afcfc994cee1b"
}

eth_sendTransaction

Tạo giao dịch lời gọi thông điệp mới hoặc tạo hợp đồng, nếu trường dữ liệu chứa mã, và ký nó bằng tài khoản được chỉ định trong from.

Các tham số

  1. Object - Đối tượng giao dịch
  • from: DATA, 20 Byte - Địa chỉ mà giao dịch được gửi đi.
  • to: DATA, 20 Byte - (tùy chọn khi tạo hợp đồng mới) Địa chỉ mà giao dịch hướng tới.
  • gas: QUANTITY - (tùy chọn, mặc định: 90000) Số nguyên của lượng gas được cung cấp cho việc thực thi giao dịch. Nó sẽ hoàn trả lại lượng gas chưa sử dụng.
  • gasPrice: QUANTITY - (tùy chọn, mặc định: Chưa xác định) Số nguyên của giá gas (gasPrice) được sử dụng cho mỗi gas được trả.
  • value: QUANTITY - (tùy chọn) Số nguyên của giá trị được gửi kèm theo giao dịch này.
  • input: DATA - Mã đã biên dịch của một hợp đồng HOẶC mã băm của chữ ký phương thức được gọi và các tham số đã 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.

Kết quả trả về

DATA, 32 Byte - mã băm giao dịch, hoặc mã băm zero 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ụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendTransaction","params":[{see above}],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_sendRawTransaction

Tạo giao dịch lời gọi thông điệp mới hoặc tạo hợp đồng cho các giao dịch đã ký.

Các tham số

  1. DATA, Dữ liệu giao dịch đã ký.
params: [
  "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
]

Kết quả trả về

DATA, 32 Byte - mã băm giao dịch, hoặc mã băm 0 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ụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_sendRawTransaction","params":[{see above}],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0xe670ec64341771606e55d6b4ca35a1a6b75ee3d5145a99d05921026d1527331"
}

eth_call

Thực thi một lời gọi thông điệp mới ngay lập tức mà không tạo 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 một hợp đồng ERC-20.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

  1. Object - Đối tượng gọi giao dịch
  • from: DATA, 20 Byte - (tùy chọn) Địa chỉ gửi giao dịch.
  • to: DATA, 20 Byte - Địa chỉ nhận giao dịch.
  • gas: QUANTITY - (tùy chọn) Số nguyên của lượng Gas được cung cấp cho việc thực thi giao dịch. eth_call không tiêu thụ Gas, nhưng tham số này có thể cần thiết cho một số quá trình thực thi.
  • gasPrice: QUANTITY - (tùy chọn) Số nguyên của gasPrice được sử dụng cho mỗi Gas được trả
  • value: QUANTITY - (tùy chọn) Số nguyên của giá trị được gửi kèm theo giao dịch này
  • input: DATA - (tùy chọn) Mã băm của chữ ký phương thức và các tham số đã mã hóa. Để biết chi tiết, xem ABI Hợp đồng Ethereum trong tài liệu Solidity (opens in a new tab).
  1. QUANTITY|TAG - số khối dạng số nguyên, hoặc chuỗi "latest", "earliest", "pending", "safe" hoặc "finalized", xem tham số khối

Kết quả trả về

DATA - giá trị trả về của hợp đồng đã thực thi.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_call","params":[{see above}],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x"
}

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 tế được sử dụng bởi giao dịch, vì nhiều lý do bao gồm cơ chế EVM và hiệu suất của nút.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

Xem các tham số của eth_call, ngoại trừ việc 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ẽ sử dụng giới hạn gas của 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 thi lời 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ý.

Kết quả trả về

QUANTITY - lượng Gas được sử dụng.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_estimateGas","params":[{see above}],"id":1}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x5208" // 21000
}

eth_getBlockByHash

Trả về thông tin về một khối dựa trên mã băm.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - Mã băm của một khối.
  2. Boolean - Nếu là true nó sẽ trả về các đối tượng giao dịch đầy đủ, nếu là false thì chỉ trả về các mã băm của các giao dịch.
params: [
  "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
  false,
]

Kết quả 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ố thứ tự của khối. null khi nó là khối đang chờ xử lý.
  • hash: DATA, 32 Byte - mã băm của khối. null khi nó là khối đang chờ xử lý.
  • parentHash: DATA, 32 Byte - mã băm của khối cha.
  • nonce: DATA, 8 Byte - mã băm của bằng chứng công việc (PoW) được tạo. null khi nó là khối đang chờ xử lý, 0x0 đối với các khối bằng chứng cổ phần (PoS) (kể từ The Merge)
  • sha3Uncles: DATA, 32 Byte - mã băm SHA3 của dữ liệu uncle trong khối.
  • logsBloom: DATA, 256 Byte - bộ lọc bloom cho các nhật ký của khối. null khi nó là khối đang chờ xử lý.
  • transactionsRoot: DATA, 32 Byte - gốc của trie giao dịch của khối.
  • stateRoot: DATA, 32 Byte - gốc của trie trạng thái cuối cùng của khối.
  • receiptsRoot: DATA, 32 Byte - gốc của trie biên lai của khối.
  • miner: DATA, 20 Byte - địa chỉ của người thụ hưởng được nhận phần thưởng khối.
  • difficulty: QUANTITY - số nguyên thể hiện độ khó của khối này.
  • totalDifficulty: QUANTITY - số nguyên thể hiện tổng độ khó của chuỗi cho đến khối này.
  • extraData: DATA - trường "dữ liệu bổ sung" (extra data) của khối này.
  • size: QUANTITY - số nguyên thể hiệ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 đã 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 các mã băm giao dịch 32 Byte tùy thuộc vào tham số cuối cùng được cung cấp.
  • uncles: Array - Mảng các mã băm uncle.

Ví dụ

eth_getBlockByNumber

Trả về thông tin về một khối dựa trên số khối.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

  1. 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 tham số khối.
  2. Boolean - Nếu là true nó sẽ trả về các đối tượng giao dịch đầy đủ, nếu là false thì chỉ trả về các mã băm của các giao dịch.
params: [
  "0x1b4", // 436
  true,
]

Kết quả trả về Xem eth_getBlockByHash

Ví dụ

// Yêu cầu
curl -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 mã băm giao dịch.

Thử điểm cuối trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - mã băm của một giao dịch
params: ["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 - mã băm của khối chứa giao dịch này. null khi nó đang chờ xử lý.
  • blockNumber: QUANTITY - số khối chứa giao dịch này. null khi nó đang chờ xử lý.
  • from: DATA, 20 Byte - địa chỉ của người gửi.
  • gas: QUANTITY - gas được cung cấp bởi người gửi.
  • gasPrice: QUANTITY - giá gas được cung cấp bởi người gửi tính bằng Wei.
  • hash: DATA, 32 Byte - mã băm của giao dịch.
  • input: DATA - dữ liệu được gửi kèm theo 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. null khi nó là một giao dịch tạo hợp đồng.
  • transactionIndex: QUANTITY - số nguyên của vị trí chỉ số giao dịch trong khối. null khi nó đang chờ xử lý.
  • value: QUANTITY - giá trị được chuyển tính bằng Wei.
  • v: QUANTITY - ID phục hồi ECDSA
  • r: QUANTITY - chữ ký ECDSA r
  • s: QUANTITY - chữ ký ECDSA s

Ví dụ

eth_getTransactionByBlockHashAndIndex

Trả về thông tin về một giao dịch theo mã băm của khối và vị trí chỉ số giao dịch.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - mã băm của một khối.
  2. QUANTITY - số nguyên của vị trí chỉ số giao dịch.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Kết quả trả về Xem eth_getTransactionByHash

Ví dụ

// Yêu cầu
curl -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ỉ số giao dịch.

Thử điểm cuối trong playground (opens in a new tab)

Các tham số

  1. QUANTITY|TAG - một số khối, hoặc chuỗi "earliest", "latest", "pending", "safe" hoặc "finalized", như trong tham số khối.
  2. QUANTITY - vị trí chỉ số giao dịch.
params: [
  "0x9c47cf", // 10241999
  "0x24", // 36
]

Kết quả trả về Xem eth_getTransactionByHash

Ví dụ

// Yêu cầu
curl -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 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ý.

Các tham số

  1. DATA, 32 Byte - mã băm của một giao dịch
params: ["0x85d995eba9763907fdf35cd2034144dd9d53ce32cbec21349d4b12823c6860c5"]

Kết quả 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 - mã băm của giao dịch.
  • transactionIndex: QUANTITY - số nguyên của vị trí chỉ số giao dịch trong khối.
  • blockHash: DATA, 32 Byte - mã băm của khối chứa giao dịch này.
  • blockNumber: QUANTITY - số khối chứa giao dịch này.
  • 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 đã sử dụng khi giao dịch này được thực thi trong khối.
  • effectiveGasPrice : QUANTITY - Tổng của phí cơ sở và phí ưu tiên được trả cho mỗi đơn vị gas.
  • gasUsed : QUANTITY - Lượng gas được sử dụng bởi riêng 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à một giao dịch tạo hợp đồng, nếu không thì là null.
  • logs: Array - Mảng các đối tượng nhật ký, mà giao dịch này đã tạo ra.
  • logsBloom: DATA, 256 Byte - Bộ lọc Bloom dành cho các máy khách nhẹ để nhanh chóng truy xuất các nhật ký liên quan.
  • type: QUANTITY - số nguyên của loại giao dịch, 0x0 cho các giao dịch cũ (legacy), 0x1 cho các loại danh sách truy cập (access list), 0x2 cho phí động (dynamic fees).

Nó cũng trả về một trong hai :

  • root : DATA 32 byte của gốc trạng thái sau giao dịch (trước Byzantium)
  • status: QUANTITY hoặc 1 (thành công) hoặc 0 (thất bại)

Ví dụ

eth_getUncleByBlockHashAndIndex

Trả về thông tin về một uncle của một khối dựa trên mã băm và vị trí chỉ số của uncle.

Thử nghiệm endpoint trong playground (opens in a new tab)

Các tham số

  1. DATA, 32 Byte - Mã băm của một khối.
  2. QUANTITY - Vị trí chỉ số của uncle.
params: [
  "0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2",
  "0x0", // 0
]

Kết quả trả về Xem eth_getBlockByHash

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getUncleByBlockHashAndIndex","params":["0x1d59ff54b1eb26b013ce3cb5fc9dab3705b415a67127a003c3e61eb445bb8df2", "0x0"],"id":1}'

Kết quả xem eth_getBlockByHash

Lưu ý: Một uncle không chứa các giao dịch riêng lẻ.

eth_getUncleByBlockNumberAndIndex

Trả về thông tin về một uncle của một khối theo số và vị trí chỉ số uncle.

Thử nghiệm điểm cuối trong playground (opens in a new tab)

Các tham số

  1. QUANTITY|TAG - một số khối, hoặc chuỗi "earliest", "latest", "pending", "safe", "finalized", như trong tham số khối.
  2. QUANTITY - vị trí chỉ số của uncle.
params: [
  "0x29c", // 668
  "0x0", // 0
]

Kết quả trả về Xem eth_getBlockByHash

Lưu ý: Một uncle không chứa các giao dịch riêng lẻ.

Ví dụ

// Yêu cầu
curl -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 hay chưa, hãy gọi eth_getFilterChanges.

Lưu ý về việc chỉ định bộ lọc chủ đề: Các chủ đề phụ thuộc vào thứ tự. Một giao dịch có nhật ký với các chủ đề [A, B] sẽ khớp với các bộ lọc chủ đề sau:

  • [] "bất kỳ thứ gì"
  • [A] "A ở vị trí đầu tiên (và bất kỳ thứ gì sau đó)"
  • [null, B] "bất kỳ thứ gì ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và bất kỳ thứ gì sau đó)"
  • [A, B] "A ở vị trí đầu tiên VÀ B ở vị trí thứ hai (và bất kỳ thứ 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 kỳ thứ gì sau đó)"
  • Các tham số
  1. 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 mới nhất, "finalized" cho khối đã chung cuộc mới nhất, hoặc "pending", "earliest" cho các giao dịch chưa nằm trong một 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 mới nhất, "finalized" cho khối đã chung cuộc mới nhất, hoặc "pending", "earliest" cho các giao dịch chưa nằm trong một 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 các chủ đề DATA 32 Byte. 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" (or).

Kết quả trả về QUANTITY - Một ID bộ lọc.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newFilter","params":[{"topics":["0x12341234"]}],"id":73}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": "0x1" // 1
}

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 hay chưa, hãy gọi eth_getFilterChanges.

Các tham số Không có

Kết quả trả về QUANTITY - Một ID bộ lọc.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newBlockFilter","params":[],"id":73}'
// Kết quả
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

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 đến. Để kiểm tra xem trạng thái đã thay đổi hay chưa, hãy gọi eth_getFilterChanges.

Các tham số Không có

Kết quả trả về QUANTITY - Một ID bộ lọc.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_newPendingTransactionFilter","params":[],"id":73}'
// Kết quả
{
  "id":1,
  "jsonrpc":  "2.0",
  "result": "0x1" // 1
}

eth_uninstallFilter

Gỡ cài đặt một bộ lọc với id đã cho. Luôn nên được gọi khi không còn cần theo dõi nữa. Ngoài ra, các bộ lọc sẽ hết hạn khi chúng không được yêu cầu bằng eth_getFilterChanges trong một khoảng thời gian.

Các tham số

  1. QUANTITY - Id của bộ lọc.
params: [
  "0xb", // 11
]

Kết quả trả về Boolean - true nếu bộ lọc đã được gỡ cài đặt thành công, nếu không thì trả về false.

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_uninstallFilter","params":["0xb"],"id":73}'
// Kết quả
{
  "id":1,
  "jsonrpc": "2.0",
  "result": true
}

eth_getFilterChanges

Phương thức thăm dò (polling) cho một bộ lọc, trả về một mảng các nhật ký đã xảy ra kể từ lần thăm dò cuối cùng.

Các tham số

  1. QUANTITY - ID của bộ lọc.
params: [
  "0x16", // 22
]

Kết quả trả về Array - Mảng các đối tượng nhật ký, hoặc một mảng rỗng nếu không có gì thay đổi kể từ lần thăm dò cuối cùng.

  • Đối với các bộ lọc được tạo bằng eth_newBlockFilter, kết quả trả về là các 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 , kết quả trả về là các 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, các nhật ký là các đối tượng có các tham số sau:

    • removed: TAG - true khi nhật ký bị xóa do tổ chức lại chuỗi. false nếu đó là một nhật ký hợp lệ.
    • logIndex: QUANTITY - số nguyên của vị trí chỉ số nhật ký trong khối. null khi nó là nhật ký đang chờ xử lý.
    • transactionIndex: QUANTITY - số nguyên của vị trí chỉ số giao dịch mà từ đó nhật ký được tạo ra. null khi nó là nhật ký đang chờ xử lý.
    • transactionHash: DATA, 32 Byte - mã băm của giao dịch mà từ đó nhật ký này được tạo ra. null khi nó là nhật ký đang chờ xử lý.
    • blockHash: DATA, 32 Byte - mã băm của khối chứa nhật ký này. null khi nó đang chờ xử lý. null khi nó là nhật ký đang chờ xử lý.
    • blockNumber: QUANTITY - số khối chứa nhật ký này. null khi nó đang chờ xử lý. null khi nó là nhật ký đang chờ xử lý.
    • address: DATA, 20 Byte - địa chỉ mà từ đó 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 đối số nhật ký không được lập chỉ mục 32 Byte.)
    • topics: Array of DATA - Mảng từ 0 đến 4 DATA 32 Byte của các đối số nhật ký được lập chỉ mục. (Trong Solidity: Chủ đề đầu tiên là 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 từ khóa chỉ định anonymous.)

  • Ví dụ

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ố

  1. QUANTITY - Id của bộ lọc.
params: [
  "0x16", // 22
]

Trả về Xem eth_getFilterChanges

Ví dụ

// Yêu cầu
curl -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 chứa tất cả các nhật ký khớp với một đối tượng bộ lọc đã cho.

Các tham số

  1. 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 mới nhất, "finalized" cho khối đã chung cuộc mới nhất, hoặc "pending", "earliest" cho các giao dịch chưa nằm trong một 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 mới nhất, "finalized" cho khối đã chung cuộc mới nhất, hoặc "pending", "earliest" cho các giao dịch chưa nằm trong một khối.
  • address: DATA|Array, 20 Byte - (tùy chọn) Địa chỉ hợp đồng hoặc một 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 gồm các chủ đề DATA 32 Byte. 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" ("or").
  • blockHash: DATA, 32 Byte - (tùy chọn, trong tương lai) Với việc bổ sung EIP-234, blockHash sẽ là một tùy chọn bộ lọc mới giúp giới hạn các nhật ký được trả về trong một khối duy nhất có mã băm 32 byte blockHash. Việc sử dụng blockHash tương đương với fromBlock = toBlock = số khối có mã băm blockHash. Nếu blockHash có mặt trong các tiêu chí bộ lọc, thì cả fromBlock và toBlock đều không được phép sử dụng.
params: [
  {
    topics: [
      "0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    ],
  },
]

Trả về Xem eth_getFilterChanges

Ví dụ

// Yêu cầu
curl -X POST --data '{"jsonrpc":"2.0","method":"eth_getLogs","params":[{"topics":["0x000000000000000000000000a94f5374fce5edbc8e2a8697c15331677e6ebf0b"]}],"id":74}'

Kết quả xem eth_getFilterChanges

Ví dụ sử dụng

Triển khai hợp đồng bằng JSON-RPC

Phần này trình bày cách triển khai hợp đồng chỉ bằng giao diện RPC. Có những cách khác để triển khai 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.js (opens in a new tab) và web3.py (opens in a new tab). Những sự trừu tượng hóa này nhìn chung dễ hiểu hơn và ít dễ mắc lỗi hơn, nhưng việc hiểu cách thức hoạt động bên trong vẫn rất hữu ích.

Dưới đây là một hợp đồng thông minh đơn giản có tên Multiply7 sẽ được triển khai bằng giao diện JSON-RPC tới một nút Ethereum. Hướng dẫn này giả định rằng người đọc đã và đang chạy một nút Geth. Thông tin thêm về các nút và ứng dụng khách có sẵn tại đây. Vui lòng tham khảo tài liệu của từng ứng dụng khách để xem cách khởi chạy HTTP JSON-RPC cho các ứng dụng khách không phải Geth. Hầu hết các ứng dụng khách mặc định phục vụ trên localhost:8545.

contract Multiply7 {
    event Print(uint);
    function multiply(uint input) returns (uint) {
        Print(input * 7);
        return input * 7;
    }
}

Điều đầu tiên cần làm là đảm bảo giao diện HTTP RPC đã được bật. Điều này có nghĩa là chúng ta cung cấp cho Geth cờ --http khi khởi động. Trong ví dụ này, chúng ta sử dụng nút Geth trên một chuỗi phát triển riêng tư. Sử dụng phương pháp này, chúng ta không cần ether trên mạng lưới thực.

geth --http --dev console 2>>geth.log

Lệnh này sẽ khởi chạy giao diện HTTP RPC trên http://localhost:8545.

Chúng ta 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 các tài khoản) và số dư bằng cách sử dụng curl (opens in a new tab). Xin lưu ý rằng dữ liệu trong các ví dụ này sẽ khác nhau 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 hex, số dư được trả về bằng wei dưới dạng chuỗi hex. Nếu chúng ta muốn có số dư bằng ether dưới dạng số, chúng ta có thể sử dụng web3 từ bảng điều khiển Geth.

web3.fromWei("0x1639e49bba16280000", "ether")
// "410"

Bây giờ đã có một ít ether trên chuỗi phát triển riêng tư của chúng ta, chúng ta 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ể gửi đến EVM. Để cài đặt solc, trình biên dịch Solidity, hãy làm theo tài liệu Solidity (opens in a new tab). (Bạn có thể muốn sử dụng một 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ôi (opens in a new tab).)

Bước tiếp theo là biên dịch hợp đồng Multiply7 thành mã byte để có thể gửi đến EVM.

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

Bây giờ chúng ta đã có mã được biên dịch, chúng ta cần xác định xem tốn bao nhiêu gas để triển khai nó. Giao diện RPC có một phương thức eth_estimateGas sẽ cung cấp 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 là 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 nút chấp nhận và một mã băm giao dịch được trả về. 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 lai. Biên lai 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 đưa vào khối nào và EVM đã 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 lai 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ả null thay vì biên lai 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 ứng dụng khách đồng thuận của bạn có đang chạy hay 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 tới 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 payload xác định phương thức nào phải được gọi và với các đố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 EVM.

Các byte của payload xác định phương thức nào trong hợp đồng được gọi. Đây là 4 byte đầu tiên từ mã băm Keccak trên tên hàm và các kiểu đối số của nó, được mã hóa hex. Hàm multiply chấp nhận một uint, là bí danh của uint256. Điều này để lại cho chúng ta:

web3.sha3("multiply(uint256)").substring(0, 10)
// "0xc6888fa1"

Bước tiếp theo là mã hóa các đối số. Chỉ có một uint256, giả sử là giá trị 6. ABI có một phần chỉ định cách mã hóa các kiểu uint256.

int<M>: enc(X) là mã hóa bù hai big-endian của X, được đệm ở phía bậc cao (bên trái) bằng 0xff đối với X âm và bằng các byte 0 đối với X dương sao cho độ dài là bội số của 32 byte.

Điều này mã hóa thành 0000000000000000000000000000000000000000000000000000000000000006.

Kết hợp bộ chọn hàm và đối số được mã hóa, dữ liệu của chúng ta sẽ là 0xc6888fa10000000000000000000000000000000000000000000000000000000000000006.

Bây giờ dữ liệu này có thể được gửi đế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 mã băm giao dịch đã được trả về. Việc truy xuất biên lai cho kết quả:

Biên lai chứa một nhật ký. Nhật ký này được EVM tạo ra khi thực thi giao dịch và được đưa vào biên lai. Hàm multiply cho thấy sự kiện Print đã được kích hoạt 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 số thập phân 42 như mong đợi. Ngoài dữ liệu, điều đáng chú ý là các chủ đề có thể được sử dụng để xác định sự kiện nào đã tạo ra nhật ký:

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

Đây chỉ là phần giới thiệu ngắn gọn về một số tác vụ phổ biến nhất, trình bày cách sử dụng trực tiếp JSON-RPC.