The Ember Codex

Official Pyre Protocol documentation

What is Pyre

Protocol overview

Hall of the ImmolatedThe ForgeThe ObservatoryThe Ashen CupThe BonfireThe Amber VaultThe Black MarketThe Grand ExchangeThe Gate

Pyre Protocol is a token economy built directly on Uniswap v4. It combines three mechanisms: a hard-capped token with epoch-based decay on idle balances, single-sided staking that accrues yield denominated in $ETH, and a burn-to-mint NFT, the Acolyte, whose tier acts as a multiplier on staking yield.

The design premise is simple to state: every liquid $PYRE balance carries a holding cost, applied per epoch, while committed balances do not. Holders choose between two forms of commitment. Staking exempts a balance from decay and earns a pro rata share of $ETH yield. Burning permanently removes supply and mints or upgrades an Acolyte, raising the multiplier on everything the stake earns. The two mechanisms are designed to be combined.

The Ember Codex documents each subsystem in its own chapter, and each subsystem is drawn as a building in the kingdom: the Bonfire is supply and decay, the Forge is staking and burning, the Black Market is the Acolyte. Read the chapters in order for the full specification, or open the chapter behind any building.

The Great Map: every state a $PYRE balance can occupy. Swapping in arrives liquid; liquid balances decay toward the Bonfire; staking earns $ETH; burning on either track forges an Acolyte that multiplies the stake; accrued $ETH is claimable at any time.
  1. The Exchange. Swap in through the canonical $PYRE/$ETH pool. Tokens arrive liquid, and decay applies from the first epoch.
  2. Liquid $PYRE. Decays 0.45% per epoch (one hour), halving every 2,000 epochs toward a 0.01% floor. Every decayed token is burned.
  3. Staked $PYRE. Exempt from decay; accrues $ETH pro rata by effective weight. Unstaking is a 7 day linear release, and the returning portion earns no yield.
  4. The Burn. Permanently removes supply and credits the wallet's cumulative burn weight.
  5. Token track. Burns $PYRE alone. Acolyte multipliers run 1× to 3×.
  6. LP track. Pairs $PYRE with $ETH and locks the position forever; the liquidity stays live in the pool. Multipliers run 2× to 6×.
  7. The Acolyte. Tiers by cumulative burn: Ember 10,000, Flame 75,000, Forge 150,000, Pyre 300,000. The crown is the Immolated: a further ×1.2, for a 7.2× ceiling.
  8. Claim. Accrued $ETH can be claimed at any time; claiming never touches staked principal.
  9. The Bonfire. Every chosen burn and every epoch of decay ends here. Hard cap 1,000,000,000; supply only falls.
Plate I. The Great Map: every state a $PYRE balance can occupy, and every path between them.

The chapters that follow specify the system in full: the decay schedule and its halvings, the staking weight formula, the Acolyte tiers and both burn tracks, and the Immolated prestige. Every parameter quoted in this Codex mirrors the deployed contracts, and all of it can be verified on-chain once addresses are published at launch.