Verschlüsselte Memos bei Blocknet-Zahlungen

Jede Blocknet-Zahlung kann eine kurze verschlüsselte Notiz mitführen. Du kannst sie für eine Rechnungsnummer, eine Bestellreferenz oder eine Nachricht an die Person nutzen, die du bezahlst, und nur ihr beide könnt sie lesen. Diese Anleitung zeigt, wie du beim Senden von BNT ein Memo hinzufügst, wer es lesen kann, warum Memos auf der Chain nie auffallen und wo du die Memos findest, die du empfängst.

Was ist ein Blocknet-Memo?

Ein Blocknet-Memo ist ein verschlüsseltes Feld von 128 Byte, das an jedem Transaktions-Output hängt. Es fasst bis zu 124 Byte deines eigenen Textes oder deiner Daten, etwa eine Rechnungsnummer oder eine kurze Notiz. Es wird mit einem Geheimnis verschlüsselt, das nur Sender und Empfänger teilen, und so aufgefüllt, dass ein leeres Memo wie ein volles aussieht.

Das Memo ist Teil des Transaktionsformats selbst. Jeder Output auf der Chain hat eines, auch Wechselgeld-Outputs, die Coins an deine eigene Wallet zurückgeben. Daraus ergeben sich drei nützliche Eigenschaften:

• Standardmäßig privat. Der Inhalt wird für den Empfänger dieses Outputs verschlüsselt. Niemand sonst sieht, was du geschrieben hast.
• Feste Größe. Das Feld ist auf der Chain immer 128 Byte groß, egal was du hineinschreibst.
• Immer vorhanden. Da jeder Output ein Memo trägt, sieht eine Zahlung mit Notiz genau so aus wie eine Zahlung ohne.

Was kannst du in ein Memo schreiben?

Alles, was in 124 Byte passt. Klartext wird als UTF-8 gespeichert, im Englischen sind das also 124 Buchstaben, Ziffern und Leerzeichen. Zeichen außerhalb des lateinischen Alphabets belegen mehr Byte: Ein chinesisches Schriftzeichen braucht drei, ein Memo fasst also etwa 41 davon.

Übliche Anwendungen:

• Rechnungen. Schreib die Rechnungsnummer ins Memo, und wer die Zahlung empfängt, kann sie ohne Nachfrage der richtigen Rechnung zuordnen.
• Bestellnummern. Ein Shop oder Dienst kann Kunden bitten, eine Bestellreferenz anzugeben, und sie direkt aus der eingehenden Zahlung lesen.
• Notizen. „Miete für November“, „Danke für die Hilfe“ oder „Anteil fürs Abendessen“ reisen mit den Coins.
• Binärdaten. Die Wallet akzeptiert auch rohe Bytes in Hex-Schreibweise, für Referenzcodes, die Software erzeugt und liest.

Wie fügst du beim Senden von BNT ein Memo hinzu?

Der Befehl send der Wallet nimmt das Memo als optionales letztes Argument:

send <address> <amount> [memo|hex:<memo_hex>]

Ein Memo darf Leerzeichen enthalten, und Anführungszeichen darum sind optional. Die Wallet entfernt ein passendes Paar Anführungszeichen, bevor sie den Text verschlüsselt. Hier eine Zahlung an einen Blocknet-ID-Namen mit Rechnungsnummer:

> send @rock 100 "invoice 1042"
  Resolved @rock -> <address> ✓ verified

# Send
  Building transaction...

  Send 100 BNT to @rock?
  Fee:     <fee>
  Address: <address>
  Memo:    "invoice 1042"
  Confirm [y/N]: y

Der Bestätigungsschritt zeigt das Memo, das der Empfänger lesen wird, sodass du es prüfen kannst, bevor etwas gesendet wird. Ist ein Memo länger als 124 Byte, bricht die Wallet noch vor dem Erstellen der Transaktion mit memo too long: max 124 bytes ab, und du kannst es kürzen und es noch einmal versuchen.

Um rohe Bytes zu senden, stellst du dem Memo hex: voran. Die Wallet dekodiert das Hex und verschlüsselt die Bytes:

send @rock 100 hex:494e562d31303432

Auch Zahlungslinks können ein Memo enthalten. Wenn du einen blocknet://-Link oder einen bntpay.com-Link in die Wallet einfügst, füllt sie Adresse, Betrag und Memo aus, damit du nur noch bestätigst. So kann die Person, die du bezahlst, die Rechnungsreferenz im Voraus festlegen. Mehr über Namen und Links erfährst du in der Blocknet-ID-Anleitung.

Memos aus deiner eigenen Software

Die Wallet-API nimmt für jeden Empfänger einer Sendung ein Memo an. Gib in einer Anfrage an POST /api/wallet/send für jeden Empfänger entweder memo_text für Klartext oder memo_hex für rohe Bytes an:

{
  "recipients": [
    { "address": "@rock", "amount": 10000000000, "memo_text": "invoice 1042" },
    { "address": "$shop", "amount": 2500000000, "memo_hex": "4f524445522d3737" }
  ]
}

