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: 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-http-endpoint> -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:
- Developer → Chain state → Session → nextKeys
- Toggle the switch include option and select your collator address in the AccountId32field.
- Click the + button.
- 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