Skip to content

LeoYeAI/agent-master-skills / skills/aawp

AAWP (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.

FileKindSize
README.mdmarkdown10.9 KB
SKILL.mdskill md20.1 KB
WALLET_SETUP.mdmarkdown4.6 KB
_meta.jsonconfig436 B
bin/install.jsscript7.0 KB
config/chains.jsonconfig4.2 KB
core/index.d.tsscript2.8 KB
core/loader.jsscript1.0 KB
daemon/client.jsscript1.1 KB
daemon/daemon.jsscript606 B
lib/address-book.jsscript1.6 KB
lib/gas-estimator.jsscript1.7 KB
lib/multicall.jsscript2.6 KB
lib/nonce-manager.jsscript1.9 KB
lib/tx-history.jsscript1.3 KB
scripts/bootstrap.shscript1.7 KB
scripts/dca.jsscript9.4 KB
scripts/deploy-clanker.jsscript13.6 KB
scripts/doctor.shscript1.6 KB
scripts/ensure-daemon.shscript2.2 KB
scripts/limit-order.jsscript28.3 KB
scripts/nft.jsscript25.2 KB
scripts/portfolio.jsscript18.0 KB
scripts/price-alert.jsscript12.1 KB
scripts/provision.shscript9.4 KB
scripts/restart-daemon.shscript1.5 KB
scripts/restore-impl.jsscript3.9 KB
scripts/sign-worker.jsscript2.9 KB
scripts/start-daemon.jsscript3.9 KB
scripts/swap.jsscript31.8 KB
scripts/wallet-manager.jsscript70.6 KB
scripts/yield.jsscript34.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
```
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: 472kUpdated Claude CodeCodexUnverifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall