...
Eroare Blockchain · hashlib: text, bytes și hash-uri

TypeError: object supporting the buffer API required

Pe scurt

Ai dat funcției hash un număr, None sau alt obiect care nu e bytes. Transformă valoarea întâi în text și apoi în bytes, de exemplu hashlib.sha256(str(nonce).encode()).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

„Buffer API” este felul în care Python numește obiectele care arată ca o bucată de memorie cu octeți: bytes, bytearray, memoryview. Funcțiile din hashlib acceptă doar astfel de obiecte. Dacă le dai un int, un float, None, o listă sau un dicționar, primești această eroare.

În codul de blockchain apare de obicei când hash-uiești direct nonce-ul, indexul blocului sau un timestamp, ori când o funcție care trebuia să întoarcă datele blocului a întors None (ai uitat return). Uită-te la linia din mesaj și verifică tipul valorii date lui sha256 sau update, de exemplu cu print(type(valoare)). Reparația: construiești din valori un text clar (f-string sau json.dumps) și îl encodezi.

De ce apare: cauzele frecvente

1Nonce-ul (un int) dat direct funcției hash

Greșit
PYTHON
import hashlib

nonce = 42
h = hashlib.sha256(nonce).hexdigest()
Corect
PYTHON
import hashlib

nonce = 42
h = hashlib.sha256(str(nonce).encode()).hexdigest()

Un int nu e un șir de bytes. str(nonce).encode() dă bytes-urile textului „42”.

2Funcția care pregătește datele nu are return

Greșit
PYTHON
def date_bloc(bloc):
    text = f"{bloc['index']}|{bloc['date']}"

h = hashlib.sha256(date_bloc(b))
Corect
PYTHON
def date_bloc(bloc):
    text = f"{bloc['index']}|{bloc['date']}"
    return text.encode()

h = hashlib.sha256(date_bloc(b))

Fără return, funcția întoarce None, iar None nu are bytes de hash-uit.

3Un dicționar dat direct funcției hash

Greșit
PYTHON
h = hashlib.sha256(bloc).hexdigest()
Corect
PYTHON
text = json.dumps(bloc, sort_keys=True)
h = hashlib.sha256(text.encode()).hexdigest()

Un dicționar nu are o formă unică în bytes. Îl serializezi determinist cu json.dumps, apoi encodezi textul.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos dă TypeError: object supporting the buffer API required, pentru că nonce-ul ajunge ca număr în funcția hash. Repară funcția hash_cu_nonce ca să hash-uiască textul date|nonce și să afișeze hash-urile pentru nonce 0, 1 și 2 (primele 16 caractere).

Codul care dă eroarea
PYTHON
import hashlib

date = "bloc 7: Ana -> Bogdan 3"

def hash_cu_nonce(date, nonce):
    h = hashlib.sha256(date.encode())
    h.update(nonce)
    return h.hexdigest()

for nonce in range(3):
    print(nonce, hash_cu_nonce(date, nonce)[:16])
După reparație, programul afișează
0 44910da2edbbe8c6
1 cf5ab7d6595e646f
2 d8fc29bb4052ab25
Indiciu

Construiește un text cu f-string din date și nonce, apoi encodează-l.

Alte forme ale mesajului

  • TypeError: a bytes-like object is required, not 'int'
  • TypeError: object supporting the buffer API required (got NoneType)

Cum o eviți pe viitor

Înainte de orice hash, transformă datele într-un singur text, într-un format fix: un f-string cu separator (f"{index}|{nonce}|{date}") sau json.dumps(..., sort_keys=True), apoi .encode(). Pune această logică într-o funcție date_de_hash(bloc) care întoarce mereu bytes și verifică o dată cu print(type(...)) că întoarce ce trebuie.

Întrebări frecvente

De ce nu transformă Python singur numărul în bytes?

Pentru că un număr se poate scrie ca bytes în multe feluri: ca text „42”, pe 4 sau 8 octeți, big-endian sau little-endian. Fiecare variantă dă alt hash, deci trebuie să alegi tu explicit.

Pot folosi nonce.to_bytes(...) în loc de str(nonce).encode()?

Da, dacă toată lumea folosește aceeași lungime și ordine a octeților (Bitcoin pune nonce-ul pe 4 bytes little-endian). În cursul nostru folosim textul, care e mai ușor de citit.

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.