ValueError: non-hexadecimal number found in fromhex() arg at position 1
Textul dat lui bytes.fromhex conține un caracter care nu e cifră hex, de obicei prefixul 0x (x este la poziția 1). Taie prefixul înainte: bytes.fromhex(valoare.removeprefix("0x")).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
bytes.fromhex(text) transformă un text hex (cifrele 0-9 și literele a-f / A-F) în bytes, câte doi caractere pentru fiecare octet. Mesajul spune că la poziția indicată (numărând de la 0) a găsit un caracter care nu e cifră hex.
„Position 1” aproape sigur înseamnă x din prefixul 0x, pe care îl au adresele, hash-urile și cheile din Ethereum și răspunsurile JSON-RPC. Alte poziții indică de obicei un spațiu sau \n la final (copiat dintr-un fișier), două puncte între octeți (ab:cd), litere care nu sunt hex (g, o în loc de 0) sau ghilimele rămase în text. Afișează repr(valoare) ca să vezi exact caracterele și uită-te la cel de la poziția din mesaj.
De ce apare: cauzele frecvente
1Prefixul 0x păstrat
adresa = "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
b = bytes.fromhex(adresa)adresa = "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
b = bytes.fromhex(adresa.removeprefix("0x"))0x doar anunță că urmează hex, nu face parte din valoare. removeprefix îl taie (sau adresa[2:]).
2Separator sau caracter străin în text
b = bytes.fromhex("ab:cd:ef")b = bytes.fromhex("ab:cd:ef".replace(":", ""))fromhex acceptă spații între octeți, dar nu : sau alte semne.
3Linie citită cu \n sau text cu ghilimele
h = '"9f86d081884c7d65"'
b = bytes.fromhex(h)h = '"9f86d081884c7d65"'
b = bytes.fromhex(h.strip().strip('"'))Ghilimelele rămase dintr-un JSON citit greșit nu sunt cifre hex.
Repară eroarea, direct în pagină
Codul de mai jos transformă în bytes trei valori primite de la un nod Ethereum, dar dă ValueError: non-hexadecimal number found in fromhex() arg at position 1. Repară funcția in_bytes ca să accepte valori cu sau fără 0x și afișează pentru fiecare numărul de bytes.
valori = {
"adresa": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"hash": "0x48bddc104f2199f7a995e6817126ddd7307c9ef6ebac2ffa3d7cdcfe8e99da2a",
"selector": "a9059cbb",
}
def in_bytes(h):
return bytes.fromhex(h)
for nume, v in valori.items():
print(f"{nume}: {len(in_bytes(v))} bytes")adresa: 20 bytes hash: 32 bytes selector: 4 bytes
Indiciu
Taie prefixul 0x înainte de bytes.fromhex.
Reparația
valori = {
"adresa": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
"hash": "0x48bddc104f2199f7a995e6817126ddd7307c9ef6ebac2ffa3d7cdcfe8e99da2a",
"selector": "a9059cbb",
}
def in_bytes(h):
return bytes.fromhex(h.removeprefix("0x"))
for nume, v in valori.items():
print(f"{nume}: {len(in_bytes(v))} bytes")De ce merge
bytes.fromhex citește perechi de cifre hex, iar x din 0x nu e cifră hex, de aceea se oprește la poziția 1. removeprefix("0x") taie prefixul doar dacă există, deci funcția merge și pentru selectorul fără prefix. Rezultatul confirmă formatele: o adresă are 20 de bytes, un hash 32, iar selectorul unei funcții 4.
Alte forme ale mesajului
ValueError: non-hexadecimal number found in fromhex() arg at position 0ValueError: non-hexadecimal number found in fromhex() arg at position 64
Cum o eviți pe viitor
Normalizează orice valoare hex primită din afară într-o singură funcție: h.strip().lower().removeprefix("0x"). Validează apoi lungimea așteptată (64 de caractere pentru un hash sau o cheie privată, 40 pentru o adresă). Păstrează în program valorile fără prefix și adaugă 0x doar la afișare.
Întrebări frecvente
int("0xff", 16) merge, de ce bytes.fromhex("0xff") nu?
int(..., 16) acceptă prefixul 0x, dar bytes.fromhex nu. Sunt funcții diferite, cu reguli diferite, deci taie prefixul înainte de fromhex.
Contează literele mari în adresele Ethereum?
Pentru fromhex nu: acceptă și A-F. Literele mari din adresă sunt checksum-ul EIP-55, care ajută doar la detectarea greșelilor de tastare.
Erori înrudite
ValueError: fromhex() arg must contain an even number of hexadecimal digits 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(...). ValueError: invalid literal for int() with base 16: '0x' Textul dat lui int(..., 16) nu e un număr hex: de obicei e "0x" gol (un răspuns RPC fără date), un text gol sau are caractere străine. Tratează explicit valoarea goală înainte de conversie. UnicodeDecodeError: 'utf-8' codec can't decode byte 0x81 in position 2: invalid start byte Ai încercat să transformi în text cu .decode() bytes care nu sunt text, de obicei un digest() de hash sau o cheie. Pentru afișare sau stocare folosește .hex(), nu .decode(). Î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.
