galleonlabs/crypto-defi-skills / packages/lp/skills/lp-monitor
lp-monitor
VerifiedEvaluate an existing Uniswap v2, v3, or v4 or Aerodrome or Slipstream liquidity position. Use when the user asks whether it is in range, what it earned, how it performed versus HOLD, who controls it, whether automation is active, or whether to hold, collect, recenter, restake, reduce, or exit. Produces a current recommendation only; not transaction execution.
| File | Kind | Size |
|---|---|---|
| ATTRIBUTION.md | markdown | 921 B |
| LICENSE | other | 1.0 KB |
| SKILL.md | skill md | 5.2 KB |
| agents/openai.yaml | config | 284 B |
| references/action-policy.md | markdown | 1.8 KB |
| references/automation-state.md | markdown | 1.6 KB |
| references/degraded-state.md | markdown | 1.9 KB |
| references/official-tools.md | markdown | 3.0 KB |
| references/output-contract.md | markdown | 1.4 KB |
| references/position-accounting.md | markdown | 2.3 KB |
| references/protocol-state.md | markdown | 2.2 KB |
| references/vfat.md | markdown | 2.5 KB |
| scripts/position.mjs | script | 3.8 KB |
references/protocol-state.md
View on GitHub# Protocol state
## Uniswap v2 and Aerodrome classic
Read pair reserves, total LP supply, wallet LP balance, decimals, fee parameters, and any gauge balance. The position's reserve share is:
```text
amount0 = reserve0 * lpBalance / totalSupply
amount1 = reserve1 * lpBalance / totalSupply
```
Use integer arithmetic with protocol rounding. Fees normally appear through reserve growth and LP value. If LP tokens are staked, include the gauge-held balance and verify who owns fees and rewards.
## Uniswap v3
Read NFT owner, pool, fee tier, tick spacing, lower and upper ticks, liquidity, tokens owed, current tick, fee growth inside, and collection history. Ownership approval is not ownership. Include both principal inventory and uncollected fees.
## Uniswap v4
Read pool state through the deployed StateView or the current official read path, not a v3-shaped pool contract. Bind the complete PoolKey and PoolId. Read position ownership, liquidity, current tick, fee state, subscriber or manager state, and hook state. Position discovery may require indexed PositionManager events, but the index is only discovery evidence; recheck ownership and state onchain. Decode hook permissions. Hook logic can change fee, liquidity, donation, or settlement behavior.
For a hook-issued share model, read the full currency set, internal reserves, actual balances, share supply, wallet or custodied shares, rate sources, amplification or other invariant state, and fee accumulators. Do not interpret the position as an NFT or sum shared reserves once per pairwise PoolKey.
## Slipstream
Read NFT owner, gauge custody or deposit state, liquidity, ticks, current tick, fee rights, reward accrual, epoch state, and reward dilution. Confirm whether unstaking is required to collect or modify. Never add unstaked fees and staked emissions unless current contracts prove both accrue.
## Current liquidity
For concentrated pools, headline TVL is insufficient. Read active liquidity and initialized ticks around the current price when action quality depends on depth. Use correct signed floor division for negative tick compression. Bound bitmap reads and mark incomplete profiles instead of returning false precision.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |