Dymension Rollapp
Rollappd - A template RollApp chain
This repository hosts rollappd
, a template implementation of a dymension rollapp.
rollappd
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 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.19
Quick guide
Get started with building RollApps
Installing / Getting started
Build and install the rollappd
binary:
make install
Initial configuration
export the following variables:
export ROLLAPP_CHAIN_ID="demo-dymension-rollapp"
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
rollappd 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/sequencer_keys --keyring-backend test
SEQUENCER_ADDR=`dymd keys show sequencer --address --keyring-backend test --keyring-dir ~/.rollapp/sequencer_keys`
fund the sequencer account
dymd tx bank send local-user $SEQUENCER_ADDR 10000000000000000000000udym --keyring-backend test
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
Modify dymint.toml
in the chain directory (~/.rollapp/config
)
set:
settlement_layer = "dymension"
Run rollapp
rollappd start
Setup IBC between rollapp and local dymension hub node
Install dymension relayer
$ git clone https://github.com/dymensionxyz/dymension-relayer.git
$ git checkout v0.1.0-relayer-v0.2.0-rc3
$ cd dymension-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