ارسال معامله قابل اعتماد

موسسات مالی و سایر خدمات با استفاده از دفترچه XRP باید از بهترین شیوه های توصیف شده در اینجا استفاده کنند تا اطمینان حاصل شود که معاملات به روشی قابل اثبات و سریع رد می شوند. شما باید معاملات را به سرورهای معتبر معتبر ارسال کنید.

بهترین شیوه های مفصل در این سند به برنامه ها اجازه می دهد تا هنگام دستیابی به معاملات به دفترچه XRP ارسال کنند:

1. - معاملات باید یک بار و فقط یک بار پردازش شوند ، یا اصلاً.
2. تأیید - برنامه ها می توانند نتیجه نهایی یک معامله را تعیین کنند.

برنامه هایی که در اجرای بهترین شیوه ها ناکام هستند ، در معرض خطاهای زیر هستند:

1. ارسال معاملات که سهواً هرگز اجرا نشده اند.
2. اشتباه کردن نتایج معامله موقت برای نتایج نهایی و تغییر ناپذیر آنها.
3. عدم یافتن نتایج معتبر از معاملات که قبلاً برای دفترچه اعمال شده بود.

این نوع خطاها به طور بالقوه می تواند منجر به مشکلات جدی شود. به عنوان مثال ، برنامه ای که نتواند یک معامله پرداخت موفقیت آمیز قبلی را پیدا کند ، ممکن است به اشتباه معامله دیگری را ارسال کند و پرداخت اصلی را کپی کند. این امر بر این اهمیت تأکید می کند که برنامه ها با استفاده از تکنیک های شرح داده شده در این سند ، اقدامات خود را بر نتایج معامله معتبر پایه گذاری می کنند.

زمینه

پروتکل Ledger XRP یک دفترچه را که در تمام سرورهای موجود در شبکه به اشتراک گذاشته شده است ، فراهم می کند. از طریق فرآیند اجماع و اعتبارسنجی ، شبکه با ترتیب اعمال معاملات برای (یا حذف از آن) به عنوان (یا حذف شده) موافقت می کند.

معاملات خوب تشکیل شده ارسال شده به سرورهای Ledger Trusted XRP معمولاً در عرض چند ثانیه اعتبار یا رد می شوند. با این حال ، مواردی وجود دارد که در آن یک معامله به خوبی شکل گرفته است و نه این مسئله را به سرعت رد می کند. در صورت افزایش هزینه معاملات جهانی پس از ارسال یک معامله ، یک مورد خاص ممکن است رخ دهد. اگر هزینه معامله بالاتر از آنچه در معامله مشخص شده است افزایش یابد ، معامله در دفترچه معتبر بعدی گنجانده نشده است. اگر در تاریخ بعدی هزینه معاملات جهانی کاهش یابد ، معامله می تواند در یک دفترچه بعدی گنجانده شود. اگر معامله انقضاء را مشخص نکند ، هیچ محدودیتی در این مورد وجود ندارد که بعداً این اتفاق بیفتد.

اگر برق یا قطع شبکه رخ دهد ، برنامه ها با چالش های بیشتری با یافتن وضعیت معاملات ارسال شده روبرو هستند. برنامه ها باید برای ارائه صحیح معامله و بعداً برای به دست آوردن نتایج معتبر ، مراقبت کنند.

جدول زمانی معامله

هنگامی که معامله ای را به دفترچه XRP ارسال می کنید ، صرف نظر از اینکه از HTTP API ، کتابخانه مشتری یا برخی از برنامه های دیگر استفاده کرده اید ، روند اعمال معامله در دفترچه یکسان است. این روند به این صورت پیش می رود:

1. یک صاحب حساب معامله را ایجاد و امضا می کند.
2. مالک معامله را به عنوان معامله نامزد به شبکه ارسال می کند.
   • معاملات ناهنجار یا مزخرف بلافاصله رد می شود.
   • معاملات خوب شکل یافته ممکن است به طور موقت موفق شوند ، سپس بعداً شکست بخورند.
   • معاملات خوب شکل یافته ممکن است به طور موقت شکست بخورد ، سپس بعداً موفق شوید.
   • معاملات خوب شکل یافته ممکن است به طور موقت موفق شوند و سپس بعداً به روشی کمی متفاوت موفق شوند.(به عنوان مثال ، نرخ ارز هنگام معاملات ارز ممکن است متفاوت باشد.)
