Skip to main content

Smart Contracts

The Mantle RWA SDK includes a suite of audited smart contracts for tokenizing real-world assets with built-in compliance.

Architecture​

graph TB
    subgraph "Core Contracts"
        A[RWAToken]
        B[KYCRegistry]
        C[YieldDistributor]
        D[AssetVault]
    end
    
    subgraph "Factory & Proxy"
        E[RWAFactory]
        F[UUPS Proxy]
    end
    
    subgraph "Compliance"
        G[ComplianceModule]
        H[TransferRestrictions]
    end
    
    E --> A
    E --> B
    E --> C
    E --> D
    A --> G
    A --> B
    G --> H
    C --> A

Contract Overview​

ContractDescriptionStandard
RWATokenERC-3643 compliant security tokenERC-20, ERC-3643
KYCRegistryOn-chain KYC verificationCustom
YieldDistributorDividend distributionCustom
AssetVaultAsset custodyCustom
RWAFactorySystem deployment factoryCustom

Deployment Addresses​

Mantle Sepolia (Testnet)​

ContractAddress
RWAFactory0x...
Implementation (Token)0x...
Implementation (KYC)0x...

Mantle Mainnet​

ContractAddress
RWAFactory0x...
Implementation (Token)0x...
Implementation (KYC)0x...

ERC-3643 Compliance​

The RWAToken contract implements the ERC-3643 (T-REX) standard for security tokens:

  • Identity Registry: On-chain KYC verification
  • Compliance Module: Transfer restrictions
  • Token Lifecycle: Mint, burn, freeze, pause
  • Recovery: Lost wallet recovery mechanism

Upgradeability​

All contracts use the UUPS (Universal Upgradeable Proxy Standard) pattern:

// Upgrade to new implementation
function upgradeTo(address newImplementation) external onlyAdmin;

// Upgrade with initialization
function upgradeToAndCall(
    address newImplementation,
    bytes memory data
) external onlyAdmin;

Access Control​

Contracts use role-based access control:

RoleDescription
DEFAULT_ADMIN_ROLEFull administrative access
MINTER_ROLECan mint new tokens
BURNER_ROLECan burn tokens
PAUSER_ROLECan pause/unpause
COMPLIANCE_ROLECan update compliance rules
VERIFIER_ROLECan verify investors

Gas Optimization​

Contracts are optimized for Mantle Network:

  • Batch operations for reduced gas
  • Efficient storage patterns
  • Minimal external calls
  • Optimized loops

Security​

  • Audited by [Auditor Name]
  • Bug bounty program active
  • Formal verification for critical functions
  • Comprehensive test coverage

Installation​

npm install @mantle-rwa/contracts

Usage​

Import in Solidity​

import "@mantle-rwa/contracts/RWAToken.sol";
import "@mantle-rwa/contracts/KYCRegistry.sol";

Import ABIs​

import { RWATokenABI, KYCRegistryABI } from '@mantle-rwa/contracts';

Next Steps​