{"id":13563118,"url":"https://github.com/dymensionxyz/rollapp","last_synced_at":"2026-04-02T18:36:19.358Z","repository":{"id":256166413,"uuid":"664193942","full_name":"dymensionxyz/rollapp","owner":"dymensionxyz","description":"Template for building RollApps","archived":false,"fork":false,"pushed_at":"2024-05-19T14:32:43.000Z","size":617,"stargazers_count":63,"open_issues_count":18,"forks_count":53,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-04-03T19:39:54.644Z","etag":null,"topics":["rdk","rollapps","template"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dymensionxyz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-07-09T07:39:39.000Z","updated_at":"2024-12-08T02:10:12.000Z","dependencies_parsed_at":"2024-09-09T11:25:53.611Z","dependency_job_id":null,"html_url":"https://github.com/dymensionxyz/rollapp","commit_stats":null,"previous_names":["dymensionxyz/rollapp"],"tags_count":8,"template":true,"template_full_name":"cosmonity/chain-minimal","purl":"pkg:github/dymensionxyz/rollapp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymensionxyz%2Frollapp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymensionxyz%2Frollapp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymensionxyz%2Frollapp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymensionxyz%2Frollapp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dymensionxyz","download_url":"https://codeload.github.com/dymensionxyz/rollapp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymensionxyz%2Frollapp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31312990,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["rdk","rollapps","template"],"created_at":"2024-08-01T13:01:15.341Z","updated_at":"2026-04-02T18:36:19.330Z","avatar_url":"https://github.com/dymensionxyz.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD033 --\u003e\n\u003ch1 align=\"center\"\u003eDymension Rollapp\u003c/h1\u003e\n\u003c!-- markdownlint-enable MD033 --\u003e\n\n# Rollappd - A template RollApp chain\n\nThis repository hosts `rollappd`, a template implementation of a dymension rollapp.\n\n`rollappd` is an example of a working RollApp using `dymension-RDK` and `dymint`.\n\nIt uses Cosmos-SDK's [simapp](https://github.com/cosmos/cosmos-sdk/tree/main/simapp) as a reference, but with the following changes:\n\n- minimal app setup\n- wired IBC for [ICS 20 Fungible Token Transfers](https://github.com/cosmos/ibc/tree/main/spec/app/ics-020-fungible-token-transfer)\n- Uses `dymint` for block sequencing and replacing `tendermint`\n- Uses modules from `dymension-RDK` to sync with `dymint` and provide RollApp custom logic \n\n## Overview\n\n**Note**: Requires [Go 1.19](https://go.dev/)\n\n## Quick guide\n\nGet started with [building RollApps](https://docs.dymension.xyz/develop/get-started/setup)\n\n## Installing / Getting started\n\nBuild and install the ```rollappd``` binary:\n\n```shell\nmake install\n```\n\n### Initial configuration\n\nexport the following variables:\n\n```shell\nexport ROLLAPP_CHAIN_ID=\"demo-dymension-rollapp\"\nexport KEY_NAME_ROLLAPP=\"rol-user\"\nexport DENOM=\"urax\"\nexport MONIKER=\"$ROLLAPP_CHAIN_ID-sequencer\"\n```\n\nAnd initialize the rollapp:\n\n```shell\nsh scripts/init.sh\n```\n\n### Run rollapp\n\n```shell\nrollappd start\n```\n\nYou should have a running local rollapp!\n\n## Run a rollapp with local settlement node\n\n### Run local dymension hub node\n\nFollow the instructions on [Dymension Hub docs](https://docs.dymension.xyz/develop/get-started/run-base-layers) to run local dymension hub node\n\n### Create sequencer keys\n\ncreate sequencer key using `dymd`\n\n```shell\ndymd keys add sequencer --keyring-dir ~/.rollapp/sequencer_keys --keyring-backend test\nSEQUENCER_ADDR=`dymd keys show sequencer --address --keyring-backend test --keyring-dir ~/.rollapp/sequencer_keys`\n```\n\nfund the sequencer account\n\n```shell\ndymd tx bank send local-user $SEQUENCER_ADDR 10000000000000000000000udym --keyring-backend test --broadcast-mode block\n```\n\n### Register rollapp on settlement\n\n```shell\nsh scripts/settlement/register_rollapp_to_hub.sh\n```\n\n### Register sequencer for rollapp on settlement\n\n```shell\nsh scripts/settlement/register_sequencer_to_hub.sh\n```\n\n### Configure the rollapp\n\nModify `dymint.toml` in the chain directory (`~/.rollapp/config`)\nset:\n\n```shell\nsettlement_layer = \"dymension\"\n```\n\n### Run rollapp locally\n\n```shell\nrollappd start\n```\n\n## Setup IBC between rollapp and local dymension hub node\n\n### Install dymension relayer\n\n```shell\ngit clone https://github.com/dymensionxyz/go-relayer.git --branch v0.2.0-v2.3.1-relayer\ncd relayer \u0026\u0026 make install\n```\n\n### Establish IBC channel\n\nwhile the rollapp and the local dymension hub node running, run:\n\n```shell\nsh scripts/ibc/setup_ibc.sh\n```\n\nAfter successful run, the new established channels will be shown\n\n### run the relayer\n\n```shell\nrly start hub-rollapp\n```\n\n## Developers guide\n\nTODO\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdymensionxyz%2Frollapp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdymensionxyz%2Frollapp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdymensionxyz%2Frollapp/lists"}