مكتبة JavaScript/TypeScript للتفاعل مع XRP Ledger
هذه هي المكتبة الموصى بها لدمج تطبيق JavaScript/TypeScript مع XRP Ledger، خاصة إذا كنت تنوي استخدام وظائف متقدمة مثل سندات الدين، ومسارات الدفع، والتبادل اللامركزي، وإعدادات الحساب، وقنوات الدفع، والضمانات، والتوقيع المتعدد، والمزيد .
راجع الوثائق المرجعية الكاملة لجميع الفئات والأساليب والأدوات المساعدة.
إدارة المفاتيح وإنشاء بيانات اعتماد الاختبار ( Wallet
&& Client.fundWallet()
)
إرسال المعاملات إلى دفتر حسابات XRP ( Client.submit(...)
وأنواع المعاملات)
إرسال طلبات لمراقبة دفتر الأستاذ ( Client.request(...)
باستخدام أساليب API العامة)
الاشتراك في التغييرات في دفتر الأستاذ (مثل دفتر الأستاذ والمعاملات والمزيد ...)
تحليل بيانات دفتر الأستاذ إلى تنسيقات أكثر ملاءمة ( xrpToDrops
و rippleTimeToISOTime
)
تعمل جميعها في Node.js (تم اختبارها للإصدار 18+) ومتصفحات الويب (تم اختبارها لـ Chrome).
يوصى باستخدام Node.js v18 . نحن ندعم أيضًا الإصدار 20. قد تعمل الإصدارات الأخرى ولكن لا يتم اختبارها بشكل متكرر.
في مشروع موجود (مع package.json)، قم بتثبيت xrpl.js باستخدام:
$ npm install --save xrpl
أو مع yarn
:
$ yarn add xrpl
مثال على الاستخدام:
const xrpl = require("xrpl");وظيفة غير متزامنة main() { const client = new xrpl.Client("wss://s.altnet.rippletest.net:51233"); انتظر Client.connect(); استجابة ثابتة = انتظار العميل. الطلب ({command: "account_info"، الحساب: "rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"، ledger_index: "تم التحقق من صحته"، }); console.log(response); في انتظار Client.disconnect();}main();
للحصول على مثال أكثر تفصيلاً، يمكنك نسخ/تفرع قالب Code Sandbox هذا!
https://codesandbox.io/s/xrpl-intro-pxgdjr?file=/src/App.js
يمر عبر:
إنشاء حساب تجريبي جديد
إرسال معاملة الدفع
وإرسال طلبات لمعرفة رصيد حسابك!
إذا كنت تستخدم xrpl.js مع React أو Deno، فستحتاج إلى القيام ببعض الخطوات الإضافية لإعداده:
استخدام xrpl.js مع CDN
استخدام xrpl.js مع create-react-app
استخدام xrpl.js مع React Native
استخدام xrpl.js مع Vite React
استخدام xrpl.js مع Deno
أثناء التطوير باستخدام xrpl.js، هناك موقعان ستستخدمهما على نطاق واسع:
xrpl.org هو المصدر الأساسي لـ:
كيف يعمل دفتر الأستاذ (راجع المفاهيم)
ما هي أنواع المعاملات الموجودة (أنواع المعاملات)
الطلبات التي يمكنك إرسالها (طرق API العامة)
برامج تعليمية للتفاعل مع الميزات المختلفة لدفتر الأستاذ (برامج تعليمية)
يحتوي js.xrpl.org على المستندات المرجعية لهذه المكتبة
إذا كنت تريد أن تعرف متى نصدر إصدارات جديدة من xrpl.js، يمكنك الانضمام إلى قائمتنا البريدية ذات الزيارات المنخفضة (حوالي بريد إلكتروني واحد في الأسبوع):
اشترك في إعلان xrpl
إذا كنت تستخدم XRP Ledger في الإنتاج، فيجب عليك تشغيل خادم مموج والاشتراك في القائمة البريدية لخادم ripple أيضًا.
اشترك في خادم تموج
واحدة من أفضل المواقع لطلب المساعدة هي في XRPL Developer Discord - هناك قناة لـ xrpl.js حيث يمكن لأعضاء المجتمع الآخرين مساعدتك في معرفة كيفية تحقيق أهدافك.
نرحب أيضًا بإنشاء مشكلة هنا وسنبذل قصارى جهدنا للرد عليها خلال 3 أيام.
xrpl.js المستندات المرجعية
xrpl.org (مستندات تفصيلية حول كيفية عمل XRPL)
عينات كود XRPL
#javascript في Discord Developer XRPL للأسئلة والدعم
xrpl-announce (القائمة البريدية لإصدارات xrpl.js الجديدة)
التطبيقات التي تستخدم xrpl.js (يمكنك فتح PR لإضافة مشروعك!)