Skip to content

Latest commit

 

History

History
346 lines (250 loc) · 7.36 KB

README.md

File metadata and controls

346 lines (250 loc) · 7.36 KB
Raw

IBC Setup Documentation

Local-Setup

Chain-1

choose first binary (eg lmsd)

  • git clone (eg : lmsd)

Initialize chain

  • lmsd init --chain-id lmsdnet lmsdmoniker

Add Key

  • lmsd keys add lmsdkey

Store The Nemonic

  • copy the nemonic and paste it somewhere as we need it later during hermes setup

Add Genesis Account

  • lmsd add-genesis-account lmsdkey 1000000000000stake

Gentx To Create a Validator

  • lmsd gentx lmsdkey 1000000000stake --chain-id lmsdnet

Collect

  • lmsd collect-gentxs

Start the node

  • lmsd start

Chain2

NOTE : Use --home flag when using same binary

choose second binary (eg gaiad)

  • git clone (eg : gaia)

Initialize chain

  • gaiad init --chain-id gaianet gaiamoniker

Add Key

  • gaiad keys add gaiakey

Store The Nemonic

  • copy the nemonic and paste it somewhere as we need it later during hermes setup

Add Genesis Account

  • gaiad add-genesis-account gaiakey 1000000000000stake

Gentx To Create a Validator

  • gaiad gentx gaiakey 1000000000stake --chain-id lmsdnet

Changes in configuration files

  • go to .gaia -> config -> config.toml

  • change rpc laddr = "tcp://127.0.0.1:26657" -> "tcp://127.0.0.1:16657"

  • change above p2p, pprof_laddr = "localhost:6060" -> "localhost:6061"

  • change p2p laddr = "tcp://0.0.0.0:26656" -> laddr = "tcp://0.0.0.0:16656"

  • go to app.toml

  • change grpc address = "0.0.0.0:9090" -> address = "0.0.0.0:9092"

  • change grpc-web address = "0.0.0.0:9091" -> address = "0.0.0.0:9095"

Collect

  • gaiad collect-gentxs

Start the node

  • gaiad start

Hermes-Configuration

Change to .hermes directory

  • cd .hermes

Create lmsd.json

  • touch lmsd.json
  • gedit lmsd.json
  • paste the nemonic of first key (lmsdkey)

Create gaia.json

  • touch gaia.json
  • gedit gaia.json
  • paste the nemonic of second key (gaiakey)

config.toml

  • follow the below example
[global]
log_level = 'info'
[mode]
[mode.clients]
enabled = true
refresh = true
misbehaviour = true
[mode.connections]
enabled = true
[mode.channels]
enabled = true
[mode.packets]
enabled = true
clear_interval = 100
clear_on_start = true
tx_confirmation = true
[telemetry]
enabled = true
host = '127.0.0.1'
port = 3001
[rest]
enabled = true
host    = '127.0.0.1'
port    = 3000
[[chains]]
id = 'gaianet'
rpc_addr = 'http://localhost:16657'
grpc_addr = 'http://localhost:9092'
websocket_addr = 'ws:/localhost:16657/websocket'
rpc_timeout = '15s'
account_prefix = 'regen'
key_name = 'gaiakey'
store_prefix = 'ibc'
gas_price = { price = 0.01, denom = 'stake' }
max_gas = 10000000
clock_drift = '5s'
trusting_period = '14days'
trust_threshold = { numerator = '1', denominator = '3' }
[[chains]]
id = 'lmsdnet'
rpc_addr = 'http://localhost:26657'
grpc_addr = 'http://localhost:9090'
websocket_addr = 'ws:/localhost:26657/websocket'
rpc_timeout = '15s'
account_prefix = 'cosmos'
key_name = 'lmsdkey'
store_prefix = 'ibc'
gas_price = { price = 0.01, denom = 'stake' }
max_gas = 10000000
clock_drift = '5s'
trusting_period = '14days'
trust_threshold = { numerator = '1', denominator = '3' }

NOTE : Lookout for id, keys, address

Start Hermes

Directory to .hermes

  • cd .hermes

Remove keys before restoring (if not the first time/ doing a restart)

  • rm -rf keys

Restore Keys

  • hermes keys add --mnemonic-file lmsdkey.json --chain lmsdnet
  • hermes keys add --mnemonic-file gaiakey.json --chain gaianet

Create a channel between the chains

  • hermes create channel --a-chain lmsdnet --b-chain gaianet --a-port transfer --b-port transfer --new-client-connection

