Nodes

guruGuru
search

Nym Testnet - Setup Guide

Back to projectRU
Stuck? AsktelegramNodes Guru telegram community

Rent on

 

!!!!!! YOU MUST SAVE YOUR KEYS FILES FROM /.nym/mixnodes/<your_id>/data (four .pem files) IN SAFE PLACE! And wallet mnemonic phraseThis is the only way to prove your participation in the testnet.

This is the guide for non-incentivized permanent Sandbox testnet.
Sandbox faucet for NYMT test tokens.

Installing

If you don’t already have a wallet, follow step 3. Install Wallet, then go to the next step.
Replace YOUR_WALLET with your wallet.

wallet=YOUR_WALLET
echo 'export wallet='$wallet >> $HOME/.bash_profile


Use our script for a quick installation:

wget -O nym_sandbox.sh https://api.nodes.guru/nym_sandbox.sh && chmod +x nym_sandbox.sh && ./nym_sandbox.sh

After installation, continue with step 1.3
To update the 0.11.0 node from the Milhon testnet, start with step 1.

1. Update from 0.11.0 to 0.12.1

If you don’t already have a wallet, follow step 3. Install Wallet, then go to the next step.
1.1 Replace YOUR_WALLET with your wallet.

wallet=YOUR_WALLET
echo 'export wallet='$wallet >> $HOME/.bash_profile

1.2 Run the update script:

wget -O nym_upgrade.sh https://api.nodes.guru/nym_upgrade.sh && chmod +x nym_upgrade.sh && ./nym_upgrade.sh

1.3 Open a new wallet. Log in with the mnemonic phrase.
Select a test network Sandbox, go to the Bond wallet section and fill out all the lines, the data for filling can be found by running the command on the node:

. $HOME/.bash_profile
nym-mixnode node-details --id $node_id

Press BOND, everything should go without errors. If all went well you should get this result


1.4 Let’s get back to terminal and check when your node starts mixing packets.
Command to check:

journalctl -u nym-mixnode -o cat | grep "Since startup mixed" 

1.5 Make sure you have your ports open: 1789, 1790, 8000 (and 443, 22, 80) for correct operation and rewards. More info about ports in official docs.
Check your ports and ipv4+ipv6 availability in mixnode checker

1.6 If everything goes correctly, your node will appear in Nodes.Guru Nym Checker and in Sandbox Explorer.

2. DELEGATION

2.1 To delegate, you need to open a wallet and select Delegate, do not forget to leave a coin for the commission.
Mixnode Identity – Identity key of mixnode to delegate to (Nodes.Guru mixnode 2cFpCe7yP79CcuRpf6JBRdJaSp7JF5YcA5SHi8JVm1d2)
Amount to delegate – amount of tokens to delegate
Click DELEGATE STAKE.


You can check your delegation in the list of that mixnode you delegate to at mixnode checker

3. Install Wallet

3.1 Download the wallet at the link. Available only on Windows 10.
Versions for other OS available here

3.2 Insert the mnemonic and get into the wallet, if you not have mnemonic create new account, this is the end of the installation.
Go to point 1. Update or 2. DELEGATE (if you don’t want to install a node).

4. Useful commands

4.1 Check how many packets your node mixed:

journalctl -u nym-mixnode -o cat | grep "Since startup mixed" | tail -1

4.2 Restart your node:

systemctl restart nym-mixnode

4.3 Extend ulimit (important for mixnode’s health in future):
oneliner autoscript:

wget -O nym_ulimit.sh https://api.nodes.guru/nym_ulimit.sh && chmod +x nym_ulimit.sh && ./nym_ulimit.sh

commands for manual change:

echo "DefaultLimitNOFILE=65535" >> /etc/systemd/system.conf
sudo systemctl daemon-reload
sudo systemctl stop nym-mixnode
sudo systemctl start nym-mixnode

Check that ulimit has changed to 65535

grep -i "Max open files" /proc/$(ps -A -o pid,cmd|grep nym-mixnode | grep -v grep |head -n 1 | awk '{print $1}')/limits

4.4 Ipv6 checks
See whats your external ipv6:

curl http://v4v6.ipv6-test.com/api/myip.php && echo

Check connection via ipv6 to google.de:

ping6 www.google.de

Check if you got ipv6 on your network settings:

hostname -I

4.5 Decypher your public Identity and Sphinx keys:
Run commands (snapd may be installed differently on your OS):

apt install snapd
snap install base58
ls -1 $HOME/.nym/mixnodes/*/data/public_identity.pem | while read F; do echo === $F ===; grep -v ^- $F | openssl base64 -A -d | base58; echo; done
ls -1 $HOME/.nym/mixnodes/*/data/public_sphinx.pem | while read F; do echo === $F ===; grep -v ^- $F | openssl base64 -A -d | base58; echo; done

Delete node:

sudo systemctl stop nym-mixnode
sudo systemctl disable nym-mixnode
rm -rf ~/nym ~/.nym
rm -f /etc/systemd/system/nym-mixnode.service
rm -f /usr/bin/nym-mixnode

Troubleshooting

If you still got problems with node (for example ‘could not create TCP Listener’; or mixed packets are still 0 after 10 minutes of running), check the following:
1) is TCP 1789 port opened on server?
2) is TCP 1789 port opened for inbound and outbount on Firewall at your server control panel (website)?
3) If you use Google Cloud, AWS, run node on hostings outside those NodesGuru recommend, or even run it at desktop or virtual machine:
4.1) check that you got static ip
4.2) check official docs about custom –init and how to set internal/external ips as host/announce host
4.3) make sure you put external ip in Bond form