Welcome to the Ternoa Blockchain repo which hosts the code used to build and run the Ternoa node. Ternoa supports the transfer of arbitrary data to your descendants, friends and loved ones even after your death or disappearance or a given timed period in a non custodial, cryptographically enforced manner.
Table of Contents:
All the examples in this document assume that you use a Ubuntu like system. If that's not the case, you need to change the commands so that it works for your system.
# Downloads the package lists and "updates" them.
sudo apt update -y
# Installing all dependencies (but not Rust).
sudo apt install build-essential git clang curl libssl-dev llvm libudev-dev cmake make protobuf-compiler -y
# Installing Rust.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
# Starting a new bash environment so we have access to cargo and rust commands.
exec bash # Get repo and CD
git clone https://github.com/capsule-corp-ternoa/ternoa-node.git && cd ternoa-node
# Get submodules
git submodule update --init --recursive
# Updating Rust to latest versions and installing the right Rust version.
rustup update && rustup show
# Building the Ternoa Binary.
cargo build --locked --release
# Checking if everything is OK.
./target/release/ternoa -V # Downloads the package lists and "updates" them.
sudo apt update -y
# Installing podman.
sudo apt install podman
# Building the image using podman and the already available Dockerfile.
podman build -t tchain .
# Checking if everything is OK.
podman images | grep tchainNode flag explanation:
--chain alphanet-dev: There are a couple of chain configurations that we provide and each configuration has a drastic impact on how the chain behaves and what features it has. For testing purposes it's best to stick with alphanet-dev configuration.--alice: This sets a couple of flags for us. It sets the --validator flag so that the client is running in a validator mode, it makes Alice a validator and it inserts Alice's keys into the local keystore.--tmp: Makes is so that the blockchain data is stored in a temporary location. Usually this data is deleted on reboot.--name MyLocalNode: Sets the name of the name. This should be something unique.--rpc-external: Listen to all RPC interfaces. This should be used only during testing.--ws-external: Listen to all Websocket interfaces. This should be used only during testing.--rpc-cors all: Specifies browser Origins allowed to access the HTTP && WS RPC servers. This should be used only during testing.--telemetry-url "wss://telemetry.polkadot.io/submit/ 0": Tells the node to send node telemetry data to telemetry.polkadot.io.Podman flag explanation:
-p 127.0.0.1:9944:9944: Maps host 127.0.0.1:9944 address:port to container 9944 port. This is the Websocket traffic port.-p 127.0.0.1:9933:9933: Maps host 127.0.0.1:9933 address:port to container 9933 port. This is the RPC traffic port.-p 127.0.0.1:30333:30333: Maps host 127.0.0.1:30333 address:port to container 30333 port. This is the P2P port. # Make sure that you have built a binary from the "Build Locally" step.
./target/release/ternoa --chain alphanet-dev --alice --tmp --name MyLocalNode --rpc-external --ws-external --rpc-cors all --telemetry-url "wss://telemetry.polkadot.io/submit/ 0" # Make sure that you have built a image from the "Build With Podman" step.
podman run -p 127.0.0.1:9944:9944 -p 127.0.0.1:9933:9933 -p 127.0.0.1:30333:30333 tchainDepending on what binary you downloaded certain features might not be available in to use. To get the latest features get the latest binary. In this example the oldest binary is being used.
# Getting the binary from github.
wget https://github.com/capsule-corp-ternoa/chain/releases/download/v1.0.0/ternoa
# Makes the binary executable
chmod u+x ternoa
# Runs the chain
./ternoa --chain alphanet-dev --alice --tmp --name MyLocalNode --rpc-external --ws-external --rpc-cors all --telemetry-url "wss://telemetry.polkadot.io/submit/ 0" # Runs the chain
./ternoa --name MyFirstNode --chain mainnet --base-path /block/chain/node-data --ws-max-connections 1000 --prometheus-port 9615 --validator --telemetry-url "wss://telemetry.polkadot.io/submit/ 0" --state-pruning archive # Building the Ternoa Binary.
cargo build --locked --release --features runtime-benchmarks
# Run the benchmarks for the balances pallet.
./target/release/ternoa benchmark pallet --chain alphanet-dev --steps=50 --repeat=20 --extrinsic=* --execution=wasm --wasm-execution=compiled --heap-pages=4096 --output=./weights/ --pallet=pallet_balances # It's important to not omit the "--all-features" flag otherwise not all test will run.
cargo test --all --all-features # While compiling it might display some warning that can be safely ignored.
cargo doc --openIn the next examples some useful Podman commands will be shown. It's important to note that most flags have been omitted in order to make the examples more concise. Before running anything make sure that the image was built from the "Build With Podman" step.
If no command arguments are given by default it will try run the Ternoa Node with default parameters. To cancel this add bash at the end of the command. Example: podman run tsdk bash;
A container that was run and its job has been finished or the user has exited will not automatically be removed instead it will enter the Exit state.
To make sure that the container is deleted and removed after it's being used the flag --rm should be used.
# The --rm flag removes the container after usage.
podman run --rm tchain
# Stop the container
[ctrl+c]
# Check if any container is running or stopped.
podman ps -aThere are two virtual endpoints that can be mapped to real ones.
Container uses a local folder to store the chain data. This means that every time a new container is created the chain will start from block 0. To avoid this the container volume /data needs to mapped to a directory on the host machine. With this mapping done all the chain data will be stored on the host and it can be used with multiple containers.
# This folder will be used to stored ternoa node and chain data.
mkdir ternoa-data
# Flag -v tells the host machine to map the physical "./ternoa-data" path with the virtual container one "/data".
podman run -v ./ternoa-data:/data tchainContainer uses a local copy of the repo in order to compile and run the Ternoa Binary. This means that if code changes are made inside the container that they will not propagate and they will be lost. To change this the virtual container volume /workdir needs to be mapped to a directory on the host machine that contains the chain repo. With the mapping done any change in the mapped directory will be visible to the container.
This can be useful if you want to develop your own chain without installing all the dependencies for it. For the workflow check the Create A Development Environment segment.
# This folder will be used to stored ternoa node and chain data.
mkdir ternoa-data
# Flag -v tells the host machine to map the physical "./ternoa-data" path with the virtual container one "/data".
podman run -v ./.:/workdir tchainThe predefined operation/command of the container when run is to run the Ternoa Node with the alphanet-dev configuration. To execute a different operation additional commands can be passed at the end of the run command. Example: passing bash will run the bash shell session instead the default operation.
# If no command arguments are given this will try to run the Ternoa Node with default parameters.
# By passing "bash" we make sure that we run a bash shell session once the container starts.
podman run -it tchain bash # Flag "-d" runs the container in detached mode.
podman run -d tchain
# Access its shell.
podman exec -itl bashThe dockerfile is made in a way that it can be used to develop new applications with it. Example of a typical workflows:
cargo build and cargo check commands. mkdir ternoa-data
# Flag "--name" is used to name the container.
podman run -it --name my_chain_env -v ./ternoa-data:/data -v ./.:/workdir tchain bash
# Do some activity and exit the container
[root@d4ad8ec11655:/workdir] nano -V
[root@d4ad8ec11655:/workdir] apt install nano
[root@d4ad8ec11655:/workdir] exit
# Return to the same container
podman start my_chain_env
podman exec -it my_chain_env /bin/bash
[root@d4ad8ec11655:/workdir] nano -VCheck out our Wiki page. We are constantly adding new pages and guides there. Current Wiki content:
We have provided 3 different linux flavors which when built and executed generate the Ternoa Binary in that flavor. The following flavours are supported:
Besides those images we also have one dockerfile which uses Ubuntu 22.04 and contains all the necessary tools to compile and build the project.
Example on how to build one of those images:
podman build -t tchainarch -f ./dockerimages/arch.Dockerfile .