Mitä BIP21 määrittelee
BIP21 on Bitcoin Improvement Proposal, jonka Nils Schneider ja Matt Corallo kirjoittivat vuonna 2012 ja joka määrittelee URI-skeeman bitcoin-maksuille. URI alkaa bitcoin: ja sen perässä on vastaanottava osoite ja valinnaiset kyselyparametrit. Kun lompakko skannaa QR-koodin, joka sisältää tällaisen URI:n, se avaa lähetysnäkymän, jossa osoite ja summa on jo täytetty.
Summa kirjoitetaan bitcoineina desimaalilukuna, ei pienemmissä yksiköissä. Esimerkiksi bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 pyytää 0,001 BTC:tä. Nimikkeen ja viestin tekstiarvot on koodattu prosenttikoodauksella.
- amount: pyydetty summa BTC:nä desimaalilukuna
- label: vastaanottajan nimi
- message: maksua kuvaava huomautus
- Etuliitteellä req- alkavat parametrit lompakon täytyy ymmärtää, tai sen pitäisi kieltäytyä URI:sta
BIP21:n käyttö QR-koodeissa
QR-koodi voi sisältää joko pelkän osoitteen tai täyden BIP21-URI:n. URI on hyödyllisempi maksuissa, koska se sisältää summan ja skeeman, joten puhelin tietää avata lompakon. Jotkin lompakot lisäävät myös lisäparametreja, kuten Lightning-laskun, jotka ovat käytäntöjä eivätkä osa alkuperäistä BIP21-tekstiä, eikä jokainen lompakko lue niitä.
Tarkista aina lompakossa näytettävä osoite ennen lähettämistä. Bitcoin-tapahtumia ei voi peruuttaa, ja oikean koodin päälle asetettu koodi voi lähettää varat jollekin toiselle.