...
Eroare Blockchain · Adrese și Base58

ValueError: substring not found

Pe scurt

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

Greșit
PYTHON
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
n = 0
for c in "1BvBM0fgL":
    n = n * 58 + ALFABET.index(c)
Corect
PYTHON
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

Greșit
PYTHON
for c in " 1BvBMSEYstWet":
    v = ALFABET.index(c)
Corect
PYTHON
for c in " 1BvBMSEYstWet".strip():
    v = ALFABET.index(c)

Spațiul nu e în alfabet; strip() îl scoate de la capete.

Repară tu

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

Codul care dă eroarea
PYTHON
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")
După reparație, programul afișează
1BvBMSEYst valid
1BvBMSEYst invalid
3J98t1WpEZ valid
Indiciu

Verifică dacă fiecare caracter există în ALFABET înainte să-i cauți poziția.

Alte forme ale mesajului

  • ValueError: 'x' is not in list
  • ValueError: 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

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