Noxtr Hoja de Especificaciones

¿Qué es Noxtr?

Noxtr es un cliente Nostr web integrado en el framework PHP ExtFW. Funciona como un módulo dentro de un sitio web auto-alojado, combinando el acceso al protocolo Nostr con funcionalidades del servidor como cuentas de usuario, hosting de direcciones Lightning y verificación de identidad NIP-05.

Está diseñado como una aplicación de página única sin frameworks JavaScript externos — vanilla JS con un helper DOM ligero (wquery).

Características Clave

Soporte de NIPs

Posibilidades de Implementación de Nostr (NIPs) soportadas por Noxtr:

Tipos de Evento (Kinds)

Resumen de Funcionalidades

Comparativa de Clientes

Una comparación imparcial de Noxtr frente a clientes Nostr establecidos. Cada cliente tiene fortalezas diferentes — esta tabla pretende ser factual, no promocional.

General

Soporte de NIPs Principales

Funcionalidades

Limitaciones Conocidas (no por mucho tiempo)

Áreas donde Noxtr está por detrás de otros clientes:

• NIP-72/29 (Comunidades/Grupos) — Sin soporte para comunidades moderadas ni grupos basados en relays.
• NIP-51 (Listas) — Sin sincronización de listas en relay. Mute, favoritos y canales fijados son locales (BD del servidor). No interoperables con otros clientes.
• NIP-78 (App data) — Sin persistencia de preferencias de UI en relays (kind 30078). Ajustes solo locales en BD del servidor.
• NIP-35 (Torrents) — Sin soporte para marketplace de torrents (kinds 2003/2004). Potencial sinergia con el espíritu P2P/Bitcoin de Noxtr.
• Múltiples cuentas — Sin selector de cuentas instantáneo. El cambio de cuenta requiere logout y nuevo login, pero es posible.
• Modelo outbox — Sin enrutamiento de relays por usuario. Todas las suscripciones van al pool de relays configurado.
• Sin app nativa — Solo web, pero funciona en móvil vía navegador y soporta “Añadir a pantalla de inicio” para experiencia app-like. Sin notificaciones push.

Fortalezas Distintivas

• Identidad auto-alojada — NIP-05 y direcciones Lightning servidas desde tu propio dominio, auto-configuradas.
• Frontend sin dependencias — Sin npm, sin herramientas de build, sin framework. Despliegue copiando archivos.
• Transferencias internas de zaps — Los usuarios registrados pueden hacer zaps entre sí sin comisiones de la red Lightning.
• Canales NIP-28 — Uno de los pocos clientes web con soporte completo de chat público (crear, unirse, fijar, enlaces de invitación, eliminar mensajes propios).
• Artículos NIP-23 — Contenido largo integrado en el feed principal con deduplicación de eventos reemplazables, renderizado Markdown y compositor dedicado con título/resumen/imagen.
• Filtrado de feed por temas — Suscríbete a hashtags y filtra tu feed global sin necesidad de seguir usuarios específicos.
• Renderizado de perfiles AR mesh — El único cliente Nostr que parsea y renderiza broadcasts de perfiles de colaboración AR/mesh como tarjetas visuales.
• Detección de dominios caídos — Detecta automáticamente y gestiona con gracia CDNs de imágenes caídos con reintento a las 24h.
• NIP-46 con QR + persistencia — Flujo completo de Nostr Connect con código QR, persistencia en localStorage entre sesiones.
• Lightning en el servidor — Endpoint LNURL-pay con integración BTCPay y keypair del servidor auto-generado para recibos de zap.
• Bitcoin P2P integrado (Mostro / NIP-69) — El único cliente Nostr web con soporte nativo para comprar Bitcoin P2P a través del protocolo Mostro, con flujo guiado paso a paso y explicaciones didácticas por orden — pensado para novatos.

₿itcoin P2P — Mostro

Noxtr incluye soporte nativo para Mostro, un protocolo de intercambio de Bitcoin entre pares (P2P) que funciona sobre Nostr. Puedes comprar o vender Bitcoin directamente con otras personas, sin inter/mediarios ni custodios, pagando con transferencia bancaria, Bizum, efectivo o cualquier otro método acordado.

