URI بیت‌کوین BIP21

نام‌های دیگر: URI به شکل bitcoin:, URI پرداخت بیت‌کوین, BIP 21

تعریف

URI بیت‌کوین BIP21 پیوندی است که با bitcoin: شروع می‌شود و نشانی بیت‌کوین به‌علاوه مبلغ، برچسب و پیام اختیاری دارد، و در کدهای QR استفاده می‌شود تا کیف پول‌ها بتوانند پرداخت را از پیش پر کنند.

BIP21 چه چیزی تعریف می‌کند

BIP21 پیشنهاد بهبود بیت‌کوین است که نیلس اشنایدر و مت کورالو در سال ۲۰۱۲ نوشتند و طرح URI برای پرداخت‌های بیت‌کوین را تعریف می‌کند. URI با bitcoin: شروع می‌شود و پس از آن نشانی گیرنده و پارامترهای پرس‌وجوی اختیاری می‌آید. وقتی کیف پول کد QR حاوی چنین URI‌ای را اسکن می‌کند، صفحه ارسال را با نشانی و مبلغ از پیش پرشده باز می‌کند.

مبلغ به بیت‌کوین به‌صورت عدد اعشاری نوشته می‌شود، نه به واحدهای کوچک‌تر. مثلاً bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 مبلغ 0.001 BTC را می‌خواهد. مقادیر متنی label و message درصدگذاری می‌شوند.

  • amount: مبلغ درخواستی به BTC، به‌صورت اعشاری
  • label: نامی برای گیرنده
  • message: یادداشتی که پرداخت را توصیف می‌کند
  • پارامترهای با پیشوند req- را باید کیف پول بفهمد، وگرنه باید URI را رد کند

استفاده از BIP21 در کدهای QR

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

پیش از ارسال همیشه نشانی نمایش‌داده‌شده در کیف پول را بررسی کنید. تراکنش‌های بیت‌کوین برگشت‌پذیر نیستند و کدی که روی کد اصلی گذاشته شود می‌تواند وجه را به دیگری بفرستد.

پرسش‌های متداول

مبلغ در کد QR بیت‌کوین به چه واحدی است؟

در URI با BIP21 پارامتر amount به بیت‌کوین (BTC) و به‌صورت اعشاری است، مثلاً amount=0.001.

فقط نشانی بیت‌کوین برای کد QR کافی است؟

نشانی تنها در بیشتر کیف پول‌ها جواب می‌دهد، ولی URI به شکل bitcoin: می‌تواند مبلغ و یادداشت را هم حمل کند و نشان می‌دهد کد درخواست پرداخت است.

منابع و استانداردها

همه اصطلاحات