penumbra_ibc/component/
ibc_component.rs

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
use std::sync::Arc;

use anyhow::Result;
use cnidarium::StateWrite;
use ibc_types::{
    core::client::Height, lightclients::tendermint::ConsensusState as TendermintConsensusState,
};
use tendermint::abci;
use tracing::instrument;

use crate::{
    component::{client::StateWriteExt as _, client_counter::ClientCounter},
    genesis, StateWriteExt as _,
};

use super::HostInterface;

pub struct Ibc {}

// Note: [`Ibc`] does not implement the [`cnidarium_component::Component`] trait
// this is because we want to have a bound on [`HostInterface`] in the `begin_block`
// processing.
impl Ibc {
    #[instrument(name = "ibc", skip(state, app_state))]
    pub async fn init_chain<S: StateWrite>(mut state: S, app_state: Option<&genesis::Content>) {
        match app_state {
            Some(genesis) => {
                state.put_ibc_params(genesis.ibc_params.clone());
                state.put_client_counter(ClientCounter(0))
            }
            None => { /* perform upgrade specific check */ }
        }
    }

    #[instrument(name = "ibc", skip(state, begin_block))]
    pub async fn begin_block<HI: HostInterface, S: StateWrite + 'static>(
        state: &mut Arc<S>,
        begin_block: &abci::request::BeginBlock,
    ) {
        let state = Arc::get_mut(state).expect("state should be unique");
        // In BeginBlock, we want to save a copy of our consensus state to our
        // own state tree, so that when we get a message from our
        // counterparties, we can verify that they are committing the correct
        // consensus states for us to their state tree.
        let commitment_root: Vec<u8> = begin_block.header.app_hash.clone().into();
        let cs = TendermintConsensusState::new(
            ibc_types::core::commitment::MerkleRoot {
                hash: commitment_root,
            },
            begin_block.header.time,
            begin_block.header.next_validators_hash,
        );

        // Currently, we don't use a revision number, because we don't have
        // any further namespacing of blocks than the block height.
        let height = Height::new(
            HI::get_revision_number(&state)
                .await
                .expect("must be able to get revision number in begin block"),
            begin_block.header.height.into(),
        )
        .expect("block height cannot be zero");

        state.put_penumbra_consensus_state(height, cs);
    }

    #[instrument(name = "ibc", skip(_state, _end_block))]
    pub async fn end_block<S: StateWrite + 'static>(
        mut _state: &mut Arc<S>,
        _end_block: &abci::request::EndBlock,
    ) {
    }

    #[instrument(name = "ibc", skip(_state))]
    pub async fn end_epoch<S: StateWrite + 'static>(mut _state: &mut Arc<S>) -> Result<()> {
        Ok(())
    }
}