
ETH Shot ๐ฏ
A viral Ethereum-powered game where users pay 0.0005 ETH per shot for a 1% chance to win the jackpot.
๐ฎ Game Overview
ETH Shot is a decentralized gambling game built on Ethereum where players take shots at winning the jackpot. Each shot costs 0.0005 ETH with a 1% chance of winning the entire pot. The game features real-time updates, social sharing, sponsor integration, and a viral referral system with discount rewards.
โจ Features
๐ฏ Smart Contract Game: Built on Ethereum with provably fair 1% win probability
๐ฐ Dynamic Jackpot: Pot grows with each shot, 90% goes to winner
๐ Wallet Integration: Connect with MetaMask, WalletConnect, and other Web3 wallets
โก Real-time Updates: Live pot updates and winner announcements via Supabase
โฐ Cooldown System: 1-hour cooldown between shots per wallet address
๐ช Sponsor Rounds: Businesses can sponsor rounds for 0.001 ETH with custom branding
๐ฏ Referral System: Invite friends and earn discount rewards for viral growth
๐ฐ Discount Rewards: 20% discounts on shots earned through referrals with 30-day expiration
๐ฑ Social Sharing: Share wins and referral links on Twitter
๐จ Winner Animations: Confetti and celebration effects for jackpot wins
๐ Leaderboards: Track top players, recent winners, and referral champions
๐ฑ Responsive Design: Optimized for desktop and mobile devices
๐ Tech Stack
Smart Contract
Solidity: Smart contract development
OpenZeppelin: Security libraries (ReentrancyGuard, Pausable, Ownable)
Hardhat: Development environment and testing
Frontend
SvelteKit: Modern web framework with SSR
Vite: Fast build tool and dev server
Tailwind CSS: Utility-first CSS framework
Ethers.js v6: Ethereum interaction library
Web3Modal: Multi-wallet connection
Backend & Database
Supabase: PostgreSQL database with real-time subscriptions
Real-time subscriptions: Live updates for winners, shots, and sponsors
Testing & Quality
Mocha + Chai: JavaScript testing framework
Hardhat: Smart contract testing
ESLint + Prettier: Code formatting and linting
Sinon: Mocking and stubbing for tests
Deployment
Vercel: Frontend hosting and deployment
Sepolia Testnet: Ethereum testnet for testing
๐ Quick Start
Prerequisites
Node.js 20+
pnpm (recommended) or npm
MetaMask or other Web3 wallet
Infura/Alchemy API key
Supabase account
Installation
Clone the repository:
Install dependencies:
Set up environment variables:
Edit
.env with your configuration:Start the development server:
Open http://localhost:5173 in your browser.
๐ Smart Contract
The game is powered by a Solidity smart contract with the following specifications:
Game Mechanics
Shot Cost: 0.0005 ETH per shot (0.0004 ETH with 20% referral discount)
Win Probability: 1% chance to win the jackpot
Payout Split: 90% to winner, 10% to contract owner
Cooldown Period: 1 hour (3600 seconds) between shots per wallet
Sponsor Cost: 0.001 ETH to sponsor a round with custom branding
Referral Discounts: 20% discount for both referrer and referee
Key Functions
takeShot(): Take a shot at the jackpot (payable)sponsorRound(string name, string logoUrl): Sponsor a round (payable)getCurrentPot(): Get current jackpot amountgetPlayerStats(address): Get player statisticscanTakeShot(address): Check if player can take a shotgetCooldownRemaining(address): Get remaining cooldown timeSecurity Features
ReentrancyGuard: Prevents reentrancy attacks
Pausable: Emergency pause functionality
Ownable: Access control for admin functions
Randomness: Uses block hash and timestamp for randomness
๐งช Testing
Run Smart Contract Tests
Run Frontend Tests
Run All Tests
Test Coverage
๐ Deployment
1. Smart Contract Deployment
Deploy to Sepolia Testnet:
Verify Contract on Etherscan:
2. Database Setup
Create a new Supabase project
Run the SQL schema from
supabase/schema.sqlConfigure Row Level Security (RLS) policies
Update environment variables with Supabase credentials
3. Frontend Deployment
Deploy to Vercel:
Environment Variables in Vercel:
VITE_CONTRACT_ADDRESSVITE_RPC_URLVITE_SUPABASE_URLVITE_SUPABASE_ANON_KEYVITE_APP_URLVITE_NETWORK_NAMEVITE_CHAIN_ID๐ Database Schema
The application uses Supabase PostgreSQL with the following tables:
shots: Records all shot attempts with discount tracking
winners: Tracks jackpot winners
sponsors: Manages sponsorship rounds
players: Player statistics and rankings
referral_codes: User referral codes for viral growth
referrals: Tracks referral relationships
referral_discounts: Manages discount rewards and usage
Real-time subscriptions provide live updates for:
New winners
Shot attempts
Sponsor activations
๐จ Components
Core Components
GameButton: Main "Take the Shot" button with loading states
PotDisplay: Real-time jackpot amount display
WalletConnect: Multi-wallet connection interface
WinnerAnimation: Confetti and celebration effects
Leaderboard: Top players and statistics
RecentWinners: Live winner feed
SponsorBanner: Sponsor branding display
ReferralSystem: Referral code management and sharing
DiscountButton: Apply referral discounts to shots
ReferralLeaderboard: Top referrers and statistics
Stores (State Management)
gameStore: Game state, contract interactions, database integration
walletStore: Wallet connection and Web3 functionality
toastStore: User notifications and feedback
๐ง Development Scripts
๐จ Security Considerations
Smart Contract Security
Audited Libraries: Uses OpenZeppelin's battle-tested contracts
Reentrancy Protection: ReentrancyGuard prevents reentrancy attacks
Access Control: Ownable pattern for admin functions
Emergency Pause: Pausable functionality for emergency stops
Input Validation: Proper validation of all inputs
Frontend Security
Environment Variables: Sensitive data stored in environment variables
HTTPS Only: All production traffic over HTTPS
Content Security Policy: Implemented via Vercel headers
XSS Protection: Framework-level XSS protection
๐ Performance Optimizations
Database Indexing: Optimized queries with proper indexes
Real-time Subscriptions: Efficient WebSocket connections
Caching: Strategic caching of contract calls
Code Splitting: Lazy loading of components
Image Optimization: Optimized assets and images
๐ค Contributing
Fork the repository
Create a feature branch:
git checkout -b feature/amazing-featureMake your changes
Add tests for new functionality
Run the test suite:
pnpm test:allCommit your changes:
git commit -m 'Add amazing feature'Push to the branch:
git push origin feature/amazing-featureSubmit a pull request
Development Guidelines
Follow the existing code style
Write tests for new features
Update documentation as needed
Use conventional commit messages
๐ License
This project is licensed under the MIT License - see the LICENSE file for details.
โ ๏ธ Disclaimer
Important: This is a game of chance involving real cryptocurrency. Please consider the following:
Gambling Risk: Only gamble with funds you can afford to lose
Smart Contract Risk: Smart contracts may contain bugs or vulnerabilities
Regulatory Compliance: Ensure compliance with local gambling laws
No Guarantees: No guarantees of winnings or returns
Educational Purpose: This project is primarily for educational purposes
๐ Support
Documentation: Check this README and inline code comments
Issues: Report bugs via GitHub Issues
Discussions: Join discussions in GitHub Discussions
Community: Follow updates on Twitter @profullstackinc
Discord: Join our community on Discord
๐ฏ Roadmap
Phase 1 (Current)
Core game mechanics
Smart contract deployment
Frontend application
Database integration
Real-time updates
Phase 2 (Planned)
Mobile app development
Advanced analytics dashboard
NFT rewards for winners
Referral system with discount rewards
Multiple game modes
Phase 3 (Future)
Layer 2 integration (Polygon, Arbitrum)
DAO governance
Tournament system
Cross-chain compatibility
Built with โค๏ธ by the ETH Shot team
0 likes ยท 20 views ยท Sep 26, 2025
Developed a viral Ethereum-powered gambling game with real-time updates and social sharing features.
Timeline
Aug 1, 2025 - Sep 30, 2025