ERPC

وثائق نقطة نهاية Avalanche RPC | ERPC

وثائق نقطة نهاية Avalanche RPC

استخدم ERPC كنقطة نهاية Avalanche RPC الخاصة بك لطلبات HTTP JSON-RPC واشتراكات WebSocket. يُعد Avalanche RPC جزءًا من RPC APIs الخاصة بـERPC ضمن Global Edge Blockchain Infrastructure لدينا، ويمكن إدارة مفتاح API من ERPC Web Dashboard.
يمكنك استخدام نفس مفتاح RPC الذي تستخدمه مع Solana وEthereum.
يُرجى إضافة مفتاح API الخاص بك إلى المعامل 'api-key'.

نقاط النهاية

أرسل طلبات JSON-RPC 2.0 كطلبات HTTP POST إلى:
text
https://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
للاشتراكات، اتصل عبر WebSocket بـ:
text
wss://edge.erpc.global/ava?api-key=<YOUR_API_KEY>
يتم اختيار واجهة API upstream وفق اسم طريقة JSON-RPC الدقيق، لذا تذهب استدعاءات C-Chain وX-Chain وP-Chain جميعها إلى نفس نقطة النهاية.

أمثلة:

إليك مثالًا على طلب HTTP.
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.
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 الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard

الطلبات المجمّعة

يُدعم إرسال دفعات JSON-RPC تصل إلى 256 استدعاء لكل طلب HTTP لطرق C-Chain EVM، كما تُقبل إشعارات JSON-RPC. مساحات الأسماء الأصلية الخاصة بـAvalanche — avax.* وavm.* وplatform.* وproposervm.* وinfo.upgrades — تُستدعى واحدة تلو الأخرى. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل.

قياس الاستخدام

يُقاس الاستخدام بالرموز بمعدل ثابت لكل استدعاء JSON-RPC — وهو نفس المعدل لكل طريقة من طرق Avalanche RPC. يُقاس كل إدخال في الطلب المجمّع عبر HTTP وكل استدعاء JSON-RPC يُرسَل عبر اتصال WebSocket بشكل منفصل. يمكنك الاطلاع على معدل الرموز الحالي لكل استدعاء في مرجع Avalanche RPC API.

الطرق المدعومة

تغطي نقطة النهاية عائلات طرق C-Chain EVM JSON-RPC — eth_* وnet_* وtxpool_* وweb3_* — بما في ذلك قراءات الحسابات والكتل (eth_getBalance، eth_getBlockByNumber، eth_getLogs)، وتدفق المعاملات (eth_sendRawTransaction، eth_getTransactionReceipt)، وبيانات الرسوم (eth_gasPrice، eth_maxPriorityFeePerGas)، ومحاكاة الاستدعاءات (eth_call، eth_estimateGas)، والمرشِّحات (eth_newFilter، eth_getFilterChanges)، وفحص txpool (txpool_status، txpool_content)، وامتدادات C-Chain (eth_getAssetBalance، eth_baseFee)، واشتراكات WebSocket (eth_subscribe، eth_unsubscribe).
تُقدَّم واجهات API الأصلية الخاصة بـAvalanche من نفس نقطة النهاية: عمليات 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).
للحصول على القائمة الكاملة للطرق مع أشكال الطلب والاستجابة، راجع مرجع Avalanche RPC API.

رموز حالة الاستجابة

HTTP statusالمعنى
200استجابة JSON-RPC من upstream.
400مفتاح API مفقود، أو طلب JSON-RPC غير صالح.
401مفتاح API غير مصرَّح به.
429تقييد المعدل. توضّح ترويسة retry-after مدة الانتظار بالثواني.
502تعذّر إكمال طلب RPC upstream.
503الخدمة غير متاحة مؤقتًا.
طريقة JSON-RPC خارج القائمة المنشورة تُقابَل باستجابة HTTP 400 وخطأ JSON-RPC -32601 (Method not found)، والدفعة التي تتجاوز 256 استدعاء تُقابَل باستجابة HTTP 400.
تستخدم اتصالات WebSocket الرمزين 101 (تم قبول ترقية البروتوكول) و426 (مطلوب تنفيذ handshake من نوع WebSocket Upgrade) بالإضافة إلى الرموز أعلاه.

طرق Avalanche RPC والوثائق

للقائمة الكاملة بالطرق القياسية والمعاملات ومواصفات الاشتراك، يُرجى الرجوع إلى الوثائق الرسمية. فهي تغطي استخدام HTTP وWebSocket كليهما.

السابق

البدء السريع لـAvalanche RPC | ERPC

التالي

SLV AI