البدء السريع لـTRON RPC | ERPC
البدء السريع لـTRON RPC
يأخذك هذا الدليل من الصفر إلى أول استجابة TRON JSON-RPC لك مع ERPC.
1. احصل على مفتاح API الخاص بك
يمكنك الحصول على مفتاح API الخاص بك والتحقق منه في ERPC Web Dashboard: ERPC Web Dashboard
هل تستخدم ERPC بالفعل لـSolana أو Ethereum أو Avalanche؟ يمكنك استخدام نفس مفتاح RPC.
2. أرسل طلبك الأول
أرسل طلب JSON-RPC 2.0 كطلب HTTP POST إلى
/jsonrpc، مع تضمين مفتاح API الخاص بك في المعامل api-key:bash
curl 'https://edge.erpc.global/tron/jsonrpc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'curl 'https://edge.erpc.global/tron/jsonrpc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_blockNumber"
}'تُعيد الاستجابة رقم آخر كتلة بصيغة سداسية عشرية:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }في خطة Free، يمكن لحسابك إرسال طلب واحد كل 10 ثوانٍ، وقد يُحتسب ضمن هذا الحد أيضًا طلب موجَّه إلى سلسلة أخرى. انتظر 10 ثوانٍ قبل إرسال الطلب التالي.
يمكنك التحقق من السلسلة التي تخدمها نقطة النهاية باستخدام
eth_chainId:bash
curl 'https://edge.erpc.global/tron/jsonrpc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_chainId"
}'curl 'https://edge.erpc.global/tron/jsonrpc?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
"jsonrpc":"2.0","id":1,
"method":"eth_chainId"
}'يمكنك أيضًا إرسال مفتاح API الخاص بك بصيغة
Authorization: Bearer <YOUR_API_KEY>. وعند وجود الاثنين معًا، يُستخدم معامل الاستعلام.3. استدعِ TRON HTTP API
في خطة Free، يمكن لحسابك إرسال طلب واحد كل 10 ثوانٍ، وقد يُحتسب ضمن هذا الحد أيضًا طلب موجَّه إلى سلسلة أخرى. انتظر 10 ثوانٍ قبل إرسال الطلب التالي.
تُقدَّم مسارات TRON HTTP API تحت
/wallet/<name> و/walletsolidity/<name>. أرسل كائن JSON كجسم لطلب POST. يقرأ هذا المثال أحدث كتلة باستخدام كائن فارغ:bash
curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'curl 'https://edge.erpc.global/tron/wallet/getnowblock?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{}'يُحتسب كل طلب HTTP API كاستدعاء واحد. المسارات المتاحة مدرجة في وثائق نقطة نهاية TRON RPC.
4. الطلبات المجمّعة
يمكنك إرسال ما بين 1 و100 استدعاء JSON-RPC في طلب HTTP واحد إلى
/jsonrpc. يجب أن يكون لكل استدعاء id خاص به، ولا يجوز تكرار قيم id داخل الدفعة الواحدة. يُحتسب كل استدعاء ضمن الطلب المجمّع كاستدعاء مستقل. في خطة Free، أرسل استدعاءً واحدًا في كل طلب: يُقابَل الطلب الذي يحتوي على استدعاءين أو أكثر باستجابة HTTP 429.الخطوات التالية
- نقاط النهاية وقياس الاستخدام وأكواد الحالة: وثائق نقطة نهاية TRON RPC
- وثائق TRON الرسمية: https://developers.tron.network/reference/full-node-api-overview