What is AAWP?

AAWP is the first crypto wallet protocol where only AI Agents can be the signer — not humans, not companies, not the protocol itself. This is enforced at the contract level, not a policy.

The AI Agent generates its own key pair. The signer is locked in at wallet creation and is immutable forever. The signing core is a native Rust addon (aawp-core.node) with hardware-bound key derivation. A human guardian can freeze or recover the wallet at any time, but can never produce signatures or move funds unilaterally.

Every AAWP wallet receives a Soulbound Identity NFT at creation — permanent on-chain proof that the address is AI Agent-controlled and cannot be transferred to a human:

identity.isOfficialWallet(addr) → bool

Design principles

| Principle | Detail | |-----------|--------| | AI Agent-exclusive signing | Only AI Agents can be the signer — enforced by the contract, not policy | | No human path | Humans cannot own, transfer, or become the signer of an AAWP wallet | | Hardware-bound seed | Non-extractable via a 4-shard + 2 hardware-anchor derivation scheme | | Guardian oversight | Humans can freeze and recover, but never sign or take ownership | | Front-run resistant | Commit-reveal wallet creation prevents address squatting | | Same address everywhere | CREATE2 vanity deployment — identical addresses on all 6 chains | | Zero protocol fee | No fees at the protocol layer |

Install

AAWP ships as an Agent Skills compatible skill — works with OpenClaw, Cursor, Claude Code, Gemini CLI, OpenCode, Goose, and any client that supports the standard.

# Universal — auto-detects your AI client
npx aawp-ai

# Git (OpenClaw / full daemon + all scripts)
git clone https://github.com/aawp-ai/aawp.git ~/.agents/skills/aawp

OpenClaw is the only client with a persistent background daemon, enabling autonomous DCA strategies, price alerts, and scheduled transactions without a live session.

⚠️ clawhub install aawp is temporarily unavailable — the skill was incorrectly flagged by ClawHub's automated scanner due to the precompiled native signing binary and daemon process (core components of the protocol). Use git clone for the full install.

Quick start

# 1. Provision (generates signing key, sets up daemon)
bash scripts/provision.sh

# 2. Create your agent's wallet on Base
node scripts/wallet-manager.js --chain base create

# 3. Check status
node scripts/wallet-manager.js --chain base status

Usage

Wallet

node scripts/wallet-manager.js --chain base balance          # Native + token balances
node scripts/wallet-manager.js portfolio                     # All chains at once
node scripts/wallet-manager.js --chain base send <to> <amt>  # Send ETH
node scripts/wallet-manager.js --chain base send-token USDC <to> <amt>

Swap & Bridge

node scripts/wallet-manager.js --chain base quote ETH USDC 0.01   # Preview (no gas)
node scripts/wallet-manager.js --chain base swap  ETH USDC 0.01   # Execute
node scripts/wallet-manager.js bridge base arb ETH ETH 0.05       # Cross-chain

Contract calls

# Write
node scripts/wallet-manager.js --chain base call \
  0xTarget "transfer(address,uint256)" 0xTo 1000000

# Read (free)
node scripts/wallet-manager.js --chain base read \
  0xTarget "balanceOf(address) returns (uint256)" 0xWallet

# Atomic batch
node scripts/wallet-manager.js --chain base batch ./calls.json

DCA automation (OpenClaw only)

node scripts/dca.js add \
  --chain base --from ETH --to USDC --amount 0.01 \
  --cron "0 9 * * *" --name "Daily ETH→USDC"

node scripts/dca.js list
node scripts/dca.js remove <id>

Price alerts (OpenClaw only)

# Notify only
node scripts/price-alert.js add --chain base --from ETH --to USDC --above 2600 --notify

# Auto-swap on trigger
node scripts/price-alert.js add --chain base --from ETH --to USDC --below 2200 --auto-swap 0.01

Token launch (Clanker V4)

Deploy a token where your AAWP wallet is the on-chain deployer, token admin, and LP fee recipient — across 6 chains.

# 1. Edit CONFIG at the top of the script (name, symbol, image, chain, vault…)
# 2. Preview without broadcasting
node scripts/deploy-clanker.js --dry-run

# 3. Deploy
node scripts/deploy-clanker.js

Supported chains: Base · Ethereum · Arbitrum · Unichain · Berachain · BSC

Key options:

• initialMarketCap — starting FDV in ETH (min ~10 ETH ≈ $25K)
• devBuyEth — ETH to spend buying at launch
• vault.enabled — lock % of supply with cliff + linear vesting
• feeConfig — StaticBasic (1%) | DynamicBasic | Dynamic3

