Real Estate Token

interface RealEstateMetadata {
  propertyId:        string;
  propertyType:      string;   // Residential | Commercial | Industrial | Land
  locationAddress:   string;
  totalAreaSqMeters: bigint;
  titleDocumentHash: string;   // bytes32
  valuationUSD:      bigint;   // 18 decimals
  rentalYieldBps:    bigint;   // Annual yield, e.g. 600 = 6%
  occupancyStatus:   string;   // Vacant | Owner-occupied | Tenanted
  developerAddress:  string;   // Developer/issuer Ethereum address
  lastUpdated:       bigint;
}

const result = await factory.deployRealEstate({
  name:        "Victoria Island Commercial Unit",
  symbol:      "VICU",
  assetId:     "PROP-LAGOS-001",
  countryCode: "NG",
  metadata: {
    propertyId:        "PROP-001",
    propertyType:      "Commercial",
    locationAddress:   "12 Adeola Odeku Street, Victoria Island, Lagos",
    totalAreaSqMeters: BigInt(300),
    titleDocumentHash: ethers.ZeroHash,
    valuationUSD:      ethers.parseEther("500000"),
    rentalYieldBps:    BigInt(650),  // 6.5%
    occupancyStatus:   "Tenanted",
    developerAddress:  ethers.ZeroAddress,
    lastUpdated:       BigInt(Math.floor(Date.now() / 1000)),
  },
});

Transfer(address indexed from, address indexed to, uint256 value)
MetadataUpdated(uint256 indexed version, uint256 timestamp)
RentalDeclared(uint256 amountUSD, uint256 perTokenUSD, uint256 timestamp)