Ethereum RPC Endpoint Documentation | ERPC
เอกสาร Ethereum RPC Endpoint
ใช้ ERPC เป็น Ethereum RPC endpoint ของคุณสำหรับ HTTP JSON-RPC requests และ WebSocket subscriptions. Ethereum RPC เป็นส่วนหนึ่งของ RPC APIs ของ ERPC ภายใน Global Edge Blockchain Infrastructure ของเรา และสามารถจัดการ API key ได้จาก ERPC Web Dashboard.
คุณสามารถใช้ RPC key เดียวกับ Solana ได้.
โปรดเพิ่ม API key ของคุณในพารามิเตอร์
api-key.Endpoint
ส่ง JSON-RPC 2.0 requests แบบ HTTP POST ไปที่:
text
https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>สำหรับ subscription ให้เชื่อมต่อผ่าน WebSocket ไปที่:
text
wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>ตัวอย่าง
นี่คือตัวอย่าง HTTP request.
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 subscription.
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"]}คุณสามารถสร้างและตรวจสอบ API key ได้ใน ERPC Web Dashboard: ERPC Web Dashboard
Batch Requests
รองรับ JSON-RPC batch สูงสุด 256 คำสั่งเรียกต่อหนึ่ง HTTP request และรองรับ JSON-RPC notification ด้วยเช่นกัน. แต่ละคำสั่งเรียกในหนึ่ง batch จะถูกวัดเป็นคำสั่งเรียกแยกกัน.
การวัดผลการใช้งาน
การใช้งานจะถูกวัดเป็น token ในอัตราคงที่ต่อหนึ่งคำสั่งเรียก JSON-RPC — อัตราเดียวกันสำหรับทุก method ของ Ethereum RPC. แต่ละรายการในหนึ่ง HTTP batch และแต่ละคำสั่งเรียก JSON-RPC ที่ส่งผ่านการเชื่อมต่อ WebSocket จะถูกวัดแยกกัน. คุณสามารถตรวจสอบอัตรา token ต่อคำสั่งเรียกปัจจุบันได้ใน ข้อมูลอ้างอิง Ethereum RPC API.
เมธอดที่รองรับ
Endpoint นี้ครอบคลุมกลุ่ม method มาตรฐานของ 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), state proof (eth_getProof), filter (eth_newFilter, eth_getFilterChanges), การตรวจสอบ txpool (txpool_status, txpool_content) และ WebSocket subscription (eth_subscribe, eth_unsubscribe).สำหรับรายการ method ทั้งหมดพร้อมรูปแบบ request และ response โปรดดู ข้อมูลอ้างอิง Ethereum RPC API.
รหัสสถานะการตอบกลับ
| HTTP status | ความหมาย |
|---|---|
| 200 | การตอบกลับ JSON-RPC จาก upstream. |
| 400 | JSON-RPC request ไม่ถูกต้อง. |
| 401 | ไม่มี API key หรือ API key ไม่ได้รับอนุญาต. |
| 429 | ถูกจำกัดอัตราโดยนโยบายของ RPC downstream. |
| 502 | Proxy ไม่พร้อมใช้งาน. |
| 503 | บริการ RPC downstream ไม่พร้อมใช้งาน. |
การเชื่อมต่อ WebSocket ใช้
101 (ยอมรับการอัปเกรดโปรโตคอล) และ 426 (ต้องมีการทำ handshake แบบ WebSocket Upgrade) นอกเหนือจากรหัสด้านบน.Ethereum RPC Methods และ Documentation
สำหรับรายการ method มาตรฐาน พารามิเตอร์ และข้อกำหนด subscription ทั้งหมด โปรดดูเอกสารทางการ. ซึ่งครอบคลุมการใช้งานทั้ง HTTP และ WebSocket.