Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
D

dymension

> 编程语言
Open source

Dymension Hub

394 stars0 likes1 views
WebsiteGitHub

About

Dymension Hub

Dymension Hub

Overview

Welcome to the Dymension Hub, the Settlement Layer of the Dymension protocol.

This guide will walk you through the steps required to set up and run a Dymension Hub full node.

Table of Contents

  • Dymension Hub
    • Overview
    • Table of Contents
    • Prerequisites
    • Installation
    • Initializing dymd
    • Running the Chain
    • Bootstrapping liquidity pools
    • Adding incentives
      • Creating incentives streams
      • Locking tokens
      • Checking rewards
      • Updating a community-driven distribution
    • Debugging Container
    • Developer
      • Setup push hooks

Prerequisites

  • Go (v1.18 or above)

Installation

Clone dymension:

bash
git clone https://github.com/dymensionxyz/dymension.git
cd dymension
make install

Check that the dymd binaries have been successfully installed:

bash
dymd version

If the dymd command is not found an error message is returned, confirm that your GOPATH is correctly configured by running the following command:

bash
export PATH=$PATH:$(go env GOPATH)/bin

Initializing dymd

  • Using the setup script:

    This method is preferred as it is preconfigured to support running rollapps locally

    bash
    bash scripts/setup_local.sh
  • Manually:

    First, set the following environment variables:

    bash
    export CHAIN_ID="dymension_100-1"
    export KEY_NAME="hub-user"
    export MONIKER_NAME="local"

    Second, create genesis and init dymension chain:

    bash
    dymd init "$MONIKER_NAME" --chain-id "$CHAIN_ID"

    Third, set parameters to ensure denom is udym:

    bash
    bash scripts/set_params.sh

    Then, add genesis account and provide token to the account:

    bash
    dymd keys add "$KEY_NAME" --keyring-backend test
    dymd add-genesis-account "$(dymd keys show "$KEY_NAME" -a --keyring-backend test)" 1000dym
    dymd gentx "$KEY_NAME" 670dym --chain-id "$CHAIN_ID" --keyring-backend test
    dymd collect-gentxs

Running the Chain

Now start the chain!

bash
dymd start

You should have a running local node!

Bootstrapping liquidity pools

To bootstrap the GAMM module with pools:

bash
sh scripts/pools/pools_bootstrap.sh

Adding incentives

Creating incentives streams

After creating the pools above, we create 3 incentive streams through gov:

bash
sh scripts/incentives/fund_incentives.sh

Wait for the gov proposal to pass, and validate with:

bash
dymd q streamer streams

The last stream is community-driven and governed by x/sponsorship.

Locking tokens

To get incentives, we need to lock the LP tokens:

bash
sh scripts/incentives/lockup_bootstrap.sh

validate with:

bash
dymd q lockup module-balance

Checking rewards

Every minute a share of the rewards will be distributed!

validate with:

bash
dymd q incentives active-gauges

# alternatively, watch the output - you will see the "amount" change every minute
#  watch -n1 -d "dymd q incentives active-gauges --output json | jq '.data[] | { "id": .id, "coins": .coins } '"

Updating a community-driven distribution

The following script casts two votes for a community-driven distribution.

bash
sh scripts/incentives/sponsorship_vote.sh

This will change the corresponding stream distribution at the end of the current epoch.

bash
dymd q streamer streams

The community-driven distribution may be queried with:

bash
dymd q sponsorship distribution

Debugging Container

Pre-requisite: Install Docker Install VSCode Install VSCode Go extension Install Delve

To debug, you can use the following command to run the debug container:

bash
make docker-run-debug

Then you can run the debugger with the following config for launch.json in VSCode:

json
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Dymension Debug Container",
            "type": "go",
            "request": "attach",
            "mode": "remote",
            "port": 4000,
            "host": "127.0.0.1",
            "debugAdapter": "legacy" // To be removed in the future after https://github.com/golang/vscode-go/issues/3096 is fixed
        }
    ]
}

After that, you can run the debugger and set breakpoints in the code.

Example:

Add breakpoint to ctx in x/eibc/keeper/grpc_query.go :

go
func (q Querier) Params(goCtx context.Context, req *types.QueryParamsRequest) (*types.QueryParamsResponse, error) {
	if req == nil {
		return nil, status.Error(codes.InvalidArgument, "invalid request")
	}
	ctx := sdk.UnwrapSDKContext(goCtx)

	return &types.QueryParamsResponse{Params: q.GetParams(ctx)}, nil
}

Open your browser and go to http://localhost:1318/dymensionxyz/dymension/eibc/params and you will see debugger stop and print the value at the breakpoint.

Developer

For support, join our Discord community and find us in the Developer section. See Contribution guidelines.

Setup push hooks

To setup push hooks, run the following command:

bash
./scripts/setup-git-hooks.sh

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

Goblockchaincosmos-sdkdymensionhub

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言