Backend Engine Overview

The NMT backend is a Rust application that serves as the platform's data brain. It continuously reads data from blockchains and external APIs, processes it, and stores it in PostgreSQL for the frontend to consume.

What It Does

The backend has two main jobs:

1. Indexing — watches the blockchain for events (new positions, swaps, deposits) and records them in the database
2. Valuation — periodically calculates the USD value of every user position

The frontend reads data directly from the shared PostgreSQL database via Prisma — there is no REST API layer between the frontend and the database.

What It Does NOT Do

The backend never holds private keys and never submits transactions. It is purely a read-only data layer with respect to the blockchain. All transaction execution happens through the smart wallet layer.

Tech Stack

High-Level Architecture

+-----------------------------------------------+
|              Backend Application                |
|                                                 |
|  +---------+  +----------------+               |
|  | Workers |  |   Scheduler    |               |
|  | (DeFi)  |  | (cron-like)    |               |
|  +---------+  +----------------+               |
|       |              |                          |
|  +---------+  +---------+  +----------------+  |
|  | Storage |  |  Types  |  |   Channels     |  |
|  | (SeaORM)|  | (shared)|  | (messaging)    |  |
|  +---------+  +---------+  +----------------+  |
|       |                                         |
|  +---------+                                    |
|  |  Math   |                                    |
|  | (DeFi)  |                                    |
|  +---------+                                    |
+-----------------------------------------------+
         |
    PostgreSQL 16

Project Location

All backend code lives in backend/:

backend/
├── apps/server/          # Main application entry point
├── crates/
│   ├── api/              # REST API routes and middleware
│   ├── workers/          # DeFi data indexing engine
│   ├── storage/          # Database entities and queries
│   ├── types/            # Shared type definitions
│   ├── channels/         # Inter-service messaging
│   └── math/             # DeFi calculations
├── migrations/pg/        # PostgreSQL migrations
├── infrastructure/       # Docker and build configs
├── .helm/                # Kubernetes Helm charts
├── Cargo.toml            # Workspace manifest
└── Makefile              # Development commands

Quick Commands