Docs

The AI Vault

Let AI Optimize Your Yield

The AI Vault is LiquidClaw's breakthrough feature: a smart contract where you deposit your veLCLAW NFT and an AI agent votes on your behalf every epoch, optimizing for maximum yield. You keep full custody. The AI can only vote — never transfer, sell, or merge your NFT.

Why Use the AI Vault?

Voting optimally on a ve(3,3) protocol is complex. Every epoch, you need to:

  • Analyze trading volumes across all pools
  • Compare bribe offers and calculate bribe-per-vote ratios
  • Factor in fee projections and APR estimates
  • Rebalance your vote allocation to maximize total returns
  • Claim rewards before the epoch resets

The AI Vault solves this. A specialized AI agent does the analysis continuously, voting with surgical precision to maximize your fee + bribe income.

How It Works

Depositing

  1. Go to the AI Vault page
  2. Select the veLCLAW NFT you want to deposit
  3. Click Deposit and approve the transfer
  4. Done — the AI starts managing your votes from the next epoch

What Happens Each Epoch

  1. The AI operator analyzes all pool data: volumes, fees, bribe offers, liquidity depth
  2. It calculates the optimal vote allocation across all pools
  3. It calls voteBatch() on the AIVault contract, voting with all deposited NFTs
  4. Rewards (fees + bribes) flow directly to your wallet — not to the vault, not to the operator

Withdrawing

  • Standard withdraw: Call withdraw() — your NFT returns to your wallet
  • Emergency withdraw: Call emergencyWithdraw() — works even if the vault is paused. Always available, no exceptions.

Security Guarantees

Trust, but verify — and always have an exit.
The AI Vault is designed with security as the top priority.
Security FeatureWhat It Means
Non-custodialYou can withdraw your NFT at any time. The vault never "owns" it.
Vote-only permissionsThe AI operator can only vote. It cannot transfer, sell, merge, or split your NFT.
Emergency withdrawWorks even when the vault is paused. Always available.
48-hour operator timelockIf the AI operator is changed, there's a 48-hour waiting period. No instant takeovers.
PausabilityThe vault owner can pause deposits and normal operations, but emergency withdraw always works.
Transparent rewardsAll reward claims are on-chain. You can verify every transaction.

AI Strategies

LiquidClaw features an AIStrategyRegistry — a marketplace of competing AI voting strategies:

StrategyApproachRisk Profile
Yield MaximizerOptimizes across all pools for maximum combined fee + bribe revenueBalanced
Liquidity DeepenerConcentrates votes on core LCLAW pairs to strengthen the ecosystemConservative
Bribe HunterTargets the highest bribe-per-vote ratio pools aggressivelyAggressive

For AI Agent Builders

Want to build a voting strategy? The AIStrategyRegistry is open:

registerStrategy(name, description, operatorAddress) → strategyId

Your agent needs to:

  1. Register as a strategy in the AIStrategyRegistry
  2. Be appointed as an operator on an AIVault instance
  3. Each epoch: analyze pool data → calculate optimal allocation → call voteBatch()
  4. Trigger reward claims for depositors (claimBribes() + claimFees())

Frequently Asked Questions

Can the AI steal my veLCLAW?
No. The operator can only call vote-related functions. Transfer, merge, split — all blocked at the smart contract level.

What if the AI makes bad votes?
Your worst-case scenario is lower-than-optimal yield for one epoch. You can withdraw anytime and vote manually.

What if the operator gets hacked?
The 48-hour timelock on operator changes means you have two full days to withdraw before any new operator takes control.

Do I still earn rebases?
Yes. Rebase rewards (anti-dilution) are forwarded to your wallet just like fees and bribes.

Can I see what the AI is voting for?
Everything is on-chain. You can check the voting allocation at any time through the contract or the UI.