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.py

View on GitHub
#!/usr/bin/env python3
"""链上追加质押 — 向已有 StakeNFT 仓位追加 AWP
addToPosition(uint256 tokenId, uint256 amount, uint64 newLockEndTime)
检查 remainingTime、获取当前 lockEndTime、approve + addToPosition。需要 ETH 作为 gas。
"""
import re
import time as _time

from awp_lib import *


def main() -> None:
    # ── 参数解析 ──
    parser = base_parser("Add AWP to existing StakeNFT position")
    parser.add_argument("--position", required=True, help="StakeNFT token ID")
    parser.add_argument("--amount", required=True, help="AWP amount (human readable)")
    parser.add_argument("--extend-days", default="0", help="额外延长锁定天数(默认 0)")
    args = parser.parse_args()

    position = validate_positive_int(args.position, "position")
    amount = validate_positive_number(args.amount, "amount")

    # 验证 extend-days 非负数
    extend_days_str: str = args.extend_days
    if not re.match(r"^[0-9]+\.?[0-9]*$", extend_days_str):
        die("Invalid --extend-days: must be a non-negative number")
    extend_days = float(extend_days_str)

    # ── 预检查 ──
    wallet_addr = get_wallet_address()
    registry = get_registry()
    awp_token = require_contract(registry, "awpToken")
    stake_nft = require_contract(registry, "stakeNFT")

    token_id_hex = pad_uint256(position)

    # ── Step 1: 检查 remainingTime(tokenId) — selector = 0x0c64a7f2 ──
    remaining_hex = rpc_call(stake_nft, encode_calldata("0x0c64a7f2", token_id_hex))
    if not remaining_hex or remaining_hex in ("0x", "null"):
        die("remainingTime() call failed — position may not exist")

    remaining = hex_to_int(remaining_hex)
    if remaining == 0:
        die(f"PositionExpired: position {position} lock has expired (remainingTime=0). Cannot add to an expired position.")

    # ── Step 2: 获取当前 lockEndTime — positions(uint256) selector = 0x99fbab88 ──
    # 返回 (uint128 amount, uint64 lockEndTime, uint64 createdAt),各占 32 字节
    positions_hex = rpc_call(stake_nft, encode_calldata("0x99fbab88", token_id_hex))
    if not positions_hex or positions_hex in ("0x", "null"):
        die("positions() call failed")

    # word 1 (offset 64..128) = lockEndTime
    data = positions_hex.replace("0x", "")
    current_lock_end = int(data[64:128], 16)

    # ── Step 3: 计算 newLockEndTime ──
    now = int(_time.time())
    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

    # uint64 溢出保护(newLockEndTime 参数类型为 uint64)
    if new_lock_end > 2**64 - 1:
        die(f"new_lock_end too large: {new_lock_end} exceeds uint64 max")

    # ── Step 4: Approve AWP to StakeNFT ──
    amount_wei = to_wei(amount)
    step("approve", spender=stake_nft, amount=f"{amount} AWP")
    wallet_approve(args.token, awp_token, stake_nft, amount)

    # ── Step 5: addToPosition(uint256,uint256,uint64) — selector = 0xd2845e7d ──
    calldata = encode_calldata(
        "0xd2845e7d",
        pad_uint256(position),
        pad_uint256(amount_wei),
        pad_uint256(new_lock_end),
    )

    step("addToPosition", tokenId=position, amount_wei=str(amount_wei),
         newLockEndTime=new_lock_end, remainingTime=remaining)
    result = wallet_send(args.token, stake_nft, calldata)
    print(result)


if __name__ == "__main__":
    main()
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