Brick Busters

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.

Smart contracts

Solidity (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 & deployment

blockend/ 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.

Frontend

React 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 & patterns

Verified-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 & CI

Hardhat 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.

Other

Demo hosted on Vercel.

Primary network: Citrea testnet (cBTC), explorer: explorer.testnet.citrea.xyz.