Adresa Base58 pierde „1” de la început: zerourile din față
Codarea Base58 transformă bytes-ii în număr, iar un număr nu are zerouri în față, așa că octeții 0x00 de la început se pierd. Bitcoin îi păstrează explicit: fiecare octet zero de la început devine caracterul „1” în fața rezultatului.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Nu primești eroare, ci o adresă greșită, de obicei fără 1-ul de la început. Adresele Bitcoin clasice (P2PKH) încep cu octetul de versiune 0x00. Când codezi în Base58, transformi toți bytes-ii într-un număr mare (int.from_bytes) și împarți repetat la 58. Dar int.from_bytes(b"\x00\x00\x01") e pur și simplu 1, la fel ca int.from_bytes(b"\x01"): informația despre zerourile din față dispare.
De aceea Base58Check are o regulă separată: numeri câți octeți 0x00 sunt la începutul datelor și pui tot atâtea caractere 1 (primul caracter al alfabetului, adică valoarea 0) în fața rezultatului. La decodare faci invers: fiecare 1 de la început devine un octet zero. Fără regula asta, adresa nu mai poate fi decodată la bytes-ii originali, iar portofelele o resping.
De ce apare: cauzele frecvente
1Doar conversia prin număr
def b58(date):
n = int.from_bytes(date, "big")
s = ""
while n:
n, r = divmod(n, 58)
s = ALFABET[r] + s
return sdef b58(date):
n = int.from_bytes(date, "big")
s = ""
while n:
n, r = divmod(n, 58)
s = ALFABET[r] + s
zerouri = len(date) - len(date.lstrip(b"\x00"))
return "1" * zerouri + sNumeri octeții zero de la început și pui câte un „1” pentru fiecare.
2Zerourile numărate în tot textul
zerouri = date.count(0)
return "1" * zerouri + szerouri = len(date) - len(date.lstrip(b"\x00"))
return "1" * zerouri + sContează doar zerourile de la început; cele din mijloc sunt deja în număr.
Repară eroarea, direct în pagină
Funcția b58 de mai jos codează bytes în Base58, dar pierde octeții zero de la început: pentru datele care încep cu 00 nu apare „1” în față. Repară funcția după regula Bitcoin, ca programul să afișeze rezultatul pentru fiecare exemplu și Toate corecte: True.
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def b58(date):
n = int.from_bytes(date, "big")
s = ""
while n:
n, r = divmod(n, 58)
s = ALFABET[r] + s
return s
exemple = [
(bytes.fromhex("0000287fb4cd"), "11233QC4"),
(bytes.fromhex("00"), "1"),
(bytes.fromhex("626262"), "a3gV"),
]
ok = True
for date, asteptat in exemple:
rez = b58(date)
ok = ok and rez == asteptat
print(date.hex(), "->", repr(rez))
print("Toate corecte:", ok)0000287fb4cd -> '11233QC4' 00 -> '1' 626262 -> 'a3gV' Toate corecte: True
Indiciu
Numără octeții 0x00 de la început (de exemplu cu lstrip) și adaugă câte un „1” pentru fiecare.
Reparația
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def b58(date):
n = int.from_bytes(date, "big")
s = ""
while n:
n, r = divmod(n, 58)
s = ALFABET[r] + s
zerouri = len(date) - len(date.lstrip(b"\x00"))
return "1" * zerouri + s
exemple = [
(bytes.fromhex("0000287fb4cd"), "11233QC4"),
(bytes.fromhex("00"), "1"),
(bytes.fromhex("626262"), "a3gV"),
]
ok = True
for date, asteptat in exemple:
rez = b58(date)
ok = ok and rez == asteptat
print(date.hex(), "->", repr(rez))
print("Toate corecte:", ok)De ce merge
Prin int.from_bytes, datele 0000287fb4cd devin același număr ca 287fb4cd, deci cei doi octeți zero se pierdeau. len(date) - len(date.lstrip(b"\x00")) numără doar zerourile de la început, iar "1" * zerouri le pune înapoi ca „1”, valoarea 0 în alfabetul Base58. Cazul 00 arată regula cel mai clar: numărul e 0, dar rezultatul trebuie să fie „1”.
Cum o eviți pe viitor
Testează codarea pe vectori cunoscuți: un singur octet zero trebuie să dea "1", doi octeți zero "11", iar adresa unei chei publice cunoscute trebuie să înceapă cu 1. Testează și drumul invers: decodeaza(codeaza(b)) == b pentru date care încep cu zerouri. Aceeași problemă apare la orice conversie bytes → număr → text, nu doar la Base58.
Întrebări frecvente
De ce adresele Bitcoin vechi încep cu 1?
Pentru că octetul de versiune al adreselor P2PKH este 0x00, iar un octet zero de la început devine caracterul „1”. Adresele P2SH au versiunea 0x05 și încep cu „3”.
Hex-ul are aceeași problemă?
Nu, dacă folosești bytes.hex(): fiecare octet devine exact două caractere, inclusiv zerourile. Problema apare doar când treci prin int și înapoi.
Erori înrudite
ValueError: substring not found str.index() nu a găsit caracterul căutat, de obicei la decodarea Base58 a unei adrese care conține 0, O, I sau l, litere excluse din alfabetul Bitcoin. Verifică fiecare caracter cu c in ALFABET înainte de index(), sau folosește find(), care întoarce -1. OverflowError: int too big to convert Numărul nu încape în câți bytes ai cerut la n.to_bytes(lungime, ...). Mărește lungimea (32 de bytes pentru chei și hash-uri) sau calculeaz-o din n.bit_length(). ValueError: byteorder must be either 'little' or 'big' Ai dat lui to_bytes() sau from_bytes() o ordine a octeților scrisă altfel decât exact "big" sau "little", de exemplu "Big", "big-endian" sau "le". Scrie textul exact, cu litere mici. Învață Blockchain de la zero, cu exerciții la fiecare lecție
Curs Blockchain și criptomonede: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
