Wallet Guard

---
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

```json
{
  "token_address": "0x...",
  "chain": "base",
  "action": "swap|transfer|approve",
  "amount_usd": 100.0,
  "requester": "agent_id"
}
```

### WalletGuardNormalizedRequestV1

```json
{
  "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

```json
{
  "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

```bash
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