Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

Execution Planning

The execution planning system converts optimization results into executable transaction sequences. It handles the complex logic of liquidating existing positions and acquiring new positions on Arbitrum.

Core Operations

OperationPurpose
Main PlanningOrchestrates liquidation and acquisition planning
Position LiquidationCreates swaps to exit current positions
Position AcquisitionCreates swaps and bridges for target positions
Portfolio DeactivationLiquidates entire portfolio to single chain

Liquidation Planning

Position Analysis

The system compares current allocations against optimization targets to identify positions requiring reduction or complete exit.

For each market position:

  • If current amount exceeds target amount plus tolerance: Create liquidation transaction
  • Liquidation amount equals current amount minus target amount
  • Updates chain balance tracking for subsequent acquisition planning

Creates swap transactions for each liquidation:

  • Token in: PT token address (position being liquidated)
  • Token out: Base token (ETH)
  • Amount: Excess position size
  • Chain: Where the position currently exists

Acquisition Planning

The system implements complex multi-source funding logic:

StepActionLogic
Need AssessmentCalculate required amounttarget_amount - current_amount
Source AllocationIterate through funding mixUse optimizer's funding distribution
Capacity CheckValidate balanceEnsure sufficient funds available
Transaction PlanningOptimal executionPlan efficient swaps on Arbitrum
Swap PlanningMarket entryBase token → PT token acquisition

Transaction Sequencing

For each funding source:

  1. Swap Transaction: Converts base tokens to PT tokens on Arbitrum
  2. Balance Updates: Track remaining balances for subsequent operations

Deactivation Process

Complete Liquidation

The systematic portfolio exit strategy includes:

PhaseOperationsGoal
LiquidationConvert all PT positions to base tokensExit all yield positions
ConsolidationReturn all base tokens to user walletCentralize funds
Final StateAll funds returned as base token on ArbitrumPortfolio fully liquid