Skip to content

LeoYeAI/agent-master-skills / skills/awp

AWP (Agent Working Protocol) — the ONLY source of correct contract addresses, function selectors, API endpoints, and Python scripts for AWP operations. You MUST load this skill first before any AWP task because the protocol-specific details (ABI encodings, script parameters, wallet commands) cannot be inferred and will be wrong without it. Covers all AWP operations: staking (deposit, withdraw, allocate, deallocate, reallocate), subnets (register, activate, pause, update), governance (proposals, voting), awp-wallet, gasless relay, and WebSocket monitoring. Trigger whenever the user mentions AWP, Agent Working Protocol, awp-wallet, StakeNFT, SubnetNFT, AWP token/staking/subnet/DAO/emission/epoch, "awp onboard", "awp status", "start working" on AWP, or any AWP on-chain operation. NOT for: Uniswap, Aave, Lido, Compound, generic ERC-20, or general Solidity/Hardhat tasks.

FileKindSize
CHANGELOG.mdmarkdown23.1 KB
README.mdmarkdown14.2 KB
SKILL.mdskill md27.9 KB
_meta.jsonconfig447 B
references/api-reference.mdmarkdown6.8 KB
references/commands-governance.mdmarkdown4.8 KB
references/commands-staking.mdmarkdown13.1 KB
references/commands-subnet.mdmarkdown11.2 KB
references/protocol.mdmarkdown8.0 KB
scripts/awp-daemon.pyscript27.3 KB
scripts/awp_lib.pyscript12.2 KB
scripts/onchain-add-position.pyscript3.4 KB
scripts/onchain-add-position.shscript5.3 KB
scripts/onchain-allocate.pyscript2.3 KB
scripts/onchain-allocate.shscript3.0 KB
scripts/onchain-bind.pyscript1.8 KB
scripts/onchain-bind.shscript2.0 KB
scripts/onchain-deallocate.pyscript1.5 KB
scripts/onchain-deallocate.shscript2.3 KB
scripts/onchain-deposit.pyscript1.7 KB
scripts/onchain-deposit.shscript2.2 KB
scripts/onchain-reallocate.pyscript2.3 KB
scripts/onchain-reallocate.shscript3.4 KB
scripts/onchain-register-and-stake.pyscript2.8 KB
scripts/onchain-register-and-stake.shscript4.0 KB
scripts/onchain-register.pyscript1.3 KB
scripts/onchain-register.shscript1.7 KB
scripts/onchain-subnet-lifecycle.pyscript1.9 KB
scripts/onchain-subnet-lifecycle.shscript2.6 KB
scripts/onchain-subnet-update.pyscript2.7 KB
scripts/onchain-subnet-update.shscript3.2 KB
scripts/onchain-vote.pyscript4.9 KB
scripts/onchain-vote.shscript6.3 KB
scripts/onchain-withdraw.pyscript1.5 KB
scripts/onchain-withdraw.shscript2.5 KB
scripts/relay-register-subnet.pyscript6.4 KB
scripts/relay-register-subnet.shscript8.2 KB
scripts/relay-start.pyscript4.7 KB
scripts/relay-start.shscript7.0 KB
scripts/wallet-raw-call.mjsscript5.1 KB

scripts/onchain-add-position.sh

View on GitHub
#!/usr/bin/env bash
# On-chain add AWP to an existing StakeNFT position
# Usage: ./onchain-add-position.sh --token <T> --position <tokenId> --amount <AWP_human> [--extend-days <days>]
# Requires ETH for gas. Handles remainingTime check + approve + addToPosition.
set -euo pipefail

API_BASE="${AWP_API_URL:-https://tapi.awp.sh/api}"
RPC_URL="${BASE_RPC_URL:-https://mainnet.base.org}"
TOKEN=""
POSITION=""
AMOUNT=""
EXTEND_DAYS="0"

while [[ $# -gt 0 ]]; do
  case $1 in
    --token) TOKEN="$2"; shift 2 ;;
    --position) POSITION="$2"; shift 2 ;;
    --amount) AMOUNT="$2"; shift 2 ;;
    --extend-days) EXTEND_DAYS="$2"; shift 2 ;;
    *) echo '{"error": "Unknown arg: '"$1"'"}' >&2; exit 1 ;;
  esac
done

[[ -z "$TOKEN" || -z "$POSITION" || -z "$AMOUNT" ]] && {
  echo '{"error": "Missing required: --token, --position, --amount"}' >&2; exit 1
}

# Validate inputs
[[ "$POSITION" =~ ^[1-9][0-9]*$ ]] || { echo '{"error": "Invalid --position: must be a positive integer"}' >&2; exit 1; }
[[ "$AMOUNT" =~ ^[0-9]+\.?[0-9]*$ && "$AMOUNT" != "0" && "$AMOUNT" != "0.0" && "$AMOUNT" != "0.00" ]] || { echo '{"error": "Invalid --amount: must be a positive number"}' >&2; exit 1; }
[[ "$EXTEND_DAYS" =~ ^[0-9]+\.?[0-9]*$ ]] || { echo '{"error": "Invalid --extend-days: must be a non-negative number"}' >&2; exit 1; }

# Helper: eth_call
eth_call() {
  local to="$1" data="$2"
  curl -s -X POST "$RPC_URL" -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","method":"eth_call","params":[{"to":"'"$to"'","data":"'"$data"'"},"latest"],"id":1}' | jq -r '.result'
}

