struct.error: unpack requires a buffer of 4 bytes
struct.unpack a primit alt număr de bytes decât cere formatul: ">I" cere exact 4, ">Q" exact 8. Taie exact bucata de care ai nevoie (date[0:4]) sau folosește unpack_from(format, date, offset) când citești dintr-un șir mai lung.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
struct transformă bytes în numere după un format: I = întreg fără semn pe 4 bytes, Q = pe 8 bytes, H = pe 2, iar < și > aleg ordinea byte-ilor (little / big endian). struct.unpack cere ca lungimea datelor să fie exact cât formatul; mesajul îți spune câți bytes aștepta (aici 4).
În blockchain apare când citești câmpuri dintr-un antet de bloc sau dintr-o tranzacție serializată: versiunea, timestamp-ul, nonce-ul (câte 4 bytes în Bitcoin), sumele (8 bytes). Cauze tipice: tai greșit (date[4:7] are 3 bytes), dai tot șirul în loc de bucată, sau formatul nu corespunde (citești cu Q un câmp de 4 bytes). Dacă vrei să citești de la un anumit offset dintr-un șir mai lung, struct.unpack_from(fmt, date, offset) nu cere ca restul să lipsească. struct.calcsize(fmt) îți spune câți bytes cere un format.
De ce apare: cauzele frecvente
1Tot antetul dat lui unpack
import struct
antet = bytes.fromhex("0100000029ab5f49")
versiune, = struct.unpack("<I", antet)import struct
antet = bytes.fromhex("0100000029ab5f49")
versiune, = struct.unpack("<I", antet[0:4])Formatul <I descrie exact 4 bytes; antetul are 8.
2Felie cu capătul greșit
timestamp, = struct.unpack("<I", antet[4:7])timestamp, = struct.unpack_from("<I", antet, 4)[4:7] are doar 3 bytes. unpack_from citește exact 4 bytes de la offset-ul 4.
Repară eroarea, direct în pagină
Codul de mai jos citește dintr-un antet de bloc simplificat (12 bytes, little-endian) versiunea, timestamp-ul și nonce-ul, câte 4 bytes fiecare, dar dă struct.error: unpack requires a buffer of 4 bytes. Repară citirea ca programul să afișeze cele trei valori.
import struct
antet = bytes.fromhex("0100000000f15365a00f0000")
versiune, = struct.unpack("<I", antet[0:4])
timestamp, = struct.unpack("<I", antet[4:7])
nonce, = struct.unpack("<I", antet[8:12])
print("Versiune:", versiune)
print("Timestamp:", timestamp)
print("Nonce:", nonce)Versiune: 1 Timestamp: 1700000000 Nonce: 4000
Indiciu
Fiecare câmp are exact 4 bytes: verifică capetele feliilor.
Reparația
import struct
antet = bytes.fromhex("0100000000f15365a00f0000")
versiune, = struct.unpack("<I", antet[0:4])
timestamp, = struct.unpack("<I", antet[4:8])
nonce, = struct.unpack("<I", antet[8:12])
print("Versiune:", versiune)
print("Timestamp:", timestamp)
print("Nonce:", nonce)De ce merge
Formatul <I cere exact 4 bytes, iar antet[4:7] avea doar 3 (capătul din dreapta nu e inclus). Cu antet[4:8] fiecare câmp are 4 bytes. < înseamnă little-endian: byte-ul cel mai puțin semnificativ vine primul, de aceea 01000000 este versiunea 1.
Alte forme ale mesajului
struct.error: unpack requires a buffer of 8 bytesstruct.error: unpack requires a buffer of 2 bytesstruct.error: unpack_from requires a buffer of at least 8 bytes for unpacking 4 bytes at offset 4 (actual buffer size is 6)
Cum o eviți pe viitor
Scrie lungimile câmpurilor ca nume (LUNGIME_NONCE = 4) și calculează offset-urile din ele, nu de mână. Verifică formatul cu struct.calcsize("<I") și lungimea datelor cu len(date) înainte de unpack. Când parcurgi un format binar câmp cu câmp, unpack_from cu un offset care crește e mai sigur decât feliile scrise manual.
Întrebări frecvente
De ce struct.unpack întoarce un tuplu chiar pentru un singur număr?
Pentru că un format poate avea mai multe câmpuri ("<IQ"). De aceea se scrie valoare, = struct.unpack(...) sau struct.unpack(...)[0].
Nu e mai simplu int.from_bytes?
Pentru un singur număr, da: int.from_bytes(antet[0:4], "little"). struct e util când citești mai multe câmpuri dintr-o dată.
Erori înrudite
struct.error: 'I' format requires 0 <= number <= 4294967295 struct.pack("<I", n) poate scrie doar numere între 0 și 2^32 - 1, iar valoarea ta e mai mare sau negativă, de obicei un nonce care a depășit 4294967295. În Bitcoin nonce-ul are 4 bytes: când se termină, schimbi alt câmp (extraNonce, timpul) și repornești nonce-ul de la 0. IndexError: list index out of range Ai cerut un element de pe o poziție care nu există în listă: de obicei frunze[i + 1] la un arbore Merkle cu număr impar de tranzacții sau lant[-1] pe un lanț gol. Verifică lungimea listei înainte și tratează cazul impar sau gol. TypeError: cannot convert 'str' object to bytes Ai dat un text lui int.from_bytes(...) sau lui bytes(...). Dacă textul e un hash hex, folosește int(h, 16) sau int.from_bytes(bytes.fromhex(h), "big"). Dacă e text obișnuit, encodează-l întâi cu .encode(). Î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.
