O que o BIP21 define
O BIP21 é uma Bitcoin Improvement Proposal, escrita em 2012 por Nils Schneider e Matt Corallo, que define um esquema de URI para pagamentos em bitcoin. A URI começa com bitcoin:, seguido do endereço recebedor e de parâmetros de consulta opcionais. Quando uma carteira escaneia um QR Code que guarda uma URI dessas, ela abre uma tela de envio com o endereço e o valor já preenchidos.
O valor é escrito em bitcoin como um número decimal, não em unidades menores. Por exemplo, bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 pede 0,001 BTC. Os valores de texto em label e message são codificados em porcentagem.
- amount: valor solicitado em BTC, como decimal
- label: um nome para o destinatário
- message: uma observação que descreve o pagamento
- Os parâmetros com prefixo req- precisam ser entendidos pela carteira, ou ela deve recusar a URI
Usando o BIP21 em QR Codes
Um QR Code pode guardar apenas um endereço ou uma URI BIP21 completa. A URI é mais útil para pagamentos porque carrega o valor e o esquema, de modo que o celular sabe abrir uma carteira. Algumas carteiras também acrescentam parâmetros extras, como uma fatura lightning, que são convenções e não fazem parte do texto original do BIP21, e nem toda carteira os lê.
Sempre confira o endereço mostrado na carteira antes de enviar. As transações em bitcoin não podem ser revertidas, e um código colado sobre um verdadeiro pode enviar fundos para outra pessoa.