[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/create; authority: /api/v1/agent/status] Plan: create a durable FarmDashIntent. This records what an agent wants to do; it never prepares, signs, broadcasts, or executes.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/policy-check; authority: /api/v1/agent/status] Readiness probe for the generic intent policy gate. Public callers cannot provide trusted policy decisions; until the server policy evaluator is configured this returns policy_evaluator_unconfigured. Tool discovery does not grant policy authority.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/simulate; authority: /api/v1/agent/status] Readiness probe for the generic intent simulation gate. Public callers cannot record trusted simulation evidence; until a server verifier is configured this returns simulation_verifier_unconfigured. Tool discovery does not grant simulation authority.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/approval-payload; authority: /api/v1/agent/status] Approve: build the EIP-712 IntentApproval payload that the human approver signs before submit_signed_approval.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/approve; authority: /api/v1/agent/status] Approve: submit a signed EIP-712 human approval or rejection for an intent. This compatibility tool is signed-only for normal callers.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/approve; authority: /api/v1/agent/status] Approve: submit a signed EIP-712 IntentApproval payload produced by request_approval_payload. This does not prepare or execute the intent.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}; authority: /api/v1/agent/status] Approve: inspect whether an intent is still awaiting approval, has been approved, or was rejected.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/prepare; authority: /api/v1/agent/status] Execute: validate adapter support and prepare an intent after policy, simulation, and approval gates pass. This does not broadcast a transaction.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/execute; authority: /api/v1/agent/status] Unavailable for generic public execution: the lifecycle API rejects client-supplied receipts until a trusted adapter and server-side transaction verifier are deployed. Use this only to observe the structured execution_verifier_unconfigured response; raw arbitrary calldata is rejected.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/intents/{intentId}/execute; authority: /api/v1/agent/status] Unavailable for generic public confirmation: FarmDash will not record a caller-supplied receipt. A trusted adapter and server-side transaction verifier must be deployed before this action can be enabled; use get_receipt only for verified receipt observation.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/receipts/{receiptId}; authority: /api/v1/agent/status] Observe: fetch one durable FarmDash receipt by receipt_id.

[Capability: preparation_only; tier: session_bound; API: /api/v1/agent/receipts; authority: /api/v1/agent/status] Observe: list durable FarmDash execution receipts. Filter by intent_id and receipt status to review recent agent activity.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/trail-heat; authority: /api/v1/agent/status] Canonical Trail Heat: fetch DeFiLlama-backed quantitative scores (0-100) with per-number evidence states, components, editorial separation and registry resolution from /v1/trail-heat. Aggregate responses also include live agent recommendations; canonical score leads and only owner-confirmed, non-wallet-bound FarmDash referral routes are eligible for the near-equivalent-quality tiebreaker. Takes no parameters.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/protocols; authority: /api/v1/agent/status] Research: get catalog metadata for a specific DeFi protocol — status, chains, description, tags, and discovery_heuristic_score (catalog editorial heuristic, NOT live Trail Heat; canonical scores via get_trail_heat).

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/protocols; authority: /api/v1/agent/status] Get protocol risk indicators from the catalog: sybil risk label, status, category, chains, and discovery_heuristic_score (editorial heuristic, NOT live Trail Heat). Canonical quantitative scores via get_trail_heat.

[Capability: available_with_tier_gate; tier: scout_quote_signature_and_simulation_gated; API: /api/agents/quote; authority: /api/v1/agent/status] Find the most efficient route between tokens/chains. Considers fees, slippage, and gas. Returns a provider-neutral market estimate (never executable, never attributed) — a wallet alone never triggers provider quoting. For execution, create a firm single-provider quote via the quote-intent API (LI.FI or Relay; 0x remains operator-paused), then simulate before preparing.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/chain-breakdown; authority: /api/v1/agent/status] Get protocol distribution aggregated by blockchain network. Returns counts, airdrops, and category coverage. Takes no parameters.

[Capability: available; tier: pioneer_plus; mock_supported: false; API: /api/v1/agent/events; authority: /api/v1/agent/status] Poll Pioneer+ tenant-bound agent events using the owning authenticated session (sessionId, agentAddress, and sessionToken); no Scout or mock preview. Returns recent event records, not a public real-time stream.

[Capability: available; tier: pioneer_plus; mock_supported: false; API: /api/v1/agent/sybil-audit; authority: /api/v1/agent/status] Research: audit 1-10 EVM addresses for sybil risk. Returns cluster risk score and hygiene suggestions.

[Capability: available; tier: pioneer_plus; mock_supported: false; API: /api/v1/agent/simulate-points; authority: /api/v1/agent/status] Project FarmScore for a hypothetical configuration. Returns estimated points, gas, and speculative USD value.

[Capability: available; tier: pioneer_plus; mock_supported: false; API: /api/v1/agent/historical-trailheat; authority: /api/v1/agent/status] Query historical Trail Heat snapshots, 1-365 days back. Returns score trends and momentum flags.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/balances; authority: /api/v1/agent/status] Get multi-chain token portfolio for an EVM wallet. Returns balances with live USD prices.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/balances; authority: /api/v1/agent/status] Get high-level portfolio metrics: total USD value, chain distribution, and capital efficiency score.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/performance; authority: /api/v1/agent/status] Compatibility alias for agent activity/performance metrics. Current endpoint does not return DeFi position APR, PnL, impermanent loss, or rebalance health.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/balances; authority: /api/v1/agent/status] Locate idle stablecoins or native assets across all supported chains.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/prices; authority: /api/v1/agent/status] Get live USD prices by symbol or by network:address token pairs.

[Capability: available_with_tier_gate; tier: scout_catalog_pioneer_runs; API: /api/v1/agent/workflows; authority: /api/v1/agent/status] Get the JSON catalog of named DeFi workflow recipes. Returns goals, tiers, and step graphs.

[Capability: available_with_tier_gate; tier: scout_catalog_pioneer_runs; API: /api/v1/agent/orchestrator; authority: /api/v1/agent/status] Build a Trail Marshal quality gate for a named workflow. Does not execute steps.

[Capability: available_with_tier_gate; tier: scout_catalog_pioneer_runs; API: /api/v1/agent/orchestrator; authority: /api/v1/agent/status] Create a guarded workflow run record for a session. Execution still requires each owning skill and explicit user confirmation.

[Capability: available_with_tier_gate; tier: scout_catalog_pioneer_runs; API: /api/v1/agent/orchestrator; authority: /api/v1/agent/status] Read the status of a Trail Marshal workflow run.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/continuation; authority: /api/v1/agent/status] Select a server-issued execution continuation as read-only context. Returns canonical next_operation parameters and missing prerequisites; it makes no quote, preparation, admission, debit, signing, or submission call and grants no execution authority. Unknown or expired IDs fail closed.

[Capability: available; tier: scout; API: /api/v1/payments/bootstrap; authority: /api/v1/agent/status] Free, provider-free payment bootstrap terms: how an agent holding only native Base ETH obtains metered access, including native-ETH payment intents, FarmDash prepaid credit, and the single-use execution-bootstrap grant. This tool is read-only. It contacts no swap provider, performs no mutation, and grants no execution authority. Issuing an intent or a grant requires an explicit authenticated POST with a server-issued, purpose-specific signature challenge, which this tool does not perform.

[Capability: available_with_tier_gate; tier: scout_quote_signature_and_simulation_gated; API: /api/v1/agent/quote-intent; authority: /api/v1/agent/status] Research or firm quote: without idempotencyKey, return a provider-neutral market estimate with zero trading-provider calls. With idempotencyKey plus a real wallet/destination and slippage, create or reuse a firm single-provider quote intent and return simulationRequirements.intent_id for simulate_swap_execution. Active selection is LI.FI/Relay; 0x remains blocked while operator-paused.

[Capability: available_with_tier_gate; tier: scout_quote_signature_and_simulation_gated; API: /api/v1/simulate; authority: /api/v1/agent/status] Compatibility: run the legacy mandatory swap simulation. Lifecycle-native agents should use simulate_intent on a FarmDashIntent instead.

[Capability: available_with_tier_gate; tier: scout_quote_signature_and_simulation_gated; API: /api/agents/swap; authority: /api/v1/agent/status] Compatibility route: validate a signed token-swap request after a fresh successful simulation and return transaction calldata. FarmDash does not broadcast the returned transaction. Generic execute_approved_intent remains unavailable.

