Guia para não nativos em cripto sobre como escolher infraestrutura de smart wallet

Mais de 5,2 bilhões de pessoas usam carteiras digitais hoje, mas a maioria nunca teve contato com crypto, e não deveria precisar aprender sobre isso para usar seu app. Se você está construindo para usuários comuns, precisa de uma infraestrutura de carteira que esconda o blockchain por completo.

Smart Wallets abstraem essa complexidade, transformando contas blockchain em algo que parece qualquer outro login. Sem seed phrases. Sem taxas de gas. Sem modais de "conectar carteira" que espantam 90% dos usuários antes de completarem o cadastro.

Neste guia, vamos mostrar como implementar infraestrutura de carteira que funciona para usuários que não são de crypto. Vamos cobrir como escolher a abordagem certa, o que procurar em provedores, e como testar antes de lançar.

Comece definindo seus usuários

Antes de escolher um SDK, descubra quem vai realmente usar essas carteiras e por quê.

Construa pelo menos três personas. Pode ser um "comprador mobile-first" na casa dos vinte anos que espera Face ID e checkout instantâneo. Ou um "iniciante curioso em DeFi" que precisa de onboarding guiado. Ou um "funcionário corporativo" que exige integração com SSO. Anote demografia, nível de conforto técnico e motivações principais para cada um.

Defina metas concretas. Recomendamos ter como alvo a criação de contas em menos de 30 segundos, zero exposição de seed phrase, e uma taxa de sucesso na primeira transação acima de 95%. Hoje os usuários já esperam autenticação baseada em passkey ou social/email e transações gasless como recursos básicos.

Mapeie seus três principais fluxos de transação. Os usuários pagam com um toque em lojas físicas? Fazem transferências peer-to-peer? Fazem compras dentro do app? Documente cada fluxo e identifique pontos de fricção. Um usuário que precisa comprar ETH para pagar gas antes de conseguir transacionar é um usuário que vai embora.

Como as smart wallets funcionam na prática

Uma smart wallet é um smart contract que pode executar lógica programável, gerenciar chaves e patrocinar gas em nome dos usuários. Diferente das carteiras crypto tradicionais, que obrigam os usuários a guardar seed phrases de 12 palavras, as smart wallets gerenciam as chaves nos bastidores enquanto os usuários se autenticam com métodos que já conhecem — Face ID, impressão digital, ou códigos de uso único por email.

Já processamos mais de 400 milhões de transações de smart wallets, representando mais de 85% de toda a atividade de smart wallets. A infraestrutura deixou de ser experimental e está pronta para produção.

Smart wallets embutidas vs. externas

Você tem duas escolhas arquiteturais para implementar smart wallets:

Carteiras embutidas (embedded) se integram diretamente ao seu app através de SDKs. Os usuários nunca saem da sua interface nem baixam apps separados. Tudo acontece dentro do app. É isso que você quer para apps de consumo, jogos, DeFi e programas de fidelidade, onde você controla toda a experiência.

Smart wallets externas são carteiras de marca de terceiros que os usuários trazem para o seu app, como a Coinbase Smart Wallet. Você pode embutir a experiência de conexão no seu app, mas os usuários gerenciam seus ativos através da interface do terceiro. Eles podem usar a mesma carteira em vários apps, o que dá a eles uma experiência consistente e controle total sobre suas chaves.

O avanço de UX: passkeys e patrocínio de gas

Duas tecnologias tornaram as smart wallets viáveis para usuários comuns:

A autenticação por passkey substitui as seed phrases pela mesma segurança biométrica em que os usuários já confiam em apps bancários. O provedor da carteira gera e armazena as chaves em enclaves seguros enquanto os usuários se autenticam com impressão digital ou reconhecimento facial. Apple, Google e Microsoft suportam passkeys nativamente, o que significa que você está construindo sobre primitivas de segurança em nível de sistema operacional.

O patrocínio de gas significa que você paga as taxas de transação em vez dos seus usuários. Eles nunca precisam comprar ETH, entender preços de gas, ou se preocupar com transações que falham. Frameworks de account abstraction — especificamente ERC-4337 — tornam isso padrão. Um contrato paymaster paga as taxas em nome dos usuários, e você pode definir políticas como "patrocinar as primeiras 10 transações" ou "patrocinar transações abaixo de $100".

Juntas, essas tecnologias eliminam as duas maiores barreiras: autenticação complicada e a exigência de tokens antecipadamente.

O que procurar em um provedor

Três coisas determinam se um provedor consegue escalar com você: postura de segurança, implementação de patrocínio de gas, e experiência de desenvolvedor.

Segurança, auditorias e isolamento de chaves

Revise relatórios de auditoria de terceiros de empresas como Quantstamp ou OpenZeppelin. Verifique se há isolamento de chaves baseado em hardware — se as chaves dos usuários são armazenadas separadamente da infraestrutura do provedor. Procure por opções de MFA e certificações de conformidade como SOC 2.

O isolamento de chaves garante que, mesmo que um provedor seja comprometido, as chaves dos usuários permanecem seguras. Peça aos provedores que expliquem em detalhes a arquitetura de gerenciamento de chaves. Se não conseguirem explicar com clareza, isso é um sinal de alerta.

