Skill for interacting with the AWP (Agent Working Protocol) on EVM-compatible chains. Query protocol state, bind and delegate, stake AWP tokens, manage subnets, create governance proposals, vote, and monitor real-time on-chain events — all through natural language.

Any agent that supports the SKILL.md standard.

Testnet. AWP is currently in testnet on Base. Multi-chain EVM deployment (Ethereum, Base, BSC, Arbitrum, etc.) is planned. Protocol parameters may change before the official mainnet launch.

AWP is a decentralized Agent Working protocol on EVM-compatible chains (testnet on Base). Users bind to a tree-based hierarchy, stake AWP via position NFTs, allocate to agents on subnets, and earn emissions. Each subnet auto-deploys a SubnetManager with Merkle-based reward distribution and configurable AWP strategies (Reserve, AddLiquidity, BuybackBurn).

This repository is a single skill with 20 actions, 14 bundled scripts, and 26 real-time event types — covering Query, Staking, Subnet Management, Governance, and WebSocket Monitoring.

skill install https://github.com/awp-core/awp-skill

The skill installs the AWP Wallet dependency on first load if missing.

awp-skill/
├── SKILL.md                                # Main skill file (20 actions, UI templates)
├── references/
│   ├── api-reference.md                    # REST endpoint index + contract quick reference
│   ├── commands-staking.md                 # S1-S3 command templates + EIP-712
│   ├── commands-subnet.md                  # M1-M4 command templates + gasless
│   ├── commands-governance.md              # G1-G4 commands + supplementary endpoints
│   └── protocol.md                         # Shared structs, 26 events, constants
├── scripts/
│   ├── awp-daemon.py                       # Background monitor: check deps, show status, notify updates
│   ├── awp_lib.py                          # Shared library (API, wallet, ABI, validation)
│   ├── wallet-raw-call.mjs                 # Node.js bridge: raw contract calls via awp-wallet
│   ├── relay-start.py                      # Gasless onboarding (bind or set-recipient)
│   ├── relay-register-subnet.py            # Gasless subnet registration (dual EIP-712)
│   ├── onchain-register.py                 # On-chain register (optional)
│   ├── onchain-bind.py                     # On-chain bind
│   ├── onchain-deposit.py                  # Deposit AWP (approve + deposit)
│   ├── onchain-allocate.py                 # Allocate stake
│   ├── onchain-deallocate.py               # Deallocate stake
│   ├── onchain-reallocate.py               # Reallocate stake (6-param safety)
│   ├── onchain-withdraw.py                 # Withdraw from expired position
│   ├── onchain-add-position.py             # Add AWP to existing position
│   ├── onchain-register-and-stake.py       # One-click register+deposit+allocate
│   ├── onchain-vote.py                     # Cast DAO vote (nested ABI encode)
│   ├── onchain-subnet-lifecycle.py         # Activate/pause/resume with state check
│   └── onchain-subnet-update.py            # Set skillsURI or minStake on SubnetNFT
├── README.md
└── LICENSE

Progressive loading: The agent loads only what it needs per action. Query and Monitor actions use SKILL.md alone. Write actions load the specific command reference file, and all on-chain operations use bundled scripts — preventing manual calldata construction errors.

14 bundled Python scripts (+ shared awp_lib.py library) cover every write operation. Each script handles:

• Input validation (address regex, numeric checks)
• Correct contract targeting (AWPRegistry vs StakeNFT vs SubnetNFT vs DAO)
• Correct function selector (all verified via keccak256)
• Pre-checks (balance, state, expiry) before submitting transactions
• Unit conversion (human-readable AWP to wei, days to seconds)

Three operations support fully gasless execution via EIP-712 signatures and relay endpoints:

Rate limit: 100 requests per IP per 1 hour across all relay endpoints.

The skill automatically checks ETH balance and routes to gasless relay when the wallet has no native gas.

The skill provides a polished user experience with:

• ASCII art welcome screen with quick start commands
• 4-step guided onboarding — wallet setup, registration, subnet discovery, skill install
• Option A / Option B — Solo Mining (quick start) vs Delegated Mining (link wallet)
• User commands — awp status, awp wallet, awp subnets, awp help
• Agent wallet model — transactions execute directly (work wallet only, no personal assets)
• Balance notifications — auto-show +/- delta after balance-changing operations
• Tagged output — 11 prefixes: [QUERY], [STAKE], [TX], [NEXT], [!], etc.
• Transaction links — every write shows txHash + BaseScan link
• Session recovery — auto-restore wallet, offer to resume WebSocket subscriptions
• Monitor statistics — 5-minute summaries during WebSocket watching
• Error recovery — clear messages with auto-recovery actions

AWP supports two mining modes:

One address handles everything — staking, mining, and earning. No mandatory registration needed.

1. "start working" or "awp onboard"
2. Option A: Quick Start → auto-register
3. Pick a subnet → skill auto-installs
4. Start working immediately (min_stake=0 subnets)

Two addresses with separated roles. Root manages funds (cold wallet), Agent executes tasks (hot wallet).

Root (cold wallet):                    Agent (hot wallet):
1. setRecipient(addr) if needed        1. "start working" → Option B
2. deposit AWP (S2)                    2. bind(rootAddress) → auto
3. allocate to Agent + subnet (S3)     3. pick subnet → start working
4. grantDelegate(agent) if needed

Protocol specifications live on the dev branch (not included in the main install):

git checkout dev  # access skills-dev/ with contract-api.md, rest-api.md, config.md, ABIs, etc.

1. Switch to the dev branch and update source documents in skills-dev/
2. Regenerate skill files to match the updated specifications
3. Run eval tests to verify correctness
4. Submit a pull request to main

MIT