ADAMANT v0.10.0: إعادة بناء منصة المطورين للرسائل على البلوكشين

الرسائل اللامركزية لا تُحدث فرقًا إلا إذا كان بإمكان المطورين البناء عليها فعليًا. إلى جانب ADAMANT Node v0.10.0، تم إعادة هيكلة تجربة المطور بالكامل: مواصفات واجهة برمجة تطبيقات جديدة، وثائق مُعاد كتابتها، شبكة محلية يمكنك تشغيلها خلال دقائق، وشبكة اختبار تم إعادة تشغيلها حديثًا. الهدف هو جعل التكامل مع نظام ADAMANT للرسائل على البلوكشين سريعًا، ومتوقعًا، وسلسًا — سواء كنت تبني محفظة، أو بوت، أو خدمة إشعارات، أو شيئًا جديدًا تمامًا.

مواصفات واجهة برمجة تطبيقات حديثة وتفاعلية

عقد واجهة برمجة التطبيقات موجود الآن كمواصفة نظيفة OpenAPI 3.2، تُنشر كواجهة مستخدم تفاعلية Swagger على schema.adamant.im. تم مراجعة المخطط بالكامل مقابل العقدة الحية، لذا ما تقرؤه هو بالضبط ما تُرجعه الشبكة فعليًا — الحسابات، المعاملات، الدردشات، المندوبون، الكتل، تخزين القيمة-المفتاح، ونقاط نهاية العقدة، كلها في مرجع واحد قابل للاستكشاف.

يمكن للمطورين تجربة الطلبات مباشرة من المتصفح. تأتي المواصفات مع اختيار خادم مباشر: تُرسل الواجهة إشارة إلى كل عقدة عامة، وتُظهر إصدار واجهة برمجة التطبيقات الحالي، وتختار تلقائيًا عقدة رئيسية سليمة بحيث تعمل استدعاءات “جربها” فورًا. يمكنك البحث عبر كل عملية حسب المسار، الطريقة، الاسم، أو الملخص، وبما أن مصدر الحقيقة هو مستند OpenAPI حقيقي، يمكنك إنشاء عُملاء مكتوبين الأنواع (مثل TypeScript) مباشرة منه. العميل الخاص بـ ADAMANT adamant-api-jsclient يقوم بالضبط بهذا.

رؤية أعمق لحالة العقدة

تتضمن إضافات v0.10.0 عدة حقول صغيرة ذات فوائد كبيرة من حيث سهولة الاستخدام. أصبحت المعاملات الآن تحتوي على حقل timestampMs يُوفر طوابع زمنية دقيقة بالميلي ثانية إلى جانب حقل timestamp الدقيق بالثواني. بالنسبة لتطبيق مراسلة حيث الترتيب مهم، يسمح هذا للعملاء بفرز الرسائل والتحويلات بدقة دون ثانية. يجب على العملاء تفضيل هذا الحقل عند وجوده، والعودة إلى timestamp * 1000 في الحالات الأخرى.

أصبح رد حالة العقدة الآن يعرض nodeTimestampMs وunixTimestampMs و كائن loader يُبلغ عن تقدم المزامنة (syncing، consensus، blocks، blocksCount)، بحيث يمكن للمشغلين والأدوات فهم حالة صحة العقدة ومزامنتها بنظرة واحدة. تم إضافة نقطة نهاية جديدة GET /peers/get للبحث عن عقدة محددة حسب عنوان IP والمنفذ، وهي مفيدة لبناء أدوات مراقبة الشبكة وتحليل الاتصال. أصبحت استعلامات الدردشة والمعاملات أكثر نظافة بفضل معلمات جديدة هي returnUnconfirmed وincludeDirectTransfers التي تمنح العملاء تحكمًا دقيقًا في ما يتم إرجاعه. هذه إضافات متوافقة مع الإصدارات السابقة: التكاملات الحالية تستمر في العمل، بينما تحصل الجديدة على مزيد من الإمكانيات.

وثائق يمكنك البناء منها فعليًا

