وثائق نقطة نهاية Base RPC | ERPC
وثائق نقطة نهاية Base RPC
استخدم ERPC كنقطة نهاية Base RPC الخاصة بك لطلبات HTTP JSON-RPC واشتراكات WebSocket. يُعد Base RPC جزءًا من RPC APIs الخاصة بـERPC ضمن Global Edge Blockchain Infrastructure لدينا، ويمكن إدارة مفتاح API من ERPC Web Dashboard.
يمكنك استخدام نفس مفتاح RPC الذي تستخدمه مع Solana وEthereum وAvalanche.
يُرجى إضافة مفتاح API الخاص بك إلى المعامل
api-key.نقاط النهاية
أرسل طلبات JSON-RPC 2.0 كطلبات HTTP POST إلى:
text
https://base.erpc.global?api-key=<YOUR_API_KEY>https://base.erpc.global?api-key=<YOUR_API_KEY>للاشتراكات، اتصل عبر WebSocket بـ:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>wss://base.erpc.global?api-key=<YOUR_API_KEY>تُقبل الطلبات على المسار
/ فقط.أمثلة
إليك مثالًا على طلب HTTP.
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard
الطلبات المجمّعة
يُدعم إرسال دفعات JSON-RPC تضم ما يصل إلى 256 استدعاء لكل طلب HTTP. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل.
قياس الاستخدام
يُقاس الاستخدام بالرموز لكل استدعاء JSON-RPC. يُقاس كل إدخال في الطلب المجمّع عبر HTTP وكل استدعاء JSON-RPC يُرسَل عبر اتصال WebSocket بشكل منفصل.
حدود خطة Free
في خطة Free، يمكن لحسابك إرسال طلب واحد كل 10 ثوانٍ. يُحتسب هذا الحد لكل حساب وليس لكل نقطة نهاية، لذا قد يُحتسب ضمنه أيضًا طلب موجَّه إلى سلسلة أخرى. يُقابَل الطلب المُرسَل قبل ذلك باستجابة HTTP
429، وتحدد ترويسة retry-after مدة الانتظار بالثواني.في خطة Free، يُقابَل أي طلب يحتوي على استدعاءين أو أكثر من استدعاءات JSON-RPC باستجابة HTTP
429، ولا يُرسَل أي من استدعاءاته: يتلقى كل استدعاء خطأ JSON-RPC بالرمز -32041. أرسل هذه الاستدعاءات واحدًا تلو الآخر بدلًا من ذلك.في خطة Free، اتصالات WebSocket غير متاحة وتُقابَل باستجابة HTTP
403.الطرق المدعومة
تتوافق Base مع EVM وتستخدم نفس طرق JSON-RPC التي تستخدمها Ethereum. ولا يطبّق ERPC قائمة سماح ثابتة للطرق على نقطة نهاية Base. للاطلاع على عائلات طرق Ethereum، راجع وثائق نقطة نهاية Ethereum RPC.
رموز حالة الاستجابة
| HTTP status | المعنى |
|---|---|
| 200 | استجابة JSON-RPC من upstream. |
| 400 | Missing API key أو Invalid JSON-RPC request أو JSON-RPC batch exceeds 256 calls. |
| 401 | Unauthorized API KEY. |
| 403 | اتصال WebSocket في خطة Free. |
| 404 | أي مسار غير /. |
| 429 | تقييد المعدل، بما في ذلك حدود خطة Free الواردة أعلاه: أكثر من طلب واحد كل 10 ثوانٍ، أو استدعاءان أو أكثر في طلب واحد. توضّح ترويسة retry-after مدة الانتظار بالثواني. |
| 502 | تعذّر إكمال طلب RPC upstream. |
| 503 | الخدمة غير متاحة مؤقتًا. |
تستخدم اتصالات WebSocket الرمز
101 (تم قبول ترقية البروتوكول) بالإضافة إلى الرموز أعلاه.طرق Base RPC والوثائق
للقائمة الكاملة بالطرق القياسية والمعاملات والمواصفات، يُرجى الرجوع إلى الوثائق الرسمية.