Constant-product engine
Pool initialization, swaps, add / remove liquidity and unified 8-decimal scaling — the entire exchange inside one audited contract.
SATURN PROTOCOL // PHANTASMA CHAIN
Three generations of
on-chain market machinery.
From a single battle-hardened contract to a twenty-two-contract modular exchange — and a credit layer built on top of both. This is everything Saturn runs, catalogued.
GEN I SATRN MONOLITH GEN II MODULAR ×22 GEN III LENDING ×8
22 MODULAR V4 CONTRACTS
3 ARCHITECTURE LAYERS
8 LENDING CONTRACTS
1000 CREDIT SCORE SCALE
SATRN v2 — the monolith
Saturn DEX v3 is one contract: SATRN_v2.tomb. The full
exchange — AMM, LP certificates, fee routing — shipped as a single
unit and hardened release after release until it simply refused to break.
Positions as certificates
Every liquidity position mints a SATURN NFT ticket carrying its own reserve share — transferable, inspectable, on-chain.
Unified 0.4% fee
One predictable rate, split three ways: 0.21% to liquidity providers, 0.09% to the protocol, 0.10% to the token owner.
FACTORY holder rebate
Holders of a Series-5 FACTORY NFT trade with an 80% swap-fee discount, verified on-chain at swap time.
Position merging
Many LP tickets fold into one — pending TACAL rewards are claimed before the old certificates burn.
Battle-tested core
Reentrancy sentinels, truncation guards, minimum-amount gates and skim protection, refined across 30+ patch releases.
DEX v4 — twenty-two contracts, three layers
v4 splits the monolith into single-purpose contracts: a lean core, a financial-products layer and an agent layer — wired through one centralized reentrancy guard, financial locks and a fee-redirect switch. The swap engine alone is ~100 lines of audit surface.
01 saturnadmin
Admin Config
Protocol owner, fee-split ratios, pool-fee bounds and the centralized reentrancy guard shared by every contract.
02 saturnpools
Pool Registry
Canonical pair keys, multi-pool-per-pair storage, reserves, scale factors and the financial locks other layers rely on.
03 saturnliquidity
Liquidity Manager
Create pools, add and remove liquidity with slippage + truncation guards. Sole custodian of pool tokens.
04 saturnswap
Swap Engine
The hot path — constant-product math and per-pool fee routing, isolated to ~100 auditable lines.
05 saturnfees
Fee Vault
Per-provider fee accrual and claims, plus the redirect switch that powers bonds and rentals.
06 SATRN
Pool NFT
One certificate NFT per pool — minted on create, burned on remove. The only contract that is a token.
07 saturnrewards
Reward Campaigns
Permissionless liquidity mining: fund a campaign, enroll pools, claim rewards pro-rata to liquidity.
08 saturnrouter
Router Views
Best-pool-for-swap selection and aggregated single-call reads — one entry point for frontends.
09 saturnbonds
Bond Market
Securitize future fee income as fixed-yield bonds. Partial or collateral-buffered hybrid modes, tradable on secondary.
10 saturnrental
Pool Rental
Franchise a pool: the owner collects guaranteed SOUL rent while the operator runs fees within owner-set bounds.
11 saturnfeeopts
Fee Options
Derivatives on fee policy — buy the right to set a pool’s fee rate for a period; the original rate restores at expiry.
12 saturnsyndicate
Syndicates
Crowdfund large pools. Fee revenue distributes pro-rata to contributors; dissolution refunds are built in.
17 saturnlaunchpad
Launchpad
Fixed-price token launches on syndicate mechanics with refund-safe accounting for unsold supply.
13 saturnarb
Flash Arbitrage
Atomic two-pool arbitrage with executor capital. Profit splits 80 / 20 with the treasury; per-executor stats on-chain.
14 saturnlimit
Limit Orders
Resting on-chain orders. Any agent may execute when price crosses — and earns a 0.1–5% bounty for doing so.
15 saturnpredict
Prediction Markets
Bet over / under on pool fee or reserve metrics. Self-resolving at claim time — no oracle, no keeper.
16 saturnvaults
Agent Vaults
Deposit into agent-run strategies with share accounting. Performance fees apply only above the high-water mark.
18 saturnclpools
Concentrated Liquidity
Range-bound pools quote only inside their declared band — roughly 10× the capital efficiency per token deposited.
19 saturntwamm
TWAMM
Stream large swaps over hours. Permissionless, bounty-paid chunk execution makes size sandwich-resistant by construction.
20 saturnflash
Flash Loans
Borrow protocol liquidity with zero capital, arbitrage two pools, repay plus a 0.05% fee — or the whole tx reverts.
21 saturnholders
Holder Rewards
Stake-to-earn a slice of swap fees via accumulator math, with pledge-locking that integrates the lending layer.
22 saturnstakearb
Stake-Arb
Bots flash-borrow idle staked capital, round-trip it across two pools and split the profit 50 / 50 with stakers.
DELTA // GEN I → GEN II
Axis SATRN v2 DEX v4
Architecture One monolith, ~1,300 lines 22 single-purpose contracts in 3 layers
Pools per pair One Unlimited — each with its own fee
Swap fee Unified 0.4% split Custom 0.3% – 30% per pool
LP position NFT per position + consolidation One NFT per pool
Fee accounting Inside the AMM Dedicated Fee Vault with redirect
Financial products — Bonds · rentals · options · syndicates · launchpad
Automation — Arb · limit orders · predictions · vaults · TWAMM · flash
Reentrancy Per-contract guard Centralized cross-contract guard
Saturn Lending — the credit layer
A full P2P lending protocol built on both DEX generations. Loans are TAZ-denominated, collateral is live LP — a v4 pool or a v3 LP NFT — and every asset prices through its RA-anchored pool. No external oracle.
Credit score 0 – 1000
On-chain creditworthiness built from account age, repayment history and streaks — the input to every loan term.
P2P marketplace
Borrowers post requests; lenders answer with direct quotes. Terms are agreed peer-to-peer, settled on-chain.
LP collateral vault
Pawn a v4 pool or a v3 LP NFT as collateral. Financial locks hold the position until the loan resolves.
Loan ledger
The state machine: draws, scheduled payments, defaults and liquidation — one auditable lifecycle per loan.
RA-anchor pricing
Every loan and collateral token prices through its RA-paired pool, on both DEX generations. No external oracle.
TAZ rewards
Fully repaid loans mint TAZ, split 30 / 30 / 40 across borrower, lender and RA pledgers — bounded, anti-abuse formula.
RA pledging
Vouch for lenders in 30-day locked windows — custodial for v3, stake-locked via holder rewards for v4.
Auto-lending (reserved)
Algorithmic term calculation, deployed with full ABI and deliberately disabled at v1.0 — the P2P market runs first.
TAZ REWARD SPLIT / REPAID LOAN
30%BORROWER
30%LENDER
40%RA PLEDGERS
Every input capped and floored — micro-loans, flash repays and self-pledges earn zero.
PLEDGE WINDOW
PLEDGE30 DAYS LOCKEDLIQUID
Pledges lock for a fixed 30-day window, then release instantly — no open-ended traps.
The machinery is live.
Swap, provide, lend and automate — every contract above is deployed on Phantasma.