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

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

Pe scurt

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

Greșit
PYTHON
adresa = "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
b = bytes.fromhex(adresa)
Corect
PYTHON
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

Greșit
PYTHON
b = bytes.fromhex("ab:cd:ef")
Corect
PYTHON
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

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

Ghilimelele rămase dintr-un JSON citit greșit nu sunt cifre hex.

Repară tu

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.

Codul care dă eroarea
PYTHON
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")
După reparație, programul afișează
adresa: 20 bytes
hash: 32 bytes
selector: 4 bytes
Indiciu

Taie prefixul 0x înainte de bytes.fromhex.

Alte forme ale mesajului

  • ValueError: non-hexadecimal number found in fromhex() arg at position 0
  • ValueError: 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

← 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.