chart update

guide/src/SUMMARY.md

@@ -17,7 +17,7 @@
      - [Start relaying](./tutorials/local-chains/start-relaying.md)
     - [More Local Chains](./tutorials/more-chains/index.md)
       - [Start the local chains](./tutorials/more-chains/start-local-chains.md)
-      - [Relay packets on multiple paths](./tutorials/more-chains/multiple-paths.md)
+      - [Build the topology](./tutorials/more-chains/build-the-topology.md)
     - [Relaying in production](./tutorials/production/index.md)
     - [Run multiple instances](./tutorials/concurrent/index.md)
 

guide/src/tutorials/more-chains/build-the-topology.md

@@ -0,0 +1,129 @@
+# Build the topology
+
+At this point of the tutorial, you should have four chains running and hermes correctly configured. You can perform a `health-check` with the command :
+
+```shell
+hermes health-check
+```
+
+If the command runs successfully you should see a message similar to the one below in the terminal:
+```
+    2022-08-23T15:54:58.150005Z  INFO ThreadId(01) using default configuration from '$HOME/.hermes/config.toml'
+    2022-08-23T15:54:58.150179Z  INFO ThreadId(01) [ibc-0] performing health check...
+    2022-08-23T15:54:58.163298Z  INFO ThreadId(01) chain is healthy chain=ibc-0
+    2022-08-23T15:54:58.163323Z  INFO ThreadId(01) [ibc-1] performing health check...
+    2022-08-23T15:54:58.169132Z  INFO ThreadId(01) chain is healthy chain=ibc-1
+    2022-08-23T15:54:58.169154Z  INFO ThreadId(01) [ibc-2] performing health check...
+    2022-08-23T15:54:58.178418Z  INFO ThreadId(01) chain is healthy chain=ibc-2
+    2022-08-23T15:54:58.178445Z  INFO ThreadId(01) [ibc-3] performing health check...
+    2022-08-23T15:54:58.184615Z  INFO ThreadId(01) chain is healthy chain=ibc-3
+    SUCCESS performed health check for all chains in the config
+```
+
+## Connect all the chains
+
+Execute the following command :
+```shell
+    gm hermes cc
+```
+
+If this command runs succesfully, it should output the following :
+
+```shell
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-0 --b-chain ibc-1 --a-port transfer --b-port transfer --new-client-connection --yes
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-0 --b-chain ibc-2 --a-port transfer --b-port transfer --new-client-connection --yes
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-0 --b-chain ibc-3 --a-port transfer --b-port transfer --new-client-connection --yes
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-1 --b-chain ibc-2 --a-port transfer --b-port transfer --new-client-connection --yes
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-1 --b-chain ibc-3 --a-port transfer --b-port transfer --new-client-connection --yes
+"$HOME/ibc-rs/target/release/hermes" create channel --a-chain ibc-2 --b-chain ibc-3 --a-port transfer --b-port transfer --new-client-connection --yes
+```
+
+Executing these commands will :
+* For every pair of chain, create a client on both chain tracking the state of the counterparty chain.
+* Create a connection between these two clients.
+* Create a `transfer` channel over this connection.
+
+Use the flag `--exec` flag to execute these commands:
+
+```shell
+gm hermes cc --exec
+```
+
+At this point, your network should be fully connected. However, we want to relay on a specific topology presented at the beginning of [Start the local chains](./start-local-chains.md). The following chart displays the current state of the network. The channels that we want to filter out are filled in red while the channels we want to relay on are filled in green  :
+
+
+```mermaid
+flowchart TD 
+    ibc0((ibc-0))
+    ibc0ibc1[[channel-0]]
+    ibc0ibc2[[channel-1]]
+    ibc0ibc3[[channel-2]]
+
+    ibc1((ibc-1))
+    ibc1ibc0[[channel-0]]
+    ibc1ibc2[[channel-1]]
+    ibc1ibc3[[channel-2]]
+
+    ibc2((ibc-2))
+    ibc2ibc0[[channel-0]]
+    ibc2ibc1[[channel-1]]
+    ibc2ibc3[[channel-2]]
+
+    ibc3((ibc-3))
+    ibc3ibc0[[channel-0]]
+    ibc3ibc1[[channel-1]]
+    ibc3ibc2[[channel-2]]
+
+    classDef deny fill:#AA0000,color:#000000;
+    classDef allow fill:#00AA00,color:#000000;
+    class ibc0ibc1 allow;
+    class ibc1ibc0 allow;
+    class ibc0ibc3 allow;
+    class ibc3ibc0 allow;
+    class ibc2ibc1 allow;
+    class ibc1ibc2 allow;
+    class ibc2ibc3 allow;
+    class ibc3ibc2 allow;
+
+
+    class ibc1ibc3 deny;
+    class ibc3ibc1 deny;
+    class ibc0ibc2 deny;
+    class ibc2ibc0 deny;
+
+    ibc0---ibc0ibc1---ibc1ibc0---ibc1
+    ibc0---ibc0ibc2---ibc2ibc0---ibc2
+    ibc0---ibc0ibc3---ibc3ibc0---ibc3
+    ibc1---ibc1ibc2---ibc2ibc1---ibc2
+    ibc1---ibc1ibc3---ibc3ibc1---ibc3
+    ibc2---ibc2ibc3---ibc3ibc2---ibc3
+```
+
+You can verify that everything is correct with the commands:
+
+```shell
+hermes query channels --chain ibc-0 --show-counterparty 
+hermes query channels --chain ibc-1 --show-counterparty
+hermes query channels --chain ibc-2 --show-counterparty
+hermes query channels --chain ibc-3 --show-counterparty
+```
+
+Which should normally output: 
+
+```
+ibc-0: transfer/channel-0 --- ibc-1: transfer/channel-0
+ibc-0: transfer/channel-1 --- ibc-2: transfer/channel-0
+ibc-0: transfer/channel-2 --- ibc-3: transfer/channel-0
+
+ibc-1: transfer/channel-0 --- ibc-0: transfer/channel-0
+ibc-1: transfer/channel-1 --- ibc-2: transfer/channel-1
+ibc-1: transfer/channel-2 --- ibc-3: transfer/channel-1
+
+ibc-2: transfer/channel-0 --- ibc-0: transfer/channel-1
+ibc-2: transfer/channel-1 --- ibc-1: transfer/channel-1
+ibc-2: transfer/channel-2 --- ibc-3: transfer/channel-2
+
+ibc-3: transfer/channel-0 --- ibc-0: transfer/channel-2
+ibc-3: transfer/channel-1 --- ibc-1: transfer/channel-2
+ibc-3: transfer/channel-2 --- ibc-2: transfer/channel-2
+```

