Exchange Core

Derivatives Exchange for Frontier FX

Build

# installs git dependencies pinned in foundry.toml (into ./lib)
# (this repo does not use git submodules)
forge install

forge build

Tests

forge test

Go to test folder for more details on how to run different tests.

Documentation

Go to docs to understand the high-level design, transaction flow, and how different Numo derivatives components work together.

The live focus is deliverable FX futures for frontier currencies (e.g. USDC/cNGN), built on the shared cross-margin core (subaccounts, cash, security module, auction, standard risk manager). Options, perps, and squared-perp assets also live in src/assets.

Deployments

DEPLOYED_ADDRESSES.md is the source of truth for live contract addresses; the per-network JSON artifacts under deployments/ back it. Note that it also lists abandoned deployments explicitly — do not integrate against those.

Static Analysis - Slither

Please go to the link above for detail to install. To run the analysis:

slither src

Deployment

Go to scripts to understand how to deploy Numo markets to different networks. See scripts/ops for the always-on FX feed publisher that keeps a live market tradeable (a stale spot feed freezes trading, withdrawals, and liquidations — any path that reads margin; pure deposits still go through).