TrustLedger — Frontend

Institutional compliance dashboard for Real-World Asset (RWA) analytics on Stellar.

This repository contains the frontend application for TrustLedger. It provides a queryable audit interface for institutional users — regulators, custodians, and fund managers — to inspect historical on-chain RWA events indexed from Soroban, verify zero-knowledge Proof of SQL results, and export compliance reports.

Related repository: — Soroban contracts, Zephyr indexer, ZK proof circuits, and GraphQL API.

---

Why This Exists

Standard block explorers and RPC interfaces are optimized for current ledger state. Institutional compliance workflows require:

• Historical aggregate queries over tokenized yield-bearing asset distributions on Stellar.
• Cryptographic proof verification — auditors need to confirm that queried data has not been tampered with, without re-running the full indexer.
• ERP-ready data delivery — compliance teams need structured, exportable views that integrate with existing institutional reporting pipelines.

---

Repository Structure

.
├── app/                    # Next.js App Router pages and layouts
│   ├── dashboard/          # RWA portfolio overview and TTL metric views
│   ├── audit/              # ZK proof verification and compliance report exports
│   └── query/              # Interactive SQL query builder over indexed ledger data
├── components/             # Shared UI components (tables, proof badges, charts)
├── lib/
│   ├── graphql/            # Apollo Client setup and typed query definitions
│   └── sxt/                # Space and Time proof verification helpers
├── public/                 # Static assets
└── docs/                   # Frontend architecture notes and environment setup guides

---

Quick Start

Prerequisites

• Node.js 22+
• npm 10+
• Access to a running TrustLedger GraphQL API endpoint
• Space and Time API credentials (for client-side proof verification)

Environment Setup

Copy the example environment file and populate your credentials:

cp .env.example .env.local

NEXT_PUBLIC_GRAPHQL_ENDPOINT=https://your-api-endpoint/graphql
NEXT_PUBLIC_SXT_API_KEY=your_space_and_time_api_key

Install and Run

npm install
npm run dev

The dashboard will be available at http://localhost:3000.

Build for Production

npm run build
npm start

---

Security

To report a vulnerability, create an issue.

All data rendered in the dashboard is backed by cryptographically pinned indexed datasets. The proof verification UI confirms ZK Proof of SQL integrity client-side before presenting query results to institutional users.

---

License

See here