Early test network: unaudited, and nothing on it has real value. What this means

Install

There are no ready-made downloads or apps yet. For now SmartNodes is built from source on Linux. Apps for Windows, macOS, Android and iPhone come later.

The programs

ProgramWho needs itWhat it does
smartvpnUsersThe VPN client: connects through two hops, buys and uses bridges, flags bad nodes.
smartnodeNode operatorsRuns an entry, exit or bridge node.
smartnodesdEveryone who talks to the chainThe chain itself, and the command line for chain transactions and queries.
smartprobeProbersTests the nodes the chain assigns, and reports results.
ticketctlTest network onlyMakes test ticket wallets and test issuer keys. It must never be used for anything of value.

What you need

  • A 64-bit Linux machine with root access and a kernel from 5.6 on, which has WireGuard built in.
  • Go 1.26 or newer, and git.
  • For the client and nodes: wireguard-tools, iproute2 and iptables. The kernel's built-in WireGuard is used.
  • For the disguise and bridges: Xray.
  • jq and curl, which the examples use.
sudo apt update
sudo apt install -y git wireguard-tools iproute2 iptables jq curl

Build from source

git clone https://github.com/mspvantage/smartnodes.git
cd smartnodes
go build -o bin/ ./cmd/...
sudo install -m 0755 bin/* /usr/local/bin/

This builds all five programs into bin/ and copies them to /usr/local/bin. It takes a few minutes the first time, while Go downloads what the code depends on.

Install Xray

Only needed for the disguise, bridges and probing disguised nodes. Download the Linux release for your machine from the Xray releases page, check its checksum, and put the xray program in /usr/local/bin:

unzip Xray-linux-64.zip xray
sudo install -m 0755 xray /usr/local/bin/xray
xray version

Check it worked

smartnodesd version
smartvpn          # prints its commands
smartnode -h      # prints its options

Updating

cd smartnodes
git pull
go build -o bin/ ./cmd/...
sudo install -m 0755 bin/* /usr/local/bin/

Restart any running node or client afterwards. While the network is in testing, an update can change the chain's rules, and the test chain may be restarted from scratch.