ixo Blockchain

The Impact blockchain for the Cosmos ecosystem
These instructions allow you to run a single node network on your local machine and interact with it using the command line interface (CLI). It is the simplest way to become familiar with the ixo Blockchain.
After completing this guide you can run a node on the pandora testnet.
We recommend the use of Docker and Docker Compose. The configuration files are provided in the ixo-blockchain directory.
Another way to interact with a node is the ixo MultiClient SDK, instead of CLI.

Prerequisites

You will need the following to install and run the ixo binary:
Optional:

Install ixo

The ixo binary is named ixod and serves as the node client and the application client. In other words, the ixo binary can be used to both run a node and to interact with it.
Clone the ixo repository:
git clone https://github.com/ixofoundation/ixo-blockchain.git
Change to the ixo-blockchain directory:
cd ixo-blockchain
Check out the latest stable version:
git checkout main
Local
Docker

Run a node

Start a session (let's refer to it as session 1).
Install the ixo binary.
#session 1
make install
Check to make sure the installation was successful.
ixod version
Start the ixo-blockchain node using pre-configured data.
./scripts/run_with_all_data.sh
The script will start the blockchain and create accounts appropriate for the ixo-blockchain to enable easy interaction. The blocks will progress and you should see the logs to confirm it.

Interact with the node

Start another session (let's refer to it as session 2).
Use the ixod CLI to query the total bank balances.
# session 2
ixod query bank total
You can now interact successfully with the ixo binary.

Stop and restart the node

Go back to session 1.
Stop the running node using CTRL + C.
There are two ways to restart the node:
  1. 1.
    With the same data and continuing from the same block height.
ixod start
  1. 2.
    or with the data reset to the first time the node started successfully and from block height 1.
make run_with_all_data

Run a node

Create a Docker image called ixo-chainand tagged devel.
docker build -f .infra/dockerfiles/Dockerfile -t ixo-chain:devel .
Compose a Docker container.
docker-compose up -d --build
Start a Bash session (let's refer to it as bash session 1).
# bash session 1
docker exec -it ixo_blockchain bash
Install the ixo binary.
make install
Check to make sure the installation was successful.
ixod version
Start the ixo-blockchain node using pre-configured data.
./scripts/run_with_all_data.sh
Script will start the blockchain and create accounts appropriate for the ixo-blockchain to enable easy interaction. The blocks will progress and you should see the logs to confirm it.

Interact with the node

Start another Bash session (let's refer to it as bash session 2).
# bash session 2
docker exec -it ixo_blockchain bash
Use the ixod CLI to query the total bank balances.
ixod query bank total
You can now interact successfully with the ixo binary.

Stop and restart the node

Go back to bash session 1.
Stop the running node using CTRL + C.bash
There are two ways to restart the node:
  1. 1.
    With the same data and continuing from the same block height.
ixod start
  1. 2.
    or with the data reset to the first time the node started successfully and from block height 1.
make run_with_all_data