Autonomous yield farming agent for BNB Chain with deterministic execution, smart contract integration, and automated decision-making.
Autonomous yield farming agent for BNB Chain with deterministic execution, smart contract integration, and automated decision-making.
clawhub install yieldvault-agent
cp config.deployed.json .env.local
# Edit with your contract addresses and RPC endpoint
cd contracts
npm install
npm run deploy:testnet
npm test # Unit tests
node test.live.mock.js # Integration tests (offline)
node test.live.js # Live testnet tests
node scheduler.js
# Runs decision cycle every hour against testnet
Telegram notifications sent automatically for:
Smart Contracts (BNB Testnet/Mainnet)
↓
BlockchainReader (live vault data)
↓
YieldFarmingAgent (deterministic decisions)
↓
TransactionExecutor (sign & broadcast)
↓
Scheduler (hourly automation)
↓
Notifications (Telegram alerts)
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
}
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:
Execute transaction (with retry logic)
Log execution record (SHA256 auditable)
For mainnet deployment, add:
See FINAL_CHECKLIST.md for complete production requirements.
README.md - Full user guideSKILL.md - This fileFINAL_CHECKLIST.md - Production requirementsINTEGRATION_GUIDE.md - Smart contract integrationEXAMPLES.md - Usage examplesRESPUESTAS_PREGUNTAS.md - FAQ & architectureIssues & PRs welcome: https://github.com/open-web-academy/yieldvault-agent-bnb
MIT