How the reference fits together
The reference is a small set of components on Stellar Testnet. A wire arrives at the mock bank, becomes tokens through the API and the signer, and settles on Stellar; the keys stay in one place.
Six components, one boundary
API
Accepts requests, records every change and owns the double-entry ledger.
Console
Where a business mints, pays, redeems and manages counterparties.
Back office
Where an operator attributes deposits, freezes holders and reconciles.
Ledger watcher
Watches the chain, reconciles what it sees and dispatches webhooks.
Signer
The only holder of keys. It holds the Testnet keys and signs every transaction.
Stellar
RPC and Horizon: how the reference reaches Stellar Testnet.
Bootstrap the issuer, then call the API
The quickstart runs the whole issuer on Testnet in about half an hour, then sends its first requests.
# in the repo root, with Docker
cp .env.example .env
docker compose up -d postgres
docker compose build core# supply and reserves, no account needed
GET /v1/public/supply/USDX
GET /v1/public/reserves/USDXSwap one part without touching the rest
ReserveSource
Reads reserves from a source, such as a bank statement feed or a custodian API.
SettlementRail
Moves fiat, such as a real bank for wires and payouts.
Signer
Signs transactions, such as a hardware module or a remote key service.
KycProvider
Checks an organisation or person, such as a KYB or KYC provider.