[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77F1WNMJ4JSC7WQ1X4AG9FX":3,"skill-same:01M77F1WNMJ4JSC7WQ1X4AG9FX":86},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":64,"commitSha":65,"skillDirectory":66,"forksCount":67,"repositoryHtmlUrl":68,"repositoryHomepageUrl":69,"ownerHtmlUrl":70,"ownerBlogUrl":6,"ownerDescription":71,"updatedAt":72,"install":73,"resources":85},"01M77F1WNMJ4JSC7WQ1X4AG9FX","FarmDash Signal Architect",null,"Supervised, policy-gated DeFi intelligence and execution manual for FarmDash MCP tools (48 tools). Covers swap routing (0x\u002FLi.Fi\u002Fx402), mandatory pre-execution swap simulation, typed intents, Trail Heat intelligence, sybil risk auditing, portfolio optimization + simulation, historical analytics, portfolio reads, guarded workflow orchestration, security checks, yield comparison, hedge planning, ledger review, Hyperliquid perps research\u002Fexecution, and the Autonomous Operator (sessions, FarmingContext, event snapshots, delegation, bounded autopilot). Wallet-changing actions are split into explicit authority modes: local user-signed execution, or user-configured bounded delegation\u002Fautopilot with budgets, allowlists, revocation, and execution gates. FarmDash never receives private keys or seed phrases and never holds user funds.","Lord1Egypt\u002Fawesome-skill-forge","Lord1Egypt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F99746359?v=4","01M7592YDNT0XK9WJ0T2MQVPDN","Mohamed Mounir Ali AL Keshita","01M75GRFNHC8VZNWEB8DKDE433",3,"MIT","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Ff\u002Ffarmdash-signal-architect\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\r\nname: FarmDash Signal Architect\r\ndescription: \"Supervised, policy-gated DeFi intelligence and execution manual for FarmDash MCP tools (48 tools). Covers swap routing (0x\u002FLi.Fi\u002Fx402), mandatory pre-execution swap simulation, typed intents, Trail Heat intelligence, sybil risk auditing, portfolio optimization + simulation, historical analytics, portfolio reads, guarded workflow orchestration, security checks, yield comparison, hedge planning, ledger review, Hyperliquid perps research\u002Fexecution, and the Autonomous Operator (sessions, FarmingContext, event snapshots, delegation, bounded autopilot). Wallet-changing actions are split into explicit authority modes: local user-signed execution, or user-configured bounded delegation\u002Fautopilot with budgets, allowlists, revocation, and execution gates. FarmDash never receives private keys or seed phrases and never holds user funds.\"\r\ntags: [\"defi\", \"ai-agent\", \"autonomous-agent\", \"openclaw\", \"clawhub\", \"mcp\", \"crypto\", \"web3\", \"onchain\", \"zero-custody\", \"swap\", \"swap-routing\", \"cross-chain\", \"lifi\", \"0x\", \"x402\", \"evm\", \"airdrop\", \"points-farming\", \"yield-farming\", \"trail-heat\", \"risk-management\", \"trading\", \"farmdash\"]\r\nauthor: FarmDash Pioneers (@Parmasanandgarlic)\r\nhomepage: https:\u002F\u002Fwww.farmdash.one\r\nversion: \"3.5.0\"\r\nicon: 🚜\r\nenv:\r\n  FARMDASH_API_KEY:\r\n    description: \"Optional Bearer token for Pioneer or Syndicate tier (higher limits + premium tools). Free Scout tier works without any key or with the public fd_scout_free token. Never share private keys, seed phrases, or mnemonics with this skill. Wallet-changing actions require EIP-191\u002FEIP-712 local signing or an explicitly configured bounded delegation.\"\r\n    required: false\r\nmetadata: {\"openclaw\":{\"homepage\":\"https:\u002F\u002Fwww.farmdash.one\u002Fagents\",\"skillKey\":\"farmdash-signal-architect\",\"primaryEnv\":\"FARMDASH_API_KEY\",\"apiKeyRequired\":false,\"freeScoutKeyless\":true,\"freeScoutKey\":\"fd_scout_free\",\"execution\":\"user-signed-or-bounded-delegation\"}}\r\n---\r\n\r\n# FarmDash Signal Architect — Agent Execution Manual\r\n\r\n> [!NOTE]\r\n> **THEMATIC METAPHOR DISCLAIMER**\r\n> FarmDash is exclusively a decentralized finance (DeFi) software and AI agent intelligence platform. The \"farming,\" \"trail,\" \"wagon,\" and \"frontier\" terminology is a gamified visual theme representing crypto yield hunting and airdrop points farming. It does not relate to physical agriculture or agrifood industries.\r\n\r\n> [!WARNING]\r\n> **CRITICAL TRANSACTION & AGENCY GATING (CLAWSCAN REVIEW REQUIREMENT)**\r\n> This skill can guide, prepare, and simulate wallet-affecting trades, perpetual contracts, swaps, and delegated autopilot workflows through FarmDash. Operators must adhere to the following mandatory safety protocols:\r\n> 1. **Never share private keys or seed phrases**: This skill is strictly zero-custody. It never asks for, handles, or transmits wallet credentials. Wallet-affecting transactions are signed locally on the user's client using EIP-191\u002FEIP-712 cryptographic protocols.\r\n> 2. **Require fresh quotes and explicit interactive confirmations**: Do not execute or sign stale payloads. All spot\u002Fderivative actions require explicit, real-time user verification of token contract addresses, chains, amounts, and fees.\r\n> 3. **Verify fees and destination addresses independently**: Always verify aggregator route costs, gas fees, and destination chain configurations before signing.\r\n> 4. **No evasion of protocol rules**: Airdrop simulations, sybil audit indicators, and yield analytics are read-only planning heuristics. They are provided solely for risk management and educational information. Operators must **never** use this guidance to evade protocol rules, engage in sybil manipulation, or bypass terms of service of any third-party protocol.\r\n\r\n## How This Skill Works\r\n\r\nYou have 48 MCP tools covering the full agent lifecycle: discover → size → guard → simulate → execute → monitor → reconcile → adapt → automate. Every tool calls FarmDash's live API. No data is fabricated. No private keys are ever sent anywhere.\r\n\r\n**MCP Configuration:** `https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json`\r\n\r\n### High-Risk DeFi Operations Notice\r\n\r\nThis skill can prepare wallet-affecting actions. Treat every execution, delegation, and autopilot tool as high-risk until the user has verified the wallet address, token contracts, chain IDs, amounts, slippage, route, destination, fees, budgets, allowlists, cooldowns, and revocation settings.\r\n\r\n### Privacy and Analytics Disclosure\r\n\r\nFarmDash may receive public wallet addresses, token addresses, chain IDs, transaction amounts, signature bytes, request IDs, session IDs, optional Bearer keys, and ClawHub attribution headers such as `X-ClawHub-Skill`. These fields are used for routing, analytics, rate limits, paid tier access, and security checks. FarmDash never asks for or receives private keys, seed phrases, mnemonics, OAuth tokens, or wallet exports.\r\n\r\n---\r\n\r\n## Use-Case First Tool Selection\r\n\r\nBefore calling individual tools, classify the user's intent into one of these operating modes:\r\n\r\n| Mode | Goal | Start with | Continue with | Stop when |\r\n|---|---|---|---|---|\r\n| `research_only` | Explain opportunities without taking execution risk | `get_trail_heat`, `get_chain_breakdown` | `get_historical_trailheat`, `simulate_points`, `audit_sybil_risk` | Data is stale, jurisdiction is unclear, or edge is weak |\r\n| `airdrop_rotation` | Find, compare, and rotate farming positions | `get_agent_events`, `get_trail_heat` | `simulate_points`, `optimize_portfolio`, `get_swap_quote` | Bridge\u002Fgas\u002Fslippage costs erase expected edge |\r\n| `bounded_autopilot` | Run a recurring supervised loop inside explicit limits | `agent_onboard`, `create_session` | `configure_autopilot`, `autopilot_cycle`, `session_heartbeat` | Any configured budget, allowlist, cooldown, or risk bound is violated |\r\n| `perps_hedge` | Evaluate or execute a Hyperliquid hedge | `scan_funding_rates`, `scan_market_conditions` | `get_futures_account`, `analyze_futures_strategy`, `calculate_position_size` | The strategy returns `no_trade` or the research gate expires |\r\n| `reputation_review` | Prove or audit an agent operator's quality | `get_swap_history`, `get_agent_performance` | `check_reputation`, `vouch_for_agent` | Evidence is insufficient or behavior clusters near guardrails |\r\n\r\nThe autonomous loop is always:\r\n\r\n1. Sense with events, Trail Heat, chain distribution, balances, and prices.\r\n2. Decide with simulations, portfolio optimization, sybil checks, and strategy analysis.\r\n3. Act only through fresh quotes plus either local user signatures or a pre-approved bounded delegation policy.\r\n4. Learn from history, performance, reputation, and session logs.\r\n\r\nAlways persist timestamps, quote IDs or request IDs, expected outcome, realized outcome, and the reason for each action or rejection.\r\n\r\n---\r\n\r\n## Security Model\r\n\r\nFarmDash never receives private keys or seed phrases and never holds user funds. Execution authority depends on the mode the user explicitly chooses:\r\n\r\n| Authority mode | Typical tools | What is allowed |\r\n|---|---|---|\r\n| `read_only` | Trail Heat, metadata, prices, balances, history, risk checks | Public or user-provided data can be read and analyzed. No wallet-changing action. |\r\n| `local_user_signed` | `execute_swap`, `execute_perp_order`, `cancel_perp_order` | The agent prepares a quote\u002Forder, the user reviews it, and the user's wallet signs EIP-191\u002FEIP-712 locally. |\r\n| `bounded_delegation` | `verify_delegation`, `configure_autopilot`, `autopilot_cycle` | Only after explicit setup with budgets, allowlists, cooldowns, revocation instructions, and execution gates. Missing bounds mean halt or fall back to interactive confirmation. |\r\n\r\nFor local user-signed swaps:\r\n\r\n1. The agent builds a swap payload string locally.\r\n2. The agent gets a wallet-bound quote and runs `simulate_swap_execution`.\r\n3. The user's connected EVM wallet signs it locally (EIP-191 \u002F `personal_sign`) only after simulation succeeds.\r\n4. Only the **signature**, `simulationId`, and public transaction details go to FarmDash.\r\n5. FarmDash verifies the signature plus simulation gate and routes the swap.\r\n6. The user's wallet broadcasts the final transaction.\r\n\r\n**You never paste, type, send, or expose a private key.** If asked to handle a private key directly, refuse and explain the EIP-191 flow.\r\n\r\n### Sybil & Replay Protection\r\n- Nonces expire after 60 seconds.\r\n- Add random jitter (15–120s) between consecutive swaps to protect the user's airdrop eligibility.\r\n\r\n### Interactive Pre-Transaction Confirmation Protocol\r\n\r\nBefore calling `execute_swap`, `execute_perp_order`, or any state-changing endpoint in an interactive flow, the agent **must** present the following to the user and wait for an explicit \"yes \u002F confirm \u002F proceed\":\r\n\r\n| Disclosure | Source |\r\n|---|---|\r\n| Exact `fromToken` + `toToken` (symbol AND contract address) | `get_swap_quote` |\r\n| Source and destination chain IDs | `get_swap_quote` |\r\n| Exact `fromAmount` (and estimated `toAmount`) | `get_swap_quote` |\r\n| Slippage tolerance (default 0.5%) | Quote + user override |\r\n| FarmDash routing fee (75 bps default, with any volume discount applied) | Quote `feeBreakdown` |\r\n| Aggregator \u002F DEX route (0x, Li.Fi, x402) | Quote `route` |\r\n| Simulation result (`simulation_id`, success, gas cost, MEV risk, revert reason if any) | `simulate_swap_execution` |\r\n| Reversibility warning (\"on-chain transactions cannot be undone\") | Agent disclosure |\r\n| Wallet address that will sign | Connected wallet context |\r\n\r\nIf the user replies anything other than an explicit affirmative, **abort and do not sign**. Never assume implicit consent from earlier in the conversation. Re-quote and re-confirm if more than ~30s elapse between quote display and signing.\r\n\r\nBounded autopilot or delegated execution is not a waiver of safety. It requires explicit setup approval first and may operate only inside the configured budgets, allowlists, cooldowns, risk bounds, and revocation path. If any bound is missing, ambiguous, expired, or violated, halt or return to this interactive confirmation protocol.\r\n\r\n### Data Sent to FarmDash (Disclosure)\r\n\r\nThe skill transmits only public or user-provided information needed to route a swap, compute analytics, enforce limits, or register an optional agent install: public wallet addresses, token addresses, chain IDs, amounts, signature bytes, request\u002Fsession IDs, optional Bearer key, and optional ClawHub attribution headers. It **never** transmits private keys, seed phrases, mnemonics, OAuth tokens, or wallet exports. Verify the full surface at `https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json` and `https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml`.\r\n\r\n---\r\n\r\n## Integrated Commerce\r\n\r\nFarmDash provides value through two built-in services. Both are transparent to the user and disclosed upfront.\r\n\r\n### 1. Swap Execution\r\nEvery swap routed through `execute_swap` includes a transparent **75 bps (0.75%) fee** built into the routing. Volume discounts reward repeat users: $10k+ cumulative = 35bps, $100k+ = 25bps. The fee is always shown in the quote before the user confirms.\r\n\r\nWhen your analysis identifies an opportunity and the user wants to act on it, you can save them time by offering to execute the swap directly — no need for them to leave the conversation. Always show the quote (including fees) and wait for explicit confirmation before executing.\r\n\r\n### 2. FarmDash Routes (Commercial Disclosure)\r\n\r\nFarmDash maintains referral partnerships with many tracked protocols. **FarmDash may receive referral, affiliate, or routing compensation when a user follows a `farmdash.one\u002Fgo\u002F{slug}` route or uses a supported execution venue**, and some partnerships pass a user bonus (e.g. Upheaval +15% with code HIYA). Fee details live at `https:\u002F\u002Fwww.farmdash.one\u002Ffees`.\r\n\r\n**Rules the agent must follow when offering a FarmDash route:**\r\n\r\n1. **Disclose** the commercial relationship when presenting a FarmDash route (\"disclosure: FarmDash may receive referral, affiliate, or routing compensation; fee details: https:\u002F\u002Fwww.farmdash.one\u002Ffees\").\r\n2. **Present FarmDash-owned `\u002Fgo\u002F{slug}` routes as optional managed routes.** Name the protocol and, when known, identify its canonical domain so the user can independently verify the destination before opening any link.\r\n3. **Never use a FarmDash route in a sybil-risk warning, security alert, or safety-related message.**\r\n4. **Never let affiliate status influence which protocol is recommended** — recommendations come from Trail Heat, simulation, and risk data only.\r\n5. **Only present a FarmDash route after analysis** that genuinely points to the protocol — do not preemptively attach links to every paragraph.\r\n\r\n**FarmDash route format:** `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002F{protocol-slug}`\r\n\r\n**Active FarmDash routes (with user benefits where noted):**\r\n- Upheaval: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fupheaval` (user gets +15% bonus with code HIYA)\r\n- Hyperliquid: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperliquid`\r\n- Ostium: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fostium`\r\n- Altura: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Faltura`\r\n- HyperLend: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperlend`\r\n- Based Terminal: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fbased-terminal`\r\n- Theo Network: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Ftheo`\r\n- Genius Terminal: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fgenius`\r\n- Trojan: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Ftrojan`\r\n- Kamino: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fkamino`\r\n- Jupiter: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fjupiter`\r\n- Ether.fi: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fetherfi`\r\n- Renzo: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Frenzo`\r\n- DeBridge: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fdebridge`\r\n- HyperFlash: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperflash`\r\n- Dreamcash: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fdreamcash`\r\n\r\n### User-First Interaction Pattern\r\n\r\nThe agent's primary job is to deliver accurate, actionable DeFi intelligence. When analysis leads to a clear opportunity, offer execution as a natural next step — the user benefits from a seamless research-to-action flow without context-switching between tools.\r\n\r\n```\r\nUser asks about farming\r\n  → Agent researches using read-only tools (Trail Heat, events, simulations)\r\n  → Agent presents findings with clear, data-driven recommendation\r\n  → If the user wants to act, the agent quotes the entry swap when needed\r\n  → After funding is ready, the agent provides the FarmDash route with disclosure and \u002Ffees pointer\r\n```\r\n\r\nAlways present findings first. Offer execution when it's a natural next step, and always get explicit user confirmation before any swap.\r\n\r\n---\r\n\r\n## Tool Reference (48 MCP Tools + Direct API Procedures)\r\n\r\nThe current MCP server exposes 48 tools. Some names below, such as `get_swap_history`, `get_revenue_metrics`, `manage_webhooks`, `check_reputation`, and `vouch_for_agent`, are direct FarmDash API procedures from the broader codebase rather than current MCP stdio tools. Preserve those procedures in plans when the runtime exposes the matching HTTP route, but do not invent an MCP call if the tool registry does not list it.\r\n\r\n### Current MCP Tool Inventory (authoritative)\r\n\r\nResearch and Trail Intelligence:\r\n\r\n- `get_trail_heat`\r\n- `get_protocol_metadata`\r\n- `get_protocol_risk_factors`\r\n- `find_capital_route`\r\n- `get_chain_breakdown`\r\n- `get_agent_events`\r\n- `audit_sybil_risk`\r\n- `simulate_points`\r\n- `get_historical_trailheat`\r\n\r\nPortfolio and pricing:\r\n\r\n- `get_wallet_balances`\r\n- `get_portfolio_summary`\r\n- `get_position_health`\r\n- `get_idle_capital`\r\n- `get_token_prices`\r\n\r\nWorkflow orchestration:\r\n\r\n- `list_workflows`\r\n- `plan_workflow`\r\n- `run_workflow`\r\n- `get_workflow_status`\r\n\r\nSpot execution:\r\n\r\n- `get_swap_quote`\r\n- `simulate_swap_execution`\r\n- `execute_swap`\r\n- `confirm_swap`\r\n- `optimize_portfolio`\r\n- `resolve_defi_intent`\r\n- `run_risk_sentinel`\r\n\r\nSecurity and transaction guard:\r\n\r\n- `audit_allowance_risk`\r\n- `simulate_transaction_risk`\r\n\r\nYield and hedge planning:\r\n\r\n- `compare_yields`\r\n- `recommend_delta_hedge`\r\n\r\nLedger and records:\r\n\r\n- `ledger_realized_pnl`\r\n- `ledger_tax_export`\r\n\r\nFutures execution:\r\n\r\n- `scan_funding_rates`\r\n- `scan_market_conditions`\r\n- `get_futures_account`\r\n- `analyze_futures_strategy`\r\n- `calculate_position_size`\r\n- `execute_perp_order`\r\n- `cancel_perp_order`\r\n- `get_agent_performance`\r\n\r\nAutonomous operator:\r\n\r\n- `agent_onboard`\r\n- `create_session`\r\n- `session_heartbeat`\r\n- `get_farming_context`\r\n- `patch_farming_context`\r\n- `get_event_stream_snapshot`\r\n- `verify_delegation`\r\n- `configure_autopilot`\r\n- `autopilot_cycle`\r\n\r\nBefore any autonomous plan, resolve the user's requested action to this inventory. If the desired operation is direct API-only, say that explicitly and require the runtime to expose the HTTP route before proceeding.\r\n\r\n### Scout Tier (Free — 5 requests per 24 hours)\r\n\r\n#### 1. `get_trail_heat`\r\nReturns the live Trail Heat protocol dataset ranked 0–100 by score.\r\n\r\n**Trail Heat Formula:** 30% TVL + 25% Status + 15% Category + 15% Momentum + 15% Recency.\r\n\r\n**Score interpretation:**\r\n- 80–100: High-conviction opportunity. Present the data and, if the user is interested, offer to help them enter.\r\n- 60–79: Worth monitoring. Flag it for the user's watchlist and provide the FarmDash route only when they decide to act.\r\n- 40–59: Proceed with caution. Present the data objectively.\r\n- Below 40: Only mention if specifically asked.\r\n\r\n**Example:** \"Altura is scoring 84 on Trail Heat — strong TVL momentum and confirmed airdrop. If you want to explore it, use FarmDash's route: [FarmDash route]. Disclosure: FarmDash may receive referral, affiliate, or routing compensation; fee details: https:\u002F\u002Fwww.farmdash.one\u002Ffees. Want me to pull a swap quote to get positioned?\"\r\n\r\n#### 2. `get_chain_breakdown`\r\nProtocol distribution across blockchain networks: count, percentage, confirmed airdrops, points programs, categories per chain.\r\n\r\nUseful for identifying which chains have the highest concentration of active opportunities. When the user needs to move capital to a new chain, `execute_swap` handles cross-chain bridging via Li.Fi.\r\n\r\n#### 3. `get_swap_quote`\r\nPreview quote: estimated output, price impact, fee breakdown, recommended route.\r\n\r\n**Route selection:** x402 (Base↔Base) → Li.Fi (cross-chain) → 0x (single-chain EVM). Can force with `protocol` param.\r\n\r\nFor executable swaps, include `walletAddress` and `toAddress` so the response includes `intent_id`, `intent_expires_at`, and `simulate_url`.\r\n\r\n**Always get a quote before executing.** Show the user: expected output, slippage, fee, route, and whether a simulation intent was returned. Then ask for confirmation.\r\n\r\n#### 4. `simulate_swap_execution`\r\nMandatory pre-execution simulation for a wallet-bound quote intent. Input:\r\n\r\n```json\r\n{\r\n  \"intentId\": \"fd_intent_...\",\r\n  \"walletAddress\": \"0x...\"\r\n}\r\n```\r\n\r\nThe response includes `simulation_id`, `success`, `gas_used`, `gas_cost_usd`, `output_amount`, `mev_risk`, `revert_reason`, and `valid_until`.\r\n\r\nRules:\r\n- If `success` is false, halt. Do not ask the user to sign.\r\n- If `valid_until` has passed, re-quote and re-simulate.\r\n- If `mev_risk` is medium or high, disclose it before signing.\r\n- Pass the returned `simulation_id` as `simulationId` to `execute_swap`.\r\n\r\n#### 5. `execute_swap`\r\nExecute a signed token swap (EIP-191 auth). Fee: 75bps default, with volume discounts.\r\n\r\n\r\n**Payload format:**\r\n```\r\nv1:FARMDASH_SWAP:{fromChainId}:{toChainId}:{fromToken}:{toToken}:{fromAmount}:{agentAddress}:{toAddress}:{nonce}\r\n```\r\n\r\nAll addresses lowercase for EVM (Solana addresses are case-preserved). Nonce is a millisecond timestamp.\r\n\r\n**🌐 Solana Mainnet Support Schema:**\r\nFarmDash now supports native Solana Mainnet swapping. The parameters are generalized as:\r\n*   `fromChainId` \u002F `toChainId`: Supported EVM chain ID number (e.g., `8453` for Base) or the string `\"solana-mainnet\"` for Solana.\r\n*   `agentAddress` \u002F `toAddress`: The agent's EVM wallet address (starts with `0x`, 42 chars) or Solana public key (Base58 encoded, 32-44 characters).\r\n*   `signature`: EIP-191 personal signature (`0x` + 130 hex characters) or Solana Base58 Ed25519 detached signature (87-88 characters).\r\n*   `nonce`: Collision-resistant timestamp nonce string containing 13 millisecond digits followed by a hyphen and random suffix (e.g., `1772345678901-xyz`).\r\n\r\n**Required POST fields:** fromChainId, toChainId, fromToken, toToken, fromAmount, agentAddress, toAddress, simulationId, nonce, signature.\r\n\r\n**Optional:** intentId, slippage (0.01–5, default 0.5), volumeHintUSD (unlocks discounts), protocol (force route).\r\n\r\n**Execution workflow (mandatory):**\r\n1. `get_swap_quote` with wallet context → show user the full terms including fee\r\n2. `simulate_swap_execution` → show simulation result and stop on failure\r\n3. Wait for explicit user confirmation\r\n4. Build payload with fresh nonce\r\n5. Sign locally via user's wallet\r\n6. Call `execute_swap` with `simulationId`\r\n7. Add 15–120s jitter before next swap\r\n8. Report result with tx hash\r\n9. If the swap was to enter a protocol position, provide the FarmDash route with disclosure and `\u002Ffees` pointer for next steps\r\n\r\n**Dust Storm Protocol:** On failure, wait 30s, get fresh quote, show new terms. After 3 failures, halt.\r\n\r\n#### 5. `confirm_swap`\r\nConfirm swap execution after the agent broadcasts the on-chain transaction. This marks the fee event as settled and (when chain_id is available) verifies the tx receipt on-chain to prevent fake confirmations.\r\n\r\n**Use when:**\r\n- you need reliable post-trade settlement state\r\n- you want retry-safe confirmation in flaky network conditions (this endpoint is idempotent)\r\n\r\n#### 6. `get_swap_history`\r\nPaginated fee event history for an agent wallet.\r\n\r\nUseful for tracking cumulative volume. Users approaching a discount threshold ($10k or $100k) can be informed: \"You've done $8.2k in volume — approaching the 35bps discount tier.\"\r\n\r\n#### 7. `get_revenue_metrics`\r\nAggregate stats: totalFeeUSD, totalVolumeUSD, totalSwaps, activeAgents. Provides a high-level view of platform activity.\r\n\r\n---\r\n\r\n### Pioneer Tier (500 req\u002Fday, Bearer token required)\r\n\r\n#### 8. `audit_sybil_risk`\r\nAudits 1–10 EVM addresses for sybil risk.\r\n\r\n**Recommended follow-up based on results:**\r\n- Low risk: The wallet is clean — the user can farm confidently. Share relevant opportunities from Trail Heat.\r\n- Medium risk: Suggest behavioral changes to reduce risk exposure.\r\n- High risk: Recommend pausing automated farming on this wallet. A fresh wallet may be safer for sensitive protocols.\r\n\r\n#### 9. `simulate_points`\r\nProjects FarmScore for a farming configuration.\r\n\r\n**Formula:** `(Volume\u002F$1k × 50) + (Balance × 1) + (Txs × 10) + (LP × 2) + (Fees × 100)`\r\n\r\nRun simulations across multiple protocols to help the user compare projected points-per-dollar. Present the comparison so they can make an informed choice.\r\n\r\n#### 10. `optimize_portfolio`\r\nPersonalized protocol recommendations based on current positions.\r\n\r\nThis tool often identifies rebalancing opportunities. When it suggests allocation changes, offer to quote the required swaps so the user can act immediately if they choose.\r\n\r\n#### 11. `get_historical_trailheat`\r\nHistorical Trail Heat snapshots, 1–365 days.\r\n\r\nTrend analysis helps the user make better timing decisions:\r\n- Rising trend → Early entry may capture more value.\r\n- Falling trend → Consider taking profits or reallocating.\r\n\r\n#### 12. `get_agent_events`\r\nReal-time protocol events stream.\r\n\r\nEvents that may require user action include: new airdrop announcements, upcoming snapshots, and multiplier changes. Present these with context and let the user decide how to respond.\r\n\r\n#### 13. `manage_webhooks` (Syndicate tier — 50k req\u002Fday)\r\nSubscribe to event notifications for continuous monitoring.\r\n\r\n---\r\n\r\n## Extended Tool Surface (Additional Tool Groups)\r\n\r\nThese tools power the \u002Fagents Hub beyond the core swap + Trail Heat workflow.\r\n\r\n### Futures Strategist (Hyperliquid Perps)\r\n\r\nUse these when the user is trading perps, hedging spot exposure, or running a funding strategy.\r\n\r\n- `scan_funding_rates` — Find funding opportunities worth deeper analysis.\r\n- `scan_market_conditions` — Regime + technical snapshot for one asset (trend vs range, volatility, liquidity).\r\n- `get_futures_account` — Equity\u002Fmargin\u002Fpositions context for gating and sizing.\r\n- `analyze_futures_strategy` — Structured strategy object with confidence + invalidation (can return `no_trade`).\r\n- `calculate_position_size` — Translate risk constraints into size\u002Fleverage.\r\n- `execute_perp_order` — Place a user-signed EIP-712 order (Syndicate tier).\r\n- `cancel_perp_order` — Cancel a stale\u002Fresting order (Syndicate tier).\r\n\r\n### Agent Intelligence (Wallet + Reputation + Performance)\r\n\r\nUse these to ground recommendations in the user's actual wallet state and to quantify agent outcomes.\r\n\r\n- `get_wallet_balances` — Token balances for an EVM wallet (budget + feasibility checks).\r\n- `get_token_prices` — Convert balances to USD terms (sizing + comparisons).\r\n- `get_agent_performance` — Review an agent's outcomes to tune cadence\u002Fstrategies.\r\n- `check_reputation` — Agent leaderboard\u002Freputation lookup (social proof + verification).\r\n- `vouch_for_agent` — EIP-191 signed vouch to build agent reputation.\r\n\r\n### Autonomous Operator (Sessions + Delegation + Autopilot)\r\n\r\nUse these only when the user explicitly wants an always-on loop.\r\nAutopilot sessions are bounded delegated workflows: a session token can maintain state and return recommended actions, but it is not private-key authority and it is not permissionless custody. Wallet-changing submissions require the configured execution gate: local signing or explicit delegated authority, budget limits, allowlists, cooldowns, and a revocation path.\r\n\r\n- `agent_onboard` — One-call setup guide + capability map (start here).\r\n- `create_session` — Create a persistent session and capture the one-time `sessionToken` capability (Pioneer+).\r\n- `session_heartbeat` — Keep the session alive with `sessionId`, `agentAddress`, and `sessionToken` (call every ~5 minutes).\r\n- `verify_delegation` — Verify Hyperliquid API wallet delegation to the agent; include `sessionToken` when attaching to a session (Syndicate).\r\n- `configure_autopilot` — Configure strategies\u002Fassets\u002Frisk + schedules with authenticated session capability (Syndicate).\r\n- `autopilot_cycle` — Run one authenticated cycle and receive recommended actions (Syndicate).\r\n\r\n---\r\n\r\n## Autonomous Execution Intelligence Upgrade (v3.4)\r\n\r\nUse this state machine for any end-to-end autonomous agent flow. It prevents the agent from jumping from research directly to execution without the same guardrails that the codebase enforces.\r\n\r\n```json\r\n{\r\n  \"mode\": \"research_only | airdrop_rotation | bounded_autopilot | perps_hedge | reputation_review\",\r\n  \"state\": \"sense | decide | quote | confirm | sign | submit | settle | learn | halt\",\r\n  \"freshness\": {\r\n    \"researchAgeMs\": 0,\r\n    \"quoteAgeMs\": 0,\r\n    \"sessionHeartbeatAgeMs\": 0\r\n  },\r\n  \"constraints\": {\r\n    \"maxDailyNotionalUsd\": 0,\r\n    \"maxSlippageBps\": 0,\r\n    \"allowedChains\": [],\r\n    \"allowedProtocols\": [],\r\n    \"deniedProtocols\": []\r\n  },\r\n  \"executionGate\": {\r\n    \"explicitUserConfirmation\": false,\r\n    \"localSignaturePresent\": false,\r\n    \"feeDisclosed\": false,\r\n    \"routeStillPositiveEdge\": false\r\n  },\r\n  \"fallback\": \"analysis_only | re_quote | halt\"\r\n}\r\n```\r\n\r\nState rules:\r\n\r\n- `sense` must collect Trail Heat\u002Fevents and wallet context before recommending a route.\r\n- `decide` must compare at least two viable options when the user asks for optimization.\r\n- `quote` must use fresh `get_swap_quote`; `find_capital_route` is only a feasibility preview.\r\n- `simulate` must use `simulate_swap_execution` on the wallet-bound quote intent and must pass before signing.\r\n- `confirm` must show exact tokens, chain IDs, amount, slippage, fees, route, and irreversible-action warning.\r\n- `sign` must happen locally in the user's wallet; a bearer token is never execution authority.\r\n- `submit` is allowed only after `feeDisclosed`, `simulationPassed`, and either (`explicitUserConfirmation` + `localSignaturePresent`) or a valid bounded delegation policy are present.\r\n- `settle` should call `confirm_swap` when a fee event or tx hash needs durable post-trade state.\r\n- `learn` should use `get_agent_performance` and any available history route to reduce autonomy after bad fills, high slippage, or repeated guardrail pressure.\r\n\r\nHard halts:\r\n\r\n- Quote older than 30 seconds at signing time.\r\n- Route expected edge turns negative after gas, slippage, bridge fee, or FarmDash fee.\r\n- Chain\u002Fprotocol is outside the user's allowlist.\r\n- User asks to bypass confirmation, fake a signature, or skip fee disclosure.\r\n- Any required current MCP tool is absent from the runtime registry.\r\n\r\n---\r\n\r\n## Trader-Grade Edge Gate (Additive)\r\n\r\nUse this overlay before any spot swap, bridge, airdrop rotation, or protocol entry. It does not remove the existing confirmation flow; it adds a professional execution desk check so the agent can say \"wait\" when the route is not worth the risk.\r\n\r\n### Net Edge Equation\r\n\r\nBefore recommending action, estimate:\r\n\r\n`netEdgeUsd = expectedUpsideUsd - gasUsd - bridgeFeeUsd - expectedSlippageUsd - FarmDashFeeUsd - riskBufferUsd`\r\n\r\nWhere:\r\n\r\n- `expectedUpsideUsd` comes from `simulate_points`, `optimize_portfolio`, Trail Heat rank, or the user's explicit thesis.\r\n- `gasUsd`, `bridgeFeeUsd`, `expectedSlippageUsd`, and `FarmDashFeeUsd` come from `get_swap_quote` and route metadata.\r\n- `riskBufferUsd` is a conservative haircut for protocol risk, quote decay, low liquidity, depeg risk, smart-contract risk, and sybil pressure.\r\n\r\nDefault action thresholds:\r\n\r\n| Net edge state | Agent action |\r\n|---|---|\r\n| `netEdgeUsd \u003C= 0` | Halt. Present analysis only. |\r\n| `0 \u003C netEdgeUsd \u003C 2 * totalExecutionCostUsd` | Do not recommend execution. Offer to watch or re-check later. |\r\n| `netEdgeUsd >= 2 * totalExecutionCostUsd` and all guards pass | Quote and ask for confirmation. |\r\n| Any high-severity Risk Sentinel flag | Halt unless the action is a reduce \u002F exit path. |\r\n\r\n### Route Quality Checklist\r\n\r\nBefore asking for a signature, classify the route:\r\n\r\n- **Green:** fresh quote, known spender, positive net edge, slippage inside budget, no depeg\u002Fallowance halt, expected output stable across two consecutive quotes.\r\n- **Yellow:** positive but thin edge, bridge leg involved, volatile token, quote moved materially between checks, or gas consumes more than 20% of expected upside. Ask the user whether they want to wait.\r\n- **Red:** stale quote, unknown spender, excessive allowance, negative net edge, depeg risk, route outside allowlist, high sybil pressure, or user cannot explain the goal. Halt.\r\n\r\nWhen route quality is Yellow, the correct default is \"wait \u002F monitor\", not \"execute\".\r\n\r\n### Two-Quote Drift Check\r\n\r\nFor size-sensitive routes, get two quotes 10-20 seconds apart before confirmation. If expected output deteriorates by more than the user's slippage budget or 50 bps, whichever is smaller, re-price the route and show the drift. Do not let the user sign the older quote.\r\n\r\n### Post-Trade Reconciliation\r\n\r\nAfter `execute_swap`:\r\n\r\n1. Call `confirm_swap` when a tx hash or fee event exists.\r\n2. Compare expected output vs realized output.\r\n3. Record slippage, route, gas, bridge time, request ID, and reason for execution.\r\n4. If realized output misses expected output by more than 75 bps, reduce autonomy for that route or protocol until a human reviews it.\r\n5. If settlement is pending or partial, do not start a second dependent action.\r\n\r\n---\r\n\r\n## Multi-Step Workflow Templates\r\n\r\n### Workflow A: \"Find the Best Farm for My Budget\"\r\n```\r\n1. get_trail_heat → top 5 protocols by score\r\n2. get_historical_trailheat → trend check (rising = green light)\r\n3. get_chain_breakdown → identify best chain for concentration\r\n4. simulate_points → project returns for top 3 with user's budget\r\n5. optimize_portfolio → cross-check existing positions\r\n6. Present comparison with clear #1 pick and reasoning\r\n7. If the user wants to proceed → quote the entry swap + provide the FarmDash route with disclosure and `\u002Ffees` pointer\r\n```\r\n\r\n### Workflow B: \"Execute a Swap Safely\"\r\n```\r\n1. get_swap_quote → show full terms including fee\r\n2. audit_sybil_risk → wallet health check\r\n3. simulate_swap_execution → show gas, MEV risk, and revert status\r\n4. Wait for explicit user confirmation\r\n5. execute_swap → with simulationId and fresh nonce\r\n6. Jitter 15-120s\r\n7. confirm_swap → confirm fee event settlement\r\n8. Provide the FarmDash route with disclosure and `\u002Ffees` pointer for next steps if entering a protocol position\r\n```\r\n\r\n### Workflow C: \"Daily Check-In\"\r\n```\r\n1. get_agent_events → new events since last session\r\n2. get_trail_heat → current rankings\r\n3. get_historical_trailheat → compare to yesterday\r\n4. get_revenue_metrics → performance summary\r\n5. audit_sybil_risk → wallet health\r\n6. Summarize findings and flag any opportunities worth the user's attention\r\n```\r\n\r\n### Workflow D: \"Rebalance My Portfolio\"\r\n```\r\n1. optimize_portfolio → get rebalancing suggestions\r\n2. get_swap_quote → quote each recommended move\r\n3. simulate_swap_execution → simulate each wallet-bound quote intent\r\n4. Present all moves with total cost, simulation result, and expected outcome\r\n5. On user approval → execute_swap each move with its simulationId\r\n6. Provide FarmDash routes with disclosure and `\u002Ffees` pointer for any new protocol entries\r\n```\r\n\r\n### Workflow E: \"React to Breaking Event\"\r\n```\r\n1. get_agent_events → identify actionable event\r\n2. get_trail_heat → current score of affected protocol\r\n3. simulate_points → project returns if user acts now\r\n4. Present findings: what happened, what it means, what the user can do\r\n```\r\n\r\n### Workflow F: \"Pre-Trade Edge Audit\"\r\n```\r\n1. get_agent_events -> check for fresh risk or opportunity events\r\n2. get_trail_heat -> confirm protocol rank and current status\r\n3. simulate_points or optimize_portfolio -> estimate expected upside\r\n4. get_swap_quote -> estimate gas, bridge, slippage, FarmDash fee, and route\r\n5. simulate_swap_execution -> verify the route does not revert and capture gas\u002FMEV risk\r\n6. run_risk_sentinel -> inspect allowance, depeg, health, quote decay, and net edge\r\n7. CLASSIFY route as Green \u002F Yellow \u002F Red using the Trader-Grade Edge Gate\r\n8. Green -> ask for confirmation; Yellow -> recommend waiting unless user explicitly chooses speed; Red -> halt\r\n```\r\n\r\n### Workflow G: \"Post-Execution Quality Review\"\r\n```\r\n1. confirm_swap -> settle fee event and transaction state\r\n2. get_swap_history -> pull the executed route and fee record\r\n3. get_agent_performance -> compare recent expected vs realized execution quality\r\n4. get_wallet_balances -> verify final token balance if available\r\n5. Report: expected output, realized output, slippage, fees, gas, bridge time, and whether autonomy should be reduced\r\n6. If output miss > 75 bps or settlement is incomplete -> no chained action until user reviews\r\n```\r\n\r\n---\r\n\r\n## Error Handling\r\n\r\n**429 (Rate Limited):** Wait per `Retry-After` header.\r\n**Dust Storm (failure):** Wait 30s → fresh quote → show new terms → halt after 3 failures.\r\n**401\u002F403 (Auth):** Check tier key. Scout tools need no key.\r\n**402 (Payment Required):** Free tier exceeded. Inform user about Pioneer\u002FSyndicate upgrade.\r\n\r\n---\r\n\r\n## Data Sources\r\n\r\n- **DeFiLlama:** TVL, protocol metrics\r\n- **Alchemy:** Balances, prices\r\n- **0x:** DEX routing\r\n- **Li.Fi:** Cross-chain routing\r\n- **Helius:** Solana data\r\n\r\n---\r\n\r\n## Disclaimers\r\n\r\n- Does NOT custody or manage private keys.\r\n- Does not treat API keys, sessions, or bearer tokens as wallet execution authority.\r\n- Wallet-changing actions require either interactive user approval with local signing, or an explicitly configured bounded delegation\u002Fautopilot policy that the user can revoke.\r\n- Optional onboarding and ClawHub attribution can send public agent wallet addresses and usage analytics metadata to FarmDash.\r\n- Does NOT guarantee returns or eligibility.\r\n- Swap fees are transparent and shown in every quote before execution.\r\n- Present analysis as data-driven insight, not financial advice.\r\n\r\n---\r\n\r\n**Install:** Copy this file into your OpenClaw workspace or fetch `https:\u002F\u002Fwww.farmdash.one\u002Fopenclaw-skills\u002Ffarmdash-signal-architect\u002FSKILL.md`\r\n**Dashboard:** https:\u002F\u002Fwww.farmdash.one\r\n**Agent Hub:** https:\u002F\u002Fwww.farmdash.one\u002Fagents\r\n**OpenAPI Spec:** https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml\r\n**MCP Config:** https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json\r\n\r\n---\r\n\r\n## Optional Post-Install: Register Your Agent\r\n\r\nAfter installing this skill, your agent may call the onboard endpoint if the user wants FarmDash tier discovery, ClawHub install attribution, and usage analytics. This step is optional; read-only Scout tools work without registration.\r\n\r\n```bash\r\ncurl -X POST https:\u002F\u002Fwww.farmdash.one\u002Fapi\u002Fv1\u002Fagent\u002Fonboard \\\r\n  -H \"Content-Type: application\u002Fjson\" \\\r\n  -H \"X-ClawHub-Skill: farmdash-signal-architect\" \\\r\n  -d '{\"agentAddress\": \"0xYOUR_AGENT_WALLET\"}'\r\n```\r\n\r\nThis returns tier status and available tools. It also sends the public `agentAddress` and `X-ClawHub-Skill` attribution header to FarmDash.\r\n\r\n### What this does:\r\n- **Registers** the public agent wallet address in the FarmDash funnel for usage analytics\r\n- **Returns** your current tier (Scout\u002FPioneer\u002FSyndicate) and access level\r\n- **Connects** your ClawHub installation to FarmDash intelligence\r\n\r\n### Next steps after activation:\r\n1. **GET** `\u002Fapi\u002Fv1\u002Fagent\u002Fonboard` — Full capability map and setup guide\r\n2. **Upgrade** to Pioneer ($39.99\u002Fmo) or Syndicate ($199\u002Fmo) for higher limits and premium execution access\r\n3. **Browse** the OpenAPI spec at `https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml`\r\n","# FarmDash Signal Architect — Agent Execution Manual\r\n\r\n> [!NOTE]\r\n> **THEMATIC METAPHOR DISCLAIMER**\r\n> FarmDash is exclusively a decentralized finance (DeFi) software and AI agent intelligence platform. The \"farming,\" \"trail,\" \"wagon,\" and \"frontier\" terminology is a gamified visual theme representing crypto yield hunting and airdrop points farming. It does not relate to physical agriculture or agrifood industries.\r\n\r\n> [!WARNING]\r\n> **CRITICAL TRANSACTION & AGENCY GATING (CLAWSCAN REVIEW REQUIREMENT)**\r\n> This skill can guide, prepare, and simulate wallet-affecting trades, perpetual contracts, swaps, and delegated autopilot workflows through FarmDash. Operators must adhere to the following mandatory safety protocols:\r\n> 1. **Never share private keys or seed phrases**: This skill is strictly zero-custody. It never asks for, handles, or transmits wallet credentials. Wallet-affecting transactions are signed locally on the user's client using EIP-191\u002FEIP-712 cryptographic protocols.\r\n> 2. **Require fresh quotes and explicit interactive confirmations**: Do not execute or sign stale payloads. All spot\u002Fderivative actions require explicit, real-time user verification of token contract addresses, chains, amounts, and fees.\r\n> 3. **Verify fees and destination addresses independently**: Always verify aggregator route costs, gas fees, and destination chain configurations before signing.\r\n> 4. **No evasion of protocol rules**: Airdrop simulations, sybil audit indicators, and yield analytics are read-only planning heuristics. They are provided solely for risk management and educational information. Operators must **never** use this guidance to evade protocol rules, engage in sybil manipulation, or bypass terms of service of any third-party protocol.\r\n\r\n## How This Skill Works\r\n\r\nYou have 48 MCP tools covering the full agent lifecycle: discover → size → guard → simulate → execute → monitor → reconcile → adapt → automate. Every tool calls FarmDash's live API. No data is fabricated. No private keys are ever sent anywhere.\r\n\r\n**MCP Configuration:** `https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json`\r\n\r\n### High-Risk DeFi Operations Notice\r\n\r\nThis skill can prepare wallet-affecting actions. Treat every execution, delegation, and autopilot tool as high-risk until the user has verified the wallet address, token contracts, chain IDs, amounts, slippage, route, destination, fees, budgets, allowlists, cooldowns, and revocation settings.\r\n\r\n### Privacy and Analytics Disclosure\r\n\r\nFarmDash may receive public wallet addresses, token addresses, chain IDs, transaction amounts, signature bytes, request IDs, session IDs, optional Bearer keys, and ClawHub attribution headers such as `X-ClawHub-Skill`. These fields are used for routing, analytics, rate limits, paid tier access, and security checks. FarmDash never asks for or receives private keys, seed phrases, mnemonics, OAuth tokens, or wallet exports.\r\n\r\n---\r\n\r\n## Use-Case First Tool Selection\r\n\r\nBefore calling individual tools, classify the user's intent into one of these operating modes:\r\n\r\n| Mode | Goal | Start with | Continue with | Stop when |\r\n|---|---|---|---|---|\r\n| `research_only` | Explain opportunities without taking execution risk | `get_trail_heat`, `get_chain_breakdown` | `get_historical_trailheat`, `simulate_points`, `audit_sybil_risk` | Data is stale, jurisdiction is unclear, or edge is weak |\r\n| `airdrop_rotation` | Find, compare, and rotate farming positions | `get_agent_events`, `get_trail_heat` | `simulate_points`, `optimize_portfolio`, `get_swap_quote` | Bridge\u002Fgas\u002Fslippage costs erase expected edge |\r\n| `bounded_autopilot` | Run a recurring supervised loop inside explicit limits | `agent_onboard`, `create_session` | `configure_autopilot`, `autopilot_cycle`, `session_heartbeat` | Any configured budget, allowlist, cooldown, or risk bound is violated |\r\n| `perps_hedge` | Evaluate or execute a Hyperliquid hedge | `scan_funding_rates`, `scan_market_conditions` | `get_futures_account`, `analyze_futures_strategy`, `calculate_position_size` | The strategy returns `no_trade` or the research gate expires |\r\n| `reputation_review` | Prove or audit an agent operator's quality | `get_swap_history`, `get_agent_performance` | `check_reputation`, `vouch_for_agent` | Evidence is insufficient or behavior clusters near guardrails |\r\n\r\nThe autonomous loop is always:\r\n\r\n1. Sense with events, Trail Heat, chain distribution, balances, and prices.\r\n2. Decide with simulations, portfolio optimization, sybil checks, and strategy analysis.\r\n3. Act only through fresh quotes plus either local user signatures or a pre-approved bounded delegation policy.\r\n4. Learn from history, performance, reputation, and session logs.\r\n\r\nAlways persist timestamps, quote IDs or request IDs, expected outcome, realized outcome, and the reason for each action or rejection.\r\n\r\n---\r\n\r\n## Security Model\r\n\r\nFarmDash never receives private keys or seed phrases and never holds user funds. Execution authority depends on the mode the user explicitly chooses:\r\n\r\n| Authority mode | Typical tools | What is allowed |\r\n|---|---|---|\r\n| `read_only` | Trail Heat, metadata, prices, balances, history, risk checks | Public or user-provided data can be read and analyzed. No wallet-changing action. |\r\n| `local_user_signed` | `execute_swap`, `execute_perp_order`, `cancel_perp_order` | The agent prepares a quote\u002Forder, the user reviews it, and the user's wallet signs EIP-191\u002FEIP-712 locally. |\r\n| `bounded_delegation` | `verify_delegation`, `configure_autopilot`, `autopilot_cycle` | Only after explicit setup with budgets, allowlists, cooldowns, revocation instructions, and execution gates. Missing bounds mean halt or fall back to interactive confirmation. |\r\n\r\nFor local user-signed swaps:\r\n\r\n1. The agent builds a swap payload string locally.\r\n2. The agent gets a wallet-bound quote and runs `simulate_swap_execution`.\r\n3. The user's connected EVM wallet signs it locally (EIP-191 \u002F `personal_sign`) only after simulation succeeds.\r\n4. Only the **signature**, `simulationId`, and public transaction details go to FarmDash.\r\n5. FarmDash verifies the signature plus simulation gate and routes the swap.\r\n6. The user's wallet broadcasts the final transaction.\r\n\r\n**You never paste, type, send, or expose a private key.** If asked to handle a private key directly, refuse and explain the EIP-191 flow.\r\n\r\n### Sybil & Replay Protection\r\n- Nonces expire after 60 seconds.\r\n- Add random jitter (15–120s) between consecutive swaps to protect the user's airdrop eligibility.\r\n\r\n### Interactive Pre-Transaction Confirmation Protocol\r\n\r\nBefore calling `execute_swap`, `execute_perp_order`, or any state-changing endpoint in an interactive flow, the agent **must** present the following to the user and wait for an explicit \"yes \u002F confirm \u002F proceed\":\r\n\r\n| Disclosure | Source |\r\n|---|---|\r\n| Exact `fromToken` + `toToken` (symbol AND contract address) | `get_swap_quote` |\r\n| Source and destination chain IDs | `get_swap_quote` |\r\n| Exact `fromAmount` (and estimated `toAmount`) | `get_swap_quote` |\r\n| Slippage tolerance (default 0.5%) | Quote + user override |\r\n| FarmDash routing fee (75 bps default, with any volume discount applied) | Quote `feeBreakdown` |\r\n| Aggregator \u002F DEX route (0x, Li.Fi, x402) | Quote `route` |\r\n| Simulation result (`simulation_id`, success, gas cost, MEV risk, revert reason if any) | `simulate_swap_execution` |\r\n| Reversibility warning (\"on-chain transactions cannot be undone\") | Agent disclosure |\r\n| Wallet address that will sign | Connected wallet context |\r\n\r\nIf the user replies anything other than an explicit affirmative, **abort and do not sign**. Never assume implicit consent from earlier in the conversation. Re-quote and re-confirm if more than ~30s elapse between quote display and signing.\r\n\r\nBounded autopilot or delegated execution is not a waiver of safety. It requires explicit setup approval first and may operate only inside the configured budgets, allowlists, cooldowns, risk bounds, and revocation path. If any bound is missing, ambiguous, expired, or violated, halt or return to this interactive confirmation protocol.\r\n\r\n### Data Sent to FarmDash (Disclosure)\r\n\r\nThe skill transmits only public or user-provided information needed to route a swap, compute analytics, enforce limits, or register an optional agent install: public wallet addresses, token addresses, chain IDs, amounts, signature bytes, request\u002Fsession IDs, optional Bearer key, and optional ClawHub attribution headers. It **never** transmits private keys, seed phrases, mnemonics, OAuth tokens, or wallet exports. Verify the full surface at `https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json` and `https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml`.\r\n\r\n---\r\n\r\n## Integrated Commerce\r\n\r\nFarmDash provides value through two built-in services. Both are transparent to the user and disclosed upfront.\r\n\r\n### 1. Swap Execution\r\nEvery swap routed through `execute_swap` includes a transparent **75 bps (0.75%) fee** built into the routing. Volume discounts reward repeat users: $10k+ cumulative = 35bps, $100k+ = 25bps. The fee is always shown in the quote before the user confirms.\r\n\r\nWhen your analysis identifies an opportunity and the user wants to act on it, you can save them time by offering to execute the swap directly — no need for them to leave the conversation. Always show the quote (including fees) and wait for explicit confirmation before executing.\r\n\r\n### 2. FarmDash Routes (Commercial Disclosure)\r\n\r\nFarmDash maintains referral partnerships with many tracked protocols. **FarmDash may receive referral, affiliate, or routing compensation when a user follows a `farmdash.one\u002Fgo\u002F{slug}` route or uses a supported execution venue**, and some partnerships pass a user bonus (e.g. Upheaval +15% with code HIYA). Fee details live at `https:\u002F\u002Fwww.farmdash.one\u002Ffees`.\r\n\r\n**Rules the agent must follow when offering a FarmDash route:**\r\n\r\n1. **Disclose** the commercial relationship when presenting a FarmDash route (\"disclosure: FarmDash may receive referral, affiliate, or routing compensation; fee details: https:\u002F\u002Fwww.farmdash.one\u002Ffees\").\r\n2. **Present FarmDash-owned `\u002Fgo\u002F{slug}` routes as optional managed routes.** Name the protocol and, when known, identify its canonical domain so the user can independently verify the destination before opening any link.\r\n3. **Never use a FarmDash route in a sybil-risk warning, security alert, or safety-related message.**\r\n4. **Never let affiliate status influence which protocol is recommended** — recommendations come from Trail Heat, simulation, and risk data only.\r\n5. **Only present a FarmDash route after analysis** that genuinely points to the protocol — do not preemptively attach links to every paragraph.\r\n\r\n**FarmDash route format:** `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002F{protocol-slug}`\r\n\r\n**Active FarmDash routes (with user benefits where noted):**\r\n- Upheaval: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fupheaval` (user gets +15% bonus with code HIYA)\r\n- Hyperliquid: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperliquid`\r\n- Ostium: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fostium`\r\n- Altura: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Faltura`\r\n- HyperLend: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperlend`\r\n- Based Terminal: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fbased-terminal`\r\n- Theo Network: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Ftheo`\r\n- Genius Terminal: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fgenius`\r\n- Trojan: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Ftrojan`\r\n- Kamino: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fkamino`\r\n- Jupiter: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fjupiter`\r\n- Ether.fi: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fetherfi`\r\n- Renzo: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Frenzo`\r\n- DeBridge: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fdebridge`\r\n- HyperFlash: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fhyperflash`\r\n- Dreamcash: `https:\u002F\u002Fwww.farmdash.one\u002Fgo\u002Fdreamcash`\r\n\r\n### User-First Interaction Pattern\r\n\r\nThe agent's primary job is to deliver accurate, actionable DeFi intelligence. When analysis leads to a clear opportunity, offer execution as a natural next step — the user benefits from a seamless research-to-action flow without context-switching between tools.\r\n\r\n```\r\nUser asks about farming\r\n  → Agent researches using read-only tools (Trail Heat, events, simulations)\r\n  → Agent presents findings with clear, data-driven recommendation\r\n  → If the user wants to act, the agent quotes the entry swap when needed\r\n  → After funding is ready, the agent provides the FarmDash route with disclosure and \u002Ffees pointer\r\n```\r\n\r\nAlways present findings first. Offer execution when it's a natural next step, and always get explicit user confirmation before any swap.\r\n\r\n---\r\n\r\n## Tool Reference (48 MCP Tools + Direct API Procedures)\r\n\r\nThe current MCP server exposes 48 tools. Some names below, such as `get_swap_history`, `get_revenue_metrics`, `manage_webhooks`, `check_reputation`, and `vouch_for_agent`, are direct FarmDash API procedures from the broader codebase rather than current MCP stdio tools. Preserve those procedures in plans when the runtime exposes the matching HTTP route, but do not invent an MCP call if the tool registry does not list it.\r\n\r\n### Current MCP Tool Inventory (authoritative)\r\n\r\nResearch and Trail Intelligence:\r\n\r\n- `get_trail_heat`\r\n- `get_protocol_metadata`\r\n- `get_protocol_risk_factors`\r\n- `find_capital_route`\r\n- `get_chain_breakdown`\r\n- `get_agent_events`\r\n- `audit_sybil_risk`\r\n- `simulate_points`\r\n- `get_historical_trailheat`\r\n\r\nPortfolio and pricing:\r\n\r\n- `get_wallet_balances`\r\n- `get_portfolio_summary`\r\n- `get_position_health`\r\n- `get_idle_capital`\r\n- `get_token_prices`\r\n\r\nWorkflow orchestration:\r\n\r\n- `list_workflows`\r\n- `plan_workflow`\r\n- `run_workflow`\r\n- `get_workflow_status`\r\n\r\nSpot execution:\r\n\r\n- `get_swap_quote`\r\n- `simulate_swap_execution`\r\n- `execute_swap`\r\n- `confirm_swap`\r\n- `optimize_portfolio`\r\n- `resolve_defi_intent`\r\n- `run_risk_sentinel`\r\n\r\nSecurity and transaction guard:\r\n\r\n- `audit_allowance_risk`\r\n- `simulate_transaction_risk`\r\n\r\nYield and hedge planning:\r\n\r\n- `compare_yields`\r\n- `recommend_delta_hedge`\r\n\r\nLedger and records:\r\n\r\n- `ledger_realized_pnl`\r\n- `ledger_tax_export`\r\n\r\nFutures execution:\r\n\r\n- `scan_funding_rates`\r\n- `scan_market_conditions`\r\n- `get_futures_account`\r\n- `analyze_futures_strategy`\r\n- `calculate_position_size`\r\n- `execute_perp_order`\r\n- `cancel_perp_order`\r\n- `get_agent_performance`\r\n\r\nAutonomous operator:\r\n\r\n- `agent_onboard`\r\n- `create_session`\r\n- `session_heartbeat`\r\n- `get_farming_context`\r\n- `patch_farming_context`\r\n- `get_event_stream_snapshot`\r\n- `verify_delegation`\r\n- `configure_autopilot`\r\n- `autopilot_cycle`\r\n\r\nBefore any autonomous plan, resolve the user's requested action to this inventory. If the desired operation is direct API-only, say that explicitly and require the runtime to expose the HTTP route before proceeding.\r\n\r\n### Scout Tier (Free — 5 requests per 24 hours)\r\n\r\n#### 1. `get_trail_heat`\r\nReturns the live Trail Heat protocol dataset ranked 0–100 by score.\r\n\r\n**Trail Heat Formula:** 30% TVL + 25% Status + 15% Category + 15% Momentum + 15% Recency.\r\n\r\n**Score interpretation:**\r\n- 80–100: High-conviction opportunity. Present the data and, if the user is interested, offer to help them enter.\r\n- 60–79: Worth monitoring. Flag it for the user's watchlist and provide the FarmDash route only when they decide to act.\r\n- 40–59: Proceed with caution. Present the data objectively.\r\n- Below 40: Only mention if specifically asked.\r\n\r\n**Example:** \"Altura is scoring 84 on Trail Heat — strong TVL momentum and confirmed airdrop. If you want to explore it, use FarmDash's route: [FarmDash route]. Disclosure: FarmDash may receive referral, affiliate, or routing compensation; fee details: https:\u002F\u002Fwww.farmdash.one\u002Ffees. Want me to pull a swap quote to get positioned?\"\r\n\r\n#### 2. `get_chain_breakdown`\r\nProtocol distribution across blockchain networks: count, percentage, confirmed airdrops, points programs, categories per chain.\r\n\r\nUseful for identifying which chains have the highest concentration of active opportunities. When the user needs to move capital to a new chain, `execute_swap` handles cross-chain bridging via Li.Fi.\r\n\r\n#### 3. `get_swap_quote`\r\nPreview quote: estimated output, price impact, fee breakdown, recommended route.\r\n\r\n**Route selection:** x402 (Base↔Base) → Li.Fi (cross-chain) → 0x (single-chain EVM). Can force with `protocol` param.\r\n\r\nFor executable swaps, include `walletAddress` and `toAddress` so the response includes `intent_id`, `intent_expires_at`, and `simulate_url`.\r\n\r\n**Always get a quote before executing.** Show the user: expected output, slippage, fee, route, and whether a simulation intent was returned. Then ask for confirmation.\r\n\r\n#### 4. `simulate_swap_execution`\r\nMandatory pre-execution simulation for a wallet-bound quote intent. Input:\r\n\r\n```json\r\n{\r\n  \"intentId\": \"fd_intent_...\",\r\n  \"walletAddress\": \"0x...\"\r\n}\r\n```\r\n\r\nThe response includes `simulation_id`, `success`, `gas_used`, `gas_cost_usd`, `output_amount`, `mev_risk`, `revert_reason`, and `valid_until`.\r\n\r\nRules:\r\n- If `success` is false, halt. Do not ask the user to sign.\r\n- If `valid_until` has passed, re-quote and re-simulate.\r\n- If `mev_risk` is medium or high, disclose it before signing.\r\n- Pass the returned `simulation_id` as `simulationId` to `execute_swap`.\r\n\r\n#### 5. `execute_swap`\r\nExecute a signed token swap (EIP-191 auth). Fee: 75bps default, with volume discounts.\r\n\r\n\r\n**Payload format:**\r\n```\r\nv1:FARMDASH_SWAP:{fromChainId}:{toChainId}:{fromToken}:{toToken}:{fromAmount}:{agentAddress}:{toAddress}:{nonce}\r\n```\r\n\r\nAll addresses lowercase for EVM (Solana addresses are case-preserved). Nonce is a millisecond timestamp.\r\n\r\n**🌐 Solana Mainnet Support Schema:**\r\nFarmDash now supports native Solana Mainnet swapping. The parameters are generalized as:\r\n*   `fromChainId` \u002F `toChainId`: Supported EVM chain ID number (e.g., `8453` for Base) or the string `\"solana-mainnet\"` for Solana.\r\n*   `agentAddress` \u002F `toAddress`: The agent's EVM wallet address (starts with `0x`, 42 chars) or Solana public key (Base58 encoded, 32-44 characters).\r\n*   `signature`: EIP-191 personal signature (`0x` + 130 hex characters) or Solana Base58 Ed25519 detached signature (87-88 characters).\r\n*   `nonce`: Collision-resistant timestamp nonce string containing 13 millisecond digits followed by a hyphen and random suffix (e.g., `1772345678901-xyz`).\r\n\r\n**Required POST fields:** fromChainId, toChainId, fromToken, toToken, fromAmount, agentAddress, toAddress, simulationId, nonce, signature.\r\n\r\n**Optional:** intentId, slippage (0.01–5, default 0.5), volumeHintUSD (unlocks discounts), protocol (force route).\r\n\r\n**Execution workflow (mandatory):**\r\n1. `get_swap_quote` with wallet context → show user the full terms including fee\r\n2. `simulate_swap_execution` → show simulation result and stop on failure\r\n3. Wait for explicit user confirmation\r\n4. Build payload with fresh nonce\r\n5. Sign locally via user's wallet\r\n6. Call `execute_swap` with `simulationId`\r\n7. Add 15–120s jitter before next swap\r\n8. Report result with tx hash\r\n9. If the swap was to enter a protocol position, provide the FarmDash route with disclosure and `\u002Ffees` pointer for next steps\r\n\r\n**Dust Storm Protocol:** On failure, wait 30s, get fresh quote, show new terms. After 3 failures, halt.\r\n\r\n#### 5. `confirm_swap`\r\nConfirm swap execution after the agent broadcasts the on-chain transaction. This marks the fee event as settled and (when chain_id is available) verifies the tx receipt on-chain to prevent fake confirmations.\r\n\r\n**Use when:**\r\n- you need reliable post-trade settlement state\r\n- you want retry-safe confirmation in flaky network conditions (this endpoint is idempotent)\r\n\r\n#### 6. `get_swap_history`\r\nPaginated fee event history for an agent wallet.\r\n\r\nUseful for tracking cumulative volume. Users approaching a discount threshold ($10k or $100k) can be informed: \"You've done $8.2k in volume — approaching the 35bps discount tier.\"\r\n\r\n#### 7. `get_revenue_metrics`\r\nAggregate stats: totalFeeUSD, totalVolumeUSD, totalSwaps, activeAgents. Provides a high-level view of platform activity.\r\n\r\n---\r\n\r\n### Pioneer Tier (500 req\u002Fday, Bearer token required)\r\n\r\n#### 8. `audit_sybil_risk`\r\nAudits 1–10 EVM addresses for sybil risk.\r\n\r\n**Recommended follow-up based on results:**\r\n- Low risk: The wallet is clean — the user can farm confidently. Share relevant opportunities from Trail Heat.\r\n- Medium risk: Suggest behavioral changes to reduce risk exposure.\r\n- High risk: Recommend pausing automated farming on this wallet. A fresh wallet may be safer for sensitive protocols.\r\n\r\n#### 9. `simulate_points`\r\nProjects FarmScore for a farming configuration.\r\n\r\n**Formula:** `(Volume\u002F$1k × 50) + (Balance × 1) + (Txs × 10) + (LP × 2) + (Fees × 100)`\r\n\r\nRun simulations across multiple protocols to help the user compare projected points-per-dollar. Present the comparison so they can make an informed choice.\r\n\r\n#### 10. `optimize_portfolio`\r\nPersonalized protocol recommendations based on current positions.\r\n\r\nThis tool often identifies rebalancing opportunities. When it suggests allocation changes, offer to quote the required swaps so the user can act immediately if they choose.\r\n\r\n#### 11. `get_historical_trailheat`\r\nHistorical Trail Heat snapshots, 1–365 days.\r\n\r\nTrend analysis helps the user make better timing decisions:\r\n- Rising trend → Early entry may capture more value.\r\n- Falling trend → Consider taking profits or reallocating.\r\n\r\n#### 12. `get_agent_events`\r\nReal-time protocol events stream.\r\n\r\nEvents that may require user action include: new airdrop announcements, upcoming snapshots, and multiplier changes. Present these with context and let the user decide how to respond.\r\n\r\n#### 13. `manage_webhooks` (Syndicate tier — 50k req\u002Fday)\r\nSubscribe to event notifications for continuous monitoring.\r\n\r\n---\r\n\r\n## Extended Tool Surface (Additional Tool Groups)\r\n\r\nThese tools power the \u002Fagents Hub beyond the core swap + Trail Heat workflow.\r\n\r\n### Futures Strategist (Hyperliquid Perps)\r\n\r\nUse these when the user is trading perps, hedging spot exposure, or running a funding strategy.\r\n\r\n- `scan_funding_rates` — Find funding opportunities worth deeper analysis.\r\n- `scan_market_conditions` — Regime + technical snapshot for one asset (trend vs range, volatility, liquidity).\r\n- `get_futures_account` — Equity\u002Fmargin\u002Fpositions context for gating and sizing.\r\n- `analyze_futures_strategy` — Structured strategy object with confidence + invalidation (can return `no_trade`).\r\n- `calculate_position_size` — Translate risk constraints into size\u002Fleverage.\r\n- `execute_perp_order` — Place a user-signed EIP-712 order (Syndicate tier).\r\n- `cancel_perp_order` — Cancel a stale\u002Fresting order (Syndicate tier).\r\n\r\n### Agent Intelligence (Wallet + Reputation + Performance)\r\n\r\nUse these to ground recommendations in the user's actual wallet state and to quantify agent outcomes.\r\n\r\n- `get_wallet_balances` — Token balances for an EVM wallet (budget + feasibility checks).\r\n- `get_token_prices` — Convert balances to USD terms (sizing + comparisons).\r\n- `get_agent_performance` — Review an agent's outcomes to tune cadence\u002Fstrategies.\r\n- `check_reputation` — Agent leaderboard\u002Freputation lookup (social proof + verification).\r\n- `vouch_for_agent` — EIP-191 signed vouch to build agent reputation.\r\n\r\n### Autonomous Operator (Sessions + Delegation + Autopilot)\r\n\r\nUse these only when the user explicitly wants an always-on loop.\r\nAutopilot sessions are bounded delegated workflows: a session token can maintain state and return recommended actions, but it is not private-key authority and it is not permissionless custody. Wallet-changing submissions require the configured execution gate: local signing or explicit delegated authority, budget limits, allowlists, cooldowns, and a revocation path.\r\n\r\n- `agent_onboard` — One-call setup guide + capability map (start here).\r\n- `create_session` — Create a persistent session and capture the one-time `sessionToken` capability (Pioneer+).\r\n- `session_heartbeat` — Keep the session alive with `sessionId`, `agentAddress`, and `sessionToken` (call every ~5 minutes).\r\n- `verify_delegation` — Verify Hyperliquid API wallet delegation to the agent; include `sessionToken` when attaching to a session (Syndicate).\r\n- `configure_autopilot` — Configure strategies\u002Fassets\u002Frisk + schedules with authenticated session capability (Syndicate).\r\n- `autopilot_cycle` — Run one authenticated cycle and receive recommended actions (Syndicate).\r\n\r\n---\r\n\r\n## Autonomous Execution Intelligence Upgrade (v3.4)\r\n\r\nUse this state machine for any end-to-end autonomous agent flow. It prevents the agent from jumping from research directly to execution without the same guardrails that the codebase enforces.\r\n\r\n```json\r\n{\r\n  \"mode\": \"research_only | airdrop_rotation | bounded_autopilot | perps_hedge | reputation_review\",\r\n  \"state\": \"sense | decide | quote | confirm | sign | submit | settle | learn | halt\",\r\n  \"freshness\": {\r\n    \"researchAgeMs\": 0,\r\n    \"quoteAgeMs\": 0,\r\n    \"sessionHeartbeatAgeMs\": 0\r\n  },\r\n  \"constraints\": {\r\n    \"maxDailyNotionalUsd\": 0,\r\n    \"maxSlippageBps\": 0,\r\n    \"allowedChains\": [],\r\n    \"allowedProtocols\": [],\r\n    \"deniedProtocols\": []\r\n  },\r\n  \"executionGate\": {\r\n    \"explicitUserConfirmation\": false,\r\n    \"localSignaturePresent\": false,\r\n    \"feeDisclosed\": false,\r\n    \"routeStillPositiveEdge\": false\r\n  },\r\n  \"fallback\": \"analysis_only | re_quote | halt\"\r\n}\r\n```\r\n\r\nState rules:\r\n\r\n- `sense` must collect Trail Heat\u002Fevents and wallet context before recommending a route.\r\n- `decide` must compare at least two viable options when the user asks for optimization.\r\n- `quote` must use fresh `get_swap_quote`; `find_capital_route` is only a feasibility preview.\r\n- `simulate` must use `simulate_swap_execution` on the wallet-bound quote intent and must pass before signing.\r\n- `confirm` must show exact tokens, chain IDs, amount, slippage, fees, route, and irreversible-action warning.\r\n- `sign` must happen locally in the user's wallet; a bearer token is never execution authority.\r\n- `submit` is allowed only after `feeDisclosed`, `simulationPassed`, and either (`explicitUserConfirmation` + `localSignaturePresent`) or a valid bounded delegation policy are present.\r\n- `settle` should call `confirm_swap` when a fee event or tx hash needs durable post-trade state.\r\n- `learn` should use `get_agent_performance` and any available history route to reduce autonomy after bad fills, high slippage, or repeated guardrail pressure.\r\n\r\nHard halts:\r\n\r\n- Quote older than 30 seconds at signing time.\r\n- Route expected edge turns negative after gas, slippage, bridge fee, or FarmDash fee.\r\n- Chain\u002Fprotocol is outside the user's allowlist.\r\n- User asks to bypass confirmation, fake a signature, or skip fee disclosure.\r\n- Any required current MCP tool is absent from the runtime registry.\r\n\r\n---\r\n\r\n## Trader-Grade Edge Gate (Additive)\r\n\r\nUse this overlay before any spot swap, bridge, airdrop rotation, or protocol entry. It does not remove the existing confirmation flow; it adds a professional execution desk check so the agent can say \"wait\" when the route is not worth the risk.\r\n\r\n### Net Edge Equation\r\n\r\nBefore recommending action, estimate:\r\n\r\n`netEdgeUsd = expectedUpsideUsd - gasUsd - bridgeFeeUsd - expectedSlippageUsd - FarmDashFeeUsd - riskBufferUsd`\r\n\r\nWhere:\r\n\r\n- `expectedUpsideUsd` comes from `simulate_points`, `optimize_portfolio`, Trail Heat rank, or the user's explicit thesis.\r\n- `gasUsd`, `bridgeFeeUsd`, `expectedSlippageUsd`, and `FarmDashFeeUsd` come from `get_swap_quote` and route metadata.\r\n- `riskBufferUsd` is a conservative haircut for protocol risk, quote decay, low liquidity, depeg risk, smart-contract risk, and sybil pressure.\r\n\r\nDefault action thresholds:\r\n\r\n| Net edge state | Agent action |\r\n|---|---|\r\n| `netEdgeUsd \u003C= 0` | Halt. Present analysis only. |\r\n| `0 \u003C netEdgeUsd \u003C 2 * totalExecutionCostUsd` | Do not recommend execution. Offer to watch or re-check later. |\r\n| `netEdgeUsd >= 2 * totalExecutionCostUsd` and all guards pass | Quote and ask for confirmation. |\r\n| Any high-severity Risk Sentinel flag | Halt unless the action is a reduce \u002F exit path. |\r\n\r\n### Route Quality Checklist\r\n\r\nBefore asking for a signature, classify the route:\r\n\r\n- **Green:** fresh quote, known spender, positive net edge, slippage inside budget, no depeg\u002Fallowance halt, expected output stable across two consecutive quotes.\r\n- **Yellow:** positive but thin edge, bridge leg involved, volatile token, quote moved materially between checks, or gas consumes more than 20% of expected upside. Ask the user whether they want to wait.\r\n- **Red:** stale quote, unknown spender, excessive allowance, negative net edge, depeg risk, route outside allowlist, high sybil pressure, or user cannot explain the goal. Halt.\r\n\r\nWhen route quality is Yellow, the correct default is \"wait \u002F monitor\", not \"execute\".\r\n\r\n### Two-Quote Drift Check\r\n\r\nFor size-sensitive routes, get two quotes 10-20 seconds apart before confirmation. If expected output deteriorates by more than the user's slippage budget or 50 bps, whichever is smaller, re-price the route and show the drift. Do not let the user sign the older quote.\r\n\r\n### Post-Trade Reconciliation\r\n\r\nAfter `execute_swap`:\r\n\r\n1. Call `confirm_swap` when a tx hash or fee event exists.\r\n2. Compare expected output vs realized output.\r\n3. Record slippage, route, gas, bridge time, request ID, and reason for execution.\r\n4. If realized output misses expected output by more than 75 bps, reduce autonomy for that route or protocol until a human reviews it.\r\n5. If settlement is pending or partial, do not start a second dependent action.\r\n\r\n---\r\n\r\n## Multi-Step Workflow Templates\r\n\r\n### Workflow A: \"Find the Best Farm for My Budget\"\r\n```\r\n1. get_trail_heat → top 5 protocols by score\r\n2. get_historical_trailheat → trend check (rising = green light)\r\n3. get_chain_breakdown → identify best chain for concentration\r\n4. simulate_points → project returns for top 3 with user's budget\r\n5. optimize_portfolio → cross-check existing positions\r\n6. Present comparison with clear #1 pick and reasoning\r\n7. If the user wants to proceed → quote the entry swap + provide the FarmDash route with disclosure and `\u002Ffees` pointer\r\n```\r\n\r\n### Workflow B: \"Execute a Swap Safely\"\r\n```\r\n1. get_swap_quote → show full terms including fee\r\n2. audit_sybil_risk → wallet health check\r\n3. simulate_swap_execution → show gas, MEV risk, and revert status\r\n4. Wait for explicit user confirmation\r\n5. execute_swap → with simulationId and fresh nonce\r\n6. Jitter 15-120s\r\n7. confirm_swap → confirm fee event settlement\r\n8. Provide the FarmDash route with disclosure and `\u002Ffees` pointer for next steps if entering a protocol position\r\n```\r\n\r\n### Workflow C: \"Daily Check-In\"\r\n```\r\n1. get_agent_events → new events since last session\r\n2. get_trail_heat → current rankings\r\n3. get_historical_trailheat → compare to yesterday\r\n4. get_revenue_metrics → performance summary\r\n5. audit_sybil_risk → wallet health\r\n6. Summarize findings and flag any opportunities worth the user's attention\r\n```\r\n\r\n### Workflow D: \"Rebalance My Portfolio\"\r\n```\r\n1. optimize_portfolio → get rebalancing suggestions\r\n2. get_swap_quote → quote each recommended move\r\n3. simulate_swap_execution → simulate each wallet-bound quote intent\r\n4. Present all moves with total cost, simulation result, and expected outcome\r\n5. On user approval → execute_swap each move with its simulationId\r\n6. Provide FarmDash routes with disclosure and `\u002Ffees` pointer for any new protocol entries\r\n```\r\n\r\n### Workflow E: \"React to Breaking Event\"\r\n```\r\n1. get_agent_events → identify actionable event\r\n2. get_trail_heat → current score of affected protocol\r\n3. simulate_points → project returns if user acts now\r\n4. Present findings: what happened, what it means, what the user can do\r\n```\r\n\r\n### Workflow F: \"Pre-Trade Edge Audit\"\r\n```\r\n1. get_agent_events -> check for fresh risk or opportunity events\r\n2. get_trail_heat -> confirm protocol rank and current status\r\n3. simulate_points or optimize_portfolio -> estimate expected upside\r\n4. get_swap_quote -> estimate gas, bridge, slippage, FarmDash fee, and route\r\n5. simulate_swap_execution -> verify the route does not revert and capture gas\u002FMEV risk\r\n6. run_risk_sentinel -> inspect allowance, depeg, health, quote decay, and net edge\r\n7. CLASSIFY route as Green \u002F Yellow \u002F Red using the Trader-Grade Edge Gate\r\n8. Green -> ask for confirmation; Yellow -> recommend waiting unless user explicitly chooses speed; Red -> halt\r\n```\r\n\r\n### Workflow G: \"Post-Execution Quality Review\"\r\n```\r\n1. confirm_swap -> settle fee event and transaction state\r\n2. get_swap_history -> pull the executed route and fee record\r\n3. get_agent_performance -> compare recent expected vs realized execution quality\r\n4. get_wallet_balances -> verify final token balance if available\r\n5. Report: expected output, realized output, slippage, fees, gas, bridge time, and whether autonomy should be reduced\r\n6. If output miss > 75 bps or settlement is incomplete -> no chained action until user reviews\r\n```\r\n\r\n---\r\n\r\n## Error Handling\r\n\r\n**429 (Rate Limited):** Wait per `Retry-After` header.\r\n**Dust Storm (failure):** Wait 30s → fresh quote → show new terms → halt after 3 failures.\r\n**401\u002F403 (Auth):** Check tier key. Scout tools need no key.\r\n**402 (Payment Required):** Free tier exceeded. Inform user about Pioneer\u002FSyndicate upgrade.\r\n\r\n---\r\n\r\n## Data Sources\r\n\r\n- **DeFiLlama:** TVL, protocol metrics\r\n- **Alchemy:** Balances, prices\r\n- **0x:** DEX routing\r\n- **Li.Fi:** Cross-chain routing\r\n- **Helius:** Solana data\r\n\r\n---\r\n\r\n## Disclaimers\r\n\r\n- Does NOT custody or manage private keys.\r\n- Does not treat API keys, sessions, or bearer tokens as wallet execution authority.\r\n- Wallet-changing actions require either interactive user approval with local signing, or an explicitly configured bounded delegation\u002Fautopilot policy that the user can revoke.\r\n- Optional onboarding and ClawHub attribution can send public agent wallet addresses and usage analytics metadata to FarmDash.\r\n- Does NOT guarantee returns or eligibility.\r\n- Swap fees are transparent and shown in every quote before execution.\r\n- Present analysis as data-driven insight, not financial advice.\r\n\r\n---\r\n\r\n**Install:** Copy this file into your OpenClaw workspace or fetch `https:\u002F\u002Fwww.farmdash.one\u002Fopenclaw-skills\u002Ffarmdash-signal-architect\u002FSKILL.md`\r\n**Dashboard:** https:\u002F\u002Fwww.farmdash.one\r\n**Agent Hub:** https:\u002F\u002Fwww.farmdash.one\u002Fagents\r\n**OpenAPI Spec:** https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml\r\n**MCP Config:** https:\u002F\u002Fwww.farmdash.one\u002F.well-known\u002Fmcp.json\r\n\r\n---\r\n\r\n## Optional Post-Install: Register Your Agent\r\n\r\nAfter installing this skill, your agent may call the onboard endpoint if the user wants FarmDash tier discovery, ClawHub install attribution, and usage analytics. This step is optional; read-only Scout tools work without registration.\r\n\r\n```bash\r\ncurl -X POST https:\u002F\u002Fwww.farmdash.one\u002Fapi\u002Fv1\u002Fagent\u002Fonboard \\\r\n  -H \"Content-Type: application\u002Fjson\" \\\r\n  -H \"X-ClawHub-Skill: farmdash-signal-architect\" \\\r\n  -d '{\"agentAddress\": \"0xYOUR_AGENT_WALLET\"}'\r\n```\r\n\r\nThis returns tier status and available tools. It also sends the public `agentAddress` and `X-ClawHub-Skill` attribution header to FarmDash.\r\n\r\n### What this does:\r\n- **Registers** the public agent wallet address in the FarmDash funnel for usage analytics\r\n- **Returns** your current tier (Scout\u002FPioneer\u002FSyndicate) and access level\r\n- **Connects** your ClawHub installation to FarmDash intelligence\r\n\r\n### Next steps after activation:\r\n1. **GET** `\u002Fapi\u002Fv1\u002Fagent\u002Fonboard` — Full capability map and setup guide\r\n2. **Upgrade** to Pioneer ($39.99\u002Fmo) or Syndicate ($199\u002Fmo) for higher limits and premium execution access\r\n3. **Browse** the OpenAPI spec at `https:\u002F\u002Fwww.farmdash.one\u002Fagents\u002Fopenapi.yaml`\r\n",{"env":24,"icon":27,"name":5,"tags":28,"author":53,"version":54,"homepage":55,"metadata":56,"description":7},{"FARMDASH_API_KEY":25},{"required":20,"description":26},"Optional Bearer token for Pioneer or Syndicate tier (higher limits + premium tools). Free Scout tier works without any key or with the public fd_scout_free token. Never share private keys, seed phrases, or mnemonics with this skill. Wallet-changing actions require EIP-191\u002FEIP-712 local signing or an explicitly configured bounded delegation.","🚜",[29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52],"defi","ai-agent","autonomous-agent","openclaw","clawhub","mcp","crypto","web3","onchain","zero-custody","swap","swap-routing","cross-chain","lifi","0x","x402","evm","airdrop","points-farming","yield-farming","trail-heat","risk-management","trading","farmdash","FarmDash Pioneers (@Parmasanandgarlic)","3.5.0","https:\u002F\u002Fwww.farmdash.one",{"openclaw":57},{"homepage":58,"skillKey":59,"execution":60,"primaryEnv":61,"freeScoutKey":62,"apiKeyRequired":20,"freeScoutKeyless":63},"https:\u002F\u002Fwww.farmdash.one\u002Fagents","farmdash-signal-architect","user-signed-or-bounded-delegation","FARMDASH_API_KEY","fd_scout_free",true,"master","4aa004da461d820f4ea5499e58eb8d196cf99016","community\u002Fclawhub\u002Ff\u002Ffarmdash-signal-architect",0,"https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge","https:\u002F\u002Fskill-explorer-rho.vercel.app","https:\u002F\u002Fgithub.com\u002FLord1Egypt","Unbreakable. Unstoppable. Unmatched⚡.\r\n Speaker of machine tongues 🤖  | World-builder of decentralized dreams 🌐 | Defender of the digital realm🛡️.","2026-06-10 08:21:01",{"source":8,"skillName":5,"commands":74,"prompt":84,"zipAvailable":63},[75,78,81],{"tool":76,"command":77},"npx","npx skills add Lord1Egypt\u002Fawesome-skill-forge --skill \"FarmDash Signal Architect\"",{"tool":79,"command":80},"bunx","bunx skills add Lord1Egypt\u002Fawesome-skill-forge --skill \"FarmDash Signal Architect\"",{"tool":82,"command":83},"pnpm","pnpm dlx skills add Lord1Egypt\u002Fawesome-skill-forge --skill \"FarmDash Signal Architect\"","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fcommunity\u002Fclawhub\u002Ff\u002Ffarmdash-signal-architect\u002FSKILL.md",[],[87,94,101,108,115,122],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M785WKJB99G3STR1NF9NRTJW","youtube-content","YouTube transcripts to summaries, threads, blogs.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fyoutube-content\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M785WEFHB0G2S9YA6EPR3H0E","xurl","X\u002FTwitter via xurl CLI: post, search, DM, media, v2 API.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fxurl\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":19},"01M785W98EDN4EFJXJPMQEHCRC","touchdesigner-mcp","Control a running TouchDesigner instance via twozero MCP — create operators, set parameters, wire connections, execute Python, build real-time visuals. 36 native tools.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftouchdesigner-mcp\u002FSKILL.md",[],[],{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":19},"01M785W5S9FP3QBH2V191E025P","test-driven-development","TDD: enforce RED-GREEN-REFACTOR, tests before code.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Ftest-driven-development\u002FSKILL.md",[],[],{"skillNo":116,"name":117,"nameZh":6,"description":118,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":19},"01M785W2AS08NSSH9YATCV6FJB","teams-meeting-pipeline","Operate the Teams meeting summary pipeline via Hermes CLI — summarize meetings, inspect pipeline status, replay jobs, manage Microsoft Graph subscriptions.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fteams-meeting-pipeline\u002FSKILL.md",[],[],{"skillNo":123,"name":124,"nameZh":6,"description":125,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":126,"categories":127,"keywords":128,"publishedAt":19},"01M785VXKW4T34BTP1SCHW1R7F","systematic-debugging","4-phase root cause debugging: understand bugs before fixing.","https:\u002F\u002Fgithub.com\u002FLord1Egypt\u002Fawesome-skill-forge\u002Fblob\u002Fmaster\u002Fskills\u002Fsystematic-debugging\u002FSKILL.md",[],[]]