Wallet workflows with clear operator control.
Understand the supported wallet model, who controls signing and how payment activity is recorded.
Todo agente que você criar no AgentCredia recebe sua própria carteira dedicada no Base. A carteira é não-custodial - você conecta uma carteira EVM existente via RainbowKit ou Reown, e nunca vemos suas chaves privadas. Os fundos do seu agente permanecem sob seu controle o tempo todo.
A carteira hoje é apenas USDC. Escolhemos USDC porque é a stablecoin dominante no ecossistema de AI agents, é nativa na Base (não bridged) e dá à experiência de pagamento do seu agente volatilidade de preço zero. Sem ficar se perguntando se $10 de valor ainda serão $10 amanhã.
- Receba USDC de humanos ou de outros agentes em um endereço permanente
- Acompanhe o saldo em tempo real no dashboard
- Receba notificações por e-mail e webhook em cada pagamento recebido
- Exporte o histórico completo de transações em CSV ou JSON
- Veja todas as transações no Basescan com um clique
- Defina limites de gasto por agente que a API aplica
- Nós controlamos os fundos. Nunca temos suas chaves privadas.
- Negociar ou especular. Esta é uma camada de pagamento, não uma plataforma de trading.
- Movimente fundos entre agentes automaticamente. Toda transferência é iniciada pelo usuário.
Como se compara ao MetaMask ou Phantom
Uma carteira de criptomoeda bruta lhe dá um endereço e um saldo. É isso. A AgentCredia adiciona as coisas que você realmente precisa para administrar um negócio de agentes: um perfil público, controles de gastos, registros de transações, webhooks, uma API, distintivos de verificação e um relacionamento de cobrança com você para a camada SaaS.
Por que Base, e não Ethereum, Solana ou Polygon.
Três razões para termos escolhido uma chain para começar e como a arquitetura de adapter faz com que essa escolha não te prenda a ela.
| Dimensão | Base (hoje) | mainnet Ethereum | Solana | Polygon |
|---|---|---|---|---|
| USDC nativo (emitido pela Circle, não bridged) | Sim | Sim | Sim | Sim (desde 2024) |
| Gas típico por transferência de USDC | <$0.01 | $1-10+ | <$0.001 | ~$0.01 |
| Compatibilidade com EVM (wallets, SDKs, bibliotecas) | Sim | Sim | Não (runtime diferente) | Sim |
| Suporte a Coinbase Smart Wallet | Sim (de primeira classe) | Sim | Não | Limited |
| suporte ao protocolo x402 / AP2 hoje | Sim | Sim | Emerging | Parcial |
| Velocidade de confirmação | Rápido (segundos) | Slower | Fast | Fast |
| Suporte AgentCredia | Ao vivo (mainnet + Sepolia) | Roadmap | Roadmap | Roadmap |
1. USDC nativo, não bridged
Stablecoins conectadas introduzem um segundo emissor na cadeia de confiança e criam risco de desmantelamento quando as pontes são exploradas. A Circle emite USDC nativamente na Base, da mesma forma que faz na mainnet do Ethereum. O saldo do seu agente é em dólares respaldados pela Circle, não IOUs sintéticos de dólares. Para casos de uso de pagamento, isso importa - estornos não existem em cripto, então a integridade do ativo é a única proteção que seu comprador tem.
2. Custos que fazem a cobrança por chamada realmente funcionar
Um pagamento de $0,10 não faz sentido econômico se o gás para liquidá-lo custa $1. As transferências na Base custam frações de centavo, então a precificação em formato de agente (cobrar por chamada de API, por invocação de ferramenta, por inferência) é viável. A mainnet Ethereum mata toda a premissa de micropagamentos abaixo de $5 por transação. Solana é ainda mais barata que a Base, mas seu tempo de execução não-EVM é um não-iniciador para a maioria dos frameworks de agentes hoje.
3. A compatibilidade EVM significa que tudo funciona
Toda carteira que seus compradores já possuem (MetaMask, Coinbase Wallet, Rainbow, Phantom-via-Solana-toggle, Frame, Safe) fala EVM. Cada biblioteca de assinatura, cada explorador de blocos, cada ferramenta de contabilidade, cada provedor de análises fala EVM. Escolher o Base significa que herdamos todo o ecossistema de ferramentas Ethereum desde o primeiro dia sem escrever ou suportar nada disso. Solana significaria um investimento paralelo em ferramentas que ainda não existem para pagamentos de agentes.
A arquitetura do adaptador significa que adicionar uma cadeia depois não mudaria a API pública, os contratos de webhook, os SDKs ou esta página - seu código de integração permaneceria o mesmo. Hoje, essa superfície é a mainnet Base e a Base Sepolia; outras cadeias estão no roadmap, não estão ao vivo, então construa contra a Base agora e você não ficará preso se mais chegarem.
O que acontece quando você clica em "Conectar carteira".
O fluxo é a conexão padrão do EVM, com um passo extra que fixa a rede ao Base.
- 01
Escolha um provedor de carteira
O RainbowKit exibe um modal listando todas as carteiras EVM que suportamos: Coinbase Wallet, MetaMask, Rainbow, WalletConnect (cobre mais de 200 carteiras móveis), Frame, Safe. Se você não tiver nenhuma delas, a opção Coinbase Smart Wallet do RainbowKit cria uma em 10 segundos sem frase-semente.
- 02
Autorizar a conexão
Sua carteira pede que você confirme. Obtemos uma assinatura somente leitura provando que você controla o endereço. Não obtemos permissão de gasto, não obtemos material de chave, não obtemos nada além do endereço. Você pode revogar a conexão nas configurações da sua carteira a qualquer momento.
- 03
Bloqueios de rede para a Base
Se sua carteira estiver atualmente na mainnet Ethereum ou em outra cadeia, nosso aplicativo solicita que você mude para a Base. A carteira gerencia a troca via wallet_switchEthereumChain; no Coinbase Smart Wallet, a Base já está selecionada. Não permitimos conectar na rede errada porque um pagamento USDC na cadeia errada seria perdido.
- 04
Os metadados do agente são anexados
Armazenamos o endereço da carteira contra o registro do agente em nosso banco de dados. A partir deste ponto, cada página pública do agente, solicitação de pagamento, entrada de log de transação e webhook referenciam esse endereço. Desconectar e reconectar uma carteira diferente é permitido; os metadados permanecem, o saldo se move com o endereço que está atualmente conectado.
Os quatro eventos que sua carteira dispara.
Dinheiro chegando, dinheiro saindo, uma carteira entrando online e um ping de teste. Cada um é um webhook assinado para seu endpoint.
payment.receivedUSDC chegou em uma das suas carteiras de agente - a transferência foi incluída em um bloco da Base. Disparamos payment.received com o hash da transação, para que seu manipulador possa realizar o trabalho para o qual o pagamento foi feito.
payment.sentUm pagamento que seu agente enviou foi liquidado na blockchain. Disparamos payment.sent com o hash da transação, para que você possa reconciliar o que o agente gastou em relação à sua permissão de gasto.
wallet.deployedA carteira inteligente de um agente foi implantada no Base. Útil quando você provisiona carteiras programaticamente e deseja saber o momento em que uma está pronta para receber.
webhook.testUma entrega de teste que você aciona do painel, para que você possa confirmar que seu endpoint verifica a assinatura corretamente antes que qualquer dinheiro real se mova.
Cada payload é assinado com HMAC-SHA256 usando seu segredo de webhook; verifique com webhooks.verify de @agentcredia/node (ou o HMAC documentado em qualquer linguagem). A assinatura está em X-AgentCredia-Signature cabeçalho. Se você perder uma entrega, reconcilie buscando a transação diretamente com GET /v1/transactions/{id}.
O que controlamos e o que deliberadamente não controlamos.
Todo sistema de pagamento tem uma fronteira de confiança. A nossa é desenhada de propósito para lhe dar controle e a nós a menor superfície de ataque possível.
- Chaves privadas (na sua wallet conectada, nunca em nossos servidores)
- Saldo de USDC (no endereço onchain da sua wallet)
- Políticas de gastos por agente (você define, nós aplicamos na API)
- Rotação de chave de API (você pode rotacionar por agente a qualquer momento)
- Se a página pública pode ser indexada ou está oculta
- O DB de metadados (nome do agente, slug, configurações da página pública)
- O monitor de chain que observa a Base em busca de pagamentos recebidos
- Secrets de assinatura de webhook (rotacionáveis por agente)
- A renderização hospedada da página /pay/*
- Relacionamento de cobrança do Stripe para assinaturas e taxas de transação
- Se o AgentCredia for comprometido: o atacante obtém acesso de leitura aos metadados do seu agente e a capacidade de definir limites de gastos. Eles não podem mover seu USDC porque não têm as chaves da sua carteira. Eles poderiam potencialmente manipular segredos de assinatura de webhook; você detectaria isso quando os payloads parassem de validar.
- Se formos à falência: seu USDC continua funcionando no mesmo endereço de carteira. Você perde a página pública, a API e o painel, mas os fundos e o histórico da cadeia são seus.
- Se você perder sua carteira: não podemos recuperá-lo. As regras padrão de recuperação de carteira se aplicam (frase-semente, backup de carteira de hardware, recuperação social de carteira inteligente).