How to Set Up A Collator for krest Network on OnFinality

OnFinality
7 min readAug 28, 2023

--

OnFinality is a blockchain infrastructure platform that saves web3 builders time and makes their lives easier. We deliver easy-to-use, reliable and scalable API endpoints for the biggest blockchain networks and empower developers to automatically test, deploy, scale and monitor their own blockchain nodes in minutes.

We are already supporting over 100 networks across Layer-1 ecosystems such as Ethereum, Polkadot, Avalanche and Cosmos, and are continuously expanding these mission-critical services to other ecosystems to help developers build the decentralised future, faster!

Introduction

In this How-To Guide, you will learn how to set up your own Collator for krest network, which will enable you to earn block rewards. This guide should be used alongside krest’s official guide which is kept up to date and includes more detail.

What is krest?

krest is peaq’s canary network — the world’s first and only Economy of Things simulation network. krest is your home for socio-economic, technical, community, and governance innovation and experimentation within the peaq ecosystem. Launch dApps and tools for the Economy of Things and assess their impact in a live environment on a public blockchain network, without running the risk of causing real-world harm.

Why Run A Collator For krest

By setting up a collator node for krest, you can earn $KREST while enabling the builders working on dApps and DePINs on peaq to test their projects on a production-grade network with real economic value. peaq’s recent integrations include ELOOP, a Web3 Tesla-sharing service, NATIX, a project building a decentralised network of Ai-powered cameras for mapping the world, and bloXmove, which recently launched a Web3 ride-hailing app in Nigeria.

In the Polkadot ecosystem, there are several successful examples of canary network launches such as Moonbeam, which launched canary network Moonriver, or Acala, which launched canary network Karura, both reaching significant market caps, traction, and impact on the ecosystems. krest is not only peaq’s canary network — it is much more than that. It is the entrance to one big vibrant ecosystem that sets the tone for the next generation of the Internet of Things — The Economy of Things.

Airdrop for node operators

Allocation: 1,400,000 $KREST

No network can be community-powered or owned without community-operated nodes. To incentivize this, the first nodes joining the krest network will get special rewards — head to the documentation section for more on how to set up a node. Any collators that connect to the krest network before September 3rd (23:59 CET) will take part in the airdrop. The more nodes join in, the more decentralized the network grows, after all, and that is very much the goal. The airdrop will follow a 12-month linear vesting schedule.

You can find all the details regarding the $KREST airdrop in this blog

Useful Links

krest’s Airdrop Blog

krest’s Official Collator Guide

Disclaimer

Running a Collator comes with a high risk and requires a high level of technical knowledge and skill. As per our Terms of Service, OnFinality is neither responsible for any rewards nor losses incurred when running a Collator node on OnFinality. OnFinality is not involved with or responsible for the KREST airdrop for node operators. Users should read and fully understand the relevant documentation for the Network before setting up the node, and get in touch directly with the Network if they have any questions or concerns.

HOW TO SET UP A KREST COLLATOR

1. Log In To OnFinality

Create an account and log in to OnFinality, then add a payment method.

2. Create Dedicated Node

Select the Dedicated Nodes menu and press “Deploy New Node”

2.1 Select Network

Search for krest and then click “Deploy Node”

2.2 Configure krest Node

Enter an easily identifiable Display Name and select the Collator Node Type. Select the latest Image Version.

Scroll down to set the Cloud Provider and Region where you will run the node. Networks may have a preference of where you should run your collator, so check with their official documentation.

Look out for the Lightning Restore indicator to get the node running as fast as possible.

Use at least the recommended configuration suggested by the network, then press “Next”

2.3 Configure Launch Arguments

Next, review the node’s Launch Configuration. The recommended settings are usually sufficient, but we recommend comparing with official documentation to be certain.

Important! — rpc-methods must be set to “Unsafe” while configuring the collator on chain, then changed to “Safe” once the setup is complete.

Press “Next” at the bottom of the screen

2.4 Review Node

Finally, review the node’s settings and press “Deploy Node”

3. Sync Your Dedicated Node

