Skip to content

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

89 Commits

Folders and files

Repository files navigation

Scripts Mostro

Scripts de gestión, monitorización y automatización para un nodo Mostro P2P.

Instalación rápida

git clone git@github.com:21Mill/scripts-mostro.git
cd scripts-mostro
./admin/setup.sh

El asistente interactivo te guiará para configurar todas las rutas y credenciales. Genera un archivo .env que todos los scripts leen automáticamente.

Configuración manual

Si prefieres configurar a mano:

cp .env.example .env
# Edita .env con tus valores

Los valores comentados en .env.example muestran los defaults. Solo necesitas descomentar y cambiar los que difieran en tu instalación. Las variables de Telegram y Nostr sí son obligatorias si usas los bots.

Variables de entorno

Variable Default Descripción
MOSTROD_SRC /opt/mostro Directorio de fuentes de mostrod
MOSTROD_CONFIG $MOSTROD_SRC/settings.toml Configuración de mostrod
MOSTROD_BIN /usr/local/bin/mostrod Binario de mostrod
MOSTROD_SERVICE mostro.service Servicio systemd
MOSTRIX_SRC ~/mostro-sources/mostrix Fuentes de mostrix
MOSTRIX_CONFIG ~/.mostrix/settings.toml Configuración de mostrix
MOSTRIX_BIN /usr/local/bin/mostrix Binario de mostrix
WATCHDOG_SRC ~/mostro-sources/mostro-watchdog Fuentes del watchdog
WATCHDOG_CONFIG $MOSTROD_SRC/config.toml Configuración del watchdog
WATCHDOG_BIN /usr/local/bin/mostro-watchdog Binario del watchdog
WATCHDOG_SERVICE mostro-watchdog.service Servicio systemd
SERBERO_SRC ~/mostro-sources/serbero Fuentes de serbero
SERBERO_CONFIG /etc/serbero/config.toml Configuración de serbero
SERBERO_BIN /usr/local/bin/serbero Binario de serbero
SERBERO_SERVICE serbero.service Servicio systemd
SERBERO_DB /var/lib/serbero/serbero.db Mediaciones de Serbero. Fuera de la instantánea: la lee tools/dispute.sh con sudo
BOT_SERVICE mostrobot.service Servicio del bot de Telegram
BOT_NOSTR_SERVICE mostrobot-nostr.service Servicio del bot de Nostr
ACCOUNTING_SERVICE mostro-accounting.service Servicio de contabilidad
SNAPSHOT_TIMER mostro-snapshot.timer Timer de la instantánea
BACKUP_DIR ~/mostro-sources/backups Directorio de backups
MOSTRO_DB $MOSTROD_SRC/mostro.db Base real. Solo la usa update.sh para el respaldo previo a una actualización
MOSTRO_DB_RO /var/lib/mostro-snapshot/mostro.db Instantánea de solo lectura. De aquí leen todas las consultas
MOSTRO_DISPUTES_DB_RO /var/lib/mostro-snapshot/disputes.db Instantánea de disputas
MOSTRO_LOG /var/log/mostro.log Log de mostrod. Escribe a fichero (StandardOutput=append:), así que journalctl -u mostro sale siempre vacío
TELEGRAM_TOKEN — Token del bot de ofertas
TELEGRAM_CHAT_ID — Canal público donde se publican las ofertas
TELEGRAM_TEST_CHAT_ID — Chat para test-telegram.py. Hoy apunta al canal público de ofertas
TELEGRAM_MONITOR_TOKEN — Bot para los avisos privados al operador
TELEGRAM_MONITOR_CHAT_ID — Chat privado del operador (contabilidad, monitor.sh)
TELEGRAM_STATS_TOKEN (cae a TELEGRAM_TOKEN) Bot para el resumen diario y el informe mensual
TELEGRAM_STATS_CHAT_ID — Destino de los informes. Sin respaldo: vacío = no se envía
TELEGRAM_STATS_CONFIG — config.toml del que tomar bot_token y chat_id; tiene prioridad
MOSTRO_PUBKEY — Clave pública del nodo Mostro
MOSTRO_WEB_APP https://mostro.network/app/#/order_link Base del enlace «Abrir en Mostro» que los bots añaden a cada oferta
MOSTRO_RELAY wss://relay.mostro.network,wss://relay.kilombino.com,wss://mostro-p2p.tech Relays donde leer las ofertas de Mostro, separados por comas (basta con que conteste uno)
NOSTR_BOT_NSEC (se genera automáticamente) Clave privada del bot de Nostr
NOSTR_BOT_RELAYS wss://relay.damus.io,wss://nos.lol,wss://relay.mostro.network Relays donde publicar ofertas
NOSTROMOSTRO_WEB_REPO ~/nostromostro.github.io Repo de GitHub Pages para premiums.json

