Ethereum RPC 端点文档 - ERPC
Ethereum RPC 端点文档
将 ERPC 用作您的 Ethereum RPC 端点,处理 HTTP JSON-RPC 请求和 WebSocket 订阅。Ethereum RPC 是 ERPC 在 Global Edge Blockchain Infrastructure 中提供的 RPC APIs 之一,API key 可以在 ERPC Web Dashboard 中管理。
您可以直接使用与 Solana 相同的 RPC key。
请将您的 API key 添加到 'api-key' 参数中。
端点
将 JSON-RPC 2.0 请求以 HTTP POST 方式发送至:
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>如需订阅,请通过 WebSocket 连接至:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>示例
以下是 HTTP 请求示例。
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"
}'以下是 WebSocket 订阅示例。
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"]}您可以在 ERPC Web Dashboard 获取和查看 API key。
批量请求
每次 HTTP 请求最多支持 256 个 JSON-RPC 批量调用,同时也接受 JSON-RPC notification。批次中的每次调用都会作为单独的调用计量。
用量计量
用量按每次 JSON-RPC 调用的统一费率以 token 计量,所有 Ethereum RPC 方法费率相同。HTTP 批量请求中的每个条目,以及通过 WebSocket 连接发送的每个 JSON-RPC 调用,都会单独计量。您可以在 Ethereum RPC API 参考 中查看当前的单次调用 token 费率。
支持的方法
该端点覆盖标准 Ethereum JSON-RPC 方法族 —
eth_*、net_*、txpool_*、web3_* — 包括账户与区块读取(eth_getBalance、eth_getBlockByNumber、eth_getLogs)、交易流程(eth_sendRawTransaction、eth_getTransactionReceipt)、手续费数据(eth_feeHistory、eth_maxPriorityFeePerGas)、调用模拟(eth_call、eth_callMany、eth_simulateV1)、状态证明(eth_getProof)、过滤器(eth_newFilter、eth_getFilterChanges)、txpool 检查(txpool_status、txpool_content)以及 WebSocket 订阅(eth_subscribe、eth_unsubscribe)。如需包含请求和响应格式的完整方法列表,请参阅 Ethereum RPC API 参考。
响应状态码
| HTTP 状态码 | 含义 |
|---|---|
| 200 | 上游 JSON-RPC 响应 |
| 400 | 无效的 JSON-RPC 请求 |
| 401 | 缺少 API key 或未获授权 |
| 429 | 受下游 RPC 策略限制速率 |
| 502 | 代理不可用 |
| 503 | 下游 RPC 服务不可用 |
WebSocket 连接除上述状态码外,还会使用
101(协议升级已接受) 和 426(需要进行 WebSocket Upgrade 握手)。Ethereum RPC 方法和文档
有关标准方法、参数和订阅规范的完整列表,请参阅官方文档。文档涵盖 HTTP 和 WebSocket 的使用方式。






