...
Eroare Blockchain · Hex, bytes și numere mari

struct.error: unpack requires a buffer of 4 bytes

Pe scurt

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

Greșit
PYTHON
import struct
antet = bytes.fromhex("0100000029ab5f49")
versiune, = struct.unpack("<I", antet)
Corect
PYTHON
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

Greșit
PYTHON
timestamp, = struct.unpack("<I", antet[4:7])
Corect
PYTHON
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ă tu

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.

Codul care dă eroarea
PYTHON
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)
După reparație, programul afișează
Versiune: 1
Timestamp: 1700000000
Nonce: 4000
Indiciu

Fiecare câmp are exact 4 bytes: verifică capetele feliilor.

Alte forme ale mesajului

  • struct.error: unpack requires a buffer of 8 bytes
  • struct.error: unpack requires a buffer of 2 bytes
  • struct.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

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