Wat BIP21 definieert
BIP21 is een Bitcoin Improvement Proposal, in 2012 geschreven door Nils Schneider en Matt Corallo, die een URI-schema voor bitcoinbetalingen definieert. De URI begint met bitcoin:, gevolgd door het ontvangende adres en optionele queryparameters. Als een wallet een QR-code scant die zo’n URI bevat, opent hij een verzendscherm met het adres en bedrag al ingevuld.
Het bedrag wordt in bitcoin als decimaal getal geschreven, niet in kleinere eenheden. bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 vraagt bijvoorbeeld om 0,001 BTC. Tekstwaarden in label en message worden met procentcodering geschreven.
- amount: gevraagd bedrag in BTC, als decimaal getal
- label: een naam voor de ontvanger
- message: een notitie die de betaling beschrijft
- Parameters met het voorvoegsel req- moeten door de wallet worden begrepen, anders moet hij de URI weigeren
BIP21 gebruiken in QR-codes
Een QR-code kan een kaal adres of een volledige BIP21-URI bevatten. De URI is nuttiger voor betalingen omdat hij het bedrag en het schema bevat, zodat de telefoon weet dat hij een wallet moet openen. Sommige wallets voegen ook extra parameters toe, zoals een lightning-factuur, die afspraken zijn en geen onderdeel van de oorspronkelijke BIP21-tekst, en niet elke wallet leest ze.
Controleer altijd het adres dat in de wallet wordt getoond voordat je verstuurt. Bitcointransacties kunnen niet worden teruggedraaid, en een code die over een echte is geplakt kan geld naar iemand anders sturen.