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/relay-start.py

View on GitHub
#!/usr/bin/env python3
"""AWP Gasless onboarding — 通过 relay 注册或绑定"""

from __future__ import annotations

import json
import time

from awp_lib import (
    API_BASE,
    api_get,
    api_post,
    base_parser,
    build_eip712,
    die,
    get_eip712_domain,
    get_registry,
    get_wallet_address,
    info,
    step,
    validate_address,
    wallet_sign_typed_data,
)


def parse_args() -> tuple[str, str, str]:
    """解析命令行参数,返回 (token, mode, target)"""
    parser = base_parser("AWP gasless onboarding — register or bind via relay")
    parser.add_argument(
        "--mode", required=True, choices=["principal", "agent"],
        help="principal(注册/设置收款人为自己)或 agent(绑定到目标地址)",
    )
    parser.add_argument("--target", default="", help="agent 模式下的目标地址")
    args = parser.parse_args()

    if args.mode == "agent" and not args.target:
        die("Agent mode requires --target <address>")
    if args.target:
        validate_address(args.target, "target")

    return args.token, args.mode, args.target


def main() -> None:
    """主流程"""
    token, mode, target = parse_args()

    # Step 1: 获取 registry 和 EIP-712 domain
    step("fetch_registry")
    registry = get_registry()
    domain = get_eip712_domain(registry)
    info(f"domain: {domain['name']} v{domain['version']} chain={domain['chainId']} contract={domain['verifyingContract']}")

    # Step 2: 获取钱包地址
    step("get_wallet_address")
    wallet_addr = get_wallet_address()

    # Step 3: 检查当前状态
    step("check_status")
    check = api_get(f"address/{wallet_addr}/check")
    if isinstance(check, dict):
        is_registered = check.get("isRegistered", check.get("isRegisteredUser", False))
        bound_to = check.get("boundTo", "")

        if mode == "principal" and str(is_registered).lower() == "true":
            print(json.dumps({"status": "already_registered", "address": wallet_addr}))
            return

        zero_addr = "0x0000000000000000000000000000000000000000"
        if mode == "agent" and bound_to and bound_to != "null" and bound_to != zero_addr:
            print(json.dumps({"status": "already_bound", "address": wallet_addr, "boundTo": bound_to}))
            return

    # Step 4: 获取 nonce
    step("get_nonce")
    nonce_resp = api_get(f"nonce/{wallet_addr}")
    if not isinstance(nonce_resp, dict) or "nonce" not in nonce_resp:
        die(f"Invalid nonce response: {nonce_resp}")
    nonce = nonce_resp["nonce"]

    # Step 5: 截止时间(1 小时后)
    deadline = int(time.time()) + 3600

    # Step 6: 构建 EIP-712 typed data
    if mode == "principal":
        # Principal 模式: setRecipient(self) via /relay/set-recipient
        eip712_data = build_eip712(
            domain,
            "SetRecipient",
            [
                {"name": "user", "type": "address"},
                {"name": "recipient", "type": "address"},
                {"name": "nonce", "type": "uint256"},
                {"name": "deadline", "type": "uint256"},
            ],
            {
                "user": wallet_addr,
                "recipient": wallet_addr,
                "nonce": nonce,
                "deadline": deadline,
            },
        )
        relay_endpoint = f"{API_BASE}/relay/set-recipient"
        relay_body: dict = {
            "user": wallet_addr,
            "recipient": wallet_addr,
            "deadline": deadline,
            "signature": None,
        }
    else:
        # Agent 模式: bind(target) via /relay/bind
        eip712_data = build_eip712(
            domain,
            "Bind",
            [
                {"name": "agent", "type": "address"},
                {"name": "target", "type": "address"},
                {"name": "nonce", "type": "uint256"},
                {"name": "deadline", "type": "uint256"},
            ],
            {
                "agent": wallet_addr,
                "target": target,
                "nonce": nonce,
                "deadline": deadline,
            },
        )
        relay_endpoint = f"{API_BASE}/relay/bind"
        relay_body = {
            "agent": wallet_addr,
            "target": target,
            "deadline": deadline,
            "signature": None,
        }

    # Step 7: 签名
    step("sign_eip712")
    signature = wallet_sign_typed_data(token, eip712_data)
    relay_body["signature"] = signature

    # Step 8: 提交到 relay
    step("submit_relay", endpoint=relay_endpoint)
    info(f"Submitting to {relay_endpoint}")
    http_code, body = api_post(relay_endpoint, relay_body)

    if 200 <= http_code < 300:
        print(json.dumps(body) if isinstance(body, dict) else body)
    else:
        die(f"Relay returned HTTP {http_code}: {body}")


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