WorldCoins

WorldCoins is a deterministic memecoin built exclusively for World Chain that leverages World ID to ensure one claim per verified human. The concept is simple but powerful: users pay exactly 1 WLD token to claim 100 WLC (WorldCoins) tokens, with no gambling or randomness involved. The project solves the common problem of bot farming and multiple claims in token distributions by using World ID's biometric verification system. Each person can only claim once, ever, using their unique World ID proof. This creates a fair distribution mechanism where verified humans get equal access to the token. The entire experience happens natively on World Chain, taking advantage of free gas for verified humans and the native WLD token availability. Users connect their wallet, verify their World ID through the IDKit widget, approve the WLD spend, and execute the claim transaction to receive their 100 WLC tokens. After claiming, users can trade their WLC tokens on Uniswap V3 pools deployed on World Chain, with the mini app providing direct deep-links to the trading interface.

Smart Contracts (Solidity + Foundry): WorldCoinsFactory.sol: Factory pattern with one-token-per-user creation, one-claim-per-user-per-token WorldCoinToken.sol: ERC20 with fixed tokenomics (1M max, 50 per claim, 5K to creator) Built dual architecture: LayerZero cross-chain + World Chain native versions Frontend (Next.js + Web3): wagmi v2 + viem for contract interactions MiniKit integration for World App authentication + World ID verification Real-time token listing and claiming interface Key Technical Implementations: Gasless UX: World Chain's gas sponsorship = $0 transactions for verified humans Factory pattern: Users create tokens, others claim from any token (prevents centralization) Server-side verification: /api/verify-and-mint validates World ID proofs before contract calls Environment-aware: Works in World App and regular browsers with graceful fallbacks Notable Solutions: Combined World ID verification with wallet auth in single flow Contract address extraction from transaction logs for real-time updates Comprehensive error handling across contract reverts → API failures → World ID issues The innovation is leveraging World Chain's free gas + World ID's sybil resistance to create truly gasless, fair token distribution while preventing bot abuse.