Cuidado con TELEGRAM_STATS_CHAT_ID. Si está vacío, los informes no se envían y punto. No cae a TELEGRAM_TEST_CHAT_ID, que apunta al canal público de ofertas: hacerlo publicaría en abierto las cuentas de la instancia. Si no sabes qué id poner, usa bot/resolver-chat-id.py.

La instantánea de solo lectura

Casi todo lo que hay aquí consulta mostro.db, una base que pertenece al usuario mostro y vive en un directorio que solo él puede abrir. La forma evidente de resolverlo era una regla de sudo:

admin ALL=(mostro) NOPASSWD: /usr/bin/sqlite3

Y es una puerta trasera. sqlite3 interpreta meta-órdenes también cuando la consulta llega como argumento, así que .shell id da ejecución de código como mostro — el usuario que posee la nsec de la instancia. Ni siquiera -readonly lo evita: -readonly bloquea escrituras en la base, no en el sistema de ficheros, y SELECT writefile('/ruta','x') escribe desde SQL puro.

En su lugar, mostro-snapshot.timer publica cada minuto una copia legible en /var/lib/mostro-snapshot/, y las herramientas leen de ahí sin privilegio ninguno. La regla de sudo ya no existe.

Detalles que el script documenta y conviene no perder:

  • La copia se hace con .backup, la API de copia de SQLite, no con cp: las bases están en modo WAL y una copia byte a byte saldría corrupta.
  • La copia se pasa a journal_mode=DELETE. Una base en WAL no se puede abrir en solo lectura sin permiso de escritura, porque SQLite necesita crear su fichero -shm; el error (attempt to write a readonly database) parece de permisos y no lo es.
  • Para saber si la base ha cambiado se mira la fecha de .db, -wal y -shm. En modo WAL las escrituras recientes no tocan el fichero principal, así que mirar solo .db dejaría la instantánea congelada.

La excepción: la base de Serbero

$SERBERO_DB no entra en la instantánea, y no por olvido: mostro-snapshot corre como mostro y /var/lib/serbero es serbero:serbero 700, así que no puede leerla. Abrirla al grupo expondría las conversaciones privadas entre comprador y vendedor. Por eso tools/dispute.sh es la única herramienta de consulta que pide sudo — interactivo, sin regla de sudoers — y abre la base con -readonly.

Scripts

admin/setup.sh

Asistente interactivo de configuración. Pregunta las rutas, valida que existen, permite probar Telegram y genera el .env.

./admin/setup.sh

admin/update.sh

Actualización segura de componentes Mostro (mostrod, mostrix, mostro-watchdog, serbero). Descarga binarios precompilados desde GitHub Releases y verifica su integridad antes de instalar, con el método que publica cada proyecto:

Componente Verificación
mostrod, mostrix Firma GPG del manifest.txt — basta una válida, de negrunch o de arkanoider — y luego SHA256 del binario
mostro-watchdog SHA256 del binario
serbero SHA256 sobre el tarball

Si ninguna firma GPG es válida, aborta. No es un caso teórico: mostrix v0.3.8 se publicó sin ninguna firma (todas las anteriores llevan la de arkanoider), y el script se negó a instalarla, con razón.

Antes de cada actualización:

  • Hace backup del binario, la configuración y la base de datos (mostro.db)
  • Detecta si la nueva versión incluye migraciones de esquema SQLite y avisa
  • Muestra commits incluidos en la actualización y cambios en la plantilla de config

Tras instalar:

  • Verifica que el servicio arranca correctamente esperando los mensajes de conexión a LND y relays (hasta 30s)
  • Si el servicio falla, hace rollback automático al binario anterior
./admin/update.sh              # Comprobar y actualizar todos
./admin/update.sh mostrod      # Solo mostrod
./admin/update.sh mostrix      # Solo mostrix
./admin/update.sh watchdog     # Solo mostro-watchdog
./admin/update.sh serbero      # Solo serbero
./admin/update.sh --check      # Solo comprobar versiones, sin actualizar

admin/update.sh

admin/check_channels.sh

Comprueba el número de canales LND inactivos y envía una alerta por Telegram (al mismo canal que el watchdog) si se supera el umbral. Usa el bot_token y chat_id del archivo de configuración del watchdog (/opt/mostro/config.toml), sin necesidad de configuración adicional.

./admin/check_channels.sh            # Comprueba y alerta si se supera el umbral (variable THRESHOLD del script)
./admin/check_channels.sh --status   # Muestra estado sin enviar alerta

