FROM VERIFIED ON-CHAIN DATA
TO UNDERSTANDABLE RISK —
WITHOUT GIVING CONTROL TO THE AI.
ChainPilot is an AI-assisted Uniswap V3 risk copilot. It queries indexed position data through The Graph, evaluates tick boundaries deterministically, and provides grounded AI risk interpretations with full on-chain provenance.
Focused on core concepts, range status, and plain-English risk understanding.
WHAT IS CHAINPILOT?
ChainPilot is an AI-assisted DeFi portfolio and risk copilot specifically built for Uniswap V3 concentrated liquidity positions.
Unlike generic wallet trackers that only show raw balances, ChainPilot answers the load-bearing operational question:
"Is my liquidity actively earning fees, how far has price drifted from my selected range, what are the risk implications, and what non-prescriptive options should I consider?"
THE USER PROBLEM: HIDDEN RANGE RISK
Shows a static token balance or NFT card. Does not alert the user when the pool tick drifts past boundary limits or when fee accrual stops completely.
Continuously measures current pool tick vs position lower/upper tick boundaries, computing exact tick distances, exposure shifts, and fee activity.
NON-NEGOTIABLE ARCHITECTURE PIPELINE
Data Provenance Guarantee: The Graph is the load-bearing source of verified indexed position data. Deterministic range geometry computes exact boundaries. AI provides natural-language interpretation only. Final control rests 100% with the user.
TECHNOLOGY MAPPING
DETERMINISTIC ENGINE VS AI EXPLANATION
- • Pool address & token pair symbols
- • Lower tick bound (t_lower)
- • Upper tick bound (t_upper)
- • Live current pool tick (t_current)
- • In-range vs out-of-range status
- • Exact tick distances to bounds
- • Range ratio & protocol tick spacing
- • Rule-based consideration generator
- • Natural-language summary
- • What I Found / Why It Matters
- • Grounded strictly in Layer 1 & 2 facts
- • Structured schema output validation
WHY THE GRAPH & WHY RANGE RISK MATTERS
Why The Graph? Indexing Uniswap V3 positions directly via standard RPC would require scanning millions of historical mint and burn event logs. The Graph Subgraph Gateway provides instant, verified GraphQL queries for any wallet address.
Out of Range ≠ Liquidation: When a position moves out of range, liquidity is inactive and accumulates 0 swap fees. However, assets are not liquidated; the position remains fully owned on-chain as a Non-Fungible Token.
INTERACTIVE TICK DRIFT SIMULATOR
Test how tick drift affects range status and distance math. This local instrument alters visual telemetry without modifying blockchain state.
PROVENANCE & READ-ONLY SAFETY BOUNDARIES
Every position detail contains direct Etherscan links to NFT ID, Pool Contract, Factory Contract, and Subgraph Deployment ID. Don't trust — verify.
Public wallet analysis requires zero private keys, zero signature grants, and zero autonomous execution.
PROGRESSIVE DISCLOSURE MATRIX
| CONCEPT | BEGINNER VIEW | ADVANCED VIEW | PRO / JUDGE VIEW |
|---|---|---|---|
| Range Status | "Active and earning swap fees." | t_current inside [t_lower, t_upper] | Verified Graph payload; distance ratio 45% |
| Out of Range | "Inactive. Fees paused." | Drifted 4,500 ticks below t_lower | Single-sided asset risk state |
| AI Engine | Plain-English risk explanation | Grounded evidence citations | Groq primary → Gemini fallback → Deterministic fallback |
FUTURE / ROADMAP
Historical tick volatility analytics and time-in-range tracking.
Optional user-approved transaction workflows via Privy embedded wallet.
Arbitrum, Optimism, and Polygon Uniswap V3 Subgraph deployment indexing.