Scripts de gestión, monitorización y automatización para un nodo Mostro P2P.
git clone git@github.com:21Mill/scripts-mostro.git
cd scripts-mostro
./admin/setup.shEl asistente interactivo te guiará para configurar todas las rutas y credenciales. Genera un archivo .env que todos los scripts leen automáticamente.
Si prefieres configurar a mano:
cp .env.example .env
# Edita .env con tus valoresLos 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.
| 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 aTELEGRAM_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, usabot/resolver-chat-id.py.
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 concp: 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,-waly-shm. En modo WAL las escrituras recientes no tocan el fichero principal, así que mirar solo.dbdejaría la instantánea congelada.
$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.
Asistente interactivo de configuración. Pregunta las rutas, valida que existen, permite probar Telegram y genera el .env.
./admin/setup.shActualizació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 actualizarComprueba 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 alertaLa alerta incluye el número de canales caídos, el total de canales y la lista de canales inactivos con alias y capacidad.
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 backupMuestra 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.shConsulta 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).
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 scriptCada 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 fechasPeriodos 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).
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 órdenesLee 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.shPide 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.
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 fechasBusca 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 a179dca3Monitoriza una transacción Bitcoin hasta su confirmación y notifica por Telegram al chat privado del operador.
./tools/monitor.sh <txid>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:
lnd1con ellnclipor defecto ylnd2si estánLND2_TLSCERTyLND2_MACAROON. Sinlnd2configurado, los pagos hechos desde él quedan pendientes en vez de contarse como 0. - El pago al comprador se localiza por el
payment_hashde 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_satde 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
pendientey 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.serviceAcceso 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.certY en el .env: LND2_TLSCERT=/home/admin/.lnd2-ro/tls.cert y
LND2_MACAROON=/home/admin/.lnd2-ro/readonly.macaroon.
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-accountingEs 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.
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 enviaraGenera 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.shResumen 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 hoyAverigua 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.pyBot 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.
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íaBot 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-runComprueba 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.pylib/ 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.
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.timerEl 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.
# 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>&1Sin 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.
├── .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


