Start Sequencer
The sequencer plays a crucial role in the operation of a RollApp. It is responsible for processing transactions, creating and ordering blocks, and submitting state updates to the Dymension hub. In this section we will go over the steps to setup and run a sequencer.
Requirements​
This guide assumes you've already setup your environment as outlined in the setup environment section.
Hardware Requirements​
- A Linux or macOS operating system
- At least 16GB of RAM
- At least 100GB of free disk space
- At least Dual CPU cores
- At least 10 Mbps bandwidth
Initialize RollApp Directory​
In case you haven't already, use the following command to install the necessary binaries, initializes the RollApp configuration files and download the genesis file. You'll be prompted to provide a RollApp ID and select an environment:
This assumes the Rollapp you want to operate already exists. If not, you can create one by using the portal.
On MacOS there are some instabilities with downloading the DA light client but running the command again upon failure usually fixes it.
roller rollapp init
After successful initialization, you’ll see output similar to:
💈 RollApp 'rollapp_12345-1' configuration files have been successfully generated on your local machine. Congratulations!
Make sure to save the generated addresses and mnemonic phrases securely. You'll need to fund these addresses to run the RollApp.
Setup RollApp Endpoints​
Before setting up the sequencer, it's important to configure the RollApp endpoints. These endpoints allow users and other network participants to interact with your RollApp through the portal.
This tool is intended for generating endpoints for testing and local installations. For production environments, we strongly recommend using your own custom setup. This step is not mandatory for running a RollApp sequencer, so in case you run into issues, you can skip this step.
For generating endpoints for testing and local installation we will be using telebit
Start by installing the telebit cli and follow the instructions:
curl https://get.telebit.io/ | bash
Create the necessary endpoints:
~/telebit http 1317 rest
~/telebit http 8545 evm
~/telebit http 26657 rpc
Save the endpoints:
~/telebit save
At this point you should have a set of endpoints which we will use when setting up the sequencer.
Setup RollApp Sequencer​
The following command sets up the RollApp node. In our example, we'll be choosing the sequencer
mode once prompted. In sequencer mode, we will also have to provide bond and https endpoints. We can use the endpoints we just created above or provide custom endpoints:
roller rollapp setup
Endpoints can be updated anytime after initial set up by updating the sequencer metadata.
Start RollApp​
- Foreground
- Background
To start the RollApp sequencer and data availability light node in the foreground, use the following command:
roller da-light-client start
roller rollapp start
View the RollApp status including ports and Sequencer balance.
roller rollapp status
To run in the background (required systemd for Linux and launchd for macOS):
Load RollApp services:
roller rollapp services load
Start RollApp services:
roller rollapp services start
View the RollApp status including ports and Sequencer balance.
roller rollapp status
View RollApp system logs using journalctl
(Only available on Linux):
journalctl -fu rollapp
To move the RollApp to the active
stage in the Portal and enable token transfers between the RollApp and Dymension, you must continue running the Relayer.