ape-claw 0.1.0

package/skillcards/seed/apeclaw-nft-autobuy.v1.json

@@ -0,0 +1,60 @@
+{
+  "name": "ApeClaw NFT Autobuy",
+  "slug": "apeclaw-nft-autobuy",
+  "description": "Plan and (optionally) execute multi-collection NFT buys on ApeChain within strict policy gates. Designed for agents that collect NFTs while you sleep.",
+  "version": "1.0.0",
+  "inputs_schema": {
+    "type": "object",
+    "required": ["count", "minPrice", "maxPrice", "currency", "execute", "autonomous"],
+    "properties": {
+      "count": { "type": "integer", "minimum": 1, "maximum": 25 },
+      "scan": { "type": "integer", "minimum": 1, "maximum": 500 },
+      "minPrice": { "type": "number", "minimum": 0 },
+      "maxPrice": { "type": "number", "exclusiveMinimum": 0 },
+      "budget": { "type": ["number", "null"], "minimum": 0 },
+      "currency": { "type": "string", "enum": ["APE"] },
+      "execute": { "type": "boolean" },
+      "autonomous": { "type": "boolean" }
+    }
+  },
+  "outputs_schema": {
+    "type": "object",
+    "required": ["ok", "planned", "selectedCount"],
+    "properties": {
+      "ok": { "type": "boolean" },
+      "selectedCount": { "type": "integer" },
+      "planned": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "required": ["quoteId", "collection", "tokenId", "priceApe"],
+          "properties": {
+            "quoteId": { "type": "string" },
+            "collection": { "type": "string" },
+            "tokenId": { "type": "string" },
+            "priceApe": { "type": "number" }
+          }
+        }
+      }
+    }
+  },
+  "bindings": [
+    {
+      "type": "cli",
+      "command": "ape-claw nft autobuy --count <count> --minPrice <minPrice> --maxPrice <maxPrice> [--scan <scan>] [--budget <budget>] [--execute] [--autonomous] --json"
+    }
+  ],
+  "constraints": {
+    "notes": [
+      "ApeClaw enforces allowlists, currency allowlist, spend caps, confirm phrases, simulation requirements, and replay protection at the CLI layer."
+    ]
+  },
+  "required_permissions": ["onchain_execute", "market_data"],
+  "examples": [],
+  "eval_packs": [],
+  "provenance": {
+    "publisher": "apeclaw",
+    "signed": false
+  }
+}
+

package/skillcards/seed/apeclaw-receipt-recorder.v1.json

@@ -0,0 +1,64 @@
+{
+  "name": "ApeClaw Receipt Recorder",
+  "slug": "apeclaw-receipt-recorder",
+  "description": "Record an append-only onchain receipt (ReceiptRegistry) for an action traceId. Designed to anchor auditability onchain without trusting a backend.",
+  "version": "1.0.0",
+  "inputs_schema": {
+    "type": "object",
+    "required": ["rpc", "privateKey", "receipts", "traceId"],
+    "properties": {
+      "rpc": { "type": "string", "description": "RPC URL for the target chain (ApeChain or local dev)." },
+      "privateKey": { "type": "string", "description": "EVM private key used to sign the receipt transaction." },
+      "receipts": { "type": "string", "description": "ReceiptRegistry contract address." },
+      "traceId": { "type": "string", "description": "Unique traceId for this action (hashed onchain)." },
+      "subject": { "type": "string", "default": "agent:unknown", "description": "Subject identifier (hashed onchain), e.g. agentId or account." },
+      "payload": { "type": ["object", "null"], "default": {}, "description": "Receipt payload (content-addressed via stable JSON hash)." },
+      "uri": { "type": "string", "default": "", "description": "Optional offchain URI (IPFS/Arweave/http/file) for additional evidence." }
+    }
+  },
+  "outputs_schema": {
+    "type": "object",
+    "required": ["ok", "txHash", "traceIdHash", "contentHash", "subjectHash"],
+    "properties": {
+      "ok": { "type": "boolean" },
+      "txHash": { "type": "string" },
+      "traceIdHash": { "type": "string" },
+      "contentHash": { "type": "string" },
+      "subjectHash": { "type": "string" },
+      "uri": { "type": "string" }
+    }
+  },
+  "bindings": [
+    {
+      "type": "cli",
+      "command": "ape-claw v2 receipt record --rpc <rpc> --privateKey <privateKey> --receipts <receipts> --traceId <traceId> [--subject <subject>] [--payload '<payloadJson>'] [--uri <uri>] --json"
+    }
+  ],
+  "constraints": {
+    "riskTier": 2,
+    "notes": [
+      "This skill writes an immutable receipt onchain. It should be used for audit anchors, not for storing secrets.",
+      "Prefer putting large evidence blobs in offchain storage and referencing via --uri."
+    ]
+  },
+  "required_permissions": ["onchain_execute"],
+  "examples": [
+    {
+      "title": "Record a receipt (local dev)",
+      "value": {
+        "rpc": "http://127.0.0.1:8545",
+        "privateKey": "0x...",
+        "receipts": "0xReceiptRegistry...",
+        "traceId": "nft_buy_1700000000_abc123",
+        "subject": "agent:the-clawllector",
+        "payload": { "kind": "nft.buy.confirmed", "collection": "gs-on-ape", "priceApe": 75 }
+      }
+    }
+  ],
+  "eval_packs": [],
+  "provenance": {
+    "publisher": "apeclaw",
+    "signed": false
+  }
+}
+

