Avalanche RPC 快速开始 - ERPC

Avalanche RPC 快速开始

本指南将带您从零开始，使用 ERPC 获取您的第一个 Avalanche JSON-RPC 响应。

1. 获取 API key

您可以在 ERPC Web Dashboard 获取和查看 API key。

已经在 Solana 或 Ethereum 上使用 ERPC 了吗？您可以直接使用相同的 RPC key。

2. 发送您的第一个请求

将 API key 放入 api-key 参数，以 HTTP POST 方式发送 JSON-RPC 2.0 请求：

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"
}'

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"
}'

响应会以十六进制返回最新的 C-Chain 区块号：

json

{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }

{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }

您可以使用 eth_chainId 确认该端点所服务的链。结果为 0xa86a — 即 43114，也就是 Avalanche C-Chain 主网的链 ID：

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_chainId"
}'

curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_chainId"
}'

同一端点还提供 Avalanche 原生 API。上游 API 由精确的方法名决定，因此 X-Chain(avm.*) 和 P-Chain(platform.*) 调用无需额外的路径或主机：

bash

curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"platform.getHeight",
  "params":{}
}'

curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"platform.getHeight",
  "params":{}
}'

3. 通过 WebSocket 订阅

WebSocket 端点支持标准的 C-Chain eth_subscribe 订阅：

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"]}

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"]}

有关可用的订阅类型，请参阅下方链接的官方 Avalanche C-Chain 文档。

4. 批量请求

您可以在一次 HTTP 请求中为 C-Chain 的 EVM 方法发送最多 256 个 JSON-RPC 调用。批次中的每次调用都会作为单独的调用计量。

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"},
  {"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'

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"},
  {"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'

后续步骤

端点、计量与状态码：Avalanche RPC 端点文档
包含请求和响应格式的完整方法列表：Avalanche RPC API 参考
官方 Avalanche C-Chain 文档：https://build.avax.network/docs/rpcs/c-chain

Ethereum RPC 端点文档 - ERPC

Avalanche RPC 端点文档 - ERPC