> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zonk.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Graduation

> The exact terminal condition and atomic Uniswap V3 settlement path.

Graduation is the one-way transition from internal curve trading to external Uniswap V3 liquidity. A token graduates only when a buy reaches both of these exact onchain conditions:

```text theme={null}
soldSupply == 800,000,000 tokens
activeEthReserve == 3 ETH
```

For an empty curve, the exact gross input that produces 3 ETH after the 1% fee is `3.030303030303030303 ETH`. With intervening sells, graduation still depends on the exact current net reserve and sold supply, not cumulative volume.

## Atomic settlement

```mermaid theme={null}
sequenceDiagram
  participant B as Final buyer
  participant C as ZonkCurveV3
  participant G as GraduationManagerV3
  participant E as Settlement executor
  participant N as Uniswap V3 NPM
  participant P as Permanent custodian
  B->>C: buy reaches terminal state
  C->>C: close curve trading
  C->>G: 200M tokens + 3 ETH
  G->>G: authenticate launch and exact pool price
  G->>P: deploy per-token custodian
  G->>E: authorize settlement
  E->>E: wrap ETH to WETH
  E->>N: mint full-range 1% position
  N-->>P: LP NFT
  G->>P: bind and validate NFT permanently
```

The manager requires the launch's reserved canonical pool to remain at the exact initialized terminal price before minting. Settlement uses the full-range ticks `-887200` through `887200`. Integer liquidity math uses nearly all 200M tokens and 3 ETH; any defined rounding residual is sent to an ownerless per-launch residual escrow with no withdrawal path.

After the transaction, curve `buy` and `sell` revert with trading closed. Swaps occur through the external pool.

<Warning>
  The repository implements and tests this graduation path. Repository evidence does not, by itself, prove that a production token has completed an end-to-end Mainnet graduation, so this documentation makes no such claim.
</Warning>