La alerta incluye el número de canales caídos, el total de canales y la lista de canales inactivos con alias y capacidad.

admin/rollback.sh

Restaura una versión anterior de cualquier componente desde los backups creados por update.sh.

./admin/rollback.sh            # Lista backups disponibles
./admin/rollback.sh mostrod    # Restaurar mostrod del último backup

admin/status.sh

Muestra el estado completo del nodo: servicios activos, versiones instaladas vs disponibles, base de datos y backups. No necesita sudo para nada: los servicios se consultan directamente y los datos salen de la instantánea, cuya antigüedad se muestra para que un timer parado se note.

./admin/status.sh

admin/status.sh

tools/order.sh

Consulta todos los datos de una orden en la base de datos de Mostro. Soporta búsqueda por UUID completo o parcial, y modos especiales para listar órdenes recientes, pendientes, en curso o estadísticas generales.

Muestra: tipo, estado, montos (incluyendo fiat final en órdenes con rango), comisiones (la fee real de Mostro y su reparto, la dev fee, el routing y el neto estimado), participantes (el creador y los master de comprador y vendedor), disputas, valoraciones, tiempos (con duración del trade) y trade index.

La base de datos guarda solo la mitad de la comisión de Mostro (la otra mitad la paga la otra parte), la dev_fee es el 30 % de la comisión entera y routing_fee va siempre a 0. Por eso la sección Comisiones no suma esos campos: enseña la comisión real, la dev fee con su estado y el coste de routing en sats enteros, leído de accounting/accounting.db (que lo calcula con LND), y con ellos el neto estimado. Si la contabilidad aún no sabe cuánto costó el routing, lo dice en vez de poner 0.

Al consultar una orden concreta añade un bloque Lightning en vivo (LND) con lo que la base de datos no guarda: el estado real de la hold invoice del vendedor (ACCEPTED = fondos bloqueados sin cobrar, SETTLED = cobrada, CANCELED = devuelta) y, sobre todo, el pago al comprador con el desglose de sus intentos de HTLC agrupados por código de fallo, la comisión de la ruta más cara intentada frente al techo que impone max_routing_fee, y un aviso si queda algún HTLC sin resolver —mientras lo haya, LND no cierra el pago y Mostro no puede reintentar—.

order.sh no muestra el hash ni el preimage que guarda la orden, ni la factura del comprador ni los contadores payment_attempts y failed_payment: el hash y el preimage son los de la hold invoice del vendedor (el pago que recibe Mostro), no los del pago de salida, y juntos en una sección se confundían con él. failed_payment solo vale 0 o 1 y payment_attempts no es el número real de intentos. El estado de la hold invoice sale en este bloque, y el pago al comprador, con todos sus intentos, en la auditoría de más abajo.

El bloque se omite sin ruido si lncli no está disponible. Cuesta ~1 s con la orden resuelta y ~4 s si hay un pago todavía en vuelo; los listados (--recent, --pending, --active, --stats) no consultan LND.

Ese bloque solo mira lnd1 (el lncli por defecto) y localiza el pago al comprador decodificando su factura, así que no sirve para los pagos hechos desde lnd2 ni para los de una Lightning Address. Para eso, en las órdenes con la hold invoice liquidada (settled-hold-invoice y success), order.sh añade la sección Auditoría del pago al comprador, que hace tools/pago.py (más abajo).

tools/pago.py

Auditoría del pago de Mostro al comprador de una orden: todos los intentos, en lnd1 y lnd2, y qué costó cada salto.

python3 tools/pago.py <order_id>          # UUID completo o su principio
python3 tools/pago.py <order_id> --json   # lo mismo, para otro script

Cada reintento del pago es un pago distinto con su propio hash, y el hash que guarda la orden es el de la hold invoice del vendedor, no el del pago de salida. Aquí se enseña, de cada intento: hora, nodo, estado, causa del fallo, hash y, en el que salió, el preimage, la comisión de routing repartida entre lo que cobra la red y lo que se queda en tus nodos, y la ruta salto a salto con el alias y la comisión de cada uno. Al final, lo que la contabilidad guardó de esa orden.

Cómo localiza el pago: por el hash de la factura del comprador si dio una; si dio una Lightning Address no hay hash, y se busca por importe (amount − fee, exacto) y fecha, y lo dice. Avisa cuando otras órdenes tienen el mismo importe en esos días (los intentos podrían mezclarse), cuando hay más de un pago completado para una orden (posible doble pago), cuando hay uno en vuelo, cuando la contabilidad no coincide con LND y cuando un nodo no responde o lnd2 no está configurado. Los criterios están en lib/auditoria.py.