3. از طریق اجماع و اعتبار سنجی ، معامله برای دفترچه اعمال می شود. حتی برخی از معاملات ناموفق نیز اعمال می شود ، تا هزینه ای را برای انتشار از طریق شبکه اعمال کند.
4. دفترچه معتبر شامل معامله است و تأثیرات آن در وضعیت دفترچه منعکس می شود.
   • نتایج معامله دیگر موقت نیست ، موفقیت یا عدم موفقیت در حال حاضر نهایی و تغییر ناپذیر است.

توجه: یک کد وضعیت موفقیت آمیز که از یک روش ارسال برگشته است نشان می دهد که سرور معامله نامزد را دریافت کرده است. معامله ممکن است یا ممکن است برای یک دفترچه معتبر اعمال نشود.

API ها ممکن است نتایج موقت را بر اساس نتیجه اعمال معاملات نامزد به دفترچه فعلی و در حال پیشرفت بازگردانند. برنامه های کاربردی نباید این موارد را با نتایج نهایی ، تغییر ناپذیر و یک معامله اشتباه بگیرند. نتایج تغییر ناپذیر فقط در دفترچه های معتبر یافت می شود. برنامه ها ممکن است نیاز به پرس و جو از وضعیت یک معامله به طور مکرر داشته باشند ، تا زمانی که دفترچه حاوی نتایج معامله باشد.

در حین استفاده از معاملات ، سرورهای موج دار از آخرین دفترچه معتبر استفاده می کنند ، عکس فوری از دولت لجر بر اساس معاملات که کل شبکه تأیید کرده است. فرایند اجماع و اعتبار سنجی مجموعه ای از معاملات جدید را به آخرین دفترچه معتبر به ترتیب متعارف اعمال می کند و در نتیجه یک دفترچه معتبر جدید ایجاد می شود. این نسخه جدید معتبر Ledger و نسخه هایی که پیش از آن بودند ، تاریخچه دفترچه را تشکیل می دهند.

هر نسخه Ledger معتبر دارای شاخص Ledger است که 1 بیشتر از فهرست دفترچه نسخه قبلی Ledger است. هر دفترچه همچنین دارای یک مقدار هش مشخص است که از محتوای آن منحصر به فرد تعیین می شود. ممکن است نسخه های مختلف بسیاری از دفترچه های در حال پیشرفت وجود داشته باشد ، که دارای همان فهرست دفترچه هستند اما مقادیر هش متفاوت دارند. فقط یک نسخه می تواند تأیید شود.

هر دفترچه معتبر دارای یک سفارش متعارف است که در آن معاملات اعمال می شود. این سفارش بر اساس مجموعه معاملات نهایی دفترچه تعیین کننده است. در مقابل ، با دریافت معاملات ، دفترچه راهنمای در حال پیشرفت هر سرور به صورت تدریجی محاسبه می شود. ترتیب انجام معاملات به طور موقت معمولاً همان ترتیب انجام معاملات برای ساخت یک دفترچه معتبر جدید نیست. این یکی از دلایلی است که نتیجه موقت یک معامله ممکن است متفاوت از نتیجه نهایی باشد. به عنوان مثال ، پرداخت بسته به اینکه آیا قبل یا پس از پرداخت دیگری که همان پیشنهاد را مصرف می کند ، می تواند نرخ ارز نهایی متفاوتی را بدست آورد.

لام الزام

LastledgerseQuence یک پارامتر اختیاری از کلیه معاملات است. این به Ledger XRP دستور می دهد که یک معامله باید در یک نسخه Ledger خاص یا قبل از آن تأیید شود. Ledger XRP هرگز معامله ای را در نسخه دفترچه ای که شاخص دفترچه آن بالاتر از پارامتر LastengerSequence معامله است ، شامل نمی شود.

برای جلوگیری از موارد نامطلوب که یک معامله به سرعت تأیید نشده است ، از پارامتر LastengerSequence استفاده کنید. شما باید پارامتر LastengerSequence را در هر معامله مشخص کنید. فرآیندهای خودکار باید از مقدار 4 بیشتر از آخرین شاخص Ledger معتبر استفاده کنند تا اطمینان حاصل شود که یک معامله به روشی قابل پیش بینی و سریع رد می شود.

برنامه های کاربردی با استفاده از API های HTTP / WebSocket باید هنگام ارسال معاملات ، یک LasterledgerSequence را صریحاً مشخص کنند. برخی از کتابخانه های مشتری همچنین می توانند یک ارزش معقول را برای LastengerSequence پر کنند. جزئیات توسط کتابخانه متفاوت است.

بهترین روشها

نمودار زیر جریان توصیه شده برای ارسال معامله و تعیین نتیجه آن را خلاصه می کند: