Pool Architecture

MAGMA's distribution economics run through a set of on-chain pools, each an Anchor program on Solana, each with a distinct role. The backing vault fans out to them via Cross-Program Invocations (CPIs) at resolution time.

Pool	Program	Devnet program ID	Role
Forge	magma_forge_pool	DMYpMVZir21LjdDKf3cTszE1LgtX5UfMMfhLpPz7yoa1	Resolution economics — collects forfeit, distributes to winners
Seam	magma_seam_pool	DxpmLeT35zN2WUNAxAVHcuKNPJjyUyodvjMCLhVFop8Y	Creator royalty (7% of Forge on TRUE)
Core	magma_core_pool	4vvYQhVzmvwDo1zCG4iP8e4T4CBvkM3pVnTz2t3AnHja	Protocol treasury (5% of Forge on TRUE)
Echo	magma_echo_pool	2k8zA7Y6b7wSDaymCQhTuh8EPJykQrEUbFUhipSMArHw	Yield-funded community draw; absorbs the Seam share (37%) of the FALSE forfeit
Ruffler	magma_ruffler	3jf4MTyxVdN4GPMsv67wL14GjtWmJsm6V7TWohae4vxT	Weekly prize draw, independent ticket economy

The Forge Pool

The Forge is where resolution economics happen. Its inflows differ by resolution outcome:

• On FALSE resolution, each incorrect backer forfeits 35% of principal (false_forge_bps = 3500); the backer keeps the other 65% of principal and 100% of their DeFi yield (yield is never forfeited). That 35% capture fans out into three pools — the Forge takes the largest slice, with the rest routed to Echo and Core (see the split below).
• On TRUE resolution, the DeFi yield earned by the backing capital is split on the same schedule; principal is returned in full and is never split.

The distribution split (applied to the 35% FALSE forfeit and, on TRUE, to the yield):

Recipient	Share	BPS	Notes
Forge → TRUE backers (proportional by backing × conviction multiplier)	58%	5800
Seam Pool (creator royalty)	7%	700	TRUE only — folds into Echo on FALSE
Echo Pool (community draw)	37% on FALSE	3700	Absorbs the Seam share on FALSE
Core Pool (protocol treasury)	5%	500
Platform fee	1.5%	150	TRUE-yield only; 0 for Volcanic tier

On FALSE, the 35% capture splits Forge 58% (5800) / Echo 37% (3700) / Core 5% (500) — the Seam/creator-royalty share folds into Echo, and there is no platform fee on the forfeit. On TRUE, the yield splits 58% backers / 7% Seam / 5% Core / 1.5% platform fee.

Volcanic-tier wallets pay a 0% platform fee — their 1.5% (150 bps) is redistributed to TRUE backers. The backing × conviction_multiplier weighting means a Volcanic-tier participant at a Supervolcano streak receives a substantially larger share than an Initiate-tier participant backing the same amount. See Conviction Score for the full multiplier stack.

Sweep mechanic

Unclaimed Forge positions older than 90 days are swept to the Echo Pool, preventing capital from being locked indefinitely.

The Seam Pool

The Seam Pool is the creator royalty system. On every TRUE resolution, 7% (700 bps) of the yield distribution flows to the Seam Pool for the narrative creator.

• The rate is fixed at 7% (700 bps) — not variable by Creator Score or tier.
• It fires only on TRUE resolution, never on FALSE or REFUND. On FALSE, the 7% slice is reassigned to the Echo Pool (the 37% Echo share of the forfeit folds it in).
• Payment is automatic — no platform approval required.
• It is 7% of the TRUE yield distribution, not of the narrative backing pool directly.

Why fixed at 7%: the rate is a hardcoded constant in the Anchor program. A variable rate would require a dynamic lookup at resolution time (creator's tier then versus at creation), introducing disputes and edge cases. A fixed rate is auditable, predictable, and fair to all creators.

Sweep mechanic

Unclaimed Seam royalties older than 180 days are swept to the treasury.

The Core Pool

The Core Pool is the protocol treasury. It takes a 5% (500 bps) slice on both outcomes — 5% of the TRUE yield distribution and 5% of the FALSE 35% forfeit capture. It accumulates protocol revenue from all narrative resolutions across all chains and is controlled by the treasury multisig. Post-TGE, the Core Pool will distribute revenue to $MAGMA stakers (a V4 feature) — see Token Economics.

The Echo Pool

The Echo Pool is the protocol's community yield distribution — a weekly prize draw funded primarily by the DeFi yield generated by backing capital across the protocol. It also absorbs the Seam (creator-royalty) share of the FALSE forfeit: on a FALSE resolution there is no creator royalty, so that 37% (3700 bps) of the 35% capture routes to the Echo Pool instead of the Seam Pool.

The Echo Pool is not an airdrop and not a fixed emission schedule. It fills based on how much conviction capital is actively locked: more capital committed to narratives means more yield generated means a larger Echo Pool. Pool size is directly proportional to active backing volume.

How it fills

Three sources fill the pool each epoch:

• DeFi yield on backing capital — SOL locked to back narratives earns lending yield in integrated protocols (Kamino and others) during the window; a portion flows to the Echo Pool at epoch end.
• The Seam share of FALSE forfeits — the 37% (3700 bps) Echo slice of each FALSE backer's 35% principal forfeit (see the Forge split).
• Epoch allocations from resolved pools — a portion of protocol revenue from resolutions flows in each epoch.

Ticket economy

Participants earn Echo Pool tickets by contributing to the protocol:

• Correct narrative backings — base tickets proportional to the backing amount.
• Eruption Streak tier — multiplies ticket earnings; Supervolcano participants earn substantially more tickets per correct backing than Initiate participants.
• Narrative creation — publishing narratives that resolve correctly earns creator tickets proportional to the pool volume attracted.
• Protocol missions — completing mission categories earns bonus tickets.

Higher streak tiers multiply earnings because sustained accuracy is the hardest signal to manufacture and the most valuable thing the protocol can reward.

The draw

At epoch end, a Pyth Entropy VRF draws winners from the ticket pool. Each correct backer's ticket allocation is stored in an EchoTicket PDA on-chain before the draw, and the VRF proof is committed on-chain before any distribution executes — no one, insider or otherwise, can influence the outcome. Ticket holdings translate to probability-weighted chances.

Why this is not an airdrop

Airdrop	Echo Pool
Fixed emission	Funded by activity — fills based on what participants do
Rewards capital/early presence	Earned through verified accuracy at minimum stake + streak
Flat weighting	Weighted by contribution quality (streak tier)
Permanent allocation	Resets each epoch — stop contributing, stop accumulating

Activation requirement

The Echo Pool VRF draw activates only after the oracle achieves sufficient accuracy on a minimum number of resolved narratives. This prevents a systematic oracle bias from misallocating yield. Below the activation threshold, the pool accumulates and activates once the reliability condition is met.

The Ruffler

The Ruffler is a separate weekly prize draw with its own ticket economy, VRF mechanics, and anti-sybil rules. It is distinct from the Echo Pool but shares the same underlying signal — strong Eruption Streak history and active backing.

Prize structure

Each weekly round distributes a minimum prize pool across five positions:

Position	Share
1st	55%
2nd	20%
3rd	12%
4th	8%
5th	5%

The prize pool accumulates from protocol participation activity each epoch.

Ticket economy and anti-sybil rules

Participants purchase Ruffler tickets, but ticket weight is not uniform and entry is capped. All of the following are enforced in-contract:

Rule	Threshold
DEGEN holder multiplier	1.15x ticket weight for DEGEN token holders
Maximum tickets per wallet	2 per round
Wallet age	Minimum 60 days old
Narrative backing recency	Active backing in the last 30 days required
Flagged-wallet exclusion	Correlation-detector flags are excluded

The 2-ticket cap is the primary anti-whale protection: a single wallet cannot dominate a draw regardless of capital. Because these rules are enforced at the contract level (not just the backend), a fresh wallet created for a Sybil attack cannot participate regardless of ticket purchases.

Provably fair randomness

The Ruffler uses Pyth Entropy VRF. The proof is committed on-chain before any prize release:

request VRF → wait for callback → commit proof on-chain → select winner → execute prize release

No step can be manipulated after the VRF is requested; anyone can verify the proof independently, and the result is deterministic given the VRF output and the ticket list.

Correlation detector

A backend correlation detector flags wallet clusters showing coordinated behavior — wallets backing opposite sides of the same narrative, funded from the same source within a short window, sharing near-identical backing patterns, or hitting identical outcomes at statistically improbable rates. Flagged wallets have Ruffler eligibility suspended until reviewed by an admin.

Cross-pool CPI flow

At resolution, magma_backing_vault orchestrates the entire distribution through Cross-Program Invocations in a fixed sequence:

1. finalize_resolution executes on the vault (after threshold + 48h timelock).
2. Vault calculates each participant's outcome.
3. CPI to the Forge → receives the 35% FALSE forfeit (or, on TRUE, the yield to split).
4. Forge calculates the 58 / 7 / 5 + platform distribution.
5. On TRUE: CPI to Seam records the creator's 7% claimable royalty.
6. On FALSE: the 7% Seam slice folds into the Echo 37% share — CPI to Echo records it.
7. CPI to Core records the 5% treasury allocation (on both outcomes).
8. CPI to the Echo pool → records the backer's ticket allocation for the epoch.
9. TRUE backers' Forge claim records created (registerTrueBacker).
10. Participants claim their shares from each respective pool.

Audit scope

All pool accounts and CPI call sequences are included in the external security audit scope. See Security.