The Pactus Blockchain provides a wallet application that allows users to interact with the Pactus blockchain without the need to run a node. This is ideal for users who do not wish to operate a node but still want to create a personal wallet to manage their funds. This tutorial will guide you step-by-step on how to use the wallet application.
To get started, download and extract the Pactus CLI file from here. Once you have downloaded and extracted the Pactus CLI file, you can proceed to the next step.
In this section, we will explore various wallet commands that help you create, manage, and recover your Pactus wallet.
~/pactus/wallets/default_wallet on Unix-like systems.
On Windows, you can find it at C:\Users\<USER_NAME>\pactus\wallets\default_wallet.
--path option.
To create a new wallet, run the following command:
./pactus-wallet --path <PATH-To-NEW-WALLET> create
pactus-wallet.exe --path <PATH-To-NEW-WALLET> create
Replace <PATH-To-NEW-WALLET> with the file path where you want to create the wallet.
If you lose your wallet or forget your password, you can recover it by running this command:
./pactus-wallet --path <PATH-To-NEW-WALLET> recover
pactus-wallet.exe --path <PATH-To-NEW-WALLET> recover
Replace <PATH-To-NEW-WALLET> with the file path where you want to restore the wallet.
You can change the wallet password by running this command:
./pactus-wallet password
pactus-wallet.exe password
This command changes the password for the default_wallet if there is one, or sets a new password.
You can obtain the wallet seed by running this command:
./pactus-wallet seed
pactus-wallet.exe seed
The wallet seed is encrypted within your wallet, and you’ll need to enter the wallet password to access it.
In this section, we’ll cover address commands that help you manage your wallet addresses.
You can create a new address by running this command:
./pactus-wallet address new
pactus-wallet.exe address new
Based on PIP-8, an address string conducts its type and usage.
By default, the above command creates an account address.
If you want to create a validator address instead, you can use the --type validator option with the command like this:
./pactus-wallet address new --type validator
pactus-wallet.exe address new --type validator
You can also assign a label to your address to better organize your address book.
To view the list of wallet addresses, use this command:
./pactus-wallet address all
pactus-wallet.exe address all
To obtain the public key for a specific address, run this command:
./pactus-wallet address pub <ADDRESS>
pactus-wallet.exe address pub <ADDRESS>
Replace <ADDRESS> with the address for which you want to retrieve its public key.
You can get the private key of your address by this command:
./pactus-wallet address priv <ADDRESS>
pactus-wallet.exe address priv <ADDRESS>
Replace <ADDRESS> with the address for which you want to retrieve its private key.
Keep your private key secure. If someone gains access to your private key,
they will have full control over that address.
You can get the balance of your address by this command:
./pactus-wallet address balance <ADDRESS>
pactus-wallet.exe address balance <ADDRESS>
Replace <ADDRESS> with the address for which you want to retrieve your balance.
In this section, we’ll cover transaction commands that help you create, sign, and broadcast transactions on the Pactus Blockchain. You’ll need to provide the password to sign the transaction. Please note that once a transaction is broadcasted, it cannot be reversed.
To create, sign, and broadcast a Transfer transaction, use the following command:
./pactus-wallet tx transfer <FROM> <TO> <AMOUNT>
pactus-wallet.exe tx transfer <FROM> <TO> <AMOUNT>
In this command, <FROM> should be one of the addresses in your wallet as the sender address,
and <TO> is the receiver address.
To create, sign, and broadcast a Bond transaction, use the following command:
./pactus-wallet tx bond <FROM> <TO> <AMOUNT>
pactus-wallet.exe tx bond <FROM> <TO> <AMOUNT>
In this command, <FROM> should be one of the addresses in your wallet as the sender address,
and <TO> is the receiver validator address.
If the validator associated with this address does not exist yet, you need to provide the public key to create it:
./pactus-wallet tx bond --pub <PUBLIC_KEY> <FROM> <TO> <AMOUNT>
pactus-wallet.exe --pub <PUBLIC_KEY> <FROM> <TO> <AMOUNT>
Replace <PUBLIC_KEY> with the validator’s public key,
which is the public key of the <TO> address.
To create, sign, and broadcast a Unbond transaction, use the following command:
./pactus-wallet tx unbond <ADDRESS>
pactus-wallet.exe tx unbond <ADDRESS>
In this command, <ADDRESS> is the address of the validator that you want to unbond.
To create, sign, and broadcast a Withdraw transaction, use the following command:
./pactus-wallet tx withdraw <FROM> <TO> <AMOUNT>
pactus-wallet.exe tx withdraw <FROM> <TO> <AMOUNT>