...
Eroare Blockchain · Adrese și Base58

Adresa Base58 pierde „1” de la început: zerourile din față

Pe scurt

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

Greșit
PYTHON
def b58(date):
    n = int.from_bytes(date, "big")
    s = ""
    while n:
        n, r = divmod(n, 58)
        s = ALFABET[r] + s
    return s
Corect
PYTHON
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

Numeri octeții zero de la început și pui câte un „1” pentru fiecare.

2Zerourile numărate în tot textul

Greșit
PYTHON
zerouri = date.count(0)
return "1" * zerouri + s
Corect
PYTHON
zerouri = len(date) - len(date.lstrip(b"\x00"))
return "1" * zerouri + s

Contează doar zerourile de la început; cele din mijloc sunt deja în număr.

Repară tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
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.

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

← Toate erorile Blockchain

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.