Real Estate Tokenization (RWA)

Tokenizing Real World Assets (RWA) involves representing a physical asset, like an apartment building, as a fixed supply of units (tokens) in a ledger. Each holder owns a fraction of the asset and is entitled to proportional rewards, such as monthly rent.

Architecture

We model each property as its own Ledger with a fixed supply (e.g., 100,000 units representing cm² or shares).

Implementation Flow

# Create Ledger for "Sunset Villa Apts"
curl -X POST http://localhost:8080/v1/ledgers -d '{ "name": "Asset: Sunset Villa" }'

curl -X POST http://localhost:8080/v1/transfers 
  -d '{
    "debit_account_id": "PROPERTY_WORLD_ID",
    "credit_account_id": "INVESTOR_A_ASSET_ID",
    "amount": 30000,
    "code": 500 # Code: "Token Purchase"
  }'

# 30% of $10,000 = $3,000
curl -X POST http://localhost:8080/v1/transfers 
  -d '{
    "debit_account_id": "RENT_COLLECTION_POOL_ID",
    "credit_account_id": "INVESTOR_A_WALLET_ID",
    "amount": 300000, # Assuming 2 decimals
    "code": 600 # Code: "Rental Dividend"
  }'

Advanced Operations

1. Secondary Market (P2P Trading)

Investors don't need to wait for a property sale to exit. They can sell their units to other investors directly within the Property Ledger.

curl -X POST http://localhost:8080/v1/transfers \
  -d '{
    "debit_account_id": "INVESTOR_A_ASSET_ID",
    "credit_account_id": "INVESTOR_C_ASSET_ID",
    "amount": 5000, # Selling 5% of the property
    "code": 700 # Code: "Secondary Market Trade"
  }'

2. Maintenance & Expense Deductions

Before distributing rent, you often need to deduct property taxes or maintenance fees.

By linking the maintenance deduction to the rental pool, you ensure the business expenses are covered before any dividends are paid out.

Why Beetles is perfect for RWA

1. Fixed Supply: By monitoring the @world account of the property ledger, you can mathematically prove that no more than 100% of the property was ever sold.
2. Fractional Accuracy: Beetles supports 128-bit integers, allowing you to track ownership down to microscopic levels without floating-point errors.
3. Secondary Market: Investors can trade their "property tokens" among themselves by simply transferring units in the Property Ledger. The next rent distribution will automatically reflect the new owner.