∮ ricci · full model

The RICCI Model, in Full

A deterministic, auditable policy for a token's creator fees. One observation, one decision, one action per cycle — journalled with its reason before the next timer is drawn.

1Discrete curvature

For the canonical V3 pool with sqrt-price s (Q64.96), the oriented displacement since the previous cycle is measured in parts-per-million of the squared sqrt-price:

r = ±10⁶ · (s² − s₋²) / s₋²(1)

The sign is oriented so that positive r always means the token rose against WETH, whichever pool slot it occupies. Squared sqrt-price is exactly the pool's rational price, so r is a pure integer computation — no floating point ever touches a decision.

2Flow pressure and the adaptive dead zone

Interval WETH volume against in-range liquidity L gives a flow pressure, which widens the dead zone in loud markets so that noise cannot trigger the policy:

q = 10⁶ · flowWETH / (L + 1)(2)
d = 1500 + min(q, 25000) / 5(3)

The dead zone therefore lies between 0.15% and 0.65% of squared price, tightening when the pool is quiet and relaxing when it churns.

3Cubic response

Only curvature in excess of the dead zone earns size, and it earns it cubically:

C = (|r| − d)³ / (d² + 1)(4)
size = clamp(C/200, 25, 1250) bps(5)

Every action is bounded to 0.25%–12.5% of the relevant reservoir. A marginal breach trades the minimum; a violent dislocation deploys the cap and never more.

4The one-sided solvency cone

Buy rule. When r < −d, spend size · WETH. Every drawdown beyond the dead zone is buy-admissible.
Sell rule. Only when r > 4d and token inventory at the live rational price is worth more than twice the WETH reservoir, sell size · tokens. Positive curvature alone is never sufficient: at r = 2d the pool has clearly risen, yet no sale is admissible. The sell region is a strict subset of the positive-curvature region — the policy is structurally buy-biased.

5Calm allocations

Inside the dead zone (|r| ≤ d) the reservoir refuses to sit on surplus:

6The cycle

Every cycle claims available creator fees first (NoFeesToCollect is ordinary), observes the pool, takes exactly one action, and persists the next start time — drawn uniformly from [10, 15] minutes — before the economic action executes, so a restart can neither reset the clock nor double-fire a cycle.

7Safety model

8Why “Ricci”?

Ricci flow, ∂g/∂t = −2 · Ric(g), deforms a metric so that regions of high curvature relax toward uniformity — it is the equation Perelman used to settle the Poincaré conjecture. RICCI does to a price path what Ricci flow does to a manifold: it measures discrete curvature and applies a bounded, deterministic counter-flow until the geometry calms. The reservoir is the metric; the fees are the flow.


1 ∮ RICCI — Ricci Flow Reservoir · Robinhood Chain (4663) · deterministic, journalled, buy-biased.