# Caudal Tus inversiones y tu bitcoin, llevados en tu casa. Caudal reúne en un solo sitio fondos, acciones, planes de pensiones, cuentas y, sobre todo, bitcoin leído desde tu propio nodo solo con la clave pública de tus monederos. Te dice cuánto vale todo y cuánto has ganado de verdad, y prepara lo que hay que declarar en España (FIFO, minería como actividad económica, territorio común y Navarra). - **Tus datos no salen de tu casa.** No hay cuenta, ni nube, ni telemetría. - **Nunca pide claves privadas.** Para bitcoin basta la clave pública o direcciones sueltas. - **Cifrado opcional** con una sola contraseña y una clave de recuperación. ## Dónde funciona - **StartOS (Start9)**: el paquete se construye desde `empaquetado/startos/` y se instala con «Sideload». Cómo, en `empaquetado/LEEME.md`. - **Umbrel**: desde la tienda de aplicaciones del autor, `https://codeberg.org/esetheyers/umbrel-apps` (en preparación). - **Docker**: `docker build -t caudal . && docker run -d -p 8080:8080 -v caudal-datos:/data caudal`. - **Tu ordenador o un USB**: Python 3.10 o posterior y `bash abrir_app.sh`. Los detalles, en `programa/LEEME.md`. En un servidor se entra con una contraseña que se crea la primera vez. En tu ordenador solo atiende en el propio equipo. ## Comprobar lo que descargas Cada versión va con un manifiesto de huellas firmado con PGP. Cómo comprobarlo, con Sparrow o con dos órdenes, en `VERIFICAR.md`. La clave del autor es `esetheyers.asc` (`esetheyers `), con esta huella: ``` 3648 41BA B31F 9D0F 3D07 5629 C34F 1F5D 7116 CA10 ``` ## Qué sale a internet Solo los precios: Caudal pregunta a fuentes públicas (Morningstar, Yahoo, CoinGecko, LS Exchange y un cambio de divisa) por los identificadores de lo que tienes, nunca por las cantidades. Bitcoin lo lee de **tu** servidor Electrum, por Tor si su dirección es `.onion`. Funciona sin conexión; lo único que deja de moverse son los precios. ## Pruebas ``` cd programa && python3 -m unittest discover -s pruebas ``` Se pasan enteras sin internet, con una cartera ficticia. ## Fallos, ideas y mejoras Abre una incidencia en este repositorio. Para enseñar un fallo usa la cartera de ejemplo que trae la aplicación: no publiques tus datos ni capturas con tus cifras. Las propuestas de código son bienvenidas; antes de una grande, abre una incidencia para comentarla. Las condiciones están en `AVISO.md`. ## Licencia AGPL-3.0 o posterior (`LICENSE`). Sin ninguna garantía: la parte fiscal es una ayuda para preparar tu declaración, no asesoría fiscal. Hecho por esetheyers con Claude (Anthropic).