ERPC

Avalanche RPC Endpoint Documentation | 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

Batch Requests

รองรับ 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 statusความหมาย
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 Methods และ Documentation

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

ก่อนหน้า

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

ถัดไป

SLV AI