Hetu Chain CLI

---

Causality Graph Future In Web3

SDK • Chain • Research

---

The Hetu CLI, hetucli, is a powerful command line tool for interacting with the Hetu blockchain. You can use it on any macOS, Linux, or WSL terminal to manage wallets, transfer HETU, query balances, interact with smart contracts, and more. Help information can be invoked for every command and option with --help.

Documentation

Installation steps are described below. For full documentation on how to use hetucli, see the Hetu CLI section on the developer documentation site.

---

Features

• Wallet management (create, query balance, export private key)
• HETU transfer, signing, send transaction
• Query on-chain balance
• Contract call (read-only)
• Command line powered by Typer

---

Install on macOS and Linux

You can install hetucli on your local machine directly from source or PyPI. Make sure you verify your installation after you install:

Install from PyPI

Run

pip install -U hetu-pycli
hetucli --help

Install from source

1. Clone the Hetu CLI repo.

git clone https://github.com/hetu-project/hetu-pycli.git

2. cd into hetu-pycli directory.

cd hetu-pycli

3. Create and activate a virtual environment.

make init-venv

4. Install dependencies and the CLI:

Using Poetry

pip install -U pip setuptools poetry
poetry install

Or, using Pip:

pip install .

---

Usage

You can invoke the CLI using the following command:

python -m hetu_pycli.cli --help

Or, if installed as a script:

hetucli --help

Wallet management

hetucli wallet create
hetucli wallet balance <address> --rpc <rpc_url>

Transfer

hetucli tx send --private-key <key> --to <address> --value <hetu> --rpc <rpc_url>

Configuration

Set the contract address

hetucli c set whetu_address <address>
hetucli c set staking_address <address>
hetucli c set subnet_address <address>
hetucli c set neuron_address <address>
hetucli c set amm_address <address>

Main Process(New,Staking,Swap)

New A Subnet

hetucli w import <private-key> --name test0
hetucli whetu deposit  --sender test0 --value  1000
hetucli whetu balance-of  test0
hetucli subnet get-network-lock-cost
hetucli whetu approve --spender <subnet_address>  --value 100 --sender test0 
hetucli subnet update-network-params --network-min-lock 100000000000000000000  --network-rate-limit 1 --lock-reduction-interval 10000  --sender <address>
hetucli subnet regist --sender test0 --name "AI Vision" --description "Computre vision and image processing network" --token-name "VISION" --token-symbol "VIS"

Staking and Participation

hetucli whetu approve --spender <stake_address>  --value 100 --sender test0
hetucli stake add-stake --sender test0 --amount 100
hetucli stake total-staked
hetucli stake allocate-to-subnet --netuid 1  --sender test0 --amount 50
hetucli neuron regist --sender test0 --netuid 1 --is-validator-role  --axon-endpoint "http://my-node.com" --axon-port 8080 --prometheus-endpoint "http://my-metrics.com" --prometheus-port 9090

Trading Subnet Tokens

hetucli subnet subnet-info --netuid 1 
hetucli c set amm_address <amm_pool_address>
hetucli amm pool-info
hetucli whetu approve --spender 0xa16E02E87b7454126E5E10d957A927A7F5B5d2be  --value 100 --sender test0
hetucli amm swap-hetu-for-alpha --hetu-amount-in  100 --alpha-amount-out-min 0   --sender test0 --to <to-address>

WHETU

hetucli whetu deposit --contract <address> --sender <address> --value <amount>
hetucli whetu withdraw --contract <address> --sender <address> --amount <amount>
hetucli whetu balance-of --contract <address> --account <address>
hetucli whetu transfer --contract <address> --to <address> --value <amount> --sender <address>
hetucli whetu approve --contract <address> --spender <address> --value <amount> --sender <address>
hetucli whetu total-eth --contract <address>
hetucli whetu total-supply --contract <address>
hetucli whetu nonces --contract <address> --owner <address>

Staking, Subnet, Swap

hetucli stake total-staked --contract <address>
hetucli stake add-stake --contract <address> --sender <address> --amount <amount>
hetucli subnet next-netuid --contract <address>
hetucli subnet register-network --contract <address> --sender <address> --name ... --description ... --token-name ... --token-symbol ...
hetucli amm alpha-price --contract <address>
hetucli amm swap-hetu-for-alpha --contract <address> --sender <address> --hetu-amount-in <amount> --alpha-amount-out-min <amount> --to <address>

Contract call

hetucli contract call --address <contract_addr> --abi-path <abi.json> --function <fn> --args "1,2,3" --rpc <rpc_url>

---

Running Tests & Development

To run the tests, ensure you have the Hetu CLI installed and configured. Then, execute:

poetry run pytest tests

---

License

This project is licensed under the MIT License.