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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
text.index(sub) întoarce poziția lui sub în text, iar dacă nu-l găsește dă ValueError: substring not found. Metoda înrudită text.find(sub) nu dă eroare, ci întoarce -1. Pentru liste, lista.index(x) dă ValueError: 'x' is not in list.
În cursul de blockchain, index apare la decodarea Base58: fiecare caracter al adresei e transformat în valoarea lui cu ALFABET.index(c). Alfabetul Base58 al Bitcoin elimină intenționat caracterele care se confundă ușor: cifra 0, literele O, I și l. O adresă scrisă de mână sau copiată greșit, cu un 0 în loc de o, dă exact eroarea din titlu. Într-un portofel, o astfel de adresă trebuie respinsă cu un mesaj clar, nu cu o excepție neprinsă.
De ce apare: cauzele frecvente
1Caracter care nu există în Base58
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
n = 0
for c in "1BvBM0fgL":
n = n * 58 + ALFABET.index(c)ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
adresa = "1BvBM0fgL"
if any(c not in ALFABET for c in adresa):
print("Adresă invalidă")Verifici caracterele înainte să le cauți poziția, deci adresa greșită e respinsă cu un mesaj clar.
2Spații din copiere
for c in " 1BvBMSEYstWet":
v = ALFABET.index(c)for c in " 1BvBMSEYstWet".strip():
v = ALFABET.index(c)Spațiul nu e în alfabet; strip() îl scoate de la capete.
Repară eroarea, direct în pagină
Funcția decodeaza de mai jos transformă adrese Base58 în număr, dar a doua adresă are cifra 0, care nu e în alfabetul Base58, iar programul dă ValueError: substring not found. Repară funcția ca să întoarcă None pentru adresele cu caractere invalide, iar programul să afișeze valid sau invalid pentru fiecare adresă.
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(adresa):
n = 0
for c in adresa:
n = n * 58 + ALFABET.index(c)
return n
adrese = ["1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN0", "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"]
for a in adrese:
n = decodeaza(a)
print(a[:10], "valid" if n is not None else "invalid")1BvBMSEYst valid 1BvBMSEYst invalid 3J98t1WpEZ valid
Indiciu
Verifică dacă fiecare caracter există în ALFABET înainte să-i cauți poziția.
Reparația
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(adresa):
n = 0
for c in adresa:
if c not in ALFABET:
return None
n = n * 58 + ALFABET.index(c)
return n
adrese = ["1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN0", "3J98t1WpEZ73CNmQviecrnyiWrnqRhWNLy"]
for a in adrese:
n = decodeaza(a)
print(a[:10], "valid" if n is not None else "invalid")De ce merge
ALFABET.index(c) dă eroare când caracterul lipsește din alfabet, iar Base58 nu conține cifra 0. Verificarea c not in ALFABET prinde caracterul înainte de index și funcția întoarce None, deci programul poate spune frumos că adresa e invalidă. Celelalte două adrese au doar caractere permise.
Alte forme ale mesajului
ValueError: 'x' is not in listValueError: substring not found (str.index)
Cum o eviți pe viitor
La orice date venite de la utilizator (adrese, chei, hash-uri), validează formatul înainte să le procesezi: caractere permise, lungime, checksum. Pentru căutări în care lipsa e posibilă, folosește find() sau in; păstrează index() pentru situațiile în care lipsa ar fi o greșeală de program. Un dicționar {c: i for i, c in enumerate(ALFABET)} e și mai rapid decât index.
Întrebări frecvente
De ce Base58 nu are 0, O, I și l?
Pentru că se confundă ușor la citire și la scriere de mână. Satoshi Nakamoto a ales Base58 tocmai ca adresele să poată fi copiate fără astfel de greșeli.
Dacă toate caracterele sunt valide, adresa e corectă?
Nu neapărat. Adresele Bitcoin au și un checksum de 4 bytes (din dublu SHA-256), care prinde majoritatea greșelilor de tastare.
Erori înrudite
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. binascii.Error: Non-hexadecimal digit found binascii.unhexlify() (sau a2b_hex) a găsit în text un caracter care nu e cifră hex: prefixul 0x, un spațiu, o literă după f sau un caracter invizibil. Curăță textul (fără 0x, fără spații) înainte de conversie. ValueError: non-hexadecimal number found in fromhex() arg at position 1 Textul dat lui bytes.fromhex conține un caracter care nu e cifră hex, de obicei prefixul 0x (x este la poziția 1). Taie prefixul înainte: bytes.fromhex(valoare.removeprefix("0x")). Î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.
