تطوير التطبيقات
يجب على تطبيقات Iroha أن تجعل سلوك المعاملة صريحًا ، والاحتفاظ بحالة التوقيع المحتوى ، واستخدام الاستفسارات والأحداث بطرق سهلة الملاحظة في الإنتاج.
إعداد العميل
- تخزين تكوين العميل خارج رمز المصدر للتطبيق. تحميل سلسلة ID، Torii URL، حساب التوقيع، وإعدادات المعاملات من إعدادات محددة للبيئة.
- حافظ على ملفات
client.tomlمنفصلة للشبكات المحلية، Taira، Minamoto، والخاصة. لا ينبغي أن يصبح مؤشر شبكة الاختبار المنسخ أبداً مؤشر الشبكة الرئيسية. - حدد مدة حياة المعاملات وتوقيت الحالة عمداً. يمكن أن تنتهي مدة الحياة القصيرة جداً تحت اضطراب الشبكة الطبيعي، في حين أن تلك الطويلة جداً قد تجعل من الصعب التفكير في إرسال المثليين.
- استخدم
nonce = trueفقط عندما يجب أن تكون المعاملات المتكررة لها حشيشات متميزة. بالنسبة لعمليات الأعمال غير المحتملة، تخزين وإعادة استخدام طلب التطبيق ID بحيث يمكن تتبع المحاولات القادمة.
انظر تهيئة العميل للحقول الحالية TOML.
المعاملات
- إنشاء المعاملات من تعليمات SDK المطبوعة حيثما أمكن بدلاً من JSON الخام أو الحمولات المفيدة التي يتم تجميعها بالسلسلة.
- يكتب Preflight مهم مع استفسارات القراءة فقط: وجود الحساب، رصيد الأصول، حالة الإذن، توافر أصول الرسوم، وحالة الكائن المستهدف.
- قم بتسجيل هاشة المعاملة وحساب السلطة وموجز التعليمات وتغيير الحالة المتوقع قبل الإرسال.
- معالجة
Rejected،Expired، وتنتائج الموعد الزمني مختلفة. يعني الموعد النهائي أن العميل لم يلاحظ حالة نهائية؛ فإنه لا يثبت أن الشبكة تجاهلت المعاملة. - بعد كتابة ناجحة، التحقق من الحالة الناتجة مع استفسار أو نقطة تفتيش حدث تتطابق مع عملية الأعمال.
لميكانيكا المعاملات، انظر معاملات .
الأسئلة والأحداث
- استخدم استفسارات الحالة الحالية وتدفقات الأحداث لإخطارات التغيير. تجنب استبدال التعامل مع الأحداث باستخدام استفسارات واسعة المتكررة.
- قم بتصفح استفسارات متكررة واسعة النطاق مثل قائمة الحسابات والأصول والبلوك.
- يفضل المرشحات الضيقة لعمليات الاشتراك والتحفيز. المرشيحات الواسعة مفيدة للتشخيص ولكنها يمكن أن تضيف تنفيذ غير ضروري ومعالجة جانب العميل.
- حافظ على فحص الدخان القراءة فقط منفصلًا عن اختبارات المعاملات الموقعة حتى يكون من الأسهل تشخيص توافر نقطة النهاية.
انظر الاستفسارات، الأحداث، و مصفحات .
التنمية بمساعدة الوكيل
- دع العملاء يفتشون الوثائق، SDK رمز، وحالة الشبكة القراءة فقط قبل أن تطلب منهم كتابة رمز المعاملة.
- الحفاظ على اختبارات الشبكة المباشرة الاختيار خلف علامة بيئة مثل
TAIRA_LIVE=1. - لا تضع المفاتيح الخاصة أو مواد استرداد الحسابات أو رموز API ، أو عناوين المؤلفين المتبعتة في الطلبات.
- تطلب خطة المعاملات قبل أن يقوم أي وكيل بإرسال معاملة عبر شبكة الاختبار المباشرة. يجب أن يذكر الخطة الشبكة والسلطة والتعليمات وأصول الرسوم وقراءات ما قبل الرحلة والنتيجة المتوقعة وسلوك الإعادة المحاولة.
من أجل Taira MCP سير العمل، انظر بناء على SORA 3: Taira و Minamoto.