hermes-cli 0.1.0

Hermes: IBC Relayer in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

use hermes_cli_components::traits::build::CanLoadBuilder;
use hermes_cli_framework::command::CommandRunner;
use hermes_cli_framework::output::Output;
use hermes_cosmos_relayer::contexts::chain::CosmosChain;
use hermes_relayer_components::build::traits::builders::relay_builder::CanBuildRelay;
use hermes_relayer_components::chain::traits::queries::chain_status::CanQueryChainHeight;
use hermes_relayer_components::chain::traits::queries::client_state::CanQueryClientStateWithLatestHeight;
use hermes_relayer_components::multi::types::index::Twindex;
use hermes_relayer_components::relay::traits::target::SourceTarget;
use hermes_relayer_components::relay::traits::update_client_message_builder::CanSendTargetUpdateClientMessage;
use ibc_relayer_types::core::ics02_client::height::Height;
use ibc_relayer_types::core::ics24_host::identifier::{ChainId, ClientId};
use oneline_eyre::eyre::Context;
use tracing::info;

use crate::contexts::app::HermesApp;
use crate::impls::error_wrapper::ErrorWrapper;
use crate::Result;

#[derive(Debug, clap::Parser)]
pub struct ClientUpdate {
    #[clap(
        long = "host-chain",
        required = true,
        value_name = "HOST_CHAIN_ID",
        help_heading = "REQUIRED",
        help = "Identifier of the chain that hosts the client"
    )]
    host_chain_id: ChainId,

    #[clap(
        long = "client",
        required = true,
        value_name = "CLIENT_ID",
        help_heading = "REQUIRED",
        help = "Identifier of the client to update"
    )]
    client_id: ClientId,

    #[clap(
        long = "height",
        value_name = "HEIGHT",
        help = "The target height of the client update. Leave unspecified for latest height."
    )]
    target_height: Option<u64>,
}

impl CommandRunner<HermesApp> for ClientUpdate {
    async fn run(&self, app: &HermesApp) -> Result<Output> {
        let builder = app.load_builder().await?;

        let host_chain = builder.build_chain(&self.host_chain_id).await?;

        let client_state =
            <CosmosChain as CanQueryClientStateWithLatestHeight<CosmosChain>>::
            query_client_state_with_latest_height(&host_chain, &self.client_id)
            .await?;

        let reference_chain_id = client_state.chain_id;
        let reference_chain = builder.build_chain(&reference_chain_id).await?;

        let relayer = builder
            .build_relay(
                Twindex::<0, 1>,
                &self.host_chain_id,
                &reference_chain_id,
                &self.client_id,
                &self.client_id, // nothing to pass here
            )
            .await?;

        let target_height = match self.target_height {
            Some(height) => {
                let height = Height::new(reference_chain_id.version(), height)
                    .wrap_err("Invalid value for --target-height")?;

                info!("Updating client using specified target height: {height}");
                height
            }
            None => {
                let height = reference_chain.query_chain_height().await?;

                info!("Updating client using specified target height: {height}");
                height
            }
        };

        relayer
            .send_target_update_client_messages(SourceTarget, &target_height)
            .await
            .wrap_error("Failed to send update client message")?;

        Ok(Output::success_msg("Client successfully updated!"))
    }
}