Skip to main content

Developer Documentation

Welcome to the NCRB developer documentation. This section covers the technical architecture, smart contracts, Oracle API, quality scoring system, and supported asset types.


Sections​

SectionDescription
ArchitectureHow the platform components fit together
Networks & ContractsTestnet contract addresses and ABIs
Oracle APIREST API reference — endpoints, request/response formats
Quality ScoringHow assets are scored, rated, and priced
Asset TypesAll supported asset classes with IDs, units, and standards

Smart Contract Reference​

ContractDescription
AccountManagerKYC allowlist — account registration, activation, suspension
AssetRegistryOn-chain ledger of RWA certificates; multi-sig approval flow
MultiSigGovernanceMint proposal lifecycle; 3-of-5 governance voting
QualityAssessmentOracle contract for scoring certificates; rating bands
RWATokenERC-7943 (uRWA) token; minting, retirement, forced transfer

Platform at a Glance​

NCRB is a multi-chain Real-World Asset (RWA) tokenization platform. Developers interact with three primary layers:

Smart Contracts — Solidity contracts deployed on Avalanche, Ethereum, and XRPL EVM. Handles asset registration, token minting, governance, compliance, and marketplace trading.

Oracle API — A Node.js/Express REST API (ncrb-oracles) that bridges the blockchain and the frontend. Provides certificate queries, quality assessment, governance, account management, price data, compliance records, and more. A Swagger UI and OpenAPI spec are served alongside the API.

Blockchain Indexer — A separate polling service (ncrb-indexer) that watches all three chains for contract events, writes them to a shared PostgreSQL database, and drives the price aggregation pipeline. The Oracle API reads from this shared database.


Tech Stack​

LayerTechnology
Smart ContractsSolidity 0.8.24, Hardhat, OpenZeppelin (UUPS upgradeable, role-based access control)
Token StandardERC-7943 (uRWA) — ERC-20 compatible with on-chain compliance hooks
Oracle APINode.js (ESM), Express.js, Winston logging, Swagger UI
IndexerNode.js polling loop, ethers.js v6, exponential backoff retry
DatabasePostgreSQL (Neon) — shared between Oracle API and Indexer
DeploymentVercel (serverless) for Oracle API; separate process for Indexer
NetworksAvalanche (C-Chain / Fuji), Ethereum (Mainnet / Sepolia), XRPL EVM