Solo lee: la instantánea de Mostro, LND con macaroons de solo lectura y accounting.db. Necesita LND2_TLSCERT y LND2_MACAROON en el .env, igual que accounting.py.

./tools/order.sh <order_id>       # Consultar una orden (UUID completo)
./tools/order.sh 7361b8fe         # Buscar por UUID parcial
./tools/order.sh --recent         # Últimas 10 órdenes
./tools/order.sh --pending        # Órdenes pendientes activas
./tools/order.sh --active         # Órdenes en curso (tomadas, no finalizadas)
./tools/order.sh --stats          # Estadísticas generales (todo el historial)
./tools/order.sh --stats 7d       # Estadísticas de la última semana
./tools/order.sh --stats 30d      # Estadísticas del último mes
./tools/order.sh --stats 2026-03-01..2026-03-23  # Entre dos fechas

Periodos disponibles para --stats: today/hoy, 24h, 7d/week/semana, 30d/month/mes, 90d/trimestre, year/año, YYYY-MM-DD (desde fecha), YYYY-MM-DD..YYYY-MM-DD (rango).

tools/user.sh

Historial de órdenes de un usuario a partir de su clave pública, con su reputación y los totales por estado.

Busca por master pubkey (master_buyer_pubkey / master_seller_pubkey), que es lo que identifica a una persona entre operaciones: buyer_pubkey y seller_pubkey son claves efímeras, distintas en cada orden. Si le pasas una efímera, la resuelve a su master y avisa.

El papel de maker o taker se deduce comparando creator_pubkey con la clave efímera de cada lado, porque creator_pubkey nunca es la master.

Cuando una orden tuvo disputa, la columna DISPUTA dice cómo se resolvió, porque el estado de la orden no lo distingue: canceled-by-admin sale igual tanto si ganó el vendedor (seller-refunded, sats devueltos) como si ganó el comprador (settled, sats entregados). Esa información vive en disputes.status. Al final se añade un recuento de disputas por resolución.

./tools/user.sh <pubkey>                    # Historial completo, reputación, disputas y totales
./tools/user.sh d91a8edb                    # Por prefijo (avisa si es ambiguo)
./tools/user.sh <pubkey> --status success   # Solo un estado
./tools/user.sh <pubkey> --status dispute,canceled   # Varios
./tools/user.sh <pubkey> --status 'canceled*'        # Incluye canceled-by-admin
./tools/user.sh <pubkey> --json             # Salida JSON para encadenar con otros scripts
./tools/user.sh --top                       # Usuarios con más órdenes

tools/dispute.sh

Lee la mediación que Serbero hizo de una disputa: la conversación entre las partes, la lectura del juez y la cronología de eventos.

Hace falta porque esos mensajes no están en ningún otro sitio consultable. Serbero toma la disputa con su clave, no con la del solver, así que nunca llega a la base local de mostrix y su panel SERBERO no la muestra. Y sus mensajes (brief, transcript, final_report) viajan como DM de Nostr al solver: mostro-watchdog los descifra, pero a Telegram solo relaya el estado (mediating, handed off: facts_gathered), nunca el contenido.

La salida marca con una línea dónde ocurrió el handoff. Importa: Serbero cierra la recogida de hechos en cuanto cree tenerlos, y lo que las partes digan después ya no entró en su valoración.

./tools/dispute.sh                  # Últimas mediaciones
./tools/dispute.sh a1b2c3d4         # Conversación completa (basta el prefijo)
DISPUTE_LIMIT=50 ./tools/dispute.sh

Pide la contraseña de sudo para la consulta, que se ejecuta como el usuario serbero, dueño de la base: $SERBERO_DB es serbero:serbero 700, así que un usuario normal no puede ni comprobar si el fichero existe, y hacer esa comprobación sin permiso daba un «no existe» engañoso. Solo se eleva la consulta, nunca el script entero.

Si una disputa no tiene sesión, lo dice: significa que Serbero no la medió, no que falte el dato.

tools/report.sh

Genera un informe financiero de la actividad del nodo: volumen de trading, flujo de sats, ingresos, disputas y tendencia diaria con gráfico ASCII.

./tools/report.sh              # Últimos 30 días (default)
./tools/report.sh today        # Hoy
./tools/report.sh week         # Últimos 7 días
./tools/report.sh month        # Últimos 30 días
./tools/report.sh year         # Último año
./tools/report.sh all          # Todo el historial
./tools/report.sh 2026-03-01 2026-03-31  # Rango de fechas

tools/logs.sh

