Base RPC Endpoint Documentation | ERPC
เอกสาร Base RPC Endpoint
ใช้ ERPC เป็น Base RPC endpoint ของคุณสำหรับ HTTP JSON-RPC requests และ WebSocket subscriptions. Base RPC เป็นส่วนหนึ่งของ RPC APIs ของ ERPC ภายใน Global Edge Blockchain Infrastructure ของเรา และสามารถจัดการ API key ได้จาก ERPC Web Dashboard.
คุณสามารถใช้ RPC key เดียวกับ Solana, Ethereum และ Avalanche ได้.
โปรดเพิ่ม API key ของคุณในพารามิเตอร์
api-key.Endpoint
ส่ง JSON-RPC 2.0 requests แบบ HTTP POST ไปที่:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>สำหรับ subscription ให้เชื่อมต่อผ่าน WebSocket ไปที่:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>รับ request ที่
/ เท่านั้น.ตัวอย่าง
นี่คือตัวอย่าง HTTP request.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'คุณสามารถสร้างและตรวจสอบ API key ได้ใน ERPC Web Dashboard: ERPC Web Dashboard
Batch Requests
รองรับ JSON-RPC batch สูงสุด 256 คำสั่งเรียกต่อหนึ่ง HTTP request. แต่ละคำสั่งเรียกในหนึ่ง batch จะถูกวัดเป็นคำสั่งเรียกแยกกัน.
การวัดผลการใช้งาน
การใช้งานจะถูกวัดเป็น token ต่อหนึ่งคำสั่งเรียก JSON-RPC. แต่ละรายการในหนึ่ง HTTP batch และแต่ละคำสั่งเรียก JSON-RPC ที่ส่งผ่านการเชื่อมต่อ WebSocket จะถูกวัดแยกกัน.
ข้อจำกัดของแพ็กเกจ Free
ในแพ็กเกจ Free บัญชีของคุณส่งได้หนึ่ง request ต่อ 10 วินาที. ขีดจำกัดนี้นับต่อบัญชี ไม่ใช่ต่อ endpoint ดังนั้น request ที่ส่งไปยัง chain อื่นก็อาจถูกนับรวมในขีดจำกัดนี้ด้วย. request ที่ส่งเร็วกว่านั้นจะได้รับการตอบกลับด้วย HTTP
429 และ header retry-after จะระบุเวลาที่ต้องรอเป็นวินาที.ในแพ็กเกจ Free request ที่มีคำสั่งเรียก JSON-RPC ตั้งแต่ 2 รายการขึ้นไปจะได้รับการตอบกลับด้วย HTTP
429 และจะไม่มีคำสั่งเรียกใดถูกส่งเลย: แต่ละคำสั่งเรียกจะได้รับ JSON-RPC error ที่มีรหัส -32041. ให้ส่งคำสั่งเรียกเหล่านี้ทีละรายการแทน.ในแพ็กเกจ Free ไม่สามารถใช้การเชื่อมต่อ WebSocket ได้ และจะได้รับการตอบกลับด้วย HTTP
403.เมธอดที่รองรับ
Base เข้ากันได้กับ EVM และใช้ JSON-RPC method เดียวกับ Ethereum. ERPC ไม่ได้กำหนด allowlist ของ method แบบตายตัวสำหรับ endpoint ของ Base. สำหรับกลุ่ม method ของ Ethereum โปรดดู เอกสาร Ethereum RPC Endpoint.
รหัสสถานะการตอบกลับ
| HTTP status | ความหมาย |
|---|---|
| 200 | การตอบกลับ JSON-RPC จาก upstream. |
| 400 | Missing API key, Invalid JSON-RPC request หรือ JSON-RPC batch exceeds 256 calls. |
| 401 | Unauthorized API KEY. |
| 403 | การเชื่อมต่อ WebSocket ในแพ็กเกจ Free. |
| 404 | path อื่นที่ไม่ใช่ /. |
| 429 | ถูกจำกัดอัตรา รวมถึงข้อจำกัดของแพ็กเกจ Free ข้างต้น: มากกว่าหนึ่ง request ต่อ 10 วินาที หรือมีคำสั่งเรียกตั้งแต่ 2 รายการขึ้นไปใน request เดียว. header retry-after ระบุเวลารอเป็นวินาที. |
| 502 | ไม่สามารถดำเนินการ upstream RPC request ได้. |
| 503 | บริการไม่พร้อมใช้งานชั่วคราว. |
การเชื่อมต่อ WebSocket ใช้
101 (ยอมรับการอัปเกรดโปรโตคอล) นอกเหนือจากรหัสด้านบน.Base RPC Methods และ Documentation
สำหรับรายการ method มาตรฐาน พารามิเตอร์ และข้อกำหนดทั้งหมด โปรดดูเอกสารทางการ.