package/skillcards/seed/humanizer.v1.json

@@ -0,0 +1,74 @@
+{
+  "name": "Humanizer — Remove AI Writing Patterns",
+  "slug": "humanizer",
+  "description": "Remove signs of AI-generated writing from text. Detects and fixes 24 patterns including inflated symbolism, promotional language, em dash overuse, AI vocabulary, rule of three, and sycophantic tone. Based on Wikipedia's AI writing guide.",
+  "version": "2.1.1",
+  "inputs_schema": {
+    "type": "object",
+    "properties": {
+      "text": { "type": "string", "description": "The text to humanize." },
+      "tone": {
+        "type": "string",
+        "enum": ["formal", "casual", "technical", "conversational"],
+        "description": "Target writing tone."
+      }
+    }
+  },
+  "outputs_schema": {
+    "type": "object",
+    "properties": {
+      "humanized_text": { "type": "string", "description": "The rewritten text with AI patterns removed." },
+      "patterns_found": { "type": "array", "description": "List of AI patterns detected and fixed." }
+    }
+  },
+  "bindings": [
+    {
+      "type": "external",
+      "url": "https://github.com/blader/humanizer"
+    },
+    {
+      "type": "external",
+      "url": "https://raw.githubusercontent.com/blader/humanizer/main/SKILL.md"
+    },
+    {
+      "type": "openclaw_skill_md",
+      "source": "github",
+      "path": "SKILL.md",
+      "repo": {
+        "owner": "blader",
+        "repo": "humanizer",
+        "ref": "main",
+        "path": "SKILL.md"
+      }
+    }
+  ],
+  "constraints": {
+    "riskTier": 1,
+    "safety": [
+      "Read-only analysis and rewriting — no side effects",
+      "Preserves meaning while removing AI patterns",
+      "Does not add opinions the author didn't intend"
+    ]
+  },
+  "required_permissions": ["file_read", "file_write"],
+  "examples": [
+    {
+      "title": "Humanize promotional text",
+      "input": { "text": "This groundbreaking initiative serves as a testament to our commitment to fostering innovation in the evolving landscape." },
+      "output": { "humanized_text": "We started this project because the old system wasn't working. Here's what we changed and why." }
+    },
+    {
+      "title": "Fix AI vocabulary",
+      "input": { "text": "Furthermore, this multifaceted approach leverages cutting-edge technology to deliver comprehensive solutions." },
+      "output": { "humanized_text": "The approach uses three specific techniques: [concrete details]." }
+    }
+  ],
+  "eval_packs": [],
+  "provenance": {
+    "publisher": "apeclaw",
+    "signed": false,
+    "source": "github",
+    "sourceUrl": "https://github.com/blader/humanizer",
+    "license": "MIT"
+  }
+}

package/skillcards/seed/otherside-navigator.v1.json