El tab P2P ₿ en la barra de navegación te da acceso al order book en tiempo real con todas las ofertas disponibles.

Cómo comprar Bitcoin (paso a paso)

No necesitas ninguna experiencia previa con Bitcoin. Solo necesitas una wallet Lightning en el móvil (Phoenix, Breez, Zeus, Wallet of Satoshi…).

1. Abre el tab P2P ₿ — Verás una lista de ofertas de venta con importe, moneda y método de pago.
2. Elige una oferta que se adapte a ti (importe, método de pago) y pulsa Comprar.
3. Introduce tu Lightning Address (ej. usuario@wallet.com) o una factura bolt11 generada desde tu wallet — ahí es donde recibirás los sats.
4. El robot entra en acción: bloquea los Bitcoin del vendedor y te notifica cuánto debes pagar en fiat y cómo.
5. Envía el dinero al vendedor por el método indicado (transferencia, Bizum, etc.) y pulsa Fiat enviado.
6. El vendedor confirma que ha recibido el pago fiat y pulsa Liberar sats.
7. ¡Listo! Los sats llegan a tu wallet Lightning. El trade aparece como completado en la ficha.

Si la wallet del vendedor o el nodo del robot no puede enrutar el pago a tu dirección, la ficha del trade mostrará un campo para introducir otra dirección Lightning alternativa. Tus sats están siempre a salvo con el robot.

Cómo vender Bitcoin

1. Pulsa Nueva orden en el tab P2P ₿ y elige Vender BTC.
2. Configura la oferta: importe en fiat, moneda, método de pago aceptado y tipo de importe (fijo o rango).
3. Publica la orden. Aparecerá en el order book para que otros la tomen.
4. Cuando alguien la toma, el robot te envía una hold invoice (factura retenida). Págala desde tu wallet Lightning — los sats quedarán bloqueados, no cobrados, hasta finalizar el trade.
5. Da al comprador los datos de pago y espera a recibir el dinero fiat por el método acordado.
6. Cuando llegue el dinero fiat, pulsa Liberar sats. El robot los enviará al comprador.

Importar identidad desde Mostro Mobile

Si ya usas la app Mostro Mobile, puedes importar tu identidad en Noxtr sin crear una cuenta nueva:

