Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dymensionxyz/rollapp-wasm

WASM DRS - WASM Dymension Rollapp Standard
https://github.com/dymensionxyz/rollapp-wasm

Last synced: 2 months ago
JSON representation

WASM DRS - WASM Dymension Rollapp Standard

Awesome Lists containing this project

README 

        


Dymension Rollapp



# Rollapp-wasm - A template RollApp chain



This repository hosts `rollapp-wasm`, a template implementation of a dymension rollapp.



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



It uses Cosmos-SDK's [simapp](https://github.com/cosmos/cosmos-sdk/tree/main/simapp) as a reference, but with the following changes:



- minimal app setup

- wired IBC for [ICS 20 Fungible Token Transfers](https://github.com/cosmos/ibc/tree/main/spec/app/ics-020-fungible-token-transfer)

- 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.21](https://go.dev/). Requires [Dasel](https://formulae.brew.sh/formula/dasel) and [JQ](https://formulae.brew.sh/formula/jq).



## Installing / Getting started



Build and install the ```rollapp-wasm``` binary:



```shell

export BECH32_PREFIX=rol

make install BECH32_PREFIX=$BECH32_PREFIX

```



### Initial configuration



export the following variables:



```shell

export EXECUTABLE="rollapp-wasm"



export CELESTIA_NETWORK="mock" # for a testnet RollApp use "arabica", for mainnet - "celestia"

export CELESTIA_HOME_DIR="${HOME}/.da"



export BECH32_PREFIX="rol"

export ROLLAPP_CHAIN_ID="rollappwasm_1234-1"

export KEY_NAME_ROLLAPP="rol-user"

export BASE_DENOM="awsm"

export DENOM=$(echo "$BASE_DENOM" | sed 's/^.//')

export MONIKER="$ROLLAPP_CHAIN_ID-sequencer"



export ROLLAPP_HOME_DIR="$HOME/.rollapp-wasm"

export ROLLAPP_SETTLEMENT_INIT_DIR_PATH="${ROLLAPP_HOME_DIR}/init"



export SETTLEMENT_LAYER="mock" # when running a local hub or a public network use "dymension"

```



And initialize the rollapp:



```shell

sh scripts/init.sh

```



You can find out in  that:



There are a few variables was allow blockchains to customize at compile time. If you build your own chain and import x/wasm, you can adjust a few items via module parameters, but a few others did not fit in that, as they need to be used by stateless ValidateBasic(). Thus, we made them as flags and set them in start.go so that they can be overridden on your custom chain.



```shell

rollapp-wasm start --max-label-size 64 --max-wasm-size 2048000 --max-wasm-proposal-size 2048000

```



Those flags are optional, the default value was set as:



```go

wasmtypes.MaxLabelSize          = 128

wasmtypes.MaxWasmSize           = 819200

wasmtypes.MaxProposalWasmSize   = 3145728

```



### Download cw20-ics20 smartcontract



Download cw20-ics20 smartcontract with a specific version:



```shell

sh scripts/download_release.sh v1.0.0

```



### Run rollapp



```shell

rollapp-wasm 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 docs](https://docs.dymension.xyz/validate/dymension/build-dymd?network=localhost) 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, the following variables must be set:



```shell

export SETTLEMENT_LAYER="dymension" # when running a local hub or a public network use "dymension"



export HUB_RPC_ENDPOINT="http://localhost"

export HUB_RPC_PORT="36657" # default: 36657

export HUB_RPC_URL="${HUB_RPC_ENDPOINT}:${HUB_RPC_PORT}"

export HUB_CHAIN_ID="dymension_100-1"

export HUB_REST_URL="http://localhost:1318" # required for relayer



dymd config chain-id ${HUB_CHAIN_ID}

dymd config node ${HUB_RPC_URL}



export HUB_KEY_WITH_FUNDS="hub-user" # This key should exist on the keyring-backend test

```



### Create sequencer keys



create sequencer key using `dymd`



```shell

dymd keys add sequencer --keyring-dir ~/.rollapp-wasm/sequencer_keys --keyring-backend test

SEQUENCER_ADDR=`dymd keys show sequencer --address --keyring-backend test --keyring-dir ~/.rollapp-wasm/sequencer_keys`

```



fund the sequencer account



```shell

# this will retrieve the min bond amount from the hub

# if you're using an new address for registering a sequencer,

# you have to account for gas fees so it should the final value should be increased

BOND_AMOUNT="$(dymd q sequencer params -o json --node ${HUB_RPC_URL} | jq -r '.params.min_bond.amount')$(dymd q sequencer params -o jsono | jq -r '.params.min_bond.denom')"

echo $BOND_AMOUNT



# 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 --fees 1dym -y --node ${HUB_RPC_URL} --chain-id ${HUB_CHAIN_ID}

```



### Generate denommetadata



```shell

sh scripts/settlement/generate_denom_metadata.sh

```



### Add genesis accounts



```shell

sh scripts/settlement/add_genesis_accounts.sh

```



### Register rollapp on settlement



```shell

sh scripts/settlement/register_rollapp_to_hub.sh

```



### Register sequencer for rollapp on settlement



```shell

sh scripts/settlement/register_sequencer_to_hub.sh

```



### Configure the rollapp



Modify `dymint.toml` in the chain directory (`~/.rollapp/config`)



```shell

dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "settlement_layer" -v "dymension"

dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "settlement_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"

dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "max_proof_time" -v "1s"

dasel put -f "${ROLLAPP_HOME_DIR}"/config/dymint.toml "batch_submit_time" -v "10s"

dasel put -f "${ROLLAPP_HOME_DIR}"/config/app.toml "minimum-gas-prices" -v "1awsm"

```



### Run rollapp locally



```shell

rollapp-wasm start

```



or as a systemd service:



```shell

sudo tee /etc/systemd/system/rollapp-wasm.service > /dev/null < /dev/null <