Start

  • hermes start

Setup accross different Systems (should connect to same wifi)

Chain-1

choose first binary (eg lmsd)

  • git clone (eg : lmsd)

Initialize chain

  • lmsd init --chain-id lmsdtejanet teja

Add Key

  • lmsd keys add lmsdtejakey

Store The Nemonic

  • copy the nemonic and paste it somewhere as we need it later during hermes setup

Add Genesis Account

  • lmsd add-genesis-account lmsdtejakey 1000000000000stake

Gentx To Create a Validator

  • lmsd gentx lmsdtejakey 1000000000stake --chain-id lmsdtejanet

Changes in configuration files

  • go to .simapp -> config -> config.toml

  • change rpc laddr = "tcp://127.0.0.1:26657" -> "tcp://0.0.0.0:26657"

Collect

  • lmsd collect-gentxs

Start the node

  • lmsd start

Chain-2

chain-2 setup

  • follow the same steps mentioned above

Lets assume

  • ipaddress of system-2 : 192.168.1.32
  • chainid : lmsdritviknet
  • key : lmsdritvikkey

Hermes-Configuration

Change to .hermes directory

  • cd .hermes

Create lmsd.json

  • touch lmsdteja.json
  • gedit lmsdteja.json
  • paste the nemonic of first key (lmsdtejakey)

Create gaia.json

  • touch lmsdritvik.json
  • gedit lmsdritvik.json
  • paste the nemonic of second key (lmsdritvikkey)

config.toml

  • follow the below example
[global]           
log_level = 'info'
[mode]
[mode.clients]
enabled = true
refresh = true
misbehaviour = true
[mode.connections]
enabled = true
[mode.channels]
enabled = true
[mode.packets]
enabled = true
clear_interval = 100
clear_on_start = true
tx_confirmation = true
[telemetry]
enabled = true
host = '127.0.0.1'
port = 3001
[rest]
enabled = true
host    = '127.0.0.1'
port    = 3000
[[chains]]
id = 'lmsdritviknet'
rpc_addr = 'http://192.168.1.32:26657'
grpc_addr = 'http://192.168.1.32:9090'
websocket_addr = 'ws:/192.168.1.32:26657/websocket'
rpc_timeout = '15s'
account_prefix = 'cosmos'
key_name = 'lmsdtejakey'
store_prefix = 'ibc'
gas_price = { price = 0.01, denom = 'stake' }
max_gas = 10000000
clock_drift = '5s'
trusting_period = '14days'
trust_threshold = { numerator = '1', denominator = '3' }
[[chains]]
id = 'lmsdtejanet'
rpc_addr = 'http://localhost:26657'
grpc_addr = 'http://localhost:9090'
websocket_addr = 'ws:/localhost:26657/websocket'
rpc_timeout = '15s'
account_prefix = 'cosmos'
key_name = 'lmsdtejakey'
store_prefix = 'ibc'
gas_price = { price = 0.01, denom = 'stake' }
max_gas = 10000000
clock_drift = '5s'
trusting_period = '14days'
trust_threshold = { numerator = '1', denominator = '3' }

NOTE : Lookout for id, keys, address, ip address

Start Hermes

Directory to .hermes

  • cd .hermes

Remove keys before restoring (if not the first time/ doing a restart)

  • rm -rf keys

Restore Keys

  • hermes keys add --mnemonic-file lmsdtejakey.json --chain lmsdtejanet
  • hermes keys add --mnemonic-file lmsdritvikkey.json --chain lmsdritviknet

Create a channel between the chains

  • hermes create channel --a-chain lmsdtejanet --b-chain lmsdritviknet --a-port transfer --b-port transfer --new-client-connection

Start

  • hermes start

Transaction across chains using IBC(Hermes)

  • lmsd tx ibc-transfer transfer transfer channel-0 77stake --from lmskey --chain-id lmsdnet

  • gaiad q bank balances --node http://127.0.0.1:16657

  • hermes tx ft-transfer --dst-chain test2 --src-chain test1 --src-port transfer --src-channel transfer --amount 1000 --denom stake

Notes and Errors

ip address command

  • ifconfig

stake errors

  • change .hermes -> config.toml -> denom (eg: uregen -> stake)
  • change .gaia -> config -> config.toml -> min_gas_price ( eg: "" -> "0stake")

hermes keys not restoring

  • check the nemonics properly
  • cd .hermes

address already in use

  • restart the system
  • kill the process
  • change .simapp -> config -> config.toml | app.toml