...
Eroare Blockchain · Serializarea blocurilor în JSON

TypeError: keys must be str, int, float, bool or None, not tuple

Pe scurt

json.dumps a primit un dicționar cu chei de tip tuple, de obicei setul UTXO indexat după (txid, index). JSON acceptă doar chei text: transformă cheia în "txid:index" sau salvează UTXO-urile ca listă de obiecte.

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

Ce înseamnă

În JSON, cheile unui obiect sunt mereu texte. json.dumps mai acceptă câteva tipuri simple ca chei (int, float, bool, None) și le transformă în text, dar nu știe cum să transforme un tuple, un bytes sau un obiect. Mesajul spune exact ce tip de cheie a găsit.

În modelul UTXO e foarte natural să ții ieșirile necheltuite într-un dicționar {(txid, index): suma}: perechea identifică unic o ieșire, iar căutarea e rapidă. Problema apare abia când vrei să salvezi starea, să o trimiți altui nod sau să o hash-uiești prin JSON. Ai două variante: cheia devine text (f"{txid}:{index}", formatul folosit și de Bitcoin pentru un „outpoint”), sau transformi dicționarul într-o listă de obiecte {"txid": ..., "index": ..., "suma": ...}. Ca să păstrezi ordinea stabilă pentru hash, sortează.

De ce apare: cauzele frecvente

1Setul UTXO cu chei (txid, index)

Greșit
PYTHON
import json

utxo = {("a1b2", 0): 5000, ("a1b2", 1): 2000}
text = json.dumps(utxo)
Corect
PYTHON
import json

utxo = {("a1b2", 0): 5000, ("a1b2", 1): 2000}
text = json.dumps({f"{t}:{i}": s for (t, i), s in utxo.items()})

Cheia "a1b2:0" e text, iar JSON o acceptă.

2Chei bytes (hash-uri ca digest)

Greșit
PYTHON
import json, hashlib

h = hashlib.sha256(b"tx").digest()
json.dumps({h: "confirmat"})
Corect
PYTHON
import json, hashlib

h = hashlib.sha256(b"tx").digest()
json.dumps({h.hex(): "confirmat"})

Un hash ca bytes nu poate fi cheie JSON; ca text hex, da.

Repară tu

Repară eroarea, direct în pagină

Codul de mai jos ține setul UTXO ca dicționar cu chei (txid, index) și vrea să-l salveze ca JSON și să calculeze amprenta stării, dar dă TypeError: keys must be str, int, float, bool or None, not tuple. Repară funcția exporta ca cheile să devină "txid:index", iar programul să afișeze JSON-ul și primele 16 caractere ale hash-ului.

Codul care dă eroarea
PYTHON
import json, hashlib

utxo = {("b7e1", 1): 3000, ("a1f2", 0): 5000, ("a1f2", 1): 1500}

def exporta(utxo):
    return json.dumps(utxo, sort_keys=True, separators=(",", ":"))

text = exporta(utxo)
print(text)
print("Amprentă:", hashlib.sha256(text.encode()).hexdigest()[:16])
După reparație, programul afișează
{"a1f2:0":5000,"a1f2:1":1500,"b7e1:1":3000}
Amprentă: 9e197e379ca536c0
Indiciu

Construiește un dicționar nou în care fiecare cheie e textul f"{txid}:{index}".

Alte forme ale mesajului

  • TypeError: keys must be str, int, float, bool or None, not bytes
  • TypeError: keys must be str, int, float, bool or None, not frozenset

Cum o eviți pe viitor

Ține în memorie structura care îți e comodă (chei tuple sunt în regulă), dar scrie două funcții mici, exporta și importa, care transformă cheile în text și înapoi. Folosește-le oriunde salvezi, trimiți sau hash-uiești starea. Pentru hash, adaugă sort_keys=True, ca toate nodurile să obțină același text.

Întrebări frecvente

De ce chei int merg?

json.dumps transformă automat cheile int în text: {0: "a"} devine {"0": "a"}. La citire înapoi, cheia rămâne însă text, nu int.

Pot folosi skipkeys=True?

Poți, dar cheile problematice sunt pur și simplu omise, deci pierzi date fără să știi. Pentru un set UTXO, asta e o greșeală gravă.

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.