Patrocínio de gas e account abstraction

Os provedores implementam account abstraction através de paymasters: smart contracts que pagam taxas em nome dos usuários.

Construa uma matriz de comparação:

• O provedor patrocina gas? Em quais chains?
• É possível definir políticas customizadas? (Apenas as primeiras N transações? Transações abaixo de um determinado valor?)
• O que acontece quando os usuários esgotam sua cota de gas?
• Como você recarrega o saldo do seu paymaster?

Alguns provedores permitem patrocinar gas condicionalmente, com base no tipo de transação ou no comportamento do usuário. Essa flexibilidade importa quando você está tentando equilibrar experiência do usuário com controle de custos.

Design de API, suporte multi-chain e preços

Peça exemplos concretos de API. Você consegue criar uma carteira em uma única chamada de API? Quantas linhas de código são necessárias para assinar e enviar uma transação? A experiência de desenvolvedor determina seu time-to-market.

Se você quiser ver a implementação completa, criamos um repositório quickstart pré-configurado que inclui todo o fluxo — autenticação, criação de carteira e transações. Você pode clonar e ter uma demo funcionando em minutos.

Exija transparência de preços. Alguns provedores cobram taxas mensais fixas, outros usam preços baseados em uso. Muitos oferecem planos gratuitos para projetos em fase inicial. Suporte multi-chain também é essencial para dar aos seus usuários o mais amplo acesso a liquidez.

Pergunte sobre rate limits, garantias de SLA, e tempos de resposta de suporte. Esses detalhes operacionais importam mais do que listas de recursos quando você já está em produção.

Teste antes de lançar

Prototipe em um ambiente controlado antes de ir ao ar. Depurar em produção é caro.

Configure um sandbox

Provisione um ambiente de testnet — Sepolia para Ethereum, Base Sepolia para Base. Configure as chaves de API de sandbox do seu provedor. Escreva scripts automatizados para simular 1.000 cadastros simultâneos e medir tempos de resposta sob carga.

Testes em escala revelam gargalos invisíveis em testes manuais. Um provedor que lida bem com dez cadastros pode falhar com centenas. Aprendemos isso da forma difícil.

Teste fluxos críticos e cenários de recuperação

Liste os casos de teste:

• Cadastro bem-sucedido
• Falha na verificação de email
• Recuperação por perda de dispositivo
• Reset de passkey
• Falhas em transações patrocinadas com gas
• Cenários de congestionamento de rede

Defina opções claras de recuperação. Recuperação social através de contatos confiáveis é amigável para o usuário, mas exige que ele designe contatos. Custódia por escrow é simples, mas exige confiar no seu provedor. Chaves de backup em hardware são seguras, mas os usuários podem perdê-las.

Cada método de recuperação troca conveniência por segurança. Escolha com base na sofisticação técnica e na tolerância a risco dos seus usuários. Para um app de consumo mainstream, tenderíamos a custódia por escrow com recuperação social opcional. Para um protocolo DeFi, controle total do usuário importa mais.

Meça o que importa

Defina limites-alvo:

• Tempos de resposta de API abaixo de 200 milissegundos
• Taxas de erro abaixo de 1%
• Taxas de abandono de usuários abaixo de 5% na etapa "criar carteira"

Pagamentos por aproximação (NFC) normalmente são concluídos em menos de um segundo. Se sua carteira não consegue igualar essa velocidade em casos de uso de tap-to-pay, os usuários vão notar. E vão culpar seu app, não o blockchain.

Acompanhe essas métricas continuamente. Um pico repentino na latência da API ou nas taxas de erro sinaliza problemas de infraestrutura antes que se tornem reclamações de usuários.

Lance, monitore e itere

Produção é onde a teoria encontra a realidade. Usuários reais estressam sistemas de formas que os testes nunca previram.

Monitoramento em tempo real e segurança

Integre dashboards como Grafana ou CloudWatch para acompanhar usuários ativos, volume de transações patrocinadas com gas, e detecção de anomalias. Configure alertas para padrões incomuns — picos em transações falhas, distribuição geográfica anormal, ou criação rápida de contas.

Detecção de fraude com IA identifica padrões que humanos não percebem. O sucesso do Tesouro dos EUA ao usar machine learning para identificar fraudes demonstra sua eficácia em escala. Você precisa de capacidades similares.

Recuperação e conformidade

Documente um fluxo de recuperação passo a passo: verificação de identidade, emissão de chave de recuperação, e reconexão da carteira. Equilibre conformidade com privacidade — implemente verificação de KYC/AML onde for exigido, sem coletar dados dos usuários desnecessariamente.

Muitas jurisdições agora exigem KYC para serviços financeiros. Trabalhe com provedores especializados como Persona ou Onfido, que cuidam da verificação de identidade enquanto mantêm você em conformidade. Não construa isso internamente a menos que tenha uma equipe dedicada de compliance.

Escale através da iteração

Agende revisões trimestrais para avaliar novos recursos. Pagamentos ativados por voz cresceram 25% em 2023 e continuam ganhando tração. Rode testes A/B em elementos de UI — um prompt biométrico converte melhor do que uma opção de passkey? Qual fluxo de onboarding tem a menor taxa de abandono?

