Skip to content

Installation

Introduction

ParallelChain client (pchain_client) is a command-line tool for you to connect and interact with the ParallelChain Mainnet. pchain_client supports Windows and Linux/MacOs.

Throughout the section, we will describe how to transfer tokens, deploy smart contract and call contract with real world examples by using pchain_client.

For Windows

Download the compressed zip file from https://cms.parallelchain.io/parallelchain-client_v0.3.1_win.zip

Unzip the file to extract the executable pchain_client.exe.

Screenshot

To open Command Prompt, type WIN+R and input cmd:

Screenshot

Head to the directory where pchain_client.exe is located via cd. For example, the executable is located at C:\Development:

Screenshot

Run the command pchain_client.exe and see usage page.

Congratulations. You have successfully installed pchain_client and are ready to proceed to "Prepare Environment"

For Powershell User

This section describes using PowerShell as the command line utility to install ParallelChain Light Client.

Open up PowerShell using the run keyboard shortcut. That is WIN+R and type in powershell to proceed.

Unzip the compressed zip file by Expand-Archive. Please specify the source path and destination path for your command parameters:

  • <SOURCE_PATH>: the directory where parallelchain-client_v0.3.1_win.zip is located.
  • <DESTINATION_PATH>: the directory you intend to install pchain_client. 
Expand-Archive -LiteralPath 'C:\<SOURCE_PATH>\parallelchain-client_v0.3.1_win.zip' -DestinationPath 'C:\<DESTINATION_PATH>\pchain_client.exe'

To switch the operating mode of PowerShell from a normal mode to administrator mode: 

Start-Process powershell -Verb runAs

Head to the destination directory where pchain_client.exe is extracted: 

Set-Location C:\<DESTINATION_PATH>\

Run the command pchain_client to see if it launches. 

pchain_client.exe

To verify that the Light Client works pchain is now an executable from anywhere on your system 
ParallelChain F Client CLI v.0.3.1
<ParallelChain Lab>
pchain-client is an (experimental) CLI for interacting with ParallelChain F (Mainnet) networks. If
you're new, start by setting up CLI using the 'Setup' command.

Congratulations. You have successfully installed pchain_client and are ready to proceed to "Prepare Environment"

For Linux / macOS

In this section, most of the commands between the two operating systems are the same. If there are any differences, a tab that states a command for a particular operating system will be shown as below:

echo "This is a linux command"

echo "This is a macOS command"

To download the precompiled compressed binaries, use:

wget https://cms.parallelchain.io/parallelchain-client_v0.3.1_linux.tar.xz

curl -O https://cms.parallelchain.io/parallelchain-client_v0.3.1_mac.tar.xz

To extract the client program, head to the directory where the downloaded file parallelchain-client_v0.3.1_linux.tar.xz or parallelchain-client_v0.3.1_mac.tar.xz is located and extract via tar:

tar -xvf parallelchain-client_v0.3.1_linux.tar.xz

tar -xvf parallelchain-client_v0.3.1_mac.tar.xz

Run the command pchain_client to see if it launches.

./pchain_client

./pchain_client

Tip

For macOS users: Newer versions of macOS contain extra security verification steps configured by default. This is called GateKeeper. This usually happens when you download the binaries from a browser instead of using the curl tool as mentioned in the previous step. In case you found a message like this when calling pchain_client: 

./pchain
Screenshot

then you can remove macOS' "GateKeeper" attributes from pchain_client by this command and run pchain as normal 

sudo xattr -rd com.apple.quarantine ./pchain_client

This is an elevated action, so you will need to enter your password to continue. pchain_client can now be used as normal.

To verify that the Client works 
ParallelChain F Client CLI v.0.3.1
<ParallelChain Lab>
pchain-client is an (experimental) CLI for interacting with ParallelChain F (Mainnet) networks. If
you're new, start by setting up CLI using the 'Setup' command.

Congratulations. You have successfully installed pchain_client.

Tip

You might want to store pchain_client in a directory of your choice so that it is easier to follow the commands in the tutorial. For example, we created a folder in our home directory called parallelchain_client: 

$ mkdir -p /home/my_user/parallelchain_client
$ cp pchain_client /home/my_user/parallelchain_client/
$ cd /home/my_user/parallelchain_client
$ ./pchain_client

So from now on, when you see a command like this in linux/macOS: 

./pchain_client

It means that pchain_client shall be executed from the directory you stored pchain_client in.

Back to top