Whitepaper
A technical book for a living settlement economy.
The whitepaper is organized as a set of engineering chapters. Each chapter links narrative intent to trust boundaries, contract surfaces, operating assumptions, and failure modes.
CHAPTER
Vision
Wardenseed is an economic civilization with a game surface: a persistent forest where memory, scarcity, lineage, and settlement are designed as one system. The product is not trying to make every tree-care action an on-chain transaction. The high-conviction design is separation of concerns: the world evolves in USK/Postgres where simulation can remain fast, replayable, and repairable; ownership, settlement, treasury flow, and public proof live on chain where cryptographic finality matters. This makes the fantasy surface credible because the narrative maps to real operational boundaries.
Read chapter →
CHAPTER
Architecture
The architecture is a three-boundary model: simulation truth, Base execution, and Ethereum L1 notarization. USK computes raw state from game and economy events. Prisma/Postgres stores player sessions, trees, seeds, resources, SEEDOS ledger entries, market listings, and settlement batches. Base handles Seed NFT minting, signed marketplace fills, SEEDOS settlement, staking, LP telemetry, and governance execution. Ethereum L1 anchors sparse raw roots so the protocol can prove historical checkpoints without pushing hot gameplay paths into L1 gas.
Read chapter →
CHAPTER
Economic Model
SEEDOS emission is epoch-based, sink-aware, capped, and guarded by GEO rather than minted per action. The economy distinguishes Essence-like gameplay credits, SEEDOS hard-layer settlement, Seed NFT ownership, treasury ETH, and protocol fees. Emission is not a blind faucet: cap-engine, dynamic inflation feedback, sink pressure, staking ratios, ecosystem stress, velocity, and emergency clamps all shape how much SEEDOS can move from ledger to chain in a settlement epoch.
Read chapter →
CHAPTER
Settlement
Settlement compresses many off-chain economic actions into replay-protected SEEDOS batches on Base. The settlement engine collects unsettled `WardLedger` mint entries, computes canonical hashes, builds `capStateHash`, `indexerSnapshotHash`, `ueiHash`, and a batch identity, then persists a `WardSettlementBatch`. The worker submits the batch only if launch controls, GEO circuit flags, and emission caps allow it. The SEEDOS contract rejects duplicate batch IDs and enforces max supply.
Read chapter →
CHAPTER
GEO
GEO is the risk governor for the living economy: UEI, circuit posture, pressure, volatility, and control bands. The Global Economic Orchestrator turns ecosystem pressure into operational posture. It can reduce emission capacity, pause minting, freeze settlement, or mark the system as stressed when volatility, whale concentration, oracle desync, mint spikes, or LP drain cross thresholds. This is not flavor text; it is the protocol's nervous system.
Read chapter →
CHAPTER
Seed Layer
Seeds are the collectible entry layer: capped ERC-721 assets tied to provenance, launch access, and future lineage surfaces. The Seed layer combines a fixed supply, Dutch pricing, market pressure updates, whitelist/reveal controls, royalties, and secondary liquidity. It should feel like a high-end collectible access layer, not a casino. Seeds do not replace gameplay truth; they create ownership, provenance, and future utility around the civilization.
Read chapter →
CHAPTER
Governance
Governance is bounded coordination, not an all-powerful DAO switch. The production direction replaces self-declared voting weights with snapshot weights derived from staked SEEDOS, capped Seed holder bonus, and governance reputation. Governance can tune bands and policy surfaces, but it must not arbitrarily mint, drain treasury, or rewrite anchors. Timelock execution gives users time to inspect changes before they land.
Read chapter →
CHAPTER
Security
Security is a product surface: roles, pausing, replay protection, circuit breakers, and incident response must be legible. Wardenseed's security model prioritizes role separation, max-supply enforcement, duplicate batch rejection, signed marketplace order replay protection, authorized anchors, pause controls, and treasury delay. The system is not audit-complete just because it has contracts; it becomes credible when roles, tests, docs, and runbooks are visible.
Read chapter →
CHAPTER
Treasury
Treasury is the economic runway and risk buffer, not a hidden team wallet. Revenue can flow from primary Seed mint, secondary royalties, protocol fees, LP fees, and future ecosystem surfaces. The production posture routes treasury movement through a timelock/governor and multisig model. Treasury communications should explain what funds support: security, liquidity, infrastructure, audits, reserves, and ecosystem maintenance.
Read chapter →
CHAPTER
Roadmap
The roadmap is security-gated: launch only moves forward when settlement, treasury, governance, and proof surfaces survive review. Wardenseed should avoid fake quarter hype. A credible roadmap separates completed foundation, active production hardening, Seed drop readiness, Base mainnet settlement, governance maturation, marketplace evolution, and ecosystem expansion. Research items stay labeled as research until implemented and tested.
Read chapter →