QuickStart: Running a Node

The Basics

The following instructions are written for Linux.


PastelUp is Pastel Network's software for interfacing with our distributed blockchain software and is the best way to get started using Pastel. It functions as a utility wrapper for the node-operating binaries that communicate with the blockchain.

PastelUp installs, updates, and starts/stops the Pastel daemon (pastelD), as well as everything needed for the storage layer to operate (e.g., WalletNode, SuperNode)

PastelUp is undergoing constant development. Be sure to always check GitHub for the most up-to-date documentation: https://github.com/pastelnetwork/pastelup

Download the latest release of PastelUp from GitHub or directly via: https://download.pastel.network/#beta/

You can install PastelUp from the terminal as follows (make sure to change the url below to reflect the latest version number for PastelUp):

wget https://github.com/pastelnetwork/pastelup/releases/download/v1.1.3/pastelup-linux-amd64
chmod 755 pastelup-linux-amd64

Install a Node

./pastelup-linux-amd64 install node -r latest

This command will install pasteld and pastel-cli in /home/<username>/pastel/

For testnet add flag `-n=testnet`

./pastelup-linux-amd64 install node -r latest -n=testnet

Run your Node

After installing the node:

./pastelup-linux-amd64 start node

You should see some output that looks like:

Make sure you're connected to the network

  • Change directories to the pasteld/pastel-cli installation location (Default /home/<username>/pastel/)

  • Use pastel-cli to connect to a running node:

./pastel-cli getconnectioncount

This will print the number of nodes you're connected to. This might not work right away if you're just connecting to the network, but will work as your node is syncing to the main network.

Setup your Wallet and PastelID

You will need a Pastel address to send and receive PSL, and a PastelID to create NFTs. Your PastelID is used as a unique identifier to allow other Pastel users to identify creators and holders of assets. You might want multiple wallets, but you probably only want one PastelID.

Navigate to your pasteld/pastel-cli installation location (Default /home/<username>/pastel/). Then use pastel-cli to get a new chain address:

./pastel-cli getnewaddress

Backing up that pastel address with:

./pastel-cli dumpprivkey <address you just printed>

Will allow you to import that key at a later date with:

./pastel-cli importprivkey <private key you just printed>

Remember to store your private key in a secure and private location

Next you should get a pastelID so you can identify your art on the network. Once again, use pastel-cli:

./pastel-cli pastelid newkey "<passphrase>"

You will see a much larger key has printed to the console. You must register this newly generated pastel ID on the network in order to be able to use the APIs.

Register the artist with network:

./pastel-cli tickets register id <artist-pastel-id> "passphrase" <artist-address>

You would need 1000 PSL to be able to register your ID on the network.

On Testnet you can use Pastel's Testnet faucet to get the required LSP

To recover your pastelID for your wallet at a later date, you can import the key in combination with your passphrase:

./pastel-cli pastelid importkey "<key>" "<passphrase>"

Stop your Node

./pastelup-linux-amd64 stop node

Should yield output similar to:

Update your Node

./pastelup-linux-amd64 update node -r latest

Make Sure your node is synced with the Network

In order to be able to do anything useful on the Pastel Network, please make sure that your node is synced fully with the network. One way of making sure is to use `mnsync status` API

./pastel-cli mnsync status

Should yield output similar to:

Register NFTs

The core node functionality above will connect you to the blockchain, but to get started using Pastel to register and search for art, you should get connected to the layer built on top of PSL, beginning with walletnode.

Head on over to WalletNode to get started.

Last updated