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.3.0] — 2026-06-02

Añadido

• Rastro de procedencia (primera versión). En la pestaña Auditoría, debajo del informe de privacidad, cada input de la transacción tiene un botón "seguir rastro" que trae la transacción de origen de ese input y muestra un eslabón con: el txid de origen (enlace a tu propio Mempool), cuánto fluyó, la fecha y la banda de privacidad de esa transacción. Funciona bajo demanda —cada consulta la pide el usuario, para no sobrecargar el nodo— y cachea en memoria las transacciones ya consultadas para no repetirlas. Incluye botón para limpiar el rastro y la caché de la sesión.

---

[1.2.1] — 2026-06-02

Cambiado

• La herramienta de OP_RETURN pasa de decodificar y mostrar el contenido a solo detectar su presencia y tamaño. Para auditar privacidad, lo relevante es que una transacción contenga datos arbitrarios (revela uso de un protocolo o servicio), no qué dicen esos datos. Además, la herramienta no debe funcionar como visor de contenido arbitrario de la cadena. Ahora indica cuántos outputs OP_RETURN hay y su tamaño en bytes, sin mostrar el contenido.

---

[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