Busca y formatea logs de Mostro por order ID. Usa journalctl por defecto o un archivo de log si MOSTRO_LOG está configurado.

./tools/logs.sh a179dca3

tools/logs.sh

tools/monitor.sh

Monitoriza una transacción Bitcoin hasta su confirmación y notifica por Telegram al chat privado del operador.

./tools/monitor.sh <txid>

accounting/accounting.py

Servicio de contabilidad. Sondea la instantánea cada 60 s buscando órdenes que pasan a success, calcula el beneficio neto real y avisa por Telegram al chat privado, operación a operación. El aviso lleva el id de la orden como UUID dentro de <code>, para copiarlo con un toque.

neto = (fee × 2) − dev_fee − routing_comprador − routing_devs     (solo lo que cobra la red)

El × 2 no es un error: Mostro registra en la base solo el 50 % de la comisión real.

Cómo se averigua el routing (lib/lnd.py):

  • Se consultan todos los nodos desde los que Mostro paga: lnd1 con el lncli por defecto y lnd2 si están LND2_TLSCERT y LND2_MACAROON. Sin lnd2 configurado, los pagos hechos desde él quedan pendientes en vez de contarse como 0.
  • El pago al comprador se localiza por el payment_hash de su factura. Si dio una Lightning Address no hay factura que decodificar: se busca por importe (amount − fee, que coincide exactamente) y fecha. Con varios candidatos que cuestan distinto no se elige ninguno; si cuestan lo mismo, da igual cuál sea.
  • El pago de la comisión de desarrollo se localiza por su payment_hash. Se paga unos segundos después de liquidar, o días después si el servidor de la Fundación no responde, así que la operación se actualiza cuando aparece, sin segundo aviso.
  • Todo se guarda en milisatoshis: fee_sat de LND trunca, y con comisiones de pocos sats el error sería del tamaño del dato. Los totales redondean una sola vez, al final.
  • Cada pago se descompone por saltos: lo que cobran tus propios nodos entre sí se guarda como coste interno, se muestra aparte y no resta del neto; lo que cobra la red sí.
  • Lo que no se puede averiguar queda pendiente y se reintenta cada 10 minutos durante 30 días. Nunca se da por 0. Una pendiente cuyo coste de comprador ya se conoce cuenta en el neto como provisional (solo le falta ~1 sat de la comisión de desarrollo), y los informes avisan de cuántas son.

Guarda una fila por operación en accounting/accounting.db, que no se versiona.

python3 accounting/accounting.py     # normalmente vía mostro-accounting.service

Acceso de solo lectura a lnd2. El usuario que ejecuta el servicio no puede leer /data/lnd2. Se crea un macaroon que solo lee pagos e información y se copia el certificado (es público):

mkdir -p ~/.lnd2-ro && chmod 700 ~/.lnd2-ro
sudo -u lnd2 lncli --lnddir=/data/lnd2 --rpcserver=127.0.0.1:10010 \
  bakemacaroon offchain:read info:read --save_to=/tmp/lnd2-ro.macaroon
sudo install -o admin -g admin -m 600 /tmp/lnd2-ro.macaroon ~/.lnd2-ro/readonly.macaroon
sudo rm /tmp/lnd2-ro.macaroon
sudo install -o admin -g admin -m 644 /data/lnd2/tls.cert ~/.lnd2-ro/tls.cert

Y en el .env: LND2_TLSCERT=/home/admin/.lnd2-ro/tls.cert y LND2_MACAROON=/home/admin/.lnd2-ro/readonly.macaroon.

accounting/migrar-routing.py

Recalcula con datos de LND el routing de las operaciones ya contabilizadas, con las reglas de arriba. Por defecto solo simula: enseña, mes a mes, el neto y el routing antes y ahora, y cuántas operaciones quedan sin resolver, sin escribir nada.

python3 accounting/migrar-routing.py             # simulación
sudo systemctl stop mostro-accounting            # antes de aplicar: escribiría a la vez
python3 accounting/migrar-routing.py --aplicar   # copia accounting.db.pre-routing-<fecha> y escribe
sudo systemctl start mostro-accounting

Es repetible. Una fila que no se pueda resolver y tenga menos de 30 días queda pendiente; una de más de 30 días conserva sus valores antiguos, marcada sin_datos.

accounting/informe-mensual.py

Informe financiero mensual al chat privado: ganancia neta con su equivalente en euros, número de operaciones, volumen, desglose (fee cobrado, dev fee y routing) y comparativa con el mes anterior. Agrega accounting.db, que ya tiene el neto calculado.

Se envía también cuando el mes no ha tenido ninguna operación: el silencio no distingue «mes vacío» de «el cron ha fallado».

