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

binascii.Error: Non-hexadecimal digit found

Pe scurt

binascii.unhexlify() (sau a2b_hex) a găsit în text un caracter care nu e cifră hex: prefixul 0x, un spațiu, o literă după f sau un caracter invizibil. Curăță textul (fără 0x, fără spații) înainte de conversie.

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

Ce înseamnă

binascii.unhexlify(text) face același lucru ca bytes.fromhex(text): transformă un text hex în bytes, câte două cifre pentru fiecare octet. Cifrele hex permise sunt doar 0-9 și a-f (sau A-F). Mesajul îți spune că a dat peste altceva, dar, spre deosebire de fromhex, nu îți spune poziția.

Cauzele tipice în blockchain: adrese și hash-uri cu prefixul 0x (x nu e cifră hex), texte copiate de pe un explorator cu spații sau cu un rând nou la final, litera O în loc de cifra 0, sau un text care nu e hex deloc (Base58, Base64). Spre deosebire de bytes.fromhex, unhexlify nu acceptă nici măcar spațiile dintre octeți. Dacă textul are număr impar de caractere, eroarea e alta: Odd-length string.

De ce apare: cauzele frecvente

1Prefixul 0x lăsat în text

Greșit
PYTHON
import binascii

adresa = "0x52908400098527886E0F7030069857D2E4169EE7"
b = binascii.unhexlify(adresa)
Corect
PYTHON
import binascii

adresa = "0x52908400098527886E0F7030069857D2E4169EE7"
b = binascii.unhexlify(adresa.removeprefix("0x"))

0x arată doar că urmează un număr hex; nu face parte din octeți.

2Spații sau rând nou în text

Greșit
PYTHON
import binascii

h = "9f86 d081 884c\n"
b = binascii.unhexlify(h)
Corect
PYTHON
import binascii

h = "9f86 d081 884c\n"
b = binascii.unhexlify("".join(h.split()))

"".join(h.split()) elimină toate spațiile și rândurile noi.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos transformă în bytes trei adrese copiate de pe un explorator, ca să afișeze lungimea fiecăreia, dar dă binascii.Error: Non-hexadecimal digit found. Repară funcția curata ca toate trei să se convertească și programul să afișeze <primele 8 caractere> 20 bytes pentru fiecare.

Codul care dă eroarea
PYTHON
import binascii

adrese = [
    "0x52908400098527886E0F7030069857D2E4169EE7",
    "  0x8617E340B3D01FA5F11F306F4090FD50E238070D\n",
    "de709f2102306220921060314715629080e2fb77",
]

def curata(a):
    return a

for a in adrese:
    c = curata(a)
    b = binascii.unhexlify(c)
    print(c[:8].lower(), len(b), "bytes")
După reparație, programul afișează
52908400 20 bytes
8617e340 20 bytes
de709f21 20 bytes
Indiciu

Scoate spațiile de la capete și prefixul 0x înainte de conversie.

Alte forme ale mesajului

  • binascii.Error: Odd-length string
  • binascii.Error: Non-hexadecimal digit found (a2b_hex)

Cum o eviți pe viitor

Normalizează orice text hex primit din afară într-o singură funcție: strip(), scoate 0x, scoate spațiile, apoi convertește. Dacă nu ai nevoie de binascii, folosește bytes.fromhex: acceptă spațiile dintre octeți și, când greșești, îți spune și poziția caracterului greșit.

Întrebări frecvente

E la fel cu „non-hexadecimal number found in fromhex() arg”?

Aceeași cauză, altă funcție. bytes.fromhex îți dă și poziția, binascii.unhexlify doar spune că a găsit un caracter greșit.

Majusculele contează?

Nu. A-F și a-f sunt acceptate la fel. Adresele Ethereum cu majuscule (EIP-55) se convertesc fără probleme, după ce scoți 0x.

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.