Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.calmtreasury.xyz/llms.txt

Use this file to discover all available pages before exploring further.

​
v0.1.0 — 2026-06-02

​
SDK

  • Initial release of @calm-xyz/react — single package exporting the vanilla client (createClient) and the React widget (CalmProvider, DepositCard, …) from one entry.
  • Auth model: Privy identity token → HttpOnly session cookie.
  • <DepositFlow /> walks register → ToS → KYC → currency/chain → VA → deposit instructions.
  • All step components exported individually for partners who want to compose their own UI.

​
API

  • POST /v1/session — Privy JWT → cookie.
  • GET /v1/wallets/:address — current state.
  • POST /v1/wallets/:address — register.
  • POST /v1/wallets/:address/tos-link — Bridge ToS URL.
  • POST /v1/wallets/:address/kyc-link — Bridge KYC URL.
  • POST /v1/wallets/:address/virtual-account — create VA.
  • GET /v1/wallets/:address/virtual-account — read VA.
  • Supported chains: Arbitrum, Base, Ethereum, HyperEVM.
  • Supported source currencies: USD, GBP, EUR.

​
Schema

  • Single-table model: customer (id, app_id, bridge_customer_id, wallet, email, country, virtual_account_id, created_at).
  • UNIQUE(app_id, email) — multi-tenant via Privy app id.