yieldvault-agent

What This Skill Does

The yieldvault-agent is a specialized autonomous agent designed for the BNB Chain, facilitating sophisticated yield farming operations through deterministic logic and automated smart contract interactions. Unlike manual approaches, this agent continuously monitors on-chain vault data to perform time-sensitive actions like deposits, withdrawals, harvesting, compounding, and rebalancing. By employing a rigorous decision engine, it calculates net APR by factoring in current rewards, platform fees, and a dynamic risk-penalty system. This ensures that capital is consistently deployed into the most profitable and compliant vaults, effectively removing emotional decision-making from decentralized finance (DeFi) operations. The agent includes built-in Telegram integration, allowing for real-time tracking of execution cycles, significant APR changes, and potential error reporting, providing users with peace of mind through a transparent, auditable trail of every transaction via SHA256 hashing.

Installation

To integrate the yieldvault-agent into your environment, utilize the ClawHub CLI. Ensure your environment is prepared by installing the necessary dependencies within your local directory.

clawhub install yieldvault-agent
cp config.deployed.json .env.local

After installation, configure your specific contract addresses, RPC endpoints, and private key environment variables. Perform a dry run using the provided integration tests before deploying to the mainnet.

Use Cases

This skill is ideal for:

• DeFi yield farmers looking to automate complex cross-vault rebalancing strategies.
• Users who require a deterministic, auditable record of all farming activities for compliance.
• Developers building autonomous treasury management systems that prioritize risk-adjusted returns.
• Crypto enthusiasts seeking 24/7 monitoring of yield protocols without the burden of manual transaction signing.

Example Prompts

• "YieldVault, start a new execution cycle and report the current net APR for the top 3 vaults.
• "Agent, what is the status of my current farming position and have any rebalancing actions occurred today?"
• "Set my risk threshold to 0.4 and initiate a compound harvest for all vaults with pending rewards exceeding $25."

Tips & Limitations

• Security: Never store private keys in plaintext files. Use environment variables or hardware security modules.
• Risk Awareness: The agent filters for a risk score ≤ 0.5; however, DeFi remains inherently risky. Always monitor the agent's performance during the first few cycles.
• Gas Costs: Ensure your wallet is funded with sufficient BNB to cover transactional gas fees for harvesting and rebalancing.
• Configuration: Fine-tune your harvest_threshold_usd and rebalance_apr_delta in config.scheduler.json to optimize gas consumption versus yield capture.