Tockchain Testnet Guide for Testers

Join the Tockchain public testnet and gain early access to the infrastructure powering the next generation of stablecoins

Introduction

Welcome to the Tockchain Public Testnet!

Project Tockchain is a research initiative for a standalone Layer 1 blockchain with native Qubic integration. If our research proves successful, Tockchain will serve as the foundation for Valis Stablecoins. VUSD, our first stablecoin, will be issued on both Qubic and Tockchain.

This guide will walk you through the steps to set up the Tockchain VUSD CLI and send transactions to the testnet. You can participate in testing the public testnet without needing to run your own node. Transactions will be submitted through the Tockchain CLI, which will redirect to Qsilver's main server for broadcasting.

If you would like to participate as a node operator instead, check out the “Tockchain Testnet Guide for Node Operators” for instructions.

By sending transactions, you will help enhance network resilience and validate performance at scale.

Steps

Step 1: Prepare the Hardware

The Tockchain CLI is lightweight and currently supports only Unix-based systems (Linux is recommended).

Step 2: Install Secp256k1 Library

Secp256k1 is a security tool that helps sign transactions and verify them on Tockchain. Specifically, Secp256k1 is a cryptographic library used for elliptic curve cryptography (ECC). ‘ECC’ is a secure math method for transactions, like a digital lock. This step installs it on your server.

# Clone the secp256k1 library (used for secure transactions).
git clone https://github.com/bitcoin-core/secp256k1
cd secp256k1

# Set up for signing transactions securely.
cmake -DSECP256K1_ENABLE_MODULE_RECOVERY=ON .

# Build and install it.
make
sudo make install
sudo ldconfig

# Return to the previous directory.
cd ..

Step 3: Download Tockchain CLI

Your node tools will live in a valis directory. This step sets up the Tockchain CLI tool.

The necessary files will be created in the valis directory and /var/www/html/VUSD, which must be accessible via a web server (set up in Step 5.3) to allow other nodes to fetch missing files using http://<your_ipaddress>/VUSD/. It’s not required to use Apache2 specifically; other web servers like Nginx are fine as long as the URL works.

For the Tockchain Core Testnet:

# Create a single valis directory in your home folder and move into it.
mkdir ~/valis

# Move into the valis directory.
cd ~/valis

# Download the Tockchain CLI tool.
wget https://raw.githubusercontent.com/valis-team/tockchain/main/CoreTestnet/CLI/tockchain-vusd-core-cli-v3.0.0

# Rename it to 'vcli' for easier use.
mv tockchain-vusd-core-cli-v3.0.0 vcli

# Make vcli executable (this lets vcli run as a program).
chmod +x vcli

Step 4: Install Websocat

Websocat is a simple tool that lets you send and receive messages over websockets—like a messenger using a phone line to talk to your node. You can use it to communicate with a Tockchain node once it’s deployed.

To install Websocat, follow these steps:

# Optionally, update system packages to ensure everything is up-to-date.
sudo apt update && sudo apt upgrade -y

# Download Websocat (version recommended by Valis).
wget https://github.com/vi/websocat/releases/download/v1.14.0/websocat.x86_64-unknown-linux-musl

# Rename the downloaded file to 'websocat' for easier use.
mv websocat.x86_64-unknown-linux-musl websocat

# Make websocat executable (this lets websocat run as a program).
chmod +x websocat

# Move Websocat to a directory in your PATH for global access.
sudo cp websocat /usr/local/bin