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

ValueError: bytes must be in range(0, 256)

Pe scurt

Ai construit bytes dintr-o listă care conține un număr mai mare de 255 sau negativ. Un octet ține doar valori 0–255: reduce valorile cu % 256 sau scrie numerele mari cu to_bytes.

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

Ce înseamnă

bytes([...]) și bytearray([...]) creează câte un octet din fiecare număr din listă, iar un octet are 8 biți, deci valori de la 0 la 255. Mesajul spune că cel puțin un element din listă e în afara intervalului range(0, 256).

În cod de blockchain apare când combini octeți cu operații care pot depăși 255 (adunare, <<), când pui un număr mare (o sumă, un nonce) ca un singur element în listă sau când construiești o „cheie” din numere alese de tine. Dacă vrei să păstrezi doar ultimii 8 biți, folosește % 256 sau & 0xff. Dacă numărul trebuie păstrat întreg, scrie-l pe mai mulți octeți cu n.to_bytes(lungime, "big").

De ce apare: cauzele frecvente

1Adunare de octeți fără reducere

Greșit
PYTHON
a = bytes([200, 100])
b = bytes([100, 50])
suma = bytes([x + y for x, y in zip(a, b)])
Corect
PYTHON
a = bytes([200, 100])
b = bytes([100, 50])
suma = bytes([(x + y) % 256 for x, y in zip(a, b)])

200 + 100 = 300 nu încape într-un octet; % 256 păstrează ultimii 8 biți.

2Un număr mare pus ca un singur octet

Greșit
PYTHON
nonce = 1000
antet = bytes([1, nonce])
Corect
PYTHON
nonce = 1000
antet = bytes([1]) + nonce.to_bytes(4, "little")

1000 are nevoie de doi octeți. to_bytes îl scrie pe lungimea dorită.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos face un checksum de jucărie: adună octeții a două hash-uri, poziție cu poziție, dar dă ValueError: bytes must be in range(0, 256). Repară-l ca fiecare sumă să păstreze doar ultimii 8 biți și afișează Combinat: (primele 8 bytes în hex) și Lungime: 32.

Codul care dă eroarea
PYTHON
import hashlib

a = hashlib.sha256(b"bloc 1").digest()
b = hashlib.sha256(b"bloc 2").digest()
combinat = bytes([x + y for x, y in zip(a, b)])
print("Combinat:", combinat[:8].hex())
print("Lungime:", len(combinat))
După reparație, programul afișează
Combinat: 1837580d6caa1840
Lungime: 32
Indiciu

Restul împărțirii la 256 păstrează valoarea într-un octet.

Alte forme ale mesajului

  • ValueError: byte must be in range(0, 256)

Cum o eviți pe viitor

Când lucrezi la nivel de octeți, gândește-te la fiecare valoare: încape în 0–255? Pentru operații pe octeți (XOR, combinarea a două chei) folosește ^, care nu depășește niciodată 255. Pentru numere care pot fi mari, folosește to_bytes cu lungimea din protocol, nu liste de numere.

Întrebări frecvente

De ce mesajul spune range(0, 256) și nu 0–255?

E notația Python pentru interval: range(0, 256) conține numerele de la 0 la 255, iar 256 e exclus.

XOR între octeți poate da eroarea asta?

Nu. x ^ y între două valori 0–255 dă tot o valoare 0–255. De aceea XOR-ul e operația obișnuită pentru combinarea octeților.

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.