clmm-rebalance

/clmm-rebalance

Closes an out-of-range CLMM position and reopens it at a new tick range. Every execution path requires a simulation check AND a typed human confirmation. No bypass flag exists. This is non-negotiable.

Steps

1. Set environment:

   export SOLANA_RPC_URL="https://your-rpc-endpoint"
   export OWNER_ADDRESS="YourWallet111..."
   export KEYPAIR_PATH="$HOME/.config/solana/id.json"
   
   # Safety caps (edit to your risk tolerance)
   export MAX_NOTIONAL_USD=50000
   export MAX_POSITION_USD=100000
   export MAX_SLIPPAGE_BPS=100        # 1%
   export DRY_RUN=true                # set false only when ready to execute
   export REQUIRE_CONFIRM=true        # never set false
   

2. Plan the rebalance (no transaction yet):

   npx tsx -e "
   import { planRebalance } from './skill/templates/rebalance';
   import { fetchPositions } from './skill/templates/adapters/orca';  // or raydium/meteora
   
   const [pos] = await fetchPositions(process.env.OWNER_ADDRESS!);
   // planRebalance(position, newRange) -> RebalancePlan (synchronous; reads no chain)
   const plan = planRebalance(pos, { tickLower: 44500, tickUpper: 45500 });
   console.log(JSON.stringify(plan, (_k, v) => (typeof v === 'bigint' ? v.toString() : v), 2));
   "
   

   Review the plan output (note the confirmPhrase you must type to authorize):

   {
     "venue": "orca",
     "pool": "<whirlpool-address>",
     "from": { "tickLower": 44000, "tickUpper": 45000 },
     "to":   { "tickLower": 44500, "tickUpper": 45500 },
     "steps": [ { "kind": "collectFees" }, { "kind": "decreaseLiquidity" }, { "kind": "closePosition" }, { "kind": "openPosition" }, { "kind": "increaseLiquidity" } ],
     "estNotional": "9840000000",
     "estPosition": "9800000000",
     "confirmPhrase": "REBALANCE orca <whirlpool-address> [44000,45000]->[44500,45500]"
   }
   

3. Simulate (automatic when executeRebalance is called; shown separately here):

   The execute function calls rpc.simulateTransaction before any signing. If simulation fails, execution aborts with the simulation error. You must fix the plan and retry; the error is never silently ignored.