LIVECRYPTO / DOCS
Da assinatura na carteira ao alerta na tela.
Um guia prático do produto, das carteiras aceitas, do Creator Studio, do OBS e do caminho do pagamento. Escrito para criadores e operadores, com os limites atuais declarados sem rodeios.
COMECE AQUI
O que o LiveCrypto é — e o que ele não é.
O LiveCrypto é uma camada de doações para criadores ao vivo. O espectador abre seu checkout público, confere a rede, o valor, a taxa e o destino, e assina uma transação na própria carteira. O dinheiro vai do espectador para a carteira que você cadastrou. O LiveCrypto não mantém saldo para você sacar.
O backend cria uma intenção de pagamento antes do pedido de assinatura, verifica o resultado on-chain contra essa intenção, registra a doação e enfileira um alerta. O alerta chega ao OBS por um Browser Source. Cada etapa foi desenhada para ser visível, não mágica.
- Entre com uma carteira
Uma carteira EVM, Solana ou Sui assina uma mensagem legível. Entrar prova o controle da conta; não move fundos.
- Cadastre um destino
Salve o endereço que deve receber doações naquela rede exata. Login e recebimento são separados de propósito.
- Compartilhe o checkout
O link público abre a página de doação. Mantenha o link de overlay privado: ele autoriza o acesso aos seus alertas.
- Conecte o OBS
Adicione um Browser Source, cole a URL privada do overlay e envie um alerta de teste antes de entrar ao vivo.
Reservado para um walkthrough gravado pelo dono: landing, login, destino, checkout e alerta no OBS. Substitua este bloco pelo embed final; gravações simuladas nunca devem ser apresentadas como transação real.
Reservado para uma captura real e atual do estúdio usando um perfil de teste claramente identificado.
IDENTIDADE
Três famílias de carteira, um modelo de conta.
Uma conta de criador pode ser aberta com carteira EVM, Solana ou Sui. A interface descobre as carteiras no navegador e pede apenas uma assinatura. Não há senha, confirmação por e-mail nem frase-semente.
| Família | Detectado hoje | Login | Endereço de recebimento |
|---|---|---|---|
| EVM | MetaMask, Rabby e outras carteiras injetadas anunciadas via EIP-6963 | Mensagem EIP-4361 (SIWE) vinculada ao EVM_CHAIN_ID | 0x seguido de 40 caracteres hexadecimais |
| Solana | Phantom, Solflare e Backpack, detectadas de forma independente | Desafio assinado com nonce de uso único | Chave pública Base58 |
| Sui | Slush, Sui Wallet e outras carteiras Wallet Standard | Assinatura de mensagem pessoal Sui (ed25519 ou secp256k1) | 0x seguido de 64 caracteres hexadecimais minúsculos |
- A assinatura de login prova o controle da conta. Ela não autoriza uma transferência.
- O backend deriva o endereço Sui da chave pública e verifica o digest da mensagem pessoal; o frontend envia o texto assinado exato da carteira.
- O login EVM é rejeitado quando a carteira está em uma rede diferente do EVM_CHAIN_ID, fechando uma brecha de replay entre redes.
- Login e recebimento são independentes: você pode autenticar com uma carteira e receber em outra.
O FLUXO PRINCIPAL
Uma doação do clique ao alerta.
Uma doação não é uma única assinatura na carteira. É uma intenção, uma transação, uma verificação e um alerta. Cada etapa tem um responsável e um estado visível, para que nem o doador nem o criador precisem adivinhar o que aconteceu.
O doador escolhe o valor
O checkout mostra a rede, o ativo, o destino do criador, a taxa da plataforma e a taxa de rede. Nada é assinado nesta etapa.
| Estado do checkout | O que significa | O que resolve |
|---|---|---|
| Pendente | A transação foi enviada, mas não confirmou | As confirmações exigidas ou o timeout do verificador |
| Confirmado | Todos os campos da intenção coincidiram com o resultado on-chain | O lançamento no livro e o alerta no OBS |
| Expirado | A janela da intenção fechou antes da liquidação | Um novo checkout e uma nova intenção |
| Rejeitado | Valor, destino, memo ou rede não coincidiram | Nenhum lançamento e nenhum alerta |
O ESPAÇO DE TRABALHO
Seu perfil, destinos e controles de alerta.
O Creator Studio é o espaço autenticado. Ele não é uma carteira e não guarda fundos. Ele armazena seu perfil, destinos de recebimento, preferências de alerta e o token usado pelo OBS.
- Entre
Escolha uma carteira, conecte e assine a mensagem. Apenas conectar não abre uma sessão.
- Salve um destino
Escolha a rede e informe o endereço de recebimento. Endereços reservados de router, tesouraria, zero e sistema são rejeitados.
- Configure o alerta
Escolha tema, posição, som, mídia opcional e voz. As configurações pertencem ao seu perfil.
- Copie a URL privada do overlay
Use-a somente dentro do OBS. O link público de checkout é o que você compartilha com a comunidade.
| Link | Onde aparece | Quem pode usar |
|---|---|---|
| Checkout público | /pay/{creator} no seu site, bio ou chat | Qualquer pessoa com quem você compartilhar |
| Overlay privado | /overlay/{token}, copiado do Creator Studio | Somente seu Browser Source no OBS; mantenha em segredo |
NA TELA
Um Browser Source. Nenhum plugin.
O OBS Studio renderiza o LiveCrypto como uma página web normal dentro de um Browser Source. O OBS mantém a página aberta, a conexão WebSocket entrega um alerta por vez e o overlay confirma cada alerta depois de exibi-lo.
- Crie um Browser Source
Na sua cena, abra Fontes, clique em + e escolha Navegador.
- Cole a URL privada
Copie o link do overlay no Creator Studio. Não use o link público de checkout aqui.
- Combine com a tela
Use 1920 × 1080, ou a resolução exata da sua tela de transmissão, para o overlay não ser cortado.
- Envie um alerta de teste
Dispare o teste no Creator Studio e observe a cena. Um comando enfileirado não prova que ele apareceu.
URL https://seu-dominio/{locale}/overlay/{token-privado}
Largura 1920
Altura 1080
FPS 30
Áudio Controlar áudio pelo OBS (opcional)| Fonte separada | Acrescente ao fim da URL | Tamanho |
|---|---|---|
| Tudo junto | nada | 1920 × 1080 |
| Só alertas | ?widget=alerts | 1920 × 1080 |
| Barra da meta | ?widget=goal | 1000 × 170 |
| Apoiadores | ?widget=ranking | 420 × 520 |
| Faixa de doações | ?widget=ticker | 1920 × 80 |
| Cronômetro de subathon | ?widget=timer | 520 × 220 |
| Enquete paga | ?widget=poll | 640 × 420 |
ENTREGA
Enfileirado, entregue, confirmado.
Uma doação verificada é gravada no livro financeiro e em uma outbox na mesma transação de banco. O Redis publica um sinal de despertar; ele não substitui a fila durável. Se o OBS desconectar, os alertas continuam enfileirados e são reproduzidos quando a fonte reconectar.
| Estado | O que significa | O que prova |
|---|---|---|
| Na fila | A doação foi registrada e o alerta está esperando | Uma linha na outbox |
| Entregue | A fonte OBS recebeu o alerta | O envio WebSocket foi concluído |
| Confirmado | O overlay terminou de exibir o alerta | Um ACK enviado pelo overlay |
- Os alertas são entregues um por vez; o segundo espera em vez de sobrepor o primeiro.
- Som, mídia e voz são configurados por perfil no Creator Studio.
- Qualquer alerta antigo pode ser repetido pelo histórico do Studio. A repetição aparece de novo na live, mas nunca conta duas vezes na meta, no ranking ou nos apoiadores.
- O cronômetro de subathon faz a contagem regressiva na live e cada doação confirmada soma tempo: alguns segundos fixos em qualquer rede, mais segundos por R$ 1 na mainnet. Alertas de teste e repetições nunca somam tempo.
- A enquete paga faz uma pergunta com 2 a 5 opções. Enquanto está aberta, a página de doação mostra as opções e cada doação confirmada que escolhe uma vota: R$ 1 = 1 voto na mainnet, 1 voto por doação em rede de teste. O resultado é contado a partir das doações confirmadas, então nada conta duas vezes.
- Depois de abrir o OBS, mantenha a fonte visível o suficiente para o overlay carregar e conectar.
- Um alerta ausente é diagnosticado pelo estado da outbox, não por suposições sobre a cena.
CAMINHO DO DINHEIRO
Não custodial por princípio, bloqueado por evidência.
O LiveCrypto é não custodial. O checkout cria uma intenção de pagamento que fotografa criador, rede, destino, remetente, valor, taxa, memo e cursor de monitoramento. Uma transação só liquida quando todos os campos conferem.
| Via | Estado atual | Condição |
|---|---|---|
| EVM | Caminho de código em testnet; router e tesouraria precisam estar configurados | DONATIONS_ENABLED=true, router implantado, evento DonationRouted confirmado |
| Solana | Caminho de código em Devnet; transferência nativa dividida e finalizada | DONATIONS_ENABLED=true, tesouraria e genesis hash da cluster coincidem |
| Identidade Sui | Login e cadastro de recebimento disponíveis | SUI_NETWORK configurado; nenhum router Move necessário |
| Checkout Sui | Implementado; habilitado só quando configurado | Pacote Move live_crypto publicado, SUI_PACKAGE_ID e SUI_TREASURY_ADDRESS |
- A taxa proposta da plataforma é 2% (PLATFORM_FEE_BPS=200), exibida separadamente da taxa de rede.
- A parte do criador vai para o destino cadastrado; a taxa vai para a tesouraria configurada.
- A carteira do doador mostra a taxa de rede antes da assinatura. O LiveCrypto não pode reembolsar uma transferência on-chain.
- O navegador recebe apenas endpoints RPC públicos; URLs com chaves de provedor ficam no servidor.
ENTRADA MÓVEL
O QR abre o checkout, não uma carteira.
Digitar um endereço no celular é propenso a erro. A entrada móvel é um QR code que codifica a URL pública do checkout do criador. Ao abrir, ele carrega o mesmo checkout do link compartilhado, com rede, valor, taxa e destino visíveis antes de qualquer assinatura.
Um QR contendo apenas um endereço de carteira pularia a intenção de pagamento, a divulgação da taxa e a atribuição do alerta. O LiveCrypto não usa QR de endereço puro para doações; o checkout continua sendo a fonte da verdade.
- Lado do criador: o Creator Studio mostra o QR do checkout público ao lado do link, com download em PNG e SVG. Ele é gerado no navegador; nenhum serviço externo vê a URL.
- Lado do doador: a câmera do celular abre o checkout; um navegador com carteira ou o app da carteira assina a transação exibida.
- Lado do servidor: a mesma intenção e o mesmo verificador rodam; o QR não adiciona confiança nem atalho.
- Parâmetros de valor ou memo só serão aceitos depois que o checkout os validar no servidor.
https://seu-dominio/{locale}/pay/{creator}
Nunca codifique: chaves privadas, frases-semente, tokens de overlay
ou um endereço puro que pule a revisão de valor, taxa e destino.CONFIANÇA
O que protegemos e o que você precisa verificar.
Segurança começa mantendo segredos fora do navegador. As sessões são cookies HttpOnly com SameSite=Strict, não tokens em localStorage. Nonces são de uso único, rotas de autenticação e pagamento têm limite de requisições, e URLs RPC privadas nunca saem do servidor.
- Entre apenas no domínio que você espera e leia a origem no pedido da carteira.
- Nunca informe frase-semente ou chave privada. O LiveCrypto nunca pede nenhuma das duas.
- Confira o destino de recebimento na rede exata antes de salvar.
- Trate o token do overlay como senha e gere outro depois de compartilhar uma captura.
- Como doador, leia rede, destino, valor e taxa antes de assinar.
- Confirme se está na testnet ou mainnet pretendida; chain IDs não são intercambiáveis.
- Transferências blockchain são geralmente irreversíveis. Não existe saldo da plataforma para reverter.
RODE VOCÊ MESMO
Dois processos Node, quatro serviços locais.
O repositório executa uma API Express e um app Next.js. PostgreSQL e Redis são opcionais no modo de prévia e obrigatórios para contas persistentes, sessões e a fila durável de alertas. Node.js 24 e npm são os únicos pré-requisitos obrigatórios.
.\start-dev.bat # prévia: dados temporários, pagamentos desligados
.\start-dev.bat --full # PostgreSQL + Redis no Docker, dados persistentes
.\start-dev.bat --check # páginas localizadas, API e assets, depois encerra| Serviço | URL padrão | Observações |
|---|---|---|
| Web app | http://localhost:3000 | Next.js; 17 páginas estáticas no build de produção |
| API | http://localhost:8080 | Express; endpoints de saúde, autenticação e pagamento |
| PostgreSQL | localhost:5432 | Somente no modo persistente |
| Redis | localhost:6379 | Sessões e sinais de alerta |
cd backend ; npm test
cd frontend ; npm run test:i18n ; npm run lint:product ; npm run build
cd contracts ; npm testEVIDÊNCIA
O que está provado e o que ainda está pendente.
O estado honesto em 5 de novembro de 2026: os caminhos de protocolo estão implementados e testados, o build de produção passa e a jornada de navegador foi exercitada com carteiras simuladas. Carteiras reais, uma cena real de OBS, uma doação real em testnet, TLS, backups e auditoria independente ainda estão pendentes.
| Área | Estado | Evidência |
|---|---|---|
| Identidade Sui | Verificada em código e testes | Assinaturas ed25519 e secp256k1, digest, derivação de endereço e rejeição de adulteração |
| UI multi-carteira | Implementada; jornada de navegador simulada | Carteira de teste Wallet Standard via CDP; seletor Solana lista três marcas |
| Checkout EVM / Solana | Caminhos de testnet; fundos reais não exercitados | Testes do verificador e fixtures de RPC |
| Checkout Sui | Implementado, ainda não validado em testnet | Publicação do pacote Move e uma doação em testnet com carteira real |
| OBS ponta a ponta | Pendente | Nenhuma cena real de OBS foi executada neste ambiente |
| Implantação de produção | Não validada aqui | Stack Compose definida; nenhuma execução em VPS ou TLS registrada |
| Auditoria de segurança | Pendente | Somente testes automatizados e revisão interna |
Reservado para uma execução ponta a ponta gravada: checkout em testnet, confirmação, lançamento no livro e ACK no OBS. A gravação deve mostrar a rede e o selo de testnet o tempo todo.
