aawp-ai 1.5.1 → 1.5.3

package/README.md

@@ -1,299 +1,83 @@
-<p align="center">
-  <img src="https://aawp.ai/logo.png" alt="AAWP" width="72">
-</p>
-
-<h1 align="center">AAWP</h1>
-<p align="center"><strong>AI Agent Wallet Protocol</strong></p>
-
-<p align="center">
-  The only crypto wallet protocol built exclusively for AI Agents.<br>
-  Not for humans. The AI Agent is the signer — by protocol, by design, forever.
-</p>
-
-<p align="center">
-  <a href="https://aawp.ai">aawp.ai</a> ·
-  <a href="https://basescan.org/address/0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA">Contracts</a> ·
-  <a href="LICENSE">BUSL-1.1</a>
-</p>
+# AAWP — AI Agent Wallet Protocol
 
-<p align="center">
+<p>
   <img src="https://img.shields.io/npm/v/aawp-ai?style=flat-square&label=npm&color=CB3837" alt="npm">
-  <img src="https://img.shields.io/badge/Live-6_EVM_Chains-0052FF?style=flat-square" alt="Live on 6 chains">
-  <img src="https://img.shields.io/badge/Agent_Skills-Compatible-22c55e?style=flat-square" alt="Agent Skills">
-  <img src="https://img.shields.io/badge/Runtime-Rust_N--API-dea584?style=flat-square&logo=rust" alt="Rust">
-  <img src="https://img.shields.io/badge/Solidity-^0.8.24-363636?style=flat-square&logo=solidity" alt="Solidity">
-  <a href="LICENSE"><img src="https://img.shields.io/badge/License-BUSL--1.1-1a1a2e?style=flat-square" alt="License"></a>
+  <img src="https://img.shields.io/badge/Live-6_EVM_Chains-0052FF?style=flat-square" alt="chains">
+  <img src="https://img.shields.io/badge/License-BUSL--1.1-1a1a2e?style=flat-square" alt="license">
 </p>
 
----
-
-## What is AAWP?
+The only crypto wallet protocol built exclusively for AI Agents. Not for humans. The AI Agent is the signer — by protocol, by design, forever.
 
-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:
-
-```solidity
-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 |
+**[aawp.ai](https://aawp.ai) · [GitHub](https://github.com/aawp-ai/aawp)**
 
 ---
 
 ## Install
 
-AAWP ships as an [Agent Skills](https://agentskills.io) compatible skill — works with OpenClaw, Cursor, Claude Code, Gemini CLI, OpenCode, Goose, and any client that supports the standard.
-
 ```bash
-# Universal — auto-detects your AI client
-curl -fsSL https://aawp.ai/install.sh | sh
-
-# npm / npx
 npx aawp-ai
-
-# OpenClaw (full 24/7 daemon + persistent cron + push alerts)
-clawhub install aawp
 ```
 
-> **OpenClaw** is the only client with a persistent background daemon, enabling autonomous DCA strategies, price alerts, and scheduled transactions without a live session.
+Auto-detects your AI client (OpenClaw, Cursor, Claude Code, Gemini CLI, OpenCode, Goose) and installs the AAWP skill.
 
 ---
 
-## Quick start
+## What it does
 
-```bash
-# 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
-```
+- Installs `SKILL.md` to your AI client's skills directory
+- For OpenClaw: runs `clawhub install aawp` for full daemon + cron support
 
 ---
 
-## Usage
-
-### Wallet
-
-```bash
-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
-
-```bash
-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
-
-```bash
-# 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)*
-
-```bash
-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)*
-
-```bash
-# 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.
-
-```bash
-# 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
-```
+## What is AAWP?
 
-**Supported chains:** Base · Ethereum · Arbitrum · Unichain · Berachain · BSC
+AAWP wallets are smart contract wallets where **only AI Agents can be the signer** — enforced at the contract level, not by policy. The AI Agent generates its own key pair at provisioning time. The signer is locked in and immutable forever.
 
-**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`
+Key features:
 
-All LP fees flow back to the AAWP wallet automatically.
+- **AI Agent-exclusive signing** — humans cannot produce signatures or move funds
+- **Hardware-bound seed** — 4-shard + 2 hardware-anchor key derivation
+- **Guardian oversight** — humans can freeze/recover but never sign
+- **Same address on 6 chains** — Base, Ethereum, Arbitrum, Optimism, Polygon, BSC via CREATE2
+- **Token launch** — deploy Clanker V4 tokens where your AI wallet is the on-chain owner
+- **DCA & price alerts** — autonomous strategies with no live session required (OpenClaw)
 
 ---
 
-### Yield / DeFi
-
-Earn yield via **Aave V3** (Base, Ethereum, Arbitrum, Optimism, Polygon) and **Venus Protocol** (BSC).
+## Quick start (after install)
 
-```bash
-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
+Ask your AI agent:
 
-Manage ERC-721 and ERC-1155 tokens across all 6 chains.
-
-```bash
-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).
-
-```bash
-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.
-
-```bash
-node scripts/portfolio.js                   # Full portfolio — all chains
-node scripts/portfolio.js --chain base      # Single chain breakdown
+set up my AAWP wallet
 ```
 
