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.
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
import struct
nonce = 4294967295 + 1
b = struct.pack("<I", nonce)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
import struct
b = struct.pack("<I", -1)import struct
b = struct.pack("<i", -1)i mic e varianta cu semn; I mare acceptă doar numere pozitive.
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.
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())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.
Reparația
import struct
def pregateste(timp, nonce, extra_nonce):
if nonce >= 2**32:
nonce = nonce % 2**32
extra_nonce += 1
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())De ce merge
Formatul I are 4 bytes, deci acceptă cel mult 4294967295. Când nonce-ul trece de limită, îl reiei de la 0 (nonce % 2**32) și crești extra_nonce, care în Bitcoin schimbă tranzacția coinbase și deci rădăcina Merkle. Astfel headerul e diferit și minerul are încă 2^32 de încercări noi.
Alte forme ale mesajului
struct.error: 'H' format requires 0 <= number <= 65535struct.error: argument out of rangestruct.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
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(). ValueError: byteorder must be either 'little' or 'big' Ai dat lui to_bytes() sau from_bytes() o ordine a octeților scrisă altfel decât exact "big" sau "little", de exemplu "Big", "big-endian" sau "le". Scrie textul exact, cu litere mici. Minarea nu găsește niciun nonce (bucla nu se mai oprește) Bucla de minare încearcă nonce după nonce, dar hash-ul nu se schimbă (nonce-ul nu intră în datele hash-uite) sau condiția de dificultate e greșită. Pune nonce-ul în textul hash-uit și verifică cu h.startswith("0" * dificultate). Î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.
