ERPC

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

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

استخدم ERPC كنقطة نهاية Monad RPC الخاصة بك لطلبات HTTP JSON-RPC. يُعد Monad RPC جزءًا من RPC APIs الخاصة بـERPC ضمن Global Edge Blockchain Infrastructure لدينا، ويمكن إدارة مفتاح API من ERPC Web Dashboard.
يمكنك استخدام نفس مفتاح RPC الذي تستخدمه مع Solana وEthereum وAvalanche.
مرِّر مفتاح API الخاص بك في معامل الاستعلام api-key، أو أرسله بصيغة Authorization: Bearer <YOUR_API_KEY>. وعند وجود الاثنين معًا، يُستخدم معامل الاستعلام.

نقاط النهاية

أرسل طلبات JSON-RPC 2.0 كطلبات HTTP POST إلى:
text
https://edge.erpc.global/monad?api-key=<YOUR_API_KEY>
أو إلى المضيف المخصّص:
text
https://monad.erpc.global?api-key=<YOUR_API_KEY>
تُقبل الطلبات على المسار / فقط.

أمثلة

إليك مثالًا على طلب HTTP يُمرَّر فيه مفتاح API في معامل الاستعلام.
bash
curl 'https://edge.erpc.global/monad?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
وإليك الطلب نفسه مع إرسال مفتاح API في ترويسة Authorization.
bash
curl 'https://edge.erpc.global/monad' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard

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

يُدعم إرسال دفعات JSON-RPC تضم ما بين 1 و100 استدعاء لكل طلب HTTP. يجب أن يكون لكل استدعاء id خاص به، ولا يجوز تكرار قيم id داخل الدفعة الواحدة. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل. يمكن أن يصل حجم جسم الطلب إلى 1 MiB.

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

يُقاس الاستخدام بالرموز، وقد يختلف معدل الرموز باختلاف الطريقة. يُقاس كل استدعاء في الطلب المجمّع عبر HTTP بشكل منفصل.

حدود خطة Free

في خطة Free، يمكن لحسابك إرسال طلب واحد كل 10 ثوانٍ. يُحتسب هذا الحد لكل حساب وليس لكل نقطة نهاية، لذا قد يُحتسب ضمنه أيضًا طلب موجَّه إلى سلسلة أخرى. يُقابَل الطلب المُرسَل قبل ذلك باستجابة HTTP 429، وتحدد ترويسة retry-after مدة الانتظار بالثواني.
في خطة Free، يُقابَل أي طلب يحتوي على استدعاءين أو أكثر من استدعاءات JSON-RPC باستجابة HTTP 429، ولا يُرسَل أي من استدعاءاته: يتلقى كل استدعاء خطأ JSON-RPC بالرمز -32041. أرسل هذه الاستدعاءات واحدًا تلو الآخر بدلًا من ذلك.

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

تخدم نقطة النهاية الطرق التالية وعددها 34، مجمّعةً حسب مساحة الاسم.
  • web3_* (2): web3_clientVersion، web3_sha3
  • txpool_* (3): txpool_content، txpool_inspect، txpool_status
  • eth_* (24): eth_blockNumber، eth_call، eth_chainId، eth_estimateGas، eth_feeHistory، eth_gasPrice، eth_getBalance، eth_getBlockByHash، eth_getBlockByNumber، eth_getBlockReceipts، eth_getBlockTransactionCountByHash، eth_getBlockTransactionCountByNumber، eth_getCode، eth_getLogs، eth_getProof، eth_getStorageAt، eth_getTransactionByBlockHashAndIndex، eth_getTransactionByBlockNumberAndIndex، eth_getTransactionByHash، eth_getTransactionCount، eth_getTransactionReceipt، eth_maxPriorityFeePerGas، eth_sendRawTransaction، eth_syncing
  • debug_* (4): debug_traceBlockByHash، debug_traceBlockByNumber، debug_traceCall، debug_traceTransaction
  • net_* (1): net_version
تُقابَل أي طريقة أو مسار غير مدرج في القائمة باستجابة HTTP 400.

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

HTTP statusالمعنى
200استجابة JSON-RPC من upstream. ويُعاد خطأ JSON-RPC أيضًا مع HTTP 200: يحتفظ بقيمتي id الطلب وerror.code، وتكون قيمة error.message هي ERPC upstream error، ولا يُعاد error.data.
400طريقة أو مسار خارج قائمة الطرق المدعومة، أو طلب JSON-RPC غير صالح، أو دفعة فارغة أو دفعة تتجاوز 100 استدعاء، أو id مكرر داخل دفعة، أو جسم طلب يتجاوز 1 MiB.
401مفتاح API مفقود أو غير صالح، أو عدم استيفاء قيد IP أو Origin المفروض على المفتاح.
405طريقة طلب HTTP غير POST.
426طُلب WebSocket Upgrade. تعمل نقطة النهاية عبر HTTP فقط.
429تقييد المعدل، بما في ذلك حدود خطة Free الواردة أعلاه: أكثر من طلب واحد كل 10 ثوانٍ، أو استدعاءان أو أكثر في طلب واحد. إذا وُجدت ترويسة retry-after، فانتظر عدد الثواني المحدد فيها.
502تعذّر إكمال طلب upstream: فشل استجابة upstream، أو استجابة تتجاوز 8 MiB، أو عدم ورود رد خلال 30 ثانية.
503الخدمة غير متاحة مؤقتًا.

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

للقائمة الكاملة بالطرق القياسية والمعاملات والمواصفات، يُرجى الرجوع إلى الوثائق الرسمية.
https://docs.monad.xyz/reference/json-rpc/overview

السابق

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

التالي

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