Co definiuje BIP21
BIP21 to Bitcoin Improvement Proposal, napisany w 2012 roku przez Nilsa Schneidera i Matta Corallo, który definiuje schemat URI dla płatności bitcoin. URI zaczyna się od bitcoin:, a po nim następują adres odbiorcy i opcjonalne parametry zapytania. Gdy portfel zeskanuje kod QR zawierający taki URI, otwiera ekran wysyłania z już wypełnionym adresem i kwotą.
Kwotę zapisuje się w bitcoinach jako liczbę dziesiętną, a nie w mniejszych jednostkach. Na przykład bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 prosi o 0,001 BTC. Wartości tekstowe w label i message są kodowane procentowo.
- amount: żądana kwota w BTC, jako liczba dziesiętna
- label: nazwa odbiorcy
- message: notatka opisująca płatność
- Parametry z przedrostkiem req- muszą być zrozumiałe dla portfela, inaczej powinien on odrzucić URI
Użycie BIP21 w kodach QR
Kod QR może zawierać sam adres albo pełny URI BIP21. URI jest przydatniejszy w płatnościach, bo niesie kwotę i schemat, więc telefon wie, że ma otworzyć portfel. Niektóre portfele dodają też dodatkowe parametry, takie jak faktura lightning, które są konwencjami, a nie częścią oryginalnego tekstu BIP21, i nie każdy portfel je odczytuje.
Zawsze sprawdź adres pokazany w portfelu przed wysłaniem. Transakcji bitcoin nie da się cofnąć, a kod naklejony na prawdziwy może skierować środki do kogoś innego.