╔═══════════════════════════════════════════════════════════╗
║                                                           ║
║    ██████╗ ███████╗███████╗███████╗██████╗  █████╗ ███╗  ║
║    ██╔══██╗██╔════╝██╔════╝██╔════╝██╔══██╗██╔══██╗████╗ ║
║    ██████╔╝█████╗  █████╗  █████╗  ██████╔╝███████║██╔██╗║
║    ██╔══██╗██╔══╝  ██╔══╝  ██╔══╝  ██╔══██╗██╔══██║██║╚██║
║    ██║  ██║███████╗██║     ███████╗██║  ██║██║  ██║██║ ╚██║
║    ╚═╝  ╚═╝╚══════╝╚═╝     ╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝
║                                                           ║
║           REFERANDIUM - Policy Prescription Markets      ║
║                                                           ║
╚═══════════════════════════════════════════════════════════╝

The World's First Policy Prescription Market on Solana

Don't predict the future. Prescribe it.

🌐 Live App • 📖 Documentation • 🐦 Twitter • 💊 RFRM Token

---

🎯 What is Referandium?

Referandium is NOT a prediction market. We don't ask you to gamble on outcomes.

Instead, Referandium is a Policy Prescription Market where communities signal what SHOULD happen, not what will happen. By depositing SOL into markets, users prescribe future outcomes while earning yield on their principal.

Key Differentiator:

• ❌ Prediction Markets: Bet on outcomes, lose if wrong
• ✅ Prescription Markets: Signal demand, principal always returned + yield share

Your SOL is locked in escrow, earns yield, and is returned 100% when the market closes—plus your share of the yield earned.

---

✨ Key Features

🎯 Policy Prescription Markets

Signal YES or NO on future outcomes with SOL. Markets generate yield while your SOL is locked. Get your principal back + 45% of total yield.

🍪 Gookie NFT Auction System

Rent market manager NFTs by bidding RFRM tokens. Winners manage markets, promote them, and earn 30% of yield in RFRM.

💰 Yield-Based Rewards

SOL locked in escrow earns yield automatically. When markets close, yield is distributed:

• 45% to signal providers (you!)
• 30% to Gookie managers (RFRM)
• 20% to platform
• 5% buyback & burn RFRM

🔒 On-Chain Escrow

Three Solana smart contracts handle all transactions:

• Market escrow for signals
• Gookie auctions for NFTs
• Learning Hub subscriptions

🎓 Learning Hub

Lock $25/month worth of RFRM to access premium courses, trading strategies, and market analysis. Unlock anytime.

🌍 Multi-Language & Dark Mode

Full support for English 🇺🇸 and Turkish 🇹🇷. Beautiful dark/light theme with responsive design.

---

🚀 Deployed Smart Contracts

All contracts live on Solana Devnet:

Contract	Program ID	Network
Market Escrow	Aby8pc1zLWbKUPgPzgh4ntbkTsbPaZWb6FyuxSwtkR8e	Devnet
Gookie Auction	3VkzfA6GU6VhMdEnYRJywLLEQ454B9gmQoNh4ycVFFS5	Devnet
Learning Subscription	FUTVzQF86UckN9KhyuRajM4xRsYS62f24hTbJqGkZxed	Devnet

Built with: Anchor 0.32.1, Rust 1.91.1

---

� RFRM Token

Mint Address: 8248ZQSM717buZAkWFRbsLEcgetSArqbpbkX638Vpump

Utility:

• 🎫 Gookie Bids: Lock RFRM to bid on market manager NFTs
• 🎓 Learning Hub: Lock for premium content access
• 💳 Fee Payments: Pay platform fees with discounts (future)
• 🔥 Buyback & Burn: 5% of yield used to buy & burn RFRM

Tokenomics:

• Total Supply: 1,000,000,000 RFRM
• Trade on: pump.fun
• Deflationary mechanism via buyback & burn

---

🔄 How It Works

3 Simple Steps:

1️⃣  Connect Wallet
    ↓
    Connect Phantom, Solflare, or any Solana wallet

2️⃣  Signal Your Demand
    ↓
    Deposit SOL to signal YES or NO
    Your principal is locked safely on-chain

3️⃣  Earn Yield
    ↓
    Market closes → Get your SOL back + 45% of yield earned
    No risk to principal!

---

💸 Fee Distribution

When markets close, yield is distributed automatically:

Recipient	Share	Currency	Purpose
Signal Providers	45%	SOL	Your share of the yield
Gookie Manager	30%	RFRM	Market operator reward (via Jupiter swap)
Platform	20%	SOL	Development & operations
Buyback & Burn	5%	RFRM	Permanent supply reduction

Example:

• 100 SOL locked generates 5 SOL yield
• You deposited 10 SOL → Receive 10 SOL + 0.225 SOL yield back
• Gookie earns 1.5 SOL worth of RFRM
• Platform takes 1 SOL
• 0.25 SOL buys & burns RFRM

---

🛠 Tech Stack

Category	Technology
Frontend	Next.js 14 (App Router), React 18, TypeScript
Styling	Tailwind CSS, next-themes
Blockchain	Solana, Anchor 0.32.1, @solana/wallet-adapter
Smart Contracts	Rust 1.91.1, Anchor Framework
Database	Supabase (PostgreSQL with Row-Level Security)
Token Swaps	Jupiter Aggregator
Hosting	Netlify (Frontend), Solana Devnet (Contracts)
Wallets	Phantom, Solflare, Backpack

---

🚀 Getting Started

Prerequisites

• Node.js v18+ (Download)
• Rust 1.91.1+ (Install)
• Anchor CLI 0.32.1+ (Install)
• Solana CLI (Install)
• Phantom Wallet (Download)

1. Clone the Repository

git clone https://github.com/ReferandiumProject/Referandium.git
cd Referandium-Project

2. Install Frontend Dependencies

cd frontend
npm install

3. Set Up Environment Variables

Create .env.local in frontend/:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

# Solana
NEXT_PUBLIC_SOLANA_RPC_URL=https://api.devnet.solana.com

4. Run Development Server

npm run dev

Open http://localhost:3000

5. Build & Deploy Smart Contracts (Optional)

cd backend
anchor build
anchor deploy --provider.cluster devnet

---

📁 Project Structure

Referandium-Project/
├── frontend/
│   ├── app/
│   │   ├── components/       # UI components
│   │   ├── context/          # React contexts (Language, User, Theme)
│   │   ├── utils/            # Contract integrations & helpers
│   │   ├── market/[id]/      # Market detail pages
│   │   ├── gookies/[id]/     # Gookie auction pages
│   │   ├── learning/         # Learning Hub
│   │   └── admin/            # Admin dashboard
│   ├── pages/docs/           # MDX documentation (Nextra)
│   └── public/               # Static assets
├── backend/
│   ├── programs/
│   │   ├── referandium/      # Main program (legacy)
│   │   ├── gookie/           # Gookie auction contract
│   │   ├── market_escrow/    # Market escrow contract
│   │   └── subscription/     # Learning subscription contract
│   └── target/idl/           # Generated IDLs
├── database/
│   └── schema/               # Supabase migrations
└── README.md

---

📖 Documentation

Comprehensive documentation available at referandium.com/docs:

• Introduction - What is Referandium?
• Tokenomics - Fee structure & yield distribution
• Gookies - NFT auction system
• RFRM Token - Token utility & buyback
• Learning Hub - Premium content access
• Architecture - Technical deep dive

---

� Links

• 🌐 Live App: referandium.com
• 📖 Documentation: referandium.com/docs
• 🐦 Twitter: @ReferandiumIO
• 💬 Discord: Join Community
• 💊 RFRM Token: pump.fun
• 📊 Chart: DexScreener

---

🤝 Contributing

Contributions are welcome! We're building the future of decentralized policy markets.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Areas for contribution:

• Frontend UX improvements
• Smart contract optimizations
• Documentation updates
• Bug fixes & testing
• New market categories

---

📄 License

This project is licensed under the MIT License. See LICENSE for details.

---

� Acknowledgments

Built on the shoulders of giants:

• Solana - High-performance blockchain
• Anchor - Solana smart contract framework
• Next.js - React framework for production
• Supabase - Open-source Firebase alternative
• Jupiter - Solana's liquidity aggregator

---

The future isn't predicted. It's prescribed.

Built with 🍪 on Solana