URI bitcoin за BIP21

Також відомо як: URI bitcoin:, платіжний URI Bitcoin, BIP 21, BIP21 bitcoin URI

Визначення

URI bitcoin за BIP21 це посилання, що починається з bitcoin: і містить адресу біткойна та необов'язкові суму, мітку й повідомлення. Його використовують у QR-кодах, щоб гаманці могли заповнити платіж.

Що визначає BIP21

BIP21 це пропозиція покращення Bitcoin (Bitcoin Improvement Proposal), написана в 2012 році Нільсом Шнайдером і Меттом Коралло, що визначає схему 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, і не кожен гаманець їх читає.

Завжди перевіряйте адресу, показану в гаманці, перед надсиланням. Транзакції Bitcoin не можна скасувати, а код, розміщений поверх справжнього, може надіслати кошти комусь іншому.

Поширені запитання

В яких одиницях сума в QR-коді біткойна?

В URI за BIP21 параметр amount виражається в біткойнах (BTC) як десяткове число, наприклад amount=0.001.

Чи достатньо однієї адреси біткойна для QR-коду?

Проста адреса працює в більшості гаманців, але URI bitcoin: може також нести суму та примітку і сигналізує, що код це запит на платіж.

Джерела та стандарти

Усі терміни