txoko-dashboard/CHANGELOG.md

Changelog

Todos los cambios notables de Txoko Node Dashboard se documentan aquí.

El formato sigue Keep a Changelog y el versionado sigue Versionado Semántico: MAYOR.MENOR.PARCHE.

• MAYOR — cambios grandes que cambian cómo se usa la herramienta
• MENOR — características nuevas que no rompen lo anterior
• PARCHE — arreglos de errores

---

[1.2.0] — 2026-06-01

Añadido

• Exportación del informe de privacidad de una transacción en dos formatos, desde la pestaña Auditoría. El botón "↓ JSON" descarga el análisis completo con su estructura (score, banda, wallets detectados y todas las señales con su detalle), pensado para procesar con scripts o archivar en formato máquina. El botón "↓ MD" descarga el informe legible en Markdown (diagnóstico, qué puede saber un analista, limitaciones, recomendaciones y una tabla de señales), para leer o guardar como documento. Ambos se generan en el navegador y se descargan en local — no sale nada del nodo.

Corregido

• El botón "Analizar privacidad" del Lab ahora envía correctamente el txid a la pestaña Auditoría y lanza el análisis. Antes la pestaña aparecía vacía porque el identificador no se transmitía entre vistas.

---

[1.1.0] — 2026-06-01

Añadido

• Exportación del UTXO Map a CSV. Un botón "↓ CSV" en el UTXO Map descarga todos los UTXOs de la dirección analizada con su información: txid, vout, valor en sats y en BTC, estado de confirmación, altura de bloque, score de privacidad y problemas detectados. El archivo se genera en el navegador y se descarga en local — no pasa por ningún servidor, no sale nada del nodo. Pensado para abrir en una hoja de cálculo y ordenar o filtrar los UTXOs por privacidad.

---

1.0.0 — 2026-05-31

Primera versión completa y funcional. Suite de auditoría de privacidad Bitcoin self-hosted, con motor de análisis, exploración de cadena, monitor del nodo y detección de entidades.

Motor de análisis de privacidad

• Análisis de transacción con 15+ heurísticas ponderadas
• Score de privacidad por bandas (ALTA / MEDIA / BAJA), sin precisión numérica falsa
• Informe narrativo en prosa: explica qué puede deducir un observador
• Distinción explícita entre certeza, probabilidad y posibilidad en cada señal
• Etiquetas de accionabilidad: qué es evitable, qué depende del wallet, qué ya está en la cadena y no se puede cambiar

Detección de CoinJoin

• Whirlpool con denominaciones fijas y tolerancia del 2%
• CoinJoin genérico por outputs de igual valor
• Filtro de denominación mínima (10.000 sats) — descarta mezclas de polvo que no son CoinJoin reales
• OP_RETURN tratado correctamente: un Whirlpool con OP_RETURN de cambio se sigue detectando
• Supresión de penalizaciones coherente: en una mezcla no penaliza señales que son esperadas

Fingerprinting de wallet

• Detección de BlueWallet, Bitcoin Core, Sparrow, Electrum y wallets con Taproot nativo a partir de señales estructurales combinadas
• Wallet inferido del tipo de CoinJoin (Whirlpool → Samourai/Sparrow, genérico → Wasabi/JoinMarket)
• En CoinJoin el fingerprinting es informativo y no penaliza

Detección de entidades

• Índice de ~155 direcciones embebido, lookup local sin consultas externas
• OFAC: alerta crítica si una dirección está en la lista de sanciones (Blender.io, Sinbad, Garantex, Suex, Chatex, Lazarus Group)
• Mining pools: marca informativa de origen en pool de minería (F2Pool, Foundry, Antpool, MARA, Braiins, Luxor, Ocean, NiceHash, Bitfury)

Exploración y monitor

• Explorador de bloques y búsqueda on-chain
• Vista de Mempool con stats, fees y bloques proyectados
• Monitor del nodo: estado de Bitcoin Core, sistema y logs en tiempo real
• UTXO Map con score de privacidad por moneda
• Herramientas: conversor de unidades, validador de dirección, decodificadores

Experiencia de uso

• El análisis se mantiene al cambiar de pestaña y volver (Privacy Lab y Auditoría) — el estado vive en memoria, sin escribir en disco
• Diseño responsive para móvil
• Tema cypherpunk

Filosofía

• Sin dependencias externas de datos: todo viene del propio nodo del usuario
• Ninguna consulta sale de la red del usuario
• Didáctica honesta sobre las limitaciones del análisis