@@ -0,0 +1,116 @@
+{
+  "name": "Otherside Navigator (THE POD Loop)",
+  "slug": "otherside-navigator",
+  "description": "A strict opt-in autonomous loop for Clawbots to enter and navigate Otherside (otherside.xyz) using a rolling screenshot buffer + VLM vision (Claude CLI or stub), structured state parsing, action planning, and an execution layer. Includes both stub execution (default) and an optional macOS CGEvent executor for real movement when explicitly enabled.",
+  "version": "1.0.0",
+  "inputs_schema": {
+    "type": "object",
+    "required": ["enabled", "screenshotDir", "vlmBackend", "stuckSeconds", "maxRuntimeSeconds", "dryRun"],
+    "properties": {
+      "enabled": { "type": "boolean", "default": false, "description": "Must be true to run. Disabled by default for safety." },
+      "screenshotDir": { "type": "string", "default": "~/pod/screens", "description": "Rolling screenshot buffer directory (newest file = current frame)." },
+      "outDir": { "type": "string", "default": "~/pod", "description": "Output directory for state/journal/executions (persistent workspace)." },
+      "journalDir": { "type": "string", "default": "~/pod/journal", "description": "Default journal path (derived from outDir/journal in the runner)." },
+      "relationshipsPath": { "type": "string", "default": "~/pod/state/relationships.json", "description": "Planned: relationships/contacts state for social navigation." },
+      "browser": { "type": "string", "enum": ["chrome"], "default": "chrome", "description": "Planned: browser target for recovery automation." },
+      "stuckSeconds": { "type": "integer", "minimum": 10, "maximum": 600, "default": 60 },
+      "vlmBackend": { "type": "string", "enum": ["claude_cli", "stub"], "default": "stub" },
+      "claudeModel": { "type": "string", "default": "sonnet" },
+      "executor": { "type": "string", "enum": ["macos_stub", "macos_cgevent"], "default": "macos_stub", "description": "Execution backend. macos_cgevent sends real input events and requires explicit opt-in + macOS Accessibility permission." },
+      "allowSystemInput": { "type": "boolean", "default": false, "description": "Strict opt-in. Must be true for real input injection (macos_cgevent)." },
+      "focusApp": { "type": "string", "default": "Google Chrome", "description": "App to focus before sending input events (macos_cgevent)." },
+      "captureScreenshots": { "type": "boolean", "default": false, "description": "Optional: auto-capture screenshots using macOS screencapture into screenshotDir." },
+      "captureIntervalSeconds": { "type": "number", "default": 2.0, "description": "Screenshot capture interval (seconds) when captureScreenshots is enabled." },
+      "captureMaxFiles": { "type": "integer", "default": 120, "description": "Rolling buffer size when captureScreenshots is enabled." },
+      "execute": { "type": "boolean", "default": false, "description": "Strict opt-in. If true, allow the runner to execute planned actions (still requires allowSystemInput for macos_cgevent)." },
+      "fastPrompt": {
+        "type": "string",
+        "default": "What gets sent to Claude (the FAST_PROMPT):\n\nAnalyze this game screenshot briefly.\n\n1) PLAYERS: List any player names visible (floating text above characters)\n2) DIRECTION: which way is the waypoint/objective marker? (left/right/forward/none)\n3) STATE: gameplay / settings_menu / loading / launcher_window\n4) CHAT: Any new chat messages? (just quote who said what)\n\nKeep it SHORT. Only report what you actually see.\n\n(Plus the actual screenshot image attached.)"
+      },
+      "deepPrompt": {
+        "type": "string",
+        "default": "Or on a deeper analysis pass (DEEP_PROMPT), return raw text, not JSON, in this exact structure:\n\n1) ENVIRONMENT: ...\n2) HUD/UI: ...\n3) PLAYERS: ...\n4) CHAT LOG: ...\n5) GAME STATE: ...\n6) NOTABLE: ...\n7) NAVIGATION: ...\n8) SUGGESTED ACTIONS:\n- ...\n- ...\n- ...\n\nBe precise. Only claim what you can actually see."
+      },
+      "maxRuntimeSeconds": { "type": "integer", "minimum": 60, "maximum": 86400, "default": 3600 },
+      "telemetryEnabled": { "type": "boolean", "default": false, "description": "Strict opt-in remote telemetry emission." },
+      "telemetryUrl": { "type": "string", "default": "https://api.apeclaw.ai", "description": "Telemetry base URL (POST /api/events)." },
+      "telemetryAgentId": { "type": "string", "description": "Optional clawbot agentId for telemetry auth." },
+      "telemetryAgentToken": { "type": "string", "description": "Optional clawbot agentToken for telemetry auth." },
+      "telemetryIntervalSeconds": { "type": "integer", "minimum": 10, "maximum": 900, "default": 120 },
+      "stopFile": { "type": "string", "default": "~/pod/STOP", "description": "Kill switch file path. If present, loop exits immediately." },
+      "dryRun": { "type": "boolean", "default": true, "description": "Default safe posture. When true, executor logs intended actions; no system input injection occurs." }
+    }
+  },
+  "outputs_schema": {
+    "type": "object",
+    "required": ["ok", "status"],
+    "properties": {
+      "ok": { "type": "boolean" },
+      "status": { "type": "string", "enum": ["started", "stopped", "error"] },
+      "lastState": { "type": "object" },
+      "lastAction": { "type": "object" }
+    }
+  },
+  "bindings": [
+    {
+      "type": "local_runner",
+      "entry": "pod/run_agent.py",
+      "runner_contract": {
+        "entrypoint": "python3 pod/run_agent.py",
+        "notes": [
+          "Standard runner contract for THE POD: one process loops on a rolling screenshot buffer and writes state/journal/executions to outDir.",
+          "v2-alpha is safe-by-default. Real macOS CGEvent input injection is available as a strict opt-in executor (requires Accessibility permission)."
+        ],
+        "default_paths": {
+          "screenshot_buffer": "~/pod/screens",
+          "journal": "~/pod/journal",
+          "relationships_json": "~/pod/state/relationships.json"
+        },
+        "browser": "chrome"
+      },
+      "notes": [
+        "This skill is OS-bound. It reads screenshots from disk. Default execution is stub-only (logs to disk). Optional macOS input injection is available via CGEvent and must remain strict opt-in.",
+        "Vision backend 'claude_cli' shells out to: claude -p \"...\" --model sonnet --allowedTools Read",
+        "Users must be logged in locally (claude /login). No API keys should be stored in the workspace."
+      ]
+    }
+  ],
+  "constraints": {
+    "riskTier": 3,
+    "safety": [
+      "Strict opt-in: enabled=false by default",
+      "Hard stop file kill switch",
+      "Rate-limit vision calls and recovery attempts",
+      "Never upload screenshots to arbitrary endpoints; only the configured vision backend is allowed",
+      "Real input injection requires explicit opt-in flags and macOS Accessibility permission"
+    ]
+  },
+  "required_permissions": [
+    "file_read",
+    "process_spawn",
+    "system_input",
+    "browser_control",
+    "network_optional"
+  ],
+  "examples": [
+    {
+      "title": "FAST_PROMPT (exact structure from otherside-navigator-reference.jpg)",
+      "value": "What gets sent to Claude (the FAST_PROMPT):\n\nAnalyze this game screenshot briefly.\n\n1) PLAYERS: List any player names visible (floating text above characters)\n2) DIRECTION: which way is the waypoint/objective marker? (left/right/forward/none)\n3) STATE: gameplay / settings_menu / loading / launcher_window\n4) CHAT: Any new chat messages? (just quote who said what)\n\nKeep it SHORT. Only report what you actually see.\n\n(Plus the actual screenshot image attached.)"
+    },
+    {
+      "title": "DEEP_PROMPT (exact structure from otherside-navigator-reference.jpg)",
+      "value": "Or on a deeper analysis pass (DEEP_PROMPT), something like:\n\n1) ENVIRONMENT: Open grassy terrain, purple-tinted sky, distant crystalline structures, warm ambient lighting, atmospheric haze on horizon\n2) HUD/UI: Waypoint marker bottom-left \"247m\", compass visible top-center showing heading NNE, no health bar visible, minimap not present\n3) PLAYERS: JayVega (red avatar, close, ~10m), Aurelius_X(blue cape, mid-distance ~25m), moonwalker99 (far, ~40m)\n4) CHAT LOG: moonwalker99: \"anyone know where the portal is\"\n5) GAME STATE: gameplay\n6) NOTABLE: Unusual light flickering near the rock formation at center-right - possible rendering artifact\n7) NAVIGATION: Waypoint marker is to the left\n8) SUGGESTED ACTIONS:\n- Move toward waypoint (left)\n- Approach JayVega (nearest player)\n- Investigate flickering near rock formation"
+    },
+    {
+      "title": "Run (fully loaded; strict opt-in)",
+      "value": "macOS prereqs:\\n- python3 -m pip install --upgrade pyobjc-framework-Quartz\\n- grant Accessibility permissions to the terminal/Python process\\n- ensure Otherside is active in Chrome\\n\\nCommand:\\npython3 pod/run_agent.py \\\\\\n  --enabled \\\\\\n  --screenshot-dir \\\"$HOME/pod/screens\\\" \\\\\\n  --capture-screenshots \\\\\\n  --capture-interval-seconds 2 \\\\\\n  --capture-max-files 120 \\\\\\n  --backend claude_cli \\\\\\n  --claude-model sonnet \\\\\\n  --executor macos_cgevent \\\\\\n  --allow-system-input \\\\\\n  --focus-app \\\"Google Chrome\\\" \\\\\\n  --execute"
+    }
+  ],
+  "eval_packs": [],
+  "provenance": {
+    "publisher": "apeclaw",
+    "signed": false,
+    "source_note": "Derived from a production-proven screenshot->VLM->parser->planner->input loop design."
+  }
+}
+

