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

ValueError: fromhex() arg must contain an even number of hexadecimal digits

Pe scurt

Textul hex are un număr impar de cifre, deci ultimul octet e incomplet. De obicei lipsește un 0 la început (de la hex(n)) sau ai tăiat greșit textul: completează cu zfill sau folosește n.to_bytes(...).

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

Ce înseamnă

Fiecare octet se scrie cu exact două cifre hex (00 până la ff). Dacă textul are 63 de cifre, bytes.fromhex nu știe cum să împartă ultima cifră, așa că oprește programul. În versiunile mai vechi de Python (până la 3.12), aceeași situație dădea mesajul „non-hexadecimal number found in fromhex() arg at position 63”, ceea ce era derutant.

Cel mai des apare când obții textul cu hex(n) sau format(n, "x"): aceste funcții nu pun zerourile din față, deci un număr mic sau o cheie care începe cu 0 dă un număr impar de cifre. Alte cauze: un slice greșit (h[2:65]) sau o valoare tăiată la copiere. Verifică len(text): trebuie să fie par și egal cu dublul numărului de bytes așteptat.

De ce apare: cauzele frecvente

1hex(n) nu pune zeroul din față

Greșit
PYTHON
n = 0x0abc
text = hex(n)[2:]
b = bytes.fromhex(text)
Corect
PYTHON
n = 0x0abc
b = n.to_bytes(2, "big")

hex(0x0abc) dă 0xabc, adică trei cifre. to_bytes produce direct numărul fix de octeți.

2Text completat la lungime fixă

Greșit
PYTHON
cheie = format(5, "x")
b = bytes.fromhex(cheie)
Corect
PYTHON
cheie = format(5, "064x")
b = bytes.fromhex(cheie)

064x completează cu zerouri până la 64 de cifre, adică exact 32 de bytes.

3Slice care taie o cifră

Greșit
PYTHON
h = "0x" + "ab" * 32
b = bytes.fromhex(h[2:65])
Corect
PYTHON
h = "0x" + "ab" * 32
b = bytes.fromhex(h[2:66])

După 0x urmează 64 de cifre, de la indicele 2 până la 66 (exclusiv).

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos transformă trei chei private de test (numere) în text hex și apoi în bytes, dar dă ValueError: fromhex() arg must contain an even number of hexadecimal digits. Repară funcția cheie_hex ca să întoarcă mereu 64 de cifre și afișează lungimea în bytes și primele 8 cifre ale fiecărei chei.

Codul care dă eroarea
PYTHON
chei = [0x1E99423A4ED27608A15A2616A2B0E9E52CED330AC530EDCC32C8FFC6A526AEDD, 7, 0xABC]

def cheie_hex(n):
    return hex(n)[2:]

for k in chei:
    h = cheie_hex(k)
    b = bytes.fromhex(h)
    print(len(b), "bytes,", h[:8])
După reparație, programul afișează
32 bytes, 1e99423a
32 bytes, 00000000
32 bytes, 00000000
Indiciu

Formatează numărul ca hex completat cu zerouri până la 64 de caractere.

Alte forme ale mesajului

  • ValueError: non-hexadecimal number found in fromhex() arg at position 63

Cum o eviți pe viitor

Când transformi un număr în bytes sau în hex de lungime fixă, spune explicit lungimea: n.to_bytes(32, "big") sau format(n, "064x"). Nu folosi hex(n) pentru chei, hash-uri sau adrese, ci doar pentru afișare. Verifică lungimea cu un assert len(h) == 64 acolo unde primești valori din afară.

Întrebări frecvente

De ce eroarea apare doar pentru unele chei?

Aproximativ o cheie din 16 începe cu cifra hex 0. hex(n) o pierde, deci doar acele chei dau un număr impar de cifre. Cu format(n, "064x") toate au 64 de cifre.

Pot adăuga eu un 0 la final?

Nu: ai schimba valoarea. Zeroul lipsă e în față, de aceea se folosește zfill(64) sau format(n, "064x"), care completează la stânga.

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.