Real SDK

Overview

The Real SDK is the official developer toolkit for building on the Real blockchain. It provides a unified set of libraries, utilities, and templates designed to make it easier for developers to integrate real-world assets (RWAs) into decentralized applications. By abstracting the complexity of tokenization, compliance, and on-chain asset management, the SDK accelerates time-to-market and ensures seamless interoperability with the Real ecosystem.

Purpose

The Real SDK is built to empower developers to:

  • Quickly onboard tokenized assets using prebuilt contract factories.

  • Integrate RWA-specific standards such as REAL-20, REAL-721, and REAL-1155 with minimal setup.

  • Connect seamlessly with Real infrastructure (Explorer, Indexer, APIs, and Wallets).

  • Access compliant tokenization flows and reference implementations for asset issuance, trading, and yield distribution.

Key Features

  • EVM Compatibility: Works natively with Solidity smart contracts and popular Ethereum tooling (Hardhat, Foundry, Truffle, Remix).

  • Prebuilt Modules: Contracts for asset issuance, fractionalization, lending, staking, and P2P trading.

  • API and SDK Clients: TypeScript and Python client libraries for interacting with the Real blockchain and indexer.

  • Composability: Plug-and-play with DeFi protocols to make tokenized assets usable from day one.

  • Cross-Chain Support: Integrations with bridges for liquidity and settlement across other chains.

  • Developer Utilities: Includes helper functions for wallet integration, metadata management, and contract deployment.

Architecture

The SDK is structured in modular layers:

  • Core Contracts: Factories and base contracts for RWAs (fractional tokens, offerings, lending modules).

  • Client Libraries: TypeScript/Python packages for blockchain queries, event subscriptions, and transaction signing.

  • CLI Tools: Scaffolding for new projects, deployment scripts, and local devnet setup.

  • Integrations: Adapters for wallets, explorers, and third-party liquidity providers.

Installation

Node.js / TypeScript

npm install @real/sdk

Python

pip install real-sdk

Requirements

  • Node.js v18+ or Python 3.9+

  • Access to Real RPC (e.g., https://rpc.reallayer.com)

  • A funded wallet for deployment

Core Modules

The SDK provides modular contracts and utilities:

Contracts

  • RealTokenFactory – Issue fractional RWA tokens.

  • RealOffering – Configure compliant offerings.

  • OfferingFactory – Batch deployment for issuers.

  • RealStakingDistributor – Distribute rental/sale proceeds to investors.

  • RealLending – Enable loans against tokenized assets.

  • P2PRouter – Facilitate peer-to-peer trading of RWAs.

Standards

  • REAL-20: Fungible token standard optimized for RWA throughput and gas efficiency.

  • REAL-721: Non-fungible token standard for unique asset representations.

  • REAL-1155: Multi-token standard for batch issuance of RWAs.

Quick Start

Deploying a Fractional Token

import { RealClient, RealTokenFactory } from "@real/sdk";

const client = new RealClient("https://rpc.reallayer.com");
const factory = new RealTokenFactory(client);

const tokenAddress = await factory.deployFractionalToken({
  name: "Dubai Villa",
  symbol: "DVILLA",
  totalSupply: "1000000"
});

console.log("Token deployed at:", tokenAddress);

Launching an Offering

import { OfferingFactory } from "@real/sdk";

const offering = new OfferingFactory(client);
await offering.create({
  token: tokenAddress,
  pricePerShare: "1 USDC",
  maxAllocation: "1000000",
});

console.log("Offering created");

Developer Utilities

The SDK includes tools and helpers to speed up development:

Wallet Integration

Supports MetaMask, WalletConnect, Ledger, and Real Wallet with prebuilt hooks.

Explorer API

Query transactions, events, and asset metadata directly from Real Explorer.

CLI Tools

npx real-sdk init my-rwa-project
npx real-sdk deploy --contract RealFractionalToken
npx real-sdk verify --address <contract_address>

Integrations

The Real SDK connects directly with Real ecosystem components:

  • Real Explorer – Track smart contracts, transactions, and token movements.

  • Real Indexer – Query indexed asset data for dashboards and apps.

  • Cross-Chain Bridges – Move assets between Ethereum, BSC, and Real.

  • DeFi Protocols – Integrate RWAs into lending pools, AMMs, and structured products.

Example Applications

Fractional Real Estate Tokenization

Issue and trade tokenized shares of real estate projects.

RWA Lending Pool

Borrow stablecoins against tokenized property, bonds, or commodities.

Compliant Investor Portal

Onboard investors with whitelisting, KYC, and controlled allocations.

Roles in Development

  • Issuers: Use the SDK to tokenize assets and configure compliance rules.

  • Developers: Build DeFi integrations, marketplaces, and apps using Real’s libraries.

  • Investors: Indirectly benefit from apps that use the SDK for transparent and compliant asset issuance.

Next Steps

PreviousAPI ReferenceNextReal Token

Last updated