Skip to main content
Version: v1.0.2 (stable)

Using Apps with Nym

Nym is a general purpose system. We aim to provide the strongest possible protections for internet traffic and transactions.

Many existing applications are able to use the SOCKS5 proxy protocol. They can use the nym-socks5-client to bounce their network traffic through the Nym network, like this:

Overview diagram of the Nym networkOverview diagram of the Nym network

If you have not yet set up a local socks5 client, follow the instructions here before continuing.

The Nym SOCKS5 proxy, though, does something quite interesting and different. Rather than simply copy data between TCP streams and making requests directly from the machine it's running on, it does the following:

  • takes a TCP data stream in, e.g. a request from a crypto wallet
  • chops up the TCP stream into multiple Sphinx packets, assigning sequence numbers to them, while leaving the TCP connection open for more data
  • sends the Sphinx packets through the mixnet to a nym-network-requester. Packets are shuffled and mixed as they transit the mixnet.
  • nym-network-requester reassembles the original TCP stream using the sequence numbers, and makes the intended request.
  • nym-network-requester then does the whole process in reverse, chopping up the response into Sphinx packets and sending it back through the mixnet to the crypto wallet.
  • The crypto wallet receives its data, without even noticing that it wasn't talking to a "normal" SOCKS5 proxy.