[Capability: server_verified; tier: session_bound; API: /api/agents/confirm; authority: /api/v1/agent/status] Confirm a compatibility swap only through FarmDash server verification of the owning session, canonical-chain receipt, exact committed fee asset/payer/recipient/amount, and required finality. A caller-supplied tx hash alone is not confirmation.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/optimize-portfolio; authority: /api/v1/agent/status] Get unranked catalog research candidates. Returns WAIT analysis-only: exact pool identity, wallet eligibility, policy, costs and stay-put comparison remain required. Campaign confirmation does not establish safety.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/intent; authority: /api/v1/agent/status] Compatibility: resolve a legacy typed DeFi intent. New state-changing actions should create a durable FarmDashIntent and use the policy/simulation/approval lifecycle.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/risk-sentinel; authority: /api/v1/agent/status] Run FarmDash Risk Sentinel on a route or manual health/net-edge inputs before execution.

[Capability: available_with_tier_gate; tier: scout_preview_pioneer_full; API: /api/v1/agent/futures/scan-funding; authority: /api/v1/agent/status] Scan Hyperliquid perp funding rates across the venue. Takes no parameters.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/futures/market-conditions; authority: /api/v1/agent/status] Technical snapshot (EMA, RSI, MACD, etc.) for one perp asset.

[Capability: available_with_tier_gate; tier: pioneer_plus_or_x402; API: /api/v1/agent/futures/account-state; authority: /api/v1/agent/status] Inspect Hyperliquid equity, margin, positions, and drawdown state. agentAddress identifies the API signer; accountAddress identifies the master/subaccount that owns the equity (omit only for a direct signer). Hyperliquid userRole must verify delegation. Daily/weekly values are conservative venue-derived loss-pressure metrics, not full period returns; history ambiguity fails closed.

[Capability: available_with_tier_gate; tier: pioneer_plus_or_x402; API: /api/v1/agent/futures/analyze-strategy; authority: /api/v1/agent/status] Primary research tool. Returns strategy object with confidence, regime, and simulation. For a delegated Hyperliquid API wallet, set agentAddress to the signer and accountAddress to the master/subaccount whose equity must size the trade; the venue relationship is verified and fails closed.

[Capability: available_with_tier_gate; tier: pioneer_plus_or_x402; API: /api/v1/agent/futures/position-sizing; authority: /api/v1/agent/status] Translate risk constraints into size and leverage for a perp setup.

[Capability: available_with_tier_gate; tier: scout_capacity_signature_gated; API: /api/v1/agent/futures/prepare-order; authority: /api/v1/agent/status] Prepare an exact zero-custody Hyperliquid order for local EIP-712 signing. FarmDash returns the action, typed data, nonce, expiry and intent hash but never signs or submits. New-risk preparation requires a fresh execution-ready analysis; reduce-only preparation remains authority-bound at execution.

[Capability: available_with_tier_gate; tier: scout_capacity_signature_gated; API: /api/v1/agent/futures/execute-order; authority: /api/v1/agent/status] USER_SIGNED requires fresh human approval. BOUNDED_AUTONOMOUS requires a valid owner-signed futures policy, authenticated session, and a local API-wallet signature on every action; rollout remains preparation_only. Compatibility: submit a pre-signed EIP-712 Hyperliquid order after a 60-second parameter-bound research gate. market_ioc is a signed, price-protected IOC limit order with a live 100 bps adverse-price cap, never an unbounded market order; its outcome distinguishes full, partial, and zero fill, and an IOC resting response is unknown/inconsistent. For delegated API wallets, set accountAddress to the venue-verified equity owner used during analysis. FarmDash recovers the exact L1 signer, rejects an agentAddress mismatch, and preflights the owner maxBuilderFee. The signed action must disclose builder f=1 (0.1 bp/0.001% of filled notional), and expiresAt is venue-signed as expiresAfter. Venue nonce authority is network + signer + nonce across account/vault contexts; durable replay control fails closed before submission.

[Capability: available_with_tier_gate; tier: scout_capacity_signature_gated; API: /api/v1/agent/futures/cancel-order; authority: /api/v1/agent/status] USER_SIGNED requires fresh human approval; BOUNDED_AUTONOMOUS requires futures.cancel scope, a valid owner-signed policy and authenticated session, but not unused entry budget. Local venue signatures are required in both modes. Cancel stale or resting Hyperliquid orders with a venue-signed expiresAfter and FarmDash intent hash. For a delegated API wallet, accountAddress identifies the verified equity owner and is included as the signed vault/subaccount routing address when required. accepted is an application acknowledgement, not final venue cancellation: reconcile every requested ID through /api/v1/agent/futures/reconcile-order before dependent actions. Mixed errors are partial rejection; malformed or timeout outcomes are unknown. Venue nonce authority is network + signer + nonce across account/vault contexts; durable replay control fails closed before submission.

