...
Eroare Blockchain · Adrese și Base58

ValueError: int() base must be >= 2 and <= 36, or 0

Pe scurt

Ai încercat int(adresa, 58) ca să decodezi Base58. int() acceptă doar bazele 2–36 (cifre plus literele a–z), iar Base58 are propriul alfabet, fără 0, O, I și l. Decodează manual: n = n * 58 + ALFABET.index(c) pentru fiecare caracter.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

int(text, baza) citește un text într-o bază de la 2 la 36, folosind cifrele 0–9 și literele a–z (fără să conteze majusculele), sau baza 0, unde baza e dedusă din prefix (0x, 0b, 0o). Baza 58 nu intră în interval, de aici mesajul.

Base58, folosit de Bitcoin pentru adrese și chei private WIF, nu e o bază „standard”: are un alfabet propriu de 58 de caractere, din care lipsesc 0, O, I și l, ca adresele să nu poată fi confundate la citire. Chiar și în baza 36, Python ar citi A și a ca aceeași cifră, iar în Base58 sunt cifre diferite. Decodarea se face cu o buclă: pornești de la 0 și, pentru fiecare caracter, înmulțești cu 58 și aduni poziția caracterului în alfabet. Apoi transformi numărul în bytes și adaugi câte un byte zero pentru fiecare 1 de la începutul textului.

De ce apare: cauzele frecvente

1int cu baza 58

Greșit
PYTHON
n = int("3J98t1Wp", 58)
Corect
PYTHON
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
n = 0
for c in "3J98t1Wp":
    n = n * 58 + ALFABET.index(c)

Base58 are alfabetul lui; poziția fiecărui caracter în alfabet e valoarea cifrei.

2Baza 36 ca „aproximare”

Greșit
PYTHON
n = int("aA", 36)
Corect
PYTHON
n = ALFABET.index("a") * 58 + ALFABET.index("A")

În baza 36, a și A valorează amândouă 10; în Base58 valorează 33 și 9.

Repară tu

Repară eroarea, direct în pagină

Funcția decodeaza de mai jos vrea să transforme un text Base58 în număr, dar folosește int(text, 58), care dă ValueError: int() base must be >= 2 and <= 36, or 0. Rescrie-o cu alfabetul Base58 dat, fără int(..., 58), ca programul să afișeze numărul fiecărui text în hex.

Codul care dă eroarea
PYTHON
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"

def decodeaza(text):
    return int(text, 58)

for t in ["2", "z", "21", "StV1DL6CwTryKyV"]:
    print(t, hex(decodeaza(t)))
După reparație, programul afișează
2 0x1
z 0x39
21 0x3a
StV1DL6CwTryKyV 0x68656c6c6f20776f726c64
Indiciu

Pentru fiecare caracter: înmulțești rezultatul cu 58 și aduni poziția caracterului în alfabet.

Alte forme ale mesajului

  • ValueError: int() base must be >= 2 and <= 36, or 0 (base 64)
  • ValueError: int() base must be >= 2 and <= 36

Cum o eviți pe viitor

Pentru formate cu alfabet propriu (Base58, Bech32, Base64) scrie sau folosește o funcție dedicată, testată pe exemple cunoscute, și nu încerca să le treci prin int(text, baza). Ține alfabetul într-o constantă și verifică în decodare că fiecare caracter există în el, cu un mesaj clar dacă nu. Testează și cazul cu 1 la început.

Întrebări frecvente

De ce Base58 nu are 0, O, I și l?

Ca să nu poată fi confundate la citire sau la copiere de mână. Satoshi Nakamoto a ales alfabetul pentru adrese pe care oamenii le copiază.

Merge int(text, 0)?

Baza 0 înseamnă „deduc baza din prefix”: 0x pentru hex, 0b pentru binar, 0o pentru octal, altfel zecimal. Nu ajută la Base58.

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.