Assetizetokenized fractional real estate
2025 to 2026. Repository.
What I ownedEverything. Solo build at SupeAI: data model, repository and service layers, API, on-chain integration, documentation and the bug log.
Architecture, drawn
Problem
Fractional ownership of property only works if the record of who owns what can be checked by someone other than the platform. Assetize is the Phase 1 investor demo of that record, built so that the later move to real contracts touches one layer.
Architecture
Strict Repository, then Service, then API. The layering is designed so that a Phase 2 migration to real Solidity contracts touches only the repository layer. It is enforced by self-audit, which caught three real boundary violations.
The hash pool. A live investor pitch cannot depend on network latency, but faking hashes destroys the credibility the demo exists to build. So about 50 real transactions are pre-submitted to Polygon Amoy and 20 unused hashes are pooled. Every demo action draws a real, explorable hash instantly.
All currency is BigInt paise, never floats. Distribution is gross, minus a 9% management fee, minus 10% TDS. BUG-006 was a missing fee deduction that would have overpaid every investor. It was caught before it ran live.
Decisions
- Real hashes, drawn from a pool
- The trade-off is explicit: the hashes are real and explorable, but they were not produced by the action that displays them. That is stated in the demo rather than hidden.
- Integer minor units everywhere
- Money is never a float. Fees and tax are computed on BigInt paise so rounding cannot leak value between investors.
- Layer boundaries are audited, not assumed
- A self-audit pass reads every import against the allowed direction. It found three violations that would have made the Phase 2 migration touch more than the repository layer.
Measured, not asserted
- Boundary violations caught before merge
- 3
- Bugs logged and fixed
- 14
- Overpayment bug caught before it ran live
- BUG-006
Bugs worth telling
- BUG-006, the missing fee
- Distribution skipped the 9% management fee, which would have overpaid every investor on every payout. Found in review of the distribution math before the demo.
Honest limits
- Phase 1 investor demo with a documented Phase 2.
- Seeded mock data. No real KYC. No real payments. No deployed contracts.
Scale
- Commits
- 58
- Prisma models
- 16
- API routes
- ~24
- Repository interfaces and implementations
- 7 + 7
- Services
- 6
- Lines of self-authored documentation
- ~3,900
- User stories
- 34
Stack
- TypeScript
- Next.js
- PostgreSQL
- Prisma
- Supabase
- ethers.js
- Zod
- Tailwind
- GitHub Actions
- Vercel
- Polygon Amoy
- shadcn/ui
- Framer Motion
- @react-pdf/renderer
- Recharts