ERPC

Avalanche RPC 端点文档 - ERPC

Avalanche RPC 端点文档

将 ERPC 用作您的 Avalanche RPC 端点，处理 HTTP JSON-RPC 请求和 WebSocket 订阅。Avalanche RPC 是 ERPC 在 Global Edge Blockchain Infrastructure 中提供的 RPC APIs 之一，API key 可以在 ERPC Web Dashboard 中管理。
您可以直接使用与 Solana 和 Ethereum 相同的 RPC key。
请将您的 API key 添加到 'api-key' 参数中。

端点

将 JSON-RPC 2.0 请求以 HTTP POST 方式发送至：
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
如需订阅，请通过 WebSocket 连接至：
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
上游 API 由精确的 JSON-RPC 方法名决定，因此 C-Chain、X-Chain 和 P-Chain 的调用都会发往同一个端点。

示例

以下是 HTTP 请求示例。
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"
}'
以下是 WebSocket 订阅示例。
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"]}
您可以在 ERPC Web Dashboard 获取和查看 API key。

批量请求

每次 HTTP 请求最多支持 256 个 JSON-RPC 批量调用，适用于 C-Chain 的 EVM 方法，同时也接受 JSON-RPC notification。Avalanche 的原生命名空间 — avax.*、avm.*、platform.*、proposervm.* 和 info.upgrades — 需要逐个调用。批次中的每次调用都会作为单独的调用计量。

用量计量

用量按每次 JSON-RPC 调用的统一费率以 token 计量，所有 Avalanche RPC 方法费率相同。HTTP 批量请求中的每个条目，以及通过 WebSocket 连接发送的每个 JSON-RPC 调用，都会单独计量。您可以在 Avalanche RPC API 参考 中查看当前的单次调用 token 费率。

支持的方法

该端点覆盖 C-Chain 的标准 EVM JSON-RPC 方法族 — eth_*、net_*、txpool_*、web3_* — 包括账户与区块读取(eth_getBalance、eth_getBlockByNumber、eth_getLogs)、交易流程(eth_sendRawTransaction、eth_getTransactionReceipt)、手续费数据(eth_gasPrice、eth_maxPriorityFeePerGas)、调用模拟(eth_call、eth_estimateGas)、过滤器(eth_newFilter、eth_getFilterChanges)、txpool 检查(txpool_status、txpool_content)、C-Chain 扩展方法(eth_getAssetBalance、eth_baseFee)以及 WebSocket 订阅(eth_subscribe、eth_unsubscribe)。
Avalanche 原生 API 也由同一端点提供：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)以及网络升级时间(info.upgrades)。
如需包含请求和响应格式的完整方法列表，请参阅 Avalanche RPC API 参考。

响应状态码

HTTP 状态码含义
200上游 JSON-RPC 响应
400缺少 API key，或 JSON-RPC 请求无效
401API key 未获授权
429已被限速。retry-after 响应头给出等待秒数
502上游 RPC 请求无法完成
503服务暂时不可用
发布目录之外的 JSON-RPC 方法会收到 HTTP 400 与 JSON-RPC 错误 -32601（Method not found）的响应，超过 256 个调用的批次会收到 HTTP 400 的响应。
WebSocket 连接除上述状态码外，还会使用 101(协议升级已接受) 和 426(需要进行 WebSocket Upgrade 握手)。

Avalanche RPC 方法和文档

有关标准方法、参数和订阅规范的完整列表，请参阅官方文档。文档涵盖 HTTP 和 WebSocket 的使用方式。

上一页

Avalanche RPC 快速开始 - ERPC

下一页

SLV AI