README.md

Dymension EVM Rollapp

Rollapp-evm - A template EVM RollApp chain

This repository hosts rollapp-evm, a template implementation of a dymension rollapp with EVM execution layer.

rollapp-evm is an example of a working RollApp using dymension-RDK and dymint.

It uses Cosmos-SDK's simapp as a reference, but with the following changes:

• minimal app setup
• wired with EVM and ERC20 modules by Evmos
• wired IBC for ICS 20 Fungible Token Transfers
• Uses dymint for block sequencing and replacing tendermint
• Uses modules from dymension-RDK to sync with dymint and provide RollApp custom logic

Overview

Note: Requires Go 1.20

Quick guide

Get started with building RollApps

Installing / Getting started

Build and install the rollapp-evm binary:

make install

Initial configuration

export the following variables:

export ROLLAPP_CHAIN_ID="rollappevm_1234-1"
export KEY_NAME_ROLLAPP="rol-user"
export DENOM="urax"
export MONIKER="$ROLLAPP_CHAIN_ID-sequencer"

And initialize the rollapp:

sh scripts/init.sh

Run rollapp

rollapp-evm start

You should have a running local rollapp!

Run a rollapp with local settlement node

Run local dymension hub node

Follow the instructions on Dymension Hub docs to run local dymension hub node

Create sequencer keys

create sequencer key using dymd

dymd keys add sequencer --keyring-dir ~/.rollapp_evm/sequencer_keys --keyring-backend test --algo secp256k1
SEQUENCER_ADDR=`dymd keys show sequencer --address --keyring-backend test --keyring-dir ~/.rollapp_evm/sequencer_keys`

fund the sequencer account

dymd tx bank send local-user $SEQUENCER_ADDR 10000000000000000000000udym --keyring-backend test --broadcast-mode block

Register rollapp on settlement

sh scripts/settlement/register_rollapp_to_hub.sh

Register sequencer for rollapp on settlement

sh scripts/settlement/register_sequencer_to_hub.sh

Configure the rollapp

Modify dymint.toml in the chain directory (~/.rollapp_evm/config) set:

settlement_layer = "dymension"

Run rollapp locally

rollapp-evm start

Setup IBC between rollapp and local dymension hub node

Install dymension relayer

git clone https://github.com/dymensionxyz/go-relayer.git --branch v0.2.0-v2.3.1-relayer
cd relayer && make install

Establish IBC channel

while the rollapp and the local dymension hub node running, run:

sh scripts/ibc/setup_ibc.sh

After successful run, the new established channels will be shown

run the relayer

rly start hub-rollapp

Developers guide

TODO