DOCS / GETTING STARTED
Introduction
LedgerOne is the trust layer for real-world assets on Robinhood Chain. It verifies who may hold an asset, records what the asset is, and proves what it is worth and what backs it — then exposes all of it through dashboards, APIs and webhooks.
Quickstart
Fetch the verified NAV of an asset in three steps. All endpoints are versioned under https://api.buildledgerone.xyz/v1.
Authentication
Every request is authenticated with a scoped API key sent in the Authorization: Bearer header. Keys are issued per environment (sandbox / production) from the Developer Portal, carry explicit scopes, and can be rotated without downtime.
Environments
https://api.sandbox.buildledgerone.xyz/v1
Test assets, simulated oracles, instant fake attestations. Keys prefixed lo_sandbox_. Free on every plan.
https://api.buildledgerone.xyz/v1
Live verified data. Keys prefixed lo_live_, issued after workspace approval. All access audit-logged.
The Trust Layer
LedgerOne sits between real-world operations and Robinhood Chain as five coordinated layers. Data flows up; proofs anchor down.
{{ sel.l }} · {{ sel.tag }}
{{ sel.name }}
{{ sel.d }}
Asset lifecycle
An asset may only move to ACTIVE when four gates pass: minimum legal documents in the Vault, at least one valid PoR attestation, a configured oracle source, and platform approval (maker–checker).
Transfer compliance
Six rules run in strict order before any transfer settles. The first failure rejects the transfer with a standardized reason code.
{{ r.n }}
{{ r.name }}
{{ r.d }}
{{ r.code }}
KYC is valid 24 months for individuals, 12 for entities. Expiry moves a wallet to RESTRICTED (sell/withdraw only). AML alerts at High severity may freeze a wallet — always with a case ticket and audit log.
NAV & oracles
NAV = Σ(component values) + cash + receivables − liabilities − accrued fees
NAV/share = NAV ÷ tokens outstanding at cut-off
Proof of Reserves
Approved auditors and custodians sign reserve reports with registered keys. Each report is SHA-256 hashed and anchored on-chain with its cut-off timestamp.
≥ 100%
Badge RESERVES_VERIFIED on the public profile.
< 100%
Critical alert: mint locked, investors notified ≤ 24h, issuer must respond in 72h.
> 7 DAYS LATE
Public RESERVE_OVERDUE label and automatic risk-score penalty.
Risk scoring
A 0–100 score recomputed at least daily from five weighted components, published as an A–D band. Model weights are versioned; every change is audit-logged.
COMPONENT WEIGHTS
RATING BANDS
API Reference
{{ ep.m }}
{{ ep.p }}
{{ ep.d }}
SDKs
Rate limits
PLAN
REQUESTS / MIN
BURST
WEBHOOK ENDPOINTS
{{ lm.plan }}
{{ lm.rpm }}
{{ lm.burst }}
{{ lm.wh }}
Limits are per key. Responses include X-RateLimit-Remaining; exceeding returns 429 with a Retry-After header.
Errors
Errors use a consistent envelope with machine-readable codes and a request ID for support.
{
"error": {
"code": "DENY_NOT_WHITELISTED",
"message": "Destination wallet is not whitelisted for RWA-0142.",
"request_id": "req_9f27ab"
}
}
Webhooks
Signed events (HMAC-SHA256) delivered with at-least-once semantics and automatic retries over 24 hours.
Changelog
{{ ch.date }}
{{ ch.tag }}
Support
Developer support
Integration questions and API issues.
devs@buildledgerone.xyz
Status page
Live uptime for API, oracles and anchoring.
status.buildledgerone.xyz
Security
Responsible disclosure & bug bounty.
security@buildledgerone.xyz