Getting Started
Everything runs against two environments. Start on sandbox — it is a complete, real-chain replica of production using test networks and test funds.
Environments
| Sandbox | Production | |
|---|---|---|
| Base URL | https://rwa-api-sandbox.tbook.com | https://rwa-api.tbook.com |
| Sui | testnet | mainnet |
| API keys | tbk_test_* | tbk_pub_* / tbk_secret_* |
| Funds | test USDC (faucets) | real |
| Settlement | operator-run cycles, plus on-demand via /v1/sandbox/settle | per published vault schedule |
The API surface is identical in both environments. Promotion to production is a key swap.
:::note Legacy Solana rail (frozen)
A legacy Solana gateway rail (rcusdp-sol, devnet/mainnet-beta) still exists but is paused: deposit and redeem builds return 409 vault_paused, while claim and cancel-deposit stay open so existing balances can exit. New integrations should target the Sui rail.
:::
Integration in five steps
- Get keys — your TBook contact issues sandbox keys; see Authentication.
- Pick your account model —
individual,omnibus,treasury, orbusiness. This decides who signs transactions and who keeps user-level books. - Run the Quickstart — full deposit → settle → webhook → positions loop in ~30 minutes.
- Wire webhooks — verify signatures and handle events; they are the primary integration surface.
- Complete the onboarding checklist — then request production keys.
Integration paths
| Path | Best for | What you need |
|---|---|---|
| REST API | Any backend or mobile app; WaaS signing | HTTP + any language |
| Server SDK | Webhook verification & typed API client | @tbookdev/vault-node |
| Client SDK | Apps building transactions client-side | @tbookdev/vault-sdk-sui |
| React Hooks | React apps on Sui | @tbookdev/vault-react-sui |
REST-only integration is fully supported — the SDKs are optional conveniences. The @tbookdev packages are published on the public npm registry and install like any other dependency (e.g. npm install @tbookdev/vault-node).
Read before you build
- Conventions — errors, idempotency, pagination, amounts, rate limits. Five minutes that prevent most integration bugs.
- Custody & WaaS Signing — how to sign with your own keys, Turnkey, or Privy (both verified end-to-end on Sui testnet).
- Core Flows — what "settlement cycle" means for your UX, and what happens on rollback.