nym

The platform is composed of multiple Rust crates. Top-level executable binary crates include:

• nym-node - a tool for running a node within the Nym network. Nym Nodes containing functionality such as mixnode, entry-gateway and exit-gateway are fundamental components of Nym Mixnet architecture. Nym Nodes are ran by decentralised node operators. Read more about nym-node in Operators Guide documentation. Network functionality of nym-node (labeled with --mode flag) can be:
  • mixnode - shuffles Sphinx packets together to provide privacy against network-level attackers.
  • gateway - acts sort of like a mailbox for mixnet messages, which removes the need for direct delivery to potentially offline or firewalled devices. Gateways can be further categorized as entry-gateway and exit-gateway. The latter has an extra embedded IP packet router and Network requester to route data to the internet.
• nym-client - an executable which you can build into your own applications. Use it for interacting with Nym nodes.
• nym-socks5-client - a Socks5 proxy you can run on your machine and use with existing applications.
• nym-explorer - a (projected) block explorer and (existing) mixnet viewer.
• nym-wallet - a desktop wallet implemented using the Tauri) framework.
• nym-cli - a tool for interacting with the network from the CLI.

                      ┌─►mix──┐  mix     mix
                      │       │
            Entry     │       │                   Exit
client ───► Gateway ──┘  mix  │  mix  ┌─►mix ───► Gateway ───► internet
                              │       │
                              │       │
                         mix  └─►mix──┘  mix

This project integrates with the Midnight Network

• Platform build instructions are available on Nym Operators Guide documentation.
• Wallet build instructions are available here.

References for developers:

• Dev Docs
• SDKs
• Network Docs
• Release Cycle - git flow

• Publishing Rust crates to crates.io
• Publishing the TypeScript SDK to npm

You can chat to us in the #dev channel on Matrix or on the Nym Forum.

Nym network economic incentives, operator and validator rewards, and scalability of the network are determined according to the principles laid out in the section 6 of Nym Whitepaper. Initial reward pool is set to 250 million Nym, making the circulating supply 750 million Nym.

This is a monorepo and components that make up Nym as a system are licensed individually, so for accurate information, please check individual files.

As a general approach, licensing is as follows this pattern:

• applications and binaries are GPLv3
• libraries and components are Apache 2.0 or MIT
• documentation is Apache 2.0 or CC0-1.0

Nym Node Operators and Validators Terms and Conditions can be found here.

Requires Node.js version 24.

pnpm install

pnpm build