Command Line Tool

The Theta ledger software provides a command line wallet tool thetacli for users to interact with the Theta ledger. Below is an example of sending tokens between two addresses.

Send and Receive Tokens

After building the Theta ledger, two binaries thetaand thetacli are generated. theta can be regarded as the launcher of the Theta Ledger node, and thetacli is a wallet with command line tools to interact with the ledger. We can use the thetacli command line tool to send Theta tokens from one address to another.

The examples below illustrates how to send Theta/TFuel tokens using thetacli against a local private net. Open a terminal, and execute the following command. When the prompt asks for password, simply enter qwertyuiop. Note that this simple password was just for demo purpose for sender 2E833968E5bB786Ae419c4d13189fB081Cc43bab. Please use a strong password when you generate your own wallets.

thetacli tx send --chain="privatenet" --from=2E833968E5bB786Ae419c4d13189fB081Cc43bab --to=9F1233798E905E173560071255140b4A8aBd3Ec6 --theta=10 --seq=1

The balance of an address can be retrieved with the following query command, after the transaction has been included in the blockchain (may take a couple seconds).

thetacli query account --address=9F1233798E905E173560071255140b4A8aBd3Ec6

Now let us send 20 more Theta tokens. Note that we need to increment the seq parameter to 2. The seq parameter is a transaction counter for each account, similar to the nonce parameter for Ethereum transactions. Each time we send tokens from an account, we need to increment the seq by 1.

thetacli tx send --chain="privatenet" --from=2E833968E5bB786Ae419c4d13189fB081Cc43bab --to=9F1233798E905E173560071255140b4A8aBd3Ec6 --theta=20 --seq=2

We can query the receipient address again to verify the account balance changes.

thetacli query account --address=9F1233798E905E173560071255140b4A8aBd3Ec6

Account/Wallet Management

The Theta command line tool can be used as a wallet, which can manage multiple accounts with the keys encrypted. Below are the relevant commands:

  • thetacli key new Create a new account with a password. The newly created key is encrypted and stored under ~/.thetacli/keys/encrypted/ by default

  • thetacli key list List all the accounts managed by the wallet.

  • thetacli key password

    Reset the password for the account. You will need the current password for the reset.

  • thetacli key delete

    Delete the account. You will need the password for the account for the deletion.

CLI Command Documentation

Please refer to the following links for the detailed usage of the command line tool.

What’s Next

NEXT: The instructions for connecting to the mainnet, or the API reference

Did this page help you?