Pactus can be run in different modes, including the command-line interface (CLI) and the graphical user interface (GUI). This tutorial will guide you through the steps to run Pactus in CLI mode, suitable for advanced users.
Before proceeding with the steps below, ensure that you have the following:
To get started, follow the steps below based on your operating system:
Windows: Download and extract the Pactus CLI file from here.
Linux and macOS: You have two options:
Download and extract the Pactus CLI file from here.
Use the following command in the Terminal:
curl --proto '=https' --tlsv1.2 -sSL https://github.com/pactus-project/pactus/releases/download/v0.13.0/pactus_downloader.sh | sh
This command will download the CLI archive file, verify it, and extract it for you.
Once you have downloaded and extracted the Pactus CLI file, you can proceed to the next step.
Now you need to create a wallet and setup a working directory for your node. A working directory is a place where you save blockchain data and wallets. Open the Terminal and run the following command:
./pactus-daemon init -w ~/pactus --testnet
This command creates your wallet and setup the working working directory at ~/pactus
.
./pactus-daemon init -w ~/pactus --testnet
This command creates your wallet and setup the working working directory at ~/pactus
.
pactus-daemon.exe init -w c:\pactus --testnet
This command creates your wallet and setup the working working directory at c:\pactus
.
Make sure you write down your 12-word mnemonic on a piece of paper to recover your wallet in the future in case your computer is lost, damaged, or stolen.
The working directory contains:
Feel free to explore the contents of these files as needed, particularly the config file. The config file contains parameters that can customize your node.
If you ever need to restore your node, for instance on a new device,
you can use the --restore
option followed by your mnemonic:
./pactus-daemon init -w ~/pactus --testnet --restore "<your-mnemonic>"
Replace <your-mnemonic>
with your previously noted mnemonic phrase.
This command will restore your wallet in the ~/pactus
directory.
./pactus-daemon init -w ~/pactus --testnet --restore "<your-mnemonic>"
Replace <your-mnemonic>
with your previously noted mnemonic phrase.
This command will restore your wallet in the ~/pactus
directory.
pactus-daemon.exe init -w c:\pactus --testnet --restore "<your-mnemonic>"
Replace <your-mnemonic>
with your previously noted mnemonic phrase.
This command will restore your wallet in the c:\pactus
directory.
Now you can start the node and sync with the network. Run the following command in the Terminal:
./pactus-daemon start -w ~/pactus
./pactus-daemon start -w ~/pactus
pactus-daemon.exe start -w c:\pactus
When the Pactus node starts running, it begins syncing with the network. This process may take some time, as your node needs to download and verify the entire blockchain history. Please be patient while your node syncs.
To become a validator and participate in the consensus algorithm to earn rewards, you first need to stake some coins. In the next tutorial, we will explain how to send a Bond transaction to become a validator.
By running a Pactus node, you contribute to the decentralization and security of the Pactus blockchain network. Thank you for your participation!