Die Beträge sind hier in atomaren Einheiten angegeben, wobei 1 BNT 100.000.000 Einheiten entspricht, das Beispiel sendet also 100 BNT und 25 BNT. Jeder Empfänger bekommt sein eigenes Memo, nur für die eigene Wallet verschlüsselt. Es gilt dasselbe Maximum von 124 Byte.

Wer kann ein Blocknet-Memo lesen?

Wenn deine Wallet eine Zahlung erstellt, kombiniert sie einen frischen, zufälligen Transaktionsschlüssel mit dem öffentlichen View Key des Empfängers zu einem gemeinsamen Geheimnis. Aus diesem Geheimnis entsteht die Einmal-Stealth-Adresse des Empfängers, und die Wallet nutzt es auch, um das Memo zu verschlüsseln. Sie hasht das Geheimnis mit SHA3-256, zusammen mit der Position des Outputs in der Transaktion und der Kennung des Netzwerks, zu einer 128-Byte-Maske und kombiniert diese Maske dann mit dem Memo. Jeder Output bekommt eine eigene Maske, zwei Memos in derselben Transaktion werden also getrennt verschlüsselt.

Die Wallet des Empfängers findet dasselbe Geheimnis von der anderen Seite aus, mit ihrem privaten View Key, während sie jeden Block durchsucht. Sie entschlüsselt das Memo und speichert es mit der Zahlung. Auf deiner Seite bewahrt die Wallet die Memos, die du geschrieben hast, in ihrem Sendeverlauf auf.

Zwei Dinge solltest du wissen:

• Auch eine View-only-Wallet zeigt Memos. Dein privater View Key liest eingehende Zahlungen, daher sieht eine daraus erstellte View-only-Wallet Betrag und Memo jeder Zahlung. Teile diesen Schlüssel nur mit Personen, die deine eingehenden Zahlungen sehen dürfen.
• Mining-Belohnungen tragen leere Memos. Der Konsens verlangt, dass das Memo jeder Blockbelohnung leer ist, sodass die Coinbase-Outputs der Chain nie als öffentlicher Nachrichtenkanal dienen können.

Warum jedes Memo auf der Chain gleich aussieht

Ein Memo, dessen Länge sichtbar wäre, würde etwas verraten. Eine Notiz mit 30 Byte sieht anders aus als eine mit 100 Byte, und ein leeres Memo würde sich von beiden abheben. Die Wallet von Blocknet schließt diese Lücke mit einem festen Aufbau und zufälligem Padding.

Vor dem Verschlüsseln packt die Wallet das Memo in einen 128-Byte-Umschlag:

Das Padding stammt aus dem kryptografischen Zufallszahlengenerator des Systems, der ungenutzte Platz ist also unvorhersehbar. Nach der Verschlüsselung sind eine kurze Notiz, eine volle Notiz und ein leeres Memo alle 128 Byte zufällig aussehender Daten. Wechselgeld-Outputs bekommen ein eigenes leeres, aufgefülltes Memo, sodass selbst die Coins, die du an dich selbst zurückschickst, nicht auffallen.

Mit der Prüfsumme kann die Wallet des Empfängers bestätigen, dass sie das Memo korrekt entschlüsselt hat, bevor sie es anzeigt. Nodes lehnen außerdem jeden Block ab, der einen Output enthält, dessen Memo-Feld nur aus Nullen besteht, sodass jeder Output auf der Chain ein korrekt gefülltes Memo trägt.

Wo du empfangene Memos findest

Die Kommandozeilen-Wallet zeigt Memos überall dort, wo sie Zahlungen auflistet:

• history listet eingehende und ausgehende Zahlungen, mit einer Zeile memo: unter jeder Zahlung, die eines enthielt.
• outputs tx <txid> zeigt jeden Output, der deiner Wallet in dieser Transaktion gehört, samt Memo. outputs <n> macht dasselbe für einen einzelnen Output aus der Liste.
• Die Wallet-API gibt das Memo jedes empfangenen Outputs als memo_hex aus GET /api/wallet/history zurück, bereit für ein Bestellsystem, das es mit Rechnungen abgleicht.

Text-Memos erscheinen in Anführungszeichen. Ein Memo, das kein druckbarer Text ist, etwa rohe Bytes, die mit hex: gesendet wurden, erscheint als Hex.

Gibt es bei einer Zahlung einmal Klärungsbedarf, kann der Sender sie nachweisen. Der Befehl prove <txid> der Wallet gibt den Transaktionsschlüssel für eine von dir gesendete Zahlung aus. Jeder mit diesem Schlüssel, der Transaktions-ID und der Adresse des Empfängers kann die Zahlung über den Endpunkt POST /api/verify-proof prüfen, ganz ohne Wallet. Er bestätigt die Transaktion und zeigt die Outputs, die diese Adresse empfangen hat, samt Beträgen und Memos.

Verdiene die BNT, die du senden wirst

Ein einfacher Weg zu deinen ersten BNT ist, sie zu minen. seine läuft auf deinem eigenen Computer, optimiert sich beim Mining selbst und zahlt über bntpool.com direkt an deine Adresse oder deinen @name aus. Mit der Mining-Anleitung läuft es in wenigen Minuten.