[Capability: paid_ready; tier: pioneer_plus_or_x402; API: /api/v1/agent/performance; authority: /api/v1/agent/status] Review FarmDash fee-event activity, fees, protocol diversity, and reputation. This endpoint does not return fills, trade outcomes, realized PnL, win rate, or slippage.

[Capability: available; tier: scout_limited_pioneer_full; API: /api/v1/agent/camp-guard; authority: /api/v1/agent/status] Audit token approvals for unlimited, unknown, or high-dollar allowance risk.

[Capability: available; tier: scout_limited_pioneer_full; API: /api/v1/agent/camp-guard; authority: /api/v1/agent/status] Apply Camp Guard transaction policy checks to an unsigned transaction. This is not an RPC simulation.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/supply; authority: /api/v1/agent/status] Research: compare DeFi yield pools by APY, TVL depth, stablecoin exposure, IL risk, and sustainability score.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/hedge; authority: /api/v1/agent/status] Recommend short-perp hedge notionals for spot farming exposure. Produces a handoff only; it does not execute.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/ledger; authority: /api/v1/agent/status] Summarize recorded spot and futures agent activity over a date range.

[Capability: paid_ready; tier: pioneer_plus; API: /api/v1/agent/ledger; authority: /api/v1/agent/status] Export recorded spot execution records as CSV for downstream accounting review.

[Capability: available; tier: scout; API: /api/v1/agent/status; authority: /api/v1/agent/status] First-run contract: fetch live feature readiness, tier gates, error semantics, execution-mode selection (USER_SIGNED default vs opt-in BOUNDED_AUTONOMOUS), and the onboarding capability map before selecting tools. Before entering any wallet-changing execution workflow, query current execution authority with get_execution_authority for the active persisted FarmDash session: if an active valid bounded delegation already exists for that session, report its policy bounds instead of re-prompting; a different/new agentSessionId does not inherit another session’s grant and remains USER_SIGNED (Standard FarmDash), and you must explicitly obtain user choice/consent before requesting a one-time scoped delegation for BOUNDED_AUTONOMOUS (Autonomous FarmDash, EOA_V1_OWNER_LOCAL_SIGNER where sessionPublicKey == ownerAddress). This never enables execution. Takes no parameters.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/session; authority: /api/v1/agent/status] Create a persistent agent session. Normal callers must include a fresh EIP-712 or EIP-191 session signature. Returns a one-time sessionToken.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/session; authority: /api/v1/agent/status] Keep an agent session alive. Extends expiry by 24h.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/context; authority: /api/v1/agent/status] Read the shared FarmingContext for a live agent session.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/context; authority: /api/v1/agent/status] Patch the shared FarmingContext for a live agent session. Server controls revision, sessionId, and agentAddress.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/stream; authority: /api/v1/agent/status] Observe: read a JSON snapshot from the agent event stream for a live session.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/delegation; authority: /api/v1/agent/status] Verify Hyperliquid API wallet delegation for guarded venue-order workflows. Verification does not bypass live status, research, risk, or signature gates.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Configure autopilot strategies, assets, and risk parameters.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Run one authenticated autopilot cycle. Returns recommended actions.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Pause the backend cycle scheduler for an active agent session. This does not close positions, revoke venue authority, or prove chain-state changes.

