Jędrzej Stuczyński 3730260cf0 feat(nym-node): mixnet packet latency instrumentation (#6852)
- PacketTrace stopwatch + generic Traced<T> carrier threaded receive -> socket-write
- TraceStage enum owns each stage's metric name/help/buckets; observations go straight
  to the global nym-metrics registry under a uniform mixnet_packet_* family
- stages: Unwrap, ReplayCheck (incl. deferral), ForwarderQueue, DelayQueue,
  DelayQueueOverrun (lateness beyond target release), EgressQueue, SocketWrite, Total
- node-side 1-in-N sampling via MixnetDebug.egress_trace_sample_rate (default 100, 0 disables)
2026-06-09 16:22:14 +01:00
2026-05-28 15:57:10 +00:00
2026-06-08 20:02:37 +02:00
2026-06-04 12:15:20 +01:00
2026-04-17 09:23:55 +01:00
2026-03-12 14:46:00 +00:00
2026-06-09 15:04:40 +02:00
2026-04-17 09:23:55 +01:00
2024-12-20 12:18:45 +01:00
2026-06-04 12:15:20 +01:00
2026-06-04 12:15:21 +01:00
2026-06-02 13:15:13 +02:00
2026-04-17 09:23:55 +01:00
2026-05-21 09:13:31 +01:00
2026-06-09 14:48:53 +02:00
2026-06-09 13:31:08 +00:00
2026-06-04 12:15:20 +01:00
2026-05-28 15:57:10 +00:00
2026-06-08 12:23:00 +02:00
2026-06-05 10:36:36 +00:00
2026-02-16 14:45:05 +01:00
2026-06-09 13:31:08 +00:00
2026-05-22 20:29:51 +01:00
2023-12-19 09:24:44 +01:00
2023-12-19 09:24:44 +01:00
2026-06-08 16:30:10 +02:00
2026-05-11 14:50:14 +00:00
2026-05-22 20:29:51 +01:00
2026-05-22 20:29:51 +01:00
2026-03-24 15:08:07 +00:00
2026-06-05 10:36:36 +00:00
2026-06-05 10:36:36 +00:00
2026-06-09 13:31:08 +00:00
2026-05-22 20:29:51 +01:00

The Nym Privacy Platform

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

Building

Developing

References for developers:

Developer chat

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

Tokenomics & Rewards

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.

Getting Started

pnpm install
pnpm build
S
Description
Nym provides strong network-level privacy against sophisticated end-to-end attackers, and anonymous transactions using blinded, re-randomizable, decentralized credentials.
Readme 377 MiB
Languages
Rust 65.9%
JavaScript 22.1%
TypeScript 9.1%
Shell 0.9%
Python 0.6%
Other 1.2%