Coinsweeper is play-to-earn game with Fully Homomorphic Encryption (FHE) integration using the Zama protocol. Players find coins, with encrypted token rewards and confidential blockchain interactions powered by Zama's relayer network.
- Three difficulty levels: Easy (8x8), Medium (16x16), Hard (16x30)
- Real-time timer and flag placement
- Responsive design for all devices
- Encrypted ERC20 tokens for rewards using Zama's FHE protocol
- Confidential leaderboard with encrypted scores
- Private token transfers via Zama relayer network
- Secure reward distribution with encrypted balances
- Homomorphic operations on encrypted data
- Cross-network FHE support (works on all EVM networks)
- MetaMask wallet connection
- Sepolia testnet deployment for development and testing
- Blockchain game recording (starts, wins, losses)
- Encrypted token management
- Real-time blockchain stats
- Node.js 16+ and npm
- MetaMask browser extension
- Git
-
Clone the repository
git clone <repository-url> cd coinsweeper
-
Install dependencies
npm install
-
Start the development server
npm start
-
Open your browser Navigate to
http://localhost:3000
Create a .env file in the root directory:
PRIVATE_KEY=your_private_key_here
SEPOLIA_RPC_URL=your_sepolia_rpc_url
ETHERSCAN_API_KEY=your_etherscan_api_key# Deploy Zama FHE contracts to Sepolia testnet
npm run deployNote: Full FHE features require the Fhenix network. Sepolia deployment is for development and testing purposes.
The contracts have been deployed to Sepolia testnet:
EncryptedERC20 Token (CSR)
- Address:
0x27eB7fC7F852e83c53D897F938443d722ab3b54E - Name: CoinSweeper Rewards
- Symbol: CSR
- Decimals: 6
- Purpose: Encrypted ERC20 token for game rewards using Zama FHE
CoinSweeper Game Contract
- Address:
0xB45D181c2F51700a489754993D9E2A0F6032504F - Purpose: Main game contract that manages gameplay, rewards, and leaderboard
- Features:
- Game statistics tracking
- Encrypted reward distribution
- Difficulty multipliers
- Leaderboard management
Contract Links:
Update Frontend Configuration:
After deployment, update the contract addresses in src/types/web3.ts:
export const CONTRACT_ADDRESSES = {
sepolia: '0xB45D181c2F51700a489754993D9E2A0F6032504F'
};- Privacy-preserving token with encrypted balances
- Confidential transfers via Zama relayer network
- Secure minting for game rewards
- Homomorphic operations on encrypted data
- Encrypted scores stored on-chain
- Private rankings without revealing exact values
- Secure comparisons using Zama FHE operations
- Encrypted reward tracking
- Confidential win/loss records
- Secure difficulty multipliers
- Decentralized FHE processing
- Cross-network compatibility
- Privacy-preserving computations
- Scalable encrypted operations
- Connect Wallet: Click "Connect Wallet" and approve MetaMask connection
- Choose Difficulty: Select Easy, Medium, or Hard
- Start Playing:
- Left-click to reveal cells
- Right-click to place/remove flags
- Find all coins without clicking on them
- Earn Rewards: Win games to earn encrypted tokens
- View Stats: Check your encrypted balance and leaderboard position
| Network | Chain ID | Zama FHE Support | Status |
|---|---|---|---|
| Sepolia Testnet | 11155111 | Development | |
| Localhost | 31337 | Development |
EncryptedERC20.sol: Zama FHE-enabled ERC20 tokenCoinSweeper.sol: Main game contract with Zama FHE integration
CoinsweeperGame.tsx: Main game componentFHETokenInfo.tsx: Zama FHE token information displayWalletConnect.tsx: MetaMask integrationBlockchainStats.tsx: Blockchain statistics
zamaFHE.ts: Zama relayer SDK integrationWeb3Context.tsx: React context for Web3 stateweb3Utils.ts: Zama FHE and blockchain utilitiesweb3.ts: TypeScript types and ABIs
# Start development server
npm start
# Build for production
npm run build
# Run tests
npm test
# Compile contracts
npx hardhat compile
# Run contract tests
npx hardhat test
# Deploy contracts
npm run deploy
# Verify contracts
npm run verify <contract_address> <constructor_args>coinsweeper/
├── host-contracts/ # Smart contracts
│ ├── CoinSweeper.sol # Main game contract
│ └── EncryptedERC20.sol # Zama FHE token contract
├── src/
│ ├── components/ # React components
│ ├── contexts/ # React contexts
│ ├── types/ # TypeScript types
│ ├── utils/ # Utility functions
│ │ └── zamaFHE.ts # Zama FHE integration
│ └── ...
├── scripts/ # Deployment scripts
├── test/ # Contract tests
└── public/ # Static assets
- Zama FHE encryption for all sensitive data
- Reentrancy protection in smart contracts
- Access control with Ownable pattern
- Input validation and error handling
- Secure random number generation
- Privacy-preserving computations
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
- Zama AI for the FHE protocol and relayer SDK
- OpenZeppelin for secure smart contract libraries
- Hardhat for development framework
- React and TypeScript for the frontend
- Zama Documentation: docs.zama.ai/protocol
- Relayer SDK Guide: docs.zama.ai/protocol/relayer-sdk-guides/development-guide/webapp
- Community: Zama Discord
🎉 Ready to experience the future of privacy-preserving gaming with Zama FHE!