[Capability: available_with_tier_gate; tier: pioneer_plus; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Resume the backend cycle scheduler for a paused agent session. Recommendations remain separately gated from transaction execution.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Register a signed, bounded ERC-4337 session-key grant. Registration is not execution; server-side UserOperation submission remains preparation-only.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Revoke any active session key grants for this agent session.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Check the active session key grant and autonomous execution status.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Query execution authority configuration (USER_SIGNED vs BOUNDED_AUTONOMOUS), zero-custody confirmation, and active delegation status.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Request an exact EIP-712 / ERC-8196 bounded delegation payload for user wallet approval. The user signs one scoped delegation so their agent runtime can execute within those bounds.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Register a user-signed bounded delegation grant. The agent runtime gains bounded autonomous execution authority within signed policy limits.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Revoke active bounded execution authority for an owner or agent session.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Prepare an autonomous spot swap within signed delegation bounds from authoritative quote and simulation records. FarmDash verifies 13 policy invariants, locks an atomic budget reservation, and computes the locked calldata digest. The agent signs and broadcasts in its local runtime.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Submit on-chain transaction hash for independent RPC receipt verification and economic reconciliation.

[Capability: available_with_tier_gate; tier: scout_plus; API: /api/v1/agent/authority; authority: /api/v1/agent/status] Release an active autonomous budget reservation if signing or broadcast is aborted before on-chain submission.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Poll the status of an asynchronous autopilot cycle job.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/autopilot; authority: /api/v1/agent/status] Inspect the cycle execution gate. Server-side ERC-4337 action submission is preview-only and returns autonomous_execution_preview_only until real calldata, session signatures, and bundler verification ship.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/mee; authority: /api/v1/agent/status] Create a preparation-only MEE-shaped cross-chain intent bundle. Creation is not authoritative simulation, submission, or settlement.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/mee; authority: /api/v1/agent/status] Preview declared-input cross-chain economics for a MEE-shaped intent. The result is non-authoritative and cannot be submitted while the coordinator gate is disabled.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/mee; authority: /api/v1/agent/status] Capability probe for MEE submission. Currently returns typed feature_not_ready until a production coordinator and authoritative cross-chain receipt verifier are deployed.

[Capability: preparation_only; tier: syndicate; API: /api/v1/agent/mee; authority: /api/v1/agent/status] Read the preparation status of a MEE-shaped intent. Created or simulated state is not proof of submission or settlement.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/protocol-risk; authority: /api/v1/agent/status] Deep risk analysis for a DeFi protocol. Pulls live signals from DeFiLlama (TVL, momentum, chain diversification, historical trends) and combines with Trail Heat scoring to produce a composite risk grade (low/moderate/elevated/high/critical) with actionable signals.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/simulate-yield; authority: /api/v1/agent/status] Read-only independent yield alternatives with exact pool, chain and asset identities. Missing rates/costs remain null; hypothetical yields and rewards never enter observed totals. Returns WAIT analysis-only until wallet, policy, route, freshness and all-in economics are verified.

[Capability: available; tier: scout_preview_pioneer_full; API: /api/v1/agent/trail-heat-query; authority: /api/v1/agent/status] DISCOVERY HEURISTIC query (NOT canonical Trail Heat): filter/sort/paginate the catalog editorial heuristic scores. Scores share the directory and export discovery_snapshot contract (catalog-editorial-v2), with campaign evidence and unknown source freshness. For quantitative DeFiLlama-backed scores use get_trail_heat.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Select a deterministic live-registry ACP V2 committee with one eligible provider per fixed role and three distinct verified controller identities. This selection-only action cannot authorize or spend funds.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Prepare a non-spendable ACP V2 evidence draft. FarmDash revalidates simulation ownership and derives output/gas economics; the caller sends only a local task commitment and disclosure manifest. This tool cannot authorize, create, fund, or settle an ACP job.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Submit an exact V2 EIP-712 signature produced by the customer ACP wallet. FarmDash first verifies deployment readiness and all committed providers; it still cannot create or fund jobs.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Read the authenticated customer ACP tender, immutable commitments, role progress, and settlement state. This read grants no authority.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Cancel an authenticated non-spendable ACP draft. It cannot erase or refund an already-created on-chain job.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Report a customer-created on-chain ACP job ID for one committed role. FarmDash independently verifies the Base client, provider, and evaluator before binding.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Atomically reserve one role budget against the exact customer-signed ACP V2 cap after FarmDash verifies the on-chain job and proposed budget. This accounting action cannot approve tokens or spend the customer wallet.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Durably record canonical Base transaction hashes after the customer wallet submits an existing ACP V2 funding reservation. This action cannot submit a transaction itself.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Request evaluation or resume settlement for a fully bound customer-funded ACP tender. FarmDash can only complete/reject jobs committed to its evaluator identity.

[Capability: available_when_deployment_prerequisites_are_met; tier: x402_or_subscription_with_authenticated_session; API: /api/v1/agent/virtuals-acp; authority: /api/v1/agent/status] Deprecated V1 compatibility tool. It prepares a zero-custody V1 tender only when the deployment explicitly enables V1 creation. Prefer prepare_virtuals_tender_v2. This tool never creates, budgets, funds, or signs an ACP job.