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

struct.error: 'I' format requires 0 <= number <= 4294967295

Pe scurt

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.

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

Ce înseamnă

Modulul struct împachetează numere în formate binare fixe, exact cum le cere un protocol. I înseamnă întreg fără semn pe 4 bytes, deci valorile permise sunt de la 0 la 4294967295 (2^32 - 1). Mesajul spune că numărul tău nu încape. La H (2 bytes) limita e 65535, la Q (8 bytes) e 2^64 - 1, iar la formatele cu semn (i, q) sunt permise și valori negative.

În headerul unui bloc Bitcoin, versiunea, timpul, ținta și nonce-ul sunt toate pe 4 bytes. Un miner care doar crește nonce-ul ajunge la limită după 4,29 miliarde de încercări, prea puțin la dificultatea de azi. De aceea minerii schimbă și extraNonce din tranzacția coinbase sau timpul, apoi repornesc nonce-ul. Eroarea mai apare când împachetezi o valoare negativă cu un format fără semn.

De ce apare: cauzele frecvente

1Nonce-ul crește peste 2^32 - 1

Greșit
PYTHON
import struct

nonce = 4294967295 + 1
b = struct.pack("<I", nonce)
Corect
PYTHON
import struct

nonce = (4294967295 + 1) % 2**32
extra_nonce = 1
b = struct.pack("<I", nonce)

Nonce-ul se reia de la 0, iar diferența se pune în alt câmp (aici extra_nonce).

2Valoare negativă cu format fără semn

Greșit
PYTHON
import struct

b = struct.pack("<I", -1)
Corect
PYTHON
import struct

b = struct.pack("<i", -1)

i mic e varianta cu semn; I mare acceptă doar numere pozitive.

Repară tu

Repară eroarea, direct în pagină

Funcția de mai jos construiește partea finală a unui header (timp și nonce, câte 4 bytes little-endian), iar minerul a ajuns cu nonce-ul la 4294967296, așa că apare struct.error: 'I' format requires 0 <= number <= 4294967295. Repară funcția pregateste ca, atunci când nonce-ul trece de limită, să-l reia de la 0 și să crească extra_nonce cu 1. Programul afișează câmpurile și headerul în hex.

Codul care dă eroarea
PYTHON
import struct

def pregateste(timp, nonce, extra_nonce):
    return nonce, extra_nonce, struct.pack("<II", timp, nonce)

nonce, extra, h = pregateste(1700000000, 4294967296, 0)
print("nonce:", nonce)
print("extra_nonce:", extra)
print("header:", h.hex())
După reparație, programul afișează
nonce: 0
extra_nonce: 1
header: 00f1536500000000
Indiciu

Folosește 2**32 ca limită: nonce-ul rămâne restul, iar extra_nonce crește.

Alte forme ale mesajului

  • struct.error: 'H' format requires 0 <= number <= 65535
  • struct.error: argument out of range
  • struct.error: 'i' format requires -2147483648 <= number <= 2147483647

Cum o eviți pe viitor

Când scrii un format binar, verifică limitele fiecărui câmp înainte de împachetare (assert 0 <= nonce < 2**32). În bucla de minare, oprește-te la limită și schimbă extraNonce-ul, în loc să lași nonce-ul să crească la nesfârșit. Pentru câmpuri mai mari de 8 bytes, folosește n.to_bytes(32, "big") în loc de struct.

Întrebări frecvente

Ce înseamnă < din "<I"?

Ordinea octeților: < e little-endian, > e big-endian. Bitcoin folosește little-endian în header, de aceea vezi des <I.

Nonce-ul se termină des în realitate?

Da. La dificultatea actuală, un miner parcurge toate cele 2^32 valori de nonce într-o fracțiune de secundă, așa că schimbă extraNonce-ul de foarte multe ori pe secundă.

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.