LIVECRYPTORECEIVE ANYWHERE_

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.

VISTA PREVIA DE DESARROLLOActualizado el 5 de noviembre de 2026

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.

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

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

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

  4. Conecta OBS

    Añade un Browser Source, pega la URL privada del overlay y envía una alerta de prueba antes de emitir.

ESPACIO PARA VÍDEO DEL DUEÑOTour de dos minutos por el producto

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.

ESPACIO PARA CAPTURAVista general del Creator Studio

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.

FamiliaDetectado hoyInicio de sesiónDirección de cobro
EVMMetaMask, Rabby y otras carteras inyectadas anunciadas por EIP-6963Mensaje EIP-4361 (SIWE) vinculado a EVM_CHAIN_ID0x seguido de 40 caracteres hexadecimales
SolanaPhantom, Solflare y Backpack, detectadas de forma independienteDesafío firmado con nonce de un solo usoClave pública Base58
SuiSlush, Sui Wallet y otras carteras Wallet StandardFirma 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ó.

01 / IMPORTE

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 checkoutQué significaQué lo resuelve
PendienteLa transacción se envió, pero no está confirmadaLas confirmaciones exigidas o el timeout del verificador
ConfirmadoTodos los campos de la intención coincidieron con el resultado on-chainEl registro en el libro y la alerta en OBS
CaducadoLa ventana de la intención cerró antes de liquidarUn checkout nuevo y una intención nueva
RechazadoImporte, destino, memo o red no coincidieronNingú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.

  1. Inicia sesión

    Elige una cartera, conéctala y firma el mensaje. Conectar por sí solo no abre una sesión.

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

  3. Configura la alerta

    Elige tema, posición, sonido, medios opcionales y voz. La configuración pertenece a tu perfil.

  4. Copia la URL privada del overlay

    Úsala solo dentro de OBS. El enlace público de checkout es el que compartes con tu comunidad.

EnlaceDónde apareceQuién puede usarlo
Checkout público/pay/{creator} en tu sitio, bio o chatCualquiera con quien lo compartas
Overlay privado/overlay/{token}, copiado desde Creator StudioSolo 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.

  1. Crea un Browser Source

    En tu escena, abre Fuentes, pulsa + y elige Navegador.

  2. Pega la URL privada

    Copia el enlace del overlay desde Creator Studio. No uses aquí el enlace público de checkout.

  3. Ajusta el lienzo

    Usa 1920 × 1080, o la resolución exacta de tu lienzo de emisión, para que el overlay no se recorte.

  4. Envía una alerta de prueba

    Dispara la prueba en Creator Studio y observa la escena. Un comando encolado no prueba que se mostró.

BROWSER SOURCE / VALORES DE REFERENCIA
URL      https://tu-dominio/{locale}/overlay/{token-privado}
Ancho    1920
Alto     1080
FPS      30
Audio    Controlar audio desde OBS (opcional)
Fuente separadaAñade al final de la URLTamaño
Todo juntonada1920 × 1080
Solo alertas?widget=alerts1920 × 1080
Barra de la meta?widget=goal1000 × 170
Apoyos?widget=ranking420 × 520
Cinta de donaciones?widget=ticker1920 × 80
Temporizador de subathon?widget=timer520 × 220
Encuesta pagada?widget=poll640 × 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.

EstadoQué significaQué lo prueba
En colaLa donación está registrada y la alerta esperaUna fila en la outbox
EntregadaLa fuente OBS recibió la alertaEl envío WebSocket se completó
ConfirmadaEl overlay terminó de mostrarlaUn 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íaEstado actualCondición
EVMRuta de código en testnet; router y tesorería deben estar configuradosDONATIONS_ENABLED=true, router desplegado, evento DonationRouted confirmado
SolanaRuta de código en Devnet; transferencia nativa dividida y finalizadaDONATIONS_ENABLED=true, tesorería y genesis hash del clúster coinciden
Identidad SuiInicio de sesión y registro de cobro disponiblesSUI_NETWORK configurado; no se requiere router Move
Checkout SuiImplementado; habilitado solo cuando está configuradoPaquete 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.
PAYLOAD DEL QR / SOLO URL DEL CHECKOUT
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.

POWERSHELL / DESDE LA RAÍZ DEL REPOSITORIO
.\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
ServicioURL por defectoNotas
Web apphttp://localhost:3000Next.js; 17 páginas estáticas en el build de producción
APIhttp://localhost:8080Express; endpoints de salud, autenticación y pago
PostgreSQLlocalhost:5432Solo en modo persistente
Redislocalhost:6379Sesiones y señales de alerta
VERIFICA ANTES DE CONFIAR EN EL BUILD
cd backend ; npm test
cd frontend ; npm run test:i18n ; npm run lint:product ; npm run build
cd contracts ; npm test

EVIDENCIA

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.

ÁreaEstadoEvidencia
Identidad SuiVerificada en código y pruebasFirmas ed25519 y secp256k1, digest, derivación de dirección y rechazo de manipulación
UI multicarteraImplementada; recorrido de navegador simuladoCartera de prueba Wallet Standard vía CDP; el selector Solana lista tres marcas
Checkout EVM / SolanaRutas de testnet; fondos reales no ejercitadosPruebas del verificador y fixtures de RPC
Checkout SuiImplementado, aún no validado en testnetPublicación del paquete Move y una donación en testnet con billetera real
OBS de extremo a extremoPendienteNinguna escena real de OBS se ha ejecutado en este entorno
Despliegue de producciónNo validado aquíStack Compose definido; ninguna ejecución en VPS o TLS registrada
Auditoría de seguridadPendienteSolo pruebas automatizadas y revisión interna
ESPACIO PARA VÍDEO DEL DUEÑORecorrido de validación

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.

LIVECRYPTO / DOCS

¿Listo para conectar OBS?

Inicia sesión con la cartera que usas para el destino, copia la URL privada del overlay y ejecuta una alerta de prueba antes de tu próxima emisión.

Abrir Creator Studio

Vista previa de desarrollo · pagos desactivados por defecto · sin afirmación de mainnet