How jsharles/qb3 works
Project type and purpose
• This is a full-stack “DePIN” logistics proof-of-concept dApp (“QB3”) using Ethereum smart contracts for last-mile delivery.
• The goal is to issue ERC-20 (QB3Token) and ERC-721 (SpaceRegistry) tokens, interact via a Next.js frontend, store off-chain data in Prisma, and deploy on Sepolia with CI/CD.
File structure
• Monorepo with two top-level folders:
– backend/ → Hardhat project (Solidity contracts, deployment scripts under ignition/, tests, config)
– frontend/ → Next.js 15 app (Tailwind CSS, Prisma schema & migrations, React components, Wagmi/Viem for Web3)
• CI: .github/workflows/test.yml
• VSCode config, linting, build scripts, type configurations
README for additional insights
• Smart contracts: QB3Token.sol and SpaceRegistry.sol
• Frontend: Next.js + Tailwind + RainbowKit + wagmi + viem
• CI: GitHub Actions, deployments: Vercel (frontend) and Sepolia (blockchain)