npm - aawp-ai - Versions diffs - 1.3.4 → 1.5.1 - Mend

aawp-ai 1.3.4 → 1.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/LICENSE ADDED Viewed

@@ -0,0 +1,62 @@
+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.

package/README.md CHANGED Viewed

@@ -1,83 +1,299 @@
-# AAWP — AI Agent Wallet Protocol
+<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>
-<p>
+<p align="center">
   <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="chains">
-  <img src="https://img.shields.io/badge/License-BUSL--1.1-1a1a2e?style=flat-square" alt="license">
+  <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>
 </p>
-The only crypto wallet protocol built exclusively for AI Agents. Not for humans. The AI Agent is the signer — by protocol, by design, forever.
+---
+## What is AAWP?
-**[aawp.ai](https://aawp.ai) · [GitHub](https://github.com/aawp-ai/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:
+```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 |
 ---
 ## 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
 ```
-Auto-detects your AI client (OpenClaw, Cursor, Claude Code, Gemini CLI, OpenCode, Goose) and installs the AAWP skill.
+> **OpenClaw** is the only client with a persistent background daemon, enabling autonomous DCA strategies, price alerts, and scheduled transactions without a live session.
 ---
-## What it does
+## Quick start
-- Installs `SKILL.md` to your AI client's skills directory
-- For OpenClaw: runs `clawhub install aawp` for full daemon + cron support
+```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
+```
 ---
-## What is AAWP?
+## 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
-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.
+```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
+```
-Key features:
+### DCA automation *(OpenClaw only)*
-- **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)
+```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
+```
+**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.
 ---
-## Quick start (after install)
+### Yield / DeFi
+Earn yield via **Aave V3** (Base, Ethereum, Arbitrum, Optimism, Polygon) and **Venus Protocol** (BSC).
-Ask your AI agent:
+```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
+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)
 ```
-set up my AAWP wallet
+### 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
 ```
-Or run directly:
+Output: native + ERC-20 balances, USD value per asset, total net worth.
+---
+### Backup & restore
 ```bash
-# Provision signing key + daemon
-bash ~/.agents/skills/aawp/scripts/provision.sh
+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
-# Create wallet on Base
-node ~/.agents/skills/aawp/scripts/wallet-manager.js --chain base create
+```
+┌──────────────────────────────────────────────────┐
+│  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 balance
-node ~/.agents/skills/aawp/scripts/wallet-manager.js --chain base balance
+```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)
 ```
 ---
-## Contract addresses (same on all chains)
+## Contract addresses
+Same address on every chain via CREATE2 vanity deployment:
 | Contract | Address |
 |----------|---------|
-| Factory | `0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA` |
-| Identity | `0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d` |
+| **Factory** | [`0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA`](https://basescan.org/address/0xAAAA3Df87F112c743BbC57c4de1700C72eB7aaAA) |
+| **Identity** | [`0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d`](https://basescan.org/address/0xAAAafBf6F88367C75A9B701fFb4684Df6bCA1D1d) |
+Verified on: BaseScan · Etherscan · Arbiscan · Optimistic Etherscan · BscScan · PolygonScan
 ---
-## Links
+## License
-- 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)
+[Business Source License 1.1](LICENSE) — free for personal and non-commercial use; commercial use requires a license after the change date.

package/bin/install.js CHANGED Viewed

File without changes

package/package.json CHANGED Viewed

@@ -1,32 +1,23 @@
 {
   "name": "aawp-ai",
-  "version": "1.3.4",
-  "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",
+  "version": "1.5.1",
+  "description": "AAWP — AI Agent Wallet Protocol skill installer",
   "bin": {
     "aawp-ai": "bin/install.js"
   },
-  "main": "./bin/install.js",
   "scripts": {
-    "postinstall": "node ./bin/install.js"
-  },
-  "engines": {
-    "node": ">=16"
+    "postinstall": "node bin/install.js"
   },
   "files": [
-    "bin/",
+    "bin/install.js",
     "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"
 }