1. En la pantalla de login de Noxtr, pulsa 📲 Mostro Mobile.
2. Introduce tus 12 palabras semilla (la misma frase que usas en Mostro Mobile).
3. Noxtr derivará tu clave privada Nostr usando el mismo estándar que Mostro Mobile (BIP39 + BIP32, ruta m/44'/1237'/38383'/0/0).
4. Tus trades activos se recuperarán automáticamente enviando un mensaje restore al robot.

Los trades terminados (cancelados o completados) no se recuperan porque el robot no los rastrea. El historial pasado solo está disponible si las 12 palabras y la interfaz son las mismas que iniciaron esos trades.

Reputación y valoraciones

Al completar un trade puedes valorar a la contraparte de 1 a 5 estrellas. Las valoraciones recibidas aparecen en tu ficha de reputación (⭐ promedio · número de trades). Los robots Mostro publican la reputación acumulada de cada usuario en sus órdenes del order book.

Disputas

Si algo va mal en un trade en estados activo o fiat_enviado (la contraparte no responde, no envía el dinero, niega haber recibido un pago confirmado…), puedes iniciar una disputa. La disputa la resuelve un administrador humano del robot Mostro.

1. Pulsa Disputar en la ficha del trade. El botón aparece junto a las acciones cuando el trade está en activo o fiat_enviado.
2. Confirma. Tu cliente envía la acción dispute al robot.
3. El robot publica la disputa y notifica a la contraparte. Tu trade pasa a estado disputado con un identificador de disputa visible en la ficha.
4. Espera a que un admin la tome. Cuando ocurra, recibirás la acción admin-took-dispute y aparecerá un nuevo recuadro de chat directo con el admin debajo de la ficha del trade.
5. Resuelve con el admin. El chat es independiente del chat con la contraparte y está cifrado con una clave compartida derivada específicamente entre tu trade key y la pubkey del admin.
6. Veredicto del admin. El admin puede liberar los sats al comprador (admin-settle-dispute) o cancelar la disputa devolviéndolos al vendedor (admin-cancel-dispute). El trade se cierra automáticamente.

Si quieres retirar tu propia disputa antes de que un admin la tome, pulsa Anular disputa. Después ya no puedes — solo el admin decide.

Si la contraparte solicita cancelación cooperativa de un trade activo y no estás de acuerdo, puedes Disputar en lugar de aceptar la cancelación.

Listado de tus disputas en /noxtr/disputes: muestra ID de disputa, estado público (initiated / in-progress), iniciador, admin asignado y última actualización.

Para administradores — Mostro P2P

Monitor del Servidor — Notificaciones y Auto-take

El Monitor es un proceso PHP que corre en el servidor en segundo plano y vigila los trades Mostro activos aunque ningún usuario tenga la web abierta. Escucha los relays Nostr continuamente y actúa cuando recibe eventos relevantes.

Para usuarios — ¿Qué hace el Monitor por ti?

Si el administrador del sitio tiene el Monitor activo, recibirás avisos automáticos cuando ocurra algo en tus trades:

Cada notificación se envía una sola vez por trade y tipo de evento — no hay spam.

Vincular Telegram para recibir avisos

1. Ve a la sección Telegram de la web.
2. Pulsa Vincular Telegram.
3. Desde el móvil: pulsa el enlace “Abrir bot en Telegram” — se abre directamente el chat del bot y basta con pulsar Iniciar.
4. Desde el ordenador: copia el comando /start CODIGO que aparece en pantalla y pégalo en el chat del bot en Telegram.
5. El bot confirmará la vinculación. A partir de ese momento recibirás avisos de mensajes privados nuevos en Noxtr.

Para administradores — Arrancar y parar el Monitor

El Monitor se gestiona desde el panel de administración web (/noxtr/server_admin) con los botones Start / Stop / Status, o directamente desde la consola del servidor:

php /ruta/index.php noxtr/server/action=monitor --verbose

Para dejarlo corriendo en background:

nohup php /ruta/index.php noxtr/server/action=monitor > /var/log/monitor.log 2>&1 &

Para administradores — Comandos de control por DM Nostr

El Monitor tiene su propia identidad Nostr. Los administradores autorizados pueden enviarle DMs con comandos de texto plano desde cualquier cliente Nostr (incluyendo Noxtr). Su npub aparece en el mensaje de arranque y en el panel web.

Para administradores — Notificaciones de nuevas órdenes

Además de vigilar trades propios, el Monitor notifica al administrador cada nueva orden que aparece en el order book Mostro:

• DM Nostr al npub del administrador con un resumen de la orden.
• Telegram con todos los detalles: ID, tipo (BUY/SELL), importe, método de pago y antigüedad del robot.
• Email con la misma información en formato HTML.

Para recibir notificaciones de nuevas órdenes por Telegram, el administrador debe tener el bot vinculado y su pubkey Nostr añadida a admin_pubkeys en la configuración del Monitor.

Para administradores — Auto-take

El Monitor puede tomar órdenes automáticamente cuando coincidan con reglas configuradas. Es útil para situaciones como “tomar siempre órdenes de robots de 0 días” o “tomar siempre órdenes de exactamente 88 EUR”.

El auto-take es efímero: el Monitor genera un keypair temporal, toma la orden y notifica al admin, pero no crea un trade persistente en la base de datos. El seguimiento posterior del trade debe hacerse manualmente desde otro cliente Mostro.

Arquitectura Técnica

Backlog — Ideas y Mejoras Futuras

Funcionalidades en cola sin fecha definida. La fuente canónica vive en _modules_/noxtr/BACKLOG.md dentro del repositorio.