⭐ STAR WORLD ORDER ⭐

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║   ✦ 𓆩 INSERT CARTRIDGE TO BEGIN 𓆪 ✦                          ║
║                                                              ║
║              🐸 + ⭐ = ACCESS GRANTED                         ║
║                                                              ║
║         chosen by the stars • the order is forming           ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

What is Star World Order?

Star World Order (SWO) — also known as The Cosmic Mandate — is an exclusive Sub-DAO for holders of Star Skrumpey NFTs on the Monad blockchain.

✦ chosen by the stars ✦

Star World Order combines retro N64 aesthetics with modern Web3 governance. Think of it as plugging in a cosmic cartridge: only those holding a Skrumpey with the rare Star constellation trait can access the DAO.

These 333 pixel art creatures are your key to the cosmic realm. No Star? The order awaits your return.

🔒 Access

To enter the Star World Order, you need:

• A Skrumpey NFT with the Star constellation trait (333 exist)

Regular Skrumpey holders cannot access DAO features. The Star trait is your cosmic key.

┌─────────────────────────────────────┐
│         ★ STAR SKRUMPEY ★           │
│                                     │
│            🐸 + ⭐                   │
│                                     │
│   your key to the cosmic realm      │
└─────────────────────────────────────┘

Star trait variants: aether, spectra, solveil, nebulu, chroma, rose, monflare, auracore, parallel, prime

🌐 IPFS Data Sources

Star Skrumpey metadata and images are stored on IPFS:

Metadata JSON:

• CID: bafybeibs4foulw6giemwwxwye2qtc3bd2lx34va6c3lpkjvsweevxudsjm
• URL Pattern: https://ipfs-proxy.magiceden.dev/ipfs/bafybeibs4foulw6giemwwxwye2qtc3bd2lx34va6c3lpkjvsweevxudsjm/{tokenId}

NFT Images:

• CID: bafybeig6jmjboqpx6puv4joxgzrzraqy7jdh63kf4dx6mupxhsl6lhr3cu
• URL Pattern: https://ipfs-proxy.magiceden.dev/ipfs/bafybeig6jmjboqpx6puv4joxgzrzraqy7jdh63kf4dx6mupxhsl6lhr3cu/{tokenId}.png

