البدء السريع لـAvalanche RPC | ERPC
البدء السريع لـAvalanche RPC
يأخذك هذا الدليل من الصفر إلى أول استجابة Avalanche JSON-RPC لك مع ERPC.
1. احصل على مفتاح API الخاص بك
يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard
هل تستخدم ERPC بالفعل لـSolana أو لـEthereum؟ يمكنك استخدام نفس مفتاح RPC.
2. أرسل طلبك الأول
أرسل طلب JSON-RPC 2.0 كطلب HTTP POST، مع تضمين مفتاح API الخاص بك في المعامل
api-key: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"
}'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"
}'تُعيد الاستجابة رقم آخر كتلة C-Chain بصيغة سداسية عشرية:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }يمكنك التحقق من السلسلة التي تخدمها نقطة النهاية باستخدام
eth_chainId. النتيجة هي 0xa86a — أي 43114، معرّف سلسلة Avalanche C-Chain الرئيسية: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_chainId"
}'curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_chainId"
}'نفس نقطة النهاية تخدم أيضًا واجهات API الأصلية الخاصة بـAvalanche. يتم اختيار واجهة API upstream وفق اسم الطريقة الدقيق، لذا لا تحتاج استدعاءات X-Chain (
avm.*) وP-Chain (platform.*) إلى مسار أو مضيف إضافي:bash
curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"platform.getHeight",
"params":{}
}'curl https://edge.erpc.global/ava?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"platform.getHeight",
"params":{}
}'3. الاشتراك عبر WebSocket
تقبل نقطة نهاية WebSocket اشتراكات
eth_subscribe القياسية الخاصة بـC-Chain: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"]}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"]}للاطلاع على أنواع الاشتراكات المتاحة، يُرجى الرجوع إلى وثائق Avalanche C-Chain الرسمية المرتبطة أدناه.
4. الطلبات المجمّعة
يمكنك إرسال ما يصل إلى 256 استدعاء JSON-RPC في طلب HTTP واحد لطرق C-Chain EVM. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل.
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"},
{"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'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"},
{"jsonrpc":"2.0","id":2,"method":"eth_gasPrice"}
]'الخطوات التالية
- نقاط النهاية والتسعير وأكواد الحالة: وثائق نقطة نهاية Avalanche RPC
- قائمة الطرق الكاملة مع أشكال الطلب والاستجابة: مرجع Avalanche RPC API
- وثائق Avalanche C-Chain الرسمية: https://build.avax.network/docs/rpcs/c-chain