Real-time payment analytics for Stellar.
A lean, production-grade stack for measuring and improving cross-border payment reliability.
- Backend: Rust analytics engine (Axum, SQLx)
- Frontend: Next.js dashboard
- Mobile: React Native (Expo) — current status
- Contracts: 9 Soroban contracts, deployed to testnet
- SDKs: TypeScript + Python clients
- DB: SQLite (WAL mode) — see Database below
No database server to install — SQLite runs in-process and the file is created on first start.
- Run backend
cd backend
cp .env.example .env
# DATABASE_URL already defaults to sqlite:./stellar_insights.db
# set STELLAR_RPC_URL etc. as needed
cargo run- Run frontend
cd frontend
npm install
npm run devSQLite only. This is a compile-time property, not a configuration one:
sqlx is built with only the sqlite feature, backend/src/database.rs uses
SqlitePool/SqliteConnectOptions directly, and every migration is written in
SQLite-flavoured SQL.
Setting a postgresql:// DATABASE_URL does not switch databases — it
fails to parse as SqliteConnectOptions and the backend refuses to start.
Adding Postgres support is a code change. Whether to make it is being tracked
in issue #1876.
All 9 Soroban contracts are deployed to testnet.
contracts/.env.testnet is the source of truth —
it is generated by deploy-contracts-testnet.sh, so prefer reading it over
copying IDs from here.
| Contract | Testnet ID |
|---|---|
| Access Control | CAZO4LD7NSWZFUJCB5ORHS3IBFJC76KHSOCPTHVDBDBISZJ72ACSHPH5 |
| Stellar Insights | CAPHQZ4BBT43HU5EUSJAOPKWB66HGLTN4AKJUALV3R2RXS4A6IOXWUTL |
| Analytics | CAJAIBW6BXRSM4CW76KRWM2UVDJOWYYPJROO2EIHB376MP6V3PGTORNF |
| Governance | CCBGEJY2CNM7XOMV5D25NARRW6MKMFW3XOU72YQOMC7VUWHNENHM3JQV |
| Escrow | CCI3YVIWBXM5YMOJZGN26CZDVQ2WRZJFSOLU6FCF4KDZ3O2KFCI7RSI2 |
| Token Swap | CDUQO3ZZICNSRIUHGA6EAL2KIMKDYFURBVGOPWDEJKPJ3P2WKSHPIOQN |
| Multi-sig Wallet | CC6I665SUO7IY5IEQ4YGPBHTIX6HJJ5GB3BUQQFBB2KUI7GQT2AITLPK |
| Time-locked Transactions | CBAFVZVCQJQXXK5BBKIX7ERC7ULYNTGF3DFLTFSF4GYE77GNUOOOYIJV |
| Upgrade | CBT3WW736ZU3GYPCE5S6GB4QHX3FDFSC53LZRSBRHQBMRD2HWR7DXZXB |
Network: Test SDF Network ; September 2015 via
https://soroban-testnet.stellar.org.
See docs/testnet-quickstart.md for interacting with them.
scripts/check_folder_size.sh(fails if any folder >200MB).github/workflows/enforce-folder-size.yml
| Path | Contents |
|---|---|
backend/ |
Rust analytics engine — REST, GraphQL and WebSocket API |
frontend/ |
Next.js dashboard |
mobile/ |
React Native (Expo) app — current status |
contracts/ |
Soroban contracts (Rust, no_std) |
sdk/ |
TypeScript and Python API clients |
docs/ |
Project documentation |
scripts/ |
Build, deploy and maintenance scripts |
tests/ |
Cross-cutting / end-to-end tests |
k8s/, terraform/ |
Deployment manifests and infrastructure as code |
elk/, monitoring/ |
Logging and observability stack configs |
- History has been cleaned to reduce clone size.
- Use
git lfsfor large binaries. - For full operational details, see
docs/and module READMEs.