Noxtr Hoja de Especificaciones

¿Qué es Noxtr?

Noxtr es un cliente Nostr web integrado en el framework 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.

Instancias y versión del protocolo

Puedes añadir y activar varias instancias Mostro (robots) en la barra de chips del tab P2P. El order book agrega las ofertas de todas las instancias activas; al crear una oferta eliges en cuál se publica.

• Cada chip muestra una etiqueta v1 (roja) o v2 (verde) con la versión del transporte que anuncia la instancia (tag protocol_version de su evento de estado, kind 38385).
• Noxtr habla exclusivamente el transporte v2 (mensajes directos NIP-44, kind 14). El transporte v1 (gift wrap) está obsoleto: las ofertas de instancias v1 se ocultan del order book y no se puede operar con ellas.
• Haciendo clic en la etiqueta v1/v2 se abre la ficha completa de la instancia: versión del daemon, límites de orden, comisión, monedas fiat aceptadas, política de fianza anti-abuso (bond), datos del nodo Lightning, etc.

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).

Se importa la identidad (misma clave y, por tanto, misma reputación acumulada). Los trades iniciados en Mostro Mobile no se recuperan automáticamente: cada interfaz gestiona sus propias sesiones de trade.

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.

Por defecto Noxtr opera en modo privacidad total (cada trade con claves efímeras, sin rastro entre trades). Si quieres acumular reputación, activa el botón ⭐ Reputación: tus trades quedan ligados a tu identidad Nostr. Requiere login con nsec local (con extensión o firmador remoto no es posible, porque la prueba de identidad exige firmar fuera del estándar de eventos).

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.

El botón Anular disputa (visible si la iniciaste tú y aún no hay admin asignado) solo la oculta de tu lista local: el protocolo Mostro no permite retirar una disputa, así que en el robot sigue abierta hasta que un admin la resuelva.

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

₿itcoin P2P on-chain — NostrEscrow

Además del flujo Lightning con Mostro, Noxtr soporta intercambios P2P on-chain /mediante NostrEscrow: los fondos se depositan en una dirección escrow Taproot 2-de-3 (comprador, vendedor y árbitro), sin robot custodio.

• Ofertas on-chain en el mismo order book (chip on-chain), con importe, método de pago y árbitros propuestos.
• Escrow Taproot: el vendedor deposita los BTC en la dirección 2-de-3; comprador y vendedor cooperan para liberar, y solo si hay conflicto interviene el árbitro.
• Árbitros: registro público de árbitros con condiciones y fianza; el operador del sitio actúa como árbitro por defecto.
• Claves propias: las claves del escrow se derivan en tu navegador (BIP-86); el servidor nunca ve claves privadas.
• Chat cifrado entre las partes, disputas con arbitraje y notificaciones del Monitor en cada paso (tomada, funding, fiat enviado/recibido, payout, disputa).

Monitor del Servidor — Notificaciones

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. Con la sesión iniciada, abre la sección /telegram de la web.
2. Pulsa el botón Vincular Telegram: en esa misma pantalla aparecerán las dos opciones siguientes, con un código de un solo uso (caduca a los 10 minutos; si caduca, vuelve a pulsar el botón).
3. Opción A — desde el móvil: pulsa el botón verde “Abrir bot en Telegram” que aparece bajo el botón de vincular. Se abre el chat del bot con el código ya incluido; basta con pulsar Iniciar.
4. Opción B — desde el ordenador: copia el comando /start CODIGO mostrado en esa misma pantalla (botón Copiar), abre Telegram, entra en el chat del bot del sitio y envíalo como mensaje.
5. El bot confirmará la vinculación. A partir de ese momento recibirás los avisos (mensajes privados nuevos, eventos de tus trades...).

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 (solo de instancias con transporte v2; las v1, obsoletas, se ignoran) y cada nueva oferta on-chain. Se puede activar/desactivar con el comando notify-new-offers on|off.

• 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.

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.