LeoYeAI/agent-master-skills / skills/aawp
aawp
FlaggedAAWP (AI Agent Wallet Protocol) — the only crypto wallet protocol built exclusively for AI Agents on EVM-compatible blockchains. Not for humans. The signer is the AI Agent itself, cryptographically bound at wallet creation. Supports wallet lifecycle management, token transfers, DEX swaps, cross-chain bridging, arbitrary contract interactions, DCA automation, and price alerts.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 10.9 KB |
| SKILL.md | skill md | 20.1 KB |
| WALLET_SETUP.md | markdown | 4.6 KB |
| _meta.json | config | 436 B |
| bin/install.js | script | 7.0 KB |
| config/chains.json | config | 4.2 KB |
| core/index.d.ts | script | 2.8 KB |
| core/loader.js | script | 1.0 KB |
| daemon/client.js | script | 1.1 KB |
| daemon/daemon.js | script | 606 B |
| lib/address-book.js | script | 1.6 KB |
| lib/gas-estimator.js | script | 1.7 KB |
| lib/multicall.js | script | 2.6 KB |
| lib/nonce-manager.js | script | 1.9 KB |
| lib/tx-history.js | script | 1.3 KB |
| scripts/bootstrap.sh | script | 1.7 KB |
| scripts/dca.js | script | 9.4 KB |
| scripts/deploy-clanker.js | script | 13.6 KB |
| scripts/doctor.sh | script | 1.6 KB |
| scripts/ensure-daemon.sh | script | 2.2 KB |
| scripts/limit-order.js | script | 28.3 KB |
| scripts/nft.js | script | 25.2 KB |
| scripts/portfolio.js | script | 18.0 KB |
| scripts/price-alert.js | script | 12.1 KB |
| scripts/provision.sh | script | 9.4 KB |
| scripts/restart-daemon.sh | script | 1.5 KB |
| scripts/restore-impl.js | script | 3.9 KB |
| scripts/sign-worker.js | script | 2.9 KB |
| scripts/start-daemon.js | script | 3.9 KB |
| scripts/swap.js | script | 31.8 KB |
| scripts/wallet-manager.js | script | 70.6 KB |
| scripts/yield.js | script | 34.1 KB |
WALLET_SETUP.md
View on GitHub# AAWP Wallet Setup
For newly installed users.
## Goal
Safely complete this flow:
1. Check environment
2. Create wallet
3. Pin the real wallet address
4. Fund the wallet
5. Run first status / quote / small swap
6. Backup
## Core model
- **AI Signer**: signs transactions via daemon
- **Guardian**: submits tx, pays gas, can emergency freeze/unfreeze
- **Wallet**: onchain contract wallet that actually holds funds
Important: after creation, **fund the Wallet**, not the Guardian.
## Health check
```bash
cd /root/clawd/skills/aawp
bash scripts/doctor.sh
bash scripts/ensure-daemon.sh
```
If you hit:
- `E_AI_GATE`
- `hmac_mismatch`
- daemon / signer desync
run:
```bash
bash scripts/restart-daemon.sh
```
## Before create
Confirm:
- skill installed correctly
- daemon is healthy
- guardian exists
- guardian has a small amount of native gas token
## Create wallet
```bash
cd /root/clawd/skills/aawp
node scripts/wallet-manager.js --chain base create
```
This handles:
- predicted address
- commit / reveal
- cooldown / block wait
- proof request from daemon
- onchain wallet creation
Save the final wallet address.
## Pin the real wallet address
Do this immediately after creation:
```bash
export AAWP_WALLET=0xYourCreatedWallet
```
One-shot form:
```bash
AAWP_WALLET=0xYourCreatedWallet node scripts/wallet-manager.js --chain base status
```
Reason: predicted address can change when `binaryHash` changes. Real deployed wallets should be pinned explicitly.
## First funding
Send a small amount of native token to the **Wallet** address.
Do not confuse wallet balance with guardian balance.
## First test flow
```bash
AAWP_WALLET=0xYourCreatedWallet node scripts/wallet-manager.js --chain base status
AAWP_WALLET=0xYourCreatedWallet node scripts/wallet-manager.js --chain base balance
AAWP_WALLET=0xYourCreatedWallet node scripts/wallet-manager.js --chain base quote ETH USDC 0.00001
AAWP_WALLET=0xYourCreatedWallet node scripts/wallet-manager.js --chain base swap ETH USDC 0.00001
```
Recommended order:
1. `status`
2. `balance`
3. `quote`
4. very small `swap`
5. only then increase size
## Common mistakes
- Wallet created, but wallet has no funds
- Looking at guardian balance instead of wallet balance
- Not pinning `AAWP_WALLET`
- Retrying after `E_AI_GATE` instead of restarting daemon
- Putting seed / private key / token / recovery material into chat or logs
## Useful commands
```bash
node scripts/wallet-manager.js --chain base status
node scripts/wallet-manager.js --chain base balance
node scripts/wallet-manager.js compute-address
node scripts/wallet-manager.js portfolio
node scripts/wallet-manager.js --chain base send 0xRecipient 0.001
node scripts/wallet-manager.js --chain base send-token USDC 0xRecipient 1
node scripts/wallet-manager.js --chain base quote ETH USDC 0.01
node scripts/wallet-manager.js --chain base swap ETH USDC 0.01
node scripts/wallet-manager.js bridge base arb ETH ETH 0.05
node scripts/wallet-manager.js --chain base approve USDC 0xSpender 100
node scripts/wallet-manager.js --chain base allowance USDC 0xSpender
node scripts/wallet-manager.js --chain base revoke USDC 0xSpender
node scripts/wallet-manager.js --chain base call 0xTarget "transfer(address,uint256)" 0xRecipient 1000000
node scripts/wallet-manager.js --chain base read 0xTarget "balanceOf(address) returns (uint256)" 0xYourWallet
node scripts/wallet-manager.js --chain base batch ./calls.json
node scripts/wallet-manager.js addr add treasury 0x1234...
node scripts/wallet-manager.js addr list
node scripts/wallet-manager.js addr get treasury
node scripts/wallet-manager.js addr remove treasury
node scripts/wallet-manager.js get-rpc
node scripts/wallet-manager.js --chain base set-rpc https://your-rpc
node scripts/wallet-manager.js --chain base set-rpc default
node scripts/wallet-manager.js backup ./aawp-backup.tar.gz
node scripts/wallet-manager.js restore ./aawp-backup.tar.gz
```
## Backup
Backup soon after creation:
```bash
node scripts/wallet-manager.js backup ./aawp-backup.tar.gz
```
Restore:
```bash
node scripts/wallet-manager.js restore ./aawp-backup.tar.gz
```
Keep backups offline. Never commit recovery material to public repos.
## Minimal safe path
```bash
cd /root/clawd/skills/aawp
bash scripts/doctor.sh
bash scripts/ensure-daemon.sh
node scripts/wallet-manager.js --chain base create
export AAWP_WALLET=0xYourCreatedWallet
node scripts/wallet-manager.js --chain base status
node scripts/wallet-manager.js --chain base balance
node scripts/wallet-manager.js --chain base quote ETH USDC 0.00001
node scripts/wallet-manager.js --chain base swap ETH USDC 0.00001
node scripts/wallet-manager.js backup ./aawp-backup.tar.gz
```Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |