Skip to content

minuterepeater7-hue/solword

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔤 SolWord - Daily Wordle with SOL Prize Pools

A revolutionary Solana-powered Wordle dApp where players compete for daily prize pools! Deposit SOL to play, solve the daily Wordle, and win proportional payouts based on your contribution percentage.

🎮 How It Works

  1. Deposit Entry Fee: Pay 0.001 SOL to enter the daily Wordle challenge
  2. Play Wordle: Solve the 5-letter word in 6 attempts or less
  3. Win Prizes: Winners receive proportional payouts based on their contribution to the total pool
  4. Daily Reset: New word and prize pool every day at midnight UTC

🚀 Features

  • 🎯 Daily Wordle Game: Classic 6-attempt word guessing with color-coded feedback
  • 💰 SOL Prize Pools: All entry fees go into a daily escrow - winners get proportional payouts
  • 🏆 Real-time Leaderboard: See all players, their contributions, and potential winnings
  • 💸 Winner Claims: Secure prize withdrawal system with transparent calculations
  • 🔐 Solana Integration: Built on Solana blockchain for fast, cheap transactions
  • 📱 Mobile Ready: Responsive design that works perfectly on all devices
  • 🎨 Beautiful UI: Modern, intuitive interface with smooth animations

🛠️ Tech Stack

  • Frontend: React + TypeScript + Vite
  • Blockchain: Solana Web3.js
  • Wallets: Solana Wallet Adapter
  • Styling: CSS3 with modern design patterns

📦 Installation

  1. Clone the repository:

    git clone <your-repo-url>
    cd solword
  2. Install dependencies:

    npm install
  3. Start the development server:

    npm run dev
  4. Open your browser and navigate to http://localhost:5173

🔧 Configuration

Solana CLI Setup

  1. Install Solana CLI (if not already installed):

    brew install solana
  2. Configure for Devnet:

    solana config set --url https://api.devnet.solana.com
  3. Get test SOL:

Wallet Setup

  1. Install Phantom Wallet:

  2. Switch to Devnet:

    • Open Phantom → Settings → Change Network → Devnet
    • Get test SOL from the faucet

🎮 Usage

  1. Connect Wallet: Click the wallet button and select your preferred wallet
  2. View Balance: See your SOL balance and wallet information
  3. Start Playing: Ready to build word games and earn rewards!

🏗️ Project Structure

solword/
├── src/
│   ├── components/
│   │   └── WalletInfo.tsx    # Wallet connection and balance display
│   ├── App.tsx               # Main application component
│   ├── App.css               # Styling
│   └── main.tsx              # Application entry point
├── public/                   # Static assets
└── package.json              # Dependencies and scripts

🏗️ Architecture

Smart Contract (Solana Program)

  • Daily Escrow System: Holds all SOL deposits for the day
  • Proportional Payouts: Winners receive prizes based on contribution percentage
  • Player Tracking: Records all players, contributions, and game results
  • Secure Distribution: Automated prize distribution to winners

Frontend Features

  • React + TypeScript: Modern, type-safe development
  • Solana Wallet Adapter: Seamless wallet integration
  • Real-time Updates: Live prize pool and leaderboard updates
  • Transaction Handling: Secure SOL deposits and prize claims

🎯 Game Mechanics

Entry Requirements

  • Entry Fee: 0.001 SOL per game
  • Daily Word: Same word for all players each day
  • Attempts: 6 guesses maximum
  • Winning: Solve the word to qualify for prizes

Prize Distribution

  • Proportional Payouts: Your prize = (Your Contribution / Total Winner Contributions) × Total Pool
  • Winner Only: Only players who solve the word receive prizes
  • Fair Distribution: Larger contributors get larger prizes
  • Daily Reset: Unclaimed prizes roll over to next day

🔮 Future Features

  • ✅ Word game mechanics
  • ✅ SOL token rewards
  • ✅ Smart contract integration
  • ✅ Leaderboards
  • USDC support for entry fees
  • NFT achievements for milestones
  • Multiplayer tournaments
  • Advanced analytics dashboard
  • Mobile app (PWA)
  • Social features and sharing

📚 Resources

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Submit a pull request

📄 License

MIT License - see LICENSE file for details


Happy coding! 🚀

About

Solana-powered Wordle dApp with daily prize pools

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published