package/skillcards/seed/stonkbrokers-launcher.v1.json

@@ -0,0 +1,280 @@
+{
+  "name": "StonkBrokers — Full DeFi Suite (Robinhood Chain)",
+  "slug": "stonkbrokers-launcher",
+  "description": "End-to-end onchain DeFi skill for Robinhood Chain testnet via the StonkBrokers protocol (Clutch Labs). Covers the complete lifecycle: claim testnet ETH from the faucet, launch new ERC-20 tokens via fixed-price sale, finalize launches into Uniswap v3 liquidity, swap tokens on the exchange, create pools and mint LP positions with native ETH, write and trade covered-call options, and interact with the NFT collection and marketplace. Designed so an agent can go from a fresh wallet to a fully launched token with trading and options activity in minutes.",
+  "version": "1.0.0",
+  "documentation_md": "# StonkBrokers — Full DeFi Suite\n\n> **Source**: [Clutch-L4bs/stonkbrokers](https://github.com/Clutch-L4bs/stonkbrokers)  \n> **Live App**: [stonkbrokers.vercel.app](https://stonkbrokers.vercel.app)  \n> **Network**: Robinhood Chain Testnet (Chain ID `46630`)\n\n## Network Details\n\n| Field | Value |\n|---|---|\n| Chain ID | `46630` |\n| RPC | `https://rpc.testnet.chain.robinhood.com` |\n| Explorer | `https://explorer.testnet.chain.robinhood.com` |\n| Currency | ETH |\n| Faucet | `https://faucet.testnet.chain.robinhood.com/` |\n\n## Deployed Contract Addresses\n\n### Core Infrastructure\n| Contract | Address |\n|---|---|\n| WETH9 | `0x37E402B8081eFcE1D82A09a066512278006e4691` |\n| Uniswap v3 Factory | `0xFECCB63CD759d768538458Ea56F47eA8004323c1` |\n| SwapRouter | `0x1b32F47434a7EF83E97d0675C823E547F9266725` |\n| QuoterV2 | `0x126f1c1F29A0f49c5D33e0139a5Da1FE25590dB1` |\n| PositionManager | `0xBc82a9aA33ff24FCd56D36a0fB0a2105B193A327` |\n\n### Stonk Contracts\n| Contract | Address |\n|---|---|\n| Token Registry | `0xA4954EF8A679B13b1875Bb508E84F563c27A9D5b` |\n| Launcher Factory | `0x631f9371Fd6B2C85F8f61d19A90547eE67Fa61A2` |\n| Covered Call Vault | `0x055d84908672b9be53275963862614aEA9CDB98B` |\n\n### NFT + Marketplace\n| Contract | Address |\n|---|---|\n| Original NFT | `0x2Bb22c9E3394272351FEffEDbEa079Be4FB10a8d` |\n| Expanded NFT | `0x5fDAeBE166490c69B4C34F99E049b4e16c9EF80a` |\n| Marketplace | `0x5a091dB1c58686f4625c14eD204BE85d83BD4aA6` |\n\n---\n\n## Module 1: Faucet — Claim Testnet ETH\n\nThe `StonkEthFaucet` contract dispenses testnet ETH with a 24-hour cooldown per address.\n\n### Steps\n1. Check eligibility: call `canClaim(address)` — returns `true` if cooldown has elapsed.\n2. Claim: call `claim()` — sends `claimAmountWei` ETH to `msg.sender`.\n3. Check next eligible time: `nextClaimTime(address)` returns the UNIX timestamp.\n\n### ABI (key functions)\n```solidity\nfunction canClaim(address user) external view returns (bool);\nfunction nextClaimTime(address user) external view returns (uint256);\nfunction claim() external; // cooldown-gated, sends claimAmountWei to caller\n```\n\n### Alternative: Robinhood Official Faucet\nVisit `https://faucet.testnet.chain.robinhood.com/` — 0.05 ETH per request (requires 0.005 mainnet ETH), or 0.025 ETH otherwise. Once per 24 hours. You can also bridge Sepolia ETH.\n\n---\n\n## Module 2: Token Launcher — Create & Launch Tokens\n\nThe launcher lifecycle:\n1. **Create** a launch via `StonkLauncherFactory.createLaunch()` — deploys a new ERC-20 token + `StonkLaunch` sale contract.\n2. **Buy** tokens during the sale by sending ETH to `StonkLaunch.buy()` — fixed price, first-come-first-served.\n3. **Finalize** the launch via `StonkLauncherFactory.finalizeLaunch()` — wraps raised ETH into WETH, creates a Uniswap v3 pool, and mints a full-range LP position.\n\n### Create a Launch\n```solidity\nstruct CreateLaunchParams {\n    string name;              // Token name (e.g. \"My Token\")\n    string symbol;            // Token symbol (e.g. \"MTKN\")\n    string metadataURI;       // JSON metadata URI\n    string imageURI;          // Token icon URI\n    uint256 totalSupplyWei;   // Total supply in wei (e.g. 1_000_000e18)\n    uint256 creatorAllocationBps; // Creator's share in basis points (e.g. 1000 = 10%)\n    uint256 saleBpsOfRemaining;   // Portion of remaining for sale (e.g. 5000 = 50%)\n    uint256 priceWeiPerToken;     // Fixed ETH price per whole token in wei\n}\n\nfunction createLaunch(CreateLaunchParams calldata p)\n    external returns (address token, address launch);\n```\n\nEmits `LaunchCreated(creator, token, launch, name, symbol, metadataURI, imageURI)`.\n\n### Buy from the Sale\n```solidity\n// On the StonkLaunch contract (the `launch` address returned above)\nfunction buy() external payable; // send ETH, receive tokens at priceWeiPerToken\nfunction remainingForSale() external view returns (uint256);\n```\n\nEmits `Bought(buyer, ethIn, tokensOut)`. Also supports `receive()` (just send ETH).\n\n### Finalize the Launch\n```solidity\n// Back on the factory\nfunction finalizeLaunch(address launch, uint160 sqrtPriceX96, uint24 fee) external payable;\n```\n\n`sqrtPriceX96` sets the initial pool price. `fee` is the Uniswap v3 fee tier (e.g. `3000` for 0.3%, `10000` for 1%). Emits `LaunchFinalized(creator, launch, pool, lpTokenId)`. This also wires up a fee splitter and staking vault.\n\n---\n\n## Module 3: Exchange — Swap Tokens\n\nSwap any pair through Uniswap v3 SwapRouter. The UI also supports direct ETH ↔ WETH wrapping.\n\n### Quote a Swap\n```solidity\n// QuoterV2 at 0x126f1c1F29A0f49c5D33e0139a5Da1FE25590dB1\nfunction quoteExactInputSingle(\n    address tokenIn,\n    address tokenOut,\n    uint24 fee,\n    uint256 amountIn,\n    uint160 sqrtPriceLimitX96\n) external returns (uint256 amountOut, ...);\n```\n\n### Execute a Swap\n```solidity\n// SwapRouter at 0x1b32F47434a7EF83E97d0675C823E547F9266725\nstruct ExactInputSingleParams {\n    address tokenIn;\n    address tokenOut;\n    uint24 fee;\n    address recipient;\n    uint256 deadline;\n    uint256 amountIn;\n    uint256 amountOutMinimum;\n    uint160 sqrtPriceLimitX96;\n}\nfunction exactInputSingle(ExactInputSingleParams calldata params)\n    external payable returns (uint256 amountOut);\n```\n\nFor native ETH swaps, send `msg.value` and set `tokenIn = WETH9`.\n\n### ETH ↔ WETH Wrap/Unwrap\n```solidity\n// WETH9 at 0x37E402B8081eFcE1D82A09a066512278006e4691\nfunction deposit() external payable;  // ETH → WETH\nfunction withdraw(uint256 wad) external; // WETH → ETH\n```\n\n---\n\n## Module 4: Pools — Create Pools & Mint LP Positions\n\n### Create and Initialize a Pool\n```solidity\n// PositionManager at 0xBc82a9aA33ff24FCd56D36a0fB0a2105B193A327\nfunction createAndInitializePoolIfNecessary(\n    address token0,\n    address token1,\n    uint24 fee,\n    uint160 sqrtPriceX96\n) external payable returns (address pool);\n```\n\n`token0` must be < `token1` (sorted by address). Use `fee` tiers: `500` (0.05%), `3000` (0.3%), `10000` (1%).\n\n### Mint an LP Position\n```solidity\nstruct MintParams {\n    address token0;\n    address token1;\n    uint24 fee;\n    int24 tickLower;\n    int24 tickUpper;\n    uint256 amount0Desired;\n    uint256 amount1Desired;\n    uint256 amount0Min;\n    uint256 amount1Min;\n    address recipient;\n    uint256 deadline;\n}\nfunction mint(MintParams calldata params)\n    external payable returns (uint256 tokenId, uint128 liquidity, uint256 amount0, uint256 amount1);\n```\n\nFor full-range: `tickLower = -887272`, `tickUpper = 887272`.\nFor native ETH on one side: send `msg.value` and use WETH9 as the token. The PositionManager wraps it.\n\n---\n\n## Module 5: Options — Covered Calls\n\n### Write a Covered Call\n```solidity\n// CoveredCallVault at 0x055d84908672b9be53275963862614aEA9CDB98B\nfunction createOffer(\n    address underlying,       // token to escrow\n    address quote,            // settlement token (usually WETH)\n    address pool,             // Uniswap v3 pool for TWAP\n    uint32 twapSeconds,       // TWAP window (min 15 minutes)\n    int24 strikeTick,         // strike price as a Uni v3 tick\n    uint256 underlyingAmount, // how many underlying tokens to escrow\n    uint256 strikeQuoteAmount,// quote tokens received if exercised\n    uint256 premiumQuoteAmount,// premium the buyer pays upfront\n    uint256 expiry            // UNIX timestamp for expiration\n) external returns (uint256 offerId);\n```\n\nThe writer must `approve(vault, underlyingAmount)` first.\n\n### Buy an Option\n```solidity\nfunction buyOption(uint256 offerId) external returns (uint256 optionTokenId);\n```\n\nBuyer must `approve(vault, premiumQuoteAmount)` of the quote token. Receives an ERC-721 option NFT.\n\n### Exercise an Option\n```solidity\nfunction exercise(uint256 optionTokenId) external;\n```\n\nOnly works if in-the-money per TWAP oracle and before expiry. Buyer sends `strikeQuoteAmount` and receives the escrowed underlying.\n\n### Reclaim Expired\n```solidity\nfunction reclaimExpired(uint256 optionTokenId) external;\n```\n\nWriter can reclaim escrowed collateral after expiry if unexercised.\n\n---\n\n## Suggested Agent Flow (End-to-End)\n\n1. **Claim gas**: Call faucet `claim()` or use the official Robinhood faucet.\n2. **Create token**: Call `createLaunch({name, symbol, ..., totalSupplyWei, priceWeiPerToken})`.\n3. **Buy from sale**: Send ETH to `launch.buy()` to acquire tokens.\n4. **Finalize**: Call `finalizeLaunch(launch, sqrtPriceX96, fee)` to seed Uniswap v3 pool.\n5. **Swap**: Use `SwapRouter.exactInputSingle()` to trade the new token.\n6. **Add LP**: Call `PositionManager.mint()` to provide liquidity.\n7. **Write option**: Approve + call `createOffer()` to write a covered call.\n8. **Buy option**: Another agent/user calls `buyOption()` and gets an option NFT.\n9. **Exercise or reclaim**: `exercise()` if ITM, or `reclaimExpired()` after expiry.\n",
+  "inputs_schema": {
+    "type": "object",
+    "required": ["action"],
+    "properties": {
+      "action": {
+        "type": "string",
+        "enum": [
+          "faucet_claim",
+          "launch_create",
+          "launch_buy",
+          "launch_finalize",
+          "swap",
+          "wrap_eth",
+          "unwrap_weth",
+          "pool_create",
+          "pool_mint_lp",
+          "option_write",
+          "option_buy",
+          "option_exercise",
+          "option_reclaim"
+        ],
+        "description": "Which StonkBrokers module action to perform"
+      },
+      "rpcUrl": {
+        "type": "string",
+        "default": "https://rpc.testnet.chain.robinhood.com",
+        "description": "Robinhood Chain testnet RPC endpoint"
+      },
+      "privateKey": {
+        "type": "string",
+        "description": "Wallet private key (hex, 0x-prefixed). Never log or persist this."
+      },
+      "faucet": {
+        "type": "object",
+        "description": "Parameters for faucet_claim action",
+        "properties": {
+          "contractAddress": { "type": "string", "description": "StonkEthFaucet contract address" }
+        }
+      },
+      "launch": {
+        "type": "object",
+        "description": "Parameters for launch_create / launch_buy / launch_finalize",
+        "properties": {
+          "factoryAddress": { "type": "string", "default": "0x631f9371Fd6B2C85F8f61d19A90547eE67Fa61A2" },
+          "name": { "type": "string", "description": "Token name (for create)" },
+          "symbol": { "type": "string", "description": "Token symbol (for create)" },
+          "totalSupplyWei": { "type": "string", "description": "Total supply in wei, e.g. '1000000000000000000000000' for 1M tokens with 18 decimals" },
+          "creatorAllocationBps": { "type": "integer", "default": 1000, "description": "Creator allocation in basis points (1000 = 10%)" },
+          "saleBpsOfRemaining": { "type": "integer", "default": 5000, "description": "Sale portion of remaining in basis points (5000 = 50%)" },
+          "priceWeiPerToken": { "type": "string", "description": "ETH price per whole token in wei" },
+          "launchAddress": { "type": "string", "description": "StonkLaunch contract address (for buy/finalize)" },
+          "buyAmountEth": { "type": "string", "description": "ETH to spend buying tokens (for buy)" },
+          "sqrtPriceX96": { "type": "string", "description": "Initial pool price as sqrtPriceX96 (for finalize)" },
+          "feeTier": { "type": "integer", "enum": [500, 3000, 10000], "default": 3000, "description": "Uniswap v3 fee tier" }
+        }
+      },
+      "swap": {
+        "type": "object",
+        "description": "Parameters for swap action",
+        "properties": {
+          "tokenIn": { "type": "string", "description": "Input token address (use WETH9 for native ETH)" },
+          "tokenOut": { "type": "string", "description": "Output token address" },
+          "amountIn": { "type": "string", "description": "Amount in wei" },
+          "fee": { "type": "integer", "enum": [500, 3000, 10000], "default": 3000 },
+          "slippageBps": { "type": "integer", "default": 100, "description": "Max slippage in basis points" }
+        }
+      },
+      "pool": {
+        "type": "object",
+        "description": "Parameters for pool_create / pool_mint_lp",
+        "properties": {
+          "token0": { "type": "string", "description": "First token address (must be < token1 by address)" },
+          "token1": { "type": "string", "description": "Second token address" },
+          "fee": { "type": "integer", "enum": [500, 3000, 10000], "default": 3000 },
+          "sqrtPriceX96": { "type": "string", "description": "Initial sqrt price (for pool_create)" },
+          "amount0Desired": { "type": "string", "description": "Amount of token0 in wei (for mint_lp)" },
+          "amount1Desired": { "type": "string", "description": "Amount of token1 in wei (for mint_lp)" },
+          "tickLower": { "type": "integer", "default": -887272, "description": "Lower tick bound (-887272 for full range)" },
+          "tickUpper": { "type": "integer", "default": 887272, "description": "Upper tick bound (887272 for full range)" },
+          "useNativeEth": { "type": "boolean", "default": false, "description": "Send native ETH as msg.value for one side" }
+        }
+      },
+      "option": {
+        "type": "object",
+        "description": "Parameters for option_write / option_buy / option_exercise / option_reclaim",
+        "properties": {
+          "vaultAddress": { "type": "string", "default": "0x055d84908672b9be53275963862614aEA9CDB98B" },
+          "underlying": { "type": "string" },
+          "quote": { "type": "string", "description": "Quote token (usually WETH)" },
+          "pool": { "type": "string", "description": "Uniswap v3 pool address for TWAP" },
+          "twapSeconds": { "type": "integer", "default": 900, "description": "TWAP window in seconds (min 900)" },
+          "strikeTick": { "type": "integer", "description": "Strike price as Uniswap v3 tick" },
+          "underlyingAmount": { "type": "string", "description": "Underlying tokens to escrow (wei)" },
+          "strikeQuoteAmount": { "type": "string", "description": "Quote amount at strike (wei)" },
+          "premiumQuoteAmount": { "type": "string", "description": "Premium cost (wei)" },
+          "expiry": { "type": "integer", "description": "UNIX timestamp for option expiry" },
+          "offerId": { "type": "integer", "description": "Offer ID (for buy)" },
+          "optionTokenId": { "type": "integer", "description": "Option NFT token ID (for exercise/reclaim)" }
+        }
+      }
+    }
+  },
+  "outputs_schema": {
+    "type": "object",
+    "required": ["ok", "action"],
+    "properties": {
+      "ok": { "type": "boolean" },
+      "action": { "type": "string" },
+      "txHash": { "type": "string", "description": "Transaction hash on Robinhood Chain testnet" },
+      "explorerUrl": { "type": "string", "description": "Link to the transaction on the block explorer" },
+      "tokenAddress": { "type": "string", "description": "Deployed token address (from launch_create)" },
+      "launchAddress": { "type": "string", "description": "StonkLaunch sale contract (from launch_create)" },
+      "poolAddress": { "type": "string", "description": "Uniswap v3 pool address (from finalize or pool_create)" },
+      "lpTokenId": { "type": "string", "description": "LP NFT token ID (from finalize or pool_mint_lp)" },
+      "tokensReceived": { "type": "string", "description": "Tokens received from a buy or swap" },
+      "ethClaimed": { "type": "string", "description": "ETH received from faucet" },
+      "offerId": { "type": "integer", "description": "Offer ID from option_write" },
+      "optionTokenId": { "type": "integer", "description": "Option NFT ID from option_buy" },
+      "error": { "type": "string", "description": "Error message if ok=false" }
+    }
+  },
+  "bindings": [
+    {
+      "type": "onchain",
+      "chain": "robinhood-testnet",
+      "chainId": 46630,
+      "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+      "explorer": "https://explorer.testnet.chain.robinhood.com",
+      "contracts": {
+        "weth9": "0x37E402B8081eFcE1D82A09a066512278006e4691",
+        "uniswapV3Factory": "0xFECCB63CD759d768538458Ea56F47eA8004323c1",
+        "swapRouter": "0x1b32F47434a7EF83E97d0675C823E547F9266725",
+        "quoterV2": "0x126f1c1F29A0f49c5D33e0139a5Da1FE25590dB1",
+        "positionManager": "0xBc82a9aA33ff24FCd56D36a0fB0a2105B193A327",
+        "tokenRegistry": "0xA4954EF8A679B13b1875Bb508E84F563c27A9D5b",
+        "launcherFactory": "0x631f9371Fd6B2C85F8f61d19A90547eE67Fa61A2",
+        "coveredCallVault": "0x055d84908672b9be53275963862614aEA9CDB98B",
+        "originalNft": "0x2Bb22c9E3394272351FEffEDbEa079Be4FB10a8d",
+        "expandedNft": "0x5fDAeBE166490c69B4C34F99E049b4e16c9EF80a",
+        "marketplace": "0x5a091dB1c58686f4625c14eD204BE85d83BD4aA6"
+      },
+      "source": "https://github.com/Clutch-L4bs/stonkbrokers"
+    }
+  ],
+  "constraints": {
+    "riskTier": 2,
+    "safety": [
+      "Never log or persist private keys",
+      "All transactions are on Robinhood Chain TESTNET only — tokens have no real value",
+      "Verify contract addresses before sending transactions",
+      "Use slippage protection on all swaps",
+      "Check faucet cooldown before calling claim()",
+      "Ensure token approvals before interacting with vault or position manager"
+    ],
+    "notes": [
+      "This is a testnet-only skill — Robinhood Chain mainnet is not yet live",
+      "The StonkBrokers contracts are a hackathon MVP; treat as experimental",
+      "Fee tier mismatches are the #1 cause of 'No liquidity' errors on swaps",
+      "LP positions use WETH — selecting ETH wraps automatically via the PositionManager",
+      "Options exercise requires TWAP to show the option is in-the-money"
+    ]
+  },
+  "required_permissions": [
+    "onchain_execute",
+    "onchain_read",
+    "market_data"
+  ],
+  "examples": [
+    {
+      "title": "Claim testnet ETH from faucet",
+      "input": {
+        "action": "faucet_claim",
+        "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+        "privateKey": "0x..."
+      },
+      "expected_output": {
+        "ok": true,
+        "action": "faucet_claim",
+        "ethClaimed": "10000000000000000",
+        "txHash": "0x..."
+      }
+    },
+    {
+      "title": "Launch a new meme token",
+      "input": {
+        "action": "launch_create",
+        "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+        "privateKey": "0x...",
+        "launch": {
+          "name": "Test Stonk Token",
+          "symbol": "TSTONK",
+          "totalSupplyWei": "1000000000000000000000000",
+          "creatorAllocationBps": 1000,
+          "saleBpsOfRemaining": 5000,
+          "priceWeiPerToken": "10000000000000"
+        }
+      },
+      "expected_output": {
+        "ok": true,
+        "action": "launch_create",
+        "tokenAddress": "0x...",
+        "launchAddress": "0x...",
+        "txHash": "0x..."
+      }
+    },
+    {
+      "title": "Buy tokens from an active sale",
+      "input": {
+        "action": "launch_buy",
+        "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+        "privateKey": "0x...",
+        "launch": {
+          "launchAddress": "0x...",
+          "buyAmountEth": "0.01"
+        }
+      },
+      "expected_output": {
+        "ok": true,
+        "action": "launch_buy",
+        "tokensReceived": "1000000000000000000000",
+        "txHash": "0x..."
+      }
+    },
+    {
+      "title": "Finalize launch → create Uniswap v3 pool with LP",
+      "input": {
+        "action": "launch_finalize",
+        "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+        "privateKey": "0x...",
+        "launch": {
+          "launchAddress": "0x...",
+          "sqrtPriceX96": "79228162514264337593543950336",
+          "feeTier": 3000
+        }
+      },
+      "expected_output": {
+        "ok": true,
+        "action": "launch_finalize",
+        "poolAddress": "0x...",
+        "lpTokenId": "1",
+        "txHash": "0x..."
+      }
+    },
+    {
+      "title": "Swap ETH for a launched token",
+      "input": {
+        "action": "swap",
+        "rpcUrl": "https://rpc.testnet.chain.robinhood.com",
+        "privateKey": "0x...",
+        "swap": {
+          "tokenIn": "0x37E402B8081eFcE1D82A09a066512278006e4691",
+          "tokenOut": "0x...",
+          "amountIn": "10000000000000000",
+          "fee": 3000,
+          "slippageBps": 100
+        }
+      },
+      "expected_output": {
+        "ok": true,
+        "action": "swap",
+        "tokensReceived": "999000000000000000000",
+        "txHash": "0x..."
+      }
+    }
+  ],
+  "eval_packs": [],
+  "provenance": {
+    "publisher": "apeclaw",
+    "signed": false,
+    "source": "github",
+    "sourceUrl": "https://github.com/Clutch-L4bs/stonkbrokers",
+    "sourceNote": "Built from Clutch Labs' StonkBrokers repo — an end-to-end onchain DeFi product suite for Robinhood Chain testnet including token launcher, exchange, pools, options, NFTs, and marketplace."
+  }
+}