TypeError: object supporting the buffer API required
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
import hashlib
nonce = 42
h = hashlib.sha256(nonce).hexdigest()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
def date_bloc(bloc):
text = f"{bloc['index']}|{bloc['date']}"
h = hashlib.sha256(date_bloc(b))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
h = hashlib.sha256(bloc).hexdigest()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ă 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).
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])0 44910da2edbbe8c6 1 cf5ab7d6595e646f 2 d8fc29bb4052ab25
Indiciu
Construiește un text cu f-string din date și nonce, apoi encodează-l.
Reparația
import hashlib
date = "bloc 7: Ana -> Bogdan 3"
def hash_cu_nonce(date, nonce):
text = f"{date}|{nonce}"
return hashlib.sha256(text.encode()).hexdigest()
for nonce in range(3):
print(nonce, hash_cu_nonce(date, nonce)[:16])De ce merge
Funcțiile hash acceptă doar obiecte cu bytes. Nonce-ul este un int, deci nu poate fi dat direct lui update. Construim un singur text, date|nonce, cu un separator care desparte clar câmpurile, și îl encodăm în UTF-8. Fiecare nonce schimbă textul, deci și hash-ul, exact ce folosește minarea: încerci nonce după nonce până când hash-ul îndeplinește dificultatea.
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
TypeError: Strings must be encoded before hashing Ai dat un text (str) direct lui hashlib.sha256, dar funcțiile hash lucrează doar pe bytes. Transformă textul cu .encode() înainte: hashlib.sha256(mesaj.encode()).hexdigest(). OverflowError: int too big to convert Numărul nu încape în câți bytes ai cerut la n.to_bytes(lungime, ...). Mărește lungimea (32 de bytes pentru chei și hash-uri) sau calculeaz-o din n.bit_length(). TypeError: Object of type bytes is not JSON serializable Blocul sau tranzacția pe care o serializezi cu json.dumps conține o valoare bytes, de obicei un digest() sau o semnătură. JSON nu are tip pentru bytes: păstrează valoarea ca text hex (hexdigest() sau .hex()). Î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.
