YieldAgentX402

{
  "name": "YieldAgentX402",
  "description": "The governed execution layer for AI agent commerce. The source catalog describes DeFi adapters and multi-chain paths; current support must be established from route discovery, policy, settlement, and receipt evidence. YieldAgent policy and required operator approval authorize governed actions; x402 applies when the selected route advertises it. Terminal orchestrated outcomes produce sealed receipts, with signing, TEE, settlement, and external-proof labels only when matching evidence is present.",
  "url": "https://yieldagentx402.app",
  "version": "1.0.0",
  "status": "source-declared",
  "statusScope": "This discovery document describes source interfaces. It is not deployment, reachability, execution-readiness, settlement, or verification evidence.",
  "provider": {
    "organization": "YieldAgentX402",
    "url": "https://yieldagentx402.app"
  },
  "serviceBase": "https://api.yieldagentx402.app",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": true,
    "multiTurn": true
  },
  "capabilityStatus": {
    "status": "source-declared",
    "checkedAt": null,
    "scope": "A2A protocol capabilities declared by source. Verify the selected route at request time and inspect the resulting receipt before making execution or assurance claims."
  },
  "defaultInputModes": [
    "text",
    "json"
  ],
  "defaultOutputModes": [
    "text",
    "json"
  ],
  "authentication": {
    "schemes": [
      "x402",
      "bearer"
    ],
    "x402Discovery": "https://api.yieldagentx402.app/.well-known/x402",
    "note": "Authentication and x402 requirements are selected-route specific. Inspect the current discovery response or HTTP challenge; a declared scheme does not prove payment, authorization, or solver registration."
  },
  "skills": [
    {
      "id": "yield-optimize",
      "name": "Yield Optimization",
      "description": "Catalog entry for governed yield analysis and planning. A current quote, allocation, or execution requires route discovery, policy and required approval, and matching run evidence.",
      "tags": [
        "defi",
        "yield",
        "apy",
        "optimize",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Optimize my USDC for best yield on Base",
          "output": "{\"protocol\":\"Aerodrome\",\"pool\":\"USDC/USDbC\",\"apy\":15.2,\"action\":\"deposit\"}",
          "illustrative": true
        },
        {
          "input": "Find the best ETH staking yield",
          "output": "{\"protocol\":\"Lido\",\"apy\":3.8,\"risk\":\"low\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "zest-dual-attested",
      "name": "Zest yield context (legacy route id)",
      "description": "Legacy compatibility route for Zest / sBTC context from declared DeFiLlama and DC sources. Returned TEE material, when present, is retrieval-only and unverified (cryptoBound:false); the artifact digest is not TEE proof. Any operational use must start through an installed governed workflow.",
      "tags": [
        "defi",
        "yield",
        "zest",
        "sbtc",
        "btc",
        "x402",
        "attestation"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        {
          "input": "{}",
          "output": "{\"success\":true,\"zestDualAttested\":{\"protocol\":\"zest-protocol\",\"asset\":\"sBTC\",\"sources\":{}}}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "swap-tokens",
      "name": "Token Swap",
      "description": "Catalog entry for governed token-swap quote and plan paths. Venue, rate, execution, and settlement are request- and receipt-specific.",
      "tags": [
        "defi",
        "swap",
        "dex",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Swap 1 ETH for USDC on Base",
          "output": "{\"from\":\"ETH\",\"to\":\"USDC\",\"amount\":\"1\",\"rate\":\"3200\",\"venue\":\"Aerodrome\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "lend-assets",
      "name": "Lend Assets",
      "description": "Catalog entry for lending adapter quote and plan interfaces. It does not assert a current protocol route, supplied position, yield, or settlement.",
      "tags": [
        "defi",
        "lend",
        "supply",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Lend 1000 USDC to Aave on Base",
          "output": "{\"protocol\":\"Aave v3\",\"chain\":\"Base\",\"supplied\":\"1000 USDC\",\"apy\":\"5.2%\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "analyze-risk",
      "name": "Risk Analysis",
      "description": "Evaluate protocol security, TVL, audit posture, and position risk. Produces a structured risk profile for deposits or routes.",
      "tags": [
        "defi",
        "risk",
        "analysis",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Analyze risk of depositing 10 ETH to Aave",
          "output": "{\"protocol\":\"Aave v3\",\"riskScore\":\"low\",\"factors\":[\"audited\",\"high TVL\",\"battle-tested\"],\"recommendation\":\"safe to deposit\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "bridge-assets",
      "name": "Cross-Chain Bridge",
      "description": "Catalog entry for cross-chain bridge quote and plan interfaces. Route availability, transfer, and settlement require request-time and receipt evidence.",
      "tags": [
        "bridge",
        "cross-chain",
        "layerzero",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Bridge 5 ETH from Ethereum to Base",
          "output": "{\"bridge\":\"LayerZero\",\"from\":\"Ethereum\",\"to\":\"Base\",\"amount\":\"5 ETH\",\"fee\":\"0.001 ETH\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "perpetual-trade",
      "name": "Perpetual Trading",
      "description": "Perpetual futures context and routing (e.g. GMX-class venues on supported chains). Analyze funding and size; execution via paid intent paths where available.",
      "tags": [
        "defi",
        "perps",
        "derivatives",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Open 2x long BTC position on GMX",
          "output": "{\"protocol\":\"GMX v2\",\"chain\":\"Arbitrum\",\"position\":\"long\",\"leverage\":\"2x\",\"size\":\"1 BTC\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "portfolio-balance",
      "name": "Portfolio Rebalancing",
      "description": "Catalog entry for governed rebalance planning across eligible adapters. Any swap, lending move, or reinvestment requires policy, required approval, execution, and settlement evidence.",
      "tags": [
        "defi",
        "portfolio",
        "rebalance",
        "x402"
      ],
      "inputModes": [
        "text",
        "json"
      ],
      "outputModes": [
        "json"
      ],
      "examples": [
        {
          "input": "Rebalance my portfolio to 60% stablecoins, 40% ETH",
          "output": "{\"actions\":[{\"action\":\"swap\",\"from\":\"ETH\",\"to\":\"USDC\",\"amount\":\"0.5 ETH\"}],\"newAllocation\":{\"USDC\":\"60%\",\"ETH\":\"40%\"}}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "yield-quote",
      "name": "Yield Quote (structured JSON)",
      "description": "POST /api/adapters/quote \u2014 source-defined APY/TVL adapter route. Inspect the response source, timestamp, and route status before relying on a quote.",
      "tags": [
        "defi",
        "yield",
        "apy",
        "api",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        {
          "input": "{\"adapter\":\"aave\",\"asset\":\"USDC\",\"amount\":\"1000\"}",
          "output": "{\"apy\":2.59,\"tvlUsd\":92572401,\"source\":\"defillama-live\"}",
          "illustrative": true
        },
        {
          "input": "{\"adapter\":\"mantle\",\"chain\":\"mantle\",\"asset\":\"mETH\",\"amount\":\"1\"}",
          "output": "{\"apy\":3.42,\"route\":\"mantle-staked-eth\",\"source\":\"live-or-sim\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "intent-routing",
      "name": "Cross-Chain Intent Routing",
      "description": "Submit governed cross-chain swap/supply/bridge intents for policy and required approval checks. Settlement is established by the resulting receipt and settlement evidence; TEE evidence is optional and path-specific.",
      "tags": [
        "intents",
        "cross-chain",
        "swap",
        "bridge",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "mantle-btcfi-orchestration",
      "name": "Mantle BTCFi Orchestration",
      "description": "Compose BTC \u2192 fBTC \u2192 yield on Mantle (fBTC-mint, PumpBTC-stake, Bedrock-restake, Solv-yield, Omega-farm, Aave-deposit).",
      "tags": [
        "mantle",
        "btcfi",
        "fbtc",
        "restake",
        "tee",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "examples": [
        {
          "input": "{\"fromChain\":\"bitcoin\",\"toChain\":\"mantle\",\"fromToken\":\"BTC\",\"toToken\":\"FBTC\",\"action\":\"fBTC-mint\",\"amount\":\"0.01\"}",
          "output": "{\"route\":\"bedrock-multi\",\"previewApyRange\":\"5-12%\",\"status\":\"routed\"}",
          "illustrative": true
        },
        {
          "input": "{\"chain\":\"mantle\",\"adapter\":\"aave\",\"asset\":\"USDC\",\"action\":\"aave-deposit\",\"amount\":\"1000\"}",
          "output": "{\"route\":\"aave-evm\",\"status\":\"routed\"}",
          "illustrative": true
        }
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "solver-registration",
      "name": "Solver Registration",
      "description": "Catalog entry for the solver-registration interface. Registration, auction eligibility, and any x402 requirement must be established from the selected route response.",
      "tags": [
        "solver",
        "auction",
        "staking",
        "x402"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "tee-attestation",
      "name": "TEE Attestation",
      "description": "Retrieve and evaluate path-specific NEAR AI Cloud attestation fields. A report requires reportVerified, pinMatch, approved measurement, freshness, and signer-identity evidence; it does not generically verify execution.",
      "tags": [
        "tee",
        "attestation",
        "trust",
        "near-ai"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "swap-bridge-inventory",
      "name": "Swap + bridge stack vs codebase",
      "description": "GET /api/integrations/swap-bridge-inventory \u2014 reports source/configuration classifications for swap and bridge routes and gaps; execution readiness requires route-specific evidence.",
      "tags": [
        "defi",
        "swap",
        "bridge",
        "discovery"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    },
    {
      "id": "jingswap-spread-signal",
      "name": "JingSwap Spread Signal",
      "description": "Internal: JingSwapSpreadSignal JSON (spread / peg / DLMM signals).",
      "tags": [
        "defi",
        "signal",
        "stacks",
        "jingswap",
        "internal"
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ],
      "status": "cataloged",
      "scope": "Source-defined discovery metadata, not a runtime-readiness or execution claim."
    }
  ],
  "endpoints": {
    "yieldQuote": "https://api.yieldagentx402.app/api/adapters/quote",
    "yieldPlan": "https://api.yieldagentx402.app/api/adapters/plan",
    "governedExecution": "https://api.yieldagentx402.app/api/orchestration/execute",
    "orchestrationCatalog": "https://api.yieldagentx402.app/api/orchestration/catalog",
    "yields": "https://api.yieldagentx402.app/api/yields",
    "intents": "https://api.yieldagentx402.app/api/intents",
    "swapBridgeInventory": "https://api.yieldagentx402.app/api/integrations/swap-bridge-inventory",
    "solverRegister": "https://api.yieldagentx402.app/api/solvers/register",
    "solvers": "https://api.yieldagentx402.app/api/solvers",
    "teeReport": "https://api.yieldagentx402.app/api/tee/report",
    "teeVerify": "https://api.yieldagentx402.app/api/tee/verify",
    "hubRegistry": "https://api.yieldagentx402.app/api/public/hubs",
    "partnerApply": "https://api.yieldagentx402.app/api/partners/apply",
    "x402Discovery": "https://api.yieldagentx402.app/.well-known/x402",
    "agentCard": "https://api.yieldagentx402.app/.well-known/agent.json"
  },
  "endpointsStatus": {
    "status": "source-declared",
    "checkedAt": null,
    "scope": "Endpoint names and URLs are discovery metadata. Reachability, auth scope, side effects, and readiness must be checked on the exact route at request time."
  },
  "extensions": {
    "x402": {
      "chain": "base",
      "caip2": "eip155:8453",
      "token": "USDC",
      "recipient": "0x97d794dB5F8B6569A7fdeD9DF57648f0b464d4F1",
      "discovery": "https://api.yieldagentx402.app/.well-known/x402",
      "pricing_endpoint": "https://api.yieldagentx402.app/.well-known/x402"
    },
    "tee": {
      "provider": "near-ai",
      "attestation_endpoint": "https://api.yieldagentx402.app/api/tee/report",
      "verify_endpoint": "https://api.yieldagentx402.app/api/tee/verify",
      "note": "Source declares attestation report and verify routes. Reachability is request-time; a TEE label requires fresh report, approved measurement and pin, and signer identity verification for the specific run."
    }
  },
  "provenance": {
    "schema": "yieldagent-provenance-v1",
    "filecoin": {
      "cid": "bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "uri": "ipfs://bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "gatewayUrl": "https://gateway.lighthouse.storage/ipfs/bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "network": "filecoin",
      "provider": "lighthouse"
    },
    "tron": {
      "cid": "bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "uri": "btfs://bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "gatewayUrl": "https://gateway.btfs.io/btfs/bafkreiemqsnky7zpsxvgfm5nu5y6zp2jf7z62bssxkznnxzw37isr3ap64",
      "network": "tron",
      "provider": "btfs"
    },
    "settlementProofs": {
      "description": "A settled intent may report Filecoin and/or Tron proof CIDs when the corresponding upload succeeded and the receipt evidence matches. Missing or unverified CIDs remain missing evidence.",
      "queryPath": "https://api.yieldagentx402.app/api/intents/:id/status",
      "networks": [
        "filecoin",
        "tron"
      ],
      "networksMeaning": "Possible evidence stores, not a promise that both CIDs exist for every settlement"
    }
  },
  "x402": {
    "supported": true,
    "supportMeaning": "x402 metadata is advertised by this card; inspect the current discovery manifest and selected route's HTTP 402 challenge for actual network, asset, and amount support",
    "discovery": "https://api.yieldagentx402.app/.well-known/x402",
    "chains": [
      "eip155:8453",
      "eip155:1",
      "eip155:56",
      "starknet:mainnet",
      "sui:mainnet",
      "tron:mainnet",
      "solana:mainnet",
      "filecoin:mainnet",
      "eip155:314"
    ],
    "chainsMeaning": "Advertised metadata only; listing does not prove current payment verification or settlement readiness on every chain"
  }
}