Tài liệu Ethereum RPC Endpoint | ERPC
Tài liệu Ethereum RPC Endpoint
ERPC có thể được dùng làm Ethereum RPC endpoint cho HTTP JSON-RPC request và WebSocket subscription. Ethereum RPC là một phần trong RPC APIs của ERPC, nằm trong Global Edge Blockchain Infrastructure của chúng tôi, và API key có thể được quản lý từ ERPC Web Dashboard.
Bạn có thể dùng cùng một RPC key như với Solana.
Thêm API key của bạn vào tham số 'api-key'.
Endpoint
Gửi request JSON-RPC 2.0 dưới dạng HTTP POST đến:
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Để nhận subscription, hãy kết nối qua WebSocket đến:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>Ví dụ
Đây là ví dụ về HTTP request.
bash
curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'Đây là ví dụ về WebSocket subscription.
bash
wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}wscat -c "wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}Bạn có thể lấy và kiểm tra API key trên ERPC Web Dashboard: ERPC Web Dashboard
Batch Request
Hỗ trợ batch JSON-RPC lên đến 256 lệnh gọi cho mỗi HTTP request, và notification JSON-RPC cũng được chấp nhận. Mỗi lệnh gọi trong một batch được tính phí như một lệnh gọi riêng.
Đo lường mức sử dụng
Mức sử dụng được đo bằng token theo một tỷ lệ cố định cho mỗi lệnh gọi JSON-RPC — cùng một tỷ lệ cho mọi method của Ethereum RPC. Mỗi mục trong một HTTP batch và mỗi lệnh gọi JSON-RPC gửi qua kết nối WebSocket được đo riêng biệt. Bạn có thể kiểm tra tỷ lệ token hiện tại cho mỗi lệnh gọi trong Tài liệu API Ethereum RPC.
Phương thức được hỗ trợ
Endpoint này bao phủ các nhóm method JSON-RPC chuẩn của Ethereum —
eth_*, net_*, txpool_*, và web3_* — bao gồm đọc tài khoản và block (eth_getBalance, eth_getBlockByNumber, eth_getLogs), luồng giao dịch (eth_sendRawTransaction, eth_getTransactionReceipt), dữ liệu phí (eth_feeHistory, eth_maxPriorityFeePerGas), mô phỏng lệnh gọi (eth_call, eth_callMany, eth_simulateV1), state proof (eth_getProof), filter (eth_newFilter, eth_getFilterChanges), kiểm tra txpool (txpool_status, txpool_content), và WebSocket subscription (eth_subscribe, eth_unsubscribe).Để xem danh sách method đầy đủ với cấu trúc request và response, hãy xem Tài liệu API Ethereum RPC.
Mã trạng thái phản hồi
| HTTP status | Ý nghĩa |
|---|---|
| 200 | Response JSON-RPC từ upstream. |
| 400 | Request JSON-RPC không hợp lệ. |
| 401 | Thiếu API key hoặc API key không được ủy quyền. |
| 429 | Bị giới hạn tốc độ bởi chính sách RPC downstream. |
| 502 | Proxy không khả dụng. |
| 503 | Dịch vụ RPC downstream không khả dụng. |
Kết nối WebSocket dùng
101 (chấp nhận nâng cấp giao thức) và 426 (yêu cầu bắt tay WebSocket Upgrade) ngoài các mã ở trên.Phương thức Ethereum RPC và tài liệu
Để xem danh sách đầy đủ các phương thức chuẩn, tham số và đặc tả subscription, hãy tham khảo tài liệu chính thức. Tài liệu này bao gồm cả cách dùng HTTP và WebSocket.