Method
One formula, its sources, its limits.
gap = (price − NAV) ÷ NAV, in parts per million, truncated toward zero; the threshold counts as crossed when reached exactly. The site (src/lib/gap/math.ts) and VellenGapWatch (VellenGapMath) run the same lines, checked on 458 generated cases.
- The index read
- The live IPO index on Robinhood Chain (chain 4663). Index token (ERC-4626, asset USDG): 0x4B129357B164d65834bdBA935c3cD08FcB7e14DA. Constituent list (getActiveTokens): 0xBD5a9d71dec44bc7282d341eBFD9b4043e16dd77. Price oracle (observe, getFeedConfig): 0xBC888398B61c12D87F498f27f6B0e02EA028904C. Vellen is not part of it and names it only by its contracts.
- How its functions were identified
- The index's source is not published on Sourcify and the explorer's API refuses plain server requests, so the functions come from the bytecode's selector table, resolved against public signature databases. Each one used was called and cross-checked: totalAssets equals the holdings × oracle prices + cash; observe(token) equals the Chainlink feed's latest answer and updatedAt. Functions that could not be identified are not used.
- NAV per token
- convertToAssets(1 token) on the index, in USDG. Recomputed as a cross-check from Σ(holding × oracle price) + cash ÷ supply; the page shows whether both agree with totalAssets within 0.1 %. Its age is the oldest constituent price (Chainlink updatedAt). Stock feeds update during US market hours; over a weekend NAV is Friday's.
- Market price of the index token
- Searched at every reading: Uniswap v2 getPair and v3 getPool (fees 0.01%, 0.05%, 0.3%, 1%) against USDG and WETH, and Uniswap v4 PoolManager Initialize logs naming the token since block 117,303,684. On 20 Nov 2026 every answer was “none”, so the token's own premium or discount is not measurable, and the page says so instead of borrowing a price.
- Look-through gap
- Each holding valued at the 30-minute time-weighted price of its deepest USDG Uniswap v3 pool (pool.observe, mean tick rounded down, tick → price with exact integer math), plus cash, ÷ supply, compared with NAV. It measures whether the holdings trade above or below their oracle value; it is not a price of the index token. Spot (slot0) is shown next to it. Last pool activity = the pool's latest observation time.
- History
- Mint and redeem: the index's ERC-4626 Deposit and Withdraw events; executed price = assets ÷ tokens from the event; NAV read at the block before through an archive endpoint. Samples: NAV and the basket at evenly spaced blocks since deployment. Anything that cannot be read is left out and said.
- Tickers
- A company name is shown only for official stock tokens proven on chain: proxy code hash, the official beacon in the ERC-1967 slot, supply above zero. Stock tokens are tokens on Robinhood Chain, not the shares themselves.
- VellenGapWatch
- Not deployed yet. Constructor argument: the Uniswap v3 factory 0x1f7d7550b1b028f7571e69a784071f0205fd2efa (every pool is checked against it). Tracks: index token + market side (none, a pool of the token, or the basket at pools) + age rules. recordCheckpoint() computes NAV, the time-weighted price, both ages and the gap itself and stores them; one per second per track; a track's pools are fixed after its first checkpoint. Rules: direction, threshold in bps, cooldown; evaluate() returns Triggered, Clear, Cooldown or the reason it cannot judge (no market, stale or invalid NAV, stale price, holdings not covered); fire() records a crossing once per checkpoint and cooldown. No owner, no fee, no upgrade, no ether, no funds.
- Limits
- Pools can be thin (depth is shown) and a time-weighted price lags fast moves by design. The index can change constituents; history samples taken under another constituent list do not draw a basket. Readings are cached up to 30 seconds (served at most 10 minutes old when the chain cannot be reached, with the age shown). Nothing here is advice.
Status of each part
Price vs NAV, liveNAV per token of the live IPO index on Robinhood Chain, the age of the oldest price behind it, and a search of Uniswap v2, v3 and v4 for a market of the index token. No pool trades the index token today, so its own premium or discount is not measurable; the page says so.Prototype
Look-through gapThe index's holdings priced at their own pools' 30-minute TWAP plus cash, per token, against NAV; per constituent: oracle price and age, pool price, last pool activity. Measures the holdings, not the index token. Pools can be thin; depth is shown.Prototype
Executions and historyEvery mint and redeem of the index token at its executed price against NAV at the block before, and NAV and the basket sampled since the index started. Historic reads need an archive endpoint; missing points are left out, never filled in.Prototype
Threshold calculatorEnter a price (or use the basket) and a threshold: see the gap, whether a premium, discount or either-side rule would trigger, and the quiet band. Shows what a rule would say now. It sends nothing.Prototype
Rules on chain (VellenGapWatch)Tracks, checkpoints the contract computes itself (NAV, TWAP price, both ages, the gap), threshold rules with cooldown, evaluate and fire. Built and tested, not deployed yet. The owner deploys it later.Concept
AlertsA message when a rule fires (premium or discount past your threshold). Not built.Concept
$VELLEN creditsPlanned test: $VELLEN as credits for those alerts. Not built. Every feature above works without the token.Concept