...
Eroare Blockchain · hashlib: text, bytes și hash-uri

LookupError: 'hex' is not a text encoding; use codecs.encode() to handle arbitrary codecs

Pe scurt

Ai scris .encode("hex") sau .decode("hex"), forma din Python 2. În Python 3, pentru bytes → hex folosești b.hex(), iar pentru hex → bytes bytes.fromhex(text). Pentru textul unui hash, hexdigest() îți dă direct hex-ul.

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

Ce înseamnă

În Python 2 se putea scrie "abc".encode("hex") sau h.decode("hex"). În Python 3, str.encode acceptă doar encoding-uri de text (utf-8, ascii, latin-1...), iar hex este o transformare bytes → bytes, nu un encoding de text. Mesajul spune exact asta și sugerează codecs.encode(), modulul care știe și transformările „arbitrare”.

Apare des când copiezi cod vechi de blockchain (scripturi Bitcoin, tutoriale din 2014–2017) sau răspunsuri vechi de pe forumuri. Metodele moderne sunt mai simple: b.hex() dă textul hex al unor bytes, bytes.fromhex("ab01") face invers, iar hashlib.sha256(b).hexdigest() dă direct hex-ul hash-ului. Dacă vezi .decode("hex") pe un text, înlocuiește-l cu bytes.fromhex(text).

De ce apare: cauzele frecvente

1Cod Python 2 pentru hex

Greșit
PYTHON
date = "Ana->Bogdan:5"
print(date.encode("hex"))
Corect
PYTHON
date = "Ana->Bogdan:5"
print(date.encode().hex())

Întâi transformi textul în bytes cu encode(), apoi hex() dă textul hex.

2Hex înapoi în bytes cu decode("hex")

Greșit
PYTHON
h = "9f86d081884c7d65"
b = h.decode("hex")
Corect
PYTHON
h = "9f86d081884c7d65"
b = bytes.fromhex(h)

Pe un str nu există decode în Python 3; bytes.fromhex citește direct textul hex.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos, copiat dintr-un tutorial vechi, afișează în hex o tranzacție și hash-ul ei dublu, ca în Bitcoin, dar dă LookupError: 'hex' is not a text encoding. Adu-l la Python 3 ca să afișeze textul hex al tranzacției și primele 16 caractere ale hash-ului dublu.

Codul care dă eroarea
PYTHON
import hashlib

tx = "Ana->Bogdan:5"
print("Hex:", tx.encode("hex"))
dublu = hashlib.sha256(hashlib.sha256(tx.encode()).digest()).digest()
print("Hash dublu:", dublu.hex()[:16])
După reparație, programul afișează
Hex: 416e612d3e426f6764616e3a35
Hash dublu: 305679ea2abc8310
Indiciu

Bytes-urile au o metodă care dă direct textul hex.

Alte forme ale mesajului

  • LookupError: 'base64' is not a text encoding; use codecs.encode() to handle arbitrary codecs
  • LookupError: unknown encoding: hexa
  • LookupError: 'hex' is not a text encoding; use codecs.decode() to handle arbitrary codecs

Cum o eviți pe viitor

Ține minte trei unelte: bytes.hex(), bytes.fromhex() și hexdigest(). Când copiezi cod vechi, caută encode("hex"), decode("hex"), print x fără paranteze sau xrange: sunt semne că e Python 2 și trebuie adaptat. Pentru base64 folosește modulul base64 (base64.b64encode(b)).

Întrebări frecvente

Merge varianta cu codecs.encode?

Da: codecs.encode(b"abc", "hex") dă b'616263', adică tot bytes. b"abc".hex() e mai scurt și îți dă direct un text.

Care e diferența dintre hexdigest() și digest().hex()?

Niciuna în rezultat: ambele dau aceleași 64 de caractere pentru SHA-256. digest() e util când ai nevoie de bytes, de exemplu la hash-ul dublu din Bitcoin.

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.