For Builders & AI Agents

Build on LiquidClaw

LiquidClaw is designed to be composable, permissionless, and agent-friendly. Whether you're building a trading bot, a liquidity management agent, or an entirely new DeFi strategy — our contracts are ready for you.

No API keys. No registration. No rate limits. Just open smart contracts on Base.

Integration Guide by Use Case

Trading Agents

1. Get a quote:       Router.getAmountsOut(amountIn, routes[])
2. Execute the swap:  Router.swapExactTokensForTokens(amountIn, amountOutMin, routes[], to, deadline)

Liquidity Management Agents

1. Preview:    Router.quoteAddLiquidity(tokenA, tokenB, stable, amountA, amountB)
2. Deposit:    Router.addLiquidity(tokenA, tokenB, stable, amountADesired, amountBDesired, ...)
3. Stake:      Gauge.deposit(lpAmount)
4. Monitor:    Pool.getReserves() — watch for rebalancing signals
5. Withdraw:   Router.removeLiquidity(...)

Voting Agents

1. Lock:    VotingEscrow.createLock(amount, lockDuration)
2. Vote:    Voter.vote(tokenId, pools[], weights[])
3. Claim:   Voter.claimBribes() + Voter.claimFees()
4. Reset:   Voter.reset(tokenId)
5. Repeat each epoch for optimal allocation

AI Vault Operators

1. Register:  AIStrategyRegistry.registerStrategy(name, description, operator)
2. Be appointed as operator on an AIVault instance
3. Each epoch:
   a. Analyze all pool volumes, fees, and bribes
   b. Calculate optimal vote allocation
   c. Call AIVault.voteBatch(tokenIds[], pools[], weights[])
   d. Call claimBribes() + claimFees() to distribute rewards

Bribe Agents

1. Deposit bribe tokens to BribeVotingReward contract for your target pool
2. veLCLAW voters see the bribe offer and are incentivized to vote for your pool
3. More votes → more emissions → more LP rewards → deeper liquidity

Technical Specifications

Contract Addresses (Base Sepolia — Live)

Architecture Overview

┌─────────────────────────────────────────────────┐
│              USER / AI AGENT                     │
└──────┬──────────┬──────────┬───────────────────┘
       │          │          │
  ┌────▼───┐ ┌───▼────┐ ┌──▼──────────┐
  │ Router │ │ Voter  │ │  AI Vault   │
  └────┬───┘ └───┬────┘ └──┬──────────┘
       │         │         │
  ┌────▼──────┐ ┌▼────────┐│ ┌──────────────────┐
  │   Pools   │ │ Gauges  ││ │AIStrategyRegistry │
  │(vol/stbl) │ │(rewards)││ └──────────────────┘
  └───────────┘ └────┬────┘│
                ┌────▼────┐│
                │ Minter  │◄┘
                └────┬────┘
                ┌────▼──────────┐
                │VotingEscrow   │
                │(veLCLAW NFTs) │
                └───────────────┘

Best Practices

• Batch where possible. Use voteBatch() instead of individual vote() calls to save gas.
• Check reserves before large operations. Call Pool.getReserves() to understand liquidity depth.
• Set reasonable deadlines. All swap and liquidity functions accept a deadline parameter.
• Monitor epoch boundaries. Voting resets each epoch. Vote early to lock in rewards.
• Leverage ERC-2771. If you want to sponsor gas for your users, the protocol supports meta-transactions out of the box.