A comprehensive Web3 template for building decentralized access control systems with smart contracts, event monitoring, and JWT authentication.
This app is a market place where users can list resources (IPFS, URLs) on Ethereum (Sepolia) blockchain for others to purchase.
It is to be used as a template for future projects and for proof of concept.
- Upgradeable proxy pattern on Ethereum (Sepolia testnet)
- Resource marketplace where users purchase access with ETH
- Key Events:
AccessPurchased,ResourceCreated,Withdrawal - Access control with usage limits and expiration times
- Event monitoring via Alchemy webhooks → Vercel functions
- Wallet-based authentication with JWT issuance
- Dual storage: Supabase (persistent) + Redis (cache)
- Repository pattern with service layer architecture
- Wallet connection via RainbowKit (MetaMask, WalletConnect)
- Authentication flow: Connect → Sign message → Receive JWT
- Resource marketplace for browsing and purchasing access
- Automatically generates decoder and types using contract ABI
- Decoding functions for consistent usage around the app
- Types generation for event interaction
- Blockchain: Solidity, Upgradeable Proxies, Hardhat, Alchemy, Etherscan
- Frontend: Next.js 15, TypeScript, TailwindCSS, RainbowKit
- Backend: Next.js API Routes, Vercel Functions
- Database: Supabase (PostgreSQL)
- Authentication: Wallet signatures + JWT
- access-contract-decoder - NPM pubished package for typing decoding blockchain events
- portal - NextJS frontend and functions for Vercel
- blockchain - Blockchain contract setup
- UI event listening
- Setup Base network
- Setup Ethereum mainnet network
- Clean up blockchain resources that were used for testing
- IPFS upload functionality
- URL and IPFS input validation
- UI styling simplification and consistency
- Potential issues in UI functionality