{
  "schemaVersion": "1.0",
  "item": {
    "slug": "yieldvault-agent",
    "name": "YieldVault Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/alannetwork/yieldvault-agent",
    "canonicalUrl": "https://clawhub.ai/alannetwork/yieldvault-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/yieldvault-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yieldvault-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "COMPLETION_REPORT.md",
      "EXAMPLES.md",
      "FILES_MANIFEST.md",
      "FINAL_CHECKLIST.md",
      "FINAL_SUMMARY.md",
      "INTEGRATION_GUIDE.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/yieldvault-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/yieldvault-agent",
    "agentPageUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "YieldVault Agent",
        "body": "Autonomous yield farming agent for BNB Chain with deterministic execution, smart contract integration, and automated decision-making."
      },
      {
        "title": "Features",
        "body": "Deterministic Decision Engine - Same input always produces same output (auditable)\nSmart Contract Integration - Interact with YieldVault contracts on BNB testnet/mainnet\nAutonomous Scheduler - Run farming decisions hourly without manual intervention\nTransaction Executor - Automatic DEPOSIT, WITHDRAW, HARVEST, COMPOUND, REBALANCE actions\nTelegram Alerts - Real-time notifications for executions, APR changes, and errors\nRisk Management - Conservative risk filtering (only vaults with risk_score ≤ 0.5)\nYield Optimization - Net APR calculation (apr - fees - risk_penalty)"
      },
      {
        "title": "Installation",
        "body": "clawhub install yieldvault-agent"
      },
      {
        "title": "1. Configure",
        "body": "cp config.deployed.json .env.local\n# Edit with your contract addresses and RPC endpoint"
      },
      {
        "title": "2. Deploy Contracts (if needed)",
        "body": "cd contracts\nnpm install\nnpm run deploy:testnet"
      },
      {
        "title": "3. Run Tests",
        "body": "npm test                    # Unit tests\nnode test.live.mock.js      # Integration tests (offline)\nnode test.live.js           # Live testnet tests"
      },
      {
        "title": "4. Start Scheduler",
        "body": "node scheduler.js\n# Runs decision cycle every hour against testnet"
      },
      {
        "title": "5. Monitor Alerts",
        "body": "Telegram notifications sent automatically for:\n\nExecution started (vault_id, action, amount)\nAPR changes (>1% delta)\nErrors (with severity level)\nCycle completion (stats summary)"
      },
      {
        "title": "Architecture",
        "body": "Smart Contracts (BNB Testnet/Mainnet)\n    ↓\nBlockchainReader (live vault data)\n    ↓\nYieldFarmingAgent (deterministic decisions)\n    ↓\nTransactionExecutor (sign & broadcast)\n    ↓\nScheduler (hourly automation)\n    ↓\nNotifications (Telegram alerts)"
      },
      {
        "title": "Configuration",
        "body": "Edit config.scheduler.json:\n\n{\n  \"chainId\": 97,\n  \"interval_minutes\": 60,\n  \"harvest_threshold_usd\": 25,\n  \"rebalance_apr_delta\": 0.02,\n  \"max_allocation_percent\": 0.35,\n  \"risk_score_threshold\": 0.5\n}"
      },
      {
        "title": "Decision Logic",
        "body": "Read current vault state (APR, TVL, user balance)\n\n\nCalculate Net APR = apr - fees - (risk_score × 0.10)\n\n\nFilter vaults with risk_score ≤ 0.5\n\n\nSelect vault with highest Net APR\n\n\nDecide action:\n\nHARVEST if pending_rewards ≥ $25 USD\nCOMPOUND if net_apr ≥ 2% delta\nREBALANCE if another vault beats current by ≥ 2%\nNOOP if already optimized\n\n\n\nExecute transaction (with retry logic)\n\n\nLog execution record (SHA256 auditable)"
      },
      {
        "title": "Supported Networks",
        "body": "Testnet: BNB Chain Testnet (chainId: 97)\nMainnet: BNB Chain Mainnet (chainId: 56)"
      },
      {
        "title": "Security",
        "body": "✅ Deterministic execution (reproducible, auditable)\n✅ SHA256 audit trail for every decision\n✅ Risk filtering (conservative)\n✅ Constraint enforcement (max 35% per vault)\n✅ Retry logic with exponential backoff\n✅ No hardcoded private keys (use environment variables)"
      },
      {
        "title": "Production Readiness",
        "body": "For mainnet deployment, add:\n\nChainlink Oracle - Live APR feeds\nHardware Wallet Support - Ledger/Trezor signing\nSmart Contract Audit - Professional security review\nEmergency Pause - Multi-sig pause mechanism\n\nSee FINAL_CHECKLIST.md for complete production requirements."
      },
      {
        "title": "Documentation",
        "body": "README.md - Full user guide\nSKILL.md - This file\nFINAL_CHECKLIST.md - Production requirements\nINTEGRATION_GUIDE.md - Smart contract integration\nEXAMPLES.md - Usage examples\nRESPUESTAS_PREGUNTAS.md - FAQ & architecture"
      },
      {
        "title": "Support",
        "body": "Issues & PRs welcome: https://github.com/open-web-academy/yieldvault-agent-bnb"
      },
      {
        "title": "License",
        "body": "MIT"
      }
    ],
    "body": "YieldVault Agent\n\nAutonomous yield farming agent for BNB Chain with deterministic execution, smart contract integration, and automated decision-making.\n\nFeatures\nDeterministic Decision Engine - Same input always produces same output (auditable)\nSmart Contract Integration - Interact with YieldVault contracts on BNB testnet/mainnet\nAutonomous Scheduler - Run farming decisions hourly without manual intervention\nTransaction Executor - Automatic DEPOSIT, WITHDRAW, HARVEST, COMPOUND, REBALANCE actions\nTelegram Alerts - Real-time notifications for executions, APR changes, and errors\nRisk Management - Conservative risk filtering (only vaults with risk_score ≤ 0.5)\nYield Optimization - Net APR calculation (apr - fees - risk_penalty)\nInstallation\nclawhub install yieldvault-agent\n\nQuick Start\n1. Configure\ncp config.deployed.json .env.local\n# Edit with your contract addresses and RPC endpoint\n\n2. Deploy Contracts (if needed)\ncd contracts\nnpm install\nnpm run deploy:testnet\n\n3. Run Tests\nnpm test                    # Unit tests\nnode test.live.mock.js      # Integration tests (offline)\nnode test.live.js           # Live testnet tests\n\n4. Start Scheduler\nnode scheduler.js\n# Runs decision cycle every hour against testnet\n\n5. Monitor Alerts\n\nTelegram notifications sent automatically for:\n\nExecution started (vault_id, action, amount)\nAPR changes (>1% delta)\nErrors (with severity level)\nCycle completion (stats summary)\nArchitecture\nSmart Contracts (BNB Testnet/Mainnet)\n    ↓\nBlockchainReader (live vault data)\n    ↓\nYieldFarmingAgent (deterministic decisions)\n    ↓\nTransactionExecutor (sign & broadcast)\n    ↓\nScheduler (hourly automation)\n    ↓\nNotifications (Telegram alerts)\n\nConfiguration\n\nEdit config.scheduler.json:\n\n{\n  \"chainId\": 97,\n  \"interval_minutes\": 60,\n  \"harvest_threshold_usd\": 25,\n  \"rebalance_apr_delta\": 0.02,\n  \"max_allocation_percent\": 0.35,\n  \"risk_score_threshold\": 0.5\n}\n\nDecision Logic\n\nRead current vault state (APR, TVL, user balance)\n\nCalculate Net APR = apr - fees - (risk_score × 0.10)\n\nFilter vaults with risk_score ≤ 0.5\n\nSelect vault with highest Net APR\n\nDecide action:\n\nHARVEST if pending_rewards ≥ $25 USD\nCOMPOUND if net_apr ≥ 2% delta\nREBALANCE if another vault beats current by ≥ 2%\nNOOP if already optimized\n\nExecute transaction (with retry logic)\n\nLog execution record (SHA256 auditable)\n\nSupported Networks\nTestnet: BNB Chain Testnet (chainId: 97)\nMainnet: BNB Chain Mainnet (chainId: 56)\nSecurity\n✅ Deterministic execution (reproducible, auditable)\n✅ SHA256 audit trail for every decision\n✅ Risk filtering (conservative)\n✅ Constraint enforcement (max 35% per vault)\n✅ Retry logic with exponential backoff\n✅ No hardcoded private keys (use environment variables)\nProduction Readiness\n\nFor mainnet deployment, add:\n\nChainlink Oracle - Live APR feeds\nHardware Wallet Support - Ledger/Trezor signing\nSmart Contract Audit - Professional security review\nEmergency Pause - Multi-sig pause mechanism\n\nSee FINAL_CHECKLIST.md for complete production requirements.\n\nDocumentation\nREADME.md - Full user guide\nSKILL.md - This file\nFINAL_CHECKLIST.md - Production requirements\nINTEGRATION_GUIDE.md - Smart contract integration\nEXAMPLES.md - Usage examples\nRESPUESTAS_PREGUNTAS.md - FAQ & architecture\nSupport\n\nIssues & PRs welcome: https://github.com/open-web-academy/yieldvault-agent-bnb\n\nLicense\n\nMIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/alannetwork/yieldvault-agent",
    "publisherUrl": "https://clawhub.ai/alannetwork/yieldvault-agent",
    "owner": "alannetwork",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/yieldvault-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/yieldvault-agent",
    "agentUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yieldvault-agent/agent.md"
  }
}