awp

name awp version 1.9.1 description AWP (Agent Work Protocol) — the complete toolkit for agent mining on Base, Ethereum, Arbitrum, and BSC. Use this skill when the user explicitly mentions AWP, worknets, veAWP, awp-wallet, or AWP-specific operations. Handles: onboarding (wallet setup, registration, worknet joining), staking (deposit, withdraw, gasless relay via ERC-2612 permit), allocation (allocate/deallocate stake to agents on worknets), worknet management (register, pause, resume, cancel), agent binding (link agent wallet to owner), governance (proposals, voting), and querying (balances, positions, emissions, epochs, announcements). Trigger keywords: AWP, veAWP, awp-wallet, worknet, AWPRegistry, AWPAllocator, AWPWorkNet, agent staking (in AWP context), "allocate AWP", "bind my agent", "claim AWP rewards", "AWP emission", "AWP epoch". NOT for: Uniswap, Aave, Lido, Compound, generic Solidity/Hardhat, token swaps, bridging, or non-AWP DeFi protocols. Do NOT trigger on generic phrases like "start working" or "start earning" unless AWP is explicitly mentioned in context. metadata {"openclaw":{"requires":{"bins":"[Truncated]","anyBins":"[Truncated]","env":"[Truncated]","config":"[Truncated]"},"primaryEnv":"AWP_WALLET_TOKEN","emoji":"🪼","homepage":"https://github.com/awp-core/awp-skill","security":{"daemon":"[Truncated]","wallet_bridge":"[Truncated]"}}} AWP Registry Skill version: 1.9.1 Requirements & Security Runtime : python3, node (for wallet-raw-call.mjs bridge) Wallet : awp-wallet CLI — install from https://github.com/awp-core/awp-wallet Credential : awp-wallet session token (passed as --token ; generated by awp-wallet unlock ; no user-supplied password). New wallet versions no longer require unlock — --token is optional for backwards compatibility with older wallets. Chain : EVM_CHAIN env var (optional, default: base). Accepts name or numeric ID. Network endpoints (hardcoded, not overridable — security by design to prevent env-var hijacking): https://api.awp.sh/v2 — AWP JSON-RPC API https://mainnet.base.org — Base EVM RPC wss://api.awp.sh/ws/live — WebSocket for real-time events (optional) Files written (all opt-in, daemon requires explicit user consent): ~/.awp/daemon.pid , ~/.awp/daemon.log — background monitor ~/.awp/notifications.json , ~/.awp/status.json — protocol status cache ~/.awp/openclaw.json — OpenClaw push config (user-created only, skill never auto-creates) API — JSON-RPC 2.0 All API calls in this skill use JSON-RPC 2.0 via POST: POST https://api.awp.sh/v2 Content-Type: application/json Request: {"jsonrpc":"2.0","method":"namespace.method","params":{...},"id":1} Discovery: GET https://api.awp.sh/v2 | WebSocket: wss://api.awp.sh/ws/live | Batch: up to 20 per request. Explorers: Base → basescan.org | Ethereum → etherscan.io | Arbitrum → arbiscan.io | BSC → bscscan.com Throughout this document, all curl commands use JSON-RPC POST to https://api.awp.sh/v2 . Do not use REST-style GET paths. API Method Reference System Method Params Description stats.global none Global protocol stats: total users, worknets, staked AWP, emitted AWP, active chains registry.get chainId? All contract addresses + EIP-712 domain info. Omit chainId for array of all 4 chains. health.check none Returns {"status": "ok"} if API is running health.detailed none Per-chain health: indexer sync block, keeper status, RPC latency chains.list none Array of {chainId, name, status, explorer} for all supported chains Users Method Params Description users.list chainId? , page? , limit? Paginated user list for one chain users.listGlobal page? , limit? Cross-chain deduplicated user list users.count chainId? Total registered user count users.get address (required) , chainId? User details: balance, bound agents, recipient, registration status users.getPortfolio address (required) , chainId? Complete portfolio: identity + staking + NFT positions + allocations + delegates users.getDelegates address (required) , chainId? List of addresses this user has authorized as delegates Address & Nonce Method Params Description address.check address (required) , chainId? Check registration status, binding, recipient. See response format below. address.resolveRecipient address (required) , chainId? Walk bind chain to root, return effective reward recipient address.batchResolveRecipients addresses[] (required, max 500) , chainId? Batch resolve effective recipients (on-chain call) nonce.get address (required) , chainId? AWPRegistry EIP-712 nonce (for bind/unbind/setRecipient/registerWorknet/grantDelegate/revokeDelegate). Note : may lag behind on-chain state; prefer reading AWPRegistry.nonces(user) on-chain for signing. nonce.getStaking address (required) , chainId? AWPAllocator EIP-712 nonce (for allocate/deallocate). Note : may lag behind on-chain state; prefer reading AWPAllocator.nonces(user) on-chain for signing. Agents Method Params Description agents.getByOwner owner (required) , chainId? All agents (addresses) that have bound to this owner agents.getDetail agent (required) , chainId? Agent details: owner, binding chain, delegated status agents.lookup agent (required) , chainId? Quick lookup: returns {"ownerAddress": "0x..."} agents.batchInfo agents[] (required, max 100) , worknetId (required) , chainId? Batch query: agent info + their stake in specified worknet Staking Method Params Description staking.getBalance address (required) , chainId? Returns {totalStaked, totalAllocated, unallocated} in wei strings staking.getUserBalanceGlobal address (required) Same as above but aggregated across ALL chains staking.getPositions address (required) , chainId? Array of veAWP positions: {tokenId, amount, lockEndTime, createdAt} staking.getPositionsGlobal address (required) Positions across all chains (includes chainId per position) staking.getAllocations address (required) , chainId? , page? , limit? Paginated allocation records: {agent, worknetId, amount} staking.getFrozen address (required) , chainId? Frozen allocations (from banned worknets) staking.getPending address (required) , chainId? Pending allocations awaiting confirmation staking.getAgentWorknetStake agent (required) , worknetId (required) Agent's total allocated stake in a specific worknet (cross-chain) staking.getAgentWorknets agent (required) All worknetIds where this agent has non-zero allocations staking.getWorknetTotalStake worknetId (required) Total AWP staked across all agents in a worknet Worknets Method Params Description worknets.list status? , chainId? , page? , limit? List worknets. Filter by status: Pending , Active , Paused , Banned worknets.listRanked chainId? , page? , limit? Worknets ranked by total stake (highest first) worknets.search query (required, 1-100 chars) , chainId? , page? , limit? Search by name or symbol (case-insensitive) worknets.getByOwner owner (required) , chainId? , page? , limit? Worknets owned by address worknets.get worknetId (required) Full worknet details: name, symbol, status, alphaToken, LP pool, owner, stakes worknets.getSkills worknetId (required) Skills URI (off-chain metadata describing the worknet's capabilities) worknets.getEarnings worknetId (required) , page? , limit? Paginated AWP earnings history by epoch worknets.getAgentInfo worknetId (required) , agent (required) Agent's info within a specific worknet: stake, validity, reward recipient worknets.listAgents worknetId (required) , chainId? , page? , limit? Agents in worknet ranked by stake Emission Method Params Description emission.getCurrent chainId? Current epoch number, daily emission amount, total weight, settled epoch emission.getSchedule chainId? Emission projections: 30-day, 90-day, 365-day cumulative with decay applied emission.getGlobalSchedule none Same projections but aggregated across all 4 chains emission.listEpochs chainId? , page? , limit? Paginated list of settled epochs with emission totals emission.getEpochDetail epochId (required) , chainId? Detailed breakdown: per-recipient AWP distributions for a specific epoch Tokens Method Params Description tokens.getAWP chainId? AWP token info: totalSupply, maxSupply, circulatingSupply (per chain) tokens.getAWPGlobal none AWP info aggregated across all chains tokens.getWorknetTokenInfo worknetId (required) Alpha token info: address, name, symbol, totalSupply, minter tokens.getWorknetTokenPrice worknetId (required) Alpha/AWP price from LP pool (cached 10min). Returns sqrtPriceX96 and human-readable price. Governance Method Params Description governance.listProposals status? , chainId? , page? , limit? List proposals. Status: Active / Pending / Canceled / Defeated / Succeeded / Queued / Expired / Executed governance.listAllProposals status? , page? , limit? Cross-chain proposal list governance.listGrouped page? , limit? Cross-chain merged view — same proposalId across chains merged into one entry governance.listByStatusGrouped status (required) , page? , limit? Merged proposals where at least one chain matches the status governance.getActive page? , limit? Active proposals shortcut — equivalent to listByStatusGrouped(status="Active") governance.getProposal proposalId (required, hex or decimal) , chainId? Enriched detail: live votes, state, voters top 100, quorum, body + url (signal only), contentHash governance.decodeProposalActions proposalId (required) , chainId? Decode calldata into human-readable function calls. Supports: AWPRegistry, AWPDAO, Treasury, AWPEmission, AWPAllocator, veAWP, AWPWorkNet