ValueError: int() base must be >= 2 and <= 36, or 0
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
n = int("3J98t1Wp", 58)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”
n = int("aA", 36)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ă 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.
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(text):
return int(text, 58)
for t in ["2", "z", "21", "StV1DL6CwTryKyV"]:
print(t, hex(decodeaza(t)))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.
Reparația
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(text):
n = 0
for c in text:
n = n * 58 + ALFABET.index(c)
return n
for t in ["2", "z", "21", "StV1DL6CwTryKyV"]:
print(t, hex(decodeaza(t)))De ce merge
int cunoaște doar bazele 2–36 cu cifre și litere standard, iar Base58 are propriul alfabet. Bucla aplică regula oricărei baze de numerație: fiecare caracter nou înmulțește valoarea de până atunci cu 58 și adaugă valoarea lui. "2" valorează 1, "z" 57, iar "21" înseamnă 1 * 58 + 0, adică 58.
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
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. 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. ValueError: invalid literal for int() with base 16: '0x' Textul dat lui int(..., 16) nu e un număr hex: de obicei e "0x" gol (un răspuns RPC fără date), un text gol sau are caractere străine. Tratează explicit valoarea goală înainte de conversie. Î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.
