txoko-dashboard/CHANGELOG.md

# Changelog

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

El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.0.0/)
y el versionado sigue [Versionado Semántico](https://semver.org/lang/es/):
`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.4.0] — 2026-06-02

### Añadido

- Distancia a una entidad en el rastro de procedencia. A medida que se exploran
  eslabones, un resumen arriba del rastro indica a cuántos saltos está lo más
  cercano de cada tipo marcado (OFAC, minería, CoinJoin) — por ejemplo "minería
  · a 2 saltos". Es honesto sobre su alcance: solo cuenta las ramas que se han
  seguido y avisa de que puede haber más sin explorar.

### Corregido

- Transacciones coinbase como origen del rastro. Antes mostraban un aviso
  confuso ("este input no indica su transacción de origen"), como si fuera un
  error. Ahora se reconocen como el principio natural del rastro: un mensaje
  claro indica que esas monedas se crearon ahí como recompensa de minado y no
  proceden de ninguna transacción anterior.

---

## [1.3.0] — 2026-06-02

### Añadido

- Rastro de procedencia. 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 su transacción de origen y muestra un eslabón con: el txid de origen
  (enlace a tu propio Mempool), cuánto fluyó, la fecha, la banda de privacidad
  de esa transacción y marcas relevantes (CoinJoin, OFAC, minería, coinbase).
- El rastro es recursivo: desde cada eslabón se puede seguir bajando por sus
  propios inputs, encadenando saltos hacia atrás nivel a nivel. Funciona bajo
  demanda —cada consulta la pide el usuario, para no sobrecargar el nodo— y
  comparte una caché en memoria para no repetir transacciones ya consultadas.
  Incluye un límite de profundidad y un botón para limpiar el rastro.

### Corregido

- Detección de CoinJoin en el rastro: antes marcaba como CoinJoin cualquier
  transacción cuyo análisis mencionara la palabra (lo que ocurría siempre,
  porque existe un indicador con ese nombre aunque dé negativo), produciendo
  falsos positivos. Ahora la marca solo aparece cuando el indicador de CoinJoin
  da positivo de verdad (estructura de varios inputs y salidas de igual valor).

---

## [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

[1.0.0]: https://git.bitcointxoko.org/pikaro/txoko-dashboard