python3 accounting/informe-mensual.py                      # el mes anterior
python3 accounting/informe-mensual.py --mes 2026-04        # un mes concreto
python3 accounting/informe-mensual.py --mes 2026-04 --dry-run
python3 accounting/informe-mensual.py --force              # aunque ya se enviara

bot/premiums.sh

Genera data/premiums.json con los premiums anonimizados, lo sube a GitHub Pages y llama a resumen.py. Se ejecuta cada noche vía cron.

./bot/premiums.sh

bot/resumen.py

Resumen diario agregado en Telegram: trades y premium medio de las últimas 24 h y de los últimos 30 días, precio BTC/EUR y métodos de pago más usados. Si no hubo trades en 24 h, no envía nada.

Esa parte se alimenta de data/premiums.json —el mismo fichero anonimizado que ya sirve la web— y no de la base de datos: nada de lo que salga de ahí puede revelar algo que no esté ya publicado.

Bloque de cuentas. Al final del mensaje se añaden las cuentas del día recién cerrado leídas de accounting/accounting.db: ganancia neta (con su equivalente en euros), volumen intercambiado, número de operaciones, desglose de fee, dev fee y routing, y el acumulado del mes en curso. La ventana es el día natural en hora local, el mismo criterio que las barras del gráfico de la web y que el informe mensual —de ahí que el encabezado lleve la fecha, para no confundirlo con la cifra de 24 h móviles que aparece más arriba en el mismo mensaje.

Eso es información privada, así que solo se incluye si el destino se verifica privado: un id numérico y positivo, que es como Telegram identifica a una persona —los grupos y canales son negativos—, y que además no sea el TELEGRAM_CHAT_ID del canal de ofertas. Reapuntar el resumen a un canal hace que el bloque desaparezca, no que se publique. Si accounting.db no está disponible, se avisa por stdout y el resto del resumen sale igual: una avería de la contabilidad no debe costarnos también el resumen.

python3 bot/resumen.py --dry-run    # imprime el mensaje sin enviarlo
python3 bot/resumen.py --force      # envía aunque ya se enviara hoy

bot/resolver-chat-id.py

Averigua a qué chats puede escribir el bot y muestra sus identificadores, para copiar el que corresponda a TELEGRAM_STATS_CHAT_ID. Escríbele algo al bot antes de ejecutarlo.

python3 bot/resolver-chat-id.py

bot/bot.py

Bot que escucha nuevas ofertas en el relay de Mostro y las publica en un canal de Telegram. Cuando una oferta es tomada, cancelada o expira, el mensaje se borra automáticamente del canal.

Cada mensaje lleva un enlace Abrir en Mostro que abre esa oferta en el cliente web, lista para tomar. No se construye aquí: sale de la etiqueta source que mostrod escribe en las ofertas pending (mostro:<id>?relays=…&mostro=<nodo>), y solo se acepta si apunta a esa misma orden y a MOSTRO_PUBKEY, porque el bot no verifica firmas. Un nodo anterior a mostrod 0.19.0 no escribe la etiqueta y el mensaje sale sin enlace.

El URI mostro: no vale directamente en Telegram: la API lo acepta, pero el cliente descarta el href y deja un texto muerto. De ahí el rodeo por el cliente web, que además sirve a quien no tiene la app instalada. Para abrir la app nativa haría falta una página propia que rebote al esquema, y entonces solo cambiaría MOSTRO_WEB_APP.

Las firmas de los eventos

Todo lo que entra por un relay se verifica antes de mirarlo siquiera. El filtro authors de la suscripción no sirve de nada por sí solo: lo aplica el relay, que es de quien se desconfía, así que sin comprobar firmas un relay hostil podría fabricar ofertas enteras —importes, divisa, métodos de pago, premium— y publicarlas en el canal con nuestra marca.

evento_autentico() hace tres comprobaciones y las tres hacen falta. Que el autor sea MOSTRO_PUBKEY. Que el id recalculado a partir de los datos coincida con el que trae el evento: la firma va sobre el id, de modo que verificarla sola dejaría pasar un par (id, firma) auténtico con el contenido sustituido. Y la firma Schnorr sobre ese id ya comprobado, con coincurve, que envuelve libsecp256k1.

El id se serializa con ensure_ascii=False, que no es un detalle: un método de pago con una tilde o un emoji daría otro hash y el evento, siendo auténtico, se rechazaría.

Hay dos puertas, las dos en bot/common.py: _consultar() para la puesta al día y al_recibir() para el directo. En el directo se descarta antes de filtro_novedades, porque esa función apunta los ids que ve y un evento falso podría envenenar esa memoria.

