Descubra quanto um agente pode perder, limite sua autoridade e impeça gastos fora da policy.
🌐 Abrir demo pública · 📦 Ver código · 🧪 Testar Devnet · 🗺️ Ver roadmap
Agentes de IA já conseguem pesquisar, assinar serviços e executar pagamentos. O problema não é apenas “o agente pode errar”: é qual o tamanho financeiro desse erro agora?
Sem controles, o saldo total da carteira vira a exposição potencial. AgentSafe troca essa confiança cega por uma autoridade explícita, explicável e tecnicamente limitada.
Não basta confiar que o agente obedecerá. Ele precisa ser incapaz de gastar além da autoridade recebida.
flowchart LR
A["🤖 Agente envia intenção<br/>de pagamento"] --> B["🔎 Descoberta de risco"]
B --> C["💥 Financial Blast Radius"]
C --> D["📜 Policy automática"]
D --> E{"⚖️ Decisão"}
E -->|"ALLOW"| F["✅ Executar dentro do limite"]
E -->|"REQUIRE APPROVAL"| G["🧑⚖️ Pedir aprovação"]
E -->|"DENY"| H["🛑 Bloquear antes da liquidação"]
| Descobre | Limita | Impede |
|---|---|---|
| orçamento ausente | valor por transação | autoridade delegada |
| loop de retries pagos | orçamento por tarefa | execução fora da policy |
| preço anômalo | limite diário | gasto acima do allowance |
| merchant/destinatário novo | destinatários permitidos | liquidação indevida |
| Antes | AgentSafe | Depois |
|---|---|---|
| 🔓 US$ 10.000 exposição sem limites |
🔎 scanner + policy ⚖️ decisão determinística |
🔐 US$ 20/dia autoridade máxima |
O ResearchBot recebe uma tarefa de pesquisa e tenta comprar dados. A análise encontra riscos que o usuário não configurou manualmente, gera uma policy e testa uma tentativa acima da regra.
{
"maxPorTransacao": "US$ 2,00",
"maxPorTarefa": "US$ 3,00",
"maxPorDia": "US$ 20,00",
"novoDestinatario": "BLOQUEAR",
"retriesPagos": 3
}Esta não é apenas uma interface de limites.
| Cenário | Resultado | Evidência |
|---|---|---|
Treasury cria 100 test-USDC |
saldo disponível | carteira do usuário mantém o cofre |
AgentSafe recebe allowance de 20 test-USDC |
autoridade limitada | delegated authority via SPL Token |
Pagamento de US$ 0,55 |
✅ permitido | ver transação |
Tentativa de US$ 21 |
🛑 recusada antes da liquidação | excede a autoridade delegada |
O insight: mesmo que existam 100 tokens no cofre, o agente não consegue gastar 21 se recebeu autoridade para 20.
→ Guia completo para reproduzir a demo
flowchart TB
UI["🌐 Site público / Risk Lab"]
AGENT["🤖 Agent SDK / ResearchBot"]
ENGINE["🧠 AgentSafe Core"]
POLICY["📜 Policy Engine"]
AUDIT["📋 Audit trail & reservations"]
SOLANA["◎ Solana Devnet<br/>SPL delegated authority"]
DB[("Postgres / RLS foundation")]
UI --> AGENT
AGENT --> ENGINE
ENGINE --> POLICY
POLICY --> AUDIT
POLICY --> SOLANA
ENGINE --> DB
Componentes no repositório
| Área | Onde está | Responsabilidade |
|---|---|---|
| Core de domínio | src/ |
intents, dinheiro em unidades inteiras, policy e decisões |
| Risco e blast radius | src/risk-score.ts, src/blast-radius.ts |
cálculo explicável de exposição |
| Policy engine | src/policy-engine.ts |
ALLOW, DENY, REQUIRE_APPROVAL |
| Policy generator | src/policy-generator.ts |
limites derivados dos sinais encontrados |
| Prova Solana | src/solana-allowance.ts |
allowance e teste de fronteira em Devnet |
| Demo pública | apps/public-site/ |
apresentação em português e Lab guiado |
| Banco/RLS | db/migrations/ |
base para multi-tenancy e auditoria |
- Abra a demo pública.
- Clique em “Analisar ResearchBot”.
- Confira riscos, policy e o teste de bloqueio de
US$ 14,00.
- Use uma única carteira Phantom em modo Devnet e tenha um pouco de Devnet SOL para taxas.
- Na seção Solana Devnet: conectar → criar demo de 20 USDC → permitir US$ 0,55 → tentar US$ 21.
- A última tentativa deve falhar; tokens não são movidos no bloqueio.
O Lab usa tokens de teste e uma identidade temporária. Nunca pede seed phrase ou chave privada.
Veja também: passo a passo detalhado.
| Capacidade | Status |
|---|---|
| Descoberta determinística de riscos | ✅ |
| Financial Blast Radius | ✅ |
| Policy automática explicável | ✅ |
Decisões ALLOW / DENY / REQUIRE_APPROVAL |
✅ |
| Reservas e idempotência no core | ✅ |
| Demo guiada em português | ✅ |
| Prova de delegated authority em Solana Devnet | ✅ |
| API autenticada e persistência de produção | 🧭 próximo passo |
| Mainnet e custódia/KMS de produção | ⛔ fora do MVP |
timeline
title Construção do AgentSafe
Agora : Scanner de risco
: Policy engine determinístico
: Demo Devnet e Lab guiado
Próximo : API POST /v1/evaluate
: Adaptador Postgres transacional
: Aprovação humana e alertas
Depois : Integrações com agentes MCP/x402
: Histórico de incidentes evitados
: Conectores de wallet e merchant
Produção : KMS / signer seguro
: Monitoramento e auditoria
: Mainnet após revisão de segurança
- Não somos uma wallet. Somos a camada de inteligência e autoridade financeira.
- Policy como artefato. Toda recomendação precisa explicar seu limite e sua evidência.
- Enforcement acima de confiança. O agente não deve conseguir ignorar uma decisão.
- Segurança honesta. Devnet é prova de conceito; mainnet requer revisão, KMS e observabilidade.
# Core TypeScript
npm ci
npm run check
npm run demo:researchbot
# Site público
cd apps/public-site
npm ci
npm run build- Roteiro e teste da demo
- Mapa do projeto
- Detalhes de enforcement Devnet
- Estado de implementação
- Decisão de escopo: AgentSafe não é wallet
AgentSafe encontra como agentes falham. AgentSafe limita quanto essa falha pode custar.
Feito para a nova era de agentes financeiros em Solana.