A Base-native Proof of Attendance protocol that uses Digital Merch NFTs, demonstrating a low-cost, friction-minimized user experience and validating the freemium monetization model on the Base Sepolia Testnet.
Merch is a revolutionary Proof of Attendance Protocol (POAP) built specifically for Base L2, featuring:
- Creator-Driven Content: Creators upload merch images to IPFS for community use
- Event Management: Users create events with claim codes for attendance tracking
- Dual Token Model: Soulbound Tokens (SBT) for permanent attendance proof + ERC-721 NFTs for collectible value
- Low-Cost UX: Minimal L2 gas fees with off-chain reservation options
- Signature-Based Security: Public minting with backend signature verification
- EAS Integration: Immutable attestation records for verifiable attendance
- Freemium Monetization: Free basic claims with premium upgrade options
This project is organized across three specialized repositories:
| Repository | Purpose | Technology |
|---|---|---|
| merch-contracts | Smart contract implementation | Solidity, Foundry |
| merch-backend | API/Backend service | Node.js, TypeScript |
| merch-miniapp | Frontend Mini-App | React, MiniKit |
-
Clone all repositories:
git clone https://github.com/eth-ecuador/merch-contracts.git git clone https://github.com/eth-ecuador/merch-backend.git git clone https://github.com/eth-ecuador/merch-miniapp.git
-
Follow setup guides in each repository's README
-
Deploy to Base Sepolia following the Development Guide
- Access the Mini-App through Base App
- Enter your claim code to mint Basic Merch (SBT)
- Upgrade to Premium Merch (ERC-721) for collectible value
- ✅ Creator Tools: Upload and manage merch images on IPFS
- ✅ Event Creation: Create events with claim codes and images
- ✅ Off-Chain Reservation: Gasless entry for new users
- ✅ Low-Cost Claiming: Minimal L2 gas fees for immediate minting
- ✅ Dual Asset Model: SBT (permanent POA) + ERC-721 (tradable)
- ✅ EAS Attestations: Verifiable, immutable attendance records
- ✅ Premium Upgrades: Freemium monetization model
- ✅ Base Native: Optimized for Base L2 infrastructure
- Architecture Overview - System design and component interactions
- Smart Contract Specification - Contract design and functions
- API Specification - Backend endpoints and integration
- Frontend/UX Guide - UI/UX design and implementation
- Project Scope - Project goals and success criteria
- Development Guide - Setup, testing, and deployment
- Review the Project Scope to understand project boundaries
- Check the Development Guide for setup instructions
- Follow the architecture patterns outlined in Architecture Overview
- Submit PRs to the appropriate repository (contracts, backend, or miniapp)
This project is part of the ETH Ecuador initiative. See individual repositories for specific licensing terms.
Built for Base. Built for the future of Proof of Attendance.