lfj-auto

LFJ Liquidity Book Auto-Rebalancer

Monad mainnet MON/USDC concentrated liquidity auto-rebalancer for LFJ (Liquidity Book) DEX.

Maintains a narrow (3-10 bin) LP position around the active price. When price moves out of range, automatically removes liquidity and re-adds at the new active bin to keep earning rewards.

Features

• Auto-rebalance on price movement out of range
• Single-sided or dual-sided liquidity (uses whatever tokens are available)
• Real-time dashboard with SSE
• Configurable bin count, position size, slippage, cooldown
• Rebalance history and stats tracking (SQLite)
• Bark / Ntfy / Pushover push notifications
• Docker deployment ready

Quick Start

# Install
pnpm install

# Configure
cp .env.example .env.local
# Edit .env.local with your PRIVATE_KEY and RPC

# Run
pnpm dev

Open http://localhost:3000, go to Config page, click Start.

Environment Variables

# Required
PRIVATE_KEY=0x...
MONAD_RPC_URL=https://your-rpc-endpoint

# Contracts (pre-filled defaults)
LB_ROUTER_ADDRESS=0x18556DA13313f3532c54711497A8FedAC273220E
LB_PAIR_ADDRESS=0x5afd3ec861f6104af26e8755abcc1f876de77620

# Strategy
NUM_BINS=3                    # 3-10 bins
POSITION_SIZE_USD=50          # USD value per position
POLL_INTERVAL_MS=3000         # polling frequency
REBALANCE_COOLDOWN_MS=10000   # min time between rebalances
SLIPPAGE_BPS=50               # slippage tolerance (0.5%)
MAX_DAILY_REBALANCES=50

# Notifications (optional)
NOTIFY_PROVIDER=bark          # bark | ntfy | pushover
NOTIFY_ENDPOINT=https://api.day.app/YOUR_KEY

How It Works

Every 3s:
  1. Read active bin from LBPair
  2. If no position → open new position
  3. If active bin outside position range:
     a. Remove all liquidity (removeLiquidityNATIVE)
     b. Swap to rebalance if needed
     c. Open new position at current active bin (addLiquidityNATIVE)
     d. Log event + send notification

Dashboard Pages

Page	Description
/	Real-time status: engine state, price, position range, wallet balances, bin chart
/config	Strategy settings, engine control (start/pause/stop), emergency withdraw
/history	Rebalance event history table with stats

Tech Stack

• Next.js 16 (App Router) + TypeScript
• viem for Monad chain interaction
• SQLite (better-sqlite3) for persistence
• Tailwind CSS + shadcn/ui
• Server-Sent Events for real-time updates

Docker Deployment

docker compose up -d --build

Data persisted in ./data/rebalancer.db.

Project Structure

src/
  lib/
    config.ts             # Environment config + types
    chain/                # viem clients, ABIs, on-chain operations
    engine/               # Rebalancer engine (poll loop, state machine)
    db/                   # SQLite schema + queries
    notifications/        # Push notification providers
  app/
    page.tsx              # Dashboard
    config/page.tsx       # Configuration
    history/page.tsx      # History
    api/                  # SSE, control, history API routes
  hooks/
    useEngineStatus.ts    # SSE client hook

Key Contracts

Contract	Address	Chain
LBPair (MON/USDC)	0x5afd...7620	Monad (143)
LBRouter V2.2	0x1855...220E	Monad (143)
WMON (tokenX)	0x3bd3...433A	Monad (143)
USDC (tokenY)	0x7547...b603	Monad (143)

Bin step: 5 (0.05% per bin)