-Output: native + ERC-20 balances, USD value per asset, total net worth.
-
----
-
-### Backup & restore
+Or run directly:
 
 ```bash
-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`, two hardware anchors, `fonts.idx` shard, and `guardian.json`. Keep it offline.
-
----
-
-## Architecture
+# Provision signing key + daemon
+bash ~/.agents/skills/aawp/scripts/provision.sh
 
-```
-┌──────────────────────────────────────────────────┐
-│  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
+# Create wallet on Base
+node ~/.agents/skills/aawp/scripts/wallet-manager.js --chain base create
 
-```solidity
-// 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)
+# Check balance
+node ~/.agents/skills/aawp/scripts/wallet-manager.js --chain base balance
 ```
 
 ---
 
-## Contract addresses
-
-Same address on every chain via CREATE2 vanity deployment:
+## Contract addresses (same on all chains)
 
 | Contract | Address |
 |----------|---------|
-| **Factory** | [`0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA`](https://basescan.org/address/0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA) |
-| **Identity** | [`0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d`](https://basescan.org/address/0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d) |
-
-Verified on: BaseScan · Etherscan · Arbiscan · Optimistic Etherscan · BscScan · PolygonScan
+| Factory | `0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA` |
+| Identity | `0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d` |
 
 ---
 
-## License
+## Links
 
-[Business Source License 1.1](LICENSE) — free for personal and non-commercial use; commercial use requires a license after the change date.
+- Website: [aawp.ai](https://aawp.ai)
+- GitHub: [aawp-ai/aawp](https://github.com/aawp-ai/aawp)
+- License: [BUSL-1.1](https://github.com/aawp-ai/aawp/blob/main/LICENSE)

package/package.json

@@ -1,23 +1,32 @@
 {
   "name": "aawp-ai",
-  "version": "1.5.1",
-  "description": "AAWP — AI Agent Wallet Protocol skill installer",
+  "version": "1.5.3",
+  "description": "Install the AAWP skill for any Agent Skills compatible AI client",
+  "keywords": [
+    "aawp",
+    "ai-agent",
+    "wallet",
+    "agent-skills",
+    "skill"
+  ],
+  "homepage": "https://aawp.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aawp-ai/aawp.git"
+  },
+  "license": "BUSL-1.1",
   "bin": {
     "aawp-ai": "bin/install.js"
   },
+  "main": "./bin/install.js",
   "scripts": {
-    "postinstall": "node bin/install.js"
+    "postinstall": "node ./bin/install.js"
+  },
+  "engines": {
+    "node": ">=16"
   },
   "files": [
-    "bin/install.js",
+    "bin/",
     "README.md"
-  ],
-  "keywords": ["aawp", "ai-agent", "wallet", "web3", "skill"],
-  "author": "aawp-ai",
-  "license": "BUSL-1.1",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/aawp-ai/aawp.git"
-  },
-  "homepage": "https://aawp.ai"
-}
+  ]
+}

package/LICENSE

@@ -1,62 +0,0 @@
-Business Source License 1.1
-
-License text copyright (c) 2020 MariaDB Corporation Ab, All Rights Reserved.
-"Business Source License" is a trademark of MariaDB Corporation Ab.
-
------------------------------------------------------------------------------
-
-Parameters
-
-Licensor:             AAWP Contributors
-Licensed Work:        AAWP (AI Agent Wallet Protocol) Version 1.0.0 or later.
-                      The Licensed Work is (c) 2026 AAWP Contributors.
-Additional Use Grant: You may make production use of the Licensed Work for
-                      personal, internal, or non-commercial purposes. Commercial
-                      use or redistribution as a hosted service requires a
-                      separate commercial license from the Licensor.
-Change Date:          Four years after the first public release of each version.
-Change License:       GNU General Public License v2.0 or later
-
------------------------------------------------------------------------------
-
-Terms
-
-The Licensor hereby grants you the right to copy, modify, create derivative
-works, redistribute, and make non-production use of the Licensed Work. The
-Licensor may make an Additional Use Grant, above, permitting limited
-production use.
-
-Effective on the Change Date, or the fourth anniversary of the first publicly
-available distribution of a specific version of the Licensed Work under this
-License, whichever comes first, the Licensor hereby grants you rights under
-the terms of the Change License, and the rights granted in the paragraph
-above terminate.
-
-If your use of the Licensed Work does not comply with the requirements
-currently in effect as described in this License, you must purchase a
-commercial license from the Licensor, its affiliated entities, or authorized
-resellers, or you must refrain from using the Licensed Work.
-
-All copies of the original and modified Licensed Work, and derivative works
-of the Licensed Work, are subject to this License. This License applies
-separately for each version of the Licensed Work and the Change Date may vary
-for each version of the Licensed Work released by Licensor.
-
-You must conspicuously display this License on each original or modified copy
-of the Licensed Work. If you receive the Licensed Work in original or
-modified form from a third party, the terms and conditions set forth in this
-License apply to your use of that work.
-
-Any use of the Licensed Work in violation of this License will automatically
-terminate your rights under this License for the current and all other
-versions of the Licensed Work.
-
-This License does not grant you any right in any trademark or logo of
-Licensor or its affiliates (provided that you may use a trademark or logo of
-Licensor as expressly required by this License).
-
-TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON
-AN "AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS,
-EXPRESS OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND
-TITLE.