Once your node is successfully deployed, you can find it in the “Dedicated Nodes” section on our portal. Click on your node and confirm the following:

  • Relay chain/parachain blocks are syncing appropriately
  • No configuration errors in the console log. You can find your console by clicking on “Console logs” on the top right hand.
  • CPU, Memory, and Storage are within reasonable range of use.

You can cross-reference the respective network blocks on the PolkadotJS App.

4. Set Up Account And Stake

Create a Wallet Address with the minimum of 50,000 KREST to stake

5. Generate Session Keys

Session keys are what links the validator or collator to your account.

First, locate your Dedicated Node’s RPC endpoints under API Endpoints. Access is secured by an API Key at the end of the URL, so keep it safe and private.

Option 1 — Polkadot-JS:

Copy your RPC — Websocket endpoint into the Polkadot-JS Custom Endpoint and press save to connect to the node

Navigate to Developer > RPC Calls and submit an author rotateKeys call.

Record the result.

Option 2 — CLI:

Generate the session keys on your Dedicated Node via the author_rotateKeys RPC Request, using your Dedicated Node’s RPC — Http url.

Example request

curl **Node’s RPC Http endpoint here** -H \ “Content-Type:application/json;charset=utf-8” -d \

‘{

“jsonrpc”:”2.0",

“id”:1,

“method”:”author_rotateKeys”,

“params”: []

}’

You will get a response like this

{

“jsonrpc”: “2.0”,

“result”:”0xc05a9d093e4db4c1bde31977716e7a0a39d6f3d1f1bf749e7fec8371147de730af6860aeef81a11130c9fcd317b96e736f6c36141c28f382a18f9faf6e7df797eaa951ead00d12db10937003f0956e3d3444d1774d452ed045dbc1b84d1bf1471abf5d77bf5033845f01be1188a852c6f0ba703042b4d06d14314841c1096c50",

“id”:1

}

The content after “result” is the session keys of your collator node

6. Set Session Keys

In Polkadot.js portal open Developer > Extrinsic

Select your collator account and extrinsic type: session / setKeys

Enter the session keys using the response from author_rotateKeys in step 5 and set proof to “0x00”

Submit the transaction.

7. Double-check that your session key is associated with your wallet address

Open the Developer tab, and click Chain state. There, you’ll need to submit the following state query:

DeveloperChain stateSessionnextKeys

  1. Toggle the switch include option and select your collator address in the AccountId32field.
  2. Click the + button.
  3. Confirm that your key is displayed.

8. Join the Collator Candidate Pool

Go to the polkadot.js portal, open the Developer tab, and click Extrinsics. There, you’ll need to submit the extrinsic:

Note

The min stake amount for the collator is 50,000 $KREST

Enter your stake into the stake: u128 (BalanceOf) field.

Note

Keep in mind that krest has 18 decimals, so if you want to stake 50,000 Tokens, you’ll need to enter 50,000,000,000,000,000,000,000.

Click Submit Transaction.

9. Check if you are in the Active Set of Collators

Open the Developer tab, and click Chain state. There, you will be able to check whether your stake was big enough to get a set in the active set of collators (top 16 collators by total stake).

Developer → Chain state → Storage → parachainStaking → topCandidates()

Confirm that your collator account is in the result

Congratulations!

If you have followed all of these steps, and been selected to be a part of the collator set, you are now running a krest Collator!

Wait for two sessions (2400 blocks or ~8hrs) to see whether your node starts authoring blocks. You can verify it by going to the krest block explorer and checking that your address started getting collator rewards.

More Resources:

Developer documentation: https://documentation.onfinality.io/support/

About OnFinality

OnFinality is a blockchain infrastructure platform that saves web3 builders time and makes their lives easier. OnFinality delivers scalable API endpoints for the biggest blockchain networks and empowers developers to automatically test, deploy, scale and monitor their own blockchain nodes in minutes. To date, OnFinality has served over 300 billion RPC requests across 70 networks including Polkadot, Ethereum, Moonbeam, Astar, Avalanche and Cosmos, and is continuously expanding these mission-critical services so developers can build the decentralised future, faster!

App | Website | Twitter | Telegram | LinkedIn | YouTube

--

--

OnFinality

OnFinality empowers Web3 developers with easy-to-use, reliable and scalable blockchain infrastructure. Build smarter with onfinality.io