# AI Agent Execution Flow

### 1. Execution Loop (Bot Logic)

The AI Execution Agent is a continuously running autonomous bot that interfaces with the Sui blockchain and AMM protocols (like Cetus) to manage liquidity in accordance with the strategy agent’s directives.

#### Get Market Data

Polls Cetus or other integrated AMMs for real-time data. Get current price (P\_c), volume, TVL,  fee yield, liquidity distribution across ticks, recent trade history, and gas prices

#### Check Rebalancing Conditions

Assess whether the current state satisfies rebalancing triggers:

* P\_c nearing or crossing range boundaries (P\_min, P\_max)
* δ\_trigger exceeded
* σ\_market > σ\_threshold
* Time since last rebalance > T\_hold\_min
* Gas-profit ratio met (Expected Fees / Gas Cost > C\_gas\_profit\_ratio)

#### Remove/Add Liquidity

If rebalance is required, withdraw current position via removeLiquidity(), recalculate the optimal price range using updated P\_c and volatility. Add new liquidity via addLiquidity() with recalibrated bounds

#### Perform Swaps

If required to match the target asset ratio for a new range, execute an internal swap (e.g., from SUI to USDC) to match the rebalance target. Use an AMM-integrated router with slippage control

#### Update Vault State

Call smart contract methods to register a new LP position ID, log rebalance metadata, update vault metrics (APR, conversion rate), and notify the cooldown system if withdrawal obligations are pending

### 2. Rebalancing Logic

#### Trigger Conditions

Rebalance is initiated if any of the following are true:

* P\_c is within δ\_trigger of the range boundary
* Market volatility exceeds σ\_threshold
* Time since last rebalance exceeds T\_hold\_min
* Profit/gas ratio exceeds the configured threshold

#### Liquidity Withdrawal

Withdraws all liquidity from the current range before redeployment. Uses removeLiquidity() via AMM. Withdrawn assets are evaluated for swap balancing

#### Asset Rebalancing via Internal Swap

If asset composition is not aligned with the new range (e.g., too much SUI vs USDC), perform an internal swap on the AMM while optimizing for minimal slippage. If close to the target, tolerate a minor imbalance to avoid excessive fees

#### Gas Cost Estimator

Before finalizing rebalance action, estimate transaction gas cost, and predict fee earnings from the new position over a forecast window (e.g., 1h). Abort rebalance if gas-profit ratio falls below C\_gas\_profit\_ratio

### 3. Fail-Safes & Pauses

#### Event Window Pause Logic

Monitors calendar-based oracles for scheduled events (e.g., macro announcements). Pauses execution in designated EventWindow\_pre/post, and withdraws liquidity if currently deployed to minimize exposure

#### Latency Handling

Uses low-latency RPC infrastructure to minimize confirmation lag, which detects stale quotes and retries with updated state if transactions are delayed. Future upgrades may include predictive rebalancing buffers

#### Slippage Prevention

Applies max slippage thresholds to all swaps. If slippage exceeds the limit, the swap is aborted, and the agent reverts to its prior state. This maintains internal buffers to cover small discrepancies without needing swaps