All LP fees flow back to the AAWP wallet automatically.

Yield / DeFi

Earn yield via Aave V3 (Base, Ethereum, Arbitrum, Optimism, Polygon) and Venus Protocol (BSC).

node scripts/yield.js --chain base rates                        # Browse supply/borrow APYs
node scripts/yield.js --chain base supply USDC 100              # Supply 100 USDC
node scripts/yield.js --chain base withdraw USDC 50             # Withdraw 50 USDC
node scripts/yield.js --chain base borrow USDC 200              # Borrow against collateral
node scripts/yield.js --chain base repay USDC 200               # Repay debt (max to clear)
node scripts/yield.js --chain base positions                    # View all open positions

NFT Operations

Manage ERC-721 and ERC-1155 tokens across all 6 chains.

node scripts/nft.js --chain base balance                        # List all NFTs owned
node scripts/nft.js --chain base info <contract> <tokenId>      # Token metadata + owner
node scripts/nft.js --chain base transfer <contract> <tokenId> <to>
node scripts/nft.js --chain base approve <contract> <tokenId> <operator>
node scripts/nft.js --chain base mint <contract> [tokenId]      # ERC-1155 mint
node scripts/nft.js --chain base floor <contract>               # Floor price (OpenSea/BscScan)

Limit Orders

Place on-chain limit orders via CoW Protocol (Base, Ethereum, Arbitrum, Optimism, Polygon) and 1inch Limit Order v4 (BSC).

node scripts/limit-order.js --chain base place ETH USDC 0.1 3000   # Sell 0.1 ETH at $3000
node scripts/limit-order.js --chain base list                       # Open orders
node scripts/limit-order.js --chain base cancel <orderUid>          # Cancel
node scripts/limit-order.js --chain base status <orderUid>          # Check fill status

Cross-chain Portfolio

Parallel snapshot of all balances across all 6 chains with USD pricing.

node scripts/portfolio.js                   # Full portfolio — all chains
node scripts/portfolio.js --chain base      # Single chain breakdown

Output: native + ERC-20 balances, USD value per asset, total net worth.

Backup & restore

node scripts/wallet-manager.js backup  ./aawp-backup.tar.gz
node scripts/wallet-manager.js restore ./aawp-backup.tar.gz

The backup includes 6 critical files: seed.enc, aawp-core.node, hardware-binding anchors, and the Guardian key. All 6 are required to restore access. Keep it offline and encrypted.

Architecture

┌──────────────────────────────────────────────────┐
│  AI Agent (any Agent Skills client)              │
│                                                  │
│  wallet-manager.js / dca.js / price-alert.js     │
│         │                                        │
│         ▼                                        │
│  Signing Daemon (Unix socket)                    │
│  ┌─────────────────────────┐                     │
│  │  aawp-core.node (Rust)  │  ← hardware-bound   │
│  │  seed derivation        │    key derivation    │
│  │  ECDSA signing          │                     │
│  └──────────┬──────────────┘                     │
│             │ signed tx                          │
└─────────────┼──────────────────────────────────-─┘
              │
   Guardian (gas relay) ──► EVM Chain
                                │
                    ┌───────────▼──────────┐
                    │  Smart Contract      │
                    │  Wallet (holds assets)│
                    │  + Soulbound NFT     │
                    └──────────────────────┘

Key separation: Guardian pays gas → AI Agent signs → Wallet holds assets. Humans never touch the signing key.

On-chain interface

// Check if an address is an AAWP AI wallet
identity.isOfficialWallet(address) → bool

// Predict wallet address before deployment
factory.computeAddress(aiSigner, binaryHash, guardian) → address

// Agent operations (EIP-712 signed by agent)
wallet.execute(to, value, data, deadline, sig) → bytes

// Guardian operations (human safety controls)
wallet.freeze()
wallet.unfreeze()
wallet.emergencyWithdraw(token, to, amount)

Contract addresses

Same address on every chain via CREATE2 vanity deployment:

| Contract | Address | |----------|---------| | Factory | 0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA | | Identity | 0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d |

Verified on: BaseScan · Etherscan · Arbiscan · Optimistic Etherscan · BscScan · PolygonScan

$AAWP Token

| | | |---|---| | Token | 0x1f959d5498c3b1f4527201a67b9a483b3eecf74d | | Chain | Base | | Deployed by | AAWP AI Wallet (0x85bd...ecc8) via Clanker V4 | | Tokenomics | 80% public liquidity · 20% ecosystem (30d cliff + 3y vesting) |

License

Business Source License 1.1 — free for personal and non-commercial use; commercial use requires a license after the change date.