ValueError: bytes must be in range(0, 256)
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
a = bytes([200, 100])
b = bytes([100, 50])
suma = bytes([x + y for x, y in zip(a, b)])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
nonce = 1000
antet = bytes([1, nonce])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ă 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.
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))Combinat: 1837580d6caa1840 Lungime: 32
Indiciu
Restul împărțirii la 256 păstrează valoarea într-un octet.
Reparația
import hashlib
a = hashlib.sha256(b"bloc 1").digest()
b = hashlib.sha256(b"bloc 2").digest()
combinat = bytes([(x + y) % 256 for x, y in zip(a, b)])
print("Combinat:", combinat[:8].hex())
print("Lungime:", len(combinat))De ce merge
Doi octeți adunați pot da până la 510, iar un octet ține doar 0–255. (x + y) % 256 păstrează ultimii 8 biți ai sumei, adică exact ce ar face un registru de 8 biți al procesorului. Rezultatul are tot 32 de bytes. Pentru combinări reale de hash-uri se folosește însă un nou hash, de exemplu sha256(a + b), nu adunarea octeților.
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
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(). TypeError: string argument without an encoding Ai apelat bytes(text) fără să spui codificarea. Scrie text.encode() sau bytes(text, "utf-8"). TypeError: 'float' object cannot be interpreted as an integer Ai dat un float acolo unde trebuie un întreg: o lungime la to_bytes, un argument la range() sau un indice. De obicei vine din împărțirea cu /; folosește // (împărțire întreagă). Î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.
