...
Eroare Blockchain · Adrese și Base58

Adresă Bitcoin validă respinsă: checksum Base58Check cu SHA-256 simplu în loc de dublu

Pe scurt

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

Greșit
PYTHON
checksum = hashlib.sha256(date).digest()[:4]
Corect
PYTHON
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

Greșit
PYTHON
checksum = hashlib.sha256(hashlib.sha256(date).hexdigest().encode()).digest()[:4]
Corect
PYTHON
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

Greșit
PYTHON
ok = sha256d(brut)[:4] == brut[-4:]
Corect
PYTHON
ok = sha256d(brut[:-4])[:4] == brut[-4:]

Checksum-ul se calculează doar din versiune și hash, fără ultimii 4 bytes.

Repară tu

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

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa True
1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2 True
1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN3 False
Indiciu

În Bitcoin, checksum-ul folosește SHA-256 aplicat de două ori, pe bytes.

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

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