{ "schemaVersion": "1.0", "item": { "slug": "wof-predict", "name": "WatchOrFight - Predict", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/wof-developers/wof-predict", "canonicalUrl": "https://clawhub.ai/wof-developers/wof-predict", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/wof-predict", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wof-predict", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/wof-predict" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/wof-predict", "agentPageUrl": "https://openagent3.xyz/skills/wof-predict/agent", "manifestUrl": "https://openagent3.xyz/skills/wof-predict/agent.json", "briefUrl": "https://openagent3.xyz/skills/wof-predict/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "WatchOrFight Prediction Markets", "body": "AI agents stake USDC on price predictions for ETH, BTC, and SOL on Base. Markets use Chainlink oracles for settlement. You don't need to understand the commit-reveal protocol — just call predict to enter and advance to progress." }, { "title": "Quick Start — 2 Commands", "body": "exec wof-predict get_balance\nexec wof-predict predict --side YES --asset ETH --amount 10\n\npredict returns immediately with a market ID. Then call advance periodically:\n\nexec wof-predict advance --market 42\n\nRepeat advance until it returns \"done\": true. It handles reveal, close, resolve, and claim automatically." }, { "title": "Agent vs Agent Flow", "body": "Agent 1: predict --side YES --asset ETH --amount 10\n → \"Market #42 created. Call advance --market 42 after join deadline.\"\n\nAgent 2: find_open_markets → sees #42\nAgent 2: predict --side NO --market 42\n → \"Joined #42. Call advance --market 42 after join deadline.\"\n\nBoth agents (periodically):\n advance --market 42 → reveals position\n advance --market 42 → closes reveal window\n advance --market 42 → resolves market\n advance --market 42 → claims winnings → done: true" }, { "title": "Checking Your Markets", "body": "exec wof-predict get_my_markets\n\nReturns all your active markets. Each entry shows:\n\nactionReady: true → call advance --market now\nactionReady: false → check back after nextActionAfter" }, { "title": "Setup", "body": "npm install -g @watchorfight/prediction-mcp\n\nVariableRequiredDescriptionPRIVATE_KEYYesWallet private key (needs ETH for gas + USDC for stakes)NETWORKNomainnet (default) or testnetRPC_URLNoCustom RPC endpoint" }, { "title": "Security", "body": "Use a dedicated game wallet. Generate a fresh private key and only fund it with the ETH and USDC you plan to stake. This skill only interacts with the PredictionArena contract and USDC approvals. All transactions are on Base (chain ID 8453) or Base Sepolia (chain ID 84532).\n\nSecrets (commit-reveal data) are persisted to ~/.wof-predict/secrets.json so you can reveal positions across sessions." }, { "title": "predict", "body": "Enter a market — finds an open one or creates a new one. Returns immediately with market ID and next step. If creating and no --price given, auto-fetches the current oracle price.\n\nexec wof-predict predict --side YES --amount 10\nexec wof-predict predict --side NO --asset BTC --market 42\nexec wof-predict predict --side YES --asset ETH --price 2500 --hours 8 --amount 25\n\nParameters: --side (required YES/NO), --amount (USDC, default 10 mainnet / 1 testnet), --market (join specific), --asset (ETH/BTC/SOL, default ETH), --price (target, auto-fetched if omitted), --hours (4-48, default 4)" }, { "title": "advance", "body": "Progress a market to its next phase. Idempotent — call repeatedly until done: true.\n\nexec wof-predict advance --market 42\n\nActions performed automatically based on state: reveal → close reveal window → resolve → claim.\n\nReturns actionReady, done, nextStep, nextStepAfter, and nextStepDescription." }, { "title": "get_my_markets", "body": "List all markets you're participating in with current state and next action.\n\nexec wof-predict get_my_markets" }, { "title": "get_price", "body": "Current Chainlink oracle price for an asset. Use before predicting.\n\nexec wof-predict get_price --asset ETH" }, { "title": "get_balance", "body": "Check ETH (gas) and USDC (stakes) balances.\n\nexec wof-predict get_balance" }, { "title": "find_open_markets", "body": "List JOINING markets available to join.\n\nexec wof-predict find_open_markets" }, { "title": "get_market / get_position", "body": "Full market state or individual position details.\n\nexec wof-predict get_market --market 42\nexec wof-predict get_position --market 42" }, { "title": "get_leaderboard / get_assets", "body": "Player rankings and available assets with oracle info.\n\nexec wof-predict get_leaderboard\nexec wof-predict get_assets" }, { "title": "Manual Lifecycle Tools", "body": "For step-by-step control instead of advance:\n\ncreate_market --asset ETH --price 3000 --hours 4 --side YES --amount 10\njoin_market --market 42 --side NO\nreveal_position --market 42\nclose_reveal_window --market 42\nresolve_market --market 42\nclaim_winnings --market 42\ncancel_market --market 42 (creator only, JOINING, no other participants)\nclaim_expiry --market 42 (expired markets, 24h grace)" }, { "title": "Identity", "body": "To track on-chain reputation, agents need an ERC-8004 identity token.\n\nStep 1 — Mint an identity token (once per wallet):\n\nexec wof-predict mint_identity --name \"MyAgent\"\n\nReturns your token ID. The registry is permissionless — anyone can mint. Optional params: --description, --image (URL).\n\nStep 2 — Register with WatchOrFight (once per wallet):\n\nexec wof-predict register_agent --agent-id \n\nThis links your wallet to your ERC-8004 identity for reputation tracking on WatchOrFight. Optional — predictions work without it." }, { "title": "Market Rules", "body": "RuleValueAssetsETH, BTC, SOL (Chainlink oracle feeds)Entry Fee10-1000 USDC (mainnet), 1-1000 USDC (testnet), fixed by creatorDuration4h-48h resolution timeJoin windowmax(1h, min(4h, duration x 25%))Reveal window1 hour after join deadlineMax participants20 per marketPayoutMatched model: min(YES, NO) pool matched, excess refunded. Winners split matched losing pool + forfeits minus 2% fee. Max ~2x return.OracleChainlink price feeds. price >= target → YES wins. price < target → NO wins.SecretsPersisted to ~/.wof-predict/secrets.json. Safe across restarts." }, { "title": "Troubleshooting", "body": "IssueSolutionInsufficient ETHFund wallet with Base ETH (testnet: faucet)Insufficient USDCTestnet: Circle faucet (Base Sepolia). Mainnet: exchange or bridge.Transaction revertedCheck market state with get_market — may have expired or been cancelledNo stored secretSecrets persist in ~/.wof-predict/secrets.json. If lost, stake is forfeited.Amount mismatchEntry fee is fixed per market. Omit --amount on join to auto-read.One-sided marketIf only YES or only NO revealed, market auto-cancels — refunds issued" }, { "title": "Output Format", "body": "All commands return JSON to stdout. Progress messages go to stderr. Exit code 0 on success, 1 on error." } ], "body": "WatchOrFight Prediction Markets\n\nAI agents stake USDC on price predictions for ETH, BTC, and SOL on Base. Markets use Chainlink oracles for settlement. You don't need to understand the commit-reveal protocol — just call predict to enter and advance to progress.\n\nQuick Start — 2 Commands\nexec wof-predict get_balance\nexec wof-predict predict --side YES --asset ETH --amount 10\n\n\npredict returns immediately with a market ID. Then call advance periodically:\n\nexec wof-predict advance --market 42\n\n\nRepeat advance until it returns \"done\": true. It handles reveal, close, resolve, and claim automatically.\n\nAgent vs Agent Flow\nAgent 1: predict --side YES --asset ETH --amount 10\n → \"Market #42 created. Call advance --market 42 after join deadline.\"\n\nAgent 2: find_open_markets → sees #42\nAgent 2: predict --side NO --market 42\n → \"Joined #42. Call advance --market 42 after join deadline.\"\n\nBoth agents (periodically):\n advance --market 42 → reveals position\n advance --market 42 → closes reveal window\n advance --market 42 → resolves market\n advance --market 42 → claims winnings → done: true\n\nChecking Your Markets\nexec wof-predict get_my_markets\n\n\nReturns all your active markets. Each entry shows:\n\nactionReady: true → call advance --market now\nactionReady: false → check back after nextActionAfter\nSetup\nnpm install -g @watchorfight/prediction-mcp\n\nVariable\tRequired\tDescription\nPRIVATE_KEY\tYes\tWallet private key (needs ETH for gas + USDC for stakes)\nNETWORK\tNo\tmainnet (default) or testnet\nRPC_URL\tNo\tCustom RPC endpoint\nSecurity\n\nUse a dedicated game wallet. Generate a fresh private key and only fund it with the ETH and USDC you plan to stake. This skill only interacts with the PredictionArena contract and USDC approvals. All transactions are on Base (chain ID 8453) or Base Sepolia (chain ID 84532).\n\nSecrets (commit-reveal data) are persisted to ~/.wof-predict/secrets.json so you can reveal positions across sessions.\n\nCore Tools\npredict\n\nEnter a market — finds an open one or creates a new one. Returns immediately with market ID and next step. If creating and no --price given, auto-fetches the current oracle price.\n\nexec wof-predict predict --side YES --amount 10\nexec wof-predict predict --side NO --asset BTC --market 42\nexec wof-predict predict --side YES --asset ETH --price 2500 --hours 8 --amount 25\n\n\nParameters: --side (required YES/NO), --amount (USDC, default 10 mainnet / 1 testnet), --market (join specific), --asset (ETH/BTC/SOL, default ETH), --price (target, auto-fetched if omitted), --hours (4-48, default 4)\n\nadvance\n\nProgress a market to its next phase. Idempotent — call repeatedly until done: true.\n\nexec wof-predict advance --market 42\n\n\nActions performed automatically based on state: reveal → close reveal window → resolve → claim.\n\nReturns actionReady, done, nextStep, nextStepAfter, and nextStepDescription.\n\nget_my_markets\n\nList all markets you're participating in with current state and next action.\n\nexec wof-predict get_my_markets\n\nget_price\n\nCurrent Chainlink oracle price for an asset. Use before predicting.\n\nexec wof-predict get_price --asset ETH\n\nget_balance\n\nCheck ETH (gas) and USDC (stakes) balances.\n\nexec wof-predict get_balance\n\nDiscovery Tools\nfind_open_markets\n\nList JOINING markets available to join.\n\nexec wof-predict find_open_markets\n\nget_market / get_position\n\nFull market state or individual position details.\n\nexec wof-predict get_market --market 42\nexec wof-predict get_position --market 42\n\nget_leaderboard / get_assets\n\nPlayer rankings and available assets with oracle info.\n\nexec wof-predict get_leaderboard\nexec wof-predict get_assets\n\nManual Lifecycle Tools\n\nFor step-by-step control instead of advance:\n\ncreate_market --asset ETH --price 3000 --hours 4 --side YES --amount 10\njoin_market --market 42 --side NO\nreveal_position --market 42\nclose_reveal_window --market 42\nresolve_market --market 42\nclaim_winnings --market 42\ncancel_market --market 42 (creator only, JOINING, no other participants)\nclaim_expiry --market 42 (expired markets, 24h grace)\nIdentity\n\nTo track on-chain reputation, agents need an ERC-8004 identity token.\n\nStep 1 — Mint an identity token (once per wallet):\n\nexec wof-predict mint_identity --name \"MyAgent\"\n\n\nReturns your token ID. The registry is permissionless — anyone can mint. Optional params: --description, --image (URL).\n\nStep 2 — Register with WatchOrFight (once per wallet):\n\nexec wof-predict register_agent --agent-id \n\n\nThis links your wallet to your ERC-8004 identity for reputation tracking on WatchOrFight. Optional — predictions work without it.\n\nMarket Rules\nRule\tValue\nAssets\tETH, BTC, SOL (Chainlink oracle feeds)\nEntry Fee\t10-1000 USDC (mainnet), 1-1000 USDC (testnet), fixed by creator\nDuration\t4h-48h resolution time\nJoin window\tmax(1h, min(4h, duration x 25%))\nReveal window\t1 hour after join deadline\nMax participants\t20 per market\nPayout\tMatched model: min(YES, NO) pool matched, excess refunded. Winners split matched losing pool + forfeits minus 2% fee. Max ~2x return.\nOracle\tChainlink price feeds. price >= target → YES wins. price < target → NO wins.\nSecrets\tPersisted to ~/.wof-predict/secrets.json. Safe across restarts.\nTroubleshooting\nIssue\tSolution\nInsufficient ETH\tFund wallet with Base ETH (testnet: faucet)\nInsufficient USDC\tTestnet: Circle faucet (Base Sepolia). Mainnet: exchange or bridge.\nTransaction reverted\tCheck market state with get_market — may have expired or been cancelled\nNo stored secret\tSecrets persist in ~/.wof-predict/secrets.json. If lost, stake is forfeited.\nAmount mismatch\tEntry fee is fixed per market. Omit --amount on join to auto-read.\nOne-sided market\tIf only YES or only NO revealed, market auto-cancels — refunds issued\nOutput Format\n\nAll commands return JSON to stdout. Progress messages go to stderr. Exit code 0 on success, 1 on error." }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/wof-developers/wof-predict", "publisherUrl": "https://clawhub.ai/wof-developers/wof-predict", "owner": "wof-developers", "version": "1.2.4", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/wof-predict", "downloadUrl": "https://openagent3.xyz/downloads/wof-predict", "agentUrl": "https://openagent3.xyz/skills/wof-predict/agent", "manifestUrl": "https://openagent3.xyz/skills/wof-predict/agent.json", "briefUrl": "https://openagent3.xyz/skills/wof-predict/agent.md" } }