Tokenomics
PRTY Supply
Total supply: 100,000,000,000 PRTY (100 billion)
PRTY is split between an initial circulating supply available at TGE and a price-locked supply held in the on-chain SupplyController contract.
| Bucket | Amount | % of total | Available at TGE? |
|---|---|---|---|
| Day-one circulating | 1,000,000,000 | 1% | Yes |
Locked in SupplyController | 99,000,000,000 | 99% | No — released only when price tiers are sustained |
| Total | 100,000,000,000 | 100% |
The 99B locked supply is released exclusively through the price-tier unlock mechanism described below. There is no admin function that can mint, burn, or move locked tokens outside that mechanism.
Day-One Circulating Distribution (1B PRTY)
The initial 1B is distributed at TGE for immediate liquidity, team retention, and investor obligations.
| Allocation | Amount | % of day-1 | Notes |
|---|---|---|---|
| Liquidity pool seed | 300,000,000 | 30% | Seeds the PRTY/WETH Uniswap V4 pool that the price oracle reads |
| Community & fair launch | 250,000,000 | 25% | Public participation, immediately tradeable |
| Team & founders | 200,000,000 | 20% | Pre-funds PairtyTeamVesting (monthly linear over 36 months from TGE) |
| Early contributors | 100,000,000 | 10% | Joins the PairtyTeamVesting pool on the same monthly schedule |
| Treasury (DAO-governed) | 100,000,000 | 10% | Operating budget for the DAO from day one |
| Staking seed | 50,000,000 | 5% | Bootstraps staking rewards before tier unlocks begin |
Price-Based Unlock (99B PRTY)
The 99B locked supply is released through 10 immutable price tiers. Each tier requires the PRTY/WETH pool price (sourced from a Uniswap V4 hook reading slot0.sqrtPriceX96) to be sustained above the tier threshold for 72 consecutive hours, with a 7-day cooldown between unlocks. Anyone can permissionlessly call checkAndUnlock() once the conditions are met.
Tier thresholds are denominated directly in ETH (WETH-per-PRTY), not USD. The Uniswap V4 PRTY/WETH pool is the single source of truth — there is no external oracle, no Chainlink feed, no admin-set fallback price. The protocol's PriceUnlockHook converts sqrtPriceX96 to a wei-per-PRTY value and pushes it directly to SupplyController.updateSmoothedPrice().
The ladder shape is 1×3×10 compounding. Each tier represents a 10× step from two tiers prior, with alternating 3× and 10/3× ratios between adjacent tiers. The shape and per-tier unlock amounts (2/4/6/8/10/12/14/16/13/14 ×1B PRTY, total 99B) are immutable; there is no tier setter.
The USD-equivalent values below are illustrative only, computed at a reference ETH price of $3,000/ETH at the time the ladder was finalized. They are not part of the on-chain logic and will drift with ETH price.
| Tier | Price (ETH-per-PRTY) | ≈ USD at $3,000/ETH | Tokens unlocked |
|---|---|---|---|
| 0 | 1 gwei | $0.000003 | 2,000,000,000 |
| 1 | 3 gwei | $0.000009 | 4,000,000,000 |
| 2 | 10 gwei | $0.00003 | 6,000,000,000 |
| 3 | 30 gwei | $0.00009 | 8,000,000,000 |
| 4 | 100 gwei | $0.0003 | 10,000,000,000 |
| 5 | 300 gwei | $0.0009 | 12,000,000,000 |
| 6 | 1,000 gwei (1 µETH) | $0.003 | 14,000,000,000 |
| 7 | 3,000 gwei (3 µETH) | $0.009 | 16,000,000,000 |
| 8 | 10,000 gwei (10 µETH) | $0.03 | 13,000,000,000 |
| 9 | 30,000 gwei (30 µETH) | $0.09 | 14,000,000,000 |
| Total | 99,000,000,000 |
Anti-Manipulation
The unlock mechanism is designed to be impervious to flash-loan and single-block price spikes:
- 72-hour sustained price — the EMA-smoothed price must hold above the tier threshold continuously for three days
- EMA smoothing (1/20) — each new per-swap sample is a 5% blend with the prior smoothed price, so a single large swap cannot move the smoothed price meaningfully
Terminology: earlier drafts of this document referred to the smoothed value as a "TWAP". It is technically an EMA over per-swap samples pushed by the Uniswap V4 hook, not a time-weighted average integrated over time. The on-chain identifier is
smoothedPrice.
- 7-day cooldown between consecutive tier unlocks
- 4-hour staleness limit on the oracle —
checkAndUnlock()reverts if no price update has been received recently
Per-Tier Distribution Split
When a tier unlocks, its tokens are immediately distributed across six on-chain destinations using fixed percentages set in the contract:
| Destination | Share | Purpose |
|---|---|---|
| Staking rewards | 30% | Funds long-term staking yield |
| Vault reserves | 20% | Treasury-controlled vault for protocol use |
| Liquidity pool | 20% | Tops up Uniswap LPs and pairing markets |
| DAO treasury | 15% | Governance-controlled treasury |
| Team vesting pool | 10% | Flows into PairtyTeamVesting (vests on the same monthly schedule) |
| Investor repayment pool | 5% | Pro-rata to early Pairty backers via InvestorRepaymentPool |
Team Vesting
Team and early-contributor tokens vest monthly linear over 36 months from TGE, with no cliff. There is one vesting clock per beneficiary; each beneficiary's basis-point share of the pool is fixed at deployment.
The pool is seeded at TGE with the day-one team and contributor allocations (300M total). It then grows over time as each price-tier unlock contributes 10% of the unlocked tokens to the same pool. The vesting schedule does not change — but the per-month claimable amount grows as the pool grows.
This design intentionally:
- Gives the team predictable monthly cadence (retention and personal planning)
- Lets the team participate in the upside from price tier unlocks (more tiers fire faster ⇒ larger monthly claim)
- Avoids the complexity of overlapping per-tier cliff schedules
Investor Repayment Pool
A new pool, introduced specifically for Pairty, repays early investors in PRTY. It receives 5% of every price-tier unlock and distributes those tokens pro-rata to a fixed list of investor beneficiaries whose basis-point shares are set at deployment and immutable thereafter. Beneficiaries claim at any time using the on-chain pull pattern; no vesting cliff applies.
This replaces the buyback mechanism that appeared in earlier drafts of the Pairty whitepaper and the 7N7D source design.
What Has Been Removed
The previous Pairty whitepaper described two value-accrual mechanisms that are not part of the redesigned model:
- Token burn on failed pairings. PRTY no longer has a public burn surface. Pairing failures are addressed through other game mechanics (slashing of personal-token escrow, reputation effects), not PRTY supply reduction.
- Buy-backs. The 5% bucket previously implied for buyback is reallocated to the Investor Repayment Pool.
Governance and Roles
DEFAULT_ADMIN_ROLEonSupplyControlleris renounced after deployment verification.GOVERNANCE_ROLEis granted to aTimelockControllercontrolled by the DAO; it is the only role that can re-point distribution destinations.PRICE_ORACLE_ROLEis granted only to thePriceUnlockHookcontract.- Tier table is immutable — there is no setter, no proxy, and no upgrade path.
Audit
The PRTY redesign is undergoing security review by Oak Security. The audit scope, design rationale, and open questions are documented at apps/contracts/audit/SECURITY-AUDIT-SCOPE.md in the Pairty monorepo.