Comment on page
ixo Blockchain (old)
The Impact blockchain for the Cosmos ecosystem
The following 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.
We recommend the use of Docker and Docker Compose. The configuration files are provided in the
ixo-blockchain
directory.You will need the following to install and run the
ixo
binary:Optional:
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
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.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.Go back to
session 1
.Stop the running node using
CTRL
+ C
.There are two ways to restart the node:
- 1.With the same data and continuing from the same block height.
ixod start
- 2.or with the data reset to the first time the node started successfully and from block height 1.
make run_with_all_data
Create a Docker image called
ixo-chain
and 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.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.Go back to
bash session 1
.Stop the running node using
CTRL
+ C
.bashThere are two ways to restart the node:
- 1.With the same data and continuing from the same block height.
ixod start
- 2.or with the data reset to the first time the node started successfully and from block height 1.
make run_with_all_data
Last modified 4mo ago