clmm-watch

/clmm-watch

Starts a reconnecting stream that fires an alert whenever a tracked position's current tick crosses its tickLower or tickUpper boundary.

Steps

1. Set environment variables (add to .env or export in shell):

   # Primary: Yellowstone gRPC (preferred - lowest latency)
   export YELLOWSTONE_ENDPOINT="https://your-grpc-endpoint:10000"
   export YELLOWSTONE_TOKEN="your-token-here"
   
   # Fallback: Helius LaserStream websocket
   export HELIUS_API_KEY="your-helius-key"
   
   # Wallet to watch
   export OWNER_ADDRESS="YourWallet111..."
   

2. Install dependencies (first run only):

   npm install
   

3. Run the watcher:

   # tsx is in devDependencies; Node 22+/24 can also run TS natively:
   #   node --experimental-strip-types skill/templates/watcher.ts
   npx tsx skill/templates/watcher.ts
   

   Or if compiled:

   node dist/templates/watcher.js
   

4. Expected output on startup:

   [clmm-watch] Fetching positions for YourWallet111...
   [clmm-watch] Tracking 3 positions across orca, raydium, meteora
   [clmm-watch] Connected to Yellowstone gRPC
   

5. Alert output when a position goes out of range:

   [ALERT] OUT-OF-RANGE venue=orca pool=SOL/USDC tickCurrent=45210 tickLower=44000 tickUpper=45000 direction=above ts=2026-06-18T12:34:56.789Z
   

6. Reconnect behavior: the watcher reconnects automatically on disconnect with exponential backoff (500ms base, 30s max). No manual restart needed.

7. Stop the watcher: press Ctrl+C. The process exits cleanly; no transactions are ever submitted by this command.

Notes

• Positions are fetched once at startup; restart to pick up newly opened positions.
• For debugging stream issues, see agents/stream-watcher.md.
• This command is read-only and alert-only; it never signs or submits transactions.