واجهة برمجة التطبيقات هي فقط نصف القصة. تم إعادة كتابة الوثائق الموجودة على docs.adamant.im وتوسيعها، مع وضع علامة إصدار مرتبطة بإصدار العقدة بحيث لا تنفصل الإرشادات عن الشبكة أبدًا. تغطي المواد الجديدة والمُوسعة مواضيع التوافق والتحقق من صحة المعاملات — كيف يتم الاتفاق على الكتل وما الذي يجعل المعاملة صالحة — بالإضافة إلى المزامنة ونقطة النهاية loader/status، بحيث تفهم بالضبط ما تفعله العقدة أثناء محاولة اللحاق بالشبكة. توجد إرشادات تثبيت (بما في ذلك macOS)، التهيئة، التشغيل التلقائي، التمهيد، واستعادة العقدة لتشغيل عقدتك الخاصة، إلى جانب وثائق كاملة لمعنى timestampMs بحيث تتعامل مع الوقت بشكل صحيح من اليوم الأول.

شغّل شبكة خلال دقائق: localnet + testnet

يمكنك الآن إنشاء شبكة ADAMANT كاملة على جهازك الخاص باستخدام localnet. قم بالتطوير والاختبار على بلوكشين حقيقي دون التأثير على البنية التحتية العامة، دون انتظار التأكيدات من شبكة مشغولة، ودون إنفاق ADM حقيقي. كرر بسرعة، وأعد التهيئة بحرية. عندما تكون مستعدًا للانتقال إلى ما هو أبعد من جهاز الكمبيوتر المحمول، تم إعادة تشغيل testnet العامة حديثًا ومُحاذاة مع v0.10.0 — بيئة مشتركة وآمنة للتحقق من التكاملات مقابل ظروف شبكة حقيقية قبل النشر على mainnet. أصبح المسار من المحلي → شبكة الاختبار → الشبكة الرئيسية الآن طريقًا سلسًا ومُوثقًا جيدًا بدلًا من قفزة خطيرة.

ما يمكنك بناؤه

مع واجهة برمجة تطبيقات مكتوبة الأنواع، وشبكات قابلة للتشغيل، ووثائق حقيقية، تصبح السيناريوهات العملية متاحة بسرعة. ADAMANT هو تطبيق مراسلة لامركزي بالكامل، مشفر من طرف إلى طرف، يعمل على بلوكشين خاص به، لذا يمكن للمحافظ وتطبيقات المراسلة إرسال رسائل مشفرة وقيمة باستخدام نفس البروتوكول. يمكن لخدمات الإشعارات والتنبيهات دفع أحداث على البلوكشين (مثل المدفوعات والرسائل) إلى تطبيقاتك الخاصة. تُصبح التكاملات مع منصات التداول والصرف ممكنة من خلال التعامل البرمجي مع الحسابات، الأرصدة، والتحويلات مع ترتيب دقيق بالميلي ثانية. البوتات والأتمتة — بوتات الدردشة، بوتات الدفع، بوتات المراقبة — كلها تستخدم واجهة برمجة التطبيقات هذه، ويحتوي نظام ADAMANT البيئي بالفعل على بوتات تداول وغيرها. تكتسب الرسائل بين الآلات والأجهزة (IoT) قناة مقاومة للرقابة ومجهولة لتنسيق الأجهزة ودفع بعضها لبعض، ويصبح الاتصال المجهول بدون خوادم ممكنًا حيث لا يوجد خادم مركزي يمكن استدعاؤه أو تسريبه أو إغلاقه.

بما أن الرسائل والدفعات تشترك في بروتوكول واحد، فإن العديد من هذه السيناريوهات تتداخل: محفظة تُجري دردشة، بوت يقوم بالدفع، جهاز يُرسل رسائل ويُسوّي — كلها تعمل على نفس البنية التحتية.

المراجع

• مرجع واجهة برمجة التطبيقات: schema.adamant.im
• الوثائق: docs.adamant.im
• مصدر العقدة: github.com/Adamant-im/adamant
• العميل JS: github.com/Adamant-im/adamant-api-jsclient