Network · node operators

Run a TSN node.

Join the network in minutes. Download the binary, create a wallet, and start mining the post-quantum blockchain.

DevnetV2 gen4 is live

The network below is DevnetV2 gen4, live now. Relay nodes have become Service Nodes and take a share of every block. The commands on this page are the ones to use. Read the devlog ↗

01 Requirements

Hardware requirements.

Minimum specifications per node role. SSD storage is strongly recommended for all roles.

Role	CPU	RAM	Disk	Network
Miner	4+ cores	8 GB+	100 GB SSD	100 Mbps
Relay	2+ cores	4 GB+	200 GB SSD	100 Mbps
Light client	1 core	1 GB	1 GB	10 Mbps

02 Quick start

Running in under five minutes.

Requires the Rust toolchain (1.75+).

wallet setup

# Step 0: Create your wallet first
./tsn new-wallet --output wallet.json
# Write down the 24-word seed phrase! It is the ONLY way to restore your wallet.
# To restore a wallet from seed phrase:
./tsn restore-wallet --seed "word1 word2 ... word24" --output wallet.json

terminal

# Download the published binary — no build needed
# Latest release: https://github.com/trusts-stack-network/tsn-releases/releases/latest
curl -LO https://github.com/trusts-stack-network/tsn-releases/releases/download/v3.0.0-rc.22/tsn-3.0.0-rc.22-linux-x86_64.tar.gz
tar xzf tsn-3.0.0-rc.22-linux-x86_64.tar.gz

# Check it
./tsn --version

03 Configuration

All settings, one flag away.

All node settings are passed as CLI flags. No config file needed.

--miner-pk-hash <64-hex>The Address that receives your block rewards. Printed by ./tsn new-wallet.

--data-dir ./tsn-dataWhere the chain is stored. Required — without it the node falls back to a default path.

-t, --threads 4CPU threads used for mining.

--port 9434HTTP port for this node’s local API.

--p2p-port 9433Port used to talk to other nodes.

--peer /ip4/<ip>/tcp/9433Extra peer to dial. Omit it and the node dials the network seeds on its own.

--bind 127.0.0.1Address the HTTP listener binds to. A public bind also needs --accept-public-launch.

04 Mining

Point the miner at your wallet.

A miner is identified by the Address its wallet prints. Pass it with --miner-pk-hash and every block you win pays that wallet. Rewards are claimed for you automatically.

mik registration

# 1. Create a wallet. Write down the 24 words, and note the Address.
./tsn new-wallet

# 2. Mine, using that Address (64 hex characters) as your miner key.
#    --data-dir is required: it is where the chain is stored.
./tsn miner-v2 --miner-pk-hash <64-hex Address> \
               --data-dir ./tsn-data -t 4

# Block rewards are claimed automatically. Nothing else to run.
./tsn balance

50 TSN per block

Reward distribution is hard-coded in the protocol. No governance vote needed.

Updated May 2026 — previously 85% / 8% relay pool / 7% dev. See announcement ↗

90%Miner

5%Service nodes

5%Dev fund

05 RPC API

The local RPC surface.

Available on localhost:3030 when the node is running. All responses are JSON.

GET/chain/infoBlock height, difficulty, hash rate, chain ID

GET/peersList of connected peers with latency and role

GET/sync/statusSync progress, current vs. target block height

POST/tx/submitSubmit a signed transaction to the mempool

GET/blocks/:heightGet block header and transactions by height

This is the node's own local API, separate from the public network endpoints this site reads from. See the node map for live network data.