Skip to content

InverseAltruism/Star-World-Order

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

585 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⭐ 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

  • Two Raffle Types:
    • Star-Only Raffles - Exclusive to Star Skrumpey holders (1-4 entries based on tier)
    • Public Raffles - Open to all Skrumpey holders (1 entry per Skrumpey + Star holder bonus)
  • Tier-Based Entries - Star holders get tier bonuses (Star Forged +1, Warden +2, Lord +3, Emperor +4)
  • Bonus Entries - Extra tickets for social engagement (Like & RT)
  • Verifiable Randomness - SHA-256 based winner selection with transparent seed
  • Entry Breakdown - Click your tier to see exactly how entries are calculated

👥 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

🛠️ 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)
  • Floor Prices: Local ME Scraper API (auto-updates every 30 min)
  • 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.

About

TBD

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors