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
dymintfor block sequencing and replacingtendermint - Uses modules from
dymension-RDKto sync withdymintand provide RollApp custom logic
Note: Requires Go 1.22.1. Requires Dasel and JQ.
Build and install the rollapp-evm binary:
export BECH32_PREFIX=ethm
make install BECH32_PREFIX=$BECH32_PREFIX
export EXECUTABLE="rollapp-evm"export the following variables:
export DA_CLIENT="mock" # choose DA client: mock(local db), celestia, loadnetwork, sui, aptos, walrus
# For Sui DA, one more env variable is needed: Sui wallet mnemonic.
# export SUI_MNEMONIC="$MNEMONIC"
# For Aptos DA, one more env variable is needed: hex-encoded Aptos wallet private key.
# export APT_PRIVATE_KEY="$PRIVATE_KEY"
# For Celestia DA, one more env variable is needed:
#export CELESTIA_NETWORK="mocha" # for a testnet RollApp use "mocha", for mainnet - "celestia"
#export CELESTIA_HOME_DIR="${HOME}/.da" # Celestia light client home directory
export ROLLAPP_CHAIN_ID="rollappevm_1234-1"
export KEY_NAME_ROLLAPP="rol-user"
export BASE_DENOM="arax"
export DENOM=$(echo "$BASE_DENOM" | sed 's/^.//')
export MONIKER="$ROLLAPP_CHAIN_ID-sequencer"
export ROLLAPP_HOME_DIR="$HOME/.rollapp_evm"
export ROLLAPP_SETTLEMENT_INIT_DIR_PATH="${ROLLAPP_HOME_DIR}/init"
export SKIP_EVM_BASE_FEE=true # optional, disables rollapp fees
$EXECUTABLE config keyring-backend test
# (if running hub too)
export SETTLEMENT_LAYER="mock" # when running a local hub or a public network use "dymension"
export HUB_KEY_WITH_FUNDS="hub-user"
export HUB_RPC_ENDPOINT="localhost"
export HUB_RPC_PORT="36657" # default: 36657
export HUB_RPC_URL="http://${HUB_RPC_ENDPOINT}:${HUB_RPC_PORT}"
export HUB_REST_URL="http://localhost:1318" # required for relayer
export HUB_CHAIN_ID="dymension_100-1"
dymd config chain-id "${HUB_CHAIN_ID}"
dymd config node "${HUB_RPC_URL}"
dymd config keyring-backend testAnd initialize the rollapp:
sh scripts/init.sh$EXECUTABLE startYou should have a running local rollapp!
Follow the instructions on Dymension Hub docs to run local dymension hub node
all scripts are adjusted to use local hub node that's hosted on the default port localhost:36657.
configuration with a remote hub node is also supported. Configure env vars above appropriately (RPC_URL)
create sequencer key using dymd
dymd keys add sequencer --keyring-dir ~/.rollapp_evm/sequencer_keys --keyring-backend test
SEQUENCER_ADDR=`dymd keys show sequencer --address --keyring-backend test --keyring-dir ~/.rollapp_evm/sequencer_keys`fund the sequencer account (if you're using a remote hub node, you must fund the sequencer account or you must have an account with enough funds in your keyring)
# retrieve the minimal bond amount from hub sequencer params
# you have to account for gas fees so it should the final value should be increased
BOND_AMOUNT="$(dymd q rollapp params -o json | jq -r '.params.min_sequencer_bond_global.amount')$(dymd q rollapp params -o json | jq -r '.params.min_sequencer_bond_global.denom')"
# Extract the numeric part
NUMERIC_PART=$(echo $BOND_AMOUNT | sed 's/adym//')
# Add 100000000000000000000 for fees
NEW_NUMERIC_PART=$(echo "$NUMERIC_PART + 100000000000000000000" | bc)
# Append 'adym' back
TRANSFER_AMOUNT="${NEW_NUMERIC_PART}adym"
dymd tx bank send $HUB_KEY_WITH_FUNDS $SEQUENCER_ADDR ${TRANSFER_AMOUNT} --keyring-backend test --broadcast-mode sync --fees 1dym -y --node ${HUB_RPC_URL}export HUB_PERMISSIONED_KEY="hub-user"
sh scripts/settlement/register_rollapp_to_hub.shsh scripts/settlement/register_sequencer_to_hub.shModify dymint.toml in the chain directory (~/.rollapp_evm/config)
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "settlement_layer" -v "dymension"
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "node_address" -v "$HUB_RPC_URL"
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "rollapp_id" -v "$ROLLAPP_CHAIN_ID"
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "max_idle_time" -v "2s" # may want to change to something longer after setup (see below)
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "max_proof_time" -v "1s"
dasel put -f "${ROLLAPP_HOME_DIR}"/config/app.toml "minimum-gas-prices" -v "1arax"
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "batch_submit_time" -v "30s"$EXECUTABLE validate-genesis# this script automatically adds 2 vesting accounts, adjust the timestamps to your liking or skip this step
sh scripts/add_vesting_accounts_to_genesis_file.sh$EXECUTABLE start --log_level=debug# Add a new key for the reward address
$EXECUTABLE keys add reward
REWARD=$($EXECUTABLE keys show reward -a)
# This assumes mock default sequencer consensus key location. for different location, update the path.
KEY="${ROLLAPP_HOME_DIR}/config/priv_validator_key.json"
# set the kerying backend to test
$EXECUTABLE config keyring-backend test
# Import the consensus key into the rollapp keyring
$EXECUTABLE tx sequencer unsafe-import-cons-key sequencerConsensusKey $KEY
# Update the sequencer reward address
$EXECUTABLE tx sequencer create-sequencer sequencerConsensusKey --from $KEY_NAME_ROLLAPP --fees 20000000000000$BASE_DENOM --reward-addr $REWARD --keyring-backend test -ygit clone https://github.com/dymensionxyz/go-relayer.git --branch v0.3.4-v2.5.2-relayer-canon-6
cd go-relayer && make installVerify you have all the environment variables defined earlier set. while the rollapp and the local dymension hub node running, run:
sh scripts/ibc/setup_ibc.shAfter successful run, the new established channels will be shown
Stop the rollapp:
kill $(pgrep $EXECUTABLE)Linux:
dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "max_idle_time" -v "1h"Start the rollapp:
$EXECUTABLE startrly start hub-rollappFor support, join our Discord community and find us in the Developer section.
To setup push hooks, run the following command:
./scripts/setup_push_hooks.sh