Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation

A full wiki with everything you need to know about Pchain is here: Pchain Wiki.

Chinese (中文) Wiki



Official golang implementation of the Pchain protocol.

To get familiar with pchain, you could read about Overview

Installation Instructions for Ubuntu(Official recommendation 16.04)

Installing from PPA, or install from release(If you want to become a Pchain validator, we recommend you to install from release)

sudo apt update
sudo apt upgrade
sudo apt install software-properties-common
sudo add-apt-repository -y ppa:pchainorg/pchain
sudo apt update
sudo apt install pchain

You should now be able to check the different options and commands with 'pchain --help'.

Upgrade the latest version of 'pchain'

sudo apt update
sudo apt dist-upgrade

Installation Instructions for Mac OS X

You can use our Homebrew tap to install pchain. If you don't have Homebrew,install it first

Then run the following commands to add the tap and install pchain:

brew tap pchain-org/pchain
brew install pchain

Upgrade the latest version of 'pchain'

brew upgrade pchain

You should now be able to check the different options and commands with 'pchain --help'.

After installing, run pchain account new to create an account on your node.

Building the source

If you would like to build from the source:

Building pchain requires both a Go (version 1.10 or later) and a C compiler. You can install them using your favourite package manager. Once the dependencies are installed, run

git clone -b pre_mainnet
cd pchain
make pchain

After run the command above,you will find pchain client in directory ./bin

./bin/pchain --help

If you want to build and run pchain under Windows(Not recommended), you could refer to Build and start pchain

If you want to know more about our Command Line Options,please consult our CLI Wiki page

Please Check Your Pchain Client Version (Latest:1.6.02)

$ pchain version

Sync and run testnet

If you want to test your smart contract, it's better to deploy it on testnet first. You can follow this guide to run pchain's testnet.

You can Get free tPI from our testnet.

Full Node On The Pchain Main Network

$ pchain

You can set your own data directory by '--datadir yourOwnDirectory' If you want to open RPC,just add the options '--rpc' and '--rpcapi "db,eth,net,web3,admin,tdm,miner,personal,chain,txpool" '. More details,please read How To Interact With Pchain

you can use 'nohup' and add '&' at the end of command above, Pchain client will run in the background

$ nohup pchain &
Platform Default Datadir Directory
Linux ~/.pchain
Mac ~/Library/Pchain
Windows %APPDATA%\Pchain

Docker quick start

One of the quickest ways to get Pchain up and running on your machine is by using Docker:

docker run -d --name pchain-node -v ~/pchain/.pchain:/.pchain \
           -p 6969:6969 -p 30308:30308 \
           plian/pchain --datadir=/.pchain

This will start pchain just as the above command does. It will also create a persistent volume in your home directory for saving your blockchain as well as map the default ports.

Do not forget --rpcaddr= --rpc --rpcapi=eth,web3,admin,tdm,miner,personal,chain,txpool,del, if you want to access RPC from other containers and/or hosts. By default, pchain binds to the local interface and RPC endpoints is not accessible from the outside.

How To Interact With Pchain(RPC OR IPC CONSOLE)

Please read the wiki How to Use the IPC Console

Please Read The Wiki How To Use the JSON RPC

How To Become A Validator

For a full guide on how to set up and become a validator node on the Pchain Network, see the Validator Node Guides

How To Delegate Your Stake

To learn how to delegate your PI to validators to receive rewards, read How To Delegate or Stake