LP monitor

Reconstruct the position from chain state, measure it against HOLD, and decide whether action clears its cost and risk hurdle.

Workflow

Bind chain ID, wallet, protocol version, pool identity, token order, position ID or LP balance, gauge or staking state, and observation block.
Read authoritative state. Use protocol state to distinguish reserves, liquidity, owed fees, rewards, and range status.
Reconstruct the original quantities and cash flows from receipts or a trusted ledger. Follow position accounting. If the baseline is unknown, label it unknown; never overwrite it with the current state.
Include every attributable asset once: active position inventory, unclaimed fees, unclaimed rewards, claimed proceeds, unstaked LP or NFT state, and loose wallet residue.
Measure current value, inventory change versus HOLD, realized fees, incentives, all costs, and net result over stated windows. Separate measured values from projections.
Evaluate pool, token, hook, gauge, admin, and exit changes since the last good observation. A delisted pool must remain manageable.
Quote each candidate action and apply action policy. Do not rebalance because a threshold fired without an economic case.
Emit monitor output.

Use node scripts/position.mjs --help for range state and balance-sheet arithmetic. It does not fetch chain data and does not choose an action.