ERPC

เอกสาร Avalanche RPC Endpoint | ERPC

เอกสาร Avalanche RPC Endpoint

ใช้ ERPC เป็น Avalanche RPC endpoint ของคุณสำหรับ HTTP JSON-RPC requests และ WebSocket subscriptions ทั้งนี้ Avalanche RPC เป็นส่วนหนึ่งของ RPC APIs ของ ERPC ภายใน Global Edge Blockchain Infrastructure ของเรา และสามารถจัดการ API key ได้จาก ERPC Web Dashboard
คุณสามารถใช้ RPC key เดียวกับ Solana และ Ethereum ได้
โปรดเพิ่ม API key ของคุณในพารามิเตอร์ 'api-key'

Endpoint

ส่ง JSON-RPC 2.0 requests แบบ HTTP POST ไปที่:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
สำหรับ subscription ให้เชื่อมต่อผ่าน WebSocket ไปที่:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
Upstream API ถูกเลือกตามชื่อ method JSON-RPC ที่ตรงกันทุกประการ ดังนั้นคำสั่งเรียกของ C-Chain, X-Chain และ P-Chain ทั้งหมดจึงไปที่ endpoint เดียวกัน

ตัวอย่าง

นี่คือตัวอย่าง HTTP request
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"
}'
นี่คือตัวอย่าง WebSocket subscription
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"]}
คุณสามารถสร้างและตรวจสอบ API key ได้ใน ERPC Web Dashboard: ERPC Web Dashboard

Request แบบ Batch

รองรับ JSON-RPC batch สูงสุด 256 คำสั่งเรียกต่อหนึ่ง HTTP request สำหรับ method EVM ของ C-Chain และรองรับ JSON-RPC notification ด้วยเช่นกัน native namespace ของ Avalanche — avax.*, avm.*, platform.*, proposervm.* และ info.upgrades — ต้องเรียกทีละรายการ แต่ละคำสั่งเรียกในหนึ่ง batch จะถูกวัดเป็นคำสั่งเรียกแยกกัน

การวัดผลการใช้งาน

การใช้งานจะถูกวัดเป็น token ในอัตราคงที่ต่อหนึ่งคำสั่งเรียก JSON-RPC — อัตราเดียวกันสำหรับทุก method ของ Avalanche RPC แต่ละรายการในหนึ่ง HTTP batch และแต่ละคำสั่งเรียก JSON-RPC ที่ส่งผ่านการเชื่อมต่อ WebSocket จะถูกวัดแยกกัน คุณสามารถตรวจสอบอัตรา token ต่อคำสั่งเรียกปัจจุบันได้ใน ข้อมูลอ้างอิง Avalanche RPC API

เมธอดที่รองรับ

Endpoint นี้ครอบคลุมกลุ่ม method JSON-RPC EVM ของ C-Chain — eth_*, net_*, txpool_* และ web3_* — รวมถึงการอ่านบัญชีและบล็อก (eth_getBalance, eth_getBlockByNumber, eth_getLogs), การทำธุรกรรม (eth_sendRawTransaction, eth_getTransactionReceipt), ข้อมูลค่าธรรมเนียม (eth_gasPrice, eth_maxPriorityFeePerGas), การจำลองการเรียก (eth_call, eth_estimateGas), filter (eth_newFilter, eth_getFilterChanges), การตรวจสอบ txpool (txpool_status, txpool_content), ส่วนขยายของ C-Chain (eth_getAssetBalance, eth_baseFee) และ WebSocket subscription (eth_subscribe, eth_unsubscribe)
native API ของ Avalanche ให้บริการจาก endpoint เดียวกัน ได้แก่ atomic operation ของ C-Chain (avax.getAtomicTx, avax.getUTXOs, avax.issueTx), X-Chain (avm.getBalance, avm.getTx, avm.issueTx), P-Chain (platform.getCurrentValidators, platform.getStake, platform.getHeight, platform.issueTx, proposervm.getProposedHeight) และเวลาการอัปเกรดเครือข่าย (info.upgrades)
สำหรับรายการ method ทั้งหมดพร้อมรูปแบบ request และ response โปรดดู ข้อมูลอ้างอิง Avalanche RPC API

รหัสสถานะการตอบกลับ

สถานะ HTTPความหมาย
200การตอบกลับ JSON-RPC จาก upstream
400ไม่มี API key หรือ JSON-RPC request ไม่ถูกต้อง
401API key ไม่ได้รับอนุญาต
429ถูกจำกัดอัตรา header retry-after ระบุเวลารอเป็นวินาที
502ไม่สามารถดำเนินการ upstream RPC request ได้
503บริการไม่พร้อมใช้งานชั่วคราว
method JSON-RPC ที่อยู่นอกแคตตาล็อกที่เผยแพร่จะได้รับการตอบกลับด้วย HTTP 400 และ JSON-RPC error -32601 (Method not found) และ batch ที่เกิน 256 คำสั่งเรียกจะได้รับการตอบกลับด้วย HTTP 400
การเชื่อมต่อ WebSocket ใช้ 101 (ยอมรับการอัปเกรดโปรโตคอล) และ 426 (ต้องมีการทำ handshake แบบ WebSocket Upgrade) นอกเหนือจากรหัสด้านบน

เมธอดและเอกสารของ Avalanche RPC

สำหรับรายการ method มาตรฐาน พารามิเตอร์ และข้อกำหนด subscription ทั้งหมด โปรดดูเอกสารทางการ ซึ่งครอบคลุมการใช้งานทั้ง HTTP และ WebSocket

ก่อนหน้า

Avalanche RPC เริ่มต้นใช้งานอย่างรวดเร็ว | ERPC

ถัดไป

Arbitrum RPC เริ่มต้นใช้งานอย่างรวดเร็ว | ERPC