# Send YieldVault Agent to your agent
Use the source page and any available docs to guide the install because the item is currently unstable or timing out.
## Fast path
- Open the source page via Review source status.
- If you can obtain the package, extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the source page and extracted files.
## Suggested prompts
### New install

```text
I tried to install a skill package from Yavira, but the item is currently unstable or timing out. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.
```
### Upgrade existing

```text
I tried to upgrade a skill package from Yavira, but the item is currently unstable or timing out. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/yieldvault-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yieldvault-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "COMPLETION_REPORT.md",
      "EXAMPLES.md",
      "FILES_MANIFEST.md",
      "FINAL_CHECKLIST.md",
      "FINAL_SUMMARY.md",
      "INTEGRATION_GUIDE.md"
    ],
    "downloadMode": "manual_only",
    "sourceHealth": {
      "source": "tencent",
      "slug": "yieldvault-agent",
      "status": "unstable",
      "reason": "timeout",
      "recommendedAction": "retry_later",
      "checkedAt": "2026-05-04T14:57:25.016Z",
      "expiresAt": "2026-05-05T02:57:25.016Z",
      "httpStatus": null,
      "finalUrl": null,
      "contentType": null,
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yieldvault-agent",
        "error": "Timed out after 5000ms",
        "slug": "yieldvault-agent"
      },
      "scope": "item",
      "summary": "Item is unstable.",
      "detail": "This item is timing out or returning errors right now. Review the source page and try again later.",
      "primaryActionLabel": "Review source status",
      "primaryActionHref": "https://clawhub.ai/alannetwork/yieldvault-agent"
    },
    "validation": {
      "installChecklist": [
        "Wait for the source to recover or retry later.",
        "Review SKILL.md only after the download returns a real package.",
        "Treat this source as transient until the upstream errors clear."
      ],
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### YieldVault Agent

Autonomous yield farming agent for BNB Chain with deterministic execution, smart contract integration, and automated decision-making.

### Features

Deterministic Decision Engine - Same input always produces same output (auditable)
Smart Contract Integration - Interact with YieldVault contracts on BNB testnet/mainnet
Autonomous Scheduler - Run farming decisions hourly without manual intervention
Transaction Executor - Automatic DEPOSIT, WITHDRAW, HARVEST, COMPOUND, REBALANCE actions
Telegram Alerts - Real-time notifications for executions, APR changes, and errors
Risk Management - Conservative risk filtering (only vaults with risk_score ≤ 0.5)
Yield Optimization - Net APR calculation (apr - fees - risk_penalty)

### Installation

clawhub install yieldvault-agent

### 1. Configure

cp config.deployed.json .env.local
# Edit with your contract addresses and RPC endpoint

### 2. Deploy Contracts (if needed)

cd contracts
npm install
npm run deploy:testnet

### 3. Run Tests

npm test                    # Unit tests
node test.live.mock.js      # Integration tests (offline)
node test.live.js           # Live testnet tests

### 4. Start Scheduler

node scheduler.js
# Runs decision cycle every hour against testnet

### 5. Monitor Alerts

Telegram notifications sent automatically for:

Execution started (vault_id, action, amount)
APR changes (>1% delta)
Errors (with severity level)
Cycle completion (stats summary)

### Architecture

Smart Contracts (BNB Testnet/Mainnet)
    ↓
BlockchainReader (live vault data)
    ↓
YieldFarmingAgent (deterministic decisions)
    ↓
TransactionExecutor (sign & broadcast)
    ↓
Scheduler (hourly automation)
    ↓
Notifications (Telegram alerts)

### Configuration

Edit config.scheduler.json:

{
  "chainId": 97,
  "interval_minutes": 60,
  "harvest_threshold_usd": 25,
  "rebalance_apr_delta": 0.02,
  "max_allocation_percent": 0.35,
  "risk_score_threshold": 0.5
}

### Decision Logic

Read current vault state (APR, TVL, user balance)


Calculate Net APR = apr - fees - (risk_score × 0.10)


Filter vaults with risk_score ≤ 0.5


Select vault with highest Net APR


Decide action:

HARVEST if pending_rewards ≥ $25 USD
COMPOUND if net_apr ≥ 2% delta
REBALANCE if another vault beats current by ≥ 2%
NOOP if already optimized



Execute transaction (with retry logic)


Log execution record (SHA256 auditable)

### Supported Networks

Testnet: BNB Chain Testnet (chainId: 97)
Mainnet: BNB Chain Mainnet (chainId: 56)

### Security

✅ Deterministic execution (reproducible, auditable)
✅ SHA256 audit trail for every decision
✅ Risk filtering (conservative)
✅ Constraint enforcement (max 35% per vault)
✅ Retry logic with exponential backoff
✅ No hardcoded private keys (use environment variables)

### Production Readiness

For mainnet deployment, add:

Chainlink Oracle - Live APR feeds
Hardware Wallet Support - Ledger/Trezor signing
Smart Contract Audit - Professional security review
Emergency Pause - Multi-sig pause mechanism

See FINAL_CHECKLIST.md for complete production requirements.

### Documentation

README.md - Full user guide
SKILL.md - This file
FINAL_CHECKLIST.md - Production requirements
INTEGRATION_GUIDE.md - Smart contract integration
EXAMPLES.md - Usage examples
RESPUESTAS_PREGUNTAS.md - FAQ & architecture

### Support

Issues & PRs welcome: https://github.com/open-web-academy/yieldvault-agent-bnb

### License

MIT
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alannetwork
- Version: 1.0.0
## Source health
- Status: unstable
- Item is unstable.
- This item is timing out or returning errors right now. Review the source page and try again later.
- Health scope: item
- Reason: timeout
- Checked at: 2026-05-04T14:57:25.016Z
- Expires at: 2026-05-05T02:57:25.016Z
- Recommended action: Review source status
## Links
- [Detail page](https://openagent3.xyz/skills/yieldvault-agent)
- [Send to Agent page](https://openagent3.xyz/skills/yieldvault-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/yieldvault-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/yieldvault-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/yieldvault-agent)