Decentralized Real Estate Investment Platform on Aptos Blockchain

Transform real estate investment through blockchain-powered fractional ownership. Buy, sell, and trade property fractions with complete transparency and liquidity.

v2 rebuild: Spec in REBUILD_BLUEPRINT.md. Scaffold: packages/* (shared, chain-client, indexer, contracts), docs/, npm run typecheck:packages.

• 1000 Token Standard: Each property minted as 1,000 fungible tokens
• Instant Liquidity: Trade fractions on integrated marketplace
• Real-time Valuation: Dynamic pricing based on market demand
• Yield Distribution: Proportional rent distribution to token holders

• Fractional Ownership: Invest with as little as 1 token
• Portfolio Management: Track all investments in one dashboard
• Rental Income: Automated yield claiming system
• Diversification: Own fractions across multiple properties

• Order Book System: Professional buy/sell order matching
• Atomic Swaps: Direct token exchanges between properties
• Real-time Listings: Live property availability
• Price Discovery: Market-driven valuation

• 3D Property Tours: Immersive 360° interior views
• Mapbox Integration: Interactive property location mapping
• Property Details: Comprehensive information on every asset
• Real-time Updates: Live data from blockchain

• Framework: Next.js 15.5.6 (React 18.3)
• Styling: TailwindCSS + Framer Motion
• 3D Graphics: React Three Fiber + Three.js
• Maps: Mapbox GL + React Map GL
• UI Components: Radix UI + Lucide Icons

• Platform: Aptos Blockchain
• Smart Contracts: Move Language
• Wallet: Petra Wallet Integration
• SDK: @aptos-labs/ts-sdk 1.8.4

• FractionRealm.move: Legacy fraction-based system
• PropertyToken.move: Advanced fungible asset tokenization with order book

• Photon: Rewards and gamification system
• Shelby Protocol: Decentralized storage
• TypeScript: End-to-end type safety

• Node.js 18+
• npm or yarn
• Aptos CLI
• Petra Wallet

git clone https://github.com/yourusername/FractionRealmRise.git
cd FractionRealmRise

npm install

Create .env.local in the root directory:

# Aptos Configuration
NEXT_PUBLIC_APTOS_NETWORK=localnet
NEXT_PUBLIC_APTOS_NODE_URL=http://localhost:8080/v1
NEXT_PUBLIC_MODULE_ADDRESS=0x24749f99a6fd99b27379477b6a9527c155fe9e4a694a9cd433b7039f59bf8f16

# Optional: Mapbox (for maps)
NEXT_PUBLIC_MAPBOX_TOKEN=your_mapbox_token

# Optional: Database
DATABASE_URL=your_database_url

aptos node run-local-testnet

cd move
aptos move publish --profile default --named-addresses fraction_realm=default --assume-yes

aptos account fund-with-faucet --account YOUR_ADDRESS --amount 100000000000 --faucet-url http://127.0.0.1:8081

npm run dev

Visit http://localhost:3000

1. Connect Wallet

   • Install Petra Wallet
   • Configure for Localnet/Testnet
   • Connect to FractionRealmRise

2. Browse Properties

   • Explore available properties on map
   • View 3D tours and details
   • Check yield and pricing

3. Invest

   • Click "Invest Now"
   • Enter number of fractions
   • Approve transaction in Petra

4. Manage Portfolio

   • View all investments in Dashboard
   • Claim rental yields
   • Track performance

1. Tokenize Property

   • Go to /tokenize
   • Fill property details
   • Mint 1,000 tokens
   • List on marketplace

2. Manage Listings

   • Create sell orders
   • Set prices
   • Monitor trades

// Core functions
initialize_property()  // Create new property
buy_fraction()        // Purchase fractions
claim_rent()          // Collect rental income
list_for_sale()       // Create marketplace listing
create_swap_offer()   // Propose token swap

// Advanced tokenization
create_property_token()  // Mint fungible asset
create_buy_order()      // Place buy order
create_sell_order()     // Place sell order
fill_order()            // Match orders
create_swap_offer()     // Token swap
update_property_value() // Price updates

FractionRealmRise/
├── app/                    # Next.js app directory
│   ├── page.tsx           # Landing page
│   ├── dashboard/         # User dashboard
│   ├── marketplace/       # Marketplace UI
│   ├── tokenize/          # Property tokenization
│   ├── property/[id]/     # Property details
│   └── api/               # API routes
├── components/            # React components
│   ├── 3d/               # 3D viewers
│   ├── dashboard/        # Dashboard components
│   ├── marketplace/      # Marketplace UI
│   ├── property/         # Property components
│   └── ui/               # Reusable UI
├── lib/                  # Utilities
│   ├── aptos/           # Blockchain SDK
│   ├── integrations/    # Third-party APIs
│   └── utils/           # Helper functions
├── move/                # Smart contracts
│   └── sources/
│       ├── FractionRealm.move
│       └── PropertyToken.move
├── contexts/            # React contexts
├── hooks/               # Custom hooks
└── types/               # TypeScript types

Each property is tokenized into exactly 1,000 fungible tokens, enabling:

• Fractional ownership down to 0.001%
• Liquid secondary markets
• Proportional yield distribution
• Easy portfolio diversification

Professional-grade trading infrastructure:

• Buy Orders: Place bids with price limits
• Sell Orders: List tokens at desired prices
• Order Matching: Automatic execution
• Price Discovery: Market-driven valuation

Trustless token exchanges:

• Swap tokens between different properties
• No intermediary required
• Instant settlement
• Fair exchange guaranteed by smart contracts

npm test

npm run build
npm start

npm run lint

cd move
aptos move test

• Deployment Guide
• Localnet Setup
• Smart Contract Integration
• Marketplace Features
• Wallet Setup

"Module not found"

• Deploy contracts first
• Check module address in .env.local
• Verify network configuration

"Insufficient balance"

• Fund wallet using faucet
• Check you're on correct network

Petra not connecting

• Verify network settings in Petra
• Try disconnect/reconnect
• Check localnet is running

See Troubleshooting Guide for more.

We welcome contributions! Please:

1. Fork the repository
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open Pull Request

This project is licensed under the MIT License - see LICENSE file for details.

• Aptos Labs - Blockchain platform
• Move Language - Smart contract development
• Next.js Team - Web framework
• Mapbox - Mapping services
• Three.js - 3D graphics

• Property tokenization (1000 tokens)
• Marketplace with order book
• Atomic swaps
• Portfolio dashboard
• 3D property tours
• Mobile app
• Multi-chain support
• Real property onboarding
• KYC/AML integration
• Governance token

Built with ❤️ on Aptos Blockchain

Democratizing real estate investment, one fraction at a time.