Skip to main content

​
HyperPaxeer Network CLI

hyperpaxd is the all-in-one command-line interface (CLI). It allows you to run an Paxeer Network node, manage wallets and interact with the Paxeer Network network through queries and transactions. This introduction will explain how to install the hyperpaxd binary onto your system and guide you through some simple examples how to use hyperpaxd.

​
Prerequisites

​
Go

Paxeer Network is built using Go version 1.20+. Check your version with: 
go version
Once you have installed the right version, confirm that your GOPATH is correctly configured by running the following command and adding it to your shell startup script: 
export PATH=$PATH:$(go env GOPATH)/bin

​
jq

Paxeer Network scripts are using jq version 1.6+. Check your version with: 
jq --version

​
Installation

You can download the latest binaries from the repo and install them, or you can build and install the hyperpaxd binaries from source or using Docker.

​
Download the binaries

  • Go to the releases section of the repository
  • Choose the desired release or pre-release you want to install on your machine
  • Select and download from the Assets dropdown the corresponding tar or zip file for your OS
  • Extract the files. The hyperpaxd binaries is located in the bin directory of the extrated files
  • Add the hyperpaxd binaries to your path, e.g. you can move it to $(go env GOPATH)/bin
After installation is done, check that the hyperpaxd binaries have been successfully installed: 
hyperpaxd version

​
Build From Source

Clone and build the Paxeer Network from source using git. The <tag> refers to a release tag on Github. Check the latest Paxeer Network version on the releases section of the repository: 
git clone https://github.com/Paxeer-Network/Paxeer-Network.git
cd Paxeer Network
git fetch
git checkout <tag>
make install
After installation is done, check that the hyperpaxd binaries have been successfully installed: 
hyperpaxd version
:::info If the hyperpaxd: command not found error message is returned, confirm that you have configured Go correctly. :::

​
Docker

When it comes to using Docker with Paxeer Network, there are two options available: Build a binary of the Paxeer Network daemon inside a dockerized build environment or build a Docker image, that can be used to spin up individual containers running the Paxeer Network binary. For information on how to achieve this, proceed to the dedicated page on working with Docker.

​
Run an Paxeer Network node

To become familiar with Paxeer Network, you can run a local blockchain node that produces blocks and exposes EVM and Cosmos endpoints. This allows you to deploy and interact with smart contracts locally or test core protocol functionality. Run the local node by executing the local_node.sh script in the base directory of the repository: 
./local_node.sh
The script stores the node configuration including the local default endpoints under ~/.tmp-hyperpaxd/config/config.toml. If you have previously run the script, the script allows you to overwrite the existing configuration and start a new local node. Once your node is running you will see it validating and producing blocks in your local Paxeer Network blockchain: 
12:59PM INF executed block height=1 module=state num_invalid_txs=0 num_valid_txs=0 server=node
# ...
1:00PM INF indexed block exents height=7 module=txindex server=node
For more information on how to customize a local node, head over to the Single Node page.

​
Using hyperpaxd

After installing the hyperpaxd binary, you can run commands using: 
hyperpaxd [command]
There is also a -h, --help command available 
hyperpaxd -h
It is possible to maintain multiple node configurations at the same time. To specify a configuration use the --home flag. In the following examples we will be using the default config for a local node, located at ~/.tmp-hyperpaxd.

​
Manage wallets

You can manage your wallets using the hyperpaxd binary to store private keys and sign transactions over CLI. To view all keys use: 
hyperpaxd keys list \
--home ~/.tmp-hyperpaxd \
--keyring-backend test

# Example Output:
# - address: Paxeer Network19xnmslvl0pcmydu4m52h2gf0std5ee5pfgpyuf
#   name: dev0
#   pubkey: '{"@type":"/ethermint.crypto.v1.ethsecp256k1.PubKey","key":"AzKouyoUL0UUS1qRUZdqyVsTPkCAFWwxx3+BTOw36nKp"}'
#   type: local
You can generate a new key/mnemonic with a $NAME with: 
hyperpaxd keys add [name] \
--home ~/.tmp-hyperpaxd \
--keyring-backend test
To export your Paxeer Network key as an Ethereum private key (for use with Metamask for example): 
hyperpaxd keys unsafe-export-eth-key [name] \
--home ~/.tmp-hyperpaxd \
--keyring-backend test
For more about the available key commands, use the --help flag 
hyperpaxd keys -h
:::tip For more information about the Keyring and its backend options, click here. :::

​
Interact with a Network

You can use hyperpaxd to query information or submit transactions on the blockchain. Queries and transactions are requests that you send to an Paxeer Network node through the Tendermint RPC. :::tip 👉 To use the CLI, you will need to provide a Tendermint RPC address for the --node flag. Look for a publicly available addresses for testnet and mainnet in the Networks page. :::

​
Set Network Config

In the local setup the node is set to tcp://localhost:26657. You can view your node configuration with: 
hyperpaxd config \
--home ~/.tmp-hyperpaxd
# Example Output
# {
# 	"chain-id": "hyperpax_125-1",
# 	"keyring-backend": "test",
# 	"output": "text",
# 	"node": "tcp://localhost:26657",
# 	"broadcast-mode": "sync"
# }
You can set your node configuration to send requests to a different network by changing the endpoint with: 
hyperpaxd config node [tendermint-rpc-endpoint] \
--home ~/.tmp-hyperpaxd
Learn about more node configurations here.

​
Queries

You can query information on the blockchain using hyperpaxd query (short hyperpaxd q). To view the account balances by its address stored in the bank module, use: 
hyperpaxd q bank balances [adress] \
--home ~/.tmp-hyperpaxd
# # Example Output:
# balances:
# - amount: "99999000000000000000002500"
#   denom: ahpx
To view other available query commands, use: 
# for all Queries
hyperpaxd q

# for querying commands in the bank module
hyperpaxd q bank

​
Transactions

You can submit transactions to the network using hyperpaxd tx. This creates, signs and broadcasts a tx in one command. To send tokens from an account in the keyring to another address with the bank module, use: 
hyperpaxd tx bank send [from_key_or_address] [to_address] [amount] \
--home ~/.tmp-hyperpaxd \
--fees 50000000000ahpx \
-b block

# Example Output:
# ...
# txhash: 7BA2618295B789CC24BB13E654D9187CDD264F61FC446EB756EAC07AF3E7C40A
To view other available transaction commands, use: 
# for all transaction commands
hyperpaxd tx

# for Bank transaction subcommands
hyperpaxd tx bank
Now that you’ve learned the basics of how to run and interact with an Paxeer Network network, head over to configurations for futher customization.