Un relay que contesta con eventos y ninguno es válido se trata como si no hubiera contestado, no como si no hubiera ofertas. La diferencia es el canal entero: con una lista vacía, obtener_pending vería cero pending y reconciliar retiraría todos los mensajes publicados. Una lista vacía de verdad, porque no había nada, sigue siendo legítima.

MOSTRO_PUBKEY tiene que estar en hexadecimal de 64 caracteres. Con un npub no se validaría ni un evento, así que common.py lo comprueba al arrancar en vez de dejar que el canal se quede mudo sin explicación.

Dependencias: pip install websocket-client requests python-dotenv coincurve

python3 bot/bot.py
python3 bot/bot.py --dry-run    # enseña qué publicaría y qué retiraría

bot/bot-nostr.py

Bot que publica las ofertas como notas (kind 1) en Nostr desde un pubkey dedicado. Cuando una oferta deja de estar pendiente, envía un evento de borrado (NIP-09, kind 5). Si no existe un NOSTR_BOT_NSEC en el .env, genera las claves automáticamente.

Dependencias: pip install websocket-client pynostr python-dotenv coincurve (pynostr ya arrastra coincurve, pero conviene que esté dicho.)

python3 bot/bot-nostr.py
python3 bot/bot-nostr.py --dry-run

bot/test-telegram.py

Comprueba que las credenciales de Telegram funcionan, publicando en TELEGRAM_TEST_CHAT_ID, que hoy apunta al canal público de ofertas —la misma advertencia de la tabla de variables—. Antes de enviar consulta getChat e imprime adónde va; si el destino no es privado se niega, y hay que repetir con --si-es-publico. Para probar en privado, apunta esa variable a un chat tuyo o usa el par TELEGRAM_MONITOR_*.

python3 bot/test-telegram.py

Arquitectura

lib/ contiene lo que comparten todos los scripts de Python, y nada de Nostr: así los scripts de contabilidad, que se ejecutan desde cron, no arrastran websocket ni pynostr solo para formatear un número.

Módulo Contiene
lib/entorno.py Localiza y carga el .env, siempre por ruta absoluta
lib/formato.py Cifras y fechas con las convenciones españolas (formato_sats, formato_msat, formato_euros, con_signo, fecha_larga)
lib/estado.py Persistencia en JSON del estado de cada script
lib/telegram.py Envío y borrado de mensajes, y lectura de credenciales de un config.toml
lib/contabilidad.py Consultas de solo lectura sobre accounting.db y las ventanas de día y mes en hora local
lib/lnd.py Localiza en LND los pagos de Mostro (lnd1 y lnd2) y reparte su coste entre red y nodos propios
lib/ganancias.py Esquema de accounting.db, cálculo del neto y guardado de cada operación
lib/auditoria.py Reconstruye el pago al comprador de una orden con todos sus intentos y lo presenta; lo usa tools/pago.py

lib/contabilidad.py es lo que mantiene cuadradas las dos vistas de las mismas cuentas: el informe mensual y el bloque diario del resumen usan la misma consulta y el mismo criterio de día local, y solo se diferencian en la ventana que le pasan.

bot/common.py es el módulo del relay: conexión con reconexión automática, parseo de eventos kind 38383 y el texto de una oferta (HTML para Telegram, plano para Nostr).

La reconciliación (obtener_pending + reconciliar) merece una nota. Los bots retiraban una oferta solo al ver en directo su evento de cambio de estado, así que todo lo ocurrido mientras estaban parados no se retiraba nunca; y una oferta que caduca por NIP-40 no emite ningún evento, de modo que en directo es indetectable por definición. Al arrancar se compara lo publicado con el estado real del relay y se corrige en ambos sentidos. obtener_pending devuelve None cuando el relay no contesta, y no un diccionario vacío: confundir «no queda ninguna oferta» con «no me han contestado» vaciaría el canal entero durante una caída del relay.

Servicios systemd

Las unidades están versionadas en systemd/, con las rutas de este nodo. Para otro directorio o usuario, ajústalas antes de instalar:

