Base58Check-Encoder und -Decoder

So kodieren und dekodieren Sie Base58Check

Zum Kodieren:

1. Fügen Sie das Hex in Eingabe · Hex ein: zuerst das Versionsbyte, dann die Nutzdaten. Leerzeichen, Doppelpunkte und 0x-Präfixe werden akzeptiert.
2. Lesen Sie das Ergebnis in Ausgabe · Base58Check. Das Tool berechnet die Prüfsumme und hängt sie vor dem Kodieren an.
3. Lassen Sie das Alphabet für Bitcoin und die meisten Forks auf Bitcoin.

Zum Dekodieren klicken Sie im Richtungsschalter auf Base58Check → Hex und fügen die Adresse oder den Schlüssel ein. Der Decoder wandelt sie um, berechnet die Prüfsumme neu und gibt die Nutzdaten (weiterhin mit dem Versionsbyte am Anfang) nur zurück, wenn alle 4 Prüfsummenbytes übereinstimmen. Ein einziges vertipptes Zeichen ergibt „Prüfsumme stimmt nicht: Die Zeichenkette ist vertippt oder beschädigt.“

Was Base58Check zu Base58 hinzufügt

Reines Base58 hat keine Fehlererkennung: Ein Tippfehler ergibt eine andere, aber ebenso gültige Zeichenkette. Base58Check behebt das mit zwei Ergänzungen:

version (1 byte) | payload | first 4 bytes of SHA-256(SHA-256(version | payload))

Das Ganze wird dann Base58-kodiert, führende Nullbytes werden also zu 1. Das Versionsbyte bestimmt das Netzwerk und die Art der Daten, und weil es vorn in der Zahl steht, legt es auch das erste Zeichen des Ergebnisses fest.

Versionsbytes und Präfixe

Derselbe 20-Byte-Hash, 62e907b15cbf27d5425399ebf6f0fb50ebb88f18, mit verschiedenen Versionsbytes:

Die erste Zeile ist die Adresse, die die Belohnung des Bitcoin-Genesis-Blocks erhalten hat. Die anderen Zeilen veranschaulichen nur das Versionsbyte: Wer einen Public-Key-Hash in ein P2SH-Versionsbyte verpackt, erhält keine nutzbare P2SH-Adresse, denn P2SH hasht ein Skript.

Private WIF-Schlüssel

Das Wallet Import Format ist Base58Check mit dem Versionsbyte 80 und einem 32-Byte-Private-Key. Ein angehängtes Byte 01 kennzeichnet einen Schlüssel, dessen Public Key in komprimierter Form verwendet wird. Mit dem bekannten Beispielschlüssel aus dem Bitcoin-Wiki:

Unkomprimierte WIF-Schlüssel beginnen mit 5, komprimierte mit K oder L. Dieser Beispielschlüssel ist öffentlich; verwenden Sie ihn nie für echtes Guthaben.

Base58Check in Python

Die Prüfsumme besteht aus zwei SHA-256-Aufrufen aus der Standardbibliothek. Mit einem kleinen Base58-Encoder:

import hashlib

ALPHABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"

def b58encode(data: bytes) -> str:
    n = int.from_bytes(data, "big")
    out = ""
    while n:
        n, r = divmod(n, 58)
        out = ALPHABET[r] + out
    zeros = len(data) - len(data.lstrip(b"\0"))
    return "1" * zeros + out

def b58check(payload: bytes) -> str:
    checksum = hashlib.sha256(hashlib.sha256(payload).digest()).digest()[:4]
    return b58encode(payload + checksum)

b58check(bytes.fromhex("0062e907b15cbf27d5425399ebf6f0fb50ebb88f18"))
# '1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa'

Um eine Zeichenkette im Code zu prüfen, dekodieren Sie sie mit Base58, trennen die letzten 4 Bytes ab und vergleichen sie mit dem doppelten Hash des Rests. Mehr zum Umgang mit Bytes in Python finden Sie auf der Python-Seite.

Häufige Probleme

• Prüfsumme stimmt nicht. Die Zeichenkette enthält einen Tippfehler, wurde abgeschnitten oder ist reines Base58 ohne Prüfsumme (Solana-Adressen und IPFS-Hashes sind reines Base58; nehmen Sie für sie den Base58-Decoder).
• „Zu kurz für die 4-Byte-Prüfsumme“. Der dekodierte Wert hat weniger als 4 Bytes und kann daher kein Base58Check sein.
• Unerwartetes Zeichen "0", "O", "I" oder "l". Gehört nicht zum Base58-Alphabet; prüfen Sie die Abschrift.
• Falsches erstes Zeichen nach dem Kodieren. Prüfen Sie das Versionsbyte. Ohne Versionsbyte ergibt ein 20-Byte-Hash meist eine Zeichenkette, die nicht mit 1 beginnt.

Häufige Fragen