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

ValueError: byteorder must be either 'little' or 'big'

Pe scurt

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ă

Greșit
PYTHON
nonce = 2083236893
b = nonce.to_bytes(4, "Little-endian")
Corect
PYTHON
nonce = 2083236893
b = nonce.to_bytes(4, "little")

Python acceptă doar textele exacte "little" și "big".

2Prescurtare din alte limbaje

Greșit
PYTHON
n = int.from_bytes(b"\x01\x00", "le")
Corect
PYTHON
n = int.from_bytes(b"\x01\x00", "little")

le / be sunt prescurtări folosite în alte biblioteci, nu în Python.

Repară tu

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.

Codul care dă eroarea
PYTHON
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))
După reparație, programul afișează
Versiune: 01000000
Timp: 29ab5f49
Nonce: 1dac2b7c
Nonce citit înapoi: 2083236893
Indiciu

byteorder acceptă doar două texte exacte, cu litere mici.

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

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