Skip to content
View yugidex's full-sized avatar

Block or report yugidex

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
yugidex/README.md

YUGIDEX

The Yu-Gi-Oh Themed Solana NFT Collection Game 🃏

YUGIDEX Logo

$SUMMON | yugidex.fun

License: MIT Platform: Solana Status: Pre-Launch

Hold $SUMMON → spend supply as a voucher → claim deck packs → build battle decks → enter PvP arena.

📖 What is YUGIDEX?

YUGIDEX is a hybrid memecoin and on-chain gaming protocol on the Solana blockchain. It transforms the classic pack-opening and card-battling experience into a fully decentralized, frictionless economy. Instead of burning your tokens to buy NFTs, your $SUMMON balance acts as a permanent "voucher." The more supply you hold, the higher the tier of card packs you can claim.

⚙️ Core Mechanics

Feature Description
Voucher Allocation $SUMMON tokens remain fully liquid in your wallet. Claiming decks "locks" a percentage of your supply off-chain.
cNFT Minting All cards are Metaplex Bubblegum compressed NFTs (cNFTs). Trading is fully supported on Tensor and Magic Eden.
Deck Builder Curate your collection into 40-card competitive decks. Max 3 active decks per wallet.
Sell-out Reconciliation If your token balance drops below your locked threshold, battle access is revoked until the deficit is cleared or cards are burned.

🎴 Deck Tiers & Drop Rates

All decks contain 40 random cards. The tier determines the rarity probability distribution.

Deck Tier Cost (% Supply) Drop Probabilities
BASIC 0.1% 80% C · 15% R · 4.5% SR · 0.4% UR · 0.1% L
STANDARD 0.25% 60% C · 25% R · 10% SR · 4% UR · 1% L
PREMIUM 0.5% 40% C · 30% R · 20% SR · 8% UR · 2% L
ELITE 1.0% 25% C · 30% R · 25% SR · 15% UR · 5% L
PHARAOH 2.0% 10% C · 20% R · 30% SR · 25% UR · 15% L (+1 God)

🏗️ Architecture

┌─────────────────┐       ┌──────────────────┐       ┌─────────────────┐
│                 │       │                  │       │                 │
│  User Wallet    │──────▶│  YUGIDEX Web UI  │──────▶│ PostgreSQL (DB) │
│  (Phantom)      │       │  (Next.js)       │       │ (Off-chain)     │
│                 │       │                  │       │                 │
└────────┬────────┘       └─────────┬────────┘       └────────┬────────┘
         │                          │                         │
         ▼                          ▼                         ▼
┌─────────────────┐       ┌──────────────────┐       ┌─────────────────┐
│                 │       │                  │       │                 │
│  Solana L1      │◀──────│ Custodial Engine    │──────▶│ WebSocket Server│
│  (Bubblegum)    │       │ (Ranked Battles) │       │ (Matchmaking)   │
│                 │       │                  │       │                 │
└─────────────────┘       └──────────────────┘       └────────┬────────┘
                                                              │
                                                              ▼
                                                     ┌─────────────────┐
                                                     │ Secure Off-chain RNG │
                                                     │ (On-chain RNG)  │
                                                     └─────────────────┘

🛠️ Tech Stack

Layer Technology Purpose
Frontend Next.js, TailwindCSS App UI, Deck Builder, Claim Interface
Database PostgreSQL Off-chain allocations, ELO, XP, Match History
Smart Contracts Node.js (Backend) Ranked SOL custodial wallets, Payouts
NFT Standard Metaplex Bubblegum Low-cost compressed NFT generation
Real-time Node.js + Socket.IO Matchmaking queue, battle rounds
RNG Secure Off-chain RNG Trustless deck shuffling
RPC/Indexing Helius DAS API Wallet asset tracking

🗺️ Phased Roadmap

  • Phase 1: Domain & Social Capture (yugidex.fun, Telegram, X).
  • Phase 2: Visual Identity & Art Curation (YGOPRODeck API, IPFS hosting).
  • Phase 3: Token Launch ($SUMMON on Pump.fun) & Basic Claim UI.
  • Phase 4: Battle Arena Beta (PvE Practice bots, Off-chain logic).
  • Phase 5: Ranked PvP & Wager Mode (Secure Off-chain RNG + Custodial Engine).

🔗 Reference Links

Resource Link
Website yugidex.fun
Documentation Whitepaper
Twitter / X @yugidexfun
Telegram t.me/yugidex

Built for the Solana ecosystem. Not affiliated with Konami. This is a Web3 homage.

Pinned Loading

  1. yugidex yugidex Public

    The core backend infrastructure and architecture for YUGIDEX, including the Custodial backend and system design documents.

  2. yugidex-api yugidex-api Public

    TypeScript SDK and API documentation for interfacing with the YUGIDEX off-chain infrastructure, matchmaking WebSocket, and deck builders.

    TypeScript