Real Tools

Overview

Real Tools is a unified collection of SDKs, client libraries, and developer utilities designed to accelerate building on Real’s decentralized products, Real Market and Real Exchange. The toolkit abstracts complex on-chain interactions, compliance-aware workflows, and trading primitives into simple, composable modules, enabling developers to ship secure, production-ready applications faster across web, backend, and smart contract environments.

---

Purpose

• Simplify integration with Real Market and Real Exchange

• Standardize access to trading, asset, and account primitives

• Reduce time-to-market for decentralized financial applications

• Enforce consistent security and compliance patterns

• Enable extensibility across multiple frameworks and chains

---

Key Features

• Modular SDK architecture (pick only what you need)

• Typed clients for assets, markets, orders, and positions

• Wallet-agnostic signing and account abstraction support

• Read/write helpers for spot and perpetual markets

• Event indexing and state synchronization utilities

• Production-grade error handling and retries

---

Installation

JavaScript / TypeScript

npm install @real/tools
# or
pnpm add @real/tools

Python

pip install real-tools

Rust (for indexers & infra)

real-tools = "0.x"

---

Core Modules

• Client Core: Connection management, RPC handling, retries, and environment configs.

• Market Module: Asset discovery, pricing feeds, order books, and settlement helpers for Real Market.

• Exchange Module: Spot and perpetual trading primitives: orders, positions, funding rates, and liquidations.

• Accounts and Wallets: Wallet adapters, signing flows, session keys, and account abstraction.

• Compliance Hooks: Optional policy checks, allowlists, and jurisdiction-aware flags.

• Indexer Utilities: Event listeners, state snapshots, and historical data access.

---

Quick Start

import { RealClient, Exchange } from "@real/tools";

const client = new RealClient({
  network: "mainnet",
  rpcUrl: process.env.REAL_RPC,
});

const exchange = new Exchange(client);

// Fetch markets
const markets = await exchange.getMarkets();

// Place a spot order
await exchange.placeOrder({
  market: "REAL-USD",
  side: "buy",
  size: 10,
  type: "limit",
  price: 1.25,
});

---

Developer Utilities

• CLI for scaffolding projects and managing configs

• Local sandbox and forked-network testing helpers

• Mock providers for unit and integration tests

• Schema generators for typed APIs and contracts

• Logging, tracing, and metrics adapters

---

Integrations

• Frontends: React, Next.js, Vue

• Wallets: MetaMask, WalletConnect, embedded wallets

• Indexing: Subgraphs, custom Rust/Node indexers

• Custody and Key Management (optional): MPC and HSM providers

• Analytics and Monitoring: Prometheus-compatible metrics

---

Example Applications

• Decentralized trading terminals (spot and perps)

• Asset issuance and marketplace frontends

• Portfolio dashboards and risk tools

• Automated trading bots and market makers

• Compliance-aware investment apps

---

Next Steps

• Explore the Real Market and Real Exchange docs

• Review module-specific API references

• Run the local sandbox and sample apps

• Join the developer community and roadmap discussions

• Contribute SDK extensions or integrations