| name | wallet-guard |
| description | Transaction governance layer for crypto wallet operations. 3-state evaluation: BLOCK / WARN / ALLOW with receipt. Schema-frozen with AION (Aldo/CODÉ). Checks token score, deployer identity, liquidity depth, and contract security before any wallet interaction proceeds.
|
| tags | ["crypto","security","wallet","governance","agent"] |
Wallet Guard — Buzz BD Agent
3-state adapter: BLOCK / WARN / ALLOW
Schema-frozen with AION (3 locked schemas)
API: POST https://api.buzzbd.ai/api/guard/evaluate
When to Use
- Before any token swap or transfer
- Evaluating unknown contracts before interaction
- Agent-to-agent transaction governance
- Protecting wallets from rug pulls, honeypots, drain attacks
3-State Decision Engine
| State | When | What Happens |
|---|
| BLOCK | Score < 30 OR honeypot detected OR deployer blacklisted | Transaction rejected. Receipt logged. Alert sent to War Room. |
| WARN | Score 30-69 OR missing security data OR CTO_FLAG active | Transaction paused. Human approval required via Telegram. |
| ALLOW | Score >= 70 AND security clean AND identity verified | Transaction proceeds. Receipt logged with full audit trail. |
Locked Schemas (Frozen with Aldo/AION)
BuzzEvaluateRequestV1
{
"token_address": "0x...",
"chain": "base",
"action": "swap|transfer|approve",
"amount_usd": 100.0,
"requester": "agent_id"
}
WalletGuardNormalizedRequestV1
{
"token_address": "0x...",
"chain": "base",
"action": "swap",
"amount_usd": 100.0,
"buzz_score": 78,
"security_flags": [],
"deployer_identity": { "verified": true, "ens": "dev.eth" },
"liquidity_usd": 12400000,
"honeypot_check": false
}
WalletGuardEvaluateResponseV1
{
"decision": "ALLOW",
"score": 78,
"reasons": [
"Score above threshold",
"Identity verified",
"Liquidity sufficient"
],
"warnings": [],
"receipt_id": "WG-2026-04-05-001",
"evaluated_at": "2026-04-05T08:00:00Z"
}
Usage
Via Claude Code
/guard 0x6982508145454Ce325dDbE47a25d4ec3d2311933 swap 100
Via API
curl -X POST https://api.buzzbd.ai/api/guard/evaluate \
-H "Content-Type: application/json" \
-d '{"token_address":"0x...","chain":"base","action":"swap","amount_usd":100}'
Trust Gate Integration
Wallet Guard respects the 5-level trust system:
- Level 0 (FULL_APPROVAL): ALL transactions require Ogie's approval
- Level 1-2: BLOCK auto-rejects, WARN/ALLOW need approval
- Level 3: Only BLOCK needs approval
- Level 4 (AUTO_85): Score >= 85 auto-allows, rest need approval
Current trust level: 0 — FULL_APPROVAL (earning autonomy)
Security Rules
- NEVER auto-approve transactions at trust level 0
- ANY complaint → instant trust reset to Level 0
- Receipts are immutable (append-only audit table)
- Graceful fallback if AION API unreachable (defaults to WARN)
- Private keys NEVER logged, printed, committed, or transmitted
