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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un număr mare ocupă mai mulți bytes, iar ordinea lor contează. Big-endian pune octetul cel mai semnificativ primul (cum scriem noi numerele), little-endian îl pune ultimul. int.to_bytes(lungime, byteorder) și int.from_bytes(b, byteorder) acceptă pentru byteorder doar două texte: "big" și "little". Orice altceva, chiar și "Big" sau "little-endian", dă eroarea din titlu.
În blockchain ordinea chiar contează: Bitcoin scrie în header versiunea, timpul și nonce-ul în little-endian, iar hash-urile se afișează inversat față de cum sunt calculate. Ethereum folosește big-endian peste tot. Dacă alegi ordinea greșită nu primești eroare, ci alt număr, deci verifică și rezultatul.
De ce apare: cauzele frecvente
1Majusculă sau formă lungă
nonce = 2083236893
b = nonce.to_bytes(4, "Little-endian")nonce = 2083236893
b = nonce.to_bytes(4, "little")Python acceptă doar textele exacte "little" și "big".
2Prescurtare din alte limbaje
n = int.from_bytes(b"\x01\x00", "le")n = int.from_bytes(b"\x01\x00", "little")le / be sunt prescurtări folosite în alte biblioteci, nu în Python.
Repară eroarea, direct în pagină
Codul de mai jos scrie versiunea, timpul și nonce-ul unui header Bitcoin ca bytes little-endian, dar dă ValueError: byteorder must be either 'little' or 'big'. Repară constanta ORDINE ca programul să afișeze cele trei câmpuri în hex și Nonce citit înapoi: 2083236893.
ORDINE = "Little-endian"
versiune = 1
timp = 1231006505
nonce = 2083236893
b_v = versiune.to_bytes(4, ORDINE)
b_t = timp.to_bytes(4, ORDINE)
b_n = nonce.to_bytes(4, ORDINE)
print("Versiune:", b_v.hex())
print("Timp:", b_t.hex())
print("Nonce:", b_n.hex())
print("Nonce citit înapoi:", int.from_bytes(b_n, ORDINE))Versiune: 01000000 Timp: 29ab5f49 Nonce: 1dac2b7c Nonce citit înapoi: 2083236893
Indiciu
byteorder acceptă doar două texte exacte, cu litere mici.
Reparația
ORDINE = "little"
versiune = 1
timp = 1231006505
nonce = 2083236893
b_v = versiune.to_bytes(4, ORDINE)
b_t = timp.to_bytes(4, ORDINE)
b_n = nonce.to_bytes(4, ORDINE)
print("Versiune:", b_v.hex())
print("Timp:", b_t.hex())
print("Nonce:", b_n.hex())
print("Nonce citit înapoi:", int.from_bytes(b_n, ORDINE))De ce merge
to_bytes și from_bytes acceptă doar "little" sau "big". Cu "little", octetul cel mai puțin semnificativ vine primul, de aceea versiunea 1 apare ca 01000000. Valorile sunt cele din blocul geneză Bitcoin, iar citirea înapoi cu aceeași ordine dă nonce-ul inițial.
Cum o eviți pe viitor
Definește constantele o dată, LE = "little" și BE = "big", sau folosește sys.byteorder doar dacă vrei ordinea calculatorului (rar în blockchain, unde formatul e fixat de protocol). Din Python 3.11, byteorder are valoarea implicită "big", dar scrie-l explicit: cine citește codul vede imediat ordinea.
Întrebări frecvente
Cum îmi dau seama dacă am ales ordinea greșită?
Nu primești eroare, dar numărul obținut e altul. Testează cu o valoare mică: (1).to_bytes(4, "big") dă 00000001, iar "little" dă 01000000.
De ce hash-urile Bitcoin apar „inversate” pe exploratoare?
Bitcoin calculează hash-ul ca bytes și îl tratează intern ca număr little-endian, dar îl afișează ca număr big-endian. De aceea textul afișat este hash-ul cu bytes-ii în ordine inversă.
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(). 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. TypeError: 'str' object cannot be interpreted as an integer O funcție care vrea un întreg, ca hex(), range(), bytes() sau to_bytes(), a primit un text, de obicei un număr citit ca str. Transformă textul în număr înainte, cu int(text) sau int(text, 16). Î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.
