Building Culture

Network guide

End users: read How it works for a plain-language investor flow. This page is for operators: deploy contracts, configure env, and verify transactions.

This deployment supports up to seven seeded properties when configured on-chain. Tokens represent programmed economic interests, not legal title; read docs/compliance.md in the repository.

How tokenization, buying shares, and your platform vision connect

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.

  1. 1

    Gas & settlement

    Listings use Base: hold ETH for gas and USDC (or the issuer's quoted token) for trades and primary sales where configured.

    Open link
  2. 2

    Deploy contracts

    From the repo root run DeployAll, then SeedSevenProperties (or SeedThreeProperties + SeedFourMoreProperties) with PROPERTY_REGISTRY and PROPERTY_SHARE_FACTORY set. See deployments/README.md.

    Go
  3. 3

    Configure the web app

    Copy deployments/base-mainnet.json fields into web/.env.local, or run scripts/sync_web_env.py deployments/base-mainnet.json.

    Go
  4. 4

    Connect wallet

    Use an injected wallet (e.g. MetaMask) on Base mainnet (chain id 8453).

    Go
  5. 5

    Explore

    Open Basescan to verify registerProperty, createPropertyShare, and pool transactions.

    Open link

AI assistant

Answers use RAG over project docs plus your configured contract addresses. Not legal advice.

Ask how registration differs from share tokens, or what to do first.