ERPC Ethereum RPC 端點文件
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 的使用方式。