guide/src/tutorials/more-chains/index.md

@@ -1,23 +1,7 @@
 # Even more local chains
 
-In this tutorial we will show how you can test the relayer against five chains using Gaiad manager `gm` with an arbitrary topology of IBC channels.
+In this tutorial we will show how you can test the relayer against four chains using Gaiad manager `gm` with an arbitrary topology of IBC channels.
 
-Using `gm` we will start five [`gaia`](https://github.com/cosmos/gaia) chains that support the `IBC` protocol.
+Using `gm` we will start four [`gaia`](https://github.com/cosmos/gaia) chains that support the `IBC` protocol.
 
-Make sure that you followed the steps in the [Pre-requisites for local chains](../pre-requisites/index.md) section.
-
-
-```mermaid
-flowchart LR
-    ibc0((ibc-0))
-    ibc1((ibc-1))
-    ibc2((ibc-2))
-    ibc3((ibc-3))
-
-    ibc0---ibc1
-    ibc0---ibc3
-    ibc1---ibc3
-    ibc2---ibc3
-    ibc2---ibc1
-
-```
+Make sure that you followed the steps in the [Pre-requisites for local chains](../pre-requisites/index.md) section before moving to the [next section](./start-local-chains.md).

guide/src/tutorials/more-chains/start-local-chains.md

@@ -2,6 +2,20 @@
 
 In this chapter, you will learn how to spawn four Gaia chains, connect them in an arbitrary topology and use Hermes to transfer tokens between them.
 
+```mermaid
+flowchart LR
+    ibc0((ibc-0))
+    ibc1((ibc-1))
+    ibc2((ibc-2))
+    ibc3((ibc-3))
+
+    ibc0---ibc1
+    ibc1---ibc2
+    ibc2---ibc3
+    ibc0---ibc3
+
+```
+
 As for the [Local chains tutorial](../local-chains/index.md), we will make use of Gaiad Manager `gm` that we installed in [Install Gaiad Manager](../pre-requisites/gaiad-manager.md).
 
 ### Reset your configuration
@@ -390,4 +404,4 @@ $HOME/.hermes/
 
 #### Next Steps
 
-[The next section](./topology.md) describes how to create an arbitrary topology between these chains before relaying packets.
+[The next section](./build-the-topology.md) describes how to create an arbitrary topology between these chains before relaying packets.