privacy chain · testnet · port 19191

How to

Node and wallet TUI on your own machine. Linux first, x86_64.

1. Download

  1. Get the package from the download page: nyr-0.1.0.zip.
  2. Unpack. Inside: the nyr binary (Linux x86_64) and the spec.
  3. Make it executable:
chmod +x nyr
sudo install -m 755 nyr /usr/local/bin/nyr
nyr --help

After that, just nyr — not /opt/nyr/nyr. Wordlist is in the binary, glibc only.

2. Chain file

A node keeps the chain in one file. Genesis is created on first start. If the file is /var/lib/nyr/nyr.chain, nyr finds it on its own.

sudo mkdir -p /var/lib/nyr
nyr status

Reference node: v41089.1blu.de:19191 · port 19191 (P2P). 19192 is reserved.

3. Start a node

  1. Create a receive address in NÝR-Wallet.
  2. In a terminal:
nyr node

In a terminal this opens the node TUI (English, same feel as the wallet TUI). If the node is already a service, the TUI only attaches — Q closes the screen, not the node. Reward and peers: R P, seal/drop: S D. Without a terminal: nyr node --plain.

The node counts work seconds (0.00001 NÝR/s, cap 0.86400/day) and seals transfers. Open TCP 19191 if other nodes should reach you.

On testnet a transfer confirms once 2 other nodes have acknowledged it.

NFTs — pictures beside the chain

Each NFT image is a JPEG, at most 512×512, stored next to the chain file: nft/<blake2b>.jpg. The chain keeps only the hash and the owner address. The NÝR-NFT app picks an image, crops/scales it, POSTs it to a node (IP:port, default 195.90.214.85:19191) and mints there. Nodes gossip the files — if one node dies, the pictures stay on the others.

Minting costs 0.25000 NÝR — deliberately expensive. The fee goes to the reward wallet of the node that stores the picture.

HTTP: POST /nft (JPEG) · POST /nft/mint · GET /nft · GET /nft/{hash} · fee 0.25000 NÝR

Keys — node TUI

KeyAction
R[R] Reward — address that receives the work
P[P] Peers — 1–5 gossip nodes
S[S] Seal — seal the mempool now
D[D] Drop — pay accrued work now (test)
Q[Q] Quit — stop the node

4. Wallet TUI

nyr wallet

The TUI is English only. Node and wallet are separate: the wallet never reads the chain file; it pulls blocks from nodes (P Peers, default 127.0.0.1:19191 and v41089.1blu.de:19191). Already synced heights are not fetched again; new/import runs a full scan including HD addresses (gap 20). The seed is 13 Latin words. Passphrase file ~/.nyr/nyr.wallet. History: H, addresses: A then N, sync: Y. Word backup: B.

Keys — start

KeyAction
N[N] New — create a wallet with a passphrase
O[O] Open — stored file
I[I] Import — 13 words, then passphrase
P[P] Peers — other nodes (1–5)
Q[Q] Quit

Keys — wallet open

KeyAction
S[S] Send (Tab cycles fields, Enter submits)
H[H] History — movements, Enter for details (memo, height, TxHash)
A[A] Addresses — list, [N] new receive address
N[N] Notes (open amounts, only you see them)
B[B] Seed — show backup, Esc hides it
P[P] Peers — other nodes
Y[Y] Sync — fetch new blocks from a node
W[W] New — replaces the current wallet file (full scan)
I[I] Import another wallet (full scan)
EscBack / close wallet
Q[Q] Quit

Send: recipient nyr1…, amount with a comma (e.g. 0,25000), memo only for the two of you. Esc cancels.

Web UI

The same chain can be viewed in the browser (explorer, wallet with a passphrase file). The TUI does not need that. Seed backup there is also only via Backup.