O comportamento do usuário revela o que funciona. Deixe os dados guiarem seu roadmap, não suposições sobre o que os usuários "deveriam" querer.

Perguntas comuns que recebemos

Como uma smart wallet funciona sem seed phrases?

Smart wallets usam autenticação baseada em passkey ou gerenciamento de chaves custodial. O provedor gera e gerencia as chaves com segurança em módulos de segurança de hardware enquanto os usuários fazem login com Face ID, impressão digital, ou códigos por email. A seed phrase nunca existe de uma forma que os usuários possam perder ou vazar.

O que é uma transação gasless?

Uma transação gasless é aquela em que o provedor da carteira paga as taxas do blockchain em seu nome. Isso elimina a necessidade de os usuários adquirirem tokens nativos antes de transacionar — a maior barreira para adoção mainstream. Por trás dos panos, um contrato paymaster patrocina a taxa de gas e você reembolsa o provedor de acordo com seu plano de preços.

Como mantenho conformidade com requisitos de kyc/aml?

Integre um provedor de KYC que verifique a identidade do usuário na criação da carteira e monitore os padrões de transação continuamente. A maioria dos provedores de carteiras embutidas suporta integrações plugáveis de KYC. Isso garante conformidade sem exigir que você construa infraestrutura de verificação de identidade ou lide diretamente com dados sensíveis de usuários.

O que acontece se um usuário perder seu dispositivo?

Os métodos de recuperação incluem recuperação social através de contatos confiáveis, custódia por escrow com seu provedor, ou passkeys secundárias armazenadas em outros dispositivos. Cada opção está vinculada à identidade verificada do usuário. Para apps de consumo, recomendamos custódia por escrow como método principal de recuperação, com recuperação social como backup — isso oferece o melhor equilíbrio entre segurança e usabilidade.

Devo usar uma carteira embutida ou uma smart wallet externa?

Use carteiras embutidas para experiências integradas ao app com fricção mínima para o usuário — ideal para apps de consumo, jogos, DeFi e programas de fidelidade. Use smart wallets externas quando os usuários precisarem de portabilidade entre apps, controle total sobre suas chaves, ou recursos avançados de DeFi. A maioria dos apps voltados para usuários mainstream deve começar com carteiras embutidas.

Próximos passos

Se você está construindo infraestrutura de carteira para usuários que não são de crypto, comece definindo suas personas e fluxos de transação. Depois, prototipe com alguns provedores para ver o que funciona melhor para seu caso de uso.

Criamos o Smart Wallets para resolver esses problemas. Ele lida com autenticação, patrocínio de gas, e account abstraction através de um único SDK que funciona em várias chains. Você pode integrá-lo em uma tarde e lançar uma infraestrutura de carteira que parece qualquer outro sistema de login.

Confira nossa documentação para começar, ou entre em contato se quiser discutir seus requisitos específicos.

Perguntas frequentes

O que é uma smart wallet?

Uma smart wallet é um smart contract que executa lógica programável, gerencia chaves, e patrocina gas em nome dos usuários, eliminando a necessidade de seed phrases e permitindo autenticação através de métodos como Face ID, impressão digital, ou email.

Qual é a diferença entre smart wallets embutidas e externas?

Carteiras embutidas se integram diretamente ao seu app através de SDKs para uma experiência integrada, enquanto smart wallets externas são carteiras de marca de terceiros que os usuários trazem para o seu app e podem usar em várias aplicações.

Como as smart wallets funcionam sem seed phrases?

Smart wallets usam autenticação baseada em passkey ou gerenciamento de chaves custodial, em que o provedor gerencia as chaves com segurança em módulos de segurança de hardware enquanto os usuários fazem login com Face ID, impressão digital, ou códigos por email.

O que é uma transação gasless?

Uma transação gasless é aquela em que o provedor da carteira paga as taxas do blockchain em seu nome através de um contrato paymaster, eliminando a necessidade de os usuários adquirirem tokens nativos antes de transacionar.

O que acontece se um usuário perder seu dispositivo?

Os métodos de recuperação incluem recuperação social através de contatos confiáveis, custódia por escrow com seu provedor, ou passkeys secundárias armazenadas em outros dispositivos, todos vinculados à identidade verificada do usuário.

Quais recursos de segurança devo procurar em um provedor de smart wallet?

Procure relatórios de auditoria de terceiros de empresas como Quantstamp ou OpenZeppelin, isolamento de chaves baseado em hardware, opções de MFA, e certificações de conformidade como SOC 2.

Devo escolher um provedor com capacidades de patrocínio de gas?

Sim, o patrocínio de gas é essencial para adoção mainstream, pois permite que você pague as taxas de transação em vez dos usuários, que nunca precisam comprar ETH ou entender preços de gas.

Quais fatores de experiência de desenvolvedor importam ao escolher um provedor?

Priorize provedores com design de API claro que permita criar carteiras em uma única chamada, suporte multi-chain, preços transparentes, rate limits, garantias de SLA, e tempos de resposta de suporte rápidos.