sed -i 's|/home/admin/mostro-sources/scripts|/tu/ruta|g; s|^User=admin|User=tuusuario|' systemd/*.service
sudo cp systemd/* /etc/systemd/system/
sudo install -m 755 bin/mostro-snapshot /usr/local/bin/
sudo mkdir -p /var/lib/mostro-snapshot && sudo chown mostro:admin /var/lib/mostro-snapshot
sudo chmod 2750 /var/lib/mostro-snapshot     # setgid: los ficheros heredan el grupo
sudo systemctl daemon-reload
sudo systemctl enable --now mostrobot mostrobot-nostr mostro-accounting mostro-snapshot.timer

El 2750 no es cosmético: sin el bit setgid, las instantáneas que crea mostro nacen con grupo mostro y el usuario que consulta no puede leerlas.

Unidad Qué ejecuta
mostrobot.service bot/bot.py — ofertas en Telegram
mostrobot-nostr.service bot/bot-nostr.py — ofertas en Nostr
mostro-accounting.service accounting/accounting.py — contabilidad en tiempo real
mostro-snapshot.service + .timer bin/mostro-snapshot — instantánea cada minuto

serbero.service no está versionado aquí: corre como su propio usuario serbero y recibe la clave privada por LoadCredential, no por el .env. ./admin/update.sh serbero sí lo actualiza.

Cron

# Datos de la web y resumen diario en Telegram
0 0 * * * /home/admin/mostro-sources/scripts/bot/premiums.sh >> /home/admin/mostro-premiums.log 2>&1

# Alerta de canales LND caídos
*/10 * * * * /home/admin/mostro-sources/scripts/admin/check_channels.sh >> /var/log/check_channels.log 2>&1

# Informe financiero del mes recién cerrado
30 0 1 * * /usr/bin/python3 /home/admin/mostro-sources/scripts/accounting/informe-mensual.py >> /home/admin/informe-mensual.log 2>&1

Tests

Sin framework: cada test es un script suelto con asserts, ejecutable tal cual en el servidor. run-tests.sh los encadena y añade una comprobación de sintaxis de todos los .py y .sh.

./run-tests.sh

Estructura

.
├── .env.example            # Plantilla de configuración
├── .gitignore              # Excluye .env, logs, bases, orders, estado y copias .bak
├── run-tests.sh            # Lanza todas las comprobaciones
├── images/                 # Capturas de pantalla
├── lib/
│   ├── entorno.py          # Carga del .env por ruta absoluta
│   ├── formato.py          # Formateo de cifras y fechas
│   ├── estado.py           # Persistencia JSON
│   ├── telegram.py         # Envío por Telegram
│   ├── contabilidad.py     # Consultas sobre accounting.db y ventanas locales
│   ├── lnd.py              # Pagos de Mostro en LND y reparto de su coste
│   ├── ganancias.py        # Esquema, neto y guardado de accounting.db
│   ├── auditoria.py        # Reconstrucción y presentación del pago al comprador
│   ├── test-lib.py         # Comprobaciones de lib/
│   ├── test-routing.py     # Comprobaciones del cálculo de routing
│   └── test-auditoria.py   # Comprobaciones de la auditoría del pago
├── admin/
│   ├── env.sh              # Configuración y helpers compartidos (sql_ro, telegram_enviar)
│   ├── setup.sh            # Asistente de configuración interactivo
│   ├── status.sh           # Estado del nodo
│   ├── update.sh           # Actualización de componentes (GPG+SHA256, backup BD, rollback)
│   ├── rollback.sh         # Rollback de componentes
│   └── check_channels.sh   # Alerta Telegram si hay demasiados canales LND caídos
├── tools/
│   ├── order.sh            # Consulta de órdenes
│   ├── pago.py             # Auditoría del pago al comprador (intentos, ruta, comisiones)
│   ├── user.sh             # Historial y reputación de un usuario
│   ├── dispute.sh          # Mediación de Serbero: conversación y veredicto
│   ├── report.sh           # Informe financiero de actividad
│   ├── logs.sh             # Búsqueda en logs
│   └── monitor.sh          # Monitor de transacciones BTC
├── accounting/
│   ├── accounting.py       # Contabilidad en tiempo real (servicio)
│   ├── migrar-routing.py   # Recalcula el routing del histórico (simula por defecto)
│   └── informe-mensual.py  # Informe financiero mensual
├── bot/
│   ├── premiums.sh         # Generador de datos para GitHub Pages
│   ├── bot.py              # Bot de ofertas para Telegram
│   ├── bot-nostr.py        # Bot de ofertas para Nostr
│   ├── common.py           # Módulo del relay de Mostro
│   ├── resumen.py          # Resumen diario agregado
│   ├── resolver-chat-id.py # Ayuda a averiguar un chat_id
│   ├── test-telegram.py    # Test de credenciales de Telegram
│   ├── test-reconciliacion.py
│   └── test-resumen.py     # Guardia de destino y bloque de cuentas
├── systemd/                # Unidades systemd versionadas
└── bin/
    └── mostro-snapshot     # Instantánea de solo lectura de las bases

About

No description, website, or topics provided.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages