Adresă Bitcoin validă respinsă: checksum Base58Check cu SHA-256 simplu în loc de dublu
Checksum-ul unei adrese Base58Check sunt primii 4 bytes din SHA-256 aplicat de două ori: sha256(sha256(date).digest()).digest()[:4]. Cu un singur SHA-256, orice adresă reală pare invalidă. Verifică și că iei digest() (bytes), nu hexdigest().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Nu primești nicio eroare: funcția de validare respinge adrese Bitcoin corecte, ca 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa (adresa din blocul geneză). O adresă Base58Check are, după decodare, 25 de bytes: 1 byte de versiune, 20 de bytes de hash al cheii publice și 4 bytes de checksum. Checksum-ul se calculează din primii 21 de bytes cu SHA-256 dublu și păstrează primii 4 bytes ai rezultatului.
Greșelile tipice: un singur SHA-256; SHA-256 dublu, dar al doilea hash aplicat pe hexdigest() (text) în loc de digest() (bytes); compararea a 4 bytes cu 4 caractere hex; sau checksum-ul calculat din toți cei 25 de bytes, inclusiv checksum-ul. Rolul checksum-ului e să prindă greșelile de tastare: o literă schimbată dă aproape sigur alt checksum, iar portofelul refuză trimiterea.
De ce apare: cauzele frecvente
1Un singur SHA-256
checksum = hashlib.sha256(date).digest()[:4]checksum = hashlib.sha256(hashlib.sha256(date).digest()).digest()[:4]Base58Check folosește SHA-256 aplicat de două ori, ca peste tot în Bitcoin.
2Al doilea hash pe textul hex
checksum = hashlib.sha256(hashlib.sha256(date).hexdigest().encode()).digest()[:4]checksum = hashlib.sha256(hashlib.sha256(date).digest()).digest()[:4]Al doilea SHA-256 se aplică celor 32 de bytes ai primului, nu celor 64 de caractere hex.
3Checksum din toată adresa
ok = sha256d(brut)[:4] == brut[-4:]ok = sha256d(brut[:-4])[:4] == brut[-4:]Checksum-ul se calculează doar din versiune și hash, fără ultimii 4 bytes.
Repară eroarea, direct în pagină
Funcția adresa_valida de mai jos verifică checksum-ul Base58Check al unei adrese Bitcoin, dar calculează un singur SHA-256, așa că respinge și adresele reale. Repară calculul checksum-ului ca primele două adrese (reale) să fie valide, iar a treia, cu un caracter schimbat, să fie respinsă.
import hashlib
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(text):
n = 0
for c in text:
n = n * 58 + ALFABET.index(c)
zerouri = len(text) - len(text.lstrip("1"))
return b"\x00" * zerouri + n.to_bytes((n.bit_length() + 7) // 8, "big")
def adresa_valida(adresa):
brut = decodeaza(adresa)
date, checksum = brut[:-4], brut[-4:]
return hashlib.sha256(date).digest()[:4] == checksum
for a in ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN3"]:
print(a, adresa_valida(a))1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa True 1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2 True 1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN3 False
Indiciu
În Bitcoin, checksum-ul folosește SHA-256 aplicat de două ori, pe bytes.
Reparația
import hashlib
ALFABET = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz"
def decodeaza(text):
n = 0
for c in text:
n = n * 58 + ALFABET.index(c)
zerouri = len(text) - len(text.lstrip("1"))
return b"\x00" * zerouri + n.to_bytes((n.bit_length() + 7) // 8, "big")
def adresa_valida(adresa):
brut = decodeaza(adresa)
date, checksum = brut[:-4], brut[-4:]
return hashlib.sha256(hashlib.sha256(date).digest()).digest()[:4] == checksum
for a in ["1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2", "1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN3"]:
print(a, adresa_valida(a))De ce merge
Base58Check calculează checksum-ul ca primii 4 bytes din SHA-256 aplicat de două ori pe versiune și hash. Cu un singur SHA-256, niciun checksum real nu se potrivea. Cu hash-ul dublu, cele două adrese reale trec, iar adresa cu ultimul caracter schimbat pică, exact rolul checksum-ului: prinde greșelile de tastare înainte de trimitere.
Cum o eviți pe viitor
Scrie o funcție sha256d(b) pentru hash-ul dublu și folosește-o peste tot unde Bitcoin îl cere: checksum-uri, ID-uri de tranzacții, hash-uri de bloc. Testează validarea pe adrese reale cunoscute (de exemplu adresa din blocul geneză) și pe aceeași adresă cu un caracter schimbat, care trebuie respinsă.
Întrebări frecvente
De ce Bitcoin folosește SHA-256 de două ori?
Ca protecție suplimentară împotriva unor atacuri teoretice asupra funcțiilor de tip Merkle–Damgård, cum e atacul prin extinderea lungimii. Pentru tine contează doar să urmezi exact regula.
Adresele care încep cu bc1 se verifică la fel?
Nu. Adresele bc1 folosesc Bech32, care are alt alfabet și alt checksum (un cod BCH), nu Base58Check.
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. 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. 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. Î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.
