Brick Busters

Problem Statement

Brick Busters is a blockchain-native platform that makes premium real-estate investable by anyone through fractional tokenization. Property owners (creators) upload verified documents, request property creation, and mint ERC-20 property tokens representing shares of a property. Verified investors buy those tokens, receive proportional automated revenue distributions (ETH or ERC-20), and trade tokens on a built-in dynamic marketplace.Compliance and security are first-class: an on-chain IdentityRegistry enforces KYC/AML verification, a ComplianceModule restricts transfers to verified wallets, and all property documents are stored on Walrus (Tusky) for immutable, auditable records. The MultiPropertyTokenManager contract manages properties, token minting, purchases, deposits of revenue, and on-chain withdrawal accounting. Admins can pause contracts, update modules, and transfer ownership for emergency and upgradeability needs.User flows are simple: creators complete KYC, upload documents, request listing; admins verify and approve listings; investors complete KYC, buy tokens via MetaMask, and automatically accrue revenue distributions which they can withdraw any time. The marketplace supports peer-to-peer sells, live availability tracking, and automatic price calculation. Brick Busters targets regulated, transparent fractional ownership with user-friendly web UX and robust on-chain compliance.

Solution

Smart contractsSolidity (0.8.28), OpenZeppelin libraries (Ownable, ReentrancyGuard, ERC20 patterns).Contracts: IdentityRegistry (KYC/AML), ComplianceModule (transfer rules), PropertyERC20 (fraction tokens), MultiPropertyTokenManager (property lifecycle, marketplace, revenue accounting).Gas/optimizations: optimizer enabled, 200 runs, packed structs, batch ops for minting & settlement.Backend & deploymentblockend/ Node.js + Hardhat scripts for compile/test/deploy.Hardhat for local tests, gas reporting, and deployments to Citrea testnet (Chain ID 5115) and Sepolia fallback.Deployment: npx hardhat run scripts/deploy.js --network citrea.FrontendReact 19, hooks + context, TailwindCSS for responsive UI.Ethers.js v6 for wallet & contract interactions, MetaMask integration, React Router, react-hot-toast for UX notifications.Walrus (Tusky) integration for document upload + storage; frontend uses a useWalrus hook and WalrusFileUpload component.Security & patternsVerified-only transfer enforcement via compliance module.Withdraw/pull payment pattern for revenue to avoid reentrancy; ReentrancyGuard used on withdrawal flows.Admin-only and creator-role restrictions enforced on-chain.Testing & CIHardhat tests for unit & integration; REPORT_GAS=true for gas benchmarks.Frontend unit tests with Jest/React Testing Library.Linting and basic CI pipeline for build/test.OtherDemo hosted on Vercel.Primary network: Citrea testnet (cBTC), explorer: explorer.testnet.citrea.xyz.