LIVECRYPTO / DOCS
De la firma en la cartera a la alerta en pantalla.
Una guía práctica del producto, las carteras aceptadas, el Creator Studio, OBS y el camino del pago. Escrita para creadores y operadores, con los límites actuales declarados sin rodeos.
EMPIEZA AQUÍ
Qué es LiveCrypto y qué no es.
LiveCrypto es una capa de donaciones para creadores en vivo. El espectador abre tu checkout público, revisa la red, el importe, la comisión y el destino, y firma una transacción en su propia cartera. El dinero va del espectador a la cartera que registraste. LiveCrypto no guarda un saldo para que lo retires.
El backend crea una intención de pago antes de la firma, verifica el resultado on-chain contra esa intención, registra la donación y encola una alerta. La alerta llega a OBS mediante un Browser Source. Cada paso está diseñado para ser visible, no mágico.
- Inicia sesión con una cartera
Una cartera EVM, Solana o Sui firma un mensaje legible. Iniciar sesión demuestra el control de la cuenta; no mueve fondos.
- Registra un destino
Guarda la dirección que debe recibir donaciones en esa red exacta. El inicio de sesión y el cobro son independientes a propósito.
- Comparte el checkout
El enlace público abre la página de donación. Mantén privado el enlace del overlay: autoriza el acceso a tus alertas.
- Conecta OBS
Añade un Browser Source, pega la URL privada del overlay y envía una alerta de prueba antes de emitir.
Reservado para un recorrido grabado por el dueño: landing, inicio de sesión, destino, checkout y alerta en OBS. Sustituye este bloque por el vídeo final; una grabación simulada nunca debe presentarse como transacción real.
Reservado para una captura real y actual del estudio con un perfil de prueba claramente identificado.
IDENTIDAD
Tres familias de cartera, un modelo de cuenta.
Una cuenta de creador puede abrirse con una cartera EVM, Solana o Sui. La interfaz descubre las carteras en el navegador y solo pide una firma. No hay contraseña, confirmación por correo ni frase semilla.
| Familia | Detectado hoy | Inicio de sesión | Dirección de cobro |
|---|---|---|---|
| EVM | MetaMask, Rabby y otras carteras inyectadas anunciadas por EIP-6963 | Mensaje EIP-4361 (SIWE) vinculado a EVM_CHAIN_ID | 0x seguido de 40 caracteres hexadecimales |
| Solana | Phantom, Solflare y Backpack, detectadas de forma independiente | Desafío firmado con nonce de un solo uso | Clave pública Base58 |
| Sui | Slush, Sui Wallet y otras carteras Wallet Standard | Firma de mensaje personal Sui (ed25519 o secp256k1) | 0x seguido de 64 caracteres hexadecimales en minúscula |
- La firma de inicio de sesión demuestra el control de la cuenta. No autoriza una transferencia.
- El backend deriva la dirección Sui de la clave pública y verifica el digest del mensaje personal; el frontend envía el texto firmado exacto de la cartera.
- El inicio de sesión EVM se rechaza cuando la cartera está en una red distinta de EVM_CHAIN_ID, cerrando una brecha de replay entre redes.
- Inicio de sesión y cobro son independientes: puedes autenticarte con una cartera y recibir en otra.
EL FLUJO PRINCIPAL
Una donación del clic a la alerta.
Una donación no es una sola firma en la cartera. Es una intención, una transacción, una verificación y una alerta. Cada etapa tiene un responsable y un estado visible, para que ni el donante ni el creador tengan que adivinar qué ocurrió.
El donante elige el importe
El checkout muestra la red, el activo, el destino del creador, la comisión de la plataforma y la comisión de red. Nada se firma en esta etapa.
| Estado del checkout | Qué significa | Qué lo resuelve |
|---|---|---|
| Pendiente | La transacción se envió, pero no está confirmada | Las confirmaciones exigidas o el timeout del verificador |
| Confirmado | Todos los campos de la intención coincidieron con el resultado on-chain | El registro en el libro y la alerta en OBS |
| Caducado | La ventana de la intención cerró antes de liquidar | Un checkout nuevo y una intención nueva |
| Rechazado | Importe, destino, memo o red no coincidieron | Ningún registro y ninguna alerta |
EL ESPACIO DE TRABAJO
Tu perfil, destinos y controles de alerta.
Creator Studio es el espacio autenticado. No es una cartera ni guarda fondos. Almacena tu perfil, destinos de cobro, preferencias de alerta y el token que usa OBS.
- Inicia sesión
Elige una cartera, conéctala y firma el mensaje. Conectar por sí solo no abre una sesión.
- Guarda un destino
Elige la red e introduce la dirección de cobro. Las direcciones reservadas de router, tesorería, cero y sistema se rechazan.
- Configura la alerta
Elige tema, posición, sonido, medios opcionales y voz. La configuración pertenece a tu perfil.
- Copia la URL privada del overlay
Úsala solo dentro de OBS. El enlace público de checkout es el que compartes con tu comunidad.
| Enlace | Dónde aparece | Quién puede usarlo |
|---|---|---|
| Checkout público | /pay/{creator} en tu sitio, bio o chat | Cualquiera con quien lo compartas |
| Overlay privado | /overlay/{token}, copiado desde Creator Studio | Solo tu Browser Source de OBS; mantenlo en secreto |
EN PANTALLA
Un Browser Source. Ningún plugin.
OBS Studio renderiza LiveCrypto como una página web normal dentro de un Browser Source. OBS mantiene la página abierta, la conexión WebSocket entrega una alerta a la vez y el overlay confirma cada alerta después de mostrarla.
- Crea un Browser Source
En tu escena, abre Fuentes, pulsa + y elige Navegador.
- Pega la URL privada
Copia el enlace del overlay desde Creator Studio. No uses aquí el enlace público de checkout.
- Ajusta el lienzo
Usa 1920 × 1080, o la resolución exacta de tu lienzo de emisión, para que el overlay no se recorte.
- Envía una alerta de prueba
Dispara la prueba en Creator Studio y observa la escena. Un comando encolado no prueba que se mostró.
URL https://tu-dominio/{locale}/overlay/{token-privado}
Ancho 1920
Alto 1080
FPS 30
Audio Controlar audio desde OBS (opcional)| Fuente separada | Añade al final de la URL | Tamaño |
|---|---|---|
| Todo junto | nada | 1920 × 1080 |
| Solo alertas | ?widget=alerts | 1920 × 1080 |
| Barra de la meta | ?widget=goal | 1000 × 170 |
| Apoyos | ?widget=ranking | 420 × 520 |
| Cinta de donaciones | ?widget=ticker | 1920 × 80 |
| Temporizador de subathon | ?widget=timer | 520 × 220 |
| Encuesta pagada | ?widget=poll | 640 × 420 |
ENTREGA
En cola, entregada, confirmada.
Una donación verificada se escribe en el libro financiero y en una outbox en la misma transacción de base de datos. Redis publica una señal de activación; no sustituye a la cola duradera. Si OBS se desconecta, las alertas siguen en cola y se reproducen cuando la fuente vuelve.
| Estado | Qué significa | Qué lo prueba |
|---|---|---|
| En cola | La donación está registrada y la alerta espera | Una fila en la outbox |
| Entregada | La fuente OBS recibió la alerta | El envío WebSocket se completó |
| Confirmada | El overlay terminó de mostrarla | Un ACK del overlay |
- Las alertas se entregan de una en una; la segunda espera en lugar de superponerse.
- Sonido, medios y voz se configuran por perfil en Creator Studio.
- Cualquier alerta anterior se puede repetir desde el historial del Studio. La repetición vuelve a aparecer en el directo, pero nunca cuenta dos veces en la meta, el ranking o los apoyos.
- El temporizador de subathon cuenta hacia atrás en el directo y cada donación confirmada suma tiempo: unos segundos fijos en cualquier red, más segundos por R$ 1 en mainnet. Las alertas de prueba y las repeticiones nunca suman tiempo.
- La encuesta pagada hace una pregunta con 2 a 5 opciones. Mientras está abierta, la página de donación muestra las opciones y cada donación confirmada que elige una vota: R$ 1 = 1 voto en mainnet, 1 voto por donación en redes de prueba. El resultado se cuenta a partir de las donaciones confirmadas, así que nada cuenta dos veces.
- Después de abrir OBS, mantén la fuente visible el tiempo suficiente para que el overlay cargue y conecte.
- Una alerta ausente se diagnostica por el estado de la outbox, no por suposiciones sobre la escena.
CAMINO DEL DINERO
No custodial por diseño, bloqueado por evidencia.
LiveCrypto no es custodial. El checkout crea una intención de pago que fotografía creador, red, destino, remitente, importe, comisión, memo y cursor de monitorización. Una transacción solo liquida cuando todos los campos coinciden.
| Vía | Estado actual | Condición |
|---|---|---|
| EVM | Ruta de código en testnet; router y tesorería deben estar configurados | DONATIONS_ENABLED=true, router desplegado, evento DonationRouted confirmado |
| Solana | Ruta de código en Devnet; transferencia nativa dividida y finalizada | DONATIONS_ENABLED=true, tesorería y genesis hash del clúster coinciden |
| Identidad Sui | Inicio de sesión y registro de cobro disponibles | SUI_NETWORK configurado; no se requiere router Move |
| Checkout Sui | Implementado; habilitado solo cuando está configurado | Paquete Move live_crypto publicado, SUI_PACKAGE_ID y SUI_TREASURY_ADDRESS |
- La comisión propuesta de la plataforma es del 2% (PLATFORM_FEE_BPS=200), mostrada aparte de la comisión de red.
- La parte del creador va al destino registrado; la comisión va a la tesorería configurada.
- La cartera del donante muestra la comisión de red antes de firmar. LiveCrypto no puede reembolsar una transferencia on-chain.
- El navegador solo recibe endpoints RPC públicos; las URL con claves de proveedor se quedan en el servidor.
ENTRADA MÓVIL
El QR abre el checkout, no una cartera.
Escribir una dirección en el teléfono es propenso a errores. La entrada móvil es un código QR que codifica la URL pública del checkout del creador. Al abrirlo se carga el mismo checkout del enlace compartido, con red, importe, comisión y destino visibles antes de firmar nada.
Un QR que solo contenga una dirección de cartera se saltaría la intención de pago, la divulgación de la comisión y la atribución de la alerta. LiveCrypto no usa un QR de dirección pura para donaciones; el checkout sigue siendo la fuente de verdad.
- Lado del creador: Creator Studio muestra el QR del checkout público junto al enlace, con descarga en PNG y SVG. Se genera en el navegador; ningún servicio externo ve la URL.
- Lado del donante: la cámara del teléfono abre el checkout; un navegador con cartera o la app de la cartera firma la transacción mostrada.
- Lado del servidor: se ejecutan la misma intención y el mismo verificador; el QR no añade confianza ni atajos.
- Los parámetros de importe o memo solo se aceptarán después de que el checkout los valide en el servidor.
https://tu-dominio/{locale}/pay/{creator}
Nunca codifiques: claves privadas, frases semilla, tokens de overlay
ni una dirección pura que omita la revisión de importe, comisión y destino.CONFIANZA
Qué protegemos y qué debes verificar.
La seguridad empieza manteniendo los secretos fuera del navegador. Las sesiones son cookies HttpOnly con SameSite=Strict, no tokens en localStorage. Los nonces son de un solo uso, las rutas de autenticación y pago tienen límite de peticiones, y las URL RPC privadas nunca salen del servidor.
- Inicia sesión solo en el dominio que esperas y lee el origen en el aviso de la cartera.
- Nunca introduzcas una frase semilla o clave privada. LiveCrypto nunca pide ninguna de las dos.
- Revisa el destino de cobro en la red exacta antes de guardarlo.
- Trata el token del overlay como una contraseña y genera otro tras compartir una captura.
- Como donante, lee red, destino, importe y comisión antes de firmar.
- Confirma si estás en la testnet o mainnet prevista; los chain IDs no son intercambiables.
- Las transferencias blockchain suelen ser irreversibles. No hay saldo de la plataforma que revertir.
EJECÚTALO TÚ MISMO
Dos procesos Node, cuatro servicios locales.
El repositorio ejecuta una API Express y una app Next.js. PostgreSQL y Redis son opcionales en modo vista previa y obligatorios para cuentas persistentes, sesiones y la cola duradera de alertas. Node.js 24 y npm son los únicos requisitos obligatorios.
.\start-dev.bat # vista previa: datos temporales, pagos desactivados
.\start-dev.bat --full # PostgreSQL + Redis en Docker, datos persistentes
.\start-dev.bat --check # páginas localizadas, API y assets, luego detiene| Servicio | URL por defecto | Notas |
|---|---|---|
| Web app | http://localhost:3000 | Next.js; 17 páginas estáticas en el build de producción |
| API | http://localhost:8080 | Express; endpoints de salud, autenticación y pago |
| PostgreSQL | localhost:5432 | Solo en modo persistente |
| Redis | localhost:6379 | Sesiones y señales de alerta |
cd backend ; npm test
cd frontend ; npm run test:i18n ; npm run lint:product ; npm run build
cd contracts ; npm testEVIDENCIA
Qué está probado y qué sigue pendiente.
El estado honesto el 5 de noviembre de 2026: las rutas de protocolo están implementadas y probadas, el build de producción pasa y el recorrido de navegador se ha ejercitado con carteras simuladas. Carteras reales, una escena real de OBS, una donación real en testnet, TLS, copias de seguridad y una auditoría independiente siguen pendientes.
| Área | Estado | Evidencia |
|---|---|---|
| Identidad Sui | Verificada en código y pruebas | Firmas ed25519 y secp256k1, digest, derivación de dirección y rechazo de manipulación |
| UI multicartera | Implementada; recorrido de navegador simulado | Cartera de prueba Wallet Standard vía CDP; el selector Solana lista tres marcas |
| Checkout EVM / Solana | Rutas de testnet; fondos reales no ejercitados | Pruebas del verificador y fixtures de RPC |
| Checkout Sui | Implementado, aún no validado en testnet | Publicación del paquete Move y una donación en testnet con billetera real |
| OBS de extremo a extremo | Pendiente | Ninguna escena real de OBS se ha ejecutado en este entorno |
| Despliegue de producción | No validado aquí | Stack Compose definido; ninguna ejecución en VPS o TLS registrada |
| Auditoría de seguridad | Pendiente | Solo pruebas automatizadas y revisión interna |
Reservado para una ejecución de extremo a extremo grabada: checkout en testnet, confirmación, registro en el libro y ACK en OBS. La grabación debe mostrar la red y la insignia de testnet en todo momento.