Example Metadata (Token #3189):

{
  "attributes": [
    { "value": "aroma", "trait_type": "aura" },
    { "value": "flora", "trait_type": "background" },
    { "value": "parallel", "trait_type": "constellation" },
    { "value": "dork", "trait_type": "eyes" },
    { "value": "super sayain", "trait_type": "form" },
    { "value": "drool", "trait_type": "mood" }
  ],
  "description": "A collection of 3,333 pixel art pfpNFTs capturing Monad's spirit. Created by melo.",
  "image": "ipfs://bafybeig6jmjboqpx6puv4joxgzrzraqy7jdh63kf4dx6mupxhsl6lhr3cu/3189.png",
  "name": "SKRUMP #3189"
}

🌟 Constellation Rarity Distribution

Constellation	Count	Rarity
aether	52	Common
spectra	52	Common
solveil	46	Uncommon
nebulu	44	Uncommon
chroma	42	Uncommon
rose	36	Rare
monflare	27	Rare
auracore	23	Epic
parallel	10	Legendary
prime	1	Mythic (1 of 1)

🎨 Star Constellation Colors

Each constellation has a unique visual appearance in the UI:

Constellation	Color Description
Spectra	Gradient: Turquoise → Light Blue → Purple → Yellow
Aether	Light Blue (#87CEEB)
Solveil	Yellow (#ffd700)
Nebulu	Purple (#9966ff)
Chroma	Light to Darker Purple Gradient
Rose	Pink (#FFB6C1)
Monflare	Glowing Purple (#9966ff with glow effect)
Auracore	Glowing Golden (#ffd700 with glow effect)
Parallel	Light Green-Blue to Darker Blue Gradient with White Stars
Prime	Golden (#ffd700)

✨ Features

🏛️ DAO Governance

• Proposals & Voting - Create and vote on governance proposals
• Simple Voting Power - 1 Star Skrumpey NFT = 1 Vote (hold 8 = 8 voting power)
• Treasury Management - Community-controlled DAO treasury
• Star Council Forum - Discussion threads auto-created with proposals

🔄 Cosmic Exchange (OTC Marketplace)

• Peer-to-Peer Trading - Trustless NFT marketplace for Star Skrumpeys
• Fixed-Price Listings - Set your own MON price
• DAO Fee - 2.5% supports treasury
• Filter & Sort - Find listings by price, variant, token ID

⭐ STAR Staking

• Earn STAR Tokens - 1 NFT = rewards per second (configurable)
• Time Multipliers - Longer stakes = higher rewards (up to 200%)
• Multiple Staking - Stake all your Star Skrumpeys at once
• No Lock Period - Instant unstaking available

🎮 Hangout Hub

• Retro Gaming Lobby - N64-inspired social space
• Chat Bubbles - Messages appear above avatars
• Voice Chat - Real-time voice communication
• Online Presence - See who's in the cosmic realm

🎰 Cosmic Raffle

• Exclusive Giveaways - Only Star Skrumpey holders can enter
• Tier-Based Entries - More Stars = more tickets (1-4 entries based on holdings)
• Bonus Entries - Extra tickets for Discord members and social engagement
• Verifiable Randomness - SHA-256 based winner selection with transparent seed
• Lottery Animations - Fun ticket animations when entering raffles

👥 Star Bearers (Members Page)

• Holder Leaderboard - Ranked list of Star Skrumpey holders
• Holder Count Chart - Live chart of unique holder count over time
• Time Range Toggle - Switch between 1H (hourly) and 1D (daily) views
• Constellation Filter - View holder counts for specific constellations (All, Aether, Spectra, etc.)
• Member Profiles - View holdings, badges, and constellation variants

📜 Smart Contracts

Star World Order uses custom Solidity contracts optimized for Monad's high-performance EVM. All contracts are open source and available in this repository.

StarSkrumpeyMarketplace.sol

OTC peer-to-peer marketplace for Star Skrumpey trading.

Features:

• Fixed-price listings with MON
• Atomic trustless swaps
• 2.5% DAO treasury fee
• Emergency pause controls
• ReentrancyGuard protection

Location: contracts/StarSkrumpeyMarketplace.sol

StarSkrumpeyStaking.sol

NFT staking system for earning STAR tokens.

Features:

• Configurable rewards per second
• Time-based multipliers (1 week to 1 year)
• Multiple NFT staking
• Emergency unstake with penalty

Location: contracts/StarSkrumpeyStaking.sol

StarWorldOrderGovernor.sol

DAO governance with proposal creation and voting.

Features:

• Simple voting power (1 Star Skrumpey = 1 Vote)
• Three-way voting (Yes/No/Abstain)
• Configurable voting period, delay, quorum
• Proposal lifecycle management

Location: contracts/StarWorldOrderGovernor.sol

🗳️ How Governance Works

Star World Order uses a secure Web2-powered governance system that verifies NFT ownership on-chain but stores votes off-chain for gas-free voting.

Voting Power

┌───────────────────────────────────────────────────────────────┐
│                    VOTING POWER                               │
├───────────────────────────────────────────────────────────────┤
│                                                               │
│   1 Star Skrumpey NFT  =  1 Vote                              │
│                                                               │
│   Example: Hold 8 Star Skrumpeys = 8 Voting Power             │
│                                                               │
│   Simple, fair, and transparent!                              │
│                                                               │
└───────────────────────────────────────────────────────────────┘

Governance Infrastructure

┌─────────────────────────────────────────────────────────────────────────────┐
│                      STAR WORLD ORDER GOVERNANCE                            │
├─────────────────────────────────────────────────────────────────────────────┤
│                                                                             │
│  ┌─────────────┐                                                            │
│  │   HOLDER    │  Connects wallet                                           │
│  │   WALLET    │──────────────────┐                                         │
│  └─────────────┘                  │                                         │
│                                   ▼                                         │
│                          ┌─────────────────┐                                │
│                          │   WEB APP       │                                │
│                          │   (Frontend)    │                                │
│                          └────────┬────────┘                                │
│                                   │                                         │
│           ┌───────────────────────┼───────────────────────┐                 │
│           │                       │                       │                 │
│           ▼                       ▼                       ▼                 │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐          │
│  │ 1. VERIFY NFT   │    │ 2. FETCH NONCE  │    │ 4. SUBMIT VOTE  │          │
│  │    OWNERSHIP    │    │    (Server)     │    │    + SIGNATURE  │          │
│  └────────┬────────┘    └────────┬────────┘    └────────┬────────┘          │
│           │                      │                      │                   │
│           ▼                      ▼                      ▼                   │
│  ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐          │
│  │   MONAD RPC     │    │   SQLITE DB     │    │  API SERVER     │          │
│  │   (On-chain)    │    │   (Nonces)      │    │  (Validation)   │          │
│  └─────────────────┘    └─────────────────┘    └────────┬────────┘          │
│                                                         │                   │
│                                                         ▼                   │
│                                                ┌─────────────────┐          │
│   ┌──────────────────────────────────────────▶│  SQLITE DB      │          │
│   │  3. SIGN VOTE                              │  (Votes Store)  │          │
│   │     (EIP-712)                              └─────────────────┘          │
│   │                                                                         │
│  ┌┴────────────────┐                                                        │
│  │  USER WALLET    │  Signs message (NOT a transaction)                     │
│  │  (MetaMask etc) │  NO gas fees required                                  │
│  └─────────────────┘                                                        │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

Security Features

Security Layer	Description
On-Chain NFT Verification	Ownership verified via Monad RPC multicall
Server-Issued Nonces	Prevents replay attacks, expires after 10 minutes
EIP-712 Signatures	Cryptographically signed votes prove voter intent
Single-Use Nonces	Each nonce can only be used once
No Gas Fees	Message signatures don't require transactions

Voting Flow

1. Connect Wallet - User connects their wallet to Star World Order
2. NFT Verification - System checks Star Skrumpey ownership on Monad blockchain
3. Request Nonce - Server issues a unique, time-limited nonce
4. Sign Vote - User signs their vote choice with their wallet (no gas)
5. Submit Vote - Signed vote is submitted to the API
6. Validation - Server verifies signature, nonce, and NFT ownership
7. Record Vote - Vote is stored securely in the database

Three-Way Voting

• ✓ YES - Vote in favor of the proposal
• ✕ NO - Vote against the proposal
• ◯ ABSTAIN - Participate without taking a side (counts toward quorum)

Quorum Requirements

Requirement	Threshold	Description
Minimum Voters	10	At least 10 unique wallets must vote
Approval	60%	YES votes must be ≥60% of all votes
Abstain Cap	30%	Proposal fails if ABSTAIN exceeds 30%

Forum Integration

When a governance proposal is created, a discussion thread is automatically created in the Star Council forum, allowing the community to discuss proposals before and during voting.

🔗 Links

• Website: https://starworldorder.com
• Twitter: https://x.com/StrWorldOrder
• Skrumpeys: https://x.com/skrumpeys
• Monad Explorer: https://monadscan.com
• GitHub: https://github.com/InverseAltruism/Star-World-Order

🛠️ Tech Stack

• Blockchain: Monad (Chain ID: 143)
• Frontend: Next.js 16, React 19, TypeScript
• Styling: Tailwind CSS 4, Synthwave theme
• Web3: Wagmi 3, Viem 2
• Contracts: Solidity 0.8.20, OpenZeppelin 5.x
• Database: SQLite (better-sqlite3)
• Font: Press Start 2P (Retro Pixel)

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Copyright (c) 2025 Star World Order Contributors

---

╔══════════════════════════════════════════════════════════════╗
║                                                              ║
║   ✦ 𓆩 STAR WORLD ORDER 𓆪 ✦                                   ║
║                                                              ║
║   chosen by the stars • the order is forming • @skrumpeys    ║
║                                                              ║
╚══════════════════════════════════════════════════════════════╝

For Developers: See CLAUDE.md for comprehensive technical documentation including deployment, database schemas, API endpoints, and more.