How to Build on Real

Overview

Real is a Layer 1 blockchain purpose-built for real-world assets (RWAs). Developers can issue, manage, and integrate tokenized assets using Real’s composable smart contract framework, SDKs, and APIs.

If you’ve shipped to Ethereum, you already know how to ship to Real. Real is fully EVM-compatible with a familiar toolchain.

Why Build on Real

  • RWA-Native Protocols – Contracts for tokenization, offerings, P2P trading, lending, and yield.

  • Immediate Composability – Assets can flow directly into DeFi (AMMs, lending pools, yield strategies).

  • Compliance Ready – Built-in permissioned transfer layers and KYC/whitelist enforcement.

  • Low Fees + Scalability – Optimized block times and gas costs.

  • Developer Tooling – SDKs, templates, and APIs for rapid dApp deployment.

Getting Started

1. Install Dependencies

mkdir real-hardhat && cd real-hardhat
npm init -y
npm i -D hardhat @nomicfoundation/hardhat-toolbox dotenv
npx hardhat init

2. Configure the REAL Network

Add to hardhat.config.ts:

import { HardhatUserConfig } from "hardhat/config";
import "@nomicfoundation/hardhat-toolbox";
import * as dotenv from "dotenv";
dotenv.config();

const config: HardhatUserConfig = {
  solidity: "0.8.24",
  networks: {
    real: {
      url: process.env.REAL_RPC || "https://rpc.reallayer.com",
      chainId: 12345,
      accounts: process.env.PRIVATE_KEY ? [process.env.PRIVATE_KEY] : []
    }
  },
  etherscan: {
    apiKey: {
      real: process.env.REAL_EXPLORER_API_KEY || ""
    },
    customChains: [{
      network: "real",
      chainId: 12345,
      urls: {
        apiURL: "https://explorer.reallayer.com/api",
        browserURL: "https://explorer.reallayer.com"
      }
    }]
  }
};

export default config;

Core Building Blocks

Tokenization

  • Factory Contracts – Deploy tokenized representations of assets (ERC-20 or ERC-6909).

  • Compliance Controls – Whitelist/KYC layers via ERC-1404/3643 style restrictions.

Offerings

  • Use RealOffering contracts to launch primary offerings with stablecoin settlement.

  • Configure eligibility, pricing, and lockup terms.

Secondary Trading

  • P2P Router for direct trading.

  • Liquidity provisioning on AMMs for market discovery.

Yield and Distribution

  • Use RealStakingDistributor to distribute proceeds (rents, dividends, sales) pro-rata to stakers.

  • Supports recurring (RENTAL) or one-time (SALE) cycles.

Example Flow

  1. Mint: Deploy a fractional token with RealTokenFactory.

  2. Offer: Allocate tokens to a RealOffering contract for sale.

  3. Trade: Enable secondary market via AMMs or P2P Router.

  4. Earn: Deposit asset proceeds into RealStakingDistributor.

  5. Distribute: Rewards flow to eligible token holders automatically.

Developer Resources

PreviousHow to Become a ValidatorNextDeploying Smart Contracts

Last updated