Network guide

What “tokenized” means here

Each registered property can have one PropertyShareToken (ERC-20) minted through PropertyShareFactory. The token is bound to a single propertyId in PropertyRegistry. That is fractional exposure as a crypto asset, not an automatic replacement for land title or securities compliance — real offerings need legal structure, disclosures, and often KYC (see repo docs/compliance.md). Early deployments may pause provider KYC — use registry bypass or admin verification instead.

How someone gets (or buys) shares today

• Primary / direct: whoever holds MINTER_ROLE or existing balances can transfer shares to buyers (wallet-to-wallet), same as any ERC-20.
• Secondary / “market price”: this stack includes OgRouter + pairs for swaps against wrapped gas (WOG). For a liquid market, someone must create a pool (share token / WOG) and add liquidity (similar to Uniswap-style AMM). Then users swap on the Trade page (approve router → swap). If there is no pool, there is nothing to “buy” via the DEX yet except OTC transfers.

Rent yield vs. price appreciation

Automatic rent streaming is not implemented in these contracts. Distributing cash flow from tenants usually requires an off-chain SPV, legal agreements, and either periodic manual distributions or a future on-chain dividend contract. Appreciation is reflected if secondary markets price the share token higher — again, only meaningful with liquidity and real economics behind the asset.

Tokenize a property (issuer flow)

Today: registerProperty on the registry (needs appropriate role), then createPropertyShare on the factory with metadata URI, supply cap, and initial mint. A full product would add onboarding UI, document upload, KYC, and legal templates — the contracts are the settlement layer.

Raise money to build (financing)

The repo includes a lending pattern (collateralize share tokens, borrow WOG) — see Lend. That is not a full construction-loan product; it is a DeFi primitive. Real “build a new property” financing typically combines equity (selling shares), debt, and licensed lenders — product and compliance work on top of these primitives.