Como adicionar uma carteira cripto ao seu app ou site (WaaS)

Seu produto precisa de uma carteira. Você tem duas opções

Se o seu app precisa que o usuário receba, envie ou troque cripto, existe um componente inevitável: uma carteira. E aí vem a decisão que define o resto: construir a infraestrutura de chaves ou usar Wallet as a Service.

A escolha não é sobre esforço de desenvolvimento. É sobre que tipo de responsabilidade você quer assumir — e, principalmente, o que você quer que exista no seu banco de dados.

O que significa construir do zero

Gerar um par de chaves é trivial: são poucas linhas com uma biblioteca conhecida. O problema começa depois.

Uma carteira de verdade exige resolver, em ordem:

• Geração segura. Aleatoriedade fraca produz chave previsível. O padrão de frase de recuperação é o BIP-39, e a derivação hierárquica de endereços é o BIP-32 — não é algo para improvisar.
• Armazenamento. Onde a chave fica? Se fica no seu servidor, você é custodiante, com todas as consequências regulatórias e de risco. Se fica no dispositivo, você precisa de um caminho de recuperação que não seja "perdeu, azar".
• Assinatura. Cada rede tem seu formato. Assinatura de dado estruturado segue o EIP-712, e mostrar ao usuário o que ele está assinando é requisito de segurança, não enfeite.
• Múltiplas redes. Cada rede nova é um conjunto novo de formatos, nós de acesso e casos de erro.
• Recuperação. A parte que mais gera suporte e a que menos aparece em demonstração.

Nenhum desses itens é opcional, e nenhum deles é o seu produto.

O que muda com WaaS

Wallet as a Service coloca essa camada fora do seu escopo. A VKX WaaS embute uma carteira não-custodial de 8 redes no seu app, com a infraestrutura hospedada.

npm install @vkx/waas

O desenho tem duas metades:

• No cliente, você inicializa com a chave pública do projeto. O usuário ganha uma carteira gerada com segurança, e passa a poder receber, enviar e fazer swap dentro do seu produto.
• No servidor, as operações que exigem a chave secreta ficam isoladas do aplicativo — onde credencial secreta deve ficar.

A parte que mais importa: a chave do usuário não fica com você. Ela não está no seu banco, não vaza num incidente seu, e não te transforma em custodiante. Isso deixa de ser um risco que você administra e passa a ser uma propriedade da arquitetura.

Não-custodial não significa sem responsabilidade

Vale ser preciso, porque essa é a confusão mais comum. Autocustódia não elimina risco — ela transfere a responsabilidade da chave para o usuário. O que muda para você:

• Você não pode mover fundo do usuário. Isso é proteção, e também limitação: não existe "estornar" no sentido tradicional.
• Você continua responsável pela experiência — deixar claro o que é a frase de recuperação, o que acontece se ela for perdida, e o que a sua aplicação faz e não faz.
• Você continua responsável por não pedir a chave do usuário em nenhuma circunstância. Todo golpe de suporte falso explora justamente isso.

Quando WaaS é a escolha certa

Faz sentido quando:

• Carteira é meio, não fim. Seu produto é um jogo, um marketplace, uma fintech, um programa de fidelidade. A carteira habilita, mas não é a proposta.
• Você não quer ser custodiante. A decisão de não guardar chave de terceiro é estratégica antes de ser técnica.
• Você precisa de várias redes. O custo de manter suporte multi-rede cresce por rede, e não por uma vez.
• Time-to-market importa. Integrar leva horas; construir e manter leva trimestres.

Não faz sentido quando a carteira é o seu produto — nesse caso, terceirizar o núcleo não se sustenta — ou quando um requisito regulatório específico exige um desenho de custódia próprio.

O que vem pronto

• 8 redes suportadas de fábrica.
• Receber, enviar e swap dentro do seu produto, sem jogar o usuário para fora.
• Infraestrutura hospedada: nós de acesso, formatos de assinatura e casos de erro deixam de ser seu problema.

Se o seu caso também envolve o usuário sem moeda nativa para pagar taxa — o que é comum quando a carteira é nova —, o patrocínio de gás resolve o passo seguinte.

Perguntas frequentes

A chave do usuário passa pelo meu servidor? Não. A carteira é não-custodial: a chave não fica com você nem existe no seu banco de dados.

Isso me torna custodiante? Não. Você não tem como mover fundo do usuário — o que é proteção para você e limitação ao mesmo tempo.

Quantas redes são suportadas? Oito de fábrica, com receber, enviar e swap.

Preciso de servidor próprio? Sim, para as operações que usam a chave secreta do projeto. Credencial secreta não vai no aplicativo.

E se o usuário perder a frase de recuperação? Em autocustódia, a recuperação depende dela. Explicar isso com clareza no seu produto faz parte da responsabilidade que sobra com você.

Dá para usar só o swap? As operações são independentes; a página do produto tem o escopo de cada uma.

Próximo passo

Se você está na decisão de construir ou integrar, o teste útil é perguntar o que o seu time vai manter em dois anos. Detalhes de integração estão na página do WaaS e na documentação.

Aviso: este conteúdo tem caráter informativo e educacional e não constitui recomendação de investimento.