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

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

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

يمكنك استخدام نفس مفتاح RPC الذي تستخدمه مع Solana.

يُرجى إضافة مفتاح API الخاص بك إلى المعامل 'api-key'.

نقاط النهاية

أرسل طلبات JSON-RPC 2.0 كطلبات HTTP POST إلى:

text

https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

https://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

للاشتراكات، اتصل عبر WebSocket بـ:

text

wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

wss://edge.erpc.global/eth?api-key=<YOUR_API_KEY>

أمثلة:

إليك مثالًا على طلب HTTP.

bash

curl https://edge.erpc.global/eth?api-key=<YOUR_API_KEY> --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'

curl https://edge.erpc.global/eth?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/eth?api-key=<YOUR_API_KEY>"
# After connected, send:
{"jsonrpc":"2.0","id":1,"method":"eth_subscribe","params":["newHeads"]}

wscat -c "wss://edge.erpc.global/eth?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، كما تُقبل إشعارات JSON-RPC. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل.

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

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

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

تغطي نقطة النهاية عائلات طرق Ethereum JSON-RPC القياسية — eth_* وnet_* وtxpool_* وweb3_* — بما في ذلك قراءات الحسابات والكتل (eth_getBalance، eth_getBlockByNumber، eth_getLogs)، وتدفق المعاملات (eth_sendRawTransaction، eth_getTransactionReceipt)، وبيانات الرسوم (eth_feeHistory، eth_maxPriorityFeePerGas)، ومحاكاة الاستدعاءات (eth_call، eth_callMany، eth_simulateV1)، وإثباتات الحالة (eth_getProof)، والمرشِّحات (eth_newFilter، eth_getFilterChanges)، وفحص txpool (txpool_status، txpool_content)، واشتراكات WebSocket (eth_subscribe، eth_unsubscribe).

للحصول على القائمة الكاملة للطرق مع أشكال الطلب والاستجابة، راجع مرجع Ethereum RPC API.

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

HTTP status	المعنى
200	استجابة JSON-RPC من upstream.
400	طلب JSON-RPC غير صالح.
401	مفتاح API مفقود أو غير مصرَّح به.
429	تقييد المعدل بواسطة سياسة downstream RPC.
502	proxy غير متاح.
503	خدمة downstream RPC غير متاحة.

تستخدم اتصالات WebSocket الرمزين 101 (تم قبول ترقية البروتوكول) و426 (مطلوب تنفيذ handshake من نوع WebSocket Upgrade) بالإضافة إلى الرموز أعلاه.

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

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

https://ethereum.org/en/developers/docs/apis/json-rpc/

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

SLV AI