Quick Start

Install Go
BlockX is built using Go version 1.18+
go version
If the blockxd: command not found error message is returned, confirm that your GOPATHis correctly configured by running the following command:
export PATH=$PATH:$(go env GOPATH)/bin

Install Binaries


Clone and build BlockX using git:
git clone https://github.com/blockx/blockx.git
cd blockx
git checkout <tag>
make install
Check that the blockxd binaries have been successfully installed:
$ blockxd
Blockx Daemon
blockxd [command]
Available Commands:
add-genesis-account Add a genesis account to genesis.json
collect-gentxs Collect genesis txs and output a genesis.json file
config Create or query an application CLI configuration file
debug Tool for helping with debugging your application
export Export state to JSON
gentx Generate a genesis tx carrying a self delegation
help Help about any command
index-eth-tx Index historical eth txs
init Initialize private validator, p2p, genesis, and application configuration files
keys Manage your application's keys
migrate Migrate genesis to a specified target version
query Querying subcommands
rollback rollback cosmos-sdk and tendermint state by one height
rosetta spin up a rosetta server
start Run the full node
status Query remote node for status
tendermint Tendermint subcommands
testnet subcommands for starting or configuring local testnets
tx Transactions subcommands
validate-genesis validates the genesis file at the default location or at the location passed as an arg
version Print the application binary version information
-b, --broadcast-mode string Transaction broadcasting mode (sync|async|block) (default "sync")
--chain-id string Specify Chain ID for sending Tx (default "testnet")
--fees string Fees to pay along with transaction; eg: 10aphoton
--from string Name or address of private key with which to sign
--gas-adjustment float adjustment factor to be multiplied against the estimate returned by the tx simulation; if the gas limit is set manually this flag is ignored (default 1)
--gas-prices string Gas prices to determine the transaction fee (e.g. 10aphoton)
-h, --help help for blockxd
--home string directory for config and data (default "/root/.blockxd")
--keyring-backend string Select keyring's backend (default "os")
--log_format string The logging format (json|plain) (default "plain")
--log_level string The logging level (trace|debug|info|warn|error|fatal|panic) (default "info")
--node string <host>:<port> to tendermint rpc interface for this chain (default "tcp://localhost:26657")
--trace print out full stack trace on errors
Use "blockxd [command] --help" for more information about a command.


You can build BlockX using Docker by running:
make build-docker
The command above will create a docker container: tharsishq/blockx:latest. Now you can run blockxd in the container.
docker run -it -p 26657:26657 -p 26656:26656 -v ~/.blockxd/:/root/.blockxd tharsishq/blockx:latest blockxd version
# To initialize
# docker run -it -p 26657:26657 -p 26656:26656 -v ~/.blockxd/:/root/.blockxd tharsishq/blockx:latest blockxd init test-chain --chain-id test_9000-2
# To run
# docker run -it -p 26657:26657 -p 26656:26656 -v ~/.blockxd/:/root/.blockxd tharsishq/blockx:latest blockxd start
Last modified 7mo ago