ERPC

Tài liệu Avalanche RPC Endpoint | ERPC

Tài liệu Avalanche RPC Endpoint

ERPC có thể được dùng làm Avalanche RPC endpoint cho HTTP JSON-RPC request và WebSocket subscription. Avalanche 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 và Ethereum.
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/ava?api-key=<YOUR_API_KEY>
Để nhận subscription, hãy kết nối qua WebSocket đến:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Upstream API được chọn theo đúng tên method JSON-RPC, do đó các lệnh gọi C-Chain, X-Chain và P-Chain đều đi đến cùng một endpoint.

Ví dụ

Đây là ví dụ về HTTP request.
bash
curl https://edge.erpc.global/ava?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/ava?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 cho các method EVM của C-Chain, và notification JSON-RPC cũng được chấp nhận. Các namespace gốc của Avalanche — avax.*, avm.*, platform.*, proposervm.*, và info.upgrades — được gọi từng lệnh một. 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 Avalanche 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 Avalanche RPC.

Phương thức được hỗ trợ

Endpoint này bao phủ các nhóm method JSON-RPC EVM chuẩn của C-Chain — 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_gasPrice, eth_maxPriorityFeePerGas), mô phỏng lệnh gọi (eth_call, eth_estimateGas), filter (eth_newFilter, eth_getFilterChanges), kiểm tra txpool (txpool_status, txpool_content), phần mở rộng của C-Chain (eth_getAssetBalance, eth_baseFee), và WebSocket subscription (eth_subscribe, eth_unsubscribe).
Các API gốc của Avalanche được phục vụ từ cùng một endpoint: thao tác atomic của C-Chain (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), X-Chain (avm.getBalance, avm.getTx, avm.issueTx), P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight), và thời điểm nâng cấp mạng (info.upgrades).
Để xem danh sách method đầy đủ với cấu trúc request và response, hãy xem Tài liệu API Avalanche RPC.

Mã trạng thái phản hồi

HTTP statusÝ nghĩa
200Response JSON-RPC từ upstream.
400Thiếu API key, hoặc request JSON-RPC không hợp lệ.
401API key không được ủy quyền.
429Bị giới hạn tốc độ. Header retry-after cho biết thời gian chờ tính bằng giây.
502Không thể hoàn tất request RPC upstream.
503Dịch vụ tạm thời không khả dụng.
Một method JSON-RPC nằm ngoài danh mục đã công bố sẽ nhận phản hồi HTTP 400 và lỗi JSON-RPC -32601 (Method not found), và một batch vượt quá 256 lệnh gọi sẽ nhận phản hồi HTTP 400.
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 Avalanche 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.

Trước đó

Avalanche RPC - Hướng dẫn nhanh | ERPC

Tiếp theo

SLV AI