Back to user guide

Technical docs

Code map

Modules

Frontend route groups, backend services, and smart contract boundaries.

Three modules make up the system: the frontend (which also hosts the BFF backend), the agent workflow service, and the on chain smart contracts.

Next.js 14 App Router with four route groups. State is mostly React context plus fetch; React Query is used on the bridge. UI is Radix + a shadcn style system with framer motion.

Route groupPurpose
(marketing)Public site: home, pricing, features, docs
(main)Authenticated workspace hub + dashboard (wallet gated)
pay/[id]Public Stellar checkout for payment links
demoUnauthenticated sandbox with mock session/data
apiRoute Handlers (BFF): auth, payments, vault, AI proxies

Key dashboard surfaces:

  • Payments: create/collect payment links, send outbound payments.
  • Treasury: pooled balances and withdrawals.
  • Secure Vault: Soroban commitment pool (privacy beta).
  • Bridge: Circle CCTP USDC across Ethereum, Avalanche, Solana, Stellar.
  • Compliance Agent / RegIntel / RNS: AI compliance analysis and regulatory news.
  • Employees, Templates, Billing: workspace operations.

Backend (BFF + services)

View on GitHub ↗

Next.js Route Handlers

GitHub ↗
  • Session auth via signed HMAC cookies
  • Prisma CRUD against MongoDB
  • Orchestrates Stellar / Soroban server libs
  • Proxies AI calls to agent workflow

Agent workflow (FastAPI)

GitHub ↗
  • RegIntel RAG pipeline over MongoDB
  • Compliance Agent (multi modal)
  • 8 regulatory scrapers (OFAC, SEC, MiCA, GDPR…)
  • OpenAI gpt-4o-mini / gpt-4o

Express demo stub

GitHub ↗Legacy
  • soroban-escrow-backend on :4000
  • In memory payment link demo
  • Not used in production path

Smart contracts

View on GitHub ↗

A single Soroban contract, PoolManager (Rust, soroban-sdk 25), runs the privacy pool. It uses Poseidon hashing and BN254 scalars from Stellar’s X Ray primitives. Source lives in contracts/poolmanager. See Smart contracts & deployments for the full interface and addresses.

Hypertron
Onboard
000