Stargate Backend

NestJS API, PostgreSQL database, Redis event delivery, webhooks, settlement, compliance, and Rust reconciler sidecar.

Local Services

docker compose up -d postgres redis
cp .env.example .env
npm install
npm run db:migrate
npm run start:dev

GraphQL Gateway

The backend exposes an opt-in GraphQL gateway at POST /graphql when the environment variable GRAPHQL_GATEWAY_ENABLED is set to true.

The gateway wraps existing authenticated REST operations and currently supports invoice and merchant queries plus invoice creation and refunds.

Verification

npm run typecheck
npm test
npm run test:e2e
npm run build
npm run generate:openapi
cargo test --manifest-path reconciler/Cargo.toml

The generated docs/openapi.yaml is the source of truth for stargate-frontend.

Production Readiness

Copy .env.production.example into your secret manager, never into Git as a real .env.production.

The API exposes deployment smoke-test endpoints:

• GET /health checks Postgres and Redis.
• GET /health/deep adds RPC and queue context for authenticated monitoring.
• GET /health/rpc checks Stellar Horizon and Soroban RPC reachability.

Before launch, run:

scripts/generate-secrets.sh
scripts/pre-launch-audit.sh

Operational runbooks live in docs/LAUNCH_RUNBOOK.md and docs/RECOVERY.md.

Changelog and Versioning

See CHANGELOG.md for a record of all notable changes. See docs/VERSIONING.md for the semantic versioning and release policy.

License

MIT