Tài liệu Base RPC Endpoint | ERPC
Tài liệu Base RPC Endpoint
ERPC có thể được dùng làm Base RPC endpoint cho HTTP JSON-RPC request và WebSocket subscription. Base 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, Ethereum và Avalanche.
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://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>Để nhận subscription, hãy kết nối qua WebSocket đến:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>Chỉ chấp nhận request tại
/.Ví dụ
Đây là ví dụ về HTTP request.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'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. Mỗi lệnh gọi trong một batch được tính là 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 cho mỗi lệnh gọi JSON-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.
Giới hạn của Gói Free
Trên Gói Free, tài khoản của bạn có thể gửi một request mỗi 10 giây. Giới hạn được tính theo tài khoản, không phải theo endpoint, nên một request tới chain khác cũng có thể được tính vào giới hạn này. Request gửi sớm hơn sẽ nhận phản hồi HTTP
429, và header retry-after cho biết thời gian chờ tính bằng giây.Trên Gói Free, một request chứa từ hai lệnh gọi JSON-RPC trở lên sẽ nhận phản hồi HTTP
429, và không lệnh gọi nào trong đó được gửi đi: mỗi lệnh gọi nhận một lỗi JSON-RPC với mã -32041. Hãy gửi từng lệnh gọi một thay vào đó.Trên Gói Free, kết nối WebSocket không khả dụng và sẽ nhận phản hồi HTTP
403.Phương thức được hỗ trợ
Base tương thích EVM và dùng các method JSON-RPC giống như Ethereum. ERPC không áp dụng allowlist method cố định cho endpoint Base. Để xem các nhóm method của Ethereum, hãy xem Tài liệu Ethereum RPC Endpoint.
Mã trạng thái phản hồi
| HTTP status | Ý nghĩa |
|---|---|
| 200 | Response JSON-RPC từ upstream. |
| 400 | Missing API key, Invalid JSON-RPC request, hoặc JSON-RPC batch exceeds 256 calls. |
| 401 | Unauthorized API KEY. |
| 403 | Một kết nối WebSocket trên Gói Free. |
| 404 | Path khác /. |
| 429 | Bị giới hạn tốc độ, bao gồm các giới hạn của Gói Free ở trên: nhiều hơn một request mỗi 10 giây, hoặc từ hai lệnh gọi trở lên trong một request. Header retry-after cho biết thời gian chờ tính bằng giây. |
| 502 | Không thể hoàn tất request RPC upstream. |
| 503 | Dịch vụ tạm thời không khả dụng. |
Kết nối WebSocket dùng
101 (chấp nhận nâng cấp giao thức) ngoài các mã ở trên.Phương thức Base RPC và tài liệu
Để xem danh sách đầy đủ các phương thức chuẩn, tham số và đặc tả, hãy tham khảo tài liệu chính thức.