قالبهای ارز

Ledger XRP دارای دو نوع دارایی دیجیتال است: XRP و نشانه ها. هر دو نوع از دقت بالایی برخوردار هستند ، اگرچه قالب های آنها متفاوت است.

مقایسه

جدول زیر برخی از تفاوت های بین XRP و نشانه ها در Ledger XRP را خلاصه می کند:

برای اطلاعات بیشتر ، به XRP و نشانه ها مراجعه کنید.

تعیین مبالغ ارز

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

مقدار XRP

برای مشخص کردن مقدار XRP ، از یک شماره رشته استفاده کنید که قطره XRP را نشان می دهد ، جایی که هر قطره برابر با 0. 000001 XRP است. به عنوان مثال ، برای مشخص کردن 13. 1 XRP:

XRP را به عنوان یک شیء مشخص نکنید.

مقدار XRP نمی تواند منفی باشد.

مقادیر توکن

برای مشخص کردن مقدار یک نشانه (قارچ) ، از یک شیء مقدار استفاده کنید. این یک شیء JSON با سه زمینه است:

احتیاط: این نام های زمینه حساس به مورد هستند.

به عنوان مثال ، به نمایندگی از 153. 75 دلار دلار آمریکا صادر شده توسط حساب R9CZA1MLK5R5AM25ARFXFMQGNWJZGNFK59 ، شما مشخص می کنید:

مشخص کردن بدون مبلغ

اگر یک نشانه را بدون مبلغ مشخص می کنید (به طور معمول برای تعیین یک کتاب سفارش در مبادله غیرمتمرکز) باید آن را به عنوان یک شیء ارز مشخص کنید ، اما قسمت ارزش را حذف کنید.

اگر XRP را بدون مبلغی مشخص می کنید (به طور معمول برای تعیین یک کتاب سفارش) ، باید آن را به عنوان یک شیء JSON با تنها یک زمینه ارز مشخص کنید. هرگز یک قسمت صادرکننده برای XRP را درج نکنید.

اعداد رشته

API های Ledger XRP به طور کلی از رشته ها استفاده می کنند ، نه شماره های بومی JSON ، برای نشان دادن مقدار عددی ارز برای XRP و نشانه ها. این امر در برابر از دست دادن دقت هنگام استفاده از تجزیه و تحلیل JSON محافظت می کند ، که ممکن است به طور خودکار سعی کند تمام شماره های JSON را در قالب نقطه شناور نشان دهد. در مقدار رشته ، اعداد به همان روشی که شماره های بومی JSON هستند سریال می شوند:

• BASE-10.
• غیر صفر
• ممکن است حاویبه عنوان یک نقطه اعشاری. به عنوان مثال ، ½ به عنوان 0. 5 نشان داده شده است.(سبک آمریکایی ، نه اروپایی)
• مقدار منفی با شخصیت شروع می شود -.
• ممکن است حاوی E یا E باشد تا نشان دهد که به قدرت 10 (نماد علمی) افزایش یافته است. به عنوان مثال ، 1. 2E5 معادل 10 × 10 5 یا 120000 است. نمایندگان منفی نیز امکان پذیر هستند.
• از شخصیت های کاما (،) استفاده نمی شود.

دقت XRP

XRP همان دقت یک عدد صحیح بدون امضا 64 بیتی را دارد که در آن هر واحد معادل 0. 000001 XRP است. از ریاضیات عدد صحیح استفاده می کند ، به طوری که هر مقدار کمتر از یک قطره کامل گرد شود.

دقت

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

هنگام ارسال مبلغ نشانه در شبکه همتا به همسالان XRP Ledger ، سرورها این مقدار را به یک مقدار باینری 64 بیتی سریال می کنند.

نکته: برای نشانه هایی که به هیچ وجه قابل تقسیم نیستند ، به نشانه های غیرقانونی (NFT) مراجعه کنید.

کدهای ارز

API HTTP / WebSocket از دو قالب کد ارز پشتیبانی می کند:

• کدهای ارز استاندارد: به عنوان یک رشته 3 کاراکتر مانند "یورو" یا "USD".
• کدهای ارز غیر استاندارد: به عنوان یک رشته شش ضلعی 160 بیتی ، مانند "015841550000000000C1F76F6ECB0BAC6000000". این غیر معمول است.

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

کدهای ارز استاندارد

قالب استاندارد برای کدهای ارز یک رشته سه کاراکتر مانند USD است. این برای استفاده با کدهای ارزی ISO 4217 در نظر گرفته شده است. قوانین زیر اعمال می شود:

• کدهای ارزی باید دقیقاً 3 کاراکتر ASCII باشد. شخصیت های زیر مجاز هستند: تمام حروف بزرگ و کوچک ، رقم ها و همچنین نمادها؟،، @ ، # ، $ ، ٪ ، ^ ، و ، * ،<,>, ( , ) , <,>، [،] ، و |بشر
• کدهای ارزی حساس به مورد هستند.
• کد ارز XRP (All-Uppercase) مجاز نیست. XRP واقعی به طور معمول از کد ارزی در پروتکل Ledger XRP استفاده نمی کند.

در سطح پروتکل ، این قالب به یک مقدار باینری 160 بیتی با شروع 0x00 سریال می شود.

کدهای ارزی غیر استاندارد

همچنین می توانید از یک رشته شش ضلعی 160 بیتی (40 کاراکتر) مانند 015841551A748AD2C1F76F6ECB0CCCD000000 به عنوان کد ارز استفاده کنید. برای جلوگیری از این امر به عنوان کد ارزی "استاندارد" ، 8 بیت اول نباید 0x00 باشد.

مستهلک: برخی از نسخه های قبلی Ripple-Lib از نوع کد ارزی "دارای علاقه" یا "کاهش دهنده" پشتیبانی می کردند. این کدها دارای 8 بیت اول 0x01 هستند. ارزهای دفع کننده / بهره و علاقه دیگر پشتیبانی نمی شوند ، اما ممکن است آنها را در داده های دفترچه پیدا کنید. برای اطلاعات بیشتر ، به Demurrage مراجعه کنید.