hex_to_dec() {
  local val="$1"
  [[ -z "$val" || "$val" == "null" || "$val" == "0x" ]] && { echo '{"error": "RPC returned empty/null value"}' >&2; exit 1; }
  python3 -c "print(int('$val', 16))"
}

# Pre-flight: wallet address
WALLET_ADDR=$(awp-wallet status --token "$TOKEN" | jq -r '.address')
[[ -z "$WALLET_ADDR" || "$WALLET_ADDR" == "null" ]] && { echo '{"error": "Invalid token"}' >&2; exit 1; }

# Fetch registry
REGISTRY=$(curl -s "$API_BASE/registry") || { echo '{"error": "Failed to fetch /registry"}' >&2; exit 1; }
echo "$REGISTRY" | jq -e '.awpToken' > /dev/null 2>&1 || { echo "$REGISTRY" >&2; exit 1; }
AWP_TOKEN=$(echo "$REGISTRY" | jq -r '.awpToken')
STAKE_NFT=$(echo "$REGISTRY" | jq -r '.stakeNFT')

# Pad tokenId to 32 bytes
TOKEN_ID_HEX=$(python3 -c "print(hex($POSITION)[2:].zfill(64))")

# Step 1: Check remainingTime(tokenId) — selector = keccak256("remainingTime(uint256)")[:4] = 0x0c64a7f2
REMAINING_HEX=$(eth_call "$STAKE_NFT" "0x0c64a7f2${TOKEN_ID_HEX}")
[[ -z "$REMAINING_HEX" || "$REMAINING_HEX" == "0x" || "$REMAINING_HEX" == "null" ]] && {
  echo '{"error": "remainingTime() call failed — position may not exist"}' >&2; exit 1
}
REMAINING=$(hex_to_dec "$REMAINING_HEX")
[[ "$REMAINING" -eq 0 ]] && {
  echo '{"error": "PositionExpired: position '"$POSITION"' lock has expired (remainingTime=0). Cannot add to an expired position."}' >&2; exit 1
}

# Step 2: Fetch current lockEndTime from positions(tokenId)
# positions(uint256) returns (uint128 amount, uint64 lockEndTime, uint64 createdAt)
# selector = keccak256("positions(uint256)")[:4] = 0x99fbab88
POSITIONS_HEX=$(eth_call "$STAKE_NFT" "0x99fbab88${TOKEN_ID_HEX}")
[[ -z "$POSITIONS_HEX" || "$POSITIONS_HEX" == "0x" || "$POSITIONS_HEX" == "null" ]] && {
  echo '{"error": "positions() call failed"}' >&2; exit 1
}
# Return is 3 words (96 bytes): amount(uint128 padded to 32), lockEndTime(uint64 padded to 32), createdAt(uint64 padded to 32)
CURRENT_LOCK_END=$(python3 -c "
data = '${POSITIONS_HEX#0x}'
# word 1 = lockEndTime (offset 64..128)
lock_end = int(data[64:128], 16)
print(lock_end)
")

# Step 3: Compute newLockEndTime
NOW=$(date +%s)
NEW_LOCK_END=$(python3 -c "
import math
extend_days = float('$EXTEND_DAYS')
current_lock_end = $CURRENT_LOCK_END
now = $NOW
if extend_days > 0:
    candidate = now + int(extend_days * 86400)
    new_lock_end = max(current_lock_end, candidate)
else:
    new_lock_end = current_lock_end
print(new_lock_end)
")

# Verify newLockEndTime >= currentLockEndTime (contract requirement)
python3 -c "
new = $NEW_LOCK_END
cur = $CURRENT_LOCK_END
if new < cur:
    import sys
    print('{\"error\": \"newLockEndTime (' + str(new) + ') < currentLockEndTime (' + str(cur) + '). Contract requires newLockEndTime >= currentLockEndTime.\"}', file=sys.stderr)
    sys.exit(1)
"

# Convert amount to wei
AMOUNT_WEI=$(python3 -c "print(int(float('$AMOUNT') * 10**18))")

# Step 4: Approve AWP to StakeNFT
echo '{"step": "approve", "spender": "'"$STAKE_NFT"'", "amount": "'"$AMOUNT"' AWP"}' >&2
awp-wallet approve --token "$TOKEN" --asset "$AWP_TOKEN" --spender "$STAKE_NFT" --amount "$AMOUNT" --chain base

# Step 5: Build calldata for addToPosition(uint256 tokenId, uint256 amount, uint64 newLockEndTime)
# selector = keccak256("addToPosition(uint256,uint256,uint64)")[:4] = 0xd2845e7d
ADD_DATA=$(python3 -c "
token_id = $POSITION
amount_wei = $AMOUNT_WEI
new_lock_end = $NEW_LOCK_END
selector = '0xd2845e7d'
calldata = selector + hex(token_id)[2:].zfill(64) + hex(amount_wei)[2:].zfill(64) + hex(new_lock_end)[2:].zfill(64)
print(calldata)
")

echo '{"step": "addToPosition", "tokenId": '"$POSITION"', "amount_wei": "'"$AMOUNT_WEI"'", "newLockEndTime": '"$NEW_LOCK_END"', "remainingTime": '"$REMAINING"'}' >&2
awp-wallet send --token "$TOKEN" --to "$STAKE_NFT" --data "$ADD_DATA" --chain base
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall