NexaFx-js

NexaFx-js is a high-performance NestJS enterprise platform supporting FX rates, multi-currency wallets, double-entry ledger bookkeeping, compliance, and Stellar blockchain transactions.

Features

• Multi-Currency Wallets: Manage wallet balances with threshold-based auto-sweeping.
• FX Rates & Conversions: Real-time exchange rate failover with locked preview quotes.
• Double-Entry Ledger: Immutable transaction recording and balance reconciliation.
• Compliance & Security: Integrated KYC/AML, IP allowlisting, and JWT authentication.
• Metrics & Observability: OpenTelemetry tracing and Prometheus metrics exposition.

Prerequisites

• Node.js: >=20.0.0
• Docker & Docker Compose
• PostgreSQL 14+
• Redis 7+

Quick Start

1. Installation

npm install

2. Environment Configuration

Copy .env.example to .env and fill in required variables:

cp .env.example .env

3. Running Locally

# Development mode
npm run start:dev

# Production build
npm run build
npm run start:prod

4. Running Tests & Linting

# Unit tests
npm test

# Type checking
npx tsc --noEmit

# Linter
npm run lint

# Check dependency wildcards
npm run check:no-wildcard-deps

5. Docker Deployment

docker-compose up --build