Get started
Concepts
The core ideas behind Pyre — how a token is born, grows, graduates, and pays out.
The bonding curve
Every token launches onto a constant-product bonding curve. Buys push the price up along the curve, sells push it down; there is no order book and no external liquidity to rug. Every token starts at a fixed $3.5k market cap and climbs toward its preset's graduation cap.
| Preset | Graduates at | Feel |
|---|---|---|
| Small (0) | $30k mcap | quick draw — light raise |
| Standard (1) | $65k mcap | balanced raise |
| Large (2) | $120k mcap | deep curve, heavy pool seed |
The curve has no owner and its ETH can only leave via sells or graduation — see the SDK for curveMath() and live curveState().
Graduation
When the curve fills, anyone can call graduate() (it's permissionless and tipped). In one atomic transaction the protocol creates the Uniswap v4 pool, seeds it, and locks the LP in a contract with no withdraw function — it can only ever collect fees. Liquidity is locked forever by construction.
The Mixer — ten fee modes
Each token charges a buy/sell tax (capped at 5% each) plus a small curve fee. Where that money goes is up to the creator: split it across any of ten modes, by weight.
| id | Mode | What it does |
|---|---|---|
| 1 | Bonfire | buys & burns the token |
| 2 | War Chest | forwards to a treasury (timelock/vesting tiers) |
| 3 | The Vault | buys & time-locks the token in tranches |
| 4 | Merry Men | rewards holders, weighted by balance × hold-time |
| 5 | Golden Arrow | powerball jackpot to a random holder |
| 6 | Rain | frequent micro-jackpots to many holders |
| 7 | Standoff | last-buyer-standing pot (FOMO) |
| 8 | Tournament | leaderboard — top net buyers split a pot |
| 9 | Diamond Hands | Merry Men where selling forfeits your streak |
| 10 | The Moat | buys & deepens the locked LP |
5% of every fee, on every token, buys and burns the platform token $PYRE. The remaining 95% flows to the modes. Configs are either locked forever or changeable through a 72-hour public timelock.
Rewards pay themselves
Reward modes distribute via Merkle roots, but you never have to claim: the contracts pay the address in the Merkle leaf (not the caller), and a permissionless distributor submits everyone's claims for them. Rewards land in your wallet automatically. The API exposes a per-wallet ledger of everything earned.
Trust model
- Tokens are fixed-supply ERC-20s with no mint, owner, blacklist, or pause.
- 100% of supply enters the curve at launch; the curve has no admin functions.
- Graduation is atomic and the LP lock has no withdraw.
- Jackpot randomness is drand, BLS-verified on-chain, committed before the beacon exists.
- Every keeper job is permissionless and tipped — the bots are redundancy, not trust.
Non-custodial
The SDK and MCP never take custody. Writes are signed by a key you control (or returned unsigned for you to sign). Use a dedicated hot wallet for automation.