BIP21-Bitcoin-URI

Auch genannt: bitcoin:-URI, Bitcoin-Zahlungs-URI, BIP 21

Definition

Eine BIP21-Bitcoin-URI ist ein Link, der mit bitcoin: beginnt und eine Bitcoin-Adresse plus optional Betrag, Bezeichnung und Nachricht enthält. In QR-Codes verwendet, können Wallets damit eine Zahlung vorausfüllen.

Was BIP21 festlegt

BIP21 ist ein Bitcoin Improvement Proposal, 2012 von Nils Schneider und Matt Corallo verfasst, das ein URI-Schema für Bitcoin-Zahlungen definiert. Die URI beginnt mit bitcoin:, gefolgt von der Empfängeradresse und optionalen Query-Parametern. Scannt eine Wallet einen QR-Code mit einer solchen URI, öffnet sie einen Sendebildschirm, in dem Adresse und Betrag schon ausgefüllt sind.

Der Betrag wird in Bitcoin als Dezimalzahl geschrieben, nicht in kleineren Einheiten. Zum Beispiel fordert bitcoin:bc1q...?amount=0.001&label=Maple%20Street%20Bakery&message=Order%2042 einen Betrag von 0,001 BTC. Textwerte in label und message werden prozentkodiert.

  • amount: geforderter Betrag in BTC, als Dezimalzahl
  • label: eine Bezeichnung für den Empfänger
  • message: eine Notiz zur Zahlung
  • Parameter mit dem Präfix req- muss die Wallet verstehen, sonst sollte sie die URI ablehnen

BIP21 in QR-Codes verwenden

Ein QR-Code kann entweder eine reine Adresse oder eine vollständige BIP21-URI enthalten. Die URI ist für Zahlungen nützlicher, weil sie Betrag und Schema mitliefert und das Smartphone so weiß, dass es eine Wallet öffnen soll. Manche Wallets ergänzen zusätzliche Parameter, etwa eine Lightning-Rechnung, die Konventionen sind und nicht zum ursprünglichen BIP21-Text gehören, und nicht jede Wallet liest sie.

Prüfe vor dem Senden immer die in der Wallet angezeigte Adresse. Bitcoin-Transaktionen lassen sich nicht rückgängig machen, und ein über einen echten Code geklebter Code kann Geld an jemand anderen schicken.

Häufig gestellte Fragen

In welcher Einheit steht der Betrag in einem Bitcoin-QR-Code?

In einer BIP21-URI steht der Parameter amount in Bitcoin (BTC) als Dezimalzahl, zum Beispiel amount=0.001.

Reicht eine Bitcoin-Adresse allein für einen QR-Code?

Eine reine Adresse funktioniert in den meisten Wallets, aber eine bitcoin:-URI kann auch Betrag und Notiz tragen und zeigt an, dass der Code eine Zahlungsaufforderung ist.

Quellen und Normen

Alle Begriffe