From c20e4915b8b38a7a7d648e91ea0ee4f931693fee Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 14 Jul 2023 16:30:56 -0700
Subject: [PATCH 001/182] fix: use `Vec<u8>` for header attribute instead of
 `Any` (#766)

* fix(api): use Vec<u8> for HeaderAttribute instead of Any

* misc: add unclog
---
 .../764-use-vec-for-header-attribute.md               |  2 ++
 crates/ibc/src/core/ics02_client/events.rs            | 11 +++++------
 .../src/core/ics02_client/handler/update_client.rs    |  4 ++--
 3 files changed, 9 insertions(+), 8 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md

diff --git a/.changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md b/.changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md
new file mode 100644
index 000000000..dcedb279d
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md
@@ -0,0 +1,2 @@
+- Use Vec<u8> for HeaderAttribute instead of Any
+  ([#764](https://github.com/cosmos/ibc-rs/issues/764))
diff --git a/crates/ibc/src/core/ics02_client/events.rs b/crates/ibc/src/core/ics02_client/events.rs
index c216521b1..8d9f87b65 100644
--- a/crates/ibc/src/core/ics02_client/events.rs
+++ b/crates/ibc/src/core/ics02_client/events.rs
@@ -2,7 +2,6 @@
 use crate::prelude::*;
 
 use derive_more::From;
-use ibc_proto::google::protobuf::Any;
 use subtle_encoding::hex;
 use tendermint::abci;
 
@@ -147,14 +146,14 @@ impl From<ConsensusHeightsAttribute> for abci::EventAttribute {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, From, PartialEq, Eq)]
 struct HeaderAttribute {
-    header: Any,
+    header: Vec<u8>,
 }
 
 impl From<HeaderAttribute> for abci::EventAttribute {
     fn from(attr: HeaderAttribute) -> Self {
         (
             HEADER_ATTRIBUTE_KEY,
-            String::from_utf8(hex::encode(attr.header.value))
+            String::from_utf8(hex::encode(attr.header))
                 .expect("Never fails because hexadecimal is valid UTF-8"),
         )
             .into()
@@ -252,7 +251,7 @@ impl UpdateClient {
         client_type: ClientType,
         consensus_height: Height,
         consensus_heights: Vec<Height>,
-        header: Any,
+        header: Vec<u8>,
     ) -> Self {
         Self {
             client_id: ClientIdAttribute::from(client_id),
@@ -279,7 +278,7 @@ impl UpdateClient {
         self.consensus_heights.consensus_heights.as_ref()
     }
 
-    pub fn header(&self) -> &Any {
+    pub fn header(&self) -> &Vec<u8> {
         &self.header.header
     }
 
@@ -471,7 +470,7 @@ mod tests {
                     client_type.clone(),
                     consensus_height,
                     consensus_heights,
-                    header,
+                    header.value,
                 )
                 .into(),
                 expected_keys: expected_keys.clone(),
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 4b88d77cc..3499dac35 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -114,7 +114,7 @@ where
                     client_state.client_type(),
                     *consensus_height,
                     consensus_heights,
-                    header,
+                    header.value,
                 ))
             };
             ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
@@ -488,7 +488,7 @@ mod tests {
         assert_eq!(update_client_event.client_type(), &mock_client_type());
         assert_eq!(update_client_event.consensus_height(), &height);
         assert_eq!(update_client_event.consensus_heights(), &vec![height]);
-        assert_eq!(update_client_event.header(), &header);
+        assert_eq!(update_client_event.header(), &header.value);
     }
 
     fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {

From 1be66995222fa0db750a32819153ccefac7024e3 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 17 Jul 2023 17:50:21 -0700
Subject: [PATCH 002/182] test: include `PacketData` serde test to keep proper
 JSON encoding (#765)

* test: include PacketData test to keep proper JSON encoding

* misc: add unclog

* Update crates/ibc/src/applications/transfer/packet.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* imp: add dummy_json_packet_data function

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
---
 .../745-scale-encoding-for-transfer-packet.md |  0
 ...3-include-PacketData-JSON-encoding-test.md |  2 +
 .../applications/transfer/msgs/transfer.rs    | 89 +++++++------------
 .../ibc/src/applications/transfer/packet.rs   | 54 +++++++++++
 crates/ibc/src/core/handler.rs                | 32 ++-----
 5 files changed, 96 insertions(+), 81 deletions(-)
 rename .changelog/unreleased/{improvement => improvements}/745-scale-encoding-for-transfer-packet.md (100%)
 create mode 100644 .changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md

diff --git a/.changelog/unreleased/improvement/745-scale-encoding-for-transfer-packet.md b/.changelog/unreleased/improvements/745-scale-encoding-for-transfer-packet.md
similarity index 100%
rename from .changelog/unreleased/improvement/745-scale-encoding-for-transfer-packet.md
rename to .changelog/unreleased/improvements/745-scale-encoding-for-transfer-packet.md
diff --git a/.changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md b/.changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md
new file mode 100644
index 000000000..1088b2467
--- /dev/null
+++ b/.changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md
@@ -0,0 +1,2 @@
+- Add test to ensure `PacketData`` keeps proper JSON encoding
+  ([#763](https://github.com/cosmos/ibc-rs/issues/763))
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index 746386f26..0b22755aa 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -127,71 +127,44 @@ pub mod test_util {
 
     use core::ops::Add;
     use core::time::Duration;
-    use primitive_types::U256;
 
     use super::MsgTransfer;
     use crate::applications::transfer::packet::PacketData;
-    use crate::applications::transfer::Coin;
     use crate::core::ics04_channel::packet::{Packet, Sequence};
     use crate::core::ics04_channel::timeout::TimeoutHeight;
-    use crate::signer::Signer;
-    use crate::{
-        applications::transfer::BaseCoin,
-        core::ics24_host::identifier::{ChannelId, PortId},
-        test_utils::get_dummy_bech32_account,
-    };
-
-    // Returns a dummy ICS20 `MsgTransfer`. If no `timeout_timestamp` is
-    // specified, a timestamp of 10 seconds in the future is used.
-    pub fn get_dummy_msg_transfer(
-        timeout_height: TimeoutHeight,
-        timeout_timestamp: Option<Timestamp>,
-    ) -> MsgTransfer {
-        let address: Signer = get_dummy_bech32_account().into();
-        MsgTransfer {
-            port_id_on_a: PortId::default(),
-            chan_id_on_a: ChannelId::default(),
-            packet_data: PacketData {
-                token: BaseCoin {
-                    denom: "uatom".parse().unwrap(),
-                    amount: U256::from(10).into(),
-                }
-                .into(),
-                sender: address.clone(),
-                receiver: address,
-                memo: "".to_owned().into(),
-            },
-            timeout_timestamp_on_b: timeout_timestamp
-                .unwrap_or_else(|| Timestamp::now().add(Duration::from_secs(10)).unwrap()),
-            timeout_height_on_b: timeout_height,
+    use crate::core::ics24_host::identifier::{ChannelId, PortId};
+
+    impl MsgTransfer {
+        // Returns a dummy ICS20 `MsgTransfer`. If no `timeout_timestamp` is
+        // specified, a timestamp of 10 seconds in the future is used.
+        pub fn new_dummy(
+            timeout_height: TimeoutHeight,
+            timeout_timestamp: Option<Timestamp>,
+        ) -> Self {
+            Self {
+                port_id_on_a: PortId::default(),
+                chan_id_on_a: ChannelId::default(),
+                packet_data: PacketData::new_dummy(),
+                timeout_timestamp_on_b: timeout_timestamp
+                    .unwrap_or_else(|| Timestamp::now().add(Duration::from_secs(10)).unwrap()),
+                timeout_height_on_b: timeout_height,
+            }
         }
-    }
 
-    pub fn get_dummy_transfer_packet(msg: MsgTransfer, sequence: Sequence) -> Packet {
-        let coin = Coin {
-            denom: msg.packet_data.token.denom.clone(),
-            amount: msg.packet_data.token.amount,
-        };
-
-        let data = {
-            let data = PacketData {
-                token: coin,
-                sender: msg.packet_data.sender.clone(),
-                receiver: msg.packet_data.receiver.clone(),
-                memo: msg.packet_data.memo.clone(),
-            };
-            serde_json::to_vec(&data).expect("PacketData's infallible Serialize impl failed")
-        };
-
-        Packet {
-            seq_on_a: sequence,
-            port_id_on_a: msg.port_id_on_a,
-            chan_id_on_a: msg.chan_id_on_a,
-            port_id_on_b: PortId::default(),
-            chan_id_on_b: ChannelId::default(),
-            data,
-            timeout_height_on_b: msg.timeout_height_on_b,
-            timeout_timestamp_on_b: msg.timeout_timestamp_on_b,
+        pub fn get_transfer_packet(&self, sequence: Sequence) -> Packet {
+            let data = serde_json::to_vec(&self.packet_data)
+                .expect("PacketData's infallible Serialize impl failed");
+
+            Packet {
+                seq_on_a: sequence,
+                port_id_on_a: self.port_id_on_a.clone(),
+                chan_id_on_a: self.chan_id_on_a.clone(),
+                port_id_on_b: PortId::default(),
+                chan_id_on_b: ChannelId::default(),
+                data,
+                timeout_height_on_b: self.timeout_height_on_b,
+                timeout_timestamp_on_b: self.timeout_timestamp_on_b,
+            }
         }
     }
 }
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index 89f1d5b4e..882003f48 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -55,3 +55,57 @@ impl From<PacketData> for RawPacketData {
         }
     }
 }
+
+#[cfg(test)]
+mod tests {
+
+    use super::*;
+    use crate::applications::transfer::BaseCoin;
+    use crate::test_utils::get_dummy_bech32_account;
+    use primitive_types::U256;
+
+    impl PacketData {
+        pub fn new_dummy() -> Self {
+            let address: Signer = get_dummy_bech32_account().into();
+
+            Self {
+                token: BaseCoin {
+                    denom: "uatom".parse().unwrap(),
+                    amount: U256::from(10).into(),
+                }
+                .into(),
+                sender: address.clone(),
+                receiver: address,
+                memo: "".to_string().into(),
+            }
+        }
+
+        pub fn ser_json_assert_eq(&self, json: &str) {
+            let ser = serde_json::to_string(&self).unwrap();
+            assert_eq!(ser, json);
+        }
+
+        pub fn deser_json_assert_eq(&self, json: &str) {
+            let deser: Self = serde_json::from_str(json).unwrap();
+            assert_eq!(&deser, self);
+        }
+    }
+
+    pub fn dummy_json_packet_data() -> &'static str {
+        r#"{"denom":"uatom","amount":"10","sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","memo":""}"#
+    }
+
+    /// Ensures `PacketData` properly encodes to JSON by first converting to a
+    /// `RawPacketData` and then serializing that.
+    #[test]
+    fn test_packet_data_ser() {
+        PacketData::new_dummy().ser_json_assert_eq(dummy_json_packet_data());
+    }
+
+    /// Ensures `PacketData` properly decodes from JSON by first deserializing to a
+    /// `RawPacketData` and then converting from that.
+    #[test]
+    fn test_packet_data_deser() {
+        PacketData::new_dummy().deser_json_assert_eq(dummy_json_packet_data());
+    }
+}
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 8d359650b..c13072d8d 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -167,12 +167,8 @@ mod tests {
     use test_log::test;
 
     use crate::applications::transfer::error::TokenTransferError;
-    use crate::applications::transfer::msgs::transfer::test_util::get_dummy_transfer_packet;
     use crate::applications::transfer::send_transfer;
-    use crate::applications::transfer::{
-        msgs::transfer::test_util::get_dummy_msg_transfer, msgs::transfer::MsgTransfer,
-        packet::PacketData, PrefixedCoin, MODULE_ID_STR,
-    };
+    use crate::applications::transfer::{msgs::transfer::MsgTransfer, MODULE_ID_STR};
     use crate::core::dispatch;
     use crate::core::events::{IbcEvent, MessageEvent};
     use crate::core::ics02_client::msgs::{
@@ -321,10 +317,10 @@ mod tests {
             MsgChannelCloseConfirm::try_from(get_dummy_raw_msg_chan_close_confirm(client_height))
                 .unwrap();
 
-        let msg_transfer = get_dummy_msg_transfer(Height::new(0, 35).unwrap().into(), None);
-        let msg_transfer_two = get_dummy_msg_transfer(Height::new(0, 36).unwrap().into(), None);
-        let msg_transfer_no_timeout = get_dummy_msg_transfer(TimeoutHeight::no_timeout(), None);
-        let msg_transfer_no_timeout_or_timestamp = get_dummy_msg_transfer(
+        let msg_transfer = MsgTransfer::new_dummy(Height::new(0, 35).unwrap().into(), None);
+        let msg_transfer_two = MsgTransfer::new_dummy(Height::new(0, 36).unwrap().into(), None);
+        let msg_transfer_no_timeout = MsgTransfer::new_dummy(TimeoutHeight::no_timeout(), None);
+        let msg_transfer_no_timeout_or_timestamp = MsgTransfer::new_dummy(
             TimeoutHeight::no_timeout(),
             Some(Timestamp::from_nanoseconds(0).unwrap()),
         );
@@ -335,24 +331,14 @@ mod tests {
         msg_to_on_close.packet.timeout_height_on_b = msg_transfer_two.timeout_height_on_b;
         msg_to_on_close.packet.timeout_timestamp_on_b = msg_transfer_two.timeout_timestamp_on_b;
 
-        let denom = msg_transfer_two.packet_data.token.denom.clone();
-        let packet_data = {
-            let data = PacketData {
-                token: PrefixedCoin {
-                    denom,
-                    amount: msg_transfer_two.packet_data.token.amount,
-                },
-                sender: msg_transfer_two.packet_data.sender.clone(),
-                receiver: msg_transfer_two.packet_data.receiver.clone(),
-                memo: "".to_owned().into(),
-            };
-            serde_json::to_vec(&data).expect("PacketData's infallible Serialize impl failed")
-        };
+        let packet_data = serde_json::to_vec(&msg_transfer_two.packet_data)
+            .expect("PacketData's infallible Serialize impl failed");
+
         msg_to_on_close.packet.data = packet_data;
 
         let msg_recv_packet = MsgRecvPacket::try_from(get_dummy_raw_msg_recv_packet(35)).unwrap();
         let msg_ack_packet = MsgAcknowledgement::try_from(get_dummy_raw_msg_ack_with_packet(
-            get_dummy_transfer_packet(msg_transfer.clone(), 1u64.into()).into(),
+            msg_transfer.get_transfer_packet(1u64.into()).into(),
             35,
         ))
         .unwrap();

From b6ad8ce55954f2678b57caa0b94feaea3f8eddac Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Wed, 26 Jul 2023 16:18:24 -0700
Subject: [PATCH 003/182] Bump syn from 2.0.23 to 2.0.27 in /ci/no-std-check
 (#775)

Bumps [syn](https://github.com/dtolnay/syn) from 2.0.23 to 2.0.27.
- [Release notes](https://github.com/dtolnay/syn/releases)
- [Commits](https://github.com/dtolnay/syn/compare/2.0.23...2.0.27)

---
updated-dependencies:
- dependency-name: syn
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 ci/no-std-check/Cargo.lock | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 313e97b68..7b976ebe8 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -526,7 +526,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -537,7 +537,7 @@ checksum = "29a358ff9f12ec09c3e61fef9b5a9902623a695a46a917b07f269bff1445611a"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -598,7 +598,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -836,7 +836,7 @@ checksum = "89ca545a94061b6365f2c7355b4b32bd20df3ff95f02da9329b34ccc3bd6ee72"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -1088,7 +1088,7 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -1425,7 +1425,7 @@ dependencies = [
  "sp-io",
  "sp-runtime",
  "sp-std 7.0.0",
- "syn 2.0.23",
+ "syn 2.0.27",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1860,7 +1860,7 @@ checksum = "8d2275aab483050ab2a7364c1a46604865ee7d6906684e08db0f090acf74f9e7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -2123,7 +2123,7 @@ checksum = "d9735b638ccc51c28bf6914d90a2e9725b377144fc612c49a611fddd1b631d68"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -2145,7 +2145,7 @@ checksum = "bcec881020c684085e55a25f7fd888954d56609ef363479dc5a1305eb0d40cab"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -2397,7 +2397,7 @@ checksum = "c7f531814d2f16995144c74428830ccf7d94ff4a7749632b83ad8199b181140c"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -2562,7 +2562,7 @@ dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -2811,9 +2811,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.23"
+version = "2.0.27"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "59fb7d6d8281a51045d62b8eb3a7d1ce347b76f312af50cd3dc0af39c87c1737"
+checksum = "b60f673f44a8255b9c8c657daf66a596d435f2da81a555b06dc644d080ba45e0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2909,7 +2909,7 @@ checksum = "f9456a42c5b0d803c8cd86e73dd7cc9edd429499f37a3550d286d5e86720569f"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -3027,7 +3027,7 @@ checksum = "0f57e3ca2a01450b1a921183a9c9cbfda207fd822cef4ccb00a65402cbba7a74"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]
 
 [[package]]
@@ -3218,7 +3218,7 @@ dependencies = [
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
  "wasm-bindgen-shared",
 ]
 
@@ -3240,7 +3240,7 @@ checksum = "e128beba882dd1eb6200e1dc92ae6c5dbaa4311aa7bb211ca035779e5efc39f8"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
@@ -3781,5 +3781,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.23",
+ "syn 2.0.27",
 ]

From 01e3ab83bd428519e7feaa3428494f94ca84a6b0 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 28 Jul 2023 11:37:57 -0700
Subject: [PATCH 004/182] imp(ics24)!: enhancements and fixes to `ChainId` impl
 and validation (#762)

* imp(ChainId): refactor abstraction and validations

* misc: add unclog

* fix: clippy catches

* fix: revert ChainId definition + improve checks

* fix: set_revision_number
---
 .../761-chain-id-enhancements-and-fixes.md    |   3 +
 .../clients/ics07_tendermint/client_state.rs  |  36 ++-
 .../ibc/src/clients/ics07_tendermint/error.rs |  19 +-
 .../src/clients/ics07_tendermint/header.rs    |   7 +-
 .../clients/ics07_tendermint/misbehaviour.rs  |   9 +-
 .../ics02_client/handler/update_client.rs     |  30 +--
 .../ics03_connection/handler/conn_open_ack.rs |   2 +-
 .../ics03_connection/handler/conn_open_try.rs |   2 +-
 crates/ibc/src/core/ics24_host/identifier.rs  | 209 ++++++++++--------
 .../core/ics24_host/identifier/validate.rs    |  78 ++++---
 .../hosts/tendermint/validate_self_client.rs  |   2 +-
 crates/ibc/src/mock/context.rs                |  30 +--
 crates/ibc/src/mock/host.rs                   |  10 +-
 crates/ibc/src/mock/ics18_relayer/context.rs  |   4 +-
 crates/ibc/tests/support/signed_header.json   |   2 +-
 15 files changed, 240 insertions(+), 203 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md

diff --git a/.changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md b/.changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md
new file mode 100644
index 000000000..0cb98cbb2
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md
@@ -0,0 +1,3 @@
+- Enhancements and fixes to `ChainId` impls and validation.
+  ([#761](https://github.com/cosmos/ibc-rs/issues/761))
+
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index be1a1e7e0..687811ec2 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -8,6 +8,7 @@ use crate::prelude::*;
 
 use core::cmp::max;
 use core::convert::{TryFrom, TryInto};
+use core::str::FromStr;
 use core::time::Duration;
 
 use ibc_proto::google::protobuf::Any;
@@ -147,13 +148,7 @@ impl ClientState {
     }
 
     pub fn validate(&self) -> Result<(), Error> {
-        if self.chain_id.as_str().len() > MaxChainIdLen {
-            return Err(Error::ChainIdTooLong {
-                chain_id: self.chain_id.clone(),
-                len: self.chain_id.as_str().len(),
-                max_len: MaxChainIdLen,
-            });
-        }
+        self.chain_id.validate_length(3, MaxChainIdLen)?;
 
         // `TrustThreshold` is guaranteed to be in the range `[0, 1)`, but a `TrustThreshold::ZERO`
         // value is invalid in this context
@@ -202,7 +197,7 @@ impl ClientState {
             });
         }
 
-        if self.latest_height.revision_number() != self.chain_id.version() {
+        if self.latest_height.revision_number() != self.chain_id.revision_number() {
             return Err(Error::InvalidLatestHeight {
                 reason: "ClientState latest-height revision number must match chain-id version"
                     .to_string(),
@@ -606,7 +601,7 @@ impl TryFrom<RawTmClientState> for ClientState {
     type Error = Error;
 
     fn try_from(raw: RawTmClientState) -> Result<Self, Self::Error> {
-        let chain_id = ChainId::from_string(raw.chain_id.as_str());
+        let chain_id = ChainId::from_str(raw.chain_id.as_str())?;
 
         let trust_level = {
             let trust_level = raw
@@ -791,7 +786,7 @@ mod tests {
     fn client_state_new() {
         // Define a "default" set of parameters to reuse throughout these tests.
         let default_params: ClientStateParams = ClientStateParams {
-            id: ChainId::default(),
+            id: ChainId::new("ibc", 0).unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
             unbonding_period: Duration::new(128000, 0),
@@ -834,9 +829,9 @@ mod tests {
                 want_pass: true,
             },
             Test {
-                name: "Valid long (50 chars) chain-id".to_string(),
+                name: "Valid long (50 chars) chain-id that satisfies revision_number length < `u16::MAX` length".to_string(),
                 params: ClientStateParams {
-                    id: ChainId::new(&"a".repeat(48), 0),
+                    id: ChainId::new(&"a".repeat(29), 0).unwrap(),
                     ..default_params.clone()
                 },
                 want_pass: true,
@@ -844,7 +839,7 @@ mod tests {
             Test {
                 name: "Invalid too-long (51 chars) chain-id".to_string(),
                 params: ClientStateParams {
-                    id: ChainId::new(&"a".repeat(49), 0),
+                    id: ChainId::new(&"a".repeat(30), 0).unwrap(),
                     ..default_params.clone()
                 },
                 want_pass: false,
@@ -957,7 +952,7 @@ mod tests {
     fn client_state_verify_height() {
         // Define a "default" set of parameters to reuse throughout these tests.
         let default_params: ClientStateParams = ClientStateParams {
-            id: ChainId::new("ibc", 1),
+            id: ChainId::new("ibc", 1).unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
             unbonding_period: Duration::new(128000, 0),
@@ -1095,6 +1090,7 @@ mod serde_tests {
 #[cfg(any(test, feature = "mocks"))]
 pub mod test_util {
     use crate::prelude::*;
+    use core::str::FromStr;
     use core::time::Duration;
 
     use tendermint::block::Header;
@@ -1113,17 +1109,15 @@ pub mod test_util {
         }
 
         pub fn new_dummy_from_header(tm_header: Header) -> Self {
+            let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
             Self::new(
-                tm_header.chain_id.to_string().into(),
+                chain_id.clone(),
                 Default::default(),
                 Duration::from_secs(64000),
                 Duration::from_secs(128000),
                 Duration::from_millis(3000),
-                Height::new(
-                    ChainId::chain_version(tm_header.chain_id.as_str()),
-                    u64::from(tm_header.height),
-                )
-                .expect("Never fails"),
+                Height::new(chain_id.revision_number(), u64::from(tm_header.height))
+                    .expect("Never fails"),
                 Default::default(),
                 Default::default(),
                 AllowUpdate {
@@ -1138,7 +1132,7 @@ pub mod test_util {
     pub fn get_dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
         #[allow(deprecated)]
         RawTmClientState {
-            chain_id: ChainId::new("ibc", 0).to_string(),
+            chain_id: ChainId::new("ibc", 0).expect("Never fails").to_string(),
             trust_level: Some(Fraction {
                 numerator: 1,
                 denominator: 3,
diff --git a/crates/ibc/src/clients/ics07_tendermint/error.rs b/crates/ibc/src/clients/ics07_tendermint/error.rs
index a3a9b5b18..f89878f91 100644
--- a/crates/ibc/src/clients/ics07_tendermint/error.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/error.rs
@@ -3,7 +3,7 @@
 use crate::prelude::*;
 
 use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::{ChainId, ClientId};
+use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
 use crate::Height;
 
 use core::time::Duration;
@@ -17,12 +17,8 @@ use tendermint_light_client_verifier::Verdict;
 /// The main error type
 #[derive(Debug, Display)]
 pub enum Error {
-    /// chain-id is (`{chain_id}`) is too long, got: `{len}`, max allowed: `{max_len}`
-    ChainIdTooLong {
-        chain_id: ChainId,
-        len: usize,
-        max_len: usize,
-    },
+    /// invalid identifier: `{0}`
+    InvalidIdentifier(IdentifierError),
     /// invalid header, failed basic validation: `{reason}`, error: `{error}`
     InvalidHeader {
         reason: String,
@@ -99,14 +95,13 @@ pub enum Error {
     MisbehaviourHeadersBlockHashesEqual,
     /// headers are not at same height and are monotonically increasing
     MisbehaviourHeadersNotAtSameHeight,
-    /// invalid raw client id: `{client_id}`
-    InvalidRawClientId { client_id: String },
 }
 
 #[cfg(feature = "std")]
 impl std::error::Error for Error {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
+            Self::InvalidIdentifier(e) => Some(e),
             Self::InvalidHeader { error: e, .. } => Some(e),
             Self::InvalidTendermintTrustThreshold(e) => Some(e),
             Self::InvalidRawHeader(e) => Some(e),
@@ -124,6 +119,12 @@ impl From<Error> for ClientError {
     }
 }
 
+impl From<IdentifierError> for Error {
+    fn from(e: IdentifierError) -> Self {
+        Self::InvalidIdentifier(e)
+    }
+}
+
 pub(crate) trait IntoResult<T, E> {
     fn into_result(self) -> Result<T, E>;
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index 8fd5c3e81..d24cf409c 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -3,6 +3,7 @@
 use crate::prelude::*;
 use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
+use core::str::FromStr;
 
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
@@ -54,7 +55,9 @@ impl Header {
 
     pub fn height(&self) -> Height {
         Height::new(
-            ChainId::chain_version(self.signed_header.header.chain_id.as_str()),
+            ChainId::from_str(self.signed_header.header.chain_id.as_str())
+                .expect("chain id")
+                .revision_number(),
             u64::from(self.signed_header.header.height),
         )
         .expect("malformed tendermint header domain type has an illegal height of 0")
@@ -89,7 +92,7 @@ impl Header {
     }
 
     pub fn verify_chain_id_version_matches_height(&self, chain_id: &ChainId) -> Result<(), Error> {
-        if self.height().revision_number() != chain_id.version() {
+        if self.height().revision_number() != chain_id.revision_number() {
             return Err(Error::MismatchHeaderChainId {
                 given: self.signed_header.header.chain_id.to_string(),
                 expected: chain_id.to_string(),
diff --git a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
index daf0c12e0..fa5f5fd51 100644
--- a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
@@ -76,18 +76,15 @@ impl TryFrom<RawMisbehaviour> for Misbehaviour {
     type Error = Error;
 
     fn try_from(raw: RawMisbehaviour) -> Result<Self, Self::Error> {
-        let client_id = raw
-            .client_id
-            .parse()
-            .map_err(|_| Error::InvalidRawClientId {
-                client_id: raw.client_id.clone(),
-            })?;
+        let client_id = raw.client_id.parse()?;
+
         let header1: Header = raw
             .header_1
             .ok_or_else(|| Error::InvalidRawMisbehaviour {
                 reason: "missing header1".into(),
             })?
             .try_into()?;
+
         let header2: Header = raw
             .header_2
             .ok_or_else(|| Error::InvalidRawMisbehaviour {
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 3499dac35..b487770f9 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -208,10 +208,10 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1);
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
         let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1),
+            ChainId::new("mockgaiaA", 1).unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -254,10 +254,10 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1);
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
         let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1),
+            ChainId::new("mockgaiaA", 1).unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -301,8 +301,8 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
 
-        let ctx_a_chain_id = ChainId::new("mockgaiaA", 1);
-        let ctx_b_chain_id = ChainId::new("mockgaiaB", 1);
+        let ctx_a_chain_id = ChainId::new("mockgaiaA", 1).unwrap();
+        let ctx_b_chain_id = ChainId::new("mockgaiaB", 1).unwrap();
         let start_height = Height::new(1, 11).unwrap();
 
         let mut ctx_a = MockContext::new(ctx_a_chain_id, HostType::Mock, 5, start_height)
@@ -353,10 +353,12 @@ mod tests {
 
             let tm_block = downcast!(block.clone() => HostBlock::SyntheticTendermint).unwrap();
 
+            let chain_id = ChainId::from_str(tm_block.header().chain_id.as_str()).unwrap();
+
             let client_state = {
                 #[allow(deprecated)]
                 let raw_client_state = RawTmClientState {
-                    chain_id: ChainId::from(tm_block.header().chain_id.to_string()).to_string(),
+                    chain_id: chain_id.to_string(),
                     trust_level: Some(Fraction {
                         numerator: 1,
                         denominator: 3,
@@ -366,7 +368,7 @@ mod tests {
                     max_clock_drift: Some(Duration::from_millis(3000).into()),
                     latest_height: Some(
                         Height::new(
-                            ChainId::chain_version(tm_block.header().chain_id.as_str()),
+                            chain_id.revision_number(),
                             u64::from(tm_block.header().height),
                         )
                         .unwrap()
@@ -426,7 +428,7 @@ mod tests {
         let chain_start_height = Height::new(1, 11).unwrap();
 
         let ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1),
+            ChainId::new("mockgaiaA", 1).unwrap(),
             HostType::Mock,
             5,
             chain_start_height,
@@ -439,7 +441,7 @@ mod tests {
         );
 
         let ctx_b = MockContext::new(
-            ChainId::new("mockgaiaB", 1),
+            ChainId::new("mockgaiaB", 1).unwrap(),
             HostType::SyntheticTendermint,
             5,
             client_height,
@@ -565,11 +567,11 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1);
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
         // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
         let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA", 1),
+            ChainId::new("mockgaiaA", 1).unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -626,11 +628,11 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1);
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
         // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
         let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA", 1),
+            ChainId::new("mockgaiaA", 1).unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index fffb0a747..caa5c01e1 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -255,7 +255,7 @@ mod tests {
 
         let ctx_default = MockContext::default();
         let ctx_new = MockContext::new(
-            ChainId::new("mockgaia", latest_height.revision_number()),
+            ChainId::new("mockgaia", latest_height.revision_number()).unwrap(),
             HostType::Mock,
             max_history_size,
             latest_height,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 5608fe7c0..b26d555d2 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -254,7 +254,7 @@ mod tests {
         };
 
         let ctx_new = MockContext::new(
-            ChainId::new("mockgaia", 0),
+            ChainId::new("mockgaia", 0).unwrap(),
             HostType::Mock,
             max_history_size,
             host_chain_height,
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index 5023faade..5cb5babf8 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -3,7 +3,6 @@
 pub(crate) mod validate;
 use validate::*;
 
-use core::convert::{From, Infallible};
 use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
@@ -18,16 +17,17 @@ use crate::prelude::*;
 const CONNECTION_ID_PREFIX: &str = "connection";
 const CHANNEL_ID_PREFIX: &str = "channel";
 
-const DEFAULT_CHAIN_ID: &str = "defaultChainId";
 const DEFAULT_PORT_ID: &str = "defaultPort";
 const TRANSFER_PORT_ID: &str = "transfer";
 
-/// A `ChainId` is in "epoch format" if it is of the form `{chain name}-{epoch number}`,
-/// where the epoch number is the number of times the chain was upgraded. Chain IDs not
-/// in that format will be assumed to have epoch number 0.
+/// Defines the domain type for chain identifiers.
 ///
-/// This is not standardized yet, although compatible with ibc-go.
-/// See: <https://github.com/informalsystems/ibc-rs/pull/304#discussion_r503917283>.
+/// A valid `ChainId` follows the format {chain name}-{revision number} where
+/// the revision number indicates how many times the chain has been upgraded.
+/// Creating `ChainId`s not in this format will result in an error.
+///
+/// It should be noted this format is not standardized yet, though it is widely
+/// accepted and compatible with Cosmos SDK driven chains.
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -44,37 +44,33 @@ const TRANSFER_PORT_ID: &str = "transfer";
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct ChainId {
     id: String,
-    version: u64,
+    revision_number: u64,
 }
 
 impl ChainId {
-    /// Creates a new `ChainId` given a chain name and an epoch number.
+    /// Creates a new `ChainId` with the given chain name and revision number.
     ///
-    /// The returned `ChainId` will have the format: `{chain name}-{epoch number}`.
+    /// It checks the chain name for valid characters according to `ICS-24`
+    /// specification and returns a `ChainId` in the the format of {chain
+    /// name}-{revision number}. Stricter checks beyond `ICS-24` rests with
+    /// the users, based on their requirements.
     ///
     /// ```
     /// use ibc::core::ics24_host::identifier::ChainId;
     ///
-    /// let epoch_number = 10;
-    /// let id = ChainId::new("chainA", epoch_number);
-    /// assert_eq!(id.version(), epoch_number);
+    /// let revision_number = 10;
+    /// let id = ChainId::new("chainA", revision_number).unwrap();
+    /// assert_eq!(id.revision_number(), revision_number);
     /// ```
-    pub fn new(name: &str, version: u64) -> Self {
-        let id = format!("{name}-{version}");
-        Self { id, version }
-    }
-
-    pub fn from_string(id: &str) -> Self {
-        let version = if Self::is_epoch_format(id) {
-            Self::chain_version(id)
-        } else {
-            0
-        };
-
-        Self {
-            id: id.to_string(),
-            version,
-        }
+    pub fn new(name: &str, revision_number: u64) -> Result<Self, IdentifierError> {
+        let prefix = name.trim();
+        validate_identifier_chars(prefix)?;
+        validate_identifier_length(prefix, 1, 43)?;
+        let id = format!("{prefix}-{revision_number}");
+        Ok(Self {
+            id,
+            revision_number,
+        })
     }
 
     /// Get a reference to the underlying string.
@@ -82,76 +78,57 @@ impl ChainId {
         &self.id
     }
 
-    // TODO: this should probably be named epoch_number.
-    /// Extract the version from this chain identifier.
-    pub fn version(&self) -> u64 {
-        self.version
+    pub fn split_chain_id(&self) -> (&str, u64) {
+        parse_chain_id_string(self.as_str())
+            .expect("never fails because a valid chain identifier is parsed")
     }
 
-    /// Extract the version from the given chain identifier.
-    /// ```
-    /// use ibc::core::ics24_host::identifier::ChainId;
-    ///
-    /// assert_eq!(ChainId::chain_version("chain--a-0"), 0);
-    /// assert_eq!(ChainId::chain_version("ibc-10"), 10);
-    /// assert_eq!(ChainId::chain_version("cosmos-hub-97"), 97);
-    /// assert_eq!(ChainId::chain_version("testnet-helloworld-2"), 2);
-    /// ```
-    pub fn chain_version(chain_id: &str) -> u64 {
-        if !ChainId::is_epoch_format(chain_id) {
-            return 0;
-        }
-
-        let split: Vec<_> = chain_id.split('-').collect();
-        split
-            .last()
-            .expect("get revision number from chain_id")
-            .parse()
-            .unwrap_or(0)
+    /// Extract the chain name from the chain identifier
+    pub fn chain_name(&self) -> &str {
+        self.split_chain_id().0
     }
 
-    /// is_epoch_format() checks if a chain_id is in the format required for parsing epochs
-    /// The chainID must be in the form: `{chainID}-{version}`
-    /// ```
-    /// use ibc::core::ics24_host::identifier::ChainId;
-    /// assert_eq!(ChainId::is_epoch_format("chainA-0"), false);
-    /// assert_eq!(ChainId::is_epoch_format("chainA"), false);
-    /// assert_eq!(ChainId::is_epoch_format("chainA-1"), true);
-    /// assert_eq!(ChainId::is_epoch_format("c-1"), true);
-    /// ```
-    pub fn is_epoch_format(chain_id: &str) -> bool {
-        let re = safe_regex::regex!(br".*[^-]-[1-9][0-9]*");
-        re.is_match(chain_id.as_bytes())
+    /// Extract the revision number from the chain identifier
+    pub fn revision_number(&self) -> u64 {
+        self.revision_number
     }
 
-    /// with_version() checks if a chain_id is in the format required for parsing epochs, and if so
-    /// replaces it's version with the specified version
+    /// Swaps `ChainId`s revision number with the new specified revision number
     /// ```
     /// use ibc::core::ics24_host::identifier::ChainId;
-    /// assert_eq!(ChainId::new("chainA", 1).with_version(2), ChainId::new("chainA", 2));
-    /// assert_eq!("chain1".parse::<ChainId>().unwrap().with_version(2), "chain1".parse::<ChainId>().unwrap());
+    /// let mut chain_id = ChainId::new("chainA", 1).unwrap();
+    /// chain_id.set_revision_number(2);
+    /// assert_eq!(chain_id.revision_number(), 2);
     /// ```
-    pub fn with_version(mut self, version: u64) -> Self {
-        if Self::is_epoch_format(&self.id) {
-            self.id = {
-                let mut split: Vec<&str> = self.id.split('-').collect();
-                let version = version.to_string();
-                if let Some(last_elem) = split.last_mut() {
-                    *last_elem = &version;
-                }
-                split.join("-")
-            };
-            self.version = version;
-        }
-        self
+    pub fn set_revision_number(&mut self, revision_number: u64) {
+        let chain_name = self.chain_name();
+        self.id = format!("{}-{}", chain_name, revision_number);
+        self.revision_number = revision_number;
+    }
+
+    /// A convenient method to check if the `ChainId` forms a valid identifier
+    /// with the desired min/max length. However, ICS-24 does not specify a
+    /// certain min or max lengths for chain identifiers.
+    pub fn validate_length(
+        &self,
+        min_length: usize,
+        max_length: usize,
+    ) -> Result<(), IdentifierError> {
+        validate_prefix_length(self.chain_name(), min_length, max_length)
     }
 }
 
+/// Construct a `ChainId` from a string literal only if it forms a valid
+/// identifier.
 impl FromStr for ChainId {
-    type Err = Infallible;
+    type Err = IdentifierError;
 
     fn from_str(id: &str) -> Result<Self, Self::Err> {
-        Ok(Self::from_string(id))
+        let (_, revision_number) = parse_chain_id_string(id)?;
+        Ok(Self {
+            id: id.to_string(),
+            revision_number,
+        })
     }
 }
 
@@ -161,16 +138,37 @@ impl Display for ChainId {
     }
 }
 
-impl Default for ChainId {
-    fn default() -> Self {
-        Self::from_string(DEFAULT_CHAIN_ID)
-    }
-}
+/// Parses a string intended to represent a `ChainId` and, if successful,
+/// returns a tuple containing the chain name and revision number.
+fn parse_chain_id_string(chain_id_str: &str) -> Result<(&str, u64), IdentifierError> {
+    let (name, rev_number_str) = match chain_id_str.rsplit_once('-') {
+        Some((name, rev_number_str)) => (name, rev_number_str),
+        None => {
+            return Err(IdentifierError::InvalidCharacter {
+                id: chain_id_str.to_string(),
+            })
+        }
+    };
+
+    // Validates the chain name for allowed characters according to ICS-24.
+    validate_identifier_chars(name)?;
 
-impl From<String> for ChainId {
-    fn from(value: String) -> Self {
-        Self::from_string(&value)
+    // Validates the revision number not to start with leading zeros, like "01".
+    if rev_number_str.as_bytes().first() == Some(&b'0') && rev_number_str.len() > 1 {
+        return Err(IdentifierError::InvalidCharacter {
+            id: chain_id_str.to_string(),
+        });
     }
+
+    // Parses the revision number string into a `u64` and checks its validity.
+    let revision_number =
+        rev_number_str
+            .parse()
+            .map_err(|_| IdentifierError::InvalidCharacter {
+                id: chain_id_str.to_string(),
+            })?;
+
+    Ok((name, revision_number))
 }
 
 #[cfg_attr(
@@ -518,3 +516,30 @@ pub enum IdentifierError {
 
 #[cfg(feature = "std")]
 impl std::error::Error for IdentifierError {}
+
+#[cfg(test)]
+mod tests {
+
+    use super::*;
+
+    #[test]
+    fn test_valid_chain_id() {
+        assert!(ChainId::from_str("chainA-0").is_ok());
+        assert!(ChainId::from_str("chainA-1").is_ok());
+        assert!(ChainId::from_str("chainA--1").is_ok());
+        assert!(ChainId::from_str("chainA-1-2").is_ok());
+    }
+
+    #[test]
+    fn test_invalid_chain_id() {
+        assert!(ChainId::from_str("1").is_err());
+        assert!(ChainId::from_str("-1").is_err());
+        assert!(ChainId::from_str("   -1").is_err());
+        assert!(ChainId::from_str("chainA").is_err());
+        assert!(ChainId::from_str("chainA-").is_err());
+        assert!(ChainId::from_str("chainA-a").is_err());
+        assert!(ChainId::from_str("chainA-01").is_err());
+        assert!(ChainId::from_str("/chainA-1").is_err());
+        assert!(ChainId::from_str("chainA-1-").is_err());
+    }
+}
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/crates/ibc/src/core/ics24_host/identifier/validate.rs
index 2e7c0fe00..f926a4c5d 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/crates/ibc/src/core/ics24_host/identifier/validate.rs
@@ -6,15 +6,10 @@ use super::IdentifierError as Error;
 const PATH_SEPARATOR: char = '/';
 const VALID_SPECIAL_CHARS: &str = "._+-#[]<>";
 
-/// Default validator function for identifiers.
-///
-/// A valid identifier only contain valid characters, and be of a given min and
-/// max length as specified in the
+/// Checks if the identifier only contains valid characters as specified in the
 /// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
 /// spec.
-pub fn validate_identifier(id: &str, min: usize, max: usize) -> Result<(), Error> {
-    assert!(max >= min);
-
+pub fn validate_identifier_chars(id: &str) -> Result<(), Error> {
     // Check identifier is not empty
     if id.is_empty() {
         return Err(Error::Empty);
@@ -25,16 +20,6 @@ pub fn validate_identifier(id: &str, min: usize, max: usize) -> Result<(), Error
         return Err(Error::ContainSeparator { id: id.into() });
     }
 
-    // Check identifier length is between given min/max
-    if id.len() < min || id.len() > max {
-        return Err(Error::InvalidLength {
-            id: id.into(),
-            length: id.len(),
-            min,
-            max,
-        });
-    }
-
     // Check that the identifier comprises only valid characters:
     // - Alphanumeric
     // - `.`, `_`, `+`, `-`, `#`
@@ -50,26 +35,42 @@ pub fn validate_identifier(id: &str, min: usize, max: usize) -> Result<(), Error
     Ok(())
 }
 
-/// Checks if the prefix can form a valid identifier with the given min/max identifier's length.
-fn validate_prefix_epoch_format(
+/// Checks if the identifier forms a valid identifier with the given min/max length as specified in the
+/// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
+/// spec.
+pub fn validate_identifier_length(id: &str, min: usize, max: usize) -> Result<(), Error> {
+    assert!(max >= min);
+
+    // Check identifier length is between given min/max
+    if id.len() < min || id.len() > max {
+        return Err(Error::InvalidLength {
+            id: id.into(),
+            length: id.len(),
+            min,
+            max,
+        });
+    }
+
+    Ok(())
+}
+
+/// Checks if a prefix forms a valid identifier with the given min/max identifier's length.
+/// The prefix must be between `min_id_length - 2`, considering `u64::MIN` (1 char) and "-"
+/// and `max_id_length - 21` characters, considering `u64::MAX` (20 chars) and "-".
+pub fn validate_prefix_length(
     prefix: &str,
     min_id_length: usize,
     max_id_length: usize,
 ) -> Result<(), Error> {
-    // Checks if the prefix is not blank
-    if prefix.is_empty() {
-        return Err(Error::Empty)?;
-    }
-
-    // Checks if the prefix forms a valid identifier when used with `0`
-    validate_identifier(
+    // Checks if the prefix forms a valid identifier length when constructed with `u64::MIN`
+    validate_identifier_length(
         &format!("{prefix}-{}", u64::MIN),
         min_id_length,
         max_id_length,
     )?;
 
-    // Checks if the prefix forms a valid identifier when used with `u64::MAX`
-    validate_identifier(
+    // Checks if the prefix forms a valid identifier length when constructed with `u64::MAX`
+    validate_identifier_length(
         &format!("{prefix}-{}", u64::MAX),
         min_id_length,
         max_id_length,
@@ -80,7 +81,8 @@ fn validate_prefix_epoch_format(
 
 /// Default validator function for the Client types.
 pub fn validate_client_type(id: &str) -> Result<(), Error> {
-    validate_prefix_epoch_format(id, 9, 64)
+    validate_identifier_chars(id)?;
+    validate_prefix_length(id, 9, 64)
 }
 
 /// Default validator function for Client identifiers.
@@ -88,7 +90,8 @@ pub fn validate_client_type(id: &str) -> Result<(), Error> {
 /// A valid client identifier must be between 9-64 characters as specified in
 /// the ICS-24 spec.
 pub fn validate_client_identifier(id: &str) -> Result<(), Error> {
-    validate_identifier(id, 9, 64)
+    validate_identifier_chars(id)?;
+    validate_identifier_length(id, 9, 64)
 }
 
 /// Default validator function for Connection identifiers.
@@ -96,7 +99,8 @@ pub fn validate_client_identifier(id: &str) -> Result<(), Error> {
 /// A valid connection identifier must be between 10-64 characters as specified
 /// in the ICS-24 spec.
 pub fn validate_connection_identifier(id: &str) -> Result<(), Error> {
-    validate_identifier(id, 10, 64)
+    validate_identifier_chars(id)?;
+    validate_identifier_length(id, 10, 64)
 }
 
 /// Default validator function for Port identifiers.
@@ -104,7 +108,8 @@ pub fn validate_connection_identifier(id: &str) -> Result<(), Error> {
 /// A valid port identifier must be between 2-128 characters as specified in the
 /// ICS-24 spec.
 pub fn validate_port_identifier(id: &str) -> Result<(), Error> {
-    validate_identifier(id, 2, 128)
+    validate_identifier_chars(id)?;
+    validate_identifier_length(id, 2, 128)
 }
 
 /// Default validator function for Channel identifiers.
@@ -112,7 +117,8 @@ pub fn validate_port_identifier(id: &str) -> Result<(), Error> {
 /// A valid channel identifier must be between 8-64 characters as specified in
 /// the ICS-24 spec.
 pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
-    validate_identifier(id, 8, 64)
+    validate_identifier_chars(id)?;
+    validate_identifier_length(id, 8, 64)
 }
 
 #[cfg(test)]
@@ -188,21 +194,21 @@ mod tests {
     #[test]
     fn parse_invalid_id_chars() {
         // invalid id chars
-        let id = validate_identifier("channel@01", 1, 10);
+        let id = validate_identifier_chars("channel@01");
         assert!(id.is_err())
     }
 
     #[test]
     fn parse_invalid_id_empty() {
         // invalid id empty
-        let id = validate_identifier("", 1, 10);
+        let id = validate_identifier_chars("");
         assert!(id.is_err())
     }
 
     #[test]
     fn parse_invalid_id_path_separator() {
         // invalid id with path separator
-        let id = validate_identifier("id/1", 1, 10);
+        let id = validate_identifier_chars("id/1");
         assert!(id.is_err())
     }
 
diff --git a/crates/ibc/src/hosts/tendermint/validate_self_client.rs b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
index b305027d4..ce8a6c3f6 100644
--- a/crates/ibc/src/hosts/tendermint/validate_self_client.rs
+++ b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
@@ -43,7 +43,7 @@ pub trait ValidateSelfClientContext {
             .map_err(ContextError::ConnectionError);
         }
 
-        let self_revision_number = self_chain_id.version();
+        let self_revision_number = self_chain_id.revision_number();
         if self_revision_number != tm_client_state.latest_height().revision_number() {
             return Err(ConnectionError::InvalidClientState {
                 reason: format!(
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 78b5bc802..04e49752a 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -234,7 +234,7 @@ pub struct MockContext {
 impl Default for MockContext {
     fn default() -> Self {
         Self::new(
-            ChainId::new("mockgaia", 0),
+            ChainId::new("mockgaia", 0).expect("Never fails"),
             HostType::Mock,
             5,
             Height::new(0, 5).expect("Never fails"),
@@ -293,7 +293,7 @@ impl MockContext {
         let n = min(max_history_size as u64, latest_height.revision_height());
 
         assert_eq!(
-            host_id.version(),
+            host_id.revision_number(),
             latest_height.revision_number(),
             "The version in the chain identifier must match the version in the latest height"
         );
@@ -900,7 +900,7 @@ impl ValidationContext for MockContext {
         mock_client_state.confirm_not_frozen()?;
 
         let self_chain_id = &self.host_chain_id;
-        let self_revision_number = self_chain_id.version();
+        let self_revision_number = self_chain_id.revision_number();
         if self_revision_number != mock_client_state.latest_height().revision_number() {
             return Err(ConnectionError::InvalidClientState {
                 reason: format!(
@@ -1395,11 +1395,13 @@ mod tests {
         }
         let cv = 1; // The version to use for all chains.
 
+        let mock_chain_id = ChainId::new("mockgaia", cv).unwrap();
+
         let tests: Vec<Test> = vec![
             Test {
                 name: "Empty history, small pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::Mock,
                     2,
                     Height::new(cv, 1).expect("Never fails"),
@@ -1408,7 +1410,7 @@ mod tests {
             Test {
                 name: "[Synthetic TM host] Empty history, small pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mocksgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::SyntheticTendermint,
                     2,
                     Height::new(cv, 1).expect("Never fails"),
@@ -1417,7 +1419,7 @@ mod tests {
             Test {
                 name: "Large pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::Mock,
                     30,
                     Height::new(cv, 2).expect("Never fails"),
@@ -1426,7 +1428,7 @@ mod tests {
             Test {
                 name: "[Synthetic TM host] Large pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mocksgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::SyntheticTendermint,
                     30,
                     Height::new(cv, 2).expect("Never fails"),
@@ -1435,7 +1437,7 @@ mod tests {
             Test {
                 name: "Small pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::Mock,
                     3,
                     Height::new(cv, 30).expect("Never fails"),
@@ -1444,7 +1446,7 @@ mod tests {
             Test {
                 name: "[Synthetic TM host] Small pruning window".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::SyntheticTendermint,
                     3,
                     Height::new(cv, 30).expect("Never fails"),
@@ -1453,7 +1455,7 @@ mod tests {
             Test {
                 name: "Small pruning window, small starting height".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::Mock,
                     3,
                     Height::new(cv, 2).expect("Never fails"),
@@ -1462,7 +1464,7 @@ mod tests {
             Test {
                 name: "[Synthetic TM host] Small pruning window, small starting height".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::SyntheticTendermint,
                     3,
                     Height::new(cv, 2).expect("Never fails"),
@@ -1471,7 +1473,7 @@ mod tests {
             Test {
                 name: "Large pruning window, large starting height".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id.clone(),
                     HostType::Mock,
                     50,
                     Height::new(cv, 2000).expect("Never fails"),
@@ -1480,7 +1482,7 @@ mod tests {
             Test {
                 name: "[Synthetic TM host] Large pruning window, large starting height".to_string(),
                 ctx: MockContext::new(
-                    ChainId::new("mockgaia", cv),
+                    mock_chain_id,
                     HostType::SyntheticTendermint,
                     50,
                     Height::new(cv, 2000).expect("Never fails"),
@@ -1732,7 +1734,7 @@ mod tests {
         }
 
         let mut ctx = MockContext::new(
-            ChainId::new("mockgaia", 1),
+            ChainId::new("mockgaia", 1).unwrap(),
             HostType::Mock,
             1,
             Height::new(1, 1).expect("Never fails"),
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc/src/mock/host.rs
index 1c52e2700..6a964ea90 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc/src/mock/host.rs
@@ -1,5 +1,7 @@
 //! Host chain types and methods, used by context mock.
 
+use core::str::FromStr;
+
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::protobuf::Protobuf as ErasedProtobuf;
@@ -59,7 +61,9 @@ impl HostBlock {
         match self {
             HostBlock::Mock(header) => header.height(),
             HostBlock::SyntheticTendermint(light_block) => Height::new(
-                ChainId::chain_version(light_block.header().chain_id.as_str()),
+                ChainId::from_str(light_block.header().chain_id.as_str())
+                    .expect("Never fails")
+                    .revision_number(),
                 light_block.header().height.value(),
             )
             .expect("Never fails"),
@@ -90,7 +94,7 @@ impl HostBlock {
     ) -> HostBlock {
         match chain_type {
             HostType::Mock => HostBlock::Mock(Box::new(MockHeader {
-                height: Height::new(chain_id.version(), height).expect("Never fails"),
+                height: Height::new(chain_id.revision_number(), height).expect("Never fails"),
                 timestamp,
             })),
             HostType::SyntheticTendermint => HostBlock::SyntheticTendermint(Box::new(
@@ -112,7 +116,7 @@ impl HostBlock {
         .generate()
         .expect("Never fails");
         SyntheticTmBlock {
-            trusted_height: Height::new(chain_id.version(), 1).expect("Never fails"),
+            trusted_height: Height::new(chain_id.revision_number(), 1).expect("Never fails"),
             light_block,
         }
     }
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc/src/mock/ics18_relayer/context.rs
index d9ec46f1e..3b569eff1 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc/src/mock/ics18_relayer/context.rs
@@ -100,8 +100,8 @@ mod tests {
         let client_on_a_for_b = ClientId::new(tm_client_type(), 0).unwrap();
         let client_on_b_for_a = ClientId::new(mock_client_type(), 0).unwrap();
 
-        let chain_id_a = ChainId::new("mockgaiaA", 1);
-        let chain_id_b = ChainId::new("mockgaiaB", 1);
+        let chain_id_a = ChainId::new("mockgaiaA", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
         // Create two mock contexts, one for each chain.
         let mut ctx_a =
diff --git a/crates/ibc/tests/support/signed_header.json b/crates/ibc/tests/support/signed_header.json
index 9416df80c..c4fe96713 100644
--- a/crates/ibc/tests/support/signed_header.json
+++ b/crates/ibc/tests/support/signed_header.json
@@ -4,7 +4,7 @@
       "block": "0",
       "app": "0"
     },
-    "chain_id": "test-chain-01",
+    "chain_id": "test-chain-1",
     "height": "20",
     "time": "2019-11-02T15:04:10Z",
     "last_block_id": {

From 17c42c3ced7428da82fa5681ca634a759c79ecf2 Mon Sep 17 00:00:00 2001
From: dzmitry-lahoda <dzmitry@lahoda.pro>
Date: Mon, 31 Jul 2023 14:26:58 +0100
Subject: [PATCH 005/182] Json schema for Coin and some parts of Transfer
 (#772)

* support for optional json schema

* some comment about using json schema

* more schema

* prefixed denom schema and amount fixes

* final transfer things

* release note

* connection is needed too

* std is for schema

* fixed de of u256

* tests behind flag

* clean up
---
 .../772-json-schema-for-channels-and-coin.md  |  2 ++
 crates/ibc/Cargo.toml                         |  5 +++
 .../ibc/src/applications/transfer/amount.rs   | 36 ++++++++++++++++++-
 crates/ibc/src/applications/transfer/coin.rs  |  5 +--
 crates/ibc/src/applications/transfer/denom.rs |  7 ++++
 crates/ibc/src/applications/transfer/memo.rs  |  1 +
 .../ibc/src/applications/transfer/packet.rs   |  4 +++
 crates/ibc/src/core/ics02_client/height.rs    |  1 +
 crates/ibc/src/core/ics04_channel/timeout.rs  |  3 +-
 crates/ibc/src/core/ics24_host/identifier.rs  |  3 ++
 crates/ibc/src/signer.rs                      |  1 +
 11 files changed, 62 insertions(+), 6 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md

diff --git a/.changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md b/.changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md
new file mode 100644
index 000000000..e7603beb7
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md
@@ -0,0 +1,2 @@
+- Serde: Schema for Coin/Transfer, Amount is string 
+  ([#772](https://github.com/cosmos/ibc-rs/issues/772))
\ No newline at end of file
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index bc8ff0222..3cfb03102 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -41,6 +41,9 @@ borsh = ["dep:borsh", "ibc-proto/borsh"]
 # This feature is required for token transfer (ICS-20)
 serde = ["dep:serde", "dep:serde_derive", "serde_json", "ics23/serde"]
 
+# CosmWasm message API generator compatible, should not be inside on chain code
+schema = ["dep:schemars", "serde", "std"]
+
 # This feature grants access to development-time mocking libraries, such as `MockContext` or `MockHeader`.
 # Depends on the `testgen` suite for generating Tendermint light blocks.
 mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
@@ -74,6 +77,8 @@ parking_lot = { version = "0.12.1", default-features = false, optional = true }
 
 ibc-derive = { version = "0.1.0", path = "../ibc-derive"}
 
+schemars = { version = "0.8.12", optional = true }
+
 [dependencies.tendermint]
 version = "0.32"
 default-features = false
diff --git a/crates/ibc/src/applications/transfer/amount.rs b/crates/ibc/src/applications/transfer/amount.rs
index 2b266a5ca..740e24d0c 100644
--- a/crates/ibc/src/applications/transfer/amount.rs
+++ b/crates/ibc/src/applications/transfer/amount.rs
@@ -6,10 +6,19 @@ use derive_more::{Display, From, Into};
 use super::error::TokenTransferError;
 use primitive_types::U256;
 
+#[cfg(feature = "schema")]
+use crate::alloc::{borrow::ToOwned, string::String};
+
 /// A type for representing token transfer amounts.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Copy, Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display, From, Into)]
-pub struct Amount(U256);
+pub struct Amount(
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
+    #[serde(serialize_with = "crate::serializers::serde_string::serialize")]
+    #[serde(deserialize_with = "deserialize")]
+    U256,
+);
 
 #[cfg(feature = "parity-scale-codec")]
 impl parity_scale_codec::WrapperTypeDecode for Amount {
@@ -63,3 +72,28 @@ impl From<u64> for Amount {
         Self(v.into())
     }
 }
+
+#[cfg(feature = "serde")]
+fn deserialize<'de, D>(deserializer: D) -> Result<U256, D::Error>
+where
+    D: serde::Deserializer<'de>,
+{
+    use serde::Deserialize;
+    U256::from_dec_str(<&str>::deserialize(deserializer)?).map_err(serde::de::Error::custom)
+}
+
+#[cfg(test)]
+#[cfg(feature = "serde")]
+mod tests {
+    use super::Amount;
+
+    #[test]
+    fn serde_amount() {
+        let value = Amount::from(42);
+        let string = serde_json::to_string(&value).expect("can serde string");
+        assert_eq!(string, "\"42\"");
+        let binary = serde_json::to_vec(&value).expect("can serde binary");
+        let de: Amount = serde_json::from_slice(binary.as_ref()).expect("can deserialize");
+        assert_eq!(de, value);
+    }
+}
diff --git a/crates/ibc/src/applications/transfer/coin.rs b/crates/ibc/src/applications/transfer/coin.rs
index f95988093..cad624121 100644
--- a/crates/ibc/src/applications/transfer/coin.rs
+++ b/crates/ibc/src/applications/transfer/coin.rs
@@ -10,9 +10,6 @@ use super::denom::{BaseDenom, PrefixedDenom};
 use super::error::TokenTransferError;
 use crate::prelude::*;
 
-#[cfg(feature = "serde")]
-use crate::serializers::serde_string;
-
 /// A `Coin` type with fully qualified `PrefixedDenom`.
 pub type PrefixedCoin = Coin<PrefixedDenom>;
 
@@ -23,6 +20,7 @@ pub type RawCoin = Coin<String>;
 
 /// Coin defines a token with a denomination and an amount.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
@@ -32,7 +30,6 @@ pub struct Coin<D> {
     /// Denomination
     pub denom: D,
     /// Amount
-    #[cfg_attr(feature = "serde", serde(with = "serde_string"))]
     pub amount: Amount,
 }
 
diff --git a/crates/ibc/src/applications/transfer/denom.rs b/crates/ibc/src/applications/transfer/denom.rs
index b97b007c5..963f6b1d7 100644
--- a/crates/ibc/src/applications/transfer/denom.rs
+++ b/crates/ibc/src/applications/transfer/denom.rs
@@ -27,6 +27,7 @@ use crate::serializers::serde_string;
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display)]
 pub struct BaseDenom(String);
 
@@ -61,6 +62,8 @@ impl FromStr for BaseDenom {
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Ord, PartialOrd, Eq, PartialEq)]
 pub struct TracePrefix {
     port_id: PortId,
@@ -94,6 +97,8 @@ impl Display for TracePrefix {
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Default, Eq, PartialEq, PartialOrd, Ord, From)]
 pub struct TracePath(Vec<TracePrefix>);
 
@@ -184,6 +189,7 @@ impl Display for TracePath {
 
 /// A type that contains the base denomination for ICS20 and the source tracing information path.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -196,6 +202,7 @@ impl Display for TracePath {
 pub struct PrefixedDenom {
     /// A series of `{port-id}/{channel-id}`s for tracing the source of the token.
     #[cfg_attr(feature = "serde", serde(with = "serde_string"))]
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
     pub trace_path: TracePath,
     /// Base denomination of the relayed fungible token.
     pub base_denom: BaseDenom,
diff --git a/crates/ibc/src/applications/transfer/memo.rs b/crates/ibc/src/applications/transfer/memo.rs
index 261828e13..04bc75584 100644
--- a/crates/ibc/src/applications/transfer/memo.rs
+++ b/crates/ibc/src/applications/transfer/memo.rs
@@ -21,6 +21,7 @@ use crate::prelude::*;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Memo(String);
 
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index 882003f48..569ce90bd 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -4,6 +4,9 @@ use alloc::string::ToString;
 use core::convert::TryFrom;
 use core::str::FromStr;
 
+#[cfg(feature = "schema")]
+use crate::alloc::borrow::ToOwned;
+
 use ibc_proto::ibc::applications::transfer::v2::FungibleTokenPacketData as RawPacketData;
 
 use super::error::TokenTransferError;
@@ -16,6 +19,7 @@ use crate::signer::Signer;
     feature = "serde",
     serde(try_from = "RawPacketData", into = "RawPacketData")
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
diff --git a/crates/ibc/src/core/ics02_client/height.rs b/crates/ibc/src/core/ics02_client/height.rs
index 3adced7a9..21297a49d 100644
--- a/crates/ibc/src/core/ics02_client/height.rs
+++ b/crates/ibc/src/core/ics02_client/height.rs
@@ -29,6 +29,7 @@ use crate::core::ics02_client::error::ClientError;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Copy, Clone, PartialEq, Eq, Hash)]
 pub struct Height {
     /// Previously known as "epoch"
diff --git a/crates/ibc/src/core/ics04_channel/timeout.rs b/crates/ibc/src/core/ics04_channel/timeout.rs
index f215dc7fe..96f3096b5 100644
--- a/crates/ibc/src/core/ics04_channel/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/timeout.rs
@@ -29,6 +29,7 @@ use crate::prelude::*;
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Copy, Debug, Hash, Eq, PartialEq)]
 pub enum TimeoutHeight {
     Never,
@@ -148,7 +149,7 @@ impl Display for TimeoutHeight {
 }
 
 #[cfg(feature = "serde")]
-mod serde {
+mod tests {
     use super::TimeoutHeight;
     use serde::{Deserialize, Serialize};
 
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index 5cb5babf8..6ce2f4b18 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -266,6 +266,7 @@ impl PartialEq<str> for ClientId {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct ConnectionId(String);
 
@@ -349,6 +350,7 @@ impl PartialEq<str> for ConnectionId {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct PortId(String);
 
@@ -417,6 +419,7 @@ impl Default for PortId {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct ChannelId(String);
 
diff --git a/crates/ibc/src/signer.rs b/crates/ibc/src/signer.rs
index 4f225593c..672492675 100644
--- a/crates/ibc/src/signer.rs
+++ b/crates/ibc/src/signer.rs
@@ -16,6 +16,7 @@ use derive_more::Display;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
 pub struct Signer(String);
 

From 5b50da01dfe5a5e56b6980f2486b86a84346f971 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 31 Jul 2023 07:27:29 -0700
Subject: [PATCH 006/182] test: include deserialization test for token transfer
 with no memo field (#793)

* test: include deserialization test for no memo condition

* deps: bump ibc-proto-rs version
---
 crates/ibc/Cargo.toml                          | 2 +-
 crates/ibc/src/applications/transfer/packet.rs | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 3cfb03102..48e3f02bb 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,7 +50,7 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.32.0", default-features = false }
+ibc-proto = { version = "0.32.1", default-features = false }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
 time = { version = ">=0.3.0, <0.3.24", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index 569ce90bd..4b7ffb4be 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -99,6 +99,10 @@ mod tests {
         r#"{"denom":"uatom","amount":"10","sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","memo":""}"#
     }
 
+    pub fn dummy_json_packet_data_without_memo() -> &'static str {
+        r#"{"denom":"uatom","amount":"10","sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng"}"#
+    }
+
     /// Ensures `PacketData` properly encodes to JSON by first converting to a
     /// `RawPacketData` and then serializing that.
     #[test]
@@ -111,5 +115,6 @@ mod tests {
     #[test]
     fn test_packet_data_deser() {
         PacketData::new_dummy().deser_json_assert_eq(dummy_json_packet_data());
+        PacketData::new_dummy().deser_json_assert_eq(dummy_json_packet_data_without_memo());
     }
 }

From 9b9cbd04ee3abd0e7da31a06e5477c16ae612466 Mon Sep 17 00:00:00 2001
From: Davirain <davirain.yin@gmail.com>
Date: Tue, 1 Aug 2023 00:48:40 +0800
Subject: [PATCH 007/182] Add serde serialization and deserialization to Packet
 Receipt (#794)

* Add serde serialization and deserialization to PacketMsgType

* Create 794-add-ser-der-for-packet-receipt.md
---
 .changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md | 2 ++
 crates/ibc/src/core/ics04_channel/packet.rs                     | 1 +
 2 files changed, 3 insertions(+)
 create mode 100644 .changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md

diff --git a/.changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md b/.changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md
new file mode 100644
index 000000000..615c392eb
--- /dev/null
+++ b/.changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md
@@ -0,0 +1,2 @@
+- Add serde serialization and deserialization to Packet Receipt
+  ([#794](https://github.com/cosmos/ibc-rs/pull/794))
\ No newline at end of file
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/crates/ibc/src/core/ics04_channel/packet.rs
index e369c9ab4..91ca8fd88 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/crates/ibc/src/core/ics04_channel/packet.rs
@@ -35,6 +35,7 @@ pub enum PacketMsgType {
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug)]
 pub enum Receipt {
     Ok,

From db7e21e4b6355cc39c9e78a3ce054b6b695f9a98 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 31 Jul 2023 11:41:52 -0700
Subject: [PATCH 008/182] Release v0.43.0 (#798)

---
 .../717-organize-ack-types-under-ics04.md     |  0
 ...nc-ics04-events-namings-with-convention.md |  0
 .../breaking-changes/754-fix-issue-747.md     |  0
 .../761-chain-id-enhancements-and-fixes.md    |  0
 .../764-use-vec-for-header-attribute.md       |  0
 .../772-json-schema-for-channels-and-coin.md  |  0
 .../bug/747-fix-747-Protobuf-out-of-memory.md |  0
 .../bug/752-fix-752.md                        |  0
 .../bug/794-add-ser-der-for-packet-receipt.md |  0
 .../745-scale-encoding-for-transfer-packet.md |  0
 ...3-include-PacketData-JSON-encoding-test.md |  0
 .changelog/v0.43.0/summary.md                 |  7 +++
 CHANGELOG.md                                  | 44 +++++++++++++++++++
 CONTRIBUTING.md                               |  2 +-
 ci/no-std-check/Cargo.lock                    |  4 +-
 ci/no-std-check/Cargo.toml                    |  2 +-
 crates/ibc/Cargo.toml                         |  4 +-
 17 files changed, 57 insertions(+), 6 deletions(-)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/717-organize-ack-types-under-ics04.md (100%)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/750-sync-ics04-events-namings-with-convention.md (100%)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/754-fix-issue-747.md (100%)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/761-chain-id-enhancements-and-fixes.md (100%)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/764-use-vec-for-header-attribute.md (100%)
 rename .changelog/{unreleased => v0.43.0}/breaking-changes/772-json-schema-for-channels-and-coin.md (100%)
 rename .changelog/{unreleased => v0.43.0}/bug/747-fix-747-Protobuf-out-of-memory.md (100%)
 rename .changelog/{unreleased => v0.43.0}/bug/752-fix-752.md (100%)
 rename .changelog/{unreleased => v0.43.0}/bug/794-add-ser-der-for-packet-receipt.md (100%)
 rename .changelog/{unreleased => v0.43.0}/improvements/745-scale-encoding-for-transfer-packet.md (100%)
 rename .changelog/{unreleased => v0.43.0}/improvements/763-include-PacketData-JSON-encoding-test.md (100%)
 create mode 100644 .changelog/v0.43.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/717-organize-ack-types-under-ics04.md b/.changelog/v0.43.0/breaking-changes/717-organize-ack-types-under-ics04.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/717-organize-ack-types-under-ics04.md
rename to .changelog/v0.43.0/breaking-changes/717-organize-ack-types-under-ics04.md
diff --git a/.changelog/unreleased/breaking-changes/750-sync-ics04-events-namings-with-convention.md b/.changelog/v0.43.0/breaking-changes/750-sync-ics04-events-namings-with-convention.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/750-sync-ics04-events-namings-with-convention.md
rename to .changelog/v0.43.0/breaking-changes/750-sync-ics04-events-namings-with-convention.md
diff --git a/.changelog/unreleased/breaking-changes/754-fix-issue-747.md b/.changelog/v0.43.0/breaking-changes/754-fix-issue-747.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/754-fix-issue-747.md
rename to .changelog/v0.43.0/breaking-changes/754-fix-issue-747.md
diff --git a/.changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md b/.changelog/v0.43.0/breaking-changes/761-chain-id-enhancements-and-fixes.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/761-chain-id-enhancements-and-fixes.md
rename to .changelog/v0.43.0/breaking-changes/761-chain-id-enhancements-and-fixes.md
diff --git a/.changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md b/.changelog/v0.43.0/breaking-changes/764-use-vec-for-header-attribute.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/764-use-vec-for-header-attribute.md
rename to .changelog/v0.43.0/breaking-changes/764-use-vec-for-header-attribute.md
diff --git a/.changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md b/.changelog/v0.43.0/breaking-changes/772-json-schema-for-channels-and-coin.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/772-json-schema-for-channels-and-coin.md
rename to .changelog/v0.43.0/breaking-changes/772-json-schema-for-channels-and-coin.md
diff --git a/.changelog/unreleased/bug/747-fix-747-Protobuf-out-of-memory.md b/.changelog/v0.43.0/bug/747-fix-747-Protobuf-out-of-memory.md
similarity index 100%
rename from .changelog/unreleased/bug/747-fix-747-Protobuf-out-of-memory.md
rename to .changelog/v0.43.0/bug/747-fix-747-Protobuf-out-of-memory.md
diff --git a/.changelog/unreleased/bug/752-fix-752.md b/.changelog/v0.43.0/bug/752-fix-752.md
similarity index 100%
rename from .changelog/unreleased/bug/752-fix-752.md
rename to .changelog/v0.43.0/bug/752-fix-752.md
diff --git a/.changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md b/.changelog/v0.43.0/bug/794-add-ser-der-for-packet-receipt.md
similarity index 100%
rename from .changelog/unreleased/bug/794-add-ser-der-for-packet-receipt.md
rename to .changelog/v0.43.0/bug/794-add-ser-der-for-packet-receipt.md
diff --git a/.changelog/unreleased/improvements/745-scale-encoding-for-transfer-packet.md b/.changelog/v0.43.0/improvements/745-scale-encoding-for-transfer-packet.md
similarity index 100%
rename from .changelog/unreleased/improvements/745-scale-encoding-for-transfer-packet.md
rename to .changelog/v0.43.0/improvements/745-scale-encoding-for-transfer-packet.md
diff --git a/.changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md b/.changelog/v0.43.0/improvements/763-include-PacketData-JSON-encoding-test.md
similarity index 100%
rename from .changelog/unreleased/improvements/763-include-PacketData-JSON-encoding-test.md
rename to .changelog/v0.43.0/improvements/763-include-PacketData-JSON-encoding-test.md
diff --git a/.changelog/v0.43.0/summary.md b/.changelog/v0.43.0/summary.md
new file mode 100644
index 000000000..836724110
--- /dev/null
+++ b/.changelog/v0.43.0/summary.md
@@ -0,0 +1,7 @@
+This release bumps ibc-proto to v0.32.1, resolving issue with token transfer
+deserialization for cases with no memo field provided. It also includes various
+enhancements and bug fixes, such as reorganized acknowledgement types, enhanced
+`ChainId` validation, improved `from_str` height creation, synchronized channel
+event namings for consistency.
+
+There are consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 33ab163dd..f64adc79d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,49 @@
 # CHANGELOG
 
+## v0.43.0
+
+*July 31, 2023*
+
+This release bumps ibc-proto to v0.32.1, resolving issue with token transfer
+deserialization for cases with no memo field provided. It also includes various
+enhancements and bug fixes, such as reorganized acknowledgement types, enhanced
+`ChainId` validation, improved `from_str` height creation, synchronized channel
+event namings for consistency.
+
+There are consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- Organize acknowledgement types under the `ics04_channel` module to get
+  accessible by any applications.
+  ([#717](https://github.com/cosmos/ibc-rs/issues/717))
+- Sync field and method namings of ics04 events with the convention
+  ([#750](https://github.com/cosmos/ibc-rs/issues/750))
+- use ibc_proto::protobuf::Protobuf to replace tendermint_proto::Protobuf
+  ([#754](https://github.com/cosmos/ibc-rs/pull/754))
+- Enhancements and fixes to `ChainId` impls and validation.
+  ([#761](https://github.com/cosmos/ibc-rs/issues/761))
+- Use `Vec<u8>` for HeaderAttribute instead of `Any`
+  ([#764](https://github.com/cosmos/ibc-rs/issues/764))
+- Serde: Schema for Coin/Transfer, Amount is string
+  ([#772](https://github.com/cosmos/ibc-rs/issues/772))
+
+### BUG-FIXES
+
+- Tendermint ConsensusState -> Any can crash if out of memory
+  ([#747](https://github.com/cosmos/ibc-rs/issues/747))
+- `Height::from_str` accepts invalid heights
+  ([#752](https://github.com/cosmos/ibc-rs/issues/752))
+- Add serde serialization and deserialization to Packet Receipt
+  ([#794](https://github.com/cosmos/ibc-rs/pull/794))
+
+### IMPROVEMENTS
+
+- Scale encoding for ICS-20 transfer message
+  ([#745](https://github.com/cosmos/ibc-rs/issues/745))
+- Add test to ensure `PacketData` keeps proper JSON encoding
+  ([#763](https://github.com/cosmos/ibc-rs/issues/763))
+
 ## v0.42.0
 
 *July 5, 2023*
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 33afc0de7..a73a2d289 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -243,7 +243,7 @@ Our release process is as follows:
    1. Running `unclog build -u` and copy pasting the output at the top
       of the `CHANGELOG.md` file, making sure to update the header with
       the new version.
-   2. Running `unclog release --editor <editor> vX.Y.Z` to create a summary of all of the changes
+   2. Running `unclog release --editor <editor> --version vX.Y.Z` to create a summary of all of the changes
       in this release.
       1. Your text editor will open. Write the release summary, and close the editor.
          1. Make sure to include a comment on whether or not the release contains consensus-breaking changes.
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 7b976ebe8..609ee9079 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1093,9 +1093,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.32.0"
+version = "0.32.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c888103095b45bee90cb9104513ade30abd69902153b0682b5ad81940ae1f865"
+checksum = "11c352715b36685c2543556a77091fb16af5d26257d5ce9c28e6756c1ccd71aa"
 dependencies = [
  "base64 0.21.2",
  "borsh",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 1b9f07446..b6911b057 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,7 +6,7 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../crates/ibc", default-features = false }
-ibc-proto = { version = "0.32.0", default-features = false, features = [
+ibc-proto = { version = "0.32.1", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
 ] }
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 48e3f02bb..045999611 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.42.0"
+version      = "0.43.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -52,7 +52,7 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
 ibc-proto = { version = "0.32.1", default-features = false }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.24", default-features = false }
+time = { version = ">=0.3.0, <0.3.25", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json = { version = "1", default-features = false, optional = true }

From b116d40dd78181382e95073c226907b73ff61c69 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 31 Jul 2023 13:36:25 -0700
Subject: [PATCH 009/182] Release v0.43.1 (#799)

* bump ibc-derive version to 0.2.0

* bump ibc version to v0.43.1

* dep: fetch ibc-derive from crates-io

* bump ibc-derive version
---
 CHANGELOG.md                 | 2 +-
 crates/ibc-derive/Cargo.toml | 2 +-
 crates/ibc/Cargo.toml        | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f64adc79d..7297db6fd 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # CHANGELOG
 
-## v0.43.0
+## v0.43.1
 
 *July 31, 2023*
 
diff --git a/crates/ibc-derive/Cargo.toml b/crates/ibc-derive/Cargo.toml
index aa18910e4..5463fc8bb 100644
--- a/crates/ibc-derive/Cargo.toml
+++ b/crates/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "ibc-derive"
-version = "0.1.0"
+version = "0.2.0"
 license = "Apache-2.0"
 readme = "README.md"
 description = "Macros implementation of #[derive(ClientState)] and #[derive(ConsensusState)]"
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 045999611..5fca810d1 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.43.0"
+version      = "0.43.1"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -75,7 +75,7 @@ scale-info = { version = "2.1.2", default-features = false, features = ["derive"
 borsh = {version = "0.9.0", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
 
-ibc-derive = { version = "0.1.0", path = "../ibc-derive"}
+ibc-derive = "0.2.0"
 
 schemars = { version = "0.8.12", optional = true }
 

From 7191d8839eb2ff8c9e95a455a5727e233ea2b28a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Tue, 1 Aug 2023 14:55:03 -0400
Subject: [PATCH 010/182] Decouple `Router` from `ValidationContext` (#789)

* fix mocks

* clippy

* changelog

* move module retrieval outside of handlers
---
 .../breaking-changes/788-decouple-router.md   |   2 +
 crates/ibc/src/core/context.rs                |   3 +-
 crates/ibc/src/core/handler.rs                | 139 ++++++++++++------
 .../ics04_channel/handler/acknowledgement.rs  |  33 +++--
 .../handler/chan_close_confirm.rs             |  23 ++-
 .../ics04_channel/handler/chan_close_init.rs  |  36 +++--
 .../ics04_channel/handler/chan_open_ack.rs    |  32 ++--
 .../handler/chan_open_confirm.rs              |  31 ++--
 .../ics04_channel/handler/chan_open_init.rs   |  30 ++--
 .../ics04_channel/handler/chan_open_try.rs    |  31 ++--
 .../core/ics04_channel/handler/recv_packet.rs |  25 ++--
 .../src/core/ics04_channel/handler/timeout.rs |  35 +++--
 crates/ibc/src/mock/context.rs                |  84 ++---------
 crates/ibc/src/mock/ics18_relayer/context.rs  |  10 +-
 crates/ibc/src/mock/mod.rs                    |   2 +
 crates/ibc/src/mock/router.rs                 |  54 +++++++
 16 files changed, 319 insertions(+), 251 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/788-decouple-router.md
 create mode 100644 crates/ibc/src/mock/router.rs

diff --git a/.changelog/unreleased/breaking-changes/788-decouple-router.md b/.changelog/unreleased/breaking-changes/788-decouple-router.md
new file mode 100644
index 000000000..15e21c2e5
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/788-decouple-router.md
@@ -0,0 +1,2 @@
+- Decouple `Router` from `ValidationContext`
+  ([#788](https://github.com/cosmos/ibc-rs/pull/788))
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index c1409449f..67420200a 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -27,7 +27,6 @@ use crate::core::ics24_host::path::{
     AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
     ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use crate::core::router::Router;
 use crate::core::timestamp::Timestamp;
 use crate::Height;
 
@@ -92,7 +91,7 @@ impl std::error::Error for RouterError {
 /// Context to be implemented by the host that provides all "read-only" methods.
 ///
 /// Trait used for the top-level [`validate`](crate::core::validate)
-pub trait ValidationContext: Router {
+pub trait ValidationContext {
     type ClientValidationContext;
     type E: ClientExecutionContext;
     type AnyConsensusState: ConsensusState;
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index c13072d8d..8bd035848 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -5,6 +5,7 @@ use super::ics03_connection::handler::{
     conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try,
 };
 use super::ics03_connection::msgs::ConnectionMsg;
+use super::ics04_channel::error::ChannelError;
 use super::ics04_channel::handler::acknowledgement::{
     acknowledgement_packet_execute, acknowledgement_packet_validate,
 };
@@ -28,12 +29,17 @@ use super::ics04_channel::handler::timeout::{
 };
 use super::ics04_channel::msgs::{ChannelMsg, PacketMsg};
 use super::msgs::MsgEnvelope;
+use super::router::Router;
 use super::{ContextError, ExecutionContext, ValidationContext};
 
 /// Entrypoint which performs both validation and message execution
-pub fn dispatch(ctx: &mut impl ExecutionContext, msg: MsgEnvelope) -> Result<(), RouterError> {
-    validate(ctx, msg.clone())?;
-    execute(ctx, msg)
+pub fn dispatch(
+    ctx: &mut impl ExecutionContext,
+    router: &mut impl Router,
+    msg: MsgEnvelope,
+) -> Result<(), RouterError> {
+    validate(ctx, router, msg.clone())?;
+    execute(ctx, router, msg)
 }
 
 /// Entrypoint which only performs message validation
@@ -44,7 +50,11 @@ pub fn dispatch(ctx: &mut impl ExecutionContext, msg: MsgEnvelope) -> Result<(),
 /// That is, the state transition of message `i` must be applied before
 /// message `i+1` is validated. This is equivalent to calling
 /// `dispatch()` on each successively.
-pub fn validate<Ctx>(ctx: &Ctx, msg: MsgEnvelope) -> Result<(), RouterError>
+pub fn validate<Ctx>(
+    ctx: &Ctx,
+    router: &mut impl Router,
+    msg: MsgEnvelope,
+) -> Result<(), RouterError>
 where
     Ctx: ValidationContext,
 {
@@ -68,31 +78,39 @@ where
         }
         .map_err(RouterError::ContextError),
         MsgEnvelope::Channel(msg) => {
-            let module_id = ctx
+            let module_id = router
                 .lookup_module_channel(&msg)
                 .map_err(ContextError::from)?;
+            let module = router
+                .get_route(&module_id)
+                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
 
             match msg {
-                ChannelMsg::OpenInit(msg) => chan_open_init_validate(ctx, module_id, msg),
-                ChannelMsg::OpenTry(msg) => chan_open_try_validate(ctx, module_id, msg),
-                ChannelMsg::OpenAck(msg) => chan_open_ack_validate(ctx, module_id, msg),
-                ChannelMsg::OpenConfirm(msg) => chan_open_confirm_validate(ctx, module_id, msg),
-                ChannelMsg::CloseInit(msg) => chan_close_init_validate(ctx, module_id, msg),
-                ChannelMsg::CloseConfirm(msg) => chan_close_confirm_validate(ctx, module_id, msg),
+                ChannelMsg::OpenInit(msg) => chan_open_init_validate(ctx, module, msg),
+                ChannelMsg::OpenTry(msg) => chan_open_try_validate(ctx, module, msg),
+                ChannelMsg::OpenAck(msg) => chan_open_ack_validate(ctx, module, msg),
+                ChannelMsg::OpenConfirm(msg) => chan_open_confirm_validate(ctx, module, msg),
+                ChannelMsg::CloseInit(msg) => chan_close_init_validate(ctx, module, msg),
+                ChannelMsg::CloseConfirm(msg) => chan_close_confirm_validate(ctx, module, msg),
             }
             .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
-            let module_id = ctx.lookup_module_packet(&msg).map_err(ContextError::from)?;
+            let module_id = router
+                .lookup_module_packet(&msg)
+                .map_err(ContextError::from)?;
+            let module = router
+                .get_route(&module_id)
+                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
 
             match msg {
                 PacketMsg::Recv(msg) => recv_packet_validate(ctx, msg),
-                PacketMsg::Ack(msg) => acknowledgement_packet_validate(ctx, module_id, msg),
+                PacketMsg::Ack(msg) => acknowledgement_packet_validate(ctx, module, msg),
                 PacketMsg::Timeout(msg) => {
-                    timeout_packet_validate(ctx, module_id, TimeoutMsgType::Timeout(msg))
+                    timeout_packet_validate(ctx, module, TimeoutMsgType::Timeout(msg))
                 }
                 PacketMsg::TimeoutOnClose(msg) => {
-                    timeout_packet_validate(ctx, module_id, TimeoutMsgType::TimeoutOnClose(msg))
+                    timeout_packet_validate(ctx, module, TimeoutMsgType::TimeoutOnClose(msg))
                 }
             }
             .map_err(RouterError::ContextError)
@@ -101,7 +119,11 @@ where
 }
 
 /// Entrypoint which only performs message execution
-pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgEnvelope) -> Result<(), RouterError>
+pub fn execute<Ctx>(
+    ctx: &mut Ctx,
+    router: &mut impl Router,
+    msg: MsgEnvelope,
+) -> Result<(), RouterError>
 where
     Ctx: ExecutionContext,
 {
@@ -125,31 +147,39 @@ where
         }
         .map_err(RouterError::ContextError),
         MsgEnvelope::Channel(msg) => {
-            let module_id = ctx
+            let module_id = router
                 .lookup_module_channel(&msg)
                 .map_err(ContextError::from)?;
+            let module = router
+                .get_route_mut(&module_id)
+                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
 
             match msg {
-                ChannelMsg::OpenInit(msg) => chan_open_init_execute(ctx, module_id, msg),
-                ChannelMsg::OpenTry(msg) => chan_open_try_execute(ctx, module_id, msg),
-                ChannelMsg::OpenAck(msg) => chan_open_ack_execute(ctx, module_id, msg),
-                ChannelMsg::OpenConfirm(msg) => chan_open_confirm_execute(ctx, module_id, msg),
-                ChannelMsg::CloseInit(msg) => chan_close_init_execute(ctx, module_id, msg),
-                ChannelMsg::CloseConfirm(msg) => chan_close_confirm_execute(ctx, module_id, msg),
+                ChannelMsg::OpenInit(msg) => chan_open_init_execute(ctx, module, msg),
+                ChannelMsg::OpenTry(msg) => chan_open_try_execute(ctx, module, msg),
+                ChannelMsg::OpenAck(msg) => chan_open_ack_execute(ctx, module, msg),
+                ChannelMsg::OpenConfirm(msg) => chan_open_confirm_execute(ctx, module, msg),
+                ChannelMsg::CloseInit(msg) => chan_close_init_execute(ctx, module, msg),
+                ChannelMsg::CloseConfirm(msg) => chan_close_confirm_execute(ctx, module, msg),
             }
             .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
-            let module_id = ctx.lookup_module_packet(&msg).map_err(ContextError::from)?;
+            let module_id = router
+                .lookup_module_packet(&msg)
+                .map_err(ContextError::from)?;
+            let module = router
+                .get_route_mut(&module_id)
+                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
 
             match msg {
-                PacketMsg::Recv(msg) => recv_packet_execute(ctx, module_id, msg),
-                PacketMsg::Ack(msg) => acknowledgement_packet_execute(ctx, module_id, msg),
+                PacketMsg::Recv(msg) => recv_packet_execute(ctx, module, msg),
+                PacketMsg::Ack(msg) => acknowledgement_packet_execute(ctx, module, msg),
                 PacketMsg::Timeout(msg) => {
-                    timeout_packet_execute(ctx, module_id, TimeoutMsgType::Timeout(msg))
+                    timeout_packet_execute(ctx, module, TimeoutMsgType::Timeout(msg))
                 }
                 PacketMsg::TimeoutOnClose(msg) => {
-                    timeout_packet_execute(ctx, module_id, TimeoutMsgType::TimeoutOnClose(msg))
+                    timeout_packet_execute(ctx, module, TimeoutMsgType::TimeoutOnClose(msg))
                 }
             }
             .map_err(RouterError::ContextError)
@@ -216,6 +246,7 @@ mod tests {
     use crate::mock::consensus_state::MockConsensusState;
     use crate::mock::context::MockContext;
     use crate::mock::header::MockHeader;
+    use crate::mock::router::MockRouter;
     use crate::prelude::*;
     use crate::test_utils::{get_dummy_account_id, DummyTransferModule};
     use crate::Height;
@@ -267,13 +298,12 @@ mod tests {
         let transfer_module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
 
         // We reuse this same context across all tests. Nothing in particular needs parametrizing.
-        let mut ctx = {
-            let mut ctx = MockContext::default();
-            let module = DummyTransferModule::new();
-            ctx.add_route(transfer_module_id.clone(), module).unwrap();
+        let mut ctx = MockContext::default();
 
-            ctx
-        };
+        let mut router = MockRouter::default();
+        router
+            .add_route(transfer_module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let create_client_msg = MsgCreateClient::new(
             MockClientState::new(MockHeader::new(start_client_height)).into(),
@@ -346,6 +376,7 @@ mod tests {
         // First, create a client..
         let res = dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Client(ClientMsg::CreateClient(create_client_msg.clone())),
         );
 
@@ -354,7 +385,7 @@ mod tests {
             "ICS26 routing dispatch test 'client creation' failed for message {create_client_msg:?} with result: {res:?}",
         );
 
-        ctx.scope_port_to_module(msg_chan_init.port_id_on_a.clone(), transfer_module_id);
+        router.scope_port_to_module(msg_chan_init.port_id_on_a.clone(), transfer_module_id);
 
         // Figure out the ID of the client that was just created.
         assert!(matches!(
@@ -576,7 +607,7 @@ mod tests {
 
         for test in tests {
             let res = match test.msg.clone() {
-                TestMsg::Ics26(msg) => dispatch(&mut ctx, msg).map(|_| ()),
+                TestMsg::Ics26(msg) => dispatch(&mut ctx, &mut router, msg).map(|_| ()),
                 TestMsg::Ics20(msg) => send_transfer(&mut ctx, msg)
                     .map_err(|e: TokenTransferError| ChannelError::AppModule {
                         description: e.to_string(),
@@ -606,9 +637,9 @@ mod tests {
         }
     }
 
-    fn get_channel_events_ctx() -> MockContext {
+    fn get_channel_events_ctx_router() -> (MockContext, MockRouter) {
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut ctx = MockContext::default()
+        let ctx = MockContext::default()
             .with_client(&ClientId::default(), Height::new(0, 1).unwrap())
             .with_connection(
                 ConnectionId::new(0),
@@ -625,25 +656,28 @@ mod tests {
                 )
                 .unwrap(),
             );
-        let module = DummyTransferModule::new();
+        let mut router = MockRouter::default();
 
-        ctx.add_route(module_id.clone(), module).unwrap();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         // Note: messages will be using the default port
-        ctx.scope_port_to_module(PortId::default(), module_id);
+        router.scope_port_to_module(PortId::default(), module_id);
 
-        ctx
+        (ctx, router)
     }
 
     #[test]
     fn test_chan_open_init_event() {
-        let mut ctx = get_channel_events_ctx();
+        let (mut ctx, mut router) = get_channel_events_ctx_router();
 
         let msg_chan_open_init =
             MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::OpenInit(msg_chan_open_init)),
         )
         .unwrap();
@@ -658,13 +692,14 @@ mod tests {
 
     #[test]
     fn test_chan_open_try_event() {
-        let mut ctx = get_channel_events_ctx();
+        let (mut ctx, mut router) = get_channel_events_ctx_router();
 
         let msg_chan_open_try =
             MsgChannelOpenTry::try_from(get_dummy_raw_msg_chan_open_try(1)).unwrap();
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::OpenTry(msg_chan_open_try)),
         )
         .unwrap();
@@ -679,7 +714,8 @@ mod tests {
 
     #[test]
     fn test_chan_open_ack_event() {
-        let mut ctx = get_channel_events_ctx().with_channel(
+        let (ctx, mut router) = get_channel_events_ctx_router();
+        let mut ctx = ctx.with_channel(
             PortId::default(),
             ChannelId::default(),
             ChannelEnd::new(
@@ -697,6 +733,7 @@ mod tests {
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::OpenAck(msg_chan_open_ack)),
         )
         .unwrap();
@@ -711,7 +748,8 @@ mod tests {
 
     #[test]
     fn test_chan_open_confirm_event() {
-        let mut ctx = get_channel_events_ctx().with_channel(
+        let (ctx, mut router) = get_channel_events_ctx_router();
+        let mut ctx = ctx.with_channel(
             PortId::default(),
             ChannelId::default(),
             ChannelEnd::new(
@@ -729,6 +767,7 @@ mod tests {
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::OpenConfirm(msg_chan_open_confirm)),
         )
         .unwrap();
@@ -743,7 +782,8 @@ mod tests {
 
     #[test]
     fn test_chan_close_init_event() {
-        let mut ctx = get_channel_events_ctx().with_channel(
+        let (ctx, mut router) = get_channel_events_ctx_router();
+        let mut ctx = ctx.with_channel(
             PortId::default(),
             ChannelId::default(),
             ChannelEnd::new(
@@ -761,6 +801,7 @@ mod tests {
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::CloseInit(msg_chan_close_init)),
         )
         .unwrap();
@@ -775,7 +816,8 @@ mod tests {
 
     #[test]
     fn test_chan_close_confirm_event() {
-        let mut ctx = get_channel_events_ctx().with_channel(
+        let (ctx, mut router) = get_channel_events_ctx_router();
+        let mut ctx = ctx.with_channel(
             PortId::default(),
             ChannelId::default(),
             ChannelEnd::new(
@@ -793,6 +835,7 @@ mod tests {
 
         dispatch(
             &mut ctx,
+            &mut router,
             MsgEnvelope::Channel(ChannelMsg::CloseConfirm(msg_chan_close_confirm)),
         )
         .unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index e65cbecaa..9a92398ab 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -14,12 +14,13 @@ use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqAckPath,
 };
-use crate::core::{events::IbcEvent, ics04_channel::events::AcknowledgePacket, router::ModuleId};
+use crate::core::router::Module;
+use crate::core::{events::IbcEvent, ics04_channel::events::AcknowledgePacket};
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn acknowledgement_packet_validate<ValCtx>(
     ctx_a: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgAcknowledgement,
 ) -> Result<(), ContextError>
 where
@@ -27,10 +28,6 @@ where
 {
     validate(ctx_a, &msg)?;
 
-    let module = ctx_a
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     module
         .on_acknowledgement_packet_validate(&msg.packet, &msg.acknowledgement, &msg.signer)
         .map_err(ContextError::PacketError)
@@ -38,7 +35,7 @@ where
 
 pub(crate) fn acknowledgement_packet_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgAcknowledgement,
 ) -> Result<(), ContextError>
 where
@@ -73,10 +70,6 @@ where
         return Ok(());
     };
 
-    let module = ctx_a
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let (extras, cb_result) =
         module.on_acknowledgement_packet_execute(&msg.packet, &msg.acknowledgement, &msg.signer);
 
@@ -236,14 +229,18 @@ mod tests {
     use crate::core::ics24_host::identifier::ChannelId;
     use crate::core::ics24_host::identifier::PortId;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::Timestamp;
     use crate::core::timestamp::ZERO_DURATION;
 
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
 
     struct Fixture {
         ctx: MockContext,
+        router: MockRouter,
         client_height: Height,
         module_id: ModuleId,
         msg: MsgAcknowledgement,
@@ -256,11 +253,12 @@ mod tests {
     #[fixture]
     fn fixture() -> Fixture {
         let client_height = Height::new(0, 2).unwrap();
-        let mut ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+        let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+        let mut router = MockRouter::default();
 
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
         let module = DummyTransferModule::new();
-        ctx.add_route(module_id.clone(), module).unwrap();
+        router.add_route(module_id.clone(), module).unwrap();
 
         let msg = MsgAcknowledgement::try_from(get_dummy_raw_msg_acknowledgement(
             client_height.revision_height(),
@@ -302,6 +300,7 @@ mod tests {
 
         Fixture {
             ctx,
+            router,
             client_height,
             module_id,
             msg,
@@ -402,6 +401,7 @@ mod tests {
     fn ack_unordered_chan_execute(fixture: Fixture) {
         let Fixture {
             ctx,
+            mut router,
             module_id,
             msg,
             packet_commitment,
@@ -423,7 +423,8 @@ mod tests {
                 packet_commitment,
             );
 
-        let res = acknowledgement_packet_execute(&mut ctx, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = acknowledgement_packet_execute(&mut ctx, module, msg);
 
         assert!(res.is_ok());
 
@@ -439,6 +440,7 @@ mod tests {
     fn ack_ordered_chan_execute(fixture: Fixture) {
         let Fixture {
             ctx,
+            mut router,
             module_id,
             msg,
             packet_commitment,
@@ -460,7 +462,8 @@ mod tests {
                 packet_commitment,
             );
 
-        let res = acknowledgement_packet_execute(&mut ctx, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = acknowledgement_packet_execute(&mut ctx, module, msg);
 
         assert!(res.is_ok());
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index 85f5df02f..de945d5b5 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -14,12 +14,12 @@ use crate::core::ics04_channel::events::CloseConfirm;
 use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_close_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelCloseConfirm,
 ) -> Result<(), ContextError>
 where
@@ -27,9 +27,6 @@ where
 {
     validate(ctx_b, &msg)?;
 
-    let module = ctx_b
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_close_confirm_validate(&msg.port_id_on_b, &msg.chan_id_on_b)?;
 
     Ok(())
@@ -37,15 +34,12 @@ where
 
 pub(crate) fn chan_close_confirm_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelCloseConfirm,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
-    let module = ctx_b
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     let extras = module.on_chan_close_confirm_execute(&msg.port_id_on_b, &msg.chan_id_on_b)?;
     let chan_end_path_on_b = ChannelEndPath::new(&msg.port_id_on_b, &msg.chan_id_on_b);
     let chan_end_on_b = ctx_b.channel_end(&chan_end_path_on_b)?;
@@ -181,12 +175,14 @@ mod tests {
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
     use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::ZERO_DURATION;
 
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
 
     use crate::applications::transfer::MODULE_ID_STR;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
     #[test]
@@ -279,12 +275,15 @@ mod tests {
                 msg_chan_close_confirm.chan_id_on_b.clone(),
                 chan_end,
             );
+        let mut router = MockRouter::default();
 
-        let module = DummyTransferModule::new();
         let module_id = ModuleId::new(MODULE_ID_STR.to_string());
-        context.add_route(module_id.clone(), module).unwrap();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
-        let res = chan_close_confirm_execute(&mut context, module_id, msg_chan_close_confirm);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = chan_close_confirm_execute(&mut context, module, msg_chan_close_confirm);
         assert!(res.is_ok(), "Execution success: happy path");
 
         assert_eq!(context.events.len(), 2);
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
index 448801a15..114f2d16f 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
@@ -9,12 +9,12 @@ use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::CloseInit;
 use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
 use crate::core::ics24_host::path::ChannelEndPath;
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_close_init_validate<ValCtx>(
     ctx_a: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelCloseInit,
 ) -> Result<(), ContextError>
 where
@@ -22,9 +22,6 @@ where
 {
     validate(ctx_a, &msg)?;
 
-    let module = ctx_a
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_close_init_validate(&msg.port_id_on_a, &msg.chan_id_on_a)?;
 
     Ok(())
@@ -32,15 +29,12 @@ where
 
 pub(crate) fn chan_close_init_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelCloseInit,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
-    let module = ctx_a
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     let extras = module.on_chan_close_init_execute(&msg.port_id_on_a, &msg.chan_id_on_a)?;
     let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
     let chan_end_on_a = ctx_a.channel_end(&chan_end_path_on_a)?;
@@ -137,11 +131,14 @@ mod tests {
     use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::ZERO_DURATION;
 
     use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
     #[test]
@@ -224,13 +221,9 @@ mod tests {
         .unwrap();
 
         let mut context = {
-            let mut default_context = MockContext::default();
+            let default_context = MockContext::default();
             let client_consensus_state_height = default_context.host_height().unwrap();
 
-            let module = DummyTransferModule::new();
-            let module_id = ModuleId::new(MODULE_ID_STR.to_string());
-            default_context.add_route(module_id, module).unwrap();
-
             default_context
                 .with_client(&client_id, client_consensus_state_height)
                 .with_connection(conn_id, conn_end)
@@ -241,11 +234,16 @@ mod tests {
                 )
         };
 
-        let res = chan_close_init_execute(
-            &mut context,
-            ModuleId::new(MODULE_ID_STR.to_string()),
-            msg_chan_close_init,
-        );
+        let mut router = MockRouter::default();
+        router
+            .add_route(
+                ModuleId::new(MODULE_ID_STR.to_string()),
+                DummyTransferModule::new(),
+            )
+            .unwrap();
+        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = chan_close_init_execute(&mut context, module, msg_chan_close_init);
         assert!(res.is_ok(), "Execution happy path");
 
         assert_eq!(context.events.len(), 2);
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index b1d229cdb..0356c40a2 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -1,5 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenAck`.
 
+use crate::core::router::Module;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
@@ -14,12 +15,11 @@ use crate::core::ics04_channel::events::OpenAck;
 use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
-use crate::core::router::ModuleId;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_ack_validate<ValCtx>(
     ctx_a: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelOpenAck,
 ) -> Result<(), ContextError>
 where
@@ -27,9 +27,6 @@ where
 {
     validate(ctx_a, &msg)?;
 
-    let module = ctx_a
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_open_ack_validate(&msg.port_id_on_a, &msg.chan_id_on_a, &msg.version_on_b)?;
 
     Ok(())
@@ -37,15 +34,12 @@ where
 
 pub(crate) fn chan_open_ack_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelOpenAck,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
-    let module = ctx_a
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     let extras =
         module.on_chan_open_ack_execute(&msg.port_id_on_a, &msg.chan_id_on_a, &msg.version_on_b)?;
     let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
@@ -180,15 +174,19 @@ mod tests {
     use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
     use crate::core::ics24_host::identifier::ClientId;
     use crate::core::ics24_host::identifier::ConnectionId;
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::ZERO_DURATION;
     use crate::Height;
 
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
     pub struct Fixture {
         pub context: MockContext,
+        pub router: MockRouter,
         pub module_id: ModuleId,
         pub msg: MsgChannelOpenAck,
         pub client_id_on_a: ClientId,
@@ -201,10 +199,13 @@ mod tests {
     #[fixture]
     fn fixture() -> Fixture {
         let proof_height = 10;
-        let mut context = MockContext::default();
-        let module = DummyTransferModule::new();
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        context.add_route(module_id.clone(), module).unwrap();
+        let context = MockContext::default();
+
+        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let client_id_on_a = ClientId::new(mock_client_type(), 45).unwrap();
         let conn_id_on_a = ConnectionId::new(2);
@@ -231,6 +232,7 @@ mod tests {
 
         Fixture {
             context,
+            router,
             module_id,
             msg,
             client_id_on_a,
@@ -359,6 +361,7 @@ mod tests {
     fn chan_open_ack_execute_happy_path(fixture: Fixture) {
         let Fixture {
             context,
+            mut router,
             module_id,
             msg,
             client_id_on_a,
@@ -378,7 +381,8 @@ mod tests {
                 chan_end_on_a,
             );
 
-        let res = chan_open_ack_execute(&mut context, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = chan_open_ack_execute(&mut context, module, msg);
 
         assert!(res.is_ok(), "Execution happy path");
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index dd8e52463..c30c4041c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -14,12 +14,12 @@ use crate::core::ics04_channel::events::OpenConfirm;
 use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelOpenConfirm,
 ) -> Result<(), ContextError>
 where
@@ -27,9 +27,6 @@ where
 {
     validate(ctx_b, &msg)?;
 
-    let module = ctx_b
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_open_confirm_validate(&msg.port_id_on_b, &msg.chan_id_on_b)?;
 
     Ok(())
@@ -37,16 +34,12 @@ where
 
 pub(crate) fn chan_open_confirm_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelOpenConfirm,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
-    let module = ctx_b
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let extras = module.on_chan_open_confirm_execute(&msg.port_id_on_b, &msg.chan_id_on_b)?;
     let chan_end_path_on_b = ChannelEndPath::new(&msg.port_id_on_b, &msg.chan_id_on_b);
     let chan_end_on_b = ctx_b.channel_end(&chan_end_path_on_b)?;
@@ -185,15 +178,19 @@ mod tests {
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::ChannelId;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::ZERO_DURATION;
     use crate::Height;
 
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
 
     pub struct Fixture {
         pub context: MockContext,
+        pub router: MockRouter,
         pub module_id: ModuleId,
         pub msg: MsgChannelOpenConfirm,
         pub client_id_on_b: ClientId,
@@ -206,10 +203,13 @@ mod tests {
     #[fixture]
     fn fixture() -> Fixture {
         let proof_height = 10;
-        let mut context = MockContext::default();
-        let module = DummyTransferModule::new();
+        let context = MockContext::default();
+
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        context.add_route(module_id.clone(), module).unwrap();
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
         let conn_id_on_b = ConnectionId::new(2);
@@ -237,6 +237,7 @@ mod tests {
 
         Fixture {
             context,
+            router,
             module_id,
             msg,
             client_id_on_b,
@@ -338,6 +339,7 @@ mod tests {
     fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
         let Fixture {
             context,
+            mut router,
             module_id,
             msg,
             client_id_on_b,
@@ -357,7 +359,8 @@ mod tests {
                 chan_end_on_b,
             );
 
-        let res = chan_open_confirm_execute(&mut context, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = chan_open_confirm_execute(&mut context, module, msg);
 
         assert!(res.is_ok(), "Execution happy path");
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index 95e9ba3e9..d4f7e5d92 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -5,17 +5,16 @@ use crate::prelude::*;
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::ClientStateCommon;
 use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State};
-use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::OpenInit;
 use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
 use crate::core::ics24_host::identifier::ChannelId;
 use crate::core::ics24_host::path::{ChannelEndPath, SeqAckPath, SeqRecvPath, SeqSendPath};
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_init_validate<ValCtx>(
     ctx_a: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelOpenInit,
 ) -> Result<(), ContextError>
 where
@@ -24,9 +23,6 @@ where
     validate(ctx_a, &msg)?;
     let chan_id_on_a = ChannelId::new(ctx_a.channel_counter()?);
 
-    let module = ctx_a
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_open_init_validate(
         msg.ordering,
         &msg.connection_hops_on_a,
@@ -41,16 +37,13 @@ where
 
 pub(crate) fn chan_open_init_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelOpenInit,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
     let chan_id_on_a = ChannelId::new(ctx_a.channel_counter()?);
-    let module = ctx_a
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     let (extras, version) = module.on_chan_open_init_execute(
         msg.ordering,
         &msg.connection_hops_on_a,
@@ -155,12 +148,16 @@ mod tests {
     use crate::core::ics24_host::identifier::ConnectionId;
 
     use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
     use test_log::test;
 
     pub struct Fixture {
         pub ctx: MockContext,
+        pub router: MockRouter,
         pub module_id: ModuleId,
         pub msg: MsgChannelOpenInit,
     }
@@ -169,10 +166,12 @@ mod tests {
     fn fixture() -> Fixture {
         let msg = MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
 
-        let mut default_ctx = MockContext::default();
+        let default_ctx = MockContext::default();
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let module = DummyTransferModule::new();
-        default_ctx.add_route(module_id.clone(), module).unwrap();
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let msg_conn_init = MsgConnectionOpenInit::new_dummy();
 
@@ -194,6 +193,7 @@ mod tests {
 
         Fixture {
             ctx,
+            router,
             module_id,
             msg,
         }
@@ -238,11 +238,13 @@ mod tests {
     fn chan_open_init_execute_happy_path(fixture: Fixture) {
         let Fixture {
             mut ctx,
+            mut router,
             module_id,
             msg,
         } = fixture;
+        let module = router.get_route_mut(&module_id).unwrap();
 
-        let res = chan_open_init_execute(&mut ctx, module_id, msg);
+        let res = chan_open_init_execute(&mut ctx, module, msg);
 
         assert!(res.is_ok(), "Execution succeeds; good parameters");
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index a9ca05e43..44ff9bf8d 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -1,5 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenTry`.
 
+use crate::core::router::Module;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
@@ -16,12 +17,11 @@ use crate::core::ics24_host::identifier::ChannelId;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
 use crate::core::ics24_host::path::{SeqAckPath, SeqRecvPath, SeqSendPath};
-use crate::core::router::ModuleId;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_try_validate<ValCtx>(
     ctx_b: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     msg: MsgChannelOpenTry,
 ) -> Result<(), ContextError>
 where
@@ -31,9 +31,6 @@ where
 
     let chan_id_on_b = ChannelId::new(ctx_b.channel_counter()?);
 
-    let module = ctx_b
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
     module.on_chan_open_try_validate(
         msg.ordering,
         &msg.connection_hops_on_b,
@@ -48,17 +45,13 @@ where
 
 pub(crate) fn chan_open_try_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgChannelOpenTry,
 ) -> Result<(), ContextError>
 where
     ExecCtx: ExecutionContext,
 {
     let chan_id_on_b = ChannelId::new(ctx_b.channel_counter()?);
-    let module = ctx_b
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let (extras, version) = module.on_chan_open_try_execute(
         msg.ordering,
         &msg.connection_hops_on_b,
@@ -199,16 +192,20 @@ mod tests {
     use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
     use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::ZERO_DURATION;
     use crate::Height;
 
     use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
     pub struct Fixture {
         pub ctx: MockContext,
+        pub router: MockRouter,
         pub module_id: ModuleId,
         pub msg: MsgChannelOpenTry,
         pub client_id_on_b: ClientId,
@@ -241,13 +238,17 @@ mod tests {
         let hops = vec![conn_id_on_b.clone()];
         msg.connection_hops_on_b = hops;
 
-        let mut ctx = MockContext::default();
-        let module = DummyTransferModule::new();
+        let ctx = MockContext::default();
+
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        ctx.add_route(module_id.clone(), module).unwrap();
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         Fixture {
             ctx,
+            router,
             module_id,
             msg,
             client_id_on_b,
@@ -313,6 +314,7 @@ mod tests {
     fn chan_open_try_execute_happy_path(fixture: Fixture) {
         let Fixture {
             ctx,
+            mut router,
             module_id,
             msg,
             client_id_on_b,
@@ -326,7 +328,8 @@ mod tests {
             .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
             .with_connection(conn_id_on_b, conn_end_on_b);
 
-        let res = chan_open_try_execute(&mut ctx, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = chan_open_try_execute(&mut ctx, module, msg);
 
         assert!(res.is_ok(), "Execution success: happy path");
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index fe0f0d131..936b81b97 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -16,7 +16,7 @@ use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, ReceiptPath, SeqRecvPath,
 };
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::timestamp::Expiry;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
@@ -36,7 +36,7 @@ where
 
 pub(crate) fn recv_packet_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     msg: MsgRecvPacket,
 ) -> Result<(), ContextError>
 where
@@ -74,10 +74,6 @@ where
         }
     }
 
-    let module = ctx_b
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let (extras, acknowledgement) = module.on_recv_packet_execute(&msg.packet, &msg.signer);
 
     // state changes
@@ -295,17 +291,21 @@ mod tests {
     use crate::core::ics04_channel::packet::Packet;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::Timestamp;
     use crate::core::timestamp::ZERO_DURATION;
     use crate::Height;
 
     use crate::mock::context::MockContext;
     use crate::mock::ics18_relayer::context::RelayerContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::get_dummy_account_id;
     use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
 
     pub struct Fixture {
         pub context: MockContext,
+        pub router: MockRouter,
         pub module_id: ModuleId,
         pub client_height: Height,
         pub host_height: Height,
@@ -316,11 +316,13 @@ mod tests {
 
     #[fixture]
     fn fixture() -> Fixture {
-        let mut context = MockContext::default();
+        let context = MockContext::default();
 
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let module = DummyTransferModule::new();
-        context.add_route(module_id.clone(), module).unwrap();
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let host_height = context.query_latest_height().unwrap().increment();
 
@@ -357,6 +359,7 @@ mod tests {
 
         Fixture {
             context,
+            router,
             module_id,
             client_height,
             host_height,
@@ -483,6 +486,7 @@ mod tests {
     fn recv_packet_execute_happy_path(fixture: Fixture) {
         let Fixture {
             context,
+            mut router,
             module_id,
             msg,
             conn_end_on_b,
@@ -495,7 +499,8 @@ mod tests {
             .with_connection(ConnectionId::default(), conn_end_on_b)
             .with_channel(PortId::default(), ChannelId::default(), chan_end_on_b);
 
-        let res = recv_packet_execute(&mut ctx, module_id, msg);
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = recv_packet_execute(&mut ctx, module, msg);
 
         assert!(res.is_ok());
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index 8a142d9fc..1f61da24c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -19,7 +19,7 @@ use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
     ChannelEndPath, ClientConsensusStatePath, CommitmentPath, ReceiptPath, SeqRecvPath,
 };
-use crate::core::router::ModuleId;
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) enum TimeoutMsgType {
@@ -29,7 +29,7 @@ pub(crate) enum TimeoutMsgType {
 
 pub(crate) fn timeout_packet_validate<ValCtx>(
     ctx_a: &ValCtx,
-    module_id: ModuleId,
+    module: &dyn Module,
     timeout_msg_type: TimeoutMsgType,
 ) -> Result<(), ContextError>
 where
@@ -40,10 +40,6 @@ where
         TimeoutMsgType::TimeoutOnClose(msg) => timeout_on_close::validate(ctx_a, msg),
     }?;
 
-    let module = ctx_a
-        .get_route(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let (packet, signer) = match timeout_msg_type {
         TimeoutMsgType::Timeout(msg) => (msg.packet, msg.signer),
         TimeoutMsgType::TimeoutOnClose(msg) => (msg.packet, msg.signer),
@@ -56,7 +52,7 @@ where
 
 pub(crate) fn timeout_packet_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
-    module_id: ModuleId,
+    module: &mut dyn Module,
     timeout_msg_type: TimeoutMsgType,
 ) -> Result<(), ContextError>
 where
@@ -86,10 +82,6 @@ where
         return Ok(());
     };
 
-    let module = ctx_a
-        .get_route_mut(&module_id)
-        .ok_or(ChannelError::RouteNotFound)?;
-
     let (extras, cb_result) = module.on_timeout_packet_execute(&packet, &signer);
 
     cb_result?;
@@ -288,15 +280,19 @@ mod tests {
     use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+    use crate::core::router::ModuleId;
+    use crate::core::router::Router;
     use crate::core::timestamp::Timestamp;
     use crate::core::timestamp::ZERO_DURATION;
 
     use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::context::MockContext;
+    use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
     struct Fixture {
         ctx: MockContext,
+        pub router: MockRouter,
         client_height: Height,
         module_id: ModuleId,
         msg: MsgTimeout,
@@ -309,13 +305,15 @@ mod tests {
     #[fixture]
     fn fixture() -> Fixture {
         let client_height = Height::new(0, 2).unwrap();
-        let mut ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+        let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
 
         let client_height = Height::new(0, 2).unwrap();
 
         let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let module = DummyTransferModule::new();
-        ctx.add_route(module_id.clone(), module).unwrap();
+        let mut router = MockRouter::default();
+        router
+            .add_route(module_id.clone(), DummyTransferModule::new())
+            .unwrap();
 
         let msg_proof_height = 2;
         let msg_timeout_height = 5;
@@ -363,6 +361,7 @@ mod tests {
 
         Fixture {
             ctx,
+            router,
             client_height,
             module_id,
             msg,
@@ -608,6 +607,7 @@ mod tests {
     fn timeout_unordered_chan_execute(fixture: Fixture) {
         let Fixture {
             ctx,
+            mut router,
             module_id,
             msg,
             packet_commitment,
@@ -629,7 +629,8 @@ mod tests {
                 packet_commitment,
             );
 
-        let res = timeout_packet_execute(&mut ctx, module_id, TimeoutMsgType::Timeout(msg));
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = timeout_packet_execute(&mut ctx, module, TimeoutMsgType::Timeout(msg));
 
         assert!(res.is_ok());
 
@@ -646,6 +647,7 @@ mod tests {
     fn timeout_ordered_chan_execute(fixture: Fixture) {
         let Fixture {
             ctx,
+            mut router,
             module_id,
             msg,
             packet_commitment,
@@ -667,7 +669,8 @@ mod tests {
                 packet_commitment,
             );
 
-        let res = timeout_packet_execute(&mut ctx, module_id, TimeoutMsgType::Timeout(msg));
+        let module = router.get_route_mut(&module_id).unwrap();
+        let res = timeout_packet_execute(&mut ctx, module, TimeoutMsgType::Timeout(msg));
 
         assert!(res.is_ok());
 
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 04e49752a..c6f34e122 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -44,7 +44,6 @@ use crate::core::ics04_channel::packet::{Receipt, Sequence};
 use crate::core::ics23_commitment::commitment::CommitmentPrefix;
 use crate::core::ics24_host::identifier::{ChainId, ChannelId, ClientId, ConnectionId, PortId};
 use crate::core::router::Router;
-use crate::core::router::{Module, ModuleId};
 use crate::core::timestamp::Timestamp;
 use crate::core::{ContextError, ValidationContext};
 use crate::core::{ExecutionContext, MsgEnvelope};
@@ -188,9 +187,6 @@ pub struct MockIbcStore {
 
     pub packet_acknowledgement: PortChannelIdMap<BTreeMap<Sequence, AcknowledgementCommitment>>,
 
-    /// Maps ports to the the module that owns it
-    pub port_to_module: BTreeMap<PortId, ModuleId>,
-
     /// Constant-size commitments to packets data fields
     pub packet_commitment: PortChannelIdMap<BTreeMap<Sequence, PacketCommitment>>,
 
@@ -220,9 +216,6 @@ pub struct MockContext {
     /// An object that stores all IBC related data.
     pub ibc_store: Arc<Mutex<MockIbcStore>>,
 
-    /// To implement ValidationContext Router
-    router: BTreeMap<ModuleId, Arc<dyn Module>>,
-
     pub events: Vec<IbcEvent>,
 
     pub logs: Vec<String>,
@@ -258,7 +251,6 @@ impl Clone for MockContext {
             history: self.history.clone(),
             block_time: self.block_time,
             ibc_store,
-            router: self.router.clone(),
             events: self.events.clone(),
             logs: self.logs.clone(),
         }
@@ -321,7 +313,6 @@ impl MockContext {
                 .collect(),
             block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-            router: BTreeMap::new(),
             events: Vec::new(),
             logs: Vec::new(),
         }
@@ -608,17 +599,6 @@ impl MockContext {
         self
     }
 
-    pub fn add_route(
-        &mut self,
-        module_id: ModuleId,
-        module: impl Module + 'static,
-    ) -> Result<(), String> {
-        match self.router.insert(module_id, Arc::new(module)) {
-            None => Ok(()),
-            Some(_) => Err("Duplicate module_id".to_owned()),
-        }
-    }
-
     /// Accessor for a block of the local (host) chain from this context.
     /// Returns `None` if the block at the requested height does not exist.
     pub fn host_block(&self, target_height: &Height) -> Option<&HostBlock> {
@@ -660,8 +640,12 @@ impl MockContext {
     /// A datagram passes from the relayer to the IBC module (on host chain).
     /// Alternative method to `Ics18Context::send` that does not exercise any serialization.
     /// Used in testing the Ics18 algorithms, hence this may return a Ics18Error.
-    pub fn deliver(&mut self, msg: MsgEnvelope) -> Result<(), RelayerError> {
-        dispatch(self, msg).map_err(RelayerError::TransactionFailed)?;
+    pub fn deliver(
+        &mut self,
+        router: &mut impl Router,
+        msg: MsgEnvelope,
+    ) -> Result<(), RelayerError> {
+        dispatch(self, router, msg).map_err(RelayerError::TransactionFailed)?;
         // Create a new block.
         self.advance_host_chain_height();
         Ok(())
@@ -695,21 +679,6 @@ impl MockContext {
         Ok(())
     }
 
-    pub fn add_port(&mut self, port_id: PortId) {
-        let module_id = ModuleId::new(format!("module{port_id}"));
-        self.ibc_store
-            .lock()
-            .port_to_module
-            .insert(port_id, module_id);
-    }
-
-    pub fn scope_port_to_module(&mut self, port_id: PortId, module_id: ModuleId) {
-        self.ibc_store
-            .lock()
-            .port_to_module
-            .insert(port_id, module_id);
-    }
-
     pub fn latest_client_states(&self, client_id: &ClientId) -> AnyClientState {
         self.ibc_store.lock().clients[client_id]
             .client_state
@@ -766,31 +735,6 @@ impl RelayerContext for MockContext {
     }
 }
 
-impl Router for MockContext {
-    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module> {
-        self.router.get(module_id).map(Arc::as_ref)
-    }
-    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module> {
-        // NOTE: The following:
-
-        // self.router.get_mut(module_id).and_then(Arc::get_mut)
-
-        // doesn't work due to a compiler bug. So we expand it out manually.
-
-        match self.router.get_mut(module_id) {
-            Some(arc_mod) => match Arc::get_mut(arc_mod) {
-                Some(m) => Some(m),
-                None => None,
-            },
-            None => None,
-        }
-    }
-
-    fn lookup_module_by_port(&self, port_id: &PortId) -> Option<ModuleId> {
-        self.ibc_store.lock().port_to_module.get(port_id).cloned()
-    }
-}
-
 impl ValidationContext for MockContext {
     type ClientValidationContext = Self;
     type E = Self;
@@ -1383,6 +1327,7 @@ mod tests {
     use crate::core::router::{Module, ModuleExtras, ModuleId};
     use crate::mock::context::MockContext;
     use crate::mock::host::HostType;
+    use crate::mock::router::MockRouter;
     use crate::signer::Signer;
     use crate::test_utils::get_dummy_bech32_account;
     use crate::Height;
@@ -1733,20 +1678,17 @@ mod tests {
             }
         }
 
-        let mut ctx = MockContext::new(
-            ChainId::new("mockgaia", 1).unwrap(),
-            HostType::Mock,
-            1,
-            Height::new(1, 1).expect("Never fails"),
-        );
-        ctx.add_route(ModuleId::new("foomodule".to_string()), FooModule::default())
+        let mut router = MockRouter::default();
+        router
+            .add_route(ModuleId::new("foomodule".to_string()), FooModule::default())
             .expect("Never fails");
-        ctx.add_route(ModuleId::new("barmodule".to_string()), BarModule)
+        router
+            .add_route(ModuleId::new("barmodule".to_string()), BarModule)
             .expect("Never fails");
 
         let mut on_recv_packet_result = |module_id: &'static str| {
             let module_id = ModuleId::new(module_id.to_string());
-            let m = ctx.get_route_mut(&module_id).expect("Never fails");
+            let m = router.get_route_mut(&module_id).expect("Never fails");
             let result =
                 m.on_recv_packet_execute(&Packet::default(), &get_dummy_bech32_account().into());
             (module_id, result)
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc/src/mock/ics18_relayer/context.rs
index 3b569eff1..73b9b3f3b 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc/src/mock/ics18_relayer/context.rs
@@ -36,6 +36,7 @@ mod tests {
     use crate::mock::host::{HostBlock, HostType};
     use crate::mock::ics18_relayer::context::RelayerContext;
     use crate::mock::ics18_relayer::error::RelayerError;
+    use crate::mock::router::MockRouter;
     use crate::prelude::*;
     use crate::Height;
 
@@ -113,6 +114,9 @@ mod tests {
                     Some(tm_client_type()), // The target host chain (B) is synthetic TM.
                     Some(client_on_a_for_b_height),
                 );
+        // dummy; not actually used in client updates
+        let mut router_a = MockRouter::default();
+
         let mut ctx_b = MockContext::new(
             chain_id_b,
             HostType::SyntheticTendermint,
@@ -126,6 +130,8 @@ mod tests {
             Some(mock_client_type()), // The target host chain is mock.
             Some(client_on_b_for_a_height),
         );
+        // dummy; not actually used in client updates
+        let mut router_b = MockRouter::default();
 
         for _i in 0..num_iterations {
             // Update client on chain B to latest height of A.
@@ -143,7 +149,7 @@ mod tests {
 
             // - send the message to B. We bypass ICS18 interface and call directly into
             // MockContext `recv` method (to avoid additional serialization steps).
-            let dispatch_res_b = ctx_b.deliver(MsgEnvelope::Client(client_msg_b));
+            let dispatch_res_b = ctx_b.deliver(&mut router_b, MsgEnvelope::Client(client_msg_b));
             let validation_res = ctx_b.validate();
             assert!(
                 validation_res.is_ok(),
@@ -182,7 +188,7 @@ mod tests {
             debug!("client_msg_a = {:?}", client_msg_a);
 
             // - send the message to A
-            let dispatch_res_a = ctx_a.deliver(MsgEnvelope::Client(client_msg_a));
+            let dispatch_res_a = ctx_a.deliver(&mut router_a, MsgEnvelope::Client(client_msg_a));
             let validation_res = ctx_a.validate();
             assert!(
                 validation_res.is_ok(),
diff --git a/crates/ibc/src/mock/mod.rs b/crates/ibc/src/mock/mod.rs
index 8547ce3fe..a2450b5a2 100644
--- a/crates/ibc/src/mock/mod.rs
+++ b/crates/ibc/src/mock/mod.rs
@@ -14,3 +14,5 @@ pub mod host;
 pub mod ics18_relayer;
 #[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
 pub mod misbehaviour;
+#[cfg(any(test, feature = "mocks"))]
+pub mod router;
diff --git a/crates/ibc/src/mock/router.rs b/crates/ibc/src/mock/router.rs
new file mode 100644
index 000000000..8433fc9f2
--- /dev/null
+++ b/crates/ibc/src/mock/router.rs
@@ -0,0 +1,54 @@
+use crate::{core::ics24_host::identifier::PortId, prelude::*};
+use alloc::{collections::BTreeMap, sync::Arc};
+
+use crate::core::router::{Module, ModuleId, Router};
+
+#[derive(Default)]
+pub struct MockRouter {
+    router: BTreeMap<ModuleId, Arc<dyn Module>>,
+
+    /// Maps ports to the the module that owns it
+    pub port_to_module: BTreeMap<PortId, ModuleId>,
+}
+
+impl MockRouter {
+    pub fn add_route(
+        &mut self,
+        module_id: ModuleId,
+        module: impl Module + 'static,
+    ) -> Result<(), String> {
+        match self.router.insert(module_id, Arc::new(module)) {
+            None => Ok(()),
+            Some(_) => Err("Duplicate module_id".to_owned()),
+        }
+    }
+
+    pub fn scope_port_to_module(&mut self, port_id: PortId, module_id: ModuleId) {
+        self.port_to_module.insert(port_id, module_id);
+    }
+}
+
+impl Router for MockRouter {
+    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module> {
+        self.router.get(module_id).map(Arc::as_ref)
+    }
+    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module> {
+        // NOTE: The following:
+
+        // self.router.get_mut(module_id).and_then(Arc::get_mut)
+
+        // doesn't work due to a compiler bug. So we expand it out manually.
+
+        match self.router.get_mut(module_id) {
+            Some(arc_mod) => match Arc::get_mut(arc_mod) {
+                Some(m) => Some(m),
+                None => None,
+            },
+            None => None,
+        }
+    }
+
+    fn lookup_module_by_port(&self, port_id: &PortId) -> Option<ModuleId> {
+        self.port_to_module.get(port_id).cloned()
+    }
+}

From e0f256892b1daf0d7e77dd2c745ba082bea9e275 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 3 Aug 2023 12:13:12 -0700
Subject: [PATCH 011/182] imp(Router)!: simplify `Module` lookup (#806)

* imp(router): simplify Module lookup

* fix: clippy catches

* imp: discard ModuleId and use PortId::transfer everywhere instead

* Revert "imp: discard ModuleId and use PortId::transfer everywhere instead"

This reverts commit 9227ef7557aa8437b4eec5dc6fd1311fa1af0333.

* nit: RouterError variants

* fix: cargo test
---
 .../802-simplify-module-lookup.md             |  2 +
 crates/ibc/src/core/context.rs                |  7 ++-
 crates/ibc/src/core/handler.rs                | 43 ++++++++++++-------
 crates/ibc/src/core/ics04_channel/error.rs    | 16 -------
 crates/ibc/src/core/ics04_channel/msgs.rs     | 22 ++++++++++
 crates/ibc/src/core/router.rs                 | 37 +---------------
 crates/ibc/src/mock/router.rs                 |  2 +-
 7 files changed, 60 insertions(+), 69 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/802-simplify-module-lookup.md

diff --git a/.changelog/unreleased/breaking-changes/802-simplify-module-lookup.md b/.changelog/unreleased/breaking-changes/802-simplify-module-lookup.md
new file mode 100644
index 000000000..68dc850cc
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/802-simplify-module-lookup.md
@@ -0,0 +1,2 @@
+- Simplify Module lookup in the `Router` trait
+ ([#802](https://github.com/cosmos/ibc-rs/issues/802))
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index 67420200a..b74437af1 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -33,6 +33,7 @@ use crate::Height;
 use super::ics02_client::client_state::ClientState;
 use super::ics02_client::consensus_state::ConsensusState;
 use super::ics02_client::ClientExecutionContext;
+use super::ics24_host::identifier::PortId;
 
 /// Top-level error
 #[derive(Debug, Display, From)]
@@ -69,6 +70,10 @@ pub enum RouterError {
     UnknownMessageTypeUrl { url: String },
     /// the message is malformed and cannot be decoded error: `{0}`
     MalformedMessageBytes(ibc_proto::protobuf::Error),
+    /// port `{port_id}` is unknown
+    UnknownPort { port_id: PortId },
+    /// module not found
+    ModuleNotFound,
 }
 
 impl From<ContextError> for RouterError {
@@ -82,8 +87,8 @@ impl std::error::Error for RouterError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             Self::ContextError(e) => Some(e),
-            Self::UnknownMessageTypeUrl { .. } => None,
             Self::MalformedMessageBytes(e) => Some(e),
+            _ => None,
         }
     }
 }
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 8bd035848..1a7530e73 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -5,7 +5,6 @@ use super::ics03_connection::handler::{
     conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try,
 };
 use super::ics03_connection::msgs::ConnectionMsg;
-use super::ics04_channel::error::ChannelError;
 use super::ics04_channel::handler::acknowledgement::{
     acknowledgement_packet_execute, acknowledgement_packet_validate,
 };
@@ -27,10 +26,12 @@ use super::ics04_channel::handler::recv_packet::{recv_packet_execute, recv_packe
 use super::ics04_channel::handler::timeout::{
     timeout_packet_execute, timeout_packet_validate, TimeoutMsgType,
 };
-use super::ics04_channel::msgs::{ChannelMsg, PacketMsg};
+use super::ics04_channel::msgs::{
+    channel_msg_to_port_id, packet_msg_to_port_id, ChannelMsg, PacketMsg,
+};
 use super::msgs::MsgEnvelope;
 use super::router::Router;
-use super::{ContextError, ExecutionContext, ValidationContext};
+use super::{ExecutionContext, ValidationContext};
 
 /// Entrypoint which performs both validation and message execution
 pub fn dispatch(
@@ -78,12 +79,15 @@ where
         }
         .map_err(RouterError::ContextError),
         MsgEnvelope::Channel(msg) => {
+            let port_id = channel_msg_to_port_id(&msg);
             let module_id = router
-                .lookup_module_channel(&msg)
-                .map_err(ContextError::from)?;
+                .lookup_module(port_id)
+                .ok_or(RouterError::UnknownPort {
+                    port_id: port_id.clone(),
+                })?;
             let module = router
                 .get_route(&module_id)
-                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
+                .ok_or(RouterError::ModuleNotFound)?;
 
             match msg {
                 ChannelMsg::OpenInit(msg) => chan_open_init_validate(ctx, module, msg),
@@ -96,12 +100,15 @@ where
             .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
+            let port_id = packet_msg_to_port_id(&msg);
             let module_id = router
-                .lookup_module_packet(&msg)
-                .map_err(ContextError::from)?;
+                .lookup_module(port_id)
+                .ok_or(RouterError::UnknownPort {
+                    port_id: port_id.clone(),
+                })?;
             let module = router
                 .get_route(&module_id)
-                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
+                .ok_or(RouterError::ModuleNotFound)?;
 
             match msg {
                 PacketMsg::Recv(msg) => recv_packet_validate(ctx, msg),
@@ -147,12 +154,15 @@ where
         }
         .map_err(RouterError::ContextError),
         MsgEnvelope::Channel(msg) => {
+            let port_id = channel_msg_to_port_id(&msg);
             let module_id = router
-                .lookup_module_channel(&msg)
-                .map_err(ContextError::from)?;
+                .lookup_module(port_id)
+                .ok_or(RouterError::UnknownPort {
+                    port_id: port_id.clone(),
+                })?;
             let module = router
                 .get_route_mut(&module_id)
-                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
+                .ok_or(RouterError::ModuleNotFound)?;
 
             match msg {
                 ChannelMsg::OpenInit(msg) => chan_open_init_execute(ctx, module, msg),
@@ -165,12 +175,15 @@ where
             .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
+            let port_id = packet_msg_to_port_id(&msg);
             let module_id = router
-                .lookup_module_packet(&msg)
-                .map_err(ContextError::from)?;
+                .lookup_module(port_id)
+                .ok_or(RouterError::UnknownPort {
+                    port_id: port_id.clone(),
+                })?;
             let module = router
                 .get_route_mut(&module_id)
-                .ok_or(ContextError::from(ChannelError::RouteNotFound))?;
+                .ok_or(RouterError::ModuleNotFound)?;
 
             match msg {
                 PacketMsg::Recv(msg) => recv_packet_execute(ctx, module, msg),
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index 905e37722..d8a98a2a7 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -16,21 +16,8 @@ use crate::Height;
 
 use displaydoc::Display;
 
-#[derive(Debug, Display)]
-pub enum PortError {
-    /// port `{port_id}` is unknown
-    UnknownPort { port_id: PortId },
-    /// implementation specific error
-    ImplementationSpecific,
-}
-
-#[cfg(feature = "std")]
-impl std::error::Error for PortError {}
-
 #[derive(Debug, Display)]
 pub enum ChannelError {
-    /// port error: `{0}`
-    Port(PortError),
     /// invalid channel end: `{channel_end}`
     InvalidChannelEnd { channel_end: String },
     /// invalid channel id: expected `{expected}`, actual `{actual}`
@@ -79,8 +66,6 @@ pub enum ChannelError {
     ProcessedTimeNotFound { client_id: ClientId, height: Height },
     /// Processed height for the client `{client_id}` at height `{height}` not found
     ProcessedHeightNotFound { client_id: ClientId, height: Height },
-    /// route not found
-    RouteNotFound,
     /// application module error: `{description}`
     AppModule { description: String },
     /// other error: `{description}`
@@ -216,7 +201,6 @@ impl std::error::Error for PacketError {
 impl std::error::Error for ChannelError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            Self::Port(e) => Some(e),
             Self::InvalidIdentifier(e) => Some(e),
             Self::PacketVerificationFailed {
                 client_error: e, ..
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index fdffdeeda..fad6922d3 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -28,6 +28,8 @@ pub use recv_packet::MsgRecvPacket;
 pub use timeout::MsgTimeout;
 pub use timeout_on_close::MsgTimeoutOnClose;
 
+use crate::core::ics24_host::identifier::PortId;
+
 /// All channel messages
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ChannelMsg {
@@ -47,3 +49,23 @@ pub enum PacketMsg {
     Timeout(MsgTimeout),
     TimeoutOnClose(MsgTimeoutOnClose),
 }
+
+pub(crate) fn channel_msg_to_port_id(msg: &ChannelMsg) -> &PortId {
+    match msg {
+        ChannelMsg::OpenInit(msg) => &msg.port_id_on_a,
+        ChannelMsg::OpenTry(msg) => &msg.port_id_on_b,
+        ChannelMsg::OpenAck(msg) => &msg.port_id_on_a,
+        ChannelMsg::OpenConfirm(msg) => &msg.port_id_on_b,
+        ChannelMsg::CloseInit(msg) => &msg.port_id_on_a,
+        ChannelMsg::CloseConfirm(msg) => &msg.port_id_on_b,
+    }
+}
+
+pub(crate) fn packet_msg_to_port_id(msg: &PacketMsg) -> &PortId {
+    match msg {
+        PacketMsg::Recv(msg) => &msg.packet.port_id_on_b,
+        PacketMsg::Ack(msg) => &msg.packet.port_id_on_a,
+        PacketMsg::Timeout(msg) => &msg.packet.port_id_on_a,
+        PacketMsg::TimeoutOnClose(msg) => &msg.packet.port_id_on_a,
+    }
+}
diff --git a/crates/ibc/src/core/router.rs b/crates/ibc/src/core/router.rs
index 34421ae38..81adbf99d 100644
--- a/crates/ibc/src/core/router.rs
+++ b/crates/ibc/src/core/router.rs
@@ -7,10 +7,7 @@ use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use crate::core::events::ModuleEvent;
 use crate::core::ics04_channel::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::channel::{Counterparty, Order};
-use crate::core::ics04_channel::error::PortError::UnknownPort;
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::msgs::ChannelMsg;
-use crate::core::ics04_channel::msgs::PacketMsg;
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics04_channel::Version;
 use crate::core::ics24_host::identifier::PortId;
@@ -26,39 +23,7 @@ pub trait Router {
     fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module>;
 
     /// Return the module_id associated with a given port_id
-    fn lookup_module_by_port(&self, port_id: &PortId) -> Option<ModuleId>;
-
-    fn lookup_module_channel(&self, msg: &ChannelMsg) -> Result<ModuleId, ChannelError> {
-        let port_id = match msg {
-            ChannelMsg::OpenInit(msg) => &msg.port_id_on_a,
-            ChannelMsg::OpenTry(msg) => &msg.port_id_on_b,
-            ChannelMsg::OpenAck(msg) => &msg.port_id_on_a,
-            ChannelMsg::OpenConfirm(msg) => &msg.port_id_on_b,
-            ChannelMsg::CloseInit(msg) => &msg.port_id_on_a,
-            ChannelMsg::CloseConfirm(msg) => &msg.port_id_on_b,
-        };
-        let module_id = self
-            .lookup_module_by_port(port_id)
-            .ok_or(ChannelError::Port(UnknownPort {
-                port_id: port_id.clone(),
-            }))?;
-        Ok(module_id)
-    }
-
-    fn lookup_module_packet(&self, msg: &PacketMsg) -> Result<ModuleId, ChannelError> {
-        let port_id = match msg {
-            PacketMsg::Recv(msg) => &msg.packet.port_id_on_b,
-            PacketMsg::Ack(msg) => &msg.packet.port_id_on_a,
-            PacketMsg::Timeout(msg) => &msg.packet.port_id_on_a,
-            PacketMsg::TimeoutOnClose(msg) => &msg.packet.port_id_on_a,
-        };
-        let module_id = self
-            .lookup_module_by_port(port_id)
-            .ok_or(ChannelError::Port(UnknownPort {
-                port_id: port_id.clone(),
-            }))?;
-        Ok(module_id)
-    }
+    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId>;
 }
 
 /// Module name, internal to the chain.
diff --git a/crates/ibc/src/mock/router.rs b/crates/ibc/src/mock/router.rs
index 8433fc9f2..b2c4c3270 100644
--- a/crates/ibc/src/mock/router.rs
+++ b/crates/ibc/src/mock/router.rs
@@ -48,7 +48,7 @@ impl Router for MockRouter {
         }
     }
 
-    fn lookup_module_by_port(&self, port_id: &PortId) -> Option<ModuleId> {
+    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId> {
         self.port_to_module.get(port_id).cloned()
     }
 }

From 79cb166e2d0fd3cb69621574b2590975cff79d0d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Fri, 4 Aug 2023 10:01:01 -0400
Subject: [PATCH 012/182] Decouple `TokenTransfer*` and `SendPacket*` (#787)

* modify traits and send_transfer

* fix mocks

* changelog

* Remove MockTokenTransferModule

* remove ctx from get_defaults
---
 .../786-decouple-token-sendpacket.md          |  2 +
 .../ibc/src/applications/transfer/context.rs  | 16 ++--
 .../transfer/relay/send_transfer.rs           | 69 ++++++++------
 crates/ibc/src/core/handler.rs                |  2 +-
 crates/ibc/src/mock/context.rs                |  1 -
 crates/ibc/src/mock/context/applications.rs   | 89 -------------------
 crates/ibc/src/test_utils.rs                  | 83 +++++++++++++++++
 7 files changed, 134 insertions(+), 128 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md
 delete mode 100644 crates/ibc/src/mock/context/applications.rs

diff --git a/.changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md b/.changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md
new file mode 100644
index 000000000..9441d8582
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md
@@ -0,0 +1,2 @@
+- Decouple TokenTransfer{Validation,Execution} from SendPacket{Validation,Execution}
+  ([#786](https://github.com/cosmos/ibc-rs/issues/786))
diff --git a/crates/ibc/src/applications/transfer/context.rs b/crates/ibc/src/applications/transfer/context.rs
index 16f0d50ab..6b3b25880 100644
--- a/crates/ibc/src/applications/transfer/context.rs
+++ b/crates/ibc/src/applications/transfer/context.rs
@@ -15,9 +15,6 @@ use crate::applications::transfer::{PrefixedCoin, PrefixedDenom, VERSION};
 use crate::core::ics04_channel::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::acknowledgement::AcknowledgementStatus;
 use crate::core::ics04_channel::channel::{Counterparty, Order};
-use crate::core::ics04_channel::context::{
-    SendPacketExecutionContext, SendPacketValidationContext,
-};
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics04_channel::Version;
 use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
@@ -26,7 +23,7 @@ use crate::core::ContextError;
 use crate::signer::Signer;
 
 /// Methods required in token transfer validation, to be implemented by the host
-pub trait TokenTransferValidationContext: SendPacketValidationContext {
+pub trait TokenTransferValidationContext {
     type AccountId: TryFrom<Signer>;
 
     /// get_port returns the portID for the transfer module.
@@ -75,9 +72,7 @@ pub trait TokenTransferValidationContext: SendPacketValidationContext {
 }
 
 /// Methods required in token transfer execution, to be implemented by the host
-pub trait TokenTransferExecutionContext:
-    TokenTransferValidationContext + SendPacketExecutionContext
-{
+pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
     /// This function should enable sending ibc fungible tokens from one account to another
     fn send_coins_execute(
         &mut self,
@@ -426,17 +421,16 @@ pub(crate) mod test {
     use crate::core::ics04_channel::channel::{Counterparty, Order};
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-    use crate::mock::context::MockContext;
+    use crate::test_utils::DummyTransferModule;
 
     fn get_defaults() -> (
-        MockContext,
+        DummyTransferModule,
         Order,
         Vec<ConnectionId>,
         PortId,
         ChannelId,
         Counterparty,
     ) {
-        let ctx = MockContext::default();
         let order = Order::Unordered;
         let connection_hops = vec![ConnectionId::new(1)];
         let port_id = PortId::transfer();
@@ -444,7 +438,7 @@ pub(crate) mod test {
         let counterparty = Counterparty::new(port_id.clone(), Some(channel_id.clone()));
 
         (
-            ctx,
+            DummyTransferModule,
             order,
             connection_hops,
             port_id,
diff --git a/crates/ibc/src/applications/transfer/relay/send_transfer.rs b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
index 20a2c6c7c..7fba81117 100644
--- a/crates/ibc/src/applications/transfer/relay/send_transfer.rs
+++ b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
@@ -6,29 +6,42 @@ use crate::applications::transfer::events::TransferEvent;
 use crate::applications::transfer::msgs::transfer::MsgTransfer;
 use crate::applications::transfer::{is_sender_chain_source, MODULE_ID_STR};
 use crate::core::events::{MessageEvent, ModuleEvent};
+use crate::core::ics04_channel::context::{
+    SendPacketExecutionContext, SendPacketValidationContext,
+};
 use crate::core::ics04_channel::handler::send_packet::{send_packet_execute, send_packet_validate};
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics24_host::path::{ChannelEndPath, SeqSendPath};
 use crate::prelude::*;
 
 /// Initiate a token transfer. Equivalent to calling [`send_transfer_validate`], followed by [`send_transfer_execute`].
-pub fn send_transfer<Ctx>(ctx_a: &mut Ctx, msg: MsgTransfer) -> Result<(), TokenTransferError>
+pub fn send_transfer<SendPacketCtx, TokenCtx>(
+    send_packet_ctx_a: &mut SendPacketCtx,
+    token_ctx_a: &mut TokenCtx,
+    msg: MsgTransfer,
+) -> Result<(), TokenTransferError>
 where
-    Ctx: TokenTransferExecutionContext,
+    SendPacketCtx: SendPacketExecutionContext,
+    TokenCtx: TokenTransferExecutionContext,
 {
-    send_transfer_validate(ctx_a, msg.clone())?;
-    send_transfer_execute(ctx_a, msg)
+    send_transfer_validate(send_packet_ctx_a, token_ctx_a, msg.clone())?;
+    send_transfer_execute(send_packet_ctx_a, token_ctx_a, msg)
 }
 
 /// Validates the token tranfer. If this succeeds, then it is legal to initiate the transfer with [`send_transfer_execute`].
-pub fn send_transfer_validate<Ctx>(ctx_a: &Ctx, msg: MsgTransfer) -> Result<(), TokenTransferError>
+pub fn send_transfer_validate<SendPacketCtx, TokenCtx>(
+    send_packet_ctx_a: &SendPacketCtx,
+    token_ctx_a: &TokenCtx,
+    msg: MsgTransfer,
+) -> Result<(), TokenTransferError>
 where
-    Ctx: TokenTransferValidationContext,
+    SendPacketCtx: SendPacketValidationContext,
+    TokenCtx: TokenTransferValidationContext,
 {
-    ctx_a.can_send_coins()?;
+    token_ctx_a.can_send_coins()?;
 
     let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
-    let chan_end_on_a = ctx_a.channel_end(&chan_end_path_on_a)?;
+    let chan_end_on_a = send_packet_ctx_a.channel_end(&chan_end_path_on_a)?;
 
     let port_id_on_b = chan_end_on_a.counterparty().port_id().clone();
     let chan_id_on_b = chan_end_on_a
@@ -41,11 +54,11 @@ where
         .clone();
 
     let seq_send_path_on_a = SeqSendPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
-    let sequence = ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
+    let sequence = send_packet_ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
 
     let token = &msg.packet_data.token;
 
-    let sender: Ctx::AccountId = msg
+    let sender: TokenCtx::AccountId = msg
         .packet_data
         .sender
         .clone()
@@ -57,10 +70,11 @@ where
         msg.chan_id_on_a.clone(),
         &token.denom,
     ) {
-        let escrow_address = ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
-        ctx_a.send_coins_validate(&sender, &escrow_address, token)?;
+        let escrow_address =
+            token_ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
+        token_ctx_a.send_coins_validate(&sender, &escrow_address, token)?;
     } else {
-        ctx_a.burn_coins_validate(&sender, token)?;
+        token_ctx_a.burn_coins_validate(&sender, token)?;
     }
 
     let packet = {
@@ -79,21 +93,23 @@ where
         }
     };
 
-    send_packet_validate(ctx_a, &packet)?;
+    send_packet_validate(send_packet_ctx_a, &packet)?;
 
     Ok(())
 }
 
 /// Executes the token transfer. A prior call to [`send_transfer_validate`] MUST have succeeded.
-pub fn send_transfer_execute<Ctx>(
-    ctx_a: &mut Ctx,
+pub fn send_transfer_execute<SendPacketCtx, TokenCtx>(
+    send_packet_ctx_a: &mut SendPacketCtx,
+    token_ctx_a: &mut TokenCtx,
     msg: MsgTransfer,
 ) -> Result<(), TokenTransferError>
 where
-    Ctx: TokenTransferExecutionContext,
+    SendPacketCtx: SendPacketExecutionContext,
+    TokenCtx: TokenTransferExecutionContext,
 {
     let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
-    let chan_end_on_a = ctx_a.channel_end(&chan_end_path_on_a)?;
+    let chan_end_on_a = send_packet_ctx_a.channel_end(&chan_end_path_on_a)?;
 
     let port_on_b = chan_end_on_a.counterparty().port_id().clone();
     let chan_on_b = chan_end_on_a
@@ -107,7 +123,7 @@ where
 
     // get the next sequence
     let seq_send_path_on_a = SeqSendPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
-    let sequence = ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
+    let sequence = send_packet_ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
 
     let token = &msg.packet_data.token;
 
@@ -123,10 +139,11 @@ where
         msg.chan_id_on_a.clone(),
         &token.denom,
     ) {
-        let escrow_address = ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
-        ctx_a.send_coins_execute(&sender, &escrow_address, token)?;
+        let escrow_address =
+            token_ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
+        token_ctx_a.send_coins_execute(&sender, &escrow_address, token)?;
     } else {
-        ctx_a.burn_coins_execute(&sender, token)?;
+        token_ctx_a.burn_coins_execute(&sender, token)?;
     }
 
     let packet = {
@@ -147,10 +164,10 @@ where
         }
     };
 
-    send_packet_execute(ctx_a, packet)?;
+    send_packet_execute(send_packet_ctx_a, packet)?;
 
     {
-        ctx_a.log_message(format!(
+        send_packet_ctx_a.log_message(format!(
             "IBC fungible token transfer: {} --({})--> {}",
             msg.packet_data.sender, token, msg.packet_data.receiver
         ));
@@ -162,9 +179,9 @@ where
             denom: msg.packet_data.token.denom,
             memo: msg.packet_data.memo,
         };
-        ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into());
+        send_packet_ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into());
 
-        ctx_a.emit_ibc_event(MessageEvent::Module(MODULE_ID_STR.to_string()).into());
+        send_packet_ctx_a.emit_ibc_event(MessageEvent::Module(MODULE_ID_STR.to_string()).into());
     }
 
     Ok(())
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 1a7530e73..027723b90 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -621,7 +621,7 @@ mod tests {
         for test in tests {
             let res = match test.msg.clone() {
                 TestMsg::Ics26(msg) => dispatch(&mut ctx, &mut router, msg).map(|_| ()),
-                TestMsg::Ics20(msg) => send_transfer(&mut ctx, msg)
+                TestMsg::Ics20(msg) => send_transfer(&mut ctx, &mut DummyTransferModule, msg)
                     .map_err(|e: TokenTransferError| ChannelError::AppModule {
                         description: e.to_string(),
                     })
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index c6f34e122..18e996eaf 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -1,6 +1,5 @@
 //! Implementation of a global context mock. Used in testing handlers of all IBC modules.
 
-mod applications;
 mod clients;
 
 use crate::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
diff --git a/crates/ibc/src/mock/context/applications.rs b/crates/ibc/src/mock/context/applications.rs
deleted file mode 100644
index 219604de0..000000000
--- a/crates/ibc/src/mock/context/applications.rs
+++ /dev/null
@@ -1,89 +0,0 @@
-//! Application context implementations for `MockContext`
-
-use subtle_encoding::bech32;
-
-use super::MockContext;
-use crate::applications::transfer::context::cosmos_adr028_escrow_address;
-use crate::applications::transfer::context::TokenTransferExecutionContext;
-use crate::applications::transfer::context::TokenTransferValidationContext;
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::PrefixedCoin;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::Signer;
-
-impl TokenTransferValidationContext for MockContext {
-    type AccountId = Signer;
-
-    fn get_port(&self) -> Result<PortId, TokenTransferError> {
-        Ok(PortId::transfer())
-    }
-
-    fn get_escrow_account(
-        &self,
-        port_id: &PortId,
-        channel_id: &ChannelId,
-    ) -> Result<Self::AccountId, TokenTransferError> {
-        let addr = cosmos_adr028_escrow_address(port_id, channel_id);
-        Ok(bech32::encode("cosmos", addr).into())
-    }
-
-    fn can_send_coins(&self) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn can_receive_coins(&self) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn send_coins_validate(
-        &self,
-        _from_account: &Self::AccountId,
-        _to_account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn mint_coins_validate(
-        &self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn burn_coins_validate(
-        &self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-}
-
-impl TokenTransferExecutionContext for MockContext {
-    fn send_coins_execute(
-        &mut self,
-        _from_account: &Self::AccountId,
-        _to_account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn mint_coins_execute(
-        &mut self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn burn_coins_execute(
-        &mut self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-}
diff --git a/crates/ibc/src/test_utils.rs b/crates/ibc/src/test_utils.rs
index 6235039cc..6cc73f801 100644
--- a/crates/ibc/src/test_utils.rs
+++ b/crates/ibc/src/test_utils.rs
@@ -1,5 +1,11 @@
+use subtle_encoding::bech32;
 use tendermint::{block, consensus, evidence, public_key::Algorithm};
 
+use crate::applications::transfer::context::{
+    cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
+};
+use crate::applications::transfer::error::TokenTransferError;
+use crate::applications::transfer::PrefixedCoin;
 use crate::core::ics04_channel::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::channel::{Counterparty, Order};
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
@@ -158,3 +164,80 @@ impl Module for DummyTransferModule {
         (ModuleExtras::empty(), Ok(()))
     }
 }
+
+impl TokenTransferValidationContext for DummyTransferModule {
+    type AccountId = Signer;
+
+    fn get_port(&self) -> Result<PortId, TokenTransferError> {
+        Ok(PortId::transfer())
+    }
+
+    fn get_escrow_account(
+        &self,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+    ) -> Result<Self::AccountId, TokenTransferError> {
+        let addr = cosmos_adr028_escrow_address(port_id, channel_id);
+        Ok(bech32::encode("cosmos", addr).into())
+    }
+
+    fn can_send_coins(&self) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn can_receive_coins(&self) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn send_coins_validate(
+        &self,
+        _from_account: &Self::AccountId,
+        _to_account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn mint_coins_validate(
+        &self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn burn_coins_validate(
+        &self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+}
+
+impl TokenTransferExecutionContext for DummyTransferModule {
+    fn send_coins_execute(
+        &mut self,
+        _from_account: &Self::AccountId,
+        _to_account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn mint_coins_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn burn_coins_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+}

From c9ebc26bc86a95861f80fd565ee58aede8df9f27 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Fri, 4 Aug 2023 12:07:50 -0400
Subject: [PATCH 013/182] Implement `ClientState::status()` (#774)

* Status enum

* implement status API

* replace most confirm_not_frozen

* validate_self_client no longer uses confirm_not_frozen

* remove confirm_not_frozen

* clippy

* fix test

* remove expired()

* changelog

* Remove `Status::Unknown`

* don't consider the client expired if consensus state is in the future

* Status methods

* remove redundant check

* Remove error variant

* update changelog
---
 .../536-clientstate-status.md                 |  2 +
 .../traits/client_state_common.rs             | 22 -----
 .../traits/client_state_validation.rs         | 19 +++++
 crates/ibc-derive/src/utils.rs                |  4 +
 crates/ibc/Cargo.toml                         |  2 +-
 .../clients/ics07_tendermint/client_state.rs  | 59 ++++++++++---
 .../ibc/src/core/ics02_client/client_state.rs | 50 +++++++++--
 crates/ibc/src/core/ics02_client/error.rs     | 17 ++--
 .../ics02_client/handler/update_client.rs     | 25 ++++--
 .../ics02_client/handler/upgrade_client.rs    | 29 ++-----
 .../ics03_connection/handler/conn_open_ack.rs | 11 ++-
 .../handler/conn_open_confirm.rs              | 11 ++-
 .../handler/conn_open_init.rs                 | 12 ++-
 .../ics03_connection/handler/conn_open_try.rs | 11 ++-
 crates/ibc/src/core/ics04_channel/context.rs  |  7 ++
 .../ics04_channel/handler/acknowledgement.rs  | 11 ++-
 .../handler/chan_close_confirm.rs             | 11 ++-
 .../ics04_channel/handler/chan_close_init.rs  | 11 ++-
 .../ics04_channel/handler/chan_open_ack.rs    | 13 ++-
 .../handler/chan_open_confirm.rs              | 11 ++-
 .../ics04_channel/handler/chan_open_init.rs   | 12 ++-
 .../ics04_channel/handler/chan_open_try.rs    | 13 ++-
 .../core/ics04_channel/handler/recv_packet.rs | 11 ++-
 .../core/ics04_channel/handler/send_packet.rs | 10 ++-
 .../src/core/ics04_channel/handler/timeout.rs | 11 ++-
 .../ics04_channel/handler/timeout_on_close.rs | 11 ++-
 .../hosts/tendermint/validate_self_client.rs  |  7 +-
 crates/ibc/src/mock/client_state.rs           | 85 ++++++++++++++++---
 crates/ibc/src/mock/context.rs                |  8 +-
 crates/ibc/src/mock/context/clients.rs        | 17 ++++
 30 files changed, 399 insertions(+), 124 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/536-clientstate-status.md

diff --git a/.changelog/unreleased/breaking-changes/536-clientstate-status.md b/.changelog/unreleased/breaking-changes/536-clientstate-status.md
new file mode 100644
index 000000000..dc414758f
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/536-clientstate-status.md
@@ -0,0 +1,2 @@
+- [ibc-derive] Replace `ClientState::{confirm_not_frozen, expired}()` with `ClientState::status()`
+  ([#536](https://github.com/cosmos/ibc-rs/issues/536))
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_common.rs b/crates/ibc-derive/src/client_state/traits/client_state_common.rs
index 3c9f4f4b6..b1dc37731 100644
--- a/crates/ibc-derive/src/client_state/traits/client_state_common.rs
+++ b/crates/ibc-derive/src/client_state/traits/client_state_common.rs
@@ -32,16 +32,6 @@ pub(crate) fn impl_ClientStateCommon(
         enum_variants.iter(),
         quote! {validate_proof_height(cs, proof_height)},
     );
-    let confirm_not_frozen_impl = delegate_call_in_match(
-        client_state_enum_name,
-        enum_variants.iter(),
-        quote! {confirm_not_frozen(cs)},
-    );
-    let expired_impl = delegate_call_in_match(
-        client_state_enum_name,
-        enum_variants.iter(),
-        quote! {expired(cs, elapsed)},
-    );
     let verify_upgrade_client_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
@@ -95,18 +85,6 @@ pub(crate) fn impl_ClientStateCommon(
                 }
             }
 
-            fn confirm_not_frozen(&self) -> core::result::Result<(), #ClientError> {
-                match self {
-                    #(#confirm_not_frozen_impl),*
-                }
-            }
-
-            fn expired(&self, elapsed: core::time::Duration) -> bool {
-                match self {
-                    #(#expired_impl),*
-                }
-            }
-
             fn verify_upgrade_client(
                 &self,
                 upgraded_client_state: #Any,
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_validation.rs b/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
index 3bc90958c..38c8ba397 100644
--- a/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
+++ b/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
@@ -30,6 +30,13 @@ pub(crate) fn impl_ClientStateValidation(
         quote! { check_for_misbehaviour(cs, ctx, client_id, client_message, update_kind) },
     );
 
+    let status_impl = delegate_call_in_match(
+        client_state_enum_name,
+        enum_variants.iter(),
+        opts,
+        quote! { status(cs, ctx, client_id) },
+    );
+
     let HostClientState = client_state_enum_name;
     let ClientValidationContext = &opts.client_validation_context;
 
@@ -37,6 +44,7 @@ pub(crate) fn impl_ClientStateValidation(
     let ClientId = Imports::ClientId();
     let ClientError = Imports::ClientError();
     let ClientStateValidation = Imports::ClientStateValidation();
+    let Status = Imports::Status();
     let UpdateKind = Imports::UpdateKind();
 
     quote! {
@@ -64,6 +72,17 @@ pub(crate) fn impl_ClientStateValidation(
                     #(#check_for_misbehaviour_impl),*
                 }
             }
+
+            fn status(
+                &self,
+                ctx: &#ClientValidationContext,
+                client_id: &#ClientId,
+            ) -> core::result::Result<#Status, #ClientError> {
+                match self {
+                    #(#status_impl),*
+                }
+
+            }
         }
 
     }
diff --git a/crates/ibc-derive/src/utils.rs b/crates/ibc-derive/src/utils.rs
index 4dc30ad29..fca155424 100644
--- a/crates/ibc-derive/src/utils.rs
+++ b/crates/ibc-derive/src/utils.rs
@@ -68,6 +68,10 @@ impl Imports {
     pub fn UpdateKind() -> TokenStream {
         quote! {ibc::core::ics02_client::client_state::UpdateKind}
     }
+
+    pub fn Status() -> TokenStream {
+        quote! {ibc::core::ics02_client::client_state::Status}
+    }
 }
 
 /// Retrieves the field of a given enum variant. Outputs an error message if the enum variant
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 5fca810d1..e47745faa 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -75,7 +75,7 @@ scale-info = { version = "2.1.2", default-features = false, features = ["derive"
 borsh = {version = "0.9.0", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
 
-ibc-derive = "0.2.0"
+ibc-derive = { version ="0.2.0", path = "../ibc-derive" }
 
 schemars = { version = "0.8.12", optional = true }
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index 687811ec2..3e60b86b8 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -28,7 +28,7 @@ use crate::clients::ics07_tendermint::error::Error;
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
 use crate::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
 use crate::core::ics02_client::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation, UpdateKind,
+    ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
 };
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::consensus_state::ConsensusState;
@@ -248,6 +248,10 @@ impl ClientState {
         self.chain_id.clone()
     }
 
+    pub fn is_frozen(&self) -> bool {
+        self.frozen_height.is_some()
+    }
+
     // Resets custom fields to zero values (used in `update_client`)
     pub fn zero_custom_fields(&mut self) {
         self.trusting_period = ZERO_DURATION;
@@ -289,19 +293,6 @@ impl ClientStateCommon for ClientState {
         Ok(())
     }
 
-    fn confirm_not_frozen(&self) -> Result<(), ClientError> {
-        if let Some(frozen_height) = self.frozen_height {
-            return Err(ClientError::ClientFrozen {
-                description: format!("the client is frozen at height {frozen_height}"),
-            });
-        }
-        Ok(())
-    }
-
-    fn expired(&self, elapsed: Duration) -> bool {
-        elapsed > self.trusting_period
-    }
-
     /// Perform client-specific verifications and check all data in the new
     /// client state to be the same across all valid Tendermint clients for the
     /// new chain.
@@ -422,6 +413,9 @@ impl ClientStateCommon for ClientState {
 impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for ClientState
 where
     ClientValidationContext: TmValidationContext,
+    ClientValidationContext::AnyConsensusState: TryInto<TmConsensusState>,
+    ClientError:
+        From<<ClientValidationContext::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
 {
     fn verify_client_message(
         &self,
@@ -460,6 +454,43 @@ where
             }
         }
     }
+
+    fn status(
+        &self,
+        ctx: &ClientValidationContext,
+        client_id: &ClientId,
+    ) -> Result<Status, ClientError> {
+        if self.is_frozen() {
+            return Ok(Status::Frozen);
+        }
+
+        let latest_consensus_state: TmConsensusState = {
+            let any_latest_consensus_state = match ctx.consensus_state(
+                &ClientConsensusStatePath::new(client_id, &self.latest_height),
+            ) {
+                Ok(cs) => cs,
+                // if the client state does not have an associated consensus state for its latest height
+                // then it must be expired
+                Err(_) => return Ok(Status::Expired),
+            };
+
+            any_latest_consensus_state.try_into()?
+        };
+
+        // Note: if the `duration_since()` is `None`, indicating that the latest
+        // consensus state is in the future, then we don't consider the client
+        // to be expired.
+        let now = ctx.host_timestamp()?;
+        if let Some(elapsed_since_latest_consensus_state) =
+            now.duration_since(&latest_consensus_state.timestamp())
+        {
+            if elapsed_since_latest_consensus_state > self.trusting_period {
+                return Ok(Status::Expired);
+            }
+        }
+
+        Ok(Status::Active)
+    }
 }
 
 impl<E> ClientStateExecution<E> for ClientState
diff --git a/crates/ibc/src/core/ics02_client/client_state.rs b/crates/ibc/src/core/ics02_client/client_state.rs
index bc79de426..441e97b2b 100644
--- a/crates/ibc/src/core/ics02_client/client_state.rs
+++ b/crates/ibc/src/core/ics02_client/client_state.rs
@@ -1,8 +1,7 @@
 //! Defines `ClientState`, the core type to be implemented by light clients
 
-use core::fmt::Debug;
+use core::fmt::{Debug, Display, Formatter};
 use core::marker::{Send, Sync};
-use core::time::Duration;
 
 use ibc_proto::google::protobuf::Any;
 
@@ -30,6 +29,39 @@ pub enum UpdateKind {
     SubmitMisbehaviour,
 }
 
+/// Represents the status of a client
+#[derive(Debug, PartialEq, Eq)]
+pub enum Status {
+    /// The client is active and allowed to be used
+    Active,
+    /// The client is frozen and not allowed to be used
+    Frozen,
+    /// The client is expired and not allowed to be used
+    Expired,
+    /// Unauthorized indicates that the client type is not registered as an allowed client type.
+    Unauthorized,
+}
+
+impl Status {
+    pub fn is_active(&self) -> bool {
+        *self == Status::Active
+    }
+
+    pub fn is_frozen(&self) -> bool {
+        *self == Status::Frozen
+    }
+
+    pub fn is_expired(&self) -> bool {
+        *self == Status::Expired
+    }
+}
+
+impl Display for Status {
+    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result {
+        write!(f, "{self:?}")
+    }
+}
+
 /// `ClientState` methods needed in both validation and execution.
 ///
 /// They do not require access to a client `ValidationContext` nor
@@ -50,13 +82,6 @@ pub trait ClientStateCommon {
     /// Validate that the client is at a sufficient height
     fn validate_proof_height(&self, proof_height: Height) -> Result<(), ClientError>;
 
-    /// Assert that the client is not frozen
-    fn confirm_not_frozen(&self) -> Result<(), ClientError>;
-
-    /// Check if the state is expired when `elapsed` time has passed since the latest consensus
-    /// state timestamp
-    fn expired(&self, elapsed: Duration) -> bool;
-
     /// Verify the upgraded client and consensus states and validate proofs
     /// against the given root.
     ///
@@ -140,6 +165,13 @@ pub trait ClientStateValidation<ClientValidationContext> {
         client_message: Any,
         update_kind: &UpdateKind,
     ) -> Result<bool, ClientError>;
+
+    /// Returns the status of the client. Only Active clients are allowed to process packets.
+    fn status(
+        &self,
+        ctx: &ClientValidationContext,
+        client_id: &ClientId,
+    ) -> Result<Status, ClientError>;
 }
 
 /// `ClientState` methods which require access to the client's
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index efda51a0f..2ee0b4831 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -12,6 +12,8 @@ use crate::core::timestamp::Timestamp;
 use crate::core::ContextError;
 use crate::Height;
 
+use super::client_state::Status;
+
 /// Encodes all the possible client errors
 #[derive(Debug, Display)]
 pub enum ClientError {
@@ -25,6 +27,8 @@ pub enum ClientError {
     },
     /// client is frozen with description: `{description}`
     ClientFrozen { description: String },
+    /// client is not active. Status=`{status}`
+    ClientNotActive { status: Status },
     /// client state not found: `{client_id}`
     ClientStateNotFound { client_id: ClientId },
     /// client state already exists: `{client_id}`
@@ -91,11 +95,6 @@ pub enum ClientError {
     },
     /// timestamp is invalid or missing, timestamp=`{time1}`,  now=`{time2}`
     InvalidConsensusStateTimestamp { time1: Timestamp, time2: Timestamp },
-    /// header not within trusting period: expires_at=`{latest_time}` now=`{update_time}`
-    HeaderNotWithinTrustPeriod {
-        latest_time: Timestamp,
-        update_time: Timestamp,
-    },
     /// the local consensus state could not be retrieved for height `{height}`
     MissingLocalConsensusState { height: Height },
     /// invalid signer error: `{reason}`
@@ -121,6 +120,14 @@ impl From<ContextError> for ClientError {
     }
 }
 
+impl From<&'static str> for ClientError {
+    fn from(s: &'static str) -> Self {
+        Self::Other {
+            description: s.to_string(),
+        }
+    }
+}
+
 #[cfg(feature = "std")]
 impl std::error::Error for ClientError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index b487770f9..594a6154b 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -28,7 +28,12 @@ where
     // Read client state from the host chain store. The client should already exist.
     let client_state = ctx.client_state(&client_id)?;
 
-    client_state.confirm_not_frozen()?;
+    {
+        let status = client_state.status(ctx.get_client_validation_context(), &client_id)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     let client_message = msg.client_message();
 
@@ -245,7 +250,10 @@ mod tests {
         assert!(res.is_ok(), "result: {res:?}");
 
         let client_state = ctx.client_state(&msg.client_id).unwrap();
-        assert!(client_state.confirm_not_frozen().is_ok());
+        assert!(client_state
+            .status(&ctx, &msg.client_id)
+            .unwrap()
+            .is_active());
         assert_eq!(client_state.latest_height(), latest_header_height);
     }
 
@@ -292,7 +300,10 @@ mod tests {
         assert!(res.is_ok(), "result: {res:?}");
 
         let client_state = ctx.client_state(&msg.client_id).unwrap();
-        assert!(client_state.confirm_not_frozen().is_ok());
+        assert!(client_state
+            .status(&ctx, &msg.client_id)
+            .unwrap()
+            .is_active());
         assert_eq!(client_state.latest_height(), latest_header_height);
     }
 
@@ -413,7 +424,10 @@ mod tests {
         assert!(res.is_ok(), "result: {res:?}");
 
         let client_state = ctx_a.client_state(&msg.client_id).unwrap();
-        assert!(client_state.confirm_not_frozen().is_ok());
+        assert!(client_state
+            .status(&ctx_a, &msg.client_id)
+            .unwrap()
+            .is_active());
         assert_eq!(client_state.latest_height(), latest_header_height);
         assert_eq!(client_state, ctx_a.latest_client_states(&msg.client_id));
     }
@@ -496,7 +510,8 @@ mod tests {
     fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {
         let client_state = ctx.client_state(client_id).unwrap();
 
-        assert!(client_state.confirm_not_frozen().is_err());
+        let status = client_state.status(ctx, client_id).unwrap();
+        assert!(status.is_frozen(), "client_state status: {status}");
 
         // check events
         assert_eq!(ctx.events.len(), 2);
diff --git a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
index 70035c5b3..3980d5b77 100644
--- a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
@@ -4,8 +4,8 @@ use crate::prelude::*;
 
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
 use crate::core::ics02_client::client_state::ClientStateExecution;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics02_client::events::UpgradeClient;
@@ -26,8 +26,13 @@ where
     // Read the current latest client state from the host chain store.
     let old_client_state = ctx.client_state(&client_id)?;
 
-    // Check if the client is frozen.
-    old_client_state.confirm_not_frozen()?;
+    // Check if the client is active.
+    {
+        let status = old_client_state.status(ctx.get_client_validation_context(), &client_id)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     // Read the latest consensus state from the host chain store.
     let old_client_cons_state_path =
@@ -39,24 +44,6 @@ where
             height: old_client_state.latest_height(),
         })?;
 
-    let now = ctx.host_timestamp()?;
-    let duration = now
-        .duration_since(&old_consensus_state.timestamp())
-        .ok_or_else(|| ClientError::InvalidConsensusStateTimestamp {
-            time1: old_consensus_state.timestamp(),
-            time2: now,
-        })?;
-
-    // Check if the latest consensus state is within the trust period.
-    if old_client_state.expired(duration) {
-        return Err(ContextError::ClientError(
-            ClientError::HeaderNotWithinTrustPeriod {
-                latest_time: old_consensus_state.timestamp(),
-                update_time: now,
-            },
-        ));
-    };
-
     // Validate the upgraded client state and consensus state and verify proofs against the root
     old_client_state.verify_upgrade_client(
         msg.upgraded_client_state.clone(),
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index caa5c01e1..8ca94b4a1 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -4,8 +4,9 @@ use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenAck;
@@ -58,7 +59,13 @@ where
     {
         let client_state_of_b_on_a = ctx_a.client_state(vars.client_id_on_a())?;
 
-        client_state_of_b_on_a.confirm_not_frozen()?;
+        {
+            let status = client_state_of_b_on_a
+                .status(ctx_a.get_client_validation_context(), vars.client_id_on_a())?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_b_on_a.validate_proof_height(msg.proofs_height_on_b)?;
 
         let client_cons_state_path_on_a =
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
index 3f7d88f23..56a96b45b 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
@@ -3,8 +3,9 @@
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::context::ContextError;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenConfirm;
@@ -47,7 +48,13 @@ where
     {
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
index ec64be11b..1d7e11a5c 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
@@ -1,9 +1,10 @@
 //! Protocol logic specific to ICS3 messages of type `MsgConnectionOpenInit`.
+use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
 use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
 use crate::core::ics03_connection::events::OpenInit;
 use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
@@ -19,7 +20,14 @@ where
 
     // An IBC client running on the local (host) chain should exist.
     let client_state_of_b_on_a = ctx_a.client_state(&msg.client_id_on_a)?;
-    client_state_of_b_on_a.confirm_not_frozen()?;
+
+    {
+        let status = client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), &msg.client_id_on_a)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     if let Some(version) = msg.version {
         version.verify_is_supported(&ctx_a.get_compatible_versions())?;
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index b26d555d2..090f3ede5 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -4,8 +4,9 @@ use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenTry;
@@ -59,7 +60,13 @@ where
     {
         let client_state_of_a_on_b = ctx_b.client_state(vars.conn_end_on_b.client_id())?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), &msg.client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proofs_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/crates/ibc/src/core/ics04_channel/context.rs
index 1f95c6521..3e24e1729 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/crates/ibc/src/core/ics04_channel/context.rs
@@ -26,6 +26,9 @@ pub trait SendPacketValidationContext {
     type AnyConsensusState: ConsensusState;
     type AnyClientState: ClientState<Self::ClientValidationContext, Self::E>;
 
+    /// Retrieve the context that implements all clients' `ValidationContext`.
+    fn get_client_validation_context(&self) -> &Self::ClientValidationContext;
+
     /// Returns the ChannelEnd for the given `port_id` and `chan_id`.
     fn channel_end(&self, channel_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError>;
 
@@ -54,6 +57,10 @@ where
     type AnyConsensusState = T::AnyConsensusState;
     type AnyClientState = T::AnyClientState;
 
+    fn get_client_validation_context(&self) -> &Self::ClientValidationContext {
+        self.get_client_validation_context()
+    }
+
     fn channel_end(&self, channel_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError> {
         self.channel_end(channel_end_path)
     }
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index 9a92398ab..64d7b31f4 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -1,7 +1,8 @@
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::events::MessageEvent;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
@@ -179,7 +180,13 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        client_state_of_b_on_a.confirm_not_frozen()?;
+        {
+            let status = client_state_of_b_on_a
+                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a =
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index de945d5b5..11974a118 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -1,10 +1,11 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseConfirm`.
 
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
@@ -116,7 +117,13 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
index 114f2d16f..976456696 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
@@ -1,8 +1,9 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseInit`.
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::ClientStateValidation;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
 use crate::core::ics04_channel::error::ChannelError;
@@ -111,7 +112,13 @@ where
 
     let client_id_on_a = conn_end_on_a.client_id();
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
-    client_state_of_b_on_a.confirm_not_frozen()?;
+    {
+        let status =
+            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     Ok(())
 }
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index 0356c40a2..8e522ebe0 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -1,12 +1,12 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenAck`.
 
-use crate::core::router::Module;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
 use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
@@ -15,6 +15,7 @@ use crate::core::ics04_channel::events::OpenAck;
 use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_ack_validate<ValCtx>(
@@ -114,7 +115,13 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        client_state_of_b_on_a.confirm_not_frozen()?;
+        {
+            let status = client_state_of_b_on_a
+                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a =
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index c30c4041c..b38a937c7 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -1,10 +1,11 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenConfirm`.
 
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
@@ -118,7 +119,13 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index d4f7e5d92..1cd8583e8 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -1,9 +1,10 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenInit`.
 
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::ClientStateValidation;
 use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State};
 use crate::core::ics04_channel::events::OpenInit;
 use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
@@ -121,7 +122,14 @@ where
 
     let client_id_on_a = conn_end_on_a.client_id();
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
-    client_state_of_b_on_a.confirm_not_frozen()?;
+
+    {
+        let status =
+            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     let conn_version = conn_end_on_a.versions();
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index 44ff9bf8d..3cda49710 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -1,12 +1,12 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenTry`.
 
-use crate::core::router::Module;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
 use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
@@ -17,6 +17,7 @@ use crate::core::ics24_host::identifier::ChannelId;
 use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
 use crate::core::ics24_host::path::{SeqAckPath, SeqRecvPath, SeqSendPath};
+use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
 
 pub(crate) fn chan_open_try_validate<ValCtx>(
@@ -138,7 +139,13 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index 936b81b97..d2f024612 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -1,7 +1,8 @@
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
@@ -185,7 +186,13 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        client_state_of_a_on_b.confirm_not_frozen()?;
+        {
+            let status = client_state_of_a_on_b
+                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
index 009f6ee99..59cb14c6d 100644
--- a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
@@ -1,3 +1,5 @@
+use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 
 use crate::core::events::IbcEvent;
@@ -56,7 +58,13 @@ pub fn send_packet_validate(
 
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-    client_state_of_b_on_a.confirm_not_frozen()?;
+    {
+        let status =
+            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+        if !status.is_active() {
+            return Err(ClientError::ClientNotActive { status }.into());
+        }
+    }
 
     let latest_height_on_a = client_state_of_b_on_a.latest_height();
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index 1f61da24c..12d479744 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -1,3 +1,5 @@
+use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 use prost::Message;
 
@@ -192,7 +194,14 @@ where
     {
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
-        client_state_of_b_on_a.confirm_not_frozen()?;
+
+        {
+            let status = client_state_of_b_on_a
+                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         // check that timeout height or timeout timestamp has passed on the other end
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
index 5630a1f2a..9215d588a 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
@@ -1,8 +1,9 @@
+use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
 use crate::core::ics04_channel::channel::State;
@@ -70,7 +71,13 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        client_state_of_b_on_a.confirm_not_frozen()?;
+        {
+            let status = client_state_of_b_on_a
+                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
+            if !status.is_active() {
+                return Err(ClientError::ClientNotActive { status }.into());
+            }
+        }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a =
diff --git a/crates/ibc/src/hosts/tendermint/validate_self_client.rs b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
index ce8a6c3f6..5ac4a1cf5 100644
--- a/crates/ibc/src/hosts/tendermint/validate_self_client.rs
+++ b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
@@ -30,7 +30,12 @@ pub trait ValidateSelfClientContext {
 
         tm_client_state.validate().map_err(ClientError::from)?;
 
-        tm_client_state.confirm_not_frozen()?;
+        if tm_client_state.is_frozen() {
+            return Err(ClientError::ClientFrozen {
+                description: String::new(),
+            }
+            .into());
+        }
 
         let self_chain_id = self.chain_id();
         if self_chain_id != &tm_client_state.chain_id {
diff --git a/crates/ibc/src/mock/client_state.rs b/crates/ibc/src/mock/client_state.rs
index 24b2bd688..9f31e8d26 100644
--- a/crates/ibc/src/mock/client_state.rs
+++ b/crates/ibc/src/mock/client_state.rs
@@ -1,3 +1,6 @@
+use crate::core::ics02_client::client_state::Status;
+use crate::core::timestamp::Timestamp;
+use crate::core::ContextError;
 use crate::prelude::*;
 
 use core::str::FromStr;
@@ -66,6 +69,14 @@ impl MockClientState {
             ..self
         }
     }
+
+    pub fn is_frozen(&self) -> bool {
+        self.frozen_height.is_some()
+    }
+
+    fn expired(&self, _elapsed: Duration) -> bool {
+        false
+    }
 }
 
 impl Protobuf<RawMockClientState> for MockClientState {}
@@ -125,6 +136,23 @@ impl From<MockClientState> for Any {
     }
 }
 
+pub trait MockClientContext {
+    type ConversionError: ToString;
+    type AnyConsensusState: TryInto<MockConsensusState, Error = Self::ConversionError>;
+
+    /// Retrieve the consensus state for the given client ID at the specified
+    /// height.
+    ///
+    /// Returns an error if no such state exists.
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<Self::AnyConsensusState, ContextError>;
+
+    /// Returns the current timestamp of the local chain.
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
+}
+
 impl ClientStateCommon for MockClientState {
     fn verify_consensus_state(&self, consensus_state: Any) -> Result<(), ClientError> {
         let _mock_consensus_state = MockConsensusState::try_from(consensus_state)?;
@@ -150,19 +178,6 @@ impl ClientStateCommon for MockClientState {
         Ok(())
     }
 
-    fn confirm_not_frozen(&self) -> Result<(), ClientError> {
-        if let Some(frozen_height) = self.frozen_height {
-            return Err(ClientError::ClientFrozen {
-                description: format!("The client is frozen at height {frozen_height}"),
-            });
-        }
-        Ok(())
-    }
-
-    fn expired(&self, _elapsed: Duration) -> bool {
-        false
-    }
-
     fn verify_upgrade_client(
         &self,
         upgraded_client_state: Any,
@@ -204,7 +219,13 @@ impl ClientStateCommon for MockClientState {
     }
 }
 
-impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for MockClientState {
+impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for MockClientState
+where
+    ClientValidationContext: MockClientContext,
+    ClientValidationContext::AnyConsensusState: TryInto<MockConsensusState>,
+    ClientError:
+        From<<ClientValidationContext::AnyConsensusState as TryInto<MockConsensusState>>::Error>,
+{
     fn verify_client_message(
         &self,
         _ctx: &ClientValidationContext,
@@ -252,6 +273,42 @@ impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for
             }
         }
     }
+
+    fn status(
+        &self,
+        ctx: &ClientValidationContext,
+        client_id: &ClientId,
+    ) -> Result<Status, ClientError> {
+        if self.is_frozen() {
+            return Ok(Status::Frozen);
+        }
+
+        let latest_consensus_state: MockConsensusState = {
+            let any_latest_consensus_state = match ctx.consensus_state(
+                &ClientConsensusStatePath::new(client_id, &self.latest_height()),
+            ) {
+                Ok(cs) => cs,
+                // if the client state does not have an associated consensus state for its latest height
+                // then it must be expired
+                Err(_) => return Ok(Status::Expired),
+            };
+
+            any_latest_consensus_state.try_into()?
+        };
+
+        let now = ctx.host_timestamp()?;
+        let elapsed_since_latest_consensus_state = now
+            .duration_since(&latest_consensus_state.timestamp())
+            .ok_or(ClientError::Other {
+                description: format!("latest consensus state is in the future. now: {now}, latest consensus state: {}", latest_consensus_state.timestamp()),
+            })?;
+
+        if self.expired(elapsed_since_latest_consensus_state) {
+            return Ok(Status::Expired);
+        }
+
+        Ok(Status::Active)
+    }
 }
 
 impl<E> ClientStateExecution<E> for MockClientState
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 18e996eaf..ff7de4c93 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -30,7 +30,6 @@ use crate::clients::ics07_tendermint::consensus_state::TENDERMINT_CONSENSUS_STAT
 use crate::core::dispatch;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::client_state::ClientState;
-use crate::core::ics02_client::client_state::ClientStateCommon;
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
@@ -840,7 +839,12 @@ impl ValidationContext for MockContext {
             })
             .map_err(ContextError::ConnectionError)?;
 
-        mock_client_state.confirm_not_frozen()?;
+        if mock_client_state.is_frozen() {
+            return Err(ClientError::ClientFrozen {
+                description: String::new(),
+            }
+            .into());
+        }
 
         let self_chain_id = &self.host_chain_id;
         let self_revision_number = self_chain_id.revision_number();
diff --git a/crates/ibc/src/mock/context/clients.rs b/crates/ibc/src/mock/context/clients.rs
index f9b13fd25..448195902 100644
--- a/crates/ibc/src/mock/context/clients.rs
+++ b/crates/ibc/src/mock/context/clients.rs
@@ -1,5 +1,6 @@
 //! Client context implementations for `MockContext`
 
+use crate::mock::client_state::MockClientContext;
 use crate::prelude::*;
 
 use super::{AnyClientState, AnyConsensusState, MockClientRecord, MockContext};
@@ -15,6 +16,22 @@ use crate::core::ContextError;
 use crate::core::ValidationContext;
 use crate::Height;
 
+impl MockClientContext for MockContext {
+    type ConversionError = &'static str;
+    type AnyConsensusState = AnyConsensusState;
+
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<Self::AnyConsensusState, ContextError> {
+        ValidationContext::consensus_state(self, client_cons_state_path)
+    }
+
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
+        ValidationContext::host_timestamp(self)
+    }
+}
+
 impl TmCommonContext for MockContext {
     type ConversionError = &'static str;
     type AnyConsensusState = AnyConsensusState;

From b44270399697866b44e9124ca1c2dbea42120b4f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Fri, 4 Aug 2023 12:25:56 -0400
Subject: [PATCH 014/182] Release v0.44.0 (#818)

* changelog

* update ibc-derive

* bump ibc-rs
---
 .../536-clientstate-status.md                 |  0
 .../786-decouple-token-sendpacket.md          |  0
 .../breaking-changes/788-decouple-router.md   |  0
 .../802-simplify-module-lookup.md             |  0
 .changelog/v0.44.0/summary.md                 |  3 +++
 CHANGELOG.md                                  | 19 +++++++++++++++++++
 crates/ibc-derive/Cargo.toml                  |  2 +-
 crates/ibc/Cargo.toml                         |  4 ++--
 8 files changed, 25 insertions(+), 3 deletions(-)
 rename .changelog/{unreleased => v0.44.0}/breaking-changes/536-clientstate-status.md (100%)
 rename .changelog/{unreleased => v0.44.0}/breaking-changes/786-decouple-token-sendpacket.md (100%)
 rename .changelog/{unreleased => v0.44.0}/breaking-changes/788-decouple-router.md (100%)
 rename .changelog/{unreleased => v0.44.0}/breaking-changes/802-simplify-module-lookup.md (100%)
 create mode 100644 .changelog/v0.44.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/536-clientstate-status.md b/.changelog/v0.44.0/breaking-changes/536-clientstate-status.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/536-clientstate-status.md
rename to .changelog/v0.44.0/breaking-changes/536-clientstate-status.md
diff --git a/.changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md b/.changelog/v0.44.0/breaking-changes/786-decouple-token-sendpacket.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/786-decouple-token-sendpacket.md
rename to .changelog/v0.44.0/breaking-changes/786-decouple-token-sendpacket.md
diff --git a/.changelog/unreleased/breaking-changes/788-decouple-router.md b/.changelog/v0.44.0/breaking-changes/788-decouple-router.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/788-decouple-router.md
rename to .changelog/v0.44.0/breaking-changes/788-decouple-router.md
diff --git a/.changelog/unreleased/breaking-changes/802-simplify-module-lookup.md b/.changelog/v0.44.0/breaking-changes/802-simplify-module-lookup.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/802-simplify-module-lookup.md
rename to .changelog/v0.44.0/breaking-changes/802-simplify-module-lookup.md
diff --git a/.changelog/v0.44.0/summary.md b/.changelog/v0.44.0/summary.md
new file mode 100644
index 000000000..87b8f04ba
--- /dev/null
+++ b/.changelog/v0.44.0/summary.md
@@ -0,0 +1,3 @@
+The goal with this release was to replace `ClientState::{confirm_not_frozen, expired}()` with `ClientState::status()` ([#536](https://github.com/cosmos/ibc-rs/issues/536)). Updating basecoin-rs with the new changes exposed the shortcomings of having `SendPacket*Context` be supertraits of `TokenTransfer*Context`, which in turned exposed the shortcomings of having `Router` be a supertrait of `ValidationContext`. Hence, we decoupled everything!
+
+There are consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7297db6fd..f12eb3418 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,24 @@
 # CHANGELOG
 
+## v0.44.0
+
+*August 4, 2023*
+
+The goal with this release was to replace `ClientState::{confirm_not_frozen, expired}()` with `ClientState::status()` ([#536](https://github.com/cosmos/ibc-rs/issues/536)). Updating basecoin-rs with the new changes exposed the shortcomings of having `SendPacket*Context` be supertraits of `TokenTransfer*Context`, which in turned exposed the shortcomings of having `Router` be a supertrait of `ValidationContext`. Hence, we decoupled everything!
+
+There are consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- [ibc-derive] Replace `ClientState::{confirm_not_frozen, expired}()` with `ClientState::status()`
+  ([#536](https://github.com/cosmos/ibc-rs/issues/536))
+- Decouple `TokenTransfer{Validation,Execution}` from `SendPacket{Validation,Execution}`
+  ([#786](https://github.com/cosmos/ibc-rs/issues/786))
+- Decouple `Router` from `ValidationContext`
+  ([#788](https://github.com/cosmos/ibc-rs/pull/788))
+- Simplify Module lookup in the `Router` trait
+ ([#802](https://github.com/cosmos/ibc-rs/issues/802))
+
 ## v0.43.1
 
 *July 31, 2023*
diff --git a/crates/ibc-derive/Cargo.toml b/crates/ibc-derive/Cargo.toml
index 5463fc8bb..e89af7e67 100644
--- a/crates/ibc-derive/Cargo.toml
+++ b/crates/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "ibc-derive"
-version = "0.2.0"
+version = "0.3.0"
 license = "Apache-2.0"
 readme = "README.md"
 description = "Macros implementation of #[derive(ClientState)] and #[derive(ConsensusState)]"
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index e47745faa..142d14b6a 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.43.1"
+version      = "0.44.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -75,7 +75,7 @@ scale-info = { version = "2.1.2", default-features = false, features = ["derive"
 borsh = {version = "0.9.0", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
 
-ibc-derive = { version ="0.2.0", path = "../ibc-derive" }
+ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
 
 schemars = { version = "0.8.12", optional = true }
 

From 5c48d1552ed66ca50ae751e5fb0d426146bb28aa Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 8 Aug 2023 09:08:51 -0700
Subject: [PATCH 015/182] fix: utilize encoded bytes from `Any` for header of
 `UpdateClient` event (#822)

* fix: utilize encoded bytes from Any for header of UpdateClient event

* nit: use header_bytes

* nit: edit unclog

* nit: add a docstring for UpdateClient event

* imp: use encode_to_vec
---
 ...21-fix-header-decoding-from-update-client-event.md |  3 +++
 crates/ibc/src/core/ics02_client/events.rs            | 11 +++++++++--
 .../src/core/ics02_client/handler/update_client.rs    |  5 +++--
 3 files changed, 15 insertions(+), 4 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md

diff --git a/.changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md b/.changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md
new file mode 100644
index 000000000..e54aa1ea9
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md
@@ -0,0 +1,3 @@
+- Utilize encoded bytes from `Any` for the `header` field of `UpdateClient`
+  event
+  ([#821](https://github.com/cosmos/ibc-rs/issues/821))
diff --git a/crates/ibc/src/core/ics02_client/events.rs b/crates/ibc/src/core/ics02_client/events.rs
index 8d9f87b65..01e4c586a 100644
--- a/crates/ibc/src/core/ics02_client/events.rs
+++ b/crates/ibc/src/core/ics02_client/events.rs
@@ -146,6 +146,8 @@ impl From<ConsensusHeightsAttribute> for abci::EventAttribute {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, From, PartialEq, Eq)]
 struct HeaderAttribute {
+    /// NOTE: The header is encoded as bytes of the
+    /// [`Any`](ibc_proto::google::protobuf::Any) type.
     header: Vec<u8>,
 }
 
@@ -246,6 +248,10 @@ pub struct UpdateClient {
 }
 
 impl UpdateClient {
+    /// Constructs a new UpdateClient event.
+    ///
+    /// NOTE: the `header` is the encoded bytes of the
+    /// [`Any`](ibc_proto::google::protobuf::Any) type.
     pub fn new(
         client_id: ClientId,
         client_type: ClientType,
@@ -419,6 +425,7 @@ mod tests {
     use crate::core::timestamp::Timestamp;
     use crate::mock::header::MockHeader;
     use ibc_proto::google::protobuf::Any;
+    use prost::Message;
     use std::str::FromStr;
     use tendermint::abci::Event as AbciEvent;
 
@@ -452,7 +459,7 @@ mod tests {
             "07-tendermint",
             "0-5",
             "0-5,0-7",
-            "0a021005",
+            "0a102f6962632e6d6f636b2e48656164657212040a021005",
         ];
 
         let tests: Vec<Test> = vec![
@@ -470,7 +477,7 @@ mod tests {
                     client_type.clone(),
                     consensus_height,
                     consensus_heights,
-                    header.value,
+                    header.encode_to_vec(),
                 )
                 .into(),
                 expected_keys: expected_keys.clone(),
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 594a6154b..cad4bde1d 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -1,6 +1,7 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpdateAnyClient`.
 
 use crate::prelude::*;
+use prost::Message;
 
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
@@ -119,7 +120,7 @@ where
                     client_state.client_type(),
                     *consensus_height,
                     consensus_heights,
-                    header.value,
+                    header.encode_to_vec(),
                 ))
             };
             ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
@@ -504,7 +505,7 @@ mod tests {
         assert_eq!(update_client_event.client_type(), &mock_client_type());
         assert_eq!(update_client_event.consensus_height(), &height);
         assert_eq!(update_client_event.consensus_heights(), &vec![height]);
-        assert_eq!(update_client_event.header(), &header.value);
+        assert_eq!(update_client_event.header(), &header.encode_to_vec());
     }
 
     fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {

From 580fc1dc6d25bb850cb03f7661535244fd7a56bf Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 10 Aug 2023 07:28:09 -0700
Subject: [PATCH 016/182] fix: remove traces of deprecated `mocks-no-std`
 feature (#825)

* fix: remove mocks-no-std leftovers

* misc: add unclog

* nit: typo
---
 .../bug-fixes/819-remove-mocks-no-std-traces.md           | 2 ++
 crates/ibc/src/lib.rs                                     | 2 +-
 crates/ibc/src/mock/mod.rs                                | 8 ++++----
 3 files changed, 7 insertions(+), 5 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md

diff --git a/.changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md b/.changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md
new file mode 100644
index 000000000..4aadca5b1
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md
@@ -0,0 +1,2 @@
+- Remove traces of deprecated `mocks-no-std` feature
+  ([#819](https://github.com/cosmos/ibc-rs/issues/821))
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 234af7a48..68004e69f 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -53,7 +53,7 @@ pub mod clients;
 pub mod core;
 pub mod hosts;
 
-#[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
+#[cfg(any(test, feature = "mocks"))]
 pub mod mock;
 #[cfg(any(test, feature = "mocks"))]
 pub mod test_utils; // Context mock, the underlying host chain, and client types: for testing all handlers.
diff --git a/crates/ibc/src/mock/mod.rs b/crates/ibc/src/mock/mod.rs
index a2450b5a2..9492569c2 100644
--- a/crates/ibc/src/mock/mod.rs
+++ b/crates/ibc/src/mock/mod.rs
@@ -1,18 +1,18 @@
 //! Implementation of mocks for context, host chain, and client.
 
-#[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
+#[cfg(any(test, feature = "mocks"))]
 pub mod client_state;
-#[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
+#[cfg(any(test, feature = "mocks"))]
 pub mod consensus_state;
 #[cfg(any(test, feature = "mocks"))]
 pub mod context;
-#[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
+#[cfg(any(test, feature = "mocks"))]
 pub mod header;
 #[cfg(any(test, feature = "mocks"))]
 pub mod host;
 #[cfg(any(test, feature = "mocks"))]
 pub mod ics18_relayer;
-#[cfg(any(test, feature = "mocks", feature = "mocks-no-std"))]
+#[cfg(any(test, feature = "mocks"))]
 pub mod misbehaviour;
 #[cfg(any(test, feature = "mocks"))]
 pub mod router;

From 5a794919ee8d4ee87bad99b9e745e974aac82b90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Thu, 10 Aug 2023 11:00:58 -0400
Subject: [PATCH 017/182] Release v0.44.1 (#826)

* unclog release

* bump version
---
 .../bug-fixes/819-remove-mocks-no-std-traces.md |  0
 ...-header-decoding-from-update-client-event.md |  0
 .changelog/v0.44.1/summary.md                   |  3 +++
 CHANGELOG.md                                    | 17 +++++++++++++++++
 crates/ibc/Cargo.toml                           |  2 +-
 5 files changed, 21 insertions(+), 1 deletion(-)
 rename .changelog/{unreleased => v0.44.1}/bug-fixes/819-remove-mocks-no-std-traces.md (100%)
 rename .changelog/{unreleased => v0.44.1}/bug-fixes/821-fix-header-decoding-from-update-client-event.md (100%)
 create mode 100644 .changelog/v0.44.1/summary.md

diff --git a/.changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md b/.changelog/v0.44.1/bug-fixes/819-remove-mocks-no-std-traces.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/819-remove-mocks-no-std-traces.md
rename to .changelog/v0.44.1/bug-fixes/819-remove-mocks-no-std-traces.md
diff --git a/.changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md b/.changelog/v0.44.1/bug-fixes/821-fix-header-decoding-from-update-client-event.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/821-fix-header-decoding-from-update-client-event.md
rename to .changelog/v0.44.1/bug-fixes/821-fix-header-decoding-from-update-client-event.md
diff --git a/.changelog/v0.44.1/summary.md b/.changelog/v0.44.1/summary.md
new file mode 100644
index 000000000..51b5400fe
--- /dev/null
+++ b/.changelog/v0.44.1/summary.md
@@ -0,0 +1,3 @@
+This release fixes a bug with the `UpdateClient` event where the `header` field was not properly encoded.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index f12eb3418..5be073407 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # CHANGELOG
 
+
+# v0.44.1
+
+*August 4, 2023*
+
+This release fixes a bug with the `UpdateClient` event where the `header` field was not properly encoded.
+
+There are no consensus-breaking changes.
+
+### BUG FIXES
+
+- Remove traces of deprecated `mocks-no-std` feature
+  ([#819](https://github.com/cosmos/ibc-rs/issues/821))
+- Utilize encoded bytes from `Any` for the `header` field of `UpdateClient`
+  event
+  ([#821](https://github.com/cosmos/ibc-rs/issues/821))
+
 ## v0.44.0
 
 *August 4, 2023*
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 142d14b6a..2217b395e 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.44.0"
+version      = "0.44.1"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"

From a9cfd86134b7630809c1639d4f0c455b0d9f8f53 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 17 Aug 2023 10:49:59 -0700
Subject: [PATCH 018/182] deps: update tendermint to v0.33.0 (#831)

* deps: update tendermint to v0.33.0

* fix: clippy catches

* misc: add unclog
---
 .../785-bump-tendermint-to-v0.33.0.md            |  2 ++
 ci/no-std-check/Cargo.toml                       | 14 +++++++-------
 crates/ibc/Cargo.toml                            | 16 ++++++++--------
 crates/ibc/src/test_utils.rs                     |  3 +++
 4 files changed, 20 insertions(+), 15 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md

diff --git a/.changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md b/.changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md
new file mode 100644
index 000000000..09e838b68
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md
@@ -0,0 +1,2 @@
+- Bump tendermint-rs to v0.33.0 
+  ([#785](https://github.com/cosmos/ibc-rs/issues/785))
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index b6911b057..51a50fb51 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,17 +6,17 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../crates/ibc", default-features = false }
-ibc-proto = { version = "0.32.1", default-features = false, features = [
+ibc-proto = { version = "0.33.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
 ] }
-tendermint = { version = "0.32.0", default-features = false }
-tendermint-proto = { version = "0.32.0", default-features = false }
-tendermint-light-client-verifier = { version = "0.32.0", default-features = false, features = ["rust-crypto"] }
+tendermint = { version = "0.33.0", default-features = false }
+tendermint-proto = { version = "0.33.0", default-features = false }
+tendermint-light-client-verifier = { version = "0.33.0", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "21.0.0", default-features = false, optional = true }
-sp-io = { version = "22.0.0", default-features = false, optional = true }
-sp-runtime = { version = "23.0.0", default-features = false, optional = true }
+sp-core = { version = "22.0.0", default-features = false, optional = true }
+sp-io = { version = "24.0.0", default-features = false, optional = true }
+sp-runtime = { version = "25.0.0", default-features = false, optional = true }
 sp-std = { version = "7.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 2217b395e..48b589378 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,9 +50,9 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.32.1", default-features = false }
+ibc-proto = { version = "0.33.0", default-features = false }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.25", default-features = false }
+time = { version = ">=0.3.0, <0.3.26", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json = { version = "1", default-features = false, optional = true }
@@ -80,20 +80,20 @@ ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
 schemars = { version = "0.8.12", optional = true }
 
 [dependencies.tendermint]
-version = "0.32"
+version = "0.33"
 default-features = false
 
 [dependencies.tendermint-proto]
-version = "0.32"
+version = "0.33"
 default-features = false
 
 [dependencies.tendermint-light-client-verifier]
-version = "0.32"
+version = "0.33"
 default-features = false
 features = ["rust-crypto"]
 
 [dependencies.tendermint-testgen]
-version = "0.32"
+version = "0.33"
 optional = true
 default-features = false
 
@@ -102,6 +102,6 @@ env_logger = "0.10.0"
 rstest = "0.18.1"
 tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
 test-log = { version = "0.2.10", features = ["trace"] }
-tendermint-rpc = { version = "0.32", features = ["http-client", "websocket-client"] }
-tendermint-testgen = { version = "0.32" } # Needed for generating (synthetic) light blocks.
+tendermint-rpc = { version = "0.33", features = ["http-client", "websocket-client"] }
+tendermint-testgen = { version = "0.33" } # Needed for generating (synthetic) light blocks.
 parking_lot = { version = "0.12.1" }
diff --git a/crates/ibc/src/test_utils.rs b/crates/ibc/src/test_utils.rs
index 6cc73f801..9d814e3e6 100644
--- a/crates/ibc/src/test_utils.rs
+++ b/crates/ibc/src/test_utils.rs
@@ -33,6 +33,9 @@ pub fn default_consensus_params() -> consensus::Params {
             pub_key_types: vec![Algorithm::Ed25519],
         },
         version: Some(consensus::params::VersionParams::default()),
+        abci: consensus::params::AbciParams {
+            vote_extensions_enable_height: None,
+        },
     }
 }
 

From d8d4973089baf802cd61e22b629b687b8cd0ffc4 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 23 Aug 2023 07:13:37 -0700
Subject: [PATCH 019/182] fix: restore `no_std` support for `serde` feature
 (#790)

* fix: restore no_std support for serde feature

* deps: bump ibc-proto-rs to v0.34.0

* fix: reflect changes b/c of ibc-proto-rs

* imp: comply naming + use better domain type for host_consensus_state

* fix: apply host_cons_state_proof changes for conn_open_ack

* fix: use domain TmEvent instead of proto for upgrade client proposal handler

* misc: add a unclog for ibc-proto-rs upgrade
---
 .../790-bump-ibc-proto-rs-to-v0.34.0.md       |   2 +
 .../bug-fixes/741-restore-no-std-support.md   |   2 +
 ...ent-for-upgrade-client-proposal-handler.md |   3 +
 ci/no-std-check/Cargo.lock                    | 732 ++++--------------
 ci/no-std-check/Cargo.toml                    |   5 +-
 crates/ibc/Cargo.toml                         |   2 +-
 .../clients/ics07_tendermint/misbehaviour.rs  |   3 +-
 crates/ibc/src/core/handler.rs                |   8 +-
 crates/ibc/src/core/ics02_client/error.rs     |   4 +-
 .../ics02_client/handler/update_client.rs     |  14 +-
 crates/ibc/src/core/ics02_client/msgs.rs      |   2 +-
 .../core/ics02_client/msgs/update_client.rs   |  12 +-
 .../ics03_connection/msgs/conn_open_ack.rs    |  17 +
 .../ics03_connection/msgs/conn_open_try.rs    |  17 +
 .../tendermint/upgrade_proposal/handler.rs    |  11 +-
 crates/ibc/src/mock/header.rs                 |   2 +-
 crates/ibc/src/mock/ics18_relayer/context.rs  |   2 +-
 17 files changed, 218 insertions(+), 620 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
 create mode 100644 .changelog/unreleased/bug-fixes/741-restore-no-std-support.md
 create mode 100644 .changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md

diff --git a/.changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md b/.changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
new file mode 100644
index 000000000..5f41eb65a
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
@@ -0,0 +1,2 @@
+- Bump ibc-proto-rs to v0.34.0 
+  ([#790](https://github.com/cosmos/ibc-rs/issues/790))
diff --git a/.changelog/unreleased/bug-fixes/741-restore-no-std-support.md b/.changelog/unreleased/bug-fixes/741-restore-no-std-support.md
new file mode 100644
index 000000000..41cfaa7ff
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/741-restore-no-std-support.md
@@ -0,0 +1,2 @@
+- Fix compilation error of v0.41.0 by restoring no_std support for serde
+  feature ([#741](https://github.com/cosmos/ibc-rs/issues/741))
diff --git a/.changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md b/.changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md
new file mode 100644
index 000000000..69247e866
--- /dev/null
+++ b/.changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md
@@ -0,0 +1,3 @@
+- Switch to domain Tendermint event type instead of proto for the
+  `upgrade_client_proposal_handler` return
+  ([#838](https://github.com/cosmos/ibc-rs/issues/838))
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 609ee9079..4915d7e39 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -12,22 +12,13 @@ dependencies = [
  "regex",
 ]
 
-[[package]]
-name = "addr2line"
-version = "0.17.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b9ecd88a8c8378ca913a680cd98f0f13ac67383d35993f86c90a70e3f137816b"
-dependencies = [
- "gimli 0.26.2",
-]
-
 [[package]]
 name = "addr2line"
 version = "0.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a76fd60b23679b7d19bd066031410fb7e458ccc5e958eb5c325888ce4baedc97"
 dependencies = [
- "gimli 0.27.2",
+ "gimli",
 ]
 
 [[package]]
@@ -100,9 +91,9 @@ checksum = "9c7d0618f0e0b7e8ff11427422b64564d5fb0be1940354bfe2e0529b18a9d9b8"
 
 [[package]]
 name = "array-bytes"
-version = "4.2.0"
+version = "6.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f52f63c5c1316a16a4b35eaac8b76a98248961a533f061684cb2a7cb0eafb6c6"
+checksum = "d9b1c5a481ec30a5abd8dfbd94ab5cf1bb4e9a66be7f1b3b322f2f1170c200fd"
 
 [[package]]
 name = "arrayref"
@@ -134,12 +125,12 @@ version = "0.3.67"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "233d376d6d185f2a3093e58f283f60f880315b6c60075b01f36b3b85154564ca"
 dependencies = [
- "addr2line 0.19.0",
+ "addr2line",
  "cc",
  "cfg-if",
  "libc",
  "miniz_oxide",
- "object 0.30.4",
+ "object",
  "rustc-demangle",
 ]
 
@@ -403,15 +394,6 @@ dependencies = [
  "libc",
 ]
 
-[[package]]
-name = "cranelift-entity"
-version = "0.93.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f42ea692c7b450ad18b8c9889661505d51c09ec4380cf1c2d278dbb2da22cae1"
-dependencies = [
- "serde",
-]
-
 [[package]]
 name = "cranelift-entity"
 version = "0.95.1"
@@ -601,12 +583,6 @@ dependencies = [
  "syn 2.0.27",
 ]
 
-[[package]]
-name = "downcast-rs"
-version = "1.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ea835d29036a4087793836fa931b08837ad5e957da9e23886b29586fb9b6650"
-
 [[package]]
 name = "dyn-clonable"
 version = "0.9.0"
@@ -910,16 +886,6 @@ dependencies = [
  "wasi 0.11.0+wasi-snapshot-preview1",
 ]
 
-[[package]]
-name = "gimli"
-version = "0.26.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "22030e2c5a68ec659fde1e949a745124b48e6fa8b045b7ed5bd1fe4ccc5c4e5d"
-dependencies = [
- "fallible-iterator",
- "stable_deref_trait",
-]
-
 [[package]]
 name = "gimli"
 version = "0.27.2"
@@ -1059,7 +1025,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.42.0"
+version = "0.44.1"
 dependencies = [
  "bytes",
  "derive_more",
@@ -1071,6 +1037,9 @@ dependencies = [
  "primitive-types",
  "prost",
  "safe-regex",
+ "serde",
+ "serde_derive",
+ "serde_json",
  "sha2 0.10.6",
  "subtle-encoding",
  "tendermint",
@@ -1083,7 +1052,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.1.0"
+version = "0.3.0"
 dependencies = [
  "darling",
  "proc-macro2",
@@ -1093,9 +1062,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.32.1"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "11c352715b36685c2543556a77091fb16af5d26257d5ce9c28e6756c1ccd71aa"
+checksum = "f6e8625e1aa28e4da4a33505c6469747a9201f14ccd9012e2481313dfbbf9e2f"
 dependencies = [
  "base64 0.21.2",
  "borsh",
@@ -1112,15 +1081,17 @@ dependencies = [
 
 [[package]]
 name = "ics23"
-version = "0.10.1"
+version = "0.10.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af9e8f569c5cc88e08b8d076dc207e0748aa1f52d4b84910ec919c8f2bed6ea7"
+checksum = "442d4bab37956e76f739c864f246c825d87c0bb7f9afa65660c57833c91bf6d4"
 dependencies = [
  "anyhow",
  "bytes",
  "hex",
+ "informalsystems-pbjson",
  "prost",
  "ripemd",
+ "serde",
  "sha2 0.10.6",
  "sha3",
 ]
@@ -1181,6 +1152,16 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "informalsystems-pbjson"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4eecd90f87bea412eac91c6ef94f6b1e390128290898cbe14f2b926787ae1fb"
+dependencies = [
+ "base64 0.13.1",
+ "serde",
+]
+
 [[package]]
 name = "integer-sqrt"
 version = "0.1.5"
@@ -1246,12 +1227,6 @@ version = "0.2.146"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f92be4933c13fd498862a9e02a3055f8a8d9c039ce33db97306fd5a6caa7f29b"
 
-[[package]]
-name = "libm"
-version = "0.2.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f7012b1bbb0719e1097c47611d3898568c546d597c2e74d66f6087edd5233ff4"
-
 [[package]]
 name = "libsecp256k1"
 version = "0.7.1"
@@ -1361,15 +1336,6 @@ dependencies = [
  "rustix 0.37.20",
 ]
 
-[[package]]
-name = "memoffset"
-version = "0.6.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5aa361d4faea93603064a027415f07bd8e1d5c88c9fbf68bf56a285428fd79ce"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "memoffset"
 version = "0.8.0"
@@ -1388,12 +1354,6 @@ dependencies = [
  "hash-db",
 ]
 
-[[package]]
-name = "memory_units"
-version = "0.4.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8452105ba047068f40ff7093dd1d9da90898e63dd61736462e9cdda6a90ad3c3"
-
 [[package]]
 name = "merlin"
 version = "2.0.1"
@@ -1421,7 +1381,7 @@ version = "0.1.0"
 dependencies = [
  "ibc",
  "ibc-proto",
- "sp-core 21.0.0",
+ "sp-core",
  "sp-io",
  "sp-runtime",
  "sp-std 7.0.0",
@@ -1437,17 +1397,6 @@ version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2bf50223579dc7cdcfb3bfcacf7069ff68243f8c363f62ffa99cf000a6b9c451"
 
-[[package]]
-name = "num-bigint"
-version = "0.4.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f93ab6289c7b344a8a9f60f88d80aa20032336fe78da341afc91c8a2341fc75f"
-dependencies = [
- "autocfg",
- "num-integer",
- "num-traits",
-]
-
 [[package]]
 name = "num-derive"
 version = "0.3.3"
@@ -1469,28 +1418,6 @@ dependencies = [
  "itoa",
 ]
 
-[[package]]
-name = "num-integer"
-version = "0.1.45"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "225d3389fb3509a24c93f5c29eb6bde2586b98d9f016636dff58d7c6f7569cd9"
-dependencies = [
- "autocfg",
- "num-traits",
-]
-
-[[package]]
-name = "num-rational"
-version = "0.4.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0638a1c9d0a3c0914158145bc76cff373a75a627e6ecbfb71cbe6f453a5a19b0"
-dependencies = [
- "autocfg",
- "num-bigint",
- "num-integer",
- "num-traits",
-]
-
 [[package]]
 name = "num-traits"
 version = "0.2.15"
@@ -1510,18 +1437,6 @@ dependencies = [
  "libc",
 ]
 
-[[package]]
-name = "object"
-version = "0.29.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "21158b2c33aa6d4561f1c0a6ea283ca92bc54802a93b263e910746d679a7eb53"
-dependencies = [
- "crc32fast",
- "hashbrown 0.12.3",
- "indexmap",
- "memchr",
-]
-
 [[package]]
 name = "object"
 version = "0.30.4"
@@ -1554,9 +1469,9 @@ checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.5.0"
+version = "3.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5ddb756ca205bd108aee3c62c6d3c994e1df84a59b9d6d4a5ea42ee1fd5a9a28"
+checksum = "dd8e946cc0cc711189c0b0249fb8b599cbeeab9784d83c415719368bb8d4ac64"
 dependencies = [
  "arrayvec 0.7.2",
  "bitvec",
@@ -1569,9 +1484,9 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.1.4"
+version = "3.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86b26a931f824dd4eca30b3e43bb4f31cd5f0d3a403c5f5ff27106b805bfde7b"
+checksum = "2a296c3079b5fefbc499e1de58dc26c09b1b9a5952d26694ee89f04a43ebbb3e"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -1579,12 +1494,6 @@ dependencies = [
  "syn 1.0.109",
 ]
 
-[[package]]
-name = "parity-wasm"
-version = "0.45.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e1ad0aff30c1da14b1254fcb2af73e1fa9a28670e584a626f53a369d0e157304"
-
 [[package]]
 name = "parking_lot"
 version = "0.12.1"
@@ -1700,9 +1609,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.63"
+version = "1.0.66"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7b368fba921b0dce7e60f5e04ec15e565b3303972b42bcfde1d0713b881959eb"
+checksum = "18fb31db3f9bddb2ea821cde30a9f70117e3f119938b5ee630b7403aa6e2ead9"
 dependencies = [
  "unicode-ident",
 ]
@@ -1750,9 +1659,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.28"
+version = "1.0.33"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b9ab9c7eadfd8df19006f1cf1a4aed13540ed5cbc047010ece5826e10825488"
+checksum = "5267fca4496028628a95160fc423a33e8b2e6af8a5302579e322e4b520293cae"
 dependencies = [
  "proc-macro2",
 ]
@@ -2099,9 +2008,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.164"
+version = "1.0.179"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9e8c8cf938e98f769bc164923b06dce91cea1751522f46f8466461af04c9027d"
+checksum = "0a5bf42b8d227d4abf38a1ddb08602e229108a517cd4e5bb28f9c7eaafdce5c0"
 dependencies = [
  "serde_derive",
 ]
@@ -2117,9 +2026,9 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.164"
+version = "1.0.179"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d9735b638ccc51c28bf6914d90a2e9725b377144fc612c49a611fddd1b631d68"
+checksum = "741e124f5485c7e60c03b043f79f320bff3527f4bbf12cf3831750dc46a0ec2c"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2232,82 +2141,38 @@ checksum = "a507befe795404456341dfab10cef66ead4c041f62b8b11bbb92bffe5d0953e0"
 
 [[package]]
 name = "sp-application-crypto"
-version = "22.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8cf23435a4bbd6eeec2bbbc346719ba4f3200e0ddb5f9e9f06c1724db03a8410"
+checksum = "6b49d62089ef6fdd52a6f90f670d533ccb365235258cf517dbd5bd571febcfbd"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
  "serde",
- "sp-core 20.0.0",
+ "sp-core",
  "sp-io",
- "sp-std 7.0.0",
+ "sp-std 9.0.0",
 ]
 
 [[package]]
 name = "sp-arithmetic"
-version = "15.0.0"
+version = "17.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2c3d3507a803e8bc332fa290ed3015a7b51d4436ce2b836744642fc412040456"
+checksum = "0241327405688cac3fcc29114fd35f99224e321daa37e19920e50e4b2fdd0645"
 dependencies = [
  "integer-sqrt",
  "num-traits",
  "parity-scale-codec",
  "scale-info",
  "serde",
- "sp-std 7.0.0",
+ "sp-std 9.0.0",
  "static_assertions",
 ]
 
 [[package]]
 name = "sp-core"
-version = "20.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7789372146f8ad40d0b40fad0596cb1db5771187a258eabe19b06f00767fcbd6"
-dependencies = [
- "array-bytes",
- "bitflags",
- "blake2",
- "bounded-collections",
- "bs58",
- "dyn-clonable",
- "ed25519-zebra",
- "futures",
- "hash-db",
- "hash256-std-hasher",
- "impl-serde",
- "lazy_static",
- "libsecp256k1",
- "log",
- "merlin",
- "parity-scale-codec",
- "parking_lot",
- "primitive-types",
- "rand 0.8.5",
- "regex",
- "scale-info",
- "schnorrkel",
- "secp256k1",
- "secrecy",
- "serde",
- "sp-core-hashing 8.0.0",
- "sp-debug-derive 7.0.0",
- "sp-externalities 0.18.0",
- "sp-runtime-interface 16.0.0",
- "sp-std 7.0.0",
- "sp-storage 12.0.0",
- "ss58-registry",
- "substrate-bip39",
- "thiserror",
- "tiny-bip39",
- "zeroize",
-]
-
-[[package]]
-name = "sp-core"
-version = "21.0.0"
+version = "22.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f18d9e2f67d8661f9729f35347069ac29d92758b59135176799db966947a7336"
+checksum = "d0de478e02efd547693b33ad02515e09933d5b69b7f3036fa890b92e50fd9dfc"
 dependencies = [
  "array-bytes",
  "bitflags",
@@ -2335,65 +2200,39 @@ dependencies = [
  "secp256k1",
  "secrecy",
  "serde",
- "sp-core-hashing 9.0.0",
- "sp-debug-derive 8.0.0",
- "sp-externalities 0.19.0",
- "sp-runtime-interface 17.0.0",
- "sp-std 8.0.0",
- "sp-storage 13.0.0",
+ "sp-core-hashing",
+ "sp-debug-derive",
+ "sp-externalities",
+ "sp-runtime-interface",
+ "sp-std 9.0.0",
+ "sp-storage",
  "ss58-registry",
  "substrate-bip39",
  "thiserror",
  "tiny-bip39",
+ "tracing",
  "zeroize",
 ]
 
 [[package]]
 name = "sp-core-hashing"
-version = "8.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "27449abdfbe41b473e625bce8113745e81d65777dd1d5a8462cf24137930dad8"
-dependencies = [
- "blake2b_simd",
- "byteorder",
- "digest 0.10.7",
- "sha2 0.10.6",
- "sha3",
- "sp-std 7.0.0",
- "twox-hash",
-]
-
-[[package]]
-name = "sp-core-hashing"
-version = "9.0.0"
+version = "10.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2ee599a8399448e65197f9a6cee338ad192e9023e35e31f22382964c3c174c68"
+checksum = "e360755a2706a76886d58776665cad0db793dece3c7d390455b28e8a1efd6285"
 dependencies = [
  "blake2b_simd",
  "byteorder",
  "digest 0.10.7",
  "sha2 0.10.6",
  "sha3",
- "sp-std 8.0.0",
  "twox-hash",
 ]
 
 [[package]]
 name = "sp-debug-derive"
-version = "7.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "62211eed9ef9dac4b9d837c56ccc9f8ee4fc49d9d9b7e6b9daf098fe173389ab"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 1.0.109",
-]
-
-[[package]]
-name = "sp-debug-derive"
-version = "8.0.0"
+version = "9.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c7f531814d2f16995144c74428830ccf7d94ff4a7749632b83ad8199b181140c"
+checksum = "f12dae7cf6c1e825d13ffd4ce16bd9309db7c539929d0302b4443ed451a9f4e5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2402,50 +2241,37 @@ dependencies = [
 
 [[package]]
 name = "sp-externalities"
-version = "0.18.0"
+version = "0.20.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ae0f275760689aaefe967943331d458cd99f5169d18364365d4cb584b246d1c"
+checksum = "3313e2c5f2523b06062e541dff9961bde88ad5a28861621dc7b7b47a32bb0f7c"
 dependencies = [
  "environmental",
  "parity-scale-codec",
- "sp-std 7.0.0",
- "sp-storage 12.0.0",
-]
-
-[[package]]
-name = "sp-externalities"
-version = "0.19.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a0f71c671e01a8ca60da925d43a1b351b69626e268b8837f8371e320cf1dd100"
-dependencies = [
- "environmental",
- "parity-scale-codec",
- "sp-std 8.0.0",
- "sp-storage 13.0.0",
+ "sp-std 9.0.0",
+ "sp-storage",
 ]
 
 [[package]]
 name = "sp-io"
-version = "22.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd3431c245992fe51b8256c838fc2e981f8d3b0afc1d1377ca7dbe0a3287a764"
+checksum = "ff6194309bfe055d93177c6c9d2ed4c7b66040617cf3003a15e509c432cf3b62"
 dependencies = [
  "bytes",
  "ed25519 1.5.3",
  "ed25519-dalek",
- "futures",
  "libsecp256k1",
  "log",
  "parity-scale-codec",
  "rustversion",
  "secp256k1",
- "sp-core 20.0.0",
- "sp-externalities 0.18.0",
+ "sp-core",
+ "sp-externalities",
  "sp-keystore",
- "sp-runtime-interface 16.0.0",
+ "sp-runtime-interface",
  "sp-state-machine",
- "sp-std 7.0.0",
- "sp-tracing 9.0.0",
+ "sp-std 9.0.0",
+ "sp-tracing",
  "sp-trie",
  "tracing",
  "tracing-core",
@@ -2453,25 +2279,22 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.26.0"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "452d079f592c97369c9ca8a5083b25f146751c6b5af10cbcacc2b24dc53fd72a"
+checksum = "6eda1d2572a15340927a9f7db75ffe74366b645eaf9212015b4a96ad8e9d4c46"
 dependencies = [
- "futures",
- "merlin",
  "parity-scale-codec",
  "parking_lot",
- "schnorrkel",
- "sp-core 20.0.0",
- "sp-externalities 0.18.0",
+ "sp-core",
+ "sp-externalities",
  "thiserror",
 ]
 
 [[package]]
 name = "sp-panic-handler"
-version = "7.0.0"
+version = "9.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75986cc917d897e0f6d0c848088064df4c74ccbb8f1c1848700b725f5ca7fe04"
+checksum = "57c67eb0a0d11d3017ef43c975068ba76c7b0e83aca1ee3d68ba0ce270ecebe7"
 dependencies = [
  "backtrace",
  "lazy_static",
@@ -2480,9 +2303,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "23.0.0"
+version = "25.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6220216caa67e3d931c693b06a3590dfcaa255f19bb3c3e3150f1672b8bc53f6"
+checksum = "3d056e4cccf36a45be5d471b47c09e8be91b825f1d8352f20aa01f9f693176e7"
 dependencies = [
  "either",
  "hash256-std-hasher",
@@ -2495,68 +2318,36 @@ dependencies = [
  "serde",
  "sp-application-crypto",
  "sp-arithmetic",
- "sp-core 20.0.0",
+ "sp-core",
  "sp-io",
- "sp-std 7.0.0",
+ "sp-std 9.0.0",
  "sp-weights",
 ]
 
 [[package]]
 name = "sp-runtime-interface"
-version = "16.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca5d0cd80200bf85b8b064238b2508b69b6146b13adf36066ec5d924825af737"
-dependencies = [
- "bytes",
- "impl-trait-for-tuples",
- "parity-scale-codec",
- "primitive-types",
- "sp-externalities 0.18.0",
- "sp-runtime-interface-proc-macro 10.0.0",
- "sp-std 7.0.0",
- "sp-storage 12.0.0",
- "sp-tracing 9.0.0",
- "sp-wasm-interface 13.0.0",
- "static_assertions",
-]
-
-[[package]]
-name = "sp-runtime-interface"
-version = "17.0.0"
+version = "18.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6e676128182f90015e916f806cba635c8141e341e7abbc45d25525472e1bbce8"
+checksum = "bf9781c72848efe6750116eb96edaeb105ee7e0bd7f38a4e46371bf810b3db7b"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
  "parity-scale-codec",
  "primitive-types",
- "sp-externalities 0.19.0",
- "sp-runtime-interface-proc-macro 11.0.0",
- "sp-std 8.0.0",
- "sp-storage 13.0.0",
- "sp-tracing 10.0.0",
- "sp-wasm-interface 14.0.0",
+ "sp-externalities",
+ "sp-runtime-interface-proc-macro",
+ "sp-std 9.0.0",
+ "sp-storage",
+ "sp-tracing",
+ "sp-wasm-interface",
  "static_assertions",
 ]
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "10.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "05ae5b00aef477127ddb6177b3464ad1e2bdcc12ee913fc5dfc9d065c6cea89b"
-dependencies = [
- "Inflector",
- "proc-macro-crate 1.3.1",
- "proc-macro2",
- "quote",
- "syn 1.0.109",
-]
-
-[[package]]
-name = "sp-runtime-interface-proc-macro"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a5d5bd5566fe5633ec48dfa35ab152fd29f8a577c21971e1c6db9f28afb9bbb9"
+checksum = "7402572a08aa1ae421ea5bab10918764b0ae72301b27710913e5d804862f2448"
 dependencies = [
  "Inflector",
  "proc-macro-crate 1.3.1",
@@ -2567,9 +2358,9 @@ dependencies = [
 
 [[package]]
 name = "sp-state-machine"
-version = "0.27.0"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1e49c3bfcc8c832c34552cd8194180cc60508c6d3d9b0b9615d6b7c3e275019"
+checksum = "f2e84d8ed3acc6aed5a3d5cfd500fb5b99c1e299c86086b2fe82c3e4be93178f"
 dependencies = [
  "hash-db",
  "log",
@@ -2577,13 +2368,14 @@ dependencies = [
  "parking_lot",
  "rand 0.8.5",
  "smallvec",
- "sp-core 20.0.0",
- "sp-externalities 0.18.0",
+ "sp-core",
+ "sp-externalities",
  "sp-panic-handler",
- "sp-std 7.0.0",
+ "sp-std 9.0.0",
  "sp-trie",
  "thiserror",
  "tracing",
+ "trie-db",
 ]
 
 [[package]]
@@ -2594,59 +2386,32 @@ checksum = "1de8eef39962b5b97478719c493bed2926cf70cb621005bbf68ebe58252ff986"
 
 [[package]]
 name = "sp-std"
-version = "8.0.0"
+version = "9.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53458e3c57df53698b3401ec0934bea8e8cfce034816873c0b0abbd83d7bac0d"
+checksum = "2d5bbc9339227d1b6a9b7ccd9b2920c818653d40eef1512f1e2e824d72e7a336"
 
 [[package]]
 name = "sp-storage"
-version = "12.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ad1f8c52d4700ac7bc42b3375679a6c6fc1fe876f4b40c6efdf36f933ef0291"
-dependencies = [
- "impl-serde",
- "parity-scale-codec",
- "ref-cast",
- "serde",
- "sp-debug-derive 7.0.0",
- "sp-std 7.0.0",
-]
-
-[[package]]
-name = "sp-storage"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "94294be83f11d4958cfea89ed5798f0b6605f5defc3a996948848458abbcc18e"
+checksum = "a21245c3a7799ff6d3f1f159b496f9ac72eb32cd6fe68c6f73013155289aa9f1"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
  "ref-cast",
  "serde",
- "sp-debug-derive 8.0.0",
- "sp-std 8.0.0",
-]
-
-[[package]]
-name = "sp-tracing"
-version = "9.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "00fab60bf3d42255ce3f678903d3a2564662371c75623de4a1ffc7cac46143df"
-dependencies = [
- "parity-scale-codec",
- "sp-std 7.0.0",
- "tracing",
- "tracing-core",
- "tracing-subscriber",
+ "sp-debug-derive",
+ "sp-std 9.0.0",
 ]
 
 [[package]]
 name = "sp-tracing"
-version = "10.0.0"
+version = "11.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "357f7591980dd58305956d32f8f6646d0a8ea9ea0e7e868e46f53b68ddf00cec"
+checksum = "6f5ba26db1f7513d5975970d1ba1f0580d7a1b8da8c86ea3f9f0f8dbe2cfa96e"
 dependencies = [
  "parity-scale-codec",
- "sp-std 8.0.0",
+ "sp-std 9.0.0",
  "tracing",
  "tracing-core",
  "tracing-subscriber",
@@ -2654,9 +2419,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "21.0.0"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "58401c53c08b6ecad83acd7e14534c8bbcb3fa73e81e26685e0ac70e51b00c56"
+checksum = "bf63ea90ffb5d61048d8fb2fac669114dac198fc2739e913e615f0fd2c36c3e7"
 dependencies = [
  "ahash 0.8.3",
  "hash-db",
@@ -2668,8 +2433,8 @@ dependencies = [
  "parking_lot",
  "scale-info",
  "schnellru",
- "sp-core 20.0.0",
- "sp-std 7.0.0",
+ "sp-core",
+ "sp-std 9.0.0",
  "thiserror",
  "tracing",
  "trie-db",
@@ -2678,47 +2443,32 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "13.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "153b7374179439e2aa783c66ed439bd86920c67bbc95d34c76390561972bc02f"
-dependencies = [
- "anyhow",
- "impl-trait-for-tuples",
- "log",
- "parity-scale-codec",
- "sp-std 7.0.0",
- "wasmi",
- "wasmtime 6.0.2",
-]
-
-[[package]]
-name = "sp-wasm-interface"
-version = "14.0.0"
+version = "15.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a19c122609ca5d8246be6386888596320d03c7bc880959eaa2c36bcd5acd6846"
+checksum = "d07945f592d2792632e6f030108769757e928a0fd78cf8659c9c210a5e341e55"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
  "log",
  "parity-scale-codec",
- "sp-std 8.0.0",
- "wasmtime 8.0.1",
+ "sp-std 9.0.0",
+ "wasmtime",
 ]
 
 [[package]]
 name = "sp-weights"
-version = "19.0.0"
+version = "21.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "123c661915e1bf328e21f8ecbe4e5247feba86f9149b782ea4348004547ce8ef"
+checksum = "0b7699b853471c2eb5dc06ea1d8ea847bfa1415371218ebb4c86325c9d0232bc"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
  "serde",
  "smallvec",
  "sp-arithmetic",
- "sp-core 20.0.0",
- "sp-debug-derive 7.0.0",
- "sp-std 7.0.0",
+ "sp-core",
+ "sp-debug-derive",
+ "sp-std 9.0.0",
 ]
 
 [[package]]
@@ -2834,9 +2584,9 @@ checksum = "fd1ba337640d60c3e96bc6f0638a939b9c9a7f2c316a1598c279828b3d1dc8c5"
 
 [[package]]
 name = "tendermint"
-version = "0.32.0"
+version = "0.33.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a46ec6b25b028097ab682ffae11d09d64fe1e2535833b902f26a278a0f88a705"
+checksum = "f6d550db02d6bec4ebcbbebc4301ec22181bc489c37fb3f167e64b14c1be8321"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -2863,9 +2613,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.32.0"
+version = "0.33.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4bc4c47cf36e740645e04128bd14ff5723aef86f5377fbd4d3b0149198dfc7e"
+checksum = "6bc1e4e3dd6f65cfa7979cf721b5afa1d79d32c4a2fe5fddb6416a98638634a9"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -2876,9 +2626,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.32.0"
+version = "0.33.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6ce23c8ff0e6634eb4c3c4aeed45076dc97dac91aac5501a905a67fa222e165b"
+checksum = "1834fa2eb884ba69b9c0eea55f0178270bed421217596ca4e54c19ef75dcb660"
 dependencies = [
  "bytes",
  "flex-error",
@@ -3251,49 +3001,6 @@ version = "0.2.86"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ed9d5b4305409d1fc9482fee2d7f9bcbf24b3972bf59817ef757e23982242a93"
 
-[[package]]
-name = "wasmi"
-version = "0.13.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "06c326c93fbf86419608361a2c925a31754cf109da1b8b55737070b4d6669422"
-dependencies = [
- "parity-wasm",
- "wasmi-validation",
- "wasmi_core",
-]
-
-[[package]]
-name = "wasmi-validation"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91ff416ad1ff0c42e5a926ed5d5fab74c0f098749aa0ad8b2a34b982ce0e867b"
-dependencies = [
- "parity-wasm",
-]
-
-[[package]]
-name = "wasmi_core"
-version = "0.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57d20cb3c59b788653d99541c646c561c9dd26506f25c0cebfe810659c54c6d7"
-dependencies = [
- "downcast-rs",
- "libm",
- "memory_units",
- "num-rational",
- "num-traits",
-]
-
-[[package]]
-name = "wasmparser"
-version = "0.100.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "64b20236ab624147dfbb62cf12a19aaf66af0e41b8398838b66e997d07d269d4"
-dependencies = [
- "indexmap",
- "url",
-]
-
 [[package]]
 name = "wasmparser"
 version = "0.102.0"
@@ -3304,31 +3011,6 @@ dependencies = [
  "url",
 ]
 
-[[package]]
-name = "wasmtime"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "76a222f5fa1e14b2cefc286f1b68494d7a965f4bf57ec04c59bb62673d639af6"
-dependencies = [
- "anyhow",
- "bincode",
- "cfg-if",
- "indexmap",
- "libc",
- "log",
- "object 0.29.0",
- "once_cell",
- "paste",
- "psm",
- "serde",
- "target-lexicon",
- "wasmparser 0.100.0",
- "wasmtime-environ 6.0.2",
- "wasmtime-jit 6.0.2",
- "wasmtime-runtime 6.0.2",
- "windows-sys 0.42.0",
-]
-
 [[package]]
 name = "wasmtime"
 version = "8.0.1"
@@ -3341,28 +3023,19 @@ dependencies = [
  "indexmap",
  "libc",
  "log",
- "object 0.30.4",
+ "object",
  "once_cell",
  "paste",
  "psm",
  "serde",
  "target-lexicon",
- "wasmparser 0.102.0",
- "wasmtime-environ 8.0.1",
- "wasmtime-jit 8.0.1",
- "wasmtime-runtime 8.0.1",
+ "wasmparser",
+ "wasmtime-environ",
+ "wasmtime-jit",
+ "wasmtime-runtime",
  "windows-sys 0.45.0",
 ]
 
-[[package]]
-name = "wasmtime-asm-macros"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4407a7246e7d2f3d8fb1cf0c72fda8dbafdb6dd34d555ae8bea0e5ae031089cc"
-dependencies = [
- "cfg-if",
-]
-
 [[package]]
 name = "wasmtime-asm-macros"
 version = "8.0.1"
@@ -3372,25 +3045,6 @@ dependencies = [
  "cfg-if",
 ]
 
-[[package]]
-name = "wasmtime-environ"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "47b8b50962eae38ee319f7b24900b7cf371f03eebdc17400c1dc8575fc10c9a7"
-dependencies = [
- "anyhow",
- "cranelift-entity 0.93.2",
- "gimli 0.26.2",
- "indexmap",
- "log",
- "object 0.29.0",
- "serde",
- "target-lexicon",
- "thiserror",
- "wasmparser 0.100.0",
- "wasmtime-types 6.0.2",
-]
-
 [[package]]
 name = "wasmtime-environ"
 version = "8.0.1"
@@ -3398,39 +3052,16 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a990198cee4197423045235bf89d3359e69bd2ea031005f4c2d901125955c949"
 dependencies = [
  "anyhow",
- "cranelift-entity 0.95.1",
- "gimli 0.27.2",
+ "cranelift-entity",
+ "gimli",
  "indexmap",
  "log",
- "object 0.30.4",
+ "object",
  "serde",
  "target-lexicon",
  "thiserror",
- "wasmparser 0.102.0",
- "wasmtime-types 8.0.1",
-]
-
-[[package]]
-name = "wasmtime-jit"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ffaed4f9a234ba5225d8e64eac7b4a5d13b994aeb37353cde2cbeb3febda9eaa"
-dependencies = [
- "addr2line 0.17.0",
- "anyhow",
- "bincode",
- "cfg-if",
- "cpp_demangle",
- "gimli 0.26.2",
- "log",
- "object 0.29.0",
- "rustc-demangle",
- "serde",
- "target-lexicon",
- "wasmtime-environ 6.0.2",
- "wasmtime-jit-icache-coherence 6.0.2",
- "wasmtime-runtime 6.0.2",
- "windows-sys 0.42.0",
+ "wasmparser",
+ "wasmtime-types",
 ]
 
 [[package]]
@@ -3439,32 +3070,23 @@ version = "8.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0de48df552cfca1c9b750002d3e07b45772dd033b0b206d5c0968496abf31244"
 dependencies = [
- "addr2line 0.19.0",
+ "addr2line",
  "anyhow",
  "bincode",
  "cfg-if",
  "cpp_demangle",
- "gimli 0.27.2",
+ "gimli",
  "log",
- "object 0.30.4",
+ "object",
  "rustc-demangle",
  "serde",
  "target-lexicon",
- "wasmtime-environ 8.0.1",
- "wasmtime-jit-icache-coherence 8.0.1",
- "wasmtime-runtime 8.0.1",
+ "wasmtime-environ",
+ "wasmtime-jit-icache-coherence",
+ "wasmtime-runtime",
  "windows-sys 0.45.0",
 ]
 
-[[package]]
-name = "wasmtime-jit-debug"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eed41cbcbf74ce3ff6f1d07d1b707888166dc408d1a880f651268f4f7c9194b2"
-dependencies = [
- "once_cell",
-]
-
 [[package]]
 name = "wasmtime-jit-debug"
 version = "8.0.1"
@@ -3474,17 +3096,6 @@ dependencies = [
  "once_cell",
 ]
 
-[[package]]
-name = "wasmtime-jit-icache-coherence"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43a28ae1e648461bfdbb79db3efdaee1bca5b940872e4175390f465593a2e54c"
-dependencies = [
- "cfg-if",
- "libc",
- "windows-sys 0.42.0",
-]
-
 [[package]]
 name = "wasmtime-jit-icache-coherence"
 version = "8.0.1"
@@ -3496,30 +3107,6 @@ dependencies = [
  "windows-sys 0.45.0",
 ]
 
-[[package]]
-name = "wasmtime-runtime"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e704b126e4252788ccfc3526d4d4511d4b23c521bf123e447ac726c14545217b"
-dependencies = [
- "anyhow",
- "cc",
- "cfg-if",
- "indexmap",
- "libc",
- "log",
- "mach",
- "memfd",
- "memoffset 0.6.5",
- "paste",
- "rand 0.8.5",
- "rustix 0.36.14",
- "wasmtime-asm-macros 6.0.2",
- "wasmtime-environ 6.0.2",
- "wasmtime-jit-debug 6.0.2",
- "windows-sys 0.42.0",
-]
-
 [[package]]
 name = "wasmtime-runtime"
 version = "8.0.1"
@@ -3534,38 +3121,26 @@ dependencies = [
  "log",
  "mach",
  "memfd",
- "memoffset 0.8.0",
+ "memoffset",
  "paste",
  "rand 0.8.5",
  "rustix 0.36.14",
- "wasmtime-asm-macros 8.0.1",
- "wasmtime-environ 8.0.1",
- "wasmtime-jit-debug 8.0.1",
+ "wasmtime-asm-macros",
+ "wasmtime-environ",
+ "wasmtime-jit-debug",
  "windows-sys 0.45.0",
 ]
 
-[[package]]
-name = "wasmtime-types"
-version = "6.0.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83e5572c5727c1ee7e8f28717aaa8400e4d22dcbd714ea5457d85b5005206568"
-dependencies = [
- "cranelift-entity 0.93.2",
- "serde",
- "thiserror",
- "wasmparser 0.100.0",
-]
-
 [[package]]
 name = "wasmtime-types"
 version = "8.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a4f6fffd2a1011887d57f07654dd112791e872e3ff4a2e626aee8059ee17f06f"
 dependencies = [
- "cranelift-entity 0.95.1",
+ "cranelift-entity",
  "serde",
  "thiserror",
- "wasmparser 0.102.0",
+ "wasmparser",
 ]
 
 [[package]]
@@ -3599,21 +3174,6 @@ dependencies = [
  "windows-targets 0.48.0",
 ]
 
-[[package]]
-name = "windows-sys"
-version = "0.42.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a3e1820f08b8513f676f7ab6c1f99ff312fb97b553d30ff4dd86f9f15728aa7"
-dependencies = [
- "windows_aarch64_gnullvm 0.42.2",
- "windows_aarch64_msvc 0.42.2",
- "windows_i686_gnu 0.42.2",
- "windows_i686_msvc 0.42.2",
- "windows_x86_64_gnu 0.42.2",
- "windows_x86_64_gnullvm 0.42.2",
- "windows_x86_64_msvc 0.42.2",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.45.0"
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 51a50fb51..691df2bae 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -5,10 +5,11 @@ edition = "2021"
 resolver = "2"
 
 [dependencies]
-ibc = { path = "../../crates/ibc", default-features = false }
-ibc-proto = { version = "0.33.0", default-features = false, features = [
+ibc = { path = "../../crates/ibc", default-features = false, features = ["serde"] }
+ibc-proto = { version = "0.34.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
+  "serde",
 ] }
 tendermint = { version = "0.33.0", default-features = false }
 tendermint-proto = { version = "0.33.0", default-features = false }
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 48b589378..12291754b 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,7 +50,7 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.33.0", default-features = false }
+ibc-proto = { version = "0.34.0", default-features = false, features = ["serde"] }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
 time = { version = ">=0.3.0, <0.3.26", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
diff --git a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
index fa5f5fd51..d81a47621 100644
--- a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
@@ -74,7 +74,7 @@ impl Protobuf<RawMisbehaviour> for Misbehaviour {}
 
 impl TryFrom<RawMisbehaviour> for Misbehaviour {
     type Error = Error;
-
+    #[allow(deprecated)]
     fn try_from(raw: RawMisbehaviour) -> Result<Self, Self::Error> {
         let client_id = raw.client_id.parse()?;
 
@@ -98,6 +98,7 @@ impl TryFrom<RawMisbehaviour> for Misbehaviour {
 
 impl From<Misbehaviour> for RawMisbehaviour {
     fn from(value: Misbehaviour) -> Self {
+        #[allow(deprecated)]
         RawMisbehaviour {
             client_id: value.client_id.to_string(),
             header_1: Some(value.header1.into()),
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 027723b90..faa3216a6 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -421,7 +421,7 @@ mod tests {
                 name: "Client update successful".to_string(),
                 msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
                     client_id: client_id.clone(),
-                    header: MockHeader::new(update_client_height)
+                    client_message: MockHeader::new(update_client_height)
                         .with_timestamp(Timestamp::now())
                         .into(),
                     signer: default_signer.clone(),
@@ -434,7 +434,7 @@ mod tests {
                 name: "Client update fails due to stale header".to_string(),
                 msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
                     client_id: client_id.clone(),
-                    header: MockHeader::new(update_client_height).into(),
+                    client_message: MockHeader::new(update_client_height).into(),
                     signer: default_signer.clone(),
                 }))
                 .into(),
@@ -509,7 +509,7 @@ mod tests {
                 name: "Client update successful #2".to_string(),
                 msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
                     client_id: client_id.clone(),
-                    header: MockHeader::new(update_client_height_after_send)
+                    client_message: MockHeader::new(update_client_height_after_send)
                         .with_timestamp(Timestamp::now())
                         .into(),
                     signer: default_signer.clone(),
@@ -554,7 +554,7 @@ mod tests {
                 name: "Client update successful".to_string(),
                 msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
                     client_id: client_id.clone(),
-                    header: MockHeader::new(update_client_height_after_second_send).into(),
+                    client_message: MockHeader::new(update_client_height_after_second_send).into(),
                     signer: default_signer,
                 }))
                 .into(),
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index 2ee0b4831..826341c34 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -67,8 +67,8 @@ pub enum ClientError {
     InvalidClientIdentifier(IdentifierError),
     /// invalid raw header error: `{0}`
     InvalidRawHeader(TendermintProtoError),
-    /// missing raw header
-    MissingRawHeader,
+    /// missing raw client message
+    MissingClientMessage,
     /// invalid raw misbehaviour error: `{0}`
     InvalidRawMisbehaviour(IdentifierError),
     /// missing raw misbehaviour
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index cad4bde1d..d0e2e0712 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -174,7 +174,7 @@ mod tests {
         let height = Height::new(0, 46).unwrap();
         let msg = MsgUpdateClient {
             client_id,
-            header: MockHeader::new(height).with_timestamp(timestamp).into(),
+            client_message: MockHeader::new(height).with_timestamp(timestamp).into(),
             signer,
         };
 
@@ -200,7 +200,7 @@ mod tests {
 
         let msg = MsgUpdateClient {
             client_id: ClientId::from_str("nonexistingclient").unwrap(),
-            header: MockHeader::new(Height::new(0, 46).unwrap()).into(),
+            client_message: MockHeader::new(Height::new(0, 46).unwrap()).into(),
             signer,
         };
 
@@ -240,7 +240,7 @@ mod tests {
         let latest_header_height = block.height();
         let msg = MsgUpdateClient {
             client_id,
-            header: block.into(),
+            client_message: block.into(),
             signer,
         };
 
@@ -290,7 +290,7 @@ mod tests {
         let latest_header_height = block.height();
         let msg = MsgUpdateClient {
             client_id,
-            header: block.into(),
+            client_message: block.into(),
             signer,
         };
 
@@ -411,7 +411,7 @@ mod tests {
         let latest_header_height = block.height();
         let msg = MsgUpdateClient {
             client_id,
-            header: block.into(),
+            client_message: block.into(),
             signer,
         };
 
@@ -468,7 +468,7 @@ mod tests {
 
         let msg = MsgUpdateClient {
             client_id,
-            header: block_ref.clone().into(),
+            client_message: block_ref.clone().into(),
             signer,
         };
 
@@ -488,7 +488,7 @@ mod tests {
         let header: Any = MockHeader::new(height).with_timestamp(timestamp).into();
         let msg = MsgUpdateClient {
             client_id: client_id.clone(),
-            header: header.clone(),
+            client_message: header.clone(),
             signer,
         };
 
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/crates/ibc/src/core/ics02_client/msgs.rs
index 87f81fde0..9bb0375a8 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/crates/ibc/src/core/ics02_client/msgs.rs
@@ -39,7 +39,7 @@ impl MsgUpdateOrMisbehaviour {
 
     pub(crate) fn client_message(self) -> Any {
         match self {
-            MsgUpdateOrMisbehaviour::UpdateClient(msg) => msg.header,
+            MsgUpdateOrMisbehaviour::UpdateClient(msg) => msg.client_message,
             MsgUpdateOrMisbehaviour::Misbehaviour(msg) => msg.misbehaviour,
         }
     }
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 8597f106c..3adfa716f 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -20,7 +20,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpdateClient {
     pub client_id: ClientId,
-    pub header: Any,
+    pub client_message: Any,
     pub signer: Signer,
 }
 
@@ -43,7 +43,9 @@ impl TryFrom<RawMsgUpdateClient> for MsgUpdateClient {
                 .client_id
                 .parse()
                 .map_err(ClientError::InvalidMsgUpdateClientId)?,
-            header: raw.header.ok_or(ClientError::MissingRawHeader)?,
+            client_message: raw
+                .client_message
+                .ok_or(ClientError::MissingClientMessage)?,
             signer: raw.signer.into(),
         })
     }
@@ -53,7 +55,7 @@ impl From<MsgUpdateClient> for RawMsgUpdateClient {
     fn from(ics_msg: MsgUpdateClient) -> Self {
         RawMsgUpdateClient {
             client_id: ics_msg.client_id.to_string(),
-            header: Some(ics_msg.header),
+            client_message: Some(ics_msg.client_message),
             signer: ics_msg.signer.to_string(),
         }
     }
@@ -75,10 +77,10 @@ mod tests {
     use crate::test_utils::get_dummy_account_id;
 
     impl MsgUpdateClient {
-        pub fn new(client_id: ClientId, header: Any, signer: Signer) -> Self {
+        pub fn new(client_id: ClientId, client_message: Any, signer: Signer) -> Self {
             MsgUpdateClient {
                 client_id,
-                header,
+                client_message,
                 signer,
             }
         }
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index 1f674c499..ad5613d13 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -36,6 +36,9 @@ pub struct MsgConnectionOpenAck {
     pub consensus_height_of_a_on_b: Height,
     pub version: Version,
     pub signer: Signer,
+    /// optional proof of host state machines (chain A) that are unable to
+    /// introspect their own consensus state
+    pub proof_consensus_state_of_a: Option<CommitmentProofBytes>,
 }
 
 impl Msg for MsgConnectionOpenAck {
@@ -89,6 +92,15 @@ impl TryFrom<RawMsgConnectionOpenAck> for MsgConnectionOpenAck {
                 .and_then(|raw_height| raw_height.try_into().ok())
                 .ok_or(ConnectionError::MissingConsensusHeight)?,
             signer: msg.signer.into(),
+            proof_consensus_state_of_a: if msg.host_consensus_state_proof.is_empty() {
+                None
+            } else {
+                Some(
+                    msg.host_consensus_state_proof
+                        .try_into()
+                        .map_err(|_| ConnectionError::InvalidProof)?,
+                )
+            },
         })
     }
 }
@@ -106,6 +118,10 @@ impl From<MsgConnectionOpenAck> for RawMsgConnectionOpenAck {
             consensus_height: Some(msg.consensus_height_of_a_on_b.into()),
             version: Some(msg.version.into()),
             signer: msg.signer.to_string(),
+            host_consensus_state_proof: match msg.proof_consensus_state_of_a {
+                Some(proof) => proof.into(),
+                None => vec![],
+            },
         }
     }
 }
@@ -159,6 +175,7 @@ pub mod test_util {
             proof_client: get_dummy_proof(),
             version: Some(Version::default().into()),
             signer: get_dummy_bech32_account(),
+            host_consensus_state_proof: vec![],
         }
     }
 }
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index 075ca9122..264aff846 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -44,6 +44,9 @@ pub struct MsgConnectionOpenTry {
     pub consensus_height_of_b_on_a: Height,
     pub delay_period: Duration,
     pub signer: Signer,
+    /// optional proof of host state machines (chain B) that are unable to
+    /// introspect their own consensus state
+    pub proof_consensus_state_of_b: Option<CommitmentProofBytes>,
 
     #[deprecated(since = "0.22.0")]
     /// Only kept here for proper conversion to/from the raw type
@@ -113,6 +116,15 @@ impl TryFrom<RawMsgConnectionOpenTry> for MsgConnectionOpenTry {
                 .ok_or(ConnectionError::MissingConsensusHeight)?,
             delay_period: Duration::from_nanos(msg.delay_period),
             signer: msg.signer.into(),
+            proof_consensus_state_of_b: if msg.host_consensus_state_proof.is_empty() {
+                None
+            } else {
+                Some(
+                    msg.host_consensus_state_proof
+                        .try_into()
+                        .map_err(|_| ConnectionError::InvalidProof)?,
+                )
+            },
         })
     }
 }
@@ -133,6 +145,10 @@ impl From<MsgConnectionOpenTry> for RawMsgConnectionOpenTry {
             proof_consensus: msg.proof_consensus_state_of_b_on_a.into(),
             consensus_height: Some(msg.consensus_height_of_b_on_a.into()),
             signer: msg.signer.to_string(),
+            host_consensus_state_proof: match msg.proof_consensus_state_of_b {
+                Some(proof) => proof.into(),
+                None => vec![],
+            },
         }
     }
 }
@@ -204,6 +220,7 @@ pub mod test_util {
             }),
             proof_client: get_dummy_proof(),
             signer: get_dummy_bech32_account(),
+            host_consensus_state_proof: vec![],
         }
     }
 }
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
index 9b6026f5c..53437d780 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
@@ -1,8 +1,5 @@
-use core::convert::Infallible;
-
 use alloc::string::ToString;
 use tendermint::abci::Event as TmEvent;
-use tendermint_proto::abci::Event as ProtoEvent;
 
 use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
 use crate::core::ics02_client::error::UpgradeClientError;
@@ -19,7 +16,7 @@ use crate::hosts::tendermint::upgrade_proposal::UpgradeProposal;
 pub fn upgrade_client_proposal_handler<Ctx>(
     ctx: &mut Ctx,
     proposal: UpgradeProposal,
-) -> Result<ProtoEvent, UpgradeClientError>
+) -> Result<TmEvent, UpgradeClientError>
 where
     Ctx: UpgradeExecutionContext,
     Ctx::AnyClientState: From<TmClientState>,
@@ -45,11 +42,7 @@ where
 
     ctx.store_upgraded_client_state(upgraded_client_state_path, client_state.into())?;
 
-    let event = TmEvent::from(UpgradeClientProposal::new(proposal.title, plan.height))
-        .try_into()
-        .map_err(|e: Infallible| UpgradeClientError::Other {
-            reason: e.to_string(),
-        })?;
+    let event = TmEvent::from(UpgradeClientProposal::new(proposal.title, plan.height));
 
     Ok(event)
 }
diff --git a/crates/ibc/src/mock/header.rs b/crates/ibc/src/mock/header.rs
index fa459d193..46ce0a785 100644
--- a/crates/ibc/src/mock/header.rs
+++ b/crates/ibc/src/mock/header.rs
@@ -47,7 +47,7 @@ impl TryFrom<RawMockHeader> for MockHeader {
             height: raw
                 .height
                 .and_then(|raw_height| raw_height.try_into().ok())
-                .ok_or(ClientError::MissingRawHeader)?,
+                .ok_or(ClientError::MissingClientMessage)?,
 
             timestamp: Timestamp::from_nanoseconds(raw.timestamp)
                 .map_err(ClientError::InvalidPacketTimestamp)?,
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc/src/mock/ics18_relayer/context.rs
index 73b9b3f3b..69e252c10 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc/src/mock/ics18_relayer/context.rs
@@ -82,7 +82,7 @@ mod tests {
         // Client on destination chain can be updated.
         Ok(ClientMsg::UpdateClient(MsgUpdateClient {
             client_id: client_id.clone(),
-            header: (*src_header).clone().into(),
+            client_message: (*src_header).clone().into(),
             signer: dest.signer(),
         }))
     }

From 56e7e62110501becb42e1bf91946605cca451b12 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Tue, 29 Aug 2023 16:21:23 -0400
Subject: [PATCH 020/182] bump ibc-proto to v0.34.1 and borsh to v0.10 (#844)

* bump ibc-proto and borsh

* changelog
---
 .changelog/unreleased/improvements/844-bump-borsh.md | 2 ++
 crates/ibc/Cargo.toml                                | 4 ++--
 crates/ibc/src/core/ics03_connection/connection.rs   | 6 ++++--
 crates/ibc/src/core/timestamp.rs                     | 6 ++++--
 4 files changed, 12 insertions(+), 6 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/844-bump-borsh.md

diff --git a/.changelog/unreleased/improvements/844-bump-borsh.md b/.changelog/unreleased/improvements/844-bump-borsh.md
new file mode 100644
index 000000000..de58be506
--- /dev/null
+++ b/.changelog/unreleased/improvements/844-bump-borsh.md
@@ -0,0 +1,2 @@
+- Bump ibc-proto to v0.34.1 and borsh to v0.10
+  ([#844](https://github.com/cosmos/ibc-rs/issues/844))
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 12291754b..ef9d36fb9 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,7 +50,7 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.34.0", default-features = false, features = ["serde"] }
+ibc-proto = { version = "0.34.1", default-features = false, features = ["serde"] }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
 time = { version = ">=0.3.0, <0.3.26", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
@@ -72,7 +72,7 @@ primitive-types = { version = "0.12.0", default-features = false, features = ["s
 parity-scale-codec = { version = "3.0.0", default-features = false, features = ["full"], optional = true }
 scale-info = { version = "2.1.2", default-features = false, features = ["derive"], optional = true }
 ## for borsh encode or decode
-borsh = {version = "0.9.0", default-features = false, optional = true }
+borsh = {version = "0.10", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
 
 ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/crates/ibc/src/core/ics03_connection/connection.rs
index e70ae400c..6ab1513ec 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/crates/ibc/src/core/ics03_connection/connection.rs
@@ -167,8 +167,10 @@ mod sealed {
 
     #[cfg(feature = "borsh")]
     impl borsh::BorshDeserialize for ConnectionEnd {
-        fn deserialize(reader: &mut &[u8]) -> borsh::maybestd::io::Result<Self> {
-            let inner_conn_end = InnerConnectionEnd::deserialize(reader)?;
+        fn deserialize_reader<R: borsh::maybestd::io::Read>(
+            reader: &mut R,
+        ) -> borsh::maybestd::io::Result<Self> {
+            let inner_conn_end = InnerConnectionEnd::deserialize_reader(reader)?;
             Ok(ConnectionEnd::from(inner_conn_end))
         }
     }
diff --git a/crates/ibc/src/core/timestamp.rs b/crates/ibc/src/core/timestamp.rs
index 510af94ee..e0c6079fb 100644
--- a/crates/ibc/src/core/timestamp.rs
+++ b/crates/ibc/src/core/timestamp.rs
@@ -41,8 +41,10 @@ impl borsh::BorshSerialize for Timestamp {
 
 #[cfg(feature = "borsh")]
 impl borsh::BorshDeserialize for Timestamp {
-    fn deserialize(reader: &mut &[u8]) -> borsh::maybestd::io::Result<Self> {
-        let timestamp = u64::deserialize(reader)?;
+    fn deserialize_reader<R: borsh::maybestd::io::Read>(
+        reader: &mut R,
+    ) -> borsh::maybestd::io::Result<Self> {
+        let timestamp = u64::deserialize_reader(reader)?;
         Ok(Timestamp::from_nanoseconds(timestamp)
             .map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
     }

From 1833df51985e1752a90e909a0e7377f8b10524e8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Wed, 30 Aug 2023 17:09:04 -0400
Subject: [PATCH 021/182] Add borsh derive for `MsgTransfer` (#845)

* add borsh derive for `MsgTransfer`

* changelog
---
 .../845-borsh-derive-msgtransfer.md           |  2 +
 .../ibc/src/applications/transfer/amount.rs   | 67 ++++++++++++++++++-
 crates/ibc/src/applications/transfer/coin.rs  |  4 ++
 crates/ibc/src/applications/transfer/denom.rs | 16 +++++
 .../applications/transfer/msgs/transfer.rs    |  4 ++
 .../ibc/src/applications/transfer/packet.rs   |  4 ++
 6 files changed, 96 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md

diff --git a/.changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md b/.changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md
new file mode 100644
index 000000000..1bbcc3ed8
--- /dev/null
+++ b/.changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md
@@ -0,0 +1,2 @@
+- Add borsh derive for `MsgTransfer`
+  ([#845](https://github.com/cosmos/ibc-rs/pull/845))
diff --git a/crates/ibc/src/applications/transfer/amount.rs b/crates/ibc/src/applications/transfer/amount.rs
index 740e24d0c..9cee50d29 100644
--- a/crates/ibc/src/applications/transfer/amount.rs
+++ b/crates/ibc/src/applications/transfer/amount.rs
@@ -1,5 +1,6 @@
 //! Contains the `Amount` type, which represents amounts of tokens transferred.
 
+use crate::prelude::*;
 use core::{ops::Deref, str::FromStr};
 use derive_more::{Display, From, Into};
 
@@ -28,6 +29,54 @@ impl parity_scale_codec::WrapperTypeDecode for Amount {
 #[cfg(feature = "parity-scale-codec")]
 impl parity_scale_codec::WrapperTypeEncode for Amount {}
 
+#[cfg(feature = "borsh")]
+impl borsh::BorshSerialize for Amount {
+    fn serialize<W: borsh::maybestd::io::Write>(
+        &self,
+        writer: &mut W,
+    ) -> borsh::maybestd::io::Result<()> {
+        // Note: a "word" is 8 bytes (i.e. a u64)
+        let words = self.as_slice();
+        let bytes: Vec<u8> = words.iter().flat_map(|word| word.to_be_bytes()).collect();
+
+        writer.write_all(&bytes)
+    }
+}
+#[cfg(feature = "borsh")]
+impl borsh::BorshDeserialize for Amount {
+    fn deserialize_reader<R: borsh::maybestd::io::Read>(
+        reader: &mut R,
+    ) -> borsh::maybestd::io::Result<Self> {
+        const NUM_BYTES_IN_U64: usize = 8;
+        const NUM_WORDS_IN_U256: usize = 4;
+
+        let mut buf = [0; 32];
+        let bytes_read = reader.read(&mut buf)?;
+        if bytes_read != 32 {
+            return Err(borsh::maybestd::io::Error::new(
+                borsh::maybestd::io::ErrorKind::InvalidInput,
+                format!("Expected to read 32 bytes, read {bytes_read}"),
+            ));
+        }
+
+        let words: Vec<u64> = buf
+            .chunks_exact(NUM_BYTES_IN_U64)
+            .map(|word| {
+                let word: [u8; NUM_BYTES_IN_U64] = word
+                    .try_into()
+                    .expect("exact chunks of 8 bytes are expected to be 8 bytes");
+                u64::from_be_bytes(word)
+            })
+            .collect();
+
+        let four_words: [u64; NUM_WORDS_IN_U256] = words
+            .try_into()
+            .expect("U256 is always 4 four words, and we confirmed that we read 32 bytes");
+
+        Ok(four_words.into())
+    }
+}
+
 impl Deref for Amount {
     type Target = [u64; 4];
 
@@ -83,10 +132,10 @@ where
 }
 
 #[cfg(test)]
-#[cfg(feature = "serde")]
 mod tests {
     use super::Amount;
 
+    #[cfg(feature = "serde")]
     #[test]
     fn serde_amount() {
         let value = Amount::from(42);
@@ -96,4 +145,20 @@ mod tests {
         let de: Amount = serde_json::from_slice(binary.as_ref()).expect("can deserialize");
         assert_eq!(de, value);
     }
+
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn borsh_amount() {
+        use borsh::BorshDeserialize;
+
+        let value = Amount::from(42);
+        let serialized = borsh::to_vec(&value).unwrap();
+
+        // Amount is supposed to be a U256 according to the spec, which is 32 bytes
+        assert_eq!(serialized.len(), 32);
+
+        let value_deserialized = Amount::try_from_slice(&serialized).unwrap();
+
+        assert_eq!(value, value_deserialized);
+    }
 }
diff --git a/crates/ibc/src/applications/transfer/coin.rs b/crates/ibc/src/applications/transfer/coin.rs
index cad624121..7fd429640 100644
--- a/crates/ibc/src/applications/transfer/coin.rs
+++ b/crates/ibc/src/applications/transfer/coin.rs
@@ -25,6 +25,10 @@ pub type RawCoin = Coin<String>;
     feature = "parity-scale-codec",
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord)]
 pub struct Coin<D> {
     /// Denomination
diff --git a/crates/ibc/src/applications/transfer/denom.rs b/crates/ibc/src/applications/transfer/denom.rs
index 963f6b1d7..77ab685ee 100644
--- a/crates/ibc/src/applications/transfer/denom.rs
+++ b/crates/ibc/src/applications/transfer/denom.rs
@@ -27,6 +27,10 @@ use crate::serializers::serde_string;
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display)]
 pub struct BaseDenom(String);
@@ -62,6 +66,10 @@ impl FromStr for BaseDenom {
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Ord, PartialOrd, Eq, PartialEq)]
@@ -97,6 +105,10 @@ impl Display for TracePrefix {
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Default, Eq, PartialEq, PartialOrd, Ord, From)]
@@ -198,6 +210,10 @@ impl Display for TracePath {
         scale_info::TypeInfo
     )
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord)]
 pub struct PrefixedDenom {
     /// A series of `{port-id}/{channel-id}`s for tracing the source of the token.
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index 0b22755aa..a5d9024c5 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -29,6 +29,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.applications.transfer.v1.MsgTransfer";
     feature = "parity-scale-codec",
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 pub struct MsgTransfer {
     /// the port on which the packet will be sent
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index 4b7ffb4be..fdcede335 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -24,6 +24,10 @@ use crate::signer::Signer;
     feature = "parity-scale-codec",
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
 )]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct PacketData {
     pub token: PrefixedCoin,

From 2c28380918f1000fd4f509fc2f9fcd4aeb189984 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Fri, 1 Sep 2023 09:08:45 -0400
Subject: [PATCH 022/182] Derive borsh for `MsgEnvelope` (#846)

* Add BorshSerialize/Deserialize to MsgEnvelope

* add tests

* changelog
---
 .../846-borsh-derive-msgenvelope.md           |   2 +
 crates/ibc/src/core/ics02_client/msgs.rs      |   4 +
 .../core/ics02_client/msgs/create_client.rs   |   4 +
 .../core/ics02_client/msgs/misbehaviour.rs    |   4 +
 .../core/ics02_client/msgs/update_client.rs   |   4 +
 .../core/ics02_client/msgs/upgrade_client.rs  |   4 +
 crates/ibc/src/core/ics03_connection/msgs.rs  |   4 +
 .../ics03_connection/msgs/conn_open_ack.rs    |   4 +
 .../msgs/conn_open_confirm.rs                 |   4 +
 .../ics03_connection/msgs/conn_open_init.rs   |  75 ++++++++++++
 .../ics03_connection/msgs/conn_open_try.rs    | 109 ++++++++++++++++++
 crates/ibc/src/core/ics04_channel/msgs.rs     |   8 ++
 .../ics04_channel/msgs/acknowledgement.rs     |   4 +
 .../ics04_channel/msgs/chan_close_confirm.rs  |   4 +
 .../ics04_channel/msgs/chan_close_init.rs     |   4 +
 .../core/ics04_channel/msgs/chan_open_ack.rs  |   4 +
 .../ics04_channel/msgs/chan_open_confirm.rs   |   4 +
 .../core/ics04_channel/msgs/chan_open_init.rs |   4 +
 .../core/ics04_channel/msgs/chan_open_try.rs  |   4 +
 .../core/ics04_channel/msgs/recv_packet.rs    |   4 +
 .../src/core/ics04_channel/msgs/timeout.rs    |   4 +
 .../ics04_channel/msgs/timeout_on_close.rs    |   4 +
 .../src/core/ics23_commitment/commitment.rs   |   4 +
 crates/ibc/src/core/msgs.rs                   |   4 +
 24 files changed, 274 insertions(+)
 create mode 100644 .changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md

diff --git a/.changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md b/.changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md
new file mode 100644
index 000000000..cc5ccad7d
--- /dev/null
+++ b/.changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md
@@ -0,0 +1,2 @@
+- Add borsh derive for `MsgEnvelope`
+  ([#846](https://github.com/cosmos/ibc-rs/pull/846))
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/crates/ibc/src/core/ics02_client/msgs.rs
index 9bb0375a8..b432211c9 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/crates/ibc/src/core/ics02_client/msgs.rs
@@ -16,6 +16,10 @@ pub mod upgrade_client;
 
 /// Encodes all the different client messages
 #[allow(dead_code)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug)]
 pub enum ClientMsg {
     CreateClient(MsgCreateClient),
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index de3de83f2..c55e8668c 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -13,6 +13,10 @@ use crate::signer::Signer;
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
 
 /// A type of message that triggers the creation of a new on-chain (IBC) client.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgCreateClient {
     pub client_state: Any,
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index 011db59dd..6ab10266b 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -14,6 +14,10 @@ use crate::signer::Signer;
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
 
 /// A type of message that submits client misbehaviour proof.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgSubmitMisbehaviour {
     /// client unique identifier
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 3adfa716f..74e365a44 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -17,6 +17,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
 /// either with new headers, or evidence of misbehaviour.
 /// Note that some types of misbehaviour can be detected when a headers
 /// are updated (`UpdateKind::UpdateClient`).
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpdateClient {
     pub client_id: ClientId,
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index b5c49613b..c87976e53 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -18,6 +18,10 @@ use crate::signer::Signer;
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
 
 /// A type of message that triggers the upgrade of an on-chain (IBC) client.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq)]
 pub struct MsgUpgradeClient {
     // client unique identifier
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/crates/ibc/src/core/ics03_connection/msgs.rs
index 55f445ea3..486ce3956 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs.rs
@@ -23,6 +23,10 @@ pub mod conn_open_init;
 pub mod conn_open_try;
 
 /// Enumeration of all possible messages that the ICS3 protocol processes.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ConnectionMsg {
     OpenInit(MsgConnectionOpenInit),
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index ad5613d13..5b57756f7 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -16,6 +16,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenAck"
 
 /// Per our convention, this message is sent to chain A.
 /// The handler will check proofs of chain B.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenAck {
     /// ConnectionId that chain A has chosen for it's ConnectionEnd
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
index 69592e31b..4f0337a69 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
@@ -14,6 +14,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenConf
 
 /// Per our convention, this message is sent to chain B.
 /// The handler will check proofs of chain A.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenConfirm {
     /// ConnectionId that chain B has chosen for it's ConnectionEnd
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index ae7c0e0a9..d6732f258 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -34,6 +34,64 @@ impl Msg for MsgConnectionOpenInit {
     }
 }
 
+/// This module encapsulates the workarounds we need to do to implement
+/// `BorshSerialize` and `BorshDeserialize` on `MsgConnectionOpenInit`
+#[cfg(feature = "borsh")]
+mod borsh_impls {
+    use borsh::{
+        maybestd::io::{self, Read},
+        BorshDeserialize, BorshSerialize,
+    };
+
+    use super::*;
+
+    #[derive(BorshSerialize, BorshDeserialize)]
+    pub struct InnerMsgConnectionOpenInit {
+        /// ClientId on chain A that the connection is being opened for
+        pub client_id_on_a: ClientId,
+        pub counterparty: Counterparty,
+        pub version: Option<Version>,
+        pub delay_period_nanos: u64,
+        pub signer: Signer,
+    }
+
+    impl BorshSerialize for MsgConnectionOpenInit {
+        fn serialize<W: io::Write>(&self, writer: &mut W) -> io::Result<()> {
+            let delay_period_nanos: u64 =
+                self.delay_period.as_nanos().try_into().map_err(|_| {
+                    io::Error::new(
+                        io::ErrorKind::Other,
+                        format!("Duration too long: {} nanos", self.delay_period.as_nanos()),
+                    )
+                })?;
+
+            let inner = InnerMsgConnectionOpenInit {
+                client_id_on_a: self.client_id_on_a.clone(),
+                counterparty: self.counterparty.clone(),
+                version: self.version.clone(),
+                delay_period_nanos,
+                signer: self.signer.clone(),
+            };
+
+            inner.serialize(writer)
+        }
+    }
+
+    impl BorshDeserialize for MsgConnectionOpenInit {
+        fn deserialize_reader<R: Read>(reader: &mut R) -> io::Result<Self> {
+            let inner = InnerMsgConnectionOpenInit::deserialize_reader(reader)?;
+
+            Ok(MsgConnectionOpenInit {
+                client_id_on_a: inner.client_id_on_a,
+                counterparty: inner.counterparty,
+                version: inner.version,
+                delay_period: Duration::from_nanos(inner.delay_period_nanos),
+                signer: inner.signer,
+            })
+        }
+    }
+}
+
 impl Protobuf<RawMsgConnectionOpenInit> for MsgConnectionOpenInit {}
 
 impl TryFrom<RawMsgConnectionOpenInit> for MsgConnectionOpenInit {
@@ -239,4 +297,21 @@ mod tests {
             msg_with_counterpary_conn_id_some_back
         );
     }
+
+    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh() {
+        let mut raw = get_dummy_raw_msg_conn_open_init();
+        raw.delay_period = u64::MAX;
+        let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
+
+        let serialized = borsh::to_vec(&msg).unwrap();
+
+        let msg_deserialized =
+            <MsgConnectionOpenInit as borsh::BorshDeserialize>::try_from_slice(&serialized)
+                .unwrap();
+
+        assert_eq!(msg, msg_deserialized);
+    }
 }
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index 264aff846..11f7fb884 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -60,6 +60,99 @@ impl Msg for MsgConnectionOpenTry {
         TYPE_URL.to_string()
     }
 }
+#[allow(deprecated)]
+#[cfg(feature = "borsh")]
+mod borsh_impls {
+    use borsh::{
+        maybestd::io::{self, Read},
+        BorshDeserialize, BorshSerialize,
+    };
+
+    use super::*;
+
+    #[derive(BorshSerialize, BorshDeserialize)]
+    pub struct InnerMsgConnectionOpenTry {
+        /// ClientId on B that the connection is being opened for
+        pub client_id_on_b: ClientId,
+        /// ClientState of client tracking chain B on chain A
+        pub client_state_of_b_on_a: Any,
+        /// ClientId, ConnectionId and prefix of chain A
+        pub counterparty: Counterparty,
+        /// Versions supported by chain A
+        pub versions_on_a: Vec<Version>,
+        /// proof of ConnectionEnd stored on Chain A during ConnOpenInit
+        pub proof_conn_end_on_a: CommitmentProofBytes,
+        /// proof that chain A has stored ClientState of chain B on its client
+        pub proof_client_state_of_b_on_a: CommitmentProofBytes,
+        /// proof that chain A has stored ConsensusState of chain B on its client
+        pub proof_consensus_state_of_b_on_a: CommitmentProofBytes,
+        /// Height at which all proofs in this message were taken
+        pub proofs_height_on_a: Height,
+        /// height of latest header of chain A that updated the client on chain B
+        pub consensus_height_of_b_on_a: Height,
+        pub delay_period_nanos: u64,
+        pub signer: Signer,
+        /// optional proof of host state machines (chain B) that are unable to
+        /// introspect their own consensus state
+        pub proof_consensus_state_of_b: Option<CommitmentProofBytes>,
+
+        #[deprecated(since = "0.22.0")]
+        /// Only kept here for proper conversion to/from the raw type
+        previous_connection_id: String,
+    }
+
+    impl BorshSerialize for MsgConnectionOpenTry {
+        fn serialize<W: io::Write>(&self, writer: &mut W) -> io::Result<()> {
+            let delay_period_nanos: u64 =
+                self.delay_period.as_nanos().try_into().map_err(|_| {
+                    io::Error::new(
+                        io::ErrorKind::Other,
+                        format!("Duration too long: {} nanos", self.delay_period.as_nanos()),
+                    )
+                })?;
+
+            let inner = InnerMsgConnectionOpenTry {
+                client_id_on_b: self.client_id_on_b.clone(),
+                client_state_of_b_on_a: self.client_state_of_b_on_a.clone(),
+                counterparty: self.counterparty.clone(),
+                versions_on_a: self.versions_on_a.clone(),
+                proof_conn_end_on_a: self.proof_conn_end_on_a.clone(),
+                proof_client_state_of_b_on_a: self.proof_client_state_of_b_on_a.clone(),
+                proof_consensus_state_of_b_on_a: self.proof_consensus_state_of_b_on_a.clone(),
+                proofs_height_on_a: self.proofs_height_on_a,
+                consensus_height_of_b_on_a: self.consensus_height_of_b_on_a,
+                delay_period_nanos,
+                signer: self.signer.clone(),
+                proof_consensus_state_of_b: self.proof_consensus_state_of_b.clone(),
+                previous_connection_id: self.previous_connection_id.clone(),
+            };
+
+            inner.serialize(writer)
+        }
+    }
+
+    impl BorshDeserialize for MsgConnectionOpenTry {
+        fn deserialize_reader<R: Read>(reader: &mut R) -> io::Result<Self> {
+            let inner = InnerMsgConnectionOpenTry::deserialize_reader(reader)?;
+
+            Ok(MsgConnectionOpenTry {
+                client_id_on_b: inner.client_id_on_b,
+                client_state_of_b_on_a: inner.client_state_of_b_on_a,
+                counterparty: inner.counterparty,
+                versions_on_a: inner.versions_on_a,
+                proof_conn_end_on_a: inner.proof_conn_end_on_a,
+                proof_client_state_of_b_on_a: inner.proof_client_state_of_b_on_a,
+                proof_consensus_state_of_b_on_a: inner.proof_consensus_state_of_b_on_a,
+                proofs_height_on_a: inner.proofs_height_on_a,
+                consensus_height_of_b_on_a: inner.consensus_height_of_b_on_a,
+                delay_period: Duration::from_nanos(inner.delay_period_nanos),
+                signer: inner.signer,
+                proof_consensus_state_of_b: inner.proof_consensus_state_of_b,
+                previous_connection_id: inner.previous_connection_id,
+            })
+        }
+    }
+}
 
 impl Protobuf<RawMsgConnectionOpenTry> for MsgConnectionOpenTry {}
 
@@ -357,4 +450,20 @@ mod tests {
         assert_eq!(raw, raw_back);
         assert_eq!(msg, msg_back);
     }
+
+    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh() {
+        let mut raw = get_dummy_raw_msg_conn_open_try(10, 34);
+        raw.delay_period = u64::MAX;
+        let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
+
+        let serialized = borsh::to_vec(&msg).unwrap();
+
+        let msg_deserialized =
+            <MsgConnectionOpenTry as borsh::BorshDeserialize>::try_from_slice(&serialized).unwrap();
+
+        assert_eq!(msg, msg_deserialized);
+    }
 }
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index fad6922d3..728c8926c 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -31,6 +31,10 @@ pub use timeout_on_close::MsgTimeoutOnClose;
 use crate::core::ics24_host::identifier::PortId;
 
 /// All channel messages
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ChannelMsg {
     OpenInit(MsgChannelOpenInit),
@@ -42,6 +46,10 @@ pub enum ChannelMsg {
 }
 
 /// All packet messages
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum PacketMsg {
     Recv(MsgRecvPacket),
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
index 7e414263e..6f448d6fc 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
@@ -16,6 +16,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgAcknowledgement";
 ///
 /// Message definition for packet acknowledgements.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgAcknowledgement {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
index 6d73b3492..c40c88c5a 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
@@ -17,6 +17,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseConfirm";
 /// datagram).
 /// Per our convention, this message is sent to chain B.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelCloseConfirm {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
index 98c8c694c..d3a569217 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
@@ -15,6 +15,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseInit";
 /// Message definition for the first step in the channel close handshake (`ChanCloseInit` datagram).
 /// Per our convention, this message is sent to chain A.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelCloseInit {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
index 2f8587ef3..9fca241ff 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
@@ -14,6 +14,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenAck";
 /// Message definition for the third step in the channel open handshake (`ChanOpenAck` datagram).
 ///
 /// Per our convention, this message is sent to chain A.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenAck {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
index aeaa39706..4bd43bd39 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
@@ -15,6 +15,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenConfirm";
 /// datagram).
 /// Per our convention, this message is sent to chain B.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenConfirm {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index a7dd63505..08f034eb2 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -18,6 +18,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenInit";
 /// Message definition for the first step in the channel open handshake (`ChanOpenInit` datagram).
 /// Per our convention, this message is sent to chain A.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenInit {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
index 1759b2deb..ad0e93ca4 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
@@ -19,6 +19,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenTry";
 /// Message definition for the second step in the channel open handshake (`ChanOpenTry` datagram).
 /// Per our convention, this message is sent to chain B.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenTry {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
index ae96fe80f..241c67976 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
@@ -16,6 +16,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgRecvPacket";
 ///
 /// Message definition for the "packet receiving" datagram.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgRecvPacket {
     /// The packet to be received
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
index 5595a27ee..b3104bca3 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
@@ -17,6 +17,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeout";
 /// Message definition for packet timeout domain type,
 /// which is sent on chain A and needs to prove that a previously sent packet was not received on chain B
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgTimeout {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
index 90401c4c4..e299d9a18 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
@@ -15,6 +15,10 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeoutOnClose";
 ///
 /// Message definition for packet timeout domain type.
 ///
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgTimeoutOnClose {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics23_commitment/commitment.rs b/crates/ibc/src/core/ics23_commitment/commitment.rs
index 98a4d5d9a..b5b876b71 100644
--- a/crates/ibc/src/core/ics23_commitment/commitment.rs
+++ b/crates/ibc/src/core/ics23_commitment/commitment.rs
@@ -61,6 +61,10 @@ impl From<Vec<u8>> for CommitmentRoot {
 ///
 /// For example, in the case of a proof of membership in a Merkle tree,
 /// this encodes a Merkle proof.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "serde", serde(transparent))]
 #[derive(Clone, PartialEq, Eq)]
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index b15a0a39d..212d08304 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -36,6 +36,10 @@ pub trait Msg: Clone {
 }
 
 /// Enumeration of all messages that the local ICS26 module is capable of routing.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
 #[derive(Clone, Debug)]
 pub enum MsgEnvelope {
     Client(ClientMsg),

From 2d610b6782a31bc7651fdfb7a0f1cb25cb061977 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Fri, 1 Sep 2023 09:30:41 -0400
Subject: [PATCH 023/182] derive `PartialEq`, `Eq` for `MsgEnvelope` (#847)

* derive PartialEq, Eq

* changelog
---
 .changelog/unreleased/improvements/847-derive-msgenvelope-eq.md | 2 ++
 crates/ibc/src/core/ics02_client/msgs.rs                        | 2 +-
 crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs         | 2 +-
 crates/ibc/src/core/msgs.rs                                     | 2 +-
 4 files changed, 5 insertions(+), 3 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/847-derive-msgenvelope-eq.md

diff --git a/.changelog/unreleased/improvements/847-derive-msgenvelope-eq.md b/.changelog/unreleased/improvements/847-derive-msgenvelope-eq.md
new file mode 100644
index 000000000..e7580e0a7
--- /dev/null
+++ b/.changelog/unreleased/improvements/847-derive-msgenvelope-eq.md
@@ -0,0 +1,2 @@
+- Derive `PartialEq`, `Eq` for `MsgEnvelope`
+  ([#847](https://github.com/cosmos/ibc-rs/pull/847))
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/crates/ibc/src/core/ics02_client/msgs.rs
index b432211c9..b1b29ac82 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/crates/ibc/src/core/ics02_client/msgs.rs
@@ -20,7 +20,7 @@ pub mod upgrade_client;
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ClientMsg {
     CreateClient(MsgCreateClient),
     UpdateClient(MsgUpdateClient),
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index c87976e53..f18160f89 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -22,7 +22,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
-#[derive(Clone, Debug, PartialEq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpgradeClient {
     // client unique identifier
     pub client_id: ClientId,
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index 212d08304..66a2c6eaf 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -40,7 +40,7 @@ pub trait Msg: Clone {
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
-#[derive(Clone, Debug)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub enum MsgEnvelope {
     Client(ClientMsg),
     Connection(ConnectionMsg),

From dc8e4161dd5e00a2031cf3feb58dad1ed7e26bdb Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 5 Sep 2023 07:24:07 -0700
Subject: [PATCH 024/182] imp: organize imports using `rustfmt.toml` (#849)

* imp: organize imports using rustfmt.toml

* fix: use nightly toolchain for fmt

* fix: add fmt component

* nix: add reorder_imports
---
 .../improvements/848-configure-cargo-fmt.md   |  2 +
 .github/workflows/rust.yml                    |  3 +-
 crates/ibc-derive/src/client_state.rs         |  8 +--
 .../traits/client_state_common.rs             |  8 +--
 .../traits/client_state_execution.rs          | 14 ++---
 .../traits/client_state_validation.rs         | 14 ++---
 crates/ibc-derive/src/consensus_state.rs      |  3 +-
 .../ibc/src/applications/transfer/amount.rs   | 13 +++--
 crates/ibc/src/applications/transfer/coin.rs  |  1 +
 .../ibc/src/applications/transfer/context.rs  | 12 ++--
 crates/ibc/src/applications/transfer/denom.rs |  1 -
 crates/ibc/src/applications/transfer/error.rs |  1 +
 .../ibc/src/applications/transfer/events.rs   |  3 +-
 crates/ibc/src/applications/transfer/memo.rs  |  4 +-
 .../applications/transfer/msgs/transfer.rs    |  7 +--
 .../ibc/src/applications/transfer/packet.rs   |  8 +--
 crates/ibc/src/applications/transfer/relay.rs |  3 +-
 .../clients/ics07_tendermint/client_state.rs  | 38 ++++++------
 .../client_state/misbehaviour.rs              |  6 +-
 .../client_state/update_client.rs             |  6 +-
 .../ics07_tendermint/consensus_state.rs       | 10 ++--
 .../src/clients/ics07_tendermint/context.rs   | 16 ++---
 .../ibc/src/clients/ics07_tendermint/error.rs | 11 ++--
 .../src/clients/ics07_tendermint/header.rs    |  8 +--
 .../clients/ics07_tendermint/misbehaviour.rs  |  3 +-
 .../ibc/src/clients/ics07_tendermint/mod.rs   |  3 +-
 .../ics07_tendermint/trust_threshold.rs       |  6 +-
 crates/ibc/src/core/context.rs                | 21 +++----
 crates/ibc/src/core/events.rs                 | 28 ++++-----
 crates/ibc/src/core/handler.rs                | 58 ++++++++++---------
 .../ibc/src/core/ics02_client/client_type.rs  | 13 ++---
 .../src/core/ics02_client/consensus_state.rs  |  9 ++-
 crates/ibc/src/core/ics02_client/context.rs   |  3 +-
 crates/ibc/src/core/ics02_client/error.rs     |  6 +-
 crates/ibc/src/core/ics02_client/events.rs    | 13 +++--
 .../ics02_client/handler/create_client.rs     | 15 ++---
 .../ics02_client/handler/update_client.rs     | 21 +++----
 .../ics02_client/handler/upgrade_client.rs    | 14 ++---
 crates/ibc/src/core/ics02_client/height.rs    |  6 +-
 .../core/ics02_client/msgs/create_client.rs   |  6 +-
 .../core/ics02_client/msgs/misbehaviour.rs    |  3 +-
 .../core/ics02_client/msgs/update_client.rs   | 11 ++--
 .../core/ics02_client/msgs/upgrade_client.rs  | 14 ++---
 .../src/core/ics03_connection/connection.rs   | 11 ++--
 crates/ibc/src/core/ics03_connection/delay.rs |  7 ++-
 crates/ibc/src/core/ics03_connection/error.rs |  9 +--
 .../ibc/src/core/ics03_connection/events.rs   |  8 ++-
 .../ibc/src/core/ics03_connection/handler.rs  |  6 +-
 .../ics03_connection/handler/conn_open_ack.rs | 15 +++--
 .../handler/conn_open_confirm.rs              | 10 ++--
 .../handler/conn_open_init.rs                 | 11 ++--
 .../ics03_connection/handler/conn_open_try.rs | 12 ++--
 crates/ibc/src/core/ics03_connection/msgs.rs  |  5 +-
 .../ics03_connection/msgs/conn_open_ack.rs    | 20 +++----
 .../msgs/conn_open_confirm.rs                 | 19 +++---
 .../ics03_connection/msgs/conn_open_init.rs   | 22 +++----
 .../ics03_connection/msgs/conn_open_try.rs    | 34 +++++------
 .../ibc/src/core/ics03_connection/version.rs  | 11 ++--
 .../src/core/ics04_channel/acknowledgement.rs |  4 +-
 crates/ibc/src/core/ics04_channel/channel.rs  | 22 +++----
 .../ibc/src/core/ics04_channel/commitment.rs  |  3 +-
 crates/ibc/src/core/ics04_channel/context.rs  | 20 +++----
 crates/ibc/src/core/ics04_channel/error.rs    |  4 +-
 crates/ibc/src/core/ics04_channel/events.rs   | 15 +++--
 .../events/channel_attributes.rs              |  6 +-
 .../ics04_channel/events/packet_attributes.rs |  4 +-
 .../ics04_channel/handler/acknowledgement.rs  | 37 +++++-------
 .../handler/chan_close_confirm.rs             | 24 +++-----
 .../ics04_channel/handler/chan_close_init.rs  | 18 +++---
 .../ics04_channel/handler/chan_open_ack.rs    | 28 ++++-----
 .../handler/chan_open_confirm.rs              | 30 +++++-----
 .../ics04_channel/handler/chan_open_init.rs   | 21 +++----
 .../ics04_channel/handler/chan_open_try.rs    | 27 ++++-----
 .../core/ics04_channel/handler/recv_packet.rs | 33 +++++------
 .../core/ics04_channel/handler/send_packet.rs | 36 +++++-------
 .../src/core/ics04_channel/handler/timeout.rs | 40 +++++--------
 .../ics04_channel/handler/timeout_on_close.rs | 32 +++++-----
 crates/ibc/src/core/ics04_channel/msgs.rs     | 12 ++--
 .../ics04_channel/msgs/acknowledgement.rs     | 14 ++---
 .../ics04_channel/msgs/chan_close_confirm.rs  | 14 ++---
 .../ics04_channel/msgs/chan_close_init.rs     | 14 ++---
 .../core/ics04_channel/msgs/chan_open_ack.rs  | 18 +++---
 .../ics04_channel/msgs/chan_open_confirm.rs   | 18 +++---
 .../core/ics04_channel/msgs/chan_open_init.rs | 21 ++++---
 .../core/ics04_channel/msgs/chan_open_try.rs  | 28 ++++-----
 .../core/ics04_channel/msgs/recv_packet.rs    | 17 +++---
 .../src/core/ics04_channel/msgs/timeout.rs    | 12 ++--
 .../ics04_channel/msgs/timeout_on_close.rs    |  5 +-
 crates/ibc/src/core/ics04_channel/packet.rs   | 14 ++---
 crates/ibc/src/core/ics04_channel/timeout.rs  |  6 +-
 crates/ibc/src/core/ics04_channel/version.rs  |  3 +-
 .../src/core/ics23_commitment/commitment.rs   | 12 ++--
 crates/ibc/src/core/ics23_commitment/error.rs |  1 +
 .../ibc/src/core/ics23_commitment/merkle.rs   |  7 +--
 crates/ibc/src/core/ics23_commitment/specs.rs |  3 +-
 crates/ibc/src/core/ics24_host/identifier.rs  |  4 +-
 .../core/ics24_host/identifier/validate.rs    |  7 +--
 crates/ibc/src/core/ics24_host/path.rs        | 11 ++--
 crates/ibc/src/core/mod.rs                    | 10 +---
 crates/ibc/src/core/msgs.rs                   |  5 +-
 crates/ibc/src/core/router.rs                 |  5 +-
 crates/ibc/src/core/timestamp.rs              |  8 +--
 .../tendermint/upgrade_proposal/events.rs     |  1 +
 .../tendermint/upgrade_proposal/handler.rs    |  7 ++-
 .../hosts/tendermint/upgrade_proposal/plan.rs |  1 +
 .../tendermint/upgrade_proposal/proposal.rs   |  1 +
 .../hosts/tendermint/validate_self_client.rs  |  7 +--
 crates/ibc/src/lib.rs                         |  3 +-
 crates/ibc/src/mock/client_state.rs           | 22 +++----
 crates/ibc/src/mock/consensus_state.rs        |  6 +-
 crates/ibc/src/mock/context.rs                | 42 ++++++--------
 crates/ibc/src/mock/context/clients.rs        | 16 +++--
 crates/ibc/src/mock/header.rs                 |  3 +-
 crates/ibc/src/mock/host.rs                   |  4 +-
 crates/ibc/src/mock/ics18_relayer/context.rs  |  9 ++-
 crates/ibc/src/mock/ics18_relayer/error.rs    |  3 +-
 crates/ibc/src/mock/misbehaviour.rs           |  3 +-
 crates/ibc/src/mock/router.rs                 |  6 +-
 crates/ibc/src/prelude.rs                     |  7 +--
 crates/ibc/src/signer.rs                      |  4 +-
 crates/ibc/src/test.rs                        |  4 +-
 crates/ibc/src/test_utils.rs                  |  3 +-
 crates/ibc/src/utils/pretty.rs                |  3 +-
 rustfmt.toml                                  |  5 ++
 124 files changed, 658 insertions(+), 828 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/848-configure-cargo-fmt.md
 create mode 100644 rustfmt.toml

diff --git a/.changelog/unreleased/improvements/848-configure-cargo-fmt.md b/.changelog/unreleased/improvements/848-configure-cargo-fmt.md
new file mode 100644
index 000000000..51ad15851
--- /dev/null
+++ b/.changelog/unreleased/improvements/848-configure-cargo-fmt.md
@@ -0,0 +1,2 @@
+- Organize imports grouping and granularity using `rustfmt.toml`
+  ([#848](https://github.com/cosmos/ibc-rs/issues/848))
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 740d384c1..4671367c2 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -37,7 +37,8 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
-          toolchain: stable
+          toolchain: nightly # Since fmt uses unstable features for organizing imports
+          components: rustfmt
           override: true
       - uses: actions-rs/cargo@v1
         with:
diff --git a/crates/ibc-derive/src/client_state.rs b/crates/ibc-derive/src/client_state.rs
index a6bb0e83c..46917ce2e 100644
--- a/crates/ibc-derive/src/client_state.rs
+++ b/crates/ibc-derive/src/client_state.rs
@@ -4,11 +4,9 @@ use darling::FromDeriveInput;
 use proc_macro2::TokenStream;
 use quote::quote;
 use syn::DeriveInput;
-
-use traits::{
-    client_state_common::impl_ClientStateCommon, client_state_execution::impl_ClientStateExecution,
-    client_state_validation::impl_ClientStateValidation,
-};
+use traits::client_state_common::impl_ClientStateCommon;
+use traits::client_state_execution::impl_ClientStateExecution;
+use traits::client_state_validation::impl_ClientStateValidation;
 
 #[derive(FromDeriveInput)]
 #[darling(attributes(generics))]
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_common.rs b/crates/ibc-derive/src/client_state/traits/client_state_common.rs
index b1dc37731..8176743e3 100644
--- a/crates/ibc-derive/src/client_state/traits/client_state_common.rs
+++ b/crates/ibc-derive/src/client_state/traits/client_state_common.rs
@@ -1,10 +1,8 @@
 use proc_macro2::{Ident, TokenStream};
 use quote::quote;
-use syn::{
-    punctuated::{Iter, Punctuated},
-    token::Comma,
-    Variant,
-};
+use syn::punctuated::{Iter, Punctuated};
+use syn::token::Comma;
+use syn::Variant;
 
 use crate::utils::{get_enum_variant_type_path, Imports};
 
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_execution.rs b/crates/ibc-derive/src/client_state/traits/client_state_execution.rs
index 7b6903122..1a92c8f79 100644
--- a/crates/ibc-derive/src/client_state/traits/client_state_execution.rs
+++ b/crates/ibc-derive/src/client_state/traits/client_state_execution.rs
@@ -1,15 +1,11 @@
 use proc_macro2::{Ident, TokenStream};
 use quote::quote;
-use syn::{
-    punctuated::{Iter, Punctuated},
-    token::Comma,
-    Variant,
-};
+use syn::punctuated::{Iter, Punctuated};
+use syn::token::Comma;
+use syn::Variant;
 
-use crate::{
-    client_state::Opts,
-    utils::{get_enum_variant_type_path, Imports},
-};
+use crate::client_state::Opts;
+use crate::utils::{get_enum_variant_type_path, Imports};
 
 pub(crate) fn impl_ClientStateExecution(
     client_state_enum_name: &Ident,
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_validation.rs b/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
index 38c8ba397..a0c920bd3 100644
--- a/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
+++ b/crates/ibc-derive/src/client_state/traits/client_state_validation.rs
@@ -1,15 +1,11 @@
 use proc_macro2::{Ident, TokenStream};
 use quote::quote;
-use syn::{
-    punctuated::{Iter, Punctuated},
-    token::Comma,
-    Variant,
-};
+use syn::punctuated::{Iter, Punctuated};
+use syn::token::Comma;
+use syn::Variant;
 
-use crate::{
-    client_state::Opts,
-    utils::{get_enum_variant_type_path, Imports},
-};
+use crate::client_state::Opts;
+use crate::utils::{get_enum_variant_type_path, Imports};
 
 pub(crate) fn impl_ClientStateValidation(
     client_state_enum_name: &Ident,
diff --git a/crates/ibc-derive/src/consensus_state.rs b/crates/ibc-derive/src/consensus_state.rs
index 3a00ea2de..99feb69ce 100644
--- a/crates/ibc-derive/src/consensus_state.rs
+++ b/crates/ibc-derive/src/consensus_state.rs
@@ -1,6 +1,7 @@
 use proc_macro2::TokenStream;
 use quote::quote;
-use syn::{punctuated::Iter, DeriveInput, Ident, Variant};
+use syn::punctuated::Iter;
+use syn::{DeriveInput, Ident, Variant};
 
 use crate::utils::{get_enum_variant_type_path, Imports};
 
diff --git a/crates/ibc/src/applications/transfer/amount.rs b/crates/ibc/src/applications/transfer/amount.rs
index 9cee50d29..fe21574fa 100644
--- a/crates/ibc/src/applications/transfer/amount.rs
+++ b/crates/ibc/src/applications/transfer/amount.rs
@@ -1,14 +1,17 @@
 //! Contains the `Amount` type, which represents amounts of tokens transferred.
 
-use crate::prelude::*;
-use core::{ops::Deref, str::FromStr};
-use derive_more::{Display, From, Into};
+use core::ops::Deref;
+use core::str::FromStr;
 
-use super::error::TokenTransferError;
+use derive_more::{Display, From, Into};
 use primitive_types::U256;
 
+use super::error::TokenTransferError;
+#[cfg(feature = "schema")]
+use crate::alloc::borrow::ToOwned;
 #[cfg(feature = "schema")]
-use crate::alloc::{borrow::ToOwned, string::String};
+use crate::alloc::string::String;
+use crate::prelude::*;
 
 /// A type for representing token transfer amounts.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
diff --git a/crates/ibc/src/applications/transfer/coin.rs b/crates/ibc/src/applications/transfer/coin.rs
index 7fd429640..406e01b43 100644
--- a/crates/ibc/src/applications/transfer/coin.rs
+++ b/crates/ibc/src/applications/transfer/coin.rs
@@ -2,6 +2,7 @@
 
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::{from_utf8, FromStr};
+
 use ibc_proto::cosmos::base::v1beta1::Coin as ProtoCoin;
 use safe_regex::regex;
 
diff --git a/crates/ibc/src/applications/transfer/context.rs b/crates/ibc/src/applications/transfer/context.rs
index 6b3b25880..81b4030af 100644
--- a/crates/ibc/src/applications/transfer/context.rs
+++ b/crates/ibc/src/applications/transfer/context.rs
@@ -1,25 +1,23 @@
 //! Defines the main context traits and IBC module callbacks
-use crate::prelude::*;
-
 use sha2::{Digest, Sha256};
 
 use super::ack_success_b64;
 use super::error::TokenTransferError;
 use crate::applications::transfer::events::{AckEvent, AckStatusEvent, RecvEvent, TimeoutEvent};
 use crate::applications::transfer::packet::PacketData;
-use crate::applications::transfer::relay::refund_packet_token_execute;
+use crate::applications::transfer::relay::on_recv_packet::process_recv_packet_execute;
 use crate::applications::transfer::relay::{
-    on_recv_packet::process_recv_packet_execute, refund_packet_token_validate,
+    refund_packet_token_execute, refund_packet_token_validate,
 };
 use crate::applications::transfer::{PrefixedCoin, PrefixedDenom, VERSION};
-use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::acknowledgement::AcknowledgementStatus;
+use crate::core::ics04_channel::acknowledgement::{Acknowledgement, AcknowledgementStatus};
 use crate::core::ics04_channel::channel::{Counterparty, Order};
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics04_channel::Version;
 use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
 use crate::core::router::ModuleExtras;
 use crate::core::ContextError;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 /// Methods required in token transfer validation, to be implemented by the host
@@ -414,9 +412,9 @@ pub fn on_timeout_packet_execute(
 
 #[cfg(test)]
 pub(crate) mod test {
-    use super::*;
     use subtle_encoding::bech32;
 
+    use super::*;
     use crate::applications::transfer::context::cosmos_adr028_escrow_address;
     use crate::core::ics04_channel::channel::{Counterparty, Order};
     use crate::core::ics04_channel::Version;
diff --git a/crates/ibc/src/applications/transfer/denom.rs b/crates/ibc/src/applications/transfer/denom.rs
index 77ab685ee..73d46745d 100644
--- a/crates/ibc/src/applications/transfer/denom.rs
+++ b/crates/ibc/src/applications/transfer/denom.rs
@@ -9,7 +9,6 @@ use ibc_proto::ibc::applications::transfer::v1::DenomTrace as RawDenomTrace;
 use super::error::TokenTransferError;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::prelude::*;
-
 #[cfg(feature = "serde")]
 use crate::serializers::serde_string;
 
diff --git a/crates/ibc/src/applications/transfer/error.rs b/crates/ibc/src/applications/transfer/error.rs
index 479820bc7..0c25654ce 100644
--- a/crates/ibc/src/applications/transfer/error.rs
+++ b/crates/ibc/src/applications/transfer/error.rs
@@ -2,6 +2,7 @@
 
 use core::convert::Infallible;
 use core::str::Utf8Error;
+
 use displaydoc::Display;
 use ibc_proto::protobuf::Error as TendermintProtoError;
 use uint::FromDecStrErr;
diff --git a/crates/ibc/src/applications/transfer/events.rs b/crates/ibc/src/applications/transfer/events.rs
index 23476f3d2..45eff108a 100644
--- a/crates/ibc/src/applications/transfer/events.rs
+++ b/crates/ibc/src/applications/transfer/events.rs
@@ -1,13 +1,12 @@
 //! Defines all token transfer event types
 
+use super::Memo;
 use crate::applications::transfer::{Amount, PrefixedDenom, MODULE_ID_STR};
 use crate::core::events::ModuleEvent;
 use crate::core::ics04_channel::acknowledgement::AcknowledgementStatus;
 use crate::prelude::*;
 use crate::signer::Signer;
 
-use super::Memo;
-
 const EVENT_TYPE_PACKET: &str = "fungible_token_packet";
 const EVENT_TYPE_TIMEOUT: &str = "timeout";
 const EVENT_TYPE_DENOM_TRACE: &str = "denomination_trace";
diff --git a/crates/ibc/src/applications/transfer/memo.rs b/crates/ibc/src/applications/transfer/memo.rs
index 04bc75584..3d31f206e 100644
--- a/crates/ibc/src/applications/transfer/memo.rs
+++ b/crates/ibc/src/applications/transfer/memo.rs
@@ -2,7 +2,9 @@
 //! with a token transfer
 
 use core::convert::Infallible;
-use core::fmt::{self, Display};
+use core::fmt::{
+    Display, {self},
+};
 use core::str::FromStr;
 
 use crate::prelude::*;
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index a5d9024c5..f3ef9172e 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -1,7 +1,5 @@
 //! Defines the token transfer message type
 
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::applications::transfer::v1::MsgTransfer as RawMsgTransfer;
 use ibc_proto::protobuf::Protobuf;
@@ -13,6 +11,7 @@ use crate::core::ics04_channel::timeout::TimeoutHeight;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::core::timestamp::Timestamp;
 use crate::core::{ContextError, Msg};
+use crate::prelude::*;
 
 pub(crate) const TYPE_URL: &str = "/ibc.applications.transfer.v1.MsgTransfer";
 
@@ -127,12 +126,10 @@ impl TryFrom<Any> for MsgTransfer {
 
 #[cfg(test)]
 pub mod test_util {
-    use super::*;
-
     use core::ops::Add;
     use core::time::Duration;
 
-    use super::MsgTransfer;
+    use super::{MsgTransfer, *};
     use crate::applications::transfer::packet::PacketData;
     use crate::core::ics04_channel::packet::{Packet, Sequence};
     use crate::core::ics04_channel::timeout::TimeoutHeight;
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index fdcede335..758af8439 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -4,13 +4,12 @@ use alloc::string::ToString;
 use core::convert::TryFrom;
 use core::str::FromStr;
 
-#[cfg(feature = "schema")]
-use crate::alloc::borrow::ToOwned;
-
 use ibc_proto::ibc::applications::transfer::v2::FungibleTokenPacketData as RawPacketData;
 
 use super::error::TokenTransferError;
 use super::{Amount, Memo, PrefixedCoin, PrefixedDenom};
+#[cfg(feature = "schema")]
+use crate::alloc::borrow::ToOwned;
 use crate::signer::Signer;
 
 /// Defines the structure of token transfers' packet bytes
@@ -67,10 +66,11 @@ impl From<PacketData> for RawPacketData {
 #[cfg(test)]
 mod tests {
 
+    use primitive_types::U256;
+
     use super::*;
     use crate::applications::transfer::BaseCoin;
     use crate::test_utils::get_dummy_bech32_account;
-    use primitive_types::U256;
 
     impl PacketData {
         pub fn new_dummy() -> Self {
diff --git a/crates/ibc/src/applications/transfer/relay.rs b/crates/ibc/src/applications/transfer/relay.rs
index 2d2fce7d1..227ac8243 100644
--- a/crates/ibc/src/applications/transfer/relay.rs
+++ b/crates/ibc/src/applications/transfer/relay.rs
@@ -1,13 +1,12 @@
 //! Implements the processing logic for ICS20 (token transfer) message.
 
+use super::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
 use crate::applications::transfer::error::TokenTransferError;
 use crate::applications::transfer::is_sender_chain_source;
 use crate::applications::transfer::packet::PacketData;
 use crate::core::ics04_channel::packet::Packet;
 use crate::prelude::*;
 
-use super::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
-
 pub mod on_recv_packet;
 pub mod send_transfer;
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index 3e60b86b8..f9709e38d 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -4,8 +4,6 @@
 mod misbehaviour;
 mod update_client;
 
-use crate::prelude::*;
-
 use core::cmp::max;
 use core::convert::{TryFrom, TryInto};
 use core::str::FromStr;
@@ -17,12 +15,16 @@ use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
 use ibc_proto::ibc::lightclients::tendermint::v1::ClientState as RawTmClientState;
 use ibc_proto::protobuf::Protobuf;
 use prost::Message;
-
 use tendermint::chain::id::MAX_LENGTH as MaxChainIdLen;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::ProdVerifier;
 
+use super::trust_threshold::TrustThreshold;
+use super::{
+    client_type as tm_client_type, ExecutionContext as TmExecutionContext,
+    ValidationContext as TmValidationContext,
+};
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
 use crate::clients::ics07_tendermint::error::Error;
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
@@ -40,17 +42,13 @@ use crate::core::ics23_commitment::commitment::{
 use crate::core::ics23_commitment::merkle::{apply_prefix, MerkleProof};
 use crate::core::ics23_commitment::specs::ProofSpecs;
 use crate::core::ics24_host::identifier::{ChainId, ClientId};
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, UpgradeClientPath};
+use crate::core::ics24_host::path::{
+    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
+};
 use crate::core::timestamp::ZERO_DURATION;
+use crate::prelude::*;
 use crate::Height;
 
-use super::trust_threshold::TrustThreshold;
-use super::{
-    client_type as tm_client_type, ExecutionContext as TmExecutionContext,
-    ValidationContext as TmValidationContext,
-};
-
 pub const TENDERMINT_CLIENT_STATE_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.ClientState";
 
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -735,9 +733,10 @@ impl TryFrom<Any> for ClientState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use bytes::Buf;
         use core::ops::Deref;
 
+        use bytes::Buf;
+
         fn decode_client_state<B: Buf>(buf: B) -> Result<ClientState, Error> {
             RawTmClientState::decode(buf)
                 .map_err(Error::Decode)?
@@ -783,22 +782,21 @@ fn check_header_trusted_next_validator_set(
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
-    use crate::Height;
     use core::time::Duration;
-    use test_log::test;
 
     use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
     use ibc_proto::ics23::ProofSpec as Ics23ProofSpec;
+    use test_log::test;
 
+    use super::*;
     use crate::clients::ics07_tendermint::client_state::AllowUpdate;
     use crate::clients::ics07_tendermint::error::Error;
+    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::ChainId;
     use crate::core::timestamp::ZERO_DURATION;
+    use crate::Height;
 
     #[derive(Clone, Debug, PartialEq)]
     struct ClientStateParams {
@@ -1120,10 +1118,11 @@ mod serde_tests {
 
 #[cfg(any(test, feature = "mocks"))]
 pub mod test_util {
-    use crate::prelude::*;
     use core::str::FromStr;
     use core::time::Duration;
 
+    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
     use tendermint::block::Header;
 
     use crate::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
@@ -1131,8 +1130,7 @@ pub mod test_util {
     use crate::core::ics02_client::height::Height;
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::ChainId;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+    use crate::prelude::*;
 
     impl ClientState {
         pub fn new_dummy_from_raw(frozen_height: RawHeight) -> Result<Self, Error> {
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs b/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs
index 5dc2aa02e..9e3c3141a 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs
@@ -1,7 +1,6 @@
 use tendermint_light_client_verifier::Verifier;
 
-use crate::prelude::*;
-
+use super::{check_header_trusted_next_validator_set, ClientState};
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
 use crate::clients::ics07_tendermint::error::{Error, IntoResult};
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
@@ -12,8 +11,7 @@ use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::ClientConsensusStatePath;
 use crate::core::timestamp::Timestamp;
-
-use super::{check_header_trusted_next_validator_set, ClientState};
+use crate::prelude::*;
 
 impl ClientState {
     // verify_misbehaviour determines whether or not two conflicting headers at
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs b/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
index 86050de97..34c10e464 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
@@ -1,8 +1,7 @@
-use crate::prelude::*;
-
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
+use super::{check_header_trusted_next_validator_set, ClientState};
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
 use crate::clients::ics07_tendermint::error::{Error, IntoResult};
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
@@ -10,8 +9,7 @@ use crate::clients::ics07_tendermint::ValidationContext as TmValidationContext;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::ClientConsensusStatePath;
-
-use super::{check_header_trusted_next_validator_set, ClientState};
+use crate::prelude::*;
 
 impl ClientState {
     pub fn verify_header<ClientValidationContext>(
diff --git a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
index b5b7f476e..39c654364 100644
--- a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
@@ -1,11 +1,11 @@
 //! Defines Tendermint's `ConsensusState` type
 
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::ConsensusState as RawConsensusState;
 use ibc_proto::protobuf::Protobuf;
-use tendermint::{hash::Algorithm, time::Time, Hash};
+use tendermint::hash::Algorithm;
+use tendermint::time::Time;
+use tendermint::Hash;
 use tendermint_proto::google::protobuf as tpb;
 
 use crate::clients::ics07_tendermint::error::Error;
@@ -14,6 +14,7 @@ use crate::core::ics02_client::consensus_state::ConsensusState as ConsensusState
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics23_commitment::commitment::CommitmentRoot;
 use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
 
 pub const TENDERMINT_CONSENSUS_STATE_TYPE_URL: &str =
     "/ibc.lightclients.tendermint.v1.ConsensusState";
@@ -99,8 +100,9 @@ impl TryFrom<Any> for ConsensusState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use bytes::Buf;
         use core::ops::Deref;
+
+        use bytes::Buf;
         use prost::Message;
 
         fn decode_consensus_state<B: Buf>(buf: B) -> Result<ConsensusState, Error> {
diff --git a/crates/ibc/src/clients/ics07_tendermint/context.rs b/crates/ibc/src/clients/ics07_tendermint/context.rs
index 3c3674389..b62cc1680 100644
--- a/crates/ibc/src/clients/ics07_tendermint/context.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/context.rs
@@ -1,16 +1,12 @@
 use alloc::string::ToString;
 
-use crate::{
-    core::{
-        ics02_client::ClientExecutionContext,
-        ics24_host::{identifier::ClientId, path::ClientConsensusStatePath},
-        timestamp::Timestamp,
-        ContextError,
-    },
-    Height,
-};
-
 use super::consensus_state::ConsensusState as TmConsensusState;
+use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics24_host::identifier::ClientId;
+use crate::core::ics24_host::path::ClientConsensusStatePath;
+use crate::core::timestamp::Timestamp;
+use crate::core::ContextError;
+use crate::Height;
 
 /// Client's context required during both validation and execution
 pub trait CommonContext {
diff --git a/crates/ibc/src/clients/ics07_tendermint/error.rs b/crates/ibc/src/clients/ics07_tendermint/error.rs
index f89878f91..135cb1948 100644
--- a/crates/ibc/src/clients/ics07_tendermint/error.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/error.rs
@@ -1,11 +1,5 @@
 //! Defines the Tendermint light client's error type
 
-use crate::prelude::*;
-
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
-use crate::Height;
-
 use core::time::Duration;
 
 use displaydoc::Display;
@@ -14,6 +8,11 @@ use tendermint_light_client_verifier::errors::VerificationErrorDetail as LightCl
 use tendermint_light_client_verifier::operations::VotingPowerTally;
 use tendermint_light_client_verifier::Verdict;
 
+use crate::core::ics02_client::error::ClientError;
+use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
+use crate::prelude::*;
+use crate::Height;
+
 /// The main error type
 #[derive(Debug, Display)]
 pub enum Error {
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index d24cf409c..614f4dd5a 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -1,6 +1,5 @@
 //! Defines the domain type for tendermint headers
 
-use crate::prelude::*;
 use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
@@ -9,6 +8,7 @@ use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::protobuf::Protobuf;
+use pretty::{PrettySignedHeader, PrettyValidatorSet};
 use prost::Message;
 use tendermint::block::signed_header::SignedHeader;
 use tendermint::chain::Id as TmChainId;
@@ -20,10 +20,9 @@ use crate::clients::ics07_tendermint::error::Error;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ChainId;
 use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
 use crate::Height;
 
-use pretty::{PrettySignedHeader, PrettyValidatorSet};
-
 pub(crate) const TENDERMINT_HEADER_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Header";
 
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -263,8 +262,7 @@ pub mod test_util {
 
     use subtle_encoding::hex;
     use tendermint::block::signed_header::SignedHeader;
-    use tendermint::validator::Info as ValidatorInfo;
-    use tendermint::validator::Set as ValidatorSet;
+    use tendermint::validator::{Info as ValidatorInfo, Set as ValidatorSet};
     use tendermint::PublicKey;
 
     use crate::clients::ics07_tendermint::header::Header;
diff --git a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
index d81a47621..646eb6781 100644
--- a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
@@ -1,7 +1,5 @@
 //! Defines the misbehaviour type for the tendermint light client
 
-use crate::prelude::*;
-
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Misbehaviour as RawMisbehaviour;
@@ -12,6 +10,7 @@ use crate::clients::ics07_tendermint::error::Error;
 use crate::clients::ics07_tendermint::header::Header;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
+use crate::prelude::*;
 
 const TENDERMINT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Misbehaviour";
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/mod.rs b/crates/ibc/src/clients/ics07_tendermint/mod.rs
index 2bb58ec4b..803e7814e 100644
--- a/crates/ibc/src/clients/ics07_tendermint/mod.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/mod.rs
@@ -1,9 +1,10 @@
 //! ICS 07: Tendermint Client implements a client verification algorithm for blockchains which use
 //! the Tendermint consensus algorithm.
 
-use crate::core::ics02_client::client_type::ClientType;
 use core::str::FromStr;
 
+use crate::core::ics02_client::client_type::ClientType;
+
 pub mod client_state;
 pub mod consensus_state;
 pub mod error;
diff --git a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs b/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
index 2ae58f3d6..d4e4e9c86 100644
--- a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
@@ -2,10 +2,8 @@
 //! represented as a fraction with valid values in the
 //! range `[0, 1)`.
 
-use core::{
-    convert::TryFrom,
-    fmt::{Display, Error as FmtError, Formatter},
-};
+use core::convert::TryFrom;
+use core::fmt::{Display, Error as FmtError, Formatter};
 
 use ibc_proto::ibc::lightclients::tendermint::v1::Fraction;
 use ibc_proto::protobuf::Protobuf;
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index b74437af1..9d9ae5e77 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -1,12 +1,14 @@
-use crate::prelude::*;
-
-use crate::signer::Signer;
 use alloc::string::String;
 use core::time::Duration;
+
 use derive_more::From;
 use displaydoc::Display;
 use ibc_proto::google::protobuf::Any;
 
+use super::ics02_client::client_state::ClientState;
+use super::ics02_client::consensus_state::ConsensusState;
+use super::ics02_client::ClientExecutionContext;
+use super::ics24_host::identifier::PortId;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::ConnectionEnd;
@@ -17,24 +19,19 @@ use crate::core::ics03_connection::version::{
 use crate::core::ics04_channel::channel::ChannelEnd;
 use crate::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
 use crate::core::ics04_channel::context::calculate_block_delay;
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::error::PacketError;
+use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics04_channel::packet::{Receipt, Sequence};
 use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::identifier::ConnectionId;
+use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
 use crate::core::ics24_host::path::{
     AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
     ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
 };
 use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
+use crate::signer::Signer;
 use crate::Height;
 
-use super::ics02_client::client_state::ClientState;
-use super::ics02_client::consensus_state::ConsensusState;
-use super::ics02_client::ClientExecutionContext;
-use super::ics24_host::identifier::PortId;
-
 /// Top-level error
 #[derive(Debug, Display, From)]
 pub enum ContextError {
diff --git a/crates/ibc/src/core/events.rs b/crates/ibc/src/core/events.rs
index 0d8d654a9..6b451c960 100644
--- a/crates/ibc/src/core/events.rs
+++ b/crates/ibc/src/core/events.rs
@@ -1,20 +1,17 @@
 //! Events emitted during message handling
 
-use crate::prelude::*;
-
 use core::convert::{TryFrom, TryInto};
+
 use displaydoc::Display;
 use tendermint::abci;
 
+use super::ics24_host::identifier::IdentifierError;
 use crate::core::ics02_client::error as client_error;
 use crate::core::ics02_client::events::{self as ClientEvents};
-use crate::core::ics03_connection::error as connection_error;
-use crate::core::ics03_connection::events as ConnectionEvents;
-use crate::core::ics04_channel::error as channel_error;
-use crate::core::ics04_channel::events as ChannelEvents;
+use crate::core::ics03_connection::{error as connection_error, events as ConnectionEvents};
+use crate::core::ics04_channel::{error as channel_error, events as ChannelEvents};
 use crate::core::timestamp::ParseTimestampError;
-
-use super::ics24_host::identifier::IdentifierError;
+use crate::prelude::*;
 
 /// All error variants related to IBC events
 #[derive(Debug, Display)]
@@ -284,17 +281,14 @@ impl From<MessageEvent> for IbcEvent {
 
 #[cfg(test)]
 pub mod tests {
-    use super::*;
     use alloc::vec;
 
-    use crate::core::{
-        ics04_channel::{
-            channel::Order,
-            events::SendPacket,
-            packet::{test_utils::get_dummy_raw_packet, Packet},
-        },
-        ics24_host::identifier::ConnectionId,
-    };
+    use super::*;
+    use crate::core::ics04_channel::channel::Order;
+    use crate::core::ics04_channel::events::SendPacket;
+    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
+    use crate::core::ics04_channel::packet::Packet;
+    use crate::core::ics24_host::identifier::ConnectionId;
 
     #[test]
     /// Ensures that we don't panic when packet data is not valid UTF-8.
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index faa3216a6..5ddebcf97 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -202,51 +202,53 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use core::default::Default;
     use core::time::Duration;
 
     use test_log::test;
 
+    use super::*;
     use crate::applications::transfer::error::TokenTransferError;
-    use crate::applications::transfer::send_transfer;
-    use crate::applications::transfer::{msgs::transfer::MsgTransfer, MODULE_ID_STR};
+    use crate::applications::transfer::msgs::transfer::MsgTransfer;
+    use crate::applications::transfer::{send_transfer, MODULE_ID_STR};
     use crate::core::dispatch;
     use crate::core::events::{IbcEvent, MessageEvent};
-    use crate::core::ics02_client::msgs::{
-        create_client::MsgCreateClient, update_client::MsgUpdateClient,
-        upgrade_client::MsgUpgradeClient, ClientMsg,
-    };
+    use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
+    use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
+    use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
+    use crate::core::ics02_client::msgs::ClientMsg;
     use crate::core::ics03_connection::connection::{
         ConnectionEnd, Counterparty as ConnCounterparty, State as ConnState,
     };
-    use crate::core::ics03_connection::msgs::{
-        conn_open_ack::MsgConnectionOpenAck, conn_open_init::MsgConnectionOpenInit,
-        conn_open_try::MsgConnectionOpenTry, ConnectionMsg,
-    };
+    use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
+    use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
+    use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
+    use crate::core::ics03_connection::msgs::ConnectionMsg;
     use crate::core::ics03_connection::version::Version as ConnVersion;
-    use crate::core::ics04_channel::channel::ChannelEnd;
-    use crate::core::ics04_channel::channel::Counterparty as ChannelCounterparty;
-    use crate::core::ics04_channel::channel::Order as ChannelOrder;
-    use crate::core::ics04_channel::channel::State as ChannelState;
+    use crate::core::ics04_channel::channel::{
+        ChannelEnd, Counterparty as ChannelCounterparty, Order as ChannelOrder,
+        State as ChannelState,
+    };
     use crate::core::ics04_channel::error::ChannelError;
     use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_ack_with_packet;
     use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
+    use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
+    use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
+    use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
+    use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
+    use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
+    use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
     use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
     use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-    use crate::core::ics04_channel::msgs::{
-        chan_close_confirm::{
-            test_util::get_dummy_raw_msg_chan_close_confirm, MsgChannelCloseConfirm,
-        },
-        chan_close_init::{test_util::get_dummy_raw_msg_chan_close_init, MsgChannelCloseInit},
-        chan_open_ack::{test_util::get_dummy_raw_msg_chan_open_ack, MsgChannelOpenAck},
-        chan_open_init::{test_util::get_dummy_raw_msg_chan_open_init, MsgChannelOpenInit},
-        chan_open_try::{test_util::get_dummy_raw_msg_chan_open_try, MsgChannelOpenTry},
-        recv_packet::{test_util::get_dummy_raw_msg_recv_packet, MsgRecvPacket},
-        timeout_on_close::{test_util::get_dummy_raw_msg_timeout_on_close, MsgTimeoutOnClose},
-        ChannelMsg, PacketMsg,
-    };
+    use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
+    use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
+    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
+    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
+    use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
+    use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
+    use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
+    use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
+    use crate::core::ics04_channel::msgs::{ChannelMsg, PacketMsg};
     use crate::core::ics04_channel::timeout::TimeoutHeight;
     use crate::core::ics04_channel::Version as ChannelVersion;
     use crate::core::ics23_commitment::commitment::CommitmentPrefix;
diff --git a/crates/ibc/src/core/ics02_client/client_type.rs b/crates/ibc/src/core/ics02_client/client_type.rs
index d842e84b3..b223fbdae 100644
--- a/crates/ibc/src/core/ics02_client/client_type.rs
+++ b/crates/ibc/src/core/ics02_client/client_type.rs
@@ -1,14 +1,11 @@
 //! Defines the `ClientType` format, typically used in chain IDs.
 
+use core::fmt::{Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use crate::core::ics24_host::identifier::validate::validate_client_type;
+use crate::core::ics24_host::identifier::IdentifierError;
 use crate::prelude::*;
-use core::{
-    fmt::{Display, Error as FmtError, Formatter},
-    str::FromStr,
-};
-
-use crate::core::ics24_host::{
-    identifier::validate::validate_client_type, identifier::IdentifierError,
-};
 
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/crates/ibc/src/core/ics02_client/consensus_state.rs b/crates/ibc/src/core/ics02_client/consensus_state.rs
index 377272b0d..17a4ebbec 100644
--- a/crates/ibc/src/core/ics02_client/consensus_state.rs
+++ b/crates/ibc/src/core/ics02_client/consensus_state.rs
@@ -1,16 +1,15 @@
 //! Defines the trait to be implemented by all concrete consensus state types
 
-use crate::prelude::*;
-
 use core::marker::{Send, Sync};
 
-use crate::core::ics23_commitment::commitment::CommitmentRoot;
-use crate::core::timestamp::Timestamp;
-
 /// Derive macro that implements [`ConsensusState`] for enums containing
 /// variants that implement [`ConsensusState`]
 pub use ibc_derive::ConsensusState;
 
+use crate::core::ics23_commitment::commitment::CommitmentRoot;
+use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
+
 /// Defines methods that all `ConsensusState`s should provide.
 ///
 /// One can think of a "consensus state" as a pruned header, to be stored on chain. In other words,
diff --git a/crates/ibc/src/core/ics02_client/context.rs b/crates/ibc/src/core/ics02_client/context.rs
index 4423d4690..f07c51e9e 100644
--- a/crates/ibc/src/core/ics02_client/context.rs
+++ b/crates/ibc/src/core/ics02_client/context.rs
@@ -1,7 +1,6 @@
 use super::client_state::ClientState;
 use super::consensus_state::ConsensusState;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::ics24_host::path::ClientStatePath;
+use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
 use crate::core::ContextError;
 
 /// Defines the methods that all client `ExecutionContext`s (precisely the
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index 826341c34..c055863cf 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -1,19 +1,17 @@
 //! Defines the client error type
 
-use crate::prelude::*;
-
 use displaydoc::Display;
 use ibc_proto::protobuf::Error as TendermintProtoError;
 
+use super::client_state::Status;
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics23_commitment::error::CommitmentError;
 use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
 use crate::core::timestamp::Timestamp;
 use crate::core::ContextError;
+use crate::prelude::*;
 use crate::Height;
 
-use super::client_state::Status;
-
 /// Encodes all the possible client errors
 #[derive(Debug, Display)]
 pub enum ClientError {
diff --git a/crates/ibc/src/core/ics02_client/events.rs b/crates/ibc/src/core/ics02_client/events.rs
index 01e4c586a..8b9f027cb 100644
--- a/crates/ibc/src/core/ics02_client/events.rs
+++ b/crates/ibc/src/core/ics02_client/events.rs
@@ -1,6 +1,4 @@
 //! Types for the IBC events emitted from Tendermint Websocket by the client module.
-use crate::prelude::*;
-
 use derive_more::From;
 use subtle_encoding::hex;
 use tendermint::abci;
@@ -8,6 +6,7 @@ use tendermint::abci;
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::height::Height;
 use crate::core::ics24_host::identifier::ClientId;
+use crate::prelude::*;
 
 /// Client event types
 const CREATE_CLIENT_EVENT: &str = "create_client";
@@ -421,14 +420,16 @@ impl From<UpgradeClient> for abci::Event {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-    use crate::core::timestamp::Timestamp;
-    use crate::mock::header::MockHeader;
+    use std::str::FromStr;
+
     use ibc_proto::google::protobuf::Any;
     use prost::Message;
-    use std::str::FromStr;
     use tendermint::abci::Event as AbciEvent;
 
+    use super::*;
+    use crate::core::timestamp::Timestamp;
+    use crate::mock::header::MockHeader;
+
     #[test]
     fn ibc_to_abci_client_events() {
         struct Test {
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index e3ee280ab..ff770a22b 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -1,18 +1,14 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgCreateClient`.
 
-use crate::prelude::*;
-
 use crate::core::context::ContextError;
-use crate::core::events::IbcEvent;
-use crate::core::events::MessageEvent;
-use crate::core::ics02_client::client_state::ClientStateCommon;
-use crate::core::ics02_client::client_state::ClientStateExecution;
+use crate::core::events::{IbcEvent, MessageEvent};
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateExecution};
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics02_client::events::CreateClient;
 use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
 use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ExecutionContext;
-use crate::core::ValidationContext;
+use crate::core::{ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
 where
@@ -104,10 +100,9 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use test_log::test;
 
+    use super::*;
     use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
     use crate::clients::ics07_tendermint::client_type as tm_client_type;
     use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index d0e2e0712..1aa200b1e 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -1,18 +1,17 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpdateAnyClient`.
 
-use crate::prelude::*;
 use prost::Message;
 
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateCommon;
-use crate::core::ics02_client::client_state::ClientStateExecution;
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::client_state::UpdateKind;
+use crate::core::ics02_client::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation, UpdateKind,
+};
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics02_client::events::{ClientMisbehaviour, UpdateClient};
 use crate::core::ics02_client::msgs::MsgUpdateOrMisbehaviour;
 use crate::core::{ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
 where
@@ -133,13 +132,14 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use core::str::FromStr;
     use core::time::Duration;
+
     use ibc_proto::google::protobuf::Any;
+    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
     use test_log::test;
 
+    use super::*;
     use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
     use crate::clients::ics07_tendermint::client_type as tm_client_type;
     use crate::clients::ics07_tendermint::header::Header as TmHeader;
@@ -152,16 +152,13 @@ mod tests {
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::{ChainId, ClientId};
     use crate::core::timestamp::Timestamp;
-    use crate::downcast;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::client_state::MockClientState;
+    use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
     use crate::mock::context::{AnyConsensusState, MockContext};
     use crate::mock::header::MockHeader;
     use crate::mock::host::{HostBlock, HostType};
     use crate::mock::misbehaviour::Misbehaviour as MockMisbehaviour;
     use crate::test_utils::get_dummy_account_id;
-    use crate::Height;
-    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+    use crate::{downcast, Height};
 
     #[test]
     fn test_update_client_ok() {
diff --git a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
index 3980d5b77..5e43dc008 100644
--- a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
@@ -1,17 +1,17 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpgradeAnyClient`.
 //!
-use crate::prelude::*;
-
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateExecution;
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
+use crate::core::ics02_client::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation,
+};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics02_client::events::UpgradeClient;
 use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
 use crate::core::ics24_host::path::ClientConsensusStatePath;
 use crate::core::{ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgUpgradeClient) -> Result<(), ContextError>
 where
@@ -85,19 +85,15 @@ where
 #[cfg(test)]
 mod tests {
     use super::*;
-
     use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
     use crate::clients::ics07_tendermint::client_type;
     use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
-
     use crate::core::ics02_client::error::UpgradeClientError;
     use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
     use crate::core::ics24_host::identifier::ClientId;
-    use crate::downcast;
-    use crate::Height;
-
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::{AnyClientState, AnyConsensusState, MockContext};
+    use crate::{downcast, Height};
 
     enum Ctx {
         Default,
diff --git a/crates/ibc/src/core/ics02_client/height.rs b/crates/ibc/src/core/ics02_client/height.rs
index 21297a49d..469337917 100644
--- a/crates/ibc/src/core/ics02_client/height.rs
+++ b/crates/ibc/src/core/ics02_client/height.rs
@@ -1,17 +1,15 @@
 //! Defines the core `Height` type used throughout the library
 
-use crate::prelude::*;
 use core::cmp::Ordering;
-
 use core::num::ParseIntError;
 use core::str::FromStr;
 
 use displaydoc::Display;
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
+use crate::prelude::*;
 
 /// The core IBC height type, which represents the height of a chain,
 /// which typically is the number of blocks since genesis
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index c55e8668c..93cbc126f 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -1,13 +1,12 @@
 //! Definition of domain type message `MsgCreateClient`.
 
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
@@ -75,9 +74,8 @@ impl From<MsgCreateClient> for RawMsgCreateClient {
 #[cfg(test)]
 mod tests {
 
-    use test_log::test;
-
     use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
+    use test_log::test;
 
     use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
     use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index 6ab10266b..02fe61905 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -1,7 +1,5 @@
 //! Definition of domain type message `MsgSubmitMisbehaviour`.
 
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any as ProtoAny;
 use ibc_proto::ibc::core::client::v1::MsgSubmitMisbehaviour as RawMsgSubmitMisbehaviour;
 use ibc_proto::protobuf::Protobuf;
@@ -9,6 +7,7 @@ use ibc_proto::protobuf::Protobuf;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 74e365a44..36ef02b36 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -1,14 +1,13 @@
 //! Definition of domain type message `MsgUpdateClient`.
 
-use crate::core::Msg;
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
+use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
@@ -67,13 +66,11 @@ impl From<MsgUpdateClient> for RawMsgUpdateClient {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
-    use test_log::test;
-
     use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
+    use test_log::test;
 
+    use super::*;
     use crate::clients::ics07_tendermint::header::test_util::get_dummy_ics07_header;
     use crate::core::ics02_client::msgs::MsgUpdateClient;
     use crate::core::ics24_host::identifier::ClientId;
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index f18160f89..55da7a238 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -1,7 +1,5 @@
 //! Definition of domain type msg `MsgUpgradeClient`.
 
-use crate::prelude::*;
-
 use core::str::FromStr;
 
 use ibc_proto::google::protobuf::Any;
@@ -13,6 +11,7 @@ use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics23_commitment::error::CommitmentError;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
@@ -100,13 +99,12 @@ impl TryFrom<RawMsgUpgradeClient> for MsgUpgradeClient {
 #[cfg(test)]
 pub mod test_util {
     use super::*;
-
+    use crate::core::ics02_client::height::Height;
     use crate::core::ics23_commitment::commitment::test_util::get_dummy_commitment_proof_bytes;
-    use crate::core::{ics02_client::height::Height, ics24_host::identifier::ClientId};
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::{
-        client_state::MockClientState, consensus_state::MockConsensusState, header::MockHeader,
-    };
+    use crate::core::ics24_host::identifier::ClientId;
+    use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
+    use crate::mock::consensus_state::MockConsensusState;
+    use crate::mock::header::MockHeader;
     use crate::test_utils::{get_dummy_account_id, get_dummy_bech32_account, get_dummy_proof};
 
     /// Extends the implementation with additional helper methods.
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/crates/ibc/src/core/ics03_connection/connection.rs
index 6ab1513ec..bfb73b645 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/crates/ibc/src/core/ics03_connection/connection.rs
@@ -1,18 +1,14 @@
 //! Defines the types that define a connection
 
-use crate::prelude::*;
-use ibc_proto::protobuf::Protobuf;
-
+use core::fmt::{Display, Error as FmtError, Formatter};
 use core::time::Duration;
-use core::{
-    fmt::{Display, Error as FmtError, Formatter},
-    u64,
-};
+use core::u64;
 
 use ibc_proto::ibc::core::connection::v1::{
     ConnectionEnd as RawConnectionEnd, Counterparty as RawCounterparty,
     IdentifiedConnection as RawIdentifiedConnection,
 };
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::error::ConnectionError;
@@ -20,6 +16,7 @@ use crate::core::ics03_connection::version::Version;
 use crate::core::ics23_commitment::commitment::CommitmentPrefix;
 use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
 use crate::core::timestamp::ZERO_DURATION;
+use crate::prelude::*;
 
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/crates/ibc/src/core/ics03_connection/delay.rs b/crates/ibc/src/core/ics03_connection/delay.rs
index 4536a6d2b..067a84282 100644
--- a/crates/ibc/src/core/ics03_connection/delay.rs
+++ b/crates/ibc/src/core/ics03_connection/delay.rs
@@ -1,6 +1,7 @@
-use crate::core::{ics02_client::height::Height, ContextError, ValidationContext};
-
-use super::{connection::ConnectionEnd, error::ConnectionError};
+use super::connection::ConnectionEnd;
+use super::error::ConnectionError;
+use crate::core::ics02_client::height::Height;
+use crate::core::{ContextError, ValidationContext};
 
 pub fn verify_conn_delay_passed<Ctx>(
     ctx: &Ctx,
diff --git a/crates/ibc/src/core/ics03_connection/error.rs b/crates/ibc/src/core/ics03_connection/error.rs
index 28512f9dd..3364a274c 100644
--- a/crates/ibc/src/core/ics03_connection/error.rs
+++ b/crates/ibc/src/core/ics03_connection/error.rs
@@ -1,15 +1,16 @@
 //! Defines the connection error type
 
+use alloc::string::String;
+
+use displaydoc::Display;
+use ibc_proto::protobuf::Error as ProtoError;
+
 use crate::core::ics02_client::error as client_error;
 use crate::core::ics03_connection::version::Version;
 use crate::core::ics24_host::identifier::{ClientId, ConnectionId, IdentifierError};
 use crate::core::timestamp::{Timestamp, TimestampOverflowError};
 use crate::Height;
 
-use alloc::string::String;
-use displaydoc::Display;
-use ibc_proto::protobuf::Error as ProtoError;
-
 #[derive(Debug, Display)]
 pub enum ConnectionError {
     /// client error: `{0}`
diff --git a/crates/ibc/src/core/ics03_connection/events.rs b/crates/ibc/src/core/ics03_connection/events.rs
index ed8dcd2c9..dcc0f38f9 100644
--- a/crates/ibc/src/core/ics03_connection/events.rs
+++ b/crates/ibc/src/core/ics03_connection/events.rs
@@ -1,9 +1,9 @@
 //! Types for the IBC events emitted from Tendermint Websocket by the connection module.
 
-use crate::prelude::*;
 use tendermint::abci;
 
 use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+use crate::prelude::*;
 
 /// Connection event types
 const CONNECTION_OPEN_INIT_EVENT: &str = "connection_open_init";
@@ -306,11 +306,13 @@ impl From<OpenConfirm> for abci::Event {
 #[cfg(test)]
 mod tests {
 
-    use super::*;
-    use crate::core::ics02_client::client_type::ClientType;
     use std::str::FromStr;
+
     use tendermint::abci::Event as AbciEvent;
 
+    use super::*;
+    use crate::core::ics02_client::client_type::ClientType;
+
     #[test]
     fn ibc_to_abci_connection_events() {
         struct Test {
diff --git a/crates/ibc/src/core/ics03_connection/handler.rs b/crates/ibc/src/core/ics03_connection/handler.rs
index 8946943c6..a79a2d87b 100644
--- a/crates/ibc/src/core/ics03_connection/handler.rs
+++ b/crates/ibc/src/core/ics03_connection/handler.rs
@@ -8,10 +8,12 @@ pub mod conn_open_try;
 
 #[cfg(test)]
 pub mod test_util {
+    use alloc::format;
     use core::fmt::Debug;
 
-    use crate::{core::ContextError, mock::context::MockContext, prelude::String};
-    use alloc::format;
+    use crate::core::ContextError;
+    use crate::mock::context::MockContext;
+    use crate::prelude::String;
 
     pub enum Expect {
         Success,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index 8ca94b4a1..1aee37d96 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -4,6 +4,7 @@ use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
+use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
@@ -12,13 +13,12 @@ use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenAck;
 use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
 use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, ConnectionPath};
+use crate::core::ics24_host::path::{
+    ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
+};
 use crate::core::{ExecutionContext, ValidationContext};
 use crate::prelude::*;
 
-use crate::core::events::{IbcEvent, MessageEvent};
-
 pub(crate) fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
@@ -205,19 +205,18 @@ impl LocalVars {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use core::str::FromStr;
+
     use test_log::test;
 
+    use super::*;
+    use crate::core::events::IbcEvent;
     use crate::core::ics02_client::height::Height;
     use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
     use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
     use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
     use crate::core::ics23_commitment::commitment::CommitmentPrefix;
     use crate::core::ics24_host::identifier::{ChainId, ClientId};
-
-    use crate::core::events::IbcEvent;
     use crate::core::timestamp::ZERO_DURATION;
     use crate::mock::context::MockContext;
     use crate::mock::host::HostType;
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
index 56a96b45b..e5c1251c6 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
@@ -3,6 +3,7 @@
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::context::ContextError;
+use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
@@ -11,13 +12,10 @@ use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenConfirm;
 use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
 use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ConnectionPath};
+use crate::core::ics24_host::path::{ClientConsensusStatePath, ConnectionPath, Path};
 use crate::core::{ExecutionContext, ValidationContext};
 use crate::prelude::*;
 
-use crate::core::events::{IbcEvent, MessageEvent};
-
 pub(crate) fn validate<Ctx>(ctx_b: &Ctx, msg: &MsgConnectionOpenConfirm) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
@@ -173,11 +171,11 @@ impl LocalVars {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use core::str::FromStr;
+
     use test_log::test;
 
+    use super::*;
     use crate::core::events::IbcEvent;
     use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
     use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
index 1d7e11a5c..6ee7daedc 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
@@ -1,16 +1,15 @@
 //! Protocol logic specific to ICS3 messages of type `MsgConnectionOpenInit`.
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
+use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
 use crate::core::ics03_connection::events::OpenInit;
 use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
 use crate::core::ics24_host::identifier::ConnectionId;
 use crate::core::ics24_host::path::{ClientConnectionPath, ConnectionPath};
 use crate::core::{ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenInit) -> Result<(), ContextError>
 where
@@ -90,8 +89,9 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
+    use test_log::test;
 
+    use super::*;
     use crate::core::events::IbcEvent;
     use crate::core::ics03_connection::connection::State;
     use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
@@ -99,7 +99,6 @@ mod tests {
     use crate::core::ics03_connection::version::Version;
     use crate::mock::context::MockContext;
     use crate::Height;
-    use test_log::test;
 
     enum Ctx {
         Default,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 090f3ede5..2cdd5da8c 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -4,6 +4,7 @@ use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
+use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
@@ -11,17 +12,13 @@ use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, Sta
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::events::OpenTry;
 use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::identifier::ConnectionId;
-use crate::core::ics24_host::path::Path;
+use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
 use crate::core::ics24_host::path::{
-    ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath,
+    ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
 };
 use crate::core::{ExecutionContext, ValidationContext};
 use crate::prelude::*;
 
-use crate::core::events::{IbcEvent, MessageEvent};
-
 pub(crate) fn validate<Ctx>(ctx_b: &Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
@@ -208,10 +205,9 @@ impl LocalVars {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use test_log::test;
 
+    use super::*;
     use crate::core::events::IbcEvent;
     use crate::core::ics03_connection::connection::State;
     use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/crates/ibc/src/core/ics03_connection/msgs.rs
index 486ce3956..4adae4c9b 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs.rs
@@ -38,11 +38,12 @@ pub enum ConnectionMsg {
 #[cfg(test)]
 pub mod test_util {
 
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::prelude::*;
     use ibc_proto::ibc::core::commitment::v1::MerklePrefix;
     use ibc_proto::ibc::core::connection::v1::Counterparty as RawCounterparty;
 
+    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::prelude::*;
+
     pub fn get_dummy_raw_counterparty(conn_id: Option<u64>) -> RawCounterparty {
         let connection_id = match conn_id {
             Some(id) => ConnectionId::new(id).to_string(),
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index 5b57756f7..415cd3983 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
 use ibc_proto::protobuf::Protobuf;
@@ -9,6 +7,7 @@ use crate::core::ics03_connection::version::Version;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::ConnectionId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -132,19 +131,18 @@ impl From<MsgConnectionOpenAck> for RawMsgConnectionOpenAck {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::core::ics02_client::height::Height;
-    use crate::mock::client_state::MockClientState;
-    use crate::mock::header::MockHeader;
-    use crate::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
 
+    use super::MsgConnectionOpenAck;
+    use crate::core::ics02_client::height::Height;
     use crate::core::ics03_connection::version::Version;
     use crate::core::ics24_host::identifier::ConnectionId;
+    use crate::mock::client_state::MockClientState;
+    use crate::mock::header::MockHeader;
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
 
-    use super::MsgConnectionOpenAck;
-
     /// Testing-specific helper methods.
     impl MsgConnectionOpenAck {
         /// Returns a new `MsgConnectionOpenAck` with dummy values.
@@ -186,15 +184,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+    use test_log::test;
 
     use crate::core::ics03_connection::msgs::conn_open_ack::test_util::get_dummy_raw_msg_conn_open_ack;
     use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
+    use crate::prelude::*;
 
     #[test]
     fn parse_connection_open_ack_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
index 4f0337a69..cb1528dc3 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
@@ -1,14 +1,13 @@
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::{prelude::*, Height};
-
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics03_connection::error::ConnectionError;
+use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::ConnectionId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
+use crate::Height;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenConfirm";
 
@@ -74,11 +73,11 @@ impl From<MsgConnectionOpenConfirm> for RawMsgConnectionOpenConfirm {
 
 #[cfg(test)]
 pub mod test_util {
-    use super::MsgConnectionOpenConfirm;
-    use crate::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
 
+    use super::MsgConnectionOpenConfirm;
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
 
     /// Testing-specific helper methods.
@@ -104,15 +103,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+    use test_log::test;
 
     use crate::core::ics03_connection::msgs::conn_open_confirm::test_util::get_dummy_raw_msg_conn_open_confirm;
     use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
+    use crate::prelude::*;
 
     #[test]
     fn parse_connection_open_confirm_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index d6732f258..322f28cc2 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use core::time::Duration;
 
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenInit as RawMsgConnectionOpenInit;
@@ -10,6 +8,7 @@ use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::version::Version;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenInit";
@@ -38,10 +37,8 @@ impl Msg for MsgConnectionOpenInit {
 /// `BorshSerialize` and `BorshDeserialize` on `MsgConnectionOpenInit`
 #[cfg(feature = "borsh")]
 mod borsh_impls {
-    use borsh::{
-        maybestd::io::{self, Read},
-        BorshDeserialize, BorshSerialize,
-    };
+    use borsh::maybestd::io::{self, Read};
+    use borsh::{BorshDeserialize, BorshSerialize};
 
     use super::*;
 
@@ -132,16 +129,16 @@ impl From<MsgConnectionOpenInit> for RawMsgConnectionOpenInit {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::core::ics03_connection::connection::Counterparty;
-    use crate::prelude::*;
     use ibc_proto::ibc::core::connection::v1::{
         MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
     };
 
+    use crate::core::ics03_connection::connection::Counterparty;
     use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::Version;
     use crate::core::ics24_host::identifier::ClientId;
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     /// Extends the implementation with additional helper methods.
@@ -199,16 +196,15 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
+    use ibc_proto::ibc::core::connection::v1::{
+        Counterparty as RawCounterparty, MsgConnectionOpenInit as RawMsgConnectionOpenInit,
+    };
     use test_log::test;
 
-    use ibc_proto::ibc::core::connection::v1::Counterparty as RawCounterparty;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenInit as RawMsgConnectionOpenInit;
-
     use super::MsgConnectionOpenInit;
     use crate::core::ics03_connection::msgs::conn_open_init::test_util::get_dummy_raw_msg_conn_open_init;
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
+    use crate::prelude::*;
 
     #[test]
     fn parse_connection_open_init_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index 11f7fb884..64269f075 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -1,9 +1,5 @@
-use crate::prelude::*;
-
-use core::{
-    convert::{TryFrom, TryInto},
-    time::Duration,
-};
+use core::convert::{TryFrom, TryInto};
+use core::time::Duration;
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
@@ -15,6 +11,7 @@ use crate::core::ics03_connection::version::Version;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -63,10 +60,8 @@ impl Msg for MsgConnectionOpenTry {
 #[allow(deprecated)]
 #[cfg(feature = "borsh")]
 mod borsh_impls {
-    use borsh::{
-        maybestd::io::{self, Read},
-        BorshDeserialize, BorshSerialize,
-    };
+    use borsh::maybestd::io::{self, Read};
+    use borsh::{BorshDeserialize, BorshSerialize};
 
     use super::*;
 
@@ -248,17 +243,17 @@ impl From<MsgConnectionOpenTry> for RawMsgConnectionOpenTry {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::core::ics02_client::height::Height;
-    use crate::mock::client_state::MockClientState;
-    use crate::mock::header::MockHeader;
-    use crate::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
 
+    use crate::core::ics02_client::height::Height;
     use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::mock::client_state::MockClientState;
+    use crate::mock::header::MockHeader;
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
 
     /// Testing-specific helper methods.
@@ -320,17 +315,16 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_proto::ibc::core::connection::v1::Counterparty as RawCounterparty;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
+    use ibc_proto::ibc::core::connection::v1::{
+        Counterparty as RawCounterparty, MsgConnectionOpenTry as RawMsgConnectionOpenTry,
+    };
+    use test_log::test;
 
     use crate::core::ics03_connection::msgs::conn_open_try::test_util::get_dummy_raw_msg_conn_open_try;
     use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
+    use crate::prelude::*;
 
     #[test]
     fn parse_connection_open_try_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/version.rs b/crates/ibc/src/core/ics03_connection/version.rs
index ba6fdb9a6..dcdb2b9f8 100644
--- a/crates/ibc/src/core/ics03_connection/version.rs
+++ b/crates/ibc/src/core/ics03_connection/version.rs
@@ -2,14 +2,13 @@
 
 use core::fmt::Display;
 
-use crate::prelude::*;
-use crate::utils::pretty::PrettySlice;
-
 use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics04_channel::channel::Order;
+use crate::prelude::*;
+use crate::utils::pretty::PrettySlice;
 
 /// Stores the identifier and the features supported by a version
 #[cfg_attr(
@@ -189,14 +188,12 @@ fn get_feature_set_intersection(
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
+    use test_log::test;
 
     use crate::core::ics03_connection::error::ConnectionError;
     use crate::core::ics03_connection::version::{get_compatible_versions, pick_version, Version};
+    use crate::prelude::*;
 
     fn get_dummy_features() -> Vec<String> {
         vec!["ORDER_RANDOM".to_string(), "ORDER_UNORDERED".to_string()]
diff --git a/crates/ibc/src/core/ics04_channel/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
index 3b3ebb844..4c5d08cd7 100644
--- a/crates/ibc/src/core/ics04_channel/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
@@ -1,6 +1,7 @@
 //! Defines acknowledgment types used by various IBC messages and applications.
 
 use core::fmt::{Display, Error as FmtError, Formatter};
+
 use derive_more::Into;
 
 use super::error::PacketError;
@@ -142,7 +143,8 @@ impl From<AcknowledgementStatus> for Acknowledgement {
 #[cfg(test)]
 mod test {
     use super::*;
-    use crate::applications::transfer::{ack_success_b64, error::TokenTransferError};
+    use crate::applications::transfer::ack_success_b64;
+    use crate::applications::transfer::error::TokenTransferError;
 
     #[test]
     fn test_ack_ser() {
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 0c77c99be..7cfac5265 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -1,20 +1,19 @@
 //! Implementation of IBC channels, as described in ICS 4.
 
-use crate::prelude::*;
-use crate::utils::pretty::PrettySlice;
-
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::channel::v1::{
     Channel as RawChannel, Counterparty as RawCounterparty,
     IdentifiedChannel as RawIdentifiedChannel,
 };
+use ibc_proto::protobuf::Protobuf;
 
-use crate::core::ics04_channel::{error::ChannelError, Version};
+use crate::core::ics04_channel::error::ChannelError;
+use crate::core::ics04_channel::Version;
 use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use crate::prelude::*;
+use crate::utils::pretty::PrettySlice;
 
 /// A [`ChannelEnd`] along with its ID and the port it is bound to
 #[cfg_attr(
@@ -573,10 +572,12 @@ impl Display for State {
 
 #[cfg(test)]
 pub mod test_util {
+    use ibc_proto::ibc::core::channel::v1::{
+        Channel as RawChannel, Counterparty as RawCounterparty,
+    };
+
     use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
     use crate::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::Channel as RawChannel;
-    use ibc_proto::ibc::core::channel::v1::Counterparty as RawCounterparty;
 
     /// Returns a dummy `RawCounterparty`, for testing only!
     /// Can be optionally parametrized with a specific channel identifier.
@@ -605,15 +606,14 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
     use core::str::FromStr;
-    use test_log::test;
 
     use ibc_proto::ibc::core::channel::v1::Channel as RawChannel;
+    use test_log::test;
 
     use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
     use crate::core::ics04_channel::channel::ChannelEnd;
+    use crate::prelude::*;
 
     #[test]
     fn channel_end_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/commitment.rs b/crates/ibc/src/core/ics04_channel/commitment.rs
index f389673e6..c2979e910 100644
--- a/crates/ibc/src/core/ics04_channel/commitment.rs
+++ b/crates/ibc/src/core/ics04_channel/commitment.rs
@@ -1,11 +1,10 @@
 //! Types and utilities related to packet commitments.
 
+use super::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::timeout::TimeoutHeight;
 use crate::core::timestamp::Timestamp;
 use crate::prelude::*;
 
-use super::acknowledgement::Acknowledgement;
-
 /// Packet commitment
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/crates/ibc/src/core/ics04_channel/context.rs
index 3e24e1729..aa7794a2e 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/crates/ibc/src/core/ics04_channel/context.rs
@@ -1,23 +1,23 @@
 //! ICS4 (channel) context.
 
-use crate::core::events::IbcEvent;
-use crate::core::ics02_client::client_state::ClientState;
-use crate::core::ics02_client::ClientExecutionContext;
-use crate::core::ics24_host::path::{
-    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
-};
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
 use core::time::Duration;
+
 use num_traits::float::FloatCore;
 
+use super::packet::Sequence;
+use crate::core::events::IbcEvent;
+use crate::core::ics02_client::client_state::ClientState;
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::ClientExecutionContext;
 use crate::core::ics03_connection::connection::ConnectionEnd;
 use crate::core::ics04_channel::channel::ChannelEnd;
 use crate::core::ics04_channel::commitment::PacketCommitment;
 use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-
-use super::packet::Sequence;
+use crate::core::ics24_host::path::{
+    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
+};
+use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 /// Methods required in send packet validation, to be implemented by the host
 pub trait SendPacketValidationContext {
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index d8a98a2a7..669a54e2f 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -1,5 +1,7 @@
 //! Defines the main channel, port and packet error types
 
+use displaydoc::Display;
+
 use super::channel::Counterparty;
 use super::packet::Sequence;
 use super::timeout::TimeoutHeight;
@@ -14,8 +16,6 @@ use crate::core::timestamp::{ParseTimestampError, Timestamp};
 use crate::prelude::*;
 use crate::Height;
 
-use displaydoc::Display;
-
 #[derive(Debug, Display)]
 pub enum ChannelError {
     /// invalid channel end: `{channel_end}`
diff --git a/crates/ibc/src/core/ics04_channel/events.rs b/crates/ibc/src/core/ics04_channel/events.rs
index 86b360734..58baab970 100644
--- a/crates/ibc/src/core/ics04_channel/events.rs
+++ b/crates/ibc/src/core/ics04_channel/events.rs
@@ -5,12 +5,6 @@ mod packet_attributes;
 
 use tendermint::abci;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
-
 use self::channel_attributes::{
     ChannelIdAttribute, ConnectionIdAttribute, CounterpartyChannelIdAttribute,
     CounterpartyPortIdAttribute, PortIdAttribute, VersionAttribute,
@@ -21,12 +15,16 @@ use self::packet_attributes::{
     PacketConnectionIdAttribute, PacketDataAttribute, SequenceAttribute, SrcChannelIdAttribute,
     SrcPortIdAttribute, TimeoutHeightAttribute, TimeoutTimestampAttribute,
 };
-
 use super::acknowledgement::Acknowledgement;
 use super::channel::Order;
 use super::packet::Sequence;
 use super::timeout::TimeoutHeight;
 use super::Version;
+use crate::core::ics04_channel::error::ChannelError;
+use crate::core::ics04_channel::packet::Packet;
+use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
 
 /// Channel event types
 const CHANNEL_OPEN_INIT_EVENT: &str = "channel_open_init";
@@ -1121,9 +1119,10 @@ impl TryFrom<TimeoutPacket> for abci::Event {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use tendermint::abci::Event as AbciEvent;
 
+    use super::*;
+
     #[test]
     fn ibc_to_abci_channel_events() {
         struct Test {
diff --git a/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs b/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs
index dad056755..d802a50b0 100644
--- a/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs
+++ b/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs
@@ -3,10 +3,8 @@
 use derive_more::From;
 use tendermint::abci;
 
-use crate::core::{
-    ics04_channel::Version,
-    ics24_host::identifier::{ChannelId, ConnectionId, PortId},
-};
+use crate::core::ics04_channel::Version;
+use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
 
 const CONNECTION_ID_ATTRIBUTE_KEY: &str = "connection_id";
 const CHANNEL_ID_ATTRIBUTE_KEY: &str = "channel_id";
diff --git a/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs b/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs
index 8e53ebfdc..58d820635 100644
--- a/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs
+++ b/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs
@@ -2,12 +2,11 @@
 //! during packet-related datagrams.
 //!
 use core::str;
+
 use derive_more::From;
 use subtle_encoding::hex;
 use tendermint::abci;
 
-use crate::prelude::*;
-
 use crate::core::ics04_channel::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::channel::Order;
 use crate::core::ics04_channel::error::ChannelError;
@@ -15,6 +14,7 @@ use crate::core::ics04_channel::packet::Sequence;
 use crate::core::ics04_channel::timeout::TimeoutHeight;
 use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
 use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
 
 const PKT_SEQ_ATTRIBUTE_KEY: &str = "packet_sequence";
 const PKT_DATA_ATTRIBUTE_KEY: &str = "packet_data";
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index 64d7b31f4..65c14fd40 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -1,23 +1,20 @@
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
-use crate::core::events::MessageEvent;
+use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
 use crate::core::ics04_channel::channel::{Counterparty, Order, State as ChannelState};
 use crate::core::ics04_channel::commitment::{compute_ack_commitment, compute_packet_commitment};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::error::PacketError;
+use crate::core::ics04_channel::error::{ChannelError, PacketError};
+use crate::core::ics04_channel::events::AcknowledgePacket;
 use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
-    AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqAckPath,
+    AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, SeqAckPath,
 };
 use crate::core::router::Module;
-use crate::core::{events::IbcEvent, ics04_channel::events::AcknowledgePacket};
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn acknowledgement_packet_validate<ValCtx>(
     ctx_a: &ValCtx,
@@ -219,31 +216,27 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
     use test_log::test;
 
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
     use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::commitment::PacketCommitment;
     use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_acknowledgement;
     use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
     use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::ChannelId;
-    use crate::core::ics24_host::identifier::PortId;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
-    use crate::core::timestamp::Timestamp;
-    use crate::core::timestamp::ZERO_DURATION;
-
+    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+    use crate::core::router::{ModuleId, Router};
+    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
-    use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
+    use crate::test_utils::DummyTransferModule;
 
     struct Fixture {
         ctx: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index 11974a118..57ca51e55 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -1,22 +1,20 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseConfirm`.
 
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
+use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::CloseConfirm;
 use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
+use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_close_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
@@ -169,10 +167,10 @@ where
 #[cfg(test)]
 mod tests {
     use super::*;
-
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{
@@ -181,14 +179,10 @@ mod tests {
     use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::router::{ModuleId, Router};
     use crate::core::timestamp::ZERO_DURATION;
-
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
-
-    use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
index 976456696..01aaac7e1 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
@@ -1,9 +1,7 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseInit`.
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics04_channel::channel::State;
 use crate::core::ics04_channel::error::ChannelError;
@@ -12,6 +10,7 @@ use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
 use crate::core::ics24_host::path::ChannelEndPath;
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_close_init_validate<ValCtx>(
     ctx_a: &ValCtx,
@@ -126,10 +125,10 @@ where
 #[cfg(test)]
 mod tests {
     use super::*;
-
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{
@@ -138,11 +137,8 @@ mod tests {
     use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::router::{ModuleId, Router};
     use crate::core::timestamp::ZERO_DURATION;
-
-    use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index 8e522ebe0..910441015 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -1,6 +1,5 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenAck`.
 
-use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
@@ -8,15 +7,14 @@ use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateVali
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
+use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::OpenAck;
 use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
+use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_open_ack_validate<ValCtx>(
     ctx_a: &ValCtx,
@@ -165,31 +163,27 @@ where
 #[cfg(test)]
 mod tests {
 
-    use super::*;
     use rstest::*;
     use test_log::test;
 
+    use super::*;
     use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::Order;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State};
+    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
     use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::core::ics24_host::identifier::ConnectionId;
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::{ModuleId, Router};
     use crate::core::timestamp::ZERO_DURATION;
-    use crate::Height;
-
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
+    use crate::Height;
 
     pub struct Fixture {
         pub context: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index b38a937c7..9461f55aa 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -1,22 +1,20 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenConfirm`.
 
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
+use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::OpenConfirm;
 use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
+use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_open_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
@@ -170,30 +168,28 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
     use test_log::test;
 
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
     use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
     use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::ChannelId;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId};
+    use crate::core::router::{ModuleId, Router};
     use crate::core::timestamp::ZERO_DURATION;
-    use crate::Height;
-
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
-    use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
+    use crate::test_utils::DummyTransferModule;
+    use crate::Height;
 
     pub struct Fixture {
         pub context: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index 1cd8583e8..15d5792ac 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -1,10 +1,8 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenInit`.
 
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State};
 use crate::core::ics04_channel::events::OpenInit;
 use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
@@ -12,6 +10,7 @@ use crate::core::ics24_host::identifier::ChannelId;
 use crate::core::ics24_host::path::{ChannelEndPath, SeqAckPath, SeqRecvPath, SeqSendPath};
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_open_init_validate<ValCtx>(
     ctx_a: &ValCtx,
@@ -140,28 +139,24 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
+    use test_log::test;
 
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
     use crate::clients::ics07_tendermint::client_type as tm_client_type;
     use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{ConnectionEnd, State as ConnectionState};
     use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::handler::chan_open_init::validate;
     use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
     use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::core::ics24_host::identifier::ConnectionId;
-
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+    use crate::core::router::{ModuleId, Router};
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
-    use test_log::test;
 
     pub struct Fixture {
         pub ctx: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index 3cda49710..4cf78dce7 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -1,6 +1,5 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenTry`.
 
-use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
@@ -8,17 +7,17 @@ use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateVali
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State as ChannelState};
+use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::events::OpenTry;
 use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
 use crate::core::ics24_host::identifier::ChannelId;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath};
-use crate::core::ics24_host::path::{SeqAckPath, SeqRecvPath, SeqSendPath};
+use crate::core::ics24_host::path::{
+    ChannelEndPath, ClientConsensusStatePath, Path, SeqAckPath, SeqRecvPath, SeqSendPath,
+};
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn chan_open_try_validate<ValCtx>(
     ctx_b: &ValCtx,
@@ -187,28 +186,26 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
     use test_log::test;
 
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
     use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
     use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
+    use crate::core::router::{ModuleId, Router};
     use crate::core::timestamp::ZERO_DURATION;
-    use crate::Height;
-
-    use crate::applications::transfer::MODULE_ID_STR;
     use crate::mock::client_state::client_type as mock_client_type;
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
+    use crate::Height;
 
     pub struct Fixture {
         pub ctx: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index d2f024612..81009c800 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -1,25 +1,23 @@
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::connection::State as ConnectionState;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
 use crate::core::ics04_channel::channel::{Counterparty, Order, State as ChannelState};
 use crate::core::ics04_channel::commitment::{compute_ack_commitment, compute_packet_commitment};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::error::PacketError;
+use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics04_channel::events::{ReceivePacket, WriteAcknowledgement};
 use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
 use crate::core::ics04_channel::packet::Receipt;
-use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
-    AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, ReceiptPath, SeqRecvPath,
+    AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath,
+    SeqRecvPath,
 };
 use crate::core::router::Module;
 use crate::core::timestamp::Expiry;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) fn recv_packet_validate<ValCtx>(
     ctx_b: &ValCtx,
@@ -284,13 +282,14 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
     use test_log::test;
 
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
@@ -298,17 +297,13 @@ mod tests {
     use crate::core::ics04_channel::packet::Packet;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
-    use crate::core::timestamp::Timestamp;
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::Height;
-
+    use crate::core::router::{ModuleId, Router};
+    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
     use crate::mock::context::MockContext;
     use crate::mock::ics18_relayer::context::RelayerContext;
     use crate::mock::router::MockRouter;
-    use crate::test_utils::get_dummy_account_id;
-    use crate::{applications::transfer::MODULE_ID_STR, test_utils::DummyTransferModule};
+    use crate::test_utils::{get_dummy_account_id, DummyTransferModule};
+    use crate::Height;
 
     pub struct Fixture {
         pub context: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
index 59cb14c6d..c978935d8 100644
--- a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
@@ -1,24 +1,21 @@
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
-
-use crate::core::events::IbcEvent;
-use crate::core::events::MessageEvent;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::events::{IbcEvent, MessageEvent};
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics04_channel::channel::Counterparty;
 use crate::core::ics04_channel::commitment::compute_packet_commitment;
-use crate::core::ics04_channel::context::SendPacketExecutionContext;
+use crate::core::ics04_channel::context::{
+    SendPacketExecutionContext, SendPacketValidationContext,
+};
+use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::events::SendPacket;
-use crate::core::ics04_channel::{
-    context::SendPacketValidationContext, error::PacketError, packet::Packet,
+use crate::core::ics04_channel::packet::Packet;
+use crate::core::ics24_host::path::{
+    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
 };
-use crate::core::ics24_host::path::ChannelEndPath;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::ics24_host::path::CommitmentPath;
-use crate::core::ics24_host::path::SeqSendPath;
 use crate::core::timestamp::Expiry;
 use crate::core::ContextError;
+use crate::prelude::*;
 
 /// Send the given packet, including all necessary validation.
 ///
@@ -143,17 +140,17 @@ pub fn send_packet_execute(
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use core::ops::Add;
     use core::time::Duration;
 
     use test_log::test;
 
+    use super::*;
     use crate::core::events::IbcEvent;
     use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::handler::send_packet::send_packet;
@@ -161,8 +158,7 @@ mod tests {
     use crate::core::ics04_channel::packet::Packet;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::timestamp::Timestamp;
-    use crate::core::timestamp::ZERO_DURATION;
+    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
     use crate::mock::context::MockContext;
 
     #[test]
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index 12d479744..f8b68814a 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -1,28 +1,23 @@
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
 use prost::Message;
 
-use crate::core::events::IbcEvent;
-use crate::core::events::MessageEvent;
-use crate::core::ics02_client::client_state::ClientStateCommon;
+use crate::core::events::{IbcEvent, MessageEvent};
+use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{Counterparty, Order};
+use crate::core::ics04_channel::channel::{Counterparty, Order, State};
 use crate::core::ics04_channel::commitment::compute_packet_commitment;
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::events::ChannelClosed;
+use crate::core::ics04_channel::error::{ChannelError, PacketError};
+use crate::core::ics04_channel::events::{ChannelClosed, TimeoutPacket};
+use crate::core::ics04_channel::handler::timeout_on_close;
 use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
 use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use crate::core::ics04_channel::{events::TimeoutPacket, handler::timeout_on_close};
-use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
-    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, ReceiptPath, SeqRecvPath,
+    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath, SeqRecvPath,
 };
 use crate::core::router::Module;
 use crate::core::{ContextError, ExecutionContext, ValidationContext};
+use crate::prelude::*;
 
 pub(crate) enum TimeoutMsgType {
     Timeout(MsgTimeout),
@@ -274,13 +269,14 @@ where
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use rstest::*;
 
+    use super::*;
+    use crate::applications::transfer::MODULE_ID_STR;
     use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
     use crate::core::ics04_channel::commitment::PacketCommitment;
@@ -289,12 +285,8 @@ mod tests {
     use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::router::ModuleId;
-    use crate::core::router::Router;
-    use crate::core::timestamp::Timestamp;
-    use crate::core::timestamp::ZERO_DURATION;
-
-    use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::router::{ModuleId, Router};
+    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
     use crate::mock::context::MockContext;
     use crate::mock::router::MockRouter;
     use crate::test_utils::DummyTransferModule;
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
index 9215d588a..5a37f8de5 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
@@ -1,21 +1,19 @@
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
 use ibc_proto::protobuf::Protobuf;
 use prost::Message;
 
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
 use crate::core::ics02_client::consensus_state::ConsensusState;
+use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order};
+use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
 use crate::core::ics04_channel::commitment::compute_packet_commitment;
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use crate::core::ics24_host::path::Path;
 use crate::core::ics24_host::path::{
-    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, ReceiptPath, SeqRecvPath,
+    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath, SeqRecvPath,
 };
 use crate::core::{ContextError, ValidationContext};
+use crate::prelude::*;
 
 pub fn validate<Ctx>(ctx_a: &Ctx, msg: &MsgTimeoutOnClose) -> Result<(), ContextError>
 where
@@ -175,26 +173,24 @@ where
 
 #[cfg(test)]
 mod tests {
-    use crate::core::ics04_channel::commitment::compute_packet_commitment;
-    use crate::core::ics04_channel::commitment::PacketCommitment;
-    use crate::core::ics04_channel::handler::timeout_on_close::validate;
-    use crate::core::timestamp::Timestamp;
-    use crate::core::ExecutionContext;
-    use crate::mock::context::MockContext;
-    use crate::prelude::*;
-    use crate::Height;
     use rstest::*;
 
-    use crate::core::ics03_connection::connection::ConnectionEnd;
-    use crate::core::ics03_connection::connection::Counterparty as ConnectionCounterparty;
-    use crate::core::ics03_connection::connection::State as ConnectionState;
+    use crate::core::ics03_connection::connection::{
+        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+    };
     use crate::core::ics03_connection::version::get_compatible_versions;
     use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+    use crate::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
+    use crate::core::ics04_channel::handler::timeout_on_close::validate;
     use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
     use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
     use crate::core::ics04_channel::Version;
     use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::timestamp::ZERO_DURATION;
+    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
+    use crate::core::ExecutionContext;
+    use crate::mock::context::MockContext;
+    use crate::prelude::*;
+    use crate::Height;
 
     pub struct Fixture {
         pub context: MockContext,
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index 728c8926c..a5e87c6e5 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -13,17 +13,15 @@ pub(crate) mod timeout;
 pub(crate) mod timeout_on_close;
 
 // Opening handshake messages.
+// Packet specific messages.
+pub use acknowledgement::MsgAcknowledgement;
+// Closing handshake messages.
+pub use chan_close_confirm::MsgChannelCloseConfirm;
+pub use chan_close_init::MsgChannelCloseInit;
 pub use chan_open_ack::MsgChannelOpenAck;
 pub use chan_open_confirm::MsgChannelOpenConfirm;
 pub use chan_open_init::MsgChannelOpenInit;
 pub use chan_open_try::MsgChannelOpenTry;
-
-// Closing handshake messages.
-pub use chan_close_confirm::MsgChannelCloseConfirm;
-pub use chan_close_init::MsgChannelCloseInit;
-
-// Packet specific messages.
-pub use acknowledgement::MsgAcknowledgement;
 pub use recv_packet::MsgRecvPacket;
 pub use timeout::MsgTimeout;
 pub use timeout_on_close::MsgTimeoutOnClose;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
index 6f448d6fc..250c33921 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
 use ibc_proto::protobuf::Protobuf;
 
@@ -8,6 +6,7 @@ use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -78,8 +77,9 @@ impl From<MsgAcknowledgement> for RawMsgAcknowledgement {
 
 #[cfg(test)]
 pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
-    use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
+    use ibc_proto::ibc::core::channel::v1::{
+        MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
+    };
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 
     use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
@@ -110,15 +110,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod test {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
+    use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
     use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_acknowledgement;
     use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
index c40c88c5a..ed03904f6 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
@@ -1,14 +1,13 @@
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::{prelude::*, Height};
-
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
+use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
+use crate::Height;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseConfirm";
 
@@ -74,11 +73,11 @@ impl From<MsgChannelCloseConfirm> for RawMsgChannelCloseConfirm {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
 
     use crate::core::ics24_host::identifier::{ChannelId, PortId};
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
 
     /// Returns a dummy `RawMsgChannelCloseConfirm`, for testing only!
@@ -98,13 +97,12 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
 
     use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
     use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
+    use crate::prelude::*;
 
     #[test]
     fn parse_channel_close_confirm_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
index d3a569217..4ad83ef81 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
@@ -1,12 +1,10 @@
-use crate::prelude::*;
-
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseInit";
@@ -60,10 +58,10 @@ impl From<MsgChannelCloseInit> for RawMsgChannelCloseInit {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
 
     use crate::core::ics24_host::identifier::{ChannelId, PortId};
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     /// Returns a dummy `RawMsgChannelCloseInit`, for testing only!
@@ -78,14 +76,12 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+    use test_log::test;
 
     use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
     use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
+    use crate::prelude::*;
 
     #[test]
     fn parse_channel_close_init_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
index 9fca241ff..56dc166e4 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
@@ -1,13 +1,14 @@
+use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+use ibc_proto::protobuf::Protobuf;
+
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::Version;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
-use crate::{prelude::*, Height};
-
-use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-use ibc_proto::protobuf::Protobuf;
+use crate::Height;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenAck";
 
@@ -77,12 +78,12 @@ impl From<MsgChannelOpenAck> for RawMsgChannelOpenAck {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+    use ibc_proto::ibc::core::client::v1::Height;
 
     use crate::core::ics24_host::identifier::{ChannelId, PortId};
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-    use ibc_proto::ibc::core::client::v1::Height;
 
     /// Returns a dummy `RawMsgChannelOpenAck`, for testing only!
     pub fn get_dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
@@ -103,14 +104,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+    use ibc_proto::ibc::core::client::v1::Height;
     use test_log::test;
 
     use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
     use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-
-    use ibc_proto::ibc::core::client::v1::Height;
+    use crate::prelude::*;
 
     #[test]
     fn parse_channel_open_ack_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
index 4bd43bd39..a0daea61d 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
@@ -1,12 +1,13 @@
+use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+use ibc_proto::protobuf::Protobuf;
+
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
-use crate::{prelude::*, Height};
-
-use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-use ibc_proto::protobuf::Protobuf;
+use crate::Height;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenConfirm";
 
@@ -72,12 +73,12 @@ impl From<MsgChannelOpenConfirm> for RawMsgChannelOpenConfirm {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+    use ibc_proto::ibc::core::client::v1::Height;
 
     use crate::core::ics24_host::identifier::{ChannelId, PortId};
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-    use ibc_proto::ibc::core::client::v1::Height;
 
     /// Returns a dummy `RawMsgChannelOpenConfirm`, for testing only!
     pub fn get_dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
@@ -96,14 +97,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+    use ibc_proto::ibc::core::client::v1::Height;
     use test_log::test;
 
     use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
     use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-
-    use ibc_proto::ibc::core::client::v1::Height;
+    use crate::prelude::*;
 
     #[test]
     fn parse_channel_open_confirm_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index 08f034eb2..f2c081252 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -1,7 +1,9 @@
-use crate::core::ics04_channel::channel::verify_connection_hops_length;
-use crate::core::ics04_channel::channel::ChannelEnd;
-use crate::core::ics04_channel::channel::Counterparty;
-use crate::core::ics04_channel::channel::{Order, State};
+use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+use ibc_proto::protobuf::Protobuf;
+
+use crate::core::ics04_channel::channel::{
+    verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
+};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::Version;
 use crate::core::ics24_host::identifier::{ConnectionId, PortId};
@@ -9,9 +11,6 @@ use crate::core::Msg;
 use crate::prelude::*;
 use crate::signer::Signer;
 
-use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-use ibc_proto::protobuf::Protobuf;
-
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenInit";
 
 ///
@@ -93,11 +92,11 @@ impl From<MsgChannelOpenInit> for RawMsgChannelOpenInit {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
 
     use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
     use crate::core::ics24_host::identifier::PortId;
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     /// Returns a dummy `RawMsgChannelOpenInit`, for testing only!
@@ -114,13 +113,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
+    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+    use test_log::test;
+
     use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
     use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
     use crate::prelude::*;
 
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-    use test_log::test;
-
     #[test]
     fn channel_open_init_from_raw() {
         struct Test {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
index ad0e93ca4..6e2876332 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
@@ -1,17 +1,17 @@
-use crate::core::ics04_channel::channel::verify_connection_hops_length;
-use crate::core::ics04_channel::channel::ChannelEnd;
-use crate::core::ics04_channel::channel::Counterparty;
-use crate::core::ics04_channel::channel::{Order, State};
+use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
+use ibc_proto::protobuf::Protobuf;
+
+use crate::core::ics04_channel::channel::{
+    verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
+};
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::Version;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
-use crate::{prelude::*, Height};
-
-use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-use ibc_proto::protobuf::Protobuf;
+use crate::Height;
 
 pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenTry";
 
@@ -129,13 +129,13 @@ impl From<MsgChannelOpenTry> for RawMsgChannelOpenTry {
 
 #[cfg(test)]
 pub mod test_util {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
+    use ibc_proto::ibc::core::client::v1::Height;
 
     use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
     use crate::core::ics24_host::identifier::PortId;
+    use crate::prelude::*;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-    use ibc_proto::ibc::core::client::v1::Height;
 
     /// Returns a dummy `RawMsgChannelOpenTry`, for testing only!
     pub fn get_dummy_raw_msg_chan_open_try(proof_height: u64) -> RawMsgChannelOpenTry {
@@ -157,14 +157,14 @@ pub mod test_util {
 
 #[cfg(test)]
 mod tests {
-    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
-    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-    use crate::prelude::*;
-
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
     use ibc_proto::ibc::core::client::v1::Height;
     use test_log::test;
 
+    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
+    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
+    use crate::prelude::*;
+
     #[test]
     fn channel_open_try_from_raw() {
         struct Test {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
index 241c67976..9b342a7d1 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
@@ -1,13 +1,11 @@
-use crate::prelude::*;
-
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -77,6 +75,9 @@ impl From<MsgRecvPacket> for RawMsgRecvPacket {
 
 #[cfg(test)]
 pub mod test_util {
+    use core::ops::Add;
+    use core::time::Duration;
+
     use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 
@@ -87,8 +88,6 @@ pub mod test_util {
     use crate::core::timestamp::Timestamp;
     use crate::signer::Signer;
     use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-    use core::ops::Add;
-    use core::time::Duration;
 
     impl MsgRecvPacket {
         pub fn new(
@@ -127,15 +126,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod test {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
+    use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
     use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
     use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
index b3104bca3..b2244b268 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
@@ -1,13 +1,11 @@
-use crate::prelude::*;
-
-use ibc_proto::protobuf::Protobuf;
-
 use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::{Packet, Sequence};
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -108,15 +106,13 @@ pub mod test_util {
 
 #[cfg(test)]
 mod test {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
+    use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
     use crate::core::ics04_channel::msgs::timeout::test_util::get_dummy_raw_msg_timeout;
     use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
+    use crate::prelude::*;
     use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
index e299d9a18..6e965edc4 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
 use ibc_proto::protobuf::Protobuf;
 
@@ -7,6 +5,7 @@ use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::{Packet, Sequence};
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
 use crate::core::Msg;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -85,12 +84,12 @@ impl From<MsgTimeoutOnClose> for RawMsgTimeoutOnClose {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
     use test_log::test;
 
     use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
     use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
+    use crate::prelude::*;
 
     #[test]
     fn msg_timeout_on_close_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/crates/ibc/src/core/ics04_channel/packet.rs
index 91ca8fd88..b80069acc 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/crates/ibc/src/core/ics04_channel/packet.rs
@@ -1,7 +1,5 @@
 //! Defines the packet type
 
-use crate::prelude::*;
-
 use core::str::FromStr;
 
 use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
@@ -9,7 +7,9 @@ use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
 use super::timeout::TimeoutHeight;
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::timestamp::{Expiry::Expired, Timestamp};
+use crate::core::timestamp::Expiry::Expired;
+use crate::core::timestamp::Timestamp;
+use crate::prelude::*;
 use crate::Height;
 
 /// Enumeration of proof carrying ICS4 message, helper for relayer.
@@ -287,11 +287,11 @@ impl From<Packet> for RawPacket {
 
 #[cfg(test)]
 pub mod test_utils {
-    use crate::prelude::*;
     use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 
     use crate::core::ics24_host::identifier::{ChannelId, PortId};
+    use crate::prelude::*;
 
     /// Returns a dummy `RawPacket`, for testing only!
     pub fn get_dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacket {
@@ -313,15 +313,13 @@ pub mod test_utils {
 
 #[cfg(test)]
 mod tests {
-    use crate::prelude::*;
-
-    use test_log::test;
-
     use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+    use test_log::test;
 
     use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
     use crate::core::ics04_channel::packet::Packet;
+    use crate::prelude::*;
 
     #[test]
     fn packet_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/timeout.rs b/crates/ibc/src/core/ics04_channel/timeout.rs
index 96f3096b5..e70a1efd7 100644
--- a/crates/ibc/src/core/ics04_channel/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/timeout.rs
@@ -4,7 +4,8 @@ use core::fmt::{Display, Error as FmtError, Formatter};
 
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 
-use crate::core::ics02_client::{error::ClientError, height::Height};
+use crate::core::ics02_client::error::ClientError;
+use crate::core::ics02_client::height::Height;
 use crate::prelude::*;
 
 /// Indicates a consensus height on the destination chain after which the packet
@@ -150,9 +151,10 @@ impl Display for TimeoutHeight {
 
 #[cfg(feature = "serde")]
 mod tests {
-    use super::TimeoutHeight;
     use serde::{Deserialize, Serialize};
 
+    use super::TimeoutHeight;
+
     impl Serialize for TimeoutHeight {
         fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
         where
diff --git a/crates/ibc/src/core/ics04_channel/version.rs b/crates/ibc/src/core/ics04_channel/version.rs
index dd3e39bf7..84feb5e7e 100644
--- a/crates/ibc/src/core/ics04_channel/version.rs
+++ b/crates/ibc/src/core/ics04_channel/version.rs
@@ -6,9 +6,8 @@ use core::convert::Infallible;
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
-use crate::prelude::*;
-
 use super::error::ChannelError;
+use crate::prelude::*;
 
 /// The version field for a `ChannelEnd`.
 ///
diff --git a/crates/ibc/src/core/ics23_commitment/commitment.rs b/crates/ibc/src/core/ics23_commitment/commitment.rs
index b5b876b71..1b8af341e 100644
--- a/crates/ibc/src/core/ics23_commitment/commitment.rs
+++ b/crates/ibc/src/core/ics23_commitment/commitment.rs
@@ -1,13 +1,14 @@
 //! Defines core commitment types
 
-use crate::core::ics23_commitment::error::CommitmentError;
-use crate::prelude::*;
+use core::convert::TryFrom;
+use core::fmt;
 
-use core::{convert::TryFrom, fmt};
 use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
 use subtle_encoding::{Encoding, Hex};
 
 use super::merkle::MerkleProof;
+use crate::core::ics23_commitment::error::CommitmentError;
+use crate::prelude::*;
 
 /// Encodes a commitment root; most often a Merkle tree root hash.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -198,11 +199,12 @@ impl serde::Serialize for CommitmentPrefix {
 
 #[cfg(test)]
 pub mod test_util {
-    use super::CommitmentProofBytes;
-    use crate::prelude::*;
     use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
     use ibc_proto::ics23::CommitmentProof;
 
+    use super::CommitmentProofBytes;
+    use crate::prelude::*;
+
     /// Returns a dummy `CommitmentProofBytes`, for testing only!
     pub fn get_dummy_commitment_proof_bytes() -> CommitmentProofBytes {
         let parsed = CommitmentProof { proof: None };
diff --git a/crates/ibc/src/core/ics23_commitment/error.rs b/crates/ibc/src/core/ics23_commitment/error.rs
index 5d70fac03..1a4bcaaeb 100644
--- a/crates/ibc/src/core/ics23_commitment/error.rs
+++ b/crates/ibc/src/core/ics23_commitment/error.rs
@@ -1,6 +1,7 @@
 //! Defines the commitment error type
 
 use alloc::string::String;
+
 use displaydoc::Display;
 use prost::DecodeError;
 
diff --git a/crates/ibc/src/core/ics23_commitment/merkle.rs b/crates/ibc/src/core/ics23_commitment/merkle.rs
index 81f679851..3f5bfb437 100644
--- a/crates/ibc/src/core/ics23_commitment/merkle.rs
+++ b/crates/ibc/src/core/ics23_commitment/merkle.rs
@@ -1,10 +1,6 @@
 //! Merkle proof utilities
 
-use crate::prelude::*;
-
-use ibc_proto::ibc::core::commitment::v1::MerklePath;
-use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
-use ibc_proto::ibc::core::commitment::v1::MerkleRoot;
+use ibc_proto::ibc::core::commitment::v1::{MerklePath, MerkleProof as RawMerkleProof, MerkleRoot};
 use ibc_proto::ics23::commitment_proof::Proof;
 use ibc_proto::ics23::{
     calculate_existence_root, verify_membership, verify_non_membership, CommitmentProof,
@@ -14,6 +10,7 @@ use ibc_proto::ics23::{
 use crate::core::ics23_commitment::commitment::{CommitmentPrefix, CommitmentRoot};
 use crate::core::ics23_commitment::error::CommitmentError;
 use crate::core::ics23_commitment::specs::ProofSpecs;
+use crate::prelude::*;
 
 pub fn apply_prefix(prefix: &CommitmentPrefix, mut path: Vec<String>) -> MerklePath {
     let mut key_path: Vec<String> = vec![format!("{prefix:?}")];
diff --git a/crates/ibc/src/core/ics23_commitment/specs.rs b/crates/ibc/src/core/ics23_commitment/specs.rs
index 902a97315..ae7787a39 100644
--- a/crates/ibc/src/core/ics23_commitment/specs.rs
+++ b/crates/ibc/src/core/ics23_commitment/specs.rs
@@ -1,7 +1,8 @@
 //! Defines proof specs, which encode the structure of proofs
 
-use crate::prelude::*;
 use ibc_proto::ics23::{InnerSpec as RawInnerSpec, LeafOp as RawLeafOp, ProofSpec as RawProofSpec};
+
+use crate::prelude::*;
 /// An array of proof specifications.
 ///
 /// This type encapsulates different types of proof specifications, mostly predefined, e.g., for
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index 6ce2f4b18..d669d8731 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -1,17 +1,15 @@
 //! Defines identifier types
 
 pub(crate) mod validate;
-use validate::*;
-
 use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use derive_more::Into;
 use displaydoc::Display;
+use validate::*;
 
 use crate::clients::ics07_tendermint::client_type as tm_client_type;
 use crate::core::ics02_client::client_type::ClientType;
-
 use crate::prelude::*;
 
 const CONNECTION_ID_PREFIX: &str = "connection";
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/crates/ibc/src/core/ics24_host/identifier/validate.rs
index f926a4c5d..ddf8c98b8 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/crates/ibc/src/core/ics24_host/identifier/validate.rs
@@ -1,6 +1,5 @@
-use crate::prelude::*;
-
 use super::IdentifierError as Error;
+use crate::prelude::*;
 
 /// Path separator (ie. forward slash '/')
 const PATH_SEPARATOR: char = '/';
@@ -123,10 +122,10 @@ pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
-
     use test_log::test;
 
+    use super::*;
+
     #[test]
     fn parse_invalid_port_id_min() {
         // invalid min port id
diff --git a/crates/ibc/src/core/ics24_host/path.rs b/crates/ibc/src/core/ics24_host/path.rs
index 24dc1bb48..c01eb5797 100644
--- a/crates/ibc/src/core/ics24_host/path.rs
+++ b/crates/ibc/src/core/ics24_host/path.rs
@@ -1,17 +1,17 @@
 //! Defines all store paths used by IBC
 
-use crate::{prelude::*, Height};
-
 /// Path-space as listed in ICS-024
 /// https://github.com/cosmos/ibc/tree/master/spec/core/ics-024-host-requirements#path-space
 /// Some of these are implemented in other ICSs, but ICS-024 has a nice summary table.
 ///
 use core::str::FromStr;
 
+use derive_more::{Display, From};
+
 use crate::core::ics04_channel::packet::Sequence;
 use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-
-use derive_more::{Display, From};
+use crate::prelude::*;
+use crate::Height;
 
 /// ABCI client upgrade keys
 /// - The key identifying the upgraded IBC state within the upgrade sub-store
@@ -834,9 +834,10 @@ fn parse_upgrades(components: &[&str]) -> Option<Path> {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use core::str::FromStr;
 
+    use super::*;
+
     #[test]
     fn invalid_path_doesnt_parse() {
         let invalid_path = Path::from_str("clients/clientType");
diff --git a/crates/ibc/src/core/mod.rs b/crates/ibc/src/core/mod.rs
index 66d10b0dd..3bef22053 100644
--- a/crates/ibc/src/core/mod.rs
+++ b/crates/ibc/src/core/mod.rs
@@ -36,15 +36,9 @@ mod context;
 mod handler;
 mod msgs;
 
-pub use handler::dispatch;
-pub use handler::execute;
-pub use handler::validate;
-
 pub use context::*;
-
-pub use msgs::Msg;
-pub use msgs::MsgEnvelope;
-
+pub use handler::{dispatch, execute, validate};
 pub use ics04_channel::handler::send_packet::{
     send_packet, send_packet_execute, send_packet_validate,
 };
+pub use msgs::{Msg, MsgEnvelope};
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index 66a2c6eaf..7f8fe8a53 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -1,6 +1,5 @@
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
+use ibc_proto::protobuf::Protobuf;
 
 use crate::core::context::RouterError;
 use crate::core::ics02_client::msgs::{
@@ -13,7 +12,7 @@ use crate::core::ics04_channel::msgs::{
     acknowledgement, chan_close_confirm, chan_close_init, chan_open_ack, chan_open_confirm,
     chan_open_init, chan_open_try, recv_packet, timeout, timeout_on_close, ChannelMsg, PacketMsg,
 };
-use ibc_proto::protobuf::Protobuf;
+use crate::prelude::*;
 
 /// Trait to be implemented by all IBC messages
 pub trait Msg: Clone {
diff --git a/crates/ibc/src/core/router.rs b/crates/ibc/src/core/router.rs
index 81adbf99d..4cdb66524 100644
--- a/crates/ibc/src/core/router.rs
+++ b/crates/ibc/src/core/router.rs
@@ -1,6 +1,5 @@
 //! Defines the `Router`, which binds modules to ports
 
-use crate::prelude::*;
 use alloc::borrow::Borrow;
 use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 
@@ -10,8 +9,8 @@ use crate::core::ics04_channel::channel::{Counterparty, Order};
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics04_channel::packet::Packet;
 use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::PortId;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId};
+use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use crate::prelude::*;
 use crate::signer::Signer;
 
 /// Router as defined in ICS-26, which binds modules to ports.
diff --git a/crates/ibc/src/core/timestamp.rs b/crates/ibc/src/core/timestamp.rs
index e0c6079fb..64add0694 100644
--- a/crates/ibc/src/core/timestamp.rs
+++ b/crates/ibc/src/core/timestamp.rs
@@ -1,7 +1,5 @@
 //! Defines the representation of timestamps used in packet timeouts
 
-use crate::prelude::*;
-
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::hash::{Hash, Hasher};
 use core::num::ParseIntError;
@@ -13,6 +11,8 @@ use displaydoc::Display;
 use tendermint::Time;
 use time::OffsetDateTime;
 
+use crate::prelude::*;
+
 pub const ZERO_DURATION: Duration = Duration::from_secs(0);
 
 /// A newtype wrapper over `Option<Time>` to keep track of
@@ -311,11 +311,11 @@ impl From<Time> for Timestamp {
 
 #[cfg(test)]
 mod tests {
-    use time::OffsetDateTime;
-
     use core::time::Duration;
     use std::thread::sleep;
+
     use test_log::test;
+    use time::OffsetDateTime;
 
     use super::{Expiry, Timestamp, ZERO_DURATION};
 
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs
index 2a2a835be..0cb380d18 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs
@@ -3,6 +3,7 @@
 use alloc::borrow::ToOwned;
 use alloc::string::{String, ToString};
 use alloc::vec;
+
 use derive_more::From;
 use tendermint::abci;
 
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
index 53437d780..0680854ca 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
@@ -1,12 +1,13 @@
 use alloc::string::ToString;
+
 use tendermint::abci::Event as TmEvent;
 
 use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
 use crate::core::ics02_client::error::UpgradeClientError;
 use crate::core::ics24_host::path::UpgradeClientPath;
-use crate::hosts::tendermint::upgrade_proposal::UpgradeClientProposal;
-use crate::hosts::tendermint::upgrade_proposal::UpgradeExecutionContext;
-use crate::hosts::tendermint::upgrade_proposal::UpgradeProposal;
+use crate::hosts::tendermint::upgrade_proposal::{
+    UpgradeClientProposal, UpgradeExecutionContext, UpgradeProposal,
+};
 
 /// Handles an upgrade client proposal
 ///
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
index 1a1308f97..a448aeb91 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
@@ -2,6 +2,7 @@
 
 use alloc::format;
 use alloc::string::{String, ToString};
+
 use ibc_proto::cosmos::upgrade::v1beta1::Plan as RawPlan;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::protobuf::Protobuf;
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
index 4ef667b1c..21cfa714f 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
@@ -1,6 +1,7 @@
 //! Definition of domain `UpgradeProposal` type for handling upgrade client proposal
 
 use alloc::string::{String, ToString};
+
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::UpgradeProposal as RawUpgradeProposal;
 use ibc_proto::protobuf::Protobuf;
diff --git a/crates/ibc/src/hosts/tendermint/validate_self_client.rs b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
index 5ac4a1cf5..8319bf727 100644
--- a/crates/ibc/src/hosts/tendermint/validate_self_client.rs
+++ b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
@@ -1,8 +1,9 @@
-use core::time::Duration;
-
 use alloc::format;
 use alloc::string::{String, ToString};
+use core::time::Duration;
+
 use ibc_proto::google::protobuf::Any;
+use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 
 use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
 use crate::core::ics02_client::client_state::ClientStateCommon;
@@ -13,8 +14,6 @@ use crate::core::ics24_host::identifier::ChainId;
 use crate::core::ContextError;
 use crate::Height;
 
-use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
-
 /// Provides an implementation of `ValidationContext::validate_self_client` for
 /// Tendermint-based hosts.
 pub trait ValidateSelfClientContext {
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 68004e69f..965db5b2d 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -44,9 +44,10 @@ extern crate alloc;
 #[cfg(any(test, feature = "std"))]
 extern crate std;
 
+pub use signer::Signer;
+
 /// Represents a block height
 pub use crate::core::ics02_client::height::Height;
-pub use signer::Signer;
 
 pub mod applications;
 pub mod clients;
diff --git a/crates/ibc/src/mock/client_state.rs b/crates/ibc/src/mock/client_state.rs
index 9f31e8d26..e1d83b1a9 100644
--- a/crates/ibc/src/mock/client_state.rs
+++ b/crates/ibc/src/mock/client_state.rs
@@ -1,8 +1,3 @@
-use crate::core::ics02_client::client_state::Status;
-use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::prelude::*;
-
 use core::str::FromStr;
 use core::time::Duration;
 
@@ -10,10 +5,9 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::ClientState as RawMockClientState;
 use ibc_proto::protobuf::Protobuf;
 
-use crate::core::ics02_client::client_state::ClientStateCommon;
-use crate::core::ics02_client::client_state::ClientStateExecution;
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::client_state::UpdateKind;
+use crate::core::ics02_client::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
+};
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
 use crate::core::ics02_client::ClientExecutionContext;
@@ -21,13 +15,14 @@ use crate::core::ics23_commitment::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
 use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::Path;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
+use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, Path};
+use crate::core::timestamp::Timestamp;
+use crate::core::ContextError;
 use crate::mock::client_state::client_type as mock_client_type;
 use crate::mock::consensus_state::MockConsensusState;
 use crate::mock::header::MockHeader;
 use crate::mock::misbehaviour::Misbehaviour;
-
+use crate::prelude::*;
 use crate::Height;
 
 pub const MOCK_CLIENT_STATE_TYPE_URL: &str = "/ibc.mock.ClientState";
@@ -106,8 +101,9 @@ impl TryFrom<Any> for MockClientState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use bytes::Buf;
         use core::ops::Deref;
+
+        use bytes::Buf;
         use prost::Message;
 
         fn decode_client_state<B: Buf>(buf: B) -> Result<MockClientState, ClientError> {
diff --git a/crates/ibc/src/mock/consensus_state.rs b/crates/ibc/src/mock/consensus_state.rs
index 0da9a4cfc..0f1d9b5ab 100644
--- a/crates/ibc/src/mock/consensus_state.rs
+++ b/crates/ibc/src/mock/consensus_state.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::ConsensusState as RawMockConsensusState;
 use ibc_proto::protobuf::Protobuf;
@@ -9,6 +7,7 @@ use crate::core::ics02_client::error::ClientError;
 use crate::core::ics23_commitment::commitment::CommitmentRoot;
 use crate::core::timestamp::Timestamp;
 use crate::mock::header::MockHeader;
+use crate::prelude::*;
 
 pub const MOCK_CONSENSUS_STATE_TYPE_URL: &str = "/ibc.mock.ConsensusState";
 
@@ -64,8 +63,9 @@ impl TryFrom<Any> for MockConsensusState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use bytes::Buf;
         use core::ops::Deref;
+
+        use bytes::Buf;
         use prost::Message;
 
         fn decode_consensus_state<B: Buf>(buf: B) -> Result<MockConsensusState, ClientError> {
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index ff7de4c93..1830b211d 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -2,32 +2,28 @@
 
 mod clients;
 
-use crate::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
-use crate::core::ics24_host::path::{
-    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
-    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
-};
-use crate::prelude::*;
-
 use alloc::collections::btree_map::BTreeMap;
 use alloc::sync::Arc;
 use core::cmp::min;
 use core::fmt::Debug;
 use core::ops::{Add, Sub};
 use core::time::Duration;
+
 use derive_more::{From, TryInto};
+use ibc_proto::google::protobuf::Any;
 use ibc_proto::protobuf::Protobuf;
 use parking_lot::Mutex;
-
-use ibc_proto::google::protobuf::Any;
 use tracing::debug;
 
-use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use crate::clients::ics07_tendermint::client_state::TENDERMINT_CLIENT_STATE_TYPE_URL;
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::consensus_state::TENDERMINT_CONSENSUS_STATE_TYPE_URL;
-
-use crate::core::dispatch;
+use super::client_state::{MOCK_CLIENT_STATE_TYPE_URL, MOCK_CLIENT_TYPE};
+use super::consensus_state::MOCK_CONSENSUS_STATE_TYPE_URL;
+use crate::clients::ics07_tendermint::client_state::{
+    ClientState as TmClientState, TENDERMINT_CLIENT_STATE_TYPE_URL,
+};
+use crate::clients::ics07_tendermint::consensus_state::{
+    ConsensusState as TmConsensusState, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
+};
+use crate::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::client_state::ClientState;
 use crate::core::ics02_client::client_type::ClientType;
@@ -41,22 +37,23 @@ use crate::core::ics04_channel::error::{ChannelError, PacketError};
 use crate::core::ics04_channel::packet::{Receipt, Sequence};
 use crate::core::ics23_commitment::commitment::CommitmentPrefix;
 use crate::core::ics24_host::identifier::{ChainId, ChannelId, ClientId, ConnectionId, PortId};
+use crate::core::ics24_host::path::{
+    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
+    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
+};
 use crate::core::router::Router;
 use crate::core::timestamp::Timestamp;
-use crate::core::{ContextError, ValidationContext};
-use crate::core::{ExecutionContext, MsgEnvelope};
+use crate::core::{dispatch, ContextError, ExecutionContext, MsgEnvelope, ValidationContext};
 use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
 use crate::mock::consensus_state::MockConsensusState;
 use crate::mock::header::MockHeader;
 use crate::mock::host::{HostBlock, HostType};
 use crate::mock::ics18_relayer::context::RelayerContext;
 use crate::mock::ics18_relayer::error::RelayerError;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
-use super::client_state::{MOCK_CLIENT_STATE_TYPE_URL, MOCK_CLIENT_TYPE};
-use super::consensus_state::MOCK_CONSENSUS_STATE_TYPE_URL;
-
 pub const DEFAULT_BLOCK_TIME_SECS: u64 = 3;
 
 #[derive(Debug, Clone, From, PartialEq, ClientState)]
@@ -1317,16 +1314,15 @@ impl ExecutionContext for MockContext {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use test_log::test;
 
+    use super::*;
     use crate::core::ics04_channel::acknowledgement::Acknowledgement;
     use crate::core::ics04_channel::channel::{Counterparty, Order};
     use crate::core::ics04_channel::error::ChannelError;
     use crate::core::ics04_channel::packet::Packet;
     use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::ChainId;
-    use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+    use crate::core::ics24_host::identifier::{ChainId, ChannelId, ConnectionId, PortId};
     use crate::core::router::{Module, ModuleExtras, ModuleId};
     use crate::mock::context::MockContext;
     use crate::mock::host::HostType;
diff --git a/crates/ibc/src/mock/context/clients.rs b/crates/ibc/src/mock/context/clients.rs
index 448195902..7aa63192d 100644
--- a/crates/ibc/src/mock/context/clients.rs
+++ b/crates/ibc/src/mock/context/clients.rs
@@ -1,19 +1,17 @@
 //! Client context implementations for `MockContext`
 
-use crate::mock::client_state::MockClientContext;
-use crate::prelude::*;
-
 use super::{AnyClientState, AnyConsensusState, MockClientRecord, MockContext};
-use crate::clients::ics07_tendermint::CommonContext as TmCommonContext;
-use crate::clients::ics07_tendermint::ValidationContext as TmValidationContext;
+use crate::clients::ics07_tendermint::{
+    CommonContext as TmCommonContext, ValidationContext as TmValidationContext,
+};
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics02_client::ClientExecutionContext;
 use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::ics24_host::path::ClientStatePath;
+use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
 use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::core::ValidationContext;
+use crate::core::{ContextError, ValidationContext};
+use crate::mock::client_state::MockClientContext;
+use crate::prelude::*;
 use crate::Height;
 
 impl MockClientContext for MockContext {
diff --git a/crates/ibc/src/mock/header.rs b/crates/ibc/src/mock/header.rs
index 46ce0a785..62e3f6073 100644
--- a/crates/ibc/src/mock/header.rs
+++ b/crates/ibc/src/mock/header.rs
@@ -115,9 +115,10 @@ impl From<MockHeader> for Any {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
     use ibc_proto::protobuf::Protobuf;
 
+    use super::*;
+
     #[test]
     fn encode_any() {
         let header = MockHeader::new(Height::new(1, 10).expect("Never fails"))
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc/src/mock/host.rs
index 6a964ea90..5b782a431 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc/src/mock/host.rs
@@ -5,11 +5,11 @@ use core::str::FromStr;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::protobuf::Protobuf as ErasedProtobuf;
-
 use tendermint::block::Header as TmHeader;
 use tendermint_testgen::light_block::TmLightBlock;
 use tendermint_testgen::{Generator, LightBlock as TestgenLightBlock};
 
+use super::context::AnyConsensusState;
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
 use crate::clients::ics07_tendermint::header::TENDERMINT_HEADER_TYPE_URL;
 use crate::core::ics02_client::error::ClientError;
@@ -20,8 +20,6 @@ use crate::mock::header::MockHeader;
 use crate::prelude::*;
 use crate::Height;
 
-use super::context::AnyConsensusState;
-
 /// Defines the different types of host chains that a mock context can emulate.
 /// The variants are as follows:
 /// - `Mock` defines that the context history consists of `MockHeader` blocks.
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc/src/mock/ics18_relayer/context.rs
index 69e252c10..4e74b04a9 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc/src/mock/ics18_relayer/context.rs
@@ -1,8 +1,7 @@
-use crate::prelude::*;
-
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ContextError;
 use crate::mock::context::AnyClientState;
+use crate::prelude::*;
 use crate::signer::Signer;
 use crate::Height;
 
@@ -25,6 +24,9 @@ pub trait RelayerContext {
 
 #[cfg(test)]
 mod tests {
+    use test_log::test;
+    use tracing::debug;
+
     use crate::clients::ics07_tendermint::client_type as tm_client_type;
     use crate::core::ics02_client::client_state::ClientStateCommon;
     use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
@@ -40,9 +42,6 @@ mod tests {
     use crate::prelude::*;
     use crate::Height;
 
-    use test_log::test;
-    use tracing::debug;
-
     /// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
     /// context, assuming that the latest header on the source context is `src_header`.
     pub(crate) fn build_client_update_datagram<Ctx>(
diff --git a/crates/ibc/src/mock/ics18_relayer/error.rs b/crates/ibc/src/mock/ics18_relayer/error.rs
index d352ab93d..43dedd7b5 100644
--- a/crates/ibc/src/mock/ics18_relayer/error.rs
+++ b/crates/ibc/src/mock/ics18_relayer/error.rs
@@ -1,7 +1,8 @@
+use displaydoc::Display;
+
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::{ics03_connection, RouterError};
 use crate::Height;
-use displaydoc::Display;
 
 #[derive(Debug, Display)]
 pub enum RelayerError {
diff --git a/crates/ibc/src/mock/misbehaviour.rs b/crates/ibc/src/mock/misbehaviour.rs
index f2f6990bc..07e0fda6d 100644
--- a/crates/ibc/src/mock/misbehaviour.rs
+++ b/crates/ibc/src/mock/misbehaviour.rs
@@ -1,5 +1,3 @@
-use crate::prelude::*;
-
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::Misbehaviour as RawMisbehaviour;
@@ -8,6 +6,7 @@ use ibc_proto::protobuf::Protobuf;
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::mock::header::MockHeader;
+use crate::prelude::*;
 
 pub const MOCK_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.mock.Misbehavior";
 
diff --git a/crates/ibc/src/mock/router.rs b/crates/ibc/src/mock/router.rs
index b2c4c3270..7cfaf3829 100644
--- a/crates/ibc/src/mock/router.rs
+++ b/crates/ibc/src/mock/router.rs
@@ -1,7 +1,9 @@
-use crate::{core::ics24_host::identifier::PortId, prelude::*};
-use alloc::{collections::BTreeMap, sync::Arc};
+use alloc::collections::BTreeMap;
+use alloc::sync::Arc;
 
+use crate::core::ics24_host::identifier::PortId;
 use crate::core::router::{Module, ModuleId, Router};
+use crate::prelude::*;
 
 #[derive(Default)]
 pub struct MockRouter {
diff --git a/crates/ibc/src/prelude.rs b/crates/ibc/src/prelude.rs
index 9ff42a989..1dd86e2e1 100644
--- a/crates/ibc/src/prelude.rs
+++ b/crates/ibc/src/prelude.rs
@@ -1,11 +1,8 @@
-pub use core::prelude::v1::*;
-
 // Re-export according to alloc::prelude::v1 because it is not yet stabilized
 // https://doc.rust-lang.org/src/alloc/prelude/v1.rs.html
 pub use alloc::borrow::ToOwned;
 pub use alloc::boxed::Box;
 pub use alloc::string::{String, ToString};
 pub use alloc::vec::Vec;
-
-pub use alloc::format;
-pub use alloc::vec;
+pub use alloc::{format, vec};
+pub use core::prelude::v1::*;
diff --git a/crates/ibc/src/signer.rs b/crates/ibc/src/signer.rs
index 672492675..a00cd498e 100644
--- a/crates/ibc/src/signer.rs
+++ b/crates/ibc/src/signer.rs
@@ -1,7 +1,7 @@
-use crate::prelude::*;
-
 use derive_more::Display;
 
+use crate::prelude::*;
+
 /// Represents the address of the signer of the current transaction
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/crates/ibc/src/test.rs b/crates/ibc/src/test.rs
index e8347cdcd..6a22d0587 100644
--- a/crates/ibc/src/test.rs
+++ b/crates/ibc/src/test.rs
@@ -1,5 +1,7 @@
 #[cfg(feature = "serde")]
-use serde::{de::DeserializeOwned, Serialize};
+use serde::de::DeserializeOwned;
+#[cfg(feature = "serde")]
+use serde::Serialize;
 
 /// Test that a struct `T` can be:
 ///
diff --git a/crates/ibc/src/test_utils.rs b/crates/ibc/src/test_utils.rs
index 9d814e3e6..00468526b 100644
--- a/crates/ibc/src/test_utils.rs
+++ b/crates/ibc/src/test_utils.rs
@@ -1,5 +1,6 @@
 use subtle_encoding::bech32;
-use tendermint::{block, consensus, evidence, public_key::Algorithm};
+use tendermint::public_key::Algorithm;
+use tendermint::{block, consensus, evidence};
 
 use crate::applications::transfer::context::{
     cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
diff --git a/crates/ibc/src/utils/pretty.rs b/crates/ibc/src/utils/pretty.rs
index 0f004d8c1..7089242cc 100644
--- a/crates/ibc/src/utils/pretty.rs
+++ b/crates/ibc/src/utils/pretty.rs
@@ -20,9 +20,8 @@ impl<'a, T: Display> Display for PrettySlice<'a, T> {
 #[cfg(test)]
 mod tests {
     use super::*;
-    use crate::prelude::*;
-
     use crate::alloc::string::ToString;
+    use crate::prelude::*;
 
     #[test]
     fn test_pretty_vec_display() {
diff --git a/rustfmt.toml b/rustfmt.toml
new file mode 100644
index 000000000..e9e7427c4
--- /dev/null
+++ b/rustfmt.toml
@@ -0,0 +1,5 @@
+reorder_imports = true
+
+# unstable features
+group_imports = "StdExternalCrate"
+imports_granularity = "Module"

From 357f51d2d175524d0e3e6afd487e51e9c8569cda Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Tue, 5 Sep 2023 11:43:30 -0400
Subject: [PATCH 025/182] Implement `JsonSchema` for `MsgEnvelope` (#856)

* derive JsonSchema

* fmt

* changelog
---
 .../improvements/856-jsonschema-derive-msgenvelope.md  |  2 ++
 crates/ibc/src/core/ics02_client/msgs.rs               |  3 ++-
 crates/ibc/src/core/ics02_client/msgs/create_client.rs |  3 +++
 crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs  |  2 ++
 crates/ibc/src/core/ics02_client/msgs/update_client.rs |  2 ++
 .../ibc/src/core/ics02_client/msgs/upgrade_client.rs   |  3 +++
 crates/ibc/src/core/ics03_connection/connection.rs     |  1 +
 crates/ibc/src/core/ics03_connection/msgs.rs           |  2 ++
 .../src/core/ics03_connection/msgs/conn_open_ack.rs    |  2 ++
 .../core/ics03_connection/msgs/conn_open_confirm.rs    |  1 +
 .../src/core/ics03_connection/msgs/conn_open_init.rs   |  1 +
 .../src/core/ics03_connection/msgs/conn_open_try.rs    |  2 ++
 crates/ibc/src/core/ics03_connection/version.rs        |  1 +
 crates/ibc/src/core/ics04_channel/acknowledgement.rs   |  1 +
 crates/ibc/src/core/ics04_channel/channel.rs           |  1 +
 crates/ibc/src/core/ics04_channel/msgs.rs              |  4 ++++
 .../ibc/src/core/ics04_channel/msgs/acknowledgement.rs |  1 +
 .../src/core/ics04_channel/msgs/chan_close_confirm.rs  |  1 +
 .../ibc/src/core/ics04_channel/msgs/chan_close_init.rs |  1 +
 .../ibc/src/core/ics04_channel/msgs/chan_open_ack.rs   |  1 +
 .../src/core/ics04_channel/msgs/chan_open_confirm.rs   |  1 +
 .../ibc/src/core/ics04_channel/msgs/chan_open_init.rs  |  1 +
 .../ibc/src/core/ics04_channel/msgs/chan_open_try.rs   |  1 +
 crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs  |  1 +
 crates/ibc/src/core/ics04_channel/msgs/timeout.rs      |  1 +
 .../src/core/ics04_channel/msgs/timeout_on_close.rs    |  1 +
 crates/ibc/src/core/ics04_channel/packet.rs            |  2 ++
 crates/ibc/src/core/ics04_channel/version.rs           |  1 +
 crates/ibc/src/core/ics23_commitment/commitment.rs     |  2 ++
 crates/ibc/src/core/ics24_host/identifier.rs           |  1 +
 crates/ibc/src/core/msgs.rs                            |  1 +
 crates/ibc/src/core/timestamp.rs                       |  3 +++
 crates/ibc/src/utils/mod.rs                            |  1 +
 crates/ibc/src/utils/schema.rs                         | 10 ++++++++++
 34 files changed, 61 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md
 create mode 100644 crates/ibc/src/utils/schema.rs

diff --git a/.changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md b/.changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md
new file mode 100644
index 000000000..5eac84360
--- /dev/null
+++ b/.changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md
@@ -0,0 +1,2 @@
+- Add `JsonSchema` derive for `MsgEnvelope`
+  ([#856](https://github.com/cosmos/ibc-rs/pull/856))
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/crates/ibc/src/core/ics02_client/msgs.rs
index b1b29ac82..221adbe3c 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/crates/ibc/src/core/ics02_client/msgs.rs
@@ -1,5 +1,4 @@
 //! Defines the client message types that are sent to the chain by the relayer.
-
 use ibc_proto::google::protobuf::Any;
 
 use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
@@ -7,6 +6,7 @@ use crate::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
 use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
 use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
 use crate::core::ics24_host::identifier::ClientId;
+use crate::prelude::*;
 use crate::signer::Signer;
 
 pub mod create_client;
@@ -20,6 +20,7 @@ pub mod upgrade_client;
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ClientMsg {
     CreateClient(MsgCreateClient),
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index 93cbc126f..37214c326 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -16,9 +16,12 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgCreateClient {
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state: Any,
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub consensus_state: Any,
     pub signer: Signer,
 }
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index 02fe61905..d2a885b46 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -17,11 +17,13 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgSubmitMisbehaviour {
     /// client unique identifier
     pub client_id: ClientId,
     /// misbehaviour used for freezing the light client
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub misbehaviour: ProtoAny,
     /// signer address
     pub signer: Signer,
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 36ef02b36..4d4b809c5 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -20,9 +20,11 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpdateClient {
     pub client_id: ClientId,
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_message: Any,
     pub signer: Signer,
 }
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index 55da7a238..6fdbca40e 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -21,14 +21,17 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpgradeClient {
     // client unique identifier
     pub client_id: ClientId,
     // Upgraded client state
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub upgraded_client_state: Any,
     // Upgraded consensus state, only contains enough information
     // to serve as a basis of trust in update logic
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub upgraded_consensus_state: Any,
     // proof that old chain committed to new client
     pub proof_upgrade_client: CommitmentProofBytes,
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/crates/ibc/src/core/ics03_connection/connection.rs
index bfb73b645..d3017b406 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/crates/ibc/src/core/ics03_connection/connection.rs
@@ -377,6 +377,7 @@ impl ConnectionEnd {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Default, PartialEq, Eq, Hash)]
 pub struct Counterparty {
     client_id: ClientId,
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/crates/ibc/src/core/ics03_connection/msgs.rs
index 4adae4c9b..04b3da330 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs.rs
@@ -16,6 +16,7 @@ use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
 use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
 use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
 use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
+use crate::prelude::*;
 
 pub mod conn_open_ack;
 pub mod conn_open_confirm;
@@ -27,6 +28,7 @@ pub mod conn_open_try;
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ConnectionMsg {
     OpenInit(MsgConnectionOpenInit),
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index 415cd3983..a470c8c10 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -19,6 +19,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenAck"
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenAck {
     /// ConnectionId that chain A has chosen for it's ConnectionEnd
@@ -26,6 +27,7 @@ pub struct MsgConnectionOpenAck {
     /// ConnectionId that chain B has chosen for it's ConnectionEnd
     pub conn_id_on_b: ConnectionId,
     /// ClientState of client tracking chain A on chain B
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state_of_a_on_b: Any,
     /// proof of ConnectionEnd stored on Chain B during ConnOpenTry
     pub proof_conn_end_on_b: CommitmentProofBytes,
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
index cb1528dc3..4e55f5d9e 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
@@ -17,6 +17,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenConf
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenConfirm {
     /// ConnectionId that chain B has chosen for it's ConnectionEnd
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index 322f28cc2..b05a7feec 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -16,6 +16,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenInit
 /// Per our convention, this message is sent to chain A.
 /// The handler will check proofs of chain B.
 #[derive(Clone, Debug, PartialEq, Eq)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct MsgConnectionOpenInit {
     /// ClientId on chain A that the connection is being opened for
     pub client_id_on_a: ClientId,
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index 64269f075..ba24309f1 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -19,11 +19,13 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenTry"
 
 /// Per our convention, this message is sent to chain B.
 /// The handler will check proofs of chain A.
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenTry {
     /// ClientId on B that the connection is being opened for
     pub client_id_on_b: ClientId,
     /// ClientState of client tracking chain B on chain A
+    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state_of_b_on_a: Any,
     /// ClientId, ConnectionId and prefix of chain A
     pub counterparty: Counterparty,
diff --git a/crates/ibc/src/core/ics03_connection/version.rs b/crates/ibc/src/core/ics03_connection/version.rs
index dcdb2b9f8..2eb4d0152 100644
--- a/crates/ibc/src/core/ics03_connection/version.rs
+++ b/crates/ibc/src/core/ics03_connection/version.rs
@@ -24,6 +24,7 @@ use crate::utils::pretty::PrettySlice;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, Hash)]
 pub struct Version {
     /// unique version identifier
diff --git a/crates/ibc/src/core/ics04_channel/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
index 4c5d08cd7..a8c07066f 100644
--- a/crates/ibc/src/core/ics04_channel/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
@@ -23,6 +23,7 @@ use crate::prelude::*;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, Into)]
 pub struct Acknowledgement(Vec<u8>);
 
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 7cfac5265..56bdaed6a 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -434,6 +434,7 @@ impl From<Counterparty> for RawCounterparty {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum Order {
     None = 0isize,
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index a5e87c6e5..3757f2c5f 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -1,6 +1,8 @@
 //! Message definitions for all ICS4 domain types: channel open & close handshake datagrams, as well
 //! as packets.
 
+use crate::prelude::*;
+
 pub(crate) mod acknowledgement;
 pub(crate) mod chan_close_confirm;
 pub(crate) mod chan_close_init;
@@ -33,6 +35,7 @@ use crate::core::ics24_host::identifier::PortId;
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum ChannelMsg {
     OpenInit(MsgChannelOpenInit),
@@ -48,6 +51,7 @@ pub enum ChannelMsg {
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum PacketMsg {
     Recv(MsgRecvPacket),
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
index 250c33921..630a9468e 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
@@ -19,6 +19,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgAcknowledgement";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgAcknowledgement {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
index ed03904f6..b3462ad72 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
@@ -20,6 +20,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseConfirm";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelCloseConfirm {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
index 4ad83ef81..88dbcd7bc 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
@@ -17,6 +17,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseInit";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelCloseInit {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
index 56dc166e4..1d0676f58 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
@@ -19,6 +19,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenAck";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenAck {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
index a0daea61d..bb1714209 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
@@ -20,6 +20,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenConfirm";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenConfirm {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index f2c081252..63831cf05 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -21,6 +21,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenInit";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenInit {
     pub port_id_on_a: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
index 6e2876332..db8da599c 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
@@ -23,6 +23,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenTry";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgChannelOpenTry {
     pub port_id_on_b: PortId,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
index 9b342a7d1..42a96d559 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
@@ -18,6 +18,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgRecvPacket";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgRecvPacket {
     /// The packet to be received
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
index b2244b268..286efbda4 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
@@ -19,6 +19,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeout";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgTimeout {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
index 6e965edc4..7cfb8b075 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
@@ -18,6 +18,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeoutOnClose";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgTimeoutOnClose {
     pub packet: Packet,
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/crates/ibc/src/core/ics04_channel/packet.rs
index b80069acc..4ae6ea5e7 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/crates/ibc/src/core/ics04_channel/packet.rs
@@ -66,6 +66,7 @@ impl core::fmt::Display for PacketMsgType {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 /// The sequence number of a packet enforces ordering among packets from the same source.
 #[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash, PartialOrd, Ord)]
 pub struct Sequence(u64);
@@ -127,6 +128,7 @@ impl core::fmt::Display for Sequence {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Default, Hash, PartialEq, Eq)]
 pub struct Packet {
     pub seq_on_a: Sequence,
diff --git a/crates/ibc/src/core/ics04_channel/version.rs b/crates/ibc/src/core/ics04_channel/version.rs
index 84feb5e7e..9e07bfe21 100644
--- a/crates/ibc/src/core/ics04_channel/version.rs
+++ b/crates/ibc/src/core/ics04_channel/version.rs
@@ -27,6 +27,7 @@ use crate::prelude::*;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Version(String);
 
diff --git a/crates/ibc/src/core/ics23_commitment/commitment.rs b/crates/ibc/src/core/ics23_commitment/commitment.rs
index 1b8af341e..46c4d8150 100644
--- a/crates/ibc/src/core/ics23_commitment/commitment.rs
+++ b/crates/ibc/src/core/ics23_commitment/commitment.rs
@@ -68,6 +68,7 @@ impl From<Vec<u8>> for CommitmentRoot {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "serde", serde(transparent))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, PartialEq, Eq)]
 pub struct CommitmentProofBytes {
     #[cfg_attr(
@@ -150,6 +151,7 @@ impl TryFrom<CommitmentProofBytes> for RawMerkleProof {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, PartialEq, Eq, Hash, Default)]
 pub struct CommitmentPrefix {
     bytes: Vec<u8>,
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index d669d8731..ae5a4fbb2 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -182,6 +182,7 @@ fn parse_chain_id_string(chain_id_str: &str) -> Result<(&str, u64), IdentifierEr
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
 pub struct ClientId(String);
 
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index 7f8fe8a53..bc3642d29 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -39,6 +39,7 @@ pub trait Msg: Clone {
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub enum MsgEnvelope {
     Client(ClientMsg),
diff --git a/crates/ibc/src/core/timestamp.rs b/crates/ibc/src/core/timestamp.rs
index 64add0694..e7b22780d 100644
--- a/crates/ibc/src/core/timestamp.rs
+++ b/crates/ibc/src/core/timestamp.rs
@@ -23,8 +23,11 @@ pub const ZERO_DURATION: Duration = Duration::from_secs(0);
 /// represented as a `u64` Unix timestamp in nanoseconds, with 0 representing the absence
 /// of timestamp.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(PartialEq, Eq, Copy, Clone, Debug, Default, PartialOrd, Ord)]
 pub struct Timestamp {
+    // Note: The schema representation is the timestamp in nanoseconds (as we do with borsh).
+    #[cfg_attr(feature = "schema", schemars(with = "u64"))]
     time: Option<Time>,
 }
 
diff --git a/crates/ibc/src/utils/mod.rs b/crates/ibc/src/utils/mod.rs
index 7720ae1ed..dee880a6f 100644
--- a/crates/ibc/src/utils/mod.rs
+++ b/crates/ibc/src/utils/mod.rs
@@ -2,3 +2,4 @@
 
 pub mod macros;
 pub mod pretty;
+pub(crate) mod schema;
diff --git a/crates/ibc/src/utils/schema.rs b/crates/ibc/src/utils/schema.rs
new file mode 100644
index 000000000..88933acd0
--- /dev/null
+++ b/crates/ibc/src/utils/schema.rs
@@ -0,0 +1,10 @@
+use crate::prelude::*;
+
+/// Dummy type that mirrors `ibc_proto::google::protobuf::Any`.
+/// Meant to be used with `#[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]`
+#[allow(dead_code)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct AnySchema {
+    pub type_url: String,
+    pub value: Vec<u8>,
+}

From 366b394cdbc5ac152ed562c5c92c2ed807fb4293 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 5 Sep 2023 11:12:04 -0700
Subject: [PATCH 026/182] fix: increase_*_counters return Result (#858)

---
 ...-use-result-for-safe-counters-increment.md |  3 ++
 crates/ibc/src/core/context.rs                |  6 ++--
 crates/ibc/src/core/ics02_client/error.rs     |  2 ++
 .../ics02_client/handler/create_client.rs     | 12 ++++++-
 crates/ibc/src/core/ics03_connection/error.rs |  2 ++
 .../handler/conn_open_init.rs                 |  5 ++-
 .../ics03_connection/handler/conn_open_try.rs |  5 ++-
 crates/ibc/src/core/ics04_channel/error.rs    |  6 ++--
 .../ics04_channel/handler/chan_open_init.rs   |  5 ++-
 .../ics04_channel/handler/chan_open_try.rs    |  5 ++-
 crates/ibc/src/mock/context.rs                | 33 +++++++++++++++----
 11 files changed, 68 insertions(+), 16 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md

diff --git a/.changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md b/.changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md
new file mode 100644
index 000000000..f0f87285e
--- /dev/null
+++ b/.changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md
@@ -0,0 +1,3 @@
+- Allow hosts to handle overflow cases in `increase_*_counter` methods by
+  returning `Result<(),ContextError>` type.
+  ([#857](https://github.com/cosmos/ibc-rs/issues/857))
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index 9d9ae5e77..02b1387e8 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -251,7 +251,7 @@ pub trait ExecutionContext: ValidationContext {
     /// Called upon client creation.
     /// Increases the counter which keeps track of how many clients have been created.
     /// Should never fail.
-    fn increase_client_counter(&mut self);
+    fn increase_client_counter(&mut self) -> Result<(), ContextError>;
 
     /// Called upon successful client update.
     /// Implementations are expected to use this to record the specified time as the time at which
@@ -290,7 +290,7 @@ pub trait ExecutionContext: ValidationContext {
     /// Called upon connection identifier creation (Init or Try process).
     /// Increases the counter which keeps track of how many connections have been created.
     /// Should never fail.
-    fn increase_connection_counter(&mut self);
+    fn increase_connection_counter(&mut self) -> Result<(), ContextError>;
 
     /// Stores the given packet commitment at the given store path
     fn store_packet_commitment(
@@ -353,7 +353,7 @@ pub trait ExecutionContext: ValidationContext {
     /// Called upon channel identifier creation (Init or Try message processing).
     /// Increases the counter which keeps track of how many channels have been created.
     /// Should never fail.
-    fn increase_channel_counter(&mut self);
+    fn increase_channel_counter(&mut self) -> Result<(), ContextError>;
 
     /// Emit the given IBC event
     fn emit_ibc_event(&mut self, event: IbcEvent);
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index c055863cf..9ae4336e2 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -103,6 +103,8 @@ pub enum ClientError {
     MisbehaviourHandlingFailure { reason: String },
     /// client specific error: `{description}`
     ClientSpecific { description: String },
+    /// client counter overflow error
+    CounterOverflow,
     /// other error: `{description}`
     Other { description: String },
 }
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index ff770a22b..59082c005 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -81,7 +81,7 @@ where
 
     ctx.store_update_time(client_id.clone(), latest_height, ctx.host_timestamp()?)?;
     ctx.store_update_height(client_id.clone(), latest_height, ctx.host_height()?)?;
-    ctx.increase_client_counter();
+    ctx.increase_client_counter()?;
 
     let event = IbcEvent::CreateClient(CreateClient::new(
         client_id.clone(),
@@ -144,8 +144,12 @@ mod tests {
 
         assert!(res.is_ok(), "execution happy path");
 
+        assert_eq!(ctx.client_counter().unwrap(), 1);
+
         let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+
         assert_eq!(expected_client_state.client_type(), client_type);
+
         assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
     }
 
@@ -173,13 +177,19 @@ mod tests {
         );
 
         let res = validate(&ctx, msg.clone());
+
         assert!(res.is_ok(), "tendermint client validation happy path");
 
         let res = execute(&mut ctx, msg.clone());
+
         assert!(res.is_ok(), "tendermint client execution happy path");
 
+        assert_eq!(ctx.client_counter().unwrap(), 1);
+
         let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+
         assert_eq!(expected_client_state.client_type(), client_type);
+
         assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
     }
 }
diff --git a/crates/ibc/src/core/ics03_connection/error.rs b/crates/ibc/src/core/ics03_connection/error.rs
index 3364a274c..40d677ade 100644
--- a/crates/ibc/src/core/ics03_connection/error.rs
+++ b/crates/ibc/src/core/ics03_connection/error.rs
@@ -85,6 +85,8 @@ pub enum ConnectionError {
     },
     /// timestamp overflowed error: `{0}`
     TimestampOverflow(TimestampOverflowError),
+    /// connection counter overflow error
+    CounterOverflow,
     /// other error: `{description}`
     Other { description: String },
 }
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
index 6ee7daedc..c583482fa 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
@@ -77,7 +77,7 @@ where
         ctx_a.emit_ibc_event(event);
     }
 
-    ctx_a.increase_connection_counter();
+    ctx_a.increase_connection_counter()?;
     ctx_a.store_connection_to_client(
         &ClientConnectionPath::new(&msg.client_id_on_a),
         conn_id_on_a.clone(),
@@ -161,6 +161,9 @@ mod tests {
             }
             Expect::Success => {
                 assert!(res.is_ok(), "{err_msg}");
+
+                assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
+
                 assert_eq!(fxt.ctx.events.len(), 2);
 
                 assert!(matches!(
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 2cdd5da8c..123a58be0 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -160,7 +160,7 @@ where
     ctx_b.emit_ibc_event(event);
     ctx_b.log_message("success: conn_open_try verification passed".to_string());
 
-    ctx_b.increase_connection_counter();
+    ctx_b.increase_connection_counter()?;
     ctx_b.store_connection_to_client(
         &ClientConnectionPath::new(&msg.client_id_on_b),
         vars.conn_id_on_b.clone(),
@@ -294,6 +294,9 @@ mod tests {
             }
             Expect::Success => {
                 assert!(res.is_ok(), "{err_msg}");
+
+                assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
+
                 assert_eq!(fxt.ctx.events.len(), 2);
 
                 assert!(matches!(
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index 669a54e2f..aaa99f546 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -68,14 +68,16 @@ pub enum ChannelError {
     ProcessedHeightNotFound { client_id: ClientId, height: Height },
     /// application module error: `{description}`
     AppModule { description: String },
-    /// other error: `{description}`
-    Other { description: String },
     /// Undefined counterparty connection for `{connection_id}`
     UndefinedConnectionCounterparty { connection_id: ConnectionId },
     /// invalid proof: empty proof
     InvalidProof,
     /// identifier error: `{0}`
     InvalidIdentifier(IdentifierError),
+    /// channel counter overflow error
+    CounterOverflow,
+    /// other error: `{description}`
+    Other { description: String },
 }
 
 #[derive(Debug, Display)]
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index 15d5792ac..c6f550712 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -67,7 +67,7 @@ where
         let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &chan_id_on_a);
         ctx_a.store_channel(&chan_end_path_on_a, chan_end_on_a)?;
 
-        ctx_a.increase_channel_counter();
+        ctx_a.increase_channel_counter()?;
 
         // Initialize send, recv, and ack sequence numbers.
         let seq_send_path = SeqSendPath::new(&msg.port_id_on_a, &chan_id_on_a);
@@ -251,7 +251,10 @@ mod tests {
 
         assert!(res.is_ok(), "Execution succeeds; good parameters");
 
+        assert_eq!(ctx.channel_counter().unwrap(), 1);
+
         assert_eq!(ctx.events.len(), 2);
+
         assert!(matches!(
             ctx.events[0],
             IbcEvent::Message(MessageEvent::Channel)
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index 4cf78dce7..1effe5d9e 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -75,7 +75,7 @@ where
 
         let chan_end_path_on_b = ChannelEndPath::new(&msg.port_id_on_b, &chan_id_on_b);
         ctx_b.store_channel(&chan_end_path_on_b, chan_end_on_b)?;
-        ctx_b.increase_channel_counter();
+        ctx_b.increase_channel_counter()?;
 
         // Initialize send, recv, and ack sequence numbers.
         let seq_send_path = SeqSendPath::new(&msg.port_id_on_b, &chan_id_on_b);
@@ -337,7 +337,10 @@ mod tests {
 
         assert!(res.is_ok(), "Execution success: happy path");
 
+        assert_eq!(ctx.channel_counter().unwrap(), 1);
+
         assert_eq!(ctx.events.len(), 2);
+
         assert!(matches!(
             ctx.events[0],
             IbcEvent::Message(MessageEvent::Channel)
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 1830b211d..83ebcab32 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -1090,8 +1090,15 @@ impl ExecutionContext for MockContext {
         self
     }
 
-    fn increase_client_counter(&mut self) {
-        self.ibc_store.lock().client_ids_counter += 1
+    fn increase_client_counter(&mut self) -> Result<(), ContextError> {
+        let mut ibc_store = self.ibc_store.lock();
+
+        ibc_store.client_ids_counter = ibc_store
+            .client_ids_counter
+            .checked_add(1)
+            .ok_or(ClientError::CounterOverflow)?;
+
+        Ok(())
     }
 
     fn store_update_time(
@@ -1148,8 +1155,15 @@ impl ExecutionContext for MockContext {
         Ok(())
     }
 
-    fn increase_connection_counter(&mut self) {
-        self.ibc_store.lock().connection_ids_counter += 1;
+    fn increase_connection_counter(&mut self) -> Result<(), ContextError> {
+        let mut ibc_store = self.ibc_store.lock();
+
+        ibc_store.connection_ids_counter = ibc_store
+            .connection_ids_counter
+            .checked_add(1)
+            .ok_or(ClientError::CounterOverflow)?;
+
+        Ok(())
     }
 
     fn store_packet_commitment(
@@ -1299,8 +1313,15 @@ impl ExecutionContext for MockContext {
         Ok(())
     }
 
-    fn increase_channel_counter(&mut self) {
-        self.ibc_store.lock().channel_ids_counter += 1;
+    fn increase_channel_counter(&mut self) -> Result<(), ContextError> {
+        let mut ibc_store = self.ibc_store.lock();
+
+        ibc_store.channel_ids_counter = ibc_store
+            .channel_ids_counter
+            .checked_add(1)
+            .ok_or(ClientError::CounterOverflow)?;
+
+        Ok(())
     }
 
     fn emit_ibc_event(&mut self, event: IbcEvent) {

From 133863db5f9ce56d57b2502913a21bde0fad7bda Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 7 Sep 2023 07:25:59 -0700
Subject: [PATCH 027/182] imp: return Result type in logger and event emitter
 APIs (#860)

---
 ...857-use-result-for-safe-counters-increment.md |  0
 ...urn-result-in-logger-event-emitter-methods.md |  2 ++
 .../applications/transfer/relay/send_transfer.rs |  6 +++---
 crates/ibc/src/core/context.rs                   |  4 ++--
 .../core/ics02_client/handler/create_client.rs   |  6 +++---
 .../core/ics02_client/handler/update_client.rs   |  8 ++++----
 .../core/ics02_client/handler/upgrade_client.rs  |  4 ++--
 .../ics03_connection/handler/conn_open_ack.rs    |  6 +++---
 .../handler/conn_open_confirm.rs                 |  6 +++---
 .../ics03_connection/handler/conn_open_init.rs   |  6 +++---
 .../ics03_connection/handler/conn_open_try.rs    |  6 +++---
 crates/ibc/src/core/ics04_channel/context.rs     |  8 ++++----
 .../ics04_channel/handler/acknowledgement.rs     | 10 +++++-----
 .../ics04_channel/handler/chan_close_confirm.rs  | 10 +++++-----
 .../ics04_channel/handler/chan_close_init.rs     | 10 +++++-----
 .../core/ics04_channel/handler/chan_open_ack.rs  | 10 +++++-----
 .../ics04_channel/handler/chan_open_confirm.rs   | 10 +++++-----
 .../core/ics04_channel/handler/chan_open_init.rs | 10 +++++-----
 .../core/ics04_channel/handler/chan_open_try.rs  | 10 +++++-----
 .../core/ics04_channel/handler/recv_packet.rs    | 16 ++++++++--------
 .../core/ics04_channel/handler/send_packet.rs    |  6 +++---
 .../src/core/ics04_channel/handler/timeout.rs    | 14 +++++++-------
 crates/ibc/src/mock/context.rs                   |  6 ++++--
 23 files changed, 89 insertions(+), 85 deletions(-)
 rename .changelog/unreleased/{breaking-change => breaking-changes}/857-use-result-for-safe-counters-increment.md (100%)
 create mode 100644 .changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md

diff --git a/.changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md b/.changelog/unreleased/breaking-changes/857-use-result-for-safe-counters-increment.md
similarity index 100%
rename from .changelog/unreleased/breaking-change/857-use-result-for-safe-counters-increment.md
rename to .changelog/unreleased/breaking-changes/857-use-result-for-safe-counters-increment.md
diff --git a/.changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md b/.changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md
new file mode 100644
index 000000000..9c25b1ba3
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md
@@ -0,0 +1,2 @@
+- logger and event emitter methods return `Result<(), ContextError>` type.
+  ([#859](https://github.com/cosmos/ibc-rs/issues/859))
diff --git a/crates/ibc/src/applications/transfer/relay/send_transfer.rs b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
index 7fba81117..607457f48 100644
--- a/crates/ibc/src/applications/transfer/relay/send_transfer.rs
+++ b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
@@ -170,7 +170,7 @@ where
         send_packet_ctx_a.log_message(format!(
             "IBC fungible token transfer: {} --({})--> {}",
             msg.packet_data.sender, token, msg.packet_data.receiver
-        ));
+        ))?;
 
         let transfer_event = TransferEvent {
             sender: msg.packet_data.sender,
@@ -179,9 +179,9 @@ where
             denom: msg.packet_data.token.denom,
             memo: msg.packet_data.memo,
         };
-        send_packet_ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into());
+        send_packet_ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into())?;
 
-        send_packet_ctx_a.emit_ibc_event(MessageEvent::Module(MODULE_ID_STR.to_string()).into());
+        send_packet_ctx_a.emit_ibc_event(MessageEvent::Module(MODULE_ID_STR.to_string()).into())?;
     }
 
     Ok(())
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index 02b1387e8..c563deb71 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -356,8 +356,8 @@ pub trait ExecutionContext: ValidationContext {
     fn increase_channel_counter(&mut self) -> Result<(), ContextError>;
 
     /// Emit the given IBC event
-    fn emit_ibc_event(&mut self, event: IbcEvent);
+    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError>;
 
     /// Log the given message.
-    fn log_message(&mut self, message: String);
+    fn log_message(&mut self, message: String) -> Result<(), ContextError>;
 }
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index 59082c005..b567add04 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -88,12 +88,12 @@ where
         client_type,
         latest_height,
     ));
-    ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
-    ctx.emit_ibc_event(event);
+    ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
+    ctx.emit_ibc_event(event)?;
 
     ctx.log_message(format!(
         "success: generated new client identifier: {client_id}"
-    ));
+    ))?;
 
     Ok(())
 }
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 1aa200b1e..ebdada405 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -79,8 +79,8 @@ where
             client_id,
             client_state.client_type(),
         ));
-        ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
-        ctx.emit_ibc_event(event);
+        ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
+        ctx.emit_ibc_event(event)?;
     } else {
         if !matches!(update_kind, UpdateKind::UpdateClient) {
             return Err(ClientError::MisbehaviourHandlingFailure {
@@ -122,8 +122,8 @@ where
                     header.encode_to_vec(),
                 ))
             };
-            ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
-            ctx.emit_ibc_event(event);
+            ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
+            ctx.emit_ibc_event(event)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
index 5e43dc008..b964e2b5c 100644
--- a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
@@ -76,8 +76,8 @@ where
         old_client_state.client_type(),
         latest_height,
     ));
-    ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client));
-    ctx.emit_ibc_event(event);
+    ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
+    ctx.emit_ibc_event(event)?;
 
     Ok(())
 }
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index 1aee37d96..e8913c465 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -157,10 +157,10 @@ where
         msg.conn_id_on_b.clone(),
         vars.client_id_on_b().clone(),
     ));
-    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection));
-    ctx_a.emit_ibc_event(event);
+    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection))?;
+    ctx_a.emit_ibc_event(event)?;
 
-    ctx_a.log_message("success: conn_open_ack verification passed".to_string());
+    ctx_a.log_message("success: conn_open_ack verification passed".to_string())?;
 
     {
         let new_conn_end_on_a = {
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
index e5c1251c6..96b7240c7 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
@@ -117,9 +117,9 @@ where
         conn_id_on_a.clone(),
         client_id_on_a.clone(),
     ));
-    ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection));
-    ctx_b.emit_ibc_event(event);
-    ctx_b.log_message("success: conn_open_confirm verification passed".to_string());
+    ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection))?;
+    ctx_b.emit_ibc_event(event)?;
+    ctx_b.log_message("success: conn_open_confirm verification passed".to_string())?;
 
     {
         let new_conn_end_on_b = {
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
index c583482fa..cc470e81b 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
@@ -63,7 +63,7 @@ where
 
     ctx_a.log_message(format!(
         "success: conn_open_init: generated new connection identifier: {conn_id_on_a}"
-    ));
+    ))?;
 
     {
         let client_id_on_b = msg.counterparty.client_id().clone();
@@ -73,8 +73,8 @@ where
             msg.client_id_on_a.clone(),
             client_id_on_b,
         ));
-        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection));
-        ctx_a.emit_ibc_event(event);
+        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection))?;
+        ctx_a.emit_ibc_event(event)?;
     }
 
     ctx_a.increase_connection_counter()?;
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 123a58be0..4c0004790 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -156,9 +156,9 @@ where
         conn_id_on_a.clone(),
         vars.client_id_on_a.clone(),
     ));
-    ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection));
-    ctx_b.emit_ibc_event(event);
-    ctx_b.log_message("success: conn_open_try verification passed".to_string());
+    ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Connection))?;
+    ctx_b.emit_ibc_event(event)?;
+    ctx_b.log_message("success: conn_open_try verification passed".to_string())?;
 
     ctx_b.increase_connection_counter()?;
     ctx_b.store_connection_to_client(
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/crates/ibc/src/core/ics04_channel/context.rs
index aa7794a2e..42eb58cc7 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/crates/ibc/src/core/ics04_channel/context.rs
@@ -103,10 +103,10 @@ pub trait SendPacketExecutionContext: SendPacketValidationContext {
     ) -> Result<(), ContextError>;
 
     /// Ibc events
-    fn emit_ibc_event(&mut self, event: IbcEvent);
+    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError>;
 
     /// Logging facility
-    fn log_message(&mut self, message: String);
+    fn log_message(&mut self, message: String) -> Result<(), ContextError>;
 }
 
 impl<T> SendPacketExecutionContext for T
@@ -129,11 +129,11 @@ where
         self.store_packet_commitment(commitment_path, commitment)
     }
 
-    fn emit_ibc_event(&mut self, event: IbcEvent) {
+    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
         self.emit_ibc_event(event)
     }
 
-    fn log_message(&mut self, message: String) {
+    fn log_message(&mut self, message: String) -> Result<(), ContextError> {
         self.log_message(message)
     }
 }
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index 65c14fd40..fa8a68900 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -50,8 +50,8 @@ where
         chan_end_on_a.ordering,
         conn_id_on_a.clone(),
     ));
-    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-    ctx_a.emit_ibc_event(event);
+    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+    ctx_a.emit_ibc_event(event)?;
 
     let commitment_path_on_a = CommitmentPath::new(
         &msg.packet.port_id_on_a,
@@ -93,16 +93,16 @@ where
 
     // emit events and logs
     {
-        ctx_a.log_message("success: packet acknowledgement".to_string());
+        ctx_a.log_message("success: packet acknowledgement".to_string())?;
 
         // Note: Acknowledgement event was emitted at the beginning
 
         for module_event in extras.events {
-            ctx_a.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_a.emit_ibc_event(IbcEvent::Module(module_event))?
         }
 
         for log_message in extras.log {
-            ctx_a.log_message(log_message);
+            ctx_a.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index 57ca51e55..c36bbe507 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -55,7 +55,7 @@ where
 
     // emit events and logs
     {
-        ctx_b.log_message("success: channel close confirm".to_string());
+        ctx_b.log_message("success: channel close confirm".to_string())?;
 
         let core_event = {
             let port_id_on_a = chan_end_on_b.counterparty().port_id.clone();
@@ -78,15 +78,15 @@ where
                 conn_id_on_b,
             ))
         };
-        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_b.emit_ibc_event(core_event);
+        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_b.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_b.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_b.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_b.log_message(log_message);
+            ctx_b.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
index 01aaac7e1..174397672 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
@@ -52,7 +52,7 @@ where
 
     // emit events and logs
     {
-        ctx_a.log_message("success: channel close init".to_string());
+        ctx_a.log_message("success: channel close init".to_string())?;
 
         let core_event = {
             let port_id_on_b = chan_end_on_a.counterparty().port_id.clone();
@@ -75,15 +75,15 @@ where
                 conn_id_on_a,
             ))
         };
-        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_a.emit_ibc_event(core_event);
+        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_a.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_a.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_a.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_a.log_message(log_message);
+            ctx_a.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index 910441015..e16e25d8e 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -60,7 +60,7 @@ where
 
     // emit events and logs
     {
-        ctx_a.log_message("success: channel open ack".to_string());
+        ctx_a.log_message("success: channel open ack".to_string())?;
 
         let core_event = {
             let port_id_on_b = chan_end_on_a.counterparty().port_id.clone();
@@ -74,15 +74,15 @@ where
                 conn_id_on_a,
             ))
         };
-        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_a.emit_ibc_event(core_event);
+        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_a.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_a.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_a.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_a.log_message(log_message);
+            ctx_a.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index 9461f55aa..e7b4598f6 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -56,7 +56,7 @@ where
 
     // emit events and logs
     {
-        ctx_b.log_message("success: channel open confirm".to_string());
+        ctx_b.log_message("success: channel open confirm".to_string())?;
 
         let conn_id_on_b = chan_end_on_b.connection_hops[0].clone();
         let port_id_on_a = chan_end_on_b.counterparty().port_id.clone();
@@ -77,15 +77,15 @@ where
             chan_id_on_a,
             conn_id_on_b,
         ));
-        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_b.emit_ibc_event(core_event);
+        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_b.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_b.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_b.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_b.log_message(log_message);
+            ctx_b.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index c6f550712..cab961ed4 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -84,7 +84,7 @@ where
     {
         ctx_a.log_message(format!(
             "success: channel open init with channel identifier: {chan_id_on_a}"
-        ));
+        ))?;
         let core_event = IbcEvent::OpenInitChannel(OpenInit::new(
             msg.port_id_on_a.clone(),
             chan_id_on_a.clone(),
@@ -92,15 +92,15 @@ where
             conn_id_on_a,
             version,
         ));
-        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_a.emit_ibc_event(core_event);
+        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_a.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_a.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_a.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_a.log_message(log_message);
+            ctx_a.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index 1effe5d9e..a1c1943bc 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -92,7 +92,7 @@ where
     {
         ctx_b.log_message(format!(
             "success: channel open try with channel identifier: {chan_id_on_b}"
-        ));
+        ))?;
 
         let core_event = IbcEvent::OpenTryChannel(OpenTry::new(
             msg.port_id_on_b.clone(),
@@ -102,15 +102,15 @@ where
             conn_id_on_b,
             version,
         ));
-        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_b.emit_ibc_event(core_event);
+        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_b.emit_ibc_event(core_event)?;
 
         for module_event in extras.events {
-            ctx_b.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_b.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_b.log_message(log_message);
+            ctx_b.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index 81009c800..6f6b6cb76 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -110,8 +110,8 @@ where
 
     // emit events and logs
     {
-        ctx_b.log_message("success: packet receive".to_string());
-        ctx_b.log_message("success: packet write acknowledgement".to_string());
+        ctx_b.log_message("success: packet receive".to_string())?;
+        ctx_b.log_message("success: packet write acknowledgement".to_string())?;
 
         let conn_id_on_b = &chan_end_on_b.connection_hops()[0];
         let event = IbcEvent::ReceivePacket(ReceivePacket::new(
@@ -119,22 +119,22 @@ where
             chan_end_on_b.ordering,
             conn_id_on_b.clone(),
         ));
-        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_b.emit_ibc_event(event);
+        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_b.emit_ibc_event(event)?;
         let event = IbcEvent::WriteAcknowledgement(WriteAcknowledgement::new(
             msg.packet,
             acknowledgement,
             conn_id_on_b.clone(),
         ));
-        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_b.emit_ibc_event(event);
+        ctx_b.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_b.emit_ibc_event(event)?;
 
         for module_event in extras.events {
-            ctx_b.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_b.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_b.log_message(log_message);
+            ctx_b.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
index c978935d8..023bcd88f 100644
--- a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
@@ -125,14 +125,14 @@ pub fn send_packet_execute(
         let chan_end_on_a = ctx_a.channel_end(&chan_end_path_on_a)?;
         let conn_id_on_a = &chan_end_on_a.connection_hops()[0];
 
-        ctx_a.log_message("success: packet send".to_string());
+        ctx_a.log_message("success: packet send".to_string())?;
         let event = IbcEvent::SendPacket(SendPacket::new(
             packet,
             chan_end_on_a.ordering,
             conn_id_on_a.clone(),
         ));
-        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-        ctx_a.emit_ibc_event(event);
+        ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+        ctx_a.emit_ibc_event(event)?;
     }
 
     Ok(())
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index f8b68814a..3036ae2eb 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -64,8 +64,8 @@ where
 
     // In all cases, this event is emitted
     let event = IbcEvent::TimeoutPacket(TimeoutPacket::new(packet.clone(), chan_end_on_a.ordering));
-    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-    ctx_a.emit_ibc_event(event);
+    ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+    ctx_a.emit_ibc_event(event)?;
 
     let commitment_path_on_a =
         CommitmentPath::new(&packet.port_id_on_a, &packet.chan_id_on_a, packet.seq_on_a);
@@ -105,7 +105,7 @@ where
 
     // emit events and logs
     {
-        ctx_a.log_message("success: packet timeout".to_string());
+        ctx_a.log_message("success: packet timeout".to_string())?;
 
         if let Order::Ordered = chan_end_on_a.ordering {
             let conn_id_on_a = chan_end_on_a.connection_hops()[0].clone();
@@ -118,16 +118,16 @@ where
                 conn_id_on_a,
                 chan_end_on_a.ordering,
             ));
-            ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel));
-            ctx_a.emit_ibc_event(event);
+            ctx_a.emit_ibc_event(IbcEvent::Message(MessageEvent::Channel))?;
+            ctx_a.emit_ibc_event(event)?;
         }
 
         for module_event in extras.events {
-            ctx_a.emit_ibc_event(IbcEvent::Module(module_event));
+            ctx_a.emit_ibc_event(IbcEvent::Module(module_event))?;
         }
 
         for log_message in extras.log {
-            ctx_a.log_message(log_message);
+            ctx_a.log_message(log_message)?;
         }
     }
 
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 83ebcab32..cf2b61b5f 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -1324,12 +1324,14 @@ impl ExecutionContext for MockContext {
         Ok(())
     }
 
-    fn emit_ibc_event(&mut self, event: IbcEvent) {
+    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
         self.events.push(event);
+        Ok(())
     }
 
-    fn log_message(&mut self, message: String) {
+    fn log_message(&mut self, message: String) -> Result<(), ContextError> {
         self.logs.push(message);
+        Ok(())
     }
 }
 

From 95704fcede4146fd9039580a8a8ca2218180e400 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 13 Sep 2023 16:38:27 +0200
Subject: [PATCH 028/182] fix: immut over mut ref on validate (#863)

* immut over mut ref on validate

* cargo fmt

* add changelog
---
 .../unreleased/bug-fixes/863-immut-ref-in-validate.md       | 2 ++
 crates/ibc/src/core/handler.rs                              | 6 +-----
 2 files changed, 3 insertions(+), 5 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md

diff --git a/.changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md b/.changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md
new file mode 100644
index 000000000..91cbda02b
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md
@@ -0,0 +1,2 @@
+- Replace mutable ref with immutable ref in validate handler
+  ([\#863](https://github.com/cosmos/ibc-rs/issues/863))
\ No newline at end of file
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 5ddebcf97..7c2babfe3 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -51,11 +51,7 @@ pub fn dispatch(
 /// That is, the state transition of message `i` must be applied before
 /// message `i+1` is validated. This is equivalent to calling
 /// `dispatch()` on each successively.
-pub fn validate<Ctx>(
-    ctx: &Ctx,
-    router: &mut impl Router,
-    msg: MsgEnvelope,
-) -> Result<(), RouterError>
+pub fn validate<Ctx>(ctx: &Ctx, router: &impl Router, msg: MsgEnvelope) -> Result<(), RouterError>
 where
     Ctx: ValidationContext,
 {

From c17ff9dba665dbc6a90427a66602a5c4dc83ab89 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 15 Sep 2023 14:50:38 +0200
Subject: [PATCH 029/182] feat: core gRPC services (#842)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* add grpc service dependencies

* client service implementation

* connection service implementation

* channel service implementation

* finish grpc service implementations

* QueryContext under grpc feature

* fix no-default-features lints

* use domain types

* return query block height

* happy lint

* immut router in validate

* client and connection param service

* implement upgrade service

* fix upgrade context

* rename struct fields and generics

* remove UpgradeValidationContext trait bound

* cargo fmt and clippy

* add ProvableContext

* add proofs to client service

* add proofs to connection service

* add proofs to channel service

* remove redundant trait method

* refactor ProvableContext trait bounds

* refactor service structs

* add service doc

* add context docs

* from impl for tonic status

* remove redundant map_errs

* fix cargo doc lint

* remove irrelevant comments

* handle empty sequence list

* a general variant of PackerError

* polish comments and logging

* remove grpc from default features

* mv grpc feature gated code under service

* mv files

* update mod files

* update prelude

* happy cargo doc

* happy cargo fmt

* support latest_height flag

* rm redundant trait method

* comment on grpc feature

* todo comment for pagination

* update client_status query

* rm redundant trait method

* add changelog entry

* nitpick

* rm allowed_clients

* update client params query

* update error message

Co-authored-by: Philippe Laferrière <plafer@protonmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* revert immut ref on validate

will be fixed in separate PR

* rm tracing use

* document thread-safe params

* point changelog entry to issue

* rm FromStr from prelude

* doc strings with correct explanations

* rm reexports

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Philippe Laferrière <plafer@protonmail.com>
---
 .../features/842-impl-grpc-services.md        |   2 +
 crates/ibc/Cargo.toml                         |   3 +
 .../ics02_client/handler/create_client.rs     |   2 +-
 crates/ibc/src/core/ics04_channel/error.rs    |   2 +
 crates/ibc/src/lib.rs                         |   3 +
 crates/ibc/src/services/core/channel.rs       | 559 ++++++++++++++++++
 crates/ibc/src/services/core/client.rs        | 298 ++++++++++
 crates/ibc/src/services/core/connection.rs    | 227 +++++++
 crates/ibc/src/services/core/context.rs       |  87 +++
 crates/ibc/src/services/core/mod.rs           |   4 +
 crates/ibc/src/services/error.rs              |  18 +
 crates/ibc/src/services/mod.rs                |  48 ++
 12 files changed, 1252 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/unreleased/features/842-impl-grpc-services.md
 create mode 100644 crates/ibc/src/services/core/channel.rs
 create mode 100644 crates/ibc/src/services/core/client.rs
 create mode 100644 crates/ibc/src/services/core/connection.rs
 create mode 100644 crates/ibc/src/services/core/context.rs
 create mode 100644 crates/ibc/src/services/core/mod.rs
 create mode 100644 crates/ibc/src/services/error.rs
 create mode 100644 crates/ibc/src/services/mod.rs

diff --git a/.changelog/unreleased/features/842-impl-grpc-services.md b/.changelog/unreleased/features/842-impl-grpc-services.md
new file mode 100644
index 000000000..081992300
--- /dev/null
+++ b/.changelog/unreleased/features/842-impl-grpc-services.md
@@ -0,0 +1,2 @@
+- Blanket implementation of core gRPC services
+  ([\#686](https://github.com/cosmos/ibc-rs/issues/686))
\ No newline at end of file
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index ef9d36fb9..34225861b 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -37,6 +37,8 @@ std = [
 ]
 parity-scale-codec = ["dep:parity-scale-codec", "dep:scale-info", "ibc-proto/parity-scale-codec"]
 borsh = ["dep:borsh", "ibc-proto/borsh"]
+# includes gRPC services for IBC core
+grpc = ["dep:tonic", "ibc-proto/server"]
 
 # This feature is required for token transfer (ICS-20)
 serde = ["dep:serde", "dep:serde_derive", "serde_json", "ics23/serde"]
@@ -67,6 +69,7 @@ num-traits = { version = "0.2.15", default-features = false }
 derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
 uint = { version = "0.9", default-features = false }
 primitive-types = { version = "0.12.0", default-features = false, features = ["serde_no_std"] }
+tonic = { version = "0.9", optional = true }
 
 ## for codec encode or decode
 parity-scale-codec = { version = "3.0.0", default-features = false, features = ["full"], optional = true }
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index b567add04..68c845471 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -65,7 +65,7 @@ where
 
     let client_id = ClientId::new(client_type.clone(), id_counter).map_err(|e| {
         ContextError::from(ClientError::ClientIdentifierConstructor {
-            client_type: client_state.client_type(),
+            client_type: client_type.clone(),
             counter: id_counter,
             validation_error: e,
         })
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index aaa99f546..df43905c5 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -173,6 +173,8 @@ pub enum PacketError {
     },
     /// Cannot encode sequence `{sequence}`
     CannotEncodeSequence { sequence: Sequence },
+    /// other error: `{description}`
+    Other { description: String },
 }
 
 impl From<IdentifierError> for ChannelError {
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 965db5b2d..4c9982e0b 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -54,6 +54,9 @@ pub mod clients;
 pub mod core;
 pub mod hosts;
 
+#[cfg(feature = "grpc")]
+pub mod services;
+
 #[cfg(any(test, feature = "mocks"))]
 pub mod mock;
 #[cfg(any(test, feature = "mocks"))]
diff --git a/crates/ibc/src/services/core/channel.rs b/crates/ibc/src/services/core/channel.rs
new file mode 100644
index 000000000..3442f569d
--- /dev/null
+++ b/crates/ibc/src/services/core/channel.rs
@@ -0,0 +1,559 @@
+//! [`ChannelQueryService`](ChannelQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use alloc::str::FromStr;
+use std::boxed::Box;
+
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
+use ibc_proto::ibc::core::channel::v1::{
+    PacketState, QueryChannelClientStateRequest, QueryChannelClientStateResponse,
+    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
+    QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
+    QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
+    QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
+    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
+    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
+    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
+    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
+    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+};
+use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
+use tonic::{Request, Response, Status};
+
+use crate::core::ics04_channel::packet::Sequence;
+use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use crate::core::ics24_host::path::{
+    AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
+    ReceiptPath, SeqRecvPath, SeqSendPath,
+};
+use crate::core::ValidationContext;
+use crate::prelude::*;
+use crate::services::core::context::QueryContext;
+use crate::Height;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// The generic `I` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+}
+
+impl<I> ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I) -> Self {
+        Self { ibc_context }
+    }
+}
+
+#[tonic::async_trait]
+impl<I> ChannelQuery for ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn channel(
+        &self,
+        request: Request<QueryChannelRequest>,
+    ) -> Result<Response<QueryChannelResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::ChannelEnd(channel_end_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Channel end proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryChannelResponse {
+            channel: Some(channel_end.into()),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn channels(
+        &self,
+        _request: Request<QueryChannelsRequest>,
+    ) -> Result<Response<QueryChannelsResponse>, Status> {
+        let channel_ends = self.ibc_context.channel_ends()?;
+
+        Ok(Response::new(QueryChannelsResponse {
+            channels: channel_ends.into_iter().map(Into::into).collect(),
+            height: Some(self.ibc_context.host_height()?.into()),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn connection_channels(
+        &self,
+        request: Request<QueryConnectionChannelsRequest>,
+    ) -> Result<Response<QueryConnectionChannelsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let connection_id = ConnectionId::from_str(request_ref.connection.as_str())?;
+
+        let all_channel_ends = self.ibc_context.channel_ends()?;
+
+        let connection_channel_ends = all_channel_ends
+            .into_iter()
+            .filter(|channel_end| {
+                channel_end
+                    .channel_end
+                    .connection_hops()
+                    .iter()
+                    .any(|connection_hop| connection_hop == &connection_id)
+            })
+            .map(Into::into)
+            .collect();
+
+        Ok(Response::new(QueryConnectionChannelsResponse {
+            channels: connection_channel_ends,
+            height: Some(self.ibc_context.host_height()?.into()),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn channel_client_state(
+        &self,
+        request: Request<QueryChannelClientStateRequest>,
+    ) -> Result<Response<QueryChannelClientStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
+
+        let connection_end = channel_end
+            .connection_hops()
+            .first()
+            .map(|connection_id| self.ibc_context.connection_end(connection_id))
+            .ok_or_else(|| {
+                Status::not_found(format!("Channel {} has no connection hops", channel_id))
+            })??;
+
+        let client_state = self.ibc_context.client_state(connection_end.client_id())?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Client state proof not found for client {}",
+                    connection_end.client_id()
+                ))
+            })?;
+
+        Ok(Response::new(QueryChannelClientStateResponse {
+            identified_client_state: Some(IdentifiedClientState {
+                client_id: connection_end.client_id().as_str().into(),
+                client_state: Some(client_state.into()),
+            }),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn channel_consensus_state(
+        &self,
+        request: Request<QueryChannelConsensusStateRequest>,
+    ) -> Result<Response<QueryChannelConsensusStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let height = Height::new(request_ref.revision_number, request_ref.revision_height)
+            .map_err(|e| Status::invalid_argument(e.to_string()))?;
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
+
+        let connection_end = channel_end
+            .connection_hops()
+            .first()
+            .map(|connection_id| self.ibc_context.connection_end(connection_id))
+            .ok_or_else(|| {
+                Status::not_found(format!("Channel {} has no connection hops", channel_id))
+            })??;
+
+        let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+
+        let consensus_state = self.ibc_context.consensus_state(&consensus_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Consensus state proof not found for client {}",
+                    connection_end.client_id()
+                ))
+            })?;
+
+        Ok(Response::new(QueryChannelConsensusStateResponse {
+            client_id: connection_end.client_id().as_str().into(),
+            consensus_state: Some(consensus_state.into()),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn packet_commitment(
+        &self,
+        request: Request<QueryPacketCommitmentRequest>,
+    ) -> Result<Response<QueryPacketCommitmentResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let sequence = Sequence::from(request_ref.sequence);
+
+        let commitment_path = CommitmentPath::new(&port_id, &channel_id, sequence);
+
+        let packet_commitment_data = self.ibc_context.get_packet_commitment(&commitment_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::Commitment(commitment_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Packet commitment proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryPacketCommitmentResponse {
+            commitment: packet_commitment_data.into_vec(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn packet_commitments(
+        &self,
+        request: Request<QueryPacketCommitmentsRequest>,
+    ) -> Result<Response<QueryPacketCommitmentsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let commitments = self
+            .ibc_context
+            .packet_commitments(&channel_end_path)?
+            .into_iter()
+            .map(|path| {
+                self.ibc_context
+                    .get_packet_commitment(&path)
+                    .map(|commitment| PacketState {
+                        port_id: path.port_id.as_str().into(),
+                        channel_id: path.channel_id.as_str().into(),
+                        sequence: path.sequence.into(),
+                        data: commitment.into_vec(),
+                    })
+            })
+            .collect::<Result<_, _>>()?;
+
+        Ok(Response::new(QueryPacketCommitmentsResponse {
+            commitments,
+            height: Some(self.ibc_context.host_height()?.into()),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn packet_receipt(
+        &self,
+        request: Request<QueryPacketReceiptRequest>,
+    ) -> Result<Response<QueryPacketReceiptResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let sequence = Sequence::from(request_ref.sequence);
+
+        let receipt_path = ReceiptPath::new(&port_id, &channel_id, sequence);
+
+        // Receipt only has one enum
+        // Unreceived packets are not stored
+        let packet_receipt_data = self.ibc_context.get_packet_receipt(&receipt_path);
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::Receipt(receipt_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Packet receipt proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryPacketReceiptResponse {
+            received: packet_receipt_data.is_ok(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn packet_acknowledgement(
+        &self,
+        request: Request<QueryPacketAcknowledgementRequest>,
+    ) -> Result<Response<QueryPacketAcknowledgementResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let sequence = Sequence::from(request_ref.sequence);
+
+        let acknowledgement_path = AckPath::new(&port_id, &channel_id, sequence);
+
+        let packet_acknowledgement_data = self
+            .ibc_context
+            .get_packet_acknowledgement(&acknowledgement_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::Ack(acknowledgement_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Packet acknowledgement proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryPacketAcknowledgementResponse {
+            acknowledgement: packet_acknowledgement_data.into_vec(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    /// Returns all the acknowledgements if sequences is omitted.
+    async fn packet_acknowledgements(
+        &self,
+        request: Request<QueryPacketAcknowledgementsRequest>,
+    ) -> Result<Response<QueryPacketAcknowledgementsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let commitment_sequences = request_ref
+            .packet_commitment_sequences
+            .iter()
+            .copied()
+            .map(Sequence::from);
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let acknowledgements = self
+            .ibc_context
+            .packet_acknowledgements(&channel_end_path, commitment_sequences)?
+            .into_iter()
+            .map(|path| {
+                self.ibc_context
+                    .get_packet_acknowledgement(&path)
+                    .map(|acknowledgement| PacketState {
+                        port_id: path.port_id.as_str().into(),
+                        channel_id: path.channel_id.as_str().into(),
+                        sequence: path.sequence.into(),
+                        data: acknowledgement.into_vec(),
+                    })
+            })
+            .collect::<Result<_, _>>()?;
+
+        Ok(Response::new(QueryPacketAcknowledgementsResponse {
+            acknowledgements,
+            height: Some(self.ibc_context.host_height()?.into()),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn unreceived_packets(
+        &self,
+        request: Request<QueryUnreceivedPacketsRequest>,
+    ) -> Result<Response<QueryUnreceivedPacketsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let sequences = request_ref
+            .packet_commitment_sequences
+            .iter()
+            .copied()
+            .map(Sequence::from);
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let unreceived_packets = self
+            .ibc_context
+            .unreceived_packets(&channel_end_path, sequences)?;
+
+        Ok(Response::new(QueryUnreceivedPacketsResponse {
+            sequences: unreceived_packets.into_iter().map(Into::into).collect(),
+            height: Some(self.ibc_context.host_height()?.into()),
+        }))
+    }
+
+    /// Returns all the unreceived acknowledgements if sequences is omitted.
+    async fn unreceived_acks(
+        &self,
+        request: Request<QueryUnreceivedAcksRequest>,
+    ) -> Result<Response<QueryUnreceivedAcksResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let sequences = request_ref
+            .packet_ack_sequences
+            .iter()
+            .copied()
+            .map(Sequence::from);
+
+        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+        let unreceived_acks = self
+            .ibc_context
+            .unreceived_acks(&channel_end_path, sequences)?;
+
+        Ok(Response::new(QueryUnreceivedAcksResponse {
+            sequences: unreceived_acks.into_iter().map(Into::into).collect(),
+            height: Some(self.ibc_context.host_height()?.into()),
+        }))
+    }
+
+    async fn next_sequence_receive(
+        &self,
+        request: Request<QueryNextSequenceReceiveRequest>,
+    ) -> Result<Response<QueryNextSequenceReceiveResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let next_seq_recv_path = SeqRecvPath::new(&port_id, &channel_id);
+
+        let next_sequence_recv = self
+            .ibc_context
+            .get_next_sequence_recv(&next_seq_recv_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::SeqRecv(next_seq_recv_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Next sequence receive proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryNextSequenceReceiveResponse {
+            next_sequence_receive: next_sequence_recv.into(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn next_sequence_send(
+        &self,
+        request: Request<QueryNextSequenceSendRequest>,
+    ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
+
+        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
+
+        let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
+
+        let next_sequence_send = self
+            .ibc_context
+            .get_next_sequence_send(&next_seq_send_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Next sequence send proof not found for channel {}",
+                    channel_id
+                ))
+            })?;
+
+        Ok(Response::new(QueryNextSequenceSendResponse {
+            next_sequence_send: next_sequence_send.into(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+}
diff --git a/crates/ibc/src/services/core/client.rs b/crates/ibc/src/services/core/client.rs
new file mode 100644
index 000000000..11a7ce548
--- /dev/null
+++ b/crates/ibc/src/services/core/client.rs
@@ -0,0 +1,298 @@
+//! [`ClientQueryService`](ClientQueryService) takes generics `I` and `U` to store `ibc_context` and `upgrade_context` that implement [`QueryContext`](QueryContext) and [`UpgradeValidationContext`](UpgradeValidationContext) respectively.
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use core::str::FromStr;
+use std::boxed::Box;
+
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::client::v1::query_server::Query as ClientQuery;
+use ibc_proto::ibc::core::client::v1::{
+    ConsensusStateWithHeight, IdentifiedClientState, QueryClientParamsRequest,
+    QueryClientParamsResponse, QueryClientStateRequest, QueryClientStateResponse,
+    QueryClientStatesRequest, QueryClientStatesResponse, QueryClientStatusRequest,
+    QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
+    QueryConsensusStateHeightsResponse, QueryConsensusStateRequest, QueryConsensusStateResponse,
+    QueryConsensusStatesRequest, QueryConsensusStatesResponse, QueryUpgradedClientStateRequest,
+    QueryUpgradedClientStateResponse, QueryUpgradedConsensusStateRequest,
+    QueryUpgradedConsensusStateResponse,
+};
+use tonic::{Request, Response, Status};
+
+use crate::core::ics02_client::client_state::ClientStateValidation;
+use crate::core::ics02_client::error::ClientError;
+use crate::core::ics24_host::identifier::ClientId;
+use crate::core::ics24_host::path::{
+    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
+};
+use crate::core::{ContextError, ValidationContext};
+use crate::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
+use crate::prelude::*;
+use crate::services::core::context::QueryContext;
+use crate::Height;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// Generics `I` and `U` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+    upgrade_context: U,
+}
+
+impl<I, U> ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// Parameters `ibc_context` and `upgrade_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I, upgrade_context: U) -> Self {
+        Self {
+            ibc_context,
+            upgrade_context,
+        }
+    }
+}
+
+#[tonic::async_trait]
+impl<I, U> ClientQuery for ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn client_state(
+        &self,
+        request: Request<QueryClientStateRequest>,
+    ) -> Result<Response<QueryClientStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+        let client_state = self.ibc_context.client_state(&client_id)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::ClientState(ClientStatePath::new(&client_id)),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Proof unavailable for client {} at height {}",
+                    client_id, current_height
+                ))
+            })?;
+
+        Ok(Response::new(QueryClientStateResponse {
+            client_state: Some(client_state.into()),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn client_states(
+        &self,
+        _request: Request<QueryClientStatesRequest>,
+    ) -> Result<Response<QueryClientStatesResponse>, Status> {
+        let client_states = self.ibc_context.client_states()?;
+
+        Ok(Response::new(QueryClientStatesResponse {
+            client_states: client_states
+                .into_iter()
+                .map(|(id, state)| IdentifiedClientState {
+                    client_id: id.into(),
+                    client_state: Some(state.into()),
+                })
+                .collect(),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn consensus_state(
+        &self,
+        request: Request<QueryConsensusStateRequest>,
+    ) -> Result<Response<QueryConsensusStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+
+        let (height, consensus_state) = if request_ref.latest_height {
+            self.ibc_context
+                .consensus_states(&client_id)?
+                .into_iter()
+                .max_by_key(|(h, _)| *h)
+                .ok_or_else(|| {
+                    Status::not_found(format!(
+                        "Consensus state not found for client {}",
+                        client_id
+                    ))
+                })?
+        } else {
+            let height = Height::new(request_ref.revision_number, request_ref.revision_height)
+                .map_err(|e| Status::invalid_argument(e.to_string()))?;
+            let consensus_state = self
+                .ibc_context
+                .consensus_state(&ClientConsensusStatePath::new(&client_id, &height))?;
+
+            (height, consensus_state)
+        };
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::ClientConsensusState(ClientConsensusStatePath::new(&client_id, &height)),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Consensus state not found for client {} at height {}",
+                    client_id, height
+                ))
+            })?;
+
+        Ok(Response::new(QueryConsensusStateResponse {
+            consensus_state: Some(consensus_state.into()),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn consensus_states(
+        &self,
+        request: Request<QueryConsensusStatesRequest>,
+    ) -> Result<Response<QueryConsensusStatesResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+
+        let consensus_states = self.ibc_context.consensus_states(&client_id)?;
+
+        Ok(Response::new(QueryConsensusStatesResponse {
+            consensus_states: consensus_states
+                .into_iter()
+                .map(|(height, state)| ConsensusStateWithHeight {
+                    height: Some(height.into()),
+                    consensus_state: Some(state.into()),
+                })
+                .collect(),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn consensus_state_heights(
+        &self,
+        request: Request<QueryConsensusStateHeightsRequest>,
+    ) -> Result<Response<QueryConsensusStateHeightsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+
+        let consensus_state_heights = self.ibc_context.consensus_state_heights(&client_id)?;
+
+        Ok(Response::new(QueryConsensusStateHeightsResponse {
+            consensus_state_heights: consensus_state_heights
+                .into_iter()
+                .map(|height| height.into())
+                .collect(),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn client_status(
+        &self,
+        request: Request<QueryClientStatusRequest>,
+    ) -> Result<Response<QueryClientStatusResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+
+        let client_state = self.ibc_context.client_state(&client_id)?;
+        let client_validation_ctx = self.ibc_context.get_client_validation_context();
+        let client_status = client_state
+            .status(client_validation_ctx, &client_id)
+            .map_err(ContextError::from)?;
+
+        Ok(Response::new(QueryClientStatusResponse {
+            status: format!("{}", client_status),
+        }))
+    }
+
+    async fn client_params(
+        &self,
+        _request: Request<QueryClientParamsRequest>,
+    ) -> Result<Response<QueryClientParamsResponse>, Status> {
+        Err(Status::unimplemented(
+            "Querying ClientParams is not supported yet",
+        ))
+    }
+
+    async fn upgraded_client_state(
+        &self,
+        _request: Request<QueryUpgradedClientStateRequest>,
+    ) -> Result<Response<QueryUpgradedClientStateResponse>, Status> {
+        let plan = self
+            .upgrade_context
+            .upgrade_plan()
+            .map_err(ClientError::from)
+            .map_err(ContextError::from)?;
+
+        let upgraded_client_state_path = UpgradeClientPath::UpgradedClientState(plan.height);
+
+        let upgraded_client_state = self
+            .upgrade_context
+            .upgraded_client_state(&upgraded_client_state_path)
+            .map_err(ClientError::from)
+            .map_err(ContextError::from)?;
+
+        Ok(Response::new(QueryUpgradedClientStateResponse {
+            upgraded_client_state: Some(upgraded_client_state.into()),
+        }))
+    }
+
+    async fn upgraded_consensus_state(
+        &self,
+        _request: Request<QueryUpgradedConsensusStateRequest>,
+    ) -> Result<Response<QueryUpgradedConsensusStateResponse>, Status> {
+        let plan = self
+            .upgrade_context
+            .upgrade_plan()
+            .map_err(ClientError::from)
+            .map_err(ContextError::from)?;
+
+        let upgraded_consensus_state_path =
+            UpgradeClientPath::UpgradedClientConsensusState(plan.height);
+
+        let upgraded_consensus_state = self
+            .upgrade_context
+            .upgraded_consensus_state(&upgraded_consensus_state_path)
+            .map_err(ClientError::from)
+            .map_err(ContextError::from)?;
+
+        Ok(Response::new(QueryUpgradedConsensusStateResponse {
+            upgraded_consensus_state: Some(upgraded_consensus_state.into()),
+        }))
+    }
+}
diff --git a/crates/ibc/src/services/core/connection.rs b/crates/ibc/src/services/core/connection.rs
new file mode 100644
index 000000000..eaf77ca65
--- /dev/null
+++ b/crates/ibc/src/services/core/connection.rs
@@ -0,0 +1,227 @@
+//! [`ConnectionQueryService`](ConnectionQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use alloc::str::FromStr;
+use std::boxed::Box;
+
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
+use ibc_proto::ibc::core::connection::v1::query_server::Query as ConnectionQuery;
+use ibc_proto::ibc::core::connection::v1::{
+    Params as ConnectionParams, QueryClientConnectionsRequest, QueryClientConnectionsResponse,
+    QueryConnectionClientStateRequest, QueryConnectionClientStateResponse,
+    QueryConnectionConsensusStateRequest, QueryConnectionConsensusStateResponse,
+    QueryConnectionParamsRequest, QueryConnectionParamsResponse, QueryConnectionRequest,
+    QueryConnectionResponse, QueryConnectionsRequest, QueryConnectionsResponse,
+};
+use tonic::{Request, Response, Status};
+
+use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+use crate::core::ics24_host::path::{
+    ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
+};
+use crate::core::ValidationContext;
+use crate::prelude::*;
+use crate::services::core::context::QueryContext;
+use crate::Height;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// The generic `I` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+}
+
+impl<I> ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I) -> Self {
+        Self { ibc_context }
+    }
+}
+
+#[tonic::async_trait]
+impl<I> ConnectionQuery for ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn connection(
+        &self,
+        request: Request<QueryConnectionRequest>,
+    ) -> Result<Response<QueryConnectionResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
+
+        let connection_end = self.ibc_context.connection_end(&connection_id)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::Connection(ConnectionPath::new(&connection_id)),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Proof not found for connection path {}",
+                    connection_id.as_str()
+                ))
+            })?;
+
+        Ok(Response::new(QueryConnectionResponse {
+            connection: Some(connection_end.into()),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn connections(
+        &self,
+        _request: Request<QueryConnectionsRequest>,
+    ) -> Result<Response<QueryConnectionsResponse>, Status> {
+        let connections = self.ibc_context.connection_ends()?;
+
+        Ok(Response::new(QueryConnectionsResponse {
+            connections: connections.into_iter().map(Into::into).collect(),
+            height: Some(self.ibc_context.host_height()?.into()),
+            // no support for pagination yet
+            pagination: None,
+        }))
+    }
+
+    async fn client_connections(
+        &self,
+        request: Request<QueryClientConnectionsRequest>,
+    ) -> Result<Response<QueryClientConnectionsResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
+
+        let connections = self.ibc_context.client_connection_ends(&client_id)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof: Vec<u8> = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::ClientConnection(ClientConnectionPath::new(&client_id)),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Proof not found for client connection path {}",
+                    client_id.as_str()
+                ))
+            })?;
+
+        Ok(Response::new(QueryClientConnectionsResponse {
+            connection_paths: connections.into_iter().map(|x| x.as_str().into()).collect(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn connection_client_state(
+        &self,
+        request: Request<QueryConnectionClientStateRequest>,
+    ) -> Result<Response<QueryConnectionClientStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
+
+        let connection_end = self.ibc_context.connection_end(&connection_id)?;
+
+        let client_state = self.ibc_context.client_state(connection_end.client_id())?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(
+                current_height,
+                &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+            )
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Proof not found for client state path {}",
+                    connection_end.client_id().as_str()
+                ))
+            })?;
+
+        Ok(Response::new(QueryConnectionClientStateResponse {
+            identified_client_state: Some(IdentifiedClientState {
+                client_id: connection_end.client_id().as_str().into(),
+                client_state: Some(client_state.into()),
+            }),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn connection_consensus_state(
+        &self,
+        request: Request<QueryConnectionConsensusStateRequest>,
+    ) -> Result<Response<QueryConnectionConsensusStateResponse>, Status> {
+        let request_ref = request.get_ref();
+
+        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
+
+        let connection_end = self.ibc_context.connection_end(&connection_id)?;
+
+        let height = Height::new(request_ref.revision_number, request_ref.revision_height)
+            .map_err(|e| Status::invalid_argument(e.to_string()))?;
+
+        let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+
+        let consensus_state = self.ibc_context.consensus_state(&consensus_path)?;
+
+        let current_height = self.ibc_context.host_height()?;
+
+        let proof = self
+            .ibc_context
+            .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
+            .ok_or_else(|| {
+                Status::not_found(format!(
+                    "Proof not found for consensus state path {}",
+                    connection_end.client_id().as_str()
+                ))
+            })?;
+
+        Ok(Response::new(QueryConnectionConsensusStateResponse {
+            consensus_state: Some(consensus_state.into()),
+            client_id: connection_end.client_id().as_str().into(),
+            proof,
+            proof_height: Some(current_height.into()),
+        }))
+    }
+
+    async fn connection_params(
+        &self,
+        _request: Request<QueryConnectionParamsRequest>,
+    ) -> Result<Response<QueryConnectionParamsResponse>, Status> {
+        Ok(Response::new(QueryConnectionParamsResponse {
+            params: Some(ConnectionParams {
+                max_expected_time_per_block: self
+                    .ibc_context
+                    .max_expected_time_per_block()
+                    .as_secs(),
+            }),
+        }))
+    }
+}
diff --git a/crates/ibc/src/services/core/context.rs b/crates/ibc/src/services/core/context.rs
new file mode 100644
index 000000000..14632f25f
--- /dev/null
+++ b/crates/ibc/src/services/core/context.rs
@@ -0,0 +1,87 @@
+//! Required traits for blanket implementations of [`gRPC query services`](crate::services::core).
+
+use crate::core::ics03_connection::connection::IdentifiedConnectionEnd;
+use crate::core::ics04_channel::channel::IdentifiedChannelEnd;
+use crate::core::ics04_channel::packet::Sequence;
+use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
+use crate::core::ics24_host::path::{AckPath, ChannelEndPath, CommitmentPath, Path};
+use crate::core::{ContextError, ValidationContext};
+use crate::prelude::*;
+use crate::Height;
+
+/// Context to be implemented by the host to provide proofs in gRPC query responses
+///
+/// Trait used for the [`gRPC query services`](crate::services).
+pub trait ProvableContext {
+    /// Returns the proof for the given path at the given height.
+    /// As this is in the context of IBC, the path is expected to be an [`IbcPath`](Path).
+    fn get_proof(&self, height: Height, path: &Path) -> Option<Vec<u8>>;
+}
+
+/// Context to be implemented by the host that provides gRPC query services.
+///
+/// Trait used for the [`gRPC query services`](crate::services).
+pub trait QueryContext: ProvableContext + ValidationContext {
+    // Client queries
+
+    /// Returns the list of all clients.
+    fn client_states(
+        &self,
+    ) -> Result<Vec<(ClientId, <Self as ValidationContext>::AnyClientState)>, ContextError>;
+
+    /// Returns the list of all consensus states for the given client.
+    fn consensus_states(
+        &self,
+        client_id: &ClientId,
+    ) -> Result<Vec<(Height, <Self as ValidationContext>::AnyConsensusState)>, ContextError>;
+
+    /// Returns the list of all heights at which consensus states for the given client are.
+    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
+
+    // Connection queries
+
+    /// Returns the list of all connection ends.
+    fn connection_ends(&self) -> Result<Vec<IdentifiedConnectionEnd>, ContextError>;
+
+    /// Returns the list of all connection ids of the given client.
+    fn client_connection_ends(
+        &self,
+        client_id: &ClientId,
+    ) -> Result<Vec<ConnectionId>, ContextError>;
+
+    // Channel queries
+
+    /// Returns the list of all channel ends.
+    fn channel_ends(&self) -> Result<Vec<IdentifiedChannelEnd>, ContextError>;
+
+    // Packet queries
+
+    /// Returns the list of all packet commitments for the given channel end.
+    fn packet_commitments(
+        &self,
+        channel_end_path: &ChannelEndPath,
+    ) -> Result<Vec<CommitmentPath>, ContextError>;
+
+    /// Filters the list of packet sequences for the given channel end that are acknowledged.
+    /// Returns all the packet acknowledgements if `sequences` is empty.
+    fn packet_acknowledgements(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<AckPath>, ContextError>;
+
+    /// Filters the packet sequences for the given channel end that are not received.
+    fn unreceived_packets(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<Sequence>, ContextError>;
+
+    /// Filters the list of packet sequences for the given channel end whose acknowledgement is not received.
+    /// Returns all the unreceived acknowledgements if `sequences` is empty.
+    fn unreceived_acks(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<Sequence>, ContextError>;
+}
diff --git a/crates/ibc/src/services/core/mod.rs b/crates/ibc/src/services/core/mod.rs
new file mode 100644
index 000000000..4404ef3e9
--- /dev/null
+++ b/crates/ibc/src/services/core/mod.rs
@@ -0,0 +1,4 @@
+pub mod channel;
+pub mod client;
+pub mod connection;
+pub mod context;
diff --git a/crates/ibc/src/services/error.rs b/crates/ibc/src/services/error.rs
new file mode 100644
index 000000000..433a5e321
--- /dev/null
+++ b/crates/ibc/src/services/error.rs
@@ -0,0 +1,18 @@
+use alloc::string::ToString;
+
+use tonic::Status;
+
+use crate::core::ics24_host::identifier::IdentifierError;
+use crate::core::ContextError;
+
+impl From<IdentifierError> for Status {
+    fn from(err: IdentifierError) -> Self {
+        Status::invalid_argument(err.to_string())
+    }
+}
+
+impl From<ContextError> for Status {
+    fn from(err: ContextError) -> Self {
+        Status::not_found(err.to_string())
+    }
+}
diff --git a/crates/ibc/src/services/mod.rs b/crates/ibc/src/services/mod.rs
new file mode 100644
index 000000000..d90ad3055
--- /dev/null
+++ b/crates/ibc/src/services/mod.rs
@@ -0,0 +1,48 @@
+//! Implementation of the gRPC services of core IBC components.
+//!
+//! The provided structs includes blanket implementation of their corresponding gRPC service traits,
+//! if the host implements the following _context_ traits.
+//! - [`ValidationContext`](crate::core::ValidationContext)
+//! - [`ProvableContext`](crate::services::core::context::ProvableContext)
+//! - [`QueryContext`](crate::services::core::context::QueryContext)
+//! - [`UpgradeValidationContext`](crate::hosts::tendermint::upgrade_proposal::UpgradeValidationContext)
+//!   - Only for [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_client_state) and [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_consensus_state)
+//!
+//! Example
+//! ```rust,ignore
+//! use ibc_proto::ibc::core::{
+//!     channel::v1::query_server::QueryServer as ChannelQueryServer
+//!     client::v1::query_server::QueryServer as ClientQueryServer,
+//!     connection::v1::query_server::QueryServer as ConnectionQueryServer,
+//! }
+//! use ibc::core::ValidationContext;
+//! use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
+//! use ibc::services::core::{ProvableContext, QueryContext};
+//! use ibc::services::{ChannelQueryService, ClientQueryService, ConnectionQueryService};
+//!
+//! struct Ibc;
+//! impl ValidationContext for Ibc { }
+//! impl ProvableContext for Ibc { }
+//! impl QueryContext for Ibc { }
+//!
+//! struct Upgrade;
+//! impl UpgradeValidationContext for Upgrade { }
+//!
+//! let ibc = Ibc::new();
+//! let upgrade = Upgrade::new();
+//!
+//! // `ibc` and `upgrade` must be thread-safe
+//!
+//! let client_service = ClientQueryServer::new(ClientQueryService::new(ibc.clone(), upgrade))
+//! let connection_service = ConnectionQueryServer::new(ConnectionQueryService::new(ibc.clone()))
+//! let channel_service = ChannelQueryServer::new(ChannelQueryService::new(ibc))
+//!
+//! let grpc_server = tonic::transport::Server::builder()
+//!       .add_service(client_service)
+//!       .add_service(connection_service)
+//!       .add_service(channel_service)
+//!       .serve(addr);
+//! ```
+
+pub mod core;
+pub mod error;

From a9132b1dcc286e02ff4d69d8d4928cafe6a5b479 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 15 Sep 2023 09:54:41 -0700
Subject: [PATCH 030/182] imp: remove unused code snippets (#870)

---
 .../improvements/869-codebase-cleanup.md      |   2 +
 .../clients/ics07_tendermint/client_state.rs  |   3 +-
 .../ics07_tendermint/consensus_state.rs       |   2 +-
 .../src/core/ics04_channel/acknowledgement.rs |   2 -
 crates/ibc/src/lib.rs                         |   3 -
 crates/ibc/src/proofs.rs                      | 104 ------------------
 crates/ibc/src/serializers.rs                 |  32 ++++++
 crates/ibc/src/test.rs                        |  30 -----
 crates/ibc/src/test_utils.rs                  |  25 -----
 9 files changed, 36 insertions(+), 167 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/869-codebase-cleanup.md
 delete mode 100644 crates/ibc/src/proofs.rs
 delete mode 100644 crates/ibc/src/test.rs

diff --git a/.changelog/unreleased/improvements/869-codebase-cleanup.md b/.changelog/unreleased/improvements/869-codebase-cleanup.md
new file mode 100644
index 000000000..55d9edca9
--- /dev/null
+++ b/.changelog/unreleased/improvements/869-codebase-cleanup.md
@@ -0,0 +1,2 @@
+- Remove unused code snippets and move serializer roundtrip test to `serializers.rs`
+  ([#869](https://github.com/cosmos/ibc-rs/issues/869))
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index f9709e38d..f4e02a952 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -1099,8 +1099,7 @@ mod tests {
 mod serde_tests {
     use tendermint_rpc::endpoint::abci_query::AbciQuery;
 
-    use crate::test::test_serialization_roundtrip;
-
+    use crate::serializers::tests::test_serialization_roundtrip;
     #[test]
     fn serialization_roundtrip_no_proof() {
         let json_data =
diff --git a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
index 39c654364..7139b3284 100644
--- a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
@@ -167,7 +167,7 @@ mod tests {
     use tendermint_rpc::endpoint::abci_query::AbciQuery;
     use test_log::test;
 
-    use crate::test::test_serialization_roundtrip;
+    use crate::serializers::tests::test_serialization_roundtrip;
 
     #[test]
     fn serialization_roundtrip_no_proof() {
diff --git a/crates/ibc/src/core/ics04_channel/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
index a8c07066f..ceb68fa57 100644
--- a/crates/ibc/src/core/ics04_channel/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
@@ -193,8 +193,6 @@ mod test {
     fn test_ack_de() {
         fn de_json_assert_eq(json_str: &str, ack: AcknowledgementStatus) {
             let de = serde_json::from_str::<AcknowledgementStatus>(json_str).unwrap();
-            std::println!("de: {:?}", de);
-            std::println!("ack: {:?}", ack);
             assert_eq!(de, ack)
         }
 
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 4c9982e0b..46b9c3a53 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -69,8 +69,5 @@ mod utils;
 #[cfg(feature = "serde")]
 mod serializers;
 
-#[cfg(test)]
-mod test;
-
 /// Re-export the `Any` type which used across the library.
 pub use ibc_proto::google::protobuf::Any;
diff --git a/crates/ibc/src/proofs.rs b/crates/ibc/src/proofs.rs
deleted file mode 100644
index 918cc14a7..000000000
--- a/crates/ibc/src/proofs.rs
+++ /dev/null
@@ -1,104 +0,0 @@
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::Height;
-use displaydoc::Display;
-
-#[derive(Debug, Display)]
-pub enum ProofError {
-    /// proof height cannot be zero
-    ZeroHeight,
-    /// proof cannot be empty
-    EmptyProof,
-}
-
-#[cfg(feature = "std")]
-impl std::error::Error for ProofError {}
-
-/// Structure comprising proofs in a message. Proofs are typically present in messages for
-/// handshake protocols, e.g., ICS3 connection (open) handshake or ICS4 channel (open and close)
-/// handshake, as well as for ICS4 packets, timeouts, and acknowledgements.
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq, Eq)]
-pub struct Proofs {
-    object_proof: CommitmentProofBytes,
-    client_proof: Option<CommitmentProofBytes>,
-    consensus_proof: Option<ConsensusProof>,
-    /// Currently used for proof_close for MsgTimeoutOnCLose where object_proof is proof_unreceived
-    other_proof: Option<CommitmentProofBytes>,
-    /// Height for the commitment root for proving the proofs above.
-    /// When creating these proofs, the chain is queried at `height-1`.
-    height: Height,
-}
-
-impl Proofs {
-    pub fn new(
-        object_proof: CommitmentProofBytes,
-        client_proof: Option<CommitmentProofBytes>,
-        consensus_proof: Option<ConsensusProof>,
-        other_proof: Option<CommitmentProofBytes>,
-        height: Height,
-    ) -> Result<Self, ProofError> {
-        Ok(Self {
-            object_proof,
-            client_proof,
-            consensus_proof,
-            other_proof,
-            height,
-        })
-    }
-
-    /// Getter for the consensus_proof field of this proof. Intuitively, this is a proof that a
-    /// client on the source chain stores a consensus state for the destination chain.
-    pub fn consensus_proof(&self) -> Option<ConsensusProof> {
-        self.consensus_proof.clone()
-    }
-
-    /// Getter for the height field of this proof (i.e., the consensus height where this proof was
-    /// created).
-    pub fn height(&self) -> Height {
-        self.height
-    }
-
-    /// Getter for the object-specific proof (e.g., proof for connection state or channel state).
-    pub fn object_proof(&self) -> &CommitmentProofBytes {
-        &self.object_proof
-    }
-
-    /// Getter for the client_proof.
-    pub fn client_proof(&self) -> &Option<CommitmentProofBytes> {
-        &self.client_proof
-    }
-
-    /// Getter for the other_proof.
-    pub fn other_proof(&self) -> &Option<CommitmentProofBytes> {
-        &self.other_proof
-    }
-}
-
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq, Eq)]
-pub struct ConsensusProof {
-    proof: CommitmentProofBytes,
-    height: Height,
-}
-
-impl ConsensusProof {
-    pub fn new(
-        consensus_proof: CommitmentProofBytes,
-        consensus_height: Height,
-    ) -> Result<Self, ProofError> {
-        Ok(Self {
-            proof: consensus_proof,
-            height: consensus_height,
-        })
-    }
-
-    /// Getter for the height field of this consensus proof.
-    pub fn height(&self) -> Height {
-        self.height
-    }
-
-    /// Getter for the proof (CommitmentProof) field of this consensus proof.
-    pub fn proof(&self) -> &CommitmentProofBytes {
-        &self.proof
-    }
-}
diff --git a/crates/ibc/src/serializers.rs b/crates/ibc/src/serializers.rs
index 42aead55a..5e0a49281 100644
--- a/crates/ibc/src/serializers.rs
+++ b/crates/ibc/src/serializers.rs
@@ -37,3 +37,35 @@ pub mod serde_string {
             .map_err(de::Error::custom)
     }
 }
+
+/// Test that a struct `T` can be:
+///
+/// - parsed out of the provided JSON data
+/// - serialized back to JSON
+/// - parsed back from the serialized JSON of the previous step
+/// - that the two parsed structs are equal according to their `PartialEq` impl
+#[cfg(test)]
+pub mod tests {
+    use serde::de::DeserializeOwned;
+
+    use super::*;
+
+    pub fn test_serialization_roundtrip<T>(json_data: &str)
+    where
+        T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
+    {
+        let parsed0 = serde_json::from_str::<T>(json_data);
+        assert!(parsed0.is_ok());
+        let parsed0 = parsed0.unwrap();
+
+        let serialized = serde_json::to_string(&parsed0);
+        assert!(serialized.is_ok());
+        let serialized = serialized.unwrap();
+
+        let parsed1 = serde_json::from_str::<T>(&serialized);
+        assert!(parsed1.is_ok());
+        let parsed1 = parsed1.unwrap();
+
+        assert_eq!(parsed0, parsed1);
+    }
+}
diff --git a/crates/ibc/src/test.rs b/crates/ibc/src/test.rs
deleted file mode 100644
index 6a22d0587..000000000
--- a/crates/ibc/src/test.rs
+++ /dev/null
@@ -1,30 +0,0 @@
-#[cfg(feature = "serde")]
-use serde::de::DeserializeOwned;
-#[cfg(feature = "serde")]
-use serde::Serialize;
-
-/// Test that a struct `T` can be:
-///
-/// - parsed out of the provided JSON data
-/// - serialized back to JSON
-/// - parsed back from the serialized JSON of the previous step
-/// - that the two parsed structs are equal according to their `PartialEq` impl
-#[cfg(feature = "serde")]
-pub fn test_serialization_roundtrip<T>(json_data: &str)
-where
-    T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
-{
-    let parsed0 = serde_json::from_str::<T>(json_data);
-    assert!(parsed0.is_ok());
-    let parsed0 = parsed0.unwrap();
-
-    let serialized = serde_json::to_string(&parsed0);
-    assert!(serialized.is_ok());
-    let serialized = serialized.unwrap();
-
-    let parsed1 = serde_json::from_str::<T>(&serialized);
-    assert!(parsed1.is_ok());
-    let parsed1 = parsed1.unwrap();
-
-    assert_eq!(parsed0, parsed1);
-}
diff --git a/crates/ibc/src/test_utils.rs b/crates/ibc/src/test_utils.rs
index 00468526b..6a13ff639 100644
--- a/crates/ibc/src/test_utils.rs
+++ b/crates/ibc/src/test_utils.rs
@@ -1,6 +1,4 @@
 use subtle_encoding::bech32;
-use tendermint::public_key::Algorithm;
-use tendermint::{block, consensus, evidence};
 
 use crate::applications::transfer::context::{
     cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
@@ -17,29 +15,6 @@ use crate::core::router::{Module, ModuleExtras};
 use crate::prelude::*;
 use crate::signer::Signer;
 
-// Needed in mocks.
-pub fn default_consensus_params() -> consensus::Params {
-    consensus::Params {
-        block: block::Size {
-            max_bytes: 22020096,
-            max_gas: -1,
-            time_iota_ms: 1000,
-        },
-        evidence: evidence::Params {
-            max_age_num_blocks: 100000,
-            max_age_duration: evidence::Duration(core::time::Duration::new(48 * 3600, 0)),
-            max_bytes: 0,
-        },
-        validator: consensus::params::ValidatorParams {
-            pub_key_types: vec![Algorithm::Ed25519],
-        },
-        version: Some(consensus::params::VersionParams::default()),
-        abci: consensus::params::AbciParams {
-            vote_extensions_enable_height: None,
-        },
-    }
-}
-
 pub fn get_dummy_proof() -> Vec<u8> {
     "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
         .as_bytes()

From 6922b5f63e32407154bac6c1dd67ce8f486b112b Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 20 Sep 2023 12:13:38 -0700
Subject: [PATCH 031/182] deps: bump ibc-proto-rs to v0.35.0 along with some
 other minor dependency updates (#873)

* chore: update deps

* chore: add unclog

* fix: update cargo.lock for no-std-check
---
 .../breaking-changes/873-bump-ibc-proto-rs.md |   2 +
 ci/no-std-check/Cargo.lock                    | 306 ++++++++++--------
 ci/no-std-check/Cargo.toml                    |  16 +-
 crates/ibc/Cargo.toml                         |   4 +-
 4 files changed, 178 insertions(+), 150 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md

diff --git a/.changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md b/.changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md
new file mode 100644
index 000000000..f421724c4
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md
@@ -0,0 +1,2 @@
+- Bump `ibc-proto-rs` to v0.35.0 along with some other minor dependency updates
+  ([#873](https://github.com/cosmos/ibc-rs/issues/873))
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 4915d7e39..72bae601d 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -240,19 +240,19 @@ dependencies = [
 
 [[package]]
 name = "borsh"
-version = "0.9.3"
+version = "0.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "15bf3650200d8bffa99015595e10f1fbd17de07abbc25bb067da79e769939bfa"
+checksum = "4114279215a005bc675e386011e594e1d9b800918cea18fcadadcce864a2046b"
 dependencies = [
  "borsh-derive",
- "hashbrown 0.11.2",
+ "hashbrown 0.13.2",
 ]
 
 [[package]]
 name = "borsh-derive"
-version = "0.9.3"
+version = "0.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6441c552f230375d18e3cc377677914d2ca2b0d36e52129fe15450a2dce46775"
+checksum = "0754613691538d51f329cce9af41d7b7ca150bc973056f1156611489475f54f7"
 dependencies = [
  "borsh-derive-internal",
  "borsh-schema-derive-internal",
@@ -263,9 +263,9 @@ dependencies = [
 
 [[package]]
 name = "borsh-derive-internal"
-version = "0.9.3"
+version = "0.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5449c28a7b352f2d1e592a8a28bf139bc71afb0764a14f3c02500935d8c44065"
+checksum = "afb438156919598d2c7bad7e1c0adf3d26ed3840dbc010db1a882a65583ca2fb"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -274,9 +274,9 @@ dependencies = [
 
 [[package]]
 name = "borsh-schema-derive-internal"
-version = "0.9.3"
+version = "0.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cdbd5696d8bfa21d53d9fe39a714a18538bad11492a42d066dbbc395fb1951c0"
+checksum = "634205cc43f74a1b9046ef87c4540ebda95696ec0f315024860cad7c5b0f5ccd"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -297,9 +297,12 @@ dependencies = [
 
 [[package]]
 name = "bs58"
-version = "0.4.0"
+version = "0.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "771fe0050b883fcc3ea2359b1a96bcfbc090b7116eae7c3c512c7a083fdf23d3"
+checksum = "f5353f36341f7451062466f0b755b96ac3a9547e4d7f6b70d603fc721a7d7896"
+dependencies = [
+ "tinyvec",
+]
 
 [[package]]
 name = "bumpalo"
@@ -474,6 +477,33 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "curve25519-dalek"
+version = "4.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "622178105f911d937a42cdb140730ba4a3ed2becd8ae6ce39c7d28b5d75d4588"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "curve25519-dalek-derive",
+ "digest 0.10.7",
+ "fiat-crypto",
+ "platforms",
+ "rustc_version",
+ "subtle",
+]
+
+[[package]]
+name = "curve25519-dalek-derive"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83fdaf97f4804dcebfa5862639bc9ce4121e82140bec2a987ac5140294865b5b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.32",
+]
+
 [[package]]
 name = "curve25519-dalek-ng"
 version = "4.1.1"
@@ -508,7 +538,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -519,7 +549,7 @@ checksum = "29a358ff9f12ec09c3e61fef9b5a9902623a695a46a917b07f269bff1445611a"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -580,7 +610,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -610,15 +640,6 @@ version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "68b0cf012f1230e43cd00ebb729c6bb58707ecfa8ad08b52ef3a4ccd2697fc30"
 
-[[package]]
-name = "ed25519"
-version = "1.5.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91cff35c70bba8a626e3185d8cd48cc11b5437e1a5bcd15b9b5fa3c64b6dfee7"
-dependencies = [
- "signature 1.6.4",
-]
-
 [[package]]
 name = "ed25519"
 version = "2.2.1"
@@ -626,7 +647,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5fb04eee5d9d907f29e80ee6b0e78f7e2c82342c63e3580d8c4f69d9d5aad963"
 dependencies = [
  "pkcs8",
- "signature 2.1.0",
+ "signature",
 ]
 
 [[package]]
@@ -644,14 +665,13 @@ dependencies = [
 
 [[package]]
 name = "ed25519-dalek"
-version = "1.0.1"
+version = "2.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c762bae6dcaf24c4c84667b8579785430908723d5c889f469d76a41d59cc7a9d"
+checksum = "7277392b266383ef8396db7fdeb1e77b6c52fed775f5df15bb24f35b72156980"
 dependencies = [
- "curve25519-dalek 3.2.0",
- "ed25519 1.5.3",
- "sha2 0.9.9",
- "zeroize",
+ "curve25519-dalek 4.1.0",
+ "ed25519",
+ "sha2 0.10.7",
 ]
 
 [[package]]
@@ -713,6 +733,12 @@ version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4443176a9f2c162692bd3d352d745ef9413eec5782a80d8fd6f8a1ac692a07f7"
 
+[[package]]
+name = "fiat-crypto"
+version = "0.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d0870c84016d4b481be5c9f323c24f65e31e901ae618f0e80f4308fb00de1d2d"
+
 [[package]]
 name = "fixed-hash"
 version = "0.8.0"
@@ -812,7 +838,7 @@ checksum = "89ca545a94061b6365f2c7355b4b32bd20df3ff95f02da9329b34ccc3bd6ee72"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -912,15 +938,6 @@ dependencies = [
  "crunchy",
 ]
 
-[[package]]
-name = "hashbrown"
-version = "0.11.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab5ef0d4909ef3724cc8cce6ccc8572c5c817592e9285f5464f8e86f8bd3726e"
-dependencies = [
- "ahash 0.7.6",
-]
-
 [[package]]
 name = "hashbrown"
 version = "0.12.3"
@@ -1040,7 +1057,7 @@ dependencies = [
  "serde",
  "serde_derive",
  "serde_json",
- "sha2 0.10.6",
+ "sha2 0.10.7",
  "subtle-encoding",
  "tendermint",
  "tendermint-light-client-verifier",
@@ -1057,14 +1074,14 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
 name = "ibc-proto"
-version = "0.34.0"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6e8625e1aa28e4da4a33505c6469747a9201f14ccd9012e2481313dfbbf9e2f"
+checksum = "459ccbab879b749bf500ae13244593fa16fc64c1b3159f6b0753c169625a1e23"
 dependencies = [
  "base64 0.21.2",
  "borsh",
@@ -1092,7 +1109,7 @@ dependencies = [
  "prost",
  "ripemd",
  "serde",
- "sha2 0.10.6",
+ "sha2 0.10.7",
  "sha3",
 ]
 
@@ -1384,8 +1401,8 @@ dependencies = [
  "sp-core",
  "sp-io",
  "sp-runtime",
- "sp-std 7.0.0",
- "syn 2.0.27",
+ "sp-std",
+ "syn 2.0.32",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1569,6 +1586,12 @@ dependencies = [
  "spki",
 ]
 
+[[package]]
+name = "platforms"
+version = "3.1.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4503fa043bf02cee09a9582e9554b4c6403b2ef55e4612e96561d294419429f8"
+
 [[package]]
 name = "ppv-lite86"
 version = "0.2.17"
@@ -1769,7 +1792,7 @@ checksum = "8d2275aab483050ab2a7364c1a46604865ee7d6906684e08db0f090acf74f9e7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -1831,6 +1854,15 @@ version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3e75f6a532d0fd9f7f13144f392b6ad56a32696bfcd9c78f797f16bbb6f072d6"
 
+[[package]]
+name = "rustc_version"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bfa0f585226d2e68097d4f95d113b15b83a82e819ab25717ec0590d9584ef366"
+dependencies = [
+ "semver",
+]
+
 [[package]]
 name = "rustix"
 version = "0.36.14"
@@ -2006,11 +2038,17 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "semver"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b0293b4b29daaf487284529cc2f5675b8e57c61f70167ba415a463651fd6a918"
+
 [[package]]
 name = "serde"
-version = "1.0.179"
+version = "1.0.188"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0a5bf42b8d227d4abf38a1ddb08602e229108a517cd4e5bb28f9c7eaafdce5c0"
+checksum = "cf9e0fcba69a370eed61bcf2b728575f726b50b55cba78064753d708ddc7549e"
 dependencies = [
  "serde_derive",
 ]
@@ -2026,13 +2064,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.179"
+version = "1.0.188"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "741e124f5485c7e60c03b043f79f320bff3527f4bbf12cf3831750dc46a0ec2c"
+checksum = "4eca7ac642d82aa35b60049a6eccb4be6be75e599bd2e9adb5f875a737654af2"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -2054,7 +2092,7 @@ checksum = "bcec881020c684085e55a25f7fd888954d56609ef363479dc5a1305eb0d40cab"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -2084,9 +2122,9 @@ dependencies = [
 
 [[package]]
 name = "sha2"
-version = "0.10.6"
+version = "0.10.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "82e6b795fe2e3b1e845bafcb27aa35405c4d47cdfc92af5fc8d3002f76cebdc0"
+checksum = "479fb9d862239e610720565ca91403019f2f00410f1864c5aa7479b950a76ed8"
 dependencies = [
  "cfg-if",
  "cpufeatures",
@@ -2112,12 +2150,6 @@ dependencies = [
  "lazy_static",
 ]
 
-[[package]]
-name = "signature"
-version = "1.6.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74233d3b3b2f6d4b006dc19dee745e73e2a6bfb6f93607cd3b02bd5b00797d7c"
-
 [[package]]
 name = "signature"
 version = "2.1.0"
@@ -2135,46 +2167,47 @@ dependencies = [
 
 [[package]]
 name = "smallvec"
-version = "1.10.0"
+version = "1.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a507befe795404456341dfab10cef66ead4c041f62b8b11bbb92bffe5d0953e0"
+checksum = "942b4a808e05215192e39f4ab80813e599068285906cc91aa64f923db842bd5a"
 
 [[package]]
 name = "sp-application-crypto"
-version = "24.0.0"
+version = "25.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6b49d62089ef6fdd52a6f90f670d533ccb365235258cf517dbd5bd571febcfbd"
+checksum = "7fa730e4f3a2aec3f4ee777410599a86eb17067ee5410c58ab496e88d7bb840c"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
  "serde",
  "sp-core",
  "sp-io",
- "sp-std 9.0.0",
+ "sp-std",
 ]
 
 [[package]]
 name = "sp-arithmetic"
-version = "17.0.0"
+version = "18.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0241327405688cac3fcc29114fd35f99224e321daa37e19920e50e4b2fdd0645"
+checksum = "2d3d3ff6d6d717d7563659e9e47e958d33ebd2d0b3d8b1a9961cf9832944375e"
 dependencies = [
  "integer-sqrt",
  "num-traits",
  "parity-scale-codec",
  "scale-info",
  "serde",
- "sp-std 9.0.0",
+ "sp-std",
  "static_assertions",
 ]
 
 [[package]]
 name = "sp-core"
-version = "22.0.0"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0de478e02efd547693b33ad02515e09933d5b69b7f3036fa890b92e50fd9dfc"
+checksum = "412e2ec53b1bc63778e2d70c347224e6cd2e25c4bacb509585db85f0788747b7"
 dependencies = [
  "array-bytes",
+ "arrayvec 0.7.2",
  "bitflags",
  "blake2",
  "bounded-collections",
@@ -2204,7 +2237,7 @@ dependencies = [
  "sp-debug-derive",
  "sp-externalities",
  "sp-runtime-interface",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-storage",
  "ss58-registry",
  "substrate-bip39",
@@ -2216,49 +2249,48 @@ dependencies = [
 
 [[package]]
 name = "sp-core-hashing"
-version = "10.0.0"
+version = "11.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e360755a2706a76886d58776665cad0db793dece3c7d390455b28e8a1efd6285"
+checksum = "558116d02341b6f28b033c19a2a5fa555afa3c52628639170087e7685d51e743"
 dependencies = [
  "blake2b_simd",
  "byteorder",
  "digest 0.10.7",
- "sha2 0.10.6",
+ "sha2 0.10.7",
  "sha3",
  "twox-hash",
 ]
 
 [[package]]
 name = "sp-debug-derive"
-version = "9.0.0"
+version = "10.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f12dae7cf6c1e825d13ffd4ce16bd9309db7c539929d0302b4443ed451a9f4e5"
+checksum = "b4b235a0ad7124d58e6f0a728c8354da5b185b77bcf18b131b3a480cdaa23d95"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
 name = "sp-externalities"
-version = "0.20.0"
+version = "0.21.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3313e2c5f2523b06062e541dff9961bde88ad5a28861621dc7b7b47a32bb0f7c"
+checksum = "588cf40c36de918f545d712ad1a70631ae71653e4a321506dfcd8fa6fd26453c"
 dependencies = [
  "environmental",
  "parity-scale-codec",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-storage",
 ]
 
 [[package]]
 name = "sp-io"
-version = "24.0.0"
+version = "25.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff6194309bfe055d93177c6c9d2ed4c7b66040617cf3003a15e509c432cf3b62"
+checksum = "e9926dba7d67d87e40f49e18ff6cfc01373d5be13e3d373f02182bb5ec8ab37b"
 dependencies = [
  "bytes",
- "ed25519 1.5.3",
  "ed25519-dalek",
  "libsecp256k1",
  "log",
@@ -2270,7 +2302,7 @@ dependencies = [
  "sp-keystore",
  "sp-runtime-interface",
  "sp-state-machine",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-tracing",
  "sp-trie",
  "tracing",
@@ -2279,9 +2311,9 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.28.0"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6eda1d2572a15340927a9f7db75ffe74366b645eaf9212015b4a96ad8e9d4c46"
+checksum = "44f0f9546dd151881c60e75355806f1cbbc893f64aa465fc5bf87a47de59467b"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
@@ -2292,9 +2324,9 @@ dependencies = [
 
 [[package]]
 name = "sp-panic-handler"
-version = "9.0.0"
+version = "10.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "57c67eb0a0d11d3017ef43c975068ba76c7b0e83aca1ee3d68ba0ce270ecebe7"
+checksum = "261572cc0db4b41cf7587b4f7bdc15b8f83f748f17ae1c3c2f56a3e8e62ee913"
 dependencies = [
  "backtrace",
  "lazy_static",
@@ -2303,9 +2335,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "25.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d056e4cccf36a45be5d471b47c09e8be91b825f1d8352f20aa01f9f693176e7"
+checksum = "f645e9e2c82d052ea48ed987a8789daca1c03f9b5ed1aa49cd080092eda85330"
 dependencies = [
  "either",
  "hash256-std-hasher",
@@ -2320,15 +2352,15 @@ dependencies = [
  "sp-arithmetic",
  "sp-core",
  "sp-io",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-weights",
 ]
 
 [[package]]
 name = "sp-runtime-interface"
-version = "18.0.0"
+version = "19.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bf9781c72848efe6750116eb96edaeb105ee7e0bd7f38a4e46371bf810b3db7b"
+checksum = "6ef767d6e400ee54a420bcbc570030741420c2d938a6e379d21cab9875a339c5"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
@@ -2336,7 +2368,7 @@ dependencies = [
  "primitive-types",
  "sp-externalities",
  "sp-runtime-interface-proc-macro",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-storage",
  "sp-tracing",
  "sp-wasm-interface",
@@ -2345,22 +2377,22 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7402572a08aa1ae421ea5bab10918764b0ae72301b27710913e5d804862f2448"
+checksum = "fdd795a4a2205b64d95da897f85b7c83a0044f30df22b0ea282f8387dc6ca428"
 dependencies = [
  "Inflector",
  "proc-macro-crate 1.3.1",
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
 name = "sp-state-machine"
-version = "0.29.0"
+version = "0.30.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f2e84d8ed3acc6aed5a3d5cfd500fb5b99c1e299c86086b2fe82c3e4be93178f"
+checksum = "771dce7d78335718ab8475984b6dbc1f374777049ed1c308186679e611333be2"
 dependencies = [
  "hash-db",
  "log",
@@ -2371,7 +2403,7 @@ dependencies = [
  "sp-core",
  "sp-externalities",
  "sp-panic-handler",
- "sp-std 9.0.0",
+ "sp-std",
  "sp-trie",
  "thiserror",
  "tracing",
@@ -2380,38 +2412,32 @@ dependencies = [
 
 [[package]]
 name = "sp-std"
-version = "7.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1de8eef39962b5b97478719c493bed2926cf70cb621005bbf68ebe58252ff986"
-
-[[package]]
-name = "sp-std"
-version = "9.0.0"
+version = "10.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2d5bbc9339227d1b6a9b7ccd9b2920c818653d40eef1512f1e2e824d72e7a336"
+checksum = "3ed09ef1760e8be9b64b7f739f1cf9a94528130be475d8e4f2d1be1e690c9f9c"
 
 [[package]]
 name = "sp-storage"
-version = "14.0.0"
+version = "15.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a21245c3a7799ff6d3f1f159b496f9ac72eb32cd6fe68c6f73013155289aa9f1"
+checksum = "c20f503280c004d94033a32cb84274ede30ef0b4b634770b1e7d595f8245bda4"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
  "ref-cast",
  "serde",
  "sp-debug-derive",
- "sp-std 9.0.0",
+ "sp-std",
 ]
 
 [[package]]
 name = "sp-tracing"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6f5ba26db1f7513d5975970d1ba1f0580d7a1b8da8c86ea3f9f0f8dbe2cfa96e"
+checksum = "ebabec43485ebdb2fdb5c6f9b388590d4797a3888024d74724ada2f16b2113b8"
 dependencies = [
  "parity-scale-codec",
- "sp-std 9.0.0",
+ "sp-std",
  "tracing",
  "tracing-core",
  "tracing-subscriber",
@@ -2419,9 +2445,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "23.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bf63ea90ffb5d61048d8fb2fac669114dac198fc2739e913e615f0fd2c36c3e7"
+checksum = "e78585a84d02d1c71e8eb8c00ed586c22a46ad4e773d9ff65c8ed3b8e98b9f51"
 dependencies = [
  "ahash 0.8.3",
  "hash-db",
@@ -2434,7 +2460,7 @@ dependencies = [
  "scale-info",
  "schnellru",
  "sp-core",
- "sp-std 9.0.0",
+ "sp-std",
  "thiserror",
  "tracing",
  "trie-db",
@@ -2443,23 +2469,23 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "15.0.0"
+version = "16.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d07945f592d2792632e6f030108769757e928a0fd78cf8659c9c210a5e341e55"
+checksum = "ee009ac79098027f5990984e0c5ee2fd4883b16bbd6ab97931f28c2148aaa3ea"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
  "log",
  "parity-scale-codec",
- "sp-std 9.0.0",
+ "sp-std",
  "wasmtime",
 ]
 
 [[package]]
 name = "sp-weights"
-version = "21.0.0"
+version = "22.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b7699b853471c2eb5dc06ea1d8ea847bfa1415371218ebb4c86325c9d0232bc"
+checksum = "86566cae93412e40bea0db9e6b110a7379105412a9aed1af73b5d2fb69cb7000"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2468,7 +2494,7 @@ dependencies = [
  "sp-arithmetic",
  "sp-core",
  "sp-debug-derive",
- "sp-std 9.0.0",
+ "sp-std",
 ]
 
 [[package]]
@@ -2561,9 +2587,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.27"
+version = "2.0.32"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b60f673f44a8255b9c8c657daf66a596d435f2da81a555b06dc644d080ba45e0"
+checksum = "239814284fd6f1a4ffe4ca893952cdd93c224b6a1571c9a9eadd670295c0c9e2"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2590,7 +2616,7 @@ checksum = "f6d550db02d6bec4ebcbbebc4301ec22181bc489c37fb3f167e64b14c1be8321"
 dependencies = [
  "bytes",
  "digest 0.10.7",
- "ed25519 2.2.1",
+ "ed25519",
  "ed25519-consensus",
  "flex-error",
  "futures",
@@ -2602,8 +2628,8 @@ dependencies = [
  "serde_bytes",
  "serde_json",
  "serde_repr",
- "sha2 0.10.6",
- "signature 2.1.0",
+ "sha2 0.10.7",
+ "signature",
  "subtle",
  "subtle-encoding",
  "tendermint-proto",
@@ -2644,22 +2670,22 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.40"
+version = "1.0.48"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "978c9a314bd8dc99be594bc3c175faaa9794be04a5a5e153caba6915336cebac"
+checksum = "9d6d7a740b8a666a7e828dd00da9c0dc290dff53154ea77ac109281de90589b7"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.40"
+version = "1.0.48"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9456a42c5b0d803c8cd86e73dd7cc9edd429499f37a3550d286d5e86720569f"
+checksum = "49922ecae66cc8a249b77e68d1d0623c1b2c514f0060c27cdc68bd62a1219d35"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -2709,7 +2735,7 @@ dependencies = [
  "pbkdf2 0.11.0",
  "rand 0.8.5",
  "rustc-hash",
- "sha2 0.10.6",
+ "sha2 0.10.7",
  "thiserror",
  "unicode-normalization",
  "wasm-bindgen",
@@ -2777,7 +2803,7 @@ checksum = "0f57e3ca2a01450b1a921183a9c9cbfda207fd822cef4ccb00a65402cbba7a74"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
 
 [[package]]
@@ -2968,7 +2994,7 @@ dependencies = [
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
  "wasm-bindgen-shared",
 ]
 
@@ -2990,7 +3016,7 @@ checksum = "e128beba882dd1eb6200e1dc92ae6c5dbaa4311aa7bb211ca035779e5efc39f8"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
@@ -3341,5 +3367,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.27",
+ "syn 2.0.32",
 ]
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 691df2bae..7ead62982 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,19 +6,19 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../crates/ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.34.0", default-features = false, features = [
+ibc-proto = { version = "0.35.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
 ] }
-tendermint = { version = "0.33.0", default-features = false }
-tendermint-proto = { version = "0.33.0", default-features = false }
-tendermint-light-client-verifier = { version = "0.33.0", default-features = false, features = ["rust-crypto"] }
+tendermint = { version = "0.33", default-features = false }
+tendermint-proto = { version = "0.33", default-features = false }
+tendermint-light-client-verifier = { version = "0.33", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "22.0.0", default-features = false, optional = true }
-sp-io = { version = "24.0.0", default-features = false, optional = true }
-sp-runtime = { version = "25.0.0", default-features = false, optional = true }
-sp-std = { version = "7.0.0", default-features = false, optional = true }
+sp-core = { version = "23.0.0", default-features = false, optional = true }
+sp-io = { version = "25.0.0", default-features = false, optional = true }
+sp-runtime = { version = "26.0.0", default-features = false, optional = true }
+sp-std = { version = "10.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 34225861b..fa09d5a0a 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -52,9 +52,9 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.34.1", default-features = false, features = ["serde"] }
+ibc-proto = { version = "0.35.0", default-features = false, features = ["serde"] }
 ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.26", default-features = false }
+time = { version = ">=0.3.0, <0.3.29", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json = { version = "1", default-features = false, optional = true }

From c83f26aeb87004ca464917e250da62ba3e92238b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Wed, 20 Sep 2023 16:41:13 -0400
Subject: [PATCH 032/182] Release v0.45.0 (#874)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* unclog release

* bump version

* Update CHANGELOG.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Philippe Laferrière <plafer@protonmail.com>

---------

Signed-off-by: Philippe Laferrière <plafer@protonmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../785-bump-tendermint-to-v0.33.0.md         |  0
 .../790-bump-ibc-proto-rs-to-v0.34.0.md       |  0
 ...-use-result-for-safe-counters-increment.md |  0
 ...-result-in-logger-event-emitter-methods.md |  0
 .../breaking-changes/873-bump-ibc-proto-rs.md |  0
 .../bug-fixes/741-restore-no-std-support.md   |  0
 .../bug-fixes/863-immut-ref-in-validate.md    |  0
 .../features/842-impl-grpc-services.md        |  0
 ...ent-for-upgrade-client-proposal-handler.md |  0
 .../improvements/844-bump-borsh.md            |  0
 .../845-borsh-derive-msgtransfer.md           |  0
 .../846-borsh-derive-msgenvelope.md           |  0
 .../improvements/847-derive-msgenvelope-eq.md |  0
 .../improvements/848-configure-cargo-fmt.md   |  0
 .../856-jsonschema-derive-msgenvelope.md      |  0
 .../improvements/869-codebase-cleanup.md      |  0
 .changelog/v0.45.0/summary.md                 |  1 +
 CHANGELOG.md                                  | 52 +++++++++++++++++++
 crates/ibc/Cargo.toml                         |  2 +-
 19 files changed, 54 insertions(+), 1 deletion(-)
 rename .changelog/{unreleased => v0.45.0}/breaking-changes/785-bump-tendermint-to-v0.33.0.md (100%)
 rename .changelog/{unreleased => v0.45.0}/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md (100%)
 rename .changelog/{unreleased => v0.45.0}/breaking-changes/857-use-result-for-safe-counters-increment.md (100%)
 rename .changelog/{unreleased => v0.45.0}/breaking-changes/859-return-result-in-logger-event-emitter-methods.md (100%)
 rename .changelog/{unreleased => v0.45.0}/breaking-changes/873-bump-ibc-proto-rs.md (100%)
 rename .changelog/{unreleased => v0.45.0}/bug-fixes/741-restore-no-std-support.md (100%)
 rename .changelog/{unreleased => v0.45.0}/bug-fixes/863-immut-ref-in-validate.md (100%)
 rename .changelog/{unreleased => v0.45.0}/features/842-impl-grpc-services.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/844-bump-borsh.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/845-borsh-derive-msgtransfer.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/846-borsh-derive-msgenvelope.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/847-derive-msgenvelope-eq.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/848-configure-cargo-fmt.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/856-jsonschema-derive-msgenvelope.md (100%)
 rename .changelog/{unreleased => v0.45.0}/improvements/869-codebase-cleanup.md (100%)
 create mode 100644 .changelog/v0.45.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md b/.changelog/v0.45.0/breaking-changes/785-bump-tendermint-to-v0.33.0.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/785-bump-tendermint-to-v0.33.0.md
rename to .changelog/v0.45.0/breaking-changes/785-bump-tendermint-to-v0.33.0.md
diff --git a/.changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md b/.changelog/v0.45.0/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
rename to .changelog/v0.45.0/breaking-changes/790-bump-ibc-proto-rs-to-v0.34.0.md
diff --git a/.changelog/unreleased/breaking-changes/857-use-result-for-safe-counters-increment.md b/.changelog/v0.45.0/breaking-changes/857-use-result-for-safe-counters-increment.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/857-use-result-for-safe-counters-increment.md
rename to .changelog/v0.45.0/breaking-changes/857-use-result-for-safe-counters-increment.md
diff --git a/.changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md b/.changelog/v0.45.0/breaking-changes/859-return-result-in-logger-event-emitter-methods.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/859-return-result-in-logger-event-emitter-methods.md
rename to .changelog/v0.45.0/breaking-changes/859-return-result-in-logger-event-emitter-methods.md
diff --git a/.changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md b/.changelog/v0.45.0/breaking-changes/873-bump-ibc-proto-rs.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/873-bump-ibc-proto-rs.md
rename to .changelog/v0.45.0/breaking-changes/873-bump-ibc-proto-rs.md
diff --git a/.changelog/unreleased/bug-fixes/741-restore-no-std-support.md b/.changelog/v0.45.0/bug-fixes/741-restore-no-std-support.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/741-restore-no-std-support.md
rename to .changelog/v0.45.0/bug-fixes/741-restore-no-std-support.md
diff --git a/.changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md b/.changelog/v0.45.0/bug-fixes/863-immut-ref-in-validate.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/863-immut-ref-in-validate.md
rename to .changelog/v0.45.0/bug-fixes/863-immut-ref-in-validate.md
diff --git a/.changelog/unreleased/features/842-impl-grpc-services.md b/.changelog/v0.45.0/features/842-impl-grpc-services.md
similarity index 100%
rename from .changelog/unreleased/features/842-impl-grpc-services.md
rename to .changelog/v0.45.0/features/842-impl-grpc-services.md
diff --git a/.changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md b/.changelog/v0.45.0/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md
similarity index 100%
rename from .changelog/unreleased/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md
rename to .changelog/v0.45.0/improvements/838-switch-to-tm-event-for-upgrade-client-proposal-handler.md
diff --git a/.changelog/unreleased/improvements/844-bump-borsh.md b/.changelog/v0.45.0/improvements/844-bump-borsh.md
similarity index 100%
rename from .changelog/unreleased/improvements/844-bump-borsh.md
rename to .changelog/v0.45.0/improvements/844-bump-borsh.md
diff --git a/.changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md b/.changelog/v0.45.0/improvements/845-borsh-derive-msgtransfer.md
similarity index 100%
rename from .changelog/unreleased/improvements/845-borsh-derive-msgtransfer.md
rename to .changelog/v0.45.0/improvements/845-borsh-derive-msgtransfer.md
diff --git a/.changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md b/.changelog/v0.45.0/improvements/846-borsh-derive-msgenvelope.md
similarity index 100%
rename from .changelog/unreleased/improvements/846-borsh-derive-msgenvelope.md
rename to .changelog/v0.45.0/improvements/846-borsh-derive-msgenvelope.md
diff --git a/.changelog/unreleased/improvements/847-derive-msgenvelope-eq.md b/.changelog/v0.45.0/improvements/847-derive-msgenvelope-eq.md
similarity index 100%
rename from .changelog/unreleased/improvements/847-derive-msgenvelope-eq.md
rename to .changelog/v0.45.0/improvements/847-derive-msgenvelope-eq.md
diff --git a/.changelog/unreleased/improvements/848-configure-cargo-fmt.md b/.changelog/v0.45.0/improvements/848-configure-cargo-fmt.md
similarity index 100%
rename from .changelog/unreleased/improvements/848-configure-cargo-fmt.md
rename to .changelog/v0.45.0/improvements/848-configure-cargo-fmt.md
diff --git a/.changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md b/.changelog/v0.45.0/improvements/856-jsonschema-derive-msgenvelope.md
similarity index 100%
rename from .changelog/unreleased/improvements/856-jsonschema-derive-msgenvelope.md
rename to .changelog/v0.45.0/improvements/856-jsonschema-derive-msgenvelope.md
diff --git a/.changelog/unreleased/improvements/869-codebase-cleanup.md b/.changelog/v0.45.0/improvements/869-codebase-cleanup.md
similarity index 100%
rename from .changelog/unreleased/improvements/869-codebase-cleanup.md
rename to .changelog/v0.45.0/improvements/869-codebase-cleanup.md
diff --git a/.changelog/v0.45.0/summary.md b/.changelog/v0.45.0/summary.md
new file mode 100644
index 000000000..43ecf0d8e
--- /dev/null
+++ b/.changelog/v0.45.0/summary.md
@@ -0,0 +1 @@
+This release introduces a new API under the `grpc` feature flag, which has ibc-rs expose grpc endpoints that the hermes relayer needs. There are other miscellaneous changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5be073407..c7cb79a89 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,57 @@
 # CHANGELOG
 
+# v0.45.0
+
+*September 20, 2023*
+
+This release introduces a new API under the `grpc` feature flag, which has ibc-rs expose grpc endpoints that the hermes relayer needs. Furthermore, `no_std` support for the `serde` feature has been restored, accompanied by other miscellaneous changes.
+There are no consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- Bump tendermint-rs to v0.33.0 
+  ([#785](https://github.com/cosmos/ibc-rs/issues/785))
+- Bump ibc-proto-rs to v0.34.0 
+  ([#790](https://github.com/cosmos/ibc-rs/issues/790))
+- Allow hosts to handle overflow cases in `increase_*_counter` methods by
+  returning `Result<(),ContextError>` type.
+  ([#857](https://github.com/cosmos/ibc-rs/issues/857))
+- logger and event emitter methods return `Result<(), ContextError>` type.
+  ([#859](https://github.com/cosmos/ibc-rs/issues/859))
+- Bump `ibc-proto-rs` to v0.35.0 along with some other minor dependency updates
+  ([#873](https://github.com/cosmos/ibc-rs/issues/873))
+
+### BUG FIXES
+
+- Fix compilation error of v0.41.0 by restoring no_std support for serde
+  feature ([#741](https://github.com/cosmos/ibc-rs/issues/741))
+- Replace mutable ref with immutable ref in validate handler
+  ([\#863](https://github.com/cosmos/ibc-rs/issues/863))
+
+### FEATURES
+
+- Blanket implementation of core gRPC services
+  ([\#686](https://github.com/cosmos/ibc-rs/issues/686))
+
+### IMPROVEMENTS
+
+- Switch to domain Tendermint event type instead of proto for the
+  `upgrade_client_proposal_handler` return
+  ([#838](https://github.com/cosmos/ibc-rs/issues/838))
+- Bump ibc-proto to v0.34.1 and borsh to v0.10
+  ([#844](https://github.com/cosmos/ibc-rs/issues/844))
+- Add borsh derive for `MsgTransfer`
+  ([#845](https://github.com/cosmos/ibc-rs/pull/845))
+- Add borsh derive for `MsgEnvelope`
+  ([#846](https://github.com/cosmos/ibc-rs/pull/846))
+- Derive `PartialEq`, `Eq` for `MsgEnvelope`
+  ([#847](https://github.com/cosmos/ibc-rs/pull/847))
+- Organize imports grouping and granularity using `rustfmt.toml`
+  ([#848](https://github.com/cosmos/ibc-rs/issues/848))
+- Add `JsonSchema` derive for `MsgEnvelope`
+  ([#856](https://github.com/cosmos/ibc-rs/pull/856))
+- Remove unused code snippets and move serializer roundtrip test to `serializers.rs`
+  ([#869](https://github.com/cosmos/ibc-rs/issues/869))
 
 # v0.44.1
 
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index fa09d5a0a..df42265db 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.44.1"
+version      = "0.45.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"

From 45b297fd4b116596068373208ee651e69ef79438 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 27 Sep 2023 21:07:56 +0200
Subject: [PATCH 033/182] Remove regex requirement (#876)

* regex dep over safe-regex

* new error variant

* refactor regex use

* coin parser wo regex

* rm regex dep

* fix incorrect conditions

* add Coin::new

* rm blackslash from valid charset

* rewrite coin tests using rstest

* fix broken test for denom with backslash

* add name to testcases and add new tests

* expect test panic message

* addd tests with plus sign

* update regex comment

* simplify impl logic

* implicit from_str

* slash delim test

* add changelog entry

* version bump for ref link

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* refactor denom parsing

* refactor tests without Coin::new

* rm Coin::new

* nit

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../improvements/875-remove-regex-dep.md      |   2 +
 crates/ibc/Cargo.toml                         |   1 -
 crates/ibc/src/applications/transfer/coin.rs  | 154 +++++++++++-------
 3 files changed, 95 insertions(+), 62 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/875-remove-regex-dep.md

diff --git a/.changelog/unreleased/improvements/875-remove-regex-dep.md b/.changelog/unreleased/improvements/875-remove-regex-dep.md
new file mode 100644
index 000000000..4bb26a232
--- /dev/null
+++ b/.changelog/unreleased/improvements/875-remove-regex-dep.md
@@ -0,0 +1,2 @@
+- Remove `safe-regex` dependency
+  ([\#875](https://github.com/cosmos/ibc-rs/issues/875))
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index df42265db..8e747ab98 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -61,7 +61,6 @@ serde_json = { version = "1", default-features = false, optional = true }
 tracing = { version = "0.1.36", default-features = false }
 prost = { version = "0.11", default-features = false }
 bytes = { version = "1.2.1", default-features = false }
-safe-regex = { version = "0.2.5", default-features = false }
 subtle-encoding = { version = "0.5", default-features = false }
 sha2 = { version = "0.10.6", default-features = false }
 displaydoc = { version = "0.2", default-features = false }
diff --git a/crates/ibc/src/applications/transfer/coin.rs b/crates/ibc/src/applications/transfer/coin.rs
index 406e01b43..be7a41172 100644
--- a/crates/ibc/src/applications/transfer/coin.rs
+++ b/crates/ibc/src/applications/transfer/coin.rs
@@ -1,10 +1,9 @@
 //! Defines coin types; the objects that are being transferred.
 
 use core::fmt::{Display, Error as FmtError, Formatter};
-use core::str::{from_utf8, FromStr};
+use core::str::FromStr;
 
 use ibc_proto::cosmos::base::v1beta1::Coin as ProtoCoin;
-use safe_regex::regex;
 
 use super::amount::Amount;
 use super::denom::{BaseDenom, PrefixedDenom};
@@ -19,6 +18,9 @@ pub type BaseCoin = Coin<BaseDenom>;
 
 pub type RawCoin = Coin<String>;
 
+/// Allowed characters in string representation of a denomination.
+const VALID_DENOM_CHARACTERS: &str = "/:._-";
+
 /// Coin defines a token with a denomination and an amount.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
@@ -58,25 +60,31 @@ where
         // Denominations can be 3 ~ 128 characters long and support letters, followed by either
         // a letter, a number or a separator ('/', ':', '.', '_' or '-').
         // Loosely copy the regex from here:
-        // https://github.com/cosmos/cosmos-sdk/blob/v0.45.5/types/coin.go#L760-L762
-        let matcher = regex!(br"([0-9]+)([a-zA-Z0-9/:\\._\x2d]+)");
-
-        let (m1, m2) = matcher.match_slices(coin_str.as_bytes()).ok_or_else(|| {
-            TokenTransferError::InvalidCoin {
+        // https://github.com/cosmos/cosmos-sdk/blob/v0.47.5/types/coin.go#L838-L840
+        //
+        // equivalent regex code in rust:
+        // let re = Regex::new(r"^(?<amount>[0-9]+)(?<denom>[a-zA-Z0-9/:._-]+)$")?;
+        // let cap = re.captures("123stake")?;
+        // let (amount, denom) = (cap.name("amount")?.as_str(), cap.name("denom")?.as_str());
+
+        let (amount, denom) = coin_str
+            .chars()
+            .position(|x| !x.is_numeric())
+            .map(|index| coin_str.split_at(index))
+            .filter(|(amount, _)| !amount.is_empty())
+            .filter(|(_, denom)| {
+                denom
+                    .chars()
+                    .all(|x| x.is_alphanumeric() || VALID_DENOM_CHARACTERS.contains(x))
+            })
+            .ok_or_else(|| TokenTransferError::InvalidCoin {
                 coin: coin_str.to_string(),
-            }
-        })?;
+            })?;
 
-        let amount = from_utf8(m1)
-            .map_err(TokenTransferError::Utf8Decode)?
-            .parse()?;
-
-        let denom = from_utf8(m2)
-            .map_err(TokenTransferError::Utf8Decode)?
-            .parse()
-            .map_err(Into::into)?;
-
-        Ok(Coin { amount, denom })
+        Ok(Coin {
+            amount: amount.parse()?,
+            denom: denom.parse().map_err(Into::into)?,
+        })
     }
 }
 
@@ -119,53 +127,77 @@ impl<D: Display> Display for Coin<D> {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
+    use primitive_types::U256;
+    use rstest::rstest;
 
-    #[test]
-    fn test_parse_raw_coin() -> Result<(), TokenTransferError> {
-        {
-            let coin = RawCoin::from_str("123stake")?;
-            assert_eq!(coin.denom, "stake");
-            assert_eq!(coin.amount, 123u64.into());
-        }
-
-        {
-            let coin = RawCoin::from_str("1a1")?;
-            assert_eq!(coin.denom, "a1");
-            assert_eq!(coin.amount, 1u64.into());
-        }
-
-        {
-            let coin = RawCoin::from_str("0x1/:.\\_-")?;
-            assert_eq!(coin.denom, "x1/:.\\_-");
-            assert_eq!(coin.amount, 0u64.into());
-        }
+    use super::*;
 
-        {
-            // `!` is not allowed
-            let res = RawCoin::from_str("0x!");
-            assert!(res.is_err());
-        }
+    #[rstest]
+    #[case::nat("123stake", 123, "stake")]
+    #[case::zero("0stake", 0, "stake")]
+    #[case::u256_max(
+        "115792089237316195423570985008687907853269984665640564039457584007913129639935stake",
+        U256::MAX,
+        "stake"
+    )]
+    #[case::digit_in_denom("1a1", 1, "a1")]
+    #[case::chars_in_denom("0x1/:._-", 0, "x1/:._-")]
+    #[case::ibc_denom("1234ibc/a0B1C", 1234, "ibc/a0B1C")]
+    fn test_parse_raw_coin(
+        #[case] parsed: RawCoin,
+        #[case] amount: impl Into<Amount>,
+        #[case] denom: &str,
+    ) {
+        assert_eq!(
+            parsed,
+            RawCoin {
+                denom: denom.into(),
+                amount: amount.into()
+            }
+        );
+    }
 
+    #[rstest]
+    #[case::pos("+123stake")]
+    #[case::pos_zero("+0stake")]
+    #[case::neg("-123stake")]
+    #[case::neg_zero("-0stake")]
+    #[case::u256_max_plus_1(
+        "115792089237316195423570985008687907853269984665640564039457584007913129639936stake"
+    )]
+    #[case::invalid_char_in_denom("0x!")]
+    #[case::blackslash_in_denom("0x1/:.\\_-")]
+    #[should_panic]
+    fn test_failed_parse_raw_coin(#[case] _raw: RawCoin) {}
+
+    #[rstest]
+    #[case::nomal("123stake,1a1,999den0m", &[(123, "stake"), (1, "a1"), (999, "den0m")])]
+    #[case::tricky("123stake,1a1-999den0m", &[(123, "stake"), (1, "a1-999den0m")])]
+    #[case::colon_delimiter("123stake:1a1:999den0m", &[(123, "stake:1a1:999den0m")])]
+    #[case::dash_delimiter("123stake-1a1-999den0m", &[(123, "stake-1a1-999den0m")])]
+    #[case::slash_delimiter("123stake/1a1/999den0m", &[(123, "stake/1a1/999den0m")])]
+    fn test_parse_raw_coin_list(
+        #[case] coins_str: &str,
+        #[case] coins: &[(u64, &str)],
+    ) -> Result<(), TokenTransferError> {
+        assert_eq!(
+            RawCoin::from_string_list(coins_str)?,
+            coins
+                .iter()
+                .map(|&(amount, denom)| RawCoin {
+                    denom: denom.to_string(),
+                    amount: amount.into(),
+                })
+                .collect::<Vec<_>>()
+        );
         Ok(())
     }
 
-    #[test]
-    fn test_parse_raw_coin_list() -> Result<(), TokenTransferError> {
-        {
-            let coins = RawCoin::from_string_list("123stake,1a1,999den0m")?;
-            assert_eq!(coins.len(), 3);
-
-            assert_eq!(coins[0].denom, "stake");
-            assert_eq!(coins[0].amount, 123u64.into());
-
-            assert_eq!(coins[1].denom, "a1");
-            assert_eq!(coins[1].amount, 1u64.into());
-
-            assert_eq!(coins[2].denom, "den0m");
-            assert_eq!(coins[2].amount, 999u64.into());
-        }
-
-        Ok(())
+    #[rstest]
+    #[case::semicolon_delimiter("123stake;1a1;999den0m")]
+    #[case::mixed_delimiter("123stake,1a1;999den0m")]
+    #[should_panic(expected = "parsing failure in test")]
+    fn test_failed_parse_raw_coin_list(#[case] coins_str: &str) {
+        RawCoin::from_string_list(coins_str).expect("parsing failure in test");
     }
 }

From e8757aa05210ebfaf07af0ee27a8a71ddbc61cec Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 2 Oct 2023 07:49:36 -0700
Subject: [PATCH 034/182] imp: update ibc-rs repo cover + small README
 adjustments (#885)

---
 .markdownlint.jsonc              |  6 +++++
 README.md                        | 28 +++++++++++++++++----
 docs/static/img/ibc-rs-cover.svg | 42 ++++++++++++++++++++++++++++++++
 3 files changed, 71 insertions(+), 5 deletions(-)
 create mode 100644 .markdownlint.jsonc
 create mode 100644 docs/static/img/ibc-rs-cover.svg

diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc
new file mode 100644
index 000000000..ef04eef87
--- /dev/null
+++ b/.markdownlint.jsonc
@@ -0,0 +1,6 @@
+{
+  "default": true,
+  "MD013": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md013---line-length
+  "MD033": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md033---inline-html
+  "MD041": false // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md041---first-line-in-a-file-should-be-a-top-level-heading
+}
diff --git a/README.md b/README.md
index 63aa65592..9b4ed00a8 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,32 @@
-# ibc-rs
+<div align="center">
+    <h1>ibc-rs</h1>
+</div>
+
+![banner](docs/static/img/ibc-rs-cover.svg)
+
+<div align="center">
+<div>
 
 [![Cosmos ecosystem][cosmos-shield]][cosmos-link]
 
+</div>
+<div>
+
 [![Docs][docs-image]][docs-link]
 [![Build Status][build-image]][build-link]
 [![Code Coverage][codecov-image]][codecov-link]
 [![Apache 2.0 Licensed][license-image]][license-link]
 ![Rust Stable][rustc-image]
 ![Rust 1.60+][rustc-version]
+![Lines of Code][loc-image]
+
+</div>
+</div>
 
 Rust implementation of the Inter-Blockchain Communication (IBC) protocol. This project hosts
 the `ibc` rust crate which defines the main data structures and on-chain logic for the IBC protocol.
 
-See the [ibc](crates/ibc) crate's README.md for more detailed information on the `ibc` crate.
+See the [ibc](crates/ibc/README.md) crate's README.md for more detailed information on the `ibc` crate.
 
 ## Contributing
 
@@ -26,9 +40,13 @@ See also [CONTRIBUTING.md](./CONTRIBUTING.md).
 
 ## Community calls
 
-We run monthly community calls to update the community with current our direction and gather feedback on what to work on next. The community calls are also a platform for you to update everyone else with what you're working on, and find opportunities to collaborate.
+We run monthly community calls to update the community with current our
+direction and gather feedback on what to work on next. The community calls are
+also a platform for you to update everyone else with what you're working on, and
+find opportunities to collaborate.
 
-Please join the [Google group](https://groups.google.com/g/ibc-rs-community) to receive a calendar invitation for the monthly meeting.
+Please join the [Google group](https://groups.google.com/g/ibc-rs-community) to
+receive a calendar invitation for the monthly meeting.
 
 ## Versioning
 
@@ -60,13 +78,13 @@ CONDITIONS OF ANY KIND, either express or implied. See the License for the speci
 [build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
 [codecov-image]: https://codecov.io/gh/cosmos/ibc-rs/branch/main/graph/badge.svg?token=wUm2aLCOu
 [codecov-link]: https://codecov.io/gh/cosmos/ibc-rs
+[loc-image]: https://tokei.rs/b1/github/cosmos/ibc-rs
 [license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
 [license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
 [rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
 [rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
 
 [//]: # (general links)
-[ibc-rs]: https://github.com/cosmos/ibc-rs
 [ibc]: https://github.com/cosmos/ibc
 [ibc-go]: https://github.com/cosmos/ibc-go
 [ibc-homepage]: https://cosmos.network/ibc
diff --git a/docs/static/img/ibc-rs-cover.svg b/docs/static/img/ibc-rs-cover.svg
new file mode 100644
index 000000000..77b555cfe
--- /dev/null
+++ b/docs/static/img/ibc-rs-cover.svg
@@ -0,0 +1,42 @@
+<svg width="1284" height="644" viewBox="0 0 1284 644" fill="none" xmlns="http://www.w3.org/2000/svg">
+<mask id="mask0_1401_1739" style="mask-type:luminance" maskUnits="userSpaceOnUse" x="2" y="2" width="1280" height="640">
+<path d="M1282 2H2V642H1282V2Z" fill="white"/>
+</mask>
+<g mask="url(#mask0_1401_1739)">
+<mask id="mask1_1401_1739" style="mask-type:luminance" maskUnits="userSpaceOnUse" x="-33" y="2" width="1724" height="985">
+<path d="M1691 2H-33V987H1691V2Z" fill="white"/>
+</mask>
+<g mask="url(#mask1_1401_1739)">
+<path d="M145.243 420.524C229.585 420.524 297.958 351.076 297.958 265.408C297.958 179.739 229.585 110.291 145.243 110.291C60.9007 110.291 -7.47217 179.739 -7.47217 265.408C-7.47217 351.076 60.9007 420.524 145.243 420.524Z" fill="#2C8A5D" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1021.73 588.965C1106.07 588.965 1174.44 519.517 1174.44 433.849C1174.44 348.18 1106.07 278.732 1021.73 278.732C937.386 278.732 869.014 348.18 869.014 433.849C869.014 519.517 937.386 588.965 1021.73 588.965Z" fill="#2C8A5D" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1253.45 88.0107C1284.43 88.0107 1309.54 62.503 1309.54 31.0376C1309.54 -0.427803 1284.43 -25.9355 1253.45 -25.9355C1222.47 -25.9355 1197.36 -0.427803 1197.36 31.0376C1197.36 62.503 1222.47 88.0107 1253.45 88.0107Z" fill="#2C8A5D" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M191.284 637.14C363.896 670.312 530.301 555.072 562.959 379.746" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1067.53 31.315C1079.28 -31.7734 1038.45 -92.5935 976.34 -104.529" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1067.53 31.3152C1079.28 -31.7732 1139.16 -73.2399 1201.27 -61.304" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1200.81 -61.3848C1238.02 -54.2335 1262.48 -17.794 1255.44 20.0045" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M563.367 379.825C590.054 236.556 726.032 142.388 867.082 169.494" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M563.307 379.813C589.994 236.544 497.283 98.428 356.233 71.3223" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M356.22 71.3117C262.985 53.3947 201.704 -37.9011 219.344 -132.602" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M356.219 71.3197C262.985 53.4027 173.102 115.647 155.463 210.349" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M866.861 169.451C960.095 187.368 1021.38 278.664 1003.74 373.364" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M866.862 169.443C960.097 187.36 1049.98 125.115 1067.62 30.4141" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M1159.26 489.332C1283.32 529.208 1415.72 459.377 1454.98 333.361C1494.24 207.345 1425.49 72.8635 1301.42 32.9883" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M865.568 -109.047C713.86 -103.626 595.203 25.6866 600.541 179.781C605.878 333.875 733.189 454.398 884.896 448.977" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+<path d="M162.996 651.822C177.874 651.822 189.935 639.571 189.935 624.46C189.935 609.348 177.874 597.098 162.996 597.098C148.119 597.098 136.058 609.348 136.058 624.46C136.058 639.571 148.119 651.822 162.996 651.822Z" fill="#2C8A5D" stroke="#2C8A5D" stroke-width="2" stroke-miterlimit="10"/>
+</g>
+</g>
+<path d="M2 1H1V2V642V643H2H1282H1283V642V2V1H1282H2Z" fill="#CCD6C4" fill-opacity="0.9" stroke="black" stroke-width="2"/>
+<g clip-path="url(#clip0_1401_1739)">
+<path d="M1031.75 421.271H1016V538.867H1031.75V421.271Z" fill="black"/>
+<path d="M1090.38 495.968H1082.27C1065.52 495.968 1051.9 482.453 1051.9 465.838V421.234H1098.5C1115.25 421.234 1128.88 434.749 1128.88 451.365V463.029H1113.13V451.365C1113.13 443.367 1106.57 436.856 1098.5 436.856H1067.65V465.838C1067.65 473.835 1074.21 480.347 1082.27 480.347H1090.38V495.968ZM1130.45 508.635V494.6C1130.45 477.985 1116.83 464.47 1100.07 464.47H1090.38V480.091H1100.07C1108.14 480.091 1114.7 486.603 1114.7 494.6V508.635C1114.7 516.633 1108.14 523.144 1100.07 523.144H1067.65V496.99H1051.9V538.766H1100.07C1116.83 538.766 1130.45 525.251 1130.45 508.635Z" fill="black"/>
+<path d="M1184.09 540.999H1181.47C1161.13 540.999 1144.57 524.575 1144.57 504.394V455.596C1144.57 435.414 1161.13 418.99 1181.47 418.99H1184.09C1204.44 418.99 1221 435.414 1221 455.596H1205.25C1205.25 444.032 1195.76 434.621 1184.1 434.621H1181.48C1169.82 434.621 1160.33 444.032 1160.33 455.596V504.394C1160.33 515.957 1169.82 525.369 1181.48 525.369H1184.1C1195.76 525.369 1205.25 515.957 1205.25 504.394H1221C1221 524.575 1204.44 540.999 1184.09 540.999Z" fill="black"/>
+<path d="M1184.09 540.999H1181.47C1161.13 540.999 1144.57 524.575 1144.57 504.394V455.596C1144.57 435.414 1161.13 418.99 1181.47 418.99H1184.09C1204.44 418.99 1221 435.414 1221 455.596H1205.25C1205.25 444.032 1195.76 434.621 1184.1 434.621H1181.48C1169.82 434.621 1160.33 444.032 1160.33 455.596V504.394C1160.33 515.957 1169.82 525.369 1181.48 525.369H1184.1C1195.76 525.369 1205.25 515.957 1205.25 504.394H1221C1221 524.575 1204.44 540.999 1184.09 540.999Z" fill="black"/>
+</g>
+<path d="M45.568 371.368V366.728H80.032V371.368H65.76V413H60.736V371.368H45.568ZM86.6825 413V365.448H91.5145V384.776C92.0905 383.837 92.8585 382.963 93.8185 382.152C94.7998 381.341 95.9732 380.691 97.3385 380.2C98.7252 379.688 100.304 379.432 102.075 379.432C104.251 379.432 106.203 379.827 107.931 380.616C109.68 381.405 111.067 382.525 112.091 383.976C113.115 385.427 113.627 387.133 113.627 389.096V413H108.635V390.216C108.635 388.125 107.92 386.504 106.491 385.352C105.061 384.179 103.173 383.592 100.827 383.592C99.2265 383.592 97.7225 383.859 96.3145 384.392C94.9278 384.904 93.8078 385.683 92.9545 386.728C92.1012 387.752 91.6745 389.064 91.6745 390.664V413H86.6825ZM126.635 397.608C126.635 399.827 126.998 401.843 127.724 403.656C128.449 405.469 129.569 406.92 131.084 408.008C132.598 409.096 134.518 409.64 136.844 409.64C139.084 409.64 141.014 409.117 142.636 408.072C144.257 407.005 145.27 405.501 145.676 403.56H150.476C150.07 405.779 149.185 407.635 147.82 409.128C146.476 410.621 144.844 411.752 142.924 412.52C141.025 413.267 139.02 413.64 136.908 413.64C133.878 413.64 131.201 412.979 128.876 411.656C126.572 410.312 124.769 408.381 123.468 405.864C122.188 403.347 121.548 400.317 121.548 396.776C121.548 393.256 122.134 390.184 123.308 387.56C124.481 384.915 126.177 382.877 128.396 381.448C130.636 379.997 133.334 379.272 136.492 379.272C139.542 379.272 142.124 379.933 144.236 381.256C146.348 382.557 147.958 384.424 149.068 386.856C150.177 389.288 150.732 392.189 150.732 395.56V397.608H126.635ZM126.668 394.056H145.868C145.868 392.008 145.526 390.163 144.844 388.52C144.161 386.877 143.126 385.576 141.74 384.616C140.353 383.656 138.593 383.176 136.46 383.176C134.198 383.176 132.342 383.72 130.892 384.808C129.462 385.875 128.396 387.24 127.692 388.904C126.988 390.568 126.646 392.285 126.668 394.056ZM207.438 413H202.094L193.39 392.488H180.11V413H175.118V366.728H192.59C195.833 366.728 198.553 367.219 200.75 368.2C202.969 369.16 204.633 370.557 205.742 372.392C206.873 374.227 207.438 376.445 207.438 379.048C207.438 381.565 206.969 383.667 206.03 385.352C205.113 387.016 203.95 388.349 202.542 389.352C201.134 390.333 199.683 391.069 198.19 391.56L207.438 413ZM190.606 388.2C194.361 388.2 197.241 387.485 199.246 386.056C201.273 384.605 202.286 382.387 202.286 379.4C202.286 376.52 201.401 374.397 199.63 373.032C197.859 371.645 195.385 370.952 192.206 370.952H180.11V388.2H190.606ZM228.405 413.64C226.634 413.619 224.981 413.373 223.445 412.904C221.909 412.413 220.554 411.699 219.381 410.76C218.229 409.8 217.322 408.616 216.661 407.208C216.021 405.779 215.701 404.125 215.701 402.248V379.912H220.693V401.8C220.693 404.125 221.397 406.013 222.805 407.464C224.213 408.893 226.378 409.608 229.301 409.608C231.904 409.608 233.994 408.936 235.573 407.592C237.152 406.227 237.941 404.168 237.941 401.416V379.912H242.901V413H238.869L238.357 406.728C237.973 408.307 237.301 409.608 236.341 410.632C235.402 411.656 234.25 412.424 232.885 412.936C231.541 413.427 230.048 413.661 228.405 413.64ZM264.012 413.64C261.708 413.64 259.585 413.288 257.644 412.584C255.724 411.859 254.135 410.76 252.876 409.288C251.639 407.795 250.86 405.896 250.54 403.592H255.18C255.479 404.915 256.023 406.035 256.812 406.952C257.601 407.869 258.604 408.573 259.82 409.064C261.057 409.533 262.455 409.768 264.012 409.768C266.359 409.768 268.247 409.32 269.676 408.424C271.105 407.507 271.82 406.109 271.82 404.232C271.82 402.931 271.447 401.885 270.7 401.096C269.975 400.307 268.865 399.731 267.372 399.368L260.236 397.544C257.633 396.883 255.564 395.891 254.028 394.568C252.492 393.224 251.713 391.357 251.692 388.968C251.692 387.069 252.14 385.395 253.036 383.944C253.953 382.493 255.319 381.352 257.132 380.52C258.945 379.688 261.217 379.272 263.948 379.272C267.425 379.272 270.231 380.051 272.364 381.608C274.497 383.165 275.628 385.491 275.756 388.584H271.212C270.999 386.899 270.273 385.565 269.036 384.584C267.799 383.581 266.092 383.08 263.916 383.08C261.676 383.08 259.852 383.539 258.444 384.456C257.057 385.373 256.364 386.792 256.364 388.712C256.364 389.992 256.844 390.995 257.804 391.72C258.764 392.424 260.161 393.011 261.996 393.48L268.972 395.304C270.423 395.688 271.617 396.2 272.556 396.84C273.516 397.459 274.273 398.163 274.828 398.952C275.404 399.72 275.809 400.541 276.044 401.416C276.3 402.291 276.428 403.133 276.428 403.944C276.428 405.928 275.948 407.645 274.988 409.096C274.028 410.547 272.62 411.667 270.764 412.456C268.929 413.245 266.679 413.64 264.012 413.64ZM300.225 383.656H292.737V405C292.737 406.28 292.854 407.219 293.089 407.816C293.345 408.392 293.782 408.765 294.401 408.936C295.041 409.085 295.926 409.16 297.057 409.16H300.449V412.616C300.044 412.765 299.436 412.893 298.625 413C297.836 413.085 296.886 413.128 295.777 413.128C293.665 413.128 292.022 412.829 290.849 412.232C289.697 411.635 288.886 410.749 288.417 409.576C287.948 408.403 287.713 406.931 287.713 405.16V383.656H282.337V379.912H287.841L289.025 370.376H292.737V379.88H300.225V383.656ZM329.845 379.912V413H324.981V379.912H329.845ZM330.005 366.76V372.264H324.757V366.76H330.005ZM341.183 413V379.912H345.983V384.744C346.857 383.272 348.073 381.992 349.631 380.904C351.209 379.816 353.279 379.272 355.839 379.272C357.076 379.272 358.324 379.475 359.583 379.88C360.841 380.285 361.993 380.893 363.039 381.704C364.084 382.515 364.884 383.517 365.439 384.712C366.463 383.048 367.849 381.725 369.599 380.744C371.348 379.763 373.332 379.272 375.551 379.272C376.703 379.272 377.897 379.443 379.135 379.784C380.393 380.125 381.567 380.733 382.655 381.608C383.743 382.461 384.617 383.688 385.279 385.288C385.961 386.867 386.303 388.904 386.303 391.4V413H381.311V391.848C381.311 389.651 380.969 387.965 380.287 386.792C379.604 385.597 378.719 384.765 377.631 384.296C376.543 383.827 375.38 383.592 374.143 383.592C373.033 383.592 371.86 383.805 370.623 384.232C369.407 384.637 368.361 385.352 367.487 386.376C366.633 387.4 366.207 388.819 366.207 390.632V413H361.215V389.864C361.215 388.477 360.841 387.325 360.095 386.408C359.369 385.469 358.463 384.765 357.375 384.296C356.287 383.827 355.199 383.592 354.111 383.592C352.916 383.592 351.7 383.827 350.463 384.296C349.247 384.765 348.223 385.523 347.391 386.568C346.58 387.613 346.175 388.968 346.175 390.632V413H341.183ZM395.995 423.304V379.912H400.955L401.051 385.96C401.371 385.299 401.819 384.584 402.395 383.816C402.992 383.048 403.739 382.323 404.635 381.64C405.531 380.936 406.587 380.371 407.803 379.944C409.04 379.496 410.459 379.272 412.059 379.272C414.747 379.272 417.115 379.869 419.163 381.064C421.211 382.259 422.8 384.093 423.931 386.568C425.083 389.043 425.659 392.179 425.659 395.976C425.659 399.688 425.115 402.867 424.027 405.512C422.96 408.136 421.392 410.152 419.323 411.56C417.254 412.947 414.726 413.64 411.739 413.64C410.139 413.64 408.742 413.416 407.547 412.968C406.352 412.52 405.328 411.933 404.475 411.208C403.622 410.483 402.918 409.736 402.363 408.968C401.808 408.179 401.36 407.432 401.019 406.728V423.304H395.995ZM410.907 409.64C413.83 409.64 416.198 408.541 418.011 406.344C419.846 404.147 420.763 400.755 420.763 396.168C420.763 392.243 419.931 389.117 418.267 386.792C416.624 384.445 414.171 383.272 410.907 383.272C407.664 383.272 405.19 384.456 403.483 386.824C401.798 389.192 400.955 392.307 400.955 396.168C400.955 398.685 401.328 400.968 402.075 403.016C402.843 405.043 403.963 406.653 405.435 407.848C406.907 409.043 408.731 409.64 410.907 409.64ZM441.552 413.352C439.973 413.352 438.672 413.128 437.648 412.68C436.645 412.211 435.856 411.571 435.28 410.76C434.725 409.949 434.341 409.021 434.128 407.976C433.914 406.931 433.808 405.832 433.808 404.68V365.448H438.736V404.264C438.736 406.077 439.077 407.411 439.76 408.264C440.442 409.096 441.338 409.544 442.448 409.608L444.304 409.64V412.904C443.834 413.053 443.354 413.16 442.864 413.224C442.373 413.309 441.936 413.352 441.552 413.352ZM455.135 397.608C455.135 399.827 455.498 401.843 456.224 403.656C456.949 405.469 458.069 406.92 459.584 408.008C461.098 409.096 463.018 409.64 465.344 409.64C467.584 409.64 469.514 409.117 471.136 408.072C472.757 407.005 473.77 405.501 474.176 403.56H478.976C478.57 405.779 477.685 407.635 476.32 409.128C474.976 410.621 473.344 411.752 471.424 412.52C469.525 413.267 467.52 413.64 465.408 413.64C462.378 413.64 459.701 412.979 457.376 411.656C455.072 410.312 453.269 408.381 451.968 405.864C450.688 403.347 450.048 400.317 450.048 396.776C450.048 393.256 450.634 390.184 451.808 387.56C452.981 384.915 454.677 382.877 456.896 381.448C459.136 379.997 461.834 379.272 464.992 379.272C468.042 379.272 470.624 379.933 472.736 381.256C474.848 382.557 476.458 384.424 477.568 386.856C478.677 389.288 479.232 392.189 479.232 395.56V397.608H455.135ZM455.168 394.056H474.368C474.368 392.008 474.026 390.163 473.344 388.52C472.661 386.877 471.626 385.576 470.24 384.616C468.853 383.656 467.093 383.176 464.96 383.176C462.698 383.176 460.842 383.72 459.392 384.808C457.962 385.875 456.896 387.24 456.192 388.904C455.488 390.568 455.146 392.285 455.168 394.056ZM487.745 413V379.912H492.545V384.744C493.42 383.272 494.636 381.992 496.193 380.904C497.772 379.816 499.841 379.272 502.401 379.272C503.638 379.272 504.886 379.475 506.145 379.88C507.404 380.285 508.556 380.893 509.601 381.704C510.646 382.515 511.446 383.517 512.001 384.712C513.025 383.048 514.412 381.725 516.161 380.744C517.91 379.763 519.894 379.272 522.113 379.272C523.265 379.272 524.46 379.443 525.697 379.784C526.956 380.125 528.129 380.733 529.217 381.608C530.305 382.461 531.18 383.688 531.841 385.288C532.524 386.867 532.865 388.904 532.865 391.4V413H527.873V391.848C527.873 389.651 527.532 387.965 526.849 386.792C526.166 385.597 525.281 384.765 524.193 384.296C523.105 383.827 521.942 383.592 520.705 383.592C519.596 383.592 518.422 383.805 517.185 384.232C515.969 384.637 514.924 385.352 514.049 386.376C513.196 387.4 512.769 388.819 512.769 390.632V413H507.777V389.864C507.777 388.477 507.404 387.325 506.657 386.408C505.932 385.469 505.025 384.765 503.937 384.296C502.849 383.827 501.761 383.592 500.673 383.592C499.478 383.592 498.262 383.827 497.025 384.296C495.809 384.765 494.785 385.523 493.953 386.568C493.142 387.613 492.737 388.968 492.737 390.632V413H487.745ZM545.885 397.608C545.885 399.827 546.248 401.843 546.974 403.656C547.699 405.469 548.819 406.92 550.334 408.008C551.848 409.096 553.768 409.64 556.094 409.64C558.334 409.64 560.264 409.117 561.886 408.072C563.507 407.005 564.52 405.501 564.926 403.56H569.726C569.32 405.779 568.435 407.635 567.07 409.128C565.726 410.621 564.094 411.752 562.174 412.52C560.275 413.267 558.27 413.64 556.158 413.64C553.128 413.64 550.451 412.979 548.126 411.656C545.822 410.312 544.019 408.381 542.718 405.864C541.438 403.347 540.798 400.317 540.798 396.776C540.798 393.256 541.384 390.184 542.558 387.56C543.731 384.915 545.427 382.877 547.646 381.448C549.886 379.997 552.584 379.272 555.742 379.272C558.792 379.272 561.374 379.933 563.486 381.256C565.598 382.557 567.208 384.424 568.318 386.856C569.427 389.288 569.982 392.189 569.982 395.56V397.608H545.885ZM545.918 394.056H565.118C565.118 392.008 564.776 390.163 564.094 388.52C563.411 386.877 562.376 385.576 560.99 384.616C559.603 383.656 557.843 383.176 555.71 383.176C553.448 383.176 551.592 383.72 550.142 384.808C548.712 385.875 547.646 387.24 546.942 388.904C546.238 390.568 545.896 392.285 545.918 394.056ZM578.495 413V379.912H583.295V384.744C583.85 383.784 584.607 382.899 585.567 382.088C586.548 381.277 587.732 380.627 589.119 380.136C590.527 379.645 592.106 379.4 593.855 379.4C595.988 379.4 597.93 379.827 599.679 380.68C601.45 381.512 602.858 382.813 603.903 384.584C604.948 386.355 605.471 388.627 605.471 391.4V413H600.479V391.848C600.479 389.032 599.764 386.952 598.335 385.608C596.906 384.264 595.018 383.592 592.671 383.592C591.071 383.592 589.567 383.848 588.159 384.36C586.751 384.872 585.62 385.651 584.767 386.696C583.914 387.741 583.487 389.053 583.487 390.632V413H578.495ZM629.413 383.656H621.925V405C621.925 406.28 622.042 407.219 622.277 407.816C622.533 408.392 622.97 408.765 623.589 408.936C624.229 409.085 625.114 409.16 626.245 409.16H629.637V412.616C629.231 412.765 628.623 412.893 627.812 413C627.023 413.085 626.074 413.128 624.965 413.128C622.853 413.128 621.21 412.829 620.037 412.232C618.885 411.635 618.074 410.749 617.605 409.576C617.135 408.403 616.901 406.931 616.901 405.16V383.656H611.525V379.912H617.029L618.213 370.376H621.925V379.88H629.413V383.656ZM647.176 413.64C645.021 413.64 643.133 413.267 641.512 412.52C639.891 411.752 638.621 410.664 637.704 409.256C636.808 407.848 636.36 406.152 636.36 404.168C636.36 400.499 637.608 397.779 640.104 396.008C642.621 394.237 646.685 393.277 652.296 393.128L658.696 392.936V390.184C658.696 388.029 658.035 386.312 656.712 385.032C655.411 383.731 653.395 383.091 650.664 383.112C648.616 383.112 646.835 383.592 645.32 384.552C643.827 385.491 642.877 387.005 642.472 389.096H637.928C638.056 387.027 638.643 385.267 639.688 383.816C640.733 382.344 642.205 381.224 644.104 380.456C646.003 379.667 648.275 379.272 650.92 379.272C653.651 379.272 655.944 379.677 657.8 380.488C659.677 381.277 661.096 382.472 662.056 384.072C663.016 385.651 663.496 387.613 663.496 389.96V413H659.208L658.856 406.632C657.533 409.256 655.848 411.08 653.8 412.104C651.773 413.128 649.565 413.64 647.176 413.64ZM648.584 409.896C649.779 409.896 650.963 409.683 652.136 409.256C653.331 408.829 654.419 408.243 655.4 407.496C656.381 406.749 657.171 405.917 657.768 405C658.365 404.083 658.675 403.144 658.696 402.184V396.296L653.352 396.392C650.557 396.435 648.264 396.712 646.472 397.224C644.701 397.736 643.379 398.525 642.504 399.592C641.651 400.637 641.224 402.013 641.224 403.72C641.224 405.661 641.907 407.176 643.272 408.264C644.637 409.352 646.408 409.896 648.584 409.896ZM688.35 383.656H680.862V405C680.862 406.28 680.979 407.219 681.214 407.816C681.47 408.392 681.907 408.765 682.526 408.936C683.166 409.085 684.051 409.16 685.182 409.16H688.574V412.616C688.169 412.765 687.561 412.893 686.75 413C685.961 413.085 685.011 413.128 683.902 413.128C681.79 413.128 680.147 412.829 678.974 412.232C677.822 411.635 677.011 410.749 676.542 409.576C676.073 408.403 675.838 406.931 675.838 405.16V383.656H670.462V379.912H675.966L677.15 370.376H680.862V379.88H688.35V383.656ZM702.908 379.912V413H698.044V379.912H702.908ZM703.068 366.76V372.264H697.82V366.76H703.068ZM726.672 413.64C723.685 413.64 721.061 413 718.8 411.72C716.56 410.419 714.821 408.499 713.584 405.96C712.346 403.421 711.728 400.296 711.728 396.584C711.728 393.128 712.293 390.099 713.424 387.496C714.576 384.893 716.261 382.877 718.48 381.448C720.698 379.997 723.44 379.272 726.704 379.272C729.69 379.272 732.282 379.933 734.48 381.256C736.698 382.557 738.416 384.499 739.632 387.08C740.869 389.64 741.488 392.808 741.488 396.584C741.488 399.955 740.933 402.92 739.824 405.48C738.714 408.04 737.061 410.045 734.864 411.496C732.688 412.925 729.957 413.64 726.672 413.64ZM726.704 409.608C728.773 409.608 730.533 409.096 731.984 408.072C733.456 407.048 734.576 405.555 735.344 403.592C736.133 401.629 736.528 399.251 736.528 396.456C736.528 393.939 736.186 391.688 735.504 389.704C734.821 387.72 733.754 386.163 732.304 385.032C730.853 383.88 728.986 383.304 726.704 383.304C724.592 383.304 722.789 383.816 721.296 384.84C719.824 385.843 718.693 387.325 717.904 389.288C717.114 391.251 716.72 393.64 716.72 396.456C716.72 398.973 717.061 401.224 717.744 403.208C718.448 405.171 719.536 406.728 721.008 407.88C722.48 409.032 724.378 409.608 726.704 409.608ZM749.62 413V379.912H754.42V384.744C754.975 383.784 755.732 382.899 756.692 382.088C757.673 381.277 758.857 380.627 760.244 380.136C761.652 379.645 763.231 379.4 764.98 379.4C767.113 379.4 769.055 379.827 770.804 380.68C772.575 381.512 773.983 382.813 775.028 384.584C776.073 386.355 776.596 388.627 776.596 391.4V413H771.604V391.848C771.604 389.032 770.889 386.952 769.46 385.608C768.031 384.264 766.143 383.592 763.796 383.592C762.196 383.592 760.692 383.848 759.284 384.36C757.876 384.872 756.745 385.651 755.892 386.696C755.039 387.741 754.612 389.053 754.612 390.632V413H749.62ZM813.234 413.64C810.247 413.64 807.623 413 805.362 411.72C803.122 410.419 801.383 408.499 800.146 405.96C798.909 403.421 798.29 400.296 798.29 396.584C798.29 393.128 798.855 390.099 799.986 387.496C801.138 384.893 802.823 382.877 805.042 381.448C807.261 379.997 810.002 379.272 813.266 379.272C816.253 379.272 818.845 379.933 821.042 381.256C823.261 382.557 824.978 384.499 826.194 387.08C827.431 389.64 828.05 392.808 828.05 396.584C828.05 399.955 827.495 402.92 826.386 405.48C825.277 408.04 823.623 410.045 821.426 411.496C819.25 412.925 816.519 413.64 813.234 413.64ZM813.266 409.608C815.335 409.608 817.095 409.096 818.546 408.072C820.018 407.048 821.138 405.555 821.906 403.592C822.695 401.629 823.09 399.251 823.09 396.456C823.09 393.939 822.749 391.688 822.066 389.704C821.383 387.72 820.317 386.163 818.866 385.032C817.415 383.88 815.549 383.304 813.266 383.304C811.154 383.304 809.351 383.816 807.858 384.84C806.386 385.843 805.255 387.325 804.466 389.288C803.677 391.251 803.282 393.64 803.282 396.456C803.282 398.973 803.623 401.224 804.306 403.208C805.01 405.171 806.098 406.728 807.57 407.88C809.042 409.032 810.941 409.608 813.266 409.608ZM853.08 379.912V383.656H844.76V413H839.768V383.656H832.536V379.912H839.768V374.664C839.768 372.061 840.408 370.088 841.688 368.744C842.968 367.4 844.92 366.728 847.544 366.728H853.4V370.376H848.312C846.904 370.376 845.944 370.76 845.432 371.528C844.941 372.275 844.696 373.405 844.696 374.92V379.912H853.08ZM65.6 447.656H58.112V469C58.112 470.28 58.2293 471.219 58.464 471.816C58.72 472.392 59.1573 472.765 59.776 472.936C60.416 473.085 61.3013 473.16 62.432 473.16H65.824V476.616C65.4187 476.765 64.8107 476.893 64 477C63.2107 477.085 62.2613 477.128 61.152 477.128C59.04 477.128 57.3973 476.829 56.224 476.232C55.072 475.635 54.2613 474.749 53.792 473.576C53.3227 472.403 53.088 470.931 53.088 469.16V447.656H47.712V443.912H53.216L54.4 434.376H58.112V443.88H65.6V447.656ZM74.5575 477V429.448H79.3895V448.776C79.9655 447.837 80.7335 446.963 81.6935 446.152C82.6748 445.341 83.8482 444.691 85.2135 444.2C86.6002 443.688 88.1788 443.432 89.9495 443.432C92.1255 443.432 94.0775 443.827 95.8055 444.616C97.5548 445.405 98.9415 446.525 99.9655 447.976C100.99 449.427 101.502 451.133 101.502 453.096V477H96.5095V454.216C96.5095 452.125 95.7948 450.504 94.3655 449.352C92.9362 448.179 91.0482 447.592 88.7015 447.592C87.1015 447.592 85.5975 447.859 84.1895 448.392C82.8028 448.904 81.6828 449.683 80.8295 450.728C79.9762 451.752 79.5495 453.064 79.5495 454.664V477H74.5575ZM114.51 461.608C114.51 463.827 114.873 465.843 115.599 467.656C116.324 469.469 117.444 470.92 118.959 472.008C120.473 473.096 122.393 473.64 124.719 473.64C126.959 473.64 128.889 473.117 130.511 472.072C132.132 471.005 133.145 469.501 133.551 467.56H138.351C137.945 469.779 137.06 471.635 135.695 473.128C134.351 474.621 132.719 475.752 130.799 476.52C128.9 477.267 126.895 477.64 124.783 477.64C121.753 477.64 119.076 476.979 116.751 475.656C114.447 474.312 112.644 472.381 111.343 469.864C110.063 467.347 109.423 464.317 109.423 460.776C109.423 457.256 110.009 454.184 111.183 451.56C112.356 448.915 114.052 446.877 116.271 445.448C118.511 443.997 121.209 443.272 124.367 443.272C127.417 443.272 129.999 443.933 132.111 445.256C134.223 446.557 135.833 448.424 136.943 450.856C138.052 453.288 138.607 456.189 138.607 459.56V461.608H114.51ZM114.543 458.056H133.743C133.743 456.008 133.401 454.163 132.719 452.52C132.036 450.877 131.001 449.576 129.615 448.616C128.228 447.656 126.468 447.176 124.335 447.176C122.073 447.176 120.217 447.72 118.767 448.808C117.337 449.875 116.271 451.24 115.567 452.904C114.863 454.568 114.521 456.285 114.543 458.056ZM162.993 430.728H167.985V477H162.993V430.728ZM179.433 477V443.912H184.233V448.744C184.787 447.784 185.545 446.899 186.505 446.088C187.486 445.277 188.67 444.627 190.057 444.136C191.465 443.645 193.043 443.4 194.793 443.4C196.926 443.4 198.867 443.827 200.617 444.68C202.387 445.512 203.795 446.813 204.841 448.584C205.886 450.355 206.409 452.627 206.409 455.4V477H201.417V455.848C201.417 453.032 200.702 450.952 199.273 449.608C197.843 448.264 195.955 447.592 193.609 447.592C192.009 447.592 190.505 447.848 189.097 448.36C187.689 448.872 186.558 449.651 185.705 450.696C184.851 451.741 184.425 453.053 184.425 454.632V477H179.433ZM230.35 447.656H222.862V469C222.862 470.28 222.979 471.219 223.214 471.816C223.47 472.392 223.907 472.765 224.526 472.936C225.166 473.085 226.051 473.16 227.182 473.16H230.574V476.616C230.169 476.765 229.561 476.893 228.75 477C227.961 477.085 227.011 477.128 225.902 477.128C223.79 477.128 222.147 476.829 220.974 476.232C219.822 475.635 219.011 474.749 218.542 473.576C218.073 472.403 217.838 470.931 217.838 469.16V447.656H212.462V443.912H217.966L219.15 434.376H222.862V443.88H230.35V447.656ZM241.823 461.608C241.823 463.827 242.186 465.843 242.911 467.656C243.636 469.469 244.756 470.92 246.271 472.008C247.786 473.096 249.706 473.64 252.031 473.64C254.271 473.64 256.202 473.117 257.823 472.072C259.444 471.005 260.458 469.501 260.863 467.56H265.663C265.258 469.779 264.372 471.635 263.007 473.128C261.663 474.621 260.031 475.752 258.111 476.52C256.212 477.267 254.207 477.64 252.095 477.64C249.066 477.64 246.388 476.979 244.063 475.656C241.759 474.312 239.956 472.381 238.655 469.864C237.375 467.347 236.735 464.317 236.735 460.776C236.735 457.256 237.322 454.184 238.495 451.56C239.668 448.915 241.364 446.877 243.583 445.448C245.823 443.997 248.522 443.272 251.679 443.272C254.73 443.272 257.311 443.933 259.423 445.256C261.535 446.557 263.146 448.424 264.255 450.856C265.364 453.288 265.919 456.189 265.919 459.56V461.608H241.823ZM241.855 458.056H261.055C261.055 456.008 260.714 454.163 260.031 452.52C259.348 450.877 258.314 449.576 256.927 448.616C255.54 447.656 253.78 447.176 251.647 447.176C249.386 447.176 247.53 447.72 246.079 448.808C244.65 449.875 243.583 451.24 242.879 452.904C242.175 454.568 241.834 456.285 241.855 458.056ZM274.433 477V443.912H279.169V449.896C279.723 448.339 280.502 447.08 281.505 446.12C282.529 445.139 283.67 444.424 284.929 443.976C286.209 443.507 287.499 443.272 288.801 443.272C289.334 443.272 289.857 443.315 290.369 443.4C290.881 443.464 291.286 443.581 291.585 443.752V448.616C291.243 448.445 290.785 448.328 290.209 448.264C289.654 448.2 289.185 448.168 288.801 448.168C287.627 448.104 286.486 448.189 285.377 448.424C284.267 448.659 283.254 449.075 282.337 449.672C281.441 450.269 280.726 451.069 280.193 452.072C279.681 453.075 279.425 454.301 279.425 455.752V477H274.433ZM310.154 458.408V462.472L294.25 462.504V458.44L310.154 458.408ZM320.493 477V430.728H334.861C340.365 430.728 344.557 431.763 347.437 433.832C350.338 435.88 351.789 438.856 351.789 442.76C351.789 445.256 351.128 447.389 349.805 449.16C348.504 450.931 346.253 452.349 343.053 453.416C344.845 453.779 346.37 454.312 347.629 455.016C348.888 455.72 349.901 456.552 350.669 457.512C351.458 458.472 352.024 459.549 352.365 460.744C352.728 461.939 352.909 463.219 352.909 464.584C352.909 468.744 351.416 471.859 348.429 473.928C345.442 475.976 341.048 477 335.245 477H320.493ZM325.485 472.68H335.117C339.277 472.68 342.445 472.029 344.621 470.728C346.797 469.405 347.885 467.325 347.885 464.488C347.885 462.397 347.341 460.712 346.253 459.432C345.186 458.152 343.746 457.224 341.933 456.648C340.12 456.072 338.104 455.784 335.885 455.784H325.485V472.68ZM325.485 451.4H335.885C337.165 451.4 338.445 451.283 339.725 451.048C341.026 450.792 342.221 450.365 343.309 449.768C344.397 449.171 345.272 448.36 345.933 447.336C346.594 446.291 346.925 444.979 346.925 443.4C346.925 440.499 345.816 438.376 343.597 437.032C341.4 435.667 338.53 434.984 334.989 434.984H325.485V451.4ZM369.614 477.352C368.035 477.352 366.734 477.128 365.71 476.68C364.707 476.211 363.918 475.571 363.342 474.76C362.787 473.949 362.403 473.021 362.19 471.976C361.977 470.931 361.87 469.832 361.87 468.68V429.448H366.798V468.264C366.798 470.077 367.139 471.411 367.822 472.264C368.505 473.096 369.401 473.544 370.51 473.608L372.366 473.64V476.904C371.897 477.053 371.417 477.16 370.926 477.224C370.435 477.309 369.998 477.352 369.614 477.352ZM392.734 477.64C389.747 477.64 387.123 477 384.862 475.72C382.622 474.419 380.883 472.499 379.646 469.96C378.409 467.421 377.79 464.296 377.79 460.584C377.79 457.128 378.355 454.099 379.486 451.496C380.638 448.893 382.323 446.877 384.542 445.448C386.761 443.997 389.502 443.272 392.766 443.272C395.753 443.272 398.345 443.933 400.542 445.256C402.761 446.557 404.478 448.499 405.694 451.08C406.931 453.64 407.55 456.808 407.55 460.584C407.55 463.955 406.995 466.92 405.886 469.48C404.777 472.04 403.123 474.045 400.926 475.496C398.75 476.925 396.019 477.64 392.734 477.64ZM392.766 473.608C394.835 473.608 396.595 473.096 398.046 472.072C399.518 471.048 400.638 469.555 401.406 467.592C402.195 465.629 402.59 463.251 402.59 460.456C402.59 457.939 402.249 455.688 401.566 453.704C400.883 451.72 399.817 450.163 398.366 449.032C396.915 447.88 395.049 447.304 392.766 447.304C390.654 447.304 388.851 447.816 387.358 448.84C385.886 449.843 384.755 451.325 383.966 453.288C383.177 455.251 382.782 457.64 382.782 460.456C382.782 462.973 383.123 465.224 383.806 467.208C384.51 469.171 385.598 470.728 387.07 471.88C388.542 473.032 390.441 473.608 392.766 473.608ZM428.611 443.272C430.893 443.272 432.963 443.699 434.819 444.552C436.675 445.405 438.211 446.632 439.427 448.232C440.643 449.811 441.421 451.72 441.763 453.96H437.187C436.973 452.723 436.493 451.613 435.747 450.632C435 449.629 434.019 448.84 432.803 448.264C431.608 447.688 430.221 447.4 428.642 447.4C425.635 447.4 423.181 448.477 421.283 450.632C419.405 452.765 418.467 456.061 418.467 460.52C418.467 464.509 419.32 467.709 421.027 470.12C422.755 472.509 425.315 473.704 428.707 473.704C430.285 473.704 431.672 473.416 432.867 472.84C434.083 472.243 435.064 471.453 435.811 470.472C436.557 469.469 437.027 468.371 437.219 467.176H441.731C441.411 469.352 440.632 471.229 439.395 472.808C438.157 474.365 436.611 475.56 434.755 476.392C432.92 477.224 430.872 477.64 428.611 477.64C425.667 477.64 423.064 477 420.803 475.72C418.541 474.44 416.771 472.531 415.491 469.992C414.232 467.453 413.603 464.307 413.603 460.552C413.603 457.117 414.179 454.109 415.331 451.528C416.483 448.925 418.168 446.899 420.387 445.448C422.627 443.997 425.368 443.272 428.611 443.272ZM478.439 477H473.031L462.279 459.752L455.143 467.08V477H450.183V429.448H455.143V461.224L471.623 443.912H477.511L465.607 456.36L478.439 477ZM497.486 443.272C499.768 443.272 501.838 443.699 503.694 444.552C505.55 445.405 507.086 446.632 508.302 448.232C509.518 449.811 510.296 451.72 510.638 453.96H506.062C505.848 452.723 505.368 451.613 504.622 450.632C503.875 449.629 502.894 448.84 501.678 448.264C500.483 447.688 499.096 447.4 497.517 447.4C494.51 447.4 492.056 448.477 490.158 450.632C488.28 452.765 487.342 456.061 487.342 460.52C487.342 464.509 488.195 467.709 489.902 470.12C491.63 472.509 494.19 473.704 497.582 473.704C499.16 473.704 500.547 473.416 501.742 472.84C502.958 472.243 503.939 471.453 504.686 470.472C505.432 469.469 505.902 468.371 506.094 467.176H510.606C510.286 469.352 509.507 471.229 508.27 472.808C507.032 474.365 505.486 475.56 503.63 476.392C501.795 477.224 499.747 477.64 497.486 477.64C494.542 477.64 491.939 477 489.678 475.72C487.416 474.44 485.646 472.531 484.366 469.992C483.107 467.453 482.478 464.307 482.478 460.552C482.478 457.117 483.054 454.109 484.206 451.528C485.358 448.925 487.043 446.899 489.262 445.448C491.502 443.997 494.243 443.272 497.486 443.272ZM519.058 477V429.448H523.89V448.776C524.466 447.837 525.234 446.963 526.194 446.152C527.175 445.341 528.348 444.691 529.714 444.2C531.1 443.688 532.679 443.432 534.45 443.432C536.626 443.432 538.578 443.827 540.306 444.616C542.055 445.405 543.442 446.525 544.466 447.976C545.49 449.427 546.002 451.133 546.002 453.096V477H541.01V454.216C541.01 452.125 540.295 450.504 538.866 449.352C537.436 448.179 535.548 447.592 533.202 447.592C531.602 447.592 530.098 447.859 528.69 448.392C527.303 448.904 526.183 449.683 525.33 450.728C524.476 451.752 524.05 453.064 524.05 454.664V477H519.058ZM564.676 477.64C562.521 477.64 560.633 477.267 559.012 476.52C557.391 475.752 556.121 474.664 555.204 473.256C554.308 471.848 553.86 470.152 553.86 468.168C553.86 464.499 555.108 461.779 557.604 460.008C560.121 458.237 564.185 457.277 569.796 457.128L576.196 456.936V454.184C576.196 452.029 575.535 450.312 574.212 449.032C572.911 447.731 570.895 447.091 568.164 447.112C566.116 447.112 564.335 447.592 562.82 448.552C561.327 449.491 560.377 451.005 559.972 453.096H555.428C555.556 451.027 556.143 449.267 557.188 447.816C558.233 446.344 559.705 445.224 561.604 444.456C563.503 443.667 565.775 443.272 568.42 443.272C571.151 443.272 573.444 443.677 575.3 444.488C577.177 445.277 578.596 446.472 579.556 448.072C580.516 449.651 580.996 451.613 580.996 453.96V477H576.708L576.356 470.632C575.033 473.256 573.348 475.08 571.3 476.104C569.273 477.128 567.065 477.64 564.676 477.64ZM566.084 473.896C567.279 473.896 568.463 473.683 569.636 473.256C570.831 472.829 571.919 472.243 572.9 471.496C573.881 470.749 574.671 469.917 575.268 469C575.865 468.083 576.175 467.144 576.196 466.184V460.296L570.852 460.392C568.057 460.435 565.764 460.712 563.972 461.224C562.201 461.736 560.879 462.525 560.004 463.592C559.151 464.637 558.724 466.013 558.724 467.72C558.724 469.661 559.407 471.176 560.772 472.264C562.137 473.352 563.908 473.896 566.084 473.896ZM597.158 443.912V477H592.294V443.912H597.158ZM597.318 430.76V436.264H592.07V430.76H597.318ZM608.495 477V443.912H613.295V448.744C613.85 447.784 614.607 446.899 615.567 446.088C616.548 445.277 617.732 444.627 619.119 444.136C620.527 443.645 622.106 443.4 623.855 443.4C625.988 443.4 627.93 443.827 629.679 444.68C631.45 445.512 632.858 446.813 633.903 448.584C634.948 450.355 635.471 452.627 635.471 455.4V477H630.479V455.848C630.479 453.032 629.764 450.952 628.335 449.608C626.906 448.264 625.018 447.592 622.671 447.592C621.071 447.592 619.567 447.848 618.159 448.36C616.751 448.872 615.62 449.651 614.767 450.696C613.914 451.741 613.487 453.053 613.487 454.632V477H608.495ZM66.88 494.088C70.08 494.088 72.9173 494.76 75.392 496.104C77.8667 497.448 79.8507 499.229 81.344 501.448C82.8373 503.667 83.7227 506.077 84 508.68H78.624C78.2613 506.824 77.5787 505.128 76.576 503.592C75.5947 502.056 74.2827 500.829 72.64 499.912C70.9973 498.995 69.0453 498.536 66.784 498.536C63.7973 498.536 61.28 499.229 59.232 500.616C57.2053 502.003 55.6693 504.125 54.624 506.984C53.6 509.821 53.088 513.437 53.088 517.832C53.088 524.445 54.24 529.32 56.544 532.456C58.8693 535.592 62.2827 537.16 66.784 537.16C69.0453 537.16 70.9973 536.691 72.64 535.752C74.2827 534.792 75.5947 533.533 76.576 531.976C77.5787 530.397 78.2613 528.68 78.624 526.824H84C83.7653 528.723 83.232 530.568 82.4 532.36C81.5893 534.131 80.4693 535.72 79.04 537.128C77.632 538.515 75.904 539.613 73.856 540.424C71.8293 541.235 69.504 541.64 66.88 541.64C62.7627 541.64 59.264 540.712 56.384 538.856C53.5253 536.979 51.3387 534.269 49.824 530.728C48.3093 527.165 47.552 522.845 47.552 517.768C47.552 512.691 48.2987 508.392 49.792 504.872C51.3067 501.352 53.504 498.675 56.384 496.84C59.264 495.005 62.7627 494.088 66.88 494.088ZM105.422 541.64C102.435 541.64 99.8108 541 97.5495 539.72C95.3095 538.419 93.5708 536.499 92.3335 533.96C91.0962 531.421 90.4775 528.296 90.4775 524.584C90.4775 521.128 91.0428 518.099 92.1735 515.496C93.3255 512.893 95.0108 510.877 97.2295 509.448C99.4482 507.997 102.19 507.272 105.454 507.272C108.44 507.272 111.032 507.933 113.23 509.256C115.448 510.557 117.166 512.499 118.382 515.08C119.619 517.64 120.238 520.808 120.238 524.584C120.238 527.955 119.683 530.92 118.574 533.48C117.464 536.04 115.811 538.045 113.614 539.496C111.438 540.925 108.707 541.64 105.422 541.64ZM105.454 537.608C107.523 537.608 109.283 537.096 110.734 536.072C112.206 535.048 113.326 533.555 114.094 531.592C114.883 529.629 115.278 527.251 115.278 524.456C115.278 521.939 114.936 519.688 114.254 517.704C113.571 515.72 112.504 514.163 111.054 513.032C109.603 511.88 107.736 511.304 105.454 511.304C103.342 511.304 101.539 511.816 100.046 512.84C98.5735 513.843 97.4428 515.325 96.6535 517.288C95.8642 519.251 95.4695 521.64 95.4695 524.456C95.4695 526.973 95.8108 529.224 96.4935 531.208C97.1975 533.171 98.2855 534.728 99.7575 535.88C101.23 537.032 103.128 537.608 105.454 537.608ZM128.37 541V507.912H133.17V512.744C134.045 511.272 135.261 509.992 136.818 508.904C138.397 507.816 140.466 507.272 143.026 507.272C144.263 507.272 145.511 507.475 146.77 507.88C148.029 508.285 149.181 508.893 150.226 509.704C151.271 510.515 152.071 511.517 152.626 512.712C153.65 511.048 155.037 509.725 156.786 508.744C158.535 507.763 160.519 507.272 162.738 507.272C163.89 507.272 165.085 507.443 166.322 507.784C167.581 508.125 168.754 508.733 169.842 509.608C170.93 510.461 171.805 511.688 172.466 513.288C173.149 514.867 173.49 516.904 173.49 519.4V541H168.498V519.848C168.498 517.651 168.157 515.965 167.474 514.792C166.791 513.597 165.906 512.765 164.818 512.296C163.73 511.827 162.567 511.592 161.33 511.592C160.221 511.592 159.047 511.805 157.81 512.232C156.594 512.637 155.549 513.352 154.674 514.376C153.821 515.4 153.394 516.819 153.394 518.632V541H148.402V517.864C148.402 516.477 148.029 515.325 147.282 514.408C146.557 513.469 145.65 512.765 144.562 512.296C143.474 511.827 142.386 511.592 141.298 511.592C140.103 511.592 138.887 511.827 137.65 512.296C136.434 512.765 135.41 513.523 134.578 514.568C133.767 515.613 133.362 516.968 133.362 518.632V541H128.37ZM183.183 541V507.912H187.983V512.744C188.857 511.272 190.073 509.992 191.631 508.904C193.209 507.816 195.279 507.272 197.839 507.272C199.076 507.272 200.324 507.475 201.583 507.88C202.841 508.285 203.993 508.893 205.039 509.704C206.084 510.515 206.884 511.517 207.439 512.712C208.463 511.048 209.849 509.725 211.599 508.744C213.348 507.763 215.332 507.272 217.551 507.272C218.703 507.272 219.897 507.443 221.135 507.784C222.393 508.125 223.567 508.733 224.655 509.608C225.743 510.461 226.617 511.688 227.279 513.288C227.961 514.867 228.303 516.904 228.303 519.4V541H223.311V519.848C223.311 517.651 222.969 515.965 222.287 514.792C221.604 513.597 220.719 512.765 219.631 512.296C218.543 511.827 217.38 511.592 216.143 511.592C215.033 511.592 213.86 511.805 212.623 512.232C211.407 512.637 210.361 513.352 209.487 514.376C208.633 515.4 208.207 516.819 208.207 518.632V541H203.215V517.864C203.215 516.477 202.841 515.325 202.095 514.408C201.369 513.469 200.463 512.765 199.375 512.296C198.287 511.827 197.199 511.592 196.111 511.592C194.916 511.592 193.7 511.827 192.463 512.296C191.247 512.765 190.223 513.523 189.391 514.568C188.58 515.613 188.175 516.968 188.175 518.632V541H183.183ZM249.593 541.64C247.822 541.619 246.169 541.373 244.633 540.904C243.097 540.413 241.742 539.699 240.569 538.76C239.417 537.8 238.51 536.616 237.849 535.208C237.209 533.779 236.889 532.125 236.889 530.248V507.912H241.881V529.8C241.881 532.125 242.585 534.013 243.993 535.464C245.401 536.893 247.566 537.608 250.489 537.608C253.091 537.608 255.182 536.936 256.761 535.592C258.339 534.227 259.129 532.168 259.129 529.416V507.912H264.089V541H260.057L259.545 534.728C259.161 536.307 258.489 537.608 257.529 538.632C256.59 539.656 255.438 540.424 254.073 540.936C252.729 541.427 251.235 541.661 249.593 541.64ZM274.245 541V507.912H279.045V512.744C279.6 511.784 280.357 510.899 281.317 510.088C282.298 509.277 283.482 508.627 284.869 508.136C286.277 507.645 287.856 507.4 289.605 507.4C291.738 507.4 293.68 507.827 295.429 508.68C297.2 509.512 298.608 510.813 299.653 512.584C300.698 514.355 301.221 516.627 301.221 519.4V541H296.229V519.848C296.229 517.032 295.514 514.952 294.085 513.608C292.656 512.264 290.768 511.592 288.421 511.592C286.821 511.592 285.317 511.848 283.909 512.36C282.501 512.872 281.37 513.651 280.517 514.696C279.664 515.741 279.237 517.053 279.237 518.632V541H274.245ZM316.47 507.912V541H311.606V507.912H316.47ZM316.63 494.76V500.264H311.382V494.76H316.63ZM340.298 507.272C342.581 507.272 344.65 507.699 346.506 508.552C348.362 509.405 349.898 510.632 351.114 512.232C352.33 513.811 353.109 515.72 353.45 517.96H348.874C348.661 516.723 348.181 515.613 347.434 514.632C346.687 513.629 345.706 512.84 344.49 512.264C343.295 511.688 341.909 511.4 340.33 511.4C337.322 511.4 334.869 512.477 332.97 514.632C331.093 516.765 330.154 520.061 330.154 524.52C330.154 528.509 331.007 531.709 332.714 534.12C334.442 536.509 337.002 537.704 340.394 537.704C341.973 537.704 343.359 537.416 344.554 536.84C345.77 536.243 346.751 535.453 347.498 534.472C348.245 533.469 348.714 532.371 348.906 531.176H353.418C353.098 533.352 352.319 535.229 351.082 536.808C349.845 538.365 348.298 539.56 346.442 540.392C344.607 541.224 342.559 541.64 340.298 541.64C337.354 541.64 334.751 541 332.49 539.72C330.229 538.44 328.458 536.531 327.178 533.992C325.919 531.453 325.29 528.307 325.29 524.552C325.29 521.117 325.866 518.109 327.018 515.528C328.17 512.925 329.855 510.899 332.074 509.448C334.314 507.997 337.055 507.272 340.298 507.272ZM370.489 541.64C368.334 541.64 366.446 541.267 364.825 540.52C363.203 539.752 361.934 538.664 361.016 537.256C360.121 535.848 359.673 534.152 359.673 532.168C359.673 528.499 360.921 525.779 363.417 524.008C365.934 522.237 369.998 521.277 375.609 521.128L382.009 520.936V518.184C382.009 516.029 381.347 514.312 380.025 513.032C378.723 511.731 376.707 511.091 373.977 511.112C371.929 511.112 370.147 511.592 368.633 512.552C367.139 513.491 366.19 515.005 365.785 517.096H361.241C361.369 515.027 361.955 513.267 363.001 511.816C364.046 510.344 365.518 509.224 367.417 508.456C369.315 507.667 371.587 507.272 374.233 507.272C376.963 507.272 379.257 507.677 381.113 508.488C382.99 509.277 384.409 510.472 385.369 512.072C386.329 513.651 386.809 515.613 386.809 517.96V541H382.521L382.169 534.632C380.846 537.256 379.161 539.08 377.113 540.104C375.086 541.128 372.878 541.64 370.489 541.64ZM371.897 537.896C373.091 537.896 374.275 537.683 375.449 537.256C376.643 536.829 377.731 536.243 378.713 535.496C379.694 534.749 380.483 533.917 381.081 533C381.678 532.083 381.987 531.144 382.009 530.184V524.296L376.665 524.392C373.87 524.435 371.577 524.712 369.785 525.224C368.014 525.736 366.691 526.525 365.817 527.592C364.963 528.637 364.536 530.013 364.536 531.72C364.536 533.661 365.219 535.176 366.585 536.264C367.95 537.352 369.721 537.896 371.897 537.896ZM411.663 511.656H404.175V533C404.175 534.28 404.292 535.219 404.527 535.816C404.783 536.392 405.22 536.765 405.839 536.936C406.479 537.085 407.364 537.16 408.495 537.16H411.887V540.616C411.481 540.765 410.873 540.893 410.062 541C409.273 541.085 408.324 541.128 407.215 541.128C405.103 541.128 403.46 540.829 402.287 540.232C401.135 539.635 400.324 538.749 399.855 537.576C399.385 536.403 399.151 534.931 399.151 533.16V511.656H393.775V507.912H399.279L400.463 498.376H404.175V507.88H411.663V511.656ZM426.22 507.912V541H421.356V507.912H426.22ZM426.38 494.76V500.264H421.132V494.76H426.38ZM449.984 541.64C446.997 541.64 444.373 541 442.112 539.72C439.872 538.419 438.133 536.499 436.896 533.96C435.659 531.421 435.04 528.296 435.04 524.584C435.04 521.128 435.605 518.099 436.736 515.496C437.888 512.893 439.573 510.877 441.792 509.448C444.011 507.997 446.752 507.272 450.016 507.272C453.003 507.272 455.595 507.933 457.792 509.256C460.011 510.557 461.728 512.499 462.944 515.08C464.181 517.64 464.8 520.808 464.8 524.584C464.8 527.955 464.245 530.92 463.136 533.48C462.027 536.04 460.373 538.045 458.176 539.496C456 540.925 453.269 541.64 449.984 541.64ZM450.016 537.608C452.085 537.608 453.845 537.096 455.296 536.072C456.768 535.048 457.888 533.555 458.656 531.592C459.445 529.629 459.84 527.251 459.84 524.456C459.84 521.939 459.499 519.688 458.816 517.704C458.133 515.72 457.067 514.163 455.616 513.032C454.165 511.88 452.299 511.304 450.016 511.304C447.904 511.304 446.101 511.816 444.608 512.84C443.136 513.843 442.005 515.325 441.216 517.288C440.427 519.251 440.032 521.64 440.032 524.456C440.032 526.973 440.373 529.224 441.056 531.208C441.76 533.171 442.848 534.728 444.32 535.88C445.792 537.032 447.691 537.608 450.016 537.608ZM472.933 541V507.912H477.733V512.744C478.287 511.784 479.045 510.899 480.005 510.088C480.986 509.277 482.17 508.627 483.557 508.136C484.965 507.645 486.543 507.4 488.293 507.4C490.426 507.4 492.367 507.827 494.117 508.68C495.887 509.512 497.295 510.813 498.341 512.584C499.386 514.355 499.909 516.627 499.909 519.4V541H494.917V519.848C494.917 517.032 494.202 514.952 492.773 513.608C491.343 512.264 489.455 511.592 487.109 511.592C485.509 511.592 484.005 511.848 482.597 512.36C481.189 512.872 480.058 513.651 479.205 514.696C478.351 515.741 477.925 517.053 477.925 518.632V541H472.933ZM525.868 541V494.728H541.132C544.417 494.728 547.34 495.283 549.9 496.392C552.481 497.48 554.497 499.101 555.948 501.256C557.42 503.389 558.156 506.035 558.156 509.192C558.156 512.285 557.463 514.92 556.076 517.096C554.689 519.251 552.769 520.893 550.316 522.024C547.884 523.155 545.057 523.72 541.836 523.72H531.052V541H525.868ZM531.02 519.336H541.74C545.132 519.336 547.884 518.408 549.996 516.552C552.129 514.696 553.196 512.147 553.196 508.904C553.196 505.619 552.108 503.155 549.932 501.512C547.756 499.869 544.908 499.048 541.388 499.048H531.02V519.336ZM565.058 541V507.912H569.794V513.896C570.348 512.339 571.127 511.08 572.13 510.12C573.154 509.139 574.295 508.424 575.554 507.976C576.834 507.507 578.124 507.272 579.426 507.272C579.959 507.272 580.482 507.315 580.994 507.4C581.506 507.464 581.911 507.581 582.21 507.752V512.616C581.868 512.445 581.41 512.328 580.834 512.264C580.279 512.2 579.81 512.168 579.426 512.168C578.252 512.104 577.111 512.189 576.002 512.424C574.892 512.659 573.879 513.075 572.962 513.672C572.066 514.269 571.351 515.069 570.818 516.072C570.306 517.075 570.05 518.301 570.05 519.752V541H565.058ZM601.547 541.64C598.56 541.64 595.936 541 593.675 539.72C591.435 538.419 589.696 536.499 588.459 533.96C587.221 531.421 586.603 528.296 586.603 524.584C586.603 521.128 587.168 518.099 588.299 515.496C589.451 512.893 591.136 510.877 593.355 509.448C595.573 507.997 598.315 507.272 601.579 507.272C604.565 507.272 607.157 507.933 609.355 509.256C611.573 510.557 613.291 512.499 614.507 515.08C615.744 517.64 616.363 520.808 616.363 524.584C616.363 527.955 615.808 530.92 614.699 533.48C613.589 536.04 611.936 538.045 609.739 539.496C607.563 540.925 604.832 541.64 601.547 541.64ZM601.579 537.608C603.648 537.608 605.408 537.096 606.859 536.072C608.331 535.048 609.451 533.555 610.219 531.592C611.008 529.629 611.403 527.251 611.403 524.456C611.403 521.939 611.061 519.688 610.379 517.704C609.696 515.72 608.629 514.163 607.179 513.032C605.728 511.88 603.861 511.304 601.579 511.304C599.467 511.304 597.664 511.816 596.171 512.84C594.699 513.843 593.568 515.325 592.779 517.288C591.989 519.251 591.595 521.64 591.595 524.456C591.595 526.973 591.936 529.224 592.619 531.208C593.323 533.171 594.411 534.728 595.883 535.88C597.355 537.032 599.253 537.608 601.579 537.608ZM639.35 511.656H631.862V533C631.862 534.28 631.979 535.219 632.214 535.816C632.47 536.392 632.907 536.765 633.526 536.936C634.166 537.085 635.051 537.16 636.182 537.16H639.574V540.616C639.169 540.765 638.561 540.893 637.75 541C636.961 541.085 636.011 541.128 634.902 541.128C632.79 541.128 631.147 540.829 629.974 540.232C628.822 539.635 628.011 538.749 627.542 537.576C627.073 536.403 626.838 534.931 626.838 533.16V511.656H621.462V507.912H626.966L628.15 498.376H631.862V507.88H639.35V511.656ZM660.359 541.64C657.372 541.64 654.748 541 652.487 539.72C650.247 538.419 648.508 536.499 647.271 533.96C646.034 531.421 645.415 528.296 645.415 524.584C645.415 521.128 645.98 518.099 647.111 515.496C648.263 512.893 649.948 510.877 652.167 509.448C654.386 507.997 657.127 507.272 660.391 507.272C663.378 507.272 665.97 507.933 668.167 509.256C670.386 510.557 672.103 512.499 673.319 515.08C674.556 517.64 675.175 520.808 675.175 524.584C675.175 527.955 674.62 530.92 673.511 533.48C672.402 536.04 670.748 538.045 668.551 539.496C666.375 540.925 663.644 541.64 660.359 541.64ZM660.391 537.608C662.46 537.608 664.22 537.096 665.671 536.072C667.143 535.048 668.263 533.555 669.031 531.592C669.82 529.629 670.215 527.251 670.215 524.456C670.215 521.939 669.874 519.688 669.191 517.704C668.508 515.72 667.442 514.163 665.991 513.032C664.54 511.88 662.674 511.304 660.391 511.304C658.279 511.304 656.476 511.816 654.983 512.84C653.511 513.843 652.38 515.325 651.591 517.288C650.802 519.251 650.407 521.64 650.407 524.456C650.407 526.973 650.748 529.224 651.431 531.208C652.135 533.171 653.223 534.728 654.695 535.88C656.167 537.032 658.066 537.608 660.391 537.608ZM696.236 507.272C698.518 507.272 700.588 507.699 702.444 508.552C704.3 509.405 705.836 510.632 707.052 512.232C708.268 513.811 709.046 515.72 709.388 517.96H704.812C704.598 516.723 704.118 515.613 703.372 514.632C702.625 513.629 701.644 512.84 700.428 512.264C699.233 511.688 697.846 511.4 696.267 511.4C693.26 511.4 690.806 512.477 688.908 514.632C687.03 516.765 686.092 520.061 686.092 524.52C686.092 528.509 686.945 531.709 688.652 534.12C690.38 536.509 692.94 537.704 696.332 537.704C697.91 537.704 699.297 537.416 700.492 536.84C701.708 536.243 702.689 535.453 703.436 534.472C704.182 533.469 704.652 532.371 704.844 531.176H709.356C709.036 533.352 708.257 535.229 707.02 536.808C705.782 538.365 704.236 539.56 702.38 540.392C700.545 541.224 698.497 541.64 696.236 541.64C693.292 541.64 690.689 541 688.428 539.72C686.166 538.44 684.396 536.531 683.116 533.992C681.857 531.453 681.228 528.307 681.228 524.552C681.228 521.117 681.804 518.109 682.956 515.528C684.108 512.925 685.793 510.899 688.012 509.448C690.252 507.997 692.993 507.272 696.236 507.272ZM730.672 541.64C727.685 541.64 725.061 541 722.8 539.72C720.56 538.419 718.821 536.499 717.584 533.96C716.346 531.421 715.728 528.296 715.728 524.584C715.728 521.128 716.293 518.099 717.424 515.496C718.576 512.893 720.261 510.877 722.48 509.448C724.698 507.997 727.44 507.272 730.704 507.272C733.69 507.272 736.282 507.933 738.48 509.256C740.698 510.557 742.416 512.499 743.632 515.08C744.869 517.64 745.488 520.808 745.488 524.584C745.488 527.955 744.933 530.92 743.824 533.48C742.714 536.04 741.061 538.045 738.864 539.496C736.688 540.925 733.957 541.64 730.672 541.64ZM730.704 537.608C732.773 537.608 734.533 537.096 735.984 536.072C737.456 535.048 738.576 533.555 739.344 531.592C740.133 529.629 740.528 527.251 740.528 524.456C740.528 521.939 740.186 519.688 739.504 517.704C738.821 515.72 737.754 514.163 736.304 513.032C734.853 511.88 732.986 511.304 730.704 511.304C728.592 511.304 726.789 511.816 725.296 512.84C723.824 513.843 722.693 515.325 721.904 517.288C721.114 519.251 720.72 521.64 720.72 524.456C720.72 526.973 721.061 529.224 721.744 531.208C722.448 533.171 723.536 534.728 725.008 535.88C726.48 537.032 728.378 537.608 730.704 537.608ZM761.364 541.352C759.785 541.352 758.484 541.128 757.46 540.68C756.457 540.211 755.668 539.571 755.092 538.76C754.537 537.949 754.153 537.021 753.94 535.976C753.727 534.931 753.62 533.832 753.62 532.68V493.448H758.548V532.264C758.548 534.077 758.889 535.411 759.572 536.264C760.255 537.096 761.151 537.544 762.26 537.608L764.116 537.64V540.904C763.647 541.053 763.167 541.16 762.676 541.224C762.185 541.309 761.748 541.352 761.364 541.352Z" fill="black"/>
+<path d="M78.5 172.6V276H63.3V172.6H78.5ZM79 131.5V148.7H62.6V131.5H79ZM153.33 278C146.996 278 141.663 277.167 137.33 275.5C133.063 273.767 129.596 271.633 126.93 269.1C124.263 266.567 122.23 264 120.83 261.4C119.43 258.8 118.43 256.6 117.83 254.8L116.23 276H103.93V127.4H119.73V189.6C120.463 188.067 121.696 186.233 123.43 184.1C125.163 181.967 127.43 179.867 130.23 177.8C133.03 175.733 136.43 174.033 140.43 172.7C144.43 171.3 149.063 170.6 154.33 170.6C167.263 170.6 177.596 175.067 185.33 184C193.063 192.933 196.93 206.233 196.93 223.9C196.93 234.767 195.296 244.267 192.03 252.4C188.83 260.467 183.996 266.767 177.53 271.3C171.13 275.767 163.063 278 153.33 278ZM150.83 265.6C159.83 265.6 167.096 262.167 172.63 255.3C178.23 248.433 181.03 237.633 181.03 222.9C181.03 210.5 178.463 200.767 173.33 193.7C168.196 186.633 160.563 183.1 150.43 183.1C143.03 183.1 137.096 184.7 132.63 187.9C128.163 191.033 124.896 195.567 122.83 201.5C120.83 207.433 119.796 214.567 119.73 222.9C119.73 237.967 122.096 248.867 126.83 255.6C131.563 262.267 139.563 265.6 150.83 265.6ZM252.884 170.6C260.018 170.6 266.484 171.933 272.284 174.6C278.084 177.267 282.884 181.1 286.684 186.1C290.484 191.033 292.918 197 293.984 204H279.684C279.018 200.133 277.518 196.667 275.184 193.6C272.851 190.467 269.784 188 265.984 186.2C262.251 184.4 257.918 183.5 252.984 183.5C243.584 183.5 235.918 186.867 229.984 193.6C224.118 200.267 221.184 210.567 221.184 224.5C221.184 236.967 223.851 246.967 229.184 254.5C234.584 261.967 242.584 265.7 253.184 265.7C258.118 265.7 262.451 264.8 266.184 263C269.984 261.133 273.051 258.667 275.384 255.6C277.718 252.467 279.184 249.033 279.784 245.3H293.884C292.884 252.1 290.451 257.967 286.584 262.9C282.718 267.767 277.884 271.5 272.084 274.1C266.351 276.7 259.951 278 252.884 278C243.684 278 235.551 276 228.484 272C221.418 268 215.884 262.033 211.884 254.1C207.951 246.167 205.984 236.333 205.984 224.6C205.984 213.867 207.784 204.467 211.384 196.4C214.984 188.267 220.251 181.933 227.184 177.4C234.184 172.867 242.751 170.6 252.884 170.6ZM358.45 217.9V230.6L308.75 230.7V218L358.45 217.9ZM376.859 276V172.6H391.659V191.3C393.393 186.433 395.826 182.5 398.959 179.5C402.159 176.433 405.726 174.2 409.659 172.8C413.659 171.333 417.693 170.6 421.759 170.6C423.426 170.6 425.059 170.733 426.659 171C428.259 171.2 429.526 171.567 430.459 172.1V187.3C429.393 186.767 427.959 186.4 426.159 186.2C424.426 186 422.959 185.9 421.759 185.9C418.093 185.7 414.526 185.967 411.059 186.7C407.593 187.433 404.426 188.733 401.559 190.6C398.759 192.467 396.526 194.967 394.859 198.1C393.259 201.233 392.459 205.067 392.459 209.6V276H376.859ZM478.241 278C471.041 278 464.407 276.9 458.341 274.7C452.341 272.433 447.374 269 443.441 264.4C439.574 259.733 437.141 253.8 436.141 246.6H450.641C451.574 250.733 453.274 254.233 455.741 257.1C458.207 259.967 461.341 262.167 465.141 263.7C469.007 265.167 473.374 265.9 478.241 265.9C485.574 265.9 491.474 264.5 495.941 261.7C500.407 258.833 502.641 254.467 502.641 248.6C502.641 244.533 501.474 241.267 499.141 238.8C496.874 236.333 493.407 234.533 488.741 233.4L466.441 227.7C458.307 225.633 451.841 222.533 447.041 218.4C442.241 214.2 439.807 208.367 439.741 200.9C439.741 194.967 441.141 189.733 443.941 185.2C446.807 180.667 451.074 177.1 456.741 174.5C462.407 171.9 469.507 170.6 478.041 170.6C488.907 170.6 497.674 173.033 504.341 177.9C511.007 182.767 514.541 190.033 514.941 199.7H500.741C500.074 194.433 497.807 190.267 493.941 187.2C490.074 184.067 484.741 182.5 477.941 182.5C470.941 182.5 465.241 183.933 460.841 186.8C456.507 189.667 454.341 194.1 454.341 200.1C454.341 204.1 455.841 207.233 458.841 209.5C461.841 211.7 466.207 213.533 471.941 215L493.741 220.7C498.274 221.9 502.007 223.5 504.941 225.5C507.941 227.433 510.307 229.633 512.041 232.1C513.841 234.5 515.107 237.067 515.841 239.8C516.641 242.533 517.041 245.167 517.041 247.7C517.041 253.9 515.541 259.267 512.541 263.8C509.541 268.333 505.141 271.833 499.341 274.3C493.607 276.767 486.574 278 478.241 278Z" fill="black"/>
+<defs>
+<clipPath id="clip0_1401_1739">
+<rect width="205" height="122" fill="white" transform="translate(1016 419)"/>
+</clipPath>
+</defs>
+</svg>

From a4a5f78405bd3a28c060df6c65438edf0b02e9e2 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 4 Oct 2023 11:58:28 -0700
Subject: [PATCH 035/182] imp: enhance IBC query methods usability and code
 organization (#897)

* imp: enhance IBC query methods usability and code organization

* docs: update contributing.md

* fix: include ibc-query in the workspace

* docs: add docstring for query modules
---
 ...896-enhance-ibc-query-methods-usability.md |   4 +
 CONTRIBUTING.md                               |  19 +-
 Cargo.toml                                    |   1 +
 crates/ibc-query/Cargo.toml                   |  24 +
 crates/ibc-query/LICENSE                      | 202 +++++++
 crates/ibc-query/README.md                    |   7 +
 crates/ibc-query/src/core/channel/mod.rs      |   5 +
 crates/ibc-query/src/core/channel/query.rs    | 538 +++++++++++++++++
 crates/ibc-query/src/core/channel/service.rs  | 196 ++++++
 crates/ibc-query/src/core/client/mod.rs       |   5 +
 crates/ibc-query/src/core/client/query.rs     | 240 ++++++++
 crates/ibc-query/src/core/client/service.rs   | 156 +++++
 crates/ibc-query/src/core/connection/mod.rs   |   5 +
 crates/ibc-query/src/core/connection/query.rs | 195 ++++++
 .../ibc-query/src/core/connection/service.rs  | 112 ++++
 .../src}/core/context.rs                      |  16 +-
 .../services => ibc-query/src}/core/mod.rs    |   0
 crates/ibc-query/src/error.rs                 |  46 ++
 .../services/mod.rs => ibc-query/src/lib.rs}  |   4 +-
 crates/ibc/Cargo.toml                         |   3 -
 crates/ibc/src/lib.rs                         |   5 +-
 crates/ibc/src/services/core/channel.rs       | 559 ------------------
 crates/ibc/src/services/core/client.rs        | 298 ----------
 crates/ibc/src/services/core/connection.rs    | 227 -------
 crates/ibc/src/services/error.rs              |  18 -
 25 files changed, 1758 insertions(+), 1127 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md
 create mode 100644 crates/ibc-query/Cargo.toml
 create mode 100644 crates/ibc-query/LICENSE
 create mode 100644 crates/ibc-query/README.md
 create mode 100644 crates/ibc-query/src/core/channel/mod.rs
 create mode 100644 crates/ibc-query/src/core/channel/query.rs
 create mode 100644 crates/ibc-query/src/core/channel/service.rs
 create mode 100644 crates/ibc-query/src/core/client/mod.rs
 create mode 100644 crates/ibc-query/src/core/client/query.rs
 create mode 100644 crates/ibc-query/src/core/client/service.rs
 create mode 100644 crates/ibc-query/src/core/connection/mod.rs
 create mode 100644 crates/ibc-query/src/core/connection/query.rs
 create mode 100644 crates/ibc-query/src/core/connection/service.rs
 rename crates/{ibc/src/services => ibc-query/src}/core/context.rs (87%)
 rename crates/{ibc/src/services => ibc-query/src}/core/mod.rs (100%)
 create mode 100644 crates/ibc-query/src/error.rs
 rename crates/{ibc/src/services/mod.rs => ibc-query/src/lib.rs} (95%)
 delete mode 100644 crates/ibc/src/services/core/channel.rs
 delete mode 100644 crates/ibc/src/services/core/client.rs
 delete mode 100644 crates/ibc/src/services/core/connection.rs
 delete mode 100644 crates/ibc/src/services/error.rs

diff --git a/.changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md b/.changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md
new file mode 100644
index 000000000..0f785755d
--- /dev/null
+++ b/.changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md
@@ -0,0 +1,4 @@
+- Enhance IBC query methods usability and code organization
+  - The implementation of query methods is now publicly accessible as standalone functions.
+  - `grpc` feature now lives as a separate crate called as `ibc-query`
+  ([#896](https://github.com/cosmos/ibc-rs/issues/896))
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index a73a2d289..d7429ccfc 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -254,8 +254,8 @@ Our release process is as follows:
 3. If there were changes in the `ibc-derive` crate, we need to publish a new version of that crate.
    1. bump the version in `crates/ibc-derive/Cargo.toml`
    2. Publish `ibc-derive` with `cargo publish -p ibc-derive`
-4. Bump all relevant versions in `crates/ibc/Cargo.toml` to the new version and
-      push these changes to the release PR.
+4. Bump the versions of relevant crates (`ibc` and `ibc-query`) in their
+   `Cargo.toml` to the new version, and push these changes to the release PR.
       + If you released a new version of `ibc-derive` in step 3, make sure to update that dependency.
 5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all the
    documentation compiles and seems up-to-date and coherent. Fix any potential
@@ -264,12 +264,13 @@ Our release process is as follows:
    any potential issues here and push them to the release PR.
 7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
 8. Once approved, merge the PR, and pull the `main` branch.
-9. Run `cargo publish -p ibc`
-9. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the tag
-   message, write the version and the link to the corresponding section of the
-   changelog.
-   + Push the tag with `git push --tags`
-10. Once the tag is pushed, create a GitHub release and append
+9. Run `cargo publish -p ibc` and `cargo publish -p ibc-query` to publish the crates.
+10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
+   tag message, write the version and the link to the corresponding section of
+   the changelog.
+       + Push the tag with `git push --tags`
+11. Once the tag is pushed, create a GitHub release and append
    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)` 
    to the release description.
-11. All done! 🎉
+
+All done! 🎉
diff --git a/Cargo.toml b/Cargo.toml
index 9e05bd35d..d1fa2ad83 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,6 +5,7 @@ resolver = "2"
 members = [
     "crates/ibc",
     "crates/ibc-derive",
+    "crates/ibc-query",
 ]
 
 exclude = [
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
new file mode 100644
index 000000000..672928281
--- /dev/null
+++ b/crates/ibc-query/Cargo.toml
@@ -0,0 +1,24 @@
+[package]
+name         = "ibc-query"
+version      = "0.45.0"
+edition      = "2021"
+license      = "Apache-2.0"
+readme       = "README.md"
+keywords     = ["blockchain", "cosmos", "ibc", "rpc", "grpc"]
+repository   = "https://github.com/cosmos/ibc-rs"
+authors      = ["Informal Systems <hello@informal.systems>"]
+rust-version = "1.60"
+description  = """
+    'ibc-query' contains essential IBC query methods and 
+    gRPC query service implementations for the IBC core.
+"""
+
+[features]
+default = ["std"]
+std = ["ibc-proto/std", "ibc/std"]
+
+[dependencies]
+ibc = { version = "0.45.0", path = "../ibc", default-features = false }
+ibc-proto = { version = "0.35.0", default-features = false, features = ["server"] }
+displaydoc = { version = "0.2", default-features = false }
+tonic = "0.9"
\ No newline at end of file
diff --git a/crates/ibc-query/LICENSE b/crates/ibc-query/LICENSE
new file mode 100644
index 000000000..58b61ab0f
--- /dev/null
+++ b/crates/ibc-query/LICENSE
@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2020 Informal Systems
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
diff --git a/crates/ibc-query/README.md b/crates/ibc-query/README.md
new file mode 100644
index 000000000..346b79544
--- /dev/null
+++ b/crates/ibc-query/README.md
@@ -0,0 +1,7 @@
+# ibc-query
+
+This crate provides a set of utility traits and implementations for querying the
+state of an IBC-enabled chain.
+
+Implementations contains essential IBC query methods and gRPC query service
+for the IBC core client, connection, and channel components.
diff --git a/crates/ibc-query/src/core/channel/mod.rs b/crates/ibc-query/src/core/channel/mod.rs
new file mode 100644
index 000000000..b24e36180
--- /dev/null
+++ b/crates/ibc-query/src/core/channel/mod.rs
@@ -0,0 +1,5 @@
+mod query;
+mod service;
+
+pub use query::*;
+pub use service::*;
diff --git a/crates/ibc-query/src/core/channel/query.rs b/crates/ibc-query/src/core/channel/query.rs
new file mode 100644
index 000000000..48eef8463
--- /dev/null
+++ b/crates/ibc-query/src/core/channel/query.rs
@@ -0,0 +1,538 @@
+//! Provides utility functions for querying IBC channel states.
+
+use alloc::format;
+use core::str::FromStr;
+
+use ibc::core::ics04_channel::packet::Sequence;
+use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use ibc::core::ics24_host::path::{
+    AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
+    ReceiptPath, SeqRecvPath, SeqSendPath,
+};
+use ibc::core::ValidationContext;
+use ibc::Height;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::channel::v1::{
+    PacketState, QueryChannelClientStateRequest, QueryChannelClientStateResponse,
+    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
+    QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
+    QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
+    QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
+    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
+    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
+    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
+    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
+    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+};
+use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
+
+use crate::core::context::{ProvableContext, QueryContext};
+use crate::error::QueryError;
+
+/// Queries for a specific IBC channel by the given channel and port ids and
+/// returns the channel end with the associated proof.
+pub fn query_channel<I>(
+    ibc_ctx: &I,
+    request: &QueryChannelRequest,
+) -> Result<QueryChannelResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::ChannelEnd(channel_end_path.clone()))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for channel end path {:?}",
+                channel_end_path
+            ),
+        })?;
+
+    Ok(QueryChannelResponse {
+        channel: Some(channel_end.into()),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all existing IBC channels and returns the corresponding channel ends
+pub fn query_channels<I>(
+    ibc_ctx: &I,
+    _request: &QueryChannelsRequest,
+) -> Result<QueryChannelsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let channel_ends = ibc_ctx.channel_ends()?;
+
+    Ok(QueryChannelsResponse {
+        channels: channel_ends.into_iter().map(Into::into).collect(),
+        height: Some(ibc_ctx.host_height()?.into()),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for all channels associated with a given connection
+pub fn query_connection_channels<I>(
+    ibc_ctx: &I,
+    request: &QueryConnectionChannelsRequest,
+) -> Result<QueryConnectionChannelsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let connection_id = ConnectionId::from_str(request.connection.as_str())?;
+
+    let all_channel_ends = ibc_ctx.channel_ends()?;
+
+    let connection_channel_ends = all_channel_ends
+        .into_iter()
+        .filter(|channel_end| {
+            channel_end
+                .channel_end
+                .connection_hops()
+                .iter()
+                .any(|connection_hop| connection_hop == &connection_id)
+        })
+        .map(Into::into)
+        .collect();
+
+    Ok(QueryConnectionChannelsResponse {
+        channels: connection_channel_ends,
+        height: Some(ibc_ctx.host_height()?.into()),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for the client state associated with a channel by the given channel
+/// and port ids
+pub fn query_channel_client_state<I>(
+    ibc_ctx: &I,
+    request: &QueryChannelClientStateRequest,
+) -> Result<QueryChannelClientStateResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
+
+    let connection_end = channel_end
+        .connection_hops()
+        .first()
+        .map(|connection_id| ibc_ctx.connection_end(connection_id))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Channel {} does not have a connection", channel_id),
+        })??;
+
+    let client_state = ibc_ctx.client_state(connection_end.client_id())?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for client state path: {:?}",
+                connection_end.client_id()
+            ),
+        })?;
+
+    Ok(QueryChannelClientStateResponse {
+        identified_client_state: Some(IdentifiedClientState {
+            client_id: connection_end.client_id().as_str().into(),
+            client_state: Some(client_state.into()),
+        }),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the consensus state associated with a channel by the given
+/// target height, channel and port ids
+pub fn query_channel_consensus_state<I>(
+    ibc_ctx: &I,
+    request: &QueryChannelConsensusStateRequest,
+) -> Result<QueryChannelConsensusStateResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let height = Height::new(request.revision_number, request.revision_height)?;
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
+
+    let connection_end = channel_end
+        .connection_hops()
+        .first()
+        .map(|connection_id| ibc_ctx.connection_end(connection_id))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Channel {} does not have a connection", channel_id),
+        })??;
+
+    let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+
+    let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientConsensusState(consensus_path.clone()),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for client consensus state path: {:?}",
+                consensus_path
+            ),
+        })?;
+
+    Ok(QueryChannelConsensusStateResponse {
+        client_id: connection_end.client_id().as_str().into(),
+        consensus_state: Some(consensus_state.into()),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the packet commitment associated with a channel by the given
+/// sequence, channel and port ids
+pub fn query_packet_commitment<I>(
+    ibc_ctx: &I,
+    request: &QueryPacketCommitmentRequest,
+) -> Result<QueryPacketCommitmentResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let sequence = Sequence::from(request.sequence);
+
+    let commitment_path = CommitmentPath::new(&port_id, &channel_id, sequence);
+
+    let packet_commitment_data = ibc_ctx.get_packet_commitment(&commitment_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::Commitment(commitment_path.clone()))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for packet commitment path: {:?}",
+                commitment_path
+            ),
+        })?;
+
+    Ok(QueryPacketCommitmentResponse {
+        commitment: packet_commitment_data.into_vec(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all packet commitments associated with a channel
+pub fn query_packet_commitments<I>(
+    ibc_ctx: &I,
+    request: &QueryPacketCommitmentsRequest,
+) -> Result<QueryPacketCommitmentsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let commitments = ibc_ctx
+        .packet_commitments(&channel_end_path)?
+        .into_iter()
+        .map(|path| {
+            ibc_ctx
+                .get_packet_commitment(&path)
+                .map(|commitment| PacketState {
+                    port_id: path.port_id.as_str().into(),
+                    channel_id: path.channel_id.as_str().into(),
+                    sequence: path.sequence.into(),
+                    data: commitment.into_vec(),
+                })
+        })
+        .collect::<Result<_, _>>()?;
+
+    Ok(QueryPacketCommitmentsResponse {
+        commitments,
+        height: Some(ibc_ctx.host_height()?.into()),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for the packet receipt associated with a channel by the given
+/// sequence, channel and port ids
+pub fn query_packet_receipt<I>(
+    ibc_ctx: &I,
+    request: &QueryPacketReceiptRequest,
+) -> Result<QueryPacketReceiptResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let sequence = Sequence::from(request.sequence);
+
+    let receipt_path = ReceiptPath::new(&port_id, &channel_id, sequence);
+
+    // Receipt only has one enum
+    // Unreceived packets are not stored
+    let packet_receipt_data = ibc_ctx.get_packet_receipt(&receipt_path);
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::Receipt(receipt_path.clone()))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for packet receipt path: {:?}",
+                receipt_path
+            ),
+        })?;
+
+    Ok(QueryPacketReceiptResponse {
+        received: packet_receipt_data.is_ok(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the packet acknowledgement associated with a channel by the
+/// given sequence, channel and port ids
+pub fn query_packet_acknowledgement<I>(
+    ibc_ctx: &I,
+    request: &QueryPacketAcknowledgementRequest,
+) -> Result<QueryPacketAcknowledgementResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let sequence = Sequence::from(request.sequence);
+
+    let acknowledgement_path = AckPath::new(&port_id, &channel_id, sequence);
+
+    let packet_acknowledgement_data = ibc_ctx.get_packet_acknowledgement(&acknowledgement_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::Ack(acknowledgement_path.clone()))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for packet acknowledgement path: {:?}",
+                acknowledgement_path
+            ),
+        })?;
+
+    Ok(QueryPacketAcknowledgementResponse {
+        acknowledgement: packet_acknowledgement_data.into_vec(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all packet acknowledgements associated with a channel
+pub fn query_packet_acknowledgements<I>(
+    ibc_ctx: &I,
+    request: &QueryPacketAcknowledgementsRequest,
+) -> Result<QueryPacketAcknowledgementsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let commitment_sequences = request
+        .packet_commitment_sequences
+        .iter()
+        .copied()
+        .map(Sequence::from);
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let acknowledgements = ibc_ctx
+        .packet_acknowledgements(&channel_end_path, commitment_sequences)?
+        .into_iter()
+        .map(|path| {
+            ibc_ctx
+                .get_packet_acknowledgement(&path)
+                .map(|acknowledgement| PacketState {
+                    port_id: path.port_id.as_str().into(),
+                    channel_id: path.channel_id.as_str().into(),
+                    sequence: path.sequence.into(),
+                    data: acknowledgement.into_vec(),
+                })
+        })
+        .collect::<Result<_, _>>()?;
+
+    Ok(QueryPacketAcknowledgementsResponse {
+        acknowledgements,
+        height: Some(ibc_ctx.host_height()?.into()),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for all unreceived packets associated with a channel
+pub fn query_unreceived_packets<I>(
+    ibc_ctx: &I,
+    request: &QueryUnreceivedPacketsRequest,
+) -> Result<QueryUnreceivedPacketsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let sequences = request
+        .packet_commitment_sequences
+        .iter()
+        .copied()
+        .map(Sequence::from);
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let unreceived_packets = ibc_ctx.unreceived_packets(&channel_end_path, sequences)?;
+
+    Ok(QueryUnreceivedPacketsResponse {
+        sequences: unreceived_packets.into_iter().map(Into::into).collect(),
+        height: Some(ibc_ctx.host_height()?.into()),
+    })
+}
+
+/// Queries for all unreceived acknowledgements associated with a channel
+pub fn query_unreceived_acks<I>(
+    ibc_ctx: &I,
+    request: &QueryUnreceivedAcksRequest,
+) -> Result<QueryUnreceivedAcksResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let sequences = request
+        .packet_ack_sequences
+        .iter()
+        .copied()
+        .map(Sequence::from);
+
+    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+
+    let unreceived_acks = ibc_ctx.unreceived_acks(&channel_end_path, sequences)?;
+
+    Ok(QueryUnreceivedAcksResponse {
+        sequences: unreceived_acks.into_iter().map(Into::into).collect(),
+        height: Some(ibc_ctx.host_height()?.into()),
+    })
+}
+
+/// Queries for the next sequence send associated with a channel
+pub fn query_next_sequence_send<I>(
+    ibc_ctx: &I,
+    request: &QueryNextSequenceSendRequest,
+) -> Result<QueryNextSequenceSendResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
+
+    let next_sequence_send = ibc_ctx.get_next_sequence_send(&next_seq_send_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Next sequence send proof not found for channel {}",
+                channel_id
+            ),
+        })?;
+
+    Ok(QueryNextSequenceSendResponse {
+        next_sequence_send: next_sequence_send.into(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the next sequence receive associated with a channel
+pub fn query_next_sequence_receive<I>(
+    ibc_ctx: &I,
+    request: &QueryNextSequenceReceiveRequest,
+) -> Result<QueryNextSequenceReceiveResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let next_seq_recv_path = SeqRecvPath::new(&port_id, &channel_id);
+
+    let next_sequence_recv = ibc_ctx.get_next_sequence_recv(&next_seq_recv_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::SeqRecv(next_seq_recv_path))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Next sequence receive proof not found for channel {}",
+                channel_id
+            ),
+        })?;
+
+    Ok(QueryNextSequenceReceiveResponse {
+        next_sequence_receive: next_sequence_recv.into(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
diff --git a/crates/ibc-query/src/core/channel/service.rs b/crates/ibc-query/src/core/channel/service.rs
new file mode 100644
index 000000000..a4f3d2fce
--- /dev/null
+++ b/crates/ibc-query/src/core/channel/service.rs
@@ -0,0 +1,196 @@
+//! [`ChannelQueryService`](ChannelQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use std::boxed::Box;
+
+use ibc::core::ValidationContext;
+use ibc::prelude::*;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
+use ibc_proto::ibc::core::channel::v1::{
+    QueryChannelClientStateRequest, QueryChannelClientStateResponse,
+    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
+    QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
+    QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
+    QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
+    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
+    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
+    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
+    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
+    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+};
+use tonic::{Request, Response, Status};
+
+use super::{
+    query_channel, query_channel_client_state, query_channel_consensus_state, query_channels,
+    query_connection_channels, query_next_sequence_receive, query_next_sequence_send,
+    query_packet_acknowledgement, query_packet_acknowledgements, query_packet_commitment,
+    query_packet_commitments, query_packet_receipt, query_unreceived_acks,
+    query_unreceived_packets,
+};
+use crate::core::context::QueryContext;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// The generic `I` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+}
+
+impl<I> ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I) -> Self {
+        Self { ibc_context }
+    }
+}
+
+#[tonic::async_trait]
+impl<I> ChannelQuery for ChannelQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn channel(
+        &self,
+        request: Request<QueryChannelRequest>,
+    ) -> Result<Response<QueryChannelResponse>, Status> {
+        let response = query_channel(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn channels(
+        &self,
+        request: Request<QueryChannelsRequest>,
+    ) -> Result<Response<QueryChannelsResponse>, Status> {
+        let response = query_channels(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn connection_channels(
+        &self,
+        request: Request<QueryConnectionChannelsRequest>,
+    ) -> Result<Response<QueryConnectionChannelsResponse>, Status> {
+        let response = query_connection_channels(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn channel_client_state(
+        &self,
+        request: Request<QueryChannelClientStateRequest>,
+    ) -> Result<Response<QueryChannelClientStateResponse>, Status> {
+        let response = query_channel_client_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn channel_consensus_state(
+        &self,
+        request: Request<QueryChannelConsensusStateRequest>,
+    ) -> Result<Response<QueryChannelConsensusStateResponse>, Status> {
+        let response = query_channel_consensus_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn packet_commitment(
+        &self,
+        request: Request<QueryPacketCommitmentRequest>,
+    ) -> Result<Response<QueryPacketCommitmentResponse>, Status> {
+        let response = query_packet_commitment(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn packet_commitments(
+        &self,
+        request: Request<QueryPacketCommitmentsRequest>,
+    ) -> Result<Response<QueryPacketCommitmentsResponse>, Status> {
+        let response = query_packet_commitments(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn packet_receipt(
+        &self,
+        request: Request<QueryPacketReceiptRequest>,
+    ) -> Result<Response<QueryPacketReceiptResponse>, Status> {
+        let response = query_packet_receipt(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn packet_acknowledgement(
+        &self,
+        request: Request<QueryPacketAcknowledgementRequest>,
+    ) -> Result<Response<QueryPacketAcknowledgementResponse>, Status> {
+        let response = query_packet_acknowledgement(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    /// Returns all the acknowledgements if sequences is omitted.
+    async fn packet_acknowledgements(
+        &self,
+        request: Request<QueryPacketAcknowledgementsRequest>,
+    ) -> Result<Response<QueryPacketAcknowledgementsResponse>, Status> {
+        let response = query_packet_acknowledgements(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    /// Returns all the unreceived packets if sequences is omitted.
+    async fn unreceived_packets(
+        &self,
+        request: Request<QueryUnreceivedPacketsRequest>,
+    ) -> Result<Response<QueryUnreceivedPacketsResponse>, Status> {
+        let response = query_unreceived_packets(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    /// Returns all the unreceived acknowledgements if sequences is omitted.
+    async fn unreceived_acks(
+        &self,
+        request: Request<QueryUnreceivedAcksRequest>,
+    ) -> Result<Response<QueryUnreceivedAcksResponse>, Status> {
+        let response = query_unreceived_acks(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn next_sequence_send(
+        &self,
+        request: Request<QueryNextSequenceSendRequest>,
+    ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
+        let response = query_next_sequence_send(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn next_sequence_receive(
+        &self,
+        request: Request<QueryNextSequenceReceiveRequest>,
+    ) -> Result<Response<QueryNextSequenceReceiveResponse>, Status> {
+        let response = query_next_sequence_receive(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+}
diff --git a/crates/ibc-query/src/core/client/mod.rs b/crates/ibc-query/src/core/client/mod.rs
new file mode 100644
index 000000000..b24e36180
--- /dev/null
+++ b/crates/ibc-query/src/core/client/mod.rs
@@ -0,0 +1,5 @@
+mod query;
+mod service;
+
+pub use query::*;
+pub use service::*;
diff --git a/crates/ibc-query/src/core/client/query.rs b/crates/ibc-query/src/core/client/query.rs
new file mode 100644
index 000000000..0f0923eba
--- /dev/null
+++ b/crates/ibc-query/src/core/client/query.rs
@@ -0,0 +1,240 @@
+//! Provides utility functions for querying IBC client states.
+
+use alloc::format;
+use core::str::FromStr;
+
+use ibc::core::ics02_client::client_state::ClientStateValidation;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::ics24_host::path::{
+    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
+};
+use ibc::core::ValidationContext;
+use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
+use ibc::Height;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::client::v1::{
+    ConsensusStateWithHeight, IdentifiedClientState, QueryClientStateRequest,
+    QueryClientStateResponse, QueryClientStatesRequest, QueryClientStatesResponse,
+    QueryClientStatusRequest, QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
+    QueryConsensusStateHeightsResponse, QueryConsensusStateRequest, QueryConsensusStateResponse,
+    QueryConsensusStatesRequest, QueryConsensusStatesResponse, QueryUpgradedClientStateRequest,
+    QueryUpgradedClientStateResponse, QueryUpgradedConsensusStateRequest,
+    QueryUpgradedConsensusStateResponse,
+};
+
+use crate::core::context::{ProvableContext, QueryContext};
+use crate::error::QueryError;
+
+/// Queries for the client state of a given client id.
+pub fn query_client_state<I>(
+    ibc_ctx: &I,
+    request: &QueryClientStateRequest,
+) -> Result<QueryClientStateResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let client_state = ibc_ctx.client_state(&client_id)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientState(ClientStatePath::new(&client_id)),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Proof not found for client state path: {client_id:?}"),
+        })?;
+
+    Ok(QueryClientStateResponse {
+        client_state: Some(client_state.into()),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all the existing client states.
+pub fn query_client_states<I>(
+    ibc_ctx: &I,
+    _request: &QueryClientStatesRequest,
+) -> Result<QueryClientStatesResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+{
+    let client_states = ibc_ctx.client_states()?;
+
+    Ok(QueryClientStatesResponse {
+        client_states: client_states
+            .into_iter()
+            .map(|(id, state)| IdentifiedClientState {
+                client_id: id.into(),
+                client_state: Some(state.into()),
+            })
+            .collect(),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for the consensus state of a given client id and height.
+pub fn query_consensus_state<I>(
+    ibc_ctx: &I,
+    request: &QueryConsensusStateRequest,
+) -> Result<QueryConsensusStateResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let (height, consensus_state) = if request.latest_height {
+        ibc_ctx
+            .consensus_states(&client_id)?
+            .into_iter()
+            .max_by_key(|(h, _)| *h)
+            .ok_or(QueryError::ProofNotFound {
+                description: format!("No consensus state found for client: {client_id:?}"),
+            })?
+    } else {
+        let height = Height::new(request.revision_number, request.revision_height)?;
+
+        let consensus_state =
+            ibc_ctx.consensus_state(&ClientConsensusStatePath::new(&client_id, &height))?;
+
+        (height, consensus_state)
+    };
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientConsensusState(ClientConsensusStatePath::new(&client_id, &height)),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Proof not found for consensus state path: {client_id:?}"),
+        })?;
+
+    Ok(QueryConsensusStateResponse {
+        consensus_state: Some(consensus_state.into()),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all the consensus states of a given client id.
+pub fn query_consensus_states<I>(
+    ibc_ctx: &I,
+    request: &QueryConsensusStatesRequest,
+) -> Result<QueryConsensusStatesResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let consensus_states = ibc_ctx.consensus_states(&client_id)?;
+
+    Ok(QueryConsensusStatesResponse {
+        consensus_states: consensus_states
+            .into_iter()
+            .map(|(height, state)| ConsensusStateWithHeight {
+                height: Some(height.into()),
+                consensus_state: Some(state.into()),
+            })
+            .collect(),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for the heights of all the consensus states of a given client id.
+pub fn query_consensus_state_heights<I>(
+    ibc_ctx: &I,
+    request: &QueryConsensusStateHeightsRequest,
+) -> Result<QueryConsensusStateHeightsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let consensus_state_heights = ibc_ctx.consensus_state_heights(&client_id)?;
+
+    Ok(QueryConsensusStateHeightsResponse {
+        consensus_state_heights: consensus_state_heights
+            .into_iter()
+            .map(|height| height.into())
+            .collect(),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for the status (Active, Frozen, Expired, Unauthorized) of a given client.
+pub fn query_client_status<I>(
+    ibc_ctx: &I,
+    request: &QueryClientStatusRequest,
+) -> Result<QueryClientStatusResponse, QueryError>
+where
+    I: ValidationContext,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let client_state = ibc_ctx.client_state(&client_id)?;
+    let client_validation_ctx = ibc_ctx.get_client_validation_context();
+    let client_status = client_state.status(client_validation_ctx, &client_id)?;
+
+    Ok(QueryClientStatusResponse {
+        status: format!("{client_status}"),
+    })
+}
+
+/// Queries for the upgraded client state.
+pub fn query_upgraded_client_state<U>(
+    upgrade_ctx: &U,
+    _request: &QueryUpgradedClientStateRequest,
+) -> Result<QueryUpgradedClientStateResponse, QueryError>
+where
+    U: UpgradeValidationContext,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+{
+    let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
+
+    let upgraded_client_state_path = UpgradeClientPath::UpgradedClientState(plan.height);
+
+    let upgraded_client_state = upgrade_ctx
+        .upgraded_client_state(&upgraded_client_state_path)
+        .map_err(ClientError::from)?;
+
+    Ok(QueryUpgradedClientStateResponse {
+        upgraded_client_state: Some(upgraded_client_state.into()),
+    })
+}
+
+/// Queries for the upgraded consensus state.
+pub fn query_upgraded_consensus_state<U>(
+    upgrade_ctx: &U,
+    _request: &QueryUpgradedConsensusStateRequest,
+) -> Result<QueryUpgradedConsensusStateResponse, QueryError>
+where
+    U: UpgradeValidationContext,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
+
+    let upgraded_consensus_state_path =
+        UpgradeClientPath::UpgradedClientConsensusState(plan.height);
+
+    let upgraded_consensus_state = upgrade_ctx
+        .upgraded_consensus_state(&upgraded_consensus_state_path)
+        .map_err(ClientError::from)?;
+
+    Ok(QueryUpgradedConsensusStateResponse {
+        upgraded_consensus_state: Some(upgraded_consensus_state.into()),
+    })
+}
diff --git a/crates/ibc-query/src/core/client/service.rs b/crates/ibc-query/src/core/client/service.rs
new file mode 100644
index 000000000..d6612cf2e
--- /dev/null
+++ b/crates/ibc-query/src/core/client/service.rs
@@ -0,0 +1,156 @@
+//! [`ClientQueryService`](ClientQueryService) takes generics `I` and `U` to store `ibc_context` and `upgrade_context` that implement [`QueryContext`](QueryContext) and [`UpgradeValidationContext`](UpgradeValidationContext) respectively.
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use std::boxed::Box;
+
+use ibc::core::ValidationContext;
+use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
+use ibc::prelude::*;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::client::v1::query_server::Query as ClientQuery;
+use ibc_proto::ibc::core::client::v1::{
+    QueryClientParamsRequest, QueryClientParamsResponse, QueryClientStateRequest,
+    QueryClientStateResponse, QueryClientStatesRequest, QueryClientStatesResponse,
+    QueryClientStatusRequest, QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
+    QueryConsensusStateHeightsResponse, QueryConsensusStateRequest, QueryConsensusStateResponse,
+    QueryConsensusStatesRequest, QueryConsensusStatesResponse, QueryUpgradedClientStateRequest,
+    QueryUpgradedClientStateResponse, QueryUpgradedConsensusStateRequest,
+    QueryUpgradedConsensusStateResponse,
+};
+use tonic::{Request, Response, Status};
+
+use super::{
+    query_client_state, query_client_states, query_client_status, query_consensus_state,
+    query_consensus_state_heights, query_consensus_states, query_upgraded_client_state,
+    query_upgraded_consensus_state,
+};
+use crate::core::context::QueryContext;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// Generics `I` and `U` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+    upgrade_context: U,
+}
+
+impl<I, U> ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// Parameters `ibc_context` and `upgrade_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I, upgrade_context: U) -> Self {
+        Self {
+            ibc_context,
+            upgrade_context,
+        }
+    }
+}
+
+#[tonic::async_trait]
+impl<I, U> ClientQuery for ClientQueryService<I, U>
+where
+    I: QueryContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
+    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn client_state(
+        &self,
+        request: Request<QueryClientStateRequest>,
+    ) -> Result<Response<QueryClientStateResponse>, Status> {
+        let response = query_client_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn client_states(
+        &self,
+        request: Request<QueryClientStatesRequest>,
+    ) -> Result<Response<QueryClientStatesResponse>, Status> {
+        let response = query_client_states(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn consensus_state(
+        &self,
+        request: Request<QueryConsensusStateRequest>,
+    ) -> Result<Response<QueryConsensusStateResponse>, Status> {
+        let response = query_consensus_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn consensus_states(
+        &self,
+        request: Request<QueryConsensusStatesRequest>,
+    ) -> Result<Response<QueryConsensusStatesResponse>, Status> {
+        let response = query_consensus_states(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn consensus_state_heights(
+        &self,
+        request: Request<QueryConsensusStateHeightsRequest>,
+    ) -> Result<Response<QueryConsensusStateHeightsResponse>, Status> {
+        let response = query_consensus_state_heights(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn client_status(
+        &self,
+        request: Request<QueryClientStatusRequest>,
+    ) -> Result<Response<QueryClientStatusResponse>, Status> {
+        let response = query_client_status(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn client_params(
+        &self,
+        _request: Request<QueryClientParamsRequest>,
+    ) -> Result<Response<QueryClientParamsResponse>, Status> {
+        Err(Status::unimplemented(
+            "Querying ClientParams is not supported yet",
+        ))
+    }
+
+    async fn upgraded_client_state(
+        &self,
+        request: Request<QueryUpgradedClientStateRequest>,
+    ) -> Result<Response<QueryUpgradedClientStateResponse>, Status> {
+        let response = query_upgraded_client_state(&self.upgrade_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn upgraded_consensus_state(
+        &self,
+        request: Request<QueryUpgradedConsensusStateRequest>,
+    ) -> Result<Response<QueryUpgradedConsensusStateResponse>, Status> {
+        let response = query_upgraded_consensus_state(&self.upgrade_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+}
diff --git a/crates/ibc-query/src/core/connection/mod.rs b/crates/ibc-query/src/core/connection/mod.rs
new file mode 100644
index 000000000..b24e36180
--- /dev/null
+++ b/crates/ibc-query/src/core/connection/mod.rs
@@ -0,0 +1,5 @@
+mod query;
+mod service;
+
+pub use query::*;
+pub use service::*;
diff --git a/crates/ibc-query/src/core/connection/query.rs b/crates/ibc-query/src/core/connection/query.rs
new file mode 100644
index 000000000..4f712b1eb
--- /dev/null
+++ b/crates/ibc-query/src/core/connection/query.rs
@@ -0,0 +1,195 @@
+//! Provides utility functions for querying IBC connection states.
+
+use alloc::format;
+use alloc::vec::Vec;
+use core::str::FromStr;
+
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::ics24_host::path::{
+    ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
+};
+use ibc::core::ValidationContext;
+use ibc::Height;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
+use ibc_proto::ibc::core::connection::v1::{
+    Params as ConnectionParams, QueryClientConnectionsRequest, QueryClientConnectionsResponse,
+    QueryConnectionClientStateRequest, QueryConnectionClientStateResponse,
+    QueryConnectionConsensusStateRequest, QueryConnectionConsensusStateResponse,
+    QueryConnectionParamsRequest, QueryConnectionParamsResponse, QueryConnectionRequest,
+    QueryConnectionResponse, QueryConnectionsRequest, QueryConnectionsResponse,
+};
+
+use crate::core::context::{ProvableContext, QueryContext};
+use crate::error::QueryError;
+
+/// Queries for the connection end of a given connection id.
+pub fn query_connection<I>(
+    ibc_ctx: &I,
+    request: &QueryConnectionRequest,
+) -> Result<QueryConnectionResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
+
+    let connection_end = ibc_ctx.connection_end(&connection_id)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::Connection(ConnectionPath::new(&connection_id)),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Proof not found for connection path: {connection_id:?}"),
+        })?;
+
+    Ok(QueryConnectionResponse {
+        connection: Some(connection_end.into()),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for all the existing connection ends.
+pub fn query_connections<I>(
+    ibc_ctx: &I,
+    _request: &QueryConnectionsRequest,
+) -> Result<QueryConnectionsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    let connections = ibc_ctx.connection_ends()?;
+
+    Ok(QueryConnectionsResponse {
+        connections: connections.into_iter().map(Into::into).collect(),
+        height: Some(ibc_ctx.host_height()?.into()),
+        // no support for pagination yet
+        pagination: None,
+    })
+}
+
+/// Queries for all the existing connection ends for a given client.
+pub fn query_client_connections<I>(
+    ibc_ctx: &I,
+    request: &QueryClientConnectionsRequest,
+) -> Result<QueryClientConnectionsResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+{
+    let client_id = ClientId::from_str(request.client_id.as_str())?;
+
+    let connections = ibc_ctx.client_connection_ends(&client_id)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof: Vec<u8> = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientConnection(ClientConnectionPath::new(&client_id)),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!("Proof not found for client connection path: {client_id:?}"),
+        })?;
+
+    Ok(QueryClientConnectionsResponse {
+        connection_paths: connections.into_iter().map(|x| x.as_str().into()).collect(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the client state of a given connection id.
+pub fn query_connection_client_state<I>(
+    ibc_ctx: &I,
+    request: &QueryConnectionClientStateRequest,
+) -> Result<QueryConnectionClientStateResponse, QueryError>
+where
+    I: QueryContext,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+{
+    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
+
+    let connection_end = ibc_ctx.connection_end(&connection_id)?;
+
+    let client_state = ibc_ctx.client_state(connection_end.client_id())?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(
+            current_height,
+            &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+        )
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for client state path: {:?}",
+                connection_end.client_id()
+            ),
+        })?;
+
+    Ok(QueryConnectionClientStateResponse {
+        identified_client_state: Some(IdentifiedClientState {
+            client_id: connection_end.client_id().as_str().into(),
+            client_state: Some(client_state.into()),
+        }),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the consensus state of a given connection id and height.
+pub fn query_connection_consensus_state<I>(
+    ibc_ctx: &I,
+    request: &QueryConnectionConsensusStateRequest,
+) -> Result<QueryConnectionConsensusStateResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
+
+    let connection_end = ibc_ctx.connection_end(&connection_id)?;
+
+    let height = Height::new(request.revision_number, request.revision_height)?;
+
+    let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+
+    let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Proof not found for consensus state path: {:?}",
+                connection_end.client_id()
+            ),
+        })?;
+
+    Ok(QueryConnectionConsensusStateResponse {
+        consensus_state: Some(consensus_state.into()),
+        client_id: connection_end.client_id().as_str().into(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
+
+/// Queries for the connection parameters.
+pub fn query_connection_params<I>(
+    ibc_ctx: &I,
+    _request: &QueryConnectionParamsRequest,
+) -> Result<QueryConnectionParamsResponse, QueryError>
+where
+    I: QueryContext,
+{
+    Ok(QueryConnectionParamsResponse {
+        params: Some(ConnectionParams {
+            max_expected_time_per_block: ibc_ctx.max_expected_time_per_block().as_secs(),
+        }),
+    })
+}
diff --git a/crates/ibc-query/src/core/connection/service.rs b/crates/ibc-query/src/core/connection/service.rs
new file mode 100644
index 000000000..a14384e34
--- /dev/null
+++ b/crates/ibc-query/src/core/connection/service.rs
@@ -0,0 +1,112 @@
+//! [`ConnectionQueryService`](ConnectionQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
+//! `I` must be a type where writes from one thread are readable from another.
+//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+
+use std::boxed::Box;
+
+use ibc::core::ValidationContext;
+use ibc::prelude::*;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::connection::v1::query_server::Query as ConnectionQuery;
+use ibc_proto::ibc::core::connection::v1::{
+    QueryClientConnectionsRequest, QueryClientConnectionsResponse,
+    QueryConnectionClientStateRequest, QueryConnectionClientStateResponse,
+    QueryConnectionConsensusStateRequest, QueryConnectionConsensusStateResponse,
+    QueryConnectionParamsRequest, QueryConnectionParamsResponse, QueryConnectionRequest,
+    QueryConnectionResponse, QueryConnectionsRequest, QueryConnectionsResponse,
+};
+use tonic::{Request, Response, Status};
+
+use super::{
+    query_client_connections, query_connection, query_connection_client_state,
+    query_connection_consensus_state, query_connection_params, query_connections,
+};
+use crate::core::context::QueryContext;
+
+// TODO(rano): currently the services don't support pagination, so we return all the results.
+
+/// The generic `I` must be a type where writes from one thread are readable from another.
+/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+pub struct ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    ibc_context: I,
+}
+
+impl<I> ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
+    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    pub fn new(ibc_context: I) -> Self {
+        Self { ibc_context }
+    }
+}
+
+#[tonic::async_trait]
+impl<I> ConnectionQuery for ConnectionQueryService<I>
+where
+    I: QueryContext + Send + Sync + 'static,
+    <I as ValidationContext>::AnyClientState: Into<Any>,
+    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+{
+    async fn connection(
+        &self,
+        request: Request<QueryConnectionRequest>,
+    ) -> Result<Response<QueryConnectionResponse>, Status> {
+        let response = query_connection(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn connections(
+        &self,
+        request: Request<QueryConnectionsRequest>,
+    ) -> Result<Response<QueryConnectionsResponse>, Status> {
+        let response = query_connections(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn client_connections(
+        &self,
+        request: Request<QueryClientConnectionsRequest>,
+    ) -> Result<Response<QueryClientConnectionsResponse>, Status> {
+        let response = query_client_connections(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn connection_client_state(
+        &self,
+        request: Request<QueryConnectionClientStateRequest>,
+    ) -> Result<Response<QueryConnectionClientStateResponse>, Status> {
+        let response = query_connection_client_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn connection_consensus_state(
+        &self,
+        request: Request<QueryConnectionConsensusStateRequest>,
+    ) -> Result<Response<QueryConnectionConsensusStateResponse>, Status> {
+        let response = query_connection_consensus_state(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+
+    async fn connection_params(
+        &self,
+        request: Request<QueryConnectionParamsRequest>,
+    ) -> Result<Response<QueryConnectionParamsResponse>, Status> {
+        let response = query_connection_params(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
+}
diff --git a/crates/ibc/src/services/core/context.rs b/crates/ibc-query/src/core/context.rs
similarity index 87%
rename from crates/ibc/src/services/core/context.rs
rename to crates/ibc-query/src/core/context.rs
index 14632f25f..0316f7090 100644
--- a/crates/ibc/src/services/core/context.rs
+++ b/crates/ibc-query/src/core/context.rs
@@ -1,13 +1,13 @@
 //! Required traits for blanket implementations of [`gRPC query services`](crate::services::core).
 
-use crate::core::ics03_connection::connection::IdentifiedConnectionEnd;
-use crate::core::ics04_channel::channel::IdentifiedChannelEnd;
-use crate::core::ics04_channel::packet::Sequence;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{AckPath, ChannelEndPath, CommitmentPath, Path};
-use crate::core::{ContextError, ValidationContext};
-use crate::prelude::*;
-use crate::Height;
+use ibc::core::ics03_connection::connection::IdentifiedConnectionEnd;
+use ibc::core::ics04_channel::channel::IdentifiedChannelEnd;
+use ibc::core::ics04_channel::packet::Sequence;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::ics24_host::path::{AckPath, ChannelEndPath, CommitmentPath, Path};
+use ibc::core::{ContextError, ValidationContext};
+use ibc::prelude::*;
+use ibc::Height;
 
 /// Context to be implemented by the host to provide proofs in gRPC query responses
 ///
diff --git a/crates/ibc/src/services/core/mod.rs b/crates/ibc-query/src/core/mod.rs
similarity index 100%
rename from crates/ibc/src/services/core/mod.rs
rename to crates/ibc-query/src/core/mod.rs
diff --git a/crates/ibc-query/src/error.rs b/crates/ibc-query/src/error.rs
new file mode 100644
index 000000000..47670d293
--- /dev/null
+++ b/crates/ibc-query/src/error.rs
@@ -0,0 +1,46 @@
+use displaydoc::Display;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics24_host::identifier::IdentifierError;
+use ibc::core::ContextError;
+use tonic::Status;
+
+#[derive(Debug, Display)]
+pub enum QueryError {
+    /// Context error: {0}
+    ContextError(ContextError),
+    /// Client error: {0}
+    ClientError(ClientError),
+    /// Identifier error: {0}
+    IdentifierError(IdentifierError),
+    /// Proof not found: {description}
+    ProofNotFound { description: String },
+}
+
+impl From<QueryError> for Status {
+    fn from(e: QueryError) -> Self {
+        match e {
+            QueryError::ContextError(e) => Status::internal(e.to_string()),
+            QueryError::ClientError(e) => Status::internal(e.to_string()),
+            QueryError::IdentifierError(e) => Status::internal(e.to_string()),
+            QueryError::ProofNotFound { description } => Status::not_found(description),
+        }
+    }
+}
+
+impl From<ContextError> for QueryError {
+    fn from(e: ContextError) -> Self {
+        QueryError::ContextError(e)
+    }
+}
+
+impl From<ClientError> for QueryError {
+    fn from(e: ClientError) -> Self {
+        QueryError::ClientError(e)
+    }
+}
+
+impl From<IdentifierError> for QueryError {
+    fn from(e: IdentifierError) -> Self {
+        QueryError::IdentifierError(e)
+    }
+}
diff --git a/crates/ibc/src/services/mod.rs b/crates/ibc-query/src/lib.rs
similarity index 95%
rename from crates/ibc/src/services/mod.rs
rename to crates/ibc-query/src/lib.rs
index d90ad3055..bccac04d8 100644
--- a/crates/ibc/src/services/mod.rs
+++ b/crates/ibc-query/src/lib.rs
@@ -1,4 +1,4 @@
-//! Implementation of the gRPC services of core IBC components.
+//! Implementation of the gRPC query services of core IBC components.
 //!
 //! The provided structs includes blanket implementation of their corresponding gRPC service traits,
 //! if the host implements the following _context_ traits.
@@ -44,5 +44,7 @@
 //!       .serve(addr);
 //! ```
 
+extern crate alloc;
+
 pub mod core;
 pub mod error;
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 8e747ab98..0f8a9b063 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -37,8 +37,6 @@ std = [
 ]
 parity-scale-codec = ["dep:parity-scale-codec", "dep:scale-info", "ibc-proto/parity-scale-codec"]
 borsh = ["dep:borsh", "ibc-proto/borsh"]
-# includes gRPC services for IBC core
-grpc = ["dep:tonic", "ibc-proto/server"]
 
 # This feature is required for token transfer (ICS-20)
 serde = ["dep:serde", "dep:serde_derive", "serde_json", "ics23/serde"]
@@ -68,7 +66,6 @@ num-traits = { version = "0.2.15", default-features = false }
 derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
 uint = { version = "0.9", default-features = false }
 primitive-types = { version = "0.12.0", default-features = false, features = ["serde_no_std"] }
-tonic = { version = "0.9", optional = true }
 
 ## for codec encode or decode
 parity-scale-codec = { version = "3.0.0", default-features = false, features = ["full"], optional = true }
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 46b9c3a53..7f0866c80 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -54,15 +54,12 @@ pub mod clients;
 pub mod core;
 pub mod hosts;
 
-#[cfg(feature = "grpc")]
-pub mod services;
-
 #[cfg(any(test, feature = "mocks"))]
 pub mod mock;
 #[cfg(any(test, feature = "mocks"))]
 pub mod test_utils; // Context mock, the underlying host chain, and client types: for testing all handlers.
 
-mod prelude;
+pub mod prelude;
 mod signer;
 mod utils;
 
diff --git a/crates/ibc/src/services/core/channel.rs b/crates/ibc/src/services/core/channel.rs
deleted file mode 100644
index 3442f569d..000000000
--- a/crates/ibc/src/services/core/channel.rs
+++ /dev/null
@@ -1,559 +0,0 @@
-//! [`ChannelQueryService`](ChannelQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
-//! `I` must be a type where writes from one thread are readable from another.
-//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-
-use alloc::str::FromStr;
-use std::boxed::Box;
-
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
-use ibc_proto::ibc::core::channel::v1::{
-    PacketState, QueryChannelClientStateRequest, QueryChannelClientStateResponse,
-    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
-    QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
-    QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
-    QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
-    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
-    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
-    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
-    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
-    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
-    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
-};
-use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
-use tonic::{Request, Response, Status};
-
-use crate::core::ics04_channel::packet::Sequence;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::ics24_host::path::{
-    AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
-    ReceiptPath, SeqRecvPath, SeqSendPath,
-};
-use crate::core::ValidationContext;
-use crate::prelude::*;
-use crate::services::core::context::QueryContext;
-use crate::Height;
-
-// TODO(rano): currently the services don't support pagination, so we return all the results.
-
-/// The generic `I` must be a type where writes from one thread are readable from another.
-/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-pub struct ChannelQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    ibc_context: I,
-}
-
-impl<I> ChannelQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
-    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-    pub fn new(ibc_context: I) -> Self {
-        Self { ibc_context }
-    }
-}
-
-#[tonic::async_trait]
-impl<I> ChannelQuery for ChannelQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    async fn channel(
-        &self,
-        request: Request<QueryChannelRequest>,
-    ) -> Result<Response<QueryChannelResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::ChannelEnd(channel_end_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Channel end proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryChannelResponse {
-            channel: Some(channel_end.into()),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn channels(
-        &self,
-        _request: Request<QueryChannelsRequest>,
-    ) -> Result<Response<QueryChannelsResponse>, Status> {
-        let channel_ends = self.ibc_context.channel_ends()?;
-
-        Ok(Response::new(QueryChannelsResponse {
-            channels: channel_ends.into_iter().map(Into::into).collect(),
-            height: Some(self.ibc_context.host_height()?.into()),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn connection_channels(
-        &self,
-        request: Request<QueryConnectionChannelsRequest>,
-    ) -> Result<Response<QueryConnectionChannelsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let connection_id = ConnectionId::from_str(request_ref.connection.as_str())?;
-
-        let all_channel_ends = self.ibc_context.channel_ends()?;
-
-        let connection_channel_ends = all_channel_ends
-            .into_iter()
-            .filter(|channel_end| {
-                channel_end
-                    .channel_end
-                    .connection_hops()
-                    .iter()
-                    .any(|connection_hop| connection_hop == &connection_id)
-            })
-            .map(Into::into)
-            .collect();
-
-        Ok(Response::new(QueryConnectionChannelsResponse {
-            channels: connection_channel_ends,
-            height: Some(self.ibc_context.host_height()?.into()),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn channel_client_state(
-        &self,
-        request: Request<QueryChannelClientStateRequest>,
-    ) -> Result<Response<QueryChannelClientStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
-
-        let connection_end = channel_end
-            .connection_hops()
-            .first()
-            .map(|connection_id| self.ibc_context.connection_end(connection_id))
-            .ok_or_else(|| {
-                Status::not_found(format!("Channel {} has no connection hops", channel_id))
-            })??;
-
-        let client_state = self.ibc_context.client_state(connection_end.client_id())?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Client state proof not found for client {}",
-                    connection_end.client_id()
-                ))
-            })?;
-
-        Ok(Response::new(QueryChannelClientStateResponse {
-            identified_client_state: Some(IdentifiedClientState {
-                client_id: connection_end.client_id().as_str().into(),
-                client_state: Some(client_state.into()),
-            }),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn channel_consensus_state(
-        &self,
-        request: Request<QueryChannelConsensusStateRequest>,
-    ) -> Result<Response<QueryChannelConsensusStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let height = Height::new(request_ref.revision_number, request_ref.revision_height)
-            .map_err(|e| Status::invalid_argument(e.to_string()))?;
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let channel_end = self.ibc_context.channel_end(&channel_end_path)?;
-
-        let connection_end = channel_end
-            .connection_hops()
-            .first()
-            .map(|connection_id| self.ibc_context.connection_end(connection_id))
-            .ok_or_else(|| {
-                Status::not_found(format!("Channel {} has no connection hops", channel_id))
-            })??;
-
-        let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
-
-        let consensus_state = self.ibc_context.consensus_state(&consensus_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Consensus state proof not found for client {}",
-                    connection_end.client_id()
-                ))
-            })?;
-
-        Ok(Response::new(QueryChannelConsensusStateResponse {
-            client_id: connection_end.client_id().as_str().into(),
-            consensus_state: Some(consensus_state.into()),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn packet_commitment(
-        &self,
-        request: Request<QueryPacketCommitmentRequest>,
-    ) -> Result<Response<QueryPacketCommitmentResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let sequence = Sequence::from(request_ref.sequence);
-
-        let commitment_path = CommitmentPath::new(&port_id, &channel_id, sequence);
-
-        let packet_commitment_data = self.ibc_context.get_packet_commitment(&commitment_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::Commitment(commitment_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Packet commitment proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryPacketCommitmentResponse {
-            commitment: packet_commitment_data.into_vec(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn packet_commitments(
-        &self,
-        request: Request<QueryPacketCommitmentsRequest>,
-    ) -> Result<Response<QueryPacketCommitmentsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let commitments = self
-            .ibc_context
-            .packet_commitments(&channel_end_path)?
-            .into_iter()
-            .map(|path| {
-                self.ibc_context
-                    .get_packet_commitment(&path)
-                    .map(|commitment| PacketState {
-                        port_id: path.port_id.as_str().into(),
-                        channel_id: path.channel_id.as_str().into(),
-                        sequence: path.sequence.into(),
-                        data: commitment.into_vec(),
-                    })
-            })
-            .collect::<Result<_, _>>()?;
-
-        Ok(Response::new(QueryPacketCommitmentsResponse {
-            commitments,
-            height: Some(self.ibc_context.host_height()?.into()),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn packet_receipt(
-        &self,
-        request: Request<QueryPacketReceiptRequest>,
-    ) -> Result<Response<QueryPacketReceiptResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let sequence = Sequence::from(request_ref.sequence);
-
-        let receipt_path = ReceiptPath::new(&port_id, &channel_id, sequence);
-
-        // Receipt only has one enum
-        // Unreceived packets are not stored
-        let packet_receipt_data = self.ibc_context.get_packet_receipt(&receipt_path);
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::Receipt(receipt_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Packet receipt proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryPacketReceiptResponse {
-            received: packet_receipt_data.is_ok(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn packet_acknowledgement(
-        &self,
-        request: Request<QueryPacketAcknowledgementRequest>,
-    ) -> Result<Response<QueryPacketAcknowledgementResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let sequence = Sequence::from(request_ref.sequence);
-
-        let acknowledgement_path = AckPath::new(&port_id, &channel_id, sequence);
-
-        let packet_acknowledgement_data = self
-            .ibc_context
-            .get_packet_acknowledgement(&acknowledgement_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::Ack(acknowledgement_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Packet acknowledgement proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryPacketAcknowledgementResponse {
-            acknowledgement: packet_acknowledgement_data.into_vec(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    /// Returns all the acknowledgements if sequences is omitted.
-    async fn packet_acknowledgements(
-        &self,
-        request: Request<QueryPacketAcknowledgementsRequest>,
-    ) -> Result<Response<QueryPacketAcknowledgementsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let commitment_sequences = request_ref
-            .packet_commitment_sequences
-            .iter()
-            .copied()
-            .map(Sequence::from);
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let acknowledgements = self
-            .ibc_context
-            .packet_acknowledgements(&channel_end_path, commitment_sequences)?
-            .into_iter()
-            .map(|path| {
-                self.ibc_context
-                    .get_packet_acknowledgement(&path)
-                    .map(|acknowledgement| PacketState {
-                        port_id: path.port_id.as_str().into(),
-                        channel_id: path.channel_id.as_str().into(),
-                        sequence: path.sequence.into(),
-                        data: acknowledgement.into_vec(),
-                    })
-            })
-            .collect::<Result<_, _>>()?;
-
-        Ok(Response::new(QueryPacketAcknowledgementsResponse {
-            acknowledgements,
-            height: Some(self.ibc_context.host_height()?.into()),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn unreceived_packets(
-        &self,
-        request: Request<QueryUnreceivedPacketsRequest>,
-    ) -> Result<Response<QueryUnreceivedPacketsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let sequences = request_ref
-            .packet_commitment_sequences
-            .iter()
-            .copied()
-            .map(Sequence::from);
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let unreceived_packets = self
-            .ibc_context
-            .unreceived_packets(&channel_end_path, sequences)?;
-
-        Ok(Response::new(QueryUnreceivedPacketsResponse {
-            sequences: unreceived_packets.into_iter().map(Into::into).collect(),
-            height: Some(self.ibc_context.host_height()?.into()),
-        }))
-    }
-
-    /// Returns all the unreceived acknowledgements if sequences is omitted.
-    async fn unreceived_acks(
-        &self,
-        request: Request<QueryUnreceivedAcksRequest>,
-    ) -> Result<Response<QueryUnreceivedAcksResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let sequences = request_ref
-            .packet_ack_sequences
-            .iter()
-            .copied()
-            .map(Sequence::from);
-
-        let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
-
-        let unreceived_acks = self
-            .ibc_context
-            .unreceived_acks(&channel_end_path, sequences)?;
-
-        Ok(Response::new(QueryUnreceivedAcksResponse {
-            sequences: unreceived_acks.into_iter().map(Into::into).collect(),
-            height: Some(self.ibc_context.host_height()?.into()),
-        }))
-    }
-
-    async fn next_sequence_receive(
-        &self,
-        request: Request<QueryNextSequenceReceiveRequest>,
-    ) -> Result<Response<QueryNextSequenceReceiveResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let next_seq_recv_path = SeqRecvPath::new(&port_id, &channel_id);
-
-        let next_sequence_recv = self
-            .ibc_context
-            .get_next_sequence_recv(&next_seq_recv_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::SeqRecv(next_seq_recv_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Next sequence receive proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryNextSequenceReceiveResponse {
-            next_sequence_receive: next_sequence_recv.into(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn next_sequence_send(
-        &self,
-        request: Request<QueryNextSequenceSendRequest>,
-    ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let channel_id = ChannelId::from_str(request_ref.channel_id.as_str())?;
-
-        let port_id = PortId::from_str(request_ref.port_id.as_str())?;
-
-        let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
-
-        let next_sequence_send = self
-            .ibc_context
-            .get_next_sequence_send(&next_seq_send_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Next sequence send proof not found for channel {}",
-                    channel_id
-                ))
-            })?;
-
-        Ok(Response::new(QueryNextSequenceSendResponse {
-            next_sequence_send: next_sequence_send.into(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-}
diff --git a/crates/ibc/src/services/core/client.rs b/crates/ibc/src/services/core/client.rs
deleted file mode 100644
index 11a7ce548..000000000
--- a/crates/ibc/src/services/core/client.rs
+++ /dev/null
@@ -1,298 +0,0 @@
-//! [`ClientQueryService`](ClientQueryService) takes generics `I` and `U` to store `ibc_context` and `upgrade_context` that implement [`QueryContext`](QueryContext) and [`UpgradeValidationContext`](UpgradeValidationContext) respectively.
-//! `I` must be a type where writes from one thread are readable from another.
-//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-
-use core::str::FromStr;
-use std::boxed::Box;
-
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::client::v1::query_server::Query as ClientQuery;
-use ibc_proto::ibc::core::client::v1::{
-    ConsensusStateWithHeight, IdentifiedClientState, QueryClientParamsRequest,
-    QueryClientParamsResponse, QueryClientStateRequest, QueryClientStateResponse,
-    QueryClientStatesRequest, QueryClientStatesResponse, QueryClientStatusRequest,
-    QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
-    QueryConsensusStateHeightsResponse, QueryConsensusStateRequest, QueryConsensusStateResponse,
-    QueryConsensusStatesRequest, QueryConsensusStatesResponse, QueryUpgradedClientStateRequest,
-    QueryUpgradedClientStateResponse, QueryUpgradedConsensusStateRequest,
-    QueryUpgradedConsensusStateResponse,
-};
-use tonic::{Request, Response, Status};
-
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::{
-    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
-};
-use crate::core::{ContextError, ValidationContext};
-use crate::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
-use crate::prelude::*;
-use crate::services::core::context::QueryContext;
-use crate::Height;
-
-// TODO(rano): currently the services don't support pagination, so we return all the results.
-
-/// Generics `I` and `U` must be a type where writes from one thread are readable from another.
-/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-pub struct ClientQueryService<I, U>
-where
-    I: QueryContext + Send + Sync + 'static,
-    U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
-{
-    ibc_context: I,
-    upgrade_context: U,
-}
-
-impl<I, U> ClientQueryService<I, U>
-where
-    I: QueryContext + Send + Sync + 'static,
-    U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
-{
-    /// Parameters `ibc_context` and `upgrade_context` must be a type where writes from one thread are readable from another.
-    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-    pub fn new(ibc_context: I, upgrade_context: U) -> Self {
-        Self {
-            ibc_context,
-            upgrade_context,
-        }
-    }
-}
-
-#[tonic::async_trait]
-impl<I, U> ClientQuery for ClientQueryService<I, U>
-where
-    I: QueryContext + Send + Sync + 'static,
-    U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
-{
-    async fn client_state(
-        &self,
-        request: Request<QueryClientStateRequest>,
-    ) -> Result<Response<QueryClientStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-        let client_state = self.ibc_context.client_state(&client_id)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::ClientState(ClientStatePath::new(&client_id)),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Proof unavailable for client {} at height {}",
-                    client_id, current_height
-                ))
-            })?;
-
-        Ok(Response::new(QueryClientStateResponse {
-            client_state: Some(client_state.into()),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn client_states(
-        &self,
-        _request: Request<QueryClientStatesRequest>,
-    ) -> Result<Response<QueryClientStatesResponse>, Status> {
-        let client_states = self.ibc_context.client_states()?;
-
-        Ok(Response::new(QueryClientStatesResponse {
-            client_states: client_states
-                .into_iter()
-                .map(|(id, state)| IdentifiedClientState {
-                    client_id: id.into(),
-                    client_state: Some(state.into()),
-                })
-                .collect(),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn consensus_state(
-        &self,
-        request: Request<QueryConsensusStateRequest>,
-    ) -> Result<Response<QueryConsensusStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-
-        let (height, consensus_state) = if request_ref.latest_height {
-            self.ibc_context
-                .consensus_states(&client_id)?
-                .into_iter()
-                .max_by_key(|(h, _)| *h)
-                .ok_or_else(|| {
-                    Status::not_found(format!(
-                        "Consensus state not found for client {}",
-                        client_id
-                    ))
-                })?
-        } else {
-            let height = Height::new(request_ref.revision_number, request_ref.revision_height)
-                .map_err(|e| Status::invalid_argument(e.to_string()))?;
-            let consensus_state = self
-                .ibc_context
-                .consensus_state(&ClientConsensusStatePath::new(&client_id, &height))?;
-
-            (height, consensus_state)
-        };
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::ClientConsensusState(ClientConsensusStatePath::new(&client_id, &height)),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Consensus state not found for client {} at height {}",
-                    client_id, height
-                ))
-            })?;
-
-        Ok(Response::new(QueryConsensusStateResponse {
-            consensus_state: Some(consensus_state.into()),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn consensus_states(
-        &self,
-        request: Request<QueryConsensusStatesRequest>,
-    ) -> Result<Response<QueryConsensusStatesResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-
-        let consensus_states = self.ibc_context.consensus_states(&client_id)?;
-
-        Ok(Response::new(QueryConsensusStatesResponse {
-            consensus_states: consensus_states
-                .into_iter()
-                .map(|(height, state)| ConsensusStateWithHeight {
-                    height: Some(height.into()),
-                    consensus_state: Some(state.into()),
-                })
-                .collect(),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn consensus_state_heights(
-        &self,
-        request: Request<QueryConsensusStateHeightsRequest>,
-    ) -> Result<Response<QueryConsensusStateHeightsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-
-        let consensus_state_heights = self.ibc_context.consensus_state_heights(&client_id)?;
-
-        Ok(Response::new(QueryConsensusStateHeightsResponse {
-            consensus_state_heights: consensus_state_heights
-                .into_iter()
-                .map(|height| height.into())
-                .collect(),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn client_status(
-        &self,
-        request: Request<QueryClientStatusRequest>,
-    ) -> Result<Response<QueryClientStatusResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-
-        let client_state = self.ibc_context.client_state(&client_id)?;
-        let client_validation_ctx = self.ibc_context.get_client_validation_context();
-        let client_status = client_state
-            .status(client_validation_ctx, &client_id)
-            .map_err(ContextError::from)?;
-
-        Ok(Response::new(QueryClientStatusResponse {
-            status: format!("{}", client_status),
-        }))
-    }
-
-    async fn client_params(
-        &self,
-        _request: Request<QueryClientParamsRequest>,
-    ) -> Result<Response<QueryClientParamsResponse>, Status> {
-        Err(Status::unimplemented(
-            "Querying ClientParams is not supported yet",
-        ))
-    }
-
-    async fn upgraded_client_state(
-        &self,
-        _request: Request<QueryUpgradedClientStateRequest>,
-    ) -> Result<Response<QueryUpgradedClientStateResponse>, Status> {
-        let plan = self
-            .upgrade_context
-            .upgrade_plan()
-            .map_err(ClientError::from)
-            .map_err(ContextError::from)?;
-
-        let upgraded_client_state_path = UpgradeClientPath::UpgradedClientState(plan.height);
-
-        let upgraded_client_state = self
-            .upgrade_context
-            .upgraded_client_state(&upgraded_client_state_path)
-            .map_err(ClientError::from)
-            .map_err(ContextError::from)?;
-
-        Ok(Response::new(QueryUpgradedClientStateResponse {
-            upgraded_client_state: Some(upgraded_client_state.into()),
-        }))
-    }
-
-    async fn upgraded_consensus_state(
-        &self,
-        _request: Request<QueryUpgradedConsensusStateRequest>,
-    ) -> Result<Response<QueryUpgradedConsensusStateResponse>, Status> {
-        let plan = self
-            .upgrade_context
-            .upgrade_plan()
-            .map_err(ClientError::from)
-            .map_err(ContextError::from)?;
-
-        let upgraded_consensus_state_path =
-            UpgradeClientPath::UpgradedClientConsensusState(plan.height);
-
-        let upgraded_consensus_state = self
-            .upgrade_context
-            .upgraded_consensus_state(&upgraded_consensus_state_path)
-            .map_err(ClientError::from)
-            .map_err(ContextError::from)?;
-
-        Ok(Response::new(QueryUpgradedConsensusStateResponse {
-            upgraded_consensus_state: Some(upgraded_consensus_state.into()),
-        }))
-    }
-}
diff --git a/crates/ibc/src/services/core/connection.rs b/crates/ibc/src/services/core/connection.rs
deleted file mode 100644
index eaf77ca65..000000000
--- a/crates/ibc/src/services/core/connection.rs
+++ /dev/null
@@ -1,227 +0,0 @@
-//! [`ConnectionQueryService`](ConnectionQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
-//! `I` must be a type where writes from one thread are readable from another.
-//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-
-use alloc::str::FromStr;
-use std::boxed::Box;
-
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
-use ibc_proto::ibc::core::connection::v1::query_server::Query as ConnectionQuery;
-use ibc_proto::ibc::core::connection::v1::{
-    Params as ConnectionParams, QueryClientConnectionsRequest, QueryClientConnectionsResponse,
-    QueryConnectionClientStateRequest, QueryConnectionClientStateResponse,
-    QueryConnectionConsensusStateRequest, QueryConnectionConsensusStateResponse,
-    QueryConnectionParamsRequest, QueryConnectionParamsResponse, QueryConnectionRequest,
-    QueryConnectionResponse, QueryConnectionsRequest, QueryConnectionsResponse,
-};
-use tonic::{Request, Response, Status};
-
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{
-    ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
-};
-use crate::core::ValidationContext;
-use crate::prelude::*;
-use crate::services::core::context::QueryContext;
-use crate::Height;
-
-// TODO(rano): currently the services don't support pagination, so we return all the results.
-
-/// The generic `I` must be a type where writes from one thread are readable from another.
-/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-pub struct ConnectionQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    ibc_context: I,
-}
-
-impl<I> ConnectionQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
-    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
-    pub fn new(ibc_context: I) -> Self {
-        Self { ibc_context }
-    }
-}
-
-#[tonic::async_trait]
-impl<I> ConnectionQuery for ConnectionQueryService<I>
-where
-    I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-{
-    async fn connection(
-        &self,
-        request: Request<QueryConnectionRequest>,
-    ) -> Result<Response<QueryConnectionResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
-
-        let connection_end = self.ibc_context.connection_end(&connection_id)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::Connection(ConnectionPath::new(&connection_id)),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Proof not found for connection path {}",
-                    connection_id.as_str()
-                ))
-            })?;
-
-        Ok(Response::new(QueryConnectionResponse {
-            connection: Some(connection_end.into()),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn connections(
-        &self,
-        _request: Request<QueryConnectionsRequest>,
-    ) -> Result<Response<QueryConnectionsResponse>, Status> {
-        let connections = self.ibc_context.connection_ends()?;
-
-        Ok(Response::new(QueryConnectionsResponse {
-            connections: connections.into_iter().map(Into::into).collect(),
-            height: Some(self.ibc_context.host_height()?.into()),
-            // no support for pagination yet
-            pagination: None,
-        }))
-    }
-
-    async fn client_connections(
-        &self,
-        request: Request<QueryClientConnectionsRequest>,
-    ) -> Result<Response<QueryClientConnectionsResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let client_id = ClientId::from_str(request_ref.client_id.as_str())?;
-
-        let connections = self.ibc_context.client_connection_ends(&client_id)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof: Vec<u8> = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::ClientConnection(ClientConnectionPath::new(&client_id)),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Proof not found for client connection path {}",
-                    client_id.as_str()
-                ))
-            })?;
-
-        Ok(Response::new(QueryClientConnectionsResponse {
-            connection_paths: connections.into_iter().map(|x| x.as_str().into()).collect(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn connection_client_state(
-        &self,
-        request: Request<QueryConnectionClientStateRequest>,
-    ) -> Result<Response<QueryConnectionClientStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
-
-        let connection_end = self.ibc_context.connection_end(&connection_id)?;
-
-        let client_state = self.ibc_context.client_state(connection_end.client_id())?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(
-                current_height,
-                &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
-            )
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Proof not found for client state path {}",
-                    connection_end.client_id().as_str()
-                ))
-            })?;
-
-        Ok(Response::new(QueryConnectionClientStateResponse {
-            identified_client_state: Some(IdentifiedClientState {
-                client_id: connection_end.client_id().as_str().into(),
-                client_state: Some(client_state.into()),
-            }),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn connection_consensus_state(
-        &self,
-        request: Request<QueryConnectionConsensusStateRequest>,
-    ) -> Result<Response<QueryConnectionConsensusStateResponse>, Status> {
-        let request_ref = request.get_ref();
-
-        let connection_id = ConnectionId::from_str(request_ref.connection_id.as_str())?;
-
-        let connection_end = self.ibc_context.connection_end(&connection_id)?;
-
-        let height = Height::new(request_ref.revision_number, request_ref.revision_height)
-            .map_err(|e| Status::invalid_argument(e.to_string()))?;
-
-        let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
-
-        let consensus_state = self.ibc_context.consensus_state(&consensus_path)?;
-
-        let current_height = self.ibc_context.host_height()?;
-
-        let proof = self
-            .ibc_context
-            .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
-            .ok_or_else(|| {
-                Status::not_found(format!(
-                    "Proof not found for consensus state path {}",
-                    connection_end.client_id().as_str()
-                ))
-            })?;
-
-        Ok(Response::new(QueryConnectionConsensusStateResponse {
-            consensus_state: Some(consensus_state.into()),
-            client_id: connection_end.client_id().as_str().into(),
-            proof,
-            proof_height: Some(current_height.into()),
-        }))
-    }
-
-    async fn connection_params(
-        &self,
-        _request: Request<QueryConnectionParamsRequest>,
-    ) -> Result<Response<QueryConnectionParamsResponse>, Status> {
-        Ok(Response::new(QueryConnectionParamsResponse {
-            params: Some(ConnectionParams {
-                max_expected_time_per_block: self
-                    .ibc_context
-                    .max_expected_time_per_block()
-                    .as_secs(),
-            }),
-        }))
-    }
-}
diff --git a/crates/ibc/src/services/error.rs b/crates/ibc/src/services/error.rs
deleted file mode 100644
index 433a5e321..000000000
--- a/crates/ibc/src/services/error.rs
+++ /dev/null
@@ -1,18 +0,0 @@
-use alloc::string::ToString;
-
-use tonic::Status;
-
-use crate::core::ics24_host::identifier::IdentifierError;
-use crate::core::ContextError;
-
-impl From<IdentifierError> for Status {
-    fn from(err: IdentifierError) -> Self {
-        Status::invalid_argument(err.to_string())
-    }
-}
-
-impl From<ContextError> for Status {
-    fn from(err: ContextError) -> Self {
-        Status::not_found(err.to_string())
-    }
-}

From a2d10f1d15736f80eff56cb85a1996a20989c47f Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 5 Oct 2023 17:24:37 -0700
Subject: [PATCH 036/182] imp: re-export ibc proto types from `ibc-proto-rs`
 (#899)

* imp: re-export ibc proto types from ibc-proto-rs

* nit: better docstring

* fix: re-export relavant types

* nit

* fix: cargo doc

* fix: expose AnySchema
---
 .../898-re-export-ibc-proto-types.md          |  2 ++
 crates/ibc-query/src/core/channel/service.rs  |  2 +-
 crates/ibc-query/src/core/client/service.rs   |  2 +-
 .../ibc-query/src/core/connection/service.rs  |  2 +-
 crates/ibc-query/src/core/context.rs          |  8 ++-----
 crates/ibc-query/src/error.rs                 |  2 ++
 crates/ibc-query/src/lib.rs                   | 21 +++++++++++++++----
 .../src/core/ics04_channel/acknowledgement.rs |  4 ++--
 crates/ibc/src/lib.rs                         | 12 ++++++++---
 crates/ibc/src/utils/mod.rs                   |  6 +++---
 crates/ibc/src/utils/schema.rs                |  1 -
 11 files changed, 40 insertions(+), 22 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/898-re-export-ibc-proto-types.md

diff --git a/.changelog/unreleased/improvements/898-re-export-ibc-proto-types.md b/.changelog/unreleased/improvements/898-re-export-ibc-proto-types.md
new file mode 100644
index 000000000..bbe181575
--- /dev/null
+++ b/.changelog/unreleased/improvements/898-re-export-ibc-proto-types.md
@@ -0,0 +1,2 @@
+- Re-export ibc proto types from `ibc-proto-rs`` for dependency convenience
+  ([/#898](https://github.com/cosmos/ibc-rs/issues/898))
diff --git a/crates/ibc-query/src/core/channel/service.rs b/crates/ibc-query/src/core/channel/service.rs
index a4f3d2fce..b797ac146 100644
--- a/crates/ibc-query/src/core/channel/service.rs
+++ b/crates/ibc-query/src/core/channel/service.rs
@@ -2,7 +2,7 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use std::boxed::Box;
+use alloc::boxed::Box;
 
 use ibc::core::ValidationContext;
 use ibc::prelude::*;
diff --git a/crates/ibc-query/src/core/client/service.rs b/crates/ibc-query/src/core/client/service.rs
index d6612cf2e..817c95146 100644
--- a/crates/ibc-query/src/core/client/service.rs
+++ b/crates/ibc-query/src/core/client/service.rs
@@ -2,7 +2,7 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use std::boxed::Box;
+use alloc::boxed::Box;
 
 use ibc::core::ValidationContext;
 use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
diff --git a/crates/ibc-query/src/core/connection/service.rs b/crates/ibc-query/src/core/connection/service.rs
index a14384e34..dbb97543e 100644
--- a/crates/ibc-query/src/core/connection/service.rs
+++ b/crates/ibc-query/src/core/connection/service.rs
@@ -2,7 +2,7 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use std::boxed::Box;
+use alloc::boxed::Box;
 
 use ibc::core::ValidationContext;
 use ibc::prelude::*;
diff --git a/crates/ibc-query/src/core/context.rs b/crates/ibc-query/src/core/context.rs
index 0316f7090..1b87e2bd0 100644
--- a/crates/ibc-query/src/core/context.rs
+++ b/crates/ibc-query/src/core/context.rs
@@ -1,4 +1,4 @@
-//! Required traits for blanket implementations of [`gRPC query services`](crate::services::core).
+//! Required traits for blanket implementations of [`gRPC query services`](crate::core).
 
 use ibc::core::ics03_connection::connection::IdentifiedConnectionEnd;
 use ibc::core::ics04_channel::channel::IdentifiedChannelEnd;
@@ -9,9 +9,7 @@ use ibc::core::{ContextError, ValidationContext};
 use ibc::prelude::*;
 use ibc::Height;
 
-/// Context to be implemented by the host to provide proofs in gRPC query responses
-///
-/// Trait used for the [`gRPC query services`](crate::services).
+/// Context to be implemented by the host to provide proofs in query responses
 pub trait ProvableContext {
     /// Returns the proof for the given path at the given height.
     /// As this is in the context of IBC, the path is expected to be an [`IbcPath`](Path).
@@ -19,8 +17,6 @@ pub trait ProvableContext {
 }
 
 /// Context to be implemented by the host that provides gRPC query services.
-///
-/// Trait used for the [`gRPC query services`](crate::services).
 pub trait QueryContext: ProvableContext + ValidationContext {
     // Client queries
 
diff --git a/crates/ibc-query/src/error.rs b/crates/ibc-query/src/error.rs
index 47670d293..fa913d42a 100644
--- a/crates/ibc-query/src/error.rs
+++ b/crates/ibc-query/src/error.rs
@@ -1,3 +1,5 @@
+use alloc::string::{String, ToString};
+
 use displaydoc::Display;
 use ibc::core::ics02_client::error::ClientError;
 use ibc::core::ics24_host::identifier::IdentifierError;
diff --git a/crates/ibc-query/src/lib.rs b/crates/ibc-query/src/lib.rs
index bccac04d8..510da1c18 100644
--- a/crates/ibc-query/src/lib.rs
+++ b/crates/ibc-query/src/lib.rs
@@ -2,10 +2,10 @@
 //!
 //! The provided structs includes blanket implementation of their corresponding gRPC service traits,
 //! if the host implements the following _context_ traits.
-//! - [`ValidationContext`](crate::core::ValidationContext)
-//! - [`ProvableContext`](crate::services::core::context::ProvableContext)
-//! - [`QueryContext`](crate::services::core::context::QueryContext)
-//! - [`UpgradeValidationContext`](crate::hosts::tendermint::upgrade_proposal::UpgradeValidationContext)
+//! - [`ValidationContext`](ibc::core::ValidationContext)
+//! - [`ProvableContext`](crate::core::context::ProvableContext)
+//! - [`QueryContext`](crate::core::context::QueryContext)
+//! - [`UpgradeValidationContext`](ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext)
 //!   - Only for [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_client_state) and [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_consensus_state)
 //!
 //! Example
@@ -43,6 +43,19 @@
 //!       .add_service(channel_service)
 //!       .serve(addr);
 //! ```
+//!
+
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![no_std]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+#![forbid(unsafe_code)]
 
 extern crate alloc;
 
diff --git a/crates/ibc/src/core/ics04_channel/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
index ceb68fa57..c7a91c754 100644
--- a/crates/ibc/src/core/ics04_channel/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/acknowledgement.rs
@@ -53,7 +53,7 @@ impl TryFrom<Vec<u8>> for Acknowledgement {
 }
 
 /// Defines a convenience type for IBC applications to construct an
-/// [`Acknowledgement`](super::acknowledgement::Acknowledgement) based on the
+/// [`Acknowledgement`] based on the
 /// success or failure of processing a received packet.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq)]
@@ -69,7 +69,7 @@ pub enum AcknowledgementStatus {
 }
 
 /// A wrapper type that guards variants of
-/// [`AcknowledgementStatus`](crate::core::ics04_channel::acknowledgement::AcknowledgementStatus)
+/// [`AcknowledgementStatus`]
 /// against being constructed with an empty value.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq)]
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 7f0866c80..de0256681 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -61,10 +61,16 @@ pub mod test_utils; // Context mock, the underlying host chain, and client types
 
 pub mod prelude;
 mod signer;
-mod utils;
+pub mod utils;
 
 #[cfg(feature = "serde")]
 mod serializers;
 
-/// Re-export the `Any` type which used across the library.
-pub use ibc_proto::google::protobuf::Any;
+/// Re-exports pertinent ibc proto types from the `ibc-proto-rs` crate for added convenience
+pub mod proto {
+    pub use ibc_proto::google::protobuf::Any;
+    pub use ibc_proto::ibc::apps::transfer;
+    pub use ibc_proto::ibc::core;
+    pub use ibc_proto::ibc::lightclients::tendermint;
+    pub use ibc_proto::protobuf;
+}
diff --git a/crates/ibc/src/utils/mod.rs b/crates/ibc/src/utils/mod.rs
index dee880a6f..5cf51aed6 100644
--- a/crates/ibc/src/utils/mod.rs
+++ b/crates/ibc/src/utils/mod.rs
@@ -1,5 +1,5 @@
 //! Various utilities used internally
 
-pub mod macros;
-pub mod pretty;
-pub(crate) mod schema;
+pub(crate) mod macros;
+pub(crate) mod pretty;
+pub mod schema;
diff --git a/crates/ibc/src/utils/schema.rs b/crates/ibc/src/utils/schema.rs
index 88933acd0..adc2e5269 100644
--- a/crates/ibc/src/utils/schema.rs
+++ b/crates/ibc/src/utils/schema.rs
@@ -2,7 +2,6 @@ use crate::prelude::*;
 
 /// Dummy type that mirrors `ibc_proto::google::protobuf::Any`.
 /// Meant to be used with `#[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]`
-#[allow(dead_code)]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct AnySchema {
     pub type_url: String,

From fd472b8f6a3cf61571ed0d974f4f21762edf73ee Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 11 Oct 2023 21:37:29 +0300
Subject: [PATCH 037/182] fix: header validation during tendermint client
 update (#912)

* add reproducible test

* fix doc lints

* rm incorrect validation check

* changelog entry
---
 ...eader-validation-during-tmclient-update.md |  2 +
 .../src/clients/ics07_tendermint/header.rs    |  7 --
 .../ics02_client/handler/update_client.rs     | 67 +++++++++++++++++
 crates/ibc/src/mock/context.rs                | 73 +++++++++++++++++++
 crates/ibc/src/mock/host.rs                   | 37 +++++++++-
 5 files changed, 178 insertions(+), 8 deletions(-)
 create mode 100644 .changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md

diff --git a/.changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md b/.changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md
new file mode 100644
index 000000000..ba6cdb634
--- /dev/null
+++ b/.changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md
@@ -0,0 +1,2 @@
+- Remove an incorrect validation during tendermint client update
+  ([\#911](https://github.com/cosmos/ibc-rs/issues/911))
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index 614f4dd5a..da0167e3e 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -126,13 +126,6 @@ impl Header {
             });
         }
 
-        if self.trusted_next_validator_set.hash() != self.signed_header.header.next_validators_hash
-        {
-            return Err(Error::MismatchValidatorsHashes {
-                signed_header_validators_hash: self.signed_header.header.next_validators_hash,
-                validators_hash: self.trusted_next_validator_set.hash(),
-            });
-        }
         Ok(())
     }
 }
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index ebdada405..736fdcb54 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -137,6 +137,7 @@ mod tests {
 
     use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+    use tendermint_testgen::Validator as TestgenValidator;
     use test_log::test;
 
     use super::*;
@@ -255,6 +256,72 @@ mod tests {
         assert_eq!(client_state.latest_height(), latest_header_height);
     }
 
+    #[test]
+    fn test_update_synthetic_tendermint_client_validator_change_ok() {
+        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+        let client_height = Height::new(1, 20).unwrap();
+        let update_height = Height::new(1, 21).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+
+        let mut ctx = MockContext::new(
+            ChainId::new("mockgaiaA", 1).unwrap(),
+            HostType::Mock,
+            5,
+            Height::new(1, 1).unwrap(),
+        )
+        .with_client_parametrized_with_chain_id(
+            chain_id_b.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+            Some(client_height),
+        );
+
+        let ctx_b = MockContext::new_with_validator_history(
+            chain_id_b,
+            HostType::SyntheticTendermint,
+            &[
+                // TODO(rano): the validator set params during setups.
+                // Here I picked the default validator set which is
+                // used at host side client creation.
+                vec![
+                    TestgenValidator::new("1").voting_power(50),
+                    TestgenValidator::new("2").voting_power(50),
+                ],
+                vec![
+                    TestgenValidator::new("1").voting_power(60),
+                    TestgenValidator::new("2").voting_power(40),
+                ],
+            ],
+            update_height,
+        );
+
+        let signer = get_dummy_account_id();
+
+        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+        block.set_trusted_height(client_height);
+
+        let latest_header_height = block.height();
+        let msg = MsgUpdateClient {
+            client_id,
+            client_message: block.into(),
+            signer,
+        };
+
+        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        assert!(res.is_ok());
+
+        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        assert!(res.is_ok(), "result: {res:?}");
+
+        let client_state = ctx.client_state(&msg.client_id).unwrap();
+        assert!(client_state
+            .status(&ctx, &msg.client_id)
+            .unwrap()
+            .is_active());
+        assert_eq!(client_state.latest_height(), latest_header_height);
+    }
+
     #[test]
     fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index cf2b61b5f..e28808d44 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -13,6 +13,7 @@ use derive_more::{From, TryInto};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::protobuf::Protobuf;
 use parking_lot::Mutex;
+use tendermint_testgen::Validator as TestgenValidator;
 use tracing::debug;
 
 use super::client_state::{MOCK_CLIENT_STATE_TYPE_URL, MOCK_CLIENT_TYPE};
@@ -313,6 +314,78 @@ impl MockContext {
         }
     }
 
+    /// Same as [Self::new] but with custom validator sets for each block.
+    /// Note: the validator history is used accordingly for current validator set and next validator set.
+    /// `validator_history[i]` and `validator_history[i+1]` is i'th block's current and next validator set.
+    /// The number of blocks will be `validator_history.len() - 1` due to the above.
+    pub fn new_with_validator_history(
+        host_id: ChainId,
+        host_type: HostType,
+        validator_history: &[Vec<TestgenValidator>],
+        latest_height: Height,
+    ) -> Self {
+        let max_history_size = validator_history.len() - 1;
+
+        assert_ne!(
+            max_history_size, 0,
+            "The chain must have a non-zero max_history_size"
+        );
+
+        assert_ne!(
+            latest_height.revision_height(),
+            0,
+            "The chain must have a non-zero revision_height"
+        );
+
+        assert!(
+            max_history_size as u64 <= latest_height.revision_height(),
+            "The number of blocks must be greater than the number of validator set histories"
+        );
+
+        assert_eq!(
+            host_id.revision_number(),
+            latest_height.revision_number(),
+            "The version in the chain identifier must match the version in the latest height"
+        );
+
+        let block_time = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
+        let next_block_timestamp = Timestamp::now().add(block_time).expect("Never fails");
+
+        let history = (0..max_history_size)
+            .rev()
+            .map(|i| {
+                // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
+                // where N = now(), BT = block_time
+                HostBlock::generate_block_with_validators(
+                    host_id.clone(),
+                    host_type,
+                    latest_height
+                        .sub(i as u64)
+                        .expect("Never fails")
+                        .revision_height(),
+                    next_block_timestamp
+                        .sub(Duration::from_secs(
+                            DEFAULT_BLOCK_TIME_SECS * (i as u64 + 1),
+                        ))
+                        .expect("Never fails"),
+                    &validator_history[i],
+                    &validator_history[i + 1],
+                )
+            })
+            .collect();
+
+        MockContext {
+            host_chain_type: host_type,
+            host_chain_id: host_id.clone(),
+            max_history_size,
+            history,
+            block_time,
+            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
+            events: Vec::new(),
+            logs: Vec::new(),
+        }
+    }
+
     /// Associates a client record to this context.
     /// Given a client id and a height, registers a new client in the context and also associates
     /// to this client a mock client state and a mock consensus state for height `height`. The type
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc/src/mock/host.rs
index 5b782a431..18950335d 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc/src/mock/host.rs
@@ -7,7 +7,10 @@ use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::protobuf::Protobuf as ErasedProtobuf;
 use tendermint::block::Header as TmHeader;
 use tendermint_testgen::light_block::TmLightBlock;
-use tendermint_testgen::{Generator, LightBlock as TestgenLightBlock};
+use tendermint_testgen::{
+    Generator, Header as TestgenHeader, LightBlock as TestgenLightBlock,
+    Validator as TestgenValidator,
+};
 
 use super::context::AnyConsensusState;
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
@@ -101,6 +104,38 @@ impl HostBlock {
         }
     }
 
+    /// Generates a new block at `height` for the given chain identifier, chain type and validator sets.
+    pub fn generate_block_with_validators(
+        chain_id: ChainId,
+        chain_type: HostType,
+        height: u64,
+        timestamp: Timestamp,
+        validators: &[TestgenValidator],
+        next_validators: &[TestgenValidator],
+    ) -> HostBlock {
+        match chain_type {
+            HostType::Mock => HostBlock::Mock(Box::new(MockHeader {
+                height: Height::new(chain_id.revision_number(), height).expect("Never fails"),
+                timestamp,
+            })),
+            HostType::SyntheticTendermint => {
+                HostBlock::SyntheticTendermint(Box::new(SyntheticTmBlock {
+                    trusted_height: Height::new(chain_id.revision_number(), 1)
+                        .expect("Never fails"),
+                    light_block: TestgenLightBlock::new_default_with_header(
+                        TestgenHeader::new(validators)
+                            .height(height)
+                            .chain_id(&chain_id.to_string())
+                            .next_validators(next_validators)
+                            .time(timestamp.into_tm_time().expect("Never fails")),
+                    )
+                    .generate()
+                    .expect("Never fails"),
+                }))
+            }
+        }
+    }
+
     pub fn generate_tm_block(
         chain_id: ChainId,
         height: u64,

From 513901f599d9227a0b1c379332463c4e29290906 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 11 Oct 2023 18:23:33 -0700
Subject: [PATCH 038/182] fix(api)!: relocate `*_update_time` and
 `*_update_height` and add missing stores for client upgrade (#915)

* imp: replace update_client_time/height under ClientValidationContext

* misc: add unclog
---
 ...e-time-and-height-under-client-contexts.md |  3 +
 ...-update-cons-metadata-on-client-upgrade.md |  3 +
 .../clients/ics07_tendermint/client_state.rs  | 34 ++++---
 .../src/clients/ics07_tendermint/context.rs   |  9 +-
 crates/ibc/src/core/context.rs                | 42 +-------
 .../ibc/src/core/ics02_client/client_state.rs | 56 +++++------
 crates/ibc/src/core/ics02_client/context.rs   | 47 ++++++++-
 crates/ibc/src/core/ics02_client/error.rs     |  6 +-
 .../ics02_client/handler/create_client.rs     |  6 +-
 .../ics02_client/handler/update_client.rs     | 11 ---
 crates/ibc/src/core/ics02_client/mod.rs       |  2 +-
 crates/ibc/src/core/ics03_connection/delay.rs |  9 +-
 crates/ibc/src/core/ics04_channel/context.rs  | 12 +--
 crates/ibc/src/core/ics04_channel/error.rs    |  8 +-
 .../ics04_channel/handler/acknowledgement.rs  | 27 +++---
 .../core/ics04_channel/handler/recv_packet.rs |  3 +
 .../src/core/ics04_channel/handler/timeout.rs | 27 +++---
 .../ics04_channel/handler/timeout_on_close.rs |  3 +
 .../tendermint/upgrade_proposal/context.rs    |  6 +-
 crates/ibc/src/mock/client_state.rs           | 40 ++++----
 crates/ibc/src/mock/context.rs                | 72 +-------------
 crates/ibc/src/mock/context/clients.rs        | 96 +++++++++++++++++--
 22 files changed, 273 insertions(+), 249 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
 create mode 100644 .changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md

diff --git a/.changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md b/.changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
new file mode 100644
index 000000000..9df36a1e6
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
@@ -0,0 +1,3 @@
+- Relocate `*_update_time` and `*_update_height` to the client contexts' traits
+  for improved access by light clients
+  ([#914](https://github.com/cosmos/ibc-rs/issues/914))
diff --git a/.changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md b/.changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
new file mode 100644
index 000000000..fee260dce
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
@@ -0,0 +1,3 @@
+- Add missing update in the state, which should include the host's height and
+   timestamp when a successful client upgrade take place.
+   ([/#913](https://github.com/cosmos/ibc-rs/issues/913))
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index f4e02a952..a0f85d226 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -35,7 +35,7 @@ use crate::core::ics02_client::client_state::{
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
-use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use crate::core::ics23_commitment::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
@@ -408,16 +408,15 @@ impl ClientStateCommon for ClientState {
     }
 }
 
-impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for ClientState
+impl<V> ClientStateValidation<V> for ClientState
 where
-    ClientValidationContext: TmValidationContext,
-    ClientValidationContext::AnyConsensusState: TryInto<TmConsensusState>,
-    ClientError:
-        From<<ClientValidationContext::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
+    V: ClientValidationContext + TmValidationContext,
+    V::AnyConsensusState: TryInto<TmConsensusState>,
+    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
 {
     fn verify_client_message(
         &self,
-        ctx: &ClientValidationContext,
+        ctx: &V,
         client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
@@ -436,7 +435,7 @@ where
 
     fn check_for_misbehaviour(
         &self,
-        ctx: &ClientValidationContext,
+        ctx: &V,
         client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
@@ -453,11 +452,7 @@ where
         }
     }
 
-    fn status(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-    ) -> Result<Status, ClientError> {
+    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
         if self.is_frozen() {
             return Ok(Status::Frozen);
         }
@@ -510,6 +505,12 @@ where
             ClientConsensusStatePath::new(client_id, &self.latest_height),
             tm_consensus_state.into(),
         )?;
+        ctx.store_update_time(
+            client_id.clone(),
+            self.latest_height(),
+            ctx.host_timestamp()?,
+        )?;
+        ctx.store_update_height(client_id.clone(), self.latest_height(), ctx.host_height()?)?;
 
         Ok(())
     }
@@ -543,10 +544,11 @@ where
                 new_consensus_state.into(),
             )?;
             ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
+            ctx.store_update_time(client_id.clone(), header_height, ctx.host_timestamp()?)?;
+            ctx.store_update_height(client_id.clone(), header_height, ctx.host_height()?)?;
         }
 
-        let updated_heights = vec![header_height];
-        Ok(updated_heights)
+        Ok(vec![header_height])
     }
 
     fn update_state_on_misbehaviour(
@@ -619,6 +621,8 @@ where
             ClientConsensusStatePath::new(client_id, &latest_height),
             new_consensus_state.into(),
         )?;
+        ctx.store_update_time(client_id.clone(), latest_height, ctx.host_timestamp()?)?;
+        ctx.store_update_height(client_id.clone(), latest_height, ctx.host_height()?)?;
 
         Ok(latest_height)
     }
diff --git a/crates/ibc/src/clients/ics07_tendermint/context.rs b/crates/ibc/src/clients/ics07_tendermint/context.rs
index b62cc1680..b98ffe644 100644
--- a/crates/ibc/src/clients/ics07_tendermint/context.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/context.rs
@@ -13,6 +13,12 @@ pub trait CommonContext {
     type ConversionError: ToString;
     type AnyConsensusState: TryInto<TmConsensusState, Error = Self::ConversionError>;
 
+    /// Returns the current timestamp of the local chain.
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
+
+    /// Returns the current height of the local chain.
+    fn host_height(&self) -> Result<Height, ContextError>;
+
     /// Retrieve the consensus state for the given client ID at the specified
     /// height.
     ///
@@ -25,9 +31,6 @@ pub trait CommonContext {
 
 /// Client's context required during validation
 pub trait ValidationContext: CommonContext {
-    /// Returns the current timestamp of the local chain.
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
-
     /// Search for the lowest consensus state higher than `height`.
     fn next_consensus_state(
         &self,
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index c563deb71..13bb7023a 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -7,7 +7,7 @@ use ibc_proto::google::protobuf::Any;
 
 use super::ics02_client::client_state::ClientState;
 use super::ics02_client::consensus_state::ConsensusState;
-use super::ics02_client::ClientExecutionContext;
+use super::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use super::ics24_host::identifier::PortId;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::error::ClientError;
@@ -94,13 +94,13 @@ impl std::error::Error for RouterError {
 ///
 /// Trait used for the top-level [`validate`](crate::core::validate)
 pub trait ValidationContext {
-    type ClientValidationContext;
+    type V: ClientValidationContext;
     type E: ClientExecutionContext;
     type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::ClientValidationContext, Self::E>;
+    type AnyClientState: ClientState<Self::V, Self::E>;
 
     /// Retrieve the context that implements all clients' `ValidationContext`.
-    fn get_client_validation_context(&self) -> &Self::ClientValidationContext;
+    fn get_client_validation_context(&self) -> &Self::V;
 
     /// Returns the ClientState for the given identifier `client_id`.
     ///
@@ -121,20 +121,6 @@ pub trait ValidationContext {
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<Self::AnyConsensusState, ContextError>;
 
-    /// Returns the time when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_time(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Timestamp, ContextError>;
-
-    /// Returns the height when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_height(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Height, ContextError>;
-
     /// Returns the current height of the local chain.
     fn host_height(&self) -> Result<Height, ContextError>;
 
@@ -253,26 +239,6 @@ pub trait ExecutionContext: ValidationContext {
     /// Should never fail.
     fn increase_client_counter(&mut self) -> Result<(), ContextError>;
 
-    /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified time as the time at which
-    /// this update (or header) was processed.
-    fn store_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        timestamp: Timestamp,
-    ) -> Result<(), ContextError>;
-
-    /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified height as the height at
-    /// at which this update (or header) was processed.
-    fn store_update_height(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        host_height: Height,
-    ) -> Result<(), ContextError>;
-
     /// Stores the given connection_end at path
     fn store_connection(
         &mut self,
diff --git a/crates/ibc/src/core/ics02_client/client_state.rs b/crates/ibc/src/core/ics02_client/client_state.rs
index 441e97b2b..05ee1e37b 100644
--- a/crates/ibc/src/core/ics02_client/client_state.rs
+++ b/crates/ibc/src/core/ics02_client/client_state.rs
@@ -123,16 +123,17 @@ pub trait ClientStateCommon {
     ) -> Result<(), ClientError>;
 }
 
-/// `ClientState` methods which require access to the client's
-/// `ValidationContext`.
+/// `ClientState` methods which require access to the client's validation
+/// context
 ///
-/// The `ClientValidationContext` enables the light client implementation to
-/// define its own `ValidationContext` trait and use it in its implementation.
+/// The generic type `V` enables light client developers to expand the set of
+/// methods available under the [`ClientValidationContext`] trait and use them in
+/// their implementation for validating a client state transition.
 ///
 /// ```ignore
-/// impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for MyClientState
+/// impl<V> ClientStateValidation<V> for MyClientState
 /// where
-///     ClientValidationContext: MyValidationContext,
+///     V: ClientValidationContext + MyValidationContext,
 /// {
 ///   // `MyValidationContext` methods available
 /// }
@@ -141,7 +142,10 @@ pub trait ClientStateCommon {
 ///   // My Context methods
 /// }
 /// ```
-pub trait ClientStateValidation<ClientValidationContext> {
+pub trait ClientStateValidation<V>
+where
+    V: ClientValidationContext,
+{
     /// verify_client_message must verify a client_message. A client_message
     /// could be a Header, Misbehaviour. It must handle each type of
     /// client_message appropriately. Calls to check_for_misbehaviour,
@@ -150,7 +154,7 @@ pub trait ClientStateValidation<ClientValidationContext> {
     /// error should be returned if the client_message fails to verify.
     fn verify_client_message(
         &self,
-        ctx: &ClientValidationContext,
+        ctx: &V,
         client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
@@ -160,28 +164,22 @@ pub trait ClientStateValidation<ClientValidationContext> {
     /// assumes the client_message has already been verified.
     fn check_for_misbehaviour(
         &self,
-        ctx: &ClientValidationContext,
+        ctx: &V,
         client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
     ) -> Result<bool, ClientError>;
 
     /// Returns the status of the client. Only Active clients are allowed to process packets.
-    fn status(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-    ) -> Result<Status, ClientError>;
+    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError>;
 }
 
 /// `ClientState` methods which require access to the client's
 /// `ExecutionContext`.
 ///
-/// A client can define its own `ExecutionContext` in a manner analogous to how
-/// it can define a `ValidationContext` in [`ClientStateValidation`]. The one
-/// difference is every client's `ExecutionContext` must have
-/// [`ClientExecutionContext`] as a supertrait, which provides a set of common
-/// methods to store a client state and consensus state.
+/// The generic type `E` enables light client developers to expand the set of
+/// methods available under the [`ClientExecutionContext`] trait and use them in
+/// their implementation for executing a client state transition.
 pub trait ClientStateExecution<E>
 where
     E: ClientExecutionContext,
@@ -244,6 +242,8 @@ where
 /// `ClientExecutionContext` (e.g. `MyType<T>` would not be supported).
 pub use ibc_derive::ClientState;
 
+use super::ClientValidationContext;
+
 /// Primary client trait. Defines all the methods that clients must implement.
 ///
 /// `ClientState` is broken up in 3 separate traits to avoid needing to use
@@ -254,22 +254,12 @@ pub use ibc_derive::ClientState;
 ///
 /// Refer to [`ClientStateValidation`] and [`ClientStateExecution`] to learn
 /// more about what both generic parameters represent.
-pub trait ClientState<ClientValidationContext, E: ClientExecutionContext>:
-    Send
-    + Sync
-    + ClientStateCommon
-    + ClientStateValidation<ClientValidationContext>
-    + ClientStateExecution<E>
+pub trait ClientState<V: ClientValidationContext, E: ClientExecutionContext>:
+    Send + Sync + ClientStateCommon + ClientStateValidation<V> + ClientStateExecution<E>
 {
 }
 
-impl<ClientValidationContext, E: ClientExecutionContext, T> ClientState<ClientValidationContext, E>
-    for T
-where
-    T: Send
-        + Sync
-        + ClientStateCommon
-        + ClientStateValidation<ClientValidationContext>
-        + ClientStateExecution<E>,
+impl<V: ClientValidationContext, E: ClientExecutionContext, T> ClientState<V, E> for T where
+    T: Send + Sync + ClientStateCommon + ClientStateValidation<V> + ClientStateExecution<E>
 {
 }
diff --git a/crates/ibc/src/core/ics02_client/context.rs b/crates/ibc/src/core/ics02_client/context.rs
index f07c51e9e..febda0799 100644
--- a/crates/ibc/src/core/ics02_client/context.rs
+++ b/crates/ibc/src/core/ics02_client/context.rs
@@ -1,7 +1,30 @@
 use super::client_state::ClientState;
 use super::consensus_state::ConsensusState;
+use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
+use crate::core::timestamp::Timestamp;
 use crate::core::ContextError;
+use crate::Height;
+
+/// Defines the methods available to clients for validating client state
+/// transitions. The generic `V` parameter in
+/// [crate::core::ics02_client::client_state::ClientStateValidation] must
+/// inherit from this trait.
+pub trait ClientValidationContext {
+    /// Returns the time when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
+    fn client_update_time(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Timestamp, ContextError>;
+
+    /// Returns the height when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
+    fn client_update_height(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Height, ContextError>;
+}
 
 /// Defines the methods that all client `ExecutionContext`s (precisely the
 /// generic parameter of
@@ -12,8 +35,8 @@ use crate::core::ContextError;
 /// and consensus states. This trait defines a uniform interface to do that for
 /// all clients.
 pub trait ClientExecutionContext: Sized {
-    type ClientValidationContext;
-    type AnyClientState: ClientState<Self::ClientValidationContext, Self>;
+    type V: ClientValidationContext;
+    type AnyClientState: ClientState<Self::V, Self>;
     type AnyConsensusState: ConsensusState;
 
     /// Called upon successful client creation and update
@@ -29,4 +52,24 @@ pub trait ClientExecutionContext: Sized {
         consensus_state_path: ClientConsensusStatePath,
         consensus_state: Self::AnyConsensusState,
     ) -> Result<(), ContextError>;
+
+    /// Called upon successful client update.
+    /// Implementations are expected to use this to record the specified time as the time at which
+    /// this update (or header) was processed.
+    fn store_update_time(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+        host_timestamp: Timestamp,
+    ) -> Result<(), ContextError>;
+
+    /// Called upon successful client update.
+    /// Implementations are expected to use this to record the specified height as the height at
+    /// at which this update (or header) was processed.
+    fn store_update_height(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+        host_height: Height,
+    ) -> Result<(), ContextError>;
 }
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index 9ae4336e2..f67b8fa42 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -33,8 +33,10 @@ pub enum ClientError {
     ClientStateAlreadyExists { client_id: ClientId },
     /// consensus state not found at: `{client_id}` at height `{height}`
     ConsensusStateNotFound { client_id: ClientId, height: Height },
-    /// implementation specific error
-    ImplementationSpecific,
+    /// Processed time for the client `{client_id}` at height `{height}` not found
+    ProcessedTimeNotFound { client_id: ClientId, height: Height },
+    /// Processed height for the client `{client_id}` at height `{height}` not found
+    ProcessedHeightNotFound { client_id: ClientId, height: Height },
     /// header verification failed with reason: `{reason}`
     HeaderVerificationFailure { reason: String },
     /// failed to build trust threshold from fraction: `{numerator}`/`{denominator}`
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index 68c845471..0f8a9b143 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -77,16 +77,12 @@ where
         consensus_state,
     )?;
 
-    let latest_height = client_state.latest_height();
-
-    ctx.store_update_time(client_id.clone(), latest_height, ctx.host_timestamp()?)?;
-    ctx.store_update_height(client_id.clone(), latest_height, ctx.host_height()?)?;
     ctx.increase_client_counter()?;
 
     let event = IbcEvent::CreateClient(CreateClient::new(
         client_id.clone(),
         client_type,
-        latest_height,
+        client_state.latest_height(),
     ));
     ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
     ctx.emit_ibc_event(event)?;
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 736fdcb54..10335d7b7 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -97,17 +97,6 @@ where
             header.clone(),
         )?;
 
-        // Store host height and time for all updated headers
-        {
-            let host_timestamp = ctx.host_timestamp()?;
-            let host_height = ctx.host_height()?;
-
-            for consensus_height in consensus_heights.iter() {
-                ctx.store_update_time(client_id.clone(), *consensus_height, host_timestamp)?;
-                ctx.store_update_height(client_id.clone(), *consensus_height, host_height)?;
-            }
-        }
-
         {
             let event = {
                 let consensus_height = consensus_heights.get(0).ok_or(ClientError::Other {
diff --git a/crates/ibc/src/core/ics02_client/mod.rs b/crates/ibc/src/core/ics02_client/mod.rs
index 682e72fb3..544a3ba55 100644
--- a/crates/ibc/src/core/ics02_client/mod.rs
+++ b/crates/ibc/src/core/ics02_client/mod.rs
@@ -10,4 +10,4 @@ pub mod height;
 pub mod msgs;
 
 mod context;
-pub use context::ClientExecutionContext;
+pub use context::{ClientExecutionContext, ClientValidationContext};
diff --git a/crates/ibc/src/core/ics03_connection/delay.rs b/crates/ibc/src/core/ics03_connection/delay.rs
index 067a84282..b359a3b5c 100644
--- a/crates/ibc/src/core/ics03_connection/delay.rs
+++ b/crates/ibc/src/core/ics03_connection/delay.rs
@@ -1,6 +1,7 @@
 use super::connection::ConnectionEnd;
 use super::error::ConnectionError;
 use crate::core::ics02_client::height::Height;
+use crate::core::ics02_client::ClientValidationContext;
 use crate::core::{ContextError, ValidationContext};
 
 pub fn verify_conn_delay_passed<Ctx>(
@@ -17,8 +18,12 @@ where
 
     // Fetch the latest time and height that the counterparty client was updated on the host chain.
     let client_id = connection_end.client_id();
-    let last_client_update_time = ctx.client_update_time(client_id, &packet_proof_height)?;
-    let last_client_update_height = ctx.client_update_height(client_id, &packet_proof_height)?;
+    let last_client_update_time = ctx
+        .get_client_validation_context()
+        .client_update_time(client_id, &packet_proof_height)?;
+    let last_client_update_height = ctx
+        .get_client_validation_context()
+        .client_update_height(client_id, &packet_proof_height)?;
 
     // Fetch the connection delay time and height periods.
     let conn_delay_time_period = connection_end.delay_period();
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/crates/ibc/src/core/ics04_channel/context.rs
index 42eb58cc7..5d6f2aba0 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/crates/ibc/src/core/ics04_channel/context.rs
@@ -8,7 +8,7 @@ use super::packet::Sequence;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::client_state::ClientState;
 use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use crate::core::ics03_connection::connection::ConnectionEnd;
 use crate::core::ics04_channel::channel::ChannelEnd;
 use crate::core::ics04_channel::commitment::PacketCommitment;
@@ -21,13 +21,13 @@ use crate::prelude::*;
 
 /// Methods required in send packet validation, to be implemented by the host
 pub trait SendPacketValidationContext {
-    type ClientValidationContext;
+    type V: ClientValidationContext;
     type E: ClientExecutionContext;
     type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::ClientValidationContext, Self::E>;
+    type AnyClientState: ClientState<Self::V, Self::E>;
 
     /// Retrieve the context that implements all clients' `ValidationContext`.
-    fn get_client_validation_context(&self) -> &Self::ClientValidationContext;
+    fn get_client_validation_context(&self) -> &Self::V;
 
     /// Returns the ChannelEnd for the given `port_id` and `chan_id`.
     fn channel_end(&self, channel_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError>;
@@ -52,12 +52,12 @@ impl<T> SendPacketValidationContext for T
 where
     T: ValidationContext,
 {
-    type ClientValidationContext = T::ClientValidationContext;
+    type V = T::V;
     type E = T::E;
     type AnyConsensusState = T::AnyConsensusState;
     type AnyClientState = T::AnyClientState;
 
-    fn get_client_validation_context(&self) -> &Self::ClientValidationContext {
+    fn get_client_validation_context(&self) -> &Self::V {
         self.get_client_validation_context()
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index df43905c5..61e5a14b1 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -9,9 +9,7 @@ use crate::core::ics02_client::error as client_error;
 use crate::core::ics03_connection::error as connection_error;
 use crate::core::ics04_channel::channel::State;
 use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{
-    ChannelId, ClientId, ConnectionId, IdentifierError, PortId,
-};
+use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, IdentifierError, PortId};
 use crate::core::timestamp::{ParseTimestampError, Timestamp};
 use crate::prelude::*;
 use crate::Height;
@@ -62,10 +60,6 @@ pub enum ChannelError {
         expected: Counterparty,
         actual: Counterparty,
     },
-    /// Processed time for the client `{client_id}` at height `{height}` not found
-    ProcessedTimeNotFound { client_id: ClientId, height: Height },
-    /// Processed height for the client `{client_id}` at height `{height}` not found
-    ProcessedHeightNotFound { client_id: ClientId, height: Height },
     /// application module error: `{description}`
     AppModule { description: String },
     /// Undefined counterparty connection for `{connection_id}`
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index fa8a68900..71b31bb78 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -222,6 +222,7 @@ mod tests {
     use super::*;
     use crate::applications::transfer::MODULE_ID_STR;
     use crate::core::ics02_client::height::Height;
+    use crate::core::ics02_client::ClientExecutionContext;
     use crate::core::ics03_connection::connection::{
         ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
     };
@@ -376,18 +377,20 @@ mod tests {
                 msg.packet.seq_on_a,
                 packet_commitment,
             );
-        ctx.store_update_time(
-            ClientId::default(),
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-        ctx.store_update_height(
-            ClientId::default(),
-            client_height,
-            Height::new(0, 4).unwrap(),
-        )
-        .unwrap();
+        ctx.get_client_execution_context()
+            .store_update_time(
+                ClientId::default(),
+                client_height,
+                Timestamp::from_nanoseconds(1000).unwrap(),
+            )
+            .unwrap();
+        ctx.get_client_execution_context()
+            .store_update_height(
+                ClientId::default(),
+                client_height,
+                Height::new(0, 4).unwrap(),
+            )
+            .unwrap();
 
         let res = validate(&ctx, &msg);
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index 6f6b6cb76..1ff78ccd2 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -287,6 +287,7 @@ mod tests {
 
     use super::*;
     use crate::applications::transfer::MODULE_ID_STR;
+    use crate::core::ics02_client::ClientExecutionContext;
     use crate::core::ics03_connection::connection::{
         ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
     };
@@ -418,6 +419,7 @@ mod tests {
             );
 
         context
+            .get_client_execution_context()
             .store_update_time(
                 ClientId::default(),
                 client_height,
@@ -425,6 +427,7 @@ mod tests {
             )
             .unwrap();
         context
+            .get_client_execution_context()
             .store_update_height(
                 ClientId::default(),
                 client_height,
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index 3036ae2eb..26b3623a0 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -274,6 +274,7 @@ mod tests {
     use super::*;
     use crate::applications::transfer::MODULE_ID_STR;
     use crate::core::ics02_client::height::Height;
+    use crate::core::ics02_client::ClientExecutionContext;
     use crate::core::ics03_connection::connection::{
         ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
     };
@@ -539,18 +540,20 @@ mod tests {
                 packet_commitment,
             );
 
-        ctx.store_update_time(
-            ClientId::default(),
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-        ctx.store_update_height(
-            ClientId::default(),
-            client_height,
-            Height::new(0, 5).unwrap(),
-        )
-        .unwrap();
+        ctx.get_client_execution_context()
+            .store_update_time(
+                ClientId::default(),
+                client_height,
+                Timestamp::from_nanoseconds(1000).unwrap(),
+            )
+            .unwrap();
+        ctx.get_client_execution_context()
+            .store_update_height(
+                ClientId::default(),
+                client_height,
+                Height::new(0, 5).unwrap(),
+            )
+            .unwrap();
 
         let res = validate(&ctx, &msg);
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
index 5a37f8de5..35af327c5 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
@@ -175,6 +175,7 @@ where
 mod tests {
     use rstest::*;
 
+    use crate::core::ics02_client::ClientExecutionContext;
     use crate::core::ics03_connection::connection::{
         ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
     };
@@ -308,6 +309,7 @@ mod tests {
             );
 
         context
+            .get_client_execution_context()
             .store_update_time(
                 ClientId::default(),
                 Height::new(0, 2).unwrap(),
@@ -315,6 +317,7 @@ mod tests {
             )
             .unwrap();
         context
+            .get_client_execution_context()
             .store_update_height(
                 ClientId::default(),
                 Height::new(0, 2).unwrap(),
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs
index bb6e014b0..29428a2be 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs
@@ -9,16 +9,16 @@ use super::Plan;
 use crate::core::ics02_client::client_state::ClientState;
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::UpgradeClientError;
-use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use crate::core::ics24_host::path::UpgradeClientPath;
 
 /// Helper context to validate client upgrades, providing methods to retrieve
 /// an upgrade plan and related upgraded client and consensus states.
 pub trait UpgradeValidationContext {
-    type ClientValidationContext;
+    type V: ClientValidationContext;
     type E: ClientExecutionContext;
     type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::ClientValidationContext, Self::E>;
+    type AnyClientState: ClientState<Self::V, Self::E>;
 
     /// Returns the upgrade plan that is scheduled and not have been executed yet.
     fn upgrade_plan(&self) -> Result<Plan, UpgradeClientError>;
diff --git a/crates/ibc/src/mock/client_state.rs b/crates/ibc/src/mock/client_state.rs
index e1d83b1a9..454b2576e 100644
--- a/crates/ibc/src/mock/client_state.rs
+++ b/crates/ibc/src/mock/client_state.rs
@@ -10,7 +10,7 @@ use crate::core::ics02_client::client_state::{
 };
 use crate::core::ics02_client::client_type::ClientType;
 use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
-use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use crate::core::ics23_commitment::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
@@ -136,6 +136,12 @@ pub trait MockClientContext {
     type ConversionError: ToString;
     type AnyConsensusState: TryInto<MockConsensusState, Error = Self::ConversionError>;
 
+    /// Returns the current timestamp of the local chain.
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
+
+    /// Returns the current height of the local chain.
+    fn host_height(&self) -> Result<Height, ContextError>;
+
     /// Retrieve the consensus state for the given client ID at the specified
     /// height.
     ///
@@ -144,9 +150,6 @@ pub trait MockClientContext {
         &self,
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<Self::AnyConsensusState, ContextError>;
-
-    /// Returns the current timestamp of the local chain.
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
 }
 
 impl ClientStateCommon for MockClientState {
@@ -215,16 +218,15 @@ impl ClientStateCommon for MockClientState {
     }
 }
 
-impl<ClientValidationContext> ClientStateValidation<ClientValidationContext> for MockClientState
+impl<V> ClientStateValidation<V> for MockClientState
 where
-    ClientValidationContext: MockClientContext,
-    ClientValidationContext::AnyConsensusState: TryInto<MockConsensusState>,
-    ClientError:
-        From<<ClientValidationContext::AnyConsensusState as TryInto<MockConsensusState>>::Error>,
+    V: ClientValidationContext + MockClientContext,
+    V::AnyConsensusState: TryInto<MockConsensusState>,
+    ClientError: From<<V::AnyConsensusState as TryInto<MockConsensusState>>::Error>,
 {
     fn verify_client_message(
         &self,
-        _ctx: &ClientValidationContext,
+        _ctx: &V,
         _client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
@@ -250,7 +252,7 @@ where
 
     fn check_for_misbehaviour(
         &self,
-        _ctx: &ClientValidationContext,
+        _ctx: &V,
         _client_id: &ClientId,
         client_message: Any,
         update_kind: &UpdateKind,
@@ -270,11 +272,7 @@ where
         }
     }
 
-    fn status(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-    ) -> Result<Status, ClientError> {
+    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
         if self.is_frozen() {
             return Ok(Status::Frozen);
         }
@@ -309,7 +307,7 @@ where
 
 impl<E> ClientStateExecution<E> for MockClientState
 where
-    E: ClientExecutionContext,
+    E: ClientExecutionContext + MockClientContext,
     <E as ClientExecutionContext>::AnyClientState: From<MockClientState>,
     <E as ClientExecutionContext>::AnyConsensusState: From<MockConsensusState>,
 {
@@ -347,6 +345,8 @@ where
             new_consensus_state.into(),
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
+        ctx.store_update_time(client_id.clone(), header_height, ctx.host_timestamp()?)?;
+        ctx.store_update_height(client_id.clone(), header_height, ctx.host_height()?)?;
 
         Ok(vec![header_height])
     }
@@ -383,6 +383,12 @@ where
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
 
+        let host_timestamp = ctx.host_timestamp()?;
+        let host_height = ctx.host_height()?;
+
+        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
+        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
+
         Ok(latest_height)
     }
 }
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index e28808d44..8bc84d1d0 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -804,7 +804,7 @@ impl RelayerContext for MockContext {
 }
 
 impl ValidationContext for MockContext {
-    type ClientValidationContext = Self;
+    type V = Self;
     type E = Self;
     type AnyConsensusState = AnyConsensusState;
     type AnyClientState = AnyClientState;
@@ -1101,46 +1101,6 @@ impl ValidationContext for MockContext {
         .map_err(ContextError::PacketError)
     }
 
-    fn client_update_time(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Timestamp, ContextError> {
-        match self
-            .ibc_store
-            .lock()
-            .client_processed_times
-            .get(&(client_id.clone(), *height))
-        {
-            Some(time) => Ok(*time),
-            None => Err(ChannelError::ProcessedTimeNotFound {
-                client_id: client_id.clone(),
-                height: *height,
-            }),
-        }
-        .map_err(ContextError::ChannelError)
-    }
-
-    fn client_update_height(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Height, ContextError> {
-        match self
-            .ibc_store
-            .lock()
-            .client_processed_heights
-            .get(&(client_id.clone(), *height))
-        {
-            Some(height) => Ok(*height),
-            None => Err(ChannelError::ProcessedHeightNotFound {
-                client_id: client_id.clone(),
-                height: *height,
-            }),
-        }
-        .map_err(ContextError::ChannelError)
-    }
-
     fn channel_counter(&self) -> Result<u64, ContextError> {
         Ok(self.ibc_store.lock().channel_ids_counter)
     }
@@ -1153,7 +1113,7 @@ impl ValidationContext for MockContext {
         Ok(())
     }
 
-    fn get_client_validation_context(&self) -> &Self::ClientValidationContext {
+    fn get_client_validation_context(&self) -> &Self::V {
         self
     }
 }
@@ -1174,34 +1134,6 @@ impl ExecutionContext for MockContext {
         Ok(())
     }
 
-    fn store_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        timestamp: Timestamp,
-    ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
-            .client_processed_times
-            .insert((client_id, height), timestamp);
-        Ok(())
-    }
-
-    fn store_update_height(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        host_height: Height,
-    ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
-            .client_processed_heights
-            .insert((client_id, height), host_height);
-        Ok(())
-    }
-
     fn store_connection(
         &mut self,
         connection_path: &ConnectionPath,
diff --git a/crates/ibc/src/mock/context/clients.rs b/crates/ibc/src/mock/context/clients.rs
index 7aa63192d..14261184f 100644
--- a/crates/ibc/src/mock/context/clients.rs
+++ b/crates/ibc/src/mock/context/clients.rs
@@ -5,7 +5,7 @@ use crate::clients::ics07_tendermint::{
     CommonContext as TmCommonContext, ValidationContext as TmValidationContext,
 };
 use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::ClientExecutionContext;
+use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
 use crate::core::timestamp::Timestamp;
@@ -18,22 +18,34 @@ impl MockClientContext for MockContext {
     type ConversionError = &'static str;
     type AnyConsensusState = AnyConsensusState;
 
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
+        ValidationContext::host_timestamp(self)
+    }
+
+    fn host_height(&self) -> Result<Height, ContextError> {
+        ValidationContext::host_height(self)
+    }
+
     fn consensus_state(
         &self,
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<Self::AnyConsensusState, ContextError> {
         ValidationContext::consensus_state(self, client_cons_state_path)
     }
-
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
-        ValidationContext::host_timestamp(self)
-    }
 }
 
 impl TmCommonContext for MockContext {
     type ConversionError = &'static str;
     type AnyConsensusState = AnyConsensusState;
 
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
+        ValidationContext::host_timestamp(self)
+    }
+
+    fn host_height(&self) -> Result<Height, ContextError> {
+        ValidationContext::host_height(self)
+    }
+
     fn consensus_state(
         &self,
         client_cons_state_path: &ClientConsensusStatePath,
@@ -43,10 +55,6 @@ impl TmCommonContext for MockContext {
 }
 
 impl TmValidationContext for MockContext {
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
-        ValidationContext::host_timestamp(self)
-    }
-
     fn next_consensus_state(
         &self,
         client_id: &ClientId,
@@ -116,8 +124,48 @@ impl TmValidationContext for MockContext {
     }
 }
 
+impl ClientValidationContext for MockContext {
+    fn client_update_time(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Timestamp, ContextError> {
+        match self
+            .ibc_store
+            .lock()
+            .client_processed_times
+            .get(&(client_id.clone(), *height))
+        {
+            Some(time) => Ok(*time),
+            None => Err(ClientError::ProcessedTimeNotFound {
+                client_id: client_id.clone(),
+                height: *height,
+            })?,
+        }
+    }
+
+    fn client_update_height(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Height, ContextError> {
+        match self
+            .ibc_store
+            .lock()
+            .client_processed_heights
+            .get(&(client_id.clone(), *height))
+        {
+            Some(height) => Ok(*height),
+            None => Err(ClientError::ProcessedHeightNotFound {
+                client_id: client_id.clone(),
+                height: *height,
+            })?,
+        }
+    }
+}
+
 impl ClientExecutionContext for MockContext {
-    type ClientValidationContext = Self;
+    type V = Self;
     type AnyClientState = AnyClientState;
     type AnyConsensusState = AnyConsensusState;
 
@@ -165,4 +213,32 @@ impl ClientExecutionContext for MockContext {
 
         Ok(())
     }
+
+    fn store_update_time(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+        timestamp: Timestamp,
+    ) -> Result<(), ContextError> {
+        let _ = self
+            .ibc_store
+            .lock()
+            .client_processed_times
+            .insert((client_id, height), timestamp);
+        Ok(())
+    }
+
+    fn store_update_height(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+        host_height: Height,
+    ) -> Result<(), ContextError> {
+        let _ = self
+            .ibc_store
+            .lock()
+            .client_processed_heights
+            .insert((client_id, height), host_height);
+        Ok(())
+    }
 }

From ebd3113dd08c9c33c40d38f36860bcf31cdfe93f Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 12 Oct 2023 08:34:50 -0700
Subject: [PATCH 039/182] Release v0.46.0 (#916)

* chore: update changelog and add summary

* chore: update versions

* chore: update ibc-query docstring

* nit: add new line to Cargo.toml
---
 ...e-time-and-height-under-client-contexts.md |  0
 ...eader-validation-during-tmclient-update.md |  0
 ...-update-cons-metadata-on-client-upgrade.md |  2 +-
 .../improvements/875-remove-regex-dep.md      |  0
 ...896-enhance-ibc-query-methods-usability.md |  0
 .../898-re-export-ibc-proto-types.md          |  0
 .changelog/v0.46.0/summary.md                 | 10 ++++
 .markdownlint.jsonc                           |  2 +
 CHANGELOG.md                                  | 49 +++++++++++++++++--
 crates/ibc-query/Cargo.toml                   |  6 +--
 crates/ibc-query/README.md                    |  6 +--
 crates/ibc-query/src/lib.rs                   | 15 ++++--
 crates/ibc/Cargo.toml                         |  2 +-
 13 files changed, 75 insertions(+), 17 deletions(-)
 rename .changelog/{unreleased => v0.46.0}/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md (100%)
 rename .changelog/{unreleased/bug => v0.46.0/bug-fixes}/911-fix-header-validation-during-tmclient-update.md (100%)
 rename .changelog/{unreleased => v0.46.0}/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md (70%)
 rename .changelog/{unreleased => v0.46.0}/improvements/875-remove-regex-dep.md (100%)
 rename .changelog/{unreleased => v0.46.0}/improvements/896-enhance-ibc-query-methods-usability.md (100%)
 rename .changelog/{unreleased => v0.46.0}/improvements/898-re-export-ibc-proto-types.md (100%)
 create mode 100644 .changelog/v0.46.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md b/.changelog/v0.46.0/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
rename to .changelog/v0.46.0/breaking-changes/914-replace-host-update-time-and-height-under-client-contexts.md
diff --git a/.changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md b/.changelog/v0.46.0/bug-fixes/911-fix-header-validation-during-tmclient-update.md
similarity index 100%
rename from .changelog/unreleased/bug/911-fix-header-validation-during-tmclient-update.md
rename to .changelog/v0.46.0/bug-fixes/911-fix-header-validation-during-tmclient-update.md
diff --git a/.changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md b/.changelog/v0.46.0/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
similarity index 70%
rename from .changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
rename to .changelog/v0.46.0/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
index fee260dce..80ae700a4 100644
--- a/.changelog/unreleased/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
+++ b/.changelog/v0.46.0/bug-fixes/913-add-update-cons-metadata-on-client-upgrade.md
@@ -1,3 +1,3 @@
 - Add missing update in the state, which should include the host's height and
    timestamp when a successful client upgrade take place.
-   ([/#913](https://github.com/cosmos/ibc-rs/issues/913))
+   ([\#913](https://github.com/cosmos/ibc-rs/issues/913))
diff --git a/.changelog/unreleased/improvements/875-remove-regex-dep.md b/.changelog/v0.46.0/improvements/875-remove-regex-dep.md
similarity index 100%
rename from .changelog/unreleased/improvements/875-remove-regex-dep.md
rename to .changelog/v0.46.0/improvements/875-remove-regex-dep.md
diff --git a/.changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md b/.changelog/v0.46.0/improvements/896-enhance-ibc-query-methods-usability.md
similarity index 100%
rename from .changelog/unreleased/improvements/896-enhance-ibc-query-methods-usability.md
rename to .changelog/v0.46.0/improvements/896-enhance-ibc-query-methods-usability.md
diff --git a/.changelog/unreleased/improvements/898-re-export-ibc-proto-types.md b/.changelog/v0.46.0/improvements/898-re-export-ibc-proto-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/898-re-export-ibc-proto-types.md
rename to .changelog/v0.46.0/improvements/898-re-export-ibc-proto-types.md
diff --git a/.changelog/v0.46.0/summary.md b/.changelog/v0.46.0/summary.md
new file mode 100644
index 000000000..2a00c61cb
--- /dev/null
+++ b/.changelog/v0.46.0/summary.md
@@ -0,0 +1,10 @@
+This release introduces vital bug fixes, including removal of an incorrect
+validation during a Tendermint client update and the addition of a missing state
+update during a successful client upgrade ensuring the inclusion of the host's
+height and timestamp in the store.
+
+Additionally, it eliminates the `safe-regex` dependency, and restructures IBC
+query implementations under the previous `grpc` feature flag and moves it to a
+separate crate called as `ibc-query`.
+
+There are consensus-breaking changes.
diff --git a/.markdownlint.jsonc b/.markdownlint.jsonc
index ef04eef87..b8be2d434 100644
--- a/.markdownlint.jsonc
+++ b/.markdownlint.jsonc
@@ -1,6 +1,8 @@
 {
   "default": true,
   "MD013": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md013---line-length
+  "MD024": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md024---multiple-headings-with-the-same-content
   "MD033": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md033---inline-html
+  "MD036": false, // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md036---emphasis-used-instead-of-a-heading
   "MD041": false // https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md#md041---first-line-in-a-file-should-be-a-top-level-heading
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
index c7cb79a89..ad468827e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,45 @@
 # CHANGELOG
 
-# v0.45.0
+## v0.46.0
+
+*October 12, 2023*
+
+This release introduces vital bug fixes, including removal of an incorrect
+validation during a Tendermint client update and the addition of a missing state
+update during a successful client upgrade ensuring the inclusion of the host's
+height and timestamp in the store.
+
+Additionally, it eliminates the `safe-regex` dependency, and restructures IBC
+query implementations under the previous `grpc` feature flag and moves it to a
+separate crate called as `ibc-query`.
+
+There are consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- Relocate `*_update_time` and `*_update_height` to the client contexts' traits
+  for improved access by light clients
+  ([#914](https://github.com/cosmos/ibc-rs/issues/914))
+
+### BUG FIXES
+
+- Remove an incorrect validation during tendermint client update
+  ([\#911](https://github.com/cosmos/ibc-rs/issues/911))
+- Add missing update in the state, which should include the host's height and
+   timestamp when a successful client upgrade take place.
+   ([\#913](https://github.com/cosmos/ibc-rs/issues/913))
+
+### IMPROVEMENTS
+
+- Remove `safe-regex` dependency
+  ([\#875](https://github.com/cosmos/ibc-rs/issues/875))
+- Enhance IBC query methods usability and code organization
+  - The implementation of query methods is now publicly accessible as standalone functions.
+  - `grpc` feature now lives as a separate crate called as `ibc-query`
+  ([#896](https://github.com/cosmos/ibc-rs/issues/896))
+- Re-export ibc proto types from `ibc-proto-rs`` for dep
+
+## v0.45.0
 
 *September 20, 2023*
 
@@ -9,9 +48,9 @@ There are no consensus-breaking changes.
 
 ### BREAKING CHANGES
 
-- Bump tendermint-rs to v0.33.0 
+- Bump tendermint-rs to v0.33.0
   ([#785](https://github.com/cosmos/ibc-rs/issues/785))
-- Bump ibc-proto-rs to v0.34.0 
+- Bump ibc-proto-rs to v0.34.0
   ([#790](https://github.com/cosmos/ibc-rs/issues/790))
 - Allow hosts to handle overflow cases in `increase_*_counter` methods by
   returning `Result<(),ContextError>` type.
@@ -53,7 +92,7 @@ There are no consensus-breaking changes.
 - Remove unused code snippets and move serializer roundtrip test to `serializers.rs`
   ([#869](https://github.com/cosmos/ibc-rs/issues/869))
 
-# v0.44.1
+## v0.44.1
 
 *August 4, 2023*
 
@@ -142,7 +181,7 @@ There are no consensus-breaking changes.
 
 ### BREAKING CHANGES
 
--  Implement ADR 7, where `ClientState` objects are now statically dispatched instead
+- Implement ADR 7, where `ClientState` objects are now statically dispatched instead
    of dynamically dispatched.
 ([#296](https://github.com/cosmos/ibc-rs/issues/296))
 - Revise the `verify_upgrade_client` method to utilize the domain-specific
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
index 672928281..6236378a0 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/crates/ibc-query/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc-query"
-version      = "0.45.0"
+version      = "0.46.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -18,7 +18,7 @@ default = ["std"]
 std = ["ibc-proto/std", "ibc/std"]
 
 [dependencies]
-ibc = { version = "0.45.0", path = "../ibc", default-features = false }
+ibc = { version = "0.46.0", path = "../ibc", default-features = false }
 ibc-proto = { version = "0.35.0", default-features = false, features = ["server"] }
 displaydoc = { version = "0.2", default-features = false }
-tonic = "0.9"
\ No newline at end of file
+tonic = "0.9"
diff --git a/crates/ibc-query/README.md b/crates/ibc-query/README.md
index 346b79544..91a1f7a00 100644
--- a/crates/ibc-query/README.md
+++ b/crates/ibc-query/README.md
@@ -1,7 +1,7 @@
 # ibc-query
 
 This crate provides a set of utility traits and implementations for querying the
-state of an IBC-enabled chain.
+state of an `ibc-rs` enabled chain.
 
-Implementations contains essential IBC query methods and gRPC query service
-for the IBC core client, connection, and channel components.
+Implementations contains essential IBC query methods and gRPC query services for
+each of the IBC core client, connection, and channel layers.
diff --git a/crates/ibc-query/src/lib.rs b/crates/ibc-query/src/lib.rs
index 510da1c18..b77185e4f 100644
--- a/crates/ibc-query/src/lib.rs
+++ b/crates/ibc-query/src/lib.rs
@@ -1,12 +1,19 @@
-//! Implementation of the gRPC query services of core IBC components.
+//! Contains a set of utility traits and implementations for querying the state
+//! of an `ibc-rs` enabled chain, including implementation of essential IBC
+//! query methods and gRPC query services defined in `ibc-proto-rs`. Therefore,
+//! some ready-to-use Query structs for each layer of the client, connection,
+//! and channel have been implemented and exposed by this crate.
 //!
-//! The provided structs includes blanket implementation of their corresponding gRPC service traits,
-//! if the host implements the following _context_ traits.
+//! The provided structs includes blanket implementation of their corresponding
+//! gRPC service traits, if the host implements the following _context_ traits:
 //! - [`ValidationContext`](ibc::core::ValidationContext)
 //! - [`ProvableContext`](crate::core::context::ProvableContext)
 //! - [`QueryContext`](crate::core::context::QueryContext)
 //! - [`UpgradeValidationContext`](ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext)
-//!   - Only for [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_client_state) and [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_consensus_state)
+//!   - Only for
+//!     [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_client_state)
+//!     and
+//!     [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_consensus_state)
 //!
 //! Example
 //! ```rust,ignore
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 0f8a9b063..230e4b282 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.45.0"
+version      = "0.46.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"

From 7bce793a519556db4f8ec40dbda20589693e1afd Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 12 Oct 2023 09:40:31 -0700
Subject: [PATCH 040/182] deps: update tendermint-rs to v0.34, ibc-proto-rs to
 v0.37, prost to v0.12, tonic to v0.10 (#895)

* deps: update tendermint-rs, ibc-proto-rs, prost, tonic

* deps: bump ibc-proto-rs version along with some others

* fix: remove query_next_sequence_send with explanation

* nit: revise comment for query_next_sequence_send
---
 ci/no-std-check/Cargo.lock                    | 738 +++++++++---------
 ci/no-std-check/Cargo.toml                    |  16 +-
 crates/ibc-query/Cargo.toml                   |   4 +-
 crates/ibc-query/src/core/channel/query.rs    |  53 +-
 crates/ibc-query/src/core/channel/service.rs  |  28 +-
 crates/ibc/Cargo.toml                         |  20 +-
 .../core/ics02_client/msgs/misbehaviour.rs    |   2 +
 7 files changed, 415 insertions(+), 446 deletions(-)

diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 72bae601d..1ccfd78d4 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -18,7 +18,16 @@ version = "0.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a76fd60b23679b7d19bd066031410fb7e458ccc5e958eb5c325888ce4baedc97"
 dependencies = [
- "gimli",
+ "gimli 0.27.3",
+]
+
+[[package]]
+name = "addr2line"
+version = "0.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a30b2e23b9e17a9f90641c7ab1549cd9b44f296d3ccbf309d2863cfe398a0cb"
+dependencies = [
+ "gimli 0.28.0",
 ]
 
 [[package]]
@@ -52,9 +61,9 @@ dependencies = [
 
 [[package]]
 name = "aho-corasick"
-version = "1.0.2"
+version = "1.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43f6cb1bf222025340178f382c426f13757b2960e89779dfcb319c32542a5a41"
+checksum = "b2969dcb958b36655471fc61f7e416fa76033bdd4bfed0678d8fee1e2d07a1f0"
 dependencies = [
  "memchr",
 ]
@@ -85,9 +94,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.71"
+version = "1.0.75"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c7d0618f0e0b7e8ff11427422b64564d5fb0be1940354bfe2e0529b18a9d9b8"
+checksum = "a4668cab20f66d8d020e1fbc0ebe47217433c1b6c8f2040faf858554e394ace6"
 
 [[package]]
 name = "array-bytes"
@@ -109,9 +118,9 @@ checksum = "23b62fc65de8e4e7f52534fb52b0f3ed04746ae267519eef2a83941e8085068b"
 
 [[package]]
 name = "arrayvec"
-version = "0.7.2"
+version = "0.7.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8da52d66c7071e2e3fa2a1e5c6d088fec47b593032b254f5e980de8ea54454d6"
+checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "autocfg"
@@ -121,16 +130,16 @@ checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
 
 [[package]]
 name = "backtrace"
-version = "0.3.67"
+version = "0.3.69"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "233d376d6d185f2a3093e58f283f60f880315b6c60075b01f36b3b85154564ca"
+checksum = "2089b7e3f35b9dd2d0ed921ead4f6d318c27680d4a5bd167b3ee120edb105837"
 dependencies = [
- "addr2line",
+ "addr2line 0.21.0",
  "cc",
  "cfg-if",
  "libc",
  "miniz_oxide",
- "object",
+ "object 0.32.1",
  "rustc-demangle",
 ]
 
@@ -142,9 +151,9 @@ checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
 
 [[package]]
 name = "base64"
-version = "0.21.2"
+version = "0.21.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "604178f6c5c21f02dc555784810edfb88d34ac2c73b2eae109655649ee73ce3d"
+checksum = "9ba43ea6f343b788c8764558649e08df62f86c6ef251fdaeb1ffd010a9ae50a2"
 
 [[package]]
 name = "base64ct"
@@ -167,6 +176,12 @@ version = "1.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
+[[package]]
+name = "bitflags"
+version = "2.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4682ae6287fcf752ecaabbfcc7b6f9b72aa33933dc23a554d853aea8eea8635"
+
 [[package]]
 name = "bitvec"
 version = "1.0.1"
@@ -190,12 +205,12 @@ dependencies = [
 
 [[package]]
 name = "blake2b_simd"
-version = "1.0.1"
+version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3c2f0dc9a68c6317d884f97cc36cf5a3d20ba14ce404227df55e1af708ab04bc"
+checksum = "23285ad32269793932e830392f2fe2f83e26488fd3ec778883a93c8323735780"
 dependencies = [
  "arrayref",
- "arrayvec 0.7.2",
+ "arrayvec 0.7.4",
  "constant_time_eq",
 ]
 
@@ -285,9 +300,9 @@ dependencies = [
 
 [[package]]
 name = "bounded-collections"
-version = "0.1.8"
+version = "0.1.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb5b05133427c07c4776906f673ccf36c21b102c9829c641a5b56bd151d44fd6"
+checksum = "ca548b6163b872067dc5eb82fd130c56881435e30367d2073594a3d9744120dd"
 dependencies = [
  "log",
  "parity-scale-codec",
@@ -306,9 +321,9 @@ dependencies = [
 
 [[package]]
 name = "bumpalo"
-version = "3.13.0"
+version = "3.14.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a3e2c3daef883ecc1b5d58c15adae93470a91d425f3532ba1695849656af3fc1"
+checksum = "7f30e7476521f6f8af1a1c4c0b8cc94f0bee37d91763d0ca2665f299b6cd8aec"
 
 [[package]]
 name = "byte-slice-cast"
@@ -324,24 +339,27 @@ checksum = "e3b5ca7a04898ad4bcd41c90c5285445ff5b791899bb1b0abdd2a2aa791211d7"
 
 [[package]]
 name = "byteorder"
-version = "1.4.3"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
 
 [[package]]
 name = "bytes"
-version = "1.4.0"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "89b2fd2a0dcf38d7971e2194b6b6eebab45ae01067456a7fd93d5547a61b70be"
+checksum = "a2bd12c1caf447e69cd4528f47f94d203fd2582878ecb9e9465484c4148a8223"
 dependencies = [
  "serde",
 ]
 
 [[package]]
 name = "cc"
-version = "1.0.79"
+version = "1.0.83"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "50d30906286121d95be3d479533b458f87493b30a4b5f79a607db8f5d11aa91f"
+checksum = "f1174fb0b6ec23863f8b971027804a42614e347eafb0a95bf0b12cdae21fc4d0"
+dependencies = [
+ "libc",
+]
 
 [[package]]
 name = "cfg-if"
@@ -351,27 +369,27 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
 [[package]]
 name = "chrono"
-version = "0.4.26"
+version = "0.4.31"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ec837a71355b28f6556dbd569b37b3f363091c0bd4b2e735674521b4c5fd9bc5"
+checksum = "7f2c685bad3eb3d45a01354cedb7d5faa66194d1d58ba6e267a8de788f79db38"
 dependencies = [
  "android-tzdata",
  "iana-time-zone",
  "num-traits",
- "winapi",
+ "windows-targets 0.48.5",
 ]
 
 [[package]]
 name = "const-oid"
-version = "0.9.2"
+version = "0.9.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "520fbf3c07483f94e3e3ca9d0cfd913d7718ef2483d2cfd91c0d9e91474ab913"
+checksum = "28c122c3980598d243d63d9a704629a2d748d101f278052ff068be5a4423ab6f"
 
 [[package]]
 name = "constant_time_eq"
-version = "0.2.6"
+version = "0.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "21a53c0a4d288377e7415b53dcfc3c04da5cdc2cc95c8d5ac178b58f0b861ad6"
+checksum = "f7144d30dcf0fafbce74250a3963025d8d52177934239851c917d29f1df280c2"
 
 [[package]]
 name = "core-foundation-sys"
@@ -390,9 +408,9 @@ dependencies = [
 
 [[package]]
 name = "cpufeatures"
-version = "0.2.7"
+version = "0.2.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3e4c1eaa2012c47becbbad2ab175484c2a84d1185b566fb2cc5b8707343dfe58"
+checksum = "a17b76ff3a4162b0b27f354a0c87015ddad39d35f9c0c36607a3bdd175dde1f1"
 dependencies = [
  "libc",
 ]
@@ -479,9 +497,9 @@ dependencies = [
 
 [[package]]
 name = "curve25519-dalek"
-version = "4.1.0"
+version = "4.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "622178105f911d937a42cdb140730ba4a3ed2becd8ae6ce39c7d28b5d75d4588"
+checksum = "e89b8c6a2e4b1f45971ad09761aafb85514a84744b67a95e32c3cc1352d1f65c"
 dependencies = [
  "cfg-if",
  "cpufeatures",
@@ -501,7 +519,7 @@ checksum = "83fdaf97f4804dcebfa5862639bc9ce4121e82140bec2a987ac5140294865b5b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -519,9 +537,9 @@ dependencies = [
 
 [[package]]
 name = "darling"
-version = "0.20.1"
+version = "0.20.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0558d22a7b463ed0241e993f76f09f30b126687447751a8638587b864e4b3944"
+checksum = "0209d94da627ab5605dcccf08bb18afa5009cfbef48d8a8b7d7bdbc79be25c5e"
 dependencies = [
  "darling_core",
  "darling_macro",
@@ -529,39 +547,45 @@ dependencies = [
 
 [[package]]
 name = "darling_core"
-version = "0.20.1"
+version = "0.20.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab8bfa2e259f8ee1ce5e97824a3c55ec4404a0d772ca7fa96bf19f0752a046eb"
+checksum = "177e3443818124b357d8e76f53be906d60937f0d3a90773a664fa63fa253e621"
 dependencies = [
  "fnv",
  "ident_case",
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "darling_macro"
-version = "0.20.1"
+version = "0.20.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "29a358ff9f12ec09c3e61fef9b5a9902623a695a46a917b07f269bff1445611a"
+checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "der"
-version = "0.7.6"
+version = "0.7.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56acb310e15652100da43d130af8d97b509e95af61aab1c5a7939ef24337ee17"
+checksum = "fffa369a668c8af7dbf8b5e56c9f744fbd399949ed171606040001947de40b1c"
 dependencies = [
  "const-oid",
  "zeroize",
 ]
 
+[[package]]
+name = "deranged"
+version = "0.3.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f2696e8a945f658fd14dc3b87242e6b80cd0f36ff04ea560fa39082368847946"
+
 [[package]]
 name = "derive_more"
 version = "0.99.17"
@@ -610,7 +634,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -636,15 +660,15 @@ dependencies = [
 
 [[package]]
 name = "dyn-clone"
-version = "1.0.11"
+version = "1.0.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "68b0cf012f1230e43cd00ebb729c6bb58707ecfa8ad08b52ef3a4ccd2697fc30"
+checksum = "23d2f3407d9a573d666de4b5bdf10569d73ca9478087346697dcbae6244bfbcd"
 
 [[package]]
 name = "ed25519"
-version = "2.2.1"
+version = "2.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5fb04eee5d9d907f29e80ee6b0e78f7e2c82342c63e3580d8c4f69d9d5aad963"
+checksum = "60f6d271ca33075c88028be6f04d502853d63a5ece419d269c15315d4fc1cf1d"
 dependencies = [
  "pkcs8",
  "signature",
@@ -669,9 +693,9 @@ version = "2.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7277392b266383ef8396db7fdeb1e77b6c52fed775f5df15bb24f35b72156980"
 dependencies = [
- "curve25519-dalek 4.1.0",
+ "curve25519-dalek 4.1.1",
  "ed25519",
- "sha2 0.10.7",
+ "sha2 0.10.8",
 ]
 
 [[package]]
@@ -690,9 +714,9 @@ dependencies = [
 
 [[package]]
 name = "either"
-version = "1.8.1"
+version = "1.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7fcaabb2fef8c910e7f4c7ce9f67a1283a1715879a7c230ca9d6d1ae31f16d91"
+checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
 
 [[package]]
 name = "environmental"
@@ -701,24 +725,19 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e48c92028aaa870e83d51c64e5d4e0b6981b360c522198c23959f219a4e1b15b"
 
 [[package]]
-name = "errno"
-version = "0.3.1"
+name = "equivalent"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4bcfec3a70f97c962c307b2d2c56e358cf1d00b558d74262b5f929ee8cc7e73a"
-dependencies = [
- "errno-dragonfly",
- "libc",
- "windows-sys 0.48.0",
-]
+checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
 [[package]]
-name = "errno-dragonfly"
-version = "0.1.2"
+name = "errno"
+version = "0.3.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "aa68f1b12764fab894d2755d2518754e71b4fd80ecfb822714a1206c2aab39bf"
+checksum = "ac3e13f66a2f95e32a39eaa81f6b95d42878ca0e1db0c7543723dfe12557e860"
 dependencies = [
- "cc",
  "libc",
+ "windows-sys 0.48.0",
 ]
 
 [[package]]
@@ -838,7 +857,7 @@ checksum = "89ca545a94061b6365f2c7355b4b32bd20df3ff95f02da9329b34ccc3bd6ee72"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -914,15 +933,21 @@ dependencies = [
 
 [[package]]
 name = "gimli"
-version = "0.27.2"
+version = "0.27.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ad0a93d233ebf96623465aad4046a8d3aa4da22d4f4beba5388838c8a434bbb4"
+checksum = "b6c80984affa11d98d1b88b66ac8853f143217b399d3c74116778ff8fdb4ed2e"
 dependencies = [
  "fallible-iterator",
- "indexmap",
+ "indexmap 1.9.3",
  "stable_deref_trait",
 ]
 
+[[package]]
+name = "gimli"
+version = "0.28.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6fb8d784f27acf97159b40fc4db5ecd8aa23b9ad5ef69cdd136d3bc80665f0c0"
+
 [[package]]
 name = "hash-db"
 version = "0.16.0"
@@ -957,19 +982,16 @@ dependencies = [
 ]
 
 [[package]]
-name = "hermit-abi"
-version = "0.2.6"
+name = "hashbrown"
+version = "0.14.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee512640fe35acbfb4bb779db6f0d80704c2cacfa2e39b601ef3e3f47d1ae4c7"
-dependencies = [
- "libc",
-]
+checksum = "7dfda62a12f55daeae5015f81b0baea145391cb4520f86c248fc615d72640d12"
 
 [[package]]
 name = "hermit-abi"
-version = "0.3.1"
+version = "0.3.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fed44880c466736ef9a5c5b5facefb5ed0785676d0c02d612db14e54f0d84286"
+checksum = "d77f7ec81a6d05a3abb01ab6eb7590f6083d08449fe5a1c8b1e620283546ccb7"
 
 [[package]]
 name = "hex"
@@ -1042,7 +1064,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.44.1"
+version = "0.45.0"
 dependencies = [
  "bytes",
  "derive_more",
@@ -1053,11 +1075,10 @@ dependencies = [
  "num-traits",
  "primitive-types",
  "prost",
- "safe-regex",
  "serde",
  "serde_derive",
  "serde_json",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "subtle-encoding",
  "tendermint",
  "tendermint-light-client-verifier",
@@ -1074,16 +1095,16 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "ibc-proto"
-version = "0.35.0"
+version = "0.37.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "459ccbab879b749bf500ae13244593fa16fc64c1b3159f6b0753c169625a1e23"
+checksum = "63042806bb2f662ca1c68026231900cfe13361136ddfd0dd09bcb315056a22b8"
 dependencies = [
- "base64 0.21.2",
+ "base64 0.21.4",
  "borsh",
  "bytes",
  "flex-error",
@@ -1098,9 +1119,9 @@ dependencies = [
 
 [[package]]
 name = "ics23"
-version = "0.10.2"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "442d4bab37956e76f739c864f246c825d87c0bb7f9afa65660c57833c91bf6d4"
+checksum = "661e2d6f79952a65bc92b1c81f639ebd37228dae6ff412a5aba7d474bdc4b957"
 dependencies = [
  "anyhow",
  "bytes",
@@ -1109,7 +1130,7 @@ dependencies = [
  "prost",
  "ripemd",
  "serde",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "sha3",
 ]
 
@@ -1169,6 +1190,16 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "indexmap"
+version = "2.0.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8adf3ddd720272c6ea8bf59463c04e0f93d0bbf7c5439b691bca2987e0270897"
+dependencies = [
+ "equivalent",
+ "hashbrown 0.14.1",
+]
+
 [[package]]
 name = "informalsystems-pbjson"
 version = "0.6.0"
@@ -1194,31 +1225,31 @@ version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "eae7b9aee968036d54dce06cebaefd919e4472e753296daccd6d344e3e2df0c2"
 dependencies = [
- "hermit-abi 0.3.1",
+ "hermit-abi",
  "libc",
  "windows-sys 0.48.0",
 ]
 
 [[package]]
 name = "itertools"
-version = "0.10.5"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473"
+checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57"
 dependencies = [
  "either",
 ]
 
 [[package]]
 name = "itoa"
-version = "1.0.6"
+version = "1.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "453ad9f582a441959e5f0d088b02ce04cfe8d51a8eaf077f12ac6d3e94164ca6"
+checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
 
 [[package]]
 name = "js-sys"
-version = "0.3.63"
+version = "0.3.64"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2f37a4a5928311ac501dee68b3c7613a1037d0edb30c8e5427bd832d55d1b790"
+checksum = "c5f195fe497f702db0f318b07fdd68edb16955aed830df8363d837542f8f935a"
 dependencies = [
  "wasm-bindgen",
 ]
@@ -1240,9 +1271,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.146"
+version = "0.2.149"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f92be4933c13fd498862a9e02a3055f8a8d9c039ce33db97306fd5a6caa7f29b"
+checksum = "a08173bc88b7955d1b3145aa561539096c421ac8debde8cbc3612ec635fee29b"
 
 [[package]]
 name = "libsecp256k1"
@@ -1300,9 +1331,9 @@ checksum = "f051f77a7c8e6957c0696eac88f26b0117e54f52d3fc682ab19397a8812846a4"
 
 [[package]]
 name = "linux-raw-sys"
-version = "0.3.8"
+version = "0.4.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ef53942eb7bf7ff43a617b3e2c1c4a5ecf5944a7c1bc12d7ee39bbb15e5c1519"
+checksum = "da2479e8c062e40bf0066ffa0bc823de0a9368974af99c9f6df941d2c231e03f"
 
 [[package]]
 name = "lock_api"
@@ -1316,9 +1347,9 @@ dependencies = [
 
 [[package]]
 name = "log"
-version = "0.4.19"
+version = "0.4.20"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b06a4cde4c0f271a446782e3eff8de789548ce57dbc8eca9292c27f4a42004b4"
+checksum = "b5e6163cb8c49088c2c36f57875e58ccd8c87c7427f7fbd50ea6710b2f3f2e8f"
 
 [[package]]
 name = "mach"
@@ -1335,22 +1366,22 @@ version = "0.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f099785f7595cc4b4553a174ce30dd7589ef93391ff414dbb67f62392b9e0ce1"
 dependencies = [
- "regex-automata",
+ "regex-automata 0.1.10",
 ]
 
 [[package]]
 name = "memchr"
-version = "2.5.0"
+version = "2.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d"
+checksum = "f665ee40bc4a3c5590afb1e9677db74a508659dfd71e126420da8274909a0167"
 
 [[package]]
 name = "memfd"
-version = "0.6.3"
+version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ffc89ccdc6e10d6907450f753537ebc5c5d3460d2e4e62ea74bd571db62c0f9e"
+checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
 dependencies = [
- "rustix 0.37.20",
+ "rustix 0.38.18",
 ]
 
 [[package]]
@@ -1385,9 +1416,9 @@ dependencies = [
 
 [[package]]
 name = "miniz_oxide"
-version = "0.6.2"
+version = "0.7.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b275950c28b37e794e8c55d88aeb5e139d0ce23fdbbeda68f8d7174abdf9e8fa"
+checksum = "e7810e0be55b428ada41041c41f32c9f1a42817901b4ccf45fa3d4b6561e74c7"
 dependencies = [
  "adler",
 ]
@@ -1402,7 +1433,7 @@ dependencies = [
  "sp-io",
  "sp-runtime",
  "sp-std",
- "syn 2.0.32",
+ "syn 2.0.38",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1431,26 +1462,26 @@ version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a652d9771a63711fd3c3deb670acfbe5c30a4072e664d7a3bf5a9e1056ac72c3"
 dependencies = [
- "arrayvec 0.7.2",
+ "arrayvec 0.7.4",
  "itoa",
 ]
 
 [[package]]
 name = "num-traits"
-version = "0.2.15"
+version = "0.2.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "578ede34cf02f8924ab9447f50c28075b4d3e5b269972345e7e0372b38c6cdcd"
+checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c"
 dependencies = [
  "autocfg",
 ]
 
 [[package]]
 name = "num_cpus"
-version = "1.15.0"
+version = "1.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0fac9e2da13b5eb447a6ce3d392f23a29d8694bff781bf03a16cd9ac8697593b"
+checksum = "4161fcb6d602d4d2081af7c3a45852d875a03dd337a6bfdd6e06407b61342a43"
 dependencies = [
- "hermit-abi 0.2.6",
+ "hermit-abi",
  "libc",
 ]
 
@@ -1462,7 +1493,16 @@ checksum = "03b4680b86d9cfafba8fc491dc9b6df26b68cf40e9e6cd73909194759a63c385"
 dependencies = [
  "crc32fast",
  "hashbrown 0.13.2",
- "indexmap",
+ "indexmap 1.9.3",
+ "memchr",
+]
+
+[[package]]
+name = "object"
+version = "0.32.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9cf5f9dd3933bd50a9e1f149ec995f39ae2c496d31fd772c1fd45ebc27e902b0"
+dependencies = [
  "memchr",
 ]
 
@@ -1486,11 +1526,11 @@ checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.4"
+version = "3.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd8e946cc0cc711189c0b0249fb8b599cbeeab9784d83c415719368bb8d4ac64"
+checksum = "0dec8a8073036902368c2cdc0387e85ff9a37054d7e7c98e592145e0c92cd4fb"
 dependencies = [
- "arrayvec 0.7.2",
+ "arrayvec 0.7.4",
  "bitvec",
  "byte-slice-cast",
  "bytes",
@@ -1501,9 +1541,9 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.4"
+version = "3.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a296c3079b5fefbc499e1de58dc26c09b1b9a5952d26694ee89f04a43ebbb3e"
+checksum = "312270ee71e1cd70289dacf597cab7b207aa107d2f28191c2ae45b2ece18a260"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -1531,14 +1571,14 @@ dependencies = [
  "libc",
  "redox_syscall",
  "smallvec",
- "windows-targets 0.48.0",
+ "windows-targets 0.48.5",
 ]
 
 [[package]]
 name = "paste"
-version = "1.0.12"
+version = "1.0.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9f746c4065a8fa3fe23974dd82f15431cc8d40779821001404d10d2e79ca7d79"
+checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
 
 [[package]]
 name = "pbkdf2"
@@ -1566,9 +1606,9 @@ checksum = "9b2a4787296e9989611394c33f193f676704af1686e70b8f8033ab5ba9a35a94"
 
 [[package]]
 name = "pin-project-lite"
-version = "0.2.9"
+version = "0.2.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e0a7ae3ac2f1173085d398531c705756c94a4c56843785df85a60c1a0afac116"
+checksum = "8afb450f006bf6385ca15ef45d71d2288452bc3683ce2e2cacc0d18e4be60b58"
 
 [[package]]
 name = "pin-utils"
@@ -1600,9 +1640,9 @@ checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de"
 
 [[package]]
 name = "primitive-types"
-version = "0.12.1"
+version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9f3486ccba82358b11a77516035647c34ba167dfa53312630de83b12bd4f3d66"
+checksum = "0b34d9fd68ae0b74a41b21c03c2f62847aa0ffea044eee893b4c140b37e244e2"
 dependencies = [
  "fixed-hash",
  "impl-codec",
@@ -1632,18 +1672,18 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.66"
+version = "1.0.69"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "18fb31db3f9bddb2ea821cde30a9f70117e3f119938b5ee630b7403aa6e2ead9"
+checksum = "134c189feb4956b20f6f547d2cf727d4c0fe06722b20a0eec87ed445a97f92da"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "prost"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b82eaa1d779e9a4bc1c3217db8ffbeabaae1dca241bf70183242128d48681cd"
+checksum = "f4fdd22f3b9c31b53c060df4a0613a1c7f062d4115a2b984dd15b1858f7e340d"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -1651,22 +1691,22 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e5d2d8d10f3c6ded6da8b05b5fb3b8a5082514344d56c9f871412d29b4e075b4"
+checksum = "265baba7fabd416cf5078179f7d2cbeca4ce7a9041111900675ea7c4cb8a4c32"
 dependencies = [
  "anyhow",
  "itertools",
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "prost-types"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "213622a1460818959ac1181aaeb2dc9c7f63df720db7d788b3e24eacd1983e13"
+checksum = "e081b29f63d83a4bc75cfc9f3fe424f9156cf92d8a4f0c9407cce9a1b67327cf"
 dependencies = [
  "prost",
 ]
@@ -1772,38 +1812,39 @@ version = "0.3.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "567664f262709473930a4bf9e51bf2ebf3348f2e748ccc50dea20646858f8f29"
 dependencies = [
- "bitflags",
+ "bitflags 1.3.2",
 ]
 
 [[package]]
 name = "ref-cast"
-version = "1.0.16"
+version = "1.0.20"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f43faa91b1c8b36841ee70e97188a869d37ae21759da6846d4be66de5bf7b12c"
+checksum = "acde58d073e9c79da00f2b5b84eed919c8326832648a5b109b3fce1bb1175280"
 dependencies = [
  "ref-cast-impl",
 ]
 
 [[package]]
 name = "ref-cast-impl"
-version = "1.0.16"
+version = "1.0.20"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8d2275aab483050ab2a7364c1a46604865ee7d6906684e08db0f090acf74f9e7"
+checksum = "7f7473c2cfcf90008193dd0e3e16599455cb601a9fce322b5bb55de799664925"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "regex"
-version = "1.8.4"
+version = "1.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0ab3ca65655bb1e41f2a8c8cd662eb4fb035e67c3f78da1d61dffe89d07300f"
+checksum = "d119d7c7ca818f8a53c300863d4f87566aac09943aef5b355bb83969dae75d87"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-syntax 0.7.2",
+ "regex-automata 0.4.1",
+ "regex-syntax 0.8.0",
 ]
 
 [[package]]
@@ -1815,6 +1856,17 @@ dependencies = [
  "regex-syntax 0.6.29",
 ]
 
+[[package]]
+name = "regex-automata"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "465c6fc0621e4abc4187a2bda0937bfd4f722c2730b29562e19689ea796c9a4b"
+dependencies = [
+ "aho-corasick",
+ "memchr",
+ "regex-syntax 0.8.0",
+]
+
 [[package]]
 name = "regex-syntax"
 version = "0.6.29"
@@ -1823,9 +1875,9 @@ checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
 
 [[package]]
 name = "regex-syntax"
-version = "0.7.2"
+version = "0.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "436b050e76ed2903236f032a59761c1eb99e1b0aead2c257922771dab1fc8c78"
+checksum = "c3cbb081b9784b07cceb8824c8583f86db4814d172ab043f3c23f7dc600bf83d"
 
 [[package]]
 name = "ripemd"
@@ -1865,11 +1917,11 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.36.14"
+version = "0.36.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14e4d67015953998ad0eb82887a0eb0129e18a7e2f3b7b0f6c422fddcd503d62"
+checksum = "c37f1bd5ef1b5422177b7646cba67430579cfe2ace80f284fee876bca52ad941"
 dependencies = [
- "bitflags",
+ "bitflags 1.3.2",
  "errno",
  "io-lifetimes",
  "libc",
@@ -1879,82 +1931,34 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.37.20"
+version = "0.38.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b96e891d04aa506a6d1f318d2771bcb1c7dfda84e126660ace067c9b474bb2c0"
+checksum = "5a74ee2d7c2581cd139b42447d7d9389b889bdaad3a73f1ebb16f2a3237bb19c"
 dependencies = [
- "bitflags",
+ "bitflags 2.4.0",
  "errno",
- "io-lifetimes",
  "libc",
- "linux-raw-sys 0.3.8",
+ "linux-raw-sys 0.4.10",
  "windows-sys 0.48.0",
 ]
 
 [[package]]
 name = "rustversion"
-version = "1.0.12"
+version = "1.0.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4f3208ce4d8448b3f3e7d168a73f5e0c43a61e32930de3bceeccedb388b6bf06"
+checksum = "7ffc183a10b4478d04cbbbfc96d0873219d962dd5accaff2ffbd4ceb7df837f4"
 
 [[package]]
 name = "ryu"
-version = "1.0.13"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f91339c0467de62360649f8d3e185ca8de4224ff281f66000de5eb2a77a79041"
-
-[[package]]
-name = "safe-proc-macro2"
-version = "1.0.36"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "814c536dcd27acf03296c618dab7ad62d28e70abd7ba41d3f34a2ce707a2c666"
-dependencies = [
- "unicode-xid",
-]
-
-[[package]]
-name = "safe-quote"
 version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77e530f7831f3feafcd5f1aae406ac205dd998436b4007c8e80f03eca78a88f7"
-dependencies = [
- "safe-proc-macro2",
-]
-
-[[package]]
-name = "safe-regex"
-version = "0.2.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a15289bf322e0673d52756a18194167f2378ec1a15fe884af6e2d2cb934822b0"
-dependencies = [
- "safe-regex-macro",
-]
-
-[[package]]
-name = "safe-regex-compiler"
-version = "0.2.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fba76fae590a2aa665279deb1f57b5098cbace01a0c5e60e262fcf55f7c51542"
-dependencies = [
- "safe-proc-macro2",
- "safe-quote",
-]
-
-[[package]]
-name = "safe-regex-macro"
-version = "0.2.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96c2e96b5c03f158d1b16ba79af515137795f4ad4e8de3f790518aae91f1d127"
-dependencies = [
- "safe-proc-macro2",
- "safe-regex-compiler",
-]
+checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
 
 [[package]]
 name = "scale-info"
-version = "2.7.0"
+version = "2.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b569c32c806ec3abdf3b5869fb8bf1e0d275a7c1c9b0b05603d9464632649edf"
+checksum = "35c0a159d0c45c12b20c5a844feb1fe4bea86e28f17b92a5f0c42193634d3782"
 dependencies = [
  "bitvec",
  "cfg-if",
@@ -1966,9 +1970,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.6.0"
+version = "2.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53012eae69e5aa5c14671942a5dd47de59d4cdcff8532a6dd0e081faf1119482"
+checksum = "912e55f6d20e0e80d63733872b40e1227c0bce1e1ab81ba67d696339bfd7fd29"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -2007,9 +2011,9 @@ dependencies = [
 
 [[package]]
 name = "scopeguard"
-version = "1.1.0"
+version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d29ab0c6d3fc0ee92fe66e2d99f700eab17a8d57d1c1d3b748380fb20baa78cd"
+checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "secp256k1"
@@ -2040,9 +2044,9 @@ dependencies = [
 
 [[package]]
 name = "semver"
-version = "1.0.18"
+version = "1.0.20"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b0293b4b29daaf487284529cc2f5675b8e57c61f70167ba415a463651fd6a918"
+checksum = "836fa6a3e1e547f9a2c4040802ec865b5d85f4014efe00555d7090a3dcaa1090"
 
 [[package]]
 name = "serde"
@@ -2055,9 +2059,9 @@ dependencies = [
 
 [[package]]
 name = "serde_bytes"
-version = "0.11.9"
+version = "0.11.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "416bda436f9aab92e02c8e10d49a15ddd339cea90b6e340fe51ed97abb548294"
+checksum = "ab33ec92f677585af6d88c65593ae2375adde54efdbf16d597f2cbc7a6d368ff"
 dependencies = [
  "serde",
 ]
@@ -2070,14 +2074,14 @@ checksum = "4eca7ac642d82aa35b60049a6eccb4be6be75e599bd2e9adb5f875a737654af2"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "serde_json"
-version = "1.0.96"
+version = "1.0.107"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "057d394a50403bcac12672b2b18fb387ab6d289d957dab67dd201875391e52f1"
+checksum = "6b420ce6e3d8bd882e9b243c6eed35dbc9a6110c9769e74b584e0d68d1f20c65"
 dependencies = [
  "itoa",
  "ryu",
@@ -2086,13 +2090,13 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.12"
+version = "0.1.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bcec881020c684085e55a25f7fd888954d56609ef363479dc5a1305eb0d40cab"
+checksum = "8725e1dfadb3a50f7e5ce0b1a540466f6ed3fe7a0fca2ac2b8b831d31316bd00"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -2122,9 +2126,9 @@ dependencies = [
 
 [[package]]
 name = "sha2"
-version = "0.10.7"
+version = "0.10.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "479fb9d862239e610720565ca91403019f2f00410f1864c5aa7479b950a76ed8"
+checksum = "793db75ad2bcafc3ffa7c68b215fee268f537982cd901d132f89c6343f3a3dc8"
 dependencies = [
  "cfg-if",
  "cpufeatures",
@@ -2143,9 +2147,9 @@ dependencies = [
 
 [[package]]
 name = "sharded-slab"
-version = "0.1.4"
+version = "0.1.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "900fba806f70c630b0a382d0d825e17a0f19fcd059a2ade1ff237bcddf446b31"
+checksum = "f40ca3c46823713e0d4209592e8d6e826aa57e928f09752619fc696c499637f6"
 dependencies = [
  "lazy_static",
 ]
@@ -2158,9 +2162,9 @@ checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
 
 [[package]]
 name = "slab"
-version = "0.4.8"
+version = "0.4.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6528351c9bc8ab22353f9d776db39a20288e8d6c37ef8cfe3317cf875eecfc2d"
+checksum = "8f92a496fb766b417c996b9c5e57daf2f7ad3b0bebe1ccfca4856390e3d3bb67"
 dependencies = [
  "autocfg",
 ]
@@ -2173,9 +2177,9 @@ checksum = "942b4a808e05215192e39f4ab80813e599068285906cc91aa64f923db842bd5a"
 
 [[package]]
 name = "sp-application-crypto"
-version = "25.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7fa730e4f3a2aec3f4ee777410599a86eb17067ee5410c58ab496e88d7bb840c"
+checksum = "b74454c936a45ac55c8de95b9fd8b5e38f8b43d97df8f4274dd6777b20d95569"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2187,9 +2191,9 @@ dependencies = [
 
 [[package]]
 name = "sp-arithmetic"
-version = "18.0.0"
+version = "19.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2d3d3ff6d6d717d7563659e9e47e958d33ebd2d0b3d8b1a9961cf9832944375e"
+checksum = "e41f710a77e9debd1c9b80f862709dce648e50f0904cde4117488e7d11d4796d"
 dependencies = [
  "integer-sqrt",
  "num-traits",
@@ -2202,13 +2206,12 @@ dependencies = [
 
 [[package]]
 name = "sp-core"
-version = "23.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "412e2ec53b1bc63778e2d70c347224e6cd2e25c4bacb509585db85f0788747b7"
+checksum = "7921d278ed2aebbb21a644c96e09663dc49a6139d1e2e063c059dc9f866e149b"
 dependencies = [
  "array-bytes",
- "arrayvec 0.7.2",
- "bitflags",
+ "bitflags 1.3.2",
  "blake2",
  "bounded-collections",
  "bs58",
@@ -2249,34 +2252,34 @@ dependencies = [
 
 [[package]]
 name = "sp-core-hashing"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "558116d02341b6f28b033c19a2a5fa555afa3c52628639170087e7685d51e743"
+checksum = "a7cb5c31aa385d6997a5b73fdc9837c1c0145559205198555c3000739a474767"
 dependencies = [
  "blake2b_simd",
  "byteorder",
  "digest 0.10.7",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "sha3",
  "twox-hash",
 ]
 
 [[package]]
 name = "sp-debug-derive"
-version = "10.0.0"
+version = "11.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4b235a0ad7124d58e6f0a728c8354da5b185b77bcf18b131b3a480cdaa23d95"
+checksum = "16f7d375610590566e11882bf5b5a4b8d0666a96ba86808b2650bbbd9be50bf8"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "sp-externalities"
-version = "0.21.0"
+version = "0.22.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "588cf40c36de918f545d712ad1a70631ae71653e4a321506dfcd8fa6fd26453c"
+checksum = "ede074871514ca7c5d2eca9563515d858c6220b47ae815714ed4393a4e99db4a"
 dependencies = [
  "environmental",
  "parity-scale-codec",
@@ -2286,9 +2289,9 @@ dependencies = [
 
 [[package]]
 name = "sp-io"
-version = "25.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e9926dba7d67d87e40f49e18ff6cfc01373d5be13e3d373f02182bb5ec8ab37b"
+checksum = "88fb6e281de5054565f07a9f79504d21133e115db549993c99f1b21236c677a5"
 dependencies = [
  "bytes",
  "ed25519-dalek",
@@ -2311,9 +2314,9 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.29.0"
+version = "0.30.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "44f0f9546dd151881c60e75355806f1cbbc893f64aa465fc5bf87a47de59467b"
+checksum = "8b9f19e773319d96223ce8dba960267e6cb977907537a8f738746ceb86592413"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
@@ -2324,9 +2327,9 @@ dependencies = [
 
 [[package]]
 name = "sp-panic-handler"
-version = "10.0.0"
+version = "11.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "261572cc0db4b41cf7587b4f7bdc15b8f83f748f17ae1c3c2f56a3e8e62ee913"
+checksum = "cd099ba2d6c1bfe5d0c79aa56e440fa3c9257eadfc0c782c09cdc2122b1e60ed"
 dependencies = [
  "backtrace",
  "lazy_static",
@@ -2335,9 +2338,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "26.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f645e9e2c82d052ea48ed987a8789daca1c03f9b5ed1aa49cd080092eda85330"
+checksum = "46c0641e1a9d340960b562bcceea1457680fd0e109fc1040f8f5364fd7bc2506"
 dependencies = [
  "either",
  "hash256-std-hasher",
@@ -2358,9 +2361,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface"
-version = "19.0.0"
+version = "20.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6ef767d6e400ee54a420bcbc570030741420c2d938a6e379d21cab9875a339c5"
+checksum = "17a4030ad93f05c93f2cc294c74bc5fea227f90fb3d1426d4a6f165e017fb7ea"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
@@ -2377,22 +2380,22 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fdd795a4a2205b64d95da897f85b7c83a0044f30df22b0ea282f8387dc6ca428"
+checksum = "b232943ee7ca83a6d56face33b8af12e9fb470a15a53835f4e12a6e452a41c1c"
 dependencies = [
  "Inflector",
  "proc-macro-crate 1.3.1",
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
 name = "sp-state-machine"
-version = "0.30.0"
+version = "0.31.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "771dce7d78335718ab8475984b6dbc1f374777049ed1c308186679e611333be2"
+checksum = "2bf4c76bea1a9e4a2e79afe70f42f1d368a8a45308e58f19bfd755c5ddb2b4a3"
 dependencies = [
  "hash-db",
  "log",
@@ -2412,15 +2415,15 @@ dependencies = [
 
 [[package]]
 name = "sp-std"
-version = "10.0.0"
+version = "11.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3ed09ef1760e8be9b64b7f739f1cf9a94528130be475d8e4f2d1be1e690c9f9c"
+checksum = "8c91d32e165d08a14098ce5ec923eaec59d1d0583758a18a770beec1b780b0d0"
 
 [[package]]
 name = "sp-storage"
-version = "15.0.0"
+version = "16.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c20f503280c004d94033a32cb84274ede30ef0b4b634770b1e7d595f8245bda4"
+checksum = "ac9660ecd48314443e73ad0f44d58b76426666a1343d72f6f65664e174da9244"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
@@ -2432,9 +2435,9 @@ dependencies = [
 
 [[package]]
 name = "sp-tracing"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ebabec43485ebdb2fdb5c6f9b388590d4797a3888024d74724ada2f16b2113b8"
+checksum = "69a61948986d2a9f8d67d60884ff0277d910df09ebe08d0e1f309da777516453"
 dependencies = [
  "parity-scale-codec",
  "sp-std",
@@ -2445,9 +2448,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "24.0.0"
+version = "25.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e78585a84d02d1c71e8eb8c00ed586c22a46ad4e773d9ff65c8ed3b8e98b9f51"
+checksum = "4bb2d292eb90452dcb0909fb44e74bf04395e3ffa37a66c0f1635a00600382a4"
 dependencies = [
  "ahash 0.8.3",
  "hash-db",
@@ -2469,9 +2472,9 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "16.0.0"
+version = "17.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee009ac79098027f5990984e0c5ee2fd4883b16bbd6ab97931f28c2148aaa3ea"
+checksum = "bf43bb0c8eb76dc41057ce0fb6b744b94c9aec28b31dff53a1efc4f04ef25384"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
@@ -2483,9 +2486,9 @@ dependencies = [
 
 [[package]]
 name = "sp-weights"
-version = "22.0.0"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "86566cae93412e40bea0db9e6b110a7379105412a9aed1af73b5d2fb69cb7000"
+checksum = "4e1cef0aad13ed8a8522a6e86ace16fb97ab220c16d2357e628352b528582693"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2509,9 +2512,9 @@ dependencies = [
 
 [[package]]
 name = "ss58-registry"
-version = "1.40.0"
+version = "1.43.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb47a8ad42e5fc72d5b1eb104a5546937eaf39843499948bb666d6e93c62423b"
+checksum = "5e6915280e2d0db8911e5032a5c275571af6bdded2916abd691a659be25d3439"
 dependencies = [
  "Inflector",
  "num-format",
@@ -2587,9 +2590,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.32"
+version = "2.0.38"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "239814284fd6f1a4ffe4ca893952cdd93c224b6a1571c9a9eadd670295c0c9e2"
+checksum = "e96b79aaa137db8f61e26363a0c9b47d8b4ec75da28b7d1d614c2303e232408b"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2604,15 +2607,15 @@ checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369"
 
 [[package]]
 name = "target-lexicon"
-version = "0.12.7"
+version = "0.12.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fd1ba337640d60c3e96bc6f0638a939b9c9a7f2c316a1598c279828b3d1dc8c5"
+checksum = "9d0e916b1148c8e263850e1ebcbd046f333e0683c724876bb0da63ea4373dc8a"
 
 [[package]]
 name = "tendermint"
-version = "0.33.0"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6d550db02d6bec4ebcbbebc4301ec22181bc489c37fb3f167e64b14c1be8321"
+checksum = "bc2294fa667c8b548ee27a9ba59115472d0a09c2ba255771092a7f1dcf03a789"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -2628,7 +2631,7 @@ dependencies = [
  "serde_bytes",
  "serde_json",
  "serde_repr",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "signature",
  "subtle",
  "subtle-encoding",
@@ -2639,9 +2642,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.33.0"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6bc1e4e3dd6f65cfa7979cf721b5afa1d79d32c4a2fe5fddb6416a98638634a9"
+checksum = "74994da9de4b1144837a367ca2c60c650f5526a7c1a54760a3020959b522e474"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -2652,9 +2655,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.33.0"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1834fa2eb884ba69b9c0eea55f0178270bed421217596ca4e54c19ef75dcb660"
+checksum = "2cc728a4f9e891d71adf66af6ecaece146f9c7a11312288a3107b3e1d6979aaf"
 dependencies = [
  "bytes",
  "flex-error",
@@ -2670,22 +2673,22 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.48"
+version = "1.0.49"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d6d7a740b8a666a7e828dd00da9c0dc290dff53154ea77ac109281de90589b7"
+checksum = "1177e8c6d7ede7afde3585fd2513e611227efd6481bd78d2e82ba1ce16557ed4"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.48"
+version = "1.0.49"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49922ecae66cc8a249b77e68d1d0623c1b2c514f0060c27cdc68bd62a1219d35"
+checksum = "10712f02019e9288794769fba95cd6847df9874d49d871d062172f9dd41bc4cc"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -2700,25 +2703,26 @@ dependencies = [
 
 [[package]]
 name = "time"
-version = "0.3.21"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f3403384eaacbca9923fa06940178ac13e4edb725486d70e8e15881d0c836cc"
+checksum = "426f806f4089c493dcac0d24c29c01e2c38baf8e30f1b716ee37e83d200b18fe"
 dependencies = [
+ "deranged",
  "time-core",
  "time-macros",
 ]
 
 [[package]]
 name = "time-core"
-version = "0.1.1"
+version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7300fbefb4dadc1af235a9cef3737cea692a9d97e1b9cbcd4ebdae6f8868e6fb"
+checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.9"
+version = "0.2.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "372950940a5f07bf38dbe211d7283c9e6d7327df53794992d293e534c733d09b"
+checksum = "4ad70d68dba9e1f8aceda7aa6711965dfec1cac869f311a51bd08b3a2ccbce20"
 dependencies = [
  "time-core",
 ]
@@ -2735,7 +2739,7 @@ dependencies = [
  "pbkdf2 0.11.0",
  "rand 0.8.5",
  "rustc-hash",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "thiserror",
  "unicode-normalization",
  "wasm-bindgen",
@@ -2768,17 +2772,17 @@ dependencies = [
 
 [[package]]
 name = "toml_datetime"
-version = "0.6.2"
+version = "0.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a76a9312f5ba4c2dec6b9161fdf25d87ad8a09256ccea5a556fef03c706a10f"
+checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
 
 [[package]]
 name = "toml_edit"
-version = "0.19.10"
+version = "0.19.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2380d56e8670370eee6566b0bfd4265f65b3f432e8c6d85623f728d4fa31f739"
+checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
 dependencies = [
- "indexmap",
+ "indexmap 2.0.2",
  "toml_datetime",
  "winnow",
 ]
@@ -2797,13 +2801,13 @@ dependencies = [
 
 [[package]]
 name = "tracing-attributes"
-version = "0.1.24"
+version = "0.1.26"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0f57e3ca2a01450b1a921183a9c9cbfda207fd822cef4ccb00a65402cbba7a74"
+checksum = "5f4f31f56159e98206da9efd823404b79b6ef3143b4a7ab76e67b1751b25a4ab"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
 
 [[package]]
@@ -2861,9 +2865,9 @@ dependencies = [
 
 [[package]]
 name = "trie-db"
-version = "0.27.1"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "767abe6ffed88a1889671a102c2861ae742726f52e0a5a425b92c9fbfa7e9c85"
+checksum = "ff28e0f815c2fea41ebddf148e008b077d2faddb026c9555b29696114d602642"
 dependencies = [
  "hash-db",
  "hashbrown 0.13.2",
@@ -2895,9 +2899,9 @@ dependencies = [
 
 [[package]]
 name = "typenum"
-version = "1.16.0"
+version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "497961ef93d974e23eb6f433eb5fe1b7930b659f06d12dec6fc44a8f554c0bba"
+checksum = "42ff0bf0c66b8238c6f3b578df37d0b7848e55df8577b3f74f92a69acceeb825"
 
 [[package]]
 name = "uint"
@@ -2919,9 +2923,9 @@ checksum = "92888ba5573ff080736b3648696b70cafad7d250551175acbaa4e0385b3e1460"
 
 [[package]]
 name = "unicode-ident"
-version = "1.0.9"
+version = "1.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b15811caf2415fb889178633e7724bad2509101cde276048e013b9def5e51fa0"
+checksum = "3354b9ac3fae1ff6755cb6db53683adb661634f67557942dea4facebec0fee4b"
 
 [[package]]
 name = "unicode-normalization"
@@ -2940,9 +2944,9 @@ checksum = "f962df74c8c05a667b5ee8bcf162993134c104e96440b663c8daa176dc772d8c"
 
 [[package]]
 name = "url"
-version = "2.4.0"
+version = "2.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "50bff7831e19200a85b17131d085c25d7811bc4e186efdaf54bbd132994a88cb"
+checksum = "143b538f18257fac9cad154828a57c6bf5157e1aa604d4816b5995bf6de87ae5"
 dependencies = [
  "form_urlencoded",
  "idna",
@@ -2975,9 +2979,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.86"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5bba0e8cb82ba49ff4e229459ff22a191bbe9a1cb3a341610c9c33efc27ddf73"
+checksum = "7706a72ab36d8cb1f80ffbf0e071533974a60d0a308d01a5d0375bf60499a342"
 dependencies = [
  "cfg-if",
  "wasm-bindgen-macro",
@@ -2985,24 +2989,24 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-backend"
-version = "0.2.86"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "19b04bc93f9d6bdee709f6bd2118f57dd6679cf1176a1af464fca3ab0d66d8fb"
+checksum = "5ef2b6d3c510e9625e5fe6f509ab07d66a760f0885d858736483c32ed7809abd"
 dependencies = [
  "bumpalo",
  "log",
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.86"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14d6b024f1a526bb0234f52840389927257beb670610081360e5a03c5df9c258"
+checksum = "dee495e55982a3bd48105a7b947fd2a9b4a8ae3010041b9e0faab3f9cd028f1d"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -3010,22 +3014,22 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.86"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e128beba882dd1eb6200e1dc92ae6c5dbaa4311aa7bb211ca035779e5efc39f8"
+checksum = "54681b18a46765f095758388f2d0cf16eb8d4169b639ab575a8f5693af210c7b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.86"
+version = "0.2.87"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed9d5b4305409d1fc9482fee2d7f9bcbf24b3972bf59817ef757e23982242a93"
+checksum = "ca6ad05a4870b2bf5fe995117d3728437bd27d7cd5f06f13c17443ef369775a1"
 
 [[package]]
 name = "wasmparser"
@@ -3033,7 +3037,7 @@ version = "0.102.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "48134de3d7598219ab9eaf6b91b15d8e50d31da76b8519fe4ecfcec2cf35104b"
 dependencies = [
- "indexmap",
+ "indexmap 1.9.3",
  "url",
 ]
 
@@ -3046,10 +3050,10 @@ dependencies = [
  "anyhow",
  "bincode",
  "cfg-if",
- "indexmap",
+ "indexmap 1.9.3",
  "libc",
  "log",
- "object",
+ "object 0.30.4",
  "once_cell",
  "paste",
  "psm",
@@ -3079,10 +3083,10 @@ checksum = "a990198cee4197423045235bf89d3359e69bd2ea031005f4c2d901125955c949"
 dependencies = [
  "anyhow",
  "cranelift-entity",
- "gimli",
- "indexmap",
+ "gimli 0.27.3",
+ "indexmap 1.9.3",
  "log",
- "object",
+ "object 0.30.4",
  "serde",
  "target-lexicon",
  "thiserror",
@@ -3096,14 +3100,14 @@ version = "8.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0de48df552cfca1c9b750002d3e07b45772dd033b0b206d5c0968496abf31244"
 dependencies = [
- "addr2line",
+ "addr2line 0.19.0",
  "anyhow",
  "bincode",
  "cfg-if",
  "cpp_demangle",
- "gimli",
+ "gimli 0.27.3",
  "log",
- "object",
+ "object 0.30.4",
  "rustc-demangle",
  "serde",
  "target-lexicon",
@@ -3142,7 +3146,7 @@ dependencies = [
  "anyhow",
  "cc",
  "cfg-if",
- "indexmap",
+ "indexmap 1.9.3",
  "libc",
  "log",
  "mach",
@@ -3150,7 +3154,7 @@ dependencies = [
  "memoffset",
  "paste",
  "rand 0.8.5",
- "rustix 0.36.14",
+ "rustix 0.36.15",
  "wasmtime-asm-macros",
  "wasmtime-environ",
  "wasmtime-jit-debug",
@@ -3197,7 +3201,7 @@ version = "0.48.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e686886bc078bc1b0b600cac0147aadb815089b6e4da64016cbd754b6342700f"
 dependencies = [
- "windows-targets 0.48.0",
+ "windows-targets 0.48.5",
 ]
 
 [[package]]
@@ -3215,7 +3219,7 @@ version = "0.48.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9"
 dependencies = [
- "windows-targets 0.48.0",
+ "windows-targets 0.48.5",
 ]
 
 [[package]]
@@ -3235,17 +3239,17 @@ dependencies = [
 
 [[package]]
 name = "windows-targets"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7b1eb6f0cd7c80c79759c929114ef071b87354ce476d9d94271031c0497adfd5"
+checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c"
 dependencies = [
- "windows_aarch64_gnullvm 0.48.0",
- "windows_aarch64_msvc 0.48.0",
- "windows_i686_gnu 0.48.0",
- "windows_i686_msvc 0.48.0",
- "windows_x86_64_gnu 0.48.0",
- "windows_x86_64_gnullvm 0.48.0",
- "windows_x86_64_msvc 0.48.0",
+ "windows_aarch64_gnullvm 0.48.5",
+ "windows_aarch64_msvc 0.48.5",
+ "windows_i686_gnu 0.48.5",
+ "windows_i686_msvc 0.48.5",
+ "windows_x86_64_gnu 0.48.5",
+ "windows_x86_64_gnullvm 0.48.5",
+ "windows_x86_64_msvc 0.48.5",
 ]
 
 [[package]]
@@ -3256,9 +3260,9 @@ checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
 
 [[package]]
 name = "windows_aarch64_gnullvm"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "91ae572e1b79dba883e0d315474df7305d12f569b400fcf90581b06062f7e1bc"
+checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
 
 [[package]]
 name = "windows_aarch64_msvc"
@@ -3268,9 +3272,9 @@ checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
 
 [[package]]
 name = "windows_aarch64_msvc"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b2ef27e0d7bdfcfc7b868b317c1d32c641a6fe4629c171b8928c7b08d98d7cf3"
+checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
 
 [[package]]
 name = "windows_i686_gnu"
@@ -3280,9 +3284,9 @@ checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
 
 [[package]]
 name = "windows_i686_gnu"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "622a1962a7db830d6fd0a69683c80a18fda201879f0f447f065a3b7467daa241"
+checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
 
 [[package]]
 name = "windows_i686_msvc"
@@ -3292,9 +3296,9 @@ checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
 
 [[package]]
 name = "windows_i686_msvc"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4542c6e364ce21bf45d69fdd2a8e455fa38d316158cfd43b3ac1c5b1b19f8e00"
+checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
 
 [[package]]
 name = "windows_x86_64_gnu"
@@ -3304,9 +3308,9 @@ checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
 
 [[package]]
 name = "windows_x86_64_gnu"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca2b8a661f7628cbd23440e50b05d705db3686f894fc9580820623656af974b1"
+checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
 
 [[package]]
 name = "windows_x86_64_gnullvm"
@@ -3316,9 +3320,9 @@ checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
 
 [[package]]
 name = "windows_x86_64_gnullvm"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7896dbc1f41e08872e9d5e8f8baa8fdd2677f29468c4e156210174edc7f7b953"
+checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
 
 [[package]]
 name = "windows_x86_64_msvc"
@@ -3328,15 +3332,15 @@ checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"
 
 [[package]]
 name = "windows_x86_64_msvc"
-version = "0.48.0"
+version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1a515f5799fe4961cb532f983ce2b23082366b898e52ffbce459c86f67c8378a"
+checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
 
 [[package]]
 name = "winnow"
-version = "0.4.6"
+version = "0.5.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "61de7bac303dc551fe038e2b3cef0f571087a47571ea6e79a87692ac99b99699"
+checksum = "037711d82167854aff2018dfd193aa0fef5370f456732f0d5a0c59b0f1b4b907"
 dependencies = [
  "memchr",
 ]
@@ -3367,5 +3371,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.32",
+ "syn 2.0.38",
 ]
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 7ead62982..81acb9a70 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,19 +6,19 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../crates/ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.35.0", default-features = false, features = [
+ibc-proto = { version = "0.37.1", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
 ] }
-tendermint = { version = "0.33", default-features = false }
-tendermint-proto = { version = "0.33", default-features = false }
-tendermint-light-client-verifier = { version = "0.33", default-features = false, features = ["rust-crypto"] }
+tendermint = { version = "0.34", default-features = false }
+tendermint-proto = { version = "0.34", default-features = false }
+tendermint-light-client-verifier = { version = "0.34", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "23.0.0", default-features = false, optional = true }
-sp-io = { version = "25.0.0", default-features = false, optional = true }
-sp-runtime = { version = "26.0.0", default-features = false, optional = true }
-sp-std = { version = "10.0.0", default-features = false, optional = true }
+sp-core = { version = "24.0.0", default-features = false, optional = true }
+sp-io = { version = "26.0.0", default-features = false, optional = true }
+sp-runtime = { version = "27.0.0", default-features = false, optional = true }
+sp-std = { version = "11.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
index 6236378a0..101934f1f 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/crates/ibc-query/Cargo.toml
@@ -19,6 +19,6 @@ std = ["ibc-proto/std", "ibc/std"]
 
 [dependencies]
 ibc = { version = "0.46.0", path = "../ibc", default-features = false }
-ibc-proto = { version = "0.35.0", default-features = false, features = ["server"] }
+ibc-proto = { version = "0.37.1", default-features = false, features = ["server"] }
 displaydoc = { version = "0.2", default-features = false }
-tonic = "0.9"
+tonic = "0.10"
diff --git a/crates/ibc-query/src/core/channel/query.rs b/crates/ibc-query/src/core/channel/query.rs
index 48eef8463..15a1db5ca 100644
--- a/crates/ibc-query/src/core/channel/query.rs
+++ b/crates/ibc-query/src/core/channel/query.rs
@@ -7,7 +7,7 @@ use ibc::core::ics04_channel::packet::Sequence;
 use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
 use ibc::core::ics24_host::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
-    ReceiptPath, SeqRecvPath, SeqSendPath,
+    ReceiptPath, SeqRecvPath,
 };
 use ibc::core::ValidationContext;
 use ibc::Height;
@@ -18,12 +18,12 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
     QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
-    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
-    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
-    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
-    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
-    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
-    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+    QueryPacketAcknowledgementRequest, QueryPacketAcknowledgementResponse,
+    QueryPacketAcknowledgementsRequest, QueryPacketAcknowledgementsResponse,
+    QueryPacketCommitmentRequest, QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest,
+    QueryPacketCommitmentsResponse, QueryPacketReceiptRequest, QueryPacketReceiptResponse,
+    QueryUnreceivedAcksRequest, QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest,
+    QueryUnreceivedPacketsResponse,
 };
 use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
 
@@ -469,39 +469,12 @@ where
     })
 }
 
-/// Queries for the next sequence send associated with a channel
-pub fn query_next_sequence_send<I>(
-    ibc_ctx: &I,
-    request: &QueryNextSequenceSendRequest,
-) -> Result<QueryNextSequenceSendResponse, QueryError>
-where
-    I: ValidationContext + ProvableContext,
-{
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
-
-    let next_sequence_send = ibc_ctx.get_next_sequence_send(&next_seq_send_path)?;
-
-    let current_height = ibc_ctx.host_height()?;
-
-    let proof = ibc_ctx
-        .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Next sequence send proof not found for channel {}",
-                channel_id
-            ),
-        })?;
-
-    Ok(QueryNextSequenceSendResponse {
-        next_sequence_send: next_sequence_send.into(),
-        proof,
-        proof_height: Some(current_height.into()),
-    })
-}
+// NOTE: The [previous `query_next_sequence_send`
+// method](https://github.com/cosmos/ibc-rs/blob/a4a5f78405bd3a28c060df6c65438edf0b02e9e2/crates/ibc-query/src/core/channel/query.rs#L472-L504)
+// is currently not present in the generated protobuf from `ibc-go` v0.7.3.
+// However, this method has been reintroduced through [this
+// PR](https://github.com/cosmos/ibc-go/pull/3417) in ibc-go. Once included in a
+// new release, we can implement this method call.
 
 /// Queries for the next sequence receive associated with a channel
 pub fn query_next_sequence_receive<I>(
diff --git a/crates/ibc-query/src/core/channel/service.rs b/crates/ibc-query/src/core/channel/service.rs
index b797ac146..9e5d42263 100644
--- a/crates/ibc-query/src/core/channel/service.rs
+++ b/crates/ibc-query/src/core/channel/service.rs
@@ -14,21 +14,20 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
     QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
-    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
-    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
-    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
-    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
-    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
-    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+    QueryPacketAcknowledgementRequest, QueryPacketAcknowledgementResponse,
+    QueryPacketAcknowledgementsRequest, QueryPacketAcknowledgementsResponse,
+    QueryPacketCommitmentRequest, QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest,
+    QueryPacketCommitmentsResponse, QueryPacketReceiptRequest, QueryPacketReceiptResponse,
+    QueryUnreceivedAcksRequest, QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest,
+    QueryUnreceivedPacketsResponse,
 };
 use tonic::{Request, Response, Status};
 
 use super::{
     query_channel, query_channel_client_state, query_channel_consensus_state, query_channels,
-    query_connection_channels, query_next_sequence_receive, query_next_sequence_send,
-    query_packet_acknowledgement, query_packet_acknowledgements, query_packet_commitment,
-    query_packet_commitments, query_packet_receipt, query_unreceived_acks,
-    query_unreceived_packets,
+    query_connection_channels, query_next_sequence_receive, query_packet_acknowledgement,
+    query_packet_acknowledgements, query_packet_commitment, query_packet_commitments,
+    query_packet_receipt, query_unreceived_acks, query_unreceived_packets,
 };
 use crate::core::context::QueryContext;
 
@@ -176,15 +175,6 @@ where
         Ok(Response::new(response))
     }
 
-    async fn next_sequence_send(
-        &self,
-        request: Request<QueryNextSequenceSendRequest>,
-    ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
-        let response = query_next_sequence_send(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
-    }
-
     async fn next_sequence_receive(
         &self,
         request: Request<QueryNextSequenceReceiveRequest>,
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 230e4b282..24d57a030 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,14 +50,14 @@ mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.35.0", default-features = false, features = ["serde"] }
-ics23 = { version = "0.10.1", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.29", default-features = false }
+ibc-proto = { version = "0.37.1", default-features = false, features = ["serde"] }
+ics23 = { version = "0.11", default-features = false, features = ["host-functions"] }
+time = { version = ">=0.3.0, <0.3.30", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json = { version = "1", default-features = false, optional = true }
 tracing = { version = "0.1.36", default-features = false }
-prost = { version = "0.11", default-features = false }
+prost = { version = "0.12", default-features = false }
 bytes = { version = "1.2.1", default-features = false }
 subtle-encoding = { version = "0.5", default-features = false }
 sha2 = { version = "0.10.6", default-features = false }
@@ -79,20 +79,20 @@ ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
 schemars = { version = "0.8.12", optional = true }
 
 [dependencies.tendermint]
-version = "0.33"
+version = "0.34"
 default-features = false
 
 [dependencies.tendermint-proto]
-version = "0.33"
+version = "0.34"
 default-features = false
 
 [dependencies.tendermint-light-client-verifier]
-version = "0.33"
+version = "0.34"
 default-features = false
 features = ["rust-crypto"]
 
 [dependencies.tendermint-testgen]
-version = "0.33"
+version = "0.34"
 optional = true
 default-features = false
 
@@ -101,6 +101,6 @@ env_logger = "0.10.0"
 rstest = "0.18.1"
 tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
 test-log = { version = "0.2.10", features = ["trace"] }
-tendermint-rpc = { version = "0.33", features = ["http-client", "websocket-client"] }
-tendermint-testgen = { version = "0.33" } # Needed for generating (synthetic) light blocks.
+tendermint-rpc = { version = "0.34", features = ["http-client", "websocket-client"] }
+tendermint-testgen = { version = "0.34" } # Needed for generating (synthetic) light blocks.
 parking_lot = { version = "0.12.1" }
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index d2a885b46..72f49d0b2 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -42,6 +42,7 @@ impl Protobuf<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {}
 impl TryFrom<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {
     type Error = ClientError;
 
+    #[allow(deprecated)]
     fn try_from(raw: RawMsgSubmitMisbehaviour) -> Result<Self, Self::Error> {
         let raw_misbehaviour = raw
             .misbehaviour
@@ -60,6 +61,7 @@ impl TryFrom<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {
 
 impl From<MsgSubmitMisbehaviour> for RawMsgSubmitMisbehaviour {
     fn from(ics_msg: MsgSubmitMisbehaviour) -> Self {
+        #[allow(deprecated)]
         RawMsgSubmitMisbehaviour {
             client_id: ics_msg.client_id.to_string(),
             misbehaviour: Some(ics_msg.misbehaviour),

From a2efb0eb8f9c3c6eb544f66208df85861b8f0747 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 12 Oct 2023 12:45:49 -0700
Subject: [PATCH 041/182] chore: add v0.44.2 release content to the main (#919)

* fix: tmclient update header validation for v0.44.x (#917)

* test for tmclient update with different validator sets

* fix doc lints

* rm incorrect check

* add changelog entry

* chore: prep v0.44.2 release (#918)

---------

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../911-fix-header-validation-during-tmclient-update.md  | 2 ++
 .changelog/v0.44.2/summary.md                            | 4 ++++
 CHANGELOG.md                                             | 9 +++++++++
 3 files changed, 15 insertions(+)
 create mode 100644 .changelog/v0.44.2/bug-fixes/911-fix-header-validation-during-tmclient-update.md
 create mode 100644 .changelog/v0.44.2/summary.md

diff --git a/.changelog/v0.44.2/bug-fixes/911-fix-header-validation-during-tmclient-update.md b/.changelog/v0.44.2/bug-fixes/911-fix-header-validation-during-tmclient-update.md
new file mode 100644
index 000000000..ba6cdb634
--- /dev/null
+++ b/.changelog/v0.44.2/bug-fixes/911-fix-header-validation-during-tmclient-update.md
@@ -0,0 +1,2 @@
+- Remove an incorrect validation during tendermint client update
+  ([\#911](https://github.com/cosmos/ibc-rs/issues/911))
diff --git a/.changelog/v0.44.2/summary.md b/.changelog/v0.44.2/summary.md
new file mode 100644
index 000000000..c80a7d4f3
--- /dev/null
+++ b/.changelog/v0.44.2/summary.md
@@ -0,0 +1,4 @@
+This release is a critical patch release that introduces a vital fix by removing
+an incorrect validation during a Tendermint client update.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ad468827e..ac9eeb4e6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -92,6 +92,15 @@ There are no consensus-breaking changes.
 - Remove unused code snippets and move serializer roundtrip test to `serializers.rs`
   ([#869](https://github.com/cosmos/ibc-rs/issues/869))
 
+## v0.44.2
+
+*October 12, 2023*
+
+This release is a critical patch release that introduces a vital fix by removing
+an incorrect validation during a Tendermint client update.
+
+There are no consensus-breaking changes.
+
 ## v0.44.1
 
 *August 4, 2023*

From 245d2fc3d53d7b3c9eb6d2380580c798aa150fe9 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 13 Oct 2023 07:28:53 -0700
Subject: [PATCH 042/182] f32/f64/usize in cosmwasm(and other no f32/f64 envs)
 reproduction and fixes (#894)

* fixed f64/f32 validation in wasm

* what to do with serde json? main one is float, fork from cw is std, my fork pr not merged for no std

* apply some adjustments + update cargo.lock for cw-check

* deps: bump serde-json-wasm to v1.0.0

* chore: add unclog

* ci: add cw-check

* fix: remove cachix

* fix: not needed to install/cache Rust in CI

* imp: run CI only on releases and main branch

* nit: on pull_request

* nit: max_history_size as u64

* test: calculate_block_delay

* nit: remove u64::max

* Apply suggestions from code review

Co-authored-by: Romain Ruetschi <romain@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: dzmitry-lahoda <dzmitry@lahoda.pro>
Co-authored-by: Romain Ruetschi <romain@informal.systems>
---
 ...-fix-wasm-compilation-error-with-floats.md |    4 +
 .github/workflows/cw-check.yaml               |   38 +
 .github/workflows/no-std.yaml                 |    4 +-
 Cargo.toml                                    |    1 +
 ci/cw-check/Cargo.lock                        | 1456 +++++++++++++++++
 ci/cw-check/Cargo.toml                        |   24 +
 ci/cw-check/rust-toolchain.toml               |    5 +
 ci/cw-check/shell.nix                         |   16 +
 ci/cw-check/src/lib.rs                        |   64 +
 ci/no-std-check/Cargo.lock                    |   41 +-
 crates/ibc/Cargo.toml                         |    8 +-
 crates/ibc/clippy.toml                        |   10 +
 .../ibc/src/applications/transfer/amount.rs   |    3 +-
 crates/ibc/src/applications/transfer/denom.rs |    8 +-
 crates/ibc/src/applications/transfer/error.rs |    6 +-
 .../clients/ics07_tendermint/client_state.rs  |    2 +-
 .../ics03_connection/handler/conn_open_try.rs |    2 +-
 crates/ibc/src/core/ics04_channel/channel.rs  |    6 +-
 crates/ibc/src/core/ics04_channel/context.rs  |   40 +-
 crates/ibc/src/core/ics04_channel/error.rs    |    2 +-
 .../ibc/src/core/ics23_commitment/merkle.rs   |    8 +-
 crates/ibc/src/core/ics24_host/identifier.rs  |   13 +-
 .../core/ics24_host/identifier/validate.rs    |   10 +-
 crates/ibc/src/lib.rs                         |    1 +
 crates/ibc/src/mock/context.rs                |   26 +-
 crates/ibc/src/serializers.rs                 |   11 +-
 26 files changed, 1737 insertions(+), 72 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
 create mode 100644 .github/workflows/cw-check.yaml
 create mode 100644 ci/cw-check/Cargo.lock
 create mode 100644 ci/cw-check/Cargo.toml
 create mode 100644 ci/cw-check/rust-toolchain.toml
 create mode 100644 ci/cw-check/shell.nix
 create mode 100644 ci/cw-check/src/lib.rs
 create mode 100644 crates/ibc/clippy.toml

diff --git a/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md b/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
new file mode 100644
index 000000000..ca866767a
--- /dev/null
+++ b/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
@@ -0,0 +1,4 @@
+- Fix compilation issue with Wasm envs because of floats
+  - Use `serde-json-wasm` dependency instead of `serde-json` for no-floats support
+  - Add CI test to include CosmWasm compilation check
+([/#850](https://github.com/cosmos/ibc-rs/issues/850))
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
new file mode 100644
index 000000000..e06e19251
--- /dev/null
+++ b/.github/workflows/cw-check.yaml
@@ -0,0 +1,38 @@
+name: CosmWasm Compilation Check
+on:
+  pull_request:
+    paths:
+      - .github/workflows/cw-check.yml
+      - ci/cw-check/**
+
+on:
+  push:
+    tags:
+      - v[0-9]+.*
+    branches:
+      - 'release/*'
+      - main
+    paths:
+      - .github/workflows/cw-check.yml
+      - Cargo.toml
+      - Cargo.lock
+      - ci/cw-check/**
+      - crates/**
+
+jobs:
+  cw-check:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v22
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+          extra_nix_config: |
+            experimental-features = nix-command flakes
+
+      - name: Run cw-check
+        run: |
+          cd ci/cw-check
+          nix-shell --run "cw-check"
\ No newline at end of file
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index f2e0c3407..47a2005a3 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -5,7 +5,7 @@ on:
       - .github/workflows/no-std.yml
       - Cargo.toml
       - Cargo.lock
-      - ci/**
+      - ci/no-std-check/**
       - crates/**
   push:
     branches: main
@@ -13,7 +13,7 @@ on:
       - .github/workflows/no-std.yml
       - Cargo.toml
       - Cargo.lock
-      - ci/**
+      - ci/no-std-check/**
       - crates/**
 
 jobs:
diff --git a/Cargo.toml b/Cargo.toml
index d1fa2ad83..5d7413065 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -9,5 +9,6 @@ members = [
 ]
 
 exclude = [
+    "ci/cw-check",
     "ci/no-std-check",
 ]
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
new file mode 100644
index 000000000..b72af99c7
--- /dev/null
+++ b/ci/cw-check/Cargo.lock
@@ -0,0 +1,1456 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 3
+
+[[package]]
+name = "ahash"
+version = "0.7.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fcb51a0695d8f838b1ee009b3fbf66bda078cd64590202a864a8f3e8c4315c47"
+dependencies = [
+ "getrandom",
+ "once_cell",
+ "version_check",
+]
+
+[[package]]
+name = "anyhow"
+version = "1.0.72"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3b13c32d80ecc7ab747b80c3784bce54ee8a7a0cc4fbda9bf4cda2cf6fe90854"
+
+[[package]]
+name = "arrayvec"
+version = "0.7.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
+
+[[package]]
+name = "autocfg"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
+
+[[package]]
+name = "base16ct"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "349a06037c7bf932dd7e7d1f653678b2038b9ad46a74102f1fc7bd7872678cce"
+
+[[package]]
+name = "base64"
+version = "0.13.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
+
+[[package]]
+name = "base64"
+version = "0.21.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "604178f6c5c21f02dc555784810edfb88d34ac2c73b2eae109655649ee73ce3d"
+
+[[package]]
+name = "base64ct"
+version = "1.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8c3c1a368f70d6cf7302d78f8f7093da241fb8e8807c05cc9e51a125895a6d5b"
+
+[[package]]
+name = "block-buffer"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4152116fd6e9dadb291ae18fc1ec3575ed6d84c29642d97890f4b4a3417297e4"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "bnum"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "845141a4fade3f790628b7daaaa298a25b204fb28907eb54febe5142db6ce653"
+
+[[package]]
+name = "byte-slice-cast"
+version = "1.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c3ac9f8b63eca6fd385229b3675f6cc0dc5c8a5c8a54a59d4f52ffd670d87b0c"
+
+[[package]]
+name = "byteorder"
+version = "1.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"
+
+[[package]]
+name = "bytes"
+version = "1.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "89b2fd2a0dcf38d7971e2194b6b6eebab45ae01067456a7fd93d5547a61b70be"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "const-oid"
+version = "0.9.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "795bc6e66a8e340f075fcf6227e417a2dc976b92b91f3cdc778bb858778b6747"
+
+[[package]]
+name = "cosmwasm-crypto"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7e272708a9745dad8b591ef8a718571512130f2b39b33e3d7a27c558e3069394"
+dependencies = [
+ "digest 0.10.7",
+ "ed25519-zebra",
+ "k256",
+ "rand_core 0.6.4",
+ "thiserror",
+]
+
+[[package]]
+name = "cosmwasm-derive"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "296db6a3caca5283425ae0cf347f4e46999ba3f6620dbea8939a0e00347831ce"
+dependencies = [
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "cosmwasm-schema"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63c337e097a089e5b52b5d914a7ff6613332777f38ea6d9d36e1887cd0baa72e"
+dependencies = [
+ "cosmwasm-schema-derive",
+ "schemars",
+ "serde",
+ "serde_json",
+ "thiserror",
+]
+
+[[package]]
+name = "cosmwasm-schema-derive"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "766cc9e7c1762d8fc9c0265808910fcad755200cd0e624195a491dd885a61169"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "cosmwasm-std"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eb5e05a95fd2a420cca50f4e94eb7e70648dac64db45e90403997ebefeb143bd"
+dependencies = [
+ "base64 0.13.1",
+ "bnum",
+ "cosmwasm-crypto",
+ "cosmwasm-derive",
+ "derivative",
+ "forward_ref",
+ "hex",
+ "schemars",
+ "serde",
+ "serde-json-wasm 0.5.1",
+ "sha2 0.10.7",
+ "thiserror",
+]
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a17b76ff3a4162b0b27f354a0c87015ddad39d35f9c0c36607a3bdd175dde1f1"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crunchy"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7"
+
+[[package]]
+name = "crypto-bigint"
+version = "0.4.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ef2b4b23cddf68b89b8f8069890e8c270d54e2d5fe1b143820234805e4cb17ef"
+dependencies = [
+ "generic-array",
+ "rand_core 0.6.4",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "curve25519-dalek"
+version = "3.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b9fdf9972b2bd6af2d913799d9ebc165ea4d2e65878e329d9c6b372c4491b61"
+dependencies = [
+ "byteorder",
+ "digest 0.9.0",
+ "rand_core 0.5.1",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "curve25519-dalek-ng"
+version = "4.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1c359b7249347e46fb28804470d071c921156ad62b3eef5d34e2ba867533dec8"
+dependencies = [
+ "byteorder",
+ "digest 0.9.0",
+ "rand_core 0.6.4",
+ "subtle-ng",
+ "zeroize",
+]
+
+[[package]]
+name = "cw-check"
+version = "0.1.0"
+dependencies = [
+ "cosmwasm-schema",
+ "cosmwasm-std",
+ "ibc",
+ "serde-json-wasm 1.0.0",
+ "thiserror",
+]
+
+[[package]]
+name = "darling"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0209d94da627ab5605dcccf08bb18afa5009cfbef48d8a8b7d7bdbc79be25c5e"
+dependencies = [
+ "darling_core",
+ "darling_macro",
+]
+
+[[package]]
+name = "darling_core"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "177e3443818124b357d8e76f53be906d60937f0d3a90773a664fa63fa253e621"
+dependencies = [
+ "fnv",
+ "ident_case",
+ "proc-macro2",
+ "quote",
+ "strsim",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "darling_macro"
+version = "0.20.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
+dependencies = [
+ "darling_core",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "der"
+version = "0.6.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f1a467a65c5e759bce6e65eaf91cc29f466cdc57cb65777bd646872a8a1fd4de"
+dependencies = [
+ "const-oid",
+ "zeroize",
+]
+
+[[package]]
+name = "der"
+version = "0.7.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0c7ed52955ce76b1554f509074bb357d3fb8ac9b51288a65a3fd480d1dfba946"
+dependencies = [
+ "const-oid",
+ "zeroize",
+]
+
+[[package]]
+name = "derivative"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fcc3dd5e9e9c0b295d6e1e4d811fb6f157d5ffd784b8d202fc62eac8035a770b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "derive_more"
+version = "0.99.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fb810d30a7c1953f91334de7244731fc3f3c10d7fe163338a35b9f640960321"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "digest"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3dd60d1080a57a05ab032377049e0591415d2b31afd7028356dbf3cc6dcb066"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer 0.10.4",
+ "crypto-common",
+ "subtle",
+]
+
+[[package]]
+name = "displaydoc"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "dyn-clone"
+version = "1.0.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "304e6508efa593091e97a9abbc10f90aa7ca635b6d2784feff3c89d41dd12272"
+
+[[package]]
+name = "ecdsa"
+version = "0.14.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "413301934810f597c1d19ca71c8710e99a3f1ba28a0d2ebc01551a2daeea3c5c"
+dependencies = [
+ "der 0.6.1",
+ "elliptic-curve",
+ "rfc6979",
+ "signature 1.6.4",
+]
+
+[[package]]
+name = "ed25519"
+version = "2.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5fb04eee5d9d907f29e80ee6b0e78f7e2c82342c63e3580d8c4f69d9d5aad963"
+dependencies = [
+ "pkcs8 0.10.2",
+ "signature 2.1.0",
+]
+
+[[package]]
+name = "ed25519-consensus"
+version = "2.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3c8465edc8ee7436ffea81d21a019b16676ee3db267aa8d5a8d729581ecf998b"
+dependencies = [
+ "curve25519-dalek-ng",
+ "hex",
+ "rand_core 0.6.4",
+ "sha2 0.9.9",
+ "zeroize",
+]
+
+[[package]]
+name = "ed25519-zebra"
+version = "3.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c24f403d068ad0b359e577a77f92392118be3f3c927538f2bb544a5ecd828c6"
+dependencies = [
+ "curve25519-dalek",
+ "hashbrown 0.12.3",
+ "hex",
+ "rand_core 0.6.4",
+ "serde",
+ "sha2 0.9.9",
+ "zeroize",
+]
+
+[[package]]
+name = "either"
+version = "1.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
+
+[[package]]
+name = "elliptic-curve"
+version = "0.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e7bb888ab5300a19b8e5bceef25ac745ad065f3c9f7efc6de1b91958110891d3"
+dependencies = [
+ "base16ct",
+ "crypto-bigint",
+ "der 0.6.1",
+ "digest 0.10.7",
+ "ff",
+ "generic-array",
+ "group",
+ "pkcs8 0.9.0",
+ "rand_core 0.6.4",
+ "sec1",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "equivalent"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
+
+[[package]]
+name = "ff"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d013fc25338cc558c5c2cfbad646908fb23591e2404481826742b651c9af7160"
+dependencies = [
+ "rand_core 0.6.4",
+ "subtle",
+]
+
+[[package]]
+name = "fixed-hash"
+version = "0.8.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "835c052cb0c08c1acf6ffd71c022172e18723949c8282f2b9f27efbc51e64534"
+dependencies = [
+ "static_assertions",
+]
+
+[[package]]
+name = "flex-error"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c606d892c9de11507fa0dcffc116434f94e105d0bbdc4e405b61519464c49d7b"
+dependencies = [
+ "paste",
+]
+
+[[package]]
+name = "fnv"
+version = "1.0.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
+
+[[package]]
+name = "forward_ref"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c8cbd1169bd7b4a0a20d92b9af7a7e0422888bd38a6f5ec29c1fd8c1558a272e"
+
+[[package]]
+name = "futures"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "23342abe12aba583913b2e62f22225ff9c950774065e4bfb61a19cd9770fec40"
+dependencies = [
+ "futures-channel",
+ "futures-core",
+ "futures-io",
+ "futures-sink",
+ "futures-task",
+ "futures-util",
+]
+
+[[package]]
+name = "futures-channel"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "955518d47e09b25bbebc7a18df10b81f0c766eaf4c4f1cccef2fca5f2a4fb5f2"
+dependencies = [
+ "futures-core",
+ "futures-sink",
+]
+
+[[package]]
+name = "futures-core"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4bca583b7e26f571124fe5b7561d49cb2868d79116cfa0eefce955557c6fee8c"
+
+[[package]]
+name = "futures-io"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fff74096e71ed47f8e023204cfd0aa1289cd54ae5430a9523be060cdb849964"
+
+[[package]]
+name = "futures-sink"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f43be4fe21a13b9781a69afa4985b0f6ee0e1afab2c6f454a8cf30e2b2237b6e"
+
+[[package]]
+name = "futures-task"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76d3d132be6c0e6aa1534069c705a74a5997a356c0dc2f86a47765e5617c5b65"
+
+[[package]]
+name = "futures-util"
+version = "0.3.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "26b01e40b772d54cf6c6d721c1d1abd0647a0106a12ecaa1c186273392a69533"
+dependencies = [
+ "futures-core",
+ "futures-sink",
+ "futures-task",
+ "pin-project-lite",
+ "pin-utils",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
+[[package]]
+name = "getrandom"
+version = "0.2.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "be4136b2a15dd319360be1c07d9933517ccf0be8f16bf62a3bee4f0d618df427"
+dependencies = [
+ "cfg-if",
+ "libc",
+ "wasi",
+]
+
+[[package]]
+name = "group"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5dfbfb3a6cfbd390d5c9564ab283a0349b9b9fcd46a706c1eb10e0db70bfbac7"
+dependencies = [
+ "ff",
+ "rand_core 0.6.4",
+ "subtle",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.12.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888"
+dependencies = [
+ "ahash",
+]
+
+[[package]]
+name = "hashbrown"
+version = "0.14.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2c6201b9ff9fd90a5a3bac2e56a830d0caa509576f0e503818ee82c181b3437a"
+
+[[package]]
+name = "hex"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
+
+[[package]]
+name = "hmac"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
+dependencies = [
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "ibc"
+version = "0.45.0"
+dependencies = [
+ "bytes",
+ "derive_more",
+ "displaydoc",
+ "ibc-derive",
+ "ibc-proto",
+ "ics23",
+ "num-traits",
+ "parity-scale-codec",
+ "primitive-types",
+ "prost",
+ "scale-info",
+ "serde",
+ "serde-json-wasm 1.0.0",
+ "serde_derive",
+ "sha2 0.10.7",
+ "subtle-encoding",
+ "tendermint",
+ "tendermint-light-client-verifier",
+ "tendermint-proto",
+ "time",
+ "tracing",
+ "uint",
+]
+
+[[package]]
+name = "ibc-derive"
+version = "0.3.0"
+dependencies = [
+ "darling",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "ibc-proto"
+version = "0.35.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "459ccbab879b749bf500ae13244593fa16fc64c1b3159f6b0753c169625a1e23"
+dependencies = [
+ "base64 0.21.2",
+ "bytes",
+ "flex-error",
+ "ics23",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "subtle-encoding",
+ "tendermint-proto",
+]
+
+[[package]]
+name = "ics23"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "442d4bab37956e76f739c864f246c825d87c0bb7f9afa65660c57833c91bf6d4"
+dependencies = [
+ "anyhow",
+ "bytes",
+ "hex",
+ "informalsystems-pbjson",
+ "prost",
+ "ripemd",
+ "serde",
+ "sha2 0.10.7",
+ "sha3",
+]
+
+[[package]]
+name = "ident_case"
+version = "1.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
+
+[[package]]
+name = "impl-serde"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ebc88fc67028ae3db0c853baa36269d398d5f45b6982f95549ff5def78c935cd"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "impl-trait-for-tuples"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "11d7a9f6330b71fea57921c9b61c47ee6e84f72d394754eff6163ae67e7395eb"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "indexmap"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d5477fe2230a79769d8dc68e0eabf5437907c0457a5614a9e8dddb67f65eb65d"
+dependencies = [
+ "equivalent",
+ "hashbrown 0.14.0",
+]
+
+[[package]]
+name = "informalsystems-pbjson"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4eecd90f87bea412eac91c6ef94f6b1e390128290898cbe14f2b926787ae1fb"
+dependencies = [
+ "base64 0.13.1",
+ "serde",
+]
+
+[[package]]
+name = "itertools"
+version = "0.10.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473"
+dependencies = [
+ "either",
+]
+
+[[package]]
+name = "itoa"
+version = "1.0.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
+
+[[package]]
+name = "k256"
+version = "0.11.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72c1e0b51e7ec0a97369623508396067a486bd0cbed95a2659a4b863d28cfc8b"
+dependencies = [
+ "cfg-if",
+ "ecdsa",
+ "elliptic-curve",
+ "sha2 0.10.7",
+]
+
+[[package]]
+name = "keccak"
+version = "0.1.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8f6d5ed8676d904364de097082f4e7d240b571b67989ced0240f08b7f966f940"
+dependencies = [
+ "cpufeatures",
+]
+
+[[package]]
+name = "libc"
+version = "0.2.147"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4668fb0ea861c1df094127ac5f1da3409a82116a4ba74fca2e58ef927159bb3"
+
+[[package]]
+name = "memchr"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d"
+
+[[package]]
+name = "num-derive"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "876a53fff98e03a936a674b29568b0e605f06b29372c2489ff4de23f1949743d"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "num-traits"
+version = "0.2.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f30b0abd723be7e2ffca1272140fac1a2f084c77ec3e123c192b66af1ee9e6c2"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d"
+
+[[package]]
+name = "opaque-debug"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
+
+[[package]]
+name = "parity-scale-codec"
+version = "3.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dd8e946cc0cc711189c0b0249fb8b599cbeeab9784d83c415719368bb8d4ac64"
+dependencies = [
+ "arrayvec",
+ "byte-slice-cast",
+ "impl-trait-for-tuples",
+ "parity-scale-codec-derive",
+]
+
+[[package]]
+name = "parity-scale-codec-derive"
+version = "3.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a296c3079b5fefbc499e1de58dc26c09b1b9a5952d26694ee89f04a43ebbb3e"
+dependencies = [
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "paste"
+version = "1.0.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
+
+[[package]]
+name = "pin-project-lite"
+version = "0.2.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c40d25201921e5ff0c862a505c6557ea88568a4e3ace775ab55e93f2f4f9d57"
+
+[[package]]
+name = "pin-utils"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
+
+[[package]]
+name = "pkcs8"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9eca2c590a5f85da82668fa685c09ce2888b9430e83299debf1f34b65fd4a4ba"
+dependencies = [
+ "der 0.6.1",
+ "spki 0.6.0",
+]
+
+[[package]]
+name = "pkcs8"
+version = "0.10.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f950b2377845cebe5cf8b5165cb3cc1a5e0fa5cfa3e1f7f55707d8fd82e0a7b7"
+dependencies = [
+ "der 0.7.7",
+ "spki 0.7.2",
+]
+
+[[package]]
+name = "primitive-types"
+version = "0.12.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9f3486ccba82358b11a77516035647c34ba167dfa53312630de83b12bd4f3d66"
+dependencies = [
+ "fixed-hash",
+ "impl-serde",
+ "uint",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "1.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
+dependencies = [
+ "once_cell",
+ "toml_edit",
+]
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.66"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "18fb31db3f9bddb2ea821cde30a9f70117e3f119938b5ee630b7403aa6e2ead9"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "prost"
+version = "0.11.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b82eaa1d779e9a4bc1c3217db8ffbeabaae1dca241bf70183242128d48681cd"
+dependencies = [
+ "bytes",
+ "prost-derive",
+]
+
+[[package]]
+name = "prost-derive"
+version = "0.11.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5d2d8d10f3c6ded6da8b05b5fb3b8a5082514344d56c9f871412d29b4e075b4"
+dependencies = [
+ "anyhow",
+ "itertools",
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "prost-types"
+version = "0.11.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "213622a1460818959ac1181aaeb2dc9c7f63df720db7d788b3e24eacd1983e13"
+dependencies = [
+ "prost",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "50f3b39ccfb720540debaa0164757101c08ecb8d326b15358ce76a62c7e85965"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "rand_core"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "90bde5296fc891b0cef12a6d03ddccc162ce7b2aff54160af9338f8d40df6d19"
+
+[[package]]
+name = "rand_core"
+version = "0.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
+dependencies = [
+ "getrandom",
+]
+
+[[package]]
+name = "rfc6979"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7743f17af12fa0b03b803ba12cd6a8d9483a587e89c69445e3909655c0b9fabb"
+dependencies = [
+ "crypto-bigint",
+ "hmac",
+ "zeroize",
+]
+
+[[package]]
+name = "ripemd"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bd124222d17ad93a644ed9d011a40f4fb64aa54275c08cc216524a9ea82fb09f"
+dependencies = [
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "ryu"
+version = "1.0.15"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
+
+[[package]]
+name = "scale-info"
+version = "2.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "35c0a159d0c45c12b20c5a844feb1fe4bea86e28f17b92a5f0c42193634d3782"
+dependencies = [
+ "cfg-if",
+ "derive_more",
+ "parity-scale-codec",
+ "scale-info-derive",
+]
+
+[[package]]
+name = "scale-info-derive"
+version = "2.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "912e55f6d20e0e80d63733872b40e1227c0bce1e1ab81ba67d696339bfd7fd29"
+dependencies = [
+ "proc-macro-crate",
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "schemars"
+version = "0.8.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02c613288622e5f0c3fdc5dbd4db1c5fbe752746b1d1a56a0630b78fd00de44f"
+dependencies = [
+ "dyn-clone",
+ "schemars_derive",
+ "serde",
+ "serde_json",
+]
+
+[[package]]
+name = "schemars_derive"
+version = "0.8.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "109da1e6b197438deb6db99952990c7f959572794b80ff93707d55a232545e7c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "serde_derive_internals",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "sec1"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3be24c1842290c45df0a7bf069e0c268a747ad05a192f2fd7dcfdbc1cba40928"
+dependencies = [
+ "base16ct",
+ "der 0.6.1",
+ "generic-array",
+ "pkcs8 0.9.0",
+ "subtle",
+ "zeroize",
+]
+
+[[package]]
+name = "serde"
+version = "1.0.188"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf9e0fcba69a370eed61bcf2b728575f726b50b55cba78064753d708ddc7549e"
+dependencies = [
+ "serde_derive",
+]
+
+[[package]]
+name = "serde-json-wasm"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "16a62a1fad1e1828b24acac8f2b468971dade7b8c3c2e672bcadefefb1f8c137"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "serde-json-wasm"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83c37d03f3b0f6b5f77c11af1e7c772de1c9af83e50bef7bb6069601900ba67b"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "serde_bytes"
+version = "0.11.12"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ab33ec92f677585af6d88c65593ae2375adde54efdbf16d597f2cbc7a6d368ff"
+dependencies = [
+ "serde",
+]
+
+[[package]]
+name = "serde_derive"
+version = "1.0.188"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4eca7ac642d82aa35b60049a6eccb4be6be75e599bd2e9adb5f875a737654af2"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "serde_derive_internals"
+version = "0.26.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85bf8229e7920a9f636479437026331ce11aa132b4dde37d121944a44d6e5f3c"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "serde_json"
+version = "1.0.104"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "076066c5f1078eac5b722a31827a8832fe108bed65dfa75e233c89f8206e976c"
+dependencies = [
+ "itoa",
+ "ryu",
+ "serde",
+]
+
+[[package]]
+name = "serde_repr"
+version = "0.1.16"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8725e1dfadb3a50f7e5ce0b1a540466f6ed3fe7a0fca2ac2b8b831d31316bd00"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "sha2"
+version = "0.9.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4d58a1e1bf39749807d89cf2d98ac2dfa0ff1cb3faa38fbb64dd88ac8013d800"
+dependencies = [
+ "block-buffer 0.9.0",
+ "cfg-if",
+ "cpufeatures",
+ "digest 0.9.0",
+ "opaque-debug",
+]
+
+[[package]]
+name = "sha2"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "479fb9d862239e610720565ca91403019f2f00410f1864c5aa7479b950a76ed8"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "sha3"
+version = "0.10.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "75872d278a8f37ef87fa0ddbda7802605cb18344497949862c0d4dcb291eba60"
+dependencies = [
+ "digest 0.10.7",
+ "keccak",
+]
+
+[[package]]
+name = "signature"
+version = "1.6.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "74233d3b3b2f6d4b006dc19dee745e73e2a6bfb6f93607cd3b02bd5b00797d7c"
+dependencies = [
+ "digest 0.10.7",
+ "rand_core 0.6.4",
+]
+
+[[package]]
+name = "signature"
+version = "2.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
+
+[[package]]
+name = "spki"
+version = "0.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "67cf02bbac7a337dc36e4f5a693db6c21e7863f45070f7064577eb4367a3212b"
+dependencies = [
+ "base64ct",
+ "der 0.6.1",
+]
+
+[[package]]
+name = "spki"
+version = "0.7.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9d1e996ef02c474957d681f1b05213dfb0abab947b446a62d37770b23500184a"
+dependencies = [
+ "base64ct",
+ "der 0.7.7",
+]
+
+[[package]]
+name = "static_assertions"
+version = "1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
+
+[[package]]
+name = "strsim"
+version = "0.10.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"
+
+[[package]]
+name = "subtle"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "81cdd64d312baedb58e21336b31bc043b77e01cc99033ce76ef539f78e965ebc"
+
+[[package]]
+name = "subtle-encoding"
+version = "0.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7dcb1ed7b8330c5eed5441052651dd7a12c75e2ed88f2ec024ae1fa3a5e59945"
+dependencies = [
+ "zeroize",
+]
+
+[[package]]
+name = "subtle-ng"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "734676eb262c623cec13c3155096e08d1f8f29adce39ba17948b18dad1e54142"
+
+[[package]]
+name = "syn"
+version = "1.0.109"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "72b64191b275b66ffe2469e8af2c1cfe3bafa67b529ead792a6d0160888b4237"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.28"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "04361975b3f5e348b2189d8dc55bc942f278b2d482a6a0365de5bdd62d351567"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "tendermint"
+version = "0.33.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7c35fe4fd24a7715571814c22416dbc40ec0f2a6e3cce75d73e19699faecd246"
+dependencies = [
+ "bytes",
+ "digest 0.10.7",
+ "ed25519",
+ "ed25519-consensus",
+ "flex-error",
+ "futures",
+ "num-traits",
+ "once_cell",
+ "prost",
+ "prost-types",
+ "serde",
+ "serde_bytes",
+ "serde_json",
+ "serde_repr",
+ "sha2 0.10.7",
+ "signature 2.1.0",
+ "subtle",
+ "subtle-encoding",
+ "tendermint-proto",
+ "time",
+ "zeroize",
+]
+
+[[package]]
+name = "tendermint-light-client-verifier"
+version = "0.33.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "680639f67d51eceb700bff18b45b584373ec94ee0d7ffe61f4ca6c54ed7787ff"
+dependencies = [
+ "derive_more",
+ "flex-error",
+ "serde",
+ "tendermint",
+ "time",
+]
+
+[[package]]
+name = "tendermint-proto"
+version = "0.33.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "639e5adffd77220d238a800a72c74c98d7e869290a6e4494c10b6b4e8f702f02"
+dependencies = [
+ "bytes",
+ "flex-error",
+ "num-derive",
+ "num-traits",
+ "prost",
+ "prost-types",
+ "serde",
+ "serde_bytes",
+ "subtle-encoding",
+ "time",
+]
+
+[[package]]
+name = "thiserror"
+version = "1.0.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "611040a08a0439f8248d1990b111c95baa9c704c805fa1f62104b39655fd7f90"
+dependencies = [
+ "thiserror-impl",
+]
+
+[[package]]
+name = "thiserror-impl"
+version = "1.0.44"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "090198534930841fab3a5d1bb637cde49e339654e606195f8d9c76eeb081dc96"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
+
+[[package]]
+name = "time"
+version = "0.3.23"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59e399c068f43a5d116fedaf73b203fa4f9c519f17e2b34f63221d3792f81446"
+dependencies = [
+ "time-core",
+ "time-macros",
+]
+
+[[package]]
+name = "time-core"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7300fbefb4dadc1af235a9cef3737cea692a9d97e1b9cbcd4ebdae6f8868e6fb"
+
+[[package]]
+name = "time-macros"
+version = "0.2.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "96ba15a897f3c86766b757e5ac7221554c6750054d74d5b28844fce5fb36a6c4"
+dependencies = [
+ "time-core",
+]
+
+[[package]]
+name = "toml_datetime"
+version = "0.6.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
+
+[[package]]
+name = "toml_edit"
+version = "0.19.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8123f27e969974a3dfba720fdb560be359f57b44302d280ba72e76a74480e8a"
+dependencies = [
+ "indexmap",
+ "toml_datetime",
+ "winnow",
+]
+
+[[package]]
+name = "tracing"
+version = "0.1.37"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ce8c33a8d48bd45d624a6e523445fd21ec13d3653cd51f681abf67418f54eb8"
+dependencies = [
+ "cfg-if",
+ "pin-project-lite",
+ "tracing-core",
+]
+
+[[package]]
+name = "tracing-core"
+version = "0.1.31"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0955b8137a1df6f1a2e9a37d8a6656291ff0297c1a97c24e0d8425fe2312f79a"
+
+[[package]]
+name = "typenum"
+version = "1.16.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "497961ef93d974e23eb6f433eb5fe1b7930b659f06d12dec6fc44a8f554c0bba"
+
+[[package]]
+name = "uint"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "76f64bba2c53b04fcab63c01a7d7427eadc821e3bc48c34dc9ba29c501164b52"
+dependencies = [
+ "byteorder",
+ "crunchy",
+ "hex",
+ "static_assertions",
+]
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.11"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "301abaae475aa91687eb82514b328ab47a211a533026cb25fc3e519b86adfc3c"
+
+[[package]]
+name = "version_check"
+version = "0.9.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "49874b5167b65d7193b8aba1567f5c7d93d001cafc34600cee003eda787e483f"
+
+[[package]]
+name = "wasi"
+version = "0.11.0+wasi-snapshot-preview1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
+
+[[package]]
+name = "winnow"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8bd122eb777186e60c3fdf765a58ac76e41c582f1f535fbf3314434c6b58f3f7"
+dependencies = [
+ "memchr",
+]
+
+[[package]]
+name = "zeroize"
+version = "1.6.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2a0956f1ba7c7909bfb66c2e9e4124ab6f6482560f6628b5aaeba39207c9aad9"
+dependencies = [
+ "zeroize_derive",
+]
+
+[[package]]
+name = "zeroize_derive"
+version = "1.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.28",
+]
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
new file mode 100644
index 000000000..6d57e8947
--- /dev/null
+++ b/ci/cw-check/Cargo.toml
@@ -0,0 +1,24 @@
+[package]
+edition = "2021"
+name = "cw-check"
+version = "0.1.0"
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+ibc = { path = "../../crates/ibc", default_features = false, features = ["serde", "parity-scale-codec"]}
+cosmwasm-std = { version = "1.2.5", default-features = false}
+cosmwasm-schema = { version = "1.2.5", default-features = false}
+serde_json =  {package = "serde-json-wasm", version = "1.0.0", default-features = false }
+thiserror = { version = "*", default-features = false}
+
+[profile.release]
+lto = true
+codegen-units = 1
+debug = false
+debug-assertions = false
+opt-level = "s"
+overflow-checks = true
+panic = "abort"
+rpath = false
\ No newline at end of file
diff --git a/ci/cw-check/rust-toolchain.toml b/ci/cw-check/rust-toolchain.toml
new file mode 100644
index 000000000..0ce1c5cca
--- /dev/null
+++ b/ci/cw-check/rust-toolchain.toml
@@ -0,0 +1,5 @@
+[toolchain]
+channel = "nightly-2023-03-09"
+targets = [
+  "wasm32-unknown-unknown",
+]
diff --git a/ci/cw-check/shell.nix b/ci/cw-check/shell.nix
new file mode 100644
index 000000000..3482d1228
--- /dev/null
+++ b/ci/cw-check/shell.nix
@@ -0,0 +1,16 @@
+# install nix and `nix-shell` in this directory, run `cw-check` command
+{ pkgs ? import <nixpkgs> { overlays = [ (import (builtins.fetchTarball "https://github.com/oxalica/rust-overlay/archive/refs/heads/stable.zip")) ]; } }:
+let
+  rust-as-on-ci = pkgs.rust-bin.fromRustupToolchainFile ./rust-toolchain.toml;
+  cw-check = pkgs.writeShellApplication rec {
+    name = "cw-check";
+    runtimeInputs = [ rust-as-on-ci ];
+    text = ''
+        cargo build --target wasm32-unknown-unknown --no-default-features --release
+        nix run github:informalsystems/cosmos.nix#cosmwasm-check ./target/wasm32-unknown-unknown/release/cw_check.wasm
+    '';
+  };
+in
+pkgs.mkShell {
+  nativeBuildInputs = [ rust-as-on-ci cw-check];
+}
\ No newline at end of file
diff --git a/ci/cw-check/src/lib.rs b/ci/cw-check/src/lib.rs
new file mode 100644
index 000000000..e13da8cd5
--- /dev/null
+++ b/ci/cw-check/src/lib.rs
@@ -0,0 +1,64 @@
+extern crate alloc;
+use std::str::FromStr;
+
+use cosmwasm_schema::cw_serde;
+use cosmwasm_std::{DepsMut, Env, MessageInfo, Response};
+use ibc::{
+    applications::transfer::{msgs::transfer::MsgTransfer, packet::PacketData, *},
+    core::ics24_host::identifier::*,
+};
+use thiserror::Error;
+
+#[cw_serde]
+pub struct Msg {
+    pub test: String,
+}
+
+#[cfg_attr(not(feature = "library"), cosmwasm_std::entry_point)]
+pub fn instantiate(
+    _deps: DepsMut,
+    _env: Env,
+    _info: MessageInfo,
+    msg: Msg,
+) -> Result<Response, ContractError> {
+    let _serde: (
+        PrefixedCoin,
+        Amount,
+        ChannelId,
+        ChainId,
+        ConnectionId,
+        MsgTransfer,
+        PacketData,
+    ) = serde_json::from_str(&msg.test).expect("test");
+    let a = serde_json::to_string(&ChannelId::from_str(msg.test.as_str()).unwrap()).expect("test");
+    let b = serde_json::to_string(&PortId::from_str(msg.test.as_str()).unwrap()).expect("test");
+    let c = serde_json::to_string(&ClientId::from_str(msg.test.as_str()).unwrap()).expect("test");
+    let d =
+        serde_json::to_string(&ConnectionId::from_str(msg.test.as_str()).unwrap()).expect("test");
+    let e = serde_json::to_string(&PrefixedDenom {
+        trace_path: TracePath::default(),
+        base_denom: BaseDenom::from_str(msg.test.as_str()).unwrap(),
+    })
+    .expect("test");
+    let f = serde_json::to_string(&ConnectionId::from_str(msg.test.as_str()).expect("test"))
+        .expect("test");
+    Ok(Response::new()
+        .add_attribute(a, b)
+        .add_attribute(c, d)
+        .add_attribute(e, f)
+        .add_attribute(msg.test.clone(), msg.test.clone()))
+}
+
+#[cfg_attr(not(feature = "library"), cosmwasm_std::entry_point)]
+pub fn execute(
+    _deps: DepsMut,
+    _env: Env,
+    _info: MessageInfo,
+    _msg: Msg,
+) -> Result<Response, ContractError> {
+    Ok(Response::default())
+}
+
+#[cw_serde]
+#[derive(Error)]
+pub enum ContractError {}
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 1ccfd78d4..ab6f65baf 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1064,7 +1064,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.45.0"
+version = "0.46.0"
 dependencies = [
  "bytes",
  "derive_more",
@@ -1076,8 +1076,8 @@ dependencies = [
  "primitive-types",
  "prost",
  "serde",
+ "serde-json-wasm",
  "serde_derive",
- "serde_json",
  "sha2 0.10.8",
  "subtle-encoding",
  "tendermint",
@@ -1381,7 +1381,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
 dependencies = [
- "rustix 0.38.18",
+ "rustix 0.38.19",
 ]
 
 [[package]]
@@ -1844,7 +1844,7 @@ dependencies = [
  "aho-corasick",
  "memchr",
  "regex-automata 0.4.1",
- "regex-syntax 0.8.0",
+ "regex-syntax 0.8.1",
 ]
 
 [[package]]
@@ -1864,7 +1864,7 @@ checksum = "465c6fc0621e4abc4187a2bda0937bfd4f722c2730b29562e19689ea796c9a4b"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-syntax 0.8.0",
+ "regex-syntax 0.8.1",
 ]
 
 [[package]]
@@ -1875,9 +1875,9 @@ checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
 
 [[package]]
 name = "regex-syntax"
-version = "0.8.0"
+version = "0.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c3cbb081b9784b07cceb8824c8583f86db4814d172ab043f3c23f7dc600bf83d"
+checksum = "56d84fdd47036b038fc80dd333d10b6aab10d5d31f4a366e20014def75328d33"
 
 [[package]]
 name = "ripemd"
@@ -1917,9 +1917,9 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.36.15"
+version = "0.36.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c37f1bd5ef1b5422177b7646cba67430579cfe2ace80f284fee876bca52ad941"
+checksum = "6da3636faa25820d8648e0e31c5d519bbb01f72fdf57131f0f5f7da5fed36eab"
 dependencies = [
  "bitflags 1.3.2",
  "errno",
@@ -1931,9 +1931,9 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.38.18"
+version = "0.38.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a74ee2d7c2581cd139b42447d7d9389b889bdaad3a73f1ebb16f2a3237bb19c"
+checksum = "745ecfa778e66b2b63c88a61cb36e0eea109e803b0b86bf9879fbc77c70e86ed"
 dependencies = [
  "bitflags 2.4.0",
  "errno",
@@ -2050,13 +2050,22 @@ checksum = "836fa6a3e1e547f9a2c4040802ec865b5d85f4014efe00555d7090a3dcaa1090"
 
 [[package]]
 name = "serde"
-version = "1.0.188"
+version = "1.0.189"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf9e0fcba69a370eed61bcf2b728575f726b50b55cba78064753d708ddc7549e"
+checksum = "8e422a44e74ad4001bdc8eede9a4570ab52f71190e9c076d14369f38b9200537"
 dependencies = [
  "serde_derive",
 ]
 
+[[package]]
+name = "serde-json-wasm"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "83c37d03f3b0f6b5f77c11af1e7c772de1c9af83e50bef7bb6069601900ba67b"
+dependencies = [
+ "serde",
+]
+
 [[package]]
 name = "serde_bytes"
 version = "0.11.12"
@@ -2068,9 +2077,9 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.188"
+version = "1.0.189"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4eca7ac642d82aa35b60049a6eccb4be6be75e599bd2e9adb5f875a737654af2"
+checksum = "1e48d1f918009ce3145511378cf68d613e3b3d9137d67272562080d68a2b32d5"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3154,7 +3163,7 @@ dependencies = [
  "memoffset",
  "paste",
  "rand 0.8.5",
- "rustix 0.36.15",
+ "rustix 0.36.16",
  "wasmtime-asm-macros",
  "wasmtime-environ",
  "wasmtime-jit-debug",
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 24d57a030..0a7a66025 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -21,12 +21,12 @@ default = ["std"]
 std = [
     "ibc-proto/std",
     "ics23/std",
-    "serde/std",
-    "serde_json/std",
+    "serde/std",    
     "tracing/std",
     "prost/std",
     "bytes/std",
     "subtle-encoding/std",
+    "serde_json/std",
     "sha2/std",
     "displaydoc/std",
     "num-traits/std",
@@ -39,7 +39,7 @@ parity-scale-codec = ["dep:parity-scale-codec", "dep:scale-info", "ibc-proto/par
 borsh = ["dep:borsh", "ibc-proto/borsh"]
 
 # This feature is required for token transfer (ICS-20)
-serde = ["dep:serde", "dep:serde_derive", "serde_json", "ics23/serde"]
+serde = ["dep:serde", "dep:serde_derive", "serde_json", "ibc-proto/serde", "ics23/serde"]
 
 # CosmWasm message API generator compatible, should not be inside on chain code
 schema = ["dep:schemars", "serde", "std"]
@@ -55,7 +55,7 @@ ics23 = { version = "0.11", default-features = false, features = ["host-function
 time = { version = ">=0.3.0, <0.3.30", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
-serde_json = { version = "1", default-features = false, optional = true }
+serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false, optional = true}
 tracing = { version = "0.1.36", default-features = false }
 prost = { version = "0.12", default-features = false }
 bytes = { version = "1.2.1", default-features = false }
diff --git a/crates/ibc/clippy.toml b/crates/ibc/clippy.toml
new file mode 100644
index 000000000..af3114623
--- /dev/null
+++ b/crates/ibc/clippy.toml
@@ -0,0 +1,10 @@
+disallowed-types = [
+    # { path = "usize", reason = "variable size" }, # cannot on now, because mocks use it and serde, even if there is no usize in type
+    { path = "f64", reason = "not supported in CosmWasm" },
+    { path = "f32", reason = "not supported in CosmWasm" },
+    { path = "num_traits::float::*", reason = "harware dependant" },
+]
+
+disallowed-methods = [
+    "std::time::Duration::as_secs_f64",
+]
diff --git a/crates/ibc/src/applications/transfer/amount.rs b/crates/ibc/src/applications/transfer/amount.rs
index fe21574fa..b14a1797a 100644
--- a/crates/ibc/src/applications/transfer/amount.rs
+++ b/crates/ibc/src/applications/transfer/amount.rs
@@ -131,7 +131,8 @@ where
     D: serde::Deserializer<'de>,
 {
     use serde::Deserialize;
-    U256::from_dec_str(<&str>::deserialize(deserializer)?).map_err(serde::de::Error::custom)
+    U256::from_dec_str(<String>::deserialize(deserializer)?.as_str())
+        .map_err(serde::de::Error::custom)
 }
 
 #[cfg(test)]
diff --git a/crates/ibc/src/applications/transfer/denom.rs b/crates/ibc/src/applications/transfer/denom.rs
index 73d46745d..855b542ae 100644
--- a/crates/ibc/src/applications/transfer/denom.rs
+++ b/crates/ibc/src/applications/transfer/denom.rs
@@ -142,7 +142,9 @@ impl<'a> TryFrom<Vec<&'a str>> for TracePath {
 
     fn try_from(v: Vec<&'a str>) -> Result<Self, Self::Error> {
         if v.len() % 2 != 0 {
-            return Err(TokenTransferError::InvalidTraceLength { len: v.len() });
+            return Err(TokenTransferError::InvalidTraceLength {
+                len: v.len() as u64,
+            });
         }
 
         let mut trace = vec![];
@@ -150,12 +152,12 @@ impl<'a> TryFrom<Vec<&'a str>> for TracePath {
         for (pos, (port_id, channel_id)) in id_pairs.rev().enumerate() {
             let port_id =
                 PortId::from_str(port_id).map_err(|e| TokenTransferError::InvalidTracePortId {
-                    pos,
+                    pos: pos as u64,
                     validation_error: e,
                 })?;
             let channel_id = ChannelId::from_str(channel_id).map_err(|e| {
                 TokenTransferError::InvalidTraceChannelId {
-                    pos,
+                    pos: pos as u64,
                     validation_error: e,
                 }
             })?;
diff --git a/crates/ibc/src/applications/transfer/error.rs b/crates/ibc/src/applications/transfer/error.rs
index 0c25654ce..72fb7ce2f 100644
--- a/crates/ibc/src/applications/transfer/error.rs
+++ b/crates/ibc/src/applications/transfer/error.rs
@@ -28,16 +28,16 @@ pub enum TokenTransferError {
     EmptyBaseDenom,
     /// invalid prot id n trace at position: `{pos}`, validation error: `{validation_error}`
     InvalidTracePortId {
-        pos: usize,
+        pos: u64,
         validation_error: IdentifierError,
     },
     /// invalid channel id in trace at position: `{pos}`, validation error: `{validation_error}`
     InvalidTraceChannelId {
-        pos: usize,
+        pos: u64,
         validation_error: IdentifierError,
     },
     /// trace length must be even but got: `{len}`
-    InvalidTraceLength { len: usize },
+    InvalidTraceLength { len: u64 },
     /// invalid amount error: `{0}`
     InvalidAmount(FromDecStrErr),
     /// invalid token
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index a0f85d226..cc7c1f66a 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -146,7 +146,7 @@ impl ClientState {
     }
 
     pub fn validate(&self) -> Result<(), Error> {
-        self.chain_id.validate_length(3, MaxChainIdLen)?;
+        self.chain_id.validate_length(3, MaxChainIdLen as u64)?;
 
         // `TrustThreshold` is guaranteed to be in the range `[0, 1)`, but a `TrustThreshold::ZERO`
         // value is invalid in this context
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 4c0004790..93f3f6612 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -234,7 +234,7 @@ mod tests {
         let client_cons_state_height = 10;
         let host_chain_height = Height::new(0, 35).unwrap();
         let pruned_height = host_chain_height
-            .sub(max_history_size as u64 + 1)
+            .sub(max_history_size + 1)
             .unwrap()
             .revision_height();
 
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 56bdaed6a..4fd2d9237 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -314,12 +314,12 @@ impl ChannelEnd {
 /// Checks if the `connection_hops` has a length of `expected`.
 pub(crate) fn verify_connection_hops_length(
     connection_hops: &Vec<ConnectionId>,
-    expected: usize,
+    expected: u64,
 ) -> Result<(), ChannelError> {
-    if connection_hops.len() != expected {
+    if connection_hops.len() as u64 != expected {
         return Err(ChannelError::InvalidConnectionHopsLength {
             expected,
-            actual: connection_hops.len(),
+            actual: connection_hops.len() as u64,
         });
     }
     Ok(())
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/crates/ibc/src/core/ics04_channel/context.rs
index 5d6f2aba0..40c51d3fc 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/crates/ibc/src/core/ics04_channel/context.rs
@@ -2,8 +2,6 @@
 
 use core::time::Duration;
 
-use num_traits::float::FloatCore;
-
 use super::packet::Sequence;
 use crate::core::events::IbcEvent;
 use crate::core::ics02_client::client_state::ClientState;
@@ -142,10 +140,42 @@ pub(crate) fn calculate_block_delay(
     delay_period_time: &Duration,
     max_expected_time_per_block: &Duration,
 ) -> u64 {
-    if max_expected_time_per_block.is_zero() {
+    let delay_period_time = delay_period_time.as_secs();
+    let max_expected_time_per_block = max_expected_time_per_block.as_secs();
+    if max_expected_time_per_block == 0 {
         return 0;
     }
+    if delay_period_time % max_expected_time_per_block == 0 {
+        return delay_period_time / max_expected_time_per_block;
+    }
+    (delay_period_time / max_expected_time_per_block) + 1
+}
 
-    FloatCore::ceil(delay_period_time.as_secs_f64() / max_expected_time_per_block.as_secs_f64())
-        as u64
+#[cfg(test)]
+mod tests {
+
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case::remainder_zero(10, 2, 5)]
+    #[case::remainder_not_zero(10, 3, 4)]
+    #[case::max_expected_zero(10, 0, 0)]
+    #[case::delay_period_zero(0, 2, 0)]
+    #[case::both_zero(0, 0, 0)]
+    #[case::delay_less_than_max(10, 11, 1)]
+    fn test_calculate_block_delay_zero(
+        #[case] delay_period_time: u64,
+        #[case] max_expected_time_per_block: u64,
+        #[case] expected: u64,
+    ) {
+        assert_eq!(
+            calculate_block_delay(
+                &Duration::from_secs(delay_period_time),
+                &Duration::from_secs(max_expected_time_per_block)
+            ),
+            expected
+        );
+    }
 }
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/crates/ibc/src/core/ics04_channel/error.rs
index 61e5a14b1..88a8abcb0 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/crates/ibc/src/core/ics04_channel/error.rs
@@ -25,7 +25,7 @@ pub enum ChannelError {
     /// invalid channel order type: expected `{expected}`, actual `{actual}`
     InvalidOrderType { expected: String, actual: String },
     /// invalid connection hops length: expected `{expected}`; actual `{actual}`
-    InvalidConnectionHopsLength { expected: usize, actual: usize },
+    InvalidConnectionHopsLength { expected: u64, actual: u64 },
     /// invalid signer error: `{reason}`
     InvalidSigner { reason: String },
     /// invalid proof: missing height
diff --git a/crates/ibc/src/core/ics23_commitment/merkle.rs b/crates/ibc/src/core/ics23_commitment/merkle.rs
index 3f5bfb437..3ffb37b8b 100644
--- a/crates/ibc/src/core/ics23_commitment/merkle.rs
+++ b/crates/ibc/src/core/ics23_commitment/merkle.rs
@@ -57,7 +57,7 @@ impl MerkleProof {
         root: MerkleRoot,
         keys: MerklePath,
         value: Vec<u8>,
-        start_index: usize,
+        start_index: u64,
     ) -> Result<(), CommitmentError> {
         // validate arguments
         if self.proofs.is_empty() {
@@ -86,7 +86,11 @@ impl MerkleProof {
             .iter()
             .zip(ics23_specs.iter())
             .zip(keys.key_path.iter().rev())
-            .skip(start_index)
+            .skip(
+                start_index
+                    .try_into()
+                    .expect("safe because if u64 is more than usize it will skip all anyway"),
+            )
         {
             match &proof.proof {
                 Some(Proof::Exist(existence_proof)) => {
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index ae5a4fbb2..4d28f65c1 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -39,6 +39,7 @@ const TRANSFER_PORT_ID: &str = "transfer";
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct ChainId {
     id: String,
@@ -107,11 +108,7 @@ impl ChainId {
     /// A convenient method to check if the `ChainId` forms a valid identifier
     /// with the desired min/max length. However, ICS-24 does not specify a
     /// certain min or max lengths for chain identifiers.
-    pub fn validate_length(
-        &self,
-        min_length: usize,
-        max_length: usize,
-    ) -> Result<(), IdentifierError> {
+    pub fn validate_length(&self, min_length: u64, max_length: u64) -> Result<(), IdentifierError> {
         validate_prefix_length(self.chain_name(), min_length, max_length)
     }
 }
@@ -504,9 +501,9 @@ pub enum IdentifierError {
     /// identifier `{id}` has invalid length `{length}` must be between `{min}`-`{max}` characters
     InvalidLength {
         id: String,
-        length: usize,
-        min: usize,
-        max: usize,
+        length: u64,
+        min: u64,
+        max: u64,
     },
     /// identifier `{id}` must only contain alphanumeric characters or `.`, `_`, `+`, `-`, `#`, - `[`, `]`, `<`, `>`
     InvalidCharacter { id: String },
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/crates/ibc/src/core/ics24_host/identifier/validate.rs
index ddf8c98b8..8123aeb3e 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/crates/ibc/src/core/ics24_host/identifier/validate.rs
@@ -37,14 +37,14 @@ pub fn validate_identifier_chars(id: &str) -> Result<(), Error> {
 /// Checks if the identifier forms a valid identifier with the given min/max length as specified in the
 /// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
 /// spec.
-pub fn validate_identifier_length(id: &str, min: usize, max: usize) -> Result<(), Error> {
+pub fn validate_identifier_length(id: &str, min: u64, max: u64) -> Result<(), Error> {
     assert!(max >= min);
 
     // Check identifier length is between given min/max
-    if id.len() < min || id.len() > max {
+    if (id.len() as u64) < min || id.len() as u64 > max {
         return Err(Error::InvalidLength {
             id: id.into(),
-            length: id.len(),
+            length: id.len() as u64,
             min,
             max,
         });
@@ -58,8 +58,8 @@ pub fn validate_identifier_length(id: &str, min: usize, max: usize) -> Result<()
 /// and `max_id_length - 21` characters, considering `u64::MAX` (20 chars) and "-".
 pub fn validate_prefix_length(
     prefix: &str,
-    min_id_length: usize,
-    max_id_length: usize,
+    min_id_length: u64,
+    max_id_length: u64,
 ) -> Result<(), Error> {
     // Checks if the prefix forms a valid identifier length when constructed with `u64::MIN`
     validate_identifier_length(
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index de0256681..528693a9b 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -8,6 +8,7 @@
     unused_qualifications,
     rust_2018_idioms
 )]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
 #![forbid(unsafe_code)]
 // https://github.com/cosmos/ibc-rs/issues/342
 #![allow(clippy::result_large_err)]
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 8bc84d1d0..f31e23a6d 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -200,7 +200,7 @@ pub struct MockContext {
     host_chain_id: ChainId,
 
     /// Maximum size for the history of the host chain. Any block older than this is pruned.
-    max_history_size: usize,
+    max_history_size: u64,
 
     /// The chain of blocks underlying this context. A vector of size up to `max_history_size`
     /// blocks, ascending order by their height (latest block is on the last position).
@@ -263,7 +263,7 @@ impl MockContext {
     pub fn new(
         host_id: ChainId,
         host_type: HostType,
-        max_history_size: usize,
+        max_history_size: u64,
         latest_height: Height,
     ) -> Self {
         assert_ne!(
@@ -278,7 +278,7 @@ impl MockContext {
         );
 
         // Compute the number of blocks to store.
-        let n = min(max_history_size as u64, latest_height.revision_height());
+        let n = min(max_history_size, latest_height.revision_height());
 
         assert_eq!(
             host_id.revision_number(),
@@ -377,7 +377,7 @@ impl MockContext {
         MockContext {
             host_chain_type: host_type,
             host_chain_id: host_id.clone(),
-            max_history_size,
+            max_history_size: max_history_size as u64,
             history,
             block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
@@ -638,7 +638,7 @@ impl MockContext {
             panic!("Cannot rewind history of the chain to a smaller revision height!")
         } else if target_height.revision_height() > latest_height.revision_height() {
             // Repeatedly advance the host chain height till we hit the desired height
-            let mut ctx = MockContext { ..self };
+            let mut ctx = self;
             while ctx.latest_height().revision_height() < target_height.revision_height() {
                 ctx.advance_host_chain_height()
             }
@@ -670,14 +670,14 @@ impl MockContext {
     /// Accessor for a block of the local (host) chain from this context.
     /// Returns `None` if the block at the requested height does not exist.
     pub fn host_block(&self, target_height: &Height) -> Option<&HostBlock> {
-        let target = target_height.revision_height() as usize;
-        let latest = self.latest_height().revision_height() as usize;
+        let target = target_height.revision_height();
+        let latest = self.latest_height().revision_height();
 
         // Check that the block is not too advanced, nor has it been pruned.
-        if (target > latest) || (target <= latest - self.history.len()) {
+        if (target > latest) || (target <= latest - self.history.len() as u64) {
             None // Block for requested height does not exist in history.
         } else {
-            Some(&self.history[self.history.len() + target - latest - 1])
+            Some(&self.history[self.history.len() + target as usize - latest as usize - 1])
         }
     }
 
@@ -695,10 +695,10 @@ impl MockContext {
         );
 
         // Append the new header at the tip of the history.
-        if self.history.len() >= self.max_history_size {
+        if self.history.len() as u64 >= self.max_history_size {
             // History is full, we rotate and replace the tip with the new header.
             self.history.rotate_left(1);
-            self.history[self.max_history_size - 1] = new_block;
+            self.history[self.max_history_size as usize - 1] = new_block;
         } else {
             // History is not full yet.
             self.history.push(new_block);
@@ -722,7 +722,7 @@ impl MockContext {
     /// Validates this context. Should be called after the context is mutated by a test.
     pub fn validate(&self) -> Result<(), String> {
         // Check that the number of entries is not higher than window size.
-        if self.history.len() > self.max_history_size {
+        if self.history.len() as u64 > self.max_history_size {
             return Err("too many entries".to_string());
         }
 
@@ -1507,7 +1507,7 @@ mod tests {
     fn test_router() {
         #[derive(Debug, Default)]
         struct FooModule {
-            counter: usize,
+            counter: u64,
         }
 
         impl Module for FooModule {
diff --git a/crates/ibc/src/serializers.rs b/crates/ibc/src/serializers.rs
index 5e0a49281..a4b56473b 100644
--- a/crates/ibc/src/serializers.rs
+++ b/crates/ibc/src/serializers.rs
@@ -18,12 +18,17 @@ pub mod serde_string {
 
     use serde::{de, Deserialize, Deserializer, Serializer};
 
+    use crate::prelude::*;
+
+    // Note: used String version (slower + heap) instead of str,
+    // because both str ser/de hit some kind of f64/f32 case when compiled into wasm
+    // and fails to be validated f32/f64 wasm runtimes
     pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
     where
         T: Display,
         S: Serializer,
     {
-        serializer.collect_str(value)
+        serializer.serialize_str(value.to_string().as_ref())
     }
 
     pub fn deserialize<'de, T, D>(deserializer: D) -> Result<T, D::Error>
@@ -32,9 +37,7 @@ pub mod serde_string {
         T::Err: Display,
         D: Deserializer<'de>,
     {
-        <&str>::deserialize(deserializer)?
-            .parse()
-            .map_err(de::Error::custom)
+        T::from_str(<String>::deserialize(deserializer)?.as_str()).map_err(de::Error::custom)
     }
 }
 

From 26c7ba6c5e5379379dd10b1e41f03f41bf492b50 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 17 Oct 2023 12:01:40 -0700
Subject: [PATCH 043/182] chore: simplify GitHub issue labeling (#925)

---
 CONTRIBUTING.md | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index d7429ccfc..c37a4e7ec 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -75,14 +75,13 @@ We welcome bug reports, feature requests, and other contributions to our project
 
 3. **Provide detailed information**: In the issue description, clearly state the purpose of the issue and follow the guidelines of the issue template
 
-4. A maintainer will take care of assigning the appropriate labels to your issue.
+Note: A maintainer will take care of assigning the appropriate labels to your issue with the following convention:
 
-We use the following convention for issue label names:
-    - (WHY) The purpose or objective of this issue with Objective-level "O" labels like `O: security`, `O: new-feature`, etc.
-    - (WHICH) The part of the system this issue relates to using:
-      - External-level "E" labels if the issue fall outside the current scope of the system and is related to external dependencies or projects like `E: non-cosmos`, `E: no-std` etc.
-      - or "Internal-level "I" labels for anything related to the current scope of the product like `I: errors`, `I: documentation`, etc.
-    - (HOW) If any administrative considerations should be taken into account use Administrative-level "A" labels like `A: help-wanted`, `A: critical`, etc.
+- Objective-level (WHY): conveys the overarching purpose or objective of the issue by labels starting with "O" like `O: security`, `O: new-feature`, etc.
+
+- Scope-level (WHICH): specifies the part of the system that the issue pertains to and labels starting with "S" like `S: non-cosmos`, `S: no-std`, etc.
+
+- Admin-level (HOW) includes relevant administrative considerations on how best handling the issue and labels starting with "A" like `A: help-wanted`, `A: critical`, etc.
 
 ## Pull Requests
 
@@ -256,7 +255,7 @@ Our release process is as follows:
    2. Publish `ibc-derive` with `cargo publish -p ibc-derive`
 4. Bump the versions of relevant crates (`ibc` and `ibc-query`) in their
    `Cargo.toml` to the new version, and push these changes to the release PR.
-      + If you released a new version of `ibc-derive` in step 3, make sure to update that dependency.
+      - If you released a new version of `ibc-derive` in step 3, make sure to update that dependency.
 5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all the
    documentation compiles and seems up-to-date and coherent. Fix any potential
    issues here and push them to the release PR.
@@ -268,7 +267,7 @@ Our release process is as follows:
 10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
    tag message, write the version and the link to the corresponding section of
    the changelog.
-       + Push the tag with `git push --tags`
+       - Push the tag with `git push --tags`
 11. Once the tag is pushed, create a GitHub release and append
    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)` 
    to the release description.

From 476937b1a4e8e9d36e2147070b96bf819558c05f Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 18 Oct 2023 18:11:32 +0300
Subject: [PATCH 044/182] test: tendermint client update when client expires or
 validator set has changed (#921)

* add client expiry test

* tm hostblock supports trusted next validator set

* fix validator change update test

* fix incorrect validator updates at each block

* add sad client update for validator change

* cargo fmt

* catch up with main branch changes

* update MockContextConfig with validator set history

* refactor tests with updated MockContextConfig

* rm duplicate def of `on`

* add todo for max_history_size and validator_set_history

* consistent variable naming in tests

* bump typed-builder version

* rm redundant builder arguments

* replace todo with panic

* mv Tendermint ClientStateConfig under ics07

* use ctx_a with ctx_b instead of only ctx

* use client_id consistently

* use mocks feature directly in dev-deps

* include trusting_period and max_clock_drift in mock light client config

* revert advance chain height with timestamp

* update client expiry test

* add test to check max_clock_drift

* rm TODO comments in favor of gh issue

* revert ctx_a renaming

* add changelog entry
---
 .../538-test-for-client-expiry.md             |   2 +
 .github/workflows/cw-check.yaml               |   2 -
 crates/ibc/Cargo.toml                         |   6 +-
 .../clients/ics07_tendermint/client_state.rs  |  41 ++-
 .../src/clients/ics07_tendermint/header.rs    |   3 +-
 .../ics02_client/handler/update_client.rs     | 288 +++++++++++++++---
 crates/ibc/src/mock/context.rs                | 226 +++++++++++++-
 crates/ibc/src/mock/host.rs                   |  60 ++--
 8 files changed, 556 insertions(+), 72 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/538-test-for-client-expiry.md

diff --git a/.changelog/unreleased/improvements/538-test-for-client-expiry.md b/.changelog/unreleased/improvements/538-test-for-client-expiry.md
new file mode 100644
index 000000000..701905ada
--- /dev/null
+++ b/.changelog/unreleased/improvements/538-test-for-client-expiry.md
@@ -0,0 +1,2 @@
+- Add test for expired client status.
+  ([\#538](https://github.com/cosmos/ibc-rs/issues/538))
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index e06e19251..ae84a64d9 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -4,8 +4,6 @@ on:
     paths:
       - .github/workflows/cw-check.yml
       - ci/cw-check/**
-
-on:
   push:
     tags:
       - v[0-9]+.*
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 0a7a66025..afbba5561 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -46,7 +46,7 @@ schema = ["dep:schemars", "serde", "std"]
 
 # This feature grants access to development-time mocking libraries, such as `MockContext` or `MockHeader`.
 # Depends on the `testgen` suite for generating Tendermint light blocks.
-mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot"]
+mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot", "typed-builder"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
@@ -73,6 +73,7 @@ scale-info = { version = "2.1.2", default-features = false, features = ["derive"
 ## for borsh encode or decode
 borsh = {version = "0.10", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
+typed-builder = { version = "0.17.0", optional = true }
 
 ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
 
@@ -102,5 +103,4 @@ rstest = "0.18.1"
 tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
 test-log = { version = "0.2.10", features = ["trace"] }
 tendermint-rpc = { version = "0.34", features = ["http-client", "websocket-client"] }
-tendermint-testgen = { version = "0.34" } # Needed for generating (synthetic) light blocks.
-parking_lot = { version = "0.12.1" }
+ibc = { path = ".", features = ["mocks"] }
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index cc7c1f66a..7fc11d421 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -1129,7 +1129,8 @@ pub mod test_util {
     use tendermint::block::Header;
 
     use crate::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
-    use crate::clients::ics07_tendermint::error::Error;
+    use crate::clients::ics07_tendermint::error::{Error as ClientError, Error};
+    use crate::clients::ics07_tendermint::trust_threshold::TrustThreshold;
     use crate::core::ics02_client::height::Height;
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::ChainId;
@@ -1180,4 +1181,42 @@ pub mod test_util {
             allow_update_after_misbehaviour: false,
         }
     }
+
+    #[derive(typed_builder::TypedBuilder, Debug)]
+    pub struct ClientStateConfig {
+        pub chain_id: ChainId,
+        #[builder(default)]
+        pub trust_level: TrustThreshold,
+        #[builder(default = Duration::from_secs(64000))]
+        pub trusting_period: Duration,
+        #[builder(default = Duration::from_secs(128000))]
+        pub unbonding_period: Duration,
+        #[builder(default = Duration::from_millis(3000))]
+        max_clock_drift: Duration,
+        pub latest_height: Height,
+        #[builder(default)]
+        pub proof_specs: ProofSpecs,
+        #[builder(default)]
+        pub upgrade_path: Vec<String>,
+        #[builder(default = AllowUpdate { after_expiry: false, after_misbehaviour: false })]
+        allow_update: AllowUpdate,
+    }
+
+    impl TryFrom<ClientStateConfig> for ClientState {
+        type Error = ClientError;
+
+        fn try_from(config: ClientStateConfig) -> Result<Self, Self::Error> {
+            ClientState::new(
+                config.chain_id,
+                config.trust_level,
+                config.trusting_period,
+                config.unbonding_period,
+                config.max_clock_drift,
+                config.latest_height,
+                config.proof_specs,
+                config.upgrade_path,
+                config.allow_update,
+            )
+        }
+    }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index da0167e3e..22056d4a6 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -318,13 +318,14 @@ pub mod test_util {
         fn from(light_block: SyntheticTmBlock) -> Self {
             let SyntheticTmBlock {
                 trusted_height,
+                trusted_next_validators,
                 light_block,
             } = light_block;
             Self {
                 signed_header: light_block.signed_header,
                 validator_set: light_block.validators,
                 trusted_height,
-                trusted_next_validator_set: light_block.next_validators,
+                trusted_next_validator_set: trusted_next_validators,
             }
         }
     }
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 10335d7b7..ddd7bef73 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -143,7 +143,9 @@ mod tests {
     use crate::core::ics24_host::identifier::{ChainId, ClientId};
     use crate::core::timestamp::Timestamp;
     use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
-    use crate::mock::context::{AnyConsensusState, MockContext};
+    use crate::mock::context::{
+        AnyConsensusState, MockClientConfig, MockContext, MockContextConfig,
+    };
     use crate::mock::header::MockHeader;
     use crate::mock::host::{HostBlock, HostType};
     use crate::mock::misbehaviour::Misbehaviour as MockMisbehaviour;
@@ -249,47 +251,70 @@ mod tests {
     fn test_update_synthetic_tendermint_client_validator_change_ok() {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
-        let update_height = Height::new(1, 21).unwrap();
         let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
 
-        let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
-            HostType::Mock,
-            5,
-            Height::new(1, 1).unwrap(),
-        )
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
-        );
+        let mut ctx_a = MockContextConfig::builder()
+            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .latest_height(Height::new(1, 1).unwrap())
+            .build()
+            .with_client_config(
+                // client state initialized with client_height, and
+                // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_b.clone())
+                    .client_id(client_id.clone())
+                    .client_state_height(client_height)
+                    .client_type(tm_client_type())
+                    .build(),
+            );
 
-        let ctx_b = MockContext::new_with_validator_history(
-            chain_id_b,
-            HostType::SyntheticTendermint,
-            &[
-                // TODO(rano): the validator set params during setups.
-                // Here I picked the default validator set which is
-                // used at host side client creation.
-                vec![
-                    TestgenValidator::new("1").voting_power(50),
-                    TestgenValidator::new("2").voting_power(50),
-                ],
-                vec![
-                    TestgenValidator::new("1").voting_power(60),
-                    TestgenValidator::new("2").voting_power(40),
-                ],
+        let ctx_b_val_history = vec![
+            // First two validator sets are default at client creation
+            //
+            // validator set of height-20
+            vec![
+                TestgenValidator::new("1").voting_power(50),
+                TestgenValidator::new("2").voting_power(50),
             ],
-            update_height,
-        );
+            // validator set of height-21
+            vec![
+                TestgenValidator::new("1").voting_power(50),
+                TestgenValidator::new("2").voting_power(50),
+            ],
+            // validator set of height-22
+            vec![
+                TestgenValidator::new("1").voting_power(30),
+                TestgenValidator::new("2").voting_power(70),
+            ],
+            // validator set of height-23
+            vec![
+                TestgenValidator::new("1").voting_power(20),
+                TestgenValidator::new("2").voting_power(80),
+            ],
+        ];
+
+        let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+
+        let ctx_b = MockContextConfig::builder()
+            .host_id(chain_id_b.clone())
+            .host_type(HostType::SyntheticTendermint)
+            .latest_height(update_height)
+            .max_history_size(ctx_b_val_history.len() as u64 - 1)
+            .validator_set_history(ctx_b_val_history)
+            .build();
 
         let signer = get_dummy_account_id();
 
         let mut block = ctx_b.host_block(&update_height).unwrap().clone();
         block.set_trusted_height(client_height);
 
+        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+            _ => panic!("unexpected host block type"),
+        };
+
+        block.set_trusted_next_validators_set(trusted_next_validator_set);
+
         let latest_header_height = block.height();
         let msg = MsgUpdateClient {
             client_id,
@@ -297,20 +322,102 @@ mod tests {
             signer,
         };
 
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
         assert!(res.is_ok());
 
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        let res = execute(
+            &mut ctx_a,
+            MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()),
+        );
         assert!(res.is_ok(), "result: {res:?}");
 
-        let client_state = ctx.client_state(&msg.client_id).unwrap();
+        let client_state = ctx_a.client_state(&msg.client_id).unwrap();
         assert!(client_state
-            .status(&ctx, &msg.client_id)
+            .status(&ctx_a, &msg.client_id)
             .unwrap()
             .is_active());
         assert_eq!(client_state.latest_height(), latest_header_height);
     }
 
+    #[test]
+    fn test_update_synthetic_tendermint_client_validator_change_fail() {
+        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+        let client_height = Height::new(1, 20).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+
+        let ctx_a = MockContextConfig::builder()
+            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .latest_height(Height::new(1, 1).unwrap())
+            .build()
+            .with_client_config(
+                // client state initialized with client_height, and
+                // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_b.clone())
+                    .client_id(client_id.clone())
+                    .client_state_height(client_height)
+                    .client_type(tm_client_type())
+                    .build(),
+            );
+
+        let ctx_b_val_history = vec![
+            // First two validator sets are default at client creation
+            //
+            // validator set of height-20
+            vec![
+                TestgenValidator::new("1").voting_power(50),
+                TestgenValidator::new("2").voting_power(50),
+            ],
+            // incorrect next validator set for height-20
+            // validator set of height-21
+            vec![
+                TestgenValidator::new("1").voting_power(45),
+                TestgenValidator::new("2").voting_power(55),
+            ],
+            // validator set of height-22
+            vec![
+                TestgenValidator::new("1").voting_power(30),
+                TestgenValidator::new("2").voting_power(70),
+            ],
+            // validator set of height-23
+            vec![
+                TestgenValidator::new("1").voting_power(20),
+                TestgenValidator::new("2").voting_power(80),
+            ],
+        ];
+
+        let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+
+        let ctx_b = MockContextConfig::builder()
+            .host_id(chain_id_b.clone())
+            .host_type(HostType::SyntheticTendermint)
+            .latest_height(update_height)
+            .max_history_size(ctx_b_val_history.len() as u64 - 1)
+            .validator_set_history(ctx_b_val_history)
+            .build();
+
+        let signer = get_dummy_account_id();
+
+        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+        block.set_trusted_height(client_height);
+
+        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+            _ => panic!("unexpected host block type"),
+        };
+
+        block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+        let msg = MsgUpdateClient {
+            client_id,
+            client_message: block.into(),
+            signer,
+        };
+
+        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        assert!(res.is_err());
+    }
+
     #[test]
     fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
@@ -753,4 +860,113 @@ mod tests {
         assert!(res.is_ok());
         ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
     }
+
+    #[test]
+    fn test_expired_client() {
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+
+        let update_height = Height::new(1, 21).unwrap();
+        let client_height = update_height.sub(3).unwrap();
+
+        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+        let timestamp = Timestamp::now();
+
+        let trusting_period = Duration::from_secs(64);
+
+        let mut ctx = MockContextConfig::builder()
+            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .latest_height(Height::new(1, 1).unwrap())
+            .latest_timestamp(timestamp)
+            .build()
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_b.clone())
+                    .client_id(client_id.clone())
+                    .client_state_height(client_height)
+                    .client_type(tm_client_type())
+                    .latest_timestamp(timestamp)
+                    .trusting_period(trusting_period)
+                    .build(),
+            );
+
+        while ctx.host_timestamp().expect("no error")
+            < (timestamp + trusting_period).expect("no error")
+        {
+            ctx.advance_host_chain_height();
+        }
+
+        let client_state = ctx.client_state(&client_id).unwrap();
+
+        assert!(client_state.status(&ctx, &client_id).unwrap().is_expired());
+    }
+
+    #[test]
+    fn test_client_update_max_clock_drift() {
+        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+
+        let client_height = Height::new(1, 20).unwrap();
+
+        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+        let timestamp = Timestamp::now();
+
+        let max_clock_drift = Duration::from_secs(64);
+
+        let ctx_a = MockContextConfig::builder()
+            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .latest_height(Height::new(1, 1).unwrap())
+            .latest_timestamp(timestamp)
+            .build()
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_b.clone())
+                    .client_id(client_id.clone())
+                    .client_state_height(client_height)
+                    .client_type(tm_client_type())
+                    .latest_timestamp(timestamp)
+                    .max_clock_drift(max_clock_drift)
+                    .build(),
+            );
+
+        let mut ctx_b = MockContextConfig::builder()
+            .host_id(chain_id_b.clone())
+            .host_type(HostType::SyntheticTendermint)
+            .latest_height(client_height)
+            .latest_timestamp(timestamp)
+            .max_history_size(u64::MAX)
+            .build();
+
+        while ctx_b.host_timestamp().expect("no error")
+            < (ctx_a.host_timestamp().expect("no error") + max_clock_drift).expect("no error")
+        {
+            ctx_b.advance_host_chain_height();
+        }
+
+        // include current block
+        ctx_b.advance_host_chain_height();
+
+        let update_height = ctx_b.latest_height();
+
+        let signer = get_dummy_account_id();
+
+        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+        block.set_trusted_height(client_height);
+
+        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+            _ => panic!("unexpected host block type"),
+        };
+
+        block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+        let msg = MsgUpdateClient {
+            client_id,
+            client_message: block.clone().into(),
+            signer,
+        };
+
+        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        assert!(res.is_err());
+    }
 }
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index f31e23a6d..53b64956b 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -15,9 +15,11 @@ use ibc_proto::protobuf::Protobuf;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
 use tracing::debug;
+use typed_builder::TypedBuilder;
 
 use super::client_state::{MOCK_CLIENT_STATE_TYPE_URL, MOCK_CLIENT_TYPE};
 use super::consensus_state::MOCK_CONSENSUS_STATE_TYPE_URL;
+use crate::clients::ics07_tendermint::client_state::test_util::ClientStateConfig as TmClientStateConfig;
 use crate::clients::ics07_tendermint::client_state::{
     ClientState as TmClientState, TENDERMINT_CLIENT_STATE_TYPE_URL,
 };
@@ -217,6 +219,135 @@ pub struct MockContext {
     pub logs: Vec<String>,
 }
 
+#[derive(Debug, TypedBuilder)]
+#[builder(build_method(into = MockContext))]
+pub struct MockContextConfig {
+    #[builder(default = HostType::Mock)]
+    host_type: HostType,
+
+    host_id: ChainId,
+
+    #[builder(default = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS))]
+    block_time: Duration,
+
+    // may panic if validator_set_history size is less than max_history_size + 1
+    #[builder(default = 5)]
+    max_history_size: u64,
+
+    #[builder(default, setter(strip_option))]
+    validator_set_history: Option<Vec<Vec<TestgenValidator>>>,
+
+    latest_height: Height,
+
+    #[builder(default = Timestamp::now())]
+    latest_timestamp: Timestamp,
+}
+
+impl From<MockContextConfig> for MockContext {
+    fn from(params: MockContextConfig) -> Self {
+        assert_ne!(
+            params.max_history_size, 0,
+            "The chain must have a non-zero max_history_size"
+        );
+
+        assert_ne!(
+            params.latest_height.revision_height(),
+            0,
+            "The chain must have a non-zero revision_height"
+        );
+
+        // Compute the number of blocks to store.
+        let n = min(
+            params.max_history_size,
+            params.latest_height.revision_height(),
+        );
+
+        assert_eq!(
+            params.host_id.revision_number(),
+            params.latest_height.revision_number(),
+            "The version in the chain identifier must match the version in the latest height"
+        );
+
+        let next_block_timestamp = params
+            .latest_timestamp
+            .add(params.block_time)
+            .expect("Never fails");
+
+        let history = if let Some(validator_set_history) = params.validator_set_history {
+            (0..n)
+                .rev()
+                .map(|i| {
+                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
+                    // where N = now(), BT = block_time
+                    HostBlock::generate_block_with_validators(
+                        params.host_id.clone(),
+                        params.host_type,
+                        params
+                            .latest_height
+                            .sub(i)
+                            .expect("Never fails")
+                            .revision_height(),
+                        next_block_timestamp
+                            .sub(params.block_time * ((i + 1) as u32))
+                            .expect("Never fails"),
+                        &validator_set_history[(n - i) as usize - 1],
+                        &validator_set_history[(n - i) as usize],
+                    )
+                })
+                .collect()
+        } else {
+            (0..n)
+                .rev()
+                .map(|i| {
+                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
+                    // where N = now(), BT = block_time
+                    HostBlock::generate_block(
+                        params.host_id.clone(),
+                        params.host_type,
+                        params
+                            .latest_height
+                            .sub(i)
+                            .expect("Never fails")
+                            .revision_height(),
+                        next_block_timestamp
+                            .sub(params.block_time * ((i + 1) as u32))
+                            .expect("Never fails"),
+                    )
+                })
+                .collect()
+        };
+
+        MockContext {
+            host_chain_type: params.host_type,
+            host_chain_id: params.host_id.clone(),
+            max_history_size: params.max_history_size,
+            history,
+            block_time: params.block_time,
+            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
+            events: Vec::new(),
+            logs: Vec::new(),
+        }
+    }
+}
+
+#[derive(Debug, TypedBuilder)]
+pub struct MockClientConfig {
+    client_chain_id: ChainId,
+    client_id: ClientId,
+    #[builder(default = mock_client_type())]
+    client_type: ClientType,
+    client_state_height: Height,
+    #[builder(default)]
+    consensus_state_heights: Vec<Height>,
+    #[builder(default = Timestamp::now())]
+    latest_timestamp: Timestamp,
+
+    #[builder(default = Duration::from_secs(64000))]
+    pub trusting_period: Duration,
+    #[builder(default = Duration::from_millis(3000))]
+    max_clock_drift: Duration,
+}
+
 /// Returns a MockContext with bare minimum initialization: no clients, no connections and no channels are
 /// present, and the chain has Height(5). This should be used sparingly, mostly for testing the
 /// creation of new domain objects.
@@ -324,7 +455,7 @@ impl MockContext {
         validator_history: &[Vec<TestgenValidator>],
         latest_height: Height,
     ) -> Self {
-        let max_history_size = validator_history.len() - 1;
+        let max_history_size = validator_history.len() as u64 - 1;
 
         assert_ne!(
             max_history_size, 0,
@@ -338,7 +469,7 @@ impl MockContext {
         );
 
         assert!(
-            max_history_size as u64 <= latest_height.revision_height(),
+            max_history_size <= latest_height.revision_height(),
             "The number of blocks must be greater than the number of validator set histories"
         );
 
@@ -359,17 +490,12 @@ impl MockContext {
                 HostBlock::generate_block_with_validators(
                     host_id.clone(),
                     host_type,
-                    latest_height
-                        .sub(i as u64)
-                        .expect("Never fails")
-                        .revision_height(),
+                    latest_height.sub(i).expect("Never fails").revision_height(),
                     next_block_timestamp
-                        .sub(Duration::from_secs(
-                            DEFAULT_BLOCK_TIME_SECS * (i as u64 + 1),
-                        ))
+                        .sub(Duration::from_secs(DEFAULT_BLOCK_TIME_SECS * (i + 1)))
                         .expect("Never fails"),
-                    &validator_history[i],
-                    &validator_history[i + 1],
+                    &validator_history[(max_history_size - i) as usize - 1],
+                    &validator_history[(max_history_size - i) as usize],
                 )
             })
             .collect();
@@ -377,7 +503,7 @@ impl MockContext {
         MockContext {
             host_chain_type: host_type,
             host_chain_id: host_id.clone(),
-            max_history_size: max_history_size as u64,
+            max_history_size,
             history,
             block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
@@ -554,6 +680,82 @@ impl MockContext {
         self
     }
 
+    pub fn with_client_config(self, client: MockClientConfig) -> Self {
+        let cs_heights = if client.consensus_state_heights.is_empty() {
+            vec![client.client_state_height]
+        } else {
+            client.consensus_state_heights
+        };
+
+        let (client_state, consensus_states) = match client.client_type.as_str() {
+            MOCK_CLIENT_TYPE => {
+                let blocks: Vec<_> = cs_heights
+                    .into_iter()
+                    .map(|cs_height| (cs_height, MockHeader::new(cs_height)))
+                    .collect();
+
+                let client_state = MockClientState::new(blocks.last().expect("never fails").1);
+
+                let cs_states = blocks
+                    .into_iter()
+                    .map(|(height, block)| (height, MockConsensusState::new(block).into()))
+                    .collect();
+
+                (client_state.into(), cs_states)
+            }
+            TENDERMINT_CLIENT_TYPE => {
+                let n_blocks = cs_heights.len();
+                let blocks: Vec<_> = cs_heights
+                    .into_iter()
+                    .enumerate()
+                    .map(|(i, cs_height)| {
+                        (
+                            cs_height,
+                            HostBlock::generate_tm_block(
+                                client.client_chain_id.clone(),
+                                cs_height.revision_height(),
+                                client
+                                    .latest_timestamp
+                                    .sub(self.block_time * ((n_blocks - 1 - i) as u32))
+                                    .expect("never fails"),
+                            ),
+                        )
+                    })
+                    .collect();
+
+                let client_state: TmClientState = TmClientStateConfig::builder()
+                    .chain_id(client.client_chain_id)
+                    .latest_height(client.client_state_height)
+                    .trusting_period(client.trusting_period)
+                    .max_clock_drift(client.max_clock_drift)
+                    .build()
+                    .try_into()
+                    .expect("never fails");
+
+                client_state.validate().expect("never fails");
+
+                let cs_states = blocks
+                    .into_iter()
+                    .map(|(height, block)| (height, block.into()))
+                    .collect();
+
+                (client_state.into(), cs_states)
+            }
+            _ => panic!("unknown client type"),
+        };
+
+        let client_record = MockClientRecord {
+            client_state: Some(client_state),
+            consensus_states,
+        };
+
+        self.ibc_store
+            .lock()
+            .clients
+            .insert(client.client_id.clone(), client_record);
+        self
+    }
+
     /// Associates a connection to this context.
     pub fn with_connection(
         self,
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc/src/mock/host.rs
index 18950335d..30444b478 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc/src/mock/host.rs
@@ -6,6 +6,7 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::protobuf::Protobuf as ErasedProtobuf;
 use tendermint::block::Header as TmHeader;
+use tendermint::validator::Set as ValidatorSet;
 use tendermint_testgen::light_block::TmLightBlock;
 use tendermint_testgen::{
     Generator, Header as TestgenHeader, LightBlock as TestgenLightBlock,
@@ -38,6 +39,7 @@ pub enum HostType {
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct SyntheticTmBlock {
     pub trusted_height: Height,
+    pub trusted_next_validators: ValidatorSet,
     pub light_block: TmLightBlock,
 }
 
@@ -78,6 +80,15 @@ impl HostBlock {
         }
     }
 
+    pub fn set_trusted_next_validators_set(&mut self, trusted_next_validators: ValidatorSet) {
+        match self {
+            HostBlock::Mock(_) => {}
+            HostBlock::SyntheticTendermint(light_block) => {
+                light_block.trusted_next_validators = trusted_next_validators
+            }
+        }
+    }
+
     /// Returns the timestamp of a block.
     pub fn timestamp(&self) -> Timestamp {
         match self {
@@ -119,18 +130,23 @@ impl HostBlock {
                 timestamp,
             })),
             HostType::SyntheticTendermint => {
+                let light_block = TestgenLightBlock::new_default_with_header(
+                    TestgenHeader::new(validators)
+                        .height(height)
+                        .chain_id(&chain_id.to_string())
+                        .next_validators(next_validators)
+                        .time(timestamp.into_tm_time().expect("Never fails")),
+                )
+                .validators(validators)
+                .next_validators(next_validators)
+                .generate()
+                .expect("Never fails");
+
                 HostBlock::SyntheticTendermint(Box::new(SyntheticTmBlock {
                     trusted_height: Height::new(chain_id.revision_number(), 1)
                         .expect("Never fails"),
-                    light_block: TestgenLightBlock::new_default_with_header(
-                        TestgenHeader::new(validators)
-                            .height(height)
-                            .chain_id(&chain_id.to_string())
-                            .next_validators(next_validators)
-                            .time(timestamp.into_tm_time().expect("Never fails")),
-                    )
-                    .generate()
-                    .expect("Never fails"),
+                    trusted_next_validators: light_block.next_validators.clone(),
+                    light_block,
                 }))
             }
         }
@@ -141,15 +157,24 @@ impl HostBlock {
         height: u64,
         timestamp: Timestamp,
     ) -> SyntheticTmBlock {
-        let light_block = TestgenLightBlock::new_default_with_time_and_chain_id(
-            chain_id.to_string(),
-            timestamp.into_tm_time().expect("Never fails"),
-            height,
-        )
-        .generate()
-        .expect("Never fails");
+        let validators = [
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ];
+
+        let header = TestgenHeader::new(&validators)
+            .height(height)
+            .chain_id(chain_id.as_str())
+            .next_validators(&validators)
+            .time(timestamp.into_tm_time().expect("Never fails"));
+
+        let light_block = TestgenLightBlock::new_default_with_header(header)
+            .generate()
+            .expect("Never fails");
+
         SyntheticTmBlock {
             trusted_height: Height::new(chain_id.revision_number(), 1).expect("Never fails"),
+            trusted_next_validators: light_block.next_validators.clone(),
             light_block,
         }
     }
@@ -197,6 +222,7 @@ impl From<HostBlock> for Any {
 
             let SyntheticTmBlock {
                 trusted_height,
+                trusted_next_validators,
                 light_block,
             } = light_block;
 
@@ -204,7 +230,7 @@ impl From<HostBlock> for Any {
                 signed_header: Some(light_block.signed_header.into()),
                 validator_set: Some(light_block.validators.into()),
                 trusted_height: Some(trusted_height.into()),
-                trusted_validators: Some(light_block.next_validators.into()),
+                trusted_validators: Some(trusted_next_validators.into()),
             }
             .encode_to_vec()
         }

From adcb0f76279425e2217a318f3b3ab68c5bcf8beb Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Wed, 18 Oct 2023 23:59:17 +0200
Subject: [PATCH 045/182] chore: enable `std` feature when `mocks` is enabled
 (#926)

`mocks` feature results in use of `Timestamp::now` which is only
defined when `std` feature is enabled.  Make `std` implied by `mocks`.
---
 .../850-fix-wasm-compilation-error-with-floats.md        | 2 +-
 .../unreleased/improvements/926_mocks_implies_std.md     | 9 +++++++++
 crates/ibc/Cargo.toml                                    | 4 ++--
 3 files changed, 12 insertions(+), 3 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/926_mocks_implies_std.md

diff --git a/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md b/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
index ca866767a..bb17a129e 100644
--- a/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
+++ b/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
@@ -1,4 +1,4 @@
 - Fix compilation issue with Wasm envs because of floats
   - Use `serde-json-wasm` dependency instead of `serde-json` for no-floats support
   - Add CI test to include CosmWasm compilation check
-([/#850](https://github.com/cosmos/ibc-rs/issues/850))
+([\#850](https://github.com/cosmos/ibc-rs/issues/850))
diff --git a/.changelog/unreleased/improvements/926_mocks_implies_std.md b/.changelog/unreleased/improvements/926_mocks_implies_std.md
new file mode 100644
index 000000000..85474a8b9
--- /dev/null
+++ b/.changelog/unreleased/improvements/926_mocks_implies_std.md
@@ -0,0 +1,9 @@
+- Change `mocks` feature to imply `std` since it requires
+  Timestamp::now to work.
+  ([\#926](https://github.com/cosmos/ibc-rs/pull/926))
+
+<!--
+    Add your entry's details here (in Markdown format).
+
+    If you don't change this message, or if this file is empty, the entry will
+    not be created. -->
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index afbba5561..79723ca7c 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -21,7 +21,7 @@ default = ["std"]
 std = [
     "ibc-proto/std",
     "ics23/std",
-    "serde/std",    
+    "serde/std",
     "tracing/std",
     "prost/std",
     "bytes/std",
@@ -46,7 +46,7 @@ schema = ["dep:schemars", "serde", "std"]
 
 # This feature grants access to development-time mocking libraries, such as `MockContext` or `MockHeader`.
 # Depends on the `testgen` suite for generating Tendermint light blocks.
-mocks = ["tendermint-testgen", "tendermint/clock", "parking_lot", "typed-builder"]
+mocks = ["tendermint-testgen", "parking_lot", "typed-builder", "std"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.

From fa07561d04fb8d850625c7574c07c6921e3cf13a Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 19 Oct 2023 07:13:25 -0700
Subject: [PATCH 046/182] chore: remove AnySchema (#930)

---
 .../unreleased/improvements/929-remove-anyschema.md      | 2 ++
 crates/ibc/Cargo.toml                                    | 4 ++--
 crates/ibc/src/core/ics02_client/msgs/create_client.rs   | 2 --
 crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs    | 1 -
 crates/ibc/src/core/ics02_client/msgs/update_client.rs   | 1 -
 crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs  | 2 --
 .../ibc/src/core/ics03_connection/msgs/conn_open_ack.rs  | 1 -
 .../ibc/src/core/ics03_connection/msgs/conn_open_try.rs  | 1 -
 crates/ibc/src/utils/mod.rs                              | 1 -
 crates/ibc/src/utils/schema.rs                           | 9 ---------
 10 files changed, 4 insertions(+), 20 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/929-remove-anyschema.md
 delete mode 100644 crates/ibc/src/utils/schema.rs

diff --git a/.changelog/unreleased/improvements/929-remove-anyschema.md b/.changelog/unreleased/improvements/929-remove-anyschema.md
new file mode 100644
index 000000000..5e3e904d2
--- /dev/null
+++ b/.changelog/unreleased/improvements/929-remove-anyschema.md
@@ -0,0 +1,2 @@
+- Remove `AnySchema` as `JsonSchema` derive on `Any` now accessible through
+  `ibc-proto-rs` ([#929](https://github.com/cosmos/ibc-rs/issues/929))
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 79723ca7c..aca555c97 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -42,7 +42,7 @@ borsh = ["dep:borsh", "ibc-proto/borsh"]
 serde = ["dep:serde", "dep:serde_derive", "serde_json", "ibc-proto/serde", "ics23/serde"]
 
 # CosmWasm message API generator compatible, should not be inside on chain code
-schema = ["dep:schemars", "serde", "std"]
+schema = ["dep:schemars", "ibc-proto/json-schema", "serde", "std"]
 
 # This feature grants access to development-time mocking libraries, such as `MockContext` or `MockHeader`.
 # Depends on the `testgen` suite for generating Tendermint light blocks.
@@ -50,7 +50,7 @@ mocks = ["tendermint-testgen", "parking_lot", "typed-builder", "std"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.37.1", default-features = false, features = ["serde"] }
+ibc-proto = { version = "0.37.1", default-features = false }
 ics23 = { version = "0.11", default-features = false, features = ["host-functions"] }
 time = { version = ">=0.3.0, <0.3.30", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index 37214c326..b292367b8 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -19,9 +19,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgCreateClient {
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state: Any,
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub consensus_state: Any,
     pub signer: Signer,
 }
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index 72f49d0b2..96b3e4e68 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -23,7 +23,6 @@ pub struct MsgSubmitMisbehaviour {
     /// client unique identifier
     pub client_id: ClientId,
     /// misbehaviour used for freezing the light client
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub misbehaviour: ProtoAny,
     /// signer address
     pub signer: Signer,
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 4d4b809c5..3995d15d2 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -24,7 +24,6 @@ pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgUpdateClient {
     pub client_id: ClientId,
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_message: Any,
     pub signer: Signer,
 }
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index 6fdbca40e..9a3bfa444 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -27,11 +27,9 @@ pub struct MsgUpgradeClient {
     // client unique identifier
     pub client_id: ClientId,
     // Upgraded client state
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub upgraded_client_state: Any,
     // Upgraded consensus state, only contains enough information
     // to serve as a basis of trust in update logic
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub upgraded_consensus_state: Any,
     // proof that old chain committed to new client
     pub proof_upgrade_client: CommitmentProofBytes,
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index a470c8c10..0e9500abf 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -27,7 +27,6 @@ pub struct MsgConnectionOpenAck {
     /// ConnectionId that chain B has chosen for it's ConnectionEnd
     pub conn_id_on_b: ConnectionId,
     /// ClientState of client tracking chain A on chain B
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state_of_a_on_b: Any,
     /// proof of ConnectionEnd stored on Chain B during ConnOpenTry
     pub proof_conn_end_on_b: CommitmentProofBytes,
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index ba24309f1..f69ee6016 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -25,7 +25,6 @@ pub struct MsgConnectionOpenTry {
     /// ClientId on B that the connection is being opened for
     pub client_id_on_b: ClientId,
     /// ClientState of client tracking chain B on chain A
-    #[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]
     pub client_state_of_b_on_a: Any,
     /// ClientId, ConnectionId and prefix of chain A
     pub counterparty: Counterparty,
diff --git a/crates/ibc/src/utils/mod.rs b/crates/ibc/src/utils/mod.rs
index 5cf51aed6..b4f1b623d 100644
--- a/crates/ibc/src/utils/mod.rs
+++ b/crates/ibc/src/utils/mod.rs
@@ -2,4 +2,3 @@
 
 pub(crate) mod macros;
 pub(crate) mod pretty;
-pub mod schema;
diff --git a/crates/ibc/src/utils/schema.rs b/crates/ibc/src/utils/schema.rs
deleted file mode 100644
index adc2e5269..000000000
--- a/crates/ibc/src/utils/schema.rs
+++ /dev/null
@@ -1,9 +0,0 @@
-use crate::prelude::*;
-
-/// Dummy type that mirrors `ibc_proto::google::protobuf::Any`.
-/// Meant to be used with `#[cfg_attr(feature = "schema", schemars(with = "crate::utils::schema::AnySchema"))]`
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-pub struct AnySchema {
-    pub type_url: String,
-    pub value: Vec<u8>,
-}

From 27592c4bebf09964eb58468083c8c00aed69e1d6 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Thu, 19 Oct 2023 20:51:59 +0300
Subject: [PATCH 047/182] refactor: packet_commitments and
 packet_acknowledgements return PacketState (#928)

* impl PacketState domain type

* refactor QueryContext method signatures

* update channel query methods

* add changelog entry
---
 ...commitments-and-packet-acknowledgements.md |  2 +
 crates/ibc-query/src/core/channel/query.rs    | 28 ++----
 crates/ibc-query/src/core/context.rs          |  8 +-
 crates/ibc/src/core/ics04_channel/packet.rs   | 87 ++++++++++++++++++-
 4 files changed, 97 insertions(+), 28 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md

diff --git a/.changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md b/.changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md
new file mode 100644
index 000000000..ad3827615
--- /dev/null
+++ b/.changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md
@@ -0,0 +1,2 @@
+- Return PacketStates instead of paths from packet_commitments and
+  packet_acknowledgements ([\#927](https://github.com/cosmos/ibc-rs/issues/927))
diff --git a/crates/ibc-query/src/core/channel/query.rs b/crates/ibc-query/src/core/channel/query.rs
index 15a1db5ca..e0cf5cbf6 100644
--- a/crates/ibc-query/src/core/channel/query.rs
+++ b/crates/ibc-query/src/core/channel/query.rs
@@ -13,7 +13,7 @@ use ibc::core::ValidationContext;
 use ibc::Height;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::{
-    PacketState, QueryChannelClientStateRequest, QueryChannelClientStateResponse,
+    QueryChannelClientStateRequest, QueryChannelClientStateResponse,
     QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
@@ -274,17 +274,8 @@ where
     let commitments = ibc_ctx
         .packet_commitments(&channel_end_path)?
         .into_iter()
-        .map(|path| {
-            ibc_ctx
-                .get_packet_commitment(&path)
-                .map(|commitment| PacketState {
-                    port_id: path.port_id.as_str().into(),
-                    channel_id: path.channel_id.as_str().into(),
-                    sequence: path.sequence.into(),
-                    data: commitment.into_vec(),
-                })
-        })
-        .collect::<Result<_, _>>()?;
+        .map(Into::into)
+        .collect();
 
     Ok(QueryPacketCommitmentsResponse {
         commitments,
@@ -393,17 +384,8 @@ where
     let acknowledgements = ibc_ctx
         .packet_acknowledgements(&channel_end_path, commitment_sequences)?
         .into_iter()
-        .map(|path| {
-            ibc_ctx
-                .get_packet_acknowledgement(&path)
-                .map(|acknowledgement| PacketState {
-                    port_id: path.port_id.as_str().into(),
-                    channel_id: path.channel_id.as_str().into(),
-                    sequence: path.sequence.into(),
-                    data: acknowledgement.into_vec(),
-                })
-        })
-        .collect::<Result<_, _>>()?;
+        .map(Into::into)
+        .collect();
 
     Ok(QueryPacketAcknowledgementsResponse {
         acknowledgements,
diff --git a/crates/ibc-query/src/core/context.rs b/crates/ibc-query/src/core/context.rs
index 1b87e2bd0..a71e44615 100644
--- a/crates/ibc-query/src/core/context.rs
+++ b/crates/ibc-query/src/core/context.rs
@@ -2,9 +2,9 @@
 
 use ibc::core::ics03_connection::connection::IdentifiedConnectionEnd;
 use ibc::core::ics04_channel::channel::IdentifiedChannelEnd;
-use ibc::core::ics04_channel::packet::Sequence;
+use ibc::core::ics04_channel::packet::{PacketState, Sequence};
 use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::ics24_host::path::{AckPath, ChannelEndPath, CommitmentPath, Path};
+use ibc::core::ics24_host::path::{ChannelEndPath, Path};
 use ibc::core::{ContextError, ValidationContext};
 use ibc::prelude::*;
 use ibc::Height;
@@ -56,7 +56,7 @@ pub trait QueryContext: ProvableContext + ValidationContext {
     fn packet_commitments(
         &self,
         channel_end_path: &ChannelEndPath,
-    ) -> Result<Vec<CommitmentPath>, ContextError>;
+    ) -> Result<Vec<PacketState>, ContextError>;
 
     /// Filters the list of packet sequences for the given channel end that are acknowledged.
     /// Returns all the packet acknowledgements if `sequences` is empty.
@@ -64,7 +64,7 @@ pub trait QueryContext: ProvableContext + ValidationContext {
         &self,
         channel_end_path: &ChannelEndPath,
         sequences: impl ExactSizeIterator<Item = Sequence>,
-    ) -> Result<Vec<AckPath>, ContextError>;
+    ) -> Result<Vec<PacketState>, ContextError>;
 
     /// Filters the packet sequences for the given channel end that are not received.
     fn unreceived_packets(
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/crates/ibc/src/core/ics04_channel/packet.rs
index 4ae6ea5e7..b1914dcbf 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/crates/ibc/src/core/ics04_channel/packet.rs
@@ -2,7 +2,7 @@
 
 use core::str::FromStr;
 
-use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
+use ibc_proto::ibc::core::channel::v1::{Packet as RawPacket, PacketState as RawPacketState};
 
 use super::timeout::TimeoutHeight;
 use crate::core::ics04_channel::error::{ChannelError, PacketError};
@@ -287,6 +287,91 @@ impl From<Packet> for RawPacket {
     }
 }
 
+/// The packet state type.
+///
+/// Each application defines the structure of the `data` field.
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Default, Hash, PartialEq, Eq)]
+pub struct PacketState {
+    pub port_id: PortId,
+    pub chan_id: ChannelId,
+    pub seq: Sequence,
+    #[cfg_attr(
+        feature = "serde",
+        serde(serialize_with = "crate::serializers::ser_hex_upper")
+    )]
+    pub data: Vec<u8>,
+}
+impl core::fmt::Debug for PacketState {
+    fn fmt(&self, formatter: &mut core::fmt::Formatter<'_>) -> Result<(), core::fmt::Error> {
+        let data_wrapper = PacketData(&self.data);
+
+        formatter
+            .debug_struct("PacketState")
+            .field("port", &self.port_id)
+            .field("channel", &self.chan_id)
+            .field("sequence", &self.seq)
+            .field("data", &data_wrapper)
+            .finish()
+    }
+}
+
+/// Custom debug output to omit the packet data
+impl core::fmt::Display for PacketState {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> Result<(), core::fmt::Error> {
+        write!(
+            f,
+            "seq:{}, path:{}/{}",
+            self.seq, self.chan_id, self.port_id,
+        )
+    }
+}
+
+impl TryFrom<RawPacketState> for PacketState {
+    type Error = PacketError;
+
+    fn try_from(raw_pkt: RawPacketState) -> Result<Self, Self::Error> {
+        if Sequence::from(raw_pkt.sequence).is_zero() {
+            return Err(PacketError::ZeroPacketSequence);
+        }
+
+        if raw_pkt.data.is_empty() {
+            return Err(PacketError::ZeroPacketData);
+        }
+
+        Ok(PacketState {
+            seq: Sequence::from(raw_pkt.sequence),
+            port_id: raw_pkt.port_id.parse()?,
+            chan_id: raw_pkt.channel_id.parse()?,
+            data: raw_pkt.data,
+        })
+    }
+}
+
+impl From<PacketState> for RawPacketState {
+    fn from(packet: PacketState) -> Self {
+        Self {
+            sequence: packet.seq.0,
+            port_id: packet.port_id.to_string(),
+            channel_id: packet.chan_id.to_string(),
+            data: packet.data,
+        }
+    }
+}
+
 #[cfg(test)]
 pub mod test_utils {
     use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;

From d062728b9321c3f70aec514b38cf195b2f07eddd Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Thu, 19 Oct 2023 14:42:25 -0500
Subject: [PATCH 048/182] feat: implement consensus state pruning for
 Tendermint clients (#922)

* Add prune_oldest_consensus_state to ClientStateValidation

* Add consensus_state_heights fn signature to CommonContext

* Stub prune_oldest_consensus_state fn

* Add comments for delete_update_time and delete_update_height

* Clean up code structure a bit

* Fix some compilation errors

* Address all compilation errors resulting from prune_old_consensus_states

* Move delete_update_height and delete_update_time methods to ExecutionContext trait

* Clean up all compilation errors

* Disambiguate some method calls

* Fix fn formatting

* Run cargo fmt

* Flip consensus state condition check

* Add changelog entry

* Incorporate PR feedback

* test: add test_cons_state_pruning

* Simplify consensus state pruning unit test a bit

* Document `test_consensus_state_pruning` function

* Correct a detail in documentation

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../improvements/600-tendermint-pruning.md    |  1 +
 .../clients/ics07_tendermint/client_state.rs  | 32 ++++---
 .../client_state/update_client.rs             | 47 +++++++++-
 .../src/clients/ics07_tendermint/context.rs   |  4 +
 crates/ibc/src/core/ics02_client/context.rs   | 24 +++++
 .../ics02_client/handler/update_client.rs     | 92 +++++++++++++++++++
 crates/ibc/src/mock/context/clients.rs        | 67 ++++++++++++++
 7 files changed, 254 insertions(+), 13 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/600-tendermint-pruning.md

diff --git a/.changelog/unreleased/improvements/600-tendermint-pruning.md b/.changelog/unreleased/improvements/600-tendermint-pruning.md
new file mode 100644
index 000000000..58ced3ddb
--- /dev/null
+++ b/.changelog/unreleased/improvements/600-tendermint-pruning.md
@@ -0,0 +1 @@
+- Implement consensus state pruning for Tendermint light clients ([#600](https://github.com/cosmos/ibc-rs/issues/600))
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index 7fc11d421..b604470c2 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -29,6 +29,7 @@ use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConse
 use crate::clients::ics07_tendermint::error::Error;
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
 use crate::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
+use crate::clients::ics07_tendermint::CommonContext;
 use crate::core::ics02_client::client_state::{
     ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
 };
@@ -46,6 +47,7 @@ use crate::core::ics24_host::path::{
     ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
 };
 use crate::core::timestamp::ZERO_DURATION;
+use crate::core::ExecutionContext;
 use crate::prelude::*;
 use crate::Height;
 
@@ -488,7 +490,7 @@ where
 
 impl<E> ClientStateExecution<E> for ClientState
 where
-    E: TmExecutionContext,
+    E: TmExecutionContext + ExecutionContext,
     <E as ClientExecutionContext>::AnyClientState: From<ClientState>,
     <E as ClientExecutionContext>::AnyConsensusState: From<TmConsensusState>,
 {
@@ -498,6 +500,9 @@ where
         client_id: &ClientId,
         consensus_state: Any,
     ) -> Result<(), ClientError> {
+        let host_timestamp = CommonContext::host_timestamp(ctx)?;
+        let host_height = CommonContext::host_height(ctx)?;
+
         let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
 
         ctx.store_client_state(ClientStatePath::new(client_id), self.clone().into())?;
@@ -505,12 +510,8 @@ where
             ClientConsensusStatePath::new(client_id, &self.latest_height),
             tm_consensus_state.into(),
         )?;
-        ctx.store_update_time(
-            client_id.clone(),
-            self.latest_height(),
-            ctx.host_timestamp()?,
-        )?;
-        ctx.store_update_height(client_id.clone(), self.latest_height(), ctx.host_height()?)?;
+        ctx.store_update_time(client_id.clone(), self.latest_height(), host_timestamp)?;
+        ctx.store_update_height(client_id.clone(), self.latest_height(), host_height)?;
 
         Ok(())
     }
@@ -524,10 +525,12 @@ where
         let header = TmHeader::try_from(header)?;
         let header_height = header.height();
 
+        self.prune_oldest_consensus_state(ctx, client_id)?;
+
         let maybe_existing_consensus_state = {
             let path_at_header_height = ClientConsensusStatePath::new(client_id, &header_height);
 
-            ctx.consensus_state(&path_at_header_height).ok()
+            CommonContext::consensus_state(ctx, &path_at_header_height).ok()
         };
 
         if maybe_existing_consensus_state.is_some() {
@@ -536,6 +539,9 @@ where
             //
             // Do nothing.
         } else {
+            let host_timestamp = CommonContext::host_timestamp(ctx)?;
+            let host_height = CommonContext::host_height(ctx)?;
+
             let new_consensus_state = TmConsensusState::from(header.clone());
             let new_client_state = self.clone().with_header(header)?;
 
@@ -544,8 +550,8 @@ where
                 new_consensus_state.into(),
             )?;
             ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
-            ctx.store_update_time(client_id.clone(), header_height, ctx.host_timestamp()?)?;
-            ctx.store_update_height(client_id.clone(), header_height, ctx.host_height()?)?;
+            ctx.store_update_time(client_id.clone(), header_height, host_timestamp)?;
+            ctx.store_update_height(client_id.clone(), header_height, host_height)?;
         }
 
         Ok(vec![header_height])
@@ -615,14 +621,16 @@ where
         );
 
         let latest_height = new_client_state.latest_height;
+        let host_timestamp = CommonContext::host_timestamp(ctx)?;
+        let host_height = CommonContext::host_height(ctx)?;
 
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
         ctx.store_consensus_state(
             ClientConsensusStatePath::new(client_id, &latest_height),
             new_consensus_state.into(),
         )?;
-        ctx.store_update_time(client_id.clone(), latest_height, ctx.host_timestamp()?)?;
-        ctx.store_update_height(client_id.clone(), latest_height, ctx.host_height()?)?;
+        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
+        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
 
         Ok(latest_height)
     }
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs b/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
index 34c10e464..a2fabec1a 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
@@ -5,8 +5,10 @@ use super::{check_header_trusted_next_validator_set, ClientState};
 use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
 use crate::clients::ics07_tendermint::error::{Error, IntoResult};
 use crate::clients::ics07_tendermint::header::Header as TmHeader;
-use crate::clients::ics07_tendermint::ValidationContext as TmValidationContext;
+use crate::clients::ics07_tendermint::{CommonContext, ValidationContext as TmValidationContext};
+use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
+use crate::core::ics02_client::ClientExecutionContext;
 use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::ClientConsensusStatePath;
 use crate::prelude::*;
@@ -163,4 +165,47 @@ impl ClientState {
             }
         }
     }
+
+    pub fn prune_oldest_consensus_state<E>(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+    ) -> Result<(), ClientError>
+    where
+        E: ClientExecutionContext + CommonContext,
+    {
+        let mut heights = ctx.consensus_state_heights(client_id)?;
+
+        heights.sort();
+
+        for height in heights {
+            let client_consensus_state_path = ClientConsensusStatePath::new(client_id, &height);
+            let consensus_state =
+                CommonContext::consensus_state(ctx, &client_consensus_state_path)?;
+            let tm_consensus_state: TmConsensusState =
+                consensus_state
+                    .try_into()
+                    .map_err(|err| ClientError::Other {
+                        description: err.to_string(),
+                    })?;
+
+            let host_timestamp = ctx.host_timestamp()?;
+            let tm_consensus_state_expiry = (tm_consensus_state.timestamp() + self.trusting_period)
+                .map_err(|_| ClientError::Other {
+                    description: String::from("Timestamp overflow error occurred while attempting to parse TmConsensusState")
+                })?;
+
+            if tm_consensus_state_expiry > host_timestamp {
+                break;
+            } else {
+                let client_id = client_id.clone();
+
+                ctx.delete_consensus_state(client_consensus_state_path)?;
+                ctx.delete_update_time(client_id.clone(), height)?;
+                ctx.delete_update_height(client_id, height)?;
+            }
+        }
+
+        Ok(())
+    }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/context.rs b/crates/ibc/src/clients/ics07_tendermint/context.rs
index b98ffe644..449efa7dd 100644
--- a/crates/ibc/src/clients/ics07_tendermint/context.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/context.rs
@@ -6,6 +6,7 @@ use crate::core::ics24_host::identifier::ClientId;
 use crate::core::ics24_host::path::ClientConsensusStatePath;
 use crate::core::timestamp::Timestamp;
 use crate::core::ContextError;
+use crate::prelude::*;
 use crate::Height;
 
 /// Client's context required during both validation and execution
@@ -27,6 +28,9 @@ pub trait CommonContext {
         &self,
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<Self::AnyConsensusState, ContextError>;
+
+    /// Returns all the heights at which a consensus state is stored
+    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
 }
 
 /// Client's context required during validation
diff --git a/crates/ibc/src/core/ics02_client/context.rs b/crates/ibc/src/core/ics02_client/context.rs
index febda0799..093cdf610 100644
--- a/crates/ibc/src/core/ics02_client/context.rs
+++ b/crates/ibc/src/core/ics02_client/context.rs
@@ -53,6 +53,12 @@ pub trait ClientExecutionContext: Sized {
         consensus_state: Self::AnyConsensusState,
     ) -> Result<(), ContextError>;
 
+    /// Delete the consensus state from the store located at the given `ClientConsensusStatePath`
+    fn delete_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+    ) -> Result<(), ContextError>;
+
     /// Called upon successful client update.
     /// Implementations are expected to use this to record the specified time as the time at which
     /// this update (or header) was processed.
@@ -72,4 +78,22 @@ pub trait ClientExecutionContext: Sized {
         height: Height,
         host_height: Height,
     ) -> Result<(), ContextError>;
+
+    /// Delete the update time associated with the client at the specified height. This update
+    /// time should be associated with a consensus state through the specified height.
+    ///
+    /// Note that this timestamp is determined by the host.
+    fn delete_update_time(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError>;
+
+    /// Delete the update height associated with the client at the specified height. This update
+    /// time should be associated with a consensus state through the specified height.
+    fn delete_update_height(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError>;
 }
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index ddd7bef73..6e5773271 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -139,8 +139,10 @@ mod tests {
     use crate::core::ics02_client::handler::update_client::{execute, validate};
     use crate::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
     use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
+    use crate::core::ics02_client::ClientValidationContext;
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::{ChainId, ClientId};
+    use crate::core::ics24_host::path::ClientConsensusStatePath;
     use crate::core::timestamp::Timestamp;
     use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
     use crate::mock::context::{
@@ -180,6 +182,96 @@ mod tests {
         );
     }
 
+    /// Tests that the Tendermint client consensus state pruning logic
+    /// functions correctly.
+    ///
+    /// This test sets up a MockContext with host height 1 and a trusting
+    /// period of 3 seconds. It then advances the state of the MockContext
+    /// by 2 heights, and thus 6 seconds, due to the DEFAULT_BLOCK_TIME_SECS
+    /// constant being set to 3 seconds. At this point, the chain is at height
+    /// 3. Any consensus states associated with a block more than 3 seconds
+    /// in the past should be expired and pruned from the IBC store. The test
+    /// thus checks that the consensus state at height 1 is not contained in
+    /// the store. It also checks that the consensus state at height 2 is
+    /// contained in the store and has not expired.
+    #[test]
+    fn test_consensus_state_pruning() {
+        let chain_id = ChainId::new("mockgaiaA", 1).unwrap();
+
+        let client_height = Height::new(1, 1).unwrap();
+
+        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+        let mut ctx = MockContextConfig::builder()
+            .host_id(chain_id.clone())
+            .host_type(HostType::SyntheticTendermint)
+            .latest_height(client_height)
+            .latest_timestamp(Timestamp::now())
+            .max_history_size(u64::MAX)
+            .build()
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id.clone())
+                    .client_id(client_id.clone())
+                    .client_state_height(client_height)
+                    .client_type(tm_client_type())
+                    .trusting_period(Duration::from_secs(3))
+                    .build(),
+            );
+
+        let start_host_timestamp = ctx.host_timestamp().unwrap();
+
+        // Move the chain forward by 2 blocks to pass the trusting period.
+        for _ in 1..=2 {
+            let signer = get_dummy_account_id();
+
+            let update_height = ctx.latest_height();
+
+            ctx.advance_host_chain_height();
+
+            let mut block = ctx.host_block(&update_height).unwrap().clone();
+
+            block.set_trusted_height(client_height);
+
+            let msg = MsgUpdateClient {
+                client_id: client_id.clone(),
+                client_message: block.clone().into(),
+                signer,
+            };
+
+            let _ = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+            let _ = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
+        }
+
+        // Check that latest expired consensus state is pruned.
+        let expired_height = Height::new(1, 1).unwrap();
+        let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &expired_height);
+        assert!(ctx
+            .client_update_height(&client_id, &expired_height)
+            .is_err());
+        assert!(ctx.client_update_time(&client_id, &expired_height).is_err());
+        assert!(ctx.consensus_state(&client_cons_state_path).is_err());
+
+        // Check that latest valid consensus state exists.
+        let earliest_valid_height = Height::new(1, 2).unwrap();
+        let client_cons_state_path =
+            ClientConsensusStatePath::new(&client_id, &earliest_valid_height);
+
+        assert!(ctx
+            .client_update_height(&client_id, &earliest_valid_height)
+            .is_ok());
+        assert!(ctx
+            .client_update_time(&client_id, &earliest_valid_height)
+            .is_ok());
+        assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
+
+        let end_host_timestamp = ctx.host_timestamp().unwrap();
+        assert_eq!(
+            end_host_timestamp,
+            (start_host_timestamp + Duration::from_secs(6)).unwrap()
+        );
+    }
+
     #[test]
     fn test_update_nonexisting_client() {
         let client_id = ClientId::from_str("mockclient1").unwrap();
diff --git a/crates/ibc/src/mock/context/clients.rs b/crates/ibc/src/mock/context/clients.rs
index 14261184f..cac89cd6d 100644
--- a/crates/ibc/src/mock/context/clients.rs
+++ b/crates/ibc/src/mock/context/clients.rs
@@ -52,6 +52,21 @@ impl TmCommonContext for MockContext {
     ) -> Result<Self::AnyConsensusState, ContextError> {
         ValidationContext::consensus_state(self, client_cons_state_path)
     }
+
+    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError> {
+        let ibc_store = self.ibc_store.lock();
+        let client_record =
+            ibc_store
+                .clients
+                .get(client_id)
+                .ok_or_else(|| ClientError::ClientStateNotFound {
+                    client_id: client_id.clone(),
+                })?;
+
+        let heights = client_record.consensus_states.keys().cloned().collect();
+
+        Ok(heights)
+    }
 }
 
 impl TmValidationContext for MockContext {
@@ -214,6 +229,56 @@ impl ClientExecutionContext for MockContext {
         Ok(())
     }
 
+    fn delete_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+    ) -> Result<(), ContextError> {
+        let mut ibc_store = self.ibc_store.lock();
+
+        let client_record = ibc_store
+            .clients
+            .entry(consensus_state_path.client_id)
+            .or_insert(MockClientRecord {
+                consensus_states: Default::default(),
+                client_state: Default::default(),
+            });
+
+        let height = Height::new(consensus_state_path.epoch, consensus_state_path.height)
+            .expect("Never fails");
+
+        client_record.consensus_states.remove(&height);
+
+        Ok(())
+    }
+
+    fn delete_update_height(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError> {
+        let _ = self
+            .ibc_store
+            .lock()
+            .client_processed_heights
+            .remove(&(client_id, height));
+
+        Ok(())
+    }
+
+    fn delete_update_time(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError> {
+        let _ = self
+            .ibc_store
+            .lock()
+            .client_processed_times
+            .remove(&(client_id, height));
+
+        Ok(())
+    }
+
     fn store_update_time(
         &mut self,
         client_id: ClientId,
@@ -225,6 +290,7 @@ impl ClientExecutionContext for MockContext {
             .lock()
             .client_processed_times
             .insert((client_id, height), timestamp);
+
         Ok(())
     }
 
@@ -239,6 +305,7 @@ impl ClientExecutionContext for MockContext {
             .lock()
             .client_processed_heights
             .insert((client_id, height), host_height);
+
         Ok(())
     }
 }

From 553bc79b31b31c586128e4e533105fe917df4c0e Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 19 Oct 2023 14:24:20 -0700
Subject: [PATCH 049/182] Release v0.47.0 (#931)

* chore: v0.47.0 release

* chore: bump ibc version

* chore: update cargo.locks

* imp: update README

* fix: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 .../improvements/926_mocks_implies_std.md     |  9 -----
 .../features}/600-tendermint-pruning.md       |  0
 .../538-test-for-client-expiry.md             |  0
 ...-fix-wasm-compilation-error-with-floats.md |  0
 .../improvements/926_mocks_implies_std.md     |  3 ++
 ...commitments-and-packet-acknowledgements.md |  0
 .../improvements/929-remove-anyschema.md      |  0
 .changelog/v0.47.0/summary.md                 |  8 +++++
 CHANGELOG.md                                  | 34 ++++++++++++++++++
 README.md                                     |  8 ++++-
 ci/cw-check/Cargo.lock                        | 36 +++++++++----------
 ci/no-std-check/Cargo.lock                    |  2 +-
 crates/ibc-query/Cargo.toml                   |  4 +--
 crates/ibc/Cargo.toml                         |  4 +--
 14 files changed, 75 insertions(+), 33 deletions(-)
 delete mode 100644 .changelog/unreleased/improvements/926_mocks_implies_std.md
 rename .changelog/{unreleased/improvements => v0.47.0/features}/600-tendermint-pruning.md (100%)
 rename .changelog/{unreleased => v0.47.0}/improvements/538-test-for-client-expiry.md (100%)
 rename .changelog/{unreleased => v0.47.0}/improvements/850-fix-wasm-compilation-error-with-floats.md (100%)
 create mode 100644 .changelog/v0.47.0/improvements/926_mocks_implies_std.md
 rename .changelog/{unreleased => v0.47.0}/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md (100%)
 rename .changelog/{unreleased => v0.47.0}/improvements/929-remove-anyschema.md (100%)
 create mode 100644 .changelog/v0.47.0/summary.md

diff --git a/.changelog/unreleased/improvements/926_mocks_implies_std.md b/.changelog/unreleased/improvements/926_mocks_implies_std.md
deleted file mode 100644
index 85474a8b9..000000000
--- a/.changelog/unreleased/improvements/926_mocks_implies_std.md
+++ /dev/null
@@ -1,9 +0,0 @@
-- Change `mocks` feature to imply `std` since it requires
-  Timestamp::now to work.
-  ([\#926](https://github.com/cosmos/ibc-rs/pull/926))
-
-<!--
-    Add your entry's details here (in Markdown format).
-
-    If you don't change this message, or if this file is empty, the entry will
-    not be created. -->
diff --git a/.changelog/unreleased/improvements/600-tendermint-pruning.md b/.changelog/v0.47.0/features/600-tendermint-pruning.md
similarity index 100%
rename from .changelog/unreleased/improvements/600-tendermint-pruning.md
rename to .changelog/v0.47.0/features/600-tendermint-pruning.md
diff --git a/.changelog/unreleased/improvements/538-test-for-client-expiry.md b/.changelog/v0.47.0/improvements/538-test-for-client-expiry.md
similarity index 100%
rename from .changelog/unreleased/improvements/538-test-for-client-expiry.md
rename to .changelog/v0.47.0/improvements/538-test-for-client-expiry.md
diff --git a/.changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md b/.changelog/v0.47.0/improvements/850-fix-wasm-compilation-error-with-floats.md
similarity index 100%
rename from .changelog/unreleased/improvements/850-fix-wasm-compilation-error-with-floats.md
rename to .changelog/v0.47.0/improvements/850-fix-wasm-compilation-error-with-floats.md
diff --git a/.changelog/v0.47.0/improvements/926_mocks_implies_std.md b/.changelog/v0.47.0/improvements/926_mocks_implies_std.md
new file mode 100644
index 000000000..b7d46ac6f
--- /dev/null
+++ b/.changelog/v0.47.0/improvements/926_mocks_implies_std.md
@@ -0,0 +1,3 @@
+- Change `mocks` feature to imply `std` since it requires
+  Timestamp::now to work.
+  ([\#926](https://github.com/cosmos/ibc-rs/pull/926))
diff --git a/.changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md b/.changelog/v0.47.0/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md
similarity index 100%
rename from .changelog/unreleased/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md
rename to .changelog/v0.47.0/improvements/927-refactor-packet-commitments-and-packet-acknowledgements.md
diff --git a/.changelog/unreleased/improvements/929-remove-anyschema.md b/.changelog/v0.47.0/improvements/929-remove-anyschema.md
similarity index 100%
rename from .changelog/unreleased/improvements/929-remove-anyschema.md
rename to .changelog/v0.47.0/improvements/929-remove-anyschema.md
diff --git a/.changelog/v0.47.0/summary.md b/.changelog/v0.47.0/summary.md
new file mode 100644
index 000000000..2a621c86a
--- /dev/null
+++ b/.changelog/v0.47.0/summary.md
@@ -0,0 +1,8 @@
+This release adds necessary APIs for featuring consensus state pruning and
+implements pertaining logic for Tendermint light clients. This prevents
+unlimited store growth. Additionally, we've enhanced ibc-rs compatibility with
+no-float environments making Wasm compilation smoother and updated main
+dependencies including `prost` to v0.12, `ibc-proto-rs` to v0.37, and
+`tendermint-rs` to v0.34, ensuring the latest advancements.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index ac9eeb4e6..4b78e0da0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,39 @@
 # CHANGELOG
 
+## v0.47.0
+
+*October 19, 2023*
+
+This release adds necessary APIs for featuring consensus state pruning and
+implements pertaining logic for Tendermint light clients. This prevents
+unlimited store growth. Additionally, we've enhanced ibc-rs compatibility with
+no-float environments making Wasm compilation smoother and updated main
+dependencies including `prost` to v0.12, `ibc-proto-rs` to v0.37, and
+`tendermint-rs` to v0.34, ensuring the latest advancements.
+
+There are no consensus-breaking changes.
+
+### FEATURES
+
+- Implement consensus state pruning for Tendermint light clients. ([\#600](https://github.com/cosmos/ibc-rs/issues/600))
+
+### IMPROVEMENTS
+
+- Add test for expired client status.
+  ([\#538](https://github.com/cosmos/ibc-rs/issues/538))
+
+- Fix compilation issue with Wasm envs because of floats. ([\#850](https://github.com/cosmos/ibc-rs/issues/850))
+  - Use `serde-json-wasm` dependency instead of `serde-json` for no-floats support
+  - Add CI test to include CosmWasm compilation check
+
+- Change `mocks` feature to imply `std` since it requires
+  Timestamp::now to work.
+  ([\#926](https://github.com/cosmos/ibc-rs/pull/926))
+- Return PacketStates instead of paths from packet_commitments and
+  packet_acknowledgements. ([\#927](https://github.com/cosmos/ibc-rs/issues/927))
+- Remove `AnySchema` as `JsonSchema` derive on `Any` now accessible through
+  `ibc-proto-rs`. ([#929](https://github.com/cosmos/ibc-rs/issues/929))
+
 ## v0.46.0
 
 *October 12, 2023*
diff --git a/README.md b/README.md
index 9b4ed00a8..2654f16d5 100644
--- a/README.md
+++ b/README.md
@@ -26,7 +26,13 @@
 Rust implementation of the Inter-Blockchain Communication (IBC) protocol. This project hosts
 the `ibc` rust crate which defines the main data structures and on-chain logic for the IBC protocol.
 
-See the [ibc](crates/ibc/README.md) crate's README.md for more detailed information on the `ibc` crate.
+## Libraries
+
+- [ibc](crates/ibc/README.md) - Data structures and on-chain logic for the IBC protocol.
+- [ibc-query](crates/ibc-query/README.md) - Utility traits and implementations for querying the
+state of an `ibc-rs` enabled chain.
+- [ibc-derive](crates/ibc-derive/README.md) - Derive macros for `ClientState`
+  and `ConsensusState` traits, reducing boilerplate.
 
 ## Contributing
 
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index b72af99c7..153b91f8f 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -613,7 +613,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.45.0"
+version = "0.47.0"
 dependencies = [
  "bytes",
  "derive_more",
@@ -651,9 +651,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.35.0"
+version = "0.37.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "459ccbab879b749bf500ae13244593fa16fc64c1b3159f6b0753c169625a1e23"
+checksum = "63042806bb2f662ca1c68026231900cfe13361136ddfd0dd09bcb315056a22b8"
 dependencies = [
  "base64 0.21.2",
  "bytes",
@@ -669,9 +669,9 @@ dependencies = [
 
 [[package]]
 name = "ics23"
-version = "0.10.2"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "442d4bab37956e76f739c864f246c825d87c0bb7f9afa65660c57833c91bf6d4"
+checksum = "661e2d6f79952a65bc92b1c81f639ebd37228dae6ff412a5aba7d474bdc4b957"
 dependencies = [
  "anyhow",
  "bytes",
@@ -904,9 +904,9 @@ dependencies = [
 
 [[package]]
 name = "prost"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b82eaa1d779e9a4bc1c3217db8ffbeabaae1dca241bf70183242128d48681cd"
+checksum = "f4fdd22f3b9c31b53c060df4a0613a1c7f062d4115a2b984dd15b1858f7e340d"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -914,22 +914,22 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e5d2d8d10f3c6ded6da8b05b5fb3b8a5082514344d56c9f871412d29b4e075b4"
+checksum = "265baba7fabd416cf5078179f7d2cbeca4ce7a9041111900675ea7c4cb8a4c32"
 dependencies = [
  "anyhow",
  "itertools",
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.28",
 ]
 
 [[package]]
 name = "prost-types"
-version = "0.11.9"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "213622a1460818959ac1181aaeb2dc9c7f63df720db7d788b3e24eacd1983e13"
+checksum = "e081b29f63d83a4bc75cfc9f3fe424f9156cf92d8a4f0c9407cce9a1b67327cf"
 dependencies = [
  "prost",
 ]
@@ -1253,9 +1253,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint"
-version = "0.33.2"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7c35fe4fd24a7715571814c22416dbc40ec0f2a6e3cce75d73e19699faecd246"
+checksum = "bc2294fa667c8b548ee27a9ba59115472d0a09c2ba255771092a7f1dcf03a789"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -1282,9 +1282,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.33.2"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "680639f67d51eceb700bff18b45b584373ec94ee0d7ffe61f4ca6c54ed7787ff"
+checksum = "74994da9de4b1144837a367ca2c60c650f5526a7c1a54760a3020959b522e474"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -1295,9 +1295,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.33.2"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "639e5adffd77220d238a800a72c74c98d7e869290a6e4494c10b6b4e8f702f02"
+checksum = "2cc728a4f9e891d71adf66af6ecaece146f9c7a11312288a3107b3e1d6979aaf"
 dependencies = [
  "bytes",
  "flex-error",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index ab6f65baf..73605b5f5 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1064,7 +1064,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.46.0"
+version = "0.47.0"
 dependencies = [
  "bytes",
  "derive_more",
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
index 101934f1f..6a73318c3 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/crates/ibc-query/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc-query"
-version      = "0.46.0"
+version      = "0.47.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -18,7 +18,7 @@ default = ["std"]
 std = ["ibc-proto/std", "ibc/std"]
 
 [dependencies]
-ibc = { version = "0.46.0", path = "../ibc", default-features = false }
+ibc = { version = "0.47.0", path = "../ibc", default-features = false }
 ibc-proto = { version = "0.37.1", default-features = false, features = ["server"] }
 displaydoc = { version = "0.2", default-features = false }
 tonic = "0.10"
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index aca555c97..ae4d4d56b 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name         = "ibc"
-version      = "0.46.0"
+version      = "0.47.0"
 edition      = "2021"
 license      = "Apache-2.0"
 readme       = "README.md"
@@ -52,7 +52,7 @@ mocks = ["tendermint-testgen", "parking_lot", "typed-builder", "std"]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
 ibc-proto = { version = "0.37.1", default-features = false }
 ics23 = { version = "0.11", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.30", default-features = false }
+time = { version = ">=0.3.0, <0.3.31", default-features = false }
 serde_derive = { version = "1.0.104", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false, optional = true}

From 599644cf54385bb84b83f78cfb1e0e9acdde7786 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Thu, 2 Nov 2023 16:56:28 +0100
Subject: [PATCH 050/182] feat: add From derive for ICS26 messages (#938)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add derive_more::From to MsgEnvelope and encapsulated enums so that
it’s easier to construct those objects without having to spell out
their names or variants.
---
 .changelog/unreleased/improvements/938-add-from.md | 2 ++
 crates/ibc/src/core/ics02_client/msgs.rs           | 2 +-
 crates/ibc/src/core/ics03_connection/msgs.rs       | 2 +-
 crates/ibc/src/core/ics04_channel/msgs.rs          | 4 ++--
 crates/ibc/src/core/msgs.rs                        | 2 +-
 5 files changed, 7 insertions(+), 5 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/938-add-from.md

diff --git a/.changelog/unreleased/improvements/938-add-from.md b/.changelog/unreleased/improvements/938-add-from.md
new file mode 100644
index 000000000..439e48b6c
--- /dev/null
+++ b/.changelog/unreleased/improvements/938-add-from.md
@@ -0,0 +1,2 @@
+- Add From implementation for ICS26 enum types to make it simpler
+  to construct the types.  ([\#938](https://github.com/cosmos/ibc-rs/pull/938))
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/crates/ibc/src/core/ics02_client/msgs.rs
index 221adbe3c..22140248f 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/crates/ibc/src/core/ics02_client/msgs.rs
@@ -21,7 +21,7 @@ pub mod upgrade_client;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub enum ClientMsg {
     CreateClient(MsgCreateClient),
     UpdateClient(MsgUpdateClient),
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/crates/ibc/src/core/ics03_connection/msgs.rs
index 04b3da330..0de5e6153 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs.rs
@@ -29,7 +29,7 @@ pub mod conn_open_try;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub enum ConnectionMsg {
     OpenInit(MsgConnectionOpenInit),
     OpenTry(MsgConnectionOpenTry),
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index 3757f2c5f..392a0c988 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -36,7 +36,7 @@ use crate::core::ics24_host::identifier::PortId;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub enum ChannelMsg {
     OpenInit(MsgChannelOpenInit),
     OpenTry(MsgChannelOpenTry),
@@ -52,7 +52,7 @@ pub enum ChannelMsg {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub enum PacketMsg {
     Recv(MsgRecvPacket),
     Ack(MsgAcknowledgement),
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index bc3642d29..311b7ad71 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -40,7 +40,7 @@ pub trait Msg: Clone {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub enum MsgEnvelope {
     Client(ClientMsg),
     Connection(ConnectionMsg),

From ccca3ffeda2406af6c43558ebde84c2bc1d62ef9 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Thu, 2 Nov 2023 20:08:29 +0100
Subject: [PATCH 051/182] perf: avoid temporary Vec allocations when computing
 commitments (#939)

* perf: avoid temporary Vec allocations when computing commitments

* review

* Update crates/ibc/src/core/ics04_channel/commitment.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* Update crates/ibc/src/core/ics04_channel/commitment.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* Update crates/ibc/src/core/ics04_channel/commitment.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* review

* Update .changelog/unreleased/improvements/939-less-alloc.md

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

---------

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
---
 .../unreleased/improvements/939-less-alloc.md |  2 +
 .../ibc/src/core/ics04_channel/commitment.rs  | 54 ++++++++++++++-----
 2 files changed, 43 insertions(+), 13 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/939-less-alloc.md

diff --git a/.changelog/unreleased/improvements/939-less-alloc.md b/.changelog/unreleased/improvements/939-less-alloc.md
new file mode 100644
index 000000000..b7ed133f9
--- /dev/null
+++ b/.changelog/unreleased/improvements/939-less-alloc.md
@@ -0,0 +1,2 @@
+- Reduce vector allocations in Commitment computation. 
+  ([\#939](https://github.com/cosmos/ibc-rs/pull/939))
diff --git a/crates/ibc/src/core/ics04_channel/commitment.rs b/crates/ibc/src/core/ics04_channel/commitment.rs
index c2979e910..8903f310a 100644
--- a/crates/ibc/src/core/ics04_channel/commitment.rs
+++ b/crates/ibc/src/core/ics04_channel/commitment.rs
@@ -86,31 +86,59 @@ pub(crate) fn compute_packet_commitment(
     timeout_height: &TimeoutHeight,
     timeout_timestamp: &Timestamp,
 ) -> PacketCommitment {
-    let mut hash_input = timeout_timestamp.nanoseconds().to_be_bytes().to_vec();
+    let mut hash_input = [0; 8 * 3 + 32];
 
-    let revision_number = timeout_height.commitment_revision_number().to_be_bytes();
-    hash_input.append(&mut revision_number.to_vec());
+    hash_input[..8].copy_from_slice(&timeout_timestamp.nanoseconds().to_be_bytes());
+    hash_input[8..16].copy_from_slice(&timeout_height.commitment_revision_number().to_be_bytes());
+    hash_input[16..24].copy_from_slice(&timeout_height.commitment_revision_height().to_be_bytes());
+    hash_input[24..].copy_from_slice(&hash(packet_data));
 
-    let revision_height = timeout_height.commitment_revision_height().to_be_bytes();
-    hash_input.append(&mut revision_height.to_vec());
-
-    let packet_data_hash = hash(packet_data);
-    hash_input.append(&mut packet_data_hash.to_vec());
-
-    hash(&hash_input).into()
+    hash(&hash_input).to_vec().into()
 }
 
 /// Compute the commitment for an acknowledgement.
 pub(crate) fn compute_ack_commitment(ack: &Acknowledgement) -> AcknowledgementCommitment {
-    hash(ack.as_ref()).into()
+    hash(ack.as_ref()).to_vec().into()
 }
 
 /// Helper function to hash a byte slice using SHA256.
 ///
 /// Note that computing commitments with anything other than SHA256 will
 /// break the Merkle proofs of the IBC provable store.
-fn hash(data: impl AsRef<[u8]>) -> Vec<u8> {
+fn hash(data: &[u8]) -> [u8; 32] {
     use sha2::Digest;
 
-    sha2::Sha256::digest(&data).to_vec()
+    sha2::Sha256::digest(data).into()
+}
+
+#[cfg(test)]
+mod test {
+    use super::*;
+
+    #[test]
+    fn test_compute_packet_commitment() {
+        let expected: [u8; 32] = [
+            0xa9, 0x28, 0xb5, 0x1f, 0x62, 0xbd, 0x54, 0x00, 0x91, 0xec, 0x45, 0x1f, 0x4e, 0xf3,
+            0x45, 0x79, 0x4f, 0x05, 0x9e, 0x65, 0x91, 0x08, 0x16, 0x86, 0x61, 0x26, 0xdc, 0x36,
+            0x4f, 0x84, 0xcc, 0x15,
+        ];
+        let actual = compute_packet_commitment(
+            "packet data".as_bytes(),
+            &TimeoutHeight::At(crate::Height::new(42, 24).unwrap()),
+            &Timestamp::from_nanoseconds(0x42).unwrap(),
+        );
+        assert_eq!(&expected[..], actual.as_ref());
+    }
+
+    #[test]
+    fn test_compute_ack_commitment() {
+        let expected: [u8; 32] = [
+            0x05, 0x4e, 0xde, 0xc1, 0xd0, 0x21, 0x1f, 0x62, 0x4f, 0xed, 0x0c, 0xbc, 0xa9, 0xd4,
+            0xf9, 0x40, 0x0b, 0x0e, 0x49, 0x1c, 0x43, 0x74, 0x2a, 0xf2, 0xc5, 0xb0, 0xab, 0xeb,
+            0xf0, 0xc9, 0x90, 0xd8,
+        ];
+        let ack = Acknowledgement::try_from(vec![0, 1, 2, 3]).unwrap();
+        let actual = compute_ack_commitment(&ack);
+        assert_eq!(&expected[..], actual.as_ref())
+    }
 }

From 1ec4b8ca4df85175acb75189c8d47bc8d0ba7178 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Mon, 6 Nov 2023 13:47:39 -0500
Subject: [PATCH 052/182] fix: support chain identifiers without
 `{chain_name}-{revision_number}` pattern (#941)

* optional revision number for chain id

* add additional methods

* update tests

* add changelog entry

* new test for codecov

* revert optional u64

* rename method

* update tests

* visualize actual testcases

* revert method rename

* update changelog entry

* refactor ChainId::new

* rm ChainId::has_revision_number method

* refactor ChainId::set_revision_number to ChainId::increment_revision_number

* rm old set unset revision_number test

* add tests for ChainId::increment_revision_number

* add length validation tests

* refactor source code for ChainId::new

* fix doc test

* fix chain identifier length validation

* update tests

* fix typo

* reword changelog entry

* reword doc string

* fix ChainId::validate_length

* add ChainId::validate_length in tests

* replace ID with identifier

* use validate_prefix_length over validate_identifier_length

* optimize validate_prefix_length

* rename changelog entry

* fix incorrect doc comment

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* use u64::checked_add

* update doc comment

* update doc tests

* simplify validate_prefix_length

* tests for validate_prefix_length

* fix tests

* add changelog entry

* import test_log::test

* fix rstest test attribute

* cargo fmt

* fix typo

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 ...tifiers-without-revision-number-pattern.md |   2 +
 .../943-optimize-validate-prefix-length.md    |   2 +
 .../clients/ics07_tendermint/client_state.rs  |  12 +-
 .../ics02_client/handler/update_client.rs     |  42 +--
 .../ics03_connection/handler/conn_open_ack.rs |   2 +-
 .../ics03_connection/handler/conn_open_try.rs |   2 +-
 crates/ibc/src/core/ics24_host/identifier.rs  | 252 ++++++++++++------
 .../core/ics24_host/identifier/validate.rs    |  53 +++-
 crates/ibc/src/mock/context.rs                |   4 +-
 crates/ibc/src/mock/ics18_relayer/context.rs  |   4 +-
 10 files changed, 256 insertions(+), 119 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md
 create mode 100644 .changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md

diff --git a/.changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md b/.changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md
new file mode 100644
index 000000000..c127a0c66
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md
@@ -0,0 +1,2 @@
+- Support chain identifiers without the `{chain_name}-{revision_number}` pattern
+  of Tendermint chains. ([\#940](https://github.com/cosmos/ibc-rs/issues/940)).
diff --git a/.changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md b/.changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md
new file mode 100644
index 000000000..0e2c11c19
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md
@@ -0,0 +1,2 @@
+- Remove redundant `String` creation in `validate_prefix_length`
+  ([\#943](https://github.com/cosmos/ibc-rs/issues/943)).
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index b604470c2..825a467d7 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -827,7 +827,7 @@ mod tests {
     fn client_state_new() {
         // Define a "default" set of parameters to reuse throughout these tests.
         let default_params: ClientStateParams = ClientStateParams {
-            id: ChainId::new("ibc", 0).unwrap(),
+            id: ChainId::new("ibc-0").unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
             unbonding_period: Duration::new(128000, 0),
@@ -870,9 +870,9 @@ mod tests {
                 want_pass: true,
             },
             Test {
-                name: "Valid long (50 chars) chain-id that satisfies revision_number length < `u16::MAX` length".to_string(),
+                name: "Valid long (50 chars) chain-id that satisfies revision_number length < `u64::MAX` length".to_string(),
                 params: ClientStateParams {
-                    id: ChainId::new(&"a".repeat(29), 0).unwrap(),
+                    id: ChainId::new(&format!("{}-{}", "a".repeat(29), 0)).unwrap(),
                     ..default_params.clone()
                 },
                 want_pass: true,
@@ -880,7 +880,7 @@ mod tests {
             Test {
                 name: "Invalid too-long (51 chars) chain-id".to_string(),
                 params: ClientStateParams {
-                    id: ChainId::new(&"a".repeat(30), 0).unwrap(),
+                    id: ChainId::new(&format!("{}-{}", "a".repeat(30), 0)).unwrap(),
                     ..default_params.clone()
                 },
                 want_pass: false,
@@ -993,7 +993,7 @@ mod tests {
     fn client_state_verify_height() {
         // Define a "default" set of parameters to reuse throughout these tests.
         let default_params: ClientStateParams = ClientStateParams {
-            id: ChainId::new("ibc", 1).unwrap(),
+            id: ChainId::new("ibc-1").unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
             unbonding_period: Duration::new(128000, 0),
@@ -1173,7 +1173,7 @@ pub mod test_util {
     pub fn get_dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
         #[allow(deprecated)]
         RawTmClientState {
-            chain_id: ChainId::new("ibc", 0).expect("Never fails").to_string(),
+            chain_id: ChainId::new("ibc-0").expect("Never fails").to_string(),
             trust_level: Some(Fraction {
                 numerator: 1,
                 denominator: 3,
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 6e5773271..47e4cdd60 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -196,7 +196,7 @@ mod tests {
     /// contained in the store and has not expired.
     #[test]
     fn test_consensus_state_pruning() {
-        let chain_id = ChainId::new("mockgaiaA", 1).unwrap();
+        let chain_id = ChainId::new("mockgaiaA-1").unwrap();
 
         let client_height = Height::new(1, 1).unwrap();
 
@@ -295,10 +295,10 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
+            ChainId::new("mockgaiaA-1").unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -343,10 +343,10 @@ mod tests {
     fn test_update_synthetic_tendermint_client_validator_change_ok() {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let mut ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .host_id(ChainId::new("mockgaiaA-1").unwrap())
             .latest_height(Height::new(1, 1).unwrap())
             .build()
             .with_client_config(
@@ -435,10 +435,10 @@ mod tests {
     fn test_update_synthetic_tendermint_client_validator_change_fail() {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .host_id(ChainId::new("mockgaiaA-1").unwrap())
             .latest_height(Height::new(1, 1).unwrap())
             .build()
             .with_client_config(
@@ -515,10 +515,10 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
+            ChainId::new("mockgaiaA-1").unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -565,8 +565,8 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
 
-        let ctx_a_chain_id = ChainId::new("mockgaiaA", 1).unwrap();
-        let ctx_b_chain_id = ChainId::new("mockgaiaB", 1).unwrap();
+        let ctx_a_chain_id = ChainId::new("mockgaiaA-1").unwrap();
+        let ctx_b_chain_id = ChainId::new("mockgaiaB-1").unwrap();
         let start_height = Height::new(1, 11).unwrap();
 
         let mut ctx_a = MockContext::new(ctx_a_chain_id, HostType::Mock, 5, start_height)
@@ -695,7 +695,7 @@ mod tests {
         let chain_start_height = Height::new(1, 11).unwrap();
 
         let ctx = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
+            ChainId::new("mockgaiaA-1").unwrap(),
             HostType::Mock,
             5,
             chain_start_height,
@@ -708,7 +708,7 @@ mod tests {
         );
 
         let ctx_b = MockContext::new(
-            ChainId::new("mockgaiaB", 1).unwrap(),
+            ChainId::new("mockgaiaB-1").unwrap(),
             HostType::SyntheticTendermint,
             5,
             client_height,
@@ -835,11 +835,11 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
         let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
+            ChainId::new("mockgaiaA-1").unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -896,11 +896,11 @@ mod tests {
         let client_id = ClientId::new(tm_client_type(), 0).unwrap();
         let client_height = Height::new(1, 20).unwrap();
         let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
         let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA", 1).unwrap(),
+            ChainId::new("mockgaiaA-1").unwrap(),
             HostType::Mock,
             5,
             Height::new(1, 1).unwrap(),
@@ -955,7 +955,7 @@ mod tests {
 
     #[test]
     fn test_expired_client() {
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let update_height = Height::new(1, 21).unwrap();
         let client_height = update_height.sub(3).unwrap();
@@ -967,7 +967,7 @@ mod tests {
         let trusting_period = Duration::from_secs(64);
 
         let mut ctx = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .host_id(ChainId::new("mockgaiaA-1").unwrap())
             .latest_height(Height::new(1, 1).unwrap())
             .latest_timestamp(timestamp)
             .build()
@@ -995,7 +995,7 @@ mod tests {
 
     #[test]
     fn test_client_update_max_clock_drift() {
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         let client_height = Height::new(1, 20).unwrap();
 
@@ -1006,7 +1006,7 @@ mod tests {
         let max_clock_drift = Duration::from_secs(64);
 
         let ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA", 1).unwrap())
+            .host_id(ChainId::new("mockgaiaA-1").unwrap())
             .latest_height(Height::new(1, 1).unwrap())
             .latest_timestamp(timestamp)
             .build()
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index e8913c465..efb7a9bf4 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -261,7 +261,7 @@ mod tests {
 
         let ctx_default = MockContext::default();
         let ctx_new = MockContext::new(
-            ChainId::new("mockgaia", latest_height.revision_number()).unwrap(),
+            ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap(),
             HostType::Mock,
             max_history_size,
             latest_height,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 93f3f6612..953fe5bb9 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -257,7 +257,7 @@ mod tests {
         };
 
         let ctx_new = MockContext::new(
-            ChainId::new("mockgaia", 0).unwrap(),
+            ChainId::new("mockgaia-0").unwrap(),
             HostType::Mock,
             max_history_size,
             host_chain_height,
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index 4d28f65c1..a822d5715 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -47,29 +47,31 @@ pub struct ChainId {
 }
 
 impl ChainId {
-    /// Creates a new `ChainId` with the given chain name and revision number.
+    /// Creates a new `ChainId` with the given chain identifier.
     ///
-    /// It checks the chain name for valid characters according to `ICS-24`
-    /// specification and returns a `ChainId` in the the format of {chain
-    /// name}-{revision number}. Stricter checks beyond `ICS-24` rests with
-    /// the users, based on their requirements.
+    /// It checks the identifier for valid characters according to `ICS-24`
+    /// specification and returns a `ChainId` successfully.
+    /// Stricter checks beyond `ICS-24` rests with the users,
+    /// based on their requirements.
+    ///
+    /// If the chain identifier is in the {chain name}-{revision number} format,
+    /// the revision number is parsed. Otherwise, revision number is set to 0.
     ///
     /// ```
     /// use ibc::core::ics24_host::identifier::ChainId;
     ///
-    /// let revision_number = 10;
-    /// let id = ChainId::new("chainA", revision_number).unwrap();
-    /// assert_eq!(id.revision_number(), revision_number);
+    /// let chain_id = "chainA";
+    /// let id = ChainId::new(chain_id).unwrap();
+    /// assert_eq!(id.revision_number(), 0);
+    /// assert_eq!(id.as_str(), chain_id);
+    ///
+    /// let chain_id = "chainA-12";
+    /// let id = ChainId::new(chain_id).unwrap();
+    /// assert_eq!(id.revision_number(), 12);
+    /// assert_eq!(id.as_str(), chain_id);
     /// ```
-    pub fn new(name: &str, revision_number: u64) -> Result<Self, IdentifierError> {
-        let prefix = name.trim();
-        validate_identifier_chars(prefix)?;
-        validate_identifier_length(prefix, 1, 43)?;
-        let id = format!("{prefix}-{revision_number}");
-        Ok(Self {
-            id,
-            revision_number,
-        })
+    pub fn new(chain_id: &str) -> Result<Self, IdentifierError> {
+        Self::from_str(chain_id)
     }
 
     /// Get a reference to the underlying string.
@@ -77,14 +79,8 @@ impl ChainId {
         &self.id
     }
 
-    pub fn split_chain_id(&self) -> (&str, u64) {
+    pub fn split_chain_id(&self) -> Result<(&str, u64), IdentifierError> {
         parse_chain_id_string(self.as_str())
-            .expect("never fails because a valid chain identifier is parsed")
-    }
-
-    /// Extract the chain name from the chain identifier
-    pub fn chain_name(&self) -> &str {
-        self.split_chain_id().0
     }
 
     /// Extract the revision number from the chain identifier
@@ -92,24 +88,41 @@ impl ChainId {
         self.revision_number
     }
 
-    /// Swaps `ChainId`s revision number with the new specified revision number
+    /// Increases `ChainId`s revision number by one.
+    /// Fails if the chain identifier is not in
+    /// `{chain_name}-{revision_number}` format or
+    /// the revision number overflows.
+    ///
     /// ```
     /// use ibc::core::ics24_host::identifier::ChainId;
-    /// let mut chain_id = ChainId::new("chainA", 1).unwrap();
-    /// chain_id.set_revision_number(2);
+    ///
+    /// let mut chain_id = ChainId::new("chainA-1").unwrap();
+    /// assert!(chain_id.increment_revision_number().is_ok());
     /// assert_eq!(chain_id.revision_number(), 2);
+    ///
+    /// let mut chain_id = ChainId::new(&format!("chainA-{}", u64::MAX)).unwrap();
+    /// assert!(chain_id.increment_revision_number().is_err());
+    /// assert_eq!(chain_id.revision_number(), u64::MAX);
     /// ```
-    pub fn set_revision_number(&mut self, revision_number: u64) {
-        let chain_name = self.chain_name();
-        self.id = format!("{}-{}", chain_name, revision_number);
-        self.revision_number = revision_number;
+    pub fn increment_revision_number(&mut self) -> Result<(), IdentifierError> {
+        let (chain_name, _) = self.split_chain_id()?;
+        let inc_revision_number = self
+            .revision_number
+            .checked_add(1)
+            .ok_or(IdentifierError::RevisionNumberOverflow)?;
+        self.id = format!("{}-{}", chain_name, inc_revision_number);
+        self.revision_number = inc_revision_number;
+        Ok(())
     }
 
     /// A convenient method to check if the `ChainId` forms a valid identifier
     /// with the desired min/max length. However, ICS-24 does not specify a
     /// certain min or max lengths for chain identifiers.
     pub fn validate_length(&self, min_length: u64, max_length: u64) -> Result<(), IdentifierError> {
-        validate_prefix_length(self.chain_name(), min_length, max_length)
+        match self.split_chain_id() {
+            Ok((chain_name, _)) => validate_prefix_length(chain_name, min_length, max_length),
+            _ => validate_identifier_length(&self.id, min_length, max_length),
+        }
     }
 }
 
@@ -119,11 +132,29 @@ impl FromStr for ChainId {
     type Err = IdentifierError;
 
     fn from_str(id: &str) -> Result<Self, Self::Err> {
-        let (_, revision_number) = parse_chain_id_string(id)?;
-        Ok(Self {
-            id: id.to_string(),
-            revision_number,
-        })
+        // Identifier string must have a maximum length of 64 characters.
+
+        // Validates the chain name for allowed characters according to ICS-24.
+        validate_identifier_chars(id)?;
+        match parse_chain_id_string(id) {
+            Ok((chain_name, revision_number)) => {
+                // Validate if the chain name with revision number has a valid length.
+                validate_prefix_length(chain_name, 1, 64)?;
+                Ok(Self {
+                    id: id.into(),
+                    revision_number,
+                })
+            }
+
+            _ => {
+                // Validate if the identifier has a valid length.
+                validate_identifier_length(id, 1, 64)?;
+                Ok(Self {
+                    id: id.into(),
+                    revision_number: 0,
+                })
+            }
+        }
     }
 }
 
@@ -136,34 +167,23 @@ impl Display for ChainId {
 /// Parses a string intended to represent a `ChainId` and, if successful,
 /// returns a tuple containing the chain name and revision number.
 fn parse_chain_id_string(chain_id_str: &str) -> Result<(&str, u64), IdentifierError> {
-    let (name, rev_number_str) = match chain_id_str.rsplit_once('-') {
-        Some((name, rev_number_str)) => (name, rev_number_str),
-        None => {
-            return Err(IdentifierError::InvalidCharacter {
-                id: chain_id_str.to_string(),
-            })
-        }
-    };
-
-    // Validates the chain name for allowed characters according to ICS-24.
-    validate_identifier_chars(name)?;
-
-    // Validates the revision number not to start with leading zeros, like "01".
-    if rev_number_str.as_bytes().first() == Some(&b'0') && rev_number_str.len() > 1 {
-        return Err(IdentifierError::InvalidCharacter {
-            id: chain_id_str.to_string(),
-        });
-    }
-
-    // Parses the revision number string into a `u64` and checks its validity.
-    let revision_number =
-        rev_number_str
-            .parse()
-            .map_err(|_| IdentifierError::InvalidCharacter {
-                id: chain_id_str.to_string(),
-            })?;
-
-    Ok((name, revision_number))
+    chain_id_str
+        .rsplit_once('-')
+        .filter(|(_, rev_number_str)| {
+            // Validates the revision number not to start with leading zeros, like "01".
+            // Zero is the only allowed revision number with leading zero.
+            rev_number_str.as_bytes().first() != Some(&b'0') || rev_number_str.len() == 1
+        })
+        .and_then(|(chain_name, rev_number_str)| {
+            // Parses the revision number string into a `u64` and checks its validity.
+            rev_number_str
+                .parse()
+                .ok()
+                .map(|revision_number| (chain_name, revision_number))
+        })
+        .ok_or(IdentifierError::UnformattedRevisionNumber {
+            chain_id: chain_id_str.to_string(),
+        })
 }
 
 #[cfg_attr(
@@ -509,6 +529,10 @@ pub enum IdentifierError {
     InvalidCharacter { id: String },
     /// identifier prefix `{prefix}` is invalid
     InvalidPrefix { prefix: String },
+    /// chain identifier is not formatted with revision number
+    UnformattedRevisionNumber { chain_id: String },
+    /// revision number overflowed
+    RevisionNumberOverflow,
     /// identifier cannot be empty
     Empty,
 }
@@ -518,27 +542,95 @@ impl std::error::Error for IdentifierError {}
 
 #[cfg(test)]
 mod tests {
+    use rstest::rstest;
 
     use super::*;
 
+    #[rstest]
+    #[case("chainA-0", "chainA", 0)]
+    #[case("chainA-1", "chainA", 1)]
+    #[case("chainA--1", "chainA-", 1)]
+    #[case("chainA-1-2", "chainA-1", 2)]
+    #[case("111-2", "111", 2)]
+    #[case("----1", "---", 1)]
+    #[case("._+-1", "._+", 1)]
+    #[case(&("A".repeat(43) + "-3"), &("A".repeat(43)), 3)]
+    fn test_valid_chain_id_with_rev(
+        #[case] raw_chain_id: &str,
+        #[case] chain_name: &str,
+        #[case] revision_number: u64,
+    ) {
+        let chain_id = ChainId::new(raw_chain_id).unwrap();
+        assert!(chain_id.validate_length(1, 64).is_ok());
+        assert_eq!(
+            chain_id,
+            ChainId {
+                id: format!("{chain_name}-{revision_number}"),
+                revision_number
+            }
+        );
+    }
+
+    #[rstest]
+    #[case("chainA")]
+    #[case("chainA.2")]
+    #[case("123")]
+    #[case("._+")]
+    #[case("chainA-")]
+    #[case("chainA-a")]
+    #[case("chainA-01")]
+    #[case("chainA-1-")]
+    #[case(&"A".repeat(64))]
+    #[case::special_case("chainA-0")]
+    fn test_valid_chain_id_without_rev(#[case] chain_name: &str) {
+        let chain_id = ChainId::new(chain_name).unwrap();
+        assert!(chain_id.validate_length(1, 64).is_ok());
+        assert_eq!(
+            chain_id,
+            ChainId {
+                id: chain_name.into(),
+                revision_number: 0
+            }
+        );
+    }
+
+    #[rstest]
+    #[case(&"A".repeat(65))]
+    #[case(&("A".repeat(44) + "-123"))]
+    #[case("-1")]
+    #[case(" ----1")]
+    #[case(" ")]
+    #[case(" chainA")]
+    #[case("chain A")]
+    #[case(" chainA.2")]
+    #[case(" chainA.2-1")]
+    #[case(" 1")]
+    #[case(" -")]
+    #[case("   -1")]
+    #[case("/chainA-1")]
+    fn test_invalid_chain_id(#[case] chain_id_str: &str) {
+        assert!(ChainId::new(chain_id_str).is_err());
+    }
+
     #[test]
-    fn test_valid_chain_id() {
-        assert!(ChainId::from_str("chainA-0").is_ok());
-        assert!(ChainId::from_str("chainA-1").is_ok());
-        assert!(ChainId::from_str("chainA--1").is_ok());
-        assert!(ChainId::from_str("chainA-1-2").is_ok());
+    fn test_inc_revision_number() {
+        let mut chain_id = ChainId::new("chainA-1").unwrap();
+
+        assert!(chain_id.increment_revision_number().is_ok());
+        assert_eq!(chain_id.revision_number(), 2);
+        assert_eq!(chain_id.as_str(), "chainA-2");
+
+        assert!(chain_id.increment_revision_number().is_ok());
+        assert_eq!(chain_id.revision_number(), 3);
+        assert_eq!(chain_id.as_str(), "chainA-3");
     }
 
     #[test]
-    fn test_invalid_chain_id() {
-        assert!(ChainId::from_str("1").is_err());
-        assert!(ChainId::from_str("-1").is_err());
-        assert!(ChainId::from_str("   -1").is_err());
-        assert!(ChainId::from_str("chainA").is_err());
-        assert!(ChainId::from_str("chainA-").is_err());
-        assert!(ChainId::from_str("chainA-a").is_err());
-        assert!(ChainId::from_str("chainA-01").is_err());
-        assert!(ChainId::from_str("/chainA-1").is_err());
-        assert!(ChainId::from_str("chainA-1-").is_err());
+    fn test_failed_inc_revision_number() {
+        let mut chain_id = ChainId::new("chainA").unwrap();
+
+        assert!(chain_id.increment_revision_number().is_err());
+        assert_eq!(chain_id.revision_number(), 0);
+        assert_eq!(chain_id.as_str(), "chainA");
     }
 }
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/crates/ibc/src/core/ics24_host/identifier/validate.rs
index 8123aeb3e..7e0f2acf3 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/crates/ibc/src/core/ics24_host/identifier/validate.rs
@@ -61,18 +61,39 @@ pub fn validate_prefix_length(
     min_id_length: u64,
     max_id_length: u64,
 ) -> Result<(), Error> {
+    assert!(max_id_length >= min_id_length);
+
+    if prefix.is_empty() {
+        return Err(Error::InvalidPrefix {
+            prefix: prefix.into(),
+        });
+    }
+
+    // Statically checks if the prefix forms a valid identifier length when constructed with `u64::MAX`
+    // len(prefix + '-' + u64::MAX) <= max_id_length (minimum prefix length is 1)
+    if max_id_length < 22 {
+        return Err(Error::InvalidLength {
+            id: prefix.into(),
+            length: prefix.len() as u64,
+            min: 0,
+            max: 0,
+        });
+    }
+
     // Checks if the prefix forms a valid identifier length when constructed with `u64::MIN`
+    // len('-' + u64::MIN) = 2
     validate_identifier_length(
-        &format!("{prefix}-{}", u64::MIN),
-        min_id_length,
-        max_id_length,
+        prefix,
+        min_id_length.saturating_sub(2),
+        max_id_length.saturating_sub(2),
     )?;
 
     // Checks if the prefix forms a valid identifier length when constructed with `u64::MAX`
+    // len('-' + u64::MAX) = 21
     validate_identifier_length(
-        &format!("{prefix}-{}", u64::MAX),
-        min_id_length,
-        max_id_length,
+        prefix,
+        min_id_length.saturating_sub(21),
+        max_id_length.saturating_sub(21),
     )?;
 
     Ok(())
@@ -122,6 +143,7 @@ pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
 
 #[cfg(test)]
 mod tests {
+    use rstest::rstest;
     use test_log::test;
 
     use super::*;
@@ -228,4 +250,23 @@ mod tests {
         let id = validate_client_type("InvalidClientTypeWithLengthOfClientId>65Char");
         assert!(id.is_err())
     }
+
+    #[rstest]
+    #[case::empty_prefix("", 1, 64, false)]
+    #[case::max_is_low("a", 1, 10, false)]
+    #[case::u64_max_is_too_big("a", 3, 21, false)]
+    #[case::u64_min_is_too_small("a", 4, 22, false)]
+    #[case::u64_min_max_boundary("a", 3, 22, true)]
+    #[case("chainA", 1, 32, true)]
+    #[case("chainA", 1, 64, true)]
+    #[test_log::test]
+    fn test_prefix_length_validation(
+        #[case] prefix: &str,
+        #[case] min: u64,
+        #[case] max: u64,
+        #[case] success: bool,
+    ) {
+        let result = validate_prefix_length(prefix, min, max);
+        assert_eq!(result.is_ok(), success);
+    }
 }
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 53b64956b..03ee78a7d 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -354,7 +354,7 @@ pub struct MockClientConfig {
 impl Default for MockContext {
     fn default() -> Self {
         Self::new(
-            ChainId::new("mockgaia", 0).expect("Never fails"),
+            ChainId::new("mockgaia-0").expect("Never fails"),
             HostType::Mock,
             5,
             Height::new(0, 5).expect("Never fails"),
@@ -1569,7 +1569,7 @@ mod tests {
         }
         let cv = 1; // The version to use for all chains.
 
-        let mock_chain_id = ChainId::new("mockgaia", cv).unwrap();
+        let mock_chain_id = ChainId::new(&format!("mockgaia-{cv}")).unwrap();
 
         let tests: Vec<Test> = vec![
             Test {
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc/src/mock/ics18_relayer/context.rs
index 4e74b04a9..735650cca 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc/src/mock/ics18_relayer/context.rs
@@ -100,8 +100,8 @@ mod tests {
         let client_on_a_for_b = ClientId::new(tm_client_type(), 0).unwrap();
         let client_on_b_for_a = ClientId::new(mock_client_type(), 0).unwrap();
 
-        let chain_id_a = ChainId::new("mockgaiaA", 1).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB", 1).unwrap();
+        let chain_id_a = ChainId::new("mockgaiaA-1").unwrap();
+        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         // Create two mock contexts, one for each chain.
         let mut ctx_a =

From 527bb141383129db804b0b9d49793c4a900deede Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 7 Nov 2023 10:10:17 -0800
Subject: [PATCH 053/182] deps: bump `ibc-proto-rs` to v0.38.0 + some other
 dependency upgrades (#949)

* deps: bump ibc-proto-rs to v0.38.0 + some other dependency upgrades

* chore: add unclog

* nit: unclog link

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* deps: upgrade some others

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../949-bump-ibc-proto-rs-to-v0380.md         |  2 +
 ci/cw-check/Cargo.lock                        |  4 +-
 ci/no-std-check/Cargo.lock                    |  4 +-
 ci/no-std-check/Cargo.toml                    | 10 +--
 crates/ibc-derive/src/consensus_state.rs      |  2 +-
 crates/ibc-query/Cargo.toml                   |  2 +-
 crates/ibc/Cargo.toml                         | 28 +++---
 crates/ibc/src/applications/transfer/error.rs |  6 +-
 .../applications/transfer/msgs/transfer.rs    |  6 +-
 .../clients/ics07_tendermint/client_state.rs  |  4 +-
 .../ics07_tendermint/consensus_state.rs       |  6 +-
 .../src/clients/ics07_tendermint/header.rs    |  4 +-
 .../clients/ics07_tendermint/misbehaviour.rs  |  4 +-
 .../ics07_tendermint/trust_threshold.rs       |  2 +-
 crates/ibc/src/core/context.rs                |  5 +-
 .../src/core/ics02_client/consensus_state.rs  |  2 +-
 crates/ibc/src/core/ics02_client/error.rs     |  6 +-
 crates/ibc/src/core/ics02_client/height.rs    |  2 +-
 .../core/ics02_client/msgs/create_client.rs   |  2 +-
 .../core/ics02_client/msgs/misbehaviour.rs    |  2 +-
 .../core/ics02_client/msgs/update_client.rs   |  2 +-
 .../core/ics02_client/msgs/upgrade_client.rs  |  2 +-
 .../src/core/ics03_connection/connection.rs   |  2 +-
 crates/ibc/src/core/ics03_connection/error.rs |  3 -
 .../ics03_connection/handler/conn_open_ack.rs |  2 +-
 .../handler/conn_open_confirm.rs              |  2 +-
 .../ics03_connection/handler/conn_open_try.rs |  2 +-
 .../ics03_connection/msgs/conn_open_ack.rs    |  2 +-
 .../msgs/conn_open_confirm.rs                 |  2 +-
 .../ics03_connection/msgs/conn_open_init.rs   |  2 +-
 .../ics03_connection/msgs/conn_open_try.rs    |  2 +-
 .../ibc/src/core/ics03_connection/version.rs  |  2 +-
 crates/ibc/src/core/ics04_channel/channel.rs  |  2 +-
 .../handler/chan_close_confirm.rs             |  2 +-
 .../ics04_channel/handler/chan_open_ack.rs    |  2 +-
 .../handler/chan_open_confirm.rs              |  2 +-
 .../ics04_channel/handler/chan_open_try.rs    |  2 +-
 .../ics04_channel/handler/timeout_on_close.rs |  2 +-
 .../ics04_channel/msgs/acknowledgement.rs     |  2 +-
 .../ics04_channel/msgs/chan_close_confirm.rs  |  2 +-
 .../ics04_channel/msgs/chan_close_init.rs     |  2 +-
 .../core/ics04_channel/msgs/chan_open_ack.rs  |  2 +-
 .../ics04_channel/msgs/chan_open_confirm.rs   |  2 +-
 .../core/ics04_channel/msgs/chan_open_init.rs |  2 +-
 .../core/ics04_channel/msgs/chan_open_try.rs  |  2 +-
 .../core/ics04_channel/msgs/recv_packet.rs    |  2 +-
 .../src/core/ics04_channel/msgs/timeout.rs    |  2 +-
 .../ics04_channel/msgs/timeout_on_close.rs    |  2 +-
 crates/ibc/src/core/msgs.rs                   | 86 ++++++++++++++-----
 .../hosts/tendermint/upgrade_proposal/plan.rs |  4 +-
 .../tendermint/upgrade_proposal/proposal.rs   |  2 +-
 crates/ibc/src/lib.rs                         |  2 +-
 crates/ibc/src/mock/client_state.rs           |  4 +-
 crates/ibc/src/mock/consensus_state.rs        |  6 +-
 crates/ibc/src/mock/context.rs                |  2 +-
 crates/ibc/src/mock/header.rs                 | 14 +--
 crates/ibc/src/mock/host.rs                   |  2 +-
 crates/ibc/src/mock/misbehaviour.rs           |  4 +-
 58 files changed, 162 insertions(+), 124 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md

diff --git a/.changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md b/.changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md
new file mode 100644
index 000000000..de2d127b7
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md
@@ -0,0 +1,2 @@
+- Bump `ibc-proto-rs` to v0.38.0
+  ([\#949](https://github.com/cosmos/ibc-rs/issues/949))
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 153b91f8f..30e602dc1 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -651,9 +651,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.37.1"
+version = "0.38.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63042806bb2f662ca1c68026231900cfe13361136ddfd0dd09bcb315056a22b8"
+checksum = "93cbf4cbe9e5113cc7c70f3208a7029b2205c629502cbb2ae7ea0a09a97d3005"
 dependencies = [
  "base64 0.21.2",
  "bytes",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 73605b5f5..86bab468e 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1100,9 +1100,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.37.1"
+version = "0.38.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63042806bb2f662ca1c68026231900cfe13361136ddfd0dd09bcb315056a22b8"
+checksum = "93cbf4cbe9e5113cc7c70f3208a7029b2205c629502cbb2ae7ea0a09a97d3005"
 dependencies = [
  "base64 0.21.4",
  "borsh",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 81acb9a70..d1296297a 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,7 +6,7 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../crates/ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.37.1", default-features = false, features = [
+ibc-proto = { version = "0.38.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
@@ -15,10 +15,10 @@ tendermint = { version = "0.34", default-features = false }
 tendermint-proto = { version = "0.34", default-features = false }
 tendermint-light-client-verifier = { version = "0.34", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "24.0.0", default-features = false, optional = true }
-sp-io = { version = "26.0.0", default-features = false, optional = true }
-sp-runtime = { version = "27.0.0", default-features = false, optional = true }
-sp-std = { version = "11.0.0", default-features = false, optional = true }
+sp-core = { version = "25.0.0", default-features = false, optional = true }
+sp-io = { version = "27.0.0", default-features = false, optional = true }
+sp-runtime = { version = "28.0.0", default-features = false, optional = true }
+sp-std = { version = "12.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
diff --git a/crates/ibc-derive/src/consensus_state.rs b/crates/ibc-derive/src/consensus_state.rs
index 99feb69ce..98b57f405 100644
--- a/crates/ibc-derive/src/consensus_state.rs
+++ b/crates/ibc-derive/src/consensus_state.rs
@@ -36,7 +36,7 @@ pub fn consensus_state_derive_impl(ast: DeriveInput) -> TokenStream {
                 }
             }
 
-            fn encode_vec(&self) -> Vec<u8> {
+            fn encode_vec(self) -> Vec<u8> {
                 match self {
                     #(#encode_vec_impl),*
                 }
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
index 6a73318c3..da50f931b 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/crates/ibc-query/Cargo.toml
@@ -19,6 +19,6 @@ std = ["ibc-proto/std", "ibc/std"]
 
 [dependencies]
 ibc = { version = "0.47.0", path = "../ibc", default-features = false }
-ibc-proto = { version = "0.37.1", default-features = false, features = ["server"] }
+ibc-proto = { version = "0.38.0", default-features = false, features = ["server"] }
 displaydoc = { version = "0.2", default-features = false }
 tonic = "0.10"
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index ae4d4d56b..1528e4008 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -50,34 +50,34 @@ mocks = ["tendermint-testgen", "parking_lot", "typed-builder", "std"]
 
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.37.1", default-features = false }
+ibc-proto = { version = "0.38.0", default-features = false }
 ics23 = { version = "0.11", default-features = false, features = ["host-functions"] }
 time = { version = ">=0.3.0, <0.3.31", default-features = false }
-serde_derive = { version = "1.0.104", default-features = false, optional = true }
+serde_derive = { version = "1.0", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false, optional = true}
-tracing = { version = "0.1.36", default-features = false }
+tracing = { version = "0.1.40", default-features = false }
 prost = { version = "0.12", default-features = false }
-bytes = { version = "1.2.1", default-features = false }
+bytes = { version = "1.5.0", default-features = false }
 subtle-encoding = { version = "0.5", default-features = false }
-sha2 = { version = "0.10.6", default-features = false }
+sha2 = { version = "0.10.8", default-features = false }
 displaydoc = { version = "0.2", default-features = false }
-num-traits = { version = "0.2.15", default-features = false }
+num-traits = { version = "0.2.17", default-features = false }
 derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
 uint = { version = "0.9", default-features = false }
-primitive-types = { version = "0.12.0", default-features = false, features = ["serde_no_std"] }
+primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
 
 ## for codec encode or decode
-parity-scale-codec = { version = "3.0.0", default-features = false, features = ["full"], optional = true }
-scale-info = { version = "2.1.2", default-features = false, features = ["derive"], optional = true }
+parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"], optional = true }
+scale-info = { version = "2.10.0", default-features = false, features = ["derive"], optional = true }
 ## for borsh encode or decode
 borsh = {version = "0.10", default-features = false, optional = true }
 parking_lot = { version = "0.12.1", default-features = false, optional = true }
-typed-builder = { version = "0.17.0", optional = true }
+typed-builder = { version = "0.18.0", optional = true }
 
 ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
 
-schemars = { version = "0.8.12", optional = true }
+schemars = { version = "0.8.15", optional = true }
 
 [dependencies.tendermint]
 version = "0.34"
@@ -99,8 +99,8 @@ default-features = false
 
 [dev-dependencies]
 env_logger = "0.10.0"
-rstest = "0.18.1"
-tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
-test-log = { version = "0.2.10", features = ["trace"] }
+rstest = "0.18.2"
+tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"]}
+test-log = { version = "0.2.13", features = ["trace"] }
 tendermint-rpc = { version = "0.34", features = ["http-client", "websocket-client"] }
 ibc = { path = ".", features = ["mocks"] }
diff --git a/crates/ibc/src/applications/transfer/error.rs b/crates/ibc/src/applications/transfer/error.rs
index 72fb7ce2f..d47decc33 100644
--- a/crates/ibc/src/applications/transfer/error.rs
+++ b/crates/ibc/src/applications/transfer/error.rs
@@ -4,7 +4,6 @@ use core::convert::Infallible;
 use core::str::Utf8Error;
 
 use displaydoc::Display;
-use ibc_proto::protobuf::Error as TendermintProtoError;
 use uint::FromDecStrErr;
 
 use crate::core::ics04_channel::acknowledgement::StatusValue;
@@ -64,8 +63,8 @@ pub enum TokenTransferError {
         port_id: PortId,
         exp_port_id: PortId,
     },
-    /// decoding raw msg error: `{0}`
-    DecodeRawMsg(TendermintProtoError),
+    /// decoding raw msg error: `{reason}`
+    DecodeRawMsg { reason: String },
     /// unknown msg type: `{msg_type}`
     UnknownMsgType { msg_type: String },
     /// invalid coin string: `{coin}`
@@ -89,7 +88,6 @@ impl std::error::Error for TokenTransferError {
                 ..
             } => Some(e),
             Self::InvalidAmount(e) => Some(e),
-            Self::DecodeRawMsg(e) => Some(e),
             Self::Utf8Decode(e) => Some(e),
             _ => None,
         }
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index f3ef9172e..026e38b3f 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -2,7 +2,7 @@
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::applications::transfer::v1::MsgTransfer as RawMsgTransfer;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::applications::transfer::error::TokenTransferError;
 use crate::applications::transfer::packet::PacketData;
@@ -115,7 +115,9 @@ impl TryFrom<Any> for MsgTransfer {
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
         match raw.type_url.as_str() {
             TYPE_URL => {
-                MsgTransfer::decode_vec(&raw.value).map_err(TokenTransferError::DecodeRawMsg)
+                MsgTransfer::decode_vec(&raw.value).map_err(|e| TokenTransferError::DecodeRawMsg {
+                    reason: e.to_string(),
+                })
             }
             _ => Err(TokenTransferError::UnknownMsgType {
                 msg_type: raw.type_url,
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index 825a467d7..a4ff405fb 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -13,7 +13,7 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
 use ibc_proto::ibc::lightclients::tendermint::v1::ClientState as RawTmClientState;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use prost::Message;
 use tendermint::chain::id::MAX_LENGTH as MaxChainIdLen;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
@@ -770,7 +770,7 @@ impl From<ClientState> for Any {
     fn from(client_state: ClientState) -> Self {
         Any {
             type_url: TENDERMINT_CLIENT_STATE_TYPE_URL.to_string(),
-            value: Protobuf::<RawTmClientState>::encode_vec(&client_state),
+            value: Protobuf::<RawTmClientState>::encode_vec(client_state),
         }
     }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
index 7139b3284..14cd0b81b 100644
--- a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
@@ -2,7 +2,7 @@
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::ConsensusState as RawConsensusState;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use tendermint::hash::Algorithm;
 use tendermint::time::Time;
 use tendermint::Hash;
@@ -126,7 +126,7 @@ impl From<ConsensusState> for Any {
     fn from(consensus_state: ConsensusState) -> Self {
         Any {
             type_url: TENDERMINT_CONSENSUS_STATE_TYPE_URL.to_string(),
-            value: Protobuf::<RawConsensusState>::encode_vec(&consensus_state),
+            value: Protobuf::<RawConsensusState>::encode_vec(consensus_state),
         }
     }
 }
@@ -156,7 +156,7 @@ impl ConsensusStateTrait for ConsensusState {
         self.timestamp.into()
     }
 
-    fn encode_vec(&self) -> Vec<u8> {
+    fn encode_vec(self) -> Vec<u8> {
         <Self as Protobuf<Any>>::encode_vec(self)
     }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index 22056d4a6..f73b79d36 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -7,7 +7,7 @@ use core::str::FromStr;
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use pretty::{PrettySignedHeader, PrettyValidatorSet};
 use prost::Message;
 use tendermint::block::signed_header::SignedHeader;
@@ -186,7 +186,7 @@ impl From<Header> for Any {
     fn from(header: Header) -> Self {
         Any {
             type_url: TENDERMINT_HEADER_TYPE_URL.to_string(),
-            value: Protobuf::<RawHeader>::encode_vec(&header),
+            value: Protobuf::<RawHeader>::encode_vec(header),
         }
     }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
index 646eb6781..8697a7c11 100644
--- a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
@@ -3,7 +3,7 @@
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Misbehaviour as RawMisbehaviour;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use prost::Message;
 
 use crate::clients::ics07_tendermint::error::Error;
@@ -135,7 +135,7 @@ impl From<Misbehaviour> for Any {
     fn from(misbehaviour: Misbehaviour) -> Self {
         Any {
             type_url: TENDERMINT_MISBEHAVIOUR_TYPE_URL.to_string(),
-            value: Protobuf::<RawMisbehaviour>::encode_vec(&misbehaviour),
+            value: Protobuf::<RawMisbehaviour>::encode_vec(misbehaviour),
         }
     }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs b/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
index d4e4e9c86..744dbf14d 100644
--- a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
@@ -6,7 +6,7 @@ use core::convert::TryFrom;
 use core::fmt::{Display, Error as FmtError, Formatter};
 
 use ibc_proto::ibc::lightclients::tendermint::v1::Fraction;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use tendermint::trust_threshold::TrustThresholdFraction;
 
 use crate::core::ics02_client::error::ClientError;
diff --git a/crates/ibc/src/core/context.rs b/crates/ibc/src/core/context.rs
index 13bb7023a..288717f4b 100644
--- a/crates/ibc/src/core/context.rs
+++ b/crates/ibc/src/core/context.rs
@@ -65,8 +65,8 @@ pub enum RouterError {
     ContextError(ContextError),
     /// unknown type URL `{url}`
     UnknownMessageTypeUrl { url: String },
-    /// the message is malformed and cannot be decoded error: `{0}`
-    MalformedMessageBytes(ibc_proto::protobuf::Error),
+    /// the message is malformed and cannot be decoded error: `{reason}`
+    MalformedMessageBytes { reason: String },
     /// port `{port_id}` is unknown
     UnknownPort { port_id: PortId },
     /// module not found
@@ -84,7 +84,6 @@ impl std::error::Error for RouterError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             Self::ContextError(e) => Some(e),
-            Self::MalformedMessageBytes(e) => Some(e),
             _ => None,
         }
     }
diff --git a/crates/ibc/src/core/ics02_client/consensus_state.rs b/crates/ibc/src/core/ics02_client/consensus_state.rs
index 17a4ebbec..ea5e05e37 100644
--- a/crates/ibc/src/core/ics02_client/consensus_state.rs
+++ b/crates/ibc/src/core/ics02_client/consensus_state.rs
@@ -24,5 +24,5 @@ pub trait ConsensusState: Send + Sync {
     /// Serializes the `ConsensusState`. This is expected to be implemented as
     /// first converting to the raw type (i.e. the protobuf definition), and then
     /// serializing that.
-    fn encode_vec(&self) -> Vec<u8>;
+    fn encode_vec(self) -> Vec<u8>;
 }
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/crates/ibc/src/core/ics02_client/error.rs
index f67b8fa42..f9b79f194 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/crates/ibc/src/core/ics02_client/error.rs
@@ -1,7 +1,6 @@
 //! Defines the client error type
 
 use displaydoc::Display;
-use ibc_proto::protobuf::Error as TendermintProtoError;
 
 use super::client_state::Status;
 use crate::core::ics02_client::client_type::ClientType;
@@ -65,8 +64,8 @@ pub enum ClientError {
     Decode(prost::DecodeError),
     /// invalid client identifier error: `{0}`
     InvalidClientIdentifier(IdentifierError),
-    /// invalid raw header error: `{0}`
-    InvalidRawHeader(TendermintProtoError),
+    /// invalid raw header error: `{reason}`
+    InvalidRawHeader { reason: String },
     /// missing raw client message
     MissingClientMessage,
     /// invalid raw misbehaviour error: `{0}`
@@ -140,7 +139,6 @@ impl std::error::Error for ClientError {
             } => Some(e),
             Self::InvalidMsgUpdateClientId(e) => Some(e),
             Self::InvalidClientIdentifier(e) => Some(e),
-            Self::InvalidRawHeader(e) => Some(e),
             Self::InvalidRawMisbehaviour(e) => Some(e),
             Self::InvalidCommitmentProof(e) => Some(e),
             Self::InvalidPacketTimestamp(e) => Some(e),
diff --git a/crates/ibc/src/core/ics02_client/height.rs b/crates/ibc/src/core/ics02_client/height.rs
index 469337917..fbdf42def 100644
--- a/crates/ibc/src/core/ics02_client/height.rs
+++ b/crates/ibc/src/core/ics02_client/height.rs
@@ -6,7 +6,7 @@ use core::str::FromStr;
 
 use displaydoc::Display;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::prelude::*;
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index b292367b8..495d8eea2 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -2,7 +2,7 @@
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::Msg;
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
index 96b3e4e68..925bd69f9 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
@@ -2,7 +2,7 @@
 
 use ibc_proto::google::protobuf::Any as ProtoAny;
 use ibc_proto::ibc::core::client::v1::MsgSubmitMisbehaviour as RawMsgSubmitMisbehaviour;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 3995d15d2..9efcbe32b 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -2,7 +2,7 @@
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index 9a3bfa444..d6dffcc67 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -4,7 +4,7 @@ use core::str::FromStr;
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/crates/ibc/src/core/ics03_connection/connection.rs
index d3017b406..5b43fd48e 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/crates/ibc/src/core/ics03_connection/connection.rs
@@ -8,7 +8,7 @@ use ibc_proto::ibc::core::connection::v1::{
     ConnectionEnd as RawConnectionEnd, Counterparty as RawCounterparty,
     IdentifiedConnection as RawIdentifiedConnection,
 };
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics03_connection::error::ConnectionError;
diff --git a/crates/ibc/src/core/ics03_connection/error.rs b/crates/ibc/src/core/ics03_connection/error.rs
index 40d677ade..db7e95dd8 100644
--- a/crates/ibc/src/core/ics03_connection/error.rs
+++ b/crates/ibc/src/core/ics03_connection/error.rs
@@ -3,7 +3,6 @@
 use alloc::string::String;
 
 use displaydoc::Display;
-use ibc_proto::protobuf::Error as ProtoError;
 
 use crate::core::ics02_client::error as client_error;
 use crate::core::ics03_connection::version::Version;
@@ -17,8 +16,6 @@ pub enum ConnectionError {
     Client(client_error::ClientError),
     /// invalid connection state: expected `{expected}`, actual `{actual}`
     InvalidState { expected: String, actual: String },
-    /// invalid connection end error: `{0}`
-    InvalidConnectionEnd(ProtoError),
     /// consensus height claimed by the client on the other party is too advanced: `{target_height}` (host chain current height: `{current_height}`)
     InvalidConsensusHeight {
         target_height: Height,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index efb7a9bf4..285d1299b 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenAck`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
index 96b7240c7..d7896f2bc 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenConfirm`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::context::ContextError;
 use crate::core::events::{IbcEvent, MessageEvent};
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index 953fe5bb9..cad91660a 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use prost::Message;
 
 use crate::core::context::ContextError;
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index 0e9500abf..ae8a7f07b 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -1,6 +1,6 @@
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics03_connection::version::Version;
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
index 4e55f5d9e..45a5f6f7d 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index b05a7feec..37afaa9b4 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -1,7 +1,7 @@
 use core::time::Duration;
 
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenInit as RawMsgConnectionOpenInit;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics03_connection::connection::Counterparty;
 use crate::core::ics03_connection::error::ConnectionError;
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index f69ee6016..09dc56b4b 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -3,7 +3,7 @@ use core::time::Duration;
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics03_connection::connection::Counterparty;
 use crate::core::ics03_connection::error::ConnectionError;
diff --git a/crates/ibc/src/core/ics03_connection/version.rs b/crates/ibc/src/core/ics03_connection/version.rs
index 2eb4d0152..2052bb12c 100644
--- a/crates/ibc/src/core/ics03_connection/version.rs
+++ b/crates/ibc/src/core/ics03_connection/version.rs
@@ -3,7 +3,7 @@
 use core::fmt::Display;
 
 use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics03_connection::error::ConnectionError;
 use crate::core::ics04_channel::channel::Order;
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 4fd2d9237..2b1c7c766 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -7,7 +7,7 @@ use ibc_proto::ibc::core::channel::v1::{
     Channel as RawChannel, Counterparty as RawCounterparty,
     IdentifiedChannel as RawIdentifiedChannel,
 };
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::Version;
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index c36bbe507..717220339 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseConfirm`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index e16e25d8e..eb6ac5074 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenAck`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index e7b4598f6..8fff0a6a9 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenConfirm`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index a1c1943bc..f140a0832 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -1,6 +1,6 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenTry`.
 
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::events::{IbcEvent, MessageEvent};
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
index 35af327c5..509d1380c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
@@ -1,4 +1,4 @@
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use prost::Message;
 
 use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
index 630a9468e..7612f34a0 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::acknowledgement::Acknowledgement;
 use crate::core::ics04_channel::error::PacketError;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
index b3462ad72..d183db53d 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
index 88dbcd7bc..7f0c1e04f 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics24_host::identifier::{ChannelId, PortId};
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
index 1d0676f58..3b230d1c9 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics04_channel::Version;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
index bb1714209..86e208e77 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::ChannelError;
 use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index 63831cf05..b16c27525 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::channel::{
     verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
index db8da599c..3eca4a0c4 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::channel::{
     verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
index 42a96d559..a39f1ec10 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::Packet;
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
index 286efbda4..6f854d70a 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::{Packet, Sequence};
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
index 7cfb8b075..74bd6de8c 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
@@ -1,5 +1,5 @@
 use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics04_channel::error::PacketError;
 use crate::core::ics04_channel::packet::{Packet, Sequence};
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
index 311b7ad71..bef0e690c 100644
--- a/crates/ibc/src/core/msgs.rs
+++ b/crates/ibc/src/core/msgs.rs
@@ -1,5 +1,5 @@
 use ibc_proto::google::protobuf::Any;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::context::RouterError;
 use crate::core::ics02_client::msgs::{
@@ -57,45 +57,61 @@ impl TryFrom<Any> for MsgEnvelope {
             create_client::TYPE_URL => {
                 // Pop out the message and then wrap it in the corresponding type.
                 let domain_msg = create_client::MsgCreateClient::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Client(ClientMsg::CreateClient(domain_msg)))
             }
             update_client::TYPE_URL => {
                 let domain_msg = update_client::MsgUpdateClient::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Client(ClientMsg::UpdateClient(domain_msg)))
             }
             upgrade_client::TYPE_URL => {
                 let domain_msg = upgrade_client::MsgUpgradeClient::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Client(ClientMsg::UpgradeClient(domain_msg)))
             }
             misbehaviour::TYPE_URL => {
                 let domain_msg = misbehaviour::MsgSubmitMisbehaviour::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Client(ClientMsg::Misbehaviour(domain_msg)))
             }
 
             // ICS03
             conn_open_init::TYPE_URL => {
                 let domain_msg = conn_open_init::MsgConnectionOpenInit::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Connection(ConnectionMsg::OpenInit(domain_msg)))
             }
             conn_open_try::TYPE_URL => {
                 let domain_msg = conn_open_try::MsgConnectionOpenTry::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Connection(ConnectionMsg::OpenTry(domain_msg)))
             }
             conn_open_ack::TYPE_URL => {
                 let domain_msg = conn_open_ack::MsgConnectionOpenAck::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Connection(ConnectionMsg::OpenAck(domain_msg)))
             }
             conn_open_confirm::TYPE_URL => {
                 let domain_msg =
                     conn_open_confirm::MsgConnectionOpenConfirm::decode_vec(&any_msg.value)
-                        .map_err(RouterError::MalformedMessageBytes)?;
+                        .map_err(|e| RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        })?;
                 Ok(MsgEnvelope::Connection(ConnectionMsg::OpenConfirm(
                     domain_msg,
                 )))
@@ -104,55 +120,79 @@ impl TryFrom<Any> for MsgEnvelope {
             // ICS04 channel messages
             chan_open_init::TYPE_URL => {
                 let domain_msg = chan_open_init::MsgChannelOpenInit::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::OpenInit(domain_msg)))
             }
             chan_open_try::TYPE_URL => {
                 let domain_msg = chan_open_try::MsgChannelOpenTry::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::OpenTry(domain_msg)))
             }
             chan_open_ack::TYPE_URL => {
                 let domain_msg = chan_open_ack::MsgChannelOpenAck::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::OpenAck(domain_msg)))
             }
             chan_open_confirm::TYPE_URL => {
-                let domain_msg =
-                    chan_open_confirm::MsgChannelOpenConfirm::decode_vec(&any_msg.value)
-                        .map_err(RouterError::MalformedMessageBytes)?;
+                let domain_msg = chan_open_confirm::MsgChannelOpenConfirm::decode_vec(
+                    &any_msg.value,
+                )
+                .map_err(|e| RouterError::MalformedMessageBytes {
+                    reason: e.to_string(),
+                })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::OpenConfirm(domain_msg)))
             }
             chan_close_init::TYPE_URL => {
                 let domain_msg = chan_close_init::MsgChannelCloseInit::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                    reason: e.to_string(),
+                })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::CloseInit(domain_msg)))
             }
             chan_close_confirm::TYPE_URL => {
                 let domain_msg =
                     chan_close_confirm::MsgChannelCloseConfirm::decode_vec(&any_msg.value)
-                        .map_err(RouterError::MalformedMessageBytes)?;
+                        .map_err(|e| RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        })?;
                 Ok(MsgEnvelope::Channel(ChannelMsg::CloseConfirm(domain_msg)))
             }
             // ICS04 packet messages
             recv_packet::TYPE_URL => {
-                let domain_msg = recv_packet::MsgRecvPacket::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                let domain_msg =
+                    recv_packet::MsgRecvPacket::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
                 Ok(MsgEnvelope::Packet(PacketMsg::Recv(domain_msg)))
             }
             acknowledgement::TYPE_URL => {
                 let domain_msg = acknowledgement::MsgAcknowledgement::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Packet(PacketMsg::Ack(domain_msg)))
             }
             timeout::TYPE_URL => {
-                let domain_msg = timeout::MsgTimeout::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                let domain_msg = timeout::MsgTimeout::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
                 Ok(MsgEnvelope::Packet(PacketMsg::Timeout(domain_msg)))
             }
             timeout_on_close::TYPE_URL => {
                 let domain_msg = timeout_on_close::MsgTimeoutOnClose::decode_vec(&any_msg.value)
-                    .map_err(RouterError::MalformedMessageBytes)?;
+                    .map_err(|e| RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    })?;
                 Ok(MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(domain_msg)))
             }
             _ => Err(RouterError::UnknownMessageTypeUrl {
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
index a448aeb91..075e0b692 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
@@ -5,7 +5,7 @@ use alloc::string::{String, ToString};
 
 use ibc_proto::cosmos::upgrade::v1beta1::Plan as RawPlan;
 use ibc_proto::google::protobuf::Any;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::UpgradeClientError;
 
@@ -108,7 +108,7 @@ impl From<Plan> for Any {
     fn from(value: Plan) -> Self {
         Any {
             type_url: TYPE_URL.to_string(),
-            value: Protobuf::<RawPlan>::encode_vec(&value),
+            value: Protobuf::<RawPlan>::encode_vec(value),
         }
     }
 }
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs b/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
index 21cfa714f..46deaeda2 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
+++ b/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
@@ -4,7 +4,7 @@ use alloc::string::{String, ToString};
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::UpgradeProposal as RawUpgradeProposal;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use super::Plan;
 use crate::core::ics02_client::error::UpgradeClientError;
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index 528693a9b..c1a9d323f 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -73,5 +73,5 @@ pub mod proto {
     pub use ibc_proto::ibc::apps::transfer;
     pub use ibc_proto::ibc::core;
     pub use ibc_proto::ibc::lightclients::tendermint;
-    pub use ibc_proto::protobuf;
+    pub use ibc_proto::Protobuf;
 }
diff --git a/crates/ibc/src/mock/client_state.rs b/crates/ibc/src/mock/client_state.rs
index 454b2576e..4fa159cc1 100644
--- a/crates/ibc/src/mock/client_state.rs
+++ b/crates/ibc/src/mock/client_state.rs
@@ -3,7 +3,7 @@ use core::time::Duration;
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::ClientState as RawMockClientState;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::client_state::{
     ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
@@ -127,7 +127,7 @@ impl From<MockClientState> for Any {
     fn from(client_state: MockClientState) -> Self {
         Any {
             type_url: MOCK_CLIENT_STATE_TYPE_URL.to_string(),
-            value: Protobuf::<RawMockClientState>::encode_vec(&client_state),
+            value: Protobuf::<RawMockClientState>::encode_vec(client_state),
         }
     }
 }
diff --git a/crates/ibc/src/mock/consensus_state.rs b/crates/ibc/src/mock/consensus_state.rs
index 0f1d9b5ab..4bf3e1129 100644
--- a/crates/ibc/src/mock/consensus_state.rs
+++ b/crates/ibc/src/mock/consensus_state.rs
@@ -1,6 +1,6 @@
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::ConsensusState as RawMockConsensusState;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::consensus_state::ConsensusState;
 use crate::core::ics02_client::error::ClientError;
@@ -89,7 +89,7 @@ impl From<MockConsensusState> for Any {
     fn from(consensus_state: MockConsensusState) -> Self {
         Any {
             type_url: MOCK_CONSENSUS_STATE_TYPE_URL.to_string(),
-            value: Protobuf::<RawMockConsensusState>::encode_vec(&consensus_state),
+            value: Protobuf::<RawMockConsensusState>::encode_vec(consensus_state),
         }
     }
 }
@@ -103,7 +103,7 @@ impl ConsensusState for MockConsensusState {
         self.header.timestamp
     }
 
-    fn encode_vec(&self) -> Vec<u8> {
+    fn encode_vec(self) -> Vec<u8> {
         <Self as Protobuf<Any>>::encode_vec(self)
     }
 }
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc/src/mock/context.rs
index 03ee78a7d..c40477f66 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc/src/mock/context.rs
@@ -11,7 +11,7 @@ use core::time::Duration;
 
 use derive_more::{From, TryInto};
 use ibc_proto::google::protobuf::Any;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
 use tracing::debug;
diff --git a/crates/ibc/src/mock/header.rs b/crates/ibc/src/mock/header.rs
index 62e3f6073..bf5ce05eb 100644
--- a/crates/ibc/src/mock/header.rs
+++ b/crates/ibc/src/mock/header.rs
@@ -3,7 +3,7 @@ use core::fmt::{Display, Error as FmtError, Formatter};
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::Header as RawMockHeader;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::timestamp::Timestamp;
@@ -95,8 +95,11 @@ impl TryFrom<Any> for MockHeader {
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
         match raw.type_url.as_str() {
-            MOCK_HEADER_TYPE_URL => Ok(Protobuf::<RawMockHeader>::decode_vec(&raw.value)
-                .map_err(ClientError::InvalidRawHeader)?),
+            MOCK_HEADER_TYPE_URL => Ok(Protobuf::<RawMockHeader>::decode_vec(&raw.value).map_err(
+                |e| ClientError::InvalidRawHeader {
+                    reason: e.to_string(),
+                },
+            )?),
             _ => Err(ClientError::UnknownHeaderType {
                 header_type: raw.type_url,
             }),
@@ -108,14 +111,13 @@ impl From<MockHeader> for Any {
     fn from(header: MockHeader) -> Self {
         Any {
             type_url: MOCK_HEADER_TYPE_URL.to_string(),
-            value: Protobuf::<RawMockHeader>::encode_vec(&header),
+            value: Protobuf::<RawMockHeader>::encode_vec(header),
         }
     }
 }
 
 #[cfg(test)]
 mod tests {
-    use ibc_proto::protobuf::Protobuf;
 
     use super::*;
 
@@ -123,7 +125,7 @@ mod tests {
     fn encode_any() {
         let header = MockHeader::new(Height::new(1, 10).expect("Never fails"))
             .with_timestamp(Timestamp::none());
-        let bytes = <MockHeader as Protobuf<Any>>::encode_vec(&header);
+        let bytes = <MockHeader as Protobuf<Any>>::encode_vec(header);
 
         assert_eq!(
             &bytes,
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc/src/mock/host.rs
index 30444b478..e54e76e93 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc/src/mock/host.rs
@@ -4,7 +4,7 @@ use core::str::FromStr;
 
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
-use ibc_proto::protobuf::Protobuf as ErasedProtobuf;
+use ibc_proto::Protobuf as ErasedProtobuf;
 use tendermint::block::Header as TmHeader;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint_testgen::light_block::TmLightBlock;
diff --git a/crates/ibc/src/mock/misbehaviour.rs b/crates/ibc/src/mock/misbehaviour.rs
index 07e0fda6d..192d78955 100644
--- a/crates/ibc/src/mock/misbehaviour.rs
+++ b/crates/ibc/src/mock/misbehaviour.rs
@@ -1,7 +1,7 @@
 use bytes::Buf;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::mock::Misbehaviour as RawMisbehaviour;
-use ibc_proto::protobuf::Protobuf;
+use ibc_proto::Protobuf;
 
 use crate::core::ics02_client::error::ClientError;
 use crate::core::ics24_host::identifier::ClientId;
@@ -79,7 +79,7 @@ impl From<Misbehaviour> for Any {
     fn from(misbehaviour: Misbehaviour) -> Self {
         Any {
             type_url: MOCK_MISBEHAVIOUR_TYPE_URL.to_string(),
-            value: Protobuf::<RawMisbehaviour>::encode_vec(&misbehaviour),
+            value: Protobuf::<RawMisbehaviour>::encode_vec(misbehaviour),
         }
     }
 }

From 046901f4bb0ea6a4a331b4c34f131c7e0d39ea5e Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 10 Nov 2023 08:37:41 -0800
Subject: [PATCH 054/182] feat: restructure mock module and separate its
 codebase into a new crate (#954)

* imp: separate mock module into a dedicated crate

* fix: clippy, fmt, no-std

* imp: restructure second iteration

* chore: add unclogs + update READMEs

* deps: bump typed-builder

* fix: move client_ctx under core

* fix: cargo fmt

* fix: remove tracing dep from ibc

* deps: remove parking_lot from ibc

* deps: remove num-traits from ibc

* fix: apply suggestions from code review

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* nit: apply feedback

* fix: introduce with_current_timestamp()

* fix: cargo test

* imp: move test_utils.rs into utils

* imp: move test-utils + mock into the ibc-testkit

* imp: add deny attr for tests

* chore: cleanups

* chore: add comment for ibc dep in ibc-testkit

* chore: adjust paths for types imported from ibc_testkit::utils

* chore: move tendermint::client_state::test_utils under the tests module

* imp: replace json files under the src/data dir

* chore: replace data/json under tests

* imp: use concat! for paths

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../954-restructure-mock-module-into-crate.md |   3 +
 .../improvements/951-remove-default-portid.md |   2 +
 .../952-expose-channel-message-types copy.md  |   2 +
 .gitignore                                    |   3 -
 Cargo.toml                                    |   1 +
 README.md                                     |   5 +-
 ci/no-std-check/Cargo.lock                    | 306 +++++-
 crates/ibc-derive/src/utils.rs                |   2 +-
 crates/ibc-testkit/Cargo.toml                 |  51 +
 crates/ibc-testkit/README.md                  |   6 +
 .../src/hosts/block.rs}                       |  43 +-
 crates/ibc-testkit/src/hosts/mod.rs           |   1 +
 crates/ibc-testkit/src/lib.rs                 |  20 +
 .../src/relayer}/context.rs                   |  62 +-
 .../src/relayer}/error.rs                     |   7 +-
 crates/ibc-testkit/src/relayer/mod.rs         |   2 +
 .../src/testapp/ibc/applications/mod.rs       |   1 +
 .../ibc/applications/transfer/context.rs      |  88 ++
 .../testapp/ibc/applications/transfer/mod.rs  |   3 +
 .../ibc/applications/transfer/module.rs       | 106 ++
 .../ibc/applications/transfer/types.rs        |  14 +
 .../testapp/ibc/clients}/mock/client_state.rs |  39 +-
 .../ibc/clients}/mock/consensus_state.rs      |  19 +-
 .../testapp/ibc/clients/mock/header copy.rs   | 136 +++
 .../src/testapp/ibc/clients}/mock/header.rs   |  32 +-
 .../testapp/ibc/clients}/mock/misbehaviour.rs |  13 +-
 .../src/testapp/ibc/clients/mock/mod.rs       |   5 +
 .../src/testapp/ibc/clients/mod.rs            |  91 ++
 .../src/testapp/ibc/core/client_ctx.rs}       |  39 +-
 .../src/testapp/ibc/core/core_ctx.rs          | 548 ++++++++++
 .../ibc-testkit/src/testapp/ibc/core/mod.rs   |   4 +
 .../src/testapp/ibc/core/router/context.rs    |  31 +
 .../src/testapp/ibc/core/router/mod.rs        |   5 +
 .../src/testapp/ibc/core/router/types.rs      |  50 +
 .../src/testapp/ibc/core/types.rs}            | 870 +--------------
 crates/ibc-testkit/src/testapp/ibc/mod.rs     |   3 +
 crates/ibc-testkit/src/testapp/mod.rs         |   1 +
 .../src/utils/dummies/applications/mod.rs     |   2 +
 .../utils/dummies/applications/transfer.rs    |  80 ++
 .../src/utils/dummies/clients/mock.rs         |   8 +
 .../src/utils/dummies/clients/mod.rs          |   2 +
 .../src/utils/dummies/clients/tendermint.rs   | 160 +++
 .../dummies/core/channel/acknowledgement.rs   |  26 +
 .../core/channel/chan_close_confirm.rs        |  21 +
 .../dummies/core/channel/chan_close_init.rs   |  14 +
 .../dummies/core/channel/chan_open_ack.rs     |  23 +
 .../dummies/core/channel/chan_open_confirm.rs |  21 +
 .../dummies/core/channel/chan_open_init.rs    |  15 +
 .../dummies/core/channel/chan_open_try.rs     |  24 +
 .../src/utils/dummies/core/channel/mod.rs     |  50 +
 .../src/utils/dummies/core/channel/packet.rs  |  68 ++
 .../utils/dummies/core/channel/recv_packet.rs |  45 +
 .../src/utils/dummies/core/channel/timeout.rs |  24 +
 .../dummies/core/channel/timeout_on_close.rs  |  21 +
 .../src/utils/dummies/core/client/mod.rs      |  11 +
 .../dummies/core/client/msg_create_client.rs  |  21 +
 .../dummies/core/client/msg_update_client.rs  |  18 +
 .../dummies/core/client/msg_upgrade_client.rs |  38 +
 .../src/utils/dummies/core/commitment.rs      |  14 +
 .../dummies/core/connection/conn_open_ack.rs  |  45 +
 .../core/connection/conn_open_confirm.rs      |  26 +
 .../dummies/core/connection/conn_open_init.rs |  80 ++
 .../dummies/core/connection/conn_open_try.rs  |  66 ++
 .../src/utils/dummies/core/connection/mod.rs  |  51 +
 .../src/utils/dummies/core/context.rs         | 127 +++
 .../ibc-testkit/src/utils/dummies/core/mod.rs |   6 +
 .../src/utils/dummies/core/signer.rs          |  12 +
 crates/ibc-testkit/src/utils/dummies/mod.rs   |   3 +
 crates/ibc-testkit/src/utils/fixture.rs       |  35 +
 crates/ibc-testkit/src/utils/mod.rs           |   5 +
 crates/ibc-testkit/tests/applications/mod.rs  |   1 +
 .../tests/applications/transfer.rs            | 167 +++
 .../tests/core/ics02_client/create_client.rs  |  95 ++
 .../tests/core/ics02_client/mod.rs            |   3 +
 .../tests/core/ics02_client/update_client.rs  | 997 ++++++++++++++++++
 .../tests/core/ics02_client/upgrade_client.rs | 165 +++
 .../core/ics03_connection/conn_open_ack.rs    | 194 ++++
 .../ics03_connection/conn_open_confirm.rs     | 124 +++
 .../core/ics03_connection/conn_open_init.rs   | 140 +++
 .../core/ics03_connection/conn_open_try.rs    | 147 +++
 .../tests/core/ics03_connection/mod.rs        |   4 +
 .../core/ics04_channel/acknowledgement.rs     | 265 +++++
 .../core/ics04_channel/chan_close_confirm.rs  | 134 +++
 .../core/ics04_channel/chan_close_init.rs     | 133 +++
 .../tests/core/ics04_channel/chan_open_ack.rs | 240 +++++
 .../core/ics04_channel/chan_open_confirm.rs   | 209 ++++
 .../core/ics04_channel/chan_open_init.rs      | 116 ++
 .../tests/core/ics04_channel/chan_open_try.rs | 158 +++
 .../tests/core/ics04_channel/mod.rs           |  11 +
 .../tests/core/ics04_channel/recv_packet.rs   | 245 +++++
 .../tests/core/ics04_channel/send_packet.rs   | 186 ++++
 .../tests/core/ics04_channel/timeout.rs       | 431 ++++++++
 .../core/ics04_channel/timeout_on_close.rs    | 173 +++
 crates/ibc-testkit/tests/core/mod.rs          |   4 +
 crates/ibc-testkit/tests/core/router.rs       | 447 ++++++++
 .../tests/data/json}/client_state.json        |   0
 .../tests/data/json}/client_state_proof.json  |   0
 .../tests/data/json}/consensus_state.json     |   0
 .../data/json}/consensus_state_proof.json     |   0
 .../tests/data/json}/signed_header.json       |   0
 crates/ibc-testkit/tests/mod.rs               |  10 +
 crates/ibc/Cargo.toml                         |  18 +-
 crates/ibc/clippy.toml                        |   1 -
 .../ibc/src/applications/transfer/context.rs  | 132 +--
 .../applications/transfer/msgs/transfer.rs    |  46 -
 .../ibc/src/applications/transfer/packet.rs   |   5 +-
 .../clients/ics07_tendermint/client_state.rs  | 203 ++--
 .../ics07_tendermint/consensus_state.rs       |  15 +-
 .../src/clients/ics07_tendermint/header.rs    |  84 +-
 .../ibc/src/clients/ics07_tendermint/mod.rs   |   2 +-
 crates/ibc/src/core/events.rs                 |   5 +-
 crates/ibc/src/core/handler.rs                | 664 ------------
 crates/ibc/src/core/ics02_client/events.rs    |   7 +-
 .../ics02_client/handler/create_client.rs     |  96 --
 .../ics02_client/handler/update_client.rs     | 944 -----------------
 .../ics02_client/handler/upgrade_client.rs    | 156 ---
 .../core/ics02_client/msgs/create_client.rs   |  23 +-
 .../core/ics02_client/msgs/update_client.rs   |  29 +-
 .../core/ics02_client/msgs/upgrade_client.rs  |  57 +-
 .../src/core/ics03_connection/connection.rs   |   4 +-
 .../ibc/src/core/ics03_connection/handler.rs  |  39 -
 .../ics03_connection/handler/conn_open_ack.rs | 186 ----
 .../handler/conn_open_confirm.rs              | 122 ---
 .../handler/conn_open_init.rs                 | 137 ---
 .../ics03_connection/handler/conn_open_try.rs | 147 ---
 crates/ibc/src/core/ics03_connection/msgs.rs  |  24 -
 .../ics03_connection/msgs/conn_open_ack.rs    |  59 +-
 .../msgs/conn_open_confirm.rs                 |  36 +-
 .../ics03_connection/msgs/conn_open_init.rs   |  82 +-
 .../ics03_connection/msgs/conn_open_try.rs    |  89 +-
 crates/ibc/src/core/ics04_channel/channel.rs  |  40 +-
 .../ibc/src/core/ics04_channel/commitment.rs  |   4 +-
 .../ics04_channel/handler/acknowledgement.rs  | 265 -----
 .../handler/chan_close_confirm.rs             | 135 ---
 .../ics04_channel/handler/chan_close_init.rs  | 136 ---
 .../ics04_channel/handler/chan_open_ack.rs    | 236 -----
 .../handler/chan_open_confirm.rs              | 210 ----
 .../ics04_channel/handler/chan_open_init.rs   | 126 ---
 .../ics04_channel/handler/chan_open_try.rs    | 165 ---
 .../core/ics04_channel/handler/recv_packet.rs | 243 -----
 .../core/ics04_channel/handler/send_packet.rs | 191 ----
 .../src/core/ics04_channel/handler/timeout.rs | 426 --------
 .../ics04_channel/handler/timeout_on_close.rs | 163 ---
 crates/ibc/src/core/ics04_channel/msgs.rs     |  20 +-
 .../ics04_channel/msgs/acknowledgement.rs     |  41 +-
 .../ics04_channel/msgs/chan_close_confirm.rs  |  30 +-
 .../ics04_channel/msgs/chan_close_init.rs     |  24 +-
 .../core/ics04_channel/msgs/chan_open_ack.rs  |  32 +-
 .../ics04_channel/msgs/chan_open_confirm.rs   |  30 +-
 .../core/ics04_channel/msgs/chan_open_init.rs |  29 +-
 .../core/ics04_channel/msgs/chan_open_try.rs  |  34 +-
 .../core/ics04_channel/msgs/recv_packet.rs    |  61 +-
 .../src/core/ics04_channel/msgs/timeout.rs    |  39 +-
 .../ics04_channel/msgs/timeout_on_close.rs    |  34 +-
 crates/ibc/src/core/ics04_channel/packet.rs   |  40 +-
 .../src/core/ics23_commitment/commitment.rs   |  17 -
 crates/ibc/src/core/ics24_host/identifier.rs  |   7 -
 crates/ibc/src/core/ics24_host/path.rs        |  64 +-
 crates/ibc/src/lib.rs                         |   9 +-
 crates/ibc/src/mock/ics18_relayer/mod.rs      |   4 -
 crates/ibc/src/mock/mod.rs                    |  18 -
 crates/ibc/src/mock/router.rs                 |  56 -
 crates/ibc/src/test_utils.rs                  | 222 ----
 crates/ibc/src/utils/mod.rs                   |   1 -
 164 files changed, 7829 insertions(+), 7310 deletions(-)
 create mode 100644 .changelog/unreleased/features/954-restructure-mock-module-into-crate.md
 create mode 100644 .changelog/unreleased/improvements/951-remove-default-portid.md
 create mode 100644 .changelog/unreleased/improvements/952-expose-channel-message-types copy.md
 create mode 100644 crates/ibc-testkit/Cargo.toml
 create mode 100644 crates/ibc-testkit/README.md
 rename crates/{ibc/src/mock/host.rs => ibc-testkit/src/hosts/block.rs} (87%)
 create mode 100644 crates/ibc-testkit/src/hosts/mod.rs
 create mode 100644 crates/ibc-testkit/src/lib.rs
 rename crates/{ibc/src/mock/ics18_relayer => ibc-testkit/src/relayer}/context.rs (83%)
 rename crates/{ibc/src/mock/ics18_relayer => ibc-testkit/src/relayer}/error.rs (91%)
 create mode 100644 crates/ibc-testkit/src/relayer/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/applications/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
 rename crates/{ibc/src => ibc-testkit/src/testapp/ibc/clients}/mock/client_state.rs (92%)
 rename crates/{ibc/src => ibc-testkit/src/testapp/ibc/clients}/mock/consensus_state.rs (85%)
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs
 rename crates/{ibc/src => ibc-testkit/src/testapp/ibc/clients}/mock/header.rs (86%)
 rename crates/{ibc/src => ibc-testkit/src/testapp/ibc/clients}/mock/misbehaviour.rs (88%)
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/clients/mod.rs
 rename crates/{ibc/src/mock/context/clients.rs => ibc-testkit/src/testapp/ibc/core/client_ctx.rs} (87%)
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/core/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/core/router/context.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/core/router/types.rs
 rename crates/{ibc/src/mock/context.rs => ibc-testkit/src/testapp/ibc/core/types.rs} (59%)
 create mode 100644 crates/ibc-testkit/src/testapp/ibc/mod.rs
 create mode 100644 crates/ibc-testkit/src/testapp/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/applications/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/applications/transfer.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/clients/mock.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/clients/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/client/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/commitment.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/context.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/core/signer.rs
 create mode 100644 crates/ibc-testkit/src/utils/dummies/mod.rs
 create mode 100644 crates/ibc-testkit/src/utils/fixture.rs
 create mode 100644 crates/ibc-testkit/src/utils/mod.rs
 create mode 100644 crates/ibc-testkit/tests/applications/mod.rs
 create mode 100644 crates/ibc-testkit/tests/applications/transfer.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics02_client/create_client.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics02_client/mod.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics02_client/update_client.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics03_connection/mod.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/mod.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/timeout.rs
 create mode 100644 crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
 create mode 100644 crates/ibc-testkit/tests/core/mod.rs
 create mode 100644 crates/ibc-testkit/tests/core/router.rs
 rename crates/{ibc/tests/support/query/serialization => ibc-testkit/tests/data/json}/client_state.json (100%)
 rename crates/{ibc/tests/support/query/serialization => ibc-testkit/tests/data/json}/client_state_proof.json (100%)
 rename crates/{ibc/tests/support/query/serialization => ibc-testkit/tests/data/json}/consensus_state.json (100%)
 rename crates/{ibc/tests/support/query/serialization => ibc-testkit/tests/data/json}/consensus_state_proof.json (100%)
 rename crates/{ibc/tests/support => ibc-testkit/tests/data/json}/signed_header.json (100%)
 create mode 100644 crates/ibc-testkit/tests/mod.rs
 delete mode 100644 crates/ibc/src/mock/ics18_relayer/mod.rs
 delete mode 100644 crates/ibc/src/mock/mod.rs
 delete mode 100644 crates/ibc/src/mock/router.rs
 delete mode 100644 crates/ibc/src/test_utils.rs

diff --git a/.changelog/unreleased/features/954-restructure-mock-module-into-crate.md b/.changelog/unreleased/features/954-restructure-mock-module-into-crate.md
new file mode 100644
index 000000000..266600f91
--- /dev/null
+++ b/.changelog/unreleased/features/954-restructure-mock-module-into-crate.md
@@ -0,0 +1,3 @@
+- Restructure the mock module implementation and separate its codebase into a
+  new crate named `ibc-testkit`
+  ([\#954](https://github.com/cosmos/ibc-rs/issues/953))
diff --git a/.changelog/unreleased/improvements/951-remove-default-portid.md b/.changelog/unreleased/improvements/951-remove-default-portid.md
new file mode 100644
index 000000000..f9f586add
--- /dev/null
+++ b/.changelog/unreleased/improvements/951-remove-default-portid.md
@@ -0,0 +1,2 @@
+- Remove the default value and implementation for `PortId`
+  ([\#951](https://github.com/cosmos/ibc-rs/issues/951))
diff --git a/.changelog/unreleased/improvements/952-expose-channel-message-types copy.md b/.changelog/unreleased/improvements/952-expose-channel-message-types copy.md
new file mode 100644
index 000000000..e0a0ccbf2
--- /dev/null
+++ b/.changelog/unreleased/improvements/952-expose-channel-message-types copy.md	
@@ -0,0 +1,2 @@
+- Expose domain message types under the `ics04_channel` as public
+  ([\#952](https://github.com/cosmos/ibc-rs/issues/952))
diff --git a/.gitignore b/.gitignore
index fad389dbc..a7c66805b 100644
--- a/.gitignore
+++ b/.gitignore
@@ -14,9 +14,6 @@ target/
 # Ignore VisualStudio
 .vscode
 
-# Ignore chain's data
-data
-
 # Ignore Python artifacts
 .mypy_cache/
 __pycache__/
diff --git a/Cargo.toml b/Cargo.toml
index 5d7413065..87820e6e9 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -5,6 +5,7 @@ resolver = "2"
 members = [
     "crates/ibc",
     "crates/ibc-derive",
+    "crates/ibc-testkit",
     "crates/ibc-query",
 ]
 
diff --git a/README.md b/README.md
index 2654f16d5..ac2cfd9fc 100644
--- a/README.md
+++ b/README.md
@@ -29,10 +29,11 @@ the `ibc` rust crate which defines the main data structures and on-chain logic f
 ## Libraries
 
 - [ibc](crates/ibc/README.md) - Data structures and on-chain logic for the IBC protocol.
-- [ibc-query](crates/ibc-query/README.md) - Utility traits and implementations for querying the
-state of an `ibc-rs` enabled chain.
 - [ibc-derive](crates/ibc-derive/README.md) - Derive macros for `ClientState`
   and `ConsensusState` traits, reducing boilerplate.
+- [ibc-testkit](crates/ibc-testkit/README.md) - Testing toolkit to aid `ibc-rs` and host chains in writing integration tests.
+- [ibc-query](crates/ibc-query/README.md) - Utility traits and implementations for querying the
+state of an `ibc-rs` enabled chain.
 
 ## Contributing
 
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 86bab468e..440218f08 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -98,6 +98,135 @@ version = "1.0.75"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a4668cab20f66d8d020e1fbc0ebe47217433c1b6c8f2040faf858554e394ace6"
 
+[[package]]
+name = "ark-bls12-377"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fb00293ba84f51ce3bd026bd0de55899c4e68f0a39a5728cebae3a73ffdc0a4f"
+dependencies = [
+ "ark-ec",
+ "ark-ff",
+ "ark-std",
+]
+
+[[package]]
+name = "ark-bls12-381"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c775f0d12169cba7aae4caeb547bb6a50781c7449a8aa53793827c9ec4abf488"
+dependencies = [
+ "ark-ec",
+ "ark-ff",
+ "ark-serialize",
+ "ark-std",
+]
+
+[[package]]
+name = "ark-ec"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "defd9a439d56ac24968cca0571f598a61bc8c55f71d50a89cda591cb750670ba"
+dependencies = [
+ "ark-ff",
+ "ark-poly",
+ "ark-serialize",
+ "ark-std",
+ "derivative",
+ "hashbrown 0.13.2",
+ "itertools 0.10.5",
+ "num-traits",
+ "zeroize",
+]
+
+[[package]]
+name = "ark-ff"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ec847af850f44ad29048935519032c33da8aa03340876d351dfab5660d2966ba"
+dependencies = [
+ "ark-ff-asm",
+ "ark-ff-macros",
+ "ark-serialize",
+ "ark-std",
+ "derivative",
+ "digest 0.10.7",
+ "itertools 0.10.5",
+ "num-bigint",
+ "num-traits",
+ "paste",
+ "rustc_version",
+ "zeroize",
+]
+
+[[package]]
+name = "ark-ff-asm"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3ed4aa4fe255d0bc6d79373f7e31d2ea147bcf486cba1be5ba7ea85abdb92348"
+dependencies = [
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "ark-ff-macros"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7abe79b0e4288889c4574159ab790824d0033b9fdcb2a112a3182fac2e514565"
+dependencies = [
+ "num-bigint",
+ "num-traits",
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "ark-poly"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d320bfc44ee185d899ccbadfa8bc31aab923ce1558716e1997a1e74057fe86bf"
+dependencies = [
+ "ark-ff",
+ "ark-serialize",
+ "ark-std",
+ "derivative",
+ "hashbrown 0.13.2",
+]
+
+[[package]]
+name = "ark-serialize"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "adb7b85a02b83d2f22f89bd5cac66c9c89474240cb6207cb1efc16d098e822a5"
+dependencies = [
+ "ark-serialize-derive",
+ "ark-std",
+ "digest 0.10.7",
+ "num-bigint",
+]
+
+[[package]]
+name = "ark-serialize-derive"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae3281bc6d0fd7e549af32b52511e1302185bd688fd3359fa36423346ff682ea"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
+[[package]]
+name = "ark-std"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94893f1e0c6eeab764ade8dc4c0db24caf4fe7cbbaafc0eba0a9030f447b5185"
+dependencies = [
+ "num-traits",
+ "rand 0.8.5",
+]
+
 [[package]]
 name = "array-bytes"
 version = "6.1.0"
@@ -391,6 +520,12 @@ version = "0.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f7144d30dcf0fafbce74250a3963025d8d52177934239851c917d29f1df280c2"
 
+[[package]]
+name = "constcat"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cd7e35aee659887cbfb97aaf227ac12cad1a9d7c71e55ff3376839ed4e282d08"
+
 [[package]]
 name = "core-foundation-sys"
 version = "0.8.4"
@@ -509,6 +644,7 @@ dependencies = [
  "platforms",
  "rustc_version",
  "subtle",
+ "zeroize",
 ]
 
 [[package]]
@@ -586,6 +722,17 @@ version = "0.3.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f2696e8a945f658fd14dc3b87242e6b80cd0f36ff04ea560fa39082368847946"
 
+[[package]]
+name = "derivative"
+version = "2.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "fcc3dd5e9e9c0b295d6e1e4d811fb6f157d5ffd784b8d202fc62eac8035a770b"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
 [[package]]
 name = "derive_more"
 version = "0.99.17"
@@ -695,7 +842,9 @@ checksum = "7277392b266383ef8396db7fdeb1e77b6c52fed775f5df15bb24f35b72156980"
 dependencies = [
  "curve25519-dalek 4.1.1",
  "ed25519",
+ "serde",
  "sha2 0.10.8",
+ "zeroize",
 ]
 
 [[package]]
@@ -1072,7 +1221,6 @@ dependencies = [
  "ibc-derive",
  "ibc-proto",
  "ics23",
- "num-traits",
  "primitive-types",
  "prost",
  "serde",
@@ -1084,7 +1232,6 @@ dependencies = [
  "tendermint-light-client-verifier",
  "tendermint-proto",
  "time",
- "tracing",
  "uint",
 ]
 
@@ -1230,6 +1377,15 @@ dependencies = [
  "windows-sys 0.48.0",
 ]
 
+[[package]]
+name = "itertools"
+version = "0.10.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473"
+dependencies = [
+ "either",
+]
+
 [[package]]
 name = "itertools"
 version = "0.11.0"
@@ -1445,6 +1601,17 @@ version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2bf50223579dc7cdcfb3bfcacf7069ff68243f8c363f62ffa99cf000a6b9c451"
 
+[[package]]
+name = "num-bigint"
+version = "0.4.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "608e7659b5c3d7cba262d894801b9ec9d00de989e8a82bd4bef91d08da45cdc0"
+dependencies = [
+ "autocfg",
+ "num-integer",
+ "num-traits",
+]
+
 [[package]]
 name = "num-derive"
 version = "0.3.3"
@@ -1466,6 +1633,16 @@ dependencies = [
  "itoa",
 ]
 
+[[package]]
+name = "num-integer"
+version = "0.1.45"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "225d3389fb3509a24c93f5c29eb6bde2586b98d9f016636dff58d7c6f7569cd9"
+dependencies = [
+ "autocfg",
+ "num-traits",
+]
+
 [[package]]
 name = "num-traits"
 version = "0.2.17"
@@ -1696,7 +1873,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "265baba7fabd416cf5078179f7d2cbeca4ce7a9041111900675ea7c4cb8a4c32"
 dependencies = [
  "anyhow",
- "itertools",
+ "itertools 0.11.0",
  "proc-macro2",
  "quote",
  "syn 2.0.38",
@@ -1956,9 +2133,9 @@ checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
 
 [[package]]
 name = "scale-info"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "35c0a159d0c45c12b20c5a844feb1fe4bea86e28f17b92a5f0c42193634d3782"
+checksum = "7f7d66a1128282b7ef025a8ead62a4a9fcf017382ec53b8ffbf4d7bf77bd3c60"
 dependencies = [
  "bitvec",
  "cfg-if",
@@ -1970,9 +2147,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "912e55f6d20e0e80d63733872b40e1227c0bce1e1ab81ba67d696339bfd7fd29"
+checksum = "abf2c68b89cafb3b8d918dd07b42be0da66ff202cf1155c5739a4e0c1ea0dc19"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -2186,9 +2363,9 @@ checksum = "942b4a808e05215192e39f4ab80813e599068285906cc91aa64f923db842bd5a"
 
 [[package]]
 name = "sp-application-crypto"
-version = "26.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b74454c936a45ac55c8de95b9fd8b5e38f8b43d97df8f4274dd6777b20d95569"
+checksum = "a93da025616ab59639f8e378df579c5aaa2c8b9999f328a0239156a57c991b53"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2200,9 +2377,9 @@ dependencies = [
 
 [[package]]
 name = "sp-arithmetic"
-version = "19.0.0"
+version = "20.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e41f710a77e9debd1c9b80f862709dce648e50f0904cde4117488e7d11d4796d"
+checksum = "f80b5c16afb61dde1037a469d570adcc686440036429e50abe2301ba9d61aad5"
 dependencies = [
  "integer-sqrt",
  "num-traits",
@@ -2215,9 +2392,9 @@ dependencies = [
 
 [[package]]
 name = "sp-core"
-version = "24.0.0"
+version = "25.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7921d278ed2aebbb21a644c96e09663dc49a6139d1e2e063c059dc9f866e149b"
+checksum = "f9ebb090ead698a6df04347c86a31ba91a387edb8a58534ec70c4f977d1e1e87"
 dependencies = [
  "array-bytes",
  "bitflags 1.3.2",
@@ -2256,14 +2433,15 @@ dependencies = [
  "thiserror",
  "tiny-bip39",
  "tracing",
+ "w3f-bls",
  "zeroize",
 ]
 
 [[package]]
 name = "sp-core-hashing"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a7cb5c31aa385d6997a5b73fdc9837c1c0145559205198555c3000739a474767"
+checksum = "cb8524f01591ee58b46cd83c9dbc0fcffd2fd730dabec4f59326cd58a00f17e2"
 dependencies = [
  "blake2b_simd",
  "byteorder",
@@ -2275,9 +2453,9 @@ dependencies = [
 
 [[package]]
 name = "sp-debug-derive"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16f7d375610590566e11882bf5b5a4b8d0666a96ba86808b2650bbbd9be50bf8"
+checksum = "50535e1a5708d3ba5c1195b59ebefac61cc8679c2c24716b87a86e8b7ed2e4a1"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2286,9 +2464,9 @@ dependencies = [
 
 [[package]]
 name = "sp-externalities"
-version = "0.22.0"
+version = "0.23.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ede074871514ca7c5d2eca9563515d858c6220b47ae815714ed4393a4e99db4a"
+checksum = "884d05160bc89d0943d1c9fb8006c3d44b80f37f8af607aeff8d4d9cc82e279a"
 dependencies = [
  "environmental",
  "parity-scale-codec",
@@ -2298,9 +2476,9 @@ dependencies = [
 
 [[package]]
 name = "sp-io"
-version = "26.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "88fb6e281de5054565f07a9f79504d21133e115db549993c99f1b21236c677a5"
+checksum = "0ced350da15e8ba3a106206840acc42a6d3eb0d7e8bf7aa43ab00eac0bdf956f"
 dependencies = [
  "bytes",
  "ed25519-dalek",
@@ -2323,9 +2501,9 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.30.0"
+version = "0.31.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8b9f19e773319d96223ce8dba960267e6cb977907537a8f738746ceb86592413"
+checksum = "8b8ec5ebbba70bee83d79c3fe5e49f12df0a4bb6029858ddf9a15eea7539a592"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
@@ -2336,9 +2514,9 @@ dependencies = [
 
 [[package]]
 name = "sp-panic-handler"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cd099ba2d6c1bfe5d0c79aa56e440fa3c9257eadfc0c782c09cdc2122b1e60ed"
+checksum = "b00e40857ed3e0187f145b037c733545c5633859f1bd1d1b09deb52805fa696a"
 dependencies = [
  "backtrace",
  "lazy_static",
@@ -2347,9 +2525,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "27.0.0"
+version = "28.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46c0641e1a9d340960b562bcceea1457680fd0e109fc1040f8f5364fd7bc2506"
+checksum = "6d9c40ff7303e62219b55635e5245d963358cb77d6916250991ebcb82c0be2c6"
 dependencies = [
  "either",
  "hash256-std-hasher",
@@ -2370,9 +2548,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface"
-version = "20.0.0"
+version = "21.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "17a4030ad93f05c93f2cc294c74bc5fea227f90fb3d1426d4a6f165e017fb7ea"
+checksum = "4f365332922a8cfa98ab00c6d08b1b0f24e159e730dd554e720d950ff3371b1f"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
@@ -2389,9 +2567,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "14.0.0"
+version = "15.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b232943ee7ca83a6d56face33b8af12e9fb470a15a53835f4e12a6e452a41c1c"
+checksum = "9b2afcbd1bd18d323371111b66b7ac2870bdc1c86c3d7b0dae67b112ca52b4d8"
 dependencies = [
  "Inflector",
  "proc-macro-crate 1.3.1",
@@ -2402,9 +2580,9 @@ dependencies = [
 
 [[package]]
 name = "sp-state-machine"
-version = "0.31.0"
+version = "0.32.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2bf4c76bea1a9e4a2e79afe70f42f1d368a8a45308e58f19bfd755c5ddb2b4a3"
+checksum = "96e087fa4430befd2047b61d912c9d6fa4eaed408c4b58b46c6e9acd7965f2d3"
 dependencies = [
  "hash-db",
  "log",
@@ -2424,15 +2602,15 @@ dependencies = [
 
 [[package]]
 name = "sp-std"
-version = "11.0.0"
+version = "12.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8c91d32e165d08a14098ce5ec923eaec59d1d0583758a18a770beec1b780b0d0"
+checksum = "54c78c5a66682568cc7b153603c5d01a2cc8f5c221c7b1e921517a0eef18ae05"
 
 [[package]]
 name = "sp-storage"
-version = "16.0.0"
+version = "17.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac9660ecd48314443e73ad0f44d58b76426666a1343d72f6f65664e174da9244"
+checksum = "016f20812cc51bd479cc88d048c35d44cd3adde4accdb159d49d6050f2953595"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
@@ -2444,9 +2622,9 @@ dependencies = [
 
 [[package]]
 name = "sp-tracing"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "69a61948986d2a9f8d67d60884ff0277d910df09ebe08d0e1f309da777516453"
+checksum = "0d727cb5265641ffbb7d4e42c18b63e29f6cfdbd240aae3bcf093c3d6eb29a19"
 dependencies = [
  "parity-scale-codec",
  "sp-std",
@@ -2457,9 +2635,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "25.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4bb2d292eb90452dcb0909fb44e74bf04395e3ffa37a66c0f1635a00600382a4"
+checksum = "1e359b358263cc322c3f678c272a3a519621d9853dcfa1374dfcbdb5f54c6f85"
 dependencies = [
  "ahash 0.8.3",
  "hash-db",
@@ -2469,6 +2647,7 @@ dependencies = [
  "nohash-hasher",
  "parity-scale-codec",
  "parking_lot",
+ "rand 0.8.5",
  "scale-info",
  "schnellru",
  "sp-core",
@@ -2481,9 +2660,9 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "17.0.0"
+version = "18.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bf43bb0c8eb76dc41057ce0fb6b744b94c9aec28b31dff53a1efc4f04ef25384"
+checksum = "d5d85813d46a22484cdf5e5afddbbe85442dd1b4d84d67a8c7792f92f9f93607"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
@@ -2495,9 +2674,9 @@ dependencies = [
 
 [[package]]
 name = "sp-weights"
-version = "23.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4e1cef0aad13ed8a8522a6e86ace16fb97ab220c16d2357e628352b528582693"
+checksum = "751676c1263e7f3600af16bad26a7978a816bc532676fe05eafa23b862c05b9e"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2798,11 +2977,10 @@ dependencies = [
 
 [[package]]
 name = "tracing"
-version = "0.1.37"
+version = "0.1.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ce8c33a8d48bd45d624a6e523445fd21ec13d3653cd51f681abf67418f54eb8"
+checksum = "c3523ab5a71916ccf420eebdf5521fcef02141234bbc0b8a49f2fdc4544364ef"
 dependencies = [
- "cfg-if",
  "pin-project-lite",
  "tracing-attributes",
  "tracing-core",
@@ -2810,9 +2988,9 @@ dependencies = [
 
 [[package]]
 name = "tracing-attributes"
-version = "0.1.26"
+version = "0.1.27"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f4f31f56159e98206da9efd823404b79b6ef3143b4a7ab76e67b1751b25a4ab"
+checksum = "34704c8d6ebcbc939824180af020566b01a7c01f80641264eba0999f6c2b6be7"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2821,9 +2999,9 @@ dependencies = [
 
 [[package]]
 name = "tracing-core"
-version = "0.1.31"
+version = "0.1.32"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0955b8137a1df6f1a2e9a37d8a6656291ff0297c1a97c24e0d8425fe2312f79a"
+checksum = "c06d3da6113f116aaee68e4d601191614c9053067f9ab7f6edbcb161237daa54"
 dependencies = [
  "once_cell",
  "valuable",
@@ -2974,6 +3152,30 @@ version = "0.9.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "49874b5167b65d7193b8aba1567f5c7d93d001cafc34600cee003eda787e483f"
 
+[[package]]
+name = "w3f-bls"
+version = "0.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7335e4c132c28cc43caef6adb339789e599e39adbe78da0c4d547fad48cbc331"
+dependencies = [
+ "ark-bls12-377",
+ "ark-bls12-381",
+ "ark-ec",
+ "ark-ff",
+ "ark-serialize",
+ "ark-serialize-derive",
+ "arrayref",
+ "constcat",
+ "digest 0.10.7",
+ "rand 0.8.5",
+ "rand_chacha 0.3.1",
+ "rand_core 0.6.4",
+ "sha2 0.10.8",
+ "sha3",
+ "thiserror",
+ "zeroize",
+]
+
 [[package]]
 name = "wasi"
 version = "0.9.0+wasi-snapshot-preview1"
diff --git a/crates/ibc-derive/src/utils.rs b/crates/ibc-derive/src/utils.rs
index fca155424..333c18da2 100644
--- a/crates/ibc-derive/src/utils.rs
+++ b/crates/ibc-derive/src/utils.rs
@@ -58,7 +58,7 @@ impl Imports {
     }
 
     pub fn Any() -> TokenStream {
-        quote! {ibc_proto::google::protobuf::Any}
+        quote! {ibc::proto::Any}
     }
 
     pub fn Timestamp() -> TokenStream {
diff --git a/crates/ibc-testkit/Cargo.toml b/crates/ibc-testkit/Cargo.toml
new file mode 100644
index 000000000..cdb496220
--- /dev/null
+++ b/crates/ibc-testkit/Cargo.toml
@@ -0,0 +1,51 @@
+[package]
+name         = "ibc-testkit"
+version      = "0.47.0"
+edition      = "2021"
+readme       = "README.md"
+keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
+repository   = "https://github.com/cosmos/ibc-rs"
+authors      = ["Informal Systems <hello@informal.systems>"]
+rust-version = "1.60"
+description  = """
+    `ibc-testkit` is a versatile library that provides essential abstractions and implementations, 
+    fulfilling a dual role of enabling rigorous integration testing for the `ibc-rs` implementation 
+    while also aiding host chains in addressing a broad spectrum of testing scenarios during 
+    their integration with `ibc-rs`.
+"""
+
+[features]
+default = ["std"]
+std = [
+    "ibc/std",
+    "tracing/std",
+    "prost/std",
+    "serde/std",
+    "serde_json/std",
+]
+
+# This feature is required for token transfer (ICS-20)
+serde = ["dep:serde", "ibc/serde", "serde_json"]
+
+[dependencies]
+bytes = { version = "1.2.1", default-features = false }
+derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
+displaydoc = { version = "0.2", default-features = false }
+ibc = { version = "0.47.0" , path = "../ibc" } # NOTE: since `ibc-testkit` does not well support `no_std` yet, we keep `ibc` default features enabled
+parking_lot = { version = "0.12.1", default-features = false }
+prost = { version = "0.12", default-features = false }
+serde = { version = "1.0", default-features = false, optional = true }
+serde_json = { version = "1", default-features = false, optional = true }
+subtle-encoding = { version = "0.5", default-features = false }
+tendermint = { version = "0.34", default-features = false }
+tendermint-testgen = { version = "0.34", default-features = false }
+tracing = { version = "0.1.36", default-features = false }
+typed-builder = "0.18.0"
+primitive-types = { version = "0.12.0", default-features = false, features = ["serde_no_std"] }
+
+
+[dev-dependencies]
+env_logger = "0.10.0"
+rstest = "0.18.1"
+tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
+test-log = { version = "0.2.10", features = ["trace"] }
diff --git a/crates/ibc-testkit/README.md b/crates/ibc-testkit/README.md
new file mode 100644
index 000000000..28b23dcd7
--- /dev/null
+++ b/crates/ibc-testkit/README.md
@@ -0,0 +1,6 @@
+# `ibc-testkit`
+
+`ibc-testkit` is a versatile library that provides essential abstractions and
+implementations, fulfilling a dual role of enabling rigorous integration testing
+for the `ibc-rs` implementation while also aiding host chains in addressing a
+broad spectrum of testing scenarios during their integration with `ibc-rs`.
diff --git a/crates/ibc/src/mock/host.rs b/crates/ibc-testkit/src/hosts/block.rs
similarity index 87%
rename from crates/ibc/src/mock/host.rs
rename to crates/ibc-testkit/src/hosts/block.rs
index e54e76e93..986ca56ee 100644
--- a/crates/ibc/src/mock/host.rs
+++ b/crates/ibc-testkit/src/hosts/block.rs
@@ -2,9 +2,15 @@
 
 use core::str::FromStr;
 
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
-use ibc_proto::Protobuf as ErasedProtobuf;
+use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::clients::ics07_tendermint::header::{Header, TENDERMINT_HEADER_TYPE_URL};
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics24_host::identifier::ChainId;
+use ibc::core::timestamp::Timestamp;
+use ibc::prelude::*;
+use ibc::proto::tendermint::v1::Header as RawHeader;
+use ibc::proto::{Any, Protobuf};
+use ibc::Height;
 use tendermint::block::Header as TmHeader;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint_testgen::light_block::TmLightBlock;
@@ -13,16 +19,9 @@ use tendermint_testgen::{
     Validator as TestgenValidator,
 };
 
-use super::context::AnyConsensusState;
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::header::TENDERMINT_HEADER_TYPE_URL;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ChainId;
-use crate::core::timestamp::Timestamp;
-use crate::mock::consensus_state::MockConsensusState;
-use crate::mock::header::MockHeader;
-use crate::prelude::*;
-use crate::Height;
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::testapp::ibc::clients::AnyConsensusState;
 
 /// Defines the different types of host chains that a mock context can emulate.
 /// The variants are as follows:
@@ -49,6 +48,22 @@ impl SyntheticTmBlock {
     }
 }
 
+impl From<SyntheticTmBlock> for Header {
+    fn from(light_block: SyntheticTmBlock) -> Self {
+        let SyntheticTmBlock {
+            trusted_height,
+            trusted_next_validators,
+            light_block,
+        } = light_block;
+        Self {
+            signed_header: light_block.signed_header,
+            validator_set: light_block.validators,
+            trusted_height,
+            trusted_next_validator_set: trusted_next_validators,
+        }
+    }
+}
+
 /// Depending on `HostType` (the type of host chain underlying a context mock), this enum defines
 /// the type of blocks composing the history of the host chain.
 #[cfg_attr(feature = "serde", derive(serde::Serialize))]
@@ -205,7 +220,7 @@ impl From<HostBlock> for AnyConsensusState {
     }
 }
 
-impl ErasedProtobuf<Any> for HostBlock {}
+impl Protobuf<Any> for HostBlock {}
 
 impl TryFrom<Any> for HostBlock {
     type Error = ClientError;
diff --git a/crates/ibc-testkit/src/hosts/mod.rs b/crates/ibc-testkit/src/hosts/mod.rs
new file mode 100644
index 000000000..a863eaad2
--- /dev/null
+++ b/crates/ibc-testkit/src/hosts/mod.rs
@@ -0,0 +1 @@
+pub mod block;
diff --git a/crates/ibc-testkit/src/lib.rs b/crates/ibc-testkit/src/lib.rs
new file mode 100644
index 000000000..3b42e390e
--- /dev/null
+++ b/crates/ibc-testkit/src/lib.rs
@@ -0,0 +1,20 @@
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![no_std]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+#![forbid(unsafe_code)]
+
+extern crate alloc;
+
+extern crate std;
+
+pub mod hosts;
+pub mod relayer;
+pub mod testapp;
+pub mod utils;
diff --git a/crates/ibc/src/mock/ics18_relayer/context.rs b/crates/ibc-testkit/src/relayer/context.rs
similarity index 83%
rename from crates/ibc/src/mock/ics18_relayer/context.rs
rename to crates/ibc-testkit/src/relayer/context.rs
index 735650cca..72090614f 100644
--- a/crates/ibc/src/mock/ics18_relayer/context.rs
+++ b/crates/ibc-testkit/src/relayer/context.rs
@@ -1,9 +1,10 @@
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ContextError;
-use crate::mock::context::AnyClientState;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::{ContextError, ValidationContext};
+use ibc::prelude::*;
+use ibc::{Height, Signer};
+
+use crate::testapp::ibc::clients::AnyClientState;
+use crate::testapp::ibc::core::types::MockContext;
 
 /// Trait capturing all dependencies (i.e., the context) which algorithms in ICS18 require to
 /// relay packets between chains. This trait comprises the dependencies towards a single chain.
@@ -22,25 +23,42 @@ pub trait RelayerContext {
     fn signer(&self) -> Signer;
 }
 
+impl RelayerContext for MockContext {
+    fn query_latest_height(&self) -> Result<Height, ContextError> {
+        ValidationContext::host_height(self)
+    }
+
+    fn query_client_full_state(&self, client_id: &ClientId) -> Option<AnyClientState> {
+        // Forward call to Ics2.
+        self.client_state(client_id).ok()
+    }
+
+    fn signer(&self) -> Signer {
+        "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
+            .to_string()
+            .into()
+    }
+}
+
 #[cfg(test)]
 mod tests {
+    use ibc::clients::ics07_tendermint::client_type as tm_client_type;
+    use ibc::core::ics02_client::client_state::ClientStateCommon;
+    use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
+    use ibc::core::ics02_client::msgs::ClientMsg;
+    use ibc::core::ics24_host::identifier::{ChainId, ClientId};
+    use ibc::core::MsgEnvelope;
+    use ibc::prelude::*;
+    use ibc::Height;
     use test_log::test;
     use tracing::debug;
 
-    use crate::clients::ics07_tendermint::client_type as tm_client_type;
-    use crate::core::ics02_client::client_state::ClientStateCommon;
-    use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
-    use crate::core::ics02_client::msgs::ClientMsg;
-    use crate::core::ics24_host::identifier::{ChainId, ClientId};
-    use crate::core::MsgEnvelope;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::host::{HostBlock, HostType};
-    use crate::mock::ics18_relayer::context::RelayerContext;
-    use crate::mock::ics18_relayer::error::RelayerError;
-    use crate::mock::router::MockRouter;
-    use crate::prelude::*;
-    use crate::Height;
+    use super::RelayerContext;
+    use crate::hosts::block::{HostBlock, HostType};
+    use crate::relayer::error::RelayerError;
+    use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+    use crate::testapp::ibc::core::router::MockRouter;
+    use crate::testapp::ibc::core::types::MockContext;
 
     /// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
     /// context, assuming that the latest header on the source context is `src_header`.
@@ -114,7 +132,7 @@ mod tests {
                     Some(client_on_a_for_b_height),
                 );
         // dummy; not actually used in client updates
-        let mut router_a = MockRouter::default();
+        let mut router_a = MockRouter::new_with_transfer();
 
         let mut ctx_b = MockContext::new(
             chain_id_b,
@@ -130,7 +148,7 @@ mod tests {
             Some(client_on_b_for_a_height),
         );
         // dummy; not actually used in client updates
-        let mut router_b = MockRouter::default();
+        let mut router_b = MockRouter::new_with_transfer();
 
         for _i in 0..num_iterations {
             // Update client on chain B to latest height of A.
diff --git a/crates/ibc/src/mock/ics18_relayer/error.rs b/crates/ibc-testkit/src/relayer/error.rs
similarity index 91%
rename from crates/ibc/src/mock/ics18_relayer/error.rs
rename to crates/ibc-testkit/src/relayer/error.rs
index 43dedd7b5..3fdf5296a 100644
--- a/crates/ibc/src/mock/ics18_relayer/error.rs
+++ b/crates/ibc-testkit/src/relayer/error.rs
@@ -1,8 +1,7 @@
 use displaydoc::Display;
-
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::{ics03_connection, RouterError};
-use crate::Height;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::{ics03_connection, RouterError};
+use ibc::Height;
 
 #[derive(Debug, Display)]
 pub enum RelayerError {
diff --git a/crates/ibc-testkit/src/relayer/mod.rs b/crates/ibc-testkit/src/relayer/mod.rs
new file mode 100644
index 000000000..c2c641829
--- /dev/null
+++ b/crates/ibc-testkit/src/relayer/mod.rs
@@ -0,0 +1,2 @@
+pub mod context;
+pub mod error;
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/mod.rs b/crates/ibc-testkit/src/testapp/ibc/applications/mod.rs
new file mode 100644
index 000000000..014e52f27
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/applications/mod.rs
@@ -0,0 +1 @@
+pub mod transfer;
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
new file mode 100644
index 000000000..f8ec4ae88
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
@@ -0,0 +1,88 @@
+use ibc::applications::transfer::context::{
+    cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
+};
+use ibc::applications::transfer::error::TokenTransferError;
+use ibc::applications::transfer::PrefixedCoin;
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::prelude::*;
+use ibc::Signer;
+use subtle_encoding::bech32;
+
+use super::types::DummyTransferModule;
+
+impl TokenTransferValidationContext for DummyTransferModule {
+    type AccountId = Signer;
+
+    fn get_port(&self) -> Result<PortId, TokenTransferError> {
+        Ok(PortId::transfer())
+    }
+
+    fn get_escrow_account(
+        &self,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+    ) -> Result<Self::AccountId, TokenTransferError> {
+        let addr = cosmos_adr028_escrow_address(port_id, channel_id);
+        Ok(bech32::encode("cosmos", addr).into())
+    }
+
+    fn can_send_coins(&self) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn can_receive_coins(&self) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn send_coins_validate(
+        &self,
+        _from_account: &Self::AccountId,
+        _to_account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn mint_coins_validate(
+        &self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn burn_coins_validate(
+        &self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+}
+
+impl TokenTransferExecutionContext for DummyTransferModule {
+    fn send_coins_execute(
+        &mut self,
+        _from_account: &Self::AccountId,
+        _to_account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn mint_coins_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn burn_coins_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+}
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
new file mode 100644
index 000000000..7a971ee1d
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
@@ -0,0 +1,3 @@
+pub mod context;
+pub mod module;
+pub mod types;
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
new file mode 100644
index 000000000..d2c0d1dde
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
@@ -0,0 +1,106 @@
+use ibc::core::ics04_channel::acknowledgement::Acknowledgement;
+use ibc::core::ics04_channel::channel::{Counterparty, Order};
+use ibc::core::ics04_channel::error::{ChannelError, PacketError};
+use ibc::core::ics04_channel::packet::Packet;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use ibc::core::router::{Module, ModuleExtras};
+use ibc::prelude::*;
+use ibc::Signer;
+
+use super::types::DummyTransferModule;
+
+impl Module for DummyTransferModule {
+    fn on_chan_open_init_validate(
+        &self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        version: &Version,
+    ) -> Result<Version, ChannelError> {
+        Ok(version.clone())
+    }
+
+    fn on_chan_open_init_execute(
+        &mut self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        version: &Version,
+    ) -> Result<(ModuleExtras, Version), ChannelError> {
+        Ok((ModuleExtras::empty(), version.clone()))
+    }
+
+    fn on_chan_open_try_validate(
+        &self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        counterparty_version: &Version,
+    ) -> Result<Version, ChannelError> {
+        Ok(counterparty_version.clone())
+    }
+
+    fn on_chan_open_try_execute(
+        &mut self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        counterparty_version: &Version,
+    ) -> Result<(ModuleExtras, Version), ChannelError> {
+        Ok((ModuleExtras::empty(), counterparty_version.clone()))
+    }
+
+    fn on_recv_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Acknowledgement) {
+        (
+            ModuleExtras::empty(),
+            Acknowledgement::try_from(vec![1u8]).expect("Never fails"),
+        )
+    }
+
+    fn on_timeout_packet_validate(
+        &self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> Result<(), PacketError> {
+        Ok(())
+    }
+
+    fn on_timeout_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Result<(), PacketError>) {
+        (ModuleExtras::empty(), Ok(()))
+    }
+
+    fn on_acknowledgement_packet_validate(
+        &self,
+        _packet: &Packet,
+        _acknowledgement: &Acknowledgement,
+        _relayer: &Signer,
+    ) -> Result<(), PacketError> {
+        Ok(())
+    }
+
+    fn on_acknowledgement_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _acknowledgement: &Acknowledgement,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Result<(), PacketError>) {
+        (ModuleExtras::empty(), Ok(()))
+    }
+}
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
new file mode 100644
index 000000000..f5d91a531
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
@@ -0,0 +1,14 @@
+#[derive(Debug)]
+pub struct DummyTransferModule;
+
+impl DummyTransferModule {
+    pub fn new() -> Self {
+        Self
+    }
+}
+
+impl Default for DummyTransferModule {
+    fn default() -> Self {
+        Self::new()
+    }
+}
diff --git a/crates/ibc/src/mock/client_state.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
similarity index 92%
rename from crates/ibc/src/mock/client_state.rs
rename to crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 4fa159cc1..cc631b40c 100644
--- a/crates/ibc/src/mock/client_state.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -1,29 +1,28 @@
 use core::str::FromStr;
 use core::time::Duration;
 
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::mock::ClientState as RawMockClientState;
-use ibc_proto::Protobuf;
-
-use crate::core::ics02_client::client_state::{
+use ibc::core::ics02_client::client_state::{
     ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
 };
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
-use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use crate::core::ics23_commitment::commitment::{
+use ibc::core::ics02_client::client_type::ClientType;
+use ibc::core::ics02_client::error::{ClientError, UpgradeClientError};
+use ibc::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::ics23_commitment::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, Path};
-use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::mock::client_state::client_type as mock_client_type;
-use crate::mock::consensus_state::MockConsensusState;
-use crate::mock::header::MockHeader;
-use crate::mock::misbehaviour::Misbehaviour;
-use crate::prelude::*;
-use crate::Height;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, Path};
+use ibc::core::timestamp::Timestamp;
+use ibc::core::ContextError;
+use ibc::prelude::*;
+use ibc::proto::mock::ClientState as RawMockClientState;
+use ibc::proto::{Any, Protobuf};
+use ibc::Height;
+
+use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::testapp::ibc::clients::mock::misbehaviour::Misbehaviour;
 
 pub const MOCK_CLIENT_STATE_TYPE_URL: &str = "/ibc.mock.ClientState";
 pub const MOCK_CLIENT_TYPE: &str = "9999-mock";
@@ -87,7 +86,7 @@ impl TryFrom<RawMockClientState> for MockClientState {
 impl From<MockClientState> for RawMockClientState {
     fn from(value: MockClientState) -> Self {
         RawMockClientState {
-            header: Some(ibc_proto::ibc::mock::Header {
+            header: Some(ibc::proto::mock::Header {
                 height: Some(value.header.height().into()),
                 timestamp: value.header.timestamp.nanoseconds(),
             }),
diff --git a/crates/ibc/src/mock/consensus_state.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
similarity index 85%
rename from crates/ibc/src/mock/consensus_state.rs
rename to crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
index 4bf3e1129..39154deb5 100644
--- a/crates/ibc/src/mock/consensus_state.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
@@ -1,13 +1,12 @@
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::mock::ConsensusState as RawMockConsensusState;
-use ibc_proto::Protobuf;
+use ibc::core::ics02_client::consensus_state::ConsensusState;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics23_commitment::commitment::CommitmentRoot;
+use ibc::core::timestamp::Timestamp;
+use ibc::prelude::*;
+use ibc::proto::mock::ConsensusState as RawMockConsensusState;
+use ibc::proto::{Any, Protobuf};
 
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics23_commitment::commitment::CommitmentRoot;
-use crate::core::timestamp::Timestamp;
-use crate::mock::header::MockHeader;
-use crate::prelude::*;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
 
 pub const MOCK_CONSENSUS_STATE_TYPE_URL: &str = "/ibc.mock.ConsensusState";
 
@@ -49,7 +48,7 @@ impl TryFrom<RawMockConsensusState> for MockConsensusState {
 impl From<MockConsensusState> for RawMockConsensusState {
     fn from(value: MockConsensusState) -> Self {
         RawMockConsensusState {
-            header: Some(ibc_proto::ibc::mock::Header {
+            header: Some(ibc::proto::mock::Header {
                 height: Some(value.header.height().into()),
                 timestamp: value.header.timestamp.nanoseconds(),
             }),
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs
new file mode 100644
index 000000000..0ea825d26
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs	
@@ -0,0 +1,136 @@
+use alloc::string::ToString;
+use core::fmt::{Display, Error as FmtError, Formatter};
+
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::mock::Header as RawMockHeader;
+use ibc_proto::Protobuf;
+
+use crate::core::ics02_client::error::ClientError;
+use crate::core::timestamp::Timestamp;
+use crate::Height;
+
+pub const MOCK_HEADER_TYPE_URL: &str = "/ibc.mock.Header";
+
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Copy, Clone, Debug, PartialEq, Eq)]
+pub struct MockHeader {
+    pub height: Height,
+    pub timestamp: Timestamp,
+}
+
+impl Default for MockHeader {
+    fn default() -> Self {
+        Self {
+            height: Height::min(0),
+            timestamp: Default::default(),
+        }
+    }
+}
+
+impl Display for MockHeader {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(
+            f,
+            "MockHeader {{ height: {}, timestamp: {} }}",
+            self.height, self.timestamp
+        )
+    }
+}
+
+impl Protobuf<RawMockHeader> for MockHeader {}
+
+impl TryFrom<RawMockHeader> for MockHeader {
+    type Error = ClientError;
+
+    fn try_from(raw: RawMockHeader) -> Result<Self, Self::Error> {
+        Ok(MockHeader {
+            height: raw
+                .height
+                .and_then(|raw_height| raw_height.try_into().ok())
+                .ok_or(ClientError::MissingClientMessage)?,
+
+            timestamp: Timestamp::from_nanoseconds(raw.timestamp)
+                .map_err(ClientError::InvalidPacketTimestamp)?,
+        })
+    }
+}
+
+impl From<MockHeader> for RawMockHeader {
+    fn from(value: MockHeader) -> Self {
+        RawMockHeader {
+            height: Some(value.height.into()),
+            timestamp: value.timestamp.nanoseconds(),
+        }
+    }
+}
+
+impl MockHeader {
+    pub fn height(&self) -> Height {
+        self.height
+    }
+
+    pub fn new(height: Height) -> Self {
+        Self {
+            height,
+            timestamp: Timestamp::none(),
+        }
+    }
+
+    #[cfg(any(test, feature = "std"))]
+    pub fn with_current_timestamp(self) -> Self {
+        self.with_timestamp(Timestamp::now())
+    }
+
+    pub fn with_timestamp(self, timestamp: Timestamp) -> Self {
+        Self { timestamp, ..self }
+    }
+}
+
+impl Protobuf<Any> for MockHeader {}
+
+impl TryFrom<Any> for MockHeader {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        match raw.type_url.as_str() {
+            MOCK_HEADER_TYPE_URL => Ok(Protobuf::<RawMockHeader>::decode_vec(&raw.value).map_err(
+                |e| ClientError::InvalidRawHeader {
+                    reason: e.to_string(),
+                },
+            )?),
+            _ => Err(ClientError::UnknownHeaderType {
+                header_type: raw.type_url,
+            }),
+        }
+    }
+}
+
+impl From<MockHeader> for Any {
+    fn from(header: MockHeader) -> Self {
+        Any {
+            type_url: MOCK_HEADER_TYPE_URL.to_string(),
+            value: Protobuf::<RawMockHeader>::encode_vec(header),
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+
+    use super::*;
+
+    #[test]
+    fn encode_any() {
+        let header = MockHeader::new(Height::new(1, 10).expect("Never fails"))
+            .with_timestamp(Timestamp::none());
+        let bytes = <MockHeader as Protobuf<Any>>::encode_vec(header);
+
+        assert_eq!(
+            &bytes,
+            &[
+                10, 16, 47, 105, 98, 99, 46, 109, 111, 99, 107, 46, 72, 101, 97, 100, 101, 114, 18,
+                6, 10, 4, 8, 1, 16, 10
+            ]
+        );
+    }
+}
diff --git a/crates/ibc/src/mock/header.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
similarity index 86%
rename from crates/ibc/src/mock/header.rs
rename to crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
index bf5ce05eb..bad80b6bd 100644
--- a/crates/ibc/src/mock/header.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
@@ -1,13 +1,11 @@
 use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
 
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::mock::Header as RawMockHeader;
-use ibc_proto::Protobuf;
-
-use crate::core::ics02_client::error::ClientError;
-use crate::core::timestamp::Timestamp;
-use crate::Height;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::timestamp::Timestamp;
+use ibc::proto::mock::Header as RawMockHeader;
+use ibc::proto::{Any, Protobuf};
+use ibc::Height;
 
 pub const MOCK_HEADER_TYPE_URL: &str = "/ibc.mock.Header";
 
@@ -70,16 +68,16 @@ impl MockHeader {
     }
 
     pub fn new(height: Height) -> Self {
-        if cfg!(any(test, feature = "std")) {
-            Self {
-                height,
-                timestamp: Timestamp::now(),
-            }
-        } else {
-            Self {
-                height,
-                timestamp: Timestamp::none(),
-            }
+        Self {
+            height,
+            timestamp: Timestamp::none(),
+        }
+    }
+
+    pub fn with_current_timestamp(self) -> Self {
+        Self {
+            timestamp: Timestamp::now(),
+            ..self
         }
     }
 
diff --git a/crates/ibc/src/mock/misbehaviour.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
similarity index 88%
rename from crates/ibc/src/mock/misbehaviour.rs
rename to crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
index 192d78955..71a852869 100644
--- a/crates/ibc/src/mock/misbehaviour.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
@@ -1,12 +1,11 @@
 use bytes::Buf;
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::mock::Misbehaviour as RawMisbehaviour;
-use ibc_proto::Protobuf;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::prelude::*;
+use ibc::proto::mock::Misbehaviour as RawMisbehaviour;
+use ibc::proto::{Any, Protobuf};
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::mock::header::MockHeader;
-use crate::prelude::*;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
 
 pub const MOCK_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.mock.Misbehavior";
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
new file mode 100644
index 000000000..746825f7f
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
@@ -0,0 +1,5 @@
+//! Definitions of ibc mock types used in testing.
+pub mod client_state;
+pub mod consensus_state;
+pub mod header;
+pub mod misbehaviour;
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mod.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mod.rs
new file mode 100644
index 000000000..d7b09e638
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -0,0 +1,91 @@
+pub mod mock;
+
+use derive_more::{From, TryInto};
+use ibc::clients::ics07_tendermint::client_state::{
+    ClientState as TmClientState, TENDERMINT_CLIENT_STATE_TYPE_URL,
+};
+use ibc::clients::ics07_tendermint::consensus_state::{
+    ConsensusState as TmConsensusState, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
+};
+use ibc::core::ics02_client::client_state::ClientState;
+use ibc::core::ics02_client::consensus_state::ConsensusState;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::prelude::*;
+use ibc::proto::{Any, Protobuf};
+
+use crate::testapp::ibc::clients::mock::client_state::{
+    MockClientState, MOCK_CLIENT_STATE_TYPE_URL,
+};
+use crate::testapp::ibc::clients::mock::consensus_state::{
+    MockConsensusState, MOCK_CONSENSUS_STATE_TYPE_URL,
+};
+use crate::testapp::ibc::core::types::MockContext;
+
+#[derive(Debug, Clone, From, PartialEq, ClientState)]
+#[generics(ClientValidationContext = MockContext,
+           ClientExecutionContext = MockContext)
+]
+pub enum AnyClientState {
+    Tendermint(TmClientState),
+    Mock(MockClientState),
+}
+
+impl Protobuf<Any> for AnyClientState {}
+
+impl TryFrom<Any> for AnyClientState {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        if raw.type_url == TENDERMINT_CLIENT_STATE_TYPE_URL {
+            TmClientState::try_from(raw).map(Into::into)
+        } else if raw.type_url == MOCK_CLIENT_STATE_TYPE_URL {
+            MockClientState::try_from(raw).map(Into::into)
+        } else {
+            Err(ClientError::Other {
+                description: "failed to deserialize message".to_string(),
+            })
+        }
+    }
+}
+
+impl From<AnyClientState> for Any {
+    fn from(host_client_state: AnyClientState) -> Self {
+        match host_client_state {
+            AnyClientState::Tendermint(cs) => cs.into(),
+            AnyClientState::Mock(cs) => cs.into(),
+        }
+    }
+}
+
+#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
+pub enum AnyConsensusState {
+    Tendermint(TmConsensusState),
+    Mock(MockConsensusState),
+}
+
+impl Protobuf<Any> for AnyConsensusState {}
+
+impl TryFrom<Any> for AnyConsensusState {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        if raw.type_url == TENDERMINT_CONSENSUS_STATE_TYPE_URL {
+            TmConsensusState::try_from(raw).map(Into::into)
+        } else if raw.type_url == MOCK_CONSENSUS_STATE_TYPE_URL {
+            MockConsensusState::try_from(raw).map(Into::into)
+        } else {
+            Err(ClientError::Other {
+                description: "failed to deserialize message".to_string(),
+            })
+        }
+    }
+}
+
+impl From<AnyConsensusState> for Any {
+    fn from(host_consensus_state: AnyConsensusState) -> Self {
+        match host_consensus_state {
+            AnyConsensusState::Tendermint(cs) => cs.into(),
+            AnyConsensusState::Mock(cs) => cs.into(),
+        }
+    }
+}
diff --git a/crates/ibc/src/mock/context/clients.rs b/crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
similarity index 87%
rename from crates/ibc/src/mock/context/clients.rs
rename to crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index cac89cd6d..17bb7ff61 100644
--- a/crates/ibc/src/mock/context/clients.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -1,18 +1,33 @@
-//! Client context implementations for `MockContext`
+use alloc::collections::BTreeMap;
+use alloc::vec::Vec;
 
-use super::{AnyClientState, AnyConsensusState, MockClientRecord, MockContext};
-use crate::clients::ics07_tendermint::{
+use ibc::clients::ics07_tendermint::{
     CommonContext as TmCommonContext, ValidationContext as TmValidationContext,
 };
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
-use crate::core::timestamp::Timestamp;
-use crate::core::{ContextError, ValidationContext};
-use crate::mock::client_state::MockClientContext;
-use crate::prelude::*;
-use crate::Height;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, PortId};
+use ibc::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc::core::timestamp::Timestamp;
+use ibc::core::{ContextError, ValidationContext};
+use ibc::Height;
+
+use crate::testapp::ibc::clients::mock::client_state::MockClientContext;
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+use crate::testapp::ibc::core::types::MockContext;
+
+pub type PortChannelIdMap<V> = BTreeMap<PortId, BTreeMap<ChannelId, V>>;
+
+/// A mock of an IBC client record as it is stored in a mock context.
+/// For testing ICS02 handlers mostly, cf. `MockClientContext`.
+#[derive(Clone, Debug)]
+pub struct MockClientRecord {
+    /// The client state (representing only the latest height at the moment).
+    pub client_state: Option<AnyClientState>,
+
+    /// Mapping of heights to consensus states for this client.
+    pub consensus_states: BTreeMap<Height, AnyConsensusState>,
+}
 
 impl MockClientContext for MockContext {
     type ConversionError = &'static str;
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
new file mode 100644
index 000000000..fa917b493
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -0,0 +1,548 @@
+//! Implementation of a global context mock. Used in testing handlers of all IBC modules.
+
+use core::ops::Add;
+use core::time::Duration;
+
+use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
+use ibc::core::events::IbcEvent;
+use ibc::core::ics02_client::error::ClientError;
+use ibc::core::ics03_connection::connection::ConnectionEnd;
+use ibc::core::ics03_connection::error::ConnectionError;
+use ibc::core::ics04_channel::channel::ChannelEnd;
+use ibc::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc::core::ics04_channel::error::{ChannelError, PacketError};
+use ibc::core::ics04_channel::packet::{Receipt, Sequence};
+use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::ics24_host::path::{
+    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
+    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
+};
+use ibc::core::timestamp::Timestamp;
+use ibc::core::{ContextError, ExecutionContext, ValidationContext};
+use ibc::prelude::*;
+use ibc::proto::Any;
+use ibc::{Height, Signer};
+
+use super::types::MockContext;
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+
+impl ValidationContext for MockContext {
+    type V = Self;
+    type E = Self;
+    type AnyConsensusState = AnyConsensusState;
+    type AnyClientState = AnyClientState;
+
+    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError> {
+        match self.ibc_store.lock().clients.get(client_id) {
+            Some(client_record) => {
+                client_record
+                    .client_state
+                    .clone()
+                    .ok_or_else(|| ClientError::ClientStateNotFound {
+                        client_id: client_id.clone(),
+                    })
+            }
+            None => Err(ClientError::ClientStateNotFound {
+                client_id: client_id.clone(),
+            }),
+        }
+        .map_err(ContextError::ClientError)
+    }
+
+    fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError> {
+        if let Ok(client_state) = TmClientState::try_from(client_state.clone()) {
+            client_state.validate().map_err(ClientError::from)?;
+            Ok(client_state.into())
+        } else if let Ok(client_state) = MockClientState::try_from(client_state.clone()) {
+            Ok(client_state.into())
+        } else {
+            Err(ClientError::UnknownClientStateType {
+                client_state_type: client_state.type_url,
+            })
+        }
+        .map_err(ContextError::ClientError)
+    }
+
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<AnyConsensusState, ContextError> {
+        let client_id = &client_cons_state_path.client_id;
+        let height = Height::new(client_cons_state_path.epoch, client_cons_state_path.height)?;
+        match self.ibc_store.lock().clients.get(client_id) {
+            Some(client_record) => match client_record.consensus_states.get(&height) {
+                Some(consensus_state) => Ok(consensus_state.clone()),
+                None => Err(ClientError::ConsensusStateNotFound {
+                    client_id: client_id.clone(),
+                    height,
+                }),
+            },
+            None => Err(ClientError::ConsensusStateNotFound {
+                client_id: client_id.clone(),
+                height,
+            }),
+        }
+        .map_err(ContextError::ClientError)
+    }
+
+    fn host_height(&self) -> Result<Height, ContextError> {
+        Ok(self.latest_height())
+    }
+
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
+        Ok(self
+            .history
+            .last()
+            .expect("history cannot be empty")
+            .timestamp()
+            .add(self.block_time)
+            .expect("Never fails"))
+    }
+
+    fn host_consensus_state(&self, height: &Height) -> Result<AnyConsensusState, ContextError> {
+        match self.host_block(height) {
+            Some(block_ref) => Ok(block_ref.clone().into()),
+            None => Err(ClientError::MissingLocalConsensusState { height: *height }),
+        }
+        .map_err(ConnectionError::Client)
+        .map_err(ContextError::ConnectionError)
+    }
+
+    fn client_counter(&self) -> Result<u64, ContextError> {
+        Ok(self.ibc_store.lock().client_ids_counter)
+    }
+
+    fn connection_end(&self, cid: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
+        match self.ibc_store.lock().connections.get(cid) {
+            Some(connection_end) => Ok(connection_end.clone()),
+            None => Err(ConnectionError::ConnectionNotFound {
+                connection_id: cid.clone(),
+            }),
+        }
+        .map_err(ContextError::ConnectionError)
+    }
+
+    fn validate_self_client(
+        &self,
+        client_state_of_host_on_counterparty: Any,
+    ) -> Result<(), ContextError> {
+        let mock_client_state = MockClientState::try_from(client_state_of_host_on_counterparty)
+            .map_err(|_| ConnectionError::InvalidClientState {
+                reason: "client must be a mock client".to_string(),
+            })
+            .map_err(ContextError::ConnectionError)?;
+
+        if mock_client_state.is_frozen() {
+            return Err(ClientError::ClientFrozen {
+                description: String::new(),
+            }
+            .into());
+        }
+
+        let self_chain_id = &self.host_chain_id;
+        let self_revision_number = self_chain_id.revision_number();
+        if self_revision_number != mock_client_state.latest_height().revision_number() {
+            return Err(ConnectionError::InvalidClientState {
+                reason: format!(
+                    "client is not in the same revision as the chain. expected: {}, got: {}",
+                    self_revision_number,
+                    mock_client_state.latest_height().revision_number()
+                ),
+            })
+            .map_err(ContextError::ConnectionError);
+        }
+
+        let host_current_height = self.latest_height().increment();
+        if mock_client_state.latest_height() >= host_current_height {
+            return Err(ConnectionError::InvalidClientState {
+                reason: format!(
+                    "client has latest height {} greater than or equal to chain height {}",
+                    mock_client_state.latest_height(),
+                    host_current_height
+                ),
+            })
+            .map_err(ContextError::ConnectionError);
+        }
+
+        Ok(())
+    }
+
+    fn commitment_prefix(&self) -> CommitmentPrefix {
+        CommitmentPrefix::try_from(b"mock".to_vec()).expect("Never fails")
+    }
+
+    fn connection_counter(&self) -> Result<u64, ContextError> {
+        Ok(self.ibc_store.lock().connection_ids_counter)
+    }
+
+    fn channel_end(&self, chan_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError> {
+        let port_id = &chan_end_path.0;
+        let channel_id = &chan_end_path.1;
+
+        match self
+            .ibc_store
+            .lock()
+            .channels
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+        {
+            Some(channel_end) => Ok(channel_end.clone()),
+            None => Err(ChannelError::ChannelNotFound {
+                port_id: port_id.clone(),
+                channel_id: channel_id.clone(),
+            }),
+        }
+        .map_err(ContextError::ChannelError)
+    }
+
+    fn get_next_sequence_send(
+        &self,
+        seq_send_path: &SeqSendPath,
+    ) -> Result<Sequence, ContextError> {
+        let port_id = &seq_send_path.0;
+        let channel_id = &seq_send_path.1;
+
+        match self
+            .ibc_store
+            .lock()
+            .next_sequence_send
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+        {
+            Some(sequence) => Ok(*sequence),
+            None => Err(PacketError::MissingNextSendSeq {
+                port_id: port_id.clone(),
+                channel_id: channel_id.clone(),
+            }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn get_next_sequence_recv(
+        &self,
+        seq_recv_path: &SeqRecvPath,
+    ) -> Result<Sequence, ContextError> {
+        let port_id = &seq_recv_path.0;
+        let channel_id = &seq_recv_path.1;
+
+        match self
+            .ibc_store
+            .lock()
+            .next_sequence_recv
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+        {
+            Some(sequence) => Ok(*sequence),
+            None => Err(PacketError::MissingNextRecvSeq {
+                port_id: port_id.clone(),
+                channel_id: channel_id.clone(),
+            }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn get_next_sequence_ack(&self, seq_ack_path: &SeqAckPath) -> Result<Sequence, ContextError> {
+        let port_id = &seq_ack_path.0;
+        let channel_id = &seq_ack_path.1;
+
+        match self
+            .ibc_store
+            .lock()
+            .next_sequence_ack
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+        {
+            Some(sequence) => Ok(*sequence),
+            None => Err(PacketError::MissingNextAckSeq {
+                port_id: port_id.clone(),
+                channel_id: channel_id.clone(),
+            }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn get_packet_commitment(
+        &self,
+        commitment_path: &CommitmentPath,
+    ) -> Result<PacketCommitment, ContextError> {
+        let port_id = &commitment_path.port_id;
+        let channel_id = &commitment_path.channel_id;
+        let seq = &commitment_path.sequence;
+
+        match self
+            .ibc_store
+            .lock()
+            .packet_commitment
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+            .and_then(|map| map.get(seq))
+        {
+            Some(commitment) => Ok(commitment.clone()),
+            None => Err(PacketError::PacketCommitmentNotFound { sequence: *seq }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn get_packet_receipt(&self, receipt_path: &ReceiptPath) -> Result<Receipt, ContextError> {
+        let port_id = &receipt_path.port_id;
+        let channel_id = &receipt_path.channel_id;
+        let seq = &receipt_path.sequence;
+
+        match self
+            .ibc_store
+            .lock()
+            .packet_receipt
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+            .and_then(|map| map.get(seq))
+        {
+            Some(receipt) => Ok(receipt.clone()),
+            None => Err(PacketError::PacketReceiptNotFound { sequence: *seq }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn get_packet_acknowledgement(
+        &self,
+        ack_path: &AckPath,
+    ) -> Result<AcknowledgementCommitment, ContextError> {
+        let port_id = &ack_path.port_id;
+        let channel_id = &ack_path.channel_id;
+        let seq = &ack_path.sequence;
+
+        match self
+            .ibc_store
+            .lock()
+            .packet_acknowledgement
+            .get(port_id)
+            .and_then(|map| map.get(channel_id))
+            .and_then(|map| map.get(seq))
+        {
+            Some(ack) => Ok(ack.clone()),
+            None => Err(PacketError::PacketAcknowledgementNotFound { sequence: *seq }),
+        }
+        .map_err(ContextError::PacketError)
+    }
+
+    fn channel_counter(&self) -> Result<u64, ContextError> {
+        Ok(self.ibc_store.lock().channel_ids_counter)
+    }
+
+    fn max_expected_time_per_block(&self) -> Duration {
+        self.block_time
+    }
+
+    fn validate_message_signer(&self, _signer: &Signer) -> Result<(), ContextError> {
+        Ok(())
+    }
+
+    fn get_client_validation_context(&self) -> &Self::V {
+        self
+    }
+}
+
+impl ExecutionContext for MockContext {
+    fn get_client_execution_context(&mut self) -> &mut Self::E {
+        self
+    }
+
+    fn increase_client_counter(&mut self) -> Result<(), ContextError> {
+        self.ibc_store.lock().client_ids_counter += 1;
+        Ok(())
+    }
+
+    fn store_connection(
+        &mut self,
+        connection_path: &ConnectionPath,
+        connection_end: ConnectionEnd,
+    ) -> Result<(), ContextError> {
+        let connection_id = connection_path.0.clone();
+        self.ibc_store
+            .lock()
+            .connections
+            .insert(connection_id, connection_end);
+        Ok(())
+    }
+
+    fn store_connection_to_client(
+        &mut self,
+        client_connection_path: &ClientConnectionPath,
+        conn_id: ConnectionId,
+    ) -> Result<(), ContextError> {
+        let client_id = client_connection_path.0.clone();
+        self.ibc_store
+            .lock()
+            .client_connections
+            .insert(client_id, conn_id);
+        Ok(())
+    }
+
+    fn increase_connection_counter(&mut self) -> Result<(), ContextError> {
+        self.ibc_store.lock().connection_ids_counter += 1;
+        Ok(())
+    }
+
+    fn store_packet_commitment(
+        &mut self,
+        commitment_path: &CommitmentPath,
+        commitment: PacketCommitment,
+    ) -> Result<(), ContextError> {
+        self.ibc_store
+            .lock()
+            .packet_commitment
+            .entry(commitment_path.port_id.clone())
+            .or_default()
+            .entry(commitment_path.channel_id.clone())
+            .or_default()
+            .insert(commitment_path.sequence, commitment);
+        Ok(())
+    }
+
+    fn delete_packet_commitment(
+        &mut self,
+        commitment_path: &CommitmentPath,
+    ) -> Result<(), ContextError> {
+        self.ibc_store
+            .lock()
+            .packet_commitment
+            .get_mut(&commitment_path.port_id)
+            .and_then(|map| map.get_mut(&commitment_path.channel_id))
+            .and_then(|map| map.remove(&commitment_path.sequence));
+        Ok(())
+    }
+
+    fn store_packet_receipt(
+        &mut self,
+        path: &ReceiptPath,
+        receipt: Receipt,
+    ) -> Result<(), ContextError> {
+        self.ibc_store
+            .lock()
+            .packet_receipt
+            .entry(path.port_id.clone())
+            .or_default()
+            .entry(path.channel_id.clone())
+            .or_default()
+            .insert(path.sequence, receipt);
+        Ok(())
+    }
+
+    fn store_packet_acknowledgement(
+        &mut self,
+        ack_path: &AckPath,
+        ack_commitment: AcknowledgementCommitment,
+    ) -> Result<(), ContextError> {
+        let port_id = ack_path.port_id.clone();
+        let channel_id = ack_path.channel_id.clone();
+        let seq = ack_path.sequence;
+
+        self.ibc_store
+            .lock()
+            .packet_acknowledgement
+            .entry(port_id)
+            .or_default()
+            .entry(channel_id)
+            .or_default()
+            .insert(seq, ack_commitment);
+        Ok(())
+    }
+
+    fn delete_packet_acknowledgement(&mut self, ack_path: &AckPath) -> Result<(), ContextError> {
+        let port_id = ack_path.port_id.clone();
+        let channel_id = ack_path.channel_id.clone();
+        let sequence = ack_path.sequence;
+
+        self.ibc_store
+            .lock()
+            .packet_acknowledgement
+            .get_mut(&port_id)
+            .and_then(|map| map.get_mut(&channel_id))
+            .and_then(|map| map.remove(&sequence));
+        Ok(())
+    }
+
+    fn store_channel(
+        &mut self,
+        channel_end_path: &ChannelEndPath,
+        channel_end: ChannelEnd,
+    ) -> Result<(), ContextError> {
+        let port_id = channel_end_path.0.clone();
+        let channel_id = channel_end_path.1.clone();
+
+        self.ibc_store
+            .lock()
+            .channels
+            .entry(port_id)
+            .or_default()
+            .insert(channel_id, channel_end);
+        Ok(())
+    }
+
+    fn store_next_sequence_send(
+        &mut self,
+        seq_send_path: &SeqSendPath,
+        seq: Sequence,
+    ) -> Result<(), ContextError> {
+        let port_id = seq_send_path.0.clone();
+        let channel_id = seq_send_path.1.clone();
+
+        self.ibc_store
+            .lock()
+            .next_sequence_send
+            .entry(port_id)
+            .or_default()
+            .insert(channel_id, seq);
+        Ok(())
+    }
+
+    fn store_next_sequence_recv(
+        &mut self,
+        seq_recv_path: &SeqRecvPath,
+        seq: Sequence,
+    ) -> Result<(), ContextError> {
+        let port_id = seq_recv_path.0.clone();
+        let channel_id = seq_recv_path.1.clone();
+
+        self.ibc_store
+            .lock()
+            .next_sequence_recv
+            .entry(port_id)
+            .or_default()
+            .insert(channel_id, seq);
+        Ok(())
+    }
+
+    fn store_next_sequence_ack(
+        &mut self,
+        seq_ack_path: &SeqAckPath,
+        seq: Sequence,
+    ) -> Result<(), ContextError> {
+        let port_id = seq_ack_path.0.clone();
+        let channel_id = seq_ack_path.1.clone();
+
+        self.ibc_store
+            .lock()
+            .next_sequence_ack
+            .entry(port_id)
+            .or_default()
+            .insert(channel_id, seq);
+        Ok(())
+    }
+
+    fn increase_channel_counter(&mut self) -> Result<(), ContextError> {
+        self.ibc_store.lock().channel_ids_counter += 1;
+        Ok(())
+    }
+
+    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
+        self.events.push(event);
+        Ok(())
+    }
+
+    fn log_message(&mut self, message: String) -> Result<(), ContextError> {
+        self.logs.push(message);
+        Ok(())
+    }
+}
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/mod.rs b/crates/ibc-testkit/src/testapp/ibc/core/mod.rs
new file mode 100644
index 000000000..052ffa92e
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/core/mod.rs
@@ -0,0 +1,4 @@
+pub mod client_ctx;
+pub mod core_ctx;
+pub mod router;
+pub mod types;
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/context.rs b/crates/ibc-testkit/src/testapp/ibc/core/router/context.rs
new file mode 100644
index 000000000..ad6855ac8
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/core/router/context.rs
@@ -0,0 +1,31 @@
+use alloc::sync::Arc;
+
+use ibc::core::ics24_host::identifier::PortId;
+use ibc::core::router::{Module, ModuleId, Router};
+
+use super::types::MockRouter;
+
+impl Router for MockRouter {
+    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module> {
+        self.router.get(module_id).map(Arc::as_ref)
+    }
+    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module> {
+        // NOTE: The following:
+
+        // self.router.get_mut(module_id).and_then(Arc::get_mut)
+
+        // doesn't work due to a compiler bug. So we expand it out manually.
+
+        match self.router.get_mut(module_id) {
+            Some(arc_mod) => match Arc::get_mut(arc_mod) {
+                Some(m) => Some(m),
+                None => None,
+            },
+            None => None,
+        }
+    }
+
+    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId> {
+        self.port_to_module.get(port_id).cloned()
+    }
+}
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs b/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
new file mode 100644
index 000000000..59680b5b0
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
@@ -0,0 +1,5 @@
+mod context;
+mod types;
+
+pub use context::*;
+pub use types::*;
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/types.rs b/crates/ibc-testkit/src/testapp/ibc/core/router/types.rs
new file mode 100644
index 000000000..b0aaaae1b
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/core/router/types.rs
@@ -0,0 +1,50 @@
+use alloc::collections::BTreeMap;
+use alloc::sync::Arc;
+
+use ibc::applications::transfer::MODULE_ID_STR;
+use ibc::core::ics24_host::identifier::PortId;
+use ibc::core::router::{Module, ModuleId};
+use ibc::prelude::*;
+
+use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
+
+#[derive(Default)]
+pub struct MockRouter {
+    pub router: BTreeMap<ModuleId, Arc<dyn Module>>,
+
+    /// Maps ports to the the module that owns it
+    pub port_to_module: BTreeMap<PortId, ModuleId>,
+}
+
+impl MockRouter {
+    pub fn new_with_transfer() -> Self {
+        let mut router = Self::default();
+
+        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
+
+        router.scope_port_to_module(PortId::transfer(), module_id.clone());
+
+        let transfer_mod = DummyTransferModule::new();
+
+        router
+            .add_route(module_id, transfer_mod)
+            .expect("Never fails");
+
+        router
+    }
+
+    pub fn add_route(
+        &mut self,
+        module_id: ModuleId,
+        module: impl Module + 'static,
+    ) -> Result<(), String> {
+        match self.router.insert(module_id, Arc::new(module)) {
+            None => Ok(()),
+            Some(_) => Err("Duplicate module_id".to_owned()),
+        }
+    }
+
+    pub fn scope_port_to_module(&mut self, port_id: PortId, module_id: ModuleId) {
+        self.port_to_module.insert(port_id, module_id);
+    }
+}
diff --git a/crates/ibc/src/mock/context.rs b/crates/ibc-testkit/src/testapp/ibc/core/types.rs
similarity index 59%
rename from crates/ibc/src/mock/context.rs
rename to crates/ibc-testkit/src/testapp/ibc/core/types.rs
index c40477f66..145afcdb1 100644
--- a/crates/ibc/src/mock/context.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -1,7 +1,5 @@
 //! Implementation of a global context mock. Used in testing handlers of all IBC modules.
 
-mod clients;
-
 use alloc::collections::btree_map::BTreeMap;
 use alloc::sync::Arc;
 use core::cmp::min;
@@ -9,137 +7,39 @@ use core::fmt::Debug;
 use core::ops::{Add, Sub};
 use core::time::Duration;
 
-use derive_more::{From, TryInto};
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::Protobuf;
+use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
+use ibc::core::events::IbcEvent;
+use ibc::core::ics02_client::client_type::ClientType;
+use ibc::core::ics03_connection::connection::ConnectionEnd;
+use ibc::core::ics04_channel::channel::ChannelEnd;
+use ibc::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc::core::ics04_channel::packet::{Receipt, Sequence};
+use ibc::core::ics24_host::identifier::{ChainId, ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::router::Router;
+use ibc::core::timestamp::Timestamp;
+use ibc::core::{dispatch, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc::Height;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
 use tracing::debug;
 use typed_builder::TypedBuilder;
 
-use super::client_state::{MOCK_CLIENT_STATE_TYPE_URL, MOCK_CLIENT_TYPE};
-use super::consensus_state::MOCK_CONSENSUS_STATE_TYPE_URL;
-use crate::clients::ics07_tendermint::client_state::test_util::ClientStateConfig as TmClientStateConfig;
-use crate::clients::ics07_tendermint::client_state::{
-    ClientState as TmClientState, TENDERMINT_CLIENT_STATE_TYPE_URL,
-};
-use crate::clients::ics07_tendermint::consensus_state::{
-    ConsensusState as TmConsensusState, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
+use super::client_ctx::{MockClientRecord, PortChannelIdMap};
+use crate::hosts::block::{HostBlock, HostType};
+use crate::relayer::error::RelayerError;
+use crate::testapp::ibc::clients::mock::client_state::{
+    client_type as mock_client_type, MockClientState, MOCK_CLIENT_TYPE,
 };
-use crate::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
-use crate::core::events::IbcEvent;
-use crate::core::ics02_client::client_state::ClientState;
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::ConnectionEnd;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics04_channel::channel::ChannelEnd;
-use crate::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::packet::{Receipt, Sequence};
-use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-use crate::core::ics24_host::identifier::{ChainId, ChannelId, ClientId, ConnectionId, PortId};
-use crate::core::ics24_host::path::{
-    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
-    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+use crate::utils::clients::tendermint::{
+    dummy_tm_client_state_from_header, ClientStateConfig as TmClientStateConfig,
 };
-use crate::core::router::Router;
-use crate::core::timestamp::Timestamp;
-use crate::core::{dispatch, ContextError, ExecutionContext, MsgEnvelope, ValidationContext};
-use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
-use crate::mock::consensus_state::MockConsensusState;
-use crate::mock::header::MockHeader;
-use crate::mock::host::{HostBlock, HostType};
-use crate::mock::ics18_relayer::context::RelayerContext;
-use crate::mock::ics18_relayer::error::RelayerError;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
-
 pub const DEFAULT_BLOCK_TIME_SECS: u64 = 3;
 
-#[derive(Debug, Clone, From, PartialEq, ClientState)]
-#[generics(ClientValidationContext = MockContext,
-           ClientExecutionContext = MockContext)
-]
-#[mock]
-pub enum AnyClientState {
-    Tendermint(TmClientState),
-    Mock(MockClientState),
-}
-
-impl Protobuf<Any> for AnyClientState {}
-
-impl TryFrom<Any> for AnyClientState {
-    type Error = ClientError;
-
-    fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        if raw.type_url == TENDERMINT_CLIENT_STATE_TYPE_URL {
-            TmClientState::try_from(raw).map(Into::into)
-        } else if raw.type_url == MOCK_CLIENT_STATE_TYPE_URL {
-            MockClientState::try_from(raw).map(Into::into)
-        } else {
-            Err(ClientError::Other {
-                description: "failed to deserialize message".to_string(),
-            })
-        }
-    }
-}
-
-impl From<AnyClientState> for Any {
-    fn from(host_client_state: AnyClientState) -> Self {
-        match host_client_state {
-            AnyClientState::Tendermint(cs) => cs.into(),
-            AnyClientState::Mock(cs) => cs.into(),
-        }
-    }
-}
-
-#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
-pub enum AnyConsensusState {
-    Tendermint(TmConsensusState),
-    Mock(MockConsensusState),
-}
-
-impl Protobuf<Any> for AnyConsensusState {}
-
-impl TryFrom<Any> for AnyConsensusState {
-    type Error = ClientError;
-
-    fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        if raw.type_url == TENDERMINT_CONSENSUS_STATE_TYPE_URL {
-            TmConsensusState::try_from(raw).map(Into::into)
-        } else if raw.type_url == MOCK_CONSENSUS_STATE_TYPE_URL {
-            MockConsensusState::try_from(raw).map(Into::into)
-        } else {
-            Err(ClientError::Other {
-                description: "failed to deserialize message".to_string(),
-            })
-        }
-    }
-}
-
-impl From<AnyConsensusState> for Any {
-    fn from(host_consensus_state: AnyConsensusState) -> Self {
-        match host_consensus_state {
-            AnyConsensusState::Tendermint(cs) => cs.into(),
-            AnyConsensusState::Mock(cs) => cs.into(),
-        }
-    }
-}
-
-/// A mock of an IBC client record as it is stored in a mock context.
-/// For testing ICS02 handlers mostly, cf. `MockClientContext`.
-#[derive(Clone, Debug)]
-pub struct MockClientRecord {
-    /// The client state (representing only the latest height at the moment).
-    pub client_state: Option<AnyClientState>,
-
-    /// Mapping of heights to consensus states for this client.
-    pub consensus_states: BTreeMap<Height, AnyConsensusState>,
-}
-
 /// An object that stores all IBC related data.
 #[derive(Clone, Debug, Default)]
 pub struct MockIbcStore {
@@ -196,20 +96,20 @@ pub struct MockIbcStore {
 #[derive(Debug)]
 pub struct MockContext {
     /// The type of host chain underlying this mock context.
-    host_chain_type: HostType,
+    pub host_chain_type: HostType,
 
     /// Host chain identifier.
-    host_chain_id: ChainId,
+    pub host_chain_id: ChainId,
 
     /// Maximum size for the history of the host chain. Any block older than this is pruned.
-    max_history_size: u64,
+    pub max_history_size: u64,
 
     /// The chain of blocks underlying this context. A vector of size up to `max_history_size`
     /// blocks, ascending order by their height (latest block is on the last position).
-    history: Vec<HostBlock>,
+    pub history: Vec<HostBlock>,
 
     /// Average time duration between blocks
-    block_time: Duration,
+    pub block_time: Duration,
 
     /// An object that stores all IBC related data.
     pub ibc_store: Arc<Mutex<MockIbcStore>>,
@@ -219,117 +119,6 @@ pub struct MockContext {
     pub logs: Vec<String>,
 }
 
-#[derive(Debug, TypedBuilder)]
-#[builder(build_method(into = MockContext))]
-pub struct MockContextConfig {
-    #[builder(default = HostType::Mock)]
-    host_type: HostType,
-
-    host_id: ChainId,
-
-    #[builder(default = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS))]
-    block_time: Duration,
-
-    // may panic if validator_set_history size is less than max_history_size + 1
-    #[builder(default = 5)]
-    max_history_size: u64,
-
-    #[builder(default, setter(strip_option))]
-    validator_set_history: Option<Vec<Vec<TestgenValidator>>>,
-
-    latest_height: Height,
-
-    #[builder(default = Timestamp::now())]
-    latest_timestamp: Timestamp,
-}
-
-impl From<MockContextConfig> for MockContext {
-    fn from(params: MockContextConfig) -> Self {
-        assert_ne!(
-            params.max_history_size, 0,
-            "The chain must have a non-zero max_history_size"
-        );
-
-        assert_ne!(
-            params.latest_height.revision_height(),
-            0,
-            "The chain must have a non-zero revision_height"
-        );
-
-        // Compute the number of blocks to store.
-        let n = min(
-            params.max_history_size,
-            params.latest_height.revision_height(),
-        );
-
-        assert_eq!(
-            params.host_id.revision_number(),
-            params.latest_height.revision_number(),
-            "The version in the chain identifier must match the version in the latest height"
-        );
-
-        let next_block_timestamp = params
-            .latest_timestamp
-            .add(params.block_time)
-            .expect("Never fails");
-
-        let history = if let Some(validator_set_history) = params.validator_set_history {
-            (0..n)
-                .rev()
-                .map(|i| {
-                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                    // where N = now(), BT = block_time
-                    HostBlock::generate_block_with_validators(
-                        params.host_id.clone(),
-                        params.host_type,
-                        params
-                            .latest_height
-                            .sub(i)
-                            .expect("Never fails")
-                            .revision_height(),
-                        next_block_timestamp
-                            .sub(params.block_time * ((i + 1) as u32))
-                            .expect("Never fails"),
-                        &validator_set_history[(n - i) as usize - 1],
-                        &validator_set_history[(n - i) as usize],
-                    )
-                })
-                .collect()
-        } else {
-            (0..n)
-                .rev()
-                .map(|i| {
-                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                    // where N = now(), BT = block_time
-                    HostBlock::generate_block(
-                        params.host_id.clone(),
-                        params.host_type,
-                        params
-                            .latest_height
-                            .sub(i)
-                            .expect("Never fails")
-                            .revision_height(),
-                        next_block_timestamp
-                            .sub(params.block_time * ((i + 1) as u32))
-                            .expect("Never fails"),
-                    )
-                })
-                .collect()
-        };
-
-        MockContext {
-            host_chain_type: params.host_type,
-            host_chain_id: params.host_id.clone(),
-            max_history_size: params.max_history_size,
-            history,
-            block_time: params.block_time,
-            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-            events: Vec::new(),
-            logs: Vec::new(),
-        }
-    }
-}
-
 #[derive(Debug, TypedBuilder)]
 pub struct MockClientConfig {
     client_chain_id: ChainId,
@@ -560,8 +349,13 @@ impl MockContext {
         let client_type = client_type.unwrap_or_else(mock_client_type);
         let (client_state, consensus_state) = if client_type.as_str() == MOCK_CLIENT_TYPE {
             (
-                Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-                MockConsensusState::new(MockHeader::new(cs_height)).into(),
+                Some(
+                    MockClientState::new(
+                        MockHeader::new(client_state_height).with_current_timestamp(),
+                    )
+                    .into(),
+                ),
+                MockConsensusState::new(MockHeader::new(cs_height).with_current_timestamp()).into(),
             )
         } else if client_type.as_str() == TENDERMINT_CLIENT_TYPE {
             let light_block = HostBlock::generate_tm_block(
@@ -571,7 +365,7 @@ impl MockContext {
             );
 
             let client_state =
-                TmClientState::new_dummy_from_header(light_block.header().clone()).into();
+                dummy_tm_client_state_from_header(light_block.header().clone()).into();
 
             // Return the tuple.
             (Some(client_state), light_block.into())
@@ -611,7 +405,7 @@ impl MockContext {
         )
     }
 
-    pub(crate) fn with_client_parametrized_history_with_chain_id(
+    pub fn with_client_parametrized_history_with_chain_id(
         self,
         client_chain_id: ChainId,
         client_id: &ClientId,
@@ -638,7 +432,7 @@ impl MockContext {
                     HostBlock::generate_tm_block(client_chain_id, cs_height.revision_height(), now);
 
                 let client_state =
-                    TmClientState::new_dummy_from_header(light_block.header().clone()).into();
+                    dummy_tm_client_state_from_header(light_block.header().clone()).into();
 
                 // Return the tuple.
                 (Some(client_state), light_block.into())
@@ -986,580 +780,22 @@ impl MockContext {
     }
 }
 
-type PortChannelIdMap<V> = BTreeMap<PortId, BTreeMap<ChannelId, V>>;
-
-impl RelayerContext for MockContext {
-    fn query_latest_height(&self) -> Result<Height, ContextError> {
-        ValidationContext::host_height(self)
-    }
-
-    fn query_client_full_state(&self, client_id: &ClientId) -> Option<AnyClientState> {
-        // Forward call to Ics2.
-        self.client_state(client_id).ok()
-    }
-
-    fn signer(&self) -> Signer {
-        "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
-            .to_string()
-            .into()
-    }
-}
-
-impl ValidationContext for MockContext {
-    type V = Self;
-    type E = Self;
-    type AnyConsensusState = AnyConsensusState;
-    type AnyClientState = AnyClientState;
-
-    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError> {
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => {
-                client_record
-                    .client_state
-                    .clone()
-                    .ok_or_else(|| ClientError::ClientStateNotFound {
-                        client_id: client_id.clone(),
-                    })
-            }
-            None => Err(ClientError::ClientStateNotFound {
-                client_id: client_id.clone(),
-            }),
-        }
-        .map_err(ContextError::ClientError)
-    }
-
-    fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError> {
-        if let Ok(client_state) = TmClientState::try_from(client_state.clone()) {
-            client_state.validate().map_err(ClientError::from)?;
-            Ok(client_state.into())
-        } else if let Ok(client_state) = MockClientState::try_from(client_state.clone()) {
-            Ok(client_state.into())
-        } else {
-            Err(ClientError::UnknownClientStateType {
-                client_state_type: client_state.type_url,
-            })
-        }
-        .map_err(ContextError::ClientError)
-    }
-
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<AnyConsensusState, ContextError> {
-        let client_id = &client_cons_state_path.client_id;
-        let height = Height::new(client_cons_state_path.epoch, client_cons_state_path.height)?;
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => match client_record.consensus_states.get(&height) {
-                Some(consensus_state) => Ok(consensus_state.clone()),
-                None => Err(ClientError::ConsensusStateNotFound {
-                    client_id: client_id.clone(),
-                    height,
-                }),
-            },
-            None => Err(ClientError::ConsensusStateNotFound {
-                client_id: client_id.clone(),
-                height,
-            }),
-        }
-        .map_err(ContextError::ClientError)
-    }
-
-    fn host_height(&self) -> Result<Height, ContextError> {
-        Ok(self.latest_height())
-    }
-
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
-        Ok(self
-            .history
-            .last()
-            .expect("history cannot be empty")
-            .timestamp()
-            .add(self.block_time)
-            .expect("Never fails"))
-    }
-
-    fn host_consensus_state(&self, height: &Height) -> Result<AnyConsensusState, ContextError> {
-        match self.host_block(height) {
-            Some(block_ref) => Ok(block_ref.clone().into()),
-            None => Err(ClientError::MissingLocalConsensusState { height: *height }),
-        }
-        .map_err(ConnectionError::Client)
-        .map_err(ContextError::ConnectionError)
-    }
-
-    fn client_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().client_ids_counter)
-    }
-
-    fn connection_end(&self, cid: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
-        match self.ibc_store.lock().connections.get(cid) {
-            Some(connection_end) => Ok(connection_end.clone()),
-            None => Err(ConnectionError::ConnectionNotFound {
-                connection_id: cid.clone(),
-            }),
-        }
-        .map_err(ContextError::ConnectionError)
-    }
-
-    fn validate_self_client(
-        &self,
-        client_state_of_host_on_counterparty: Any,
-    ) -> Result<(), ContextError> {
-        let mock_client_state = MockClientState::try_from(client_state_of_host_on_counterparty)
-            .map_err(|_| ConnectionError::InvalidClientState {
-                reason: "client must be a mock client".to_string(),
-            })
-            .map_err(ContextError::ConnectionError)?;
-
-        if mock_client_state.is_frozen() {
-            return Err(ClientError::ClientFrozen {
-                description: String::new(),
-            }
-            .into());
-        }
-
-        let self_chain_id = &self.host_chain_id;
-        let self_revision_number = self_chain_id.revision_number();
-        if self_revision_number != mock_client_state.latest_height().revision_number() {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client is not in the same revision as the chain. expected: {}, got: {}",
-                    self_revision_number,
-                    mock_client_state.latest_height().revision_number()
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
-        }
-
-        let host_current_height = self.latest_height().increment();
-        if mock_client_state.latest_height() >= host_current_height {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client has latest height {} greater than or equal to chain height {}",
-                    mock_client_state.latest_height(),
-                    host_current_height
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
-        }
-
-        Ok(())
-    }
-
-    fn commitment_prefix(&self) -> CommitmentPrefix {
-        CommitmentPrefix::try_from(b"mock".to_vec()).expect("Never fails")
-    }
-
-    fn connection_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().connection_ids_counter)
-    }
-
-    fn channel_end(&self, chan_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError> {
-        let port_id = &chan_end_path.0;
-        let channel_id = &chan_end_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .channels
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(channel_end) => Ok(channel_end.clone()),
-            None => Err(ChannelError::ChannelNotFound {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::ChannelError)
-    }
-
-    fn get_next_sequence_send(
-        &self,
-        seq_send_path: &SeqSendPath,
-    ) -> Result<Sequence, ContextError> {
-        let port_id = &seq_send_path.0;
-        let channel_id = &seq_send_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_send
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextSendSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn get_next_sequence_recv(
-        &self,
-        seq_recv_path: &SeqRecvPath,
-    ) -> Result<Sequence, ContextError> {
-        let port_id = &seq_recv_path.0;
-        let channel_id = &seq_recv_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_recv
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextRecvSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn get_next_sequence_ack(&self, seq_ack_path: &SeqAckPath) -> Result<Sequence, ContextError> {
-        let port_id = &seq_ack_path.0;
-        let channel_id = &seq_ack_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_ack
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextAckSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn get_packet_commitment(
-        &self,
-        commitment_path: &CommitmentPath,
-    ) -> Result<PacketCommitment, ContextError> {
-        let port_id = &commitment_path.port_id;
-        let channel_id = &commitment_path.channel_id;
-        let seq = &commitment_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_commitment
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(commitment) => Ok(commitment.clone()),
-            None => Err(PacketError::PacketCommitmentNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn get_packet_receipt(&self, receipt_path: &ReceiptPath) -> Result<Receipt, ContextError> {
-        let port_id = &receipt_path.port_id;
-        let channel_id = &receipt_path.channel_id;
-        let seq = &receipt_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_receipt
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(receipt) => Ok(receipt.clone()),
-            None => Err(PacketError::PacketReceiptNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn get_packet_acknowledgement(
-        &self,
-        ack_path: &AckPath,
-    ) -> Result<AcknowledgementCommitment, ContextError> {
-        let port_id = &ack_path.port_id;
-        let channel_id = &ack_path.channel_id;
-        let seq = &ack_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_acknowledgement
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(ack) => Ok(ack.clone()),
-            None => Err(PacketError::PacketAcknowledgementNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
-    fn channel_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().channel_ids_counter)
-    }
-
-    fn max_expected_time_per_block(&self) -> Duration {
-        self.block_time
-    }
-
-    fn validate_message_signer(&self, _signer: &Signer) -> Result<(), ContextError> {
-        Ok(())
-    }
-
-    fn get_client_validation_context(&self) -> &Self::V {
-        self
-    }
-}
-
-impl ExecutionContext for MockContext {
-    fn get_client_execution_context(&mut self) -> &mut Self::E {
-        self
-    }
-
-    fn increase_client_counter(&mut self) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        ibc_store.client_ids_counter = ibc_store
-            .client_ids_counter
-            .checked_add(1)
-            .ok_or(ClientError::CounterOverflow)?;
-
-        Ok(())
-    }
-
-    fn store_connection(
-        &mut self,
-        connection_path: &ConnectionPath,
-        connection_end: ConnectionEnd,
-    ) -> Result<(), ContextError> {
-        let connection_id = connection_path.0.clone();
-        self.ibc_store
-            .lock()
-            .connections
-            .insert(connection_id, connection_end);
-        Ok(())
-    }
-
-    fn store_connection_to_client(
-        &mut self,
-        client_connection_path: &ClientConnectionPath,
-        conn_id: ConnectionId,
-    ) -> Result<(), ContextError> {
-        let client_id = client_connection_path.0.clone();
-        self.ibc_store
-            .lock()
-            .client_connections
-            .insert(client_id, conn_id);
-        Ok(())
-    }
-
-    fn increase_connection_counter(&mut self) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        ibc_store.connection_ids_counter = ibc_store
-            .connection_ids_counter
-            .checked_add(1)
-            .ok_or(ClientError::CounterOverflow)?;
-
-        Ok(())
-    }
-
-    fn store_packet_commitment(
-        &mut self,
-        commitment_path: &CommitmentPath,
-        commitment: PacketCommitment,
-    ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_commitment
-            .entry(commitment_path.port_id.clone())
-            .or_default()
-            .entry(commitment_path.channel_id.clone())
-            .or_default()
-            .insert(commitment_path.sequence, commitment);
-        Ok(())
-    }
-
-    fn delete_packet_commitment(
-        &mut self,
-        commitment_path: &CommitmentPath,
-    ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_commitment
-            .get_mut(&commitment_path.port_id)
-            .and_then(|map| map.get_mut(&commitment_path.channel_id))
-            .and_then(|map| map.remove(&commitment_path.sequence));
-        Ok(())
-    }
-
-    fn store_packet_receipt(
-        &mut self,
-        path: &ReceiptPath,
-        receipt: Receipt,
-    ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_receipt
-            .entry(path.port_id.clone())
-            .or_default()
-            .entry(path.channel_id.clone())
-            .or_default()
-            .insert(path.sequence, receipt);
-        Ok(())
-    }
-
-    fn store_packet_acknowledgement(
-        &mut self,
-        ack_path: &AckPath,
-        ack_commitment: AcknowledgementCommitment,
-    ) -> Result<(), ContextError> {
-        let port_id = ack_path.port_id.clone();
-        let channel_id = ack_path.channel_id.clone();
-        let seq = ack_path.sequence;
-
-        self.ibc_store
-            .lock()
-            .packet_acknowledgement
-            .entry(port_id)
-            .or_default()
-            .entry(channel_id)
-            .or_default()
-            .insert(seq, ack_commitment);
-        Ok(())
-    }
-
-    fn delete_packet_acknowledgement(&mut self, ack_path: &AckPath) -> Result<(), ContextError> {
-        let port_id = ack_path.port_id.clone();
-        let channel_id = ack_path.channel_id.clone();
-        let sequence = ack_path.sequence;
-
-        self.ibc_store
-            .lock()
-            .packet_acknowledgement
-            .get_mut(&port_id)
-            .and_then(|map| map.get_mut(&channel_id))
-            .and_then(|map| map.remove(&sequence));
-        Ok(())
-    }
-
-    fn store_channel(
-        &mut self,
-        channel_end_path: &ChannelEndPath,
-        channel_end: ChannelEnd,
-    ) -> Result<(), ContextError> {
-        let port_id = channel_end_path.0.clone();
-        let channel_id = channel_end_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .channels
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, channel_end);
-        Ok(())
-    }
-
-    fn store_next_sequence_send(
-        &mut self,
-        seq_send_path: &SeqSendPath,
-        seq: Sequence,
-    ) -> Result<(), ContextError> {
-        let port_id = seq_send_path.0.clone();
-        let channel_id = seq_send_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_send
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
-        Ok(())
-    }
-
-    fn store_next_sequence_recv(
-        &mut self,
-        seq_recv_path: &SeqRecvPath,
-        seq: Sequence,
-    ) -> Result<(), ContextError> {
-        let port_id = seq_recv_path.0.clone();
-        let channel_id = seq_recv_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_recv
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
-        Ok(())
-    }
-
-    fn store_next_sequence_ack(
-        &mut self,
-        seq_ack_path: &SeqAckPath,
-        seq: Sequence,
-    ) -> Result<(), ContextError> {
-        let port_id = seq_ack_path.0.clone();
-        let channel_id = seq_ack_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_ack
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
-        Ok(())
-    }
-
-    fn increase_channel_counter(&mut self) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        ibc_store.channel_ids_counter = ibc_store
-            .channel_ids_counter
-            .checked_add(1)
-            .ok_or(ClientError::CounterOverflow)?;
-
-        Ok(())
-    }
-
-    fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
-        self.events.push(event);
-        Ok(())
-    }
-
-    fn log_message(&mut self, message: String) -> Result<(), ContextError> {
-        self.logs.push(message);
-        Ok(())
-    }
-}
-
 #[cfg(test)]
 mod tests {
+    use ibc::core::ics04_channel::acknowledgement::Acknowledgement;
+    use ibc::core::ics04_channel::channel::{Counterparty, Order};
+    use ibc::core::ics04_channel::error::{ChannelError, PacketError};
+    use ibc::core::ics04_channel::packet::Packet;
+    use ibc::core::ics04_channel::Version;
+    use ibc::core::ics24_host::identifier::{ChainId, ChannelId, ConnectionId, PortId};
+    use ibc::core::router::{Module, ModuleExtras, ModuleId};
+    use ibc::{Height, Signer};
     use test_log::test;
 
     use super::*;
-    use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-    use crate::core::ics04_channel::channel::{Counterparty, Order};
-    use crate::core::ics04_channel::error::ChannelError;
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChainId, ChannelId, ConnectionId, PortId};
-    use crate::core::router::{Module, ModuleExtras, ModuleId};
-    use crate::mock::context::MockContext;
-    use crate::mock::host::HostType;
-    use crate::mock::router::MockRouter;
-    use crate::signer::Signer;
-    use crate::test_utils::get_dummy_bech32_account;
-    use crate::Height;
+    use crate::testapp::ibc::core::router::MockRouter;
+    use crate::utils::core::channel::PacketConfig;
+    use crate::utils::core::signer::dummy_bech32_account;
 
     #[test]
     fn test_history_manipulation() {
@@ -1918,8 +1154,10 @@ mod tests {
         let mut on_recv_packet_result = |module_id: &'static str| {
             let module_id = ModuleId::new(module_id.to_string());
             let m = router.get_route_mut(&module_id).expect("Never fails");
-            let result =
-                m.on_recv_packet_execute(&Packet::default(), &get_dummy_bech32_account().into());
+
+            let packet = PacketConfig::builder().build();
+
+            let result = m.on_recv_packet_execute(&packet, &dummy_bech32_account().into());
             (module_id, result)
         };
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/mod.rs b/crates/ibc-testkit/src/testapp/ibc/mod.rs
new file mode 100644
index 000000000..f13a3c645
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/ibc/mod.rs
@@ -0,0 +1,3 @@
+pub mod applications;
+pub mod clients;
+pub mod core;
diff --git a/crates/ibc-testkit/src/testapp/mod.rs b/crates/ibc-testkit/src/testapp/mod.rs
new file mode 100644
index 000000000..0887f62f4
--- /dev/null
+++ b/crates/ibc-testkit/src/testapp/mod.rs
@@ -0,0 +1 @@
+pub mod ibc;
diff --git a/crates/ibc-testkit/src/utils/dummies/applications/mod.rs b/crates/ibc-testkit/src/utils/dummies/applications/mod.rs
new file mode 100644
index 000000000..544cab2c5
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/applications/mod.rs
@@ -0,0 +1,2 @@
+#[cfg(feature = "serde")]
+pub mod transfer;
diff --git a/crates/ibc-testkit/src/utils/dummies/applications/transfer.rs b/crates/ibc-testkit/src/utils/dummies/applications/transfer.rs
new file mode 100644
index 000000000..0bf50c99b
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/applications/transfer.rs
@@ -0,0 +1,80 @@
+use alloc::string::ToString;
+
+use ibc::applications::transfer::msgs::transfer::MsgTransfer;
+use ibc::applications::transfer::packet::PacketData;
+use ibc::applications::transfer::{Memo, PrefixedCoin};
+use ibc::core::ics04_channel::packet::{Packet, Sequence};
+use ibc::core::ics04_channel::timeout::TimeoutHeight;
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::core::timestamp::Timestamp;
+use ibc::Signer;
+use typed_builder::TypedBuilder;
+
+use crate::utils::dummies::core::signer::dummy_account_id;
+
+/// Configuration of the `MsgTransfer` message for building dummy messages.
+#[derive(TypedBuilder, Debug)]
+#[builder(build_method(into = MsgTransfer))]
+pub struct MsgTransferConfig {
+    #[builder(default = PortId::transfer())]
+    pub port_id_on_a: PortId,
+    #[builder(default)]
+    pub chan_id_on_a: ChannelId,
+    pub packet_data: PacketData,
+    #[builder(default)]
+    pub timeout_height_on_b: TimeoutHeight,
+    #[builder(default)]
+    pub timeout_timestamp_on_b: Timestamp,
+}
+
+impl From<MsgTransferConfig> for MsgTransfer {
+    fn from(config: MsgTransferConfig) -> Self {
+        MsgTransfer {
+            port_id_on_a: config.port_id_on_a,
+            chan_id_on_a: config.chan_id_on_a,
+            packet_data: config.packet_data,
+            timeout_height_on_b: config.timeout_height_on_b,
+            timeout_timestamp_on_b: config.timeout_timestamp_on_b,
+        }
+    }
+}
+
+pub fn extract_transfer_packet(msg: &MsgTransfer, sequence: Sequence) -> Packet {
+    let data = serde_json::to_vec(&msg.packet_data)
+        .expect("PacketData's infallible Serialize impl failed");
+
+    Packet {
+        seq_on_a: sequence,
+        port_id_on_a: msg.port_id_on_a.clone(),
+        chan_id_on_a: msg.chan_id_on_a.clone(),
+        port_id_on_b: PortId::transfer(),
+        chan_id_on_b: ChannelId::default(),
+        data,
+        timeout_height_on_b: msg.timeout_height_on_b,
+        timeout_timestamp_on_b: msg.timeout_timestamp_on_b,
+    }
+}
+
+/// Configuration of the `PacketData` type for building dummy packets.
+#[derive(TypedBuilder, Debug)]
+#[builder(build_method(into = PacketData))]
+pub struct PacketDataConfig {
+    pub token: PrefixedCoin,
+    #[builder(default = dummy_account_id())]
+    pub sender: Signer,
+    #[builder(default = dummy_account_id())]
+    pub receiver: Signer,
+    #[builder(default = Memo::from("".to_string()))]
+    pub memo: Memo,
+}
+
+impl From<PacketDataConfig> for PacketData {
+    fn from(config: PacketDataConfig) -> Self {
+        PacketData {
+            token: config.token,
+            sender: config.sender,
+            receiver: config.receiver,
+            memo: config.memo,
+        }
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/mock.rs b/crates/ibc-testkit/src/utils/dummies/clients/mock.rs
new file mode 100644
index 000000000..0f9350ff3
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/clients/mock.rs
@@ -0,0 +1,8 @@
+use ibc::Height;
+
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+
+/// Returns a dummy `MockHeader` with the given revision height.
+pub fn dummy_new_mock_header(revision_height: u64) -> MockHeader {
+    MockHeader::new(Height::new(0, revision_height).expect("Never fails"))
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/mod.rs b/crates/ibc-testkit/src/utils/dummies/clients/mod.rs
new file mode 100644
index 000000000..301d7f544
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/clients/mod.rs
@@ -0,0 +1,2 @@
+pub mod mock;
+pub mod tendermint;
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs b/crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs
new file mode 100644
index 000000000..c249c487e
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs
@@ -0,0 +1,160 @@
+use core::str::FromStr;
+use core::time::Duration;
+
+use ibc::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
+use ibc::clients::ics07_tendermint::error::{Error as ClientError, Error};
+#[cfg(feature = "serde")]
+use ibc::clients::ics07_tendermint::header::Header;
+use ibc::clients::ics07_tendermint::trust_threshold::TrustThreshold;
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics23_commitment::specs::ProofSpecs;
+use ibc::core::ics24_host::identifier::ChainId;
+use ibc::prelude::*;
+use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::proto::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+use tendermint::block::Header as TmHeader;
+
+/// Returns a dummy tendermint `ClientState` by given `frozen_height`, for testing purposes only!
+pub fn dummy_tm_client_state_from_raw(frozen_height: RawHeight) -> Result<ClientState, Error> {
+    ClientState::try_from(dummy_raw_tm_client_state(frozen_height))
+}
+
+/// Returns a dummy tendermint `ClientState` from a `TmHeader`, for testing purposes only!
+pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> ClientState {
+    let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
+    ClientState::new(
+        chain_id.clone(),
+        Default::default(),
+        Duration::from_secs(64000),
+        Duration::from_secs(128000),
+        Duration::from_millis(3000),
+        Height::new(chain_id.revision_number(), u64::from(tm_header.height)).expect("Never fails"),
+        Default::default(),
+        Default::default(),
+        AllowUpdate {
+            after_expiry: false,
+            after_misbehaviour: false,
+        },
+    )
+    .expect("Never fails")
+}
+
+/// Returns a dummy tendermint `RawTmClientState` by given `frozen_height`, for testing purposes only!
+pub fn dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
+    #[allow(deprecated)]
+    RawTmClientState {
+        chain_id: ChainId::new("ibc-0").expect("Never fails").to_string(),
+        trust_level: Some(Fraction {
+            numerator: 1,
+            denominator: 3,
+        }),
+        trusting_period: Some(Duration::from_secs(64000).into()),
+        unbonding_period: Some(Duration::from_secs(128000).into()),
+        max_clock_drift: Some(Duration::from_millis(3000).into()),
+        latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
+        proof_specs: ProofSpecs::default().into(),
+        upgrade_path: Default::default(),
+        frozen_height: Some(frozen_height),
+        allow_update_after_expiry: false,
+        allow_update_after_misbehaviour: false,
+    }
+}
+
+#[derive(typed_builder::TypedBuilder, Debug)]
+pub struct ClientStateConfig {
+    pub chain_id: ChainId,
+    #[builder(default)]
+    pub trust_level: TrustThreshold,
+    #[builder(default = Duration::from_secs(64000))]
+    pub trusting_period: Duration,
+    #[builder(default = Duration::from_secs(128000))]
+    pub unbonding_period: Duration,
+    #[builder(default = Duration::from_millis(3000))]
+    max_clock_drift: Duration,
+    pub latest_height: Height,
+    #[builder(default)]
+    pub proof_specs: ProofSpecs,
+    #[builder(default)]
+    pub upgrade_path: Vec<String>,
+    #[builder(default = AllowUpdate { after_expiry: false, after_misbehaviour: false })]
+    allow_update: AllowUpdate,
+}
+
+impl TryFrom<ClientStateConfig> for ClientState {
+    type Error = ClientError;
+
+    fn try_from(config: ClientStateConfig) -> Result<Self, Self::Error> {
+        ClientState::new(
+            config.chain_id,
+            config.trust_level,
+            config.trusting_period,
+            config.unbonding_period,
+            config.max_clock_drift,
+            config.latest_height,
+            config.proof_specs,
+            config.upgrade_path,
+            config.allow_update,
+        )
+    }
+}
+
+#[cfg(feature = "serde")]
+pub fn dummy_tendermint_header() -> tendermint::block::Header {
+    use tendermint::block::signed_header::SignedHeader;
+
+    serde_json::from_str::<SignedHeader>(include_str!(concat!(
+        env!("CARGO_MANIFEST_DIR"),
+        "/tests/data/json/signed_header.json"
+    )))
+    .expect("Never fails")
+    .header
+}
+
+// TODO: This should be replaced with a ::default() or ::produce().
+// The implementation of this function comprises duplicate code (code borrowed from
+// `tendermint-rs` for assembling a Header).
+// See https://github.com/informalsystems/tendermint-rs/issues/381.
+//
+// The normal flow is:
+// - get the (trusted) signed header and the `trusted_validator_set` at a `trusted_height`
+// - get the `signed_header` and the `validator_set` at latest height
+// - build the ics07 Header
+// For testing purposes this function does:
+// - get the `signed_header` from a .json file
+// - create the `validator_set` with a single validator that is also the proposer
+// - assume a `trusted_height` of 1 and no change in the validator set since height 1,
+//   i.e. `trusted_validator_set` = `validator_set`
+#[cfg(feature = "serde")]
+pub fn dummy_ics07_header() -> Header {
+    use subtle_encoding::hex;
+    use tendermint::block::signed_header::SignedHeader;
+    use tendermint::validator::{Info as ValidatorInfo, Set as ValidatorSet};
+    use tendermint::PublicKey;
+
+    // Build a SignedHeader from a JSON file.
+    let shdr = serde_json::from_str::<SignedHeader>(include_str!(concat!(
+        env!("CARGO_MANIFEST_DIR"),
+        "/tests/data/json/signed_header.json"
+    )))
+    .expect("Never fails");
+
+    // Build a set of validators.
+    // Below are test values inspired form `test_validator_set()` in tendermint-rs.
+    let v1: ValidatorInfo = ValidatorInfo::new(
+        PublicKey::from_raw_ed25519(
+            &hex::decode_upper("F349539C7E5EF7C49549B09C4BFC2335318AB0FE51FBFAA2433B4F13E816F4A7")
+                .expect("Never fails"),
+        )
+        .expect("Never fails"),
+        281_815_u64.try_into().expect("Never fails"),
+    );
+
+    let vs = ValidatorSet::new(vec![v1.clone()], Some(v1));
+
+    Header {
+        signed_header: shdr,
+        validator_set: vs.clone(),
+        trusted_height: Height::min(0),
+        trusted_next_validator_set: vs,
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
new file mode 100644
index 000000000..f1e1e0129
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
@@ -0,0 +1,26 @@
+use ibc::proto::core::channel::v1::{
+    MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
+};
+use ibc::proto::core::client::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgAcknowledgement`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_acknowledgement(height: u64) -> RawMsgAcknowledgement {
+    dummy_raw_msg_ack_with_packet(dummy_raw_packet(height, 1), height)
+}
+
+pub fn dummy_raw_msg_ack_with_packet(packet: RawPacket, height: u64) -> RawMsgAcknowledgement {
+    RawMsgAcknowledgement {
+        packet: Some(packet),
+        acknowledgement: dummy_proof(),
+        proof_acked: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
new file mode 100644
index 000000000..42645de42
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
@@ -0,0 +1,21 @@
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
+use ibc::proto::core::client::v1::Height;
+
+use super::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelCloseConfirm`, for testing purposes only!
+pub fn dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelCloseConfirm {
+    RawMsgChannelCloseConfirm {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        proof_init: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
new file mode 100644
index 000000000..492090cda
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
@@ -0,0 +1,14 @@
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelCloseInit`, for testing purposes only!
+pub fn dummy_raw_msg_chan_close_init() -> RawMsgChannelCloseInit {
+    RawMsgChannelCloseInit {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
new file mode 100644
index 000000000..087c3d31a
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
@@ -0,0 +1,23 @@
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+use ibc::proto::core::client::v1::Height;
+
+use super::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenAck`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
+    RawMsgChannelOpenAck {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        counterparty_channel_id: ChannelId::default().to_string(),
+        counterparty_version: "".to_string(),
+        proof_try: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
new file mode 100644
index 000000000..68140bd2e
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
@@ -0,0 +1,21 @@
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+use ibc::proto::core::client::v1::Height;
+
+use super::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenConfirm`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
+    RawMsgChannelOpenConfirm {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        proof_ack: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
new file mode 100644
index 000000000..d161134a2
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
@@ -0,0 +1,15 @@
+use ibc::core::ics24_host::identifier::PortId;
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+
+use super::dummy_raw_channel_end;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenInit`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_init(counterparty_channel_id: Option<u64>) -> RawMsgChannelOpenInit {
+    RawMsgChannelOpenInit {
+        port_id: PortId::transfer().to_string(),
+        channel: Some(dummy_raw_channel_end(1, counterparty_channel_id)),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
new file mode 100644
index 000000000..1bedea696
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
@@ -0,0 +1,24 @@
+use ibc::core::ics24_host::identifier::PortId;
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
+use ibc::proto::core::client::v1::Height;
+
+use super::{dummy_proof, dummy_raw_channel_end};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenTry`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_try(proof_height: u64) -> RawMsgChannelOpenTry {
+    #[allow(deprecated)]
+    RawMsgChannelOpenTry {
+        port_id: PortId::transfer().to_string(),
+        previous_channel_id: "".to_string(),
+        channel: Some(dummy_raw_channel_end(2, Some(0))),
+        counterparty_version: "".to_string(),
+        proof_init: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs
new file mode 100644
index 000000000..3e5a083da
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs
@@ -0,0 +1,50 @@
+mod acknowledgement;
+mod chan_close_confirm;
+mod chan_close_init;
+mod chan_open_ack;
+mod chan_open_confirm;
+mod chan_open_init;
+mod chan_open_try;
+mod packet;
+mod recv_packet;
+mod timeout;
+mod timeout_on_close;
+
+pub use acknowledgement::*;
+pub use chan_close_confirm::*;
+pub use chan_close_init::*;
+pub use chan_open_ack::*;
+pub use chan_open_confirm::*;
+pub use chan_open_init::*;
+pub use chan_open_try::*;
+use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::{Channel as RawChannel, Counterparty as RawCounterparty};
+pub use packet::*;
+pub use recv_packet::*;
+pub use timeout::*;
+pub use timeout_on_close::*;
+
+/// Returns a dummy `RawCounterparty`, for testing purposes only!
+/// Can be optionally parametrized with a specific channel identifier.
+pub fn dummy_raw_counterparty_chan(channel_id: String) -> RawCounterparty {
+    RawCounterparty {
+        port_id: PortId::transfer().to_string(),
+        channel_id,
+    }
+}
+
+/// Returns a dummy `RawChannel`, for testing purposes only!
+pub fn dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel {
+    let channel_id = match channel_id {
+        Some(id) => ChannelId::new(id).to_string(),
+        None => "".to_string(),
+    };
+    RawChannel {
+        state,
+        ordering: 2,
+        counterparty: Some(dummy_raw_counterparty_chan(channel_id)),
+        connection_hops: vec![ConnectionId::default().to_string()],
+        version: "".to_string(), // The version is not validated.
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs
new file mode 100644
index 000000000..9045dd320
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs
@@ -0,0 +1,68 @@
+use ibc::core::ics04_channel::packet::{Packet, Sequence};
+use ibc::core::ics04_channel::timeout::TimeoutHeight;
+use ibc::core::ics24_host::identifier::{ChannelId, PortId};
+use ibc::core::timestamp::Timestamp;
+use ibc::prelude::*;
+use ibc::proto::core::channel::v1::Packet as RawPacket;
+use ibc::proto::core::client::v1::Height as RawHeight;
+use typed_builder::TypedBuilder;
+
+/// Configuration of the `PacketData` type for building dummy packets.
+#[derive(TypedBuilder, Debug)]
+#[builder(build_method(into = Packet))]
+pub struct PacketConfig {
+    #[builder(default)]
+    pub seq_on_a: Sequence,
+    #[builder(default = PortId::transfer())]
+    pub port_id_on_a: PortId,
+    #[builder(default)]
+    pub chan_id_on_a: ChannelId,
+    #[builder(default = PortId::transfer())]
+    pub port_id_on_b: PortId,
+    #[builder(default)]
+    pub chan_id_on_b: ChannelId,
+    #[builder(default)]
+    pub data: Vec<u8>,
+    #[builder(default)]
+    pub timeout_height_on_b: TimeoutHeight,
+    #[builder(default)]
+    pub timeout_timestamp_on_b: Timestamp,
+}
+
+impl From<PacketConfig> for Packet {
+    fn from(config: PacketConfig) -> Self {
+        Packet {
+            seq_on_a: config.seq_on_a,
+            port_id_on_a: config.port_id_on_a,
+            chan_id_on_a: config.chan_id_on_a,
+            port_id_on_b: config.port_id_on_b,
+            chan_id_on_b: config.chan_id_on_b,
+            data: config.data,
+            timeout_height_on_b: config.timeout_height_on_b,
+            timeout_timestamp_on_b: config.timeout_timestamp_on_b,
+        }
+    }
+}
+
+/// Returns a dummy `RawPacket`, for testing purposes only!
+pub fn dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacket {
+    RawPacket {
+        sequence: 1,
+        source_port: PortId::transfer().to_string(),
+        source_channel: ChannelId::default().to_string(),
+        destination_port: PortId::transfer().to_string(),
+        destination_channel: ChannelId::default().to_string(),
+        data: vec![0],
+        timeout_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: timeout_height,
+        }),
+        timeout_timestamp,
+    }
+}
+
+pub fn dummy_proof() -> Vec<u8> {
+    "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
+        .as_bytes()
+        .to_vec()
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
new file mode 100644
index 000000000..a9e521859
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
@@ -0,0 +1,45 @@
+use core::ops::Add;
+use core::time::Duration;
+
+use ibc::core::ics04_channel::msgs::MsgRecvPacket;
+use ibc::core::ics04_channel::packet::Packet;
+use ibc::core::ics23_commitment::commitment::CommitmentProofBytes;
+use ibc::core::timestamp::Timestamp;
+use ibc::proto::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
+use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::{Height, Signer};
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+pub fn dummy_msg_recv_packet(
+    packet: Packet,
+    proof_commitment_on_a: CommitmentProofBytes,
+    proof_height_on_a: Height,
+    signer: Signer,
+) -> MsgRecvPacket {
+    MsgRecvPacket {
+        packet,
+        proof_commitment_on_a,
+        proof_height_on_a,
+        signer,
+    }
+}
+
+/// Returns a dummy `RawMsgRecvPacket`, for testing purposes only! The `height`
+/// parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_recv_packet(height: u64) -> RawMsgRecvPacket {
+    let timestamp = Timestamp::now().add(Duration::from_secs(9));
+    RawMsgRecvPacket {
+        packet: Some(dummy_raw_packet(
+            height,
+            timestamp.expect("timestamp").nanoseconds(),
+        )),
+        proof_commitment: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
new file mode 100644
index 000000000..db08b045c
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
@@ -0,0 +1,24 @@
+use ibc::proto::core::channel::v1::MsgTimeout as RawMsgTimeout;
+use ibc::proto::core::client::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgTimeout`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_timeout(
+    proof_height: u64,
+    timeout_height: u64,
+    timeout_timestamp: u64,
+) -> RawMsgTimeout {
+    RawMsgTimeout {
+        packet: Some(dummy_raw_packet(timeout_height, timeout_timestamp)),
+        proof_unreceived: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        next_sequence_recv: 1,
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs b/crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
new file mode 100644
index 000000000..c11bcd187
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
@@ -0,0 +1,21 @@
+use ibc::proto::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
+use ibc::proto::core::client::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgTimeoutOnClose`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_timeout_on_close(height: u64, timeout_timestamp: u64) -> RawMsgTimeoutOnClose {
+    RawMsgTimeoutOnClose {
+        packet: Some(dummy_raw_packet(height, timeout_timestamp)),
+        proof_unreceived: dummy_proof(),
+        proof_close: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        next_sequence_recv: 1,
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/mod.rs b/crates/ibc-testkit/src/utils/dummies/core/client/mod.rs
new file mode 100644
index 000000000..aaacce78c
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/client/mod.rs
@@ -0,0 +1,11 @@
+#[cfg(feature = "serde")]
+mod msg_create_client;
+#[cfg(feature = "serde")]
+mod msg_update_client;
+mod msg_upgrade_client;
+
+#[cfg(feature = "serde")]
+pub use msg_create_client::*;
+#[cfg(feature = "serde")]
+pub use msg_update_client::*;
+pub use msg_upgrade_client::*;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs b/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
new file mode 100644
index 000000000..8c93071d0
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
@@ -0,0 +1,21 @@
+use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::proto::core::client::v1::MsgCreateClient;
+use ibc::proto::Any;
+
+use crate::utils::dummies::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgCreateClient`, for testing purposes only!
+pub fn dummy_raw_msg_create_client() -> MsgCreateClient {
+    let tm_header = dummy_tendermint_header();
+
+    let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone());
+
+    MsgCreateClient {
+        client_state: Some(Any::from(tm_client_state)),
+        consensus_state: Some(Any::from(TmConsensusState::try_from(tm_header).unwrap())),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs b/crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
new file mode 100644
index 000000000..5ff980504
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
@@ -0,0 +1,18 @@
+use ibc::proto::core::client::v1::MsgUpdateClient;
+use ibc::proto::Any;
+
+use crate::utils::dummies::clients::tendermint::dummy_ics07_header;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgUpdateClient`, for testing purposes only!
+pub fn dummy_raw_msg_update_client() -> MsgUpdateClient {
+    let client_id = "07-tendermint-0".parse().unwrap();
+
+    let tm_header = dummy_ics07_header();
+
+    MsgUpdateClient {
+        client_id,
+        client_message: Some(Any::from(tm_header)),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs b/crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
new file mode 100644
index 000000000..3c42c10f7
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
@@ -0,0 +1,38 @@
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::proto::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
+
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::utils::dummies::core::commitment::dummy_commitment_proof_bytes;
+use crate::utils::dummies::core::signer::{dummy_account_id, dummy_bech32_account};
+
+/// Returns a dummy `MsgUpgradeClient`, for testing purposes only!
+pub fn dummy_msg_upgrade_client(client_id: ClientId, upgrade_height: Height) -> MsgUpgradeClient {
+    MsgUpgradeClient {
+        client_id,
+        upgraded_client_state: MockClientState::new(MockHeader::new(upgrade_height)).into(),
+        upgraded_consensus_state: MockConsensusState::new(MockHeader::new(upgrade_height)).into(),
+        proof_upgrade_client: dummy_commitment_proof_bytes(),
+        proof_upgrade_consensus_state: dummy_commitment_proof_bytes(),
+        signer: dummy_account_id(),
+    }
+}
+
+/// Returns a dummy `RawMsgUpgradeClient`, for testing purposes only!
+pub fn dummy_raw_msg_upgrade_client() -> RawMsgUpgradeClient {
+    let client_id = "07-tendermint-0".parse().unwrap();
+
+    let upgrade_height = Height::new(0, 10).expect("Never fails");
+
+    RawMsgUpgradeClient {
+        client_id,
+        client_state: Some(MockClientState::new(MockHeader::new(upgrade_height)).into()),
+        consensus_state: Some(MockConsensusState::new(MockHeader::new(upgrade_height)).into()),
+        proof_upgrade_client: dummy_commitment_proof_bytes().into(),
+        proof_upgrade_consensus_state: dummy_commitment_proof_bytes().into(),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/commitment.rs b/crates/ibc-testkit/src/utils/dummies/core/commitment.rs
new file mode 100644
index 000000000..c4939556e
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/commitment.rs
@@ -0,0 +1,14 @@
+use ibc::core::ics23_commitment::commitment::CommitmentProofBytes;
+use ibc::prelude::*;
+use ibc::proto::core::commitment::v1::MerkleProof as RawMerkleProof;
+use ibc::proto::ics23::CommitmentProof;
+
+/// Returns a dummy `CommitmentProofBytes`, for testing purposes only!
+pub fn dummy_commitment_proof_bytes() -> CommitmentProofBytes {
+    let parsed = CommitmentProof { proof: None };
+    let mproofs: Vec<CommitmentProof> = vec![parsed];
+    let raw_mp = RawMerkleProof { proofs: mproofs };
+    raw_mp
+        .try_into()
+        .expect("could not convert to CommitmentProofBytes")
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
new file mode 100644
index 000000000..b1a18e862
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
@@ -0,0 +1,45 @@
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
+use ibc::core::ics03_connection::version::Version;
+use ibc::core::ics24_host::identifier::ConnectionId;
+use ibc::prelude::*;
+use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::proto::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::utils::dummies::core::channel::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `MsgConnectionOpenAck` with dummy values.
+pub fn dummy_msg_conn_open_ack(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenAck {
+    MsgConnectionOpenAck::try_from(dummy_raw_msg_conn_open_ack(proof_height, consensus_height))
+        .expect("Never fails")
+}
+
+/// Returns a dummy `RawMsgConnectionOpenAck`, for testing purposes only!
+pub fn dummy_raw_msg_conn_open_ack(
+    proof_height: u64,
+    consensus_height: u64,
+) -> RawMsgConnectionOpenAck {
+    let client_state_height = Height::new(0, consensus_height).expect("invalid height");
+    RawMsgConnectionOpenAck {
+        connection_id: ConnectionId::new(0).to_string(),
+        counterparty_connection_id: ConnectionId::new(1).to_string(),
+        proof_try: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        proof_consensus: dummy_proof(),
+        consensus_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: consensus_height,
+        }),
+        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
+        proof_client: dummy_proof(),
+        version: Some(Version::default().into()),
+        signer: dummy_bech32_account(),
+        host_consensus_state_proof: vec![],
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
new file mode 100644
index 000000000..f5f4f4764
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
@@ -0,0 +1,26 @@
+use alloc::string::ToString;
+
+use ibc::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
+use ibc::proto::core::client::v1::Height;
+use ibc::proto::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+
+use crate::utils::dummies::core::channel::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `MsgConnectionOpenConfirm` for testing purposes only!
+pub fn dummy_conn_open_confirm() -> MsgConnectionOpenConfirm {
+    MsgConnectionOpenConfirm::try_from(dummy_raw_msg_conn_open_confirm()).expect("Never fails")
+}
+
+/// Returns a dummy `RawMsgConnectionOpenConfirm` for testing purposes only!
+pub fn dummy_raw_msg_conn_open_confirm() -> RawMsgConnectionOpenConfirm {
+    RawMsgConnectionOpenConfirm {
+        connection_id: "srcconnection".to_string(),
+        proof_ack: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: 10,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
new file mode 100644
index 000000000..588737a0f
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
@@ -0,0 +1,80 @@
+use ibc::core::ics03_connection::connection::Counterparty;
+use ibc::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
+use ibc::core::ics03_connection::version::Version;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::prelude::*;
+use ibc::proto::core::connection::v1::{
+    MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
+};
+
+use super::dummy_raw_counterparty_conn;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+pub fn raw_version_from_identifier(identifier: &str) -> Option<RawVersion> {
+    if identifier.is_empty() {
+        return None;
+    }
+
+    Some(RawVersion {
+        identifier: identifier.to_string(),
+        features: vec![],
+    })
+}
+
+/// Returns a dummy `MsgConnectionOpenInit` for testing purposes only!
+pub fn dummy_msg_conn_open_init() -> MsgConnectionOpenInit {
+    MsgConnectionOpenInit::try_from(dummy_raw_msg_conn_open_init()).expect("Never fails")
+}
+
+/// Setter for `client_id`. Amenable to chaining, since it consumes the input message.
+pub fn dummy_msg_conn_open_init_with_client_id(
+    msg: MsgConnectionOpenInit,
+    client_id: ClientId,
+) -> MsgConnectionOpenInit {
+    MsgConnectionOpenInit {
+        client_id_on_a: client_id,
+        ..msg
+    }
+}
+
+/// Setter for `counterparty`. Amenable to chaining, since it consumes the input message.
+pub fn msg_conn_open_init_with_counterparty_conn_id(
+    msg: MsgConnectionOpenInit,
+    counterparty_conn_id: u64,
+) -> MsgConnectionOpenInit {
+    let counterparty =
+        Counterparty::try_from(dummy_raw_counterparty_conn(Some(counterparty_conn_id)))
+            .expect("Never fails");
+    MsgConnectionOpenInit {
+        counterparty,
+        ..msg
+    }
+}
+
+/// Setter for the connection `version`
+pub fn msg_conn_open_with_version(
+    msg: MsgConnectionOpenInit,
+    identifier: Option<&str>,
+) -> MsgConnectionOpenInit {
+    let version = match identifier {
+        Some(v) => Version::try_from(RawVersion {
+            identifier: v.to_string(),
+            features: vec![],
+        })
+        .expect("could not create version from identifier")
+        .into(),
+        None => None,
+    };
+    MsgConnectionOpenInit { version, ..msg }
+}
+
+/// Returns a dummy `RawMsgConnectionOpenInit`, for testing purposes only!
+pub fn dummy_raw_msg_conn_open_init() -> RawMsgConnectionOpenInit {
+    RawMsgConnectionOpenInit {
+        client_id: ClientId::default().to_string(),
+        counterparty: Some(dummy_raw_counterparty_conn(None)),
+        version: Some(Version::default().into()),
+        delay_period: 0,
+        signer: dummy_bech32_account(),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
new file mode 100644
index 000000000..3d6bb0956
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
@@ -0,0 +1,66 @@
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::prelude::*;
+use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::proto::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
+
+use super::dummy_raw_counterparty_conn;
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::utils::dummies::core::channel::dummy_proof;
+use crate::utils::dummies::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `MsgConnectionOpenTry` for testing purposes only!
+pub fn dummy_msg_conn_open_try(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenTry {
+    MsgConnectionOpenTry::try_from(dummy_raw_msg_conn_open_try(proof_height, consensus_height))
+        .expect("Never fails")
+}
+/// Setter for the `client_id`
+pub fn msg_conn_open_try_with_client_id(
+    msg: MsgConnectionOpenTry,
+    client_id: ClientId,
+) -> MsgConnectionOpenTry {
+    MsgConnectionOpenTry {
+        client_id_on_b: client_id,
+        ..msg
+    }
+}
+
+/// Returns a dummy `RawMsgConnectionOpenTry` with parametrized heights. The parameter
+/// `proof_height` represents the height, on the source chain, at which this chain produced the
+/// proof. Parameter `consensus_height` represents the height of destination chain which a
+/// client on the source chain stores.
+pub fn dummy_raw_msg_conn_open_try(
+    proof_height: u64,
+    consensus_height: u64,
+) -> RawMsgConnectionOpenTry {
+    let client_state_height = Height::new(0, consensus_height).expect("could not create height");
+
+    #[allow(deprecated)]
+    RawMsgConnectionOpenTry {
+        client_id: ClientId::default().to_string(),
+        previous_connection_id: ConnectionId::default().to_string(),
+        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
+        counterparty: Some(dummy_raw_counterparty_conn(Some(0))),
+        delay_period: 0,
+        counterparty_versions: get_compatible_versions()
+            .iter()
+            .map(|v| v.clone().into())
+            .collect(),
+        proof_init: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        proof_consensus: dummy_proof(),
+        consensus_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: consensus_height,
+        }),
+        proof_client: dummy_proof(),
+        signer: dummy_bech32_account(),
+        host_consensus_state_proof: vec![],
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs b/crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs
new file mode 100644
index 000000000..15bc1990b
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs
@@ -0,0 +1,51 @@
+mod conn_open_ack;
+mod conn_open_confirm;
+mod conn_open_init;
+mod conn_open_try;
+
+pub use conn_open_ack::*;
+pub use conn_open_confirm::*;
+pub use conn_open_init::*;
+pub use conn_open_try::*;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::prelude::*;
+use ibc::proto::core::commitment::v1::MerklePrefix;
+use ibc::proto::core::connection::v1::Counterparty as RawCounterparty;
+use typed_builder::TypedBuilder;
+
+#[derive(TypedBuilder, Debug)]
+#[builder(build_method(into = RawCounterparty))]
+pub struct CounterpartyConfig {
+    #[builder(default = "07-tendermint-0")]
+    client_id: &'static str,
+    #[builder(default = "connection-0")]
+    connection_id: &'static str,
+    #[builder(default = Some(MerklePrefix {
+        key_prefix: b"ibc".to_vec()
+    }))]
+    prefix: Option<MerklePrefix>,
+}
+
+impl From<CounterpartyConfig> for RawCounterparty {
+    fn from(config: CounterpartyConfig) -> Self {
+        Self {
+            client_id: config.client_id.to_string(),
+            connection_id: config.connection_id.to_string(),
+            prefix: config.prefix,
+        }
+    }
+}
+
+pub fn dummy_raw_counterparty_conn(conn_id: Option<u64>) -> RawCounterparty {
+    let connection_id = match conn_id {
+        Some(id) => ConnectionId::new(id).to_string(),
+        None => "".to_string(),
+    };
+    RawCounterparty {
+        client_id: ClientId::default().to_string(),
+        connection_id,
+        prefix: Some(MerklePrefix {
+            key_prefix: b"ibc".to_vec(),
+        }),
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/context.rs b/crates/ibc-testkit/src/utils/dummies/core/context.rs
new file mode 100644
index 000000000..6c7b95af1
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/context.rs
@@ -0,0 +1,127 @@
+use alloc::sync::Arc;
+use core::cmp::min;
+use core::ops::{Add, Sub};
+use core::time::Duration;
+
+use ibc::core::ics24_host::identifier::ChainId;
+use ibc::core::timestamp::Timestamp;
+use ibc::prelude::*;
+use ibc::Height;
+use parking_lot::Mutex;
+use tendermint_testgen::Validator as TestgenValidator;
+use typed_builder::TypedBuilder;
+
+use crate::hosts::block::{HostBlock, HostType};
+use crate::testapp::ibc::core::types::{MockContext, MockIbcStore, DEFAULT_BLOCK_TIME_SECS};
+
+/// Configuration of the `MockContext` type for generating dummy contexts.
+#[derive(Debug, TypedBuilder)]
+#[builder(build_method(into = MockContext))]
+pub struct MockContextConfig {
+    #[builder(default = HostType::Mock)]
+    host_type: HostType,
+
+    host_id: ChainId,
+
+    #[builder(default = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS))]
+    block_time: Duration,
+
+    // may panic if validator_set_history size is less than max_history_size + 1
+    #[builder(default = 5)]
+    max_history_size: u64,
+
+    #[builder(default, setter(strip_option))]
+    validator_set_history: Option<Vec<Vec<TestgenValidator>>>,
+
+    latest_height: Height,
+
+    #[builder(default = Timestamp::now())]
+    latest_timestamp: Timestamp,
+}
+
+impl From<MockContextConfig> for MockContext {
+    fn from(params: MockContextConfig) -> Self {
+        assert_ne!(
+            params.max_history_size, 0,
+            "The chain must have a non-zero max_history_size"
+        );
+
+        assert_ne!(
+            params.latest_height.revision_height(),
+            0,
+            "The chain must have a non-zero revision_height"
+        );
+
+        // Compute the number of blocks to store.
+        let n = min(
+            params.max_history_size,
+            params.latest_height.revision_height(),
+        );
+
+        assert_eq!(
+            params.host_id.revision_number(),
+            params.latest_height.revision_number(),
+            "The version in the chain identifier must match the version in the latest height"
+        );
+
+        let next_block_timestamp = params
+            .latest_timestamp
+            .add(params.block_time)
+            .expect("Never fails");
+
+        let history = if let Some(validator_set_history) = params.validator_set_history {
+            (0..n)
+                .rev()
+                .map(|i| {
+                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
+                    // where N = now(), BT = block_time
+                    HostBlock::generate_block_with_validators(
+                        params.host_id.clone(),
+                        params.host_type,
+                        params
+                            .latest_height
+                            .sub(i)
+                            .expect("Never fails")
+                            .revision_height(),
+                        next_block_timestamp
+                            .sub(params.block_time * ((i + 1) as u32))
+                            .expect("Never fails"),
+                        &validator_set_history[(n - i) as usize - 1],
+                        &validator_set_history[(n - i) as usize],
+                    )
+                })
+                .collect()
+        } else {
+            (0..n)
+                .rev()
+                .map(|i| {
+                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
+                    // where N = now(), BT = block_time
+                    HostBlock::generate_block(
+                        params.host_id.clone(),
+                        params.host_type,
+                        params
+                            .latest_height
+                            .sub(i)
+                            .expect("Never fails")
+                            .revision_height(),
+                        next_block_timestamp
+                            .sub(params.block_time * ((i + 1) as u32))
+                            .expect("Never fails"),
+                    )
+                })
+                .collect()
+        };
+
+        MockContext {
+            host_chain_type: params.host_type,
+            host_chain_id: params.host_id.clone(),
+            max_history_size: params.max_history_size,
+            history,
+            block_time: params.block_time,
+            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
+            events: Vec::new(),
+            logs: Vec::new(),
+        }
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/core/mod.rs b/crates/ibc-testkit/src/utils/dummies/core/mod.rs
new file mode 100644
index 000000000..1fe85ed5d
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/mod.rs
@@ -0,0 +1,6 @@
+pub mod channel;
+pub mod client;
+pub mod commitment;
+pub mod connection;
+pub mod context;
+pub mod signer;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/signer.rs b/crates/ibc-testkit/src/utils/dummies/core/signer.rs
new file mode 100644
index 000000000..2d74049a8
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/core/signer.rs
@@ -0,0 +1,12 @@
+use ibc::prelude::*;
+use ibc::Signer;
+
+pub fn dummy_account_id() -> Signer {
+    "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
+        .to_string()
+        .into()
+}
+
+pub fn dummy_bech32_account() -> String {
+    "cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng".to_string()
+}
diff --git a/crates/ibc-testkit/src/utils/dummies/mod.rs b/crates/ibc-testkit/src/utils/dummies/mod.rs
new file mode 100644
index 000000000..f13a3c645
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/dummies/mod.rs
@@ -0,0 +1,3 @@
+pub mod applications;
+pub mod clients;
+pub mod core;
diff --git a/crates/ibc-testkit/src/utils/fixture.rs b/crates/ibc-testkit/src/utils/fixture.rs
new file mode 100644
index 000000000..134c41c1f
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/fixture.rs
@@ -0,0 +1,35 @@
+use core::fmt::Debug;
+
+use ibc::core::RouterError;
+use ibc::prelude::{String, *};
+
+use crate::testapp::ibc::core::types::MockContext;
+
+pub enum Expect {
+    Success,
+    Failure(Option<RouterError>),
+}
+
+#[derive(Clone, Debug)]
+pub struct Fixture<M: Debug> {
+    pub ctx: MockContext,
+    pub msg: M,
+}
+
+impl<M: Debug> Fixture<M> {
+    pub fn generate_error_msg(
+        &self,
+        expect: &Expect,
+        process: &str,
+        res: &Result<(), RouterError>,
+    ) -> String {
+        let base_error = match expect {
+            Expect::Success => "step failed!",
+            Expect::Failure(_) => "step passed but was supposed to fail!",
+        };
+        format!(
+            "{process} {base_error} /n {res:?} /n {:?} /n {:?}",
+            &self.msg, &self.ctx
+        )
+    }
+}
diff --git a/crates/ibc-testkit/src/utils/mod.rs b/crates/ibc-testkit/src/utils/mod.rs
new file mode 100644
index 000000000..35f40c216
--- /dev/null
+++ b/crates/ibc-testkit/src/utils/mod.rs
@@ -0,0 +1,5 @@
+mod dummies;
+mod fixture;
+
+pub use dummies::*;
+pub use fixture::*;
diff --git a/crates/ibc-testkit/tests/applications/mod.rs b/crates/ibc-testkit/tests/applications/mod.rs
new file mode 100644
index 000000000..014e52f27
--- /dev/null
+++ b/crates/ibc-testkit/tests/applications/mod.rs
@@ -0,0 +1 @@
+pub mod transfer;
diff --git a/crates/ibc-testkit/tests/applications/transfer.rs b/crates/ibc-testkit/tests/applications/transfer.rs
new file mode 100644
index 000000000..64d56b8c2
--- /dev/null
+++ b/crates/ibc-testkit/tests/applications/transfer.rs
@@ -0,0 +1,167 @@
+use ibc::applications::transfer::context::{
+    cosmos_adr028_escrow_address, on_chan_open_init_execute, on_chan_open_init_validate,
+    on_chan_open_try_execute, on_chan_open_try_validate,
+};
+use ibc::applications::transfer::VERSION;
+use ibc::core::ics04_channel::channel::{Counterparty, Order};
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
+use subtle_encoding::bech32;
+
+fn get_defaults() -> (
+    DummyTransferModule,
+    Order,
+    Vec<ConnectionId>,
+    PortId,
+    ChannelId,
+    Counterparty,
+) {
+    let order = Order::Unordered;
+    let connection_hops = vec![ConnectionId::new(1)];
+    let port_id = PortId::transfer();
+    let channel_id = ChannelId::new(1);
+    let counterparty = Counterparty::new(port_id.clone(), Some(channel_id.clone()));
+
+    (
+        DummyTransferModule,
+        order,
+        connection_hops,
+        port_id,
+        channel_id,
+        counterparty,
+    )
+}
+
+#[test]
+fn test_cosmos_escrow_address() {
+    fn assert_eq_escrow_address(port_id: &str, channel_id: &str, address: &str) {
+        let port_id = port_id.parse().unwrap();
+        let channel_id = channel_id.parse().unwrap();
+        let gen_address = {
+            let addr = cosmos_adr028_escrow_address(&port_id, &channel_id);
+            bech32::encode("cosmos", addr)
+        };
+        assert_eq!(gen_address, address.to_owned())
+    }
+
+    // addresses obtained using `gaiad query ibc-transfer escrow-address [port-id] [channel-id]`
+    assert_eq_escrow_address(
+        "transfer",
+        "channel-141",
+        "cosmos1x54ltnyg88k0ejmk8ytwrhd3ltm84xehrnlslf",
+    );
+    assert_eq_escrow_address(
+        "transfer",
+        "channel-207",
+        "cosmos1ju6tlfclulxumtt2kglvnxduj5d93a64r5czge",
+    );
+    assert_eq_escrow_address(
+        "transfer",
+        "channel-187",
+        "cosmos177x69sver58mcfs74x6dg0tv6ls4s3xmmcaw53",
+    );
+}
+
+/// If the relayer passed "", indicating that it wants us to return the versions we support.
+/// We currently only support ics20
+#[test]
+fn test_on_chan_open_init_empty_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new("".to_string());
+
+    let (_, out_version) = on_chan_open_init_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the relayer passed in the only supported version (ics20), then return ics20
+#[test]
+fn test_on_chan_open_init_ics20_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new(VERSION.to_string());
+    let (_, out_version) = on_chan_open_init_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the relayer passed in an unsupported version, then fail
+#[test]
+fn test_on_chan_open_init_incorrect_version() {
+    let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new("some-unsupported-version".to_string());
+    let res = on_chan_open_init_validate(
+        &ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    );
+
+    assert!(res.is_err());
+}
+
+/// If the counterparty supports ics20, then return ics20
+#[test]
+fn test_on_chan_open_try_counterparty_correct_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let counterparty_version = Version::new(VERSION.to_string());
+
+    let (_, out_version) = on_chan_open_try_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &counterparty_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the counterparty doesn't support ics20, then fail
+#[test]
+fn test_on_chan_open_try_counterparty_incorrect_version() {
+    let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let counterparty_version = Version::new("some-unsupported-version".to_string());
+
+    let res = on_chan_open_try_validate(
+        &ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &counterparty_version,
+    );
+
+    assert!(res.is_err());
+}
diff --git a/crates/ibc-testkit/tests/core/ics02_client/create_client.rs b/crates/ibc-testkit/tests/core/ics02_client/create_client.rs
new file mode 100644
index 000000000..0e239b3a1
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -0,0 +1,95 @@
+use ibc::clients::ics07_tendermint::client_type as tm_client_type;
+use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::core::ics02_client::client_state::ClientStateCommon;
+use ibc::core::ics02_client::msgs::create_client::MsgCreateClient;
+use ibc::core::ics02_client::msgs::ClientMsg;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::Height;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::{
+    client_type as mock_client_type, MockClientState,
+};
+use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use ibc_testkit::utils::core::signer::dummy_account_id;
+use test_log::test;
+
+#[test]
+fn test_create_client_ok() {
+    let mut ctx = MockContext::default();
+    let mut router = MockRouter::new_with_transfer();
+    let signer = dummy_account_id();
+    let height = Height::new(0, 42).unwrap();
+
+    let msg = MsgCreateClient::new(
+        MockClientState::new(MockHeader::new(height)).into(),
+        MockConsensusState::new(MockHeader::new(height)).into(),
+        signer,
+    );
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let client_type = mock_client_type();
+
+    let client_id = {
+        let id_counter = ctx.client_counter().unwrap();
+        ClientId::new(client_type.clone(), id_counter).unwrap()
+    };
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+
+    assert!(res.is_ok(), "validation happy path");
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "execution happy path");
+
+    let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+    assert_eq!(expected_client_state.client_type(), client_type);
+    assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
+}
+
+#[test]
+fn test_tm_create_client_ok() {
+    let signer = dummy_account_id();
+
+    let mut ctx = MockContext::default();
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let tm_header = dummy_tendermint_header();
+
+    let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone()).into();
+
+    let client_type = tm_client_type();
+
+    let client_id = {
+        let id_counter = ctx.client_counter().unwrap();
+        ClientId::new(client_type.clone(), id_counter).unwrap()
+    };
+
+    let msg = MsgCreateClient::new(
+        tm_client_state,
+        TmConsensusState::try_from(tm_header).unwrap().into(),
+        signer,
+    );
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+
+    assert!(res.is_ok(), "tendermint client validation happy path");
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "tendermint client execution happy path");
+
+    let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+    assert_eq!(expected_client_state.client_type(), client_type);
+    assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
+}
diff --git a/crates/ibc-testkit/tests/core/ics02_client/mod.rs b/crates/ibc-testkit/tests/core/ics02_client/mod.rs
new file mode 100644
index 000000000..acab4918d
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics02_client/mod.rs
@@ -0,0 +1,3 @@
+pub mod create_client;
+pub mod update_client;
+pub mod upgrade_client;
diff --git a/crates/ibc-testkit/tests/core/ics02_client/update_client.rs b/crates/ibc-testkit/tests/core/ics02_client/update_client.rs
new file mode 100644
index 000000000..11ba9e9a3
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -0,0 +1,997 @@
+use core::str::FromStr;
+use core::time::Duration;
+
+use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::ics07_tendermint::client_type as tm_client_type;
+use ibc::clients::ics07_tendermint::header::Header as TmHeader;
+use ibc::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc::core::ics02_client::client_type::ClientType;
+use ibc::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
+use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
+use ibc::core::ics02_client::msgs::ClientMsg;
+use ibc::core::ics02_client::ClientValidationContext;
+use ibc::core::ics23_commitment::specs::ProofSpecs;
+use ibc::core::ics24_host::identifier::{ChainId, ClientId};
+use ibc::core::ics24_host::path::ClientConsensusStatePath;
+use ibc::core::timestamp::Timestamp;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc::proto::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+use ibc::proto::Any;
+use ibc::{downcast, Height};
+use ibc_testkit::hosts::block::{HostBlock, HostType};
+use ibc_testkit::testapp::ibc::clients::mock::client_state::{
+    client_type as mock_client_type, MockClientState,
+};
+use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::clients::mock::misbehaviour::Misbehaviour as MockMisbehaviour;
+use ibc_testkit::testapp::ibc::clients::AnyConsensusState;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::utils::core::context::MockContextConfig;
+use ibc_testkit::utils::core::signer::dummy_account_id;
+use prost::Message;
+use tendermint_testgen::Validator as TestgenValidator;
+use test_log::test;
+
+#[test]
+fn test_update_client_ok() {
+    let client_id = ClientId::default();
+
+    let signer = dummy_account_id();
+
+    let timestamp = Timestamp::now();
+
+    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let height = Height::new(0, 46).unwrap();
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: MockHeader::new(height).with_timestamp(timestamp).into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+
+    assert!(res.is_ok(), "validation happy path");
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "execution happy path");
+
+    assert_eq!(
+        ctx.client_state(&msg.client_id).unwrap(),
+        MockClientState::new(MockHeader::new(height).with_timestamp(timestamp)).into()
+    );
+}
+
+/// Tests that the Tendermint client consensus state pruning logic
+/// functions correctly.
+///
+/// This test sets up a MockContext with host height 1 and a trusting
+/// period of 3 seconds. It then advances the state of the MockContext
+/// by 2 heights, and thus 6 seconds, due to the DEFAULT_BLOCK_TIME_SECS
+/// constant being set to 3 seconds. At this point, the chain is at height
+/// 3. Any consensus states associated with a block more than 3 seconds
+/// in the past should be expired and pruned from the IBC store. The test
+/// thus checks that the consensus state at height 1 is not contained in
+/// the store. It also checks that the consensus state at height 2 is
+/// contained in the store and has not expired.
+#[test]
+fn test_consensus_state_pruning() {
+    let chain_id = ChainId::new("mockgaiaA-1").unwrap();
+
+    let client_height = Height::new(1, 1).unwrap();
+
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+    let mut ctx = MockContextConfig::builder()
+        .host_id(chain_id.clone())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(client_height)
+        .latest_timestamp(Timestamp::now())
+        .max_history_size(u64::MAX)
+        .build()
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id.clone())
+                .client_id(client_id.clone())
+                .client_state_height(client_height)
+                .client_type(tm_client_type())
+                .trusting_period(Duration::from_secs(3))
+                .build(),
+        );
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let start_host_timestamp = ctx.host_timestamp().unwrap();
+
+    // Move the chain forward by 2 blocks to pass the trusting period.
+    for _ in 1..=2 {
+        let signer = dummy_account_id();
+
+        let update_height = ctx.latest_height();
+
+        ctx.advance_host_chain_height();
+
+        let mut block = ctx.host_block(&update_height).unwrap().clone();
+
+        block.set_trusted_height(client_height);
+
+        let msg = MsgUpdateClient {
+            client_id: client_id.clone(),
+            client_message: block.clone().into(),
+            signer,
+        };
+
+        let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+        let _ = validate(&ctx, &router, msg_envelope.clone());
+        let _ = execute(&mut ctx, &mut router, msg_envelope);
+    }
+
+    // Check that latest expired consensus state is pruned.
+    let expired_height = Height::new(1, 1).unwrap();
+    let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &expired_height);
+    assert!(ctx
+        .client_update_height(&client_id, &expired_height)
+        .is_err());
+    assert!(ctx.client_update_time(&client_id, &expired_height).is_err());
+    assert!(ctx.consensus_state(&client_cons_state_path).is_err());
+
+    // Check that latest valid consensus state exists.
+    let earliest_valid_height = Height::new(1, 2).unwrap();
+    let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &earliest_valid_height);
+
+    assert!(ctx
+        .client_update_height(&client_id, &earliest_valid_height)
+        .is_ok());
+
+    assert!(ctx
+        .client_update_time(&client_id, &earliest_valid_height)
+        .is_ok());
+
+    assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
+
+    let end_host_timestamp = ctx.host_timestamp().unwrap();
+
+    assert_eq!(
+        end_host_timestamp,
+        (start_host_timestamp + Duration::from_secs(6)).unwrap()
+    );
+}
+
+#[test]
+fn test_update_nonexisting_client() {
+    let client_id = ClientId::from_str("mockclient1").unwrap();
+
+    let signer = dummy_account_id();
+
+    let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+
+    let router = MockRouter::new_with_transfer();
+
+    let msg = MsgUpdateClient {
+        client_id: ClientId::from_str("nonexistingclient").unwrap(),
+        client_message: MockHeader::new(Height::new(0, 46).unwrap()).into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(res.is_err());
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_adjacent_ok() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let update_height = Height::new(1, 21).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let mut ctx = MockContext::new(
+        ChainId::new("mockgaiaA-1").unwrap(),
+        HostType::Mock,
+        5,
+        Height::new(1, 1).unwrap(),
+    )
+    .with_client_parametrized_with_chain_id(
+        chain_id_b.clone(),
+        &client_id,
+        client_height,
+        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+        Some(client_height),
+    );
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    block.set_trusted_height(client_height);
+
+    let latest_header_height = block.height();
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+    assert!(res.is_ok());
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let client_state = ctx.client_state(&msg.client_id).unwrap();
+
+    assert!(client_state
+        .status(&ctx, &msg.client_id)
+        .unwrap()
+        .is_active());
+
+    assert_eq!(client_state.latest_height(), latest_header_height);
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_validator_change_ok() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let mut ctx_a = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_config(
+            // client state initialized with client_height, and
+            // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_state_height(client_height)
+                .client_type(tm_client_type())
+                .build(),
+        );
+
+    let mut router_a = MockRouter::new_with_transfer();
+
+    let ctx_b_val_history = vec![
+        // First two validator sets are default at client creation
+        //
+        // validator set of height-20
+        vec![
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ],
+        // validator set of height-21
+        vec![
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ],
+        // validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(30),
+            TestgenValidator::new("2").voting_power(70),
+        ],
+        // validator set of height-23
+        vec![
+            TestgenValidator::new("1").voting_power(20),
+            TestgenValidator::new("2").voting_power(80),
+        ],
+    ];
+
+    let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+
+    let ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b.clone())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(update_height)
+        .max_history_size(ctx_b_val_history.len() as u64 - 1)
+        .validator_set_history(ctx_b_val_history)
+        .build();
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    block.set_trusted_height(client_height);
+
+    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+        _ => panic!("unexpected host block type"),
+    };
+
+    block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+    let latest_header_height = block.height();
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    assert!(res.is_ok());
+
+    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let client_state = ctx_a.client_state(&msg.client_id).unwrap();
+    assert!(client_state
+        .status(&ctx_a, &msg.client_id)
+        .unwrap()
+        .is_active());
+    assert_eq!(client_state.latest_height(), latest_header_height);
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_validator_change_fail() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let ctx_a = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_config(
+            // client state initialized with client_height, and
+            // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_state_height(client_height)
+                .client_type(tm_client_type())
+                .build(),
+        );
+
+    let router = MockRouter::new_with_transfer();
+
+    let ctx_b_val_history = vec![
+        // First two validator sets are default at client creation
+        //
+        // validator set of height-20
+        vec![
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ],
+        // incorrect next validator set for height-20
+        // validator set of height-21
+        vec![
+            TestgenValidator::new("1").voting_power(45),
+            TestgenValidator::new("2").voting_power(55),
+        ],
+        // validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(30),
+            TestgenValidator::new("2").voting_power(70),
+        ],
+        // validator set of height-23
+        vec![
+            TestgenValidator::new("1").voting_power(20),
+            TestgenValidator::new("2").voting_power(80),
+        ],
+    ];
+
+    let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+
+    let ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b.clone())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(update_height)
+        .max_history_size(ctx_b_val_history.len() as u64 - 1)
+        .validator_set_history(ctx_b_val_history)
+        .build();
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    block.set_trusted_height(client_height);
+
+    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+        _ => panic!("unexpected host block type"),
+    };
+
+    block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a, &router, msg_envelope);
+
+    assert!(res.is_err());
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let update_height = Height::new(1, 21).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let mut ctx = MockContext::new(
+        ChainId::new("mockgaiaA-1").unwrap(),
+        HostType::Mock,
+        5,
+        Height::new(1, 1).unwrap(),
+    )
+    .with_client_parametrized_history_with_chain_id(
+        chain_id_b.clone(),
+        &client_id,
+        client_height,
+        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+        Some(client_height),
+    );
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    let trusted_height = client_height.clone().sub(1).unwrap();
+    block.set_trusted_height(trusted_height);
+
+    let latest_header_height = block.height();
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+    assert!(res.is_ok());
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let client_state = ctx.client_state(&msg.client_id).unwrap();
+
+    assert!(client_state
+        .status(&ctx, &msg.client_id)
+        .unwrap()
+        .is_active());
+
+    assert_eq!(client_state.latest_height(), latest_header_height);
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_duplicate_ok() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+
+    let ctx_a_chain_id = ChainId::new("mockgaiaA-1").unwrap();
+    let ctx_b_chain_id = ChainId::new("mockgaiaB-1").unwrap();
+    let start_height = Height::new(1, 11).unwrap();
+
+    let mut ctx_a = MockContext::new(ctx_a_chain_id, HostType::Mock, 5, start_height)
+        .with_client_parametrized_with_chain_id(
+            ctx_b_chain_id.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+            Some(start_height),
+        );
+
+    let mut router_a = MockRouter::new_with_transfer();
+
+    let ctx_b = MockContext::new(
+        ctx_b_chain_id,
+        HostType::SyntheticTendermint,
+        5,
+        client_height,
+    );
+
+    let signer = dummy_account_id();
+
+    let block = ctx_b.host_block(&client_height).unwrap().clone();
+
+    // Update the trusted height of the header to point to the previous height
+    // (`start_height` in this case).
+    //
+    // Note: The current MockContext interface doesn't allow us to
+    // do this without a major redesign.
+    let block = match block {
+        HostBlock::SyntheticTendermint(mut theader) => {
+            // current problem: the timestamp of the new header doesn't match the timestamp of
+            // the stored consensus state. If we hack them to match, then commit check fails.
+            // FIXME: figure out why they don't match.
+            theader.trusted_height = start_height;
+
+            HostBlock::SyntheticTendermint(theader)
+        }
+        _ => block,
+    };
+
+    // Update the client height to `client_height`
+    //
+    // Note: The current MockContext interface doesn't allow us to
+    // do this without a major redesign.
+    {
+        // FIXME: idea: we need to update the light client with the latest block from
+        // chain B
+        let consensus_state: AnyConsensusState = block.clone().into();
+
+        let tm_block = downcast!(block.clone() => HostBlock::SyntheticTendermint).unwrap();
+
+        let chain_id = ChainId::from_str(tm_block.header().chain_id.as_str()).unwrap();
+
+        let client_state = {
+            #[allow(deprecated)]
+            let raw_client_state = RawTmClientState {
+                chain_id: chain_id.to_string(),
+                trust_level: Some(Fraction {
+                    numerator: 1,
+                    denominator: 3,
+                }),
+                trusting_period: Some(Duration::from_secs(64000).into()),
+                unbonding_period: Some(Duration::from_secs(128000).into()),
+                max_clock_drift: Some(Duration::from_millis(3000).into()),
+                latest_height: Some(
+                    Height::new(
+                        chain_id.revision_number(),
+                        u64::from(tm_block.header().height),
+                    )
+                    .unwrap()
+                    .into(),
+                ),
+                proof_specs: ProofSpecs::default().into(),
+                upgrade_path: Default::default(),
+                frozen_height: None,
+                allow_update_after_expiry: false,
+                allow_update_after_misbehaviour: false,
+            };
+
+            let client_state = TmClientState::try_from(raw_client_state).unwrap();
+
+            client_state.into()
+        };
+
+        let mut ibc_store = ctx_a.ibc_store.lock();
+        let client_record = ibc_store.clients.get_mut(&client_id).unwrap();
+
+        client_record
+            .consensus_states
+            .insert(client_height, consensus_state);
+
+        client_record.client_state = Some(client_state);
+    }
+
+    let latest_header_height = block.height();
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let client_state = ctx_a.client_state(&msg.client_id).unwrap();
+    assert!(client_state
+        .status(&ctx_a, &msg.client_id)
+        .unwrap()
+        .is_active());
+    assert_eq!(client_state.latest_height(), latest_header_height);
+    assert_eq!(client_state, ctx_a.latest_client_states(&msg.client_id));
+}
+
+#[test]
+fn test_update_synthetic_tendermint_client_lower_height() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+
+    let client_update_height = Height::new(1, 19).unwrap();
+
+    let chain_start_height = Height::new(1, 11).unwrap();
+
+    let ctx = MockContext::new(
+        ChainId::new("mockgaiaA-1").unwrap(),
+        HostType::Mock,
+        5,
+        chain_start_height,
+    )
+    .with_client_parametrized(
+        &client_id,
+        client_height,
+        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+        Some(client_height),
+    );
+
+    let router = MockRouter::new_with_transfer();
+
+    let ctx_b = MockContext::new(
+        ChainId::new("mockgaiaB-1").unwrap(),
+        HostType::SyntheticTendermint,
+        5,
+        client_height,
+    );
+
+    let signer = dummy_account_id();
+
+    let block_ref = ctx_b.host_block(&client_update_height).unwrap();
+
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block_ref.clone().into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+    assert!(res.is_err());
+}
+
+#[test]
+fn test_update_client_events() {
+    let client_id = ClientId::default();
+    let signer = dummy_account_id();
+
+    let timestamp = Timestamp::now();
+
+    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let mut router = MockRouter::new_with_transfer();
+    let height = Height::new(0, 46).unwrap();
+    let header: Any = MockHeader::new(height).with_timestamp(timestamp).into();
+    let msg = MsgUpdateClient {
+        client_id: client_id.clone(),
+        client_message: header.clone(),
+        signer,
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+    assert!(res.is_ok());
+
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Client)
+    ));
+    let update_client_event = downcast!(&ctx.events[1] => IbcEvent::UpdateClient).unwrap();
+
+    assert_eq!(update_client_event.client_id(), &client_id);
+    assert_eq!(update_client_event.client_type(), &mock_client_type());
+    assert_eq!(update_client_event.consensus_height(), &height);
+    assert_eq!(update_client_event.consensus_heights(), &vec![height]);
+    assert_eq!(update_client_event.header(), &header.encode_to_vec());
+}
+
+fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {
+    let client_state = ctx.client_state(client_id).unwrap();
+
+    let status = client_state.status(ctx, client_id).unwrap();
+    assert!(status.is_frozen(), "client_state status: {status}");
+
+    // check events
+    assert_eq!(ctx.events.len(), 2);
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Client),
+    ));
+    let misbehaviour_client_event =
+        downcast!(&ctx.events[1] => IbcEvent::ClientMisbehaviour).unwrap();
+    assert_eq!(misbehaviour_client_event.client_id(), client_id);
+    assert_eq!(misbehaviour_client_event.client_type(), client_type);
+}
+
+/// Tests misbehaviour handling for the mock client.
+/// Misbehaviour evidence consists of identical headers - mock misbehaviour handler considers it
+/// a valid proof of misbehaviour
+#[test]
+fn test_misbehaviour_client_ok() {
+    let client_id = ClientId::default();
+    let timestamp = Timestamp::now();
+    let height = Height::new(0, 46).unwrap();
+    let msg = MsgSubmitMisbehaviour {
+        client_id: client_id.clone(),
+        misbehaviour: MockMisbehaviour {
+            client_id: client_id.clone(),
+            header1: MockHeader::new(height).with_timestamp(timestamp),
+            header2: MockHeader::new(height).with_timestamp(timestamp),
+        }
+        .into(),
+        signer: dummy_account_id(),
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let mut router = MockRouter::new_with_transfer();
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+    assert!(res.is_ok());
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+    assert!(res.is_ok());
+
+    ensure_misbehaviour(&ctx, &client_id, &mock_client_type());
+}
+
+/// Tests misbehaviour handling failure for a non-existent client
+#[test]
+fn test_misbehaviour_nonexisting_client() {
+    let client_id = ClientId::from_str("mockclient1").unwrap();
+    let height = Height::new(0, 46).unwrap();
+    let msg = MsgSubmitMisbehaviour {
+        client_id: ClientId::from_str("nonexistingclient").unwrap(),
+        misbehaviour: MockMisbehaviour {
+            client_id: client_id.clone(),
+            header1: MockHeader::new(height),
+            header2: MockHeader::new(height),
+        }
+        .into(),
+        signer: dummy_account_id(),
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let router = MockRouter::new_with_transfer();
+    let res = validate(&ctx, &router, msg_envelope);
+    assert!(res.is_err());
+}
+
+/// Tests misbehaviour handling for the synthetic Tendermint client.
+/// Misbehaviour evidence consists of equivocal headers.
+#[test]
+fn test_misbehaviour_synthetic_tendermint_equivocation() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let misbehaviour_height = Height::new(1, 21).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
+    let mut ctx_a = MockContext::new(
+        ChainId::new("mockgaiaA-1").unwrap(),
+        HostType::Mock,
+        5,
+        Height::new(1, 1).unwrap(),
+    )
+    .with_client_parametrized_with_chain_id(
+        chain_id_b.clone(),
+        &client_id,
+        client_height,
+        Some(tm_client_type()),
+        Some(client_height),
+    );
+
+    let mut router_a = MockRouter::new_with_transfer();
+
+    // Create a mock context for chain-B
+    let ctx_b = MockContext::new(
+        chain_id_b.clone(),
+        HostType::SyntheticTendermint,
+        5,
+        misbehaviour_height,
+    );
+
+    // Get chain-B's header at `misbehaviour_height`
+    let header1: TmHeader = {
+        let mut block = ctx_b.host_block(&misbehaviour_height).unwrap().clone();
+        block.set_trusted_height(client_height);
+        block.try_into_tm_block().unwrap().into()
+    };
+
+    // Generate an equivocal header for chain-B at `misbehaviour_height`
+    let header2 = {
+        let mut tm_block = HostBlock::generate_tm_block(
+            chain_id_b,
+            misbehaviour_height.revision_height(),
+            Timestamp::now(),
+        );
+        tm_block.trusted_height = client_height;
+        tm_block.into()
+    };
+
+    let msg = MsgSubmitMisbehaviour {
+        client_id: client_id.clone(),
+        misbehaviour: TmMisbehaviour::new(client_id.clone(), header1, header2).into(),
+        signer: dummy_account_id(),
+    };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    assert!(res.is_ok());
+    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    assert!(res.is_ok());
+    ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
+}
+
+#[test]
+fn test_misbehaviour_synthetic_tendermint_bft_time() {
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(1, 20).unwrap();
+    let misbehaviour_height = Height::new(1, 21).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
+    let mut ctx_a = MockContext::new(
+        ChainId::new("mockgaiaA-1").unwrap(),
+        HostType::Mock,
+        5,
+        Height::new(1, 1).unwrap(),
+    )
+    .with_client_parametrized_with_chain_id(
+        chain_id_b.clone(),
+        &client_id,
+        client_height,
+        Some(tm_client_type()),
+        Some(client_height),
+    );
+
+    let mut router_a = MockRouter::new_with_transfer();
+
+    // Generate `header1` for chain-B
+    let header1 = {
+        let mut tm_block = HostBlock::generate_tm_block(
+            chain_id_b.clone(),
+            misbehaviour_height.revision_height(),
+            Timestamp::now(),
+        );
+        tm_block.trusted_height = client_height;
+        tm_block
+    };
+
+    // Generate `header2` for chain-B which is identical to `header1` but with a conflicting
+    // timestamp
+    let header2 = {
+        let timestamp =
+            Timestamp::from_nanoseconds(Timestamp::now().nanoseconds() + 1_000_000_000).unwrap();
+        let mut tm_block = HostBlock::generate_tm_block(
+            chain_id_b,
+            misbehaviour_height.revision_height(),
+            timestamp,
+        );
+        tm_block.trusted_height = client_height;
+        tm_block
+    };
+
+    let msg = MsgSubmitMisbehaviour {
+        client_id: client_id.clone(),
+        misbehaviour: TmMisbehaviour::new(client_id.clone(), header1.into(), header2.into()).into(),
+        signer: dummy_account_id(),
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    assert!(res.is_ok());
+    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    assert!(res.is_ok());
+    ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
+}
+
+#[test]
+fn test_expired_client() {
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let update_height = Height::new(1, 21).unwrap();
+    let client_height = update_height.sub(3).unwrap();
+
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+    let timestamp = Timestamp::now();
+
+    let trusting_period = Duration::from_secs(64);
+
+    let mut ctx = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .latest_timestamp(timestamp)
+        .build()
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_state_height(client_height)
+                .client_type(tm_client_type())
+                .latest_timestamp(timestamp)
+                .trusting_period(trusting_period)
+                .build(),
+        );
+
+    while ctx.host_timestamp().expect("no error") < (timestamp + trusting_period).expect("no error")
+    {
+        ctx.advance_host_chain_height();
+    }
+
+    let client_state = ctx.client_state(&client_id).unwrap();
+
+    assert!(client_state.status(&ctx, &client_id).unwrap().is_expired());
+}
+
+#[test]
+fn test_client_update_max_clock_drift() {
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let client_height = Height::new(1, 20).unwrap();
+
+    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+
+    let timestamp = Timestamp::now();
+
+    let max_clock_drift = Duration::from_secs(64);
+
+    let ctx_a = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .latest_timestamp(timestamp)
+        .build()
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_state_height(client_height)
+                .client_type(tm_client_type())
+                .latest_timestamp(timestamp)
+                .max_clock_drift(max_clock_drift)
+                .build(),
+        );
+
+    let router_a = MockRouter::new_with_transfer();
+
+    let mut ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b.clone())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(client_height)
+        .latest_timestamp(timestamp)
+        .max_history_size(u64::MAX)
+        .build();
+
+    while ctx_b.host_timestamp().expect("no error")
+        < (ctx_a.host_timestamp().expect("no error") + max_clock_drift).expect("no error")
+    {
+        ctx_b.advance_host_chain_height();
+    }
+
+    // include current block
+    ctx_b.advance_host_chain_height();
+
+    let update_height = ctx_b.latest_height();
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    block.set_trusted_height(client_height);
+
+    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
+        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
+        _ => panic!("unexpected host block type"),
+    };
+
+    block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.clone().into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a, &router_a, msg_envelope);
+    assert!(res.is_err());
+}
diff --git a/crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
new file mode 100644
index 000000000..79733107b
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -0,0 +1,165 @@
+use ibc::clients::ics07_tendermint::client_type;
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::error::{ClientError, UpgradeClientError};
+use ibc::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
+use ibc::core::ics02_client::msgs::ClientMsg;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::ics24_host::path::ClientConsensusStatePath;
+use ibc::core::{execute, validate, ContextError, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc::{downcast, Height};
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use ibc_testkit::utils::core::client::dummy_msg_upgrade_client;
+use ibc_testkit::utils::{Expect, Fixture};
+
+enum Ctx {
+    Default,
+    WithClient,
+}
+
+enum Msg {
+    Default,
+    LowUpgradeHeight,
+    UnknownUpgradedClientStateType,
+}
+
+fn msg_upgrade_client_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgUpgradeClient> {
+    let client_id = ClientId::new(mock_client_type(), 0).unwrap();
+
+    let ctx_default = MockContext::default();
+    let ctx_with_client = ctx_default
+        .clone()
+        .with_client(&client_id, Height::new(0, 42).unwrap());
+    let ctx = match ctx_variant {
+        Ctx::Default => ctx_default,
+        Ctx::WithClient => ctx_with_client,
+    };
+
+    let upgrade_height = Height::new(1, 26).unwrap();
+    let msg_default = dummy_msg_upgrade_client(client_id.clone(), upgrade_height);
+
+    let low_upgrade_height = Height::new(0, 26).unwrap();
+    let msg_with_low_upgrade_height = dummy_msg_upgrade_client(client_id, low_upgrade_height);
+
+    let msg_with_unknown_upgraded_cs = MsgUpgradeClient {
+        upgraded_client_state: dummy_tm_client_state_from_header(dummy_tendermint_header()).into(),
+        ..msg_default.clone()
+    };
+
+    let msg = match msg_variant {
+        Msg::Default => msg_default,
+        Msg::LowUpgradeHeight => msg_with_low_upgrade_height,
+        Msg::UnknownUpgradedClientStateType => msg_with_unknown_upgraded_cs,
+    };
+
+    Fixture { ctx, msg }
+}
+
+fn upgrade_client_validate(fxt: &Fixture<MsgUpgradeClient>, expect: Expect) {
+    let Fixture { ctx, msg } = fxt;
+    let router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+    let res = validate(ctx, &router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
+
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}");
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+        }
+    };
+}
+
+fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
+    let mut router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(fxt.msg.clone()));
+    let res = execute(&mut fxt.ctx, &mut router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
+    match expect {
+        Expect::Failure(err) => {
+            assert!(res.is_err(), "{err_msg}");
+            assert_eq!(
+                core::mem::discriminant(res.as_ref().unwrap_err()),
+                core::mem::discriminant(&err.unwrap())
+            );
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+            assert!(matches!(
+                fxt.ctx.events[0],
+                IbcEvent::Message(MessageEvent::Client)
+            ));
+            let upgrade_client_event =
+                downcast!(&fxt.ctx.events[1] => IbcEvent::UpgradeClient).unwrap();
+            let plan_height = Height::new(1, 26).unwrap();
+
+            assert_eq!(upgrade_client_event.client_id(), &fxt.msg.client_id);
+            assert_eq!(upgrade_client_event.client_type(), &mock_client_type());
+            assert_eq!(upgrade_client_event.consensus_height(), &plan_height);
+
+            let client_state = fxt.ctx.client_state(&fxt.msg.client_id).unwrap();
+            let msg_client_state: AnyClientState =
+                fxt.msg.upgraded_client_state.clone().try_into().unwrap();
+            assert_eq!(client_state, msg_client_state);
+
+            let consensus_state = fxt
+                .ctx
+                .consensus_state(&ClientConsensusStatePath::new(
+                    &fxt.msg.client_id,
+                    &plan_height,
+                ))
+                .unwrap();
+            let msg_consensus_state: AnyConsensusState =
+                fxt.msg.upgraded_consensus_state.clone().try_into().unwrap();
+            assert_eq!(consensus_state, msg_consensus_state);
+        }
+    };
+}
+
+#[test]
+fn msg_upgrade_client_healthy() {
+    let mut fxt = msg_upgrade_client_fixture(Ctx::WithClient, Msg::Default);
+    upgrade_client_validate(&fxt, Expect::Success);
+    upgrade_client_execute(&mut fxt, Expect::Success);
+}
+
+#[test]
+fn upgrade_client_fail_nonexisting_client() {
+    let fxt = msg_upgrade_client_fixture(Ctx::Default, Msg::Default);
+    let expected_err = ContextError::ClientError(ClientError::ClientStateNotFound {
+        client_id: fxt.msg.client_id.clone(),
+    });
+    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+}
+
+#[test]
+fn upgrade_client_fail_low_upgrade_height() {
+    let fxt: Fixture<MsgUpgradeClient> =
+        msg_upgrade_client_fixture(Ctx::WithClient, Msg::LowUpgradeHeight);
+    let expected_err: ClientError = UpgradeClientError::LowUpgradeHeight {
+        upgraded_height: Height::new(0, 26).unwrap(),
+        client_height: fxt.ctx.latest_height(),
+    }
+    .into();
+    upgrade_client_validate(
+        &fxt,
+        Expect::Failure(Some(ContextError::from(expected_err).into())),
+    );
+}
+
+#[test]
+fn upgrade_client_fail_unknown_upgraded_client_state() {
+    let fxt = msg_upgrade_client_fixture(Ctx::WithClient, Msg::UnknownUpgradedClientStateType);
+    let expected_err = ContextError::ClientError(ClientError::UnknownClientStateType {
+        client_state_type: client_type().to_string(),
+    });
+    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+}
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
new file mode 100644
index 000000000..7cd0a2333
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -0,0 +1,194 @@
+use core::str::FromStr;
+
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
+use ibc::core::ics03_connection::error::ConnectionError;
+use ibc::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
+use ibc::core::ics03_connection::msgs::ConnectionMsg;
+use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
+use ibc::core::ics24_host::identifier::{ChainId, ClientId};
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, ContextError, MsgEnvelope, RouterError, ValidationContext};
+use ibc::prelude::*;
+use ibc_testkit::hosts::block::HostType;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::connection::dummy_msg_conn_open_ack;
+use ibc_testkit::utils::{Expect, Fixture};
+use test_log::test;
+
+enum Ctx {
+    New,
+    NewWithConnection,
+    NewWithConnectionEndOpen,
+    DefaultWithConnection,
+}
+
+fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
+    let msg = dummy_msg_conn_open_ack(10, 10);
+
+    // Client parameters -- identifier and correct height (matching the proof height)
+    let client_id = ClientId::from_str("mock_clientid").unwrap();
+    let proof_height = msg.proofs_height_on_b;
+    let conn_id = msg.conn_id_on_a.clone();
+
+    // Parametrize the host chain to have a height at least as recent as the
+    // the height of the proofs in the Ack msg.
+    let latest_height = proof_height.increment();
+    let max_history_size = 5;
+
+    // A connection end that will exercise the successful path.
+    let default_conn_end = ConnectionEnd::new(
+        State::Init,
+        client_id.clone(),
+        Counterparty::new(
+            client_id.clone(),
+            Some(msg.conn_id_on_b.clone()),
+            CommitmentPrefix::try_from(b"ibc".to_vec()).unwrap(),
+        ),
+        vec![msg.version.clone()],
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    // A connection end with incorrect state `Open`; will be part of the context.
+    let mut conn_end_open = default_conn_end.clone();
+    conn_end_open.set_state(State::Open); // incorrect field
+
+    let ctx_default = MockContext::default();
+    let ctx_new = MockContext::new(
+        ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap(),
+        HostType::Mock,
+        max_history_size,
+        latest_height,
+    );
+    let ctx = match ctx {
+        Ctx::New => ctx_new,
+        Ctx::NewWithConnection => ctx_new
+            .with_client(&client_id, proof_height)
+            .with_connection(conn_id, default_conn_end),
+        Ctx::DefaultWithConnection => ctx_default
+            .with_client(&client_id, proof_height)
+            .with_connection(conn_id, default_conn_end),
+        Ctx::NewWithConnectionEndOpen => ctx_new
+            .with_client(&client_id, proof_height)
+            .with_connection(conn_id, conn_end_open),
+    };
+
+    Fixture { ctx, msg }
+}
+
+fn conn_open_ack_validate(fxt: &Fixture<MsgConnectionOpenAck>, expect: Expect) {
+    let router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = validate(&fxt.ctx, &router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
+    match expect {
+        Expect::Failure(err) => {
+            assert!(res.is_err(), "{err_msg}");
+            assert_eq!(
+                core::mem::discriminant(res.as_ref().unwrap_err()),
+                core::mem::discriminant(&err.unwrap())
+            );
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+            return;
+        }
+    };
+    let right_connection_id = fxt.msg.conn_id_on_a.clone();
+    let cons_state_height = fxt.msg.consensus_height_of_a_on_b;
+
+    let ctx_err = match res.unwrap_err() {
+        RouterError::ContextError(e) => e,
+        _ => panic!("unexpected error type"),
+    };
+
+    match ctx_err {
+        ContextError::ConnectionError(ConnectionError::ConnectionNotFound { connection_id }) => {
+            assert_eq!(connection_id, right_connection_id)
+        }
+        ContextError::ConnectionError(ConnectionError::InvalidConsensusHeight {
+            target_height,
+            current_height: _,
+        }) => {
+            assert_eq!(cons_state_height, target_height);
+        }
+        ContextError::ConnectionError(ConnectionError::InvalidState {
+            expected: _,
+            actual: _,
+        }) => {}
+        _ => unreachable!(),
+    }
+}
+
+fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect) {
+    let mut router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = execute(&mut fxt.ctx, &mut router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}");
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+            assert_eq!(fxt.ctx.events.len(), 2);
+
+            assert!(matches!(
+                fxt.ctx.events[0],
+                IbcEvent::Message(MessageEvent::Connection)
+            ));
+            let event = &fxt.ctx.events[1];
+            assert!(matches!(event, &IbcEvent::OpenAckConnection(_)));
+
+            let conn_open_try_event = match event {
+                IbcEvent::OpenAckConnection(e) => e,
+                _ => unreachable!(),
+            };
+            let conn_end = <MockContext as ValidationContext>::connection_end(
+                &fxt.ctx,
+                conn_open_try_event.conn_id_on_a(),
+            )
+            .unwrap();
+            assert_eq!(conn_end.state().clone(), State::Open);
+        }
+    }
+}
+
+#[test]
+fn conn_open_ack_healthy() {
+    let mut fxt = conn_open_ack_fixture(Ctx::NewWithConnection);
+    conn_open_ack_validate(&fxt, Expect::Success);
+    conn_open_ack_execute(&mut fxt, Expect::Success);
+}
+
+#[test]
+fn conn_open_ack_no_connection() {
+    let fxt = conn_open_ack_fixture(Ctx::New);
+    let expected_err = ContextError::ConnectionError(ConnectionError::ConnectionNotFound {
+        connection_id: fxt.msg.conn_id_on_a.clone(),
+    });
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+}
+
+#[test]
+fn conn_open_ack_invalid_consensus_height() {
+    let fxt = conn_open_ack_fixture(Ctx::DefaultWithConnection);
+    let expected_err = ContextError::ConnectionError(ConnectionError::InvalidConsensusHeight {
+        target_height: fxt.msg.consensus_height_of_a_on_b,
+        current_height: Height::new(0, 10).unwrap(),
+    });
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+}
+
+#[test]
+fn conn_open_ack_connection_mismatch() {
+    let fxt = conn_open_ack_fixture(Ctx::NewWithConnectionEndOpen);
+    let expected_err = ContextError::ConnectionError(ConnectionError::InvalidState {
+        expected: State::Init.to_string(),
+        actual: State::Open.to_string(),
+    });
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+}
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
new file mode 100644
index 000000000..6d629162e
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -0,0 +1,124 @@
+use core::str::FromStr;
+
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
+use ibc::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
+use ibc::core::ics03_connection::msgs::ConnectionMsg;
+use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
+use ibc::core::ics24_host::identifier::ClientId;
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::Height;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::connection::dummy_conn_open_confirm;
+use ibc_testkit::utils::{Expect, Fixture};
+use test_log::test;
+
+enum Ctx {
+    Default,
+    CorrectConnection,
+    IncorrectConnection,
+}
+
+fn conn_open_confirm_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenConfirm> {
+    let client_id = ClientId::from_str("mock_clientid").unwrap();
+    let msg = dummy_conn_open_confirm();
+    let counterparty = Counterparty::new(
+        client_id.clone(),
+        Some(msg.conn_id_on_b.clone()),
+        CommitmentPrefix::try_from(b"ibc".to_vec()).unwrap(),
+    );
+
+    let ctx_default = MockContext::default();
+
+    let incorrect_conn_end_state = ConnectionEnd::new(
+        State::Init,
+        client_id.clone(),
+        counterparty,
+        ValidationContext::get_compatible_versions(&ctx_default),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let mut correct_conn_end = incorrect_conn_end_state.clone();
+    correct_conn_end.set_state(State::TryOpen);
+
+    let ctx = match ctx {
+        Ctx::Default => ctx_default,
+        Ctx::IncorrectConnection => ctx_default
+            .with_client(&client_id, Height::new(0, 10).unwrap())
+            .with_connection(msg.conn_id_on_b.clone(), incorrect_conn_end_state),
+        Ctx::CorrectConnection => ctx_default
+            .with_client(&client_id, Height::new(0, 10).unwrap())
+            .with_connection(msg.conn_id_on_b.clone(), correct_conn_end),
+    };
+
+    Fixture { ctx, msg }
+}
+
+fn conn_open_confirm_validate(fxt: &Fixture<MsgConnectionOpenConfirm>, expect: Expect) {
+    let router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = validate(&fxt.ctx, &router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}");
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+        }
+    };
+}
+
+fn conn_open_confirm_execute(fxt: &mut Fixture<MsgConnectionOpenConfirm>, expect: Expect) {
+    let mut router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = execute(&mut fxt.ctx, &mut router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}");
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+            assert_eq!(fxt.ctx.events.len(), 2);
+
+            assert!(matches!(
+                fxt.ctx.events[0],
+                IbcEvent::Message(MessageEvent::Connection)
+            ));
+            let event = &fxt.ctx.events[1];
+            assert!(matches!(event, &IbcEvent::OpenConfirmConnection(_)));
+
+            let conn_open_try_event = match event {
+                IbcEvent::OpenConfirmConnection(e) => e,
+                _ => unreachable!(),
+            };
+            let conn_end =
+                ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
+                    .unwrap();
+            assert_eq!(conn_end.state().clone(), State::Open);
+        }
+    }
+}
+
+#[test]
+fn conn_open_confirm_healthy() {
+    let mut fxt = conn_open_confirm_fixture(Ctx::CorrectConnection);
+    conn_open_confirm_validate(&fxt, Expect::Success);
+    conn_open_confirm_execute(&mut fxt, Expect::Success);
+}
+
+#[test]
+fn conn_open_confirm_no_connection() {
+    let fxt = conn_open_confirm_fixture(Ctx::Default);
+    conn_open_confirm_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_confirm_connection_mismatch() {
+    let fxt = conn_open_confirm_fixture(Ctx::IncorrectConnection);
+    conn_open_confirm_validate(&fxt, Expect::Failure(None));
+}
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
new file mode 100644
index 000000000..02e9a38a6
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -0,0 +1,140 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::State;
+use ibc::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
+use ibc::core::ics03_connection::msgs::ConnectionMsg;
+use ibc::core::ics03_connection::version::Version;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::connection::{
+    dummy_msg_conn_open_init, msg_conn_open_init_with_counterparty_conn_id,
+    msg_conn_open_with_version,
+};
+use ibc_testkit::utils::{Expect, Fixture};
+use test_log::test;
+
+enum Ctx {
+    Default,
+    WithClient,
+}
+
+enum Msg {
+    Default,
+    NoVersion,
+    BadVersion,
+    WithCounterpartyConnId,
+}
+
+fn conn_open_init_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConnectionOpenInit> {
+    let msg_default = dummy_msg_conn_open_init();
+    let msg = match msg_variant {
+        Msg::Default => msg_default.clone(),
+        Msg::NoVersion => msg_conn_open_with_version(msg_default, None),
+        Msg::BadVersion => {
+            msg_conn_open_with_version(msg_default, Some("random identifier 424242"))
+        }
+        Msg::WithCounterpartyConnId => msg_conn_open_init_with_counterparty_conn_id(msg_default, 2),
+    };
+
+    let ctx_default = MockContext::default();
+    let ctx = match ctx_variant {
+        Ctx::WithClient => {
+            ctx_default.with_client(&msg.client_id_on_a, Height::new(0, 10).unwrap())
+        }
+        _ => ctx_default,
+    };
+
+    Fixture { ctx, msg }
+}
+
+fn conn_open_init_validate(fxt: &Fixture<MsgConnectionOpenInit>, expect: Expect) {
+    let router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = validate(&fxt.ctx, &router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}")
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}")
+        }
+    }
+}
+
+fn conn_open_init_execute(
+    fxt: &mut Fixture<MsgConnectionOpenInit>,
+    expect: Expect,
+    expected_version: Vec<Version>,
+) {
+    let mut router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = execute(&mut fxt.ctx, &mut router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}")
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+
+            assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
+
+            assert_eq!(fxt.ctx.events.len(), 2);
+
+            assert!(matches!(
+                fxt.ctx.events[0],
+                IbcEvent::Message(MessageEvent::Connection)
+            ));
+            let event = &fxt.ctx.events[1];
+            assert!(matches!(event, &IbcEvent::OpenInitConnection(_)));
+
+            let conn_open_init_event = match event {
+                IbcEvent::OpenInitConnection(e) => e,
+                _ => unreachable!(),
+            };
+            let conn_end =
+                ValidationContext::connection_end(&fxt.ctx, conn_open_init_event.conn_id_on_a())
+                    .unwrap();
+            assert_eq!(conn_end.state().clone(), State::Init);
+            assert_eq!(conn_end.versions(), expected_version);
+        }
+    }
+}
+
+#[test]
+fn conn_open_init_healthy() {
+    let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::Default);
+    conn_open_init_validate(&fxt, Expect::Success);
+    let expected_version = vec![fxt.msg.version.clone().unwrap()];
+    conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
+}
+
+#[test]
+fn conn_open_init_no_context() {
+    let fxt = conn_open_init_fixture(Ctx::Default, Msg::Default);
+    conn_open_init_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_init_no_version() {
+    let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::NoVersion);
+    conn_open_init_validate(&fxt, Expect::Success);
+    let expected_version = ValidationContext::get_compatible_versions(&fxt.ctx.clone());
+    conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
+}
+#[test]
+fn conn_open_init_incompatible_version() {
+    let fxt = conn_open_init_fixture(Ctx::WithClient, Msg::BadVersion);
+    conn_open_init_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_init_with_counterparty_conn_id() {
+    let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::WithCounterpartyConnId);
+    conn_open_init_validate(&fxt, Expect::Success);
+    let expected_version = vec![fxt.msg.version.clone().unwrap()];
+    conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
+}
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
new file mode 100644
index 000000000..47a87a673
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -0,0 +1,147 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::State;
+use ibc::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
+use ibc::core::ics03_connection::msgs::ConnectionMsg;
+use ibc::core::ics24_host::identifier::ChainId;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::Height;
+use ibc_testkit::hosts::block::HostType;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::connection::dummy_msg_conn_open_try;
+use ibc_testkit::utils::{Expect, Fixture};
+use test_log::test;
+
+enum Ctx {
+    Default,
+    WithClient,
+}
+
+enum Msg {
+    Default,
+    HeightAdvanced,
+    HeightOld,
+    ProofHeightMissing,
+}
+
+fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConnectionOpenTry> {
+    let max_history_size = 5;
+    let client_cons_state_height = 10;
+    let host_chain_height = Height::new(0, 35).unwrap();
+    let pruned_height = host_chain_height
+        .sub(max_history_size + 1)
+        .unwrap()
+        .revision_height();
+
+    let msg = match msg_variant {
+        Msg::Default => dummy_msg_conn_open_try(
+            client_cons_state_height,
+            host_chain_height.revision_height(),
+        ),
+        Msg::HeightAdvanced => dummy_msg_conn_open_try(
+            client_cons_state_height,
+            host_chain_height.increment().revision_height(),
+        ),
+        Msg::HeightOld => dummy_msg_conn_open_try(client_cons_state_height, pruned_height),
+        Msg::ProofHeightMissing => dummy_msg_conn_open_try(
+            client_cons_state_height - 1,
+            host_chain_height.revision_height(),
+        ),
+    };
+
+    let ctx_new = MockContext::new(
+        ChainId::new("mockgaia-0").unwrap(),
+        HostType::Mock,
+        max_history_size,
+        host_chain_height,
+    );
+    let ctx = match ctx_variant {
+        Ctx::Default => MockContext::default(),
+        Ctx::WithClient => ctx_new.with_client(
+            &msg.client_id_on_b,
+            Height::new(0, client_cons_state_height).unwrap(),
+        ),
+    };
+    Fixture { ctx, msg }
+}
+
+fn conn_open_try_validate(fxt: &Fixture<MsgConnectionOpenTry>, expect: Expect) {
+    let router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = validate(&fxt.ctx, &router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}")
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+        }
+    }
+}
+
+fn conn_open_try_execute(fxt: &mut Fixture<MsgConnectionOpenTry>, expect: Expect) {
+    let mut router = MockRouter::new_with_transfer();
+    let msg_envelope = MsgEnvelope::from(ConnectionMsg::from(fxt.msg.clone()));
+    let res = execute(&mut fxt.ctx, &mut router, msg_envelope);
+    let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
+    match expect {
+        Expect::Failure(_) => {
+            assert!(res.is_err(), "{err_msg}")
+        }
+        Expect::Success => {
+            assert!(res.is_ok(), "{err_msg}");
+
+            assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
+
+            assert_eq!(fxt.ctx.events.len(), 2);
+
+            assert!(matches!(
+                fxt.ctx.events[0],
+                IbcEvent::Message(MessageEvent::Connection)
+            ));
+            let event = &fxt.ctx.events[1];
+            assert!(matches!(event, &IbcEvent::OpenTryConnection(_)));
+
+            let conn_open_try_event = match event {
+                IbcEvent::OpenTryConnection(e) => e,
+                _ => unreachable!(),
+            };
+            let conn_end =
+                ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
+                    .unwrap();
+            assert_eq!(conn_end.state().clone(), State::TryOpen);
+        }
+    }
+}
+
+#[test]
+fn conn_open_try_healthy() {
+    let mut fxt = conn_open_try_fixture(Ctx::WithClient, Msg::Default);
+    conn_open_try_validate(&fxt, Expect::Success);
+    conn_open_try_execute(&mut fxt, Expect::Success);
+}
+
+#[test]
+fn conn_open_try_height_advanced() {
+    let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::HeightAdvanced);
+    conn_open_try_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_try_height_old() {
+    let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::HeightOld);
+    conn_open_try_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_try_proof_height_missing() {
+    let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::ProofHeightMissing);
+    conn_open_try_validate(&fxt, Expect::Failure(None));
+}
+
+#[test]
+fn conn_open_try_no_client() {
+    let fxt = conn_open_try_fixture(Ctx::Default, Msg::Default);
+    conn_open_try_validate(&fxt, Expect::Failure(None));
+}
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/mod.rs b/crates/ibc-testkit/tests/core/ics03_connection/mod.rs
new file mode 100644
index 000000000..c504edc00
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics03_connection/mod.rs
@@ -0,0 +1,4 @@
+pub mod conn_open_ack;
+pub mod conn_open_confirm;
+pub mod conn_open_init;
+pub mod conn_open_try;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
new file mode 100644
index 000000000..c79908f8f
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -0,0 +1,265 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics02_client::ClientExecutionContext;
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
+use ibc::core::ics04_channel::msgs::PacketMsg;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
+use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
+use rstest::*;
+use test_log::test;
+
+struct Fixture {
+    ctx: MockContext,
+    router: MockRouter,
+    client_height: Height,
+    msg: MsgAcknowledgement,
+    packet_commitment: PacketCommitment,
+    conn_end_on_a: ConnectionEnd,
+    chan_end_on_a_ordered: ChannelEnd,
+    chan_end_on_a_unordered: ChannelEnd,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let client_height = Height::new(0, 2).unwrap();
+    let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+
+    let router = MockRouter::new_with_transfer();
+
+    let msg = MsgAcknowledgement::try_from(dummy_raw_msg_acknowledgement(
+        client_height.revision_height(),
+    ))
+    .unwrap();
+
+    let packet = msg.packet.clone();
+
+    let packet_commitment = compute_packet_commitment(
+        &packet.data,
+        &packet.timeout_height_on_b,
+        &packet.timeout_timestamp_on_b,
+    );
+
+    let chan_end_on_a_unordered = ChannelEnd::new(
+        State::Open,
+        Order::Unordered,
+        Counterparty::new(packet.port_id_on_b, Some(packet.chan_id_on_b)),
+        vec![ConnectionId::default()],
+        Version::new("ics20-1".to_string()),
+    )
+    .unwrap();
+
+    let mut chan_end_on_a_ordered = chan_end_on_a_unordered.clone();
+    chan_end_on_a_ordered.ordering = Order::Ordered;
+
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Open,
+        ClientId::default(),
+        ConnectionCounterparty::new(
+            ClientId::default(),
+            Some(ConnectionId::default()),
+            Default::default(),
+        ),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    Fixture {
+        ctx,
+        router,
+        client_height,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        chan_end_on_a_ordered,
+    }
+}
+
+#[rstest]
+fn ack_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        ctx, router, msg, ..
+    } = fixture;
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+/// NO-OP case
+#[rstest]
+fn ack_success_no_packet_commitment(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        client_height,
+        ..
+    } = fixture;
+    let ctx = ctx
+        .with_client(&ClientId::default(), client_height)
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a);
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation should succeed when no packet commitment is present"
+    )
+}
+
+#[rstest]
+fn ack_success_happy_path(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        client_height,
+        ..
+    } = fixture;
+    let mut ctx: MockContext = ctx
+        .with_client(&ClientId::default(), client_height)
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+    ctx.get_client_execution_context()
+        .store_update_time(
+            ClientId::default(),
+            client_height,
+            Timestamp::from_nanoseconds(1000).unwrap(),
+        )
+        .unwrap();
+    ctx.get_client_execution_context()
+        .store_update_height(
+            ClientId::default(),
+            client_height,
+            Height::new(0, 4).unwrap(),
+        )
+        .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Happy path: validation should succeed. err: {res:?}"
+    )
+}
+
+#[rstest]
+fn ack_unordered_chan_execute(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        mut router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        ..
+    } = fixture;
+    let mut ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok());
+
+    assert_eq!(ctx.events.len(), 2);
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
+}
+
+#[rstest]
+fn ack_ordered_chan_execute(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        mut router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_ordered,
+        ..
+    } = fixture;
+    let mut ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_ordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok());
+
+    assert_eq!(ctx.events.len(), 2);
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
new file mode 100644
index 000000000..6ab70d27d
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -0,0 +1,134 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
+use ibc::core::ics04_channel::msgs::{ChannelMsg, MsgChannelCloseConfirm};
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_confirm;
+use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
+
+#[test]
+fn test_chan_close_confirm_validate() {
+    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let conn_id = ConnectionId::new(2);
+    let default_context = MockContext::default();
+    let client_consensus_state_height = default_context.host_height().unwrap();
+
+    let conn_end = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg_chan_close_confirm = MsgChannelCloseConfirm::try_from(
+        dummy_raw_msg_chan_close_confirm(client_consensus_state_height.revision_height()),
+    )
+    .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg_chan_close_confirm.clone()));
+
+    let chan_end = ChannelEnd::new(
+        ChannelState::Open,
+        Order::default(),
+        Counterparty::new(
+            msg_chan_close_confirm.port_id_on_b.clone(),
+            Some(msg_chan_close_confirm.chan_id_on_b.clone()),
+        ),
+        vec![conn_id.clone()],
+        Version::default(),
+    )
+    .unwrap();
+
+    let context = default_context
+        .with_client(&client_id, client_consensus_state_height)
+        .with_connection(conn_id, conn_end)
+        .with_channel(
+            msg_chan_close_confirm.port_id_on_b.clone(),
+            msg_chan_close_confirm.chan_id_on_b.clone(),
+            chan_end,
+        );
+
+    let router = MockRouter::new_with_transfer();
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation expected to succeed (happy path). Error: {res:?}"
+    );
+}
+
+#[test]
+fn test_chan_close_confirm_execute() {
+    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let conn_id = ConnectionId::new(2);
+    let default_context = MockContext::default();
+    let client_consensus_state_height = default_context.host_height().unwrap();
+
+    let conn_end = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg_chan_close_confirm = MsgChannelCloseConfirm::try_from(
+        dummy_raw_msg_chan_close_confirm(client_consensus_state_height.revision_height()),
+    )
+    .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg_chan_close_confirm.clone()));
+
+    let chan_end = ChannelEnd::new(
+        ChannelState::Open,
+        Order::default(),
+        Counterparty::new(
+            msg_chan_close_confirm.port_id_on_b.clone(),
+            Some(msg_chan_close_confirm.chan_id_on_b.clone()),
+        ),
+        vec![conn_id.clone()],
+        Version::default(),
+    )
+    .unwrap();
+
+    let mut context = default_context
+        .with_client(&client_id, client_consensus_state_height)
+        .with_connection(conn_id, conn_end)
+        .with_channel(
+            msg_chan_close_confirm.port_id_on_b.clone(),
+            msg_chan_close_confirm.chan_id_on_b.clone(),
+            chan_end,
+        );
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let res = execute(&mut context, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "Execution success: happy path");
+
+    assert_eq!(context.events.len(), 2);
+
+    assert!(matches!(
+        context.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+
+    assert!(matches!(
+        context.events[1],
+        IbcEvent::CloseConfirmChannel(_)
+    ));
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
new file mode 100644
index 000000000..51d880cfe
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -0,0 +1,133 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
+use ibc::core::ics04_channel::msgs::{ChannelMsg, MsgChannelCloseInit};
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_init;
+use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
+
+#[test]
+fn test_chan_close_init_validate() {
+    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let conn_id = ConnectionId::new(2);
+
+    let conn_end = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg_chan_close_init =
+        MsgChannelCloseInit::try_from(dummy_raw_msg_chan_close_init()).unwrap();
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg_chan_close_init.clone()));
+
+    let chan_end = ChannelEnd::new(
+        ChannelState::Open,
+        Order::default(),
+        Counterparty::new(
+            msg_chan_close_init.port_id_on_a.clone(),
+            Some(msg_chan_close_init.chan_id_on_a.clone()),
+        ),
+        vec![conn_id.clone()],
+        Version::default(),
+    )
+    .unwrap();
+
+    let context = {
+        let default_context = MockContext::default();
+        let client_consensus_state_height = default_context.host_height().unwrap();
+
+        default_context
+            .with_client(&client_id, client_consensus_state_height)
+            .with_connection(conn_id, conn_end)
+            .with_channel(
+                msg_chan_close_init.port_id_on_a.clone(),
+                msg_chan_close_init.chan_id_on_a.clone(),
+                chan_end,
+            )
+    };
+
+    let router = MockRouter::new_with_transfer();
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation expected to succeed (happy path). Error: {res:?}"
+    );
+}
+
+#[test]
+fn test_chan_close_init_execute() {
+    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let conn_id = ConnectionId::new(2);
+
+    let conn_end = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg_chan_close_init =
+        MsgChannelCloseInit::try_from(dummy_raw_msg_chan_close_init()).unwrap();
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg_chan_close_init.clone()));
+
+    let chan_end = ChannelEnd::new(
+        ChannelState::Open,
+        Order::default(),
+        Counterparty::new(
+            msg_chan_close_init.port_id_on_a.clone(),
+            Some(msg_chan_close_init.chan_id_on_a.clone()),
+        ),
+        vec![conn_id.clone()],
+        Version::default(),
+    )
+    .unwrap();
+
+    let mut context = {
+        let default_context = MockContext::default();
+        let client_consensus_state_height = default_context.host_height().unwrap();
+
+        default_context
+            .with_client(&client_id, client_consensus_state_height)
+            .with_connection(conn_id, conn_end)
+            .with_channel(
+                msg_chan_close_init.port_id_on_a.clone(),
+                msg_chan_close_init.chan_id_on_a.clone(),
+                chan_end,
+            )
+    };
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let res = execute(&mut context, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "Execution happy path");
+
+    assert_eq!(context.events.len(), 2);
+
+    assert!(matches!(
+        context.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+
+    assert!(matches!(context.events[1], IbcEvent::CloseInitChannel(_)));
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
new file mode 100644
index 000000000..25a7d36c5
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -0,0 +1,240 @@
+use ibc::applications::transfer::MODULE_ID_STR;
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
+use ibc::core::ics04_channel::msgs::ChannelMsg;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::router::ModuleId;
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_ack;
+use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
+use rstest::*;
+use test_log::test;
+
+pub struct Fixture {
+    pub context: MockContext,
+    pub router: MockRouter,
+    pub module_id: ModuleId,
+    pub msg: MsgChannelOpenAck,
+    pub client_id_on_a: ClientId,
+    pub conn_id_on_a: ConnectionId,
+    pub conn_end_on_a: ConnectionEnd,
+    pub chan_end_on_a: ChannelEnd,
+    pub proof_height: u64,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let proof_height = 10;
+    let context = MockContext::default();
+
+    let module_id = ModuleId::new(MODULE_ID_STR.to_string());
+    let router = MockRouter::new_with_transfer();
+
+    let client_id_on_a = ClientId::new(mock_client_type(), 45).unwrap();
+    let conn_id_on_a = ConnectionId::new(2);
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id_on_a.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg = MsgChannelOpenAck::try_from(dummy_raw_msg_chan_open_ack(proof_height)).unwrap();
+
+    let chan_end_on_a = ChannelEnd::new(
+        State::Init,
+        Order::Unordered,
+        Counterparty::new(msg.port_id_on_a.clone(), Some(msg.chan_id_on_b.clone())),
+        vec![conn_id_on_a.clone()],
+        msg.version_on_b.clone(),
+    )
+    .unwrap();
+
+    Fixture {
+        context,
+        router,
+        module_id,
+        msg,
+        client_id_on_a,
+        conn_id_on_a,
+        conn_end_on_a,
+        chan_end_on_a,
+        proof_height,
+    }
+}
+
+#[rstest]
+fn chan_open_ack_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_a,
+        conn_id_on_a,
+        conn_end_on_a,
+        chan_end_on_a,
+        proof_height,
+        ..
+    } = fixture;
+
+    let context = context
+        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_a, conn_end_on_a)
+        .with_channel(
+            msg.port_id_on_a.clone(),
+            msg.chan_id_on_a.clone(),
+            chan_end_on_a,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(res.is_ok(), "Validation happy path")
+}
+
+#[rstest]
+fn chan_open_ack_execute_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        mut router,
+        msg,
+        client_id_on_a,
+        conn_id_on_a,
+        conn_end_on_a,
+        chan_end_on_a,
+        proof_height,
+        ..
+    } = fixture;
+
+    let mut context = context
+        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_a, conn_end_on_a)
+        .with_channel(
+            msg.port_id_on_a.clone(),
+            msg.chan_id_on_a.clone(),
+            chan_end_on_a,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg.clone()));
+
+    let res = execute(&mut context, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "Execution happy path");
+
+    assert_eq!(context.events.len(), 2);
+    assert!(matches!(
+        context.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(context.events[1], IbcEvent::OpenAckChannel(_)));
+}
+
+#[rstest]
+fn chan_open_ack_fail_no_connection(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_a,
+        chan_end_on_a,
+        proof_height,
+        ..
+    } = fixture;
+
+    let context = context
+        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_channel(
+            msg.port_id_on_a.clone(),
+            msg.chan_id_on_a.clone(),
+            chan_end_on_a,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no connection exists in the context"
+    )
+}
+
+#[rstest]
+fn chan_open_ack_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_a,
+        conn_id_on_a,
+        conn_end_on_a,
+        proof_height,
+        ..
+    } = fixture;
+    let context = context
+        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_a, conn_end_on_a);
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+#[rstest]
+fn chan_open_ack_fail_channel_wrong_state(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_a,
+        conn_id_on_a,
+        conn_end_on_a,
+        proof_height,
+        ..
+    } = fixture;
+
+    let wrong_chan_end = ChannelEnd::new(
+        State::Open,
+        Order::Unordered,
+        Counterparty::new(msg.port_id_on_a.clone(), Some(msg.chan_id_on_b.clone())),
+        vec![conn_id_on_a.clone()],
+        msg.version_on_b.clone(),
+    )
+    .unwrap();
+    let context = context
+        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_a, conn_end_on_a)
+        .with_channel(
+            msg.port_id_on_a.clone(),
+            msg.chan_id_on_a.clone(),
+            wrong_chan_end,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because channel is in the wrong state"
+    )
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
new file mode 100644
index 000000000..1b6df3e4b
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -0,0 +1,209 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
+use ibc::core::ics04_channel::msgs::ChannelMsg;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId};
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_confirm;
+use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
+use rstest::*;
+use test_log::test;
+
+pub struct Fixture {
+    pub context: MockContext,
+    pub router: MockRouter,
+    pub msg: MsgChannelOpenConfirm,
+    pub client_id_on_b: ClientId,
+    pub conn_id_on_b: ConnectionId,
+    pub conn_end_on_b: ConnectionEnd,
+    pub chan_end_on_b: ChannelEnd,
+    pub proof_height: u64,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let proof_height = 10;
+    let context = MockContext::default();
+
+    let router = MockRouter::new_with_transfer();
+
+    let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
+    let conn_id_on_b = ConnectionId::new(2);
+    let conn_end_on_b = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id_on_b.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let msg =
+        MsgChannelOpenConfirm::try_from(dummy_raw_msg_chan_open_confirm(proof_height)).unwrap();
+
+    let chan_end_on_b = ChannelEnd::new(
+        State::TryOpen,
+        Order::Unordered,
+        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
+        vec![conn_id_on_b.clone()],
+        Version::default(),
+    )
+    .unwrap();
+
+    Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        chan_end_on_b,
+        proof_height,
+    }
+}
+
+#[rstest]
+fn chan_open_confirm_validate_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        chan_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+
+    let context = context
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b)
+        .with_channel(
+            msg.port_id_on_b.clone(),
+            ChannelId::default(),
+            chan_end_on_b,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(res.is_ok(), "Validation happy path")
+}
+
+#[rstest]
+fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        mut router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        chan_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+
+    let mut context = context
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b)
+        .with_channel(
+            msg.port_id_on_b.clone(),
+            ChannelId::default(),
+            chan_end_on_b,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = execute(&mut context, &mut router, msg_envelope);
+
+    assert!(res.is_ok(), "Execution happy path");
+
+    assert_eq!(context.events.len(), 2);
+
+    assert!(matches!(
+        context.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+
+    assert!(matches!(context.events[1], IbcEvent::OpenConfirmChannel(_)));
+}
+
+#[rstest]
+fn chan_open_confirm_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+    let context = context
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b);
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+#[rstest]
+fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+
+    let wrong_chan_end = ChannelEnd::new(
+        State::Init,
+        Order::Unordered,
+        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
+        vec![conn_id_on_b.clone()],
+        Version::default(),
+    )
+    .unwrap();
+    let context = context
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b)
+        .with_channel(
+            msg.port_id_on_b.clone(),
+            ChannelId::default(),
+            wrong_chan_end,
+        );
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because channel is in the wrong state"
+    )
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
new file mode 100644
index 000000000..645d1a180
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -0,0 +1,116 @@
+use ibc::clients::ics07_tendermint::client_type as tm_client_type;
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics03_connection::connection::{ConnectionEnd, State as ConnectionState};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
+use ibc::core::ics04_channel::msgs::ChannelMsg;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
+use ibc_testkit::utils::core::connection::dummy_msg_conn_open_init;
+use rstest::*;
+use test_log::test;
+
+pub struct Fixture {
+    pub ctx: MockContext,
+    pub router: MockRouter,
+    pub msg: MsgEnvelope,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let msg_chan_open_init =
+        MsgChannelOpenInit::try_from(dummy_raw_msg_chan_open_init(None)).unwrap();
+
+    let msg = MsgEnvelope::from(ChannelMsg::from(msg_chan_open_init));
+
+    let default_ctx = MockContext::default();
+    let router = MockRouter::new_with_transfer();
+
+    let msg_conn_init = dummy_msg_conn_open_init();
+
+    let client_id_on_a = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_height = Height::new(0, 10).unwrap();
+
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Init,
+        msg_conn_init.client_id_on_a.clone(),
+        msg_conn_init.counterparty.clone(),
+        get_compatible_versions(),
+        msg_conn_init.delay_period,
+    )
+    .unwrap();
+
+    let ctx = default_ctx
+        .with_client(&client_id_on_a, client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_a);
+
+    Fixture { ctx, router, msg }
+}
+
+#[rstest]
+fn chan_open_init_validate_happy_path(fixture: Fixture) {
+    let Fixture {
+        ctx, router, msg, ..
+    } = fixture;
+
+    let res = validate(&ctx, &router, msg);
+
+    assert!(res.is_ok(), "Validation succeeds; good parameters")
+}
+
+#[rstest]
+fn chan_open_init_validate_counterparty_chan_id_set(fixture: Fixture) {
+    let Fixture { ctx, router, .. } = fixture;
+
+    let msg = MsgChannelOpenInit::try_from(dummy_raw_msg_chan_open_init(None)).unwrap();
+
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation succeeds even if counterparty channel id is set by relayer"
+    )
+}
+
+#[rstest]
+fn chan_open_init_execute_happy_path(fixture: Fixture) {
+    let Fixture {
+        mut ctx,
+        mut router,
+        msg,
+        ..
+    } = fixture;
+
+    let res = execute(&mut ctx, &mut router, msg);
+
+    assert!(res.is_ok(), "Execution succeeds; good parameters");
+
+    assert_eq!(ctx.channel_counter().unwrap(), 1);
+
+    assert_eq!(ctx.events.len(), 2);
+
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::OpenInitChannel(_)));
+}
+
+#[rstest]
+fn chan_open_init_fail_no_connection(fixture: Fixture) {
+    let Fixture { router, msg, .. } = fixture;
+
+    let res = validate(&MockContext::default(), &router, msg);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no connection exists in the context"
+    )
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
new file mode 100644
index 000000000..bcee388bf
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -0,0 +1,158 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
+use ibc::core::ics04_channel::msgs::ChannelMsg;
+use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
+use ibc::core::timestamp::ZERO_DURATION;
+use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_try;
+use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
+use rstest::*;
+use test_log::test;
+
+pub struct Fixture {
+    pub ctx: MockContext,
+    pub router: MockRouter,
+    pub msg: MsgEnvelope,
+    pub client_id_on_b: ClientId,
+    pub conn_id_on_b: ConnectionId,
+    pub conn_end_on_b: ConnectionEnd,
+    pub proof_height: u64,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let proof_height = 10;
+    let conn_id_on_b = ConnectionId::new(2);
+    let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
+
+    // This is the connection underlying the channel we're trying to open.
+    let conn_end_on_b = ConnectionEnd::new(
+        ConnectionState::Open,
+        client_id_on_b.clone(),
+        ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    // We're going to test message processing against this message.
+    // Note: we make the counterparty's channel_id `None`.
+    let mut msg_chan_open_try =
+        MsgChannelOpenTry::try_from(dummy_raw_msg_chan_open_try(proof_height)).unwrap();
+
+    let hops = vec![conn_id_on_b.clone()];
+    msg_chan_open_try.connection_hops_on_b = hops;
+
+    let msg = MsgEnvelope::from(ChannelMsg::from(msg_chan_open_try));
+
+    let ctx = MockContext::default();
+
+    let router = MockRouter::new_with_transfer();
+
+    Fixture {
+        ctx,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        proof_height,
+    }
+}
+
+#[rstest]
+fn chan_open_try_validate_happy_path(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+
+    let ctx = ctx
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b);
+
+    let res = validate(&ctx, &router, msg);
+
+    assert!(res.is_ok(), "Validation success: happy path")
+}
+
+#[rstest]
+fn chan_open_try_execute_happy_path(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        mut router,
+        msg,
+        client_id_on_b,
+        conn_id_on_b,
+        conn_end_on_b,
+        proof_height,
+        ..
+    } = fixture;
+
+    let mut ctx = ctx
+        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_connection(conn_id_on_b, conn_end_on_b);
+
+    let res = execute(&mut ctx, &mut router, msg);
+
+    assert!(res.is_ok(), "Execution success: happy path");
+
+    assert_eq!(ctx.channel_counter().unwrap(), 1);
+
+    assert_eq!(ctx.events.len(), 2);
+
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::OpenTryChannel(_)));
+}
+
+#[rstest]
+fn chan_open_try_fail_no_connection(fixture: Fixture) {
+    let Fixture {
+        ctx, router, msg, ..
+    } = fixture;
+
+    let res = validate(&ctx, &router, msg);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no connection exists in the context"
+    )
+}
+
+#[rstest]
+fn chan_open_try_fail_no_client_state(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        conn_id_on_b,
+        conn_end_on_b,
+        ..
+    } = fixture;
+    let ctx = ctx.with_connection(conn_id_on_b, conn_end_on_b);
+
+    let res = validate(&ctx, &router, msg);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because the context has no client state"
+    )
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/mod.rs b/crates/ibc-testkit/tests/core/ics04_channel/mod.rs
new file mode 100644
index 000000000..01d376a35
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/mod.rs
@@ -0,0 +1,11 @@
+pub mod acknowledgement;
+pub mod chan_close_confirm;
+pub mod chan_close_init;
+pub mod chan_open_ack;
+pub mod chan_open_confirm;
+pub mod chan_open_init;
+pub mod chan_open_try;
+pub mod recv_packet;
+pub mod send_packet;
+pub mod timeout;
+pub mod timeout_on_close;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
new file mode 100644
index 000000000..64b4b5ca8
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -0,0 +1,245 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::ClientExecutionContext;
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
+use ibc::core::ics04_channel::msgs::PacketMsg;
+use ibc::core::ics04_channel::packet::Packet;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
+use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::relayer::context::RelayerContext;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::{dummy_msg_recv_packet, dummy_raw_msg_recv_packet};
+use ibc_testkit::utils::core::signer::dummy_account_id;
+use rstest::*;
+use test_log::test;
+
+pub struct Fixture {
+    pub context: MockContext,
+    pub router: MockRouter,
+    pub client_height: Height,
+    pub host_height: Height,
+    pub msg: MsgRecvPacket,
+    pub conn_end_on_b: ConnectionEnd,
+    pub chan_end_on_b: ChannelEnd,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let context = MockContext::default();
+
+    let router = MockRouter::new_with_transfer();
+
+    let host_height = context.query_latest_height().unwrap().increment();
+
+    let client_height = host_height.increment();
+
+    let msg = MsgRecvPacket::try_from(dummy_raw_msg_recv_packet(client_height.revision_height()))
+        .unwrap();
+
+    let packet = msg.packet.clone();
+
+    let chan_end_on_b = ChannelEnd::new(
+        State::Open,
+        Order::default(),
+        Counterparty::new(packet.port_id_on_a, Some(packet.chan_id_on_a)),
+        vec![ConnectionId::default()],
+        Version::new("ics20-1".to_string()),
+    )
+    .unwrap();
+
+    let conn_end_on_b = ConnectionEnd::new(
+        ConnectionState::Open,
+        ClientId::default(),
+        ConnectionCounterparty::new(
+            ClientId::default(),
+            Some(ConnectionId::default()),
+            Default::default(),
+        ),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    Fixture {
+        context,
+        router,
+        client_height,
+        host_height,
+        msg,
+        conn_end_on_b,
+        chan_end_on_b,
+    }
+}
+
+#[rstest]
+fn recv_packet_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        ..
+    } = fixture;
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+#[rstest]
+fn recv_packet_validate_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        conn_end_on_b,
+        chan_end_on_b,
+        client_height,
+        host_height,
+        ..
+    } = fixture;
+
+    let packet = &msg.packet;
+    let mut context = context
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_b)
+        .with_channel(
+            packet.port_id_on_b.clone(),
+            packet.chan_id_on_b.clone(),
+            chan_end_on_b,
+        )
+        .with_send_sequence(
+            packet.port_id_on_b.clone(),
+            packet.chan_id_on_b.clone(),
+            1.into(),
+        )
+        .with_height(host_height)
+        // This `with_recv_sequence` is required for ordered channels
+        .with_recv_sequence(
+            packet.port_id_on_b.clone(),
+            packet.chan_id_on_b.clone(),
+            packet.seq_on_a,
+        );
+
+    context
+        .get_client_execution_context()
+        .store_update_time(
+            ClientId::default(),
+            client_height,
+            Timestamp::from_nanoseconds(1000).unwrap(),
+        )
+        .unwrap();
+    context
+        .get_client_execution_context()
+        .store_update_height(
+            ClientId::default(),
+            client_height,
+            Height::new(0, 5).unwrap(),
+        )
+        .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Happy path: validation should succeed. err: {res:?}"
+    )
+}
+
+#[rstest]
+fn recv_packet_timeout_expired(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        conn_end_on_b,
+        chan_end_on_b,
+        client_height,
+        host_height,
+        ..
+    } = fixture;
+
+    let packet_old = Packet {
+        seq_on_a: 1.into(),
+        port_id_on_a: PortId::transfer(),
+        chan_id_on_a: ChannelId::default(),
+        port_id_on_b: PortId::transfer(),
+        chan_id_on_b: ChannelId::default(),
+        data: Vec::new(),
+        timeout_height_on_b: client_height.into(),
+        timeout_timestamp_on_b: Timestamp::from_nanoseconds(1).unwrap(),
+    };
+
+    let msg_packet_old = dummy_msg_recv_packet(
+        packet_old,
+        msg.proof_commitment_on_a.clone(),
+        msg.proof_height_on_a,
+        dummy_account_id(),
+    );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg_packet_old));
+
+    let context = context
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_b)
+        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b)
+        .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into())
+        .with_height(host_height);
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "recv_packet validation should fail when the packet has timed out"
+    )
+}
+
+#[rstest]
+fn recv_packet_execute_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        mut router,
+        msg,
+        conn_end_on_b,
+        chan_end_on_b,
+        client_height,
+        ..
+    } = fixture;
+    let mut ctx = context
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_b)
+        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b);
+
+    let msg_env = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_env);
+
+    assert!(res.is_ok());
+
+    assert_eq!(ctx.events.len(), 4);
+    assert!(matches!(
+        &ctx.events[0],
+        &IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(&ctx.events[1], &IbcEvent::ReceivePacket(_)));
+    assert!(matches!(
+        &ctx.events[2],
+        &IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(&ctx.events[3], &IbcEvent::WriteAcknowledgement(_)));
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs
new file mode 100644
index 000000000..4262627c0
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -0,0 +1,186 @@
+use core::ops::Add;
+use core::time::Duration;
+
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::packet::Packet;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::send_packet;
+use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_packet;
+use test_log::test;
+
+#[test]
+fn send_packet_processing() {
+    struct Test {
+        name: String,
+        ctx: MockContext,
+        packet: Packet,
+        want_pass: bool,
+    }
+
+    let context = MockContext::default();
+
+    let chan_end_on_a = ChannelEnd::new(
+        State::Open,
+        Order::default(),
+        Counterparty::new(PortId::transfer(), Some(ChannelId::default())),
+        vec![ConnectionId::default()],
+        Version::new("ics20-1".to_string()),
+    )
+    .unwrap();
+
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Open,
+        ClientId::default(),
+        ConnectionCounterparty::new(
+            ClientId::default(),
+            Some(ConnectionId::default()),
+            Default::default(),
+        ),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    let timestamp_future = Timestamp::now().add(Duration::from_secs(10)).unwrap();
+    let timestamp_ns_past = 1;
+
+    let timeout_height_future = 10;
+
+    let mut packet: Packet =
+        dummy_raw_packet(timeout_height_future, timestamp_future.nanoseconds())
+            .try_into()
+            .unwrap();
+    packet.seq_on_a = 1.into();
+    packet.data = vec![0];
+
+    let mut packet_with_timestamp_old: Packet =
+        dummy_raw_packet(timeout_height_future, timestamp_ns_past)
+            .try_into()
+            .unwrap();
+    packet_with_timestamp_old.seq_on_a = 1.into();
+    packet_with_timestamp_old.data = vec![0];
+
+    let client_raw_height = 5;
+    let packet_timeout_equal_client_height: Packet =
+        dummy_raw_packet(client_raw_height, timestamp_future.nanoseconds())
+            .try_into()
+            .unwrap();
+    let packet_timeout_one_before_client_height: Packet =
+        dummy_raw_packet(client_raw_height - 1, timestamp_future.nanoseconds())
+            .try_into()
+            .unwrap();
+
+    let client_height = Height::new(0, client_raw_height).unwrap();
+
+    let tests: Vec<Test> = vec![
+        Test {
+            name: "Processing fails because no channel exists in the context".to_string(),
+            ctx: context.clone(),
+            packet: packet.clone(),
+            want_pass: false,
+        },
+        Test {
+            name: "Good parameters".to_string(),
+            ctx: context
+                .clone()
+                .with_client(&ClientId::default(), client_height)
+                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
+                .with_channel(
+                    PortId::transfer(),
+                    ChannelId::default(),
+                    chan_end_on_a.clone(),
+                )
+                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+            packet,
+            want_pass: true,
+        },
+        Test {
+            name: "Packet timeout height same as destination chain height".to_string(),
+            ctx: context
+                .clone()
+                .with_client(&ClientId::default(), client_height)
+                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
+                .with_channel(
+                    PortId::transfer(),
+                    ChannelId::default(),
+                    chan_end_on_a.clone(),
+                )
+                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+            packet: packet_timeout_equal_client_height,
+            want_pass: true,
+        },
+        Test {
+            name: "Packet timeout height one more than destination chain height".to_string(),
+            ctx: context
+                .clone()
+                .with_client(&ClientId::default(), client_height)
+                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
+                .with_channel(
+                    PortId::transfer(),
+                    ChannelId::default(),
+                    chan_end_on_a.clone(),
+                )
+                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+            packet: packet_timeout_one_before_client_height,
+            want_pass: false,
+        },
+        Test {
+            name: "Packet timeout due to timestamp".to_string(),
+            ctx: context
+                .with_client(&ClientId::default(), client_height)
+                .with_connection(ConnectionId::default(), conn_end_on_a)
+                .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
+                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+            packet: packet_with_timestamp_old,
+            want_pass: false,
+        },
+    ]
+    .into_iter()
+    .collect();
+
+    for mut test in tests {
+        let res = send_packet(&mut test.ctx, test.packet.clone());
+        // Additionally check the events and the output objects in the result.
+        match res {
+            Ok(()) => {
+                assert!(
+                        test.want_pass,
+                        "send_packet: test passed but was supposed to fail for test: {}, \nparams {:?} {:?}",
+                        test.name,
+                        test.packet.clone(),
+                        test.ctx.clone()
+                    );
+
+                assert!(!test.ctx.events.is_empty()); // Some events must exist.
+
+                assert_eq!(test.ctx.events.len(), 2);
+                assert!(matches!(
+                    &test.ctx.events[0],
+                    &IbcEvent::Message(MessageEvent::Channel)
+                ));
+                // TODO: The object in the output is a PacketResult what can we check on it?
+                assert!(matches!(&test.ctx.events[1], &IbcEvent::SendPacket(_)));
+            }
+            Err(e) => {
+                assert!(
+                    !test.want_pass,
+                    "send_packet: did not pass test: {}, \nparams {:?} {:?} error: {:?}",
+                    test.name,
+                    test.packet.clone(),
+                    test.ctx.clone(),
+                    e,
+                );
+            }
+        }
+    }
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/timeout.rs b/crates/ibc-testkit/tests/core/ics04_channel/timeout.rs
new file mode 100644
index 000000000..d0e2bcd01
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -0,0 +1,431 @@
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::height::Height;
+use ibc::core::ics02_client::ClientExecutionContext;
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::ics04_channel::msgs::timeout::MsgTimeout;
+use ibc::core::ics04_channel::msgs::PacketMsg;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
+use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
+use ibc::prelude::*;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
+use rstest::*;
+
+struct Fixture {
+    ctx: MockContext,
+    pub router: MockRouter,
+    client_height: Height,
+    msg: MsgTimeout,
+    packet_commitment: PacketCommitment,
+    conn_end_on_a: ConnectionEnd,
+    chan_end_on_a_ordered: ChannelEnd,
+    chan_end_on_a_unordered: ChannelEnd,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let client_height = Height::new(0, 2).unwrap();
+    let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+
+    let client_height = Height::new(0, 2).unwrap();
+
+    let router = MockRouter::new_with_transfer();
+
+    let msg_proof_height = 2;
+    let msg_timeout_height = 5;
+    let timeout_timestamp = Timestamp::now().nanoseconds();
+
+    let msg = MsgTimeout::try_from(dummy_raw_msg_timeout(
+        msg_proof_height,
+        msg_timeout_height,
+        timeout_timestamp,
+    ))
+    .unwrap();
+
+    let packet = msg.packet.clone();
+
+    let packet_commitment = compute_packet_commitment(
+        &msg.packet.data,
+        &msg.packet.timeout_height_on_b,
+        &msg.packet.timeout_timestamp_on_b,
+    );
+
+    let chan_end_on_a_unordered = ChannelEnd::new(
+        State::Open,
+        Order::Unordered,
+        Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
+        vec![ConnectionId::default()],
+        Version::new("ics20-1".to_string()),
+    )
+    .unwrap();
+
+    let mut chan_end_on_a_ordered = chan_end_on_a_unordered.clone();
+    chan_end_on_a_ordered.ordering = Order::Ordered;
+
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Open,
+        ClientId::default(),
+        ConnectionCounterparty::new(
+            ClientId::default(),
+            Some(ConnectionId::default()),
+            Default::default(),
+        ),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    Fixture {
+        ctx,
+        router,
+        client_height,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_ordered,
+        chan_end_on_a_unordered,
+    }
+}
+
+#[rstest]
+fn timeout_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        client_height,
+        ..
+    } = fixture;
+    let ctx = ctx.with_client(&ClientId::default(), client_height);
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+#[rstest]
+fn timeout_fail_no_consensus_state_for_height(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        chan_end_on_a_unordered,
+        conn_end_on_a,
+        packet_commitment,
+        ..
+    } = fixture;
+
+    let packet = msg.packet.clone();
+
+    let ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            packet.port_id_on_a,
+            packet.chan_id_on_a,
+            packet.seq_on_a,
+            packet_commitment,
+        );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+            res.is_err(),
+            "Validation fails because the client does not have a consensus state for the required height"
+        )
+}
+
+#[rstest]
+fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        mut msg,
+        chan_end_on_a_unordered,
+        conn_end_on_a,
+        client_height,
+        ..
+    } = fixture;
+
+    // timeout timestamp has not reached yet
+    let timeout_timestamp_on_b =
+        (msg.packet.timeout_timestamp_on_b + core::time::Duration::new(10, 0)).unwrap();
+    msg.packet.timeout_timestamp_on_b = timeout_timestamp_on_b;
+    let packet_commitment = compute_packet_commitment(
+        &msg.packet.data,
+        &msg.packet.timeout_height_on_b,
+        &msg.packet.timeout_timestamp_on_b,
+    );
+
+    let packet = msg.packet.clone();
+
+    let mut ctx = ctx
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_packet_commitment(
+            packet.port_id_on_a,
+            packet.chan_id_on_a,
+            packet.seq_on_a,
+            packet_commitment,
+        );
+
+    ctx.store_update_time(
+        ClientId::default(),
+        client_height,
+        Timestamp::from_nanoseconds(5).unwrap(),
+    )
+    .unwrap();
+    ctx.store_update_height(
+        ClientId::default(),
+        client_height,
+        Height::new(0, 4).unwrap(),
+    )
+    .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+            res.is_err(),
+            "Validation should fail because the timeout height was reached, but the timestamp hasn't been reached. Both the height and timestamp need to be reached for the packet to be considered timed out"
+        )
+}
+
+/// NO-OP case
+#[rstest]
+fn timeout_success_no_packet_commitment(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        ..
+    } = fixture;
+    let ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a);
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation should succeed when no packet commitment is present"
+    )
+}
+
+#[rstest]
+fn timeout_unordered_channel_validate(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        chan_end_on_a_unordered,
+        conn_end_on_a,
+        packet_commitment,
+        client_height,
+        ..
+    } = fixture;
+
+    let packet = msg.packet.clone();
+
+    let mut ctx = ctx
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_packet_commitment(
+            packet.port_id_on_a,
+            packet.chan_id_on_a,
+            packet.seq_on_a,
+            packet_commitment,
+        );
+
+    ctx.get_client_execution_context()
+        .store_update_time(
+            ClientId::default(),
+            client_height,
+            Timestamp::from_nanoseconds(1000).unwrap(),
+        )
+        .unwrap();
+    ctx.get_client_execution_context()
+        .store_update_height(
+            ClientId::default(),
+            client_height,
+            Height::new(0, 5).unwrap(),
+        )
+        .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(res.is_ok(), "Good parameters for unordered channels")
+}
+
+#[rstest]
+fn timeout_ordered_channel_validate(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        router,
+        msg,
+        chan_end_on_a_ordered,
+        conn_end_on_a,
+        packet_commitment,
+        client_height,
+        ..
+    } = fixture;
+
+    let packet = msg.packet.clone();
+
+    let mut ctx = ctx
+        .with_client(&ClientId::default(), client_height)
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_ordered,
+        )
+        .with_packet_commitment(
+            packet.port_id_on_a,
+            packet.chan_id_on_a,
+            packet.seq_on_a,
+            packet_commitment,
+        );
+
+    ctx.store_update_time(
+        ClientId::default(),
+        client_height,
+        Timestamp::from_nanoseconds(1000).unwrap(),
+    )
+    .unwrap();
+    ctx.store_update_height(
+        ClientId::default(),
+        client_height,
+        Height::new(0, 4).unwrap(),
+    )
+    .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&ctx, &router, msg_envelope);
+
+    assert!(res.is_ok(), "Good parameters for unordered channels")
+}
+
+#[rstest]
+fn timeout_unordered_chan_execute(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        mut router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_unordered,
+        ..
+    } = fixture;
+    let mut ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_unordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok());
+
+    // Unordered channels only emit one event
+    assert_eq!(ctx.events.len(), 2);
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
+}
+
+#[rstest]
+fn timeout_ordered_chan_execute(fixture: Fixture) {
+    let Fixture {
+        ctx,
+        mut router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a_ordered,
+        ..
+    } = fixture;
+    let mut ctx = ctx
+        .with_channel(
+            PortId::transfer(),
+            ChannelId::default(),
+            chan_end_on_a_ordered,
+        )
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+
+    assert!(res.is_ok());
+
+    // Ordered channels emit 2 events
+    assert_eq!(ctx.events.len(), 4);
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
+    assert!(matches!(
+        ctx.events[2],
+        IbcEvent::Message(MessageEvent::Channel)
+    ));
+    assert!(matches!(ctx.events[3], IbcEvent::ChannelClosed(_)));
+}
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
new file mode 100644
index 000000000..8aa8d9e00
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -0,0 +1,173 @@
+use ibc::core::ics02_client::ClientExecutionContext;
+use ibc::core::ics03_connection::connection::{
+    ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
+};
+use ibc::core::ics03_connection::version::get_compatible_versions;
+use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
+use ibc::core::ics04_channel::msgs::PacketMsg;
+use ibc::core::ics04_channel::Version;
+use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
+use ibc::core::{validate, ExecutionContext, MsgEnvelope};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
+use rstest::*;
+
+pub struct Fixture {
+    pub context: MockContext,
+    pub router: MockRouter,
+    pub msg: MsgTimeoutOnClose,
+    pub packet_commitment: PacketCommitment,
+    pub conn_end_on_a: ConnectionEnd,
+    pub chan_end_on_a: ChannelEnd,
+}
+
+#[fixture]
+fn fixture() -> Fixture {
+    let client_height = Height::new(0, 2).unwrap();
+    let context = MockContext::default().with_client(&ClientId::default(), client_height);
+    let router = MockRouter::new_with_transfer();
+
+    let height = 2;
+    let timeout_timestamp = 5;
+
+    let msg =
+        MsgTimeoutOnClose::try_from(dummy_raw_msg_timeout_on_close(height, timeout_timestamp))
+            .unwrap();
+
+    let packet = msg.packet.clone();
+
+    let packet_commitment = compute_packet_commitment(
+        &msg.packet.data,
+        &msg.packet.timeout_height_on_b,
+        &msg.packet.timeout_timestamp_on_b,
+    );
+
+    let chan_end_on_a = ChannelEnd::new(
+        State::Open,
+        Order::Ordered,
+        Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
+        vec![ConnectionId::default()],
+        Version::new("ics20-1".to_string()),
+    )
+    .unwrap();
+
+    let conn_end_on_a = ConnectionEnd::new(
+        ConnectionState::Open,
+        ClientId::default(),
+        ConnectionCounterparty::new(
+            ClientId::default(),
+            Some(ConnectionId::default()),
+            Default::default(),
+        ),
+        get_compatible_versions(),
+        ZERO_DURATION,
+    )
+    .unwrap();
+
+    Fixture {
+        context,
+        router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a,
+    }
+}
+
+#[rstest]
+fn timeout_on_close_fail_no_channel(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        ..
+    } = fixture;
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_err(),
+        "Validation fails because no channel exists in the context"
+    )
+}
+
+/// NO-OP case
+#[rstest]
+fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        conn_end_on_a,
+        chan_end_on_a,
+        ..
+    } = fixture;
+    let context = context
+        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
+        .with_connection(ConnectionId::default(), conn_end_on_a);
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Validation should succeed when no packet commitment is present"
+    )
+}
+
+#[rstest]
+fn timeout_on_close_success_happy_path(fixture: Fixture) {
+    let Fixture {
+        context,
+        router,
+        msg,
+        packet_commitment,
+        conn_end_on_a,
+        chan_end_on_a,
+        ..
+    } = fixture;
+    let mut context = context
+        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
+        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_packet_commitment(
+            msg.packet.port_id_on_a.clone(),
+            msg.packet.chan_id_on_a.clone(),
+            msg.packet.seq_on_a,
+            packet_commitment,
+        );
+
+    context
+        .get_client_execution_context()
+        .store_update_time(
+            ClientId::default(),
+            Height::new(0, 2).unwrap(),
+            Timestamp::from_nanoseconds(5000).unwrap(),
+        )
+        .unwrap();
+    context
+        .get_client_execution_context()
+        .store_update_height(
+            ClientId::default(),
+            Height::new(0, 2).unwrap(),
+            Height::new(0, 5).unwrap(),
+        )
+        .unwrap();
+
+    let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
+
+    let res = validate(&context, &router, msg_envelope);
+
+    assert!(
+        res.is_ok(),
+        "Happy path: validation should succeed. err: {res:?}"
+    )
+}
diff --git a/crates/ibc-testkit/tests/core/mod.rs b/crates/ibc-testkit/tests/core/mod.rs
new file mode 100644
index 000000000..97dce615a
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/mod.rs
@@ -0,0 +1,4 @@
+pub mod ics02_client;
+pub mod ics03_connection;
+pub mod ics04_channel;
+pub mod router;
diff --git a/crates/ibc-testkit/tests/core/router.rs b/crates/ibc-testkit/tests/core/router.rs
new file mode 100644
index 000000000..94a5a0c2a
--- /dev/null
+++ b/crates/ibc-testkit/tests/core/router.rs
@@ -0,0 +1,447 @@
+use ibc::applications::transfer::error::TokenTransferError;
+use ibc::applications::transfer::msgs::transfer::MsgTransfer;
+use ibc::applications::transfer::{send_transfer, BaseCoin};
+use ibc::core::events::{IbcEvent, MessageEvent};
+use ibc::core::ics02_client::msgs::create_client::MsgCreateClient;
+use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
+use ibc::core::ics02_client::msgs::ClientMsg;
+use ibc::core::ics03_connection::msgs::ConnectionMsg;
+use ibc::core::ics04_channel::error::ChannelError;
+use ibc::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
+use ibc::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
+use ibc::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
+use ibc::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
+use ibc::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
+use ibc::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
+use ibc::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
+use ibc::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
+use ibc::core::ics04_channel::msgs::{ChannelMsg, PacketMsg};
+use ibc::core::ics04_channel::timeout::TimeoutHeight;
+use ibc::core::ics24_host::identifier::ConnectionId;
+use ibc::core::ics24_host::path::CommitmentPath;
+use ibc::core::timestamp::Timestamp;
+use ibc::core::{dispatch, MsgEnvelope, RouterError, ValidationContext};
+use ibc::prelude::*;
+use ibc::Height;
+use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::MockClientState;
+use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::utils::applications::transfer::{
+    extract_transfer_packet, MsgTransferConfig, PacketDataConfig,
+};
+use ibc_testkit::utils::core::channel::{
+    dummy_raw_msg_ack_with_packet, dummy_raw_msg_chan_close_confirm, dummy_raw_msg_chan_close_init,
+    dummy_raw_msg_chan_open_ack, dummy_raw_msg_chan_open_init, dummy_raw_msg_chan_open_try,
+    dummy_raw_msg_recv_packet, dummy_raw_msg_timeout_on_close,
+};
+use ibc_testkit::utils::core::client::dummy_msg_upgrade_client;
+use ibc_testkit::utils::core::connection::{
+    dummy_msg_conn_open_ack, dummy_msg_conn_open_init, dummy_msg_conn_open_init_with_client_id,
+    dummy_msg_conn_open_try, msg_conn_open_try_with_client_id,
+};
+use ibc_testkit::utils::core::signer::dummy_account_id;
+use primitive_types::U256;
+use test_log::test;
+
+#[test]
+/// These tests exercise two main paths: (1) the ability of the ICS26 routing module to dispatch
+/// messages to the correct module handler, and more importantly: (2) the ability of ICS handlers
+/// to work with the context and correctly store results.
+fn routing_module_and_keepers() {
+    #[derive(Clone, Debug)]
+    enum TestMsg {
+        Ics26(MsgEnvelope),
+        Ics20(MsgTransfer),
+    }
+
+    impl From<MsgEnvelope> for TestMsg {
+        fn from(msg: MsgEnvelope) -> Self {
+            Self::Ics26(msg)
+        }
+    }
+
+    impl From<MsgTransfer> for TestMsg {
+        fn from(msg: MsgTransfer) -> Self {
+            Self::Ics20(msg)
+        }
+    }
+
+    type StateCheckFn = dyn FnOnce(&MockContext) -> bool;
+
+    // Test parameters
+    struct Test {
+        name: String,
+        msg: TestMsg,
+        want_pass: bool,
+        state_check: Option<Box<StateCheckFn>>,
+    }
+    let default_signer = dummy_account_id();
+    let client_height = 5;
+    let start_client_height = Height::new(0, client_height).unwrap();
+    let update_client_height = Height::new(0, 34).unwrap();
+    let update_client_height_after_send = Height::new(0, 35).unwrap();
+
+    let update_client_height_after_second_send = Height::new(0, 36).unwrap();
+
+    let upgrade_client_height = Height::new(1, 2).unwrap();
+
+    let upgrade_client_height_second = Height::new(1, 1).unwrap();
+
+    // We reuse this same context across all tests. Nothing in particular needs parametrizing.
+    let mut ctx = MockContext::default();
+
+    let mut router = MockRouter::new_with_transfer();
+
+    let create_client_msg = MsgCreateClient::new(
+        MockClientState::new(MockHeader::new(start_client_height).with_current_timestamp()).into(),
+        MockConsensusState::new(MockHeader::new(start_client_height).with_current_timestamp())
+            .into(),
+        default_signer.clone(),
+    );
+
+    //
+    // Connection handshake messages.
+    //
+    let msg_conn_init = dummy_msg_conn_open_init();
+
+    let correct_msg_conn_try = dummy_msg_conn_open_try(client_height, client_height);
+
+    // The handler will fail to process this msg because the client height is too advanced.
+    let incorrect_msg_conn_try = dummy_msg_conn_open_try(client_height + 1, client_height + 1);
+
+    let msg_conn_ack = dummy_msg_conn_open_ack(client_height, client_height);
+
+    //
+    // Channel handshake messages.
+    //
+    let msg_chan_init = MsgChannelOpenInit::try_from(dummy_raw_msg_chan_open_init(None)).unwrap();
+
+    // The handler will fail to process this b/c the associated connection does not exist
+    let mut incorrect_msg_chan_init = msg_chan_init.clone();
+    incorrect_msg_chan_init.connection_hops_on_a = vec![ConnectionId::new(590)];
+
+    let msg_chan_try =
+        MsgChannelOpenTry::try_from(dummy_raw_msg_chan_open_try(client_height)).unwrap();
+
+    let msg_chan_ack =
+        MsgChannelOpenAck::try_from(dummy_raw_msg_chan_open_ack(client_height)).unwrap();
+
+    let msg_chan_close_init =
+        MsgChannelCloseInit::try_from(dummy_raw_msg_chan_close_init()).unwrap();
+
+    let msg_chan_close_confirm =
+        MsgChannelCloseConfirm::try_from(dummy_raw_msg_chan_close_confirm(client_height)).unwrap();
+
+    let packet_data = PacketDataConfig::builder()
+        .token(
+            BaseCoin {
+                denom: "uatom".parse().expect("parse denom"),
+                amount: U256::from(10).into(),
+            }
+            .into(),
+        )
+        .build();
+
+    let msg_transfer = MsgTransferConfig::builder()
+        .packet_data(packet_data.clone())
+        .timeout_height_on_b(TimeoutHeight::At(Height::new(0, 35).unwrap()))
+        .build();
+
+    let msg_transfer_two = MsgTransferConfig::builder()
+        .packet_data(packet_data.clone())
+        .timeout_height_on_b(TimeoutHeight::At(Height::new(0, 36).unwrap()))
+        .build();
+
+    let msg_transfer_no_timeout = MsgTransferConfig::builder()
+        .packet_data(packet_data.clone())
+        .build();
+
+    let msg_transfer_no_timeout_or_timestamp = MsgTransferConfig::builder()
+        .packet_data(packet_data.clone())
+        .timeout_timestamp_on_b(Timestamp::from_nanoseconds(0).unwrap())
+        .build();
+
+    let mut msg_to_on_close =
+        MsgTimeoutOnClose::try_from(dummy_raw_msg_timeout_on_close(36, 5)).unwrap();
+    msg_to_on_close.packet.seq_on_a = 2.into();
+    msg_to_on_close.packet.timeout_height_on_b = msg_transfer_two.timeout_height_on_b;
+    msg_to_on_close.packet.timeout_timestamp_on_b = msg_transfer_two.timeout_timestamp_on_b;
+
+    let packet_data = serde_json::to_vec(&msg_transfer_two.packet_data)
+        .expect("PacketData's infallible Serialize impl failed");
+
+    msg_to_on_close.packet.data = packet_data;
+
+    let msg_recv_packet = MsgRecvPacket::try_from(dummy_raw_msg_recv_packet(35)).unwrap();
+    let msg_ack_packet = MsgAcknowledgement::try_from(dummy_raw_msg_ack_with_packet(
+        extract_transfer_packet(&msg_transfer, 1u64.into()).into(),
+        35,
+    ))
+    .unwrap();
+
+    // First, create a client..
+    let res = dispatch(
+        &mut ctx,
+        &mut router,
+        MsgEnvelope::Client(ClientMsg::CreateClient(create_client_msg.clone())),
+    );
+
+    assert!(
+            res.is_ok(),
+            "ICS26 routing dispatch test 'client creation' failed for message {create_client_msg:?} with result: {res:?}",
+        );
+
+    // Figure out the ID of the client that was just created.
+    assert!(matches!(
+        ctx.events[0],
+        IbcEvent::Message(MessageEvent::Client)
+    ));
+    let client_id_event = ctx.events.get(1);
+    assert!(
+        client_id_event.is_some(),
+        "There was no event generated for client creation!"
+    );
+    let client_id = match client_id_event.unwrap() {
+        IbcEvent::CreateClient(create_client) => create_client.client_id().clone(),
+        event => panic!("unexpected IBC event: {:?}", event),
+    };
+
+    let tests: Vec<Test> = vec![
+        // Test some ICS2 client functionality.
+        Test {
+            name: "Client update successful".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
+                client_id: client_id.clone(),
+                client_message: MockHeader::new(update_client_height)
+                    .with_current_timestamp()
+                    .into(),
+                signer: default_signer.clone(),
+            }))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Client update fails due to stale header".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
+                client_id: client_id.clone(),
+                client_message: MockHeader::new(update_client_height).into(),
+                signer: default_signer.clone(),
+            }))
+            .into(),
+            want_pass: false,
+            state_check: None,
+        },
+        Test {
+            name: "Connection open init succeeds".to_string(),
+            msg: MsgEnvelope::Connection(ConnectionMsg::OpenInit(
+                dummy_msg_conn_open_init_with_client_id(msg_conn_init, client_id.clone()),
+            ))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Connection open try fails due to InvalidConsensusHeight (too high)".to_string(),
+            msg: MsgEnvelope::Connection(ConnectionMsg::OpenTry(incorrect_msg_conn_try)).into(),
+            want_pass: false,
+            state_check: None,
+        },
+        Test {
+            name: "Connection open try succeeds".to_string(),
+            msg: MsgEnvelope::Connection(ConnectionMsg::OpenTry(msg_conn_open_try_with_client_id(
+                correct_msg_conn_try,
+                client_id.clone(),
+            )))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Connection open ack succeeds".to_string(),
+            msg: MsgEnvelope::Connection(ConnectionMsg::OpenAck(msg_conn_ack)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        // ICS04
+        Test {
+            name: "Channel open init succeeds".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::OpenInit(msg_chan_init)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Channel open init fail due to missing connection".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::OpenInit(incorrect_msg_chan_init)).into(),
+            want_pass: false,
+            state_check: None,
+        },
+        Test {
+            name: "Channel open try succeeds".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::OpenTry(msg_chan_try)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Channel open ack succeeds".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::OpenAck(msg_chan_ack)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Packet send".to_string(),
+            msg: msg_transfer.into(),
+            want_pass: true,
+            state_check: None,
+        },
+        // The client update is required in this test, because the proof associated with
+        // msg_recv_packet has the same height as the packet TO height (see get_dummy_raw_msg_recv_packet)
+        Test {
+            name: "Client update successful #2".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
+                client_id: client_id.clone(),
+                client_message: MockHeader::new(update_client_height_after_send)
+                    .with_current_timestamp()
+                    .into(),
+                signer: default_signer.clone(),
+            }))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Receive packet".to_string(),
+            msg: MsgEnvelope::Packet(PacketMsg::Recv(msg_recv_packet.clone())).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Re-Receive packet".to_string(),
+            msg: MsgEnvelope::Packet(PacketMsg::Recv(msg_recv_packet)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        // Ack packet
+        Test {
+            name: "Ack packet".to_string(),
+            msg: MsgEnvelope::Packet(PacketMsg::Ack(msg_ack_packet.clone())).into(),
+            want_pass: true,
+            state_check: Some(Box::new(move |ctx| {
+                ctx.get_packet_commitment(&CommitmentPath::new(
+                    &msg_ack_packet.packet.port_id_on_a,
+                    &msg_ack_packet.packet.chan_id_on_a,
+                    msg_ack_packet.packet.seq_on_a,
+                ))
+                .is_err()
+            })),
+        },
+        Test {
+            name: "Packet send".to_string(),
+            msg: msg_transfer_two.into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Client update successful".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
+                client_id: client_id.clone(),
+                client_message: MockHeader::new(update_client_height_after_second_send)
+                    .with_current_timestamp()
+                    .into(),
+                signer: default_signer,
+            }))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        // Timeout packets
+        Test {
+            name: "Transfer message no timeout".to_string(),
+            msg: msg_transfer_no_timeout.into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Transfer message no timeout nor timestamp".to_string(),
+            msg: msg_transfer_no_timeout_or_timestamp.into(),
+            want_pass: true,
+            state_check: None,
+        },
+        //ICS04-close channel
+        Test {
+            name: "Channel close init succeeds".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::CloseInit(msg_chan_close_init)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Channel close confirm fails cause channel is already closed".to_string(),
+            msg: MsgEnvelope::Channel(ChannelMsg::CloseConfirm(msg_chan_close_confirm)).into(),
+            want_pass: false,
+            state_check: None,
+        },
+        //ICS04-to_on_close
+        Test {
+            name: "Timeout on close".to_string(),
+            msg: MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(msg_to_on_close)).into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Client upgrade successful".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpgradeClient(dummy_msg_upgrade_client(
+                client_id.clone(),
+                upgrade_client_height,
+            )))
+            .into(),
+            want_pass: true,
+            state_check: None,
+        },
+        Test {
+            name: "Client upgrade un-successful".to_string(),
+            msg: MsgEnvelope::Client(ClientMsg::UpgradeClient(dummy_msg_upgrade_client(
+                client_id,
+                upgrade_client_height_second,
+            )))
+            .into(),
+            want_pass: false,
+            state_check: None,
+        },
+    ]
+    .into_iter()
+    .collect();
+
+    for test in tests {
+        let res = match test.msg.clone() {
+            TestMsg::Ics26(msg) => dispatch(&mut ctx, &mut router, msg).map(|_| ()),
+            TestMsg::Ics20(msg) => send_transfer(&mut ctx, &mut DummyTransferModule, msg)
+                .map_err(|e: TokenTransferError| ChannelError::AppModule {
+                    description: e.to_string(),
+                })
+                .map_err(|e| RouterError::ContextError(e.into())),
+        };
+
+        assert_eq!(
+            test.want_pass,
+            res.is_ok(),
+            "ICS26 routing dispatch test '{}' failed for message {:?}\nwith result: {:?}",
+            test.name,
+            test.msg,
+            res
+        );
+
+        if let Some(state_check) = test.state_check {
+            assert_eq!(
+                test.want_pass,
+                state_check(&ctx),
+                "ICS26 routing state check '{}' failed for message {:?}\nwith result: {:?}",
+                test.name,
+                test.msg,
+                res
+            );
+        }
+    }
+}
diff --git a/crates/ibc/tests/support/query/serialization/client_state.json b/crates/ibc-testkit/tests/data/json/client_state.json
similarity index 100%
rename from crates/ibc/tests/support/query/serialization/client_state.json
rename to crates/ibc-testkit/tests/data/json/client_state.json
diff --git a/crates/ibc/tests/support/query/serialization/client_state_proof.json b/crates/ibc-testkit/tests/data/json/client_state_proof.json
similarity index 100%
rename from crates/ibc/tests/support/query/serialization/client_state_proof.json
rename to crates/ibc-testkit/tests/data/json/client_state_proof.json
diff --git a/crates/ibc/tests/support/query/serialization/consensus_state.json b/crates/ibc-testkit/tests/data/json/consensus_state.json
similarity index 100%
rename from crates/ibc/tests/support/query/serialization/consensus_state.json
rename to crates/ibc-testkit/tests/data/json/consensus_state.json
diff --git a/crates/ibc/tests/support/query/serialization/consensus_state_proof.json b/crates/ibc-testkit/tests/data/json/consensus_state_proof.json
similarity index 100%
rename from crates/ibc/tests/support/query/serialization/consensus_state_proof.json
rename to crates/ibc-testkit/tests/data/json/consensus_state_proof.json
diff --git a/crates/ibc/tests/support/signed_header.json b/crates/ibc-testkit/tests/data/json/signed_header.json
similarity index 100%
rename from crates/ibc/tests/support/signed_header.json
rename to crates/ibc-testkit/tests/data/json/signed_header.json
diff --git a/crates/ibc-testkit/tests/mod.rs b/crates/ibc-testkit/tests/mod.rs
new file mode 100644
index 000000000..1f32c1d98
--- /dev/null
+++ b/crates/ibc-testkit/tests/mod.rs
@@ -0,0 +1,10 @@
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+pub mod applications;
+pub mod core;
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 1528e4008..52238ed20 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -22,14 +22,12 @@ std = [
     "ibc-proto/std",
     "ics23/std",
     "serde/std",
-    "tracing/std",
     "prost/std",
     "bytes/std",
     "subtle-encoding/std",
     "serde_json/std",
     "sha2/std",
     "displaydoc/std",
-    "num-traits/std",
     "uint/std",
     "primitive-types/std",
     "tendermint/clock",
@@ -44,10 +42,6 @@ serde = ["dep:serde", "dep:serde_derive", "serde_json", "ibc-proto/serde", "ics2
 # CosmWasm message API generator compatible, should not be inside on chain code
 schema = ["dep:schemars", "ibc-proto/json-schema", "serde", "std"]
 
-# This feature grants access to development-time mocking libraries, such as `MockContext` or `MockHeader`.
-# Depends on the `testgen` suite for generating Tendermint light blocks.
-mocks = ["tendermint-testgen", "parking_lot", "typed-builder", "std"]
-
 [dependencies]
 # Proto definitions for all IBC-related interfaces, e.g., connections or channels.
 ibc-proto = { version = "0.38.0", default-features = false }
@@ -56,13 +50,11 @@ time = { version = ">=0.3.0, <0.3.31", default-features = false }
 serde_derive = { version = "1.0", default-features = false, optional = true }
 serde = { version = "1.0", default-features = false, optional = true }
 serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false, optional = true}
-tracing = { version = "0.1.40", default-features = false }
 prost = { version = "0.12", default-features = false }
 bytes = { version = "1.5.0", default-features = false }
 subtle-encoding = { version = "0.5", default-features = false }
 sha2 = { version = "0.10.8", default-features = false }
 displaydoc = { version = "0.2", default-features = false }
-num-traits = { version = "0.2.17", default-features = false }
 derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
 uint = { version = "0.9", default-features = false }
 primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
@@ -72,10 +64,9 @@ parity-scale-codec = { version = "3.6.5", default-features = false, features = [
 scale-info = { version = "2.10.0", default-features = false, features = ["derive"], optional = true }
 ## for borsh encode or decode
 borsh = {version = "0.10", default-features = false, optional = true }
-parking_lot = { version = "0.12.1", default-features = false, optional = true }
 typed-builder = { version = "0.18.0", optional = true }
 
-ibc-derive = { version ="0.3.0", path = "../ibc-derive" }
+ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
 
 schemars = { version = "0.8.15", optional = true }
 
@@ -92,15 +83,10 @@ version = "0.34"
 default-features = false
 features = ["rust-crypto"]
 
-[dependencies.tendermint-testgen]
-version = "0.34"
-optional = true
-default-features = false
-
 [dev-dependencies]
+ibc-testkit = { version = "0.47.0", path = "../ibc-testkit", default-features = false, features = ["serde"] }
 env_logger = "0.10.0"
 rstest = "0.18.2"
 tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"]}
 test-log = { version = "0.2.13", features = ["trace"] }
 tendermint-rpc = { version = "0.34", features = ["http-client", "websocket-client"] }
-ibc = { path = ".", features = ["mocks"] }
diff --git a/crates/ibc/clippy.toml b/crates/ibc/clippy.toml
index af3114623..87ee0dae3 100644
--- a/crates/ibc/clippy.toml
+++ b/crates/ibc/clippy.toml
@@ -2,7 +2,6 @@ disallowed-types = [
     # { path = "usize", reason = "variable size" }, # cannot on now, because mocks use it and serde, even if there is no usize in type
     { path = "f64", reason = "not supported in CosmWasm" },
     { path = "f32", reason = "not supported in CosmWasm" },
-    { path = "num_traits::float::*", reason = "harware dependant" },
 ]
 
 disallowed-methods = [
diff --git a/crates/ibc/src/applications/transfer/context.rs b/crates/ibc/src/applications/transfer/context.rs
index 81b4030af..33d080f30 100644
--- a/crates/ibc/src/applications/transfer/context.rs
+++ b/crates/ibc/src/applications/transfer/context.rs
@@ -411,39 +411,11 @@ pub fn on_timeout_packet_execute(
 }
 
 #[cfg(test)]
-pub(crate) mod test {
+mod tests {
     use subtle_encoding::bech32;
 
     use super::*;
     use crate::applications::transfer::context::cosmos_adr028_escrow_address;
-    use crate::core::ics04_channel::channel::{Counterparty, Order};
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-    use crate::test_utils::DummyTransferModule;
-
-    fn get_defaults() -> (
-        DummyTransferModule,
-        Order,
-        Vec<ConnectionId>,
-        PortId,
-        ChannelId,
-        Counterparty,
-    ) {
-        let order = Order::Unordered;
-        let connection_hops = vec![ConnectionId::new(1)];
-        let port_id = PortId::transfer();
-        let channel_id = ChannelId::new(1);
-        let counterparty = Counterparty::new(port_id.clone(), Some(channel_id.clone()));
-
-        (
-            DummyTransferModule,
-            order,
-            connection_hops,
-            port_id,
-            channel_id,
-            counterparty,
-        )
-    }
 
     #[test]
     fn test_cosmos_escrow_address() {
@@ -474,106 +446,4 @@ pub(crate) mod test {
             "cosmos177x69sver58mcfs74x6dg0tv6ls4s3xmmcaw53",
         );
     }
-
-    /// If the relayer passed "", indicating that it wants us to return the versions we support.
-    /// We currently only support ics20
-    #[test]
-    fn test_on_chan_open_init_empty_version() {
-        let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
-
-        let in_version = Version::new("".to_string());
-
-        let (_, out_version) = on_chan_open_init_execute(
-            &mut ctx,
-            order,
-            &connection_hops,
-            &port_id,
-            &channel_id,
-            &counterparty,
-            &in_version,
-        )
-        .unwrap();
-
-        assert_eq!(out_version, Version::new(VERSION.to_string()));
-    }
-
-    /// If the relayer passed in the only supported version (ics20), then return ics20
-    #[test]
-    fn test_on_chan_open_init_ics20_version() {
-        let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
-
-        let in_version = Version::new(VERSION.to_string());
-        let (_, out_version) = on_chan_open_init_execute(
-            &mut ctx,
-            order,
-            &connection_hops,
-            &port_id,
-            &channel_id,
-            &counterparty,
-            &in_version,
-        )
-        .unwrap();
-
-        assert_eq!(out_version, Version::new(VERSION.to_string()));
-    }
-
-    /// If the relayer passed in an unsupported version, then fail
-    #[test]
-    fn test_on_chan_open_init_incorrect_version() {
-        let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
-
-        let in_version = Version::new("some-unsupported-version".to_string());
-        let res = on_chan_open_init_validate(
-            &ctx,
-            order,
-            &connection_hops,
-            &port_id,
-            &channel_id,
-            &counterparty,
-            &in_version,
-        );
-
-        assert!(res.is_err());
-    }
-
-    /// If the counterparty supports ics20, then return ics20
-    #[test]
-    fn test_on_chan_open_try_counterparty_correct_version() {
-        let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
-
-        let counterparty_version = Version::new(VERSION.to_string());
-
-        let (_, out_version) = on_chan_open_try_execute(
-            &mut ctx,
-            order,
-            &connection_hops,
-            &port_id,
-            &channel_id,
-            &counterparty,
-            &counterparty_version,
-        )
-        .unwrap();
-
-        assert_eq!(out_version, Version::new(VERSION.to_string()));
-    }
-
-    /// If the counterparty doesn't support ics20, then fail
-    #[test]
-    fn test_on_chan_open_try_counterparty_incorrect_version() {
-        let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
-
-        let counterparty_version = Version::new("some-unsupported-version".to_string());
-
-        let res = on_chan_open_try_validate(
-            &ctx,
-            order,
-            &connection_hops,
-            &port_id,
-            &channel_id,
-            &counterparty,
-            &counterparty_version,
-        );
-
-        assert!(res.is_err());
-    }
 }
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index 026e38b3f..44a8406a6 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -125,49 +125,3 @@ impl TryFrom<Any> for MsgTransfer {
         }
     }
 }
-
-#[cfg(test)]
-pub mod test_util {
-    use core::ops::Add;
-    use core::time::Duration;
-
-    use super::{MsgTransfer, *};
-    use crate::applications::transfer::packet::PacketData;
-    use crate::core::ics04_channel::packet::{Packet, Sequence};
-    use crate::core::ics04_channel::timeout::TimeoutHeight;
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-
-    impl MsgTransfer {
-        // Returns a dummy ICS20 `MsgTransfer`. If no `timeout_timestamp` is
-        // specified, a timestamp of 10 seconds in the future is used.
-        pub fn new_dummy(
-            timeout_height: TimeoutHeight,
-            timeout_timestamp: Option<Timestamp>,
-        ) -> Self {
-            Self {
-                port_id_on_a: PortId::default(),
-                chan_id_on_a: ChannelId::default(),
-                packet_data: PacketData::new_dummy(),
-                timeout_timestamp_on_b: timeout_timestamp
-                    .unwrap_or_else(|| Timestamp::now().add(Duration::from_secs(10)).unwrap()),
-                timeout_height_on_b: timeout_height,
-            }
-        }
-
-        pub fn get_transfer_packet(&self, sequence: Sequence) -> Packet {
-            let data = serde_json::to_vec(&self.packet_data)
-                .expect("PacketData's infallible Serialize impl failed");
-
-            Packet {
-                seq_on_a: sequence,
-                port_id_on_a: self.port_id_on_a.clone(),
-                chan_id_on_a: self.chan_id_on_a.clone(),
-                port_id_on_b: PortId::default(),
-                chan_id_on_b: ChannelId::default(),
-                data,
-                timeout_height_on_b: self.timeout_height_on_b,
-                timeout_timestamp_on_b: self.timeout_timestamp_on_b,
-            }
-        }
-    }
-}
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/crates/ibc/src/applications/transfer/packet.rs
index 758af8439..63058b2ed 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/crates/ibc/src/applications/transfer/packet.rs
@@ -65,16 +65,15 @@ impl From<PacketData> for RawPacketData {
 
 #[cfg(test)]
 mod tests {
-
+    use ibc_testkit::utils::core::signer::dummy_bech32_account;
     use primitive_types::U256;
 
     use super::*;
     use crate::applications::transfer::BaseCoin;
-    use crate::test_utils::get_dummy_bech32_account;
 
     impl PacketData {
         pub fn new_dummy() -> Self {
-            let address: Signer = get_dummy_bech32_account().into();
+            let address: Signer = dummy_bech32_account().into();
 
             Self {
                 token: BaseCoin {
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
index a4ff405fb..d7ada244f 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/client_state.rs
@@ -792,23 +792,96 @@ fn check_header_trusted_next_validator_set(
     }
 }
 
+#[cfg(all(test, feature = "serde"))]
+mod serde_tests {
+    use tendermint_rpc::endpoint::abci_query::AbciQuery;
+
+    use crate::serializers::tests::test_serialization_roundtrip;
+    #[test]
+    fn serialization_roundtrip_no_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/../ibc-testkit/tests/data/json/client_state.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+
+    #[test]
+    fn serialization_roundtrip_with_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/../ibc-testkit/tests/data/json/client_state_proof.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+}
+
 #[cfg(test)]
 mod tests {
+    use core::str::FromStr;
     use core::time::Duration;
 
     use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
     use ibc_proto::ics23::ProofSpec as Ics23ProofSpec;
+    use ibc_testkit::utils::clients::tendermint::dummy_tendermint_header;
+    use tendermint::block::Header;
     use test_log::test;
 
     use super::*;
-    use crate::clients::ics07_tendermint::client_state::AllowUpdate;
+    use crate::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
     use crate::clients::ics07_tendermint::error::Error;
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
+    use crate::core::ics02_client::height::Height;
     use crate::core::ics23_commitment::specs::ProofSpecs;
     use crate::core::ics24_host::identifier::ChainId;
     use crate::core::timestamp::ZERO_DURATION;
-    use crate::Height;
+
+    impl ClientState {
+        pub fn new_dummy_from_raw(frozen_height: RawHeight) -> Result<Self, Error> {
+            Self::try_from(get_dummy_raw_tm_client_state(frozen_height))
+        }
+
+        pub fn new_dummy_from_header(tm_header: Header) -> Self {
+            let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
+            Self::new(
+                chain_id.clone(),
+                Default::default(),
+                Duration::from_secs(64000),
+                Duration::from_secs(128000),
+                Duration::from_millis(3000),
+                Height::new(chain_id.revision_number(), u64::from(tm_header.height))
+                    .expect("Never fails"),
+                Default::default(),
+                Default::default(),
+                AllowUpdate {
+                    after_expiry: false,
+                    after_misbehaviour: false,
+                },
+            )
+            .expect("Never fails")
+        }
+    }
+
+    pub fn get_dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
+        #[allow(deprecated)]
+        RawTmClientState {
+            chain_id: ChainId::new("ibc-0").expect("Never fails").to_string(),
+            trust_level: Some(Fraction {
+                numerator: 1,
+                denominator: 3,
+            }),
+            trusting_period: Some(Duration::from_secs(64000).into()),
+            unbonding_period: Some(Duration::from_secs(128000).into()),
+            max_clock_drift: Some(Duration::from_millis(3000).into()),
+            latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
+            proof_specs: ProofSpecs::default().into(),
+            upgrade_path: Default::default(),
+            frozen_height: Some(frozen_height),
+            allow_update_after_expiry: false,
+            allow_update_after_misbehaviour: false,
+        }
+    }
 
     #[derive(Clone, Debug, PartialEq)]
     struct ClientStateParams {
@@ -1083,7 +1156,7 @@ mod tests {
         );
 
         // check client state creation path from a tendermint header
-        let tm_header = get_dummy_tendermint_header();
+        let tm_header = dummy_tendermint_header();
         let tm_client_state_from_header = ClientState::new_dummy_from_header(tm_header);
         let any_from_header = Any::from(tm_client_state_from_header.clone());
         let tm_client_state_from_any = ClientState::try_from(any_from_header);
@@ -1106,125 +1179,3 @@ mod tests {
         }
     }
 }
-
-#[cfg(all(test, feature = "serde"))]
-mod serde_tests {
-    use tendermint_rpc::endpoint::abci_query::AbciQuery;
-
-    use crate::serializers::tests::test_serialization_roundtrip;
-    #[test]
-    fn serialization_roundtrip_no_proof() {
-        let json_data =
-            include_str!("../../../tests/support/query/serialization/client_state.json");
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-
-    #[test]
-    fn serialization_roundtrip_with_proof() {
-        let json_data =
-            include_str!("../../../tests/support/query/serialization/client_state_proof.json");
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-}
-
-#[cfg(any(test, feature = "mocks"))]
-pub mod test_util {
-    use core::str::FromStr;
-    use core::time::Duration;
-
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
-    use tendermint::block::Header;
-
-    use crate::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
-    use crate::clients::ics07_tendermint::error::{Error as ClientError, Error};
-    use crate::clients::ics07_tendermint::trust_threshold::TrustThreshold;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics23_commitment::specs::ProofSpecs;
-    use crate::core::ics24_host::identifier::ChainId;
-    use crate::prelude::*;
-
-    impl ClientState {
-        pub fn new_dummy_from_raw(frozen_height: RawHeight) -> Result<Self, Error> {
-            Self::try_from(get_dummy_raw_tm_client_state(frozen_height))
-        }
-
-        pub fn new_dummy_from_header(tm_header: Header) -> Self {
-            let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
-            Self::new(
-                chain_id.clone(),
-                Default::default(),
-                Duration::from_secs(64000),
-                Duration::from_secs(128000),
-                Duration::from_millis(3000),
-                Height::new(chain_id.revision_number(), u64::from(tm_header.height))
-                    .expect("Never fails"),
-                Default::default(),
-                Default::default(),
-                AllowUpdate {
-                    after_expiry: false,
-                    after_misbehaviour: false,
-                },
-            )
-            .expect("Never fails")
-        }
-    }
-
-    pub fn get_dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
-        #[allow(deprecated)]
-        RawTmClientState {
-            chain_id: ChainId::new("ibc-0").expect("Never fails").to_string(),
-            trust_level: Some(Fraction {
-                numerator: 1,
-                denominator: 3,
-            }),
-            trusting_period: Some(Duration::from_secs(64000).into()),
-            unbonding_period: Some(Duration::from_secs(128000).into()),
-            max_clock_drift: Some(Duration::from_millis(3000).into()),
-            latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
-            proof_specs: ProofSpecs::default().into(),
-            upgrade_path: Default::default(),
-            frozen_height: Some(frozen_height),
-            allow_update_after_expiry: false,
-            allow_update_after_misbehaviour: false,
-        }
-    }
-
-    #[derive(typed_builder::TypedBuilder, Debug)]
-    pub struct ClientStateConfig {
-        pub chain_id: ChainId,
-        #[builder(default)]
-        pub trust_level: TrustThreshold,
-        #[builder(default = Duration::from_secs(64000))]
-        pub trusting_period: Duration,
-        #[builder(default = Duration::from_secs(128000))]
-        pub unbonding_period: Duration,
-        #[builder(default = Duration::from_millis(3000))]
-        max_clock_drift: Duration,
-        pub latest_height: Height,
-        #[builder(default)]
-        pub proof_specs: ProofSpecs,
-        #[builder(default)]
-        pub upgrade_path: Vec<String>,
-        #[builder(default = AllowUpdate { after_expiry: false, after_misbehaviour: false })]
-        allow_update: AllowUpdate,
-    }
-
-    impl TryFrom<ClientStateConfig> for ClientState {
-        type Error = ClientError;
-
-        fn try_from(config: ClientStateConfig) -> Result<Self, Self::Error> {
-            ClientState::new(
-                config.chain_id,
-                config.trust_level,
-                config.trusting_period,
-                config.unbonding_period,
-                config.max_clock_drift,
-                config.latest_height,
-                config.proof_specs,
-                config.upgrade_path,
-                config.allow_update,
-            )
-        }
-    }
-}
diff --git a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
index 14cd0b81b..f00a70b8c 100644
--- a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
@@ -161,8 +161,7 @@ impl ConsensusStateTrait for ConsensusState {
     }
 }
 
-#[cfg(test)]
-#[cfg(feature = "serde")]
+#[cfg(all(test, feature = "serde"))]
 mod tests {
     use tendermint_rpc::endpoint::abci_query::AbciQuery;
     use test_log::test;
@@ -171,15 +170,19 @@ mod tests {
 
     #[test]
     fn serialization_roundtrip_no_proof() {
-        let json_data =
-            include_str!("../../../tests/support/query/serialization/consensus_state.json");
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/../ibc-testkit/tests/data/json/consensus_state.json"
+        ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
 
     #[test]
     fn serialization_roundtrip_with_proof() {
-        let json_data =
-            include_str!("../../../tests/support/query/serialization/consensus_state_proof.json");
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/../ibc-testkit/tests/data/json/consensus_state_proof.json"
+        ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
 }
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/crates/ibc/src/clients/ics07_tendermint/header.rs
index f73b79d36..cb1f56c4f 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/header.rs
@@ -23,7 +23,7 @@ use crate::core::timestamp::Timestamp;
 use crate::prelude::*;
 use crate::Height;
 
-pub(crate) const TENDERMINT_HEADER_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Header";
+pub const TENDERMINT_HEADER_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Header";
 
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 /// Tendermint consensus header
@@ -248,85 +248,3 @@ mod pretty {
         }
     }
 }
-
-#[cfg(any(test, feature = "mocks"))]
-pub mod test_util {
-    use alloc::vec;
-
-    use subtle_encoding::hex;
-    use tendermint::block::signed_header::SignedHeader;
-    use tendermint::validator::{Info as ValidatorInfo, Set as ValidatorSet};
-    use tendermint::PublicKey;
-
-    use crate::clients::ics07_tendermint::header::Header;
-    use crate::mock::host::SyntheticTmBlock;
-    use crate::Height;
-
-    pub fn get_dummy_tendermint_header() -> tendermint::block::Header {
-        serde_json::from_str::<SignedHeader>(include_str!(
-            "../../../tests/support/signed_header.json"
-        ))
-        .expect("Never fails")
-        .header
-    }
-
-    // TODO: This should be replaced with a ::default() or ::produce().
-    // The implementation of this function comprises duplicate code (code borrowed from
-    // `tendermint-rs` for assembling a Header).
-    // See https://github.com/informalsystems/tendermint-rs/issues/381.
-    //
-    // The normal flow is:
-    // - get the (trusted) signed header and the `trusted_validator_set` at a `trusted_height`
-    // - get the `signed_header` and the `validator_set` at latest height
-    // - build the ics07 Header
-    // For testing purposes this function does:
-    // - get the `signed_header` from a .json file
-    // - create the `validator_set` with a single validator that is also the proposer
-    // - assume a `trusted_height` of 1 and no change in the validator set since height 1,
-    //   i.e. `trusted_validator_set` = `validator_set`
-    pub fn get_dummy_ics07_header() -> Header {
-        // Build a SignedHeader from a JSON file.
-        let shdr = serde_json::from_str::<SignedHeader>(include_str!(
-            "../../../tests/support/signed_header.json"
-        ))
-        .expect("Never fails");
-
-        // Build a set of validators.
-        // Below are test values inspired form `test_validator_set()` in tendermint-rs.
-        let v1: ValidatorInfo = ValidatorInfo::new(
-            PublicKey::from_raw_ed25519(
-                &hex::decode_upper(
-                    "F349539C7E5EF7C49549B09C4BFC2335318AB0FE51FBFAA2433B4F13E816F4A7",
-                )
-                .expect("Never fails"),
-            )
-            .expect("Never fails"),
-            281_815_u64.try_into().expect("Never fails"),
-        );
-
-        let vs = ValidatorSet::new(vec![v1.clone()], Some(v1));
-
-        Header {
-            signed_header: shdr,
-            validator_set: vs.clone(),
-            trusted_height: Height::min(0),
-            trusted_next_validator_set: vs,
-        }
-    }
-
-    impl From<SyntheticTmBlock> for Header {
-        fn from(light_block: SyntheticTmBlock) -> Self {
-            let SyntheticTmBlock {
-                trusted_height,
-                trusted_next_validators,
-                light_block,
-            } = light_block;
-            Self {
-                signed_header: light_block.signed_header,
-                validator_set: light_block.validators,
-                trusted_height,
-                trusted_next_validator_set: trusted_next_validators,
-            }
-        }
-    }
-}
diff --git a/crates/ibc/src/clients/ics07_tendermint/mod.rs b/crates/ibc/src/clients/ics07_tendermint/mod.rs
index 803e7814e..13fa13694 100644
--- a/crates/ibc/src/clients/ics07_tendermint/mod.rs
+++ b/crates/ibc/src/clients/ics07_tendermint/mod.rs
@@ -15,7 +15,7 @@ pub mod trust_threshold;
 mod context;
 pub use context::*;
 
-pub(crate) const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
+pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
 
 /// Returns the tendermint `ClientType`
 pub fn client_type() -> ClientType {
diff --git a/crates/ibc/src/core/events.rs b/crates/ibc/src/core/events.rs
index 6b451c960..b4a2b5292 100644
--- a/crates/ibc/src/core/events.rs
+++ b/crates/ibc/src/core/events.rs
@@ -283,10 +283,11 @@ impl From<MessageEvent> for IbcEvent {
 pub mod tests {
     use alloc::vec;
 
+    use ibc_testkit::utils::core::channel::dummy_raw_packet;
+
     use super::*;
     use crate::core::ics04_channel::channel::Order;
     use crate::core::ics04_channel::events::SendPacket;
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
     use crate::core::ics04_channel::packet::Packet;
     use crate::core::ics24_host::identifier::ConnectionId;
 
@@ -294,7 +295,7 @@ pub mod tests {
     /// Ensures that we don't panic when packet data is not valid UTF-8.
     /// See issue [#199](https://github.com/cosmos/ibc-rs/issues/199)
     pub fn test_packet_data_non_utf8() {
-        let mut packet = Packet::try_from(get_dummy_raw_packet(1, 1)).unwrap();
+        let mut packet = Packet::try_from(dummy_raw_packet(1, 1)).unwrap();
         packet.data = vec![128];
 
         let ibc_event = IbcEvent::SendPacket(SendPacket::new(
diff --git a/crates/ibc/src/core/handler.rs b/crates/ibc/src/core/handler.rs
index 7c2babfe3..7c766a0dd 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/crates/ibc/src/core/handler.rs
@@ -195,667 +195,3 @@ where
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use core::default::Default;
-    use core::time::Duration;
-
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::error::TokenTransferError;
-    use crate::applications::transfer::msgs::transfer::MsgTransfer;
-    use crate::applications::transfer::{send_transfer, MODULE_ID_STR};
-    use crate::core::dispatch;
-    use crate::core::events::{IbcEvent, MessageEvent};
-    use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
-    use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
-    use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
-    use crate::core::ics02_client::msgs::ClientMsg;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnCounterparty, State as ConnState,
-    };
-    use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-    use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-    use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-    use crate::core::ics03_connection::msgs::ConnectionMsg;
-    use crate::core::ics03_connection::version::Version as ConnVersion;
-    use crate::core::ics04_channel::channel::{
-        ChannelEnd, Counterparty as ChannelCounterparty, Order as ChannelOrder,
-        State as ChannelState,
-    };
-    use crate::core::ics04_channel::error::ChannelError;
-    use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_ack_with_packet;
-    use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-    use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
-    use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-    use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
-    use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
-    use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
-    use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-    use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
-    use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-    use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
-    use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
-    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-    use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
-    use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-    use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
-    use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-    use crate::core::ics04_channel::msgs::{ChannelMsg, PacketMsg};
-    use crate::core::ics04_channel::timeout::TimeoutHeight;
-    use crate::core::ics04_channel::Version as ChannelVersion;
-    use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::ics24_host::path::CommitmentPath;
-    use crate::core::msgs::MsgEnvelope;
-    use crate::core::router::ModuleId;
-    use crate::core::timestamp::Timestamp;
-    use crate::mock::client_state::MockClientState;
-    use crate::mock::consensus_state::MockConsensusState;
-    use crate::mock::context::MockContext;
-    use crate::mock::header::MockHeader;
-    use crate::mock::router::MockRouter;
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_account_id, DummyTransferModule};
-    use crate::Height;
-
-    #[test]
-    /// These tests exercise two main paths: (1) the ability of the ICS26 routing module to dispatch
-    /// messages to the correct module handler, and more importantly: (2) the ability of ICS handlers
-    /// to work with the context and correctly store results.
-    fn routing_module_and_keepers() {
-        #[derive(Clone, Debug)]
-        enum TestMsg {
-            Ics26(MsgEnvelope),
-            Ics20(MsgTransfer),
-        }
-
-        impl From<MsgEnvelope> for TestMsg {
-            fn from(msg: MsgEnvelope) -> Self {
-                Self::Ics26(msg)
-            }
-        }
-
-        impl From<MsgTransfer> for TestMsg {
-            fn from(msg: MsgTransfer) -> Self {
-                Self::Ics20(msg)
-            }
-        }
-
-        type StateCheckFn = dyn FnOnce(&MockContext) -> bool;
-
-        // Test parameters
-        struct Test {
-            name: String,
-            msg: TestMsg,
-            want_pass: bool,
-            state_check: Option<Box<StateCheckFn>>,
-        }
-        let default_signer = get_dummy_account_id();
-        let client_height = 5;
-        let start_client_height = Height::new(0, client_height).unwrap();
-        let update_client_height = Height::new(0, 34).unwrap();
-        let update_client_height_after_send = Height::new(0, 35).unwrap();
-
-        let update_client_height_after_second_send = Height::new(0, 36).unwrap();
-
-        let upgrade_client_height = Height::new(1, 2).unwrap();
-
-        let upgrade_client_height_second = Height::new(1, 1).unwrap();
-
-        let transfer_module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-
-        // We reuse this same context across all tests. Nothing in particular needs parametrizing.
-        let mut ctx = MockContext::default();
-
-        let mut router = MockRouter::default();
-        router
-            .add_route(transfer_module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let create_client_msg = MsgCreateClient::new(
-            MockClientState::new(MockHeader::new(start_client_height)).into(),
-            MockConsensusState::new(MockHeader::new(start_client_height)).into(),
-            default_signer.clone(),
-        );
-
-        //
-        // Connection handshake messages.
-        //
-        let msg_conn_init = MsgConnectionOpenInit::new_dummy();
-
-        let correct_msg_conn_try = MsgConnectionOpenTry::new_dummy(client_height, client_height);
-
-        // The handler will fail to process this msg because the client height is too advanced.
-        let incorrect_msg_conn_try =
-            MsgConnectionOpenTry::new_dummy(client_height + 1, client_height + 1);
-
-        let msg_conn_ack = MsgConnectionOpenAck::new_dummy(client_height, client_height);
-
-        //
-        // Channel handshake messages.
-        //
-        let msg_chan_init =
-            MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
-
-        // The handler will fail to process this b/c the associated connection does not exist
-        let mut incorrect_msg_chan_init = msg_chan_init.clone();
-        incorrect_msg_chan_init.connection_hops_on_a = vec![ConnectionId::new(590)];
-
-        let msg_chan_try =
-            MsgChannelOpenTry::try_from(get_dummy_raw_msg_chan_open_try(client_height)).unwrap();
-
-        let msg_chan_ack =
-            MsgChannelOpenAck::try_from(get_dummy_raw_msg_chan_open_ack(client_height)).unwrap();
-
-        let msg_chan_close_init =
-            MsgChannelCloseInit::try_from(get_dummy_raw_msg_chan_close_init()).unwrap();
-
-        let msg_chan_close_confirm =
-            MsgChannelCloseConfirm::try_from(get_dummy_raw_msg_chan_close_confirm(client_height))
-                .unwrap();
-
-        let msg_transfer = MsgTransfer::new_dummy(Height::new(0, 35).unwrap().into(), None);
-        let msg_transfer_two = MsgTransfer::new_dummy(Height::new(0, 36).unwrap().into(), None);
-        let msg_transfer_no_timeout = MsgTransfer::new_dummy(TimeoutHeight::no_timeout(), None);
-        let msg_transfer_no_timeout_or_timestamp = MsgTransfer::new_dummy(
-            TimeoutHeight::no_timeout(),
-            Some(Timestamp::from_nanoseconds(0).unwrap()),
-        );
-
-        let mut msg_to_on_close =
-            MsgTimeoutOnClose::try_from(get_dummy_raw_msg_timeout_on_close(36, 5)).unwrap();
-        msg_to_on_close.packet.seq_on_a = 2.into();
-        msg_to_on_close.packet.timeout_height_on_b = msg_transfer_two.timeout_height_on_b;
-        msg_to_on_close.packet.timeout_timestamp_on_b = msg_transfer_two.timeout_timestamp_on_b;
-
-        let packet_data = serde_json::to_vec(&msg_transfer_two.packet_data)
-            .expect("PacketData's infallible Serialize impl failed");
-
-        msg_to_on_close.packet.data = packet_data;
-
-        let msg_recv_packet = MsgRecvPacket::try_from(get_dummy_raw_msg_recv_packet(35)).unwrap();
-        let msg_ack_packet = MsgAcknowledgement::try_from(get_dummy_raw_msg_ack_with_packet(
-            msg_transfer.get_transfer_packet(1u64.into()).into(),
-            35,
-        ))
-        .unwrap();
-
-        // First, create a client..
-        let res = dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Client(ClientMsg::CreateClient(create_client_msg.clone())),
-        );
-
-        assert!(
-            res.is_ok(),
-            "ICS26 routing dispatch test 'client creation' failed for message {create_client_msg:?} with result: {res:?}",
-        );
-
-        router.scope_port_to_module(msg_chan_init.port_id_on_a.clone(), transfer_module_id);
-
-        // Figure out the ID of the client that was just created.
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Client)
-        ));
-        let client_id_event = ctx.events.get(1);
-        assert!(
-            client_id_event.is_some(),
-            "There was no event generated for client creation!"
-        );
-        let client_id = match client_id_event.unwrap() {
-            IbcEvent::CreateClient(create_client) => create_client.client_id().clone(),
-            event => panic!("unexpected IBC event: {:?}", event),
-        };
-
-        let tests: Vec<Test> = vec![
-            // Test some ICS2 client functionality.
-            Test {
-                name: "Client update successful".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
-                    client_id: client_id.clone(),
-                    client_message: MockHeader::new(update_client_height)
-                        .with_timestamp(Timestamp::now())
-                        .into(),
-                    signer: default_signer.clone(),
-                }))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Client update fails due to stale header".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
-                    client_id: client_id.clone(),
-                    client_message: MockHeader::new(update_client_height).into(),
-                    signer: default_signer.clone(),
-                }))
-                .into(),
-                want_pass: false,
-                state_check: None,
-            },
-            Test {
-                name: "Connection open init succeeds".to_string(),
-                msg: MsgEnvelope::Connection(ConnectionMsg::OpenInit(
-                    msg_conn_init.with_client_id(client_id.clone()),
-                ))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Connection open try fails due to InvalidConsensusHeight (too high)"
-                    .to_string(),
-                msg: MsgEnvelope::Connection(ConnectionMsg::OpenTry(incorrect_msg_conn_try)).into(),
-                want_pass: false,
-                state_check: None,
-            },
-            Test {
-                name: "Connection open try succeeds".to_string(),
-                msg: MsgEnvelope::Connection(ConnectionMsg::OpenTry(
-                    correct_msg_conn_try.with_client_id(client_id.clone()),
-                ))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Connection open ack succeeds".to_string(),
-                msg: MsgEnvelope::Connection(ConnectionMsg::OpenAck(msg_conn_ack)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            // ICS04
-            Test {
-                name: "Channel open init succeeds".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::OpenInit(msg_chan_init)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Channel open init fail due to missing connection".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::OpenInit(incorrect_msg_chan_init)).into(),
-                want_pass: false,
-                state_check: None,
-            },
-            Test {
-                name: "Channel open try succeeds".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::OpenTry(msg_chan_try)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Channel open ack succeeds".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::OpenAck(msg_chan_ack)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Packet send".to_string(),
-                msg: msg_transfer.into(),
-                want_pass: true,
-                state_check: None,
-            },
-            // The client update is required in this test, because the proof associated with
-            // msg_recv_packet has the same height as the packet TO height (see get_dummy_raw_msg_recv_packet)
-            Test {
-                name: "Client update successful #2".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
-                    client_id: client_id.clone(),
-                    client_message: MockHeader::new(update_client_height_after_send)
-                        .with_timestamp(Timestamp::now())
-                        .into(),
-                    signer: default_signer.clone(),
-                }))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Receive packet".to_string(),
-                msg: MsgEnvelope::Packet(PacketMsg::Recv(msg_recv_packet.clone())).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Re-Receive packet".to_string(),
-                msg: MsgEnvelope::Packet(PacketMsg::Recv(msg_recv_packet)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            // Ack packet
-            Test {
-                name: "Ack packet".to_string(),
-                msg: MsgEnvelope::Packet(PacketMsg::Ack(msg_ack_packet.clone())).into(),
-                want_pass: true,
-                state_check: Some(Box::new(move |ctx| {
-                    ctx.get_packet_commitment(&CommitmentPath::new(
-                        &msg_ack_packet.packet.port_id_on_a,
-                        &msg_ack_packet.packet.chan_id_on_a,
-                        msg_ack_packet.packet.seq_on_a,
-                    ))
-                    .is_err()
-                })),
-            },
-            Test {
-                name: "Packet send".to_string(),
-                msg: msg_transfer_two.into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Client update successful".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
-                    client_id: client_id.clone(),
-                    client_message: MockHeader::new(update_client_height_after_second_send).into(),
-                    signer: default_signer,
-                }))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            // Timeout packets
-            Test {
-                name: "Transfer message no timeout".to_string(),
-                msg: msg_transfer_no_timeout.into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Transfer message no timeout nor timestamp".to_string(),
-                msg: msg_transfer_no_timeout_or_timestamp.into(),
-                want_pass: true,
-                state_check: None,
-            },
-            //ICS04-close channel
-            Test {
-                name: "Channel close init succeeds".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::CloseInit(msg_chan_close_init)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Channel close confirm fails cause channel is already closed".to_string(),
-                msg: MsgEnvelope::Channel(ChannelMsg::CloseConfirm(msg_chan_close_confirm)).into(),
-                want_pass: false,
-                state_check: None,
-            },
-            //ICS04-to_on_close
-            Test {
-                name: "Timeout on close".to_string(),
-                msg: MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(msg_to_on_close)).into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Client upgrade successful".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpgradeClient(
-                    MsgUpgradeClient::new_dummy(upgrade_client_height)
-                        .with_client_id(client_id.clone()),
-                ))
-                .into(),
-                want_pass: true,
-                state_check: None,
-            },
-            Test {
-                name: "Client upgrade un-successful".to_string(),
-                msg: MsgEnvelope::Client(ClientMsg::UpgradeClient(
-                    MsgUpgradeClient::new_dummy(upgrade_client_height_second)
-                        .with_client_id(client_id),
-                ))
-                .into(),
-                want_pass: false,
-                state_check: None,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let res = match test.msg.clone() {
-                TestMsg::Ics26(msg) => dispatch(&mut ctx, &mut router, msg).map(|_| ()),
-                TestMsg::Ics20(msg) => send_transfer(&mut ctx, &mut DummyTransferModule, msg)
-                    .map_err(|e: TokenTransferError| ChannelError::AppModule {
-                        description: e.to_string(),
-                    })
-                    .map_err(|e| RouterError::ContextError(e.into())),
-            };
-
-            assert_eq!(
-                test.want_pass,
-                res.is_ok(),
-                "ICS26 routing dispatch test '{}' failed for message {:?}\nwith result: {:?}",
-                test.name,
-                test.msg,
-                res
-            );
-
-            if let Some(state_check) = test.state_check {
-                assert_eq!(
-                    test.want_pass,
-                    state_check(&ctx),
-                    "ICS26 routing state check '{}' failed for message {:?}\nwith result: {:?}",
-                    test.name,
-                    test.msg,
-                    res
-                );
-            }
-        }
-    }
-
-    fn get_channel_events_ctx_router() -> (MockContext, MockRouter) {
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let ctx = MockContext::default()
-            .with_client(&ClientId::default(), Height::new(0, 1).unwrap())
-            .with_connection(
-                ConnectionId::new(0),
-                ConnectionEnd::new(
-                    ConnState::Open,
-                    ClientId::default(),
-                    ConnCounterparty::new(
-                        ClientId::default(),
-                        Some(ConnectionId::new(0)),
-                        CommitmentPrefix::default(),
-                    ),
-                    vec![ConnVersion::default()],
-                    Duration::MAX,
-                )
-                .unwrap(),
-            );
-        let mut router = MockRouter::default();
-
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        // Note: messages will be using the default port
-        router.scope_port_to_module(PortId::default(), module_id);
-
-        (ctx, router)
-    }
-
-    #[test]
-    fn test_chan_open_init_event() {
-        let (mut ctx, mut router) = get_channel_events_ctx_router();
-
-        let msg_chan_open_init =
-            MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::OpenInit(msg_chan_open_init)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenInitChannel(_)));
-    }
-
-    #[test]
-    fn test_chan_open_try_event() {
-        let (mut ctx, mut router) = get_channel_events_ctx_router();
-
-        let msg_chan_open_try =
-            MsgChannelOpenTry::try_from(get_dummy_raw_msg_chan_open_try(1)).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::OpenTry(msg_chan_open_try)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenTryChannel(_)));
-    }
-
-    #[test]
-    fn test_chan_open_ack_event() {
-        let (ctx, mut router) = get_channel_events_ctx_router();
-        let mut ctx = ctx.with_channel(
-            PortId::default(),
-            ChannelId::default(),
-            ChannelEnd::new(
-                ChannelState::Init,
-                ChannelOrder::Unordered,
-                ChannelCounterparty::new(PortId::default(), Some(ChannelId::default())),
-                vec![ConnectionId::new(0)],
-                ChannelVersion::default(),
-            )
-            .unwrap(),
-        );
-
-        let msg_chan_open_ack =
-            MsgChannelOpenAck::try_from(get_dummy_raw_msg_chan_open_ack(1)).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::OpenAck(msg_chan_open_ack)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenAckChannel(_)));
-    }
-
-    #[test]
-    fn test_chan_open_confirm_event() {
-        let (ctx, mut router) = get_channel_events_ctx_router();
-        let mut ctx = ctx.with_channel(
-            PortId::default(),
-            ChannelId::default(),
-            ChannelEnd::new(
-                ChannelState::TryOpen,
-                ChannelOrder::Unordered,
-                ChannelCounterparty::new(PortId::default(), Some(ChannelId::default())),
-                vec![ConnectionId::new(0)],
-                ChannelVersion::default(),
-            )
-            .unwrap(),
-        );
-
-        let msg_chan_open_confirm =
-            MsgChannelOpenConfirm::try_from(get_dummy_raw_msg_chan_open_confirm(1)).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::OpenConfirm(msg_chan_open_confirm)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenConfirmChannel(_)));
-    }
-
-    #[test]
-    fn test_chan_close_init_event() {
-        let (ctx, mut router) = get_channel_events_ctx_router();
-        let mut ctx = ctx.with_channel(
-            PortId::default(),
-            ChannelId::default(),
-            ChannelEnd::new(
-                ChannelState::Open,
-                ChannelOrder::Unordered,
-                ChannelCounterparty::new(PortId::default(), Some(ChannelId::default())),
-                vec![ConnectionId::new(0)],
-                ChannelVersion::default(),
-            )
-            .unwrap(),
-        );
-
-        let msg_chan_close_init =
-            MsgChannelCloseInit::try_from(get_dummy_raw_msg_chan_close_init()).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::CloseInit(msg_chan_close_init)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::CloseInitChannel(_)));
-    }
-
-    #[test]
-    fn test_chan_close_confirm_event() {
-        let (ctx, mut router) = get_channel_events_ctx_router();
-        let mut ctx = ctx.with_channel(
-            PortId::default(),
-            ChannelId::default(),
-            ChannelEnd::new(
-                ChannelState::Open,
-                ChannelOrder::Unordered,
-                ChannelCounterparty::new(PortId::default(), Some(ChannelId::default())),
-                vec![ConnectionId::new(0)],
-                ChannelVersion::default(),
-            )
-            .unwrap(),
-        );
-
-        let msg_chan_close_confirm =
-            MsgChannelCloseConfirm::try_from(get_dummy_raw_msg_chan_close_confirm(1)).unwrap();
-
-        dispatch(
-            &mut ctx,
-            &mut router,
-            MsgEnvelope::Channel(ChannelMsg::CloseConfirm(msg_chan_close_confirm)),
-        )
-        .unwrap();
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::CloseConfirmChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics02_client/events.rs b/crates/ibc/src/core/ics02_client/events.rs
index 8b9f027cb..e55bb9017 100644
--- a/crates/ibc/src/core/ics02_client/events.rs
+++ b/crates/ibc/src/core/ics02_client/events.rs
@@ -423,12 +423,11 @@ mod tests {
     use std::str::FromStr;
 
     use ibc_proto::google::protobuf::Any;
+    use ibc_testkit::utils::clients::mock::dummy_new_mock_header;
     use prost::Message;
     use tendermint::abci::Event as AbciEvent;
 
     use super::*;
-    use crate::core::timestamp::Timestamp;
-    use crate::mock::header::MockHeader;
 
     #[test]
     fn ibc_to_abci_client_events() {
@@ -444,9 +443,7 @@ mod tests {
         let client_id = ClientId::new(client_type.clone(), 0).unwrap();
         let consensus_height = Height::new(0, 5).unwrap();
         let consensus_heights = vec![Height::new(0, 5).unwrap(), Height::new(0, 7).unwrap()];
-        let header: Any = MockHeader::new(consensus_height)
-            .with_timestamp(Timestamp::none())
-            .into();
+        let header: Any = dummy_new_mock_header(5).into();
         let expected_keys = vec![
             "client_id",
             "client_type",
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/crates/ibc/src/core/ics02_client/handler/create_client.rs
index 0f8a9b143..342fefb16 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/create_client.rs
@@ -93,99 +93,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use test_log::test;
-
-    use super::*;
-    use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-    use crate::clients::ics07_tendermint::client_type as tm_client_type;
-    use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
-    use crate::core::ics02_client::handler::create_client::{execute, validate};
-    use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
-    use crate::mock::consensus_state::MockConsensusState;
-    use crate::mock::context::MockContext;
-    use crate::mock::header::MockHeader;
-    use crate::test_utils::get_dummy_account_id;
-    use crate::Height;
-
-    #[test]
-    fn test_create_client_ok() {
-        let mut ctx = MockContext::default();
-        let signer = get_dummy_account_id();
-        let height = Height::new(0, 42).unwrap();
-
-        let msg = MsgCreateClient::new(
-            MockClientState::new(MockHeader::new(height)).into(),
-            MockConsensusState::new(MockHeader::new(height)).into(),
-            signer,
-        );
-
-        let client_type = mock_client_type();
-
-        let client_id = {
-            let id_counter = ctx.client_counter().unwrap();
-            ClientId::new(client_type.clone(), id_counter).unwrap()
-        };
-
-        let res = validate(&ctx, msg.clone());
-
-        assert!(res.is_ok(), "validation happy path");
-
-        let res = execute(&mut ctx, msg.clone());
-
-        assert!(res.is_ok(), "execution happy path");
-
-        assert_eq!(ctx.client_counter().unwrap(), 1);
-
-        let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
-
-        assert_eq!(expected_client_state.client_type(), client_type);
-
-        assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
-    }
-
-    #[test]
-    fn test_tm_create_client_ok() {
-        let signer = get_dummy_account_id();
-
-        let mut ctx = MockContext::default();
-
-        let tm_header = get_dummy_tendermint_header();
-
-        let tm_client_state = TmClientState::new_dummy_from_header(tm_header.clone()).into();
-
-        let client_type = tm_client_type();
-
-        let client_id = {
-            let id_counter = ctx.client_counter().unwrap();
-            ClientId::new(client_type.clone(), id_counter).unwrap()
-        };
-
-        let msg = MsgCreateClient::new(
-            tm_client_state,
-            TmConsensusState::try_from(tm_header).unwrap().into(),
-            signer,
-        );
-
-        let res = validate(&ctx, msg.clone());
-
-        assert!(res.is_ok(), "tendermint client validation happy path");
-
-        let res = execute(&mut ctx, msg.clone());
-
-        assert!(res.is_ok(), "tendermint client execution happy path");
-
-        assert_eq!(ctx.client_counter().unwrap(), 1);
-
-        let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
-
-        assert_eq!(expected_client_state.client_type(), client_type);
-
-        assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
-    }
-}
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 47e4cdd60..9227495a0 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -118,947 +118,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use core::str::FromStr;
-    use core::time::Duration;
-
-    use ibc_proto::google::protobuf::Any;
-    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
-    use tendermint_testgen::Validator as TestgenValidator;
-    use test_log::test;
-
-    use super::*;
-    use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-    use crate::clients::ics07_tendermint::client_type as tm_client_type;
-    use crate::clients::ics07_tendermint::header::Header as TmHeader;
-    use crate::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics02_client::client_type::ClientType;
-    use crate::core::ics02_client::handler::update_client::{execute, validate};
-    use crate::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
-    use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
-    use crate::core::ics02_client::ClientValidationContext;
-    use crate::core::ics23_commitment::specs::ProofSpecs;
-    use crate::core::ics24_host::identifier::{ChainId, ClientId};
-    use crate::core::ics24_host::path::ClientConsensusStatePath;
-    use crate::core::timestamp::Timestamp;
-    use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
-    use crate::mock::context::{
-        AnyConsensusState, MockClientConfig, MockContext, MockContextConfig,
-    };
-    use crate::mock::header::MockHeader;
-    use crate::mock::host::{HostBlock, HostType};
-    use crate::mock::misbehaviour::Misbehaviour as MockMisbehaviour;
-    use crate::test_utils::get_dummy_account_id;
-    use crate::{downcast, Height};
-
-    #[test]
-    fn test_update_client_ok() {
-        let client_id = ClientId::default();
-        let signer = get_dummy_account_id();
-
-        let timestamp = Timestamp::now();
-
-        let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
-        let height = Height::new(0, 46).unwrap();
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: MockHeader::new(height).with_timestamp(timestamp).into(),
-            signer,
-        };
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-
-        assert!(res.is_ok(), "validation happy path");
-
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok(), "execution happy path");
-
-        assert_eq!(
-            ctx.client_state(&msg.client_id).unwrap(),
-            MockClientState::new(MockHeader::new(height).with_timestamp(timestamp)).into()
-        );
-    }
-
-    /// Tests that the Tendermint client consensus state pruning logic
-    /// functions correctly.
-    ///
-    /// This test sets up a MockContext with host height 1 and a trusting
-    /// period of 3 seconds. It then advances the state of the MockContext
-    /// by 2 heights, and thus 6 seconds, due to the DEFAULT_BLOCK_TIME_SECS
-    /// constant being set to 3 seconds. At this point, the chain is at height
-    /// 3. Any consensus states associated with a block more than 3 seconds
-    /// in the past should be expired and pruned from the IBC store. The test
-    /// thus checks that the consensus state at height 1 is not contained in
-    /// the store. It also checks that the consensus state at height 2 is
-    /// contained in the store and has not expired.
-    #[test]
-    fn test_consensus_state_pruning() {
-        let chain_id = ChainId::new("mockgaiaA-1").unwrap();
-
-        let client_height = Height::new(1, 1).unwrap();
-
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-
-        let mut ctx = MockContextConfig::builder()
-            .host_id(chain_id.clone())
-            .host_type(HostType::SyntheticTendermint)
-            .latest_height(client_height)
-            .latest_timestamp(Timestamp::now())
-            .max_history_size(u64::MAX)
-            .build()
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id.clone())
-                    .client_id(client_id.clone())
-                    .client_state_height(client_height)
-                    .client_type(tm_client_type())
-                    .trusting_period(Duration::from_secs(3))
-                    .build(),
-            );
-
-        let start_host_timestamp = ctx.host_timestamp().unwrap();
-
-        // Move the chain forward by 2 blocks to pass the trusting period.
-        for _ in 1..=2 {
-            let signer = get_dummy_account_id();
-
-            let update_height = ctx.latest_height();
-
-            ctx.advance_host_chain_height();
-
-            let mut block = ctx.host_block(&update_height).unwrap().clone();
-
-            block.set_trusted_height(client_height);
-
-            let msg = MsgUpdateClient {
-                client_id: client_id.clone(),
-                client_message: block.clone().into(),
-                signer,
-            };
-
-            let _ = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-            let _ = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        }
-
-        // Check that latest expired consensus state is pruned.
-        let expired_height = Height::new(1, 1).unwrap();
-        let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &expired_height);
-        assert!(ctx
-            .client_update_height(&client_id, &expired_height)
-            .is_err());
-        assert!(ctx.client_update_time(&client_id, &expired_height).is_err());
-        assert!(ctx.consensus_state(&client_cons_state_path).is_err());
-
-        // Check that latest valid consensus state exists.
-        let earliest_valid_height = Height::new(1, 2).unwrap();
-        let client_cons_state_path =
-            ClientConsensusStatePath::new(&client_id, &earliest_valid_height);
-
-        assert!(ctx
-            .client_update_height(&client_id, &earliest_valid_height)
-            .is_ok());
-        assert!(ctx
-            .client_update_time(&client_id, &earliest_valid_height)
-            .is_ok());
-        assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
-
-        let end_host_timestamp = ctx.host_timestamp().unwrap();
-        assert_eq!(
-            end_host_timestamp,
-            (start_host_timestamp + Duration::from_secs(6)).unwrap()
-        );
-    }
-
-    #[test]
-    fn test_update_nonexisting_client() {
-        let client_id = ClientId::from_str("mockclient1").unwrap();
-        let signer = get_dummy_account_id();
-
-        let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
-
-        let msg = MsgUpdateClient {
-            client_id: ClientId::from_str("nonexistingclient").unwrap(),
-            client_message: MockHeader::new(Height::new(0, 46).unwrap()).into(),
-            signer,
-        };
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg));
-
-        assert!(res.is_err());
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_adjacent_ok() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA-1").unwrap(),
-            HostType::Mock,
-            5,
-            Height::new(1, 1).unwrap(),
-        )
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
-        );
-
-        let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
-
-        let signer = get_dummy_account_id();
-
-        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-        block.set_trusted_height(client_height);
-
-        let latest_header_height = block.height();
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.into(),
-            signer,
-        };
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok());
-
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok(), "result: {res:?}");
-
-        let client_state = ctx.client_state(&msg.client_id).unwrap();
-        assert!(client_state
-            .status(&ctx, &msg.client_id)
-            .unwrap()
-            .is_active());
-        assert_eq!(client_state.latest_height(), latest_header_height);
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_validator_change_ok() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let mut ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA-1").unwrap())
-            .latest_height(Height::new(1, 1).unwrap())
-            .build()
-            .with_client_config(
-                // client state initialized with client_height, and
-                // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_b.clone())
-                    .client_id(client_id.clone())
-                    .client_state_height(client_height)
-                    .client_type(tm_client_type())
-                    .build(),
-            );
-
-        let ctx_b_val_history = vec![
-            // First two validator sets are default at client creation
-            //
-            // validator set of height-20
-            vec![
-                TestgenValidator::new("1").voting_power(50),
-                TestgenValidator::new("2").voting_power(50),
-            ],
-            // validator set of height-21
-            vec![
-                TestgenValidator::new("1").voting_power(50),
-                TestgenValidator::new("2").voting_power(50),
-            ],
-            // validator set of height-22
-            vec![
-                TestgenValidator::new("1").voting_power(30),
-                TestgenValidator::new("2").voting_power(70),
-            ],
-            // validator set of height-23
-            vec![
-                TestgenValidator::new("1").voting_power(20),
-                TestgenValidator::new("2").voting_power(80),
-            ],
-        ];
-
-        let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
-
-        let ctx_b = MockContextConfig::builder()
-            .host_id(chain_id_b.clone())
-            .host_type(HostType::SyntheticTendermint)
-            .latest_height(update_height)
-            .max_history_size(ctx_b_val_history.len() as u64 - 1)
-            .validator_set_history(ctx_b_val_history)
-            .build();
-
-        let signer = get_dummy_account_id();
-
-        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-        block.set_trusted_height(client_height);
-
-        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-            _ => panic!("unexpected host block type"),
-        };
-
-        block.set_trusted_next_validators_set(trusted_next_validator_set);
-
-        let latest_header_height = block.height();
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.into(),
-            signer,
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok());
-
-        let res = execute(
-            &mut ctx_a,
-            MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()),
-        );
-        assert!(res.is_ok(), "result: {res:?}");
-
-        let client_state = ctx_a.client_state(&msg.client_id).unwrap();
-        assert!(client_state
-            .status(&ctx_a, &msg.client_id)
-            .unwrap()
-            .is_active());
-        assert_eq!(client_state.latest_height(), latest_header_height);
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_validator_change_fail() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA-1").unwrap())
-            .latest_height(Height::new(1, 1).unwrap())
-            .build()
-            .with_client_config(
-                // client state initialized with client_height, and
-                // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_b.clone())
-                    .client_id(client_id.clone())
-                    .client_state_height(client_height)
-                    .client_type(tm_client_type())
-                    .build(),
-            );
-
-        let ctx_b_val_history = vec![
-            // First two validator sets are default at client creation
-            //
-            // validator set of height-20
-            vec![
-                TestgenValidator::new("1").voting_power(50),
-                TestgenValidator::new("2").voting_power(50),
-            ],
-            // incorrect next validator set for height-20
-            // validator set of height-21
-            vec![
-                TestgenValidator::new("1").voting_power(45),
-                TestgenValidator::new("2").voting_power(55),
-            ],
-            // validator set of height-22
-            vec![
-                TestgenValidator::new("1").voting_power(30),
-                TestgenValidator::new("2").voting_power(70),
-            ],
-            // validator set of height-23
-            vec![
-                TestgenValidator::new("1").voting_power(20),
-                TestgenValidator::new("2").voting_power(80),
-            ],
-        ];
-
-        let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
-
-        let ctx_b = MockContextConfig::builder()
-            .host_id(chain_id_b.clone())
-            .host_type(HostType::SyntheticTendermint)
-            .latest_height(update_height)
-            .max_history_size(ctx_b_val_history.len() as u64 - 1)
-            .validator_set_history(ctx_b_val_history)
-            .build();
-
-        let signer = get_dummy_account_id();
-
-        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-        block.set_trusted_height(client_height);
-
-        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-            _ => panic!("unexpected host block type"),
-        };
-
-        block.set_trusted_next_validators_set(trusted_next_validator_set);
-
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.into(),
-            signer,
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_err());
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let update_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let mut ctx = MockContext::new(
-            ChainId::new("mockgaiaA-1").unwrap(),
-            HostType::Mock,
-            5,
-            Height::new(1, 1).unwrap(),
-        )
-        .with_client_parametrized_history_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
-        );
-
-        let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
-
-        let signer = get_dummy_account_id();
-
-        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-        let trusted_height = client_height.clone().sub(1).unwrap();
-        block.set_trusted_height(trusted_height);
-
-        let latest_header_height = block.height();
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.into(),
-            signer,
-        };
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok());
-
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok(), "result: {res:?}");
-
-        let client_state = ctx.client_state(&msg.client_id).unwrap();
-        assert!(client_state
-            .status(&ctx, &msg.client_id)
-            .unwrap()
-            .is_active());
-        assert_eq!(client_state.latest_height(), latest_header_height);
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_duplicate_ok() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-
-        let ctx_a_chain_id = ChainId::new("mockgaiaA-1").unwrap();
-        let ctx_b_chain_id = ChainId::new("mockgaiaB-1").unwrap();
-        let start_height = Height::new(1, 11).unwrap();
-
-        let mut ctx_a = MockContext::new(ctx_a_chain_id, HostType::Mock, 5, start_height)
-            .with_client_parametrized_with_chain_id(
-                ctx_b_chain_id.clone(),
-                &client_id,
-                client_height,
-                Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-                Some(start_height),
-            );
-
-        let ctx_b = MockContext::new(
-            ctx_b_chain_id,
-            HostType::SyntheticTendermint,
-            5,
-            client_height,
-        );
-
-        let signer = get_dummy_account_id();
-
-        let block = ctx_b.host_block(&client_height).unwrap().clone();
-
-        // Update the trusted height of the header to point to the previous height
-        // (`start_height` in this case).
-        //
-        // Note: The current MockContext interface doesn't allow us to
-        // do this without a major redesign.
-        let block = match block {
-            HostBlock::SyntheticTendermint(mut theader) => {
-                // current problem: the timestamp of the new header doesn't match the timestamp of
-                // the stored consensus state. If we hack them to match, then commit check fails.
-                // FIXME: figure out why they don't match.
-                theader.trusted_height = start_height;
-
-                HostBlock::SyntheticTendermint(theader)
-            }
-            _ => block,
-        };
-
-        // Update the client height to `client_height`
-        //
-        // Note: The current MockContext interface doesn't allow us to
-        // do this without a major redesign.
-        {
-            // FIXME: idea: we need to update the light client with the latest block from
-            // chain B
-            let consensus_state: AnyConsensusState = block.clone().into();
-
-            let tm_block = downcast!(block.clone() => HostBlock::SyntheticTendermint).unwrap();
-
-            let chain_id = ChainId::from_str(tm_block.header().chain_id.as_str()).unwrap();
-
-            let client_state = {
-                #[allow(deprecated)]
-                let raw_client_state = RawTmClientState {
-                    chain_id: chain_id.to_string(),
-                    trust_level: Some(Fraction {
-                        numerator: 1,
-                        denominator: 3,
-                    }),
-                    trusting_period: Some(Duration::from_secs(64000).into()),
-                    unbonding_period: Some(Duration::from_secs(128000).into()),
-                    max_clock_drift: Some(Duration::from_millis(3000).into()),
-                    latest_height: Some(
-                        Height::new(
-                            chain_id.revision_number(),
-                            u64::from(tm_block.header().height),
-                        )
-                        .unwrap()
-                        .into(),
-                    ),
-                    proof_specs: ProofSpecs::default().into(),
-                    upgrade_path: Default::default(),
-                    frozen_height: None,
-                    allow_update_after_expiry: false,
-                    allow_update_after_misbehaviour: false,
-                };
-
-                let client_state = TmClientState::try_from(raw_client_state).unwrap();
-
-                client_state.into()
-            };
-
-            let mut ibc_store = ctx_a.ibc_store.lock();
-            let client_record = ibc_store.clients.get_mut(&client_id).unwrap();
-
-            client_record
-                .consensus_states
-                .insert(client_height, consensus_state);
-
-            client_record.client_state = Some(client_state);
-        }
-
-        let latest_header_height = block.height();
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.into(),
-            signer,
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_ok(), "result: {res:?}");
-
-        let res = execute(
-            &mut ctx_a,
-            MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()),
-        );
-        assert!(res.is_ok(), "result: {res:?}");
-
-        let client_state = ctx_a.client_state(&msg.client_id).unwrap();
-        assert!(client_state
-            .status(&ctx_a, &msg.client_id)
-            .unwrap()
-            .is_active());
-        assert_eq!(client_state.latest_height(), latest_header_height);
-        assert_eq!(client_state, ctx_a.latest_client_states(&msg.client_id));
-    }
-
-    #[test]
-    fn test_update_synthetic_tendermint_client_lower_height() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-
-        let client_update_height = Height::new(1, 19).unwrap();
-
-        let chain_start_height = Height::new(1, 11).unwrap();
-
-        let ctx = MockContext::new(
-            ChainId::new("mockgaiaA-1").unwrap(),
-            HostType::Mock,
-            5,
-            chain_start_height,
-        )
-        .with_client_parametrized(
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
-        );
-
-        let ctx_b = MockContext::new(
-            ChainId::new("mockgaiaB-1").unwrap(),
-            HostType::SyntheticTendermint,
-            5,
-            client_height,
-        );
-
-        let signer = get_dummy_account_id();
-
-        let block_ref = ctx_b.host_block(&client_update_height).unwrap();
-
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block_ref.clone().into(),
-            signer,
-        };
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg));
-        assert!(res.is_err());
-    }
-
-    #[test]
-    fn test_update_client_events() {
-        let client_id = ClientId::default();
-        let signer = get_dummy_account_id();
-
-        let timestamp = Timestamp::now();
-
-        let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
-        let height = Height::new(0, 46).unwrap();
-        let header: Any = MockHeader::new(height).with_timestamp(timestamp).into();
-        let msg = MsgUpdateClient {
-            client_id: client_id.clone(),
-            client_message: header.clone(),
-            signer,
-        };
-
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::UpdateClient(msg));
-        assert!(res.is_ok());
-
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Client)
-        ));
-        let update_client_event = downcast!(&ctx.events[1] => IbcEvent::UpdateClient).unwrap();
-
-        assert_eq!(update_client_event.client_id(), &client_id);
-        assert_eq!(update_client_event.client_type(), &mock_client_type());
-        assert_eq!(update_client_event.consensus_height(), &height);
-        assert_eq!(update_client_event.consensus_heights(), &vec![height]);
-        assert_eq!(update_client_event.header(), &header.encode_to_vec());
-    }
-
-    fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {
-        let client_state = ctx.client_state(client_id).unwrap();
-
-        let status = client_state.status(ctx, client_id).unwrap();
-        assert!(status.is_frozen(), "client_state status: {status}");
-
-        // check events
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Client),
-        ));
-        let misbehaviour_client_event =
-            downcast!(&ctx.events[1] => IbcEvent::ClientMisbehaviour).unwrap();
-        assert_eq!(misbehaviour_client_event.client_id(), client_id);
-        assert_eq!(misbehaviour_client_event.client_type(), client_type);
-    }
-
-    /// Tests misbehaviour handling for the mock client.
-    /// Misbehaviour evidence consists of identical headers - mock misbehaviour handler considers it
-    /// a valid proof of misbehaviour
-    #[test]
-    fn test_misbehaviour_client_ok() {
-        let client_id = ClientId::default();
-        let timestamp = Timestamp::now();
-        let height = Height::new(0, 46).unwrap();
-        let msg = MsgSubmitMisbehaviour {
-            client_id: client_id.clone(),
-            misbehaviour: MockMisbehaviour {
-                client_id: client_id.clone(),
-                header1: MockHeader::new(height).with_timestamp(timestamp),
-                header2: MockHeader::new(height).with_timestamp(timestamp),
-            }
-            .into(),
-            signer: get_dummy_account_id(),
-        };
-
-        let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
-
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg.clone()));
-        assert!(res.is_ok());
-        let res = execute(&mut ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg));
-        assert!(res.is_ok());
-
-        ensure_misbehaviour(&ctx, &client_id, &mock_client_type());
-    }
-
-    /// Tests misbehaviour handling failure for a non-existent client
-    #[test]
-    fn test_misbehaviour_nonexisting_client() {
-        let client_id = ClientId::from_str("mockclient1").unwrap();
-        let height = Height::new(0, 46).unwrap();
-        let msg = MsgSubmitMisbehaviour {
-            client_id: ClientId::from_str("nonexistingclient").unwrap(),
-            misbehaviour: MockMisbehaviour {
-                client_id: client_id.clone(),
-                header1: MockHeader::new(height),
-                header2: MockHeader::new(height),
-            }
-            .into(),
-            signer: get_dummy_account_id(),
-        };
-
-        let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
-        let res = validate(&ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg));
-        assert!(res.is_err());
-    }
-
-    /// Tests misbehaviour handling for the synthetic Tendermint client.
-    /// Misbehaviour evidence consists of equivocal headers.
-    #[test]
-    fn test_misbehaviour_synthetic_tendermint_equivocation() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-        let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA-1").unwrap(),
-            HostType::Mock,
-            5,
-            Height::new(1, 1).unwrap(),
-        )
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()),
-            Some(client_height),
-        );
-
-        // Create a mock context for chain-B
-        let ctx_b = MockContext::new(
-            chain_id_b.clone(),
-            HostType::SyntheticTendermint,
-            5,
-            misbehaviour_height,
-        );
-
-        // Get chain-B's header at `misbehaviour_height`
-        let header1: TmHeader = {
-            let mut block = ctx_b.host_block(&misbehaviour_height).unwrap().clone();
-            block.set_trusted_height(client_height);
-            block.try_into_tm_block().unwrap().into()
-        };
-
-        // Generate an equivocal header for chain-B at `misbehaviour_height`
-        let header2 = {
-            let mut tm_block = HostBlock::generate_tm_block(
-                chain_id_b,
-                misbehaviour_height.revision_height(),
-                Timestamp::now(),
-            );
-            tm_block.trusted_height = client_height;
-            tm_block.into()
-        };
-
-        let msg = MsgSubmitMisbehaviour {
-            client_id: client_id.clone(),
-            misbehaviour: TmMisbehaviour::new(client_id.clone(), header1, header2).into(),
-            signer: get_dummy_account_id(),
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::Misbehaviour(msg.clone()));
-        assert!(res.is_ok());
-        let res = execute(&mut ctx_a, MsgUpdateOrMisbehaviour::Misbehaviour(msg));
-        assert!(res.is_ok());
-        ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
-    }
-
-    #[test]
-    fn test_misbehaviour_synthetic_tendermint_bft_time() {
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(1, 20).unwrap();
-        let misbehaviour_height = Height::new(1, 21).unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-        let mut ctx_a = MockContext::new(
-            ChainId::new("mockgaiaA-1").unwrap(),
-            HostType::Mock,
-            5,
-            Height::new(1, 1).unwrap(),
-        )
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()),
-            Some(client_height),
-        );
-
-        // Generate `header1` for chain-B
-        let header1 = {
-            let mut tm_block = HostBlock::generate_tm_block(
-                chain_id_b.clone(),
-                misbehaviour_height.revision_height(),
-                Timestamp::now(),
-            );
-            tm_block.trusted_height = client_height;
-            tm_block
-        };
-
-        // Generate `header2` for chain-B which is identical to `header1` but with a conflicting
-        // timestamp
-        let header2 = {
-            let timestamp =
-                Timestamp::from_nanoseconds(Timestamp::now().nanoseconds() + 1_000_000_000)
-                    .unwrap();
-            let mut tm_block = HostBlock::generate_tm_block(
-                chain_id_b,
-                misbehaviour_height.revision_height(),
-                timestamp,
-            );
-            tm_block.trusted_height = client_height;
-            tm_block
-        };
-
-        let msg = MsgSubmitMisbehaviour {
-            client_id: client_id.clone(),
-            misbehaviour: TmMisbehaviour::new(client_id.clone(), header1.into(), header2.into())
-                .into(),
-            signer: get_dummy_account_id(),
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::Misbehaviour(msg.clone()));
-        assert!(res.is_ok());
-        let res = execute(&mut ctx_a, MsgUpdateOrMisbehaviour::Misbehaviour(msg));
-        assert!(res.is_ok());
-        ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
-    }
-
-    #[test]
-    fn test_expired_client() {
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let update_height = Height::new(1, 21).unwrap();
-        let client_height = update_height.sub(3).unwrap();
-
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-
-        let timestamp = Timestamp::now();
-
-        let trusting_period = Duration::from_secs(64);
-
-        let mut ctx = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA-1").unwrap())
-            .latest_height(Height::new(1, 1).unwrap())
-            .latest_timestamp(timestamp)
-            .build()
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_b.clone())
-                    .client_id(client_id.clone())
-                    .client_state_height(client_height)
-                    .client_type(tm_client_type())
-                    .latest_timestamp(timestamp)
-                    .trusting_period(trusting_period)
-                    .build(),
-            );
-
-        while ctx.host_timestamp().expect("no error")
-            < (timestamp + trusting_period).expect("no error")
-        {
-            ctx.advance_host_chain_height();
-        }
-
-        let client_state = ctx.client_state(&client_id).unwrap();
-
-        assert!(client_state.status(&ctx, &client_id).unwrap().is_expired());
-    }
-
-    #[test]
-    fn test_client_update_max_clock_drift() {
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        let client_height = Height::new(1, 20).unwrap();
-
-        let client_id = ClientId::new(tm_client_type(), 0).unwrap();
-
-        let timestamp = Timestamp::now();
-
-        let max_clock_drift = Duration::from_secs(64);
-
-        let ctx_a = MockContextConfig::builder()
-            .host_id(ChainId::new("mockgaiaA-1").unwrap())
-            .latest_height(Height::new(1, 1).unwrap())
-            .latest_timestamp(timestamp)
-            .build()
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_b.clone())
-                    .client_id(client_id.clone())
-                    .client_state_height(client_height)
-                    .client_type(tm_client_type())
-                    .latest_timestamp(timestamp)
-                    .max_clock_drift(max_clock_drift)
-                    .build(),
-            );
-
-        let mut ctx_b = MockContextConfig::builder()
-            .host_id(chain_id_b.clone())
-            .host_type(HostType::SyntheticTendermint)
-            .latest_height(client_height)
-            .latest_timestamp(timestamp)
-            .max_history_size(u64::MAX)
-            .build();
-
-        while ctx_b.host_timestamp().expect("no error")
-            < (ctx_a.host_timestamp().expect("no error") + max_clock_drift).expect("no error")
-        {
-            ctx_b.advance_host_chain_height();
-        }
-
-        // include current block
-        ctx_b.advance_host_chain_height();
-
-        let update_height = ctx_b.latest_height();
-
-        let signer = get_dummy_account_id();
-
-        let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-        block.set_trusted_height(client_height);
-
-        let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-            HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-            _ => panic!("unexpected host block type"),
-        };
-
-        block.set_trusted_next_validators_set(trusted_next_validator_set);
-
-        let msg = MsgUpdateClient {
-            client_id,
-            client_message: block.clone().into(),
-            signer,
-        };
-
-        let res = validate(&ctx_a, MsgUpdateOrMisbehaviour::UpdateClient(msg.clone()));
-        assert!(res.is_err());
-    }
-}
diff --git a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
index b964e2b5c..de5ebfbbd 100644
--- a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
@@ -81,159 +81,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-    use crate::clients::ics07_tendermint::client_type;
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
-    use crate::core::ics02_client::error::UpgradeClientError;
-    use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::{AnyClientState, AnyConsensusState, MockContext};
-    use crate::{downcast, Height};
-
-    enum Ctx {
-        Default,
-        WithClient,
-    }
-
-    enum Msg {
-        Default,
-        LowUpgradeHeight,
-        UnknownUpgradedClientStateType,
-    }
-
-    fn msg_upgrade_client_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgUpgradeClient> {
-        let client_id = ClientId::new(mock_client_type(), 0).unwrap();
-
-        let ctx_default = MockContext::default();
-        let ctx_with_client = ctx_default
-            .clone()
-            .with_client(&client_id, Height::new(0, 42).unwrap());
-        let ctx = match ctx_variant {
-            Ctx::Default => ctx_default,
-            Ctx::WithClient => ctx_with_client,
-        };
-
-        let upgrade_height = Height::new(1, 26).unwrap();
-        let msg_default = MsgUpgradeClient::new_dummy(upgrade_height);
-
-        let low_upgrade_height = Height::new(0, 26).unwrap();
-        let msg_with_low_upgrade_height = MsgUpgradeClient::new_dummy(low_upgrade_height);
-
-        let msg_with_unknown_upgraded_cs = MsgUpgradeClient {
-            upgraded_client_state: TmClientState::new_dummy_from_header(
-                get_dummy_tendermint_header(),
-            )
-            .into(),
-            ..msg_default.clone()
-        };
-
-        let msg = match msg_variant {
-            Msg::Default => msg_default,
-            Msg::LowUpgradeHeight => msg_with_low_upgrade_height,
-            Msg::UnknownUpgradedClientStateType => msg_with_unknown_upgraded_cs,
-        };
-
-        Fixture { ctx, msg }
-    }
-
-    fn upgrade_client_validate(fxt: &Fixture<MsgUpgradeClient>, expect: Expect) {
-        let Fixture { ctx, msg } = fxt;
-        let res = validate(ctx, msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
-
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}");
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-            }
-        };
-    }
-
-    fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
-        let res = execute(&mut fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
-        match expect {
-            Expect::Failure(err) => {
-                assert!(res.is_err(), "{err_msg}");
-                assert_eq!(
-                    core::mem::discriminant(res.as_ref().unwrap_err()),
-                    core::mem::discriminant(&err.unwrap())
-                );
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-                assert!(matches!(
-                    fxt.ctx.events[0],
-                    IbcEvent::Message(MessageEvent::Client)
-                ));
-                let upgrade_client_event =
-                    downcast!(&fxt.ctx.events[1] => IbcEvent::UpgradeClient).unwrap();
-                let plan_height = Height::new(1, 26).unwrap();
-
-                assert_eq!(upgrade_client_event.client_id(), &fxt.msg.client_id);
-                assert_eq!(upgrade_client_event.client_type(), &mock_client_type());
-                assert_eq!(upgrade_client_event.consensus_height(), &plan_height);
-
-                let client_state = fxt.ctx.client_state(&fxt.msg.client_id).unwrap();
-                let msg_client_state: AnyClientState =
-                    fxt.msg.upgraded_client_state.clone().try_into().unwrap();
-                assert_eq!(client_state, msg_client_state);
-
-                let consensus_state = fxt
-                    .ctx
-                    .consensus_state(&ClientConsensusStatePath::new(
-                        &fxt.msg.client_id,
-                        &plan_height,
-                    ))
-                    .unwrap();
-                let msg_consensus_state: AnyConsensusState =
-                    fxt.msg.upgraded_consensus_state.clone().try_into().unwrap();
-                assert_eq!(consensus_state, msg_consensus_state);
-            }
-        };
-    }
-
-    #[test]
-    fn msg_upgrade_client_healthy() {
-        let mut fxt = msg_upgrade_client_fixture(Ctx::WithClient, Msg::Default);
-        upgrade_client_validate(&fxt, Expect::Success);
-        upgrade_client_execute(&mut fxt, Expect::Success);
-    }
-
-    #[test]
-    fn upgrade_client_fail_nonexisting_client() {
-        let fxt = msg_upgrade_client_fixture(Ctx::Default, Msg::Default);
-        let expected_err = ContextError::ClientError(ClientError::ClientStateNotFound {
-            client_id: fxt.msg.client_id.clone(),
-        });
-        upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err)));
-    }
-
-    #[test]
-    fn upgrade_client_fail_low_upgrade_height() {
-        let fxt: Fixture<MsgUpgradeClient> =
-            msg_upgrade_client_fixture(Ctx::WithClient, Msg::LowUpgradeHeight);
-        let expected_err: ClientError = UpgradeClientError::LowUpgradeHeight {
-            upgraded_height: Height::new(0, 26).unwrap(),
-            client_height: fxt.ctx.latest_height(),
-        }
-        .into();
-        upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err.into())));
-    }
-
-    #[test]
-    fn upgrade_client_fail_unknown_upgraded_client_state() {
-        let fxt = msg_upgrade_client_fixture(Ctx::WithClient, Msg::UnknownUpgradedClientStateType);
-        let expected_err = ContextError::ClientError(ClientError::UnknownClientStateType {
-            client_state_type: client_type().to_string(),
-        });
-        upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err)));
-    }
-}
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
index 495d8eea2..9e1e6af13 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/create_client.rs
@@ -76,30 +76,17 @@ impl From<MsgCreateClient> for RawMsgCreateClient {
 mod tests {
 
     use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
+    use ibc_testkit::utils::core::client::dummy_raw_msg_create_client;
     use test_log::test;
 
-    use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-    use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_tendermint_header;
     use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
-    use crate::test_utils::get_dummy_account_id;
 
     #[test]
     fn msg_create_client_serialization() {
-        let signer = get_dummy_account_id();
-
-        let tm_header = get_dummy_tendermint_header();
-        let tm_client_state = TmClientState::new_dummy_from_header(tm_header.clone()).into();
-
-        let msg = MsgCreateClient::new(
-            tm_client_state,
-            TmConsensusState::try_from(tm_header).unwrap().into(),
-            signer,
-        );
-
-        let raw = RawMsgCreateClient::from(msg.clone());
-        let msg_back = MsgCreateClient::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgCreateClient::from(msg_back.clone());
+        let raw = dummy_raw_msg_create_client();
+        let msg = MsgCreateClient::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgCreateClient::from(msg.clone());
+        let msg_back = MsgCreateClient::try_from(raw_back.clone()).unwrap();
         assert_eq!(msg, msg_back);
         assert_eq!(raw, raw_back);
     }
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
index 9efcbe32b..9c19e77d2 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/update_client.rs
@@ -67,38 +67,19 @@ impl From<MsgUpdateClient> for RawMsgUpdateClient {
 
 #[cfg(test)]
 mod tests {
-    use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
+    use ibc_testkit::utils::core::client::dummy_raw_msg_update_client;
     use test_log::test;
 
     use super::*;
-    use crate::clients::ics07_tendermint::header::test_util::get_dummy_ics07_header;
     use crate::core::ics02_client::msgs::MsgUpdateClient;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::signer::Signer;
-    use crate::test_utils::get_dummy_account_id;
-
-    impl MsgUpdateClient {
-        pub fn new(client_id: ClientId, client_message: Any, signer: Signer) -> Self {
-            MsgUpdateClient {
-                client_id,
-                client_message,
-                signer,
-            }
-        }
-    }
 
     #[test]
     fn msg_update_client_serialization() {
-        let client_id: ClientId = "tendermint".parse().unwrap();
-        let signer = get_dummy_account_id();
-
-        let header = get_dummy_ics07_header();
-
-        let msg = MsgUpdateClient::new(client_id, header.into(), signer);
-        let raw = RawMsgUpdateClient::from(msg.clone());
-        let msg_back = MsgUpdateClient::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgUpdateClient::from(msg_back.clone());
+        let raw = dummy_raw_msg_update_client();
+        let msg = MsgUpdateClient::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgUpdateClient::from(msg.clone());
+        let msg_back = MsgUpdateClient::try_from(raw_back.clone()).unwrap();
         assert_eq!(msg, msg_back);
         assert_eq!(raw, raw_back);
     }
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
index d6dffcc67..baf363b38 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
@@ -97,60 +97,19 @@ impl TryFrom<RawMsgUpgradeClient> for MsgUpgradeClient {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use super::*;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics23_commitment::commitment::test_util::get_dummy_commitment_proof_bytes;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::mock::client_state::{client_type as mock_client_type, MockClientState};
-    use crate::mock::consensus_state::MockConsensusState;
-    use crate::mock::header::MockHeader;
-    use crate::test_utils::{get_dummy_account_id, get_dummy_bech32_account, get_dummy_proof};
-
-    /// Extends the implementation with additional helper methods.
-    impl MsgUpgradeClient {
-        pub fn new_dummy(upgrade_height: Height) -> Self {
-            MsgUpgradeClient {
-                client_id: ClientId::new(mock_client_type(), 0).unwrap(),
-                upgraded_client_state: MockClientState::new(MockHeader::new(upgrade_height)).into(),
-                upgraded_consensus_state: MockConsensusState::new(MockHeader::new(upgrade_height))
-                    .into(),
-                proof_upgrade_client: get_dummy_commitment_proof_bytes(),
-                proof_upgrade_consensus_state: get_dummy_commitment_proof_bytes(),
-                signer: get_dummy_account_id(),
-            }
-        }
-
-        pub fn with_client_id(self, client_id: ClientId) -> Self {
-            MsgUpgradeClient { client_id, ..self }
-        }
-    }
-
-    /// Returns a dummy `RawMsgUpgradeClient`, for testing only!
-    pub fn get_dummy_raw_msg_upgrade_client(upgrade_height: Height) -> RawMsgUpgradeClient {
-        RawMsgUpgradeClient {
-            client_id: mock_client_type().to_string(),
-            client_state: Some(MockClientState::new(MockHeader::new(upgrade_height)).into()),
-            consensus_state: Some(MockConsensusState::new(MockHeader::new(upgrade_height)).into()),
-            proof_upgrade_client: get_dummy_proof(),
-            proof_upgrade_consensus_state: get_dummy_proof(),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
-    use super::*;
-    use crate::core::ics02_client::height::Height;
+    use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
+    use ibc_testkit::utils::core::client::dummy_raw_msg_upgrade_client;
+
+    use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
 
     #[test]
     fn msg_upgrade_client_serialization() {
-        let msg = MsgUpgradeClient::new_dummy(Height::new(1, 1).unwrap());
-        let raw: RawMsgUpgradeClient = RawMsgUpgradeClient::from(msg.clone());
-        let msg_back = MsgUpgradeClient::try_from(raw.clone()).unwrap();
-        let raw_back: RawMsgUpgradeClient = RawMsgUpgradeClient::from(msg_back.clone());
+        let raw = dummy_raw_msg_upgrade_client();
+        let msg = MsgUpgradeClient::try_from(raw.clone()).unwrap();
+        let raw_back: RawMsgUpgradeClient = RawMsgUpgradeClient::from(msg.clone());
+        let msg_back = MsgUpgradeClient::try_from(raw_back.clone()).unwrap();
         assert_eq!(msg, msg_back);
         assert_eq!(raw, raw_back);
     }
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/crates/ibc/src/core/ics03_connection/connection.rs
index 5b43fd48e..ae989a9a0 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/crates/ibc/src/core/ics03_connection/connection.rs
@@ -380,9 +380,9 @@ impl ConnectionEnd {
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, Default, PartialEq, Eq, Hash)]
 pub struct Counterparty {
-    client_id: ClientId,
+    pub client_id: ClientId,
     pub connection_id: Option<ConnectionId>,
-    prefix: CommitmentPrefix,
+    pub prefix: CommitmentPrefix,
 }
 
 impl Protobuf<RawCounterparty> for Counterparty {}
diff --git a/crates/ibc/src/core/ics03_connection/handler.rs b/crates/ibc/src/core/ics03_connection/handler.rs
index a79a2d87b..20c34a37a 100644
--- a/crates/ibc/src/core/ics03_connection/handler.rs
+++ b/crates/ibc/src/core/ics03_connection/handler.rs
@@ -5,42 +5,3 @@ pub mod conn_open_ack;
 pub mod conn_open_confirm;
 pub mod conn_open_init;
 pub mod conn_open_try;
-
-#[cfg(test)]
-pub mod test_util {
-    use alloc::format;
-    use core::fmt::Debug;
-
-    use crate::core::ContextError;
-    use crate::mock::context::MockContext;
-    use crate::prelude::String;
-
-    pub enum Expect {
-        Success,
-        Failure(Option<ContextError>),
-    }
-
-    #[derive(Clone, Debug)]
-    pub struct Fixture<M: Debug> {
-        pub ctx: MockContext,
-        pub msg: M,
-    }
-
-    impl<M: Debug> Fixture<M> {
-        pub fn generate_error_msg(
-            &self,
-            expect: &Expect,
-            process: &str,
-            res: &Result<(), ContextError>,
-        ) -> String {
-            let base_error = match expect {
-                Expect::Success => "step failed!",
-                Expect::Failure(_) => "step passed but was supposed to fail!",
-            };
-            format!(
-                "{process} {base_error} /n {res:?} /n {:?} /n {:?}",
-                &self.msg, &self.ctx
-            )
-        }
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
index 285d1299b..cdc137d66 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
@@ -202,189 +202,3 @@ impl LocalVars {
         self.conn_end_on_a.counterparty().client_id()
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use core::str::FromStr;
-
-    use test_log::test;
-
-    use super::*;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-    use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
-    use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-    use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-    use crate::core::ics24_host::identifier::{ChainId, ClientId};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::context::MockContext;
-    use crate::mock::host::HostType;
-
-    enum Ctx {
-        New,
-        NewWithConnection,
-        NewWithConnectionEndOpen,
-        DefaultWithConnection,
-    }
-
-    fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
-        let msg = MsgConnectionOpenAck::new_dummy(10, 10);
-
-        // Client parameters -- identifier and correct height (matching the proof height)
-        let client_id = ClientId::from_str("mock_clientid").unwrap();
-        let proof_height = msg.proofs_height_on_b;
-        let conn_id = msg.conn_id_on_a.clone();
-
-        // Parametrize the host chain to have a height at least as recent as the
-        // the height of the proofs in the Ack msg.
-        let latest_height = proof_height.increment();
-        let max_history_size = 5;
-
-        // A connection end that will exercise the successful path.
-        let default_conn_end = ConnectionEnd::new(
-            State::Init,
-            client_id.clone(),
-            Counterparty::new(
-                client_id.clone(),
-                Some(msg.conn_id_on_b.clone()),
-                CommitmentPrefix::try_from(b"ibc".to_vec()).unwrap(),
-            ),
-            vec![msg.version.clone()],
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        // A connection end with incorrect state `Open`; will be part of the context.
-        let mut conn_end_open = default_conn_end.clone();
-        conn_end_open.set_state(State::Open); // incorrect field
-
-        let ctx_default = MockContext::default();
-        let ctx_new = MockContext::new(
-            ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap(),
-            HostType::Mock,
-            max_history_size,
-            latest_height,
-        );
-        let ctx = match ctx {
-            Ctx::New => ctx_new,
-            Ctx::NewWithConnection => ctx_new
-                .with_client(&client_id, proof_height)
-                .with_connection(conn_id, default_conn_end),
-            Ctx::DefaultWithConnection => ctx_default
-                .with_client(&client_id, proof_height)
-                .with_connection(conn_id, default_conn_end),
-            Ctx::NewWithConnectionEndOpen => ctx_new
-                .with_client(&client_id, proof_height)
-                .with_connection(conn_id, conn_end_open),
-        };
-
-        Fixture { ctx, msg }
-    }
-
-    fn conn_open_ack_validate(fxt: &Fixture<MsgConnectionOpenAck>, expect: Expect) {
-        let res = validate(&fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
-        match expect {
-            Expect::Failure(err) => {
-                assert!(res.is_err(), "{err_msg}");
-                assert_eq!(
-                    core::mem::discriminant(res.as_ref().unwrap_err()),
-                    core::mem::discriminant(&err.unwrap())
-                );
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-                return;
-            }
-        };
-        let right_connection_id = fxt.msg.conn_id_on_a.clone();
-        let cons_state_height = fxt.msg.consensus_height_of_a_on_b;
-        match res.unwrap_err() {
-            ContextError::ConnectionError(ConnectionError::ConnectionNotFound {
-                connection_id,
-            }) => {
-                assert_eq!(connection_id, right_connection_id)
-            }
-            ContextError::ConnectionError(ConnectionError::InvalidConsensusHeight {
-                target_height,
-                current_height: _,
-            }) => {
-                assert_eq!(cons_state_height, target_height);
-            }
-            ContextError::ConnectionError(ConnectionError::InvalidState {
-                expected: _,
-                actual: _,
-            }) => {}
-            _ => unreachable!(),
-        }
-    }
-
-    fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect) {
-        let res = execute(&mut fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}");
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-                assert_eq!(fxt.ctx.events.len(), 2);
-
-                assert!(matches!(
-                    fxt.ctx.events[0],
-                    IbcEvent::Message(MessageEvent::Connection)
-                ));
-                let event = &fxt.ctx.events[1];
-                assert!(matches!(event, &IbcEvent::OpenAckConnection(_)));
-
-                let conn_open_try_event = match event {
-                    IbcEvent::OpenAckConnection(e) => e,
-                    _ => unreachable!(),
-                };
-                let conn_end = <MockContext as ValidationContext>::connection_end(
-                    &fxt.ctx,
-                    conn_open_try_event.conn_id_on_a(),
-                )
-                .unwrap();
-                assert_eq!(conn_end.state().clone(), State::Open);
-            }
-        }
-    }
-
-    #[test]
-    fn conn_open_ack_healthy() {
-        let mut fxt = conn_open_ack_fixture(Ctx::NewWithConnection);
-        conn_open_ack_validate(&fxt, Expect::Success);
-        conn_open_ack_execute(&mut fxt, Expect::Success);
-    }
-
-    #[test]
-    fn conn_open_ack_no_connection() {
-        let fxt = conn_open_ack_fixture(Ctx::New);
-        let expected_err = ContextError::ConnectionError(ConnectionError::ConnectionNotFound {
-            connection_id: fxt.msg.conn_id_on_a.clone(),
-        });
-        conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
-    }
-
-    #[test]
-    fn conn_open_ack_invalid_consensus_height() {
-        let fxt = conn_open_ack_fixture(Ctx::DefaultWithConnection);
-        let expected_err = ContextError::ConnectionError(ConnectionError::InvalidConsensusHeight {
-            target_height: fxt.msg.consensus_height_of_a_on_b,
-            current_height: Height::new(0, 10).unwrap(),
-        });
-        conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
-    }
-
-    #[test]
-    fn conn_open_ack_connection_mismatch() {
-        let fxt = conn_open_ack_fixture(Ctx::NewWithConnectionEndOpen);
-        let expected_err = ContextError::ConnectionError(ConnectionError::InvalidState {
-            expected: State::Init.to_string(),
-            actual: State::Open.to_string(),
-        });
-        conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
index d7896f2bc..83392ff6d 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
@@ -168,125 +168,3 @@ impl LocalVars {
             .ok_or(ConnectionError::InvalidCounterparty)
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use core::str::FromStr;
-
-    use test_log::test;
-
-    use super::*;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-    use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
-    use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-    use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::context::MockContext;
-    use crate::Height;
-
-    enum Ctx {
-        Default,
-        CorrectConnection,
-        IncorrectConnection,
-    }
-
-    fn conn_open_confirm_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenConfirm> {
-        let client_id = ClientId::from_str("mock_clientid").unwrap();
-        let msg = MsgConnectionOpenConfirm::new_dummy();
-        let counterparty = Counterparty::new(
-            client_id.clone(),
-            Some(msg.conn_id_on_b.clone()),
-            CommitmentPrefix::try_from(b"ibc".to_vec()).unwrap(),
-        );
-
-        let ctx_default = MockContext::default();
-
-        let incorrect_conn_end_state = ConnectionEnd::new(
-            State::Init,
-            client_id.clone(),
-            counterparty,
-            ValidationContext::get_compatible_versions(&ctx_default),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let mut correct_conn_end = incorrect_conn_end_state.clone();
-        correct_conn_end.set_state(State::TryOpen);
-
-        let ctx = match ctx {
-            Ctx::Default => ctx_default,
-            Ctx::IncorrectConnection => ctx_default
-                .with_client(&client_id, Height::new(0, 10).unwrap())
-                .with_connection(msg.conn_id_on_b.clone(), incorrect_conn_end_state),
-            Ctx::CorrectConnection => ctx_default
-                .with_client(&client_id, Height::new(0, 10).unwrap())
-                .with_connection(msg.conn_id_on_b.clone(), correct_conn_end),
-        };
-
-        Fixture { ctx, msg }
-    }
-
-    fn conn_open_confirm_validate(fxt: &Fixture<MsgConnectionOpenConfirm>, expect: Expect) {
-        let res = validate(&fxt.ctx, &fxt.msg);
-        let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}");
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-            }
-        };
-    }
-
-    fn conn_open_confirm_execute(fxt: &mut Fixture<MsgConnectionOpenConfirm>, expect: Expect) {
-        let res = execute(&mut fxt.ctx, &fxt.msg);
-        let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}");
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-                assert_eq!(fxt.ctx.events.len(), 2);
-
-                assert!(matches!(
-                    fxt.ctx.events[0],
-                    IbcEvent::Message(MessageEvent::Connection)
-                ));
-                let event = &fxt.ctx.events[1];
-                assert!(matches!(event, &IbcEvent::OpenConfirmConnection(_)));
-
-                let conn_open_try_event = match event {
-                    IbcEvent::OpenConfirmConnection(e) => e,
-                    _ => unreachable!(),
-                };
-                let conn_end =
-                    ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
-                        .unwrap();
-                assert_eq!(conn_end.state().clone(), State::Open);
-            }
-        }
-    }
-
-    #[test]
-    fn conn_open_confirm_healthy() {
-        let mut fxt = conn_open_confirm_fixture(Ctx::CorrectConnection);
-        conn_open_confirm_validate(&fxt, Expect::Success);
-        conn_open_confirm_execute(&mut fxt, Expect::Success);
-    }
-
-    #[test]
-    fn conn_open_confirm_no_connection() {
-        let fxt = conn_open_confirm_fixture(Ctx::Default);
-        conn_open_confirm_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_confirm_connection_mismatch() {
-        let fxt = conn_open_confirm_fixture(Ctx::IncorrectConnection);
-        conn_open_confirm_validate(&fxt, Expect::Failure(None));
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
index cc470e81b..f1ba3c95a 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
@@ -86,140 +86,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use test_log::test;
-
-    use super::*;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics03_connection::connection::State;
-    use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
-    use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-    use crate::core::ics03_connection::version::Version;
-    use crate::mock::context::MockContext;
-    use crate::Height;
-
-    enum Ctx {
-        Default,
-        WithClient,
-    }
-
-    enum Msg {
-        Default,
-        NoVersion,
-        BadVersion,
-        WithCounterpartyConnId,
-    }
-
-    fn conn_open_init_fixture(
-        ctx_variant: Ctx,
-        msg_variant: Msg,
-    ) -> Fixture<MsgConnectionOpenInit> {
-        let msg_default = MsgConnectionOpenInit::new_dummy();
-        let msg = match msg_variant {
-            Msg::Default => msg_default,
-            Msg::NoVersion => msg_default.with_version(None),
-            Msg::BadVersion => msg_default.with_version(Some("random identifier 424242")),
-            Msg::WithCounterpartyConnId => msg_default.with_counterparty_conn_id(2),
-        };
-
-        let ctx_default = MockContext::default();
-        let ctx = match ctx_variant {
-            Ctx::WithClient => {
-                ctx_default.with_client(&msg.client_id_on_a, Height::new(0, 10).unwrap())
-            }
-            _ => ctx_default,
-        };
-
-        Fixture { ctx, msg }
-    }
-
-    fn conn_open_init_validate(fxt: &Fixture<MsgConnectionOpenInit>, expect: Expect) {
-        let res = validate(&fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}")
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}")
-            }
-        }
-    }
-
-    fn conn_open_init_execute(
-        fxt: &mut Fixture<MsgConnectionOpenInit>,
-        expect: Expect,
-        expected_version: Vec<Version>,
-    ) {
-        let res = execute(&mut fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}")
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-
-                assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
-
-                assert_eq!(fxt.ctx.events.len(), 2);
-
-                assert!(matches!(
-                    fxt.ctx.events[0],
-                    IbcEvent::Message(MessageEvent::Connection)
-                ));
-                let event = &fxt.ctx.events[1];
-                assert!(matches!(event, &IbcEvent::OpenInitConnection(_)));
-
-                let conn_open_init_event = match event {
-                    IbcEvent::OpenInitConnection(e) => e,
-                    _ => unreachable!(),
-                };
-                let conn_end = ValidationContext::connection_end(
-                    &fxt.ctx,
-                    conn_open_init_event.conn_id_on_a(),
-                )
-                .unwrap();
-                assert_eq!(conn_end.state().clone(), State::Init);
-                assert_eq!(conn_end.versions(), expected_version);
-            }
-        }
-    }
-
-    #[test]
-    fn conn_open_init_healthy() {
-        let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::Default);
-        conn_open_init_validate(&fxt, Expect::Success);
-        let expected_version = vec![fxt.msg.version.clone().unwrap()];
-        conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
-    }
-
-    #[test]
-    fn conn_open_init_no_context() {
-        let fxt = conn_open_init_fixture(Ctx::Default, Msg::Default);
-        conn_open_init_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_init_no_version() {
-        let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::NoVersion);
-        conn_open_init_validate(&fxt, Expect::Success);
-        let expected_version = ValidationContext::get_compatible_versions(&fxt.ctx.clone());
-        conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
-    }
-    #[test]
-    fn conn_open_init_incompatible_version() {
-        let fxt = conn_open_init_fixture(Ctx::WithClient, Msg::BadVersion);
-        conn_open_init_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_init_with_counterparty_conn_id() {
-        let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::WithCounterpartyConnId);
-        conn_open_init_validate(&fxt, Expect::Success);
-        let expected_version = vec![fxt.msg.version.clone().unwrap()];
-        conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
index cad91660a..965cd4b0d 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
@@ -202,150 +202,3 @@ impl LocalVars {
         })
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use test_log::test;
-
-    use super::*;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics03_connection::connection::State;
-    use crate::core::ics03_connection::handler::test_util::{Expect, Fixture};
-    use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-    use crate::core::ics24_host::identifier::ChainId;
-    use crate::mock::context::MockContext;
-    use crate::mock::host::HostType;
-    use crate::Height;
-
-    enum Ctx {
-        Default,
-        WithClient,
-    }
-
-    enum Msg {
-        Default,
-        HeightAdvanced,
-        HeightOld,
-        ProofHeightMissing,
-    }
-
-    fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConnectionOpenTry> {
-        let max_history_size = 5;
-        let client_cons_state_height = 10;
-        let host_chain_height = Height::new(0, 35).unwrap();
-        let pruned_height = host_chain_height
-            .sub(max_history_size + 1)
-            .unwrap()
-            .revision_height();
-
-        let msg = match msg_variant {
-            Msg::Default => MsgConnectionOpenTry::new_dummy(
-                client_cons_state_height,
-                host_chain_height.revision_height(),
-            ),
-            Msg::HeightAdvanced => MsgConnectionOpenTry::new_dummy(
-                client_cons_state_height,
-                host_chain_height.increment().revision_height(),
-            ),
-            Msg::HeightOld => {
-                MsgConnectionOpenTry::new_dummy(client_cons_state_height, pruned_height)
-            }
-            Msg::ProofHeightMissing => MsgConnectionOpenTry::new_dummy(
-                client_cons_state_height - 1,
-                host_chain_height.revision_height(),
-            ),
-        };
-
-        let ctx_new = MockContext::new(
-            ChainId::new("mockgaia-0").unwrap(),
-            HostType::Mock,
-            max_history_size,
-            host_chain_height,
-        );
-        let ctx = match ctx_variant {
-            Ctx::Default => MockContext::default(),
-            Ctx::WithClient => ctx_new.with_client(
-                &msg.client_id_on_b,
-                Height::new(0, client_cons_state_height).unwrap(),
-            ),
-        };
-        Fixture { ctx, msg }
-    }
-
-    fn conn_open_try_validate(fxt: &Fixture<MsgConnectionOpenTry>, expect: Expect) {
-        let res = validate(&fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "validation", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}")
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-            }
-        }
-    }
-
-    fn conn_open_try_execute(fxt: &mut Fixture<MsgConnectionOpenTry>, expect: Expect) {
-        let res = execute(&mut fxt.ctx, fxt.msg.clone());
-        let err_msg = fxt.generate_error_msg(&expect, "execution", &res);
-        match expect {
-            Expect::Failure(_) => {
-                assert!(res.is_err(), "{err_msg}")
-            }
-            Expect::Success => {
-                assert!(res.is_ok(), "{err_msg}");
-
-                assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
-
-                assert_eq!(fxt.ctx.events.len(), 2);
-
-                assert!(matches!(
-                    fxt.ctx.events[0],
-                    IbcEvent::Message(MessageEvent::Connection)
-                ));
-                let event = &fxt.ctx.events[1];
-                assert!(matches!(event, &IbcEvent::OpenTryConnection(_)));
-
-                let conn_open_try_event = match event {
-                    IbcEvent::OpenTryConnection(e) => e,
-                    _ => unreachable!(),
-                };
-                let conn_end =
-                    ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
-                        .unwrap();
-                assert_eq!(conn_end.state().clone(), State::TryOpen);
-            }
-        }
-    }
-
-    #[test]
-    fn conn_open_try_healthy() {
-        let mut fxt = conn_open_try_fixture(Ctx::WithClient, Msg::Default);
-        conn_open_try_validate(&fxt, Expect::Success);
-        conn_open_try_execute(&mut fxt, Expect::Success);
-    }
-
-    #[test]
-    fn conn_open_try_height_advanced() {
-        let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::HeightAdvanced);
-        conn_open_try_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_try_height_old() {
-        let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::HeightOld);
-        conn_open_try_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_try_proof_height_missing() {
-        let fxt = conn_open_try_fixture(Ctx::WithClient, Msg::ProofHeightMissing);
-        conn_open_try_validate(&fxt, Expect::Failure(None));
-    }
-
-    #[test]
-    fn conn_open_try_no_client() {
-        let fxt = conn_open_try_fixture(Ctx::Default, Msg::Default);
-        conn_open_try_validate(&fxt, Expect::Failure(None));
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/crates/ibc/src/core/ics03_connection/msgs.rs
index 0de5e6153..f80617d82 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs.rs
@@ -36,27 +36,3 @@ pub enum ConnectionMsg {
     OpenAck(MsgConnectionOpenAck),
     OpenConfirm(MsgConnectionOpenConfirm),
 }
-
-#[cfg(test)]
-pub mod test_util {
-
-    use ibc_proto::ibc::core::commitment::v1::MerklePrefix;
-    use ibc_proto::ibc::core::connection::v1::Counterparty as RawCounterparty;
-
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::prelude::*;
-
-    pub fn get_dummy_raw_counterparty(conn_id: Option<u64>) -> RawCounterparty {
-        let connection_id = match conn_id {
-            Some(id) => ConnectionId::new(id).to_string(),
-            None => "".to_string(),
-        };
-        RawCounterparty {
-            client_id: ClientId::default().to_string(),
-            connection_id,
-            prefix: Some(MerklePrefix {
-                key_prefix: b"ibc".to_vec(),
-            }),
-        }
-    }
-}
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
index ae8a7f07b..cbdbbfcba 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
@@ -130,66 +130,13 @@ impl From<MsgConnectionOpenAck> for RawMsgConnectionOpenAck {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
-
-    use super::MsgConnectionOpenAck;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::version::Version;
-    use crate::core::ics24_host::identifier::ConnectionId;
-    use crate::mock::client_state::MockClientState;
-    use crate::mock::header::MockHeader;
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Testing-specific helper methods.
-    impl MsgConnectionOpenAck {
-        /// Returns a new `MsgConnectionOpenAck` with dummy values.
-        pub fn new_dummy(proof_height: u64, consensus_height: u64) -> Self {
-            MsgConnectionOpenAck::try_from(get_dummy_raw_msg_conn_open_ack(
-                proof_height,
-                consensus_height,
-            ))
-            .unwrap()
-        }
-    }
-
-    pub fn get_dummy_raw_msg_conn_open_ack(
-        proof_height: u64,
-        consensus_height: u64,
-    ) -> RawMsgConnectionOpenAck {
-        let client_state_height = Height::new(0, consensus_height).unwrap();
-        RawMsgConnectionOpenAck {
-            connection_id: ConnectionId::new(0).to_string(),
-            counterparty_connection_id: ConnectionId::new(1).to_string(),
-            proof_try: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            proof_consensus: get_dummy_proof(),
-            consensus_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: consensus_height,
-            }),
-            client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-            proof_client: get_dummy_proof(),
-            version: Some(Version::default().into()),
-            signer: get_dummy_bech32_account(),
-            host_consensus_state_proof: vec![],
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+    use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_ack;
     use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_ack::test_util::get_dummy_raw_msg_conn_open_ack;
     use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
     use crate::prelude::*;
 
@@ -202,7 +149,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_ack_msg = get_dummy_raw_msg_conn_open_ack(5, 5);
+        let default_ack_msg = dummy_raw_msg_conn_open_ack(5, 5);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -268,7 +215,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_conn_open_ack(5, 6);
+        let raw = dummy_raw_msg_conn_open_ack(5, 6);
         let msg = MsgConnectionOpenAck::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgConnectionOpenAck::from(msg.clone());
         let msg_back = MsgConnectionOpenAck::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
index 45a5f6f7d..5a1200c78 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
@@ -72,43 +72,13 @@ impl From<MsgConnectionOpenConfirm> for RawMsgConnectionOpenConfirm {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
-
-    use super::MsgConnectionOpenConfirm;
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Testing-specific helper methods.
-    impl MsgConnectionOpenConfirm {
-        /// Returns a new `MsgConnectionOpenConfirm` with dummy values.
-        pub fn new_dummy() -> Self {
-            MsgConnectionOpenConfirm::try_from(get_dummy_raw_msg_conn_open_confirm()).unwrap()
-        }
-    }
-
-    pub fn get_dummy_raw_msg_conn_open_confirm() -> RawMsgConnectionOpenConfirm {
-        RawMsgConnectionOpenConfirm {
-            connection_id: "srcconnection".to_string(),
-            proof_ack: get_dummy_proof(),
-            proof_height: Some(Height {
-                revision_number: 0,
-                revision_height: 10,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+    use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_confirm;
     use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_confirm::test_util::get_dummy_raw_msg_conn_open_confirm;
     use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
     use crate::prelude::*;
 
@@ -121,7 +91,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_ack_msg = get_dummy_raw_msg_conn_open_confirm();
+        let default_ack_msg = dummy_raw_msg_conn_open_confirm();
         let tests: Vec<Test> = vec![
             Test {
                 name: "Good parameters".to_string(),
@@ -167,7 +137,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_conn_open_confirm();
+        let raw = dummy_raw_msg_conn_open_confirm();
         let msg = MsgConnectionOpenConfirm::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgConnectionOpenConfirm::from(msg.clone());
         let msg_back = MsgConnectionOpenConfirm::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index 37afaa9b4..249076364 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -128,83 +128,17 @@ impl From<MsgConnectionOpenInit> for RawMsgConnectionOpenInit {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::connection::v1::{
-        MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
-    };
-
-    use crate::core::ics03_connection::connection::Counterparty;
-    use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::Version;
-    use crate::core::ics24_host::identifier::ClientId;
-    use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
-
-    /// Extends the implementation with additional helper methods.
-    impl MsgConnectionOpenInit {
-        /// Returns a new `MsgConnectionOpenInit` with dummy values.
-        pub fn new_dummy() -> Self {
-            MsgConnectionOpenInit::try_from(get_dummy_raw_msg_conn_open_init()).unwrap()
-        }
-
-        /// Setter for `client_id`. Amenable to chaining, since it consumes the input message.
-        pub fn with_client_id(self, client_id: ClientId) -> Self {
-            MsgConnectionOpenInit {
-                client_id_on_a: client_id,
-                ..self
-            }
-        }
-
-        /// Setter for `counterparty`. Amenable to chaining, since it consumes the input message.\
-        pub fn with_counterparty_conn_id(self, counterparty_conn_id: u64) -> Self {
-            let counterparty =
-                Counterparty::try_from(get_dummy_raw_counterparty(Some(counterparty_conn_id)))
-                    .unwrap();
-            MsgConnectionOpenInit {
-                counterparty,
-                ..self
-            }
-        }
-
-        pub fn with_version(self, identifier: Option<&str>) -> Self {
-            let version = match identifier {
-                Some(v) => Version::try_from(RawVersion {
-                    identifier: v.to_string(),
-                    features: vec![],
-                })
-                .unwrap()
-                .into(),
-                None => None,
-            };
-            MsgConnectionOpenInit { version, ..self }
-        }
-    }
-
-    /// Returns a dummy message, for testing only.
-    /// Other unit tests may import this if they depend on a MsgConnectionOpenInit.
-    pub fn get_dummy_raw_msg_conn_open_init() -> RawMsgConnectionOpenInit {
-        RawMsgConnectionOpenInit {
-            client_id: ClientId::default().to_string(),
-            counterparty: Some(get_dummy_raw_counterparty(None)),
-            version: Some(Version::default().into()),
-            delay_period: 0,
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::connection::v1::{
         Counterparty as RawCounterparty, MsgConnectionOpenInit as RawMsgConnectionOpenInit,
     };
+    use ibc_testkit::utils::core::connection::{
+        dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_init,
+    };
     use test_log::test;
 
     use super::MsgConnectionOpenInit;
-    use crate::core::ics03_connection::msgs::conn_open_init::test_util::get_dummy_raw_msg_conn_open_init;
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::prelude::*;
 
     #[test]
@@ -216,7 +150,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_init_msg = get_dummy_raw_msg_conn_open_init();
+        let default_init_msg = dummy_raw_msg_conn_open_init();
 
         let tests: Vec<Test> = vec![
             Test {
@@ -239,7 +173,7 @@ mod tests {
                         connection_id:
                             "abcdefghijksdffjssdkflweldflsfladfsfwjkrekcmmsdfsdfjflddmnopqrstu"
                                 .to_string(),
-                        ..get_dummy_raw_counterparty(None)
+                        ..dummy_raw_counterparty_conn(None)
                     }),
                     ..default_init_msg
                 },
@@ -265,7 +199,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_conn_open_init();
+        let raw = dummy_raw_msg_conn_open_init();
         let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgConnectionOpenInit::from(msg.clone());
         let msg_back = MsgConnectionOpenInit::try_from(raw_back.clone()).unwrap();
@@ -274,7 +208,7 @@ mod tests {
 
         // Check if handler sets counterparty connection id to `None`
         // in case relayer passes `MsgConnectionOpenInit` message with it set to `Some(_)`.
-        let raw_with_counterpary_conn_id_some = get_dummy_raw_msg_conn_open_init();
+        let raw_with_counterpary_conn_id_some = dummy_raw_msg_conn_open_init();
         let msg_with_counterpary_conn_id_some =
             MsgConnectionOpenInit::try_from(raw_with_counterpary_conn_id_some).unwrap();
         let raw_with_counterpary_conn_id_some_back =
@@ -299,7 +233,7 @@ mod tests {
     #[cfg(feature = "borsh")]
     #[test]
     fn test_borsh() {
-        let mut raw = get_dummy_raw_msg_conn_open_init();
+        let mut raw = dummy_raw_msg_conn_open_init();
         raw.delay_period = u64::MAX;
         let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
 
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
index 09dc56b4b..ab778f2e3 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
@@ -48,7 +48,7 @@ pub struct MsgConnectionOpenTry {
 
     #[deprecated(since = "0.22.0")]
     /// Only kept here for proper conversion to/from the raw type
-    previous_connection_id: String,
+    pub previous_connection_id: String,
 }
 
 impl Msg for MsgConnectionOpenTry {
@@ -242,89 +242,18 @@ impl From<MsgConnectionOpenTry> for RawMsgConnectionOpenTry {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
-
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::mock::client_state::MockClientState;
-    use crate::mock::header::MockHeader;
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Testing-specific helper methods.
-    impl MsgConnectionOpenTry {
-        /// Returns a new `MsgConnectionOpenTry` with dummy values.
-        pub fn new_dummy(proof_height: u64, consensus_height: u64) -> Self {
-            MsgConnectionOpenTry::try_from(get_dummy_raw_msg_conn_open_try(
-                proof_height,
-                consensus_height,
-            ))
-            .unwrap()
-        }
-        /// Setter for `client_id`.
-        pub fn with_client_id(self, client_id: ClientId) -> MsgConnectionOpenTry {
-            MsgConnectionOpenTry {
-                client_id_on_b: client_id,
-                ..self
-            }
-        }
-    }
-
-    /// Returns a dummy `RawMsgConnectionOpenTry` with parametrized heights. The parameter
-    /// `proof_height` represents the height, on the source chain, at which this chain produced the
-    /// proof. Parameter `consensus_height` represents the height of destination chain which a
-    /// client on the source chain stores.
-    pub fn get_dummy_raw_msg_conn_open_try(
-        proof_height: u64,
-        consensus_height: u64,
-    ) -> RawMsgConnectionOpenTry {
-        let client_state_height = Height::new(0, consensus_height).unwrap();
-
-        #[allow(deprecated)]
-        RawMsgConnectionOpenTry {
-            client_id: ClientId::default().to_string(),
-            previous_connection_id: ConnectionId::default().to_string(),
-            client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-            counterparty: Some(get_dummy_raw_counterparty(Some(0))),
-            delay_period: 0,
-            counterparty_versions: get_compatible_versions()
-                .iter()
-                .map(|v| v.clone().into())
-                .collect(),
-            proof_init: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            proof_consensus: get_dummy_proof(),
-            consensus_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: consensus_height,
-            }),
-            proof_client: get_dummy_proof(),
-            signer: get_dummy_bech32_account(),
-            host_consensus_state_proof: vec![],
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::{
         Counterparty as RawCounterparty, MsgConnectionOpenTry as RawMsgConnectionOpenTry,
     };
+    use ibc_testkit::utils::core::connection::{
+        dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_try,
+    };
     use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_try::test_util::get_dummy_raw_msg_conn_open_try;
     use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
     use crate::prelude::*;
 
     #[test]
@@ -336,7 +265,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_try_msg = get_dummy_raw_msg_conn_open_try(10, 34);
+        let default_try_msg = dummy_raw_msg_conn_open_try(10, 34);
 
         let tests: Vec<Test> =
             vec![
@@ -360,7 +289,7 @@ mod tests {
                             connection_id:
                             "abcdasdfasdfsdfasfdwefwfsdfsfsfasfwewvxcvdvwgadvaadsefghijklmnopqrstu"
                                 .to_string(),
-                            ..get_dummy_raw_counterparty(Some(0))
+                            ..dummy_raw_counterparty_conn(Some(0))
                         }),
                         ..default_try_msg.clone()
                     },
@@ -372,7 +301,7 @@ mod tests {
                     raw: RawMsgConnectionOpenTry {
                         counterparty: Some(RawCounterparty {
                             client_id: "ClientId_".to_string(),
-                            ..get_dummy_raw_counterparty(Some(0))
+                            ..dummy_raw_counterparty_conn(Some(0))
                         }),
                         ..default_try_msg.clone()
                     },
@@ -438,7 +367,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_conn_open_try(10, 34);
+        let raw = dummy_raw_msg_conn_open_try(10, 34);
         let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgConnectionOpenTry::from(msg.clone());
         let msg_back = MsgConnectionOpenTry::try_from(raw_back.clone()).unwrap();
@@ -450,7 +379,7 @@ mod tests {
     #[cfg(feature = "borsh")]
     #[test]
     fn test_borsh() {
-        let mut raw = get_dummy_raw_msg_conn_open_try(10, 34);
+        let mut raw = dummy_raw_msg_conn_open_try(10, 34);
         raw.delay_period = u64::MAX;
         let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
 
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 2b1c7c766..49717cde4 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -338,7 +338,7 @@ pub(crate) fn verify_connection_hops_length(
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, Default, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Counterparty {
     pub port_id: PortId,
     pub channel_id: Option<ChannelId>,
@@ -571,54 +571,20 @@ impl Display for State {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::{
-        Channel as RawChannel, Counterparty as RawCounterparty,
-    };
-
-    use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-    use crate::prelude::*;
-
-    /// Returns a dummy `RawCounterparty`, for testing only!
-    /// Can be optionally parametrized with a specific channel identifier.
-    pub fn get_dummy_raw_counterparty(channel_id: String) -> RawCounterparty {
-        RawCounterparty {
-            port_id: PortId::default().to_string(),
-            channel_id,
-        }
-    }
-
-    /// Returns a dummy `RawChannel`, for testing only!
-    pub fn get_dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel {
-        let channel_id = match channel_id {
-            Some(id) => ChannelId::new(id).to_string(),
-            None => "".to_string(),
-        };
-        RawChannel {
-            state,
-            ordering: 2,
-            counterparty: Some(get_dummy_raw_counterparty(channel_id)),
-            connection_hops: vec![ConnectionId::default().to_string()],
-            version: "".to_string(), // The version is not validated.
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use core::str::FromStr;
 
     use ibc_proto::ibc::core::channel::v1::Channel as RawChannel;
+    use ibc_testkit::utils::core::channel::dummy_raw_channel_end;
     use test_log::test;
 
-    use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
     use crate::core::ics04_channel::channel::ChannelEnd;
     use crate::prelude::*;
 
     #[test]
     fn channel_end_try_from_raw() {
-        let raw_channel_end = get_dummy_raw_channel_end(2, Some(0));
+        let raw_channel_end = dummy_raw_channel_end(2, Some(0));
 
         let empty_raw_channel_end = RawChannel {
             counterparty: None,
diff --git a/crates/ibc/src/core/ics04_channel/commitment.rs b/crates/ibc/src/core/ics04_channel/commitment.rs
index 8903f310a..67f8fbae6 100644
--- a/crates/ibc/src/core/ics04_channel/commitment.rs
+++ b/crates/ibc/src/core/ics04_channel/commitment.rs
@@ -81,7 +81,7 @@ impl From<Vec<u8>> for AcknowledgementCommitment {
 /// `{revision_number: 0, revision_height: 0}` to be consistent with ibc-go,
 /// where this value is used to mean "no timeout height":
 /// <https://github.com/cosmos/ibc-go/blob/04791984b3d6c83f704c4f058e6ca0038d155d91/modules/core/04-channel/keeper/packet.go#L206>
-pub(crate) fn compute_packet_commitment(
+pub fn compute_packet_commitment(
     packet_data: &[u8],
     timeout_height: &TimeoutHeight,
     timeout_timestamp: &Timestamp,
@@ -97,7 +97,7 @@ pub(crate) fn compute_packet_commitment(
 }
 
 /// Compute the commitment for an acknowledgement.
-pub(crate) fn compute_ack_commitment(ack: &Acknowledgement) -> AcknowledgementCommitment {
+pub fn compute_ack_commitment(ack: &Acknowledgement) -> AcknowledgementCommitment {
     hash(ack.as_ref()).to_vec().into()
 }
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
index 71b31bb78..4680e86d2 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
@@ -213,268 +213,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics02_client::ClientExecutionContext;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::commitment::PacketCommitment;
-    use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_acknowledgement;
-    use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-
-    struct Fixture {
-        ctx: MockContext,
-        router: MockRouter,
-        client_height: Height,
-        module_id: ModuleId,
-        msg: MsgAcknowledgement,
-        packet_commitment: PacketCommitment,
-        conn_end_on_a: ConnectionEnd,
-        chan_end_on_a_ordered: ChannelEnd,
-        chan_end_on_a_unordered: ChannelEnd,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let client_height = Height::new(0, 2).unwrap();
-        let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
-        let mut router = MockRouter::default();
-
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let module = DummyTransferModule::new();
-        router.add_route(module_id.clone(), module).unwrap();
-
-        let msg = MsgAcknowledgement::try_from(get_dummy_raw_msg_acknowledgement(
-            client_height.revision_height(),
-        ))
-        .unwrap();
-
-        let packet = msg.packet.clone();
-
-        let packet_commitment = compute_packet_commitment(
-            &packet.data,
-            &packet.timeout_height_on_b,
-            &packet.timeout_timestamp_on_b,
-        );
-
-        let chan_end_on_a_unordered = ChannelEnd::new(
-            State::Open,
-            Order::Unordered,
-            Counterparty::new(packet.port_id_on_b, Some(packet.chan_id_on_b)),
-            vec![ConnectionId::default()],
-            Version::new("ics20-1".to_string()),
-        )
-        .unwrap();
-
-        let mut chan_end_on_a_ordered = chan_end_on_a_unordered.clone();
-        chan_end_on_a_ordered.ordering = Order::Ordered;
-
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Open,
-            ClientId::default(),
-            ConnectionCounterparty::new(
-                ClientId::default(),
-                Some(ConnectionId::default()),
-                Default::default(),
-            ),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        Fixture {
-            ctx,
-            router,
-            client_height,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            chan_end_on_a_ordered,
-        }
-    }
-
-    #[rstest]
-    fn ack_fail_no_channel(fixture: Fixture) {
-        let Fixture { ctx, msg, .. } = fixture;
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    /// NO-OP case
-    #[rstest]
-    fn ack_success_no_packet_commitment(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            client_height,
-            ..
-        } = fixture;
-        let ctx = ctx
-            .with_client(&ClientId::default(), client_height)
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a);
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Validation should succeed when no packet commitment is present"
-        )
-    }
-
-    #[rstest]
-    fn ack_success_happy_path(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            client_height,
-            ..
-        } = fixture;
-        let mut ctx: MockContext = ctx
-            .with_client(&ClientId::default(), client_height)
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-        ctx.get_client_execution_context()
-            .store_update_time(
-                ClientId::default(),
-                client_height,
-                Timestamp::from_nanoseconds(1000).unwrap(),
-            )
-            .unwrap();
-        ctx.get_client_execution_context()
-            .store_update_height(
-                ClientId::default(),
-                client_height,
-                Height::new(0, 4).unwrap(),
-            )
-            .unwrap();
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Happy path: validation should succeed. err: {res:?}"
-        )
-    }
-
-    #[rstest]
-    fn ack_unordered_chan_execute(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut router,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            ..
-        } = fixture;
-        let mut ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = acknowledgement_packet_execute(&mut ctx, module, msg);
-
-        assert!(res.is_ok());
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
-    }
-
-    #[rstest]
-    fn ack_ordered_chan_execute(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut router,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_ordered,
-            ..
-        } = fixture;
-        let mut ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_ordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = acknowledgement_packet_execute(&mut ctx, module, msg);
-
-        assert!(res.is_ok());
-
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
index 717220339..28ce154d9 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
@@ -163,138 +163,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{
-        ChannelEnd, Counterparty, Order, State as ChannelState,
-    };
-    use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-
-    #[test]
-    fn test_chan_close_confirm_validate() {
-        let client_id = ClientId::new(mock_client_type(), 24).unwrap();
-        let conn_id = ConnectionId::new(2);
-        let default_context = MockContext::default();
-        let client_consensus_state_height = default_context.host_height().unwrap();
-
-        let conn_end = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg_chan_close_confirm = MsgChannelCloseConfirm::try_from(
-            get_dummy_raw_msg_chan_close_confirm(client_consensus_state_height.revision_height()),
-        )
-        .unwrap();
-
-        let chan_end = ChannelEnd::new(
-            ChannelState::Open,
-            Order::default(),
-            Counterparty::new(
-                msg_chan_close_confirm.port_id_on_b.clone(),
-                Some(msg_chan_close_confirm.chan_id_on_b.clone()),
-            ),
-            vec![conn_id.clone()],
-            Version::default(),
-        )
-        .unwrap();
-
-        let context = default_context
-            .with_client(&client_id, client_consensus_state_height)
-            .with_connection(conn_id, conn_end)
-            .with_channel(
-                msg_chan_close_confirm.port_id_on_b.clone(),
-                msg_chan_close_confirm.chan_id_on_b.clone(),
-                chan_end,
-            );
-
-        let res = validate(&context, &msg_chan_close_confirm);
-        assert!(
-            res.is_ok(),
-            "Validation expected to succeed (happy path). Error: {res:?}"
-        );
-    }
-
-    #[test]
-    fn test_chan_close_confirm_execute() {
-        let client_id = ClientId::new(mock_client_type(), 24).unwrap();
-        let conn_id = ConnectionId::new(2);
-        let default_context = MockContext::default();
-        let client_consensus_state_height = default_context.host_height().unwrap();
-
-        let conn_end = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg_chan_close_confirm = MsgChannelCloseConfirm::try_from(
-            get_dummy_raw_msg_chan_close_confirm(client_consensus_state_height.revision_height()),
-        )
-        .unwrap();
-
-        let chan_end = ChannelEnd::new(
-            ChannelState::Open,
-            Order::default(),
-            Counterparty::new(
-                msg_chan_close_confirm.port_id_on_b.clone(),
-                Some(msg_chan_close_confirm.chan_id_on_b.clone()),
-            ),
-            vec![conn_id.clone()],
-            Version::default(),
-        )
-        .unwrap();
-
-        let mut context = default_context
-            .with_client(&client_id, client_consensus_state_height)
-            .with_connection(conn_id, conn_end)
-            .with_channel(
-                msg_chan_close_confirm.port_id_on_b.clone(),
-                msg_chan_close_confirm.chan_id_on_b.clone(),
-                chan_end,
-            );
-        let mut router = MockRouter::default();
-
-        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = chan_close_confirm_execute(&mut context, module, msg_chan_close_confirm);
-        assert!(res.is_ok(), "Execution success: happy path");
-
-        assert_eq!(context.events.len(), 2);
-        assert!(matches!(
-            context.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(
-            context.events[1],
-            IbcEvent::CloseConfirmChannel(_)
-        ));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
index 174397672..b5856e9f6 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
@@ -121,139 +121,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{
-        ChannelEnd, Counterparty, Order, State as ChannelState,
-    };
-    use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-
-    #[test]
-    fn test_chan_close_init_validate() {
-        let client_id = ClientId::new(mock_client_type(), 24).unwrap();
-        let conn_id = ConnectionId::new(2);
-
-        let conn_end = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg_chan_close_init =
-            MsgChannelCloseInit::try_from(get_dummy_raw_msg_chan_close_init()).unwrap();
-
-        let chan_end = ChannelEnd::new(
-            ChannelState::Open,
-            Order::default(),
-            Counterparty::new(
-                msg_chan_close_init.port_id_on_a.clone(),
-                Some(msg_chan_close_init.chan_id_on_a.clone()),
-            ),
-            vec![conn_id.clone()],
-            Version::default(),
-        )
-        .unwrap();
-
-        let context = {
-            let default_context = MockContext::default();
-            let client_consensus_state_height = default_context.host_height().unwrap();
-
-            default_context
-                .with_client(&client_id, client_consensus_state_height)
-                .with_connection(conn_id, conn_end)
-                .with_channel(
-                    msg_chan_close_init.port_id_on_a.clone(),
-                    msg_chan_close_init.chan_id_on_a.clone(),
-                    chan_end,
-                )
-        };
-
-        let res = validate(&context, &msg_chan_close_init);
-        assert!(
-            res.is_ok(),
-            "Validation expected to succeed (happy path). Error: {res:?}"
-        );
-    }
-
-    #[test]
-    fn test_chan_close_init_execute() {
-        let client_id = ClientId::new(mock_client_type(), 24).unwrap();
-        let conn_id = ConnectionId::new(2);
-
-        let conn_end = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg_chan_close_init =
-            MsgChannelCloseInit::try_from(get_dummy_raw_msg_chan_close_init()).unwrap();
-
-        let chan_end = ChannelEnd::new(
-            ChannelState::Open,
-            Order::default(),
-            Counterparty::new(
-                msg_chan_close_init.port_id_on_a.clone(),
-                Some(msg_chan_close_init.chan_id_on_a.clone()),
-            ),
-            vec![conn_id.clone()],
-            Version::default(),
-        )
-        .unwrap();
-
-        let mut context = {
-            let default_context = MockContext::default();
-            let client_consensus_state_height = default_context.host_height().unwrap();
-
-            default_context
-                .with_client(&client_id, client_consensus_state_height)
-                .with_connection(conn_id, conn_end)
-                .with_channel(
-                    msg_chan_close_init.port_id_on_a.clone(),
-                    msg_chan_close_init.chan_id_on_a.clone(),
-                    chan_end,
-                )
-        };
-
-        let mut router = MockRouter::default();
-        router
-            .add_route(
-                ModuleId::new(MODULE_ID_STR.to_string()),
-                DummyTransferModule::new(),
-            )
-            .unwrap();
-        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = chan_close_init_execute(&mut context, module, msg_chan_close_init);
-        assert!(res.is_ok(), "Execution happy path");
-
-        assert_eq!(context.events.len(), 2);
-        assert!(matches!(
-            context.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(context.events[1], IbcEvent::CloseInitChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
index eb6ac5074..4267437d2 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
@@ -159,239 +159,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
-    use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-    use crate::Height;
-
-    pub struct Fixture {
-        pub context: MockContext,
-        pub router: MockRouter,
-        pub module_id: ModuleId,
-        pub msg: MsgChannelOpenAck,
-        pub client_id_on_a: ClientId,
-        pub conn_id_on_a: ConnectionId,
-        pub conn_end_on_a: ConnectionEnd,
-        pub chan_end_on_a: ChannelEnd,
-        pub proof_height: u64,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let proof_height = 10;
-        let context = MockContext::default();
-
-        let module_id = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let client_id_on_a = ClientId::new(mock_client_type(), 45).unwrap();
-        let conn_id_on_a = ConnectionId::new(2);
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id_on_a.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg =
-            MsgChannelOpenAck::try_from(get_dummy_raw_msg_chan_open_ack(proof_height)).unwrap();
-
-        let chan_end_on_a = ChannelEnd::new(
-            State::Init,
-            Order::Unordered,
-            Counterparty::new(msg.port_id_on_a.clone(), Some(msg.chan_id_on_b.clone())),
-            vec![conn_id_on_a.clone()],
-            msg.version_on_b.clone(),
-        )
-        .unwrap();
-
-        Fixture {
-            context,
-            router,
-            module_id,
-            msg,
-            client_id_on_a,
-            conn_id_on_a,
-            conn_end_on_a,
-            chan_end_on_a,
-            proof_height,
-        }
-    }
-
-    #[rstest]
-    fn chan_open_ack_fail_no_channel(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_a,
-            conn_id_on_a,
-            conn_end_on_a,
-            proof_height,
-            ..
-        } = fixture;
-        let context = context
-            .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_a, conn_end_on_a);
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_ack_fail_channel_wrong_state(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_a,
-            conn_id_on_a,
-            conn_end_on_a,
-            proof_height,
-            ..
-        } = fixture;
-
-        let wrong_chan_end = ChannelEnd::new(
-            State::Open,
-            Order::Unordered,
-            Counterparty::new(msg.port_id_on_a.clone(), Some(msg.chan_id_on_b.clone())),
-            vec![conn_id_on_a.clone()],
-            msg.version_on_b.clone(),
-        )
-        .unwrap();
-        let context = context
-            .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_a, conn_end_on_a)
-            .with_channel(
-                msg.port_id_on_a.clone(),
-                msg.chan_id_on_a.clone(),
-                wrong_chan_end,
-            );
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because channel is in the wrong state"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_ack_fail_no_connection(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_a,
-            chan_end_on_a,
-            proof_height,
-            ..
-        } = fixture;
-
-        let context = context
-            .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
-            .with_channel(
-                msg.port_id_on_a.clone(),
-                msg.chan_id_on_a.clone(),
-                chan_end_on_a,
-            );
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no connection exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_ack_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_a,
-            conn_id_on_a,
-            conn_end_on_a,
-            chan_end_on_a,
-            proof_height,
-            ..
-        } = fixture;
-
-        let context = context
-            .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_a, conn_end_on_a)
-            .with_channel(
-                msg.port_id_on_a.clone(),
-                msg.chan_id_on_a.clone(),
-                chan_end_on_a,
-            );
-
-        let res = validate(&context, &msg);
-
-        assert!(res.is_ok(), "Validation happy path")
-    }
-
-    #[rstest]
-    fn chan_open_ack_execute_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            mut router,
-            module_id,
-            msg,
-            client_id_on_a,
-            conn_id_on_a,
-            conn_end_on_a,
-            chan_end_on_a,
-            proof_height,
-            ..
-        } = fixture;
-
-        let mut context = context
-            .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_a, conn_end_on_a)
-            .with_channel(
-                msg.port_id_on_a.clone(),
-                msg.chan_id_on_a.clone(),
-                chan_end_on_a,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = chan_open_ack_execute(&mut context, module, msg);
-
-        assert!(res.is_ok(), "Execution happy path");
-
-        assert_eq!(context.events.len(), 2);
-        assert!(matches!(
-            context.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(context.events[1], IbcEvent::OpenAckChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
index 8fff0a6a9..7e5ecf93b 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
@@ -165,213 +165,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
-    use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-    use crate::Height;
-
-    pub struct Fixture {
-        pub context: MockContext,
-        pub router: MockRouter,
-        pub module_id: ModuleId,
-        pub msg: MsgChannelOpenConfirm,
-        pub client_id_on_b: ClientId,
-        pub conn_id_on_b: ConnectionId,
-        pub conn_end_on_b: ConnectionEnd,
-        pub chan_end_on_b: ChannelEnd,
-        pub proof_height: u64,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let proof_height = 10;
-        let context = MockContext::default();
-
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
-        let conn_id_on_b = ConnectionId::new(2);
-        let conn_end_on_b = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id_on_b.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let msg =
-            MsgChannelOpenConfirm::try_from(get_dummy_raw_msg_chan_open_confirm(proof_height))
-                .unwrap();
-
-        let chan_end_on_b = ChannelEnd::new(
-            State::TryOpen,
-            Order::Unordered,
-            Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
-            vec![conn_id_on_b.clone()],
-            Version::default(),
-        )
-        .unwrap();
-
-        Fixture {
-            context,
-            router,
-            module_id,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            chan_end_on_b,
-            proof_height,
-        }
-    }
-
-    #[rstest]
-    fn chan_open_confirm_fail_no_channel(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-        let context = context
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b);
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-
-        let wrong_chan_end = ChannelEnd::new(
-            State::Init,
-            Order::Unordered,
-            Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
-            vec![conn_id_on_b.clone()],
-            Version::default(),
-        )
-        .unwrap();
-        let context = context
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b)
-            .with_channel(
-                msg.port_id_on_b.clone(),
-                ChannelId::default(),
-                wrong_chan_end,
-            );
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because channel is in the wrong state"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_confirm_validate_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            chan_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-
-        let context = context
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b)
-            .with_channel(
-                msg.port_id_on_b.clone(),
-                ChannelId::default(),
-                chan_end_on_b,
-            );
-
-        let res = validate(&context, &msg);
-
-        assert!(res.is_ok(), "Validation happy path")
-    }
-
-    #[rstest]
-    fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            mut router,
-            module_id,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            chan_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-
-        let mut context = context
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b)
-            .with_channel(
-                msg.port_id_on_b.clone(),
-                ChannelId::default(),
-                chan_end_on_b,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = chan_open_confirm_execute(&mut context, module, msg);
-
-        assert!(res.is_ok(), "Execution happy path");
-
-        assert_eq!(context.events.len(), 2);
-        assert!(matches!(
-            context.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(context.events[1], IbcEvent::OpenConfirmChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
index cab961ed4..17dc77df3 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
@@ -136,129 +136,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::clients::ics07_tendermint::client_type as tm_client_type;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::{ConnectionEnd, State as ConnectionState};
-    use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::handler::chan_open_init::validate;
-    use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
-    use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-
-    pub struct Fixture {
-        pub ctx: MockContext,
-        pub router: MockRouter,
-        pub module_id: ModuleId,
-        pub msg: MsgChannelOpenInit,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let msg = MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
-
-        let default_ctx = MockContext::default();
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let msg_conn_init = MsgConnectionOpenInit::new_dummy();
-
-        let client_id_on_a = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_height = Height::new(0, 10).unwrap();
-
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Init,
-            msg_conn_init.client_id_on_a.clone(),
-            msg_conn_init.counterparty.clone(),
-            get_compatible_versions(),
-            msg_conn_init.delay_period,
-        )
-        .unwrap();
-
-        let ctx = default_ctx
-            .with_client(&client_id_on_a, client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_a);
-
-        Fixture {
-            ctx,
-            router,
-            module_id,
-            msg,
-        }
-    }
-
-    #[rstest]
-    fn chan_open_init_fail_no_connection(fixture: Fixture) {
-        let Fixture { msg, .. } = fixture;
-
-        let res = validate(&MockContext::default(), &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no connection exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_init_validate_happy_path(fixture: Fixture) {
-        let Fixture { ctx, msg, .. } = fixture;
-
-        let res = validate(&ctx, &msg);
-
-        assert!(res.is_ok(), "Validation succeeds; good parameters")
-    }
-
-    #[rstest]
-    fn chan_open_init_validate_counterparty_chan_id_set(fixture: Fixture) {
-        let Fixture { ctx, .. } = fixture;
-
-        let msg = MsgChannelOpenInit::try_from(get_dummy_raw_msg_chan_open_init(None)).unwrap();
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Validation succeeds even if counterparty channel id is set by relayer"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_init_execute_happy_path(fixture: Fixture) {
-        let Fixture {
-            mut ctx,
-            mut router,
-            module_id,
-            msg,
-        } = fixture;
-        let module = router.get_route_mut(&module_id).unwrap();
-
-        let res = chan_open_init_execute(&mut ctx, module, msg);
-
-        assert!(res.is_ok(), "Execution succeeds; good parameters");
-
-        assert_eq!(ctx.channel_counter().unwrap(), 1);
-
-        assert_eq!(ctx.events.len(), 2);
-
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenInitChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
index f140a0832..ff27b0eff 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
@@ -183,168 +183,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::msgs::test_util::get_dummy_raw_counterparty;
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
-    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-    use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::ZERO_DURATION;
-    use crate::mock::client_state::client_type as mock_client_type;
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-    use crate::Height;
-
-    pub struct Fixture {
-        pub ctx: MockContext,
-        pub router: MockRouter,
-        pub module_id: ModuleId,
-        pub msg: MsgChannelOpenTry,
-        pub client_id_on_b: ClientId,
-        pub conn_id_on_b: ConnectionId,
-        pub conn_end_on_b: ConnectionEnd,
-        pub proof_height: u64,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let proof_height = 10;
-        let conn_id_on_b = ConnectionId::new(2);
-        let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
-
-        // This is the connection underlying the channel we're trying to open.
-        let conn_end_on_b = ConnectionEnd::new(
-            ConnectionState::Open,
-            client_id_on_b.clone(),
-            ConnectionCounterparty::try_from(get_dummy_raw_counterparty(Some(0))).unwrap(),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        // We're going to test message processing against this message.
-        // Note: we make the counterparty's channel_id `None`.
-        let mut msg =
-            MsgChannelOpenTry::try_from(get_dummy_raw_msg_chan_open_try(proof_height)).unwrap();
-
-        let hops = vec![conn_id_on_b.clone()];
-        msg.connection_hops_on_b = hops;
-
-        let ctx = MockContext::default();
-
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        Fixture {
-            ctx,
-            router,
-            module_id,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            proof_height,
-        }
-    }
-
-    #[rstest]
-    fn chan_open_try_fail_no_connection(fixture: Fixture) {
-        let Fixture { ctx, msg, .. } = fixture;
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no connection exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_try_fail_no_client_state(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            conn_id_on_b,
-            conn_end_on_b,
-            ..
-        } = fixture;
-        let ctx = ctx.with_connection(conn_id_on_b, conn_end_on_b);
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because the context has no client state"
-        )
-    }
-
-    #[rstest]
-    fn chan_open_try_validate_happy_path(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-
-        let ctx = ctx
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b);
-
-        let res = validate(&ctx, &msg);
-
-        assert!(res.is_ok(), "Validation success: happy path")
-    }
-
-    #[rstest]
-    fn chan_open_try_execute_happy_path(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut router,
-            module_id,
-            msg,
-            client_id_on_b,
-            conn_id_on_b,
-            conn_end_on_b,
-            proof_height,
-            ..
-        } = fixture;
-
-        let mut ctx = ctx
-            .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
-            .with_connection(conn_id_on_b, conn_end_on_b);
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = chan_open_try_execute(&mut ctx, module, msg);
-
-        assert!(res.is_ok(), "Execution success: happy path");
-
-        assert_eq!(ctx.channel_counter().unwrap(), 1);
-
-        assert_eq!(ctx.events.len(), 2);
-
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::OpenTryChannel(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
index 1ff78ccd2..f99d184a1 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
@@ -279,246 +279,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-    use test_log::test;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics02_client::ClientExecutionContext;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
-    use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
-    use crate::mock::context::MockContext;
-    use crate::mock::ics18_relayer::context::RelayerContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::{get_dummy_account_id, DummyTransferModule};
-    use crate::Height;
-
-    pub struct Fixture {
-        pub context: MockContext,
-        pub router: MockRouter,
-        pub module_id: ModuleId,
-        pub client_height: Height,
-        pub host_height: Height,
-        pub msg: MsgRecvPacket,
-        pub conn_end_on_b: ConnectionEnd,
-        pub chan_end_on_b: ChannelEnd,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let context = MockContext::default();
-
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let host_height = context.query_latest_height().unwrap().increment();
-
-        let client_height = host_height.increment();
-
-        let msg = MsgRecvPacket::try_from(get_dummy_raw_msg_recv_packet(
-            client_height.revision_height(),
-        ))
-        .unwrap();
-
-        let packet = msg.packet.clone();
-
-        let chan_end_on_b = ChannelEnd::new(
-            State::Open,
-            Order::default(),
-            Counterparty::new(packet.port_id_on_a, Some(packet.chan_id_on_a)),
-            vec![ConnectionId::default()],
-            Version::new("ics20-1".to_string()),
-        )
-        .unwrap();
-
-        let conn_end_on_b = ConnectionEnd::new(
-            ConnectionState::Open,
-            ClientId::default(),
-            ConnectionCounterparty::new(
-                ClientId::default(),
-                Some(ConnectionId::default()),
-                Default::default(),
-            ),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        Fixture {
-            context,
-            router,
-            module_id,
-            client_height,
-            host_height,
-            msg,
-            conn_end_on_b,
-            chan_end_on_b,
-        }
-    }
-
-    #[rstest]
-    fn recv_packet_fail_no_channel(fixture: Fixture) {
-        let Fixture { context, msg, .. } = fixture;
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn recv_packet_validate_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            conn_end_on_b,
-            chan_end_on_b,
-            client_height,
-            host_height,
-            ..
-        } = fixture;
-
-        let packet = &msg.packet;
-        let mut context = context
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_b)
-            .with_channel(
-                packet.port_id_on_b.clone(),
-                packet.chan_id_on_b.clone(),
-                chan_end_on_b,
-            )
-            .with_send_sequence(
-                packet.port_id_on_b.clone(),
-                packet.chan_id_on_b.clone(),
-                1.into(),
-            )
-            .with_height(host_height)
-            // This `with_recv_sequence` is required for ordered channels
-            .with_recv_sequence(
-                packet.port_id_on_b.clone(),
-                packet.chan_id_on_b.clone(),
-                packet.seq_on_a,
-            );
-
-        context
-            .get_client_execution_context()
-            .store_update_time(
-                ClientId::default(),
-                client_height,
-                Timestamp::from_nanoseconds(1000).unwrap(),
-            )
-            .unwrap();
-        context
-            .get_client_execution_context()
-            .store_update_height(
-                ClientId::default(),
-                client_height,
-                Height::new(0, 5).unwrap(),
-            )
-            .unwrap();
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Happy path: validation should succeed. err: {res:?}"
-        )
-    }
-
-    #[rstest]
-    fn recv_packet_timeout_expired(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            conn_end_on_b,
-            chan_end_on_b,
-            client_height,
-            host_height,
-            ..
-        } = fixture;
-
-        let packet_old = Packet {
-            seq_on_a: 1.into(),
-            port_id_on_a: PortId::default(),
-            chan_id_on_a: ChannelId::default(),
-            port_id_on_b: PortId::default(),
-            chan_id_on_b: ChannelId::default(),
-            data: Vec::new(),
-            timeout_height_on_b: client_height.into(),
-            timeout_timestamp_on_b: Timestamp::from_nanoseconds(1).unwrap(),
-        };
-
-        let msg_packet_old = MsgRecvPacket::new(
-            packet_old,
-            msg.proof_commitment_on_a.clone(),
-            msg.proof_height_on_a,
-            get_dummy_account_id(),
-        );
-        let context = context
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_b)
-            .with_channel(PortId::default(), ChannelId::default(), chan_end_on_b)
-            .with_send_sequence(PortId::default(), ChannelId::default(), 1.into())
-            .with_height(host_height);
-
-        let res = validate(&context, &msg_packet_old);
-
-        assert!(
-            res.is_err(),
-            "recv_packet validation should fail when the packet has timed out"
-        )
-    }
-
-    #[rstest]
-    fn recv_packet_execute_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            mut router,
-            module_id,
-            msg,
-            conn_end_on_b,
-            chan_end_on_b,
-            client_height,
-            ..
-        } = fixture;
-        let mut ctx = context
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_b)
-            .with_channel(PortId::default(), ChannelId::default(), chan_end_on_b);
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = recv_packet_execute(&mut ctx, module, msg);
-
-        assert!(res.is_ok());
-
-        assert_eq!(ctx.events.len(), 4);
-        assert!(matches!(
-            &ctx.events[0],
-            &IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(&ctx.events[1], &IbcEvent::ReceivePacket(_)));
-        assert!(matches!(
-            &ctx.events[2],
-            &IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(&ctx.events[3], &IbcEvent::WriteAcknowledgement(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
index 023bcd88f..4a9134f57 100644
--- a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
@@ -137,194 +137,3 @@ pub fn send_packet_execute(
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use core::ops::Add;
-    use core::time::Duration;
-
-    use test_log::test;
-
-    use super::*;
-    use crate::core::events::IbcEvent;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::handler::send_packet::send_packet;
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
-    use crate::mock::context::MockContext;
-
-    #[test]
-    fn send_packet_processing() {
-        struct Test {
-            name: String,
-            ctx: MockContext,
-            packet: Packet,
-            want_pass: bool,
-        }
-
-        let context = MockContext::default();
-
-        let chan_end_on_a = ChannelEnd::new(
-            State::Open,
-            Order::default(),
-            Counterparty::new(PortId::default(), Some(ChannelId::default())),
-            vec![ConnectionId::default()],
-            Version::new("ics20-1".to_string()),
-        )
-        .unwrap();
-
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Open,
-            ClientId::default(),
-            ConnectionCounterparty::new(
-                ClientId::default(),
-                Some(ConnectionId::default()),
-                Default::default(),
-            ),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        let timestamp_future = Timestamp::now().add(Duration::from_secs(10)).unwrap();
-        let timestamp_ns_past = 1;
-
-        let timeout_height_future = 10;
-
-        let mut packet: Packet =
-            get_dummy_raw_packet(timeout_height_future, timestamp_future.nanoseconds())
-                .try_into()
-                .unwrap();
-        packet.seq_on_a = 1.into();
-        packet.data = vec![0];
-
-        let mut packet_with_timestamp_old: Packet =
-            get_dummy_raw_packet(timeout_height_future, timestamp_ns_past)
-                .try_into()
-                .unwrap();
-        packet_with_timestamp_old.seq_on_a = 1.into();
-        packet_with_timestamp_old.data = vec![0];
-
-        let client_raw_height = 5;
-        let packet_timeout_equal_client_height: Packet =
-            get_dummy_raw_packet(client_raw_height, timestamp_future.nanoseconds())
-                .try_into()
-                .unwrap();
-        let packet_timeout_one_before_client_height: Packet =
-            get_dummy_raw_packet(client_raw_height - 1, timestamp_future.nanoseconds())
-                .try_into()
-                .unwrap();
-
-        let client_height = Height::new(0, client_raw_height).unwrap();
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Processing fails because no channel exists in the context".to_string(),
-                ctx: context.clone(),
-                packet: packet.clone(),
-                want_pass: false,
-            },
-            Test {
-                name: "Good parameters".to_string(),
-                ctx: context
-                    .clone()
-                    .with_client(&ClientId::default(), client_height)
-                    .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                    .with_channel(
-                        PortId::default(),
-                        ChannelId::default(),
-                        chan_end_on_a.clone(),
-                    )
-                    .with_send_sequence(PortId::default(), ChannelId::default(), 1.into()),
-                packet,
-                want_pass: true,
-            },
-            Test {
-                name: "Packet timeout height same as destination chain height".to_string(),
-                ctx: context
-                    .clone()
-                    .with_client(&ClientId::default(), client_height)
-                    .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                    .with_channel(
-                        PortId::default(),
-                        ChannelId::default(),
-                        chan_end_on_a.clone(),
-                    )
-                    .with_send_sequence(PortId::default(), ChannelId::default(), 1.into()),
-                packet: packet_timeout_equal_client_height,
-                want_pass: true,
-            },
-            Test {
-                name: "Packet timeout height one more than destination chain height".to_string(),
-                ctx: context
-                    .clone()
-                    .with_client(&ClientId::default(), client_height)
-                    .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                    .with_channel(
-                        PortId::default(),
-                        ChannelId::default(),
-                        chan_end_on_a.clone(),
-                    )
-                    .with_send_sequence(PortId::default(), ChannelId::default(), 1.into()),
-                packet: packet_timeout_one_before_client_height,
-                want_pass: false,
-            },
-            Test {
-                name: "Packet timeout due to timestamp".to_string(),
-                ctx: context
-                    .with_client(&ClientId::default(), client_height)
-                    .with_connection(ConnectionId::default(), conn_end_on_a)
-                    .with_channel(PortId::default(), ChannelId::default(), chan_end_on_a)
-                    .with_send_sequence(PortId::default(), ChannelId::default(), 1.into()),
-                packet: packet_with_timestamp_old,
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for mut test in tests {
-            let res = send_packet(&mut test.ctx, test.packet.clone());
-            // Additionally check the events and the output objects in the result.
-            match res {
-                Ok(()) => {
-                    assert!(
-                        test.want_pass,
-                        "send_packet: test passed but was supposed to fail for test: {}, \nparams {:?} {:?}",
-                        test.name,
-                        test.packet.clone(),
-                        test.ctx.clone()
-                    );
-
-                    assert!(!test.ctx.events.is_empty()); // Some events must exist.
-
-                    assert_eq!(test.ctx.events.len(), 2);
-                    assert!(matches!(
-                        &test.ctx.events[0],
-                        &IbcEvent::Message(MessageEvent::Channel)
-                    ));
-                    // TODO: The object in the output is a PacketResult what can we check on it?
-                    assert!(matches!(&test.ctx.events[1], &IbcEvent::SendPacket(_)));
-                }
-                Err(e) => {
-                    assert!(
-                        !test.want_pass,
-                        "send_packet: did not pass test: {}, \nparams {:?} {:?} error: {:?}",
-                        test.name,
-                        test.packet.clone(),
-                        test.ctx.clone(),
-                        e,
-                    );
-                }
-            }
-        }
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
index 26b3623a0..5235f9a8c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout.rs
@@ -266,429 +266,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-
-    use super::*;
-    use crate::applications::transfer::MODULE_ID_STR;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics02_client::ClientExecutionContext;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::commitment::PacketCommitment;
-    use crate::core::ics04_channel::handler::timeout::validate;
-    use crate::core::ics04_channel::msgs::timeout::test_util::get_dummy_raw_msg_timeout;
-    use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::router::{ModuleId, Router};
-    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
-    use crate::mock::context::MockContext;
-    use crate::mock::router::MockRouter;
-    use crate::test_utils::DummyTransferModule;
-
-    struct Fixture {
-        ctx: MockContext,
-        pub router: MockRouter,
-        client_height: Height,
-        module_id: ModuleId,
-        msg: MsgTimeout,
-        packet_commitment: PacketCommitment,
-        conn_end_on_a: ConnectionEnd,
-        chan_end_on_a_ordered: ChannelEnd,
-        chan_end_on_a_unordered: ChannelEnd,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let client_height = Height::new(0, 2).unwrap();
-        let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
-
-        let client_height = Height::new(0, 2).unwrap();
-
-        let module_id: ModuleId = ModuleId::new(MODULE_ID_STR.to_string());
-        let mut router = MockRouter::default();
-        router
-            .add_route(module_id.clone(), DummyTransferModule::new())
-            .unwrap();
-
-        let msg_proof_height = 2;
-        let msg_timeout_height = 5;
-        let timeout_timestamp = Timestamp::now().nanoseconds();
-
-        let msg = MsgTimeout::try_from(get_dummy_raw_msg_timeout(
-            msg_proof_height,
-            msg_timeout_height,
-            timeout_timestamp,
-        ))
-        .unwrap();
-
-        let packet = msg.packet.clone();
-
-        let packet_commitment = compute_packet_commitment(
-            &msg.packet.data,
-            &msg.packet.timeout_height_on_b,
-            &msg.packet.timeout_timestamp_on_b,
-        );
-
-        let chan_end_on_a_unordered = ChannelEnd::new(
-            State::Open,
-            Order::Unordered,
-            Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
-            vec![ConnectionId::default()],
-            Version::new("ics20-1".to_string()),
-        )
-        .unwrap();
-
-        let mut chan_end_on_a_ordered = chan_end_on_a_unordered.clone();
-        chan_end_on_a_ordered.ordering = Order::Ordered;
-
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Open,
-            ClientId::default(),
-            ConnectionCounterparty::new(
-                ClientId::default(),
-                Some(ConnectionId::default()),
-                Default::default(),
-            ),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        Fixture {
-            ctx,
-            router,
-            client_height,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_ordered,
-            chan_end_on_a_unordered,
-        }
-    }
-
-    #[rstest]
-    fn timeout_fail_no_channel(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            client_height,
-            ..
-        } = fixture;
-        let ctx = ctx.with_client(&ClientId::default(), client_height);
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    #[rstest]
-    fn timeout_fail_no_consensus_state_for_height(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            chan_end_on_a_unordered,
-            conn_end_on_a,
-            packet_commitment,
-            ..
-        } = fixture;
-
-        let packet = msg.packet.clone();
-
-        let ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                packet.port_id_on_a,
-                packet.chan_id_on_a,
-                packet.seq_on_a,
-                packet_commitment,
-            );
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because the client does not have a consensus state for the required height"
-        )
-    }
-
-    #[rstest]
-    fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut msg,
-            chan_end_on_a_unordered,
-            conn_end_on_a,
-            client_height,
-            ..
-        } = fixture;
-
-        // timeout timestamp has not reached yet
-        let timeout_timestamp_on_b =
-            (msg.packet.timeout_timestamp_on_b + core::time::Duration::new(10, 0)).unwrap();
-        msg.packet.timeout_timestamp_on_b = timeout_timestamp_on_b;
-        let packet_commitment = compute_packet_commitment(
-            &msg.packet.data,
-            &msg.packet.timeout_height_on_b,
-            &msg.packet.timeout_timestamp_on_b,
-        );
-
-        let packet = msg.packet.clone();
-
-        let mut ctx = ctx
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_packet_commitment(
-                packet.port_id_on_a,
-                packet.chan_id_on_a,
-                packet.seq_on_a,
-                packet_commitment,
-            );
-
-        ctx.store_update_time(
-            ClientId::default(),
-            client_height,
-            Timestamp::from_nanoseconds(5).unwrap(),
-        )
-        .unwrap();
-        ctx.store_update_height(
-            ClientId::default(),
-            client_height,
-            Height::new(0, 4).unwrap(),
-        )
-        .unwrap();
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation should fail because the timeout height was reached, but the timestamp hasn't been reached. Both the height and timestamp need to be reached for the packet to be considered timed out"
-        )
-    }
-
-    /// NO-OP case
-    #[rstest]
-    fn timeout_success_no_packet_commitment(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            ..
-        } = fixture;
-        let ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a);
-
-        let res = validate(&ctx, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Validation should succeed when no packet commitment is present"
-        )
-    }
-
-    #[rstest]
-    fn timeout_unordered_channel_validate(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            chan_end_on_a_unordered,
-            conn_end_on_a,
-            packet_commitment,
-            client_height,
-            ..
-        } = fixture;
-
-        let packet = msg.packet.clone();
-
-        let mut ctx = ctx
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_packet_commitment(
-                packet.port_id_on_a,
-                packet.chan_id_on_a,
-                packet.seq_on_a,
-                packet_commitment,
-            );
-
-        ctx.get_client_execution_context()
-            .store_update_time(
-                ClientId::default(),
-                client_height,
-                Timestamp::from_nanoseconds(1000).unwrap(),
-            )
-            .unwrap();
-        ctx.get_client_execution_context()
-            .store_update_height(
-                ClientId::default(),
-                client_height,
-                Height::new(0, 5).unwrap(),
-            )
-            .unwrap();
-
-        let res = validate(&ctx, &msg);
-
-        assert!(res.is_ok(), "Good parameters for unordered channels")
-    }
-
-    #[rstest]
-    fn timeout_ordered_channel_validate(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            msg,
-            chan_end_on_a_ordered,
-            conn_end_on_a,
-            packet_commitment,
-            client_height,
-            ..
-        } = fixture;
-
-        let packet = msg.packet.clone();
-
-        let mut ctx = ctx
-            .with_client(&ClientId::default(), client_height)
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_ordered,
-            )
-            .with_packet_commitment(
-                packet.port_id_on_a,
-                packet.chan_id_on_a,
-                packet.seq_on_a,
-                packet_commitment,
-            );
-
-        ctx.store_update_time(
-            ClientId::default(),
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-        ctx.store_update_height(
-            ClientId::default(),
-            client_height,
-            Height::new(0, 4).unwrap(),
-        )
-        .unwrap();
-
-        let res = validate(&ctx, &msg);
-
-        assert!(res.is_ok(), "Good parameters for unordered channels")
-    }
-
-    #[rstest]
-    fn timeout_unordered_chan_execute(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut router,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_unordered,
-            ..
-        } = fixture;
-        let mut ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_unordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = timeout_packet_execute(&mut ctx, module, TimeoutMsgType::Timeout(msg));
-
-        assert!(res.is_ok());
-
-        // Unordered channels only emit one event
-        assert_eq!(ctx.events.len(), 2);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
-    }
-
-    #[rstest]
-    fn timeout_ordered_chan_execute(fixture: Fixture) {
-        let Fixture {
-            ctx,
-            mut router,
-            module_id,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a_ordered,
-            ..
-        } = fixture;
-        let mut ctx = ctx
-            .with_channel(
-                PortId::default(),
-                ChannelId::default(),
-                chan_end_on_a_ordered,
-            )
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-
-        let module = router.get_route_mut(&module_id).unwrap();
-        let res = timeout_packet_execute(&mut ctx, module, TimeoutMsgType::Timeout(msg));
-
-        assert!(res.is_ok());
-
-        // Ordered channels emit 2 events
-        assert_eq!(ctx.events.len(), 4);
-        assert!(matches!(
-            ctx.events[0],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
-        assert!(matches!(
-            ctx.events[2],
-            IbcEvent::Message(MessageEvent::Channel)
-        ));
-        assert!(matches!(ctx.events[3], IbcEvent::ChannelClosed(_)));
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
index 509d1380c..cb0a9b40a 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
@@ -170,166 +170,3 @@ where
 
     Ok(())
 }
-
-#[cfg(test)]
-mod tests {
-    use rstest::*;
-
-    use crate::core::ics02_client::ClientExecutionContext;
-    use crate::core::ics03_connection::connection::{
-        ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
-    };
-    use crate::core::ics03_connection::version::get_compatible_versions;
-    use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-    use crate::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
-    use crate::core::ics04_channel::handler::timeout_on_close::validate;
-    use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
-    use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-    use crate::core::ics04_channel::Version;
-    use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-    use crate::core::timestamp::{Timestamp, ZERO_DURATION};
-    use crate::core::ExecutionContext;
-    use crate::mock::context::MockContext;
-    use crate::prelude::*;
-    use crate::Height;
-
-    pub struct Fixture {
-        pub context: MockContext,
-        pub msg: MsgTimeoutOnClose,
-        pub packet_commitment: PacketCommitment,
-        pub conn_end_on_a: ConnectionEnd,
-        pub chan_end_on_a: ChannelEnd,
-    }
-
-    #[fixture]
-    fn fixture() -> Fixture {
-        let client_height = Height::new(0, 2).unwrap();
-        let context = MockContext::default().with_client(&ClientId::default(), client_height);
-
-        let height = 2;
-        let timeout_timestamp = 5;
-
-        let msg = MsgTimeoutOnClose::try_from(get_dummy_raw_msg_timeout_on_close(
-            height,
-            timeout_timestamp,
-        ))
-        .unwrap();
-
-        let packet = msg.packet.clone();
-
-        let packet_commitment = compute_packet_commitment(
-            &msg.packet.data,
-            &msg.packet.timeout_height_on_b,
-            &msg.packet.timeout_timestamp_on_b,
-        );
-
-        let chan_end_on_a = ChannelEnd::new(
-            State::Open,
-            Order::Ordered,
-            Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
-            vec![ConnectionId::default()],
-            Version::new("ics20-1".to_string()),
-        )
-        .unwrap();
-
-        let conn_end_on_a = ConnectionEnd::new(
-            ConnectionState::Open,
-            ClientId::default(),
-            ConnectionCounterparty::new(
-                ClientId::default(),
-                Some(ConnectionId::default()),
-                Default::default(),
-            ),
-            get_compatible_versions(),
-            ZERO_DURATION,
-        )
-        .unwrap();
-
-        Fixture {
-            context,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a,
-        }
-    }
-
-    #[rstest]
-    fn timeout_on_close_fail_no_channel(fixture: Fixture) {
-        let Fixture { context, msg, .. } = fixture;
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_err(),
-            "Validation fails because no channel exists in the context"
-        )
-    }
-
-    /// NO-OP case
-    #[rstest]
-    fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            conn_end_on_a,
-            chan_end_on_a,
-            ..
-        } = fixture;
-        let context = context
-            .with_channel(PortId::default(), ChannelId::default(), chan_end_on_a)
-            .with_connection(ConnectionId::default(), conn_end_on_a);
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Validation should succeed when no packet commitment is present"
-        )
-    }
-
-    #[rstest]
-    fn timeout_on_close_success_happy_path(fixture: Fixture) {
-        let Fixture {
-            context,
-            msg,
-            packet_commitment,
-            conn_end_on_a,
-            chan_end_on_a,
-            ..
-        } = fixture;
-        let mut context = context
-            .with_channel(PortId::default(), ChannelId::default(), chan_end_on_a)
-            .with_connection(ConnectionId::default(), conn_end_on_a)
-            .with_packet_commitment(
-                msg.packet.port_id_on_a.clone(),
-                msg.packet.chan_id_on_a.clone(),
-                msg.packet.seq_on_a,
-                packet_commitment,
-            );
-
-        context
-            .get_client_execution_context()
-            .store_update_time(
-                ClientId::default(),
-                Height::new(0, 2).unwrap(),
-                Timestamp::from_nanoseconds(5000).unwrap(),
-            )
-            .unwrap();
-        context
-            .get_client_execution_context()
-            .store_update_height(
-                ClientId::default(),
-                Height::new(0, 2).unwrap(),
-                Height::new(0, 5).unwrap(),
-            )
-            .unwrap();
-
-        let res = validate(&context, &msg);
-
-        assert!(
-            res.is_ok(),
-            "Happy path: validation should succeed. err: {res:?}"
-        )
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/crates/ibc/src/core/ics04_channel/msgs.rs
index 392a0c988..4b8c39bda 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs.rs
@@ -3,16 +3,16 @@
 
 use crate::prelude::*;
 
-pub(crate) mod acknowledgement;
-pub(crate) mod chan_close_confirm;
-pub(crate) mod chan_close_init;
-pub(crate) mod chan_open_ack;
-pub(crate) mod chan_open_confirm;
-pub(crate) mod chan_open_init;
-pub(crate) mod chan_open_try;
-pub(crate) mod recv_packet;
-pub(crate) mod timeout;
-pub(crate) mod timeout_on_close;
+pub mod acknowledgement;
+pub mod chan_close_confirm;
+pub mod chan_close_init;
+pub mod chan_open_ack;
+pub mod chan_open_confirm;
+pub mod chan_open_init;
+pub mod chan_open_try;
+pub mod recv_packet;
+pub mod timeout;
+pub mod timeout_on_close;
 
 // Opening handshake messages.
 // Packet specific messages.
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
index 7612f34a0..7195be630 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
@@ -76,49 +76,16 @@ impl From<MsgAcknowledgement> for RawMsgAcknowledgement {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::{
-        MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
-    };
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgAcknowledgement`, for testing only!
-    /// The `height` parametrizes both the proof height as well as the timeout height.
-    pub fn get_dummy_raw_msg_acknowledgement(height: u64) -> RawMsgAcknowledgement {
-        get_dummy_raw_msg_ack_with_packet(get_dummy_raw_packet(height, 1), height)
-    }
-
-    pub fn get_dummy_raw_msg_ack_with_packet(
-        packet: RawPacket,
-        height: u64,
-    ) -> RawMsgAcknowledgement {
-        RawMsgAcknowledgement {
-            packet: Some(packet),
-            acknowledgement: get_dummy_proof(),
-            proof_acked: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod test {
     use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
+    use ibc_testkit::utils::core::signer::dummy_bech32_account;
     use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::acknowledgement::test_util::get_dummy_raw_msg_acknowledgement;
     use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
     use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
     fn msg_acknowledgment_try_from_raw() {
@@ -129,7 +96,7 @@ mod test {
         }
 
         let height = 50;
-        let default_raw_msg = get_dummy_raw_msg_acknowledgement(height);
+        let default_raw_msg = dummy_raw_msg_acknowledgement(height);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -156,7 +123,7 @@ mod test {
             Test {
                 name: "Empty signer".to_string(),
                 raw: RawMsgAcknowledgement {
-                    signer: get_dummy_bech32_account(),
+                    signer: dummy_bech32_account(),
                     ..default_raw_msg.clone()
                 },
                 want_pass: true,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
index d183db53d..d9c9867c1 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
@@ -72,36 +72,12 @@ impl From<MsgChannelCloseConfirm> for RawMsgChannelCloseConfirm {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
-    use ibc_proto::ibc::core::client::v1::Height;
-
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgChannelCloseConfirm`, for testing only!
-    pub fn get_dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelCloseConfirm {
-        RawMsgChannelCloseConfirm {
-            port_id: PortId::default().to_string(),
-            channel_id: ChannelId::default().to_string(),
-            proof_init: get_dummy_proof(),
-            proof_height: Some(Height {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_confirm;
 
-    use crate::core::ics04_channel::msgs::chan_close_confirm::test_util::get_dummy_raw_msg_chan_close_confirm;
     use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
     use crate::prelude::*;
 
@@ -114,7 +90,7 @@ mod tests {
         }
 
         let proof_height = 10;
-        let default_raw_msg = get_dummy_raw_msg_chan_close_confirm(proof_height);
+        let default_raw_msg = dummy_raw_msg_chan_close_confirm(proof_height);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -205,7 +181,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_chan_close_confirm(19);
+        let raw = dummy_raw_msg_chan_close_confirm(19);
         let msg = MsgChannelCloseConfirm::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelCloseConfirm::from(msg.clone());
         let msg_back = MsgChannelCloseConfirm::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
index 7f0c1e04f..dbbea054b 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
@@ -57,30 +57,12 @@ impl From<MsgChannelCloseInit> for RawMsgChannelCloseInit {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
-
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-    use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
-
-    /// Returns a dummy `RawMsgChannelCloseInit`, for testing only!
-    pub fn get_dummy_raw_msg_chan_close_init() -> RawMsgChannelCloseInit {
-        RawMsgChannelCloseInit {
-            port_id: PortId::default().to_string(),
-            channel_id: ChannelId::default().to_string(),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_init;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_close_init::test_util::get_dummy_raw_msg_chan_close_init;
     use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
     use crate::prelude::*;
 
@@ -92,7 +74,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_raw_msg = get_dummy_raw_msg_chan_close_init();
+        let default_raw_msg = dummy_raw_msg_chan_close_init();
 
         let tests: Vec<Test> = vec![
             Test {
@@ -168,7 +150,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_chan_close_init();
+        let raw = dummy_raw_msg_chan_close_init();
         let msg = MsgChannelCloseInit::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelCloseInit::from(msg.clone());
         let msg_back = MsgChannelCloseInit::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
index 3b230d1c9..65bbb1f4b 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
@@ -77,39 +77,13 @@ impl From<MsgChannelOpenAck> for RawMsgChannelOpenAck {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-    use ibc_proto::ibc::core::client::v1::Height;
-
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgChannelOpenAck`, for testing only!
-    pub fn get_dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
-        RawMsgChannelOpenAck {
-            port_id: PortId::default().to_string(),
-            channel_id: ChannelId::default().to_string(),
-            counterparty_channel_id: ChannelId::default().to_string(),
-            counterparty_version: "".to_string(),
-            proof_try: get_dummy_proof(),
-            proof_height: Some(Height {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
     use ibc_proto::ibc::core::client::v1::Height;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_ack;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_ack::test_util::get_dummy_raw_msg_chan_open_ack;
     use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
     use crate::prelude::*;
 
@@ -122,7 +96,7 @@ mod tests {
         }
 
         let proof_height = 20;
-        let default_raw_msg = get_dummy_raw_msg_chan_open_ack(proof_height);
+        let default_raw_msg = dummy_raw_msg_chan_open_ack(proof_height);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -265,7 +239,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_chan_open_ack(100);
+        let raw = dummy_raw_msg_chan_open_ack(100);
         let msg = MsgChannelOpenAck::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelOpenAck::from(msg.clone());
         let msg_back = MsgChannelOpenAck::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
index 86e208e77..01a03e16e 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
@@ -72,37 +72,13 @@ impl From<MsgChannelOpenConfirm> for RawMsgChannelOpenConfirm {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-    use ibc_proto::ibc::core::client::v1::Height;
-
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgChannelOpenConfirm`, for testing only!
-    pub fn get_dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
-        RawMsgChannelOpenConfirm {
-            port_id: PortId::default().to_string(),
-            channel_id: ChannelId::default().to_string(),
-            proof_ack: get_dummy_proof(),
-            proof_height: Some(Height {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_confirm;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_confirm::test_util::get_dummy_raw_msg_chan_open_confirm;
     use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
     use crate::prelude::*;
 
@@ -115,7 +91,7 @@ mod tests {
         }
 
         let proof_height = 78;
-        let default_raw_msg = get_dummy_raw_msg_chan_open_confirm(proof_height);
+        let default_raw_msg = dummy_raw_msg_chan_open_confirm(proof_height);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -210,7 +186,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_chan_open_confirm(19);
+        let raw = dummy_raw_msg_chan_open_confirm(19);
         let msg = MsgChannelOpenConfirm::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelOpenConfirm::from(msg.clone());
         let msg_back = MsgChannelOpenConfirm::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index b16c27525..c9bc91718 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -91,33 +91,12 @@ impl From<MsgChannelOpenInit> for RawMsgChannelOpenInit {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-
-    use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
-    use crate::core::ics24_host::identifier::PortId;
-    use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
-
-    /// Returns a dummy `RawMsgChannelOpenInit`, for testing only!
-    pub fn get_dummy_raw_msg_chan_open_init(
-        counterparty_channel_id: Option<u64>,
-    ) -> RawMsgChannelOpenInit {
-        RawMsgChannelOpenInit {
-            port_id: PortId::default().to_string(),
-            channel: Some(get_dummy_raw_channel_end(1, counterparty_channel_id)),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_init::test_util::get_dummy_raw_msg_chan_open_init;
     use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
     use crate::prelude::*;
 
@@ -129,7 +108,7 @@ mod tests {
             want_pass: bool,
         }
 
-        let default_raw_init_msg = get_dummy_raw_msg_chan_open_init(None);
+        let default_raw_init_msg = dummy_raw_msg_chan_open_init(None);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -174,7 +153,7 @@ mod tests {
     #[test]
     fn to_and_from() {
         // Check if raw and domain types are equal after conversions
-        let raw = get_dummy_raw_msg_chan_open_init(None);
+        let raw = dummy_raw_msg_chan_open_init(None);
         let msg = MsgChannelOpenInit::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelOpenInit::from(msg.clone());
         let msg_back = MsgChannelOpenInit::try_from(raw_back.clone()).unwrap();
@@ -183,7 +162,7 @@ mod tests {
 
         // Check if handler sets counterparty channel id to `None`
         // in case relayer passes `MsgChannelOpenInit` message with it set to `Some(_)`
-        let raw_with_counterpary_chan_id_some = get_dummy_raw_msg_chan_open_init(None);
+        let raw_with_counterpary_chan_id_some = dummy_raw_msg_chan_open_init(None);
         let msg_with_counterpary_chan_id_some =
             MsgChannelOpenInit::try_from(raw_with_counterpary_chan_id_some).unwrap();
         let raw_with_counterpary_chan_id_some_back =
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
index 3eca4a0c4..ae9c60fc2 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
@@ -128,41 +128,13 @@ impl From<MsgChannelOpenTry> for RawMsgChannelOpenTry {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-    use ibc_proto::ibc::core::client::v1::Height;
-
-    use crate::core::ics04_channel::channel::test_util::get_dummy_raw_channel_end;
-    use crate::core::ics24_host::identifier::PortId;
-    use crate::prelude::*;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgChannelOpenTry`, for testing only!
-    pub fn get_dummy_raw_msg_chan_open_try(proof_height: u64) -> RawMsgChannelOpenTry {
-        #[allow(deprecated)]
-        RawMsgChannelOpenTry {
-            port_id: PortId::default().to_string(),
-            previous_channel_id: "".to_string(),
-            channel: Some(get_dummy_raw_channel_end(2, Some(0))),
-            counterparty_version: "".to_string(),
-            proof_init: get_dummy_proof(),
-            proof_height: Some(Height {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
     use ibc_proto::ibc::core::client::v1::Height;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_try;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_try::test_util::get_dummy_raw_msg_chan_open_try;
     use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
     use crate::prelude::*;
 
@@ -175,7 +147,7 @@ mod tests {
         }
 
         let proof_height = 10;
-        let default_raw_msg = get_dummy_raw_msg_chan_open_try(proof_height);
+        let default_raw_msg = dummy_raw_msg_chan_open_try(proof_height);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -270,7 +242,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_chan_open_try(10);
+        let raw = dummy_raw_msg_chan_open_try(10);
         let msg = MsgChannelOpenTry::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgChannelOpenTry::from(msg.clone());
         let msg_back = MsgChannelOpenTry::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
index a39f1ec10..91bebda00 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
@@ -74,67 +74,16 @@ impl From<MsgRecvPacket> for RawMsgRecvPacket {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use core::ops::Add;
-    use core::time::Duration;
-
-    use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-
-    use super::MsgRecvPacket;
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-    use crate::core::timestamp::Timestamp;
-    use crate::signer::Signer;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    impl MsgRecvPacket {
-        pub fn new(
-            packet: Packet,
-            proof_commitment_on_a: CommitmentProofBytes,
-            proof_height_on_a: crate::Height,
-            signer: Signer,
-        ) -> MsgRecvPacket {
-            Self {
-                packet,
-                proof_commitment_on_a,
-                proof_height_on_a,
-                signer,
-            }
-        }
-    }
-
-    /// Returns a dummy `RawMsgRecvPacket`, for testing only! The `height` parametrizes both the
-    /// proof height as well as the timeout height.
-    pub fn get_dummy_raw_msg_recv_packet(height: u64) -> RawMsgRecvPacket {
-        let timestamp = Timestamp::now().add(Duration::from_secs(9));
-        RawMsgRecvPacket {
-            packet: Some(get_dummy_raw_packet(
-                height,
-                timestamp.unwrap().nanoseconds(),
-            )),
-            proof_commitment: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: height,
-            }),
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod test {
     use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_recv_packet;
+    use ibc_testkit::utils::core::signer::dummy_bech32_account;
     use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::recv_packet::test_util::get_dummy_raw_msg_recv_packet;
     use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
     use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
     fn msg_recv_packet_try_from_raw() {
@@ -145,7 +94,7 @@ mod test {
         }
 
         let height = 20;
-        let default_raw_msg = get_dummy_raw_msg_recv_packet(height);
+        let default_raw_msg = dummy_raw_msg_recv_packet(height);
         let tests: Vec<Test> = vec![
             Test {
                 name: "Good parameters".to_string(),
@@ -171,7 +120,7 @@ mod test {
             Test {
                 name: "Empty signer".to_string(),
                 raw: RawMsgRecvPacket {
-                    signer: get_dummy_bech32_account(),
+                    signer: dummy_bech32_account(),
                     ..default_raw_msg
                 },
                 want_pass: true,
@@ -194,7 +143,7 @@ mod test {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_recv_packet(15);
+        let raw = dummy_raw_msg_recv_packet(15);
         let msg = MsgRecvPacket::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgRecvPacket::from(msg.clone());
         let msg_back = MsgRecvPacket::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
index 6f854d70a..55dd4bc62 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
@@ -77,44 +77,16 @@ impl From<MsgTimeout> for RawMsgTimeout {
     }
 }
 
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgTimeout`, for testing only!
-    /// The `height` parametrizes both the proof height as well as the timeout height.
-    pub fn get_dummy_raw_msg_timeout(
-        proof_height: u64,
-        timeout_height: u64,
-        timeout_timestamp: u64,
-    ) -> RawMsgTimeout {
-        RawMsgTimeout {
-            packet: Some(get_dummy_raw_packet(timeout_height, timeout_timestamp)),
-            proof_unreceived: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: proof_height,
-            }),
-            next_sequence_recv: 1,
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
-
 #[cfg(test)]
 mod test {
     use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
+    use ibc_testkit::utils::core::signer::dummy_bech32_account;
     use test_log::test;
 
     use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::timeout::test_util::get_dummy_raw_msg_timeout;
     use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
     use crate::prelude::*;
-    use crate::test_utils::get_dummy_bech32_account;
 
     #[test]
     fn msg_timeout_try_from_raw() {
@@ -128,7 +100,7 @@ mod test {
         let timeout_height = proof_height;
         let timeout_timestamp = 0;
         let default_raw_msg =
-            get_dummy_raw_msg_timeout(proof_height, timeout_height, timeout_timestamp);
+            dummy_raw_msg_timeout(proof_height, timeout_height, timeout_timestamp);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -163,7 +135,7 @@ mod test {
             Test {
                 name: "Empty signer".to_string(),
                 raw: RawMsgTimeout {
-                    signer: get_dummy_bech32_account(),
+                    signer: dummy_bech32_account(),
                     ..default_raw_msg
                 },
                 want_pass: true,
@@ -186,7 +158,8 @@ mod test {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_msg_timeout(15, 20, 0);
+        let dummy_raw_msg_timeout = dummy_raw_msg_timeout(15, 20, 0);
+        let raw = dummy_raw_msg_timeout;
         let msg = MsgTimeout::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgTimeout::from(msg.clone());
         let msg_back = MsgTimeout::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
index 74bd6de8c..c590e2bf2 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
@@ -86,9 +86,9 @@ impl From<MsgTimeoutOnClose> for RawMsgTimeoutOnClose {
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
+    use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
     use test_log::test;
 
-    use crate::core::ics04_channel::msgs::timeout_on_close::test_util::get_dummy_raw_msg_timeout_on_close;
     use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
     use crate::prelude::*;
 
@@ -96,7 +96,7 @@ mod tests {
     fn msg_timeout_on_close_try_from_raw() {
         let height = 50;
         let timeout_timestamp = 5;
-        let raw = get_dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
+        let raw = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
 
         let msg = MsgTimeoutOnClose::try_from(raw.clone()).unwrap();
         let raw_back = RawMsgTimeoutOnClose::from(msg);
@@ -113,7 +113,7 @@ mod tests {
 
         let height = 50;
         let timeout_timestamp = 5;
-        let default_raw_msg = get_dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
+        let default_raw_msg = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
 
         let tests: Vec<Test> = vec![
             Test {
@@ -169,31 +169,3 @@ mod tests {
         }
     }
 }
-
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
-    use crate::test_utils::{get_dummy_bech32_account, get_dummy_proof};
-
-    /// Returns a dummy `RawMsgTimeoutOnClose`, for testing only!
-    /// The `height` parametrizes both the proof height as well as the timeout height.
-    pub fn get_dummy_raw_msg_timeout_on_close(
-        height: u64,
-        timeout_timestamp: u64,
-    ) -> RawMsgTimeoutOnClose {
-        RawMsgTimeoutOnClose {
-            packet: Some(get_dummy_raw_packet(height, timeout_timestamp)),
-            proof_unreceived: get_dummy_proof(),
-            proof_close: get_dummy_proof(),
-            proof_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: height,
-            }),
-            next_sequence_recv: 1,
-            signer: get_dummy_bech32_account(),
-        }
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/crates/ibc/src/core/ics04_channel/packet.rs
index b1914dcbf..eba1ca8e9 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/crates/ibc/src/core/ics04_channel/packet.rs
@@ -129,7 +129,7 @@ impl core::fmt::Display for Sequence {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Default, Hash, PartialEq, Eq)]
+#[derive(Clone, Hash, PartialEq, Eq)]
 pub struct Packet {
     pub seq_on_a: Sequence,
     pub port_id_on_a: PortId,
@@ -304,7 +304,7 @@ impl From<Packet> for RawPacket {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Default, Hash, PartialEq, Eq)]
+#[derive(Clone, Hash, PartialEq, Eq)]
 pub struct PacketState {
     pub port_id: PortId,
     pub chan_id: ChannelId,
@@ -372,39 +372,13 @@ impl From<PacketState> for RawPacketState {
     }
 }
 
-#[cfg(test)]
-pub mod test_utils {
-    use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-
-    use crate::core::ics24_host::identifier::{ChannelId, PortId};
-    use crate::prelude::*;
-
-    /// Returns a dummy `RawPacket`, for testing only!
-    pub fn get_dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacket {
-        RawPacket {
-            sequence: 1,
-            source_port: PortId::default().to_string(),
-            source_channel: ChannelId::default().to_string(),
-            destination_port: PortId::default().to_string(),
-            destination_channel: ChannelId::default().to_string(),
-            data: vec![0],
-            timeout_height: Some(RawHeight {
-                revision_number: 0,
-                revision_height: timeout_height,
-            }),
-            timeout_timestamp,
-        }
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+    use ibc_testkit::utils::core::channel::dummy_raw_packet;
     use test_log::test;
 
-    use crate::core::ics04_channel::packet::test_utils::get_dummy_raw_packet;
     use crate::core::ics04_channel::packet::Packet;
     use crate::prelude::*;
 
@@ -417,10 +391,10 @@ mod tests {
         }
 
         let proof_height = 10;
-        let default_raw_packet = get_dummy_raw_packet(proof_height, 1000);
-        let raw_packet_no_timeout_or_timestamp = get_dummy_raw_packet(10, 0);
+        let default_raw_packet = dummy_raw_packet(proof_height, 1000);
+        let raw_packet_no_timeout_or_timestamp = dummy_raw_packet(10, 0);
 
-        let mut raw_packet_invalid_timeout_height = get_dummy_raw_packet(0, 10);
+        let mut raw_packet_invalid_timeout_height = dummy_raw_packet(0, 10);
         raw_packet_invalid_timeout_height.timeout_height = Some(RawHeight {
             revision_number: 1,
             revision_height: 0,
@@ -581,7 +555,7 @@ mod tests {
 
     #[test]
     fn to_and_from() {
-        let raw = get_dummy_raw_packet(15, 0);
+        let raw = dummy_raw_packet(15, 0);
         let msg = Packet::try_from(raw.clone()).unwrap();
         let raw_back = RawPacket::from(msg.clone());
         let msg_back = Packet::try_from(raw_back.clone()).unwrap();
diff --git a/crates/ibc/src/core/ics23_commitment/commitment.rs b/crates/ibc/src/core/ics23_commitment/commitment.rs
index 46c4d8150..556f58458 100644
--- a/crates/ibc/src/core/ics23_commitment/commitment.rs
+++ b/crates/ibc/src/core/ics23_commitment/commitment.rs
@@ -198,20 +198,3 @@ impl serde::Serialize for CommitmentPrefix {
         format!("{self:?}").serialize(serializer)
     }
 }
-
-#[cfg(test)]
-pub mod test_util {
-    use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
-    use ibc_proto::ics23::CommitmentProof;
-
-    use super::CommitmentProofBytes;
-    use crate::prelude::*;
-
-    /// Returns a dummy `CommitmentProofBytes`, for testing only!
-    pub fn get_dummy_commitment_proof_bytes() -> CommitmentProofBytes {
-        let parsed = CommitmentProof { proof: None };
-        let mproofs: Vec<CommitmentProof> = vec![parsed];
-        let raw_mp = RawMerkleProof { proofs: mproofs };
-        raw_mp.try_into().unwrap()
-    }
-}
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
index a822d5715..8b7943847 100644
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ b/crates/ibc/src/core/ics24_host/identifier.rs
@@ -15,7 +15,6 @@ use crate::prelude::*;
 const CONNECTION_ID_PREFIX: &str = "connection";
 const CHANNEL_ID_PREFIX: &str = "channel";
 
-const DEFAULT_PORT_ID: &str = "defaultPort";
 const TRANSFER_PORT_ID: &str = "transfer";
 
 /// Defines the domain type for chain identifiers.
@@ -416,12 +415,6 @@ impl AsRef<str> for PortId {
     }
 }
 
-impl Default for PortId {
-    fn default() -> Self {
-        Self(DEFAULT_PORT_ID.to_string())
-    }
-}
-
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
diff --git a/crates/ibc/src/core/ics24_host/path.rs b/crates/ibc/src/core/ics24_host/path.rs
index c01eb5797..6630abbf0 100644
--- a/crates/ibc/src/core/ics24_host/path.rs
+++ b/crates/ibc/src/core/ics24_host/path.rs
@@ -933,22 +933,22 @@ mod tests {
 
     #[test]
     fn test_parse_ports_fn() {
-        let path = "ports/defaultPort";
+        let path = "ports/transfer";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_ports(&components),
-            Some(Path::Ports(PortPath(PortId::default()))),
+            Some(Path::Ports(PortPath(PortId::transfer()))),
         );
     }
 
     #[test]
     fn ports_path_parses() {
-        let path = "ports/defaultPort";
+        let path = "ports/transfer";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
-        assert_eq!(path.unwrap(), Path::Ports(PortPath(PortId::default())));
+        assert_eq!(path.unwrap(), Path::Ports(PortPath(PortId::transfer())));
     }
 
     #[test]
@@ -991,13 +991,13 @@ mod tests {
 
     #[test]
     fn test_parse_channel_ends_fn() {
-        let path = "channelEnds/ports/defaultPort/channels/channel-0";
+        let path = "channelEnds/ports/transfer/channels/channel-0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_channel_ends(&components),
             Some(Path::ChannelEnd(ChannelEndPath(
-                PortId::default(),
+                PortId::transfer(),
                 ChannelId::default()
             ))),
         );
@@ -1005,47 +1005,47 @@ mod tests {
 
     #[test]
     fn channel_ends_path_parses() {
-        let path = "channelEnds/ports/defaultPort/channels/channel-0";
+        let path = "channelEnds/ports/transfer/channels/channel-0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
-            Path::ChannelEnd(ChannelEndPath(PortId::default(), ChannelId::default())),
+            Path::ChannelEnd(ChannelEndPath(PortId::transfer(), ChannelId::default())),
         );
     }
 
     #[test]
     fn test_parse_seqs_fn() {
-        let path = "nextSequenceSend/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceSend/ports/transfer/channels/channel-0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_seqs(&components),
             Some(Path::SeqSend(SeqSendPath(
-                PortId::default(),
+                PortId::transfer(),
                 ChannelId::default()
             ))),
         );
 
-        let path = "nextSequenceRecv/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceRecv/ports/transfer/channels/channel-0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_seqs(&components),
             Some(Path::SeqRecv(SeqRecvPath(
-                PortId::default(),
+                PortId::transfer(),
                 ChannelId::default()
             ))),
         );
 
-        let path = "nextSequenceAck/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceAck/ports/transfer/channels/channel-0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_seqs(&components),
             Some(Path::SeqAck(SeqAckPath(
-                PortId::default(),
+                PortId::transfer(),
                 ChannelId::default()
             ))),
         );
@@ -1053,49 +1053,49 @@ mod tests {
 
     #[test]
     fn sequence_send_path_parses() {
-        let path = "nextSequenceSend/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceSend/ports/transfer/channels/channel-0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
-            Path::SeqSend(SeqSendPath(PortId::default(), ChannelId::default())),
+            Path::SeqSend(SeqSendPath(PortId::transfer(), ChannelId::default())),
         );
     }
 
     #[test]
     fn sequence_recv_path_parses() {
-        let path = "nextSequenceRecv/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceRecv/ports/transfer/channels/channel-0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
-            Path::SeqRecv(SeqRecvPath(PortId::default(), ChannelId::default())),
+            Path::SeqRecv(SeqRecvPath(PortId::transfer(), ChannelId::default())),
         );
     }
 
     #[test]
     fn sequence_ack_path_parses() {
-        let path = "nextSequenceAck/ports/defaultPort/channels/channel-0";
+        let path = "nextSequenceAck/ports/transfer/channels/channel-0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
-            Path::SeqAck(SeqAckPath(PortId::default(), ChannelId::default())),
+            Path::SeqAck(SeqAckPath(PortId::transfer(), ChannelId::default())),
         );
     }
 
     #[test]
     fn test_parse_commitments_fn() {
-        let path = "commitments/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "commitments/ports/transfer/channels/channel-0/sequences/0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_commitments(&components),
             Some(Path::Commitment(CommitmentPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             })),
@@ -1104,14 +1104,14 @@ mod tests {
 
     #[test]
     fn commitments_path_parses() {
-        let path = "commitments/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "commitments/ports/transfer/channels/channel-0/sequences/0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
             Path::Commitment(CommitmentPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             }),
@@ -1120,13 +1120,13 @@ mod tests {
 
     #[test]
     fn test_parse_acks_fn() {
-        let path = "acks/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "acks/ports/transfer/channels/channel-0/sequences/0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_acks(&components),
             Some(Path::Ack(AckPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             })),
@@ -1135,14 +1135,14 @@ mod tests {
 
     #[test]
     fn acks_path_parses() {
-        let path = "acks/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "acks/ports/transfer/channels/channel-0/sequences/0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
             Path::Ack(AckPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             }),
@@ -1151,13 +1151,13 @@ mod tests {
 
     #[test]
     fn test_parse_receipts_fn() {
-        let path = "receipts/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "receipts/ports/transfer/channels/channel-0/sequences/0";
         let components: Vec<&str> = path.split('/').collect();
 
         assert_eq!(
             parse_receipts(&components),
             Some(Path::Receipt(ReceiptPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             })),
@@ -1166,14 +1166,14 @@ mod tests {
 
     #[test]
     fn receipts_path_parses() {
-        let path = "receipts/ports/defaultPort/channels/channel-0/sequences/0";
+        let path = "receipts/ports/transfer/channels/channel-0/sequences/0";
         let path = Path::from_str(path);
 
         assert!(path.is_ok());
         assert_eq!(
             path.unwrap(),
             Path::Receipt(ReceiptPath {
-                port_id: PortId::default(),
+                port_id: PortId::transfer(),
                 channel_id: ChannelId::default(),
                 sequence: Sequence::default(),
             }),
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
index c1a9d323f..16318bdfb 100644
--- a/crates/ibc/src/lib.rs
+++ b/crates/ibc/src/lib.rs
@@ -55,11 +55,6 @@ pub mod clients;
 pub mod core;
 pub mod hosts;
 
-#[cfg(any(test, feature = "mocks"))]
-pub mod mock;
-#[cfg(any(test, feature = "mocks"))]
-pub mod test_utils; // Context mock, the underlying host chain, and client types: for testing all handlers.
-
 pub mod prelude;
 mod signer;
 pub mod utils;
@@ -71,7 +66,7 @@ mod serializers;
 pub mod proto {
     pub use ibc_proto::google::protobuf::Any;
     pub use ibc_proto::ibc::apps::transfer;
-    pub use ibc_proto::ibc::core;
     pub use ibc_proto::ibc::lightclients::tendermint;
-    pub use ibc_proto::Protobuf;
+    pub use ibc_proto::ibc::{core, mock};
+    pub use ibc_proto::{ics23, Protobuf};
 }
diff --git a/crates/ibc/src/mock/ics18_relayer/mod.rs b/crates/ibc/src/mock/ics18_relayer/mod.rs
deleted file mode 100644
index 8a7f14e5b..000000000
--- a/crates/ibc/src/mock/ics18_relayer/mod.rs
+++ /dev/null
@@ -1,4 +0,0 @@
-//! ICS 18: Relayer contains utilities for testing `ibc` against the Hermes relayer.
-
-pub mod context;
-pub mod error;
diff --git a/crates/ibc/src/mock/mod.rs b/crates/ibc/src/mock/mod.rs
deleted file mode 100644
index 9492569c2..000000000
--- a/crates/ibc/src/mock/mod.rs
+++ /dev/null
@@ -1,18 +0,0 @@
-//! Implementation of mocks for context, host chain, and client.
-
-#[cfg(any(test, feature = "mocks"))]
-pub mod client_state;
-#[cfg(any(test, feature = "mocks"))]
-pub mod consensus_state;
-#[cfg(any(test, feature = "mocks"))]
-pub mod context;
-#[cfg(any(test, feature = "mocks"))]
-pub mod header;
-#[cfg(any(test, feature = "mocks"))]
-pub mod host;
-#[cfg(any(test, feature = "mocks"))]
-pub mod ics18_relayer;
-#[cfg(any(test, feature = "mocks"))]
-pub mod misbehaviour;
-#[cfg(any(test, feature = "mocks"))]
-pub mod router;
diff --git a/crates/ibc/src/mock/router.rs b/crates/ibc/src/mock/router.rs
deleted file mode 100644
index 7cfaf3829..000000000
--- a/crates/ibc/src/mock/router.rs
+++ /dev/null
@@ -1,56 +0,0 @@
-use alloc::collections::BTreeMap;
-use alloc::sync::Arc;
-
-use crate::core::ics24_host::identifier::PortId;
-use crate::core::router::{Module, ModuleId, Router};
-use crate::prelude::*;
-
-#[derive(Default)]
-pub struct MockRouter {
-    router: BTreeMap<ModuleId, Arc<dyn Module>>,
-
-    /// Maps ports to the the module that owns it
-    pub port_to_module: BTreeMap<PortId, ModuleId>,
-}
-
-impl MockRouter {
-    pub fn add_route(
-        &mut self,
-        module_id: ModuleId,
-        module: impl Module + 'static,
-    ) -> Result<(), String> {
-        match self.router.insert(module_id, Arc::new(module)) {
-            None => Ok(()),
-            Some(_) => Err("Duplicate module_id".to_owned()),
-        }
-    }
-
-    pub fn scope_port_to_module(&mut self, port_id: PortId, module_id: ModuleId) {
-        self.port_to_module.insert(port_id, module_id);
-    }
-}
-
-impl Router for MockRouter {
-    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module> {
-        self.router.get(module_id).map(Arc::as_ref)
-    }
-    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module> {
-        // NOTE: The following:
-
-        // self.router.get_mut(module_id).and_then(Arc::get_mut)
-
-        // doesn't work due to a compiler bug. So we expand it out manually.
-
-        match self.router.get_mut(module_id) {
-            Some(arc_mod) => match Arc::get_mut(arc_mod) {
-                Some(m) => Some(m),
-                None => None,
-            },
-            None => None,
-        }
-    }
-
-    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId> {
-        self.port_to_module.get(port_id).cloned()
-    }
-}
diff --git a/crates/ibc/src/test_utils.rs b/crates/ibc/src/test_utils.rs
deleted file mode 100644
index 6a13ff639..000000000
--- a/crates/ibc/src/test_utils.rs
+++ /dev/null
@@ -1,222 +0,0 @@
-use subtle_encoding::bech32;
-
-use crate::applications::transfer::context::{
-    cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
-};
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::PrefixedCoin;
-use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::channel::{Counterparty, Order};
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::router::{Module, ModuleExtras};
-use crate::prelude::*;
-use crate::signer::Signer;
-
-pub fn get_dummy_proof() -> Vec<u8> {
-    "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
-        .as_bytes()
-        .to_vec()
-}
-
-pub fn get_dummy_account_id() -> Signer {
-    "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
-        .to_string()
-        .into()
-}
-
-pub fn get_dummy_bech32_account() -> String {
-    "cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng".to_string()
-}
-
-pub fn get_dummy_transfer_module() -> DummyTransferModule {
-    DummyTransferModule
-}
-#[derive(Debug)]
-pub struct DummyTransferModule;
-
-impl DummyTransferModule {
-    pub fn new() -> Self {
-        Self
-    }
-}
-
-impl Default for DummyTransferModule {
-    fn default() -> Self {
-        Self::new()
-    }
-}
-
-impl Module for DummyTransferModule {
-    fn on_chan_open_init_validate(
-        &self,
-        _order: Order,
-        _connection_hops: &[ConnectionId],
-        _port_id: &PortId,
-        _channel_id: &ChannelId,
-        _counterparty: &Counterparty,
-        version: &Version,
-    ) -> Result<Version, ChannelError> {
-        Ok(version.clone())
-    }
-
-    fn on_chan_open_init_execute(
-        &mut self,
-        _order: Order,
-        _connection_hops: &[ConnectionId],
-        _port_id: &PortId,
-        _channel_id: &ChannelId,
-        _counterparty: &Counterparty,
-        version: &Version,
-    ) -> Result<(ModuleExtras, Version), ChannelError> {
-        Ok((ModuleExtras::empty(), version.clone()))
-    }
-
-    fn on_chan_open_try_validate(
-        &self,
-        _order: Order,
-        _connection_hops: &[ConnectionId],
-        _port_id: &PortId,
-        _channel_id: &ChannelId,
-        _counterparty: &Counterparty,
-        counterparty_version: &Version,
-    ) -> Result<Version, ChannelError> {
-        Ok(counterparty_version.clone())
-    }
-
-    fn on_chan_open_try_execute(
-        &mut self,
-        _order: Order,
-        _connection_hops: &[ConnectionId],
-        _port_id: &PortId,
-        _channel_id: &ChannelId,
-        _counterparty: &Counterparty,
-        counterparty_version: &Version,
-    ) -> Result<(ModuleExtras, Version), ChannelError> {
-        Ok((ModuleExtras::empty(), counterparty_version.clone()))
-    }
-
-    fn on_recv_packet_execute(
-        &mut self,
-        _packet: &Packet,
-        _relayer: &Signer,
-    ) -> (ModuleExtras, Acknowledgement) {
-        (
-            ModuleExtras::empty(),
-            Acknowledgement::try_from(vec![1u8]).expect("Never fails"),
-        )
-    }
-
-    fn on_timeout_packet_validate(
-        &self,
-        _packet: &Packet,
-        _relayer: &Signer,
-    ) -> Result<(), PacketError> {
-        Ok(())
-    }
-
-    fn on_timeout_packet_execute(
-        &mut self,
-        _packet: &Packet,
-        _relayer: &Signer,
-    ) -> (ModuleExtras, Result<(), PacketError>) {
-        (ModuleExtras::empty(), Ok(()))
-    }
-
-    fn on_acknowledgement_packet_validate(
-        &self,
-        _packet: &Packet,
-        _acknowledgement: &Acknowledgement,
-        _relayer: &Signer,
-    ) -> Result<(), PacketError> {
-        Ok(())
-    }
-
-    fn on_acknowledgement_packet_execute(
-        &mut self,
-        _packet: &Packet,
-        _acknowledgement: &Acknowledgement,
-        _relayer: &Signer,
-    ) -> (ModuleExtras, Result<(), PacketError>) {
-        (ModuleExtras::empty(), Ok(()))
-    }
-}
-
-impl TokenTransferValidationContext for DummyTransferModule {
-    type AccountId = Signer;
-
-    fn get_port(&self) -> Result<PortId, TokenTransferError> {
-        Ok(PortId::transfer())
-    }
-
-    fn get_escrow_account(
-        &self,
-        port_id: &PortId,
-        channel_id: &ChannelId,
-    ) -> Result<Self::AccountId, TokenTransferError> {
-        let addr = cosmos_adr028_escrow_address(port_id, channel_id);
-        Ok(bech32::encode("cosmos", addr).into())
-    }
-
-    fn can_send_coins(&self) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn can_receive_coins(&self) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn send_coins_validate(
-        &self,
-        _from_account: &Self::AccountId,
-        _to_account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn mint_coins_validate(
-        &self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn burn_coins_validate(
-        &self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-}
-
-impl TokenTransferExecutionContext for DummyTransferModule {
-    fn send_coins_execute(
-        &mut self,
-        _from_account: &Self::AccountId,
-        _to_account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn mint_coins_execute(
-        &mut self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-
-    fn burn_coins_execute(
-        &mut self,
-        _account: &Self::AccountId,
-        _coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError> {
-        Ok(())
-    }
-}
diff --git a/crates/ibc/src/utils/mod.rs b/crates/ibc/src/utils/mod.rs
index b4f1b623d..f0eeeadba 100644
--- a/crates/ibc/src/utils/mod.rs
+++ b/crates/ibc/src/utils/mod.rs
@@ -1,4 +1,3 @@
 //! Various utilities used internally
-
 pub(crate) mod macros;
 pub(crate) mod pretty;

From 318c284de38637420f14f41babf13a116e8a5e21 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 10 Nov 2023 10:35:54 -0800
Subject: [PATCH 055/182] imp: enhance dependency management with workspace
 inheritance (#957)

* imp: use workspace dependencies

* chore: add unclog

* fix: clippy catches

* fix: cleanups b/c of merging main branch

* fix: add ibc-testkit as dev-dep to ibc

* nit: reorder ibc deps

* fix: apply suggestions from code review

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* fix: use worksapce for dev-deps under ibc-testkit

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../breaking-changes/956-bump-MSRV-to-1-64.md |   2 +
 .../955-use-workspace-dependencies.md         |   2 +
 Cargo.toml                                    |  53 ++++++++-
 README.md                                     |   2 +-
 ci/no-std-check/Cargo.lock                    |   1 +
 crates/ibc-query/Cargo.toml                   |  27 +++--
 crates/ibc-testkit/Cargo.toml                 |  61 +++++-----
 crates/ibc/Cargo.toml                         | 107 +++++++++---------
 crates/ibc/src/core/ics04_channel/channel.rs  |   9 +-
 9 files changed, 157 insertions(+), 107 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md
 create mode 100644 .changelog/unreleased/improvements/955-use-workspace-dependencies.md

diff --git a/.changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md b/.changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md
new file mode 100644
index 000000000..37056378e
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md
@@ -0,0 +1,2 @@
+- Bump minimum supported Rust version to 1.64
+  ([\#956](https://github.com/cosmos/ibc-rs/issues/956))
diff --git a/.changelog/unreleased/improvements/955-use-workspace-dependencies.md b/.changelog/unreleased/improvements/955-use-workspace-dependencies.md
new file mode 100644
index 000000000..51846aba0
--- /dev/null
+++ b/.changelog/unreleased/improvements/955-use-workspace-dependencies.md
@@ -0,0 +1,2 @@
+- Enhance dependency management with workspace inheritance
+  ([\#955](https://github.com/cosmos/ibc-rs/issues/955))
diff --git a/Cargo.toml b/Cargo.toml
index 87820e6e9..7f65e463b 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,15 +1,62 @@
 [workspace]
-
 resolver = "2"
-
 members = [
     "crates/ibc",
     "crates/ibc-derive",
     "crates/ibc-testkit",
     "crates/ibc-query",
 ]
-
 exclude = [
     "ci/cw-check",
     "ci/no-std-check",
 ]
+
+[workspace.package]
+version      = "0.47.0"
+license      = "Apache-2.0"
+edition      = "2021"
+rust-version = "1.64"
+readme       = "README.md"
+repository   = "https://github.com/cosmos/ibc-rs"
+authors      = ["Informal Systems <hello@informal.systems>"]
+
+[workspace.dependencies]
+# external dependencies
+borsh = {version = "0.10", default-features = false }
+bytes = { version = "1.5.0", default-features = false }
+displaydoc = { version = "0.2", default-features = false }
+derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
+env_logger = "0.10.0"
+num-traits = { version = "0.2.17", default-features = false }
+parking_lot = { version = "0.12.1", default-features = false }
+primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
+prost = { version = "0.12", default-features = false }
+rstest = "0.18.2"
+schemars = { version = "0.8.15"}
+sha2 = { version = "0.10.8", default-features = false }
+serde = { version = "1.0", default-features = false }
+serde_derive = { version = "1.0", default-features = false }
+serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false }
+subtle-encoding = { version = "0.5", default-features = false }
+test-log = { version = "0.2.13", features = ["trace"] }
+time = { version = ">=0.3.0, <0.3.31", default-features = false }
+tracing = { version = "0.1.40", default-features = false }
+tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
+typed-builder = { version = "0.18.0"}
+
+# ibc dependencies
+ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
+ibc-proto = { version = "0.38.0", default-features = false }
+ics23 = { version = "0.11", default-features = false }
+
+# cosmos dependencies
+tendermint = { version = "0.34.0", default-features = false }
+tendermint-light-client = { version = "0.34.0", default-features = false }
+tendermint-light-client-verifier = { version = "0.34.0", default-features = false }
+tendermint-proto = { version = "0.34.0", default-features = false }
+tendermint-rpc = { version = "0.34.0", default-features = false }
+tendermint-testgen = { version = "0.34.0", default-features = false }
+
+# parity dependencies
+parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"] }
+scale-info = { version = "2.10.0", default-features = false, features = ["derive"] }
diff --git a/README.md b/README.md
index ac2cfd9fc..6bcd01fe8 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@
 [![Code Coverage][codecov-image]][codecov-link]
 [![Apache 2.0 Licensed][license-image]][license-link]
 ![Rust Stable][rustc-image]
-![Rust 1.60+][rustc-version]
+![Rust 1.64+][rustc-version]
 ![Lines of Code][loc-image]
 
 </div>
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 440218f08..01cf92efa 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1216,6 +1216,7 @@ name = "ibc"
 version = "0.47.0"
 dependencies = [
  "bytes",
+ "cfg-if",
  "derive_more",
  "displaydoc",
  "ibc-derive",
diff --git a/crates/ibc-query/Cargo.toml b/crates/ibc-query/Cargo.toml
index da50f931b..c6af07d99 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/crates/ibc-query/Cargo.toml
@@ -1,24 +1,27 @@
 [package]
 name         = "ibc-query"
-version      = "0.47.0"
-edition      = "2021"
-license      = "Apache-2.0"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
 readme       = "README.md"
 keywords     = ["blockchain", "cosmos", "ibc", "rpc", "grpc"]
-repository   = "https://github.com/cosmos/ibc-rs"
-authors      = ["Informal Systems <hello@informal.systems>"]
-rust-version = "1.60"
 description  = """
     'ibc-query' contains essential IBC query methods and 
     gRPC query service implementations for the IBC core.
 """
 
-[features]
-default = ["std"]
-std = ["ibc-proto/std", "ibc/std"]
-
 [dependencies]
-ibc = { version = "0.47.0", path = "../ibc", default-features = false }
-ibc-proto = { version = "0.38.0", default-features = false, features = ["server"] }
+# external dependencies
 displaydoc = { version = "0.2", default-features = false }
 tonic = "0.10"
+
+# ibc dependencies
+ibc = { version = "0.47.0", path = "../ibc", default-features = false }
+ibc-proto = { workspace = true, features = ["server"] }
+
+[features]
+default = ["std"]
+std = ["ibc-proto/std", "ibc/std"]
diff --git a/crates/ibc-testkit/Cargo.toml b/crates/ibc-testkit/Cargo.toml
index cdb496220..8a8c9137d 100644
--- a/crates/ibc-testkit/Cargo.toml
+++ b/crates/ibc-testkit/Cargo.toml
@@ -1,12 +1,13 @@
 [package]
 name         = "ibc-testkit"
-version      = "0.47.0"
-edition      = "2021"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
 readme       = "README.md"
 keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-repository   = "https://github.com/cosmos/ibc-rs"
-authors      = ["Informal Systems <hello@informal.systems>"]
-rust-version = "1.60"
 description  = """
     `ibc-testkit` is a versatile library that provides essential abstractions and implementations, 
     fulfilling a dual role of enabling rigorous integration testing for the `ibc-rs` implementation 
@@ -14,6 +15,33 @@ description  = """
     their integration with `ibc-rs`.
 """
 
+[dependencies]
+# external dependencies
+bytes = { workspace = true }
+derive_more = { workspace = true }
+displaydoc = { workspace = true }
+parking_lot = { workspace = true }
+primitive-types = { workspace = true }
+prost = { workspace = true }
+serde = { workspace = true, optional = true }
+serde_json = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+tracing = { workspace = true }
+typed-builder = { workspace = true }
+
+# ibc dependencies
+ibc = { version = "0.47.0" , path = "../ibc" } # NOTE: since `ibc-testkit` does not well support `no_std` yet, we keep `ibc` default features enabled
+
+# cosmos dependencies
+tendermint = { workspace = true }
+tendermint-testgen = { workspace = true }
+
+[dev-dependencies]
+env_logger = { workspace = true }
+rstest =  { workspace = true }
+tracing-subscriber = { workspace = true }
+test-log = { workspace = true }
+
 [features]
 default = ["std"]
 std = [
@@ -26,26 +54,3 @@ std = [
 
 # This feature is required for token transfer (ICS-20)
 serde = ["dep:serde", "ibc/serde", "serde_json"]
-
-[dependencies]
-bytes = { version = "1.2.1", default-features = false }
-derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
-displaydoc = { version = "0.2", default-features = false }
-ibc = { version = "0.47.0" , path = "../ibc" } # NOTE: since `ibc-testkit` does not well support `no_std` yet, we keep `ibc` default features enabled
-parking_lot = { version = "0.12.1", default-features = false }
-prost = { version = "0.12", default-features = false }
-serde = { version = "1.0", default-features = false, optional = true }
-serde_json = { version = "1", default-features = false, optional = true }
-subtle-encoding = { version = "0.5", default-features = false }
-tendermint = { version = "0.34", default-features = false }
-tendermint-testgen = { version = "0.34", default-features = false }
-tracing = { version = "0.1.36", default-features = false }
-typed-builder = "0.18.0"
-primitive-types = { version = "0.12.0", default-features = false, features = ["serde_no_std"] }
-
-
-[dev-dependencies]
-env_logger = "0.10.0"
-rstest = "0.18.1"
-tracing-subscriber = { version = "0.3.14", features = ["fmt", "env-filter", "json"]}
-test-log = { version = "0.2.10", features = ["trace"] }
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
index 52238ed20..8bd87b26f 100644
--- a/crates/ibc/Cargo.toml
+++ b/crates/ibc/Cargo.toml
@@ -1,13 +1,13 @@
 [package]
 name         = "ibc"
-version      = "0.47.0"
-edition      = "2021"
-license      = "Apache-2.0"
-readme       = "README.md"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
 keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-repository   = "https://github.com/cosmos/ibc-rs"
-authors      = ["Informal Systems <hello@informal.systems>"]
-rust-version = "1.60"
+readme       = "README.md"
 description  = """
     Implementation of the Inter-Blockchain Communication Protocol (IBC).
     This crate comprises the main data structures and on-chain logic.
@@ -16,8 +16,50 @@ description  = """
 [package.metadata.docs.rs]
 all-features = true
 
+[dependencies]
+# external dependencies
+borsh = { workspace = true, optional = true }
+bytes = { workspace = true }
+derive_more = { workspace = true }
+displaydoc = { workspace = true }
+primitive-types = { workspace = true }
+prost = { workspace = true }
+serde_derive = { workspace = true, optional = true }
+serde = { workspace = true, optional = true }
+serde_json =  { workspace = true, optional = true}
+subtle-encoding = { workspace = true, default-features = false }
+sha2 = { workspace = true, default-features = false }
+time = { workspace = true, default-features = false }
+schemars = { workspace = true, optional = true }
+typed-builder = { workspace = true, optional = true }
+uint = { version = "0.9", default-features = false }
+
+# ibc dependencies
+ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
+ibc-proto = { workspace = true }
+ics23 = { workspace = true, features = ["host-functions"] }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+tendermint-proto = { workspace = true }
+tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
+
+## parity dependencies
+parity-scale-codec = { workspace = true , optional = true }
+scale-info = { workspace = true , optional = true }
+
+
+[dev-dependencies]
+ibc-testkit = { version = "0.47.0", path = "../ibc-testkit", default-features = false, features = ["serde"] }
+env_logger = { workspace = true }
+rstest = { workspace = true }
+tracing-subscriber = { workspace = true }
+test-log = { workspace = true }
+tendermint-rpc = {  workspace = true, features = ["http-client", "websocket-client"] }
+
 [features]
 default = ["std"]
+
 std = [
     "ibc-proto/std",
     "ics23/std",
@@ -33,7 +75,9 @@ std = [
     "tendermint/clock",
     "tendermint/std",
 ]
+
 parity-scale-codec = ["dep:parity-scale-codec", "dep:scale-info", "ibc-proto/parity-scale-codec"]
+
 borsh = ["dep:borsh", "ibc-proto/borsh"]
 
 # This feature is required for token transfer (ICS-20)
@@ -41,52 +85,3 @@ serde = ["dep:serde", "dep:serde_derive", "serde_json", "ibc-proto/serde", "ics2
 
 # CosmWasm message API generator compatible, should not be inside on chain code
 schema = ["dep:schemars", "ibc-proto/json-schema", "serde", "std"]
-
-[dependencies]
-# Proto definitions for all IBC-related interfaces, e.g., connections or channels.
-ibc-proto = { version = "0.38.0", default-features = false }
-ics23 = { version = "0.11", default-features = false, features = ["host-functions"] }
-time = { version = ">=0.3.0, <0.3.31", default-features = false }
-serde_derive = { version = "1.0", default-features = false, optional = true }
-serde = { version = "1.0", default-features = false, optional = true }
-serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false, optional = true}
-prost = { version = "0.12", default-features = false }
-bytes = { version = "1.5.0", default-features = false }
-subtle-encoding = { version = "0.5", default-features = false }
-sha2 = { version = "0.10.8", default-features = false }
-displaydoc = { version = "0.2", default-features = false }
-derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
-uint = { version = "0.9", default-features = false }
-primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
-
-## for codec encode or decode
-parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"], optional = true }
-scale-info = { version = "2.10.0", default-features = false, features = ["derive"], optional = true }
-## for borsh encode or decode
-borsh = {version = "0.10", default-features = false, optional = true }
-typed-builder = { version = "0.18.0", optional = true }
-
-ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
-
-schemars = { version = "0.8.15", optional = true }
-
-[dependencies.tendermint]
-version = "0.34"
-default-features = false
-
-[dependencies.tendermint-proto]
-version = "0.34"
-default-features = false
-
-[dependencies.tendermint-light-client-verifier]
-version = "0.34"
-default-features = false
-features = ["rust-crypto"]
-
-[dev-dependencies]
-ibc-testkit = { version = "0.47.0", path = "../ibc-testkit", default-features = false, features = ["serde"] }
-env_logger = "0.10.0"
-rstest = "0.18.2"
-tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"]}
-test-log = { version = "0.2.13", features = ["trace"] }
-tendermint-rpc = { version = "0.34", features = ["http-client", "websocket-client"] }
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/crates/ibc/src/core/ics04_channel/channel.rs
index 49717cde4..43eceacb5 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/crates/ibc/src/core/ics04_channel/channel.rs
@@ -435,19 +435,14 @@ impl From<Counterparty> for RawCounterparty {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Copy, Debug, PartialEq, Eq)]
+#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
 pub enum Order {
     None = 0isize,
+    #[default]
     Unordered = 1isize,
     Ordered = 2isize,
 }
 
-impl Default for Order {
-    fn default() -> Self {
-        Order::Unordered
-    }
-}
-
 impl Display for Order {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
         write!(f, "{}", self.as_str())

From fe6b5b0a7a6b64efdc8313c9a6b1d73d29bab3ed Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Mon, 13 Nov 2023 19:36:36 +0100
Subject: [PATCH 056/182] refactor: simplify identifier length validation
 (#960)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* refactor: simplify identifier length validation

Firstly, remove asserts from the validate_identifier_length and
validate_prefix_length functions.  Instead, let the regular checks
handle cases where min and max constraints don’t allow for a valid
prefix to exist.

Secondly, ensure minimum length constraints is at least one.  This
makes sure that the validation functions will check for empty
identifiers and prefixes.  This makes empty identifier check in
validate_channel_identifier as well as Error::Empty variant
unnecessary so get rid of those too.

Lastly, collapse all checks in validate_prefix_length into a single
call to validate_identifier_length with correctly adjusted min and max
constraints.

Issue: https://github.com/cosmos/ibc-rs/issues/959

* log

* Update 960-simplify-length-validation.md

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* tests

* Update and rename 960-simplify-length-validation.md to 961-simplify-length-validation.md

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* update changelog entry

* revert error variant deletion

* refactor id validation tests

* use numeral consistently

---------

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../961-refactor-identifier-validation.md     |  2 +
 .../core/ics24_host/identifier/validate.rs    | 90 ++++++++-----------
 2 files changed, 38 insertions(+), 54 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md

diff --git a/.changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md b/.changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md
new file mode 100644
index 000000000..ca8ca1d0e
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md
@@ -0,0 +1,2 @@
+- Simplify and refactor ICS-24 identifier validation logic.
+  ([\#961](https://github.com/cosmos/ibc-rs/issues/961))
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/crates/ibc/src/core/ics24_host/identifier/validate.rs
index 7e0f2acf3..c16fcdf12 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/crates/ibc/src/core/ics24_host/identifier/validate.rs
@@ -9,11 +9,6 @@ const VALID_SPECIAL_CHARS: &str = "._+-#[]<>";
 /// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
 /// spec.
 pub fn validate_identifier_chars(id: &str) -> Result<(), Error> {
-    // Check identifier is not empty
-    if id.is_empty() {
-        return Err(Error::Empty);
-    }
-
     // Check identifier does not contain path separators
     if id.contains(PATH_SEPARATOR) {
         return Err(Error::ContainSeparator { id: id.into() });
@@ -38,19 +33,19 @@ pub fn validate_identifier_chars(id: &str) -> Result<(), Error> {
 /// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
 /// spec.
 pub fn validate_identifier_length(id: &str, min: u64, max: u64) -> Result<(), Error> {
-    assert!(max >= min);
-
-    // Check identifier length is between given min/max
-    if (id.len() as u64) < min || id.len() as u64 > max {
-        return Err(Error::InvalidLength {
+    // Make sure min is at least one so we reject empty identifiers.
+    let min = min.max(1);
+    let length = id.len() as u64;
+    if (min..=max).contains(&length) {
+        Ok(())
+    } else {
+        Err(Error::InvalidLength {
             id: id.into(),
-            length: id.len() as u64,
+            length,
             min,
             max,
-        });
+        })
     }
-
-    Ok(())
 }
 
 /// Checks if a prefix forms a valid identifier with the given min/max identifier's length.
@@ -61,42 +56,16 @@ pub fn validate_prefix_length(
     min_id_length: u64,
     max_id_length: u64,
 ) -> Result<(), Error> {
-    assert!(max_id_length >= min_id_length);
-
-    if prefix.is_empty() {
-        return Err(Error::InvalidPrefix {
-            prefix: prefix.into(),
-        });
-    }
-
-    // Statically checks if the prefix forms a valid identifier length when constructed with `u64::MAX`
-    // len(prefix + '-' + u64::MAX) <= max_id_length (minimum prefix length is 1)
-    if max_id_length < 22 {
-        return Err(Error::InvalidLength {
-            id: prefix.into(),
-            length: prefix.len() as u64,
-            min: 0,
-            max: 0,
-        });
-    }
-
-    // Checks if the prefix forms a valid identifier length when constructed with `u64::MIN`
-    // len('-' + u64::MIN) = 2
-    validate_identifier_length(
-        prefix,
-        min_id_length.saturating_sub(2),
-        max_id_length.saturating_sub(2),
-    )?;
-
-    // Checks if the prefix forms a valid identifier length when constructed with `u64::MAX`
-    // len('-' + u64::MAX) = 21
-    validate_identifier_length(
-        prefix,
-        min_id_length.saturating_sub(21),
-        max_id_length.saturating_sub(21),
-    )?;
-
-    Ok(())
+    // Prefix must be at least `min_id_length - 2` characters long since the
+    // shortest identifier we can construct is `{prefix}-0` which extends prefix
+    // by 2 characters.
+    let min = min_id_length.saturating_sub(2);
+    // Prefix must be at most `max_id_length - 21` characters long since the
+    // longest identifier we can construct is `{prefix}-{u64::MAX}` which
+    // extends prefix by 21 characters.
+    let max = max_id_length.saturating_sub(21);
+
+    validate_identifier_length(prefix, min, max)
 }
 
 /// Default validator function for the Client types.
@@ -220,10 +189,21 @@ mod tests {
     }
 
     #[test]
-    fn parse_invalid_id_empty() {
-        // invalid id empty
-        let id = validate_identifier_chars("");
-        assert!(id.is_err())
+    fn validate_chars_empty_id() {
+        // validate_identifier_chars allows empty identifiers
+        assert!(validate_identifier_chars("").is_ok());
+    }
+
+    #[test]
+    fn validate_length_empty_id() {
+        // validate_identifier_length does not allow empty identifiers
+        assert!(validate_identifier_length("", 0, 64).is_err());
+    }
+
+    #[test]
+    fn validate_min_gt_max_constraints() {
+        // validate_identifier_length rejects the id if min > max.
+        assert!(validate_identifier_length("foobar", 5, 3).is_err());
     }
 
     #[test]
@@ -252,8 +232,10 @@ mod tests {
     }
 
     #[rstest]
+    #[case::zero_min_length("", 0, 64, false)]
     #[case::empty_prefix("", 1, 64, false)]
     #[case::max_is_low("a", 1, 10, false)]
+    #[case::min_greater_than_max("foobar", 5, 3, false)]
     #[case::u64_max_is_too_big("a", 3, 21, false)]
     #[case::u64_min_is_too_small("a", 4, 22, false)]
     #[case::u64_min_max_boundary("a", 3, 22, true)]

From 95fc7d753f28c8ec7e607c91ec2aeefcfeec91f8 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 14 Nov 2023 09:22:24 -0500
Subject: [PATCH 057/182] refactor: nits from nightly clippy (#962)

* use enum tuple variants directly

* use first() over get(0)

* use infallible conversion

* rm redundant export

* cargo fmt
---
 .../src/testapp/ibc/core/core_ctx.rs          |  34 +++---
 .../src/testapp/ibc/core/router/mod.rs        |   1 -
 .../dummies/core/client/msg_create_client.rs  |   2 +-
 .../applications/transfer/msgs/transfer.rs    |   2 +-
 .../ics02_client/handler/update_client.rs     |   2 +-
 crates/ibc/src/core/ics03_connection/delay.rs |  22 ++--
 .../ibc/src/core/ics23_commitment/merkle.rs   |   4 +-
 .../hosts/tendermint/validate_self_client.rs  | 105 +++++++++---------
 8 files changed, 90 insertions(+), 82 deletions(-)

diff --git a/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index fa917b493..470f28a86 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -144,26 +144,28 @@ impl ValidationContext for MockContext {
         let self_chain_id = &self.host_chain_id;
         let self_revision_number = self_chain_id.revision_number();
         if self_revision_number != mock_client_state.latest_height().revision_number() {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client is not in the same revision as the chain. expected: {}, got: {}",
-                    self_revision_number,
-                    mock_client_state.latest_height().revision_number()
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "client is not in the same revision as the chain. expected: {}, got: {}",
+                        self_revision_number,
+                        mock_client_state.latest_height().revision_number()
+                    ),
+                },
+            ));
         }
 
         let host_current_height = self.latest_height().increment();
         if mock_client_state.latest_height() >= host_current_height {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client has latest height {} greater than or equal to chain height {}",
-                    mock_client_state.latest_height(),
-                    host_current_height
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "client has latest height {} greater than or equal to chain height {}",
+                        mock_client_state.latest_height(),
+                        host_current_height
+                    ),
+                },
+            ));
         }
 
         Ok(())
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs b/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
index 59680b5b0..6629c0e08 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
+++ b/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
@@ -1,5 +1,4 @@
 mod context;
 mod types;
 
-pub use context::*;
 pub use types::*;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs b/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
index 8c93071d0..250855fb0 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
+++ b/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
@@ -15,7 +15,7 @@ pub fn dummy_raw_msg_create_client() -> MsgCreateClient {
 
     MsgCreateClient {
         client_state: Some(Any::from(tm_client_state)),
-        consensus_state: Some(Any::from(TmConsensusState::try_from(tm_header).unwrap())),
+        consensus_state: Some(Any::from(TmConsensusState::from(tm_header))),
         signer: dummy_bech32_account(),
     }
 }
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/crates/ibc/src/applications/transfer/msgs/transfer.rs
index 44a8406a6..5ea2d66d7 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/crates/ibc/src/applications/transfer/msgs/transfer.rs
@@ -70,7 +70,7 @@ impl TryFrom<RawMsgTransfer> for MsgTransfer {
 
         // Packet timeout height and packet timeout timestamp cannot both be unset.
         if !timeout_height_on_b.is_set() && !timeout_timestamp_on_b.is_set() {
-            return Err(PacketError::MissingTimeout).map_err(ContextError::from)?;
+            return Err(ContextError::from(PacketError::MissingTimeout))?;
         }
 
         Ok(MsgTransfer {
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/crates/ibc/src/core/ics02_client/handler/update_client.rs
index 9227495a0..f4ce3013d 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/crates/ibc/src/core/ics02_client/handler/update_client.rs
@@ -99,7 +99,7 @@ where
 
         {
             let event = {
-                let consensus_height = consensus_heights.get(0).ok_or(ClientError::Other {
+                let consensus_height = consensus_heights.first().ok_or(ClientError::Other {
                     description: "client update state returned no updated height".to_string(),
                 })?;
 
diff --git a/crates/ibc/src/core/ics03_connection/delay.rs b/crates/ibc/src/core/ics03_connection/delay.rs
index b359a3b5c..9b3865fac 100644
--- a/crates/ibc/src/core/ics03_connection/delay.rs
+++ b/crates/ibc/src/core/ics03_connection/delay.rs
@@ -33,21 +33,23 @@ where
     let earliest_valid_time = (last_client_update_time + conn_delay_time_period)
         .map_err(ConnectionError::TimestampOverflow)?;
     if current_host_time < earliest_valid_time {
-        return Err(ConnectionError::NotEnoughTimeElapsed {
-            current_host_time,
-            earliest_valid_time,
-        })
-        .map_err(ContextError::ConnectionError);
+        return Err(ContextError::ConnectionError(
+            ConnectionError::NotEnoughTimeElapsed {
+                current_host_time,
+                earliest_valid_time,
+            },
+        ));
     }
 
     // Verify that the current host chain height is later than the last client update height
     let earliest_valid_height = last_client_update_height.add(conn_delay_height_period);
     if current_host_height < earliest_valid_height {
-        return Err(ConnectionError::NotEnoughBlocksElapsed {
-            current_host_height,
-            earliest_valid_height,
-        })
-        .map_err(ContextError::ConnectionError);
+        return Err(ContextError::ConnectionError(
+            ConnectionError::NotEnoughBlocksElapsed {
+                current_host_height,
+                earliest_valid_height,
+            },
+        ));
     };
 
     Ok(())
diff --git a/crates/ibc/src/core/ics23_commitment/merkle.rs b/crates/ibc/src/core/ics23_commitment/merkle.rs
index 3ffb37b8b..26908e6f0 100644
--- a/crates/ibc/src/core/ics23_commitment/merkle.rs
+++ b/crates/ibc/src/core/ics23_commitment/merkle.rs
@@ -145,10 +145,10 @@ impl MerkleProof {
         // verify the absence of key in lowest subtree
         let proof = self
             .proofs
-            .get(0)
+            .first()
             .ok_or(CommitmentError::InvalidMerkleProof)?;
         let spec = ics23_specs
-            .get(0)
+            .first()
             .ok_or(CommitmentError::InvalidMerkleProof)?;
         // keys are represented from root-to-leaf
         let key = keys
diff --git a/crates/ibc/src/hosts/tendermint/validate_self_client.rs b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
index 8319bf727..6b7762114 100644
--- a/crates/ibc/src/hosts/tendermint/validate_self_client.rs
+++ b/crates/ibc/src/hosts/tendermint/validate_self_client.rs
@@ -38,47 +38,51 @@ pub trait ValidateSelfClientContext {
 
         let self_chain_id = self.chain_id();
         if self_chain_id != &tm_client_state.chain_id {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "invalid chain-id. expected: {}, got: {}",
-                    self_chain_id, tm_client_state.chain_id
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "invalid chain-id. expected: {}, got: {}",
+                        self_chain_id, tm_client_state.chain_id
+                    ),
+                },
+            ));
         }
 
         let self_revision_number = self_chain_id.revision_number();
         if self_revision_number != tm_client_state.latest_height().revision_number() {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client is not in the same revision as the chain. expected: {}, got: {}",
-                    self_revision_number,
-                    tm_client_state.latest_height().revision_number()
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "client is not in the same revision as the chain. expected: {}, got: {}",
+                        self_revision_number,
+                        tm_client_state.latest_height().revision_number()
+                    ),
+                },
+            ));
         }
 
         if tm_client_state.latest_height() >= self.host_current_height() {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client has latest height {} greater than or equal to chain height {}",
-                    tm_client_state.latest_height(),
-                    self.host_current_height()
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "client has latest height {} greater than or equal to chain height {}",
+                        tm_client_state.latest_height(),
+                        self.host_current_height()
+                    ),
+                },
+            ));
         }
 
         if self.proof_specs() != &tm_client_state.proof_specs {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "client has invalid proof specs. expected: {:?}, got: {:?}",
-                    self.proof_specs(),
-                    tm_client_state.proof_specs
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "client has invalid proof specs. expected: {:?}, got: {:?}",
+                        self.proof_specs(),
+                        tm_client_state.proof_specs
+                    ),
+                },
+            ));
         }
 
         let _ = {
@@ -94,36 +98,37 @@ pub trait ValidateSelfClientContext {
         };
 
         if self.unbonding_period() != tm_client_state.unbonding_period {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "invalid unbonding period. expected: {:?}, got: {:?}",
-                    self.unbonding_period(),
-                    tm_client_state.unbonding_period,
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "invalid unbonding period. expected: {:?}, got: {:?}",
+                        self.unbonding_period(),
+                        tm_client_state.unbonding_period,
+                    ),
+                },
+            ));
         }
 
         if tm_client_state.unbonding_period < tm_client_state.trusting_period {
-            return Err(ConnectionError::InvalidClientState{ reason: format!(
+            return Err(ContextError::ConnectionError(ConnectionError::InvalidClientState{ reason: format!(
                 "unbonding period must be greater than trusting period. unbonding period ({:?}) < trusting period ({:?})",
                 tm_client_state.unbonding_period,
                 tm_client_state.trusting_period
-            )})
-            .map_err(ContextError::ConnectionError);
+            )}));
         }
 
         if !tm_client_state.upgrade_path.is_empty()
             && self.upgrade_path() != tm_client_state.upgrade_path
         {
-            return Err(ConnectionError::InvalidClientState {
-                reason: format!(
-                    "invalid upgrade path. expected: {:?}, got: {:?}",
-                    self.upgrade_path(),
-                    tm_client_state.upgrade_path
-                ),
-            })
-            .map_err(ContextError::ConnectionError);
+            return Err(ContextError::ConnectionError(
+                ConnectionError::InvalidClientState {
+                    reason: format!(
+                        "invalid upgrade path. expected: {:?}, got: {:?}",
+                        self.upgrade_path(),
+                        tm_client_state.upgrade_path
+                    ),
+                },
+            ));
         }
 
         Ok(())

From bf773785f28e1276a12553dbcbabd164e83362b3 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 14 Nov 2023 11:51:48 -0500
Subject: [PATCH 058/182] ci: spell check on GitHub workflows (#964)

* typos github action

* cutom config for typos

* fix spelling to counterparty

* fix spelling to transfer
---
 .github/typos.toml                            |  3 +++
 .github/workflows/typos.yml                   | 13 ++++++++++++
 .../transfer/relay/send_transfer.rs           |  2 +-
 .../ics03_connection/msgs/conn_open_init.rs   | 20 +++++++++----------
 .../core/ics04_channel/msgs/chan_open_init.rs | 20 +++++++++----------
 5 files changed, 37 insertions(+), 21 deletions(-)
 create mode 100644 .github/typos.toml
 create mode 100644 .github/workflows/typos.yml

diff --git a/.github/typos.toml b/.github/typos.toml
new file mode 100644
index 000000000..fc71242c0
--- /dev/null
+++ b/.github/typos.toml
@@ -0,0 +1,3 @@
+[default.extend-words]
+# for serde serialization
+ser = "ser"
diff --git a/.github/workflows/typos.yml b/.github/workflows/typos.yml
new file mode 100644
index 000000000..ba30dc387
--- /dev/null
+++ b/.github/workflows/typos.yml
@@ -0,0 +1,13 @@
+name: Spell Check
+on:
+  pull_request:
+
+jobs:
+  run:
+    name: Spell Check with Typos
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: crate-ci/typos@master
+        with:
+          config: ./.github/typos.toml
diff --git a/crates/ibc/src/applications/transfer/relay/send_transfer.rs b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
index 607457f48..112462cd0 100644
--- a/crates/ibc/src/applications/transfer/relay/send_transfer.rs
+++ b/crates/ibc/src/applications/transfer/relay/send_transfer.rs
@@ -28,7 +28,7 @@ where
     send_transfer_execute(send_packet_ctx_a, token_ctx_a, msg)
 }
 
-/// Validates the token tranfer. If this succeeds, then it is legal to initiate the transfer with [`send_transfer_execute`].
+/// Validates the token transfer. If this succeeds, then it is legal to initiate the transfer with [`send_transfer_execute`].
 pub fn send_transfer_validate<SendPacketCtx, TokenCtx>(
     send_packet_ctx_a: &SendPacketCtx,
     token_ctx_a: &TokenCtx,
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
index 249076364..d0fd2572a 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
@@ -208,24 +208,24 @@ mod tests {
 
         // Check if handler sets counterparty connection id to `None`
         // in case relayer passes `MsgConnectionOpenInit` message with it set to `Some(_)`.
-        let raw_with_counterpary_conn_id_some = dummy_raw_msg_conn_open_init();
-        let msg_with_counterpary_conn_id_some =
-            MsgConnectionOpenInit::try_from(raw_with_counterpary_conn_id_some).unwrap();
-        let raw_with_counterpary_conn_id_some_back =
-            RawMsgConnectionOpenInit::from(msg_with_counterpary_conn_id_some.clone());
-        let msg_with_counterpary_conn_id_some_back =
-            MsgConnectionOpenInit::try_from(raw_with_counterpary_conn_id_some_back.clone())
+        let raw_with_counterparty_conn_id_some = dummy_raw_msg_conn_open_init();
+        let msg_with_counterparty_conn_id_some =
+            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some).unwrap();
+        let raw_with_counterparty_conn_id_some_back =
+            RawMsgConnectionOpenInit::from(msg_with_counterparty_conn_id_some.clone());
+        let msg_with_counterparty_conn_id_some_back =
+            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some_back.clone())
                 .unwrap();
         assert_eq!(
-            raw_with_counterpary_conn_id_some_back
+            raw_with_counterparty_conn_id_some_back
                 .counterparty
                 .unwrap()
                 .connection_id,
             "".to_string()
         );
         assert_eq!(
-            msg_with_counterpary_conn_id_some,
-            msg_with_counterpary_conn_id_some_back
+            msg_with_counterparty_conn_id_some,
+            msg_with_counterparty_conn_id_some_back
         );
     }
 
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
index c9bc91718..9f68c475e 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
@@ -162,15 +162,15 @@ mod tests {
 
         // Check if handler sets counterparty channel id to `None`
         // in case relayer passes `MsgChannelOpenInit` message with it set to `Some(_)`
-        let raw_with_counterpary_chan_id_some = dummy_raw_msg_chan_open_init(None);
-        let msg_with_counterpary_chan_id_some =
-            MsgChannelOpenInit::try_from(raw_with_counterpary_chan_id_some).unwrap();
-        let raw_with_counterpary_chan_id_some_back =
-            RawMsgChannelOpenInit::from(msg_with_counterpary_chan_id_some.clone());
-        let msg_with_counterpary_chan_id_some_back =
-            MsgChannelOpenInit::try_from(raw_with_counterpary_chan_id_some_back.clone()).unwrap();
+        let raw_with_counterparty_chan_id_some = dummy_raw_msg_chan_open_init(None);
+        let msg_with_counterparty_chan_id_some =
+            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some).unwrap();
+        let raw_with_counterparty_chan_id_some_back =
+            RawMsgChannelOpenInit::from(msg_with_counterparty_chan_id_some.clone());
+        let msg_with_counterparty_chan_id_some_back =
+            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some_back.clone()).unwrap();
         assert_eq!(
-            raw_with_counterpary_chan_id_some_back
+            raw_with_counterparty_chan_id_some_back
                 .channel
                 .unwrap()
                 .counterparty
@@ -179,8 +179,8 @@ mod tests {
             "".to_string()
         );
         assert_eq!(
-            msg_with_counterpary_chan_id_some,
-            msg_with_counterpary_chan_id_some_back
+            msg_with_counterparty_chan_id_some,
+            msg_with_counterparty_chan_id_some_back
         );
     }
 }

From 4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 22 Nov 2023 08:24:56 -0800
Subject: [PATCH 059/182] feat: restructure `ibc` crate (#975)

* feat: migrate `applications` module under the `ibc` crate into `ibc-apps` (#967)

* feat: restructure and split off applications codebase into ibc-apps dir

* imp: rename transfer dir to ics20_transfer

* feat: add ibc-apps crate

* fix: remove redundant dep + fix cargo doc

* docs: add README and descriptions

* docs: update main README page

* nit: docstrings

* nit: docstrings

* imp: rename folder to ics20-transfer

* chore: move serializers into ics20-transfer/types

* fix: apply reviewer comments

* imp: add docstring for cosmos_adr028_escrow_address

* fix: add missing features + use workspace deps for ibc crates

* imp: place re-exports under mod

* nit: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* fix: cargo fmt

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>

* docs: ADR-008 to restructure the `ibc` crate (#966)

* docs: write ADR for ibc crate restructure

* fix: mistaken adr007 file naming

* chore: markdown adjustment

* fix: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* docs: explanation for *-types interaction with ibc-proto

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>

* feat: migrate `core`, `clients` modules into `ibc-core`, `ibc-clients` crates (#969)

* feat: migrate `core` module under the `ibc` crate into `ibc-core`

feat: migrate `core` module under the `ibc` crate into `ibc-core`

feat: migrate `applications` module under the `ibc` crate into `ibc-apps` (#967)

* feat: restructure and split off applications codebase into ibc-apps dir

* imp: rename transfer dir to ics20_transfer

* feat: add ibc-apps crate

* fix: remove redundant dep + fix cargo doc

* docs: add README and descriptions

* docs: update main README page

* nit: docstrings

* nit: docstrings

* imp: rename folder to ics20-transfer

* chore: move serializers into ics20-transfer/types

* fix: apply reviewer comments

* imp: add docstring for cosmos_adr028_escrow_address

* fix: add missing features + use workspace deps for ibc crates

* imp: place re-exports under mod

* nit: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* fix: cargo fmt

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>

feat: restructure and split off applications codebase into ibc-apps dir

refactor: nits from nightly clippy (#962)

* use enum tuple variants directly

* use first() over get(0)

* use infallible conversion

* rm redundant export

* cargo fmt

ci: spell check on GitHub workflows (#964)

* typos github action

* cutom config for typos

* fix spelling to counterparty

* fix spelling to transfer

imp: rename transfer dir to ics20_transfer

feat: add ibc-apps crate

fix: remove redundant dep + fix cargo doc

docs: add README and descriptions

docs: update main README page

nit: docstrings

nit: docstrings

imp: rename folder to ics20-transfer

chore: move serializers into ics20-transfer/types

fix: apply reviewer comments

imp: add docstring for cosmos_adr028_escrow_address

fix: add missing features + use workspace deps for ibc crates

imp: place re-exports under mod

feat: ibc core codebase overhaul (part-1)

feat: ibc core codebase overhaul (part-2)

chore: comment out ibc-query & ibc-testkit

fix: add missing features

nit

* fix: re-export ibc_apps in the ibc crate

* chore: adjust features + add description for crates

* fix: CI catches

* fix: no_std

* imp: define ics25-handler + move tendermint-specific impls into ibc-core-host-tendermint

* fix: cargo doc

* docs: add and edit READMEs

* fix: cargo hack catches

* fix: cargo udeps catches

* chore: ajdust README tables

* docs: further README adjustments

* fix: typo

* chore: another review of comments & READMEs

* imp: move Any and Protobuf to ibc-primitives

* fix: missing std features

* Split out ibc-clients crate (#971)

* Migrate crates/ibc-clients

* Fix dependencies in types directory

* Fix dependencies in ibc-clients crate

* Delete ibc/ics07_tendermint directory

* Resolve dependencies in ibc crate

* Resolve dependencies in ibc-clients crate

* Wrap ClientState type in a newtype wrapper

* Address all compilation errors

* Migrate crates/ibc-clients

* Fix dependencies in types directory

* Fix dependencies in ibc-clients crate

* Delete ibc/ics07_tendermint directory

* Resolve dependencies in ibc crate

* Resolve dependencies in ibc-clients crate

* Wrap ClientState type in a newtype wrapper

* Address all compilation errors

* Add default feature `std` for ibc-clients crate

* Change cfg derivation

* Fixing import paths

* Fix import paths for ibc-client-tendermint crate

* Fix merge conflicts

* Fix merge conflicts

* Fix merge conflicts

* Fix remaining compilation errors in ics07-tendermint crate

* chore: adjust import paths, features and READMEs

* fix: CI catches

* fix: add serde dep for ibc-client-tendermint

* fix: serde_tests

* imp: rename ClientState to ClientStateWrapper

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* docs: improve crates descriptions

* fix: apply reviewer comments

* Delete some unused modules and add some documentation

* Add TODO to use u64::dev_ceil

* Formatting of ibc-primitives README

* fix: ibc-primitives serde feature

---------

Co-authored-by: Sean Chen <seanchen11235@gmail.com>

* imp: move crates into the root directory

* chore: add unclogs + fix broken links

* fix: additional deps and features adjustment

* fix: cargo fmt, clippy

* imp: review ibc-core-host-cosmos crate

* fix: move consensus_state API implementation into ibc-client-tendermint

* Delete empty ics07-tendermint/types README

* fix: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* fix: adjust comments, markdowns

* nit: further touchups

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 ...and-tendermint-client-to-separate-crate.md |   3 +
 .../breaking-changes/965-restructure-ibc.md   |   5 +
 .../697-re-export-essential-proto-types.md    |   3 +
 ...771-use-mod-rs-places-having-submodules.md |   2 +
 .../948-remove-redundant-test-log-deps.md     |   2 +
 ...md => 952-expose-channel-message-types.md} |   0
 ...xpose-different-types-for-public-access.md |   6 +
 .github/dependabot.yml                        |   7 +-
 .github/workflows/coverage.yml                |   8 +-
 .github/workflows/cw-check.yaml               |  11 +-
 .github/workflows/no-std.yaml                 |  17 +-
 .github/workflows/rust.yml                    |  24 +-
 CONTRIBUTING.md                               |  46 +-
 Cargo.toml                                    | 110 ++-
 README.md                                     |  54 +-
 RELEASES.md                                   |  46 ++
 ci/no-std-check/Cargo.lock                    | 320 ++++++++-
 ci/no-std-check/Cargo.toml                    |   2 +-
 crates/ibc/clippy.toml => clippy.toml         |   0
 crates/ibc-derive/Cargo.toml                  |  17 -
 crates/ibc-derive/README.md                   |  83 ---
 crates/ibc-query/README.md                    |   7 -
 crates/ibc-testkit/Cargo.toml                 |  56 --
 crates/ibc-testkit/README.md                  |   6 -
 .../testapp/ibc/clients/mock/header copy.rs   | 136 ----
 crates/ibc/Cargo.toml                         |  87 ---
 crates/ibc/README.md                          |  83 ---
 crates/ibc/src/applications/mod.rs            |   4 -
 crates/ibc/src/applications/transfer/mod.rs   |  41 --
 .../ibc/src/clients/ics07_tendermint/mod.rs   |  34 -
 crates/ibc/src/clients/mod.rs                 |  16 -
 crates/ibc/src/core/ics02_client/mod.rs       |  13 -
 .../ibc/src/core/ics03_connection/handler.rs  |   7 -
 crates/ibc/src/core/ics03_connection/mod.rs   |  11 -
 crates/ibc/src/core/ics04_channel/handler.rs  |  13 -
 crates/ibc/src/core/ics04_channel/mod.rs      |  17 -
 crates/ibc/src/core/ics23_commitment/mod.rs   |   7 -
 crates/ibc/src/core/ics24_host/identifier.rs  | 629 ------------------
 crates/ibc/src/core/ics24_host/mod.rs         |   5 -
 crates/ibc/src/core/mod.rs                    |  44 --
 crates/ibc/src/core/msgs.rs                   | 203 ------
 crates/ibc/src/hosts/mod.rs                   |   2 -
 crates/ibc/src/hosts/tendermint/mod.rs        |  12 -
 crates/ibc/src/lib.rs                         |  72 --
 crates/ibc/src/serializers.rs                 |  74 ---
 crates/ibc/src/utils/mod.rs                   |   3 -
 .../adr-006-upgrade-client-implementation.md  |  12 +-
 .../adr-008-restructure-ibc-crate.md          | 190 ++++++
 ibc-apps/Cargo.toml                           |  40 ++
 ibc-apps/README.md                            |  37 ++
 ibc-apps/ics20-transfer/Cargo.toml            |  56 ++
 ibc-apps/ics20-transfer/src/context.rs        |  81 +++
 .../ics20-transfer/src/handler/mod.rs         |  17 +-
 .../src/handler}/on_recv_packet.rs            |  17 +-
 .../src/handler}/send_transfer.rs             |  28 +-
 ibc-apps/ics20-transfer/src/lib.rs            |  32 +
 .../ics20-transfer/src/module.rs              | 206 ++----
 ibc-apps/ics20-transfer/types/Cargo.toml      |  78 +++
 .../ics20-transfer/types/src}/amount.rs       |   9 +-
 .../ics20-transfer/types/src}/coin.rs         |   3 +-
 .../ics20-transfer/types/src}/denom.rs        |  10 +-
 .../ics20-transfer/types/src}/error.rs        |  13 +-
 .../ics20-transfer/types/src}/events.rs       |  30 +-
 ibc-apps/ics20-transfer/types/src/lib.rs      |  69 ++
 .../ics20-transfer/types/src}/memo.rs         |   2 +-
 .../ics20-transfer/types/src/msgs/mod.rs      |   1 -
 .../types/src}/msgs/transfer.rs               |  16 +-
 .../ics20-transfer/types/src}/packet.rs       |   8 +-
 .../ics20-transfer/types/src/serializers.rs   |  27 +
 ibc-apps/src/lib.rs                           |  20 +
 ibc-clients/Cargo.toml                        |  40 ++
 ibc-clients/README.md                         |  46 ++
 ibc-clients/ics07-tendermint/Cargo.toml       |  79 +++
 .../ics07-tendermint/src/client_state.rs      | 584 ++++++++++++++++
 .../src}/client_state/misbehaviour.rs         |  58 +-
 .../src}/client_state/update_client.rs        |  81 ++-
 .../ics07-tendermint/src/consensus_state.rs   |  98 +++
 .../ics07-tendermint/src}/context.rs          |  17 +-
 ibc-clients/ics07-tendermint/src/lib.rs       |  31 +
 ibc-clients/ics07-tendermint/types/Cargo.toml | 106 +++
 .../types/src}/client_state.rs                | 582 ++--------------
 .../types/src}/consensus_state.rs             |  41 +-
 .../ics07-tendermint/types/src}/error.rs      |  12 +-
 .../ics07-tendermint/types/src}/header.rs     |  39 +-
 ibc-clients/ics07-tendermint/types/src/lib.rs |  63 ++
 .../types/src}/misbehaviour.rs                |  10 +-
 .../types/src}/trust_threshold.rs             |   3 +-
 ibc-clients/src/lib.rs                        |  18 +
 ibc-core/Cargo.toml                           |  75 +++
 ibc-core/README.md                            | 128 ++++
 ibc-core/ics02-client/Cargo.toml              |  75 +++
 ibc-core/ics02-client/context/Cargo.toml      |  81 +++
 .../ics02-client/context/src}/client_state.rs |  66 +-
 .../context/src}/consensus_state.rs           |   7 +-
 .../ics02-client/context/src}/context.rs      |  15 +-
 ibc-core/ics02-client/context/src/lib.rs      |  30 +
 .../src}/handler/create_client.rs             |  24 +-
 .../ics02-client/src/handler/mod.rs           |   0
 .../src}/handler/update_client.rs             |  26 +-
 .../src}/handler/upgrade_client.rs            |  33 +-
 ibc-core/ics02-client/src/lib.rs              |  31 +
 ibc-core/ics02-client/types/Cargo.toml        |  88 +++
 .../ics02-client/types/src}/error.rs          |  29 +-
 .../ics02-client/types/src}/events.rs         |   9 +-
 .../ics02-client/types/src}/height.rs         |   4 +-
 ibc-core/ics02-client/types/src/lib.rs        |  29 +
 .../types/src}/msgs/create_client.rs          |  14 +-
 .../types/src}/msgs/misbehaviour.rs           |  13 +-
 .../ics02-client/types/src/msgs/mod.rs        |  30 +-
 .../types/src}/msgs/update_client.rs          |  16 +-
 .../types/src}/msgs/upgrade_client.rs         |  19 +-
 ibc-core/ics02-client/types/src/status.rs     |  47 ++
 ibc-core/ics03-connection/Cargo.toml          |  68 ++
 .../ics03-connection/src}/delay.rs            |  11 +-
 .../src}/handler/conn_open_ack.rs             |  50 +-
 .../src}/handler/conn_open_confirm.rs         |  45 +-
 .../src}/handler/conn_open_init.rs            |  26 +-
 .../src}/handler/conn_open_try.rs             |  53 +-
 .../ics03-connection/src/handler}/mod.rs      |   0
 ibc-core/ics03-connection/src/lib.rs          |  26 +
 ibc-core/ics03-connection/types/Cargo.toml    |  95 +++
 .../ics03-connection/types/src}/connection.rs |  14 +-
 .../ics03-connection/types/src}/error.rs      |  13 +-
 .../ics03-connection/types/src}/events.rs     |   9 +-
 ibc-core/ics03-connection/types/src/lib.rs    |  29 +
 .../types/src}/msgs/conn_open_ack.rs          |  24 +-
 .../types/src}/msgs/conn_open_confirm.rs      |  22 +-
 .../types/src}/msgs/conn_open_init.rs         |  20 +-
 .../types/src}/msgs/conn_open_try.rs          |  26 +-
 .../ics03-connection/types/src/msgs/mod.rs    |  19 +-
 .../ics03-connection/types/src}/version.rs    |  19 +-
 ibc-core/ics04-channel/Cargo.toml             |  84 +++
 .../ics04-channel/src}/context.rs             |  70 +-
 .../src}/handler/acknowledgement.rs           |  42 +-
 .../src}/handler/chan_close_confirm.rs        |  43 +-
 .../src}/handler/chan_close_init.rs           |  31 +-
 .../src}/handler/chan_open_ack.rs             |  44 +-
 .../src}/handler/chan_open_confirm.rs         |  43 +-
 .../src}/handler/chan_open_init.rs            |  29 +-
 .../src}/handler/chan_open_try.rs             |  45 +-
 ibc-core/ics04-channel/src/handler/mod.rs     |  24 +
 .../ics04-channel/src}/handler/recv_packet.rs |  50 +-
 .../ics04-channel/src}/handler/send_packet.rs |  38 +-
 .../ics04-channel/src}/handler/timeout.rs     |  49 +-
 .../src}/handler/timeout_on_close.rs          |  35 +-
 ibc-core/ics04-channel/src/lib.rs             |  26 +
 ibc-core/ics04-channel/types/Cargo.toml       | 101 +++
 .../types/src}/acknowledgement.rs             |  70 +-
 .../ics04-channel/types/src}/channel.rs       |  17 +-
 .../ics04-channel/types/src}/commitment.rs    |   9 +-
 .../ics04-channel/types/src}/error.rs         |  17 +-
 .../types/src}/events/channel_attributes.rs   |   4 +-
 .../ics04-channel/types/src/events/mod.rs     |  11 +-
 .../types/src}/events/packet_attributes.rs    |  15 +-
 ibc-core/ics04-channel/types/src/lib.rs       |  35 +
 .../types/src}/msgs/acknowledgement.rs        |  26 +-
 .../types/src}/msgs/chan_close_confirm.rs     |  21 +-
 .../types/src}/msgs/chan_close_init.rs        |  18 +-
 .../types/src}/msgs/chan_open_ack.rs          |  24 +-
 .../types/src}/msgs/chan_open_confirm.rs      |  22 +-
 .../types/src}/msgs/chan_open_init.rs         |  26 +-
 .../types/src}/msgs/chan_open_try.rs          |  30 +-
 .../ics04-channel/types/src/msgs/mod.rs       |  50 +-
 .../types/src}/msgs/recv_packet.rs            |  24 +-
 .../ics04-channel/types/src}/msgs/timeout.rs  |  25 +-
 .../types/src}/msgs/timeout_on_close.rs       |  23 +-
 .../ics04-channel/types/src}/packet.rs        |  93 +--
 .../ics04-channel/types/src}/timeout.rs       |   9 +-
 .../ics04-channel/types/src}/version.rs       |   3 +-
 ibc-core/ics23-commitment/types/Cargo.toml    |  74 +++
 .../ics23-commitment/types/src}/commitment.rs |   8 +-
 .../ics23-commitment/types/src}/error.rs      |   3 +-
 ibc-core/ics23-commitment/types/src/lib.rs    |  31 +
 .../ics23-commitment/types/src}/merkle.rs     |   8 +-
 .../ics23-commitment/types/src/serializer.rs  |  14 +
 .../ics23-commitment/types/src}/specs.rs      |   3 +-
 ibc-core/ics24-host/Cargo.toml                |  90 +++
 ibc-core/ics24-host/cosmos/Cargo.toml         | 113 ++++
 ibc-core/ics24-host/cosmos/src/lib.rs         |  30 +
 .../cosmos/src}/upgrade_proposal/context.rs   |  11 +-
 .../cosmos/src}/upgrade_proposal/events.rs    |   5 +-
 .../cosmos/src}/upgrade_proposal/handler.rs   |  13 +-
 .../cosmos/src}/upgrade_proposal/mod.rs       |   0
 .../cosmos/src}/upgrade_proposal/plan.rs      |   9 +-
 .../cosmos/src}/upgrade_proposal/proposal.rs  |   5 +-
 ibc-core/ics24-host/cosmos/src/utils.rs       |  57 ++
 .../cosmos/src}/validate_self_client.rs       |  56 +-
 .../ics24-host/src}/context.rs                | 110 +--
 ibc-core/ics24-host/src/lib.rs                |  29 +
 ibc-core/ics24-host/src/utils.rs              |  47 ++
 ibc-core/ics24-host/types/Cargo.toml          |  62 ++
 ibc-core/ics24-host/types/src/error.rs        |  31 +
 .../types/src/identifiers/chain_id.rs         | 272 ++++++++
 .../types/src/identifiers/channel_id.rs       | 100 +++
 .../types/src/identifiers/client_id.rs        |  92 +++
 .../types/src/identifiers}/client_type.rs     |   7 +-
 .../types/src/identifiers/connection_id.rs    |  93 +++
 .../ics24-host/types/src/identifiers/mod.rs   |  17 +
 .../types/src/identifiers/port_id.rs          |  72 ++
 .../types/src/identifiers/sequence.rs         |  65 ++
 ibc-core/ics24-host/types/src/lib.rs          |  21 +
 .../ics24-host/types/src}/path.rs             |  44 +-
 .../ics24-host/types/src}/validate.rs         |   7 +-
 ibc-core/ics25-handler/Cargo.toml             |  76 +++
 .../ics25-handler/src/entrypoint.rs           |  70 +-
 ibc-core/ics25-handler/src/lib.rs             |  26 +
 ibc-core/ics25-handler/types/Cargo.toml       | 115 ++++
 ibc-core/ics25-handler/types/src/error.rs     |  48 ++
 .../ics25-handler/types/src}/events.rs        | 108 +--
 ibc-core/ics25-handler/types/src/lib.rs       |  21 +
 ibc-core/ics25-handler/types/src/msgs.rs      | 206 ++++++
 ibc-core/ics26-routing/Cargo.toml             |  66 ++
 ibc-core/ics26-routing/src/lib.rs             |  24 +
 .../ics26-routing/src/module.rs               | 107 +--
 ibc-core/ics26-routing/src/router.rs          |  18 +
 ibc-core/ics26-routing/types/Cargo.toml       |  84 +++
 ibc-core/ics26-routing/types/src/error.rs     |  19 +
 ibc-core/ics26-routing/types/src/event.rs     |  67 ++
 ibc-core/ics26-routing/types/src/lib.rs       |  24 +
 ibc-core/ics26-routing/types/src/module.rs    |  74 +++
 ibc-core/src/lib.rs                           |  67 ++
 ibc-data-types/Cargo.toml                     |  83 +++
 ibc-data-types/README.md                      |  50 ++
 ibc-data-types/src/lib.rs                     |  77 +++
 ibc-derive/Cargo.toml                         |  17 +
 {crates/ibc-derive => ibc-derive}/LICENSE     |   0
 ibc-derive/README.md                          |   9 +
 .../src/client_state.rs                       |   0
 .../src/client_state/traits.rs                |   0
 .../traits/client_state_common.rs             |   0
 .../traits/client_state_execution.rs          |   0
 .../traits/client_state_validation.rs         |   0
 .../src/consensus_state.rs                    |   0
 {crates/ibc-derive => ibc-derive}/src/lib.rs  |   0
 .../ibc-derive => ibc-derive}/src/utils.rs    |  32 +-
 ibc-primitives/Cargo.toml                     |  68 ++
 ibc-primitives/README.md                      |   5 +
 ibc-primitives/src/lib.rs                     |  32 +
 {crates/ibc => ibc-primitives}/src/prelude.rs |   0
 ibc-primitives/src/traits/mod.rs              |   3 +
 ibc-primitives/src/traits/msg.rs              |  23 +
 ibc-primitives/src/types/mod.rs               |   5 +
 .../src/types}/signer.rs                      |   0
 .../src/types}/timestamp.rs                   |   7 +-
 .../src/utils/macros.rs                       |   6 +-
 ibc-primitives/src/utils/mod.rs               |   5 +
 .../src/utils/pretty.rs                       |   3 +
 {crates/ibc-query => ibc-query}/Cargo.toml    |   4 +-
 {crates/ibc-query => ibc-query}/LICENSE       |   0
 ibc-query/README.md                           |   7 +
 .../src/core/channel/mod.rs                   |   0
 .../src/core/channel/query.rs                 |  15 +-
 .../src/core/channel/service.rs               |   4 +-
 .../src/core/client/mod.rs                    |   0
 .../src/core/client/query.rs                  |  27 +-
 .../src/core/client/service.rs                |   6 +-
 .../src/core/connection/mod.rs                |   0
 .../src/core/connection/query.rs              |  14 +-
 .../src/core/connection/service.rs            |   4 +-
 .../src/core/context.rs                       |  17 +-
 .../ibc-query => ibc-query}/src/core/mod.rs   |   0
 {crates/ibc-query => ibc-query}/src/error.rs  |   6 +-
 {crates/ibc-query => ibc-query}/src/lib.rs    |  10 +-
 ibc-testkit/Cargo.toml                        |  77 +++
 ibc-testkit/README.md                         |   7 +
 .../src/hosts/block.rs                        |  18 +-
 .../src/hosts/mod.rs                          |   0
 .../ibc-testkit => ibc-testkit}/src/lib.rs    |   0
 .../src/relayer/context.rs                    |  28 +-
 .../src/relayer/error.rs                      |  11 +-
 .../src/relayer/mod.rs                        |   0
 .../src/testapp/ibc/applications/mod.rs       |   0
 .../ibc/applications/transfer/context.rs      |  14 +-
 .../testapp/ibc/applications/transfer/mod.rs  |   1 +
 .../ibc/applications/transfer/module.rs       |  19 +-
 .../ibc/applications/transfer/types.rs        |   0
 .../testapp/ibc/clients/mock/client_state.rs  |  68 +-
 .../ibc/clients/mock/consensus_state.rs       |  19 +-
 .../src/testapp/ibc/clients/mock/header.rs    |  11 +-
 .../testapp/ibc/clients/mock/misbehaviour.rs  |  10 +-
 .../src/testapp/ibc/clients/mock/mod.rs       |   5 +
 .../src/testapp/ibc/clients/mod.rs            |  27 +-
 .../src/testapp/ibc/core/client_ctx.rs        |  31 +-
 .../src/testapp/ibc/core/core_ctx.rs          |  44 +-
 .../src/testapp/ibc/core/mod.rs               |   0
 .../src/testapp/ibc/core/router/context.rs    |   6 +-
 .../src/testapp/ibc/core/router/mod.rs        |   0
 .../src/testapp/ibc/core/router/types.rs      |   9 +-
 .../src/testapp/ibc/core/types.rs             |  49 +-
 .../src/testapp/ibc/mod.rs                    |   0
 .../src/testapp/mod.rs                        |   0
 .../src/utils/dummies/applications/mod.rs     |   0
 .../utils/dummies/applications/transfer.rs    |  15 +-
 .../src/utils/dummies/clients/mock.rs         |   3 +-
 .../src/utils/dummies/clients/mod.rs          |   0
 .../src/utils/dummies/clients/tendermint.rs   |  45 +-
 .../dummies/core/channel/acknowledgement.rs   |   4 +-
 .../core/channel/chan_close_confirm.rs        |   8 +-
 .../dummies/core/channel/chan_close_init.rs   |   6 +-
 .../dummies/core/channel/chan_open_ack.rs     |   8 +-
 .../dummies/core/channel/chan_open_confirm.rs |   8 +-
 .../dummies/core/channel/chan_open_init.rs    |   6 +-
 .../dummies/core/channel/chan_open_try.rs     |   8 +-
 .../src/utils/dummies/core/channel/mod.rs     |   8 +-
 .../src/utils/dummies/core/channel/packet.rs  |  14 +-
 .../utils/dummies/core/channel/recv_packet.rs |  14 +-
 .../src/utils/dummies/core/channel/timeout.rs |   4 +-
 .../dummies/core/channel/timeout_on_close.rs  |   4 +-
 .../src/utils/dummies/core/client/mod.rs      |   0
 .../dummies/core/client/msg_create_client.rs  |   6 +-
 .../dummies/core/client/msg_update_client.rs  |   4 +-
 .../dummies/core/client/msg_upgrade_client.rs |   8 +-
 .../src/utils/dummies/core/commitment.rs      |   8 +-
 .../dummies/core/connection/conn_open_ack.rs  |  14 +-
 .../core/connection/conn_open_confirm.rs      |   6 +-
 .../dummies/core/connection/conn_open_init.rs |  12 +-
 .../dummies/core/connection/conn_open_try.rs  |  14 +-
 .../src/utils/dummies/core/connection/mod.rs  |   8 +-
 .../src/utils/dummies/core/context.rs         |   8 +-
 .../src/utils/dummies/core/mod.rs             |   0
 .../src/utils/dummies/core/signer.rs          |   4 +-
 .../src/utils/dummies/mod.rs                  |   0
 .../src/utils/fixture.rs                      |   9 +-
 .../src/utils/mod.rs                          |   0
 .../tests/applications/mod.rs                 |   0
 .../tests/applications/transfer.rs            |  17 +-
 .../tests/core/ics02_client/create_client.rs  |  18 +-
 .../tests/core/ics02_client/mod.rs            |   0
 .../tests/core/ics02_client/update_client.rs  |  53 +-
 .../tests/core/ics02_client/upgrade_client.rs |  33 +-
 .../core/ics03_connection/conn_open_ack.rs    |  37 +-
 .../ics03_connection/conn_open_confirm.rs     |  20 +-
 .../core/ics03_connection/conn_open_init.rs   |  17 +-
 .../core/ics03_connection/conn_open_try.rs    |  16 +-
 .../tests/core/ics03_connection/mod.rs        |   4 +
 .../core/ics04_channel/acknowledgement.rs     |  28 +-
 .../core/ics04_channel/chan_close_confirm.rs  |  21 +-
 .../core/ics04_channel/chan_close_init.rs     |  21 +-
 .../tests/core/ics04_channel/chan_open_ack.rs |  25 +-
 .../core/ics04_channel/chan_open_confirm.rs   |  23 +-
 .../core/ics04_channel/chan_open_init.rs      |  20 +-
 .../tests/core/ics04_channel/chan_open_try.rs |  20 +-
 .../tests/core/ics04_channel/mod.rs           |   0
 .../tests/core/ics04_channel/recv_packet.rs   |  28 +-
 .../tests/core/ics04_channel/send_packet.rs   |  21 +-
 .../tests/core/ics04_channel/timeout.rs       |  28 +-
 .../core/ics04_channel/timeout_on_close.rs    |  26 +-
 .../tests/core/mod.rs                         |   0
 .../tests/core/router.rs                      |  49 +-
 .../tests/data/json/client_state.json         |   0
 .../tests/data/json/client_state_proof.json   |   0
 .../tests/data/json/consensus_state.json      |   0
 .../data/json/consensus_state_proof.json      |   0
 .../tests/data/json/signed_header.json        |   0
 .../ibc-testkit => ibc-testkit}/tests/mod.rs  |   0
 ibc/Cargo.toml                                |  68 ++
 ibc/README.md                                 |  68 ++
 ibc/src/lib.rs                                |  73 ++
 358 files changed, 8187 insertions(+), 4657 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
 create mode 100644 .changelog/unreleased/breaking-changes/965-restructure-ibc.md
 create mode 100644 .changelog/unreleased/improvements/697-re-export-essential-proto-types.md
 create mode 100644 .changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md
 create mode 100644 .changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md
 rename .changelog/unreleased/improvements/{952-expose-channel-message-types copy.md => 952-expose-channel-message-types.md} (100%)
 create mode 100644 .changelog/unreleased/improvements/976-expose-different-types-for-public-access.md
 create mode 100644 RELEASES.md
 rename crates/ibc/clippy.toml => clippy.toml (100%)
 delete mode 100644 crates/ibc-derive/Cargo.toml
 delete mode 100644 crates/ibc-derive/README.md
 delete mode 100644 crates/ibc-query/README.md
 delete mode 100644 crates/ibc-testkit/Cargo.toml
 delete mode 100644 crates/ibc-testkit/README.md
 delete mode 100644 crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs
 delete mode 100644 crates/ibc/Cargo.toml
 delete mode 100644 crates/ibc/README.md
 delete mode 100644 crates/ibc/src/applications/mod.rs
 delete mode 100644 crates/ibc/src/applications/transfer/mod.rs
 delete mode 100644 crates/ibc/src/clients/ics07_tendermint/mod.rs
 delete mode 100644 crates/ibc/src/clients/mod.rs
 delete mode 100644 crates/ibc/src/core/ics02_client/mod.rs
 delete mode 100644 crates/ibc/src/core/ics03_connection/handler.rs
 delete mode 100644 crates/ibc/src/core/ics03_connection/mod.rs
 delete mode 100644 crates/ibc/src/core/ics04_channel/handler.rs
 delete mode 100644 crates/ibc/src/core/ics04_channel/mod.rs
 delete mode 100644 crates/ibc/src/core/ics23_commitment/mod.rs
 delete mode 100644 crates/ibc/src/core/ics24_host/identifier.rs
 delete mode 100644 crates/ibc/src/core/ics24_host/mod.rs
 delete mode 100644 crates/ibc/src/core/mod.rs
 delete mode 100644 crates/ibc/src/core/msgs.rs
 delete mode 100644 crates/ibc/src/hosts/mod.rs
 delete mode 100644 crates/ibc/src/hosts/tendermint/mod.rs
 delete mode 100644 crates/ibc/src/lib.rs
 delete mode 100644 crates/ibc/src/serializers.rs
 delete mode 100644 crates/ibc/src/utils/mod.rs
 create mode 100644 docs/architecture/adr-008-restructure-ibc-crate.md
 create mode 100644 ibc-apps/Cargo.toml
 create mode 100644 ibc-apps/README.md
 create mode 100644 ibc-apps/ics20-transfer/Cargo.toml
 create mode 100644 ibc-apps/ics20-transfer/src/context.rs
 rename crates/ibc/src/applications/transfer/relay.rs => ibc-apps/ics20-transfer/src/handler/mod.rs (81%)
 rename {crates/ibc/src/applications/transfer/relay => ibc-apps/ics20-transfer/src/handler}/on_recv_packet.rs (90%)
 rename {crates/ibc/src/applications/transfer/relay => ibc-apps/ics20-transfer/src/handler}/send_transfer.rs (88%)
 create mode 100644 ibc-apps/ics20-transfer/src/lib.rs
 rename crates/ibc/src/applications/transfer/context.rs => ibc-apps/ics20-transfer/src/module.rs (62%)
 create mode 100644 ibc-apps/ics20-transfer/types/Cargo.toml
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/amount.rs (95%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/coin.rs (99%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/denom.rs (98%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/error.rs (91%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/events.rs (83%)
 create mode 100644 ibc-apps/ics20-transfer/types/src/lib.rs
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/memo.rs (96%)
 rename crates/ibc/src/applications/transfer/msgs.rs => ibc-apps/ics20-transfer/types/src/msgs/mod.rs (98%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/msgs/transfer.rs (91%)
 rename {crates/ibc/src/applications/transfer => ibc-apps/ics20-transfer/types/src}/packet.rs (95%)
 create mode 100644 ibc-apps/ics20-transfer/types/src/serializers.rs
 create mode 100644 ibc-apps/src/lib.rs
 create mode 100644 ibc-clients/Cargo.toml
 create mode 100644 ibc-clients/README.md
 create mode 100644 ibc-clients/ics07-tendermint/Cargo.toml
 create mode 100644 ibc-clients/ics07-tendermint/src/client_state.rs
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/src}/client_state/misbehaviour.rs (71%)
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/src}/client_state/update_client.rs (74%)
 create mode 100644 ibc-clients/ics07-tendermint/src/consensus_state.rs
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/src}/context.rs (83%)
 create mode 100644 ibc-clients/ics07-tendermint/src/lib.rs
 create mode 100644 ibc-clients/ics07-tendermint/types/Cargo.toml
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/client_state.rs (53%)
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/consensus_state.rs (85%)
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/error.rs (95%)
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/header.rs (87%)
 create mode 100644 ibc-clients/ics07-tendermint/types/src/lib.rs
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/misbehaviour.rs (94%)
 rename {crates/ibc/src/clients/ics07_tendermint => ibc-clients/ics07-tendermint/types/src}/trust_threshold.rs (98%)
 create mode 100644 ibc-clients/src/lib.rs
 create mode 100644 ibc-core/Cargo.toml
 create mode 100644 ibc-core/README.md
 create mode 100644 ibc-core/ics02-client/Cargo.toml
 create mode 100644 ibc-core/ics02-client/context/Cargo.toml
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/context/src}/client_state.rs (80%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/context/src}/consensus_state.rs (88%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/context/src}/context.rs (90%)
 create mode 100644 ibc-core/ics02-client/context/src/lib.rs
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/src}/handler/create_client.rs (75%)
 rename crates/ibc/src/core/ics02_client/handler.rs => ibc-core/ics02-client/src/handler/mod.rs (100%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/src}/handler/update_client.rs (83%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/src}/handler/upgrade_client.rs (68%)
 create mode 100644 ibc-core/ics02-client/src/lib.rs
 create mode 100644 ibc-core/ics02-client/types/Cargo.toml
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/error.rs (90%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/events.rs (98%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/height.rs (98%)
 create mode 100644 ibc-core/ics02-client/types/src/lib.rs
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/msgs/create_client.rs (88%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/msgs/misbehaviour.rs (86%)
 rename crates/ibc/src/core/ics02_client/msgs.rs => ibc-core/ics02-client/types/src/msgs/mod.rs (65%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/msgs/update_client.rs (86%)
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics02-client/types/src}/msgs/upgrade_client.rs (88%)
 create mode 100644 ibc-core/ics02-client/types/src/status.rs
 create mode 100644 ibc-core/ics03-connection/Cargo.toml
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/src}/delay.rs (87%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/src}/handler/conn_open_ack.rs (79%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/src}/handler/conn_open_confirm.rs (77%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/src}/handler/conn_open_init.rs (72%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/src}/handler/conn_open_try.rs (80%)
 rename {crates/ibc-testkit/tests/core/ics03_connection => ibc-core/ics03-connection/src/handler}/mod.rs (100%)
 create mode 100644 ibc-core/ics03-connection/src/lib.rs
 create mode 100644 ibc-core/ics03-connection/types/Cargo.toml
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/connection.rs (97%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/error.rs (92%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/events.rs (98%)
 create mode 100644 ibc-core/ics03-connection/types/src/lib.rs
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/msgs/conn_open_ack.rs (93%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/msgs/conn_open_confirm.rs (89%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/msgs/conn_open_init.rs (94%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/msgs/conn_open_try.rs (96%)
 rename crates/ibc/src/core/ics03_connection/msgs.rs => ibc-core/ics03-connection/types/src/msgs/mod.rs (75%)
 rename {crates/ibc/src/core/ics03_connection => ibc-core/ics03-connection/types/src}/version.rs (95%)
 create mode 100644 ibc-core/ics04-channel/Cargo.toml
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/context.rs (67%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/acknowledgement.rs (84%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_close_confirm.rs (81%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_close_init.rs (82%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_open_ack.rs (80%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_open_confirm.rs (81%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_open_init.rs (83%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/chan_open_try.rs (82%)
 create mode 100644 ibc-core/ics04-channel/src/handler/mod.rs
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/recv_packet.rs (86%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/send_packet.rs (81%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/timeout.rs (87%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/src}/handler/timeout_on_close.rs (86%)
 create mode 100644 ibc-core/ics04-channel/src/lib.rs
 create mode 100644 ibc-core/ics04-channel/types/Cargo.toml
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/acknowledgement.rs (64%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/channel.rs (98%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/commitment.rs (95%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/error.rs (94%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/events/channel_attributes.rs (97%)
 rename crates/ibc/src/core/ics04_channel/events.rs => ibc-core/ics04-channel/types/src/events/mod.rs (99%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/events/packet_attributes.rs (95%)
 create mode 100644 ibc-core/ics04-channel/types/src/lib.rs
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/acknowledgement.rs (87%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_close_confirm.rs (92%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_close_init.rs (92%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_open_ack.rs (93%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_open_confirm.rs (92%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_open_init.rs (89%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/chan_open_try.rs (91%)
 rename crates/ibc/src/core/ics04_channel/msgs.rs => ibc-core/ics04-channel/types/src/msgs/mod.rs (66%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/recv_packet.rs (88%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/timeout.rs (90%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/msgs/timeout_on_close.rs (90%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/packet.rs (88%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/timeout.rs (97%)
 rename {crates/ibc/src/core/ics04_channel => ibc-core/ics04-channel/types/src}/version.rs (98%)
 create mode 100644 ibc-core/ics23-commitment/types/Cargo.toml
 rename {crates/ibc/src/core/ics23_commitment => ibc-core/ics23-commitment/types/src}/commitment.rs (96%)
 rename {crates/ibc/src/core/ics23_commitment => ibc-core/ics23-commitment/types/src}/error.rs (97%)
 create mode 100644 ibc-core/ics23-commitment/types/src/lib.rs
 rename {crates/ibc/src/core/ics23_commitment => ibc-core/ics23-commitment/types/src}/merkle.rs (96%)
 create mode 100644 ibc-core/ics23-commitment/types/src/serializer.rs
 rename {crates/ibc/src/core/ics23_commitment => ibc-core/ics23-commitment/types/src}/specs.rs (99%)
 create mode 100644 ibc-core/ics24-host/Cargo.toml
 create mode 100644 ibc-core/ics24-host/cosmos/Cargo.toml
 create mode 100644 ibc-core/ics24-host/cosmos/src/lib.rs
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/context.rs (88%)
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/events.rs (98%)
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/handler.rs (77%)
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/mod.rs (100%)
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/plan.rs (94%)
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/upgrade_proposal/proposal.rs (96%)
 create mode 100644 ibc-core/ics24-host/cosmos/src/utils.rs
 rename {crates/ibc/src/hosts/tendermint => ibc-core/ics24-host/cosmos/src}/validate_self_client.rs (72%)
 rename {crates/ibc/src/core => ibc-core/ics24-host/src}/context.rs (75%)
 create mode 100644 ibc-core/ics24-host/src/lib.rs
 create mode 100644 ibc-core/ics24-host/src/utils.rs
 create mode 100644 ibc-core/ics24-host/types/Cargo.toml
 create mode 100644 ibc-core/ics24-host/types/src/error.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/chain_id.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/channel_id.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/client_id.rs
 rename {crates/ibc/src/core/ics02_client => ibc-core/ics24-host/types/src/identifiers}/client_type.rs (89%)
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/connection_id.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/mod.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/port_id.rs
 create mode 100644 ibc-core/ics24-host/types/src/identifiers/sequence.rs
 create mode 100644 ibc-core/ics24-host/types/src/lib.rs
 rename {crates/ibc/src/core/ics24_host => ibc-core/ics24-host/types/src}/path.rs (97%)
 rename {crates/ibc/src/core/ics24_host/identifier => ibc-core/ics24-host/types/src}/validate.rs (98%)
 create mode 100644 ibc-core/ics25-handler/Cargo.toml
 rename crates/ibc/src/core/handler.rs => ibc-core/ics25-handler/src/entrypoint.rs (79%)
 create mode 100644 ibc-core/ics25-handler/src/lib.rs
 create mode 100644 ibc-core/ics25-handler/types/Cargo.toml
 create mode 100644 ibc-core/ics25-handler/types/src/error.rs
 rename {crates/ibc/src/core => ibc-core/ics25-handler/types/src}/events.rs (76%)
 create mode 100644 ibc-core/ics25-handler/types/src/lib.rs
 create mode 100644 ibc-core/ics25-handler/types/src/msgs.rs
 create mode 100644 ibc-core/ics26-routing/Cargo.toml
 create mode 100644 ibc-core/ics26-routing/src/lib.rs
 rename crates/ibc/src/core/router.rs => ibc-core/ics26-routing/src/module.rs (58%)
 create mode 100644 ibc-core/ics26-routing/src/router.rs
 create mode 100644 ibc-core/ics26-routing/types/Cargo.toml
 create mode 100644 ibc-core/ics26-routing/types/src/error.rs
 create mode 100644 ibc-core/ics26-routing/types/src/event.rs
 create mode 100644 ibc-core/ics26-routing/types/src/lib.rs
 create mode 100644 ibc-core/ics26-routing/types/src/module.rs
 create mode 100644 ibc-core/src/lib.rs
 create mode 100644 ibc-data-types/Cargo.toml
 create mode 100644 ibc-data-types/README.md
 create mode 100644 ibc-data-types/src/lib.rs
 create mode 100644 ibc-derive/Cargo.toml
 rename {crates/ibc-derive => ibc-derive}/LICENSE (100%)
 create mode 100644 ibc-derive/README.md
 rename {crates/ibc-derive => ibc-derive}/src/client_state.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/client_state/traits.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/client_state/traits/client_state_common.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/client_state/traits/client_state_execution.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/client_state/traits/client_state_validation.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/consensus_state.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/lib.rs (100%)
 rename {crates/ibc-derive => ibc-derive}/src/utils.rs (71%)
 create mode 100644 ibc-primitives/Cargo.toml
 create mode 100644 ibc-primitives/README.md
 create mode 100644 ibc-primitives/src/lib.rs
 rename {crates/ibc => ibc-primitives}/src/prelude.rs (100%)
 create mode 100644 ibc-primitives/src/traits/mod.rs
 create mode 100644 ibc-primitives/src/traits/msg.rs
 create mode 100644 ibc-primitives/src/types/mod.rs
 rename {crates/ibc/src => ibc-primitives/src/types}/signer.rs (100%)
 rename {crates/ibc/src/core => ibc-primitives/src/types}/timestamp.rs (98%)
 rename {crates/ibc => ibc-primitives}/src/utils/macros.rs (86%)
 create mode 100644 ibc-primitives/src/utils/mod.rs
 rename {crates/ibc => ibc-primitives}/src/utils/pretty.rs (92%)
 rename {crates/ibc-query => ibc-query}/Cargo.toml (83%)
 rename {crates/ibc-query => ibc-query}/LICENSE (100%)
 create mode 100644 ibc-query/README.md
 rename {crates/ibc-query => ibc-query}/src/core/channel/mod.rs (100%)
 rename {crates/ibc-query => ibc-query}/src/core/channel/query.rs (97%)
 rename {crates/ibc-query => ibc-query}/src/core/channel/service.rs (98%)
 rename {crates/ibc-query => ibc-query}/src/core/client/mod.rs (100%)
 rename {crates/ibc-query => ibc-query}/src/core/client/query.rs (91%)
 rename {crates/ibc-query => ibc-query}/src/core/client/service.rs (97%)
 rename {crates/ibc-query => ibc-query}/src/core/connection/mod.rs (100%)
 rename {crates/ibc-query => ibc-query}/src/core/connection/query.rs (94%)
 rename {crates/ibc-query => ibc-query}/src/core/connection/service.rs (98%)
 rename {crates/ibc-query => ibc-query}/src/core/context.rs (86%)
 rename {crates/ibc-query => ibc-query}/src/core/mod.rs (100%)
 rename {crates/ibc-query => ibc-query}/src/error.rs (88%)
 rename {crates/ibc-query => ibc-query}/src/lib.rs (86%)
 create mode 100644 ibc-testkit/Cargo.toml
 create mode 100644 ibc-testkit/README.md
 rename {crates/ibc-testkit => ibc-testkit}/src/hosts/block.rs (94%)
 rename {crates/ibc-testkit => ibc-testkit}/src/hosts/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/lib.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/relayer/context.rs (92%)
 rename {crates/ibc-testkit => ibc-testkit}/src/relayer/error.rs (81%)
 rename {crates/ibc-testkit => ibc-testkit}/src/relayer/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/applications/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/applications/transfer/context.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/applications/transfer/mod.rs (64%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/applications/transfer/module.rs (83%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/applications/transfer/types.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mock/client_state.rs (85%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mock/consensus_state.rs (85%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mock/header.rs (93%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mock/misbehaviour.rs (89%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mock/mod.rs (54%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/clients/mod.rs (72%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/client_ctx.rs (91%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/core_ctx.rs (92%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/router/context.rs (82%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/router/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/router/types.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/core/types.rs (96%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/ibc/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/testapp/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/applications/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/applications/transfer.rs (85%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/clients/mock.rs (87%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/clients/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/clients/tendermint.rs (82%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/acknowledgement.rs (89%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_close_confirm.rs (70%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_close_init.rs (66%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_open_ack.rs (74%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_open_confirm.rs (70%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_open_init.rs (72%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/chan_open_try.rs (76%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/mod.rs (85%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/packet.rs (83%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/recv_packet.rs (73%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/timeout.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/channel/timeout_on_close.rs (83%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/client/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/client/msg_create_client.rs (79%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/client/msg_update_client.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/client/msg_upgrade_client.rs (87%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/commitment.rs (61%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/connection/conn_open_ack.rs (79%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/connection/conn_open_confirm.rs (78%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/connection/conn_open_init.rs (88%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/connection/conn_open_try.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/connection/mod.rs (84%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/context.rs (96%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/core/signer.rs (75%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/dummies/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/fixture.rs (79%)
 rename {crates/ibc-testkit => ibc-testkit}/src/utils/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/applications/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/applications/transfer.rs (90%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics02_client/create_client.rs (86%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics02_client/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics02_client/update_client.rs (95%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics02_client/upgrade_client.rs (86%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics03_connection/conn_open_ack.rs (88%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics03_connection/conn_open_confirm.rs (87%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics03_connection/conn_open_init.rs (90%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics03_connection/conn_open_try.rs (91%)
 create mode 100644 ibc-testkit/tests/core/ics03_connection/mod.rs
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/acknowledgement.rs (89%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_close_confirm.rs (86%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_close_init.rs (86%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_open_ack.rs (90%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_open_confirm.rs (89%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_open_init.rs (82%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/chan_open_try.rs (88%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/recv_packet.rs (89%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/send_packet.rs (91%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/timeout.rs (93%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/ics04_channel/timeout_on_close.rs (85%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/mod.rs (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/core/router.rs (91%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/data/json/client_state.json (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/data/json/client_state_proof.json (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/data/json/consensus_state.json (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/data/json/consensus_state_proof.json (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/data/json/signed_header.json (100%)
 rename {crates/ibc-testkit => ibc-testkit}/tests/mod.rs (100%)
 create mode 100644 ibc/Cargo.toml
 create mode 100644 ibc/README.md
 create mode 100644 ibc/src/lib.rs

diff --git a/.changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md b/.changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
new file mode 100644
index 000000000..600725b77
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
@@ -0,0 +1,3 @@
+- Move ICS-20 and ICS-27 implementations to the respective part of `ibc-apps`
+  and `ibc-clients` crates, as part of the `ibc` crate restructuring effort.
+  ([\#716](https://github.com/cosmos/ibc-rs/issues/716))
diff --git a/.changelog/unreleased/breaking-changes/965-restructure-ibc.md b/.changelog/unreleased/breaking-changes/965-restructure-ibc.md
new file mode 100644
index 000000000..46df0936a
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/965-restructure-ibc.md
@@ -0,0 +1,5 @@
+- Restructure `ibc-rs` codebase by organizing it into smaller self-contained,
+  modular libraries, enabling the selective import of specific domain types or
+  module implementations, either individually or in combination, providing
+  enhanced flexibility and ease of use.
+  ([\#965](https://github.com/cosmos/ibc-rs/issues/965))
diff --git a/.changelog/unreleased/improvements/697-re-export-essential-proto-types.md b/.changelog/unreleased/improvements/697-re-export-essential-proto-types.md
new file mode 100644
index 000000000..0ff69eb56
--- /dev/null
+++ b/.changelog/unreleased/improvements/697-re-export-essential-proto-types.md
@@ -0,0 +1,3 @@
+- Re-export essential proto types from the underlying `ibc-*-*-types` crates,
+  removing the necessity for a direct dependency on `ibc-proto` in projects
+  integrating `ibc-rs` ([\#697](https://github.com/cosmos/ibc-rs/issues/697))
diff --git a/.changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md b/.changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md
new file mode 100644
index 000000000..3f605655b
--- /dev/null
+++ b/.changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md
@@ -0,0 +1,2 @@
+- Rename `{submodule}.rs` with corresponding `{submodule}` directory to
+  `{submodule}/mod.rs` ([\#771](https://github.com/cosmos/ibc-rs/issues/771))
diff --git a/.changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md b/.changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md
new file mode 100644
index 000000000..704cf5c48
--- /dev/null
+++ b/.changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md
@@ -0,0 +1,2 @@
+- Remove redundant `#[test_log::test]` attributes in test modules
+  ([\#948](https://github.com/cosmos/ibc-rs/issues/948))
diff --git a/.changelog/unreleased/improvements/952-expose-channel-message-types copy.md b/.changelog/unreleased/improvements/952-expose-channel-message-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/952-expose-channel-message-types copy.md
rename to .changelog/unreleased/improvements/952-expose-channel-message-types.md
diff --git a/.changelog/unreleased/improvements/976-expose-different-types-for-public-access.md b/.changelog/unreleased/improvements/976-expose-different-types-for-public-access.md
new file mode 100644
index 000000000..e329e6744
--- /dev/null
+++ b/.changelog/unreleased/improvements/976-expose-different-types-for-public-access.md
@@ -0,0 +1,6 @@
+- Expose various fields, types and functions in `ibc-rs` as public including:
+  - `validate` and `execute` handler functions for all the IBC message types.
+  - `TYPE_URL` constants.
+  - Any private fields within the domain message types.
+  - Any private fields within the Tendermint `ClientState` and `ConsensusState`
+  ([\#976](https://github.com/cosmos/ibc-rs/issues/976))
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index fb75b4861..321a36376 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -4,11 +4,14 @@
 version: 2
 updates:
   - package-ecosystem: "cargo"
-    directory: "crates/ibc"
+    directory: "/"
     schedule:
       interval: "weekly"
-
   - package-ecosystem: "cargo"
     directory: "ci/no-std-check"
     schedule:
       interval: "weekly"
+  - package-ecosystem: "cargo"
+    directory: "ci/cw-check"
+    schedule:
+      interval: "weekly"
diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yml
index 1f9c332ba..3176c269a 100644
--- a/.github/workflows/coverage.yml
+++ b/.github/workflows/coverage.yml
@@ -7,7 +7,13 @@ on:
       - .github/workflows/coverage.yml
       - Cargo.toml
       - ci/**
-      - crates/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
   push:
     branches:
       - main
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index ae84a64d9..f4a6a89dc 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -15,8 +15,15 @@ on:
       - Cargo.toml
       - Cargo.lock
       - ci/cw-check/**
-      - crates/**
-
+      - ci/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
+      - ibc-derive/**
 jobs:
   cw-check:
     runs-on: ubuntu-20.04
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 47a2005a3..9f35e1cd7 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -6,7 +6,13 @@ on:
       - Cargo.toml
       - Cargo.lock
       - ci/no-std-check/**
-      - crates/**
+      - ci/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
   push:
     branches: main
     paths:
@@ -14,8 +20,13 @@ on:
       - Cargo.toml
       - Cargo.lock
       - ci/no-std-check/**
-      - crates/**
-
+      - ci/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
 jobs:
   check-no-std-panic-conflict:
     name: Check no_std panic conflict
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 4671367c2..6f0e35cd8 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -5,15 +5,31 @@ on:
       - .github/workflows/rust.yml
       - Cargo.toml
       - ci/**
-      - crates/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
+      - ibc-testkit/**
+      - ibc-derive/**
   push:
     branches: main
     paths:
       - .github/workflows/rust.yml
       - Cargo.toml
       - ci/**
-      - crates/**
-
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
+      - ibc-testkit/**
+      - ibc-derive/**
+      
 env:
   CARGO_INCREMENTAL: 0
   CARGO_PROFILE_DEV_DEBUG: 1
@@ -31,7 +47,7 @@ jobs:
         GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
     if: "!startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main'"
 
-  fmt:
+  nightly_fmt:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c37a4e7ec..2595d1205 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,7 +19,6 @@ repository:
 - [Pull Requests](#pull-requests) - what makes a good pull request
 - [Forking](#forking) - fork the repo to make pull requests
 - [Changelog](#changelog) - changes must be recorded in the changelog
-- [Releases](#releases) - how to release new version of the crates
 
 ## Decision Making
 
@@ -109,7 +108,7 @@ single commit for the PR with all the commit messages.
 If the issue you worked on was tagged `A: low-priority`, we'll do our best to
 review it in a timely manner, but please expect longer wait times for a review
 in general. If a low priority issue is important to you, please leave a comment
-explaining why, and we will reprioritize it!
+explaining why, and we will re-prioritize it!
 
 ## Responsibilities of a PR Reviewer
 
@@ -200,7 +199,7 @@ See those changelogs for examples.
 We currently split changes for a given release between these four sections: Breaking
 Changes, Features, Improvements, Bug Fixes.
 
-Entries in the changelog should initially be logged in the __Unreleased__ section, which
+Entries in the changelog should initially be logged in the **Unreleased** section, which
 represents a "staging area" for accumulating all the changes throughout a
 release (see [Pull Requests](#pull-requests) below). With each release,
 the entries then move from this section into their permanent place under a
@@ -232,44 +231,3 @@ Any change that effects multiple APIs/users should be recorded multiply - for
 instance, a change to some core protocol data structure might need to be
 reflected both as breaking the core protocol but also breaking any APIs where core data structures are
 exposed.
-
-## Releases
-
-Our release process is as follows:
-
-1. In a new branch `release/vX.Y.Z`, update the [changelog](#changelog) to reflect and summarize all changes in
-   the release. This involves:
-   1. Running `unclog build -u` and copy pasting the output at the top
-      of the `CHANGELOG.md` file, making sure to update the header with
-      the new version.
-   2. Running `unclog release --editor <editor> --version vX.Y.Z` to create a summary of all of the changes
-      in this release.
-      1. Your text editor will open. Write the release summary, and close the editor.
-         1. Make sure to include a comment on whether or not the release contains consensus-breaking changes.
-      2. Add this same summary to `CHANGELOG.md` as well.
-   3. Committing the updated `CHANGELOG.md` file and `.changelog` directory to the repo.
-2. Push this to a branch `release/vX.Y.Z` according to the version number of
-   the anticipated release (e.g. `release/v0.18.0`) and open a **draft PR**.
-3. If there were changes in the `ibc-derive` crate, we need to publish a new version of that crate.
-   1. bump the version in `crates/ibc-derive/Cargo.toml`
-   2. Publish `ibc-derive` with `cargo publish -p ibc-derive`
-4. Bump the versions of relevant crates (`ibc` and `ibc-query`) in their
-   `Cargo.toml` to the new version, and push these changes to the release PR.
-      - If you released a new version of `ibc-derive` in step 3, make sure to update that dependency.
-5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all the
-   documentation compiles and seems up-to-date and coherent. Fix any potential
-   issues here and push them to the release PR.
-6. Run `cargo publish -p ibc --dry-run` to double-check that publishing will work. Fix
-   any potential issues here and push them to the release PR.
-7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
-8. Once approved, merge the PR, and pull the `main` branch.
-9. Run `cargo publish -p ibc` and `cargo publish -p ibc-query` to publish the crates.
-10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
-   tag message, write the version and the link to the corresponding section of
-   the changelog.
-       - Push the tag with `git push --tags`
-11. Once the tag is pushed, create a GitHub release and append
-   `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)` 
-   to the release description.
-
-All done! 🎉
diff --git a/Cargo.toml b/Cargo.toml
index 7f65e463b..b64e02926 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,10 +1,33 @@
 [workspace]
 resolver = "2"
 members = [
-    "crates/ibc",
-    "crates/ibc-derive",
-    "crates/ibc-testkit",
-    "crates/ibc-query",
+    "ibc",
+    "ibc-data-types",
+    "ibc-primitives",
+    "ibc-core",
+    "ibc-clients",
+    "ibc-apps",
+    "ibc-testkit",
+    "ibc-query",
+    "ibc-derive",
+    "ibc-core/ics02-client",
+    "ibc-core/ics02-client/types",
+    "ibc-core/ics03-connection",
+    "ibc-core/ics03-connection/types",
+    "ibc-core/ics04-channel",
+    "ibc-core/ics04-channel/types",
+    "ibc-core/ics23-commitment/types",
+    "ibc-core/ics24-host",
+    "ibc-core/ics24-host/types",
+    "ibc-core/ics24-host/cosmos",
+    "ibc-core/ics25-handler",
+    "ibc-core/ics25-handler/types",
+    "ibc-core/ics26-routing",
+    "ibc-core/ics26-routing/types",
+    "ibc-clients/ics07-tendermint",
+    "ibc-clients/ics07-tendermint/types",
+    "ibc-apps/ics20-transfer",
+    "ibc-apps/ics20-transfer/types",
 ]
 exclude = [
     "ci/cw-check",
@@ -22,41 +45,62 @@ authors      = ["Informal Systems <hello@informal.systems>"]
 
 [workspace.dependencies]
 # external dependencies
-borsh = {version = "0.10", default-features = false }
-bytes = { version = "1.5.0", default-features = false }
-displaydoc = { version = "0.2", default-features = false }
-derive_more = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
-env_logger = "0.10.0"
-num-traits = { version = "0.2.17", default-features = false }
-parking_lot = { version = "0.12.1", default-features = false }
-primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
-prost = { version = "0.12", default-features = false }
-rstest = "0.18.2"
-schemars = { version = "0.8.15"}
-sha2 = { version = "0.10.8", default-features = false }
-serde = { version = "1.0", default-features = false }
-serde_derive = { version = "1.0", default-features = false }
-serde_json =  { package = "serde-json-wasm", version = "1.0.0" , default-features = false }
-subtle-encoding = { version = "0.5", default-features = false }
-test-log = { version = "0.2.13", features = ["trace"] }
-time = { version = ">=0.3.0, <0.3.31", default-features = false }
-tracing = { version = "0.1.40", default-features = false }
-tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
-typed-builder = { version = "0.18.0"}
+borsh               = { version = "0.10", default-features = false }
+bytes               = { version = "1.5.0", default-features = false }
+displaydoc          = { version = "0.2", default-features = false }
+derive_more         = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
+num-traits          = { version = "0.2.17", default-features = false }
+primitive-types     = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
+prost               = { version = "0.12", default-features = false }
+rstest              = "0.18.2"
+schemars            = { version = "0.8.15" }
+sha2                = { version = "0.10.8", default-features = false }
+serde               = { version = "1.0", default-features = false }
+serde_json          = { package = "serde-json-wasm", version = "1.0.0" , default-features = false }
+subtle-encoding     = { version = "0.5", default-features = false }
+time                = { version = ">=0.3.0, <0.3.31", default-features = false }
 
 # ibc dependencies
-ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
+ibc                 = { version = "0.47.0", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.47.0", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.47.0", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.47.0", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.47.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit         = { version = "0.47.0", path = "./ibc-testkit" }
+ibc-derive          = { version = "0.3.0", path = "./ibc-derive" }
+
+ibc-core-client       = { version = "0.47.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.47.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.47.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.47.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.47.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.47.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.47.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.47.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+
+ibc-core-client-context     = { version = "0.47.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.47.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.47.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.47.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.47.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.47.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.47.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.47.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.47.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.47.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.47.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+
 ibc-proto = { version = "0.38.0", default-features = false }
-ics23 = { version = "0.11", default-features = false }
+ics23     = { version = "0.11", default-features = false }
 
 # cosmos dependencies
-tendermint = { version = "0.34.0", default-features = false }
-tendermint-light-client = { version = "0.34.0", default-features = false }
+tendermint                       = { version = "0.34.0", default-features = false }
+tendermint-light-client          = { version = "0.34.0", default-features = false }
 tendermint-light-client-verifier = { version = "0.34.0", default-features = false }
-tendermint-proto = { version = "0.34.0", default-features = false }
-tendermint-rpc = { version = "0.34.0", default-features = false }
-tendermint-testgen = { version = "0.34.0", default-features = false }
+tendermint-proto                 = { version = "0.34.0", default-features = false }
+tendermint-rpc                   = { version = "0.34.0", default-features = false }
+tendermint-testgen               = { version = "0.34.0", default-features = false }
 
 # parity dependencies
 parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"] }
-scale-info = { version = "2.10.0", default-features = false, features = ["derive"] }
+scale-info         = { version = "2.10.0", default-features = false, features = ["derive"] }
diff --git a/README.md b/README.md
index 6bcd01fe8..51971b1bb 100644
--- a/README.md
+++ b/README.md
@@ -23,27 +23,32 @@
 </div>
 </div>
 
-Rust implementation of the Inter-Blockchain Communication (IBC) protocol. This project hosts
-the `ibc` rust crate which defines the main data structures and on-chain logic for the IBC protocol.
-
-## Libraries
-
-- [ibc](crates/ibc/README.md) - Data structures and on-chain logic for the IBC protocol.
-- [ibc-derive](crates/ibc-derive/README.md) - Derive macros for `ClientState`
-  and `ConsensusState` traits, reducing boilerplate.
-- [ibc-testkit](crates/ibc-testkit/README.md) - Testing toolkit to aid `ibc-rs` and host chains in writing integration tests.
-- [ibc-query](crates/ibc-query/README.md) - Utility traits and implementations for querying the
-state of an `ibc-rs` enabled chain.
+Rust implementation of the Inter-Blockchain Communication (IBC) protocol that
+hosts all the data structures and on-chain logic implementations of various IBC
+core, clients and applications. This repository organized as a collection of
+sub-crates that can be used independently or together.
+
+## Project Structure
+
+| <div style="width:100px">Crate</div>  | Description |
+| ------------------------------------- | ----------- |
+|[ibc](ibc)                             | Re-exports all the data structures and on-chain logic of various IBC core, clients and applications. |
+|[ibc-data-types](ibc-data-types)       | Re-exports all the IBC data types that are shared across different IBC implementations. |
+|[ibc-core](ibc-core)                   | Contains data structures and implementations of all the IBC core specifications. |
+|[ibc-client](ibc-clients)              | Contains data structures and implementations of various IBC light clients. |
+|[ibc-apps](ibc-apps)                   | Contains data structures and implementations of various IBC applications. |
+|[ibc-testkit](ibc-testkit)             | Provides testing toolkit to aid `ibc-rs` and host chains in writing integration tests. |
+|[ibc-query](ibc-query)                 | Contains utility traits and implementations for querying states of an integrated IBC module. |
+|[ibc-derive](ibc-derive)               | Derive macros for `ClientState` and `ConsensusState` traits, reducing boilerplate. |
 
 ## Contributing
 
-IBC is specified in English in the [cosmos/ibc repo][ibc]. Any
-protocol changes or clarifications should be contributed there.
-
-This repo contains the Rust implementation for the IBC modules. If you're interested in
-contributing, please comment on an issue or open a new one!
+IBC is specified in English in the [cosmos/ibc repo][ibc]. Any protocol changes
+or clarifications should be contributed there.
 
-See also [CONTRIBUTING.md](./CONTRIBUTING.md).
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
 
 ## Community calls
 
@@ -57,26 +62,30 @@ receive a calendar invitation for the monthly meeting.
 
 ## Versioning
 
-We follow [Semantic Versioning][semver], though APIs are still
-under active development.
+We follow [Semantic Versioning][semver], though APIs are still under active
+development.
 
 ## Resources
 
 - [IBC Website][ibc-homepage]
 - [IBC Specification][ibc]
 - [IBC Go implementation][ibc-go]
+- [Protobuf definitions in Rust][ibc-proto-rs]
 
 ## License
 
 Copyright © 2022 Informal Systems Inc. and ibc-rs authors.
 
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+the files in this repository except in compliance with the License. You may
 obtain a copy of the License at
 
     https://www.apache.org/licenses/LICENSE-2.0
 
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
-CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.
 
 [//]: # (badges)
 [docs-image]: https://docs.rs/ibc/badge.svg
@@ -94,6 +103,7 @@ CONDITIONS OF ANY KIND, either express or implied. See the License for the speci
 [//]: # (general links)
 [ibc]: https://github.com/cosmos/ibc
 [ibc-go]: https://github.com/cosmos/ibc-go
+[ibc-proto-rs]: https://github.com/cosmos/ibc-proto-rs
 [ibc-homepage]: https://cosmos.network/ibc
 [cosmos-link]: https://cosmos.network
 [semver]: https://semver.org/
diff --git a/RELEASES.md b/RELEASES.md
new file mode 100644
index 000000000..dc6a55865
--- /dev/null
+++ b/RELEASES.md
@@ -0,0 +1,46 @@
+
+## Releases
+
+Our release process is as follows:
+
+1. In a new branch `release/vX.Y.Z`, update the [changelog](./CHANGELOG.md) to
+   reflect and summarize all changes in the release. This involves:
+   1. Running `unclog build -u` and copy pasting the output at the top of the
+      `CHANGELOG.md` file, making sure to update the header with the new
+      version.
+   2. Running `unclog release --editor <editor> --version vX.Y.Z` to create a
+      summary of all of the changes in this release.
+      1. Your text editor will open. Write the release summary, and close the
+         editor. Make sure to include a comment on whether or not the release
+         contains consensus-breaking changes.
+      2. Add this same summary to `CHANGELOG.md` as well.
+   3. Committing the updated `CHANGELOG.md` file and `.changelog` directory to
+      the repo.
+2. Push this to a branch `release/vX.Y.Z` according to the version number of the
+   anticipated release (e.g. `release/v0.18.0`) and open a **draft PR**.
+3. If there were changes in the `ibc-derive` crate, we need to publish a new
+   version of that crate.
+   1. bump the version in `crates/ibc-derive/Cargo.toml`
+   2. Publish `ibc-derive` with `cargo publish -p ibc-derive`
+4. Bump the versions of all crates to the new version in their Cargo.toml and in
+   the root `Cargo.toml` as well, and push these changes to the release PR.
+      - If you released a new version of `ibc-derive` in step 3, make sure to
+        update that dependency.
+5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
+   the documentation compiles and seems up-to-date and coherent. Fix any
+   potential issues here and push them to the release PR.
+6. Run `cargo publish -p ibc --dry-run` to double-check that publishing will
+   work. Fix any potential issues here and push them to the release PR.
+7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
+8. Once approved, merge the PR, and pull the `main` branch.
+9. Run `cargo publish -p <PACKAGE_NAME>` for each package separately to publish
+   the crates.
+10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
+   tag message, write the version and the link to the corresponding section of
+   the changelog.
+       - Push the tag with `git push --tags`
+11. Once the tag is pushed, create a GitHub release and append
+   `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
+   to the release description.
+
+All done! 🎉
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 01cf92efa..e902341ed 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1216,26 +1216,325 @@ name = "ibc"
 version = "0.47.0"
 dependencies = [
  "bytes",
- "cfg-if",
  "derive_more",
  "displaydoc",
+ "ibc-apps",
+ "ibc-clients",
+ "ibc-core",
  "ibc-derive",
+ "ibc-primitives",
  "ibc-proto",
- "ics23",
- "primitive-types",
  "prost",
  "serde",
  "serde-json-wasm",
- "serde_derive",
  "sha2 0.10.8",
  "subtle-encoding",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
  "time",
+]
+
+[[package]]
+name = "ibc-app-transfer"
+version = "0.47.0"
+dependencies = [
+ "ibc-app-transfer-types",
+ "ibc-core",
+ "serde-json-wasm",
+ "sha2 0.10.8",
+]
+
+[[package]]
+name = "ibc-app-transfer-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core",
+ "ibc-proto",
+ "primitive-types",
+ "serde",
  "uint",
 ]
 
+[[package]]
+name = "ibc-apps"
+version = "0.47.0"
+dependencies = [
+ "ibc-app-transfer",
+]
+
+[[package]]
+name = "ibc-client-tendermint"
+version = "0.47.0"
+dependencies = [
+ "ibc-client-tendermint-types",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-primitives",
+ "prost",
+ "tendermint-light-client-verifier",
+]
+
+[[package]]
+name = "ibc-client-tendermint-types"
+version = "0.47.0"
+dependencies = [
+ "bytes",
+ "displaydoc",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "tendermint",
+ "tendermint-light-client-verifier",
+ "tendermint-proto",
+]
+
+[[package]]
+name = "ibc-clients"
+version = "0.47.0"
+dependencies = [
+ "ibc-client-tendermint",
+]
+
+[[package]]
+name = "ibc-core"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+]
+
+[[package]]
+name = "ibc-core-channel"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel-types",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-channel-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "sha2 0.10.8",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-client"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-derive",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-client-context"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-derive",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-client-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-commitment-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-commitment-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-primitives",
+ "ibc-proto",
+ "ics23",
+ "prost",
+ "serde",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-connection"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-client",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-connection-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-handler"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+]
+
+[[package]]
+name = "ibc-core-handler-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-host-types",
+ "ibc-core-router-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-host"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-host-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-primitives",
+ "serde",
+]
+
+[[package]]
+name = "ibc-core-router"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-host-types",
+ "ibc-core-router-types",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-router-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "ics23",
+ "prost",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
 [[package]]
 name = "ibc-derive"
 version = "0.3.0"
@@ -1246,6 +1545,19 @@ dependencies = [
  "syn 2.0.38",
 ]
 
+[[package]]
+name = "ibc-primitives"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "tendermint",
+ "time",
+]
+
 [[package]]
 name = "ibc-proto"
 version = "0.38.0"
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index d1296297a..3dd20003e 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -5,7 +5,7 @@ edition = "2021"
 resolver = "2"
 
 [dependencies]
-ibc = { path = "../../crates/ibc", default-features = false, features = ["serde"] }
+ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
 ibc-proto = { version = "0.38.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
diff --git a/crates/ibc/clippy.toml b/clippy.toml
similarity index 100%
rename from crates/ibc/clippy.toml
rename to clippy.toml
diff --git a/crates/ibc-derive/Cargo.toml b/crates/ibc-derive/Cargo.toml
deleted file mode 100644
index e89af7e67..000000000
--- a/crates/ibc-derive/Cargo.toml
+++ /dev/null
@@ -1,17 +0,0 @@
-[package]
-name = "ibc-derive"
-version = "0.3.0"
-license = "Apache-2.0"
-readme = "README.md"
-description = "Macros implementation of #[derive(ClientState)] and #[derive(ConsensusState)]"
-repository   = "https://github.com/cosmos/ibc-rs"
-edition = "2021"
-
-[lib]
-proc-macro = true
-
-[dependencies]
-syn = "2"
-proc-macro2 = "1"
-quote = "1"
-darling = "0.20"
diff --git a/crates/ibc-derive/README.md b/crates/ibc-derive/README.md
deleted file mode 100644
index 06db5de09..000000000
--- a/crates/ibc-derive/README.md
+++ /dev/null
@@ -1,83 +0,0 @@
-# IBC in Rust
-
-[![Crate][crate-image]][crate-link]
-[![Docs][docs-image]][docs-link]
-[![Build Status][build-image]][build-link]
-[![Apache 2.0 Licensed][license-image]][license-link]
-![Rust Stable][rustc-image]
-![Rust 1.60+][rustc-version]
-
-Implementation of the Inter-Blockchain Communication Protocol ([IBC]) in Rust.
-
-## Documentation
-
-See documentation on [docs.rs][docs-link].
-
-## Third-party clients
-
-Here, we list IBC third-party clients that are compatible with ibc-rs. You should always audit the implementation of any third-party crate. If you have a client that you'd like to be added to this list, please open a PR!
-
-+ [ICS 6: Solomachine](https://github.com/octopus-network/ics06-solomachine) by Octopus Network
-
-## Divergence from the Interchain Standards (ICS)
-
-This crate diverges from the [ICS specification](https://github.com/cosmos/ibc) in a number of ways. See below for more details.
-
-### Module system: no support for untrusted modules
-
-ICS 24 (Host Requirements) gives the [following requirement](https://github.com/cosmos/ibc/blob/master/spec/core/ics-024-host-requirements/README.md#module-system) about the module system that the host state machine must support:
-
-> The host state machine must support a module system, whereby self-contained, potentially mutually distrusted packages of code can safely execute on the same ledger [...].
-
-**This crate currently does not support mutually distrusted packages**. That is, modules on the host state machine are assumed to be fully trusted. In practice, this means that every module has either been written by the host state machine developers, or fully vetted by them.
-
-### Port system: No object capability system
-
-ICS 5 (Port Allocation) requires the host system to support either object-capability reference or source authentication for modules.
-
-> In the former object-capability case, the IBC handler must have the ability to generate object-capabilities, unique, opaque references which can be passed to a module and will not be duplicable by other modules. [...]
-> In the latter source authentication case, the IBC handler must have the ability to securely read the source identifier of the calling module, a unique string for each module in the host state machine, which cannot be altered by the module or faked by another module.
-
-**This crate currently requires neither of the host system**. Since modules are assumed to be trusted, there is no need for this object capability system that protects resources for potentially malicious modules.
-
-For more background on this, see [this issue](https://github.com/informalsystems/ibc-rs/issues/2159).
-
-### Port system: transferring and releasing a port
-
-ICS 5 (Port Allocation) requires the IBC handler to permit [transferring ownership of a port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#transferring-ownership-of-a-port) and [releasing a port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#releasing-a-port).
-
-We currently support neither.
-
-### Asynchronous acknowledgements
-The standard gives the ability for modules to [acknowledge packets asynchronously](https://github.com/cosmos/ibc/tree/main/spec/core/ics-004-channel-and-packet-semantics#writing-acknowledgements). This allows modules to receive the packet, but only applying the changes at a later time (after which they would write the acknowledgement).
-
-We currently force applications to process the packets as part of `onRecvPacket()`. If you need asynchronous acknowledgements for your application, please open an issue.
-
-Note that this still makes us 100% compatible with ibc-go.
-
-## License
-
-Copyright © 2021 Informal Systems Inc. and ibc-rs authors.
-
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at
-
-    https://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-
-[//]: # (badges)
-
-[crate-image]: https://img.shields.io/crates/v/ibc.svg
-[crate-link]: https://crates.io/crates/ibc
-[docs-image]: https://docs.rs/ibc/badge.svg
-[docs-link]: https://docs.rs/ibc/
-[build-image]: https://github.com/cosmos/ibc-rs/workflows/Rust/badge.svg
-[build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
-[license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
-[license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
-[rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
-[rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
-
-[//]: # (general links)
-
-[IBC]: https://github.com/cosmos/ibc
diff --git a/crates/ibc-query/README.md b/crates/ibc-query/README.md
deleted file mode 100644
index 91a1f7a00..000000000
--- a/crates/ibc-query/README.md
+++ /dev/null
@@ -1,7 +0,0 @@
-# ibc-query
-
-This crate provides a set of utility traits and implementations for querying the
-state of an `ibc-rs` enabled chain.
-
-Implementations contains essential IBC query methods and gRPC query services for
-each of the IBC core client, connection, and channel layers.
diff --git a/crates/ibc-testkit/Cargo.toml b/crates/ibc-testkit/Cargo.toml
deleted file mode 100644
index 8a8c9137d..000000000
--- a/crates/ibc-testkit/Cargo.toml
+++ /dev/null
@@ -1,56 +0,0 @@
-[package]
-name         = "ibc-testkit"
-version      = { workspace = true }
-authors      = { workspace = true }
-edition      = { workspace = true }
-rust-version = { workspace = true }
-license      = { workspace = true }
-repository   = { workspace = true }
-readme       = "README.md"
-keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-description  = """
-    `ibc-testkit` is a versatile library that provides essential abstractions and implementations, 
-    fulfilling a dual role of enabling rigorous integration testing for the `ibc-rs` implementation 
-    while also aiding host chains in addressing a broad spectrum of testing scenarios during 
-    their integration with `ibc-rs`.
-"""
-
-[dependencies]
-# external dependencies
-bytes = { workspace = true }
-derive_more = { workspace = true }
-displaydoc = { workspace = true }
-parking_lot = { workspace = true }
-primitive-types = { workspace = true }
-prost = { workspace = true }
-serde = { workspace = true, optional = true }
-serde_json = { workspace = true, optional = true }
-subtle-encoding = { workspace = true }
-tracing = { workspace = true }
-typed-builder = { workspace = true }
-
-# ibc dependencies
-ibc = { version = "0.47.0" , path = "../ibc" } # NOTE: since `ibc-testkit` does not well support `no_std` yet, we keep `ibc` default features enabled
-
-# cosmos dependencies
-tendermint = { workspace = true }
-tendermint-testgen = { workspace = true }
-
-[dev-dependencies]
-env_logger = { workspace = true }
-rstest =  { workspace = true }
-tracing-subscriber = { workspace = true }
-test-log = { workspace = true }
-
-[features]
-default = ["std"]
-std = [
-    "ibc/std",
-    "tracing/std",
-    "prost/std",
-    "serde/std",
-    "serde_json/std",
-]
-
-# This feature is required for token transfer (ICS-20)
-serde = ["dep:serde", "ibc/serde", "serde_json"]
diff --git a/crates/ibc-testkit/README.md b/crates/ibc-testkit/README.md
deleted file mode 100644
index 28b23dcd7..000000000
--- a/crates/ibc-testkit/README.md
+++ /dev/null
@@ -1,6 +0,0 @@
-# `ibc-testkit`
-
-`ibc-testkit` is a versatile library that provides essential abstractions and
-implementations, fulfilling a dual role of enabling rigorous integration testing
-for the `ibc-rs` implementation while also aiding host chains in addressing a
-broad spectrum of testing scenarios during their integration with `ibc-rs`.
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs b/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs
deleted file mode 100644
index 0ea825d26..000000000
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/header copy.rs	
+++ /dev/null
@@ -1,136 +0,0 @@
-use alloc::string::ToString;
-use core::fmt::{Display, Error as FmtError, Formatter};
-
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::mock::Header as RawMockHeader;
-use ibc_proto::Protobuf;
-
-use crate::core::ics02_client::error::ClientError;
-use crate::core::timestamp::Timestamp;
-use crate::Height;
-
-pub const MOCK_HEADER_TYPE_URL: &str = "/ibc.mock.Header";
-
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Copy, Clone, Debug, PartialEq, Eq)]
-pub struct MockHeader {
-    pub height: Height,
-    pub timestamp: Timestamp,
-}
-
-impl Default for MockHeader {
-    fn default() -> Self {
-        Self {
-            height: Height::min(0),
-            timestamp: Default::default(),
-        }
-    }
-}
-
-impl Display for MockHeader {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(
-            f,
-            "MockHeader {{ height: {}, timestamp: {} }}",
-            self.height, self.timestamp
-        )
-    }
-}
-
-impl Protobuf<RawMockHeader> for MockHeader {}
-
-impl TryFrom<RawMockHeader> for MockHeader {
-    type Error = ClientError;
-
-    fn try_from(raw: RawMockHeader) -> Result<Self, Self::Error> {
-        Ok(MockHeader {
-            height: raw
-                .height
-                .and_then(|raw_height| raw_height.try_into().ok())
-                .ok_or(ClientError::MissingClientMessage)?,
-
-            timestamp: Timestamp::from_nanoseconds(raw.timestamp)
-                .map_err(ClientError::InvalidPacketTimestamp)?,
-        })
-    }
-}
-
-impl From<MockHeader> for RawMockHeader {
-    fn from(value: MockHeader) -> Self {
-        RawMockHeader {
-            height: Some(value.height.into()),
-            timestamp: value.timestamp.nanoseconds(),
-        }
-    }
-}
-
-impl MockHeader {
-    pub fn height(&self) -> Height {
-        self.height
-    }
-
-    pub fn new(height: Height) -> Self {
-        Self {
-            height,
-            timestamp: Timestamp::none(),
-        }
-    }
-
-    #[cfg(any(test, feature = "std"))]
-    pub fn with_current_timestamp(self) -> Self {
-        self.with_timestamp(Timestamp::now())
-    }
-
-    pub fn with_timestamp(self, timestamp: Timestamp) -> Self {
-        Self { timestamp, ..self }
-    }
-}
-
-impl Protobuf<Any> for MockHeader {}
-
-impl TryFrom<Any> for MockHeader {
-    type Error = ClientError;
-
-    fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        match raw.type_url.as_str() {
-            MOCK_HEADER_TYPE_URL => Ok(Protobuf::<RawMockHeader>::decode_vec(&raw.value).map_err(
-                |e| ClientError::InvalidRawHeader {
-                    reason: e.to_string(),
-                },
-            )?),
-            _ => Err(ClientError::UnknownHeaderType {
-                header_type: raw.type_url,
-            }),
-        }
-    }
-}
-
-impl From<MockHeader> for Any {
-    fn from(header: MockHeader) -> Self {
-        Any {
-            type_url: MOCK_HEADER_TYPE_URL.to_string(),
-            value: Protobuf::<RawMockHeader>::encode_vec(header),
-        }
-    }
-}
-
-#[cfg(test)]
-mod tests {
-
-    use super::*;
-
-    #[test]
-    fn encode_any() {
-        let header = MockHeader::new(Height::new(1, 10).expect("Never fails"))
-            .with_timestamp(Timestamp::none());
-        let bytes = <MockHeader as Protobuf<Any>>::encode_vec(header);
-
-        assert_eq!(
-            &bytes,
-            &[
-                10, 16, 47, 105, 98, 99, 46, 109, 111, 99, 107, 46, 72, 101, 97, 100, 101, 114, 18,
-                6, 10, 4, 8, 1, 16, 10
-            ]
-        );
-    }
-}
diff --git a/crates/ibc/Cargo.toml b/crates/ibc/Cargo.toml
deleted file mode 100644
index 8bd87b26f..000000000
--- a/crates/ibc/Cargo.toml
+++ /dev/null
@@ -1,87 +0,0 @@
-[package]
-name         = "ibc"
-version      = { workspace = true }
-authors      = { workspace = true }
-edition      = { workspace = true }
-rust-version = { workspace = true }
-license      = { workspace = true }
-repository   = { workspace = true }
-keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-readme       = "README.md"
-description  = """
-    Implementation of the Inter-Blockchain Communication Protocol (IBC).
-    This crate comprises the main data structures and on-chain logic.
-"""
-
-[package.metadata.docs.rs]
-all-features = true
-
-[dependencies]
-# external dependencies
-borsh = { workspace = true, optional = true }
-bytes = { workspace = true }
-derive_more = { workspace = true }
-displaydoc = { workspace = true }
-primitive-types = { workspace = true }
-prost = { workspace = true }
-serde_derive = { workspace = true, optional = true }
-serde = { workspace = true, optional = true }
-serde_json =  { workspace = true, optional = true}
-subtle-encoding = { workspace = true, default-features = false }
-sha2 = { workspace = true, default-features = false }
-time = { workspace = true, default-features = false }
-schemars = { workspace = true, optional = true }
-typed-builder = { workspace = true, optional = true }
-uint = { version = "0.9", default-features = false }
-
-# ibc dependencies
-ibc-derive = { version = "0.3.0", path = "../ibc-derive" }
-ibc-proto = { workspace = true }
-ics23 = { workspace = true, features = ["host-functions"] }
-
-# cosmos dependencies
-tendermint = { workspace = true }
-tendermint-proto = { workspace = true }
-tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
-
-## parity dependencies
-parity-scale-codec = { workspace = true , optional = true }
-scale-info = { workspace = true , optional = true }
-
-
-[dev-dependencies]
-ibc-testkit = { version = "0.47.0", path = "../ibc-testkit", default-features = false, features = ["serde"] }
-env_logger = { workspace = true }
-rstest = { workspace = true }
-tracing-subscriber = { workspace = true }
-test-log = { workspace = true }
-tendermint-rpc = {  workspace = true, features = ["http-client", "websocket-client"] }
-
-[features]
-default = ["std"]
-
-std = [
-    "ibc-proto/std",
-    "ics23/std",
-    "serde/std",
-    "prost/std",
-    "bytes/std",
-    "subtle-encoding/std",
-    "serde_json/std",
-    "sha2/std",
-    "displaydoc/std",
-    "uint/std",
-    "primitive-types/std",
-    "tendermint/clock",
-    "tendermint/std",
-]
-
-parity-scale-codec = ["dep:parity-scale-codec", "dep:scale-info", "ibc-proto/parity-scale-codec"]
-
-borsh = ["dep:borsh", "ibc-proto/borsh"]
-
-# This feature is required for token transfer (ICS-20)
-serde = ["dep:serde", "dep:serde_derive", "serde_json", "ibc-proto/serde", "ics23/serde"]
-
-# CosmWasm message API generator compatible, should not be inside on chain code
-schema = ["dep:schemars", "ibc-proto/json-schema", "serde", "std"]
diff --git a/crates/ibc/README.md b/crates/ibc/README.md
deleted file mode 100644
index 06db5de09..000000000
--- a/crates/ibc/README.md
+++ /dev/null
@@ -1,83 +0,0 @@
-# IBC in Rust
-
-[![Crate][crate-image]][crate-link]
-[![Docs][docs-image]][docs-link]
-[![Build Status][build-image]][build-link]
-[![Apache 2.0 Licensed][license-image]][license-link]
-![Rust Stable][rustc-image]
-![Rust 1.60+][rustc-version]
-
-Implementation of the Inter-Blockchain Communication Protocol ([IBC]) in Rust.
-
-## Documentation
-
-See documentation on [docs.rs][docs-link].
-
-## Third-party clients
-
-Here, we list IBC third-party clients that are compatible with ibc-rs. You should always audit the implementation of any third-party crate. If you have a client that you'd like to be added to this list, please open a PR!
-
-+ [ICS 6: Solomachine](https://github.com/octopus-network/ics06-solomachine) by Octopus Network
-
-## Divergence from the Interchain Standards (ICS)
-
-This crate diverges from the [ICS specification](https://github.com/cosmos/ibc) in a number of ways. See below for more details.
-
-### Module system: no support for untrusted modules
-
-ICS 24 (Host Requirements) gives the [following requirement](https://github.com/cosmos/ibc/blob/master/spec/core/ics-024-host-requirements/README.md#module-system) about the module system that the host state machine must support:
-
-> The host state machine must support a module system, whereby self-contained, potentially mutually distrusted packages of code can safely execute on the same ledger [...].
-
-**This crate currently does not support mutually distrusted packages**. That is, modules on the host state machine are assumed to be fully trusted. In practice, this means that every module has either been written by the host state machine developers, or fully vetted by them.
-
-### Port system: No object capability system
-
-ICS 5 (Port Allocation) requires the host system to support either object-capability reference or source authentication for modules.
-
-> In the former object-capability case, the IBC handler must have the ability to generate object-capabilities, unique, opaque references which can be passed to a module and will not be duplicable by other modules. [...]
-> In the latter source authentication case, the IBC handler must have the ability to securely read the source identifier of the calling module, a unique string for each module in the host state machine, which cannot be altered by the module or faked by another module.
-
-**This crate currently requires neither of the host system**. Since modules are assumed to be trusted, there is no need for this object capability system that protects resources for potentially malicious modules.
-
-For more background on this, see [this issue](https://github.com/informalsystems/ibc-rs/issues/2159).
-
-### Port system: transferring and releasing a port
-
-ICS 5 (Port Allocation) requires the IBC handler to permit [transferring ownership of a port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#transferring-ownership-of-a-port) and [releasing a port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#releasing-a-port).
-
-We currently support neither.
-
-### Asynchronous acknowledgements
-The standard gives the ability for modules to [acknowledge packets asynchronously](https://github.com/cosmos/ibc/tree/main/spec/core/ics-004-channel-and-packet-semantics#writing-acknowledgements). This allows modules to receive the packet, but only applying the changes at a later time (after which they would write the acknowledgement).
-
-We currently force applications to process the packets as part of `onRecvPacket()`. If you need asynchronous acknowledgements for your application, please open an issue.
-
-Note that this still makes us 100% compatible with ibc-go.
-
-## License
-
-Copyright © 2021 Informal Systems Inc. and ibc-rs authors.
-
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at
-
-    https://www.apache.org/licenses/LICENSE-2.0
-
-Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
-
-[//]: # (badges)
-
-[crate-image]: https://img.shields.io/crates/v/ibc.svg
-[crate-link]: https://crates.io/crates/ibc
-[docs-image]: https://docs.rs/ibc/badge.svg
-[docs-link]: https://docs.rs/ibc/
-[build-image]: https://github.com/cosmos/ibc-rs/workflows/Rust/badge.svg
-[build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
-[license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
-[license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
-[rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
-[rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
-
-[//]: # (general links)
-
-[IBC]: https://github.com/cosmos/ibc
diff --git a/crates/ibc/src/applications/mod.rs b/crates/ibc/src/applications/mod.rs
deleted file mode 100644
index bfbfd10f6..000000000
--- a/crates/ibc/src/applications/mod.rs
+++ /dev/null
@@ -1,4 +0,0 @@
-//! Implementation of IBC applications
-
-#[cfg(feature = "serde")]
-pub mod transfer;
diff --git a/crates/ibc/src/applications/transfer/mod.rs b/crates/ibc/src/applications/transfer/mod.rs
deleted file mode 100644
index 198a9f82e..000000000
--- a/crates/ibc/src/applications/transfer/mod.rs
+++ /dev/null
@@ -1,41 +0,0 @@
-//! Implementation of the [fungible token transfer module](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md) (ICS-20)
-
-pub mod amount;
-pub mod coin;
-pub mod context;
-pub mod denom;
-pub mod error;
-pub mod events;
-pub mod memo;
-pub mod msgs;
-pub mod packet;
-
-pub use amount::*;
-pub use coin::*;
-pub use denom::*;
-pub use memo::*;
-
-mod relay;
-
-pub use relay::send_transfer::{send_transfer, send_transfer_execute, send_transfer_validate};
-
-/// Module identifier for the ICS20 application.
-pub const MODULE_ID_STR: &str = "transfer";
-
-/// The port identifier that the ICS20 applications
-/// typically bind with.
-pub const PORT_ID_STR: &str = "transfer";
-
-/// ICS20 application current version.
-pub const VERSION: &str = "ics20-1";
-
-/// The successful string used for creating an acknowledgement status,
-/// equivalent to `base64::encode(0x01)`.
-pub const ACK_SUCCESS_B64: &str = "AQ==";
-
-use crate::core::ics04_channel::acknowledgement::StatusValue;
-
-/// Returns a successful acknowledgement status for the token transfer application.
-pub fn ack_success_b64() -> StatusValue {
-    StatusValue::new(ACK_SUCCESS_B64).expect("ack status value is never supposed to be empty")
-}
diff --git a/crates/ibc/src/clients/ics07_tendermint/mod.rs b/crates/ibc/src/clients/ics07_tendermint/mod.rs
deleted file mode 100644
index 13fa13694..000000000
--- a/crates/ibc/src/clients/ics07_tendermint/mod.rs
+++ /dev/null
@@ -1,34 +0,0 @@
-//! ICS 07: Tendermint Client implements a client verification algorithm for blockchains which use
-//! the Tendermint consensus algorithm.
-
-use core::str::FromStr;
-
-use crate::core::ics02_client::client_type::ClientType;
-
-pub mod client_state;
-pub mod consensus_state;
-pub mod error;
-pub mod header;
-pub mod misbehaviour;
-pub mod trust_threshold;
-
-mod context;
-pub use context::*;
-
-pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
-
-/// Returns the tendermint `ClientType`
-pub fn client_type() -> ClientType {
-    ClientType::from_str(TENDERMINT_CLIENT_TYPE).expect("Never fails because it's valid")
-}
-
-#[cfg(test)]
-mod tests {
-    use super::*;
-
-    // Ensures that the validation in `ClientType::from_str` doesn't fail for the tendermint client type
-    #[test]
-    pub fn test_tm_client_type() {
-        let _ = ClientType::from_str(TENDERMINT_CLIENT_TYPE).unwrap();
-    }
-}
diff --git a/crates/ibc/src/clients/mod.rs b/crates/ibc/src/clients/mod.rs
deleted file mode 100644
index 24f804757..000000000
--- a/crates/ibc/src/clients/mod.rs
+++ /dev/null
@@ -1,16 +0,0 @@
-//! Light client implementations to be used in [core](crate::core).
-
-use core::any::Any;
-
-pub mod ics07_tendermint;
-
-/// Allows type to be converted to `&dyn Any`
-pub trait AsAny: Any {
-    fn as_any(&self) -> &dyn Any;
-}
-
-impl<M: Any> AsAny for M {
-    fn as_any(&self) -> &dyn Any {
-        self
-    }
-}
diff --git a/crates/ibc/src/core/ics02_client/mod.rs b/crates/ibc/src/core/ics02_client/mod.rs
deleted file mode 100644
index 544a3ba55..000000000
--- a/crates/ibc/src/core/ics02_client/mod.rs
+++ /dev/null
@@ -1,13 +0,0 @@
-//! ICS 02: Client implementation for verifying remote IBC-enabled chains.
-
-pub mod client_state;
-pub mod client_type;
-pub mod consensus_state;
-pub mod error;
-pub mod events;
-pub mod handler;
-pub mod height;
-pub mod msgs;
-
-mod context;
-pub use context::{ClientExecutionContext, ClientValidationContext};
diff --git a/crates/ibc/src/core/ics03_connection/handler.rs b/crates/ibc/src/core/ics03_connection/handler.rs
deleted file mode 100644
index 20c34a37a..000000000
--- a/crates/ibc/src/core/ics03_connection/handler.rs
+++ /dev/null
@@ -1,7 +0,0 @@
-//! This module implements the processing logic for ICS3 (connection open
-//! handshake) messages.
-
-pub mod conn_open_ack;
-pub mod conn_open_confirm;
-pub mod conn_open_init;
-pub mod conn_open_try;
diff --git a/crates/ibc/src/core/ics03_connection/mod.rs b/crates/ibc/src/core/ics03_connection/mod.rs
deleted file mode 100644
index 550e5bcaa..000000000
--- a/crates/ibc/src/core/ics03_connection/mod.rs
+++ /dev/null
@@ -1,11 +0,0 @@
-//! ICS 03: Connection implementation for connecting a client
-//! on the local chain with a client on a remote chain.
-
-pub mod connection;
-pub(crate) mod delay;
-pub mod error;
-pub mod events;
-/// Message processing logic (protocol) for ICS 03.
-pub mod handler;
-pub mod msgs;
-pub mod version;
diff --git a/crates/ibc/src/core/ics04_channel/handler.rs b/crates/ibc/src/core/ics04_channel/handler.rs
deleted file mode 100644
index 0950dc923..000000000
--- a/crates/ibc/src/core/ics04_channel/handler.rs
+++ /dev/null
@@ -1,13 +0,0 @@
-//! This module implements the processing logic for ICS4 (channel) messages.
-
-pub(crate) mod acknowledgement;
-pub(crate) mod chan_close_confirm;
-pub(crate) mod chan_close_init;
-pub(crate) mod chan_open_ack;
-pub(crate) mod chan_open_confirm;
-pub(crate) mod chan_open_init;
-pub(crate) mod chan_open_try;
-pub(crate) mod recv_packet;
-pub(crate) mod send_packet;
-pub(crate) mod timeout;
-pub(crate) mod timeout_on_close;
diff --git a/crates/ibc/src/core/ics04_channel/mod.rs b/crates/ibc/src/core/ics04_channel/mod.rs
deleted file mode 100644
index 40e6538cf..000000000
--- a/crates/ibc/src/core/ics04_channel/mod.rs
+++ /dev/null
@@ -1,17 +0,0 @@
-//! ICS 04: Channel implementation that facilitates communication between
-//! applications and the chains those applications are built upon.
-
-pub mod channel;
-pub mod context;
-pub mod error;
-pub mod events;
-
-pub(crate) mod handler;
-pub mod msgs;
-pub mod packet;
-pub mod timeout;
-
-pub mod acknowledgement;
-pub mod commitment;
-mod version;
-pub use version::Version;
diff --git a/crates/ibc/src/core/ics23_commitment/mod.rs b/crates/ibc/src/core/ics23_commitment/mod.rs
deleted file mode 100644
index ecffa81d6..000000000
--- a/crates/ibc/src/core/ics23_commitment/mod.rs
+++ /dev/null
@@ -1,7 +0,0 @@
-//! ICS 23: Commitment implementation of a cryptographic scheme that verifies
-//! state transitions between chains.
-
-pub mod commitment;
-pub mod error;
-pub mod merkle;
-pub mod specs;
diff --git a/crates/ibc/src/core/ics24_host/identifier.rs b/crates/ibc/src/core/ics24_host/identifier.rs
deleted file mode 100644
index 8b7943847..000000000
--- a/crates/ibc/src/core/ics24_host/identifier.rs
+++ /dev/null
@@ -1,629 +0,0 @@
-//! Defines identifier types
-
-pub(crate) mod validate;
-use core::fmt::{Debug, Display, Error as FmtError, Formatter};
-use core::str::FromStr;
-
-use derive_more::Into;
-use displaydoc::Display;
-use validate::*;
-
-use crate::clients::ics07_tendermint::client_type as tm_client_type;
-use crate::core::ics02_client::client_type::ClientType;
-use crate::prelude::*;
-
-const CONNECTION_ID_PREFIX: &str = "connection";
-const CHANNEL_ID_PREFIX: &str = "channel";
-
-const TRANSFER_PORT_ID: &str = "transfer";
-
-/// Defines the domain type for chain identifiers.
-///
-/// A valid `ChainId` follows the format {chain name}-{revision number} where
-/// the revision number indicates how many times the chain has been upgraded.
-/// Creating `ChainId`s not in this format will result in an error.
-///
-/// It should be noted this format is not standardized yet, though it is widely
-/// accepted and compatible with Cosmos SDK driven chains.
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
-pub struct ChainId {
-    id: String,
-    revision_number: u64,
-}
-
-impl ChainId {
-    /// Creates a new `ChainId` with the given chain identifier.
-    ///
-    /// It checks the identifier for valid characters according to `ICS-24`
-    /// specification and returns a `ChainId` successfully.
-    /// Stricter checks beyond `ICS-24` rests with the users,
-    /// based on their requirements.
-    ///
-    /// If the chain identifier is in the {chain name}-{revision number} format,
-    /// the revision number is parsed. Otherwise, revision number is set to 0.
-    ///
-    /// ```
-    /// use ibc::core::ics24_host::identifier::ChainId;
-    ///
-    /// let chain_id = "chainA";
-    /// let id = ChainId::new(chain_id).unwrap();
-    /// assert_eq!(id.revision_number(), 0);
-    /// assert_eq!(id.as_str(), chain_id);
-    ///
-    /// let chain_id = "chainA-12";
-    /// let id = ChainId::new(chain_id).unwrap();
-    /// assert_eq!(id.revision_number(), 12);
-    /// assert_eq!(id.as_str(), chain_id);
-    /// ```
-    pub fn new(chain_id: &str) -> Result<Self, IdentifierError> {
-        Self::from_str(chain_id)
-    }
-
-    /// Get a reference to the underlying string.
-    pub fn as_str(&self) -> &str {
-        &self.id
-    }
-
-    pub fn split_chain_id(&self) -> Result<(&str, u64), IdentifierError> {
-        parse_chain_id_string(self.as_str())
-    }
-
-    /// Extract the revision number from the chain identifier
-    pub fn revision_number(&self) -> u64 {
-        self.revision_number
-    }
-
-    /// Increases `ChainId`s revision number by one.
-    /// Fails if the chain identifier is not in
-    /// `{chain_name}-{revision_number}` format or
-    /// the revision number overflows.
-    ///
-    /// ```
-    /// use ibc::core::ics24_host::identifier::ChainId;
-    ///
-    /// let mut chain_id = ChainId::new("chainA-1").unwrap();
-    /// assert!(chain_id.increment_revision_number().is_ok());
-    /// assert_eq!(chain_id.revision_number(), 2);
-    ///
-    /// let mut chain_id = ChainId::new(&format!("chainA-{}", u64::MAX)).unwrap();
-    /// assert!(chain_id.increment_revision_number().is_err());
-    /// assert_eq!(chain_id.revision_number(), u64::MAX);
-    /// ```
-    pub fn increment_revision_number(&mut self) -> Result<(), IdentifierError> {
-        let (chain_name, _) = self.split_chain_id()?;
-        let inc_revision_number = self
-            .revision_number
-            .checked_add(1)
-            .ok_or(IdentifierError::RevisionNumberOverflow)?;
-        self.id = format!("{}-{}", chain_name, inc_revision_number);
-        self.revision_number = inc_revision_number;
-        Ok(())
-    }
-
-    /// A convenient method to check if the `ChainId` forms a valid identifier
-    /// with the desired min/max length. However, ICS-24 does not specify a
-    /// certain min or max lengths for chain identifiers.
-    pub fn validate_length(&self, min_length: u64, max_length: u64) -> Result<(), IdentifierError> {
-        match self.split_chain_id() {
-            Ok((chain_name, _)) => validate_prefix_length(chain_name, min_length, max_length),
-            _ => validate_identifier_length(&self.id, min_length, max_length),
-        }
-    }
-}
-
-/// Construct a `ChainId` from a string literal only if it forms a valid
-/// identifier.
-impl FromStr for ChainId {
-    type Err = IdentifierError;
-
-    fn from_str(id: &str) -> Result<Self, Self::Err> {
-        // Identifier string must have a maximum length of 64 characters.
-
-        // Validates the chain name for allowed characters according to ICS-24.
-        validate_identifier_chars(id)?;
-        match parse_chain_id_string(id) {
-            Ok((chain_name, revision_number)) => {
-                // Validate if the chain name with revision number has a valid length.
-                validate_prefix_length(chain_name, 1, 64)?;
-                Ok(Self {
-                    id: id.into(),
-                    revision_number,
-                })
-            }
-
-            _ => {
-                // Validate if the identifier has a valid length.
-                validate_identifier_length(id, 1, 64)?;
-                Ok(Self {
-                    id: id.into(),
-                    revision_number: 0,
-                })
-            }
-        }
-    }
-}
-
-impl Display for ChainId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.id)
-    }
-}
-
-/// Parses a string intended to represent a `ChainId` and, if successful,
-/// returns a tuple containing the chain name and revision number.
-fn parse_chain_id_string(chain_id_str: &str) -> Result<(&str, u64), IdentifierError> {
-    chain_id_str
-        .rsplit_once('-')
-        .filter(|(_, rev_number_str)| {
-            // Validates the revision number not to start with leading zeros, like "01".
-            // Zero is the only allowed revision number with leading zero.
-            rev_number_str.as_bytes().first() != Some(&b'0') || rev_number_str.len() == 1
-        })
-        .and_then(|(chain_name, rev_number_str)| {
-            // Parses the revision number string into a `u64` and checks its validity.
-            rev_number_str
-                .parse()
-                .ok()
-                .map(|revision_number| (chain_name, revision_number))
-        })
-        .ok_or(IdentifierError::UnformattedRevisionNumber {
-            chain_id: chain_id_str.to_string(),
-        })
-}
-
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
-pub struct ClientId(String);
-
-impl ClientId {
-    /// Builds a new client identifier. Client identifiers are deterministically formed from two
-    /// elements: a prefix derived from the client type `ctype`, and a monotonically increasing
-    /// `counter`; these are separated by a dash "-".
-    ///
-    /// ```
-    /// # use ibc::core::ics24_host::identifier::ClientId;
-    /// # use ibc::core::ics02_client::client_type::ClientType;
-    /// # use std::str::FromStr;
-    /// let tm_client_id = ClientId::new(ClientType::from_str("07-tendermint").unwrap(), 0);
-    /// assert!(tm_client_id.is_ok());
-    /// tm_client_id.map(|id| { assert_eq!(&id, "07-tendermint-0") });
-    /// ```
-    pub fn new(client_type: ClientType, counter: u64) -> Result<Self, IdentifierError> {
-        let prefix = client_type.as_str().trim();
-        validate_client_type(prefix)?;
-        let id = format!("{prefix}-{counter}");
-        Self::from_str(id.as_str())
-    }
-
-    /// Get this identifier as a borrowed `&str`
-    pub fn as_str(&self) -> &str {
-        &self.0
-    }
-
-    /// Get this identifier as a borrowed byte slice
-    pub fn as_bytes(&self) -> &[u8] {
-        self.0.as_bytes()
-    }
-}
-
-/// This implementation provides a `to_string` method.
-impl Display for ClientId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
-impl FromStr for ClientId {
-    type Err = IdentifierError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        validate_client_identifier(s).map(|_| Self(s.to_string()))
-    }
-}
-
-impl Default for ClientId {
-    fn default() -> Self {
-        Self::new(tm_client_type(), 0).expect("Never fails because we use a valid client type")
-    }
-}
-
-/// Equality check against string literal (satisfies &ClientId == &str).
-/// ```
-/// use core::str::FromStr;
-/// use ibc::core::ics24_host::identifier::ClientId;
-/// let client_id = ClientId::from_str("clientidtwo");
-/// assert!(client_id.is_ok());
-/// client_id.map(|id| {assert_eq!(&id, "clientidtwo")});
-/// ```
-impl PartialEq<str> for ClientId {
-    fn eq(&self, other: &str) -> bool {
-        self.as_str().eq(other)
-    }
-}
-
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
-pub struct ConnectionId(String);
-
-impl ConnectionId {
-    /// Builds a new connection identifier. Connection identifiers are deterministically formed from
-    /// two elements: a prefix `prefix`, and a monotonically increasing `counter`; these are
-    /// separated by a dash "-". The prefix is currently determined statically (see
-    /// `ConnectionId::prefix()`) so this method accepts a single argument, the `counter`.
-    ///
-    /// ```
-    /// # use ibc::core::ics24_host::identifier::ConnectionId;
-    /// let conn_id = ConnectionId::new(11);
-    /// assert_eq!(&conn_id, "connection-11");
-    /// ```
-    pub fn new(identifier: u64) -> Self {
-        let id = format!("{}-{}", Self::prefix(), identifier);
-        Self(id)
-    }
-
-    /// Returns the static prefix to be used across all connection identifiers.
-    pub fn prefix() -> &'static str {
-        CONNECTION_ID_PREFIX
-    }
-
-    /// Get this identifier as a borrowed `&str`
-    pub fn as_str(&self) -> &str {
-        &self.0
-    }
-
-    /// Get this identifier as a borrowed byte slice
-    pub fn as_bytes(&self) -> &[u8] {
-        self.0.as_bytes()
-    }
-}
-
-/// This implementation provides a `to_string` method.
-impl Display for ConnectionId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
-impl FromStr for ConnectionId {
-    type Err = IdentifierError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        validate_connection_identifier(s).map(|_| Self(s.to_string()))
-    }
-}
-
-impl Default for ConnectionId {
-    fn default() -> Self {
-        Self::new(0)
-    }
-}
-
-/// Equality check against string literal (satisfies &ConnectionId == &str).
-/// ```
-/// use core::str::FromStr;
-/// use ibc::core::ics24_host::identifier::ConnectionId;
-/// let conn_id = ConnectionId::from_str("connectionId-0");
-/// assert!(conn_id.is_ok());
-/// conn_id.map(|id| {assert_eq!(&id, "connectionId-0")});
-/// ```
-impl PartialEq<str> for ConnectionId {
-    fn eq(&self, other: &str) -> bool {
-        self.as_str().eq(other)
-    }
-}
-
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
-pub struct PortId(String);
-
-impl PortId {
-    pub fn new(id: String) -> Result<Self, IdentifierError> {
-        Self::from_str(&id)
-    }
-
-    /// Infallible creation of the well-known transfer port
-    pub fn transfer() -> Self {
-        Self(TRANSFER_PORT_ID.to_string())
-    }
-
-    /// Get this identifier as a borrowed `&str`
-    pub fn as_str(&self) -> &str {
-        &self.0
-    }
-
-    /// Get this identifier as a borrowed byte slice
-    pub fn as_bytes(&self) -> &[u8] {
-        self.0.as_bytes()
-    }
-
-    pub fn validate(&self) -> Result<(), IdentifierError> {
-        validate_port_identifier(self.as_str())
-    }
-}
-
-/// This implementation provides a `to_string` method.
-impl Display for PortId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
-impl FromStr for PortId {
-    type Err = IdentifierError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        validate_port_identifier(s).map(|_| Self(s.to_string()))
-    }
-}
-
-impl AsRef<str> for PortId {
-    fn as_ref(&self) -> &str {
-        self.0.as_str()
-    }
-}
-
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
-pub struct ChannelId(String);
-
-impl ChannelId {
-    /// Builds a new channel identifier. Like client and connection identifiers, channel ids are
-    /// deterministically formed from two elements: a prefix `prefix`, and a monotonically
-    /// increasing `counter`, separated by a dash "-".
-    /// The prefix is currently determined statically (see `ChannelId::prefix()`) so this method
-    /// accepts a single argument, the `counter`.
-    ///
-    /// ```
-    /// # use ibc::core::ics24_host::identifier::ChannelId;
-    /// let chan_id = ChannelId::new(27);
-    /// assert_eq!(chan_id.to_string(), "channel-27");
-    /// ```
-    pub fn new(identifier: u64) -> Self {
-        let id = format!("{}-{}", Self::prefix(), identifier);
-        Self(id)
-    }
-
-    /// Returns the static prefix to be used across all channel identifiers.
-    pub fn prefix() -> &'static str {
-        CHANNEL_ID_PREFIX
-    }
-
-    /// Get this identifier as a borrowed `&str`
-    pub fn as_str(&self) -> &str {
-        &self.0
-    }
-
-    /// Get this identifier as a borrowed byte slice
-    pub fn as_bytes(&self) -> &[u8] {
-        self.0.as_bytes()
-    }
-}
-
-/// This implementation provides a `to_string` method.
-impl Display for ChannelId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
-impl FromStr for ChannelId {
-    type Err = IdentifierError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        validate_channel_identifier(s).map(|_| Self(s.to_string()))
-    }
-}
-
-impl AsRef<str> for ChannelId {
-    fn as_ref(&self) -> &str {
-        &self.0
-    }
-}
-
-impl Default for ChannelId {
-    fn default() -> Self {
-        Self::new(0)
-    }
-}
-
-/// Equality check against string literal (satisfies &ChannelId == &str).
-/// ```
-/// use core::str::FromStr;
-/// use ibc::core::ics24_host::identifier::ChannelId;
-/// let channel_id = ChannelId::from_str("channelId-0");
-/// assert!(channel_id.is_ok());
-/// channel_id.map(|id| {assert_eq!(&id, "channelId-0")});
-/// ```
-impl PartialEq<str> for ChannelId {
-    fn eq(&self, other: &str) -> bool {
-        self.as_str().eq(other)
-    }
-}
-
-#[cfg_attr(feature = "serde", derive(serde::Serialize))]
-#[derive(Debug, Display)]
-pub enum IdentifierError {
-    /// identifier `{id}` cannot contain separator '/'
-    ContainSeparator { id: String },
-    /// identifier `{id}` has invalid length `{length}` must be between `{min}`-`{max}` characters
-    InvalidLength {
-        id: String,
-        length: u64,
-        min: u64,
-        max: u64,
-    },
-    /// identifier `{id}` must only contain alphanumeric characters or `.`, `_`, `+`, `-`, `#`, - `[`, `]`, `<`, `>`
-    InvalidCharacter { id: String },
-    /// identifier prefix `{prefix}` is invalid
-    InvalidPrefix { prefix: String },
-    /// chain identifier is not formatted with revision number
-    UnformattedRevisionNumber { chain_id: String },
-    /// revision number overflowed
-    RevisionNumberOverflow,
-    /// identifier cannot be empty
-    Empty,
-}
-
-#[cfg(feature = "std")]
-impl std::error::Error for IdentifierError {}
-
-#[cfg(test)]
-mod tests {
-    use rstest::rstest;
-
-    use super::*;
-
-    #[rstest]
-    #[case("chainA-0", "chainA", 0)]
-    #[case("chainA-1", "chainA", 1)]
-    #[case("chainA--1", "chainA-", 1)]
-    #[case("chainA-1-2", "chainA-1", 2)]
-    #[case("111-2", "111", 2)]
-    #[case("----1", "---", 1)]
-    #[case("._+-1", "._+", 1)]
-    #[case(&("A".repeat(43) + "-3"), &("A".repeat(43)), 3)]
-    fn test_valid_chain_id_with_rev(
-        #[case] raw_chain_id: &str,
-        #[case] chain_name: &str,
-        #[case] revision_number: u64,
-    ) {
-        let chain_id = ChainId::new(raw_chain_id).unwrap();
-        assert!(chain_id.validate_length(1, 64).is_ok());
-        assert_eq!(
-            chain_id,
-            ChainId {
-                id: format!("{chain_name}-{revision_number}"),
-                revision_number
-            }
-        );
-    }
-
-    #[rstest]
-    #[case("chainA")]
-    #[case("chainA.2")]
-    #[case("123")]
-    #[case("._+")]
-    #[case("chainA-")]
-    #[case("chainA-a")]
-    #[case("chainA-01")]
-    #[case("chainA-1-")]
-    #[case(&"A".repeat(64))]
-    #[case::special_case("chainA-0")]
-    fn test_valid_chain_id_without_rev(#[case] chain_name: &str) {
-        let chain_id = ChainId::new(chain_name).unwrap();
-        assert!(chain_id.validate_length(1, 64).is_ok());
-        assert_eq!(
-            chain_id,
-            ChainId {
-                id: chain_name.into(),
-                revision_number: 0
-            }
-        );
-    }
-
-    #[rstest]
-    #[case(&"A".repeat(65))]
-    #[case(&("A".repeat(44) + "-123"))]
-    #[case("-1")]
-    #[case(" ----1")]
-    #[case(" ")]
-    #[case(" chainA")]
-    #[case("chain A")]
-    #[case(" chainA.2")]
-    #[case(" chainA.2-1")]
-    #[case(" 1")]
-    #[case(" -")]
-    #[case("   -1")]
-    #[case("/chainA-1")]
-    fn test_invalid_chain_id(#[case] chain_id_str: &str) {
-        assert!(ChainId::new(chain_id_str).is_err());
-    }
-
-    #[test]
-    fn test_inc_revision_number() {
-        let mut chain_id = ChainId::new("chainA-1").unwrap();
-
-        assert!(chain_id.increment_revision_number().is_ok());
-        assert_eq!(chain_id.revision_number(), 2);
-        assert_eq!(chain_id.as_str(), "chainA-2");
-
-        assert!(chain_id.increment_revision_number().is_ok());
-        assert_eq!(chain_id.revision_number(), 3);
-        assert_eq!(chain_id.as_str(), "chainA-3");
-    }
-
-    #[test]
-    fn test_failed_inc_revision_number() {
-        let mut chain_id = ChainId::new("chainA").unwrap();
-
-        assert!(chain_id.increment_revision_number().is_err());
-        assert_eq!(chain_id.revision_number(), 0);
-        assert_eq!(chain_id.as_str(), "chainA");
-    }
-}
diff --git a/crates/ibc/src/core/ics24_host/mod.rs b/crates/ibc/src/core/ics24_host/mod.rs
deleted file mode 100644
index c7ceab539..000000000
--- a/crates/ibc/src/core/ics24_host/mod.rs
+++ /dev/null
@@ -1,5 +0,0 @@
-//! ICS 24: Host defines the minimal set of interfaces that a
-//! state machine hosting an IBC-enabled chain must implement.
-
-pub mod identifier;
-pub mod path;
diff --git a/crates/ibc/src/core/mod.rs b/crates/ibc/src/core/mod.rs
deleted file mode 100644
index 3bef22053..000000000
--- a/crates/ibc/src/core/mod.rs
+++ /dev/null
@@ -1,44 +0,0 @@
-//! Implementation of the core IBC protocol.
-
-// Naming is hard in the IBC handlers, since we deal with a client on a
-// *counterparty* chain, which is itself a light client of *self* (the chain
-// the handler is currently running on). So depending on the frame of reference
-// chosen, e.g. counterparty_client_state could mean:
-//
-// 1. the client state of the client running on the counterparty chain
-// 2. or the state of the "counterparty client" (that is, the client that we
-//    run of the counterparty chain) running on the host chain
-//
-// We remove such ambiguity by adopting the following conventions:
-// + During handshakes
-//     + we call "chain A" the chain that runs `OpenInit` and `OpenAck`
-//     + we call "chain B" the chain that runs `OpenTry` and `OpenConfirm`
-// + During packet transfers
-//     + we call "chain A" the chain that runs `SendPacket`, `Acknowledgement`, and timeouts
-//     + we call "chain B" the chain that runs `RecvPacket` and `WriteAcknowledgement`
-// + In variable names,
-//     + `on_a` implies "stored on chain A"
-//     + `of_a` implies "of light client for chain A" So
-// `client_state_of_a_on_b` means "the client state of light client for chain A
-// stored on chain B"
-
-pub mod ics02_client;
-pub mod ics03_connection;
-pub mod ics04_channel;
-pub mod ics23_commitment;
-pub mod ics24_host;
-pub mod router;
-
-pub mod events;
-pub mod timestamp;
-
-mod context;
-mod handler;
-mod msgs;
-
-pub use context::*;
-pub use handler::{dispatch, execute, validate};
-pub use ics04_channel::handler::send_packet::{
-    send_packet, send_packet_execute, send_packet_validate,
-};
-pub use msgs::{Msg, MsgEnvelope};
diff --git a/crates/ibc/src/core/msgs.rs b/crates/ibc/src/core/msgs.rs
deleted file mode 100644
index bef0e690c..000000000
--- a/crates/ibc/src/core/msgs.rs
+++ /dev/null
@@ -1,203 +0,0 @@
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::Protobuf;
-
-use crate::core::context::RouterError;
-use crate::core::ics02_client::msgs::{
-    create_client, misbehaviour, update_client, upgrade_client, ClientMsg,
-};
-use crate::core::ics03_connection::msgs::{
-    conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try, ConnectionMsg,
-};
-use crate::core::ics04_channel::msgs::{
-    acknowledgement, chan_close_confirm, chan_close_init, chan_open_ack, chan_open_confirm,
-    chan_open_init, chan_open_try, recv_packet, timeout, timeout_on_close, ChannelMsg, PacketMsg,
-};
-use crate::prelude::*;
-
-/// Trait to be implemented by all IBC messages
-pub trait Msg: Clone {
-    type Raw: From<Self> + prost::Message;
-
-    /// Unique type identifier for this message, to support encoding to/from `prost_types::Any`.
-    fn type_url(&self) -> String;
-
-    fn get_sign_bytes(self) -> Vec<u8> {
-        let raw_msg: Self::Raw = self.into();
-        prost::Message::encode_to_vec(&raw_msg)
-    }
-
-    fn to_any(self) -> Any {
-        Any {
-            type_url: self.type_url(),
-            value: self.get_sign_bytes(),
-        }
-    }
-}
-
-/// Enumeration of all messages that the local ICS26 module is capable of routing.
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
-pub enum MsgEnvelope {
-    Client(ClientMsg),
-    Connection(ConnectionMsg),
-    Channel(ChannelMsg),
-    Packet(PacketMsg),
-}
-
-impl TryFrom<Any> for MsgEnvelope {
-    type Error = RouterError;
-
-    fn try_from(any_msg: Any) -> Result<Self, Self::Error> {
-        match any_msg.type_url.as_str() {
-            // ICS2 messages
-            create_client::TYPE_URL => {
-                // Pop out the message and then wrap it in the corresponding type.
-                let domain_msg = create_client::MsgCreateClient::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Client(ClientMsg::CreateClient(domain_msg)))
-            }
-            update_client::TYPE_URL => {
-                let domain_msg = update_client::MsgUpdateClient::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Client(ClientMsg::UpdateClient(domain_msg)))
-            }
-            upgrade_client::TYPE_URL => {
-                let domain_msg = upgrade_client::MsgUpgradeClient::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Client(ClientMsg::UpgradeClient(domain_msg)))
-            }
-            misbehaviour::TYPE_URL => {
-                let domain_msg = misbehaviour::MsgSubmitMisbehaviour::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Client(ClientMsg::Misbehaviour(domain_msg)))
-            }
-
-            // ICS03
-            conn_open_init::TYPE_URL => {
-                let domain_msg = conn_open_init::MsgConnectionOpenInit::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenInit(domain_msg)))
-            }
-            conn_open_try::TYPE_URL => {
-                let domain_msg = conn_open_try::MsgConnectionOpenTry::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenTry(domain_msg)))
-            }
-            conn_open_ack::TYPE_URL => {
-                let domain_msg = conn_open_ack::MsgConnectionOpenAck::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenAck(domain_msg)))
-            }
-            conn_open_confirm::TYPE_URL => {
-                let domain_msg =
-                    conn_open_confirm::MsgConnectionOpenConfirm::decode_vec(&any_msg.value)
-                        .map_err(|e| RouterError::MalformedMessageBytes {
-                            reason: e.to_string(),
-                        })?;
-                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenConfirm(
-                    domain_msg,
-                )))
-            }
-
-            // ICS04 channel messages
-            chan_open_init::TYPE_URL => {
-                let domain_msg = chan_open_init::MsgChannelOpenInit::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::OpenInit(domain_msg)))
-            }
-            chan_open_try::TYPE_URL => {
-                let domain_msg = chan_open_try::MsgChannelOpenTry::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::OpenTry(domain_msg)))
-            }
-            chan_open_ack::TYPE_URL => {
-                let domain_msg = chan_open_ack::MsgChannelOpenAck::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::OpenAck(domain_msg)))
-            }
-            chan_open_confirm::TYPE_URL => {
-                let domain_msg = chan_open_confirm::MsgChannelOpenConfirm::decode_vec(
-                    &any_msg.value,
-                )
-                .map_err(|e| RouterError::MalformedMessageBytes {
-                    reason: e.to_string(),
-                })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::OpenConfirm(domain_msg)))
-            }
-            chan_close_init::TYPE_URL => {
-                let domain_msg = chan_close_init::MsgChannelCloseInit::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                    reason: e.to_string(),
-                })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::CloseInit(domain_msg)))
-            }
-            chan_close_confirm::TYPE_URL => {
-                let domain_msg =
-                    chan_close_confirm::MsgChannelCloseConfirm::decode_vec(&any_msg.value)
-                        .map_err(|e| RouterError::MalformedMessageBytes {
-                            reason: e.to_string(),
-                        })?;
-                Ok(MsgEnvelope::Channel(ChannelMsg::CloseConfirm(domain_msg)))
-            }
-            // ICS04 packet messages
-            recv_packet::TYPE_URL => {
-                let domain_msg =
-                    recv_packet::MsgRecvPacket::decode_vec(&any_msg.value).map_err(|e| {
-                        RouterError::MalformedMessageBytes {
-                            reason: e.to_string(),
-                        }
-                    })?;
-                Ok(MsgEnvelope::Packet(PacketMsg::Recv(domain_msg)))
-            }
-            acknowledgement::TYPE_URL => {
-                let domain_msg = acknowledgement::MsgAcknowledgement::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Packet(PacketMsg::Ack(domain_msg)))
-            }
-            timeout::TYPE_URL => {
-                let domain_msg = timeout::MsgTimeout::decode_vec(&any_msg.value).map_err(|e| {
-                    RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    }
-                })?;
-                Ok(MsgEnvelope::Packet(PacketMsg::Timeout(domain_msg)))
-            }
-            timeout_on_close::TYPE_URL => {
-                let domain_msg = timeout_on_close::MsgTimeoutOnClose::decode_vec(&any_msg.value)
-                    .map_err(|e| RouterError::MalformedMessageBytes {
-                        reason: e.to_string(),
-                    })?;
-                Ok(MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(domain_msg)))
-            }
-            _ => Err(RouterError::UnknownMessageTypeUrl {
-                url: any_msg.type_url,
-            }),
-        }
-    }
-}
diff --git a/crates/ibc/src/hosts/mod.rs b/crates/ibc/src/hosts/mod.rs
deleted file mode 100644
index 8d3836cfe..000000000
--- a/crates/ibc/src/hosts/mod.rs
+++ /dev/null
@@ -1,2 +0,0 @@
-//! Provides convenience implementations for various hosts
-pub mod tendermint;
diff --git a/crates/ibc/src/hosts/tendermint/mod.rs b/crates/ibc/src/hosts/tendermint/mod.rs
deleted file mode 100644
index fc7188dc4..000000000
--- a/crates/ibc/src/hosts/tendermint/mod.rs
+++ /dev/null
@@ -1,12 +0,0 @@
-//! Provides convenience implementations for Tendermint-based hosts
-
-pub mod upgrade_proposal;
-
-mod validate_self_client;
-pub use validate_self_client::ValidateSelfClientContext;
-
-/// ABCI store/query path for the IBC sub-store
-pub const IBC_QUERY_PATH: &str = "store/ibc/key";
-
-/// ABCI store/query path for the upgrade sub-store
-pub const SDK_UPGRADE_QUERY_PATH: &str = "store/upgrade/key";
diff --git a/crates/ibc/src/lib.rs b/crates/ibc/src/lib.rs
deleted file mode 100644
index 16318bdfb..000000000
--- a/crates/ibc/src/lib.rs
+++ /dev/null
@@ -1,72 +0,0 @@
-#![cfg_attr(not(test), deny(clippy::unwrap_used))]
-#![no_std]
-#![deny(
-    warnings,
-    trivial_casts,
-    trivial_numeric_casts,
-    unused_import_braces,
-    unused_qualifications,
-    rust_2018_idioms
-)]
-#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
-#![forbid(unsafe_code)]
-// https://github.com/cosmos/ibc-rs/issues/342
-#![allow(clippy::result_large_err)]
-//! This library implements the InterBlockchain Communication (IBC) protocol in Rust. IBC is
-//! a distributed protocol that enables communication between distinct sovereign blockchains.
-//!
-//! The layout of this crate mirrors the organization of the [IBC
-//! Standard][ibc-standard]:
-//!
-//! + [Core](core) implements the transport, authentication, and ordering layers of the IBC protocol.
-//!
-//! + [Clients](clients) consists of implementations of client verification algorithms (following the base
-//! client interface that is defined in `Core`) for specific consensus algorithms. A chain uses these
-//! verification algorithms to verify the state of remote chains.
-//!
-//! + [Applications](applications) consists of implementations of some IBC applications. This is the part of
-//! the protocol that abstracts away the core protocol and focuses solely on business logic.
-//!
-//! When processing a given message `M`, if any method in this library returns an error, the runtime
-//! is expected to rollback all state modifications made to the context
-//! (e.g. [`ExecutionContext`](core::ExecutionContext)) while processing `M`. If a transaction on your
-//! blockchain contains multiple messages, then typically the state modifications from all messages
-//! is expected to be rolled back as well.
-//!
-//! # Note
-//!
-//! Currently, the `serde` feature (required by the token transfer app) does not work in `no_std` environments.
-//! See context [here](https://github.com/cosmos/ibc-proto-rs/pull/92). If this is a blocker for you, please
-//! open a Github issue.
-//!
-//! [ibc-standard]: https://github.com/cosmos/ibc
-
-extern crate alloc;
-#[cfg(any(test, feature = "std"))]
-extern crate std;
-
-pub use signer::Signer;
-
-/// Represents a block height
-pub use crate::core::ics02_client::height::Height;
-
-pub mod applications;
-pub mod clients;
-pub mod core;
-pub mod hosts;
-
-pub mod prelude;
-mod signer;
-pub mod utils;
-
-#[cfg(feature = "serde")]
-mod serializers;
-
-/// Re-exports pertinent ibc proto types from the `ibc-proto-rs` crate for added convenience
-pub mod proto {
-    pub use ibc_proto::google::protobuf::Any;
-    pub use ibc_proto::ibc::apps::transfer;
-    pub use ibc_proto::ibc::lightclients::tendermint;
-    pub use ibc_proto::ibc::{core, mock};
-    pub use ibc_proto::{ics23, Protobuf};
-}
diff --git a/crates/ibc/src/serializers.rs b/crates/ibc/src/serializers.rs
deleted file mode 100644
index a4b56473b..000000000
--- a/crates/ibc/src/serializers.rs
+++ /dev/null
@@ -1,74 +0,0 @@
-use serde::ser::{Serialize, Serializer};
-use subtle_encoding::{Encoding, Hex};
-
-pub fn ser_hex_upper<S, T>(data: T, serializer: S) -> Result<S::Ok, S::Error>
-where
-    S: Serializer,
-    T: AsRef<[u8]>,
-{
-    let hex = Hex::upper_case()
-        .encode_to_string(data)
-        .map_err(|e| serde::ser::Error::custom(alloc::format!("failed to serialize hex: {}", e)))?;
-    hex.serialize(serializer)
-}
-
-pub mod serde_string {
-    use core::fmt::Display;
-    use core::str::FromStr;
-
-    use serde::{de, Deserialize, Deserializer, Serializer};
-
-    use crate::prelude::*;
-
-    // Note: used String version (slower + heap) instead of str,
-    // because both str ser/de hit some kind of f64/f32 case when compiled into wasm
-    // and fails to be validated f32/f64 wasm runtimes
-    pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
-    where
-        T: Display,
-        S: Serializer,
-    {
-        serializer.serialize_str(value.to_string().as_ref())
-    }
-
-    pub fn deserialize<'de, T, D>(deserializer: D) -> Result<T, D::Error>
-    where
-        T: FromStr,
-        T::Err: Display,
-        D: Deserializer<'de>,
-    {
-        T::from_str(<String>::deserialize(deserializer)?.as_str()).map_err(de::Error::custom)
-    }
-}
-
-/// Test that a struct `T` can be:
-///
-/// - parsed out of the provided JSON data
-/// - serialized back to JSON
-/// - parsed back from the serialized JSON of the previous step
-/// - that the two parsed structs are equal according to their `PartialEq` impl
-#[cfg(test)]
-pub mod tests {
-    use serde::de::DeserializeOwned;
-
-    use super::*;
-
-    pub fn test_serialization_roundtrip<T>(json_data: &str)
-    where
-        T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
-    {
-        let parsed0 = serde_json::from_str::<T>(json_data);
-        assert!(parsed0.is_ok());
-        let parsed0 = parsed0.unwrap();
-
-        let serialized = serde_json::to_string(&parsed0);
-        assert!(serialized.is_ok());
-        let serialized = serialized.unwrap();
-
-        let parsed1 = serde_json::from_str::<T>(&serialized);
-        assert!(parsed1.is_ok());
-        let parsed1 = parsed1.unwrap();
-
-        assert_eq!(parsed0, parsed1);
-    }
-}
diff --git a/crates/ibc/src/utils/mod.rs b/crates/ibc/src/utils/mod.rs
deleted file mode 100644
index f0eeeadba..000000000
--- a/crates/ibc/src/utils/mod.rs
+++ /dev/null
@@ -1,3 +0,0 @@
-//! Various utilities used internally
-pub(crate) mod macros;
-pub(crate) mod pretty;
diff --git a/docs/architecture/adr-006-upgrade-client-implementation.md b/docs/architecture/adr-006-upgrade-client-implementation.md
index f389a6336..9d8137409 100644
--- a/docs/architecture/adr-006-upgrade-client-implementation.md
+++ b/docs/architecture/adr-006-upgrade-client-implementation.md
@@ -20,7 +20,7 @@ justify the chain-wide logic behind upgrading light clients, list requisites for
 validation and execution steps, determine the boundary between basic and
 upgrade-specific validations by an IBC handler, and explain Tendermint's upgrade
 client implementation within the
-[ics07_tendermint](../../crates/ibc/src/clients/ics07_tendermint).
+[ics07_tendermint](../../ibc/src/clients/ics07_tendermint).
 
 ## Decision
 
@@ -41,9 +41,9 @@ we will explain how we have implemented this rationale in IBC-rs.
 * There **MUST** be a proof verification process to check upgraded client and
   consensus states against the host chain's state.
 * Chain upgrades **MUST NOT** result in changing
-  [ClientState](../../crates/ibc/src/core/ics02_client/client_state.rs#ClientState)
+  [ClientState](../../ibc/src/core/ics02_client/client_state.rs#ClientState)
   or
-  [ConsensusState](../../crates/ibc/src/core/ics02_client/consensus_state.rs#ConsensusState)
+  [ConsensusState](../../ibc/src/core/ics02_client/consensus_state.rs#ConsensusState)
   implementations
 * It is **UP TO** the chain's architecture how upgraded client and consensus
   states are committed, either through decentralized approaches, like governance
@@ -104,9 +104,9 @@ supported by `IBC-rs`:
    recommended that chains reduce the unbonding period.
 7. (P) Changing the Tendermint LightClient algorithm: Changes to the light
    client algorithm that do not change the
-   [ClientState](../../crates/ibc/src/clients/ics07_tendermint/client_state.rs#ClientState)
+   [ClientState](../../ibc/src/clients/ics07_tendermint/client_state.rs#ClientState)
    or
-   [ConsensusState](../../crates/ibc/src/clients/ics07_tendermint/consensus_state.rs#ConsensusState)
+   [ConsensusState](../../ibc/src/clients/ics07_tendermint/consensus_state.rs#ConsensusState)
    struct abstraction may be supported, provided that the counterparty is also
    upgraded to support the new light client algorithm. Changes that require
    updating the `ClientState` and `ConsensusState` structs themselves are
@@ -206,7 +206,7 @@ validations (SV) and lastly execution (E) steps as follows:
 
 Whenever the IBC handler receives an `MsgUpgradeClient`, it dispatches the
 decoded message to the router and triggers the
-[process](../../crates/ibc/src/core/ics02_client/handler/upgrade_client.rs#process)
+[process](../../ibc/src/core/ics02_client/handler/upgrade_client.rs#process)
 function of `upgrade_client` handler, which would go through the steps outlined
 in 3rd section of [Upgrade Process Step-by-Step](#upgrade-process-step-by-step).
 Just note that the `process` function will be rendered into `validate` and
diff --git a/docs/architecture/adr-008-restructure-ibc-crate.md b/docs/architecture/adr-008-restructure-ibc-crate.md
new file mode 100644
index 000000000..45c7be6e8
--- /dev/null
+++ b/docs/architecture/adr-008-restructure-ibc-crate.md
@@ -0,0 +1,190 @@
+# ADR 008: RESTRUCTURE `ibc` CRATE
+
+## Context
+
+The current state of the **`ibc`** crate exhibits a mix of different
+implementation layers. From a module-based perspective, it encompasses essential
+elements like ibc core, clients, applications, along with testing facilities.
+However, an architectural view reveals a fusion of diverse layers of type
+definitions, interfaces (APIs), and handler functions, resulting in a mix of
+dependencies and features that may lead to potential conflicts or unnecessary
+imports for users.
+
+As of [this pull request](https://github.com/cosmos/ibc-rs/pull/954), we've
+separated our mock testing kit into the standalone **`ibc-testkit`** library.
+This decoupling from the main **`ibc`** crate sets the stage for the objectives
+of this ADR.
+
+The primary goals here are twofold: firstly, to reduce interdependence within
+the codebase among various components such as ibc core, clients, and
+applications, and secondly, to improve the overall usability of the `ibc-rs`
+implementation. The overarching aim is to empower users to selectively import
+specific IBC layers, mitigating potential conflicts related to dependencies or
+features that may arise in the context of a monolithic library and letting
+`ibc-rs` be used in the following scenarios:
+
+1. **Selective Module Import**
+    - Users cannot import only the necessary components/modules for their
+      projects. For instance, importing only the **`ics07_tendermint`**
+      implementation is impractical.
+2. **Selective Types Import**
+    - Relayers, like Hermes, or any off-chain consumers cannot import their
+      desired layer of implementation like ibc types without pulling in
+      unnecessary dependencies into their project.
+3. **Smoother IBC Core Integration with Hosts**
+    - Integrating ibc core with host chains without introducing light client or
+      app dependencies is currently not straightforward, impeding smooth
+      integration.
+4. **Easier Development of CosmWasm Contracts**
+    - For developing a CosmWasm tendermint light client, we ideally should only
+      be dependent on implementation under the **`ics07_tendermint`** and also
+      be importing relevant parts from the **`ibc-core-client`** layer without
+      pulling in all the ibc codebase and dependencies.
+
+This ADR aims to enhance both the usability and practicality of `ibc-rs` by
+restructuring the codebase and organizing it under multiple sub-libraries, as
+stated in the [decision](#decision) section. This will make different parts of
+`ibc-rs` accessible to users, positioning it as a more comprehensive, one-stop
+solution catering to diverse user groups, whether for on-chain or off-chain use
+cases.
+
+## Decision
+
+For the library organization, the first stage of separation is to split the
+codebase so that each IBC application, client, and core implementation is
+decoupled from one another. The top-level libraries and the naming schema would
+look as follows:
+
+```markdown
+.
+├── ibc -> Primarily re-exports sub-libraries
+├── ibc-core 
+│   ├── ibc-core-client (contains the implementation + Re-exports types)
+│   ├── ibc-core-connection
+│   ├── ibc-core-channel
+│   ├── ibc-core-commitment
+│   └── ibc-core-host
+│       └── .
+├── ibc-clients
+│   ├── ibc-client-tendermint
+│   ├── ibc-client-tendermint-cw
+│   └── .
+├── ibc-apps
+│   ├── ibc-app-transfer
+│   ├── ibc-app-ica
+│   │   └── .
+│   └── .
+├── ibc-primitives
+├── ibc-testkit (previously mock module + `test-utils` feature)
+├── ibc-query
+└── ibc-derive
+```
+
+With this restructure, the main `ibc` crate primarily re-exports types,
+interfaces, and implementations of all the sub-libraries. Therefore, if someone
+only wants to depend on the `ibc` crate without caring about this granularity,
+they can do so.
+
+Afterward, we split off data structure (domain types) of each IBC layer into a
+separate sub-library under a `types` folder, still maintained under the
+directory of that relevant component/module. As an example, the
+`ibc-core-client` crate’s tree and the naming schema would look like this:
+
+```markdown
+ibc-core
+└── ibc-core-client (dir: ibc-core/ics02-client)
+    └── ibc-core-client-types (dir: ibc-core/ics02-client/types)
+        ├── msgs
+        ├── events
+        └── .
+```
+
+This way, the main crate of each IBC module contains all the necessary APIs and
+implementations to integrate with host chains, along with re-exporting the
+sub-library types. This allows projects to selectively import types (e.g.
+`ibc-core-client-types`), often required by off-chain users such as relayers. Or
+to pick the library containing the entire implementation of that particular
+module (e.g. `ibc-core-client`), typically more convenient for host chains or
+smart contract developers to integrate with on their end.
+
+Once the restructuring is complete, the **directory tree** of the repo would
+look as follows:
+
+```markdown
+ibc
+ibc-core
+├── ics02-client
+|   ├── src
+|   ├── types
+|   |   ├── src
+|   |   └── Cargo.toml
+|   └── Cargo.toml
+├── ics03-connection
+|   └── .
+├── ics04-channel
+|   └── .
+├── ics23-commitment
+|   └── .
+├── ics24-host
+|   └── .
+├── src
+├── Cargo.toml
+└── README.md
+ibc-clients
+├── ics07-tendermint
+├── ics08-wasm
+└── .
+ibc-apps
+├── ics20-transfer
+├── ics27-ica
+└── .
+ibc-primitives
+ibc-testkit
+ibc-query
+ibc-derive
+```
+
+In the refactored codebase, there will be several `*-types` crates that rely on
+the `ibc-proto` library. This library acts as an upstream crate, facilitating
+the conversion to and from proto types. Each `*-types` crate also re-exports
+crucial proto types for added user convenience. This approach ensures a seamless
+experience for users downstream, sparing them the necessity of directly
+including the `ibc-proto` dependency in their projects. Consequently, the
+`*-types` crates serve as comprehensive, battery-included libraries.
+
+To implement this ADR efficiently and for more organization, we use the
+workspace inheritance feature and will add a top-level README for main library
+groups like `ibc-core`, `ibc-clients`, etc serving as a guide for users to
+understand the purpose and structure of their sub libraries.
+
+Later, it is crucial to come up with a Github action to automate and simplify
+the release process as well.
+
+## **Status**
+
+Proposed
+
+## **Consequences**
+
+We should acknowledge this restructuring, while a significant step forward, will
+not completely address all existing design couplings. Subsequent improvements in
+implementation logic will be necessary to completely decouple ibc core, clients,
+and applications from each other and make the entire logic as chain-agnostic as
+possible. For instance, currently, our `IbcEvent` type depends on the Tendermint
+events in their conversion, which can only be addressed once this restructuring
+is complete. There may be other mix-ups as well, but the new repository
+structure significantly simplifies their handling and ensures `ibc-rs` evolves
+into a more adaptable, modular, and composable implementation that can serve
+various use cases.
+
+### **Positive**
+
+- Opens up a range of new use cases for `ibc-rs`
+- Facilitates moving toward more chain-agnostic and flexible design and interfaces
+- Simplifies development on top of each layer of `ibc-rs` implementation
+
+### **Negative**
+
+- Multiple libraries are more challenging to maintain
+- Enforces current users to update a large number of their import paths from
+  `ibc` crates
diff --git a/ibc-apps/Cargo.toml b/ibc-apps/Cargo.toml
new file mode 100644
index 000000000..9057c5e7f
--- /dev/null
+++ b/ibc-apps/Cargo.toml
@@ -0,0 +1,40 @@
+[package]
+name         = "ibc-apps"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "applications", "token-transfer"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement various
+    IBC applications, enabling smooth integration of IBC business logic into any blockchain system.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+ibc-app-transfer = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-app-transfer/std",
+]
+serde = [
+    "ibc-app-transfer/serde",
+]
+schema = [
+    "ibc-app-transfer/schema",
+    "serde",
+    "std",
+]
+borsh = [
+    "ibc-app-transfer/borsh",
+]
+parity-scale-codec = [
+    "ibc-app-transfer/parity-scale-codec",
+]
diff --git a/ibc-apps/README.md b/ibc-apps/README.md
new file mode 100644
index 000000000..71c8848df
--- /dev/null
+++ b/ibc-apps/README.md
@@ -0,0 +1,37 @@
+# IBC Applications
+
+This crate is a top-level library that re-exports implementations of
+Inter-Blockchain Communication (IBC) applications. It serves as a meta-crate,
+simplifying the process of importing and integrating various IBC applications
+into your blockchain. IBC is a distributed protocol that enables communication
+between distinct sovereign blockchains. IBC applications abstract away the core
+transport, authentication, and ordering (TAO) layers, letting blockchain app
+developers focus solely on implementing business logic.
+
+The structure within the `ibc-apps` crate is designed to provide flexibility for
+external users. It allows users to either utilize the entire `ibc-apps` crate,
+or selectively import specific sub-crates, whether they need a certain IBC
+application (e.g. `ibc-app-transfer` crate) or only its associated data
+structures (e.g. `ibc-app-transfer-types`). This versatility empowers hosts,
+including chain integrators, relayers, or any IBC tooling projects, to build
+their solutions on top of the layers that best suit their requirements.
+
+## Sub-Crates
+
+The `ibc-apps` crate contains the implementation of the following IBC
+applications:
+
+### ICS-20: Fungible Token Transfer Application
+
+- [ibc-app-transfer](./../ibc-apps/ics20-transfer)
+- [ibc-app-transfer-types](./../ibc-apps/ics20-transfer/types)
+
+## Contributing
+
+IBC is specified in English in the [cosmos/ibc
+repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
+should be contributed there.
+
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./../CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
diff --git a/ibc-apps/ics20-transfer/Cargo.toml b/ibc-apps/ics20-transfer/Cargo.toml
new file mode 100644
index 000000000..2e992e718
--- /dev/null
+++ b/ibc-apps/ics20-transfer/Cargo.toml
@@ -0,0 +1,56 @@
+[package]
+name         = "ibc-app-transfer"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of the ICS-20 Fungible Token Transfer
+    application logic and re-exports essential data structures and domain types from
+    `ibc-app-transfer-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+serde_json =  { workspace = true, optional = true }
+
+# ibc dependencies
+ibc-core               = { workspace = true }
+ibc-app-transfer-types = { workspace = true }
+
+[dev-dependencies]
+subtle-encoding = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-app-transfer-types/std",
+    "ibc-core/std",
+    "serde_json/std",
+]
+serde = [
+    "ibc-app-transfer-types/serde",
+    "ibc-core/serde",
+    "dep:serde_json"
+]
+schema = [
+    "ibc-app-transfer-types/schema",
+    "ibc-core/schema",
+    "serde",
+    "std",
+]
+borsh = [
+    "ibc-app-transfer-types/borsh",
+    "ibc-core/borsh",
+]
+parity-scale-codec = [
+    "ibc-app-transfer-types/parity-scale-codec",
+    "ibc-core/parity-scale-codec",
+]
diff --git a/ibc-apps/ics20-transfer/src/context.rs b/ibc-apps/ics20-transfer/src/context.rs
new file mode 100644
index 000000000..672c87819
--- /dev/null
+++ b/ibc-apps/ics20-transfer/src/context.rs
@@ -0,0 +1,81 @@
+//! Defines the main context traits and IBC module callbacks
+
+use ibc_app_transfer_types::error::TokenTransferError;
+use ibc_app_transfer_types::{PrefixedCoin, PrefixedDenom};
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+
+/// Methods required in token transfer validation, to be implemented by the host
+pub trait TokenTransferValidationContext {
+    type AccountId: TryFrom<Signer>;
+
+    /// get_port returns the portID for the transfer module.
+    fn get_port(&self) -> Result<PortId, TokenTransferError>;
+
+    /// Returns the escrow account id for a port and channel combination
+    fn get_escrow_account(
+        &self,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+    ) -> Result<Self::AccountId, TokenTransferError>;
+
+    /// Returns Ok() if the host chain supports sending coins.
+    fn can_send_coins(&self) -> Result<(), TokenTransferError>;
+
+    /// Returns Ok() if the host chain supports receiving coins.
+    fn can_receive_coins(&self) -> Result<(), TokenTransferError>;
+
+    /// Validates the sender and receiver accounts and the coin inputs
+    fn send_coins_validate(
+        &self,
+        from_account: &Self::AccountId,
+        to_account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+
+    /// Validates the receiver account and the coin input
+    fn mint_coins_validate(
+        &self,
+        account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+
+    /// Validates the sender account and the coin input
+    fn burn_coins_validate(
+        &self,
+        account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+
+    /// Returns a hash of the prefixed denom.
+    /// Implement only if the host chain supports hashed denominations.
+    fn denom_hash_string(&self, _denom: &PrefixedDenom) -> Option<String> {
+        None
+    }
+}
+
+/// Methods required in token transfer execution, to be implemented by the host
+pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
+    /// This function should enable sending ibc fungible tokens from one account to another
+    fn send_coins_execute(
+        &mut self,
+        from_account: &Self::AccountId,
+        to_account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+
+    /// This function to enable minting ibc tokens to a user account
+    fn mint_coins_execute(
+        &mut self,
+        account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+
+    /// This function should enable burning of minted tokens in a user account
+    fn burn_coins_execute(
+        &mut self,
+        account: &Self::AccountId,
+        coin: &PrefixedCoin,
+    ) -> Result<(), TokenTransferError>;
+}
diff --git a/crates/ibc/src/applications/transfer/relay.rs b/ibc-apps/ics20-transfer/src/handler/mod.rs
similarity index 81%
rename from crates/ibc/src/applications/transfer/relay.rs
rename to ibc-apps/ics20-transfer/src/handler/mod.rs
index 227ac8243..9689ab629 100644
--- a/crates/ibc/src/applications/transfer/relay.rs
+++ b/ibc-apps/ics20-transfer/src/handler/mod.rs
@@ -1,14 +1,15 @@
 //! Implements the processing logic for ICS20 (token transfer) message.
+mod on_recv_packet;
+mod send_transfer;
 
-use super::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::is_sender_chain_source;
-use crate::applications::transfer::packet::PacketData;
-use crate::core::ics04_channel::packet::Packet;
-use crate::prelude::*;
+use ibc_app_transfer_types::error::TokenTransferError;
+use ibc_app_transfer_types::is_sender_chain_source;
+use ibc_app_transfer_types::packet::PacketData;
+use ibc_core::channel::types::packet::Packet;
+pub use on_recv_packet::*;
+pub use send_transfer::*;
 
-pub mod on_recv_packet;
-pub mod send_transfer;
+use crate::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
 
 pub fn refund_packet_token_execute(
     ctx_a: &mut impl TokenTransferExecutionContext,
diff --git a/crates/ibc/src/applications/transfer/relay/on_recv_packet.rs b/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
similarity index 90%
rename from crates/ibc/src/applications/transfer/relay/on_recv_packet.rs
rename to ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
index 9e9e70c2d..2baa187f6 100644
--- a/crates/ibc/src/applications/transfer/relay/on_recv_packet.rs
+++ b/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
@@ -1,11 +1,12 @@
-use crate::applications::transfer::context::TokenTransferExecutionContext;
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::events::DenomTraceEvent;
-use crate::applications::transfer::packet::PacketData;
-use crate::applications::transfer::{is_receiver_chain_source, TracePrefix};
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::router::ModuleExtras;
-use crate::prelude::*;
+use ibc_app_transfer_types::error::TokenTransferError;
+use ibc_app_transfer_types::events::DenomTraceEvent;
+use ibc_app_transfer_types::packet::PacketData;
+use ibc_app_transfer_types::{is_receiver_chain_source, TracePrefix};
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::primitives::prelude::*;
+use ibc_core::router::types::module::ModuleExtras;
+
+use crate::context::TokenTransferExecutionContext;
 
 /// This function handles the transfer receiving logic.
 ///
diff --git a/crates/ibc/src/applications/transfer/relay/send_transfer.rs b/ibc-apps/ics20-transfer/src/handler/send_transfer.rs
similarity index 88%
rename from crates/ibc/src/applications/transfer/relay/send_transfer.rs
rename to ibc-apps/ics20-transfer/src/handler/send_transfer.rs
index 112462cd0..683b96edf 100644
--- a/crates/ibc/src/applications/transfer/relay/send_transfer.rs
+++ b/ibc-apps/ics20-transfer/src/handler/send_transfer.rs
@@ -1,18 +1,16 @@
-use crate::applications::transfer::context::{
-    TokenTransferExecutionContext, TokenTransferValidationContext,
-};
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::events::TransferEvent;
-use crate::applications::transfer::msgs::transfer::MsgTransfer;
-use crate::applications::transfer::{is_sender_chain_source, MODULE_ID_STR};
-use crate::core::events::{MessageEvent, ModuleEvent};
-use crate::core::ics04_channel::context::{
-    SendPacketExecutionContext, SendPacketValidationContext,
-};
-use crate::core::ics04_channel::handler::send_packet::{send_packet_execute, send_packet_validate};
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics24_host::path::{ChannelEndPath, SeqSendPath};
-use crate::prelude::*;
+use ibc_app_transfer_types::error::TokenTransferError;
+use ibc_app_transfer_types::events::TransferEvent;
+use ibc_app_transfer_types::msgs::transfer::MsgTransfer;
+use ibc_app_transfer_types::{is_sender_chain_source, MODULE_ID_STR};
+use ibc_core::channel::context::{SendPacketExecutionContext, SendPacketValidationContext};
+use ibc_core::channel::handler::{send_packet_execute, send_packet_validate};
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::handler::types::events::MessageEvent;
+use ibc_core::host::types::path::{ChannelEndPath, SeqSendPath};
+use ibc_core::primitives::prelude::*;
+use ibc_core::router::types::event::ModuleEvent;
+
+use crate::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
 
 /// Initiate a token transfer. Equivalent to calling [`send_transfer_validate`], followed by [`send_transfer_execute`].
 pub fn send_transfer<SendPacketCtx, TokenCtx>(
diff --git a/ibc-apps/ics20-transfer/src/lib.rs b/ibc-apps/ics20-transfer/src/lib.rs
new file mode 100644
index 000000000..8c2c31d9c
--- /dev/null
+++ b/ibc-apps/ics20-transfer/src/lib.rs
@@ -0,0 +1,32 @@
+//! Implementation of the IBC [fungible token transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md) (ICS-20) application logic.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+#![allow(clippy::result_large_err)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+/// Re-exports the implementation of the IBC [fungible token
+/// transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md)
+/// (ICS-20) data structures.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_app_transfer_types::*;
+}
+
+#[cfg(feature = "serde")]
+pub mod context;
+#[cfg(feature = "serde")]
+pub mod handler;
+#[cfg(feature = "serde")]
+pub mod module;
diff --git a/crates/ibc/src/applications/transfer/context.rs b/ibc-apps/ics20-transfer/src/module.rs
similarity index 62%
rename from crates/ibc/src/applications/transfer/context.rs
rename to ibc-apps/ics20-transfer/src/module.rs
index 33d080f30..c9b5d75b8 100644
--- a/crates/ibc/src/applications/transfer/context.rs
+++ b/ibc-apps/ics20-transfer/src/module.rs
@@ -1,112 +1,21 @@
-//! Defines the main context traits and IBC module callbacks
-use sha2::{Digest, Sha256};
-
-use super::ack_success_b64;
-use super::error::TokenTransferError;
-use crate::applications::transfer::events::{AckEvent, AckStatusEvent, RecvEvent, TimeoutEvent};
-use crate::applications::transfer::packet::PacketData;
-use crate::applications::transfer::relay::on_recv_packet::process_recv_packet_execute;
-use crate::applications::transfer::relay::{
-    refund_packet_token_execute, refund_packet_token_validate,
+use ibc_app_transfer_types::error::TokenTransferError;
+use ibc_app_transfer_types::events::{AckEvent, AckStatusEvent, RecvEvent, TimeoutEvent};
+use ibc_app_transfer_types::packet::PacketData;
+use ibc_app_transfer_types::{ack_success_b64, VERSION};
+use ibc_core::channel::types::acknowledgement::{Acknowledgement, AcknowledgementStatus};
+use ibc_core::channel::types::channel::{Counterparty, Order};
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::channel::types::Version;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+use ibc_core::router::types::module::ModuleExtras;
+
+use crate::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
+use crate::handler::{
+    process_recv_packet_execute, refund_packet_token_execute, refund_packet_token_validate,
 };
-use crate::applications::transfer::{PrefixedCoin, PrefixedDenom, VERSION};
-use crate::core::ics04_channel::acknowledgement::{Acknowledgement, AcknowledgementStatus};
-use crate::core::ics04_channel::channel::{Counterparty, Order};
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::router::ModuleExtras;
-use crate::core::ContextError;
-use crate::prelude::*;
-use crate::signer::Signer;
-
-/// Methods required in token transfer validation, to be implemented by the host
-pub trait TokenTransferValidationContext {
-    type AccountId: TryFrom<Signer>;
-
-    /// get_port returns the portID for the transfer module.
-    fn get_port(&self) -> Result<PortId, TokenTransferError>;
-
-    /// Returns the escrow account id for a port and channel combination
-    fn get_escrow_account(
-        &self,
-        port_id: &PortId,
-        channel_id: &ChannelId,
-    ) -> Result<Self::AccountId, TokenTransferError>;
-
-    /// Returns Ok() if the host chain supports sending coins.
-    fn can_send_coins(&self) -> Result<(), TokenTransferError>;
-
-    /// Returns Ok() if the host chain supports receiving coins.
-    fn can_receive_coins(&self) -> Result<(), TokenTransferError>;
-
-    /// Validates the sender and receiver accounts and the coin inputs
-    fn send_coins_validate(
-        &self,
-        from_account: &Self::AccountId,
-        to_account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-
-    /// Validates the receiver account and the coin input
-    fn mint_coins_validate(
-        &self,
-        account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-
-    /// Validates the sender account and the coin input
-    fn burn_coins_validate(
-        &self,
-        account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-
-    /// Returns a hash of the prefixed denom.
-    /// Implement only if the host chain supports hashed denominations.
-    fn denom_hash_string(&self, _denom: &PrefixedDenom) -> Option<String> {
-        None
-    }
-}
-
-/// Methods required in token transfer execution, to be implemented by the host
-pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
-    /// This function should enable sending ibc fungible tokens from one account to another
-    fn send_coins_execute(
-        &mut self,
-        from_account: &Self::AccountId,
-        to_account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-
-    /// This function to enable minting ibc tokens to a user account
-    fn mint_coins_execute(
-        &mut self,
-        account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-
-    /// This function should enable burning of minted tokens in a user account
-    fn burn_coins_execute(
-        &mut self,
-        account: &Self::AccountId,
-        coin: &PrefixedCoin,
-    ) -> Result<(), TokenTransferError>;
-}
-
-// https://github.com/cosmos/cosmos-sdk/blob/master/docs/architecture/adr-028-public-key-addresses.md
-pub fn cosmos_adr028_escrow_address(port_id: &PortId, channel_id: &ChannelId) -> Vec<u8> {
-    let contents = format!("{port_id}/{channel_id}");
-
-    let mut hasher = Sha256::new();
-    hasher.update(VERSION.as_bytes());
-    hasher.update([0]);
-    hasher.update(contents.as_bytes());
-
-    let mut hash = hasher.finalize().to_vec();
-    hash.truncate(20);
-    hash
-}
 
 pub fn on_chan_open_init_validate(
     ctx: &impl TokenTransferValidationContext,
@@ -411,39 +320,70 @@ pub fn on_timeout_packet_execute(
 }
 
 #[cfg(test)]
-mod tests {
-    use subtle_encoding::bech32;
+mod test {
+    use ibc_app_transfer_types::ack_success_b64;
+    use ibc_app_transfer_types::error::TokenTransferError;
 
     use super::*;
-    use crate::applications::transfer::context::cosmos_adr028_escrow_address;
 
     #[test]
-    fn test_cosmos_escrow_address() {
-        fn assert_eq_escrow_address(port_id: &str, channel_id: &str, address: &str) {
-            let port_id = port_id.parse().unwrap();
-            let channel_id = channel_id.parse().unwrap();
-            let gen_address = {
-                let addr = cosmos_adr028_escrow_address(&port_id, &channel_id);
-                bech32::encode("cosmos", addr)
-            };
-            assert_eq!(gen_address, address.to_owned())
+    fn test_ack_ser() {
+        fn ser_json_assert_eq(ack: AcknowledgementStatus, json_str: &str) {
+            let ser = serde_json::to_string(&ack).unwrap();
+            assert_eq!(ser, json_str)
         }
 
-        // addresses obtained using `gaiad query ibc-transfer escrow-address [port-id] [channel-id]`
-        assert_eq_escrow_address(
-            "transfer",
-            "channel-141",
-            "cosmos1x54ltnyg88k0ejmk8ytwrhd3ltm84xehrnlslf",
+        ser_json_assert_eq(
+            AcknowledgementStatus::success(ack_success_b64()),
+            r#"{"result":"AQ=="}"#,
         );
-        assert_eq_escrow_address(
-            "transfer",
-            "channel-207",
-            "cosmos1ju6tlfclulxumtt2kglvnxduj5d93a64r5czge",
+        ser_json_assert_eq(
+            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into()),
+            r#"{"error":"failed to deserialize packet data"}"#,
         );
-        assert_eq_escrow_address(
-            "transfer",
-            "channel-187",
-            "cosmos177x69sver58mcfs74x6dg0tv6ls4s3xmmcaw53",
+    }
+
+    #[test]
+    fn test_ack_success_to_vec() {
+        let ack_success: Vec<u8> = AcknowledgementStatus::success(ack_success_b64()).into();
+
+        // Check that it's the same output as ibc-go
+        // Note: this also implicitly checks that the ack bytes are non-empty,
+        // which would make the conversion to `Acknowledgement` panic
+        assert_eq!(ack_success, r#"{"result":"AQ=="}"#.as_bytes());
+    }
+
+    #[test]
+    fn test_ack_error_to_vec() {
+        let ack_error: Vec<u8> =
+            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into())
+                .into();
+
+        // Check that it's the same output as ibc-go
+        // Note: this also implicitly checks that the ack bytes are non-empty,
+        // which would make the conversion to `Acknowledgement` panic
+        assert_eq!(
+            ack_error,
+            r#"{"error":"failed to deserialize packet data"}"#.as_bytes()
         );
     }
+
+    #[test]
+    fn test_ack_de() {
+        fn de_json_assert_eq(json_str: &str, ack: AcknowledgementStatus) {
+            let de = serde_json::from_str::<AcknowledgementStatus>(json_str).unwrap();
+            assert_eq!(de, ack)
+        }
+
+        de_json_assert_eq(
+            r#"{"result":"AQ=="}"#,
+            AcknowledgementStatus::success(ack_success_b64()),
+        );
+        de_json_assert_eq(
+            r#"{"error":"failed to deserialize packet data"}"#,
+            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into()),
+        );
+
+        assert!(serde_json::from_str::<AcknowledgementStatus>(r#"{"success":"AQ=="}"#).is_err());
+    }
 }
diff --git a/ibc-apps/ics20-transfer/types/Cargo.toml b/ibc-apps/ics20-transfer/types/Cargo.toml
new file mode 100644
index 000000000..ad7af1ee6
--- /dev/null
+++ b/ibc-apps/ics20-transfer/types/Cargo.toml
@@ -0,0 +1,78 @@
+[package]
+name         = "ibc-app-transfer-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-20 Fungible Token Transfer data structures and 
+    domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
+    applicability to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+primitive-types = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+uint            = { version = "0.9", default-features = false }
+
+# ibc dependencies
+ibc-core  = { workspace = true }
+ibc-proto = { workspace = true }
+
+## parity dependencies
+parity-scale-codec = { workspace = true , optional = true }
+scale-info         = { workspace = true , optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+serde_json  = { workspace = true }
+rstest      = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "serde/std",
+    "serde_json/std",
+    "displaydoc/std",
+    "uint/std",
+    "primitive-types/std",
+    "ibc-core/std",
+    "ibc-proto/std",
+    "ibc-testkit/std",
+]
+serde = [
+    "dep:serde", 
+    "ibc-core/serde",
+    "ibc-proto/serde", 
+    "ibc-testkit/serde"
+]
+schema = [
+    "dep:schemars", 
+    "ibc-core/schema", 
+    "ibc-proto/json-schema", 
+    "serde", 
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core/borsh",
+    "ibc-proto/borsh"
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec", 
+    "dep:scale-info", 
+    "ibc-core/parity-scale-codec",
+    "ibc-proto/parity-scale-codec"
+]
diff --git a/crates/ibc/src/applications/transfer/amount.rs b/ibc-apps/ics20-transfer/types/src/amount.rs
similarity index 95%
rename from crates/ibc/src/applications/transfer/amount.rs
rename to ibc-apps/ics20-transfer/types/src/amount.rs
index b14a1797a..5c3802d2d 100644
--- a/crates/ibc/src/applications/transfer/amount.rs
+++ b/ibc-apps/ics20-transfer/types/src/amount.rs
@@ -1,17 +1,12 @@
 //! Contains the `Amount` type, which represents amounts of tokens transferred.
-
 use core::ops::Deref;
 use core::str::FromStr;
 
 use derive_more::{Display, From, Into};
+use ibc_core::primitives::prelude::*;
 use primitive_types::U256;
 
 use super::error::TokenTransferError;
-#[cfg(feature = "schema")]
-use crate::alloc::borrow::ToOwned;
-#[cfg(feature = "schema")]
-use crate::alloc::string::String;
-use crate::prelude::*;
 
 /// A type for representing token transfer amounts.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -19,7 +14,7 @@ use crate::prelude::*;
 #[derive(Copy, Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display, From, Into)]
 pub struct Amount(
     #[cfg_attr(feature = "schema", schemars(with = "String"))]
-    #[serde(serialize_with = "crate::serializers::serde_string::serialize")]
+    #[serde(serialize_with = "crate::serializers::serialize")]
     #[serde(deserialize_with = "deserialize")]
     U256,
 );
diff --git a/crates/ibc/src/applications/transfer/coin.rs b/ibc-apps/ics20-transfer/types/src/coin.rs
similarity index 99%
rename from crates/ibc/src/applications/transfer/coin.rs
rename to ibc-apps/ics20-transfer/types/src/coin.rs
index be7a41172..65a147218 100644
--- a/crates/ibc/src/applications/transfer/coin.rs
+++ b/ibc-apps/ics20-transfer/types/src/coin.rs
@@ -1,14 +1,13 @@
 //! Defines coin types; the objects that are being transferred.
-
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use ibc_core::primitives::prelude::*;
 use ibc_proto::cosmos::base::v1beta1::Coin as ProtoCoin;
 
 use super::amount::Amount;
 use super::denom::{BaseDenom, PrefixedDenom};
 use super::error::TokenTransferError;
-use crate::prelude::*;
 
 /// A `Coin` type with fully qualified `PrefixedDenom`.
 pub type PrefixedCoin = Coin<PrefixedDenom>;
diff --git a/crates/ibc/src/applications/transfer/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
similarity index 98%
rename from crates/ibc/src/applications/transfer/denom.rs
rename to ibc-apps/ics20-transfer/types/src/denom.rs
index 855b542ae..92f60c9d3 100644
--- a/crates/ibc/src/applications/transfer/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -1,16 +1,14 @@
 //! Defines types to represent "denominations" [as defined in ICS-20](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md#data-structures)
-
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use derive_more::{Display, From};
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
 use ibc_proto::ibc::applications::transfer::v1::DenomTrace as RawDenomTrace;
 
 use super::error::TokenTransferError;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::prelude::*;
-#[cfg(feature = "serde")]
-use crate::serializers::serde_string;
+use crate::serializers;
 
 /// The "base" of a denomination.
 ///
@@ -218,7 +216,7 @@ impl Display for TracePath {
 #[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord)]
 pub struct PrefixedDenom {
     /// A series of `{port-id}/{channel-id}`s for tracing the source of the token.
-    #[cfg_attr(feature = "serde", serde(with = "serde_string"))]
+    #[cfg_attr(feature = "serde", serde(with = "serializers"))]
     #[cfg_attr(feature = "schema", schemars(with = "String"))]
     pub trace_path: TracePath,
     /// Base denomination of the relayed fungible token.
diff --git a/crates/ibc/src/applications/transfer/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
similarity index 91%
rename from crates/ibc/src/applications/transfer/error.rs
rename to ibc-apps/ics20-transfer/types/src/error.rs
index d47decc33..8737ddf96 100644
--- a/crates/ibc/src/applications/transfer/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -1,17 +1,16 @@
 //! Defines the token transfer error type
-
 use core::convert::Infallible;
 use core::str::Utf8Error;
 
 use displaydoc::Display;
+use ibc_core::channel::types::acknowledgement::StatusValue;
+use ibc_core::channel::types::channel::Order;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::error::IdentifierError;
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
 use uint::FromDecStrErr;
 
-use crate::core::ics04_channel::acknowledgement::StatusValue;
-use crate::core::ics04_channel::channel::Order;
-use crate::core::ics24_host::identifier::{ChannelId, IdentifierError, PortId};
-use crate::core::ContextError;
-use crate::prelude::*;
-
 #[derive(Display, Debug)]
 pub enum TokenTransferError {
     /// context error: `{0}`
diff --git a/crates/ibc/src/applications/transfer/events.rs b/ibc-apps/ics20-transfer/types/src/events.rs
similarity index 83%
rename from crates/ibc/src/applications/transfer/events.rs
rename to ibc-apps/ics20-transfer/types/src/events.rs
index 45eff108a..565e14430 100644
--- a/crates/ibc/src/applications/transfer/events.rs
+++ b/ibc-apps/ics20-transfer/types/src/events.rs
@@ -1,11 +1,11 @@
 //! Defines all token transfer event types
+use ibc_core::channel::types::acknowledgement::AcknowledgementStatus;
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+use ibc_core::router::types::event::ModuleEvent;
 
 use super::Memo;
-use crate::applications::transfer::{Amount, PrefixedDenom, MODULE_ID_STR};
-use crate::core::events::ModuleEvent;
-use crate::core::ics04_channel::acknowledgement::AcknowledgementStatus;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::{Amount, PrefixedDenom, MODULE_ID_STR};
 
 const EVENT_TYPE_PACKET: &str = "fungible_token_packet";
 const EVENT_TYPE_TIMEOUT: &str = "timeout";
@@ -22,8 +22,8 @@ pub enum Event {
     Transfer(TransferEvent),
 }
 
-/// Event emitted in the [`onRecvPacket`][super::context::on_recv_packet_execute]
-/// module callback to indicate the that the `RecvPacket` message was processed
+/// Event emitted by the `onRecvPacket` module callback to indicate the that the
+/// `RecvPacket` message was processed
 pub struct RecvEvent {
     pub sender: Signer,
     pub receiver: Signer,
@@ -58,8 +58,7 @@ impl From<RecvEvent> for ModuleEvent {
     }
 }
 
-/// Event emitted in the [`onAcknowledgePacket`][super::context::on_acknowledgement_packet_execute]
-/// module callback
+/// Event emitted in the `onAcknowledgePacket` module callback
 pub struct AckEvent {
     pub sender: Signer,
     pub receiver: Signer,
@@ -94,8 +93,8 @@ impl From<AckEvent> for ModuleEvent {
     }
 }
 
-/// Event emitted in the [`onAcknowledgePacket`][super::context::on_acknowledgement_packet_execute]
-/// module callback to indicate whether the acknowledgement is a success or a failure
+/// Event emitted in the `onAcknowledgePacket` module callback to indicate
+/// whether the acknowledgement is a success or a failure
 pub struct AckStatusEvent {
     pub acknowledgement: AcknowledgementStatus,
 }
@@ -115,8 +114,7 @@ impl From<AckStatusEvent> for ModuleEvent {
     }
 }
 
-/// Event emitted in the [`onTimeoutPacket`][super::context::on_timeout_packet_execute]
-/// module callback
+/// Event emitted in the `onTimeoutPacket` module callback
 pub struct TimeoutEvent {
     pub refund_receiver: Signer,
     pub refund_denom: PrefixedDenom,
@@ -145,8 +143,7 @@ impl From<TimeoutEvent> for ModuleEvent {
     }
 }
 
-/// Event emitted in the [`onRecvPacket`][super::context::on_recv_packet_execute]
-/// module callback when new tokens are minted
+/// Event emitted in the `onRecvPacket` module callback when new tokens are minted
 pub struct DenomTraceEvent {
     pub trace_hash: Option<String>,
     pub denom: PrefixedDenom,
@@ -166,8 +163,7 @@ impl From<DenomTraceEvent> for ModuleEvent {
     }
 }
 
-/// Event emitted in [`sendTransfer`][super::send_transfer] after a successful
-/// transfer
+/// Event emitted after a successful `sendTransfer`
 pub struct TransferEvent {
     pub sender: Signer,
     pub receiver: Signer,
diff --git a/ibc-apps/ics20-transfer/types/src/lib.rs b/ibc-apps/ics20-transfer/types/src/lib.rs
new file mode 100644
index 000000000..2cc84f2fe
--- /dev/null
+++ b/ibc-apps/ics20-transfer/types/src/lib.rs
@@ -0,0 +1,69 @@
+//! Implementation of the IBC [fungible token transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md) (ICS-20) data structures.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+#[cfg(feature = "serde")]
+mod amount;
+#[cfg(feature = "serde")]
+pub use amount::*;
+#[cfg(feature = "serde")]
+mod coin;
+#[cfg(feature = "serde")]
+pub use coin::*;
+#[cfg(feature = "serde")]
+mod denom;
+#[cfg(feature = "serde")]
+pub use denom::*;
+#[cfg(feature = "serde")]
+pub mod events;
+#[cfg(feature = "serde")]
+pub mod msgs;
+#[cfg(feature = "serde")]
+pub mod packet;
+
+#[cfg(feature = "serde")]
+pub(crate) mod serializers;
+
+pub mod error;
+mod memo;
+pub use memo::*;
+
+/// Re-exports ICS-20 token transfer proto types from the `ibc-proto` crate
+/// for added convenience
+pub mod proto {
+    pub use ibc_proto::ibc::apps::transfer;
+}
+
+/// Module identifier for the ICS20 application.
+pub const MODULE_ID_STR: &str = "transfer";
+
+/// The port identifier that the ICS20 applications
+/// typically bind with.
+pub const PORT_ID_STR: &str = "transfer";
+
+/// ICS20 application current version.
+pub const VERSION: &str = "ics20-1";
+
+/// The successful string used for creating an acknowledgement status,
+/// equivalent to `base64::encode(0x01)`.
+pub const ACK_SUCCESS_B64: &str = "AQ==";
+
+use ibc_core::channel::types::acknowledgement::StatusValue;
+
+/// Returns a successful acknowledgement status for the token transfer application.
+pub fn ack_success_b64() -> StatusValue {
+    StatusValue::new(ACK_SUCCESS_B64).expect("ack status value is never supposed to be empty")
+}
diff --git a/crates/ibc/src/applications/transfer/memo.rs b/ibc-apps/ics20-transfer/types/src/memo.rs
similarity index 96%
rename from crates/ibc/src/applications/transfer/memo.rs
rename to ibc-apps/ics20-transfer/types/src/memo.rs
index 3d31f206e..9a3caea74 100644
--- a/crates/ibc/src/applications/transfer/memo.rs
+++ b/ibc-apps/ics20-transfer/types/src/memo.rs
@@ -7,7 +7,7 @@ use core::fmt::{
 };
 use core::str::FromStr;
 
-use crate::prelude::*;
+use ibc_core::primitives::prelude::*;
 
 /// Represents the token transfer memo
 #[cfg_attr(
diff --git a/crates/ibc/src/applications/transfer/msgs.rs b/ibc-apps/ics20-transfer/types/src/msgs/mod.rs
similarity index 98%
rename from crates/ibc/src/applications/transfer/msgs.rs
rename to ibc-apps/ics20-transfer/types/src/msgs/mod.rs
index c019a3120..9c6780741 100644
--- a/crates/ibc/src/applications/transfer/msgs.rs
+++ b/ibc-apps/ics20-transfer/types/src/msgs/mod.rs
@@ -1,3 +1,2 @@
 //! Defines the token transfer message type
-
 pub mod transfer;
diff --git a/crates/ibc/src/applications/transfer/msgs/transfer.rs b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
similarity index 91%
rename from crates/ibc/src/applications/transfer/msgs/transfer.rs
rename to ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
index 5ea2d66d7..b892f9f40 100644
--- a/crates/ibc/src/applications/transfer/msgs/transfer.rs
+++ b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
@@ -1,17 +1,17 @@
 //! Defines the token transfer message type
 
+use ibc_core::channel::types::error::PacketError;
+use ibc_core::channel::types::timeout::TimeoutHeight;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::{Msg, Timestamp};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::applications::transfer::v1::MsgTransfer as RawMsgTransfer;
 use ibc_proto::Protobuf;
 
-use crate::applications::transfer::error::TokenTransferError;
-use crate::applications::transfer::packet::PacketData;
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::timeout::TimeoutHeight;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::timestamp::Timestamp;
-use crate::core::{ContextError, Msg};
-use crate::prelude::*;
+use crate::error::TokenTransferError;
+use crate::packet::PacketData;
 
 pub(crate) const TYPE_URL: &str = "/ibc.applications.transfer.v1.MsgTransfer";
 
diff --git a/crates/ibc/src/applications/transfer/packet.rs b/ibc-apps/ics20-transfer/types/src/packet.rs
similarity index 95%
rename from crates/ibc/src/applications/transfer/packet.rs
rename to ibc-apps/ics20-transfer/types/src/packet.rs
index 63058b2ed..d9d1ace76 100644
--- a/crates/ibc/src/applications/transfer/packet.rs
+++ b/ibc-apps/ics20-transfer/types/src/packet.rs
@@ -1,16 +1,14 @@
 //! Contains the `PacketData` type that defines the structure of token transfers' packet bytes
 
-use alloc::string::ToString;
 use core::convert::TryFrom;
 use core::str::FromStr;
 
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
 use ibc_proto::ibc::applications::transfer::v2::FungibleTokenPacketData as RawPacketData;
 
 use super::error::TokenTransferError;
 use super::{Amount, Memo, PrefixedCoin, PrefixedDenom};
-#[cfg(feature = "schema")]
-use crate::alloc::borrow::ToOwned;
-use crate::signer::Signer;
 
 /// Defines the structure of token transfers' packet bytes
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -69,7 +67,7 @@ mod tests {
     use primitive_types::U256;
 
     use super::*;
-    use crate::applications::transfer::BaseCoin;
+    use crate::BaseCoin;
 
     impl PacketData {
         pub fn new_dummy() -> Self {
diff --git a/ibc-apps/ics20-transfer/types/src/serializers.rs b/ibc-apps/ics20-transfer/types/src/serializers.rs
new file mode 100644
index 000000000..65c4d2ba6
--- /dev/null
+++ b/ibc-apps/ics20-transfer/types/src/serializers.rs
@@ -0,0 +1,27 @@
+use core::fmt::Display;
+use core::str::FromStr;
+
+use ibc_core::primitives::prelude::*;
+use serde::{de, Deserialize, Deserializer, Serializer};
+
+// Note: This method serializes to a String instead of a str
+// in order to avoid a wasm compilation issue. Specifically,
+// str (de)serialization hits some kind of f64/f32 case
+// when compiled into wasm, but this fails validation on
+// f32/f64 wasm runtimes.
+pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
+where
+    T: Display,
+    S: Serializer,
+{
+    serializer.serialize_str(value.to_string().as_ref())
+}
+
+pub fn deserialize<'de, T, D>(deserializer: D) -> Result<T, D::Error>
+where
+    T: FromStr,
+    T::Err: Display,
+    D: Deserializer<'de>,
+{
+    T::from_str(<String>::deserialize(deserializer)?.as_str()).map_err(de::Error::custom)
+}
diff --git a/ibc-apps/src/lib.rs b/ibc-apps/src/lib.rs
new file mode 100644
index 000000000..246713011
--- /dev/null
+++ b/ibc-apps/src/lib.rs
@@ -0,0 +1,20 @@
+//! Re-exports implementations and data structures of different IBC applications.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+/// Re-exports the implementation of the IBC [fungible token
+/// transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md)
+/// (ICS-20) application logic.
+pub mod transfer {
+    #[doc(inline)]
+    pub use ibc_app_transfer::*;
+}
diff --git a/ibc-clients/Cargo.toml b/ibc-clients/Cargo.toml
new file mode 100644
index 000000000..65da32f6e
--- /dev/null
+++ b/ibc-clients/Cargo.toml
@@ -0,0 +1,40 @@
+[package]
+name         = "ibc-clients"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "applications", "tendermint"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement 
+    various IBC light clients, enabling smooth integration with IBC-enabled blockchains.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+ibc-client-tendermint = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-client-tendermint/std",
+]
+serde = [
+    "ibc-client-tendermint/serde",
+]
+schema = [
+    "ibc-client-tendermint/schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "ibc-client-tendermint/borsh",
+]
+parity-scale-codec = [
+    "ibc-client-tendermint/parity-scale-codec",
+]
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
new file mode 100644
index 000000000..6aa0466cf
--- /dev/null
+++ b/ibc-clients/README.md
@@ -0,0 +1,46 @@
+# IBC Clients
+
+This top-level crate re-exports Inter-Blockchain Communication (IBC)
+implementations of light clients. It serves as a meta-crate, simplifying the
+process of importing and integrating various IBC clients into your blockchain.
+IBC is a distributed protocol that enables communication between distinct
+sovereign blockchains and IBC light clients track the consensus states and proof
+specs of external blockchains, which are required to properly verify proofs
+against the client's consensus state.
+
+The structure within the `ibc-clients` crate is designed to provide flexibility
+for external users. It allows you to utilize the own `ibc-clients` crate or
+selectively import specific libraries, whether you need a certain IBC client
+implementation (e.g. `ibc-client-tendermint` crate) or only its associated data
+structures (e.g. `ibc-core-tendermint-types`). This versatility empowers hosts,
+including chain integrators, relayers, or any IBC tooling projects, to build
+their solutions on top of the layers that best suit their requirements.
+
+## Sub-Crates
+
+Currently, the `ibc-clients` crate contains the implementation of the following
+IBC light clients:
+
+### ICS-07: Tendermint Light Client
+
+- [ibc-client-tendermint](../ibc-client-tendermint)
+- [ibc-client-tendermint-types](../ibc-client-tendermint-types)
+
+## Third-party Clients
+
+Here, we list IBC third-party clients that are compatible with `ibc-rs`. You
+should always audit the implementation of any third-party crate. If you have a
+client that you'd like to be added to this list, please open a PR!
+
+- [ICS 6: Solomachine](https://github.com/octopus-network/ics06-solomachine) by
+  Octopus Network
+
+## Contributing
+
+IBC is specified in English in the [cosmos/ibc
+repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
+should be contributed there.
+
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./../../CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
new file mode 100644
index 000000000..f59ee647b
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -0,0 +1,79 @@
+[package]
+name         = "ibc-client-tendermint"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+readme       = "./../README.md"
+keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of the ICS-07 Tendermint Client logic 
+    and re-exports essential data structures and domain types from `ibc-client-tendermint-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+prost = { workspace = true }
+serde = { workspace = true, optional = true }
+
+# ibc dependencies
+ibc-client-tendermint-types      = { workspace = true }
+ibc-core-client                  = { workspace = true }
+ibc-core-commitment-types        = { workspace = true }
+ibc-core-host                    = { workspace = true }
+ibc-core-handler-types           = { workspace = true }
+ibc-primitives                   = { workspace = true }
+
+# cosmos dependencies
+tendermint                       = { workspace = true }
+tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
+
+[features]
+default = ["std"]
+std = [
+    "prost/std",
+    "ibc-client-tendermint-types/std",
+    "ibc-core-client/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-client-tendermint-types/serde",
+    "ibc-core-client/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "ibc-client-tendermint-types/schema",
+    "ibc-core-client/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
+]
+borsh = [
+    "ibc-client-tendermint-types/borsh",
+    "ibc-core-client/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "ibc-client-tendermint-types/parity-scale-codec",
+    "ibc-core-client/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
new file mode 100644
index 000000000..6f6dfdcb5
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -0,0 +1,584 @@
+//! This module includes trait implementations for the
+//! `ibc_client_tendermint_types::ClientState` type. Implemented traits include
+//! `ClientStateCommon`, `ClientStateValidation`, and `ClientStateExecution`.
+//!
+//! Note that this crate defines a newtype wrapper around the
+//! `ibc_client_tendermint_types::ClientState` type in order to enable
+//! implementing a foreign trait on a foreign type (i.e. the orphan rule in
+//! Rust). As such, this module also includes some trait implementations that
+//! serve to pass through traits implemented on the wrapped `ClientState` type.
+
+use ibc_client_tendermint_types::error::Error;
+use ibc_client_tendermint_types::proto::v1::ClientState as RawTmClientState;
+use ibc_client_tendermint_types::proto::{Any, Protobuf};
+use ibc_client_tendermint_types::{
+    client_type as tm_client_type, ClientState as ClientStateType,
+    ConsensusState as ConsensusStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
+};
+use ibc_core_client::context::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation,
+};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client::types::error::{ClientError, UpgradeClientError};
+use ibc_core_client::types::{Height, Status, UpdateKind};
+use ibc_core_commitment_types::commitment::{
+    CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
+};
+use ibc_core_commitment_types::merkle::{apply_prefix, MerkleProof};
+use ibc_core_commitment_types::proto::v1::MerkleProof as RawMerkleProof;
+use ibc_core_host::types::identifiers::{ClientId, ClientType};
+use ibc_core_host::types::path::{
+    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
+};
+use ibc_core_host::ExecutionContext;
+use ibc_primitives::prelude::*;
+use prost::Message;
+
+use super::consensus_state::ConsensusState as TmConsensusState;
+use crate::context::{
+    CommonContext, ExecutionContext as TmExecutionContext, ValidationContext as TmValidationContext,
+};
+
+mod misbehaviour;
+mod update_client;
+
+/// Newtype wrapper around the `ClientState` type imported from the
+/// `ibc-client-tendermint-types` crate. This wrapper exists so that we can
+/// bypass Rust's orphan rules and implement traits from
+/// `ibc::core::client::context` on the `ClientState` type.
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq)]
+pub struct ClientState(ClientStateType);
+
+impl ClientState {
+    pub fn inner(&self) -> &ClientStateType {
+        &self.0
+    }
+}
+
+impl From<ClientStateType> for ClientState {
+    fn from(client_state: ClientStateType) -> Self {
+        Self(client_state)
+    }
+}
+
+impl Protobuf<RawTmClientState> for ClientState {}
+
+impl TryFrom<RawTmClientState> for ClientState {
+    type Error = Error;
+
+    fn try_from(raw: RawTmClientState) -> Result<Self, Self::Error> {
+        Ok(Self(ClientStateType::try_from(raw)?))
+    }
+}
+
+impl From<ClientState> for RawTmClientState {
+    fn from(client_state: ClientState) -> Self {
+        client_state.0.into()
+    }
+}
+
+impl Protobuf<Any> for ClientState {}
+
+impl TryFrom<Any> for ClientState {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        Ok(Self(ClientStateType::try_from(raw)?))
+    }
+}
+
+impl From<ClientState> for Any {
+    fn from(client_state: ClientState) -> Self {
+        client_state.0.into()
+    }
+}
+
+impl ClientStateCommon for ClientState {
+    fn verify_consensus_state(&self, consensus_state: Any) -> Result<(), ClientError> {
+        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
+        if tm_consensus_state.root().is_empty() {
+            return Err(ClientError::Other {
+                description: "empty commitment root".into(),
+            });
+        };
+
+        Ok(())
+    }
+
+    fn client_type(&self) -> ClientType {
+        tm_client_type()
+    }
+
+    fn latest_height(&self) -> Height {
+        self.0.latest_height
+    }
+
+    fn validate_proof_height(&self, proof_height: Height) -> Result<(), ClientError> {
+        if self.latest_height() < proof_height {
+            return Err(ClientError::InvalidProofHeight {
+                latest_height: self.latest_height(),
+                proof_height,
+            });
+        }
+        Ok(())
+    }
+
+    /// Perform client-specific verifications and check all data in the new
+    /// client state to be the same across all valid Tendermint clients for the
+    /// new chain.
+    ///
+    /// You can learn more about how to upgrade IBC-connected SDK chains in
+    /// [this](https://ibc.cosmos.network/main/ibc/upgrades/quick-guide.html)
+    /// guide
+    fn verify_upgrade_client(
+        &self,
+        upgraded_client_state: Any,
+        upgraded_consensus_state: Any,
+        proof_upgrade_client: CommitmentProofBytes,
+        proof_upgrade_consensus_state: CommitmentProofBytes,
+        root: &CommitmentRoot,
+    ) -> Result<(), ClientError> {
+        // Make sure that the client type is of Tendermint type `ClientState`
+        let upgraded_tm_client_state = Self::try_from(upgraded_client_state.clone())?;
+
+        // Make sure that the consensus type is of Tendermint type `ConsensusState`
+        TmConsensusState::try_from(upgraded_consensus_state.clone())?;
+
+        // Make sure the latest height of the current client is not greater then
+        // the upgrade height This condition checks both the revision number and
+        // the height
+        if self.latest_height() >= upgraded_tm_client_state.0.latest_height {
+            return Err(UpgradeClientError::LowUpgradeHeight {
+                upgraded_height: self.latest_height(),
+                client_height: upgraded_tm_client_state.0.latest_height,
+            })?;
+        }
+
+        // Check to see if the upgrade path is set
+        let mut upgrade_path = self.0.upgrade_path.clone();
+        if upgrade_path.pop().is_none() {
+            return Err(ClientError::ClientSpecific {
+                description: "cannot upgrade client as no upgrade path has been set".to_string(),
+            });
+        };
+
+        let upgrade_path_prefix = CommitmentPrefix::try_from(upgrade_path[0].clone().into_bytes())
+            .map_err(ClientError::InvalidCommitmentProof)?;
+
+        let last_height = self.latest_height().revision_height();
+
+        let mut client_state_value = Vec::new();
+        upgraded_client_state
+            .encode(&mut client_state_value)
+            .map_err(ClientError::Encode)?;
+
+        // Verify the proof of the upgraded client state
+        self.verify_membership(
+            &upgrade_path_prefix,
+            &proof_upgrade_client,
+            root,
+            Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(last_height)),
+            client_state_value,
+        )?;
+
+        let mut cons_state_value = Vec::new();
+        upgraded_consensus_state
+            .encode(&mut cons_state_value)
+            .map_err(ClientError::Encode)?;
+
+        // Verify the proof of the upgraded consensus state
+        self.verify_membership(
+            &upgrade_path_prefix,
+            &proof_upgrade_consensus_state,
+            root,
+            Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(last_height)),
+            cons_state_value,
+        )?;
+
+        Ok(())
+    }
+
+    fn verify_membership(
+        &self,
+        prefix: &CommitmentPrefix,
+        proof: &CommitmentProofBytes,
+        root: &CommitmentRoot,
+        path: Path,
+        value: Vec<u8>,
+    ) -> Result<(), ClientError> {
+        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
+        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
+            .map_err(ClientError::InvalidCommitmentProof)?
+            .into();
+
+        merkle_proof
+            .verify_membership(
+                &self.0.proof_specs,
+                root.clone().into(),
+                merkle_path,
+                value,
+                0,
+            )
+            .map_err(ClientError::Ics23Verification)
+    }
+
+    fn verify_non_membership(
+        &self,
+        prefix: &CommitmentPrefix,
+        proof: &CommitmentProofBytes,
+        root: &CommitmentRoot,
+        path: Path,
+    ) -> Result<(), ClientError> {
+        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
+        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
+            .map_err(ClientError::InvalidCommitmentProof)?
+            .into();
+
+        merkle_proof
+            .verify_non_membership(&self.0.proof_specs, root.clone().into(), merkle_path)
+            .map_err(ClientError::Ics23Verification)
+    }
+}
+
+impl<V> ClientStateValidation<V> for ClientState
+where
+    V: ClientValidationContext + TmValidationContext,
+    V::AnyConsensusState: TryInto<TmConsensusState>,
+    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
+{
+    fn verify_client_message(
+        &self,
+        ctx: &V,
+        client_id: &ClientId,
+        client_message: Any,
+        update_kind: &UpdateKind,
+    ) -> Result<(), ClientError> {
+        match update_kind {
+            UpdateKind::UpdateClient => {
+                let header = TmHeader::try_from(client_message)?;
+                self.verify_header(ctx, client_id, header)
+            }
+            UpdateKind::SubmitMisbehaviour => {
+                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
+                self.verify_misbehaviour(ctx, client_id, misbehaviour)
+            }
+        }
+    }
+
+    fn check_for_misbehaviour(
+        &self,
+        ctx: &V,
+        client_id: &ClientId,
+        client_message: Any,
+        update_kind: &UpdateKind,
+    ) -> Result<bool, ClientError> {
+        match update_kind {
+            UpdateKind::UpdateClient => {
+                let header = TmHeader::try_from(client_message)?;
+                self.check_for_misbehaviour_update_client(ctx, client_id, header)
+            }
+            UpdateKind::SubmitMisbehaviour => {
+                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
+                self.check_for_misbehaviour_misbehavior(&misbehaviour)
+            }
+        }
+    }
+
+    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
+        if self.0.is_frozen() {
+            return Ok(Status::Frozen);
+        }
+
+        let latest_consensus_state: TmConsensusState = {
+            let any_latest_consensus_state =
+                match ctx.consensus_state(&ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    self.0.latest_height.revision_number(),
+                    self.0.latest_height.revision_height(),
+                )) {
+                    Ok(cs) => cs,
+                    // if the client state does not have an associated consensus state for its latest height
+                    // then it must be expired
+                    Err(_) => return Ok(Status::Expired),
+                };
+
+            any_latest_consensus_state.try_into()?
+        };
+
+        // Note: if the `duration_since()` is `None`, indicating that the latest
+        // consensus state is in the future, then we don't consider the client
+        // to be expired.
+        let now = ctx.host_timestamp()?;
+        if let Some(elapsed_since_latest_consensus_state) =
+            now.duration_since(&latest_consensus_state.timestamp().into())
+        {
+            if elapsed_since_latest_consensus_state > self.0.trusting_period {
+                return Ok(Status::Expired);
+            }
+        }
+
+        Ok(Status::Active)
+    }
+}
+
+impl<E> ClientStateExecution<E> for ClientState
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientState>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<TmConsensusState>,
+{
+    fn initialise(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        consensus_state: Any,
+    ) -> Result<(), ClientError> {
+        let host_timestamp = CommonContext::host_timestamp(ctx)?;
+        let host_height = CommonContext::host_height(ctx)?;
+
+        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
+
+        ctx.store_client_state(ClientStatePath::new(client_id), self.clone().into())?;
+        ctx.store_consensus_state(
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                self.0.latest_height.revision_number(),
+                self.0.latest_height.revision_height(),
+            ),
+            tm_consensus_state.into(),
+        )?;
+        ctx.store_update_time(client_id.clone(), self.latest_height(), host_timestamp)?;
+        ctx.store_update_height(client_id.clone(), self.latest_height(), host_height)?;
+
+        Ok(())
+    }
+
+    fn update_state(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        header: Any,
+    ) -> Result<Vec<Height>, ClientError> {
+        let header = TmHeader::try_from(header)?;
+        let header_height = header.height();
+
+        self.prune_oldest_consensus_state(ctx, client_id)?;
+
+        let maybe_existing_consensus_state = {
+            let path_at_header_height = ClientConsensusStatePath::new(
+                client_id.clone(),
+                header_height.revision_number(),
+                header_height.revision_height(),
+            );
+
+            CommonContext::consensus_state(ctx, &path_at_header_height).ok()
+        };
+
+        if maybe_existing_consensus_state.is_some() {
+            // if we already had the header installed by a previous relayer
+            // then this is a no-op.
+            //
+            // Do nothing.
+        } else {
+            let host_timestamp = CommonContext::host_timestamp(ctx)?;
+            let host_height = CommonContext::host_height(ctx)?;
+
+            let new_consensus_state = ConsensusStateType::from(header.clone());
+            let new_client_state = self.0.clone().with_header(header)?;
+
+            ctx.store_consensus_state(
+                ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    new_client_state.latest_height.revision_number(),
+                    new_client_state.latest_height.revision_height(),
+                ),
+                TmConsensusState::from(new_consensus_state).into(),
+            )?;
+            ctx.store_client_state(
+                ClientStatePath::new(client_id),
+                ClientState::from(new_client_state).into(),
+            )?;
+            ctx.store_update_time(client_id.clone(), header_height, host_timestamp)?;
+            ctx.store_update_height(client_id.clone(), header_height, host_height)?;
+        }
+
+        Ok(vec![header_height])
+    }
+
+    fn update_state_on_misbehaviour(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        _client_message: Any,
+        _update_kind: &UpdateKind,
+    ) -> Result<(), ClientError> {
+        let frozen_client_state = self.0.clone().with_frozen_height(Height::min(0));
+
+        let wrapped_frozen_client_state = ClientState::from(frozen_client_state);
+
+        ctx.store_client_state(
+            ClientStatePath::new(client_id),
+            wrapped_frozen_client_state.into(),
+        )?;
+
+        Ok(())
+    }
+
+    // Commit the new client state and consensus state to the store
+    fn update_state_on_upgrade(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        upgraded_client_state: Any,
+        upgraded_consensus_state: Any,
+    ) -> Result<Height, ClientError> {
+        let mut upgraded_tm_client_state = Self::try_from(upgraded_client_state)?;
+        let upgraded_tm_cons_state = TmConsensusState::try_from(upgraded_consensus_state)?;
+
+        upgraded_tm_client_state.0.zero_custom_fields();
+
+        // Construct new client state and consensus state relayer chosen client
+        // parameters are ignored. All chain-chosen parameters come from
+        // committed client, all client-chosen parameters come from current
+        // client.
+        let new_client_state = ClientStateType::new(
+            upgraded_tm_client_state.0.chain_id,
+            self.0.trust_level,
+            self.0.trusting_period,
+            upgraded_tm_client_state.0.unbonding_period,
+            self.0.max_clock_drift,
+            upgraded_tm_client_state.0.latest_height,
+            upgraded_tm_client_state.0.proof_specs,
+            upgraded_tm_client_state.0.upgrade_path,
+            self.0.allow_update,
+        )?;
+
+        // The new consensus state is merely used as a trusted kernel against
+        // which headers on the new chain can be verified. The root is just a
+        // stand-in sentinel value as it cannot be known in advance, thus no
+        // proof verification will pass. The timestamp and the
+        // NextValidatorsHash of the consensus state is the blocktime and
+        // NextValidatorsHash of the last block committed by the old chain. This
+        // will allow the first block of the new chain to be verified against
+        // the last validators of the old chain so long as it is submitted
+        // within the TrustingPeriod of this client.
+        // NOTE: We do not set processed time for this consensus state since
+        // this consensus state should not be used for packet verification as
+        // the root is empty. The next consensus state submitted using update
+        // will be usable for packet-verification.
+        let sentinel_root = "sentinel_root".as_bytes().to_vec();
+        let new_consensus_state = ConsensusStateType::new(
+            sentinel_root.into(),
+            upgraded_tm_cons_state.timestamp(),
+            upgraded_tm_cons_state.next_validators_hash(),
+        );
+
+        let latest_height = new_client_state.latest_height;
+        let host_timestamp = CommonContext::host_timestamp(ctx)?;
+        let host_height = CommonContext::host_height(ctx)?;
+
+        ctx.store_client_state(
+            ClientStatePath::new(client_id),
+            ClientState::from(new_client_state).into(),
+        )?;
+        ctx.store_consensus_state(
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                latest_height.revision_number(),
+                latest_height.revision_height(),
+            ),
+            TmConsensusState::from(new_consensus_state).into(),
+        )?;
+        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
+        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
+
+        Ok(latest_height)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use core::time::Duration;
+
+    use ibc_client_tendermint_types::{
+        AllowUpdate, ClientState as ClientStateType, ClientStateParams, TrustThreshold,
+    };
+    use ibc_core_client::types::Height;
+    use ibc_core_commitment_types::specs::ProofSpecs;
+    use ibc_core_host::types::identifiers::ChainId;
+
+    use super::*;
+
+    #[test]
+    fn client_state_verify_height() {
+        // Define a "default" set of parameters to reuse throughout these tests.
+        let default_params: ClientStateParams = ClientStateParams {
+            id: ChainId::new("ibc-1").unwrap(),
+            trust_level: TrustThreshold::ONE_THIRD,
+            trusting_period: Duration::new(64000, 0),
+            unbonding_period: Duration::new(128000, 0),
+            max_clock_drift: Duration::new(3, 0),
+            latest_height: Height::new(1, 10).expect("Never fails"),
+            proof_specs: ProofSpecs::default(),
+            upgrade_path: Default::default(),
+            allow_update: AllowUpdate {
+                after_expiry: false,
+                after_misbehaviour: false,
+            },
+        };
+
+        struct Test {
+            name: String,
+            height: Height,
+            setup: Option<Box<dyn FnOnce(ClientState) -> ClientState>>,
+            want_pass: bool,
+        }
+
+        let tests = vec![
+            Test {
+                name: "Successful height verification".to_string(),
+                height: Height::new(1, 8).expect("Never fails"),
+                setup: None,
+                want_pass: true,
+            },
+            Test {
+                name: "Invalid (too large)  client height".to_string(),
+                height: Height::new(1, 12).expect("Never fails"),
+                setup: None,
+                want_pass: false,
+            },
+        ];
+
+        for test in tests {
+            let p = default_params.clone();
+            let client_state = ClientStateType::new(
+                p.id,
+                p.trust_level,
+                p.trusting_period,
+                p.unbonding_period,
+                p.max_clock_drift,
+                p.latest_height,
+                p.proof_specs,
+                p.upgrade_path,
+                p.allow_update,
+            )
+            .expect("Never fails");
+            let client_state = match test.setup {
+                Some(setup) => (setup)(ClientState(client_state)),
+                _ => ClientState(client_state),
+            };
+            let res = client_state.validate_proof_height(test.height);
+
+            assert_eq!(
+                test.want_pass,
+                res.is_ok(),
+                "ClientState::validate_proof_height() failed for test {}, \nmsg{:?} with error {:?}",
+                test.name,
+                test.height,
+                res.err(),
+            );
+        }
+    }
+}
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
similarity index 71%
rename from crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs
rename to ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 9e3c3141a..c671ffa63 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -1,19 +1,16 @@
+use ibc_client_tendermint_types::error::{Error, IntoResult};
+use ibc_client_tendermint_types::{Header as TmHeader, Misbehaviour as TmMisbehaviour};
+use ibc_core_client::types::error::ClientError;
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::ClientConsensusStatePath;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 use tendermint_light_client_verifier::Verifier;
 
-use super::{check_header_trusted_next_validator_set, ClientState};
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::error::{Error, IntoResult};
-use crate::clients::ics07_tendermint::header::Header as TmHeader;
-use crate::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
-use crate::clients::ics07_tendermint::ValidationContext as TmValidationContext;
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
-
-impl ClientState {
+use super::{ClientState as TmClientState, TmValidationContext};
+use crate::consensus_state::ConsensusState as TmConsensusState;
+
+impl TmClientState {
     // verify_misbehaviour determines whether or not two conflicting headers at
     // the same height would have convinced the light client.
     pub fn verify_misbehaviour<ClientValidationContext>(
@@ -29,8 +26,11 @@ impl ClientState {
 
         let header_1 = misbehaviour.header1();
         let trusted_consensus_state_1 = {
-            let consensus_state_path =
-                ClientConsensusStatePath::new(client_id, &header_1.trusted_height);
+            let consensus_state_path = ClientConsensusStatePath::new(
+                client_id.clone(),
+                header_1.trusted_height.revision_number(),
+                header_1.trusted_height.revision_height(),
+            );
             let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
             consensus_state
@@ -42,8 +42,11 @@ impl ClientState {
 
         let header_2 = misbehaviour.header2();
         let trusted_consensus_state_2 = {
-            let consensus_state_path =
-                ClientConsensusStatePath::new(client_id, &header_2.trusted_height);
+            let consensus_state_path = ClientConsensusStatePath::new(
+                client_id.clone(),
+                header_2.trusted_height.revision_number(),
+                header_2.trusted_height.revision_height(),
+            );
             let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
             consensus_state
@@ -65,21 +68,21 @@ impl ClientState {
         current_timestamp: Timestamp,
     ) -> Result<(), ClientError> {
         // ensure correctness of the trusted next validator set provided by the relayer
-        check_header_trusted_next_validator_set(header, trusted_consensus_state)?;
+        header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
 
         // ensure trusted consensus state is within trusting period
         {
             let duration_since_consensus_state = current_timestamp
-                .duration_since(&trusted_consensus_state.timestamp())
+                .duration_since(&(trusted_consensus_state.timestamp().into()))
                 .ok_or_else(|| ClientError::InvalidConsensusStateTimestamp {
-                    time1: trusted_consensus_state.timestamp(),
+                    time1: trusted_consensus_state.timestamp().into(),
                     time2: current_timestamp,
                 })?;
 
-            if duration_since_consensus_state >= self.trusting_period {
+            if duration_since_consensus_state >= self.0.trusting_period {
                 return Err(Error::ConsensusStateTimestampGteTrustingPeriod {
                     duration_since_consensus_state,
-                    trusting_period: self.trusting_period,
+                    trusting_period: self.0.trusting_period,
                 }
                 .into());
             }
@@ -89,20 +92,23 @@ impl ClientState {
         let untrusted_state = header.as_untrusted_block_state();
 
         let chain_id = self
+            .0
             .chain_id
             .to_string()
             .try_into()
             .map_err(|e| ClientError::Other {
                 description: format!("failed to parse chain id: {}", e),
             })?;
-        let trusted_state = header.as_trusted_block_state(trusted_consensus_state, &chain_id)?;
+        let trusted_state =
+            header.as_trusted_block_state(trusted_consensus_state.inner(), &chain_id)?;
 
-        let options = self.as_light_client_options()?;
+        let options = self.0.as_light_client_options()?;
         let current_timestamp = current_timestamp.into_tm_time().ok_or(ClientError::Other {
             description: "host timestamp must not be zero".to_string(),
         })?;
 
-        self.verifier
+        self.0
+            .verifier
             .verify_misbehaviour_header(untrusted_state, trusted_state, &options, current_timestamp)
             .into_result()?;
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
similarity index 74%
rename from crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
rename to ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index a2fabec1a..89a88d520 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -1,17 +1,16 @@
+use ibc_client_tendermint_types::error::{Error, IntoResult};
+use ibc_client_tendermint_types::{ConsensusState as ConsensusStateType, Header as TmHeader};
+use ibc_core_client::context::ClientExecutionContext;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::ClientConsensusStatePath;
+use ibc_primitives::prelude::*;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
-use super::{check_header_trusted_next_validator_set, ClientState};
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::error::{Error, IntoResult};
-use crate::clients::ics07_tendermint::header::Header as TmHeader;
-use crate::clients::ics07_tendermint::{CommonContext, ValidationContext as TmValidationContext};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::ClientExecutionContext;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::prelude::*;
+use super::ClientState;
+use crate::consensus_state::ConsensusState as TmConsensusState;
+use crate::context::{CommonContext, ValidationContext as TmValidationContext};
 
 impl ClientState {
     pub fn verify_header<ClientValidationContext>(
@@ -28,15 +27,18 @@ impl ClientState {
 
         // The tendermint-light-client crate though works on heights that are assumed
         // to have the same revision number. We ensure this here.
-        header.verify_chain_id_version_matches_height(&self.chain_id())?;
+        header.verify_chain_id_version_matches_height(&self.0.chain_id())?;
 
         // Delegate to tendermint-light-client, which contains the required checks
         // of the new header against the trusted consensus state.
         {
             let trusted_state =
                 {
-                    let trusted_client_cons_state_path =
-                        ClientConsensusStatePath::new(client_id, &header.trusted_height);
+                    let trusted_client_cons_state_path = ClientConsensusStatePath::new(
+                        client_id.clone(),
+                        header.trusted_height.revision_number(),
+                        header.trusted_height.revision_height(),
+                    );
                     let trusted_consensus_state: TmConsensusState = ctx
                         .consensus_state(&trusted_client_cons_state_path)?
                         .try_into()
@@ -44,15 +46,15 @@ impl ClientState {
                             description: err.to_string(),
                         })?;
 
-                    check_header_trusted_next_validator_set(&header, &trusted_consensus_state)?;
+                    header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
 
                     TrustedBlockState {
-                        chain_id: &self.chain_id.to_string().try_into().map_err(|e| {
+                        chain_id: &self.0.chain_id.to_string().try_into().map_err(|e| {
                             ClientError::Other {
                                 description: format!("failed to parse chain id: {}", e),
                             }
                         })?,
-                        header_time: trusted_consensus_state.timestamp,
+                        header_time: trusted_consensus_state.timestamp(),
                         height: header.trusted_height.revision_height().try_into().map_err(
                             |_| ClientError::ClientSpecific {
                                 description: Error::InvalidHeaderHeight {
@@ -62,7 +64,7 @@ impl ClientState {
                             },
                         )?,
                         next_validators: &header.trusted_next_validator_set,
-                        next_validators_hash: trusted_consensus_state.next_validators_hash,
+                        next_validators_hash: trusted_consensus_state.next_validators_hash(),
                     }
                 };
 
@@ -75,7 +77,7 @@ impl ClientState {
                 next_validators: None,
             };
 
-            let options = self.as_light_client_options()?;
+            let options = self.0.as_light_client_options()?;
             let now = ctx.host_timestamp()?.into_tm_time().ok_or_else(|| {
                 ClientError::ClientSpecific {
                     description: "host timestamp is not a valid TM timestamp".to_string(),
@@ -83,7 +85,8 @@ impl ClientState {
             })?;
 
             // main header verification, delegated to the tendermint-light-client crate.
-            self.verifier
+            self.0
+                .verifier
                 .verify_update_header(untrusted_state, trusted_state, &options, now)
                 .into_result()?;
         }
@@ -100,10 +103,12 @@ impl ClientState {
     where
         ClientValidationContext: TmValidationContext,
     {
-        let header_consensus_state = TmConsensusState::from(header.clone());
-
         let maybe_existing_consensus_state = {
-            let path_at_header_height = ClientConsensusStatePath::new(client_id, &header.height());
+            let path_at_header_height = ClientConsensusStatePath::new(
+                client_id.clone(),
+                header.height().revision_number(),
+                header.height().revision_height(),
+            );
 
             ctx.consensus_state(&path_at_header_height).ok()
         };
@@ -116,6 +121,9 @@ impl ClientState {
                         description: err.to_string(),
                     })?;
 
+                let header_consensus_state =
+                    TmConsensusState::from(ConsensusStateType::from(header.clone()));
+
                 // There is evidence of misbehaviour if the stored consensus state
                 // is different from the new one we received.
                 Ok(existing_consensus_state != header_consensus_state)
@@ -136,7 +144,7 @@ impl ClientState {
                                 description: err.to_string(),
                             })?;
 
-                        if header.signed_header.header().time <= prev_cs.timestamp {
+                        if header.signed_header.header().time <= prev_cs.timestamp() {
                             return Ok(true);
                         }
                     }
@@ -144,7 +152,7 @@ impl ClientState {
 
                 // 2. if a header comes in and is not the “last” header, then we also ensure
                 //    that its timestamp is less than the “next header”
-                if header.height() < self.latest_height {
+                if header.height() < self.0.latest_height {
                     let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
 
                     if let Some(next_cs) = maybe_next_cs {
@@ -155,7 +163,7 @@ impl ClientState {
                                 description: err.to_string(),
                             })?;
 
-                        if header.signed_header.header().time >= next_cs.timestamp {
+                        if header.signed_header.header().time >= next_cs.timestamp() {
                             return Ok(true);
                         }
                     }
@@ -179,7 +187,11 @@ impl ClientState {
         heights.sort();
 
         for height in heights {
-            let client_consensus_state_path = ClientConsensusStatePath::new(client_id, &height);
+            let client_consensus_state_path = ClientConsensusStatePath::new(
+                client_id.clone(),
+                height.revision_number(),
+                height.revision_height(),
+            );
             let consensus_state =
                 CommonContext::consensus_state(ctx, &client_consensus_state_path)?;
             let tm_consensus_state: TmConsensusState =
@@ -189,10 +201,19 @@ impl ClientState {
                         description: err.to_string(),
                     })?;
 
-            let host_timestamp = ctx.host_timestamp()?;
-            let tm_consensus_state_expiry = (tm_consensus_state.timestamp() + self.trusting_period)
+            let host_timestamp =
+                ctx.host_timestamp()?
+                    .into_tm_time()
+                    .ok_or_else(|| ClientError::Other {
+                        description: String::from("host timestamp is not a valid TM timestamp"),
+                    })?;
+            let tm_consensus_state_timestamp = tm_consensus_state.timestamp();
+            let tm_consensus_state_expiry = (tm_consensus_state_timestamp
+                + self.0.trusting_period)
                 .map_err(|_| ClientError::Other {
-                    description: String::from("Timestamp overflow error occurred while attempting to parse TmConsensusState")
+                    description: String::from(
+                        "Timestamp overflow error occurred while attempting to parse TmConsensusState",
+                    ),
                 })?;
 
             if tm_consensus_state_expiry > host_timestamp {
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
new file mode 100644
index 000000000..020849e57
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -0,0 +1,98 @@
+//! This module includes trait implementations for the
+//! `ibc_client_tendermint_types::ConsensusState` type. It implements the
+//! `ConsensusStateTrait` for `ConsensusState` by defining a newtype wrapper in
+//! order to circumvent Rust's orphan rule, which disallows foreign traits from
+//! being implemented on foreign types. This module also includes some trait
+//! implementations that serve to pass through traits implemented on the wrapped
+//! `ConsensusState` type.
+
+use ibc_client_tendermint_types::error::Error;
+use ibc_client_tendermint_types::proto::v1::ConsensusState as RawTmConsensusState;
+use ibc_client_tendermint_types::ConsensusState as ConsensusStateType;
+use ibc_core_client::context::consensus_state::ConsensusState as ConsensusStateTrait;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_commitment_types::commitment::CommitmentRoot;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::{Any, Protobuf};
+use ibc_primitives::Timestamp;
+use tendermint::{Hash, Time};
+
+/// Newtype wrapper around the `ConsensusState` type imported from the
+/// `ibc-client-tendermint-types` crate. This wrapper exists so that we can
+/// bypass Rust's orphan rules and implement traits from
+/// `ibc::core::client::context` on the `ConsensusState` type.
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq)]
+pub struct ConsensusState(ConsensusStateType);
+
+impl ConsensusState {
+    pub fn inner(&self) -> &ConsensusStateType {
+        &self.0
+    }
+
+    pub fn timestamp(&self) -> Time {
+        self.0.timestamp
+    }
+
+    pub fn next_validators_hash(&self) -> Hash {
+        self.0.next_validators_hash
+    }
+}
+
+impl From<ConsensusStateType> for ConsensusState {
+    fn from(consensus_state: ConsensusStateType) -> Self {
+        Self(consensus_state)
+    }
+}
+
+impl Protobuf<RawTmConsensusState> for ConsensusState {}
+
+impl TryFrom<RawTmConsensusState> for ConsensusState {
+    type Error = Error;
+
+    fn try_from(raw: RawTmConsensusState) -> Result<Self, Self::Error> {
+        Ok(Self(ConsensusStateType::try_from(raw)?))
+    }
+}
+
+impl From<ConsensusState> for RawTmConsensusState {
+    fn from(consensus_state: ConsensusState) -> Self {
+        consensus_state.0.into()
+    }
+}
+
+impl Protobuf<Any> for ConsensusState {}
+
+impl TryFrom<Any> for ConsensusState {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        Ok(Self(ConsensusStateType::try_from(raw)?))
+    }
+}
+
+impl From<ConsensusState> for Any {
+    fn from(client_state: ConsensusState) -> Self {
+        client_state.0.into()
+    }
+}
+
+impl From<tendermint::block::Header> for ConsensusState {
+    fn from(header: tendermint::block::Header) -> Self {
+        Self(ConsensusStateType::from(header))
+    }
+}
+
+impl ConsensusStateTrait for ConsensusState {
+    fn root(&self) -> &CommitmentRoot {
+        &self.0.root
+    }
+
+    fn timestamp(&self) -> Timestamp {
+        self.0.timestamp.into()
+    }
+
+    fn encode_vec(self) -> Vec<u8> {
+        <Self as Protobuf<Any>>::encode_vec(self)
+    }
+}
diff --git a/crates/ibc/src/clients/ics07_tendermint/context.rs b/ibc-clients/ics07-tendermint/src/context.rs
similarity index 83%
rename from crates/ibc/src/clients/ics07_tendermint/context.rs
rename to ibc-clients/ics07-tendermint/src/context.rs
index 449efa7dd..2f2579fc6 100644
--- a/crates/ibc/src/clients/ics07_tendermint/context.rs
+++ b/ibc-clients/ics07-tendermint/src/context.rs
@@ -1,13 +1,14 @@
 use alloc::string::ToString;
 
-use super::consensus_state::ConsensusState as TmConsensusState;
-use crate::core::ics02_client::ClientExecutionContext;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::prelude::*;
-use crate::Height;
+use ibc_core_client::context::ClientExecutionContext;
+use ibc_core_client::types::Height;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::ClientConsensusStatePath;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
+
+use crate::consensus_state::ConsensusState as TmConsensusState;
 
 /// Client's context required during both validation and execution
 pub trait CommonContext {
diff --git a/ibc-clients/ics07-tendermint/src/lib.rs b/ibc-clients/ics07-tendermint/src/lib.rs
new file mode 100644
index 000000000..7971d5976
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/lib.rs
@@ -0,0 +1,31 @@
+//! ICS 07: Tendermint light client implementation along with re-exporting data
+//! structures and implementations of IBC core client module.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+extern crate alloc;
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+pub mod client_state;
+pub mod consensus_state;
+pub mod context;
+
+pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
+
+/// Re-export of Tendermint light client data structures from `ibc-client-tendermint` crate.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_client_tendermint_types::*;
+}
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
new file mode 100644
index 000000000..55935dad4
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -0,0 +1,106 @@
+[package]
+name         = "ibc-client-tendermint-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-07 Tendermint Client data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh      = { workspace = true, optional = true }
+bytes      = { workspace = true }
+displaydoc = { workspace = true }
+prost      = { workspace = true }
+serde      = { workspace = true, optional = true }
+
+# ibc dependencies
+ibc-core-client-context   = { workspace = true }
+ibc-core-client-types     = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint                       = { workspace = true }
+tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
+tendermint-proto                 = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit    = { workspace = true }
+serde_json     = { workspace = true }
+tendermint-rpc = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "bytes/std",
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "serde_json/std",
+    "ibc-core-client-context/std",
+    "ibc-core-client-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-handler-types/std",
+    "ibc-core-host-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "tendermint/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-core-client-context/serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "ibc-core-client-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/crates/ibc/src/clients/ics07_tendermint/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
similarity index 53%
rename from crates/ibc/src/clients/ics07_tendermint/client_state.rs
rename to ibc-clients/ics07-tendermint/types/src/client_state.rs
index d7ada244f..172ffdba9 100644
--- a/crates/ibc/src/clients/ics07_tendermint/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -1,17 +1,19 @@
 //! Implements the core [`ClientState`](crate::core::ics02_client::client_state::ClientState) trait
 //! for the Tendermint light client.
 
-mod misbehaviour;
-mod update_client;
-
 use core::cmp::max;
 use core::convert::{TryFrom, TryInto};
 use core::str::FromStr;
 use core::time::Duration;
 
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::specs::ProofSpecs;
+use ibc_core_host_types::identifiers::ChainId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::ZERO_DURATION;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
 use ibc_proto::ibc::lightclients::tendermint::v1::ClientState as RawTmClientState;
 use ibc_proto::Protobuf;
 use prost::Message;
@@ -20,36 +22,9 @@ use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresh
 use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::ProdVerifier;
 
-use super::trust_threshold::TrustThreshold;
-use super::{
-    client_type as tm_client_type, ExecutionContext as TmExecutionContext,
-    ValidationContext as TmValidationContext,
-};
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::error::Error;
-use crate::clients::ics07_tendermint::header::Header as TmHeader;
-use crate::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
-use crate::clients::ics07_tendermint::CommonContext;
-use crate::core::ics02_client::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
-};
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
-use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use crate::core::ics23_commitment::commitment::{
-    CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
-};
-use crate::core::ics23_commitment::merkle::{apply_prefix, MerkleProof};
-use crate::core::ics23_commitment::specs::ProofSpecs;
-use crate::core::ics24_host::identifier::{ChainId, ClientId};
-use crate::core::ics24_host::path::{
-    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
-};
-use crate::core::timestamp::ZERO_DURATION;
-use crate::core::ExecutionContext;
-use crate::prelude::*;
-use crate::Height;
+use crate::error::Error;
+use crate::header::Header as TmHeader;
+use crate::trust_threshold::TrustThreshold;
 
 pub const TENDERMINT_CLIENT_STATE_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.ClientState";
 
@@ -60,6 +35,22 @@ pub struct AllowUpdate {
     pub after_misbehaviour: bool,
 }
 
+/// Parameters needed when initializing a new `ClientState`. This type
+/// exists mainly as a convenience for providing default values in
+/// testing scenarios.
+#[derive(Clone, Debug, PartialEq)]
+pub struct ClientStateParams {
+    pub id: ChainId,
+    pub trust_level: TrustThreshold,
+    pub trusting_period: Duration,
+    pub unbonding_period: Duration,
+    pub max_clock_drift: Duration,
+    pub latest_height: Height,
+    pub proof_specs: ProofSpecs,
+    pub upgrade_path: Vec<String>,
+    pub allow_update: AllowUpdate,
+}
+
 /// Contains the core implementation of the Tendermint light client
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq)]
@@ -68,14 +59,14 @@ pub struct ClientState {
     pub trust_level: TrustThreshold,
     pub trusting_period: Duration,
     pub unbonding_period: Duration,
-    max_clock_drift: Duration,
+    pub max_clock_drift: Duration,
     pub latest_height: Height,
     pub proof_specs: ProofSpecs,
     pub upgrade_path: Vec<String>,
-    allow_update: AllowUpdate,
-    frozen_height: Option<Height>,
+    pub allow_update: AllowUpdate,
+    pub frozen_height: Option<Height>,
     #[cfg_attr(feature = "serde", serde(skip))]
-    verifier: ProdVerifier,
+    pub verifier: ProdVerifier,
 }
 
 impl ClientState {
@@ -244,7 +235,7 @@ impl ClientState {
         })
     }
 
-    fn chain_id(&self) -> ChainId {
+    pub fn chain_id(&self) -> ChainId {
         self.chain_id.clone()
     }
 
@@ -263,379 +254,6 @@ impl ClientState {
     }
 }
 
-impl ClientStateCommon for ClientState {
-    fn verify_consensus_state(&self, consensus_state: Any) -> Result<(), ClientError> {
-        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
-        if tm_consensus_state.root().is_empty() {
-            return Err(ClientError::Other {
-                description: "empty commitment root".into(),
-            });
-        };
-
-        Ok(())
-    }
-
-    fn client_type(&self) -> ClientType {
-        tm_client_type()
-    }
-
-    fn latest_height(&self) -> Height {
-        self.latest_height
-    }
-
-    fn validate_proof_height(&self, proof_height: Height) -> Result<(), ClientError> {
-        if self.latest_height() < proof_height {
-            return Err(ClientError::InvalidProofHeight {
-                latest_height: self.latest_height(),
-                proof_height,
-            });
-        }
-        Ok(())
-    }
-
-    /// Perform client-specific verifications and check all data in the new
-    /// client state to be the same across all valid Tendermint clients for the
-    /// new chain.
-    ///
-    /// You can learn more about how to upgrade IBC-connected SDK chains in
-    /// [this](https://ibc.cosmos.network/main/ibc/upgrades/quick-guide.html)
-    /// guide
-    fn verify_upgrade_client(
-        &self,
-        upgraded_client_state: Any,
-        upgraded_consensus_state: Any,
-        proof_upgrade_client: CommitmentProofBytes,
-        proof_upgrade_consensus_state: CommitmentProofBytes,
-        root: &CommitmentRoot,
-    ) -> Result<(), ClientError> {
-        // Make sure that the client type is of Tendermint type `ClientState`
-        let upgraded_tm_client_state = Self::try_from(upgraded_client_state.clone())?;
-
-        // Make sure that the consensus type is of Tendermint type `ConsensusState`
-        TmConsensusState::try_from(upgraded_consensus_state.clone())?;
-
-        // Make sure the latest height of the current client is not greater then
-        // the upgrade height This condition checks both the revision number and
-        // the height
-        if self.latest_height() >= upgraded_tm_client_state.latest_height {
-            return Err(UpgradeClientError::LowUpgradeHeight {
-                upgraded_height: self.latest_height(),
-                client_height: upgraded_tm_client_state.latest_height,
-            })?;
-        }
-
-        // Check to see if the upgrade path is set
-        let mut upgrade_path = self.upgrade_path.clone();
-        if upgrade_path.pop().is_none() {
-            return Err(ClientError::ClientSpecific {
-                description: "cannot upgrade client as no upgrade path has been set".to_string(),
-            });
-        };
-
-        let upgrade_path_prefix = CommitmentPrefix::try_from(upgrade_path[0].clone().into_bytes())
-            .map_err(ClientError::InvalidCommitmentProof)?;
-
-        let last_height = self.latest_height().revision_height();
-
-        let mut client_state_value = Vec::new();
-        upgraded_client_state
-            .encode(&mut client_state_value)
-            .map_err(ClientError::Encode)?;
-
-        // Verify the proof of the upgraded client state
-        self.verify_membership(
-            &upgrade_path_prefix,
-            &proof_upgrade_client,
-            root,
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(last_height)),
-            client_state_value,
-        )?;
-
-        let mut cons_state_value = Vec::new();
-        upgraded_consensus_state
-            .encode(&mut cons_state_value)
-            .map_err(ClientError::Encode)?;
-
-        // Verify the proof of the upgraded consensus state
-        self.verify_membership(
-            &upgrade_path_prefix,
-            &proof_upgrade_consensus_state,
-            root,
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(last_height)),
-            cons_state_value,
-        )?;
-
-        Ok(())
-    }
-
-    fn verify_membership(
-        &self,
-        prefix: &CommitmentPrefix,
-        proof: &CommitmentProofBytes,
-        root: &CommitmentRoot,
-        path: Path,
-        value: Vec<u8>,
-    ) -> Result<(), ClientError> {
-        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
-            .map_err(ClientError::InvalidCommitmentProof)?
-            .into();
-
-        merkle_proof
-            .verify_membership(
-                &self.proof_specs,
-                root.clone().into(),
-                merkle_path,
-                value,
-                0,
-            )
-            .map_err(ClientError::Ics23Verification)
-    }
-
-    fn verify_non_membership(
-        &self,
-        prefix: &CommitmentPrefix,
-        proof: &CommitmentProofBytes,
-        root: &CommitmentRoot,
-        path: Path,
-    ) -> Result<(), ClientError> {
-        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
-            .map_err(ClientError::InvalidCommitmentProof)?
-            .into();
-
-        merkle_proof
-            .verify_non_membership(&self.proof_specs, root.clone().into(), merkle_path)
-            .map_err(ClientError::Ics23Verification)
-    }
-}
-
-impl<V> ClientStateValidation<V> for ClientState
-where
-    V: ClientValidationContext + TmValidationContext,
-    V::AnyConsensusState: TryInto<TmConsensusState>,
-    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
-{
-    fn verify_client_message(
-        &self,
-        ctx: &V,
-        client_id: &ClientId,
-        client_message: Any,
-        update_kind: &UpdateKind,
-    ) -> Result<(), ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => {
-                let header = TmHeader::try_from(client_message)?;
-                self.verify_header(ctx, client_id, header)
-            }
-            UpdateKind::SubmitMisbehaviour => {
-                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-                self.verify_misbehaviour(ctx, client_id, misbehaviour)
-            }
-        }
-    }
-
-    fn check_for_misbehaviour(
-        &self,
-        ctx: &V,
-        client_id: &ClientId,
-        client_message: Any,
-        update_kind: &UpdateKind,
-    ) -> Result<bool, ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => {
-                let header = TmHeader::try_from(client_message)?;
-                self.check_for_misbehaviour_update_client(ctx, client_id, header)
-            }
-            UpdateKind::SubmitMisbehaviour => {
-                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-                self.check_for_misbehaviour_misbehavior(&misbehaviour)
-            }
-        }
-    }
-
-    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
-        if self.is_frozen() {
-            return Ok(Status::Frozen);
-        }
-
-        let latest_consensus_state: TmConsensusState = {
-            let any_latest_consensus_state = match ctx.consensus_state(
-                &ClientConsensusStatePath::new(client_id, &self.latest_height),
-            ) {
-                Ok(cs) => cs,
-                // if the client state does not have an associated consensus state for its latest height
-                // then it must be expired
-                Err(_) => return Ok(Status::Expired),
-            };
-
-            any_latest_consensus_state.try_into()?
-        };
-
-        // Note: if the `duration_since()` is `None`, indicating that the latest
-        // consensus state is in the future, then we don't consider the client
-        // to be expired.
-        let now = ctx.host_timestamp()?;
-        if let Some(elapsed_since_latest_consensus_state) =
-            now.duration_since(&latest_consensus_state.timestamp())
-        {
-            if elapsed_since_latest_consensus_state > self.trusting_period {
-                return Ok(Status::Expired);
-            }
-        }
-
-        Ok(Status::Active)
-    }
-}
-
-impl<E> ClientStateExecution<E> for ClientState
-where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientState>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<TmConsensusState>,
-{
-    fn initialise(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        consensus_state: Any,
-    ) -> Result<(), ClientError> {
-        let host_timestamp = CommonContext::host_timestamp(ctx)?;
-        let host_height = CommonContext::host_height(ctx)?;
-
-        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
-
-        ctx.store_client_state(ClientStatePath::new(client_id), self.clone().into())?;
-        ctx.store_consensus_state(
-            ClientConsensusStatePath::new(client_id, &self.latest_height),
-            tm_consensus_state.into(),
-        )?;
-        ctx.store_update_time(client_id.clone(), self.latest_height(), host_timestamp)?;
-        ctx.store_update_height(client_id.clone(), self.latest_height(), host_height)?;
-
-        Ok(())
-    }
-
-    fn update_state(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        header: Any,
-    ) -> Result<Vec<Height>, ClientError> {
-        let header = TmHeader::try_from(header)?;
-        let header_height = header.height();
-
-        self.prune_oldest_consensus_state(ctx, client_id)?;
-
-        let maybe_existing_consensus_state = {
-            let path_at_header_height = ClientConsensusStatePath::new(client_id, &header_height);
-
-            CommonContext::consensus_state(ctx, &path_at_header_height).ok()
-        };
-
-        if maybe_existing_consensus_state.is_some() {
-            // if we already had the header installed by a previous relayer
-            // then this is a no-op.
-            //
-            // Do nothing.
-        } else {
-            let host_timestamp = CommonContext::host_timestamp(ctx)?;
-            let host_height = CommonContext::host_height(ctx)?;
-
-            let new_consensus_state = TmConsensusState::from(header.clone());
-            let new_client_state = self.clone().with_header(header)?;
-
-            ctx.store_consensus_state(
-                ClientConsensusStatePath::new(client_id, &new_client_state.latest_height),
-                new_consensus_state.into(),
-            )?;
-            ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
-            ctx.store_update_time(client_id.clone(), header_height, host_timestamp)?;
-            ctx.store_update_height(client_id.clone(), header_height, host_height)?;
-        }
-
-        Ok(vec![header_height])
-    }
-
-    fn update_state_on_misbehaviour(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        _client_message: Any,
-        _update_kind: &UpdateKind,
-    ) -> Result<(), ClientError> {
-        let frozen_client_state = self.clone().with_frozen_height(Height::min(0));
-
-        ctx.store_client_state(ClientStatePath::new(client_id), frozen_client_state.into())?;
-
-        Ok(())
-    }
-
-    // Commit the new client state and consensus state to the store
-    fn update_state_on_upgrade(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        upgraded_client_state: Any,
-        upgraded_consensus_state: Any,
-    ) -> Result<Height, ClientError> {
-        let mut upgraded_tm_client_state = Self::try_from(upgraded_client_state)?;
-        let upgraded_tm_cons_state = TmConsensusState::try_from(upgraded_consensus_state)?;
-
-        upgraded_tm_client_state.zero_custom_fields();
-
-        // Construct new client state and consensus state relayer chosen client
-        // parameters are ignored. All chain-chosen parameters come from
-        // committed client, all client-chosen parameters come from current
-        // client.
-        let new_client_state = ClientState::new(
-            upgraded_tm_client_state.chain_id,
-            self.trust_level,
-            self.trusting_period,
-            upgraded_tm_client_state.unbonding_period,
-            self.max_clock_drift,
-            upgraded_tm_client_state.latest_height,
-            upgraded_tm_client_state.proof_specs,
-            upgraded_tm_client_state.upgrade_path,
-            self.allow_update,
-        )?;
-
-        // The new consensus state is merely used as a trusted kernel against
-        // which headers on the new chain can be verified. The root is just a
-        // stand-in sentinel value as it cannot be known in advance, thus no
-        // proof verification will pass. The timestamp and the
-        // NextValidatorsHash of the consensus state is the blocktime and
-        // NextValidatorsHash of the last block committed by the old chain. This
-        // will allow the first block of the new chain to be verified against
-        // the last validators of the old chain so long as it is submitted
-        // within the TrustingPeriod of this client.
-        // NOTE: We do not set processed time for this consensus state since
-        // this consensus state should not be used for packet verification as
-        // the root is empty. The next consensus state submitted using update
-        // will be usable for packet-verification.
-        let sentinel_root = "sentinel_root".as_bytes().to_vec();
-        let new_consensus_state = TmConsensusState::new(
-            sentinel_root.into(),
-            upgraded_tm_cons_state.timestamp,
-            upgraded_tm_cons_state.next_validators_hash,
-        );
-
-        let latest_height = new_client_state.latest_height;
-        let host_timestamp = CommonContext::host_timestamp(ctx)?;
-        let host_height = CommonContext::host_height(ctx)?;
-
-        ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
-        ctx.store_consensus_state(
-            ClientConsensusStatePath::new(client_id, &latest_height),
-            new_consensus_state.into(),
-        )?;
-        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
-        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
-
-        Ok(latest_height)
-    }
-}
-
 impl Protobuf<RawTmClientState> for ClientState {}
 
 impl TryFrom<RawTmClientState> for ClientState {
@@ -775,33 +393,36 @@ impl From<ClientState> for Any {
     }
 }
 
-// `header.trusted_validator_set` was given to us by the relayer. Thus, we
-// need to ensure that the relayer gave us the right set, i.e. by ensuring
-// that it matches the hash we have stored on chain.
-fn check_header_trusted_next_validator_set(
-    header: &TmHeader,
-    trusted_consensus_state: &TmConsensusState,
-) -> Result<(), ClientError> {
-    if header.trusted_next_validator_set.hash() == trusted_consensus_state.next_validators_hash {
-        Ok(())
-    } else {
-        Err(ClientError::HeaderVerificationFailure {
-            reason: "header trusted next validator set hash does not match hash stored on chain"
-                .to_string(),
-        })
-    }
-}
-
 #[cfg(all(test, feature = "serde"))]
-mod serde_tests {
+pub(crate) mod serde_tests {
+    use serde::de::DeserializeOwned;
+    use serde::Serialize;
     use tendermint_rpc::endpoint::abci_query::AbciQuery;
 
-    use crate::serializers::tests::test_serialization_roundtrip;
+    pub fn test_serialization_roundtrip<T>(json_data: &str)
+    where
+        T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
+    {
+        let parsed0 = serde_json::from_str::<T>(json_data);
+        assert!(parsed0.is_ok());
+        let parsed0 = parsed0.unwrap();
+
+        let serialized = serde_json::to_string(&parsed0);
+        assert!(serialized.is_ok());
+        let serialized = serialized.unwrap();
+
+        let parsed1 = serde_json::from_str::<T>(&serialized);
+        assert!(parsed1.is_ok());
+        let parsed1 = parsed1.unwrap();
+
+        assert_eq!(parsed0, parsed1);
+    }
+
     #[test]
     fn serialization_roundtrip_no_proof() {
         let json_data = include_str!(concat!(
             env!("CARGO_MANIFEST_DIR"),
-            "/../ibc-testkit/tests/data/json/client_state.json"
+            "/../../../ibc-testkit/tests/data/json/client_state.json"
         ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
@@ -810,7 +431,7 @@ mod serde_tests {
     fn serialization_roundtrip_with_proof() {
         let json_data = include_str!(concat!(
             env!("CARGO_MANIFEST_DIR"),
-            "/../ibc-testkit/tests/data/json/client_state_proof.json"
+            "/../../../ibc-testkit/tests/data/json/client_state_proof.json"
         ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
@@ -821,21 +442,18 @@ mod tests {
     use core::str::FromStr;
     use core::time::Duration;
 
+    use ibc_core_client_types::Height;
+    use ibc_core_commitment_types::specs::ProofSpecs;
     use ibc_proto::google::protobuf::Any;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
     use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
     use ibc_proto::ics23::ProofSpec as Ics23ProofSpec;
     use ibc_testkit::utils::clients::tendermint::dummy_tendermint_header;
     use tendermint::block::Header;
-    use test_log::test;
 
     use super::*;
-    use crate::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
-    use crate::clients::ics07_tendermint::error::Error;
-    use crate::core::ics02_client::height::Height;
-    use crate::core::ics23_commitment::specs::ProofSpecs;
-    use crate::core::ics24_host::identifier::ChainId;
-    use crate::core::timestamp::ZERO_DURATION;
+    use crate::client_state::{AllowUpdate, ClientState};
+    use crate::error::Error;
 
     impl ClientState {
         pub fn new_dummy_from_raw(frozen_height: RawHeight) -> Result<Self, Error> {
@@ -883,19 +501,6 @@ mod tests {
         }
     }
 
-    #[derive(Clone, Debug, PartialEq)]
-    struct ClientStateParams {
-        id: ChainId,
-        trust_level: TrustThreshold,
-        trusting_period: Duration,
-        unbonding_period: Duration,
-        max_clock_drift: Duration,
-        latest_height: Height,
-        proof_specs: ProofSpecs,
-        upgrade_path: Vec<String>,
-        allow_update: AllowUpdate,
-    }
-
     #[test]
     fn client_state_new() {
         // Define a "default" set of parameters to reuse throughout these tests.
@@ -1062,77 +667,6 @@ mod tests {
         }
     }
 
-    #[test]
-    fn client_state_verify_height() {
-        // Define a "default" set of parameters to reuse throughout these tests.
-        let default_params: ClientStateParams = ClientStateParams {
-            id: ChainId::new("ibc-1").unwrap(),
-            trust_level: TrustThreshold::ONE_THIRD,
-            trusting_period: Duration::new(64000, 0),
-            unbonding_period: Duration::new(128000, 0),
-            max_clock_drift: Duration::new(3, 0),
-            latest_height: Height::new(1, 10).expect("Never fails"),
-            proof_specs: ProofSpecs::default(),
-            upgrade_path: Default::default(),
-            allow_update: AllowUpdate {
-                after_expiry: false,
-                after_misbehaviour: false,
-            },
-        };
-
-        struct Test {
-            name: String,
-            height: Height,
-            setup: Option<Box<dyn FnOnce(ClientState) -> ClientState>>,
-            want_pass: bool,
-        }
-
-        let tests = vec![
-            Test {
-                name: "Successful height verification".to_string(),
-                height: Height::new(1, 8).expect("Never fails"),
-                setup: None,
-                want_pass: true,
-            },
-            Test {
-                name: "Invalid (too large)  client height".to_string(),
-                height: Height::new(1, 12).expect("Never fails"),
-                setup: None,
-                want_pass: false,
-            },
-        ];
-
-        for test in tests {
-            let p = default_params.clone();
-            let client_state = ClientState::new(
-                p.id,
-                p.trust_level,
-                p.trusting_period,
-                p.unbonding_period,
-                p.max_clock_drift,
-                p.latest_height,
-                p.proof_specs,
-                p.upgrade_path,
-                p.allow_update,
-            )
-            .expect("Never fails");
-            let client_state = match test.setup {
-                Some(setup) => (setup)(client_state),
-                _ => client_state,
-            };
-            let res = client_state.validate_proof_height(test.height);
-
-            assert_eq!(
-                test.want_pass,
-                res.is_ok(),
-                "ClientState::validate_proof_height() failed for test {}, \nmsg{:?} with error {:?}",
-                test.name,
-                test.height,
-                res.err(),
-            );
-        }
-    }
-
     #[test]
     fn tm_client_state_conversions_healthy() {
         // check client state creation path from a proto type
diff --git a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
similarity index 85%
rename from crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
rename to ibc-clients/ics07-tendermint/types/src/consensus_state.rs
index f00a70b8c..d8ac3aaa5 100644
--- a/crates/ibc/src/clients/ics07_tendermint/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
@@ -1,5 +1,8 @@
 //! Defines Tendermint's `ConsensusState` type
 
+use ibc_core_client_types::error::ClientError;
+use ibc_core_commitment_types::commitment::CommitmentRoot;
+use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::ConsensusState as RawConsensusState;
 use ibc_proto::Protobuf;
@@ -8,13 +11,8 @@ use tendermint::time::Time;
 use tendermint::Hash;
 use tendermint_proto::google::protobuf as tpb;
 
-use crate::clients::ics07_tendermint::error::Error;
-use crate::clients::ics07_tendermint::header::Header;
-use crate::core::ics02_client::consensus_state::ConsensusState as ConsensusStateTrait;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics23_commitment::commitment::CommitmentRoot;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
+use crate::error::Error;
+use crate::header::Header;
 
 pub const TENDERMINT_CONSENSUS_STATE_TYPE_URL: &str =
     "/ibc.lightclients.tendermint.v1.ConsensusState";
@@ -36,6 +34,14 @@ impl ConsensusState {
             next_validators_hash,
         }
     }
+
+    pub fn timestamp(&self) -> Time {
+        self.timestamp
+    }
+
+    pub fn root(&self) -> CommitmentRoot {
+        self.root.clone()
+    }
 }
 
 impl Protobuf<RawConsensusState> for ConsensusState {}
@@ -147,32 +153,17 @@ impl From<Header> for ConsensusState {
     }
 }
 
-impl ConsensusStateTrait for ConsensusState {
-    fn root(&self) -> &CommitmentRoot {
-        &self.root
-    }
-
-    fn timestamp(&self) -> Timestamp {
-        self.timestamp.into()
-    }
-
-    fn encode_vec(self) -> Vec<u8> {
-        <Self as Protobuf<Any>>::encode_vec(self)
-    }
-}
-
 #[cfg(all(test, feature = "serde"))]
 mod tests {
     use tendermint_rpc::endpoint::abci_query::AbciQuery;
-    use test_log::test;
 
-    use crate::serializers::tests::test_serialization_roundtrip;
+    use crate::serde_tests::test_serialization_roundtrip;
 
     #[test]
     fn serialization_roundtrip_no_proof() {
         let json_data = include_str!(concat!(
             env!("CARGO_MANIFEST_DIR"),
-            "/../ibc-testkit/tests/data/json/consensus_state.json"
+            "/../../../ibc-testkit/tests/data/json/consensus_state.json"
         ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
@@ -181,7 +172,7 @@ mod tests {
     fn serialization_roundtrip_with_proof() {
         let json_data = include_str!(concat!(
             env!("CARGO_MANIFEST_DIR"),
-            "/../ibc-testkit/tests/data/json/consensus_state_proof.json"
+            "/../../../ibc-testkit/tests/data/json/consensus_state_proof.json"
         ));
         test_serialization_roundtrip::<AbciQuery>(json_data);
     }
diff --git a/crates/ibc/src/clients/ics07_tendermint/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
similarity index 95%
rename from crates/ibc/src/clients/ics07_tendermint/error.rs
rename to ibc-clients/ics07-tendermint/types/src/error.rs
index 135cb1948..661b116a5 100644
--- a/crates/ibc/src/clients/ics07_tendermint/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -3,16 +3,16 @@
 use core::time::Duration;
 
 use displaydoc::Display;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::Height;
+use ibc_core_host_types::error::IdentifierError;
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
 use tendermint::{Error as TendermintError, Hash};
 use tendermint_light_client_verifier::errors::VerificationErrorDetail as LightClientErrorDetail;
 use tendermint_light_client_verifier::operations::VotingPowerTally;
 use tendermint_light_client_verifier::Verdict;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
-use crate::prelude::*;
-use crate::Height;
-
 /// The main error type
 #[derive(Debug, Display)]
 pub enum Error {
@@ -124,7 +124,7 @@ impl From<IdentifierError> for Error {
     }
 }
 
-pub(crate) trait IntoResult<T, E> {
+pub trait IntoResult<T, E> {
     fn into_result(self) -> Result<T, E>;
 }
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/header.rs b/ibc-clients/ics07-tendermint/types/src/header.rs
similarity index 87%
rename from crates/ibc/src/clients/ics07_tendermint/header.rs
rename to ibc-clients/ics07-tendermint/types/src/header.rs
index cb1f56c4f..f70b6f812 100644
--- a/crates/ibc/src/clients/ics07_tendermint/header.rs
+++ b/ibc-clients/ics07-tendermint/types/src/header.rs
@@ -5,6 +5,11 @@ use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use bytes::Buf;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::Height;
+use ibc_core_host_types::identifiers::ChainId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::Protobuf;
@@ -15,13 +20,8 @@ use tendermint::chain::Id as TmChainId;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 
-use crate::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use crate::clients::ics07_tendermint::error::Error;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ChainId;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
-use crate::Height;
+use crate::consensus_state::ConsensusState as TmConsensusState;
+use crate::error::Error;
 
 pub const TENDERMINT_HEADER_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Header";
 
@@ -62,7 +62,7 @@ impl Header {
         .expect("malformed tendermint header domain type has an illegal height of 0")
     }
 
-    pub(crate) fn as_untrusted_block_state(&self) -> UntrustedBlockState<'_> {
+    pub fn as_untrusted_block_state(&self) -> UntrustedBlockState<'_> {
         UntrustedBlockState {
             signed_header: &self.signed_header,
             validators: &self.validator_set,
@@ -70,7 +70,7 @@ impl Header {
         }
     }
 
-    pub(crate) fn as_trusted_block_state<'a>(
+    pub fn as_trusted_block_state<'a>(
         &'a self,
         consensus_state: &TmConsensusState,
         chain_id: &'a TmChainId,
@@ -100,6 +100,24 @@ impl Header {
         Ok(())
     }
 
+    // `header.trusted_validator_set` was given to us by the relayer. Thus, we
+    // need to ensure that the relayer gave us the right set, i.e. by ensuring
+    // that it matches the hash we have stored on chain.
+    pub fn check_trusted_next_validator_set(
+        &self,
+        trusted_consensus_state: &TmConsensusState,
+    ) -> Result<(), ClientError> {
+        if self.trusted_next_validator_set.hash() == trusted_consensus_state.next_validators_hash {
+            Ok(())
+        } else {
+            Err(ClientError::HeaderVerificationFailure {
+                reason:
+                    "header trusted next validator set hash does not match hash stored on chain"
+                        .to_string(),
+            })
+        }
+    }
+
     /// Checks if the fields of a given header are consistent with the trusted fields of this header.
     pub fn validate_basic(&self) -> Result<(), Error> {
         if self.height().revision_number() != self.trusted_height.revision_number() {
@@ -207,8 +225,9 @@ impl From<Header> for RawHeader {
 }
 
 mod pretty {
+    use ibc_primitives::utils::PrettySlice;
+
     pub use super::*;
-    use crate::utils::pretty::PrettySlice;
 
     pub struct PrettySignedHeader<'a>(pub &'a SignedHeader);
 
diff --git a/ibc-clients/ics07-tendermint/types/src/lib.rs b/ibc-clients/ics07-tendermint/types/src/lib.rs
new file mode 100644
index 000000000..6d312d9c3
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/types/src/lib.rs
@@ -0,0 +1,63 @@
+//! ICS-07: Tendermint Client implements a client verification algorithm for blockchains which use
+//! the Tendermint consensus algorithm.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+use core::str::FromStr;
+
+use ibc_core_host_types::identifiers::ClientType;
+
+extern crate alloc;
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+mod client_state;
+mod consensus_state;
+mod header;
+mod misbehaviour;
+mod trust_threshold;
+
+pub use client_state::*;
+pub use consensus_state::*;
+pub use header::*;
+pub use misbehaviour::*;
+pub use trust_threshold::*;
+
+pub mod error;
+
+/// Re-exports necessary proto types for Tendermint light client implementation
+/// from `ibc-proto` crate.
+pub mod proto {
+    pub use ibc_proto::google::protobuf::Any;
+    pub use ibc_proto::ibc::lightclients::tendermint::*;
+    pub use ibc_proto::Protobuf;
+}
+
+pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
+
+/// Returns the tendermint `ClientType`
+pub fn client_type() -> ClientType {
+    ClientType::from_str(TENDERMINT_CLIENT_TYPE).expect("Never fails because it's valid")
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    // Ensures that the validation in `ClientType::from_str` doesn't fail for the tendermint client type
+    #[test]
+    pub fn test_tm_client_type() {
+        let _ = ClientType::from_str(TENDERMINT_CLIENT_TYPE).unwrap();
+    }
+}
diff --git a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
similarity index 94%
rename from crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
rename to ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
index 8697a7c11..010b2a40f 100644
--- a/crates/ibc/src/clients/ics07_tendermint/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
@@ -1,16 +1,16 @@
 //! Defines the misbehaviour type for the tendermint light client
 
 use bytes::Buf;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Misbehaviour as RawMisbehaviour;
 use ibc_proto::Protobuf;
 use prost::Message;
 
-use crate::clients::ics07_tendermint::error::Error;
-use crate::clients::ics07_tendermint::header::Header;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::prelude::*;
+use crate::error::Error;
+use crate::header::Header;
 
 const TENDERMINT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Misbehaviour";
 
diff --git a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
similarity index 98%
rename from crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
rename to ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
index 744dbf14d..c601f3e25 100644
--- a/crates/ibc/src/clients/ics07_tendermint/trust_threshold.rs
+++ b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
@@ -5,12 +5,11 @@
 use core::convert::TryFrom;
 use core::fmt::{Display, Error as FmtError, Formatter};
 
+use ibc_core_client_types::error::ClientError;
 use ibc_proto::ibc::lightclients::tendermint::v1::Fraction;
 use ibc_proto::Protobuf;
 use tendermint::trust_threshold::TrustThresholdFraction;
 
-use crate::core::ics02_client::error::ClientError;
-
 /// [`TrustThreshold`] defines the level of trust that a client has
 /// towards a set of validators of a chain.
 ///
diff --git a/ibc-clients/src/lib.rs b/ibc-clients/src/lib.rs
new file mode 100644
index 000000000..e3c426d06
--- /dev/null
+++ b/ibc-clients/src/lib.rs
@@ -0,0 +1,18 @@
+//! Exports data structures and implementations of different IBC applications.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+/// Re-exports implementations of ICS-07 Tendermint light client.
+pub mod tendermint {
+    #[doc(inline)]
+    pub use ibc_client_tendermint::*;
+}
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
new file mode 100644
index 000000000..f8853a76f
--- /dev/null
+++ b/ibc-core/Cargo.toml
@@ -0,0 +1,75 @@
+[package]
+name         = "ibc-core"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "core"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement IBC core (TAO) 
+    modules, facilitating seamless integration of IBC core business logic into any blockchain system.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+ibc-core-client           = { workspace = true }
+ibc-core-connection       = { workspace = true }
+ibc-core-channel          = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host             = { workspace = true }
+ibc-core-router           = { workspace = true }
+ibc-core-handler          = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-core-client/std",
+    "ibc-core-connection/std",
+    "ibc-core-channel/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host/std",
+    "ibc-core-router/std",
+    "ibc-core-handler/std",
+]
+serde = [
+    "ibc-core-client/serde",
+    "ibc-core-connection/serde",
+    "ibc-core-channel/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-router/serde",
+    "ibc-core-handler/serde",
+]
+borsh = [
+    "ibc-core-client/borsh",
+    "ibc-core-connection/borsh",
+    "ibc-core-channel/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-router/borsh",
+    "ibc-core-handler/borsh",
+]
+schema = [
+    "ibc-core-client/schema",
+    "ibc-core-connection/schema",
+    "ibc-core-channel/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host/schema",
+    "ibc-core-router/schema",
+    "ibc-core-handler/schema",
+]
+parity-scale-codec = [
+    "ibc-core-client/parity-scale-codec",
+    "ibc-core-connection/parity-scale-codec",
+    "ibc-core-channel/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-router/parity-scale-codec",
+    "ibc-core-handler/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/ibc-core/README.md b/ibc-core/README.md
new file mode 100644
index 000000000..d8460a5b5
--- /dev/null
+++ b/ibc-core/README.md
@@ -0,0 +1,128 @@
+# IBC Core
+
+This is the top-level library that re-exports the Inter-Blockchain Communication
+(IBC) core modules as a meta-crate. It serves to simplify the process of
+importing and integrating various IBC core modules into your blockchain.
+
+IBC is a distributed protocol that enables communication between distinct
+sovereign blockchains and IBC core is the part of the protocol that handles the
+transport, authentication, and ordering (TAO) of data packets.
+
+The structure within the `ibc-core` crate is designed to provide flexibility for
+external users. You can choose to utilize the entire `ibc-core` crate, or
+selectively import specific libraries. From there, you also have the flexibility
+of bringing in an entire sub-module (e.g. the `ibc-core-client` crate), or only
+a module's associated data structures (e.g. `ibc-core-client-types`).
+
+This versatility empowers hosts, including chain integrators, relayers, or any
+IBC tooling projects, to build their solution on top of the layers that best
+suit their particular requirements.
+
+## Sub-Crates
+
+Currently, the `ibc-core` crate contains the implementation of the following IBC
+core specifications:
+
+### ICS-02: Client Semantics
+
+- [ibc-core-client](./../ibc-core/ics02-client)
+- [ibc-core-client-context](./../ibc-core/ics02-client/context)
+- [ibc-core-client-types](./../ibc-core/ics02-client/types)
+
+### ICS-03: Connection Semantics
+
+- [ibc-core-connection](./../ibc-core/ics03-connection)
+- [ibc-core-connection-types](./../ibc-core/ics03-connection/types)
+
+### ICS-04: Channel and Packet Semantics
+
+- [ibc-core-channel](./../ibc-core/ics04-channel)
+- [ibc-core-channel-types](./../ibc-core/ics04-channel/types)
+
+### ICS-24: Host Requirements
+
+- [ibc-core-host](./../ibc-core/ics24-host)
+- [ibc-core-host-cosmos](./../ibc-core/ics24-host/cosmos)
+- [ibc-core-host-types](./../ibc-core/ics24-host/types)
+
+### ICS-25: Handler Interface
+
+- [ibc-core-handler](./../ibc-core/ics25-handler)
+- [ibc-core-handler-types](./../ibc-core/ics25-handler/types)
+
+### ICS-26: Routing Module
+
+- [ibc-core-routing](./../ibc-core/ics26-routing)
+- [ibc-core-routing-types](./../ibc-core/ics26-routing/types)
+
+## Divergence from the Interchain Standards (ICS)
+
+This crate diverges from the [ICS specification](https://github.com/cosmos/ibc)
+in a number of ways. See below for more details.
+
+### Module system: no support for untrusted modules
+
+ICS-24 (Host Requirements) gives the [following
+requirement](https://github.com/cosmos/ibc/blob/master/spec/core/ics-024-host-requirements/README.md#module-system)
+about the module system that the host state machine must support:
+
+> The host state machine must support a module system, whereby self-contained,
+> potentially mutually distrusted packages of code can safely execute on the
+> same ledger [...].
+
+**This crate currently does not support mutually distrusted packages**. That is,
+modules on the host state machine are assumed to be fully trusted. In practice,
+this means that every module has either been written by the host state machine
+developers, or fully vetted by them.
+
+### Port system: No object capability system
+
+ICS-05 (Port Allocation) requires the host system to support either
+object-capability reference or source authentication for modules.
+
+> In the former object-capability case, the IBC handler must have the ability to
+> generate object-capabilities, unique, opaque references which can be passed to
+> a module and will not be duplicable by other modules. [...] In the latter
+> source authentication case, the IBC handler must have the ability to securely
+> read the source identifier of the calling module, a unique string for each
+> module in the host state machine, which cannot be altered by the module or
+> faked by another module.
+
+**This crate currently requires neither of the host system**. Since modules are
+assumed to be trusted, there is no need for this object capability system that
+protects resources for potentially malicious modules.
+
+For more background on this, see [this issue](https://github.com/informalsystems/ibc-rs/issues/2159).
+
+### Port system: transferring and releasing a port
+
+ICS-05 (Port Allocation) requires the IBC handler to permit [transferring
+ownership of a
+port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#transferring-ownership-of-a-port)
+and [releasing a
+port](https://github.com/cosmos/ibc/tree/master/spec/core/ics-005-port-allocation#releasing-a-port).
+
+We currently support neither.
+
+### Asynchronous acknowledgements
+
+The standard gives the ability for modules to [acknowledge packets
+asynchronously](https://github.com/cosmos/ibc/tree/main/spec/core/ics-004-channel-and-packet-semantics#writing-acknowledgements).
+This allows modules to receive the packet, but only applying the changes at a
+later time (after which they would write the acknowledgement).
+
+We currently force applications to process the packets as part of
+`onRecvPacket()`. If you need asynchronous acknowledgements for your
+application, please open an issue.
+
+Note that this still makes us 100% compatible with `ibc-go`.
+
+## Contributing
+
+IBC is specified in English in the [cosmos/ibc
+repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
+should be contributed there.
+
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./../CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
diff --git a/ibc-core/ics02-client/Cargo.toml b/ibc-core/ics02-client/Cargo.toml
new file mode 100644
index 000000000..5e82d0736
--- /dev/null
+++ b/ibc-core/ics02-client/Cargo.toml
@@ -0,0 +1,75 @@
+[package]
+name         = "ibc-core-client"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "light-client"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of ICS-02 Client Semantics and 
+    re-exports essential data structures and domain types from `ibc-core-client-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+prost = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-client-context   = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host             = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "prost/std",
+    "ibc-core-client-types/std",
+    "ibc-core-client-context/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "ibc-core-client-types/serde",
+    "ibc-core-client-context/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+borsh = [
+    "ibc-core-client-types/borsh",
+    "ibc-core-client-context/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+schema = [
+    "ibc-core-client-types/schema",
+    "ibc-core-client-context/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
+    "serde",
+    "std"
+]
+parity-scale-codec = [
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-client-context/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
new file mode 100644
index 000000000..06a23157b
--- /dev/null
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -0,0 +1,81 @@
+[package]
+name         = "ibc-core-client-context"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc"]
+readme       = "./../README.md"
+description  = """
+    Maintaind by `ibc-rs`, contains essential APIs to interface with the host chain's store, 
+    enabling smooth client state transitions. Additionally, provides necessary traits for 
+    implementing custom IBC light clients.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-derive                = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "subtle-encoding/std",
+    "ibc-core-client-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+    "tendermint/std",
+]
+serde = [
+    "ibc-core-client-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+borsh = [
+    "ibc-core-client-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+schema = [
+    "ibc-core-client-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-handler-types/schema",
+    "serde",
+    "std"
+]
+parity-scale-codec = [
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/crates/ibc/src/core/ics02_client/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
similarity index 80%
rename from crates/ibc/src/core/ics02_client/client_state.rs
rename to ibc-core/ics02-client/context/src/client_state.rs
index 05ee1e37b..e671c0319 100644
--- a/crates/ibc/src/core/ics02_client/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -1,66 +1,16 @@
 //! Defines `ClientState`, the core type to be implemented by light clients
 
-use core::fmt::{Debug, Display, Formatter};
 use core::marker::{Send, Sync};
 
-use ibc_proto::google::protobuf::Any;
-
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::ClientExecutionContext;
-use crate::core::ics23_commitment::commitment::{
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::{Height, Status, UpdateKind};
+use ibc_core_commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::Path;
-use crate::prelude::*;
-use crate::Height;
-
-/// `UpdateKind` represents the 2 ways that a client can be updated
-/// in IBC: either through a `MsgUpdateClient`, or a `MsgSubmitMisbehaviour`.
-#[derive(Clone, Debug, PartialEq, Eq)]
-pub enum UpdateKind {
-    /// this is the typical scenario where a new header is submitted to the client
-    /// to update the client. Note that light clients are free to define the type
-    /// of the object used to update them (e.g. could be a list of headers).
-    UpdateClient,
-    /// this is the scenario where misbehaviour is submitted to the client
-    /// (e.g 2 headers with the same height in Tendermint)
-    SubmitMisbehaviour,
-}
-
-/// Represents the status of a client
-#[derive(Debug, PartialEq, Eq)]
-pub enum Status {
-    /// The client is active and allowed to be used
-    Active,
-    /// The client is frozen and not allowed to be used
-    Frozen,
-    /// The client is expired and not allowed to be used
-    Expired,
-    /// Unauthorized indicates that the client type is not registered as an allowed client type.
-    Unauthorized,
-}
-
-impl Status {
-    pub fn is_active(&self) -> bool {
-        *self == Status::Active
-    }
-
-    pub fn is_frozen(&self) -> bool {
-        *self == Status::Frozen
-    }
-
-    pub fn is_expired(&self) -> bool {
-        *self == Status::Expired
-    }
-}
-
-impl Display for Status {
-    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result {
-        write!(f, "{self:?}")
-    }
-}
+use ibc_core_host_types::identifiers::{ClientId, ClientType};
+use ibc_core_host_types::path::Path;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
 
 /// `ClientState` methods needed in both validation and execution.
 ///
@@ -242,7 +192,7 @@ where
 /// `ClientExecutionContext` (e.g. `MyType<T>` would not be supported).
 pub use ibc_derive::ClientState;
 
-use super::ClientValidationContext;
+use crate::context::{ClientExecutionContext, ClientValidationContext};
 
 /// Primary client trait. Defines all the methods that clients must implement.
 ///
diff --git a/crates/ibc/src/core/ics02_client/consensus_state.rs b/ibc-core/ics02-client/context/src/consensus_state.rs
similarity index 88%
rename from crates/ibc/src/core/ics02_client/consensus_state.rs
rename to ibc-core/ics02-client/context/src/consensus_state.rs
index ea5e05e37..8331428a5 100644
--- a/crates/ibc/src/core/ics02_client/consensus_state.rs
+++ b/ibc-core/ics02-client/context/src/consensus_state.rs
@@ -2,13 +2,12 @@
 
 use core::marker::{Send, Sync};
 
+use ibc_core_commitment_types::commitment::CommitmentRoot;
 /// Derive macro that implements [`ConsensusState`] for enums containing
 /// variants that implement [`ConsensusState`]
 pub use ibc_derive::ConsensusState;
-
-use crate::core::ics23_commitment::commitment::CommitmentRoot;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 
 /// Defines methods that all `ConsensusState`s should provide.
 ///
diff --git a/crates/ibc/src/core/ics02_client/context.rs b/ibc-core/ics02-client/context/src/context.rs
similarity index 90%
rename from crates/ibc/src/core/ics02_client/context.rs
rename to ibc-core/ics02-client/context/src/context.rs
index 093cdf610..368e2c446 100644
--- a/crates/ibc/src/core/ics02_client/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -1,14 +1,15 @@
+use ibc_core_client_types::Height;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_core_host_types::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc_primitives::Timestamp;
+
 use super::client_state::ClientState;
 use super::consensus_state::ConsensusState;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
-use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::Height;
 
 /// Defines the methods available to clients for validating client state
 /// transitions. The generic `V` parameter in
-/// [crate::core::ics02_client::client_state::ClientStateValidation] must
+/// [crate::client_state::ClientStateValidation] must
 /// inherit from this trait.
 pub trait ClientValidationContext {
     /// Returns the time when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
@@ -28,7 +29,7 @@ pub trait ClientValidationContext {
 
 /// Defines the methods that all client `ExecutionContext`s (precisely the
 /// generic parameter of
-/// [`crate::core::ics02_client::client_state::ClientStateExecution`] ) must
+/// [`crate::client_state::ClientStateExecution`] ) must
 /// implement.
 ///
 /// Specifically, clients have the responsibility to store their client state
diff --git a/ibc-core/ics02-client/context/src/lib.rs b/ibc-core/ics02-client/context/src/lib.rs
new file mode 100644
index 000000000..65d41640d
--- /dev/null
+++ b/ibc-core/ics02-client/context/src/lib.rs
@@ -0,0 +1,30 @@
+//! This crate functions as an intermediary layer between the storage of host
+//! chains and an IBC client implementation, providing developers with necessary
+//! traits to craft their custom light clients. It streamlines the process of
+//! integrating light clients with the host, enabling interaction with the store
+//! for pertinent client state transitions.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod client_state;
+pub mod consensus_state;
+
+mod context;
+pub use context::*;
+
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_client_types::*;
+}
diff --git a/crates/ibc/src/core/ics02_client/handler/create_client.rs b/ibc-core/ics02-client/src/handler/create_client.rs
similarity index 75%
rename from crates/ibc/src/core/ics02_client/handler/create_client.rs
rename to ibc-core/ics02-client/src/handler/create_client.rs
index 342fefb16..c4624fefb 100644
--- a/crates/ibc/src/core/ics02_client/handler/create_client.rs
+++ b/ibc-core/ics02-client/src/handler/create_client.rs
@@ -1,16 +1,16 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgCreateClient`.
 
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateExecution};
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::events::CreateClient;
-use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
+use ibc_core_client_context::client_state::{ClientStateCommon, ClientStateExecution};
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::events::CreateClient;
+use ibc_core_client_types::msgs::MsgCreateClient;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
+
+pub fn validate<Ctx>(ctx: &Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -46,7 +46,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx: &mut Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc/src/core/ics02_client/handler.rs b/ibc-core/ics02-client/src/handler/mod.rs
similarity index 100%
rename from crates/ibc/src/core/ics02_client/handler.rs
rename to ibc-core/ics02-client/src/handler/mod.rs
diff --git a/crates/ibc/src/core/ics02_client/handler/update_client.rs b/ibc-core/ics02-client/src/handler/update_client.rs
similarity index 83%
rename from crates/ibc/src/core/ics02_client/handler/update_client.rs
rename to ibc-core/ics02-client/src/handler/update_client.rs
index f4ce3013d..8970bc527 100644
--- a/crates/ibc/src/core/ics02_client/handler/update_client.rs
+++ b/ibc-core/ics02-client/src/handler/update_client.rs
@@ -1,19 +1,19 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpdateAnyClient`.
 
-use prost::Message;
-
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation, UpdateKind,
+use ibc_core_client_context::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation,
 };
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::events::{ClientMisbehaviour, UpdateClient};
-use crate::core::ics02_client::msgs::MsgUpdateOrMisbehaviour;
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::events::{ClientMisbehaviour, UpdateClient};
+use ibc_core_client_types::msgs::MsgUpdateOrMisbehaviour;
+use ibc_core_client_types::UpdateKind;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
+use prost::Message;
 
-pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
+pub fn validate<Ctx>(ctx: &Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -47,7 +47,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx: &mut Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs b/ibc-core/ics02-client/src/handler/upgrade_client.rs
similarity index 68%
rename from crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
rename to ibc-core/ics02-client/src/handler/upgrade_client.rs
index de5ebfbbd..f15c4ce99 100644
--- a/crates/ibc/src/core/ics02_client/handler/upgrade_client.rs
+++ b/ibc-core/ics02-client/src/handler/upgrade_client.rs
@@ -1,19 +1,19 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpgradeAnyClient`.
 //!
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{
+use ibc_core_client_context::client_state::{
     ClientStateCommon, ClientStateExecution, ClientStateValidation,
 };
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::events::UpgradeClient;
-use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
-use crate::core::ics24_host::path::ClientConsensusStatePath;
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_client_context::consensus_state::ConsensusState;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::events::UpgradeClient;
+use ibc_core_client_types::msgs::MsgUpgradeClient;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::ClientConsensusStatePath;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
 
-pub(crate) fn validate<Ctx>(ctx: &Ctx, msg: MsgUpgradeClient) -> Result<(), ContextError>
+pub fn validate<Ctx>(ctx: &Ctx, msg: MsgUpgradeClient) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -35,12 +35,15 @@ where
     }
 
     // Read the latest consensus state from the host chain store.
-    let old_client_cons_state_path =
-        ClientConsensusStatePath::new(&client_id, &old_client_state.latest_height());
+    let old_client_cons_state_path = ClientConsensusStatePath::new(
+        client_id.clone(),
+        old_client_state.latest_height().revision_number(),
+        old_client_state.latest_height().revision_height(),
+    );
     let old_consensus_state = ctx
         .consensus_state(&old_client_cons_state_path)
         .map_err(|_| ClientError::ConsensusStateNotFound {
-            client_id: client_id.clone(),
+            client_id,
             height: old_client_state.latest_height(),
         })?;
 
@@ -56,7 +59,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx: &mut Ctx, msg: MsgUpgradeClient) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgUpgradeClient) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/ibc-core/ics02-client/src/lib.rs b/ibc-core/ics02-client/src/lib.rs
new file mode 100644
index 000000000..b692624c8
--- /dev/null
+++ b/ibc-core/ics02-client/src/lib.rs
@@ -0,0 +1,31 @@
+//! ICS-02: Client Semantics implementation for verifying remote IBC-enabled chains,
+//! along with re-exporting data structures from `ibc-core-client-types` crate.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod handler;
+
+/// Re-exports ICS-02 traits from `ibc-core-client-context` for custom IBC
+/// client implementation.
+pub mod context {
+    #[doc(inline)]
+    pub use ibc_core_client_context::*;
+}
+
+/// Re-exports ICS-02 data structures from the `ibc-core-client-types` crate.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_client_types::*;
+}
diff --git a/ibc-core/ics02-client/types/Cargo.toml b/ibc-core/ics02-client/types/Cargo.toml
new file mode 100644
index 000000000..f4cb72346
--- /dev/null
+++ b/ibc-core/ics02-client/types/Cargo.toml
@@ -0,0 +1,88 @@
+[package]
+name         = "ibc-core-client-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "client", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-02 Client Semantics data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec  = { workspace = true, optional = true }
+scale-info          = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "tendermint/std",
+]
+serde = [
+    "ibc-core-host-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+    "dep:serde",
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core-host-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/crates/ibc/src/core/ics02_client/error.rs b/ibc-core/ics02-client/types/src/error.rs
similarity index 90%
rename from crates/ibc/src/core/ics02_client/error.rs
rename to ibc-core/ics02-client/types/src/error.rs
index f9b79f194..ab40103f1 100644
--- a/crates/ibc/src/core/ics02_client/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -1,15 +1,15 @@
 //! Defines the client error type
 
 use displaydoc::Display;
+// use ibc::core::ContextError;
+use ibc_core_commitment_types::error::CommitmentError;
+use ibc_core_host_types::error::IdentifierError;
+use ibc_core_host_types::identifiers::{ClientId, ClientType};
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 
-use super::client_state::Status;
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics23_commitment::error::CommitmentError;
-use crate::core::ics24_host::identifier::{ClientId, IdentifierError};
-use crate::core::timestamp::Timestamp;
-use crate::core::ContextError;
-use crate::prelude::*;
-use crate::Height;
+use super::status::Status;
+use crate::height::Height;
 
 /// Encodes all the possible client errors
 #[derive(Debug, Display)]
@@ -84,7 +84,7 @@ pub enum ClientError {
     /// invalid commitment proof bytes error: `{0}`
     InvalidCommitmentProof(CommitmentError),
     /// invalid packet timeout timestamp value error: `{0}`
-    InvalidPacketTimestamp(crate::core::timestamp::ParseTimestampError),
+    InvalidPacketTimestamp(ibc_primitives::ParseTimestampError),
     /// mismatch between client and arguments types
     ClientArgsTypeMismatch { client_type: ClientType },
     /// received header height (`{header_height}`) is lower than (or equal to) client latest height (`{latest_height}`)
@@ -110,17 +110,6 @@ pub enum ClientError {
     Other { description: String },
 }
 
-impl From<ContextError> for ClientError {
-    fn from(context_error: ContextError) -> Self {
-        match context_error {
-            ContextError::ClientError(e) => e,
-            _ => ClientError::Other {
-                description: context_error.to_string(),
-            },
-        }
-    }
-}
-
 impl From<&'static str> for ClientError {
     fn from(s: &'static str) -> Self {
         Self::Other {
diff --git a/crates/ibc/src/core/ics02_client/events.rs b/ibc-core/ics02-client/types/src/events.rs
similarity index 98%
rename from crates/ibc/src/core/ics02_client/events.rs
rename to ibc-core/ics02-client/types/src/events.rs
index e55bb9017..31625757b 100644
--- a/crates/ibc/src/core/ics02_client/events.rs
+++ b/ibc-core/ics02-client/types/src/events.rs
@@ -1,12 +1,11 @@
 //! Types for the IBC events emitted from Tendermint Websocket by the client module.
 use derive_more::From;
+use ibc_core_host_types::identifiers::{ClientId, ClientType};
+use ibc_primitives::prelude::*;
 use subtle_encoding::hex;
 use tendermint::abci;
 
-use crate::core::ics02_client::client_type::ClientType;
-use crate::core::ics02_client::height::Height;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::prelude::*;
+use crate::height::Height;
 
 /// Client event types
 const CREATE_CLIENT_EVENT: &str = "create_client";
@@ -420,7 +419,7 @@ impl From<UpgradeClient> for abci::Event {
 
 #[cfg(test)]
 mod tests {
-    use std::str::FromStr;
+    use core::str::FromStr;
 
     use ibc_proto::google::protobuf::Any;
     use ibc_testkit::utils::clients::mock::dummy_new_mock_header;
diff --git a/crates/ibc/src/core/ics02_client/height.rs b/ibc-core/ics02-client/types/src/height.rs
similarity index 98%
rename from crates/ibc/src/core/ics02_client/height.rs
rename to ibc-core/ics02-client/types/src/height.rs
index fbdf42def..889c47c81 100644
--- a/crates/ibc/src/core/ics02_client/height.rs
+++ b/ibc-core/ics02-client/types/src/height.rs
@@ -5,11 +5,11 @@ use core::num::ParseIntError;
 use core::str::FromStr;
 
 use displaydoc::Display;
+use ibc_primitives::prelude::*;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::prelude::*;
+use crate::error::ClientError;
 
 /// The core IBC height type, which represents the height of a chain,
 /// which typically is the number of blocks since genesis
diff --git a/ibc-core/ics02-client/types/src/lib.rs b/ibc-core/ics02-client/types/src/lib.rs
new file mode 100644
index 000000000..f7c1f9593
--- /dev/null
+++ b/ibc-core/ics02-client/types/src/lib.rs
@@ -0,0 +1,29 @@
+//! Implementation of the Client Semantics (ICS-02) data structures.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod error;
+pub mod events;
+mod height;
+pub mod msgs;
+mod status;
+
+pub use height::*;
+pub use status::*;
+
+/// Re-exports ICS-02 proto types from the `ibc-proto` crate for added convenience.
+pub mod proto {
+    pub use ibc_proto::ibc::core::client::*;
+}
diff --git a/crates/ibc/src/core/ics02_client/msgs/create_client.rs b/ibc-core/ics02-client/types/src/msgs/create_client.rs
similarity index 88%
rename from crates/ibc/src/core/ics02_client/msgs/create_client.rs
rename to ibc-core/ics02-client/types/src/msgs/create_client.rs
index 9e1e6af13..7c3347980 100644
--- a/crates/ibc/src/core/ics02_client/msgs/create_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/create_client.rs
@@ -1,15 +1,14 @@
 //! Definition of domain type message `MsgCreateClient`.
 
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::error::ClientError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
+pub const CREATE_CLIENT_TYPE_URL: &str = "/ibc.core.client.v1.MsgCreateClient";
 
 /// A type of message that triggers the creation of a new on-chain (IBC) client.
 #[cfg_attr(
@@ -38,7 +37,7 @@ impl Msg for MsgCreateClient {
     type Raw = RawMsgCreateClient;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CREATE_CLIENT_TYPE_URL.to_string()
     }
 }
 
@@ -77,9 +76,8 @@ mod tests {
 
     use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
     use ibc_testkit::utils::core::client::dummy_raw_msg_create_client;
-    use test_log::test;
 
-    use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
+    use crate::msgs::create_client::MsgCreateClient;
 
     #[test]
     fn msg_create_client_serialization() {
diff --git a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
similarity index 86%
rename from crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
rename to ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
index 925bd69f9..d33651821 100644
--- a/crates/ibc/src/core/ics02_client/msgs/misbehaviour.rs
+++ b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
@@ -1,16 +1,15 @@
 //! Definition of domain type message `MsgSubmitMisbehaviour`.
 
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any as ProtoAny;
 use ibc_proto::ibc::core::client::v1::MsgSubmitMisbehaviour as RawMsgSubmitMisbehaviour;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::error::ClientError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
+pub const SUBMIT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
 
 /// A type of message that submits client misbehaviour proof.
 #[cfg_attr(
@@ -32,7 +31,7 @@ impl Msg for MsgSubmitMisbehaviour {
     type Raw = RawMsgSubmitMisbehaviour;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        SUBMIT_MISBEHAVIOUR_TYPE_URL.to_string()
     }
 }
 
diff --git a/crates/ibc/src/core/ics02_client/msgs.rs b/ibc-core/ics02-client/types/src/msgs/mod.rs
similarity index 65%
rename from crates/ibc/src/core/ics02_client/msgs.rs
rename to ibc-core/ics02-client/types/src/msgs/mod.rs
index 22140248f..33330a77d 100644
--- a/crates/ibc/src/core/ics02_client/msgs.rs
+++ b/ibc-core/ics02-client/types/src/msgs/mod.rs
@@ -1,18 +1,18 @@
 //! Defines the client message types that are sent to the chain by the relayer.
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 
-use crate::core::ics02_client::msgs::create_client::MsgCreateClient;
-use crate::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
-use crate::core::ics02_client::msgs::update_client::MsgUpdateClient;
-use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::prelude::*;
-use crate::signer::Signer;
+mod create_client;
+mod misbehaviour;
+mod update_client;
+mod upgrade_client;
 
-pub mod create_client;
-pub mod misbehaviour;
-pub mod update_client;
-pub mod upgrade_client;
+pub use create_client::*;
+pub use misbehaviour::*;
+pub use update_client::*;
+pub use upgrade_client::*;
 
 /// Encodes all the different client messages
 #[allow(dead_code)]
@@ -29,27 +29,27 @@ pub enum ClientMsg {
     UpgradeClient(MsgUpgradeClient),
 }
 
-pub(crate) enum MsgUpdateOrMisbehaviour {
+pub enum MsgUpdateOrMisbehaviour {
     UpdateClient(MsgUpdateClient),
     Misbehaviour(MsgSubmitMisbehaviour),
 }
 
 impl MsgUpdateOrMisbehaviour {
-    pub(crate) fn client_id(&self) -> &ClientId {
+    pub fn client_id(&self) -> &ClientId {
         match self {
             MsgUpdateOrMisbehaviour::UpdateClient(msg) => &msg.client_id,
             MsgUpdateOrMisbehaviour::Misbehaviour(msg) => &msg.client_id,
         }
     }
 
-    pub(crate) fn client_message(self) -> Any {
+    pub fn client_message(self) -> Any {
         match self {
             MsgUpdateOrMisbehaviour::UpdateClient(msg) => msg.client_message,
             MsgUpdateOrMisbehaviour::Misbehaviour(msg) => msg.misbehaviour,
         }
     }
 
-    pub(crate) fn signer(&self) -> &Signer {
+    pub fn signer(&self) -> &Signer {
         match self {
             MsgUpdateOrMisbehaviour::UpdateClient(msg) => &msg.signer,
             MsgUpdateOrMisbehaviour::Misbehaviour(msg) => &msg.signer,
diff --git a/crates/ibc/src/core/ics02_client/msgs/update_client.rs b/ibc-core/ics02-client/types/src/msgs/update_client.rs
similarity index 86%
rename from crates/ibc/src/core/ics02_client/msgs/update_client.rs
rename to ibc-core/ics02-client/types/src/msgs/update_client.rs
index 9c19e77d2..60c70cfc2 100644
--- a/crates/ibc/src/core/ics02_client/msgs/update_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/update_client.rs
@@ -1,16 +1,15 @@
 //! Definition of domain type message `MsgUpdateClient`.
 
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::error::ClientError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
+pub const UPDATE_CLIENT_TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
 
 /// Represents the message that triggers the update of an on-chain (IBC) client
 /// either with new headers, or evidence of misbehaviour.
@@ -32,7 +31,7 @@ impl Msg for MsgUpdateClient {
     type Raw = RawMsgUpdateClient;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        UPDATE_CLIENT_TYPE_URL.to_string()
     }
 }
 
@@ -69,10 +68,9 @@ impl From<MsgUpdateClient> for RawMsgUpdateClient {
 mod tests {
     use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
     use ibc_testkit::utils::core::client::dummy_raw_msg_update_client;
-    use test_log::test;
 
     use super::*;
-    use crate::core::ics02_client::msgs::MsgUpdateClient;
+    use crate::msgs::MsgUpdateClient;
 
     #[test]
     fn msg_update_client_serialization() {
diff --git a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
similarity index 88%
rename from crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
rename to ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
index baf363b38..2175a3cb4 100644
--- a/crates/ibc/src/core/ics02_client/msgs/upgrade_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
@@ -2,19 +2,18 @@
 
 use core::str::FromStr;
 
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_commitment_types::error::CommitmentError;
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::{ClientError, UpgradeClientError};
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics23_commitment::error::CommitmentError;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::error::{ClientError, UpgradeClientError};
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
+pub const UPGRADE_CLIENT_TYPE_URL: &str = "/ibc.core.client.v1.MsgUpgradeClient";
 
 /// A type of message that triggers the upgrade of an on-chain (IBC) client.
 #[cfg_attr(
@@ -43,7 +42,7 @@ impl Msg for MsgUpgradeClient {
     type Raw = RawMsgUpgradeClient;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        UPGRADE_CLIENT_TYPE_URL.to_string()
     }
 }
 
@@ -102,7 +101,7 @@ mod tests {
     use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
     use ibc_testkit::utils::core::client::dummy_raw_msg_upgrade_client;
 
-    use crate::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
+    use crate::msgs::upgrade_client::MsgUpgradeClient;
 
     #[test]
     fn msg_upgrade_client_serialization() {
diff --git a/ibc-core/ics02-client/types/src/status.rs b/ibc-core/ics02-client/types/src/status.rs
new file mode 100644
index 000000000..b15ed61e7
--- /dev/null
+++ b/ibc-core/ics02-client/types/src/status.rs
@@ -0,0 +1,47 @@
+use core::fmt::{Debug, Display, Formatter};
+
+/// `UpdateKind` represents the 2 ways that a client can be updated
+/// in IBC: either through a `MsgUpdateClient`, or a `MsgSubmitMisbehaviour`.
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub enum UpdateKind {
+    /// this is the typical scenario where a new header is submitted to the client
+    /// to update the client. Note that light clients are free to define the type
+    /// of the object used to update them (e.g. could be a list of headers).
+    UpdateClient,
+    /// this is the scenario where misbehaviour is submitted to the client
+    /// (e.g 2 headers with the same height in Tendermint)
+    SubmitMisbehaviour,
+}
+
+/// Represents the status of a client
+#[derive(Debug, PartialEq, Eq)]
+pub enum Status {
+    /// The client is active and allowed to be used
+    Active,
+    /// The client is frozen and not allowed to be used
+    Frozen,
+    /// The client is expired and not allowed to be used
+    Expired,
+    /// Unauthorized indicates that the client type is not registered as an allowed client type.
+    Unauthorized,
+}
+
+impl Status {
+    pub fn is_active(&self) -> bool {
+        *self == Status::Active
+    }
+
+    pub fn is_frozen(&self) -> bool {
+        *self == Status::Frozen
+    }
+
+    pub fn is_expired(&self) -> bool {
+        *self == Status::Expired
+    }
+}
+
+impl Display for Status {
+    fn fmt(&self, f: &mut Formatter<'_>) -> core::fmt::Result {
+        write!(f, "{self:?}")
+    }
+}
diff --git a/ibc-core/ics03-connection/Cargo.toml b/ibc-core/ics03-connection/Cargo.toml
new file mode 100644
index 000000000..56f51110e
--- /dev/null
+++ b/ibc-core/ics03-connection/Cargo.toml
@@ -0,0 +1,68 @@
+[package]
+name         = "ibc-core-connection"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "connection"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of the ICS-03 Connection Semantics and 
+    re-exports essential data structures and domain types from `ibc-core-connection-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+prost = { workspace = true }
+
+# ibc dependencies
+ibc-core-client           = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-host             = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "prost/std",
+    "ibc-core-client/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-host/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "ibc-core-client/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "ibc-core-client/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-host/schema",
+    "ibc-primitives/schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "ibc-core-client/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "ibc-core-client/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/crates/ibc/src/core/ics03_connection/delay.rs b/ibc-core/ics03-connection/src/delay.rs
similarity index 87%
rename from crates/ibc/src/core/ics03_connection/delay.rs
rename to ibc-core/ics03-connection/src/delay.rs
index 9b3865fac..d573a6eac 100644
--- a/crates/ibc/src/core/ics03_connection/delay.rs
+++ b/ibc-core/ics03-connection/src/delay.rs
@@ -1,8 +1,9 @@
-use super::connection::ConnectionEnd;
-use super::error::ConnectionError;
-use crate::core::ics02_client::height::Height;
-use crate::core::ics02_client::ClientValidationContext;
-use crate::core::{ContextError, ValidationContext};
+use ibc_core_client::context::ClientValidationContext;
+use ibc_core_client::types::Height;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_connection_types::ConnectionEnd;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host::ValidationContext;
 
 pub fn verify_conn_delay_passed<Ctx>(
     ctx: &Ctx,
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
similarity index 79%
rename from crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
rename to ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index cdc137d66..af44a4ee9 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -1,25 +1,22 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenAck`.
 
-use ibc_proto::Protobuf;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_connection_types::events::OpenAck;
+use ibc_core_connection_types::msgs::MsgConnectionOpenAck;
+use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::{ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
 use prost::Message;
 
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::events::OpenAck;
-use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::ics24_host::path::{
-    ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
-};
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
+pub fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -68,8 +65,12 @@ where
         }
         client_state_of_b_on_a.validate_proof_height(msg.proofs_height_on_b)?;
 
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(vars.client_id_on_a(), &msg.proofs_height_on_b);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            vars.client_id_on_a().clone(),
+            msg.proofs_height_on_b.revision_number(),
+            msg.proofs_height_on_b.revision_height(),
+        );
+
         let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
 
         let prefix_on_a = ctx_a.commitment_prefix();
@@ -115,8 +116,11 @@ where
         let expected_consensus_state_of_a_on_b =
             ctx_a.host_consensus_state(&msg.consensus_height_of_a_on_b)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(vars.client_id_on_b(), &msg.consensus_height_of_a_on_b);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            vars.client_id_on_b().clone(),
+            msg.consensus_height_of_a_on_b.revision_number(),
+            msg.consensus_height_of_a_on_b.revision_height(),
+        );
 
         client_state_of_b_on_a
             .verify_membership(
@@ -135,7 +139,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx_a: &mut Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx_a: &mut Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
similarity index 77%
rename from crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
rename to ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
index 83392ff6d..a6a53f6e9 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
@@ -1,22 +1,21 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenConfirm`.
 
-use ibc_proto::Protobuf;
-
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::events::OpenConfirm;
-use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{ClientConsensusStatePath, ConnectionPath, Path};
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn validate<Ctx>(ctx_b: &Ctx, msg: &MsgConnectionOpenConfirm) -> Result<(), ContextError>
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_connection_types::events::OpenConfirm;
+use ibc_core_connection_types::msgs::MsgConnectionOpenConfirm;
+use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::{ClientId, ConnectionId};
+use ibc_core_host::types::path::{ClientConsensusStatePath, ConnectionPath, Path};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+
+pub fn validate<Ctx>(ctx_b: &Ctx, msg: &MsgConnectionOpenConfirm) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -55,8 +54,11 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(client_id_on_b, &msg.proof_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            client_id_on_b.clone(),
+            msg.proof_height_on_a.revision_number(),
+            msg.proof_height_on_a.revision_height(),
+        );
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
@@ -88,10 +90,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(
-    ctx_b: &mut Ctx,
-    msg: &MsgConnectionOpenConfirm,
-) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx_b: &mut Ctx, msg: &MsgConnectionOpenConfirm) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
similarity index 72%
rename from crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
rename to ibc-core/ics03-connection/src/handler/conn_open_init.rs
index f1ba3c95a..b7deac746 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_init.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
@@ -1,17 +1,17 @@
 //! Protocol logic specific to ICS3 messages of type `MsgConnectionOpenInit`.
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use crate::core::ics03_connection::events::OpenInit;
-use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-use crate::core::ics24_host::identifier::ConnectionId;
-use crate::core::ics24_host::path::{ClientConnectionPath, ConnectionPath};
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection_types::events::OpenInit;
+use ibc_core_connection_types::msgs::MsgConnectionOpenInit;
+use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::ConnectionId;
+use ibc_core_host::types::path::{ClientConnectionPath, ConnectionPath};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
 
-pub(crate) fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenInit) -> Result<(), ContextError>
+pub fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenInit) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -35,7 +35,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx_a: &mut Ctx, msg: MsgConnectionOpenInit) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx_a: &mut Ctx, msg: MsgConnectionOpenInit) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
similarity index 80%
rename from crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
rename to ibc-core/ics03-connection/src/handler/conn_open_try.rs
index 965cd4b0d..6d70604f9 100644
--- a/crates/ibc/src/core/ics03_connection/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -1,25 +1,23 @@
-//! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.
-
-use ibc_proto::Protobuf;
-use prost::Message;
-
-use crate::core::context::ContextError;
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::events::OpenTry;
-use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{
+//! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_connection_types::events::OpenTry;
+use ibc_core_connection_types::msgs::MsgConnectionOpenTry;
+use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::{ClientId, ConnectionId};
+use ibc_core_host::types::path::{
     ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
 };
-use crate::core::{ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+use prost::Message;
 
-pub(crate) fn validate<Ctx>(ctx_b: &Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
+pub fn validate<Ctx>(ctx_b: &Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -66,8 +64,12 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proofs_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(&msg.client_id_on_b, &msg.proofs_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            msg.client_id_on_b.clone(),
+            msg.proofs_height_on_a.revision_number(),
+            msg.proofs_height_on_a.revision_height(),
+        );
+
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let prefix_on_a = vars.conn_end_on_b.counterparty().prefix();
@@ -109,8 +111,11 @@ where
         let expected_consensus_state_of_b_on_a =
             ctx_b.host_consensus_state(&msg.consensus_height_of_b_on_a)?;
 
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(client_id_on_a, &msg.consensus_height_of_b_on_a);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            client_id_on_a.clone(),
+            msg.consensus_height_of_b_on_a.revision_number(),
+            msg.consensus_height_of_b_on_a.revision_height(),
+        );
 
         client_state_of_a_on_b
             .verify_membership(
@@ -129,7 +134,7 @@ where
     Ok(())
 }
 
-pub(crate) fn execute<Ctx>(ctx_b: &mut Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
+pub fn execute<Ctx>(ctx_b: &mut Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/mod.rs b/ibc-core/ics03-connection/src/handler/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/core/ics03_connection/mod.rs
rename to ibc-core/ics03-connection/src/handler/mod.rs
diff --git a/ibc-core/ics03-connection/src/lib.rs b/ibc-core/ics03-connection/src/lib.rs
new file mode 100644
index 000000000..0892189d1
--- /dev/null
+++ b/ibc-core/ics03-connection/src/lib.rs
@@ -0,0 +1,26 @@
+//! ICS-03: Connection Semantics implementation to process connection open
+//! handshake. Exports data structures and implementations of IBC core
+//! connection module.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod delay;
+pub mod handler;
+
+/// Re-exports ICS-03 data structures from the `ibc-core-connection-types` crate
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_connection_types::*;
+}
diff --git a/ibc-core/ics03-connection/types/Cargo.toml b/ibc-core/ics03-connection/types/Cargo.toml
new file mode 100644
index 000000000..f34d459bb
--- /dev/null
+++ b/ibc-core/ics03-connection/types/Cargo.toml
@@ -0,0 +1,95 @@
+[package]
+name         = "ibc-core-connection-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "connection", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-03 Connection Semantics data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "subtle-encoding/std",
+    "serde/std",
+    "ibc-core-client-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "tendermint/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core-client-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/crates/ibc/src/core/ics03_connection/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
similarity index 97%
rename from crates/ibc/src/core/ics03_connection/connection.rs
rename to ibc-core/ics03-connection/types/src/connection.rs
index ae989a9a0..2af44ec5f 100644
--- a/crates/ibc/src/core/ics03_connection/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -4,19 +4,19 @@ use core::fmt::{Display, Error as FmtError, Formatter};
 use core::time::Duration;
 use core::u64;
 
+use ibc_core_client_types::error::ClientError;
+use ibc_core_commitment_types::commitment::CommitmentPrefix;
+use ibc_core_host_types::identifiers::{ClientId, ConnectionId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::ZERO_DURATION;
 use ibc_proto::ibc::core::connection::v1::{
     ConnectionEnd as RawConnectionEnd, Counterparty as RawCounterparty,
     IdentifiedConnection as RawIdentifiedConnection,
 };
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::version::Version;
-use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::timestamp::ZERO_DURATION;
-use crate::prelude::*;
+use crate::error::ConnectionError;
+use crate::version::Version;
 
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/crates/ibc/src/core/ics03_connection/error.rs b/ibc-core/ics03-connection/types/src/error.rs
similarity index 92%
rename from crates/ibc/src/core/ics03_connection/error.rs
rename to ibc-core/ics03-connection/types/src/error.rs
index db7e95dd8..b9cb0460b 100644
--- a/crates/ibc/src/core/ics03_connection/error.rs
+++ b/ibc-core/ics03-connection/types/src/error.rs
@@ -1,14 +1,13 @@
 //! Defines the connection error type
 
-use alloc::string::String;
-
 use displaydoc::Display;
+use ibc_core_client_types::{error as client_error, Height};
+use ibc_core_host_types::error::IdentifierError;
+use ibc_core_host_types::identifiers::{ClientId, ConnectionId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Timestamp, TimestampOverflowError};
 
-use crate::core::ics02_client::error as client_error;
-use crate::core::ics03_connection::version::Version;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId, IdentifierError};
-use crate::core::timestamp::{Timestamp, TimestampOverflowError};
-use crate::Height;
+use crate::version::Version;
 
 #[derive(Debug, Display)]
 pub enum ConnectionError {
diff --git a/crates/ibc/src/core/ics03_connection/events.rs b/ibc-core/ics03-connection/types/src/events.rs
similarity index 98%
rename from crates/ibc/src/core/ics03_connection/events.rs
rename to ibc-core/ics03-connection/types/src/events.rs
index dcc0f38f9..4b6ef6df0 100644
--- a/crates/ibc/src/core/ics03_connection/events.rs
+++ b/ibc-core/ics03-connection/types/src/events.rs
@@ -1,10 +1,9 @@
 //! Types for the IBC events emitted from Tendermint Websocket by the connection module.
 
+use ibc_core_host_types::identifiers::{ClientId, ConnectionId};
+use ibc_primitives::prelude::*;
 use tendermint::abci;
 
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::prelude::*;
-
 /// Connection event types
 const CONNECTION_OPEN_INIT_EVENT: &str = "connection_open_init";
 const CONNECTION_OPEN_TRY_EVENT: &str = "connection_open_try";
@@ -306,12 +305,12 @@ impl From<OpenConfirm> for abci::Event {
 #[cfg(test)]
 mod tests {
 
-    use std::str::FromStr;
+    use core::str::FromStr;
 
+    use ibc_core_host_types::identifiers::ClientType;
     use tendermint::abci::Event as AbciEvent;
 
     use super::*;
-    use crate::core::ics02_client::client_type::ClientType;
 
     #[test]
     fn ibc_to_abci_connection_events() {
diff --git a/ibc-core/ics03-connection/types/src/lib.rs b/ibc-core/ics03-connection/types/src/lib.rs
new file mode 100644
index 000000000..345e7eee1
--- /dev/null
+++ b/ibc-core/ics03-connection/types/src/lib.rs
@@ -0,0 +1,29 @@
+//! Implementation of the Connection Semantics (ICS-03) data structures.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+mod connection;
+pub use connection::*;
+
+pub mod error;
+pub mod events;
+pub mod msgs;
+pub mod version;
+
+/// Re-exports ICS-03 proto types from the `ibc-proto` crate for added
+/// convenience
+pub mod proto {
+    pub use ibc_proto::ibc::core::connection::*;
+}
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
similarity index 93%
rename from crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
rename to ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
index cbdbbfcba..3ba244ed9 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
@@ -1,17 +1,16 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::ConnectionId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
 use ibc_proto::Protobuf;
 
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::version::Version;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::ConnectionId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::ConnectionError;
+use crate::version::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenAck";
+pub const CONN_OPEN_ACK_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenAck";
 
 /// Per our convention, this message is sent to chain A.
 /// The handler will check proofs of chain B.
@@ -49,7 +48,7 @@ impl Msg for MsgConnectionOpenAck {
     type Raw = RawMsgConnectionOpenAck;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CONN_OPEN_ACK_TYPE_URL.to_string()
     }
 }
 
@@ -132,13 +131,12 @@ impl From<MsgConnectionOpenAck> for RawMsgConnectionOpenAck {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
     use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_ack;
-    use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-    use crate::prelude::*;
+    use crate::msgs::conn_open_ack::MsgConnectionOpenAck;
 
     #[test]
     fn parse_connection_open_ack_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
similarity index 89%
rename from crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
rename to ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
index 5a1200c78..545805c37 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
@@ -1,15 +1,14 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::ConnectionId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
 use ibc_proto::Protobuf;
 
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::ConnectionId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::ConnectionError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenConfirm";
+pub const CONN_OPEN_CONFIRM_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenConfirm";
 
 /// Per our convention, this message is sent to chain B.
 /// The handler will check proofs of chain A.
@@ -33,7 +32,7 @@ impl Msg for MsgConnectionOpenConfirm {
     type Raw = RawMsgConnectionOpenConfirm;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CONN_OPEN_CONFIRM_TYPE_URL.to_string()
     }
 }
 
@@ -74,13 +73,12 @@ impl From<MsgConnectionOpenConfirm> for RawMsgConnectionOpenConfirm {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
     use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_confirm;
-    use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-    use crate::prelude::*;
+    use crate::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
 
     #[test]
     fn parse_connection_open_confirm_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
similarity index 94%
rename from crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
rename to ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
index d0fd2572a..1638fc8ae 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_init.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
@@ -1,17 +1,16 @@
 use core::time::Duration;
 
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenInit as RawMsgConnectionOpenInit;
 use ibc_proto::Protobuf;
 
-use crate::core::ics03_connection::connection::Counterparty;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::version::Version;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::connection::Counterparty;
+use crate::error::ConnectionError;
+use crate::version::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenInit";
+pub const CONN_OPEN_INIT_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenInit";
 
 /// Per our convention, this message is sent to chain A.
 /// The handler will check proofs of chain B.
@@ -30,7 +29,7 @@ impl Msg for MsgConnectionOpenInit {
     type Raw = RawMsgConnectionOpenInit;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CONN_OPEN_INIT_TYPE_URL.to_string()
     }
 }
 
@@ -130,16 +129,15 @@ impl From<MsgConnectionOpenInit> for RawMsgConnectionOpenInit {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::connection::v1::{
         Counterparty as RawCounterparty, MsgConnectionOpenInit as RawMsgConnectionOpenInit,
     };
     use ibc_testkit::utils::core::connection::{
         dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_init,
     };
-    use test_log::test;
 
     use super::MsgConnectionOpenInit;
-    use crate::prelude::*;
 
     #[test]
     fn parse_connection_open_init_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
similarity index 96%
rename from crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
rename to ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
index ab778f2e3..4999f54c4 100644
--- a/crates/ibc/src/core/ics03_connection/msgs/conn_open_try.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
@@ -1,21 +1,20 @@
 use core::convert::{TryFrom, TryInto};
 use core::time::Duration;
 
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
 use ibc_proto::Protobuf;
 
-use crate::core::ics03_connection::connection::Counterparty;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::version::Version;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::ClientId;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::connection::Counterparty;
+use crate::error::ConnectionError;
+use crate::version::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenTry";
+pub const CONN_OPEN_TRY_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionOpenTry";
 
 /// Per our convention, this message is sent to chain B.
 /// The handler will check proofs of chain A.
@@ -55,7 +54,7 @@ impl Msg for MsgConnectionOpenTry {
     type Raw = RawMsgConnectionOpenTry;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CONN_OPEN_TRY_TYPE_URL.to_string()
     }
 }
 #[allow(deprecated)]
@@ -244,6 +243,7 @@ impl From<MsgConnectionOpenTry> for RawMsgConnectionOpenTry {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_proto::ibc::core::connection::v1::{
         Counterparty as RawCounterparty, MsgConnectionOpenTry as RawMsgConnectionOpenTry,
@@ -251,10 +251,8 @@ mod tests {
     use ibc_testkit::utils::core::connection::{
         dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_try,
     };
-    use test_log::test;
 
-    use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-    use crate::prelude::*;
+    use crate::msgs::conn_open_try::MsgConnectionOpenTry;
 
     #[test]
     fn parse_connection_open_try_msg() {
diff --git a/crates/ibc/src/core/ics03_connection/msgs.rs b/ibc-core/ics03-connection/types/src/msgs/mod.rs
similarity index 75%
rename from crates/ibc/src/core/ics03_connection/msgs.rs
rename to ibc-core/ics03-connection/types/src/msgs/mod.rs
index f80617d82..406001e36 100644
--- a/crates/ibc/src/core/ics03_connection/msgs.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/mod.rs
@@ -12,16 +12,17 @@
 //! Another difference to ICS3 specs is that each message comprises an additional field called
 //! `signer` which is specific to Cosmos-SDK.
 
-use crate::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-use crate::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-use crate::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-use crate::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-use crate::prelude::*;
+use ibc_primitives::prelude::*;
 
-pub mod conn_open_ack;
-pub mod conn_open_confirm;
-pub mod conn_open_init;
-pub mod conn_open_try;
+mod conn_open_ack;
+mod conn_open_confirm;
+mod conn_open_init;
+mod conn_open_try;
+
+pub use conn_open_ack::*;
+pub use conn_open_confirm::*;
+pub use conn_open_init::*;
+pub use conn_open_try::*;
 
 /// Enumeration of all possible messages that the ICS3 protocol processes.
 #[cfg_attr(
diff --git a/crates/ibc/src/core/ics03_connection/version.rs b/ibc-core/ics03-connection/types/src/version.rs
similarity index 95%
rename from crates/ibc/src/core/ics03_connection/version.rs
rename to ibc-core/ics03-connection/types/src/version.rs
index 2052bb12c..46029c68c 100644
--- a/crates/ibc/src/core/ics03_connection/version.rs
+++ b/ibc-core/ics03-connection/types/src/version.rs
@@ -2,13 +2,12 @@
 
 use core::fmt::Display;
 
+use ibc_primitives::prelude::*;
+use ibc_primitives::utils::PrettySlice;
 use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
 use ibc_proto::Protobuf;
 
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics04_channel::channel::Order;
-use crate::prelude::*;
-use crate::utils::pretty::PrettySlice;
+use crate::error::ConnectionError;
 
 /// Stores the identifier and the features supported by a version
 #[cfg_attr(
@@ -94,10 +93,7 @@ impl Default for Version {
     fn default() -> Self {
         Version {
             identifier: "1".to_string(),
-            features: vec![
-                Order::Ordered.as_str().to_owned(),
-                Order::Unordered.as_str().to_owned(),
-            ],
+            features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
         }
     }
 }
@@ -189,12 +185,11 @@ fn get_feature_set_intersection(
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
-    use test_log::test;
 
-    use crate::core::ics03_connection::error::ConnectionError;
-    use crate::core::ics03_connection::version::{get_compatible_versions, pick_version, Version};
-    use crate::prelude::*;
+    use crate::error::ConnectionError;
+    use crate::version::{get_compatible_versions, pick_version, Version};
 
     fn get_dummy_features() -> Vec<String> {
         vec!["ORDER_RANDOM".to_string(), "ORDER_UNORDERED".to_string()]
diff --git a/ibc-core/ics04-channel/Cargo.toml b/ibc-core/ics04-channel/Cargo.toml
new file mode 100644
index 000000000..f49c7175b
--- /dev/null
+++ b/ibc-core/ics04-channel/Cargo.toml
@@ -0,0 +1,84 @@
+[package]
+name         = "ibc-core-channel"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "channel"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of the ICS-04 Channel & Packet Semantics and 
+    re-exports essential data structures and domain types from `ibc-core-channel-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+prost = { workspace = true }
+
+# ibc dependencies
+ibc-core-client           = { workspace = true }
+ibc-core-connection       = { workspace = true }
+ibc-core-channel-types    = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host             = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-core-router           = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-core-client/std",
+    "ibc-core-connection/std",
+    "ibc-core-channel-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host/std",
+    "ibc-core-handler-types/std",
+    "ibc-core-router/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "ibc-core-client/serde",
+    "ibc-core-connection/serde",
+    "ibc-core-channel-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-core-router/serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "ibc-core-client/schema",
+    "ibc-core-connection/schema",
+    "ibc-core-channel-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-core-router/schema",
+    "ibc-primitives/schema",
+]
+borsh = [
+    "ibc-core-client/borsh",
+    "ibc-core-connection/borsh",
+    "ibc-core-channel-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-core-router/borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "ibc-core-client/parity-scale-codec",
+    "ibc-core-connection/parity-scale-codec",
+    "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-core-router/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/crates/ibc/src/core/ics04_channel/context.rs b/ibc-core/ics04-channel/src/context.rs
similarity index 67%
rename from crates/ibc/src/core/ics04_channel/context.rs
rename to ibc-core/ics04-channel/src/context.rs
index 40c51d3fc..8dcd05fac 100644
--- a/crates/ibc/src/core/ics04_channel/context.rs
+++ b/ibc-core/ics04-channel/src/context.rs
@@ -1,21 +1,19 @@
 //! ICS4 (channel) context.
 
-use core::time::Duration;
-
-use super::packet::Sequence;
-use crate::core::events::IbcEvent;
-use crate::core::ics02_client::client_state::ClientState;
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use crate::core::ics03_connection::connection::ConnectionEnd;
-use crate::core::ics04_channel::channel::ChannelEnd;
-use crate::core::ics04_channel::commitment::PacketCommitment;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::ChannelEnd;
+use ibc_core_channel_types::commitment::PacketCommitment;
+use ibc_core_client::context::client_state::ClientState;
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_connection::types::ConnectionEnd;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::IbcEvent;
+use ibc_core_host::types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc_core_host::types::path::{
     ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
 };
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_primitives::prelude::*;
 
 /// Methods required in send packet validation, to be implemented by the host
 pub trait SendPacketValidationContext {
@@ -135,47 +133,3 @@ where
         self.log_message(message)
     }
 }
-
-pub(crate) fn calculate_block_delay(
-    delay_period_time: &Duration,
-    max_expected_time_per_block: &Duration,
-) -> u64 {
-    let delay_period_time = delay_period_time.as_secs();
-    let max_expected_time_per_block = max_expected_time_per_block.as_secs();
-    if max_expected_time_per_block == 0 {
-        return 0;
-    }
-    if delay_period_time % max_expected_time_per_block == 0 {
-        return delay_period_time / max_expected_time_per_block;
-    }
-    (delay_period_time / max_expected_time_per_block) + 1
-}
-
-#[cfg(test)]
-mod tests {
-
-    use rstest::rstest;
-
-    use super::*;
-
-    #[rstest]
-    #[case::remainder_zero(10, 2, 5)]
-    #[case::remainder_not_zero(10, 3, 4)]
-    #[case::max_expected_zero(10, 0, 0)]
-    #[case::delay_period_zero(0, 2, 0)]
-    #[case::both_zero(0, 0, 0)]
-    #[case::delay_less_than_max(10, 11, 1)]
-    fn test_calculate_block_delay_zero(
-        #[case] delay_period_time: u64,
-        #[case] max_expected_time_per_block: u64,
-        #[case] expected: u64,
-    ) {
-        assert_eq!(
-            calculate_block_delay(
-                &Duration::from_secs(delay_period_time),
-                &Duration::from_secs(max_expected_time_per_block)
-            ),
-            expected
-        );
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
similarity index 84%
rename from crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
rename to ibc-core/ics04-channel/src/handler/acknowledgement.rs
index 4680e86d2..2ae3a39e6 100644
--- a/crates/ibc/src/core/ics04_channel/handler/acknowledgement.rs
+++ b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
@@ -1,22 +1,23 @@
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::{Counterparty, Order, State as ChannelState};
-use crate::core::ics04_channel::commitment::{compute_ack_commitment, compute_packet_commitment};
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::events::AcknowledgePacket;
-use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::{Counterparty, Order, State as ChannelState};
+use ibc_core_channel_types::commitment::{compute_ack_commitment, compute_packet_commitment};
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_channel_types::events::AcknowledgePacket;
+use ibc_core_channel_types::msgs::MsgAcknowledgement;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::delay::verify_conn_delay_passed;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, SeqAckPath,
 };
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
 
-pub(crate) fn acknowledgement_packet_validate<ValCtx>(
+pub fn acknowledgement_packet_validate<ValCtx>(
     ctx_a: &ValCtx,
     module: &dyn Module,
     msg: MsgAcknowledgement,
@@ -31,7 +32,7 @@ where
         .map_err(ContextError::PacketError)
 }
 
-pub(crate) fn acknowledgement_packet_execute<ExecCtx>(
+pub fn acknowledgement_packet_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgAcknowledgement,
@@ -186,8 +187,11 @@ where
         }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(client_id_on_a, &msg.proof_height_on_b);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            client_id_on_a.clone(),
+            msg.proof_height_on_b.revision_number(),
+            msg.proof_height_on_b.revision_height(),
+        );
         let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let ack_commitment = compute_ack_commitment(&msg.acknowledgement);
         let ack_path_on_b =
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
similarity index 81%
rename from crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
rename to ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
index 28ce154d9..30024afd3 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
@@ -1,22 +1,22 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseConfirm`.
 
-use ibc_proto::Protobuf;
-
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::events::CloseConfirm;
-use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn chan_close_confirm_validate<ValCtx>(
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
+use ibc_core_channel_types::error::ChannelError;
+use ibc_core_channel_types::events::CloseConfirm;
+use ibc_core_channel_types::msgs::MsgChannelCloseConfirm;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{ChannelEndPath, ClientConsensusStatePath, Path};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+
+pub fn chan_close_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelCloseConfirm,
@@ -31,7 +31,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_close_confirm_execute<ExecCtx>(
+pub fn chan_close_confirm_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelCloseConfirm,
@@ -124,8 +124,11 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(client_id_on_b, &msg.proof_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            client_id_on_b.clone(),
+            msg.proof_height_on_a.revision_number(),
+            msg.proof_height_on_a.revision_height(),
+        );
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = &chan_end_on_b.counterparty().port_id;
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
similarity index 82%
rename from crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
rename to ibc-core/ics04-channel/src/handler/chan_close_init.rs
index b5856e9f6..a7f03163e 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_close_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
@@ -1,18 +1,19 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelCloseInit`.
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::events::CloseInit;
-use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
-use crate::core::ics24_host::path::ChannelEndPath;
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn chan_close_init_validate<ValCtx>(
+use ibc_core_channel_types::channel::State;
+use ibc_core_channel_types::error::ChannelError;
+use ibc_core_channel_types::events::CloseInit;
+use ibc_core_channel_types::msgs::MsgChannelCloseInit;
+use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::ChannelEndPath;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+
+pub fn chan_close_init_validate<ValCtx>(
     ctx_a: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelCloseInit,
@@ -27,7 +28,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_close_init_execute<ExecCtx>(
+pub fn chan_close_init_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelCloseInit,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
similarity index 80%
rename from crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
rename to ibc-core/ics04-channel/src/handler/chan_open_ack.rs
index 4267437d2..c40fb2561 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
@@ -1,22 +1,21 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenAck`.
-
-use ibc_proto::Protobuf;
-
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::events::OpenAck;
-use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn chan_open_ack_validate<ValCtx>(
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
+use ibc_core_channel_types::error::ChannelError;
+use ibc_core_channel_types::events::OpenAck;
+use ibc_core_channel_types::msgs::MsgChannelOpenAck;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{ChannelEndPath, ClientConsensusStatePath, Path};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+
+pub fn chan_open_ack_validate<ValCtx>(
     ctx_a: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelOpenAck,
@@ -31,7 +30,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_open_ack_execute<ExecCtx>(
+pub fn chan_open_ack_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelOpenAck,
@@ -122,8 +121,11 @@ where
         }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(client_id_on_a, &msg.proof_height_on_b);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            client_id_on_a.clone(),
+            msg.proof_height_on_b.revision_number(),
+            msg.proof_height_on_b.revision_height(),
+        );
         let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let prefix_on_b = conn_end_on_a.counterparty().prefix();
         let port_id_on_b = &chan_end_on_a.counterparty().port_id;
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
similarity index 81%
rename from crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
rename to ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
index 7e5ecf93b..5ef8bd769 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
@@ -1,22 +1,22 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenConfirm`.
 
-use ibc_proto::Protobuf;
-
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::events::OpenConfirm;
-use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-use crate::core::ics24_host::path::{ChannelEndPath, ClientConsensusStatePath, Path};
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn chan_open_confirm_validate<ValCtx>(
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
+use ibc_core_channel_types::error::ChannelError;
+use ibc_core_channel_types::events::OpenConfirm;
+use ibc_core_channel_types::msgs::MsgChannelOpenConfirm;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{ChannelEndPath, ClientConsensusStatePath, Path};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+
+pub fn chan_open_confirm_validate<ValCtx>(
     ctx_b: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelOpenConfirm,
@@ -31,7 +31,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_open_confirm_execute<ExecCtx>(
+pub fn chan_open_confirm_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelOpenConfirm,
@@ -126,8 +126,11 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(client_id_on_b, &msg.proof_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            client_id_on_b.clone(),
+            msg.proof_height_on_a.revision_number(),
+            msg.proof_height_on_a.revision_height(),
+        );
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = &chan_end_on_b.counterparty().port_id;
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
similarity index 83%
rename from crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
rename to ibc-core/ics04-channel/src/handler/chan_open_init.rs
index 17dc77df3..31f74ce0c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
@@ -1,18 +1,19 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenInit`.
 
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::ClientStateValidation;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State};
-use crate::core::ics04_channel::events::OpenInit;
-use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-use crate::core::ics24_host::identifier::ChannelId;
-use crate::core::ics24_host::path::{ChannelEndPath, SeqAckPath, SeqRecvPath, SeqSendPath};
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
-
-pub(crate) fn chan_open_init_validate<ValCtx>(
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State};
+use ibc_core_channel_types::events::OpenInit;
+use ibc_core_channel_types::msgs::MsgChannelOpenInit;
+use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::ChannelId;
+use ibc_core_host::types::path::{ChannelEndPath, SeqAckPath, SeqRecvPath, SeqSendPath};
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+
+pub fn chan_open_init_validate<ValCtx>(
     ctx_a: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelOpenInit,
@@ -35,7 +36,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_open_init_execute<ExecCtx>(
+pub fn chan_open_init_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelOpenInit,
diff --git a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
similarity index 82%
rename from crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
rename to ibc-core/ics04-channel/src/handler/chan_open_try.rs
index ff27b0eff..cbc9ec590 100644
--- a/crates/ibc/src/core/ics04_channel/handler/chan_open_try.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
@@ -1,25 +1,25 @@
 //! Protocol logic specific to ICS4 messages of type `MsgChannelOpenTry`.
 
-use ibc_proto::Protobuf;
-
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, State, State as ChannelState};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::events::OpenTry;
-use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-use crate::core::ics24_host::identifier::ChannelId;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State as ChannelState};
+use ibc_core_channel_types::error::ChannelError;
+use ibc_core_channel_types::events::OpenTry;
+use ibc_core_channel_types::msgs::MsgChannelOpenTry;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::identifiers::ChannelId;
+use ibc_core_host::types::path::{
     ChannelEndPath, ClientConsensusStatePath, Path, SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
 
-pub(crate) fn chan_open_try_validate<ValCtx>(
+pub fn chan_open_try_validate<ValCtx>(
     ctx_b: &ValCtx,
     module: &dyn Module,
     msg: MsgChannelOpenTry,
@@ -43,7 +43,7 @@ where
     Ok(())
 }
 
-pub(crate) fn chan_open_try_execute<ExecCtx>(
+pub fn chan_open_try_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgChannelOpenTry,
@@ -66,7 +66,7 @@ where
     // state changes
     {
         let chan_end_on_b = ChannelEnd::new(
-            State::TryOpen,
+            ChannelState::TryOpen,
             msg.ordering,
             Counterparty::new(msg.port_id_on_a.clone(), Some(msg.chan_id_on_a.clone())),
             msg.connection_hops_on_b.clone(),
@@ -147,8 +147,11 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(client_id_on_b, &msg.proof_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            client_id_on_b.clone(),
+            msg.proof_height_on_a.revision_number(),
+            msg.proof_height_on_a.revision_height(),
+        );
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = msg.port_id_on_a.clone();
diff --git a/ibc-core/ics04-channel/src/handler/mod.rs b/ibc-core/ics04-channel/src/handler/mod.rs
new file mode 100644
index 000000000..b1ea237a1
--- /dev/null
+++ b/ibc-core/ics04-channel/src/handler/mod.rs
@@ -0,0 +1,24 @@
+//! This module implements the processing logic for ICS4 (channel) messages.
+mod acknowledgement;
+mod chan_close_confirm;
+mod chan_close_init;
+mod chan_open_ack;
+mod chan_open_confirm;
+mod chan_open_init;
+mod chan_open_try;
+mod recv_packet;
+mod send_packet;
+mod timeout;
+mod timeout_on_close;
+
+pub use acknowledgement::*;
+pub use chan_close_confirm::*;
+pub use chan_close_init::*;
+pub use chan_open_ack::*;
+pub use chan_open_confirm::*;
+pub use chan_open_init::*;
+pub use chan_open_try::*;
+pub use recv_packet::*;
+pub use send_packet::*;
+pub use timeout::*;
+pub use timeout_on_close::*;
diff --git a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs b/ibc-core/ics04-channel/src/handler/recv_packet.rs
similarity index 86%
rename from crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
rename to ibc-core/ics04-channel/src/handler/recv_packet.rs
index f99d184a1..cc59d9100 100644
--- a/crates/ibc/src/core/ics04_channel/handler/recv_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/recv_packet.rs
@@ -1,28 +1,26 @@
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::State as ConnectionState;
-use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::{Counterparty, Order, State as ChannelState};
-use crate::core::ics04_channel::commitment::{compute_ack_commitment, compute_packet_commitment};
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::events::{ReceivePacket, WriteAcknowledgement};
-use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-use crate::core::ics04_channel::packet::Receipt;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::{Counterparty, Order, State as ChannelState};
+use ibc_core_channel_types::commitment::{compute_ack_commitment, compute_packet_commitment};
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_channel_types::events::{ReceivePacket, WriteAcknowledgement};
+use ibc_core_channel_types::msgs::MsgRecvPacket;
+use ibc_core_channel_types::packet::Receipt;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::delay::verify_conn_delay_passed;
+use ibc_core_connection::types::State as ConnectionState;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath,
     SeqRecvPath,
 };
-use crate::core::router::Module;
-use crate::core::timestamp::Expiry;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Expiry;
 
-pub(crate) fn recv_packet_validate<ValCtx>(
-    ctx_b: &ValCtx,
-    msg: MsgRecvPacket,
-) -> Result<(), ContextError>
+pub fn recv_packet_validate<ValCtx>(ctx_b: &ValCtx, msg: MsgRecvPacket) -> Result<(), ContextError>
 where
     ValCtx: ValidationContext,
 {
@@ -33,7 +31,7 @@ where
     // If any error occurs, then an "error acknowledgement" must be returned.
 }
 
-pub(crate) fn recv_packet_execute<ExecCtx>(
+pub fn recv_packet_execute<ExecCtx>(
     ctx_b: &mut ExecCtx,
     module: &mut dyn Module,
     msg: MsgRecvPacket,
@@ -193,8 +191,12 @@ where
         }
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
-        let client_cons_state_path_on_b =
-            ClientConsensusStatePath::new(client_id_on_b, &msg.proof_height_on_a);
+        let client_cons_state_path_on_b = ClientConsensusStatePath::new(
+            client_id_on_b.clone(),
+            msg.proof_height_on_a.revision_number(),
+            msg.proof_height_on_a.revision_height(),
+        );
+
         let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let expected_commitment_on_a = compute_packet_commitment(
diff --git a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs b/ibc-core/ics04-channel/src/handler/send_packet.rs
similarity index 81%
rename from crates/ibc/src/core/ics04_channel/handler/send_packet.rs
rename to ibc-core/ics04-channel/src/handler/send_packet.rs
index 4a9134f57..da97c51c2 100644
--- a/crates/ibc/src/core/ics04_channel/handler/send_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/send_packet.rs
@@ -1,21 +1,20 @@
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics04_channel::channel::Counterparty;
-use crate::core::ics04_channel::commitment::compute_packet_commitment;
-use crate::core::ics04_channel::context::{
-    SendPacketExecutionContext, SendPacketValidationContext,
-};
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::events::SendPacket;
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::Counterparty;
+use ibc_core_channel_types::commitment::compute_packet_commitment;
+use ibc_core_channel_types::error::PacketError;
+use ibc_core_channel_types::events::SendPacket;
+use ibc_core_channel_types::packet::Packet;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{
     ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
 };
-use crate::core::timestamp::Expiry;
-use crate::core::ContextError;
-use crate::prelude::*;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Expiry;
+
+use crate::context::{SendPacketExecutionContext, SendPacketValidationContext};
 
 /// Send the given packet, including all necessary validation.
 ///
@@ -73,8 +72,11 @@ pub fn send_packet_validate(
         .into());
     }
 
-    let client_cons_state_path_on_a =
-        ClientConsensusStatePath::new(client_id_on_a, &latest_height_on_a);
+    let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+        client_id_on_a.clone(),
+        latest_height_on_a.revision_number(),
+        latest_height_on_a.revision_height(),
+    );
     let consensus_state_of_b_on_a = ctx_a.client_consensus_state(&client_cons_state_path_on_a)?;
     let latest_timestamp = consensus_state_of_b_on_a.timestamp();
     let packet_timestamp = packet.timeout_timestamp_on_b;
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
similarity index 87%
rename from crates/ibc/src/core/ics04_channel/handler/timeout.rs
rename to ibc-core/ics04-channel/src/handler/timeout.rs
index 5235f9a8c..28cfd6587 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -1,30 +1,30 @@
-use prost::Message;
-
-use crate::core::events::{IbcEvent, MessageEvent};
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::{Counterparty, Order, State};
-use crate::core::ics04_channel::commitment::compute_packet_commitment;
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::events::{ChannelClosed, TimeoutPacket};
-use crate::core::ics04_channel::handler::timeout_on_close;
-use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
-use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::{Counterparty, Order, State};
+use ibc_core_channel_types::commitment::compute_packet_commitment;
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_channel_types::events::{ChannelClosed, TimeoutPacket};
+use ibc_core_channel_types::msgs::{MsgTimeout, MsgTimeoutOnClose};
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::delay::verify_conn_delay_passed;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
+use ibc_core_host::types::path::{
     ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath, SeqRecvPath,
 };
-use crate::core::router::Module;
-use crate::core::{ContextError, ExecutionContext, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::module::Module;
+use ibc_primitives::prelude::*;
+use prost::Message;
+
+use super::timeout_on_close;
 
-pub(crate) enum TimeoutMsgType {
+pub enum TimeoutMsgType {
     Timeout(MsgTimeout),
     TimeoutOnClose(MsgTimeoutOnClose),
 }
 
-pub(crate) fn timeout_packet_validate<ValCtx>(
+pub fn timeout_packet_validate<ValCtx>(
     ctx_a: &ValCtx,
     module: &dyn Module,
     timeout_msg_type: TimeoutMsgType,
@@ -47,7 +47,7 @@ where
         .map_err(ContextError::PacketError)
 }
 
-pub(crate) fn timeout_packet_execute<ExecCtx>(
+pub fn timeout_packet_execute<ExecCtx>(
     ctx_a: &mut ExecCtx,
     module: &mut dyn Module,
     timeout_msg_type: TimeoutMsgType,
@@ -200,8 +200,11 @@ where
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         // check that timeout height or timeout timestamp has passed on the other end
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(client_id_on_a, &msg.proof_height_on_b);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            client_id_on_a.clone(),
+            msg.proof_height_on_b.revision_number(),
+            msg.proof_height_on_b.revision_height(),
+        );
         let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let timestamp_of_b = consensus_state_of_b_on_a.timestamp();
 
diff --git a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
similarity index 86%
rename from crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
rename to ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index cb0a9b40a..641f0483c 100644
--- a/crates/ibc/src/core/ics04_channel/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -1,19 +1,19 @@
-use ibc_proto::Protobuf;
-use prost::Message;
-
-use crate::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::delay::verify_conn_delay_passed;
-use crate::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use crate::core::ics04_channel::commitment::compute_packet_commitment;
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use crate::core::ics24_host::path::{
+use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc_core_channel_types::commitment::compute_packet_commitment;
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_channel_types::msgs::MsgTimeoutOnClose;
+use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_connection::delay::verify_conn_delay_passed;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host::types::path::{
     ChannelEndPath, ClientConsensusStatePath, CommitmentPath, Path, ReceiptPath, SeqRecvPath,
 };
-use crate::core::{ContextError, ValidationContext};
-use crate::prelude::*;
+use ibc_core_host::ValidationContext;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
+use prost::Message;
 
 pub fn validate<Ctx>(ctx_a: &Ctx, msg: &MsgTimeoutOnClose) -> Result<(), ContextError>
 where
@@ -78,8 +78,11 @@ where
         }
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
-        let client_cons_state_path_on_a =
-            ClientConsensusStatePath::new(client_id_on_a, &msg.proof_height_on_b);
+        let client_cons_state_path_on_a = ClientConsensusStatePath::new(
+            client_id_on_a.clone(),
+            msg.proof_height_on_b.revision_number(),
+            msg.proof_height_on_b.revision_height(),
+        );
         let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let prefix_on_b = conn_end_on_a.counterparty().prefix();
         let port_id_on_b = chan_end_on_a.counterparty().port_id.clone();
diff --git a/ibc-core/ics04-channel/src/lib.rs b/ibc-core/ics04-channel/src/lib.rs
new file mode 100644
index 000000000..1ccb4f25c
--- /dev/null
+++ b/ibc-core/ics04-channel/src/lib.rs
@@ -0,0 +1,26 @@
+//! ICS-04: Channel and Packet Semantics implementation to process channel open
+//! handshake and incoming data packets. Exports data structures and
+//! implementations of IBC core channel module.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod context;
+pub mod handler;
+
+/// Re-exports ICS-04 data structures from the `ibc-core-channel-types` crate.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_channel_types::*;
+}
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
new file mode 100644
index 000000000..b19aa13df
--- /dev/null
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -0,0 +1,101 @@
+[package]
+name         = "ibc-core-channel-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "channel", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-4 Channel Semantics data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+sha2            = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "sha2/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-core-client-types/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "tendermint/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core-client-types/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/crates/ibc/src/core/ics04_channel/acknowledgement.rs b/ibc-core/ics04-channel/types/src/acknowledgement.rs
similarity index 64%
rename from crates/ibc/src/core/ics04_channel/acknowledgement.rs
rename to ibc-core/ics04-channel/types/src/acknowledgement.rs
index c7a91c754..b30f14454 100644
--- a/crates/ibc/src/core/ics04_channel/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/acknowledgement.rs
@@ -3,9 +3,9 @@
 use core::fmt::{Display, Error as FmtError, Formatter};
 
 use derive_more::Into;
+use ibc_primitives::prelude::*;
 
 use super::error::PacketError;
-use crate::prelude::*;
 
 /// A generic Acknowledgement type that modules may interpret as they like.
 ///
@@ -140,71 +140,3 @@ impl From<AcknowledgementStatus> for Acknowledgement {
             .expect("token transfer internal error: ack is never supposed to be empty")
     }
 }
-
-#[cfg(test)]
-mod test {
-    use super::*;
-    use crate::applications::transfer::ack_success_b64;
-    use crate::applications::transfer::error::TokenTransferError;
-
-    #[test]
-    fn test_ack_ser() {
-        fn ser_json_assert_eq(ack: AcknowledgementStatus, json_str: &str) {
-            let ser = serde_json::to_string(&ack).unwrap();
-            assert_eq!(ser, json_str)
-        }
-
-        ser_json_assert_eq(
-            AcknowledgementStatus::success(ack_success_b64()),
-            r#"{"result":"AQ=="}"#,
-        );
-        ser_json_assert_eq(
-            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into()),
-            r#"{"error":"failed to deserialize packet data"}"#,
-        );
-    }
-
-    #[test]
-    fn test_ack_success_to_vec() {
-        let ack_success: Vec<u8> = AcknowledgementStatus::success(ack_success_b64()).into();
-
-        // Check that it's the same output as ibc-go
-        // Note: this also implicitly checks that the ack bytes are non-empty,
-        // which would make the conversion to `Acknowledgement` panic
-        assert_eq!(ack_success, r#"{"result":"AQ=="}"#.as_bytes());
-    }
-
-    #[test]
-    fn test_ack_error_to_vec() {
-        let ack_error: Vec<u8> =
-            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into())
-                .into();
-
-        // Check that it's the same output as ibc-go
-        // Note: this also implicitly checks that the ack bytes are non-empty,
-        // which would make the conversion to `Acknowledgement` panic
-        assert_eq!(
-            ack_error,
-            r#"{"error":"failed to deserialize packet data"}"#.as_bytes()
-        );
-    }
-
-    #[test]
-    fn test_ack_de() {
-        fn de_json_assert_eq(json_str: &str, ack: AcknowledgementStatus) {
-            let de = serde_json::from_str::<AcknowledgementStatus>(json_str).unwrap();
-            assert_eq!(de, ack)
-        }
-
-        de_json_assert_eq(
-            r#"{"result":"AQ=="}"#,
-            AcknowledgementStatus::success(ack_success_b64()),
-        );
-        de_json_assert_eq(
-            r#"{"error":"failed to deserialize packet data"}"#,
-            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into()),
-        );
-
-        assert!(serde_json::from_str::<AcknowledgementStatus>(r#"{"success":"AQ=="}"#).is_err());
-    }
-}
diff --git a/crates/ibc/src/core/ics04_channel/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
similarity index 98%
rename from crates/ibc/src/core/ics04_channel/channel.rs
rename to ibc-core/ics04-channel/types/src/channel.rs
index 43eceacb5..eed651870 100644
--- a/crates/ibc/src/core/ics04_channel/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -1,19 +1,19 @@
-//! Implementation of IBC channels, as described in ICS 4.
+//! Implementation of IBC channels, as described in ICS-04.
 
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::utils::PrettySlice;
 use ibc_proto::ibc::core::channel::v1::{
     Channel as RawChannel, Counterparty as RawCounterparty,
     IdentifiedChannel as RawIdentifiedChannel,
 };
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::prelude::*;
-use crate::utils::pretty::PrettySlice;
+use crate::error::ChannelError;
+use crate::Version;
 
 /// A [`ChannelEnd`] along with its ID and the port it is bound to
 #[cfg_attr(
@@ -570,12 +570,11 @@ impl Display for State {
 mod tests {
     use core::str::FromStr;
 
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::Channel as RawChannel;
     use ibc_testkit::utils::core::channel::dummy_raw_channel_end;
-    use test_log::test;
 
-    use crate::core::ics04_channel::channel::ChannelEnd;
-    use crate::prelude::*;
+    use crate::channel::ChannelEnd;
 
     #[test]
     fn channel_end_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/commitment.rs b/ibc-core/ics04-channel/types/src/commitment.rs
similarity index 95%
rename from crates/ibc/src/core/ics04_channel/commitment.rs
rename to ibc-core/ics04-channel/types/src/commitment.rs
index 67f8fbae6..ba5da70c5 100644
--- a/crates/ibc/src/core/ics04_channel/commitment.rs
+++ b/ibc-core/ics04-channel/types/src/commitment.rs
@@ -1,9 +1,10 @@
 //! Types and utilities related to packet commitments.
 
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
+
 use super::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::timeout::TimeoutHeight;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
+use crate::timeout::TimeoutHeight;
 
 /// Packet commitment
 #[cfg_attr(
@@ -124,7 +125,7 @@ mod test {
         ];
         let actual = compute_packet_commitment(
             "packet data".as_bytes(),
-            &TimeoutHeight::At(crate::Height::new(42, 24).unwrap()),
+            &TimeoutHeight::At(ibc_core_client_types::Height::new(42, 24).unwrap()),
             &Timestamp::from_nanoseconds(0x42).unwrap(),
         );
         assert_eq!(&expected[..], actual.as_ref());
diff --git a/crates/ibc/src/core/ics04_channel/error.rs b/ibc-core/ics04-channel/types/src/error.rs
similarity index 94%
rename from crates/ibc/src/core/ics04_channel/error.rs
rename to ibc-core/ics04-channel/types/src/error.rs
index 88a8abcb0..13e33db9c 100644
--- a/crates/ibc/src/core/ics04_channel/error.rs
+++ b/ibc-core/ics04-channel/types/src/error.rs
@@ -1,18 +1,17 @@
 //! Defines the main channel, port and packet error types
 
 use displaydoc::Display;
+use ibc_core_client_types::{error as client_error, Height};
+use ibc_core_connection_types::error as connection_error;
+use ibc_core_host_types::error::IdentifierError;
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{ParseTimestampError, Timestamp};
 
 use super::channel::Counterparty;
-use super::packet::Sequence;
 use super::timeout::TimeoutHeight;
-use crate::core::ics02_client::error as client_error;
-use crate::core::ics03_connection::error as connection_error;
-use crate::core::ics04_channel::channel::State;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, IdentifierError, PortId};
-use crate::core::timestamp::{ParseTimestampError, Timestamp};
-use crate::prelude::*;
-use crate::Height;
+use crate::channel::State;
+use crate::Version;
 
 #[derive(Debug, Display)]
 pub enum ChannelError {
diff --git a/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs b/ibc-core/ics04-channel/types/src/events/channel_attributes.rs
similarity index 97%
rename from crates/ibc/src/core/ics04_channel/events/channel_attributes.rs
rename to ibc-core/ics04-channel/types/src/events/channel_attributes.rs
index d802a50b0..8032fb44d 100644
--- a/crates/ibc/src/core/ics04_channel/events/channel_attributes.rs
+++ b/ibc-core/ics04-channel/types/src/events/channel_attributes.rs
@@ -1,10 +1,10 @@
 //! This module holds all the abci event attributes for IBC events emitted
 //! during the channel handshake.
 use derive_more::From;
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId};
 use tendermint::abci;
 
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
+use crate::Version;
 
 const CONNECTION_ID_ATTRIBUTE_KEY: &str = "connection_id";
 const CHANNEL_ID_ATTRIBUTE_KEY: &str = "channel_id";
diff --git a/crates/ibc/src/core/ics04_channel/events.rs b/ibc-core/ics04-channel/types/src/events/mod.rs
similarity index 99%
rename from crates/ibc/src/core/ics04_channel/events.rs
rename to ibc-core/ics04-channel/types/src/events/mod.rs
index 58baab970..606d248db 100644
--- a/crates/ibc/src/core/ics04_channel/events.rs
+++ b/ibc-core/ics04-channel/types/src/events/mod.rs
@@ -3,6 +3,9 @@
 mod channel_attributes;
 mod packet_attributes;
 
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 use tendermint::abci;
 
 use self::channel_attributes::{
@@ -17,14 +20,10 @@ use self::packet_attributes::{
 };
 use super::acknowledgement::Acknowledgement;
 use super::channel::Order;
-use super::packet::Sequence;
 use super::timeout::TimeoutHeight;
 use super::Version;
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
+use crate::error::ChannelError;
+use crate::packet::Packet;
 
 /// Channel event types
 const CHANNEL_OPEN_INIT_EVENT: &str = "channel_open_init";
diff --git a/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs b/ibc-core/ics04-channel/types/src/events/packet_attributes.rs
similarity index 95%
rename from crates/ibc/src/core/ics04_channel/events/packet_attributes.rs
rename to ibc-core/ics04-channel/types/src/events/packet_attributes.rs
index 58d820635..44a7970a8 100644
--- a/crates/ibc/src/core/ics04_channel/events/packet_attributes.rs
+++ b/ibc-core/ics04-channel/types/src/events/packet_attributes.rs
@@ -4,17 +4,16 @@
 use core::str;
 
 use derive_more::From;
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
+use ibc_primitives::prelude::*;
+use ibc_primitives::Timestamp;
 use subtle_encoding::hex;
 use tendermint::abci;
 
-use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::channel::Order;
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::packet::Sequence;
-use crate::core::ics04_channel::timeout::TimeoutHeight;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
+use crate::acknowledgement::Acknowledgement;
+use crate::channel::Order;
+use crate::error::ChannelError;
+use crate::timeout::TimeoutHeight;
 
 const PKT_SEQ_ATTRIBUTE_KEY: &str = "packet_sequence";
 const PKT_DATA_ATTRIBUTE_KEY: &str = "packet_data";
diff --git a/ibc-core/ics04-channel/types/src/lib.rs b/ibc-core/ics04-channel/types/src/lib.rs
new file mode 100644
index 000000000..6e7a0b3c6
--- /dev/null
+++ b/ibc-core/ics04-channel/types/src/lib.rs
@@ -0,0 +1,35 @@
+//! Implementation of the Channel and Packet Semantics (ICS-04) data structures.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+extern crate alloc;
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod channel;
+pub mod error;
+pub mod events;
+
+pub mod msgs;
+pub mod packet;
+pub mod timeout;
+
+pub mod acknowledgement;
+pub mod commitment;
+mod version;
+pub use version::Version;
+
+/// Re-exports ICS-04 proto types from the `ibc-proto` crate
+pub mod proto {
+    pub use ibc_proto::ibc::core::channel::*;
+}
diff --git a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
similarity index 87%
rename from crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
rename to ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
index 7195be630..0b5be9ea8 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
@@ -1,16 +1,15 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::acknowledgement::Acknowledgement;
+use crate::error::PacketError;
+use crate::packet::Packet;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgAcknowledgement";
+pub const ACKNOWLEDGEMENT_TYPE_URL: &str = "/ibc.core.channel.v1.MsgAcknowledgement";
 
 ///
 /// Message definition for packet acknowledgements.
@@ -35,7 +34,7 @@ impl Msg for MsgAcknowledgement {
     type Raw = RawMsgAcknowledgement;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        ACKNOWLEDGEMENT_TYPE_URL.to_string()
     }
 }
 
@@ -78,14 +77,13 @@ impl From<MsgAcknowledgement> for RawMsgAcknowledgement {
 
 #[cfg(test)]
 mod test {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
     use ibc_testkit::utils::core::signer::dummy_bech32_account;
-    use test_log::test;
 
-    use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-    use crate::prelude::*;
+    use crate::error::PacketError;
+    use crate::msgs::acknowledgement::MsgAcknowledgement;
 
     #[test]
     fn msg_acknowledgment_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
similarity index 92%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
index d9c9867c1..8c028cf11 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
@@ -1,15 +1,14 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::{ChannelId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::ChannelError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseConfirm";
+pub const CHAN_CLOSE_CONFIRM_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseConfirm";
 
 ///
 /// Message definition for the second step in the channel close handshake (the `ChanCloseConfirm`
@@ -34,7 +33,7 @@ impl Msg for MsgChannelCloseConfirm {
     type Raw = RawMsgChannelCloseConfirm;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_CLOSE_CONFIRM_TYPE_URL.to_string()
     }
 }
 
@@ -74,12 +73,12 @@ impl From<MsgChannelCloseConfirm> for RawMsgChannelCloseConfirm {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_confirm;
 
-    use crate::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-    use crate::prelude::*;
+    use crate::msgs::chan_close_confirm::MsgChannelCloseConfirm;
 
     #[test]
     fn parse_channel_close_confirm_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
similarity index 92%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
index dbbea054b..dafc18dcb 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_close_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
@@ -1,13 +1,12 @@
+use ibc_core_host_types::identifiers::{ChannelId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::error::ChannelError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseInit";
+pub const CHAN_CLOSE_INIT_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelCloseInit";
 
 ///
 /// Message definition for the first step in the channel close handshake (`ChanCloseInit` datagram).
@@ -29,7 +28,7 @@ impl Msg for MsgChannelCloseInit {
     type Raw = RawMsgChannelCloseInit;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_CLOSE_INIT_TYPE_URL.to_string()
     }
 }
 
@@ -59,12 +58,11 @@ impl From<MsgChannelCloseInit> for RawMsgChannelCloseInit {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_init;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
-    use crate::prelude::*;
+    use crate::msgs::chan_close_init::MsgChannelCloseInit;
 
     #[test]
     fn parse_channel_close_init_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
similarity index 93%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
index 65bbb1f4b..c2f962d64 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
@@ -1,16 +1,15 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::{ChannelId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::Version;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::ChannelError;
+use crate::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenAck";
+pub const CHAN_OPEN_ACK_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenAck";
 
 /// Message definition for the third step in the channel open handshake (`ChanOpenAck` datagram).
 ///
@@ -35,7 +34,7 @@ impl Msg for MsgChannelOpenAck {
     type Raw = RawMsgChannelOpenAck;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_OPEN_ACK_TYPE_URL.to_string()
     }
 }
 
@@ -79,13 +78,12 @@ impl From<MsgChannelOpenAck> for RawMsgChannelOpenAck {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_ack;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-    use crate::prelude::*;
+    use crate::msgs::chan_open_ack::MsgChannelOpenAck;
 
     #[test]
     fn parse_channel_open_ack_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
similarity index 92%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
index 01a03e16e..8ff31e03a 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
@@ -1,15 +1,14 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::{ChannelId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::ChannelError;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenConfirm";
+pub const CHAN_OPEN_CONFIRM_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenConfirm";
 
 ///
 /// Message definition for the fourth step in the channel open handshake (`ChanOpenConfirm`
@@ -34,7 +33,7 @@ impl Msg for MsgChannelOpenConfirm {
     type Raw = RawMsgChannelOpenConfirm;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_OPEN_CONFIRM_TYPE_URL.to_string()
     }
 }
 
@@ -74,13 +73,12 @@ impl From<MsgChannelOpenConfirm> for RawMsgChannelOpenConfirm {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_confirm;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-    use crate::prelude::*;
+    use crate::msgs::chan_open_confirm::MsgChannelOpenConfirm;
 
     #[test]
     fn parse_channel_open_confirm_msg() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
similarity index 89%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
index 9f68c475e..2a11c07b9 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
@@ -1,17 +1,14 @@
+use ibc_core_host_types::identifiers::{ConnectionId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::channel::{
-    verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
-};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ConnectionId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
+use crate::channel::{verify_connection_hops_length, ChannelEnd, Counterparty, Order, State};
+use crate::error::ChannelError;
+use crate::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenInit";
+pub const CHAN_OPEN_INIT_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenInit";
 
 ///
 /// Message definition for the first step in the channel open handshake (`ChanOpenInit` datagram).
@@ -37,7 +34,7 @@ impl MsgChannelOpenInit {
     /// Checks if the `connection_hops` has a length of `expected`.
     ///
     /// Note: Current IBC version only supports one connection hop.
-    pub(crate) fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
+    pub fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
         verify_connection_hops_length(&self.connection_hops_on_a, 1)
     }
 }
@@ -46,7 +43,7 @@ impl Msg for MsgChannelOpenInit {
     type Raw = RawMsgChannelOpenInit;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_OPEN_INIT_TYPE_URL.to_string()
     }
 }
 
@@ -93,12 +90,11 @@ impl From<MsgChannelOpenInit> for RawMsgChannelOpenInit {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-    use crate::prelude::*;
+    use crate::msgs::chan_open_init::MsgChannelOpenInit;
 
     #[test]
     fn channel_open_init_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
similarity index 91%
rename from crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
rename to ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
index ae9c60fc2..a671a5352 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/chan_open_try.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
@@ -1,19 +1,16 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::channel::{
-    verify_connection_hops_length, ChannelEnd, Counterparty, Order, State,
-};
-use crate::core::ics04_channel::error::ChannelError;
-use crate::core::ics04_channel::Version;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::channel::{verify_connection_hops_length, ChannelEnd, Counterparty, Order, State};
+use crate::error::ChannelError;
+use crate::Version;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenTry";
+pub const CHAN_OPEN_TRY_TYPE_URL: &str = "/ibc.core.channel.v1.MsgChannelOpenTry";
 
 ///
 /// Message definition for the second step in the channel open handshake (`ChanOpenTry` datagram).
@@ -45,7 +42,7 @@ impl MsgChannelOpenTry {
     /// Checks if the `connection_hops` has a length of `expected`.
     ///
     /// Note: Current IBC version only supports one connection hop.
-    pub(crate) fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
+    pub fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
         verify_connection_hops_length(&self.connection_hops_on_b, 1)
     }
 }
@@ -54,7 +51,7 @@ impl Msg for MsgChannelOpenTry {
     type Raw = RawMsgChannelOpenTry;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        CHAN_OPEN_TRY_TYPE_URL.to_string()
     }
 }
 
@@ -130,13 +127,12 @@ impl From<MsgChannelOpenTry> for RawMsgChannelOpenTry {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
     use ibc_proto::ibc::core::client::v1::Height;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_try;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-    use crate::prelude::*;
+    use crate::msgs::chan_open_try::MsgChannelOpenTry;
 
     #[test]
     fn channel_open_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs.rs b/ibc-core/ics04-channel/types/src/msgs/mod.rs
similarity index 66%
rename from crates/ibc/src/core/ics04_channel/msgs.rs
rename to ibc-core/ics04-channel/types/src/msgs/mod.rs
index 4b8c39bda..8e518591c 100644
--- a/crates/ibc/src/core/ics04_channel/msgs.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/mod.rs
@@ -1,34 +1,32 @@
 //! Message definitions for all ICS4 domain types: channel open & close handshake datagrams, as well
 //! as packets.
 
-use crate::prelude::*;
-
-pub mod acknowledgement;
-pub mod chan_close_confirm;
-pub mod chan_close_init;
-pub mod chan_open_ack;
-pub mod chan_open_confirm;
-pub mod chan_open_init;
-pub mod chan_open_try;
-pub mod recv_packet;
-pub mod timeout;
-pub mod timeout_on_close;
+mod acknowledgement;
+mod chan_close_confirm;
+mod chan_close_init;
+mod chan_open_ack;
+mod chan_open_confirm;
+mod chan_open_init;
+mod chan_open_try;
+mod recv_packet;
+mod timeout;
+mod timeout_on_close;
 
 // Opening handshake messages.
 // Packet specific messages.
-pub use acknowledgement::MsgAcknowledgement;
+pub use acknowledgement::*;
 // Closing handshake messages.
-pub use chan_close_confirm::MsgChannelCloseConfirm;
-pub use chan_close_init::MsgChannelCloseInit;
-pub use chan_open_ack::MsgChannelOpenAck;
-pub use chan_open_confirm::MsgChannelOpenConfirm;
-pub use chan_open_init::MsgChannelOpenInit;
-pub use chan_open_try::MsgChannelOpenTry;
-pub use recv_packet::MsgRecvPacket;
-pub use timeout::MsgTimeout;
-pub use timeout_on_close::MsgTimeoutOnClose;
-
-use crate::core::ics24_host::identifier::PortId;
+pub use chan_close_confirm::*;
+pub use chan_close_init::*;
+pub use chan_open_ack::*;
+pub use chan_open_confirm::*;
+pub use chan_open_init::*;
+pub use chan_open_try::*;
+use ibc_core_host_types::identifiers::*;
+use ibc_primitives::prelude::*;
+pub use recv_packet::*;
+pub use timeout::*;
+pub use timeout_on_close::*;
 
 /// All channel messages
 #[cfg_attr(
@@ -60,7 +58,7 @@ pub enum PacketMsg {
     TimeoutOnClose(MsgTimeoutOnClose),
 }
 
-pub(crate) fn channel_msg_to_port_id(msg: &ChannelMsg) -> &PortId {
+pub fn channel_msg_to_port_id(msg: &ChannelMsg) -> &PortId {
     match msg {
         ChannelMsg::OpenInit(msg) => &msg.port_id_on_a,
         ChannelMsg::OpenTry(msg) => &msg.port_id_on_b,
@@ -71,7 +69,7 @@ pub(crate) fn channel_msg_to_port_id(msg: &ChannelMsg) -> &PortId {
     }
 }
 
-pub(crate) fn packet_msg_to_port_id(msg: &PacketMsg) -> &PortId {
+pub fn packet_msg_to_port_id(msg: &PacketMsg) -> &PortId {
     match msg {
         PacketMsg::Recv(msg) => &msg.packet.port_id_on_b,
         PacketMsg::Ack(msg) => &msg.packet.port_id_on_a,
diff --git a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
similarity index 88%
rename from crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
rename to ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
index 91bebda00..da5367036 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/recv_packet.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
@@ -1,15 +1,14 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::PacketError;
+use crate::packet::Packet;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgRecvPacket";
+pub const RECV_PACKET_TYPE_URL: &str = "/ibc.core.channel.v1.MsgRecvPacket";
 
 ///
 /// Message definition for the "packet receiving" datagram.
@@ -35,7 +34,7 @@ impl Msg for MsgRecvPacket {
     type Raw = RawMsgRecvPacket;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        RECV_PACKET_TYPE_URL.to_string()
     }
 }
 
@@ -76,14 +75,13 @@ impl From<MsgRecvPacket> for RawMsgRecvPacket {
 
 #[cfg(test)]
 mod test {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_recv_packet;
     use ibc_testkit::utils::core::signer::dummy_bech32_account;
-    use test_log::test;
 
-    use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-    use crate::prelude::*;
+    use crate::error::PacketError;
+    use crate::msgs::recv_packet::MsgRecvPacket;
 
     #[test]
     fn msg_recv_packet_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
similarity index 90%
rename from crates/ibc/src/core/ics04_channel/msgs/timeout.rs
rename to ibc-core/ics04-channel/types/src/msgs/timeout.rs
index 55dd4bc62..3ae4ba4ce 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
@@ -1,15 +1,15 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::Sequence;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::packet::{Packet, Sequence};
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::PacketError;
+use crate::packet::Packet;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeout";
+pub const TIMEOUT_TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeout";
 
 ///
 /// Message definition for packet timeout domain type,
@@ -33,7 +33,7 @@ impl Msg for MsgTimeout {
     type Raw = RawMsgTimeout;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        TIMEOUT_TYPE_URL.to_string()
     }
 }
 
@@ -79,14 +79,13 @@ impl From<MsgTimeout> for RawMsgTimeout {
 
 #[cfg(test)]
 mod test {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
     use ibc_testkit::utils::core::signer::dummy_bech32_account;
-    use test_log::test;
 
-    use crate::core::ics04_channel::error::PacketError;
-    use crate::core::ics04_channel::msgs::timeout::MsgTimeout;
-    use crate::prelude::*;
+    use crate::error::PacketError;
+    use crate::msgs::timeout::MsgTimeout;
 
     #[test]
     fn msg_timeout_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
similarity index 90%
rename from crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
rename to ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
index c590e2bf2..e05cf240d 100644
--- a/crates/ibc/src/core/ics04_channel/msgs/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
@@ -1,15 +1,15 @@
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentProofBytes;
+use ibc_core_host_types::identifiers::Sequence;
+use ibc_primitives::prelude::*;
+use ibc_primitives::{Msg, Signer};
 use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
 use ibc_proto::Protobuf;
 
-use crate::core::ics04_channel::error::PacketError;
-use crate::core::ics04_channel::packet::{Packet, Sequence};
-use crate::core::ics23_commitment::commitment::CommitmentProofBytes;
-use crate::core::Msg;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
+use crate::error::PacketError;
+use crate::packet::Packet;
 
-pub(crate) const TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeoutOnClose";
+pub const TIMEOUT_ON_CLOSE_TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeoutOnClose";
 
 ///
 /// Message definition for packet timeout domain type.
@@ -33,7 +33,7 @@ impl Msg for MsgTimeoutOnClose {
     type Raw = RawMsgTimeoutOnClose;
 
     fn type_url(&self) -> String {
-        TYPE_URL.to_string()
+        TIMEOUT_ON_CLOSE_TYPE_URL.to_string()
     }
 }
 
@@ -85,12 +85,11 @@ impl From<MsgTimeoutOnClose> for RawMsgTimeoutOnClose {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
     use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
-    use test_log::test;
 
-    use crate::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-    use crate::prelude::*;
+    use crate::msgs::timeout_on_close::MsgTimeoutOnClose;
 
     #[test]
     fn msg_timeout_on_close_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/packet.rs b/ibc-core/ics04-channel/types/src/packet.rs
similarity index 88%
rename from crates/ibc/src/core/ics04_channel/packet.rs
rename to ibc-core/ics04-channel/types/src/packet.rs
index eba1ca8e9..8c09af4c9 100644
--- a/crates/ibc/src/core/ics04_channel/packet.rs
+++ b/ibc-core/ics04-channel/types/src/packet.rs
@@ -1,16 +1,13 @@
 //! Defines the packet type
-
-use core::str::FromStr;
-
+use ibc_core_client_types::Height;
+use ibc_core_host_types::identifiers::{ChannelId, PortId, Sequence};
+use ibc_primitives::prelude::*;
+use ibc_primitives::Expiry::Expired;
+use ibc_primitives::Timestamp;
 use ibc_proto::ibc::core::channel::v1::{Packet as RawPacket, PacketState as RawPacketState};
 
 use super::timeout::TimeoutHeight;
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics24_host::identifier::{ChannelId, PortId};
-use crate::core::timestamp::Expiry::Expired;
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
-use crate::Height;
+use crate::error::PacketError;
 
 /// Enumeration of proof carrying ICS4 message, helper for relayer.
 #[derive(Clone, Debug, PartialEq, Eq)]
@@ -53,65 +50,6 @@ impl core::fmt::Display for PacketMsgType {
     }
 }
 
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-/// The sequence number of a packet enforces ordering among packets from the same source.
-#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash, PartialOrd, Ord)]
-pub struct Sequence(u64);
-
-impl FromStr for Sequence {
-    type Err = ChannelError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        Ok(Self::from(s.parse::<u64>().map_err(|e| {
-            ChannelError::InvalidStringAsSequence {
-                value: s.to_string(),
-                error: e,
-            }
-        })?))
-    }
-}
-
-impl Sequence {
-    pub fn is_zero(&self) -> bool {
-        self.0 == 0
-    }
-
-    pub fn increment(&self) -> Sequence {
-        Sequence(self.0 + 1)
-    }
-}
-
-impl From<u64> for Sequence {
-    fn from(seq: u64) -> Self {
-        Sequence(seq)
-    }
-}
-
-impl From<Sequence> for u64 {
-    fn from(s: Sequence) -> u64 {
-        s.0
-    }
-}
-
-impl core::fmt::Display for Sequence {
-    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> Result<(), core::fmt::Error> {
-        write!(f, "{}", self.0)
-    }
-}
-
 /// The packet type; this is what applications send to one another.
 ///
 /// Each application defines the structure of the `data` field.
@@ -138,7 +76,7 @@ pub struct Packet {
     pub chan_id_on_b: ChannelId,
     #[cfg_attr(
         feature = "serde",
-        serde(serialize_with = "crate::serializers::ser_hex_upper")
+        serde(serialize_with = "ibc_core_commitment_types::serializer::ser_hex_upper")
     )]
     pub data: Vec<u8>,
     pub timeout_height_on_b: TimeoutHeight,
@@ -187,7 +125,7 @@ impl core::fmt::Debug for Packet {
 
 impl Packet {
     /// Checks whether a packet from a
-    /// [`SendPacket`](crate::core::ics04_channel::events::SendPacket)
+    /// [`SendPacket`](crate::events::SendPacket)
     /// event is timed-out relative to the current state of the
     /// destination chain.
     ///
@@ -196,9 +134,9 @@ impl Packet {
     /// the height `dst_chain_height`.
     ///
     /// Note: a timed-out packet should result in a
-    /// [`MsgTimeout`](crate::core::ics04_channel::msgs::timeout::MsgTimeout),
+    /// [`MsgTimeout`](crate::msgs::MsgTimeout),
     /// instead of the common-case where it results in
-    /// [`MsgRecvPacket`](crate::core::ics04_channel::msgs::recv_packet::MsgRecvPacket).
+    /// [`MsgRecvPacket`](crate::msgs::MsgRecvPacket).
     pub fn timed_out(&self, dst_chain_ts: &Timestamp, dst_chain_height: Height) -> bool {
         let height_timed_out = self.timeout_height_on_b.has_expired(dst_chain_height);
 
@@ -275,7 +213,7 @@ impl TryFrom<RawPacket> for Packet {
 impl From<Packet> for RawPacket {
     fn from(packet: Packet) -> Self {
         RawPacket {
-            sequence: packet.seq_on_a.0,
+            sequence: packet.seq_on_a.value(),
             source_port: packet.port_id_on_a.to_string(),
             source_channel: packet.chan_id_on_a.to_string(),
             destination_port: packet.port_id_on_b.to_string(),
@@ -311,7 +249,7 @@ pub struct PacketState {
     pub seq: Sequence,
     #[cfg_attr(
         feature = "serde",
-        serde(serialize_with = "crate::serializers::ser_hex_upper")
+        serde(serialize_with = "ibc_core_commitment_types::serializer::ser_hex_upper")
     )]
     pub data: Vec<u8>,
 }
@@ -364,7 +302,7 @@ impl TryFrom<RawPacketState> for PacketState {
 impl From<PacketState> for RawPacketState {
     fn from(packet: PacketState) -> Self {
         Self {
-            sequence: packet.seq.0,
+            sequence: packet.seq.value(),
             port_id: packet.port_id.to_string(),
             channel_id: packet.chan_id.to_string(),
             data: packet.data,
@@ -374,13 +312,12 @@ impl From<PacketState> for RawPacketState {
 
 #[cfg(test)]
 mod tests {
+    use ibc_primitives::prelude::*;
     use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
     use ibc_proto::ibc::core::client::v1::Height as RawHeight;
     use ibc_testkit::utils::core::channel::dummy_raw_packet;
-    use test_log::test;
 
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::prelude::*;
+    use crate::packet::Packet;
 
     #[test]
     fn packet_try_from_raw() {
diff --git a/crates/ibc/src/core/ics04_channel/timeout.rs b/ibc-core/ics04-channel/types/src/timeout.rs
similarity index 97%
rename from crates/ibc/src/core/ics04_channel/timeout.rs
rename to ibc-core/ics04-channel/types/src/timeout.rs
index e70a1efd7..3a7e825ce 100644
--- a/crates/ibc/src/core/ics04_channel/timeout.rs
+++ b/ibc-core/ics04-channel/types/src/timeout.rs
@@ -2,12 +2,11 @@
 
 use core::fmt::{Display, Error as FmtError, Formatter};
 
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::Height;
+use ibc_primitives::prelude::*;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics02_client::height::Height;
-use crate::prelude::*;
-
 /// Indicates a consensus height on the destination chain after which the packet
 /// will no longer be processed, and will instead count as having timed-out.
 ///
@@ -190,7 +189,7 @@ mod tests {
         where
             D: serde::Deserializer<'de>,
         {
-            use crate::core::ics02_client::height::Height as Ics02Height;
+            use ibc_core_client_types::Height as Ics02Height;
 
             // Here we have to use a bespoke struct as well in order to deserialize
             // a height which may have a revision height equal to zero.
diff --git a/crates/ibc/src/core/ics04_channel/version.rs b/ibc-core/ics04-channel/types/src/version.rs
similarity index 98%
rename from crates/ibc/src/core/ics04_channel/version.rs
rename to ibc-core/ics04-channel/types/src/version.rs
index 9e07bfe21..bf41109da 100644
--- a/crates/ibc/src/core/ics04_channel/version.rs
+++ b/ibc-core/ics04-channel/types/src/version.rs
@@ -6,8 +6,9 @@ use core::convert::Infallible;
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use ibc_primitives::prelude::*;
+
 use super::error::ChannelError;
-use crate::prelude::*;
 
 /// The version field for a `ChannelEnd`.
 ///
diff --git a/ibc-core/ics23-commitment/types/Cargo.toml b/ibc-core/ics23-commitment/types/Cargo.toml
new file mode 100644
index 000000000..f29aff6c0
--- /dev/null
+++ b/ibc-core/ics23-commitment/types/Cargo.toml
@@ -0,0 +1,74 @@
+[package]
+name = "ibc-core-commitment-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "commitment", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-23 Vector Commitments data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-proto       = { workspace = true }
+ibc-primitives  = {workspace = true }
+ics23           = { workspace = true, features = ["host-functions"] }
+
+# parity dependencies
+parity-scale-codec  = { workspace = true, optional = true }
+scale-info          = { workspace = true, optional = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "ics23/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+    "ics23/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-proto/json-schema",
+    "ibc-primitives/schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-proto/borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
+
diff --git a/crates/ibc/src/core/ics23_commitment/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
similarity index 96%
rename from crates/ibc/src/core/ics23_commitment/commitment.rs
rename to ibc-core/ics23-commitment/types/src/commitment.rs
index 556f58458..0969c565c 100644
--- a/crates/ibc/src/core/ics23_commitment/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -3,12 +3,12 @@
 use core::convert::TryFrom;
 use core::fmt;
 
+use ibc_primitives::prelude::*;
 use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
 use subtle_encoding::{Encoding, Hex};
 
 use super::merkle::MerkleProof;
-use crate::core::ics23_commitment::error::CommitmentError;
-use crate::prelude::*;
+use crate::error::CommitmentError;
 
 /// Encodes a commitment root; most often a Merkle tree root hash.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -17,7 +17,7 @@ use crate::prelude::*;
 pub struct CommitmentRoot {
     #[cfg_attr(
         feature = "serde",
-        serde(serialize_with = "crate::serializers::ser_hex_upper")
+        serde(serialize_with = "crate::serializer::ser_hex_upper")
     )]
     bytes: Vec<u8>,
 }
@@ -73,7 +73,7 @@ impl From<Vec<u8>> for CommitmentRoot {
 pub struct CommitmentProofBytes {
     #[cfg_attr(
         feature = "serde",
-        serde(serialize_with = "crate::serializers::ser_hex_upper")
+        serde(serialize_with = "crate::serializer::ser_hex_upper")
     )]
     bytes: Vec<u8>,
 }
diff --git a/crates/ibc/src/core/ics23_commitment/error.rs b/ibc-core/ics23-commitment/types/src/error.rs
similarity index 97%
rename from crates/ibc/src/core/ics23_commitment/error.rs
rename to ibc-core/ics23-commitment/types/src/error.rs
index 1a4bcaaeb..3b7b17575 100644
--- a/crates/ibc/src/core/ics23_commitment/error.rs
+++ b/ibc-core/ics23-commitment/types/src/error.rs
@@ -1,8 +1,7 @@
 //! Defines the commitment error type
 
-use alloc::string::String;
-
 use displaydoc::Display;
+use ibc_primitives::prelude::*;
 use prost::DecodeError;
 
 #[derive(Debug, Display)]
diff --git a/ibc-core/ics23-commitment/types/src/lib.rs b/ibc-core/ics23-commitment/types/src/lib.rs
new file mode 100644
index 000000000..a4cb15890
--- /dev/null
+++ b/ibc-core/ics23-commitment/types/src/lib.rs
@@ -0,0 +1,31 @@
+//! ICS-23: Commitment implementation of a cryptographic scheme that verifies
+//! state transitions between chains.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod commitment;
+pub mod error;
+pub mod merkle;
+pub mod specs;
+
+#[cfg(feature = "serde")]
+pub mod serializer;
+
+/// Re-exports ICS-23 proto types from the `ibc-proto` crate, which are
+/// used in the implementation of dependent IBC crates.
+pub mod proto {
+    pub use ibc_proto::ibc::core::commitment::*;
+    pub use ibc_proto::ics23;
+}
diff --git a/crates/ibc/src/core/ics23_commitment/merkle.rs b/ibc-core/ics23-commitment/types/src/merkle.rs
similarity index 96%
rename from crates/ibc/src/core/ics23_commitment/merkle.rs
rename to ibc-core/ics23-commitment/types/src/merkle.rs
index 26908e6f0..50e711c1d 100644
--- a/crates/ibc/src/core/ics23_commitment/merkle.rs
+++ b/ibc-core/ics23-commitment/types/src/merkle.rs
@@ -1,5 +1,6 @@
 //! Merkle proof utilities
 
+use ibc_primitives::prelude::*;
 use ibc_proto::ibc::core::commitment::v1::{MerklePath, MerkleProof as RawMerkleProof, MerkleRoot};
 use ibc_proto::ics23::commitment_proof::Proof;
 use ibc_proto::ics23::{
@@ -7,10 +8,9 @@ use ibc_proto::ics23::{
     NonExistenceProof,
 };
 
-use crate::core::ics23_commitment::commitment::{CommitmentPrefix, CommitmentRoot};
-use crate::core::ics23_commitment::error::CommitmentError;
-use crate::core::ics23_commitment::specs::ProofSpecs;
-use crate::prelude::*;
+use crate::commitment::{CommitmentPrefix, CommitmentRoot};
+use crate::error::CommitmentError;
+use crate::specs::ProofSpecs;
 
 pub fn apply_prefix(prefix: &CommitmentPrefix, mut path: Vec<String>) -> MerklePath {
     let mut key_path: Vec<String> = vec![format!("{prefix:?}")];
diff --git a/ibc-core/ics23-commitment/types/src/serializer.rs b/ibc-core/ics23-commitment/types/src/serializer.rs
new file mode 100644
index 000000000..b3950b218
--- /dev/null
+++ b/ibc-core/ics23-commitment/types/src/serializer.rs
@@ -0,0 +1,14 @@
+use ibc_primitives::prelude::*;
+use serde::ser::{Serialize, Serializer};
+use subtle_encoding::{Encoding, Hex};
+
+pub fn ser_hex_upper<S, T>(data: T, serializer: S) -> Result<S::Ok, S::Error>
+where
+    S: Serializer,
+    T: AsRef<[u8]>,
+{
+    let hex = Hex::upper_case()
+        .encode_to_string(data)
+        .map_err(|e| serde::ser::Error::custom(format!("failed to serialize hex: {}", e)))?;
+    hex.serialize(serializer)
+}
diff --git a/crates/ibc/src/core/ics23_commitment/specs.rs b/ibc-core/ics23-commitment/types/src/specs.rs
similarity index 99%
rename from crates/ibc/src/core/ics23_commitment/specs.rs
rename to ibc-core/ics23-commitment/types/src/specs.rs
index ae7787a39..3c2b1df75 100644
--- a/crates/ibc/src/core/ics23_commitment/specs.rs
+++ b/ibc-core/ics23-commitment/types/src/specs.rs
@@ -1,8 +1,7 @@
 //! Defines proof specs, which encode the structure of proofs
 
+use ibc_primitives::prelude::*;
 use ibc_proto::ics23::{InnerSpec as RawInnerSpec, LeafOp as RawLeafOp, ProofSpec as RawProofSpec};
-
-use crate::prelude::*;
 /// An array of proof specifications.
 ///
 /// This type encapsulates different types of proof specifications, mostly predefined, e.g., for
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
new file mode 100644
index 000000000..dc28e951f
--- /dev/null
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -0,0 +1,90 @@
+[package]
+name         = "ibc-core-host"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "host"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains essential top-level traits designed for the seamless integration
+    of host chains, facilitating access to the host's storage, the efficient retrieval of states and 
+    metadata crucial for the execution of any IBC datagrams.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+derive_more      = { workspace = true }
+displaydoc       = { workspace = true }
+prost            = { workspace = true }
+subtle-encoding  = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-client-context   = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-channel-types    = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[dev-dependencies]
+rstest = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-core-client-types/std",
+    "ibc-core-client-context/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-channel-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "ibc-core-client-types/serde",
+    "ibc-core-client-context/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-channel-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "ibc-core-client-types/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-channel-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "ibc-core-client-types/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-channel-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
new file mode 100644
index 000000000..51a9ef519
--- /dev/null
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -0,0 +1,113 @@
+[package]
+name         = "ibc-core-host-cosmos"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "tendermint"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains Cosmos-specific helper traits and implementations
+    to facilitate IBC integration, ensuring proper interaction with modules/components
+    beyond the IBC modules on host chains.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true}
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+serde           = { workspace = true, optional = true }
+sha2            = { workspace = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-client-tendermint     = { workspace = true }
+ibc-app-transfer-types    = { workspace = true }
+ibc-core-client-types     = { workspace = true }
+ibc-core-client-context   = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+rstest      = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-core-client-types/std",
+    "ibc-core-client-context/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-client-tendermint/serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-client-context/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "ibc-client-tendermint/schema",
+    "ibc-core-client-types/schema",
+    "ibc-core-client-context/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+]
+borsh = [
+    "dep:borsh",
+    "ibc-client-tendermint/borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-client-tendermint/parity-scale-codec",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/ibc-core/ics24-host/cosmos/src/lib.rs b/ibc-core/ics24-host/cosmos/src/lib.rs
new file mode 100644
index 000000000..7225534a9
--- /dev/null
+++ b/ibc-core/ics24-host/cosmos/src/lib.rs
@@ -0,0 +1,30 @@
+//! Provides convenience traits and implementations for Tendermint-based hosts
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+pub mod upgrade_proposal;
+
+pub mod utils;
+
+mod validate_self_client;
+pub use validate_self_client::ValidateSelfClientContext;
+
+/// Re-exports necessary proto types for implementing the tendermint client
+/// upgradeability feature.
+pub mod proto {
+    pub use ibc_proto::cosmos::upgrade::*;
+}
+
+/// ABCI store/query path for the IBC sub-store
+pub const IBC_QUERY_PATH: &str = "store/ibc/key";
+
+/// ABCI store/query path for the upgrade sub-store
+pub const SDK_UPGRADE_QUERY_PATH: &str = "store/upgrade/key";
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
similarity index 88%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
index 29428a2be..eaa9313a8 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/context.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
@@ -5,12 +5,13 @@
 //! [Basecoin-rs](https://github.com/informalsystems/basecoin-rs) repository.
 //! If it proves to be generic enough, we may move it to the ICS02 section.
 
+use ibc_core_client_context::client_state::ClientState;
+use ibc_core_client_context::consensus_state::ConsensusState;
+use ibc_core_client_context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client_types::error::UpgradeClientError;
+use ibc_core_host_types::path::UpgradeClientPath;
+
 use super::Plan;
-use crate::core::ics02_client::client_state::ClientState;
-use crate::core::ics02_client::consensus_state::ConsensusState;
-use crate::core::ics02_client::error::UpgradeClientError;
-use crate::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use crate::core::ics24_host::path::UpgradeClientPath;
 
 /// Helper context to validate client upgrades, providing methods to retrieve
 /// an upgrade plan and related upgraded client and consensus states.
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/events.rs
similarity index 98%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/events.rs
index 0cb380d18..b4e3550c9 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/events.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/events.rs
@@ -1,10 +1,7 @@
 //! Definitions of events emitted when an upgrade client is proposed or executed.
 
-use alloc::borrow::ToOwned;
-use alloc::string::{String, ToString};
-use alloc::vec;
-
 use derive_more::From;
+use ibc_primitives::prelude::*;
 use tendermint::abci;
 
 const UPGRADE_CHAIN_EVENT: &str = "upgrade_chain";
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
similarity index 77%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
index 0680854ca..31f187175 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/handler.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
@@ -1,13 +1,10 @@
-use alloc::string::ToString;
-
+use ibc_client_tendermint::types::ClientState as TmClientState;
+use ibc_core_client_types::error::UpgradeClientError;
+use ibc_core_host_types::path::UpgradeClientPath;
+use ibc_primitives::prelude::*;
 use tendermint::abci::Event as TmEvent;
 
-use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use crate::core::ics02_client::error::UpgradeClientError;
-use crate::core::ics24_host::path::UpgradeClientPath;
-use crate::hosts::tendermint::upgrade_proposal::{
-    UpgradeClientProposal, UpgradeExecutionContext, UpgradeProposal,
-};
+use crate::upgrade_proposal::{UpgradeClientProposal, UpgradeExecutionContext, UpgradeProposal};
 
 /// Handles an upgrade client proposal
 ///
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/mod.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
similarity index 100%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/mod.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/plan.rs
similarity index 94%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/plan.rs
index 075e0b692..d1a25adcc 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/plan.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/plan.rs
@@ -1,15 +1,12 @@
 //! Definition of domain `Plan` type.
 
-use alloc::format;
-use alloc::string::{String, ToString};
-
+use ibc_core_client_types::error::UpgradeClientError;
+use ibc_primitives::prelude::*;
 use ibc_proto::cosmos::upgrade::v1beta1::Plan as RawPlan;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::Protobuf;
 
-use crate::core::ics02_client::error::UpgradeClientError;
-
-pub(crate) const TYPE_URL: &str = "/cosmos.upgrade.v1beta1.Plan";
+pub const TYPE_URL: &str = "/cosmos.upgrade.v1beta1.Plan";
 
 /// Specifies information about a planned upgrade and at which height it should
 /// be performed.
diff --git a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
similarity index 96%
rename from crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
rename to ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
index 46deaeda2..5f24c9523 100644
--- a/crates/ibc/src/hosts/tendermint/upgrade_proposal/proposal.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
@@ -1,13 +1,12 @@
 //! Definition of domain `UpgradeProposal` type for handling upgrade client proposal
 
-use alloc::string::{String, ToString};
-
+use ibc_core_client_types::error::UpgradeClientError;
+use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::UpgradeProposal as RawUpgradeProposal;
 use ibc_proto::Protobuf;
 
 use super::Plan;
-use crate::core::ics02_client::error::UpgradeClientError;
 
 /// Defines a governance proposal of type `Content` that enables the initiation
 /// of an IBC breaking upgrade and specifies the new client state that should be
diff --git a/ibc-core/ics24-host/cosmos/src/utils.rs b/ibc-core/ics24-host/cosmos/src/utils.rs
new file mode 100644
index 000000000..7ecf41975
--- /dev/null
+++ b/ibc-core/ics24-host/cosmos/src/utils.rs
@@ -0,0 +1,57 @@
+use ibc_app_transfer_types::VERSION;
+use ibc_core_host_types::identifiers::{ChannelId, PortId};
+pub use ibc_primitives::prelude::*;
+use sha2::{Digest, Sha256};
+
+/// Helper function to generate an escrow address for a given port and channel
+/// ids according to the format specified in the Cosmos SDK
+/// [`ADR-028`](https://github.com/cosmos/cosmos-sdk/blob/master/docs/architecture/adr-028-public-key-addresses.md)
+pub fn cosmos_adr028_escrow_address(port_id: &PortId, channel_id: &ChannelId) -> Vec<u8> {
+    let contents = format!("{port_id}/{channel_id}");
+
+    let mut hasher = Sha256::new();
+    hasher.update(VERSION.as_bytes());
+    hasher.update([0]);
+    hasher.update(contents.as_bytes());
+
+    let mut hash = hasher.finalize().to_vec();
+    hash.truncate(20);
+    hash
+}
+
+#[cfg(test)]
+mod tests {
+    use subtle_encoding::bech32;
+
+    use super::*;
+
+    #[test]
+    fn test_cosmos_escrow_address() {
+        fn assert_eq_escrow_address(port_id: &str, channel_id: &str, address: &str) {
+            let port_id = port_id.parse().unwrap();
+            let channel_id = channel_id.parse().unwrap();
+            let gen_address = {
+                let addr = cosmos_adr028_escrow_address(&port_id, &channel_id);
+                bech32::encode("cosmos", addr)
+            };
+            assert_eq!(gen_address, address.to_owned())
+        }
+
+        // addresses obtained using `gaiad query ibc-transfer escrow-address [port-id] [channel-id]`
+        assert_eq_escrow_address(
+            "transfer",
+            "channel-141",
+            "cosmos1x54ltnyg88k0ejmk8ytwrhd3ltm84xehrnlslf",
+        );
+        assert_eq_escrow_address(
+            "transfer",
+            "channel-207",
+            "cosmos1ju6tlfclulxumtt2kglvnxduj5d93a64r5czge",
+        );
+        assert_eq_escrow_address(
+            "transfer",
+            "channel-187",
+            "cosmos177x69sver58mcfs74x6dg0tv6ls4s3xmmcaw53",
+        );
+    }
+}
diff --git a/crates/ibc/src/hosts/tendermint/validate_self_client.rs b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
similarity index 72%
rename from crates/ibc/src/hosts/tendermint/validate_self_client.rs
rename to ibc-core/ics24-host/cosmos/src/validate_self_client.rs
index 6b7762114..e0cdb9b81 100644
--- a/crates/ibc/src/hosts/tendermint/validate_self_client.rs
+++ b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
@@ -1,19 +1,17 @@
-use alloc::format;
-use alloc::string::{String, ToString};
 use core::time::Duration;
 
+use ibc_client_tendermint::client_state::ClientState;
+use ibc_core_client_context::client_state::ClientStateCommon;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::specs::ProofSpecs;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host_types::identifiers::ChainId;
+use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 
-use crate::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use crate::core::ics02_client::client_state::ClientStateCommon;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics23_commitment::specs::ProofSpecs;
-use crate::core::ics24_host::identifier::ChainId;
-use crate::core::ContextError;
-use crate::Height;
-
 /// Provides an implementation of `ValidationContext::validate_self_client` for
 /// Tendermint-based hosts.
 pub trait ValidateSelfClientContext {
@@ -21,15 +19,19 @@ pub trait ValidateSelfClientContext {
         &self,
         client_state_of_host_on_counterparty: Any,
     ) -> Result<(), ContextError> {
-        let tm_client_state = TmClientState::try_from(client_state_of_host_on_counterparty)
+        let tm_client_state = ClientState::try_from(client_state_of_host_on_counterparty)
             .map_err(|_| ConnectionError::InvalidClientState {
                 reason: "client must be a tendermint client".to_string(),
             })
             .map_err(ContextError::ConnectionError)?;
 
-        tm_client_state.validate().map_err(ClientError::from)?;
+        let tm_client_state_inner = tm_client_state.inner();
+
+        tm_client_state_inner
+            .validate()
+            .map_err(ClientError::from)?;
 
-        if tm_client_state.is_frozen() {
+        if tm_client_state_inner.is_frozen() {
             return Err(ClientError::ClientFrozen {
                 description: String::new(),
             }
@@ -37,12 +39,12 @@ pub trait ValidateSelfClientContext {
         }
 
         let self_chain_id = self.chain_id();
-        if self_chain_id != &tm_client_state.chain_id {
+        if self_chain_id != &tm_client_state_inner.chain_id {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid chain-id. expected: {}, got: {}",
-                        self_chain_id, tm_client_state.chain_id
+                        self_chain_id, tm_client_state_inner.chain_id
                     ),
                 },
             ));
@@ -73,20 +75,20 @@ pub trait ValidateSelfClientContext {
             ));
         }
 
-        if self.proof_specs() != &tm_client_state.proof_specs {
+        if self.proof_specs() != &tm_client_state_inner.proof_specs {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client has invalid proof specs. expected: {:?}, got: {:?}",
                         self.proof_specs(),
-                        tm_client_state.proof_specs
+                        tm_client_state_inner.proof_specs
                     ),
                 },
             ));
         }
 
         let _ = {
-            let trust_level = tm_client_state.trust_level;
+            let trust_level = tm_client_state_inner.trust_level;
 
             TendermintTrustThresholdFraction::new(
                 trust_level.numerator(),
@@ -97,35 +99,35 @@ pub trait ValidateSelfClientContext {
             })?
         };
 
-        if self.unbonding_period() != tm_client_state.unbonding_period {
+        if self.unbonding_period() != tm_client_state_inner.unbonding_period {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid unbonding period. expected: {:?}, got: {:?}",
                         self.unbonding_period(),
-                        tm_client_state.unbonding_period,
+                        tm_client_state_inner.unbonding_period,
                     ),
                 },
             ));
         }
 
-        if tm_client_state.unbonding_period < tm_client_state.trusting_period {
+        if tm_client_state_inner.unbonding_period < tm_client_state_inner.trusting_period {
             return Err(ContextError::ConnectionError(ConnectionError::InvalidClientState{ reason: format!(
                 "unbonding period must be greater than trusting period. unbonding period ({:?}) < trusting period ({:?})",
-                tm_client_state.unbonding_period,
-                tm_client_state.trusting_period
+                tm_client_state_inner.unbonding_period,
+                tm_client_state_inner.trusting_period
             )}));
         }
 
-        if !tm_client_state.upgrade_path.is_empty()
-            && self.upgrade_path() != tm_client_state.upgrade_path
+        if !tm_client_state_inner.upgrade_path.is_empty()
+            && self.upgrade_path() != tm_client_state_inner.upgrade_path
         {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid upgrade path. expected: {:?}, got: {:?}",
                         self.upgrade_path(),
-                        tm_client_state.upgrade_path
+                        tm_client_state_inner.upgrade_path
                     ),
                 },
             ));
diff --git a/crates/ibc/src/core/context.rs b/ibc-core/ics24-host/src/context.rs
similarity index 75%
rename from crates/ibc/src/core/context.rs
rename to ibc-core/ics24-host/src/context.rs
index 288717f4b..b2525b3cb 100644
--- a/crates/ibc/src/core/context.rs
+++ b/ibc-core/ics24-host/src/context.rs
@@ -1,97 +1,33 @@
-use alloc::string::String;
 use core::time::Duration;
 
-use derive_more::From;
-use displaydoc::Display;
-use ibc_proto::google::protobuf::Any;
-
-use super::ics02_client::client_state::ClientState;
-use super::ics02_client::consensus_state::ConsensusState;
-use super::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use super::ics24_host::identifier::PortId;
-use crate::core::events::IbcEvent;
-use crate::core::ics02_client::error::ClientError;
-use crate::core::ics03_connection::connection::ConnectionEnd;
-use crate::core::ics03_connection::error::ConnectionError;
-use crate::core::ics03_connection::version::{
+use ibc_core_channel_types::channel::ChannelEnd;
+use ibc_core_channel_types::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc_core_channel_types::packet::Receipt;
+use ibc_core_client_context::client_state::ClientState;
+use ibc_core_client_context::consensus_state::ConsensusState;
+use ibc_core_client_context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client_types::Height;
+use ibc_core_commitment_types::commitment::CommitmentPrefix;
+use ibc_core_connection_types::version::{
     get_compatible_versions, pick_version, Version as ConnectionVersion,
 };
-use crate::core::ics04_channel::channel::ChannelEnd;
-use crate::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
-use crate::core::ics04_channel::context::calculate_block_delay;
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::packet::{Receipt, Sequence};
-use crate::core::ics23_commitment::commitment::CommitmentPrefix;
-use crate::core::ics24_host::identifier::{ClientId, ConnectionId};
-use crate::core::ics24_host::path::{
+use ibc_core_connection_types::ConnectionEnd;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::events::IbcEvent;
+use ibc_core_host_types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc_core_host_types::path::{
     AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
     ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use crate::core::timestamp::Timestamp;
-use crate::prelude::*;
-use crate::signer::Signer;
-use crate::Height;
-
-/// Top-level error
-#[derive(Debug, Display, From)]
-pub enum ContextError {
-    /// ICS02 Client error: {0}
-    ClientError(ClientError),
-    /// ICS03 Connection error: {0}
-    ConnectionError(ConnectionError),
-    /// ICS04 Channel error: {0}
-    ChannelError(ChannelError),
-    /// ICS04 Packet error: {0}
-    PacketError(PacketError),
-}
-
-#[cfg(feature = "std")]
-impl std::error::Error for ContextError {
-    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
-        match &self {
-            Self::ClientError(e) => Some(e),
-            Self::ConnectionError(e) => Some(e),
-            Self::ChannelError(e) => Some(e),
-            Self::PacketError(e) => Some(e),
-        }
-    }
-}
-
-/// Error returned from entrypoint functions [`dispatch`][super::dispatch], [`validate`][super::validate] and
-/// [`execute`][super::execute].
-#[derive(Debug, Display)]
-pub enum RouterError {
-    /// context error: `{0}`
-    ContextError(ContextError),
-    /// unknown type URL `{url}`
-    UnknownMessageTypeUrl { url: String },
-    /// the message is malformed and cannot be decoded error: `{reason}`
-    MalformedMessageBytes { reason: String },
-    /// port `{port_id}` is unknown
-    UnknownPort { port_id: PortId },
-    /// module not found
-    ModuleNotFound,
-}
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
+use ibc_primitives::{Signer, Timestamp};
 
-impl From<ContextError> for RouterError {
-    fn from(error: ContextError) -> Self {
-        Self::ContextError(error)
-    }
-}
-
-#[cfg(feature = "std")]
-impl std::error::Error for RouterError {
-    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
-        match &self {
-            Self::ContextError(e) => Some(e),
-            _ => None,
-        }
-    }
-}
+use crate::utils::calculate_block_delay;
 
 /// Context to be implemented by the host that provides all "read-only" methods.
 ///
-/// Trait used for the top-level [`validate`](crate::core::validate)
+/// Trait used for the top-level `validate` entrypoint in the `ibc-core` crate.
 pub trait ValidationContext {
     type V: ClientValidationContext;
     type E: ClientExecutionContext;
@@ -147,7 +83,7 @@ pub trait ValidationContext {
     /// requirements](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#client-state-validation)
     ///
     /// Additionally, implementations specific to individual chains can be found
-    /// in the [hosts](crate::hosts) module.
+    /// in the `ibc-core-hostkit` crate.
     fn validate_self_client(
         &self,
         client_state_of_host_on_counterparty: Any,
@@ -159,13 +95,13 @@ pub trait ValidationContext {
     /// Returns a counter on how many connections have been created thus far.
     fn connection_counter(&self) -> Result<u64, ContextError>;
 
-    /// Function required by ICS 03. Returns the list of all possible versions that the connection
+    /// Function required by ICS-03. Returns the list of all possible versions that the connection
     /// handshake protocol supports.
     fn get_compatible_versions(&self) -> Vec<ConnectionVersion> {
         get_compatible_versions()
     }
 
-    /// Function required by ICS 03. Returns one version out of the supplied list of versions, which the
+    /// Function required by ICS-03. Returns one version out of the supplied list of versions, which the
     /// connection handshake protocol prefers.
     fn pick_version(
         &self,
@@ -228,7 +164,7 @@ pub trait ValidationContext {
 
 /// Context to be implemented by the host that provides all "write-only" methods.
 ///
-/// Trait used for the top-level [`execute`](crate::core::execute) and [`dispatch`](crate::core::dispatch)
+/// Trait used for the top-level `execute` and `dispatch` entrypoints in the `ibc-core` crate.
 pub trait ExecutionContext: ValidationContext {
     /// Retrieve the context that implements all clients' `ExecutionContext`.
     fn get_client_execution_context(&mut self) -> &mut Self::E;
diff --git a/ibc-core/ics24-host/src/lib.rs b/ibc-core/ics24-host/src/lib.rs
new file mode 100644
index 000000000..7d64b4e38
--- /dev/null
+++ b/ibc-core/ics24-host/src/lib.rs
@@ -0,0 +1,29 @@
+//! Provides essential top-level traits designed for the seamless integration of
+//! host chains with ibc-rs. It streamlines access to the host's storage,
+//! facilitating the efficient retrieval of states and metadata crucial for the
+//! execution of IBC logics.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+pub(crate) mod utils;
+
+mod context;
+pub use context::*;
+
+/// Re-exports ICS-24 data structures from `ibc-core-host-types` crate.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_host_types::*;
+}
diff --git a/ibc-core/ics24-host/src/utils.rs b/ibc-core/ics24-host/src/utils.rs
new file mode 100644
index 000000000..9ba2cbe08
--- /dev/null
+++ b/ibc-core/ics24-host/src/utils.rs
@@ -0,0 +1,47 @@
+use core::time::Duration;
+
+pub fn calculate_block_delay(
+    delay_period_time: &Duration,
+    max_expected_time_per_block: &Duration,
+) -> u64 {
+    let delay_period_time = delay_period_time.as_secs();
+    let max_expected_time_per_block = max_expected_time_per_block.as_secs();
+    if max_expected_time_per_block == 0 {
+        return 0;
+    }
+    if delay_period_time % max_expected_time_per_block == 0 {
+        return delay_period_time / max_expected_time_per_block;
+    }
+
+    // TODO: Use `u64::div_ceil` here instead
+    (delay_period_time / max_expected_time_per_block) + 1
+}
+
+#[cfg(test)]
+mod tests {
+
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case::remainder_zero(10, 2, 5)]
+    #[case::remainder_not_zero(10, 3, 4)]
+    #[case::max_expected_zero(10, 0, 0)]
+    #[case::delay_period_zero(0, 2, 0)]
+    #[case::both_zero(0, 0, 0)]
+    #[case::delay_less_than_max(10, 11, 1)]
+    fn test_calculate_block_delay_zero(
+        #[case] delay_period_time: u64,
+        #[case] max_expected_time_per_block: u64,
+        #[case] expected: u64,
+    ) {
+        assert_eq!(
+            calculate_block_delay(
+                &Duration::from_secs(delay_period_time),
+                &Duration::from_secs(max_expected_time_per_block)
+            ),
+            expected
+        );
+    }
+}
diff --git a/ibc-core/ics24-host/types/Cargo.toml b/ibc-core/ics24-host/types/Cargo.toml
new file mode 100644
index 000000000..8f725aef9
--- /dev/null
+++ b/ibc-core/ics24-host/types/Cargo.toml
@@ -0,0 +1,62 @@
+[package]
+name         = "ibc-core-host-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "host", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-24 Host Requirements data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh       = { workspace = true, optional = true }
+derive_more = { workspace = true }
+displaydoc  = { workspace = true }
+schemars    = { workspace = true, optional = true }
+serde       = { workspace = true, optional = true }
+
+# ibc dependencies
+ibc-primitives = { workspace = true }
+
+# parity dependencies
+parity-scale-codec  = { workspace = true, optional = true }
+scale-info          = { workspace = true, optional = true }
+
+[dev-dependencies]
+rstest = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-primitives/schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-primitives/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/ibc-core/ics24-host/types/src/error.rs b/ibc-core/ics24-host/types/src/error.rs
new file mode 100644
index 000000000..980a3a1c4
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/error.rs
@@ -0,0 +1,31 @@
+use displaydoc::Display;
+use ibc_primitives::prelude::*;
+
+#[cfg_attr(feature = "serde", derive(serde::Serialize))]
+#[derive(Debug, Display)]
+pub enum IdentifierError {
+    /// identifier `{id}` cannot contain separator '/'
+    ContainSeparator { id: String },
+    /// identifier `{id}` has invalid length `{length}` must be between `{min}`-`{max}` characters
+    InvalidLength {
+        id: String,
+        length: u64,
+        min: u64,
+        max: u64,
+    },
+    /// identifier `{id}` must only contain alphanumeric characters or `.`, `_`, `+`, `-`, `#`, - `[`, `]`, `<`, `>`
+    InvalidCharacter { id: String },
+    /// identifier prefix `{prefix}` is invalid
+    InvalidPrefix { prefix: String },
+    /// chain identifier is not formatted with revision number
+    UnformattedRevisionNumber { chain_id: String },
+    /// revision number overflowed
+    RevisionNumberOverflow,
+    /// String `{value}` cannot be converted to packet sequence, error: `{reason}`
+    InvalidStringAsSequence { value: String, reason: String },
+    /// identifier cannot be empty
+    Empty,
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for IdentifierError {}
diff --git a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
new file mode 100644
index 000000000..5b532aeef
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
@@ -0,0 +1,272 @@
+use core::fmt::{Debug, Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+use crate::validate::{
+    validate_identifier_chars, validate_identifier_length, validate_prefix_length,
+};
+
+/// Defines the domain type for chain identifiers.
+///
+/// A valid `ChainId` follows the format {chain name}-{revision number} where
+/// the revision number indicates how many times the chain has been upgraded.
+/// Creating `ChainId`s not in this format will result in an error.
+///
+/// It should be noted this format is not standardized yet, though it is widely
+/// accepted and compatible with Cosmos SDK driven chains.
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+pub struct ChainId {
+    id: String,
+    revision_number: u64,
+}
+
+impl ChainId {
+    /// Creates a new `ChainId` with the given chain identifier.
+    ///
+    /// It checks the identifier for valid characters according to `ICS-24`
+    /// specification and returns a `ChainId` successfully.
+    /// Stricter checks beyond `ICS-24` rests with the users,
+    /// based on their requirements.
+    ///
+    /// If the chain identifier is in the {chain name}-{revision number} format,
+    /// the revision number is parsed. Otherwise, revision number is set to 0.
+    ///
+    /// ```
+    /// use ibc_core_host_types::identifiers::ChainId;
+    ///
+    /// let chain_id = "chainA";
+    /// let id = ChainId::new(chain_id).unwrap();
+    /// assert_eq!(id.revision_number(), 0);
+    /// assert_eq!(id.as_str(), chain_id);
+    ///
+    /// let chain_id = "chainA-12";
+    /// let id = ChainId::new(chain_id).unwrap();
+    /// assert_eq!(id.revision_number(), 12);
+    /// assert_eq!(id.as_str(), chain_id);
+    /// ```
+    pub fn new(chain_id: &str) -> Result<Self, IdentifierError> {
+        Self::from_str(chain_id)
+    }
+
+    /// Get a reference to the underlying string.
+    pub fn as_str(&self) -> &str {
+        &self.id
+    }
+
+    pub fn split_chain_id(&self) -> Result<(&str, u64), IdentifierError> {
+        parse_chain_id_string(self.as_str())
+    }
+
+    /// Extract the revision number from the chain identifier
+    pub fn revision_number(&self) -> u64 {
+        self.revision_number
+    }
+
+    /// Increases `ChainId`s revision number by one.
+    /// Fails if the chain identifier is not in
+    /// `{chain_name}-{revision_number}` format or
+    /// the revision number overflows.
+    ///
+    /// ```
+    /// use ibc_core_host_types::identifiers::ChainId;
+    ///
+    /// let mut chain_id = ChainId::new("chainA-1").unwrap();
+    /// assert!(chain_id.increment_revision_number().is_ok());
+    /// assert_eq!(chain_id.revision_number(), 2);
+    ///
+    /// let mut chain_id = ChainId::new(&format!("chainA-{}", u64::MAX)).unwrap();
+    /// assert!(chain_id.increment_revision_number().is_err());
+    /// assert_eq!(chain_id.revision_number(), u64::MAX);
+    /// ```
+    pub fn increment_revision_number(&mut self) -> Result<(), IdentifierError> {
+        let (chain_name, _) = self.split_chain_id()?;
+        let inc_revision_number = self
+            .revision_number
+            .checked_add(1)
+            .ok_or(IdentifierError::RevisionNumberOverflow)?;
+        self.id = format!("{}-{}", chain_name, inc_revision_number);
+        self.revision_number = inc_revision_number;
+        Ok(())
+    }
+
+    /// A convenient method to check if the `ChainId` forms a valid identifier
+    /// with the desired min/max length. However, ICS-24 does not specify a
+    /// certain min or max lengths for chain identifiers.
+    pub fn validate_length(&self, min_length: u64, max_length: u64) -> Result<(), IdentifierError> {
+        match self.split_chain_id() {
+            Ok((chain_name, _)) => validate_prefix_length(chain_name, min_length, max_length),
+            _ => validate_identifier_length(&self.id, min_length, max_length),
+        }
+    }
+}
+
+/// Construct a `ChainId` from a string literal only if it forms a valid
+/// identifier.
+impl FromStr for ChainId {
+    type Err = IdentifierError;
+
+    fn from_str(id: &str) -> Result<Self, Self::Err> {
+        // Identifier string must have a maximum length of 64 characters.
+
+        // Validates the chain name for allowed characters according to ICS-24.
+        validate_identifier_chars(id)?;
+        match parse_chain_id_string(id) {
+            Ok((chain_name, revision_number)) => {
+                // Validate if the chain name with revision number has a valid length.
+                validate_prefix_length(chain_name, 1, 64)?;
+                Ok(Self {
+                    id: id.into(),
+                    revision_number,
+                })
+            }
+
+            _ => {
+                // Validate if the identifier has a valid length.
+                validate_identifier_length(id, 1, 64)?;
+                Ok(Self {
+                    id: id.into(),
+                    revision_number: 0,
+                })
+            }
+        }
+    }
+}
+
+impl Display for ChainId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.id)
+    }
+}
+
+/// Parses a string intended to represent a `ChainId` and, if successful,
+/// returns a tuple containing the chain name and revision number.
+fn parse_chain_id_string(chain_id_str: &str) -> Result<(&str, u64), IdentifierError> {
+    chain_id_str
+        .rsplit_once('-')
+        .filter(|(_, rev_number_str)| {
+            // Validates the revision number not to start with leading zeros, like "01".
+            // Zero is the only allowed revision number with leading zero.
+            rev_number_str.as_bytes().first() != Some(&b'0') || rev_number_str.len() == 1
+        })
+        .and_then(|(chain_name, rev_number_str)| {
+            // Parses the revision number string into a `u64` and checks its validity.
+            rev_number_str
+                .parse()
+                .ok()
+                .map(|revision_number| (chain_name, revision_number))
+        })
+        .ok_or(IdentifierError::UnformattedRevisionNumber {
+            chain_id: chain_id_str.to_string(),
+        })
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case("chainA-0", "chainA", 0)]
+    #[case("chainA-1", "chainA", 1)]
+    #[case("chainA--1", "chainA-", 1)]
+    #[case("chainA-1-2", "chainA-1", 2)]
+    #[case("111-2", "111", 2)]
+    #[case("----1", "---", 1)]
+    #[case("._+-1", "._+", 1)]
+    #[case(&("A".repeat(43) + "-3"), &("A".repeat(43)), 3)]
+    fn test_valid_chain_id_with_rev(
+        #[case] raw_chain_id: &str,
+        #[case] chain_name: &str,
+        #[case] revision_number: u64,
+    ) {
+        let chain_id = ChainId::new(raw_chain_id).unwrap();
+        assert!(chain_id.validate_length(1, 64).is_ok());
+        assert_eq!(
+            chain_id,
+            ChainId {
+                id: format!("{chain_name}-{revision_number}"),
+                revision_number
+            }
+        );
+    }
+
+    #[rstest]
+    #[case("chainA")]
+    #[case("chainA.2")]
+    #[case("123")]
+    #[case("._+")]
+    #[case("chainA-")]
+    #[case("chainA-a")]
+    #[case("chainA-01")]
+    #[case("chainA-1-")]
+    #[case(&"A".repeat(64))]
+    #[case::special_case("chainA-0")]
+    fn test_valid_chain_id_without_rev(#[case] chain_name: &str) {
+        let chain_id = ChainId::new(chain_name).unwrap();
+        assert!(chain_id.validate_length(1, 64).is_ok());
+        assert_eq!(
+            chain_id,
+            ChainId {
+                id: chain_name.into(),
+                revision_number: 0
+            }
+        );
+    }
+
+    #[rstest]
+    #[case(&"A".repeat(65))]
+    #[case(&("A".repeat(44) + "-123"))]
+    #[case("-1")]
+    #[case(" ----1")]
+    #[case(" ")]
+    #[case(" chainA")]
+    #[case("chain A")]
+    #[case(" chainA.2")]
+    #[case(" chainA.2-1")]
+    #[case(" 1")]
+    #[case(" -")]
+    #[case("   -1")]
+    #[case("/chainA-1")]
+    fn test_invalid_chain_id(#[case] chain_id_str: &str) {
+        assert!(ChainId::new(chain_id_str).is_err());
+    }
+
+    #[test]
+    fn test_inc_revision_number() {
+        let mut chain_id = ChainId::new("chainA-1").unwrap();
+
+        assert!(chain_id.increment_revision_number().is_ok());
+        assert_eq!(chain_id.revision_number(), 2);
+        assert_eq!(chain_id.as_str(), "chainA-2");
+
+        assert!(chain_id.increment_revision_number().is_ok());
+        assert_eq!(chain_id.revision_number(), 3);
+        assert_eq!(chain_id.as_str(), "chainA-3");
+    }
+
+    #[test]
+    fn test_failed_inc_revision_number() {
+        let mut chain_id = ChainId::new("chainA").unwrap();
+
+        assert!(chain_id.increment_revision_number().is_err());
+        assert_eq!(chain_id.revision_number(), 0);
+        assert_eq!(chain_id.as_str(), "chainA");
+    }
+}
diff --git a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
new file mode 100644
index 000000000..f4dc7e2fa
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
@@ -0,0 +1,100 @@
+use core::fmt::{Debug, Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+use crate::validate::validate_channel_identifier;
+
+const CHANNEL_ID_PREFIX: &str = "channel";
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+pub struct ChannelId(String);
+
+impl ChannelId {
+    /// Builds a new channel identifier. Like client and connection identifiers, channel ids are
+    /// deterministically formed from two elements: a prefix `prefix`, and a monotonically
+    /// increasing `counter`, separated by a dash "-".
+    /// The prefix is currently determined statically (see `ChannelId::prefix()`) so this method
+    /// accepts a single argument, the `counter`.
+    ///
+    /// ```
+    /// # use ibc_core_host_types::identifiers::ChannelId;
+    /// let chan_id = ChannelId::new(27);
+    /// assert_eq!(chan_id.to_string(), "channel-27");
+    /// ```
+    pub fn new(identifier: u64) -> Self {
+        let id = format!("{}-{}", Self::prefix(), identifier);
+        Self(id)
+    }
+
+    /// Returns the static prefix to be used across all channel identifiers.
+    pub fn prefix() -> &'static str {
+        CHANNEL_ID_PREFIX
+    }
+
+    /// Get this identifier as a borrowed `&str`
+    pub fn as_str(&self) -> &str {
+        &self.0
+    }
+
+    /// Get this identifier as a borrowed byte slice
+    pub fn as_bytes(&self) -> &[u8] {
+        self.0.as_bytes()
+    }
+}
+
+/// This implementation provides a `to_string` method.
+impl Display for ChannelId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ChannelId {
+    type Err = IdentifierError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        validate_channel_identifier(s).map(|_| Self(s.to_string()))
+    }
+}
+
+impl AsRef<str> for ChannelId {
+    fn as_ref(&self) -> &str {
+        &self.0
+    }
+}
+
+impl Default for ChannelId {
+    fn default() -> Self {
+        Self::new(0)
+    }
+}
+
+/// Equality check against string literal (satisfies &ChannelId == &str).
+/// ```
+/// use core::str::FromStr;
+/// use ibc_core_host_types::identifiers::ChannelId;
+/// let channel_id = ChannelId::from_str("channelId-0");
+/// assert!(channel_id.is_ok());
+/// channel_id.map(|id| {assert_eq!(&id, "channelId-0")});
+/// ```
+impl PartialEq<str> for ChannelId {
+    fn eq(&self, other: &str) -> bool {
+        self.as_str().eq(other)
+    }
+}
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_id.rs b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
new file mode 100644
index 000000000..627b0155f
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
@@ -0,0 +1,92 @@
+use core::fmt::{Debug, Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use derive_more::Into;
+use ibc_primitives::prelude::*;
+
+use super::ClientType;
+use crate::error::IdentifierError;
+use crate::validate::{validate_client_identifier, validate_client_type};
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
+pub struct ClientId(String);
+
+impl ClientId {
+    /// Builds a new client identifier. Client identifiers are deterministically formed from two
+    /// elements: a prefix derived from the client type `ctype`, and a monotonically increasing
+    /// `counter`; these are separated by a dash "-".
+    ///
+    /// ```
+    /// # use ibc_core_host_types::identifiers::ClientId;
+    /// # use ibc_core_host_types::identifiers::ClientType;
+    /// # use std::str::FromStr;
+    /// let tm_client_id = ClientId::new(ClientType::from_str("07-tendermint").unwrap(), 0);
+    /// assert!(tm_client_id.is_ok());
+    /// tm_client_id.map(|id| { assert_eq!(&id, "07-tendermint-0") });
+    /// ```
+    pub fn new(client_type: ClientType, counter: u64) -> Result<Self, IdentifierError> {
+        let prefix = client_type.as_str().trim();
+        validate_client_type(prefix)?;
+        let id = format!("{prefix}-{counter}");
+        Self::from_str(id.as_str())
+    }
+
+    /// Get this identifier as a borrowed `&str`
+    pub fn as_str(&self) -> &str {
+        &self.0
+    }
+
+    /// Get this identifier as a borrowed byte slice
+    pub fn as_bytes(&self) -> &[u8] {
+        self.0.as_bytes()
+    }
+}
+
+/// This implementation provides a `to_string` method.
+impl Display for ClientId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ClientId {
+    type Err = IdentifierError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        validate_client_identifier(s).map(|_| Self(s.to_string()))
+    }
+}
+
+impl Default for ClientId {
+    fn default() -> Self {
+        Self::from_str("07-tendermint-0").expect("Never fails because we use a valid client id")
+    }
+}
+
+/// Equality check against string literal (satisfies &ClientId == &str).
+/// ```
+/// use core::str::FromStr;
+/// use ibc_core_host_types::identifiers::ClientId;
+/// let client_id = ClientId::from_str("clientidtwo");
+/// assert!(client_id.is_ok());
+/// client_id.map(|id| {assert_eq!(&id, "clientidtwo")});
+/// ```
+impl PartialEq<str> for ClientId {
+    fn eq(&self, other: &str) -> bool {
+        self.as_str().eq(other)
+    }
+}
diff --git a/crates/ibc/src/core/ics02_client/client_type.rs b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
similarity index 89%
rename from crates/ibc/src/core/ics02_client/client_type.rs
rename to ibc-core/ics24-host/types/src/identifiers/client_type.rs
index b223fbdae..ff1968ebb 100644
--- a/crates/ibc/src/core/ics02_client/client_type.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
@@ -3,9 +3,10 @@
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
-use crate::core::ics24_host::identifier::validate::validate_client_type;
-use crate::core::ics24_host::identifier::IdentifierError;
-use crate::prelude::*;
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+use crate::validate::validate_client_type;
 
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
new file mode 100644
index 000000000..10a2c8857
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
@@ -0,0 +1,93 @@
+use core::fmt::{Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+use crate::validate::validate_connection_identifier;
+
+const CONNECTION_ID_PREFIX: &str = "connection";
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+pub struct ConnectionId(String);
+
+impl ConnectionId {
+    /// Builds a new connection identifier. Connection identifiers are deterministically formed from
+    /// two elements: a prefix `prefix`, and a monotonically increasing `counter`; these are
+    /// separated by a dash "-". The prefix is currently determined statically (see
+    /// `ConnectionId::prefix()`) so this method accepts a single argument, the `counter`.
+    ///
+    /// ```
+    /// # use ibc_core_host_types::identifiers::ConnectionId;
+    /// let conn_id = ConnectionId::new(11);
+    /// assert_eq!(&conn_id, "connection-11");
+    /// ```
+    pub fn new(identifier: u64) -> Self {
+        let id = format!("{}-{}", Self::prefix(), identifier);
+        Self(id)
+    }
+
+    /// Returns the static prefix to be used across all connection identifiers.
+    pub fn prefix() -> &'static str {
+        CONNECTION_ID_PREFIX
+    }
+
+    /// Get this identifier as a borrowed `&str`
+    pub fn as_str(&self) -> &str {
+        &self.0
+    }
+
+    /// Get this identifier as a borrowed byte slice
+    pub fn as_bytes(&self) -> &[u8] {
+        self.0.as_bytes()
+    }
+}
+
+/// This implementation provides a `to_string` method.
+impl Display for ConnectionId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ConnectionId {
+    type Err = IdentifierError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        validate_connection_identifier(s).map(|_| Self(s.to_string()))
+    }
+}
+
+impl Default for ConnectionId {
+    fn default() -> Self {
+        Self::new(0)
+    }
+}
+
+/// Equality check against string literal (satisfies &ConnectionId == &str).
+/// ```
+/// use core::str::FromStr;
+/// use ibc_core_host_types::identifiers::ConnectionId;
+/// let conn_id = ConnectionId::from_str("connectionId-0");
+/// assert!(conn_id.is_ok());
+/// conn_id.map(|id| {assert_eq!(&id, "connectionId-0")});
+/// ```
+impl PartialEq<str> for ConnectionId {
+    fn eq(&self, other: &str) -> bool {
+        self.as_str().eq(other)
+    }
+}
diff --git a/ibc-core/ics24-host/types/src/identifiers/mod.rs b/ibc-core/ics24-host/types/src/identifiers/mod.rs
new file mode 100644
index 000000000..9ae79f673
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/mod.rs
@@ -0,0 +1,17 @@
+//! Defines identifier types
+
+mod chain_id;
+mod channel_id;
+mod client_id;
+mod client_type;
+mod connection_id;
+mod port_id;
+mod sequence;
+
+pub use chain_id::ChainId;
+pub use channel_id::ChannelId;
+pub use client_id::ClientId;
+pub use client_type::ClientType;
+pub use connection_id::ConnectionId;
+pub use port_id::PortId;
+pub use sequence::Sequence;
diff --git a/ibc-core/ics24-host/types/src/identifiers/port_id.rs b/ibc-core/ics24-host/types/src/identifiers/port_id.rs
new file mode 100644
index 000000000..d1b640757
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/port_id.rs
@@ -0,0 +1,72 @@
+use core::fmt::{Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+use crate::validate::validate_port_identifier;
+
+const TRANSFER_PORT_ID: &str = "transfer";
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+pub struct PortId(String);
+
+impl PortId {
+    pub fn new(id: String) -> Result<Self, IdentifierError> {
+        Self::from_str(&id)
+    }
+
+    /// Infallible creation of the well-known transfer port
+    pub fn transfer() -> Self {
+        Self(TRANSFER_PORT_ID.to_string())
+    }
+
+    /// Get this identifier as a borrowed `&str`
+    pub fn as_str(&self) -> &str {
+        &self.0
+    }
+
+    /// Get this identifier as a borrowed byte slice
+    pub fn as_bytes(&self) -> &[u8] {
+        self.0.as_bytes()
+    }
+
+    pub fn validate(&self) -> Result<(), IdentifierError> {
+        validate_port_identifier(self.as_str())
+    }
+}
+
+/// This implementation provides a `to_string` method.
+impl Display for PortId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for PortId {
+    type Err = IdentifierError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        validate_port_identifier(s).map(|_| Self(s.to_string()))
+    }
+}
+
+impl AsRef<str> for PortId {
+    fn as_ref(&self) -> &str {
+        self.0.as_str()
+    }
+}
diff --git a/ibc-core/ics24-host/types/src/identifiers/sequence.rs b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
new file mode 100644
index 000000000..db6d9c560
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
@@ -0,0 +1,65 @@
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError;
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+/// The sequence number of a packet enforces ordering among packets from the same source.
+#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash, PartialOrd, Ord)]
+pub struct Sequence(u64);
+
+impl core::str::FromStr for Sequence {
+    type Err = IdentifierError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        Ok(Self::from(s.parse::<u64>().map_err(|e| {
+            IdentifierError::InvalidStringAsSequence {
+                value: s.to_string(),
+                reason: e.to_string(),
+            }
+        })?))
+    }
+}
+
+impl Sequence {
+    pub fn value(&self) -> u64 {
+        self.0
+    }
+    pub fn is_zero(&self) -> bool {
+        self.0 == 0
+    }
+
+    pub fn increment(&self) -> Sequence {
+        Sequence(self.0 + 1)
+    }
+}
+
+impl From<u64> for Sequence {
+    fn from(seq: u64) -> Self {
+        Sequence(seq)
+    }
+}
+
+impl From<Sequence> for u64 {
+    fn from(s: Sequence) -> u64 {
+        s.0
+    }
+}
+
+impl core::fmt::Display for Sequence {
+    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> Result<(), core::fmt::Error> {
+        write!(f, "{}", self.0)
+    }
+}
diff --git a/ibc-core/ics24-host/types/src/lib.rs b/ibc-core/ics24-host/types/src/lib.rs
new file mode 100644
index 000000000..f466de4c2
--- /dev/null
+++ b/ibc-core/ics24-host/types/src/lib.rs
@@ -0,0 +1,21 @@
+//! ICS-24: Host defines the minimal set of interfaces that a state machine
+//! hosting an IBC-enabled chain must implement.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod error;
+pub mod identifiers;
+pub mod path;
+pub(crate) mod validate;
diff --git a/crates/ibc/src/core/ics24_host/path.rs b/ibc-core/ics24-host/types/src/path.rs
similarity index 97%
rename from crates/ibc/src/core/ics24_host/path.rs
rename to ibc-core/ics24-host/types/src/path.rs
index 6630abbf0..ede974372 100644
--- a/crates/ibc/src/core/ics24_host/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -7,11 +7,9 @@
 use core::str::FromStr;
 
 use derive_more::{Display, From};
+use ibc_primitives::prelude::*;
 
-use crate::core::ics04_channel::packet::Sequence;
-use crate::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use crate::prelude::*;
-use crate::Height;
+use crate::identifiers::{ChannelId, ClientId, ConnectionId, PortId, Sequence};
 
 /// ABCI client upgrade keys
 /// - The key identifying the upgraded IBC state within the upgrade sub-store
@@ -76,19 +74,23 @@ impl ClientStatePath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "clients/{client_id}/consensusStates/{epoch}-{height}")]
+#[display(fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}")]
 pub struct ClientConsensusStatePath {
     pub client_id: ClientId,
-    pub epoch: u64,
-    pub height: u64,
+    pub revision_number: u64,
+    pub revision_height: u64,
 }
 
 impl ClientConsensusStatePath {
-    pub fn new(client_id: &ClientId, height: &Height) -> ClientConsensusStatePath {
+    pub fn new(
+        client_id: ClientId,
+        revision_number: u64,
+        revision_height: u64,
+    ) -> ClientConsensusStatePath {
         ClientConsensusStatePath {
-            client_id: client_id.clone(),
-            epoch: height.revision_number(),
-            height: height.revision_height(),
+            client_id,
+            revision_number,
+            revision_height,
         }
     }
 }
@@ -464,15 +466,15 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
             return None;
         }
 
-        let epoch = epoch_height[0];
-        let height = epoch_height[1];
+        let revision_number = epoch_height[0];
+        let revision_height = epoch_height[1];
 
-        let epoch = match epoch.parse::<u64>() {
+        let revision_number = match revision_number.parse::<u64>() {
             Ok(ep) => ep,
             Err(_) => return None,
         };
 
-        let height = match height.parse::<u64>() {
+        let revision_height = match revision_height.parse::<u64>() {
             Ok(h) => h,
             Err(_) => return None,
         };
@@ -480,8 +482,8 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
         Some(
             ClientConsensusStatePath {
                 client_id,
-                epoch,
-                height,
+                revision_number,
+                revision_height,
             }
             .into(),
         )
@@ -862,8 +864,8 @@ mod tests {
             parse_client_paths(&components),
             Some(Path::ClientConsensusState(ClientConsensusStatePath {
                 client_id: ClientId::default(),
-                epoch: 15,
-                height: 31,
+                revision_number: 15,
+                revision_height: 31,
             }))
         );
     }
@@ -890,8 +892,8 @@ mod tests {
             path.unwrap(),
             Path::ClientConsensusState(ClientConsensusStatePath {
                 client_id: ClientId::default(),
-                epoch: 15,
-                height: 31,
+                revision_number: 15,
+                revision_height: 31,
             })
         );
     }
diff --git a/crates/ibc/src/core/ics24_host/identifier/validate.rs b/ibc-core/ics24-host/types/src/validate.rs
similarity index 98%
rename from crates/ibc/src/core/ics24_host/identifier/validate.rs
rename to ibc-core/ics24-host/types/src/validate.rs
index c16fcdf12..5fb164020 100644
--- a/crates/ibc/src/core/ics24_host/identifier/validate.rs
+++ b/ibc-core/ics24-host/types/src/validate.rs
@@ -1,5 +1,6 @@
-use super::IdentifierError as Error;
-use crate::prelude::*;
+use ibc_primitives::prelude::*;
+
+use crate::error::IdentifierError as Error;
 
 /// Path separator (ie. forward slash '/')
 const PATH_SEPARATOR: char = '/';
@@ -113,7 +114,6 @@ pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
 #[cfg(test)]
 mod tests {
     use rstest::rstest;
-    use test_log::test;
 
     use super::*;
 
@@ -241,7 +241,6 @@ mod tests {
     #[case::u64_min_max_boundary("a", 3, 22, true)]
     #[case("chainA", 1, 32, true)]
     #[case("chainA", 1, 64, true)]
-    #[test_log::test]
     fn test_prefix_length_validation(
         #[case] prefix: &str,
         #[case] min: u64,
diff --git a/ibc-core/ics25-handler/Cargo.toml b/ibc-core/ics25-handler/Cargo.toml
new file mode 100644
index 000000000..ea8b1aea8
--- /dev/null
+++ b/ibc-core/ics25-handler/Cargo.toml
@@ -0,0 +1,76 @@
+[package]
+name         = "ibc-core-handler"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "handler"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, exposes IBC handler entry points for an integrated IBC core modules. 
+    These entry points are responsible for processing incoming IBC messages, performing validation,
+    and execution logic by invoking the appropriate module handler.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+ibc-core-client           = { workspace = true }
+ibc-core-connection       = { workspace = true }
+ibc-core-channel          = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-router           = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-core-host             = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-core-client/std",
+    "ibc-core-connection/std",
+    "ibc-core-channel/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host/std",
+    "ibc-core-router/std",
+    "ibc-core-handler-types/std",
+]
+serde = [
+    "ibc-core-client/serde",
+    "ibc-core-connection/serde",
+    "ibc-core-channel/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host/serde",
+    "ibc-core-router/serde",
+    "ibc-core-handler-types/serde",
+]
+borsh = [
+    "ibc-core-client/borsh",
+    "ibc-core-connection/borsh",
+    "ibc-core-channel/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host/borsh",
+    "ibc-core-router/borsh",
+    "ibc-core-handler-types/borsh",
+]
+schema = [
+    "ibc-core-client/schema",
+    "ibc-core-connection/schema",
+    "ibc-core-channel/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host/schema",
+    "ibc-core-router/schema",
+    "ibc-core-handler-types/schema",
+]
+parity-scale-codec = [
+    "ibc-core-client/parity-scale-codec",
+    "ibc-core-connection/parity-scale-codec",
+    "ibc-core-channel/parity-scale-codec",
+    "ibc-core-host/parity-scale-codec",
+    "ibc-core-router/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/crates/ibc/src/core/handler.rs b/ibc-core/ics25-handler/src/entrypoint.rs
similarity index 79%
rename from crates/ibc/src/core/handler.rs
rename to ibc-core/ics25-handler/src/entrypoint.rs
index 7c766a0dd..957e147c0 100644
--- a/crates/ibc/src/core/handler.rs
+++ b/ibc-core/ics25-handler/src/entrypoint.rs
@@ -1,44 +1,32 @@
-use super::context::RouterError;
-use super::ics02_client::handler::{create_client, update_client, upgrade_client};
-use super::ics02_client::msgs::{ClientMsg, MsgUpdateOrMisbehaviour};
-use super::ics03_connection::handler::{
-    conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try,
-};
-use super::ics03_connection::msgs::ConnectionMsg;
-use super::ics04_channel::handler::acknowledgement::{
-    acknowledgement_packet_execute, acknowledgement_packet_validate,
-};
-use super::ics04_channel::handler::chan_close_confirm::{
-    chan_close_confirm_execute, chan_close_confirm_validate,
-};
-use super::ics04_channel::handler::chan_close_init::{
-    chan_close_init_execute, chan_close_init_validate,
-};
-use super::ics04_channel::handler::chan_open_ack::{chan_open_ack_execute, chan_open_ack_validate};
-use super::ics04_channel::handler::chan_open_confirm::{
-    chan_open_confirm_execute, chan_open_confirm_validate,
-};
-use super::ics04_channel::handler::chan_open_init::{
-    chan_open_init_execute, chan_open_init_validate,
-};
-use super::ics04_channel::handler::chan_open_try::{chan_open_try_execute, chan_open_try_validate};
-use super::ics04_channel::handler::recv_packet::{recv_packet_execute, recv_packet_validate};
-use super::ics04_channel::handler::timeout::{
+use ibc_core_channel::handler::{
+    acknowledgement_packet_execute, acknowledgement_packet_validate, chan_close_confirm_execute,
+    chan_close_confirm_validate, chan_close_init_execute, chan_close_init_validate,
+    chan_open_ack_execute, chan_open_ack_validate, chan_open_confirm_execute,
+    chan_open_confirm_validate, chan_open_init_execute, chan_open_init_validate,
+    chan_open_try_execute, chan_open_try_validate, recv_packet_execute, recv_packet_validate,
     timeout_packet_execute, timeout_packet_validate, TimeoutMsgType,
 };
-use super::ics04_channel::msgs::{
+use ibc_core_channel::types::msgs::{
     channel_msg_to_port_id, packet_msg_to_port_id, ChannelMsg, PacketMsg,
 };
-use super::msgs::MsgEnvelope;
-use super::router::Router;
-use super::{ExecutionContext, ValidationContext};
+use ibc_core_client::handler::{create_client, update_client, upgrade_client};
+use ibc_core_client::types::msgs::{ClientMsg, MsgUpdateOrMisbehaviour};
+use ibc_core_connection::handler::{
+    conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try,
+};
+use ibc_core_connection::types::msgs::ConnectionMsg;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_handler_types::msgs::MsgEnvelope;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_router::router::Router;
+use ibc_core_router::types::error::RouterError;
 
 /// Entrypoint which performs both validation and message execution
 pub fn dispatch(
     ctx: &mut impl ExecutionContext,
     router: &mut impl Router,
     msg: MsgEnvelope,
-) -> Result<(), RouterError> {
+) -> Result<(), ContextError> {
     validate(ctx, router, msg.clone())?;
     execute(ctx, router, msg)
 }
@@ -51,7 +39,7 @@ pub fn dispatch(
 /// That is, the state transition of message `i` must be applied before
 /// message `i+1` is validated. This is equivalent to calling
 /// `dispatch()` on each successively.
-pub fn validate<Ctx>(ctx: &Ctx, router: &impl Router, msg: MsgEnvelope) -> Result<(), RouterError>
+pub fn validate<Ctx>(ctx: &Ctx, router: &impl Router, msg: MsgEnvelope) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
 {
@@ -65,15 +53,13 @@ where
                 update_client::validate(ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg))
             }
             ClientMsg::UpgradeClient(msg) => upgrade_client::validate(ctx, msg),
-        }
-        .map_err(RouterError::ContextError),
+        },
         MsgEnvelope::Connection(msg) => match msg {
             ConnectionMsg::OpenInit(msg) => conn_open_init::validate(ctx, msg),
             ConnectionMsg::OpenTry(msg) => conn_open_try::validate(ctx, msg),
             ConnectionMsg::OpenAck(msg) => conn_open_ack::validate(ctx, msg),
             ConnectionMsg::OpenConfirm(ref msg) => conn_open_confirm::validate(ctx, msg),
-        }
-        .map_err(RouterError::ContextError),
+        },
         MsgEnvelope::Channel(msg) => {
             let port_id = channel_msg_to_port_id(&msg);
             let module_id = router
@@ -93,7 +79,6 @@ where
                 ChannelMsg::CloseInit(msg) => chan_close_init_validate(ctx, module, msg),
                 ChannelMsg::CloseConfirm(msg) => chan_close_confirm_validate(ctx, module, msg),
             }
-            .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
             let port_id = packet_msg_to_port_id(&msg);
@@ -116,7 +101,6 @@ where
                     timeout_packet_validate(ctx, module, TimeoutMsgType::TimeoutOnClose(msg))
                 }
             }
-            .map_err(RouterError::ContextError)
         }
     }
 }
@@ -126,7 +110,7 @@ pub fn execute<Ctx>(
     ctx: &mut Ctx,
     router: &mut impl Router,
     msg: MsgEnvelope,
-) -> Result<(), RouterError>
+) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
 {
@@ -140,15 +124,13 @@ where
                 update_client::execute(ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg))
             }
             ClientMsg::UpgradeClient(msg) => upgrade_client::execute(ctx, msg),
-        }
-        .map_err(RouterError::ContextError),
+        },
         MsgEnvelope::Connection(msg) => match msg {
             ConnectionMsg::OpenInit(msg) => conn_open_init::execute(ctx, msg),
             ConnectionMsg::OpenTry(msg) => conn_open_try::execute(ctx, msg),
             ConnectionMsg::OpenAck(msg) => conn_open_ack::execute(ctx, msg),
             ConnectionMsg::OpenConfirm(ref msg) => conn_open_confirm::execute(ctx, msg),
-        }
-        .map_err(RouterError::ContextError),
+        },
         MsgEnvelope::Channel(msg) => {
             let port_id = channel_msg_to_port_id(&msg);
             let module_id = router
@@ -168,7 +150,6 @@ where
                 ChannelMsg::CloseInit(msg) => chan_close_init_execute(ctx, module, msg),
                 ChannelMsg::CloseConfirm(msg) => chan_close_confirm_execute(ctx, module, msg),
             }
-            .map_err(RouterError::ContextError)
         }
         MsgEnvelope::Packet(msg) => {
             let port_id = packet_msg_to_port_id(&msg);
@@ -191,7 +172,6 @@ where
                     timeout_packet_execute(ctx, module, TimeoutMsgType::TimeoutOnClose(msg))
                 }
             }
-            .map_err(RouterError::ContextError)
         }
     }
 }
diff --git a/ibc-core/ics25-handler/src/lib.rs b/ibc-core/ics25-handler/src/lib.rs
new file mode 100644
index 000000000..a9505d9aa
--- /dev/null
+++ b/ibc-core/ics25-handler/src/lib.rs
@@ -0,0 +1,26 @@
+//! Exposes IBC handler entry points for an integrated IBC core modules. These
+//! entry points are responsible for processing incoming IBC messages,
+//! performing validation, and execution logics by invoking the appropriate
+//! module handler.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+pub mod entrypoint;
+
+/// Re-export IBC handler types from `ibc-core-handler-types` crate.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_handler_types::*;
+}
diff --git a/ibc-core/ics25-handler/types/Cargo.toml b/ibc-core/ics25-handler/types/Cargo.toml
new file mode 100644
index 000000000..53eff8b37
--- /dev/null
+++ b/ibc-core/ics25-handler/types/Cargo.toml
@@ -0,0 +1,115 @@
+[package]
+name         = "ibc-core-handler-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "handler", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-25 Handler Interface data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+serde           = { workspace = true, optional = true }
+schemars        = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-client-types     = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-channel-types    = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-core-router-types     = { workspace = true }
+ibc-primitives            = { workspace = true }
+ibc-proto                 = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[dev-dependencies]
+ibc-testkit = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-core-client-types/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-channel-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-router-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "tendermint/std",
+    "ibc-testkit/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-channel-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-router-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+    "ibc-testkit/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core-client-types/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-channel-types/schema",
+    "ibc-core-commitment-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-router-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-channel-types/borsh",
+    "ibc-core-commitment-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-router-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-router-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/ibc-core/ics25-handler/types/src/error.rs b/ibc-core/ics25-handler/types/src/error.rs
new file mode 100644
index 000000000..5bea4b54d
--- /dev/null
+++ b/ibc-core/ics25-handler/types/src/error.rs
@@ -0,0 +1,48 @@
+//! Defines the context error type
+
+use derive_more::From;
+use displaydoc::Display;
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_client_types::error::ClientError;
+use ibc_core_connection_types::error::ConnectionError;
+use ibc_core_router_types::error::RouterError;
+use ibc_primitives::prelude::*;
+
+/// Top-level error
+#[derive(Debug, Display, From)]
+pub enum ContextError {
+    /// ICS02 Client error: {0}
+    ClientError(ClientError),
+    /// ICS03 Connection error: {0}
+    ConnectionError(ConnectionError),
+    /// ICS04 Channel error: {0}
+    ChannelError(ChannelError),
+    /// ICS04 Packet error: {0}
+    PacketError(PacketError),
+    /// ICS26 Routing error: {0}
+    RouterError(RouterError),
+}
+
+impl From<ContextError> for ClientError {
+    fn from(context_error: ContextError) -> Self {
+        match context_error {
+            ContextError::ClientError(e) => e,
+            _ => ClientError::Other {
+                description: context_error.to_string(),
+            },
+        }
+    }
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for ContextError {
+    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+        match self {
+            Self::ClientError(e) => Some(e),
+            Self::ConnectionError(e) => Some(e),
+            Self::ChannelError(e) => Some(e),
+            Self::PacketError(e) => Some(e),
+            Self::RouterError(e) => Some(e),
+        }
+    }
+}
diff --git a/crates/ibc/src/core/events.rs b/ibc-core/ics25-handler/types/src/events.rs
similarity index 76%
rename from crates/ibc/src/core/events.rs
rename to ibc-core/ics25-handler/types/src/events.rs
index b4a2b5292..56c236e91 100644
--- a/crates/ibc/src/core/events.rs
+++ b/ibc-core/ics25-handler/types/src/events.rs
@@ -1,18 +1,18 @@
-//! Events emitted during message handling
+//! Defines events emitted during handling of IBC messages
 
 use core::convert::{TryFrom, TryInto};
 
 use displaydoc::Display;
+use ibc_core_channel_types::{error as channel_error, events as ChannelEvents};
+use ibc_core_client_types::error as client_error;
+use ibc_core_client_types::events::{self as ClientEvents};
+use ibc_core_connection_types::{error as connection_error, events as ConnectionEvents};
+use ibc_core_host_types::error::IdentifierError;
+use ibc_core_router_types::event::ModuleEvent;
+use ibc_primitives::prelude::*;
+use ibc_primitives::ParseTimestampError;
 use tendermint::abci;
 
-use super::ics24_host::identifier::IdentifierError;
-use crate::core::ics02_client::error as client_error;
-use crate::core::ics02_client::events::{self as ClientEvents};
-use crate::core::ics03_connection::{error as connection_error, events as ConnectionEvents};
-use crate::core::ics04_channel::{error as channel_error, events as ChannelEvents};
-use crate::core::timestamp::ParseTimestampError;
-use crate::prelude::*;
-
 /// All error variants related to IBC events
 #[derive(Debug, Display)]
 pub enum Error {
@@ -122,7 +122,7 @@ impl TryFrom<IbcEvent> for abci::Event {
             IbcEvent::AcknowledgePacket(event) => event.try_into().map_err(Error::Channel)?,
             IbcEvent::TimeoutPacket(event) => event.try_into().map_err(Error::Channel)?,
             IbcEvent::ChannelClosed(event) => event.into(),
-            IbcEvent::Module(event) => event.try_into()?,
+            IbcEvent::Module(event) => event.into(),
             IbcEvent::Message(event) => abci::Event {
                 kind: MESSAGE_EVENT.to_string(),
                 attributes: vec![("module", event.module_attribute(), true).into()],
@@ -160,79 +160,6 @@ impl IbcEvent {
     }
 }
 
-/// The event type emitted by IBC applications
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Debug, Clone, PartialEq, Eq)]
-pub struct ModuleEvent {
-    pub kind: String,
-    pub attributes: Vec<ModuleEventAttribute>,
-}
-
-impl TryFrom<ModuleEvent> for abci::Event {
-    type Error = Error;
-
-    fn try_from(event: ModuleEvent) -> Result<Self, Self::Error> {
-        let attributes = event.attributes.into_iter().map(Into::into).collect();
-        Ok(abci::Event {
-            kind: event.kind,
-            attributes,
-        })
-    }
-}
-
-impl From<ModuleEvent> for IbcEvent {
-    fn from(e: ModuleEvent) -> Self {
-        IbcEvent::Module(e)
-    }
-}
-
-///  A single key/value pair in a [`ModuleEvent`]
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Debug, Clone, PartialEq, Eq)]
-pub struct ModuleEventAttribute {
-    pub key: String,
-    pub value: String,
-}
-
-impl<K: ToString, V: ToString> From<(K, V)> for ModuleEventAttribute {
-    fn from((k, v): (K, V)) -> Self {
-        Self {
-            key: k.to_string(),
-            value: v.to_string(),
-        }
-    }
-}
-
-impl From<ModuleEventAttribute> for abci::EventAttribute {
-    fn from(attr: ModuleEventAttribute) -> Self {
-        (attr.key, attr.value).into()
-    }
-}
-
 /// An event type that is emitted by the Cosmos SDK.
 ///
 /// We need to emit it as well, as currently [hermes] relies on it.
@@ -279,17 +206,22 @@ impl From<MessageEvent> for IbcEvent {
     }
 }
 
+impl From<ModuleEvent> for IbcEvent {
+    fn from(e: ModuleEvent) -> Self {
+        IbcEvent::Module(e)
+    }
+}
+
 #[cfg(test)]
 pub mod tests {
-    use alloc::vec;
 
+    use ibc_core_channel_types::channel::Order;
+    use ibc_core_channel_types::events::SendPacket;
+    use ibc_core_channel_types::packet::Packet;
+    use ibc_core_host_types::identifiers::ConnectionId;
     use ibc_testkit::utils::core::channel::dummy_raw_packet;
 
     use super::*;
-    use crate::core::ics04_channel::channel::Order;
-    use crate::core::ics04_channel::events::SendPacket;
-    use crate::core::ics04_channel::packet::Packet;
-    use crate::core::ics24_host::identifier::ConnectionId;
 
     #[test]
     /// Ensures that we don't panic when packet data is not valid UTF-8.
diff --git a/ibc-core/ics25-handler/types/src/lib.rs b/ibc-core/ics25-handler/types/src/lib.rs
new file mode 100644
index 000000000..60d03ad14
--- /dev/null
+++ b/ibc-core/ics25-handler/types/src/lib.rs
@@ -0,0 +1,21 @@
+//! Encapsulates essential data structures facilitating the seamless
+//! interaction between an implemented IBC module using ibc-rs and the
+//! underlying host blockchain.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod error;
+pub mod events;
+pub mod msgs;
diff --git a/ibc-core/ics25-handler/types/src/msgs.rs b/ibc-core/ics25-handler/types/src/msgs.rs
new file mode 100644
index 000000000..849bcaaf6
--- /dev/null
+++ b/ibc-core/ics25-handler/types/src/msgs.rs
@@ -0,0 +1,206 @@
+use ibc_core_channel_types::msgs::{
+    ChannelMsg, MsgAcknowledgement, MsgChannelCloseConfirm, MsgChannelCloseInit, MsgChannelOpenAck,
+    MsgChannelOpenConfirm, MsgChannelOpenInit, MsgChannelOpenTry, MsgRecvPacket, MsgTimeout,
+    MsgTimeoutOnClose, PacketMsg, ACKNOWLEDGEMENT_TYPE_URL, CHAN_CLOSE_CONFIRM_TYPE_URL,
+    CHAN_CLOSE_INIT_TYPE_URL, CHAN_OPEN_ACK_TYPE_URL, CHAN_OPEN_CONFIRM_TYPE_URL,
+    CHAN_OPEN_INIT_TYPE_URL, CHAN_OPEN_TRY_TYPE_URL, RECV_PACKET_TYPE_URL,
+    TIMEOUT_ON_CLOSE_TYPE_URL, TIMEOUT_TYPE_URL,
+};
+use ibc_core_client_types::msgs::{
+    ClientMsg, MsgCreateClient, MsgSubmitMisbehaviour, MsgUpdateClient, MsgUpgradeClient,
+    CREATE_CLIENT_TYPE_URL, SUBMIT_MISBEHAVIOUR_TYPE_URL, UPDATE_CLIENT_TYPE_URL,
+    UPGRADE_CLIENT_TYPE_URL,
+};
+use ibc_core_connection_types::msgs::{
+    ConnectionMsg, MsgConnectionOpenAck, MsgConnectionOpenConfirm, MsgConnectionOpenInit,
+    MsgConnectionOpenTry, CONN_OPEN_ACK_TYPE_URL, CONN_OPEN_CONFIRM_TYPE_URL,
+    CONN_OPEN_INIT_TYPE_URL, CONN_OPEN_TRY_TYPE_URL,
+};
+use ibc_core_router_types::error::RouterError;
+use ibc_primitives::prelude::*;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::Protobuf;
+
+/// Enumeration of all messages that the local ICS26 module is capable of routing.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
+pub enum MsgEnvelope {
+    Client(ClientMsg),
+    Connection(ConnectionMsg),
+    Channel(ChannelMsg),
+    Packet(PacketMsg),
+}
+
+impl TryFrom<Any> for MsgEnvelope {
+    type Error = RouterError;
+
+    fn try_from(any_msg: Any) -> Result<Self, Self::Error> {
+        match any_msg.type_url.as_str() {
+            // ICS2 messages
+            CREATE_CLIENT_TYPE_URL => {
+                // Pop out the message and then wrap it in the corresponding type.
+                let domain_msg = MsgCreateClient::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Client(ClientMsg::CreateClient(domain_msg)))
+            }
+            UPDATE_CLIENT_TYPE_URL => {
+                let domain_msg = MsgUpdateClient::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Client(ClientMsg::UpdateClient(domain_msg)))
+            }
+            UPGRADE_CLIENT_TYPE_URL => {
+                let domain_msg = MsgUpgradeClient::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Client(ClientMsg::UpgradeClient(domain_msg)))
+            }
+            SUBMIT_MISBEHAVIOUR_TYPE_URL => {
+                let domain_msg =
+                    MsgSubmitMisbehaviour::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
+                Ok(MsgEnvelope::Client(ClientMsg::Misbehaviour(domain_msg)))
+            }
+
+            // ICS03
+            CONN_OPEN_INIT_TYPE_URL => {
+                let domain_msg =
+                    MsgConnectionOpenInit::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
+                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenInit(domain_msg)))
+            }
+            CONN_OPEN_TRY_TYPE_URL => {
+                let domain_msg = MsgConnectionOpenTry::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenTry(domain_msg)))
+            }
+            CONN_OPEN_ACK_TYPE_URL => {
+                let domain_msg = MsgConnectionOpenAck::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenAck(domain_msg)))
+            }
+            CONN_OPEN_CONFIRM_TYPE_URL => {
+                let domain_msg =
+                    MsgConnectionOpenConfirm::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
+                Ok(MsgEnvelope::Connection(ConnectionMsg::OpenConfirm(
+                    domain_msg,
+                )))
+            }
+
+            // ICS04 channel messages
+            CHAN_OPEN_INIT_TYPE_URL => {
+                let domain_msg = MsgChannelOpenInit::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::OpenInit(domain_msg)))
+            }
+            CHAN_OPEN_TRY_TYPE_URL => {
+                let domain_msg = MsgChannelOpenTry::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::OpenTry(domain_msg)))
+            }
+            CHAN_OPEN_ACK_TYPE_URL => {
+                let domain_msg = MsgChannelOpenAck::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::OpenAck(domain_msg)))
+            }
+            CHAN_OPEN_CONFIRM_TYPE_URL => {
+                let domain_msg =
+                    MsgChannelOpenConfirm::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::OpenConfirm(domain_msg)))
+            }
+            CHAN_CLOSE_INIT_TYPE_URL => {
+                let domain_msg = MsgChannelCloseInit::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::CloseInit(domain_msg)))
+            }
+            CHAN_CLOSE_CONFIRM_TYPE_URL => {
+                let domain_msg =
+                    MsgChannelCloseConfirm::decode_vec(&any_msg.value).map_err(|e| {
+                        RouterError::MalformedMessageBytes {
+                            reason: e.to_string(),
+                        }
+                    })?;
+                Ok(MsgEnvelope::Channel(ChannelMsg::CloseConfirm(domain_msg)))
+            }
+            // ICS04 packet messages
+            RECV_PACKET_TYPE_URL => {
+                let domain_msg = MsgRecvPacket::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Packet(PacketMsg::Recv(domain_msg)))
+            }
+            ACKNOWLEDGEMENT_TYPE_URL => {
+                let domain_msg = MsgAcknowledgement::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Packet(PacketMsg::Ack(domain_msg)))
+            }
+            TIMEOUT_TYPE_URL => {
+                let domain_msg = MsgTimeout::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Packet(PacketMsg::Timeout(domain_msg)))
+            }
+            TIMEOUT_ON_CLOSE_TYPE_URL => {
+                let domain_msg = MsgTimeoutOnClose::decode_vec(&any_msg.value).map_err(|e| {
+                    RouterError::MalformedMessageBytes {
+                        reason: e.to_string(),
+                    }
+                })?;
+                Ok(MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(domain_msg)))
+            }
+            _ => Err(RouterError::UnknownMessageTypeUrl {
+                url: any_msg.type_url,
+            }),
+        }
+    }
+}
diff --git a/ibc-core/ics26-routing/Cargo.toml b/ibc-core/ics26-routing/Cargo.toml
new file mode 100644
index 000000000..6fedc2fc9
--- /dev/null
+++ b/ibc-core/ics26-routing/Cargo.toml
@@ -0,0 +1,66 @@
+[package]
+name         = "ibc-core-router"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "routing"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains necessary traits to implement the routing and callback functionality
+    (IBC router module) used for connecting the application layer to the transport layer of an IBC enabled chain.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-primitives         = { workspace = true }
+ibc-core-channel-types = { workspace = true }
+ibc-core-host-types    = { workspace = true }
+ibc-core-router-types  = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "subtle-encoding/std",
+    "ibc-primitives/std",
+    "ibc-core-channel-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-router-types/std",
+]
+serde = [
+    "ibc-primitives/serde",
+    "ibc-core-channel-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-router-types/serde",
+]
+borsh = [
+    "ibc-primitives/borsh",
+    "ibc-core-channel-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-router-types/borsh",
+]
+schema = [
+    "ibc-core-channel-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-router-types/schema",
+    "ibc-primitives/schema",
+]
+parity-scale-codec = [
+    "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-router-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
diff --git a/ibc-core/ics26-routing/src/lib.rs b/ibc-core/ics26-routing/src/lib.rs
new file mode 100644
index 000000000..b5b585ee5
--- /dev/null
+++ b/ibc-core/ics26-routing/src/lib.rs
@@ -0,0 +1,24 @@
+//! This library contains necessary traits to implement an IBC router module when integrating with `ibc-rs`.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod module;
+pub mod router;
+
+/// Re-exports router data structures from the `ibc-core-router-types` crate
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_core_router_types::*;
+}
diff --git a/crates/ibc/src/core/router.rs b/ibc-core/ics26-routing/src/module.rs
similarity index 58%
rename from crates/ibc/src/core/router.rs
rename to ibc-core/ics26-routing/src/module.rs
index 4cdb66524..26b296713 100644
--- a/crates/ibc/src/core/router.rs
+++ b/ibc-core/ics26-routing/src/module.rs
@@ -1,99 +1,16 @@
-//! Defines the `Router`, which binds modules to ports
-
-use alloc::borrow::Borrow;
-use core::fmt::{Debug, Display, Error as FmtError, Formatter};
-
-use crate::core::events::ModuleEvent;
-use crate::core::ics04_channel::acknowledgement::Acknowledgement;
-use crate::core::ics04_channel::channel::{Counterparty, Order};
-use crate::core::ics04_channel::error::{ChannelError, PacketError};
-use crate::core::ics04_channel::packet::Packet;
-use crate::core::ics04_channel::Version;
-use crate::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use crate::prelude::*;
-use crate::signer::Signer;
-
-/// Router as defined in ICS-26, which binds modules to ports.
-pub trait Router {
-    /// Returns a reference to a `Module` registered against the specified `ModuleId`
-    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module>;
-
-    /// Returns a mutable reference to a `Module` registered against the specified `ModuleId`
-    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module>;
-
-    /// Return the module_id associated with a given port_id
-    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId>;
-}
-
-/// Module name, internal to the chain.
-///
-/// That is, the IBC protocol never exposes this name. Note that this is
-/// different from IBC host [identifiers][crate::core::ics24_host::identifier],
-/// which are exposed to other chains by the protocol.
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
-pub struct ModuleId(String);
-
-impl ModuleId {
-    pub fn new(s: String) -> Self {
-        Self(s)
-    }
-}
-
-impl Display for ModuleId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
-impl Borrow<str> for ModuleId {
-    fn borrow(&self) -> &str {
-        self.0.as_str()
-    }
-}
-
-/// Logs and events produced during module callbacks
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug)]
-pub struct ModuleExtras {
-    pub events: Vec<ModuleEvent>,
-    pub log: Vec<String>,
-}
-
-impl ModuleExtras {
-    pub fn empty() -> Self {
-        ModuleExtras {
-            events: Vec::new(),
-            log: Vec::new(),
-        }
-    }
-}
-
 /// The trait that defines an IBC application
+use core::fmt::Debug;
+
+use ibc_core_channel_types::acknowledgement::Acknowledgement;
+use ibc_core_channel_types::channel::{Counterparty, Order};
+use ibc_core_channel_types::error::{ChannelError, PacketError};
+use ibc_core_channel_types::packet::Packet;
+use ibc_core_channel_types::Version;
+use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc_core_router_types::module::ModuleExtras;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
+
 pub trait Module: Debug {
     fn on_chan_open_init_validate(
         &self,
diff --git a/ibc-core/ics26-routing/src/router.rs b/ibc-core/ics26-routing/src/router.rs
new file mode 100644
index 000000000..b73d16d5c
--- /dev/null
+++ b/ibc-core/ics26-routing/src/router.rs
@@ -0,0 +1,18 @@
+//! Defines the `Router`, which binds modules to ports
+
+use ibc_core_host_types::identifiers::PortId;
+use ibc_core_router_types::module::ModuleId;
+
+use crate::module::Module;
+
+/// Router as defined in ICS-26, which binds modules to ports.
+pub trait Router {
+    /// Returns a reference to a `Module` registered against the specified `ModuleId`
+    fn get_route(&self, module_id: &ModuleId) -> Option<&dyn Module>;
+
+    /// Returns a mutable reference to a `Module` registered against the specified `ModuleId`
+    fn get_route_mut(&mut self, module_id: &ModuleId) -> Option<&mut dyn Module>;
+
+    /// Return the module_id associated with a given port_id
+    fn lookup_module(&self, port_id: &PortId) -> Option<ModuleId>;
+}
diff --git a/ibc-core/ics26-routing/types/Cargo.toml b/ibc-core/ics26-routing/types/Cargo.toml
new file mode 100644
index 000000000..8974821ea
--- /dev/null
+++ b/ibc-core/ics26-routing/types/Cargo.toml
@@ -0,0 +1,84 @@
+[package]
+name         = "ibc-core-router-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "routing", "types"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-26 Routing Module data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+prost           = { workspace = true }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+
+# ibc dependencies
+ibc-core-host-types    = { workspace = true }
+ibc-primitives         = { workspace = true }
+ibc-proto              = {workspace = true }
+ics23                  = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "subtle-encoding/std",
+    "ibc-primitives/std",
+    "ibc-core-host-types/std",
+    "ibc-proto/std",
+    "ics23/std",
+    "tendermint/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-primitives/serde",
+    "ibc-core-host-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+    "ics23/serde",
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-primitives/borsh",
+    "ibc-proto/borsh",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core-host-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/ibc-core/ics26-routing/types/src/error.rs b/ibc-core/ics26-routing/types/src/error.rs
new file mode 100644
index 000000000..01fb3c6c6
--- /dev/null
+++ b/ibc-core/ics26-routing/types/src/error.rs
@@ -0,0 +1,19 @@
+use displaydoc::Display;
+use ibc_core_host_types::identifiers::PortId;
+use ibc_primitives::prelude::*;
+
+/// Error type for the router module.
+#[derive(Debug, Display)]
+pub enum RouterError {
+    /// unknown type URL `{url}`
+    UnknownMessageTypeUrl { url: String },
+    /// the message is malformed and cannot be decoded error: `{reason}`
+    MalformedMessageBytes { reason: String },
+    /// port `{port_id}` is unknown
+    UnknownPort { port_id: PortId },
+    /// module not found
+    ModuleNotFound,
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for RouterError {}
diff --git a/ibc-core/ics26-routing/types/src/event.rs b/ibc-core/ics26-routing/types/src/event.rs
new file mode 100644
index 000000000..b3754b2d7
--- /dev/null
+++ b/ibc-core/ics26-routing/types/src/event.rs
@@ -0,0 +1,67 @@
+use ibc_primitives::prelude::*;
+use tendermint::abci;
+
+/// The event type emitted by IBC applications
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct ModuleEvent {
+    pub kind: String,
+    pub attributes: Vec<ModuleEventAttribute>,
+}
+
+impl From<ModuleEvent> for abci::Event {
+    fn from(event: ModuleEvent) -> Self {
+        let attributes = event.attributes.into_iter().map(Into::into).collect();
+        abci::Event {
+            kind: event.kind,
+            attributes,
+        }
+    }
+}
+
+///  A single key/value pair in a [`ModuleEvent`]
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Debug, Clone, PartialEq, Eq)]
+pub struct ModuleEventAttribute {
+    pub key: String,
+    pub value: String,
+}
+
+impl<K: ToString, V: ToString> From<(K, V)> for ModuleEventAttribute {
+    fn from((k, v): (K, V)) -> Self {
+        Self {
+            key: k.to_string(),
+            value: v.to_string(),
+        }
+    }
+}
+
+impl From<ModuleEventAttribute> for abci::EventAttribute {
+    fn from(attr: ModuleEventAttribute) -> Self {
+        (attr.key, attr.value).into()
+    }
+}
diff --git a/ibc-core/ics26-routing/types/src/lib.rs b/ibc-core/ics26-routing/types/src/lib.rs
new file mode 100644
index 000000000..6ca759f79
--- /dev/null
+++ b/ibc-core/ics26-routing/types/src/lib.rs
@@ -0,0 +1,24 @@
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+extern crate alloc;
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod error;
+pub mod event;
+pub mod module;
+
+pub mod primitives {
+    pub use ibc_primitives::*;
+}
diff --git a/ibc-core/ics26-routing/types/src/module.rs b/ibc-core/ics26-routing/types/src/module.rs
new file mode 100644
index 000000000..82867fde0
--- /dev/null
+++ b/ibc-core/ics26-routing/types/src/module.rs
@@ -0,0 +1,74 @@
+use alloc::borrow::Borrow;
+use core::fmt::{Debug, Display, Error as FmtError, Formatter};
+
+use ibc_primitives::prelude::*;
+
+use crate::event::ModuleEvent;
+
+/// Module name, internal to the chain.
+///
+/// That is, the IBC protocol never exposes this name. Note that this is
+/// different from IBC host [identifiers][ibc_core_host_types::identifiers],
+/// which are exposed to other chains by the protocol.
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
+pub struct ModuleId(String);
+
+impl ModuleId {
+    pub fn new(s: String) -> Self {
+        Self(s)
+    }
+}
+
+impl Display for ModuleId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl Borrow<str> for ModuleId {
+    fn borrow(&self) -> &str {
+        self.0.as_str()
+    }
+}
+
+/// Logs and events produced during module callbacks
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug)]
+pub struct ModuleExtras {
+    pub events: Vec<ModuleEvent>,
+    pub log: Vec<String>,
+}
+
+impl ModuleExtras {
+    pub fn empty() -> Self {
+        ModuleExtras {
+            events: Vec::new(),
+            log: Vec::new(),
+        }
+    }
+}
diff --git a/ibc-core/src/lib.rs b/ibc-core/src/lib.rs
new file mode 100644
index 000000000..444129f02
--- /dev/null
+++ b/ibc-core/src/lib.rs
@@ -0,0 +1,67 @@
+//! Re-exports data structures and implementations of all the IBC core (TAO) modules/components.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+/// Re-exports IBC handler entrypoints from the `ibc-core-handler` crate for
+/// added convenience.
+pub mod entrypoint {
+    #[doc(inline)]
+    pub use ibc_core_handler::entrypoint::*;
+}
+
+/// Re-exports IBC primitive types from the `ibc-primitives` crate
+pub mod primitives {
+    #[doc(inline)]
+    pub use ibc_primitives::*;
+}
+
+/// Re-exports ICS-02 implementation from the `ibc-core-client` crate
+pub mod client {
+    #[doc(inline)]
+    pub use ibc_core_client::*;
+}
+
+/// Re-exports ICS-03 implementation from the `ibc-core-connection` crate
+pub mod connection {
+    #[doc(inline)]
+    pub use ibc_core_connection::*;
+}
+
+/// Re-exports ICS-04 implementation from the `ibc-core-channel` crate
+pub mod channel {
+    #[doc(inline)]
+    pub use ibc_core_channel::*;
+}
+
+/// Re-exports ICS-23 data structures from the `ibc-core-commitment-types` crate
+pub mod commitment_types {
+    #[doc(inline)]
+    pub use ibc_core_commitment_types::*;
+}
+
+/// Re-exports ICS-24 implementation from the `ibc-core-host` crate
+pub mod host {
+    #[doc(inline)]
+    pub use ibc_core_host::*;
+}
+
+/// Re-exports ICS-25 implementation from the `ibc-core-handler` crate
+pub mod handler {
+    #[doc(inline)]
+    pub use ibc_core_handler::*;
+}
+
+/// Re-exports ICS-26 implementation from the `ibc-core-router` crate
+pub mod router {
+    #[doc(inline)]
+    pub use ibc_core_router::*;
+}
diff --git a/ibc-data-types/Cargo.toml b/ibc-data-types/Cargo.toml
new file mode 100644
index 000000000..d47bd254e
--- /dev/null
+++ b/ibc-data-types/Cargo.toml
@@ -0,0 +1,83 @@
+[package]
+name         = "ibc-data-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, delineates standard data structures and domain types of the Inter-Blockchain Communication (IBC) protocol. 
+    Designed for universal application, enabling diverse projects across IBC ecosystem to build using a shared language.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+ibc-app-transfer-types    = { workspace = true }
+ibc-core-client-types     = { workspace = true }
+ibc-core-connection-types = { workspace = true }
+ibc-core-channel-types    = { workspace = true }
+ibc-core-commitment-types = { workspace = true }
+ibc-core-host-types       = { workspace = true }
+ibc-core-router-types     = { workspace = true }
+ibc-core-handler-types    = { workspace = true }
+ibc-primitives            = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-app-transfer-types/std",
+    "ibc-core-client-types/std",
+    "ibc-core-connection-types/std",
+    "ibc-core-channel-types/std",
+    "ibc-core-commitment-types/std",
+    "ibc-core-host-types/std",
+    "ibc-core-router-types/std",
+    "ibc-core-handler-types/std",
+    "ibc-primitives/std",
+]
+serde = [
+    "ibc-app-transfer-types/serde",
+    "ibc-core-client-types/serde",
+    "ibc-core-connection-types/serde",
+    "ibc-core-channel-types/serde",
+    "ibc-core-commitment-types/serde",
+    "ibc-core-host-types/serde",
+    "ibc-core-router-types/serde",
+    "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
+]
+borsh = [
+    "ibc-app-transfer-types/borsh",
+    "ibc-core-client-types/borsh",
+    "ibc-core-connection-types/borsh",
+    "ibc-core-channel-types/borsh",
+    "ibc-core-host-types/borsh",
+    "ibc-core-router-types/borsh",
+    "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
+]
+schema = [
+    "ibc-app-transfer-types/schema",
+    "ibc-core-client-types/schema",
+    "ibc-core-connection-types/schema",
+    "ibc-core-channel-types/schema",
+    "ibc-core-host-types/schema",
+    "ibc-core-router-types/schema",
+    "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
+]
+parity-scale-codec = [
+    "ibc-app-transfer-types/parity-scale-codec",
+    "ibc-core-client-types/parity-scale-codec",
+    "ibc-core-connection-types/parity-scale-codec",
+    "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-router-types/parity-scale-codec",
+    "ibc-core-handler-types/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/ibc-data-types/README.md b/ibc-data-types/README.md
new file mode 100644
index 000000000..0beb79852
--- /dev/null
+++ b/ibc-data-types/README.md
@@ -0,0 +1,50 @@
+# IBC Types
+
+This crate serves as a central hub for re-exporting the implemented
+Inter-Blockchain Communication (IBC) data structures. It simplifies the
+integration of various IBC domain types into your project. IBC is a distributed
+protocol facilitating communication between independent sovereign blockchains
+and The IBC data structures within this crate abstract various IBC
+specifications, offering a convenient means to encode and decode IBC messages to
+and from proto types exposed by
+[`ibc-proto`](https://github.com/cosmos/ibc-proto-rs) crate. Additionally, it
+supports parsing events to and from ABCI event types.
+
+## Sub-Crates
+
+This crate organizes data structures into three main modules: `core`, `clients`,
+and `apps`. Each category further re-exports its respective sub data structures,
+providing a clear and modular path for easy navigation and usage:
+
+### Core
+
+| <div style="width:300px">Specification</div> | Crate |
+| ------------------------------------------- | ------ |
+| ICS-02: Client Semantics                    | [ibc-core-client-types](./../ibc-core/ics02-client/types) |
+| ICS-03: Connection Semantics                | [ibc-core-connection-types](./../ibc-core/ics03-connection/types) |
+| ICS-04: Channel and Packet Semantics        | [ibc-core-channel-types](./../ibc-core/ics04-channel/types) |
+| ICS-24: Host Requirements                   | [ibc-core-host-types](./../ibc-core/ics24-host/types) |
+| ICS-25: Handler Interface                   | [ibc-core-handler-types](./../ibc-core/ics25-handler/types) |
+| ICS-26: Routing Module                      | [ibc-core-routing-types](./../ibc-core/ics26-routing/types) |
+
+### Clients
+
+| <div style="width:300px">Specification</div> | Crate |
+| ------------------------------------------- | ------ |
+| ICS-07: Tendermint Client                   | [ibc-client-tendermint-types](./../ibc-clients/ics07-tendermint/types) |
+
+### Apps
+
+| <div style="width:300px">Specification</div> | Crate |
+| ------------------------------------------- | ------ |
+| ICS-20: Fungible Token Transfer             | [ibc-app-transfer-types](./../ibc-apps/ics20-transfer/types) |
+
+## Contributing
+
+IBC is specified in English in the [cosmos/ibc
+repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
+should be contributed there.
+
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./../CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
diff --git a/ibc-data-types/src/lib.rs b/ibc-data-types/src/lib.rs
new file mode 100644
index 000000000..9e849a593
--- /dev/null
+++ b/ibc-data-types/src/lib.rs
@@ -0,0 +1,77 @@
+//! Re-exports data structures of various specifications within the
+//! Inter-Blockchain Communication (IBC) protocol. Designed for universal
+//! application, enabling diverse projects across IBC ecosystem to build using a
+//! shared language.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+/// Re-exports IBC primitive types from the `ibc-primitives` crate
+pub mod primitives {
+    #[doc(inline)]
+    pub use ibc_primitives::*;
+}
+
+/// Re-exports data structures of all IBC core specifications
+pub mod core {
+    /// Re-exports ICS-02 client data structures from the
+    /// `ibc-core-client-types` crate
+    pub mod client {
+        #[doc(inline)]
+        pub use ibc_core_client_types::*;
+    }
+    /// Re-exports ICS-03 connection data structures from the
+    /// `ibc-core-connection-types` crate
+    pub mod connection {
+        #[doc(inline)]
+        pub use ibc_core_connection_types::*;
+    }
+    /// Re-exports ICS-04 channel data structures from the
+    /// `ibc-core-channel-types` crate
+    pub mod channel {
+        #[doc(inline)]
+        pub use ibc_core_channel_types::*;
+    }
+    /// Re-exports ICS-23 commitment data structures from the
+    /// `ibc-core-commitment-types` crate
+    pub mod commitment {
+        #[doc(inline)]
+        pub use ibc_core_commitment_types::*;
+    }
+    /// Re-exports ICS-24 host data structures from the `ibc-core-host-types`
+    /// crate
+    pub mod host {
+        #[doc(inline)]
+        pub use ibc_core_host_types::*;
+    }
+    /// Re-exports ICS-25 handler data structures from the
+    /// `ibc-core-handler-types` crate
+    pub mod handler {
+        #[doc(inline)]
+        pub use ibc_core_handler_types::*;
+    }
+    /// Re-exports ICS-26 routing data structures from the
+    /// `ibc-core-router-types` crate
+    pub mod router {
+        #[doc(inline)]
+        pub use ibc_core_router_types::*;
+    }
+}
+
+/// Re-exports data structures of various IBC applications
+pub mod apps {
+    /// Re-exports ICS-27 client update data structures from the
+    /// `ibc-core-client-types` crate
+    pub mod transfer {
+        #[doc(inline)]
+        pub use ibc_app_transfer_types::*;
+    }
+}
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
new file mode 100644
index 000000000..532f6f783
--- /dev/null
+++ b/ibc-derive/Cargo.toml
@@ -0,0 +1,17 @@
+[package]
+name        = "ibc-derive"
+version     = "0.3.0"
+license     = { workspace = true }
+repository  = { workspace = true }
+edition     = { workspace = true }
+readme      = "README.md"
+description = "Maintained by `ibc-rs`, macros implementations of #[derive(ClientState)] and #[derive(ConsensusState)]"
+
+[lib]
+proc-macro = true
+
+[dependencies]
+syn = "2"
+proc-macro2 = "1"
+quote = "1"
+darling = "0.20"
diff --git a/crates/ibc-derive/LICENSE b/ibc-derive/LICENSE
similarity index 100%
rename from crates/ibc-derive/LICENSE
rename to ibc-derive/LICENSE
diff --git a/ibc-derive/README.md b/ibc-derive/README.md
new file mode 100644
index 000000000..2742cb6ea
--- /dev/null
+++ b/ibc-derive/README.md
@@ -0,0 +1,9 @@
+# IBC Derive
+
+This crate provides a set of procedural macros for deriving IBC-related traits
+defined in the [`ibc-rs`](https://github.com/cosmos/ibc-rs) repository, reducing
+the amount of boilerplate code required to implement them. It contains macro
+implementations for the following traits:
+
+- [ClientState](./../ibc-core/ics02-client/context/src/client_state.rs)
+- [ConsensusState](./../ibc-core/ics02-client/context/src/consensus_state.rs)
diff --git a/crates/ibc-derive/src/client_state.rs b/ibc-derive/src/client_state.rs
similarity index 100%
rename from crates/ibc-derive/src/client_state.rs
rename to ibc-derive/src/client_state.rs
diff --git a/crates/ibc-derive/src/client_state/traits.rs b/ibc-derive/src/client_state/traits.rs
similarity index 100%
rename from crates/ibc-derive/src/client_state/traits.rs
rename to ibc-derive/src/client_state/traits.rs
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_common.rs b/ibc-derive/src/client_state/traits/client_state_common.rs
similarity index 100%
rename from crates/ibc-derive/src/client_state/traits/client_state_common.rs
rename to ibc-derive/src/client_state/traits/client_state_common.rs
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_execution.rs b/ibc-derive/src/client_state/traits/client_state_execution.rs
similarity index 100%
rename from crates/ibc-derive/src/client_state/traits/client_state_execution.rs
rename to ibc-derive/src/client_state/traits/client_state_execution.rs
diff --git a/crates/ibc-derive/src/client_state/traits/client_state_validation.rs b/ibc-derive/src/client_state/traits/client_state_validation.rs
similarity index 100%
rename from crates/ibc-derive/src/client_state/traits/client_state_validation.rs
rename to ibc-derive/src/client_state/traits/client_state_validation.rs
diff --git a/crates/ibc-derive/src/consensus_state.rs b/ibc-derive/src/consensus_state.rs
similarity index 100%
rename from crates/ibc-derive/src/consensus_state.rs
rename to ibc-derive/src/consensus_state.rs
diff --git a/crates/ibc-derive/src/lib.rs b/ibc-derive/src/lib.rs
similarity index 100%
rename from crates/ibc-derive/src/lib.rs
rename to ibc-derive/src/lib.rs
diff --git a/crates/ibc-derive/src/utils.rs b/ibc-derive/src/utils.rs
similarity index 71%
rename from crates/ibc-derive/src/utils.rs
rename to ibc-derive/src/utils.rs
index 333c18da2..3a1ea8b66 100644
--- a/crates/ibc-derive/src/utils.rs
+++ b/ibc-derive/src/utils.rs
@@ -10,67 +10,67 @@ pub struct Imports;
 
 impl Imports {
     pub fn CommitmentRoot() -> TokenStream {
-        quote! {ibc::core::ics23_commitment::commitment::CommitmentRoot}
+        quote! {ibc::core::commitment_types::commitment::CommitmentRoot}
     }
 
     pub fn CommitmentPrefix() -> TokenStream {
-        quote! {ibc::core::ics23_commitment::commitment::CommitmentPrefix}
+        quote! {ibc::core::commitment_types::commitment::CommitmentPrefix}
     }
 
     pub fn CommitmentProofBytes() -> TokenStream {
-        quote! {ibc::core::ics23_commitment::commitment::CommitmentProofBytes}
+        quote! {ibc::core::commitment_types::commitment::CommitmentProofBytes}
     }
 
     pub fn Path() -> TokenStream {
-        quote! {ibc::core::ics24_host::path::Path}
+        quote! {ibc::core::host::types::path::Path}
     }
 
     pub fn ConsensusState() -> TokenStream {
-        quote! {ibc::core::ics02_client::consensus_state::ConsensusState}
+        quote! {ibc::core::client::context::consensus_state::ConsensusState}
     }
 
     pub fn ClientStateCommon() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_state::ClientStateCommon}
+        quote! {ibc::core::client::context::client_state::ClientStateCommon}
     }
 
     pub fn ClientStateValidation() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_state::ClientStateValidation}
+        quote! {ibc::core::client::context::client_state::ClientStateValidation}
     }
 
     pub fn ClientStateExecution() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_state::ClientStateExecution}
+        quote! {ibc::core::client::context::client_state::ClientStateExecution}
     }
 
     pub fn ClientId() -> TokenStream {
-        quote! {ibc::core::ics24_host::identifier::ClientId}
+        quote! {ibc::core::host::types::identifiers::ClientId}
     }
 
     pub fn ClientType() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_type::ClientType}
+        quote! {ibc::core::host::types::identifiers::ClientType}
     }
 
     pub fn ClientError() -> TokenStream {
-        quote! {ibc::core::ics02_client::error::ClientError}
+        quote! {ibc::core::client::types::error::ClientError}
     }
 
     pub fn Height() -> TokenStream {
-        quote! {ibc::Height}
+        quote! {ibc::core::client::types::Height}
     }
 
     pub fn Any() -> TokenStream {
-        quote! {ibc::proto::Any}
+        quote! {ibc::primitives::proto::Any}
     }
 
     pub fn Timestamp() -> TokenStream {
-        quote! {ibc::core::timestamp::Timestamp}
+        quote! {ibc::core::primitives::Timestamp}
     }
 
     pub fn UpdateKind() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_state::UpdateKind}
+        quote! {ibc::core::client::types::UpdateKind}
     }
 
     pub fn Status() -> TokenStream {
-        quote! {ibc::core::ics02_client::client_state::Status}
+        quote! {ibc::core::client::types::Status}
     }
 }
 
diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
new file mode 100644
index 000000000..74f685233
--- /dev/null
+++ b/ibc-primitives/Cargo.toml
@@ -0,0 +1,68 @@
+[package]
+name         = "ibc-primitives"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, furnishes essential types and traits universally
+    utilized in the implementation of diverse IBC modules, encompassing
+    core functionalities, clients, and applications.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh       = { workspace = true, optional = true }
+derive_more = { workspace = true }
+displaydoc  = { workspace = true }
+prost       = { workspace = true }
+schemars    = { workspace = true, optional = true }
+serde       = { workspace = true, optional = true }
+time        = { workspace = true }
+
+# ibc dependencies
+ibc-proto = { workspace = true }
+
+# cosmos dependencies
+tendermint = { workspace = true }
+
+# parity dependencies
+parity-scale-codec  = { workspace = true, optional = true }
+scale-info          = { workspace = true, optional = true }
+
+[features]
+default = ["std"]
+std = [
+    "displaydoc/std",
+    "prost/std",
+    "serde/std",
+    "ibc-proto/std",
+    "tendermint/std",
+    "time/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/ibc-primitives/README.md b/ibc-primitives/README.md
new file mode 100644
index 000000000..3b4cc4ec8
--- /dev/null
+++ b/ibc-primitives/README.md
@@ -0,0 +1,5 @@
+# `ibc-primitives`
+
+This library furnishes essential types, traits, and utilities universally utilized in the
+implementation of diverse IBC modules, encompassing core functionalities,
+clients, and applications.
diff --git a/ibc-primitives/src/lib.rs b/ibc-primitives/src/lib.rs
new file mode 100644
index 000000000..0e4d4bcac
--- /dev/null
+++ b/ibc-primitives/src/lib.rs
@@ -0,0 +1,32 @@
+//! Contains primitives types and traits common to various IBC components.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+extern crate alloc;
+
+#[cfg(feature = "std")]
+extern crate std;
+
+pub mod prelude;
+pub mod utils;
+
+mod traits;
+pub use traits::*;
+
+mod types;
+pub use types::*;
+
+/// Re-export of common proto types from the `ibc-proto` crate.
+pub mod proto {
+    pub use ibc_proto::google::protobuf::Any;
+    pub use ibc_proto::Protobuf;
+}
diff --git a/crates/ibc/src/prelude.rs b/ibc-primitives/src/prelude.rs
similarity index 100%
rename from crates/ibc/src/prelude.rs
rename to ibc-primitives/src/prelude.rs
diff --git a/ibc-primitives/src/traits/mod.rs b/ibc-primitives/src/traits/mod.rs
new file mode 100644
index 000000000..9eccbc1ec
--- /dev/null
+++ b/ibc-primitives/src/traits/mod.rs
@@ -0,0 +1,3 @@
+mod msg;
+
+pub use msg::*;
diff --git a/ibc-primitives/src/traits/msg.rs b/ibc-primitives/src/traits/msg.rs
new file mode 100644
index 000000000..61eeb796a
--- /dev/null
+++ b/ibc-primitives/src/traits/msg.rs
@@ -0,0 +1,23 @@
+use ibc_proto::google::protobuf::Any;
+
+use crate::prelude::*;
+
+/// Trait to be implemented by all IBC messages
+pub trait Msg: Clone {
+    type Raw: From<Self> + prost::Message;
+
+    /// Unique type identifier for this message, to support encoding to/from `prost_types::Any`.
+    fn type_url(&self) -> String;
+
+    fn get_sign_bytes(self) -> Vec<u8> {
+        let raw_msg: Self::Raw = self.into();
+        prost::Message::encode_to_vec(&raw_msg)
+    }
+
+    fn to_any(self) -> Any {
+        Any {
+            type_url: self.type_url(),
+            value: self.get_sign_bytes(),
+        }
+    }
+}
diff --git a/ibc-primitives/src/types/mod.rs b/ibc-primitives/src/types/mod.rs
new file mode 100644
index 000000000..8df0d3c40
--- /dev/null
+++ b/ibc-primitives/src/types/mod.rs
@@ -0,0 +1,5 @@
+mod signer;
+mod timestamp;
+
+pub use signer::*;
+pub use timestamp::*;
diff --git a/crates/ibc/src/signer.rs b/ibc-primitives/src/types/signer.rs
similarity index 100%
rename from crates/ibc/src/signer.rs
rename to ibc-primitives/src/types/signer.rs
diff --git a/crates/ibc/src/core/timestamp.rs b/ibc-primitives/src/types/timestamp.rs
similarity index 98%
rename from crates/ibc/src/core/timestamp.rs
rename to ibc-primitives/src/types/timestamp.rs
index e7b22780d..ef54a4630 100644
--- a/crates/ibc/src/core/timestamp.rs
+++ b/ibc-primitives/src/types/timestamp.rs
@@ -1,4 +1,4 @@
-//! Defines the representation of timestamps used in packet timeouts
+//! Defines the representation of timestamps used in IBC.
 
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::hash::{Hash, Hasher};
@@ -15,7 +15,7 @@ use crate::prelude::*;
 
 pub const ZERO_DURATION: Duration = Duration::from_secs(0);
 
-/// A newtype wrapper over `Option<Time>` to keep track of
+/// A new type wrapper over `Option<Time>` to keep track of
 /// IBC packet timeout.
 ///
 /// We use an explicit `Option` type to distinguish this when converting between
@@ -170,7 +170,7 @@ impl Timestamp {
     /// Convert a `Timestamp` to `u64` value in nanoseconds. If no timestamp
     /// is set, the result is 0.
     /// ```
-    /// use ibc::core::timestamp::Timestamp;
+    /// use ibc_primitives::Timestamp;
     ///
     /// let max = u64::MAX;
     /// let tx = Timestamp::from_nanoseconds(max).unwrap();
@@ -317,7 +317,6 @@ mod tests {
     use core::time::Duration;
     use std::thread::sleep;
 
-    use test_log::test;
     use time::OffsetDateTime;
 
     use super::{Expiry, Timestamp, ZERO_DURATION};
diff --git a/crates/ibc/src/utils/macros.rs b/ibc-primitives/src/utils/macros.rs
similarity index 86%
rename from crates/ibc/src/utils/macros.rs
rename to ibc-primitives/src/utils/macros.rs
index c4ad6655d..e926ae23f 100644
--- a/crates/ibc/src/utils/macros.rs
+++ b/ibc-primitives/src/utils/macros.rs
@@ -1,4 +1,6 @@
-/// Downcast the given arguments to the associated enum variant.
+//! Macros used across the ibc-rs crates.
+
+/// Downcast an enum variant that contains a single value into its inner value.
 ///
 /// ## Note
 /// Only works for enums whose variants only hold a single value.
@@ -6,7 +8,7 @@
 /// ## Example
 ///
 /// ```rust
-/// use ibc::downcast;
+/// use ibc_primitives::downcast;
 ///
 /// enum Foo {
 ///     Bar(u32),
diff --git a/ibc-primitives/src/utils/mod.rs b/ibc-primitives/src/utils/mod.rs
new file mode 100644
index 000000000..cd8e30c13
--- /dev/null
+++ b/ibc-primitives/src/utils/mod.rs
@@ -0,0 +1,5 @@
+//! Contains various internally-used utilities.
+mod macros;
+pub mod pretty;
+
+pub use pretty::*;
diff --git a/crates/ibc/src/utils/pretty.rs b/ibc-primitives/src/utils/pretty.rs
similarity index 92%
rename from crates/ibc/src/utils/pretty.rs
rename to ibc-primitives/src/utils/pretty.rs
index 7089242cc..e250ee310 100644
--- a/crates/ibc/src/utils/pretty.rs
+++ b/ibc-primitives/src/utils/pretty.rs
@@ -1,5 +1,8 @@
+//! Pretty printing utilities.
+
 use core::fmt::{Display, Error as FmtError, Formatter};
 
+/// A slice type that implements the `Display` trait to pretty-print the contained elements.
 pub struct PrettySlice<'a, T>(pub &'a [T]);
 
 impl<'a, T: Display> Display for PrettySlice<'a, T> {
diff --git a/crates/ibc-query/Cargo.toml b/ibc-query/Cargo.toml
similarity index 83%
rename from crates/ibc-query/Cargo.toml
rename to ibc-query/Cargo.toml
index c6af07d99..3f6e4e14f 100644
--- a/crates/ibc-query/Cargo.toml
+++ b/ibc-query/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 readme       = "README.md"
 keywords     = ["blockchain", "cosmos", "ibc", "rpc", "grpc"]
 description  = """
-    'ibc-query' contains essential IBC query methods and 
+    Maintained by `ibc-rs`, contains essential IBC query methods and
     gRPC query service implementations for the IBC core.
 """
 
@@ -19,7 +19,7 @@ displaydoc = { version = "0.2", default-features = false }
 tonic = "0.10"
 
 # ibc dependencies
-ibc = { version = "0.47.0", path = "../ibc", default-features = false }
+ibc = { workspace = true }
 ibc-proto = { workspace = true, features = ["server"] }
 
 [features]
diff --git a/crates/ibc-query/LICENSE b/ibc-query/LICENSE
similarity index 100%
rename from crates/ibc-query/LICENSE
rename to ibc-query/LICENSE
diff --git a/ibc-query/README.md b/ibc-query/README.md
new file mode 100644
index 000000000..80117ebc8
--- /dev/null
+++ b/ibc-query/README.md
@@ -0,0 +1,7 @@
+# IBC Query
+
+This crate provides a set of utility traits and implementations for querying the
+state of an [`ibc-rs`](https://github.com/cosmos/ibc-rs) enabled chain.
+
+Implementations contain essential IBC query methods and gRPC query services for
+each of the IBC core client, connection, and channel layers.
diff --git a/crates/ibc-query/src/core/channel/mod.rs b/ibc-query/src/core/channel/mod.rs
similarity index 100%
rename from crates/ibc-query/src/core/channel/mod.rs
rename to ibc-query/src/core/channel/mod.rs
diff --git a/crates/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
similarity index 97%
rename from crates/ibc-query/src/core/channel/query.rs
rename to ibc-query/src/core/channel/query.rs
index e0cf5cbf6..5d9e22681 100644
--- a/crates/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -3,14 +3,13 @@
 use alloc::format;
 use core::str::FromStr;
 
-use ibc::core::ics04_channel::packet::Sequence;
-use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use ibc::core::ics24_host::path::{
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
+use ibc::core::host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
     ReceiptPath, SeqRecvPath,
 };
-use ibc::core::ValidationContext;
-use ibc::Height;
+use ibc::core::host::ValidationContext;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::{
     QueryChannelClientStateRequest, QueryChannelClientStateResponse,
@@ -194,7 +193,11 @@ where
             description: format!("Channel {} does not have a connection", channel_id),
         })??;
 
-    let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+    let consensus_path = ClientConsensusStatePath::new(
+        connection_end.client_id().clone(),
+        height.revision_number(),
+        height.revision_height(),
+    );
 
     let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
 
diff --git a/crates/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
similarity index 98%
rename from crates/ibc-query/src/core/channel/service.rs
rename to ibc-query/src/core/channel/service.rs
index 9e5d42263..4aeb18ddc 100644
--- a/crates/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -4,8 +4,8 @@
 
 use alloc::boxed::Box;
 
-use ibc::core::ValidationContext;
-use ibc::prelude::*;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
 use ibc_proto::ibc::core::channel::v1::{
diff --git a/crates/ibc-query/src/core/client/mod.rs b/ibc-query/src/core/client/mod.rs
similarity index 100%
rename from crates/ibc-query/src/core/client/mod.rs
rename to ibc-query/src/core/client/mod.rs
diff --git a/crates/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
similarity index 91%
rename from crates/ibc-query/src/core/client/query.rs
rename to ibc-query/src/core/client/query.rs
index 0f0923eba..93383b6b7 100644
--- a/crates/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -3,15 +3,15 @@
 use alloc::format;
 use core::str::FromStr;
 
-use ibc::core::ics02_client::client_state::ClientStateValidation;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::ics24_host::path::{
+use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::types::path::{
     ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
 };
-use ibc::core::ValidationContext;
-use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
-use ibc::Height;
+use ibc::core::host::ValidationContext;
+use ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::{
     ConsensusStateWithHeight, IdentifiedClientState, QueryClientStateRequest,
@@ -103,8 +103,11 @@ where
     } else {
         let height = Height::new(request.revision_number, request.revision_height)?;
 
-        let consensus_state =
-            ibc_ctx.consensus_state(&ClientConsensusStatePath::new(&client_id, &height))?;
+        let consensus_state = ibc_ctx.consensus_state(&ClientConsensusStatePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        ))?;
 
         (height, consensus_state)
     };
@@ -114,7 +117,11 @@ where
     let proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientConsensusState(ClientConsensusStatePath::new(&client_id, &height)),
+            &Path::ClientConsensusState(ClientConsensusStatePath::new(
+                client_id.clone(),
+                height.revision_number(),
+                height.revision_height(),
+            )),
         )
         .ok_or(QueryError::ProofNotFound {
             description: format!("Proof not found for consensus state path: {client_id:?}"),
diff --git a/crates/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
similarity index 97%
rename from crates/ibc-query/src/core/client/service.rs
rename to ibc-query/src/core/client/service.rs
index 817c95146..0aedd93a0 100644
--- a/crates/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -4,9 +4,9 @@
 
 use alloc::boxed::Box;
 
-use ibc::core::ValidationContext;
-use ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext;
-use ibc::prelude::*;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::query_server::Query as ClientQuery;
 use ibc_proto::ibc::core::client::v1::{
diff --git a/crates/ibc-query/src/core/connection/mod.rs b/ibc-query/src/core/connection/mod.rs
similarity index 100%
rename from crates/ibc-query/src/core/connection/mod.rs
rename to ibc-query/src/core/connection/mod.rs
diff --git a/crates/ibc-query/src/core/connection/query.rs b/ibc-query/src/core/connection/query.rs
similarity index 94%
rename from crates/ibc-query/src/core/connection/query.rs
rename to ibc-query/src/core/connection/query.rs
index 4f712b1eb..e7eafc92f 100644
--- a/crates/ibc-query/src/core/connection/query.rs
+++ b/ibc-query/src/core/connection/query.rs
@@ -4,12 +4,12 @@ use alloc::format;
 use alloc::vec::Vec;
 use core::str::FromStr;
 
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::ics24_host::path::{
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::types::path::{
     ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
 };
-use ibc::core::ValidationContext;
-use ibc::Height;
+use ibc::core::host::ValidationContext;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
 use ibc_proto::ibc::core::connection::v1::{
@@ -156,7 +156,11 @@ where
 
     let height = Height::new(request.revision_number, request.revision_height)?;
 
-    let consensus_path = ClientConsensusStatePath::new(connection_end.client_id(), &height);
+    let consensus_path = ClientConsensusStatePath::new(
+        connection_end.client_id().clone(),
+        height.revision_number(),
+        height.revision_height(),
+    );
 
     let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
 
diff --git a/crates/ibc-query/src/core/connection/service.rs b/ibc-query/src/core/connection/service.rs
similarity index 98%
rename from crates/ibc-query/src/core/connection/service.rs
rename to ibc-query/src/core/connection/service.rs
index dbb97543e..04811b883 100644
--- a/crates/ibc-query/src/core/connection/service.rs
+++ b/ibc-query/src/core/connection/service.rs
@@ -4,8 +4,8 @@
 
 use alloc::boxed::Box;
 
-use ibc::core::ValidationContext;
-use ibc::prelude::*;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::query_server::Query as ConnectionQuery;
 use ibc_proto::ibc::core::connection::v1::{
diff --git a/crates/ibc-query/src/core/context.rs b/ibc-query/src/core/context.rs
similarity index 86%
rename from crates/ibc-query/src/core/context.rs
rename to ibc-query/src/core/context.rs
index a71e44615..2f4eef7a1 100644
--- a/crates/ibc-query/src/core/context.rs
+++ b/ibc-query/src/core/context.rs
@@ -1,13 +1,14 @@
 //! Required traits for blanket implementations of [`gRPC query services`](crate::core).
 
-use ibc::core::ics03_connection::connection::IdentifiedConnectionEnd;
-use ibc::core::ics04_channel::channel::IdentifiedChannelEnd;
-use ibc::core::ics04_channel::packet::{PacketState, Sequence};
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::ics24_host::path::{ChannelEndPath, Path};
-use ibc::core::{ContextError, ValidationContext};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::channel::types::channel::IdentifiedChannelEnd;
+use ibc::core::channel::types::packet::PacketState;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::IdentifiedConnectionEnd;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc::core::host::types::path::{ChannelEndPath, Path};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
 
 /// Context to be implemented by the host to provide proofs in query responses
 pub trait ProvableContext {
diff --git a/crates/ibc-query/src/core/mod.rs b/ibc-query/src/core/mod.rs
similarity index 100%
rename from crates/ibc-query/src/core/mod.rs
rename to ibc-query/src/core/mod.rs
diff --git a/crates/ibc-query/src/error.rs b/ibc-query/src/error.rs
similarity index 88%
rename from crates/ibc-query/src/error.rs
rename to ibc-query/src/error.rs
index fa913d42a..9b8eb54f2 100644
--- a/crates/ibc-query/src/error.rs
+++ b/ibc-query/src/error.rs
@@ -1,9 +1,9 @@
 use alloc::string::{String, ToString};
 
 use displaydoc::Display;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics24_host::identifier::IdentifierError;
-use ibc::core::ContextError;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::error::IdentifierError;
 use tonic::Status;
 
 #[derive(Debug, Display)]
diff --git a/crates/ibc-query/src/lib.rs b/ibc-query/src/lib.rs
similarity index 86%
rename from crates/ibc-query/src/lib.rs
rename to ibc-query/src/lib.rs
index b77185e4f..e9db0806f 100644
--- a/crates/ibc-query/src/lib.rs
+++ b/ibc-query/src/lib.rs
@@ -1,15 +1,15 @@
 //! Contains a set of utility traits and implementations for querying the state
 //! of an `ibc-rs` enabled chain, including implementation of essential IBC
-//! query methods and gRPC query services defined in `ibc-proto-rs`. Therefore,
-//! some ready-to-use Query structs for each layer of the client, connection,
-//! and channel have been implemented and exposed by this crate.
+//! query methods and gRPC query services defined in `ibc-proto` crate.
+//! Therefore, some ready-to-use Query structs for each layer of the client,
+//! connection, and channel have been implemented and exposed by this crate.
 //!
 //! The provided structs includes blanket implementation of their corresponding
 //! gRPC service traits, if the host implements the following _context_ traits:
-//! - [`ValidationContext`](ibc::core::ValidationContext)
+//! - [`ValidationContext`](ibc::core::host::ValidationContext)
 //! - [`ProvableContext`](crate::core::context::ProvableContext)
 //! - [`QueryContext`](crate::core::context::QueryContext)
-//! - [`UpgradeValidationContext`](ibc::hosts::tendermint::upgrade_proposal::UpgradeValidationContext)
+//! - [`UpgradeValidationContext`](ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext)
 //!   - Only for
 //!     [`ClientQuery::upgraded_client_state`](ibc_proto::ibc::core::client::v1::query_server::Query::upgraded_client_state)
 //!     and
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
new file mode 100644
index 000000000..2c8ea9ff5
--- /dev/null
+++ b/ibc-testkit/Cargo.toml
@@ -0,0 +1,77 @@
+[package]
+name         = "ibc-testkit"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+readme       = "README.md"
+keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
+description  = """
+    Maintained by `ibc-rs`, serves as a versatile library that provides essential abstractions 
+    and implementations, fulfilling a dual role of enabling rigorous integration testing for
+    the `ibc-rs` implementation while also aiding host chains in addressing a broad spectrum 
+    of testing scenarios during their integrations with `ibc-rs`.
+"""
+
+[dependencies]
+# external dependencies
+bytes             = { workspace = true }
+derive_more       = { workspace = true }
+displaydoc        = { workspace = true }
+parking_lot       = { version = "0.12.1", default-features = false }
+primitive-types   = { workspace = true }
+prost             = { workspace = true }
+serde             = { workspace = true, optional = true }
+serde_json        = { workspace = true, optional = true }
+subtle-encoding   = { workspace = true }
+tracing           = { version = "0.1.40", default-features = false }
+typed-builder     = { version = "0.18.0" }
+
+# ibc dependencies
+ibc       = { workspace = true, features = ["std"] }
+ibc-proto = { workspace = true }
+
+# cosmos dependencies
+tendermint         = { workspace = true }
+tendermint-testgen = { workspace = true }
+
+[dev-dependencies]
+env_logger         = "0.10.0"
+rstest             = { workspace = true }
+tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
+test-log           = { version = "0.2.13", features = ["trace"] }
+
+[features]
+default = ["std"]
+std = [
+    "prost/std",
+    "serde/std",
+    "tracing/std",
+    "tracing-subscriber/std",
+    "serde_json/std",
+    "ibc/std",
+    "ibc-proto/std",
+    "tendermint/std",
+]
+serde = [
+    "dep:serde",
+    "ibc/serde",
+    "ibc-proto/serde",
+    "serde_json",
+]
+schema = [
+    "ibc/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std",
+]
+borsh = [
+    "ibc/borsh",
+    "ibc-proto/borsh",
+]
+parity-scale-codec = [
+    "ibc/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
+]
diff --git a/ibc-testkit/README.md b/ibc-testkit/README.md
new file mode 100644
index 000000000..31715e9c6
--- /dev/null
+++ b/ibc-testkit/README.md
@@ -0,0 +1,7 @@
+# IBC Testkit
+
+`ibc-testkit` is a versatile library that provides essential abstractions and
+implementations, fulfilling a dual role of enabling rigorous integration testing
+for the [`ibc-rs`](https://github.com/cosmos/ibc-rs) implementation while also
+aiding host chains in addressing a broad spectrum of testing scenarios during
+their integrations with `ibc-rs`.
diff --git a/crates/ibc-testkit/src/hosts/block.rs b/ibc-testkit/src/hosts/block.rs
similarity index 94%
rename from crates/ibc-testkit/src/hosts/block.rs
rename to ibc-testkit/src/hosts/block.rs
index 986ca56ee..be7419c65 100644
--- a/crates/ibc-testkit/src/hosts/block.rs
+++ b/ibc-testkit/src/hosts/block.rs
@@ -2,15 +2,15 @@
 
 use core::str::FromStr;
 
-use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use ibc::clients::ics07_tendermint::header::{Header, TENDERMINT_HEADER_TYPE_URL};
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics24_host::identifier::ChainId;
-use ibc::core::timestamp::Timestamp;
-use ibc::prelude::*;
-use ibc::proto::tendermint::v1::Header as RawHeader;
-use ibc::proto::{Any, Protobuf};
-use ibc::Height;
+use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::clients::tendermint::types::proto::v1::Header as RawHeader;
+use ibc::clients::tendermint::types::{Header, TENDERMINT_HEADER_TYPE_URL};
+use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::{Any, Protobuf};
 use tendermint::block::Header as TmHeader;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint_testgen::light_block::TmLightBlock;
diff --git a/crates/ibc-testkit/src/hosts/mod.rs b/ibc-testkit/src/hosts/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/hosts/mod.rs
rename to ibc-testkit/src/hosts/mod.rs
diff --git a/crates/ibc-testkit/src/lib.rs b/ibc-testkit/src/lib.rs
similarity index 100%
rename from crates/ibc-testkit/src/lib.rs
rename to ibc-testkit/src/lib.rs
diff --git a/crates/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
similarity index 92%
rename from crates/ibc-testkit/src/relayer/context.rs
rename to ibc-testkit/src/relayer/context.rs
index 72090614f..15faa0d33 100644
--- a/crates/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -1,11 +1,12 @@
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::{ContextError, ValidationContext};
-use ibc::prelude::*;
-use ibc::{Height, Signer};
+use ibc::core::client::types::Height;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Signer;
 
 use crate::testapp::ibc::clients::AnyClientState;
 use crate::testapp::ibc::core::types::MockContext;
-
 /// Trait capturing all dependencies (i.e., the context) which algorithms in ICS18 require to
 /// relay packets between chains. This trait comprises the dependencies towards a single chain.
 /// Most of the functions in this represent wrappers over the ABCI interface.
@@ -42,19 +43,18 @@ impl RelayerContext for MockContext {
 
 #[cfg(test)]
 mod tests {
-    use ibc::clients::ics07_tendermint::client_type as tm_client_type;
-    use ibc::core::ics02_client::client_state::ClientStateCommon;
-    use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
-    use ibc::core::ics02_client::msgs::ClientMsg;
-    use ibc::core::ics24_host::identifier::{ChainId, ClientId};
-    use ibc::core::MsgEnvelope;
-    use ibc::prelude::*;
-    use ibc::Height;
+    use ibc::clients::tendermint::types::client_type as tm_client_type;
+    use ibc::core::client::context::client_state::ClientStateCommon;
+    use ibc::core::client::types::msgs::{ClientMsg, MsgUpdateClient};
+    use ibc::core::client::types::Height;
+    use ibc::core::handler::types::msgs::MsgEnvelope;
+    use ibc::core::host::types::identifiers::ChainId;
     use test_log::test;
     use tracing::debug;
 
     use super::RelayerContext;
     use crate::hosts::block::{HostBlock, HostType};
+    use crate::relayer::context::ClientId;
     use crate::relayer::error::RelayerError;
     use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
     use crate::testapp::ibc::core::router::MockRouter;
@@ -105,7 +105,7 @@ mod tests {
     }
 
     #[test]
-    /// Serves to test both ICS 26 `dispatch` & `build_client_update_datagram` functions.
+    /// Serves to test both ICS-26 `dispatch` & `build_client_update_datagram` functions.
     /// Implements a "ping pong" of client update messages, so that two chains repeatedly
     /// process a client update message and update their height in succession.
     fn client_update_ping_pong() {
diff --git a/crates/ibc-testkit/src/relayer/error.rs b/ibc-testkit/src/relayer/error.rs
similarity index 81%
rename from crates/ibc-testkit/src/relayer/error.rs
rename to ibc-testkit/src/relayer/error.rs
index 3fdf5296a..2e5c368c8 100644
--- a/crates/ibc-testkit/src/relayer/error.rs
+++ b/ibc-testkit/src/relayer/error.rs
@@ -1,7 +1,8 @@
 use displaydoc::Display;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::{ics03_connection, RouterError};
-use ibc::Height;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::error::ConnectionError;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::identifiers::ClientId;
 
 #[derive(Debug, Display)]
 pub enum RelayerError {
@@ -20,9 +21,9 @@ pub enum RelayerError {
         destination_height: Height,
     },
     /// transaction processing by modules failed error: `{0}`
-    TransactionFailed(RouterError),
+    TransactionFailed(ContextError),
     /// connection error: `{0}`
-    Connection(ics03_connection::error::ConnectionError),
+    Connection(ConnectionError),
 }
 
 #[cfg(feature = "std")]
diff --git a/crates/ibc-testkit/src/relayer/mod.rs b/ibc-testkit/src/relayer/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/relayer/mod.rs
rename to ibc-testkit/src/relayer/mod.rs
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/mod.rs b/ibc-testkit/src/testapp/ibc/applications/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/ibc/applications/mod.rs
rename to ibc-testkit/src/testapp/ibc/applications/mod.rs
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs b/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
similarity index 84%
rename from crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
rename to ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
index f8ec4ae88..2608dcda6 100644
--- a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
+++ b/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
@@ -1,11 +1,9 @@
-use ibc::applications::transfer::context::{
-    cosmos_adr028_escrow_address, TokenTransferExecutionContext, TokenTransferValidationContext,
-};
-use ibc::applications::transfer::error::TokenTransferError;
-use ibc::applications::transfer::PrefixedCoin;
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::prelude::*;
-use ibc::Signer;
+use ibc::apps::transfer::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
+use ibc::apps::transfer::types::error::TokenTransferError;
+use ibc::apps::transfer::types::PrefixedCoin;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::Signer;
+use ibc::cosmos_host::utils::cosmos_adr028_escrow_address;
 use subtle_encoding::bech32;
 
 use super::types::DummyTransferModule;
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs b/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
similarity index 64%
rename from crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
rename to ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
index 7a971ee1d..a811b728e 100644
--- a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/applications/transfer/mod.rs
@@ -1,3 +1,4 @@
+#[cfg(feature = "serde")]
 pub mod context;
 pub mod module;
 pub mod types;
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs b/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
similarity index 83%
rename from crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
rename to ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
index d2c0d1dde..2246c893b 100644
--- a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
+++ b/ibc-testkit/src/testapp/ibc/applications/transfer/module.rs
@@ -1,12 +1,13 @@
-use ibc::core::ics04_channel::acknowledgement::Acknowledgement;
-use ibc::core::ics04_channel::channel::{Counterparty, Order};
-use ibc::core::ics04_channel::error::{ChannelError, PacketError};
-use ibc::core::ics04_channel::packet::Packet;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use ibc::core::router::{Module, ModuleExtras};
-use ibc::prelude::*;
-use ibc::Signer;
+use ibc::core::channel::types::acknowledgement::Acknowledgement;
+use ibc::core::channel::types::channel::{Counterparty, Order};
+use ibc::core::channel::types::error::{ChannelError, PacketError};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::Version;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Signer;
+use ibc::core::router::module::Module;
+use ibc::core::router::types::module::ModuleExtras;
 
 use super::types::DummyTransferModule;
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs b/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
rename to ibc-testkit/src/testapp/ibc/applications/transfer/types.rs
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
similarity index 85%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
rename to ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index cc631b40c..5be183162 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -1,28 +1,29 @@
 use core::str::FromStr;
 use core::time::Duration;
 
-use ibc::core::ics02_client::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation, Status, UpdateKind,
+use ibc::core::client::context::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation,
 };
-use ibc::core::ics02_client::client_type::ClientType;
-use ibc::core::ics02_client::error::{ClientError, UpgradeClientError};
-use ibc::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use ibc::core::ics23_commitment::commitment::{
+use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::client::types::error::{ClientError, UpgradeClientError};
+use ibc::core::client::types::{Height, Status, UpdateKind};
+use ibc::core::commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath, Path};
-use ibc::core::timestamp::Timestamp;
-use ibc::core::ContextError;
-use ibc::prelude::*;
-use ibc::proto::mock::ClientState as RawMockClientState;
-use ibc::proto::{Any, Protobuf};
-use ibc::Height;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::identifiers::{ClientId, ClientType};
+use ibc::core::host::types::path::{ClientConsensusStatePath, ClientStatePath, Path};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use crate::testapp::ibc::clients::mock::header::MockHeader;
 use crate::testapp::ibc::clients::mock::misbehaviour::Misbehaviour;
+use crate::testapp::ibc::clients::mock::proto::{
+    ClientState as RawMockClientState, Header as RawMockHeader,
+};
 
 pub const MOCK_CLIENT_STATE_TYPE_URL: &str = "/ibc.mock.ClientState";
 pub const MOCK_CLIENT_TYPE: &str = "9999-mock";
@@ -86,7 +87,7 @@ impl TryFrom<RawMockClientState> for MockClientState {
 impl From<MockClientState> for RawMockClientState {
     fn from(value: MockClientState) -> Self {
         RawMockClientState {
-            header: Some(ibc::proto::mock::Header {
+            header: Some(RawMockHeader {
                 height: Some(value.header.height().into()),
                 timestamp: value.header.timestamp.nanoseconds(),
             }),
@@ -277,14 +278,17 @@ where
         }
 
         let latest_consensus_state: MockConsensusState = {
-            let any_latest_consensus_state = match ctx.consensus_state(
-                &ClientConsensusStatePath::new(client_id, &self.latest_height()),
-            ) {
-                Ok(cs) => cs,
-                // if the client state does not have an associated consensus state for its latest height
-                // then it must be expired
-                Err(_) => return Ok(Status::Expired),
-            };
+            let any_latest_consensus_state =
+                match ctx.consensus_state(&ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    self.latest_height().revision_number(),
+                    self.latest_height().revision_height(),
+                )) {
+                    Ok(cs) => cs,
+                    // if the client state does not have an associated consensus state for its latest height
+                    // then it must be expired
+                    Err(_) => return Ok(Status::Expired),
+                };
 
             any_latest_consensus_state.try_into()?
         };
@@ -320,7 +324,11 @@ where
 
         ctx.store_client_state(ClientStatePath::new(client_id), (*self).into())?;
         ctx.store_consensus_state(
-            ClientConsensusStatePath::new(client_id, &self.latest_height()),
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                self.latest_height().revision_number(),
+                self.latest_height().revision_height(),
+            ),
             mock_consensus_state.into(),
         )?;
 
@@ -340,7 +348,11 @@ where
         let new_consensus_state = MockConsensusState::new(header);
 
         ctx.store_consensus_state(
-            ClientConsensusStatePath::new(client_id, &new_client_state.latest_height()),
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                new_client_state.latest_height().revision_number(),
+                new_client_state.latest_height().revision_height(),
+            ),
             new_consensus_state.into(),
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
@@ -377,7 +389,11 @@ where
         let latest_height = new_client_state.latest_height();
 
         ctx.store_consensus_state(
-            ClientConsensusStatePath::new(client_id, &latest_height),
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                latest_height.revision_number(),
+                latest_height.revision_height(),
+            ),
             new_consensus_state.into(),
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
similarity index 85%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
rename to ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
index 39154deb5..fa0451ebe 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
@@ -1,13 +1,14 @@
-use ibc::core::ics02_client::consensus_state::ConsensusState;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics23_commitment::commitment::CommitmentRoot;
-use ibc::core::timestamp::Timestamp;
-use ibc::prelude::*;
-use ibc::proto::mock::ConsensusState as RawMockConsensusState;
-use ibc::proto::{Any, Protobuf};
+use ibc::core::client::context::consensus_state::ConsensusState;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::commitment_types::commitment::CommitmentRoot;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::header::MockHeader;
-
+use crate::testapp::ibc::clients::mock::proto::{
+    ConsensusState as RawMockConsensusState, Header as RawMockHeader,
+};
 pub const MOCK_CONSENSUS_STATE_TYPE_URL: &str = "/ibc.mock.ConsensusState";
 
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -48,7 +49,7 @@ impl TryFrom<RawMockConsensusState> for MockConsensusState {
 impl From<MockConsensusState> for RawMockConsensusState {
     fn from(value: MockConsensusState) -> Self {
         RawMockConsensusState {
-            header: Some(ibc::proto::mock::Header {
+            header: Some(RawMockHeader {
                 height: Some(value.header.height().into()),
                 timestamp: value.header.timestamp.nanoseconds(),
             }),
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
similarity index 93%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
rename to ibc-testkit/src/testapp/ibc/clients/mock/header.rs
index bad80b6bd..072b7bba7 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
@@ -1,11 +1,12 @@
 use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
 
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::timestamp::Timestamp;
-use ibc::proto::mock::Header as RawMockHeader;
-use ibc::proto::{Any, Protobuf};
-use ibc::Height;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::{Any, Protobuf};
+
+use crate::testapp::ibc::clients::mock::proto::Header as RawMockHeader;
 
 pub const MOCK_HEADER_TYPE_URL: &str = "/ibc.mock.Header";
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
similarity index 89%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
rename to ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
index 71a852869..85dd8bceb 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
@@ -1,11 +1,11 @@
 use bytes::Buf;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::prelude::*;
-use ibc::proto::mock::Misbehaviour as RawMisbehaviour;
-use ibc::proto::{Any, Protobuf};
+use ibc::core::client::types::error::ClientError;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::primitives::prelude::*;
+use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::header::MockHeader;
+use crate::testapp::ibc::clients::mock::proto::Misbehaviour as RawMisbehaviour;
 
 pub const MOCK_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.mock.Misbehavior";
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
similarity index 54%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
rename to ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
index 746825f7f..ec880383c 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/mod.rs
@@ -3,3 +3,8 @@ pub mod client_state;
 pub mod consensus_state;
 pub mod header;
 pub mod misbehaviour;
+
+/// Re-exports mock proto types from the `ibc-proto` crate
+pub mod proto {
+    pub use ibc_proto::ibc::mock::*;
+}
diff --git a/crates/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
similarity index 72%
rename from crates/ibc-testkit/src/testapp/ibc/clients/mod.rs
rename to ibc-testkit/src/testapp/ibc/clients/mod.rs
index d7b09e638..639d66cf5 100644
--- a/crates/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -1,17 +1,16 @@
 pub mod mock;
 
 use derive_more::{From, TryInto};
-use ibc::clients::ics07_tendermint::client_state::{
-    ClientState as TmClientState, TENDERMINT_CLIENT_STATE_TYPE_URL,
+use ibc::clients::tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::clients::tendermint::types::{
+    TENDERMINT_CLIENT_STATE_TYPE_URL, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
 };
-use ibc::clients::ics07_tendermint::consensus_state::{
-    ConsensusState as TmConsensusState, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
-};
-use ibc::core::ics02_client::client_state::ClientState;
-use ibc::core::ics02_client::consensus_state::ConsensusState;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::prelude::*;
-use ibc::proto::{Any, Protobuf};
+use ibc::core::client::context::client_state::ClientState as ClientStateTrait;
+use ibc::core::client::context::consensus_state::ConsensusState as ConsensusStateTrait;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::primitives::prelude::*;
+use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::client_state::{
     MockClientState, MOCK_CLIENT_STATE_TYPE_URL,
@@ -21,7 +20,7 @@ use crate::testapp::ibc::clients::mock::consensus_state::{
 };
 use crate::testapp::ibc::core::types::MockContext;
 
-#[derive(Debug, Clone, From, PartialEq, ClientState)]
+#[derive(Debug, Clone, From, PartialEq, ClientStateTrait)]
 #[generics(ClientValidationContext = MockContext,
            ClientExecutionContext = MockContext)
 ]
@@ -37,7 +36,7 @@ impl TryFrom<Any> for AnyClientState {
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
         if raw.type_url == TENDERMINT_CLIENT_STATE_TYPE_URL {
-            TmClientState::try_from(raw).map(Into::into)
+            Ok(TmClientState::try_from(raw)?.into())
         } else if raw.type_url == MOCK_CLIENT_STATE_TYPE_URL {
             MockClientState::try_from(raw).map(Into::into)
         } else {
@@ -57,7 +56,7 @@ impl From<AnyClientState> for Any {
     }
 }
 
-#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
+#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusStateTrait)]
 pub enum AnyConsensusState {
     Tendermint(TmConsensusState),
     Mock(MockConsensusState),
@@ -70,7 +69,7 @@ impl TryFrom<Any> for AnyConsensusState {
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
         if raw.type_url == TENDERMINT_CONSENSUS_STATE_TYPE_URL {
-            TmConsensusState::try_from(raw).map(Into::into)
+            Ok(TmConsensusState::try_from(raw)?.into())
         } else if raw.type_url == MOCK_CONSENSUS_STATE_TYPE_URL {
             MockConsensusState::try_from(raw).map(Into::into)
         } else {
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
similarity index 91%
rename from crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
rename to ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 17bb7ff61..667aabdf8 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -1,16 +1,17 @@
 use alloc::collections::BTreeMap;
 use alloc::vec::Vec;
 
-use ibc::clients::ics07_tendermint::{
+use ibc::clients::tendermint::context::{
     CommonContext as TmCommonContext, ValidationContext as TmValidationContext,
 };
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics02_client::{ClientExecutionContext, ClientValidationContext};
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, PortId};
-use ibc::core::ics24_host::path::{ClientConsensusStatePath, ClientStatePath};
-use ibc::core::timestamp::Timestamp;
-use ibc::core::{ContextError, ValidationContext};
-use ibc::Height;
+use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, PortId};
+use ibc::core::host::types::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::Timestamp;
 
 use crate::testapp::ibc::clients::mock::client_state::MockClientContext;
 use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
@@ -235,8 +236,11 @@ impl ClientExecutionContext for MockContext {
                 client_state: Default::default(),
             });
 
-        let height = Height::new(consensus_state_path.epoch, consensus_state_path.height)
-            .expect("Never fails");
+        let height = Height::new(
+            consensus_state_path.revision_number,
+            consensus_state_path.revision_height,
+        )
+        .expect("Never fails");
         client_record
             .consensus_states
             .insert(height, consensus_state);
@@ -258,8 +262,11 @@ impl ClientExecutionContext for MockContext {
                 client_state: Default::default(),
             });
 
-        let height = Height::new(consensus_state_path.epoch, consensus_state_path.height)
-            .expect("Never fails");
+        let height = Height::new(
+            consensus_state_path.revision_number,
+            consensus_state_path.revision_height,
+        )
+        .expect("Never fails");
 
         client_record.consensus_states.remove(&height);
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
similarity index 92%
rename from crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
rename to ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index 470f28a86..1dc063ded 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -3,26 +3,27 @@
 use core::ops::Add;
 use core::time::Duration;
 
-use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use ibc::core::events::IbcEvent;
-use ibc::core::ics02_client::error::ClientError;
-use ibc::core::ics03_connection::connection::ConnectionEnd;
-use ibc::core::ics03_connection::error::ConnectionError;
-use ibc::core::ics04_channel::channel::ChannelEnd;
-use ibc::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
-use ibc::core::ics04_channel::error::{ChannelError, PacketError};
-use ibc::core::ics04_channel::packet::{Receipt, Sequence};
-use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::ics24_host::path::{
+use ibc::clients::tendermint::client_state::ClientState;
+use ibc::core::channel::types::channel::ChannelEnd;
+use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc::core::channel::types::error::{ChannelError, PacketError};
+use ibc::core::channel::types::packet::Receipt;
+use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::error::ConnectionError;
+use ibc::core::connection::types::ConnectionEnd;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::handler::types::events::IbcEvent;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc::core::host::types::path::{
     AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
     ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use ibc::core::timestamp::Timestamp;
-use ibc::core::{ContextError, ExecutionContext, ValidationContext};
-use ibc::prelude::*;
-use ibc::proto::Any;
-use ibc::{Height, Signer};
+use ibc::core::host::{ExecutionContext, ValidationContext};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::{Signer, Timestamp};
+use ibc::primitives::proto::Any;
 
 use super::types::MockContext;
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
@@ -52,8 +53,8 @@ impl ValidationContext for MockContext {
     }
 
     fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError> {
-        if let Ok(client_state) = TmClientState::try_from(client_state.clone()) {
-            client_state.validate().map_err(ClientError::from)?;
+        if let Ok(client_state) = ClientState::try_from(client_state.clone()) {
+            client_state.inner().validate().map_err(ClientError::from)?;
             Ok(client_state.into())
         } else if let Ok(client_state) = MockClientState::try_from(client_state.clone()) {
             Ok(client_state.into())
@@ -70,7 +71,10 @@ impl ValidationContext for MockContext {
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<AnyConsensusState, ContextError> {
         let client_id = &client_cons_state_path.client_id;
-        let height = Height::new(client_cons_state_path.epoch, client_cons_state_path.height)?;
+        let height = Height::new(
+            client_cons_state_path.revision_number,
+            client_cons_state_path.revision_height,
+        )?;
         match self.ibc_store.lock().clients.get(client_id) {
             Some(client_record) => match client_record.consensus_states.get(&height) {
                 Some(consensus_state) => Ok(consensus_state.clone()),
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/mod.rs b/ibc-testkit/src/testapp/ibc/core/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/ibc/core/mod.rs
rename to ibc-testkit/src/testapp/ibc/core/mod.rs
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/context.rs b/ibc-testkit/src/testapp/ibc/core/router/context.rs
similarity index 82%
rename from crates/ibc-testkit/src/testapp/ibc/core/router/context.rs
rename to ibc-testkit/src/testapp/ibc/core/router/context.rs
index ad6855ac8..aa8faefc8 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/router/context.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/context.rs
@@ -1,7 +1,9 @@
 use alloc::sync::Arc;
 
-use ibc::core::ics24_host::identifier::PortId;
-use ibc::core::router::{Module, ModuleId, Router};
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::router::module::Module;
+use ibc::core::router::router::Router;
+use ibc::core::router::types::module::ModuleId;
 
 use super::types::MockRouter;
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs b/ibc-testkit/src/testapp/ibc/core/router/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/ibc/core/router/mod.rs
rename to ibc-testkit/src/testapp/ibc/core/router/mod.rs
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/router/types.rs b/ibc-testkit/src/testapp/ibc/core/router/types.rs
similarity index 84%
rename from crates/ibc-testkit/src/testapp/ibc/core/router/types.rs
rename to ibc-testkit/src/testapp/ibc/core/router/types.rs
index b0aaaae1b..5e5041d3d 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/router/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/types.rs
@@ -1,10 +1,11 @@
 use alloc::collections::BTreeMap;
 use alloc::sync::Arc;
 
-use ibc::applications::transfer::MODULE_ID_STR;
-use ibc::core::ics24_host::identifier::PortId;
-use ibc::core::router::{Module, ModuleId};
-use ibc::prelude::*;
+use ibc::apps::transfer::types::MODULE_ID_STR;
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::primitives::prelude::*;
+use ibc::core::router::module::Module;
+use ibc::core::router::types::module::ModuleId;
 
 use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
 
diff --git a/crates/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
similarity index 96%
rename from crates/ibc-testkit/src/testapp/ibc/core/types.rs
rename to ibc-testkit/src/testapp/ibc/core/types.rs
index 145afcdb1..be31e896a 100644
--- a/crates/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -7,20 +7,23 @@ use core::fmt::Debug;
 use core::ops::{Add, Sub};
 use core::time::Duration;
 
-use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use ibc::clients::ics07_tendermint::TENDERMINT_CLIENT_TYPE;
-use ibc::core::events::IbcEvent;
-use ibc::core::ics02_client::client_type::ClientType;
-use ibc::core::ics03_connection::connection::ConnectionEnd;
-use ibc::core::ics04_channel::channel::ChannelEnd;
-use ibc::core::ics04_channel::commitment::{AcknowledgementCommitment, PacketCommitment};
-use ibc::core::ics04_channel::packet::{Receipt, Sequence};
-use ibc::core::ics24_host::identifier::{ChainId, ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::router::Router;
-use ibc::core::timestamp::Timestamp;
-use ibc::core::{dispatch, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::clients::tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::tendermint::types::TENDERMINT_CLIENT_TYPE;
+use ibc::core::channel::types::channel::ChannelEnd;
+use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc::core::channel::types::packet::Receipt;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::ConnectionEnd;
+use ibc::core::entrypoint::dispatch;
+use ibc::core::handler::types::events::IbcEvent;
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{
+    ChainId, ChannelId, ClientId, ClientType, ConnectionId, PortId, Sequence,
+};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::core::router::router::Router;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
 use tracing::debug;
@@ -526,7 +529,7 @@ impl MockContext {
                     .try_into()
                     .expect("never fails");
 
-                client_state.validate().expect("never fails");
+                client_state.inner().validate().expect("never fails");
 
                 let cs_states = blocks
                     .into_iter()
@@ -782,14 +785,14 @@ impl MockContext {
 
 #[cfg(test)]
 mod tests {
-    use ibc::core::ics04_channel::acknowledgement::Acknowledgement;
-    use ibc::core::ics04_channel::channel::{Counterparty, Order};
-    use ibc::core::ics04_channel::error::{ChannelError, PacketError};
-    use ibc::core::ics04_channel::packet::Packet;
-    use ibc::core::ics04_channel::Version;
-    use ibc::core::ics24_host::identifier::{ChainId, ChannelId, ConnectionId, PortId};
-    use ibc::core::router::{Module, ModuleExtras, ModuleId};
-    use ibc::{Height, Signer};
+    use ibc::core::channel::types::acknowledgement::Acknowledgement;
+    use ibc::core::channel::types::channel::{Counterparty, Order};
+    use ibc::core::channel::types::error::{ChannelError, PacketError};
+    use ibc::core::channel::types::packet::Packet;
+    use ibc::core::channel::types::Version;
+    use ibc::core::primitives::Signer;
+    use ibc::core::router::module::Module;
+    use ibc::core::router::types::module::{ModuleExtras, ModuleId};
     use test_log::test;
 
     use super::*;
diff --git a/crates/ibc-testkit/src/testapp/ibc/mod.rs b/ibc-testkit/src/testapp/ibc/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/ibc/mod.rs
rename to ibc-testkit/src/testapp/ibc/mod.rs
diff --git a/crates/ibc-testkit/src/testapp/mod.rs b/ibc-testkit/src/testapp/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/testapp/mod.rs
rename to ibc-testkit/src/testapp/mod.rs
diff --git a/crates/ibc-testkit/src/utils/dummies/applications/mod.rs b/ibc-testkit/src/utils/dummies/applications/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/dummies/applications/mod.rs
rename to ibc-testkit/src/utils/dummies/applications/mod.rs
diff --git a/crates/ibc-testkit/src/utils/dummies/applications/transfer.rs b/ibc-testkit/src/utils/dummies/applications/transfer.rs
similarity index 85%
rename from crates/ibc-testkit/src/utils/dummies/applications/transfer.rs
rename to ibc-testkit/src/utils/dummies/applications/transfer.rs
index 0bf50c99b..89c630c79 100644
--- a/crates/ibc-testkit/src/utils/dummies/applications/transfer.rs
+++ b/ibc-testkit/src/utils/dummies/applications/transfer.rs
@@ -1,13 +1,12 @@
 use alloc::string::ToString;
 
-use ibc::applications::transfer::msgs::transfer::MsgTransfer;
-use ibc::applications::transfer::packet::PacketData;
-use ibc::applications::transfer::{Memo, PrefixedCoin};
-use ibc::core::ics04_channel::packet::{Packet, Sequence};
-use ibc::core::ics04_channel::timeout::TimeoutHeight;
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::core::timestamp::Timestamp;
-use ibc::Signer;
+use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
+use ibc::apps::transfer::types::packet::PacketData;
+use ibc::apps::transfer::types::{Memo, PrefixedCoin};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::timeout::TimeoutHeight;
+use ibc::core::host::types::identifiers::{ChannelId, PortId, Sequence};
+use ibc::core::primitives::{Signer, Timestamp};
 use typed_builder::TypedBuilder;
 
 use crate::utils::dummies::core::signer::dummy_account_id;
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/mock.rs b/ibc-testkit/src/utils/dummies/clients/mock.rs
similarity index 87%
rename from crates/ibc-testkit/src/utils/dummies/clients/mock.rs
rename to ibc-testkit/src/utils/dummies/clients/mock.rs
index 0f9350ff3..63ec379bc 100644
--- a/crates/ibc-testkit/src/utils/dummies/clients/mock.rs
+++ b/ibc-testkit/src/utils/dummies/clients/mock.rs
@@ -1,7 +1,6 @@
-use ibc::Height;
+use ibc::core::client::types::Height;
 
 use crate::testapp::ibc::clients::mock::header::MockHeader;
-
 /// Returns a dummy `MockHeader` with the given revision height.
 pub fn dummy_new_mock_header(revision_height: u64) -> MockHeader {
     MockHeader::new(Height::new(0, revision_height).expect("Never fails"))
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/mod.rs b/ibc-testkit/src/utils/dummies/clients/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/dummies/clients/mod.rs
rename to ibc-testkit/src/utils/dummies/clients/mod.rs
diff --git a/crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs b/ibc-testkit/src/utils/dummies/clients/tendermint.rs
similarity index 82%
rename from crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs
rename to ibc-testkit/src/utils/dummies/clients/tendermint.rs
index c249c487e..80bace16f 100644
--- a/crates/ibc-testkit/src/utils/dummies/clients/tendermint.rs
+++ b/ibc-testkit/src/utils/dummies/clients/tendermint.rs
@@ -1,28 +1,33 @@
 use core::str::FromStr;
 use core::time::Duration;
 
-use ibc::clients::ics07_tendermint::client_state::{AllowUpdate, ClientState};
-use ibc::clients::ics07_tendermint::error::{Error as ClientError, Error};
+use ibc::clients::tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::tendermint::types::error::{Error as ClientError, Error};
+use ibc::clients::tendermint::types::proto::v1::{ClientState as RawTmClientState, Fraction};
 #[cfg(feature = "serde")]
-use ibc::clients::ics07_tendermint::header::Header;
-use ibc::clients::ics07_tendermint::trust_threshold::TrustThreshold;
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics23_commitment::specs::ProofSpecs;
-use ibc::core::ics24_host::identifier::ChainId;
-use ibc::prelude::*;
-use ibc::proto::core::client::v1::Height as RawHeight;
-use ibc::proto::tendermint::v1::{ClientState as RawTmClientState, Fraction};
+use ibc::clients::tendermint::types::Header;
+use ibc::clients::tendermint::types::{
+    AllowUpdate, ClientState as ClientStateType, TrustThreshold,
+};
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::specs::ProofSpecs;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::prelude::*;
 use tendermint::block::Header as TmHeader;
 
 /// Returns a dummy tendermint `ClientState` by given `frozen_height`, for testing purposes only!
-pub fn dummy_tm_client_state_from_raw(frozen_height: RawHeight) -> Result<ClientState, Error> {
-    ClientState::try_from(dummy_raw_tm_client_state(frozen_height))
+pub fn dummy_tm_client_state_from_raw(frozen_height: RawHeight) -> Result<TmClientState, Error> {
+    let client_state =
+        ClientStateType::try_from(dummy_raw_tm_client_state(frozen_height)).expect("Never fails");
+
+    Ok(TmClientState::from(client_state))
 }
 
 /// Returns a dummy tendermint `ClientState` from a `TmHeader`, for testing purposes only!
-pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> ClientState {
+pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> TmClientState {
     let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
-    ClientState::new(
+    let client_state = ClientStateType::new(
         chain_id.clone(),
         Default::default(),
         Duration::from_secs(64000),
@@ -36,7 +41,9 @@ pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> ClientState {
             after_misbehaviour: false,
         },
     )
-    .expect("Never fails")
+    .expect("Never fails");
+
+    TmClientState::from(client_state)
 }
 
 /// Returns a dummy tendermint `RawTmClientState` by given `frozen_height`, for testing purposes only!
@@ -80,11 +87,11 @@ pub struct ClientStateConfig {
     allow_update: AllowUpdate,
 }
 
-impl TryFrom<ClientStateConfig> for ClientState {
+impl TryFrom<ClientStateConfig> for TmClientState {
     type Error = ClientError;
 
     fn try_from(config: ClientStateConfig) -> Result<Self, Self::Error> {
-        ClientState::new(
+        let client_state = ClientStateType::new(
             config.chain_id,
             config.trust_level,
             config.trusting_period,
@@ -94,7 +101,9 @@ impl TryFrom<ClientStateConfig> for ClientState {
             config.proof_specs,
             config.upgrade_path,
             config.allow_update,
-        )
+        )?;
+
+        Ok(TmClientState::from(client_state))
     }
 }
 
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs b/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
similarity index 89%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
rename to ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
index f1e1e0129..64314696a 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
@@ -1,7 +1,7 @@
-use ibc::proto::core::channel::v1::{
+use ibc::core::channel::types::proto::v1::{
     MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
 };
-use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
 
 use super::{dummy_proof, dummy_raw_packet};
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
similarity index 70%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
index 42645de42..1ee818729 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
-use ibc::proto::core::client::v1::Height;
+use ibc::core::channel::types::proto::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_proof;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
similarity index 66%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
index 492090cda..9753b02a5 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
@@ -1,6 +1,6 @@
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+use ibc::core::channel::types::proto::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
 
 use crate::utils::dummies::core::signer::dummy_bech32_account;
 
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
similarity index 74%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
index 087c3d31a..0436fc1b2 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-use ibc::proto::core::client::v1::Height;
+use ibc::core::channel::types::proto::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_proof;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
similarity index 70%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
index 68140bd2e..03c661f6d 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-use ibc::proto::core::client::v1::Height;
+use ibc::core::channel::types::proto::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_proof;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
similarity index 72%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
index d161134a2..090027aba 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
@@ -1,6 +1,6 @@
-use ibc::core::ics24_host::identifier::PortId;
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+use ibc::core::channel::types::proto::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_raw_channel_end;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
similarity index 76%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
rename to ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
index 1bedea696..85a4fa036 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics24_host::identifier::PortId;
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-use ibc::proto::core::client::v1::Height;
+use ibc::core::channel::types::proto::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::primitives::prelude::*;
 
 use super::{dummy_proof, dummy_raw_channel_end};
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs b/ibc-testkit/src/utils/dummies/core/channel/mod.rs
similarity index 85%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs
rename to ibc-testkit/src/utils/dummies/core/channel/mod.rs
index 3e5a083da..fad50ad02 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/mod.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/mod.rs
@@ -17,9 +17,11 @@ pub use chan_open_ack::*;
 pub use chan_open_confirm::*;
 pub use chan_open_init::*;
 pub use chan_open_try::*;
-use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::{Channel as RawChannel, Counterparty as RawCounterparty};
+use ibc::core::channel::types::proto::v1::{
+    Channel as RawChannel, Counterparty as RawCounterparty,
+};
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::core::primitives::prelude::*;
 pub use packet::*;
 pub use recv_packet::*;
 pub use timeout::*;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs b/ibc-testkit/src/utils/dummies/core/channel/packet.rs
similarity index 83%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs
rename to ibc-testkit/src/utils/dummies/core/channel/packet.rs
index 9045dd320..7682c4200 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/packet.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/packet.rs
@@ -1,10 +1,10 @@
-use ibc::core::ics04_channel::packet::{Packet, Sequence};
-use ibc::core::ics04_channel::timeout::TimeoutHeight;
-use ibc::core::ics24_host::identifier::{ChannelId, PortId};
-use ibc::core::timestamp::Timestamp;
-use ibc::prelude::*;
-use ibc::proto::core::channel::v1::Packet as RawPacket;
-use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::proto::v1::Packet as RawPacket;
+use ibc::core::channel::types::timeout::TimeoutHeight;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::host::types::identifiers::{ChannelId, PortId, Sequence};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
 use typed_builder::TypedBuilder;
 
 /// Configuration of the `PacketData` type for building dummy packets.
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs b/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
similarity index 73%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
rename to ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
index a9e521859..a758961c4 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
@@ -1,13 +1,13 @@
 use core::ops::Add;
 use core::time::Duration;
 
-use ibc::core::ics04_channel::msgs::MsgRecvPacket;
-use ibc::core::ics04_channel::packet::Packet;
-use ibc::core::ics23_commitment::commitment::CommitmentProofBytes;
-use ibc::core::timestamp::Timestamp;
-use ibc::proto::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
-use ibc::proto::core::client::v1::Height as RawHeight;
-use ibc::{Height, Signer};
+use ibc::core::channel::types::msgs::MsgRecvPacket;
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::proto::v1::MsgRecvPacket as RawMsgRecvPacket;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::commitment::CommitmentProofBytes;
+use ibc::core::primitives::{Signer, Timestamp};
 
 use super::{dummy_proof, dummy_raw_packet};
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs b/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
similarity index 84%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
rename to ibc-testkit/src/utils/dummies/core/channel/timeout.rs
index db08b045c..1c24f7ec1 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
@@ -1,5 +1,5 @@
-use ibc::proto::core::channel::v1::MsgTimeout as RawMsgTimeout;
-use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::core::channel::types::proto::v1::MsgTimeout as RawMsgTimeout;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
 
 use super::{dummy_proof, dummy_raw_packet};
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs b/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
similarity index 83%
rename from crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
rename to ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
index c11bcd187..0aca9f223 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
+++ b/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
@@ -1,5 +1,5 @@
-use ibc::proto::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
-use ibc::proto::core::client::v1::Height as RawHeight;
+use ibc::core::channel::types::proto::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
 
 use super::{dummy_proof, dummy_raw_packet};
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/mod.rs b/ibc-testkit/src/utils/dummies/core/client/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/dummies/core/client/mod.rs
rename to ibc-testkit/src/utils/dummies/core/client/mod.rs
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs b/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
similarity index 79%
rename from crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
rename to ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
index 250855fb0..75bf4fa9f 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
+++ b/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
@@ -1,6 +1,6 @@
-use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use ibc::proto::core::client::v1::MsgCreateClient;
-use ibc::proto::Any;
+use ibc::clients::tendermint::types::ConsensusState as TmConsensusState;
+use ibc::core::client::types::proto::v1::MsgCreateClient;
+use ibc::primitives::proto::Any;
 
 use crate::utils::dummies::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs b/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
similarity index 84%
rename from crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
rename to ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
index 5ff980504..18ca4243e 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
+++ b/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
@@ -1,5 +1,5 @@
-use ibc::proto::core::client::v1::MsgUpdateClient;
-use ibc::proto::Any;
+use ibc::core::client::types::proto::v1::MsgUpdateClient;
+use ibc::primitives::proto::Any;
 
 use crate::utils::dummies::clients::tendermint::dummy_ics07_header;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs b/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
similarity index 87%
rename from crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
rename to ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
index 3c42c10f7..c5e75aae3 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
+++ b/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::proto::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
+use ibc::core::client::types::msgs::MsgUpgradeClient;
+use ibc::core::client::types::proto::v1::MsgUpgradeClient as RawMsgUpgradeClient;
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ClientId;
 
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/commitment.rs b/ibc-testkit/src/utils/dummies/core/commitment.rs
similarity index 61%
rename from crates/ibc-testkit/src/utils/dummies/core/commitment.rs
rename to ibc-testkit/src/utils/dummies/core/commitment.rs
index c4939556e..7abbd95c5 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/commitment.rs
+++ b/ibc-testkit/src/utils/dummies/core/commitment.rs
@@ -1,7 +1,7 @@
-use ibc::core::ics23_commitment::commitment::CommitmentProofBytes;
-use ibc::prelude::*;
-use ibc::proto::core::commitment::v1::MerkleProof as RawMerkleProof;
-use ibc::proto::ics23::CommitmentProof;
+use ibc::core::commitment_types::commitment::CommitmentProofBytes;
+use ibc::core::commitment_types::proto::ics23::CommitmentProof;
+use ibc::core::commitment_types::proto::v1::MerkleProof as RawMerkleProof;
+use ibc::core::primitives::prelude::*;
 
 /// Returns a dummy `CommitmentProofBytes`, for testing purposes only!
 pub fn dummy_commitment_proof_bytes() -> CommitmentProofBytes {
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
similarity index 79%
rename from crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
rename to ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
index b1a18e862..f0782cae2 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
+++ b/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
@@ -1,10 +1,10 @@
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-use ibc::core::ics03_connection::version::Version;
-use ibc::core::ics24_host::identifier::ConnectionId;
-use ibc::prelude::*;
-use ibc::proto::core::client::v1::Height as RawHeight;
-use ibc::proto::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenAck;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+use ibc::core::connection::types::version::Version;
+use ibc::core::host::types::identifiers::ConnectionId;
+use ibc::core::primitives::prelude::*;
 
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
 use crate::testapp::ibc::clients::mock::header::MockHeader;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
similarity index 78%
rename from crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
rename to ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
index f5f4f4764..58a0348f9 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
+++ b/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
@@ -1,8 +1,8 @@
 use alloc::string::ToString;
 
-use ibc::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-use ibc::proto::core::client::v1::Height;
-use ibc::proto::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenConfirm;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
 
 use crate::utils::dummies::core::channel::dummy_proof;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
similarity index 88%
rename from crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
rename to ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
index 588737a0f..24eadd989 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
+++ b/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
@@ -1,11 +1,11 @@
-use ibc::core::ics03_connection::connection::Counterparty;
-use ibc::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-use ibc::core::ics03_connection::version::Version;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::prelude::*;
-use ibc::proto::core::connection::v1::{
+use ibc::core::connection::types::msgs::MsgConnectionOpenInit;
+use ibc::core::connection::types::proto::v1::{
     MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
 };
+use ibc::core::connection::types::version::Version;
+use ibc::core::connection::types::Counterparty;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_raw_counterparty_conn;
 use crate::utils::dummies::core::signer::dummy_bech32_account;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
similarity index 84%
rename from crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
rename to ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
index 3d6bb0956..464e2c7f0 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
+++ b/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
@@ -1,10 +1,10 @@
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::prelude::*;
-use ibc::proto::core::client::v1::Height as RawHeight;
-use ibc::proto::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenTry;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::primitives::prelude::*;
 
 use super::dummy_raw_counterparty_conn;
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs b/ibc-testkit/src/utils/dummies/core/connection/mod.rs
similarity index 84%
rename from crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs
rename to ibc-testkit/src/utils/dummies/core/connection/mod.rs
index 15bc1990b..0567705c0 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/connection/mod.rs
+++ b/ibc-testkit/src/utils/dummies/core/connection/mod.rs
@@ -7,10 +7,10 @@ pub use conn_open_ack::*;
 pub use conn_open_confirm::*;
 pub use conn_open_init::*;
 pub use conn_open_try::*;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::prelude::*;
-use ibc::proto::core::commitment::v1::MerklePrefix;
-use ibc::proto::core::connection::v1::Counterparty as RawCounterparty;
+use ibc::core::commitment_types::proto::v1::MerklePrefix;
+use ibc::core::connection::types::proto::v1::Counterparty as RawCounterparty;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::primitives::prelude::*;
 use typed_builder::TypedBuilder;
 
 #[derive(TypedBuilder, Debug)]
diff --git a/crates/ibc-testkit/src/utils/dummies/core/context.rs b/ibc-testkit/src/utils/dummies/core/context.rs
similarity index 96%
rename from crates/ibc-testkit/src/utils/dummies/core/context.rs
rename to ibc-testkit/src/utils/dummies/core/context.rs
index 6c7b95af1..9d1e0e345 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/context.rs
+++ b/ibc-testkit/src/utils/dummies/core/context.rs
@@ -3,10 +3,10 @@ use core::cmp::min;
 use core::ops::{Add, Sub};
 use core::time::Duration;
 
-use ibc::core::ics24_host::identifier::ChainId;
-use ibc::core::timestamp::Timestamp;
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
 use typed_builder::TypedBuilder;
diff --git a/crates/ibc-testkit/src/utils/dummies/core/mod.rs b/ibc-testkit/src/utils/dummies/core/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/dummies/core/mod.rs
rename to ibc-testkit/src/utils/dummies/core/mod.rs
diff --git a/crates/ibc-testkit/src/utils/dummies/core/signer.rs b/ibc-testkit/src/utils/dummies/core/signer.rs
similarity index 75%
rename from crates/ibc-testkit/src/utils/dummies/core/signer.rs
rename to ibc-testkit/src/utils/dummies/core/signer.rs
index 2d74049a8..6adb8727e 100644
--- a/crates/ibc-testkit/src/utils/dummies/core/signer.rs
+++ b/ibc-testkit/src/utils/dummies/core/signer.rs
@@ -1,5 +1,5 @@
-use ibc::prelude::*;
-use ibc::Signer;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Signer;
 
 pub fn dummy_account_id() -> Signer {
     "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
diff --git a/crates/ibc-testkit/src/utils/dummies/mod.rs b/ibc-testkit/src/utils/dummies/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/dummies/mod.rs
rename to ibc-testkit/src/utils/dummies/mod.rs
diff --git a/crates/ibc-testkit/src/utils/fixture.rs b/ibc-testkit/src/utils/fixture.rs
similarity index 79%
rename from crates/ibc-testkit/src/utils/fixture.rs
rename to ibc-testkit/src/utils/fixture.rs
index 134c41c1f..6b3a5eb1a 100644
--- a/crates/ibc-testkit/src/utils/fixture.rs
+++ b/ibc-testkit/src/utils/fixture.rs
@@ -1,13 +1,12 @@
 use core::fmt::Debug;
 
-use ibc::core::RouterError;
-use ibc::prelude::{String, *};
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::primitives::prelude::*;
 
 use crate::testapp::ibc::core::types::MockContext;
-
 pub enum Expect {
     Success,
-    Failure(Option<RouterError>),
+    Failure(Option<ContextError>),
 }
 
 #[derive(Clone, Debug)]
@@ -21,7 +20,7 @@ impl<M: Debug> Fixture<M> {
         &self,
         expect: &Expect,
         process: &str,
-        res: &Result<(), RouterError>,
+        res: &Result<(), ContextError>,
     ) -> String {
         let base_error = match expect {
             Expect::Success => "step failed!",
diff --git a/crates/ibc-testkit/src/utils/mod.rs b/ibc-testkit/src/utils/mod.rs
similarity index 100%
rename from crates/ibc-testkit/src/utils/mod.rs
rename to ibc-testkit/src/utils/mod.rs
diff --git a/crates/ibc-testkit/tests/applications/mod.rs b/ibc-testkit/tests/applications/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/applications/mod.rs
rename to ibc-testkit/tests/applications/mod.rs
diff --git a/crates/ibc-testkit/tests/applications/transfer.rs b/ibc-testkit/tests/applications/transfer.rs
similarity index 90%
rename from crates/ibc-testkit/tests/applications/transfer.rs
rename to ibc-testkit/tests/applications/transfer.rs
index 64d56b8c2..6aa8e3839 100644
--- a/crates/ibc-testkit/tests/applications/transfer.rs
+++ b/ibc-testkit/tests/applications/transfer.rs
@@ -1,12 +1,13 @@
-use ibc::applications::transfer::context::{
-    cosmos_adr028_escrow_address, on_chan_open_init_execute, on_chan_open_init_validate,
-    on_chan_open_try_execute, on_chan_open_try_validate,
+use ibc::apps::transfer::module::{
+    on_chan_open_init_execute, on_chan_open_init_validate, on_chan_open_try_execute,
+    on_chan_open_try_validate,
 };
-use ibc::applications::transfer::VERSION;
-use ibc::core::ics04_channel::channel::{Counterparty, Order};
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ConnectionId, PortId};
-use ibc::prelude::*;
+use ibc::apps::transfer::types::VERSION;
+use ibc::core::channel::types::channel::{Counterparty, Order};
+use ibc::core::channel::types::Version;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::core::primitives::prelude::*;
+use ibc::cosmos_host::utils::cosmos_adr028_escrow_address;
 use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
 use subtle_encoding::bech32;
 
diff --git a/crates/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
similarity index 86%
rename from crates/ibc-testkit/tests/core/ics02_client/create_client.rs
rename to ibc-testkit/tests/core/ics02_client/create_client.rs
index 0e239b3a1..103dd06c7 100644
--- a/crates/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -1,11 +1,13 @@
-use ibc::clients::ics07_tendermint::client_type as tm_client_type;
-use ibc::clients::ics07_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use ibc::core::ics02_client::client_state::ClientStateCommon;
-use ibc::core::ics02_client::msgs::create_client::MsgCreateClient;
-use ibc::core::ics02_client::msgs::ClientMsg;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::Height;
+use ibc::clients::tendermint::types::{
+    client_type as tm_client_type, ConsensusState as TmConsensusState,
+};
+use ibc::core::client::context::client_state::ClientStateCommon;
+use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient};
+use ibc::core::client::types::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::ValidationContext;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
 };
diff --git a/crates/ibc-testkit/tests/core/ics02_client/mod.rs b/ibc-testkit/tests/core/ics02_client/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/core/ics02_client/mod.rs
rename to ibc-testkit/tests/core/ics02_client/mod.rs
diff --git a/crates/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
similarity index 95%
rename from crates/ibc-testkit/tests/core/ics02_client/update_client.rs
rename to ibc-testkit/tests/core/ics02_client/update_client.rs
index 11ba9e9a3..b629adeed 100644
--- a/crates/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -1,26 +1,25 @@
 use core::str::FromStr;
 use core::time::Duration;
 
-use ibc::clients::ics07_tendermint::client_state::ClientState as TmClientState;
-use ibc::clients::ics07_tendermint::client_type as tm_client_type;
-use ibc::clients::ics07_tendermint::header::Header as TmHeader;
-use ibc::clients::ics07_tendermint::misbehaviour::Misbehaviour as TmMisbehaviour;
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc::core::ics02_client::client_type::ClientType;
-use ibc::core::ics02_client::msgs::misbehaviour::MsgSubmitMisbehaviour;
-use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
-use ibc::core::ics02_client::msgs::ClientMsg;
-use ibc::core::ics02_client::ClientValidationContext;
-use ibc::core::ics23_commitment::specs::ProofSpecs;
-use ibc::core::ics24_host::identifier::{ChainId, ClientId};
-use ibc::core::ics24_host::path::ClientConsensusStatePath;
-use ibc::core::timestamp::Timestamp;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
-use ibc::proto::tendermint::v1::{ClientState as RawTmClientState, Fraction};
-use ibc::proto::Any;
-use ibc::{downcast, Height};
+use ibc::clients::tendermint::client_state::ClientState;
+use ibc::clients::tendermint::types::proto::v1::{ClientState as RawTmClientState, Fraction};
+use ibc::clients::tendermint::types::{
+    client_type as tm_client_type, ClientState as TmClientState, Header as TmHeader,
+    Misbehaviour as TmMisbehaviour,
+};
+use ibc::core::client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc::core::client::context::ClientValidationContext;
+use ibc::core::client::types::msgs::{ClientMsg, MsgSubmitMisbehaviour, MsgUpdateClient};
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::specs::ProofSpecs;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChainId, ClientId, ClientType};
+use ibc::core::host::types::path::ClientConsensusStatePath;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::{downcast, Timestamp};
+use ibc::primitives::proto::Any;
 use ibc_testkit::hosts::block::{HostBlock, HostType};
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
@@ -137,7 +136,11 @@ fn test_consensus_state_pruning() {
 
     // Check that latest expired consensus state is pruned.
     let expired_height = Height::new(1, 1).unwrap();
-    let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &expired_height);
+    let client_cons_state_path = ClientConsensusStatePath::new(
+        client_id.clone(),
+        expired_height.revision_number(),
+        expired_height.revision_height(),
+    );
     assert!(ctx
         .client_update_height(&client_id, &expired_height)
         .is_err());
@@ -146,7 +149,11 @@ fn test_consensus_state_pruning() {
 
     // Check that latest valid consensus state exists.
     let earliest_valid_height = Height::new(1, 2).unwrap();
-    let client_cons_state_path = ClientConsensusStatePath::new(&client_id, &earliest_valid_height);
+    let client_cons_state_path = ClientConsensusStatePath::new(
+        client_id.clone(),
+        earliest_valid_height.revision_number(),
+        earliest_valid_height.revision_height(),
+    );
 
     assert!(ctx
         .client_update_height(&client_id, &earliest_valid_height)
@@ -564,7 +571,7 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
 
             let client_state = TmClientState::try_from(raw_client_state).unwrap();
 
-            client_state.into()
+            ClientState::from(client_state).into()
         };
 
         let mut ibc_store = ctx_a.ibc_store.lock();
diff --git a/crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
similarity index 86%
rename from crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
rename to ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index 79733107b..1f86d410c 100644
--- a/crates/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -1,13 +1,15 @@
-use ibc::clients::ics07_tendermint::client_type;
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::error::{ClientError, UpgradeClientError};
-use ibc::core::ics02_client::msgs::upgrade_client::MsgUpgradeClient;
-use ibc::core::ics02_client::msgs::ClientMsg;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::ics24_host::path::ClientConsensusStatePath;
-use ibc::core::{execute, validate, ContextError, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
-use ibc::{downcast, Height};
+use ibc::clients::tendermint::types::client_type;
+use ibc::core::client::types::error::{ClientError, UpgradeClientError};
+use ibc::core::client::types::msgs::{ClientMsg, MsgUpgradeClient};
+use ibc::core::client::types::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::types::path::ClientConsensusStatePath;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::downcast;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
@@ -113,8 +115,9 @@ fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
             let consensus_state = fxt
                 .ctx
                 .consensus_state(&ClientConsensusStatePath::new(
-                    &fxt.msg.client_id,
-                    &plan_height,
+                    fxt.msg.client_id.clone(),
+                    plan_height.revision_number(),
+                    plan_height.revision_height(),
                 ))
                 .unwrap();
             let msg_consensus_state: AnyConsensusState =
@@ -137,7 +140,7 @@ fn upgrade_client_fail_nonexisting_client() {
     let expected_err = ContextError::ClientError(ClientError::ClientStateNotFound {
         client_id: fxt.msg.client_id.clone(),
     });
-    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err)));
 }
 
 #[test]
@@ -151,7 +154,7 @@ fn upgrade_client_fail_low_upgrade_height() {
     .into();
     upgrade_client_validate(
         &fxt,
-        Expect::Failure(Some(ContextError::from(expected_err).into())),
+        Expect::Failure(Some(ContextError::from(expected_err))),
     );
 }
 
@@ -161,5 +164,5 @@ fn upgrade_client_fail_unknown_upgraded_client_state() {
     let expected_err = ContextError::ClientError(ClientError::UnknownClientStateType {
         client_state_type: client_type().to_string(),
     });
-    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+    upgrade_client_validate(&fxt, Expect::Failure(Some(expected_err)));
 }
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
similarity index 88%
rename from crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
rename to ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 7cd0a2333..51617f664 100644
--- a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -1,16 +1,18 @@
 use core::str::FromStr;
 
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use ibc::core::ics03_connection::error::ConnectionError;
-use ibc::core::ics03_connection::msgs::conn_open_ack::MsgConnectionOpenAck;
-use ibc::core::ics03_connection::msgs::ConnectionMsg;
-use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
-use ibc::core::ics24_host::identifier::{ChainId, ClientId};
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, ContextError, MsgEnvelope, RouterError, ValidationContext};
-use ibc::prelude::*;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::error::ConnectionError;
+use ibc::core::connection::types::msgs::{ConnectionMsg, MsgConnectionOpenAck};
+use ibc::core::connection::types::{ConnectionEnd, Counterparty, State};
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChainId, ClientId};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::ZERO_DURATION;
 use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
@@ -100,12 +102,7 @@ fn conn_open_ack_validate(fxt: &Fixture<MsgConnectionOpenAck>, expect: Expect) {
     let right_connection_id = fxt.msg.conn_id_on_a.clone();
     let cons_state_height = fxt.msg.consensus_height_of_a_on_b;
 
-    let ctx_err = match res.unwrap_err() {
-        RouterError::ContextError(e) => e,
-        _ => panic!("unexpected error type"),
-    };
-
-    match ctx_err {
+    match res.unwrap_err() {
         ContextError::ConnectionError(ConnectionError::ConnectionNotFound { connection_id }) => {
             assert_eq!(connection_id, right_connection_id)
         }
@@ -170,7 +167,7 @@ fn conn_open_ack_no_connection() {
     let expected_err = ContextError::ConnectionError(ConnectionError::ConnectionNotFound {
         connection_id: fxt.msg.conn_id_on_a.clone(),
     });
-    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
 }
 
 #[test]
@@ -180,7 +177,7 @@ fn conn_open_ack_invalid_consensus_height() {
         target_height: fxt.msg.consensus_height_of_a_on_b,
         current_height: Height::new(0, 10).unwrap(),
     });
-    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
 }
 
 #[test]
@@ -190,5 +187,5 @@ fn conn_open_ack_connection_mismatch() {
         expected: State::Init.to_string(),
         actual: State::Open.to_string(),
     });
-    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err.into())));
+    conn_open_ack_validate(&fxt, Expect::Failure(Some(expected_err)));
 }
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
similarity index 87%
rename from crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
rename to ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index 6d629162e..f39417b8a 100644
--- a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -1,14 +1,16 @@
 use core::str::FromStr;
 
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{ConnectionEnd, Counterparty, State};
-use ibc::core::ics03_connection::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-use ibc::core::ics03_connection::msgs::ConnectionMsg;
-use ibc::core::ics23_commitment::commitment::CommitmentPrefix;
-use ibc::core::ics24_host::identifier::ClientId;
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::Height;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::msgs::{ConnectionMsg, MsgConnectionOpenConfirm};
+use ibc::core::connection::types::{ConnectionEnd, Counterparty, State};
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::ZERO_DURATION;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::connection::dummy_conn_open_confirm;
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
similarity index 90%
rename from crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
rename to ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index 02e9a38a6..1e78e4dcd 100644
--- a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -1,11 +1,12 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::State;
-use ibc::core::ics03_connection::msgs::conn_open_init::MsgConnectionOpenInit;
-use ibc::core::ics03_connection::msgs::ConnectionMsg;
-use ibc::core::ics03_connection::version::Version;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::{ConnectionMsg, MsgConnectionOpenInit};
+use ibc::core::connection::types::version::Version;
+use ibc::core::connection::types::State;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::connection::{
diff --git a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
similarity index 91%
rename from crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
rename to ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index 47a87a673..e1a662c6c 100644
--- a/crates/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -1,10 +1,12 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::State;
-use ibc::core::ics03_connection::msgs::conn_open_try::MsgConnectionOpenTry;
-use ibc::core::ics03_connection::msgs::ConnectionMsg;
-use ibc::core::ics24_host::identifier::ChainId;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::Height;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::{ConnectionMsg, MsgConnectionOpenTry};
+use ibc::core::connection::types::State;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
 use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/ibc-testkit/tests/core/ics03_connection/mod.rs b/ibc-testkit/tests/core/ics03_connection/mod.rs
new file mode 100644
index 000000000..c504edc00
--- /dev/null
+++ b/ibc-testkit/tests/core/ics03_connection/mod.rs
@@ -0,0 +1,4 @@
+pub mod conn_open_ack;
+pub mod conn_open_confirm;
+pub mod conn_open_init;
+pub mod conn_open_try;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
similarity index 89%
rename from crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
rename to ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index c79908f8f..11fed0970 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -1,19 +1,19 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics02_client::ClientExecutionContext;
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::channel::types::msgs::{MsgAcknowledgement, PacketMsg};
+use ibc::core::channel::types::Version;
+use ibc::core::client::context::ClientExecutionContext;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
-use ibc::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-use ibc::core::ics04_channel::msgs::PacketMsg;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
-use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
-use ibc::prelude::*;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::ExecutionContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
similarity index 86%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index 6ab70d27d..b308a2d29 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -1,15 +1,16 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelCloseConfirm};
+use ibc::core::channel::types::Version;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
-use ibc::core::ics04_channel::msgs::{ChannelMsg, MsgChannelCloseConfirm};
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
similarity index 86%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 51d880cfe..286a84c15 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -1,15 +1,16 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelCloseInit};
+use ibc::core::channel::types::Version;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
-use ibc::core::ics04_channel::msgs::{ChannelMsg, MsgChannelCloseInit};
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
similarity index 90%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index 25a7d36c5..b5932d227 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -1,18 +1,17 @@
-use ibc::applications::transfer::MODULE_ID_STR;
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{
+use ibc::apps::transfer::types::MODULE_ID_STR;
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenAck};
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-use ibc::core::ics04_channel::msgs::ChannelMsg;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::router::ModuleId;
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::primitives::*;
+use ibc::core::router::types::module::ModuleId;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
similarity index 89%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index 1b6df3e4b..6b3513571 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -1,17 +1,16 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenConfirm};
+use ibc::core::channel::types::Version;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-use ibc::core::ics04_channel::msgs::ChannelMsg;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId};
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId};
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
similarity index 82%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index 645d1a180..590f68e56 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -1,13 +1,13 @@
-use ibc::clients::ics07_tendermint::client_type as tm_client_type;
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics03_connection::connection::{ConnectionEnd, State as ConnectionState};
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-use ibc::core::ics04_channel::msgs::ChannelMsg;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
+use ibc::clients::tendermint::types::client_type as tm_client_type;
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenInit};
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{ConnectionEnd, State as ConnectionState};
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::ValidationContext;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
similarity index 88%
rename from crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
rename to ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index bcee388bf..3ebe68460 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -1,15 +1,15 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenTry};
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-use ibc::core::ics04_channel::msgs::ChannelMsg;
-use ibc::core::ics24_host::identifier::{ClientId, ConnectionId};
-use ibc::core::timestamp::ZERO_DURATION;
-use ibc::core::{execute, validate, MsgEnvelope, ValidationContext};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/mod.rs b/ibc-testkit/tests/core/ics04_channel/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/core/ics04_channel/mod.rs
rename to ibc-testkit/tests/core/ics04_channel/mod.rs
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
similarity index 89%
rename from crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
rename to ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 64b4b5ca8..90fda5f92 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -1,19 +1,19 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::ClientExecutionContext;
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::msgs::{MsgRecvPacket, PacketMsg};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::Version;
+use ibc::core::client::context::ClientExecutionContext;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-use ibc::core::ics04_channel::msgs::PacketMsg;
-use ibc::core::ics04_channel::packet::Packet;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
-use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::ExecutionContext;
+use ibc::core::primitives::*;
 use ibc_testkit::relayer::context::RelayerContext;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
similarity index 91%
rename from crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs
rename to ibc-testkit/tests/core/ics04_channel/send_packet.rs
index 4262627c0..d3b1fcbc4 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -1,19 +1,18 @@
 use core::ops::Add;
 use core::time::Duration;
 
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::handler::send_packet;
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::Version;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::packet::Packet;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::send_packet;
-use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
-use ibc::prelude::*;
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::channel::dummy_raw_packet;
 use test_log::test;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
similarity index 93%
rename from crates/ibc-testkit/tests/core/ics04_channel/timeout.rs
rename to ibc-testkit/tests/core/ics04_channel/timeout.rs
index d0e2bcd01..10cbe83c8 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -1,19 +1,19 @@
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::height::Height;
-use ibc::core::ics02_client::ClientExecutionContext;
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::channel::types::msgs::{MsgTimeout, PacketMsg};
+use ibc::core::channel::types::Version;
+use ibc::core::client::context::ClientExecutionContext;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
-use ibc::core::ics04_channel::msgs::timeout::MsgTimeout;
-use ibc::core::ics04_channel::msgs::PacketMsg;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
-use ibc::core::{execute, validate, ExecutionContext, MsgEnvelope};
-use ibc::prelude::*;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::ExecutionContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
diff --git a/crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
similarity index 85%
rename from crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
rename to ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 8aa8d9e00..5e7a1b538 100644
--- a/crates/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -1,18 +1,18 @@
-use ibc::core::ics02_client::ClientExecutionContext;
-use ibc::core::ics03_connection::connection::{
+use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
+use ibc::core::channel::types::commitment::{compute_packet_commitment, PacketCommitment};
+use ibc::core::channel::types::msgs::{MsgTimeoutOnClose, PacketMsg};
+use ibc::core::channel::types::Version;
+use ibc::core::client::context::ClientExecutionContext;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
-use ibc::core::ics03_connection::version::get_compatible_versions;
-use ibc::core::ics04_channel::channel::{ChannelEnd, Counterparty, Order, State};
-use ibc::core::ics04_channel::commitment::{compute_packet_commitment, PacketCommitment};
-use ibc::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use ibc::core::ics04_channel::msgs::PacketMsg;
-use ibc::core::ics04_channel::Version;
-use ibc::core::ics24_host::identifier::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::timestamp::{Timestamp, ZERO_DURATION};
-use ibc::core::{validate, ExecutionContext, MsgEnvelope};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::core::entrypoint::validate;
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::ExecutionContext;
+use ibc::core::primitives::*;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
diff --git a/crates/ibc-testkit/tests/core/mod.rs b/ibc-testkit/tests/core/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/core/mod.rs
rename to ibc-testkit/tests/core/mod.rs
diff --git a/crates/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
similarity index 91%
rename from crates/ibc-testkit/tests/core/router.rs
rename to ibc-testkit/tests/core/router.rs
index 94a5a0c2a..59708282d 100644
--- a/crates/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -1,28 +1,25 @@
-use ibc::applications::transfer::error::TokenTransferError;
-use ibc::applications::transfer::msgs::transfer::MsgTransfer;
-use ibc::applications::transfer::{send_transfer, BaseCoin};
-use ibc::core::events::{IbcEvent, MessageEvent};
-use ibc::core::ics02_client::msgs::create_client::MsgCreateClient;
-use ibc::core::ics02_client::msgs::update_client::MsgUpdateClient;
-use ibc::core::ics02_client::msgs::ClientMsg;
-use ibc::core::ics03_connection::msgs::ConnectionMsg;
-use ibc::core::ics04_channel::error::ChannelError;
-use ibc::core::ics04_channel::msgs::acknowledgement::MsgAcknowledgement;
-use ibc::core::ics04_channel::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-use ibc::core::ics04_channel::msgs::chan_close_init::MsgChannelCloseInit;
-use ibc::core::ics04_channel::msgs::chan_open_ack::MsgChannelOpenAck;
-use ibc::core::ics04_channel::msgs::chan_open_init::MsgChannelOpenInit;
-use ibc::core::ics04_channel::msgs::chan_open_try::MsgChannelOpenTry;
-use ibc::core::ics04_channel::msgs::recv_packet::MsgRecvPacket;
-use ibc::core::ics04_channel::msgs::timeout_on_close::MsgTimeoutOnClose;
-use ibc::core::ics04_channel::msgs::{ChannelMsg, PacketMsg};
-use ibc::core::ics04_channel::timeout::TimeoutHeight;
-use ibc::core::ics24_host::identifier::ConnectionId;
-use ibc::core::ics24_host::path::CommitmentPath;
-use ibc::core::timestamp::Timestamp;
-use ibc::core::{dispatch, MsgEnvelope, RouterError, ValidationContext};
-use ibc::prelude::*;
-use ibc::Height;
+use ibc::apps::transfer::handler::send_transfer;
+use ibc::apps::transfer::types::error::TokenTransferError;
+use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
+use ibc::apps::transfer::types::BaseCoin;
+use ibc::core::channel::types::error::ChannelError;
+use ibc::core::channel::types::msgs::{
+    ChannelMsg, MsgAcknowledgement, MsgChannelCloseConfirm, MsgChannelCloseInit, MsgChannelOpenAck,
+    MsgChannelOpenInit, MsgChannelOpenTry, MsgRecvPacket, MsgTimeoutOnClose, PacketMsg,
+};
+use ibc::core::channel::types::timeout::TimeoutHeight;
+use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient, MsgUpdateClient};
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::ConnectionMsg;
+use ibc::core::entrypoint::dispatch;
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ConnectionId;
+use ibc::core::host::types::path::CommitmentPath;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
 use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::MockClientState;
 use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
@@ -421,7 +418,7 @@ fn routing_module_and_keepers() {
                 .map_err(|e: TokenTransferError| ChannelError::AppModule {
                     description: e.to_string(),
                 })
-                .map_err(|e| RouterError::ContextError(e.into())),
+                .map_err(ContextError::from),
         };
 
         assert_eq!(
diff --git a/crates/ibc-testkit/tests/data/json/client_state.json b/ibc-testkit/tests/data/json/client_state.json
similarity index 100%
rename from crates/ibc-testkit/tests/data/json/client_state.json
rename to ibc-testkit/tests/data/json/client_state.json
diff --git a/crates/ibc-testkit/tests/data/json/client_state_proof.json b/ibc-testkit/tests/data/json/client_state_proof.json
similarity index 100%
rename from crates/ibc-testkit/tests/data/json/client_state_proof.json
rename to ibc-testkit/tests/data/json/client_state_proof.json
diff --git a/crates/ibc-testkit/tests/data/json/consensus_state.json b/ibc-testkit/tests/data/json/consensus_state.json
similarity index 100%
rename from crates/ibc-testkit/tests/data/json/consensus_state.json
rename to ibc-testkit/tests/data/json/consensus_state.json
diff --git a/crates/ibc-testkit/tests/data/json/consensus_state_proof.json b/ibc-testkit/tests/data/json/consensus_state_proof.json
similarity index 100%
rename from crates/ibc-testkit/tests/data/json/consensus_state_proof.json
rename to ibc-testkit/tests/data/json/consensus_state_proof.json
diff --git a/crates/ibc-testkit/tests/data/json/signed_header.json b/ibc-testkit/tests/data/json/signed_header.json
similarity index 100%
rename from crates/ibc-testkit/tests/data/json/signed_header.json
rename to ibc-testkit/tests/data/json/signed_header.json
diff --git a/crates/ibc-testkit/tests/mod.rs b/ibc-testkit/tests/mod.rs
similarity index 100%
rename from crates/ibc-testkit/tests/mod.rs
rename to ibc-testkit/tests/mod.rs
diff --git a/ibc/Cargo.toml b/ibc/Cargo.toml
new file mode 100644
index 000000000..a5866ed50
--- /dev/null
+++ b/ibc/Cargo.toml
@@ -0,0 +1,68 @@
+[package]
+name         = "ibc"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "consensus", "cosmos", "ibc"]
+readme       = "README.md"
+description  = """
+    Maintained by `ibc-rs`, serves as a top-level library that contain a comprehensive set of
+    Inter-Blockchain Communication (IBC) implementations, re-exporting data structures and 
+    implementations of various IBC core, clients and applications from the `ibc-core`, 
+    `ibc-clients` and `ibc-apps` crates.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# ibc dependencies
+ibc-apps              = { workspace = true }
+ibc-clients           = { workspace = true }
+ibc-core              = { workspace = true }
+ibc-core-host-cosmos  = { workspace = true }
+ibc-derive            = { workspace = true }
+ibc-primitives        = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-apps/std",
+    "ibc-clients/std",
+    "ibc-core/std",
+    "ibc-core-host-cosmos/std",
+    "ibc-primitives/std",
+]
+borsh = [
+    "ibc-apps/borsh",
+    "ibc-clients/borsh",
+    "ibc-core/borsh",
+    "ibc-core-host-cosmos/borsh",
+    "ibc-primitives/borsh",
+]
+serde = [
+    "ibc-apps/serde",
+    "ibc-clients/serde",
+    "ibc-core/serde",
+    "ibc-core-host-cosmos/serde",
+    "ibc-primitives/serde",
+]
+schema = [
+    "ibc-apps/schema",
+    "ibc-clients/schema",
+    "ibc-core/schema",
+    "ibc-core-host-cosmos/schema",
+    "ibc-primitives/schema",
+    "serde", 
+    "std"
+]
+parity-scale-codec = [
+    "ibc-apps/parity-scale-codec",
+    "ibc-clients/parity-scale-codec",
+    "ibc-core/parity-scale-codec",
+    "ibc-core-host-cosmos/parity-scale-codec",
+    "ibc-primitives/parity-scale-codec",
+]
\ No newline at end of file
diff --git a/ibc/README.md b/ibc/README.md
new file mode 100644
index 000000000..20eb03295
--- /dev/null
+++ b/ibc/README.md
@@ -0,0 +1,68 @@
+<div align="center">
+    <h1>IBC in Rust</h1>
+</div>
+
+![banner](./../docs/static/img/ibc-rs-cover.svg)
+
+<div align="center">
+
+[![Crate][crate-image]][crate-link]
+[![Docs][docs-image]][docs-link]
+[![Build Status][build-image]][build-link]
+[![Apache 2.0 Licensed][license-image]][license-link]
+![Rust Stable][rustc-image]
+![Rust 1.64+][rustc-version]
+
+</div>
+
+Implementation of the Inter-Blockchain Communication Protocol ([IBC]) in Rust.
+This crate serves as one-stop shop library re-exporting data structures and
+implementations of various IBC core, clients and applications from the
+[`ibc-core`](../ibc-core), [`ibc-clients`](../ibc-clients) and
+[`ibc-apps`](../ibc-apps) crates.
+
+## Documentation
+
+See documentation on [docs.rs][docs-link].
+
+## Contributing
+
+IBC is specified in English in the [cosmos/ibc
+repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
+should be contributed there.
+
+If you're interested in contributing, please take a look at the
+[CONTRIBUTING](./../CONTRIBUTING.md) guidelines. We welcome and appreciate
+community contributions!
+
+## License
+
+Copyright © 2021 Informal Systems Inc. and `ibc-rs` authors.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+the files in this repository except in compliance with the License. You may
+obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.
+
+[//]: # (badges)
+
+[crate-image]: https://img.shields.io/crates/v/ibc.svg
+[crate-link]: https://crates.io/crates/ibc
+[docs-image]: https://docs.rs/ibc/badge.svg
+[docs-link]: https://docs.rs/ibc/
+[build-image]: https://github.com/cosmos/ibc-rs/workflows/Rust/badge.svg
+[build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
+[license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
+[license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
+[rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
+[rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
+
+[//]: # (general links)
+
+[IBC]: https://github.com/cosmos/ibc
diff --git a/ibc/src/lib.rs b/ibc/src/lib.rs
new file mode 100644
index 000000000..1e9eaab80
--- /dev/null
+++ b/ibc/src/lib.rs
@@ -0,0 +1,73 @@
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+//! This library re-exports implementations of all the Inter-Blockchain
+//! Communication (IBC) specifications available in [`ibc-rs`][ibc-rs]
+//! repository. IBC is a distributed protocol that enables communication between
+//! distinct sovereign blockchains.
+//!
+//! The layout of this crate mirrors the organization of the [IBC
+//! Standard][ibc-standard]:
+//!
+//! + [Core](core) implements the transport, authentication, and ordering layers
+//!   of the IBC protocol.
+//!
+//! + [Clients](clients) consists of implementations of client verification
+//! algorithms (following the base client interface that is defined in `Core`)
+//! for specific consensus algorithms. A chain uses these verification
+//! algorithms to verify the state of remote chains.
+//!
+//! + [Applications](apps) consists of implementations of some IBC applications.
+//! This is the part of the protocol that abstracts away the core protocol and
+//! focuses solely on business logic.
+//!
+//! When processing a given message `M`, if any method in this library returns
+//! an error, the runtime is expected to rollback all state modifications made
+//! to the context (e.g.
+//! [`ExecutionContext`](crate::core::host::ExecutionContext)) while processing
+//! `M`. If a transaction on your blockchain contains multiple messages, then
+//! typically the state modifications from all messages is expected to be rolled
+//! back as well.
+//!
+//! [ibc-standard]: https://github.com/cosmos/ibc
+//! [ibc-rs]: https://github.com/cosmos/ibc-rs
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+/// Re-exports primitive types and traits from the `ibc-primitives` crate.
+pub mod primitives {
+    pub use ibc_primitives::*;
+}
+
+/// Re-exports implementations of all the IBC core (TAO) modules.
+pub mod core {
+    #[doc(inline)]
+    pub use ibc_core::*;
+}
+
+/// Re-exports implementations of IBC light clients.
+pub mod clients {
+    #[doc(inline)]
+    pub use ibc_clients::*;
+}
+
+/// Re-exports implementations of various IBC applications.
+pub mod apps {
+    #[doc(inline)]
+    pub use ibc_apps::*;
+}
+
+/// Re-exports Cosmos-specific utility types, traits, and implementations.
+pub mod cosmos_host {
+    pub use ibc_core_host_cosmos::*;
+}

From 4596f88c3d99fbbb106587c5c263a42f013e988d Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 22 Nov 2023 09:43:45 -0800
Subject: [PATCH 060/182] fix: cw-check (#977)

---
 README.md              |   2 +-
 ci/cw-check/Cargo.lock | 420 ++++++++++++++++++++++++++++++++++++-----
 ci/cw-check/Cargo.toml |  10 +-
 ci/cw-check/src/lib.rs |   8 +-
 ibc-clients/README.md  |   4 +-
 5 files changed, 385 insertions(+), 59 deletions(-)

diff --git a/README.md b/README.md
index 51971b1bb..4bdeeafcf 100644
--- a/README.md
+++ b/README.md
@@ -35,7 +35,7 @@ sub-crates that can be used independently or together.
 |[ibc](ibc)                             | Re-exports all the data structures and on-chain logic of various IBC core, clients and applications. |
 |[ibc-data-types](ibc-data-types)       | Re-exports all the IBC data types that are shared across different IBC implementations. |
 |[ibc-core](ibc-core)                   | Contains data structures and implementations of all the IBC core specifications. |
-|[ibc-client](ibc-clients)              | Contains data structures and implementations of various IBC light clients. |
+|[ibc-clients](ibc-clients)             | Contains data structures and implementations of various IBC light clients. |
 |[ibc-apps](ibc-apps)                   | Contains data structures and implementations of various IBC applications. |
 |[ibc-testkit](ibc-testkit)             | Provides testing toolkit to aid `ibc-rs` and host chains in writing integration tests. |
 |[ibc-query](ibc-query)                 | Contains utility traits and implementations for querying states of an integrated IBC module. |
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 30e602dc1..d2c236984 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -93,9 +93,9 @@ checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"
 
 [[package]]
 name = "bytes"
-version = "1.4.0"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "89b2fd2a0dcf38d7971e2194b6b6eebab45ae01067456a7fd93d5547a61b70be"
+checksum = "a2bd12c1caf447e69cd4528f47f94d203fd2582878ecb9e9465484c4148a8223"
 dependencies = [
  "serde",
 ]
@@ -174,7 +174,7 @@ dependencies = [
  "schemars",
  "serde",
  "serde-json-wasm 0.5.1",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "thiserror",
 ]
 
@@ -614,29 +614,357 @@ dependencies = [
 [[package]]
 name = "ibc"
 version = "0.47.0"
+dependencies = [
+ "ibc-apps",
+ "ibc-clients",
+ "ibc-core",
+ "ibc-core-host-cosmos",
+ "ibc-derive",
+ "ibc-primitives",
+]
+
+[[package]]
+name = "ibc-app-transfer"
+version = "0.47.0"
+dependencies = [
+ "ibc-app-transfer-types",
+ "ibc-core",
+ "serde-json-wasm 1.0.0",
+]
+
+[[package]]
+name = "ibc-app-transfer-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core",
+ "ibc-proto",
+ "parity-scale-codec",
+ "primitive-types",
+ "scale-info",
+ "serde",
+ "uint",
+]
+
+[[package]]
+name = "ibc-apps"
+version = "0.47.0"
+dependencies = [
+ "ibc-app-transfer",
+]
+
+[[package]]
+name = "ibc-client-tendermint"
+version = "0.47.0"
+dependencies = [
+ "ibc-client-tendermint-types",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-primitives",
+ "prost",
+ "serde",
+ "tendermint",
+ "tendermint-light-client-verifier",
+]
+
+[[package]]
+name = "ibc-client-tendermint-types"
+version = "0.47.0"
 dependencies = [
  "bytes",
+ "displaydoc",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "tendermint",
+ "tendermint-light-client-verifier",
+ "tendermint-proto",
+]
+
+[[package]]
+name = "ibc-clients"
+version = "0.47.0"
+dependencies = [
+ "ibc-client-tendermint",
+]
+
+[[package]]
+name = "ibc-core"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+]
+
+[[package]]
+name = "ibc-core-channel"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel-types",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-channel-types"
+version = "0.47.0"
+dependencies = [
  "derive_more",
  "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "sha2 0.10.8",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-client"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-client-context"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
  "ibc-derive",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-client-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-commitment-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-commitment-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-primitives",
+ "ibc-proto",
+ "ics23",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-connection"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-client",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-primitives",
+ "prost",
+]
+
+[[package]]
+name = "ibc-core-connection-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-handler"
+version = "0.47.0"
+dependencies = [
+ "ibc-core-channel",
+ "ibc-core-client",
+ "ibc-core-commitment-types",
+ "ibc-core-connection",
+ "ibc-core-handler-types",
+ "ibc-core-host",
+ "ibc-core-router",
+ "ibc-primitives",
+]
+
+[[package]]
+name = "ibc-core-handler-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-host-types",
+ "ibc-core-router-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-host"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-host-cosmos"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-app-transfer-types",
+ "ibc-client-tendermint",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "sha2 0.10.8",
+ "subtle-encoding",
+ "tendermint",
+]
+
+[[package]]
+name = "ibc-core-host-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-primitives",
+ "parity-scale-codec",
+ "scale-info",
+ "serde",
+]
+
+[[package]]
+name = "ibc-core-router"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-channel-types",
+ "ibc-core-host-types",
+ "ibc-core-router-types",
+ "ibc-primitives",
+ "prost",
+ "subtle-encoding",
+]
+
+[[package]]
+name = "ibc-core-router-types"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-core-host-types",
+ "ibc-primitives",
  "ibc-proto",
  "ics23",
- "num-traits",
  "parity-scale-codec",
- "primitive-types",
  "prost",
  "scale-info",
  "serde",
- "serde-json-wasm 1.0.0",
- "serde_derive",
- "sha2 0.10.7",
  "subtle-encoding",
  "tendermint",
- "tendermint-light-client-verifier",
- "tendermint-proto",
- "time",
- "tracing",
- "uint",
 ]
 
 [[package]]
@@ -649,6 +977,21 @@ dependencies = [
  "syn 2.0.28",
 ]
 
+[[package]]
+name = "ibc-primitives"
+version = "0.47.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-proto",
+ "parity-scale-codec",
+ "prost",
+ "scale-info",
+ "serde",
+ "tendermint",
+ "time",
+]
+
 [[package]]
 name = "ibc-proto"
 version = "0.38.0"
@@ -680,7 +1023,7 @@ dependencies = [
  "prost",
  "ripemd",
  "serde",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "sha3",
 ]
 
@@ -754,7 +1097,7 @@ dependencies = [
  "cfg-if",
  "ecdsa",
  "elliptic-curve",
- "sha2 0.10.7",
+ "sha2 0.10.8",
 ]
 
 [[package]]
@@ -812,9 +1155,9 @@ checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.4"
+version = "3.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd8e946cc0cc711189c0b0249fb8b599cbeeab9784d83c415719368bb8d4ac64"
+checksum = "0dec8a8073036902368c2cdc0387e85ff9a37054d7e7c98e592145e0c92cd4fb"
 dependencies = [
  "arrayvec",
  "byte-slice-cast",
@@ -824,9 +1167,9 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.4"
+version = "3.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a296c3079b5fefbc499e1de58dc26c09b1b9a5952d26694ee89f04a43ebbb3e"
+checksum = "312270ee71e1cd70289dacf597cab7b207aa107d2f28191c2ae45b2ece18a260"
 dependencies = [
  "proc-macro-crate",
  "proc-macro2",
@@ -874,9 +1217,9 @@ dependencies = [
 
 [[package]]
 name = "primitive-types"
-version = "0.12.1"
+version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9f3486ccba82358b11a77516035647c34ba167dfa53312630de83b12bd4f3d66"
+checksum = "0b34d9fd68ae0b74a41b21c03c2f62847aa0ffea044eee893b4c140b37e244e2"
 dependencies = [
  "fixed-hash",
  "impl-serde",
@@ -936,9 +1279,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.32"
+version = "1.0.33"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "50f3b39ccfb720540debaa0164757101c08ecb8d326b15358ce76a62c7e85965"
+checksum = "5267fca4496028628a95160fc423a33e8b2e6af8a5302579e322e4b520293cae"
 dependencies = [
  "proc-macro2",
 ]
@@ -986,9 +1329,9 @@ checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
 
 [[package]]
 name = "scale-info"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "35c0a159d0c45c12b20c5a844feb1fe4bea86e28f17b92a5f0c42193634d3782"
+checksum = "7f7d66a1128282b7ef025a8ead62a4a9fcf017382ec53b8ffbf4d7bf77bd3c60"
 dependencies = [
  "cfg-if",
  "derive_more",
@@ -998,9 +1341,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.9.0"
+version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "912e55f6d20e0e80d63733872b40e1227c0bce1e1ab81ba67d696339bfd7fd29"
+checksum = "abf2c68b89cafb3b8d918dd07b42be0da66ff202cf1155c5739a4e0c1ea0dc19"
 dependencies = [
  "proc-macro-crate",
  "proc-macro2",
@@ -1141,9 +1484,9 @@ dependencies = [
 
 [[package]]
 name = "sha2"
-version = "0.10.7"
+version = "0.10.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "479fb9d862239e610720565ca91403019f2f00410f1864c5aa7479b950a76ed8"
+checksum = "793db75ad2bcafc3ffa7c68b215fee268f537982cd901d132f89c6343f3a3dc8"
 dependencies = [
  "cfg-if",
  "cpufeatures",
@@ -1271,7 +1614,7 @@ dependencies = [
  "serde_bytes",
  "serde_json",
  "serde_repr",
- "sha2 0.10.7",
+ "sha2 0.10.8",
  "signature 2.1.0",
  "subtle",
  "subtle-encoding",
@@ -1373,23 +1716,6 @@ dependencies = [
  "winnow",
 ]
 
-[[package]]
-name = "tracing"
-version = "0.1.37"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8ce8c33a8d48bd45d624a6e523445fd21ec13d3653cd51f681abf67418f54eb8"
-dependencies = [
- "cfg-if",
- "pin-project-lite",
- "tracing-core",
-]
-
-[[package]]
-name = "tracing-core"
-version = "0.1.31"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0955b8137a1df6f1a2e9a37d8a6656291ff0297c1a97c24e0d8425fe2312f79a"
-
 [[package]]
 name = "typenum"
 version = "1.16.0"
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 6d57e8947..12d7e8076 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -7,11 +7,11 @@ version = "0.1.0"
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
-ibc = { path = "../../crates/ibc", default_features = false, features = ["serde", "parity-scale-codec"]}
-cosmwasm-std = { version = "1.2.5", default-features = false}
-cosmwasm-schema = { version = "1.2.5", default-features = false}
-serde_json =  {package = "serde-json-wasm", version = "1.0.0", default-features = false }
-thiserror = { version = "*", default-features = false}
+ibc = { path = "../../ibc", default_features = false, features = ["serde", "parity-scale-codec"] }
+cosmwasm-std = { version = "1.2.5", default-features = false }
+cosmwasm-schema = { version = "1.2.5", default-features = false }
+serde_json =  { package = "serde-json-wasm", version = "1.0.0", default-features = false }
+thiserror = { version = "*", default-features = false }
 
 [profile.release]
 lto = true
diff --git a/ci/cw-check/src/lib.rs b/ci/cw-check/src/lib.rs
index e13da8cd5..185e0270f 100644
--- a/ci/cw-check/src/lib.rs
+++ b/ci/cw-check/src/lib.rs
@@ -3,10 +3,10 @@ use std::str::FromStr;
 
 use cosmwasm_schema::cw_serde;
 use cosmwasm_std::{DepsMut, Env, MessageInfo, Response};
-use ibc::{
-    applications::transfer::{msgs::transfer::MsgTransfer, packet::PacketData, *},
-    core::ics24_host::identifier::*,
-};
+use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
+use ibc::apps::transfer::types::packet::PacketData;
+use ibc::apps::transfer::types::{Amount, BaseDenom, PrefixedCoin, PrefixedDenom, TracePath};
+use ibc::core::host::types::identifiers::*;
 use thiserror::Error;
 
 #[cw_serde]
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
index 6aa0466cf..c72ac618e 100644
--- a/ibc-clients/README.md
+++ b/ibc-clients/README.md
@@ -23,8 +23,8 @@ IBC light clients:
 
 ### ICS-07: Tendermint Light Client
 
-- [ibc-client-tendermint](../ibc-client-tendermint)
-- [ibc-client-tendermint-types](../ibc-client-tendermint-types)
+- [ibc-client-tendermint](./ics07-tendermint)
+- [ibc-client-tendermint-types](./ics07-tendermint/types)
 
 ## Third-party Clients
 

From 71df7e8e8ab7be65e6be8969fa26ead92cbb0385 Mon Sep 17 00:00:00 2001
From: Blas Rodriguez Irizar <rodrigblas@gmail.com>
Date: Wed, 22 Nov 2023 14:47:40 -0300
Subject: [PATCH 061/182] optimization: reduce heap allocation (#970)

* optimization: reduce heap allocation

Prefer str::from_utf8 over String::from_utf8 to avoid
unnecesary heap allocation

* fmt

* chore: add unclog

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../unreleased/improvements/970-reduce-heap-allocation.md     | 3 +++
 ibc-core/ics02-client/types/src/events.rs                     | 2 +-
 ibc-core/ics04-channel/types/src/events/packet_attributes.rs  | 4 ++--
 ibc-primitives/src/prelude.rs                                 | 2 +-
 4 files changed, 7 insertions(+), 4 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/970-reduce-heap-allocation.md

diff --git a/.changelog/unreleased/improvements/970-reduce-heap-allocation.md b/.changelog/unreleased/improvements/970-reduce-heap-allocation.md
new file mode 100644
index 000000000..9854416b2
--- /dev/null
+++ b/.changelog/unreleased/improvements/970-reduce-heap-allocation.md
@@ -0,0 +1,3 @@
+- Reduce heap allocation by using `str` instead of `String` places we convert
+  domain event attributes to the ABCI event attributes
+  ([\#970](https://github.com/cosmos/ibc-rs/issues/970))
diff --git a/ibc-core/ics02-client/types/src/events.rs b/ibc-core/ics02-client/types/src/events.rs
index 31625757b..f9ae7213c 100644
--- a/ibc-core/ics02-client/types/src/events.rs
+++ b/ibc-core/ics02-client/types/src/events.rs
@@ -153,7 +153,7 @@ impl From<HeaderAttribute> for abci::EventAttribute {
     fn from(attr: HeaderAttribute) -> Self {
         (
             HEADER_ATTRIBUTE_KEY,
-            String::from_utf8(hex::encode(attr.header))
+            str::from_utf8(&hex::encode(attr.header))
                 .expect("Never fails because hexadecimal is valid UTF-8"),
         )
             .into()
diff --git a/ibc-core/ics04-channel/types/src/events/packet_attributes.rs b/ibc-core/ics04-channel/types/src/events/packet_attributes.rs
index 44a7970a8..2366ae71e 100644
--- a/ibc-core/ics04-channel/types/src/events/packet_attributes.rs
+++ b/ibc-core/ics04-channel/types/src/events/packet_attributes.rs
@@ -59,7 +59,7 @@ impl TryFrom<PacketDataAttribute> for Vec<abci::EventAttribute> {
                 .into(),
             (
                 PKT_DATA_HEX_ATTRIBUTE_KEY,
-                String::from_utf8(hex::encode(attr.packet_data))
+                str::from_utf8(&hex::encode(attr.packet_data))
                     .expect("Never fails because hexadecimal is valid UTF8"),
             )
                 .into(),
@@ -329,7 +329,7 @@ impl TryFrom<AcknowledgementAttribute> for Vec<abci::EventAttribute> {
                 .into(),
             (
                 PKT_ACK_HEX_ATTRIBUTE_KEY,
-                String::from_utf8(hex::encode(attr.acknowledgement))
+                str::from_utf8(&hex::encode(attr.acknowledgement))
                     .expect("Never fails because hexadecimal is always valid UTF-8"),
             )
                 .into(),
diff --git a/ibc-primitives/src/prelude.rs b/ibc-primitives/src/prelude.rs
index 1dd86e2e1..3662f7bb9 100644
--- a/ibc-primitives/src/prelude.rs
+++ b/ibc-primitives/src/prelude.rs
@@ -4,5 +4,5 @@ pub use alloc::borrow::ToOwned;
 pub use alloc::boxed::Box;
 pub use alloc::string::{String, ToString};
 pub use alloc::vec::Vec;
-pub use alloc::{format, vec};
+pub use alloc::{format, str, vec};
 pub use core::prelude::v1::*;

From 45b1c97186827972e5668d3b369a1e56c56ab169 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Wed, 22 Nov 2023 19:03:17 +0100
Subject: [PATCH 062/182] feat: provide `Into<String>` for identifier types
 (#974)

* feat: provide `Into<String>` and `AsRef<str>` for identifier types

* fix: use as_str on chain_id

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .changelog/unreleased/features/974-id-into-string.md       | 2 ++
 ibc-core/ics24-host/types/src/identifiers/chain_id.rs      | 6 ++++++
 ibc-core/ics24-host/types/src/identifiers/channel_id.rs    | 3 ++-
 ibc-core/ics24-host/types/src/identifiers/connection_id.rs | 3 ++-
 ibc-core/ics24-host/types/src/identifiers/port_id.rs       | 3 ++-
 ibc-testkit/src/hosts/block.rs                             | 2 +-
 6 files changed, 15 insertions(+), 4 deletions(-)
 create mode 100644 .changelog/unreleased/features/974-id-into-string.md

diff --git a/.changelog/unreleased/features/974-id-into-string.md b/.changelog/unreleased/features/974-id-into-string.md
new file mode 100644
index 000000000..fb2d5bb3a
--- /dev/null
+++ b/.changelog/unreleased/features/974-id-into-string.md
@@ -0,0 +1,2 @@
+- Provide `Into<String>` for all identifiers types.
+  ([\#974](https://github.com/cosmos/ibc-rs/pull/974))
diff --git a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
index 5b532aeef..a88fdc940 100644
--- a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
@@ -148,6 +148,12 @@ impl FromStr for ChainId {
     }
 }
 
+impl From<ChainId> for String {
+    fn from(chain_id: ChainId) -> String {
+        chain_id.id
+    }
+}
+
 impl Display for ChainId {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
         write!(f, "{}", self.id)
diff --git a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
index f4dc7e2fa..3cfeacb7b 100644
--- a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
@@ -1,6 +1,7 @@
 use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use derive_more::Into;
 use ibc_primitives::prelude::*;
 
 use crate::error::IdentifierError;
@@ -22,7 +23,7 @@ const CHANNEL_ID_PREFIX: &str = "channel";
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
 pub struct ChannelId(String);
 
 impl ChannelId {
diff --git a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
index 10a2c8857..a0283f5f4 100644
--- a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
@@ -1,6 +1,7 @@
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use derive_more::Into;
 use ibc_primitives::prelude::*;
 
 use crate::error::IdentifierError;
@@ -22,7 +23,7 @@ const CONNECTION_ID_PREFIX: &str = "connection";
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
 pub struct ConnectionId(String);
 
 impl ConnectionId {
diff --git a/ibc-core/ics24-host/types/src/identifiers/port_id.rs b/ibc-core/ics24-host/types/src/identifiers/port_id.rs
index d1b640757..e1a0e062d 100644
--- a/ibc-core/ics24-host/types/src/identifiers/port_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/port_id.rs
@@ -1,6 +1,7 @@
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
+use derive_more::Into;
 use ibc_primitives::prelude::*;
 
 use crate::error::IdentifierError;
@@ -22,7 +23,7 @@ const TRANSFER_PORT_ID: &str = "transfer";
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
 pub struct PortId(String);
 
 impl PortId {
diff --git a/ibc-testkit/src/hosts/block.rs b/ibc-testkit/src/hosts/block.rs
index be7419c65..9ce08cdce 100644
--- a/ibc-testkit/src/hosts/block.rs
+++ b/ibc-testkit/src/hosts/block.rs
@@ -148,7 +148,7 @@ impl HostBlock {
                 let light_block = TestgenLightBlock::new_default_with_header(
                     TestgenHeader::new(validators)
                         .height(height)
-                        .chain_id(&chain_id.to_string())
+                        .chain_id(chain_id.as_str())
                         .next_validators(next_validators)
                         .time(timestamp.into_tm_time().expect("Never fails")),
                 )

From 6f042051bc6f21bdc243a91b7930757d2ecbbd71 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 23 Nov 2023 09:58:03 -0800
Subject: [PATCH 063/182] Release v0.48.0 (#980)

* chore: prepare for v0.48.0 release

* fix: remained from ibc restructure

* chore: further touch up

* nit: broken link

* fix: missing std features

* fix: apply reviewer comments
---
 .../unreleased/improvements/938-add-from.md   |  2 -
 .../unreleased/improvements/939-less-alloc.md |  2 -
 ...and-tendermint-client-to-separate-crate.md |  0
 .../949-bump-ibc-proto-rs-to-v0380.md         |  0
 .../breaking-changes/956-bump-MSRV-to-1-64.md |  0
 .../breaking-changes/965-restructure-ibc.md   |  0
 .../954-restructure-mock-module-into-crate.md |  0
 .../features/974-id-into-string.md            |  0
 .../697-re-export-essential-proto-types.md    |  0
 ...771-use-mod-rs-places-having-submodules.md |  0
 .../v0.48.0/improvements/938-add-from.md      |  2 +
 .../v0.48.0/improvements/939-less-alloc.md    |  2 +
 ...tifiers-without-revision-number-pattern.md |  0
 .../943-optimize-validate-prefix-length.md    |  0
 .../948-remove-redundant-test-log-deps.md     |  0
 .../improvements/951-remove-default-portid.md |  0
 .../952-expose-channel-message-types.md       |  0
 .../955-use-workspace-dependencies.md         |  0
 .../961-refactor-identifier-validation.md     |  0
 .../970-reduce-heap-allocation.md             |  0
 ...xpose-different-types-for-public-access.md |  0
 .changelog/v0.48.0/summary.md                 | 20 +++++
 CHANGELOG.md                                  | 83 +++++++++++++++++
 Cargo.toml                                    | 54 +++++------
 ci/cw-check/Cargo.lock                        | 50 +++++------
 ci/no-std-check/Cargo.lock                    | 90 +++++++++++--------
 ibc-clients/ics07-tendermint/Cargo.toml       |  3 +
 ibc-core/Cargo.toml                           |  2 +
 ibc-core/ics02-client/context/Cargo.toml      |  2 +-
 ibc-core/ics04-channel/Cargo.toml             |  3 +
 ibc-core/ics04-channel/types/Cargo.toml       |  2 +
 ibc-core/ics24-host/Cargo.toml                |  3 +
 ibc-core/ics24-host/cosmos/Cargo.toml         |  5 +-
 ibc-core/ics24-host/cosmos/src/utils.rs       |  2 +-
 ibc-core/ics25-handler/Cargo.toml             |  2 +
 ibc-core/ics25-handler/src/lib.rs             |  7 ++
 ibc-core/ics26-routing/Cargo.toml             |  2 +
 ibc-data-types/README.md                      | 22 ++---
 ibc-derive/Cargo.toml                         |  2 +-
 ibc-primitives/README.md                      |  2 +-
 ibc/src/lib.rs                                |  8 --
 41 files changed, 253 insertions(+), 119 deletions(-)
 delete mode 100644 .changelog/unreleased/improvements/938-add-from.md
 delete mode 100644 .changelog/unreleased/improvements/939-less-alloc.md
 rename .changelog/{unreleased => v0.48.0}/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md (100%)
 rename .changelog/{unreleased => v0.48.0}/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md (100%)
 rename .changelog/{unreleased => v0.48.0}/breaking-changes/956-bump-MSRV-to-1-64.md (100%)
 rename .changelog/{unreleased => v0.48.0}/breaking-changes/965-restructure-ibc.md (100%)
 rename .changelog/{unreleased => v0.48.0}/features/954-restructure-mock-module-into-crate.md (100%)
 rename .changelog/{unreleased => v0.48.0}/features/974-id-into-string.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/697-re-export-essential-proto-types.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/771-use-mod-rs-places-having-submodules.md (100%)
 create mode 100644 .changelog/v0.48.0/improvements/938-add-from.md
 create mode 100644 .changelog/v0.48.0/improvements/939-less-alloc.md
 rename .changelog/{unreleased/bug-fixes => v0.48.0/improvements}/940-chain-identifiers-without-revision-number-pattern.md (100%)
 rename .changelog/{unreleased/bug-fixes => v0.48.0/improvements}/943-optimize-validate-prefix-length.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/948-remove-redundant-test-log-deps.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/951-remove-default-portid.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/952-expose-channel-message-types.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/955-use-workspace-dependencies.md (100%)
 rename .changelog/{unreleased/breaking-changes => v0.48.0/improvements}/961-refactor-identifier-validation.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/970-reduce-heap-allocation.md (100%)
 rename .changelog/{unreleased => v0.48.0}/improvements/976-expose-different-types-for-public-access.md (100%)
 create mode 100644 .changelog/v0.48.0/summary.md

diff --git a/.changelog/unreleased/improvements/938-add-from.md b/.changelog/unreleased/improvements/938-add-from.md
deleted file mode 100644
index 439e48b6c..000000000
--- a/.changelog/unreleased/improvements/938-add-from.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- Add From implementation for ICS26 enum types to make it simpler
-  to construct the types.  ([\#938](https://github.com/cosmos/ibc-rs/pull/938))
diff --git a/.changelog/unreleased/improvements/939-less-alloc.md b/.changelog/unreleased/improvements/939-less-alloc.md
deleted file mode 100644
index b7ed133f9..000000000
--- a/.changelog/unreleased/improvements/939-less-alloc.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- Reduce vector allocations in Commitment computation. 
-  ([\#939](https://github.com/cosmos/ibc-rs/pull/939))
diff --git a/.changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md b/.changelog/v0.48.0/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
rename to .changelog/v0.48.0/breaking-changes/716-move-transfer-app-and-tendermint-client-to-separate-crate.md
diff --git a/.changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md b/.changelog/v0.48.0/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md
rename to .changelog/v0.48.0/breaking-changes/949-bump-ibc-proto-rs-to-v0380.md
diff --git a/.changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md b/.changelog/v0.48.0/breaking-changes/956-bump-MSRV-to-1-64.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/956-bump-MSRV-to-1-64.md
rename to .changelog/v0.48.0/breaking-changes/956-bump-MSRV-to-1-64.md
diff --git a/.changelog/unreleased/breaking-changes/965-restructure-ibc.md b/.changelog/v0.48.0/breaking-changes/965-restructure-ibc.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/965-restructure-ibc.md
rename to .changelog/v0.48.0/breaking-changes/965-restructure-ibc.md
diff --git a/.changelog/unreleased/features/954-restructure-mock-module-into-crate.md b/.changelog/v0.48.0/features/954-restructure-mock-module-into-crate.md
similarity index 100%
rename from .changelog/unreleased/features/954-restructure-mock-module-into-crate.md
rename to .changelog/v0.48.0/features/954-restructure-mock-module-into-crate.md
diff --git a/.changelog/unreleased/features/974-id-into-string.md b/.changelog/v0.48.0/features/974-id-into-string.md
similarity index 100%
rename from .changelog/unreleased/features/974-id-into-string.md
rename to .changelog/v0.48.0/features/974-id-into-string.md
diff --git a/.changelog/unreleased/improvements/697-re-export-essential-proto-types.md b/.changelog/v0.48.0/improvements/697-re-export-essential-proto-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/697-re-export-essential-proto-types.md
rename to .changelog/v0.48.0/improvements/697-re-export-essential-proto-types.md
diff --git a/.changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md b/.changelog/v0.48.0/improvements/771-use-mod-rs-places-having-submodules.md
similarity index 100%
rename from .changelog/unreleased/improvements/771-use-mod-rs-places-having-submodules.md
rename to .changelog/v0.48.0/improvements/771-use-mod-rs-places-having-submodules.md
diff --git a/.changelog/v0.48.0/improvements/938-add-from.md b/.changelog/v0.48.0/improvements/938-add-from.md
new file mode 100644
index 000000000..6c8b48a9c
--- /dev/null
+++ b/.changelog/v0.48.0/improvements/938-add-from.md
@@ -0,0 +1,2 @@
+- Add From implementation for ICS26 enum types to make it simpler to construct
+  the types. ([\#938](https://github.com/cosmos/ibc-rs/pull/938))
diff --git a/.changelog/v0.48.0/improvements/939-less-alloc.md b/.changelog/v0.48.0/improvements/939-less-alloc.md
new file mode 100644
index 000000000..f468106a7
--- /dev/null
+++ b/.changelog/v0.48.0/improvements/939-less-alloc.md
@@ -0,0 +1,2 @@
+- Reduce vector allocations in Commitment computation.
+  ([\#939](https://github.com/cosmos/ibc-rs/pull/939))
diff --git a/.changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md b/.changelog/v0.48.0/improvements/940-chain-identifiers-without-revision-number-pattern.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/940-chain-identifiers-without-revision-number-pattern.md
rename to .changelog/v0.48.0/improvements/940-chain-identifiers-without-revision-number-pattern.md
diff --git a/.changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md b/.changelog/v0.48.0/improvements/943-optimize-validate-prefix-length.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/943-optimize-validate-prefix-length.md
rename to .changelog/v0.48.0/improvements/943-optimize-validate-prefix-length.md
diff --git a/.changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md b/.changelog/v0.48.0/improvements/948-remove-redundant-test-log-deps.md
similarity index 100%
rename from .changelog/unreleased/improvements/948-remove-redundant-test-log-deps.md
rename to .changelog/v0.48.0/improvements/948-remove-redundant-test-log-deps.md
diff --git a/.changelog/unreleased/improvements/951-remove-default-portid.md b/.changelog/v0.48.0/improvements/951-remove-default-portid.md
similarity index 100%
rename from .changelog/unreleased/improvements/951-remove-default-portid.md
rename to .changelog/v0.48.0/improvements/951-remove-default-portid.md
diff --git a/.changelog/unreleased/improvements/952-expose-channel-message-types.md b/.changelog/v0.48.0/improvements/952-expose-channel-message-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/952-expose-channel-message-types.md
rename to .changelog/v0.48.0/improvements/952-expose-channel-message-types.md
diff --git a/.changelog/unreleased/improvements/955-use-workspace-dependencies.md b/.changelog/v0.48.0/improvements/955-use-workspace-dependencies.md
similarity index 100%
rename from .changelog/unreleased/improvements/955-use-workspace-dependencies.md
rename to .changelog/v0.48.0/improvements/955-use-workspace-dependencies.md
diff --git a/.changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md b/.changelog/v0.48.0/improvements/961-refactor-identifier-validation.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/961-refactor-identifier-validation.md
rename to .changelog/v0.48.0/improvements/961-refactor-identifier-validation.md
diff --git a/.changelog/unreleased/improvements/970-reduce-heap-allocation.md b/.changelog/v0.48.0/improvements/970-reduce-heap-allocation.md
similarity index 100%
rename from .changelog/unreleased/improvements/970-reduce-heap-allocation.md
rename to .changelog/v0.48.0/improvements/970-reduce-heap-allocation.md
diff --git a/.changelog/unreleased/improvements/976-expose-different-types-for-public-access.md b/.changelog/v0.48.0/improvements/976-expose-different-types-for-public-access.md
similarity index 100%
rename from .changelog/unreleased/improvements/976-expose-different-types-for-public-access.md
rename to .changelog/v0.48.0/improvements/976-expose-different-types-for-public-access.md
diff --git a/.changelog/v0.48.0/summary.md b/.changelog/v0.48.0/summary.md
new file mode 100644
index 000000000..86454e131
--- /dev/null
+++ b/.changelog/v0.48.0/summary.md
@@ -0,0 +1,20 @@
+In this release, we've undertaken a comprehensive overhaul of the **`ibc-rs`**
+repository, resulting in a strategic reorganization of the codebase. This
+restructuring dissects the implementation of each IBC specification,
+categorizing and situating them within relevant libraries. The primary objective
+is to elevate `ibc-rs` practicality and enhance user flexibility by providing a
+more modular and composable experience.
+
+Users now have the flexibility to choose from a spectrum of dependencies. They
+can opt to utilize the entire suite of meta-crates, such as `ibc`, `ibc-core`,
+`ibc-clients`, or `ibc-apps`. Alternatively, they can exercise fine-grained
+control by selectively importing specific crates. This can involve bringing in
+an entire implemented IBC sub-module, like the `ibc-core-client` crate, or
+importing only the associated data structures of a module, such as the
+`ibc-core-client-types` crate.
+
+Furthermore, this release introduces optimizations centered around construction
+and validation of ICS-24 host identifiers, aiming to curtail some heap
+allocations, beneficial for resource-constrained hosts.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4b78e0da0..005143b9e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,88 @@
 # CHANGELOG
 
+## v0.48.0
+
+*November 22, 2023*
+
+In this release, we've undertaken a comprehensive overhaul of the **`ibc-rs`**
+repository, resulting in a strategic reorganization of the codebase. This
+restructuring dissects the implementation of each IBC specification,
+categorizing and situating them within relevant libraries. The primary objective
+is to elevate `ibc-rs` practicality and enhance user flexibility by providing a
+more modular and composable experience.
+
+Users now have the flexibility to choose from a spectrum of dependencies. They
+can opt to utilize the entire suite of meta-crates, such as `ibc`, `ibc-core`,
+`ibc-clients`, or `ibc-apps`. Alternatively, they can exercise fine-grained
+control by selectively importing specific crates. This can involve bringing in
+an entire implemented IBC sub-module, like the `ibc-core-client` crate, or
+importing only the associated data structures of a module, such as the
+`ibc-core-client-types` crate.
+
+Furthermore, this release introduces optimizations centered around construction
+and validation of ICS-24 host identifiers, aiming to curtail some heap
+allocations, beneficial for resource-constrained hosts.
+
+There are no consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- Move ICS-20 and ICS-27 implementations to the respective part of `ibc-apps`
+  and `ibc-clients` crates, as part of the `ibc` crate restructuring effort.
+  ([\#716](https://github.com/cosmos/ibc-rs/issues/716))
+- Bump `ibc-proto-rs` to v0.38.0
+  ([\#949](https://github.com/cosmos/ibc-rs/issues/949))
+- Bump minimum supported Rust version to 1.64
+  ([\#956](https://github.com/cosmos/ibc-rs/issues/956))
+- Restructure `ibc-rs` codebase by organizing it into smaller self-contained,
+  modular libraries, enabling the selective import of specific domain types or
+  module implementations, either individually or in combination, providing
+  enhanced flexibility and ease of use.
+  ([\#965](https://github.com/cosmos/ibc-rs/issues/965))
+
+### FEATURES
+
+- Restructure the mock module implementation and separate its codebase into a
+  new crate named `ibc-testkit`
+  ([\#954](https://github.com/cosmos/ibc-rs/issues/953))
+- Provide `Into<String>` for all identifiers types.
+  ([\#974](https://github.com/cosmos/ibc-rs/pull/974))
+
+### IMPROVEMENTS
+
+- Re-export essential proto types from the underlying `ibc-*-*-types` crates,
+  removing the necessity for a direct dependency on `ibc-proto` in projects
+  integrating `ibc-rs` ([\#697](https://github.com/cosmos/ibc-rs/issues/697))
+- Rename `{submodule}.rs` with corresponding `{submodule}` directory to
+  `{submodule}/mod.rs` ([\#771](https://github.com/cosmos/ibc-rs/issues/771))
+- Add From implementation for ICS26 enum types to make it simpler to construct
+  the types. ([\#938](https://github.com/cosmos/ibc-rs/pull/938))
+- Reduce vector allocations in Commitment computation.
+  ([\#939](https://github.com/cosmos/ibc-rs/pull/939))
+- Support chain identifiers without the `{chain_name}-{revision_number}` pattern
+  of Tendermint chains. ([\#940](https://github.com/cosmos/ibc-rs/issues/940)).
+- Remove redundant `String` creation in `validate_prefix_length`
+  ([\#943](https://github.com/cosmos/ibc-rs/issues/943)).
+- Remove redundant `#[test_log::test]` attributes in test modules
+  ([\#948](https://github.com/cosmos/ibc-rs/issues/948))
+- Remove the default value and implementation for `PortId`
+  ([\#951](https://github.com/cosmos/ibc-rs/issues/951))
+- Expose domain message types under the `ics04_channel` as public
+  ([\#952](https://github.com/cosmos/ibc-rs/issues/952))
+- Enhance dependency management with workspace inheritance
+  ([\#955](https://github.com/cosmos/ibc-rs/issues/955))
+- Simplify and refactor ICS-24 identifier validation logic.
+  ([\#961](https://github.com/cosmos/ibc-rs/issues/961))
+- Reduce heap allocation by using `str` instead of `String` places we convert
+  domain event attributes to the ABCI event attributes
+  ([\#970](https://github.com/cosmos/ibc-rs/issues/970))
+- Expose various fields, types and functions in `ibc-rs` as public including:
+  - `validate` and `execute` handler functions for all the IBC message types.
+  - `TYPE_URL` constants.
+  - Any private fields within the domain message types.
+  - Any private fields within the Tendermint `ClientState` and `ConsensusState`
+  ([\#976](https://github.com/cosmos/ibc-rs/issues/976))
+
 ## v0.47.0
 
 *October 19, 2023*
diff --git a/Cargo.toml b/Cargo.toml
index b64e02926..4f3384533 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -35,7 +35,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.47.0"
+version      = "0.48.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -61,34 +61,34 @@ subtle-encoding     = { version = "0.5", default-features = false }
 time                = { version = ">=0.3.0, <0.3.31", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.47.0", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.47.0", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.47.0", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.47.0", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.47.0", path = "./ibc-primitives", default-features = false }
-ibc-testkit         = { version = "0.47.0", path = "./ibc-testkit" }
-ibc-derive          = { version = "0.3.0", path = "./ibc-derive" }
+ibc                 = { version = "0.48.0", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.48.0", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.48.0", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.48.0", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.48.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit         = { version = "0.48.0", path = "./ibc-testkit" }
+ibc-derive          = { version = "0.4.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.47.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.47.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.47.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.47.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.47.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.47.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.47.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.47.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-core-client       = { version = "0.48.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.48.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.48.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.48.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.48.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.48.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.48.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.48.0", path = "./ibc-apps/ics20-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.47.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.47.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.47.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.47.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.47.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.47.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.47.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.47.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.47.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.47.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.47.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.48.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.48.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.48.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.48.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.48.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.48.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.48.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.48.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.48.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.48.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.48.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.38.0", default-features = false }
 ics23     = { version = "0.11", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index d2c236984..0f3cc0f4f 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -613,7 +613,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -625,7 +625,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -634,7 +634,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -649,14 +649,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -672,7 +672,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "bytes",
  "displaydoc",
@@ -694,14 +694,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -715,7 +715,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -730,7 +730,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -751,7 +751,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -764,7 +764,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -781,7 +781,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -799,7 +799,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -815,7 +815,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -827,7 +827,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -846,7 +846,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -860,7 +860,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -882,7 +882,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -900,7 +900,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -925,7 +925,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -937,7 +937,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -951,7 +951,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -969,7 +969,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
  "darling",
  "proc-macro2",
@@ -979,7 +979,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index e902341ed..08ed7b9de 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1213,41 +1213,28 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
- "bytes",
- "derive_more",
- "displaydoc",
  "ibc-apps",
  "ibc-clients",
  "ibc-core",
+ "ibc-core-host-cosmos",
  "ibc-derive",
  "ibc-primitives",
- "ibc-proto",
- "prost",
- "serde",
- "serde-json-wasm",
- "sha2 0.10.8",
- "subtle-encoding",
- "tendermint",
- "tendermint-light-client-verifier",
- "tendermint-proto",
- "time",
 ]
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
  "serde-json-wasm",
- "sha2 0.10.8",
 ]
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1260,14 +1247,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -1276,12 +1263,14 @@ dependencies = [
  "ibc-core-host",
  "ibc-primitives",
  "prost",
+ "serde",
+ "tendermint",
  "tendermint-light-client-verifier",
 ]
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "bytes",
  "displaydoc",
@@ -1293,6 +1282,7 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "prost",
+ "serde",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1300,14 +1290,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1321,7 +1311,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1336,7 +1326,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1355,21 +1345,20 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
  "ibc-core-commitment-types",
  "ibc-core-handler-types",
  "ibc-core-host",
- "ibc-derive",
  "ibc-primitives",
  "prost",
 ]
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1386,7 +1375,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1402,7 +1391,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1416,7 +1405,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1428,7 +1417,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1445,7 +1434,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1459,7 +1448,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1479,7 +1468,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1495,9 +1484,32 @@ dependencies = [
  "subtle-encoding",
 ]
 
+[[package]]
+name = "ibc-core-host-cosmos"
+version = "0.48.0"
+dependencies = [
+ "derive_more",
+ "displaydoc",
+ "ibc-app-transfer-types",
+ "ibc-client-tendermint",
+ "ibc-core-client-context",
+ "ibc-core-client-types",
+ "ibc-core-commitment-types",
+ "ibc-core-connection-types",
+ "ibc-core-handler-types",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "prost",
+ "serde",
+ "sha2 0.10.8",
+ "subtle-encoding",
+ "tendermint",
+]
+
 [[package]]
 name = "ibc-core-host-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1507,7 +1519,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1521,7 +1533,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1537,7 +1549,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.3.0"
+version = "0.4.0"
 dependencies = [
  "darling",
  "proc-macro2",
@@ -1547,7 +1559,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.47.0"
+version = "0.48.0"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index f59ee647b..22a46ae28 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -37,6 +37,7 @@ tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"
 default = ["std"]
 std = [
     "prost/std",
+    "serde/std",
     "ibc-client-tendermint-types/std",
     "ibc-core-client/std",
     "ibc-core-commitment-types/std",
@@ -60,6 +61,8 @@ schema = [
     "ibc-core-host/schema",
     "ibc-core-handler-types/schema",
     "ibc-primitives/schema",
+    "serde",
+    "std"
 ]
 borsh = [
     "ibc-client-tendermint-types/borsh",
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
index f8853a76f..896c16987 100644
--- a/ibc-core/Cargo.toml
+++ b/ibc-core/Cargo.toml
@@ -63,6 +63,8 @@ schema = [
     "ibc-core-host/schema",
     "ibc-core-router/schema",
     "ibc-core-handler/schema",
+    "serde",
+    "std"
 ]
 parity-scale-codec = [
     "ibc-core-client/parity-scale-codec",
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index 06a23157b..5a5f1d467 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -7,7 +7,7 @@ rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc"]
-readme       = "./../README.md"
+readme       = "./../../README.md"
 description  = """
     Maintaind by `ibc-rs`, contains essential APIs to interface with the host chain's store, 
     enabling smooth client state transitions. Additionally, provides necessary traits for 
diff --git a/ibc-core/ics04-channel/Cargo.toml b/ibc-core/ics04-channel/Cargo.toml
index f49c7175b..ba955ef67 100644
--- a/ibc-core/ics04-channel/Cargo.toml
+++ b/ibc-core/ics04-channel/Cargo.toml
@@ -33,6 +33,7 @@ ibc-primitives            = { workspace = true }
 [features]
 default = ["std"]
 std = [
+    "prost/std",
     "ibc-core-client/std",
     "ibc-core-connection/std",
     "ibc-core-channel-types/std",
@@ -61,6 +62,8 @@ schema = [
     "ibc-core-handler-types/schema",
     "ibc-core-router/schema",
     "ibc-primitives/schema",
+    "serde",
+    "std"
 ]
 borsh = [
     "ibc-core-client/borsh",
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
index b19aa13df..ab06daea0 100644
--- a/ibc-core/ics04-channel/types/Cargo.toml
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -79,6 +79,8 @@ schema = [
     "ibc-core-commitment-types/schema",
     "ibc-primitives/schema",
     "ibc-proto/json-schema",
+    "serde",
+    "std"
 ]
 borsh = [
     "dep:borsh",
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index dc28e951f..664d3da23 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -40,6 +40,9 @@ rstest = { workspace = true }
 [features]
 default = ["std"]
 std = [
+    "displaydoc/std",
+    "prost/std",
+    "subtle-encoding/std",
     "ibc-core-client-types/std",
     "ibc-core-client-context/std",
     "ibc-core-connection-types/std",
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
index 51a9ef519..ee57aab62 100644
--- a/ibc-core/ics24-host/cosmos/Cargo.toml
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -7,7 +7,7 @@ rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "tendermint"]
-readme       = "./../README.md"
+readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, contains Cosmos-specific helper traits and implementations
     to facilitate IBC integration, ensuring proper interaction with modules/components
@@ -56,6 +56,7 @@ std = [
     "displaydoc/std",
     "prost/std",
     "serde/std",
+    "sha2/std",
     "subtle-encoding/std",
     "ibc-core-client-types/std",
     "ibc-core-client-context/std",
@@ -88,6 +89,8 @@ schema = [
     "ibc-core-handler-types/schema",
     "ibc-primitives/schema",
     "ibc-proto/json-schema",
+    "serde",
+    "std"
 ]
 borsh = [
     "dep:borsh",
diff --git a/ibc-core/ics24-host/cosmos/src/utils.rs b/ibc-core/ics24-host/cosmos/src/utils.rs
index 7ecf41975..613a48f36 100644
--- a/ibc-core/ics24-host/cosmos/src/utils.rs
+++ b/ibc-core/ics24-host/cosmos/src/utils.rs
@@ -1,6 +1,6 @@
 use ibc_app_transfer_types::VERSION;
 use ibc_core_host_types::identifiers::{ChannelId, PortId};
-pub use ibc_primitives::prelude::*;
+use ibc_primitives::prelude::*;
 use sha2::{Digest, Sha256};
 
 /// Helper function to generate an escrow address for a given port and channel
diff --git a/ibc-core/ics25-handler/Cargo.toml b/ibc-core/ics25-handler/Cargo.toml
index ea8b1aea8..1e158e402 100644
--- a/ibc-core/ics25-handler/Cargo.toml
+++ b/ibc-core/ics25-handler/Cargo.toml
@@ -64,6 +64,8 @@ schema = [
     "ibc-core-host/schema",
     "ibc-core-router/schema",
     "ibc-core-handler-types/schema",
+    "serde",
+    "std"
 ]
 parity-scale-codec = [
     "ibc-core-client/parity-scale-codec",
diff --git a/ibc-core/ics25-handler/src/lib.rs b/ibc-core/ics25-handler/src/lib.rs
index a9505d9aa..203c98c2f 100644
--- a/ibc-core/ics25-handler/src/lib.rs
+++ b/ibc-core/ics25-handler/src/lib.rs
@@ -2,6 +2,13 @@
 //! entry points are responsible for processing incoming IBC messages,
 //! performing validation, and execution logics by invoking the appropriate
 //! module handler.
+//!
+//! When processing a given message `M`, if any method in this library returns
+//! an error, the runtime is expected to rollback all state modifications made
+//! to the context (e.g. [`ExecutionContext`](ibc_core_host::ExecutionContext))
+//! while processing `M`. If the transaction containing `M` consists of multiple
+//! messages, then typically the state modifications from all messages is
+//! expected to be rolled back as well.
 #![no_std]
 #![forbid(unsafe_code)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
diff --git a/ibc-core/ics26-routing/Cargo.toml b/ibc-core/ics26-routing/Cargo.toml
index 6fedc2fc9..91e75f476 100644
--- a/ibc-core/ics26-routing/Cargo.toml
+++ b/ibc-core/ics26-routing/Cargo.toml
@@ -57,6 +57,8 @@ schema = [
     "ibc-core-host-types/schema",
     "ibc-core-router-types/schema",
     "ibc-primitives/schema",
+    "serde",
+    "std"
 ]
 parity-scale-codec = [
     "ibc-core-channel-types/parity-scale-codec",
diff --git a/ibc-data-types/README.md b/ibc-data-types/README.md
index 0beb79852..90671b8cb 100644
--- a/ibc-data-types/README.md
+++ b/ibc-data-types/README.md
@@ -19,25 +19,25 @@ providing a clear and modular path for easy navigation and usage:
 ### Core
 
 | <div style="width:300px">Specification</div> | Crate |
-| ------------------------------------------- | ------ |
-| ICS-02: Client Semantics                    | [ibc-core-client-types](./../ibc-core/ics02-client/types) |
-| ICS-03: Connection Semantics                | [ibc-core-connection-types](./../ibc-core/ics03-connection/types) |
-| ICS-04: Channel and Packet Semantics        | [ibc-core-channel-types](./../ibc-core/ics04-channel/types) |
-| ICS-24: Host Requirements                   | [ibc-core-host-types](./../ibc-core/ics24-host/types) |
-| ICS-25: Handler Interface                   | [ibc-core-handler-types](./../ibc-core/ics25-handler/types) |
-| ICS-26: Routing Module                      | [ibc-core-routing-types](./../ibc-core/ics26-routing/types) |
+| -------------------------------------------- | ------ |
+| ICS-02: Client Semantics                     | [ibc-core-client-types](./../ibc-core/ics02-client/types) |
+| ICS-03: Connection Semantics                 | [ibc-core-connection-types](./../ibc-core/ics03-connection/types) |
+| ICS-04: Channel and Packet Semantics         | [ibc-core-channel-types](./../ibc-core/ics04-channel/types) |
+| ICS-24: Host Requirements                    | [ibc-core-host-types](./../ibc-core/ics24-host/types) |
+| ICS-25: Handler Interface                    | [ibc-core-handler-types](./../ibc-core/ics25-handler/types) |
+| ICS-26: Routing Module                       | [ibc-core-routing-types](./../ibc-core/ics26-routing/types) |
 
 ### Clients
 
 | <div style="width:300px">Specification</div> | Crate |
-| ------------------------------------------- | ------ |
-| ICS-07: Tendermint Client                   | [ibc-client-tendermint-types](./../ibc-clients/ics07-tendermint/types) |
+| -------------------------------------------- | ------ |
+| ICS-07: Tendermint Client                    | [ibc-client-tendermint-types](./../ibc-clients/ics07-tendermint/types) |
 
 ### Apps
 
 | <div style="width:300px">Specification</div> | Crate |
-| ------------------------------------------- | ------ |
-| ICS-20: Fungible Token Transfer             | [ibc-app-transfer-types](./../ibc-apps/ics20-transfer/types) |
+| -------------------------------------------- | ------ |
+| ICS-20: Fungible Token Transfer              | [ibc-app-transfer-types](./../ibc-apps/ics20-transfer/types) |
 
 ## Contributing
 
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 532f6f783..8d1355c08 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name        = "ibc-derive"
-version     = "0.3.0"
+version     = "0.4.0"
 license     = { workspace = true }
 repository  = { workspace = true }
 edition     = { workspace = true }
diff --git a/ibc-primitives/README.md b/ibc-primitives/README.md
index 3b4cc4ec8..db295a8fd 100644
--- a/ibc-primitives/README.md
+++ b/ibc-primitives/README.md
@@ -1,4 +1,4 @@
-# `ibc-primitives`
+# IBC Primitives
 
 This library furnishes essential types, traits, and utilities universally utilized in the
 implementation of diverse IBC modules, encompassing core functionalities,
diff --git a/ibc/src/lib.rs b/ibc/src/lib.rs
index 1e9eaab80..02887a4e6 100644
--- a/ibc/src/lib.rs
+++ b/ibc/src/lib.rs
@@ -30,14 +30,6 @@
 //! This is the part of the protocol that abstracts away the core protocol and
 //! focuses solely on business logic.
 //!
-//! When processing a given message `M`, if any method in this library returns
-//! an error, the runtime is expected to rollback all state modifications made
-//! to the context (e.g.
-//! [`ExecutionContext`](crate::core::host::ExecutionContext)) while processing
-//! `M`. If a transaction on your blockchain contains multiple messages, then
-//! typically the state modifications from all messages is expected to be rolled
-//! back as well.
-//!
 //! [ibc-standard]: https://github.com/cosmos/ibc
 //! [ibc-rs]: https://github.com/cosmos/ibc-rs
 

From 8c1766fa823f8a2e8e83a79f39c521aa6e270a81 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 23 Nov 2023 14:31:23 -0800
Subject: [PATCH 064/182] Release v0.48.0: addendum (#982)

* fix: remove version for ibc-testkit

* chore: move ibc tests using ibc-testkit

* chore: rename utils to fixtures
---
 Cargo.toml                                    |  40 +--
 RELEASES.md                                   |   5 +-
 ci/cw-check/Cargo.lock                        |   2 -
 ci/no-std-check/Cargo.lock                    |   2 -
 ibc-apps/ics20-transfer/types/Cargo.toml      |   3 -
 ibc-apps/ics20-transfer/types/src/packet.rs   |   5 +-
 .../ics07-tendermint/src/client_state.rs      |  15 +-
 ibc-clients/ics07-tendermint/types/Cargo.toml |  10 -
 .../types/src/client_state.rs                 | 136 +--------
 ibc-core/ics02-client/context/Cargo.toml      |   3 -
 ibc-core/ics02-client/types/Cargo.toml        |   3 -
 ibc-core/ics02-client/types/src/events.rs     | 107 +------
 .../types/src/msgs/create_client.rs           |  19 --
 .../types/src/msgs/update_client.rs           |  19 --
 .../types/src/msgs/upgrade_client.rs          |  18 --
 ibc-core/ics03-connection/types/Cargo.toml    |   3 -
 .../types/src/msgs/conn_open_ack.rs           |  93 ------
 .../types/src/msgs/conn_open_confirm.rs       |  73 -----
 .../types/src/msgs/conn_open_init.rs          | 118 --------
 .../types/src/msgs/conn_open_try.rs           | 149 ----------
 ibc-core/ics04-channel/types/Cargo.toml       |   3 -
 ibc-core/ics04-channel/types/src/channel.rs   | 145 ---------
 .../types/src/msgs/acknowledgement.rs         |  76 -----
 .../types/src/msgs/chan_close_confirm.rs      | 118 --------
 .../types/src/msgs/chan_close_init.rs         | 101 -------
 .../types/src/msgs/chan_open_ack.rs           | 170 -----------
 .../types/src/msgs/chan_open_confirm.rs       | 122 --------
 .../types/src/msgs/chan_open_init.rs          |  93 ------
 .../types/src/msgs/chan_open_try.rs           | 122 --------
 .../types/src/msgs/recv_packet.rs             |  77 -----
 .../ics04-channel/types/src/msgs/timeout.rs   |  90 ------
 .../types/src/msgs/timeout_on_close.rs        |  86 ------
 ibc-core/ics04-channel/types/src/packet.rs    | 191 ------------
 ibc-core/ics24-host/cosmos/Cargo.toml         |   4 -
 ibc-core/ics25-handler/types/Cargo.toml       |   5 -
 ibc-core/ics25-handler/types/src/events.rs    |  27 --
 ibc-testkit/Cargo.toml                        |   4 +
 .../dummies => fixtures}/applications/mod.rs  |   0
 .../applications/transfer.rs                  |   2 +-
 .../dummies => fixtures}/clients/mock.rs      |   0
 .../dummies => fixtures}/clients/mod.rs       |   0
 .../clients/tendermint.rs                     |  59 +++-
 .../fixtures/core/channel/acknowledgement.rs  | 100 +++++++
 .../core/channel/chan_close_confirm.rs        | 136 +++++++++
 .../fixtures/core/channel/chan_close_init.rs  | 113 +++++++
 .../fixtures/core/channel/chan_open_ack.rs    | 190 ++++++++++++
 .../core/channel/chan_open_confirm.rs         | 140 +++++++++
 .../fixtures/core/channel/chan_open_init.rs   | 106 +++++++
 .../fixtures/core/channel/chan_open_try.rs    | 143 +++++++++
 ibc-testkit/src/fixtures/core/channel/mod.rs  | 194 ++++++++++++
 .../src/fixtures/core/channel/packet.rs       | 275 ++++++++++++++++++
 .../src/fixtures/core/channel/recv_packet.rs  | 119 ++++++++
 .../src/fixtures/core/channel/timeout.rs      | 112 +++++++
 .../fixtures/core/channel/timeout_on_close.rs | 106 +++++++
 ibc-testkit/src/fixtures/core/client/mod.rs   | 113 +++++++
 .../fixtures/core/client/msg_create_client.rs |  38 +++
 .../fixtures/core/client/msg_update_client.rs |  35 +++
 .../core/client/msg_upgrade_client.rs         |  22 +-
 .../dummies => fixtures}/core/commitment.rs   |   0
 .../fixtures/core/connection/conn_open_ack.rs | 133 +++++++++
 .../core/connection/conn_open_confirm.rs      |  93 ++++++
 .../core/connection/conn_open_init.rs         | 192 ++++++++++++
 .../fixtures/core/connection/conn_open_try.rs | 208 +++++++++++++
 .../core/connection/mod.rs                    |   0
 .../dummies => fixtures}/core/context.rs      |   0
 .../{utils/dummies => fixtures}/core/mod.rs   |   0
 .../dummies => fixtures}/core/signer.rs       |   0
 .../src/{utils/fixture.rs => fixtures/mod.rs} |   5 +-
 ibc-testkit/src/lib.rs                        |   3 +-
 ibc-testkit/src/testapp/ibc/core/types.rs     |  10 +-
 .../dummies/core/channel/acknowledgement.rs   |  26 --
 .../core/channel/chan_close_confirm.rs        |  21 --
 .../dummies/core/channel/chan_close_init.rs   |  14 -
 .../dummies/core/channel/chan_open_ack.rs     |  23 --
 .../dummies/core/channel/chan_open_confirm.rs |  21 --
 .../dummies/core/channel/chan_open_init.rs    |  15 -
 .../dummies/core/channel/chan_open_try.rs     |  24 --
 .../src/utils/dummies/core/channel/mod.rs     |  52 ----
 .../src/utils/dummies/core/channel/packet.rs  |  68 -----
 .../utils/dummies/core/channel/recv_packet.rs |  45 ---
 .../src/utils/dummies/core/channel/timeout.rs |  24 --
 .../dummies/core/channel/timeout_on_close.rs  |  21 --
 .../src/utils/dummies/core/client/mod.rs      |  11 -
 .../dummies/core/client/msg_create_client.rs  |  21 --
 .../dummies/core/client/msg_update_client.rs  |  18 --
 .../dummies/core/connection/conn_open_ack.rs  |  45 ---
 .../core/connection/conn_open_confirm.rs      |  26 --
 .../dummies/core/connection/conn_open_init.rs |  80 -----
 .../dummies/core/connection/conn_open_try.rs  |  66 -----
 ibc-testkit/src/utils/dummies/mod.rs          |   3 -
 ibc-testkit/src/utils/mod.rs                  |   5 -
 .../tests/core/ics02_client/create_client.rs  |   8 +-
 .../tests/core/ics02_client/update_client.rs  |   4 +-
 .../tests/core/ics02_client/upgrade_client.rs |  10 +-
 .../core/ics03_connection/conn_open_ack.rs    |   4 +-
 .../ics03_connection/conn_open_confirm.rs     |   4 +-
 .../core/ics03_connection/conn_open_init.rs   |   8 +-
 .../core/ics03_connection/conn_open_try.rs    |   4 +-
 .../core/ics04_channel/acknowledgement.rs     |   2 +-
 .../core/ics04_channel/chan_close_confirm.rs  |   4 +-
 .../core/ics04_channel/chan_close_init.rs     |   4 +-
 .../tests/core/ics04_channel/chan_open_ack.rs |   4 +-
 .../core/ics04_channel/chan_open_confirm.rs   |   4 +-
 .../core/ics04_channel/chan_open_init.rs      |   4 +-
 .../tests/core/ics04_channel/chan_open_try.rs |   4 +-
 .../tests/core/ics04_channel/recv_packet.rs   |   4 +-
 .../tests/core/ics04_channel/send_packet.rs   |   2 +-
 .../tests/core/ics04_channel/timeout.rs       |   2 +-
 .../core/ics04_channel/timeout_on_close.rs    |   2 +-
 ibc-testkit/tests/core/router.rs              |  22 +-
 110 files changed, 2746 insertions(+), 2887 deletions(-)
 rename ibc-testkit/src/{utils/dummies => fixtures}/applications/mod.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/applications/transfer.rs (97%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/clients/mock.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/clients/mod.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/clients/tendermint.rs (75%)
 create mode 100644 ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_open_init.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/chan_open_try.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/mod.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/packet.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/recv_packet.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/timeout.rs
 create mode 100644 ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
 create mode 100644 ibc-testkit/src/fixtures/core/client/mod.rs
 create mode 100644 ibc-testkit/src/fixtures/core/client/msg_create_client.rs
 create mode 100644 ibc-testkit/src/fixtures/core/client/msg_update_client.rs
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/client/msg_upgrade_client.rs (71%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/commitment.rs (100%)
 create mode 100644 ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
 create mode 100644 ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
 create mode 100644 ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
 create mode 100644 ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/connection/mod.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/context.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/mod.rs (100%)
 rename ibc-testkit/src/{utils/dummies => fixtures}/core/signer.rs (100%)
 rename ibc-testkit/src/{utils/fixture.rs => fixtures/mod.rs} (91%)
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/mod.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/packet.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/timeout.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/client/mod.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
 delete mode 100644 ibc-testkit/src/utils/dummies/mod.rs
 delete mode 100644 ibc-testkit/src/utils/mod.rs

diff --git a/Cargo.toml b/Cargo.toml
index 4f3384533..c4c0367ee 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,33 +1,35 @@
 [workspace]
 resolver = "2"
+# members sorted by publishing order to `crates.io`
 members = [
-    "ibc",
-    "ibc-data-types",
-    "ibc-primitives",
-    "ibc-core",
-    "ibc-clients",
-    "ibc-apps",
-    "ibc-testkit",
-    "ibc-query",
     "ibc-derive",
-    "ibc-core/ics02-client",
+    "ibc-primitives",
+    "ibc-core/ics24-host/types",
+    "ibc-core/ics26-routing/types",
+    "ibc-core/ics23-commitment/types",
     "ibc-core/ics02-client/types",
-    "ibc-core/ics03-connection",
     "ibc-core/ics03-connection/types",
-    "ibc-core/ics04-channel",
     "ibc-core/ics04-channel/types",
-    "ibc-core/ics23-commitment/types",
-    "ibc-core/ics24-host",
-    "ibc-core/ics24-host/types",
-    "ibc-core/ics24-host/cosmos",
-    "ibc-core/ics25-handler",
     "ibc-core/ics25-handler/types",
+    "ibc-core/ics02-client/context",
+    "ibc-core/ics24-host",
     "ibc-core/ics26-routing",
-    "ibc-core/ics26-routing/types",
-    "ibc-clients/ics07-tendermint",
+    "ibc-core/ics02-client",
+    "ibc-core/ics03-connection",
+    "ibc-core/ics04-channel",
+    "ibc-core/ics25-handler",
+    "ibc-core",
     "ibc-clients/ics07-tendermint/types",
-    "ibc-apps/ics20-transfer",
+    "ibc-clients/ics07-tendermint",
+    "ibc-clients",
+    "ibc-core/ics24-host/cosmos",
     "ibc-apps/ics20-transfer/types",
+    "ibc-apps/ics20-transfer",
+    "ibc-apps",
+    "ibc-data-types",
+    "ibc",
+    "ibc-query",
+    "ibc-testkit",
 ]
 exclude = [
     "ci/cw-check",
diff --git a/RELEASES.md b/RELEASES.md
index dc6a55865..9a584f679 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -1,4 +1,3 @@
-
 ## Releases
 
 Our release process is as follows:
@@ -33,8 +32,8 @@ Our release process is as follows:
    work. Fix any potential issues here and push them to the release PR.
 7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
 8. Once approved, merge the PR, and pull the `main` branch.
-9. Run `cargo publish -p <PACKAGE_NAME>` for each package separately to publish
-   the crates.
+9. Publish each package to crates.io by running `cargo publish -p <PACKAGE_NAME>`
+   in the order specified in the workspace `Cargo.toml`.
 10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
    tag message, write the version and the link to the corresponding section of
    the changelog.
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 0f3cc0f4f..a9c9685a3 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -676,10 +676,8 @@ version = "0.48.0"
 dependencies = [
  "bytes",
  "displaydoc",
- "ibc-core-client-context",
  "ibc-core-client-types",
  "ibc-core-commitment-types",
- "ibc-core-handler-types",
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 08ed7b9de..d0f8b0fee 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1274,10 +1274,8 @@ version = "0.48.0"
 dependencies = [
  "bytes",
  "displaydoc",
- "ibc-core-client-context",
  "ibc-core-client-types",
  "ibc-core-commitment-types",
- "ibc-core-handler-types",
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
diff --git a/ibc-apps/ics20-transfer/types/Cargo.toml b/ibc-apps/ics20-transfer/types/Cargo.toml
index ad7af1ee6..150ba8d63 100644
--- a/ibc-apps/ics20-transfer/types/Cargo.toml
+++ b/ibc-apps/ics20-transfer/types/Cargo.toml
@@ -36,7 +36,6 @@ parity-scale-codec = { workspace = true , optional = true }
 scale-info         = { workspace = true , optional = true }
 
 [dev-dependencies]
-ibc-testkit = { workspace = true }
 serde_json  = { workspace = true }
 rstest      = { workspace = true }
 
@@ -50,13 +49,11 @@ std = [
     "primitive-types/std",
     "ibc-core/std",
     "ibc-proto/std",
-    "ibc-testkit/std",
 ]
 serde = [
     "dep:serde", 
     "ibc-core/serde",
     "ibc-proto/serde", 
-    "ibc-testkit/serde"
 ]
 schema = [
     "dep:schemars", 
diff --git a/ibc-apps/ics20-transfer/types/src/packet.rs b/ibc-apps/ics20-transfer/types/src/packet.rs
index d9d1ace76..cc8babc23 100644
--- a/ibc-apps/ics20-transfer/types/src/packet.rs
+++ b/ibc-apps/ics20-transfer/types/src/packet.rs
@@ -63,7 +63,6 @@ impl From<PacketData> for RawPacketData {
 
 #[cfg(test)]
 mod tests {
-    use ibc_testkit::utils::core::signer::dummy_bech32_account;
     use primitive_types::U256;
 
     use super::*;
@@ -71,7 +70,9 @@ mod tests {
 
     impl PacketData {
         pub fn new_dummy() -> Self {
-            let address: Signer = dummy_bech32_account().into();
+            let address: Signer = "cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng"
+                .to_string()
+                .into();
 
             Self {
                 token: BaseCoin {
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 6f6dfdcb5..515ebf627 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -503,7 +503,7 @@ mod tests {
     use core::time::Duration;
 
     use ibc_client_tendermint_types::{
-        AllowUpdate, ClientState as ClientStateType, ClientStateParams, TrustThreshold,
+        AllowUpdate, ClientState as ClientStateType, TrustThreshold,
     };
     use ibc_core_client::types::Height;
     use ibc_core_commitment_types::specs::ProofSpecs;
@@ -511,6 +511,19 @@ mod tests {
 
     use super::*;
 
+    #[derive(Clone, Debug, PartialEq)]
+    pub struct ClientStateParams {
+        pub id: ChainId,
+        pub trust_level: TrustThreshold,
+        pub trusting_period: Duration,
+        pub unbonding_period: Duration,
+        pub max_clock_drift: Duration,
+        pub latest_height: Height,
+        pub proof_specs: ProofSpecs,
+        pub upgrade_path: Vec<String>,
+        pub allow_update: AllowUpdate,
+    }
+
     #[test]
     fn client_state_verify_height() {
         // Define a "default" set of parameters to reuse throughout these tests.
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
index 55935dad4..68ec26b55 100644
--- a/ibc-clients/ics07-tendermint/types/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -26,10 +26,8 @@ prost      = { workspace = true }
 serde      = { workspace = true, optional = true }
 
 # ibc dependencies
-ibc-core-client-context   = { workspace = true }
 ibc-core-client-types     = { workspace = true }
 ibc-core-commitment-types = { workspace = true }
-ibc-core-handler-types    = { workspace = true }
 ibc-core-host-types       = { workspace = true }
 ibc-primitives            = { workspace = true }
 ibc-proto                 = { workspace = true }
@@ -44,7 +42,6 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [dev-dependencies]
-ibc-testkit    = { workspace = true }
 serde_json     = { workspace = true }
 tendermint-rpc = { workspace = true }
 
@@ -56,10 +53,8 @@ std = [
     "prost/std",
     "serde/std",
     "serde_json/std",
-    "ibc-core-client-context/std",
     "ibc-core-client-types/std",
     "ibc-core-commitment-types/std",
-    "ibc-core-handler-types/std",
     "ibc-core-host-types/std",
     "ibc-primitives/std",
     "ibc-proto/std",
@@ -67,10 +62,8 @@ std = [
 ]
 serde = [
     "dep:serde",
-    "ibc-core-client-context/serde",
     "ibc-core-client-types/serde",
     "ibc-core-commitment-types/serde",
-    "ibc-core-handler-types/serde",
     "ibc-core-host-types/serde",
     "ibc-primitives/serde",
     "ibc-proto/serde",
@@ -78,7 +71,6 @@ serde = [
 schema = [
     "ibc-core-client-types/schema",
     "ibc-core-commitment-types/schema",
-    "ibc-core-handler-types/schema",
     "ibc-core-host-types/schema",
     "ibc-primitives/schema",
     "ibc-proto/json-schema",
@@ -89,7 +81,6 @@ borsh = [
     "dep:borsh",
     "ibc-core-client-types/borsh",
     "ibc-core-commitment-types/borsh",
-    "ibc-core-handler-types/borsh",
     "ibc-core-host-types/borsh",
     "ibc-primitives/borsh",
     "ibc-proto/borsh",
@@ -99,7 +90,6 @@ parity-scale-codec = [
     "dep:scale-info",
     "ibc-core-client-types/parity-scale-codec",
     "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
     "ibc-core-host-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
     "ibc-proto/parity-scale-codec",
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 172ffdba9..ba323a400 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -1,5 +1,4 @@
-//! Implements the core [`ClientState`](crate::core::ics02_client::client_state::ClientState) trait
-//! for the Tendermint light client.
+//! Contains the implementation of the Tendermint `ClientState` domain type.
 
 use core::cmp::max;
 use core::convert::{TryFrom, TryInto};
@@ -35,23 +34,7 @@ pub struct AllowUpdate {
     pub after_misbehaviour: bool,
 }
 
-/// Parameters needed when initializing a new `ClientState`. This type
-/// exists mainly as a convenience for providing default values in
-/// testing scenarios.
-#[derive(Clone, Debug, PartialEq)]
-pub struct ClientStateParams {
-    pub id: ChainId,
-    pub trust_level: TrustThreshold,
-    pub trusting_period: Duration,
-    pub unbonding_period: Duration,
-    pub max_clock_drift: Duration,
-    pub latest_height: Height,
-    pub proof_specs: ProofSpecs,
-    pub upgrade_path: Vec<String>,
-    pub allow_update: AllowUpdate,
-}
-
-/// Contains the core implementation of the Tendermint light client
+/// Defines data structure for Tendermint client state.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq)]
 pub struct ClientState {
@@ -439,66 +422,23 @@ pub(crate) mod serde_tests {
 
 #[cfg(test)]
 mod tests {
-    use core::str::FromStr;
     use core::time::Duration;
 
-    use ibc_core_client_types::Height;
-    use ibc_core_commitment_types::specs::ProofSpecs;
-    use ibc_proto::google::protobuf::Any;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_proto::ibc::lightclients::tendermint::v1::{ClientState as RawTmClientState, Fraction};
-    use ibc_proto::ics23::ProofSpec as Ics23ProofSpec;
-    use ibc_testkit::utils::clients::tendermint::dummy_tendermint_header;
-    use tendermint::block::Header;
+    use ibc_core_commitment_types::proto::ics23::ProofSpec as Ics23ProofSpec;
 
     use super::*;
-    use crate::client_state::{AllowUpdate, ClientState};
-    use crate::error::Error;
-
-    impl ClientState {
-        pub fn new_dummy_from_raw(frozen_height: RawHeight) -> Result<Self, Error> {
-            Self::try_from(get_dummy_raw_tm_client_state(frozen_height))
-        }
-
-        pub fn new_dummy_from_header(tm_header: Header) -> Self {
-            let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
-            Self::new(
-                chain_id.clone(),
-                Default::default(),
-                Duration::from_secs(64000),
-                Duration::from_secs(128000),
-                Duration::from_millis(3000),
-                Height::new(chain_id.revision_number(), u64::from(tm_header.height))
-                    .expect("Never fails"),
-                Default::default(),
-                Default::default(),
-                AllowUpdate {
-                    after_expiry: false,
-                    after_misbehaviour: false,
-                },
-            )
-            .expect("Never fails")
-        }
-    }
 
-    pub fn get_dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
-        #[allow(deprecated)]
-        RawTmClientState {
-            chain_id: ChainId::new("ibc-0").expect("Never fails").to_string(),
-            trust_level: Some(Fraction {
-                numerator: 1,
-                denominator: 3,
-            }),
-            trusting_period: Some(Duration::from_secs(64000).into()),
-            unbonding_period: Some(Duration::from_secs(128000).into()),
-            max_clock_drift: Some(Duration::from_millis(3000).into()),
-            latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
-            proof_specs: ProofSpecs::default().into(),
-            upgrade_path: Default::default(),
-            frozen_height: Some(frozen_height),
-            allow_update_after_expiry: false,
-            allow_update_after_misbehaviour: false,
-        }
+    #[derive(Clone, Debug, PartialEq)]
+    pub struct ClientStateParams {
+        pub id: ChainId,
+        pub trust_level: TrustThreshold,
+        pub trusting_period: Duration,
+        pub unbonding_period: Duration,
+        pub max_clock_drift: Duration,
+        pub latest_height: Height,
+        pub proof_specs: ProofSpecs,
+        pub upgrade_path: Vec<String>,
+        pub allow_update: AllowUpdate,
     }
 
     #[test]
@@ -644,7 +584,7 @@ mod tests {
         for test in tests {
             let p = test.params.clone();
 
-            let cs_result = ClientState::new(
+            let cs_result: Result<ClientState, Error> = ClientState::new(
                 p.id,
                 p.trust_level,
                 p.trusting_period,
@@ -666,50 +606,4 @@ mod tests {
             );
         }
     }
-
-    #[test]
-    fn tm_client_state_conversions_healthy() {
-        // check client state creation path from a proto type
-        let tm_client_state_from_raw = ClientState::new_dummy_from_raw(RawHeight {
-            revision_number: 0,
-            revision_height: 0,
-        });
-        assert!(tm_client_state_from_raw.is_ok());
-
-        let any_from_tm_client_state = Any::from(
-            tm_client_state_from_raw
-                .as_ref()
-                .expect("Never fails")
-                .clone(),
-        );
-        let tm_client_state_from_any = ClientState::try_from(any_from_tm_client_state);
-        assert!(tm_client_state_from_any.is_ok());
-        assert_eq!(
-            tm_client_state_from_raw.expect("Never fails"),
-            tm_client_state_from_any.expect("Never fails")
-        );
-
-        // check client state creation path from a tendermint header
-        let tm_header = dummy_tendermint_header();
-        let tm_client_state_from_header = ClientState::new_dummy_from_header(tm_header);
-        let any_from_header = Any::from(tm_client_state_from_header.clone());
-        let tm_client_state_from_any = ClientState::try_from(any_from_header);
-        assert!(tm_client_state_from_any.is_ok());
-        assert_eq!(
-            tm_client_state_from_header,
-            tm_client_state_from_any.expect("Never fails")
-        );
-    }
-
-    #[test]
-    fn tm_client_state_malformed_with_frozen_height() {
-        let tm_client_state_from_raw = ClientState::new_dummy_from_raw(RawHeight {
-            revision_number: 0,
-            revision_height: 10,
-        });
-        match tm_client_state_from_raw {
-            Err(Error::FrozenHeightNotAllowed) => {}
-            _ => panic!("Expected to fail with FrozenHeightNotAllowed error"),
-        }
-    }
 }
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index 5a5f1d467..3b19788b7 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -35,9 +35,6 @@ ibc-primitives            = { workspace = true }
 # cosmos dependencies
 tendermint = { workspace = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics02-client/types/Cargo.toml b/ibc-core/ics02-client/types/Cargo.toml
index f4cb72346..8b01bbca1 100644
--- a/ibc-core/ics02-client/types/Cargo.toml
+++ b/ibc-core/ics02-client/types/Cargo.toml
@@ -40,9 +40,6 @@ tendermint = { workspace = true }
 parity-scale-codec  = { workspace = true, optional = true }
 scale-info          = { workspace = true, optional = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics02-client/types/src/events.rs b/ibc-core/ics02-client/types/src/events.rs
index f9ae7213c..d7c7545c1 100644
--- a/ibc-core/ics02-client/types/src/events.rs
+++ b/ibc-core/ics02-client/types/src/events.rs
@@ -8,10 +8,10 @@ use tendermint::abci;
 use crate::height::Height;
 
 /// Client event types
-const CREATE_CLIENT_EVENT: &str = "create_client";
-const UPDATE_CLIENT_EVENT: &str = "update_client";
-const CLIENT_MISBEHAVIOUR_EVENT: &str = "client_misbehaviour";
-const UPGRADE_CLIENT_EVENT: &str = "upgrade_client";
+pub const CREATE_CLIENT_EVENT: &str = "create_client";
+pub const UPDATE_CLIENT_EVENT: &str = "update_client";
+pub const CLIENT_MISBEHAVIOUR_EVENT: &str = "client_misbehaviour";
+pub const UPGRADE_CLIENT_EVENT: &str = "upgrade_client";
 
 /// The content of the `key` field for the attribute containing the client identifier.
 pub const CLIENT_ID_ATTRIBUTE_KEY: &str = "client_id";
@@ -416,102 +416,3 @@ impl From<UpgradeClient> for abci::Event {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use core::str::FromStr;
-
-    use ibc_proto::google::protobuf::Any;
-    use ibc_testkit::utils::clients::mock::dummy_new_mock_header;
-    use prost::Message;
-    use tendermint::abci::Event as AbciEvent;
-
-    use super::*;
-
-    #[test]
-    fn ibc_to_abci_client_events() {
-        struct Test {
-            event_kind: &'static str,
-            event: AbciEvent,
-            expected_keys: Vec<&'static str>,
-            expected_values: Vec<&'static str>,
-        }
-
-        let client_type = ClientType::from_str("07-tendermint")
-            .expect("never fails because it's a valid client type");
-        let client_id = ClientId::new(client_type.clone(), 0).unwrap();
-        let consensus_height = Height::new(0, 5).unwrap();
-        let consensus_heights = vec![Height::new(0, 5).unwrap(), Height::new(0, 7).unwrap()];
-        let header: Any = dummy_new_mock_header(5).into();
-        let expected_keys = vec![
-            "client_id",
-            "client_type",
-            "consensus_height",
-            "consensus_heights",
-            "header",
-        ];
-
-        let expected_values = vec![
-            "07-tendermint-0",
-            "07-tendermint",
-            "0-5",
-            "0-5,0-7",
-            "0a102f6962632e6d6f636b2e48656164657212040a021005",
-        ];
-
-        let tests: Vec<Test> = vec![
-            Test {
-                event_kind: CREATE_CLIENT_EVENT,
-                event: CreateClient::new(client_id.clone(), client_type.clone(), consensus_height)
-                    .into(),
-                expected_keys: expected_keys[0..3].to_vec(),
-                expected_values: expected_values[0..3].to_vec(),
-            },
-            Test {
-                event_kind: UPDATE_CLIENT_EVENT,
-                event: UpdateClient::new(
-                    client_id.clone(),
-                    client_type.clone(),
-                    consensus_height,
-                    consensus_heights,
-                    header.encode_to_vec(),
-                )
-                .into(),
-                expected_keys: expected_keys.clone(),
-                expected_values: expected_values.clone(),
-            },
-            Test {
-                event_kind: UPGRADE_CLIENT_EVENT,
-                event: UpgradeClient::new(client_id.clone(), client_type.clone(), consensus_height)
-                    .into(),
-                expected_keys: expected_keys[0..3].to_vec(),
-                expected_values: expected_values[0..3].to_vec(),
-            },
-            Test {
-                event_kind: CLIENT_MISBEHAVIOUR_EVENT,
-                event: ClientMisbehaviour::new(client_id, client_type).into(),
-                expected_keys: expected_keys[0..2].to_vec(),
-                expected_values: expected_values[0..2].to_vec(),
-            },
-        ];
-
-        for t in tests {
-            assert_eq!(t.event.kind, t.event_kind);
-            assert_eq!(t.expected_keys.len(), t.event.attributes.len());
-            for (i, e) in t.event.attributes.iter().enumerate() {
-                assert_eq!(
-                    e.key, t.expected_keys[i],
-                    "key mismatch for {:?}",
-                    t.event_kind
-                );
-            }
-            for (i, e) in t.event.attributes.iter().enumerate() {
-                assert_eq!(
-                    e.value, t.expected_values[i],
-                    "value mismatch for {:?}",
-                    t.event_kind
-                );
-            }
-        }
-    }
-}
diff --git a/ibc-core/ics02-client/types/src/msgs/create_client.rs b/ibc-core/ics02-client/types/src/msgs/create_client.rs
index 7c3347980..f20353c91 100644
--- a/ibc-core/ics02-client/types/src/msgs/create_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/create_client.rs
@@ -70,22 +70,3 @@ impl From<MsgCreateClient> for RawMsgCreateClient {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-
-    use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
-    use ibc_testkit::utils::core::client::dummy_raw_msg_create_client;
-
-    use crate::msgs::create_client::MsgCreateClient;
-
-    #[test]
-    fn msg_create_client_serialization() {
-        let raw = dummy_raw_msg_create_client();
-        let msg = MsgCreateClient::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgCreateClient::from(msg.clone());
-        let msg_back = MsgCreateClient::try_from(raw_back.clone()).unwrap();
-        assert_eq!(msg, msg_back);
-        assert_eq!(raw, raw_back);
-    }
-}
diff --git a/ibc-core/ics02-client/types/src/msgs/update_client.rs b/ibc-core/ics02-client/types/src/msgs/update_client.rs
index 60c70cfc2..0e6a020ad 100644
--- a/ibc-core/ics02-client/types/src/msgs/update_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/update_client.rs
@@ -63,22 +63,3 @@ impl From<MsgUpdateClient> for RawMsgUpdateClient {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
-    use ibc_testkit::utils::core::client::dummy_raw_msg_update_client;
-
-    use super::*;
-    use crate::msgs::MsgUpdateClient;
-
-    #[test]
-    fn msg_update_client_serialization() {
-        let raw = dummy_raw_msg_update_client();
-        let msg = MsgUpdateClient::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgUpdateClient::from(msg.clone());
-        let msg_back = MsgUpdateClient::try_from(raw_back.clone()).unwrap();
-        assert_eq!(msg, msg_back);
-        assert_eq!(raw, raw_back);
-    }
-}
diff --git a/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
index 2175a3cb4..cf8ed7506 100644
--- a/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
@@ -95,21 +95,3 @@ impl TryFrom<RawMsgUpgradeClient> for MsgUpgradeClient {
         })
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
-    use ibc_testkit::utils::core::client::dummy_raw_msg_upgrade_client;
-
-    use crate::msgs::upgrade_client::MsgUpgradeClient;
-
-    #[test]
-    fn msg_upgrade_client_serialization() {
-        let raw = dummy_raw_msg_upgrade_client();
-        let msg = MsgUpgradeClient::try_from(raw.clone()).unwrap();
-        let raw_back: RawMsgUpgradeClient = RawMsgUpgradeClient::from(msg.clone());
-        let msg_back = MsgUpgradeClient::try_from(raw_back.clone()).unwrap();
-        assert_eq!(msg, msg_back);
-        assert_eq!(raw, raw_back);
-    }
-}
diff --git a/ibc-core/ics03-connection/types/Cargo.toml b/ibc-core/ics03-connection/types/Cargo.toml
index f34d459bb..9f1f7379b 100644
--- a/ibc-core/ics03-connection/types/Cargo.toml
+++ b/ibc-core/ics03-connection/types/Cargo.toml
@@ -41,9 +41,6 @@ tendermint = { workspace = true }
 parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
index 3ba244ed9..462648c88 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
@@ -128,96 +128,3 @@ impl From<MsgConnectionOpenAck> for RawMsgConnectionOpenAck {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
-    use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_ack;
-
-    use crate::msgs::conn_open_ack::MsgConnectionOpenAck;
-
-    #[test]
-    fn parse_connection_open_ack_msg() {
-        #[derive(Clone, Debug, PartialEq)]
-        struct Test {
-            name: String,
-            raw: RawMsgConnectionOpenAck,
-            want_pass: bool,
-        }
-
-        let default_ack_msg = dummy_raw_msg_conn_open_ack(5, 5);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_ack_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Bad connection id, non-alpha".to_string(),
-                raw: RawMsgConnectionOpenAck {
-                    connection_id: "con007".to_string(),
-                    ..default_ack_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad version, missing version".to_string(),
-                raw: RawMsgConnectionOpenAck {
-                    version: None,
-                    ..default_ack_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad proof height, height is 0".to_string(),
-                raw: RawMsgConnectionOpenAck {
-                    proof_height: Some(Height {
-                        revision_number: 1,
-                        revision_height: 0,
-                    }),
-                    ..default_ack_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad consensus height, height is 0".to_string(),
-                raw: RawMsgConnectionOpenAck {
-                    consensus_height: Some(Height {
-                        revision_number: 1,
-                        revision_height: 0,
-                    }),
-                    ..default_ack_msg
-                },
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let msg = MsgConnectionOpenAck::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgConnOpenAck::new failed for test {}, \nmsg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_conn_open_ack(5, 6);
-        let msg = MsgConnectionOpenAck::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgConnectionOpenAck::from(msg.clone());
-        let msg_back = MsgConnectionOpenAck::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
index 545805c37..631a31b18 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
@@ -70,76 +70,3 @@ impl From<MsgConnectionOpenConfirm> for RawMsgConnectionOpenConfirm {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
-    use ibc_testkit::utils::core::connection::dummy_raw_msg_conn_open_confirm;
-
-    use crate::msgs::conn_open_confirm::MsgConnectionOpenConfirm;
-
-    #[test]
-    fn parse_connection_open_confirm_msg() {
-        #[derive(Clone, Debug, PartialEq)]
-        struct Test {
-            name: String,
-            raw: RawMsgConnectionOpenConfirm,
-            want_pass: bool,
-        }
-
-        let default_ack_msg = dummy_raw_msg_conn_open_confirm();
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_ack_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Bad connection id, non-alpha".to_string(),
-                raw: RawMsgConnectionOpenConfirm {
-                    connection_id: "con007".to_string(),
-                    ..default_ack_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad proof height, height is 0".to_string(),
-                raw: RawMsgConnectionOpenConfirm {
-                    proof_height: Some(Height {
-                        revision_number: 1,
-                        revision_height: 0,
-                    }),
-                    ..default_ack_msg
-                },
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let msg = MsgConnectionOpenConfirm::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgConnOpenTry::new failed for test {}, \nmsg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_conn_open_confirm();
-        let msg = MsgConnectionOpenConfirm::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgConnectionOpenConfirm::from(msg.clone());
-        let msg_back = MsgConnectionOpenConfirm::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
index 1638fc8ae..8a1bbee57 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
@@ -126,121 +126,3 @@ impl From<MsgConnectionOpenInit> for RawMsgConnectionOpenInit {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::connection::v1::{
-        Counterparty as RawCounterparty, MsgConnectionOpenInit as RawMsgConnectionOpenInit,
-    };
-    use ibc_testkit::utils::core::connection::{
-        dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_init,
-    };
-
-    use super::MsgConnectionOpenInit;
-
-    #[test]
-    fn parse_connection_open_init_msg() {
-        #[derive(Clone, Debug, PartialEq)]
-        struct Test {
-            name: String,
-            raw: RawMsgConnectionOpenInit,
-            want_pass: bool,
-        }
-
-        let default_init_msg = dummy_raw_msg_conn_open_init();
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_init_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Bad client id, name too short".to_string(),
-                raw: RawMsgConnectionOpenInit {
-                    client_id: "client".to_string(),
-                    ..default_init_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad destination connection id, name too long".to_string(),
-                raw: RawMsgConnectionOpenInit {
-                    counterparty: Some(RawCounterparty {
-                        connection_id:
-                            "abcdefghijksdffjssdkflweldflsfladfsfwjkrekcmmsdfsdfjflddmnopqrstu"
-                                .to_string(),
-                        ..dummy_raw_counterparty_conn(None)
-                    }),
-                    ..default_init_msg
-                },
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let msg = MsgConnectionOpenInit::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgConnOpenInit::new failed for test {}, \nmsg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_conn_open_init();
-        let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgConnectionOpenInit::from(msg.clone());
-        let msg_back = MsgConnectionOpenInit::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-
-        // Check if handler sets counterparty connection id to `None`
-        // in case relayer passes `MsgConnectionOpenInit` message with it set to `Some(_)`.
-        let raw_with_counterparty_conn_id_some = dummy_raw_msg_conn_open_init();
-        let msg_with_counterparty_conn_id_some =
-            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some).unwrap();
-        let raw_with_counterparty_conn_id_some_back =
-            RawMsgConnectionOpenInit::from(msg_with_counterparty_conn_id_some.clone());
-        let msg_with_counterparty_conn_id_some_back =
-            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some_back.clone())
-                .unwrap();
-        assert_eq!(
-            raw_with_counterparty_conn_id_some_back
-                .counterparty
-                .unwrap()
-                .connection_id,
-            "".to_string()
-        );
-        assert_eq!(
-            msg_with_counterparty_conn_id_some,
-            msg_with_counterparty_conn_id_some_back
-        );
-    }
-
-    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
-    #[cfg(feature = "borsh")]
-    #[test]
-    fn test_borsh() {
-        let mut raw = dummy_raw_msg_conn_open_init();
-        raw.delay_period = u64::MAX;
-        let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
-
-        let serialized = borsh::to_vec(&msg).unwrap();
-
-        let msg_deserialized =
-            <MsgConnectionOpenInit as borsh::BorshDeserialize>::try_from_slice(&serialized)
-                .unwrap();
-
-        assert_eq!(msg, msg_deserialized);
-    }
-}
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
index 4999f54c4..776a46f36 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
@@ -240,152 +240,3 @@ impl From<MsgConnectionOpenTry> for RawMsgConnectionOpenTry {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_proto::ibc::core::connection::v1::{
-        Counterparty as RawCounterparty, MsgConnectionOpenTry as RawMsgConnectionOpenTry,
-    };
-    use ibc_testkit::utils::core::connection::{
-        dummy_raw_counterparty_conn, dummy_raw_msg_conn_open_try,
-    };
-
-    use crate::msgs::conn_open_try::MsgConnectionOpenTry;
-
-    #[test]
-    fn parse_connection_open_try_msg() {
-        #[derive(Clone, Debug, PartialEq)]
-        struct Test {
-            name: String,
-            raw: RawMsgConnectionOpenTry,
-            want_pass: bool,
-        }
-
-        let default_try_msg = dummy_raw_msg_conn_open_try(10, 34);
-
-        let tests: Vec<Test> =
-            vec![
-                Test {
-                    name: "Good parameters".to_string(),
-                    raw: default_try_msg.clone(),
-                    want_pass: true,
-                },
-                Test {
-                    name: "Bad client id, name too short".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        client_id: "client".to_string(),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Bad destination connection id, name too long".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        counterparty: Some(RawCounterparty {
-                            connection_id:
-                            "abcdasdfasdfsdfasfdwefwfsdfsfsfasfwewvxcvdvwgadvaadsefghijklmnopqrstu"
-                                .to_string(),
-                            ..dummy_raw_counterparty_conn(Some(0))
-                        }),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Correct destination client id with lower/upper case and special chars"
-                        .to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        counterparty: Some(RawCounterparty {
-                            client_id: "ClientId_".to_string(),
-                            ..dummy_raw_counterparty_conn(Some(0))
-                        }),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: true,
-                },
-                Test {
-                    name: "Bad counterparty versions, empty versions vec".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        counterparty_versions: Vec::new(),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Bad counterparty versions, empty version string".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        counterparty_versions: Vec::new(),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Bad proof height, height is 0".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        proof_height: Some(Height { revision_number: 1, revision_height: 0 }),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Bad consensus height, height is 0".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        proof_height: Some(Height { revision_number: 1, revision_height: 0 }),
-                        ..default_try_msg.clone()
-                    },
-                    want_pass: false,
-                },
-                Test {
-                    name: "Empty proof".to_string(),
-                    raw: RawMsgConnectionOpenTry {
-                        proof_init: b"".to_vec(),
-                        ..default_try_msg
-                    },
-                    want_pass: false,
-                }
-            ]
-            .into_iter()
-            .collect();
-
-        for test in tests {
-            let msg = MsgConnectionOpenTry::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgConnOpenTry::new failed for test {}, \nmsg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_conn_open_try(10, 34);
-        let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgConnectionOpenTry::from(msg.clone());
-        let msg_back = MsgConnectionOpenTry::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-
-    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
-    #[cfg(feature = "borsh")]
-    #[test]
-    fn test_borsh() {
-        let mut raw = dummy_raw_msg_conn_open_try(10, 34);
-        raw.delay_period = u64::MAX;
-        let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
-
-        let serialized = borsh::to_vec(&msg).unwrap();
-
-        let msg_deserialized =
-            <MsgConnectionOpenTry as borsh::BorshDeserialize>::try_from_slice(&serialized).unwrap();
-
-        assert_eq!(msg, msg_deserialized);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
index ab06daea0..bbd34da60 100644
--- a/ibc-core/ics04-channel/types/Cargo.toml
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -43,9 +43,6 @@ tendermint = { workspace = true }
 parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index eed651870..aa0f3b633 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -565,148 +565,3 @@ impl Display for State {
         write!(f, "{}", self.as_string())
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use core::str::FromStr;
-
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::Channel as RawChannel;
-    use ibc_testkit::utils::core::channel::dummy_raw_channel_end;
-
-    use crate::channel::ChannelEnd;
-
-    #[test]
-    fn channel_end_try_from_raw() {
-        let raw_channel_end = dummy_raw_channel_end(2, Some(0));
-
-        let empty_raw_channel_end = RawChannel {
-            counterparty: None,
-            ..raw_channel_end.clone()
-        };
-
-        struct Test {
-            name: String,
-            params: RawChannel,
-            want_pass: bool,
-        }
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Raw channel end with missing counterparty".to_string(),
-                params: empty_raw_channel_end,
-                want_pass: false,
-            },
-            Test {
-                name: "Raw channel end with incorrect state".to_string(),
-                params: RawChannel {
-                    state: -1,
-                    ..raw_channel_end.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Raw channel end with incorrect ordering".to_string(),
-                params: RawChannel {
-                    ordering: -1,
-                    ..raw_channel_end.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Raw channel end with incorrect connection id in connection hops".to_string(),
-                params: RawChannel {
-                    connection_hops: vec!["connection*".to_string()].into_iter().collect(),
-                    ..raw_channel_end.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Raw channel end with incorrect connection id (has blank space)".to_string(),
-                params: RawChannel {
-                    connection_hops: vec!["con nection".to_string()].into_iter().collect(),
-                    ..raw_channel_end.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Raw channel end with two correct connection ids in connection hops"
-                    .to_string(),
-                params: RawChannel {
-                    connection_hops: vec!["connection-1".to_string(), "connection-2".to_string()]
-                        .into_iter()
-                        .collect(),
-                    ..raw_channel_end.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Raw channel end with correct params".to_string(),
-                params: raw_channel_end,
-                want_pass: true,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let p = test.params.clone();
-
-            let ce_result = ChannelEnd::try_from(p);
-
-            assert_eq!(
-                test.want_pass,
-                ce_result.is_ok(),
-                "ChannelEnd::try_from() failed for test {}, \nmsg{:?} with error {:?}",
-                test.name,
-                test.params.clone(),
-                ce_result.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn parse_channel_ordering_type() {
-        use super::Order;
-
-        struct Test {
-            ordering: &'static str,
-            want_res: Order,
-            want_err: bool,
-        }
-        let tests: Vec<Test> = vec![
-            Test {
-                ordering: "UNINITIALIZED",
-                want_res: Order::None,
-                want_err: false,
-            },
-            Test {
-                ordering: "UNORDERED",
-                want_res: Order::Unordered,
-                want_err: false,
-            },
-            Test {
-                ordering: "ORDERED",
-                want_res: Order::Ordered,
-                want_err: false,
-            },
-            Test {
-                ordering: "UNKNOWN_ORDER",
-                want_res: Order::None,
-                want_err: true,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            match Order::from_str(test.ordering) {
-                Ok(res) => {
-                    assert!(!test.want_err);
-                    assert_eq!(test.want_res, res);
-                }
-                Err(_) => assert!(test.want_err, "parse failed"),
-            }
-        }
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
index 0b5be9ea8..50cba957e 100644
--- a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
@@ -74,79 +74,3 @@ impl From<MsgAcknowledgement> for RawMsgAcknowledgement {
         }
     }
 }
-
-#[cfg(test)]
-mod test {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
-    use ibc_testkit::utils::core::signer::dummy_bech32_account;
-
-    use crate::error::PacketError;
-    use crate::msgs::acknowledgement::MsgAcknowledgement;
-
-    #[test]
-    fn msg_acknowledgment_try_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawMsgAcknowledgement,
-            want_pass: bool,
-        }
-
-        let height = 50;
-        let default_raw_msg = dummy_raw_msg_acknowledgement(height);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Missing packet".to_string(),
-                raw: RawMsgAcknowledgement {
-                    packet: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgAcknowledgement {
-                    proof_height: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Empty signer".to_string(),
-                raw: RawMsgAcknowledgement {
-                    signer: dummy_bech32_account(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Empty proof acked".to_string(),
-                raw: RawMsgAcknowledgement {
-                    proof_acked: Vec::new(),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ];
-
-        for test in tests {
-            let res_msg: Result<MsgAcknowledgement, PacketError> = test.raw.clone().try_into();
-
-            assert_eq!(
-                res_msg.is_ok(),
-                test.want_pass,
-                "MsgAcknowledgement::try_from failed for test {} \nraw message: {:?} with error: {:?}",
-                test.name,
-                test.raw,
-                res_msg.err()
-            );
-        }
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
index 8c028cf11..f69ddf472 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
@@ -70,121 +70,3 @@ impl From<MsgChannelCloseConfirm> for RawMsgChannelCloseConfirm {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_confirm;
-
-    use crate::msgs::chan_close_confirm::MsgChannelCloseConfirm;
-
-    #[test]
-    fn parse_channel_close_confirm_msg() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelCloseConfirm,
-            want_pass: bool,
-        }
-
-        let proof_height = 10;
-        let default_raw_msg = dummy_raw_msg_chan_close_confirm(proof_height);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Correct port".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    port_id: "p34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad port, name too short".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    port_id: "p".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad port, name too long".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    port_id:
-                        "abcdefghijklmnsdfasdfasdfasdfasdgafgadsfasdfasdfasdasfdasdfsadfopqrstuabcdefghijklmnsdfasdfasdfasdfasdgafgadsfasdfasdfasdasfdasdfsadfopqrstu"
-                            .to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Correct channel identifier".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    channel_id: "channel-34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad channel, name too short".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    channel_id: "chshort".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad channel, name too long".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    channel_id:
-                        "channel-128391283791827398127398791283912837918273981273987912839"
-                            .to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad proof height, height = 0".to_string(),
-                raw: RawMsgChannelCloseConfirm {
-                    proof_height: Some(Height {
-                        revision_number: 0,
-                        revision_height: 0,
-                    }),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let msg = MsgChannelCloseConfirm::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgChanCloseConfirm::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_chan_close_confirm(19);
-        let msg = MsgChannelCloseConfirm::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelCloseConfirm::from(msg.clone());
-        let msg_back = MsgChannelCloseConfirm::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
index dafc18dcb..c92cd5992 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
@@ -55,104 +55,3 @@ impl From<MsgChannelCloseInit> for RawMsgChannelCloseInit {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_init;
-
-    use crate::msgs::chan_close_init::MsgChannelCloseInit;
-
-    #[test]
-    fn parse_channel_close_init_msg() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelCloseInit,
-            want_pass: bool,
-        }
-
-        let default_raw_msg = dummy_raw_msg_chan_close_init();
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Correct port".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    port_id: "p34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad port, name too short".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    port_id: "p".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad port, name too long".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    port_id: "abcdefsdfasdfasdfasdfasdfasdfadsfasdgafsgadfasdfasdfasdfsdfasdfaghijklmnopqrstuabcdefsdfasdfasdfasdfasdfasdfadsfasdgafsgadfasdfasdfasdfsdfasdfaghijklmnopqrstu".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Correct channel identifier".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    channel_id: "channel-34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad channel, name too short".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    channel_id: "chshort".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad channel, name too long".to_string(),
-                raw: RawMsgChannelCloseInit {
-                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ]
-            .into_iter()
-            .collect();
-
-        for test in tests {
-            let msg = MsgChannelCloseInit::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                msg.is_ok(),
-                "MsgChanCloseInit::try_from failed for test {}, \nmsg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_chan_close_init();
-        let msg = MsgChannelCloseInit::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelCloseInit::from(msg.clone());
-        let msg_back = MsgChannelCloseInit::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
index c2f962d64..5ef4c5694 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
@@ -75,173 +75,3 @@ impl From<MsgChannelOpenAck> for RawMsgChannelOpenAck {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_ack;
-
-    use crate::msgs::chan_open_ack::MsgChannelOpenAck;
-
-    #[test]
-    fn parse_channel_open_ack_msg() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelOpenAck,
-            want_pass: bool,
-        }
-
-        let proof_height = 20;
-        let default_raw_msg = dummy_raw_msg_chan_open_ack(proof_height);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Correct port identifier".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    port_id: "p34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad port, name too short".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    port_id: "p".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad port, name too long".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    port_id: "abcdezdfDfsdfgfddsfsfdsdfdfvxcvzxcvsgdfsdfwefwvsdfdsfdasgagadgsadgsdffghijklmnopqrstuabcdezdfDfsdfgfddsfsfdsdfdfvxcvzxcvsgdfsdfwefwvsdfdsfdasgagadgsadgsdffghijklmnopqrstu".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Correct channel identifier".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    channel_id: "channel-34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad channel, name too short".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    channel_id: "chshort".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad channel, name too long".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "[Counterparty] Correct channel identifier".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    counterparty_channel_id: "channel-34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "[Counterparty] Bad channel, name too short".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    counterparty_channel_id: "chshort".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "[Counterparty] Bad channel, name too long".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    counterparty_channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Empty counterparty version (allowed)".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    counterparty_version: " ".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Arbitrary counterparty version (allowed)".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    counterparty_version: "v1.1.23-alpha".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad proof height, height = 0".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    proof_height: Some(Height {
-                        revision_number: 0,
-                        revision_height: 0,
-                    }),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    proof_height: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof try (object proof)".to_string(),
-                raw: RawMsgChannelOpenAck {
-                    proof_try: Vec::new(),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ]
-            .into_iter()
-            .collect();
-
-        for test in tests {
-            let res_msg = MsgChannelOpenAck::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "MsgChanOpenAck::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_chan_open_ack(100);
-        let msg = MsgChannelOpenAck::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelOpenAck::from(msg.clone());
-        let msg_back = MsgChannelOpenAck::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
index 8ff31e03a..cffc523b8 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
@@ -70,125 +70,3 @@ impl From<MsgChannelOpenConfirm> for RawMsgChannelOpenConfirm {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_confirm;
-
-    use crate::msgs::chan_open_confirm::MsgChannelOpenConfirm;
-
-    #[test]
-    fn parse_channel_open_confirm_msg() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelOpenConfirm,
-            want_pass: bool,
-        }
-
-        let proof_height = 78;
-        let default_raw_msg = dummy_raw_msg_chan_open_confirm(proof_height);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Correct port".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    port_id: "p34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad port, name too short".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    port_id: "p".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad port, name too long".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    port_id: "abcdesdfasdsdffasdfasdfasfasdgasdfgasdfasdfasdfasdfasdfasdffghijklmnopqrstuabcdesdfasdsdffasdfasdfasfasdgasdfgasdfasdfasdfasdfasdfasdffghijklmnopqrstu".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Correct channel identifier".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    channel_id: "channel-34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad channel, name too short".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    channel_id: "chshort".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad channel, name too long".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad proof height, height = 0".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    proof_height: Some(Height {
-                        revision_number: 0,
-                        revision_height: 0,
-                    }),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing object proof".to_string(),
-                raw: RawMsgChannelOpenConfirm {
-                    proof_ack: Vec::new(),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ]
-            .into_iter()
-            .collect();
-
-        for test in tests {
-            let res_msg = MsgChannelOpenConfirm::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "MsgChanOpenConfirm::try_from failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_chan_open_confirm(19);
-        let msg = MsgChannelOpenConfirm::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelOpenConfirm::from(msg.clone());
-        let msg_back = MsgChannelOpenConfirm::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
index 2a11c07b9..aa5175eae 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
@@ -87,96 +87,3 @@ impl From<MsgChannelOpenInit> for RawMsgChannelOpenInit {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
-
-    use crate::msgs::chan_open_init::MsgChannelOpenInit;
-
-    #[test]
-    fn channel_open_init_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelOpenInit,
-            want_pass: bool,
-        }
-
-        let default_raw_init_msg = dummy_raw_msg_chan_open_init(None);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_init_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Incorrect port identifier, slash (separator) prohibited".to_string(),
-                raw: RawMsgChannelOpenInit {
-                    port_id: "p34/".to_string(),
-                    ..default_raw_init_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing channel".to_string(),
-                raw: RawMsgChannelOpenInit {
-                    channel: None,
-                    ..default_raw_init_msg
-                },
-                want_pass: false,
-            },
-        ]
-        .into_iter()
-        .collect();
-
-        for test in tests {
-            let res_msg = MsgChannelOpenInit::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "MsgChanOpenInit::try_from failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        // Check if raw and domain types are equal after conversions
-        let raw = dummy_raw_msg_chan_open_init(None);
-        let msg = MsgChannelOpenInit::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelOpenInit::from(msg.clone());
-        let msg_back = MsgChannelOpenInit::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-
-        // Check if handler sets counterparty channel id to `None`
-        // in case relayer passes `MsgChannelOpenInit` message with it set to `Some(_)`
-        let raw_with_counterparty_chan_id_some = dummy_raw_msg_chan_open_init(None);
-        let msg_with_counterparty_chan_id_some =
-            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some).unwrap();
-        let raw_with_counterparty_chan_id_some_back =
-            RawMsgChannelOpenInit::from(msg_with_counterparty_chan_id_some.clone());
-        let msg_with_counterparty_chan_id_some_back =
-            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some_back.clone()).unwrap();
-        assert_eq!(
-            raw_with_counterparty_chan_id_some_back
-                .channel
-                .unwrap()
-                .counterparty
-                .unwrap()
-                .channel_id,
-            "".to_string()
-        );
-        assert_eq!(
-            msg_with_counterparty_chan_id_some,
-            msg_with_counterparty_chan_id_some_back
-        );
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
index a671a5352..cb554ee00 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
@@ -124,125 +124,3 @@ impl From<MsgChannelOpenTry> for RawMsgChannelOpenTry {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-    use ibc_proto::ibc::core::client::v1::Height;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_try;
-
-    use crate::msgs::chan_open_try::MsgChannelOpenTry;
-
-    #[test]
-    fn channel_open_try_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawMsgChannelOpenTry,
-            want_pass: bool,
-        }
-
-        let proof_height = 10;
-        let default_raw_msg = dummy_raw_msg_chan_open_try(proof_height);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Correct port".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    port_id: "p34".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad port, name too short".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    port_id: "p".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad port, name too long".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    port_id: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfaabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfa".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Empty counterparty version (valid choice)".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    counterparty_version: " ".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Arbitrary counterparty version (valid choice)".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    counterparty_version: "anyversion".to_string(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad proof height, height = 0".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    proof_height: Some(Height {
-                        revision_number: 0,
-                        revision_height: 0,
-                    }),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    proof_height: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof init (object proof)".to_string(),
-                raw: RawMsgChannelOpenTry {
-                    proof_init: Vec::new(),
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ]
-            .into_iter()
-            .collect();
-
-        for test in tests {
-            let res_msg = MsgChannelOpenTry::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "MsgChanOpenTry::try_from failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_chan_open_try(10);
-        let msg = MsgChannelOpenTry::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgChannelOpenTry::from(msg.clone());
-        let msg_back = MsgChannelOpenTry::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
index da5367036..cf4bc4d77 100644
--- a/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
@@ -72,80 +72,3 @@ impl From<MsgRecvPacket> for RawMsgRecvPacket {
         }
     }
 }
-
-#[cfg(test)]
-mod test {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_recv_packet;
-    use ibc_testkit::utils::core::signer::dummy_bech32_account;
-
-    use crate::error::PacketError;
-    use crate::msgs::recv_packet::MsgRecvPacket;
-
-    #[test]
-    fn msg_recv_packet_try_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawMsgRecvPacket,
-            want_pass: bool,
-        }
-
-        let height = 20;
-        let default_raw_msg = dummy_raw_msg_recv_packet(height);
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Missing proof".to_string(),
-                raw: RawMsgRecvPacket {
-                    proof_commitment: Vec::new(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgRecvPacket {
-                    proof_height: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Empty signer".to_string(),
-                raw: RawMsgRecvPacket {
-                    signer: dummy_bech32_account(),
-                    ..default_raw_msg
-                },
-                want_pass: true,
-            },
-        ];
-
-        for test in tests {
-            let res_msg: Result<MsgRecvPacket, PacketError> = test.raw.clone().try_into();
-
-            assert_eq!(
-                res_msg.is_ok(),
-                test.want_pass,
-                "MsgRecvPacket::try_from failed for test {} \nraw message: {:?} with error: {:?}",
-                test.name,
-                test.raw,
-                res_msg.err()
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_msg_recv_packet(15);
-        let msg = MsgRecvPacket::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgRecvPacket::from(msg.clone());
-        let msg_back = MsgRecvPacket::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/timeout.rs b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
index 3ae4ba4ce..0404015ab 100644
--- a/ibc-core/ics04-channel/types/src/msgs/timeout.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
@@ -76,93 +76,3 @@ impl From<MsgTimeout> for RawMsgTimeout {
         }
     }
 }
-
-#[cfg(test)]
-mod test {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
-    use ibc_testkit::utils::core::signer::dummy_bech32_account;
-
-    use crate::error::PacketError;
-    use crate::msgs::timeout::MsgTimeout;
-
-    #[test]
-    fn msg_timeout_try_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawMsgTimeout,
-            want_pass: bool,
-        }
-
-        let proof_height = 50;
-        let timeout_height = proof_height;
-        let timeout_timestamp = 0;
-        let default_raw_msg =
-            dummy_raw_msg_timeout(proof_height, timeout_height, timeout_timestamp);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Missing packet".to_string(),
-                raw: RawMsgTimeout {
-                    packet: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof".to_string(),
-                raw: RawMsgTimeout {
-                    proof_unreceived: Vec::new(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgTimeout {
-                    proof_height: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Empty signer".to_string(),
-                raw: RawMsgTimeout {
-                    signer: dummy_bech32_account(),
-                    ..default_raw_msg
-                },
-                want_pass: true,
-            },
-        ];
-
-        for test in tests {
-            let res_msg: Result<MsgTimeout, PacketError> = test.raw.clone().try_into();
-
-            assert_eq!(
-                res_msg.is_ok(),
-                test.want_pass,
-                "MsgTimeout::try_from failed for test {} \nraw message: {:?} with error: {:?}",
-                test.name,
-                test.raw,
-                res_msg.err()
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let dummy_raw_msg_timeout = dummy_raw_msg_timeout(15, 20, 0);
-        let raw = dummy_raw_msg_timeout;
-        let msg = MsgTimeout::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgTimeout::from(msg.clone());
-        let msg_back = MsgTimeout::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
index e05cf240d..4b85a87a9 100644
--- a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
@@ -82,89 +82,3 @@ impl From<MsgTimeoutOnClose> for RawMsgTimeoutOnClose {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
-    use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
-
-    use crate::msgs::timeout_on_close::MsgTimeoutOnClose;
-
-    #[test]
-    fn msg_timeout_on_close_try_from_raw() {
-        let height = 50;
-        let timeout_timestamp = 5;
-        let raw = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
-
-        let msg = MsgTimeoutOnClose::try_from(raw.clone()).unwrap();
-        let raw_back = RawMsgTimeoutOnClose::from(msg);
-        assert_eq!(raw, raw_back);
-    }
-
-    #[test]
-    fn parse_timeout_on_close_msg() {
-        struct Test {
-            name: String,
-            raw: RawMsgTimeoutOnClose,
-            want_pass: bool,
-        }
-
-        let height = 50;
-        let timeout_timestamp = 5;
-        let default_raw_msg = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_msg.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Missing packet".to_string(),
-                raw: RawMsgTimeoutOnClose {
-                    packet: None,
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof of unreceived packet".to_string(),
-                raw: RawMsgTimeoutOnClose {
-                    proof_unreceived: Vec::new(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof of channel".to_string(),
-                raw: RawMsgTimeoutOnClose {
-                    proof_close: Vec::new(),
-                    ..default_raw_msg.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Missing proof height".to_string(),
-                raw: RawMsgTimeoutOnClose {
-                    proof_height: None,
-                    ..default_raw_msg
-                },
-                want_pass: false,
-            },
-        ];
-
-        for test in tests {
-            let res_msg = MsgTimeoutOnClose::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "MsgTimeoutOnClose::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-}
diff --git a/ibc-core/ics04-channel/types/src/packet.rs b/ibc-core/ics04-channel/types/src/packet.rs
index 8c09af4c9..0017e0518 100644
--- a/ibc-core/ics04-channel/types/src/packet.rs
+++ b/ibc-core/ics04-channel/types/src/packet.rs
@@ -309,194 +309,3 @@ impl From<PacketState> for RawPacketState {
         }
     }
 }
-
-#[cfg(test)]
-mod tests {
-    use ibc_primitives::prelude::*;
-    use ibc_proto::ibc::core::channel::v1::Packet as RawPacket;
-    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
-    use ibc_testkit::utils::core::channel::dummy_raw_packet;
-
-    use crate::packet::Packet;
-
-    #[test]
-    fn packet_try_from_raw() {
-        struct Test {
-            name: String,
-            raw: RawPacket,
-            want_pass: bool,
-        }
-
-        let proof_height = 10;
-        let default_raw_packet = dummy_raw_packet(proof_height, 1000);
-        let raw_packet_no_timeout_or_timestamp = dummy_raw_packet(10, 0);
-
-        let mut raw_packet_invalid_timeout_height = dummy_raw_packet(0, 10);
-        raw_packet_invalid_timeout_height.timeout_height = Some(RawHeight {
-            revision_number: 1,
-            revision_height: 0,
-        });
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Good parameters".to_string(),
-                raw: default_raw_packet.clone(),
-                want_pass: true,
-            },
-            Test {
-                // Note: ibc-go currently (July 2022) incorrectly rejects this
-                // case, even though it is allowed in ICS-4.
-                name: "Packet with no timeout of timestamp".to_string(),
-                raw: raw_packet_no_timeout_or_timestamp.clone(),
-                want_pass: true,
-            },
-            Test {
-                name: "Packet with invalid timeout height".to_string(),
-                raw: raw_packet_invalid_timeout_height,
-                want_pass: false,
-            },
-            Test {
-                name: "Src port validation: correct".to_string(),
-                raw: RawPacket {
-                    source_port: "srcportp34".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad src port, name too short".to_string(),
-                raw: RawPacket {
-                    source_port: "p".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad src port, name too long".to_string(),
-                raw: RawPacket {
-                    source_port: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstuabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstu".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Dst port validation: correct".to_string(),
-                raw: RawPacket {
-                    destination_port: "destportsrcp34".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad dst port, name too short".to_string(),
-                raw: RawPacket {
-                    destination_port: "p".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad dst port, name too long".to_string(),
-                raw: RawPacket {
-                    destination_port: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstuabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfas".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Src channel validation: correct".to_string(),
-                raw: RawPacket {
-                    source_channel: "channel-1".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad src channel, name too short".to_string(),
-                raw: RawPacket {
-                    source_channel: "p".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad src channel, name too long".to_string(),
-                raw: RawPacket {
-                    source_channel: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Dst channel validation: correct".to_string(),
-                raw: RawPacket {
-                    destination_channel: "channel-34".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Bad dst channel, name too short".to_string(),
-                raw: RawPacket {
-                    destination_channel: "p".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Bad dst channel, name too long".to_string(),
-                raw: RawPacket {
-                    destination_channel: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
-                    ..default_raw_packet.clone()
-                },
-                want_pass: false,
-            },
-            // Note: `timeout_height == None` is a quirk of protobuf. In
-            // `proto3` syntax, all structs are "nullable" by default and are
-            // represented as `Option<T>`. `ibc-go` defines the protobuf file
-            // with the extension option `gogoproto.nullable = false`, which
-            // means that they will always generate a field. It is left
-            // unspecified what a `None` value means. In this case, I believe it
-            // is best to assume the obvious semantic of "no timeout".
-            Test {
-                name: "Missing timeout height".to_string(),
-                raw: RawPacket {
-                    timeout_height: None,
-                    ..default_raw_packet
-                },
-                want_pass: true,
-            },
-            Test {
-                name: "Missing both timeout height and timestamp".to_string(),
-                raw: RawPacket {
-                    timeout_height: None,
-                    ..raw_packet_no_timeout_or_timestamp
-                },
-                want_pass: false,
-            }
-        ];
-
-        for test in tests {
-            let res_msg = Packet::try_from(test.raw.clone());
-
-            assert_eq!(
-                test.want_pass,
-                res_msg.is_ok(),
-                "Packet::try_from failed for test {}, \nraw packet {:?} with error {:?}",
-                test.name,
-                test.raw,
-                res_msg.err(),
-            );
-        }
-    }
-
-    #[test]
-    fn to_and_from() {
-        let raw = dummy_raw_packet(15, 0);
-        let msg = Packet::try_from(raw.clone()).unwrap();
-        let raw_back = RawPacket::from(msg.clone());
-        let msg_back = Packet::try_from(raw_back.clone()).unwrap();
-        assert_eq!(raw, raw_back);
-        assert_eq!(msg, msg_back);
-    }
-}
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
index ee57aab62..45a427b81 100644
--- a/ibc-core/ics24-host/cosmos/Cargo.toml
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -46,10 +46,6 @@ tendermint = { workspace = true }
 parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-rstest      = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics25-handler/types/Cargo.toml b/ibc-core/ics25-handler/types/Cargo.toml
index 53eff8b37..5d92949e3 100644
--- a/ibc-core/ics25-handler/types/Cargo.toml
+++ b/ibc-core/ics25-handler/types/Cargo.toml
@@ -44,9 +44,6 @@ tendermint = { workspace = true }
 parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
-[dev-dependencies]
-ibc-testkit = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
@@ -63,7 +60,6 @@ std = [
     "ibc-primitives/std",
     "ibc-proto/std",
     "tendermint/std",
-    "ibc-testkit/std",
 ]
 serde = [
     "dep:serde",
@@ -75,7 +71,6 @@ serde = [
     "ibc-core-router-types/serde",
     "ibc-primitives/serde",
     "ibc-proto/serde",
-    "ibc-testkit/serde",
 ]
 schema = [
     "dep:schemars",
diff --git a/ibc-core/ics25-handler/types/src/events.rs b/ibc-core/ics25-handler/types/src/events.rs
index 56c236e91..78c98acbd 100644
--- a/ibc-core/ics25-handler/types/src/events.rs
+++ b/ibc-core/ics25-handler/types/src/events.rs
@@ -211,30 +211,3 @@ impl From<ModuleEvent> for IbcEvent {
         IbcEvent::Module(e)
     }
 }
-
-#[cfg(test)]
-pub mod tests {
-
-    use ibc_core_channel_types::channel::Order;
-    use ibc_core_channel_types::events::SendPacket;
-    use ibc_core_channel_types::packet::Packet;
-    use ibc_core_host_types::identifiers::ConnectionId;
-    use ibc_testkit::utils::core::channel::dummy_raw_packet;
-
-    use super::*;
-
-    #[test]
-    /// Ensures that we don't panic when packet data is not valid UTF-8.
-    /// See issue [#199](https://github.com/cosmos/ibc-rs/issues/199)
-    pub fn test_packet_data_non_utf8() {
-        let mut packet = Packet::try_from(dummy_raw_packet(1, 1)).unwrap();
-        packet.data = vec![128];
-
-        let ibc_event = IbcEvent::SendPacket(SendPacket::new(
-            packet,
-            Order::Unordered,
-            ConnectionId::default(),
-        ));
-        let _ = abci::Event::try_from(ibc_event);
-    }
-}
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 2c8ea9ff5..b2cd443b1 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -17,12 +17,14 @@ description  = """
 
 [dependencies]
 # external dependencies
+borsh             = { workspace = true, optional = true }
 bytes             = { workspace = true }
 derive_more       = { workspace = true }
 displaydoc        = { workspace = true }
 parking_lot       = { version = "0.12.1", default-features = false }
 primitive-types   = { workspace = true }
 prost             = { workspace = true }
+schemars          = { workspace = true, optional = true }
 serde             = { workspace = true, optional = true }
 serde_json        = { workspace = true, optional = true }
 subtle-encoding   = { workspace = true }
@@ -62,12 +64,14 @@ serde = [
     "serde_json",
 ]
 schema = [
+    "dep:schemars",
     "ibc/schema",
     "ibc-proto/json-schema",
     "serde",
     "std",
 ]
 borsh = [
+    "dep:borsh",
     "ibc/borsh",
     "ibc-proto/borsh",
 ]
diff --git a/ibc-testkit/src/utils/dummies/applications/mod.rs b/ibc-testkit/src/fixtures/applications/mod.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/applications/mod.rs
rename to ibc-testkit/src/fixtures/applications/mod.rs
diff --git a/ibc-testkit/src/utils/dummies/applications/transfer.rs b/ibc-testkit/src/fixtures/applications/transfer.rs
similarity index 97%
rename from ibc-testkit/src/utils/dummies/applications/transfer.rs
rename to ibc-testkit/src/fixtures/applications/transfer.rs
index 89c630c79..b352f1a42 100644
--- a/ibc-testkit/src/utils/dummies/applications/transfer.rs
+++ b/ibc-testkit/src/fixtures/applications/transfer.rs
@@ -9,7 +9,7 @@ use ibc::core::host::types::identifiers::{ChannelId, PortId, Sequence};
 use ibc::core::primitives::{Signer, Timestamp};
 use typed_builder::TypedBuilder;
 
-use crate::utils::dummies::core::signer::dummy_account_id;
+use crate::fixtures::core::signer::dummy_account_id;
 
 /// Configuration of the `MsgTransfer` message for building dummy messages.
 #[derive(TypedBuilder, Debug)]
diff --git a/ibc-testkit/src/utils/dummies/clients/mock.rs b/ibc-testkit/src/fixtures/clients/mock.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/clients/mock.rs
rename to ibc-testkit/src/fixtures/clients/mock.rs
diff --git a/ibc-testkit/src/utils/dummies/clients/mod.rs b/ibc-testkit/src/fixtures/clients/mod.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/clients/mod.rs
rename to ibc-testkit/src/fixtures/clients/mod.rs
diff --git a/ibc-testkit/src/utils/dummies/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
similarity index 75%
rename from ibc-testkit/src/utils/dummies/clients/tendermint.rs
rename to ibc-testkit/src/fixtures/clients/tendermint.rs
index 80bace16f..d64fbd488 100644
--- a/ibc-testkit/src/utils/dummies/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -18,10 +18,7 @@ use tendermint::block::Header as TmHeader;
 
 /// Returns a dummy tendermint `ClientState` by given `frozen_height`, for testing purposes only!
 pub fn dummy_tm_client_state_from_raw(frozen_height: RawHeight) -> Result<TmClientState, Error> {
-    let client_state =
-        ClientStateType::try_from(dummy_raw_tm_client_state(frozen_height)).expect("Never fails");
-
-    Ok(TmClientState::from(client_state))
+    ClientStateType::try_from(dummy_raw_tm_client_state(frozen_height)).map(TmClientState::from)
 }
 
 /// Returns a dummy tendermint `ClientState` from a `TmHeader`, for testing purposes only!
@@ -167,3 +164,57 @@ pub fn dummy_ics07_header() -> Header {
         trusted_next_validator_set: vs,
     }
 }
+
+#[cfg(test)]
+mod tests {
+
+    use ibc::primitives::proto::Any;
+
+    use super::*;
+
+    #[test]
+    fn tm_client_state_conversions_healthy() {
+        // check client state creation path from a proto type
+        let tm_client_state_from_raw = dummy_tm_client_state_from_raw(RawHeight {
+            revision_number: 0,
+            revision_height: 0,
+        });
+        assert!(tm_client_state_from_raw.is_ok());
+
+        let any_from_tm_client_state = Any::from(
+            tm_client_state_from_raw
+                .as_ref()
+                .expect("Never fails")
+                .clone(),
+        );
+        let tm_client_state_from_any = ClientStateType::try_from(any_from_tm_client_state);
+        assert!(tm_client_state_from_any.is_ok());
+        assert_eq!(
+            tm_client_state_from_raw.expect("Never fails"),
+            tm_client_state_from_any.expect("Never fails").into()
+        );
+
+        // check client state creation path from a tendermint header
+        let tm_header = dummy_tendermint_header();
+        let tm_client_state_from_header = dummy_tm_client_state_from_header(tm_header);
+        let any_from_header = Any::from(tm_client_state_from_header.clone());
+        let tm_client_state_from_any = ClientStateType::try_from(any_from_header);
+        assert!(tm_client_state_from_any.is_ok());
+        assert_eq!(
+            tm_client_state_from_header,
+            tm_client_state_from_any.expect("Never fails").into()
+        );
+    }
+
+    #[test]
+    fn tm_client_state_malformed_with_frozen_height() {
+        let tm_client_state_from_raw = dummy_tm_client_state_from_raw(RawHeight {
+            revision_number: 0,
+            revision_height: 10,
+        });
+        match tm_client_state_from_raw {
+            Err(Error::FrozenHeightNotAllowed) => {}
+            _ => panic!("Expected to fail with FrozenHeightNotAllowed error"),
+        }
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs b/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
new file mode 100644
index 000000000..299278789
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
@@ -0,0 +1,100 @@
+use ibc::core::channel::types::proto::v1::{
+    MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
+};
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgAcknowledgement`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_acknowledgement(height: u64) -> RawMsgAcknowledgement {
+    dummy_raw_msg_ack_with_packet(dummy_raw_packet(height, 1), height)
+}
+
+pub fn dummy_raw_msg_ack_with_packet(packet: RawPacket, height: u64) -> RawMsgAcknowledgement {
+    RawMsgAcknowledgement {
+        packet: Some(packet),
+        acknowledgement: dummy_proof(),
+        proof_acked: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use ibc::core::channel::types::error::PacketError;
+    use ibc::core::channel::types::msgs::MsgAcknowledgement;
+    use ibc::primitives::prelude::*;
+
+    use super::*;
+
+    #[test]
+    fn msg_acknowledgment_try_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawMsgAcknowledgement,
+            want_pass: bool,
+        }
+
+        let height = 50;
+        let default_raw_msg = dummy_raw_msg_acknowledgement(height);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Missing packet".to_string(),
+                raw: RawMsgAcknowledgement {
+                    packet: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgAcknowledgement {
+                    proof_height: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Empty signer".to_string(),
+                raw: RawMsgAcknowledgement {
+                    signer: dummy_bech32_account(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Empty proof acked".to_string(),
+                raw: RawMsgAcknowledgement {
+                    proof_acked: Vec::new(),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ];
+
+        for test in tests {
+            let res_msg: Result<MsgAcknowledgement, PacketError> = test.raw.clone().try_into();
+
+            assert_eq!(
+                res_msg.is_ok(),
+                test.want_pass,
+                "MsgAcknowledgement::try_from failed for test {} \nraw message: {:?} with error: {:?}",
+                test.name,
+                test.raw,
+                res_msg.err()
+            );
+        }
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
new file mode 100644
index 000000000..650c735ac
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
@@ -0,0 +1,136 @@
+use ibc::core::channel::types::proto::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelCloseConfirm`, for testing purposes only!
+pub fn dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelCloseConfirm {
+    RawMsgChannelCloseConfirm {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        proof_init: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelCloseConfirm;
+
+    use super::*;
+
+    #[test]
+    fn parse_channel_close_confirm_msg() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelCloseConfirm,
+            want_pass: bool,
+        }
+
+        let proof_height = 10;
+        let default_raw_msg = dummy_raw_msg_chan_close_confirm(proof_height);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Correct port".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    port_id: "p34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad port, name too short".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    port_id: "p".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad port, name too long".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    port_id:
+                        "abcdefghijklmnsdfasdfasdfasdfasdgafgadsfasdfasdfasdasfdasdfsadfopqrstuabcdefghijklmnsdfasdfasdfasdfasdgafgadsfasdfasdfasdasfdasdfsadfopqrstu"
+                            .to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Correct channel identifier".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    channel_id: "channel-34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad channel, name too short".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    channel_id: "chshort".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad channel, name too long".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    channel_id:
+                        "channel-128391283791827398127398791283912837918273981273987912839"
+                            .to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad proof height, height = 0".to_string(),
+                raw: RawMsgChannelCloseConfirm {
+                    proof_height: Some(Height {
+                        revision_number: 0,
+                        revision_height: 0,
+                    }),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let msg = MsgChannelCloseConfirm::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgChanCloseConfirm::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_chan_close_confirm(19);
+        let msg = MsgChannelCloseConfirm::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelCloseConfirm::from(msg.clone());
+        let msg_back = MsgChannelCloseConfirm::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs b/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
new file mode 100644
index 000000000..dd770443d
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
@@ -0,0 +1,113 @@
+use ibc::core::channel::types::proto::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
+
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelCloseInit`, for testing purposes only!
+pub fn dummy_raw_msg_chan_close_init() -> RawMsgChannelCloseInit {
+    RawMsgChannelCloseInit {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelCloseInit;
+
+    use super::*;
+
+    #[test]
+    fn parse_channel_close_init_msg() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelCloseInit,
+            want_pass: bool,
+        }
+
+        let default_raw_msg = dummy_raw_msg_chan_close_init();
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Correct port".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    port_id: "p34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad port, name too short".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    port_id: "p".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad port, name too long".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    port_id: "abcdefsdfasdfasdfasdfasdfasdfadsfasdgafsgadfasdfasdfasdfsdfasdfaghijklmnopqrstuabcdefsdfasdfasdfasdfasdfasdfadsfasdgafsgadfasdfasdfasdfsdfasdfaghijklmnopqrstu".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Correct channel identifier".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    channel_id: "channel-34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad channel, name too short".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    channel_id: "chshort".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad channel, name too long".to_string(),
+                raw: RawMsgChannelCloseInit {
+                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ]
+            .into_iter()
+            .collect();
+
+        for test in tests {
+            let msg = MsgChannelCloseInit::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgChanCloseInit::try_from failed for test {}, \nmsg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_chan_close_init();
+        let msg = MsgChannelCloseInit::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelCloseInit::from(msg.clone());
+        let msg_back = MsgChannelCloseInit::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
new file mode 100644
index 000000000..8b9a0b952
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
@@ -0,0 +1,190 @@
+use ibc::core::channel::types::proto::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenAck`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
+    RawMsgChannelOpenAck {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        counterparty_channel_id: ChannelId::default().to_string(),
+        counterparty_version: "".to_string(),
+        proof_try: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelOpenAck;
+
+    use super::*;
+
+    #[test]
+    fn parse_channel_open_ack_msg() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelOpenAck,
+            want_pass: bool,
+        }
+
+        let proof_height = 20;
+        let default_raw_msg = dummy_raw_msg_chan_open_ack(proof_height);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Correct port identifier".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    port_id: "p34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad port, name too short".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    port_id: "p".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad port, name too long".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    port_id: "abcdezdfDfsdfgfddsfsfdsdfdfvxcvzxcvsgdfsdfwefwvsdfdsfdasgagadgsadgsdffghijklmnopqrstuabcdezdfDfsdfgfddsfsfdsdfdfvxcvzxcvsgdfsdfwefwvsdfdsfdasgagadgsadgsdffghijklmnopqrstu".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Correct channel identifier".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    channel_id: "channel-34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad channel, name too short".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    channel_id: "chshort".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad channel, name too long".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "[Counterparty] Correct channel identifier".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    counterparty_channel_id: "channel-34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "[Counterparty] Bad channel, name too short".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    counterparty_channel_id: "chshort".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "[Counterparty] Bad channel, name too long".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    counterparty_channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Empty counterparty version (allowed)".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    counterparty_version: " ".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Arbitrary counterparty version (allowed)".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    counterparty_version: "v1.1.23-alpha".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad proof height, height = 0".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    proof_height: Some(Height {
+                        revision_number: 0,
+                        revision_height: 0,
+                    }),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    proof_height: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof try (object proof)".to_string(),
+                raw: RawMsgChannelOpenAck {
+                    proof_try: Vec::new(),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ]
+            .into_iter()
+            .collect();
+
+        for test in tests {
+            let res_msg = MsgChannelOpenAck::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "MsgChanOpenAck::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_chan_open_ack(100);
+        let msg = MsgChannelOpenAck::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelOpenAck::from(msg.clone());
+        let msg_back = MsgChannelOpenAck::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
new file mode 100644
index 000000000..dfb1c797e
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
@@ -0,0 +1,140 @@
+use ibc::core::channel::types::proto::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenConfirm`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
+    RawMsgChannelOpenConfirm {
+        port_id: PortId::transfer().to_string(),
+        channel_id: ChannelId::default().to_string(),
+        proof_ack: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelOpenConfirm;
+
+    use super::*;
+
+    #[test]
+    fn parse_channel_open_confirm_msg() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelOpenConfirm,
+            want_pass: bool,
+        }
+
+        let proof_height = 78;
+        let default_raw_msg = dummy_raw_msg_chan_open_confirm(proof_height);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Correct port".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    port_id: "p34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad port, name too short".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    port_id: "p".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad port, name too long".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    port_id: "abcdesdfasdsdffasdfasdfasfasdgasdfgasdfasdfasdfasdfasdfasdffghijklmnopqrstuabcdesdfasdsdffasdfasdfasfasdgasdfgasdfasdfasdfasdfasdfasdffghijklmnopqrstu".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Correct channel identifier".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    channel_id: "channel-34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad channel, name too short".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    channel_id: "chshort".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad channel, name too long".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    channel_id: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad proof height, height = 0".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    proof_height: Some(Height {
+                        revision_number: 0,
+                        revision_height: 0,
+                    }),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing object proof".to_string(),
+                raw: RawMsgChannelOpenConfirm {
+                    proof_ack: Vec::new(),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ]
+            .into_iter()
+            .collect();
+
+        for test in tests {
+            let res_msg = MsgChannelOpenConfirm::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "MsgChanOpenConfirm::try_from failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_chan_open_confirm(19);
+        let msg = MsgChannelOpenConfirm::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelOpenConfirm::from(msg.clone());
+        let msg_back = MsgChannelOpenConfirm::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_init.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_init.rs
new file mode 100644
index 000000000..a40f5afa8
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_init.rs
@@ -0,0 +1,106 @@
+use ibc::core::channel::types::proto::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_raw_channel_end;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenInit`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_init(counterparty_channel_id: Option<u64>) -> RawMsgChannelOpenInit {
+    RawMsgChannelOpenInit {
+        port_id: PortId::transfer().to_string(),
+        channel: Some(dummy_raw_channel_end(1, counterparty_channel_id)),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelOpenInit;
+
+    use super::*;
+
+    #[test]
+    fn channel_open_init_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelOpenInit,
+            want_pass: bool,
+        }
+
+        let default_raw_init_msg = dummy_raw_msg_chan_open_init(None);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_init_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Incorrect port identifier, slash (separator) prohibited".to_string(),
+                raw: RawMsgChannelOpenInit {
+                    port_id: "p34/".to_string(),
+                    ..default_raw_init_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing channel".to_string(),
+                raw: RawMsgChannelOpenInit {
+                    channel: None,
+                    ..default_raw_init_msg
+                },
+                want_pass: false,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let res_msg = MsgChannelOpenInit::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "MsgChanOpenInit::try_from failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        // Check if raw and domain types are equal after conversions
+        let raw = dummy_raw_msg_chan_open_init(None);
+        let msg = MsgChannelOpenInit::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelOpenInit::from(msg.clone());
+        let msg_back = MsgChannelOpenInit::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+
+        // Check if handler sets counterparty channel id to `None`
+        // in case relayer passes `MsgChannelOpenInit` message with it set to `Some(_)`
+        let raw_with_counterparty_chan_id_some = dummy_raw_msg_chan_open_init(None);
+        let msg_with_counterparty_chan_id_some =
+            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some).unwrap();
+        let raw_with_counterparty_chan_id_some_back =
+            RawMsgChannelOpenInit::from(msg_with_counterparty_chan_id_some.clone());
+        let msg_with_counterparty_chan_id_some_back =
+            MsgChannelOpenInit::try_from(raw_with_counterparty_chan_id_some_back.clone()).unwrap();
+        assert_eq!(
+            raw_with_counterparty_chan_id_some_back
+                .channel
+                .unwrap()
+                .counterparty
+                .unwrap()
+                .channel_id,
+            "".to_string()
+        );
+        assert_eq!(
+            msg_with_counterparty_chan_id_some,
+            msg_with_counterparty_chan_id_some_back
+        );
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_try.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_try.rs
new file mode 100644
index 000000000..8b4185df6
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_try.rs
@@ -0,0 +1,143 @@
+use ibc::core::channel::types::proto::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::host::types::identifiers::PortId;
+use ibc::core::primitives::prelude::*;
+
+use super::{dummy_proof, dummy_raw_channel_end};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgChannelOpenTry`, for testing purposes only!
+pub fn dummy_raw_msg_chan_open_try(proof_height: u64) -> RawMsgChannelOpenTry {
+    #[allow(deprecated)]
+    RawMsgChannelOpenTry {
+        port_id: PortId::transfer().to_string(),
+        previous_channel_id: "".to_string(),
+        channel: Some(dummy_raw_channel_end(2, Some(0))),
+        counterparty_version: "".to_string(),
+        proof_init: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgChannelOpenTry;
+
+    use super::*;
+
+    #[test]
+    fn channel_open_try_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawMsgChannelOpenTry,
+            want_pass: bool,
+        }
+
+        let proof_height = 10;
+        let default_raw_msg = dummy_raw_msg_chan_open_try(proof_height);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Correct port".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    port_id: "p34".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad port, name too short".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    port_id: "p".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad port, name too long".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    port_id: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfaabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfa".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Empty counterparty version (valid choice)".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    counterparty_version: " ".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Arbitrary counterparty version (valid choice)".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    counterparty_version: "anyversion".to_string(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad proof height, height = 0".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    proof_height: Some(Height {
+                        revision_number: 0,
+                        revision_height: 0,
+                    }),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    proof_height: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof init (object proof)".to_string(),
+                raw: RawMsgChannelOpenTry {
+                    proof_init: Vec::new(),
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ]
+            .into_iter()
+            .collect();
+
+        for test in tests {
+            let res_msg = MsgChannelOpenTry::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "MsgChanOpenTry::try_from failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_chan_open_try(10);
+        let msg = MsgChannelOpenTry::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgChannelOpenTry::from(msg.clone());
+        let msg_back = MsgChannelOpenTry::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/mod.rs b/ibc-testkit/src/fixtures/core/channel/mod.rs
new file mode 100644
index 000000000..0f0df1bf4
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/mod.rs
@@ -0,0 +1,194 @@
+mod acknowledgement;
+mod chan_close_confirm;
+mod chan_close_init;
+mod chan_open_ack;
+mod chan_open_confirm;
+mod chan_open_init;
+mod chan_open_try;
+mod packet;
+mod recv_packet;
+mod timeout;
+mod timeout_on_close;
+
+pub use acknowledgement::*;
+pub use chan_close_confirm::*;
+pub use chan_close_init::*;
+pub use chan_open_ack::*;
+pub use chan_open_confirm::*;
+pub use chan_open_init::*;
+pub use chan_open_try::*;
+use ibc::core::channel::types::proto::v1::{
+    Channel as RawChannel, Counterparty as RawCounterparty,
+};
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::primitives::prelude::*;
+pub use packet::*;
+pub use recv_packet::*;
+pub use timeout::*;
+pub use timeout_on_close::*;
+
+/// Returns a dummy `RawCounterparty`, for testing purposes only!
+/// Can be optionally parametrized with a specific channel identifier.
+pub fn dummy_raw_counterparty_chan(channel_id: String) -> RawCounterparty {
+    RawCounterparty {
+        port_id: PortId::transfer().to_string(),
+        channel_id,
+    }
+}
+
+/// Returns a dummy `RawChannel`, for testing purposes only!
+pub fn dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel {
+    let channel_id = match channel_id {
+        Some(id) => ChannelId::new(id).to_string(),
+        None => "".to_string(),
+    };
+    RawChannel {
+        state,
+        ordering: 2,
+        counterparty: Some(dummy_raw_counterparty_chan(channel_id)),
+        connection_hops: vec![ConnectionId::default().to_string()],
+        version: "".to_string(), // The version is not validated.
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use core::str::FromStr;
+
+    use ibc::core::channel::types::channel::ChannelEnd;
+
+    use super::*;
+    #[test]
+    fn channel_end_try_from_raw() {
+        let raw_channel_end = dummy_raw_channel_end(2, Some(0));
+
+        let empty_raw_channel_end = RawChannel {
+            counterparty: None,
+            ..raw_channel_end.clone()
+        };
+
+        struct Test {
+            name: String,
+            params: RawChannel,
+            want_pass: bool,
+        }
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Raw channel end with missing counterparty".to_string(),
+                params: empty_raw_channel_end,
+                want_pass: false,
+            },
+            Test {
+                name: "Raw channel end with incorrect state".to_string(),
+                params: RawChannel {
+                    state: -1,
+                    ..raw_channel_end.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Raw channel end with incorrect ordering".to_string(),
+                params: RawChannel {
+                    ordering: -1,
+                    ..raw_channel_end.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Raw channel end with incorrect connection id in connection hops".to_string(),
+                params: RawChannel {
+                    connection_hops: vec!["connection*".to_string()].into_iter().collect(),
+                    ..raw_channel_end.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Raw channel end with incorrect connection id (has blank space)".to_string(),
+                params: RawChannel {
+                    connection_hops: vec!["con nection".to_string()].into_iter().collect(),
+                    ..raw_channel_end.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Raw channel end with two correct connection ids in connection hops"
+                    .to_string(),
+                params: RawChannel {
+                    connection_hops: vec!["connection-1".to_string(), "connection-2".to_string()]
+                        .into_iter()
+                        .collect(),
+                    ..raw_channel_end.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Raw channel end with correct params".to_string(),
+                params: raw_channel_end,
+                want_pass: true,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let p = test.params.clone();
+
+            let ce_result = ChannelEnd::try_from(p);
+
+            assert_eq!(
+                test.want_pass,
+                ce_result.is_ok(),
+                "ChannelEnd::try_from() failed for test {}, \nmsg{:?} with error {:?}",
+                test.name,
+                test.params.clone(),
+                ce_result.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn parse_channel_ordering_type() {
+        use ibc::core::channel::types::channel::Order;
+
+        struct Test {
+            ordering: &'static str,
+            want_res: Order,
+            want_err: bool,
+        }
+        let tests: Vec<Test> = vec![
+            Test {
+                ordering: "UNINITIALIZED",
+                want_res: Order::None,
+                want_err: false,
+            },
+            Test {
+                ordering: "UNORDERED",
+                want_res: Order::Unordered,
+                want_err: false,
+            },
+            Test {
+                ordering: "ORDERED",
+                want_res: Order::Ordered,
+                want_err: false,
+            },
+            Test {
+                ordering: "UNKNOWN_ORDER",
+                want_res: Order::None,
+                want_err: true,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            match Order::from_str(test.ordering) {
+                Ok(res) => {
+                    assert!(!test.want_err);
+                    assert_eq!(test.want_res, res);
+                }
+                Err(_) => assert!(test.want_err, "parse failed"),
+            }
+        }
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
new file mode 100644
index 000000000..caa094c5a
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -0,0 +1,275 @@
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::proto::v1::Packet as RawPacket;
+use ibc::core::channel::types::timeout::TimeoutHeight;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::host::types::identifiers::{ChannelId, PortId, Sequence};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use typed_builder::TypedBuilder;
+
+/// Configuration of the `PacketData` type for building dummy packets.
+#[derive(TypedBuilder, Debug)]
+#[builder(build_method(into = Packet))]
+pub struct PacketConfig {
+    #[builder(default)]
+    pub seq_on_a: Sequence,
+    #[builder(default = PortId::transfer())]
+    pub port_id_on_a: PortId,
+    #[builder(default)]
+    pub chan_id_on_a: ChannelId,
+    #[builder(default = PortId::transfer())]
+    pub port_id_on_b: PortId,
+    #[builder(default)]
+    pub chan_id_on_b: ChannelId,
+    #[builder(default)]
+    pub data: Vec<u8>,
+    #[builder(default)]
+    pub timeout_height_on_b: TimeoutHeight,
+    #[builder(default)]
+    pub timeout_timestamp_on_b: Timestamp,
+}
+
+impl From<PacketConfig> for Packet {
+    fn from(config: PacketConfig) -> Self {
+        Packet {
+            seq_on_a: config.seq_on_a,
+            port_id_on_a: config.port_id_on_a,
+            chan_id_on_a: config.chan_id_on_a,
+            port_id_on_b: config.port_id_on_b,
+            chan_id_on_b: config.chan_id_on_b,
+            data: config.data,
+            timeout_height_on_b: config.timeout_height_on_b,
+            timeout_timestamp_on_b: config.timeout_timestamp_on_b,
+        }
+    }
+}
+
+/// Returns a dummy `RawPacket`, for testing purposes only!
+pub fn dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacket {
+    RawPacket {
+        sequence: 1,
+        source_port: PortId::transfer().to_string(),
+        source_channel: ChannelId::default().to_string(),
+        destination_port: PortId::transfer().to_string(),
+        destination_channel: ChannelId::default().to_string(),
+        data: vec![0],
+        timeout_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: timeout_height,
+        }),
+        timeout_timestamp,
+    }
+}
+
+pub fn dummy_proof() -> Vec<u8> {
+    "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
+        .as_bytes()
+        .to_vec()
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::channel::Order;
+    use ibc::core::channel::types::events::SendPacket;
+    use ibc::core::channel::types::packet::Packet;
+    use ibc::core::handler::types::events::IbcEvent;
+    use ibc::core::host::types::identifiers::ConnectionId;
+
+    use super::*;
+
+    #[test]
+    fn packet_try_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawPacket,
+            want_pass: bool,
+        }
+
+        let proof_height = 10;
+        let default_raw_packet = dummy_raw_packet(proof_height, 1000);
+        let raw_packet_no_timeout_or_timestamp = dummy_raw_packet(10, 0);
+
+        let mut raw_packet_invalid_timeout_height = dummy_raw_packet(0, 10);
+        raw_packet_invalid_timeout_height.timeout_height = Some(RawHeight {
+            revision_number: 1,
+            revision_height: 0,
+        });
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_packet.clone(),
+                want_pass: true,
+            },
+            Test {
+                // Note: ibc-go currently (July 2022) incorrectly rejects this
+                // case, even though it is allowed in ICS-4.
+                name: "Packet with no timeout of timestamp".to_string(),
+                raw: raw_packet_no_timeout_or_timestamp.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Packet with invalid timeout height".to_string(),
+                raw: raw_packet_invalid_timeout_height,
+                want_pass: false,
+            },
+            Test {
+                name: "Src port validation: correct".to_string(),
+                raw: RawPacket {
+                    source_port: "srcportp34".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad src port, name too short".to_string(),
+                raw: RawPacket {
+                    source_port: "p".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad src port, name too long".to_string(),
+                raw: RawPacket {
+                    source_port: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstuabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstu".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Dst port validation: correct".to_string(),
+                raw: RawPacket {
+                    destination_port: "destportsrcp34".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad dst port, name too short".to_string(),
+                raw: RawPacket {
+                    destination_port: "p".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad dst port, name too long".to_string(),
+                raw: RawPacket {
+                    destination_port: "abcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfasdfasdfasdfaklmnopqrstuabcdefghijasdfasdfasdfasdfasdfasdfasdfasdfasdfasdfadgasgasdfas".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Src channel validation: correct".to_string(),
+                raw: RawPacket {
+                    source_channel: "channel-1".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad src channel, name too short".to_string(),
+                raw: RawPacket {
+                    source_channel: "p".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad src channel, name too long".to_string(),
+                raw: RawPacket {
+                    source_channel: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Dst channel validation: correct".to_string(),
+                raw: RawPacket {
+                    destination_channel: "channel-34".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Bad dst channel, name too short".to_string(),
+                raw: RawPacket {
+                    destination_channel: "p".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad dst channel, name too long".to_string(),
+                raw: RawPacket {
+                    destination_channel: "channel-128391283791827398127398791283912837918273981273987912839".to_string(),
+                    ..default_raw_packet.clone()
+                },
+                want_pass: false,
+            },
+            // Note: `timeout_height == None` is a quirk of protobuf. In
+            // `proto3` syntax, all structs are "nullable" by default and are
+            // represented as `Option<T>`. `ibc-go` defines the protobuf file
+            // with the extension option `gogoproto.nullable = false`, which
+            // means that they will always generate a field. It is left
+            // unspecified what a `None` value means. In this case, I believe it
+            // is best to assume the obvious semantic of "no timeout".
+            Test {
+                name: "Missing timeout height".to_string(),
+                raw: RawPacket {
+                    timeout_height: None,
+                    ..default_raw_packet
+                },
+                want_pass: true,
+            },
+            Test {
+                name: "Missing both timeout height and timestamp".to_string(),
+                raw: RawPacket {
+                    timeout_height: None,
+                    ..raw_packet_no_timeout_or_timestamp
+                },
+                want_pass: false,
+            }
+        ];
+
+        for test in tests {
+            let res_msg = Packet::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "Packet::try_from failed for test {}, \nraw packet {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_packet(15, 0);
+        let msg = Packet::try_from(raw.clone()).unwrap();
+        let raw_back = RawPacket::from(msg.clone());
+        let msg_back = Packet::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+
+    #[test]
+    /// Ensures that we don't panic when packet data is not valid UTF-8.
+    /// See issue [#199](https://github.com/cosmos/ibc-rs/issues/199)
+    pub fn test_packet_data_non_utf8() {
+        let mut packet = Packet::try_from(dummy_raw_packet(1, 1)).unwrap();
+        packet.data = vec![128];
+
+        let ibc_event = IbcEvent::SendPacket(SendPacket::new(
+            packet,
+            Order::Unordered,
+            ConnectionId::default(),
+        ));
+        let _ = tendermint::abci::Event::try_from(ibc_event);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/recv_packet.rs b/ibc-testkit/src/fixtures/core/channel/recv_packet.rs
new file mode 100644
index 000000000..0faeff71a
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/recv_packet.rs
@@ -0,0 +1,119 @@
+use core::ops::Add;
+use core::time::Duration;
+
+use ibc::core::channel::types::msgs::MsgRecvPacket;
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::proto::v1::MsgRecvPacket as RawMsgRecvPacket;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::commitment_types::commitment::CommitmentProofBytes;
+use ibc::core::primitives::{Signer, Timestamp};
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+pub fn dummy_msg_recv_packet(
+    packet: Packet,
+    proof_commitment_on_a: CommitmentProofBytes,
+    proof_height_on_a: Height,
+    signer: Signer,
+) -> MsgRecvPacket {
+    MsgRecvPacket {
+        packet,
+        proof_commitment_on_a,
+        proof_height_on_a,
+        signer,
+    }
+}
+
+/// Returns a dummy `RawMsgRecvPacket`, for testing purposes only! The `height`
+/// parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_recv_packet(height: u64) -> RawMsgRecvPacket {
+    let timestamp = Timestamp::now().add(Duration::from_secs(9));
+    RawMsgRecvPacket {
+        packet: Some(dummy_raw_packet(
+            height,
+            timestamp.expect("timestamp").nanoseconds(),
+        )),
+        proof_commitment: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use ibc::core::channel::types::error::PacketError;
+    use ibc::primitives::prelude::*;
+
+    use super::*;
+
+    #[test]
+    fn msg_recv_packet_try_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawMsgRecvPacket,
+            want_pass: bool,
+        }
+
+        let height = 20;
+        let default_raw_msg = dummy_raw_msg_recv_packet(height);
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Missing proof".to_string(),
+                raw: RawMsgRecvPacket {
+                    proof_commitment: Vec::new(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgRecvPacket {
+                    proof_height: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Empty signer".to_string(),
+                raw: RawMsgRecvPacket {
+                    signer: dummy_bech32_account(),
+                    ..default_raw_msg
+                },
+                want_pass: true,
+            },
+        ];
+
+        for test in tests {
+            let res_msg: Result<MsgRecvPacket, PacketError> = test.raw.clone().try_into();
+
+            assert_eq!(
+                res_msg.is_ok(),
+                test.want_pass,
+                "MsgRecvPacket::try_from failed for test {} \nraw message: {:?} with error: {:?}",
+                test.name,
+                test.raw,
+                res_msg.err()
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_recv_packet(15);
+        let msg = MsgRecvPacket::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgRecvPacket::from(msg.clone());
+        let msg_back = MsgRecvPacket::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/timeout.rs b/ibc-testkit/src/fixtures/core/channel/timeout.rs
new file mode 100644
index 000000000..960dd4d57
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/timeout.rs
@@ -0,0 +1,112 @@
+use ibc::core::channel::types::proto::v1::MsgTimeout as RawMsgTimeout;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgTimeout`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_timeout(
+    proof_height: u64,
+    timeout_height: u64,
+    timeout_timestamp: u64,
+) -> RawMsgTimeout {
+    RawMsgTimeout {
+        packet: Some(dummy_raw_packet(timeout_height, timeout_timestamp)),
+        proof_unreceived: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        next_sequence_recv: 1,
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod test {
+    use ibc::core::channel::types::error::PacketError;
+    use ibc::core::channel::types::msgs::MsgTimeout;
+    use ibc::primitives::prelude::*;
+
+    use super::*;
+
+    #[test]
+    fn msg_timeout_try_from_raw() {
+        struct Test {
+            name: String,
+            raw: RawMsgTimeout,
+            want_pass: bool,
+        }
+
+        let proof_height = 50;
+        let timeout_height = proof_height;
+        let timeout_timestamp = 0;
+        let default_raw_msg =
+            dummy_raw_msg_timeout(proof_height, timeout_height, timeout_timestamp);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Missing packet".to_string(),
+                raw: RawMsgTimeout {
+                    packet: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof".to_string(),
+                raw: RawMsgTimeout {
+                    proof_unreceived: Vec::new(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgTimeout {
+                    proof_height: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Empty signer".to_string(),
+                raw: RawMsgTimeout {
+                    signer: dummy_bech32_account(),
+                    ..default_raw_msg
+                },
+                want_pass: true,
+            },
+        ];
+
+        for test in tests {
+            let res_msg: Result<MsgTimeout, PacketError> = test.raw.clone().try_into();
+
+            assert_eq!(
+                res_msg.is_ok(),
+                test.want_pass,
+                "MsgTimeout::try_from failed for test {} \nraw message: {:?} with error: {:?}",
+                test.name,
+                test.raw,
+                res_msg.err()
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let dummy_raw_msg_timeout = dummy_raw_msg_timeout(15, 20, 0);
+        let raw = dummy_raw_msg_timeout;
+        let msg = MsgTimeout::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgTimeout::from(msg.clone());
+        let msg_back = MsgTimeout::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
new file mode 100644
index 000000000..42db0e35f
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
@@ -0,0 +1,106 @@
+use ibc::core::channel::types::proto::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+
+use super::{dummy_proof, dummy_raw_packet};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgTimeoutOnClose`, for testing purposes only!
+/// The `height` parametrizes both the proof height as well as the timeout height.
+pub fn dummy_raw_msg_timeout_on_close(height: u64, timeout_timestamp: u64) -> RawMsgTimeoutOnClose {
+    RawMsgTimeoutOnClose {
+        packet: Some(dummy_raw_packet(height, timeout_timestamp)),
+        proof_unreceived: dummy_proof(),
+        proof_close: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: height,
+        }),
+        next_sequence_recv: 1,
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::channel::types::msgs::MsgTimeoutOnClose;
+    use ibc::primitives::prelude::*;
+
+    use super::*;
+
+    #[test]
+    fn msg_timeout_on_close_try_from_raw() {
+        let height = 50;
+        let timeout_timestamp = 5;
+        let raw = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
+
+        let msg = MsgTimeoutOnClose::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgTimeoutOnClose::from(msg);
+        assert_eq!(raw, raw_back);
+    }
+
+    #[test]
+    fn parse_timeout_on_close_msg() {
+        struct Test {
+            name: String,
+            raw: RawMsgTimeoutOnClose,
+            want_pass: bool,
+        }
+
+        let height = 50;
+        let timeout_timestamp = 5;
+        let default_raw_msg = dummy_raw_msg_timeout_on_close(height, timeout_timestamp);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_raw_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Missing packet".to_string(),
+                raw: RawMsgTimeoutOnClose {
+                    packet: None,
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof of unreceived packet".to_string(),
+                raw: RawMsgTimeoutOnClose {
+                    proof_unreceived: Vec::new(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof of channel".to_string(),
+                raw: RawMsgTimeoutOnClose {
+                    proof_close: Vec::new(),
+                    ..default_raw_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Missing proof height".to_string(),
+                raw: RawMsgTimeoutOnClose {
+                    proof_height: None,
+                    ..default_raw_msg
+                },
+                want_pass: false,
+            },
+        ];
+
+        for test in tests {
+            let res_msg = MsgTimeoutOnClose::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                res_msg.is_ok(),
+                "MsgTimeoutOnClose::try_from raw failed for test {}, \nraw msg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                res_msg.err(),
+            );
+        }
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/client/mod.rs b/ibc-testkit/src/fixtures/core/client/mod.rs
new file mode 100644
index 000000000..e6807a097
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/client/mod.rs
@@ -0,0 +1,113 @@
+#[cfg(feature = "serde")]
+mod msg_create_client;
+#[cfg(feature = "serde")]
+mod msg_update_client;
+mod msg_upgrade_client;
+
+#[cfg(feature = "serde")]
+pub use msg_create_client::*;
+#[cfg(feature = "serde")]
+pub use msg_update_client::*;
+pub use msg_upgrade_client::*;
+
+#[cfg(test)]
+mod tests {
+    use core::str::FromStr;
+
+    use ibc::core::client::types::events::*;
+    use ibc::core::client::types::Height;
+    use ibc::core::host::types::identifiers::*;
+    use ibc::primitives::prelude::*;
+    use ibc_proto::google::protobuf::Any;
+    use prost::Message;
+    use tendermint::abci::Event as AbciEvent;
+
+    use crate::fixtures::clients::mock::dummy_new_mock_header;
+
+    #[test]
+    fn ibc_to_abci_client_events() {
+        struct Test {
+            event_kind: &'static str,
+            event: AbciEvent,
+            expected_keys: Vec<&'static str>,
+            expected_values: Vec<&'static str>,
+        }
+
+        let client_type = ClientType::from_str("07-tendermint")
+            .expect("never fails because it's a valid client type");
+        let client_id = ClientId::new(client_type.clone(), 0).unwrap();
+        let consensus_height = Height::new(0, 5).unwrap();
+        let consensus_heights = vec![Height::new(0, 5).unwrap(), Height::new(0, 7).unwrap()];
+        let header: Any = dummy_new_mock_header(5).into();
+        let expected_keys = vec![
+            "client_id",
+            "client_type",
+            "consensus_height",
+            "consensus_heights",
+            "header",
+        ];
+
+        let expected_values = vec![
+            "07-tendermint-0",
+            "07-tendermint",
+            "0-5",
+            "0-5,0-7",
+            "0a102f6962632e6d6f636b2e48656164657212040a021005",
+        ];
+
+        let tests: Vec<Test> = vec![
+            Test {
+                event_kind: CREATE_CLIENT_EVENT,
+                event: CreateClient::new(client_id.clone(), client_type.clone(), consensus_height)
+                    .into(),
+                expected_keys: expected_keys[0..3].to_vec(),
+                expected_values: expected_values[0..3].to_vec(),
+            },
+            Test {
+                event_kind: UPDATE_CLIENT_EVENT,
+                event: UpdateClient::new(
+                    client_id.clone(),
+                    client_type.clone(),
+                    consensus_height,
+                    consensus_heights,
+                    header.encode_to_vec(),
+                )
+                .into(),
+                expected_keys: expected_keys.clone(),
+                expected_values: expected_values.clone(),
+            },
+            Test {
+                event_kind: UPGRADE_CLIENT_EVENT,
+                event: UpgradeClient::new(client_id.clone(), client_type.clone(), consensus_height)
+                    .into(),
+                expected_keys: expected_keys[0..3].to_vec(),
+                expected_values: expected_values[0..3].to_vec(),
+            },
+            Test {
+                event_kind: CLIENT_MISBEHAVIOUR_EVENT,
+                event: ClientMisbehaviour::new(client_id, client_type).into(),
+                expected_keys: expected_keys[0..2].to_vec(),
+                expected_values: expected_values[0..2].to_vec(),
+            },
+        ];
+
+        for t in tests {
+            assert_eq!(t.event.kind, t.event_kind);
+            assert_eq!(t.expected_keys.len(), t.event.attributes.len());
+            for (i, e) in t.event.attributes.iter().enumerate() {
+                assert_eq!(
+                    e.key, t.expected_keys[i],
+                    "key mismatch for {:?}",
+                    t.event_kind
+                );
+            }
+            for (i, e) in t.event.attributes.iter().enumerate() {
+                assert_eq!(
+                    e.value, t.expected_values[i],
+                    "value mismatch for {:?}",
+                    t.event_kind
+                );
+            }
+        }
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/client/msg_create_client.rs b/ibc-testkit/src/fixtures/core/client/msg_create_client.rs
new file mode 100644
index 000000000..bc1cfbc31
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/client/msg_create_client.rs
@@ -0,0 +1,38 @@
+use ibc::clients::tendermint::types::ConsensusState as TmConsensusState;
+use ibc::core::client::types::proto::v1::MsgCreateClient as RawMsgCreateClient;
+use ibc::primitives::proto::Any;
+
+use crate::fixtures::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgCreateClient`, for testing purposes only!
+pub fn dummy_raw_msg_create_client() -> RawMsgCreateClient {
+    let tm_header = dummy_tendermint_header();
+
+    let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone());
+
+    RawMsgCreateClient {
+        client_state: Some(Any::from(tm_client_state)),
+        consensus_state: Some(Any::from(TmConsensusState::from(tm_header))),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::client::types::msgs::MsgCreateClient;
+
+    use super::*;
+
+    #[test]
+    fn msg_create_client_serialization() {
+        let raw = dummy_raw_msg_create_client();
+        let msg = MsgCreateClient::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgCreateClient::from(msg.clone());
+        let msg_back = MsgCreateClient::try_from(raw_back.clone()).unwrap();
+        assert_eq!(msg, msg_back);
+        assert_eq!(raw, raw_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/client/msg_update_client.rs b/ibc-testkit/src/fixtures/core/client/msg_update_client.rs
new file mode 100644
index 000000000..980dee50b
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/client/msg_update_client.rs
@@ -0,0 +1,35 @@
+use ibc::core::client::types::proto::v1::MsgUpdateClient as RawMsgUpdateClient;
+use ibc::primitives::proto::Any;
+
+use crate::fixtures::clients::tendermint::dummy_ics07_header;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `RawMsgUpdateClient`, for testing purposes only!
+pub fn dummy_raw_msg_update_client() -> RawMsgUpdateClient {
+    let client_id = "07-tendermint-0".parse().unwrap();
+
+    let tm_header = dummy_ics07_header();
+
+    RawMsgUpdateClient {
+        client_id,
+        client_message: Some(Any::from(tm_header)),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::client::types::msgs::MsgUpdateClient;
+
+    use super::*;
+
+    #[test]
+    fn msg_update_client_serialization() {
+        let raw = dummy_raw_msg_update_client();
+        let msg = MsgUpdateClient::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgUpdateClient::from(msg.clone());
+        let msg_back = MsgUpdateClient::try_from(raw_back.clone()).unwrap();
+        assert_eq!(msg, msg_back);
+        assert_eq!(raw, raw_back);
+    }
+}
diff --git a/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
similarity index 71%
rename from ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
rename to ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
index c5e75aae3..29ac5e080 100644
--- a/ibc-testkit/src/utils/dummies/core/client/msg_upgrade_client.rs
+++ b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
@@ -3,11 +3,11 @@ use ibc::core::client::types::proto::v1::MsgUpgradeClient as RawMsgUpgradeClient
 use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::ClientId;
 
+use crate::fixtures::core::commitment::dummy_commitment_proof_bytes;
+use crate::fixtures::core::signer::{dummy_account_id, dummy_bech32_account};
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::utils::dummies::core::commitment::dummy_commitment_proof_bytes;
-use crate::utils::dummies::core::signer::{dummy_account_id, dummy_bech32_account};
 
 /// Returns a dummy `MsgUpgradeClient`, for testing purposes only!
 pub fn dummy_msg_upgrade_client(client_id: ClientId, upgrade_height: Height) -> MsgUpgradeClient {
@@ -36,3 +36,21 @@ pub fn dummy_raw_msg_upgrade_client() -> RawMsgUpgradeClient {
         signer: dummy_bech32_account(),
     }
 }
+
+#[cfg(test)]
+mod tests {
+
+    use ibc::core::client::types::msgs::MsgUpgradeClient;
+
+    use super::*;
+
+    #[test]
+    fn msg_upgrade_client_serialization() {
+        let raw = dummy_raw_msg_upgrade_client();
+        let msg = MsgUpgradeClient::try_from(raw.clone()).unwrap();
+        let raw_back: RawMsgUpgradeClient = RawMsgUpgradeClient::from(msg.clone());
+        let msg_back = MsgUpgradeClient::try_from(raw_back.clone()).unwrap();
+        assert_eq!(msg, msg_back);
+        assert_eq!(raw, raw_back);
+    }
+}
diff --git a/ibc-testkit/src/utils/dummies/core/commitment.rs b/ibc-testkit/src/fixtures/core/commitment.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/core/commitment.rs
rename to ibc-testkit/src/fixtures/core/commitment.rs
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
new file mode 100644
index 000000000..f690e430a
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
@@ -0,0 +1,133 @@
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenAck;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
+use ibc::core::connection::types::version::Version;
+use ibc::core::host::types::identifiers::ConnectionId;
+use ibc::core::primitives::prelude::*;
+
+use crate::fixtures::core::channel::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+
+/// Returns a dummy `MsgConnectionOpenAck` with dummy values.
+pub fn dummy_msg_conn_open_ack(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenAck {
+    MsgConnectionOpenAck::try_from(dummy_raw_msg_conn_open_ack(proof_height, consensus_height))
+        .expect("Never fails")
+}
+
+/// Returns a dummy `RawMsgConnectionOpenAck`, for testing purposes only!
+pub fn dummy_raw_msg_conn_open_ack(
+    proof_height: u64,
+    consensus_height: u64,
+) -> RawMsgConnectionOpenAck {
+    let client_state_height = Height::new(0, consensus_height).expect("invalid height");
+    RawMsgConnectionOpenAck {
+        connection_id: ConnectionId::new(0).to_string(),
+        counterparty_connection_id: ConnectionId::new(1).to_string(),
+        proof_try: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        proof_consensus: dummy_proof(),
+        consensus_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: consensus_height,
+        }),
+        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
+        proof_client: dummy_proof(),
+        version: Some(Version::default().into()),
+        signer: dummy_bech32_account(),
+        host_consensus_state_proof: vec![],
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn parse_connection_open_ack_msg() {
+        #[derive(Clone, Debug, PartialEq)]
+        struct Test {
+            name: String,
+            raw: RawMsgConnectionOpenAck,
+            want_pass: bool,
+        }
+
+        let default_ack_msg = dummy_raw_msg_conn_open_ack(5, 5);
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_ack_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Bad connection id, non-alpha".to_string(),
+                raw: RawMsgConnectionOpenAck {
+                    connection_id: "con007".to_string(),
+                    ..default_ack_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad version, missing version".to_string(),
+                raw: RawMsgConnectionOpenAck {
+                    version: None,
+                    ..default_ack_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad proof height, height is 0".to_string(),
+                raw: RawMsgConnectionOpenAck {
+                    proof_height: Some(RawHeight {
+                        revision_number: 1,
+                        revision_height: 0,
+                    }),
+                    ..default_ack_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad consensus height, height is 0".to_string(),
+                raw: RawMsgConnectionOpenAck {
+                    consensus_height: Some(RawHeight {
+                        revision_number: 1,
+                        revision_height: 0,
+                    }),
+                    ..default_ack_msg
+                },
+                want_pass: false,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let msg = MsgConnectionOpenAck::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgConnOpenAck::new failed for test {}, \nmsg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_conn_open_ack(5, 6);
+        let msg = MsgConnectionOpenAck::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgConnectionOpenAck::from(msg.clone());
+        let msg_back = MsgConnectionOpenAck::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
new file mode 100644
index 000000000..151ab7e37
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
@@ -0,0 +1,93 @@
+use ibc::core::client::types::proto::v1::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenConfirm;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
+use ibc::primitives::prelude::*;
+
+use crate::fixtures::core::channel::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+/// Returns a dummy `MsgConnectionOpenConfirm` for testing purposes only!
+pub fn dummy_conn_open_confirm() -> MsgConnectionOpenConfirm {
+    MsgConnectionOpenConfirm::try_from(dummy_raw_msg_conn_open_confirm()).expect("Never fails")
+}
+
+/// Returns a dummy `RawMsgConnectionOpenConfirm` for testing purposes only!
+pub fn dummy_raw_msg_conn_open_confirm() -> RawMsgConnectionOpenConfirm {
+    RawMsgConnectionOpenConfirm {
+        connection_id: "srcconnection".to_string(),
+        proof_ack: dummy_proof(),
+        proof_height: Some(Height {
+            revision_number: 0,
+            revision_height: 10,
+        }),
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn parse_connection_open_confirm_msg() {
+        #[derive(Clone, Debug, PartialEq)]
+        struct Test {
+            name: String,
+            raw: RawMsgConnectionOpenConfirm,
+            want_pass: bool,
+        }
+
+        let default_ack_msg = dummy_raw_msg_conn_open_confirm();
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_ack_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Bad connection id, non-alpha".to_string(),
+                raw: RawMsgConnectionOpenConfirm {
+                    connection_id: "con007".to_string(),
+                    ..default_ack_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad proof height, height is 0".to_string(),
+                raw: RawMsgConnectionOpenConfirm {
+                    proof_height: Some(Height {
+                        revision_number: 1,
+                        revision_height: 0,
+                    }),
+                    ..default_ack_msg
+                },
+                want_pass: false,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let msg = MsgConnectionOpenConfirm::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgConnOpenTry::new failed for test {}, \nmsg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_conn_open_confirm();
+        let msg = MsgConnectionOpenConfirm::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgConnectionOpenConfirm::from(msg.clone());
+        let msg_back = MsgConnectionOpenConfirm::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
new file mode 100644
index 000000000..07302e0de
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
@@ -0,0 +1,192 @@
+use ibc::core::connection::types::msgs::MsgConnectionOpenInit;
+use ibc::core::connection::types::proto::v1::{
+    MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
+};
+use ibc::core::connection::types::version::Version;
+use ibc::core::connection::types::Counterparty;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_raw_counterparty_conn;
+use crate::fixtures::core::signer::dummy_bech32_account;
+
+pub fn raw_version_from_identifier(identifier: &str) -> Option<RawVersion> {
+    if identifier.is_empty() {
+        return None;
+    }
+
+    Some(RawVersion {
+        identifier: identifier.to_string(),
+        features: vec![],
+    })
+}
+
+/// Returns a dummy `MsgConnectionOpenInit` for testing purposes only!
+pub fn dummy_msg_conn_open_init() -> MsgConnectionOpenInit {
+    MsgConnectionOpenInit::try_from(dummy_raw_msg_conn_open_init()).expect("Never fails")
+}
+
+/// Setter for `client_id`. Amenable to chaining, since it consumes the input message.
+pub fn dummy_msg_conn_open_init_with_client_id(
+    msg: MsgConnectionOpenInit,
+    client_id: ClientId,
+) -> MsgConnectionOpenInit {
+    MsgConnectionOpenInit {
+        client_id_on_a: client_id,
+        ..msg
+    }
+}
+
+/// Setter for `counterparty`. Amenable to chaining, since it consumes the input message.
+pub fn msg_conn_open_init_with_counterparty_conn_id(
+    msg: MsgConnectionOpenInit,
+    counterparty_conn_id: u64,
+) -> MsgConnectionOpenInit {
+    let counterparty =
+        Counterparty::try_from(dummy_raw_counterparty_conn(Some(counterparty_conn_id)))
+            .expect("Never fails");
+    MsgConnectionOpenInit {
+        counterparty,
+        ..msg
+    }
+}
+
+/// Setter for the connection `version`
+pub fn msg_conn_open_with_version(
+    msg: MsgConnectionOpenInit,
+    identifier: Option<&str>,
+) -> MsgConnectionOpenInit {
+    let version = match identifier {
+        Some(v) => Version::try_from(RawVersion {
+            identifier: v.to_string(),
+            features: vec![],
+        })
+        .expect("could not create version from identifier")
+        .into(),
+        None => None,
+    };
+    MsgConnectionOpenInit { version, ..msg }
+}
+
+/// Returns a dummy `RawMsgConnectionOpenInit`, for testing purposes only!
+pub fn dummy_raw_msg_conn_open_init() -> RawMsgConnectionOpenInit {
+    RawMsgConnectionOpenInit {
+        client_id: ClientId::default().to_string(),
+        counterparty: Some(dummy_raw_counterparty_conn(None)),
+        version: Some(Version::default().into()),
+        delay_period: 0,
+        signer: dummy_bech32_account(),
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::connection::types::proto::v1::Counterparty as RawCounterparty;
+
+    use super::*;
+
+    #[test]
+    fn parse_connection_open_init_msg() {
+        #[derive(Clone, Debug, PartialEq)]
+        struct Test {
+            name: String,
+            raw: RawMsgConnectionOpenInit,
+            want_pass: bool,
+        }
+
+        let default_init_msg = dummy_raw_msg_conn_open_init();
+
+        let tests: Vec<Test> = vec![
+            Test {
+                name: "Good parameters".to_string(),
+                raw: default_init_msg.clone(),
+                want_pass: true,
+            },
+            Test {
+                name: "Bad client id, name too short".to_string(),
+                raw: RawMsgConnectionOpenInit {
+                    client_id: "client".to_string(),
+                    ..default_init_msg.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Bad destination connection id, name too long".to_string(),
+                raw: RawMsgConnectionOpenInit {
+                    counterparty: Some(RawCounterparty {
+                        connection_id:
+                            "abcdefghijksdffjssdkflweldflsfladfsfwjkrekcmmsdfsdfjflddmnopqrstu"
+                                .to_string(),
+                        ..dummy_raw_counterparty_conn(None)
+                    }),
+                    ..default_init_msg
+                },
+                want_pass: false,
+            },
+        ]
+        .into_iter()
+        .collect();
+
+        for test in tests {
+            let msg = MsgConnectionOpenInit::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgConnOpenInit::new failed for test {}, \nmsg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_conn_open_init();
+        let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgConnectionOpenInit::from(msg.clone());
+        let msg_back = MsgConnectionOpenInit::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+
+        // Check if handler sets counterparty connection id to `None`
+        // in case relayer passes `MsgConnectionOpenInit` message with it set to `Some(_)`.
+        let raw_with_counterparty_conn_id_some = dummy_raw_msg_conn_open_init();
+        let msg_with_counterparty_conn_id_some =
+            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some).unwrap();
+        let raw_with_counterparty_conn_id_some_back =
+            RawMsgConnectionOpenInit::from(msg_with_counterparty_conn_id_some.clone());
+        let msg_with_counterparty_conn_id_some_back =
+            MsgConnectionOpenInit::try_from(raw_with_counterparty_conn_id_some_back.clone())
+                .unwrap();
+        assert_eq!(
+            raw_with_counterparty_conn_id_some_back
+                .counterparty
+                .unwrap()
+                .connection_id,
+            "".to_string()
+        );
+        assert_eq!(
+            msg_with_counterparty_conn_id_some,
+            msg_with_counterparty_conn_id_some_back
+        );
+    }
+
+    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh() {
+        let mut raw = dummy_raw_msg_conn_open_init();
+        raw.delay_period = u64::MAX;
+        let msg = MsgConnectionOpenInit::try_from(raw.clone()).unwrap();
+
+        let serialized = borsh::to_vec(&msg).unwrap();
+
+        let msg_deserialized =
+            <MsgConnectionOpenInit as borsh::BorshDeserialize>::try_from_slice(&serialized)
+                .unwrap();
+
+        assert_eq!(msg, msg_deserialized);
+    }
+}
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
new file mode 100644
index 000000000..5780dd928
--- /dev/null
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
@@ -0,0 +1,208 @@
+use ibc::core::client::types::proto::v1::Height as RawHeight;
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::msgs::MsgConnectionOpenTry;
+use ibc::core::connection::types::proto::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
+use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::primitives::prelude::*;
+
+use super::dummy_raw_counterparty_conn;
+use crate::fixtures::core::channel::dummy_proof;
+use crate::fixtures::core::signer::dummy_bech32_account;
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+
+/// Returns a dummy `MsgConnectionOpenTry` for testing purposes only!
+pub fn dummy_msg_conn_open_try(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenTry {
+    MsgConnectionOpenTry::try_from(dummy_raw_msg_conn_open_try(proof_height, consensus_height))
+        .expect("Never fails")
+}
+/// Setter for the `client_id`
+pub fn msg_conn_open_try_with_client_id(
+    msg: MsgConnectionOpenTry,
+    client_id: ClientId,
+) -> MsgConnectionOpenTry {
+    MsgConnectionOpenTry {
+        client_id_on_b: client_id,
+        ..msg
+    }
+}
+
+/// Returns a dummy `RawMsgConnectionOpenTry` with parametrized heights. The parameter
+/// `proof_height` represents the height, on the source chain, at which this chain produced the
+/// proof. Parameter `consensus_height` represents the height of destination chain which a
+/// client on the source chain stores.
+pub fn dummy_raw_msg_conn_open_try(
+    proof_height: u64,
+    consensus_height: u64,
+) -> RawMsgConnectionOpenTry {
+    let client_state_height = Height::new(0, consensus_height).expect("could not create height");
+
+    #[allow(deprecated)]
+    RawMsgConnectionOpenTry {
+        client_id: ClientId::default().to_string(),
+        previous_connection_id: ConnectionId::default().to_string(),
+        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
+        counterparty: Some(dummy_raw_counterparty_conn(Some(0))),
+        delay_period: 0,
+        counterparty_versions: get_compatible_versions()
+            .iter()
+            .map(|v| v.clone().into())
+            .collect(),
+        proof_init: dummy_proof(),
+        proof_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: proof_height,
+        }),
+        proof_consensus: dummy_proof(),
+        consensus_height: Some(RawHeight {
+            revision_number: 0,
+            revision_height: consensus_height,
+        }),
+        proof_client: dummy_proof(),
+        signer: dummy_bech32_account(),
+        host_consensus_state_proof: vec![],
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::connection::types::proto::v1::Counterparty as RawCounterparty;
+
+    use super::*;
+
+    #[test]
+    fn parse_connection_open_try_msg() {
+        #[derive(Clone, Debug, PartialEq)]
+        struct Test {
+            name: String,
+            raw: RawMsgConnectionOpenTry,
+            want_pass: bool,
+        }
+
+        let default_try_msg = dummy_raw_msg_conn_open_try(10, 34);
+
+        let tests: Vec<Test> =
+            vec![
+                Test {
+                    name: "Good parameters".to_string(),
+                    raw: default_try_msg.clone(),
+                    want_pass: true,
+                },
+                Test {
+                    name: "Bad client id, name too short".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        client_id: "client".to_string(),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Bad destination connection id, name too long".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        counterparty: Some(RawCounterparty {
+                            connection_id:
+                            "abcdasdfasdfsdfasfdwefwfsdfsfsfasfwewvxcvdvwgadvaadsefghijklmnopqrstu"
+                                .to_string(),
+                            ..dummy_raw_counterparty_conn(Some(0))
+                        }),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Correct destination client id with lower/upper case and special chars"
+                        .to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        counterparty: Some(RawCounterparty {
+                            client_id: "ClientId_".to_string(),
+                            ..dummy_raw_counterparty_conn(Some(0))
+                        }),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: true,
+                },
+                Test {
+                    name: "Bad counterparty versions, empty versions vec".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        counterparty_versions: Vec::new(),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Bad counterparty versions, empty version string".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        counterparty_versions: Vec::new(),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Bad proof height, height is 0".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        proof_height: Some(RawHeight { revision_number: 1, revision_height: 0 }),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Bad consensus height, height is 0".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        proof_height: Some(RawHeight { revision_number: 1, revision_height: 0 }),
+                        ..default_try_msg.clone()
+                    },
+                    want_pass: false,
+                },
+                Test {
+                    name: "Empty proof".to_string(),
+                    raw: RawMsgConnectionOpenTry {
+                        proof_init: b"".to_vec(),
+                        ..default_try_msg
+                    },
+                    want_pass: false,
+                }
+            ]
+            .into_iter()
+            .collect();
+
+        for test in tests {
+            let msg = MsgConnectionOpenTry::try_from(test.raw.clone());
+
+            assert_eq!(
+                test.want_pass,
+                msg.is_ok(),
+                "MsgConnOpenTry::new failed for test {}, \nmsg {:?} with error {:?}",
+                test.name,
+                test.raw,
+                msg.err(),
+            );
+        }
+    }
+
+    #[test]
+    fn to_and_from() {
+        let raw = dummy_raw_msg_conn_open_try(10, 34);
+        let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
+        let raw_back = RawMsgConnectionOpenTry::from(msg.clone());
+        let msg_back = MsgConnectionOpenTry::try_from(raw_back.clone()).unwrap();
+        assert_eq!(raw, raw_back);
+        assert_eq!(msg, msg_back);
+    }
+
+    /// Test that borsh serialization/deserialization works well with delay periods up to u64::MAX
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh() {
+        let mut raw = dummy_raw_msg_conn_open_try(10, 34);
+        raw.delay_period = u64::MAX;
+        let msg = MsgConnectionOpenTry::try_from(raw.clone()).unwrap();
+
+        let serialized = borsh::to_vec(&msg).unwrap();
+
+        let msg_deserialized =
+            <MsgConnectionOpenTry as borsh::BorshDeserialize>::try_from_slice(&serialized).unwrap();
+
+        assert_eq!(msg, msg_deserialized);
+    }
+}
diff --git a/ibc-testkit/src/utils/dummies/core/connection/mod.rs b/ibc-testkit/src/fixtures/core/connection/mod.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/core/connection/mod.rs
rename to ibc-testkit/src/fixtures/core/connection/mod.rs
diff --git a/ibc-testkit/src/utils/dummies/core/context.rs b/ibc-testkit/src/fixtures/core/context.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/core/context.rs
rename to ibc-testkit/src/fixtures/core/context.rs
diff --git a/ibc-testkit/src/utils/dummies/core/mod.rs b/ibc-testkit/src/fixtures/core/mod.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/core/mod.rs
rename to ibc-testkit/src/fixtures/core/mod.rs
diff --git a/ibc-testkit/src/utils/dummies/core/signer.rs b/ibc-testkit/src/fixtures/core/signer.rs
similarity index 100%
rename from ibc-testkit/src/utils/dummies/core/signer.rs
rename to ibc-testkit/src/fixtures/core/signer.rs
diff --git a/ibc-testkit/src/utils/fixture.rs b/ibc-testkit/src/fixtures/mod.rs
similarity index 91%
rename from ibc-testkit/src/utils/fixture.rs
rename to ibc-testkit/src/fixtures/mod.rs
index 6b3a5eb1a..af14cadb9 100644
--- a/ibc-testkit/src/utils/fixture.rs
+++ b/ibc-testkit/src/fixtures/mod.rs
@@ -1,4 +1,7 @@
-use core::fmt::Debug;
+pub mod applications;
+pub mod clients;
+pub mod core;
+use alloc::fmt::Debug;
 
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::primitives::prelude::*;
diff --git a/ibc-testkit/src/lib.rs b/ibc-testkit/src/lib.rs
index 3b42e390e..1ae269367 100644
--- a/ibc-testkit/src/lib.rs
+++ b/ibc-testkit/src/lib.rs
@@ -12,9 +12,10 @@
 
 extern crate alloc;
 
+#[cfg(feature = "std")]
 extern crate std;
 
+pub mod fixtures;
 pub mod hosts;
 pub mod relayer;
 pub mod testapp;
-pub mod utils;
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index be31e896a..40b44c34a 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -30,6 +30,9 @@ use tracing::debug;
 use typed_builder::TypedBuilder;
 
 use super::client_ctx::{MockClientRecord, PortChannelIdMap};
+use crate::fixtures::clients::tendermint::{
+    dummy_tm_client_state_from_header, ClientStateConfig as TmClientStateConfig,
+};
 use crate::hosts::block::{HostBlock, HostType};
 use crate::relayer::error::RelayerError;
 use crate::testapp::ibc::clients::mock::client_state::{
@@ -38,9 +41,6 @@ use crate::testapp::ibc::clients::mock::client_state::{
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use crate::testapp::ibc::clients::mock::header::MockHeader;
 use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
-use crate::utils::clients::tendermint::{
-    dummy_tm_client_state_from_header, ClientStateConfig as TmClientStateConfig,
-};
 pub const DEFAULT_BLOCK_TIME_SECS: u64 = 3;
 
 /// An object that stores all IBC related data.
@@ -796,9 +796,9 @@ mod tests {
     use test_log::test;
 
     use super::*;
+    use crate::fixtures::core::channel::PacketConfig;
+    use crate::fixtures::core::signer::dummy_bech32_account;
     use crate::testapp::ibc::core::router::MockRouter;
-    use crate::utils::core::channel::PacketConfig;
-    use crate::utils::core::signer::dummy_bech32_account;
 
     #[test]
     fn test_history_manipulation() {
diff --git a/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs b/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
deleted file mode 100644
index 64314696a..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/acknowledgement.rs
+++ /dev/null
@@ -1,26 +0,0 @@
-use ibc::core::channel::types::proto::v1::{
-    MsgAcknowledgement as RawMsgAcknowledgement, Packet as RawPacket,
-};
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-
-use super::{dummy_proof, dummy_raw_packet};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgAcknowledgement`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
-pub fn dummy_raw_msg_acknowledgement(height: u64) -> RawMsgAcknowledgement {
-    dummy_raw_msg_ack_with_packet(dummy_raw_packet(height, 1), height)
-}
-
-pub fn dummy_raw_msg_ack_with_packet(packet: RawPacket, height: u64) -> RawMsgAcknowledgement {
-    RawMsgAcknowledgement {
-        packet: Some(packet),
-        acknowledgement: dummy_proof(),
-        proof_acked: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
deleted file mode 100644
index 1ee818729..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_close_confirm.rs
+++ /dev/null
@@ -1,21 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
-use ibc::core::client::types::proto::v1::Height;
-use ibc::core::host::types::identifiers::{ChannelId, PortId};
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelCloseConfirm`, for testing purposes only!
-pub fn dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelCloseConfirm {
-    RawMsgChannelCloseConfirm {
-        port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
-        proof_init: dummy_proof(),
-        proof_height: Some(Height {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
deleted file mode 100644
index 9753b02a5..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_close_init.rs
+++ /dev/null
@@ -1,14 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
-use ibc::core::host::types::identifiers::{ChannelId, PortId};
-use ibc::core::primitives::prelude::*;
-
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelCloseInit`, for testing purposes only!
-pub fn dummy_raw_msg_chan_close_init() -> RawMsgChannelCloseInit {
-    RawMsgChannelCloseInit {
-        port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
deleted file mode 100644
index 0436fc1b2..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_open_ack.rs
+++ /dev/null
@@ -1,23 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
-use ibc::core::client::types::proto::v1::Height;
-use ibc::core::host::types::identifiers::{ChannelId, PortId};
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelOpenAck`, for testing purposes only!
-pub fn dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
-    RawMsgChannelOpenAck {
-        port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
-        counterparty_channel_id: ChannelId::default().to_string(),
-        counterparty_version: "".to_string(),
-        proof_try: dummy_proof(),
-        proof_height: Some(Height {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
deleted file mode 100644
index 03c661f6d..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_open_confirm.rs
+++ /dev/null
@@ -1,21 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
-use ibc::core::client::types::proto::v1::Height;
-use ibc::core::host::types::identifiers::{ChannelId, PortId};
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelOpenConfirm`, for testing purposes only!
-pub fn dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
-    RawMsgChannelOpenConfirm {
-        port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
-        proof_ack: dummy_proof(),
-        proof_height: Some(Height {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
deleted file mode 100644
index 090027aba..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_open_init.rs
+++ /dev/null
@@ -1,15 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
-use ibc::core::host::types::identifiers::PortId;
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_raw_channel_end;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelOpenInit`, for testing purposes only!
-pub fn dummy_raw_msg_chan_open_init(counterparty_channel_id: Option<u64>) -> RawMsgChannelOpenInit {
-    RawMsgChannelOpenInit {
-        port_id: PortId::transfer().to_string(),
-        channel: Some(dummy_raw_channel_end(1, counterparty_channel_id)),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs b/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
deleted file mode 100644
index 85a4fa036..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/chan_open_try.rs
+++ /dev/null
@@ -1,24 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
-use ibc::core::client::types::proto::v1::Height;
-use ibc::core::host::types::identifiers::PortId;
-use ibc::core::primitives::prelude::*;
-
-use super::{dummy_proof, dummy_raw_channel_end};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgChannelOpenTry`, for testing purposes only!
-pub fn dummy_raw_msg_chan_open_try(proof_height: u64) -> RawMsgChannelOpenTry {
-    #[allow(deprecated)]
-    RawMsgChannelOpenTry {
-        port_id: PortId::transfer().to_string(),
-        previous_channel_id: "".to_string(),
-        channel: Some(dummy_raw_channel_end(2, Some(0))),
-        counterparty_version: "".to_string(),
-        proof_init: dummy_proof(),
-        proof_height: Some(Height {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/mod.rs b/ibc-testkit/src/utils/dummies/core/channel/mod.rs
deleted file mode 100644
index fad50ad02..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/mod.rs
+++ /dev/null
@@ -1,52 +0,0 @@
-mod acknowledgement;
-mod chan_close_confirm;
-mod chan_close_init;
-mod chan_open_ack;
-mod chan_open_confirm;
-mod chan_open_init;
-mod chan_open_try;
-mod packet;
-mod recv_packet;
-mod timeout;
-mod timeout_on_close;
-
-pub use acknowledgement::*;
-pub use chan_close_confirm::*;
-pub use chan_close_init::*;
-pub use chan_open_ack::*;
-pub use chan_open_confirm::*;
-pub use chan_open_init::*;
-pub use chan_open_try::*;
-use ibc::core::channel::types::proto::v1::{
-    Channel as RawChannel, Counterparty as RawCounterparty,
-};
-use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
-use ibc::core::primitives::prelude::*;
-pub use packet::*;
-pub use recv_packet::*;
-pub use timeout::*;
-pub use timeout_on_close::*;
-
-/// Returns a dummy `RawCounterparty`, for testing purposes only!
-/// Can be optionally parametrized with a specific channel identifier.
-pub fn dummy_raw_counterparty_chan(channel_id: String) -> RawCounterparty {
-    RawCounterparty {
-        port_id: PortId::transfer().to_string(),
-        channel_id,
-    }
-}
-
-/// Returns a dummy `RawChannel`, for testing purposes only!
-pub fn dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel {
-    let channel_id = match channel_id {
-        Some(id) => ChannelId::new(id).to_string(),
-        None => "".to_string(),
-    };
-    RawChannel {
-        state,
-        ordering: 2,
-        counterparty: Some(dummy_raw_counterparty_chan(channel_id)),
-        connection_hops: vec![ConnectionId::default().to_string()],
-        version: "".to_string(), // The version is not validated.
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/packet.rs b/ibc-testkit/src/utils/dummies/core/channel/packet.rs
deleted file mode 100644
index 7682c4200..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/packet.rs
+++ /dev/null
@@ -1,68 +0,0 @@
-use ibc::core::channel::types::packet::Packet;
-use ibc::core::channel::types::proto::v1::Packet as RawPacket;
-use ibc::core::channel::types::timeout::TimeoutHeight;
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-use ibc::core::host::types::identifiers::{ChannelId, PortId, Sequence};
-use ibc::core::primitives::prelude::*;
-use ibc::core::primitives::Timestamp;
-use typed_builder::TypedBuilder;
-
-/// Configuration of the `PacketData` type for building dummy packets.
-#[derive(TypedBuilder, Debug)]
-#[builder(build_method(into = Packet))]
-pub struct PacketConfig {
-    #[builder(default)]
-    pub seq_on_a: Sequence,
-    #[builder(default = PortId::transfer())]
-    pub port_id_on_a: PortId,
-    #[builder(default)]
-    pub chan_id_on_a: ChannelId,
-    #[builder(default = PortId::transfer())]
-    pub port_id_on_b: PortId,
-    #[builder(default)]
-    pub chan_id_on_b: ChannelId,
-    #[builder(default)]
-    pub data: Vec<u8>,
-    #[builder(default)]
-    pub timeout_height_on_b: TimeoutHeight,
-    #[builder(default)]
-    pub timeout_timestamp_on_b: Timestamp,
-}
-
-impl From<PacketConfig> for Packet {
-    fn from(config: PacketConfig) -> Self {
-        Packet {
-            seq_on_a: config.seq_on_a,
-            port_id_on_a: config.port_id_on_a,
-            chan_id_on_a: config.chan_id_on_a,
-            port_id_on_b: config.port_id_on_b,
-            chan_id_on_b: config.chan_id_on_b,
-            data: config.data,
-            timeout_height_on_b: config.timeout_height_on_b,
-            timeout_timestamp_on_b: config.timeout_timestamp_on_b,
-        }
-    }
-}
-
-/// Returns a dummy `RawPacket`, for testing purposes only!
-pub fn dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacket {
-    RawPacket {
-        sequence: 1,
-        source_port: PortId::transfer().to_string(),
-        source_channel: ChannelId::default().to_string(),
-        destination_port: PortId::transfer().to_string(),
-        destination_channel: ChannelId::default().to_string(),
-        data: vec![0],
-        timeout_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: timeout_height,
-        }),
-        timeout_timestamp,
-    }
-}
-
-pub fn dummy_proof() -> Vec<u8> {
-    "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
-        .as_bytes()
-        .to_vec()
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs b/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
deleted file mode 100644
index a758961c4..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/recv_packet.rs
+++ /dev/null
@@ -1,45 +0,0 @@
-use core::ops::Add;
-use core::time::Duration;
-
-use ibc::core::channel::types::msgs::MsgRecvPacket;
-use ibc::core::channel::types::packet::Packet;
-use ibc::core::channel::types::proto::v1::MsgRecvPacket as RawMsgRecvPacket;
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-use ibc::core::client::types::Height;
-use ibc::core::commitment_types::commitment::CommitmentProofBytes;
-use ibc::core::primitives::{Signer, Timestamp};
-
-use super::{dummy_proof, dummy_raw_packet};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-pub fn dummy_msg_recv_packet(
-    packet: Packet,
-    proof_commitment_on_a: CommitmentProofBytes,
-    proof_height_on_a: Height,
-    signer: Signer,
-) -> MsgRecvPacket {
-    MsgRecvPacket {
-        packet,
-        proof_commitment_on_a,
-        proof_height_on_a,
-        signer,
-    }
-}
-
-/// Returns a dummy `RawMsgRecvPacket`, for testing purposes only! The `height`
-/// parametrizes both the proof height as well as the timeout height.
-pub fn dummy_raw_msg_recv_packet(height: u64) -> RawMsgRecvPacket {
-    let timestamp = Timestamp::now().add(Duration::from_secs(9));
-    RawMsgRecvPacket {
-        packet: Some(dummy_raw_packet(
-            height,
-            timestamp.expect("timestamp").nanoseconds(),
-        )),
-        proof_commitment: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: height,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/timeout.rs b/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
deleted file mode 100644
index 1c24f7ec1..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/timeout.rs
+++ /dev/null
@@ -1,24 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgTimeout as RawMsgTimeout;
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-
-use super::{dummy_proof, dummy_raw_packet};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgTimeout`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
-pub fn dummy_raw_msg_timeout(
-    proof_height: u64,
-    timeout_height: u64,
-    timeout_timestamp: u64,
-) -> RawMsgTimeout {
-    RawMsgTimeout {
-        packet: Some(dummy_raw_packet(timeout_height, timeout_timestamp)),
-        proof_unreceived: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        next_sequence_recv: 1,
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs b/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
deleted file mode 100644
index 0aca9f223..000000000
--- a/ibc-testkit/src/utils/dummies/core/channel/timeout_on_close.rs
+++ /dev/null
@@ -1,21 +0,0 @@
-use ibc::core::channel::types::proto::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-
-use super::{dummy_proof, dummy_raw_packet};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgTimeoutOnClose`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
-pub fn dummy_raw_msg_timeout_on_close(height: u64, timeout_timestamp: u64) -> RawMsgTimeoutOnClose {
-    RawMsgTimeoutOnClose {
-        packet: Some(dummy_raw_packet(height, timeout_timestamp)),
-        proof_unreceived: dummy_proof(),
-        proof_close: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: height,
-        }),
-        next_sequence_recv: 1,
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/client/mod.rs b/ibc-testkit/src/utils/dummies/core/client/mod.rs
deleted file mode 100644
index aaacce78c..000000000
--- a/ibc-testkit/src/utils/dummies/core/client/mod.rs
+++ /dev/null
@@ -1,11 +0,0 @@
-#[cfg(feature = "serde")]
-mod msg_create_client;
-#[cfg(feature = "serde")]
-mod msg_update_client;
-mod msg_upgrade_client;
-
-#[cfg(feature = "serde")]
-pub use msg_create_client::*;
-#[cfg(feature = "serde")]
-pub use msg_update_client::*;
-pub use msg_upgrade_client::*;
diff --git a/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs b/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
deleted file mode 100644
index 75bf4fa9f..000000000
--- a/ibc-testkit/src/utils/dummies/core/client/msg_create_client.rs
+++ /dev/null
@@ -1,21 +0,0 @@
-use ibc::clients::tendermint::types::ConsensusState as TmConsensusState;
-use ibc::core::client::types::proto::v1::MsgCreateClient;
-use ibc::primitives::proto::Any;
-
-use crate::utils::dummies::clients::tendermint::{
-    dummy_tendermint_header, dummy_tm_client_state_from_header,
-};
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgCreateClient`, for testing purposes only!
-pub fn dummy_raw_msg_create_client() -> MsgCreateClient {
-    let tm_header = dummy_tendermint_header();
-
-    let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone());
-
-    MsgCreateClient {
-        client_state: Some(Any::from(tm_client_state)),
-        consensus_state: Some(Any::from(TmConsensusState::from(tm_header))),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs b/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
deleted file mode 100644
index 18ca4243e..000000000
--- a/ibc-testkit/src/utils/dummies/core/client/msg_update_client.rs
+++ /dev/null
@@ -1,18 +0,0 @@
-use ibc::core::client::types::proto::v1::MsgUpdateClient;
-use ibc::primitives::proto::Any;
-
-use crate::utils::dummies::clients::tendermint::dummy_ics07_header;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `RawMsgUpdateClient`, for testing purposes only!
-pub fn dummy_raw_msg_update_client() -> MsgUpdateClient {
-    let client_id = "07-tendermint-0".parse().unwrap();
-
-    let tm_header = dummy_ics07_header();
-
-    MsgUpdateClient {
-        client_id,
-        client_message: Some(Any::from(tm_header)),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
deleted file mode 100644
index f0782cae2..000000000
--- a/ibc-testkit/src/utils/dummies/core/connection/conn_open_ack.rs
+++ /dev/null
@@ -1,45 +0,0 @@
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-use ibc::core::client::types::Height;
-use ibc::core::connection::types::msgs::MsgConnectionOpenAck;
-use ibc::core::connection::types::proto::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
-use ibc::core::connection::types::version::Version;
-use ibc::core::host::types::identifiers::ConnectionId;
-use ibc::core::primitives::prelude::*;
-
-use crate::testapp::ibc::clients::mock::client_state::MockClientState;
-use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::utils::dummies::core::channel::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `MsgConnectionOpenAck` with dummy values.
-pub fn dummy_msg_conn_open_ack(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenAck {
-    MsgConnectionOpenAck::try_from(dummy_raw_msg_conn_open_ack(proof_height, consensus_height))
-        .expect("Never fails")
-}
-
-/// Returns a dummy `RawMsgConnectionOpenAck`, for testing purposes only!
-pub fn dummy_raw_msg_conn_open_ack(
-    proof_height: u64,
-    consensus_height: u64,
-) -> RawMsgConnectionOpenAck {
-    let client_state_height = Height::new(0, consensus_height).expect("invalid height");
-    RawMsgConnectionOpenAck {
-        connection_id: ConnectionId::new(0).to_string(),
-        counterparty_connection_id: ConnectionId::new(1).to_string(),
-        proof_try: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        proof_consensus: dummy_proof(),
-        consensus_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: consensus_height,
-        }),
-        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-        proof_client: dummy_proof(),
-        version: Some(Version::default().into()),
-        signer: dummy_bech32_account(),
-        host_consensus_state_proof: vec![],
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
deleted file mode 100644
index 58a0348f9..000000000
--- a/ibc-testkit/src/utils/dummies/core/connection/conn_open_confirm.rs
+++ /dev/null
@@ -1,26 +0,0 @@
-use alloc::string::ToString;
-
-use ibc::core::client::types::proto::v1::Height;
-use ibc::core::connection::types::msgs::MsgConnectionOpenConfirm;
-use ibc::core::connection::types::proto::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
-
-use crate::utils::dummies::core::channel::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `MsgConnectionOpenConfirm` for testing purposes only!
-pub fn dummy_conn_open_confirm() -> MsgConnectionOpenConfirm {
-    MsgConnectionOpenConfirm::try_from(dummy_raw_msg_conn_open_confirm()).expect("Never fails")
-}
-
-/// Returns a dummy `RawMsgConnectionOpenConfirm` for testing purposes only!
-pub fn dummy_raw_msg_conn_open_confirm() -> RawMsgConnectionOpenConfirm {
-    RawMsgConnectionOpenConfirm {
-        connection_id: "srcconnection".to_string(),
-        proof_ack: dummy_proof(),
-        proof_height: Some(Height {
-            revision_number: 0,
-            revision_height: 10,
-        }),
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
deleted file mode 100644
index 24eadd989..000000000
--- a/ibc-testkit/src/utils/dummies/core/connection/conn_open_init.rs
+++ /dev/null
@@ -1,80 +0,0 @@
-use ibc::core::connection::types::msgs::MsgConnectionOpenInit;
-use ibc::core::connection::types::proto::v1::{
-    MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
-};
-use ibc::core::connection::types::version::Version;
-use ibc::core::connection::types::Counterparty;
-use ibc::core::host::types::identifiers::ClientId;
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_raw_counterparty_conn;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-pub fn raw_version_from_identifier(identifier: &str) -> Option<RawVersion> {
-    if identifier.is_empty() {
-        return None;
-    }
-
-    Some(RawVersion {
-        identifier: identifier.to_string(),
-        features: vec![],
-    })
-}
-
-/// Returns a dummy `MsgConnectionOpenInit` for testing purposes only!
-pub fn dummy_msg_conn_open_init() -> MsgConnectionOpenInit {
-    MsgConnectionOpenInit::try_from(dummy_raw_msg_conn_open_init()).expect("Never fails")
-}
-
-/// Setter for `client_id`. Amenable to chaining, since it consumes the input message.
-pub fn dummy_msg_conn_open_init_with_client_id(
-    msg: MsgConnectionOpenInit,
-    client_id: ClientId,
-) -> MsgConnectionOpenInit {
-    MsgConnectionOpenInit {
-        client_id_on_a: client_id,
-        ..msg
-    }
-}
-
-/// Setter for `counterparty`. Amenable to chaining, since it consumes the input message.
-pub fn msg_conn_open_init_with_counterparty_conn_id(
-    msg: MsgConnectionOpenInit,
-    counterparty_conn_id: u64,
-) -> MsgConnectionOpenInit {
-    let counterparty =
-        Counterparty::try_from(dummy_raw_counterparty_conn(Some(counterparty_conn_id)))
-            .expect("Never fails");
-    MsgConnectionOpenInit {
-        counterparty,
-        ..msg
-    }
-}
-
-/// Setter for the connection `version`
-pub fn msg_conn_open_with_version(
-    msg: MsgConnectionOpenInit,
-    identifier: Option<&str>,
-) -> MsgConnectionOpenInit {
-    let version = match identifier {
-        Some(v) => Version::try_from(RawVersion {
-            identifier: v.to_string(),
-            features: vec![],
-        })
-        .expect("could not create version from identifier")
-        .into(),
-        None => None,
-    };
-    MsgConnectionOpenInit { version, ..msg }
-}
-
-/// Returns a dummy `RawMsgConnectionOpenInit`, for testing purposes only!
-pub fn dummy_raw_msg_conn_open_init() -> RawMsgConnectionOpenInit {
-    RawMsgConnectionOpenInit {
-        client_id: ClientId::default().to_string(),
-        counterparty: Some(dummy_raw_counterparty_conn(None)),
-        version: Some(Version::default().into()),
-        delay_period: 0,
-        signer: dummy_bech32_account(),
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs b/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
deleted file mode 100644
index 464e2c7f0..000000000
--- a/ibc-testkit/src/utils/dummies/core/connection/conn_open_try.rs
+++ /dev/null
@@ -1,66 +0,0 @@
-use ibc::core::client::types::proto::v1::Height as RawHeight;
-use ibc::core::client::types::Height;
-use ibc::core::connection::types::msgs::MsgConnectionOpenTry;
-use ibc::core::connection::types::proto::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
-use ibc::core::connection::types::version::get_compatible_versions;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
-use ibc::core::primitives::prelude::*;
-
-use super::dummy_raw_counterparty_conn;
-use crate::testapp::ibc::clients::mock::client_state::MockClientState;
-use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::utils::dummies::core::channel::dummy_proof;
-use crate::utils::dummies::core::signer::dummy_bech32_account;
-
-/// Returns a dummy `MsgConnectionOpenTry` for testing purposes only!
-pub fn dummy_msg_conn_open_try(proof_height: u64, consensus_height: u64) -> MsgConnectionOpenTry {
-    MsgConnectionOpenTry::try_from(dummy_raw_msg_conn_open_try(proof_height, consensus_height))
-        .expect("Never fails")
-}
-/// Setter for the `client_id`
-pub fn msg_conn_open_try_with_client_id(
-    msg: MsgConnectionOpenTry,
-    client_id: ClientId,
-) -> MsgConnectionOpenTry {
-    MsgConnectionOpenTry {
-        client_id_on_b: client_id,
-        ..msg
-    }
-}
-
-/// Returns a dummy `RawMsgConnectionOpenTry` with parametrized heights. The parameter
-/// `proof_height` represents the height, on the source chain, at which this chain produced the
-/// proof. Parameter `consensus_height` represents the height of destination chain which a
-/// client on the source chain stores.
-pub fn dummy_raw_msg_conn_open_try(
-    proof_height: u64,
-    consensus_height: u64,
-) -> RawMsgConnectionOpenTry {
-    let client_state_height = Height::new(0, consensus_height).expect("could not create height");
-
-    #[allow(deprecated)]
-    RawMsgConnectionOpenTry {
-        client_id: ClientId::default().to_string(),
-        previous_connection_id: ConnectionId::default().to_string(),
-        client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-        counterparty: Some(dummy_raw_counterparty_conn(Some(0))),
-        delay_period: 0,
-        counterparty_versions: get_compatible_versions()
-            .iter()
-            .map(|v| v.clone().into())
-            .collect(),
-        proof_init: dummy_proof(),
-        proof_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: proof_height,
-        }),
-        proof_consensus: dummy_proof(),
-        consensus_height: Some(RawHeight {
-            revision_number: 0,
-            revision_height: consensus_height,
-        }),
-        proof_client: dummy_proof(),
-        signer: dummy_bech32_account(),
-        host_consensus_state_proof: vec![],
-    }
-}
diff --git a/ibc-testkit/src/utils/dummies/mod.rs b/ibc-testkit/src/utils/dummies/mod.rs
deleted file mode 100644
index f13a3c645..000000000
--- a/ibc-testkit/src/utils/dummies/mod.rs
+++ /dev/null
@@ -1,3 +0,0 @@
-pub mod applications;
-pub mod clients;
-pub mod core;
diff --git a/ibc-testkit/src/utils/mod.rs b/ibc-testkit/src/utils/mod.rs
deleted file mode 100644
index 35f40c216..000000000
--- a/ibc-testkit/src/utils/mod.rs
+++ /dev/null
@@ -1,5 +0,0 @@
-mod dummies;
-mod fixture;
-
-pub use dummies::*;
-pub use fixture::*;
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index 103dd06c7..fe69a4a05 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -8,6 +8,10 @@ use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::ValidationContext;
+use ibc_testkit::fixtures::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
 };
@@ -15,10 +19,6 @@ use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusStat
 use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::clients::tendermint::{
-    dummy_tendermint_header, dummy_tm_client_state_from_header,
-};
-use ibc_testkit::utils::core::signer::dummy_account_id;
 use test_log::test;
 
 #[test]
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index b629adeed..1011b7a3c 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -20,6 +20,8 @@ use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::{downcast, Timestamp};
 use ibc::primitives::proto::Any;
+use ibc_testkit::fixtures::core::context::MockContextConfig;
+use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::hosts::block::{HostBlock, HostType};
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
@@ -29,8 +31,6 @@ use ibc_testkit::testapp::ibc::clients::mock::misbehaviour::Misbehaviour as Mock
 use ibc_testkit::testapp::ibc::clients::AnyConsensusState;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
-use ibc_testkit::utils::core::context::MockContextConfig;
-use ibc_testkit::utils::core::signer::dummy_account_id;
 use prost::Message;
 use tendermint_testgen::Validator as TestgenValidator;
 use test_log::test;
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index 1f86d410c..6b7b3eff2 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -10,15 +10,15 @@ use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::downcast;
+use ibc_testkit::fixtures::clients::tendermint::{
+    dummy_tendermint_header, dummy_tm_client_state_from_header,
+};
+use ibc_testkit::fixtures::core::client::dummy_msg_upgrade_client;
+use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::clients::tendermint::{
-    dummy_tendermint_header, dummy_tm_client_state_from_header,
-};
-use ibc_testkit::utils::core::client::dummy_msg_upgrade_client;
-use ibc_testkit::utils::{Expect, Fixture};
 
 enum Ctx {
     Default,
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 51617f664..7987f355e 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -13,11 +13,11 @@ use ibc::core::host::types::identifiers::{ChainId, ClientId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::ZERO_DURATION;
+use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_ack;
+use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::connection::dummy_msg_conn_open_ack;
-use ibc_testkit::utils::{Expect, Fixture};
 use test_log::test;
 
 enum Ctx {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index f39417b8a..94321028d 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -11,10 +11,10 @@ use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::ZERO_DURATION;
+use ibc_testkit::fixtures::core::connection::dummy_conn_open_confirm;
+use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::connection::dummy_conn_open_confirm;
-use ibc_testkit::utils::{Expect, Fixture};
 use test_log::test;
 
 enum Ctx {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index 1e78e4dcd..deee41dba 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -7,13 +7,13 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
-use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::connection::{
+use ibc_testkit::fixtures::core::connection::{
     dummy_msg_conn_open_init, msg_conn_open_init_with_counterparty_conn_id,
     msg_conn_open_with_version,
 };
-use ibc_testkit::utils::{Expect, Fixture};
+use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
 use test_log::test;
 
 enum Ctx {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index e1a662c6c..44a5160cc 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -7,11 +7,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ChainId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
+use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_try;
+use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::connection::dummy_msg_conn_open_try;
-use ibc_testkit::utils::{Expect, Fixture};
 use test_log::test;
 
 enum Ctx {
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index 11fed0970..2f5872bfe 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -14,9 +14,9 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_acknowledgement;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_acknowledgement;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index b308a2d29..5e91a7be9 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -11,11 +11,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_confirm;
+use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_confirm;
-use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
 
 #[test]
 fn test_chan_close_confirm_validate() {
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 286a84c15..8ede99523 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -11,11 +11,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_init;
+use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_close_init;
-use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
 
 #[test]
 fn test_chan_close_init_validate() {
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index b5932d227..aec54f2ba 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -12,11 +12,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::primitives::*;
 use ibc::core::router::types::module::ModuleId;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_ack;
+use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_ack;
-use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index 6b3513571..c077c1e9e 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -11,11 +11,11 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId};
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_confirm;
+use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_confirm;
-use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index 590f68e56..8d6b6172f 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -8,10 +8,10 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::ValidationContext;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_init;
+use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_init;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_init;
-use ibc_testkit::utils::core::connection::dummy_msg_conn_open_init;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index 3ebe68460..09db155f7 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -10,11 +10,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_try;
+use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_chan_open_try;
-use ibc_testkit::utils::core::connection::dummy_raw_counterparty_conn;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 90fda5f92..20a7c97ab 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -14,11 +14,11 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::{dummy_msg_recv_packet, dummy_raw_msg_recv_packet};
+use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::relayer::context::RelayerContext;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::{dummy_msg_recv_packet, dummy_raw_msg_recv_packet};
-use ibc_testkit::utils::core::signer::dummy_account_id;
 use rstest::*;
 use test_log::test;
 
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index d3b1fcbc4..2ae01f6cf 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -13,8 +13,8 @@ use ibc::core::connection::types::{
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_packet;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_packet;
 use test_log::test;
 
 #[test]
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index 10cbe83c8..37556b612 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -14,9 +14,9 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout;
 use rstest::*;
 
 struct Fixture {
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 5e7a1b538..9c32642b9 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -13,9 +13,9 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout_on_close;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::core::channel::dummy_raw_msg_timeout_on_close;
 use rstest::*;
 
 pub struct Fixture {
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index 59708282d..68969ba0f 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -20,26 +20,26 @@ use ibc::core::host::types::path::CommitmentPath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::Timestamp;
-use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
-use ibc_testkit::testapp::ibc::clients::mock::client_state::MockClientState;
-use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
-use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
-use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
-use ibc_testkit::utils::applications::transfer::{
+use ibc_testkit::fixtures::applications::transfer::{
     extract_transfer_packet, MsgTransferConfig, PacketDataConfig,
 };
-use ibc_testkit::utils::core::channel::{
+use ibc_testkit::fixtures::core::channel::{
     dummy_raw_msg_ack_with_packet, dummy_raw_msg_chan_close_confirm, dummy_raw_msg_chan_close_init,
     dummy_raw_msg_chan_open_ack, dummy_raw_msg_chan_open_init, dummy_raw_msg_chan_open_try,
     dummy_raw_msg_recv_packet, dummy_raw_msg_timeout_on_close,
 };
-use ibc_testkit::utils::core::client::dummy_msg_upgrade_client;
-use ibc_testkit::utils::core::connection::{
+use ibc_testkit::fixtures::core::client::dummy_msg_upgrade_client;
+use ibc_testkit::fixtures::core::connection::{
     dummy_msg_conn_open_ack, dummy_msg_conn_open_init, dummy_msg_conn_open_init_with_client_id,
     dummy_msg_conn_open_try, msg_conn_open_try_with_client_id,
 };
-use ibc_testkit::utils::core::signer::dummy_account_id;
+use ibc_testkit::fixtures::core::signer::dummy_account_id;
+use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::MockClientState;
+use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
 use primitive_types::U256;
 use test_log::test;
 

From 3703e298a3f408a16892738d3d4696cd24c2380c Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 24 Nov 2023 09:29:11 -0800
Subject: [PATCH 065/182] chore: automate the release process (#984)

* fix: tendermint-types keywords

* feat: add release.yaml to CI

* chore: update RELEASES.md

* add newline at the end of files

* fix: apply reviewer suggestions

* minor fix and lints for release script

* rm braces on individually quoted variables

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .github/workflows/release.yaml                |  27 +++++
 Cargo.toml                                    |   3 +-
 RELEASES.md                                   |  25 ++--
 ibc-clients/ics07-tendermint/types/Cargo.toml |   2 +-
 scripts/release.sh                            | 107 ++++++++++++++++++
 5 files changed, 154 insertions(+), 10 deletions(-)
 create mode 100644 .github/workflows/release.yaml
 create mode 100755 scripts/release.sh

diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
new file mode 100644
index 000000000..160b039da
--- /dev/null
+++ b/.github/workflows/release.yaml
@@ -0,0 +1,27 @@
+# Attempts to perform a release when a particular tag is pushed. This uses the
+# `./scripts/release.sh`, and assumes that the CRATES_TOKEN secret has been set
+# and contains an API token with which we can publish our crates to crates.io.
+#
+# If release operation fails partway through due to a temporary error (e.g. the
+# crate being published depends on the crate published just prior, but the prior
+# crate isn't yet available via crates.io), one can simply rerun this workflow.
+# The release.sh script aims to be an idempotent operation, skipping the
+# publishing of crates that have already been published.
+name: Release
+
+on:
+  push:
+    tags:
+      - "v[0-9]+.[0-9]+.[0-9]+"             # Push events to matching v*, i.e. v0.26.0, v1.0.0
+      - "v[0-9]+.[0-9]+.[0-9]+-pre.[0-9]+"  # e.g. v0.26.0-pre.1
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - name: Publish crates
+        run: ./scripts/release.sh
+        env:
+          CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
diff --git a/Cargo.toml b/Cargo.toml
index c4c0367ee..aabc8d1c8 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -22,10 +22,10 @@ members = [
     "ibc-clients/ics07-tendermint/types",
     "ibc-clients/ics07-tendermint",
     "ibc-clients",
-    "ibc-core/ics24-host/cosmos",
     "ibc-apps/ics20-transfer/types",
     "ibc-apps/ics20-transfer",
     "ibc-apps",
+    "ibc-core/ics24-host/cosmos",
     "ibc-data-types",
     "ibc",
     "ibc-query",
@@ -68,7 +68,6 @@ ibc-core            = { version = "0.48.0", path = "./ibc-core", default-feature
 ibc-clients         = { version = "0.48.0", path = "./ibc-clients", default-features = false }
 ibc-apps            = { version = "0.48.0", path = "./ibc-apps", default-features = false }
 ibc-primitives      = { version = "0.48.0", path = "./ibc-primitives", default-features = false }
-ibc-testkit         = { version = "0.48.0", path = "./ibc-testkit" }
 ibc-derive          = { version = "0.4.0", path = "./ibc-derive" }
 
 ibc-core-client       = { version = "0.48.0", path = "./ibc-core/ics02-client", default-features = false }
diff --git a/RELEASES.md b/RELEASES.md
index 9a584f679..44b0d2f68 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -23,7 +23,7 @@ Our release process is as follows:
    2. Publish `ibc-derive` with `cargo publish -p ibc-derive`
 4. Bump the versions of all crates to the new version in their Cargo.toml and in
    the root `Cargo.toml` as well, and push these changes to the release PR.
-      - If you released a new version of `ibc-derive` in step 3, make sure to
+   - If you released a new version of `ibc-derive` in step 3, make sure to
         update that dependency.
 5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
    the documentation compiles and seems up-to-date and coherent. Fix any
@@ -32,14 +32,25 @@ Our release process is as follows:
    work. Fix any potential issues here and push them to the release PR.
 7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
 8. Once approved, merge the PR, and pull the `main` branch.
-9. Publish each package to crates.io by running `cargo publish -p <PACKAGE_NAME>`
-   in the order specified in the workspace `Cargo.toml`.
-10. Create a signed tag and push it to GitHub: `git tag -s -a vX.Y.Z`. In the
-   tag message, write the version and the link to the corresponding section of
-   the changelog.
-       - Push the tag with `git push --tags`
+9. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
+   version and the link to the corresponding section of the changelog. Then push
+   the tag to GitHub with `git push --tags`.
+   - The [release workflow][release.yml] will run the [`release.sh`] script in a
+   CI worker.
+10. If some crates have not been released, check the cause of the failure and
+   act accordingly:
+    1. In case of intermittent problems with the registry, rerun the script
+      locally to publish any missing crates from this release. This step
+      requires the appropriate privileges to push crates to [crates.io].
+    2. In case the problems arise from the source files, fix them, bump a new
+      patch version (e.g. `v0.48.1`) and repeat the process with its
+      corresponding new tag.
 11. Once the tag is pushed, create a GitHub release and append
    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
    to the release description.
 
 All done! 🎉
+
+[crates.io]: https://crates.io
+[`release.sh`]: https://github.com/cosmos/ibc-rs/blob/main/scripts/release.sh
+[release.yml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yml
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
index 68ec26b55..3676b799c 100644
--- a/ibc-clients/ics07-tendermint/types/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -6,7 +6,7 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20", "types"]
+keywords     = ["blockchain", "cosmos", "ibc", "tendermint", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-07 Tendermint Client data structures and domain types,
diff --git a/scripts/release.sh b/scripts/release.sh
new file mode 100755
index 000000000..d95806fdc
--- /dev/null
+++ b/scripts/release.sh
@@ -0,0 +1,107 @@
+#!/bin/bash
+
+# release.sh will hopefully allow us to publish all of the necessary crates in
+# this repo in the right order. It is assumed that only one person will be
+# releasing all crates at the same time.
+
+set -euo pipefail
+
+# A space-separated list of all the crates we want to publish, in the order in
+# which they must be published. It's important to respect this order, since
+# each subsequent crate depends on one or more of the preceding ones.
+DEFAULT_CRATES=(
+    "ibc-primitives"
+    "ibc-core-host-types"
+    "ibc-core-router-types"
+    "ibc-core-commitment-types"
+    "ibc-core-client-types"
+    "ibc-core-connection-types"
+    "ibc-core-channel-types"
+    "ibc-core-handler-types"
+    "ibc-core-client-context"
+    "ibc-core-host"
+    "ibc-core-router"
+    "ibc-core-client"
+    "ibc-core-connection"
+    "ibc-core-channel"
+    "ibc-core-handler"
+    "ibc-core"
+    "ibc-client-tendermint-types"
+    "ibc-client-tendermint"
+    "ibc-clients"
+    "ibc-app-transfer-types"
+    "ibc-app-transfer"
+    "ibc-apps"
+    "ibc-core-host-cosmos"
+    "ibc-data-types"
+    "ibc"
+    "ibc-query"
+    "ibc-testkit"
+)
+
+# Allows us to override the crates we want to publish.
+CRATES=("${@:-${DEFAULT_CRATES[@]}}")
+
+# Additional flags to pass to the "cargo publish" operation for every crate we
+# publish.
+CARGO_PUBLISH_FLAGS=""
+
+# Allow us to specify a crates.io API token via environment variables. Mostly
+# for CI use.
+if [ "$CRATES_TOKEN" != "" ]; then
+  CARGO_PUBLISH_FLAGS="${CARGO_PUBLISH_FLAGS} --token ${CRATES_TOKEN}"
+fi
+
+get_manifest_path() {
+  cargo metadata --format-version 1 | jq -r '.packages[]|select(.name == "'"${1}"'")|.manifest_path'
+}
+
+get_local_version() {
+  cargo metadata --format-version 1 | jq -r '.packages[]|select(.name == "'"${1}"'")|.version'
+}
+
+check_version_online() {
+  curl -s "https://crates.io/api/v1/crates/${1}" | jq -r 'try .versions[]|select(.num == "'"${2}"'").updated_at'
+}
+
+publish() {
+  echo "Publishing crate $1..."
+  cargo publish --manifest-path "$(get_manifest_path "${1}")" "$CARGO_PUBLISH_FLAGS"
+  echo ""
+}
+
+wait_until_available() {
+  echo "Waiting for crate ${1} to become available via crates.io..."
+  for retry in {1..5}; do
+    sleep 5
+    ONLINE_DATE="$(check_version_online "${1}" "${2}")"
+    if [ "$ONLINE_DATE" != "" ]; then
+      echo "Crate ${crate} is now available online"
+      break
+    else
+      if [ "$retry" == 5 ]; then
+        echo "ERROR: Crate should have become available by now"
+        exit 1
+      else
+        echo "Not available just yet. Waiting a few seconds..."
+      fi
+    fi
+  done
+  echo "Waiting an additional 10 seconds for crate to propagate through CDN..."
+  sleep 10
+}
+
+echo "Attempting to publish crate(s): ${CRATES}"
+
+for crate in "$CRATES"; do
+  VERSION="$(get_local_version "$crate")"
+  ONLINE_DATE="$(check_version_online "$crate" "$VERSION")"
+  echo "${crate} version number: ${VERSION}"
+  if [ "$ONLINE_DATE" != "" ]; then
+    echo "${crate} ${VERSION} has already been published at ${ONLINE_DATE}, skipping"
+    continue
+  fi
+
+  publish "$crate"
+  wait_until_available "$crate" "$VERSION"
+done

From fc25b945345d7e85c66ca1f801b6eb6c13342d7b Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Mon, 27 Nov 2023 00:03:35 +0100
Subject: [PATCH 066/182] chore: fix dependency resolution because of `dep:`
 syntax in `serde` feature (#988)

* chore: fix no_std builds

* Update .changelog/unreleased/bug-fixes/987-serde-json-feature.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* review

---------

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .changelog/unreleased/bug-fixes/987-serde-json-feature.md | 3 +++
 ibc-apps/ics20-transfer/Cargo.toml                        | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/unreleased/bug-fixes/987-serde-json-feature.md

diff --git a/.changelog/unreleased/bug-fixes/987-serde-json-feature.md b/.changelog/unreleased/bug-fixes/987-serde-json-feature.md
new file mode 100644
index 000000000..ee4eed5b0
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/987-serde-json-feature.md
@@ -0,0 +1,3 @@
+- Fix dependency resolution by removing the `dep:` syntax in `serde` feature of
+  `ibc-app-transfer` crate.
+  ([#987](https://github.com/cosmos/ibc-rs/issues/987))
diff --git a/ibc-apps/ics20-transfer/Cargo.toml b/ibc-apps/ics20-transfer/Cargo.toml
index 2e992e718..4d54f2bf6 100644
--- a/ibc-apps/ics20-transfer/Cargo.toml
+++ b/ibc-apps/ics20-transfer/Cargo.toml
@@ -38,7 +38,7 @@ std = [
 serde = [
     "ibc-app-transfer-types/serde",
     "ibc-core/serde",
-    "dep:serde_json"
+    "serde_json"
 ]
 schema = [
     "ibc-app-transfer-types/schema",

From 841ceac397668585698b5b5d7c3e0849584be29b Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 27 Nov 2023 06:26:10 -0800
Subject: [PATCH 067/182] fix: cargo test --no-default-features (#989)

---
 .../bug-fixes/770-fix-cargo-test-no-default-features.md       | 2 ++
 .changelog/unreleased/bug-fixes/987-serde-json-feature.md     | 2 +-
 .github/workflows/rust.yml                                    | 4 ++++
 ibc-testkit/src/fixtures/clients/tendermint.rs                | 2 +-
 ibc-testkit/src/lib.rs                                        | 4 ++--
 ibc-testkit/src/relayer/context.rs                            | 1 -
 ibc-testkit/src/testapp/ibc/core/types.rs                     | 1 -
 ibc-testkit/tests/applications/mod.rs                         | 1 +
 ibc-testkit/tests/core/ics02_client/mod.rs                    | 2 ++
 ibc-testkit/tests/core/mod.rs                                 | 1 +
 10 files changed, 14 insertions(+), 6 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md

diff --git a/.changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md b/.changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md
new file mode 100644
index 000000000..ab687989d
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md
@@ -0,0 +1,2 @@
+- Fix Cargo test failure with `--no-default-features` flag.
+  ([\#770](https://github.com/cosmos/ibc-rs/issues/770))
diff --git a/.changelog/unreleased/bug-fixes/987-serde-json-feature.md b/.changelog/unreleased/bug-fixes/987-serde-json-feature.md
index ee4eed5b0..03b70b888 100644
--- a/.changelog/unreleased/bug-fixes/987-serde-json-feature.md
+++ b/.changelog/unreleased/bug-fixes/987-serde-json-feature.md
@@ -1,3 +1,3 @@
 - Fix dependency resolution by removing the `dep:` syntax in `serde` feature of
   `ibc-app-transfer` crate.
-  ([#987](https://github.com/cosmos/ibc-rs/issues/987))
+  ([\#987](https://github.com/cosmos/ibc-rs/issues/987))
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 6f0e35cd8..d343d327b 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -135,3 +135,7 @@ jobs:
         with:
           command: test
           args: --all-features --no-fail-fast --workspace -- --nocapture
+      - uses: actions-rs/cargo@v1
+        with:
+          command: test
+          args: --no-default-features --no-fail-fast --no-run
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index d64fbd488..03828d78f 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -165,7 +165,7 @@ pub fn dummy_ics07_header() -> Header {
     }
 }
 
-#[cfg(test)]
+#[cfg(all(test, feature = "serde"))]
 mod tests {
 
     use ibc::primitives::proto::Any;
diff --git a/ibc-testkit/src/lib.rs b/ibc-testkit/src/lib.rs
index 1ae269367..b2f737471 100644
--- a/ibc-testkit/src/lib.rs
+++ b/ibc-testkit/src/lib.rs
@@ -1,5 +1,6 @@
-#![cfg_attr(not(test), deny(clippy::unwrap_used))]
 #![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
 #![deny(
     warnings,
     trivial_casts,
@@ -8,7 +9,6 @@
     unused_qualifications,
     rust_2018_idioms
 )]
-#![forbid(unsafe_code)]
 
 extern crate alloc;
 
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index 15faa0d33..4ed1805f1 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -49,7 +49,6 @@ mod tests {
     use ibc::core::client::types::Height;
     use ibc::core::handler::types::msgs::MsgEnvelope;
     use ibc::core::host::types::identifiers::ChainId;
-    use test_log::test;
     use tracing::debug;
 
     use super::RelayerContext;
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index 40b44c34a..e8c6d2972 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -793,7 +793,6 @@ mod tests {
     use ibc::core::primitives::Signer;
     use ibc::core::router::module::Module;
     use ibc::core::router::types::module::{ModuleExtras, ModuleId};
-    use test_log::test;
 
     use super::*;
     use crate::fixtures::core::channel::PacketConfig;
diff --git a/ibc-testkit/tests/applications/mod.rs b/ibc-testkit/tests/applications/mod.rs
index 014e52f27..544cab2c5 100644
--- a/ibc-testkit/tests/applications/mod.rs
+++ b/ibc-testkit/tests/applications/mod.rs
@@ -1 +1,2 @@
+#[cfg(feature = "serde")]
 pub mod transfer;
diff --git a/ibc-testkit/tests/core/ics02_client/mod.rs b/ibc-testkit/tests/core/ics02_client/mod.rs
index acab4918d..1a11ad044 100644
--- a/ibc-testkit/tests/core/ics02_client/mod.rs
+++ b/ibc-testkit/tests/core/ics02_client/mod.rs
@@ -1,3 +1,5 @@
+#[cfg(feature = "serde")]
 pub mod create_client;
 pub mod update_client;
+#[cfg(feature = "serde")]
 pub mod upgrade_client;
diff --git a/ibc-testkit/tests/core/mod.rs b/ibc-testkit/tests/core/mod.rs
index 97dce615a..10f45250e 100644
--- a/ibc-testkit/tests/core/mod.rs
+++ b/ibc-testkit/tests/core/mod.rs
@@ -1,4 +1,5 @@
 pub mod ics02_client;
 pub mod ics03_connection;
 pub mod ics04_channel;
+#[cfg(feature = "serde")]
 pub mod router;

From 3be16b27a7da27254d285364625aa7b0f57a7229 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 27 Nov 2023 07:34:06 -0800
Subject: [PATCH 068/182] Release v0.48.1 (#990)

* fix: cargo test --no-default-features

* chore: update changelog and summary

* deps: bump ibc-rs version

* chore: remove redundant ibc_primitive re-export from router

* chore: add note for ibc-testkit no_std support
---
 .../770-fix-cargo-test-no-default-features.md |  0
 .../bug-fixes/987-serde-json-feature.md       |  0
 .changelog/v0.48.1/summary.md                 |  4 ++
 CHANGELOG.md                                  | 17 +++++++
 Cargo.toml                                    | 50 +++++++++----------
 ci/cw-check/Cargo.lock                        | 48 +++++++++---------
 ci/no-std-check/Cargo.lock                    | 48 +++++++++---------
 ibc-core/ics26-routing/types/src/lib.rs       |  6 +--
 ibc-testkit/README.md                         |  3 ++
 9 files changed, 98 insertions(+), 78 deletions(-)
 rename .changelog/{unreleased => v0.48.1}/bug-fixes/770-fix-cargo-test-no-default-features.md (100%)
 rename .changelog/{unreleased => v0.48.1}/bug-fixes/987-serde-json-feature.md (100%)
 create mode 100644 .changelog/v0.48.1/summary.md

diff --git a/.changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md b/.changelog/v0.48.1/bug-fixes/770-fix-cargo-test-no-default-features.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/770-fix-cargo-test-no-default-features.md
rename to .changelog/v0.48.1/bug-fixes/770-fix-cargo-test-no-default-features.md
diff --git a/.changelog/unreleased/bug-fixes/987-serde-json-feature.md b/.changelog/v0.48.1/bug-fixes/987-serde-json-feature.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/987-serde-json-feature.md
rename to .changelog/v0.48.1/bug-fixes/987-serde-json-feature.md
diff --git a/.changelog/v0.48.1/summary.md b/.changelog/v0.48.1/summary.md
new file mode 100644
index 000000000..72df2fc53
--- /dev/null
+++ b/.changelog/v0.48.1/summary.md
@@ -0,0 +1,4 @@
+This patch release eliminates the `dep:` syntax from the `serde` feature,
+addressing potential dependency resolution issue stemming from Rust v1.70.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 005143b9e..be0d56533 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,22 @@
 # CHANGELOG
 
+## v0.48.1
+
+*November 27, 2023*
+
+This patch release eliminates the `dep:` syntax from the `serde` feature,
+addressing potential dependency resolution issue stemming from Rust v1.70.
+
+There are no consensus-breaking changes.
+
+### BUG FIXES
+
+- Fix Cargo test failure with `--no-default-features` flag.
+  ([\#770](https://github.com/cosmos/ibc-rs/issues/770))
+- Fix dependency resolution by removing the `dep:` syntax in `serde` feature of
+  `ibc-app-transfer` crate.
+  ([\#987](https://github.com/cosmos/ibc-rs/issues/987))
+
 ## v0.48.0
 
 *November 22, 2023*
diff --git a/Cargo.toml b/Cargo.toml
index aabc8d1c8..4f98ba81c 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -37,7 +37,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.48.0"
+version      = "0.48.1"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -63,33 +63,33 @@ subtle-encoding     = { version = "0.5", default-features = false }
 time                = { version = ">=0.3.0, <0.3.31", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.48.0", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.48.0", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.48.0", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.48.0", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.48.0", path = "./ibc-primitives", default-features = false }
+ibc                 = { version = "0.48.1", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.48.1", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.48.1", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.48.1", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.48.1", path = "./ibc-primitives", default-features = false }
 ibc-derive          = { version = "0.4.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.48.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.48.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.48.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.48.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.48.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.48.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.48.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.48.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-core-client       = { version = "0.48.1", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.48.1", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.48.1", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.48.1", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.48.1", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.48.1", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.48.1", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.48.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.48.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.48.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.48.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.48.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.48.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.48.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.48.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.48.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.48.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.48.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.48.1", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.48.1", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.48.1", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.48.1", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.48.1", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.48.1", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.48.1", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.48.1", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.48.1", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.48.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.38.0", default-features = false }
 ics23     = { version = "0.11", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index a9c9685a3..3a32eebf2 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -613,7 +613,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -625,7 +625,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -634,7 +634,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -649,14 +649,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -672,7 +672,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "bytes",
  "displaydoc",
@@ -692,14 +692,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -713,7 +713,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -728,7 +728,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -749,7 +749,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -762,7 +762,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -779,7 +779,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -797,7 +797,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -813,7 +813,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -825,7 +825,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -844,7 +844,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -858,7 +858,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -880,7 +880,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -898,7 +898,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -923,7 +923,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -935,7 +935,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -949,7 +949,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -977,7 +977,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index d0f8b0fee..6ab592ccc 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1213,7 +1213,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1225,7 +1225,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1234,7 +1234,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1247,14 +1247,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -1270,7 +1270,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "bytes",
  "displaydoc",
@@ -1288,14 +1288,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1309,7 +1309,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1324,7 +1324,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1343,7 +1343,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1356,7 +1356,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1373,7 +1373,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1389,7 +1389,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1403,7 +1403,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1415,7 +1415,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1432,7 +1432,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1446,7 +1446,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1466,7 +1466,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1484,7 +1484,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1507,7 +1507,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1517,7 +1517,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1531,7 +1531,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1557,7 +1557,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.0"
+version = "0.48.1"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ibc-core/ics26-routing/types/src/lib.rs b/ibc-core/ics26-routing/types/src/lib.rs
index 6ca759f79..78d5fd12b 100644
--- a/ibc-core/ics26-routing/types/src/lib.rs
+++ b/ibc-core/ics26-routing/types/src/lib.rs
@@ -1,7 +1,7 @@
 #![no_std]
 #![forbid(unsafe_code)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
-#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types,))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
 #![deny(
     warnings,
     trivial_numeric_casts,
@@ -18,7 +18,3 @@ extern crate std;
 pub mod error;
 pub mod event;
 pub mod module;
-
-pub mod primitives {
-    pub use ibc_primitives::*;
-}
diff --git a/ibc-testkit/README.md b/ibc-testkit/README.md
index 31715e9c6..75f01e5d4 100644
--- a/ibc-testkit/README.md
+++ b/ibc-testkit/README.md
@@ -5,3 +5,6 @@ implementations, fulfilling a dual role of enabling rigorous integration testing
 for the [`ibc-rs`](https://github.com/cosmos/ibc-rs) implementation while also
 aiding host chains in addressing a broad spectrum of testing scenarios during
 their integrations with `ibc-rs`.
+
+- Note: `ibc-testkit` currently only supports `std` environments. See this
+  [issue](https://github.com/cosmos/ibc-rs/issues/329) for more details.

From 8f2ddfefbeb7988bacc27dc6ab64ba7bcd537ce3 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Mon, 27 Nov 2023 17:40:27 +0100
Subject: [PATCH 069/182] feat: optimize `IdentifierError` variants (#942)

* remove ContainsSeparator

* remove length

* remove Empty

* changelog

* update changelog entry

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
---
 .../breaking-changes/978-identifier-error.md        |  2 ++
 ibc-core/ics24-host/types/src/error.rs              | 13 ++-----------
 ibc-core/ics24-host/types/src/validate.rs           |  8 --------
 3 files changed, 4 insertions(+), 19 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/978-identifier-error.md

diff --git a/.changelog/unreleased/breaking-changes/978-identifier-error.md b/.changelog/unreleased/breaking-changes/978-identifier-error.md
new file mode 100644
index 000000000..cd03b558e
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/978-identifier-error.md
@@ -0,0 +1,2 @@
+- Optimize `IdentifierError` variants and make them mutually exclusive.
+  ([\#978](https://github.com/cosmos/ibc-rs/issues/978))
diff --git a/ibc-core/ics24-host/types/src/error.rs b/ibc-core/ics24-host/types/src/error.rs
index 980a3a1c4..4df4c4dd9 100644
--- a/ibc-core/ics24-host/types/src/error.rs
+++ b/ibc-core/ics24-host/types/src/error.rs
@@ -4,15 +4,8 @@ use ibc_primitives::prelude::*;
 #[cfg_attr(feature = "serde", derive(serde::Serialize))]
 #[derive(Debug, Display)]
 pub enum IdentifierError {
-    /// identifier `{id}` cannot contain separator '/'
-    ContainSeparator { id: String },
-    /// identifier `{id}` has invalid length `{length}` must be between `{min}`-`{max}` characters
-    InvalidLength {
-        id: String,
-        length: u64,
-        min: u64,
-        max: u64,
-    },
+    /// identifier `{id}` has invalid length; must be between `{min}` and `{max}` characters
+    InvalidLength { id: String, min: u64, max: u64 },
     /// identifier `{id}` must only contain alphanumeric characters or `.`, `_`, `+`, `-`, `#`, - `[`, `]`, `<`, `>`
     InvalidCharacter { id: String },
     /// identifier prefix `{prefix}` is invalid
@@ -23,8 +16,6 @@ pub enum IdentifierError {
     RevisionNumberOverflow,
     /// String `{value}` cannot be converted to packet sequence, error: `{reason}`
     InvalidStringAsSequence { value: String, reason: String },
-    /// identifier cannot be empty
-    Empty,
 }
 
 #[cfg(feature = "std")]
diff --git a/ibc-core/ics24-host/types/src/validate.rs b/ibc-core/ics24-host/types/src/validate.rs
index 5fb164020..47a92ac72 100644
--- a/ibc-core/ics24-host/types/src/validate.rs
+++ b/ibc-core/ics24-host/types/src/validate.rs
@@ -2,19 +2,12 @@ use ibc_primitives::prelude::*;
 
 use crate::error::IdentifierError as Error;
 
-/// Path separator (ie. forward slash '/')
-const PATH_SEPARATOR: char = '/';
 const VALID_SPECIAL_CHARS: &str = "._+-#[]<>";
 
 /// Checks if the identifier only contains valid characters as specified in the
 /// [`ICS-24`](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#paths-identifiers-separators)]
 /// spec.
 pub fn validate_identifier_chars(id: &str) -> Result<(), Error> {
-    // Check identifier does not contain path separators
-    if id.contains(PATH_SEPARATOR) {
-        return Err(Error::ContainSeparator { id: id.into() });
-    }
-
     // Check that the identifier comprises only valid characters:
     // - Alphanumeric
     // - `.`, `_`, `+`, `-`, `#`
@@ -42,7 +35,6 @@ pub fn validate_identifier_length(id: &str, min: u64, max: u64) -> Result<(), Er
     } else {
         Err(Error::InvalidLength {
             id: id.into(),
-            length,
             min,
             max,
         })

From f3066670dd4d4c22e34a3958c03ce6dfbad40d04 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Tue, 28 Nov 2023 13:37:17 -0600
Subject: [PATCH 070/182] deps: update ibc-proto-rs to v0.39.1 (#994)

* Update ibc-proto-rs to v0.39.1

* Update ci/no-std-check to ibc-proto-rs v0.39.1

* Add changelog entry
---
 .../unreleased/993-bump-ibc-proto-rs.md       |  2 +
 Cargo.toml                                    |  2 +-
 ci/no-std-check/Cargo.lock                    | 12 ++---
 ci/no-std-check/Cargo.toml                    |  2 +-
 ibc-query/src/core/channel/query.rs           | 54 ++++++++++++++-----
 ibc-query/src/core/channel/service.rs         | 28 ++++++----
 6 files changed, 70 insertions(+), 30 deletions(-)
 create mode 100644 .changelog/unreleased/993-bump-ibc-proto-rs.md

diff --git a/.changelog/unreleased/993-bump-ibc-proto-rs.md b/.changelog/unreleased/993-bump-ibc-proto-rs.md
new file mode 100644
index 000000000..bc4fa551d
--- /dev/null
+++ b/.changelog/unreleased/993-bump-ibc-proto-rs.md
@@ -0,0 +1,2 @@
+- Bump ibc-proto-rs dependency to v0.39.1.
+  ([\#993](https://github.com/cosmos/ibc-rs/issues/993))
diff --git a/Cargo.toml b/Cargo.toml
index 4f98ba81c..2bfc3974a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -91,7 +91,7 @@ ibc-core-router-types       = { version = "0.48.1", path = "./ibc-core/ics26-rou
 ibc-client-tendermint-types = { version = "0.48.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
 ibc-app-transfer-types      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
-ibc-proto = { version = "0.38.0", default-features = false }
+ibc-proto = { version = "0.39.1", default-features = false }
 ics23     = { version = "0.11", default-features = false }
 
 # cosmos dependencies
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 6ab592ccc..ff8c1e715 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1570,9 +1570,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.38.0"
+version = "0.39.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "93cbf4cbe9e5113cc7c70f3208a7029b2205c629502cbb2ae7ea0a09a97d3005"
+checksum = "c8a8b1356652b9f160f5a010dd6b084675b8a28e163bf2b41ca5abecf27d9701"
 dependencies = [
  "base64 0.21.4",
  "borsh",
@@ -2181,9 +2181,9 @@ dependencies = [
 
 [[package]]
 name = "prost"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f4fdd22f3b9c31b53c060df4a0613a1c7f062d4115a2b984dd15b1858f7e340d"
+checksum = "146c289cda302b98a28d40c8b3b90498d6e526dd24ac2ecea73e4e491685b94a"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -2191,9 +2191,9 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "265baba7fabd416cf5078179f7d2cbeca4ce7a9041111900675ea7c4cb8a4c32"
+checksum = "efb6c9a1dd1def8e2124d17e83a20af56f1570d6c2d2bd9e266ccb768df3840e"
 dependencies = [
  "anyhow",
  "itertools 0.11.0",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 3dd20003e..d62e2a3a8 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,7 +6,7 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.38.0", default-features = false, features = [
+ibc-proto = { version = "0.39.1", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index 5d9e22681..d14a5621c 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -7,7 +7,7 @@ use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
 use ibc::core::host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
-    ReceiptPath, SeqRecvPath,
+    ReceiptPath, SeqRecvPath, SeqSendPath,
 };
 use ibc::core::host::ValidationContext;
 use ibc_proto::google::protobuf::Any;
@@ -17,12 +17,12 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
     QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
-    QueryPacketAcknowledgementRequest, QueryPacketAcknowledgementResponse,
-    QueryPacketAcknowledgementsRequest, QueryPacketAcknowledgementsResponse,
-    QueryPacketCommitmentRequest, QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest,
-    QueryPacketCommitmentsResponse, QueryPacketReceiptRequest, QueryPacketReceiptResponse,
-    QueryUnreceivedAcksRequest, QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest,
-    QueryUnreceivedPacketsResponse,
+    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
+    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
+    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
+    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
+    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
 };
 use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
 
@@ -454,12 +454,40 @@ where
     })
 }
 
-// NOTE: The [previous `query_next_sequence_send`
-// method](https://github.com/cosmos/ibc-rs/blob/a4a5f78405bd3a28c060df6c65438edf0b02e9e2/crates/ibc-query/src/core/channel/query.rs#L472-L504)
-// is currently not present in the generated protobuf from `ibc-go` v0.7.3.
-// However, this method has been reintroduced through [this
-// PR](https://github.com/cosmos/ibc-go/pull/3417) in ibc-go. Once included in a
-// new release, we can implement this method call.
+/// Queries for the next sequence to send for the channel specified
+/// in the `request`.
+pub fn query_next_sequence_send<I>(
+    ibc_ctx: &I,
+    request: &QueryNextSequenceSendRequest,
+) -> Result<QueryNextSequenceSendResponse, QueryError>
+where
+    I: ValidationContext + ProvableContext,
+{
+    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+
+    let port_id = PortId::from_str(request.port_id.as_str())?;
+
+    let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
+
+    let next_sequence_send = ibc_ctx.get_next_sequence_send(&next_seq_send_path)?;
+
+    let current_height = ibc_ctx.host_height()?;
+
+    let proof = ibc_ctx
+        .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
+        .ok_or(QueryError::ProofNotFound {
+            description: format!(
+                "Next sequence send proof not found for channel {}",
+                channel_id
+            ),
+        })?;
+
+    Ok(QueryNextSequenceSendResponse {
+        next_sequence_send: next_sequence_send.into(),
+        proof,
+        proof_height: Some(current_height.into()),
+    })
+}
 
 /// Queries for the next sequence receive associated with a channel
 pub fn query_next_sequence_receive<I>(
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 4aeb18ddc..3279c1b2f 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -14,20 +14,21 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
     QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
-    QueryPacketAcknowledgementRequest, QueryPacketAcknowledgementResponse,
-    QueryPacketAcknowledgementsRequest, QueryPacketAcknowledgementsResponse,
-    QueryPacketCommitmentRequest, QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest,
-    QueryPacketCommitmentsResponse, QueryPacketReceiptRequest, QueryPacketReceiptResponse,
-    QueryUnreceivedAcksRequest, QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest,
-    QueryUnreceivedPacketsResponse,
+    QueryNextSequenceSendRequest, QueryNextSequenceSendResponse, QueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementResponse, QueryPacketAcknowledgementsRequest,
+    QueryPacketAcknowledgementsResponse, QueryPacketCommitmentRequest,
+    QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
+    QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
+    QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
 };
 use tonic::{Request, Response, Status};
 
 use super::{
     query_channel, query_channel_client_state, query_channel_consensus_state, query_channels,
-    query_connection_channels, query_next_sequence_receive, query_packet_acknowledgement,
-    query_packet_acknowledgements, query_packet_commitment, query_packet_commitments,
-    query_packet_receipt, query_unreceived_acks, query_unreceived_packets,
+    query_connection_channels, query_next_sequence_receive, query_next_sequence_send,
+    query_packet_acknowledgement, query_packet_acknowledgements, query_packet_commitment,
+    query_packet_commitments, query_packet_receipt, query_unreceived_acks,
+    query_unreceived_packets,
 };
 use crate::core::context::QueryContext;
 
@@ -183,4 +184,13 @@ where
 
         Ok(Response::new(response))
     }
+
+    async fn next_sequence_send(
+        &self,
+        request: Request<QueryNextSequenceSendRequest>,
+    ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
+        let response = query_next_sequence_send(&self.ibc_context, request.get_ref())?;
+
+        Ok(Response::new(response))
+    }
 }

From 6c7d719ad8f9a958e7ed3a6e0b27a77a1267b42c Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Thu, 30 Nov 2023 15:45:13 -0600
Subject: [PATCH 071/182] imp: streamline Msg trait and rename to ToProto
 (#995)

* Remove Msg::get_sign_bytes method

* Update bounds on Msg trait

* Rename Msg trait to ToProto

* Import prost::Name in ToProto::to_any fn

* Change `impl Msg` implementations

* Define blanket implementation of ToProto

* Rename msg.rs to proto.rs

* Remove `impl ToProto` blocks

* chore: add unclog

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../improvements/993-streamline-msg-trait.md  |  2 ++
 .../ics20-transfer/types/src/msgs/transfer.rs | 10 +-----
 .../types/src/msgs/create_client.rs           | 10 +-----
 .../types/src/msgs/misbehaviour.rs            | 10 +-----
 .../types/src/msgs/update_client.rs           | 10 +-----
 .../types/src/msgs/upgrade_client.rs          | 10 +-----
 .../types/src/msgs/conn_open_ack.rs           | 10 +-----
 .../types/src/msgs/conn_open_confirm.rs       | 10 +-----
 .../types/src/msgs/conn_open_init.rs          | 10 +-----
 .../types/src/msgs/conn_open_try.rs           |  9 +----
 .../types/src/msgs/acknowledgement.rs         | 10 +-----
 .../types/src/msgs/chan_close_confirm.rs      | 10 +-----
 .../types/src/msgs/chan_close_init.rs         | 10 +-----
 .../types/src/msgs/chan_open_ack.rs           | 10 +-----
 .../types/src/msgs/chan_open_confirm.rs       | 10 +-----
 .../types/src/msgs/chan_open_init.rs          | 10 +-----
 .../types/src/msgs/chan_open_try.rs           | 10 +-----
 .../types/src/msgs/recv_packet.rs             | 10 +-----
 .../ics04-channel/types/src/msgs/timeout.rs   | 10 +-----
 .../types/src/msgs/timeout_on_close.rs        | 10 +-----
 ibc-primitives/src/traits/mod.rs              |  4 +--
 ibc-primitives/src/traits/msg.rs              | 23 -------------
 ibc-primitives/src/traits/proto.rs            | 33 +++++++++++++++++++
 23 files changed, 56 insertions(+), 195 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/993-streamline-msg-trait.md
 delete mode 100644 ibc-primitives/src/traits/msg.rs
 create mode 100644 ibc-primitives/src/traits/proto.rs

diff --git a/.changelog/unreleased/improvements/993-streamline-msg-trait.md b/.changelog/unreleased/improvements/993-streamline-msg-trait.md
new file mode 100644
index 000000000..439644449
--- /dev/null
+++ b/.changelog/unreleased/improvements/993-streamline-msg-trait.md
@@ -0,0 +1,2 @@
+- `[ibc-primitives]` streamline `Msg` trait and rename to `ToProto`
+ ([#993](https://github.com/cosmos/ibc-rs/issues/993))
diff --git a/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
index b892f9f40..f100bfb52 100644
--- a/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
+++ b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
@@ -5,7 +5,7 @@ use ibc_core::channel::types::timeout::TimeoutHeight;
 use ibc_core::handler::types::error::ContextError;
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
-use ibc_core::primitives::{Msg, Timestamp};
+use ibc_core::primitives::Timestamp;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::applications::transfer::v1::MsgTransfer as RawMsgTransfer;
 use ibc_proto::Protobuf;
@@ -47,14 +47,6 @@ pub struct MsgTransfer {
     pub timeout_timestamp_on_b: Timestamp,
 }
 
-impl Msg for MsgTransfer {
-    type Raw = RawMsgTransfer;
-
-    fn type_url(&self) -> String {
-        TYPE_URL.to_string()
-    }
-}
-
 impl TryFrom<RawMsgTransfer> for MsgTransfer {
     type Error = TokenTransferError;
 
diff --git a/ibc-core/ics02-client/types/src/msgs/create_client.rs b/ibc-core/ics02-client/types/src/msgs/create_client.rs
index f20353c91..fe6944b3d 100644
--- a/ibc-core/ics02-client/types/src/msgs/create_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/create_client.rs
@@ -1,7 +1,7 @@
 //! Definition of domain type message `MsgCreateClient`.
 
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgCreateClient as RawMsgCreateClient;
 use ibc_proto::Protobuf;
@@ -33,14 +33,6 @@ impl MsgCreateClient {
     }
 }
 
-impl Msg for MsgCreateClient {
-    type Raw = RawMsgCreateClient;
-
-    fn type_url(&self) -> String {
-        CREATE_CLIENT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgCreateClient> for MsgCreateClient {}
 
 impl TryFrom<RawMsgCreateClient> for MsgCreateClient {
diff --git a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
index d33651821..b47be6166 100644
--- a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
+++ b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
@@ -2,7 +2,7 @@
 
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any as ProtoAny;
 use ibc_proto::ibc::core::client::v1::MsgSubmitMisbehaviour as RawMsgSubmitMisbehaviour;
 use ibc_proto::Protobuf;
@@ -27,14 +27,6 @@ pub struct MsgSubmitMisbehaviour {
     pub signer: Signer,
 }
 
-impl Msg for MsgSubmitMisbehaviour {
-    type Raw = RawMsgSubmitMisbehaviour;
-
-    fn type_url(&self) -> String {
-        SUBMIT_MISBEHAVIOUR_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {}
 
 impl TryFrom<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {
diff --git a/ibc-core/ics02-client/types/src/msgs/update_client.rs b/ibc-core/ics02-client/types/src/msgs/update_client.rs
index 0e6a020ad..ace553b40 100644
--- a/ibc-core/ics02-client/types/src/msgs/update_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/update_client.rs
@@ -2,7 +2,7 @@
 
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpdateClient as RawMsgUpdateClient;
 use ibc_proto::Protobuf;
@@ -27,14 +27,6 @@ pub struct MsgUpdateClient {
     pub signer: Signer,
 }
 
-impl Msg for MsgUpdateClient {
-    type Raw = RawMsgUpdateClient;
-
-    fn type_url(&self) -> String {
-        UPDATE_CLIENT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgUpdateClient> for MsgUpdateClient {}
 
 impl TryFrom<RawMsgUpdateClient> for MsgUpdateClient {
diff --git a/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
index cf8ed7506..c3d9a956b 100644
--- a/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/upgrade_client.rs
@@ -6,7 +6,7 @@ use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_commitment_types::error::CommitmentError;
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::MsgUpgradeClient as RawMsgUpgradeClient;
 use ibc_proto::Protobuf;
@@ -38,14 +38,6 @@ pub struct MsgUpgradeClient {
     pub signer: Signer,
 }
 
-impl Msg for MsgUpgradeClient {
-    type Raw = RawMsgUpgradeClient;
-
-    fn type_url(&self) -> String {
-        UPGRADE_CLIENT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgUpgradeClient> for MsgUpgradeClient {}
 
 impl From<MsgUpgradeClient> for RawMsgUpgradeClient {
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
index 462648c88..417e99d4d 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::ConnectionId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
 use ibc_proto::Protobuf;
@@ -44,14 +44,6 @@ pub struct MsgConnectionOpenAck {
     pub proof_consensus_state_of_a: Option<CommitmentProofBytes>,
 }
 
-impl Msg for MsgConnectionOpenAck {
-    type Raw = RawMsgConnectionOpenAck;
-
-    fn type_url(&self) -> String {
-        CONN_OPEN_ACK_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgConnectionOpenAck> for MsgConnectionOpenAck {}
 
 impl TryFrom<RawMsgConnectionOpenAck> for MsgConnectionOpenAck {
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
index 631a31b18..ec4bcce7c 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::ConnectionId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenConfirm as RawMsgConnectionOpenConfirm;
 use ibc_proto::Protobuf;
 
@@ -28,14 +28,6 @@ pub struct MsgConnectionOpenConfirm {
     pub signer: Signer,
 }
 
-impl Msg for MsgConnectionOpenConfirm {
-    type Raw = RawMsgConnectionOpenConfirm;
-
-    fn type_url(&self) -> String {
-        CONN_OPEN_CONFIRM_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgConnectionOpenConfirm> for MsgConnectionOpenConfirm {}
 
 impl TryFrom<RawMsgConnectionOpenConfirm> for MsgConnectionOpenConfirm {
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
index 8a1bbee57..f077945be 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
@@ -2,7 +2,7 @@ use core::time::Duration;
 
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenInit as RawMsgConnectionOpenInit;
 use ibc_proto::Protobuf;
 
@@ -25,14 +25,6 @@ pub struct MsgConnectionOpenInit {
     pub signer: Signer,
 }
 
-impl Msg for MsgConnectionOpenInit {
-    type Raw = RawMsgConnectionOpenInit;
-
-    fn type_url(&self) -> String {
-        CONN_OPEN_INIT_TYPE_URL.to_string()
-    }
-}
-
 /// This module encapsulates the workarounds we need to do to implement
 /// `BorshSerialize` and `BorshDeserialize` on `MsgConnectionOpenInit`
 #[cfg(feature = "borsh")]
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
index 776a46f36..205926738 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
@@ -5,7 +5,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
 use ibc_proto::Protobuf;
@@ -50,13 +50,6 @@ pub struct MsgConnectionOpenTry {
     pub previous_connection_id: String,
 }
 
-impl Msg for MsgConnectionOpenTry {
-    type Raw = RawMsgConnectionOpenTry;
-
-    fn type_url(&self) -> String {
-        CONN_OPEN_TRY_TYPE_URL.to_string()
-    }
-}
 #[allow(deprecated)]
 #[cfg(feature = "borsh")]
 mod borsh_impls {
diff --git a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
index 50cba957e..e37fa6300 100644
--- a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
@@ -1,7 +1,7 @@
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgAcknowledgement as RawMsgAcknowledgement;
 use ibc_proto::Protobuf;
 
@@ -30,14 +30,6 @@ pub struct MsgAcknowledgement {
     pub signer: Signer,
 }
 
-impl Msg for MsgAcknowledgement {
-    type Raw = RawMsgAcknowledgement;
-
-    fn type_url(&self) -> String {
-        ACKNOWLEDGEMENT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgAcknowledgement> for MsgAcknowledgement {}
 
 impl TryFrom<RawMsgAcknowledgement> for MsgAcknowledgement {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
index f69ddf472..c60d3bf5e 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::{ChannelId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseConfirm as RawMsgChannelCloseConfirm;
 use ibc_proto::Protobuf;
 
@@ -29,14 +29,6 @@ pub struct MsgChannelCloseConfirm {
     pub signer: Signer,
 }
 
-impl Msg for MsgChannelCloseConfirm {
-    type Raw = RawMsgChannelCloseConfirm;
-
-    fn type_url(&self) -> String {
-        CHAN_CLOSE_CONFIRM_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelCloseConfirm> for MsgChannelCloseConfirm {}
 
 impl TryFrom<RawMsgChannelCloseConfirm> for MsgChannelCloseConfirm {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
index c92cd5992..2663b4186 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_init.rs
@@ -1,6 +1,6 @@
 use ibc_core_host_types::identifiers::{ChannelId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelCloseInit as RawMsgChannelCloseInit;
 use ibc_proto::Protobuf;
 
@@ -24,14 +24,6 @@ pub struct MsgChannelCloseInit {
     pub signer: Signer,
 }
 
-impl Msg for MsgChannelCloseInit {
-    type Raw = RawMsgChannelCloseInit;
-
-    fn type_url(&self) -> String {
-        CHAN_CLOSE_INIT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelCloseInit> for MsgChannelCloseInit {}
 
 impl TryFrom<RawMsgChannelCloseInit> for MsgChannelCloseInit {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
index 5ef4c5694..432ca92fe 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_ack.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::{ChannelId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenAck as RawMsgChannelOpenAck;
 use ibc_proto::Protobuf;
 
@@ -30,14 +30,6 @@ pub struct MsgChannelOpenAck {
     pub signer: Signer,
 }
 
-impl Msg for MsgChannelOpenAck {
-    type Raw = RawMsgChannelOpenAck;
-
-    fn type_url(&self) -> String {
-        CHAN_OPEN_ACK_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelOpenAck> for MsgChannelOpenAck {}
 
 impl TryFrom<RawMsgChannelOpenAck> for MsgChannelOpenAck {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
index cffc523b8..6070eb1a2 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_confirm.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::{ChannelId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenConfirm as RawMsgChannelOpenConfirm;
 use ibc_proto::Protobuf;
 
@@ -29,14 +29,6 @@ pub struct MsgChannelOpenConfirm {
     pub signer: Signer,
 }
 
-impl Msg for MsgChannelOpenConfirm {
-    type Raw = RawMsgChannelOpenConfirm;
-
-    fn type_url(&self) -> String {
-        CHAN_OPEN_CONFIRM_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelOpenConfirm> for MsgChannelOpenConfirm {}
 
 impl TryFrom<RawMsgChannelOpenConfirm> for MsgChannelOpenConfirm {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
index aa5175eae..7ab3f1598 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_init.rs
@@ -1,6 +1,6 @@
 use ibc_core_host_types::identifiers::{ConnectionId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenInit as RawMsgChannelOpenInit;
 use ibc_proto::Protobuf;
 
@@ -39,14 +39,6 @@ impl MsgChannelOpenInit {
     }
 }
 
-impl Msg for MsgChannelOpenInit {
-    type Raw = RawMsgChannelOpenInit;
-
-    fn type_url(&self) -> String {
-        CHAN_OPEN_INIT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelOpenInit> for MsgChannelOpenInit {}
 
 impl TryFrom<RawMsgChannelOpenInit> for MsgChannelOpenInit {
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
index cb554ee00..4b1d54384 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::{ChannelId, ConnectionId, PortId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgChannelOpenTry as RawMsgChannelOpenTry;
 use ibc_proto::Protobuf;
 
@@ -47,14 +47,6 @@ impl MsgChannelOpenTry {
     }
 }
 
-impl Msg for MsgChannelOpenTry {
-    type Raw = RawMsgChannelOpenTry;
-
-    fn type_url(&self) -> String {
-        CHAN_OPEN_TRY_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgChannelOpenTry> for MsgChannelOpenTry {}
 
 impl TryFrom<RawMsgChannelOpenTry> for MsgChannelOpenTry {
diff --git a/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
index cf4bc4d77..5295e1807 100644
--- a/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/recv_packet.rs
@@ -1,7 +1,7 @@
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgRecvPacket as RawMsgRecvPacket;
 use ibc_proto::Protobuf;
 
@@ -30,14 +30,6 @@ pub struct MsgRecvPacket {
     pub signer: Signer,
 }
 
-impl Msg for MsgRecvPacket {
-    type Raw = RawMsgRecvPacket;
-
-    fn type_url(&self) -> String {
-        RECV_PACKET_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgRecvPacket> for MsgRecvPacket {}
 
 impl TryFrom<RawMsgRecvPacket> for MsgRecvPacket {
diff --git a/ibc-core/ics04-channel/types/src/msgs/timeout.rs b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
index 0404015ab..362630ff0 100644
--- a/ibc-core/ics04-channel/types/src/msgs/timeout.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::Sequence;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgTimeout as RawMsgTimeout;
 use ibc_proto::Protobuf;
 
@@ -29,14 +29,6 @@ pub struct MsgTimeout {
     pub signer: Signer,
 }
 
-impl Msg for MsgTimeout {
-    type Raw = RawMsgTimeout;
-
-    fn type_url(&self) -> String {
-        TIMEOUT_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgTimeout> for MsgTimeout {}
 
 impl TryFrom<RawMsgTimeout> for MsgTimeout {
diff --git a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
index 4b85a87a9..95cdb826d 100644
--- a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
@@ -2,7 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentProofBytes;
 use ibc_core_host_types::identifiers::Sequence;
 use ibc_primitives::prelude::*;
-use ibc_primitives::{Msg, Signer};
+use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
 use ibc_proto::Protobuf;
 
@@ -29,14 +29,6 @@ pub struct MsgTimeoutOnClose {
     pub signer: Signer,
 }
 
-impl Msg for MsgTimeoutOnClose {
-    type Raw = RawMsgTimeoutOnClose;
-
-    fn type_url(&self) -> String {
-        TIMEOUT_ON_CLOSE_TYPE_URL.to_string()
-    }
-}
-
 impl Protobuf<RawMsgTimeoutOnClose> for MsgTimeoutOnClose {}
 
 impl TryFrom<RawMsgTimeoutOnClose> for MsgTimeoutOnClose {
diff --git a/ibc-primitives/src/traits/mod.rs b/ibc-primitives/src/traits/mod.rs
index 9eccbc1ec..d473c3a78 100644
--- a/ibc-primitives/src/traits/mod.rs
+++ b/ibc-primitives/src/traits/mod.rs
@@ -1,3 +1,3 @@
-mod msg;
+mod proto;
 
-pub use msg::*;
+pub use proto::*;
diff --git a/ibc-primitives/src/traits/msg.rs b/ibc-primitives/src/traits/msg.rs
deleted file mode 100644
index 61eeb796a..000000000
--- a/ibc-primitives/src/traits/msg.rs
+++ /dev/null
@@ -1,23 +0,0 @@
-use ibc_proto::google::protobuf::Any;
-
-use crate::prelude::*;
-
-/// Trait to be implemented by all IBC messages
-pub trait Msg: Clone {
-    type Raw: From<Self> + prost::Message;
-
-    /// Unique type identifier for this message, to support encoding to/from `prost_types::Any`.
-    fn type_url(&self) -> String;
-
-    fn get_sign_bytes(self) -> Vec<u8> {
-        let raw_msg: Self::Raw = self.into();
-        prost::Message::encode_to_vec(&raw_msg)
-    }
-
-    fn to_any(self) -> Any {
-        Any {
-            type_url: self.type_url(),
-            value: self.get_sign_bytes(),
-        }
-    }
-}
diff --git a/ibc-primitives/src/traits/proto.rs b/ibc-primitives/src/traits/proto.rs
new file mode 100644
index 000000000..b08589014
--- /dev/null
+++ b/ibc-primitives/src/traits/proto.rs
@@ -0,0 +1,33 @@
+use core::fmt::Display;
+
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::Protobuf;
+
+use crate::prelude::*;
+
+/// Types that implement this trait are able to be converted to
+/// a raw Protobuf `Any` type.
+pub trait ToProto<P>: Protobuf<P>
+where
+    P: From<Self> + prost::Message + prost::Name + Default,
+    <Self as TryFrom<P>>::Error: Display,
+{
+    fn type_url() -> String {
+        P::type_url()
+    }
+
+    fn to_any(self) -> Any {
+        Any {
+            type_url: P::type_url(),
+            value: self.encode_vec(),
+        }
+    }
+}
+
+impl<T, P> ToProto<P> for T
+where
+    T: Protobuf<P>,
+    P: From<Self> + prost::Message + prost::Name + Default,
+    <Self as TryFrom<P>>::Error: Display,
+{
+}

From fe9a26b539b1b6c5ae13fed8ff8efaae8e299acf Mon Sep 17 00:00:00 2001
From: dzmitry-lahoda <dzmitry@lahoda.pro>
Date: Fri, 1 Dec 2023 14:30:14 +0000
Subject: [PATCH 072/182] chore: More rigorous CosmWasm check and upgrade
 dependencies (#992)

* clean up

* remaining

* up

* spelling

* true check

* better nix - features enabled + gh cache integration

* flag

* Update ci/cw-check/Cargo.toml

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: dzmitry-lahoda <dzmitry@lahoda.pro>

* Update ci/cw-check/README.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: dzmitry-lahoda <dzmitry@lahoda.pro>

* Update .changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: dzmitry-lahoda <dzmitry@lahoda.pro>

* Update Cargo.toml

Signed-off-by: dzmitry-lahoda <dzmitry@lahoda.pro>

---------

Signed-off-by: dzmitry-lahoda <dzmitry@lahoda.pro>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 ...-making-cosmwasm-compile-apps-transfers.md |   4 +
 .github/workflows/cw-check.yaml               |  10 +-
 ci/cw-check/Cargo.lock                        | 313 ++++++------------
 ci/cw-check/Cargo.toml                        |  11 +-
 ci/cw-check/README.md                         |   5 +
 ci/cw-check/src/lib.rs                        |   8 +-
 6 files changed, 118 insertions(+), 233 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
 create mode 100644 ci/cw-check/README.md

diff --git a/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md b/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
new file mode 100644
index 000000000..961a043a6
--- /dev/null
+++ b/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
@@ -0,0 +1,4 @@
+- More rigorous CosmWasm check by upgrading dependencies and including `std` and
+  `schema` features for `ibc-core`.
+  ([\#992](https://github.com/cosmos/ibc-rs/pull/992))
+  
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index f4a6a89dc..72e16df29 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -29,14 +29,10 @@ jobs:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v4
-
-      - name: Install Nix
-        uses: cachix/install-nix-action@v22
+      - uses: DeterminateSystems/nix-installer-action@main
+      - uses: DeterminateSystems/magic-nix-cache-action@main
         with:
-          nix_path: nixpkgs=channel:nixos-unstable
-          extra_nix_config: |
-            experimental-features = nix-command flakes
-
+          is_ci : true
       - name: Run cw-check
         run: |
           cd ci/cw-check
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 3a32eebf2..65c2e8007 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -33,9 +33,9 @@ checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
 
 [[package]]
 name = "base16ct"
-version = "0.1.1"
+version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "349a06037c7bf932dd7e7d1f653678b2038b9ad46a74102f1fc7bd7872678cce"
+checksum = "4c7f02d4ea65f2c1853089ffd8d2787bdbc63de2f0d29dedbcf8ccdfa0ccd4cf"
 
 [[package]]
 name = "base64"
@@ -55,6 +55,12 @@ version = "1.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8c3c1a368f70d6cf7302d78f8f7093da241fb8e8807c05cc9e51a125895a6d5b"
 
+[[package]]
+name = "bech32"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d86b93f97252c47b41663388e6d155714a9d0c398b99f1005cbc5f978b29f445"
+
 [[package]]
 name = "block-buffer"
 version = "0.9.0"
@@ -75,9 +81,9 @@ dependencies = [
 
 [[package]]
 name = "bnum"
-version = "0.7.0"
+version = "0.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "845141a4fade3f790628b7daaaa298a25b204fb28907eb54febe5142db6ce653"
+checksum = "ab9008b6bb9fc80b5277f2fe481c09e828743d9151203e804583eb4c9e15b31d"
 
 [[package]]
 name = "byte-slice-cast"
@@ -114,11 +120,12 @@ checksum = "795bc6e66a8e340f075fcf6227e417a2dc976b92b91f3cdc778bb858778b6747"
 
 [[package]]
 name = "cosmwasm-crypto"
-version = "1.3.1"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e272708a9745dad8b591ef8a718571512130f2b39b33e3d7a27c558e3069394"
+checksum = "d8bb3c77c3b7ce472056968c745eb501c440fbc07be5004eba02782c35bfbbe3"
 dependencies = [
  "digest 0.10.7",
+ "ecdsa",
  "ed25519-zebra",
  "k256",
  "rand_core 0.6.4",
@@ -127,18 +134,18 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-derive"
-version = "1.3.1"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "296db6a3caca5283425ae0cf347f4e46999ba3f6620dbea8939a0e00347831ce"
+checksum = "fea73e9162e6efde00018d55ed0061e93a108b5d6ec4548b4f8ce3c706249687"
 dependencies = [
  "syn 1.0.109",
 ]
 
 [[package]]
 name = "cosmwasm-schema"
-version = "1.3.1"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63c337e097a089e5b52b5d914a7ff6613332777f38ea6d9d36e1887cd0baa72e"
+checksum = "0df41ea55f2946b6b43579659eec048cc2f66e8c8e2e3652fc5e5e476f673856"
 dependencies = [
  "cosmwasm-schema-derive",
  "schemars",
@@ -149,9 +156,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-schema-derive"
-version = "1.3.1"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "766cc9e7c1762d8fc9c0265808910fcad755200cd0e624195a491dd885a61169"
+checksum = "43609e92ce1b9368aa951b334dd354a2d0dd4d484931a5f83ae10e12a26c8ba9"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -160,11 +167,12 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-std"
-version = "1.3.1"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb5e05a95fd2a420cca50f4e94eb7e70648dac64db45e90403997ebefeb143bd"
+checksum = "04d6864742e3a7662d024b51a94ea81c9af21db6faea2f9a6d2232bb97c6e53e"
 dependencies = [
- "base64 0.13.1",
+ "base64 0.21.2",
+ "bech32",
  "bnum",
  "cosmwasm-crypto",
  "cosmwasm-derive",
@@ -175,6 +183,7 @@ dependencies = [
  "serde",
  "serde-json-wasm 0.5.1",
  "sha2 0.10.8",
+ "static_assertions",
  "thiserror",
 ]
 
@@ -195,9 +204,9 @@ checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7"
 
 [[package]]
 name = "crypto-bigint"
-version = "0.4.9"
+version = "0.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ef2b4b23cddf68b89b8f8069890e8c270d54e2d5fe1b143820234805e4cb17ef"
+checksum = "0dc92fb57ca44df6db8059111ab3af99a63d5d0f8375d9972e319a379c6bab76"
 dependencies = [
  "generic-array",
  "rand_core 0.6.4",
@@ -228,26 +237,14 @@ dependencies = [
  "zeroize",
 ]
 
-[[package]]
-name = "curve25519-dalek-ng"
-version = "4.1.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1c359b7249347e46fb28804470d071c921156ad62b3eef5d34e2ba867533dec8"
-dependencies = [
- "byteorder",
- "digest 0.9.0",
- "rand_core 0.6.4",
- "subtle-ng",
- "zeroize",
-]
-
 [[package]]
 name = "cw-check"
 version = "0.1.0"
 dependencies = [
  "cosmwasm-schema",
  "cosmwasm-std",
- "ibc",
+ "ibc-apps",
+ "ibc-core",
  "serde-json-wasm 1.0.0",
  "thiserror",
 ]
@@ -287,16 +284,6 @@ dependencies = [
  "syn 2.0.28",
 ]
 
-[[package]]
-name = "der"
-version = "0.6.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1a467a65c5e759bce6e65eaf91cc29f466cdc57cb65777bd646872a8a1fd4de"
-dependencies = [
- "const-oid",
- "zeroize",
-]
-
 [[package]]
 name = "der"
 version = "0.7.7"
@@ -345,6 +332,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
 dependencies = [
  "block-buffer 0.10.4",
+ "const-oid",
  "crypto-common",
  "subtle",
 ]
@@ -368,14 +356,16 @@ checksum = "304e6508efa593091e97a9abbc10f90aa7ca635b6d2784feff3c89d41dd12272"
 
 [[package]]
 name = "ecdsa"
-version = "0.14.8"
+version = "0.16.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "413301934810f597c1d19ca71c8710e99a3f1ba28a0d2ebc01551a2daeea3c5c"
+checksum = "ee27f32b5c5292967d2d4a9d7f1e0b0aed2c15daded5a60300e4abb9d8020bca"
 dependencies = [
- "der 0.6.1",
+ "der",
+ "digest 0.10.7",
  "elliptic-curve",
  "rfc6979",
- "signature 1.6.4",
+ "signature",
+ "spki",
 ]
 
 [[package]]
@@ -384,21 +374,8 @@ version = "2.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5fb04eee5d9d907f29e80ee6b0e78f7e2c82342c63e3580d8c4f69d9d5aad963"
 dependencies = [
- "pkcs8 0.10.2",
- "signature 2.1.0",
-]
-
-[[package]]
-name = "ed25519-consensus"
-version = "2.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3c8465edc8ee7436ffea81d21a019b16676ee3db267aa8d5a8d729581ecf998b"
-dependencies = [
- "curve25519-dalek-ng",
- "hex",
- "rand_core 0.6.4",
- "sha2 0.9.9",
- "zeroize",
+ "pkcs8",
+ "signature",
 ]
 
 [[package]]
@@ -424,18 +401,17 @@ checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
 
 [[package]]
 name = "elliptic-curve"
-version = "0.12.3"
+version = "0.13.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e7bb888ab5300a19b8e5bceef25ac745ad065f3c9f7efc6de1b91958110891d3"
+checksum = "b5e6043086bf7973472e0c7dff2142ea0b680d30e18d9cc40f267efbf222bd47"
 dependencies = [
  "base16ct",
  "crypto-bigint",
- "der 0.6.1",
  "digest 0.10.7",
  "ff",
  "generic-array",
  "group",
- "pkcs8 0.9.0",
+ "pkcs8",
  "rand_core 0.6.4",
  "sec1",
  "subtle",
@@ -448,11 +424,21 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
+[[package]]
+name = "eyre"
+version = "0.6.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "80f656be11ddf91bd709454d15d5bd896fbaf4cc3314e69349e4d1569f5b46cd"
+dependencies = [
+ "indenter",
+ "once_cell",
+]
+
 [[package]]
 name = "ff"
-version = "0.12.1"
+version = "0.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d013fc25338cc558c5c2cfbad646908fb23591e2404481826742b651c9af7160"
+checksum = "ded41244b729663b1e574f1b4fb731469f69f79c17667b5d776b16cda0479449"
 dependencies = [
  "rand_core 0.6.4",
  "subtle",
@@ -473,6 +459,7 @@ version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c606d892c9de11507fa0dcffc116434f94e105d0bbdc4e405b61519464c49d7b"
 dependencies = [
+ "eyre",
  "paste",
 ]
 
@@ -557,6 +544,7 @@ checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
 dependencies = [
  "typenum",
  "version_check",
+ "zeroize",
 ]
 
 [[package]]
@@ -572,9 +560,9 @@ dependencies = [
 
 [[package]]
 name = "group"
-version = "0.12.1"
+version = "0.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5dfbfb3a6cfbd390d5c9564ab283a0349b9b9fcd46a706c1eb10e0db70bfbac7"
+checksum = "f0f9ef7462f7c099f518d754361858f86d8a07af53ba9af0fe635bbccb151a63"
 dependencies = [
  "ff",
  "rand_core 0.6.4",
@@ -611,18 +599,6 @@ dependencies = [
  "digest 0.10.7",
 ]
 
-[[package]]
-name = "ibc"
-version = "0.48.1"
-dependencies = [
- "ibc-apps",
- "ibc-clients",
- "ibc-core",
- "ibc-core-host-cosmos",
- "ibc-derive",
- "ibc-primitives",
-]
-
 [[package]]
 name = "ibc-app-transfer"
 version = "0.48.1"
@@ -643,6 +619,7 @@ dependencies = [
  "parity-scale-codec",
  "primitive-types",
  "scale-info",
+ "schemars",
  "serde",
  "uint",
 ]
@@ -654,49 +631,6 @@ dependencies = [
  "ibc-app-transfer",
 ]
 
-[[package]]
-name = "ibc-client-tendermint"
-version = "0.48.1"
-dependencies = [
- "ibc-client-tendermint-types",
- "ibc-core-client",
- "ibc-core-commitment-types",
- "ibc-core-handler-types",
- "ibc-core-host",
- "ibc-primitives",
- "prost",
- "serde",
- "tendermint",
- "tendermint-light-client-verifier",
-]
-
-[[package]]
-name = "ibc-client-tendermint-types"
-version = "0.48.1"
-dependencies = [
- "bytes",
- "displaydoc",
- "ibc-core-client-types",
- "ibc-core-commitment-types",
- "ibc-core-host-types",
- "ibc-primitives",
- "ibc-proto",
- "parity-scale-codec",
- "prost",
- "scale-info",
- "serde",
- "tendermint",
- "tendermint-light-client-verifier",
- "tendermint-proto",
-]
-
-[[package]]
-name = "ibc-clients"
-version = "0.48.1"
-dependencies = [
- "ibc-client-tendermint",
-]
-
 [[package]]
 name = "ibc-core"
 version = "0.48.1"
@@ -741,6 +675,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "sha2 0.10.8",
  "subtle-encoding",
@@ -790,6 +725,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -807,6 +743,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
 ]
@@ -837,6 +774,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -873,6 +811,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -896,31 +835,6 @@ dependencies = [
  "subtle-encoding",
 ]
 
-[[package]]
-name = "ibc-core-host-cosmos"
-version = "0.48.1"
-dependencies = [
- "derive_more",
- "displaydoc",
- "ibc-app-transfer-types",
- "ibc-client-tendermint",
- "ibc-core-client-context",
- "ibc-core-client-types",
- "ibc-core-commitment-types",
- "ibc-core-connection-types",
- "ibc-core-handler-types",
- "ibc-core-host-types",
- "ibc-primitives",
- "ibc-proto",
- "parity-scale-codec",
- "prost",
- "scale-info",
- "serde",
- "sha2 0.10.8",
- "subtle-encoding",
- "tendermint",
-]
-
 [[package]]
 name = "ibc-core-host-types"
 version = "0.48.1"
@@ -930,6 +844,7 @@ dependencies = [
  "ibc-primitives",
  "parity-scale-codec",
  "scale-info",
+ "schemars",
  "serde",
 ]
 
@@ -960,6 +875,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -985,6 +901,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "tendermint",
  "time",
@@ -1003,6 +920,7 @@ dependencies = [
  "parity-scale-codec",
  "prost",
  "scale-info",
+ "schemars",
  "serde",
  "subtle-encoding",
  "tendermint-proto",
@@ -1051,6 +969,12 @@ dependencies = [
  "syn 1.0.109",
 ]
 
+[[package]]
+name = "indenter"
+version = "0.3.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ce23b50ad8242c51a442f3ff322d56b02f08852c77e4c0b4d3fd684abc89c683"
+
 [[package]]
 name = "indexmap"
 version = "2.0.0"
@@ -1088,14 +1012,16 @@ checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
 
 [[package]]
 name = "k256"
-version = "0.11.6"
+version = "0.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72c1e0b51e7ec0a97369623508396067a486bd0cbed95a2659a4b863d28cfc8b"
+checksum = "3f01b677d82ef7a676aa37e099defd83a28e15687112cafdd112d60236b6115b"
 dependencies = [
  "cfg-if",
  "ecdsa",
  "elliptic-curve",
+ "once_cell",
  "sha2 0.10.8",
+ "signature",
 ]
 
 [[package]]
@@ -1193,24 +1119,14 @@ version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8b870d8c151b6f2fb93e84a13146138f05d02ed11c7e7c54f8826aaaf7c9f184"
 
-[[package]]
-name = "pkcs8"
-version = "0.9.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9eca2c590a5f85da82668fa685c09ce2888b9430e83299debf1f34b65fd4a4ba"
-dependencies = [
- "der 0.6.1",
- "spki 0.6.0",
-]
-
 [[package]]
 name = "pkcs8"
 version = "0.10.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f950b2377845cebe5cf8b5165cb3cc1a5e0fa5cfa3e1f7f55707d8fd82e0a7b7"
 dependencies = [
- "der 0.7.7",
- "spki 0.7.2",
+ "der",
+ "spki",
 ]
 
 [[package]]
@@ -1301,13 +1217,12 @@ dependencies = [
 
 [[package]]
 name = "rfc6979"
-version = "0.3.1"
+version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7743f17af12fa0b03b803ba12cd6a8d9483a587e89c69445e3909655c0b9fabb"
+checksum = "f8dd2a808d456c4a54e300a23e9f5a67e122c3024119acbfd73e3bf664491cb2"
 dependencies = [
- "crypto-bigint",
  "hmac",
- "zeroize",
+ "subtle",
 ]
 
 [[package]]
@@ -1351,9 +1266,9 @@ dependencies = [
 
 [[package]]
 name = "schemars"
-version = "0.8.12"
+version = "0.8.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "02c613288622e5f0c3fdc5dbd4db1c5fbe752746b1d1a56a0630b78fd00de44f"
+checksum = "45a28f4c49489add4ce10783f7911893516f15afe45d015608d41faca6bc4d29"
 dependencies = [
  "dyn-clone",
  "schemars_derive",
@@ -1363,9 +1278,9 @@ dependencies = [
 
 [[package]]
 name = "schemars_derive"
-version = "0.8.12"
+version = "0.8.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "109da1e6b197438deb6db99952990c7f959572794b80ff93707d55a232545e7c"
+checksum = "c767fd6fa65d9ccf9cf026122c1b555f2ef9a4f0cea69da4d7dbc3e258d30967"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1375,14 +1290,14 @@ dependencies = [
 
 [[package]]
 name = "sec1"
-version = "0.3.0"
+version = "0.7.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3be24c1842290c45df0a7bf069e0c268a747ad05a192f2fd7dcfdbc1cba40928"
+checksum = "d3e97a565f76233a6003f9f5c54be1d9c5bdfa3eccfb189469f11ec4901c47dc"
 dependencies = [
  "base16ct",
- "der 0.6.1",
+ "der",
  "generic-array",
- "pkcs8 0.9.0",
+ "pkcs8",
  "subtle",
  "zeroize",
 ]
@@ -1501,30 +1416,14 @@ dependencies = [
  "keccak",
 ]
 
-[[package]]
-name = "signature"
-version = "1.6.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74233d3b3b2f6d4b006dc19dee745e73e2a6bfb6f93607cd3b02bd5b00797d7c"
-dependencies = [
- "digest 0.10.7",
- "rand_core 0.6.4",
-]
-
 [[package]]
 name = "signature"
 version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
-
-[[package]]
-name = "spki"
-version = "0.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "67cf02bbac7a337dc36e4f5a693db6c21e7863f45070f7064577eb4367a3212b"
 dependencies = [
- "base64ct",
- "der 0.6.1",
+ "digest 0.10.7",
+ "rand_core 0.6.4",
 ]
 
 [[package]]
@@ -1534,7 +1433,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9d1e996ef02c474957d681f1b05213dfb0abab947b446a62d37770b23500184a"
 dependencies = [
  "base64ct",
- "der 0.7.7",
+ "der",
 ]
 
 [[package]]
@@ -1564,12 +1463,6 @@ dependencies = [
  "zeroize",
 ]
 
-[[package]]
-name = "subtle-ng"
-version = "2.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "734676eb262c623cec13c3155096e08d1f8f29adce39ba17948b18dad1e54142"
-
 [[package]]
 name = "syn"
 version = "1.0.109"
@@ -1601,7 +1494,6 @@ dependencies = [
  "bytes",
  "digest 0.10.7",
  "ed25519",
- "ed25519-consensus",
  "flex-error",
  "futures",
  "num-traits",
@@ -1612,8 +1504,7 @@ dependencies = [
  "serde_bytes",
  "serde_json",
  "serde_repr",
- "sha2 0.10.8",
- "signature 2.1.0",
+ "signature",
  "subtle",
  "subtle-encoding",
  "tendermint-proto",
@@ -1621,19 +1512,6 @@ dependencies = [
  "zeroize",
 ]
 
-[[package]]
-name = "tendermint-light-client-verifier"
-version = "0.34.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74994da9de4b1144837a367ca2c60c650f5526a7c1a54760a3020959b522e474"
-dependencies = [
- "derive_more",
- "flex-error",
- "serde",
- "tendermint",
- "time",
-]
-
 [[package]]
 name = "tendermint-proto"
 version = "0.34.0"
@@ -1678,6 +1556,7 @@ version = "0.3.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "59e399c068f43a5d116fedaf73b203fa4f9c519f17e2b34f63221d3792f81446"
 dependencies = [
+ "serde",
  "time-core",
  "time-macros",
 ]
@@ -1761,9 +1640,9 @@ dependencies = [
 
 [[package]]
 name = "zeroize"
-version = "1.6.0"
+version = "1.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a0956f1ba7c7909bfb66c2e9e4124ab6f6482560f6628b5aaeba39207c9aad9"
+checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 12d7e8076..f7b3d1769 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -7,11 +7,12 @@ version = "0.1.0"
 crate-type = ["cdylib", "rlib"]
 
 [dependencies]
-ibc = { path = "../../ibc", default_features = false, features = ["serde", "parity-scale-codec"] }
-cosmwasm-std = { version = "1.2.5", default-features = false }
-cosmwasm-schema = { version = "1.2.5", default-features = false }
-serde_json =  { package = "serde-json-wasm", version = "1.0.0", default-features = false }
-thiserror = { version = "*", default-features = false }
+ibc-apps = { path = "../../ibc-apps", default_features = false, features = ["serde", "parity-scale-codec"] }
+ibc-core = { path = "../../ibc-core", features = ["serde", "parity-scale-codec", "schema"] }
+cosmwasm-std = { version = "^1.5.0", default-features = false }
+cosmwasm-schema = { version = "^1.5.0", default-features = false }
+serde_json =  { package = "serde-json-wasm", version = "^1.0.0", default-features = false }
+thiserror = { version = "^1.0", default-features = false }
 
 [profile.release]
 lto = true
diff --git a/ci/cw-check/README.md b/ci/cw-check/README.md
new file mode 100644
index 000000000..0f5ba12cb
--- /dev/null
+++ b/ci/cw-check/README.md
@@ -0,0 +1,5 @@
+# CosmWasm Check
+
+This crate contains a simple CosmWasm contract, which incorporates `ibc-rs`, to ensure the compatibility of `ibc-rs` with the CosmWasm environment.
+
+CosmWasm is `std` targeting `wasm32-unknown-unknown` with `stable` rust which provides precompiled extensions `alloc/core/std` which has only features available in `wasmd` runner and passed `cosmwasm-check` (precompile extensions check and cosmwasm-check are not same set).
diff --git a/ci/cw-check/src/lib.rs b/ci/cw-check/src/lib.rs
index 185e0270f..7ebe4effb 100644
--- a/ci/cw-check/src/lib.rs
+++ b/ci/cw-check/src/lib.rs
@@ -3,10 +3,10 @@ use std::str::FromStr;
 
 use cosmwasm_schema::cw_serde;
 use cosmwasm_std::{DepsMut, Env, MessageInfo, Response};
-use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
-use ibc::apps::transfer::types::packet::PacketData;
-use ibc::apps::transfer::types::{Amount, BaseDenom, PrefixedCoin, PrefixedDenom, TracePath};
-use ibc::core::host::types::identifiers::*;
+use ibc_apps::transfer::types::msgs::transfer::MsgTransfer;
+use ibc_apps::transfer::types::packet::PacketData;
+use ibc_apps::transfer::types::{Amount, BaseDenom, PrefixedCoin, PrefixedDenom, TracePath};
+use ibc_core::host::types::identifiers::*;
 use thiserror::Error;
 
 #[cw_serde]

From 2259108eda5fc5500e9234876f9482280eac44dc Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 1 Dec 2023 08:13:13 -0800
Subject: [PATCH 073/182] imp: minimize prost dependency (#998)

---
 ...992-making-cosmwasm-compile-apps-transfers.md |  4 ----
 .../992-more-rigorous-cosmwasm-check.md          |  3 +++
 .../997-minimize-prost-dependency.md             |  2 ++
 ibc-clients/ics07-tendermint/Cargo.toml          |  2 --
 ibc-clients/ics07-tendermint/src/client_state.rs | 16 +++-------------
 ibc-core/ics02-client/Cargo.toml                 |  5 -----
 ibc-core/ics02-client/context/Cargo.toml         |  2 --
 .../ics02-client/src/handler/update_client.rs    |  4 ++--
 ibc-core/ics02-client/types/src/error.rs         |  2 --
 ibc-core/ics03-connection/Cargo.toml             |  5 -----
 .../src/handler/conn_open_ack.rs                 |  4 ++--
 .../src/handler/conn_open_try.rs                 |  4 ++--
 ibc-core/ics04-channel/Cargo.toml                |  5 -----
 ibc-core/ics04-channel/src/handler/timeout.rs    | 10 +---------
 .../src/handler/timeout_on_close.rs              | 10 +---------
 ibc-core/ics04-channel/types/src/error.rs        |  2 --
 ibc-core/ics24-host/Cargo.toml                   |  2 --
 ibc-core/ics24-host/cosmos/Cargo.toml            |  2 --
 .../ics24-host/types/src/identifiers/sequence.rs | 11 +++++++++++
 ibc-core/ics26-routing/Cargo.toml                |  2 --
 ibc-primitives/src/traits/proto.rs               | 11 +++++++++++
 21 files changed, 38 insertions(+), 70 deletions(-)
 delete mode 100644 .changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
 create mode 100644 .changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
 create mode 100644 .changelog/unreleased/improvements/997-minimize-prost-dependency.md

diff --git a/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md b/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
deleted file mode 100644
index 961a043a6..000000000
--- a/.changelog/unreleased/improvements/992-making-cosmwasm-compile-apps-transfers.md
+++ /dev/null
@@ -1,4 +0,0 @@
-- More rigorous CosmWasm check by upgrading dependencies and including `std` and
-  `schema` features for `ibc-core`.
-  ([\#992](https://github.com/cosmos/ibc-rs/pull/992))
-  
diff --git a/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md b/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
new file mode 100644
index 000000000..7540c8a9d
--- /dev/null
+++ b/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
@@ -0,0 +1,3 @@
+- [`cw-check`] More rigorous CosmWasm check by upgrading dependencies and
+  including `std` and `schema` features for `ibc-core`.
+  ([\#992](https://github.com/cosmos/ibc-rs/pull/992))
diff --git a/.changelog/unreleased/improvements/997-minimize-prost-dependency.md b/.changelog/unreleased/improvements/997-minimize-prost-dependency.md
new file mode 100644
index 000000000..eb5cabc3d
--- /dev/null
+++ b/.changelog/unreleased/improvements/997-minimize-prost-dependency.md
@@ -0,0 +1,2 @@
+- [`ibc-primitives`] Minimize `prost` dependency by introducing `ToVec` trait
+ ([\#997](https://github.com/cosmos/ibc-rs/issues/997))
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index 22a46ae28..a66ab41ba 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -18,7 +18,6 @@ all-features = true
 
 [dependencies]
 # external dependencies
-prost = { workspace = true }
 serde = { workspace = true, optional = true }
 
 # ibc dependencies
@@ -36,7 +35,6 @@ tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"
 [features]
 default = ["std"]
 std = [
-    "prost/std",
     "serde/std",
     "ibc-client-tendermint-types/std",
     "ibc-core-client/std",
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 515ebf627..8797ad3bb 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -33,7 +33,7 @@ use ibc_core_host::types::path::{
 };
 use ibc_core_host::ExecutionContext;
 use ibc_primitives::prelude::*;
-use prost::Message;
+use ibc_primitives::ToVec;
 
 use super::consensus_state::ConsensusState as TmConsensusState;
 use crate::context::{
@@ -169,32 +169,22 @@ impl ClientStateCommon for ClientState {
 
         let last_height = self.latest_height().revision_height();
 
-        let mut client_state_value = Vec::new();
-        upgraded_client_state
-            .encode(&mut client_state_value)
-            .map_err(ClientError::Encode)?;
-
         // Verify the proof of the upgraded client state
         self.verify_membership(
             &upgrade_path_prefix,
             &proof_upgrade_client,
             root,
             Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(last_height)),
-            client_state_value,
+            upgraded_client_state.to_vec(),
         )?;
 
-        let mut cons_state_value = Vec::new();
-        upgraded_consensus_state
-            .encode(&mut cons_state_value)
-            .map_err(ClientError::Encode)?;
-
         // Verify the proof of the upgraded consensus state
         self.verify_membership(
             &upgrade_path_prefix,
             &proof_upgrade_consensus_state,
             root,
             Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(last_height)),
-            cons_state_value,
+            upgraded_consensus_state.to_vec(),
         )?;
 
         Ok(())
diff --git a/ibc-core/ics02-client/Cargo.toml b/ibc-core/ics02-client/Cargo.toml
index 5e82d0736..bcb30f561 100644
--- a/ibc-core/ics02-client/Cargo.toml
+++ b/ibc-core/ics02-client/Cargo.toml
@@ -17,10 +17,6 @@ description  = """
 all-features = true
 
 [dependencies]
-# external dependencies
-prost = { workspace = true }
-
-# ibc dependencies
 ibc-core-client-types     = { workspace = true }
 ibc-core-client-context   = { workspace = true }
 ibc-core-commitment-types = { workspace = true }
@@ -31,7 +27,6 @@ ibc-primitives            = { workspace = true }
 [features]
 default = ["std"]
 std = [
-    "prost/std",
     "ibc-core-client-types/std",
     "ibc-core-client-context/std",
     "ibc-core-commitment-types/std",
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index 3b19788b7..789b53ad8 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -21,7 +21,6 @@ all-features = true
 # external dependencies
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 subtle-encoding = { workspace = true }
 
 # ibc dependencies
@@ -39,7 +38,6 @@ tendermint = { workspace = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "subtle-encoding/std",
     "ibc-core-client-types/std",
     "ibc-core-commitment-types/std",
diff --git a/ibc-core/ics02-client/src/handler/update_client.rs b/ibc-core/ics02-client/src/handler/update_client.rs
index 8970bc527..a9d6862d5 100644
--- a/ibc-core/ics02-client/src/handler/update_client.rs
+++ b/ibc-core/ics02-client/src/handler/update_client.rs
@@ -11,7 +11,7 @@ use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
-use prost::Message;
+use ibc_primitives::ToVec;
 
 pub fn validate<Ctx>(ctx: &Ctx, msg: MsgUpdateOrMisbehaviour) -> Result<(), ContextError>
 where
@@ -108,7 +108,7 @@ where
                     client_state.client_type(),
                     *consensus_height,
                     consensus_heights,
-                    header.encode_to_vec(),
+                    header.to_vec(),
                 ))
             };
             ctx.emit_ibc_event(IbcEvent::Message(MessageEvent::Client))?;
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index ab40103f1..27cf5304b 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -58,8 +58,6 @@ pub enum ClientError {
     MissingRawConsensusState,
     /// invalid client id in the update client message: `{0}`
     InvalidMsgUpdateClientId(IdentifierError),
-    /// encode error: `{0}`
-    Encode(prost::EncodeError),
     /// decode error: `{0}`
     Decode(prost::DecodeError),
     /// invalid client identifier error: `{0}`
diff --git a/ibc-core/ics03-connection/Cargo.toml b/ibc-core/ics03-connection/Cargo.toml
index 56f51110e..f7531db79 100644
--- a/ibc-core/ics03-connection/Cargo.toml
+++ b/ibc-core/ics03-connection/Cargo.toml
@@ -17,10 +17,6 @@ description  = """
 all-features = true
 
 [dependencies]
-# external dependencies
-prost = { workspace = true }
-
-# ibc dependencies
 ibc-core-client           = { workspace = true }
 ibc-core-connection-types = { workspace = true }
 ibc-core-host             = { workspace = true }
@@ -30,7 +26,6 @@ ibc-primitives            = { workspace = true }
 [features]
 default = ["std"]
 std = [
-    "prost/std",
     "ibc-core-client/std",
     "ibc-core-connection-types/std",
     "ibc-core-host/std",
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index af44a4ee9..ca5fdb5fa 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -14,7 +14,7 @@ use ibc_core_host::types::path::{ClientConsensusStatePath, ClientStatePath, Conn
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Protobuf;
-use prost::Message;
+use ibc_primitives::ToVec;
 
 pub fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
 where
@@ -106,7 +106,7 @@ where
                 &msg.proof_client_state_of_a_on_b,
                 consensus_state_of_b_on_a.root(),
                 Path::ClientState(ClientStatePath::new(vars.client_id_on_b())),
-                msg.client_state_of_a_on_b.encode_to_vec(),
+                msg.client_state_of_a_on_b.to_vec(),
             )
             .map_err(|e| ConnectionError::ClientStateVerificationFailure {
                 client_id: vars.client_id_on_b().clone(),
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index 6d70604f9..61bd339a2 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -15,7 +15,7 @@ use ibc_core_host::types::path::{
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Protobuf;
-use prost::Message;
+use ibc_primitives::ToVec;
 
 pub fn validate<Ctx>(ctx_b: &Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
 where
@@ -101,7 +101,7 @@ where
                 &msg.proof_client_state_of_b_on_a,
                 consensus_state_of_a_on_b.root(),
                 Path::ClientState(ClientStatePath::new(client_id_on_a)),
-                msg.client_state_of_b_on_a.encode_to_vec(),
+                msg.client_state_of_b_on_a.to_vec(),
             )
             .map_err(|e| ConnectionError::ClientStateVerificationFailure {
                 client_id: msg.client_id_on_b.clone(),
diff --git a/ibc-core/ics04-channel/Cargo.toml b/ibc-core/ics04-channel/Cargo.toml
index ba955ef67..d2b5edf99 100644
--- a/ibc-core/ics04-channel/Cargo.toml
+++ b/ibc-core/ics04-channel/Cargo.toml
@@ -17,10 +17,6 @@ description  = """
 all-features = true
 
 [dependencies]
-# external dependencies
-prost = { workspace = true }
-
-# ibc dependencies
 ibc-core-client           = { workspace = true }
 ibc-core-connection       = { workspace = true }
 ibc-core-channel-types    = { workspace = true }
@@ -33,7 +29,6 @@ ibc-primitives            = { workspace = true }
 [features]
 default = ["std"]
 std = [
-    "prost/std",
     "ibc-core-client/std",
     "ibc-core-connection/std",
     "ibc-core-channel-types/std",
diff --git a/ibc-core/ics04-channel/src/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
index 28cfd6587..0cfed7c03 100644
--- a/ibc-core/ics04-channel/src/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -15,7 +15,6 @@ use ibc_core_host::types::path::{
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_core_router::module::Module;
 use ibc_primitives::prelude::*;
-use prost::Message;
 
 use super::timeout_on_close;
 
@@ -231,19 +230,12 @@ where
             let seq_recv_path_on_b =
                 SeqRecvPath::new(&msg.packet.port_id_on_b, &msg.packet.chan_id_on_b);
 
-            let mut value = Vec::new();
-            u64::from(msg.packet.seq_on_a)
-                .encode(&mut value)
-                .map_err(|_| PacketError::CannotEncodeSequence {
-                    sequence: msg.packet.seq_on_a,
-                })?;
-
             client_state_of_b_on_a.verify_membership(
                 conn_end_on_a.counterparty().prefix(),
                 &msg.proof_unreceived_on_b,
                 consensus_state_of_b_on_a.root(),
                 Path::SeqRecv(seq_recv_path_on_b),
-                value,
+                msg.packet.seq_on_a.to_vec(),
             )
         } else {
             let receipt_path_on_b = ReceiptPath::new(
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index 641f0483c..c08c0e8d3 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -13,7 +13,6 @@ use ibc_core_host::types::path::{
 use ibc_core_host::ValidationContext;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Protobuf;
-use prost::Message;
 
 pub fn validate<Ctx>(ctx_a: &Ctx, msg: &MsgTimeoutOnClose) -> Result<(), ContextError>
 where
@@ -135,19 +134,12 @@ where
             }
             let seq_recv_path_on_b = SeqRecvPath::new(&packet.port_id_on_b, &packet.chan_id_on_b);
 
-            let mut value = Vec::new();
-            u64::from(packet.seq_on_a).encode(&mut value).map_err(|_| {
-                PacketError::CannotEncodeSequence {
-                    sequence: packet.seq_on_a,
-                }
-            })?;
-
             client_state_of_b_on_a.verify_membership(
                 conn_end_on_a.counterparty().prefix(),
                 &msg.proof_unreceived_on_b,
                 consensus_state_of_b_on_a.root(),
                 Path::SeqRecv(seq_recv_path_on_b),
-                value,
+                packet.seq_on_a.to_vec(),
             )
         } else {
             let receipt_path_on_b = ReceiptPath::new(
diff --git a/ibc-core/ics04-channel/types/src/error.rs b/ibc-core/ics04-channel/types/src/error.rs
index 13e33db9c..652ad0878 100644
--- a/ibc-core/ics04-channel/types/src/error.rs
+++ b/ibc-core/ics04-channel/types/src/error.rs
@@ -164,8 +164,6 @@ pub enum PacketError {
         port_id: PortId,
         channel_id: ChannelId,
     },
-    /// Cannot encode sequence `{sequence}`
-    CannotEncodeSequence { sequence: Sequence },
     /// other error: `{description}`
     Other { description: String },
 }
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index 664d3da23..0726eea08 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -21,7 +21,6 @@ all-features = true
 # external dependencies
 derive_more      = { workspace = true }
 displaydoc       = { workspace = true }
-prost            = { workspace = true }
 subtle-encoding  = { workspace = true }
 
 # ibc dependencies
@@ -41,7 +40,6 @@ rstest = { workspace = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "subtle-encoding/std",
     "ibc-core-client-types/std",
     "ibc-core-client-context/std",
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
index 45a427b81..bbe7d7bb2 100644
--- a/ibc-core/ics24-host/cosmos/Cargo.toml
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true}
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 serde           = { workspace = true, optional = true }
 sha2            = { workspace = true }
 subtle-encoding = { workspace = true }
@@ -50,7 +49,6 @@ scale-info         = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "sha2/std",
     "subtle-encoding/std",
diff --git a/ibc-core/ics24-host/types/src/identifiers/sequence.rs b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
index db6d9c560..ece48903b 100644
--- a/ibc-core/ics24-host/types/src/identifiers/sequence.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
@@ -1,4 +1,5 @@
 use ibc_primitives::prelude::*;
+use ibc_primitives::ToVec;
 
 use crate::error::IdentifierError;
 
@@ -34,16 +35,26 @@ impl core::str::FromStr for Sequence {
 }
 
 impl Sequence {
+    /// Gives the sequence number.
     pub fn value(&self) -> u64 {
         self.0
     }
+
+    /// Returns `true` if the sequence number is zero.
     pub fn is_zero(&self) -> bool {
         self.0 == 0
     }
 
+    /// Increments the sequence number by one.
     pub fn increment(&self) -> Sequence {
         Sequence(self.0 + 1)
     }
+
+    /// Encodes the sequence number into a `Vec<u8>` using
+    /// `prost::Message::encode_to_vec`.
+    pub fn to_vec(&self) -> Vec<u8> {
+        self.0.to_vec()
+    }
 }
 
 impl From<u64> for Sequence {
diff --git a/ibc-core/ics26-routing/Cargo.toml b/ibc-core/ics26-routing/Cargo.toml
index 91e75f476..482bf719d 100644
--- a/ibc-core/ics26-routing/Cargo.toml
+++ b/ibc-core/ics26-routing/Cargo.toml
@@ -20,7 +20,6 @@ all-features = true
 # external dependencies
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 subtle-encoding = { workspace = true }
 
 # ibc dependencies
@@ -33,7 +32,6 @@ ibc-core-router-types  = { workspace = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "subtle-encoding/std",
     "ibc-primitives/std",
     "ibc-core-channel-types/std",
diff --git a/ibc-primitives/src/traits/proto.rs b/ibc-primitives/src/traits/proto.rs
index b08589014..686350b2d 100644
--- a/ibc-primitives/src/traits/proto.rs
+++ b/ibc-primitives/src/traits/proto.rs
@@ -31,3 +31,14 @@ where
     <Self as TryFrom<P>>::Error: Display,
 {
 }
+
+/// Convenient trait for converting types to a raw Protobuf `Vec<u8>`.
+pub trait ToVec {
+    fn to_vec(&self) -> Vec<u8>;
+}
+
+impl<T: prost::Message> ToVec for T {
+    fn to_vec(&self) -> Vec<u8> {
+        self.encode_to_vec()
+    }
+}

From eafdd300727ebc310b2189406cd0bc50f94d2c67 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 1 Dec 2023 21:16:16 -0800
Subject: [PATCH 074/182] imp: further minimization of `prost` imports (#1000)

* imp: further minimizing prost imports

* fix: merkle proof extraction in ics07

* chore: update Cargo.lock

* chore: clean ups

* chore: touch ups
---
 .../997-minimize-prost-dependency.md          |  5 ++++
 .../997-minimize-prost-dependency.md          |  2 --
 Cargo.toml                                    |  6 -----
 ci/cw-check/Cargo.lock                        | 25 +++++--------------
 ci/no-std-check/Cargo.lock                    | 16 ------------
 ibc-apps/ics20-transfer/types/Cargo.toml      | 16 ++++++------
 ibc-apps/ics20-transfer/types/src/lib.rs      |  5 ++--
 .../ics07-tendermint/src/client_state.rs      | 11 +++-----
 ibc-clients/ics07-tendermint/types/Cargo.toml |  4 ---
 .../types/src/client_state.rs                 | 19 ++++++--------
 .../types/src/consensus_state.rs              | 19 ++++++--------
 .../ics07-tendermint/types/src/error.rs       |  3 ---
 .../ics07-tendermint/types/src/header.rs      | 16 ++++++------
 .../types/src/misbehaviour.rs                 | 19 ++++++--------
 ibc-core/ics02-client/types/Cargo.toml        |  2 --
 ibc-core/ics02-client/types/src/error.rs      |  2 --
 ibc-core/ics03-connection/types/Cargo.toml    |  2 --
 ibc-core/ics04-channel/types/Cargo.toml       |  2 --
 ibc-core/ics23-commitment/types/Cargo.toml    |  6 ++---
 .../ics23-commitment/types/src/commitment.rs  | 15 ++++++-----
 ibc-core/ics23-commitment/types/src/error.rs  | 17 +++----------
 ibc-core/ics23-commitment/types/src/merkle.rs | 16 ++++++------
 ibc-core/ics25-handler/types/Cargo.toml       |  2 --
 ibc-core/ics25-handler/types/src/events.rs    |  3 ---
 ibc-core/ics26-routing/types/Cargo.toml       |  5 ----
 ibc-primitives/Cargo.toml                     |  4 +--
 ibc-testkit/Cargo.toml                        |  4 ---
 ibc-testkit/src/fixtures/core/client/mod.rs   |  4 +--
 ibc-testkit/src/hosts/block.rs                |  5 ++--
 .../testapp/ibc/clients/mock/client_state.rs  | 20 ++++++---------
 .../ibc/clients/mock/consensus_state.rs       | 22 +++++++---------
 .../testapp/ibc/clients/mock/misbehaviour.rs  | 20 ++++++---------
 .../tests/core/ics02_client/update_client.rs  |  4 +--
 ibc-testkit/tests/core/router.rs              |  3 +--
 34 files changed, 107 insertions(+), 217 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
 delete mode 100644 .changelog/unreleased/improvements/997-minimize-prost-dependency.md

diff --git a/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md b/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
new file mode 100644
index 000000000..a1e20886d
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
@@ -0,0 +1,5 @@
+- [`ibc`] Minimize `prost` dependency by introducing `ToVec` trait
+  - Now `prost` is only imported in `ibc-primitives` crate
+  - Remove error variants originating from `prost` (Breaking change)
+  - Eliminate the need for the `bytes` dependency
+ ([\#997](https://github.com/cosmos/ibc-rs/issues/997))
diff --git a/.changelog/unreleased/improvements/997-minimize-prost-dependency.md b/.changelog/unreleased/improvements/997-minimize-prost-dependency.md
deleted file mode 100644
index eb5cabc3d..000000000
--- a/.changelog/unreleased/improvements/997-minimize-prost-dependency.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- [`ibc-primitives`] Minimize `prost` dependency by introducing `ToVec` trait
- ([\#997](https://github.com/cosmos/ibc-rs/issues/997))
diff --git a/Cargo.toml b/Cargo.toml
index 2bfc3974a..bda0b4595 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -48,19 +48,14 @@ authors      = ["Informal Systems <hello@informal.systems>"]
 [workspace.dependencies]
 # external dependencies
 borsh               = { version = "0.10", default-features = false }
-bytes               = { version = "1.5.0", default-features = false }
 displaydoc          = { version = "0.2", default-features = false }
 derive_more         = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
-num-traits          = { version = "0.2.17", default-features = false }
-primitive-types     = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
-prost               = { version = "0.12", default-features = false }
 rstest              = "0.18.2"
 schemars            = { version = "0.8.15" }
 sha2                = { version = "0.10.8", default-features = false }
 serde               = { version = "1.0", default-features = false }
 serde_json          = { package = "serde-json-wasm", version = "1.0.0" , default-features = false }
 subtle-encoding     = { version = "0.5", default-features = false }
-time                = { version = ">=0.3.0, <0.3.31", default-features = false }
 
 # ibc dependencies
 ibc                 = { version = "0.48.1", path = "./ibc", default-features = false }
@@ -92,7 +87,6 @@ ibc-client-tendermint-types = { version = "0.48.1", path = "./ibc-clients/ics07-
 ibc-app-transfer-types      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.39.1", default-features = false }
-ics23     = { version = "0.11", default-features = false }
 
 # cosmos dependencies
 tendermint                       = { version = "0.34.0", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 65c2e8007..def22f0ff 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -619,7 +619,6 @@ dependencies = [
  "parity-scale-codec",
  "primitive-types",
  "scale-info",
- "schemars",
  "serde",
  "uint",
 ]
@@ -657,7 +656,6 @@ dependencies = [
  "ibc-core-host",
  "ibc-core-router",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -673,7 +671,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -692,7 +689,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -707,7 +703,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-derive",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
  "tendermint",
 ]
@@ -723,7 +718,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -741,7 +735,6 @@ dependencies = [
  "ibc-proto",
  "ics23",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -757,7 +750,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -772,7 +764,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -809,7 +800,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -831,7 +821,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host-types",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
 ]
 
@@ -858,7 +847,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-core-router-types",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
 ]
 
@@ -873,7 +861,6 @@ dependencies = [
  "ibc-proto",
  "ics23",
  "parity-scale-codec",
- "prost",
  "scale-info",
  "schemars",
  "serde",
@@ -909,9 +896,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.38.0"
+version = "0.39.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "93cbf4cbe9e5113cc7c70f3208a7029b2205c629502cbb2ae7ea0a09a97d3005"
+checksum = "c8a8b1356652b9f160f5a010dd6b084675b8a28e163bf2b41ca5abecf27d9701"
 dependencies = [
  "base64 0.21.2",
  "bytes",
@@ -1161,9 +1148,9 @@ dependencies = [
 
 [[package]]
 name = "prost"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f4fdd22f3b9c31b53c060df4a0613a1c7f062d4115a2b984dd15b1858f7e340d"
+checksum = "146c289cda302b98a28d40c8b3b90498d6e526dd24ac2ecea73e4e491685b94a"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -1171,9 +1158,9 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "265baba7fabd416cf5078179f7d2cbeca4ce7a9041111900675ea7c4cb8a4c32"
+checksum = "efb6c9a1dd1def8e2124d17e83a20af56f1570d6c2d2bd9e266ccb768df3840e"
 dependencies = [
  "anyhow",
  "itertools",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index ff8c1e715..6404bfca4 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1262,7 +1262,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host",
  "ibc-primitives",
- "prost",
  "serde",
  "tendermint",
  "tendermint-light-client-verifier",
@@ -1272,14 +1271,12 @@ dependencies = [
 name = "ibc-client-tendermint-types"
 version = "0.48.1"
 dependencies = [
- "bytes",
  "displaydoc",
  "ibc-core-client-types",
  "ibc-core-commitment-types",
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "tendermint",
  "tendermint-light-client-verifier",
@@ -1319,7 +1316,6 @@ dependencies = [
  "ibc-core-host",
  "ibc-core-router",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -1334,7 +1330,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "sha2 0.10.8",
  "subtle-encoding",
@@ -1351,7 +1346,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -1366,7 +1360,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-derive",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
  "tendermint",
 ]
@@ -1381,7 +1374,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -1396,7 +1388,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "ics23",
- "prost",
  "serde",
  "subtle-encoding",
 ]
@@ -1410,7 +1401,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host",
  "ibc-primitives",
- "prost",
 ]
 
 [[package]]
@@ -1424,7 +1414,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -1458,7 +1447,6 @@ dependencies = [
  "ibc-core-router-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -1478,7 +1466,6 @@ dependencies = [
  "ibc-core-handler-types",
  "ibc-core-host-types",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
 ]
 
@@ -1498,7 +1485,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "prost",
  "serde",
  "sha2 0.10.8",
  "subtle-encoding",
@@ -1525,7 +1511,6 @@ dependencies = [
  "ibc-core-host-types",
  "ibc-core-router-types",
  "ibc-primitives",
- "prost",
  "subtle-encoding",
 ]
 
@@ -1539,7 +1524,6 @@ dependencies = [
  "ibc-primitives",
  "ibc-proto",
  "ics23",
- "prost",
  "serde",
  "subtle-encoding",
  "tendermint",
diff --git a/ibc-apps/ics20-transfer/types/Cargo.toml b/ibc-apps/ics20-transfer/types/Cargo.toml
index 150ba8d63..2706d19c5 100644
--- a/ibc-apps/ics20-transfer/types/Cargo.toml
+++ b/ibc-apps/ics20-transfer/types/Cargo.toml
@@ -22,7 +22,7 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-primitive-types = { workspace = true }
+primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 uint            = { version = "0.9", default-features = false }
@@ -51,15 +51,15 @@ std = [
     "ibc-proto/std",
 ]
 serde = [
-    "dep:serde", 
+    "dep:serde",
     "ibc-core/serde",
-    "ibc-proto/serde", 
+    "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars", 
-    "ibc-core/schema", 
+    "dep:schemars",
+    "ibc-core/schema",
     "ibc-proto/json-schema", 
-    "serde", 
+    "serde",
     "std"
 ]
 borsh = [
@@ -68,8 +68,8 @@ borsh = [
     "ibc-proto/borsh"
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec", 
-    "dep:scale-info", 
+    "dep:parity-scale-codec",
+    "dep:scale-info",
     "ibc-core/parity-scale-codec",
     "ibc-proto/parity-scale-codec"
 ]
diff --git a/ibc-apps/ics20-transfer/types/src/lib.rs b/ibc-apps/ics20-transfer/types/src/lib.rs
index 2cc84f2fe..fd510cc9f 100644
--- a/ibc-apps/ics20-transfer/types/src/lib.rs
+++ b/ibc-apps/ics20-transfer/types/src/lib.rs
@@ -40,9 +40,10 @@ pub(crate) mod serializers;
 pub mod error;
 mod memo;
 pub use memo::*;
+/// Re-exports `U256` from `primitive-types` crate for convenience.
+pub use primitive_types::U256;
 
-/// Re-exports ICS-20 token transfer proto types from the `ibc-proto` crate
-/// for added convenience
+/// Re-exports ICS-20 token transfer proto types from the `ibc-proto` crate.
 pub mod proto {
     pub use ibc_proto::ibc::apps::transfer;
 }
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 8797ad3bb..35ac0ac09 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -26,7 +26,6 @@ use ibc_core_commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
 use ibc_core_commitment_types::merkle::{apply_prefix, MerkleProof};
-use ibc_core_commitment_types::proto::v1::MerkleProof as RawMerkleProof;
 use ibc_core_host::types::identifiers::{ClientId, ClientType};
 use ibc_core_host::types::path::{
     ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
@@ -199,9 +198,8 @@ impl ClientStateCommon for ClientState {
         value: Vec<u8>,
     ) -> Result<(), ClientError> {
         let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
-            .map_err(ClientError::InvalidCommitmentProof)?
-            .into();
+        let merkle_proof =
+            MerkleProof::try_from(proof.clone()).map_err(ClientError::InvalidCommitmentProof)?;
 
         merkle_proof
             .verify_membership(
@@ -222,9 +220,8 @@ impl ClientStateCommon for ClientState {
         path: Path,
     ) -> Result<(), ClientError> {
         let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof: MerkleProof = RawMerkleProof::try_from(proof.clone())
-            .map_err(ClientError::InvalidCommitmentProof)?
-            .into();
+        let merkle_proof =
+            MerkleProof::try_from(proof.clone()).map_err(ClientError::InvalidCommitmentProof)?;
 
         merkle_proof
             .verify_non_membership(&self.0.proof_specs, root.clone().into(), merkle_path)
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
index 3676b799c..085ca4fad 100644
--- a/ibc-clients/ics07-tendermint/types/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -20,9 +20,7 @@ all-features = true
 [dependencies]
 # external dependencies
 borsh      = { workspace = true, optional = true }
-bytes      = { workspace = true }
 displaydoc = { workspace = true }
-prost      = { workspace = true }
 serde      = { workspace = true, optional = true }
 
 # ibc dependencies
@@ -48,9 +46,7 @@ tendermint-rpc = { workspace = true }
 [features]
 default = ["std"]
 std = [
-    "bytes/std",
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "serde_json/std",
     "ibc-core-client-types/std",
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index ba323a400..b1f755711 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -15,7 +15,6 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 use ibc_proto::ibc::lightclients::tendermint::v1::ClientState as RawTmClientState;
 use ibc_proto::Protobuf;
-use prost::Message;
 use tendermint::chain::id::MAX_LENGTH as MaxChainIdLen;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 use tendermint_light_client_verifier::options::Options;
@@ -346,20 +345,16 @@ impl TryFrom<Any> for ClientState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use core::ops::Deref;
-
-        use bytes::Buf;
-
-        fn decode_client_state<B: Buf>(buf: B) -> Result<ClientState, Error> {
-            RawTmClientState::decode(buf)
-                .map_err(Error::Decode)?
-                .try_into()
+        fn decode_client_state(value: &[u8]) -> Result<ClientState, ClientError> {
+            let client_state =
+                Protobuf::<RawTmClientState>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(client_state)
         }
 
         match raw.type_url.as_str() {
-            TENDERMINT_CLIENT_STATE_TYPE_URL => {
-                decode_client_state(raw.value.deref()).map_err(Into::into)
-            }
+            TENDERMINT_CLIENT_STATE_TYPE_URL => decode_client_state(&raw.value),
             _ => Err(ClientError::UnknownClientStateType {
                 client_state_type: raw.type_url,
             }),
diff --git a/ibc-clients/ics07-tendermint/types/src/consensus_state.rs b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
index d8ac3aaa5..e48b016c3 100644
--- a/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
@@ -106,21 +106,16 @@ impl TryFrom<Any> for ConsensusState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use core::ops::Deref;
-
-        use bytes::Buf;
-        use prost::Message;
-
-        fn decode_consensus_state<B: Buf>(buf: B) -> Result<ConsensusState, Error> {
-            RawConsensusState::decode(buf)
-                .map_err(Error::Decode)?
-                .try_into()
+        fn decode_consensus_state(value: &[u8]) -> Result<ConsensusState, ClientError> {
+            let client_state =
+                Protobuf::<RawConsensusState>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(client_state)
         }
 
         match raw.type_url.as_str() {
-            TENDERMINT_CONSENSUS_STATE_TYPE_URL => {
-                decode_consensus_state(raw.value.deref()).map_err(Into::into)
-            }
+            TENDERMINT_CONSENSUS_STATE_TYPE_URL => decode_consensus_state(&raw.value),
             _ => Err(ClientError::UnknownConsensusStateType {
                 consensus_state_type: raw.type_url,
             }),
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index 661b116a5..0bc1dd918 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -55,8 +55,6 @@ pub enum Error {
     InvalidRawHeader(TendermintError),
     /// invalid raw misbehaviour: `{reason}`
     InvalidRawMisbehaviour { reason: String },
-    /// decode error: `{0}`
-    Decode(prost::DecodeError),
     /// given other previous updates, header timestamp should be at most `{max}`, but was `{actual}`
     HeaderTimestampTooHigh { actual: String, max: String },
     /// given other previous updates, header timestamp should be at least `{min}`, but was `{actual}`
@@ -104,7 +102,6 @@ impl std::error::Error for Error {
             Self::InvalidHeader { error: e, .. } => Some(e),
             Self::InvalidTendermintTrustThreshold(e) => Some(e),
             Self::InvalidRawHeader(e) => Some(e),
-            Self::Decode(e) => Some(e),
             _ => None,
         }
     }
diff --git a/ibc-clients/ics07-tendermint/types/src/header.rs b/ibc-clients/ics07-tendermint/types/src/header.rs
index f70b6f812..4872f9419 100644
--- a/ibc-clients/ics07-tendermint/types/src/header.rs
+++ b/ibc-clients/ics07-tendermint/types/src/header.rs
@@ -4,7 +4,6 @@ use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
-use bytes::Buf;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::Height;
 use ibc_core_host_types::identifiers::ChainId;
@@ -14,7 +13,6 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Header as RawHeader;
 use ibc_proto::Protobuf;
 use pretty::{PrettySignedHeader, PrettyValidatorSet};
-use prost::Message;
 use tendermint::block::signed_header::SignedHeader;
 use tendermint::chain::Id as TmChainId;
 use tendermint::validator::Set as ValidatorSet;
@@ -189,10 +187,14 @@ impl TryFrom<Any> for Header {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use core::ops::Deref;
-
+        fn decode_header(value: &[u8]) -> Result<Header, ClientError> {
+            let header = Protobuf::<RawHeader>::decode(value).map_err(|e| ClientError::Other {
+                description: e.to_string(),
+            })?;
+            Ok(header)
+        }
         match raw.type_url.as_str() {
-            TENDERMINT_HEADER_TYPE_URL => decode_header(raw.value.deref()).map_err(Into::into),
+            TENDERMINT_HEADER_TYPE_URL => decode_header(&raw.value),
             _ => Err(ClientError::UnknownHeaderType {
                 header_type: raw.type_url,
             }),
@@ -209,10 +211,6 @@ impl From<Header> for Any {
     }
 }
 
-fn decode_header<B: Buf>(buf: B) -> Result<Header, Error> {
-    RawHeader::decode(buf).map_err(Error::Decode)?.try_into()
-}
-
 impl From<Header> for RawHeader {
     fn from(value: Header) -> Self {
         RawHeader {
diff --git a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
index 010b2a40f..f3013378e 100644
--- a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
@@ -1,13 +1,11 @@
 //! Defines the misbehaviour type for the tendermint light client
 
-use bytes::Buf;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Misbehaviour as RawMisbehaviour;
 use ibc_proto::Protobuf;
-use prost::Message;
 
 use crate::error::Error;
 use crate::header::Header;
@@ -112,18 +110,15 @@ impl TryFrom<Any> for Misbehaviour {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, ClientError> {
-        use core::ops::Deref;
-
-        fn decode_misbehaviour<B: Buf>(buf: B) -> Result<Misbehaviour, Error> {
-            RawMisbehaviour::decode(buf)
-                .map_err(Error::Decode)?
-                .try_into()
+        fn decode_misbehaviour(value: &[u8]) -> Result<Misbehaviour, ClientError> {
+            let misbehaviour =
+                Protobuf::<RawMisbehaviour>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(misbehaviour)
         }
-
         match raw.type_url.as_str() {
-            TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
-                decode_misbehaviour(raw.value.deref()).map_err(Into::into)
-            }
+            TENDERMINT_MISBEHAVIOUR_TYPE_URL => decode_misbehaviour(&raw.value),
             _ => Err(ClientError::UnknownMisbehaviourType {
                 misbehaviour_type: raw.type_url,
             }),
diff --git a/ibc-core/ics02-client/types/Cargo.toml b/ibc-core/ics02-client/types/Cargo.toml
index 8b01bbca1..5069cd604 100644
--- a/ibc-core/ics02-client/types/Cargo.toml
+++ b/ibc-core/ics02-client/types/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
@@ -44,7 +43,6 @@ scale-info          = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "subtle-encoding/std",
     "ibc-core-commitment-types/std",
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 27cf5304b..57352297d 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -58,8 +58,6 @@ pub enum ClientError {
     MissingRawConsensusState,
     /// invalid client id in the update client message: `{0}`
     InvalidMsgUpdateClientId(IdentifierError),
-    /// decode error: `{0}`
-    Decode(prost::DecodeError),
     /// invalid client identifier error: `{0}`
     InvalidClientIdentifier(IdentifierError),
     /// invalid raw header error: `{reason}`
diff --git a/ibc-core/ics03-connection/types/Cargo.toml b/ibc-core/ics03-connection/types/Cargo.toml
index 9f1f7379b..536069db7 100644
--- a/ibc-core/ics03-connection/types/Cargo.toml
+++ b/ibc-core/ics03-connection/types/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
@@ -45,7 +44,6 @@ scale-info         = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "subtle-encoding/std",
     "serde/std",
     "ibc-core-client-types/std",
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
index bbd34da60..97395dfb5 100644
--- a/ibc-core/ics04-channel/types/Cargo.toml
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 sha2            = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
@@ -47,7 +46,6 @@ scale-info         = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "sha2/std",
     "serde/std",
     "subtle-encoding/std",
diff --git a/ibc-core/ics23-commitment/types/Cargo.toml b/ibc-core/ics23-commitment/types/Cargo.toml
index f29aff6c0..fbda6e24d 100644
--- a/ibc-core/ics23-commitment/types/Cargo.toml
+++ b/ibc-core/ics23-commitment/types/Cargo.toml
@@ -22,15 +22,14 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
 
 # ibc dependencies
 ibc-proto       = { workspace = true }
-ibc-primitives  = {workspace = true }
-ics23           = { workspace = true, features = ["host-functions"] }
+ibc-primitives  = { workspace = true }
+ics23           = { version = "0.11", default-features = false, features = ["host-functions"] }
 
 # parity dependencies
 parity-scale-codec  = { workspace = true, optional = true }
@@ -40,7 +39,6 @@ scale-info          = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "subtle-encoding/std",
     "ibc-primitives/std",
diff --git a/ibc-core/ics23-commitment/types/src/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
index 0969c565c..009a78f2c 100644
--- a/ibc-core/ics23-commitment/types/src/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -4,7 +4,9 @@ use core::convert::TryFrom;
 use core::fmt;
 
 use ibc_primitives::prelude::*;
+use ibc_primitives::ToVec;
 use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
+use ibc_proto::Protobuf;
 use subtle_encoding::{Encoding, Hex};
 
 use super::merkle::MerkleProof;
@@ -109,10 +111,7 @@ impl TryFrom<RawMerkleProof> for CommitmentProofBytes {
     type Error = CommitmentError;
 
     fn try_from(proof: RawMerkleProof) -> Result<Self, Self::Error> {
-        let mut buf = Vec::new();
-        prost::Message::encode(&proof, &mut buf)
-            .map_err(|e| Self::Error::EncodingFailure(e.to_string()))?;
-        buf.try_into()
+        proof.to_vec().try_into()
     }
 }
 
@@ -124,14 +123,14 @@ impl TryFrom<MerkleProof> for CommitmentProofBytes {
     }
 }
 
-impl TryFrom<CommitmentProofBytes> for RawMerkleProof {
+impl TryFrom<CommitmentProofBytes> for MerkleProof {
     type Error = CommitmentError;
 
     fn try_from(value: CommitmentProofBytes) -> Result<Self, Self::Error> {
         let value: Vec<u8> = value.into();
-        let res: RawMerkleProof = prost::Message::decode(value.as_ref())
-            .map_err(CommitmentError::InvalidRawMerkleProof)?;
-        Ok(res)
+        let merkle_proof = Protobuf::<RawMerkleProof>::decode(value.as_ref())
+            .map_err(|e| CommitmentError::DecodingFailure(e.to_string()))?;
+        Ok(merkle_proof)
     }
 }
 
diff --git a/ibc-core/ics23-commitment/types/src/error.rs b/ibc-core/ics23-commitment/types/src/error.rs
index 3b7b17575..88625226f 100644
--- a/ibc-core/ics23-commitment/types/src/error.rs
+++ b/ibc-core/ics23-commitment/types/src/error.rs
@@ -2,14 +2,9 @@
 
 use displaydoc::Display;
 use ibc_primitives::prelude::*;
-use prost::DecodeError;
 
 #[derive(Debug, Display)]
 pub enum CommitmentError {
-    /// invalid raw merkle proof error: `{0}`
-    InvalidRawMerkleProof(DecodeError),
-    /// failed to decode commitment proof error: `{0}`
-    CommitmentProofDecodingFailed(DecodeError),
     /// empty commitment prefix
     EmptyCommitmentPrefix,
     /// empty merkle proof
@@ -28,15 +23,9 @@ pub enum CommitmentError {
     VerificationFailure,
     /// encoded commitment prefix is not a valid hex string: `{0}`
     EncodingFailure(String),
+    /// decoding commitment proof bytes failed: `{0}`
+    DecodingFailure(String),
 }
 
 #[cfg(feature = "std")]
-impl std::error::Error for CommitmentError {
-    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
-        match &self {
-            Self::InvalidRawMerkleProof(e) => Some(e),
-            Self::CommitmentProofDecodingFailed(e) => Some(e),
-            _ => None,
-        }
-    }
-}
+impl std::error::Error for CommitmentError {}
diff --git a/ibc-core/ics23-commitment/types/src/merkle.rs b/ibc-core/ics23-commitment/types/src/merkle.rs
index 50e711c1d..3e0624968 100644
--- a/ibc-core/ics23-commitment/types/src/merkle.rs
+++ b/ibc-core/ics23-commitment/types/src/merkle.rs
@@ -7,6 +7,7 @@ use ibc_proto::ics23::{
     calculate_existence_root, verify_membership, verify_non_membership, CommitmentProof,
     NonExistenceProof,
 };
+use ibc_proto::Protobuf;
 
 use crate::commitment::{CommitmentPrefix, CommitmentRoot};
 use crate::error::CommitmentError;
@@ -31,14 +32,15 @@ pub struct MerkleProof {
     pub proofs: Vec<CommitmentProof>,
 }
 
-/// Convert to ics23::CommitmentProof
-/// The encoding and decoding shouldn't fail since ics23::CommitmentProof and ibc_proto::ics23::CommitmentProof should be the same
-/// Ref. <https://github.com/informalsystems/ibc-rs/issues/853>
-impl From<RawMerkleProof> for MerkleProof {
-    fn from(proof: RawMerkleProof) -> Self {
-        Self {
+impl Protobuf<RawMerkleProof> for MerkleProof {}
+
+impl TryFrom<RawMerkleProof> for MerkleProof {
+    type Error = CommitmentError;
+
+    fn try_from(proof: RawMerkleProof) -> Result<Self, Self::Error> {
+        Ok(Self {
             proofs: proof.proofs,
-        }
+        })
     }
 }
 
diff --git a/ibc-core/ics25-handler/types/Cargo.toml b/ibc-core/ics25-handler/types/Cargo.toml
index 5d92949e3..59c663903 100644
--- a/ibc-core/ics25-handler/types/Cargo.toml
+++ b/ibc-core/ics25-handler/types/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 serde           = { workspace = true, optional = true }
 schemars        = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
@@ -48,7 +47,6 @@ scale-info         = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "subtle-encoding/std",
     "ibc-core-client-types/std",
diff --git a/ibc-core/ics25-handler/types/src/events.rs b/ibc-core/ics25-handler/types/src/events.rs
index 78c98acbd..ab3c4b0c7 100644
--- a/ibc-core/ics25-handler/types/src/events.rs
+++ b/ibc-core/ics25-handler/types/src/events.rs
@@ -28,8 +28,6 @@ pub enum Error {
     Channel(channel_error::ChannelError),
     /// parsing timestamp error: `{0}`
     Timestamp(ParseTimestampError),
-    /// decoding protobuf error: `{0}`
-    Decode(prost::DecodeError),
     /// incorrect event type: `{event}`
     IncorrectEventType { event: String },
     /// module event cannot use core event types: `{event:?}`
@@ -45,7 +43,6 @@ impl std::error::Error for Error {
             Self::Connection(e) => Some(e),
             Self::Channel(e) => Some(e),
             Self::Timestamp(e) => Some(e),
-            Self::Decode(e) => Some(e),
             _ => None,
         }
     }
diff --git a/ibc-core/ics26-routing/types/Cargo.toml b/ibc-core/ics26-routing/types/Cargo.toml
index 8974821ea..3b1e4e15e 100644
--- a/ibc-core/ics26-routing/types/Cargo.toml
+++ b/ibc-core/ics26-routing/types/Cargo.toml
@@ -22,7 +22,6 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-prost           = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
@@ -31,7 +30,6 @@ subtle-encoding = { workspace = true }
 ibc-core-host-types    = { workspace = true }
 ibc-primitives         = { workspace = true }
 ibc-proto              = {workspace = true }
-ics23                  = { workspace = true }
 
 # cosmos dependencies
 tendermint = { workspace = true }
@@ -44,13 +42,11 @@ scale-info         = { workspace = true, optional = true }
 default = ["std"]
 std = [
     "displaydoc/std",
-    "prost/std",
     "serde/std",
     "subtle-encoding/std",
     "ibc-primitives/std",
     "ibc-core-host-types/std",
     "ibc-proto/std",
-    "ics23/std",
     "tendermint/std",
 ]
 serde = [
@@ -59,7 +55,6 @@ serde = [
     "ibc-core-host-types/serde",
     "ibc-primitives/serde",
     "ibc-proto/serde",
-    "ics23/serde",
 ]
 borsh = [
     "dep:borsh",
diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index 74f685233..149e4a55c 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -22,10 +22,10 @@ all-features = true
 borsh       = { workspace = true, optional = true }
 derive_more = { workspace = true }
 displaydoc  = { workspace = true }
-prost       = { workspace = true }
+prost       = { version = "0.12", default-features = false }
 schemars    = { workspace = true, optional = true }
 serde       = { workspace = true, optional = true }
-time        = { workspace = true }
+time        = { version = ">=0.3.0, <0.3.31", default-features = false }
 
 # ibc dependencies
 ibc-proto = { workspace = true }
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index b2cd443b1..e020657a6 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -18,12 +18,9 @@ description  = """
 [dependencies]
 # external dependencies
 borsh             = { workspace = true, optional = true }
-bytes             = { workspace = true }
 derive_more       = { workspace = true }
 displaydoc        = { workspace = true }
 parking_lot       = { version = "0.12.1", default-features = false }
-primitive-types   = { workspace = true }
-prost             = { workspace = true }
 schemars          = { workspace = true, optional = true }
 serde             = { workspace = true, optional = true }
 serde_json        = { workspace = true, optional = true }
@@ -48,7 +45,6 @@ test-log           = { version = "0.2.13", features = ["trace"] }
 [features]
 default = ["std"]
 std = [
-    "prost/std",
     "serde/std",
     "tracing/std",
     "tracing-subscriber/std",
diff --git a/ibc-testkit/src/fixtures/core/client/mod.rs b/ibc-testkit/src/fixtures/core/client/mod.rs
index e6807a097..2f3c477d4 100644
--- a/ibc-testkit/src/fixtures/core/client/mod.rs
+++ b/ibc-testkit/src/fixtures/core/client/mod.rs
@@ -18,8 +18,8 @@ mod tests {
     use ibc::core::client::types::Height;
     use ibc::core::host::types::identifiers::*;
     use ibc::primitives::prelude::*;
+    use ibc::primitives::ToVec;
     use ibc_proto::google::protobuf::Any;
-    use prost::Message;
     use tendermint::abci::Event as AbciEvent;
 
     use crate::fixtures::clients::mock::dummy_new_mock_header;
@@ -70,7 +70,7 @@ mod tests {
                     client_type.clone(),
                     consensus_height,
                     consensus_heights,
-                    header.encode_to_vec(),
+                    header.to_vec(),
                 )
                 .into(),
                 expected_keys: expected_keys.clone(),
diff --git a/ibc-testkit/src/hosts/block.rs b/ibc-testkit/src/hosts/block.rs
index 9ce08cdce..526ca1784 100644
--- a/ibc-testkit/src/hosts/block.rs
+++ b/ibc-testkit/src/hosts/block.rs
@@ -11,6 +11,7 @@ use ibc::core::host::types::identifiers::ChainId;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::Timestamp;
 use ibc::primitives::proto::{Any, Protobuf};
+use ibc::primitives::ToVec;
 use tendermint::block::Header as TmHeader;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint_testgen::light_block::TmLightBlock;
@@ -233,8 +234,6 @@ impl TryFrom<Any> for HostBlock {
 impl From<HostBlock> for Any {
     fn from(value: HostBlock) -> Self {
         fn encode_light_block(light_block: SyntheticTmBlock) -> Vec<u8> {
-            use prost::Message;
-
             let SyntheticTmBlock {
                 trusted_height,
                 trusted_next_validators,
@@ -247,7 +246,7 @@ impl From<HostBlock> for Any {
                 trusted_height: Some(trusted_height.into()),
                 trusted_validators: Some(trusted_next_validators.into()),
             }
-            .encode_to_vec()
+            .to_vec()
         }
 
         match value {
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 5be183162..34a387a34 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -101,21 +101,15 @@ impl TryFrom<Any> for MockClientState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use core::ops::Deref;
-
-        use bytes::Buf;
-        use prost::Message;
-
-        fn decode_client_state<B: Buf>(buf: B) -> Result<MockClientState, ClientError> {
-            RawMockClientState::decode(buf)
-                .map_err(ClientError::Decode)?
-                .try_into()
+        fn decode_client_state(value: &[u8]) -> Result<MockClientState, ClientError> {
+            let client_state =
+                Protobuf::<RawMockClientState>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(client_state)
         }
-
         match raw.type_url.as_str() {
-            MOCK_CLIENT_STATE_TYPE_URL => {
-                decode_client_state(raw.value.deref()).map_err(Into::into)
-            }
+            MOCK_CLIENT_STATE_TYPE_URL => decode_client_state(&raw.value),
             _ => Err(ClientError::UnknownClientStateType {
                 client_state_type: raw.type_url,
             }),
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
index fa0451ebe..8a2e31e58 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
@@ -63,21 +63,17 @@ impl TryFrom<Any> for MockConsensusState {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        use core::ops::Deref;
-
-        use bytes::Buf;
-        use prost::Message;
-
-        fn decode_consensus_state<B: Buf>(buf: B) -> Result<MockConsensusState, ClientError> {
-            RawMockConsensusState::decode(buf)
-                .map_err(ClientError::Decode)?
-                .try_into()
+        fn decode_consensus_state(value: &[u8]) -> Result<MockConsensusState, ClientError> {
+            let mock_consensus_state =
+                Protobuf::<RawMockConsensusState>::decode(value).map_err(|e| {
+                    ClientError::Other {
+                        description: e.to_string(),
+                    }
+                })?;
+            Ok(mock_consensus_state)
         }
-
         match raw.type_url.as_str() {
-            MOCK_CONSENSUS_STATE_TYPE_URL => {
-                decode_consensus_state(raw.value.deref()).map_err(Into::into)
-            }
+            MOCK_CONSENSUS_STATE_TYPE_URL => decode_consensus_state(&raw.value),
             _ => Err(ClientError::UnknownConsensusStateType {
                 consensus_state_type: raw.type_url,
             }),
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
index 85dd8bceb..f0769e4df 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
@@ -1,4 +1,3 @@
-use bytes::Buf;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::primitives::prelude::*;
@@ -53,20 +52,15 @@ impl TryFrom<Any> for Misbehaviour {
     type Error = ClientError;
 
     fn try_from(raw: Any) -> Result<Self, ClientError> {
-        use core::ops::Deref;
-
-        fn decode_misbehaviour<B: Buf>(buf: B) -> Result<Misbehaviour, ClientError> {
-            use prost::Message;
-
-            RawMisbehaviour::decode(buf)
-                .map_err(ClientError::Decode)?
-                .try_into()
+        fn decode_misbehaviour(value: &[u8]) -> Result<Misbehaviour, ClientError> {
+            let raw_misbehaviour =
+                Protobuf::<RawMisbehaviour>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(raw_misbehaviour)
         }
-
         match raw.type_url.as_str() {
-            MOCK_MISBEHAVIOUR_TYPE_URL => {
-                decode_misbehaviour(raw.value.deref()).map_err(Into::into)
-            }
+            MOCK_MISBEHAVIOUR_TYPE_URL => decode_misbehaviour(&raw.value),
             _ => Err(ClientError::UnknownMisbehaviourType {
                 misbehaviour_type: raw.type_url,
             }),
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 1011b7a3c..9ef713dd9 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -20,6 +20,7 @@ use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::{downcast, Timestamp};
 use ibc::primitives::proto::Any;
+use ibc::primitives::ToVec;
 use ibc_testkit::fixtures::core::context::MockContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::hosts::block::{HostBlock, HostType};
@@ -31,7 +32,6 @@ use ibc_testkit::testapp::ibc::clients::mock::misbehaviour::Misbehaviour as Mock
 use ibc_testkit::testapp::ibc::clients::AnyConsensusState;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
-use prost::Message;
 use tendermint_testgen::Validator as TestgenValidator;
 use test_log::test;
 
@@ -686,7 +686,7 @@ fn test_update_client_events() {
     assert_eq!(update_client_event.client_type(), &mock_client_type());
     assert_eq!(update_client_event.consensus_height(), &height);
     assert_eq!(update_client_event.consensus_heights(), &vec![height]);
-    assert_eq!(update_client_event.header(), &header.encode_to_vec());
+    assert_eq!(update_client_event.header(), &header.to_vec());
 }
 
 fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index 68969ba0f..327c09642 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -1,7 +1,7 @@
 use ibc::apps::transfer::handler::send_transfer;
 use ibc::apps::transfer::types::error::TokenTransferError;
 use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
-use ibc::apps::transfer::types::BaseCoin;
+use ibc::apps::transfer::types::{BaseCoin, U256};
 use ibc::core::channel::types::error::ChannelError;
 use ibc::core::channel::types::msgs::{
     ChannelMsg, MsgAcknowledgement, MsgChannelCloseConfirm, MsgChannelCloseInit, MsgChannelOpenAck,
@@ -40,7 +40,6 @@ use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusStat
 use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
-use primitive_types::U256;
 use test_log::test;
 
 #[test]

From de2c530f941eaf993badce2fccc4f3cb352f95b8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Philippe=20Laferri=C3=A8re?= <plafer@protonmail.com>
Date: Sun, 10 Dec 2023 23:34:35 -0500
Subject: [PATCH 075/182] imp: refactor `send-coins-*()` and add `memo` field
 to `escrow-*` and `burn-*` methods (#836)

* split send_coins_*() functions

and introduce extra data

* arg name change

* add error variant

* add error

* add `Other` variant to `TokenTransferError`

* fmt

* fix: restore `no_std` support for `serde` feature (#790)

* fix: restore no_std support for serde feature

* deps: bump ibc-proto-rs to v0.34.0

* fix: reflect changes b/c of ibc-proto-rs

* imp: comply naming + use better domain type for host_consensus_state

* fix: apply host_cons_state_proof changes for conn_open_ack

* fix: use domain TmEvent instead of proto for upgrade client proposal handler

* misc: add a unclog for ibc-proto-rs upgrade

* bump ibc-proto to v0.34.1 and borsh to v0.10 (#844)

* bump ibc-proto and borsh

* changelog

* add borsh derive for `MsgTransfer`

* derive JsonSchema for MsgTransfer

* fix JsonSchema derive for MsgTransfer

Fix is in implementing it properly for our `Timestamp`

* execute() methods must have &mut self

* nit: spell checker

* imp: simplify escrow/unescrow abstraction + using memo instead

* chore: dress up with unclogs

* nit: adjust unlogs

* nit: remove confusing InternalTransferFailed error variant

* imp: add memo field to burn-coins-*

* docs: adjust & add missing docstrings

---------

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../unreleased/993-bump-ibc-proto-rs.md       |  2 -
 .../837-split-sent-coins-method copy.md       |  5 ++
 .../839-add-memo-field-for-token-escrow.md    |  5 ++
 .../breaking-changes/978-identifier-error.md  |  4 +-
 .../breaking-changes/993-bump-ibc-proto-rs.md |  2 +
 .../997-minimize-prost-dependency.md          |  2 +-
 .../992-more-rigorous-cosmwasm-check.md       |  2 +-
 ibc-apps/ics20-transfer/src/context.rs        | 61 ++++++++++++++-----
 ibc-apps/ics20-transfer/src/handler/mod.rs    | 21 ++++---
 .../src/handler/on_recv_packet.rs             | 19 +++---
 .../src/handler/send_transfer.rs              | 24 +++++---
 ibc-apps/ics20-transfer/types/src/error.rs    |  9 +++
 .../ics20-transfer/types/src/msgs/transfer.rs |  1 +
 .../ibc/applications/transfer/context.rs      | 44 ++++++++-----
 14 files changed, 140 insertions(+), 61 deletions(-)
 delete mode 100644 .changelog/unreleased/993-bump-ibc-proto-rs.md
 create mode 100644 .changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md
 create mode 100644 .changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md
 create mode 100644 .changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md

diff --git a/.changelog/unreleased/993-bump-ibc-proto-rs.md b/.changelog/unreleased/993-bump-ibc-proto-rs.md
deleted file mode 100644
index bc4fa551d..000000000
--- a/.changelog/unreleased/993-bump-ibc-proto-rs.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- Bump ibc-proto-rs dependency to v0.39.1.
-  ([\#993](https://github.com/cosmos/ibc-rs/issues/993))
diff --git a/.changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md b/.changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md
new file mode 100644
index 000000000..f3877cdbb
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md	
@@ -0,0 +1,5 @@
+- `[ibc-app-transfer]` Refactor `send-coins-*()` methods by breaking them down
+  into distinct escrow and unescrow methods, enhancing both clarity and
+  specificity in functionality.
+  ([\#837](https://github.com/cosmos/ibc-rs/issues/837))
+  
\ No newline at end of file
diff --git a/.changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md b/.changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md
new file mode 100644
index 000000000..f506d8809
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md
@@ -0,0 +1,5 @@
+- `[ibc-app-transfer]` Add `memo` field to `escrow-coins-*()` and
+  `burn-coins-*()` methods, allowing implementors to pass in arbitrary data
+  necessary for their use case.
+  ([\#839](https://github.com/cosmos/ibc-rs/issues/837))
+  
\ No newline at end of file
diff --git a/.changelog/unreleased/breaking-changes/978-identifier-error.md b/.changelog/unreleased/breaking-changes/978-identifier-error.md
index cd03b558e..51bc5be68 100644
--- a/.changelog/unreleased/breaking-changes/978-identifier-error.md
+++ b/.changelog/unreleased/breaking-changes/978-identifier-error.md
@@ -1,2 +1,2 @@
-- Optimize `IdentifierError` variants and make them mutually exclusive.
-  ([\#978](https://github.com/cosmos/ibc-rs/issues/978))
+- `[ibc-core-host-type]` Optimize `IdentifierError` variants and make them
+  mutually exclusive. ([\#978](https://github.com/cosmos/ibc-rs/issues/978))
diff --git a/.changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md b/.changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md
new file mode 100644
index 000000000..07c4e5024
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md
@@ -0,0 +1,2 @@
+- `[ibc-data-types]` Bump ibc-proto-rs dependency to v0.39.1.
+  ([\#993](https://github.com/cosmos/ibc-rs/issues/993))
diff --git a/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md b/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
index a1e20886d..558b56b31 100644
--- a/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
+++ b/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
@@ -1,4 +1,4 @@
-- [`ibc`] Minimize `prost` dependency by introducing `ToVec` trait
+- `[ibc]` Minimize `prost` dependency by introducing `ToVec` trait
   - Now `prost` is only imported in `ibc-primitives` crate
   - Remove error variants originating from `prost` (Breaking change)
   - Eliminate the need for the `bytes` dependency
diff --git a/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md b/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
index 7540c8a9d..a4c91b322 100644
--- a/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
+++ b/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
@@ -1,3 +1,3 @@
-- [`cw-check`] More rigorous CosmWasm check by upgrading dependencies and
+- `[cw-check]` More rigorous CosmWasm check by upgrading dependencies and
   including `std` and `schema` features for `ibc-core`.
   ([\#992](https://github.com/cosmos/ibc-rs/pull/992))
diff --git a/ibc-apps/ics20-transfer/src/context.rs b/ibc-apps/ics20-transfer/src/context.rs
index 672c87819..c427d4ad6 100644
--- a/ibc-apps/ics20-transfer/src/context.rs
+++ b/ibc-apps/ics20-transfer/src/context.rs
@@ -1,7 +1,7 @@
 //! Defines the main context traits and IBC module callbacks
 
 use ibc_app_transfer_types::error::TokenTransferError;
-use ibc_app_transfer_types::{PrefixedCoin, PrefixedDenom};
+use ibc_app_transfer_types::{Memo, PrefixedCoin, PrefixedDenom};
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
 use ibc_core::primitives::Signer;
@@ -13,24 +13,31 @@ pub trait TokenTransferValidationContext {
     /// get_port returns the portID for the transfer module.
     fn get_port(&self) -> Result<PortId, TokenTransferError>;
 
-    /// Returns the escrow account id for a port and channel combination
-    fn get_escrow_account(
-        &self,
-        port_id: &PortId,
-        channel_id: &ChannelId,
-    ) -> Result<Self::AccountId, TokenTransferError>;
-
     /// Returns Ok() if the host chain supports sending coins.
     fn can_send_coins(&self) -> Result<(), TokenTransferError>;
 
     /// Returns Ok() if the host chain supports receiving coins.
     fn can_receive_coins(&self) -> Result<(), TokenTransferError>;
 
-    /// Validates the sender and receiver accounts and the coin inputs
-    fn send_coins_validate(
+    /// Validates that the tokens can be escrowed successfully.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// escrow validation.
+    fn escrow_coins_validate(
         &self,
         from_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        coin: &PrefixedCoin,
+        memo: &Memo,
+    ) -> Result<(), TokenTransferError>;
+
+    /// Validates that the tokens can be unescrowed successfully.
+    fn unescrow_coins_validate(
+        &self,
         to_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
         coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError>;
 
@@ -41,11 +48,15 @@ pub trait TokenTransferValidationContext {
         coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError>;
 
-    /// Validates the sender account and the coin input
+    /// Validates the sender account and the coin input before burning.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// burn validation.
     fn burn_coins_validate(
         &self,
         account: &Self::AccountId,
         coin: &PrefixedCoin,
+        memo: &Memo,
     ) -> Result<(), TokenTransferError>;
 
     /// Returns a hash of the prefixed denom.
@@ -55,27 +66,45 @@ pub trait TokenTransferValidationContext {
     }
 }
 
-/// Methods required in token transfer execution, to be implemented by the host
+/// Methods required in token transfer execution, to be implemented by the host.
 pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
-    /// This function should enable sending ibc fungible tokens from one account to another
-    fn send_coins_execute(
+    /// Executes the escrow of the tokens in a user account.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// escrow execution.
+    fn escrow_coins_execute(
         &mut self,
         from_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        coin: &PrefixedCoin,
+        memo: &Memo,
+    ) -> Result<(), TokenTransferError>;
+
+    /// Executes the unescrow of the tokens in a user account.
+    fn unescrow_coins_execute(
+        &mut self,
         to_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
         coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError>;
 
-    /// This function to enable minting ibc tokens to a user account
+    /// Executes minting of the tokens in a user account.
     fn mint_coins_execute(
         &mut self,
         account: &Self::AccountId,
         coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError>;
 
-    /// This function should enable burning of minted tokens in a user account
+    /// Executes burning of the tokens in a user account.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// burn execution.
     fn burn_coins_execute(
         &mut self,
         account: &Self::AccountId,
         coin: &PrefixedCoin,
+        memo: &Memo,
     ) -> Result<(), TokenTransferError>;
 }
diff --git a/ibc-apps/ics20-transfer/src/handler/mod.rs b/ibc-apps/ics20-transfer/src/handler/mod.rs
index 9689ab629..39dcd373d 100644
--- a/ibc-apps/ics20-transfer/src/handler/mod.rs
+++ b/ibc-apps/ics20-transfer/src/handler/mod.rs
@@ -27,11 +27,12 @@ pub fn refund_packet_token_execute(
         packet.chan_id_on_a.clone(),
         &data.token.denom,
     ) {
-        // unescrow tokens back to sender
-        let escrow_address =
-            ctx_a.get_escrow_account(&packet.port_id_on_a, &packet.chan_id_on_a)?;
-
-        ctx_a.send_coins_execute(&escrow_address, &sender, &data.token)
+        ctx_a.unescrow_coins_execute(
+            &sender,
+            &packet.port_id_on_a,
+            &packet.chan_id_on_a,
+            &data.token,
+        )
     }
     // mint vouchers back to sender
     else {
@@ -55,10 +56,12 @@ pub fn refund_packet_token_validate(
         packet.chan_id_on_a.clone(),
         &data.token.denom,
     ) {
-        let escrow_address =
-            ctx_a.get_escrow_account(&packet.port_id_on_a, &packet.chan_id_on_a)?;
-
-        ctx_a.send_coins_validate(&escrow_address, &sender, &data.token)
+        ctx_a.unescrow_coins_validate(
+            &sender,
+            &packet.port_id_on_a,
+            &packet.chan_id_on_a,
+            &data.token,
+        )
     } else {
         ctx_a.mint_coins_validate(&sender, &data.token)
     }
diff --git a/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs b/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
index 2baa187f6..193b33196 100644
--- a/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
+++ b/ibc-apps/ics20-transfer/src/handler/on_recv_packet.rs
@@ -43,10 +43,6 @@ pub fn process_recv_packet_execute<Ctx: TokenTransferExecutionContext>(
             c
         };
 
-        let escrow_address = ctx_b
-            .get_escrow_account(&packet.port_id_on_b, &packet.chan_id_on_b)
-            .map_err(|token_err| (ModuleExtras::empty(), token_err))?;
-
         // Note: it is correct to do the validation here because `recv_packet()`
         // works slightly differently. We do not have a
         // `on_recv_packet_validate()` callback because regardless of whether or
@@ -58,11 +54,20 @@ pub fn process_recv_packet_execute<Ctx: TokenTransferExecutionContext>(
         // gets relayed back to the sender so that the escrowed tokens
         // can be refunded.
         ctx_b
-            .send_coins_validate(&escrow_address, &receiver_account, &coin)
+            .unescrow_coins_validate(
+                &receiver_account,
+                &packet.port_id_on_b,
+                &packet.chan_id_on_b,
+                &coin,
+            )
             .map_err(|token_err| (ModuleExtras::empty(), token_err))?;
-
         ctx_b
-            .send_coins_execute(&escrow_address, &receiver_account, &coin)
+            .unescrow_coins_execute(
+                &receiver_account,
+                &packet.port_id_on_b,
+                &packet.chan_id_on_b,
+                &coin,
+            )
             .map_err(|token_err| (ModuleExtras::empty(), token_err))?;
 
         ModuleExtras::empty()
diff --git a/ibc-apps/ics20-transfer/src/handler/send_transfer.rs b/ibc-apps/ics20-transfer/src/handler/send_transfer.rs
index 683b96edf..439e5604c 100644
--- a/ibc-apps/ics20-transfer/src/handler/send_transfer.rs
+++ b/ibc-apps/ics20-transfer/src/handler/send_transfer.rs
@@ -68,11 +68,15 @@ where
         msg.chan_id_on_a.clone(),
         &token.denom,
     ) {
-        let escrow_address =
-            token_ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
-        token_ctx_a.send_coins_validate(&sender, &escrow_address, token)?;
+        token_ctx_a.escrow_coins_validate(
+            &sender,
+            &msg.port_id_on_a,
+            &msg.chan_id_on_a,
+            token,
+            &msg.packet_data.memo,
+        )?;
     } else {
-        token_ctx_a.burn_coins_validate(&sender, token)?;
+        token_ctx_a.burn_coins_validate(&sender, token, &msg.packet_data.memo)?;
     }
 
     let packet = {
@@ -137,11 +141,15 @@ where
         msg.chan_id_on_a.clone(),
         &token.denom,
     ) {
-        let escrow_address =
-            token_ctx_a.get_escrow_account(&msg.port_id_on_a, &msg.chan_id_on_a)?;
-        token_ctx_a.send_coins_execute(&sender, &escrow_address, token)?;
+        token_ctx_a.escrow_coins_execute(
+            &sender,
+            &msg.port_id_on_a,
+            &msg.chan_id_on_a,
+            token,
+            &msg.packet_data.memo,
+        )?;
     } else {
-        token_ctx_a.burn_coins_execute(&sender, token)?;
+        token_ctx_a.burn_coins_execute(&sender, token, &msg.packet_data.memo)?;
     }
 
     let packet = {
diff --git a/ibc-apps/ics20-transfer/types/src/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
index 8737ddf96..f4b06aee5 100644
--- a/ibc-apps/ics20-transfer/types/src/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -11,12 +11,19 @@ use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
 use uint::FromDecStrErr;
 
+use crate::Amount;
+
 #[derive(Display, Debug)]
 pub enum TokenTransferError {
     /// context error: `{0}`
     ContextError(ContextError),
     /// invalid identifier: `{0}`
     InvalidIdentifier(IdentifierError),
+    /// insufficient funds: tried to send `{send_attempt}`, sender only has `{available_funds}`
+    InsufficientFunds {
+        send_attempt: Amount,
+        available_funds: Amount,
+    },
     /// destination channel not found in the counterparty of port_id `{port_id}` and channel_id `{channel_id}`
     DestinationChannelNotFound {
         port_id: PortId,
@@ -70,6 +77,8 @@ pub enum TokenTransferError {
     InvalidCoin { coin: String },
     /// decoding raw bytes as UTF8 string error: `{0}`
     Utf8Decode(Utf8Error),
+    /// other error: `{0}`
+    Other(String),
 }
 
 #[cfg(feature = "std")]
diff --git a/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
index f100bfb52..06bd48027 100644
--- a/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
+++ b/ibc-apps/ics20-transfer/types/src/msgs/transfer.rs
@@ -32,6 +32,7 @@ pub(crate) const TYPE_URL: &str = "/ibc.applications.transfer.v1.MsgTransfer";
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct MsgTransfer {
     /// the port on which the packet will be sent
     pub port_id_on_a: PortId,
diff --git a/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs b/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
index 2608dcda6..d8876b315 100644
--- a/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
+++ b/ibc-testkit/src/testapp/ibc/applications/transfer/context.rs
@@ -1,10 +1,8 @@
 use ibc::apps::transfer::context::{TokenTransferExecutionContext, TokenTransferValidationContext};
 use ibc::apps::transfer::types::error::TokenTransferError;
-use ibc::apps::transfer::types::PrefixedCoin;
+use ibc::apps::transfer::types::{Memo, PrefixedCoin};
 use ibc::core::host::types::identifiers::{ChannelId, PortId};
 use ibc::core::primitives::Signer;
-use ibc::cosmos_host::utils::cosmos_adr028_escrow_address;
-use subtle_encoding::bech32;
 
 use super::types::DummyTransferModule;
 
@@ -15,15 +13,6 @@ impl TokenTransferValidationContext for DummyTransferModule {
         Ok(PortId::transfer())
     }
 
-    fn get_escrow_account(
-        &self,
-        port_id: &PortId,
-        channel_id: &ChannelId,
-    ) -> Result<Self::AccountId, TokenTransferError> {
-        let addr = cosmos_adr028_escrow_address(port_id, channel_id);
-        Ok(bech32::encode("cosmos", addr).into())
-    }
-
     fn can_send_coins(&self) -> Result<(), TokenTransferError> {
         Ok(())
     }
@@ -31,11 +20,22 @@ impl TokenTransferValidationContext for DummyTransferModule {
     fn can_receive_coins(&self) -> Result<(), TokenTransferError> {
         Ok(())
     }
-
-    fn send_coins_validate(
+    fn escrow_coins_validate(
         &self,
         _from_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _coin: &PrefixedCoin,
+        _memo: &Memo,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn unescrow_coins_validate(
+        &self,
         _to_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
         _coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError> {
         Ok(())
@@ -53,16 +53,29 @@ impl TokenTransferValidationContext for DummyTransferModule {
         &self,
         _account: &Self::AccountId,
         _coin: &PrefixedCoin,
+        _memo: &Memo,
     ) -> Result<(), TokenTransferError> {
         Ok(())
     }
 }
 
 impl TokenTransferExecutionContext for DummyTransferModule {
-    fn send_coins_execute(
+    fn escrow_coins_execute(
         &mut self,
         _from_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _coin: &PrefixedCoin,
+        _memo: &Memo,
+    ) -> Result<(), TokenTransferError> {
+        Ok(())
+    }
+
+    fn unescrow_coins_execute(
+        &mut self,
         _to_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
         _coin: &PrefixedCoin,
     ) -> Result<(), TokenTransferError> {
         Ok(())
@@ -80,6 +93,7 @@ impl TokenTransferExecutionContext for DummyTransferModule {
         &mut self,
         _account: &Self::AccountId,
         _coin: &PrefixedCoin,
+        _memo: &Memo,
     ) -> Result<(), TokenTransferError> {
         Ok(())
     }

From bc7866f812fd7728fcd60ca17e348dd46d088f83 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Wed, 13 Dec 2023 02:02:08 +0100
Subject: [PATCH 076/182] feat: introduce convenience Status::verify_is_active
 method (#1005)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: introduce convenience Status::verify_active method

Similarly to ChannelEnd::verify_not_closed, introduce a convenience
method Status::verify_active which checks whether client’s status is
active and returns an error if it isn’t.  This simplifies whole bunch
of code locations making them more DRY.

* Update .changelog/unreleased/improvements/1005-status-verify-active.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* review

---------

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../improvements/1005-status-verify-active.md        |  2 ++
 ibc-core/ics02-client/src/handler/update_client.rs   |  9 +++------
 ibc-core/ics02-client/src/handler/upgrade_client.rs  |  9 +++------
 ibc-core/ics02-client/types/src/status.rs            | 10 ++++++++++
 .../ics03-connection/src/handler/conn_open_ack.rs    | 11 +++--------
 .../src/handler/conn_open_confirm.rs                 | 11 +++--------
 .../ics03-connection/src/handler/conn_open_init.rs   | 11 +++--------
 .../ics03-connection/src/handler/conn_open_try.rs    | 11 +++--------
 .../ics04-channel/src/handler/acknowledgement.rs     | 11 +++--------
 .../ics04-channel/src/handler/chan_close_confirm.rs  | 11 +++--------
 .../ics04-channel/src/handler/chan_close_init.rs     | 11 +++--------
 ibc-core/ics04-channel/src/handler/chan_open_ack.rs  | 11 +++--------
 .../ics04-channel/src/handler/chan_open_confirm.rs   | 11 +++--------
 ibc-core/ics04-channel/src/handler/chan_open_init.rs | 11 +++--------
 ibc-core/ics04-channel/src/handler/chan_open_try.rs  | 12 ++++--------
 ibc-core/ics04-channel/src/handler/recv_packet.rs    | 12 ++++--------
 ibc-core/ics04-channel/src/handler/send_packet.rs    | 11 +++--------
 ibc-core/ics04-channel/src/handler/timeout.rs        | 12 ++++--------
 .../ics04-channel/src/handler/timeout_on_close.rs    | 12 ++++--------
 19 files changed, 67 insertions(+), 132 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1005-status-verify-active.md

diff --git a/.changelog/unreleased/improvements/1005-status-verify-active.md b/.changelog/unreleased/improvements/1005-status-verify-active.md
new file mode 100644
index 000000000..8aef96bb5
--- /dev/null
+++ b/.changelog/unreleased/improvements/1005-status-verify-active.md
@@ -0,0 +1,2 @@
+- `[ibc-core-client-types]` Add a convenient `Status::verify_is_active` method.
+  ([#1005](https://github.com/cosmos/ibc-rs/pull/1005))
diff --git a/ibc-core/ics02-client/src/handler/update_client.rs b/ibc-core/ics02-client/src/handler/update_client.rs
index a9d6862d5..54dd9fd42 100644
--- a/ibc-core/ics02-client/src/handler/update_client.rs
+++ b/ibc-core/ics02-client/src/handler/update_client.rs
@@ -28,12 +28,9 @@ where
     // Read client state from the host chain store. The client should already exist.
     let client_state = ctx.client_state(&client_id)?;
 
-    {
-        let status = client_state.status(ctx.get_client_validation_context(), &client_id)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    client_state
+        .status(ctx.get_client_validation_context(), &client_id)?
+        .verify_is_active()?;
 
     let client_message = msg.client_message();
 
diff --git a/ibc-core/ics02-client/src/handler/upgrade_client.rs b/ibc-core/ics02-client/src/handler/upgrade_client.rs
index f15c4ce99..5bf1386e4 100644
--- a/ibc-core/ics02-client/src/handler/upgrade_client.rs
+++ b/ibc-core/ics02-client/src/handler/upgrade_client.rs
@@ -27,12 +27,9 @@ where
     let old_client_state = ctx.client_state(&client_id)?;
 
     // Check if the client is active.
-    {
-        let status = old_client_state.status(ctx.get_client_validation_context(), &client_id)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    old_client_state
+        .status(ctx.get_client_validation_context(), &client_id)?
+        .verify_is_active()?;
 
     // Read the latest consensus state from the host chain store.
     let old_client_cons_state_path = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics02-client/types/src/status.rs b/ibc-core/ics02-client/types/src/status.rs
index b15ed61e7..9660758f4 100644
--- a/ibc-core/ics02-client/types/src/status.rs
+++ b/ibc-core/ics02-client/types/src/status.rs
@@ -1,5 +1,7 @@
 use core::fmt::{Debug, Display, Formatter};
 
+use crate::error::ClientError;
+
 /// `UpdateKind` represents the 2 ways that a client can be updated
 /// in IBC: either through a `MsgUpdateClient`, or a `MsgSubmitMisbehaviour`.
 #[derive(Clone, Debug, PartialEq, Eq)]
@@ -38,6 +40,14 @@ impl Status {
     pub fn is_expired(&self) -> bool {
         *self == Status::Expired
     }
+
+    /// Checks whether the status is active; returns `Err` if not.
+    pub fn verify_is_active(self) -> Result<(), ClientError> {
+        match self {
+            Self::Active => Ok(()),
+            status => Err(ClientError::ClientNotActive { status }),
+        }
+    }
 }
 
 impl Display for Status {
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index ca5fdb5fa..865bd78ff 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -2,7 +2,6 @@
 
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenAck;
 use ibc_core_connection_types::msgs::MsgConnectionOpenAck;
@@ -56,13 +55,9 @@ where
     {
         let client_state_of_b_on_a = ctx_a.client_state(vars.client_id_on_a())?;
 
-        {
-            let status = client_state_of_b_on_a
-                .status(ctx_a.get_client_validation_context(), vars.client_id_on_a())?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), vars.client_id_on_a())?
+            .verify_is_active()?;
         client_state_of_b_on_a.validate_proof_height(msg.proofs_height_on_b)?;
 
         let client_cons_state_path_on_a = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
index a6a53f6e9..f265c6029 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
@@ -2,7 +2,6 @@
 
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenConfirm;
 use ibc_core_connection_types::msgs::MsgConnectionOpenConfirm;
@@ -45,13 +44,9 @@ where
     {
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_init.rs b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
index b7deac746..2f4a4506d 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_init.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
@@ -1,6 +1,5 @@
 //! Protocol logic specific to ICS3 messages of type `MsgConnectionOpenInit`.
 use ibc_core_client::context::client_state::ClientStateValidation;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::events::OpenInit;
 use ibc_core_connection_types::msgs::MsgConnectionOpenInit;
 use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
@@ -20,13 +19,9 @@ where
     // An IBC client running on the local (host) chain should exist.
     let client_state_of_b_on_a = ctx_a.client_state(&msg.client_id_on_a)?;
 
-    {
-        let status = client_state_of_b_on_a
-            .status(ctx_a.get_client_validation_context(), &msg.client_id_on_a)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    client_state_of_b_on_a
+        .status(ctx_a.get_client_validation_context(), &msg.client_id_on_a)?
+        .verify_is_active()?;
 
     if let Some(version) = msg.version {
         version.verify_is_supported(&ctx_a.get_compatible_versions())?;
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index 61bd339a2..8ddd3c274 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -1,7 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenTry;
 use ibc_core_connection_types::msgs::MsgConnectionOpenTry;
@@ -55,13 +54,9 @@ where
     {
         let client_state_of_a_on_b = ctx_b.client_state(vars.conn_end_on_b.client_id())?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), &msg.client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), &msg.client_id_on_b)?
+            .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proofs_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/acknowledgement.rs b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
index 2ae3a39e6..516d581e6 100644
--- a/ibc-core/ics04-channel/src/handler/acknowledgement.rs
+++ b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
@@ -5,7 +5,6 @@ use ibc_core_channel_types::events::AcknowledgePacket;
 use ibc_core_channel_types::msgs::MsgAcknowledgement;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
@@ -178,13 +177,9 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        {
-            let status = client_state_of_b_on_a
-                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+            .verify_is_active()?;
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
index 30024afd3..dd3b51b06 100644
--- a/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
@@ -6,7 +6,6 @@ use ibc_core_channel_types::events::CloseConfirm;
 use ibc_core_channel_types::msgs::MsgChannelCloseConfirm;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -115,13 +114,9 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/chan_close_init.rs b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
index a7f03163e..fe7588361 100644
--- a/ibc-core/ics04-channel/src/handler/chan_close_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
@@ -4,7 +4,6 @@ use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::CloseInit;
 use ibc_core_channel_types::msgs::MsgChannelCloseInit;
 use ibc_core_client::context::client_state::ClientStateValidation;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -112,13 +111,9 @@ where
 
     let client_id_on_a = conn_end_on_a.client_id();
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
-    {
-        let status =
-            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    client_state_of_b_on_a
+        .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+        .verify_is_active()?;
 
     Ok(())
 }
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_ack.rs b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
index c40fb2561..5bf0e3211 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
@@ -5,7 +5,6 @@ use ibc_core_channel_types::events::OpenAck;
 use ibc_core_channel_types::msgs::MsgChannelOpenAck;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -112,13 +111,9 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        {
-            let status = client_state_of_b_on_a
-                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+            .verify_is_active()?;
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
index 5ef8bd769..bb9920d3b 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
@@ -6,7 +6,6 @@ use ibc_core_channel_types::events::OpenConfirm;
 use ibc_core_channel_types::msgs::MsgChannelOpenConfirm;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -117,13 +116,9 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_init.rs b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
index 31f74ce0c..81f645204 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
@@ -4,7 +4,6 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State};
 use ibc_core_channel_types::events::OpenInit;
 use ibc_core_channel_types::msgs::MsgChannelOpenInit;
 use ibc_core_client::context::client_state::ClientStateValidation;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::types::identifiers::ChannelId;
@@ -123,13 +122,9 @@ where
     let client_id_on_a = conn_end_on_a.client_id();
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-    {
-        let status =
-            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    client_state_of_b_on_a
+        .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+        .verify_is_active()?;
 
     let conn_version = conn_end_on_a.versions();
 
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_try.rs b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
index cbc9ec590..80888b0b1 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_try.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
@@ -6,7 +6,6 @@ use ibc_core_channel_types::events::OpenTry;
 use ibc_core_channel_types::msgs::MsgChannelOpenTry;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -138,13 +137,10 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .verify_is_active()?;
+
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/recv_packet.rs b/ibc-core/ics04-channel/src/handler/recv_packet.rs
index cc59d9100..bd32a3258 100644
--- a/ibc-core/ics04-channel/src/handler/recv_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/recv_packet.rs
@@ -6,7 +6,6 @@ use ibc_core_channel_types::msgs::MsgRecvPacket;
 use ibc_core_channel_types::packet::Receipt;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
@@ -182,13 +181,10 @@ where
         let client_id_on_b = conn_end_on_b.client_id();
         let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
 
-        {
-            let status = client_state_of_a_on_b
-                .status(ctx_b.get_client_validation_context(), client_id_on_b)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_a_on_b
+            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .verify_is_active()?;
+
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
         let client_cons_state_path_on_b = ClientConsensusStatePath::new(
diff --git a/ibc-core/ics04-channel/src/handler/send_packet.rs b/ibc-core/ics04-channel/src/handler/send_packet.rs
index da97c51c2..a0f3405c0 100644
--- a/ibc-core/ics04-channel/src/handler/send_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/send_packet.rs
@@ -5,7 +5,6 @@ use ibc_core_channel_types::events::SendPacket;
 use ibc_core_channel_types::packet::Packet;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::types::path::{
@@ -54,13 +53,9 @@ pub fn send_packet_validate(
 
     let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-    {
-        let status =
-            client_state_of_b_on_a.status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-        if !status.is_active() {
-            return Err(ClientError::ClientNotActive { status }.into());
-        }
-    }
+    client_state_of_b_on_a
+        .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+        .verify_is_active()?;
 
     let latest_height_on_a = client_state_of_b_on_a.latest_height();
 
diff --git a/ibc-core/ics04-channel/src/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
index 0cfed7c03..adef59bfb 100644
--- a/ibc-core/ics04-channel/src/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -5,7 +5,6 @@ use ibc_core_channel_types::events::{ChannelClosed, TimeoutPacket};
 use ibc_core_channel_types::msgs::{MsgTimeout, MsgTimeoutOnClose};
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -189,13 +188,10 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        {
-            let status = client_state_of_b_on_a
-                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+            .verify_is_active()?;
+
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         // check that timeout height or timeout timestamp has passed on the other end
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index c08c0e8d3..eb6224a4b 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -4,7 +4,6 @@ use ibc_core_channel_types::error::{ChannelError, PacketError};
 use ibc_core_channel_types::msgs::MsgTimeoutOnClose;
 use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::types::error::ClientError;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_host::types::path::{
@@ -68,13 +67,10 @@ where
         let client_id_on_a = conn_end_on_a.client_id();
         let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
 
-        {
-            let status = client_state_of_b_on_a
-                .status(ctx_a.get_client_validation_context(), client_id_on_a)?;
-            if !status.is_active() {
-                return Err(ClientError::ClientNotActive { status }.into());
-            }
-        }
+        client_state_of_b_on_a
+            .status(ctx_a.get_client_validation_context(), client_id_on_a)?
+            .verify_is_active()?;
+
         client_state_of_b_on_a.validate_proof_height(msg.proof_height_on_b)?;
 
         let client_cons_state_path_on_a = ClientConsensusStatePath::new(

From 3894b50929e207eea3653e8bea3c70048d783d8c Mon Sep 17 00:00:00 2001
From: Yuanchao Sun <yuanchao.sun@gmail.com>
Date: Sun, 17 Dec 2023 00:27:06 +0800
Subject: [PATCH 077/182] fix: packet sequence in Timeout handlers should be
 encoded in big-endian (#1004)

* fix: encode package sequence into big endian bytes

* Fix this issue in `to_vec` method.
---
 .../bug-fixes/1004-fix-packet-sequence-encoding.md          | 2 ++
 ibc-core/ics24-host/types/src/identifiers/sequence.rs       | 6 ++----
 2 files changed, 4 insertions(+), 4 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md

diff --git a/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md b/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md
new file mode 100644
index 000000000..e6e8f84a4
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md
@@ -0,0 +1,2 @@
+- Encode packet sequence into a big endian bytes.
+  ([\#1004](https://github.com/cosmos/ibc-rs/pull/1004))
\ No newline at end of file
diff --git a/ibc-core/ics24-host/types/src/identifiers/sequence.rs b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
index ece48903b..7919ba56e 100644
--- a/ibc-core/ics24-host/types/src/identifiers/sequence.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
@@ -1,5 +1,4 @@
 use ibc_primitives::prelude::*;
-use ibc_primitives::ToVec;
 
 use crate::error::IdentifierError;
 
@@ -50,10 +49,9 @@ impl Sequence {
         Sequence(self.0 + 1)
     }
 
-    /// Encodes the sequence number into a `Vec<u8>` using
-    /// `prost::Message::encode_to_vec`.
+    /// Encodes the sequence number into a byte array in big endian.
     pub fn to_vec(&self) -> Vec<u8> {
-        self.0.to_vec()
+        self.0.to_be_bytes().to_vec()
     }
 }
 

From a6b225e911a6b6945668eb3399f4ab8be1281cde Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Mon, 18 Dec 2023 20:36:27 +0100
Subject: [PATCH 078/182] feat: derive AsRef for CommitmentProofBytes (#1008)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* feat: derive AsRef for CommitmentProofBytes

Derive AsRef for CommitmentProofBytes so it’s possible to access its
underlying bytes without having to own it.

The type can be converted into Vec but that requires ownership.  If all
one has is a reference to the proof bytes (as in verify_membership
method for example), there’s no way to access underlying bytes without
cloning it first.

With derive_more::AsRef added, one can now use as_ref method to borrow
the underlying byets slice.

Whilo at it.  Replace explicit From implementation by derive_more::Into
and get rid of unnecessary clone inside of conversion into MerkleProof.

* log

* nit: remove now redundant clones

* chore: remove redundant conversion to MerkleProof from owned CommitmentProofBytes

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1008-commitment-proof-bytes-as-ref.md     |  4 ++++
 .../ics07-tendermint/src/client_state.rs      |  4 ++--
 ibc-core/ics23-commitment/types/Cargo.toml    |  5 ++---
 .../ics23-commitment/types/src/commitment.rs  | 19 ++++++-------------
 4 files changed, 14 insertions(+), 18 deletions(-)
 create mode 100644 .changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md

diff --git a/.changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md b/.changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md
new file mode 100644
index 000000000..aaedebef0
--- /dev/null
+++ b/.changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md
@@ -0,0 +1,4 @@
+- `[ibc-core-commitment-types`] implement `AsRef<Vec<u8>>` and
+  `AsRef<[u8]>` for `CommitmentProofBytes` so it’s possible to gain
+  access to the proof byte slice without having to own the object.
+  ([#1008](https://github.com/cosmos/ibc-rs/pull/1008))
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 35ac0ac09..32fcc5a57 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -199,7 +199,7 @@ impl ClientStateCommon for ClientState {
     ) -> Result<(), ClientError> {
         let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
         let merkle_proof =
-            MerkleProof::try_from(proof.clone()).map_err(ClientError::InvalidCommitmentProof)?;
+            MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
 
         merkle_proof
             .verify_membership(
@@ -221,7 +221,7 @@ impl ClientStateCommon for ClientState {
     ) -> Result<(), ClientError> {
         let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
         let merkle_proof =
-            MerkleProof::try_from(proof.clone()).map_err(ClientError::InvalidCommitmentProof)?;
+            MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
 
         merkle_proof
             .verify_non_membership(&self.0.proof_specs, root.clone().into(), merkle_path)
diff --git a/ibc-core/ics23-commitment/types/Cargo.toml b/ibc-core/ics23-commitment/types/Cargo.toml
index fbda6e24d..15cd37dd4 100644
--- a/ibc-core/ics23-commitment/types/Cargo.toml
+++ b/ibc-core/ics23-commitment/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "commitment", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-23 Vector Commitments data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
@@ -20,7 +20,7 @@ all-features = true
 [dependencies]
 # external dependencies
 borsh           = { workspace = true, optional = true }
-derive_more     = { workspace = true }
+derive_more     = { workspace = true, features = ["as_ref"] }
 displaydoc      = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
@@ -69,4 +69,3 @@ parity-scale-codec = [
     "ibc-primitives/parity-scale-codec",
     "ibc-proto/parity-scale-codec",
 ]
-
diff --git a/ibc-core/ics23-commitment/types/src/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
index 009a78f2c..b24b60a88 100644
--- a/ibc-core/ics23-commitment/types/src/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -71,7 +71,8 @@ impl From<Vec<u8>> for CommitmentRoot {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "serde", serde(transparent))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, PartialEq, Eq)]
+#[derive(Clone, PartialEq, Eq, derive_more::AsRef, derive_more::Into)]
+#[as_ref(forward)]
 pub struct CommitmentProofBytes {
     #[cfg_attr(
         feature = "serde",
@@ -101,12 +102,6 @@ impl TryFrom<Vec<u8>> for CommitmentProofBytes {
     }
 }
 
-impl From<CommitmentProofBytes> for Vec<u8> {
-    fn from(p: CommitmentProofBytes) -> Vec<u8> {
-        p.bytes
-    }
-}
-
 impl TryFrom<RawMerkleProof> for CommitmentProofBytes {
     type Error = CommitmentError;
 
@@ -123,14 +118,12 @@ impl TryFrom<MerkleProof> for CommitmentProofBytes {
     }
 }
 
-impl TryFrom<CommitmentProofBytes> for MerkleProof {
+impl<'a> TryFrom<&'a CommitmentProofBytes> for MerkleProof {
     type Error = CommitmentError;
 
-    fn try_from(value: CommitmentProofBytes) -> Result<Self, Self::Error> {
-        let value: Vec<u8> = value.into();
-        let merkle_proof = Protobuf::<RawMerkleProof>::decode(value.as_ref())
-            .map_err(|e| CommitmentError::DecodingFailure(e.to_string()))?;
-        Ok(merkle_proof)
+    fn try_from(value: &'a CommitmentProofBytes) -> Result<Self, Self::Error> {
+        Protobuf::<RawMerkleProof>::decode(value.as_ref())
+            .map_err(|e| CommitmentError::DecodingFailure(e.to_string()))
     }
 }
 

From 38f746db2e65fb3eb64ef5fc783c1d0c947aba88 Mon Sep 17 00:00:00 2001
From: Dhruv D Jain <dhruv@iamsizzling.com>
Date: Tue, 19 Dec 2023 01:23:20 +0530
Subject: [PATCH 079/182] fix: recursive call in connection `State` conversion
 to `i32` (#1010)

* fix state conversion recursive call

* replace match with casting

Co-authored-by: Michal Nazarewicz <mina86@mina86.com>
Signed-off-by: Dhruv D Jain <dhruv@iamsizzling.com>

* chore: add unclog

* nit

---------

Signed-off-by: Dhruv D Jain <dhruv@iamsizzling.com>
Co-authored-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1010-fix-recursive-call-in-conn-state-converstion-to-i32.md | 2 ++
 ibc-core/ics03-connection/types/src/connection.rs               | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md

diff --git a/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md b/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
new file mode 100644
index 000000000..337ba7642
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
@@ -0,0 +1,2 @@
+- `[ibc-core-connection-types]` Fix recursive call in connection `State`
+  conversion to `i32` ([#1010](https://github.com/cosmos/ibc-rs/issues/1010))
diff --git a/ibc-core/ics03-connection/types/src/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
index 2af44ec5f..d73d53930 100644
--- a/ibc-core/ics03-connection/types/src/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -559,6 +559,6 @@ impl TryFrom<i32> for State {
 
 impl From<State> for i32 {
     fn from(value: State) -> Self {
-        value.into()
+        value as i32
     }
 }

From d2a91ead86dea9a36580ca191bedd8935b5fe040 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 18 Dec 2023 12:26:36 -0800
Subject: [PATCH 080/182] imp: derive Hash on Timestamp instead of explicit
 implementation (#1011)

---
 .../improvements/1011-status-verify-active.md      |  2 ++
 ibc-primitives/src/types/timestamp.rs              | 14 ++------------
 2 files changed, 4 insertions(+), 12 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1011-status-verify-active.md

diff --git a/.changelog/unreleased/improvements/1011-status-verify-active.md b/.changelog/unreleased/improvements/1011-status-verify-active.md
new file mode 100644
index 000000000..65b3e911a
--- /dev/null
+++ b/.changelog/unreleased/improvements/1011-status-verify-active.md
@@ -0,0 +1,2 @@
+- `[ibc-primitives]` Derive `Hash` on `Timestamp` instead of explicit
+  implementation ([#1011](https://github.com/cosmos/ibc-rs/pull/1005))
diff --git a/ibc-primitives/src/types/timestamp.rs b/ibc-primitives/src/types/timestamp.rs
index ef54a4630..c7d8e5aae 100644
--- a/ibc-primitives/src/types/timestamp.rs
+++ b/ibc-primitives/src/types/timestamp.rs
@@ -1,7 +1,7 @@
 //! Defines the representation of timestamps used in IBC.
 
 use core::fmt::{Display, Error as FmtError, Formatter};
-use core::hash::{Hash, Hasher};
+use core::hash::Hash;
 use core::num::ParseIntError;
 use core::ops::{Add, Sub};
 use core::str::FromStr;
@@ -24,7 +24,7 @@ pub const ZERO_DURATION: Duration = Duration::from_secs(0);
 /// of timestamp.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(PartialEq, Eq, Copy, Clone, Debug, Default, PartialOrd, Ord)]
+#[derive(PartialEq, Eq, Copy, Clone, Debug, Default, PartialOrd, Ord, Hash)]
 pub struct Timestamp {
     // Note: The schema representation is the timestamp in nanoseconds (as we do with borsh).
     #[cfg_attr(feature = "schema", schemars(with = "u64"))]
@@ -85,16 +85,6 @@ impl scale_info::TypeInfo for Timestamp {
     }
 }
 
-// TODO: derive when tendermint::Time supports it:
-// https://github.com/informalsystems/tendermint-rs/pull/1054
-#[allow(clippy::derived_hash_with_manual_eq)]
-impl Hash for Timestamp {
-    fn hash<H: Hasher>(&self, state: &mut H) {
-        let odt: Option<OffsetDateTime> = self.time.map(Into::into);
-        odt.hash(state);
-    }
-}
-
 /// The expiry result when comparing two timestamps.
 /// - If either timestamp is invalid (0), the result is `InvalidTimestamp`.
 /// - If the left timestamp is strictly after the right timestamp, the result is `Expired`.

From 7ff743b4c55e6074d9cc15d94b1fb84d4510a61a Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Thu, 21 Dec 2023 15:50:12 -0600
Subject: [PATCH 081/182] imp: Implement custom JSON and Borsh deserialization
 for `ChainId` (#1013)

* Add ChainId json deserialize test

* Add BorshDeserialization test

* Add some debugging to ChainId deserialize impl

* Change assertion to unwrap

* First stab at custom Visitor and Deserialize impls

* Implement custom Deserialize for ChainId

* Remove unnecessary ChainId::from_str call

* Add some additional assertions to test valid ChainIds

* Stub out custom BorshDeserialize impl

* Get custom borshDeserialize impl compiling

* Add rstest test case testing invalid borsh deserialization

* Add changelog entry

* Cargo fmt

* Incorporate some PR feedback

* Remove expanded.rs file

* Remove expanded.rs file

* Clean up borshDeserialize impl

* Add test the verifies valid borsh deserialization

* Update BorshDeserialize test

* test: add test_valid_borsh_ser_de_roundtrip

* Clean up

* nit

* Move `use core::fmt` statement into serde::Deserialize impl

* fix: core::fmt::Result

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../996-custom-chain-id-deserialization.md    |   1 +
 ibc-core/ics24-host/Cargo.toml                |   2 +-
 ibc-core/ics24-host/types/Cargo.toml          |   3 +-
 .../types/src/identifiers/chain_id.rs         | 201 +++++++++++++++++-
 4 files changed, 199 insertions(+), 8 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/996-custom-chain-id-deserialization.md

diff --git a/.changelog/unreleased/improvements/996-custom-chain-id-deserialization.md b/.changelog/unreleased/improvements/996-custom-chain-id-deserialization.md
new file mode 100644
index 000000000..c77fda22d
--- /dev/null
+++ b/.changelog/unreleased/improvements/996-custom-chain-id-deserialization.md
@@ -0,0 +1 @@
+- `[ibc-core-host-types]` Implement custom JSON and Borsh deserialization for `ChainId` ([#996](https://github.com/cosmos/ibc-rs/pull/1013))
\ No newline at end of file
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index 0726eea08..79adcf6e5 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -88,4 +88,4 @@ parity-scale-codec = [
     "ibc-core-host-types/parity-scale-codec",
     "ibc-core-handler-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
-]
\ No newline at end of file
+]
diff --git a/ibc-core/ics24-host/types/Cargo.toml b/ibc-core/ics24-host/types/Cargo.toml
index 8f725aef9..5c007e8cb 100644
--- a/ibc-core/ics24-host/types/Cargo.toml
+++ b/ibc-core/ics24-host/types/Cargo.toml
@@ -33,7 +33,8 @@ parity-scale-codec  = { workspace = true, optional = true }
 scale-info          = { workspace = true, optional = true }
 
 [dev-dependencies]
-rstest = { workspace = true }
+rstest     = { workspace = true }
+serde_json = { workspace = true }
 
 [features]
 default = ["std"]
diff --git a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
index a88fdc940..c40904b1b 100644
--- a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
@@ -2,6 +2,8 @@ use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use ibc_primitives::prelude::*;
+#[cfg(feature = "serde")]
+use serde::de::{Deserialize, Deserializer, Error, MapAccess, Visitor};
 
 use crate::error::IdentifierError;
 use crate::validate::{
@@ -24,11 +26,8 @@ use crate::validate::{
         scale_info::TypeInfo
     )
 )]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "borsh", derive(borsh::BorshSerialize))]
+#[cfg_attr(feature = "serde", derive(serde::Serialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 pub struct ChainId {
@@ -116,6 +115,146 @@ impl ChainId {
     }
 }
 
+#[cfg(feature = "serde")]
+impl<'de> Deserialize<'de> for ChainId {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: Deserializer<'de>,
+    {
+        const FIELDS: &[&str] = &["id", "revision_number"];
+
+        enum Field {
+            Id,
+            RevisionNumber,
+        }
+
+        impl<'de> Deserialize<'de> for Field {
+            fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+            where
+                D: Deserializer<'de>,
+            {
+                struct FieldVisitor;
+
+                impl<'de> Visitor<'de> for FieldVisitor {
+                    type Value = Field;
+
+                    fn expecting(&self, formatter: &mut Formatter<'_>) -> core::fmt::Result {
+                        write!(formatter, "expected one of: {:?}", &FIELDS)
+                    }
+
+                    fn visit_str<E>(self, value: &str) -> Result<Field, E>
+                    where
+                        E: Error,
+                    {
+                        match value {
+                            "id" => Ok(Field::Id),
+                            "revisionNumber" | "revision_number" => Ok(Field::RevisionNumber),
+                            _ => Err(Error::unknown_field(value, FIELDS)),
+                        }
+                    }
+                }
+
+                deserializer.deserialize_identifier(FieldVisitor)
+            }
+        }
+
+        struct ChainIdVisitor;
+
+        impl<'de> Visitor<'de> for ChainIdVisitor {
+            type Value = ChainId;
+
+            fn expecting(&self, formatter: &mut Formatter<'_>) -> core::fmt::Result {
+                formatter.write_str("struct ChainId")
+            }
+
+            fn visit_map<V>(self, mut map: V) -> Result<Self::Value, V::Error>
+            where
+                V: MapAccess<'de>,
+            {
+                let mut id = None;
+                let mut revision_number = None;
+
+                while let Some(key) = map.next_key()? {
+                    match key {
+                        Field::Id => {
+                            if id.is_some() {
+                                return Err(Error::duplicate_field("id"));
+                            }
+
+                            let next_value = map.next_value::<&str>()?;
+
+                            let chain_id = ChainId::from_str(next_value)
+                                .map_err(|_| Error::custom("failed to parse ChainId `id` field"))?;
+
+                            id = Some(chain_id.id);
+                            revision_number = Some(chain_id.revision_number);
+                        }
+                        Field::RevisionNumber => {
+                            let next_value = map.next_value::<&str>()?;
+                            let rev = u64::from_str(next_value).unwrap_or(0);
+
+                            if let Some(rn) = revision_number {
+                                if rev != 0 && rn != rev {
+                                    return Err(Error::custom(format_args!(
+                                        "chain ID revision numbers do not match; got `{}` and `{}`",
+                                        rn, rev,
+                                    )));
+                                }
+                            } else {
+                                revision_number = Some(rev);
+                            }
+                        }
+                    }
+                }
+
+                let id = id.ok_or_else(|| Error::missing_field("id"))?;
+
+                Ok(ChainId {
+                    id,
+                    revision_number: revision_number.unwrap_or(0),
+                })
+            }
+        }
+
+        deserializer.deserialize_struct("ChainId", FIELDS, ChainIdVisitor)
+    }
+}
+
+#[cfg(feature = "borsh")]
+mod borsh_impls {
+    use borsh::maybestd::io::{self, Error, ErrorKind, Read};
+    use borsh::BorshDeserialize;
+
+    use super::*;
+
+    impl BorshDeserialize for ChainId {
+        fn deserialize_reader<R: Read>(reader: &mut R) -> io::Result<Self> {
+            let (id, revision_number) = <(String, u64)>::deserialize_reader(reader)?;
+
+            match parse_chain_id_string(&id) {
+                Ok((_, rn)) => {
+                    if revision_number != 0 && rn != revision_number {
+                        return Err(Error::new(
+                            ErrorKind::Other,
+                            "chain ID revision numbers do not match",
+                        ));
+                    }
+                }
+                _ => {
+                    if revision_number != 0 {
+                        return Err(Error::new(ErrorKind::Other, "failed to parse chain ID"));
+                    }
+                }
+            }
+
+            Ok(ChainId {
+                id,
+                revision_number,
+            })
+        }
+    }
+}
+
 /// Construct a `ChainId` from a string literal only if it forms a valid
 /// identifier.
 impl FromStr for ChainId {
@@ -250,7 +389,7 @@ mod tests {
     #[case(" -")]
     #[case("   -1")]
     #[case("/chainA-1")]
-    fn test_invalid_chain_id(#[case] chain_id_str: &str) {
+    fn test_invalid_chain_id_from_str(#[case] chain_id_str: &str) {
         assert!(ChainId::new(chain_id_str).is_err());
     }
 
@@ -275,4 +414,54 @@ mod tests {
         assert_eq!(chain_id.revision_number(), 0);
         assert_eq!(chain_id.as_str(), "chainA");
     }
+
+    #[cfg(feature = "serde")]
+    #[rstest]
+    #[case(r#"{"id":"foo-42","revision_number":"42"}"#)]
+    #[case(r#"{"id":"foo-42","revision_number":"0"}"#)]
+    #[case(r#"{"id":"foo-bar-42","revision_number":"0"}"#)]
+    fn test_valid_chain_id_json_deserialization(#[case] chain_id_json: &str) {
+        let chain_id = serde_json::from_str::<ChainId>(chain_id_json);
+        assert!(chain_id.is_ok());
+
+        let chain_id = chain_id.unwrap();
+
+        let (_id, rev_num) = chain_id.split_chain_id().unwrap();
+
+        assert_eq!(rev_num, chain_id.revision_number());
+    }
+
+    #[cfg(feature = "serde")]
+    #[rstest]
+    #[case(r#"{"id":"foo-42","revision_number":"69"}"#)]
+    #[case(r#"{"id":"foo-0","revision_number":"69"}"#)]
+    #[case(r#"{"id":"/foo-42","revision_number":"0"}"#)]
+    fn test_invalid_chain_id_json_deserialization(#[case] chain_id_json: &str) {
+        assert!(serde_json::from_str::<ChainId>(chain_id_json).is_err())
+    }
+
+    #[cfg(feature = "borsh")]
+    #[rstest]
+    #[case(b"\x06\0\0\0foo-42\x45\0\0\0\0\0\0\0")]
+    fn test_invalid_chain_id_borsh_deserialization(#[case] chain_id_bytes: &[u8]) {
+        use borsh::BorshDeserialize;
+
+        assert!(ChainId::try_from_slice(chain_id_bytes).is_err())
+    }
+
+    #[cfg(feature = "borsh")]
+    fn borsh_ser_de_roundtrip(chain_id: ChainId) {
+        use borsh::{BorshDeserialize, BorshSerialize};
+
+        let chain_id_bytes = chain_id.try_to_vec().unwrap();
+        let res = ChainId::try_from_slice(&chain_id_bytes).unwrap();
+        assert_eq!(chain_id, res);
+    }
+
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_valid_borsh_ser_de_roundtrip() {
+        borsh_ser_de_roundtrip(ChainId::new("foo-42").unwrap());
+        borsh_ser_de_roundtrip(ChainId::new("foo").unwrap());
+    }
 }

From 9c29cb420983f32b848bb0dac592d118f55ab434 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Thu, 21 Dec 2023 23:49:12 +0100
Subject: [PATCH 082/182] imp: avoid unnecessary clones and validations when
 creating ClientId (#1015)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* imp: avoid unnecessary clones and validations when creating ClientId

Introduce ClientType::get_client_id method which constructs a new
ClientId but forgoes client type verification.  The client type has
already been verified at creation and the verification guarantees that
formatted ClientId will also be valid.

Furthermore, rewrite ClientId::new so that it doesn’t take ownership
of the client type and doesn’t allocated temporary strings.
Furthermore, since ClinetType::get_client_id is now a thing, change
the client type argument to be `&str` so that constructing ids from
string client type is easier.

* wip

* clippy

* Update .changelog/unreleased/breaking-changes/1014-better-client-id-new.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

* build_client_id

* drop variant

* Update 1014-better-client-id-new.md

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>

---------

Signed-off-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../1014-better-client-id-new.md              |  4 ++
 .../ics02-client/src/handler/create_client.rs | 22 +--------
 ibc-core/ics02-client/types/src/error.rs      | 10 ----
 ibc-core/ics03-connection/types/src/events.rs |  4 +-
 .../types/src/identifiers/client_id.rs        | 47 ++++++++++---------
 .../types/src/identifiers/client_type.rs      | 35 +++++++++-----
 ibc-testkit/src/fixtures/core/client/mod.rs   |  2 +-
 ibc-testkit/src/relayer/context.rs            |  4 +-
 .../tests/core/ics02_client/create_client.rs  | 13 +----
 .../tests/core/ics02_client/update_client.rs  | 22 ++++-----
 .../tests/core/ics02_client/upgrade_client.rs |  3 +-
 .../core/ics04_channel/chan_close_confirm.rs  |  6 +--
 .../core/ics04_channel/chan_close_init.rs     |  6 +--
 .../tests/core/ics04_channel/chan_open_ack.rs |  2 +-
 .../core/ics04_channel/chan_open_confirm.rs   |  2 +-
 .../core/ics04_channel/chan_open_init.rs      |  4 +-
 .../tests/core/ics04_channel/chan_open_try.rs |  2 +-
 17 files changed, 85 insertions(+), 103 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1014-better-client-id-new.md

diff --git a/.changelog/unreleased/breaking-changes/1014-better-client-id-new.md b/.changelog/unreleased/breaking-changes/1014-better-client-id-new.md
new file mode 100644
index 000000000..2c7ad406e
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1014-better-client-id-new.md
@@ -0,0 +1,4 @@
+- `[ibc-core-host-types]` Introduce `ClientType::build_client_id` which avoids unnecessary validaiton.
+  ([#1014](https://github.com/cosmos/ibc-rs/issues/1014))
+- `[ibc-core-host-types]` Optimise `ClientId::new` to avoid unnecessary validaiton and temporary
+  string allocation. ([#1014](https://github.com/cosmos/ibc-rs/issues/1014))
diff --git a/ibc-core/ics02-client/src/handler/create_client.rs b/ibc-core/ics02-client/src/handler/create_client.rs
index c4624fefb..d0e1d4d0a 100644
--- a/ibc-core/ics02-client/src/handler/create_client.rs
+++ b/ibc-core/ics02-client/src/handler/create_client.rs
@@ -6,7 +6,6 @@ use ibc_core_client_types::events::CreateClient;
 use ibc_core_client_types::msgs::MsgCreateClient;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
-use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
 
@@ -29,15 +28,7 @@ where
 
     client_state.verify_consensus_state(consensus_state)?;
 
-    let client_type = client_state.client_type();
-
-    let client_id = ClientId::new(client_type, id_counter).map_err(|e| {
-        ClientError::ClientIdentifierConstructor {
-            client_type: client_state.client_type(),
-            counter: id_counter,
-            validation_error: e,
-        }
-    })?;
+    let client_id = client_state.client_type().build_client_id(id_counter);
 
     if ctx.client_state(&client_id).is_ok() {
         return Err(ClientError::ClientStateAlreadyExists { client_id }.into());
@@ -58,18 +49,9 @@ where
 
     // Construct this client's identifier
     let id_counter = ctx.client_counter()?;
-
     let client_state = ctx.decode_client_state(client_state)?;
-
     let client_type = client_state.client_type();
-
-    let client_id = ClientId::new(client_type.clone(), id_counter).map_err(|e| {
-        ContextError::from(ClientError::ClientIdentifierConstructor {
-            client_type: client_type.clone(),
-            counter: id_counter,
-            validation_error: e,
-        })
-    })?;
+    let client_id = client_type.build_client_id(id_counter);
 
     client_state.initialise(
         ctx.get_client_execution_context(),
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 57352297d..fbfcebcb1 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -16,12 +16,6 @@ use crate::height::Height;
 pub enum ClientError {
     /// upgrade client error: `{0}`
     Upgrade(UpgradeClientError),
-    /// Client identifier constructor failed for type `{client_type}` with counter `{counter}`, validation error: `{validation_error}`
-    ClientIdentifierConstructor {
-        client_type: ClientType,
-        counter: u64,
-        validation_error: IdentifierError,
-    },
     /// client is frozen with description: `{description}`
     ClientFrozen { description: String },
     /// client is not active. Status=`{status}`
@@ -118,10 +112,6 @@ impl From<&'static str> for ClientError {
 impl std::error::Error for ClientError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            Self::ClientIdentifierConstructor {
-                validation_error: e,
-                ..
-            } => Some(e),
             Self::InvalidMsgUpdateClientId(e) => Some(e),
             Self::InvalidClientIdentifier(e) => Some(e),
             Self::InvalidRawMisbehaviour(e) => Some(e),
diff --git a/ibc-core/ics03-connection/types/src/events.rs b/ibc-core/ics03-connection/types/src/events.rs
index 4b6ef6df0..0d10512a4 100644
--- a/ibc-core/ics03-connection/types/src/events.rs
+++ b/ibc-core/ics03-connection/types/src/events.rs
@@ -324,9 +324,9 @@ mod tests {
         let client_type = ClientType::from_str("07-tendermint")
             .expect("never fails because it's a valid client type");
         let conn_id_on_a = ConnectionId::default();
-        let client_id_on_a = ClientId::new(client_type.clone(), 0).unwrap();
+        let client_id_on_a = client_type.build_client_id(0);
         let conn_id_on_b = ConnectionId::new(1);
-        let client_id_on_b = ClientId::new(client_type, 1).unwrap();
+        let client_id_on_b = client_type.build_client_id(1);
         let expected_keys = vec![
             "connection_id",
             "client_id",
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_id.rs b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
index 627b0155f..62a5662d6 100644
--- a/ibc-core/ics24-host/types/src/identifiers/client_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
@@ -1,10 +1,8 @@
-use core::fmt::{Debug, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use derive_more::Into;
 use ibc_primitives::prelude::*;
 
-use super::ClientType;
 use crate::error::IdentifierError;
 use crate::validate::{validate_client_identifier, validate_client_type};
 
@@ -22,27 +20,41 @@ use crate::validate::{validate_client_identifier, validate_client_type};
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Into, derive_more::Display)]
 pub struct ClientId(String);
 
 impl ClientId {
-    /// Builds a new client identifier. Client identifiers are deterministically formed from two
-    /// elements: a prefix derived from the client type `ctype`, and a monotonically increasing
-    /// `counter`; these are separated by a dash "-".
+    /// Builds a new client identifier.
+    ///
+    /// Client identifiers are deterministically formed from two elements:
+    /// a prefix derived from the client type `ctype`, and a monotonically
+    /// increasing `counter`; these are separated by a dash "-".
+    ///
+    /// See also [`ClientType::build_client_id`](super::ClientType::build_client_id)
+    /// method.
+    ///
+    /// # Example
     ///
     /// ```
     /// # use ibc_core_host_types::identifiers::ClientId;
     /// # use ibc_core_host_types::identifiers::ClientType;
     /// # use std::str::FromStr;
-    /// let tm_client_id = ClientId::new(ClientType::from_str("07-tendermint").unwrap(), 0);
-    /// assert!(tm_client_id.is_ok());
-    /// tm_client_id.map(|id| { assert_eq!(&id, "07-tendermint-0") });
+    /// let client_type = ClientType::from_str("07-tendermint").unwrap();
+    /// let client_id = &client_type.build_client_id(0);
+    /// assert_eq!(client_id.as_str(), "07-tendermint-0");
     /// ```
-    pub fn new(client_type: ClientType, counter: u64) -> Result<Self, IdentifierError> {
-        let prefix = client_type.as_str().trim();
-        validate_client_type(prefix)?;
-        let id = format!("{prefix}-{counter}");
-        Self::from_str(id.as_str())
+    pub fn new(client_type: &str, counter: u64) -> Result<Self, IdentifierError> {
+        let client_type = client_type.trim();
+        validate_client_type(client_type).map(|()| Self::format(client_type, counter))
+    }
+
+    pub(super) fn format(client_type: &str, counter: u64) -> Self {
+        let client_id = format!("{client_type}-{counter}");
+        if cfg!(debug_assertions) {
+            validate_client_type(client_type).expect("valid client type");
+            validate_client_identifier(&client_id).expect("valid client id");
+        }
+        Self(client_id)
     }
 
     /// Get this identifier as a borrowed `&str`
@@ -56,13 +68,6 @@ impl ClientId {
     }
 }
 
-/// This implementation provides a `to_string` method.
-impl Display for ClientId {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}", self.0)
-    }
-}
-
 impl FromStr for ClientId {
     type Err = IdentifierError;
 
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_type.rs b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
index ff1968ebb..ee14147f8 100644
--- a/ibc-core/ics24-host/types/src/identifiers/client_type.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
@@ -1,10 +1,10 @@
 //! Defines the `ClientType` format, typically used in chain IDs.
 
-use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
 use ibc_primitives::prelude::*;
 
+use super::ClientId;
 use crate::error::IdentifierError;
 use crate::validate::validate_client_type;
 
@@ -22,15 +22,32 @@ use crate::validate::validate_client_type;
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 /// Type of the client, depending on the specific consensus algorithm.
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, derive_more::Display)]
 pub struct ClientType(String);
 
 impl ClientType {
     /// Constructs a new `ClientType` from the given `String` if it ends with a valid client identifier.
-    pub fn new(s: &str) -> Result<Self, IdentifierError> {
-        let s_trim = s.trim();
-        validate_client_type(s_trim)?;
-        Ok(Self(s_trim.to_string()))
+    pub fn new(client_type: &str) -> Result<Self, IdentifierError> {
+        let client_type = client_type.trim();
+        validate_client_type(client_type).map(|()| Self(client_type.into()))
+    }
+
+    /// Constructs a new [`ClientId`] with this types client type and given
+    /// `counter`.
+    ///
+    /// This is equivalent to `ClientId::new(self.as_str(), counter)` but
+    /// infallible since client type is assumed to be correct.
+    ///
+    /// ```
+    /// # use ibc_core_host_types::identifiers::ClientId;
+    /// # use ibc_core_host_types::identifiers::ClientType;
+    /// # use std::str::FromStr;
+    /// let client_type = ClientType::from_str("07-tendermint").unwrap();
+    /// let client_id = client_type.build_client_id(14);
+    /// assert_eq!(client_id.as_str(), "07-tendermint-14");
+    /// ```
+    pub fn build_client_id(&self, counter: u64) -> ClientId {
+        ClientId::format(self.as_str(), counter)
     }
 
     /// Yields this identifier as a borrowed `&str`
@@ -46,9 +63,3 @@ impl FromStr for ClientType {
         Self::new(s)
     }
 }
-
-impl Display for ClientType {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "ClientType({})", self.0)
-    }
-}
diff --git a/ibc-testkit/src/fixtures/core/client/mod.rs b/ibc-testkit/src/fixtures/core/client/mod.rs
index 2f3c477d4..a536d778c 100644
--- a/ibc-testkit/src/fixtures/core/client/mod.rs
+++ b/ibc-testkit/src/fixtures/core/client/mod.rs
@@ -35,7 +35,7 @@ mod tests {
 
         let client_type = ClientType::from_str("07-tendermint")
             .expect("never fails because it's a valid client type");
-        let client_id = ClientId::new(client_type.clone(), 0).unwrap();
+        let client_id = client_type.build_client_id(0);
         let consensus_height = Height::new(0, 5).unwrap();
         let consensus_heights = vec![Height::new(0, 5).unwrap(), Height::new(0, 7).unwrap()];
         let header: Any = dummy_new_mock_header(5).into();
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index 4ed1805f1..d2576f264 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -114,8 +114,8 @@ mod tests {
         let client_on_a_for_b_height = Height::new(1, 20).unwrap(); // Should be smaller than `chain_b_start_height`
         let num_iterations = 4;
 
-        let client_on_a_for_b = ClientId::new(tm_client_type(), 0).unwrap();
-        let client_on_b_for_a = ClientId::new(mock_client_type(), 0).unwrap();
+        let client_on_a_for_b = tm_client_type().build_client_id(0);
+        let client_on_b_for_a = mock_client_type().build_client_id(0);
 
         let chain_id_a = ChainId::new("mockgaiaA-1").unwrap();
         let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index fe69a4a05..86c316dcf 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -6,7 +6,6 @@ use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient};
 use ibc::core::client::types::Height;
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::ValidationContext;
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
@@ -37,11 +36,7 @@ fn test_create_client_ok() {
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
     let client_type = mock_client_type();
-
-    let client_id = {
-        let id_counter = ctx.client_counter().unwrap();
-        ClientId::new(client_type.clone(), id_counter).unwrap()
-    };
+    let client_id = client_type.build_client_id(ctx.client_counter().unwrap());
 
     let res = validate(&ctx, &router, msg_envelope.clone());
 
@@ -69,11 +64,7 @@ fn test_tm_create_client_ok() {
     let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone()).into();
 
     let client_type = tm_client_type();
-
-    let client_id = {
-        let id_counter = ctx.client_counter().unwrap();
-        ClientId::new(client_type.clone(), id_counter).unwrap()
-    };
+    let client_id = client_type.build_client_id(ctx.client_counter().unwrap());
 
     let msg = MsgCreateClient::new(
         tm_client_state,
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 9ef713dd9..67c52d41c 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -87,7 +87,7 @@ fn test_consensus_state_pruning() {
 
     let client_height = Height::new(1, 1).unwrap();
 
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
 
     let mut ctx = MockContextConfig::builder()
         .host_id(chain_id.clone())
@@ -198,7 +198,7 @@ fn test_update_nonexisting_client() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_adjacent_ok() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
@@ -252,7 +252,7 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_validator_change_ok() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
@@ -344,7 +344,7 @@ fn test_update_synthetic_tendermint_client_validator_change_ok() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_validator_change_fail() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
@@ -428,7 +428,7 @@ fn test_update_synthetic_tendermint_client_validator_change_fail() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
@@ -484,7 +484,7 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_duplicate_ok() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
 
     let ctx_a_chain_id = ChainId::new("mockgaiaA-1").unwrap();
@@ -610,7 +610,7 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
 
 #[test]
 fn test_update_synthetic_tendermint_client_lower_height() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
 
     let client_update_height = Height::new(1, 19).unwrap();
@@ -765,7 +765,7 @@ fn test_misbehaviour_nonexisting_client() {
 /// Misbehaviour evidence consists of equivocal headers.
 #[test]
 fn test_misbehaviour_synthetic_tendermint_equivocation() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let misbehaviour_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
@@ -829,7 +829,7 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
 
 #[test]
 fn test_misbehaviour_synthetic_tendermint_bft_time() {
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let misbehaviour_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
@@ -898,7 +898,7 @@ fn test_expired_client() {
     let update_height = Height::new(1, 21).unwrap();
     let client_height = update_height.sub(3).unwrap();
 
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
 
     let timestamp = Timestamp::now();
 
@@ -936,7 +936,7 @@ fn test_client_update_max_clock_drift() {
 
     let client_height = Height::new(1, 20).unwrap();
 
-    let client_id = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id = tm_client_type().build_client_id(0);
 
     let timestamp = Timestamp::now();
 
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index 6b7b3eff2..409576f0b 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -6,7 +6,6 @@ use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::downcast;
@@ -32,7 +31,7 @@ enum Msg {
 }
 
 fn msg_upgrade_client_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgUpgradeClient> {
-    let client_id = ClientId::new(mock_client_type(), 0).unwrap();
+    let client_id = mock_client_type().build_client_id(0);
 
     let ctx_default = MockContext::default();
     let ctx_with_client = ctx_default
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index 5e91a7be9..32c8dbb1f 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -8,7 +8,7 @@ use ibc::core::connection::types::{
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_confirm;
@@ -19,7 +19,7 @@ use ibc_testkit::testapp::ibc::core::types::MockContext;
 
 #[test]
 fn test_chan_close_confirm_validate() {
-    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
     let default_context = MockContext::default();
     let client_consensus_state_height = default_context.host_height().unwrap();
@@ -73,7 +73,7 @@ fn test_chan_close_confirm_validate() {
 
 #[test]
 fn test_chan_close_confirm_execute() {
-    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
     let default_context = MockContext::default();
     let client_consensus_state_height = default_context.host_height().unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 8ede99523..658a9a978 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -8,7 +8,7 @@ use ibc::core::connection::types::{
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_init;
@@ -19,7 +19,7 @@ use ibc_testkit::testapp::ibc::core::types::MockContext;
 
 #[test]
 fn test_chan_close_init_validate() {
-    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
 
     let conn_end = ConnectionEnd::new(
@@ -74,7 +74,7 @@ fn test_chan_close_init_validate() {
 
 #[test]
 fn test_chan_close_init_execute() {
-    let client_id = ClientId::new(mock_client_type(), 24).unwrap();
+    let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
 
     let conn_end = ConnectionEnd::new(
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index aec54f2ba..e652a2a7a 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -40,7 +40,7 @@ fn fixture() -> Fixture {
     let module_id = ModuleId::new(MODULE_ID_STR.to_string());
     let router = MockRouter::new_with_transfer();
 
-    let client_id_on_a = ClientId::new(mock_client_type(), 45).unwrap();
+    let client_id_on_a = mock_client_type().build_client_id(45);
     let conn_id_on_a = ConnectionId::new(2);
     let conn_end_on_a = ConnectionEnd::new(
         ConnectionState::Open,
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index c077c1e9e..d7b74a907 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -37,7 +37,7 @@ fn fixture() -> Fixture {
 
     let router = MockRouter::new_with_transfer();
 
-    let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
+    let client_id_on_b = mock_client_type().build_client_id(45);
     let conn_id_on_b = ConnectionId::new(2);
     let conn_end_on_b = ConnectionEnd::new(
         ConnectionState::Open,
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index 8d6b6172f..23077a7f0 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -6,7 +6,7 @@ use ibc::core::connection::types::{ConnectionEnd, State as ConnectionState};
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_init;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_init;
@@ -33,7 +33,7 @@ fn fixture() -> Fixture {
 
     let msg_conn_init = dummy_msg_conn_open_init();
 
-    let client_id_on_a = ClientId::new(tm_client_type(), 0).unwrap();
+    let client_id_on_a = tm_client_type().build_client_id(0);
     let client_height = Height::new(0, 10).unwrap();
 
     let conn_end_on_a = ConnectionEnd::new(
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index 09db155f7..9720afe81 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -32,7 +32,7 @@ pub struct Fixture {
 fn fixture() -> Fixture {
     let proof_height = 10;
     let conn_id_on_b = ConnectionId::new(2);
-    let client_id_on_b = ClientId::new(mock_client_type(), 45).unwrap();
+    let client_id_on_b = mock_client_type().build_client_id(45);
 
     // This is the connection underlying the channel we're trying to open.
     let conn_end_on_b = ConnectionEnd::new(

From c020e51009c61d300e6d0767a4aa78f79d027f0b Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Fri, 22 Dec 2023 05:44:16 +0100
Subject: [PATCH 083/182] imp: use global paths in generated code by
 `ibc-derive` (#1017)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* ibc-derive: use global paths in generated code

Because the generated code uses paths which start with `ibc::`, they
are first resolved from the local module’s namespace.  That is, if
an `ibc` module is defined, the derives create code which does not
compile.  This is demonstrated by the following fragment:

    use ::ibc::core::client::context::consensus_state::ConsensusState;
    use ::ibc::core::commitment_types::commitment::CommitmentRoot;

    mod ibc {}

    #[derive(ConsensusState)]
    enum AnyConsensusState { Foo(Foo) }

    struct Foo;

    impl ConsensusState for Foo {
        fn root(&self) -> &CommitmentRoot { todo!() }
        fn timestamp(&self) -> ::ibc::primitives::Timestamp { todo!() }
        fn encode_vec(self) -> Vec<u8> { todo!() }
    }

The compilation fails with ‘failed to resolve: could not find `core`
in `ibc`’ errors.

To solve this, use global paths (i.e. ones starting with `::ibc::`).
Starting from 2018 Rust edition such paths resolve from the extern
prelude and thus `::ibc` points at the `ibc` crate.

Note however that in 2015 edition global paths are anchored at the
crate root so `::ibc` will attempt to look for `crate::ibc` module.
This means that this change is breaking for code using ancient Rust
editions.

* chore: unclog

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 ...1017-use-global-paths-in-generated-code.md |  3 ++
 ibc-derive/src/utils.rs                       | 32 +++++++++----------
 2 files changed, 19 insertions(+), 16 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md

diff --git a/.changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md b/.changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md
new file mode 100644
index 000000000..89282ec02
--- /dev/null
+++ b/.changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md
@@ -0,0 +1,3 @@
+- `[ibc-derive]` Use global paths in generated code by macros to prevent
+  namespace conflicts with local modules
+  ([#1017](https://github.com/cosmos/ibc-rs/pull/1017))
diff --git a/ibc-derive/src/utils.rs b/ibc-derive/src/utils.rs
index 3a1ea8b66..a8fbfd1cb 100644
--- a/ibc-derive/src/utils.rs
+++ b/ibc-derive/src/utils.rs
@@ -10,67 +10,67 @@ pub struct Imports;
 
 impl Imports {
     pub fn CommitmentRoot() -> TokenStream {
-        quote! {ibc::core::commitment_types::commitment::CommitmentRoot}
+        quote! {::ibc::core::commitment_types::commitment::CommitmentRoot}
     }
 
     pub fn CommitmentPrefix() -> TokenStream {
-        quote! {ibc::core::commitment_types::commitment::CommitmentPrefix}
+        quote! {::ibc::core::commitment_types::commitment::CommitmentPrefix}
     }
 
     pub fn CommitmentProofBytes() -> TokenStream {
-        quote! {ibc::core::commitment_types::commitment::CommitmentProofBytes}
+        quote! {::ibc::core::commitment_types::commitment::CommitmentProofBytes}
     }
 
     pub fn Path() -> TokenStream {
-        quote! {ibc::core::host::types::path::Path}
+        quote! {::ibc::core::host::types::path::Path}
     }
 
     pub fn ConsensusState() -> TokenStream {
-        quote! {ibc::core::client::context::consensus_state::ConsensusState}
+        quote! {::ibc::core::client::context::consensus_state::ConsensusState}
     }
 
     pub fn ClientStateCommon() -> TokenStream {
-        quote! {ibc::core::client::context::client_state::ClientStateCommon}
+        quote! {::ibc::core::client::context::client_state::ClientStateCommon}
     }
 
     pub fn ClientStateValidation() -> TokenStream {
-        quote! {ibc::core::client::context::client_state::ClientStateValidation}
+        quote! {::ibc::core::client::context::client_state::ClientStateValidation}
     }
 
     pub fn ClientStateExecution() -> TokenStream {
-        quote! {ibc::core::client::context::client_state::ClientStateExecution}
+        quote! {::ibc::core::client::context::client_state::ClientStateExecution}
     }
 
     pub fn ClientId() -> TokenStream {
-        quote! {ibc::core::host::types::identifiers::ClientId}
+        quote! {::ibc::core::host::types::identifiers::ClientId}
     }
 
     pub fn ClientType() -> TokenStream {
-        quote! {ibc::core::host::types::identifiers::ClientType}
+        quote! {::ibc::core::host::types::identifiers::ClientType}
     }
 
     pub fn ClientError() -> TokenStream {
-        quote! {ibc::core::client::types::error::ClientError}
+        quote! {::ibc::core::client::types::error::ClientError}
     }
 
     pub fn Height() -> TokenStream {
-        quote! {ibc::core::client::types::Height}
+        quote! {::ibc::core::client::types::Height}
     }
 
     pub fn Any() -> TokenStream {
-        quote! {ibc::primitives::proto::Any}
+        quote! {::ibc::primitives::proto::Any}
     }
 
     pub fn Timestamp() -> TokenStream {
-        quote! {ibc::core::primitives::Timestamp}
+        quote! {::ibc::core::primitives::Timestamp}
     }
 
     pub fn UpdateKind() -> TokenStream {
-        quote! {ibc::core::client::types::UpdateKind}
+        quote! {::ibc::core::client::types::UpdateKind}
     }
 
     pub fn Status() -> TokenStream {
-        quote! {ibc::core::client::types::Status}
+        quote! {::ibc::core::client::types::Status}
     }
 }
 

From d96cc6632e53cbab1a4bb6f636a86427772806d8 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 2 Jan 2024 06:33:22 -0800
Subject: [PATCH 084/182] Release v0.48.2 (#1018)

* fix: packet sequence in Timeout handlers should be encoded in big-endian (#1004)

* fix: encode package sequence into big endian bytes

* Fix this issue in `to_vec` method.

* fix: recursive call in connection `State` conversion to `i32` (#1010)

* fix state conversion recursive call

* replace match with casting

Co-authored-by: Michal Nazarewicz <mina86@mina86.com>
Signed-off-by: Dhruv D Jain <dhruv@iamsizzling.com>

* chore: add unclog

* nit

---------

Signed-off-by: Dhruv D Jain <dhruv@iamsizzling.com>
Co-authored-by: Michal Nazarewicz <mina86@mina86.com>
Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* Release v0.48.2

chore: update changelog + summary

deps: bump versions to v0.48.2

---------

Signed-off-by: Dhruv D Jain <dhruv@iamsizzling.com>
Co-authored-by: Yuanchao Sun <yuanchao.sun@gmail.com>
Co-authored-by: Dhruv D Jain <dhruv@iamsizzling.com>
Co-authored-by: Michal Nazarewicz <mina86@mina86.com>
---
 .../1004-fix-packet-sequence-encoding.md      |   2 -
 ...e-call-in-conn-state-converstion-to-i32.md |   2 -
 .../1004-fix-packet-sequence-encoding.md      |   2 +
 ...e-call-in-conn-state-converstion-to-i32.md |   2 +
 .changelog/v0.48.2/summary.md                 |   6 +
 CHANGELOG.md                                  |  18 ++
 Cargo.toml                                    |  50 +--
 ci/cw-check/Cargo.lock                        | 299 ++++++++++--------
 ci/no-std-check/Cargo.lock                    |  48 +--
 9 files changed, 245 insertions(+), 184 deletions(-)
 delete mode 100644 .changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md
 delete mode 100644 .changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
 create mode 100644 .changelog/v0.48.2/bug-fixes/1004-fix-packet-sequence-encoding.md
 create mode 100644 .changelog/v0.48.2/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
 create mode 100644 .changelog/v0.48.2/summary.md

diff --git a/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md b/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md
deleted file mode 100644
index e6e8f84a4..000000000
--- a/.changelog/unreleased/bug-fixes/1004-fix-packet-sequence-encoding.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- Encode packet sequence into a big endian bytes.
-  ([\#1004](https://github.com/cosmos/ibc-rs/pull/1004))
\ No newline at end of file
diff --git a/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md b/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
deleted file mode 100644
index 337ba7642..000000000
--- a/.changelog/unreleased/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
+++ /dev/null
@@ -1,2 +0,0 @@
-- `[ibc-core-connection-types]` Fix recursive call in connection `State`
-  conversion to `i32` ([#1010](https://github.com/cosmos/ibc-rs/issues/1010))
diff --git a/.changelog/v0.48.2/bug-fixes/1004-fix-packet-sequence-encoding.md b/.changelog/v0.48.2/bug-fixes/1004-fix-packet-sequence-encoding.md
new file mode 100644
index 000000000..cc43e371d
--- /dev/null
+++ b/.changelog/v0.48.2/bug-fixes/1004-fix-packet-sequence-encoding.md
@@ -0,0 +1,2 @@
+- `[ibc-core-host-types]` Encode packet sequence into a big endian bytes.
+  ([\#1004](https://github.com/cosmos/ibc-rs/pull/1004))
diff --git a/.changelog/v0.48.2/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md b/.changelog/v0.48.2/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
new file mode 100644
index 000000000..c1c9209e5
--- /dev/null
+++ b/.changelog/v0.48.2/bug-fixes/1010-fix-recursive-call-in-conn-state-converstion-to-i32.md
@@ -0,0 +1,2 @@
+- `[ibc-core-connection-types]` Fix recursive call in connection `State`
+  conversion to `i32` ([\#1010](https://github.com/cosmos/ibc-rs/issues/1010))
diff --git a/.changelog/v0.48.2/summary.md b/.changelog/v0.48.2/summary.md
new file mode 100644
index 000000000..119af0fdf
--- /dev/null
+++ b/.changelog/v0.48.2/summary.md
@@ -0,0 +1,6 @@
+This patch release resolves two issues. It corrects the packet sequence number
+encoding within Timeout message handlers to align with the big-endian format and
+addresses a recursive call error during the conversion from connection `State`
+to `i32`.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index be0d56533..1174d9750 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,23 @@
 # CHANGELOG
 
+## v0.48.2
+
+*December 22, 2023*
+
+This patch release resolves two issues. It corrects the packet sequence number
+encoding within Timeout message handlers to align with the big-endian format and
+addresses a recursive call error during the conversion from connection `State`
+to `i32`.
+
+There are no consensus-breaking changes.
+
+### BUG FIXES
+
+- `[ibc-core-host-types]` Encode packet sequence into a big endian bytes.
+  ([\#1004](https://github.com/cosmos/ibc-rs/pull/1004))
+- `[ibc-core-connection-types]` Fix recursive call in connection `State`
+  conversion to `i32` ([\#1010](https://github.com/cosmos/ibc-rs/issues/1010))
+
 ## v0.48.1
 
 *November 27, 2023*
diff --git a/Cargo.toml b/Cargo.toml
index bda0b4595..d75305572 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -37,7 +37,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.48.1"
+version      = "0.48.2"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -58,33 +58,33 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.0" , default
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.48.1", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.48.1", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.48.1", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.48.1", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.48.1", path = "./ibc-primitives", default-features = false }
+ibc                 = { version = "0.48.2", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.48.2", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.48.2", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.48.2", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.48.2", path = "./ibc-primitives", default-features = false }
 ibc-derive          = { version = "0.4.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.48.1", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.48.1", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.48.1", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.48.1", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.48.1", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.48.1", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.48.1", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-core-client       = { version = "0.48.2", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.48.2", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.48.2", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.48.2", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.48.2", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.48.2", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.48.2", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.48.2", path = "./ibc-apps/ics20-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.48.1", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.48.1", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.48.1", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.48.1", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.48.1", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.48.1", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.48.1", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.48.1", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.48.1", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.48.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.48.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.48.2", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.48.2", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.48.2", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.48.2", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.48.2", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.48.2", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.48.2", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.48.2", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.48.2", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.48.2", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.48.2", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.39.1", default-features = false }
 
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index def22f0ff..5f536b35f 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -4,9 +4,9 @@ version = 3
 
 [[package]]
 name = "ahash"
-version = "0.7.6"
+version = "0.7.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fcb51a0695d8f838b1ee009b3fbf66bda078cd64590202a864a8f3e8c4315c47"
+checksum = "5a824f2aa7e75a0c98c5a504fceb80649e9c35265d44525b5f94de4771a395cd"
 dependencies = [
  "getrandom",
  "once_cell",
@@ -15,9 +15,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.72"
+version = "1.0.76"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b13c32d80ecc7ab747b80c3784bce54ee8a7a0cc4fbda9bf4cda2cf6fe90854"
+checksum = "59d2a3357dde987206219e78ecfbbb6e8dad06cbb65292758d3270e6254f7355"
 
 [[package]]
 name = "arrayvec"
@@ -45,9 +45,9 @@ checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
 
 [[package]]
 name = "base64"
-version = "0.21.2"
+version = "0.21.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "604178f6c5c21f02dc555784810edfb88d34ac2c73b2eae109655649ee73ce3d"
+checksum = "35636a1494ede3b646cc98f74f8e62c773a38a659ebc777a2cf26b9b74171df9"
 
 [[package]]
 name = "base64ct"
@@ -93,9 +93,9 @@ checksum = "c3ac9f8b63eca6fd385229b3675f6cc0dc5c8a5c8a54a59d4f52ffd670d87b0c"
 
 [[package]]
 name = "byteorder"
-version = "1.4.3"
+version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14c189c53d098945499cdfa7ecc63567cf3886b3332b312a5b4585d8d3a6a610"
+checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
 
 [[package]]
 name = "bytes"
@@ -114,9 +114,9 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
 [[package]]
 name = "const-oid"
-version = "0.9.4"
+version = "0.9.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "795bc6e66a8e340f075fcf6227e417a2dc976b92b91f3cdc778bb858778b6747"
+checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
 
 [[package]]
 name = "cosmwasm-crypto"
@@ -171,7 +171,7 @@ version = "1.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "04d6864742e3a7662d024b51a94ea81c9af21db6faea2f9a6d2232bb97c6e53e"
 dependencies = [
- "base64 0.21.2",
+ "base64 0.21.5",
  "bech32",
  "bnum",
  "cosmwasm-crypto",
@@ -189,9 +189,9 @@ dependencies = [
 
 [[package]]
 name = "cpufeatures"
-version = "0.2.9"
+version = "0.2.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a17b76ff3a4162b0b27f354a0c87015ddad39d35f9c0c36607a3bdd175dde1f1"
+checksum = "ce420fe07aecd3e67c5f910618fe65e94158f6dcc0adf44e00d69ce2bdfe0fd0"
 dependencies = [
  "libc",
 ]
@@ -270,7 +270,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
@@ -281,19 +281,28 @@ checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
 name = "der"
-version = "0.7.7"
+version = "0.7.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c7ed52955ce76b1554f509074bb357d3fb8ac9b51288a65a3fd480d1dfba946"
+checksum = "fffa369a668c8af7dbf8b5e56c9f744fbd399949ed171606040001947de40b1c"
 dependencies = [
  "const-oid",
  "zeroize",
 ]
 
+[[package]]
+name = "deranged"
+version = "0.3.10"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8eb30d70a07a3b04884d2677f06bec33509dc67ca60d92949e5535352d3191dc"
+dependencies = [
+ "powerfmt",
+]
+
 [[package]]
 name = "derivative"
 version = "2.2.0"
@@ -345,14 +354,14 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
 name = "dyn-clone"
-version = "1.0.12"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "304e6508efa593091e97a9abbc10f90aa7ca635b6d2784feff3c89d41dd12272"
+checksum = "545b22097d44f8a9581187cdf93de7a71e4722bf51200cfaba810865b49a495d"
 
 [[package]]
 name = "ecdsa"
@@ -370,9 +379,9 @@ dependencies = [
 
 [[package]]
 name = "ed25519"
-version = "2.2.1"
+version = "2.2.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5fb04eee5d9d907f29e80ee6b0e78f7e2c82342c63e3580d8c4f69d9d5aad963"
+checksum = "115531babc129696a58c64a4fef0a8bf9e9698629fb97e9e40767d235cfbcd53"
 dependencies = [
  "pkcs8",
  "signature",
@@ -426,9 +435,9 @@ checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
 [[package]]
 name = "eyre"
-version = "0.6.9"
+version = "0.6.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "80f656be11ddf91bd709454d15d5bd896fbaf4cc3314e69349e4d1569f5b46cd"
+checksum = "b6267a1fa6f59179ea4afc8e50fd8612a3cc60bc858f786ff877a4a8cb042799"
 dependencies = [
  "indenter",
  "once_cell",
@@ -477,9 +486,9 @@ checksum = "c8cbd1169bd7b4a0a20d92b9af7a7e0422888bd38a6f5ec29c1fd8c1558a272e"
 
 [[package]]
 name = "futures"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23342abe12aba583913b2e62f22225ff9c950774065e4bfb61a19cd9770fec40"
+checksum = "da0290714b38af9b4a7b094b8a37086d1b4e61f2df9122c3cad2577669145335"
 dependencies = [
  "futures-channel",
  "futures-core",
@@ -491,9 +500,9 @@ dependencies = [
 
 [[package]]
 name = "futures-channel"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "955518d47e09b25bbebc7a18df10b81f0c766eaf4c4f1cccef2fca5f2a4fb5f2"
+checksum = "ff4dd66668b557604244583e3e1e1eada8c5c2e96a6d0d6653ede395b78bbacb"
 dependencies = [
  "futures-core",
  "futures-sink",
@@ -501,33 +510,33 @@ dependencies = [
 
 [[package]]
 name = "futures-core"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4bca583b7e26f571124fe5b7561d49cb2868d79116cfa0eefce955557c6fee8c"
+checksum = "eb1d22c66e66d9d72e1758f0bd7d4fd0bee04cad842ee34587d68c07e45d088c"
 
 [[package]]
 name = "futures-io"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fff74096e71ed47f8e023204cfd0aa1289cd54ae5430a9523be060cdb849964"
+checksum = "8bf34a163b5c4c52d0478a4d757da8fb65cabef42ba90515efee0f6f9fa45aaa"
 
 [[package]]
 name = "futures-sink"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f43be4fe21a13b9781a69afa4985b0f6ee0e1afab2c6f454a8cf30e2b2237b6e"
+checksum = "e36d3378ee38c2a36ad710c5d30c2911d752cb941c00c72dbabfb786a7970817"
 
 [[package]]
 name = "futures-task"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "76d3d132be6c0e6aa1534069c705a74a5997a356c0dc2f86a47765e5617c5b65"
+checksum = "efd193069b0ddadc69c46389b740bbccdd97203899b48d09c5f7969591d6bae2"
 
 [[package]]
 name = "futures-util"
-version = "0.3.28"
+version = "0.3.29"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26b01e40b772d54cf6c6d721c1d1abd0647a0106a12ecaa1c186273392a69533"
+checksum = "a19526d624e703a3179b3d322efec918b6246ea0fa51d41124525f00f1cc8104"
 dependencies = [
  "futures-core",
  "futures-sink",
@@ -549,9 +558,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.10"
+version = "0.2.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be4136b2a15dd319360be1c07d9933517ccf0be8f16bf62a3bee4f0d618df427"
+checksum = "fe9006bed769170c11f845cf00c7c1e9092aeb3f268e007c3e760ac68008070f"
 dependencies = [
  "cfg-if",
  "libc",
@@ -580,9 +589,9 @@ dependencies = [
 
 [[package]]
 name = "hashbrown"
-version = "0.14.0"
+version = "0.14.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2c6201b9ff9fd90a5a3bac2e56a830d0caa509576f0e503818ee82c181b3437a"
+checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
 
 [[package]]
 name = "hex"
@@ -601,7 +610,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -610,7 +619,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -625,14 +634,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -646,7 +655,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -660,7 +669,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -681,7 +690,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -693,7 +702,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -709,7 +718,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -727,7 +736,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -743,7 +752,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -754,7 +763,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -773,7 +782,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -787,7 +796,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -809,7 +818,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -826,7 +835,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -839,7 +848,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -852,14 +861,13 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "ics23",
  "parity-scale-codec",
  "scale-info",
  "schemars",
@@ -875,12 +883,12 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -900,7 +908,7 @@ version = "0.39.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c8a8b1356652b9f160f5a010dd6b084675b8a28e163bf2b41ca5abecf27d9701"
 dependencies = [
- "base64 0.21.2",
+ "base64 0.21.5",
  "bytes",
  "flex-error",
  "ics23",
@@ -964,12 +972,12 @@ checksum = "ce23b50ad8242c51a442f3ff322d56b02f08852c77e4c0b4d3fd684abc89c683"
 
 [[package]]
 name = "indexmap"
-version = "2.0.0"
+version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d5477fe2230a79769d8dc68e0eabf5437907c0457a5614a9e8dddb67f65eb65d"
+checksum = "d530e1a18b1cb4c484e6e34556a0d948706958449fca0cab753d649f2bce3d1f"
 dependencies = [
  "equivalent",
- "hashbrown 0.14.0",
+ "hashbrown 0.14.3",
 ]
 
 [[package]]
@@ -984,18 +992,18 @@ dependencies = [
 
 [[package]]
 name = "itertools"
-version = "0.10.5"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b0fd2260e829bddf4cb6ea802289de2f86d6a7a690192fbe91b3f46e0f2c8473"
+checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57"
 dependencies = [
  "either",
 ]
 
 [[package]]
 name = "itoa"
-version = "1.0.9"
+version = "1.0.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
+checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
 
 [[package]]
 name = "k256"
@@ -1022,15 +1030,15 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.147"
+version = "0.2.151"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4668fb0ea861c1df094127ac5f1da3409a82116a4ba74fca2e58ef927159bb3"
+checksum = "302d7ab3130588088d277783b1e2d2e10c9e9e4a16dd9050e6ec93fb3e7048f4"
 
 [[package]]
 name = "memchr"
-version = "2.5.0"
+version = "2.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2dffe52ecf27772e601905b7522cb4ef790d2cc203488bbd0e2fe85fcb74566d"
+checksum = "f665ee40bc4a3c5590afb1e9677db74a508659dfd71e126420da8274909a0167"
 
 [[package]]
 name = "num-derive"
@@ -1045,18 +1053,18 @@ dependencies = [
 
 [[package]]
 name = "num-traits"
-version = "0.2.16"
+version = "0.2.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f30b0abd723be7e2ffca1272140fac1a2f084c77ec3e123c192b66af1ee9e6c2"
+checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c"
 dependencies = [
  "autocfg",
 ]
 
 [[package]]
 name = "once_cell"
-version = "1.18.0"
+version = "1.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d"
+checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
 
 [[package]]
 name = "opaque-debug"
@@ -1066,9 +1074,9 @@ checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.5"
+version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0dec8a8073036902368c2cdc0387e85ff9a37054d7e7c98e592145e0c92cd4fb"
+checksum = "881331e34fa842a2fb61cc2db9643a8fedc615e47cfcc52597d1af0db9a7e8fe"
 dependencies = [
  "arrayvec",
  "byte-slice-cast",
@@ -1078,11 +1086,11 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.5"
+version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "312270ee71e1cd70289dacf597cab7b207aa107d2f28191c2ae45b2ece18a260"
+checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
 dependencies = [
- "proc-macro-crate",
+ "proc-macro-crate 2.0.1",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1096,9 +1104,9 @@ checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
 
 [[package]]
 name = "pin-project-lite"
-version = "0.2.10"
+version = "0.2.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4c40d25201921e5ff0c862a505c6557ea88568a4e3ace775ab55e93f2f4f9d57"
+checksum = "8afb450f006bf6385ca15ef45d71d2288452bc3683ce2e2cacc0d18e4be60b58"
 
 [[package]]
 name = "pin-utils"
@@ -1116,6 +1124,12 @@ dependencies = [
  "spki",
 ]
 
+[[package]]
+name = "powerfmt"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
+
 [[package]]
 name = "primitive-types"
 version = "0.12.2"
@@ -1134,14 +1148,24 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
 dependencies = [
  "once_cell",
- "toml_edit",
+ "toml_edit 0.19.15",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97dc5fea232fc28d2f597b37c4876b348a40e33f3b02cc975c8d006d78d94b1a"
+dependencies = [
+ "toml_datetime",
+ "toml_edit 0.20.2",
 ]
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.66"
+version = "1.0.71"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "18fb31db3f9bddb2ea821cde30a9f70117e3f119938b5ee630b7403aa6e2ead9"
+checksum = "75cb1540fadbd5b8fbccc4dddad2734eba435053f725621c070711a14bb5f4b8"
 dependencies = [
  "unicode-ident",
 ]
@@ -1166,14 +1190,14 @@ dependencies = [
  "itertools",
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
 name = "prost-types"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e081b29f63d83a4bc75cfc9f3fe424f9156cf92d8a4f0c9407cce9a1b67327cf"
+checksum = "193898f59edcf43c26227dcd4c8427f00d99d61e95dcde58dabd49fa291d470e"
 dependencies = [
  "prost",
 ]
@@ -1223,9 +1247,9 @@ dependencies = [
 
 [[package]]
 name = "ryu"
-version = "1.0.15"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
+checksum = "f98d2aa92eebf49b69786be48e4477826b256916e84a57ff2a4f21923b48eb4c"
 
 [[package]]
 name = "scale-info"
@@ -1245,7 +1269,7 @@ version = "2.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "abf2c68b89cafb3b8d918dd07b42be0da66ff202cf1155c5739a4e0c1ea0dc19"
 dependencies = [
- "proc-macro-crate",
+ "proc-macro-crate 1.3.1",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1291,9 +1315,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.188"
+version = "1.0.193"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf9e0fcba69a370eed61bcf2b728575f726b50b55cba78064753d708ddc7549e"
+checksum = "25dd9975e68d0cb5aa1120c288333fc98731bd1dd12f561e468ea4728c042b89"
 dependencies = [
  "serde_derive",
 ]
@@ -1327,13 +1351,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.188"
+version = "1.0.193"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4eca7ac642d82aa35b60049a6eccb4be6be75e599bd2e9adb5f875a737654af2"
+checksum = "43576ca501357b9b071ac53cdc7da8ef0cbd9493d8df094cd821777ea6e894d3"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
@@ -1349,9 +1373,9 @@ dependencies = [
 
 [[package]]
 name = "serde_json"
-version = "1.0.104"
+version = "1.0.108"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "076066c5f1078eac5b722a31827a8832fe108bed65dfa75e233c89f8206e976c"
+checksum = "3d1c7e3eac408d115102c4c24ad393e0821bb3a5df4d506a80f85f7a742a526b"
 dependencies = [
  "itoa",
  "ryu",
@@ -1360,13 +1384,13 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.16"
+version = "0.1.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8725e1dfadb3a50f7e5ce0b1a540466f6ed3fe7a0fca2ac2b8b831d31316bd00"
+checksum = "3081f5ffbb02284dda55132aa26daecedd7372a42417bbbab6f14ab7d6bb9145"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
@@ -1405,9 +1429,9 @@ dependencies = [
 
 [[package]]
 name = "signature"
-version = "2.1.0"
+version = "2.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
+checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
 dependencies = [
  "digest 0.10.7",
  "rand_core 0.6.4",
@@ -1415,9 +1439,9 @@ dependencies = [
 
 [[package]]
 name = "spki"
-version = "0.7.2"
+version = "0.7.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d1e996ef02c474957d681f1b05213dfb0abab947b446a62d37770b23500184a"
+checksum = "d91ed6c858b01f942cd56b37a94b3e0a1798290327d1236e4d9cf4eaca44d29d"
 dependencies = [
  "base64ct",
  "der",
@@ -1463,9 +1487,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.28"
+version = "2.0.42"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "04361975b3f5e348b2189d8dc55bc942f278b2d482a6a0365de5bdd62d351567"
+checksum = "5b7d0a2c048d661a1a59fcd7355baa232f7ed34e0ee4df2eef3c1c1c0d3852d8"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1519,30 +1543,32 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.44"
+version = "1.0.51"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "611040a08a0439f8248d1990b111c95baa9c704c805fa1f62104b39655fd7f90"
+checksum = "f11c217e1416d6f036b870f14e0413d480dbf28edbee1f877abaf0206af43bb7"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.44"
+version = "1.0.51"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "090198534930841fab3a5d1bb637cde49e339654e606195f8d9c76eeb081dc96"
+checksum = "01742297787513b79cf8e29d1056ede1313e2420b7b3b15d0a768b4921f549df"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
 
 [[package]]
 name = "time"
-version = "0.3.23"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "59e399c068f43a5d116fedaf73b203fa4f9c519f17e2b34f63221d3792f81446"
+checksum = "c4a34ab300f2dee6e562c10a046fc05e358b29f9bf92277f30c3c8d82275f6f5"
 dependencies = [
+ "deranged",
+ "powerfmt",
  "serde",
  "time-core",
  "time-macros",
@@ -1550,15 +1576,15 @@ dependencies = [
 
 [[package]]
 name = "time-core"
-version = "0.1.1"
+version = "0.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7300fbefb4dadc1af235a9cef3737cea692a9d97e1b9cbcd4ebdae6f8868e6fb"
+checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.10"
+version = "0.2.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96ba15a897f3c86766b757e5ac7221554c6750054d74d5b28844fce5fb36a6c4"
+checksum = "4ad70d68dba9e1f8aceda7aa6711965dfec1cac869f311a51bd08b3a2ccbce20"
 dependencies = [
  "time-core",
 ]
@@ -1571,9 +1597,20 @@ checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
 
 [[package]]
 name = "toml_edit"
-version = "0.19.14"
+version = "0.19.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f8123f27e969974a3dfba720fdb560be359f57b44302d280ba72e76a74480e8a"
+checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
+dependencies = [
+ "indexmap",
+ "toml_datetime",
+ "winnow",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.20.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
 dependencies = [
  "indexmap",
  "toml_datetime",
@@ -1582,9 +1619,9 @@ dependencies = [
 
 [[package]]
 name = "typenum"
-version = "1.16.0"
+version = "1.17.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "497961ef93d974e23eb6f433eb5fe1b7930b659f06d12dec6fc44a8f554c0bba"
+checksum = "42ff0bf0c66b8238c6f3b578df37d0b7848e55df8577b3f74f92a69acceeb825"
 
 [[package]]
 name = "uint"
@@ -1600,9 +1637,9 @@ dependencies = [
 
 [[package]]
 name = "unicode-ident"
-version = "1.0.11"
+version = "1.0.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "301abaae475aa91687eb82514b328ab47a211a533026cb25fc3e519b86adfc3c"
+checksum = "3354b9ac3fae1ff6755cb6db53683adb661634f67557942dea4facebec0fee4b"
 
 [[package]]
 name = "version_check"
@@ -1618,9 +1655,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "winnow"
-version = "0.5.2"
+version = "0.5.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8bd122eb777186e60c3fdf765a58ac76e41c582f1f535fbf3314434c6b58f3f7"
+checksum = "9b5c3db89721d50d0e2a673f5043fc4722f76dcc352d7b1ab8b8288bed4ed2c5"
 dependencies = [
  "memchr",
 ]
@@ -1642,5 +1679,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.28",
+ "syn 2.0.42",
 ]
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 6404bfca4..5b6bbc27a 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1213,7 +1213,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1225,7 +1225,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1234,7 +1234,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1247,14 +1247,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -1269,7 +1269,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1285,14 +1285,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1306,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1320,7 +1320,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1338,7 +1338,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1350,7 +1350,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1366,7 +1366,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1381,7 +1381,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1394,7 +1394,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1405,7 +1405,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1421,7 +1421,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1435,7 +1435,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1454,7 +1454,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1471,7 +1471,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1493,7 +1493,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1503,7 +1503,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1516,7 +1516,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1541,7 +1541,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.1"
+version = "0.48.2"
 dependencies = [
  "derive_more",
  "displaydoc",

From e340d1ef18ad6934bc2d47d43fae5c883809c985 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Wed, 3 Jan 2024 09:09:27 -0600
Subject: [PATCH 085/182] Release v0.49.0 (#1021)

* Add v0.49 changelog

* Update cargo.toml dependency versions

* Use infallible conversion method where appropriate

* Bump ibc-derive version

* Update ibc-derive deps version

* Update RELEASES.md doc

* Update release workflow to use `cargo release`

* Remove release.sh script in favor of `cargo release` command

* CI: add job for release-check

* fix: revise if conditions

* fix: release.yaml if condition

* rewrite release.yaml + apply linter on CHANGELOG.md

* Incorporate some PR feedback

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1014-better-client-id-new.md              |   0
 .../837-split-sent-coins-method copy.md       |   0
 .../839-add-memo-field-for-token-escrow.md    |   0
 .../breaking-changes/978-identifier-error.md  |   0
 .../breaking-changes/993-bump-ibc-proto-rs.md |   0
 .../997-minimize-prost-dependency.md          |   0
 .../1008-commitment-proof-bytes-as-ref.md     |   0
 .../improvements/1005-status-verify-active.md |   0
 .../improvements/1011-status-verify-active.md |   0
 ...1017-use-global-paths-in-generated-code.md |   0
 .../992-more-rigorous-cosmwasm-check.md       |   0
 .../improvements/993-streamline-msg-trait.md  |   0
 .../996-custom-chain-id-deserialization.md    |   0
 .changelog/v0.49.0/summary.md                 |  13 +++
 .github/workflows/release.yaml                |  56 +++++++--
 CHANGELOG.md                                  |  66 +++++++++++
 Cargo.toml                                    |  52 ++++-----
 RELEASES.md                                   |  24 ++--
 ibc-derive/Cargo.toml                         |   2 +-
 .../tests/core/ics02_client/create_client.rs  |   2 +-
 scripts/release.sh                            | 107 ------------------
 21 files changed, 165 insertions(+), 157 deletions(-)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/1014-better-client-id-new.md (100%)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/837-split-sent-coins-method copy.md (100%)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/839-add-memo-field-for-token-escrow.md (100%)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/978-identifier-error.md (100%)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/993-bump-ibc-proto-rs.md (100%)
 rename .changelog/{unreleased => v0.49.0}/breaking-changes/997-minimize-prost-dependency.md (100%)
 rename .changelog/{unreleased => v0.49.0}/features/1008-commitment-proof-bytes-as-ref.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/1005-status-verify-active.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/1011-status-verify-active.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/1017-use-global-paths-in-generated-code.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/992-more-rigorous-cosmwasm-check.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/993-streamline-msg-trait.md (100%)
 rename .changelog/{unreleased => v0.49.0}/improvements/996-custom-chain-id-deserialization.md (100%)
 create mode 100644 .changelog/v0.49.0/summary.md
 delete mode 100755 scripts/release.sh

diff --git a/.changelog/unreleased/breaking-changes/1014-better-client-id-new.md b/.changelog/v0.49.0/breaking-changes/1014-better-client-id-new.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1014-better-client-id-new.md
rename to .changelog/v0.49.0/breaking-changes/1014-better-client-id-new.md
diff --git a/.changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md b/.changelog/v0.49.0/breaking-changes/837-split-sent-coins-method copy.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/837-split-sent-coins-method copy.md
rename to .changelog/v0.49.0/breaking-changes/837-split-sent-coins-method copy.md
diff --git a/.changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md b/.changelog/v0.49.0/breaking-changes/839-add-memo-field-for-token-escrow.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/839-add-memo-field-for-token-escrow.md
rename to .changelog/v0.49.0/breaking-changes/839-add-memo-field-for-token-escrow.md
diff --git a/.changelog/unreleased/breaking-changes/978-identifier-error.md b/.changelog/v0.49.0/breaking-changes/978-identifier-error.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/978-identifier-error.md
rename to .changelog/v0.49.0/breaking-changes/978-identifier-error.md
diff --git a/.changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md b/.changelog/v0.49.0/breaking-changes/993-bump-ibc-proto-rs.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/993-bump-ibc-proto-rs.md
rename to .changelog/v0.49.0/breaking-changes/993-bump-ibc-proto-rs.md
diff --git a/.changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md b/.changelog/v0.49.0/breaking-changes/997-minimize-prost-dependency.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/997-minimize-prost-dependency.md
rename to .changelog/v0.49.0/breaking-changes/997-minimize-prost-dependency.md
diff --git a/.changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md b/.changelog/v0.49.0/features/1008-commitment-proof-bytes-as-ref.md
similarity index 100%
rename from .changelog/unreleased/features/1008-commitment-proof-bytes-as-ref.md
rename to .changelog/v0.49.0/features/1008-commitment-proof-bytes-as-ref.md
diff --git a/.changelog/unreleased/improvements/1005-status-verify-active.md b/.changelog/v0.49.0/improvements/1005-status-verify-active.md
similarity index 100%
rename from .changelog/unreleased/improvements/1005-status-verify-active.md
rename to .changelog/v0.49.0/improvements/1005-status-verify-active.md
diff --git a/.changelog/unreleased/improvements/1011-status-verify-active.md b/.changelog/v0.49.0/improvements/1011-status-verify-active.md
similarity index 100%
rename from .changelog/unreleased/improvements/1011-status-verify-active.md
rename to .changelog/v0.49.0/improvements/1011-status-verify-active.md
diff --git a/.changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md b/.changelog/v0.49.0/improvements/1017-use-global-paths-in-generated-code.md
similarity index 100%
rename from .changelog/unreleased/improvements/1017-use-global-paths-in-generated-code.md
rename to .changelog/v0.49.0/improvements/1017-use-global-paths-in-generated-code.md
diff --git a/.changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md b/.changelog/v0.49.0/improvements/992-more-rigorous-cosmwasm-check.md
similarity index 100%
rename from .changelog/unreleased/improvements/992-more-rigorous-cosmwasm-check.md
rename to .changelog/v0.49.0/improvements/992-more-rigorous-cosmwasm-check.md
diff --git a/.changelog/unreleased/improvements/993-streamline-msg-trait.md b/.changelog/v0.49.0/improvements/993-streamline-msg-trait.md
similarity index 100%
rename from .changelog/unreleased/improvements/993-streamline-msg-trait.md
rename to .changelog/v0.49.0/improvements/993-streamline-msg-trait.md
diff --git a/.changelog/unreleased/improvements/996-custom-chain-id-deserialization.md b/.changelog/v0.49.0/improvements/996-custom-chain-id-deserialization.md
similarity index 100%
rename from .changelog/unreleased/improvements/996-custom-chain-id-deserialization.md
rename to .changelog/v0.49.0/improvements/996-custom-chain-id-deserialization.md
diff --git a/.changelog/v0.49.0/summary.md b/.changelog/v0.49.0/summary.md
new file mode 100644
index 000000000..672de2863
--- /dev/null
+++ b/.changelog/v0.49.0/summary.md
@@ -0,0 +1,13 @@
+This release continues the trend of further decoupling dependencies between the different `ibc-rs`
+sub-crates and modules. 
+
+In particular, the `prost` dependency is now only imported in the `ibc-primitives`
+crate; note that error variants originating from `prost` have largely been removed, which is a breaking
+change. The `bytes` dependency was also removed. Additionally, `CommitmentProofBytes` can now be 
+accessed without explicit ownership of the object which the proof is being queried for. 
+
+Some other notable improvements include making the CosmWasm check more rigorous, streamlining the 
+`Msg` trait and renaming it to `ToProto`, as well as implementing custom JSON and Borsh `ChainId`
+deserialization. 
+
+There are no consensus-breaking changes.
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 160b039da..86282f360 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -1,27 +1,65 @@
-# Attempts to perform a release when a particular tag is pushed. This uses the
-# `./scripts/release.sh`, and assumes that the CRATES_TOKEN secret has been set
-# and contains an API token with which we can publish our crates to crates.io.
+# Attempts to perform a release when a particular tag is pushed. This job uses 
+# the `cargo release` command and assumes that the `CRATES_TOKEN`secret has 
+# been set and contains an API token with which we can publish our crates to 
+# crates.io.
+#
+# The `ibc-derive` publishing process is managed manually since it's not
+# consistently published with every release.
 #
 # If release operation fails partway through due to a temporary error (e.g. the
 # crate being published depends on the crate published just prior, but the prior
 # crate isn't yet available via crates.io), one can simply rerun this workflow.
-# The release.sh script aims to be an idempotent operation, skipping the
-# publishing of crates that have already been published.
 name: Release
 
 on:
   push:
+    branches:
+      - "release/*"
     tags:
       - "v[0-9]+.[0-9]+.[0-9]+"             # Push events to matching v*, i.e. v0.26.0, v1.0.0
       - "v[0-9]+.[0-9]+.[0-9]+-pre.[0-9]+"  # e.g. v0.26.0-pre.1
 
 jobs:
-  release:
+  publish-check:
+    if: github.ref_type != 'tag'
+    name: Check publish to crates.io (dry run)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: dtolnay/rust-toolchain@stable
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Cache cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Install cargo-release
+        run: cargo install cargo-release
+      - name: Publish crates (dry run)
+        run: cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive
+        env:
+          CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
+
+  publish:
+    if: github.ref_type == 'tag'
+    name: Publish to crates.io
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Cache cargo dependencies
+        uses: Swatinem/rust-cache@v2
+      - name: Install cargo-release
+        run: cargo install cargo-release
       - name: Publish crates
-        run: ./scripts/release.sh
+        run: cargo release --workspace --no-push --no-tag --exclude ibc-derive --execute
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
+  
+  gh-release:
+    if: github.ref_type == 'tag'
+    name: Create GitHub release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: taiki-e/create-gh-release-action@v1
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 1174d9750..98f8b067e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,71 @@
 # CHANGELOG
 
+## v0.49.0
+
+*January 3, 2024*
+
+This release continues the trend of further decoupling dependencies between the
+different ibc-rs sub-crates and modules.
+
+In particular, the `prost` dependency is now only imported in the
+`ibc-primitives` crate; note that error variants originating from `prost` have
+largely been removed, which is a breaking change. The `bytes` dependency was
+also removed. Additionally, `CommitmentProofBytes` can now be accessed without
+explicit ownership of the object for which the proof is being queried for.
+
+Some other improvements of note include making the CosmWasm check more rigorous,
+streamlining the `Msg` trait and renaming it to `ToProto`, as well as
+implementing custom JSON and Borsh `ChainId` deserialization.
+
+There are no consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- `[ibc-app-transfer]` Refactor `send-coins-*()` methods by breaking them down
+  into distinct escrow and unescrow methods, enhancing both clarity and
+  specificity in functionality.
+  ([\#837](https://github.com/cosmos/ibc-rs/issues/837))
+- `[ibc-app-transfer]` Add `memo` field to `escrow-coins-*()` and
+  `burn-coins-*()` methods, allowing implementors to pass in arbitrary data
+  necessary for their use case.
+  ([\#839](https://github.com/cosmos/ibc-rs/issues/837))
+- `[ibc-core-host-type]` Optimize `IdentifierError` variants and make them
+  mutually exclusive. ([\#978](https://github.com/cosmos/ibc-rs/issues/978))
+- `[ibc-data-types]` Bump ibc-proto-rs dependency to v0.39.1.
+  ([\#993](https://github.com/cosmos/ibc-rs/issues/993))
+- `[ibc]` Minimize `prost` dependency by introducing `ToVec` trait
+  - Now `prost` is only imported in `ibc-primitives` crate
+  - Remove error variants originating from `prost` (Breaking change)
+  - Eliminate the need for the `bytes` dependency
+ ([\#997](https://github.com/cosmos/ibc-rs/issues/997))
+- `[ibc-core-host-types]` Introduce `ClientType::build_client_id` which avoids unnecessary validation.
+  ([#1014](https://github.com/cosmos/ibc-rs/issues/1014))
+- `[ibc-core-host-types]` Optimise `ClientId::new` to avoid unnecessary validation and temporary
+  string allocation. ([#1014](https://github.com/cosmos/ibc-rs/issues/1014))
+
+### FEATURES
+
+- `[ibc-core-commitment-types]` implement `AsRef<Vec<u8>>` and
+  `AsRef<[u8]>` for `CommitmentProofBytes` so it’s possible to gain
+  access to the proof byte slice without having to own the object.
+  ([#1008](https://github.com/cosmos/ibc-rs/pull/1008))
+
+### IMPROVEMENTS
+
+- `[cw-check]` More rigorous CosmWasm check by upgrading dependencies and
+  including `std` and `schema` features for `ibc-core`.
+  ([\#992](https://github.com/cosmos/ibc-rs/pull/992))
+- `[ibc-primitives]` streamline `Msg` trait and rename to `ToProto`
+ ([#993](https://github.com/cosmos/ibc-rs/issues/993))
+- `[ibc-core-host-types]` Implement custom JSON and Borsh deserialization for `ChainId` ([#996](https://github.com/cosmos/ibc-rs/pull/1013))
+- `[ibc-core-client-types]` Add a convenient `Status::verify_is_active` method.
+  ([#1005](https://github.com/cosmos/ibc-rs/pull/1005))
+- `[ibc-primitives]` Derive `Hash` on `Timestamp` instead of explicit
+  implementation ([#1011](https://github.com/cosmos/ibc-rs/pull/1005))
+- `[ibc-derive]` Use global paths in generated code by macros to prevent
+  namespace conflicts with local modules
+  ([#1017](https://github.com/cosmos/ibc-rs/pull/1017))
+
 ## v0.48.2
 
 *December 22, 2023*
diff --git a/Cargo.toml b/Cargo.toml
index d75305572..ac2d39628 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -37,7 +37,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.48.2"
+version      = "0.49.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -58,33 +58,33 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.0" , default
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.48.2", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.48.2", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.48.2", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.48.2", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.48.2", path = "./ibc-primitives", default-features = false }
-ibc-derive          = { version = "0.4.0", path = "./ibc-derive" }
+ibc                 = { version = "0.49.0", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.49.0", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.49.0", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.49.0", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.49.0", path = "./ibc-primitives", default-features = false }
+ibc-derive          = { version = "0.5.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.48.2", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.48.2", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.48.2", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.48.2", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.48.2", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.48.2", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.48.2", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.48.2", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-core-client       = { version = "0.49.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.49.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.49.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.49.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.49.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.49.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.49.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.49.0", path = "./ibc-apps/ics20-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.48.2", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.48.2", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.48.2", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.48.2", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.48.2", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.48.2", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.48.2", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.48.2", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.48.2", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.48.2", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.48.2", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.49.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.49.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.49.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.49.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.49.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.49.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.49.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.49.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.49.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.49.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.49.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.39.1", default-features = false }
 
diff --git a/RELEASES.md b/RELEASES.md
index 44b0d2f68..416a5765c 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -28,29 +28,27 @@ Our release process is as follows:
 5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
    the documentation compiles and seems up-to-date and coherent. Fix any
    potential issues here and push them to the release PR.
-6. Run `cargo publish -p ibc --dry-run` to double-check that publishing will
-   work. Fix any potential issues here and push them to the release PR.
-7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
-8. Once approved, merge the PR, and pull the `main` branch.
-9. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
+6. Mark the PR as **Ready for Review** and incorporate feedback on the release.
+   Once approved, merge the PR.
+7. Checkout the `main` and pull it with `git checkout main && git pull origin main`.
+8. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
    version and the link to the corresponding section of the changelog. Then push
-   the tag to GitHub with `git push --tags`.
-   - The [release workflow][release.yml] will run the [`release.sh`] script in a
-   CI worker.
-10. If some crates have not been released, check the cause of the failure and
+   the tag to GitHub with `git push origin vX.Y.Z`.
+   - The [release workflow][release.yml] will run the `cargo release --execute`
+   command in a CI worker.
+9. If some crates have not been released, check the cause of the failure and
    act accordingly:
-    1. In case of intermittent problems with the registry, rerun the script
+    1. In case of intermittent problems with the registry, try `cargo release`
       locally to publish any missing crates from this release. This step
       requires the appropriate privileges to push crates to [crates.io].
     2. In case the problems arise from the source files, fix them, bump a new
       patch version (e.g. `v0.48.1`) and repeat the process with its
       corresponding new tag.
-11. Once the tag is pushed, create a GitHub release and append
+10. Once the tag is pushed, wait for the CI bot to create a GitHub release,
+    then update the release description and append:
    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
-   to the release description.
 
 All done! 🎉
 
 [crates.io]: https://crates.io
-[`release.sh`]: https://github.com/cosmos/ibc-rs/blob/main/scripts/release.sh
 [release.yml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yml
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 8d1355c08..abc082834 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name        = "ibc-derive"
-version     = "0.4.0"
+version     = "0.5.0"
 license     = { workspace = true }
 repository  = { workspace = true }
 edition     = { workspace = true }
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index 86c316dcf..91d465d6b 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -68,7 +68,7 @@ fn test_tm_create_client_ok() {
 
     let msg = MsgCreateClient::new(
         tm_client_state,
-        TmConsensusState::try_from(tm_header).unwrap().into(),
+        TmConsensusState::from(tm_header).into(),
         signer,
     );
 
diff --git a/scripts/release.sh b/scripts/release.sh
deleted file mode 100755
index d95806fdc..000000000
--- a/scripts/release.sh
+++ /dev/null
@@ -1,107 +0,0 @@
-#!/bin/bash
-
-# release.sh will hopefully allow us to publish all of the necessary crates in
-# this repo in the right order. It is assumed that only one person will be
-# releasing all crates at the same time.
-
-set -euo pipefail
-
-# A space-separated list of all the crates we want to publish, in the order in
-# which they must be published. It's important to respect this order, since
-# each subsequent crate depends on one or more of the preceding ones.
-DEFAULT_CRATES=(
-    "ibc-primitives"
-    "ibc-core-host-types"
-    "ibc-core-router-types"
-    "ibc-core-commitment-types"
-    "ibc-core-client-types"
-    "ibc-core-connection-types"
-    "ibc-core-channel-types"
-    "ibc-core-handler-types"
-    "ibc-core-client-context"
-    "ibc-core-host"
-    "ibc-core-router"
-    "ibc-core-client"
-    "ibc-core-connection"
-    "ibc-core-channel"
-    "ibc-core-handler"
-    "ibc-core"
-    "ibc-client-tendermint-types"
-    "ibc-client-tendermint"
-    "ibc-clients"
-    "ibc-app-transfer-types"
-    "ibc-app-transfer"
-    "ibc-apps"
-    "ibc-core-host-cosmos"
-    "ibc-data-types"
-    "ibc"
-    "ibc-query"
-    "ibc-testkit"
-)
-
-# Allows us to override the crates we want to publish.
-CRATES=("${@:-${DEFAULT_CRATES[@]}}")
-
-# Additional flags to pass to the "cargo publish" operation for every crate we
-# publish.
-CARGO_PUBLISH_FLAGS=""
-
-# Allow us to specify a crates.io API token via environment variables. Mostly
-# for CI use.
-if [ "$CRATES_TOKEN" != "" ]; then
-  CARGO_PUBLISH_FLAGS="${CARGO_PUBLISH_FLAGS} --token ${CRATES_TOKEN}"
-fi
-
-get_manifest_path() {
-  cargo metadata --format-version 1 | jq -r '.packages[]|select(.name == "'"${1}"'")|.manifest_path'
-}
-
-get_local_version() {
-  cargo metadata --format-version 1 | jq -r '.packages[]|select(.name == "'"${1}"'")|.version'
-}
-
-check_version_online() {
-  curl -s "https://crates.io/api/v1/crates/${1}" | jq -r 'try .versions[]|select(.num == "'"${2}"'").updated_at'
-}
-
-publish() {
-  echo "Publishing crate $1..."
-  cargo publish --manifest-path "$(get_manifest_path "${1}")" "$CARGO_PUBLISH_FLAGS"
-  echo ""
-}
-
-wait_until_available() {
-  echo "Waiting for crate ${1} to become available via crates.io..."
-  for retry in {1..5}; do
-    sleep 5
-    ONLINE_DATE="$(check_version_online "${1}" "${2}")"
-    if [ "$ONLINE_DATE" != "" ]; then
-      echo "Crate ${crate} is now available online"
-      break
-    else
-      if [ "$retry" == 5 ]; then
-        echo "ERROR: Crate should have become available by now"
-        exit 1
-      else
-        echo "Not available just yet. Waiting a few seconds..."
-      fi
-    fi
-  done
-  echo "Waiting an additional 10 seconds for crate to propagate through CDN..."
-  sleep 10
-}
-
-echo "Attempting to publish crate(s): ${CRATES}"
-
-for crate in "$CRATES"; do
-  VERSION="$(get_local_version "$crate")"
-  ONLINE_DATE="$(check_version_online "$crate" "$VERSION")"
-  echo "${crate} version number: ${VERSION}"
-  if [ "$ONLINE_DATE" != "" ]; then
-    echo "${crate} ${VERSION} has already been published at ${ONLINE_DATE}, skipping"
-    continue
-  fi
-
-  publish "$crate"
-  wait_until_available "$crate" "$VERSION"
-done

From 08aeb02075b058d41568e013f5917965eac888b0 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Wed, 3 Jan 2024 11:42:14 -0600
Subject: [PATCH 086/182] fix: typo in Cargo.toml + switch to tag branch for
 publishing crates  (#1024)

* Fix typo in cargo.toml

* CI: use ref to checkout to tag branch for publish

* CI: use ref for gh-release as well

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .github/workflows/release.yaml | 4 ++++
 Cargo.toml                     | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 86282f360..50c7ca721 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -43,6 +43,8 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.ref }}
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
       - name: Install cargo-release
@@ -60,6 +62,8 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.ref }}
       - uses: taiki-e/create-gh-release-action@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/Cargo.toml b/Cargo.toml
index ac2d39628..d4df501c3 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -54,7 +54,7 @@ rstest              = "0.18.2"
 schemars            = { version = "0.8.15" }
 sha2                = { version = "0.10.8", default-features = false }
 serde               = { version = "1.0", default-features = false }
-serde_json          = { package = "serde-json-wasm", version = "1.0.0" , default-features = false }
+serde_json          = { package = "serde-json-wasm", version = "1.0.0", default-features = false }
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies

From f4ea79990bb08d53c2c55ecc299b351484036032 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 3 Jan 2024 17:22:29 -0800
Subject: [PATCH 087/182] Release v0.49.1 (#1026)

* CI: add check-features

* fix: allow publish from HEAD

* chore: bump version to v0.49.1

* fix: set --allow-branch to HEAD for publish job
---
 .../1014-better-client-id-new.md              |  0
 .../837-split-sent-coins-method copy.md       |  0
 .../839-add-memo-field-for-token-escrow.md    |  0
 .../breaking-changes/978-identifier-error.md  |  0
 .../breaking-changes/993-bump-ibc-proto-rs.md |  0
 .../997-minimize-prost-dependency.md          |  0
 .../1008-commitment-proof-bytes-as-ref.md     |  0
 .../improvements/1005-status-verify-active.md |  0
 .../improvements/1011-status-verify-active.md |  0
 ...1017-use-global-paths-in-generated-code.md |  0
 .../992-more-rigorous-cosmwasm-check.md       |  0
 .../improvements/993-streamline-msg-trait.md  |  0
 .../996-custom-chain-id-deserialization.md    |  0
 .changelog/{v0.49.0 => v0.49.1}/summary.md    |  0
 .github/workflows/release.yaml                | 14 ++---
 .github/workflows/rust.yml                    | 60 ++++++++++++-------
 CHANGELOG.md                                  |  2 +-
 Cargo.toml                                    | 50 ++++++++--------
 ci/cw-check/Cargo.lock                        | 40 ++++++-------
 ci/no-std-check/Cargo.lock                    | 51 ++++++++--------
 ibc-apps/ics20-transfer/types/src/error.rs    |  6 +-
 21 files changed, 117 insertions(+), 106 deletions(-)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/1014-better-client-id-new.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/837-split-sent-coins-method copy.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/839-add-memo-field-for-token-escrow.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/978-identifier-error.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/993-bump-ibc-proto-rs.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/breaking-changes/997-minimize-prost-dependency.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/features/1008-commitment-proof-bytes-as-ref.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/1005-status-verify-active.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/1011-status-verify-active.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/1017-use-global-paths-in-generated-code.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/992-more-rigorous-cosmwasm-check.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/993-streamline-msg-trait.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/improvements/996-custom-chain-id-deserialization.md (100%)
 rename .changelog/{v0.49.0 => v0.49.1}/summary.md (100%)

diff --git a/.changelog/v0.49.0/breaking-changes/1014-better-client-id-new.md b/.changelog/v0.49.1/breaking-changes/1014-better-client-id-new.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/1014-better-client-id-new.md
rename to .changelog/v0.49.1/breaking-changes/1014-better-client-id-new.md
diff --git a/.changelog/v0.49.0/breaking-changes/837-split-sent-coins-method copy.md b/.changelog/v0.49.1/breaking-changes/837-split-sent-coins-method copy.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/837-split-sent-coins-method copy.md
rename to .changelog/v0.49.1/breaking-changes/837-split-sent-coins-method copy.md
diff --git a/.changelog/v0.49.0/breaking-changes/839-add-memo-field-for-token-escrow.md b/.changelog/v0.49.1/breaking-changes/839-add-memo-field-for-token-escrow.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/839-add-memo-field-for-token-escrow.md
rename to .changelog/v0.49.1/breaking-changes/839-add-memo-field-for-token-escrow.md
diff --git a/.changelog/v0.49.0/breaking-changes/978-identifier-error.md b/.changelog/v0.49.1/breaking-changes/978-identifier-error.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/978-identifier-error.md
rename to .changelog/v0.49.1/breaking-changes/978-identifier-error.md
diff --git a/.changelog/v0.49.0/breaking-changes/993-bump-ibc-proto-rs.md b/.changelog/v0.49.1/breaking-changes/993-bump-ibc-proto-rs.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/993-bump-ibc-proto-rs.md
rename to .changelog/v0.49.1/breaking-changes/993-bump-ibc-proto-rs.md
diff --git a/.changelog/v0.49.0/breaking-changes/997-minimize-prost-dependency.md b/.changelog/v0.49.1/breaking-changes/997-minimize-prost-dependency.md
similarity index 100%
rename from .changelog/v0.49.0/breaking-changes/997-minimize-prost-dependency.md
rename to .changelog/v0.49.1/breaking-changes/997-minimize-prost-dependency.md
diff --git a/.changelog/v0.49.0/features/1008-commitment-proof-bytes-as-ref.md b/.changelog/v0.49.1/features/1008-commitment-proof-bytes-as-ref.md
similarity index 100%
rename from .changelog/v0.49.0/features/1008-commitment-proof-bytes-as-ref.md
rename to .changelog/v0.49.1/features/1008-commitment-proof-bytes-as-ref.md
diff --git a/.changelog/v0.49.0/improvements/1005-status-verify-active.md b/.changelog/v0.49.1/improvements/1005-status-verify-active.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/1005-status-verify-active.md
rename to .changelog/v0.49.1/improvements/1005-status-verify-active.md
diff --git a/.changelog/v0.49.0/improvements/1011-status-verify-active.md b/.changelog/v0.49.1/improvements/1011-status-verify-active.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/1011-status-verify-active.md
rename to .changelog/v0.49.1/improvements/1011-status-verify-active.md
diff --git a/.changelog/v0.49.0/improvements/1017-use-global-paths-in-generated-code.md b/.changelog/v0.49.1/improvements/1017-use-global-paths-in-generated-code.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/1017-use-global-paths-in-generated-code.md
rename to .changelog/v0.49.1/improvements/1017-use-global-paths-in-generated-code.md
diff --git a/.changelog/v0.49.0/improvements/992-more-rigorous-cosmwasm-check.md b/.changelog/v0.49.1/improvements/992-more-rigorous-cosmwasm-check.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/992-more-rigorous-cosmwasm-check.md
rename to .changelog/v0.49.1/improvements/992-more-rigorous-cosmwasm-check.md
diff --git a/.changelog/v0.49.0/improvements/993-streamline-msg-trait.md b/.changelog/v0.49.1/improvements/993-streamline-msg-trait.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/993-streamline-msg-trait.md
rename to .changelog/v0.49.1/improvements/993-streamline-msg-trait.md
diff --git a/.changelog/v0.49.0/improvements/996-custom-chain-id-deserialization.md b/.changelog/v0.49.1/improvements/996-custom-chain-id-deserialization.md
similarity index 100%
rename from .changelog/v0.49.0/improvements/996-custom-chain-id-deserialization.md
rename to .changelog/v0.49.1/improvements/996-custom-chain-id-deserialization.md
diff --git a/.changelog/v0.49.0/summary.md b/.changelog/v0.49.1/summary.md
similarity index 100%
rename from .changelog/v0.49.0/summary.md
rename to .changelog/v0.49.1/summary.md
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 50c7ca721..7887221fb 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -27,10 +27,10 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      - name: Cache cargo dependencies
-        uses: Swatinem/rust-cache@v2
       - name: Install cargo-release
         run: cargo install cargo-release
+      - name: Cache cargo dependencies
+        uses: Swatinem/rust-cache@v2
       - name: Publish crates (dry run)
         run: cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive
         env:
@@ -43,14 +43,12 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.ref }}
-      - name: Cache cargo dependencies
-        uses: Swatinem/rust-cache@v2
       - name: Install cargo-release
         run: cargo install cargo-release
+      - name: Cache cargo dependencies
+        uses: Swatinem/rust-cache@v2
       - name: Publish crates
-        run: cargo release --workspace --no-push --no-tag --exclude ibc-derive --execute
+        run: cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
   
@@ -62,8 +60,6 @@ jobs:
       contents: write
     steps:
       - uses: actions/checkout@v4
-        with:
-          ref: ${{ github.event.ref }}
       - uses: taiki-e/create-gh-release-action@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index d343d327b..2feef2028 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -47,6 +47,22 @@ jobs:
         GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
     if: "!startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main'"
 
+  check-features:
+    name: Check features
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions-rs/toolchain@v1
+        with:
+          toolchain: stable
+          override: true
+      - name: Install cargo-hack
+        uses: taiki-e/install-action@cargo-hack
+      - uses: Swatinem/rust-cache@v2
+      - name: Run cargo hack
+        run: cargo hack check --workspace --feature-powerset --exclude-features default
+
   nightly_fmt:
     runs-on: ubuntu-latest
     steps:
@@ -60,62 +76,64 @@ jobs:
         with:
           command: fmt
           args: --all -- --check
-  
-  doc_all_features:
+
+  clippy_all_features:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
+          components: clippy
           override: true
-      - uses: actions-rs/cargo@v1
+      - uses: Swatinem/rust-cache@v1
+      - uses: actions-rs/clippy-check@v1
         with:
-          command: doc
-          args: --all-features --release
-    
-  doc_no_default_features:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          args: --all-features --all-targets
+
+  clippy_no_default_features:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
+          components: clippy
           override: true
-      - uses: actions-rs/cargo@v1
+      - uses: Swatinem/rust-cache@v1
+      - uses: actions-rs/clippy-check@v1
         with:
-          command: doc
-          args: --no-default-features --release
+          token: ${{ secrets.GITHUB_TOKEN }}
+          args: --no-default-features --lib
 
-  clippy_all_features:
+  doc_all_features:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
-          components: clippy
           override: true
       - uses: Swatinem/rust-cache@v1
-      - uses: actions-rs/clippy-check@v1
+      - uses: actions-rs/cargo@v1
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          args: --all-features --all-targets
-
-  clippy_no_default_features:
+          command: doc
+          args: --all-features --release
+    
+  doc_no_default_features:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
-          components: clippy
           override: true
       - uses: Swatinem/rust-cache@v1
-      - uses: actions-rs/clippy-check@v1
+      - uses: actions-rs/cargo@v1
         with:
-          token: ${{ secrets.GITHUB_TOKEN }}
-          args: --no-default-features --lib
+          command: doc
+          args: --no-default-features --release
 
   test-stable:
     runs-on: ubuntu-latest
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 98f8b067e..e160061fe 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,6 +1,6 @@
 # CHANGELOG
 
-## v0.49.0
+## v0.49.1
 
 *January 3, 2024*
 
diff --git a/Cargo.toml b/Cargo.toml
index d4df501c3..39f779901 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -37,7 +37,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.49.0"
+version      = "0.49.1"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -58,33 +58,33 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.0", default-
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.49.0", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.49.0", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.49.0", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.49.0", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.49.0", path = "./ibc-primitives", default-features = false }
+ibc                 = { version = "0.49.1", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.49.1", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.49.1", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.49.1", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.49.1", path = "./ibc-primitives", default-features = false }
 ibc-derive          = { version = "0.5.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.49.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.49.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.49.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.49.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.49.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.49.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.49.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.49.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-core-client       = { version = "0.49.1", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.49.1", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.49.1", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.49.1", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.49.1", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.49.1", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.49.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.49.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.49.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.49.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.49.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.49.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.49.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.49.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.49.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.49.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.49.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.49.1", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.49.1", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.49.1", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.49.1", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.49.1", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.49.1", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.49.1", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.49.1", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.49.1", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.39.1", default-features = false }
 
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 5f536b35f..db9fd1b48 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -610,7 +610,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -619,7 +619,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -634,14 +634,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -655,7 +655,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -669,7 +669,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -690,7 +690,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -702,7 +702,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -718,7 +718,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -736,7 +736,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -752,7 +752,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -763,7 +763,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -782,7 +782,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -796,7 +796,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -818,7 +818,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -835,7 +835,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -848,7 +848,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -861,7 +861,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -878,7 +878,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "darling",
  "proc-macro2",
@@ -888,7 +888,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 5b6bbc27a..40f4a67b2 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1213,7 +1213,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1225,7 +1225,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1234,7 +1234,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1247,14 +1247,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -1269,7 +1269,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1285,14 +1285,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-client-tendermint",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1306,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1320,7 +1320,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1338,7 +1338,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1350,7 +1350,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1366,7 +1366,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1381,7 +1381,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1394,7 +1394,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1405,7 +1405,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1421,7 +1421,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1435,7 +1435,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1454,7 +1454,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1471,7 +1471,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1493,7 +1493,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1503,7 +1503,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1516,14 +1516,13 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
  "ibc-core-host-types",
  "ibc-primitives",
  "ibc-proto",
- "ics23",
  "serde",
  "subtle-encoding",
  "tendermint",
@@ -1531,7 +1530,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.4.0"
+version = "0.5.0"
 dependencies = [
  "darling",
  "proc-macro2",
@@ -1541,7 +1540,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.48.2"
+version = "0.49.1"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ibc-apps/ics20-transfer/types/src/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
index f4b06aee5..2ef3f732a 100644
--- a/ibc-apps/ics20-transfer/types/src/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -11,8 +11,6 @@ use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
 use uint::FromDecStrErr;
 
-use crate::Amount;
-
 #[derive(Display, Debug)]
 pub enum TokenTransferError {
     /// context error: `{0}`
@@ -21,8 +19,8 @@ pub enum TokenTransferError {
     InvalidIdentifier(IdentifierError),
     /// insufficient funds: tried to send `{send_attempt}`, sender only has `{available_funds}`
     InsufficientFunds {
-        send_attempt: Amount,
-        available_funds: Amount,
+        send_attempt: String,
+        available_funds: String,
     },
     /// destination channel not found in the counterparty of port_id `{port_id}` and channel_id `{channel_id}`
     DestinationChannelNotFound {

From 8a552f7d0a7fb3bec1fd8ffbd7c0a98d66a769aa Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 4 Jan 2024 14:26:40 -0800
Subject: [PATCH 088/182] chore: update CONTRIBUTING.md (#1029)

---
 .github/workflows/release.yaml |   2 +-
 CONTRIBUTING.md                | 223 ++++++++++++++++++---------------
 RELEASES.md                    |   2 +-
 3 files changed, 122 insertions(+), 105 deletions(-)

diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 7887221fb..153832e72 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -48,7 +48,7 @@ jobs:
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
       - name: Publish crates
-        run: cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
+        run: yes | cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
   
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2595d1205..0e83c5585 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,15 +1,6 @@
 # Contributing
 
-Thank you for your interest in contributing! The goal
-of ibc-rs is to provide a high quality, formally verified implementation of
-the IBC protocol.
-
-All work on the code base should be motivated by a Github
-issue. Before opening a new issue, first do a search of open and closed issues
-to make sure that yours will not be a duplicate.
-If you would like to work on an issue which already exists, please indicate so
-by leaving a comment. If what you'd like to work on hasn't already been covered
-by an issue, then open a new one to get the process going.
+Thank you for your interest in contributing to ibc-rs!🎉
 
 The rest of this document outlines the best practices for contributing to this
 repository:
@@ -22,34 +13,34 @@ repository:
 
 ## Decision Making
 
-When contributing to the project, the following process leads to the best chance of
-landing the changes in `main`.
+The following process leads to the best chance of landing the changes in `main`.
 
-All new contributions should start with a Github issue which captures the
+All new contributions should **start with a GitHub issue** which captures the
 problem you're trying to solve. Starting off with an issue allows for early
-feedback. Once the issue is created, maintainers may request that more detailed
+feedback. See the [Issues](#issues) section for more details.
+
+Once the issue is created, maintainers may request that more detailed
 documentation be written in the form of a Request for Comment (RFC) or an
 Architectural Decision Record
 ([ADR](https://github.com/cosmos/ibc-rs/blob/main/docs/architecture/README.md)).
 
-Discussion at the RFC stage will build collective understanding of the dimensions
-of the problem and help structure conversations around trade-offs.
-
-When the problem is well understood but the solution leads to large
-structural changes to the code base, these changes should be proposed in
-the form of an [Architectural Decision Record
-(ADR)](./docs/architecture/). The ADR will help build consensus on an
-overall strategy to ensure that the code base maintains coherence
-in the larger context. If you are not comfortable with writing an ADR,
-you can open a regular issue and the maintainers will help you
-turn it into an ADR.
-
-When the problem and the proposed solution are well understood,
-changes should start with a [draft
-pull request](https://github.blog/2019-02-14-introducing-draft-pull-requests/)
-against `main`. The draft status signals that work is underway. When the work
-is ready for feedback, hitting "Ready for Review" will signal to the
-maintainers to take a look.
+Discussion at the RFC stage will build collective understanding of the
+dimensions of the problem and help structure conversations around trade-offs.
+
+When the problem is well understood but the solution leads to large structural
+changes to the code base, these changes should be proposed in the form of an
+[Architectural Decision Record (ADR)](./docs/architecture/). The ADR will help
+build consensus on an overall strategy to ensure that the code base maintains
+coherence in the larger context. If you are not comfortable with writing an ADR,
+you can open a regular issue and the maintainers will help you turn it into an
+ADR.
+
+When the problem and the proposed solution are well understood, changes should
+start with a [draft pull
+request](https://github.blog/2019-02-14-introducing-draft-pull-requests/)
+against `main`. The draft status signals that work is underway. When the work is
+ready for feedback, hitting "Ready for Review" will signal to the maintainers to
+take a look.
 
 Implementation trajectories should aim to proceed where possible as a series
 of smaller incremental changes, in the form of small PRs that can be merged
@@ -58,67 +49,93 @@ that PRs will sit open for long periods of time.
 
 ![Contributing flow](https://github.com/tendermint/tendermint/blob/v0.33.6/docs/imgs/contributing.png?raw=true)
 
-Each stage of the process is aimed at creating feedback cycles which align
-contributors and maintainers in order to ensure that:
-
-- Contributors don’t waste their time implementing/proposing features which won’t land in `main`
-- Maintainers have the necessary context in order to support and review contributions
-
 ## Issues
 
-We welcome bug reports, feature requests, and other contributions to our project. To open an issue, please follow these guidelines:
+We appreciate bug reports, feature requests, and contributions to our project.
+If you're new to contributing, a great starting point is to explore [A:
+good-first-issues](https://github.com/cosmos/ibc-rs/labels/A%3A%20good-first-issue)
+on our GitHub repository. These are well-defined tasks ideal for developers who
+are new to ibc-rs. When opening an issue, kindly adhere to the following
+guidelines:
 
-1. **Search existing issues**: Before opening a new issue, please search existing issues to ensure that is not a duplicates.
+1. **Search existing issues**: Before opening a new issue, please search
+   existing issues to ensure that is not a duplicates. If you would like to work
+   on an issue which already exists please indicate so by leaving a comment. If
+   what you'd like to work on hasn't already been covered by an issue, then open
+   a new one to get the process going.
 
-2. **Provide a clear and descriptive title**: This helps others understand the nature of the issue at a glance.
+2. **Provide a clear and descriptive title**: This helps others understand the
+   nature of the issue at a glance.
 
-3. **Provide detailed information**: In the issue description, clearly state the purpose of the issue and follow the guidelines of the issue template
+3. **Provide detailed information**: In the issue description, clearly state the
+   purpose of the issue and follow the guidelines of the issue template
 
-Note: A maintainer will take care of assigning the appropriate labels to your issue with the following convention:
+Note: A maintainer will take care of assigning the appropriate labels to your
+issue with the following convention:
 
-- Objective-level (WHY): conveys the overarching purpose or objective of the issue by labels starting with "O" like `O: security`, `O: new-feature`, etc.
+- Objective-level (WHY): conveys the overarching purpose or objective of the
+  issue by labels starting with "O" like `O: security`, `O: new-feature`, etc.
 
-- Scope-level (WHICH): specifies the part of the system that the issue pertains to and labels starting with "S" like `S: non-cosmos`, `S: no-std`, etc.
+- Scope-level (WHICH): specifies the part of the system that the issue pertains
+  to and labels starting with "S" like `S: non-cosmos`, `S: no-std`, etc.
 
-- Admin-level (HOW) includes relevant administrative considerations on how best handling the issue and labels starting with "A" like `A: help-wanted`, `A: critical`, etc.
+- Admin-level (HOW) includes relevant administrative considerations on how best
+  handling the issue and labels starting with "A" like `A: help-wanted`, `A:
+  critical`, etc.
+
+If the issue was tagged `A: low-priority`, we'll do our best to review it in a
+timely manner, but please expect longer wait times for a review in general. If a
+low priority issue is important to you, please leave a comment explaining why,
+and we will re-prioritize it!
 
 ## Pull Requests
 
-If you have write access to the ibc-rs repo, you can directly branch off of `main`.
-This makes it easier for project maintainers to directly make changes to your
-branch should the need arise. Otherwise, check [Forking](#forking) section for instructions.
+Before making any changes, please create a new issue or refer to an existing one
+to initiate a discussion with us. This allows for collaborative discussions on
+the design and proposed implementation of your changes. This way, we ensure that
+your efforts align with our objectives and increase the likelihood of your
+contribution being accepted.
 
-Branch names should be prefixed with the author's name followed by a short description
-of the feature, eg. `name/feature-x`.
+Pull requests should aim to be small and self-contained to facilitate quick
+review and merging. Larger change sets should be broken up across multiple PRs.
+Commits should be concise but informative, and moderately clean. Please follow
+these guidelines when opening a pull request:
 
-Pull requests are made against `main` and are squash-merged into main.
+- If you have write access to the ibc-rs repo,  directly branch off from `HEAD`
+  of `main`. Otherwise, check [Forking](#forking) section for instructions.
 
-**PRs must:**
+- Branch names should be prefixed with the convention
+  `{moniker}/{issue#}-branch-name`.
 
-- make reference to an issue outlining the context
-- update any relevant documentation and include tests
-- add a corresponding entry in the `.changelog` directory using `unclog`,
-  see the [Changelog](#changelog) section for more details.
+- Ensure PR titles adhere to the format of `{type}: {description}`. The {type}
+  should be selected from the following list:
+  - feat: for feature work.
+  - fix: for bug fixes.
+  - imp: for refactors and improvements.
+  - docs: for documentation changes.
+  - test: for addition or improvements of unit, integration and e2e tests.
+  - deps: for changes to dependencies.
+  - chore: for any miscellaneous changes that don't fit into another category.
+  - If any change is breaking, follow the format below: type + (api)! for api
+    breaking changes, e.g. fix(api)!: api breaking fix type + (statemachine)!
+    for state machine breaking changes, e.g. fix(statemachine)!: state machine
+    breaking fix api breaking changes take precedence over statemachine breaking
+    changes.
 
-Pull requests should aim to be small and self-contained to facilitate quick
-review and merging. Larger change sets should be broken up across multiple PRs.
-Commits should be concise but informative, and moderately clean. Commits will be squashed into a
-single commit for the PR with all the commit messages.
+- Commit messages should follow the [Conventional Commits
+  specification](https://www.conventionalcommits.org/en/v1.0.0/).
 
-If the issue you worked on was tagged `A: low-priority`, we'll do our best to
-review it in a timely manner, but please expect longer wait times for a review
-in general. If a low priority issue is important to you, please leave a comment
-explaining why, and we will re-prioritize it!
+- Make reference to the relevant issue by including `Closes: #<issue number>` in
+  the PR’s description to auto-close the related issue once the PR is merged.
 
-## Responsibilities of a PR Reviewer
+- Update any relevant documentation and include tests.
 
-If you're tagged as the reviewer of a PR, you are responsible for shepherding it
-through to completion. This includes fixing issues with the PR and taking the
-lead on decisions that need to be resolved in order to get the PR merged.
+- Add a corresponding entry in the `.changelog` directory using `unclog`. See
+  the [Changelog](#changelog) section for more details.
 
-If you're tagged as a reviewer on a PR that affects a part of the code base that
-you are unfamiliar with, you can hand it off to someone (with their
-consent) who is more appropriate to shepherd the PR through to completion.
+- If possible, tick the `Allow edits from maintainers` box when opening your PR
+  from your fork of ibc-rs. This allows us to directly make minor edits /
+  refactors and speeds up the merging process.
 
 ## Forking
 
@@ -146,9 +163,10 @@ To pull in updates from the origin repo, run `git fetch upstream` followed by
 
 Every non-trivial PR must update the [CHANGELOG](CHANGELOG.md). This is
 accomplished indirectly by adding entries to the `.changelog` folder in
-[`unclog`](https://github.com/informalsystems/unclog) format using the `unclog` CLI tool.
-`CHANGELOG.md` will be built by whomever is responsible for performing a release just
-prior to release - this is to avoid changelog conflicts prior to releases.
+[`unclog`](https://github.com/informalsystems/unclog) format using the `unclog`
+CLI tool. `CHANGELOG.md` will be built by whomever is responsible for performing
+a release just prior to release - this is to avoid changelog conflicts prior to
+releases.
 
 ### Install `unclog`
 
@@ -177,33 +195,33 @@ unclog add -c ibc -s features --id a-new-feature --issue-no 1235 -m "msg about t
 unclog build -u
 ```
 
-The Changelog is *not* a record of what Pull Requests were merged;
-the commit history already shows that. The Changelog is a notice to users
-about how their expectations of the software should be modified.
-It is part of the UX of a release and is a *critical* user facing integration point.
-The Changelog must be clean, inviting, and readable, with concise, meaningful entries.
-Entries must be semantically meaningful to users. If a change takes multiple
-Pull Requests to complete, it should likely have only a single entry in the
-Changelog describing the net effect to the user. Instead of linking PRs directly, we
-instead prefer to log issues, which tend to be higher-level, hence more relevant for users.
+The Changelog is *not* a record of what Pull Requests were merged; the commit
+history already shows that. The Changelog is a notice to users about how their
+expectations of the software should be modified. It is part of the UX of a
+release and is a *critical* user facing integration point. The Changelog must be
+clean, inviting, and readable, with concise, meaningful entries. Entries must be
+semantically meaningful to users. If a change takes multiple Pull Requests to
+complete, it should likely have only a single entry in the Changelog describing
+the net effect to the user. Instead of linking PRs directly, we instead prefer
+to log issues, which tend to be higher-level, hence more relevant for users.
 
 When writing Changelog entries, ensure they are targeting users of the software,
 not fellow developers. Developers have much more context and care about more
 things than users do. Changelogs are for users.
 
-Changelog structure is modeled after
-[Tendermint Core](https://github.com/tendermint/tendermint/blob/master/CHANGELOG.md)
-and [Hashicorp Consul](http://github.com/hashicorp/consul/tree/master/CHANGELOG.md).
+Changelog structure is modeled after [Tendermint
+Core](https://github.com/tendermint/tendermint/blob/master/CHANGELOG.md) and
+[Hashicorp Consul](http://github.com/hashicorp/consul/tree/master/CHANGELOG.md).
 See those changelogs for examples.
 
-We currently split changes for a given release between these four sections: Breaking
-Changes, Features, Improvements, Bug Fixes.
+We currently split changes for a given release between these four sections:
+Breaking Changes, Features, Improvements, Bug Fixes.
 
-Entries in the changelog should initially be logged in the **Unreleased** section, which
-represents a "staging area" for accumulating all the changes throughout a
-release (see [Pull Requests](#pull-requests) below). With each release,
-the entries then move from this section into their permanent place under a
-specific release number in Changelog.
+Entries in the changelog should initially be logged in the **Unreleased**
+section, which represents a "staging area" for accumulating all the changes
+throughout a release (see [Pull Requests](#pull-requests) above). With each
+release, the entries then move from this section into their permanent place
+under a specific release number in Changelog.
 
 Changelog entries should be formatted as follows:
 
@@ -211,17 +229,16 @@ Changelog entries should be formatted as follows:
 - [pkg] Some description about the change ([#xxx](https://github.com/cosmos/ibc-rs/issues/xxx)) (optional @contributor)
 ```
 
-Here, `pkg` is the part of the code that changed (typically a
-top-level crate, but could be `<crate>/<module>`), `xxx` is the issue number, and `contributor`
+Here, `pkg` is the part of the code that changed (typically a top-level crate,
+but could be `<crate>/<module>`), `xxx` is the issue number, and `contributor`
 is the author/s of the change.
 
 It's also acceptable for `xxx` to refer to the relevant pull request, but issue
-numbers are preferred.
-Note this means issues (or pull-requests) should be opened first so the changelog can then
-be updated with the corresponding number.
+numbers are preferred. Note this means issues (or pull-requests) should be
+opened first so the changelog can then be updated with the corresponding number.
 
-Changelog entries should be ordered alphabetically according to the
-`pkg`, and numerically according to their issue/PR number.
+Changelog entries should be ordered alphabetically according to the `pkg`, and
+numerically according to their issue/PR number.
 
 Changes with multiple classifications should be doubly included (eg. a bug fix
 that is also a breaking change should be recorded under both).
@@ -229,5 +246,5 @@ that is also a breaking change should be recorded under both).
 Breaking changes are further subdivided according to the APIs/users they impact.
 Any change that effects multiple APIs/users should be recorded multiply - for
 instance, a change to some core protocol data structure might need to be
-reflected both as breaking the core protocol but also breaking any APIs where core data structures are
-exposed.
+reflected both as breaking the core protocol but also breaking any APIs where
+core data structures are exposed.
diff --git a/RELEASES.md b/RELEASES.md
index 416a5765c..a5055293e 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -51,4 +51,4 @@ Our release process is as follows:
 All done! 🎉
 
 [crates.io]: https://crates.io
-[release.yml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yml
+[release.yml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yaml

From 10a51887063baa3878597af71da1b142ba411b5c Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 10 Jan 2024 06:48:26 -0800
Subject: [PATCH 089/182] deps: update ibc-proto-rs to v0.41.0 (#1036)

* deps: update ibc-proto-rs to v0.41.0

* nit
---
 .../1036-bump-ibc-proto-to-v0-41-0.md         |   2 +
 Cargo.toml                                    |   2 +-
 ci/cw-check/Cargo.lock                        |  17 +-
 ci/no-std-check/Cargo.lock                    | 390 ++++++++++++------
 ci/no-std-check/Cargo.toml                    |  10 +-
 ibc-primitives/Cargo.toml                     |   2 +-
 6 files changed, 291 insertions(+), 132 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md

diff --git a/.changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md b/.changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
new file mode 100644
index 000000000..30572655f
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
@@ -0,0 +1,2 @@
+- [ibc] Bump `ibc-proto-rs` to v0.41.0
+  ([\#1036](https://github.com/cosmos/ibc-rs/pull/1036)).
diff --git a/Cargo.toml b/Cargo.toml
index 39f779901..9f3f31493 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -86,7 +86,7 @@ ibc-core-router-types       = { version = "0.49.1", path = "./ibc-core/ics26-rou
 ibc-client-tendermint-types = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
 ibc-app-transfer-types      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
-ibc-proto = { version = "0.39.1", default-features = false }
+ibc-proto = { version = "0.41.0", default-features = false }
 
 # cosmos dependencies
 tendermint                       = { version = "0.34.0", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index db9fd1b48..3434bbb30 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -904,14 +904,15 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.39.1"
+version = "0.41.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c8a8b1356652b9f160f5a010dd6b084675b8a28e163bf2b41ca5abecf27d9701"
+checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
 dependencies = [
  "base64 0.21.5",
  "bytes",
  "flex-error",
  "ics23",
+ "informalsystems-pbjson 0.7.0",
  "parity-scale-codec",
  "prost",
  "scale-info",
@@ -930,7 +931,7 @@ dependencies = [
  "anyhow",
  "bytes",
  "hex",
- "informalsystems-pbjson",
+ "informalsystems-pbjson 0.6.0",
  "prost",
  "ripemd",
  "serde",
@@ -990,6 +991,16 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "informalsystems-pbjson"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
+dependencies = [
+ "base64 0.21.5",
+ "serde",
+]
+
 [[package]]
 name = "itertools"
 version = "0.11.0"
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 40f4a67b2..271b67e18 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -299,6 +299,25 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "bip39"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93f2635620bf0b9d4576eb7bb9a38a55df78bd1205d26fa994b25911a69f212f"
+dependencies = [
+ "bitcoin_hashes",
+ "rand 0.8.5",
+ "rand_core 0.6.4",
+ "serde",
+ "unicode-normalization",
+]
+
+[[package]]
+name = "bitcoin_hashes"
+version = "0.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "90064b8dee6815a6470d60bad07bbbaee885c0e12d04177138fa3291a01b7bc4"
+
 [[package]]
 name = "bitflags"
 version = "1.3.2"
@@ -508,6 +527,12 @@ dependencies = [
  "windows-targets 0.48.5",
 ]
 
+[[package]]
+name = "common-path"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2382f75942f4b3be3690fe4f86365e9c853c1587d6ee58212cebf6e2a9ccd101"
+
 [[package]]
 name = "const-oid"
 version = "0.9.5"
@@ -655,7 +680,7 @@ checksum = "83fdaf97f4804dcebfa5862639bc9ce4121e82140bec2a987ac5140294865b5b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -692,7 +717,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -703,7 +728,7 @@ checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -733,6 +758,17 @@ dependencies = [
  "syn 1.0.109",
 ]
 
+[[package]]
+name = "derive-syn-parse"
+version = "0.1.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e79116f119dd1dba1abf1f3405f03b9b0e79a27a3883864bfebded8a3dc768cd"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 1.0.109",
+]
+
 [[package]]
 name = "derive_more"
 version = "0.99.17"
@@ -781,7 +817,34 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
+]
+
+[[package]]
+name = "docify"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7cc4fd38aaa9fb98ac70794c82a00360d1e165a87fbf96a8a91f9dfc602aaee2"
+dependencies = [
+ "docify_macros",
+]
+
+[[package]]
+name = "docify_macros"
+version = "0.2.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "63fa215f3a0d40fb2a221b3aa90d8e1fbb8379785a990cb60d62ac71ebdc6460"
+dependencies = [
+ "common-path",
+ "derive-syn-parse",
+ "once_cell",
+ "proc-macro2",
+ "quote",
+ "regex",
+ "syn 2.0.48",
+ "termcolor",
+ "toml 0.8.2",
+ "walkdir",
 ]
 
 [[package]]
@@ -889,6 +952,19 @@ dependencies = [
  "windows-sys 0.48.0",
 ]
 
+[[package]]
+name = "expander"
+version = "2.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5f86a749cf851891866c10515ef6c299b5c69661465e9c3bbe7e07a2b77fb0f7"
+dependencies = [
+ "blake2",
+ "fs-err",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.48",
+]
+
 [[package]]
 name = "fake-simd"
 version = "0.1.2"
@@ -943,6 +1019,15 @@ dependencies = [
  "percent-encoding",
 ]
 
+[[package]]
+name = "fs-err"
+version = "2.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88a41f105fe1d5b6b34b2055e3dc59bb79b46b48b2040b9e6c7b4b5de097aa41"
+dependencies = [
+ "autocfg",
+]
+
 [[package]]
 name = "funty"
 version = "2.0.0"
@@ -1006,7 +1091,7 @@ checksum = "89ca545a94061b6365f2c7355b4b32bd20df3ff95f02da9329b34ccc3bd6ee72"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -1168,15 +1253,6 @@ dependencies = [
  "digest 0.9.0",
 ]
 
-[[package]]
-name = "hmac"
-version = "0.12.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
-dependencies = [
- "digest 0.10.7",
-]
-
 [[package]]
 name = "hmac-drbg"
 version = "0.3.0"
@@ -1535,7 +1611,7 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -1553,15 +1629,16 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.39.1"
+version = "0.41.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c8a8b1356652b9f160f5a010dd6b084675b8a28e163bf2b41ca5abecf27d9701"
+checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
 dependencies = [
  "base64 0.21.4",
  "borsh",
  "bytes",
  "flex-error",
  "ics23",
+ "informalsystems-pbjson 0.7.0",
  "parity-scale-codec",
  "prost",
  "scale-info",
@@ -1579,7 +1656,7 @@ dependencies = [
  "anyhow",
  "bytes",
  "hex",
- "informalsystems-pbjson",
+ "informalsystems-pbjson 0.6.0",
  "prost",
  "ripemd",
  "serde",
@@ -1663,6 +1740,16 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "informalsystems-pbjson"
+version = "0.7.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
+dependencies = [
+ "base64 0.21.4",
+ "serde",
+]
+
 [[package]]
 name = "integer-sqrt"
 version = "0.1.5"
@@ -1895,7 +1982,7 @@ dependencies = [
  "sp-io",
  "sp-runtime",
  "sp-std",
- "syn 2.0.38",
+ "syn 2.0.48",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -2072,15 +2159,6 @@ dependencies = [
  "crypto-mac 0.11.1",
 ]
 
-[[package]]
-name = "pbkdf2"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83a0692ec44e4cf1ef28ca317f14f8f07da2d95ec3fa01f86e4467b725e60917"
-dependencies = [
- "digest 0.10.7",
-]
-
 [[package]]
 name = "percent-encoding"
 version = "2.3.0"
@@ -2140,7 +2218,7 @@ version = "0.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1d6ea3c4595b96363c13943497db34af4460fb474a95c43f4446ad341b8c9785"
 dependencies = [
- "toml",
+ "toml 0.5.11",
 ]
 
 [[package]]
@@ -2150,14 +2228,24 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
 dependencies = [
  "once_cell",
- "toml_edit",
+ "toml_edit 0.19.15",
+]
+
+[[package]]
+name = "proc-macro-crate"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "97dc5fea232fc28d2f597b37c4876b348a40e33f3b02cc975c8d006d78d94b1a"
+dependencies = [
+ "toml_datetime",
+ "toml_edit 0.20.2",
 ]
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.69"
+version = "1.0.76"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "134c189feb4956b20f6f547d2cf727d4c0fe06722b20a0eec87ed445a97f92da"
+checksum = "95fc56cda0b5c3325f5fbbd7ff9fda9e02bb00bb3dac51252d2f1bfa1cb8cc8c"
 dependencies = [
  "unicode-ident",
 ]
@@ -2182,7 +2270,7 @@ dependencies = [
  "itertools 0.11.0",
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -2205,9 +2293,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.33"
+version = "1.0.35"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5267fca4496028628a95160fc423a33e8b2e6af8a5302579e322e4b520293cae"
+checksum = "291ec9ab5efd934aaf503a6466c5d5251535d108ee747472c3977cc5acc868ef"
 dependencies = [
  "proc-macro2",
 ]
@@ -2315,7 +2403,7 @@ checksum = "7f7473c2cfcf90008193dd0e3e16599455cb601a9fce322b5bb55de799664925"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -2377,12 +2465,6 @@ version = "0.1.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d626bb9dae77e28219937af045c257c28bfd3f69333c512553507f5f9798cb76"
 
-[[package]]
-name = "rustc-hash"
-version = "1.1.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08d43f7aa6b08d49f382cde6a7982047c3426db949b1424bc4b7ec9ae12c6ce2"
-
 [[package]]
 name = "rustc-hex"
 version = "2.1.0"
@@ -2437,6 +2519,15 @@ version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
 
+[[package]]
+name = "same-file"
+version = "1.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "93fc1dc3aaa9bfed95e02e6eadabb4baf7e3078b0bd1b4d7b6b0b68378900502"
+dependencies = [
+ "winapi-util",
+]
+
 [[package]]
 name = "scale-info"
 version = "2.10.0"
@@ -2500,18 +2591,18 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "secp256k1"
-version = "0.24.3"
+version = "0.28.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6b1629c9c557ef9b293568b338dddfc8208c98a18c59d722a9d53f859d9c9b62"
+checksum = "3f622567e3b4b38154fb8190bcf6b160d7a4301d70595a49195b48c116007a27"
 dependencies = [
  "secp256k1-sys",
 ]
 
 [[package]]
 name = "secp256k1-sys"
-version = "0.6.1"
+version = "0.9.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83080e2c2fc1006e625be82e5d1eb6a43b7fd9578b617fcc55814daf286bba4b"
+checksum = "e5d1746aae42c19d583c3c1a8c646bfad910498e2051c551a7f2e3c0c9fbb7eb"
 dependencies = [
  "cc",
 ]
@@ -2533,9 +2624,9 @@ checksum = "836fa6a3e1e547f9a2c4040802ec865b5d85f4014efe00555d7090a3dcaa1090"
 
 [[package]]
 name = "serde"
-version = "1.0.189"
+version = "1.0.195"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e422a44e74ad4001bdc8eede9a4570ab52f71190e9c076d14369f38b9200537"
+checksum = "63261df402c67811e9ac6def069e4786148c4563f4b50fd4bf30aa370d626b02"
 dependencies = [
  "serde_derive",
 ]
@@ -2560,13 +2651,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.189"
+version = "1.0.195"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e48d1f918009ce3145511378cf68d613e3b3d9137d67272562080d68a2b32d5"
+checksum = "46fe8f8603d81ba86327b23a2e9cdf49e1255fb94a4c5f297f6ee0547178ea2c"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -2588,7 +2679,16 @@ checksum = "8725e1dfadb3a50f7e5ce0b1a540466f6ed3fe7a0fca2ac2b8b831d31316bd00"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
+]
+
+[[package]]
+name = "serde_spanned"
+version = "0.6.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "eb3622f419d1296904700073ea6cc23ad690adbd66f13ea683df73298736f0c1"
+dependencies = [
+ "serde",
 ]
 
 [[package]]
@@ -2652,6 +2752,12 @@ version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
 
+[[package]]
+name = "simple-mermaid"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "620a1d43d70e142b1d46a929af51d44f383db9c7a2ec122de2cd992ccfcf3c18"
+
 [[package]]
 name = "slab"
 version = "0.4.9"
@@ -2669,9 +2775,9 @@ checksum = "942b4a808e05215192e39f4ab80813e599068285906cc91aa64f923db842bd5a"
 
 [[package]]
 name = "sp-application-crypto"
-version = "27.0.0"
+version = "29.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a93da025616ab59639f8e378df579c5aaa2c8b9999f328a0239156a57c991b53"
+checksum = "bd703034c3f4f34fa4965e0d4d773f50d0f56256b1759b36016b3b1baba147d8"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2683,9 +2789,9 @@ dependencies = [
 
 [[package]]
 name = "sp-arithmetic"
-version = "20.0.0"
+version = "22.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f80b5c16afb61dde1037a469d570adcc686440036429e50abe2301ba9d61aad5"
+checksum = "56dec3290d64ec9994457abe974f82fe7260c9cc32e920e4cf20611346ca7464"
 dependencies = [
  "integer-sqrt",
  "num-traits",
@@ -2698,11 +2804,12 @@ dependencies = [
 
 [[package]]
 name = "sp-core"
-version = "25.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f9ebb090ead698a6df04347c86a31ba91a387edb8a58534ec70c4f977d1e1e87"
+checksum = "d92c65ecfdb86fa1c4809b06a2a83d6f3bdb1ef4fe4c5a4f6df19229030d5283"
 dependencies = [
  "array-bytes",
+ "bip39",
  "bitflags 1.3.2",
  "blake2",
  "bounded-collections",
@@ -2713,7 +2820,7 @@ dependencies = [
  "hash-db",
  "hash256-std-hasher",
  "impl-serde",
- "lazy_static",
+ "itertools 0.10.5",
  "libsecp256k1",
  "log",
  "merlin",
@@ -2722,7 +2829,6 @@ dependencies = [
  "paste",
  "primitive-types",
  "rand 0.8.5",
- "regex",
  "scale-info",
  "schnorrkel",
  "secp256k1",
@@ -2737,7 +2843,6 @@ dependencies = [
  "ss58-registry",
  "substrate-bip39",
  "thiserror",
- "tiny-bip39",
  "tracing",
  "w3f-bls",
  "zeroize",
@@ -2745,9 +2850,9 @@ dependencies = [
 
 [[package]]
 name = "sp-core-hashing"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cb8524f01591ee58b46cd83c9dbc0fcffd2fd730dabec4f59326cd58a00f17e2"
+checksum = "1936171e56a51272757760cc50883d2a8c37c650b3602a0aeed05b0c4fffc5f1"
 dependencies = [
  "blake2b_simd",
  "byteorder",
@@ -2759,20 +2864,20 @@ dependencies = [
 
 [[package]]
 name = "sp-debug-derive"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "50535e1a5708d3ba5c1195b59ebefac61cc8679c2c24716b87a86e8b7ed2e4a1"
+checksum = "90fd2c660c3e940df93f4920b183cc103443d66503f68189fa7e4b3f09996a18"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
 name = "sp-externalities"
-version = "0.23.0"
+version = "0.24.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "884d05160bc89d0943d1c9fb8006c3d44b80f37f8af607aeff8d4d9cc82e279a"
+checksum = "ac0a1df458d0bba69bc011a3b0197049396272e497b207ad161289e7518b74bf"
 dependencies = [
  "environmental",
  "parity-scale-codec",
@@ -2782,9 +2887,9 @@ dependencies = [
 
 [[package]]
 name = "sp-io"
-version = "27.0.0"
+version = "29.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0ced350da15e8ba3a106206840acc42a6d3eb0d7e8bf7aa43ab00eac0bdf956f"
+checksum = "6c600c911757504c43f8c354edd1b0d327a1c2abfe947e490a6b62d8f1543d96"
 dependencies = [
  "bytes",
  "ed25519-dalek",
@@ -2807,9 +2912,9 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.31.0"
+version = "0.33.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8b8ec5ebbba70bee83d79c3fe5e49f12df0a4bb6029858ddf9a15eea7539a592"
+checksum = "b955546b815ace30f63542efda71ce4e010444596cd8316f7ef49a26fb971709"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
@@ -2831,10 +2936,11 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "28.0.0"
+version = "30.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6d9c40ff7303e62219b55635e5245d963358cb77d6916250991ebcb82c0be2c6"
+checksum = "ee4bb0ddcc4e26cc6c770b49149e1a07ad6b34ab22d3da94330994b7145a025f"
 dependencies = [
+ "docify",
  "either",
  "hash256-std-hasher",
  "impl-trait-for-tuples",
@@ -2844,6 +2950,7 @@ dependencies = [
  "rand 0.8.5",
  "scale-info",
  "serde",
+ "simple-mermaid",
  "sp-application-crypto",
  "sp-arithmetic",
  "sp-core",
@@ -2854,9 +2961,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface"
-version = "21.0.0"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4f365332922a8cfa98ab00c6d08b1b0f24e159e730dd554e720d950ff3371b1f"
+checksum = "d0093f419cb2ef80c8ecb583ac54e05d1105710eb84add7f9483c8ea882cbaff"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
@@ -2873,22 +2980,23 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "15.0.0"
+version = "16.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9b2afcbd1bd18d323371111b66b7ac2870bdc1c86c3d7b0dae67b112ca52b4d8"
+checksum = "5ebdb4aff8286f5095871b2f950037d690edb0fed0590af5f6735352533a53b6"
 dependencies = [
  "Inflector",
- "proc-macro-crate 1.3.1",
+ "expander",
+ "proc-macro-crate 2.0.1",
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
 name = "sp-state-machine"
-version = "0.32.0"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96e087fa4430befd2047b61d912c9d6fa4eaed408c4b58b46c6e9acd7965f2d3"
+checksum = "0f5027dceaa62f3c18f40593ee6a898df69c70e84e01450a17293511c4f3c46c"
 dependencies = [
  "hash-db",
  "log",
@@ -2908,15 +3016,15 @@ dependencies = [
 
 [[package]]
 name = "sp-std"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "54c78c5a66682568cc7b153603c5d01a2cc8f5c221c7b1e921517a0eef18ae05"
+checksum = "71323a3b5f189085d11123ce397b3cdfaec4437071243b51f68a38a4833fbaa7"
 
 [[package]]
 name = "sp-storage"
-version = "17.0.0"
+version = "18.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "016f20812cc51bd479cc88d048c35d44cd3adde4accdb159d49d6050f2953595"
+checksum = "d5300c9012180259489a97167f4c45cf3362446e5f0d0c66b6e9342968be8f22"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
@@ -2928,9 +3036,9 @@ dependencies = [
 
 [[package]]
 name = "sp-tracing"
-version = "14.0.0"
+version = "15.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0d727cb5265641ffbb7d4e42c18b63e29f6cfdbd240aae3bcf093c3d6eb29a19"
+checksum = "16b63d14c3214b8b5fe35b67bd61124b5f080cc9d1312b227e0c6cc2a198461e"
 dependencies = [
  "parity-scale-codec",
  "sp-std",
@@ -2941,9 +3049,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "26.0.0"
+version = "28.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e359b358263cc322c3f678c272a3a519621d9853dcfa1374dfcbdb5f54c6f85"
+checksum = "5cbc3ad723c9addc4b7aafbe8bfabf638c39be3c911e11f58e924e17554003ac"
 dependencies = [
  "ahash 0.8.3",
  "hash-db",
@@ -2957,6 +3065,7 @@ dependencies = [
  "scale-info",
  "schnellru",
  "sp-core",
+ "sp-externalities",
  "sp-std",
  "thiserror",
  "tracing",
@@ -2966,9 +3075,9 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "18.0.0"
+version = "19.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d5d85813d46a22484cdf5e5afddbbe85442dd1b4d84d67a8c7792f92f9f93607"
+checksum = "c4ef2e859d3cde7294c3bf691f8f64244a6a9bb67e53c65729b129318757070e"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
@@ -2980,16 +3089,16 @@ dependencies = [
 
 [[package]]
 name = "sp-weights"
-version = "24.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "751676c1263e7f3600af16bad26a7978a816bc532676fe05eafa23b862c05b9e"
+checksum = "8813a9942a3b900d5ce109875b91ff8ae7eb5849545ebb6464c22aa21e42622e"
 dependencies = [
+ "bounded-collections",
  "parity-scale-codec",
  "scale-info",
  "serde",
  "smallvec",
  "sp-arithmetic",
- "sp-core",
  "sp-debug-derive",
  "sp-std",
 ]
@@ -3044,7 +3153,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "49eee6965196b32f882dd2ee85a92b1dbead41b04e53907f269de3b0dc04733c"
 dependencies = [
  "hmac 0.11.0",
- "pbkdf2 0.8.0",
+ "pbkdf2",
  "schnorrkel",
  "sha2 0.9.9",
  "zeroize",
@@ -3084,9 +3193,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.38"
+version = "2.0.48"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e96b79aaa137db8f61e26363a0c9b47d8b4ec75da28b7d1d614c2303e232408b"
+checksum = "0f3531638e407dfc0814761abb7c00a5b54992b849452a0646b7f65c9f770f3f"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3165,6 +3274,15 @@ dependencies = [
  "time",
 ]
 
+[[package]]
+name = "termcolor"
+version = "1.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ff1bc3d3f05aff0403e8ac0d92ced918ec05b666a43f83297ccef5bea8a3d449"
+dependencies = [
+ "winapi-util",
+]
+
 [[package]]
 name = "thiserror"
 version = "1.0.49"
@@ -3182,7 +3300,7 @@ checksum = "10712f02019e9288794769fba95cd6847df9874d49d871d062172f9dd41bc4cc"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -3221,25 +3339,6 @@ dependencies = [
  "time-core",
 ]
 
-[[package]]
-name = "tiny-bip39"
-version = "1.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "62cc94d358b5a1e84a5cb9109f559aa3c4d634d2b1b4de3d0fa4adc7c78e2861"
-dependencies = [
- "anyhow",
- "hmac 0.12.1",
- "once_cell",
- "pbkdf2 0.11.0",
- "rand 0.8.5",
- "rustc-hash",
- "sha2 0.10.8",
- "thiserror",
- "unicode-normalization",
- "wasm-bindgen",
- "zeroize",
-]
-
 [[package]]
 name = "tinyvec"
 version = "1.6.0"
@@ -3264,11 +3363,26 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "toml"
+version = "0.8.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "185d8ab0dfbb35cf1399a6344d8484209c088f75f8f68230da55d48d95d43e3d"
+dependencies = [
+ "serde",
+ "serde_spanned",
+ "toml_datetime",
+ "toml_edit 0.20.2",
+]
+
 [[package]]
 name = "toml_datetime"
 version = "0.6.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
+dependencies = [
+ "serde",
+]
 
 [[package]]
 name = "toml_edit"
@@ -3281,6 +3395,19 @@ dependencies = [
  "winnow",
 ]
 
+[[package]]
+name = "toml_edit"
+version = "0.20.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
+dependencies = [
+ "indexmap 2.0.2",
+ "serde",
+ "serde_spanned",
+ "toml_datetime",
+ "winnow",
+]
+
 [[package]]
 name = "tracing"
 version = "0.1.40"
@@ -3300,7 +3427,7 @@ checksum = "34704c8d6ebcbc939824180af020566b01a7c01f80641264eba0999f6c2b6be7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -3482,6 +3609,16 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "walkdir"
+version = "2.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d71d857dc86794ca4c280d616f7da00d2dbfd8cd788846559a6813e6aa4b54ee"
+dependencies = [
+ "same-file",
+ "winapi-util",
+]
+
 [[package]]
 name = "wasi"
 version = "0.9.0+wasi-snapshot-preview1"
@@ -3515,7 +3652,7 @@ dependencies = [
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
  "wasm-bindgen-shared",
 ]
 
@@ -3537,7 +3674,7 @@ checksum = "54681b18a46765f095758388f2d0cf16eb8d4169b639ab575a8f5693af210c7b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
@@ -3706,6 +3843,15 @@ version = "0.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
 
+[[package]]
+name = "winapi-util"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f29e6f9198ba0d26b4c9f07dbe6f9ed633e1f3d5b8b414090084349e46a52596"
+dependencies = [
+ "winapi",
+]
+
 [[package]]
 name = "winapi-x86_64-pc-windows-gnu"
 version = "0.4.0"
@@ -3888,5 +4034,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.38",
+ "syn 2.0.48",
 ]
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index d62e2a3a8..481d50bd5 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,7 +6,7 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.39.1", default-features = false, features = [
+ibc-proto = { version = "0.41.0", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
@@ -15,10 +15,10 @@ tendermint = { version = "0.34", default-features = false }
 tendermint-proto = { version = "0.34", default-features = false }
 tendermint-light-client-verifier = { version = "0.34", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "25.0.0", default-features = false, optional = true }
-sp-io = { version = "27.0.0", default-features = false, optional = true }
-sp-runtime = { version = "28.0.0", default-features = false, optional = true }
-sp-std = { version = "12.0.0", default-features = false, optional = true }
+sp-core = { version = "27.0.0", default-features = false, optional = true }
+sp-io = { version = "29.0.0", default-features = false, optional = true }
+sp-runtime = { version = "30.0.1", default-features = false, optional = true }
+sp-std = { version = "13.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index 149e4a55c..2c3592ebc 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -25,7 +25,7 @@ displaydoc  = { workspace = true }
 prost       = { version = "0.12", default-features = false }
 schemars    = { workspace = true, optional = true }
 serde       = { workspace = true, optional = true }
-time        = { version = ">=0.3.0, <0.3.31", default-features = false }
+time        = { version = ">=0.3.0, <0.3.32", default-features = false }
 
 # ibc dependencies
 ibc-proto = { workspace = true }

From fcc8c576f2998ce9108c228b4e9f5680d2bef932 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 11 Jan 2024 18:17:49 -0800
Subject: [PATCH 090/182] fix: refactor `ibc-derive` to handle context with
 generic types and projects dependent on `ibc-core` (#1037)

* fix: refactor ibc-derive to support broader cases

* fix: cargo doc

* imp: define get_impl_quote

* imp: move each set of derives to the related meta-crate

* imp: refactor ClientState drive to work with generics with trait-bounds

* fix: remove redundant derive feature

* docs: improve derive docstrings

* imp: define SupportedCrate enum
---
 ...-derive-to-handle-context-with-generics.md |   2 +
 .../999-make-ibc-derive-work-with-ibc-core.md |   2 +
 .../adr-007-light-client-contexts.md          |   6 +-
 ibc-core/Cargo.toml                           |   1 +
 ibc-core/ics02-client/context/Cargo.toml      |   1 -
 .../ics02-client/context/src/client_state.rs  |  11 -
 .../context/src/consensus_state.rs            |   3 -
 ibc-core/src/lib.rs                           |  24 +++
 ibc-derive/Cargo.toml                         |   1 -
 ibc-derive/src/client_state.rs                | 190 +++++++++++++-----
 .../traits/client_state_common.rs             |  29 ++-
 .../traits/client_state_execution.rs          |  35 +++-
 .../traits/client_state_validation.rs         |  34 +++-
 ibc-derive/src/consensus_state.rs             |  30 ++-
 ibc-derive/src/lib.rs                         |  38 +++-
 ibc-derive/src/utils.rs                       | 111 ++++++----
 ibc-testkit/src/testapp/ibc/clients/mod.rs    |  12 +-
 ibc/src/lib.rs                                |  30 +++
 18 files changed, 404 insertions(+), 156 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
 create mode 100644 .changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md

diff --git a/.changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md b/.changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
new file mode 100644
index 000000000..90abb1fe1
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
@@ -0,0 +1,2 @@
+- [ibc-derive] Refactor `ClientState` macro derivation to handle contexts with
+  generic types. ([\#910](https://github.com/cosmos/ibc-rs/issues/910))
diff --git a/.changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md b/.changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
new file mode 100644
index 000000000..587f8b3da
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
@@ -0,0 +1,2 @@
+- [ibc-derive] Adapt macro derivations to integrate with projects dependent on
+  `ibc-core` ([\#999](https://github.com/cosmos/ibc-rs/issues/999)).
diff --git a/docs/architecture/adr-007-light-client-contexts.md b/docs/architecture/adr-007-light-client-contexts.md
index feb9b0e3c..834a74bfb 100644
--- a/docs/architecture/adr-007-light-client-contexts.md
+++ b/docs/architecture/adr-007-light-client-contexts.md
@@ -193,10 +193,8 @@ enum AnyConsensusState {
 }
 
 #[derive(ClientState)]
-#[generics(
-    ClientValidationContext = MyClientValidationContext,
-    ClientExecutionContext  = MyClientExecutionContext
-)]
+#[validation(MyClientValidationContext)]
+#[execution(MyClientExecutionContext)]
 enum AnyClientState {
     Tendermint(TmClientState),
     Near(NearClientState),
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
index 896c16987..f19a89432 100644
--- a/ibc-core/Cargo.toml
+++ b/ibc-core/Cargo.toml
@@ -24,6 +24,7 @@ ibc-core-commitment-types = { workspace = true }
 ibc-core-host             = { workspace = true }
 ibc-core-router           = { workspace = true }
 ibc-core-handler          = { workspace = true }
+ibc-derive                = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index 789b53ad8..d93aebbaa 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -28,7 +28,6 @@ ibc-core-client-types     = { workspace = true }
 ibc-core-commitment-types = { workspace = true }
 ibc-core-host-types       = { workspace = true }
 ibc-core-handler-types    = { workspace = true }
-ibc-derive                = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 # cosmos dependencies
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index e671c0319..ccdfedee9 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -181,17 +181,6 @@ where
     ) -> Result<Height, ClientError>;
 }
 
-/// Derive macro that implements [`ClientState`] for enums containing variants
-/// that implement [`ClientState`].
-///
-/// The macro expects the attribute `#[generics(ClientValidationContext = <...>,
-/// ClientExecutionContext = <...>)]` which specifies [`ClientState`]'s generic
-/// arguments to be defined.
-///
-/// The macro does not support generic types for `ClientValidationContext` and
-/// `ClientExecutionContext` (e.g. `MyType<T>` would not be supported).
-pub use ibc_derive::ClientState;
-
 use crate::context::{ClientExecutionContext, ClientValidationContext};
 
 /// Primary client trait. Defines all the methods that clients must implement.
diff --git a/ibc-core/ics02-client/context/src/consensus_state.rs b/ibc-core/ics02-client/context/src/consensus_state.rs
index 8331428a5..378eab512 100644
--- a/ibc-core/ics02-client/context/src/consensus_state.rs
+++ b/ibc-core/ics02-client/context/src/consensus_state.rs
@@ -3,9 +3,6 @@
 use core::marker::{Send, Sync};
 
 use ibc_core_commitment_types::commitment::CommitmentRoot;
-/// Derive macro that implements [`ConsensusState`] for enums containing
-/// variants that implement [`ConsensusState`]
-pub use ibc_derive::ConsensusState;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
 
diff --git a/ibc-core/src/lib.rs b/ibc-core/src/lib.rs
index 444129f02..da0deda7a 100644
--- a/ibc-core/src/lib.rs
+++ b/ibc-core/src/lib.rs
@@ -65,3 +65,27 @@ pub mod router {
     #[doc(inline)]
     pub use ibc_core_router::*;
 }
+
+/// Re-exports convenient derive macros from `ibc-derive` crate.
+pub mod derive {
+    /// To specify the generic arguments for `ClientState`, use the following
+    /// attributes:
+    ///
+    /// - `#[validation(<YourClientValidationContext>)]`
+    /// - `#[execution(<YourClientExecutionContext>)]`
+    ///
+    /// The argument to the `validation` or `execution` attributes may contain
+    /// lifetimes or generic types and even that types might be bounded by
+    /// traits. For instance:
+    ///
+    /// - `#[validation(Context<S>)]`
+    /// - `#[validation(Context<'a, S>)]`
+    /// - `#[validation(Context<'a, S: Clone>)]`
+    pub use ibc_derive::IbcCoreClientState as ClientState;
+    /// A derive macro for implementing the
+    /// [`ConsensusState`](crate::client::context::consensus_state::ConsensusState) trait for
+    /// enums. Enums with variants that also implement the
+    /// [`ConsensusState`](crate::client::context::consensus_state::ConsensusState) trait can
+    /// leverage this macro for automatic implementation.
+    pub use ibc_derive::IbcCoreConsensusState as ConsensusState;
+}
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index abc082834..0b9764de6 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -14,4 +14,3 @@ proc-macro = true
 syn = "2"
 proc-macro2 = "1"
 quote = "1"
-darling = "0.20"
diff --git a/ibc-derive/src/client_state.rs b/ibc-derive/src/client_state.rs
index 46917ce2e..b33862fb2 100644
--- a/ibc-derive/src/client_state.rs
+++ b/ibc-derive/src/client_state.rs
@@ -1,29 +1,155 @@
 mod traits;
 
-use darling::FromDeriveInput;
 use proc_macro2::TokenStream;
-use quote::quote;
-use syn::DeriveInput;
+use quote::{quote, ToTokens};
+use syn::{DeriveInput, Error, GenericArgument, Ident, WherePredicate};
 use traits::client_state_common::impl_ClientStateCommon;
 use traits::client_state_execution::impl_ClientStateExecution;
 use traits::client_state_validation::impl_ClientStateValidation;
 
-#[derive(FromDeriveInput)]
-#[darling(attributes(generics))]
+use crate::utils::Imports;
+
+const MISSING_ATTR: &str = "must be annotated with #[validation(<your ClientValidationContext>) and #[execution(<your ClientExecutionContext>)]";
+const MISSING_VALIDATION_ATTR: &str = "missing #[validation(<your ClientValidationContext>)]";
+const MISSING_EXECUTION_ATTR: &str = "missing #[execution(<your ClientExecutionContext>)]";
+const INVALID_ATTR: &str = "invalid attribute annotation";
+const INVALID_ARGS: &str = "invalid context argument";
+
+#[derive(Clone)]
+pub(crate) struct ClientCtx {
+    ident: Ident,
+    generics: Vec<GenericArgument>,
+    predicates: Vec<WherePredicate>,
+}
+
+impl ClientCtx {
+    fn new(ident: Ident, generics: Vec<GenericArgument>, predicates: Vec<WherePredicate>) -> Self {
+        ClientCtx {
+            ident,
+            generics,
+            predicates,
+        }
+    }
+
+    /// Returns the `impl` quote block for the given context type, used for
+    /// implementing ClientValidation/ExecutionContext on the given enum.
+    fn impl_ts(&self) -> TokenStream {
+        let gens = self.generics.clone();
+
+        quote! { impl<#(#gens),*> }
+    }
+
+    /// Returns the `where` clause quote block for the given context type, used
+    /// for implementing ClientValidation/ExecutionContext on the given enum.
+    fn where_clause_ts(&self) -> TokenStream {
+        let predicates = self.predicates.clone();
+
+        quote! { where #(#predicates),* }
+    }
+}
+
+impl ToTokens for ClientCtx {
+    fn to_tokens(&self, tokens: &mut TokenStream) {
+        let ident = &self.ident;
+
+        let generics = self.generics.iter().map(|g| g.to_token_stream());
+
+        tokens.extend(quote! { #ident<#(#generics),*> });
+    }
+}
+
 pub(crate) struct Opts {
-    #[darling(rename = "ClientValidationContext")]
-    client_validation_context: syn::ExprPath,
-    #[darling(rename = "ClientExecutionContext")]
-    client_execution_context: syn::ExprPath,
+    client_validation_context: ClientCtx,
+    client_execution_context: ClientCtx,
+}
+
+impl Opts {
+    /// Returns the `Opts` struct from the given `DeriveInput` AST.
+    fn from_derive_input(ast: &DeriveInput) -> Result<Self, Error> {
+        let mut client_validation_context = None;
+        let mut client_execution_context = None;
+
+        if ast.attrs.is_empty() {
+            return Err(Error::new_spanned(ast, MISSING_ATTR));
+        }
+
+        for attr in ast.attrs.iter() {
+            if let syn::Meta::List(ref meta_list) = attr.meta {
+                let path: syn::Path = syn::parse2(meta_list.tokens.clone())?;
+
+                let path_segment = match path.segments.last() {
+                    Some(segment) => segment.clone(),
+                    None => return Err(Error::new_spanned(&meta_list.path, INVALID_ARGS)),
+                };
+
+                let meta_ident = match meta_list.path.require_ident() {
+                    Ok(ident) => ident.to_string(),
+                    Err(e) => return Err(Error::new_spanned(attr, e)),
+                };
+
+                let (gens, ps) = split_for_impl(path_segment.arguments)?;
+
+                let ctx = ClientCtx::new(path_segment.ident.clone(), gens, ps);
+
+                match meta_ident.as_str() {
+                    "validation" => client_validation_context = Some(ctx),
+                    "execution" => client_execution_context = Some(ctx),
+                    _ => return Err(Error::new_spanned(&meta_list.path, INVALID_ATTR)),
+                };
+            }
+        }
+
+        let client_validation_context = client_validation_context
+            .ok_or_else(|| Error::new_spanned(ast, MISSING_VALIDATION_ATTR))?;
+        let client_execution_context = client_execution_context
+            .ok_or_else(|| Error::new_spanned(ast, MISSING_EXECUTION_ATTR))?;
+
+        Ok(Opts {
+            client_validation_context,
+            client_execution_context,
+        })
+    }
+}
+
+fn split_for_impl(
+    args: syn::PathArguments,
+) -> Result<(Vec<GenericArgument>, Vec<WherePredicate>), Error> {
+    let mut generics = vec![];
+    let mut predicates = vec![];
+
+    if let syn::PathArguments::AngleBracketed(ref gen) = args {
+        for arg in gen.args.clone() {
+            match arg.clone() {
+                syn::GenericArgument::Type(_) => {
+                    generics.push(arg);
+                }
+                syn::GenericArgument::Lifetime(_) => {
+                    generics.push(arg);
+                }
+                syn::GenericArgument::Constraint(c) => {
+                    let ident = c.ident.into_token_stream();
+
+                    let gen = syn::parse2(ident.into_token_stream())?;
+
+                    generics.push(gen);
+
+                    let gen_type_param: syn::TypeParam =
+                        syn::parse2(arg.clone().into_token_stream())?;
+
+                    predicates.push(syn::parse2(gen_type_param.into_token_stream())?);
+                }
+                _ => return Err(Error::new_spanned(arg, INVALID_ARGS)),
+            };
+        }
+    }
+
+    Ok((generics, predicates))
 }
 
-pub fn client_state_derive_impl(ast: DeriveInput) -> TokenStream {
+pub fn client_state_derive_impl(ast: DeriveInput, imports: &Imports) -> TokenStream {
     let opts = match Opts::from_derive_input(&ast) {
         Ok(opts) => opts,
-        Err(e) => panic!(
-            "{} must be annotated with #[generics(ClientValidationContext = <your ClientValidationContext>, ClientExecutionContext: <your ClientExecutionContext>)]: {e}",
-            ast.ident
-        ),
+        Err(e) => panic!("{e}"),
     };
 
     let enum_name = &ast.ident;
@@ -32,45 +158,15 @@ pub fn client_state_derive_impl(ast: DeriveInput) -> TokenStream {
         _ => panic!("ClientState only supports enums"),
     };
 
-    let ClientStateCommon_impl_block = impl_ClientStateCommon(enum_name, enum_variants);
+    let ClientStateCommon_impl_block = impl_ClientStateCommon(enum_name, enum_variants, imports);
     let ClientStateValidation_impl_block =
-        impl_ClientStateValidation(enum_name, enum_variants, &opts);
+        impl_ClientStateValidation(enum_name, enum_variants, &opts, imports);
     let ClientStateExecution_impl_block =
-        impl_ClientStateExecution(enum_name, enum_variants, &opts);
-
-    let maybe_extern_crate_stmt = if is_mock(&ast) {
-        // Note: we must add this statement when in "mock mode"
-        // (i.e. in ibc-rs itself) because we don't have `ibc` as a dependency,
-        // so we need to define the `ibc` symbol to mean "the `self` crate".
-        quote! {extern crate self as ibc;}
-    } else {
-        quote! {}
-    };
+        impl_ClientStateExecution(enum_name, enum_variants, &opts, imports);
 
     quote! {
-        #maybe_extern_crate_stmt
-
         #ClientStateCommon_impl_block
         #ClientStateValidation_impl_block
         #ClientStateExecution_impl_block
     }
 }
-
-/// We are in "mock mode" (i.e. within ibc-rs crate itself) if the user added
-/// a #[mock] attribute
-fn is_mock(ast: &DeriveInput) -> bool {
-    for attr in &ast.attrs {
-        let path = match attr.meta {
-            syn::Meta::Path(ref path) => path,
-            _ => continue,
-        };
-
-        for path_segment in path.segments.iter() {
-            if path_segment.ident == "mock" {
-                return true;
-            }
-        }
-    }
-
-    false
-}
diff --git a/ibc-derive/src/client_state/traits/client_state_common.rs b/ibc-derive/src/client_state/traits/client_state_common.rs
index 8176743e3..42a144b2e 100644
--- a/ibc-derive/src/client_state/traits/client_state_common.rs
+++ b/ibc-derive/src/client_state/traits/client_state_common.rs
@@ -9,54 +9,62 @@ use crate::utils::{get_enum_variant_type_path, Imports};
 pub(crate) fn impl_ClientStateCommon(
     client_state_enum_name: &Ident,
     enum_variants: &Punctuated<Variant, Comma>,
+    imports: &Imports,
 ) -> TokenStream {
     let verify_consensus_state_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! { verify_consensus_state(cs, consensus_state) },
+        imports,
     );
     let client_type_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {client_type(cs)},
+        imports,
     );
     let latest_height_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {latest_height(cs)},
+        imports,
     );
     let validate_proof_height_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {validate_proof_height(cs, proof_height)},
+        imports,
     );
     let verify_upgrade_client_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {verify_upgrade_client(cs, upgraded_client_state, upgraded_consensus_state, proof_upgrade_client, proof_upgrade_consensus_state, root)},
+        imports,
     );
     let verify_membership_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {verify_membership(cs, prefix, proof, root, path, value)},
+        imports,
     );
     let verify_non_membership_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         quote! {verify_non_membership(cs, prefix, proof, root, path)},
+        imports,
     );
 
     let HostClientState = client_state_enum_name;
 
-    let Any = Imports::Any();
-    let CommitmentRoot = Imports::CommitmentRoot();
-    let CommitmentPrefix = Imports::CommitmentPrefix();
-    let CommitmentProofBytes = Imports::CommitmentProofBytes();
-    let ClientStateCommon = Imports::ClientStateCommon();
-    let ClientType = Imports::ClientType();
-    let ClientError = Imports::ClientError();
-    let Height = Imports::Height();
-    let Path = Imports::Path();
+    let Any = imports.any();
+    let CommitmentRoot = imports.commitment_root();
+    let CommitmentPrefix = imports.commitment_prefix();
+    let CommitmentProofBytes = imports.commitment_proof_bytes();
+    let ClientStateCommon = imports.client_state_common();
+    let ClientType = imports.client_type();
+    let ClientError = imports.client_error();
+    let Height = imports.height();
+    let Path = imports.path();
 
     quote! {
         impl #ClientStateCommon for #HostClientState {
@@ -156,8 +164,9 @@ fn delegate_call_in_match(
     enum_name: &Ident,
     enum_variants: Iter<'_, Variant>,
     fn_call: TokenStream,
+    imports: &Imports,
 ) -> Vec<TokenStream> {
-    let ClientStateCommon = Imports::ClientStateCommon();
+    let ClientStateCommon = imports.client_state_common();
 
     enum_variants
         .map(|variant| {
diff --git a/ibc-derive/src/client_state/traits/client_state_execution.rs b/ibc-derive/src/client_state/traits/client_state_execution.rs
index 1a92c8f79..8ec55471d 100644
--- a/ibc-derive/src/client_state/traits/client_state_execution.rs
+++ b/ibc-derive/src/client_state/traits/client_state_execution.rs
@@ -1,5 +1,5 @@
 use proc_macro2::{Ident, TokenStream};
-use quote::quote;
+use quote::{quote, ToTokens};
 use syn::punctuated::{Iter, Punctuated};
 use syn::token::Comma;
 use syn::Variant;
@@ -11,24 +11,28 @@ pub(crate) fn impl_ClientStateExecution(
     client_state_enum_name: &Ident,
     enum_variants: &Punctuated<Variant, Comma>,
     opts: &Opts,
+    imports: &Imports,
 ) -> TokenStream {
     let initialise_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
         quote! { initialise(cs, ctx, client_id, consensus_state) },
+        imports,
     );
     let update_state_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
         quote! { update_state(cs, ctx, client_id, header) },
+        imports,
     );
     let update_state_on_misbehaviour_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
         quote! { update_state_on_misbehaviour(cs, ctx, client_id, client_message, update_kind) },
+        imports,
     );
 
     let update_state_with_upgrade_client_impl = delegate_call_in_match(
@@ -36,20 +40,30 @@ pub(crate) fn impl_ClientStateExecution(
         enum_variants.iter(),
         opts,
         quote! { update_state_on_upgrade(cs, ctx, client_id, upgraded_client_state, upgraded_consensus_state) },
+        imports,
     );
 
+    // The imports we need for the generated code.
+    let Any = imports.any();
+    let ClientId = imports.client_id();
+    let ClientError = imports.client_error();
+    let ClientStateExecution = imports.client_state_execution();
+    let UpdateKind = imports.update_kind();
+    let Height = imports.height();
+
+    // The types we need for the generated code.
     let HostClientState = client_state_enum_name;
-    let ClientExecutionContext = &opts.client_execution_context;
+    let ClientExecutionContext = &opts.client_execution_context.clone().into_token_stream();
+
+    // The `impl` block quote based on whether the context includes generics.
+    let Impl = opts.client_execution_context.impl_ts();
 
-    let Any = Imports::Any();
-    let ClientId = Imports::ClientId();
-    let ClientError = Imports::ClientError();
-    let ClientStateExecution = Imports::ClientStateExecution();
-    let UpdateKind = Imports::UpdateKind();
-    let Height = Imports::Height();
+    // The `Where` clause quote based on whether the generics within the context
+    // include trait bounds
+    let Where = opts.client_execution_context.where_clause_ts();
 
     quote! {
-        impl #ClientStateExecution<#ClientExecutionContext> for #HostClientState {
+        #Impl #ClientStateExecution<#ClientExecutionContext> for #HostClientState #Where {
             fn initialise(
                 &self,
                 ctx: &mut #ClientExecutionContext,
@@ -105,8 +119,9 @@ fn delegate_call_in_match(
     enum_variants: Iter<'_, Variant>,
     opts: &Opts,
     fn_call: TokenStream,
+    imports: &Imports,
 ) -> Vec<TokenStream> {
-    let ClientStateExecution = Imports::ClientStateExecution();
+    let ClientStateExecution = imports.client_state_execution();
 
     enum_variants
         .map(|variant| {
diff --git a/ibc-derive/src/client_state/traits/client_state_validation.rs b/ibc-derive/src/client_state/traits/client_state_validation.rs
index a0c920bd3..47f0561e1 100644
--- a/ibc-derive/src/client_state/traits/client_state_validation.rs
+++ b/ibc-derive/src/client_state/traits/client_state_validation.rs
@@ -1,5 +1,5 @@
 use proc_macro2::{Ident, TokenStream};
-use quote::quote;
+use quote::{quote, ToTokens};
 use syn::punctuated::{Iter, Punctuated};
 use syn::token::Comma;
 use syn::Variant;
@@ -11,12 +11,14 @@ pub(crate) fn impl_ClientStateValidation(
     client_state_enum_name: &Ident,
     enum_variants: &Punctuated<Variant, Comma>,
     opts: &Opts,
+    imports: &Imports,
 ) -> TokenStream {
     let verify_client_message_impl = delegate_call_in_match(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
         quote! { verify_client_message(cs, ctx, client_id, client_message, update_kind) },
+        imports,
     );
 
     let check_for_misbehaviour_impl = delegate_call_in_match(
@@ -24,6 +26,7 @@ pub(crate) fn impl_ClientStateValidation(
         enum_variants.iter(),
         opts,
         quote! { check_for_misbehaviour(cs, ctx, client_id, client_message, update_kind) },
+        imports,
     );
 
     let status_impl = delegate_call_in_match(
@@ -31,20 +34,30 @@ pub(crate) fn impl_ClientStateValidation(
         enum_variants.iter(),
         opts,
         quote! { status(cs, ctx, client_id) },
+        imports,
     );
 
+    // The imports we need for the generated code.
+    let Any = imports.any();
+    let ClientId = imports.client_id();
+    let ClientError = imports.client_error();
+    let ClientStateValidation = imports.client_state_validation();
+    let Status = imports.status();
+    let UpdateKind = imports.update_kind();
+
+    // The types we need for the generated code.
     let HostClientState = client_state_enum_name;
-    let ClientValidationContext = &opts.client_validation_context;
+    let ClientValidationContext = opts.client_validation_context.clone().into_token_stream();
+
+    // The `impl` block quote based on whether the context includes generics.
+    let Impl = opts.client_validation_context.impl_ts();
 
-    let Any = Imports::Any();
-    let ClientId = Imports::ClientId();
-    let ClientError = Imports::ClientError();
-    let ClientStateValidation = Imports::ClientStateValidation();
-    let Status = Imports::Status();
-    let UpdateKind = Imports::UpdateKind();
+    // The `Where` clause quote based on whether the generics within the context
+    // include trait bounds
+    let Where = opts.client_validation_context.where_clause_ts();
 
     quote! {
-        impl #ClientStateValidation<#ClientValidationContext> for #HostClientState {
+        #Impl #ClientStateValidation<#ClientValidationContext> for #HostClientState #Where {
             fn verify_client_message(
                 &self,
                 ctx: &#ClientValidationContext,
@@ -89,8 +102,9 @@ fn delegate_call_in_match(
     enum_variants: Iter<'_, Variant>,
     opts: &Opts,
     fn_call: TokenStream,
+    imports: &Imports,
 ) -> Vec<TokenStream> {
-    let ClientStateValidation = Imports::ClientStateValidation();
+    let ClientStateValidation = imports.client_state_validation();
 
     enum_variants
         .map(|variant| {
diff --git a/ibc-derive/src/consensus_state.rs b/ibc-derive/src/consensus_state.rs
index 98b57f405..811f69fc6 100644
--- a/ibc-derive/src/consensus_state.rs
+++ b/ibc-derive/src/consensus_state.rs
@@ -5,22 +5,31 @@ use syn::{DeriveInput, Ident, Variant};
 
 use crate::utils::{get_enum_variant_type_path, Imports};
 
-pub fn consensus_state_derive_impl(ast: DeriveInput) -> TokenStream {
+pub fn consensus_state_derive_impl(ast: DeriveInput, imports: &Imports) -> TokenStream {
     let enum_name = &ast.ident;
     let enum_variants = match ast.data {
         syn::Data::Enum(ref enum_data) => &enum_data.variants,
         _ => panic!("ConsensusState only supports enums"),
     };
 
-    let root_impl = delegate_call_in_match(enum_name, enum_variants.iter(), quote! {root(cs)});
-    let timestamp_impl =
-        delegate_call_in_match(enum_name, enum_variants.iter(), quote! {timestamp(cs)});
-    let encode_vec_impl =
-        delegate_call_in_match(enum_name, enum_variants.iter(), quote! {encode_vec(cs)});
+    let root_impl =
+        delegate_call_in_match(enum_name, enum_variants.iter(), quote! {root(cs)}, imports);
+    let timestamp_impl = delegate_call_in_match(
+        enum_name,
+        enum_variants.iter(),
+        quote! {timestamp(cs)},
+        imports,
+    );
+    let encode_vec_impl = delegate_call_in_match(
+        enum_name,
+        enum_variants.iter(),
+        quote! {encode_vec(cs)},
+        imports,
+    );
 
-    let CommitmentRoot = Imports::CommitmentRoot();
-    let ConsensusState = Imports::ConsensusState();
-    let Timestamp = Imports::Timestamp();
+    let CommitmentRoot = imports.commitment_root();
+    let ConsensusState = imports.consensus_state();
+    let Timestamp = imports.timestamp();
 
     quote! {
         impl #ConsensusState for #enum_name {
@@ -49,8 +58,9 @@ fn delegate_call_in_match(
     enum_name: &Ident,
     enum_variants: Iter<'_, Variant>,
     fn_call: TokenStream,
+    imports: &Imports,
 ) -> Vec<TokenStream> {
-    let ConsensusState = Imports::ConsensusState();
+    let ConsensusState = imports.consensus_state();
 
     enum_variants
         .map(|variant| {
diff --git a/ibc-derive/src/lib.rs b/ibc-derive/src/lib.rs
index 9c165082c..381c7fdf3 100644
--- a/ibc-derive/src/lib.rs
+++ b/ibc-derive/src/lib.rs
@@ -16,21 +16,47 @@ use client_state::client_state_derive_impl;
 use consensus_state::consensus_state_derive_impl;
 use proc_macro::TokenStream as RawTokenStream;
 use syn::{parse_macro_input, DeriveInput};
+use utils::{Imports, SupportedCrate};
 
-#[proc_macro_derive(ClientState, attributes(generics, mock))]
-pub fn client_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+#[proc_macro_derive(IbcClientState, attributes(validation, execution))]
+pub fn ibc_client_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+    generate_client_state_derive(input, SupportedCrate::Ibc)
+}
+
+#[proc_macro_derive(IbcCoreClientState, attributes(validation, execution))]
+pub fn ibc_core_client_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+    generate_client_state_derive(input, SupportedCrate::IbcCore)
+}
+
+fn generate_client_state_derive(input: RawTokenStream, source: SupportedCrate) -> RawTokenStream {
     let ast: DeriveInput = parse_macro_input!(input);
 
-    let output = client_state_derive_impl(ast);
+    let imports = Imports::new(source);
+
+    let output = client_state_derive_impl(ast, &imports);
 
     RawTokenStream::from(output)
 }
 
-#[proc_macro_derive(ConsensusState)]
-pub fn consensus_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+#[proc_macro_derive(IbcConsensusState)]
+pub fn ibc_consensus_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+    generate_consensus_state_derive(input, SupportedCrate::Ibc)
+}
+
+#[proc_macro_derive(IbcCoreConsensusState)]
+pub fn ibc_core_consensus_state_macro_derive(input: RawTokenStream) -> RawTokenStream {
+    generate_consensus_state_derive(input, SupportedCrate::IbcCore)
+}
+
+fn generate_consensus_state_derive(
+    input: RawTokenStream,
+    source: SupportedCrate,
+) -> RawTokenStream {
     let ast: DeriveInput = parse_macro_input!(input);
 
-    let output = consensus_state_derive_impl(ast);
+    let imports = Imports::new(source);
+
+    let output = consensus_state_derive_impl(ast, &imports);
 
     RawTokenStream::from(output)
 }
diff --git a/ibc-derive/src/utils.rs b/ibc-derive/src/utils.rs
index a8fbfd1cb..b17c60ccc 100644
--- a/ibc-derive/src/utils.rs
+++ b/ibc-derive/src/utils.rs
@@ -2,75 +2,114 @@ use proc_macro2::TokenStream;
 use quote::quote;
 use syn::{Path, Variant};
 
+/// The IBC crates that we already support in the derive macro
+pub enum SupportedCrate {
+    Ibc,
+    IbcCore,
+}
+
 /// Encodes the ibc-rs types that will be used in the macro
 ///
-/// Note: we use `ibc` as our top-level crate, due to the
-/// `extern crate ibc as ibc;` statement we inject.
-pub struct Imports;
+/// Note: we use `ibc` or `ibc-core` as our top-level crate, due to the `extern
+/// crate ibc as ibc;` statement we inject.
+pub struct Imports {
+    prefix: TokenStream,
+}
+
+impl Imports {
+    pub fn new(crate_name: SupportedCrate) -> Self {
+        let prefix = match crate_name {
+            SupportedCrate::Ibc => quote! {::ibc::core},
+            SupportedCrate::IbcCore => quote! {::ibc_core},
+        };
+
+        Self { prefix }
+    }
+
+    pub fn prefix(&self) -> &TokenStream {
+        &self.prefix
+    }
+}
 
 impl Imports {
-    pub fn CommitmentRoot() -> TokenStream {
-        quote! {::ibc::core::commitment_types::commitment::CommitmentRoot}
+    pub fn commitment_root(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::commitment_types::commitment::CommitmentRoot}
     }
 
-    pub fn CommitmentPrefix() -> TokenStream {
-        quote! {::ibc::core::commitment_types::commitment::CommitmentPrefix}
+    pub fn commitment_prefix(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::commitment_types::commitment::CommitmentPrefix}
     }
 
-    pub fn CommitmentProofBytes() -> TokenStream {
-        quote! {::ibc::core::commitment_types::commitment::CommitmentProofBytes}
+    pub fn commitment_proof_bytes(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::commitment_types::commitment::CommitmentProofBytes}
     }
 
-    pub fn Path() -> TokenStream {
-        quote! {::ibc::core::host::types::path::Path}
+    pub fn path(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::host::types::path::Path}
     }
 
-    pub fn ConsensusState() -> TokenStream {
-        quote! {::ibc::core::client::context::consensus_state::ConsensusState}
+    pub fn consensus_state(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::client::context::consensus_state::ConsensusState}
     }
 
-    pub fn ClientStateCommon() -> TokenStream {
-        quote! {::ibc::core::client::context::client_state::ClientStateCommon}
+    pub fn client_state_common(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::client::context::client_state::ClientStateCommon}
     }
 
-    pub fn ClientStateValidation() -> TokenStream {
-        quote! {::ibc::core::client::context::client_state::ClientStateValidation}
+    pub fn client_state_validation(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::client::context::client_state::ClientStateValidation}
     }
 
-    pub fn ClientStateExecution() -> TokenStream {
-        quote! {::ibc::core::client::context::client_state::ClientStateExecution}
+    pub fn client_state_execution(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::client::context::client_state::ClientStateExecution}
     }
 
-    pub fn ClientId() -> TokenStream {
-        quote! {::ibc::core::host::types::identifiers::ClientId}
+    pub fn client_id(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::host::types::identifiers::ClientId}
     }
 
-    pub fn ClientType() -> TokenStream {
-        quote! {::ibc::core::host::types::identifiers::ClientType}
+    pub fn client_type(&self) -> TokenStream {
+        let Prefix = self.prefix();
+        quote! {#Prefix::host::types::identifiers::ClientType}
     }
 
-    pub fn ClientError() -> TokenStream {
-        quote! {::ibc::core::client::types::error::ClientError}
+    pub fn client_error(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::client::types::error::ClientError}
     }
 
-    pub fn Height() -> TokenStream {
-        quote! {::ibc::core::client::types::Height}
+    pub fn height(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::client::types::Height}
     }
 
-    pub fn Any() -> TokenStream {
-        quote! {::ibc::primitives::proto::Any}
+    pub fn any(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::primitives::proto::Any}
     }
 
-    pub fn Timestamp() -> TokenStream {
-        quote! {::ibc::core::primitives::Timestamp}
+    pub fn timestamp(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::primitives::Timestamp}
     }
 
-    pub fn UpdateKind() -> TokenStream {
-        quote! {::ibc::core::client::types::UpdateKind}
+    pub fn update_kind(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::client::types::UpdateKind}
     }
 
-    pub fn Status() -> TokenStream {
-        quote! {::ibc::core::client::types::Status}
+    pub fn status(&self) -> TokenStream {
+        let prefix = self.prefix();
+        quote! {#prefix::client::types::Status}
     }
 }
 
@@ -80,7 +119,7 @@ impl Imports {
 /// For example, given
 /// ```ignore
 ///
-/// #[derive(ClientState)]
+/// #[derive(IbcClientState)]
 /// enum HostClientState {
 ///     Tendermint(TmClientState),
 /// }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
index 639d66cf5..e5f7ad7be 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -6,10 +6,9 @@ use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusStat
 use ibc::clients::tendermint::types::{
     TENDERMINT_CLIENT_STATE_TYPE_URL, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
 };
-use ibc::core::client::context::client_state::ClientState as ClientStateTrait;
-use ibc::core::client::context::consensus_state::ConsensusState as ConsensusStateTrait;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::primitives::prelude::*;
+use ibc::derive::{ClientState, ConsensusState};
 use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::client_state::{
@@ -20,10 +19,9 @@ use crate::testapp::ibc::clients::mock::consensus_state::{
 };
 use crate::testapp::ibc::core::types::MockContext;
 
-#[derive(Debug, Clone, From, PartialEq, ClientStateTrait)]
-#[generics(ClientValidationContext = MockContext,
-           ClientExecutionContext = MockContext)
-]
+#[derive(Debug, Clone, From, PartialEq, ClientState)]
+#[validation(MockContext)]
+#[execution(MockContext)]
 pub enum AnyClientState {
     Tendermint(TmClientState),
     Mock(MockClientState),
@@ -56,7 +54,7 @@ impl From<AnyClientState> for Any {
     }
 }
 
-#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusStateTrait)]
+#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
 pub enum AnyConsensusState {
     Tendermint(TmConsensusState),
     Mock(MockConsensusState),
diff --git a/ibc/src/lib.rs b/ibc/src/lib.rs
index 02887a4e6..66b64d168 100644
--- a/ibc/src/lib.rs
+++ b/ibc/src/lib.rs
@@ -63,3 +63,33 @@ pub mod apps {
 pub mod cosmos_host {
     pub use ibc_core_host_cosmos::*;
 }
+
+/// Re-exports convenient derive macros from `ibc-derive` crate.
+pub mod derive {
+    /// A derive macro for implementing the
+    /// [`ClientState`](crate::core::client::context::client_state::ClientState)
+    /// trait for enums. Enums with variants that also implement the
+    /// [`ClientState`](crate::core::client::context::client_state::ClientState)
+    /// trait can leverage this macro for automatic implementation.
+    ///
+    /// To specify the generic arguments for `ClientState`, use the following
+    /// attributes:
+    ///
+    /// - `#[validation(<YourClientValidationContext>)]`
+    /// - `#[execution(<YourClientExecutionContext>)]`
+    ///
+    /// The argument to the `validation` or `execution` attributes may contain
+    /// lifetimes or generic types and even that types might be bounded by
+    /// traits. For instance:
+    ///
+    /// - `#[validation(Context<S>)]`
+    /// - `#[validation(Context<'a, S>)]`
+    /// - `#[validation(Context<'a, S: Clone>)]`
+    pub use ibc_derive::IbcClientState as ClientState;
+    /// A derive macro for implementing the
+    /// [`ConsensusState`](crate::core::client::context::consensus_state::ConsensusState)
+    /// trait for enums. Enums with variants that also implement the
+    /// [`ConsensusState`](crate::core::client::context::consensus_state::ConsensusState)
+    /// trait can leverage this macro for automatic implementation..
+    pub use ibc_derive::IbcConsensusState as ConsensusState;
+}

From d5e83145c177a2cd62135aebadaba5c9feb0fa2b Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 11 Jan 2024 18:47:48 -0800
Subject: [PATCH 091/182] feat: implement `08-wasm` client types (#1031)

* feat: implement 08-wasm client types

deps: bump ibc-proto rev

* fix: no_std compatibility

* imp: add all of the Wasm msg types

* chore: update Cargo.lock

* chore: use ibc-proto-rs rev which contains sovereign protos

* nit: correct ibc-proto-rs rev

* chore: apply review comments

* fix: use From instead of TryFrom where Error = Infallible

* add WASM_CLIENT_TYPE

* add tests for Base64

* add tests for ClientType

* add tests in wasm client type crate

* use bytes over strings

* nit: remove bytes

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../1030-implement-08-wasm-client-types.md    |   2 +
 Cargo.toml                                    |   2 +
 ci/cw-check/Cargo.lock                        | 156 +++---
 ci/no-std-check/Cargo.lock                    | 495 +++++++++++-------
 ibc-clients/Cargo.toml                        |   4 +
 ibc-clients/README.md                         |   4 +
 ibc-clients/ics08-wasm/types/Cargo.toml       |  53 ++
 .../ics08-wasm/types/src/client_message.rs    |  47 ++
 .../ics08-wasm/types/src/client_state.rs      | 121 +++++
 .../ics08-wasm/types/src/consensus_state.rs   |  97 ++++
 ibc-clients/ics08-wasm/types/src/error.rs     |  32 ++
 ibc-clients/ics08-wasm/types/src/lib.rs       |  49 ++
 .../types/src/msgs/migrate_contract.rs        |  74 +++
 ibc-clients/ics08-wasm/types/src/msgs/mod.rs  |   4 +
 .../types/src/msgs/remove_checksum.rs         |  55 ++
 .../ics08-wasm/types/src/msgs/store_code.rs   |  55 ++
 .../ics08-wasm/types/src/serializer.rs        |  46 ++
 ibc-clients/src/lib.rs                        |   6 +
 .../types/src/identifiers/client_type.rs      |  36 ++
 19 files changed, 1070 insertions(+), 268 deletions(-)
 create mode 100644 .changelog/unreleased/features/1030-implement-08-wasm-client-types.md
 create mode 100644 ibc-clients/ics08-wasm/types/Cargo.toml
 create mode 100644 ibc-clients/ics08-wasm/types/src/client_message.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/client_state.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/consensus_state.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/error.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/lib.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/msgs/migrate_contract.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/msgs/mod.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/msgs/remove_checksum.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/msgs/store_code.rs
 create mode 100644 ibc-clients/ics08-wasm/types/src/serializer.rs

diff --git a/.changelog/unreleased/features/1030-implement-08-wasm-client-types.md b/.changelog/unreleased/features/1030-implement-08-wasm-client-types.md
new file mode 100644
index 000000000..ed229a895
--- /dev/null
+++ b/.changelog/unreleased/features/1030-implement-08-wasm-client-types.md
@@ -0,0 +1,2 @@
+- [ibc-client-wasm-types] Implement ICS-08 Wasm light client domain types
+  ([\#1030](https://github.com/cosmos/ibc-rs/issues/1030)).
diff --git a/Cargo.toml b/Cargo.toml
index 9f3f31493..d32711f97 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -21,6 +21,7 @@ members = [
     "ibc-core",
     "ibc-clients/ics07-tendermint/types",
     "ibc-clients/ics07-tendermint",
+    "ibc-clients/ics08-wasm/types",
     "ibc-clients",
     "ibc-apps/ics20-transfer/types",
     "ibc-apps/ics20-transfer",
@@ -84,6 +85,7 @@ ibc-core-host-types         = { version = "0.49.1", path = "./ibc-core/ics24-hos
 ibc-core-handler-types      = { version = "0.49.1", path = "./ibc-core/ics25-handler/types", default-features = false }
 ibc-core-router-types       = { version = "0.49.1", path = "./ibc-core/ics26-routing/types", default-features = false }
 ibc-client-tendermint-types = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-client-wasm-types       = { version = "0.49.1", path = "./ibc-clients/ics08-wasm/types", default-features = false }
 ibc-app-transfer-types      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.41.0", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 3434bbb30..7933b4d6f 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -15,9 +15,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.76"
+version = "1.0.79"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "59d2a3357dde987206219e78ecfbbb6e8dad06cbb65292758d3270e6254f7355"
+checksum = "080e9890a082662b09c1ad45f567faeeb47f22b5fb23895fbe1e651e718e25ca"
 
 [[package]]
 name = "arrayvec"
@@ -45,9 +45,9 @@ checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
 
 [[package]]
 name = "base64"
-version = "0.21.5"
+version = "0.21.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "35636a1494ede3b646cc98f74f8e62c773a38a659ebc777a2cf26b9b74171df9"
+checksum = "c79fed4cdb43e993fcdadc7e58a09fd0e3e649c4436fa11da71c9f1f3ee7feb9"
 
 [[package]]
 name = "base64ct"
@@ -120,9 +120,9 @@ checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
 
 [[package]]
 name = "cosmwasm-crypto"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d8bb3c77c3b7ce472056968c745eb501c440fbc07be5004eba02782c35bfbbe3"
+checksum = "ad24bc9dae9aac5dc124b4560e3f7678729d701f1bf3cb11140703d91f247d31"
 dependencies = [
  "digest 0.10.7",
  "ecdsa",
@@ -134,18 +134,18 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-derive"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fea73e9162e6efde00018d55ed0061e93a108b5d6ec4548b4f8ce3c706249687"
+checksum = "ca65635b768406eabdd28ba015cc3f2f863ca5a2677a7dc4c237b8ee1298efb3"
 dependencies = [
  "syn 1.0.109",
 ]
 
 [[package]]
 name = "cosmwasm-schema"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0df41ea55f2946b6b43579659eec048cc2f66e8c8e2e3652fc5e5e476f673856"
+checksum = "77e2a6ce6dbcad572495fd9d9c1072793fe682aebfcc09752c3b0de3fa1814d7"
 dependencies = [
  "cosmwasm-schema-derive",
  "schemars",
@@ -156,9 +156,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-schema-derive"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43609e92ce1b9368aa951b334dd354a2d0dd4d484931a5f83ae10e12a26c8ba9"
+checksum = "904408dc6d73fd1d535c764a55370803cccf6b9be5af7423c4db8967058673f0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -167,11 +167,11 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-std"
-version = "1.5.0"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "04d6864742e3a7662d024b51a94ea81c9af21db6faea2f9a6d2232bb97c6e53e"
+checksum = "1ed4564772e5d779235f2d7353e3d66e37793065c3a5155a2978256bf4c5b7d5"
 dependencies = [
- "base64 0.21.5",
+ "base64 0.21.6",
  "bech32",
  "bnum",
  "cosmwasm-crypto",
@@ -189,9 +189,9 @@ dependencies = [
 
 [[package]]
 name = "cpufeatures"
-version = "0.2.11"
+version = "0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce420fe07aecd3e67c5f910618fe65e94158f6dcc0adf44e00d69ce2bdfe0fd0"
+checksum = "53fe5e26ff1b7aef8bca9c6080520cfb8d9333c7568e1829cef191a9723e5504"
 dependencies = [
  "libc",
 ]
@@ -270,7 +270,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "strsim",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -281,7 +281,7 @@ checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
 dependencies = [
  "darling_core",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -296,9 +296,9 @@ dependencies = [
 
 [[package]]
 name = "deranged"
-version = "0.3.10"
+version = "0.3.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8eb30d70a07a3b04884d2677f06bec33509dc67ca60d92949e5535352d3191dc"
+checksum = "b42b6fa04a440b495c8b04d0e71b707c585f83cb9cb28cf8cd0d976c315e31b4"
 dependencies = [
  "powerfmt",
 ]
@@ -354,7 +354,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -486,9 +486,9 @@ checksum = "c8cbd1169bd7b4a0a20d92b9af7a7e0422888bd38a6f5ec29c1fd8c1558a272e"
 
 [[package]]
 name = "futures"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "da0290714b38af9b4a7b094b8a37086d1b4e61f2df9122c3cad2577669145335"
+checksum = "645c6916888f6cb6350d2550b80fb63e734897a8498abe35cfb732b6487804b0"
 dependencies = [
  "futures-channel",
  "futures-core",
@@ -500,9 +500,9 @@ dependencies = [
 
 [[package]]
 name = "futures-channel"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff4dd66668b557604244583e3e1e1eada8c5c2e96a6d0d6653ede395b78bbacb"
+checksum = "eac8f7d7865dcb88bd4373ab671c8cf4508703796caa2b1985a9ca867b3fcb78"
 dependencies = [
  "futures-core",
  "futures-sink",
@@ -510,33 +510,33 @@ dependencies = [
 
 [[package]]
 name = "futures-core"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eb1d22c66e66d9d72e1758f0bd7d4fd0bee04cad842ee34587d68c07e45d088c"
+checksum = "dfc6580bb841c5a68e9ef15c77ccc837b40a7504914d52e47b8b0e9bbda25a1d"
 
 [[package]]
 name = "futures-io"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8bf34a163b5c4c52d0478a4d757da8fb65cabef42ba90515efee0f6f9fa45aaa"
+checksum = "a44623e20b9681a318efdd71c299b6b222ed6f231972bfe2f224ebad6311f0c1"
 
 [[package]]
 name = "futures-sink"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e36d3378ee38c2a36ad710c5d30c2911d752cb941c00c72dbabfb786a7970817"
+checksum = "9fb8e00e87438d937621c1c6269e53f536c14d3fbd6a042bb24879e57d474fb5"
 
 [[package]]
 name = "futures-task"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efd193069b0ddadc69c46389b740bbccdd97203899b48d09c5f7969591d6bae2"
+checksum = "38d84fa142264698cdce1a9f9172cf383a0c82de1bddcf3092901442c4097004"
 
 [[package]]
 name = "futures-util"
-version = "0.3.29"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a19526d624e703a3179b3d322efec918b6246ea0fa51d41124525f00f1cc8104"
+checksum = "3d6401deb83407ab3da39eba7e33987a73c3df0c82b4bb5813ee871c19c41d48"
 dependencies = [
  "futures-core",
  "futures-sink",
@@ -558,9 +558,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.11"
+version = "0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fe9006bed769170c11f845cf00c7c1e9092aeb3f268e007c3e760ac68008070f"
+checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
 dependencies = [
  "cfg-if",
  "libc",
@@ -883,7 +883,7 @@ dependencies = [
  "darling",
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -908,7 +908,7 @@ version = "0.41.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
 dependencies = [
- "base64 0.21.5",
+ "base64 0.21.6",
  "bytes",
  "flex-error",
  "ics23",
@@ -997,7 +997,7 @@ version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
 dependencies = [
- "base64 0.21.5",
+ "base64 0.21.6",
  "serde",
 ]
 
@@ -1018,9 +1018,9 @@ checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
 
 [[package]]
 name = "k256"
-version = "0.13.2"
+version = "0.13.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f01b677d82ef7a676aa37e099defd83a28e15687112cafdd112d60236b6115b"
+checksum = "956ff9b67e26e1a6a866cb758f12c6f8746208489e3e4a4b5580802f2f0a587b"
 dependencies = [
  "cfg-if",
  "ecdsa",
@@ -1041,15 +1041,15 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.151"
+version = "0.2.152"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "302d7ab3130588088d277783b1e2d2e10c9e9e4a16dd9050e6ec93fb3e7048f4"
+checksum = "13e3bf6590cbc649f4d1a3eefc9d5d6eb746f5200ffb04e5e142700b8faa56e7"
 
 [[package]]
 name = "memchr"
-version = "2.6.4"
+version = "2.7.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f665ee40bc4a3c5590afb1e9677db74a508659dfd71e126420da8274909a0167"
+checksum = "523dc4f511e55ab87b694dc30d0f820d60906ef06413f93d4d7a1385599cc149"
 
 [[package]]
 name = "num-derive"
@@ -1174,9 +1174,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.71"
+version = "1.0.76"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75cb1540fadbd5b8fbccc4dddad2734eba435053f725621c070711a14bb5f4b8"
+checksum = "95fc56cda0b5c3325f5fbbd7ff9fda9e02bb00bb3dac51252d2f1bfa1cb8cc8c"
 dependencies = [
  "unicode-ident",
 ]
@@ -1201,7 +1201,7 @@ dependencies = [
  "itertools",
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -1215,9 +1215,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.33"
+version = "1.0.35"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5267fca4496028628a95160fc423a33e8b2e6af8a5302579e322e4b520293cae"
+checksum = "291ec9ab5efd934aaf503a6466c5d5251535d108ee747472c3977cc5acc868ef"
 dependencies = [
  "proc-macro2",
 ]
@@ -1326,9 +1326,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.193"
+version = "1.0.195"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "25dd9975e68d0cb5aa1120c288333fc98731bd1dd12f561e468ea4728c042b89"
+checksum = "63261df402c67811e9ac6def069e4786148c4563f4b50fd4bf30aa370d626b02"
 dependencies = [
  "serde_derive",
 ]
@@ -1353,22 +1353,22 @@ dependencies = [
 
 [[package]]
 name = "serde_bytes"
-version = "0.11.12"
+version = "0.11.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab33ec92f677585af6d88c65593ae2375adde54efdbf16d597f2cbc7a6d368ff"
+checksum = "8b8497c313fd43ab992087548117643f6fcd935cbf36f176ffda0aacf9591734"
 dependencies = [
  "serde",
 ]
 
 [[package]]
 name = "serde_derive"
-version = "1.0.193"
+version = "1.0.195"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43576ca501357b9b071ac53cdc7da8ef0cbd9493d8df094cd821777ea6e894d3"
+checksum = "46fe8f8603d81ba86327b23a2e9cdf49e1255fb94a4c5f297f6ee0547178ea2c"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -1384,9 +1384,9 @@ dependencies = [
 
 [[package]]
 name = "serde_json"
-version = "1.0.108"
+version = "1.0.111"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d1c7e3eac408d115102c4c24ad393e0821bb3a5df4d506a80f85f7a742a526b"
+checksum = "176e46fa42316f18edd598015a5166857fc835ec732f5215eac6b7bdbf0a84f4"
 dependencies = [
  "itoa",
  "ryu",
@@ -1395,13 +1395,13 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.17"
+version = "0.1.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3081f5ffbb02284dda55132aa26daecedd7372a42417bbbab6f14ab7d6bb9145"
+checksum = "0b2e6b945e9d3df726b65d6ee24060aff8e3533d431f677a9695db04eff9dfdb"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
@@ -1498,9 +1498,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.42"
+version = "2.0.48"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5b7d0a2c048d661a1a59fcd7355baa232f7ed34e0ee4df2eef3c1c1c0d3852d8"
+checksum = "0f3531638e407dfc0814761abb7c00a5b54992b849452a0646b7f65c9f770f3f"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1554,29 +1554,29 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.51"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f11c217e1416d6f036b870f14e0413d480dbf28edbee1f877abaf0206af43bb7"
+checksum = "d54378c645627613241d077a3a79db965db602882668f9136ac42af9ecb730ad"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.51"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01742297787513b79cf8e29d1056ede1313e2420b7b3b15d0a768b4921f549df"
+checksum = "fa0faa943b50f3db30a20aa7e265dbc66076993efed8463e8de414e5d06d3471"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
 
 [[package]]
 name = "time"
-version = "0.3.30"
+version = "0.3.31"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4a34ab300f2dee6e562c10a046fc05e358b29f9bf92277f30c3c8d82275f6f5"
+checksum = "f657ba42c3f86e7680e53c8cd3af8abbe56b5491790b46e22e19c0d57463583e"
 dependencies = [
  "deranged",
  "powerfmt",
@@ -1593,9 +1593,9 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.15"
+version = "0.2.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4ad70d68dba9e1f8aceda7aa6711965dfec1cac869f311a51bd08b3a2ccbce20"
+checksum = "26197e33420244aeb70c3e8c78376ca46571bc4e701e4791c2cd9f57dcb3a43f"
 dependencies = [
  "time-core",
 ]
@@ -1666,9 +1666,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "winnow"
-version = "0.5.30"
+version = "0.5.33"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9b5c3db89721d50d0e2a673f5043fc4722f76dcc352d7b1ab8b8288bed4ed2c5"
+checksum = "b7520bbdec7211caa7c4e682eb1fbe07abe20cee6756b6e00f537c82c11816aa"
 dependencies = [
  "memchr",
 ]
@@ -1690,5 +1690,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.42",
+ "syn 2.0.48",
 ]
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 271b67e18..f41f4ff9c 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -27,7 +27,7 @@ version = "0.21.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8a30b2e23b9e17a9f90641c7ab1549cd9b44f296d3ccbf309d2863cfe398a0cb"
 dependencies = [
- "gimli 0.28.0",
+ "gimli 0.28.1",
 ]
 
 [[package]]
@@ -38,25 +38,26 @@ checksum = "f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe"
 
 [[package]]
 name = "ahash"
-version = "0.7.6"
+version = "0.7.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fcb51a0695d8f838b1ee009b3fbf66bda078cd64590202a864a8f3e8c4315c47"
+checksum = "5a824f2aa7e75a0c98c5a504fceb80649e9c35265d44525b5f94de4771a395cd"
 dependencies = [
- "getrandom 0.2.10",
+ "getrandom 0.2.12",
  "once_cell",
  "version_check",
 ]
 
 [[package]]
 name = "ahash"
-version = "0.8.3"
+version = "0.8.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2c99f64d1e06488f620f932677e24bc6e2897582980441ae90a671415bd7ec2f"
+checksum = "77c3a9648d43b9cd48db467b3f87fdd6e146bcc88ab0180006cef2179fe11d01"
 dependencies = [
  "cfg-if",
- "getrandom 0.2.10",
+ "getrandom 0.2.12",
  "once_cell",
  "version_check",
+ "zerocopy",
 ]
 
 [[package]]
@@ -94,9 +95,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.75"
+version = "1.0.79"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a4668cab20f66d8d020e1fbc0ebe47217433c1b6c8f2040faf858554e394ace6"
+checksum = "080e9890a082662b09c1ad45f567faeeb47f22b5fb23895fbe1e651e718e25ca"
 
 [[package]]
 name = "ark-bls12-377"
@@ -229,9 +230,9 @@ dependencies = [
 
 [[package]]
 name = "array-bytes"
-version = "6.1.0"
+version = "6.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d9b1c5a481ec30a5abd8dfbd94ab5cf1bb4e9a66be7f1b3b322f2f1170c200fd"
+checksum = "6f840fb7195bcfc5e17ea40c26e5ce6d5b9ce5d584466e17703209657e459ae0"
 
 [[package]]
 name = "arrayref"
@@ -268,7 +269,7 @@ dependencies = [
  "cfg-if",
  "libc",
  "miniz_oxide",
- "object 0.32.1",
+ "object 0.32.2",
  "rustc-demangle",
 ]
 
@@ -280,9 +281,9 @@ checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
 
 [[package]]
 name = "base64"
-version = "0.21.4"
+version = "0.21.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ba43ea6f343b788c8764558649e08df62f86c6ef251fdaeb1ffd010a9ae50a2"
+checksum = "c79fed4cdb43e993fcdadc7e58a09fd0e3e649c4436fa11da71c9f1f3ee7feb9"
 
 [[package]]
 name = "base64ct"
@@ -326,9 +327,9 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.4.0"
+version = "2.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4682ae6287fcf752ecaabbfcc7b6f9b72aa33933dc23a554d853aea8eea8635"
+checksum = "327762f6e5a765692301e5bb513e0d9fef63be86bbc14528052b1cd3e6f03e07"
 
 [[package]]
 name = "bitvec"
@@ -535,9 +536,9 @@ checksum = "2382f75942f4b3be3690fe4f86365e9c853c1587d6ee58212cebf6e2a9ccd101"
 
 [[package]]
 name = "const-oid"
-version = "0.9.5"
+version = "0.9.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "28c122c3980598d243d63d9a704629a2d748d101f278052ff068be5a4423ab6f"
+checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
 
 [[package]]
 name = "constant_time_eq"
@@ -553,9 +554,9 @@ checksum = "cd7e35aee659887cbfb97aaf227ac12cad1a9d7c71e55ff3376839ed4e282d08"
 
 [[package]]
 name = "core-foundation-sys"
-version = "0.8.4"
+version = "0.8.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e496a50fda8aacccc86d7529e2c1e0892dbd0f898a6b5645b5561b89c3210efa"
+checksum = "06ea2b9bc92be3c2baa9334a323ebca2d6f074ff852cd1d7b11064035cd3868f"
 
 [[package]]
 name = "cpp_demangle"
@@ -568,9 +569,9 @@ dependencies = [
 
 [[package]]
 name = "cpufeatures"
-version = "0.2.9"
+version = "0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a17b76ff3a4162b0b27f354a0c87015ddad39d35f9c0c36607a3bdd175dde1f1"
+checksum = "53fe5e26ff1b7aef8bca9c6080520cfb8d9333c7568e1829cef191a9723e5504"
 dependencies = [
  "libc",
 ]
@@ -674,9 +675,9 @@ dependencies = [
 
 [[package]]
 name = "curve25519-dalek-derive"
-version = "0.1.0"
+version = "0.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83fdaf97f4804dcebfa5862639bc9ce4121e82140bec2a987ac5140294865b5b"
+checksum = "f46882e17999c6cc590af592290432be3bce0428cb0d5f8b6715e4dc7b383eb3"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -743,9 +744,12 @@ dependencies = [
 
 [[package]]
 name = "deranged"
-version = "0.3.8"
+version = "0.3.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f2696e8a945f658fd14dc3b87242e6b80cd0f36ff04ea560fa39082368847946"
+checksum = "b42b6fa04a440b495c8b04d0e71b707c585f83cb9cb28cf8cd0d976c315e31b4"
+dependencies = [
+ "powerfmt",
+]
 
 [[package]]
 name = "derivative"
@@ -870,15 +874,15 @@ dependencies = [
 
 [[package]]
 name = "dyn-clone"
-version = "1.0.14"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23d2f3407d9a573d666de4b5bdf10569d73ca9478087346697dcbae6244bfbcd"
+checksum = "545b22097d44f8a9581187cdf93de7a71e4722bf51200cfaba810865b49a495d"
 
 [[package]]
 name = "ed25519"
-version = "2.2.2"
+version = "2.2.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "60f6d271ca33075c88028be6f04d502853d63a5ece419d269c15315d4fc1cf1d"
+checksum = "115531babc129696a58c64a4fef0a8bf9e9698629fb97e9e40767d235cfbcd53"
 dependencies = [
  "pkcs8",
  "signature",
@@ -899,14 +903,15 @@ dependencies = [
 
 [[package]]
 name = "ed25519-dalek"
-version = "2.0.0"
+version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7277392b266383ef8396db7fdeb1e77b6c52fed775f5df15bb24f35b72156980"
+checksum = "1f628eaec48bfd21b865dc2950cfa014450c01d2fa2b69a86c2fd5844ec523c0"
 dependencies = [
  "curve25519-dalek 4.1.1",
  "ed25519",
  "serde",
  "sha2 0.10.8",
+ "subtle",
  "zeroize",
 ]
 
@@ -944,12 +949,12 @@ checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
 [[package]]
 name = "errno"
-version = "0.3.5"
+version = "0.3.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac3e13f66a2f95e32a39eaa81f6b95d42878ca0e1db0c7543723dfe12557e860"
+checksum = "a258e46cdc063eb8519c00b9fc845fc47bcfca4130e2f08e88665ceda8474245"
 dependencies = [
  "libc",
- "windows-sys 0.48.0",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -979,9 +984,9 @@ checksum = "4443176a9f2c162692bd3d352d745ef9413eec5782a80d8fd6f8a1ac692a07f7"
 
 [[package]]
 name = "fiat-crypto"
-version = "0.2.1"
+version = "0.2.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0870c84016d4b481be5c9f323c24f65e31e901ae618f0e80f4308fb00de1d2d"
+checksum = "27573eac26f4dd11e2b1916c3fe1baa56407c83c71a773a8ba17ec0bca03b6b7"
 
 [[package]]
 name = "fixed-hash"
@@ -1012,9 +1017,9 @@ checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
 
 [[package]]
 name = "form_urlencoded"
-version = "1.2.0"
+version = "1.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a62bc1cf6f830c2ec14a513a9fb124d0a213a629668a4186f329db21fe045652"
+checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
 dependencies = [
  "percent-encoding",
 ]
@@ -1036,9 +1041,9 @@ checksum = "e6d5a32815ae3f33302d95fdcb2ce17862f8c65363dcfd29360480ba1001fc9c"
 
 [[package]]
 name = "futures"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23342abe12aba583913b2e62f22225ff9c950774065e4bfb61a19cd9770fec40"
+checksum = "645c6916888f6cb6350d2550b80fb63e734897a8498abe35cfb732b6487804b0"
 dependencies = [
  "futures-channel",
  "futures-core",
@@ -1051,9 +1056,9 @@ dependencies = [
 
 [[package]]
 name = "futures-channel"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "955518d47e09b25bbebc7a18df10b81f0c766eaf4c4f1cccef2fca5f2a4fb5f2"
+checksum = "eac8f7d7865dcb88bd4373ab671c8cf4508703796caa2b1985a9ca867b3fcb78"
 dependencies = [
  "futures-core",
  "futures-sink",
@@ -1061,15 +1066,15 @@ dependencies = [
 
 [[package]]
 name = "futures-core"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4bca583b7e26f571124fe5b7561d49cb2868d79116cfa0eefce955557c6fee8c"
+checksum = "dfc6580bb841c5a68e9ef15c77ccc837b40a7504914d52e47b8b0e9bbda25a1d"
 
 [[package]]
 name = "futures-executor"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ccecee823288125bd88b4d7f565c9e58e41858e47ab72e8ea2d64e93624386e0"
+checksum = "a576fc72ae164fca6b9db127eaa9a9dda0d61316034f33a0a0d4eda41f02b01d"
 dependencies = [
  "futures-core",
  "futures-task",
@@ -1079,15 +1084,15 @@ dependencies = [
 
 [[package]]
 name = "futures-io"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4fff74096e71ed47f8e023204cfd0aa1289cd54ae5430a9523be060cdb849964"
+checksum = "a44623e20b9681a318efdd71c299b6b222ed6f231972bfe2f224ebad6311f0c1"
 
 [[package]]
 name = "futures-macro"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "89ca545a94061b6365f2c7355b4b32bd20df3ff95f02da9329b34ccc3bd6ee72"
+checksum = "87750cf4b7a4c0625b1529e4c543c2182106e4dedc60a2a6455e00d212c489ac"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1096,21 +1101,21 @@ dependencies = [
 
 [[package]]
 name = "futures-sink"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f43be4fe21a13b9781a69afa4985b0f6ee0e1afab2c6f454a8cf30e2b2237b6e"
+checksum = "9fb8e00e87438d937621c1c6269e53f536c14d3fbd6a042bb24879e57d474fb5"
 
 [[package]]
 name = "futures-task"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "76d3d132be6c0e6aa1534069c705a74a5997a356c0dc2f86a47765e5617c5b65"
+checksum = "38d84fa142264698cdce1a9f9172cf383a0c82de1bddcf3092901442c4097004"
 
 [[package]]
 name = "futures-util"
-version = "0.3.28"
+version = "0.3.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26b01e40b772d54cf6c6d721c1d1abd0647a0106a12ecaa1c186273392a69533"
+checksum = "3d6401deb83407ab3da39eba7e33987a73c3df0c82b4bb5813ee871c19c41d48"
 dependencies = [
  "futures-channel",
  "futures-core",
@@ -1156,9 +1161,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.10"
+version = "0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be4136b2a15dd319360be1c07d9933517ccf0be8f16bf62a3bee4f0d618df427"
+checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
 dependencies = [
  "cfg-if",
  "libc",
@@ -1178,9 +1183,9 @@ dependencies = [
 
 [[package]]
 name = "gimli"
-version = "0.28.0"
+version = "0.28.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6fb8d784f27acf97159b40fc4db5ecd8aa23b9ad5ef69cdd136d3bc80665f0c0"
+checksum = "4271d37baee1b8c7e4b708028c57d816cf9d2434acb33a549475f78c181f6253"
 
 [[package]]
 name = "hash-db"
@@ -1203,7 +1208,7 @@ version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888"
 dependencies = [
- "ahash 0.7.6",
+ "ahash 0.7.7",
 ]
 
 [[package]]
@@ -1212,14 +1217,14 @@ version = "0.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "43a3c133739dddd0d2990f9a4bdf8eb4b21ef50e4851ca85ab661199821d510e"
 dependencies = [
- "ahash 0.8.3",
+ "ahash 0.8.7",
 ]
 
 [[package]]
 name = "hashbrown"
-version = "0.14.1"
+version = "0.14.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7dfda62a12f55daeae5015f81b0baea145391cb4520f86c248fc615d72640d12"
+checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
 
 [[package]]
 name = "hermit-abi"
@@ -1266,16 +1271,16 @@ dependencies = [
 
 [[package]]
 name = "iana-time-zone"
-version = "0.1.57"
+version = "0.1.59"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2fad5b825842d2b38bd206f3e81d6957625fd7f0a361e345c30e01a0ae2dd613"
+checksum = "b6a67363e2aa4443928ce15e57ebae94fd8949958fd1223c4cfc0cd473ad7539"
 dependencies = [
  "android_system_properties",
  "core-foundation-sys",
  "iana-time-zone-haiku",
  "js-sys",
  "wasm-bindgen",
- "windows",
+ "windows-core",
 ]
 
 [[package]]
@@ -1359,11 +1364,25 @@ dependencies = [
  "tendermint-proto",
 ]
 
+[[package]]
+name = "ibc-client-wasm-types"
+version = "0.49.1"
+dependencies = [
+ "base64 0.21.6",
+ "displaydoc",
+ "ibc-core-client",
+ "ibc-core-host-types",
+ "ibc-primitives",
+ "ibc-proto",
+ "serde",
+]
+
 [[package]]
 name = "ibc-clients"
 version = "0.49.1"
 dependencies = [
  "ibc-client-tendermint",
+ "ibc-client-wasm-types",
 ]
 
 [[package]]
@@ -1633,7 +1652,7 @@ version = "0.41.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
 dependencies = [
- "base64 0.21.4",
+ "base64 0.21.6",
  "borsh",
  "bytes",
  "flex-error",
@@ -1672,9 +1691,9 @@ checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
 
 [[package]]
 name = "idna"
-version = "0.4.0"
+version = "0.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7d20d6b07bfbc108882d88ed8e37d39636dcc260e15e30c45e6ba089610b917c"
+checksum = "634d9b1461af396cad843f47fdba5597a4f9e6ddd4bfb6ff5d85028c25cb12f6"
 dependencies = [
  "unicode-bidi",
  "unicode-normalization",
@@ -1722,12 +1741,12 @@ dependencies = [
 
 [[package]]
 name = "indexmap"
-version = "2.0.2"
+version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8adf3ddd720272c6ea8bf59463c04e0f93d0bbf7c5439b691bca2987e0270897"
+checksum = "d530e1a18b1cb4c484e6e34556a0d948706958449fca0cab753d649f2bce3d1f"
 dependencies = [
  "equivalent",
- "hashbrown 0.14.1",
+ "hashbrown 0.14.3",
 ]
 
 [[package]]
@@ -1746,7 +1765,7 @@ version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
 dependencies = [
- "base64 0.21.4",
+ "base64 0.21.6",
  "serde",
 ]
 
@@ -1790,15 +1809,15 @@ dependencies = [
 
 [[package]]
 name = "itoa"
-version = "1.0.9"
+version = "1.0.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af150ab688ff2122fcef229be89cb50dd66af9e01a4ff320cc137eecc9bacc38"
+checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
 
 [[package]]
 name = "js-sys"
-version = "0.3.64"
+version = "0.3.66"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c5f195fe497f702db0f318b07fdd68edb16955aed830df8363d837542f8f935a"
+checksum = "cee9c64da59eae3b50095c18d3e74f8b73c0b86d2792824ff01bbce68ba229ca"
 dependencies = [
  "wasm-bindgen",
 ]
@@ -1820,9 +1839,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.149"
+version = "0.2.152"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a08173bc88b7955d1b3145aa561539096c421ac8debde8cbc3612ec635fee29b"
+checksum = "13e3bf6590cbc649f4d1a3eefc9d5d6eb746f5200ffb04e5e142700b8faa56e7"
 
 [[package]]
 name = "libsecp256k1"
@@ -1880,15 +1899,15 @@ checksum = "f051f77a7c8e6957c0696eac88f26b0117e54f52d3fc682ab19397a8812846a4"
 
 [[package]]
 name = "linux-raw-sys"
-version = "0.4.10"
+version = "0.4.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "da2479e8c062e40bf0066ffa0bc823de0a9368974af99c9f6df941d2c231e03f"
+checksum = "c4cd1a83af159aa67994778be9070f0ae1bd732942279cabb14f86f986a21456"
 
 [[package]]
 name = "lock_api"
-version = "0.4.10"
+version = "0.4.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c1cc9717a20b1bb222f333e6a92fd32f7d8a18ddc5a3191a11af45dcbf4dcd16"
+checksum = "3c168f8615b12bc01f9c17e2eb0cc07dcae1940121185446edc3744920e8ef45"
 dependencies = [
  "autocfg",
  "scopeguard",
@@ -1920,9 +1939,9 @@ dependencies = [
 
 [[package]]
 name = "memchr"
-version = "2.6.4"
+version = "2.7.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f665ee40bc4a3c5590afb1e9677db74a508659dfd71e126420da8274909a0167"
+checksum = "523dc4f511e55ab87b694dc30d0f820d60906ef06413f93d4d7a1385599cc149"
 
 [[package]]
 name = "memfd"
@@ -1930,7 +1949,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
 dependencies = [
- "rustix 0.38.19",
+ "rustix 0.38.28",
 ]
 
 [[package]]
@@ -2069,18 +2088,18 @@ dependencies = [
 
 [[package]]
 name = "object"
-version = "0.32.1"
+version = "0.32.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9cf5f9dd3933bd50a9e1f149ec995f39ae2c496d31fd772c1fd45ebc27e902b0"
+checksum = "a6a622008b6e321afc04970976f62ee297fdbaa6f95318ca343e3eebb9648441"
 dependencies = [
  "memchr",
 ]
 
 [[package]]
 name = "once_cell"
-version = "1.18.0"
+version = "1.19.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd8b5dd2ae5ed71462c540258bedcb51965123ad7e7ccf4b9a8cafaa4a63576d"
+checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
 
 [[package]]
 name = "opaque-debug"
@@ -2096,9 +2115,9 @@ checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.5"
+version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0dec8a8073036902368c2cdc0387e85ff9a37054d7e7c98e592145e0c92cd4fb"
+checksum = "881331e34fa842a2fb61cc2db9643a8fedc615e47cfcc52597d1af0db9a7e8fe"
 dependencies = [
  "arrayvec 0.7.4",
  "bitvec",
@@ -2111,11 +2130,11 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.5"
+version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "312270ee71e1cd70289dacf597cab7b207aa107d2f28191c2ae45b2ece18a260"
+checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
 dependencies = [
- "proc-macro-crate 1.3.1",
+ "proc-macro-crate 2.0.1",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -2133,9 +2152,9 @@ dependencies = [
 
 [[package]]
 name = "parking_lot_core"
-version = "0.9.8"
+version = "0.9.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "93f00c865fe7cabf650081affecd3871070f26767e7b2070a3ffae14c654b447"
+checksum = "4c42a9226546d68acdd9c0a280d17ce19bfe27a46bf68784e4066115788d008e"
 dependencies = [
  "cfg-if",
  "libc",
@@ -2161,9 +2180,9 @@ dependencies = [
 
 [[package]]
 name = "percent-encoding"
-version = "2.3.0"
+version = "2.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9b2a4787296e9989611394c33f193f676704af1686e70b8f8033ab5ba9a35a94"
+checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
 
 [[package]]
 name = "pin-project-lite"
@@ -2189,9 +2208,15 @@ dependencies = [
 
 [[package]]
 name = "platforms"
-version = "3.1.2"
+version = "3.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4503fa043bf02cee09a9582e9554b4c6403b2ef55e4612e96561d294419429f8"
+checksum = "626dec3cac7cc0e1577a2ec3fc496277ec2baa084bebad95bb6fdbfae235f84c"
+
+[[package]]
+name = "powerfmt"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "439ee305def115ba05938db6eb1644ff94165c5ab5e9420d1c1bcedbba909391"
 
 [[package]]
 name = "ppv-lite86"
@@ -2275,9 +2300,9 @@ dependencies = [
 
 [[package]]
 name = "prost-types"
-version = "0.12.1"
+version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e081b29f63d83a4bc75cfc9f3fe424f9156cf92d8a4f0c9407cce9a1b67327cf"
+checksum = "193898f59edcf43c26227dcd4c8427f00d99d61e95dcde58dabd49fa291d470e"
 dependencies = [
  "prost",
 ]
@@ -2365,7 +2390,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
 dependencies = [
- "getrandom 0.2.10",
+ "getrandom 0.2.12",
 ]
 
 [[package]]
@@ -2379,27 +2404,27 @@ dependencies = [
 
 [[package]]
 name = "redox_syscall"
-version = "0.3.5"
+version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "567664f262709473930a4bf9e51bf2ebf3348f2e748ccc50dea20646858f8f29"
+checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa"
 dependencies = [
  "bitflags 1.3.2",
 ]
 
 [[package]]
 name = "ref-cast"
-version = "1.0.20"
+version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "acde58d073e9c79da00f2b5b84eed919c8326832648a5b109b3fce1bb1175280"
+checksum = "c4846d4c50d1721b1a3bef8af76924eef20d5e723647333798c1b519b3a9473f"
 dependencies = [
  "ref-cast-impl",
 ]
 
 [[package]]
 name = "ref-cast-impl"
-version = "1.0.20"
+version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f7473c2cfcf90008193dd0e3e16599455cb601a9fce322b5bb55de799664925"
+checksum = "5fddb4f8d99b0a2ebafc65a87a69a7b9875e4b1ae1f00db265d300ef7f28bccc"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2408,14 +2433,14 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.10.0"
+version = "1.10.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d119d7c7ca818f8a53c300863d4f87566aac09943aef5b355bb83969dae75d87"
+checksum = "380b951a9c5e80ddfd6136919eef32310721aa4aacd4889a8d39124b026ab343"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-automata 0.4.1",
- "regex-syntax 0.8.1",
+ "regex-automata 0.4.3",
+ "regex-syntax 0.8.2",
 ]
 
 [[package]]
@@ -2429,13 +2454,13 @@ dependencies = [
 
 [[package]]
 name = "regex-automata"
-version = "0.4.1"
+version = "0.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "465c6fc0621e4abc4187a2bda0937bfd4f722c2730b29562e19689ea796c9a4b"
+checksum = "5f804c7828047e88b2d32e2d7fe5a105da8ee3264f01902f796c8e067dc2483f"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-syntax 0.8.1",
+ "regex-syntax 0.8.2",
 ]
 
 [[package]]
@@ -2446,9 +2471,9 @@ checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
 
 [[package]]
 name = "regex-syntax"
-version = "0.8.1"
+version = "0.8.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56d84fdd47036b038fc80dd333d10b6aab10d5d31f4a366e20014def75328d33"
+checksum = "c08c74e62047bb2de4ff487b251e4a92e24f48745648451635cec7d591162d9f"
 
 [[package]]
 name = "ripemd"
@@ -2482,9 +2507,9 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.36.16"
+version = "0.36.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6da3636faa25820d8648e0e31c5d519bbb01f72fdf57131f0f5f7da5fed36eab"
+checksum = "305efbd14fde4139eb501df5f136994bb520b033fa9fbdce287507dc23b8c7ed"
 dependencies = [
  "bitflags 1.3.2",
  "errno",
@@ -2496,15 +2521,15 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.38.19"
+version = "0.38.28"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "745ecfa778e66b2b63c88a61cb36e0eea109e803b0b86bf9879fbc77c70e86ed"
+checksum = "72e572a5e8ca657d7366229cdde4bd14c4eb5499a9573d4d366fe1b599daa316"
 dependencies = [
- "bitflags 2.4.0",
+ "bitflags 2.4.1",
  "errno",
  "libc",
- "linux-raw-sys 0.4.10",
- "windows-sys 0.48.0",
+ "linux-raw-sys 0.4.12",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -2515,9 +2540,9 @@ checksum = "7ffc183a10b4478d04cbbbfc96d0873219d962dd5accaff2ffbd4ceb7df837f4"
 
 [[package]]
 name = "ryu"
-version = "1.0.15"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1ad4cc8da4ef723ed60bced201181d83791ad433213d8c24efffda1eec85d741"
+checksum = "f98d2aa92eebf49b69786be48e4477826b256916e84a57ff2a4f21923b48eb4c"
 
 [[package]]
 name = "same-file"
@@ -2560,7 +2585,7 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "772575a524feeb803e5b0fcbc6dd9f367e579488197c94c6e4023aad2305774d"
 dependencies = [
- "ahash 0.8.3",
+ "ahash 0.8.7",
  "cfg-if",
  "hashbrown 0.13.2",
 ]
@@ -2618,9 +2643,9 @@ dependencies = [
 
 [[package]]
 name = "semver"
-version = "1.0.20"
+version = "1.0.21"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "836fa6a3e1e547f9a2c4040802ec865b5d85f4014efe00555d7090a3dcaa1090"
+checksum = "b97ed7a9823b74f99c7742f5336af7be5ecd3eeafcb1507d1fa93347b1d589b0"
 
 [[package]]
 name = "serde"
@@ -2642,9 +2667,9 @@ dependencies = [
 
 [[package]]
 name = "serde_bytes"
-version = "0.11.12"
+version = "0.11.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab33ec92f677585af6d88c65593ae2375adde54efdbf16d597f2cbc7a6d368ff"
+checksum = "8b8497c313fd43ab992087548117643f6fcd935cbf36f176ffda0aacf9591734"
 dependencies = [
  "serde",
 ]
@@ -2662,9 +2687,9 @@ dependencies = [
 
 [[package]]
 name = "serde_json"
-version = "1.0.107"
+version = "1.0.111"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6b420ce6e3d8bd882e9b243c6eed35dbc9a6110c9769e74b584e0d68d1f20c65"
+checksum = "176e46fa42316f18edd598015a5166857fc835ec732f5215eac6b7bdbf0a84f4"
 dependencies = [
  "itoa",
  "ryu",
@@ -2673,9 +2698,9 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.16"
+version = "0.1.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8725e1dfadb3a50f7e5ce0b1a540466f6ed3fe7a0fca2ac2b8b831d31316bd00"
+checksum = "0b2e6b945e9d3df726b65d6ee24060aff8e3533d431f677a9695db04eff9dfdb"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2748,9 +2773,12 @@ dependencies = [
 
 [[package]]
 name = "signature"
-version = "2.1.0"
+version = "2.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e1788eed21689f9cf370582dfc467ef36ed9c707f073528ddafa8d83e3b8500"
+checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
+dependencies = [
+ "rand_core 0.6.4",
+]
 
 [[package]]
 name = "simple-mermaid"
@@ -2769,9 +2797,9 @@ dependencies = [
 
 [[package]]
 name = "smallvec"
-version = "1.11.1"
+version = "1.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "942b4a808e05215192e39f4ab80813e599068285906cc91aa64f923db842bd5a"
+checksum = "4dccd0940a2dcdf68d092b8cbab7dc0ad8fa938bf95787e1b916b0e3d0e8e970"
 
 [[package]]
 name = "sp-application-crypto"
@@ -3053,7 +3081,7 @@ version = "28.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5cbc3ad723c9addc4b7aafbe8bfabf638c39be3c911e11f58e924e17554003ac"
 dependencies = [
- "ahash 0.8.3",
+ "ahash 0.8.7",
  "hash-db",
  "hashbrown 0.13.2",
  "lazy_static",
@@ -3105,9 +3133,9 @@ dependencies = [
 
 [[package]]
 name = "spki"
-version = "0.7.2"
+version = "0.7.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d1e996ef02c474957d681f1b05213dfb0abab947b446a62d37770b23500184a"
+checksum = "d91ed6c858b01f942cd56b37a94b3e0a1798290327d1236e4d9cf4eaca44d29d"
 dependencies = [
  "base64ct",
  "der",
@@ -3115,9 +3143,9 @@ dependencies = [
 
 [[package]]
 name = "ss58-registry"
-version = "1.43.0"
+version = "1.45.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5e6915280e2d0db8911e5032a5c275571af6bdded2916abd691a659be25d3439"
+checksum = "3c0c74081753a8ce1c8eb10b9f262ab6f7017e5ad3317c17a54c7ab65fcb3c6e"
 dependencies = [
  "Inflector",
  "num-format",
@@ -3148,9 +3176,9 @@ checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"
 
 [[package]]
 name = "substrate-bip39"
-version = "0.4.4"
+version = "0.4.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "49eee6965196b32f882dd2ee85a92b1dbead41b04e53907f269de3b0dc04733c"
+checksum = "e620c7098893ba667438b47169c00aacdd9e7c10e042250ce2b60b087ec97328"
 dependencies = [
  "hmac 0.11.0",
  "pbkdf2",
@@ -3210,9 +3238,9 @@ checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369"
 
 [[package]]
 name = "target-lexicon"
-version = "0.12.11"
+version = "0.12.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9d0e916b1148c8e263850e1ebcbd046f333e0683c724876bb0da63ea4373dc8a"
+checksum = "69758bda2e78f098e4ccb393021a0963bb3442eac05f135c30f61b7370bbafae"
 
 [[package]]
 name = "tendermint"
@@ -3276,27 +3304,27 @@ dependencies = [
 
 [[package]]
 name = "termcolor"
-version = "1.4.0"
+version = "1.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff1bc3d3f05aff0403e8ac0d92ced918ec05b666a43f83297ccef5bea8a3d449"
+checksum = "06794f8f6c5c898b3275aebefa6b8a1cb24cd2c6c79397ab15774837a0bc5755"
 dependencies = [
  "winapi-util",
 ]
 
 [[package]]
 name = "thiserror"
-version = "1.0.49"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1177e8c6d7ede7afde3585fd2513e611227efd6481bd78d2e82ba1ce16557ed4"
+checksum = "d54378c645627613241d077a3a79db965db602882668f9136ac42af9ecb730ad"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.49"
+version = "1.0.56"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "10712f02019e9288794769fba95cd6847df9874d49d871d062172f9dd41bc4cc"
+checksum = "fa0faa943b50f3db30a20aa7e265dbc66076993efed8463e8de414e5d06d3471"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3315,11 +3343,12 @@ dependencies = [
 
 [[package]]
 name = "time"
-version = "0.3.29"
+version = "0.3.31"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "426f806f4089c493dcac0d24c29c01e2c38baf8e30f1b716ee37e83d200b18fe"
+checksum = "f657ba42c3f86e7680e53c8cd3af8abbe56b5491790b46e22e19c0d57463583e"
 dependencies = [
  "deranged",
+ "powerfmt",
  "time-core",
  "time-macros",
 ]
@@ -3332,9 +3361,9 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.15"
+version = "0.2.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4ad70d68dba9e1f8aceda7aa6711965dfec1cac869f311a51bd08b3a2ccbce20"
+checksum = "26197e33420244aeb70c3e8c78376ca46571bc4e701e4791c2cd9f57dcb3a43f"
 dependencies = [
  "time-core",
 ]
@@ -3390,7 +3419,7 @@ version = "0.19.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
 dependencies = [
- "indexmap 2.0.2",
+ "indexmap 2.1.0",
  "toml_datetime",
  "winnow",
 ]
@@ -3401,7 +3430,7 @@ version = "0.20.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
 dependencies = [
- "indexmap 2.0.2",
+ "indexmap 2.1.0",
  "serde",
  "serde_spanned",
  "toml_datetime",
@@ -3442,12 +3471,12 @@ dependencies = [
 
 [[package]]
 name = "tracing-log"
-version = "0.1.3"
+version = "0.1.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "78ddad33d2d10b1ed7eb9d1f518a5674713876e97e5bb9b7345a7984fbb4f922"
+checksum = "f751112709b4e791d8ce53e32c4ed2d353565a795ce84da2285393f41557bdf2"
 dependencies = [
- "lazy_static",
  "log",
+ "once_cell",
  "tracing-core",
 ]
 
@@ -3537,9 +3566,9 @@ dependencies = [
 
 [[package]]
 name = "unicode-bidi"
-version = "0.3.13"
+version = "0.3.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "92888ba5573ff080736b3648696b70cafad7d250551175acbaa4e0385b3e1460"
+checksum = "6f2528f27a9eb2b21e69c95319b30bd0efd85d09c379741b0f78ea1d86be2416"
 
 [[package]]
 name = "unicode-ident"
@@ -3564,9 +3593,9 @@ checksum = "f962df74c8c05a667b5ee8bcf162993134c104e96440b663c8daa176dc772d8c"
 
 [[package]]
 name = "url"
-version = "2.4.1"
+version = "2.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "143b538f18257fac9cad154828a57c6bf5157e1aa604d4816b5995bf6de87ae5"
+checksum = "31e6302e3bb753d46e83516cae55ae196fc0c309407cf11ab35cc51a4c2a4633"
 dependencies = [
  "form_urlencoded",
  "idna",
@@ -3633,9 +3662,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.87"
+version = "0.2.89"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7706a72ab36d8cb1f80ffbf0e071533974a60d0a308d01a5d0375bf60499a342"
+checksum = "0ed0d4f68a3015cc185aff4db9506a015f4b96f95303897bfa23f846db54064e"
 dependencies = [
  "cfg-if",
  "wasm-bindgen-macro",
@@ -3643,9 +3672,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-backend"
-version = "0.2.87"
+version = "0.2.89"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5ef2b6d3c510e9625e5fe6f509ab07d66a760f0885d858736483c32ed7809abd"
+checksum = "1b56f625e64f3a1084ded111c4d5f477df9f8c92df113852fa5a374dbda78826"
 dependencies = [
  "bumpalo",
  "log",
@@ -3658,9 +3687,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.87"
+version = "0.2.89"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dee495e55982a3bd48105a7b947fd2a9b4a8ae3010041b9e0faab3f9cd028f1d"
+checksum = "0162dbf37223cd2afce98f3d0785506dcb8d266223983e4b5b525859e6e182b2"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -3668,9 +3697,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.87"
+version = "0.2.89"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "54681b18a46765f095758388f2d0cf16eb8d4169b639ab575a8f5693af210c7b"
+checksum = "f0eb82fcb7930ae6219a7ecfd55b217f5f0893484b7a13022ebb2b2bf20b5283"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3681,9 +3710,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.87"
+version = "0.2.89"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca6ad05a4870b2bf5fe995117d3728437bd27d7cd5f06f13c17443ef369775a1"
+checksum = "7ab9b36309365056cd639da3134bf87fa8f3d86008abf99e612384a6eecd459f"
 
 [[package]]
 name = "wasmparser"
@@ -3808,7 +3837,7 @@ dependencies = [
  "memoffset",
  "paste",
  "rand 0.8.5",
- "rustix 0.36.16",
+ "rustix 0.36.17",
  "wasmtime-asm-macros",
  "wasmtime-environ",
  "wasmtime-jit-debug",
@@ -3859,12 +3888,12 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "712e227841d057c1ee1cd2fb22fa7e5a5461ae8e48fa2ca79ec42cfc1931183f"
 
 [[package]]
-name = "windows"
-version = "0.48.0"
+name = "windows-core"
+version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e686886bc078bc1b0b600cac0147aadb815089b6e4da64016cbd754b6342700f"
+checksum = "33ab640c8d7e35bf8ba19b884ba838ceb4fba93a4e8c65a9059d08afcfc683d9"
 dependencies = [
- "windows-targets 0.48.5",
+ "windows-targets 0.52.0",
 ]
 
 [[package]]
@@ -3885,6 +3914,15 @@ dependencies = [
  "windows-targets 0.48.5",
 ]
 
+[[package]]
+name = "windows-sys"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
+dependencies = [
+ "windows-targets 0.52.0",
+]
+
 [[package]]
 name = "windows-targets"
 version = "0.42.2"
@@ -3915,6 +3953,21 @@ dependencies = [
  "windows_x86_64_msvc 0.48.5",
 ]
 
+[[package]]
+name = "windows-targets"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8a18201040b24831fbb9e4eb208f8892e1f50a37feb53cc7ff887feb8f50e7cd"
+dependencies = [
+ "windows_aarch64_gnullvm 0.52.0",
+ "windows_aarch64_msvc 0.52.0",
+ "windows_i686_gnu 0.52.0",
+ "windows_i686_msvc 0.52.0",
+ "windows_x86_64_gnu 0.52.0",
+ "windows_x86_64_gnullvm 0.52.0",
+ "windows_x86_64_msvc 0.52.0",
+]
+
 [[package]]
 name = "windows_aarch64_gnullvm"
 version = "0.42.2"
@@ -3927,6 +3980,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
 
+[[package]]
+name = "windows_aarch64_gnullvm"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cb7764e35d4db8a7921e09562a0304bf2f93e0a51bfccee0bd0bb0b666b015ea"
+
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.42.2"
@@ -3939,6 +3998,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
 
+[[package]]
+name = "windows_aarch64_msvc"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "bbaa0368d4f1d2aaefc55b6fcfee13f41544ddf36801e793edbbfd7d7df075ef"
+
 [[package]]
 name = "windows_i686_gnu"
 version = "0.42.2"
@@ -3951,6 +4016,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
 
+[[package]]
+name = "windows_i686_gnu"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a28637cb1fa3560a16915793afb20081aba2c92ee8af57b4d5f28e4b3e7df313"
+
 [[package]]
 name = "windows_i686_msvc"
 version = "0.42.2"
@@ -3963,6 +4034,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
 
+[[package]]
+name = "windows_i686_msvc"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ffe5e8e31046ce6230cc7215707b816e339ff4d4d67c65dffa206fd0f7aa7b9a"
+
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.42.2"
@@ -3975,6 +4052,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
 
+[[package]]
+name = "windows_x86_64_gnu"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3d6fa32db2bc4a2f5abeacf2b69f7992cd09dca97498da74a151a3132c26befd"
+
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.42.2"
@@ -3987,6 +4070,12 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
 
+[[package]]
+name = "windows_x86_64_gnullvm"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1a657e1e9d3f514745a572a6846d3c7aa7dbe1658c056ed9c3344c4109a6949e"
+
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.42.2"
@@ -3999,11 +4088,17 @@ version = "0.48.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
 
+[[package]]
+name = "windows_x86_64_msvc"
+version = "0.52.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "dff9641d1cd4be8d1a070daf9e3773c5f67e78b4d9d42263020c057706765c04"
+
 [[package]]
 name = "winnow"
-version = "0.5.16"
+version = "0.5.33"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "037711d82167854aff2018dfd193aa0fef5370f456732f0d5a0c59b0f1b4b907"
+checksum = "b7520bbdec7211caa7c4e682eb1fbe07abe20cee6756b6e00f537c82c11816aa"
 dependencies = [
  "memchr",
 ]
@@ -4017,11 +4112,31 @@ dependencies = [
  "tap",
 ]
 
+[[package]]
+name = "zerocopy"
+version = "0.7.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "74d4d3961e53fa4c9a25a8637fc2bfaf2595b3d3ae34875568a5cf64787716be"
+dependencies = [
+ "zerocopy-derive",
+]
+
+[[package]]
+name = "zerocopy-derive"
+version = "0.7.32"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ce1b18ccd8e73a9321186f97e46f9f04b778851177567b1975109d26a08d2a6"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.48",
+]
+
 [[package]]
 name = "zeroize"
-version = "1.6.0"
+version = "1.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a0956f1ba7c7909bfb66c2e9e4124ab6f6482560f6628b5aaeba39207c9aad9"
+checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ibc-clients/Cargo.toml b/ibc-clients/Cargo.toml
index 65da32f6e..85f3f2c21 100644
--- a/ibc-clients/Cargo.toml
+++ b/ibc-clients/Cargo.toml
@@ -18,17 +18,21 @@ all-features = true
 
 [dependencies]
 ibc-client-tendermint = { workspace = true }
+ibc-client-wasm-types = { workspace = true }
 
 [features]
 default = ["std"]
 std = [
     "ibc-client-tendermint/std",
+    "ibc-client-wasm-types/std",
 ]
 serde = [
     "ibc-client-tendermint/serde",
+    "ibc-client-wasm-types/serde",
 ]
 schema = [
     "ibc-client-tendermint/schema",
+    "ibc-client-wasm-types/schema",
     "serde",
     "std"
 ]
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
index c72ac618e..4c0e32a9d 100644
--- a/ibc-clients/README.md
+++ b/ibc-clients/README.md
@@ -26,6 +26,10 @@ IBC light clients:
 - [ibc-client-tendermint](./ics07-tendermint)
 - [ibc-client-tendermint-types](./ics07-tendermint/types)
 
+### ICS-08: WASM Proxy Light Client
+
+- [ibc-client-wasm-types](./ics08-wasm/types)
+
 ## Third-party Clients
 
 Here, we list IBC third-party clients that are compatible with `ibc-rs`. You
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
new file mode 100644
index 000000000..fe645d132
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -0,0 +1,53 @@
+[package]
+name = "ibc-client-wasm-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+license      = { workspace = true }
+rust-version = { workspace = true }
+edition      = { workspace = true }
+
+[dependencies]
+# external dependencies
+base64          = { version = "0.21", default-features = false, features = ["alloc"] }
+displaydoc      = { workspace = true }
+serde           = { workspace = true , optional = true }
+cosmwasm-schema = { version = "1.4.1", default-features = false, optional = true }
+
+# ibc dependencies
+ibc-core-client     = { workspace = true }
+ibc-core-host-types = { workspace = true }
+ibc-primitives      = { workspace = true }
+ibc-proto           = { workspace = true }
+
+[dev-dependencies]
+rstest     = { workspace = true }
+serde_json = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+	"ibc-core-client/std",
+	"ibc-core-host-types/std",
+	"ibc-proto/std",
+	"base64/std",
+	"serde/std"
+]
+serde = [
+	"ibc-core-client/serde",
+	"ibc-core-host-types/serde",
+	"ibc-primitives/serde",
+	"ibc-proto/serde",
+	"dep:serde"
+]
+schema = [
+	"ibc-core-client/schema",
+	"ibc-core-host-types/schema",
+	"ibc-primitives/schema",
+	"ibc-proto/json-schema",
+	"serde",
+	"std"
+]
+cosmwasm = [
+	"cosmwasm-schema",
+	"schema"
+]
diff --git a/ibc-clients/ics08-wasm/types/src/client_message.rs b/ibc-clients/ics08-wasm/types/src/client_message.rs
new file mode 100644
index 000000000..242dcd653
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/client_message.rs
@@ -0,0 +1,47 @@
+//! Defines the client message type for the ICS-08 Wasm light client.
+
+use ibc_primitives::proto::Protobuf;
+use ibc_proto::ibc::lightclients::wasm::v1::ClientMessage as RawClientMessage;
+
+use crate::Bytes;
+
+pub const WASM_CLIENT_MESSAGE_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.ClientMessage";
+
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct ClientMessage {
+    pub data: Bytes,
+}
+
+impl Protobuf<RawClientMessage> for ClientMessage {}
+
+impl From<RawClientMessage> for ClientMessage {
+    fn from(raw: RawClientMessage) -> Self {
+        Self { data: raw.data }
+    }
+}
+
+impl From<ClientMessage> for RawClientMessage {
+    fn from(value: ClientMessage) -> Self {
+        RawClientMessage { data: value.data }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case(b"data")]
+    fn test_roundtrip(#[case] data: &[u8]) {
+        let raw_msg = RawClientMessage {
+            data: data.to_vec(),
+        };
+        assert_eq!(
+            RawClientMessage::from(ClientMessage::from(raw_msg.clone())),
+            raw_msg,
+        )
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/client_state.rs b/ibc-clients/ics08-wasm/types/src/client_state.rs
new file mode 100644
index 000000000..4dda117a0
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/client_state.rs
@@ -0,0 +1,121 @@
+//! Defines the client state type for the ICS-08 Wasm light client.
+
+#[cfg(feature = "cosmwasm")]
+use cosmwasm_schema::cw_serde;
+use ibc_core_client::types::Height;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::{Any, Protobuf};
+use ibc_proto::ibc::lightclients::wasm::v1::ClientState as RawClientState;
+
+use crate::error::Error;
+#[cfg(feature = "cosmwasm")]
+use crate::serializer::Base64;
+use crate::Bytes;
+
+pub const WASM_CLIENT_STATE_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.ClientState";
+
+#[cfg_attr(feature = "cosmwasm", cw_serde)]
+#[cfg_attr(not(feature = "cosmwasm"), derive(Clone, Debug, PartialEq))]
+#[derive(Eq)]
+pub struct ClientState {
+    #[cfg_attr(feature = "cosmwasm", schemars(with = "String"))]
+    #[cfg_attr(feature = "cosmwasm", serde(with = "Base64", default))]
+    pub data: Bytes,
+    #[cfg_attr(feature = "cosmwasm", schemars(with = "String"))]
+    #[cfg_attr(feature = "cosmwasm", serde(with = "Base64", default))]
+    pub checksum: Bytes,
+    pub latest_height: Height,
+}
+
+impl Protobuf<RawClientState> for ClientState {}
+
+impl From<ClientState> for RawClientState {
+    fn from(value: ClientState) -> Self {
+        Self {
+            data: value.data,
+            checksum: value.checksum,
+            latest_height: Some(value.latest_height.into()),
+        }
+    }
+}
+
+impl TryFrom<RawClientState> for ClientState {
+    type Error = Error;
+
+    fn try_from(raw: RawClientState) -> Result<Self, Self::Error> {
+        let latest_height = raw
+            .latest_height
+            .ok_or(Error::InvalidLatestHeight {
+                reason: "missing latest height".to_string(),
+            })?
+            .try_into()
+            .map_err(|_| Error::InvalidLatestHeight {
+                reason: "invalid protobuf latest height".to_string(),
+            })?;
+        Ok(Self {
+            data: raw.data,
+            checksum: raw.checksum,
+            latest_height,
+        })
+    }
+}
+
+impl Protobuf<Any> for ClientState {}
+
+impl From<ClientState> for Any {
+    fn from(value: ClientState) -> Self {
+        Self {
+            type_url: WASM_CLIENT_STATE_TYPE_URL.to_string(),
+            value: Protobuf::<RawClientState>::encode_vec(value),
+        }
+    }
+}
+
+impl TryFrom<Any> for ClientState {
+    type Error = Error;
+
+    fn try_from(any: Any) -> Result<Self, Self::Error> {
+        fn decode_client_state(value: &[u8]) -> Result<ClientState, Error> {
+            let client_state =
+                Protobuf::<RawClientState>::decode(value).map_err(|e| Error::DecodeError {
+                    reason: e.to_string(),
+                })?;
+
+            Ok(client_state)
+        }
+
+        match any.type_url.as_str() {
+            WASM_CLIENT_STATE_TYPE_URL => decode_client_state(&any.value),
+            _ => Err(Error::DecodeError {
+                reason: "type_url does not match".into(),
+            }),
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case(b"data", b"checksum", 1)]
+    fn test_roundtrip(#[case] data: &[u8], #[case] checksum: &[u8], #[case] height: u64) {
+        let raw_client_state = RawClientState {
+            data: data.to_vec(),
+            checksum: checksum.to_vec(),
+            latest_height: Some(RawHeight {
+                revision_number: 0,
+                revision_height: height,
+            }),
+        };
+        let client_state: ClientState = raw_client_state.clone().try_into().unwrap();
+        assert_eq!(RawClientState::from(client_state.clone()), raw_client_state);
+        assert_eq!(
+            ClientState::try_from(Any::from(client_state.clone())).unwrap(),
+            client_state
+        );
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/consensus_state.rs b/ibc-clients/ics08-wasm/types/src/consensus_state.rs
new file mode 100644
index 000000000..32e6476a9
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/consensus_state.rs
@@ -0,0 +1,97 @@
+//! Defines the consensus state type for the ICS-08 Wasm light client.
+
+#[cfg(feature = "cosmwasm")]
+use cosmwasm_schema::cw_serde;
+use ibc_core_client::types::error::ClientError;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::{Any, Protobuf};
+use ibc_proto::ibc::lightclients::wasm::v1::ConsensusState as RawConsensusState;
+
+#[cfg(feature = "cosmwasm")]
+use crate::serializer::Base64;
+use crate::Bytes;
+
+pub const WASM_CONSENSUS_STATE_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.ConsensusState";
+
+#[cfg_attr(feature = "cosmwasm", cw_serde)]
+#[cfg_attr(not(feature = "cosmwasm"), derive(Clone, Debug, PartialEq))]
+#[derive(Eq)]
+pub struct ConsensusState {
+    #[cfg_attr(feature = "cosmwasm", schemars(with = "String"))]
+    #[cfg_attr(feature = "cosmwasm", serde(with = "Base64", default))]
+    pub data: Bytes,
+}
+
+impl ConsensusState {
+    pub fn new(data: Bytes) -> Self {
+        Self { data }
+    }
+}
+
+impl Protobuf<RawConsensusState> for ConsensusState {}
+
+impl From<ConsensusState> for RawConsensusState {
+    fn from(value: ConsensusState) -> Self {
+        Self { data: value.data }
+    }
+}
+
+impl TryFrom<RawConsensusState> for ConsensusState {
+    type Error = ClientError;
+
+    fn try_from(value: RawConsensusState) -> Result<Self, Self::Error> {
+        Ok(Self { data: value.data })
+    }
+}
+
+impl Protobuf<Any> for ConsensusState {}
+
+impl From<ConsensusState> for Any {
+    fn from(value: ConsensusState) -> Self {
+        Self {
+            type_url: WASM_CONSENSUS_STATE_TYPE_URL.to_string(),
+            value: Protobuf::<RawConsensusState>::encode_vec(value),
+        }
+    }
+}
+
+impl TryFrom<Any> for ConsensusState {
+    type Error = ClientError;
+
+    fn try_from(any: Any) -> Result<Self, Self::Error> {
+        fn decode_consensus_state(value: &[u8]) -> Result<ConsensusState, ClientError> {
+            let consensus_state =
+                Protobuf::<RawConsensusState>::decode(value).map_err(|e| ClientError::Other {
+                    description: e.to_string(),
+                })?;
+            Ok(consensus_state)
+        }
+        match any.type_url.as_str() {
+            WASM_CONSENSUS_STATE_TYPE_URL => decode_consensus_state(&any.value),
+            _ => Err(ClientError::Other {
+                description: "type_url does not match".into(),
+            }),
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case(b"data")]
+    fn test_roundtrip(#[case] data: &[u8]) {
+        let raw_msg = RawConsensusState {
+            data: data.to_vec(),
+        };
+        let msg = ConsensusState::try_from(raw_msg.clone()).unwrap();
+        assert_eq!(RawConsensusState::from(msg.clone()), raw_msg);
+        assert_eq!(
+            ConsensusState::try_from(Any::from(msg.clone())).unwrap(),
+            msg
+        );
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/error.rs b/ibc-clients/ics08-wasm/types/src/error.rs
new file mode 100644
index 000000000..eb48a2855
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/error.rs
@@ -0,0 +1,32 @@
+//! Defines the error type for the ICS-08 Wasm light client.
+
+use displaydoc::Display;
+use ibc_core_host_types::error::IdentifierError;
+use ibc_primitives::prelude::*;
+
+/// The main error type
+#[derive(Debug, Display)]
+pub enum Error {
+    /// invalid identifier: `{0}`
+    InvalidIdentifier(IdentifierError),
+    /// decoding error: `{reason}`
+    DecodeError { reason: String },
+    /// invalid client state latest height: `{reason}`
+    InvalidLatestHeight { reason: String },
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for Error {
+    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+        match self {
+            Error::InvalidIdentifier(err) => Some(err),
+            _ => None,
+        }
+    }
+}
+
+impl From<IdentifierError> for Error {
+    fn from(e: IdentifierError) -> Self {
+        Self::InvalidIdentifier(e)
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/lib.rs b/ibc-clients/ics08-wasm/types/src/lib.rs
new file mode 100644
index 000000000..d1cbdf51a
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/lib.rs
@@ -0,0 +1,49 @@
+//! Definitions of domain types used in the ICS-08 Wasm light client implementation.
+#![forbid(unsafe_code)]
+#![cfg_attr(not(feature = "std"), no_std)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+pub mod client_message;
+pub mod client_state;
+pub mod consensus_state;
+pub mod error;
+pub mod msgs;
+
+#[cfg(feature = "cosmwasm")]
+pub mod serializer;
+
+use core::str::FromStr;
+
+use ibc_core_host_types::identifiers::ClientType;
+use ibc_primitives::prelude::Vec;
+pub type Bytes = Vec<u8>;
+
+pub static SUBJECT_PREFIX: &[u8] = b"subject/";
+pub static SUBSTITUTE_PREFIX: &[u8] = b"substitute/";
+
+pub const WASM_CLIENT_TYPE: &str = "08-wasm";
+
+/// Returns the wasm `ClientType`
+pub fn client_type() -> ClientType {
+    ClientType::from_str(WASM_CLIENT_TYPE).expect("Never fails because it's valid")
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    // Ensures that the validation in `ClientType::from_str` doesn't fail for the wasm client type
+    #[test]
+    pub fn test_wasm_client_type() {
+        let _ = ClientType::from_str(WASM_CLIENT_TYPE).unwrap();
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/msgs/migrate_contract.rs b/ibc-clients/ics08-wasm/types/src/msgs/migrate_contract.rs
new file mode 100644
index 000000000..40c737457
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/msgs/migrate_contract.rs
@@ -0,0 +1,74 @@
+use core::str::FromStr;
+
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
+use ibc_proto::ibc::lightclients::wasm::v1::MsgMigrateContract as RawMsgMigrateContract;
+use ibc_proto::Protobuf;
+
+use crate::error::Error;
+use crate::Bytes;
+
+pub const MIGRATE_CONTRACT_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.MsgMigrateContract";
+
+/// Defines the message type for migrating a Wasm contract on the chain.
+#[derive(Clone, PartialEq, Debug, Eq)]
+pub struct MsgMigrateContract {
+    pub signer: Signer,
+    pub client_id: ClientId,
+    pub checksum: Bytes,
+    pub msg: Bytes,
+}
+
+impl Protobuf<RawMsgMigrateContract> for MsgMigrateContract {}
+
+impl From<MsgMigrateContract> for RawMsgMigrateContract {
+    fn from(value: MsgMigrateContract) -> Self {
+        Self {
+            signer: value.signer.to_string(),
+            client_id: value.client_id.to_string(),
+            checksum: value.checksum,
+            msg: value.msg,
+        }
+    }
+}
+
+impl TryFrom<RawMsgMigrateContract> for MsgMigrateContract {
+    type Error = Error;
+
+    fn try_from(value: RawMsgMigrateContract) -> Result<Self, Self::Error> {
+        Ok(Self {
+            signer: Signer::from(value.signer),
+            client_id: ClientId::from_str(&value.client_id)?,
+            checksum: value.checksum,
+            msg: value.msg,
+        })
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case("signer", "08-wasm-2", b"checksum", b"msg")]
+    fn test_roundtrip(
+        #[case] signer: &str,
+        #[case] client_id: &str,
+        #[case] checksum: &[u8],
+        #[case] msg: &[u8],
+    ) {
+        let raw_msg = RawMsgMigrateContract {
+            signer: signer.to_string(),
+            client_id: client_id.to_string(),
+            checksum: checksum.to_vec(),
+            msg: msg.to_vec(),
+        };
+        assert_eq!(
+            RawMsgMigrateContract::from(MsgMigrateContract::try_from(raw_msg.clone()).unwrap()),
+            raw_msg,
+        )
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/msgs/mod.rs b/ibc-clients/ics08-wasm/types/src/msgs/mod.rs
new file mode 100644
index 000000000..d58ab8201
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/msgs/mod.rs
@@ -0,0 +1,4 @@
+//! Contains definitions of message types for the ICS-08 Wasm light client.
+pub mod migrate_contract;
+pub mod remove_checksum;
+pub mod store_code;
diff --git a/ibc-clients/ics08-wasm/types/src/msgs/remove_checksum.rs b/ibc-clients/ics08-wasm/types/src/msgs/remove_checksum.rs
new file mode 100644
index 000000000..9b84aac87
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/msgs/remove_checksum.rs
@@ -0,0 +1,55 @@
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
+use ibc_proto::ibc::lightclients::wasm::v1::MsgRemoveChecksum as RawMsgRemoveChecksum;
+use ibc_proto::Protobuf;
+
+use crate::Bytes;
+
+pub const REMOVE_CHECKSUM_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.MsgRemoveChecksum";
+
+/// Defines the message type for removing a checksum from the chain.
+#[derive(Clone, PartialEq, Debug, Eq)]
+pub struct MsgRemoveChecksum {
+    pub signer: Signer,
+    pub checksum: Bytes,
+}
+
+impl Protobuf<RawMsgRemoveChecksum> for MsgRemoveChecksum {}
+
+impl From<MsgRemoveChecksum> for RawMsgRemoveChecksum {
+    fn from(value: MsgRemoveChecksum) -> Self {
+        Self {
+            signer: value.signer.to_string(),
+            checksum: value.checksum,
+        }
+    }
+}
+
+impl From<RawMsgRemoveChecksum> for MsgRemoveChecksum {
+    fn from(value: RawMsgRemoveChecksum) -> Self {
+        Self {
+            signer: Signer::from(value.signer),
+            checksum: value.checksum,
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case("signer", b"checksum")]
+    fn test_roundtrip(#[case] signer: &str, #[case] checksum: &[u8]) {
+        let raw_msg = RawMsgRemoveChecksum {
+            signer: signer.to_string(),
+            checksum: checksum.to_vec(),
+        };
+        assert_eq!(
+            RawMsgRemoveChecksum::from(MsgRemoveChecksum::from(raw_msg.clone())),
+            raw_msg,
+        )
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/msgs/store_code.rs b/ibc-clients/ics08-wasm/types/src/msgs/store_code.rs
new file mode 100644
index 000000000..ca7818eac
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/msgs/store_code.rs
@@ -0,0 +1,55 @@
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
+use ibc_proto::ibc::lightclients::wasm::v1::MsgStoreCode as RawMsgStoreCode;
+use ibc_proto::Protobuf;
+
+use crate::Bytes;
+
+pub const STORE_CODE_TYPE_URL: &str = "/ibc.lightclients.wasm.v1.MsgStoreCode";
+
+/// Defines the message type for storing the Wasm byte code on the chain.
+#[derive(Clone, PartialEq, Debug, Eq)]
+pub struct MsgStoreCode {
+    pub signer: Signer,
+    pub wasm_byte_code: Bytes,
+}
+
+impl Protobuf<RawMsgStoreCode> for MsgStoreCode {}
+
+impl From<MsgStoreCode> for RawMsgStoreCode {
+    fn from(value: MsgStoreCode) -> Self {
+        Self {
+            signer: value.signer.to_string(),
+            wasm_byte_code: value.wasm_byte_code,
+        }
+    }
+}
+
+impl From<RawMsgStoreCode> for MsgStoreCode {
+    fn from(value: RawMsgStoreCode) -> Self {
+        Self {
+            signer: Signer::from(value.signer),
+            wasm_byte_code: value.wasm_byte_code,
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case("signer", b"wasm_data")]
+    fn test_roundtrip(#[case] signer: &str, #[case] wasm_byte_code: &[u8]) {
+        let raw_msg = RawMsgStoreCode {
+            signer: signer.to_string(),
+            wasm_byte_code: wasm_byte_code.to_vec(),
+        };
+        assert_eq!(
+            RawMsgStoreCode::from(MsgStoreCode::from(raw_msg.clone())),
+            raw_msg,
+        )
+    }
+}
diff --git a/ibc-clients/ics08-wasm/types/src/serializer.rs b/ibc-clients/ics08-wasm/types/src/serializer.rs
new file mode 100644
index 000000000..c44dc7325
--- /dev/null
+++ b/ibc-clients/ics08-wasm/types/src/serializer.rs
@@ -0,0 +1,46 @@
+use base64::prelude::BASE64_STANDARD;
+use base64::Engine;
+use ibc_primitives::prelude::*;
+use serde::de::Error;
+use serde::{Deserialize, Deserializer, Serialize, Serializer};
+
+pub struct Base64;
+
+impl Base64 {
+    pub fn serialize<S: Serializer>(bytes: &[u8], serializer: S) -> Result<S::Ok, S::Error> {
+        let encoded = BASE64_STANDARD.encode(bytes);
+        String::serialize(&encoded, serializer)
+    }
+
+    pub fn deserialize<'de, D: Deserializer<'de>>(deserializer: D) -> Result<Vec<u8>, D::Error> {
+        let base64 = String::deserialize(deserializer)?;
+        let bytes = BASE64_STANDARD
+            .decode(base64.as_bytes())
+            .map_err(Error::custom)?;
+
+        Ok(bytes)
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[derive(Serialize, Deserialize, PartialEq, Eq, Debug)]
+    struct Foo(#[serde(with = "Base64")] crate::Bytes);
+
+    // Ensures Base64 serialize and deserialize work as expected
+    #[rstest]
+    #[case(b"", "")]
+    #[case(&[118], "dg==")]
+    #[case(&[0x1, 0x2, 0x3, 0x4, 0x5], "AQIDBAU=")]
+    #[case(b"hello world", "aGVsbG8gd29ybGQ=")]
+    pub fn test_ser_and_deser(#[case] bytes: &[u8], #[case] hash: &str) {
+        let foo = Foo(bytes.to_vec());
+        let json = format!("\"{hash}\"");
+        assert_eq!(serde_json::to_string(&foo).unwrap(), json);
+        assert_eq!(serde_json::from_str::<Foo>(&json).unwrap(), foo);
+    }
+}
diff --git a/ibc-clients/src/lib.rs b/ibc-clients/src/lib.rs
index e3c426d06..da992dffe 100644
--- a/ibc-clients/src/lib.rs
+++ b/ibc-clients/src/lib.rs
@@ -16,3 +16,9 @@ pub mod tendermint {
     #[doc(inline)]
     pub use ibc_client_tendermint::*;
 }
+
+/// Re-exports implementations of ICS-08 Wasm light client types.
+pub mod wasm_types {
+    #[doc(inline)]
+    pub use ibc_client_wasm_types::*;
+}
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_type.rs b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
index ee14147f8..847f46452 100644
--- a/ibc-core/ics24-host/types/src/identifiers/client_type.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
@@ -63,3 +63,39 @@ impl FromStr for ClientType {
         Self::new(s)
     }
 }
+
+#[cfg(test)]
+mod test {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case::tendermint("07-tendermint")]
+    #[case::wasm("08-wasm")]
+    #[case::zero_double_digits("00-dummy")]
+    #[case::zero_single_digit("0-dummy")]
+    #[case::length_seven("1234567")]
+    fn client_type_from_str(#[case] client_str: &str) {
+        let client_type = ClientType::from_str(client_str).unwrap();
+        assert_eq!(client_type.as_str(), client_str);
+    }
+
+    #[rstest]
+    #[case::length_less_than_seven("00-foo")]
+    #[case::length_six("123456")]
+    fn client_type_from_str_fails(#[case] client_str: &str) {
+        let client_type = ClientType::from_str(client_str);
+        assert!(client_type.is_err());
+    }
+
+    #[rstest]
+    #[case::tendermint("07-tendermint", 118)]
+    #[case::wasm("08-wasm", 2)]
+    #[case::zero_counter("01-dummy", 0)]
+    fn client_type_build_client_id(#[case] client_str: &str, #[case] counter: u64) {
+        let client_type = ClientType::from_str(client_str).unwrap();
+        let client_id = client_type.build_client_id(counter);
+        assert_eq!(client_id.as_str(), format!("{}-{}", client_str, counter));
+    }
+}

From bc3bccafbff73096cecf1853bd40ed4ee239fda5 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 18 Jan 2024 07:33:39 -0800
Subject: [PATCH 092/182] chore: add missing domain and proto type re-exports
 (#1041)

* chore: re-export missing types

* nit: cargo fmt

* changelog fmt

* whitespace nits

* fix: introduce missing cosmwasm feature

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../1041-re-export-missing-types.md           |  2 ++
 .../ics07-tendermint/src/client_state.rs      |  2 +-
 ibc-clients/ics07-tendermint/types/src/lib.rs |  5 +--
 ibc-clients/ics08-wasm/types/src/lib.rs       |  5 +++
 ibc-data-types/Cargo.toml                     | 35 +++++++++++++------
 ibc-data-types/src/lib.rs                     | 15 ++++++++
 6 files changed, 48 insertions(+), 16 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1041-re-export-missing-types.md

diff --git a/.changelog/unreleased/improvements/1041-re-export-missing-types.md b/.changelog/unreleased/improvements/1041-re-export-missing-types.md
new file mode 100644
index 000000000..eff7dec39
--- /dev/null
+++ b/.changelog/unreleased/improvements/1041-re-export-missing-types.md
@@ -0,0 +1,2 @@
+- [ibc-data-types] Re-export clients' domain type from `ibc-data-types`
+  ([\#1041](https://github.com/cosmos/ibc-rs/pull/1041)).
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 32fcc5a57..f9c7eb332 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -10,7 +10,6 @@
 
 use ibc_client_tendermint_types::error::Error;
 use ibc_client_tendermint_types::proto::v1::ClientState as RawTmClientState;
-use ibc_client_tendermint_types::proto::{Any, Protobuf};
 use ibc_client_tendermint_types::{
     client_type as tm_client_type, ClientState as ClientStateType,
     ConsensusState as ConsensusStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
@@ -32,6 +31,7 @@ use ibc_core_host::types::path::{
 };
 use ibc_core_host::ExecutionContext;
 use ibc_primitives::prelude::*;
+use ibc_primitives::proto::{Any, Protobuf};
 use ibc_primitives::ToVec;
 
 use super::consensus_state::ConsensusState as TmConsensusState;
diff --git a/ibc-clients/ics07-tendermint/types/src/lib.rs b/ibc-clients/ics07-tendermint/types/src/lib.rs
index 6d312d9c3..aa0e021f6 100644
--- a/ibc-clients/ics07-tendermint/types/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/types/src/lib.rs
@@ -36,12 +36,9 @@ pub use trust_threshold::*;
 
 pub mod error;
 
-/// Re-exports necessary proto types for Tendermint light client implementation
-/// from `ibc-proto` crate.
+/// Re-exports ICS-07 Tendermint light client from `ibc-proto` crate.
 pub mod proto {
-    pub use ibc_proto::google::protobuf::Any;
     pub use ibc_proto::ibc::lightclients::tendermint::*;
-    pub use ibc_proto::Protobuf;
 }
 
 pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
diff --git a/ibc-clients/ics08-wasm/types/src/lib.rs b/ibc-clients/ics08-wasm/types/src/lib.rs
index d1cbdf51a..0ef9eda55 100644
--- a/ibc-clients/ics08-wasm/types/src/lib.rs
+++ b/ibc-clients/ics08-wasm/types/src/lib.rs
@@ -27,6 +27,11 @@ use ibc_core_host_types::identifiers::ClientType;
 use ibc_primitives::prelude::Vec;
 pub type Bytes = Vec<u8>;
 
+/// Re-exports ICS-08 Wasm light client proto types from `ibc-proto` crate.
+pub mod proto {
+    pub use ibc_proto::ibc::lightclients::wasm::*;
+}
+
 pub static SUBJECT_PREFIX: &[u8] = b"subject/";
 pub static SUBSTITUTE_PREFIX: &[u8] = b"substitute/";
 
diff --git a/ibc-data-types/Cargo.toml b/ibc-data-types/Cargo.toml
index d47bd254e..00830d562 100644
--- a/ibc-data-types/Cargo.toml
+++ b/ibc-data-types/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc"]
 readme       = "README.md"
 description  = """
-    Maintained by `ibc-rs`, delineates standard data structures and domain types of the Inter-Blockchain Communication (IBC) protocol. 
+    Maintained by `ibc-rs`, delineates standard data structures and domain types of the Inter-Blockchain Communication (IBC) protocol.
     Designed for universal application, enabling diverse projects across IBC ecosystem to build using a shared language.
 """
 
@@ -17,15 +17,17 @@ description  = """
 all-features = true
 
 [dependencies]
-ibc-app-transfer-types    = { workspace = true }
-ibc-core-client-types     = { workspace = true }
-ibc-core-connection-types = { workspace = true }
-ibc-core-channel-types    = { workspace = true }
-ibc-core-commitment-types = { workspace = true }
-ibc-core-host-types       = { workspace = true }
-ibc-core-router-types     = { workspace = true }
-ibc-core-handler-types    = { workspace = true }
-ibc-primitives            = { workspace = true }
+ibc-app-transfer-types      = { workspace = true }
+ibc-core-client-types       = { workspace = true }
+ibc-core-connection-types   = { workspace = true }
+ibc-core-channel-types      = { workspace = true }
+ibc-core-commitment-types   = { workspace = true }
+ibc-core-host-types         = { workspace = true }
+ibc-core-router-types       = { workspace = true }
+ibc-core-handler-types      = { workspace = true }
+ibc-client-tendermint-types = { workspace = true }
+ibc-client-wasm-types       = { workspace = true }
+ibc-primitives              = { workspace = true }
 
 [features]
 default = ["std"]
@@ -38,6 +40,8 @@ std = [
     "ibc-core-host-types/std",
     "ibc-core-router-types/std",
     "ibc-core-handler-types/std",
+    "ibc-client-tendermint-types/std",
+    "ibc-client-wasm-types/std",
     "ibc-primitives/std",
 ]
 serde = [
@@ -49,6 +53,8 @@ serde = [
     "ibc-core-host-types/serde",
     "ibc-core-router-types/serde",
     "ibc-core-handler-types/serde",
+    "ibc-client-tendermint-types/serde",
+    "ibc-client-wasm-types/serde",
     "ibc-primitives/serde",
 ]
 borsh = [
@@ -59,6 +65,7 @@ borsh = [
     "ibc-core-host-types/borsh",
     "ibc-core-router-types/borsh",
     "ibc-core-handler-types/borsh",
+    "ibc-client-tendermint-types/borsh",
     "ibc-primitives/borsh",
 ]
 schema = [
@@ -69,6 +76,8 @@ schema = [
     "ibc-core-host-types/schema",
     "ibc-core-router-types/schema",
     "ibc-core-handler-types/schema",
+    "ibc-client-tendermint-types/schema",
+    "ibc-client-wasm-types/schema",
     "ibc-primitives/schema",
 ]
 parity-scale-codec = [
@@ -79,5 +88,9 @@ parity-scale-codec = [
     "ibc-core-host-types/parity-scale-codec",
     "ibc-core-router-types/parity-scale-codec",
     "ibc-core-handler-types/parity-scale-codec",
+    "ibc-client-tendermint-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
-]
\ No newline at end of file
+]
+cosmwasm = [
+    "ibc-client-wasm-types/cosmwasm",
+]
diff --git a/ibc-data-types/src/lib.rs b/ibc-data-types/src/lib.rs
index 9e849a593..6056d869e 100644
--- a/ibc-data-types/src/lib.rs
+++ b/ibc-data-types/src/lib.rs
@@ -66,6 +66,21 @@ pub mod core {
     }
 }
 
+pub mod clients {
+    /// Re-exports ICS-07 tendermint client data structures from the
+    /// `ibc-client-tendermint-types` crate
+    pub mod tendermint {
+        #[doc(inline)]
+        pub use ibc_client_tendermint_types::*;
+    }
+    /// Re-exports ICS-08 wasm client data structures from the
+    /// `ibc-client-wasm-types` crate
+    pub mod wasm {
+        #[doc(inline)]
+        pub use ibc_client_wasm_types::*;
+    }
+}
+
 /// Re-exports data structures of various IBC applications
 pub mod apps {
     /// Re-exports ICS-27 client update data structures from the

From ccef193cd657ae0452297e7b3367321a413d2f4e Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Thu, 18 Jan 2024 10:48:20 -0500
Subject: [PATCH 093/182] imp(ibc-testkit): remove field access of
 `MockContext` (#1046)

* move events and logs inside MockIbcStore

* add getters for ibc events and logs

* refactor tests

* add doc strings

* add changelog
---
 ...1043-remove-field-access-of-mockcontext.md |  2 ++
 ibc-testkit/src/fixtures/core/context.rs      |  2 --
 ibc-testkit/src/testapp/ibc/core/core_ctx.rs  |  4 +--
 ibc-testkit/src/testapp/ibc/core/types.rs     | 26 +++++++++++--------
 .../tests/core/ics02_client/update_client.rs  | 13 ++++++----
 .../tests/core/ics02_client/upgrade_client.rs |  5 ++--
 .../core/ics03_connection/conn_open_ack.rs    |  7 ++---
 .../ics03_connection/conn_open_confirm.rs     |  7 ++---
 .../core/ics03_connection/conn_open_init.rs   |  8 +++---
 .../core/ics03_connection/conn_open_try.rs    |  8 +++---
 .../core/ics04_channel/acknowledgement.rs     | 16 +++++++-----
 .../core/ics04_channel/chan_close_confirm.rs  | 11 ++++----
 .../core/ics04_channel/chan_close_init.rs     |  8 +++---
 .../tests/core/ics04_channel/chan_open_ack.rs |  8 +++---
 .../core/ics04_channel/chan_open_confirm.rs   |  8 +++---
 .../core/ics04_channel/chan_open_init.rs      |  8 +++---
 .../tests/core/ics04_channel/chan_open_try.rs |  8 +++---
 .../tests/core/ics04_channel/recv_packet.rs   | 12 +++++----
 .../tests/core/ics04_channel/send_packet.rs   | 10 ++++---
 .../tests/core/ics04_channel/timeout.rs       | 20 ++++++++------
 ibc-testkit/tests/core/router.rs              |  6 +++--
 21 files changed, 117 insertions(+), 80 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md

diff --git a/.changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md b/.changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md
new file mode 100644
index 000000000..8b0470932
--- /dev/null
+++ b/.changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md
@@ -0,0 +1,2 @@
+- [ibc-testkit] Remove field access of `MockContext`.
+  ([\#1043](https://github.com/cosmos/ibc-rs/issues/1043))
diff --git a/ibc-testkit/src/fixtures/core/context.rs b/ibc-testkit/src/fixtures/core/context.rs
index 9d1e0e345..bf3ed2a7d 100644
--- a/ibc-testkit/src/fixtures/core/context.rs
+++ b/ibc-testkit/src/fixtures/core/context.rs
@@ -120,8 +120,6 @@ impl From<MockContextConfig> for MockContext {
             history,
             block_time: params.block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-            events: Vec::new(),
-            logs: Vec::new(),
         }
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index 1dc063ded..5c561d14e 100644
--- a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -543,12 +543,12 @@ impl ExecutionContext for MockContext {
     }
 
     fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
-        self.events.push(event);
+        self.ibc_store.lock().events.push(event);
         Ok(())
     }
 
     fn log_message(&mut self, message: String) -> Result<(), ContextError> {
-        self.logs.push(message);
+        self.ibc_store.lock().logs.push(message);
         Ok(())
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index e8c6d2972..64f39a6ff 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -91,8 +91,14 @@ pub struct MockIbcStore {
     /// Constant-size commitments to packets data fields
     pub packet_commitment: PortChannelIdMap<BTreeMap<Sequence, PacketCommitment>>,
 
-    // Used by unordered channel
+    /// Used by unordered channel
     pub packet_receipt: PortChannelIdMap<BTreeMap<Sequence, Receipt>>,
+
+    /// Emitted IBC events in order
+    pub events: Vec<IbcEvent>,
+
+    /// Logs of the IBC module
+    pub logs: Vec<String>,
 }
 
 /// A context implementing the dependencies necessary for testing any IBC module.
@@ -116,10 +122,6 @@ pub struct MockContext {
 
     /// An object that stores all IBC related data.
     pub ibc_store: Arc<Mutex<MockIbcStore>>,
-
-    pub events: Vec<IbcEvent>,
-
-    pub logs: Vec<String>,
 }
 
 #[derive(Debug, TypedBuilder)]
@@ -170,8 +172,6 @@ impl Clone for MockContext {
             history: self.history.clone(),
             block_time: self.block_time,
             ibc_store,
-            events: self.events.clone(),
-            logs: self.logs.clone(),
         }
     }
 }
@@ -232,8 +232,6 @@ impl MockContext {
                 .collect(),
             block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-            events: Vec::new(),
-            logs: Vec::new(),
         }
     }
 
@@ -299,8 +297,6 @@ impl MockContext {
             history,
             block_time,
             ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-            events: Vec::new(),
-            logs: Vec::new(),
         }
     }
 
@@ -781,6 +777,14 @@ impl MockContext {
         let block_ref = self.host_block(&self.host_height().expect("Never fails"));
         block_ref.cloned()
     }
+
+    pub fn get_events(&self) -> Vec<IbcEvent> {
+        self.ibc_store.lock().events.clone()
+    }
+
+    pub fn get_logs(&self) -> Vec<String> {
+        self.ibc_store.lock().logs.clone()
+    }
 }
 
 #[cfg(test)]
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 67c52d41c..ab04489ec 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -676,11 +676,13 @@ fn test_update_client_events() {
     let res = execute(&mut ctx, &mut router, msg_envelope);
     assert!(res.is_ok());
 
+    let ibc_events = ctx.get_events();
+
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Client)
     ));
-    let update_client_event = downcast!(&ctx.events[1] => IbcEvent::UpdateClient).unwrap();
+    let update_client_event = downcast!(&ibc_events[1] => IbcEvent::UpdateClient).unwrap();
 
     assert_eq!(update_client_event.client_id(), &client_id);
     assert_eq!(update_client_event.client_type(), &mock_client_type());
@@ -696,13 +698,14 @@ fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &Cl
     assert!(status.is_frozen(), "client_state status: {status}");
 
     // check events
-    assert_eq!(ctx.events.len(), 2);
+    let ibc_events = ctx.get_events();
+    assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Client),
     ));
     let misbehaviour_client_event =
-        downcast!(&ctx.events[1] => IbcEvent::ClientMisbehaviour).unwrap();
+        downcast!(&ibc_events[1] => IbcEvent::ClientMisbehaviour).unwrap();
     assert_eq!(misbehaviour_client_event.client_id(), client_id);
     assert_eq!(misbehaviour_client_event.client_type(), client_type);
 }
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index 409576f0b..dd097935f 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -94,12 +94,13 @@ fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
         }
         Expect::Success => {
             assert!(res.is_ok(), "{err_msg}");
+            let ibc_events = fxt.ctx.get_events();
             assert!(matches!(
-                fxt.ctx.events[0],
+                ibc_events[0],
                 IbcEvent::Message(MessageEvent::Client)
             ));
             let upgrade_client_event =
-                downcast!(&fxt.ctx.events[1] => IbcEvent::UpgradeClient).unwrap();
+                downcast!(&ibc_events[1] => IbcEvent::UpgradeClient).unwrap();
             let plan_height = Height::new(1, 26).unwrap();
 
             assert_eq!(upgrade_client_event.client_id(), &fxt.msg.client_id);
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 7987f355e..62f0ca2f3 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -130,14 +130,15 @@ fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect
             assert!(res.is_err(), "{err_msg}");
         }
         Expect::Success => {
+            let ibc_events = fxt.ctx.get_events();
             assert!(res.is_ok(), "{err_msg}");
-            assert_eq!(fxt.ctx.events.len(), 2);
+            assert_eq!(ibc_events.len(), 2);
 
             assert!(matches!(
-                fxt.ctx.events[0],
+                ibc_events[0],
                 IbcEvent::Message(MessageEvent::Connection)
             ));
-            let event = &fxt.ctx.events[1];
+            let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenAckConnection(_)));
 
             let conn_open_try_event = match event {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index 94321028d..fe83a003b 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -84,14 +84,15 @@ fn conn_open_confirm_execute(fxt: &mut Fixture<MsgConnectionOpenConfirm>, expect
             assert!(res.is_err(), "{err_msg}");
         }
         Expect::Success => {
+            let ibc_events = fxt.ctx.get_events();
             assert!(res.is_ok(), "{err_msg}");
-            assert_eq!(fxt.ctx.events.len(), 2);
+            assert_eq!(ibc_events.len(), 2);
 
             assert!(matches!(
-                fxt.ctx.events[0],
+                ibc_events[0],
                 IbcEvent::Message(MessageEvent::Connection)
             ));
-            let event = &fxt.ctx.events[1];
+            let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenConfirmConnection(_)));
 
             let conn_open_try_event = match event {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index deee41dba..796c352ad 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -79,17 +79,19 @@ fn conn_open_init_execute(
             assert!(res.is_err(), "{err_msg}")
         }
         Expect::Success => {
+            let ibc_events = fxt.ctx.get_events();
+
             assert!(res.is_ok(), "{err_msg}");
 
             assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
 
-            assert_eq!(fxt.ctx.events.len(), 2);
+            assert_eq!(ibc_events.len(), 2);
 
             assert!(matches!(
-                fxt.ctx.events[0],
+                ibc_events[0],
                 IbcEvent::Message(MessageEvent::Connection)
             ));
-            let event = &fxt.ctx.events[1];
+            let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenInitConnection(_)));
 
             let conn_open_init_event = match event {
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index 44a5160cc..63487221f 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -96,13 +96,15 @@ fn conn_open_try_execute(fxt: &mut Fixture<MsgConnectionOpenTry>, expect: Expect
 
             assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
 
-            assert_eq!(fxt.ctx.events.len(), 2);
+            let ibc_events = fxt.ctx.get_events();
+
+            assert_eq!(ibc_events.len(), 2);
 
             assert!(matches!(
-                fxt.ctx.events[0],
+                ibc_events[0],
                 IbcEvent::Message(MessageEvent::Connection)
             ));
-            let event = &fxt.ctx.events[1];
+            let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenTryConnection(_)));
 
             let conn_open_try_event = match event {
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index 2f5872bfe..c6d84ce47 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -217,12 +217,14 @@ fn ack_unordered_chan_execute(fixture: Fixture) {
 
     assert!(res.is_ok());
 
-    assert_eq!(ctx.events.len(), 2);
+    let ibc_events = ctx.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::AcknowledgePacket(_)));
 }
 
 #[rstest]
@@ -256,10 +258,12 @@ fn ack_ordered_chan_execute(fixture: Fixture) {
 
     assert!(res.is_ok());
 
-    assert_eq!(ctx.events.len(), 2);
+    let ibc_events = ctx.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::AcknowledgePacket(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::AcknowledgePacket(_)));
 }
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index 32c8dbb1f..8133fb7f0 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -121,15 +121,14 @@ fn test_chan_close_confirm_execute() {
 
     assert!(res.is_ok(), "Execution success: happy path");
 
-    assert_eq!(context.events.len(), 2);
+    let ibc_events = context.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
 
     assert!(matches!(
-        context.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
 
-    assert!(matches!(
-        context.events[1],
-        IbcEvent::CloseConfirmChannel(_)
-    ));
+    assert!(matches!(ibc_events[1], IbcEvent::CloseConfirmChannel(_)));
 }
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 658a9a978..3518c7280 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -123,12 +123,14 @@ fn test_chan_close_init_execute() {
 
     assert!(res.is_ok(), "Execution happy path");
 
-    assert_eq!(context.events.len(), 2);
+    let ibc_events = context.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
 
     assert!(matches!(
-        context.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
 
-    assert!(matches!(context.events[1], IbcEvent::CloseInitChannel(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::CloseInitChannel(_)));
 }
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index e652a2a7a..74c1f0d9e 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -134,12 +134,14 @@ fn chan_open_ack_execute_happy_path(fixture: Fixture) {
 
     assert!(res.is_ok(), "Execution happy path");
 
-    assert_eq!(context.events.len(), 2);
+    let ibc_events = context.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
-        context.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(context.events[1], IbcEvent::OpenAckChannel(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::OpenAckChannel(_)));
 }
 
 #[rstest]
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index d7b74a907..4dc209817 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -131,14 +131,16 @@ fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
 
     assert!(res.is_ok(), "Execution happy path");
 
-    assert_eq!(context.events.len(), 2);
+    let ibc_events = context.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
 
     assert!(matches!(
-        context.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
 
-    assert!(matches!(context.events[1], IbcEvent::OpenConfirmChannel(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::OpenConfirmChannel(_)));
 }
 
 #[rstest]
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index 23077a7f0..f139bbeaa 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -94,13 +94,15 @@ fn chan_open_init_execute_happy_path(fixture: Fixture) {
 
     assert_eq!(ctx.channel_counter().unwrap(), 1);
 
-    assert_eq!(ctx.events.len(), 2);
+    let ibc_events = ctx.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
 
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::OpenInitChannel(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::OpenInitChannel(_)));
 }
 
 #[rstest]
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index 9720afe81..c9de6454c 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -114,13 +114,15 @@ fn chan_open_try_execute_happy_path(fixture: Fixture) {
 
     assert_eq!(ctx.channel_counter().unwrap(), 1);
 
-    assert_eq!(ctx.events.len(), 2);
+    let ibc_events = ctx.get_events();
+
+    assert_eq!(ibc_events.len(), 2);
 
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::OpenTryChannel(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::OpenTryChannel(_)));
 }
 
 #[rstest]
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 20a7c97ab..7afa94ac8 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -231,15 +231,17 @@ fn recv_packet_execute_happy_path(fixture: Fixture) {
 
     assert!(res.is_ok());
 
-    assert_eq!(ctx.events.len(), 4);
+    let ibc_events = ctx.get_events();
+
+    assert_eq!(ibc_events.len(), 4);
     assert!(matches!(
-        &ctx.events[0],
+        &ibc_events[0],
         &IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(&ctx.events[1], &IbcEvent::ReceivePacket(_)));
+    assert!(matches!(&ibc_events[1], &IbcEvent::ReceivePacket(_)));
     assert!(matches!(
-        &ctx.events[2],
+        &ibc_events[2],
         &IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(&ctx.events[3], &IbcEvent::WriteAcknowledgement(_)));
+    assert!(matches!(&ibc_events[3], &IbcEvent::WriteAcknowledgement(_)));
 }
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index 2ae01f6cf..7a9659d55 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -160,15 +160,17 @@ fn send_packet_processing() {
                         test.ctx.clone()
                     );
 
-                assert!(!test.ctx.events.is_empty()); // Some events must exist.
+                let ibc_events = test.ctx.get_events();
 
-                assert_eq!(test.ctx.events.len(), 2);
+                assert!(!ibc_events.is_empty()); // Some events must exist.
+
+                assert_eq!(ibc_events.len(), 2);
                 assert!(matches!(
-                    &test.ctx.events[0],
+                    &ibc_events[0],
                     &IbcEvent::Message(MessageEvent::Channel)
                 ));
                 // TODO: The object in the output is a PacketResult what can we check on it?
-                assert!(matches!(&test.ctx.events[1], &IbcEvent::SendPacket(_)));
+                assert!(matches!(&ibc_events[1], &IbcEvent::SendPacket(_)));
             }
             Err(e) => {
                 assert!(
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index 37556b612..2e20bb160 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -376,13 +376,15 @@ fn timeout_unordered_chan_execute(fixture: Fixture) {
 
     assert!(res.is_ok());
 
+    let ibc_events = ctx.get_events();
+
     // Unordered channels only emit one event
-    assert_eq!(ctx.events.len(), 2);
+    assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::TimeoutPacket(_)));
 }
 
 #[rstest]
@@ -416,16 +418,18 @@ fn timeout_ordered_chan_execute(fixture: Fixture) {
 
     assert!(res.is_ok());
 
+    let ibc_events = ctx.get_events();
+
     // Ordered channels emit 2 events
-    assert_eq!(ctx.events.len(), 4);
+    assert_eq!(ibc_events.len(), 4);
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[1], IbcEvent::TimeoutPacket(_)));
+    assert!(matches!(ibc_events[1], IbcEvent::TimeoutPacket(_)));
     assert!(matches!(
-        ctx.events[2],
+        ibc_events[2],
         IbcEvent::Message(MessageEvent::Channel)
     ));
-    assert!(matches!(ctx.events[3], IbcEvent::ChannelClosed(_)));
+    assert!(matches!(ibc_events[3], IbcEvent::ChannelClosed(_)));
 }
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index 327c09642..70756530f 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -190,12 +190,14 @@ fn routing_module_and_keepers() {
             "ICS26 routing dispatch test 'client creation' failed for message {create_client_msg:?} with result: {res:?}",
         );
 
+    let ibc_events = ctx.get_events();
+
     // Figure out the ID of the client that was just created.
     assert!(matches!(
-        ctx.events[0],
+        ibc_events[0],
         IbcEvent::Message(MessageEvent::Client)
     ));
-    let client_id_event = ctx.events.get(1);
+    let client_id_event = ibc_events.get(1);
     assert!(
         client_id_event.is_some(),
         "There was no event generated for client creation!"

From ee92645e050f552bee9acdd17ba6468a624c710c Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 19 Jan 2024 08:35:16 -0500
Subject: [PATCH 094/182] imp(ibc-testkit): deprecate `MockContext` multiple
 init methods (#1047)

* deprecate default arg init methods in MockContext

* refactor tests

* add changelog

* chore: trim redundant method calls, opting for default values

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1042-deprecate-mockcontext-new-methods.md |   2 +
 ibc-testkit/src/fixtures/core/context.rs      |   2 +
 ibc-testkit/src/relayer/context.rs            |  47 ++---
 ibc-testkit/src/testapp/ibc/core/types.rs     | 131 +++++++-------
 .../tests/core/ics02_client/update_client.rs  | 168 +++++++++---------
 .../core/ics03_connection/conn_open_ack.rs    |  13 +-
 .../core/ics03_connection/conn_open_try.rs    |  13 +-
 7 files changed, 186 insertions(+), 190 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md

diff --git a/.changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md b/.changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md
new file mode 100644
index 000000000..7acac9522
--- /dev/null
+++ b/.changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md
@@ -0,0 +1,2 @@
+- [ibc-testkit] Deprecate `MockContext::new*` in favor of `MockContextConfig`.
+  ([\#1042](https://github.com/cosmos/ibc-rs/issues/1042))
diff --git a/ibc-testkit/src/fixtures/core/context.rs b/ibc-testkit/src/fixtures/core/context.rs
index bf3ed2a7d..a886777e7 100644
--- a/ibc-testkit/src/fixtures/core/context.rs
+++ b/ibc-testkit/src/fixtures/core/context.rs
@@ -21,6 +21,7 @@ pub struct MockContextConfig {
     #[builder(default = HostType::Mock)]
     host_type: HostType,
 
+    #[builder(default = ChainId::new("mockgaia-0").expect("Never fails"))]
     host_id: ChainId,
 
     #[builder(default = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS))]
@@ -33,6 +34,7 @@ pub struct MockContextConfig {
     #[builder(default, setter(strip_option))]
     validator_set_history: Option<Vec<Vec<TestgenValidator>>>,
 
+    #[builder(default = Height::new(0, 5).expect("Never fails"))]
     latest_height: Height,
 
     #[builder(default = Timestamp::now())]
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index d2576f264..c80737603 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -52,12 +52,12 @@ mod tests {
     use tracing::debug;
 
     use super::RelayerContext;
+    use crate::fixtures::core::context::MockContextConfig;
     use crate::hosts::block::{HostBlock, HostType};
     use crate::relayer::context::ClientId;
     use crate::relayer::error::RelayerError;
     use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
     use crate::testapp::ibc::core::router::MockRouter;
-    use crate::testapp::ibc::core::types::MockContext;
 
     /// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
     /// context, assuming that the latest header on the source context is `src_header`.
@@ -121,31 +121,32 @@ mod tests {
         let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
         // Create two mock contexts, one for each chain.
-        let mut ctx_a =
-            MockContext::new(chain_id_a.clone(), HostType::Mock, 5, chain_a_start_height)
-                .with_client_parametrized_with_chain_id(
-                    chain_id_b.clone(),
-                    &client_on_a_for_b,
-                    client_on_a_for_b_height,
-                    Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-                    Some(client_on_a_for_b_height),
-                );
+        let mut ctx_a = MockContextConfig::builder()
+            .host_id(chain_id_a.clone())
+            .latest_height(chain_a_start_height)
+            .build()
+            .with_client_parametrized_with_chain_id(
+                chain_id_b.clone(),
+                &client_on_a_for_b,
+                client_on_a_for_b_height,
+                Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+                Some(client_on_a_for_b_height),
+            );
         // dummy; not actually used in client updates
         let mut router_a = MockRouter::new_with_transfer();
 
-        let mut ctx_b = MockContext::new(
-            chain_id_b,
-            HostType::SyntheticTendermint,
-            5,
-            chain_b_start_height,
-        )
-        .with_client_parametrized_with_chain_id(
-            chain_id_a,
-            &client_on_b_for_a,
-            client_on_b_for_a_height,
-            Some(mock_client_type()), // The target host chain is mock.
-            Some(client_on_b_for_a_height),
-        );
+        let mut ctx_b = MockContextConfig::builder()
+            .host_id(chain_id_b)
+            .host_type(HostType::SyntheticTendermint)
+            .latest_height(chain_b_start_height)
+            .build()
+            .with_client_parametrized_with_chain_id(
+                chain_id_a,
+                &client_on_b_for_a,
+                client_on_b_for_a_height,
+                Some(mock_client_type()), // The target host chain is mock.
+                Some(client_on_b_for_a_height),
+            );
         // dummy; not actually used in client updates
         let mut router_b = MockRouter::new_with_transfer();
 
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index 64f39a6ff..e9c914cb1 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -33,6 +33,7 @@ use super::client_ctx::{MockClientRecord, PortChannelIdMap};
 use crate::fixtures::clients::tendermint::{
     dummy_tm_client_state_from_header, ClientStateConfig as TmClientStateConfig,
 };
+use crate::fixtures::core::context::MockContextConfig;
 use crate::hosts::block::{HostBlock, HostType};
 use crate::relayer::error::RelayerError;
 use crate::testapp::ibc::clients::mock::client_state::{
@@ -147,12 +148,7 @@ pub struct MockClientConfig {
 /// creation of new domain objects.
 impl Default for MockContext {
     fn default() -> Self {
-        Self::new(
-            ChainId::new("mockgaia-0").expect("Never fails"),
-            HostType::Mock,
-            5,
-            Height::new(0, 5).expect("Never fails"),
-        )
+        MockContextConfig::builder().build()
     }
 }
 
@@ -183,6 +179,10 @@ impl MockContext {
     /// the chain maintain in its history, which also determines the pruning window. Parameter
     /// `latest_height` determines the current height of the chain. This context
     /// has support to emulate two type of underlying chains: Mock or SyntheticTendermint.
+    #[deprecated(
+        since = "0.49.2",
+        note = "Please use `MockContextConfig::builder().build()` instead"
+    )]
     pub fn new(
         host_id: ChainId,
         host_type: HostType,
@@ -239,6 +239,10 @@ impl MockContext {
     /// Note: the validator history is used accordingly for current validator set and next validator set.
     /// `validator_history[i]` and `validator_history[i+1]` is i'th block's current and next validator set.
     /// The number of blocks will be `validator_history.len() - 1` due to the above.
+    #[deprecated(
+        since = "0.49.2",
+        note = "Please use `MockContextConfig::builder().build()` instead"
+    )]
     pub fn new_with_validator_history(
         host_id: ChainId,
         host_type: HostType,
@@ -816,93 +820,88 @@ mod tests {
         let tests: Vec<Test> = vec![
             Test {
                 name: "Empty history, small pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::Mock,
-                    2,
-                    Height::new(cv, 1).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .max_history_size(2)
+                    .latest_height(Height::new(cv, 1).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "[Synthetic TM host] Empty history, small pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::SyntheticTendermint,
-                    2,
-                    Height::new(cv, 1).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .host_type(HostType::SyntheticTendermint)
+                    .max_history_size(2)
+                    .latest_height(Height::new(cv, 1).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "Large pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::Mock,
-                    30,
-                    Height::new(cv, 2).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .max_history_size(30)
+                    .latest_height(Height::new(cv, 2).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "[Synthetic TM host] Large pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::SyntheticTendermint,
-                    30,
-                    Height::new(cv, 2).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .host_type(HostType::SyntheticTendermint)
+                    .max_history_size(30)
+                    .latest_height(Height::new(cv, 2).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "Small pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::Mock,
-                    3,
-                    Height::new(cv, 30).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .max_history_size(3)
+                    .latest_height(Height::new(cv, 30).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "[Synthetic TM host] Small pruning window".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::SyntheticTendermint,
-                    3,
-                    Height::new(cv, 30).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .host_type(HostType::SyntheticTendermint)
+                    .max_history_size(3)
+                    .latest_height(Height::new(cv, 30).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "Small pruning window, small starting height".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::Mock,
-                    3,
-                    Height::new(cv, 2).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .max_history_size(3)
+                    .latest_height(Height::new(cv, 2).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "[Synthetic TM host] Small pruning window, small starting height".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::SyntheticTendermint,
-                    3,
-                    Height::new(cv, 2).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .host_type(HostType::SyntheticTendermint)
+                    .max_history_size(3)
+                    .latest_height(Height::new(cv, 2).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "Large pruning window, large starting height".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id.clone(),
-                    HostType::Mock,
-                    50,
-                    Height::new(cv, 2000).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id.clone())
+                    .max_history_size(50)
+                    .latest_height(Height::new(cv, 2000).expect("Never fails"))
+                    .build(),
             },
             Test {
                 name: "[Synthetic TM host] Large pruning window, large starting height".to_string(),
-                ctx: MockContext::new(
-                    mock_chain_id,
-                    HostType::SyntheticTendermint,
-                    50,
-                    Height::new(cv, 2000).expect("Never fails"),
-                ),
+                ctx: MockContextConfig::builder()
+                    .host_id(mock_chain_id)
+                    .host_type(HostType::SyntheticTendermint)
+                    .max_history_size(50)
+                    .latest_height(Height::new(cv, 2000).expect("Never fails"))
+                    .build(),
             },
         ];
 
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index ab04489ec..95c983f08 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -203,23 +203,25 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let mut ctx = MockContext::new(
-        ChainId::new("mockgaiaA-1").unwrap(),
-        HostType::Mock,
-        5,
-        Height::new(1, 1).unwrap(),
-    )
-    .with_client_parametrized_with_chain_id(
-        chain_id_b.clone(),
-        &client_id,
-        client_height,
-        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-        Some(client_height),
-    );
+    let mut ctx = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_parametrized_with_chain_id(
+            chain_id_b.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+            Some(client_height),
+        );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
+    let ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b)
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(update_height)
+        .build();
 
     let signer = dummy_account_id();
 
@@ -433,23 +435,25 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let mut ctx = MockContext::new(
-        ChainId::new("mockgaiaA-1").unwrap(),
-        HostType::Mock,
-        5,
-        Height::new(1, 1).unwrap(),
-    )
-    .with_client_parametrized_history_with_chain_id(
-        chain_id_b.clone(),
-        &client_id,
-        client_height,
-        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-        Some(client_height),
-    );
+    let mut ctx = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_parametrized_history_with_chain_id(
+            chain_id_b.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+            Some(client_height),
+        );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContext::new(chain_id_b, HostType::SyntheticTendermint, 5, update_height);
+    let ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b)
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(update_height)
+        .build();
 
     let signer = dummy_account_id();
 
@@ -491,7 +495,10 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
     let ctx_b_chain_id = ChainId::new("mockgaiaB-1").unwrap();
     let start_height = Height::new(1, 11).unwrap();
 
-    let mut ctx_a = MockContext::new(ctx_a_chain_id, HostType::Mock, 5, start_height)
+    let mut ctx_a = MockContextConfig::builder()
+        .host_id(ctx_a_chain_id)
+        .latest_height(start_height)
+        .build()
         .with_client_parametrized_with_chain_id(
             ctx_b_chain_id.clone(),
             &client_id,
@@ -502,12 +509,11 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
 
     let mut router_a = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContext::new(
-        ctx_b_chain_id,
-        HostType::SyntheticTendermint,
-        5,
-        client_height,
-    );
+    let ctx_b = MockContextConfig::builder()
+        .host_id(ctx_b_chain_id)
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(client_height)
+        .build();
 
     let signer = dummy_account_id();
 
@@ -617,27 +623,24 @@ fn test_update_synthetic_tendermint_client_lower_height() {
 
     let chain_start_height = Height::new(1, 11).unwrap();
 
-    let ctx = MockContext::new(
-        ChainId::new("mockgaiaA-1").unwrap(),
-        HostType::Mock,
-        5,
-        chain_start_height,
-    )
-    .with_client_parametrized(
-        &client_id,
-        client_height,
-        Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-        Some(client_height),
-    );
+    let ctx = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(chain_start_height)
+        .build()
+        .with_client_parametrized(
+            &client_id,
+            client_height,
+            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
+            Some(client_height),
+        );
 
     let router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContext::new(
-        ChainId::new("mockgaiaB-1").unwrap(),
-        HostType::SyntheticTendermint,
-        5,
-        client_height,
-    );
+    let ctx_b = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaB-1").unwrap())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(client_height)
+        .build();
 
     let signer = dummy_account_id();
 
@@ -774,29 +777,26 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
     // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-    let mut ctx_a = MockContext::new(
-        ChainId::new("mockgaiaA-1").unwrap(),
-        HostType::Mock,
-        5,
-        Height::new(1, 1).unwrap(),
-    )
-    .with_client_parametrized_with_chain_id(
-        chain_id_b.clone(),
-        &client_id,
-        client_height,
-        Some(tm_client_type()),
-        Some(client_height),
-    );
+    let mut ctx_a = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_parametrized_with_chain_id(
+            chain_id_b.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()),
+            Some(client_height),
+        );
 
     let mut router_a = MockRouter::new_with_transfer();
 
     // Create a mock context for chain-B
-    let ctx_b = MockContext::new(
-        chain_id_b.clone(),
-        HostType::SyntheticTendermint,
-        5,
-        misbehaviour_height,
-    );
+    let ctx_b = MockContextConfig::builder()
+        .host_id(chain_id_b.clone())
+        .host_type(HostType::SyntheticTendermint)
+        .latest_height(misbehaviour_height)
+        .build();
 
     // Get chain-B's header at `misbehaviour_height`
     let header1: TmHeader = {
@@ -838,19 +838,17 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
     // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-    let mut ctx_a = MockContext::new(
-        ChainId::new("mockgaiaA-1").unwrap(),
-        HostType::Mock,
-        5,
-        Height::new(1, 1).unwrap(),
-    )
-    .with_client_parametrized_with_chain_id(
-        chain_id_b.clone(),
-        &client_id,
-        client_height,
-        Some(tm_client_type()),
-        Some(client_height),
-    );
+    let mut ctx_a = MockContextConfig::builder()
+        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+        .latest_height(Height::new(1, 1).unwrap())
+        .build()
+        .with_client_parametrized_with_chain_id(
+            chain_id_b.clone(),
+            &client_id,
+            client_height,
+            Some(tm_client_type()),
+            Some(client_height),
+        );
 
     let mut router_a = MockRouter::new_with_transfer();
 
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 62f0ca2f3..1f7dd7828 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -14,8 +14,8 @@ use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::ZERO_DURATION;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_ack;
+use ibc_testkit::fixtures::core::context::MockContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
-use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use test_log::test;
@@ -38,7 +38,6 @@ fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
     // Parametrize the host chain to have a height at least as recent as the
     // the height of the proofs in the Ack msg.
     let latest_height = proof_height.increment();
-    let max_history_size = 5;
 
     // A connection end that will exercise the successful path.
     let default_conn_end = ConnectionEnd::new(
@@ -59,12 +58,10 @@ fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
     conn_end_open.set_state(State::Open); // incorrect field
 
     let ctx_default = MockContext::default();
-    let ctx_new = MockContext::new(
-        ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap(),
-        HostType::Mock,
-        max_history_size,
-        latest_height,
-    );
+    let ctx_new = MockContextConfig::builder()
+        .host_id(ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap())
+        .latest_height(latest_height)
+        .build();
     let ctx = match ctx {
         Ctx::New => ctx_new,
         Ctx::NewWithConnection => ctx_new
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index 63487221f..18c700ba4 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -4,12 +4,11 @@ use ibc::core::connection::types::State;
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::ChainId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_try;
+use ibc_testkit::fixtures::core::context::MockContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
-use ibc_testkit::hosts::block::HostType;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::MockContext;
 use test_log::test;
@@ -51,12 +50,10 @@ fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConne
         ),
     };
 
-    let ctx_new = MockContext::new(
-        ChainId::new("mockgaia-0").unwrap(),
-        HostType::Mock,
-        max_history_size,
-        host_chain_height,
-    );
+    let ctx_new = MockContextConfig::builder()
+        .max_history_size(max_history_size)
+        .latest_height(host_chain_height)
+        .build();
     let ctx = match ctx_variant {
         Ctx::Default => MockContext::default(),
         Ctx::WithClient => ctx_new.with_client(

From 91b632c8838a6c5356906332332f66a5ae9d3110 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 23 Jan 2024 17:40:37 -0800
Subject: [PATCH 095/182] feat: implement ICS-721 NFT transfer application
 (#1053)

* feat: establish ICS-721 boilerplate, ready for new additions (#1012)

* chore: establish ics721 boilerplate, ready for new additions

* nit

* Implement ICS-721 NFT transfer (#1020)

* WIP: add types and contexts

* WIP: add events

* WIP: implement modules

* add send_transfer

* add recv and refund handlers

* add tests

* fix send and recv

* fix context and add tests

* fix fmt

* fix for CI

* fix messages and serde

* fix comments

* Add (de)serialization tests for `DataValue`, `TokenUri`, and `ClassUri` types (#1027)

* WIP: add types and contexts

* WIP: add events

* WIP: implement modules

* add send_transfer

* add recv and refund handlers

* add tests

* fix send and recv

* fix context and add tests

* fix fmt

* fix for CI

* fix messages and serde

* fix comments

* Stub out DataValue Borsh unit test

* Add basic borsh (de)ser roundtrip tests

* Add basic serde roundtrip tests for DataValue

* Add json (de)serialization tests

* Add roundtrip tests for TokenUri

* Add roundtrip tests for ClassUri

* Remove ignore statement on a test

* Resolve clippy warning

* Change packet data dummy json strings to use camel case

* Configure nft-transfer app under std feature flag

* Move cfg statement

* Add nft-transfer feature

* Add nft-transfer feature

* Remove nft-transfer feature from default features

* Remove `optional = true` from `http` dependency

---------

Co-authored-by: yito88 <yuji@phact-columba.com>

* fix: calculate trace hash from both class ID and token ID (#1032)

* trace hash with class ID and token ID

* add serde flag

* Fix ClassData and TokenData encoding in NonFungiblePacketData (#1038)

* fix encoding for ClassData and TokenData

* fix Cargo.toml

* Support ClassData and TokenData not according to ICS-721 spec (#1039)

* skip validation, make some data optional

* check the length of token_uri and token_data

* fix to set TokenData and TokenUri at once

* imp: add validate_basic method for PacketData

* imp: allow any format for Data + define parse_as_ics721_data method

* fmt and clippy

* custom serde packet data with option

* add a test

* restore conversions

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* chore: add unclog

* nit: fix docstrings

---------

Co-authored-by: Yuji Ito <yito88@users.noreply.github.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Co-authored-by: yito88 <yuji@phact-columba.com>
---
 .../346-implement-ics721-nft-transfer.md      |   2 +
 Cargo.toml                                    |   4 +
 ci/no-std-check/Cargo.lock                    | 152 ++---
 ibc-apps/Cargo.toml                           |   7 +-
 ibc-apps/README.md                            |   5 +
 ibc-apps/ics721-nft-transfer/Cargo.toml       |  53 ++
 ibc-apps/ics721-nft-transfer/src/context.rs   | 199 ++++++
 .../ics721-nft-transfer/src/handler/mod.rs    |  85 +++
 .../src/handler/on_recv_packet.rs             | 137 ++++
 .../src/handler/send_transfer.rs              | 253 ++++++++
 ibc-apps/ics721-nft-transfer/src/lib.rs       |  33 +
 ibc-apps/ics721-nft-transfer/src/module.rs    | 386 +++++++++++
 ibc-apps/ics721-nft-transfer/types/Cargo.toml |  76 +++
 .../ics721-nft-transfer/types/src/class.rs    | 602 ++++++++++++++++++
 .../ics721-nft-transfer/types/src/data.rs     | 309 +++++++++
 .../ics721-nft-transfer/types/src/error.rs    | 140 ++++
 .../ics721-nft-transfer/types/src/events.rs   | 214 +++++++
 ibc-apps/ics721-nft-transfer/types/src/lib.rs |  69 ++
 .../ics721-nft-transfer/types/src/memo.rs     |  54 ++
 .../ics721-nft-transfer/types/src/msgs/mod.rs |   2 +
 .../types/src/msgs/transfer.rs                | 138 ++++
 .../ics721-nft-transfer/types/src/packet.rs   | 324 ++++++++++
 .../types/src/serializers.rs                  |  27 +
 .../ics721-nft-transfer/types/src/token.rs    | 268 ++++++++
 ibc-apps/src/lib.rs                           |   9 +
 ibc-primitives/src/prelude.rs                 |   1 +
 .../src/testapp/ibc/applications/mod.rs       |   1 +
 .../ibc/applications/nft_transfer/context.rs  | 185 ++++++
 .../ibc/applications/nft_transfer/mod.rs      |   4 +
 .../ibc/applications/nft_transfer/module.rs   | 107 ++++
 .../ibc/applications/nft_transfer/types.rs    |  61 ++
 ibc-testkit/tests/applications/mod.rs         |   2 +
 .../tests/applications/nft_transfer.rs        | 135 ++++
 33 files changed, 3940 insertions(+), 104 deletions(-)
 create mode 100644 .changelog/unreleased/features/346-implement-ics721-nft-transfer.md
 create mode 100644 ibc-apps/ics721-nft-transfer/Cargo.toml
 create mode 100644 ibc-apps/ics721-nft-transfer/src/context.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/src/handler/mod.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/src/handler/on_recv_packet.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/src/lib.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/src/module.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/Cargo.toml
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/class.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/data.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/error.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/events.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/lib.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/memo.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/msgs/mod.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/msgs/transfer.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/packet.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/serializers.rs
 create mode 100644 ibc-apps/ics721-nft-transfer/types/src/token.rs
 create mode 100644 ibc-testkit/src/testapp/ibc/applications/nft_transfer/context.rs
 create mode 100644 ibc-testkit/src/testapp/ibc/applications/nft_transfer/mod.rs
 create mode 100644 ibc-testkit/src/testapp/ibc/applications/nft_transfer/module.rs
 create mode 100644 ibc-testkit/src/testapp/ibc/applications/nft_transfer/types.rs
 create mode 100644 ibc-testkit/tests/applications/nft_transfer.rs

diff --git a/.changelog/unreleased/features/346-implement-ics721-nft-transfer.md b/.changelog/unreleased/features/346-implement-ics721-nft-transfer.md
new file mode 100644
index 000000000..0a68909ff
--- /dev/null
+++ b/.changelog/unreleased/features/346-implement-ics721-nft-transfer.md
@@ -0,0 +1,2 @@
+- [ibc-app-nft-transfer] Implement ICS-721 NFT transfer application
+  ([\#346](https://github.com/cosmos/ibc-rs/issues/346))
diff --git a/Cargo.toml b/Cargo.toml
index d32711f97..1fce9be1a 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -25,6 +25,8 @@ members = [
     "ibc-clients",
     "ibc-apps/ics20-transfer/types",
     "ibc-apps/ics20-transfer",
+    "ibc-apps/ics721-nft-transfer/types",
+    "ibc-apps/ics721-nft-transfer",
     "ibc-apps",
     "ibc-core/ics24-host/cosmos",
     "ibc-data-types",
@@ -74,6 +76,7 @@ ibc-core-handler      = { version = "0.49.1", path = "./ibc-core/ics25-handler",
 ibc-core-router       = { version = "0.49.1", path = "./ibc-core/ics26-routing", default-features = false }
 ibc-client-tendermint = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint", default-features = false }
 ibc-app-transfer      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer  = { version = "0.49.1", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
 ibc-core-client-context     = { version = "0.49.1", path = "./ibc-core/ics02-client/context", default-features = false }
 ibc-core-client-types       = { version = "0.49.1", path = "./ibc-core/ics02-client/types", default-features = false }
@@ -87,6 +90,7 @@ ibc-core-router-types       = { version = "0.49.1", path = "./ibc-core/ics26-rou
 ibc-client-tendermint-types = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
 ibc-client-wasm-types       = { version = "0.49.1", path = "./ibc-clients/ics08-wasm/types", default-features = false }
 ibc-app-transfer-types      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-app-nft-transfer-types  = { version = "0.49.1", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.41.0", default-features = false }
 
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index f41f4ff9c..e0a8bf90d 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -281,9 +281,9 @@ checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
 
 [[package]]
 name = "base64"
-version = "0.21.6"
+version = "0.21.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c79fed4cdb43e993fcdadc7e58a09fd0e3e649c4436fa11da71c9f1f3ee7feb9"
+checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
 [[package]]
 name = "base64ct"
@@ -327,9 +327,9 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.4.1"
+version = "2.4.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "327762f6e5a765692301e5bb513e0d9fef63be86bbc14528052b1cd3e6f03e07"
+checksum = "ed570934406eb16438a4e976b1b4500774099c13b8cb96eec99f620f05090ddf"
 
 [[package]]
 name = "bitvec"
@@ -518,14 +518,14 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
 [[package]]
 name = "chrono"
-version = "0.4.31"
+version = "0.4.32"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f2c685bad3eb3d45a01354cedb7d5faa66194d1d58ba6e267a8de788f79db38"
+checksum = "41daef31d7a747c5c847246f36de49ced6f7403b4cdabc807a97b5cc184cda7a"
 dependencies = [
  "android-tzdata",
  "iana-time-zone",
  "num-traits",
- "windows-targets 0.48.5",
+ "windows-targets 0.52.0",
 ]
 
 [[package]]
@@ -697,41 +697,6 @@ dependencies = [
  "zeroize",
 ]
 
-[[package]]
-name = "darling"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0209d94da627ab5605dcccf08bb18afa5009cfbef48d8a8b7d7bdbc79be25c5e"
-dependencies = [
- "darling_core",
- "darling_macro",
-]
-
-[[package]]
-name = "darling_core"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "177e3443818124b357d8e76f53be906d60937f0d3a90773a664fa63fa253e621"
-dependencies = [
- "fnv",
- "ident_case",
- "proc-macro2",
- "quote",
- "strsim",
- "syn 2.0.48",
-]
-
-[[package]]
-name = "darling_macro"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
-dependencies = [
- "darling_core",
- "quote",
- "syn 2.0.48",
-]
-
 [[package]]
 name = "der"
 version = "0.7.8"
@@ -1009,12 +974,6 @@ dependencies = [
  "paste",
 ]
 
-[[package]]
-name = "fnv"
-version = "1.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
-
 [[package]]
 name = "form_urlencoded"
 version = "1.2.1"
@@ -1228,9 +1187,9 @@ checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
 
 [[package]]
 name = "hermit-abi"
-version = "0.3.3"
+version = "0.3.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d77f7ec81a6d05a3abb01ab6eb7590f6083d08449fe5a1c8b1e620283546ccb7"
+checksum = "5d3d0e0f38255e7fa3cf31335b3a56f05febd18025f4db5ef7a0cfb4f8da651f"
 
 [[package]]
 name = "hex"
@@ -1368,7 +1327,7 @@ dependencies = [
 name = "ibc-client-wasm-types"
 version = "0.49.1"
 dependencies = [
- "base64 0.21.6",
+ "base64 0.21.7",
  "displaydoc",
  "ibc-core-client",
  "ibc-core-host-types",
@@ -1396,6 +1355,7 @@ dependencies = [
  "ibc-core-handler",
  "ibc-core-host",
  "ibc-core-router",
+ "ibc-derive",
  "ibc-primitives",
 ]
 
@@ -1453,7 +1413,6 @@ dependencies = [
  "ibc-core-commitment-types",
  "ibc-core-handler-types",
  "ibc-core-host-types",
- "ibc-derive",
  "ibc-primitives",
  "subtle-encoding",
  "tendermint",
@@ -1627,7 +1586,6 @@ dependencies = [
 name = "ibc-derive"
 version = "0.5.0"
 dependencies = [
- "darling",
  "proc-macro2",
  "quote",
  "syn 2.0.48",
@@ -1652,7 +1610,7 @@ version = "0.41.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
 dependencies = [
- "base64 0.21.6",
+ "base64 0.21.7",
  "borsh",
  "bytes",
  "flex-error",
@@ -1683,12 +1641,6 @@ dependencies = [
  "sha3",
 ]
 
-[[package]]
-name = "ident_case"
-version = "1.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
-
 [[package]]
 name = "idna"
 version = "0.5.0"
@@ -1765,7 +1717,7 @@ version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
 dependencies = [
- "base64 0.21.6",
+ "base64 0.21.7",
  "serde",
 ]
 
@@ -1815,18 +1767,18 @@ checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
 
 [[package]]
 name = "js-sys"
-version = "0.3.66"
+version = "0.3.67"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cee9c64da59eae3b50095c18d3e74f8b73c0b86d2792824ff01bbce68ba229ca"
+checksum = "9a1d36f1235bc969acba30b7f5990b864423a6068a10f7c90ae8f0112e3a59d1"
 dependencies = [
  "wasm-bindgen",
 ]
 
 [[package]]
 name = "keccak"
-version = "0.1.4"
+version = "0.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f6d5ed8676d904364de097082f4e7d240b571b67989ced0240f08b7f966f940"
+checksum = "ecc2af9a1119c51f12a14607e783cb977bde58bc069ff0c3da1095e635d70654"
 dependencies = [
  "cpufeatures",
 ]
@@ -1899,9 +1851,9 @@ checksum = "f051f77a7c8e6957c0696eac88f26b0117e54f52d3fc682ab19397a8812846a4"
 
 [[package]]
 name = "linux-raw-sys"
-version = "0.4.12"
+version = "0.4.13"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4cd1a83af159aa67994778be9070f0ae1bd732942279cabb14f86f986a21456"
+checksum = "01cda141df6706de531b6c46c3a33ecca755538219bd484262fa09410c13539c"
 
 [[package]]
 name = "lock_api"
@@ -1949,7 +1901,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
 dependencies = [
- "rustix 0.38.28",
+ "rustix 0.38.30",
 ]
 
 [[package]]
@@ -2268,9 +2220,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.76"
+version = "1.0.78"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "95fc56cda0b5c3325f5fbbd7ff9fda9e02bb00bb3dac51252d2f1bfa1cb8cc8c"
+checksum = "e2422ad645d89c99f8f3e6b88a9fdeca7fabeac836b1002371c4367c8f984aae"
 dependencies = [
  "unicode-ident",
 ]
@@ -2433,13 +2385,13 @@ dependencies = [
 
 [[package]]
 name = "regex"
-version = "1.10.2"
+version = "1.10.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "380b951a9c5e80ddfd6136919eef32310721aa4aacd4889a8d39124b026ab343"
+checksum = "b62dbe01f0b06f9d8dc7d49e05a0785f153b00b2c227856282f671e0318c9b15"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-automata 0.4.3",
+ "regex-automata 0.4.4",
  "regex-syntax 0.8.2",
 ]
 
@@ -2454,9 +2406,9 @@ dependencies = [
 
 [[package]]
 name = "regex-automata"
-version = "0.4.3"
+version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f804c7828047e88b2d32e2d7fe5a105da8ee3264f01902f796c8e067dc2483f"
+checksum = "3b7fa1134405e2ec9353fd416b17f8dacd46c473d7d3fd1cf202706a14eb792a"
 dependencies = [
  "aho-corasick",
  "memchr",
@@ -2521,14 +2473,14 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.38.28"
+version = "0.38.30"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "72e572a5e8ca657d7366229cdde4bd14c4eb5499a9573d4d366fe1b599daa316"
+checksum = "322394588aaf33c24007e8bb3238ee3e4c5c09c084ab32bc73890b99ff326bca"
 dependencies = [
- "bitflags 2.4.1",
+ "bitflags 2.4.2",
  "errno",
  "libc",
- "linux-raw-sys 0.4.12",
+ "linux-raw-sys 0.4.13",
  "windows-sys 0.52.0",
 ]
 
@@ -2797,9 +2749,9 @@ dependencies = [
 
 [[package]]
 name = "smallvec"
-version = "1.11.2"
+version = "1.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4dccd0940a2dcdf68d092b8cbab7dc0ad8fa938bf95787e1b916b0e3d0e8e970"
+checksum = "e6ecd384b10a64542d77071bd64bd7b231f4ed5940fba55e98c3de13824cf3d7"
 
 [[package]]
 name = "sp-application-crypto"
@@ -3143,9 +3095,9 @@ dependencies = [
 
 [[package]]
 name = "ss58-registry"
-version = "1.45.0"
+version = "1.46.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3c0c74081753a8ce1c8eb10b9f262ab6f7017e5ad3317c17a54c7ab65fcb3c6e"
+checksum = "b1114ee5900b8569bbc8b1a014a942f937b752af4b44f4607430b5f86cedaac0"
 dependencies = [
  "Inflector",
  "num-format",
@@ -3168,12 +3120,6 @@ version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
 
-[[package]]
-name = "strsim"
-version = "0.10.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"
-
 [[package]]
 name = "substrate-bip39"
 version = "0.4.5"
@@ -3566,9 +3512,9 @@ dependencies = [
 
 [[package]]
 name = "unicode-bidi"
-version = "0.3.14"
+version = "0.3.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6f2528f27a9eb2b21e69c95319b30bd0efd85d09c379741b0f78ea1d86be2416"
+checksum = "08f95100a766bf4f8f28f90d77e0a5461bbdb219042e7679bebe79004fed8d75"
 
 [[package]]
 name = "unicode-ident"
@@ -3662,9 +3608,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.89"
+version = "0.2.90"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0ed0d4f68a3015cc185aff4db9506a015f4b96f95303897bfa23f846db54064e"
+checksum = "b1223296a201415c7fad14792dbefaace9bd52b62d33453ade1c5b5f07555406"
 dependencies = [
  "cfg-if",
  "wasm-bindgen-macro",
@@ -3672,9 +3618,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-backend"
-version = "0.2.89"
+version = "0.2.90"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b56f625e64f3a1084ded111c4d5f477df9f8c92df113852fa5a374dbda78826"
+checksum = "fcdc935b63408d58a32f8cc9738a0bffd8f05cc7c002086c6ef20b7312ad9dcd"
 dependencies = [
  "bumpalo",
  "log",
@@ -3687,9 +3633,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.89"
+version = "0.2.90"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0162dbf37223cd2afce98f3d0785506dcb8d266223983e4b5b525859e6e182b2"
+checksum = "3e4c238561b2d428924c49815533a8b9121c664599558a5d9ec51f8a1740a999"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -3697,9 +3643,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.89"
+version = "0.2.90"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f0eb82fcb7930ae6219a7ecfd55b217f5f0893484b7a13022ebb2b2bf20b5283"
+checksum = "bae1abb6806dc1ad9e560ed242107c0f6c84335f1749dd4e8ddb012ebd5e25a7"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3710,9 +3656,9 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.89"
+version = "0.2.90"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ab9b36309365056cd639da3134bf87fa8f3d86008abf99e612384a6eecd459f"
+checksum = "4d91413b1c31d7539ba5ef2451af3f0b833a005eb27a631cec32bc0635a8602b"
 
 [[package]]
 name = "wasmparser"
@@ -4096,9 +4042,9 @@ checksum = "dff9641d1cd4be8d1a070daf9e3773c5f67e78b4d9d42263020c057706765c04"
 
 [[package]]
 name = "winnow"
-version = "0.5.33"
+version = "0.5.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7520bbdec7211caa7c4e682eb1fbe07abe20cee6756b6e00f537c82c11816aa"
+checksum = "b7cf47b659b318dccbd69cc4797a39ae128f533dce7902a1096044d1967b9c16"
 dependencies = [
  "memchr",
 ]
diff --git a/ibc-apps/Cargo.toml b/ibc-apps/Cargo.toml
index 9057c5e7f..a6fe583b3 100644
--- a/ibc-apps/Cargo.toml
+++ b/ibc-apps/Cargo.toml
@@ -17,12 +17,14 @@ description  = """
 all-features = true
 
 [dependencies]
-ibc-app-transfer = { workspace = true }
+ibc-app-transfer     = { workspace = true }
+ibc-app-nft-transfer = { workspace = true, optional = true, features = [ "std", "serde", "schema", "borsh", "parity-scale-codec" ] }
 
 [features]
 default = ["std"]
 std = [
     "ibc-app-transfer/std",
+    "nft-transfer",
 ]
 serde = [
     "ibc-app-transfer/serde",
@@ -38,3 +40,6 @@ borsh = [
 parity-scale-codec = [
     "ibc-app-transfer/parity-scale-codec",
 ]
+nft-transfer = [
+    "ibc-app-nft-transfer"
+]
diff --git a/ibc-apps/README.md b/ibc-apps/README.md
index 71c8848df..103e68bc2 100644
--- a/ibc-apps/README.md
+++ b/ibc-apps/README.md
@@ -26,6 +26,11 @@ applications:
 - [ibc-app-transfer](./../ibc-apps/ics20-transfer)
 - [ibc-app-transfer-types](./../ibc-apps/ics20-transfer/types)
 
+### ICS-721: Non-Fungible Token Transfer Application
+
+- [ibc-app-nft-transfer](./../ibc-apps/ics721-nft-transfer)
+- [ibc-app-nft-transfer-types](./../ibc-apps/ics721-nft-transfer/types)
+
 ## Contributing
 
 IBC is specified in English in the [cosmos/ibc
diff --git a/ibc-apps/ics721-nft-transfer/Cargo.toml b/ibc-apps/ics721-nft-transfer/Cargo.toml
new file mode 100644
index 000000000..aaba18862
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/Cargo.toml
@@ -0,0 +1,53 @@
+[package]
+name         = "ibc-app-nft-transfer"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["cosmos", "ibc", "nft", "transfer", "ics721"]
+readme       = "./../README.md"
+description  = """
+    Maintained by `ibc-rs`, contains the implementation of the ICS-721 Non-Fungible Token Transfer
+    application logic and re-exports essential data structures and domain types from
+    `ibc-app-nft-transfer-types` crate.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+serde_json = { workspace = true, optional = true }
+
+# ibc dependencies
+ibc-app-nft-transfer-types = { workspace = true }
+ibc-core                   = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-app-nft-transfer-types/std",
+    "ibc-core/std",
+    "serde_json/std",
+]
+serde = [
+    "ibc-app-nft-transfer-types/serde",
+    "ibc-core/serde",
+    "serde_json"
+]
+schema = [
+    "ibc-app-nft-transfer-types/schema",
+    "ibc-core/schema",
+    "serde",
+    "std",
+]
+borsh = [
+    "ibc-app-nft-transfer-types/borsh",
+    "ibc-core/borsh",
+]
+parity-scale-codec = [
+    "ibc-app-nft-transfer-types/parity-scale-codec",
+    "ibc-core/parity-scale-codec",
+]
diff --git a/ibc-apps/ics721-nft-transfer/src/context.rs b/ibc-apps/ics721-nft-transfer/src/context.rs
new file mode 100644
index 000000000..34fec88dd
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/context.rs
@@ -0,0 +1,199 @@
+//! Defines the required context traits for ICS-721 to interact with host
+//! machine.
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+
+use crate::types::error::NftTransferError;
+use crate::types::{
+    ClassData, ClassId, ClassUri, Memo, PrefixedClassId, TokenData, TokenId, TokenUri,
+};
+
+pub trait NftContext {
+    /// Get the class ID of the token
+    fn get_class_id(&self) -> &ClassId;
+
+    /// Get the token ID
+    fn get_id(&self) -> &TokenId;
+
+    /// Get the token URI
+    fn get_uri(&self) -> Option<&TokenUri>;
+
+    /// Get the token Data
+    fn get_data(&self) -> Option<&TokenData>;
+}
+
+pub trait NftClassContext {
+    /// Get the class ID
+    fn get_id(&self) -> &ClassId;
+
+    /// Get the class URI
+    fn get_uri(&self) -> Option<&ClassUri>;
+
+    /// Get the class Data
+    fn get_data(&self) -> Option<&ClassData>;
+}
+
+/// Read-only methods required in NFT transfer validation context.
+pub trait NftTransferValidationContext {
+    type AccountId: TryFrom<Signer> + PartialEq;
+    type Nft: NftContext;
+    type NftClass: NftClassContext;
+
+    /// get_port returns the portID for the transfer module.
+    fn get_port(&self) -> Result<PortId, NftTransferError>;
+
+    /// Returns Ok() if the host chain supports sending NFTs.
+    fn can_send_nft(&self) -> Result<(), NftTransferError>;
+
+    /// Returns Ok() if the host chain supports receiving NFTs.
+    fn can_receive_nft(&self) -> Result<(), NftTransferError>;
+
+    /// Validates that the NFT can be created or updated successfully.
+    ///
+    /// Note: some existing ICS-721 implementations may not strictly adhere to
+    /// the ICS-721 class data structure. The
+    /// [`ClassData`] associated with this
+    /// implementation can take any valid JSON format. If your project requires
+    /// ICS-721 format for the `ClassData`, ensure correctness by checking with
+    /// [`parse_as_ics721_data()`](crate::types::Data::parse_as_ics721_data).
+    fn create_or_update_class_validate(
+        &self,
+        class_id: &PrefixedClassId,
+        class_uri: Option<&ClassUri>,
+        class_data: Option<&ClassData>,
+    ) -> Result<(), NftTransferError>;
+
+    /// Validates that the tokens can be escrowed successfully.
+    ///
+    /// The owner of the NFT should be checked in this validation.
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// escrow validation.
+    fn escrow_nft_validate(
+        &self,
+        from_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        memo: &Memo,
+    ) -> Result<(), NftTransferError>;
+
+    /// Validates that the NFT can be unescrowed successfully.
+    fn unescrow_nft_validate(
+        &self,
+        to_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+    ) -> Result<(), NftTransferError>;
+
+    /// Validates the receiver account and the NFT input
+    ///
+    /// Note: some existing ICS-721 implementations may not strictly adhere to
+    /// the ICS-721 token data structure. The
+    /// [`TokenData`] associated with this
+    /// implementation can take any valid JSON format. If your project requires
+    /// ICS-721 format for `TokenData`, ensure correctness by checking with
+    /// [`parse_as_ics721_data()`](crate::types::Data::parse_as_ics721_data).
+    fn mint_nft_validate(
+        &self,
+        account: &Self::AccountId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        token_uri: Option<&TokenUri>,
+        token_data: Option<&TokenData>,
+    ) -> Result<(), NftTransferError>;
+
+    /// Validates the sender account and the coin input before burning.
+    ///
+    /// The owner of the NFT should be checked in this validation.
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// burn validation.
+    fn burn_nft_validate(
+        &self,
+        account: &Self::AccountId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        memo: &Memo,
+    ) -> Result<(), NftTransferError>;
+
+    /// Returns a hash of the prefixed class ID and the token ID.
+    /// Implement only if the host chain supports hashed class ID and token ID.
+    fn token_hash_string(
+        &self,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+    ) -> Option<String> {
+        None
+    }
+
+    /// Returns the NFT
+    fn get_nft(
+        &self,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+    ) -> Result<Self::Nft, NftTransferError>;
+
+    /// Returns the NFT class
+    fn get_nft_class(&self, class_id: &PrefixedClassId)
+        -> Result<Self::NftClass, NftTransferError>;
+}
+
+/// Read-write methods required in NFT transfer execution context.
+pub trait NftTransferExecutionContext: NftTransferValidationContext {
+    /// Creates a new NFT Class identified by classId. If the class ID already exists, it updates the class metadata.
+    fn create_or_update_class_execute(
+        &self,
+        class_id: &PrefixedClassId,
+        class_uri: Option<&ClassUri>,
+        class_data: Option<&ClassData>,
+    ) -> Result<(), NftTransferError>;
+
+    /// Executes the escrow of the NFT in a user account.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// escrow execution.
+    fn escrow_nft_execute(
+        &mut self,
+        from_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        memo: &Memo,
+    ) -> Result<(), NftTransferError>;
+
+    /// Executes the unescrow of the NFT in a user account.
+    fn unescrow_nft_execute(
+        &mut self,
+        to_account: &Self::AccountId,
+        port_id: &PortId,
+        channel_id: &ChannelId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+    ) -> Result<(), NftTransferError>;
+
+    /// Executes minting of the NFT in a user account.
+    fn mint_nft_execute(
+        &mut self,
+        account: &Self::AccountId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        token_uri: Option<&TokenUri>,
+        token_data: Option<&TokenData>,
+    ) -> Result<(), NftTransferError>;
+
+    /// Executes burning of the NFT in a user account.
+    ///
+    /// `memo` field allows to incorporate additional contextual details in the
+    /// burn execution.
+    fn burn_nft_execute(
+        &mut self,
+        account: &Self::AccountId,
+        class_id: &PrefixedClassId,
+        token_id: &TokenId,
+        memo: &Memo,
+    ) -> Result<(), NftTransferError>;
+}
diff --git a/ibc-apps/ics721-nft-transfer/src/handler/mod.rs b/ibc-apps/ics721-nft-transfer/src/handler/mod.rs
new file mode 100644
index 000000000..2adbb47f6
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/handler/mod.rs
@@ -0,0 +1,85 @@
+//! Implements IBC handlers responsible for processing Non-Fungible Token
+//! Transfers (ICS-721) messages.
+mod on_recv_packet;
+mod send_transfer;
+
+use ibc_core::channel::types::packet::Packet;
+pub use on_recv_packet::*;
+pub use send_transfer::*;
+
+use crate::context::{NftTransferExecutionContext, NftTransferValidationContext};
+use crate::types::error::NftTransferError;
+use crate::types::is_sender_chain_source;
+use crate::types::packet::PacketData;
+
+pub fn refund_packet_nft_execute(
+    ctx_a: &mut impl NftTransferExecutionContext,
+    packet: &Packet,
+    data: &PacketData,
+) -> Result<(), NftTransferError> {
+    let sender = data
+        .sender
+        .clone()
+        .try_into()
+        .map_err(|_| NftTransferError::ParseAccountFailure)?;
+
+    if is_sender_chain_source(
+        packet.port_id_on_a.clone(),
+        packet.chan_id_on_a.clone(),
+        &data.class_id,
+    ) {
+        data.token_ids.as_ref().iter().try_for_each(|token_id| {
+            ctx_a.unescrow_nft_execute(
+                &sender,
+                &packet.port_id_on_a,
+                &packet.chan_id_on_a,
+                &data.class_id,
+                token_id,
+            )
+        })
+    }
+    // mint vouchers back to sender
+    else {
+        for (i, token_id) in data.token_ids.0.iter().enumerate() {
+            let token_uri = data.token_uris.as_ref().and_then(|uris| uris.get(i));
+            let token_data = data.token_data.as_ref().and_then(|data| data.get(i));
+            ctx_a.mint_nft_execute(&sender, &data.class_id, token_id, token_uri, token_data)?;
+        }
+        Ok(())
+    }
+}
+
+pub fn refund_packet_nft_validate(
+    ctx_a: &impl NftTransferValidationContext,
+    packet: &Packet,
+    data: &PacketData,
+) -> Result<(), NftTransferError> {
+    let sender = data
+        .sender
+        .clone()
+        .try_into()
+        .map_err(|_| NftTransferError::ParseAccountFailure)?;
+
+    if is_sender_chain_source(
+        packet.port_id_on_a.clone(),
+        packet.chan_id_on_a.clone(),
+        &data.class_id,
+    ) {
+        data.token_ids.0.iter().try_for_each(|token_id| {
+            ctx_a.unescrow_nft_validate(
+                &sender,
+                &packet.port_id_on_a,
+                &packet.chan_id_on_a,
+                &data.class_id,
+                token_id,
+            )
+        })
+    } else {
+        for (i, token_id) in data.token_ids.0.iter().enumerate() {
+            let token_uri = data.token_uris.as_ref().and_then(|uris| uris.get(i));
+            let token_data = data.token_data.as_ref().and_then(|data| data.get(i));
+            ctx_a.mint_nft_validate(&sender, &data.class_id, token_id, token_uri, token_data)?;
+        }
+        Ok(())
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/src/handler/on_recv_packet.rs b/ibc-apps/ics721-nft-transfer/src/handler/on_recv_packet.rs
new file mode 100644
index 000000000..8782bf7a2
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/handler/on_recv_packet.rs
@@ -0,0 +1,137 @@
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::primitives::prelude::*;
+use ibc_core::router::types::module::ModuleExtras;
+
+use crate::context::NftTransferExecutionContext;
+use crate::types::error::NftTransferError;
+use crate::types::events::TokenTraceEvent;
+use crate::types::packet::PacketData;
+use crate::types::{is_receiver_chain_source, TracePrefix};
+
+/// This function handles the transfer receiving logic.
+///
+/// Note that `send/mint_nft_validate` steps are performed on the host chain
+/// to validate accounts and NFT info. But the result is then used for execution
+/// on the IBC side, including storing acknowledgements and emitting events.
+pub fn process_recv_packet_execute<Ctx>(
+    ctx_b: &mut Ctx,
+    packet: &Packet,
+    data: PacketData,
+) -> Result<ModuleExtras, Box<(ModuleExtras, NftTransferError)>>
+where
+    Ctx: NftTransferExecutionContext,
+{
+    ctx_b
+        .can_receive_nft()
+        .map_err(|err| (ModuleExtras::empty(), err))?;
+
+    let receiver_account = data
+        .receiver
+        .clone()
+        .try_into()
+        .map_err(|_| (ModuleExtras::empty(), NftTransferError::ParseAccountFailure))?;
+
+    let extras = if is_receiver_chain_source(
+        packet.port_id_on_a.clone(),
+        packet.chan_id_on_a.clone(),
+        &data.class_id,
+    ) {
+        // sender chain is not the source, unescrow the NFT
+        let prefix = TracePrefix::new(packet.port_id_on_a.clone(), packet.chan_id_on_a.clone());
+        let class_id = {
+            let mut c = data.class_id;
+            c.remove_trace_prefix(&prefix);
+            c
+        };
+
+        // Note: the validation is called before the execution.
+        // Refer to ICS-20 `process_recv_packet_execute()`.
+        for token_id in data.token_ids.as_ref() {
+            ctx_b
+                .unescrow_nft_validate(
+                    &receiver_account,
+                    &packet.port_id_on_b,
+                    &packet.chan_id_on_b,
+                    &class_id,
+                    token_id,
+                )
+                .map_err(|nft_error| (ModuleExtras::empty(), nft_error))?;
+            ctx_b
+                .unescrow_nft_execute(
+                    &receiver_account,
+                    &packet.port_id_on_b,
+                    &packet.chan_id_on_b,
+                    &class_id,
+                    token_id,
+                )
+                .map_err(|nft_error| (ModuleExtras::empty(), nft_error))?;
+        }
+
+        ModuleExtras::empty()
+    } else {
+        // sender chain is the source, mint vouchers
+        let prefix = TracePrefix::new(packet.port_id_on_b.clone(), packet.chan_id_on_b.clone());
+        let class_id = {
+            let mut c = data.class_id;
+            c.add_trace_prefix(prefix);
+            c
+        };
+
+        let mut extras = ModuleExtras {
+            events: vec![],
+            log: Vec::new(),
+        };
+        for (i, token_id) in data.token_ids.0.iter().enumerate() {
+            let token_uri = data.token_uris.as_ref().and_then(|uris| uris.get(i));
+            let token_data = data.token_data.as_ref().and_then(|data| data.get(i));
+
+            let trace_event = TokenTraceEvent {
+                trace_hash: ctx_b.token_hash_string(&class_id, token_id),
+                class: class_id.clone(),
+                token: token_id.clone(),
+            };
+            extras.events.push(trace_event.into());
+
+            // Note: the validation is called before the execution.
+            // Refer to ICS-20 `process_recv_packet_execute()`.
+
+            ctx_b
+                .create_or_update_class_validate(
+                    &class_id,
+                    data.class_uri.as_ref(),
+                    data.class_data.as_ref(),
+                )
+                .map_err(|nft_error| (ModuleExtras::empty(), nft_error))?;
+            ctx_b
+                .create_or_update_class_execute(
+                    &class_id,
+                    data.class_uri.as_ref(),
+                    data.class_data.as_ref(),
+                )
+                .map_err(|nft_error| (ModuleExtras::empty(), nft_error))?;
+
+            ctx_b
+                .mint_nft_validate(
+                    &receiver_account,
+                    &class_id,
+                    token_id,
+                    token_uri,
+                    token_data,
+                )
+                .map_err(|nft_error| (extras.clone(), nft_error))?;
+            ctx_b
+                .mint_nft_execute(
+                    &receiver_account,
+                    &class_id,
+                    token_id,
+                    token_uri,
+                    token_data,
+                )
+                .map_err(|nft_error| (extras.clone(), nft_error))?;
+        }
+
+        extras
+    };
+
+    Ok(extras)
+}
diff --git a/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs b/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
new file mode 100644
index 000000000..270164701
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
@@ -0,0 +1,253 @@
+use ibc_core::channel::context::{SendPacketExecutionContext, SendPacketValidationContext};
+use ibc_core::channel::handler::{send_packet_execute, send_packet_validate};
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::handler::types::events::MessageEvent;
+use ibc_core::host::types::path::{ChannelEndPath, SeqSendPath};
+use ibc_core::primitives::prelude::*;
+use ibc_core::router::types::event::ModuleEvent;
+
+use crate::context::{
+    NftClassContext, NftContext, NftTransferExecutionContext, NftTransferValidationContext,
+};
+use crate::types::error::NftTransferError;
+use crate::types::events::TransferEvent;
+use crate::types::msgs::transfer::MsgTransfer;
+use crate::types::{is_sender_chain_source, MODULE_ID_STR};
+
+/// Initiate a token transfer. Equivalent to calling [`send_nft_transfer_validate`], followed by [`send_nft_transfer_execute`].
+pub fn send_nft_transfer<SendPacketCtx, TransferCtx>(
+    send_packet_ctx_a: &mut SendPacketCtx,
+    transfer_ctx: &mut TransferCtx,
+    msg: MsgTransfer,
+) -> Result<(), NftTransferError>
+where
+    SendPacketCtx: SendPacketExecutionContext,
+    TransferCtx: NftTransferExecutionContext,
+{
+    send_nft_transfer_validate(send_packet_ctx_a, transfer_ctx, msg.clone())?;
+    send_nft_transfer_execute(send_packet_ctx_a, transfer_ctx, msg)
+}
+
+/// Validates the NFT transfer
+pub fn send_nft_transfer_validate<SendPacketCtx, TransferCtx>(
+    send_packet_ctx_a: &SendPacketCtx,
+    transfer_ctx: &TransferCtx,
+    msg: MsgTransfer,
+) -> Result<(), NftTransferError>
+where
+    SendPacketCtx: SendPacketValidationContext,
+    TransferCtx: NftTransferValidationContext,
+{
+    transfer_ctx.can_send_nft()?;
+
+    let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
+    let chan_end_on_a = send_packet_ctx_a.channel_end(&chan_end_path_on_a)?;
+
+    let port_id_on_b = chan_end_on_a.counterparty().port_id().clone();
+    let chan_id_on_b = chan_end_on_a
+        .counterparty()
+        .channel_id()
+        .ok_or_else(|| NftTransferError::DestinationChannelNotFound {
+            port_id: msg.port_id_on_a.clone(),
+            channel_id: msg.chan_id_on_a.clone(),
+        })?
+        .clone();
+
+    let seq_send_path_on_a = SeqSendPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
+    let sequence = send_packet_ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
+
+    let sender: TransferCtx::AccountId = msg
+        .packet_data
+        .sender
+        .clone()
+        .try_into()
+        .map_err(|_| NftTransferError::ParseAccountFailure)?;
+
+    let mut packet_data = msg.packet_data;
+    let class_id = &packet_data.class_id;
+    let token_ids = &packet_data.token_ids;
+    // overwrite even if they are set in MsgTransfer
+    if let Some(uris) = &mut packet_data.token_uris {
+        uris.clear();
+    }
+    if let Some(data) = &mut packet_data.token_data {
+        data.clear();
+    }
+    for token_id in token_ids.as_ref() {
+        if is_sender_chain_source(msg.port_id_on_a.clone(), msg.chan_id_on_a.clone(), class_id) {
+            transfer_ctx.escrow_nft_validate(
+                &sender,
+                &msg.port_id_on_a,
+                &msg.chan_id_on_a,
+                class_id,
+                token_id,
+                &packet_data.memo.clone().unwrap_or_default(),
+            )?;
+        } else {
+            transfer_ctx.burn_nft_validate(
+                &sender,
+                class_id,
+                token_id,
+                &packet_data.memo.clone().unwrap_or_default(),
+            )?;
+        }
+        let nft = transfer_ctx.get_nft(class_id, token_id)?;
+        // Set the URI and the data if both exists
+        if let (Some(uri), Some(data)) = (nft.get_uri(), nft.get_data()) {
+            match &mut packet_data.token_uris {
+                Some(uris) => uris.push(uri.clone()),
+                None => packet_data.token_uris = Some(vec![uri.clone()]),
+            }
+            match &mut packet_data.token_data {
+                Some(token_data) => token_data.push(data.clone()),
+                None => packet_data.token_data = Some(vec![data.clone()]),
+            }
+        }
+    }
+
+    packet_data.validate_basic()?;
+
+    let nft_class = transfer_ctx.get_nft_class(class_id)?;
+    packet_data.class_uri = nft_class.get_uri().cloned();
+    packet_data.class_data = nft_class.get_data().cloned();
+
+    let packet = {
+        let data = serde_json::to_vec(&packet_data)
+            .expect("PacketData's infallible Serialize impl failed");
+
+        Packet {
+            seq_on_a: sequence,
+            port_id_on_a: msg.port_id_on_a,
+            chan_id_on_a: msg.chan_id_on_a,
+            port_id_on_b,
+            chan_id_on_b,
+            data,
+            timeout_height_on_b: msg.timeout_height_on_b,
+            timeout_timestamp_on_b: msg.timeout_timestamp_on_b,
+        }
+    };
+
+    send_packet_validate(send_packet_ctx_a, &packet)?;
+
+    Ok(())
+}
+
+/// Executes the token transfer. A prior call to [`send_nft_transfer_validate`] MUST have succeeded.
+pub fn send_nft_transfer_execute<SendPacketCtx, TransferCtx>(
+    send_packet_ctx_a: &mut SendPacketCtx,
+    transfer_ctx: &mut TransferCtx,
+    msg: MsgTransfer,
+) -> Result<(), NftTransferError>
+where
+    SendPacketCtx: SendPacketExecutionContext,
+    TransferCtx: NftTransferExecutionContext,
+{
+    let chan_end_path_on_a = ChannelEndPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
+    let chan_end_on_a = send_packet_ctx_a.channel_end(&chan_end_path_on_a)?;
+
+    let port_on_b = chan_end_on_a.counterparty().port_id().clone();
+    let chan_on_b = chan_end_on_a
+        .counterparty()
+        .channel_id()
+        .ok_or_else(|| NftTransferError::DestinationChannelNotFound {
+            port_id: msg.port_id_on_a.clone(),
+            channel_id: msg.chan_id_on_a.clone(),
+        })?
+        .clone();
+
+    // get the next sequence
+    let seq_send_path_on_a = SeqSendPath::new(&msg.port_id_on_a, &msg.chan_id_on_a);
+    let sequence = send_packet_ctx_a.get_next_sequence_send(&seq_send_path_on_a)?;
+
+    let sender = msg
+        .packet_data
+        .sender
+        .clone()
+        .try_into()
+        .map_err(|_| NftTransferError::ParseAccountFailure)?;
+
+    let mut packet_data = msg.packet_data;
+    let class_id = &packet_data.class_id;
+    let token_ids = &packet_data.token_ids;
+    // overwrite even if they are set in MsgTransfer
+    if let Some(uris) = &mut packet_data.token_uris {
+        uris.clear();
+    }
+    if let Some(data) = &mut packet_data.token_data {
+        data.clear();
+    }
+    for token_id in token_ids.as_ref() {
+        if is_sender_chain_source(msg.port_id_on_a.clone(), msg.chan_id_on_a.clone(), class_id) {
+            transfer_ctx.escrow_nft_execute(
+                &sender,
+                &msg.port_id_on_a,
+                &msg.chan_id_on_a,
+                class_id,
+                token_id,
+                &packet_data.memo.clone().unwrap_or_default(),
+            )?;
+        } else {
+            transfer_ctx.burn_nft_execute(
+                &sender,
+                class_id,
+                token_id,
+                &packet_data.memo.clone().unwrap_or_default(),
+            )?;
+        }
+        let nft = transfer_ctx.get_nft(class_id, token_id)?;
+        // Set the URI and the data if both exists
+        if let (Some(uri), Some(data)) = (nft.get_uri(), nft.get_data()) {
+            match &mut packet_data.token_uris {
+                Some(uris) => uris.push(uri.clone()),
+                None => packet_data.token_uris = Some(vec![uri.clone()]),
+            }
+            match &mut packet_data.token_data {
+                Some(token_data) => token_data.push(data.clone()),
+                None => packet_data.token_data = Some(vec![data.clone()]),
+            }
+        }
+    }
+
+    let nft_class = transfer_ctx.get_nft_class(class_id)?;
+    packet_data.class_uri = nft_class.get_uri().cloned();
+    packet_data.class_data = nft_class.get_data().cloned();
+
+    let packet = {
+        let data = {
+            serde_json::to_vec(&packet_data).expect("PacketData's infallible Serialize impl failed")
+        };
+
+        Packet {
+            seq_on_a: sequence,
+            port_id_on_a: msg.port_id_on_a,
+            chan_id_on_a: msg.chan_id_on_a,
+            port_id_on_b: port_on_b,
+            chan_id_on_b: chan_on_b,
+            data,
+            timeout_height_on_b: msg.timeout_height_on_b,
+            timeout_timestamp_on_b: msg.timeout_timestamp_on_b,
+        }
+    };
+
+    send_packet_execute(send_packet_ctx_a, packet)?;
+
+    {
+        send_packet_ctx_a.log_message(format!(
+            "IBC NFT transfer: {} --({}, [{}])--> {}",
+            packet_data.sender, class_id, token_ids, packet_data.receiver
+        ))?;
+
+        let transfer_event = TransferEvent {
+            sender: packet_data.sender,
+            receiver: packet_data.receiver,
+            class: packet_data.class_id,
+            tokens: packet_data.token_ids,
+            memo: packet_data.memo.unwrap_or_default(),
+        };
+        send_packet_ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into())?;
+
+        send_packet_ctx_a.emit_ibc_event(MessageEvent::Module(MODULE_ID_STR.to_string()).into())?;
+    }
+
+    Ok(())
+}
diff --git a/ibc-apps/ics721-nft-transfer/src/lib.rs b/ibc-apps/ics721-nft-transfer/src/lib.rs
new file mode 100644
index 000000000..66693ac1d
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/lib.rs
@@ -0,0 +1,33 @@
+//! Implementation of the IBC [Non-Fungible Token
+//! Transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-721-nft-transfer/README.md)
+//! (ICS-721) application logic.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+#[cfg(feature = "serde")]
+pub mod context;
+#[cfg(feature = "serde")]
+pub mod handler;
+#[cfg(feature = "serde")]
+pub mod module;
+
+/// Re-exports the implementation of the IBC [Non-Fungible Token
+/// Transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-020-fungible-token-transfer/README.md)
+/// (ICS-721) data structures.
+pub mod types {
+    #[doc(inline)]
+    pub use ibc_app_nft_transfer_types::*;
+}
diff --git a/ibc-apps/ics721-nft-transfer/src/module.rs b/ibc-apps/ics721-nft-transfer/src/module.rs
new file mode 100644
index 000000000..fc4097016
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/src/module.rs
@@ -0,0 +1,386 @@
+//! Provides IBC module callbacks implementation for the ICS-721 transfer.
+
+use ibc_core::channel::types::acknowledgement::{Acknowledgement, AcknowledgementStatus};
+use ibc_core::channel::types::channel::{Counterparty, Order};
+use ibc_core::channel::types::packet::Packet;
+use ibc_core::channel::types::Version;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+use ibc_core::router::types::module::ModuleExtras;
+
+use crate::context::{NftTransferExecutionContext, NftTransferValidationContext};
+use crate::handler::{
+    process_recv_packet_execute, refund_packet_nft_execute, refund_packet_nft_validate,
+};
+use crate::types::error::NftTransferError;
+use crate::types::events::{AckEvent, AckStatusEvent, RecvEvent, TimeoutEvent};
+use crate::types::packet::PacketData;
+use crate::types::{ack_success_b64, VERSION};
+
+pub fn on_chan_open_init_validate(
+    ctx: &impl NftTransferValidationContext,
+    order: Order,
+    _connection_hops: &[ConnectionId],
+    port_id: &PortId,
+    _channel_id: &ChannelId,
+    _counterparty: &Counterparty,
+    version: &Version,
+) -> Result<(), NftTransferError> {
+    if order != Order::Unordered {
+        return Err(NftTransferError::ChannelNotUnordered {
+            expect_order: Order::Unordered,
+            got_order: order,
+        });
+    }
+    let bound_port = ctx.get_port()?;
+    if port_id != &bound_port {
+        return Err(NftTransferError::InvalidPort {
+            port_id: port_id.clone(),
+            exp_port_id: bound_port,
+        });
+    }
+
+    if !version.is_empty() {
+        version
+            .verify_is_expected(Version::new(VERSION.to_string()))
+            .map_err(ContextError::from)?;
+    }
+
+    Ok(())
+}
+
+pub fn on_chan_open_init_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _order: Order,
+    _connection_hops: &[ConnectionId],
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+    _counterparty: &Counterparty,
+    _version: &Version,
+) -> Result<(ModuleExtras, Version), NftTransferError> {
+    Ok((ModuleExtras::empty(), Version::new(VERSION.to_string())))
+}
+
+pub fn on_chan_open_try_validate(
+    _ctx: &impl NftTransferValidationContext,
+    order: Order,
+    _connection_hops: &[ConnectionId],
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+    _counterparty: &Counterparty,
+    counterparty_version: &Version,
+) -> Result<(), NftTransferError> {
+    if order != Order::Unordered {
+        return Err(NftTransferError::ChannelNotUnordered {
+            expect_order: Order::Unordered,
+            got_order: order,
+        });
+    }
+
+    counterparty_version
+        .verify_is_expected(Version::new(VERSION.to_string()))
+        .map_err(ContextError::from)?;
+
+    Ok(())
+}
+
+pub fn on_chan_open_try_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _order: Order,
+    _connection_hops: &[ConnectionId],
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+    _counterparty: &Counterparty,
+    _counterparty_version: &Version,
+) -> Result<(ModuleExtras, Version), NftTransferError> {
+    Ok((ModuleExtras::empty(), Version::new(VERSION.to_string())))
+}
+
+pub fn on_chan_open_ack_validate(
+    _ctx: &impl NftTransferExecutionContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+    counterparty_version: &Version,
+) -> Result<(), NftTransferError> {
+    counterparty_version
+        .verify_is_expected(Version::new(VERSION.to_string()))
+        .map_err(ContextError::from)?;
+
+    Ok(())
+}
+
+pub fn on_chan_open_ack_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+    _counterparty_version: &Version,
+) -> Result<ModuleExtras, NftTransferError> {
+    Ok(ModuleExtras::empty())
+}
+
+pub fn on_chan_open_confirm_validate(
+    _ctx: &impl NftTransferValidationContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<(), NftTransferError> {
+    Ok(())
+}
+
+pub fn on_chan_open_confirm_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<ModuleExtras, NftTransferError> {
+    Ok(ModuleExtras::empty())
+}
+
+pub fn on_chan_close_init_validate(
+    _ctx: &impl NftTransferValidationContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<(), NftTransferError> {
+    Err(NftTransferError::CantCloseChannel)
+}
+
+pub fn on_chan_close_init_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<ModuleExtras, NftTransferError> {
+    Err(NftTransferError::CantCloseChannel)
+}
+
+pub fn on_chan_close_confirm_validate(
+    _ctx: &impl NftTransferValidationContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<(), NftTransferError> {
+    Ok(())
+}
+
+pub fn on_chan_close_confirm_execute(
+    _ctx: &mut impl NftTransferExecutionContext,
+    _port_id: &PortId,
+    _channel_id: &ChannelId,
+) -> Result<ModuleExtras, NftTransferError> {
+    Ok(ModuleExtras::empty())
+}
+
+pub fn on_recv_packet_execute(
+    ctx_b: &mut impl NftTransferExecutionContext,
+    packet: &Packet,
+) -> (ModuleExtras, Acknowledgement) {
+    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
+        Ok(data) => data,
+        Err(_) => {
+            let ack =
+                AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into());
+            return (ModuleExtras::empty(), ack.into());
+        }
+    };
+
+    let (mut extras, ack) = match process_recv_packet_execute(ctx_b, packet, data.clone()) {
+        Ok(extras) => (extras, AcknowledgementStatus::success(ack_success_b64())),
+        Err(boxed_error) => {
+            let (extras, error) = *boxed_error;
+            (extras, AcknowledgementStatus::error(error.into()))
+        }
+    };
+
+    let recv_event = RecvEvent {
+        sender: data.sender,
+        receiver: data.receiver,
+        class: data.class_id,
+        tokens: data.token_ids,
+        memo: data.memo.unwrap_or_default(),
+        success: ack.is_successful(),
+    };
+    extras.events.push(recv_event.into());
+
+    (extras, ack.into())
+}
+
+pub fn on_acknowledgement_packet_validate(
+    ctx: &impl NftTransferValidationContext,
+    packet: &Packet,
+    acknowledgement: &Acknowledgement,
+    _relayer: &Signer,
+) -> Result<(), NftTransferError> {
+    let data = serde_json::from_slice::<PacketData>(&packet.data)
+        .map_err(|_| NftTransferError::PacketDataDeserialization)?;
+
+    let acknowledgement = serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref())
+        .map_err(|_| NftTransferError::AckDeserialization)?;
+
+    if !acknowledgement.is_successful() {
+        refund_packet_nft_validate(ctx, packet, &data)?;
+    }
+
+    Ok(())
+}
+
+pub fn on_acknowledgement_packet_execute(
+    ctx: &mut impl NftTransferExecutionContext,
+    packet: &Packet,
+    acknowledgement: &Acknowledgement,
+    _relayer: &Signer,
+) -> (ModuleExtras, Result<(), NftTransferError>) {
+    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
+        Ok(data) => data,
+        Err(_) => {
+            return (
+                ModuleExtras::empty(),
+                Err(NftTransferError::PacketDataDeserialization),
+            );
+        }
+    };
+
+    let acknowledgement =
+        match serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref()) {
+            Ok(ack) => ack,
+            Err(_) => {
+                return (
+                    ModuleExtras::empty(),
+                    Err(NftTransferError::AckDeserialization),
+                );
+            }
+        };
+
+    if !acknowledgement.is_successful() {
+        if let Err(err) = refund_packet_nft_execute(ctx, packet, &data) {
+            return (ModuleExtras::empty(), Err(err));
+        }
+    }
+
+    let ack_event = AckEvent {
+        sender: data.sender,
+        receiver: data.receiver,
+        class: data.class_id,
+        tokens: data.token_ids,
+        memo: data.memo.unwrap_or_default(),
+        acknowledgement: acknowledgement.clone(),
+    };
+
+    let extras = ModuleExtras {
+        events: vec![ack_event.into(), AckStatusEvent { acknowledgement }.into()],
+        log: Vec::new(),
+    };
+
+    (extras, Ok(()))
+}
+
+pub fn on_timeout_packet_validate(
+    ctx: &impl NftTransferValidationContext,
+    packet: &Packet,
+    _relayer: &Signer,
+) -> Result<(), NftTransferError> {
+    let data = serde_json::from_slice::<PacketData>(&packet.data)
+        .map_err(|_| NftTransferError::PacketDataDeserialization)?;
+
+    refund_packet_nft_validate(ctx, packet, &data)?;
+
+    Ok(())
+}
+
+pub fn on_timeout_packet_execute(
+    ctx: &mut impl NftTransferExecutionContext,
+    packet: &Packet,
+    _relayer: &Signer,
+) -> (ModuleExtras, Result<(), NftTransferError>) {
+    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
+        Ok(data) => data,
+        Err(_) => {
+            return (
+                ModuleExtras::empty(),
+                Err(NftTransferError::PacketDataDeserialization),
+            );
+        }
+    };
+
+    if let Err(err) = refund_packet_nft_execute(ctx, packet, &data) {
+        return (ModuleExtras::empty(), Err(err));
+    }
+
+    let timeout_event = TimeoutEvent {
+        refund_receiver: data.sender,
+        refund_class: data.class_id,
+        refund_tokens: data.token_ids,
+        memo: data.memo.unwrap_or_default(),
+    };
+
+    let extras = ModuleExtras {
+        events: vec![timeout_event.into()],
+        log: Vec::new(),
+    };
+
+    (extras, Ok(()))
+}
+
+#[cfg(test)]
+mod test {
+    use super::*;
+    use crate::types::ack_success_b64;
+    use crate::types::error::NftTransferError;
+
+    #[test]
+    fn test_ack_ser() {
+        fn ser_json_assert_eq(ack: AcknowledgementStatus, json_str: &str) {
+            let ser = serde_json::to_string(&ack).unwrap();
+            assert_eq!(ser, json_str)
+        }
+
+        ser_json_assert_eq(
+            AcknowledgementStatus::success(ack_success_b64()),
+            r#"{"result":"AQ=="}"#,
+        );
+        ser_json_assert_eq(
+            AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into()),
+            r#"{"error":"failed to deserialize packet data"}"#,
+        );
+    }
+
+    #[test]
+    fn test_ack_success_to_vec() {
+        let ack_success: Vec<u8> = AcknowledgementStatus::success(ack_success_b64()).into();
+
+        // Check that it's the same output as ibc-go
+        // Note: this also implicitly checks that the ack bytes are non-empty,
+        // which would make the conversion to `Acknowledgement` panic
+        assert_eq!(ack_success, r#"{"result":"AQ=="}"#.as_bytes());
+    }
+
+    #[test]
+    fn test_ack_error_to_vec() {
+        let ack_error: Vec<u8> =
+            AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into()).into();
+
+        // Check that it's the same output as ibc-go
+        // Note: this also implicitly checks that the ack bytes are non-empty,
+        // which would make the conversion to `Acknowledgement` panic
+        assert_eq!(
+            ack_error,
+            r#"{"error":"failed to deserialize packet data"}"#.as_bytes()
+        );
+    }
+
+    #[test]
+    fn test_ack_de() {
+        fn de_json_assert_eq(json_str: &str, ack: AcknowledgementStatus) {
+            let de = serde_json::from_str::<AcknowledgementStatus>(json_str).unwrap();
+            assert_eq!(de, ack)
+        }
+
+        de_json_assert_eq(
+            r#"{"result":"AQ=="}"#,
+            AcknowledgementStatus::success(ack_success_b64()),
+        );
+        de_json_assert_eq(
+            r#"{"error":"failed to deserialize packet data"}"#,
+            AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into()),
+        );
+
+        assert!(serde_json::from_str::<AcknowledgementStatus>(r#"{"success":"AQ=="}"#).is_err());
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
new file mode 100644
index 000000000..b63d0fb14
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -0,0 +1,76 @@
+[package]
+name         = "ibc-app-nft-transfer-types"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["cosmos", "ibc", "transfer", "nft", "ics721"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-721 Non-Fungible Token Transfer data structures and 
+    domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
+    applicability to facilitate development and integration across diverse IBC-enabled projects.
+"""
+
+[package.metadata.docs.rs]
+all-features = true
+
+[dependencies]
+# external dependencies
+borsh           = { workspace = true, optional = true }
+base64          = { version = "0.21.6", default-features = false }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+http            = "1.0.0"
+mime            = "0.3.17"
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+serde_json      = { workspace = true }
+
+# ibc dependencies
+ibc-core  = { workspace = true }
+ibc-proto = { workspace = true }
+
+## parity dependencies
+parity-scale-codec = { workspace = true , optional = true }
+scale-info         = { workspace = true , optional = true }
+
+[dev-dependencies]
+rstest      = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "serde/std",
+    "serde_json/std",
+    "base64/std",
+    "displaydoc/std",
+    "http/std",
+    "ibc-core/std",
+    "ibc-proto/std",
+]
+serde = [
+    "dep:serde",
+    "ibc-core/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc-core/schema",
+    "ibc-proto/json-schema", 
+    "serde",
+    "std"
+]
+borsh = [
+    "dep:borsh",
+    "ibc-core/borsh",
+    "ibc-proto/borsh"
+]
+parity-scale-codec = [
+    "dep:parity-scale-codec",
+    "dep:scale-info",
+    "ibc-core/parity-scale-codec",
+    "ibc-proto/parity-scale-codec"
+]
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
new file mode 100644
index 000000000..278a90a07
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -0,0 +1,602 @@
+//! Defines Non-Fungible Token Transfer (ICS-721) class types.
+use core::fmt::{self, Display, Error as FmtError, Formatter};
+use core::str::FromStr;
+
+use derive_more::From;
+use http::Uri;
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_proto::ibc::applications::nft_transfer::v1::ClassTrace as RawClassTrace;
+
+use crate::data::Data;
+use crate::error::NftTransferError;
+use crate::serializers;
+
+/// Class ID for an NFT
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
+pub struct ClassId(String);
+
+impl AsRef<str> for ClassId {
+    fn as_ref(&self) -> &str {
+        &self.0
+    }
+}
+
+impl Display for ClassId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ClassId {
+    type Err = NftTransferError;
+
+    fn from_str(class_id: &str) -> Result<Self, Self::Err> {
+        if class_id.trim().is_empty() {
+            Err(NftTransferError::EmptyBaseClassId)
+        } else {
+            Ok(Self(class_id.to_string()))
+        }
+    }
+}
+
+/// Class prefix, the same as ICS-20 TracePrefix
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, Ord, PartialOrd, Eq, PartialEq)]
+pub struct TracePrefix {
+    port_id: PortId,
+    channel_id: ChannelId,
+}
+
+impl TracePrefix {
+    pub fn new(port_id: PortId, channel_id: ChannelId) -> Self {
+        Self {
+            port_id,
+            channel_id,
+        }
+    }
+}
+
+impl Display for TracePrefix {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        write!(f, "{}/{}", self.port_id, self.channel_id)
+    }
+}
+
+/// Class trace path, the same as ICS-20 TracePath
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, Default, Eq, PartialEq, PartialOrd, Ord, From)]
+pub struct TracePath(Vec<TracePrefix>);
+
+impl TracePath {
+    /// Returns true iff this path starts with the specified prefix
+    pub fn starts_with(&self, prefix: &TracePrefix) -> bool {
+        self.0.last().map(|p| p == prefix).unwrap_or(false)
+    }
+
+    /// Removes the specified prefix from the path if there is a match, otherwise does nothing.
+    pub fn remove_prefix(&mut self, prefix: &TracePrefix) {
+        if self.starts_with(prefix) {
+            self.0.pop();
+        }
+    }
+
+    /// Adds the specified prefix to the path.
+    pub fn add_prefix(&mut self, prefix: TracePrefix) {
+        self.0.push(prefix)
+    }
+
+    /// Returns true if the path is empty and false otherwise.
+    pub fn is_empty(&self) -> bool {
+        self.0.is_empty()
+    }
+}
+
+impl<'a> TryFrom<Vec<&'a str>> for TracePath {
+    type Error = NftTransferError;
+
+    fn try_from(v: Vec<&'a str>) -> Result<Self, Self::Error> {
+        if v.len() % 2 != 0 {
+            return Err(NftTransferError::InvalidTraceLength {
+                len: v.len() as u64,
+            });
+        }
+
+        let mut trace = vec![];
+        let id_pairs = v.chunks_exact(2).map(|paths| (paths[0], paths[1]));
+        for (pos, (port_id, channel_id)) in id_pairs.rev().enumerate() {
+            let port_id =
+                PortId::from_str(port_id).map_err(|e| NftTransferError::InvalidTracePortId {
+                    pos: pos as u64,
+                    validation_error: e,
+                })?;
+            let channel_id = ChannelId::from_str(channel_id).map_err(|e| {
+                NftTransferError::InvalidTraceChannelId {
+                    pos: pos as u64,
+                    validation_error: e,
+                }
+            })?;
+            trace.push(TracePrefix {
+                port_id,
+                channel_id,
+            });
+        }
+
+        Ok(trace.into())
+    }
+}
+
+impl FromStr for TracePath {
+    type Err = NftTransferError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        let parts = {
+            let parts: Vec<&str> = s.split('/').collect();
+            if parts.len() == 1 && parts[0].trim().is_empty() {
+                vec![]
+            } else {
+                parts
+            }
+        };
+        parts.try_into()
+    }
+}
+
+impl Display for TracePath {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        let path = self
+            .0
+            .iter()
+            .rev()
+            .map(|prefix| prefix.to_string())
+            .collect::<Vec<String>>()
+            .join("/");
+        write!(f, "{path}")
+    }
+}
+
+/// Prefixed class to trace sources like ICS-20 PrefixedDenom
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord)]
+pub struct PrefixedClassId {
+    /// A series of `{port-id}/{channel-id}`s for tracing the source of the class.
+    #[cfg_attr(feature = "serde", serde(with = "serializers"))]
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
+    pub trace_path: TracePath,
+    /// Base class of the relayed non-fungible token.
+    pub base_class_id: ClassId,
+}
+
+impl PrefixedClassId {
+    /// Removes the specified prefix from the trace path if there is a match, otherwise does nothing.
+    pub fn remove_trace_prefix(&mut self, prefix: &TracePrefix) {
+        self.trace_path.remove_prefix(prefix)
+    }
+
+    /// Adds the specified prefix to the trace path.
+    pub fn add_trace_prefix(&mut self, prefix: TracePrefix) {
+        self.trace_path.add_prefix(prefix)
+    }
+}
+
+/// Returns true if the class ID originally came from the sender chain and false otherwise.
+pub fn is_sender_chain_source(
+    source_port: PortId,
+    source_channel: ChannelId,
+    class_id: &PrefixedClassId,
+) -> bool {
+    !is_receiver_chain_source(source_port, source_channel, class_id)
+}
+
+/// Returns true if the class ID originally came from the receiving chain and false otherwise.
+pub fn is_receiver_chain_source(
+    source_port: PortId,
+    source_channel: ChannelId,
+    class_id: &PrefixedClassId,
+) -> bool {
+    // For example, let
+    // A: sender chain in this transfer, port "transfer" and channel "c2b" (to B)
+    // B: receiver chain in this transfer, port "transfer" and channel "c2a" (to A)
+    //
+    // If B had originally sent the token in a previous transfer, then A would have stored the token as
+    // "transfer/c2b/{token_denom}". Now, A is sending to B, so to check if B is the source of the token,
+    // we need to check if the token starts with "transfer/c2b".
+    let prefix = TracePrefix::new(source_port, source_channel);
+    class_id.trace_path.starts_with(&prefix)
+}
+
+impl FromStr for PrefixedClassId {
+    type Err = NftTransferError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        let mut parts: Vec<&str> = s.split('/').collect();
+        let last_part = parts.pop().expect("split() returned an empty iterator");
+
+        let (base_class_id, trace_path) = {
+            if last_part == s {
+                (ClassId::from_str(s)?, TracePath::default())
+            } else {
+                let base_class_id = ClassId::from_str(last_part)?;
+                let trace_path = TracePath::try_from(parts)?;
+                (base_class_id, trace_path)
+            }
+        };
+
+        Ok(Self {
+            trace_path,
+            base_class_id,
+        })
+    }
+}
+
+impl TryFrom<RawClassTrace> for PrefixedClassId {
+    type Error = NftTransferError;
+
+    fn try_from(value: RawClassTrace) -> Result<Self, Self::Error> {
+        let base_class_id = ClassId::from_str(&value.base_class_id)?;
+        let trace_path = TracePath::from_str(&value.path)?;
+        Ok(Self {
+            trace_path,
+            base_class_id,
+        })
+    }
+}
+
+impl From<PrefixedClassId> for RawClassTrace {
+    fn from(value: PrefixedClassId) -> Self {
+        Self {
+            path: value.trace_path.to_string(),
+            base_class_id: value.base_class_id.to_string(),
+        }
+    }
+}
+
+impl From<ClassId> for PrefixedClassId {
+    fn from(class_id: ClassId) -> Self {
+        Self {
+            trace_path: Default::default(),
+            base_class_id: class_id,
+        }
+    }
+}
+
+impl Display for PrefixedClassId {
+    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
+        if self.trace_path.0.is_empty() {
+            write!(f, "{}", self.base_class_id)
+        } else {
+            write!(f, "{}/{}", self.trace_path, self.base_class_id)
+        }
+    }
+}
+
+/// Class URI for an NFT
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct ClassUri(
+    #[cfg_attr(feature = "serde", serde(with = "serializers"))]
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
+    Uri,
+);
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshSerialize for ClassUri {
+    fn serialize<W: borsh::maybestd::io::Write>(
+        &self,
+        writer: &mut W,
+    ) -> borsh::maybestd::io::Result<()> {
+        borsh::BorshSerialize::serialize(&self.to_string(), writer)
+    }
+}
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshDeserialize for ClassUri {
+    fn deserialize_reader<R: borsh::maybestd::io::Read>(
+        reader: &mut R,
+    ) -> borsh::maybestd::io::Result<Self> {
+        let uri = String::deserialize_reader(reader)?;
+        Ok(ClassUri::from_str(&uri).map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Encode for ClassUri {
+    fn encode_to<T: parity_scale_codec::Output + ?Sized>(&self, writer: &mut T) {
+        self.to_string().encode_to(writer);
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Decode for ClassUri {
+    fn decode<I: parity_scale_codec::Input>(
+        input: &mut I,
+    ) -> Result<Self, parity_scale_codec::Error> {
+        let uri = String::decode(input)?;
+        ClassUri::from_str(&uri).map_err(|_| parity_scale_codec::Error::from("from str error"))
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl scale_info::TypeInfo for ClassUri {
+    type Identity = Self;
+
+    fn type_info() -> scale_info::Type {
+        scale_info::Type::builder()
+            .path(scale_info::Path::new("ClassUri", module_path!()))
+            .composite(
+                scale_info::build::Fields::unnamed()
+                    .field(|f| f.ty::<String>().type_name("String")),
+            )
+    }
+}
+
+impl Display for ClassUri {
+    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ClassUri {
+    type Err = NftTransferError;
+
+    fn from_str(class_uri: &str) -> Result<Self, Self::Err> {
+        match Uri::from_str(class_uri) {
+            Ok(uri) => Ok(Self(uri)),
+            Err(err) => Err(NftTransferError::InvalidUri {
+                uri: class_uri.to_string(),
+                validation_error: err,
+            }),
+        }
+    }
+}
+
+/// Class data for an NFT
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::AsRef)]
+pub struct ClassData(Data);
+
+impl Display for ClassData {
+    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for ClassData {
+    type Err = NftTransferError;
+
+    fn from_str(class_data: &str) -> Result<Self, Self::Err> {
+        // validate the data
+        let data = Data::from_str(class_data)?;
+        Ok(Self(data))
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[test]
+    fn test_class_id_validation() -> Result<(), NftTransferError> {
+        assert!(ClassId::from_str("").is_err(), "empty base class ID");
+        assert!(ClassId::from_str("myclass").is_ok(), "valid base class ID");
+        assert!(PrefixedClassId::from_str("").is_err(), "empty class trace");
+        assert!(
+            PrefixedClassId::from_str("transfer/channel-0/").is_err(),
+            "empty base class ID with trace"
+        );
+        assert!(
+            PrefixedClassId::from_str("/myclass").is_err(),
+            "empty prefix"
+        );
+        assert!(PrefixedClassId::from_str("//myclass").is_err(), "empty ids");
+        assert!(
+            PrefixedClassId::from_str("transfer/").is_err(),
+            "single trace"
+        );
+        assert!(
+            PrefixedClassId::from_str("transfer/myclass").is_err(),
+            "single trace with base class ID"
+        );
+        assert!(
+            PrefixedClassId::from_str("transfer/channel-0/myclass").is_ok(),
+            "valid single trace info"
+        );
+        assert!(
+            PrefixedClassId::from_str("transfer/channel-0/transfer/channel-1/myclass").is_ok(),
+            "valid multiple trace info"
+        );
+        assert!(
+            PrefixedClassId::from_str("(transfer)/channel-0/myclass").is_err(),
+            "invalid port"
+        );
+        assert!(
+            PrefixedClassId::from_str("transfer/(channel-0)/myclass").is_err(),
+            "invalid channel"
+        );
+
+        Ok(())
+    }
+
+    #[test]
+    fn test_class_id_trace() -> Result<(), NftTransferError> {
+        assert_eq!(
+            PrefixedClassId::from_str("transfer/channel-0/myclass")?,
+            PrefixedClassId {
+                trace_path: "transfer/channel-0".parse()?,
+                base_class_id: "myclass".parse()?
+            },
+            "valid single trace info"
+        );
+        assert_eq!(
+            PrefixedClassId::from_str("transfer/channel-0/transfer/channel-1/myclass")?,
+            PrefixedClassId {
+                trace_path: "transfer/channel-0/transfer/channel-1".parse()?,
+                base_class_id: "myclass".parse()?
+            },
+            "valid multiple trace info"
+        );
+
+        Ok(())
+    }
+
+    #[test]
+    fn test_class_id_serde() -> Result<(), NftTransferError> {
+        let dt_str = "transfer/channel-0/myclass";
+        let dt = PrefixedClassId::from_str(dt_str)?;
+        assert_eq!(dt.to_string(), dt_str, "valid single trace info");
+
+        let dt_str = "transfer/channel-0/transfer/channel-1/myclass";
+        let dt = PrefixedClassId::from_str(dt_str)?;
+        assert_eq!(dt.to_string(), dt_str, "valid multiple trace info");
+
+        Ok(())
+    }
+
+    #[test]
+    fn test_trace_path() -> Result<(), NftTransferError> {
+        assert!(TracePath::from_str("").is_ok(), "empty trace path");
+        assert!(
+            TracePath::from_str("transfer/myclass").is_err(),
+            "invalid trace path: bad ChannelId"
+        );
+        assert!(
+            TracePath::from_str("transfer//myclass").is_err(),
+            "malformed trace path: missing ChannelId"
+        );
+        assert!(
+            TracePath::from_str("transfer/channel-0/").is_err(),
+            "malformed trace path: trailing delimiter"
+        );
+
+        let prefix_1 = TracePrefix::new("transfer".parse().unwrap(), "channel-1".parse().unwrap());
+        let prefix_2 = TracePrefix::new("transfer".parse().unwrap(), "channel-0".parse().unwrap());
+        let mut trace_path = TracePath(vec![prefix_1.clone()]);
+
+        trace_path.add_prefix(prefix_2.clone());
+        assert_eq!(
+            TracePath::from_str("transfer/channel-0/transfer/channel-1")?,
+            trace_path
+        );
+        assert_eq!(
+            TracePath(vec![prefix_1.clone(), prefix_2.clone()]),
+            trace_path
+        );
+
+        trace_path.remove_prefix(&prefix_2);
+        assert_eq!(TracePath::from_str("transfer/channel-1")?, trace_path);
+        assert_eq!(TracePath(vec![prefix_1.clone()]), trace_path);
+
+        trace_path.remove_prefix(&prefix_1);
+        assert!(trace_path.is_empty());
+
+        Ok(())
+    }
+
+    #[test]
+    fn test_serde_json_roundtrip() {
+        fn serde_roundtrip(class_uri: ClassUri) {
+            let serialized =
+                serde_json::to_string(&class_uri).expect("failed to serialize ClassUri");
+            let deserialized = serde_json::from_str::<ClassUri>(&serialized)
+                .expect("failed to deserialize ClassUri");
+
+            assert_eq!(deserialized, class_uri);
+        }
+
+        let uri = "/foo/bar?baz".parse::<Uri>().unwrap();
+        serde_roundtrip(ClassUri(uri));
+
+        let uri = "https://www.rust-lang.org/install.html"
+            .parse::<Uri>()
+            .unwrap();
+        serde_roundtrip(ClassUri(uri));
+    }
+
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh_roundtrip() {
+        fn borsh_roundtrip(class_uri: ClassUri) {
+            use borsh::{BorshDeserialize, BorshSerialize};
+
+            let class_uri_bytes = class_uri.try_to_vec().unwrap();
+            let res = ClassUri::try_from_slice(&class_uri_bytes).unwrap();
+
+            assert_eq!(class_uri, res);
+        }
+
+        let uri = "/foo/bar?baz".parse::<Uri>().unwrap();
+        borsh_roundtrip(ClassUri(uri));
+
+        let uri = "https://www.rust-lang.org/install.html"
+            .parse::<Uri>()
+            .unwrap();
+        borsh_roundtrip(ClassUri(uri));
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/data.rs b/ibc-apps/ics721-nft-transfer/types/src/data.rs
new file mode 100644
index 000000000..098c8c094
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/data.rs
@@ -0,0 +1,309 @@
+//! Defines Non-Fungible Token Transfer (ICS-721) data types.
+use core::fmt::{self, Display, Formatter};
+use core::str::FromStr;
+
+use base64::prelude::BASE64_STANDARD;
+use base64::Engine;
+use ibc_core::primitives::prelude::*;
+use mime::Mime;
+
+use crate::error::NftTransferError;
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, Default, PartialEq, Eq, derive_more::From)]
+pub struct Data(String);
+
+impl Data {
+    /// Parses the data in the format specified by ICS-721.
+    pub fn parse_as_ics721_data(&self) -> Result<Ics721Data, NftTransferError> {
+        self.0.parse::<Ics721Data>()
+    }
+}
+
+impl Display for Data {
+    fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for Data {
+    type Err = NftTransferError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        Ok(Self(s.to_string()))
+    }
+}
+
+impl serde::Serialize for Data {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::Serializer,
+    {
+        serializer.serialize_str(&BASE64_STANDARD.encode(&self.0))
+    }
+}
+
+impl<'de> serde::Deserialize<'de> for Data {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        let encoded = String::deserialize(deserializer)?;
+        let decoded = BASE64_STANDARD
+            .decode(encoded)
+            .map_err(serde::de::Error::custom)?;
+        let decoded_str = String::from_utf8(decoded).map_err(serde::de::Error::custom)?;
+        Ok(Data(decoded_str))
+    }
+}
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, Default, PartialEq, Eq)]
+pub struct Ics721Data(BTreeMap<String, DataValue>);
+
+impl FromStr for Ics721Data {
+    type Err = NftTransferError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        serde_json::from_str(s).map_err(|_| NftTransferError::InvalidIcs721Data)
+    }
+}
+
+#[derive(Clone, Debug, Default, PartialEq, Eq)]
+pub struct DataValue {
+    value: String,
+    mime: Option<Mime>,
+}
+
+#[cfg(feature = "serde")]
+impl serde::Serialize for DataValue {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: serde::Serializer,
+    {
+        use serde::ser::SerializeStruct;
+        let mut state = serializer.serialize_struct("DataValue", 2)?;
+        state.serialize_field("value", &self.value)?;
+        match &self.mime {
+            Some(mime) if *mime != "" => {
+                state.serialize_field("mime", &mime.to_string())?;
+            }
+            _ => {}
+        }
+        state.end()
+    }
+}
+
+#[cfg(feature = "serde")]
+impl<'de> serde::Deserialize<'de> for DataValue {
+    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        #[derive(serde::Deserialize)]
+        struct StringDataValue {
+            value: String,
+            mime: Option<String>,
+        }
+
+        let data_value = StringDataValue::deserialize(deserializer)?;
+        let mime = data_value
+            .mime
+            .map(|s| Mime::from_str(&s).map_err(serde::de::Error::custom))
+            .transpose()?;
+
+        Ok(DataValue {
+            value: data_value.value,
+            mime,
+        })
+    }
+}
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshSerialize for DataValue {
+    fn serialize<W: borsh::maybestd::io::Write>(
+        &self,
+        writer: &mut W,
+    ) -> borsh::maybestd::io::Result<()> {
+        borsh::BorshSerialize::serialize(&self.value, writer)?;
+        let mime = match &self.mime {
+            Some(mime) => mime.to_string(),
+            None => String::default(),
+        };
+        borsh::BorshSerialize::serialize(&mime.to_string(), writer)?;
+        Ok(())
+    }
+}
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshDeserialize for DataValue {
+    fn deserialize_reader<R: borsh::maybestd::io::Read>(
+        reader: &mut R,
+    ) -> borsh::maybestd::io::Result<Self> {
+        let value = String::deserialize_reader(reader)?;
+        let mime = String::deserialize_reader(reader)?;
+        let mime = if mime.is_empty() {
+            None
+        } else {
+            Some(Mime::from_str(&mime).map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
+        };
+
+        Ok(Self { value, mime })
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Encode for DataValue {
+    fn encode_to<T: parity_scale_codec::Output + ?Sized>(&self, writer: &mut T) {
+        self.value.encode_to(writer);
+        if let Some(mime) = &self.mime {
+            mime.to_string().encode_to(writer);
+        } else {
+            "".encode_to(writer);
+        }
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Decode for DataValue {
+    fn decode<I: parity_scale_codec::Input>(
+        input: &mut I,
+    ) -> Result<Self, parity_scale_codec::Error> {
+        let value = String::decode(input)?;
+        let mime_str = String::decode(input)?;
+        let mime = if mime_str.is_empty() {
+            None
+        } else {
+            Some(
+                Mime::from_str(&mime_str)
+                    .map_err(|_| parity_scale_codec::Error::from("from str error"))?,
+            )
+        };
+
+        Ok(DataValue { value, mime })
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl scale_info::TypeInfo for DataValue {
+    type Identity = Self;
+
+    fn type_info() -> scale_info::Type {
+        scale_info::Type::builder()
+            .path(scale_info::Path::new("DataValue", module_path!()))
+            .composite(
+                scale_info::build::Fields::named()
+                    .field(|f| f.ty::<String>().name("value").type_name("String"))
+                    .field(|f| f.ty::<String>().name("mime").type_name("String")),
+            )
+    }
+}
+
+#[cfg(feature = "schema")]
+impl schemars::JsonSchema for DataValue {
+    fn schema_name() -> String {
+        "DataValue".to_string()
+    }
+
+    fn schema_id() -> std::borrow::Cow<'static, str> {
+        std::borrow::Cow::Borrowed(concat!(module_path!(), "::DataValue"))
+    }
+
+    fn json_schema(gen: &mut schemars::gen::SchemaGenerator) -> schemars::schema::Schema {
+        gen.subschema_for::<Self>()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use rstest::rstest;
+
+    use super::*;
+
+    #[cfg(feature = "serde")]
+    #[rstest]
+    #[case(r#"{"value":"foo"}"#)]
+    #[case(r#"{"value":"foo-42","mime":"multipart/form-data; boundary=ABCDEFG"}"#)]
+    fn test_valid_json_deserialization(#[case] data_value_json: &str) {
+        assert!(serde_json::from_str::<DataValue>(data_value_json).is_ok());
+    }
+
+    #[cfg(feature = "serde")]
+    #[rstest]
+    #[case(r#"{"value":"foo-42","mime":"invalid"}"#)]
+    #[case(r#"{"value":"invalid","mime":""}"#)]
+    fn test_invalid_json_deserialization(#[case] data_value_json: &str) {
+        assert!(serde_json::from_str::<DataValue>(data_value_json).is_err());
+    }
+
+    #[cfg(feature = "serde")]
+    #[test]
+    fn test_serde_json_roundtrip() {
+        fn serde_roundtrip(data_value: DataValue) {
+            let serialized =
+                serde_json::to_string(&data_value).expect("failed to serialize DataValue");
+            let deserialized = serde_json::from_str::<DataValue>(&serialized)
+                .expect("failed to deserialize DataValue");
+
+            assert_eq!(deserialized, data_value);
+        }
+
+        serde_roundtrip(DataValue {
+            value: String::from("foo"),
+            mime: None,
+        });
+
+        serde_roundtrip(DataValue {
+            value: String::from("foo"),
+            mime: Some(mime::TEXT_PLAIN_UTF_8),
+        });
+    }
+
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh_roundtrip() {
+        fn borsh_roundtrip(data_value: DataValue) {
+            use borsh::{BorshDeserialize, BorshSerialize};
+
+            let data_value_bytes = data_value.try_to_vec().unwrap();
+            let res = DataValue::try_from_slice(&data_value_bytes).unwrap();
+
+            assert_eq!(data_value, res);
+        }
+
+        borsh_roundtrip(DataValue {
+            value: String::from("foo"),
+            mime: None,
+        });
+
+        borsh_roundtrip(DataValue {
+            value: String::from("foo"),
+            mime: Some(mime::TEXT_PLAIN_UTF_8),
+        });
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/error.rs b/ibc-apps/ics721-nft-transfer/types/src/error.rs
new file mode 100644
index 000000000..08ab598e5
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/error.rs
@@ -0,0 +1,140 @@
+//! Defines the Non-Fungible Token Transfer (ICS-721) error types.
+use core::convert::Infallible;
+use core::str::Utf8Error;
+
+use displaydoc::Display;
+use ibc_core::channel::types::acknowledgement::StatusValue;
+use ibc_core::channel::types::channel::Order;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::error::IdentifierError;
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+
+#[derive(Display, Debug)]
+pub enum NftTransferError {
+    /// context error: `{0}`
+    ContextError(ContextError),
+    /// invalid identifier: `{0}`
+    InvalidIdentifier(IdentifierError),
+    /// invalid URI: `{uri}`, validation error: `{validation_error}``
+    InvalidUri {
+        uri: String,
+        validation_error: http::uri::InvalidUri,
+    },
+    /// destination channel not found in the counterparty of port_id `{port_id}` and channel_id `{channel_id}`
+    DestinationChannelNotFound {
+        port_id: PortId,
+        channel_id: ChannelId,
+    },
+    /// base class ID is empty
+    EmptyBaseClassId,
+    /// invalid prot id n trace at position: `{pos}`, validation error: `{validation_error}`
+    InvalidTracePortId {
+        pos: u64,
+        validation_error: IdentifierError,
+    },
+    /// invalid channel id in trace at position: `{pos}`, validation error: `{validation_error}`
+    InvalidTraceChannelId {
+        pos: u64,
+        validation_error: IdentifierError,
+    },
+    /// trace length must be even but got: `{len}`
+    InvalidTraceLength { len: u64 },
+    /// no token ID
+    NoTokenId,
+    /// invalid token ID
+    InvalidTokenId,
+    /// duplicated token IDs
+    DuplicatedTokenIds,
+    /// The length of token IDs mismatched that of token URIs or token data
+    TokenMismatched,
+    /// invalid json data
+    InvalidJsonData,
+    /// the data is not in the JSON format specified by ICS-721
+    InvalidIcs721Data,
+    /// expected `{expect_order}` channel, got `{got_order}`
+    ChannelNotUnordered {
+        expect_order: Order,
+        got_order: Order,
+    },
+    /// channel cannot be closed
+    CantCloseChannel,
+    /// `{sender}` doesn't own the NFT
+    InvalidOwner { sender: String },
+    /// owner is not found
+    OwnerNotFound,
+    /// nft is not found
+    NftNotFound,
+    /// nft class is not found
+    NftClassNotFound,
+    /// failed to deserialize packet data
+    PacketDataDeserialization,
+    /// failed to deserialize acknowledgement
+    AckDeserialization,
+    /// receive is not enabled
+    ReceiveDisabled { reason: String },
+    /// send is not enabled
+    SendDisabled { reason: String },
+    /// failed to parse as AccountId
+    ParseAccountFailure,
+    /// invalid port: `{port_id}`, expected `{exp_port_id}`
+    InvalidPort {
+        port_id: PortId,
+        exp_port_id: PortId,
+    },
+    /// decoding raw msg error: `{reason}`
+    DecodeRawMsg { reason: String },
+    /// unknown msg type: `{msg_type}`
+    UnknownMsgType { msg_type: String },
+    /// decoding raw bytes as UTF8 string error: `{0}`
+    Utf8Decode(Utf8Error),
+    /// other error: `{0}`
+    Other(String),
+}
+
+#[cfg(feature = "std")]
+impl std::error::Error for NftTransferError {
+    fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
+        match &self {
+            Self::ContextError(e) => Some(e),
+            Self::InvalidIdentifier(e) => Some(e),
+            Self::InvalidUri {
+                validation_error: e,
+                ..
+            } => Some(e),
+            Self::InvalidTracePortId {
+                validation_error: e,
+                ..
+            } => Some(e),
+            Self::InvalidTraceChannelId {
+                validation_error: e,
+                ..
+            } => Some(e),
+            _ => None,
+        }
+    }
+}
+
+impl From<Infallible> for NftTransferError {
+    fn from(e: Infallible) -> Self {
+        match e {}
+    }
+}
+
+impl From<ContextError> for NftTransferError {
+    fn from(err: ContextError) -> NftTransferError {
+        Self::ContextError(err)
+    }
+}
+
+impl From<IdentifierError> for NftTransferError {
+    fn from(err: IdentifierError) -> NftTransferError {
+        Self::InvalidIdentifier(err)
+    }
+}
+
+impl From<NftTransferError> for StatusValue {
+    fn from(err: NftTransferError) -> Self {
+        StatusValue::new(err.to_string()).expect("error message must not be empty")
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/events.rs b/ibc-apps/ics721-nft-transfer/types/src/events.rs
new file mode 100644
index 000000000..6f0c90579
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/events.rs
@@ -0,0 +1,214 @@
+//! Defines Non-Fungible Token Transfer (ICS-721) event types.
+use ibc_core::channel::types::acknowledgement::AcknowledgementStatus;
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+use ibc_core::router::types::event::ModuleEvent;
+
+use super::Memo;
+use crate::{PrefixedClassId, TokenId, TokenIds, MODULE_ID_STR};
+
+const EVENT_TYPE_PACKET: &str = "non_fungible_token_packet";
+const EVENT_TYPE_TIMEOUT: &str = "timeout";
+const EVENT_TYPE_TOKEN_TRACE: &str = "token_trace";
+const EVENT_TYPE_TRANSFER: &str = "ibc_nft_transfer";
+
+/// Contains all events variants that can be emitted from the NFT transfer application
+pub enum Event {
+    Recv(RecvEvent),
+    Ack(AckEvent),
+    AckStatus(AckStatusEvent),
+    Timeout(TimeoutEvent),
+    TokenTrace(TokenTraceEvent),
+    Transfer(TransferEvent),
+}
+
+/// Event emitted by the `onRecvPacket` module callback to indicate the that the
+/// `RecvPacket` message was processed
+pub struct RecvEvent {
+    pub sender: Signer,
+    pub receiver: Signer,
+    pub class: PrefixedClassId,
+    pub tokens: TokenIds,
+    pub memo: Memo,
+    pub success: bool,
+}
+
+impl From<RecvEvent> for ModuleEvent {
+    fn from(ev: RecvEvent) -> Self {
+        let RecvEvent {
+            sender,
+            receiver,
+            class,
+            tokens,
+            memo,
+            success,
+        } = ev;
+        Self {
+            kind: EVENT_TYPE_PACKET.to_string(),
+            attributes: vec![
+                ("module", MODULE_ID_STR).into(),
+                ("sender", sender).into(),
+                ("receiver", receiver).into(),
+                ("class", class).into(),
+                ("tokens", tokens).into(),
+                ("memo", memo).into(),
+                ("success", success).into(),
+            ],
+        }
+    }
+}
+
+/// Event emitted in the `onAcknowledgePacket` module callback
+pub struct AckEvent {
+    pub sender: Signer,
+    pub receiver: Signer,
+    pub class: PrefixedClassId,
+    pub tokens: TokenIds,
+    pub memo: Memo,
+    pub acknowledgement: AcknowledgementStatus,
+}
+
+impl From<AckEvent> for ModuleEvent {
+    fn from(ev: AckEvent) -> Self {
+        let AckEvent {
+            sender,
+            receiver,
+            class,
+            tokens,
+            memo,
+            acknowledgement,
+        } = ev;
+        Self {
+            kind: EVENT_TYPE_PACKET.to_string(),
+            attributes: vec![
+                ("module", MODULE_ID_STR).into(),
+                ("sender", sender).into(),
+                ("receiver", receiver).into(),
+                ("class", class).into(),
+                ("tokens", tokens).into(),
+                ("memo", memo).into(),
+                ("acknowledgement", acknowledgement).into(),
+            ],
+        }
+    }
+}
+
+/// Event emitted in the `onAcknowledgePacket` module callback to indicate
+/// whether the acknowledgement is a success or a failure
+pub struct AckStatusEvent {
+    pub acknowledgement: AcknowledgementStatus,
+}
+
+impl From<AckStatusEvent> for ModuleEvent {
+    fn from(ev: AckStatusEvent) -> Self {
+        let AckStatusEvent { acknowledgement } = ev;
+        let attr_label = match acknowledgement {
+            AcknowledgementStatus::Success(_) => "success",
+            AcknowledgementStatus::Error(_) => "error",
+        };
+
+        Self {
+            kind: EVENT_TYPE_PACKET.to_string(),
+            attributes: vec![(attr_label, acknowledgement.to_string()).into()],
+        }
+    }
+}
+
+/// Event emitted in the `onTimeoutPacket` module callback
+pub struct TimeoutEvent {
+    pub refund_receiver: Signer,
+    pub refund_class: PrefixedClassId,
+    pub refund_tokens: TokenIds,
+    pub memo: Memo,
+}
+
+impl From<TimeoutEvent> for ModuleEvent {
+    fn from(ev: TimeoutEvent) -> Self {
+        let TimeoutEvent {
+            refund_receiver,
+            refund_class,
+            refund_tokens,
+            memo,
+        } = ev;
+        Self {
+            kind: EVENT_TYPE_TIMEOUT.to_string(),
+            attributes: vec![
+                ("module", MODULE_ID_STR).into(),
+                ("refund_receiver", refund_receiver).into(),
+                ("refund_class", refund_class).into(),
+                ("refund_tokens", refund_tokens).into(),
+                ("memo", memo).into(),
+            ],
+        }
+    }
+}
+
+/// Event emitted in the `onRecvPacket` module callback when new tokens are minted
+pub struct TokenTraceEvent {
+    pub trace_hash: Option<String>,
+    pub class: PrefixedClassId,
+    pub token: TokenId,
+}
+
+impl From<TokenTraceEvent> for ModuleEvent {
+    fn from(ev: TokenTraceEvent) -> Self {
+        let TokenTraceEvent {
+            trace_hash,
+            class,
+            token,
+        } = ev;
+        let mut ev = Self {
+            kind: EVENT_TYPE_TOKEN_TRACE.to_string(),
+            attributes: vec![("class", class).into(), ("token", token).into()],
+        };
+        if let Some(hash) = trace_hash {
+            ev.attributes.push(("trace_hash", hash).into());
+        }
+        ev
+    }
+}
+
+/// Event emitted after a successful `sendTransfer`
+pub struct TransferEvent {
+    pub sender: Signer,
+    pub receiver: Signer,
+    pub class: PrefixedClassId,
+    pub tokens: TokenIds,
+    pub memo: Memo,
+}
+
+impl From<TransferEvent> for ModuleEvent {
+    fn from(ev: TransferEvent) -> Self {
+        let TransferEvent {
+            sender,
+            receiver,
+            class,
+            tokens,
+            memo,
+        } = ev;
+
+        Self {
+            kind: EVENT_TYPE_TRANSFER.to_string(),
+            attributes: vec![
+                ("sender", sender).into(),
+                ("receiver", receiver).into(),
+                ("class", class).into(),
+                ("tokens", tokens).into(),
+                ("memo", memo).into(),
+            ],
+        }
+    }
+}
+
+impl From<Event> for ModuleEvent {
+    fn from(ev: Event) -> Self {
+        match ev {
+            Event::Recv(ev) => ev.into(),
+            Event::Ack(ev) => ev.into(),
+            Event::AckStatus(ev) => ev.into(),
+            Event::Timeout(ev) => ev.into(),
+            Event::TokenTrace(ev) => ev.into(),
+            Event::Transfer(ev) => ev.into(),
+        }
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/lib.rs b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
new file mode 100644
index 000000000..b429ce1a3
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
@@ -0,0 +1,69 @@
+//! Implementation of the IBC [Non-Fungible Token
+//! Transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-721-nft-transfer/README.md)
+//! (ICS-721) data structures.
+#![no_std]
+#![forbid(unsafe_code)]
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![cfg_attr(not(test), deny(clippy::disallowed_methods, clippy::disallowed_types))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+
+#[cfg(any(test, feature = "std"))]
+extern crate std;
+
+#[cfg(feature = "serde")]
+mod class;
+#[cfg(feature = "serde")]
+pub use class::*;
+#[cfg(feature = "serde")]
+mod data;
+#[cfg(feature = "serde")]
+pub use data::*;
+#[cfg(feature = "serde")]
+pub mod events;
+#[cfg(feature = "serde")]
+pub mod msgs;
+#[cfg(feature = "serde")]
+pub mod packet;
+#[cfg(feature = "serde")]
+mod token;
+#[cfg(feature = "serde")]
+pub use token::*;
+
+#[cfg(feature = "serde")]
+pub(crate) mod serializers;
+
+pub mod error;
+mod memo;
+pub use memo::*;
+
+/// Re-exports ICS-721 NFT transfer proto types from the `ibc-proto` crate.
+pub mod proto {
+    pub use ibc_proto::ibc::apps::nft_transfer;
+}
+
+/// Module identifier for the ICS-721 application.
+pub const MODULE_ID_STR: &str = "nft_transfer";
+
+/// The port identifier that the ICS-721 applications typically bind with.
+pub const PORT_ID_STR: &str = "nft-transfer";
+
+/// ICS-721 application current version.
+pub const VERSION: &str = "ics721-1";
+
+/// The successful string used for creating an acknowledgement status,
+/// equivalent to `base64::encode(0x01)`.
+pub const ACK_SUCCESS_B64: &str = "AQ==";
+
+use ibc_core::channel::types::acknowledgement::StatusValue;
+
+/// Returns a successful acknowledgement status for the NFT transfer application.
+pub fn ack_success_b64() -> StatusValue {
+    StatusValue::new(ACK_SUCCESS_B64).expect("ack status value is never supposed to be empty")
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/memo.rs b/ibc-apps/ics721-nft-transfer/types/src/memo.rs
new file mode 100644
index 000000000..432dd4fc6
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/memo.rs
@@ -0,0 +1,54 @@
+//! Defines the memo type, which represents the string that users can include
+//! with a Non-Fungible Token Transfer
+
+use core::convert::Infallible;
+use core::fmt::{
+    Display, {self},
+};
+use core::str::FromStr;
+
+use ibc_core::primitives::prelude::*;
+
+/// Represents the token transfer memo
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, Default, PartialEq, Eq)]
+pub struct Memo(String);
+
+impl AsRef<str> for Memo {
+    fn as_ref(&self) -> &str {
+        &self.0
+    }
+}
+
+impl Display for Memo {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl From<String> for Memo {
+    fn from(memo: String) -> Self {
+        Self(memo)
+    }
+}
+
+impl FromStr for Memo {
+    type Err = Infallible;
+
+    fn from_str(memo: &str) -> Result<Self, Infallible> {
+        Ok(Self(memo.to_owned()))
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/msgs/mod.rs b/ibc-apps/ics721-nft-transfer/types/src/msgs/mod.rs
new file mode 100644
index 000000000..70f4adfef
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/msgs/mod.rs
@@ -0,0 +1,2 @@
+//! Defines the Non-Fungible Token Transfer (ICS-721) message types.
+pub mod transfer;
diff --git a/ibc-apps/ics721-nft-transfer/types/src/msgs/transfer.rs b/ibc-apps/ics721-nft-transfer/types/src/msgs/transfer.rs
new file mode 100644
index 000000000..357723f61
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/msgs/transfer.rs
@@ -0,0 +1,138 @@
+//! Defines the Non-Fungible Token Transfer message type
+
+use ibc_core::channel::types::error::PacketError;
+use ibc_core::channel::types::timeout::TimeoutHeight;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::{ChannelId, PortId};
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Timestamp;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::applications::nft_transfer::v1::MsgTransfer as RawMsgTransfer;
+use ibc_proto::Protobuf;
+
+use crate::error::NftTransferError;
+use crate::packet::PacketData;
+
+pub(crate) const TYPE_URL: &str = "/ibc.applications.nft_transfer.v1.MsgTransfer";
+
+/// Message used to build an ICS-721 Non-Fungible Token Transfer packet.
+///
+/// Note that this message is not a packet yet, as it lacks the proper sequence
+/// number, and destination port/channel. This is by design. The sender of the
+/// packet, which might be the user of a command line application, should only
+/// have to specify the information related to the transfer of the token, and
+/// let the library figure out how to build the packet properly.
+#[derive(Clone, Debug, PartialEq, Eq)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct MsgTransfer {
+    /// the port on which the packet will be sent
+    pub port_id_on_a: PortId,
+    /// the channel by which the packet will be sent
+    pub chan_id_on_a: ChannelId,
+    /// NFT transfer packet data of the packet that will be sent
+    pub packet_data: PacketData,
+    /// Timeout height relative to the current block height.
+    /// The timeout is disabled when set to None.
+    pub timeout_height_on_b: TimeoutHeight,
+    /// Timeout timestamp relative to the current block timestamp.
+    /// The timeout is disabled when set to 0.
+    pub timeout_timestamp_on_b: Timestamp,
+}
+
+impl TryFrom<RawMsgTransfer> for MsgTransfer {
+    type Error = NftTransferError;
+
+    fn try_from(raw_msg: RawMsgTransfer) -> Result<Self, Self::Error> {
+        let timeout_timestamp_on_b = Timestamp::from_nanoseconds(raw_msg.timeout_timestamp)
+            .map_err(PacketError::InvalidPacketTimestamp)
+            .map_err(ContextError::from)?;
+
+        let timeout_height_on_b: TimeoutHeight = raw_msg
+            .timeout_height
+            .try_into()
+            .map_err(ContextError::from)?;
+
+        // Packet timeout height and packet timeout timestamp cannot both be unset.
+        if !timeout_height_on_b.is_set() && !timeout_timestamp_on_b.is_set() {
+            return Err(ContextError::from(PacketError::MissingTimeout))?;
+        }
+
+        let memo = if raw_msg.memo.is_empty() {
+            None
+        } else {
+            Some(raw_msg.memo.into())
+        };
+
+        Ok(MsgTransfer {
+            port_id_on_a: raw_msg.source_port.parse()?,
+            chan_id_on_a: raw_msg.source_channel.parse()?,
+            packet_data: PacketData {
+                class_id: raw_msg.class_id.parse()?,
+                class_uri: None,
+                class_data: None,
+                token_ids: raw_msg.token_ids.try_into()?,
+                token_uris: None,
+                token_data: None,
+                sender: raw_msg.sender.into(),
+                receiver: raw_msg.receiver.into(),
+                memo,
+            },
+            timeout_height_on_b,
+            timeout_timestamp_on_b,
+        })
+    }
+}
+
+impl From<MsgTransfer> for RawMsgTransfer {
+    fn from(domain_msg: MsgTransfer) -> Self {
+        RawMsgTransfer {
+            source_port: domain_msg.port_id_on_a.to_string(),
+            source_channel: domain_msg.chan_id_on_a.to_string(),
+            class_id: domain_msg.packet_data.class_id.to_string(),
+            token_ids: domain_msg
+                .packet_data
+                .token_ids
+                .as_ref()
+                .iter()
+                .map(|t| t.to_string())
+                .collect(),
+            sender: domain_msg.packet_data.sender.to_string(),
+            receiver: domain_msg.packet_data.receiver.to_string(),
+            timeout_height: domain_msg.timeout_height_on_b.into(),
+            timeout_timestamp: domain_msg.timeout_timestamp_on_b.nanoseconds(),
+            memo: domain_msg
+                .packet_data
+                .memo
+                .map(|m| m.to_string())
+                .unwrap_or_default(),
+        }
+    }
+}
+
+impl Protobuf<RawMsgTransfer> for MsgTransfer {}
+
+impl TryFrom<Any> for MsgTransfer {
+    type Error = NftTransferError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        match raw.type_url.as_str() {
+            TYPE_URL => {
+                MsgTransfer::decode_vec(&raw.value).map_err(|e| NftTransferError::DecodeRawMsg {
+                    reason: e.to_string(),
+                })
+            }
+            _ => Err(NftTransferError::UnknownMsgType {
+                msg_type: raw.type_url,
+            }),
+        }
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/packet.rs b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
new file mode 100644
index 000000000..a870ae436
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
@@ -0,0 +1,324 @@
+//! Contains the `PacketData` type that defines the structure of NFT transfers' packet bytes
+
+use core::convert::TryFrom;
+
+use base64::prelude::BASE64_STANDARD;
+use base64::Engine;
+use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::Signer;
+use ibc_proto::ibc::applications::nft_transfer::v1::NonFungibleTokenPacketData as RawPacketData;
+
+use crate::class::{ClassData, ClassUri, PrefixedClassId};
+use crate::error::NftTransferError;
+use crate::memo::Memo;
+use crate::serializers;
+use crate::token::{TokenData, TokenIds, TokenUri};
+
+/// Defines the structure of token transfers' packet bytes
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[serde(rename_all = "camelCase")]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct PacketData {
+    #[cfg_attr(feature = "serde", serde(with = "serializers"))]
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
+    pub class_id: PrefixedClassId,
+    pub class_uri: Option<ClassUri>,
+    pub class_data: Option<ClassData>,
+    pub token_ids: TokenIds,
+    // Need `Option` to decode `null` value
+    pub token_uris: Option<Vec<TokenUri>>,
+    // Need `Option` to decode `null` value
+    pub token_data: Option<Vec<TokenData>>,
+    pub sender: Signer,
+    pub receiver: Signer,
+    pub memo: Option<Memo>,
+}
+
+impl PacketData {
+    #[allow(clippy::too_many_arguments)]
+    pub fn new(
+        class_id: PrefixedClassId,
+        class_uri: Option<ClassUri>,
+        class_data: Option<ClassData>,
+        token_ids: TokenIds,
+        token_uris: Vec<TokenUri>,
+        token_data: Vec<TokenData>,
+        sender: Signer,
+        receiver: Signer,
+        memo: Memo,
+    ) -> Result<Self, NftTransferError> {
+        let token_uris = if token_uris.is_empty() {
+            None
+        } else {
+            Some(token_uris)
+        };
+        let token_data = if token_data.is_empty() {
+            None
+        } else {
+            Some(token_data)
+        };
+        let memo = if memo.as_ref().is_empty() {
+            None
+        } else {
+            Some(memo)
+        };
+
+        let packet_data = Self {
+            class_id,
+            class_uri,
+            class_data,
+            token_ids,
+            token_uris,
+            token_data,
+            sender,
+            receiver,
+            memo,
+        };
+
+        packet_data.validate_basic()?;
+
+        Ok(packet_data)
+    }
+
+    /// Performs the basic validation of the packet data fields.
+    pub fn validate_basic(&self) -> Result<(), NftTransferError> {
+        if self.token_ids.0.is_empty() {
+            return Err(NftTransferError::NoTokenId);
+        }
+        let num = self.token_ids.0.len();
+        let num_uri = self
+            .token_uris
+            .as_ref()
+            .map(|t| t.len())
+            .unwrap_or_default();
+        let num_data = self
+            .token_data
+            .as_ref()
+            .map(|t| t.len())
+            .unwrap_or_default();
+        if (num_uri != 0 && num_uri != num) || (num_data != 0 && num_data != num) {
+            return Err(NftTransferError::TokenMismatched);
+        }
+        Ok(())
+    }
+}
+
+impl TryFrom<RawPacketData> for PacketData {
+    type Error = NftTransferError;
+
+    fn try_from(raw_pkt_data: RawPacketData) -> Result<Self, Self::Error> {
+        let class_uri = if raw_pkt_data.class_uri.is_empty() {
+            None
+        } else {
+            Some(raw_pkt_data.class_uri.parse()?)
+        };
+        let class_data = if raw_pkt_data.class_data.is_empty() {
+            None
+        } else {
+            let decoded = BASE64_STANDARD
+                .decode(raw_pkt_data.class_data)
+                .map_err(|_| NftTransferError::InvalidJsonData)?;
+            let data_str =
+                String::from_utf8(decoded).map_err(|_| NftTransferError::InvalidJsonData)?;
+            Some(data_str.parse()?)
+        };
+
+        let token_ids = raw_pkt_data.token_ids.try_into()?;
+        let token_uris: Result<Vec<TokenUri>, _> =
+            raw_pkt_data.token_uris.iter().map(|t| t.parse()).collect();
+        let token_data: Result<Vec<TokenData>, _> = raw_pkt_data
+            .token_data
+            .iter()
+            .map(|data| {
+                let decoded = BASE64_STANDARD
+                    .decode(data)
+                    .map_err(|_| NftTransferError::InvalidJsonData)?;
+                let data_str =
+                    String::from_utf8(decoded).map_err(|_| NftTransferError::InvalidJsonData)?;
+                data_str.parse()
+            })
+            .collect();
+        Self::new(
+            raw_pkt_data.class_id.parse()?,
+            class_uri,
+            class_data,
+            token_ids,
+            token_uris?,
+            token_data?,
+            raw_pkt_data.sender.into(),
+            raw_pkt_data.receiver.into(),
+            raw_pkt_data.memo.into(),
+        )
+    }
+}
+
+impl From<PacketData> for RawPacketData {
+    fn from(pkt_data: PacketData) -> Self {
+        Self {
+            class_id: pkt_data.class_id.to_string(),
+            class_uri: pkt_data
+                .class_uri
+                .map(|c| c.to_string())
+                .unwrap_or_default(),
+            class_data: pkt_data
+                .class_data
+                .map(|c| BASE64_STANDARD.encode(c.to_string()))
+                .unwrap_or_default(),
+            token_ids: pkt_data
+                .token_ids
+                .as_ref()
+                .iter()
+                .map(|t| t.to_string())
+                .collect(),
+            token_uris: pkt_data
+                .token_uris
+                .map(|uris| uris.iter().map(|t| t.to_string()).collect())
+                .unwrap_or_default(),
+            token_data: pkt_data
+                .token_data
+                .map(|data| {
+                    data.iter()
+                        .map(|t| BASE64_STANDARD.encode(t.to_string()))
+                        .collect()
+                })
+                .unwrap_or_default(),
+            sender: pkt_data.sender.to_string(),
+            receiver: pkt_data.receiver.to_string(),
+            memo: pkt_data.memo.map(|m| m.to_string()).unwrap_or_default(),
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use core::str::FromStr;
+
+    use super::*;
+
+    const DUMMY_ADDRESS: &str = "cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng";
+    const DUMMY_CLASS_ID: &str = "class";
+    const DUMMY_URI: &str = "http://example.com";
+    const DUMMY_DATA: &str =
+        r#"{"image":{"value":"binary","mime":"image/png"},"name":{"value":"Crypto Creatures"}}"#;
+
+    impl PacketData {
+        pub fn new_dummy(memo: Option<&str>) -> Self {
+            let address: Signer = DUMMY_ADDRESS.to_string().into();
+
+            Self {
+                class_id: PrefixedClassId::from_str(DUMMY_CLASS_ID).unwrap(),
+                class_uri: Some(ClassUri::from_str(DUMMY_URI).unwrap()),
+                class_data: Some(ClassData::from_str(DUMMY_DATA).unwrap()),
+                token_ids: TokenIds::try_from(vec!["token_0".to_string(), "token_1".to_string()])
+                    .unwrap(),
+                token_uris: Some(vec![
+                    TokenUri::from_str(DUMMY_URI).unwrap(),
+                    TokenUri::from_str(DUMMY_URI).unwrap(),
+                ]),
+                token_data: Some(vec![
+                    TokenData::from_str(DUMMY_DATA).unwrap(),
+                    TokenData::from_str(DUMMY_DATA).unwrap(),
+                ]),
+                sender: address.clone(),
+                receiver: address,
+                memo: memo.map(|m| m.to_string().into()),
+            }
+        }
+
+        pub fn new_min_dummy() -> Self {
+            let address: Signer = DUMMY_ADDRESS.to_string().into();
+
+            Self {
+                class_id: PrefixedClassId::from_str(DUMMY_CLASS_ID).unwrap(),
+                class_uri: None,
+                class_data: None,
+                token_ids: TokenIds::try_from(vec!["token_0".to_string()]).unwrap(),
+                token_uris: None,
+                token_data: None,
+                sender: address.clone(),
+                receiver: address,
+                memo: None,
+            }
+        }
+
+        pub fn ser_json_assert_eq(&self, json: &str) {
+            let ser = serde_json::to_string(&self).unwrap();
+            assert_eq!(ser, json);
+        }
+
+        pub fn deser_json_assert_eq(&self, json: &str) {
+            let deser: Self = serde_json::from_str(json).unwrap();
+
+            if let Some(data) = &deser.class_data {
+                assert!(data.as_ref().parse_as_ics721_data().is_ok());
+            };
+
+            if let Some(token_data) = &deser.token_data {
+                for data in token_data.iter() {
+                    assert!(data.as_ref().parse_as_ics721_data().is_ok());
+                }
+            }
+
+            assert_eq!(&deser, self);
+        }
+    }
+
+    fn dummy_min_json_packet_data() -> &'static str {
+        r#"{"classId":"class","tokenIds":["token_0"],"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng"}"#
+    }
+
+    fn dummy_min_json_packet_data_with_null() -> &'static str {
+        r#"{"classId":"class","classUri":null,"classData":null,"tokenIds":["token_0"],"tokenUris":null,"tokenData":null,"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng"}"#
+    }
+
+    fn dummy_json_packet_data() -> &'static str {
+        r#"{"classId":"class","classUri":"http://example.com/","classData":"eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0=","tokenIds":["token_0","token_1"],"tokenUris":["http://example.com/","http://example.com/"],"tokenData":["eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0=","eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0="],"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","memo":"memo"}"#
+    }
+
+    fn dummy_json_packet_data_without_memo() -> &'static str {
+        r#"{"classId":"class","classUri":"http://example.com/","classData":"eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0=","tokenIds":["token_0","token_1"],"tokenUris":["http://example.com/","http://example.com/"],"tokenData":["eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0=","eyJpbWFnZSI6eyJ2YWx1ZSI6ImJpbmFyeSIsIm1pbWUiOiJpbWFnZS9wbmcifSwibmFtZSI6eyJ2YWx1ZSI6IkNyeXB0byBDcmVhdHVyZXMifX0="],"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng"}"#
+    }
+
+    /// Ensures `PacketData` properly encodes to JSON by first converting to a
+    /// `RawPacketData` and then serializing that.
+    #[test]
+    fn test_packet_data_ser() {
+        PacketData::new_dummy(Some("memo")).ser_json_assert_eq(dummy_json_packet_data());
+    }
+
+    /// Ensures `PacketData` properly decodes from JSON by first deserializing to a
+    /// `RawPacketData` and then converting from that.
+    #[test]
+    fn test_packet_data_deser() {
+        PacketData::new_dummy(Some("memo")).deser_json_assert_eq(dummy_json_packet_data());
+        PacketData::new_dummy(None).deser_json_assert_eq(dummy_json_packet_data_without_memo());
+        PacketData::new_min_dummy().deser_json_assert_eq(dummy_min_json_packet_data());
+        PacketData::new_min_dummy().deser_json_assert_eq(dummy_min_json_packet_data_with_null());
+    }
+
+    #[test]
+    fn test_invalid_packet_data() {
+        // the number of tokens is mismatched
+        let packet_data = r#"{"class_id":"class","token_ids":["token_0","token_1"],"token_uris":["http://example.com"],"token_data":["{\"image\":{\"value\":\"binary\",\"mime\":\"image/png\"},\"name\":{\"value\":\"Crypto Creatures\"}}"],"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","memo":""}"#;
+        assert!(
+            serde_json::from_str::<PacketData>(packet_data).is_err(),
+            "num of token data is unmatched"
+        );
+
+        // No token ID
+        let packet_data = r#"{"class_id":"class","token_ids":[],"sender":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","receiver":"cosmos1wxeyh7zgn4tctjzs0vtqpc6p5cxq5t2muzl7ng","memo":""}"#;
+        assert!(
+            serde_json::from_str::<PacketData>(packet_data).is_err(),
+            "no token ID"
+        );
+    }
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/serializers.rs b/ibc-apps/ics721-nft-transfer/types/src/serializers.rs
new file mode 100644
index 000000000..65c4d2ba6
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/serializers.rs
@@ -0,0 +1,27 @@
+use core::fmt::Display;
+use core::str::FromStr;
+
+use ibc_core::primitives::prelude::*;
+use serde::{de, Deserialize, Deserializer, Serializer};
+
+// Note: This method serializes to a String instead of a str
+// in order to avoid a wasm compilation issue. Specifically,
+// str (de)serialization hits some kind of f64/f32 case
+// when compiled into wasm, but this fails validation on
+// f32/f64 wasm runtimes.
+pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
+where
+    T: Display,
+    S: Serializer,
+{
+    serializer.serialize_str(value.to_string().as_ref())
+}
+
+pub fn deserialize<'de, T, D>(deserializer: D) -> Result<T, D::Error>
+where
+    T: FromStr,
+    T::Err: Display,
+    D: Deserializer<'de>,
+{
+    T::from_str(<String>::deserialize(deserializer)?.as_str()).map_err(de::Error::custom)
+}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/token.rs b/ibc-apps/ics721-nft-transfer/types/src/token.rs
new file mode 100644
index 000000000..4965d49be
--- /dev/null
+++ b/ibc-apps/ics721-nft-transfer/types/src/token.rs
@@ -0,0 +1,268 @@
+//! Defines Non-Fungible Token Transfer (ICS-721) token types.
+use core::fmt::{self, Display};
+use core::str::FromStr;
+
+use http::Uri;
+use ibc_core::primitives::prelude::*;
+
+use crate::data::Data;
+use crate::error::NftTransferError;
+use crate::serializers;
+
+/// Token ID for an NFT
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord)]
+pub struct TokenId(String);
+
+impl AsRef<str> for TokenId {
+    fn as_ref(&self) -> &str {
+        &self.0
+    }
+}
+
+impl Display for TokenId {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for TokenId {
+    type Err = NftTransferError;
+
+    fn from_str(token_id: &str) -> Result<Self, Self::Err> {
+        if token_id.trim().is_empty() {
+            Err(NftTransferError::InvalidTokenId)
+        } else {
+            Ok(Self(token_id.to_string()))
+        }
+    }
+}
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct TokenIds(pub Vec<TokenId>);
+
+impl TokenIds {
+    pub fn as_ref(&self) -> Vec<&TokenId> {
+        self.0.iter().collect()
+    }
+}
+
+impl Display for TokenIds {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(
+            f,
+            "{}",
+            self.0
+                .iter()
+                .map(|t| t.to_string())
+                .collect::<Vec<String>>()
+                .join(",")
+        )
+    }
+}
+
+impl TryFrom<Vec<String>> for TokenIds {
+    type Error = NftTransferError;
+
+    fn try_from(token_ids: Vec<String>) -> Result<Self, Self::Error> {
+        if token_ids.is_empty() {
+            return Err(NftTransferError::NoTokenId);
+        }
+        let ids: Result<Vec<TokenId>, _> = token_ids.iter().map(|t| t.parse()).collect();
+        let mut ids = ids?;
+        ids.sort();
+        ids.dedup();
+        if ids.len() != token_ids.len() {
+            return Err(NftTransferError::DuplicatedTokenIds);
+        }
+        Ok(Self(ids))
+    }
+}
+
+/// Token URI for an NFT
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct TokenUri(
+    #[cfg_attr(feature = "serde", serde(with = "serializers"))]
+    #[cfg_attr(feature = "schema", schemars(with = "String"))]
+    Uri,
+);
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshSerialize for TokenUri {
+    fn serialize<W: borsh::maybestd::io::Write>(
+        &self,
+        writer: &mut W,
+    ) -> borsh::maybestd::io::Result<()> {
+        borsh::BorshSerialize::serialize(&self.to_string(), writer)
+    }
+}
+
+#[cfg(feature = "borsh")]
+impl borsh::BorshDeserialize for TokenUri {
+    fn deserialize_reader<R: borsh::maybestd::io::Read>(
+        reader: &mut R,
+    ) -> borsh::maybestd::io::Result<Self> {
+        let uri = String::deserialize_reader(reader)?;
+        Ok(TokenUri::from_str(&uri).map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Encode for TokenUri {
+    fn encode_to<T: parity_scale_codec::Output + ?Sized>(&self, writer: &mut T) {
+        self.to_string().encode_to(writer);
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl parity_scale_codec::Decode for TokenUri {
+    fn decode<I: parity_scale_codec::Input>(
+        input: &mut I,
+    ) -> Result<Self, parity_scale_codec::Error> {
+        let uri = String::decode(input)?;
+        TokenUri::from_str(&uri).map_err(|_| parity_scale_codec::Error::from("from str error"))
+    }
+}
+
+#[cfg(feature = "parity-scale-codec")]
+impl scale_info::TypeInfo for TokenUri {
+    type Identity = Self;
+
+    fn type_info() -> scale_info::Type {
+        scale_info::Type::builder()
+            .path(scale_info::Path::new("TokenUri", module_path!()))
+            .composite(
+                scale_info::build::Fields::unnamed()
+                    .field(|f| f.ty::<String>().type_name("String")),
+            )
+    }
+}
+
+impl Display for TokenUri {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for TokenUri {
+    type Err = NftTransferError;
+
+    fn from_str(token_uri: &str) -> Result<Self, Self::Err> {
+        match Uri::from_str(token_uri) {
+            Ok(uri) => Ok(Self(uri)),
+            Err(err) => Err(NftTransferError::InvalidUri {
+                uri: token_uri.to_string(),
+                validation_error: err,
+            }),
+        }
+    }
+}
+
+/// Token data for an NFT
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::AsRef)]
+pub struct TokenData(Data);
+
+impl Display for TokenData {
+    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
+        write!(f, "{}", self.0)
+    }
+}
+
+impl FromStr for TokenData {
+    type Err = NftTransferError;
+
+    fn from_str(token_data: &str) -> Result<Self, Self::Err> {
+        let data = Data::from_str(token_data)?;
+        Ok(Self(data))
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[cfg(feature = "serde")]
+    #[test]
+    fn test_serde_json_roundtrip() {
+        fn serde_roundtrip(token_uri: TokenUri) {
+            let serialized =
+                serde_json::to_string(&token_uri).expect("failed to serialize TokenUri");
+            let deserialized = serde_json::from_str::<TokenUri>(&serialized)
+                .expect("failed to deserialize TokenUri");
+
+            assert_eq!(deserialized, token_uri);
+        }
+
+        let uri = "/foo/bar?baz".parse::<Uri>().unwrap();
+        serde_roundtrip(TokenUri(uri));
+
+        let uri = "https://www.rust-lang.org/install.html"
+            .parse::<Uri>()
+            .unwrap();
+        serde_roundtrip(TokenUri(uri));
+    }
+
+    #[cfg(feature = "borsh")]
+    #[test]
+    fn test_borsh_roundtrip() {
+        fn borsh_roundtrip(token_uri: TokenUri) {
+            use borsh::{BorshDeserialize, BorshSerialize};
+
+            let token_uri_bytes = token_uri.try_to_vec().unwrap();
+            let res = TokenUri::try_from_slice(&token_uri_bytes).unwrap();
+
+            assert_eq!(token_uri, res);
+        }
+
+        let uri = "/foo/bar?baz".parse::<Uri>().unwrap();
+        borsh_roundtrip(TokenUri(uri));
+
+        let uri = "https://www.rust-lang.org/install.html"
+            .parse::<Uri>()
+            .unwrap();
+        borsh_roundtrip(TokenUri(uri));
+    }
+}
diff --git a/ibc-apps/src/lib.rs b/ibc-apps/src/lib.rs
index 246713011..306624bc0 100644
--- a/ibc-apps/src/lib.rs
+++ b/ibc-apps/src/lib.rs
@@ -18,3 +18,12 @@ pub mod transfer {
     #[doc(inline)]
     pub use ibc_app_transfer::*;
 }
+
+/// Re-exports the implementation of the IBC [Non-Fungible Token
+/// Transfer](https://github.com/cosmos/ibc/blob/main/spec/app/ics-721-nft-transfer/README.md)
+/// (ICS-721) application logic.
+pub mod nft_transfer {
+    #[doc(inline)]
+    #[cfg(feature = "nft-transfer")]
+    pub use ibc_app_nft_transfer::*;
+}
diff --git a/ibc-primitives/src/prelude.rs b/ibc-primitives/src/prelude.rs
index 3662f7bb9..b7ac674e9 100644
--- a/ibc-primitives/src/prelude.rs
+++ b/ibc-primitives/src/prelude.rs
@@ -2,6 +2,7 @@
 // https://doc.rust-lang.org/src/alloc/prelude/v1.rs.html
 pub use alloc::borrow::ToOwned;
 pub use alloc::boxed::Box;
+pub use alloc::collections::BTreeMap;
 pub use alloc::string::{String, ToString};
 pub use alloc::vec::Vec;
 pub use alloc::{format, str, vec};
diff --git a/ibc-testkit/src/testapp/ibc/applications/mod.rs b/ibc-testkit/src/testapp/ibc/applications/mod.rs
index 014e52f27..85baa285f 100644
--- a/ibc-testkit/src/testapp/ibc/applications/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/applications/mod.rs
@@ -1 +1,2 @@
+pub mod nft_transfer;
 pub mod transfer;
diff --git a/ibc-testkit/src/testapp/ibc/applications/nft_transfer/context.rs b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/context.rs
new file mode 100644
index 000000000..a526dcf45
--- /dev/null
+++ b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/context.rs
@@ -0,0 +1,185 @@
+use ibc::apps::nft_transfer::context::{
+    NftClassContext, NftContext, NftTransferExecutionContext, NftTransferValidationContext,
+};
+use ibc::apps::nft_transfer::types::error::NftTransferError;
+use ibc::apps::nft_transfer::types::{
+    ClassData, ClassId, ClassUri, Memo, PrefixedClassId, TokenData, TokenId, TokenUri,
+};
+use ibc::core::host::types::identifiers::{ChannelId, PortId};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Signer;
+
+use super::types::{DummyNft, DummyNftClass, DummyNftTransferModule};
+
+impl NftContext for DummyNft {
+    fn get_class_id(&self) -> &ClassId {
+        &self.class_id
+    }
+
+    fn get_id(&self) -> &TokenId {
+        &self.token_id
+    }
+
+    fn get_uri(&self) -> Option<&TokenUri> {
+        self.token_uri.as_ref()
+    }
+
+    fn get_data(&self) -> Option<&TokenData> {
+        self.token_data.as_ref()
+    }
+}
+
+impl NftClassContext for DummyNftClass {
+    fn get_id(&self) -> &ClassId {
+        &self.class_id
+    }
+
+    fn get_uri(&self) -> Option<&ClassUri> {
+        self.class_uri.as_ref()
+    }
+
+    fn get_data(&self) -> Option<&ClassData> {
+        self.class_data.as_ref()
+    }
+}
+
+impl NftTransferValidationContext for DummyNftTransferModule {
+    type AccountId = Signer;
+    type Nft = DummyNft;
+    type NftClass = DummyNftClass;
+
+    fn get_port(&self) -> Result<PortId, NftTransferError> {
+        Ok(PortId::transfer())
+    }
+
+    fn can_send_nft(&self) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn can_receive_nft(&self) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn create_or_update_class_validate(
+        &self,
+        _class_id: &PrefixedClassId,
+        _class_uri: Option<&ClassUri>,
+        _class_data: Option<&ClassData>,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn escrow_nft_validate(
+        &self,
+        _from_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _memo: &Memo,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn unescrow_nft_validate(
+        &self,
+        _to_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn mint_nft_validate(
+        &self,
+        _account: &Self::AccountId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _token_uri: Option<&TokenUri>,
+        _token_data: Option<&TokenData>,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn burn_nft_validate(
+        &self,
+        _account: &Self::AccountId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _memo: &Memo,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn get_nft(
+        &self,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+    ) -> Result<Self::Nft, NftTransferError> {
+        Ok(DummyNft::default())
+    }
+
+    fn get_nft_class(
+        &self,
+        _class_id: &PrefixedClassId,
+    ) -> Result<Self::NftClass, NftTransferError> {
+        Ok(DummyNftClass::default())
+    }
+}
+
+impl NftTransferExecutionContext for DummyNftTransferModule {
+    fn create_or_update_class_execute(
+        &self,
+        _class_id: &PrefixedClassId,
+        _class_uri: Option<&ClassUri>,
+        _class_data: Option<&ClassData>,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn escrow_nft_execute(
+        &mut self,
+        _from_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _memo: &Memo,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn unescrow_nft_execute(
+        &mut self,
+        _to_account: &Self::AccountId,
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn mint_nft_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _token_uri: Option<&TokenUri>,
+        _token_data: Option<&TokenData>,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+
+    fn burn_nft_execute(
+        &mut self,
+        _account: &Self::AccountId,
+        _class_id: &PrefixedClassId,
+        _token_id: &TokenId,
+        _memo: &Memo,
+    ) -> Result<(), NftTransferError> {
+        Ok(())
+    }
+}
diff --git a/ibc-testkit/src/testapp/ibc/applications/nft_transfer/mod.rs b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/mod.rs
new file mode 100644
index 000000000..a811b728e
--- /dev/null
+++ b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/mod.rs
@@ -0,0 +1,4 @@
+#[cfg(feature = "serde")]
+pub mod context;
+pub mod module;
+pub mod types;
diff --git a/ibc-testkit/src/testapp/ibc/applications/nft_transfer/module.rs b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/module.rs
new file mode 100644
index 000000000..06652a1dd
--- /dev/null
+++ b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/module.rs
@@ -0,0 +1,107 @@
+use ibc::core::channel::types::acknowledgement::Acknowledgement;
+use ibc::core::channel::types::channel::{Counterparty, Order};
+use ibc::core::channel::types::error::{ChannelError, PacketError};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::Version;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Signer;
+use ibc::core::router::module::Module;
+use ibc::core::router::types::module::ModuleExtras;
+
+use super::types::DummyNftTransferModule;
+
+impl Module for DummyNftTransferModule {
+    fn on_chan_open_init_validate(
+        &self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        version: &Version,
+    ) -> Result<Version, ChannelError> {
+        Ok(version.clone())
+    }
+
+    fn on_chan_open_init_execute(
+        &mut self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        version: &Version,
+    ) -> Result<(ModuleExtras, Version), ChannelError> {
+        Ok((ModuleExtras::empty(), version.clone()))
+    }
+
+    fn on_chan_open_try_validate(
+        &self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        counterparty_version: &Version,
+    ) -> Result<Version, ChannelError> {
+        Ok(counterparty_version.clone())
+    }
+
+    fn on_chan_open_try_execute(
+        &mut self,
+        _order: Order,
+        _connection_hops: &[ConnectionId],
+        _port_id: &PortId,
+        _channel_id: &ChannelId,
+        _counterparty: &Counterparty,
+        counterparty_version: &Version,
+    ) -> Result<(ModuleExtras, Version), ChannelError> {
+        Ok((ModuleExtras::empty(), counterparty_version.clone()))
+    }
+
+    fn on_recv_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Acknowledgement) {
+        (
+            ModuleExtras::empty(),
+            Acknowledgement::try_from(vec![1u8]).expect("Never fails"),
+        )
+    }
+
+    fn on_timeout_packet_validate(
+        &self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> Result<(), PacketError> {
+        Ok(())
+    }
+
+    fn on_timeout_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Result<(), PacketError>) {
+        (ModuleExtras::empty(), Ok(()))
+    }
+
+    fn on_acknowledgement_packet_validate(
+        &self,
+        _packet: &Packet,
+        _acknowledgement: &Acknowledgement,
+        _relayer: &Signer,
+    ) -> Result<(), PacketError> {
+        Ok(())
+    }
+
+    fn on_acknowledgement_packet_execute(
+        &mut self,
+        _packet: &Packet,
+        _acknowledgement: &Acknowledgement,
+        _relayer: &Signer,
+    ) -> (ModuleExtras, Result<(), PacketError>) {
+        (ModuleExtras::empty(), Ok(()))
+    }
+}
diff --git a/ibc-testkit/src/testapp/ibc/applications/nft_transfer/types.rs b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/types.rs
new file mode 100644
index 000000000..6e282fe61
--- /dev/null
+++ b/ibc-testkit/src/testapp/ibc/applications/nft_transfer/types.rs
@@ -0,0 +1,61 @@
+use ibc::apps::nft_transfer::types::{ClassData, ClassId, ClassUri, TokenData, TokenId, TokenUri};
+
+#[derive(Debug)]
+pub struct DummyNftTransferModule;
+
+#[derive(Debug)]
+pub struct DummyNft {
+    pub class_id: ClassId,
+    pub token_id: TokenId,
+    pub token_uri: Option<TokenUri>,
+    pub token_data: Option<TokenData>,
+}
+
+impl Default for DummyNft {
+    fn default() -> Self {
+        let class_id = "class_0".parse().expect("infallible");
+        let token_id = "token_0".parse().expect("infallible");
+        let token_uri = Some("http://example.com".parse().expect("infallible"));
+        let data = r#"{"name":{"value":"Crypto Creatures"},"image":{"value":"binary","mime":"image/png"}}"#;
+        let token_data = Some(data.parse().expect("infallible"));
+        Self {
+            class_id,
+            token_id,
+            token_uri,
+            token_data,
+        }
+    }
+}
+
+#[derive(Debug)]
+pub struct DummyNftClass {
+    pub class_id: ClassId,
+    pub class_uri: Option<ClassUri>,
+    pub class_data: Option<ClassData>,
+}
+
+impl Default for DummyNftClass {
+    fn default() -> Self {
+        let class_id = "class_0".parse().expect("infallible");
+        let class_uri = Some("http://example.com".parse().expect("infallible"));
+        let data = r#"{"name":{"value":"Crypto Creatures"},"image":{"value":"binary","mime":"image/png"}}"#;
+        let class_data = Some(data.parse().expect("infallible"));
+        Self {
+            class_id,
+            class_uri,
+            class_data,
+        }
+    }
+}
+
+impl DummyNftTransferModule {
+    pub fn new() -> Self {
+        Self
+    }
+}
+
+impl Default for DummyNftTransferModule {
+    fn default() -> Self {
+        Self::new()
+    }
+}
diff --git a/ibc-testkit/tests/applications/mod.rs b/ibc-testkit/tests/applications/mod.rs
index 544cab2c5..2b046ccd5 100644
--- a/ibc-testkit/tests/applications/mod.rs
+++ b/ibc-testkit/tests/applications/mod.rs
@@ -1,2 +1,4 @@
 #[cfg(feature = "serde")]
+pub mod nft_transfer;
+#[cfg(feature = "serde")]
 pub mod transfer;
diff --git a/ibc-testkit/tests/applications/nft_transfer.rs b/ibc-testkit/tests/applications/nft_transfer.rs
new file mode 100644
index 000000000..05996a534
--- /dev/null
+++ b/ibc-testkit/tests/applications/nft_transfer.rs
@@ -0,0 +1,135 @@
+use ibc::apps::nft_transfer::module::{
+    on_chan_open_init_execute, on_chan_open_init_validate, on_chan_open_try_execute,
+    on_chan_open_try_validate,
+};
+use ibc::apps::nft_transfer::types::VERSION;
+use ibc::core::channel::types::channel::{Counterparty, Order};
+use ibc::core::channel::types::Version;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::core::primitives::prelude::*;
+use ibc_testkit::testapp::ibc::applications::nft_transfer::types::DummyNftTransferModule;
+
+fn get_defaults() -> (
+    DummyNftTransferModule,
+    Order,
+    Vec<ConnectionId>,
+    PortId,
+    ChannelId,
+    Counterparty,
+) {
+    let order = Order::Unordered;
+    let connection_hops = vec![ConnectionId::new(1)];
+    let port_id = PortId::transfer();
+    let channel_id = ChannelId::new(1);
+    let counterparty = Counterparty::new(port_id.clone(), Some(channel_id.clone()));
+
+    (
+        DummyNftTransferModule,
+        order,
+        connection_hops,
+        port_id,
+        channel_id,
+        counterparty,
+    )
+}
+
+/// If the relayer passed "", indicating that it wants us to return the versions we support.
+#[test]
+fn test_on_chan_open_init_empty_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new("".to_string());
+
+    let (_, out_version) = on_chan_open_init_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the relayer passed in the only supported version (ics721-1), then return ics721-1
+#[test]
+fn test_on_chan_open_init_ics721_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new(VERSION.to_string());
+    let (_, out_version) = on_chan_open_init_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the relayer passed in an unsupported version, then fail
+#[test]
+fn test_on_chan_open_init_incorrect_version() {
+    let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let in_version = Version::new("some-unsupported-version".to_string());
+    let res = on_chan_open_init_validate(
+        &ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &in_version,
+    );
+
+    assert!(res.is_err());
+}
+
+/// If the counterparty supports ics721, then return ics721
+#[test]
+fn test_on_chan_open_try_counterparty_correct_version() {
+    let (mut ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let counterparty_version = Version::new(VERSION.to_string());
+
+    let (_, out_version) = on_chan_open_try_execute(
+        &mut ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &counterparty_version,
+    )
+    .unwrap();
+
+    assert_eq!(out_version, Version::new(VERSION.to_string()));
+}
+
+/// If the counterparty doesn't support ics721, then fail
+#[test]
+fn test_on_chan_open_try_counterparty_incorrect_version() {
+    let (ctx, order, connection_hops, port_id, channel_id, counterparty) = get_defaults();
+
+    let counterparty_version = Version::new("some-unsupported-version".to_string());
+
+    let res = on_chan_open_try_validate(
+        &ctx,
+        order,
+        &connection_hops,
+        &port_id,
+        &channel_id,
+        &counterparty,
+        &counterparty_version,
+    );
+
+    assert!(res.is_err());
+}

From 5053973072f0f955e5d11a048293712c92c4a676 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 23 Jan 2024 20:54:40 -0500
Subject: [PATCH 096/182] imp(testkit): deprecate `MockContext::with_client*`
 in favor of `MockContext::with_client_config` (#1051)

* refactor the with_client methods

* fix no timestamp in mockclient

* add Height::since to calculate height delta

* use height delta to compute block timestamp

* refactor existing tests

* add changelog

* consistent comments with pre-refactoring

* default is already mock client

* use ClientId::default as default

* remove redudant client_id setter

* rename client_state_height to latest_height

* refactor client_state_height to latest_height

* use local blocks_since

* rm Height::since method from ics02 types

* fix blocks_since

* nit: rename 1042.*.md file + set deprecation since 0.50.0

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 ...eprecate-mockcontext-withclient-methods.md |   3 +
 ibc-testkit/src/relayer/context.rs            |  27 +-
 ibc-testkit/src/testapp/ibc/core/types.rs     | 247 +++++++++---------
 .../tests/core/ics02_client/update_client.rs  | 126 +++++----
 .../tests/core/ics02_client/upgrade_client.rs |  11 +-
 .../core/ics03_connection/conn_open_ack.rs    |  23 +-
 .../ics03_connection/conn_open_confirm.rs     |  16 +-
 .../core/ics03_connection/conn_open_init.rs   |  11 +-
 .../core/ics03_connection/conn_open_try.rs    |  10 +-
 .../core/ics04_channel/acknowledgement.rs     |  20 +-
 .../core/ics04_channel/chan_close_confirm.rs  |  16 +-
 .../core/ics04_channel/chan_close_init.rs     |  16 +-
 .../tests/core/ics04_channel/chan_open_ack.rs |  37 ++-
 .../core/ics04_channel/chan_open_confirm.rs   |  30 ++-
 .../core/ics04_channel/chan_open_init.rs      |   9 +-
 .../tests/core/ics04_channel/chan_open_try.rs |  16 +-
 .../tests/core/ics04_channel/recv_packet.rs   |  20 +-
 .../tests/core/ics04_channel/send_packet.rs   |  26 +-
 .../tests/core/ics04_channel/timeout.rs       |  32 ++-
 .../core/ics04_channel/timeout_on_close.rs    |   8 +-
 20 files changed, 455 insertions(+), 249 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md

diff --git a/.changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md b/.changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md
new file mode 100644
index 000000000..900bc46eb
--- /dev/null
+++ b/.changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md
@@ -0,0 +1,3 @@
+- [ibc-testkit] Deprecate `MockContext::with_client*` in favor of
+  `MockContext::with_client_config`.
+  ([\#1049](https://github.com/cosmos/ibc-rs/issues/1049))
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index c80737603..d41331345 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -49,6 +49,7 @@ mod tests {
     use ibc::core::client::types::Height;
     use ibc::core::handler::types::msgs::MsgEnvelope;
     use ibc::core::host::types::identifiers::ChainId;
+    use ibc::core::primitives::prelude::*;
     use tracing::debug;
 
     use super::RelayerContext;
@@ -58,6 +59,7 @@ mod tests {
     use crate::relayer::error::RelayerError;
     use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
     use crate::testapp::ibc::core::router::MockRouter;
+    use crate::testapp::ibc::core::types::MockClientConfig;
 
     /// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
     /// context, assuming that the latest header on the source context is `src_header`.
@@ -125,12 +127,13 @@ mod tests {
             .host_id(chain_id_a.clone())
             .latest_height(chain_a_start_height)
             .build()
-            .with_client_parametrized_with_chain_id(
-                chain_id_b.clone(),
-                &client_on_a_for_b,
-                client_on_a_for_b_height,
-                Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-                Some(client_on_a_for_b_height),
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_b.clone())
+                    .client_id(client_on_a_for_b.clone())
+                    .latest_height(client_on_a_for_b_height)
+                    .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
+                    .build(),
             );
         // dummy; not actually used in client updates
         let mut router_a = MockRouter::new_with_transfer();
@@ -140,12 +143,12 @@ mod tests {
             .host_type(HostType::SyntheticTendermint)
             .latest_height(chain_b_start_height)
             .build()
-            .with_client_parametrized_with_chain_id(
-                chain_id_a,
-                &client_on_b_for_a,
-                client_on_b_for_a_height,
-                Some(mock_client_type()), // The target host chain is mock.
-                Some(client_on_b_for_a_height),
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_chain_id(chain_id_a)
+                    .client_id(client_on_b_for_a.clone())
+                    .latest_height(client_on_b_for_a_height)
+                    .build(),
             );
         // dummy; not actually used in client updates
         let mut router_b = MockRouter::new_with_transfer();
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index e9c914cb1..603d6d00d 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -26,13 +26,10 @@ use ibc::core::primitives::Timestamp;
 use ibc::core::router::router::Router;
 use parking_lot::Mutex;
 use tendermint_testgen::Validator as TestgenValidator;
-use tracing::debug;
 use typed_builder::TypedBuilder;
 
 use super::client_ctx::{MockClientRecord, PortChannelIdMap};
-use crate::fixtures::clients::tendermint::{
-    dummy_tm_client_state_from_header, ClientStateConfig as TmClientStateConfig,
-};
+use crate::fixtures::clients::tendermint::ClientStateConfig as TmClientStateConfig;
 use crate::fixtures::core::context::MockContextConfig;
 use crate::hosts::block::{HostBlock, HostType};
 use crate::relayer::error::RelayerError;
@@ -127,20 +124,24 @@ pub struct MockContext {
 
 #[derive(Debug, TypedBuilder)]
 pub struct MockClientConfig {
+    #[builder(default = ChainId::new("mockZ-1").expect("no error"))]
     client_chain_id: ChainId,
+    #[builder(default)]
     client_id: ClientId,
     #[builder(default = mock_client_type())]
     client_type: ClientType,
-    client_state_height: Height,
+    latest_height: Height,
     #[builder(default)]
     consensus_state_heights: Vec<Height>,
     #[builder(default = Timestamp::now())]
     latest_timestamp: Timestamp,
 
     #[builder(default = Duration::from_secs(64000))]
-    pub trusting_period: Duration,
+    trusting_period: Duration,
     #[builder(default = Duration::from_millis(3000))]
     max_clock_drift: Duration,
+    #[builder(default = Duration::from_secs(128000))]
+    unbonding_period: Duration,
 }
 
 /// Returns a MockContext with bare minimum initialization: no clients, no connections and no channels are
@@ -180,7 +181,7 @@ impl MockContext {
     /// `latest_height` determines the current height of the chain. This context
     /// has support to emulate two type of underlying chains: Mock or SyntheticTendermint.
     #[deprecated(
-        since = "0.49.2",
+        since = "0.50.0",
         note = "Please use `MockContextConfig::builder().build()` instead"
     )]
     pub fn new(
@@ -240,7 +241,7 @@ impl MockContext {
     /// `validator_history[i]` and `validator_history[i+1]` is i'th block's current and next validator set.
     /// The number of blocks will be `validator_history.len() - 1` due to the above.
     #[deprecated(
-        since = "0.49.2",
+        since = "0.50.0",
         note = "Please use `MockContextConfig::builder().build()` instead"
     )]
     pub fn new_with_validator_history(
@@ -308,8 +309,24 @@ impl MockContext {
     /// Given a client id and a height, registers a new client in the context and also associates
     /// to this client a mock client state and a mock consensus state for height `height`. The type
     /// of this client is implicitly assumed to be Mock.
+    #[deprecated(
+        since = "0.50.0",
+        note = "Please use `MockClientConfig::builder().build()` instead"
+    )]
     pub fn with_client(self, client_id: &ClientId, height: Height) -> Self {
-        self.with_client_parametrized(client_id, height, Some(mock_client_type()), Some(height))
+        // NOTE: this is wrong; the client chain ID is supposed to represent
+        // the chain ID of the counterparty chain. But at this point this is
+        // too ingrained in our tests; `with_client()` is called everywhere,
+        // which delegates to this.
+        let client_chain_id = self.host_chain_id.clone();
+
+        self.with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(client_chain_id)
+                .client_id(client_id.clone())
+                .latest_height(height)
+                .build(),
+        )
     }
 
     /// Similar to `with_client`, this function associates a client record to this context, but
@@ -317,6 +334,10 @@ impl MockContext {
     /// then the client will have type Mock, otherwise the specified type. If
     /// `consensus_state_height` is None, then the client will be initialized with a consensus
     /// state matching the same height as the client state (`client_state_height`).
+    #[deprecated(
+        since = "0.50.0",
+        note = "Please use `MockClientConfig::builder().build()` instead"
+    )]
     pub fn with_client_parametrized(
         self,
         client_id: &ClientId,
@@ -330,15 +351,23 @@ impl MockContext {
         // which delegates to this.
         let client_chain_id = self.host_chain_id.clone();
 
-        self.with_client_parametrized_with_chain_id(
-            client_chain_id,
-            client_id,
-            client_state_height,
-            client_type,
-            consensus_state_height,
+        self.with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(client_chain_id)
+                .client_id(client_id.clone())
+                .latest_height(client_state_height)
+                .client_type(client_type.unwrap_or_else(mock_client_type))
+                .consensus_state_heights(
+                    vec![consensus_state_height.unwrap_or(client_state_height)],
+                )
+                .build(),
         )
     }
 
+    #[deprecated(
+        since = "0.50.0",
+        note = "Please use `MockClientConfig::builder().build()` instead"
+    )]
     pub fn with_client_parametrized_with_chain_id(
         self,
         client_chain_id: ChainId,
@@ -347,50 +376,23 @@ impl MockContext {
         client_type: Option<ClientType>,
         consensus_state_height: Option<Height>,
     ) -> Self {
-        let cs_height = consensus_state_height.unwrap_or(client_state_height);
-
-        let client_type = client_type.unwrap_or_else(mock_client_type);
-        let (client_state, consensus_state) = if client_type.as_str() == MOCK_CLIENT_TYPE {
-            (
-                Some(
-                    MockClientState::new(
-                        MockHeader::new(client_state_height).with_current_timestamp(),
-                    )
-                    .into(),
-                ),
-                MockConsensusState::new(MockHeader::new(cs_height).with_current_timestamp()).into(),
-            )
-        } else if client_type.as_str() == TENDERMINT_CLIENT_TYPE {
-            let light_block = HostBlock::generate_tm_block(
-                client_chain_id,
-                cs_height.revision_height(),
-                Timestamp::now(),
-            );
-
-            let client_state =
-                dummy_tm_client_state_from_header(light_block.header().clone()).into();
-
-            // Return the tuple.
-            (Some(client_state), light_block.into())
-        } else {
-            panic!("unknown client type")
-        };
-        // If it's a mock client, create the corresponding mock states.
-        let consensus_states = vec![(cs_height, consensus_state)].into_iter().collect();
-
-        debug!("consensus states: {:?}", consensus_states);
-
-        let client_record = MockClientRecord {
-            client_state,
-            consensus_states,
-        };
-        self.ibc_store
-            .lock()
-            .clients
-            .insert(client_id.clone(), client_record);
-        self
+        self.with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(client_chain_id)
+                .client_id(client_id.clone())
+                .latest_height(client_state_height)
+                .client_type(client_type.unwrap_or_else(mock_client_type))
+                .consensus_state_heights(
+                    vec![consensus_state_height.unwrap_or(client_state_height)],
+                )
+                .build(),
+        )
     }
 
+    #[deprecated(
+        since = "0.50.0",
+        note = "Please use `MockClientConfig::builder().build()` instead"
+    )]
     pub fn with_client_parametrized_history(
         self,
         client_id: &ClientId,
@@ -399,15 +401,25 @@ impl MockContext {
         consensus_state_height: Option<Height>,
     ) -> Self {
         let client_chain_id = self.host_chain_id.clone();
-        self.with_client_parametrized_history_with_chain_id(
-            client_chain_id,
-            client_id,
-            client_state_height,
-            client_type,
-            consensus_state_height,
+        let current_consensus_height = consensus_state_height.unwrap_or(client_state_height);
+        let prev_consensus_height = current_consensus_height
+            .sub(1)
+            .unwrap_or(client_state_height);
+        self.with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(client_chain_id)
+                .client_id(client_id.clone())
+                .latest_height(client_state_height)
+                .client_type(client_type.unwrap_or_else(mock_client_type))
+                .consensus_state_heights(vec![prev_consensus_height, current_consensus_height])
+                .build(),
         )
     }
 
+    #[deprecated(
+        since = "0.50.0",
+        note = "Please use `MockClientConfig::builder().build()` instead"
+    )]
     pub fn with_client_parametrized_history_with_chain_id(
         self,
         client_chain_id: ChainId,
@@ -416,82 +428,56 @@ impl MockContext {
         client_type: Option<ClientType>,
         consensus_state_height: Option<Height>,
     ) -> Self {
-        let cs_height = consensus_state_height.unwrap_or(client_state_height);
-        let prev_cs_height = cs_height.clone().sub(1).unwrap_or(client_state_height);
-
-        let client_type = client_type.unwrap_or_else(mock_client_type);
-        let now = Timestamp::now();
-
-        let (client_state, consensus_state): (Option<AnyClientState>, AnyConsensusState) =
-            if client_type.as_str() == MOCK_CLIENT_TYPE {
-                // If it's a mock client, create the corresponding mock states.
-                (
-                    Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
-                    MockConsensusState::new(MockHeader::new(cs_height)).into(),
-                )
-            } else if client_type.as_str() == TENDERMINT_CLIENT_TYPE {
-                // If it's a Tendermint client, we need TM states.
-                let light_block =
-                    HostBlock::generate_tm_block(client_chain_id, cs_height.revision_height(), now);
-
-                let client_state =
-                    dummy_tm_client_state_from_header(light_block.header().clone()).into();
-
-                // Return the tuple.
-                (Some(client_state), light_block.into())
-            } else {
-                panic!("Unknown client type")
-            };
-
-        let prev_consensus_state = if client_type.as_str() == MOCK_CLIENT_TYPE {
-            MockConsensusState::new(MockHeader::new(prev_cs_height)).into()
-        } else if client_type.as_str() == TENDERMINT_CLIENT_TYPE {
-            let light_block = HostBlock::generate_tm_block(
-                self.host_chain_id.clone(),
-                prev_cs_height.revision_height(),
-                now.sub(self.block_time).expect("Never fails"),
-            );
-            light_block.into()
-        } else {
-            panic!("Unknown client type")
-        };
-
-        let consensus_states = vec![
-            (prev_cs_height, prev_consensus_state),
-            (cs_height, consensus_state),
-        ]
-        .into_iter()
-        .collect();
-
-        debug!("consensus states: {:?}", consensus_states);
-
-        let client_record = MockClientRecord {
-            client_state,
-            consensus_states,
-        };
-
-        self.ibc_store
-            .lock()
-            .clients
-            .insert(client_id.clone(), client_record);
-        self
+        let current_consensus_height = consensus_state_height.unwrap_or(client_state_height);
+        let prev_consensus_height = current_consensus_height
+            .sub(1)
+            .unwrap_or(client_state_height);
+        self.with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(client_chain_id)
+                .client_id(client_id.clone())
+                .latest_height(client_state_height)
+                .client_type(client_type.unwrap_or_else(mock_client_type))
+                .consensus_state_heights(vec![prev_consensus_height, current_consensus_height])
+                .build(),
+        )
     }
 
     pub fn with_client_config(self, client: MockClientConfig) -> Self {
         let cs_heights = if client.consensus_state_heights.is_empty() {
-            vec![client.client_state_height]
+            vec![client.latest_height]
         } else {
             client.consensus_state_heights
         };
 
+        fn blocks_since(a: Height, b: Height) -> Option<u64> {
+            (a.revision_number() == b.revision_number()
+                && a.revision_height() >= b.revision_height())
+            .then(|| a.revision_height() - b.revision_height())
+        }
+
         let (client_state, consensus_states) = match client.client_type.as_str() {
             MOCK_CLIENT_TYPE => {
                 let blocks: Vec<_> = cs_heights
                     .into_iter()
-                    .map(|cs_height| (cs_height, MockHeader::new(cs_height)))
+                    .map(|cs_height| {
+                        let n_blocks = blocks_since(client.latest_height, cs_height)
+                            .expect("less or equal height");
+                        (
+                            cs_height,
+                            MockHeader::new(cs_height).with_timestamp(
+                                client
+                                    .latest_timestamp
+                                    .sub(self.block_time * (n_blocks as u32))
+                                    .expect("never fails"),
+                            ),
+                        )
+                    })
                     .collect();
 
-                let client_state = MockClientState::new(blocks.last().expect("never fails").1);
+                let client_state = MockClientState::new(
+                    MockHeader::new(client.latest_height).with_timestamp(client.latest_timestamp),
+                );
 
                 let cs_states = blocks
                     .into_iter()
@@ -501,11 +487,11 @@ impl MockContext {
                 (client_state.into(), cs_states)
             }
             TENDERMINT_CLIENT_TYPE => {
-                let n_blocks = cs_heights.len();
                 let blocks: Vec<_> = cs_heights
                     .into_iter()
-                    .enumerate()
-                    .map(|(i, cs_height)| {
+                    .map(|cs_height| {
+                        let n_blocks = blocks_since(client.latest_height, cs_height)
+                            .expect("less or equal height");
                         (
                             cs_height,
                             HostBlock::generate_tm_block(
@@ -513,7 +499,7 @@ impl MockContext {
                                 cs_height.revision_height(),
                                 client
                                     .latest_timestamp
-                                    .sub(self.block_time * ((n_blocks - 1 - i) as u32))
+                                    .sub(self.block_time * (n_blocks as u32))
                                     .expect("never fails"),
                             ),
                         )
@@ -522,9 +508,10 @@ impl MockContext {
 
                 let client_state: TmClientState = TmClientStateConfig::builder()
                     .chain_id(client.client_chain_id)
-                    .latest_height(client.client_state_height)
+                    .latest_height(client.latest_height)
                     .trusting_period(client.trusting_period)
                     .max_clock_drift(client.max_clock_drift)
+                    .unbonding_period(client.unbonding_period)
                     .build()
                     .try_into()
                     .expect("never fails");
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 95c983f08..4a24bada3 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -43,7 +43,12 @@ fn test_update_client_ok() {
 
     let timestamp = Timestamp::now();
 
-    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let mut ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
     let height = Height::new(0, 46).unwrap();
     let msg = MsgUpdateClient {
         client_id,
@@ -100,7 +105,7 @@ fn test_consensus_state_pruning() {
             MockClientConfig::builder()
                 .client_chain_id(chain_id.clone())
                 .client_id(client_id.clone())
-                .client_state_height(client_height)
+                .latest_height(client_height)
                 .client_type(tm_client_type())
                 .trusting_period(Duration::from_secs(3))
                 .build(),
@@ -179,7 +184,12 @@ fn test_update_nonexisting_client() {
 
     let signer = dummy_account_id();
 
-    let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
 
     let router = MockRouter::new_with_transfer();
 
@@ -207,12 +217,13 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
         .host_id(ChainId::new("mockgaiaA-1").unwrap())
         .latest_height(Height::new(1, 1).unwrap())
         .build()
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
+                .latest_height(client_height)
+                .build(),
         );
 
     let mut router = MockRouter::new_with_transfer();
@@ -268,7 +279,7 @@ fn test_update_synthetic_tendermint_client_validator_change_ok() {
             MockClientConfig::builder()
                 .client_chain_id(chain_id_b.clone())
                 .client_id(client_id.clone())
-                .client_state_height(client_height)
+                .latest_height(client_height)
                 .client_type(tm_client_type())
                 .build(),
         );
@@ -360,7 +371,7 @@ fn test_update_synthetic_tendermint_client_validator_change_fail() {
             MockClientConfig::builder()
                 .client_chain_id(chain_id_b.clone())
                 .client_id(client_id.clone())
-                .client_state_height(client_height)
+                .latest_height(client_height)
                 .client_type(tm_client_type())
                 .build(),
         );
@@ -439,12 +450,17 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
         .host_id(ChainId::new("mockgaiaA-1").unwrap())
         .latest_height(Height::new(1, 1).unwrap())
         .build()
-        .with_client_parametrized_history_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
+                .latest_height(client_height)
+                .consensus_state_heights(vec![
+                    client_height.sub(1).expect("no error"),
+                    client_height,
+                ])
+                .build(),
         );
 
     let mut router = MockRouter::new_with_transfer();
@@ -499,12 +515,14 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
         .host_id(ctx_a_chain_id)
         .latest_height(start_height)
         .build()
-        .with_client_parametrized_with_chain_id(
-            ctx_b_chain_id.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(start_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(ctx_b_chain_id.clone())
+                .client_id(client_id.clone())
+                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
+                .latest_height(client_height)
+                .consensus_state_heights(vec![start_height])
+                .build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
@@ -627,11 +645,12 @@ fn test_update_synthetic_tendermint_client_lower_height() {
         .host_id(ChainId::new("mockgaiaA-1").unwrap())
         .latest_height(chain_start_height)
         .build()
-        .with_client_parametrized(
-            &client_id,
-            client_height,
-            Some(tm_client_type()), // The target host chain (B) is synthetic TM.
-            Some(client_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id.clone())
+                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
+                .latest_height(client_height)
+                .build(),
         );
 
     let router = MockRouter::new_with_transfer();
@@ -665,7 +684,12 @@ fn test_update_client_events() {
 
     let timestamp = Timestamp::now();
 
-    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let mut ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
     let mut router = MockRouter::new_with_transfer();
     let height = Height::new(0, 46).unwrap();
     let header: Any = MockHeader::new(height).with_timestamp(timestamp).into();
@@ -733,7 +757,12 @@ fn test_misbehaviour_client_ok() {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let mut ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let mut ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
     let mut router = MockRouter::new_with_transfer();
 
     let res = validate(&ctx, &router, msg_envelope.clone());
@@ -761,7 +790,12 @@ fn test_misbehaviour_nonexisting_client() {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let ctx = MockContext::default().with_client(&client_id, Height::new(0, 42).unwrap());
+    let ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
     let router = MockRouter::new_with_transfer();
     let res = validate(&ctx, &router, msg_envelope);
     assert!(res.is_err());
@@ -781,12 +815,13 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
         .host_id(ChainId::new("mockgaiaA-1").unwrap())
         .latest_height(Height::new(1, 1).unwrap())
         .build()
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()),
-            Some(client_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_type(tm_client_type())
+                .latest_height(client_height)
+                .build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
@@ -842,12 +877,13 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
         .host_id(ChainId::new("mockgaiaA-1").unwrap())
         .latest_height(Height::new(1, 1).unwrap())
         .build()
-        .with_client_parametrized_with_chain_id(
-            chain_id_b.clone(),
-            &client_id,
-            client_height,
-            Some(tm_client_type()),
-            Some(client_height),
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_chain_id(chain_id_b.clone())
+                .client_id(client_id.clone())
+                .client_type(tm_client_type())
+                .latest_height(client_height)
+                .build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
@@ -914,7 +950,7 @@ fn test_expired_client() {
             MockClientConfig::builder()
                 .client_chain_id(chain_id_b.clone())
                 .client_id(client_id.clone())
-                .client_state_height(client_height)
+                .latest_height(client_height)
                 .client_type(tm_client_type())
                 .latest_timestamp(timestamp)
                 .trusting_period(trusting_period)
@@ -952,7 +988,7 @@ fn test_client_update_max_clock_drift() {
             MockClientConfig::builder()
                 .client_chain_id(chain_id_b.clone())
                 .client_id(client_id.clone())
-                .client_state_height(client_height)
+                .latest_height(client_height)
                 .client_type(tm_client_type())
                 .latest_timestamp(timestamp)
                 .max_clock_drift(max_clock_drift)
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index dd097935f..84d5b1fbd 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -17,7 +17,7 @@ use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 
 enum Ctx {
     Default,
@@ -34,9 +34,12 @@ fn msg_upgrade_client_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<Msg
     let client_id = mock_client_type().build_client_id(0);
 
     let ctx_default = MockContext::default();
-    let ctx_with_client = ctx_default
-        .clone()
-        .with_client(&client_id, Height::new(0, 42).unwrap());
+    let ctx_with_client = ctx_default.clone().with_client_config(
+        MockClientConfig::builder()
+            .client_id(client_id.clone())
+            .latest_height(Height::new(0, 42).unwrap())
+            .build(),
+    );
     let ctx = match ctx_variant {
         Ctx::Default => ctx_default,
         Ctx::WithClient => ctx_with_client,
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 1f7dd7828..9bfa34469 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -17,7 +17,7 @@ use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_ack;
 use ibc_testkit::fixtures::core::context::MockContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use test_log::test;
 
 enum Ctx {
@@ -65,13 +65,28 @@ fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
     let ctx = match ctx {
         Ctx::New => ctx_new,
         Ctx::NewWithConnection => ctx_new
-            .with_client(&client_id, proof_height)
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(proof_height)
+                    .build(),
+            )
             .with_connection(conn_id, default_conn_end),
         Ctx::DefaultWithConnection => ctx_default
-            .with_client(&client_id, proof_height)
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(proof_height)
+                    .build(),
+            )
             .with_connection(conn_id, default_conn_end),
         Ctx::NewWithConnectionEndOpen => ctx_new
-            .with_client(&client_id, proof_height)
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(proof_height)
+                    .build(),
+            )
             .with_connection(conn_id, conn_end_open),
     };
 
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index fe83a003b..67eafe48f 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -14,7 +14,7 @@ use ibc::core::primitives::ZERO_DURATION;
 use ibc_testkit::fixtures::core::connection::dummy_conn_open_confirm;
 use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use test_log::test;
 
 enum Ctx {
@@ -49,10 +49,20 @@ fn conn_open_confirm_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenConfirm> {
     let ctx = match ctx {
         Ctx::Default => ctx_default,
         Ctx::IncorrectConnection => ctx_default
-            .with_client(&client_id, Height::new(0, 10).unwrap())
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(Height::new(0, 10).unwrap())
+                    .build(),
+            )
             .with_connection(msg.conn_id_on_b.clone(), incorrect_conn_end_state),
         Ctx::CorrectConnection => ctx_default
-            .with_client(&client_id, Height::new(0, 10).unwrap())
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(Height::new(0, 10).unwrap())
+                    .build(),
+            )
             .with_connection(msg.conn_id_on_b.clone(), correct_conn_end),
     };
 
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index 796c352ad..007be597e 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -13,7 +13,7 @@ use ibc_testkit::fixtures::core::connection::{
 };
 use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use test_log::test;
 
 enum Ctx {
@@ -41,9 +41,12 @@ fn conn_open_init_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConn
 
     let ctx_default = MockContext::default();
     let ctx = match ctx_variant {
-        Ctx::WithClient => {
-            ctx_default.with_client(&msg.client_id_on_a, Height::new(0, 10).unwrap())
-        }
+        Ctx::WithClient => ctx_default.with_client_config(
+            MockClientConfig::builder()
+                .client_id(msg.client_id_on_a.clone())
+                .latest_height(Height::new(0, 10).unwrap())
+                .build(),
+        ),
         _ => ctx_default,
     };
 
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index 18c700ba4..5afca6581 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -10,7 +10,7 @@ use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_try;
 use ibc_testkit::fixtures::core::context::MockContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use test_log::test;
 
 enum Ctx {
@@ -56,9 +56,11 @@ fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConne
         .build();
     let ctx = match ctx_variant {
         Ctx::Default => MockContext::default(),
-        Ctx::WithClient => ctx_new.with_client(
-            &msg.client_id_on_b,
-            Height::new(0, client_cons_state_height).unwrap(),
+        Ctx::WithClient => ctx_new.with_client_config(
+            MockClientConfig::builder()
+                .client_id(msg.client_id_on_b.clone())
+                .latest_height(Height::new(0, client_cons_state_height).unwrap())
+                .build(),
         ),
     };
     Fixture { ctx, msg }
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index c6d84ce47..838f51efe 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -16,7 +16,7 @@ use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_acknowledgement;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -34,7 +34,11 @@ struct Fixture {
 #[fixture]
 fn fixture() -> Fixture {
     let client_height = Height::new(0, 2).unwrap();
-    let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+    let ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .latest_height(client_height)
+            .build(),
+    );
 
     let router = MockRouter::new_with_transfer();
 
@@ -117,7 +121,11 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
         ..
     } = fixture;
     let ctx = ctx
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_channel(
             PortId::transfer(),
             ChannelId::default(),
@@ -148,7 +156,11 @@ fn ack_success_happy_path(fixture: Fixture) {
         ..
     } = fixture;
     let mut ctx: MockContext = ctx
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_channel(
             PortId::transfer(),
             ChannelId::default(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index 8133fb7f0..d337c7d4a 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -15,7 +15,7 @@ use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_confirm;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 
 #[test]
 fn test_chan_close_confirm_validate() {
@@ -53,7 +53,12 @@ fn test_chan_close_confirm_validate() {
     .unwrap();
 
     let context = default_context
-        .with_client(&client_id, client_consensus_state_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id.clone())
+                .latest_height(client_consensus_state_height)
+                .build(),
+        )
         .with_connection(conn_id, conn_end)
         .with_channel(
             msg_chan_close_confirm.port_id_on_b.clone(),
@@ -107,7 +112,12 @@ fn test_chan_close_confirm_execute() {
     .unwrap();
 
     let mut context = default_context
-        .with_client(&client_id, client_consensus_state_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id.clone())
+                .latest_height(client_consensus_state_height)
+                .build(),
+        )
         .with_connection(conn_id, conn_end)
         .with_channel(
             msg_chan_close_confirm.port_id_on_b.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 3518c7280..ccf040f85 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -15,7 +15,7 @@ use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_init;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 
 #[test]
 fn test_chan_close_init_validate() {
@@ -53,7 +53,12 @@ fn test_chan_close_init_validate() {
         let client_consensus_state_height = default_context.host_height().unwrap();
 
         default_context
-            .with_client(&client_id, client_consensus_state_height)
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(client_consensus_state_height)
+                    .build(),
+            )
             .with_connection(conn_id, conn_end)
             .with_channel(
                 msg_chan_close_init.port_id_on_a.clone(),
@@ -108,7 +113,12 @@ fn test_chan_close_init_execute() {
         let client_consensus_state_height = default_context.host_height().unwrap();
 
         default_context
-            .with_client(&client_id, client_consensus_state_height)
+            .with_client_config(
+                MockClientConfig::builder()
+                    .client_id(client_id.clone())
+                    .latest_height(client_consensus_state_height)
+                    .build(),
+            )
             .with_connection(conn_id, conn_end)
             .with_channel(
                 msg_chan_close_init.port_id_on_a.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index 74c1f0d9e..6a584e2ca 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -16,7 +16,7 @@ use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_ack;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -90,7 +90,12 @@ fn chan_open_ack_happy_path(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
             msg.port_id_on_a.clone(),
@@ -120,7 +125,12 @@ fn chan_open_ack_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut context = context
-        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
             msg.port_id_on_a.clone(),
@@ -157,7 +167,12 @@ fn chan_open_ack_fail_no_connection(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_channel(
             msg.port_id_on_a.clone(),
             msg.chan_id_on_a.clone(),
@@ -187,7 +202,12 @@ fn chan_open_ack_fail_no_channel(fixture: Fixture) {
         ..
     } = fixture;
     let context = context
-        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_a, conn_end_on_a);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
@@ -222,7 +242,12 @@ fn chan_open_ack_fail_channel_wrong_state(fixture: Fixture) {
     )
     .unwrap();
     let context = context
-        .with_client(&client_id_on_a, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
             msg.port_id_on_a.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index 4dc209817..f01b4adfd 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -15,7 +15,7 @@ use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_confirm;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -87,7 +87,12 @@ fn chan_open_confirm_validate_happy_path(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(
             msg.port_id_on_b.clone(),
@@ -117,7 +122,12 @@ fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut context = context
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(
             msg.port_id_on_b.clone(),
@@ -156,7 +166,12 @@ fn chan_open_confirm_fail_no_channel(fixture: Fixture) {
         ..
     } = fixture;
     let context = context
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
@@ -191,7 +206,12 @@ fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
     )
     .unwrap();
     let context = context
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(
             msg.port_id_on_b.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index f139bbeaa..d79f8989c 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -11,7 +11,7 @@ use ibc::core::host::ValidationContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_init;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_init;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -46,7 +46,12 @@ fn fixture() -> Fixture {
     .unwrap();
 
     let ctx = default_ctx
-        .with_client(&client_id_on_a, client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_a.clone())
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_a);
 
     Fixture { ctx, router, msg }
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index c9de6454c..35d8a55a7 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -14,7 +14,7 @@ use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_try;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -83,7 +83,12 @@ fn chan_open_try_validate_happy_path(fixture: Fixture) {
     } = fixture;
 
     let ctx = ctx
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
     let res = validate(&ctx, &router, msg);
@@ -105,7 +110,12 @@ fn chan_open_try_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut ctx = ctx
-        .with_client(&client_id_on_b, Height::new(0, proof_height).unwrap())
+        .with_client_config(
+            MockClientConfig::builder()
+                .client_id(client_id_on_b.clone())
+                .latest_height(Height::new(0, proof_height).unwrap())
+                .build(),
+        )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
     let res = execute(&mut ctx, &mut router, msg);
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 7afa94ac8..36dd40ff6 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -18,7 +18,7 @@ use ibc_testkit::fixtures::core::channel::{dummy_msg_recv_packet, dummy_raw_msg_
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::relayer::context::RelayerContext;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 use test_log::test;
 
@@ -114,7 +114,11 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
 
     let packet = &msg.packet;
     let mut context = context
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_b)
         .with_channel(
             packet.port_id_on_b.clone(),
@@ -195,7 +199,11 @@ fn recv_packet_timeout_expired(fixture: Fixture) {
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg_packet_old));
 
     let context = context
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_b)
         .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b)
         .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into())
@@ -221,7 +229,11 @@ fn recv_packet_execute_happy_path(fixture: Fixture) {
         ..
     } = fixture;
     let mut ctx = context
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_b)
         .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b);
 
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index 7a9659d55..333563ee0 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -14,7 +14,7 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_packet;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use test_log::test;
 
 #[test]
@@ -92,7 +92,11 @@ fn send_packet_processing() {
             name: "Good parameters".to_string(),
             ctx: context
                 .clone()
-                .with_client(&ClientId::default(), client_height)
+                .with_client_config(
+                    MockClientConfig::builder()
+                        .latest_height(client_height)
+                        .build(),
+                )
                 .with_connection(ConnectionId::default(), conn_end_on_a.clone())
                 .with_channel(
                     PortId::transfer(),
@@ -107,7 +111,11 @@ fn send_packet_processing() {
             name: "Packet timeout height same as destination chain height".to_string(),
             ctx: context
                 .clone()
-                .with_client(&ClientId::default(), client_height)
+                .with_client_config(
+                    MockClientConfig::builder()
+                        .latest_height(client_height)
+                        .build(),
+                )
                 .with_connection(ConnectionId::default(), conn_end_on_a.clone())
                 .with_channel(
                     PortId::transfer(),
@@ -122,7 +130,11 @@ fn send_packet_processing() {
             name: "Packet timeout height one more than destination chain height".to_string(),
             ctx: context
                 .clone()
-                .with_client(&ClientId::default(), client_height)
+                .with_client_config(
+                    MockClientConfig::builder()
+                        .latest_height(client_height)
+                        .build(),
+                )
                 .with_connection(ConnectionId::default(), conn_end_on_a.clone())
                 .with_channel(
                     PortId::transfer(),
@@ -136,7 +148,11 @@ fn send_packet_processing() {
         Test {
             name: "Packet timeout due to timestamp".to_string(),
             ctx: context
-                .with_client(&ClientId::default(), client_height)
+                .with_client_config(
+                    MockClientConfig::builder()
+                        .latest_height(client_height)
+                        .build(),
+                )
                 .with_connection(ConnectionId::default(), conn_end_on_a)
                 .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
                 .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index 2e20bb160..ce5954abf 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -16,7 +16,7 @@ use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 
 struct Fixture {
@@ -33,7 +33,11 @@ struct Fixture {
 #[fixture]
 fn fixture() -> Fixture {
     let client_height = Height::new(0, 2).unwrap();
-    let ctx = MockContext::default().with_client(&ClientId::default(), client_height);
+    let ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .latest_height(client_height)
+            .build(),
+    );
 
     let client_height = Height::new(0, 2).unwrap();
 
@@ -104,7 +108,11 @@ fn timeout_fail_no_channel(fixture: Fixture) {
         client_height,
         ..
     } = fixture;
-    let ctx = ctx.with_client(&ClientId::default(), client_height);
+    let ctx = ctx.with_client_config(
+        MockClientConfig::builder()
+            .latest_height(client_height)
+            .build(),
+    );
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
     let res = validate(&ctx, &router, msg_envelope);
 
@@ -177,7 +185,11 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
     let packet = msg.packet.clone();
 
     let mut ctx = ctx
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_a)
         .with_channel(
             PortId::transfer(),
@@ -259,7 +271,11 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
     let packet = msg.packet.clone();
 
     let mut ctx = ctx
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_a)
         .with_channel(
             PortId::transfer(),
@@ -311,7 +327,11 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
     let packet = msg.packet.clone();
 
     let mut ctx = ctx
-        .with_client(&ClientId::default(), client_height)
+        .with_client_config(
+            MockClientConfig::builder()
+                .latest_height(client_height)
+                .build(),
+        )
         .with_connection(ConnectionId::default(), conn_end_on_a)
         .with_channel(
             PortId::transfer(),
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 9c32642b9..3d6922ef8 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -15,7 +15,7 @@ use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout_on_close;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
 use rstest::*;
 
 pub struct Fixture {
@@ -30,7 +30,11 @@ pub struct Fixture {
 #[fixture]
 fn fixture() -> Fixture {
     let client_height = Height::new(0, 2).unwrap();
-    let context = MockContext::default().with_client(&ClientId::default(), client_height);
+    let context = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .latest_height(client_height)
+            .build(),
+    );
     let router = MockRouter::new_with_transfer();
 
     let height = 2;

From 171073544cbd444b78c6a9b46a6e9ea57280f8d8 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 24 Jan 2024 06:55:25 -0800
Subject: [PATCH 097/182] imp: relocate serializers.rs within the
 ibc-primitives (#1056)

---
 ...55-move-serializers-into-ibc-primitives.md |  3 +++
 ibc-apps/ics20-transfer/types/src/amount.rs   |  3 ++-
 ibc-apps/ics20-transfer/types/src/denom.rs    |  2 +-
 ibc-apps/ics20-transfer/types/src/lib.rs      |  3 ---
 .../ics721-nft-transfer/types/src/class.rs    |  2 +-
 ibc-apps/ics721-nft-transfer/types/src/lib.rs |  3 ---
 .../ics721-nft-transfer/types/src/packet.rs   |  3 +--
 .../types/src/serializers.rs                  | 27 -------------------
 .../ics721-nft-transfer/types/src/token.rs    |  2 +-
 ibc-primitives/src/lib.rs                     |  5 ++++
 .../src/serializers.rs                        | 12 ++++-----
 11 files changed, 20 insertions(+), 45 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md
 delete mode 100644 ibc-apps/ics721-nft-transfer/types/src/serializers.rs
 rename {ibc-apps/ics20-transfer/types => ibc-primitives}/src/serializers.rs (63%)

diff --git a/.changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md b/.changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md
new file mode 100644
index 000000000..495624bc2
--- /dev/null
+++ b/.changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md
@@ -0,0 +1,3 @@
+- [ibc-primitives] Relocate `serializers.rs` module to reside within the
+  `ibc-primitives` crate extending its utility for a broader range of IBC
+  applications. ([\#1055](https://github.com/cosmos/ibc-rs/issues/1055))
diff --git a/ibc-apps/ics20-transfer/types/src/amount.rs b/ibc-apps/ics20-transfer/types/src/amount.rs
index 5c3802d2d..89d3531a6 100644
--- a/ibc-apps/ics20-transfer/types/src/amount.rs
+++ b/ibc-apps/ics20-transfer/types/src/amount.rs
@@ -4,6 +4,7 @@ use core::str::FromStr;
 
 use derive_more::{Display, From, Into};
 use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::serializers;
 use primitive_types::U256;
 
 use super::error::TokenTransferError;
@@ -14,7 +15,7 @@ use super::error::TokenTransferError;
 #[derive(Copy, Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display, From, Into)]
 pub struct Amount(
     #[cfg_attr(feature = "schema", schemars(with = "String"))]
-    #[serde(serialize_with = "crate::serializers::serialize")]
+    #[serde(serialize_with = "serializers::serialize")]
     #[serde(deserialize_with = "deserialize")]
     U256,
 );
diff --git a/ibc-apps/ics20-transfer/types/src/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
index 92f60c9d3..a6ee5aad2 100644
--- a/ibc-apps/ics20-transfer/types/src/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -5,10 +5,10 @@ use core::str::FromStr;
 use derive_more::{Display, From};
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::serializers;
 use ibc_proto::ibc::applications::transfer::v1::DenomTrace as RawDenomTrace;
 
 use super::error::TokenTransferError;
-use crate::serializers;
 
 /// The "base" of a denomination.
 ///
diff --git a/ibc-apps/ics20-transfer/types/src/lib.rs b/ibc-apps/ics20-transfer/types/src/lib.rs
index fd510cc9f..44fe89603 100644
--- a/ibc-apps/ics20-transfer/types/src/lib.rs
+++ b/ibc-apps/ics20-transfer/types/src/lib.rs
@@ -34,9 +34,6 @@ pub mod msgs;
 #[cfg(feature = "serde")]
 pub mod packet;
 
-#[cfg(feature = "serde")]
-pub(crate) mod serializers;
-
 pub mod error;
 mod memo;
 pub use memo::*;
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
index 278a90a07..41d150fa0 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/class.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -6,11 +6,11 @@ use derive_more::From;
 use http::Uri;
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::serializers;
 use ibc_proto::ibc::applications::nft_transfer::v1::ClassTrace as RawClassTrace;
 
 use crate::data::Data;
 use crate::error::NftTransferError;
-use crate::serializers;
 
 /// Class ID for an NFT
 #[cfg_attr(
diff --git a/ibc-apps/ics721-nft-transfer/types/src/lib.rs b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
index b429ce1a3..8ca548269 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/lib.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
@@ -36,9 +36,6 @@ mod token;
 #[cfg(feature = "serde")]
 pub use token::*;
 
-#[cfg(feature = "serde")]
-pub(crate) mod serializers;
-
 pub mod error;
 mod memo;
 pub use memo::*;
diff --git a/ibc-apps/ics721-nft-transfer/types/src/packet.rs b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
index a870ae436..183dbc2bf 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/packet.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
@@ -5,13 +5,12 @@ use core::convert::TryFrom;
 use base64::prelude::BASE64_STANDARD;
 use base64::Engine;
 use ibc_core::primitives::prelude::*;
-use ibc_core::primitives::Signer;
+use ibc_core::primitives::{serializers, Signer};
 use ibc_proto::ibc::applications::nft_transfer::v1::NonFungibleTokenPacketData as RawPacketData;
 
 use crate::class::{ClassData, ClassUri, PrefixedClassId};
 use crate::error::NftTransferError;
 use crate::memo::Memo;
-use crate::serializers;
 use crate::token::{TokenData, TokenIds, TokenUri};
 
 /// Defines the structure of token transfers' packet bytes
diff --git a/ibc-apps/ics721-nft-transfer/types/src/serializers.rs b/ibc-apps/ics721-nft-transfer/types/src/serializers.rs
deleted file mode 100644
index 65c4d2ba6..000000000
--- a/ibc-apps/ics721-nft-transfer/types/src/serializers.rs
+++ /dev/null
@@ -1,27 +0,0 @@
-use core::fmt::Display;
-use core::str::FromStr;
-
-use ibc_core::primitives::prelude::*;
-use serde::{de, Deserialize, Deserializer, Serializer};
-
-// Note: This method serializes to a String instead of a str
-// in order to avoid a wasm compilation issue. Specifically,
-// str (de)serialization hits some kind of f64/f32 case
-// when compiled into wasm, but this fails validation on
-// f32/f64 wasm runtimes.
-pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
-where
-    T: Display,
-    S: Serializer,
-{
-    serializer.serialize_str(value.to_string().as_ref())
-}
-
-pub fn deserialize<'de, T, D>(deserializer: D) -> Result<T, D::Error>
-where
-    T: FromStr,
-    T::Err: Display,
-    D: Deserializer<'de>,
-{
-    T::from_str(<String>::deserialize(deserializer)?.as_str()).map_err(de::Error::custom)
-}
diff --git a/ibc-apps/ics721-nft-transfer/types/src/token.rs b/ibc-apps/ics721-nft-transfer/types/src/token.rs
index 4965d49be..ca8adb343 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/token.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/token.rs
@@ -4,10 +4,10 @@ use core::str::FromStr;
 
 use http::Uri;
 use ibc_core::primitives::prelude::*;
+use ibc_core::primitives::serializers;
 
 use crate::data::Data;
 use crate::error::NftTransferError;
-use crate::serializers;
 
 /// Token ID for an NFT
 #[cfg_attr(
diff --git a/ibc-primitives/src/lib.rs b/ibc-primitives/src/lib.rs
index 0e4d4bcac..a93811ece 100644
--- a/ibc-primitives/src/lib.rs
+++ b/ibc-primitives/src/lib.rs
@@ -25,6 +25,11 @@ pub use traits::*;
 mod types;
 pub use types::*;
 
+// Helper module for serializing and deserializing types through the `String`
+// primarily used by IBC applications.
+#[cfg(feature = "serde")]
+pub mod serializers;
+
 /// Re-export of common proto types from the `ibc-proto` crate.
 pub mod proto {
     pub use ibc_proto::google::protobuf::Any;
diff --git a/ibc-apps/ics20-transfer/types/src/serializers.rs b/ibc-primitives/src/serializers.rs
similarity index 63%
rename from ibc-apps/ics20-transfer/types/src/serializers.rs
rename to ibc-primitives/src/serializers.rs
index 65c4d2ba6..d61756ea1 100644
--- a/ibc-apps/ics20-transfer/types/src/serializers.rs
+++ b/ibc-primitives/src/serializers.rs
@@ -1,14 +1,14 @@
 use core::fmt::Display;
 use core::str::FromStr;
 
-use ibc_core::primitives::prelude::*;
 use serde::{de, Deserialize, Deserializer, Serializer};
 
-// Note: This method serializes to a String instead of a str
-// in order to avoid a wasm compilation issue. Specifically,
-// str (de)serialization hits some kind of f64/f32 case
-// when compiled into wasm, but this fails validation on
-// f32/f64 wasm runtimes.
+use crate::prelude::*;
+
+// Note: This method serializes to a String instead of a str in order to
+// avoid a wasm compilation issue. Specifically, str (de)serialization hits
+// some kind of f64/f32 case when compiled into wasm, but this fails
+// validation on f32/f64 wasm runtimes.
 pub fn serialize<T, S>(value: &T, serializer: S) -> Result<S::Ok, S::Error>
 where
     T: Display,

From 3577c90e363ac31553c5186113149184e01016f2 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 24 Jan 2024 07:26:35 -0800
Subject: [PATCH 098/182] imp: re-export `Timestamp` & `Duration` from
 `ibc_proto::google::protobuf` (#1054)

* imp: re-export all the proto type under ibc_proto::google::protobuf

* fix: re-export a few necessary types

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../improvements/1054-re-export-all-google-proto-types.md      | 3 +++
 ibc-primitives/src/lib.rs                                      | 3 +--
 2 files changed, 4 insertions(+), 2 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md

diff --git a/.changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md b/.changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md
new file mode 100644
index 000000000..cb022177f
--- /dev/null
+++ b/.changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md
@@ -0,0 +1,3 @@
+- [ibc-primitives] Re-exports additional google proto types, like `Timestamp`
+  and `Duration` for added convenience when developing IBC light clients or
+  applications. ([\#1054](https://github.com/cosmos/ibc-rs/pull/1054))
diff --git a/ibc-primitives/src/lib.rs b/ibc-primitives/src/lib.rs
index a93811ece..5aa99f4e5 100644
--- a/ibc-primitives/src/lib.rs
+++ b/ibc-primitives/src/lib.rs
@@ -30,8 +30,7 @@ pub use types::*;
 #[cfg(feature = "serde")]
 pub mod serializers;
 
-/// Re-export of common proto types from the `ibc-proto` crate.
 pub mod proto {
-    pub use ibc_proto::google::protobuf::Any;
+    pub use ibc_proto::google::protobuf::{Any, Duration, Timestamp};
     pub use ibc_proto::Protobuf;
 }

From 76955d047aac67faf4f41b9efed55612d44dfc07 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 24 Jan 2024 08:53:13 -0800
Subject: [PATCH 099/182] Release v0.50.0 (#1057)

* release v0.50.0

* nit

* nit
---
 .../1036-bump-ibc-proto-to-v0-41-0.md         |   0
 ...-derive-to-handle-context-with-generics.md |   0
 .../999-make-ibc-derive-work-with-ibc-core.md |   0
 .../1030-implement-08-wasm-client-types.md    |   0
 .../346-implement-ics721-nft-transfer.md      |   0
 .../1041-re-export-missing-types.md           |   0
 .../1042-deprecate-mockcontext-new-methods.md |   0
 ...1043-remove-field-access-of-mockcontext.md |   0
 ...eprecate-mockcontext-withclient-methods.md |   0
 .../1054-re-export-all-google-proto-types.md  |   2 +-
 ...55-move-serializers-into-ibc-primitives.md |   0
 .changelog/0.50.0/summary.md                  |  15 +
 CHANGELOG.md                                  |  58 ++++
 Cargo.toml                                    |  58 ++--
 RELEASES.md                                   |   4 +-
 ci/cw-check/Cargo.lock                        |  96 ++----
 ci/no-std-check/Cargo.lock                    | 304 +++++++++---------
 ci/no-std-check/Cargo.toml                    |   8 +-
 ibc-derive/Cargo.toml                         |   2 +-
 ibc-testkit/Cargo.toml                        |   2 +-
 20 files changed, 292 insertions(+), 257 deletions(-)
 rename .changelog/{unreleased => 0.50.0}/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md (100%)
 rename .changelog/{unreleased => 0.50.0}/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md (100%)
 rename .changelog/{unreleased => 0.50.0}/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md (100%)
 rename .changelog/{unreleased => 0.50.0}/features/1030-implement-08-wasm-client-types.md (100%)
 rename .changelog/{unreleased => 0.50.0}/features/346-implement-ics721-nft-transfer.md (100%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1041-re-export-missing-types.md (100%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1042-deprecate-mockcontext-new-methods.md (100%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1043-remove-field-access-of-mockcontext.md (100%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1049-deprecate-mockcontext-withclient-methods.md (100%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1054-re-export-all-google-proto-types.md (65%)
 rename .changelog/{unreleased => 0.50.0}/improvements/1055-move-serializers-into-ibc-primitives.md (100%)
 create mode 100644 .changelog/0.50.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md b/.changelog/0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
rename to .changelog/0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
diff --git a/.changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md b/.changelog/0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
rename to .changelog/0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
diff --git a/.changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md b/.changelog/0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
rename to .changelog/0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
diff --git a/.changelog/unreleased/features/1030-implement-08-wasm-client-types.md b/.changelog/0.50.0/features/1030-implement-08-wasm-client-types.md
similarity index 100%
rename from .changelog/unreleased/features/1030-implement-08-wasm-client-types.md
rename to .changelog/0.50.0/features/1030-implement-08-wasm-client-types.md
diff --git a/.changelog/unreleased/features/346-implement-ics721-nft-transfer.md b/.changelog/0.50.0/features/346-implement-ics721-nft-transfer.md
similarity index 100%
rename from .changelog/unreleased/features/346-implement-ics721-nft-transfer.md
rename to .changelog/0.50.0/features/346-implement-ics721-nft-transfer.md
diff --git a/.changelog/unreleased/improvements/1041-re-export-missing-types.md b/.changelog/0.50.0/improvements/1041-re-export-missing-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/1041-re-export-missing-types.md
rename to .changelog/0.50.0/improvements/1041-re-export-missing-types.md
diff --git a/.changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md b/.changelog/0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md
similarity index 100%
rename from .changelog/unreleased/improvements/1042-deprecate-mockcontext-new-methods.md
rename to .changelog/0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md
diff --git a/.changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md b/.changelog/0.50.0/improvements/1043-remove-field-access-of-mockcontext.md
similarity index 100%
rename from .changelog/unreleased/improvements/1043-remove-field-access-of-mockcontext.md
rename to .changelog/0.50.0/improvements/1043-remove-field-access-of-mockcontext.md
diff --git a/.changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md b/.changelog/0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md
similarity index 100%
rename from .changelog/unreleased/improvements/1049-deprecate-mockcontext-withclient-methods.md
rename to .changelog/0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md
diff --git a/.changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md b/.changelog/0.50.0/improvements/1054-re-export-all-google-proto-types.md
similarity index 65%
rename from .changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md
rename to .changelog/0.50.0/improvements/1054-re-export-all-google-proto-types.md
index cb022177f..ba220b316 100644
--- a/.changelog/unreleased/improvements/1054-re-export-all-google-proto-types.md
+++ b/.changelog/0.50.0/improvements/1054-re-export-all-google-proto-types.md
@@ -1,3 +1,3 @@
-- [ibc-primitives] Re-exports additional google proto types, like `Timestamp`
+- [ibc-primitives] Re-export additional google proto types, like `Timestamp`
   and `Duration` for added convenience when developing IBC light clients or
   applications. ([\#1054](https://github.com/cosmos/ibc-rs/pull/1054))
diff --git a/.changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md b/.changelog/0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md
similarity index 100%
rename from .changelog/unreleased/improvements/1055-move-serializers-into-ibc-primitives.md
rename to .changelog/0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md
diff --git a/.changelog/0.50.0/summary.md b/.changelog/0.50.0/summary.md
new file mode 100644
index 000000000..0e8fd1cee
--- /dev/null
+++ b/.changelog/0.50.0/summary.md
@@ -0,0 +1,15 @@
+This release introduces several noteworthy libraries. A standout addition is the
+implementation of the ICS-721 NFT transfer application, enabling the transfer of
+NFT packets across chains that support this capability.
+
+In addition, It incorporates the ICS-08 Wasm light client data structure and
+types. This empowers light client developers to create CosmWasm contracts for
+deployment on Cosmos chains compatible with the version of `ibc-go` supporting
+ICS-08 Wasm client.
+
+Moreover, it exposes additional convenient types and serializers through
+`ibc-primitives` and includes a more flexible constructor for `MockContext`
+types within the `ibc-testkit` crate, allows for testing with diverse parameter
+combinations.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e160061fe..7b962fb25 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,63 @@
 # CHANGELOG
 
+## v0.50.0
+
+*January 24, 2024*
+
+This release introduces several noteworthy libraries. A standout addition is the
+implementation of the ICS-721 NFT transfer application, enabling the transfer of
+NFT packets across chains that support this capability.
+
+In addition, It incorporates the ICS-08 Wasm light client data structure and
+types. This empowers light client developers to create CosmWasm contracts for
+deployment on Cosmos chains compatible with the version of `ibc-go` supporting
+ICS-08 Wasm client.
+
+Furthermore, this release addresses the issue with the macro derivation of the
+`ClientState` when contexts include generic types, exposes additional convenient
+types and serializers through `ibc-primitives` and includes a more flexible
+constructor for `MockContext` types within the `ibc-testkit` crate, allowing to
+write tests with diverse parameter combinations.
+
+There are no consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- [ibc] Bump `ibc-proto-rs` to v0.41.0
+  ([\#1036](https://github.com/cosmos/ibc-rs/pull/1036)).
+
+### BUG FIXES
+
+- [ibc-derive] Refactor `ClientState` macro derivation to handle contexts with
+  generic types. ([\#910](https://github.com/cosmos/ibc-rs/issues/910))
+- [ibc-derive] Adapt macro derivations to integrate with projects dependent on
+  `ibc-core` ([\#999](https://github.com/cosmos/ibc-rs/issues/999)).
+
+### FEATURES
+
+- [ibc-app-nft-transfer] Implement ICS-721 NFT transfer application
+  ([\#346](https://github.com/cosmos/ibc-rs/issues/346))
+- [ibc-client-wasm-types] Implement ICS-08 Wasm light client domain types
+  ([\#1030](https://github.com/cosmos/ibc-rs/issues/1030)).
+
+### IMPROVEMENTS
+
+- [ibc-data-types] Re-export clients' domain type from `ibc-data-types`
+  ([\#1041](https://github.com/cosmos/ibc-rs/pull/1041)).
+- [ibc-testkit] Deprecate `MockContext::new*` in favor of `MockContextConfig`.
+  ([\#1042](https://github.com/cosmos/ibc-rs/issues/1042))
+- [ibc-testkit] Remove field access of `MockContext`.
+  ([\#1043](https://github.com/cosmos/ibc-rs/issues/1043))
+- [ibc-testkit] Deprecate `MockContext::with_client*` in favor of
+  `MockContext::with_client_config`.
+  ([\#1049](https://github.com/cosmos/ibc-rs/issues/1049))
+- [ibc-primitives] Re-export additional google proto types, like `Timestamp`
+  and `Duration` for added convenience when developing IBC light clients or
+  applications. ([\#1054](https://github.com/cosmos/ibc-rs/pull/1054))
+- [ibc-primitives] Relocate `serializers.rs` module to reside within the
+  `ibc-primitives` crate extending its utility for a broader range of IBC
+  applications. ([\#1055](https://github.com/cosmos/ibc-rs/issues/1055))
+
 ## v0.49.1
 
 *January 3, 2024*
diff --git a/Cargo.toml b/Cargo.toml
index 1fce9be1a..6007c4f27 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -40,7 +40,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.49.1"
+version      = "0.50.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.64"
@@ -61,36 +61,36 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.0", default-
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.49.1", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.49.1", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.49.1", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.49.1", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.49.1", path = "./ibc-primitives", default-features = false }
-ibc-derive          = { version = "0.5.0", path = "./ibc-derive" }
+ibc                 = { version = "0.50.0", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.50.0", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.50.0", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.50.0", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.50.0", path = "./ibc-primitives", default-features = false }
+ibc-derive          = { version = "0.6.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.49.1", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.49.1", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.49.1", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.49.1", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.49.1", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.49.1", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer  = { version = "0.49.1", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-core-client       = { version = "0.50.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.50.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.50.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.50.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.50.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.50.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.50.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.50.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer  = { version = "0.50.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.49.1", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.49.1", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.49.1", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.49.1", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.49.1", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.49.1", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.49.1", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.49.1", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.49.1", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.49.1", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-client-wasm-types       = { version = "0.49.1", path = "./ibc-clients/ics08-wasm/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.49.1", path = "./ibc-apps/ics20-transfer/types", default-features = false }
-ibc-app-nft-transfer-types  = { version = "0.49.1", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.50.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.50.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.50.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.50.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.50.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.50.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.50.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.50.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.50.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.50.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-client-wasm-types       = { version = "0.50.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.50.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-app-nft-transfer-types  = { version = "0.50.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.41.0", default-features = false }
 
diff --git a/RELEASES.md b/RELEASES.md
index a5055293e..a9d4d06f0 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -7,8 +7,8 @@ Our release process is as follows:
    1. Running `unclog build -u` and copy pasting the output at the top of the
       `CHANGELOG.md` file, making sure to update the header with the new
       version.
-   2. Running `unclog release --editor <editor> --version vX.Y.Z` to create a
-      summary of all of the changes in this release.
+   2. Running `unclog release --editor <editor> vX.Y.Z` to create a summary of
+      all of the changes in this release.
       1. Your text editor will open. Write the release summary, and close the
          editor. Make sure to include a comment on whether or not the release
          contains consensus-breaking changes.
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 7933b4d6f..28ea56fe3 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -249,41 +249,6 @@ dependencies = [
  "thiserror",
 ]
 
-[[package]]
-name = "darling"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0209d94da627ab5605dcccf08bb18afa5009cfbef48d8a8b7d7bdbc79be25c5e"
-dependencies = [
- "darling_core",
- "darling_macro",
-]
-
-[[package]]
-name = "darling_core"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "177e3443818124b357d8e76f53be906d60937f0d3a90773a664fa63fa253e621"
-dependencies = [
- "fnv",
- "ident_case",
- "proc-macro2",
- "quote",
- "strsim",
- "syn 2.0.48",
-]
-
-[[package]]
-name = "darling_macro"
-version = "0.20.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "836a9bbc7ad63342d6d6e7b815ccab164bc77a2d95d84bc3117a8c0d5c98e2d5"
-dependencies = [
- "darling_core",
- "quote",
- "syn 2.0.48",
-]
-
 [[package]]
 name = "der"
 version = "0.7.8"
@@ -472,12 +437,6 @@ dependencies = [
  "paste",
 ]
 
-[[package]]
-name = "fnv"
-version = "1.0.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f9eec918d3f24069decb9af1554cad7c880e2da24a9afd88aca000531ab82c1"
-
 [[package]]
 name = "forward_ref"
 version = "1.0.0"
@@ -610,7 +569,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -619,7 +578,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -634,14 +593,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -650,12 +609,13 @@ dependencies = [
  "ibc-core-handler",
  "ibc-core-host",
  "ibc-core-router",
+ "ibc-derive",
  "ibc-primitives",
 ]
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -669,7 +629,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -690,7 +650,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -702,7 +662,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -710,7 +670,6 @@ dependencies = [
  "ibc-core-commitment-types",
  "ibc-core-handler-types",
  "ibc-core-host-types",
- "ibc-derive",
  "ibc-primitives",
  "subtle-encoding",
  "tendermint",
@@ -718,7 +677,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -736,7 +695,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -752,7 +711,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -763,7 +722,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -782,7 +741,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -796,7 +755,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -818,7 +777,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -835,7 +794,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -848,7 +807,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -861,7 +820,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -878,9 +837,8 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.5.0"
+version = "0.6.0"
 dependencies = [
- "darling",
  "proc-macro2",
  "quote",
  "syn 2.0.48",
@@ -888,7 +846,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -939,12 +897,6 @@ dependencies = [
  "sha3",
 ]
 
-[[package]]
-name = "ident_case"
-version = "1.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b9e0384b61958566e926dc50660321d12159025e767c18e043daf26b70104c39"
-
 [[package]]
 name = "impl-serde"
 version = "0.4.0"
@@ -1464,12 +1416,6 @@ version = "1.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
 
-[[package]]
-name = "strsim"
-version = "0.10.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "73473c0e59e6d5812c5dfe2a064a6444949f089e20eec9a2e5506596494e4623"
-
 [[package]]
 name = "subtle"
 version = "2.5.0"
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index e0a8bf90d..3dfe7207c 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -36,13 +36,23 @@ version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f26201604c87b1e01bd3d98f8d5d9a8fcbb815e8cedb41ffccbeb4bf593a35fe"
 
+[[package]]
+name = "aead"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d122413f284cf2d62fb1b7db97e02edb8cda96d769b16e443a4f6195e35662b0"
+dependencies = [
+ "crypto-common",
+ "generic-array 0.14.7",
+]
+
 [[package]]
 name = "ahash"
 version = "0.7.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5a824f2aa7e75a0c98c5a504fceb80649e9c35265d44525b5f94de4771a395cd"
 dependencies = [
- "getrandom 0.2.12",
+ "getrandom",
  "once_cell",
  "version_check",
 ]
@@ -54,7 +64,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "77c3a9648d43b9cd48db467b3f87fdd6e146bcc88ab0180006cef2179fe11d01"
 dependencies = [
  "cfg-if",
- "getrandom 0.2.12",
+ "getrandom",
  "once_cell",
  "version_check",
  "zerocopy",
@@ -225,7 +235,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "94893f1e0c6eeab764ade8dc4c0db24caf4fe7cbbaafc0eba0a9030f447b5185"
 dependencies = [
  "num-traits",
- "rand 0.8.5",
+ "rand",
 ]
 
 [[package]]
@@ -307,7 +317,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "93f2635620bf0b9d4576eb7bb9a38a55df78bd1205d26fa994b25911a69f212f"
 dependencies = [
  "bitcoin_hashes",
- "rand 0.8.5",
+ "rand",
  "rand_core 0.6.4",
  "serde",
  "unicode-normalization",
@@ -607,6 +617,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
 dependencies = [
  "generic-array 0.14.7",
+ "rand_core 0.6.4",
  "typenum",
 ]
 
@@ -960,7 +971,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "835c052cb0c08c1acf6ffd71c022172e18723949c8282f2b9f27efbc51e64534"
 dependencies = [
  "byteorder",
- "rand 0.8.5",
+ "rand",
  "rustc-hex",
  "static_assertions",
 ]
@@ -1109,24 +1120,23 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.1.16"
+version = "0.2.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8fc3cb4d91f53b50155bdcfd23f6a4c39ae1969c2ae85982b135750cccaf5fce"
+checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
 dependencies = [
  "cfg-if",
  "libc",
- "wasi 0.9.0+wasi-snapshot-preview1",
+ "wasi",
 ]
 
 [[package]]
-name = "getrandom"
-version = "0.2.12"
+name = "getrandom_or_panic"
+version = "0.0.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
+checksum = "6ea1015b5a70616b688dc230cfe50c8af89d972cb132d5a622814d29773b10b9"
 dependencies = [
- "cfg-if",
- "libc",
- "wasi 0.11.0+wasi-snapshot-preview1",
+ "rand",
+ "rand_core 0.6.4",
 ]
 
 [[package]]
@@ -1253,7 +1263,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1265,7 +1275,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1274,7 +1284,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1287,14 +1297,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-client-tendermint-types",
  "ibc-core-client",
@@ -1309,7 +1319,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1325,7 +1335,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-wasm-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "base64 0.21.7",
  "displaydoc",
@@ -1338,7 +1348,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-client-tendermint",
  "ibc-client-wasm-types",
@@ -1346,7 +1356,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1361,7 +1371,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1375,7 +1385,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1393,7 +1403,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1405,7 +1415,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1420,7 +1430,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1435,7 +1445,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1448,7 +1458,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1459,7 +1469,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1475,7 +1485,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1489,7 +1499,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1508,7 +1518,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1525,7 +1535,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1547,7 +1557,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1557,7 +1567,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1570,7 +1580,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1584,7 +1594,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.5.0"
+version = "0.6.0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1593,7 +1603,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.49.1"
+version = "0.50.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1808,7 +1818,7 @@ dependencies = [
  "libsecp256k1-core",
  "libsecp256k1-gen-ecmult",
  "libsecp256k1-gen-genmult",
- "rand 0.8.5",
+ "rand",
  "serde",
  "sha2 0.9.9",
  "typenum",
@@ -1934,6 +1944,18 @@ dependencies = [
  "zeroize",
 ]
 
+[[package]]
+name = "merlin"
+version = "3.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "58c38e2799fc0978b65dfff8023ec7843e2330bb462f19198840b34b6582397d"
+dependencies = [
+ "byteorder",
+ "keccak",
+ "rand_core 0.6.4",
+ "zeroize",
+]
+
 [[package]]
 name = "miniz_oxide"
 version = "0.7.1"
@@ -2086,7 +2108,7 @@ version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
 dependencies = [
- "proc-macro-crate 2.0.1",
+ "proc-macro-crate 2.0.0",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -2210,14 +2232,22 @@ dependencies = [
 
 [[package]]
 name = "proc-macro-crate"
-version = "2.0.1"
+version = "2.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97dc5fea232fc28d2f597b37c4876b348a40e33f3b02cc975c8d006d78d94b1a"
+checksum = "7e8366a6159044a37876a2b9817124296703c586a5c92e2c53751fa06d8d43e8"
 dependencies = [
- "toml_datetime",
  "toml_edit 0.20.2",
 ]
 
+[[package]]
+name = "proc-macro-crate"
+version = "3.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6d37c51ca738a55da99dc0c4a34860fd675453b8b36209178c2249bb13651284"
+dependencies = [
+ "toml_edit 0.21.0",
+]
+
 [[package]]
 name = "proc-macro2"
 version = "1.0.78"
@@ -2283,19 +2313,6 @@ version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "dc33ff2d4973d518d823d61aa239014831e521c75da58e3df4840d3f47749d09"
 
-[[package]]
-name = "rand"
-version = "0.7.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6a6b1679d49b24bbfe0c803429aa1874472f50d9b363131f0e89fc356b544d03"
-dependencies = [
- "getrandom 0.1.16",
- "libc",
- "rand_chacha 0.2.2",
- "rand_core 0.5.1",
- "rand_hc",
-]
-
 [[package]]
 name = "rand"
 version = "0.8.5"
@@ -2303,20 +2320,10 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "34af8d1a0e25924bc5b7c43c079c942339d8f0a8b57c39049bef581b46327404"
 dependencies = [
  "libc",
- "rand_chacha 0.3.1",
+ "rand_chacha",
  "rand_core 0.6.4",
 ]
 
-[[package]]
-name = "rand_chacha"
-version = "0.2.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f4c8ed856279c9737206bf725bf36935d8666ead7aa69b52be55af369d193402"
-dependencies = [
- "ppv-lite86",
- "rand_core 0.5.1",
-]
-
 [[package]]
 name = "rand_chacha"
 version = "0.3.1"
@@ -2332,9 +2339,6 @@ name = "rand_core"
 version = "0.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "90bde5296fc891b0cef12a6d03ddccc162ce7b2aff54160af9338f8d40df6d19"
-dependencies = [
- "getrandom 0.1.16",
-]
 
 [[package]]
 name = "rand_core"
@@ -2342,16 +2346,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "ec0be4795e2f6a28069bec0b5ff3e2ac9bafc99e6a9a7dc3547996c5c816922c"
 dependencies = [
- "getrandom 0.2.12",
-]
-
-[[package]]
-name = "rand_hc"
-version = "0.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca3129af7b92a17112d59ad498c6f81eaf463253766b90396d39ea7a39d6613c"
-dependencies = [
- "rand_core 0.5.1",
+ "getrandom",
 ]
 
 [[package]]
@@ -2551,15 +2546,32 @@ dependencies = [
  "arrayref",
  "arrayvec 0.5.2",
  "curve25519-dalek 2.1.3",
- "getrandom 0.1.16",
- "merlin",
- "rand 0.7.3",
+ "merlin 2.0.1",
  "rand_core 0.5.1",
  "sha2 0.8.2",
  "subtle",
  "zeroize",
 ]
 
+[[package]]
+name = "schnorrkel"
+version = "0.11.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8de18f6d8ba0aad7045f5feae07ec29899c1112584a38509a84ad7b04451eaa0"
+dependencies = [
+ "aead",
+ "arrayref",
+ "arrayvec 0.7.4",
+ "curve25519-dalek 4.1.1",
+ "getrandom_or_panic",
+ "merlin 3.0.0",
+ "rand_core 0.6.4",
+ "serde_bytes",
+ "sha2 0.10.8",
+ "subtle",
+ "zeroize",
+]
+
 [[package]]
 name = "scopeguard"
 version = "1.2.0"
@@ -2755,9 +2767,9 @@ checksum = "e6ecd384b10a64542d77071bd64bd7b231f4ed5940fba55e98c3de13824cf3d7"
 
 [[package]]
 name = "sp-application-crypto"
-version = "29.0.0"
+version = "30.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd703034c3f4f34fa4965e0d4d773f50d0f56256b1759b36016b3b1baba147d8"
+checksum = "7e4fe7a9b7fa9da76272b201e2fb3c7900d97d32a46b66af9a04dad457f73c71"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2769,9 +2781,9 @@ dependencies = [
 
 [[package]]
 name = "sp-arithmetic"
-version = "22.0.0"
+version = "23.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56dec3290d64ec9994457abe974f82fe7260c9cc32e920e4cf20611346ca7464"
+checksum = "f42721f072b421f292a072e8f52a3b3c0fbc27428f0c9fe24067bc47046bad63"
 dependencies = [
  "integer-sqrt",
  "num-traits",
@@ -2784,9 +2796,9 @@ dependencies = [
 
 [[package]]
 name = "sp-core"
-version = "27.0.0"
+version = "28.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d92c65ecfdb86fa1c4809b06a2a83d6f3bdb1ef4fe4c5a4f6df19229030d5283"
+checksum = "f230cb12575455070da0fc174815958423a0b9a641d5e304a9457113c7cb4007"
 dependencies = [
  "array-bytes",
  "bip39",
@@ -2803,14 +2815,14 @@ dependencies = [
  "itertools 0.10.5",
  "libsecp256k1",
  "log",
- "merlin",
+ "merlin 3.0.0",
  "parity-scale-codec",
  "parking_lot",
  "paste",
  "primitive-types",
- "rand 0.8.5",
+ "rand",
  "scale-info",
- "schnorrkel",
+ "schnorrkel 0.11.4",
  "secp256k1",
  "secrecy",
  "serde",
@@ -2830,9 +2842,9 @@ dependencies = [
 
 [[package]]
 name = "sp-core-hashing"
-version = "14.0.0"
+version = "15.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1936171e56a51272757760cc50883d2a8c37c650b3602a0aeed05b0c4fffc5f1"
+checksum = "1e0f4990add7b2cefdeca883c0efa99bb4d912cb2196120e1500c0cc099553b0"
 dependencies = [
  "blake2b_simd",
  "byteorder",
@@ -2844,9 +2856,9 @@ dependencies = [
 
 [[package]]
 name = "sp-debug-derive"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "90fd2c660c3e940df93f4920b183cc103443d66503f68189fa7e4b3f09996a18"
+checksum = "48d09fa0a5f7299fb81ee25ae3853d26200f7a348148aed6de76be905c007dbe"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -2855,9 +2867,9 @@ dependencies = [
 
 [[package]]
 name = "sp-externalities"
-version = "0.24.0"
+version = "0.25.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac0a1df458d0bba69bc011a3b0197049396272e497b207ad161289e7518b74bf"
+checksum = "63867ec85950ced90d4ab1bba902a47db1b1efdf2829f653945669b2bb470a9c"
 dependencies = [
  "environmental",
  "parity-scale-codec",
@@ -2867,9 +2879,9 @@ dependencies = [
 
 [[package]]
 name = "sp-io"
-version = "29.0.0"
+version = "30.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6c600c911757504c43f8c354edd1b0d327a1c2abfe947e490a6b62d8f1543d96"
+checksum = "c55f26d89feedaf0faf81688b6e1e1e81329cd8b4c6a4fd6c5b97ed9dd068b8a"
 dependencies = [
  "bytes",
  "ed25519-dalek",
@@ -2892,9 +2904,9 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.33.0"
+version = "0.34.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b955546b815ace30f63542efda71ce4e010444596cd8316f7ef49a26fb971709"
+checksum = "96806a28a62ed9ddecd0b28857b1344d029390f7c5c42a2ff9199cbf5638635c"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
@@ -2905,9 +2917,9 @@ dependencies = [
 
 [[package]]
 name = "sp-panic-handler"
-version = "12.0.0"
+version = "13.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b00e40857ed3e0187f145b037c733545c5633859f1bd1d1b09deb52805fa696a"
+checksum = "d8f5a17a0a11de029a8b811cb6e8b32ce7e02183cc04a3e965c383246798c416"
 dependencies = [
  "backtrace",
  "lazy_static",
@@ -2916,9 +2928,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "30.0.1"
+version = "31.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ee4bb0ddcc4e26cc6c770b49149e1a07ad6b34ab22d3da94330994b7145a025f"
+checksum = "a3bb49a4475d390198dfd3d41bef4564ab569fbaf1b5e38ae69b35fc01199d91"
 dependencies = [
  "docify",
  "either",
@@ -2927,7 +2939,7 @@ dependencies = [
  "log",
  "parity-scale-codec",
  "paste",
- "rand 0.8.5",
+ "rand",
  "scale-info",
  "serde",
  "simple-mermaid",
@@ -2941,9 +2953,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface"
-version = "23.0.0"
+version = "24.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d0093f419cb2ef80c8ecb583ac54e05d1105710eb84add7f9483c8ea882cbaff"
+checksum = "f66b66d8cec3d785fa6289336c1d9cbd4305d5d84f7134378c4d79ed7983e6fb"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
@@ -2960,13 +2972,13 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "16.0.0"
+version = "17.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5ebdb4aff8286f5095871b2f950037d690edb0fed0590af5f6735352533a53b6"
+checksum = "cfaf6e85b2ec12a4b99cd6d8d57d083e30c94b7f1b0d8f93547121495aae6f0c"
 dependencies = [
  "Inflector",
  "expander",
- "proc-macro-crate 2.0.1",
+ "proc-macro-crate 3.1.0",
  "proc-macro2",
  "quote",
  "syn 2.0.48",
@@ -2974,15 +2986,15 @@ dependencies = [
 
 [[package]]
 name = "sp-state-machine"
-version = "0.34.0"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0f5027dceaa62f3c18f40593ee6a898df69c70e84e01450a17293511c4f3c46c"
+checksum = "718c779ad1d6fcc0be64c7ce030b33fa44b5c8914b3a1319ef63bb5f27fb98df"
 dependencies = [
  "hash-db",
  "log",
  "parity-scale-codec",
  "parking_lot",
- "rand 0.8.5",
+ "rand",
  "smallvec",
  "sp-core",
  "sp-externalities",
@@ -2996,15 +3008,15 @@ dependencies = [
 
 [[package]]
 name = "sp-std"
-version = "13.0.0"
+version = "14.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "71323a3b5f189085d11123ce397b3cdfaec4437071243b51f68a38a4833fbaa7"
+checksum = "12f8ee986414b0a9ad741776762f4083cd3a5128449b982a3919c4df36874834"
 
 [[package]]
 name = "sp-storage"
-version = "18.0.0"
+version = "19.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d5300c9012180259489a97167f4c45cf3362446e5f0d0c66b6e9342968be8f22"
+checksum = "1fb92d7b24033a8a856d6e20dd980b653cbd7af7ec471cc988b1b7c1d2e3a32b"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
@@ -3016,9 +3028,9 @@ dependencies = [
 
 [[package]]
 name = "sp-tracing"
-version = "15.0.0"
+version = "16.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16b63d14c3214b8b5fe35b67bd61124b5f080cc9d1312b227e0c6cc2a198461e"
+checksum = "0351810b9d074df71c4514c5228ed05c250607cba131c1c9d1526760ab69c05c"
 dependencies = [
  "parity-scale-codec",
  "sp-std",
@@ -3029,19 +3041,18 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "28.0.0"
+version = "29.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5cbc3ad723c9addc4b7aafbe8bfabf638c39be3c911e11f58e924e17554003ac"
+checksum = "2e4d24d84a0beb44a71dcac1b41980e1edf7fb722c7f3046710136a283cd479b"
 dependencies = [
  "ahash 0.8.7",
  "hash-db",
- "hashbrown 0.13.2",
  "lazy_static",
  "memory-db",
  "nohash-hasher",
  "parity-scale-codec",
  "parking_lot",
- "rand 0.8.5",
+ "rand",
  "scale-info",
  "schnellru",
  "sp-core",
@@ -3055,9 +3066,9 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "19.0.0"
+version = "20.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4ef2e859d3cde7294c3bf691f8f64244a6a9bb67e53c65729b129318757070e"
+checksum = "9ef97172c42eb4c6c26506f325f48463e9bc29b2034a587f1b9e48c751229bee"
 dependencies = [
  "anyhow",
  "impl-trait-for-tuples",
@@ -3069,9 +3080,9 @@ dependencies = [
 
 [[package]]
 name = "sp-weights"
-version = "26.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8813a9942a3b900d5ce109875b91ff8ae7eb5849545ebb6464c22aa21e42622e"
+checksum = "9e874bdf9dd3fd3242f5b7867a4eaedd545b02f29041a46d222a9d9d5caaaa5c"
 dependencies = [
  "bounded-collections",
  "parity-scale-codec",
@@ -3128,7 +3139,7 @@ checksum = "e620c7098893ba667438b47169c00aacdd9e7c10e042250ce2b60b087ec97328"
 dependencies = [
  "hmac 0.11.0",
  "pbkdf2",
- "schnorrkel",
+ "schnorrkel 0.9.1",
  "sha2 0.9.9",
  "zeroize",
 ]
@@ -3352,9 +3363,9 @@ dependencies = [
 
 [[package]]
 name = "toml_datetime"
-version = "0.6.3"
+version = "0.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
+checksum = "3550f4e9685620ac18a50ed434eb3aec30db8ba93b0287467bca5826ea25baf1"
 dependencies = [
  "serde",
 ]
@@ -3383,6 +3394,17 @@ dependencies = [
  "winnow",
 ]
 
+[[package]]
+name = "toml_edit"
+version = "0.21.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d34d383cd00a163b4a5b85053df514d45bc330f6de7737edfe0a93311d1eaa03"
+dependencies = [
+ "indexmap 2.1.0",
+ "toml_datetime",
+ "winnow",
+]
+
 [[package]]
 name = "tracing"
 version = "0.1.40"
@@ -3488,7 +3510,7 @@ checksum = "97fee6b57c6a41524a810daee9286c02d7752c4253064d0b05472833a438f675"
 dependencies = [
  "cfg-if",
  "digest 0.10.7",
- "rand 0.8.5",
+ "rand",
  "static_assertions",
 ]
 
@@ -3575,8 +3597,8 @@ dependencies = [
  "arrayref",
  "constcat",
  "digest 0.10.7",
- "rand 0.8.5",
- "rand_chacha 0.3.1",
+ "rand",
+ "rand_chacha",
  "rand_core 0.6.4",
  "sha2 0.10.8",
  "sha3",
@@ -3594,12 +3616,6 @@ dependencies = [
  "winapi-util",
 ]
 
-[[package]]
-name = "wasi"
-version = "0.9.0+wasi-snapshot-preview1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cccddf32554fecc6acb585f82a32a72e28b48f8c4c1883ddfeeeaa96f7d8e519"
-
 [[package]]
 name = "wasi"
 version = "0.11.0+wasi-snapshot-preview1"
@@ -3782,7 +3798,7 @@ dependencies = [
  "memfd",
  "memoffset",
  "paste",
- "rand 0.8.5",
+ "rand",
  "rustix 0.36.17",
  "wasmtime-asm-macros",
  "wasmtime-environ",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 481d50bd5..815a42f96 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -15,10 +15,10 @@ tendermint = { version = "0.34", default-features = false }
 tendermint-proto = { version = "0.34", default-features = false }
 tendermint-light-client-verifier = { version = "0.34", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "27.0.0", default-features = false, optional = true }
-sp-io = { version = "29.0.0", default-features = false, optional = true }
-sp-runtime = { version = "30.0.1", default-features = false, optional = true }
-sp-std = { version = "13.0.0", default-features = false, optional = true }
+sp-core = { version = "28.0.0", default-features = false, optional = true }
+sp-io = { version = "30.0.0", default-features = false, optional = true }
+sp-runtime = { version = "31.0.1", default-features = false, optional = true }
+sp-std = { version = "14.0.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 0b9764de6..830595fbd 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name        = "ibc-derive"
-version     = "0.5.0"
+version     = "0.6.0"
 license     = { workspace = true }
 repository  = { workspace = true }
 edition     = { workspace = true }
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index e020657a6..032f03cdb 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -37,7 +37,7 @@ tendermint         = { workspace = true }
 tendermint-testgen = { workspace = true }
 
 [dev-dependencies]
-env_logger         = "0.10.0"
+env_logger         = "0.11.0"
 rstest             = { workspace = true }
 tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
 test-log           = { version = "0.2.13", features = ["trace"] }

From 24a09d0c393e94085a962418b01508398cd5f7ab Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 24 Jan 2024 09:26:23 -0800
Subject: [PATCH 100/182] fix: add missing package fields (#1058)

---
 ibc-clients/ics08-wasm/types/Cargo.toml | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index fe645d132..1db31f114 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -2,9 +2,17 @@
 name = "ibc-client-wasm-types"
 version      = { workspace = true }
 authors      = { workspace = true }
-license      = { workspace = true }
-rust-version = { workspace = true }
 edition      = { workspace = true }
+rust-version = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+keywords     = ["blockchain", "cosmos", "ibc", "wasm", "ics08"]
+readme       = "./../../README.md"
+description  = """
+    Maintained by `ibc-rs`, encapsulates essential ICS-08 Wasm Light Client data structures and domain types,
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    to facilitate development and integration across diverse IBC-enabled projects.
+"""
 
 [dependencies]
 # external dependencies

From 0546c6cf5ab2972c2f88f6271b8126733d5fca41 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 26 Jan 2024 04:14:27 -0800
Subject: [PATCH 101/182] fix(ibc-client-tendermint-types): drop frozen height
 check in `TryFrom` of  `TmClientState` (#1062)

* Fix issues related to frozen height of tendermint client.

* fix: ease frozen height check within TryFrom for TmClientState

* nit: set correct vallue for the frozen height in test

* nit

* use rstest cases

* add check for is_frozen

---------

Co-authored-by: Rivers Yang <rivers.yang@icloud.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 ...ease-frozen-height-check-ics07-try-from.md |  3 ++
 .../ics07-tendermint/src/client_state.rs      |  5 +++
 .../types/src/client_state.rs                 | 23 ++++------
 .../src/fixtures/clients/tendermint.rs        | 45 +++++++++++--------
 4 files changed, 43 insertions(+), 33 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md

diff --git a/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md b/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
new file mode 100644
index 000000000..40e230d61
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
@@ -0,0 +1,3 @@
+- [ibc-client-tendermint-types] Ease frozen Height check in the tendermint
+  `ClientState` protobuf deserialization
+  ([\#1061](https://github.com/cosmos/ibc-rs/issues/1061))
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index f9c7eb332..f4e4390ba 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -401,6 +401,11 @@ where
         _client_message: Any,
         _update_kind: &UpdateKind,
     ) -> Result<(), ClientError> {
+        // NOTE: frozen height is  set to `Height {revision_height: 0,
+        // revision_number: 1}` and it is the same for all misbehaviour. This
+        // aligns with the
+        // [`ibc-go`](https://github.com/cosmos/ibc-go/blob/0e3f428e66d6fc0fc6b10d2f3c658aaa5000daf7/modules/light-clients/07-tendermint/misbehaviour.go#L18-L19)
+        // implementation.
         let frozen_client_state = self.0.clone().with_frozen_height(Height::min(0));
 
         let wrapped_frozen_client_state = ClientState::from(frozen_client_state);
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index b1f755711..1c6001e22 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -12,7 +12,6 @@ use ibc_core_host_types::identifiers::ChainId;
 use ibc_primitives::prelude::*;
 use ibc_primitives::ZERO_DURATION;
 use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::client::v1::Height as RawHeight;
 use ibc_proto::ibc::lightclients::tendermint::v1::ClientState as RawTmClientState;
 use ibc_proto::Protobuf;
 use tendermint::chain::id::MAX_LENGTH as MaxChainIdLen;
@@ -62,6 +61,7 @@ impl ClientState {
         latest_height: Height,
         proof_specs: ProofSpecs,
         upgrade_path: Vec<String>,
+        frozen_height: Option<Height>,
         allow_update: AllowUpdate,
     ) -> Self {
         Self {
@@ -74,11 +74,13 @@ impl ClientState {
             proof_specs,
             upgrade_path,
             allow_update,
-            frozen_height: None,
+            frozen_height,
             verifier: ProdVerifier::default(),
         }
     }
 
+    /// Constructs a new Tendermint `ClientState` by given parameters and checks
+    /// if the parameters are valid.
     #[allow(clippy::too_many_arguments)]
     pub fn new(
         chain_id: ChainId,
@@ -100,6 +102,7 @@ impl ClientState {
             latest_height,
             proof_specs,
             upgrade_path,
+            None, // New valid client must not be frozen.
             allow_update,
         );
         client_state.validate()?;
@@ -283,13 +286,7 @@ impl TryFrom<RawTmClientState> for ClientState {
         // In `RawClientState`, a `frozen_height` of `0` means "not frozen".
         // See:
         // https://github.com/cosmos/ibc-go/blob/8422d0c4c35ef970539466c5bdec1cd27369bab3/modules/light-clients/07-tendermint/types/client_state.go#L74
-        if raw
-            .frozen_height
-            .and_then(|h| Height::try_from(h).ok())
-            .is_some()
-        {
-            return Err(Error::FrozenHeightNotAllowed);
-        }
+        let frozen_height = raw.frozen_height.and_then(|h| Height::try_from(h).ok());
 
         // We use set this deprecated field just so that we can properly convert
         // it back in its raw form
@@ -308,6 +305,7 @@ impl TryFrom<RawTmClientState> for ClientState {
             latest_height,
             raw.proof_specs.into(),
             raw.upgrade_path,
+            frozen_height,
             allow_update,
         );
 
@@ -324,12 +322,7 @@ impl From<ClientState> for RawTmClientState {
             trusting_period: Some(value.trusting_period.into()),
             unbonding_period: Some(value.unbonding_period.into()),
             max_clock_drift: Some(value.max_clock_drift.into()),
-            frozen_height: Some(value.frozen_height.map(|height| height.into()).unwrap_or(
-                RawHeight {
-                    revision_number: 0,
-                    revision_height: 0,
-                },
-            )),
+            frozen_height: value.frozen_height.map(|height| height.into()),
             latest_height: Some(value.latest_height.into()),
             proof_specs: value.proof_specs.into(),
             upgrade_path: value.upgrade_path,
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index 03828d78f..39f8de82f 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -169,16 +169,27 @@ pub fn dummy_ics07_header() -> Header {
 mod tests {
 
     use ibc::primitives::proto::Any;
+    use rstest::rstest;
 
     use super::*;
 
-    #[test]
-    fn tm_client_state_conversions_healthy() {
+    #[rstest]
+    // try conversions for when the client is not frozen
+    #[case::valid_client(0, 0, false)]
+    // try conversions for when the client is frozen
+    #[case::frozen_client(0, 1, true)]
+    fn tm_client_state_conversions_healthy(
+        #[case] revision_number: u64,
+        #[case] revision_height: u64,
+        #[case] is_frozen: bool,
+    ) {
+        let frozen_height = RawHeight {
+            revision_number,
+            revision_height,
+        };
+
         // check client state creation path from a proto type
-        let tm_client_state_from_raw = dummy_tm_client_state_from_raw(RawHeight {
-            revision_number: 0,
-            revision_height: 0,
-        });
+        let tm_client_state_from_raw = dummy_tm_client_state_from_raw(frozen_height);
         assert!(tm_client_state_from_raw.is_ok());
 
         let any_from_tm_client_state = Any::from(
@@ -189,11 +200,21 @@ mod tests {
         );
         let tm_client_state_from_any = ClientStateType::try_from(any_from_tm_client_state);
         assert!(tm_client_state_from_any.is_ok());
+        assert_eq!(
+            Some(is_frozen),
+            tm_client_state_from_any
+                .as_ref()
+                .map(|x| x.is_frozen())
+                .ok()
+        );
         assert_eq!(
             tm_client_state_from_raw.expect("Never fails"),
             tm_client_state_from_any.expect("Never fails").into()
         );
+    }
 
+    #[test]
+    fn tm_client_state_from_header_healthy() {
         // check client state creation path from a tendermint header
         let tm_header = dummy_tendermint_header();
         let tm_client_state_from_header = dummy_tm_client_state_from_header(tm_header);
@@ -205,16 +226,4 @@ mod tests {
             tm_client_state_from_any.expect("Never fails").into()
         );
     }
-
-    #[test]
-    fn tm_client_state_malformed_with_frozen_height() {
-        let tm_client_state_from_raw = dummy_tm_client_state_from_raw(RawHeight {
-            revision_number: 0,
-            revision_height: 10,
-        });
-        match tm_client_state_from_raw {
-            Err(Error::FrozenHeightNotAllowed) => {}
-            _ => panic!("Expected to fail with FrozenHeightNotAllowed error"),
-        }
-    }
 }

From 4718ca62e5e7facc9b87f78af337166f470d072f Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 26 Jan 2024 04:15:03 -0800
Subject: [PATCH 102/182] fix(ibc): add missing dependencies for feature flags
 across multiple crates (#1060)

* fix: add missing dependencies for some feature flags

* fix: derive serde attr on ics20 serializer imports

* ease serde derive on ICS20 & ICS721 types

* imp: ease serde derive on ics20 and ics721 types

* nit: fix the name of v0.50.0 dir under changelog

* nit
---
 ...1059-add-missing-deps-for-feature-flags.md |  2 ++
 ...60-ease-serde-derive-on-ics20-721-types.md |  2 ++
 .../1036-bump-ibc-proto-to-v0-41-0.md         |  0
 ...-derive-to-handle-context-with-generics.md |  0
 .../999-make-ibc-derive-work-with-ibc-core.md |  0
 .../1030-implement-08-wasm-client-types.md    |  0
 .../346-implement-ics721-nft-transfer.md      |  0
 .../1041-re-export-missing-types.md           |  0
 .../1042-deprecate-mockcontext-new-methods.md |  0
 ...1043-remove-field-access-of-mockcontext.md |  0
 ...eprecate-mockcontext-withclient-methods.md |  0
 .../1054-re-export-all-google-proto-types.md  |  0
 ...55-move-serializers-into-ibc-primitives.md |  0
 .changelog/{0.50.0 => v0.50.0}/summary.md     |  0
 ibc-apps/ics20-transfer/src/lib.rs            |  1 -
 ibc-apps/ics20-transfer/types/src/amount.rs   |  5 +++--
 ibc-apps/ics20-transfer/types/src/denom.rs    |  1 +
 ibc-apps/ics20-transfer/types/src/lib.rs      | 19 +++++------------
 .../ics721-nft-transfer/types/src/class.rs    |  1 +
 .../ics721-nft-transfer/types/src/data.rs     |  6 ++++++
 ibc-apps/ics721-nft-transfer/types/src/lib.rs | 21 ++++++-------------
 .../ics721-nft-transfer/types/src/packet.rs   |  6 ++++--
 .../ics721-nft-transfer/types/src/token.rs    |  1 +
 ibc-clients/ics08-wasm/types/Cargo.toml       |  1 +
 ibc-core/Cargo.toml                           |  5 +++++
 ibc-core/ics02-client/context/Cargo.toml      |  1 +
 ibc-core/ics02-client/types/Cargo.toml        |  3 ++-
 ibc-core/ics03-connection/Cargo.toml          |  1 +
 ibc-core/ics24-host/Cargo.toml                |  2 ++
 ibc-core/ics24-host/cosmos/Cargo.toml         |  1 +
 ibc-core/ics25-handler/Cargo.toml             |  4 ++++
 ibc-data-types/Cargo.toml                     |  3 +++
 32 files changed, 51 insertions(+), 35 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md
 create mode 100644 .changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md
 rename .changelog/{0.50.0 => v0.50.0}/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/features/1030-implement-08-wasm-client-types.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/features/346-implement-ics721-nft-transfer.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1041-re-export-missing-types.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1042-deprecate-mockcontext-new-methods.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1043-remove-field-access-of-mockcontext.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1049-deprecate-mockcontext-withclient-methods.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1054-re-export-all-google-proto-types.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/improvements/1055-move-serializers-into-ibc-primitives.md (100%)
 rename .changelog/{0.50.0 => v0.50.0}/summary.md (100%)

diff --git a/.changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md b/.changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md
new file mode 100644
index 000000000..42592cb58
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md
@@ -0,0 +1,2 @@
+- [ibc] Add missing dependencies for some feature flags across multiple crates
+  ([\#1059](https://github.com/cosmos/ibc-rs/issues/1059))
diff --git a/.changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md b/.changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md
new file mode 100644
index 000000000..7d6fd9306
--- /dev/null
+++ b/.changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md
@@ -0,0 +1,2 @@
+- [ibc-apps] Ease `serde` derive on `ICS-20` and `ICS-721` types
+  ([\#1060](https://github.com/cosmos/ibc-rs/pull/1060))
diff --git a/.changelog/0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md b/.changelog/v0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
similarity index 100%
rename from .changelog/0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
rename to .changelog/v0.50.0/breaking-changes/1036-bump-ibc-proto-to-v0-41-0.md
diff --git a/.changelog/0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md b/.changelog/v0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
similarity index 100%
rename from .changelog/0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
rename to .changelog/v0.50.0/bug-fixes/910-refactor-client-state-derive-to-handle-context-with-generics.md
diff --git a/.changelog/0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md b/.changelog/v0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
similarity index 100%
rename from .changelog/0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
rename to .changelog/v0.50.0/bug-fixes/999-make-ibc-derive-work-with-ibc-core.md
diff --git a/.changelog/0.50.0/features/1030-implement-08-wasm-client-types.md b/.changelog/v0.50.0/features/1030-implement-08-wasm-client-types.md
similarity index 100%
rename from .changelog/0.50.0/features/1030-implement-08-wasm-client-types.md
rename to .changelog/v0.50.0/features/1030-implement-08-wasm-client-types.md
diff --git a/.changelog/0.50.0/features/346-implement-ics721-nft-transfer.md b/.changelog/v0.50.0/features/346-implement-ics721-nft-transfer.md
similarity index 100%
rename from .changelog/0.50.0/features/346-implement-ics721-nft-transfer.md
rename to .changelog/v0.50.0/features/346-implement-ics721-nft-transfer.md
diff --git a/.changelog/0.50.0/improvements/1041-re-export-missing-types.md b/.changelog/v0.50.0/improvements/1041-re-export-missing-types.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1041-re-export-missing-types.md
rename to .changelog/v0.50.0/improvements/1041-re-export-missing-types.md
diff --git a/.changelog/0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md b/.changelog/v0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md
rename to .changelog/v0.50.0/improvements/1042-deprecate-mockcontext-new-methods.md
diff --git a/.changelog/0.50.0/improvements/1043-remove-field-access-of-mockcontext.md b/.changelog/v0.50.0/improvements/1043-remove-field-access-of-mockcontext.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1043-remove-field-access-of-mockcontext.md
rename to .changelog/v0.50.0/improvements/1043-remove-field-access-of-mockcontext.md
diff --git a/.changelog/0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md b/.changelog/v0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md
rename to .changelog/v0.50.0/improvements/1049-deprecate-mockcontext-withclient-methods.md
diff --git a/.changelog/0.50.0/improvements/1054-re-export-all-google-proto-types.md b/.changelog/v0.50.0/improvements/1054-re-export-all-google-proto-types.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1054-re-export-all-google-proto-types.md
rename to .changelog/v0.50.0/improvements/1054-re-export-all-google-proto-types.md
diff --git a/.changelog/0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md b/.changelog/v0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md
similarity index 100%
rename from .changelog/0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md
rename to .changelog/v0.50.0/improvements/1055-move-serializers-into-ibc-primitives.md
diff --git a/.changelog/0.50.0/summary.md b/.changelog/v0.50.0/summary.md
similarity index 100%
rename from .changelog/0.50.0/summary.md
rename to .changelog/v0.50.0/summary.md
diff --git a/ibc-apps/ics20-transfer/src/lib.rs b/ibc-apps/ics20-transfer/src/lib.rs
index 8c2c31d9c..2f2bec601 100644
--- a/ibc-apps/ics20-transfer/src/lib.rs
+++ b/ibc-apps/ics20-transfer/src/lib.rs
@@ -24,7 +24,6 @@ pub mod types {
     pub use ibc_app_transfer_types::*;
 }
 
-#[cfg(feature = "serde")]
 pub mod context;
 #[cfg(feature = "serde")]
 pub mod handler;
diff --git a/ibc-apps/ics20-transfer/types/src/amount.rs b/ibc-apps/ics20-transfer/types/src/amount.rs
index 89d3531a6..7754f4723 100644
--- a/ibc-apps/ics20-transfer/types/src/amount.rs
+++ b/ibc-apps/ics20-transfer/types/src/amount.rs
@@ -4,6 +4,7 @@ use core::str::FromStr;
 
 use derive_more::{Display, From, Into};
 use ibc_core::primitives::prelude::*;
+#[cfg(feature = "serde")]
 use ibc_core::primitives::serializers;
 use primitive_types::U256;
 
@@ -15,8 +16,8 @@ use super::error::TokenTransferError;
 #[derive(Copy, Clone, Debug, Eq, PartialEq, PartialOrd, Ord, Display, From, Into)]
 pub struct Amount(
     #[cfg_attr(feature = "schema", schemars(with = "String"))]
-    #[serde(serialize_with = "serializers::serialize")]
-    #[serde(deserialize_with = "deserialize")]
+    #[cfg_attr(feature = "serde", serde(serialize_with = "serializers::serialize"))]
+    #[cfg_attr(feature = "serde", serde(deserialize_with = "deserialize"))]
     U256,
 );
 
diff --git a/ibc-apps/ics20-transfer/types/src/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
index a6ee5aad2..c76eaf062 100644
--- a/ibc-apps/ics20-transfer/types/src/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -5,6 +5,7 @@ use core::str::FromStr;
 use derive_more::{Display, From};
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
+#[cfg(feature = "serde")]
 use ibc_core::primitives::serializers;
 use ibc_proto::ibc::applications::transfer::v1::DenomTrace as RawDenomTrace;
 
diff --git a/ibc-apps/ics20-transfer/types/src/lib.rs b/ibc-apps/ics20-transfer/types/src/lib.rs
index 44fe89603..9ef3e8413 100644
--- a/ibc-apps/ics20-transfer/types/src/lib.rs
+++ b/ibc-apps/ics20-transfer/types/src/lib.rs
@@ -15,27 +15,18 @@
 #[cfg(any(test, feature = "std"))]
 extern crate std;
 
-#[cfg(feature = "serde")]
 mod amount;
-#[cfg(feature = "serde")]
-pub use amount::*;
-#[cfg(feature = "serde")]
 mod coin;
-#[cfg(feature = "serde")]
-pub use coin::*;
-#[cfg(feature = "serde")]
 mod denom;
-#[cfg(feature = "serde")]
+mod memo;
+
+pub use amount::*;
+pub use coin::*;
 pub use denom::*;
-#[cfg(feature = "serde")]
+pub mod error;
 pub mod events;
-#[cfg(feature = "serde")]
 pub mod msgs;
-#[cfg(feature = "serde")]
 pub mod packet;
-
-pub mod error;
-mod memo;
 pub use memo::*;
 /// Re-exports `U256` from `primitive-types` crate for convenience.
 pub use primitive_types::U256;
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
index 41d150fa0..adbc95f92 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/class.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -6,6 +6,7 @@ use derive_more::From;
 use http::Uri;
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
+#[cfg(feature = "serde")]
 use ibc_core::primitives::serializers;
 use ibc_proto::ibc::applications::nft_transfer::v1::ClassTrace as RawClassTrace;
 
diff --git a/ibc-apps/ics721-nft-transfer/types/src/data.rs b/ibc-apps/ics721-nft-transfer/types/src/data.rs
index 098c8c094..c94e9ee31 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/data.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/data.rs
@@ -2,7 +2,9 @@
 use core::fmt::{self, Display, Formatter};
 use core::str::FromStr;
 
+#[cfg(feature = "serde")]
 use base64::prelude::BASE64_STANDARD;
+#[cfg(feature = "serde")]
 use base64::Engine;
 use ibc_core::primitives::prelude::*;
 use mime::Mime;
@@ -25,6 +27,7 @@ use crate::error::NftTransferError;
 #[derive(Clone, Debug, Default, PartialEq, Eq, derive_more::From)]
 pub struct Data(String);
 
+#[cfg(feature = "serde")]
 impl Data {
     /// Parses the data in the format specified by ICS-721.
     pub fn parse_as_ics721_data(&self) -> Result<Ics721Data, NftTransferError> {
@@ -46,6 +49,7 @@ impl FromStr for Data {
     }
 }
 
+#[cfg(feature = "serde")]
 impl serde::Serialize for Data {
     fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
     where
@@ -55,6 +59,7 @@ impl serde::Serialize for Data {
     }
 }
 
+#[cfg(feature = "serde")]
 impl<'de> serde::Deserialize<'de> for Data {
     fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
     where
@@ -86,6 +91,7 @@ impl<'de> serde::Deserialize<'de> for Data {
 #[derive(Clone, Debug, Default, PartialEq, Eq)]
 pub struct Ics721Data(BTreeMap<String, DataValue>);
 
+#[cfg(feature = "serde")]
 impl FromStr for Ics721Data {
     type Err = NftTransferError;
 
diff --git a/ibc-apps/ics721-nft-transfer/types/src/lib.rs b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
index 8ca548269..7a55e1368 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/lib.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
@@ -17,28 +17,19 @@
 #[cfg(any(test, feature = "std"))]
 extern crate std;
 
-#[cfg(feature = "serde")]
 mod class;
-#[cfg(feature = "serde")]
-pub use class::*;
-#[cfg(feature = "serde")]
 mod data;
-#[cfg(feature = "serde")]
-pub use data::*;
-#[cfg(feature = "serde")]
+mod memo;
+mod token;
+
 pub mod events;
-#[cfg(feature = "serde")]
 pub mod msgs;
-#[cfg(feature = "serde")]
+pub use class::*;
+pub use data::*;
 pub mod packet;
-#[cfg(feature = "serde")]
-mod token;
-#[cfg(feature = "serde")]
+pub use memo::*;
 pub use token::*;
-
 pub mod error;
-mod memo;
-pub use memo::*;
 
 /// Re-exports ICS-721 NFT transfer proto types from the `ibc-proto` crate.
 pub mod proto {
diff --git a/ibc-apps/ics721-nft-transfer/types/src/packet.rs b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
index 183dbc2bf..efa8e6264 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/packet.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
@@ -5,7 +5,9 @@ use core::convert::TryFrom;
 use base64::prelude::BASE64_STANDARD;
 use base64::Engine;
 use ibc_core::primitives::prelude::*;
-use ibc_core::primitives::{serializers, Signer};
+#[cfg(feature = "serde")]
+use ibc_core::primitives::serializers;
+use ibc_core::primitives::Signer;
 use ibc_proto::ibc::applications::nft_transfer::v1::NonFungibleTokenPacketData as RawPacketData;
 
 use crate::class::{ClassData, ClassUri, PrefixedClassId};
@@ -15,7 +17,7 @@ use crate::token::{TokenData, TokenIds, TokenUri};
 
 /// Defines the structure of token transfers' packet bytes
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[serde(rename_all = "camelCase")]
+#[cfg_attr(feature = "serde", serde(rename_all = "camelCase"))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[cfg_attr(
     feature = "parity-scale-codec",
diff --git a/ibc-apps/ics721-nft-transfer/types/src/token.rs b/ibc-apps/ics721-nft-transfer/types/src/token.rs
index ca8adb343..6128bb630 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/token.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/token.rs
@@ -4,6 +4,7 @@ use core::str::FromStr;
 
 use http::Uri;
 use ibc_core::primitives::prelude::*;
+#[cfg(feature = "serde")]
 use ibc_core::primitives::serializers;
 
 use crate::data::Data;
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index 1db31f114..a04c64f48 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -36,6 +36,7 @@ default = ["std"]
 std = [
 	"ibc-core-client/std",
 	"ibc-core-host-types/std",
+	"ibc-primitives/std",
 	"ibc-proto/std",
 	"base64/std",
 	"serde/std"
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
index f19a89432..277e4a438 100644
--- a/ibc-core/Cargo.toml
+++ b/ibc-core/Cargo.toml
@@ -37,6 +37,7 @@ std = [
     "ibc-core-host/std",
     "ibc-core-router/std",
     "ibc-core-handler/std",
+    "ibc-primitives/std",
 ]
 serde = [
     "ibc-core-client/serde",
@@ -46,6 +47,7 @@ serde = [
     "ibc-core-host/serde",
     "ibc-core-router/serde",
     "ibc-core-handler/serde",
+    "ibc-primitives/serde",
 ]
 borsh = [
     "ibc-core-client/borsh",
@@ -55,6 +57,7 @@ borsh = [
     "ibc-core-host/borsh",
     "ibc-core-router/borsh",
     "ibc-core-handler/borsh",
+    "ibc-primitives/borsh",
 ]
 schema = [
     "ibc-core-client/schema",
@@ -64,6 +67,7 @@ schema = [
     "ibc-core-host/schema",
     "ibc-core-router/schema",
     "ibc-core-handler/schema",
+    "ibc-primitives/schema",
     "serde",
     "std"
 ]
@@ -71,6 +75,7 @@ parity-scale-codec = [
     "ibc-core-client/parity-scale-codec",
     "ibc-core-connection/parity-scale-codec",
     "ibc-core-channel/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
     "ibc-core-host/parity-scale-codec",
     "ibc-core-router/parity-scale-codec",
     "ibc-core-handler/parity-scale-codec",
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index d93aebbaa..65e90d116 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -63,6 +63,7 @@ schema = [
     "ibc-core-client-types/schema",
     "ibc-core-host-types/schema",
     "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
     "serde",
     "std"
 ]
diff --git a/ibc-core/ics02-client/types/Cargo.toml b/ibc-core/ics02-client/types/Cargo.toml
index 5069cd604..de5f7b656 100644
--- a/ibc-core/ics02-client/types/Cargo.toml
+++ b/ibc-core/ics02-client/types/Cargo.toml
@@ -77,7 +77,8 @@ schema = [
 parity-scale-codec = [
     "dep:parity-scale-codec",
     "dep:scale-info",
-    "ibc-core-commitment-types/parity-scale-codec",
     "ibc-core-host-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
+    "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics03-connection/Cargo.toml b/ibc-core/ics03-connection/Cargo.toml
index f7531db79..3bb727d2b 100644
--- a/ibc-core/ics03-connection/Cargo.toml
+++ b/ibc-core/ics03-connection/Cargo.toml
@@ -43,6 +43,7 @@ schema = [
     "ibc-core-client/schema",
     "ibc-core-connection-types/schema",
     "ibc-core-host/schema",
+    "ibc-core-handler-types/schema",
     "ibc-primitives/schema",
     "serde",
     "std"
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index 79adcf6e5..cb7e22342 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -62,6 +62,7 @@ serde = [
 ]
 schema = [
     "ibc-core-client-types/schema",
+    "ibc-core-client-context/schema",
     "ibc-core-connection-types/schema",
     "ibc-core-channel-types/schema",
     "ibc-core-commitment-types/schema",
@@ -73,6 +74,7 @@ schema = [
 ]
 borsh = [
     "ibc-core-client-types/borsh",
+    "ibc-core-client-context/borsh",
     "ibc-core-connection-types/borsh",
     "ibc-core-channel-types/borsh",
     "ibc-core-commitment-types/borsh",
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
index bbe7d7bb2..e9c2e73e6 100644
--- a/ibc-core/ics24-host/cosmos/Cargo.toml
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -90,6 +90,7 @@ borsh = [
     "dep:borsh",
     "ibc-client-tendermint/borsh",
     "ibc-core-client-types/borsh",
+    "ibc-core-client-context/borsh",
     "ibc-core-connection-types/borsh",
     "ibc-core-commitment-types/borsh",
     "ibc-core-host-types/borsh",
diff --git a/ibc-core/ics25-handler/Cargo.toml b/ibc-core/ics25-handler/Cargo.toml
index 1e158e402..15231a4af 100644
--- a/ibc-core/ics25-handler/Cargo.toml
+++ b/ibc-core/ics25-handler/Cargo.toml
@@ -37,6 +37,7 @@ std = [
     "ibc-core-host/std",
     "ibc-core-router/std",
     "ibc-core-handler-types/std",
+    "ibc-primitives/std",
 ]
 serde = [
     "ibc-core-client/serde",
@@ -46,6 +47,7 @@ serde = [
     "ibc-core-host/serde",
     "ibc-core-router/serde",
     "ibc-core-handler-types/serde",
+    "ibc-primitives/serde",
 ]
 borsh = [
     "ibc-core-client/borsh",
@@ -55,6 +57,7 @@ borsh = [
     "ibc-core-host/borsh",
     "ibc-core-router/borsh",
     "ibc-core-handler-types/borsh",
+    "ibc-primitives/borsh",
 ]
 schema = [
     "ibc-core-client/schema",
@@ -64,6 +67,7 @@ schema = [
     "ibc-core-host/schema",
     "ibc-core-router/schema",
     "ibc-core-handler-types/schema",
+    "ibc-primitives/schema",
     "serde",
     "std"
 ]
diff --git a/ibc-data-types/Cargo.toml b/ibc-data-types/Cargo.toml
index 00830d562..30bc92a2c 100644
--- a/ibc-data-types/Cargo.toml
+++ b/ibc-data-types/Cargo.toml
@@ -62,6 +62,7 @@ borsh = [
     "ibc-core-client-types/borsh",
     "ibc-core-connection-types/borsh",
     "ibc-core-channel-types/borsh",
+    "ibc-core-commitment-types/borsh",
     "ibc-core-host-types/borsh",
     "ibc-core-router-types/borsh",
     "ibc-core-handler-types/borsh",
@@ -73,6 +74,7 @@ schema = [
     "ibc-core-client-types/schema",
     "ibc-core-connection-types/schema",
     "ibc-core-channel-types/schema",
+    "ibc-core-commitment-types/schema",
     "ibc-core-host-types/schema",
     "ibc-core-router-types/schema",
     "ibc-core-handler-types/schema",
@@ -85,6 +87,7 @@ parity-scale-codec = [
     "ibc-core-client-types/parity-scale-codec",
     "ibc-core-connection-types/parity-scale-codec",
     "ibc-core-channel-types/parity-scale-codec",
+    "ibc-core-commitment-types/parity-scale-codec",
     "ibc-core-host-types/parity-scale-codec",
     "ibc-core-router-types/parity-scale-codec",
     "ibc-core-handler-types/parity-scale-codec",

From 06725c1eb3d27c1e5ed876a78cba08183fc220ef Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 26 Jan 2024 12:13:26 -0800
Subject: [PATCH 103/182] fix: add frozen client check for `create_client`
 handler (#1063)

* fix: add frozen client check for create_client handler

* imp: merge assert checks for test
---
 ...ease-frozen-height-check-ics07-try-from.md |  6 ++--
 .../ics02-client/src/handler/create_client.rs | 17 ++++++++--
 .../tests/core/ics02_client/create_client.rs  | 33 +++++++++++++++++++
 3 files changed, 51 insertions(+), 5 deletions(-)

diff --git a/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md b/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
index 40e230d61..d3aa5cacc 100644
--- a/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
+++ b/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
@@ -1,3 +1,5 @@
 - [ibc-client-tendermint-types] Ease frozen Height check in the tendermint
-  `ClientState` protobuf deserialization
-  ([\#1061](https://github.com/cosmos/ibc-rs/issues/1061))
+  `ClientState` protobuf deserialization, and consequently include frozen client
+  check for client creation path.
+  ([\#1061](https://github.com/cosmos/ibc-rs/issues/1061)),
+  ([\#1063](https://github.com/cosmos/ibc-rs/pull/1063))
diff --git a/ibc-core/ics02-client/src/handler/create_client.rs b/ibc-core/ics02-client/src/handler/create_client.rs
index d0e1d4d0a..e0a47e05b 100644
--- a/ibc-core/ics02-client/src/handler/create_client.rs
+++ b/ibc-core/ics02-client/src/handler/create_client.rs
@@ -1,6 +1,8 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgCreateClient`.
 
-use ibc_core_client_context::client_state::{ClientStateCommon, ClientStateExecution};
+use ibc_core_client_context::client_state::{
+    ClientStateCommon, ClientStateExecution, ClientStateValidation,
+};
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::events::CreateClient;
 use ibc_core_client_types::msgs::MsgCreateClient;
@@ -26,10 +28,19 @@ where
 
     let client_state = ctx.decode_client_state(client_state)?;
 
-    client_state.verify_consensus_state(consensus_state)?;
-
     let client_id = client_state.client_type().build_client_id(id_counter);
 
+    let status = client_state.status(ctx.get_client_validation_context(), &client_id)?;
+
+    if status.is_frozen() {
+        return Err(ClientError::ClientFrozen {
+            description: "the client is frozen".to_string(),
+        }
+        .into());
+    };
+
+    client_state.verify_consensus_state(consensus_state)?;
+
     if ctx.client_state(&client_id).is_ok() {
         return Err(ClientError::ClientStateAlreadyExists { client_id }.into());
     };
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index 91d465d6b..3540aefb6 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -2,9 +2,11 @@ use ibc::clients::tendermint::types::{
     client_type as tm_client_type, ConsensusState as TmConsensusState,
 };
 use ibc::core::client::context::client_state::ClientStateCommon;
+use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient};
 use ibc::core::client::types::Height;
 use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::ValidationContext;
 use ibc_testkit::fixtures::clients::tendermint::{
@@ -86,3 +88,34 @@ fn test_tm_create_client_ok() {
     assert_eq!(expected_client_state.client_type(), client_type);
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
+
+#[test]
+fn test_invalid_frozen_tm_client_creation() {
+    let signer = dummy_account_id();
+
+    let ctx = MockContext::default();
+
+    let router = MockRouter::new_with_transfer();
+
+    let tm_header = dummy_tendermint_header();
+
+    let tm_client_state = dummy_tm_client_state_from_header(tm_header.clone())
+        .inner()
+        .clone()
+        .with_frozen_height(Height::min(0));
+
+    let msg = MsgCreateClient::new(
+        tm_client_state.into(),
+        TmConsensusState::from(tm_header).into(),
+        signer,
+    );
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+
+    assert!(matches!(
+        res,
+        Err(ContextError::ClientError(ClientError::ClientFrozen { .. }))
+    ))
+}

From 4a0990f35e2a9338b7205445b9d21a044784104c Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 29 Jan 2024 13:13:15 -0800
Subject: [PATCH 104/182] fix: revert `frozen_height` to 0 for active clients
 in conversions  (#1064)

* fix: revert proto encoded frozen_height to height = zero

* fix: disallow proto frozen_height equal to None

* fix: test_update_synthetic_tendermint_client_duplicate_ok

* Update ibc-clients/ics07-tendermint/types/src/error.rs

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../types/src/client_state.rs                 | 20 +++++++++++++++----
 .../ics07-tendermint/types/src/error.rs       |  4 ++--
 .../tests/core/ics02_client/update_client.rs  |  6 +++++-
 3 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 1c6001e22..05af81f58 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -6,6 +6,7 @@ use core::str::FromStr;
 use core::time::Duration;
 
 use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::proto::v1::Height as RawHeight;
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::specs::ProofSpecs;
 use ibc_core_host_types::identifiers::ChainId;
@@ -283,10 +284,11 @@ impl TryFrom<RawTmClientState> for ClientState {
             .try_into()
             .map_err(|_| Error::MissingLatestHeight)?;
 
-        // In `RawClientState`, a `frozen_height` of `0` means "not frozen".
-        // See:
+        // NOTE: In `RawClientState`, a `frozen_height` of `0` means "not
+        // frozen". See:
         // https://github.com/cosmos/ibc-go/blob/8422d0c4c35ef970539466c5bdec1cd27369bab3/modules/light-clients/07-tendermint/types/client_state.go#L74
-        let frozen_height = raw.frozen_height.and_then(|h| Height::try_from(h).ok());
+        let frozen_height =
+            Height::try_from(raw.frozen_height.ok_or(Error::MissingFrozenHeight)?).ok();
 
         // We use set this deprecated field just so that we can properly convert
         // it back in its raw form
@@ -322,7 +324,17 @@ impl From<ClientState> for RawTmClientState {
             trusting_period: Some(value.trusting_period.into()),
             unbonding_period: Some(value.unbonding_period.into()),
             max_clock_drift: Some(value.max_clock_drift.into()),
-            frozen_height: value.frozen_height.map(|height| height.into()),
+            // NOTE: The protobuf encoded `frozen_height` of an active client
+            // must be set to `0` so that `ibc-go` driven chains can properly
+            // decode the `ClientState` value. In `RawClientState`, a
+            // `frozen_height` of `0` means "not frozen". See:
+            // https://github.com/cosmos/ibc-go/blob/8422d0c4c35ef970539466c5bdec1cd27369bab3/modules/light-clients/07-tendermint/types/client_state.go#L74
+            frozen_height: Some(value.frozen_height.map(|height| height.into()).unwrap_or(
+                RawHeight {
+                    revision_number: 0,
+                    revision_height: 0,
+                },
+            )),
             latest_height: Some(value.latest_height.into()),
             proof_specs: value.proof_specs.into(),
             upgrade_path: value.upgrade_path,
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index 0bc1dd918..a9fac983e 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -61,8 +61,8 @@ pub enum Error {
     HeaderTimestampTooLow { actual: String, min: String },
     /// header revision height = `{height}` is invalid
     InvalidHeaderHeight { height: u64 },
-    /// Disallowed to create a new client with a frozen height
-    FrozenHeightNotAllowed,
+    /// frozen height is missing
+    MissingFrozenHeight,
     /// the header's trusted revision number (`{trusted_revision}`) and the update's revision number (`{header_revision}`) should be the same
     MismatchHeightRevisions {
         trusted_revision: u64,
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 4a24bada3..8d9707566 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -10,6 +10,7 @@ use ibc::clients::tendermint::types::{
 use ibc::core::client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::msgs::{ClientMsg, MsgSubmitMisbehaviour, MsgUpdateClient};
+use ibc::core::client::types::proto::v1::Height as RawHeight;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::specs::ProofSpecs;
 use ibc::core::entrypoint::{execute, validate};
@@ -588,7 +589,10 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
                 ),
                 proof_specs: ProofSpecs::default().into(),
                 upgrade_path: Default::default(),
-                frozen_height: None,
+                frozen_height: Some(RawHeight {
+                    revision_number: 0,
+                    revision_height: 0,
+                }),
                 allow_update_after_expiry: false,
                 allow_update_after_misbehaviour: false,
             };

From 5d2805cd28d780996922b0ab978cad4dfeeba304 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Thu, 1 Feb 2024 10:29:04 -0500
Subject: [PATCH 105/182] ci: whitepsace lints (#1066)

* update issue templates

* update workflow files

* ci job for code quality

* convert tabs to spaces

* rm trailing spaces

* restrict whitespace checks to only rust and toml types

* add newline at eof

* check for newline at eof

* use fd musl build over gnu

* touchup

* make recipe starts with a tab

* consistent order

* script for whitespace lints

* update code-quality workflow with bash script

* rm redundant gh action option

* imp: exclude /target + use ggrep for macOS

* grep or ggrep based on os

* fix lint message

* shellharden

* same order as in comment

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .github/ISSUE_TEMPLATE/bug-report.md          |  8 +--
 .github/ISSUE_TEMPLATE/feature-request.md     |  8 +--
 .github/ISSUE_TEMPLATE/process-improvement.md |  6 +--
 .github/workflows/audit.yaml                  |  2 +-
 .github/workflows/code-quality.yml            | 21 ++++++++
 .github/workflows/cw-check.yaml               |  6 +--
 .github/workflows/markdown-link-check.yml     |  8 +--
 .github/workflows/release.yaml                |  8 +--
 .github/workflows/rust.yml                    | 12 ++---
 .github/workflows/typos.yml                   | 13 -----
 ci/code-quality/whitespace-lints.sh           | 54 +++++++++++++++++++
 ci/cw-check/Cargo.toml                        |  2 +-
 ibc-apps/ics20-transfer/types/Cargo.toml      |  4 +-
 ibc-apps/ics721-nft-transfer/types/Cargo.toml |  4 +-
 ibc-clients/Cargo.toml                        |  2 +-
 ibc-clients/ics07-tendermint/Cargo.toml       |  4 +-
 ibc-clients/ics07-tendermint/types/Cargo.toml |  4 +-
 ibc-clients/ics08-wasm/types/Cargo.toml       | 40 +++++++-------
 ibc-core/Cargo.toml                           |  2 +-
 ibc-core/ics02-client/Cargo.toml              |  2 +-
 ibc-core/ics02-client/context/Cargo.toml      |  4 +-
 ibc-core/ics03-connection/Cargo.toml          |  4 +-
 ibc-core/ics03-connection/types/Cargo.toml    |  4 +-
 ibc-core/ics04-channel/Cargo.toml             |  2 +-
 ibc-core/ics04-channel/types/Cargo.toml       |  2 +-
 ibc-core/ics24-host/Cargo.toml                |  2 +-
 ibc-core/ics24-host/types/Cargo.toml          |  2 +-
 ibc-core/ics25-handler/Cargo.toml             |  2 +-
 ibc-core/ics25-handler/types/Cargo.toml       |  2 +-
 ibc-core/ics26-routing/types/Cargo.toml       |  2 +-
 ibc-testkit/Cargo.toml                        |  4 +-
 ibc/Cargo.toml                                |  8 +--
 32 files changed, 154 insertions(+), 94 deletions(-)
 create mode 100644 .github/workflows/code-quality.yml
 delete mode 100644 .github/workflows/typos.yml
 create mode 100755 ci/code-quality/whitespace-lints.sh

diff --git a/.github/ISSUE_TEMPLATE/bug-report.md b/.github/ISSUE_TEMPLATE/bug-report.md
index f825fd0f1..33b15fa70 100644
--- a/.github/ISSUE_TEMPLATE/bug-report.md
+++ b/.github/ISSUE_TEMPLATE/bug-report.md
@@ -1,13 +1,13 @@
 ---
-name: Bug Report 
+name: Bug Report
 about: Create a report to help us squash bugs!
 
 ---
 
-<!-- < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < ☺ 
-v               ✰  Thanks for opening an issue! ✰    
+<!-- < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < ☺
+v               ✰  Thanks for opening an issue! ✰
 v    Before smashing the submit button please review the template.
-v    Please also ensure that this is not a duplicate issue :)  
+v    Please also ensure that this is not a duplicate issue :)
 ☺ > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >  -->
 
 ## Bug Summary
diff --git a/.github/ISSUE_TEMPLATE/feature-request.md b/.github/ISSUE_TEMPLATE/feature-request.md
index 8bd708247..7b50c781b 100644
--- a/.github/ISSUE_TEMPLATE/feature-request.md
+++ b/.github/ISSUE_TEMPLATE/feature-request.md
@@ -4,11 +4,11 @@ about: Create a proposal to request a feature!
 
 ---
 
-<!-- < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < ☺ 
-v                ✰  Thanks for opening an issue! ✰    
+<!-- < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < ☺
+v                ✰  Thanks for opening an issue! ✰
 v    Before smashing the submit button please review the template.
-v    Word of caution: poorly thought-out proposals may be rejected 
-v                     without deliberation 
+v    Word of caution: poorly thought-out proposals may be rejected
+v                     without deliberation
 ☺ > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >  -->
 
 ## Feature Summary
diff --git a/.github/ISSUE_TEMPLATE/process-improvement.md b/.github/ISSUE_TEMPLATE/process-improvement.md
index 05a7073cf..1cf320562 100644
--- a/.github/ISSUE_TEMPLATE/process-improvement.md
+++ b/.github/ISSUE_TEMPLATE/process-improvement.md
@@ -5,17 +5,17 @@ about: Create a proposal to suggest an improvement for `ibc-rs` operations!
 ---
 
 <!-- < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < < ☺
-v                ✰  Thanks for opening an issue! ✰    
+v                ✰  Thanks for opening an issue! ✰
 v    Before smashing the submit button please review the template.
 v    Please also ensure that this is not a duplicate issue :)
 ☺ > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > >  -->
 
 ## Improvement Summary
 
-<!-- Short description of the proposed improvement about the projects' processes -->
+<!-- Short description of the proposed improvement of the projects' processes -->
 
 ## Proposal
 
-<!-- Describe your proposal for how some process of `ibc-rs` should be improved -->
+<!-- Describe your proposal for how some processes of `ibc-rs` should be improved -->
 <!-- What would be the benefits if we adopted the proposal?
      Are there any disadvantages? -->
diff --git a/.github/workflows/audit.yaml b/.github/workflows/audit.yaml
index 4ca65ae9f..2c8286bfc 100644
--- a/.github/workflows/audit.yaml
+++ b/.github/workflows/audit.yaml
@@ -1,7 +1,7 @@
 name: Security Audit
 on:
   schedule:
-    - cron: '0 0 * * *'
+    - cron: "0 0 * * *"
 
 jobs:
   security_audit:
diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml
new file mode 100644
index 000000000..24bdad7f5
--- /dev/null
+++ b/.github/workflows/code-quality.yml
@@ -0,0 +1,21 @@
+name: Code Quality Checks
+on:
+  pull_request:
+
+jobs:
+  code-quality:
+    runs-on: ubuntu-latest
+    env:
+      RIPGREP_VERSION: 14.1.0
+      FD_VERSION: 9.0.0
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Whitestapace lints
+        run: bash ci/code-quality/whitespace-lints.sh
+
+      - name: Spell Check with Typos
+        uses: crate-ci/typos@master
+        with:
+          config: ./.github/typos.toml
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index 72e16df29..8455a187e 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -8,7 +8,7 @@ on:
     tags:
       - v[0-9]+.*
     branches:
-      - 'release/*'
+      - "release/*"
       - main
     paths:
       - .github/workflows/cw-check.yml
@@ -31,9 +31,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: DeterminateSystems/nix-installer-action@main
       - uses: DeterminateSystems/magic-nix-cache-action@main
-        with:
-          is_ci : true
       - name: Run cw-check
         run: |
           cd ci/cw-check
-          nix-shell --run "cw-check"
\ No newline at end of file
+          nix-shell --run "cw-check"
diff --git a/.github/workflows/markdown-link-check.yml b/.github/workflows/markdown-link-check.yml
index c699a8551..9df23cd42 100644
--- a/.github/workflows/markdown-link-check.yml
+++ b/.github/workflows/markdown-link-check.yml
@@ -2,7 +2,7 @@ name: Check Markdown links
 
 on:
   schedule:
-    - cron: '0 0 * * *'
+    - cron: "0 0 * * *"
 
   workflow_dispatch:
 
@@ -14,6 +14,6 @@ jobs:
       - name: markdown-link-check
         uses: gaurav-nelson/github-action-markdown-link-check@1.0.13
         with:
-          config-file: '.github/markdown-link-check.json'
-          use-quiet-mode: 'yes'
-          use-verbose-mode: 'yes'
+          config-file: ".github/markdown-link-check.json"
+          use-quiet-mode: "yes"
+          use-verbose-mode: "yes"
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 153832e72..92c149cca 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -1,6 +1,6 @@
-# Attempts to perform a release when a particular tag is pushed. This job uses 
-# the `cargo release` command and assumes that the `CRATES_TOKEN`secret has 
-# been set and contains an API token with which we can publish our crates to 
+# Attempts to perform a release when a particular tag is pushed. This job uses
+# the `cargo release` command and assumes that the `CRATES_TOKEN`secret has
+# been set and contains an API token with which we can publish our crates to
 # crates.io.
 #
 # The `ibc-derive` publishing process is managed manually since it's not
@@ -51,7 +51,7 @@ jobs:
         run: yes | cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
-  
+
   gh-release:
     if: github.ref_type == 'tag'
     name: Create GitHub release
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 2feef2028..51613f22e 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -29,7 +29,7 @@ on:
       - ibc-query/**
       - ibc-testkit/**
       - ibc-derive/**
-      
+
 env:
   CARGO_INCREMENTAL: 0
   CARGO_PROFILE_DEV_DEBUG: 1
@@ -42,10 +42,10 @@ jobs:
   cleanup-runs:
     runs-on: ubuntu-latest
     steps:
-    - uses: rokroskar/workflow-run-cleanup-action@master
-      env:
-        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
-    if: "!startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main'"
+      - uses: rokroskar/workflow-run-cleanup-action@master
+        env:
+          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+    if: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
 
   check-features:
     name: Check features
@@ -120,7 +120,7 @@ jobs:
         with:
           command: doc
           args: --all-features --release
-    
+
   doc_no_default_features:
     runs-on: ubuntu-latest
     steps:
diff --git a/.github/workflows/typos.yml b/.github/workflows/typos.yml
deleted file mode 100644
index ba30dc387..000000000
--- a/.github/workflows/typos.yml
+++ /dev/null
@@ -1,13 +0,0 @@
-name: Spell Check
-on:
-  pull_request:
-
-jobs:
-  run:
-    name: Spell Check with Typos
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - uses: crate-ci/typos@master
-        with:
-          config: ./.github/typos.toml
diff --git a/ci/code-quality/whitespace-lints.sh b/ci/code-quality/whitespace-lints.sh
new file mode 100755
index 000000000..ebf181c6c
--- /dev/null
+++ b/ci/code-quality/whitespace-lints.sh
@@ -0,0 +1,54 @@
+#!/bin/bash
+set -euo pipefail
+
+# use ggrep for macOS, and grep for Linux
+case "$OSTYPE" in
+    darwin*) GREP="ggrep" ;;
+    linux-gnu*) GREP="grep" ;;
+    *) echo "Unknown OS: $OSTYPE" && exit 1 ;;
+esac
+
+check_binary() {
+    # exactly one argument is passed
+    if [ $# -ne 1 ] || [ "$1" = "" ]; then
+        echo "Usage: check_binary <binary>"
+        exit 1
+    fi
+
+    if ! (type "$1" >/dev/null 2>&1); then
+        echo "$1 is not present"
+        exit 1
+    fi
+}
+
+check_binary "$GREP"
+check_binary find
+
+check_code_quality() {
+    # exactly three arguments are passed
+    if [ $# -ne 3 ] || [ "$1" = "" ] || [ "$2" = "" ] || [ "$3" = "" ]; then
+        echo "Usage: check_code_quality <option> <pattern> <message>"
+        exit 1
+    fi
+
+    if find . -type f -name "*.toml" -o -name "*.rs" \
+        -not -path '*/.*' -not -path '*/target/*' \
+        -exec "$GREP" "$1" "$2" {} \; | "$GREP" '.*'; then
+        echo "$3"
+        return 1
+    else
+        return 0
+    fi
+}
+
+exit_code=0
+
+check_code_quality -nHIP "\s+$" "found: trailing whitespaces" || exit_code=1
+check_code_quality -nHIP $"\t" "found: tabs" || exit_code=1
+check_code_quality -zLIP ".*\n\Z" "found: no newline at EOF" || exit_code=1
+
+if [ "$exit_code" -eq 0 ]; then
+    echo "All code quality checks passed successfully."
+fi
+
+exit "$exit_code"
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index f7b3d1769..461de802e 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -22,4 +22,4 @@ debug-assertions = false
 opt-level = "s"
 overflow-checks = true
 panic = "abort"
-rpath = false
\ No newline at end of file
+rpath = false
diff --git a/ibc-apps/ics20-transfer/types/Cargo.toml b/ibc-apps/ics20-transfer/types/Cargo.toml
index 2706d19c5..7afb599eb 100644
--- a/ibc-apps/ics20-transfer/types/Cargo.toml
+++ b/ibc-apps/ics20-transfer/types/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20"]
 readme       = "./../../README.md"
 description  = """
-    Maintained by `ibc-rs`, encapsulates essential ICS-20 Fungible Token Transfer data structures and 
+    Maintained by `ibc-rs`, encapsulates essential ICS-20 Fungible Token Transfer data structures and
     domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
     applicability to facilitate development and integration across diverse IBC-enabled projects.
 """
@@ -58,7 +58,7 @@ serde = [
 schema = [
     "dep:schemars",
     "ibc-core/schema",
-    "ibc-proto/json-schema", 
+    "ibc-proto/json-schema",
     "serde",
     "std"
 ]
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
index b63d0fb14..beda003a3 100644
--- a/ibc-apps/ics721-nft-transfer/types/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["cosmos", "ibc", "transfer", "nft", "ics721"]
 readme       = "./../../README.md"
 description  = """
-    Maintained by `ibc-rs`, encapsulates essential ICS-721 Non-Fungible Token Transfer data structures and 
+    Maintained by `ibc-rs`, encapsulates essential ICS-721 Non-Fungible Token Transfer data structures and
     domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
     applicability to facilitate development and integration across diverse IBC-enabled projects.
 """
@@ -59,7 +59,7 @@ serde = [
 schema = [
     "dep:schemars",
     "ibc-core/schema",
-    "ibc-proto/json-schema", 
+    "ibc-proto/json-schema",
     "serde",
     "std"
 ]
diff --git a/ibc-clients/Cargo.toml b/ibc-clients/Cargo.toml
index 85f3f2c21..1f1e35812 100644
--- a/ibc-clients/Cargo.toml
+++ b/ibc-clients/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "applications", "tendermint"]
 readme       = "README.md"
 description  = """
-    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement 
+    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement
     various IBC light clients, enabling smooth integration with IBC-enabled blockchains.
 """
 
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index a66ab41ba..b1727305e 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 readme       = "./../README.md"
 keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
 description  = """
-    Maintained by `ibc-rs`, contains the implementation of the ICS-07 Tendermint Client logic 
+    Maintained by `ibc-rs`, contains the implementation of the ICS-07 Tendermint Client logic
     and re-exports essential data structures and domain types from `ibc-client-tendermint-types` crate.
 """
 
@@ -77,4 +77,4 @@ parity-scale-codec = [
     "ibc-core-host/parity-scale-codec",
     "ibc-core-handler-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
-]
\ No newline at end of file
+]
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
index 085ca4fad..2eae85a94 100644
--- a/ibc-clients/ics07-tendermint/types/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "tendermint", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-07 Tendermint Client data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
@@ -89,4 +89,4 @@ parity-scale-codec = [
     "ibc-core-host-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
     "ibc-proto/parity-scale-codec",
-]
\ No newline at end of file
+]
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index a04c64f48..b920c4cba 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "wasm", "ics08"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-08 Wasm Light Client data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
@@ -34,29 +34,29 @@ serde_json = { workspace = true }
 [features]
 default = ["std"]
 std = [
-	"ibc-core-client/std",
-	"ibc-core-host-types/std",
-	"ibc-primitives/std",
-	"ibc-proto/std",
-	"base64/std",
-	"serde/std"
+    "ibc-core-client/std",
+    "ibc-core-host-types/std",
+    "ibc-primitives/std",
+    "ibc-proto/std",
+    "base64/std",
+    "serde/std"
 ]
 serde = [
-	"ibc-core-client/serde",
-	"ibc-core-host-types/serde",
-	"ibc-primitives/serde",
-	"ibc-proto/serde",
-	"dep:serde"
+    "ibc-core-client/serde",
+    "ibc-core-host-types/serde",
+    "ibc-primitives/serde",
+    "ibc-proto/serde",
+    "dep:serde"
 ]
 schema = [
-	"ibc-core-client/schema",
-	"ibc-core-host-types/schema",
-	"ibc-primitives/schema",
-	"ibc-proto/json-schema",
-	"serde",
-	"std"
+    "ibc-core-client/schema",
+    "ibc-core-host-types/schema",
+    "ibc-primitives/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std"
 ]
 cosmwasm = [
-	"cosmwasm-schema",
-	"schema"
+    "cosmwasm-schema",
+    "schema"
 ]
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
index 277e4a438..4eed1c18e 100644
--- a/ibc-core/Cargo.toml
+++ b/ibc-core/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "core"]
 readme       = "README.md"
 description  = """
-    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement IBC core (TAO) 
+    Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement IBC core (TAO)
     modules, facilitating seamless integration of IBC core business logic into any blockchain system.
 """
 
diff --git a/ibc-core/ics02-client/Cargo.toml b/ibc-core/ics02-client/Cargo.toml
index bcb30f561..7c6340022 100644
--- a/ibc-core/ics02-client/Cargo.toml
+++ b/ibc-core/ics02-client/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "light-client"]
 readme       = "./../README.md"
 description  = """
-    Maintained by `ibc-rs`, contains the implementation of ICS-02 Client Semantics and 
+    Maintained by `ibc-rs`, contains the implementation of ICS-02 Client Semantics and
     re-exports essential data structures and domain types from `ibc-core-client-types` crate.
 """
 
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index 65e90d116..e4eb8db05 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -9,8 +9,8 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc"]
 readme       = "./../../README.md"
 description  = """
-    Maintaind by `ibc-rs`, contains essential APIs to interface with the host chain's store, 
-    enabling smooth client state transitions. Additionally, provides necessary traits for 
+    Maintaind by `ibc-rs`, contains essential APIs to interface with the host chain's store,
+    enabling smooth client state transitions. Additionally, provides necessary traits for
     implementing custom IBC light clients.
 """
 
diff --git a/ibc-core/ics03-connection/Cargo.toml b/ibc-core/ics03-connection/Cargo.toml
index 3bb727d2b..c43f93c8e 100644
--- a/ibc-core/ics03-connection/Cargo.toml
+++ b/ibc-core/ics03-connection/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "connection"]
 readme       = "./../README.md"
 description  = """
-    Maintained by `ibc-rs`, contains the implementation of the ICS-03 Connection Semantics and 
+    Maintained by `ibc-rs`, contains the implementation of the ICS-03 Connection Semantics and
     re-exports essential data structures and domain types from `ibc-core-connection-types` crate.
 """
 
@@ -61,4 +61,4 @@ parity-scale-codec = [
     "ibc-core-host/parity-scale-codec",
     "ibc-core-handler-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
-]
\ No newline at end of file
+]
diff --git a/ibc-core/ics03-connection/types/Cargo.toml b/ibc-core/ics03-connection/types/Cargo.toml
index 536069db7..07091d845 100644
--- a/ibc-core/ics03-connection/types/Cargo.toml
+++ b/ibc-core/ics03-connection/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "connection", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-03 Connection Semantics data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
@@ -87,4 +87,4 @@ parity-scale-codec = [
     "ibc-core-host-types/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
     "ibc-proto/parity-scale-codec",
-]
\ No newline at end of file
+]
diff --git a/ibc-core/ics04-channel/Cargo.toml b/ibc-core/ics04-channel/Cargo.toml
index d2b5edf99..3f61d5092 100644
--- a/ibc-core/ics04-channel/Cargo.toml
+++ b/ibc-core/ics04-channel/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "channel"]
 readme       = "./../README.md"
 description  = """
-    Maintained by `ibc-rs`, contains the implementation of the ICS-04 Channel & Packet Semantics and 
+    Maintained by `ibc-rs`, contains the implementation of the ICS-04 Channel & Packet Semantics and
     re-exports essential data structures and domain types from `ibc-core-channel-types` crate.
 """
 
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
index 97395dfb5..55aee47f5 100644
--- a/ibc-core/ics04-channel/types/Cargo.toml
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "channel", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-4 Channel Semantics data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index cb7e22342..c3e56f554 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "host"]
 readme       = "./../README.md"
 description  = """
     Maintained by `ibc-rs`, contains essential top-level traits designed for the seamless integration
-    of host chains, facilitating access to the host's storage, the efficient retrieval of states and 
+    of host chains, facilitating access to the host's storage, the efficient retrieval of states and
     metadata crucial for the execution of any IBC datagrams.
 """
 
diff --git a/ibc-core/ics24-host/types/Cargo.toml b/ibc-core/ics24-host/types/Cargo.toml
index 5c007e8cb..ec2d6ed1f 100644
--- a/ibc-core/ics24-host/types/Cargo.toml
+++ b/ibc-core/ics24-host/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "host", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-24 Host Requirements data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
diff --git a/ibc-core/ics25-handler/Cargo.toml b/ibc-core/ics25-handler/Cargo.toml
index 15231a4af..af7589735 100644
--- a/ibc-core/ics25-handler/Cargo.toml
+++ b/ibc-core/ics25-handler/Cargo.toml
@@ -9,7 +9,7 @@ repository   = { workspace = true }
 keywords     = ["blockchain", "cosmos", "ibc", "handler"]
 readme       = "./../README.md"
 description  = """
-    Maintained by `ibc-rs`, exposes IBC handler entry points for an integrated IBC core modules. 
+    Maintained by `ibc-rs`, exposes IBC handler entry points for an integrated IBC core modules.
     These entry points are responsible for processing incoming IBC messages, performing validation,
     and execution logic by invoking the appropriate module handler.
 """
diff --git a/ibc-core/ics25-handler/types/Cargo.toml b/ibc-core/ics25-handler/types/Cargo.toml
index 59c663903..853e43c39 100644
--- a/ibc-core/ics25-handler/types/Cargo.toml
+++ b/ibc-core/ics25-handler/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "handler", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-25 Handler Interface data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
diff --git a/ibc-core/ics26-routing/types/Cargo.toml b/ibc-core/ics26-routing/types/Cargo.toml
index 3b1e4e15e..e9691d43a 100644
--- a/ibc-core/ics26-routing/types/Cargo.toml
+++ b/ibc-core/ics26-routing/types/Cargo.toml
@@ -10,7 +10,7 @@ keywords     = ["blockchain", "cosmos", "ibc", "routing", "types"]
 readme       = "./../../README.md"
 description  = """
     Maintained by `ibc-rs`, encapsulates essential ICS-26 Routing Module data structures and domain types,
-    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability 
+    as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
 """
 
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 032f03cdb..55546cf8c 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -9,9 +9,9 @@ repository   = { workspace = true }
 readme       = "README.md"
 keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
 description  = """
-    Maintained by `ibc-rs`, serves as a versatile library that provides essential abstractions 
+    Maintained by `ibc-rs`, serves as a versatile library that provides essential abstractions
     and implementations, fulfilling a dual role of enabling rigorous integration testing for
-    the `ibc-rs` implementation while also aiding host chains in addressing a broad spectrum 
+    the `ibc-rs` implementation while also aiding host chains in addressing a broad spectrum
     of testing scenarios during their integrations with `ibc-rs`.
 """
 
diff --git a/ibc/Cargo.toml b/ibc/Cargo.toml
index a5866ed50..bc7d9c2ba 100644
--- a/ibc/Cargo.toml
+++ b/ibc/Cargo.toml
@@ -10,8 +10,8 @@ keywords     = ["blockchain", "consensus", "cosmos", "ibc"]
 readme       = "README.md"
 description  = """
     Maintained by `ibc-rs`, serves as a top-level library that contain a comprehensive set of
-    Inter-Blockchain Communication (IBC) implementations, re-exporting data structures and 
-    implementations of various IBC core, clients and applications from the `ibc-core`, 
+    Inter-Blockchain Communication (IBC) implementations, re-exporting data structures and
+    implementations of various IBC core, clients and applications from the `ibc-core`,
     `ibc-clients` and `ibc-apps` crates.
 """
 
@@ -56,7 +56,7 @@ schema = [
     "ibc-core/schema",
     "ibc-core-host-cosmos/schema",
     "ibc-primitives/schema",
-    "serde", 
+    "serde",
     "std"
 ]
 parity-scale-codec = [
@@ -65,4 +65,4 @@ parity-scale-codec = [
     "ibc-core/parity-scale-codec",
     "ibc-core-host-cosmos/parity-scale-codec",
     "ibc-primitives/parity-scale-codec",
-]
\ No newline at end of file
+]

From ba7b90ce5a0faeb05c5c758b73aecb8e039ed4d5 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Thu, 1 Feb 2024 14:02:19 -0500
Subject: [PATCH 106/182] imp(core-host-types): add new storage paths (#1069)

* add missing paths

* update Path enum with new paths

* update parse functions

* add next_sequence path parser

* add unit tests

* update names and path format

* update parsing functions

* update tests

* use rstest cases for Path::try_from

* add comment in rstest

* consistent with old tests

* update rstest test names

* add changelog
---
 .../feature/1065-add-new-storage-paths.md     |   2 +
 ibc-core/ics24-host/types/src/path.rs         | 502 ++++++++++--------
 2 files changed, 297 insertions(+), 207 deletions(-)
 create mode 100644 .changelog/unreleased/feature/1065-add-new-storage-paths.md

diff --git a/.changelog/unreleased/feature/1065-add-new-storage-paths.md b/.changelog/unreleased/feature/1065-add-new-storage-paths.md
new file mode 100644
index 000000000..8efd486b7
--- /dev/null
+++ b/.changelog/unreleased/feature/1065-add-new-storage-paths.md
@@ -0,0 +1,2 @@
+- [ibc-core-host] Add remaining storage paths.
+  ([\#1065](https://github.com/cosmos/ibc-rs/issues/1065))
diff --git a/ibc-core/ics24-host/types/src/path.rs b/ibc-core/ics24-host/types/src/path.rs
index ede974372..ac31922b3 100644
--- a/ibc-core/ics24-host/types/src/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -22,8 +22,13 @@ const UPGRADED_CLIENT_CONSENSUS_STATE: &str = "upgradedConsState";
 /// The Path enum abstracts out the different sub-paths.
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, From, Display)]
 pub enum Path {
+    NextClientSequence(NextClientSequencePath),
+    NextConnectionSequence(NextConnectionSequencePath),
+    NextChannelSequence(NextChannelSequencePath),
     ClientState(ClientStatePath),
     ClientConsensusState(ClientConsensusStatePath),
+    ClientUpdateTime(ClientUpdateTimePath),
+    ClientUpdateHeight(ClientUpdateHeightPath),
     ClientConnection(ClientConnectionPath),
     Connection(ConnectionPath),
     Ports(PortPath),
@@ -37,6 +42,57 @@ pub enum Path {
     UpgradeClient(UpgradeClientPath),
 }
 
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
+#[display(fmt = "nextClientSequence")]
+pub struct NextClientSequencePath;
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
+#[display(fmt = "nextConnectionSequence")]
+pub struct NextConnectionSequencePath;
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
+#[display(fmt = "nextChannelSequence")]
+pub struct NextChannelSequencePath;
+
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -95,6 +151,72 @@ impl ClientConsensusStatePath {
     }
 }
 
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
+#[display(
+    fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}/processedTime"
+)]
+pub struct ClientUpdateTimePath {
+    pub client_id: ClientId,
+    pub revision_number: u64,
+    pub revision_height: u64,
+}
+
+impl ClientUpdateTimePath {
+    pub fn new(client_id: ClientId, revision_number: u64, revision_height: u64) -> Self {
+        Self {
+            client_id,
+            revision_number,
+            revision_height,
+        }
+    }
+}
+
+#[cfg_attr(
+    feature = "parity-scale-codec",
+    derive(
+        parity_scale_codec::Encode,
+        parity_scale_codec::Decode,
+        scale_info::TypeInfo
+    )
+)]
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
+#[display(
+    fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}/processedHeight"
+)]
+pub struct ClientUpdateHeightPath {
+    pub client_id: ClientId,
+    pub revision_number: u64,
+    pub revision_height: u64,
+}
+
+impl ClientUpdateHeightPath {
+    pub fn new(client_id: ClientId, revision_number: u64, revision_height: u64) -> Self {
+        Self {
+            client_id,
+            revision_number,
+            revision_height,
+        }
+    }
+}
+
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -414,7 +536,8 @@ impl FromStr for Path {
     fn from_str(s: &str) -> Result<Self, Self::Err> {
         let components: Vec<&str> = s.split('/').collect();
 
-        parse_client_paths(&components)
+        parse_next_sequence(&components)
+            .or_else(|| parse_client_paths(&components))
             .or_else(|| parse_connections(&components))
             .or_else(|| parse_ports(&components))
             .or_else(|| parse_channel_ends(&components))
@@ -429,6 +552,19 @@ impl FromStr for Path {
     }
 }
 
+fn parse_next_sequence(components: &[&str]) -> Option<Path> {
+    if components.len() != 1 {
+        return None;
+    }
+
+    match *components.first()? {
+        "nextClientSequence" => Some(NextClientSequencePath.into()),
+        "nextConnectionSequence" => Some(NextConnectionSequencePath.into()),
+        "nextChannelSequence" => Some(NextChannelSequencePath.into()),
+        _ => None,
+    }
+}
+
 fn parse_client_paths(components: &[&str]) -> Option<Path> {
     let first = match components.first() {
         Some(f) => *f,
@@ -450,17 +586,13 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
             "connections" => Some(ClientConnectionPath(client_id).into()),
             _ => None,
         }
-    } else if components.len() == 4 {
-        if "consensusStates" != components[2] {
-            return None;
+    } else if components.len() == 4 || components.len() == 5 {
+        match components[2] {
+            "consensusStates" => {}
+            _ => return None,
         }
 
-        let epoch_height = match components.last() {
-            Some(eh) => *eh,
-            None => return None,
-        };
-
-        let epoch_height: Vec<&str> = epoch_height.split('-').collect();
+        let epoch_height: Vec<&str> = components[3].split('-').collect();
 
         if epoch_height.len() != 2 {
             return None;
@@ -479,14 +611,36 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
             Err(_) => return None,
         };
 
-        Some(
-            ClientConsensusStatePath {
-                client_id,
-                revision_number,
-                revision_height,
-            }
-            .into(),
-        )
+        match components.len() {
+            4 => Some(
+                ClientConsensusStatePath {
+                    client_id,
+                    revision_number,
+                    revision_height,
+                }
+                .into(),
+            ),
+            5 => match components[4] {
+                "processedTime" => Some(
+                    ClientUpdateTimePath {
+                        client_id,
+                        revision_number,
+                        revision_height,
+                    }
+                    .into(),
+                ),
+                "processedHeight" => Some(
+                    ClientUpdateHeightPath {
+                        client_id,
+                        revision_number,
+                        revision_height,
+                    }
+                    .into(),
+                ),
+                _ => None,
+            },
+            _ => None,
+        }
     } else {
         None
     }
@@ -840,11 +994,115 @@ mod tests {
 
     use super::*;
 
-    #[test]
-    fn invalid_path_doesnt_parse() {
-        let invalid_path = Path::from_str("clients/clientType");
-
-        assert!(invalid_path.is_err());
+    #[rstest::rstest]
+    #[case("nextClientSequence", Path::NextClientSequence(NextClientSequencePath))]
+    #[case(
+        "nextConnectionSequence",
+        Path::NextConnectionSequence(NextConnectionSequencePath)
+    )]
+    #[case(
+        "nextChannelSequence",
+        Path::NextChannelSequence(NextChannelSequencePath)
+    )]
+    #[case(
+        "clients/07-tendermint-0/clientState",
+        Path::ClientState(ClientStatePath(ClientId::default()))
+    )]
+    #[case(
+        "clients/07-tendermint-0/consensusStates/15-31",
+        Path::ClientConsensusState(ClientConsensusStatePath {
+            client_id: ClientId::default(),
+            revision_number: 15,
+            revision_height: 31,
+        })
+    )]
+    #[case(
+        "clients/07-tendermint-0/consensusStates/15-31/processedTime",
+        Path::ClientUpdateTime(ClientUpdateTimePath {
+            client_id: ClientId::default(),
+            revision_number: 15,
+            revision_height: 31,
+        })
+    )]
+    #[case(
+        "clients/07-tendermint-0/consensusStates/15-31/processedHeight",
+        Path::ClientUpdateHeight(ClientUpdateHeightPath {
+            client_id: ClientId::default(),
+            revision_number: 15,
+            revision_height: 31,
+        })
+    )]
+    #[case(
+        "clients/07-tendermint-0/connections",
+        Path::ClientConnection(ClientConnectionPath(ClientId::default()))
+    )]
+    #[case(
+        "connections/connection-0",
+        Path::Connection(ConnectionPath(ConnectionId::new(0)))
+    )]
+    #[case("ports/transfer", Path::Ports(PortPath(PortId::transfer())))]
+    #[case(
+        "channelEnds/ports/transfer/channels/channel-0",
+        Path::ChannelEnd(ChannelEndPath(PortId::transfer(), ChannelId::default()))
+    )]
+    #[case(
+        "nextSequenceSend/ports/transfer/channels/channel-0",
+        Path::SeqSend(SeqSendPath(PortId::transfer(), ChannelId::default()))
+    )]
+    #[case(
+        "nextSequenceRecv/ports/transfer/channels/channel-0",
+        Path::SeqRecv(SeqRecvPath(PortId::transfer(), ChannelId::default()))
+    )]
+    #[case(
+        "nextSequenceAck/ports/transfer/channels/channel-0",
+        Path::SeqAck(SeqAckPath(PortId::transfer(), ChannelId::default()))
+    )]
+    #[case(
+        "commitments/ports/transfer/channels/channel-0/sequences/0",
+        Path::Commitment(CommitmentPath {
+            port_id: PortId::transfer(),
+            channel_id: ChannelId::default(),
+            sequence: Sequence::default(),
+        })
+    )]
+    #[case(
+        "acks/ports/transfer/channels/channel-0/sequences/0",
+        Path::Ack(AckPath {
+            port_id: PortId::transfer(),
+            channel_id: ChannelId::default(),
+            sequence: Sequence::default(),
+        })
+    )]
+    #[case(
+        "receipts/ports/transfer/channels/channel-0/sequences/0",
+        Path::Receipt(ReceiptPath {
+            port_id: PortId::transfer(),
+            channel_id: ChannelId::default(),
+            sequence: Sequence::default(),
+        })
+    )]
+    #[case(
+        "upgradedIBCState/0/upgradedClient",
+        Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(0))
+    )]
+    #[case(
+        "upgradedIBCState/0/upgradedConsState",
+        Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(0))
+    )]
+    fn test_successful_parsing(#[case] path_str: &str, #[case] path: Path) {
+        // can be parsed into Path
+        assert_eq!(Path::from_str(path_str).expect("no error"), path);
+        // can be converted back to string
+        assert_eq!(path_str, path.to_string());
+    }
+
+    #[rstest::rstest]
+    #[case("clients/clientType")]
+    #[case("channels/channel-0")]
+    #[case("sequences/0")]
+    fn test_failure_parsing(#[case] path_str: &str) {
+        // cannot be parsed into Path
+        assert!(Path::from_str(path_str).is_err());
     }
 
     #[test]
@@ -871,42 +1129,29 @@ mod tests {
     }
 
     #[test]
-    fn client_state_path_parses() {
-        let path = "clients/07-tendermint-0/clientState";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::ClientState(ClientStatePath(ClientId::default()))
-        );
-    }
-
-    #[test]
-    fn client_consensus_state_path_parses() {
-        let path = "clients/07-tendermint-0/consensusStates/15-31";
-        let path = Path::from_str(path);
+    fn test_parse_client_update_paths_fn() {
+        let path = "clients/07-tendermint-0/consensusStates/15-31/processedTime";
+        let components: Vec<&str> = path.split('/').collect();
 
-        assert!(path.is_ok());
         assert_eq!(
-            path.unwrap(),
-            Path::ClientConsensusState(ClientConsensusStatePath {
+            parse_client_paths(&components),
+            Some(Path::ClientUpdateTime(ClientUpdateTimePath {
                 client_id: ClientId::default(),
                 revision_number: 15,
                 revision_height: 31,
-            })
+            }))
         );
-    }
 
-    #[test]
-    fn client_connections_path_parses() {
-        let path = "clients/07-tendermint-0/connections";
-        let path = Path::from_str(path);
+        let path = "clients/07-tendermint-0/consensusStates/15-31/processedHeight";
+        let components: Vec<&str> = path.split('/').collect();
 
-        assert!(path.is_ok());
         assert_eq!(
-            path.unwrap(),
-            Path::ClientConnection(ClientConnectionPath(ClientId::default()))
+            parse_client_paths(&components),
+            Some(Path::ClientUpdateHeight(ClientUpdateHeightPath {
+                client_id: ClientId::default(),
+                revision_number: 15,
+                revision_height: 31,
+            }))
         );
     }
 
@@ -921,18 +1166,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn connections_path_parses() {
-        let path = "connections/connection-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::Connection(ConnectionPath(ConnectionId::new(0)))
-        );
-    }
-
     #[test]
     fn test_parse_ports_fn() {
         let path = "ports/transfer";
@@ -944,15 +1177,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn ports_path_parses() {
-        let path = "ports/transfer";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(path.unwrap(), Path::Ports(PortPath(PortId::transfer())));
-    }
-
     #[test]
     fn test_parse_channels_fn() {
         let path = "channels/channel-0";
@@ -964,14 +1188,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn channels_path_doesnt_parse() {
-        let path = "channels/channel-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_err());
-    }
-
     #[test]
     fn test_parse_sequences_fn() {
         let path = "sequences/0";
@@ -983,14 +1199,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn sequences_path_doesnt_parse() {
-        let path = "sequences/0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_err());
-    }
-
     #[test]
     fn test_parse_channel_ends_fn() {
         let path = "channelEnds/ports/transfer/channels/channel-0";
@@ -1005,18 +1213,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn channel_ends_path_parses() {
-        let path = "channelEnds/ports/transfer/channels/channel-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::ChannelEnd(ChannelEndPath(PortId::transfer(), ChannelId::default())),
-        );
-    }
-
     #[test]
     fn test_parse_seqs_fn() {
         let path = "nextSequenceSend/ports/transfer/channels/channel-0";
@@ -1053,42 +1249,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn sequence_send_path_parses() {
-        let path = "nextSequenceSend/ports/transfer/channels/channel-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::SeqSend(SeqSendPath(PortId::transfer(), ChannelId::default())),
-        );
-    }
-
-    #[test]
-    fn sequence_recv_path_parses() {
-        let path = "nextSequenceRecv/ports/transfer/channels/channel-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::SeqRecv(SeqRecvPath(PortId::transfer(), ChannelId::default())),
-        );
-    }
-
-    #[test]
-    fn sequence_ack_path_parses() {
-        let path = "nextSequenceAck/ports/transfer/channels/channel-0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::SeqAck(SeqAckPath(PortId::transfer(), ChannelId::default())),
-        );
-    }
-
     #[test]
     fn test_parse_commitments_fn() {
         let path = "commitments/ports/transfer/channels/channel-0/sequences/0";
@@ -1104,22 +1264,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn commitments_path_parses() {
-        let path = "commitments/ports/transfer/channels/channel-0/sequences/0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::Commitment(CommitmentPath {
-                port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
-            }),
-        );
-    }
-
     #[test]
     fn test_parse_acks_fn() {
         let path = "acks/ports/transfer/channels/channel-0/sequences/0";
@@ -1135,22 +1279,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn acks_path_parses() {
-        let path = "acks/ports/transfer/channels/channel-0/sequences/0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::Ack(AckPath {
-                port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
-            }),
-        );
-    }
-
     #[test]
     fn test_parse_receipts_fn() {
         let path = "receipts/ports/transfer/channels/channel-0/sequences/0";
@@ -1166,22 +1294,6 @@ mod tests {
         );
     }
 
-    #[test]
-    fn receipts_path_parses() {
-        let path = "receipts/ports/transfer/channels/channel-0/sequences/0";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::Receipt(ReceiptPath {
-                port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
-            }),
-        );
-    }
-
     #[test]
     fn test_parse_upgrades_fn() {
         let path = "upgradedIBCState/0/upgradedClient";
@@ -1204,28 +1316,4 @@ mod tests {
             )),
         )
     }
-
-    #[test]
-    fn upgrade_client_state_path_parses() {
-        let path = "upgradedIBCState/0/upgradedClient";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(0)),
-        );
-    }
-
-    #[test]
-    fn upgrade_client_consensus_state_path_parses() {
-        let path = "upgradedIBCState/0/upgradedConsState";
-        let path = Path::from_str(path);
-
-        assert!(path.is_ok());
-        assert_eq!(
-            path.unwrap(),
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(0)),
-        );
-    }
 }

From 0c1e8a9a451a72d202aa6d19dcff7f408354564f Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Thu, 1 Feb 2024 22:45:30 +0100
Subject: [PATCH 107/182] feat(core-client)!: replace
 store_update_{time,height} by metadata update (#972)

* {store,delete}_update_meta

* client_update_meta

* log

* clippy

* error

* review

* fix unclog

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../breaking-changes/973-update-meta.md       |   6 +
 .../architecture/adr-005-handlers-redesign.md |  50 +++-----
 .../ics07-tendermint/src/client_state.rs      |   9 +-
 .../src/client_state/update_client.rs         |   8 +-
 .../ics07-tendermint/types/src/error.rs       |   6 +-
 ibc-core/ics02-client/context/src/context.rs  |  53 +++------
 ibc-core/ics02-client/types/src/error.rs      |   6 +-
 ibc-core/ics03-connection/src/delay.rs        |  11 +-
 .../testapp/ibc/clients/mock/client_state.rs  |  11 +-
 .../src/testapp/ibc/core/client_ctx.rs        | 108 +++++-------------
 .../tests/core/ics02_client/update_client.rs  |  14 +--
 .../core/ics04_channel/acknowledgement.rs     |  10 +-
 .../tests/core/ics04_channel/recv_packet.rs   |  11 +-
 .../tests/core/ics04_channel/timeout.rs       |  28 +----
 .../core/ics04_channel/timeout_on_close.rs    |  11 +-
 15 files changed, 104 insertions(+), 238 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/973-update-meta.md

diff --git a/.changelog/unreleased/breaking-changes/973-update-meta.md b/.changelog/unreleased/breaking-changes/973-update-meta.md
new file mode 100644
index 000000000..2aabe1231
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/973-update-meta.md
@@ -0,0 +1,6 @@
+- Merge client update time and height modification method pairs into
+  one, that is replace
+  a) client_update_{time,height} by update_meta,
+  b) store_update_{time,height} by store_update_meta and
+  c) delete_update_{time,height} by delete_update_meta.
+  ([\#972](https://github.com/cosmos/ibc-rs/pull/972))
diff --git a/docs/architecture/adr-005-handlers-redesign.md b/docs/architecture/adr-005-handlers-redesign.md
index 6d4be433c..a4c25890a 100644
--- a/docs/architecture/adr-005-handlers-redesign.md
+++ b/docs/architecture/adr-005-handlers-redesign.md
@@ -40,14 +40,14 @@ function updateClient(
 
     clientState.VerifyClientMessage(clientMessage)
     // Validation END
-    
+
     // Execution START
     foundMisbehaviour := clientState.CheckForMisbehaviour(clientMessage)
     if foundMisbehaviour {
         clientState.UpdateStateOnMisbehaviour(clientMessage)
     }
-    else {    
-        clientState.UpdateState(clientMessage) 
+    else {
+        clientState.UpdateState(clientMessage)
     }
     // Execution END
 }
@@ -99,13 +99,13 @@ pub trait Host {
     /// An error type that can represent all host errors.
     type Error;
 
-    /// The Host's key-value store that must provide access to IBC paths. 
+    /// The Host's key-value store that must provide access to IBC paths.
     type KvStore: IbcStore<Self::Error>;
 
     /// An event logging facility.
     type EventLogger: EventLogger<Event=Event<DefaultIbcTypes>>;
 
-    /// Methods to access the store (ro & rw). 
+    /// Methods to access the store (ro & rw).
     fn store(&self) -> &Self::KvStore;
     fn store_mut(&mut self) -> &mut Self::KvStore;
 
@@ -373,11 +373,9 @@ trait ValidationContext {
     /// A hashing function for packet commitments
     fn hash(&self, value: Vec<u8>) -> Vec<u8>;
 
-    /// Returns the time when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_time(&self, client_id: &ClientId, height: Height) -> Result<Timestamp, Error>;
-
-    /// Returns the height when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_height(&self, client_id: &ClientId, height: Height) -> Result<Height, Error>;
+    /// Returns the time and height when the client state for the
+    /// given [`ClientId`] was updated with a header for the given [`Height`]
+    fn update_meta(&self, client_id: &ClientId, height: Height) -> Result<(Timestamp, Height), Error>;
 
     /// Returns a counter on the number of channel ids that have been created thus far.
     /// The value of this counter should increase only via method
@@ -427,22 +425,14 @@ trait ExecutionContext {
     fn increase_client_counter(&mut self);
 
     /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified time as the time at which
-    /// this update (or header) was processed.
-    fn store_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        timestamp: Timestamp,
-    ) -> Result<(), Error>;
-
-    /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified height as the height at
-    /// at which this update (or header) was processed.
-    fn store_update_height(
+    ///
+    /// Implementations are expected to use this to record the specified time
+    /// and height as the time at which this update (or header) was processed.
+    fn store_update_meta(
         &mut self,
         client_id: ClientId,
         height: Height,
+        host_timestamp: Timestamp,
         host_height: Height,
     ) -> Result<(), Error>;
 
@@ -550,16 +540,11 @@ pub trait Host {
 
     /// Methods currently in `ClientKeeper`
     fn increase_client_counter(&mut self);
-    fn store_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-        timestamp: Timestamp,
-    ) -> Result<(), Error>;
-    fn store_update_height(
+    fn store_update_meta(
         &mut self,
         client_id: ClientId,
         height: Height,
+        host_timestamp: Timestamp,
         host_height: Height,
     ) -> Result<(), Error>;
 
@@ -574,8 +559,7 @@ pub trait Host {
     /// Methods currently in `ChannelReader`
     fn connection_channels(&self, cid: &ConnectionId) -> Result<Vec<(PortId, ChannelId)>, Error>;
     fn hash(&self, value: Vec<u8>) -> Vec<u8>;
-    fn client_update_time(&self, client_id: &ClientId, height: Height) -> Result<Timestamp, Error>;
-    fn client_update_height(&self, client_id: &ClientId, height: Height) -> Result<Height, Error>;
+    fn update_meta(&self, client_id: &ClientId, height: Height) -> Result<(Timestamp, Height), Error>;
     fn channel_counter(&self) -> Result<u64, Error>;
     fn max_expected_time_per_block(&self) -> Duration;
     fn block_delay(&self, delay_period_time: Duration) -> u64;
@@ -626,7 +610,7 @@ pub trait StoreSerde {
     /// Serialize to canonical binary representation
     fn serialize(self) -> Vec<u8>;
 
-    /// Deserialize from bytes 
+    /// Deserialize from bytes
     fn deserialize(value: &[u8]) -> Self;
 }
 
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index f4e4390ba..1bffd8f99 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -336,8 +336,7 @@ where
             ),
             tm_consensus_state.into(),
         )?;
-        ctx.store_update_time(client_id.clone(), self.latest_height(), host_timestamp)?;
-        ctx.store_update_height(client_id.clone(), self.latest_height(), host_height)?;
+        ctx.store_update_meta(client_id, self.latest_height(), host_timestamp, host_height)?;
 
         Ok(())
     }
@@ -387,8 +386,7 @@ where
                 ClientStatePath::new(client_id),
                 ClientState::from(new_client_state).into(),
             )?;
-            ctx.store_update_time(client_id.clone(), header_height, host_timestamp)?;
-            ctx.store_update_height(client_id.clone(), header_height, host_height)?;
+            ctx.store_update_meta(client_id, header_height, host_timestamp, host_height)?;
         }
 
         Ok(vec![header_height])
@@ -483,8 +481,7 @@ where
             ),
             TmConsensusState::from(new_consensus_state).into(),
         )?;
-        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
-        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
+        ctx.store_update_meta(client_id, latest_height, host_timestamp, host_height)?;
 
         Ok(latest_height)
     }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 89a88d520..599fc1ca5 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -218,13 +218,9 @@ impl ClientState {
 
             if tm_consensus_state_expiry > host_timestamp {
                 break;
-            } else {
-                let client_id = client_id.clone();
-
-                ctx.delete_consensus_state(client_consensus_state_path)?;
-                ctx.delete_update_time(client_id.clone(), height)?;
-                ctx.delete_update_height(client_id, height)?;
             }
+            ctx.delete_consensus_state(client_consensus_state_path)?;
+            ctx.delete_update_meta(client_id, height)?;
         }
 
         Ok(())
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index a9fac983e..556d5e6fe 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -74,10 +74,8 @@ pub enum Error {
     NotEnoughTrustedValsSigned { reason: VotingPowerTally },
     /// verification failed: `{detail}`
     VerificationError { detail: LightClientErrorDetail },
-    /// Processed time for the client `{client_id}` at height `{height}` not found
-    ProcessedTimeNotFound { client_id: ClientId, height: Height },
-    /// Processed height for the client `{client_id}` at height `{height}` not found
-    ProcessedHeightNotFound { client_id: ClientId, height: Height },
+    /// Processed time or height for the client `{client_id}` at height `{height}` not found
+    UpdateMetaDataNotFound { client_id: ClientId, height: Height },
     /// The given hash of the validators does not matches the given hash in the signed header. Expected: `{signed_header_validators_hash}`, got: `{validators_hash}`
     MismatchValidatorsHashes {
         validators_hash: Hash,
diff --git a/ibc-core/ics02-client/context/src/context.rs b/ibc-core/ics02-client/context/src/context.rs
index 368e2c446..b181c388b 100644
--- a/ibc-core/ics02-client/context/src/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -12,19 +12,13 @@ use super::consensus_state::ConsensusState;
 /// [crate::client_state::ClientStateValidation] must
 /// inherit from this trait.
 pub trait ClientValidationContext {
-    /// Returns the time when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_time(
+    /// Returns the time and height when the client state for the given
+    /// [`ClientId`] was updated with a header for the given [`Height`]
+    fn update_meta(
         &self,
         client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Timestamp, ContextError>;
-
-    /// Returns the height when the client state for the given [`ClientId`] was updated with a header for the given [`Height`]
-    fn client_update_height(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Height, ContextError>;
+        height: Height,
+    ) -> Result<(Timestamp, Height), ContextError>;
 }
 
 /// Defines the methods that all client `ExecutionContext`s (precisely the
@@ -61,40 +55,27 @@ pub trait ClientExecutionContext: Sized {
     ) -> Result<(), ContextError>;
 
     /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified time as the time at which
-    /// this update (or header) was processed.
-    fn store_update_time(
+    ///
+    /// Implementations are expected to use this to record the specified time
+    /// and height as the time at which this update (or header) was processed.
+    fn store_update_meta(
         &mut self,
-        client_id: ClientId,
+        client_id: &ClientId,
         height: Height,
         host_timestamp: Timestamp,
-    ) -> Result<(), ContextError>;
-
-    /// Called upon successful client update.
-    /// Implementations are expected to use this to record the specified height as the height at
-    /// at which this update (or header) was processed.
-    fn store_update_height(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
         host_height: Height,
     ) -> Result<(), ContextError>;
 
-    /// Delete the update time associated with the client at the specified height. This update
-    /// time should be associated with a consensus state through the specified height.
+    /// Delete the update time and height associated with the client at the
+    /// specified height.
+    ///
+    /// This update time should be associated with a consensus state through the
+    /// specified height.
     ///
     /// Note that this timestamp is determined by the host.
-    fn delete_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-    ) -> Result<(), ContextError>;
-
-    /// Delete the update height associated with the client at the specified height. This update
-    /// time should be associated with a consensus state through the specified height.
-    fn delete_update_height(
+    fn delete_update_meta(
         &mut self,
-        client_id: ClientId,
+        client_id: &ClientId,
         height: Height,
     ) -> Result<(), ContextError>;
 }
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index fbfcebcb1..985599dcc 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -26,10 +26,8 @@ pub enum ClientError {
     ClientStateAlreadyExists { client_id: ClientId },
     /// consensus state not found at: `{client_id}` at height `{height}`
     ConsensusStateNotFound { client_id: ClientId, height: Height },
-    /// Processed time for the client `{client_id}` at height `{height}` not found
-    ProcessedTimeNotFound { client_id: ClientId, height: Height },
-    /// Processed height for the client `{client_id}` at height `{height}` not found
-    ProcessedHeightNotFound { client_id: ClientId, height: Height },
+    /// Processed time or height for the client `{client_id}` at height `{height}` not found
+    UpdateMetaDataNotFound { client_id: ClientId, height: Height },
     /// header verification failed with reason: `{reason}`
     HeaderVerificationFailure { reason: String },
     /// failed to build trust threshold from fraction: `{numerator}`/`{denominator}`
diff --git a/ibc-core/ics03-connection/src/delay.rs b/ibc-core/ics03-connection/src/delay.rs
index d573a6eac..04fcc550f 100644
--- a/ibc-core/ics03-connection/src/delay.rs
+++ b/ibc-core/ics03-connection/src/delay.rs
@@ -19,19 +19,16 @@ where
 
     // Fetch the latest time and height that the counterparty client was updated on the host chain.
     let client_id = connection_end.client_id();
-    let last_client_update_time = ctx
+    let last_client_update = ctx
         .get_client_validation_context()
-        .client_update_time(client_id, &packet_proof_height)?;
-    let last_client_update_height = ctx
-        .get_client_validation_context()
-        .client_update_height(client_id, &packet_proof_height)?;
+        .update_meta(client_id, packet_proof_height)?;
 
     // Fetch the connection delay time and height periods.
     let conn_delay_time_period = connection_end.delay_period();
     let conn_delay_height_period = ctx.block_delay(&conn_delay_time_period);
 
     // Verify that the current host chain time is later than the last client update time
-    let earliest_valid_time = (last_client_update_time + conn_delay_time_period)
+    let earliest_valid_time = (last_client_update.0 + conn_delay_time_period)
         .map_err(ConnectionError::TimestampOverflow)?;
     if current_host_time < earliest_valid_time {
         return Err(ContextError::ConnectionError(
@@ -43,7 +40,7 @@ where
     }
 
     // Verify that the current host chain height is later than the last client update height
-    let earliest_valid_height = last_client_update_height.add(conn_delay_height_period);
+    let earliest_valid_height = last_client_update.1.add(conn_delay_height_period);
     if current_host_height < earliest_valid_height {
         return Err(ContextError::ConnectionError(
             ConnectionError::NotEnoughBlocksElapsed {
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 34a387a34..1d47277b6 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -350,8 +350,12 @@ where
             new_consensus_state.into(),
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
-        ctx.store_update_time(client_id.clone(), header_height, ctx.host_timestamp()?)?;
-        ctx.store_update_height(client_id.clone(), header_height, ctx.host_height()?)?;
+        ctx.store_update_meta(
+            client_id,
+            header_height,
+            ctx.host_timestamp()?,
+            ctx.host_height()?,
+        )?;
 
         Ok(vec![header_height])
     }
@@ -395,8 +399,7 @@ where
         let host_timestamp = ctx.host_timestamp()?;
         let host_height = ctx.host_height()?;
 
-        ctx.store_update_time(client_id.clone(), latest_height, host_timestamp)?;
-        ctx.store_update_height(client_id.clone(), latest_height, host_height)?;
+        ctx.store_update_meta(client_id, latest_height, host_timestamp, host_height)?;
 
         Ok(latest_height)
     }
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 667aabdf8..5280270f9 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -156,42 +156,23 @@ impl TmValidationContext for MockContext {
 }
 
 impl ClientValidationContext for MockContext {
-    fn client_update_time(
+    fn update_meta(
         &self,
         client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Timestamp, ContextError> {
-        match self
-            .ibc_store
-            .lock()
-            .client_processed_times
-            .get(&(client_id.clone(), *height))
-        {
-            Some(time) => Ok(*time),
-            None => Err(ClientError::ProcessedTimeNotFound {
-                client_id: client_id.clone(),
-                height: *height,
-            })?,
-        }
-    }
-
-    fn client_update_height(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Height, ContextError> {
-        match self
-            .ibc_store
-            .lock()
-            .client_processed_heights
-            .get(&(client_id.clone(), *height))
-        {
-            Some(height) => Ok(*height),
-            None => Err(ClientError::ProcessedHeightNotFound {
-                client_id: client_id.clone(),
-                height: *height,
-            })?,
-        }
+        height: Height,
+    ) -> Result<(Timestamp, Height), ContextError> {
+        let key = (client_id.clone(), height);
+        (|| {
+            let ibc_store = self.ibc_store.lock();
+            let time = ibc_store.client_processed_times.get(&key)?;
+            let height = ibc_store.client_processed_heights.get(&key)?;
+            Some((*time, *height))
+        })()
+        .ok_or(ClientError::UpdateMetaDataNotFound {
+            client_id: key.0,
+            height,
+        })
+        .map_err(ContextError::from)
     }
 }
 
@@ -273,61 +254,32 @@ impl ClientExecutionContext for MockContext {
         Ok(())
     }
 
-    fn delete_update_height(
+    fn delete_update_meta(
         &mut self,
-        client_id: ClientId,
-        height: Height,
-    ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
-            .client_processed_heights
-            .remove(&(client_id, height));
-
-        Ok(())
-    }
-
-    fn delete_update_time(
-        &mut self,
-        client_id: ClientId,
-        height: Height,
-    ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
-            .client_processed_times
-            .remove(&(client_id, height));
-
-        Ok(())
-    }
-
-    fn store_update_time(
-        &mut self,
-        client_id: ClientId,
+        client_id: &ClientId,
         height: Height,
-        timestamp: Timestamp,
     ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
-            .client_processed_times
-            .insert((client_id, height), timestamp);
-
+        let key = (client_id.clone(), height);
+        let mut ibc_store = self.ibc_store.lock();
+        ibc_store.client_processed_times.remove(&key);
+        ibc_store.client_processed_heights.remove(&key);
         Ok(())
     }
 
-    fn store_update_height(
+    fn store_update_meta(
         &mut self,
-        client_id: ClientId,
+        client_id: &ClientId,
         height: Height,
+        host_timestamp: Timestamp,
         host_height: Height,
     ) -> Result<(), ContextError> {
-        let _ = self
-            .ibc_store
-            .lock()
+        let mut ibc_store = self.ibc_store.lock();
+        ibc_store
+            .client_processed_times
+            .insert((client_id.clone(), height), host_timestamp);
+        ibc_store
             .client_processed_heights
-            .insert((client_id, height), host_height);
-
+            .insert((client_id.clone(), height), host_height);
         Ok(())
     }
 }
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 8d9707566..287ea58ec 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -147,10 +147,7 @@ fn test_consensus_state_pruning() {
         expired_height.revision_number(),
         expired_height.revision_height(),
     );
-    assert!(ctx
-        .client_update_height(&client_id, &expired_height)
-        .is_err());
-    assert!(ctx.client_update_time(&client_id, &expired_height).is_err());
+    assert!(ctx.update_meta(&client_id, expired_height).is_err());
     assert!(ctx.consensus_state(&client_cons_state_path).is_err());
 
     // Check that latest valid consensus state exists.
@@ -161,14 +158,7 @@ fn test_consensus_state_pruning() {
         earliest_valid_height.revision_height(),
     );
 
-    assert!(ctx
-        .client_update_height(&client_id, &earliest_valid_height)
-        .is_ok());
-
-    assert!(ctx
-        .client_update_time(&client_id, &earliest_valid_height)
-        .is_ok());
-
+    assert!(ctx.update_meta(&client_id, earliest_valid_height).is_ok());
     assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
 
     let end_host_timestamp = ctx.host_timestamp().unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index 838f51efe..ead20652a 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -174,16 +174,10 @@ fn ack_success_happy_path(fixture: Fixture) {
             packet_commitment,
         );
     ctx.get_client_execution_context()
-        .store_update_time(
-            ClientId::default(),
+        .store_update_meta(
+            &ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-    ctx.get_client_execution_context()
-        .store_update_height(
-            ClientId::default(),
-            client_height,
             Height::new(0, 4).unwrap(),
         )
         .unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 36dd40ff6..ee4844767 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -140,17 +140,10 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
 
     context
         .get_client_execution_context()
-        .store_update_time(
-            ClientId::default(),
+        .store_update_meta(
+            &ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-    context
-        .get_client_execution_context()
-        .store_update_height(
-            ClientId::default(),
-            client_height,
             Height::new(0, 5).unwrap(),
         )
         .unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index ce5954abf..f3f7cd109 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -203,15 +203,10 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
             packet_commitment,
         );
 
-    ctx.store_update_time(
-        ClientId::default(),
+    ctx.store_update_meta(
+        &ClientId::default(),
         client_height,
         Timestamp::from_nanoseconds(5).unwrap(),
-    )
-    .unwrap();
-    ctx.store_update_height(
-        ClientId::default(),
-        client_height,
         Height::new(0, 4).unwrap(),
     )
     .unwrap();
@@ -290,16 +285,10 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
         );
 
     ctx.get_client_execution_context()
-        .store_update_time(
-            ClientId::default(),
+        .store_update_meta(
+            &ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
-        )
-        .unwrap();
-    ctx.get_client_execution_context()
-        .store_update_height(
-            ClientId::default(),
-            client_height,
             Height::new(0, 5).unwrap(),
         )
         .unwrap();
@@ -345,15 +334,10 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
             packet_commitment,
         );
 
-    ctx.store_update_time(
-        ClientId::default(),
+    ctx.store_update_meta(
+        &ClientId::default(),
         client_height,
         Timestamp::from_nanoseconds(1000).unwrap(),
-    )
-    .unwrap();
-    ctx.store_update_height(
-        ClientId::default(),
-        client_height,
         Height::new(0, 4).unwrap(),
     )
     .unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 3d6922ef8..23fcdf4e2 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -151,17 +151,10 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
 
     context
         .get_client_execution_context()
-        .store_update_time(
-            ClientId::default(),
+        .store_update_meta(
+            &ClientId::default(),
             Height::new(0, 2).unwrap(),
             Timestamp::from_nanoseconds(5000).unwrap(),
-        )
-        .unwrap();
-    context
-        .get_client_execution_context()
-        .store_update_height(
-            ClientId::default(),
-            Height::new(0, 2).unwrap(),
             Height::new(0, 5).unwrap(),
         )
         .unwrap();

From caee889ad308a4aac3f9905de9cdda76c5533cfb Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 1 Feb 2024 14:19:54 -0800
Subject: [PATCH 108/182] fix: be consistent with where arguments own and where
 they borrow (#1072)

---
 .../ics07-tendermint/src/client_state.rs      | 21 ++++++++++++++++---
 .../src/client_state/update_client.rs         |  2 +-
 ibc-core/ics02-client/context/src/context.rs  |  6 +++---
 ibc-core/ics03-connection/src/delay.rs        |  2 +-
 .../testapp/ibc/clients/mock/client_state.rs  |  9 ++++++--
 .../src/testapp/ibc/core/client_ctx.rs        | 12 +++++------
 .../tests/core/ics02_client/update_client.rs  |  4 ++--
 .../core/ics04_channel/acknowledgement.rs     |  2 +-
 .../tests/core/ics04_channel/recv_packet.rs   |  2 +-
 .../tests/core/ics04_channel/timeout.rs       |  6 +++---
 .../core/ics04_channel/timeout_on_close.rs    |  2 +-
 11 files changed, 44 insertions(+), 24 deletions(-)

diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 1bffd8f99..e6cd47364 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -336,7 +336,12 @@ where
             ),
             tm_consensus_state.into(),
         )?;
-        ctx.store_update_meta(client_id, self.latest_height(), host_timestamp, host_height)?;
+        ctx.store_update_meta(
+            client_id.clone(),
+            self.latest_height(),
+            host_timestamp,
+            host_height,
+        )?;
 
         Ok(())
     }
@@ -386,7 +391,12 @@ where
                 ClientStatePath::new(client_id),
                 ClientState::from(new_client_state).into(),
             )?;
-            ctx.store_update_meta(client_id, header_height, host_timestamp, host_height)?;
+            ctx.store_update_meta(
+                client_id.clone(),
+                header_height,
+                host_timestamp,
+                host_height,
+            )?;
         }
 
         Ok(vec![header_height])
@@ -481,7 +491,12 @@ where
             ),
             TmConsensusState::from(new_consensus_state).into(),
         )?;
-        ctx.store_update_meta(client_id, latest_height, host_timestamp, host_height)?;
+        ctx.store_update_meta(
+            client_id.clone(),
+            latest_height,
+            host_timestamp,
+            host_height,
+        )?;
 
         Ok(latest_height)
     }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 599fc1ca5..f412e6242 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -220,7 +220,7 @@ impl ClientState {
                 break;
             }
             ctx.delete_consensus_state(client_consensus_state_path)?;
-            ctx.delete_update_meta(client_id, height)?;
+            ctx.delete_update_meta(client_id.clone(), height)?;
         }
 
         Ok(())
diff --git a/ibc-core/ics02-client/context/src/context.rs b/ibc-core/ics02-client/context/src/context.rs
index b181c388b..a09673bb7 100644
--- a/ibc-core/ics02-client/context/src/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -17,7 +17,7 @@ pub trait ClientValidationContext {
     fn update_meta(
         &self,
         client_id: &ClientId,
-        height: Height,
+        height: &Height,
     ) -> Result<(Timestamp, Height), ContextError>;
 }
 
@@ -60,7 +60,7 @@ pub trait ClientExecutionContext: Sized {
     /// and height as the time at which this update (or header) was processed.
     fn store_update_meta(
         &mut self,
-        client_id: &ClientId,
+        client_id: ClientId,
         height: Height,
         host_timestamp: Timestamp,
         host_height: Height,
@@ -75,7 +75,7 @@ pub trait ClientExecutionContext: Sized {
     /// Note that this timestamp is determined by the host.
     fn delete_update_meta(
         &mut self,
-        client_id: &ClientId,
+        client_id: ClientId,
         height: Height,
     ) -> Result<(), ContextError>;
 }
diff --git a/ibc-core/ics03-connection/src/delay.rs b/ibc-core/ics03-connection/src/delay.rs
index 04fcc550f..feecf23fb 100644
--- a/ibc-core/ics03-connection/src/delay.rs
+++ b/ibc-core/ics03-connection/src/delay.rs
@@ -21,7 +21,7 @@ where
     let client_id = connection_end.client_id();
     let last_client_update = ctx
         .get_client_validation_context()
-        .update_meta(client_id, packet_proof_height)?;
+        .update_meta(client_id, &packet_proof_height)?;
 
     // Fetch the connection delay time and height periods.
     let conn_delay_time_period = connection_end.delay_period();
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 1d47277b6..4c74b7c2d 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -351,7 +351,7 @@ where
         )?;
         ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
         ctx.store_update_meta(
-            client_id,
+            client_id.clone(),
             header_height,
             ctx.host_timestamp()?,
             ctx.host_height()?,
@@ -399,7 +399,12 @@ where
         let host_timestamp = ctx.host_timestamp()?;
         let host_height = ctx.host_height()?;
 
-        ctx.store_update_meta(client_id, latest_height, host_timestamp, host_height)?;
+        ctx.store_update_meta(
+            client_id.clone(),
+            latest_height,
+            host_timestamp,
+            host_height,
+        )?;
 
         Ok(latest_height)
     }
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 5280270f9..227c647af 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -159,9 +159,9 @@ impl ClientValidationContext for MockContext {
     fn update_meta(
         &self,
         client_id: &ClientId,
-        height: Height,
+        height: &Height,
     ) -> Result<(Timestamp, Height), ContextError> {
-        let key = (client_id.clone(), height);
+        let key = (client_id.clone(), *height);
         (|| {
             let ibc_store = self.ibc_store.lock();
             let time = ibc_store.client_processed_times.get(&key)?;
@@ -170,7 +170,7 @@ impl ClientValidationContext for MockContext {
         })()
         .ok_or(ClientError::UpdateMetaDataNotFound {
             client_id: key.0,
-            height,
+            height: key.1,
         })
         .map_err(ContextError::from)
     }
@@ -256,7 +256,7 @@ impl ClientExecutionContext for MockContext {
 
     fn delete_update_meta(
         &mut self,
-        client_id: &ClientId,
+        client_id: ClientId,
         height: Height,
     ) -> Result<(), ContextError> {
         let key = (client_id.clone(), height);
@@ -268,7 +268,7 @@ impl ClientExecutionContext for MockContext {
 
     fn store_update_meta(
         &mut self,
-        client_id: &ClientId,
+        client_id: ClientId,
         height: Height,
         host_timestamp: Timestamp,
         host_height: Height,
@@ -279,7 +279,7 @@ impl ClientExecutionContext for MockContext {
             .insert((client_id.clone(), height), host_timestamp);
         ibc_store
             .client_processed_heights
-            .insert((client_id.clone(), height), host_height);
+            .insert((client_id, height), host_height);
         Ok(())
     }
 }
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 287ea58ec..4cac3e1e8 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -147,7 +147,7 @@ fn test_consensus_state_pruning() {
         expired_height.revision_number(),
         expired_height.revision_height(),
     );
-    assert!(ctx.update_meta(&client_id, expired_height).is_err());
+    assert!(ctx.update_meta(&client_id, &expired_height).is_err());
     assert!(ctx.consensus_state(&client_cons_state_path).is_err());
 
     // Check that latest valid consensus state exists.
@@ -158,7 +158,7 @@ fn test_consensus_state_pruning() {
         earliest_valid_height.revision_height(),
     );
 
-    assert!(ctx.update_meta(&client_id, earliest_valid_height).is_ok());
+    assert!(ctx.update_meta(&client_id, &earliest_valid_height).is_ok());
     assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
 
     let end_host_timestamp = ctx.host_timestamp().unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index ead20652a..056936fd1 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -175,7 +175,7 @@ fn ack_success_happy_path(fixture: Fixture) {
         );
     ctx.get_client_execution_context()
         .store_update_meta(
-            &ClientId::default(),
+            ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 4).unwrap(),
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index ee4844767..773390f17 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -141,7 +141,7 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
     context
         .get_client_execution_context()
         .store_update_meta(
-            &ClientId::default(),
+            ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 5).unwrap(),
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index f3f7cd109..55d964b68 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -204,7 +204,7 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
         );
 
     ctx.store_update_meta(
-        &ClientId::default(),
+        ClientId::default(),
         client_height,
         Timestamp::from_nanoseconds(5).unwrap(),
         Height::new(0, 4).unwrap(),
@@ -286,7 +286,7 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
 
     ctx.get_client_execution_context()
         .store_update_meta(
-            &ClientId::default(),
+            ClientId::default(),
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 5).unwrap(),
@@ -335,7 +335,7 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
         );
 
     ctx.store_update_meta(
-        &ClientId::default(),
+        ClientId::default(),
         client_height,
         Timestamp::from_nanoseconds(1000).unwrap(),
         Height::new(0, 4).unwrap(),
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 23fcdf4e2..c0321e8b1 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -152,7 +152,7 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
     context
         .get_client_execution_context()
         .store_update_meta(
-            &ClientId::default(),
+            ClientId::default(),
             Height::new(0, 2).unwrap(),
             Timestamp::from_nanoseconds(5000).unwrap(),
             Height::new(0, 5).unwrap(),

From 0a275ff15b4392f33cf0e16ad880f67ddbcdeca4 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Tue, 6 Feb 2024 10:36:09 -0600
Subject: [PATCH 109/182] Update `MsgUpdateClient` handlers to accept
 misbehaviour reports via its `client_message` field (#1075)

* Check MsgUpdateClient::client_message by matching against type_url

* Update ibc testkit mock

* Remove leading underscores

* Remove code comments

* Clean up compilation issues from ibc testkit

* Fix ambiguous import issue

* Add passing tests

* Add deprecation attribute to `MsgSubmitMisbehaviour` type

* Remove deprecated attribute from MsgSubmitMisbehaviour

* Remove std::dbg call
---
 .../ics07-tendermint/src/client_state.rs      |  20 +-
 .../types/src/misbehaviour.rs                 |   2 +-
 .../ics02-client/context/src/client_state.rs  |   5 +-
 .../ics02-client/src/handler/update_client.rs |   8 -
 ibc-core/ics02-client/types/src/error.rs      |   2 +
 .../traits/client_state_execution.rs          |   4 +-
 .../traits/client_state_validation.rs         |   7 +-
 ibc-derive/src/utils.rs                       |   5 -
 .../testapp/ibc/clients/mock/client_state.rs  |  23 +--
 .../tests/core/ics02_client/update_client.rs  | 194 ++++++++++++------
 10 files changed, 156 insertions(+), 114 deletions(-)

diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index e6cd47364..211966c68 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -13,6 +13,7 @@ use ibc_client_tendermint_types::proto::v1::ClientState as RawTmClientState;
 use ibc_client_tendermint_types::{
     client_type as tm_client_type, ClientState as ClientStateType,
     ConsensusState as ConsensusStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
+    TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
 };
 use ibc_core_client::context::client_state::{
     ClientStateCommon, ClientStateExecution, ClientStateValidation,
@@ -20,7 +21,7 @@ use ibc_core_client::context::client_state::{
 use ibc_core_client::context::consensus_state::ConsensusState;
 use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
 use ibc_core_client::types::error::{ClientError, UpgradeClientError};
-use ibc_core_client::types::{Height, Status, UpdateKind};
+use ibc_core_client::types::{Height, Status};
 use ibc_core_commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
@@ -240,17 +241,17 @@ where
         ctx: &V,
         client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<(), ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => {
+        match client_message.type_url.as_str() {
+            TENDERMINT_HEADER_TYPE_URL => {
                 let header = TmHeader::try_from(client_message)?;
                 self.verify_header(ctx, client_id, header)
             }
-            UpdateKind::SubmitMisbehaviour => {
+            TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
                 let misbehaviour = TmMisbehaviour::try_from(client_message)?;
                 self.verify_misbehaviour(ctx, client_id, misbehaviour)
             }
+            _ => Err(ClientError::InvalidUpdateClientMessage),
         }
     }
 
@@ -259,17 +260,17 @@ where
         ctx: &V,
         client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<bool, ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => {
+        match client_message.type_url.as_str() {
+            TENDERMINT_HEADER_TYPE_URL => {
                 let header = TmHeader::try_from(client_message)?;
                 self.check_for_misbehaviour_update_client(ctx, client_id, header)
             }
-            UpdateKind::SubmitMisbehaviour => {
+            TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
                 let misbehaviour = TmMisbehaviour::try_from(client_message)?;
                 self.check_for_misbehaviour_misbehavior(&misbehaviour)
             }
+            _ => Err(ClientError::InvalidUpdateClientMessage),
         }
     }
 
@@ -407,7 +408,6 @@ where
         ctx: &mut E,
         client_id: &ClientId,
         _client_message: Any,
-        _update_kind: &UpdateKind,
     ) -> Result<(), ClientError> {
         // NOTE: frozen height is  set to `Height {revision_height: 0,
         // revision_number: 1}` and it is the same for all misbehaviour. This
diff --git a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
index f3013378e..68348d0dc 100644
--- a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
@@ -10,7 +10,7 @@ use ibc_proto::Protobuf;
 use crate::error::Error;
 use crate::header::Header;
 
-const TENDERMINT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Misbehaviour";
+pub const TENDERMINT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Misbehaviour";
 
 /// Tendermint light client's misbehaviour type
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index ccdfedee9..7d6edea96 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -3,7 +3,7 @@
 use core::marker::{Send, Sync};
 
 use ibc_core_client_types::error::ClientError;
-use ibc_core_client_types::{Height, Status, UpdateKind};
+use ibc_core_client_types::{Height, Status};
 use ibc_core_commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
@@ -107,7 +107,6 @@ where
         ctx: &V,
         client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<(), ClientError>;
 
     /// Checks for evidence of a misbehaviour in Header or Misbehaviour type. It
@@ -117,7 +116,6 @@ where
         ctx: &V,
         client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<bool, ClientError>;
 
     /// Returns the status of the client. Only Active clients are allowed to process packets.
@@ -168,7 +166,6 @@ where
         ctx: &mut E,
         client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<(), ClientError>;
 
     // Update the client state and consensus state in the store with the upgraded ones.
diff --git a/ibc-core/ics02-client/src/handler/update_client.rs b/ibc-core/ics02-client/src/handler/update_client.rs
index 54dd9fd42..bb00372c6 100644
--- a/ibc-core/ics02-client/src/handler/update_client.rs
+++ b/ibc-core/ics02-client/src/handler/update_client.rs
@@ -20,10 +20,6 @@ where
     ctx.validate_message_signer(msg.signer())?;
 
     let client_id = msg.client_id().clone();
-    let update_kind = match msg {
-        MsgUpdateOrMisbehaviour::UpdateClient(_) => UpdateKind::UpdateClient,
-        MsgUpdateOrMisbehaviour::Misbehaviour(_) => UpdateKind::SubmitMisbehaviour,
-    };
 
     // Read client state from the host chain store. The client should already exist.
     let client_state = ctx.client_state(&client_id)?;
@@ -38,7 +34,6 @@ where
         ctx.get_client_validation_context(),
         &client_id,
         client_message,
-        &update_kind,
     )?;
 
     Ok(())
@@ -54,14 +49,12 @@ where
         MsgUpdateOrMisbehaviour::Misbehaviour(_) => UpdateKind::SubmitMisbehaviour,
     };
     let client_message = msg.client_message();
-
     let client_state = ctx.client_state(&client_id)?;
 
     let found_misbehaviour = client_state.check_for_misbehaviour(
         ctx.get_client_validation_context(),
         &client_id,
         client_message.clone(),
-        &update_kind,
     )?;
 
     if found_misbehaviour {
@@ -69,7 +62,6 @@ where
             ctx.get_client_execution_context(),
             &client_id,
             client_message,
-            &update_kind,
         )?;
 
         let event = IbcEvent::ClientMisbehaviour(ClientMisbehaviour::new(
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 985599dcc..57102d0e7 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -94,6 +94,8 @@ pub enum ClientError {
     ClientSpecific { description: String },
     /// client counter overflow error
     CounterOverflow,
+    /// update client message did not contain valid header or misbehaviour
+    InvalidUpdateClientMessage,
     /// other error: `{description}`
     Other { description: String },
 }
diff --git a/ibc-derive/src/client_state/traits/client_state_execution.rs b/ibc-derive/src/client_state/traits/client_state_execution.rs
index 8ec55471d..12a1b1de0 100644
--- a/ibc-derive/src/client_state/traits/client_state_execution.rs
+++ b/ibc-derive/src/client_state/traits/client_state_execution.rs
@@ -31,7 +31,7 @@ pub(crate) fn impl_ClientStateExecution(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
-        quote! { update_state_on_misbehaviour(cs, ctx, client_id, client_message, update_kind) },
+        quote! { update_state_on_misbehaviour(cs, ctx, client_id, client_message) },
         imports,
     );
 
@@ -48,7 +48,6 @@ pub(crate) fn impl_ClientStateExecution(
     let ClientId = imports.client_id();
     let ClientError = imports.client_error();
     let ClientStateExecution = imports.client_state_execution();
-    let UpdateKind = imports.update_kind();
     let Height = imports.height();
 
     // The types we need for the generated code.
@@ -91,7 +90,6 @@ pub(crate) fn impl_ClientStateExecution(
                 ctx: &mut #ClientExecutionContext,
                 client_id: &#ClientId,
                 client_message: #Any,
-                update_kind: &#UpdateKind,
             ) -> core::result::Result<(), #ClientError> {
                 match self {
                     #(#update_state_on_misbehaviour_impl),*
diff --git a/ibc-derive/src/client_state/traits/client_state_validation.rs b/ibc-derive/src/client_state/traits/client_state_validation.rs
index 47f0561e1..d87fed4c2 100644
--- a/ibc-derive/src/client_state/traits/client_state_validation.rs
+++ b/ibc-derive/src/client_state/traits/client_state_validation.rs
@@ -17,7 +17,7 @@ pub(crate) fn impl_ClientStateValidation(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
-        quote! { verify_client_message(cs, ctx, client_id, client_message, update_kind) },
+        quote! { verify_client_message(cs, ctx, client_id, client_message) },
         imports,
     );
 
@@ -25,7 +25,7 @@ pub(crate) fn impl_ClientStateValidation(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
-        quote! { check_for_misbehaviour(cs, ctx, client_id, client_message, update_kind) },
+        quote! { check_for_misbehaviour(cs, ctx, client_id, client_message) },
         imports,
     );
 
@@ -43,7 +43,6 @@ pub(crate) fn impl_ClientStateValidation(
     let ClientError = imports.client_error();
     let ClientStateValidation = imports.client_state_validation();
     let Status = imports.status();
-    let UpdateKind = imports.update_kind();
 
     // The types we need for the generated code.
     let HostClientState = client_state_enum_name;
@@ -63,7 +62,6 @@ pub(crate) fn impl_ClientStateValidation(
                 ctx: &#ClientValidationContext,
                 client_id: &#ClientId,
                 client_message: #Any,
-                update_kind: &#UpdateKind,
             ) -> core::result::Result<(), #ClientError> {
                 match self {
                     #(#verify_client_message_impl),*
@@ -75,7 +73,6 @@ pub(crate) fn impl_ClientStateValidation(
                 ctx: &#ClientValidationContext,
                 client_id: &#ClientId,
                 client_message: #Any,
-                update_kind: &#UpdateKind,
             ) -> core::result::Result<bool, #ClientError> {
                 match self {
                     #(#check_for_misbehaviour_impl),*
diff --git a/ibc-derive/src/utils.rs b/ibc-derive/src/utils.rs
index b17c60ccc..e33f13974 100644
--- a/ibc-derive/src/utils.rs
+++ b/ibc-derive/src/utils.rs
@@ -102,11 +102,6 @@ impl Imports {
         quote! {#prefix::primitives::Timestamp}
     }
 
-    pub fn update_kind(&self) -> TokenStream {
-        let prefix = self.prefix();
-        quote! {#prefix::client::types::UpdateKind}
-    }
-
     pub fn status(&self) -> TokenStream {
         let prefix = self.prefix();
         quote! {#prefix::client::types::Status}
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 4c74b7c2d..f798960d3 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -6,7 +6,7 @@ use ibc::core::client::context::client_state::{
 };
 use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
 use ibc::core::client::types::error::{ClientError, UpgradeClientError};
-use ibc::core::client::types::{Height, Status, UpdateKind};
+use ibc::core::client::types::{Height, Status};
 use ibc::core::commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
@@ -19,8 +19,8 @@ use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
-use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::testapp::ibc::clients::mock::misbehaviour::Misbehaviour;
+use crate::testapp::ibc::clients::mock::header::{MockHeader, MOCK_HEADER_TYPE_URL};
+use crate::testapp::ibc::clients::mock::misbehaviour::{Misbehaviour, MOCK_MISBEHAVIOUR_TYPE_URL};
 use crate::testapp::ibc::clients::mock::proto::{
     ClientState as RawMockClientState, Header as RawMockHeader,
 };
@@ -223,10 +223,9 @@ where
         _ctx: &V,
         _client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<(), ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => {
+        match client_message.type_url.as_str() {
+            MOCK_HEADER_TYPE_URL => {
                 let header = MockHeader::try_from(client_message)?;
 
                 if self.latest_height() >= header.height() {
@@ -236,9 +235,10 @@ where
                     });
                 }
             }
-            UpdateKind::SubmitMisbehaviour => {
+            MOCK_MISBEHAVIOUR_TYPE_URL => {
                 let _misbehaviour = Misbehaviour::try_from(client_message)?;
             }
+            _ => {}
         }
 
         Ok(())
@@ -249,11 +249,10 @@ where
         _ctx: &V,
         _client_id: &ClientId,
         client_message: Any,
-        update_kind: &UpdateKind,
     ) -> Result<bool, ClientError> {
-        match update_kind {
-            UpdateKind::UpdateClient => Ok(false),
-            UpdateKind::SubmitMisbehaviour => {
+        match client_message.type_url.as_str() {
+            MOCK_HEADER_TYPE_URL => Ok(false),
+            MOCK_MISBEHAVIOUR_TYPE_URL => {
                 let misbehaviour = Misbehaviour::try_from(client_message)?;
                 let header_1 = misbehaviour.header1;
                 let header_2 = misbehaviour.header2;
@@ -263,6 +262,7 @@ where
 
                 Ok(header_heights_equal && headers_are_in_future)
             }
+            _ => Ok(false),
         }
     }
 
@@ -365,7 +365,6 @@ where
         ctx: &mut E,
         client_id: &ClientId,
         _client_message: Any,
-        _update_kind: &UpdateKind,
     ) -> Result<(), ClientError> {
         let frozen_client_state = self.with_frozen_height(Height::min(0));
 
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 4cac3e1e8..2d4e7bbf3 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -33,23 +33,83 @@ use ibc_testkit::testapp::ibc::clients::mock::misbehaviour::Misbehaviour as Mock
 use ibc_testkit::testapp::ibc::clients::AnyConsensusState;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
 use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use rstest::*;
 use tendermint_testgen::Validator as TestgenValidator;
-use test_log::test;
 
-#[test]
-fn test_update_client_ok() {
-    let client_id = ClientId::default();
-
-    let signer = dummy_account_id();
+struct Fixture {
+    ctx: MockContext,
+    router: MockRouter,
+}
 
-    let timestamp = Timestamp::now();
+#[fixture]
+fn fixture() -> Fixture {
+    let client_id = ClientId::default();
 
-    let mut ctx = MockContext::default().with_client_config(
+    let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
             .client_id(client_id.clone())
             .latest_height(Height::new(0, 42).unwrap())
             .build(),
     );
+
+    let router = MockRouter::new_with_transfer();
+
+    Fixture { ctx, router }
+}
+
+/// rstest fixture that returns a `MsgEnvelope` with the `client_message`
+/// field set to a `MockMisbehaviour` report.
+#[fixture]
+fn msg_update_client() -> MsgEnvelope {
+    let client_id = ClientId::default();
+    let timestamp = Timestamp::now();
+    let height = Height::new(0, 46).unwrap();
+    let msg = MsgUpdateClient {
+        client_id: client_id.clone(),
+        client_message: MockMisbehaviour {
+            client_id: client_id.clone(),
+            header1: MockHeader::new(height).with_timestamp(timestamp),
+            header2: MockHeader::new(height).with_timestamp(timestamp),
+        }
+        .into(),
+        signer: dummy_account_id(),
+    };
+
+    MsgEnvelope::from(ClientMsg::from(msg))
+}
+
+/// rstest fixture that returns a `MsgEnvelope` with the `misbehaviour`
+/// field set to a `MockMisbehaviour` report.
+#[fixture]
+fn msg_submit_misbehaviour() -> MsgEnvelope {
+    let client_id = ClientId::default();
+    let timestamp = Timestamp::now();
+    let height = Height::new(0, 46).unwrap();
+    let msg = MsgSubmitMisbehaviour {
+        client_id: client_id.clone(),
+        misbehaviour: MockMisbehaviour {
+            client_id: client_id.clone(),
+            header1: MockHeader::new(height).with_timestamp(timestamp),
+            header2: MockHeader::new(height).with_timestamp(timestamp),
+        }
+        .into(),
+        signer: dummy_account_id(),
+    };
+
+    MsgEnvelope::from(ClientMsg::from(msg))
+}
+
+#[rstest]
+fn test_update_client_ok(fixture: Fixture) {
+    let Fixture {
+        mut ctx,
+        mut router,
+    } = fixture;
+
+    let client_id = ClientId::default();
+    let signer = dummy_account_id();
+    let timestamp = Timestamp::now();
+
     let height = Height::new(0, 46).unwrap();
     let msg = MsgUpdateClient {
         client_id,
@@ -59,8 +119,6 @@ fn test_update_client_ok() {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let mut router = MockRouter::new_with_transfer();
-
     let res = validate(&ctx, &router, msg_envelope.clone());
 
     assert!(res.is_ok(), "validation happy path");
@@ -87,7 +145,7 @@ fn test_update_client_ok() {
 /// thus checks that the consensus state at height 1 is not contained in
 /// the store. It also checks that the consensus state at height 2 is
 /// contained in the store and has not expired.
-#[test]
+#[rstest]
 fn test_consensus_state_pruning() {
     let chain_id = ChainId::new("mockgaiaA-1").unwrap();
 
@@ -169,21 +227,12 @@ fn test_consensus_state_pruning() {
     );
 }
 
-#[test]
-fn test_update_nonexisting_client() {
-    let client_id = ClientId::from_str("mockclient1").unwrap();
+#[rstest]
+fn test_update_nonexisting_client(fixture: Fixture) {
+    let Fixture { ctx, router } = fixture;
 
     let signer = dummy_account_id();
 
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
-    );
-
-    let router = MockRouter::new_with_transfer();
-
     let msg = MsgUpdateClient {
         client_id: ClientId::from_str("nonexistingclient").unwrap(),
         client_message: MockHeader::new(Height::new(0, 46).unwrap()).into(),
@@ -197,7 +246,7 @@ fn test_update_nonexisting_client() {
     assert!(res.is_err());
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_adjacent_ok() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -254,7 +303,7 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
     assert_eq!(client_state.latest_height(), latest_header_height);
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_validator_change_ok() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -346,7 +395,7 @@ fn test_update_synthetic_tendermint_client_validator_change_ok() {
     assert_eq!(client_state.latest_height(), latest_header_height);
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_validator_change_fail() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -430,7 +479,7 @@ fn test_update_synthetic_tendermint_client_validator_change_fail() {
     assert!(res.is_err());
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -493,7 +542,7 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
     assert_eq!(client_state.latest_height(), latest_header_height);
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_duplicate_ok() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -626,7 +675,7 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
     assert_eq!(client_state, ctx_a.latest_client_states(&msg.client_id));
 }
 
-#[test]
+#[rstest]
 fn test_update_synthetic_tendermint_client_lower_height() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -671,20 +720,17 @@ fn test_update_synthetic_tendermint_client_lower_height() {
     assert!(res.is_err());
 }
 
-#[test]
-fn test_update_client_events() {
+#[rstest]
+fn test_update_client_events(fixture: Fixture) {
+    let Fixture {
+        mut ctx,
+        mut router,
+    } = fixture;
+
     let client_id = ClientId::default();
     let signer = dummy_account_id();
-
     let timestamp = Timestamp::now();
 
-    let mut ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
-    );
-    let mut router = MockRouter::new_with_transfer();
     let height = Height::new(0, 46).unwrap();
     let header: Any = MockHeader::new(height).with_timestamp(timestamp).into();
     let msg = MsgUpdateClient {
@@ -732,49 +778,66 @@ fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &Cl
 }
 
 /// Tests misbehaviour handling for the mock client.
-/// Misbehaviour evidence consists of identical headers - mock misbehaviour handler considers it
-/// a valid proof of misbehaviour
-#[test]
-fn test_misbehaviour_client_ok() {
+///
+/// Misbehaviour evidence consists of identical headers - mock misbehaviour handler
+/// considers it a valid proof of misbehaviour.
+#[rstest]
+#[case::msg_submit_misbehaviour(msg_submit_misbehaviour())]
+#[case::msg_update_client(msg_update_client())]
+fn test_misbehaviour_client_ok(fixture: Fixture, #[case] msg_envelope: MsgEnvelope) {
+    let Fixture {
+        mut ctx,
+        mut router,
+    } = fixture;
+
     let client_id = ClientId::default();
-    let timestamp = Timestamp::now();
+
+    let res = validate(&ctx, &router, msg_envelope.clone());
+    assert!(res.is_ok());
+
+    let res = execute(&mut ctx, &mut router, msg_envelope);
+    assert!(res.is_ok());
+
+    ensure_misbehaviour(&ctx, &client_id, &mock_client_type());
+}
+
+#[rstest]
+fn test_submit_misbehaviour_nonexisting_client(fixture: Fixture) {
+    let Fixture { router, .. } = fixture;
+
+    let client_id = ClientId::from_str("mockclient1").unwrap();
     let height = Height::new(0, 46).unwrap();
     let msg = MsgSubmitMisbehaviour {
-        client_id: client_id.clone(),
+        client_id: ClientId::from_str("nonexistingclient").unwrap(),
         misbehaviour: MockMisbehaviour {
             client_id: client_id.clone(),
-            header1: MockHeader::new(height).with_timestamp(timestamp),
-            header2: MockHeader::new(height).with_timestamp(timestamp),
+            header1: MockHeader::new(height),
+            header2: MockHeader::new(height),
         }
         .into(),
         signer: dummy_account_id(),
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let mut ctx = MockContext::default().with_client_config(
+    let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
             .client_id(client_id.clone())
             .latest_height(Height::new(0, 42).unwrap())
             .build(),
     );
-    let mut router = MockRouter::new_with_transfer();
-
-    let res = validate(&ctx, &router, msg_envelope.clone());
-    assert!(res.is_ok());
-    let res = execute(&mut ctx, &mut router, msg_envelope);
-    assert!(res.is_ok());
-
-    ensure_misbehaviour(&ctx, &client_id, &mock_client_type());
+    let res = validate(&ctx, &router, msg_envelope);
+    assert!(res.is_err());
 }
 
-/// Tests misbehaviour handling failure for a non-existent client
-#[test]
-fn test_misbehaviour_nonexisting_client() {
+#[rstest]
+fn test_client_update_misbehaviour_nonexisting_client(fixture: Fixture) {
+    let Fixture { router, .. } = fixture;
+
     let client_id = ClientId::from_str("mockclient1").unwrap();
     let height = Height::new(0, 46).unwrap();
-    let msg = MsgSubmitMisbehaviour {
+    let msg = MsgUpdateClient {
         client_id: ClientId::from_str("nonexistingclient").unwrap(),
-        misbehaviour: MockMisbehaviour {
+        client_message: MockMisbehaviour {
             client_id: client_id.clone(),
             header1: MockHeader::new(height),
             header2: MockHeader::new(height),
@@ -790,14 +853,13 @@ fn test_misbehaviour_nonexisting_client() {
             .latest_height(Height::new(0, 42).unwrap())
             .build(),
     );
-    let router = MockRouter::new_with_transfer();
     let res = validate(&ctx, &router, msg_envelope);
     assert!(res.is_err());
 }
 
 /// Tests misbehaviour handling for the synthetic Tendermint client.
 /// Misbehaviour evidence consists of equivocal headers.
-#[test]
+#[rstest]
 fn test_misbehaviour_synthetic_tendermint_equivocation() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -859,7 +921,7 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
     ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
 }
 
-#[test]
+#[rstest]
 fn test_misbehaviour_synthetic_tendermint_bft_time() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
@@ -922,7 +984,7 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
     ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
 }
 
-#[test]
+#[rstest]
 fn test_expired_client() {
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
@@ -961,7 +1023,7 @@ fn test_expired_client() {
     assert!(client_state.status(&ctx, &client_id).unwrap().is_expired());
 }
 
-#[test]
+#[rstest]
 fn test_client_update_max_clock_drift() {
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 

From 21b6ad0db361a5e5dc0e78d44903dcfd11294e3f Mon Sep 17 00:00:00 2001
From: Adi Seredinschi <adi@informal.systems>
Date: Tue, 6 Feb 2024 20:38:51 +0100
Subject: [PATCH 110/182] Update PULL_REQUEST_TEMPLATE.md (#1067)

* Update PULL_REQUEST_TEMPLATE.md

Updated the PR template to put a reminder, so that when we do new version releases we notify the comms team about it in advance.

Signed-off-by: Adi Seredinschi <adi@informal.systems>

* using releases.md instead of PR template

* Apply suggestions from code review

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

---------

Signed-off-by: Adi Seredinschi <adi@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 RELEASES.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/RELEASES.md b/RELEASES.md
index a9d4d06f0..6d10f734d 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -48,6 +48,11 @@ Our release process is as follows:
     then update the release description and append:
    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
 
+### Communications (non-technical) release pipeline
+
+- Notify the communications team about the pending release and prepare an announcement.
+- Coordinate with other organizations that are active in IBC development (e.g., Interchain) and keep them in the loop.
+
 All done! 🎉
 
 [crates.io]: https://crates.io

From 4428fa98316fb453cb006db574dc39fe5e3b1999 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Tue, 6 Feb 2024 22:03:21 -0600
Subject: [PATCH 111/182] chore: deprecate `MsgSubmitMisbehaviour` (#1079)

* Decorate MsgSubmitMisbehaviour with `deprecated` attribute

* Add #[allow(deprecated)] attributes in ibc-testkit

* Add #![allow(deprecated)] attribute to ics02/types/msgs/mod.rs

* Remove usages of MsgSubmitMisbehaviour from ibc-testkit/update_client.rs

* Remove unused rstest fixture

* Fix incorrect doc comment

* Add changelog entry

* chore: add missing unclog for PR835

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1077-deprecate-msgsubmitmisbehaviour.md   |  3 +
 ...date-client-handler-accept-misbehaviour.md |  3 +
 .../types/src/msgs/misbehaviour.rs            |  9 ++-
 ibc-core/ics02-client/types/src/msgs/mod.rs   |  3 +
 ibc-core/ics25-handler/types/src/msgs.rs      |  2 +
 .../tests/core/ics02_client/update_client.rs  | 72 ++++---------------
 6 files changed, 32 insertions(+), 60 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md
 create mode 100644 .changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md

diff --git a/.changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md b/.changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md
new file mode 100644
index 000000000..e92dc29d2
--- /dev/null
+++ b/.changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md
@@ -0,0 +1,3 @@
+- [ibc-core] Deprecate `MsgSubmitMisbehaviour` in favor of `MsgUpdateClient` for
+  submitting misbehaviour reports
+  ([\#1077](https://github.com/cosmos/ibc-rs/issues/1077))
diff --git a/.changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md b/.changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md
new file mode 100644
index 000000000..6e6b8488e
--- /dev/null
+++ b/.changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md
@@ -0,0 +1,3 @@
+- [ibc-core] Update `MsgUpdateClient` handler to accept misbehaviour reports via
+  its `client_message` field
+  ([\#835](https://github.com/cosmos/ibc-rs/issues/835))
diff --git a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
index b47be6166..fc13aa91f 100644
--- a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
+++ b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
@@ -12,6 +12,13 @@ use crate::error::ClientError;
 pub const SUBMIT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMisbehaviour";
 
 /// A type of message that submits client misbehaviour proof.
+///
+/// Deprecated since v0.51.0. Misbehaviour reports should be submitted via the `MsgUpdateClient`
+/// type through its `client_message` field.
+#[deprecated(
+    since = "0.51.0",
+    note = "Misbehaviour reports should be submitted via `MsgUpdateClient` through its `client_message` field"
+)]
 #[cfg_attr(
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
@@ -32,7 +39,6 @@ impl Protobuf<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {}
 impl TryFrom<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {
     type Error = ClientError;
 
-    #[allow(deprecated)]
     fn try_from(raw: RawMsgSubmitMisbehaviour) -> Result<Self, Self::Error> {
         let raw_misbehaviour = raw
             .misbehaviour
@@ -51,7 +57,6 @@ impl TryFrom<RawMsgSubmitMisbehaviour> for MsgSubmitMisbehaviour {
 
 impl From<MsgSubmitMisbehaviour> for RawMsgSubmitMisbehaviour {
     fn from(ics_msg: MsgSubmitMisbehaviour) -> Self {
-        #[allow(deprecated)]
         RawMsgSubmitMisbehaviour {
             client_id: ics_msg.client_id.to_string(),
             misbehaviour: Some(ics_msg.misbehaviour),
diff --git a/ibc-core/ics02-client/types/src/msgs/mod.rs b/ibc-core/ics02-client/types/src/msgs/mod.rs
index 33330a77d..ab9a145ed 100644
--- a/ibc-core/ics02-client/types/src/msgs/mod.rs
+++ b/ibc-core/ics02-client/types/src/msgs/mod.rs
@@ -1,4 +1,7 @@
+#![allow(deprecated)]
+
 //! Defines the client message types that are sent to the chain by the relayer.
+
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Signer;
diff --git a/ibc-core/ics25-handler/types/src/msgs.rs b/ibc-core/ics25-handler/types/src/msgs.rs
index 849bcaaf6..1272c0aff 100644
--- a/ibc-core/ics25-handler/types/src/msgs.rs
+++ b/ibc-core/ics25-handler/types/src/msgs.rs
@@ -6,6 +6,7 @@ use ibc_core_channel_types::msgs::{
     CHAN_OPEN_INIT_TYPE_URL, CHAN_OPEN_TRY_TYPE_URL, RECV_PACKET_TYPE_URL,
     TIMEOUT_ON_CLOSE_TYPE_URL, TIMEOUT_TYPE_URL,
 };
+#[allow(deprecated)]
 use ibc_core_client_types::msgs::{
     ClientMsg, MsgCreateClient, MsgSubmitMisbehaviour, MsgUpdateClient, MsgUpgradeClient,
     CREATE_CLIENT_TYPE_URL, SUBMIT_MISBEHAVIOUR_TYPE_URL, UPDATE_CLIENT_TYPE_URL,
@@ -35,6 +36,7 @@ pub enum MsgEnvelope {
     Packet(PacketMsg),
 }
 
+#[allow(deprecated)]
 impl TryFrom<Any> for MsgEnvelope {
     type Error = RouterError;
 
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 2d4e7bbf3..fc60fcbab 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -9,7 +9,7 @@ use ibc::clients::tendermint::types::{
 };
 use ibc::core::client::context::client_state::{ClientStateCommon, ClientStateValidation};
 use ibc::core::client::context::ClientValidationContext;
-use ibc::core::client::types::msgs::{ClientMsg, MsgSubmitMisbehaviour, MsgUpdateClient};
+use ibc::core::client::types::msgs::{ClientMsg, MsgUpdateClient};
 use ibc::core::client::types::proto::v1::Height as RawHeight;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::specs::ProofSpecs;
@@ -57,11 +57,8 @@ fn fixture() -> Fixture {
     Fixture { ctx, router }
 }
 
-/// rstest fixture that returns a `MsgEnvelope` with the `client_message`
-/// field set to a `MockMisbehaviour` report.
-#[fixture]
-fn msg_update_client() -> MsgEnvelope {
-    let client_id = ClientId::default();
+/// Returns a `MsgEnvelope` with the `client_message` field set to a `MockMisbehaviour` report.
+fn msg_update_client(client_id: &ClientId) -> MsgEnvelope {
     let timestamp = Timestamp::now();
     let height = Height::new(0, 46).unwrap();
     let msg = MsgUpdateClient {
@@ -78,27 +75,6 @@ fn msg_update_client() -> MsgEnvelope {
     MsgEnvelope::from(ClientMsg::from(msg))
 }
 
-/// rstest fixture that returns a `MsgEnvelope` with the `misbehaviour`
-/// field set to a `MockMisbehaviour` report.
-#[fixture]
-fn msg_submit_misbehaviour() -> MsgEnvelope {
-    let client_id = ClientId::default();
-    let timestamp = Timestamp::now();
-    let height = Height::new(0, 46).unwrap();
-    let msg = MsgSubmitMisbehaviour {
-        client_id: client_id.clone(),
-        misbehaviour: MockMisbehaviour {
-            client_id: client_id.clone(),
-            header1: MockHeader::new(height).with_timestamp(timestamp),
-            header2: MockHeader::new(height).with_timestamp(timestamp),
-        }
-        .into(),
-        signer: dummy_account_id(),
-    };
-
-    MsgEnvelope::from(ClientMsg::from(msg))
-}
-
 #[rstest]
 fn test_update_client_ok(fixture: Fixture) {
     let Fixture {
@@ -782,15 +758,14 @@ fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &Cl
 /// Misbehaviour evidence consists of identical headers - mock misbehaviour handler
 /// considers it a valid proof of misbehaviour.
 #[rstest]
-#[case::msg_submit_misbehaviour(msg_submit_misbehaviour())]
-#[case::msg_update_client(msg_update_client())]
-fn test_misbehaviour_client_ok(fixture: Fixture, #[case] msg_envelope: MsgEnvelope) {
+fn test_misbehaviour_client_ok(fixture: Fixture) {
     let Fixture {
         mut ctx,
         mut router,
     } = fixture;
 
     let client_id = ClientId::default();
+    let msg_envelope = msg_update_client(&client_id);
 
     let res = validate(&ctx, &router, msg_envelope.clone());
     assert!(res.is_ok());
@@ -806,18 +781,8 @@ fn test_submit_misbehaviour_nonexisting_client(fixture: Fixture) {
     let Fixture { router, .. } = fixture;
 
     let client_id = ClientId::from_str("mockclient1").unwrap();
-    let height = Height::new(0, 46).unwrap();
-    let msg = MsgSubmitMisbehaviour {
-        client_id: ClientId::from_str("nonexistingclient").unwrap(),
-        misbehaviour: MockMisbehaviour {
-            client_id: client_id.clone(),
-            header1: MockHeader::new(height),
-            header2: MockHeader::new(height),
-        }
-        .into(),
-        signer: dummy_account_id(),
-    };
-    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let msg_envelope = msg_update_client(&ClientId::from_str("nonexistingclient").unwrap());
 
     let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -834,18 +799,8 @@ fn test_client_update_misbehaviour_nonexisting_client(fixture: Fixture) {
     let Fixture { router, .. } = fixture;
 
     let client_id = ClientId::from_str("mockclient1").unwrap();
-    let height = Height::new(0, 46).unwrap();
-    let msg = MsgUpdateClient {
-        client_id: ClientId::from_str("nonexistingclient").unwrap(),
-        client_message: MockMisbehaviour {
-            client_id: client_id.clone(),
-            header1: MockHeader::new(height),
-            header2: MockHeader::new(height),
-        }
-        .into(),
-        signer: dummy_account_id(),
-    };
-    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let msg_envelope = msg_update_client(&ClientId::from_str("nonexistingclient").unwrap());
 
     let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -907,9 +862,9 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
         tm_block.into()
     };
 
-    let msg = MsgSubmitMisbehaviour {
+    let msg = MsgUpdateClient {
         client_id: client_id.clone(),
-        misbehaviour: TmMisbehaviour::new(client_id.clone(), header1, header2).into(),
+        client_message: TmMisbehaviour::new(client_id.clone(), header1, header2).into(),
         signer: dummy_account_id(),
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
@@ -969,9 +924,10 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
         tm_block
     };
 
-    let msg = MsgSubmitMisbehaviour {
+    let msg = MsgUpdateClient {
         client_id: client_id.clone(),
-        misbehaviour: TmMisbehaviour::new(client_id.clone(), header1.into(), header2.into()).into(),
+        client_message: TmMisbehaviour::new(client_id.clone(), header1.into(), header2.into())
+            .into(),
         signer: dummy_account_id(),
     };
 

From c8dcb04ba28ee6ea19aa2140586980fb05ca2fc2 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 9 Feb 2024 08:55:33 -0800
Subject: [PATCH 112/182] fix: use header height for Tendermint consensus state
 storage (#1081)

* fix: use header height for Tendermint consensus state storage

* fix: make clippy 0.1.76 happy

* test: add test_update_client_with_prev_header

* nit: remove redundant clones

* fix: remove stale header test
---
 ...date-client-handler-accept-misbehaviour.md |  0
 ...r-height-for-tm-consensus-state-storage.md |  2 +
 .../ics07-tendermint/src/client_state.rs      |  4 +-
 ibc-core/ics02-client/types/src/error.rs      |  5 --
 ibc-core/ics04-channel/types/src/channel.rs   |  2 +-
 .../testapp/ibc/clients/mock/client_state.rs  |  9 +--
 .../tests/core/ics02_client/update_client.rs  | 75 +++++++++++++++++++
 ibc-testkit/tests/core/router.rs              | 11 ---
 8 files changed, 81 insertions(+), 27 deletions(-)
 rename .changelog/unreleased/{improvements => breaking-changes}/835-msg-update-client-handler-accept-misbehaviour.md (100%)
 create mode 100644 .changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md

diff --git a/.changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md b/.changelog/unreleased/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md
similarity index 100%
rename from .changelog/unreleased/improvements/835-msg-update-client-handler-accept-misbehaviour.md
rename to .changelog/unreleased/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md
diff --git a/.changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md b/.changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md
new file mode 100644
index 000000000..a9a3124ac
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md
@@ -0,0 +1,2 @@
+- [ibc-client-tendermint] Use header height for Tendermint consensus state storage
+  ([\#1080](https://github.com/cosmos/ibc-rs/issues/1080))
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 211966c68..3c2c2ab5f 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -383,8 +383,8 @@ where
             ctx.store_consensus_state(
                 ClientConsensusStatePath::new(
                     client_id.clone(),
-                    new_client_state.latest_height.revision_number(),
-                    new_client_state.latest_height.revision_height(),
+                    header_height.revision_number(),
+                    header_height.revision_height(),
                 ),
                 TmConsensusState::from(new_consensus_state).into(),
             )?;
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 57102d0e7..c34eb0436 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -75,11 +75,6 @@ pub enum ClientError {
     InvalidPacketTimestamp(ibc_primitives::ParseTimestampError),
     /// mismatch between client and arguments types
     ClientArgsTypeMismatch { client_type: ClientType },
-    /// received header height (`{header_height}`) is lower than (or equal to) client latest height (`{latest_height}`)
-    LowHeaderHeight {
-        header_height: Height,
-        latest_height: Height,
-    },
     /// timestamp is invalid or missing, timestamp=`{time1}`,  now=`{time2}`
     InvalidConsensusStateTimestamp { time1: Timestamp, time2: Timestamp },
     /// the local consensus state could not be retrieved for height `{height}`
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index aa0f3b633..f42d8b86f 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -313,7 +313,7 @@ impl ChannelEnd {
 
 /// Checks if the `connection_hops` has a length of `expected`.
 pub(crate) fn verify_connection_hops_length(
-    connection_hops: &Vec<ConnectionId>,
+    connection_hops: &[ConnectionId],
     expected: u64,
 ) -> Result<(), ChannelError> {
     if connection_hops.len() as u64 != expected {
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index f798960d3..0c1ea1a8b 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -226,14 +226,7 @@ where
     ) -> Result<(), ClientError> {
         match client_message.type_url.as_str() {
             MOCK_HEADER_TYPE_URL => {
-                let header = MockHeader::try_from(client_message)?;
-
-                if self.latest_height() >= header.height() {
-                    return Err(ClientError::LowHeaderHeight {
-                        header_height: header.height(),
-                        latest_height: self.latest_height(),
-                    });
-                }
+                let _header = MockHeader::try_from(client_message)?;
             }
             MOCK_MISBEHAVIOUR_TYPE_URL => {
                 let _misbehaviour = Misbehaviour::try_from(client_message)?;
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index fc60fcbab..bc7bf02ad 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -109,6 +109,81 @@ fn test_update_client_ok(fixture: Fixture) {
     );
 }
 
+#[rstest]
+// Tests successful submission of a header with a height below the latest
+// client's height and ensures that `ConsensusState` is stored at the correct
+// path (header height).
+fn test_update_client_with_prev_header() {
+    let client_id = ClientId::default();
+    let chain_id_b = ChainId::new("mockgaiaA-0").unwrap();
+    let latest_height = Height::new(0, 42).unwrap();
+    let height_1 = Height::new(0, 43).unwrap();
+    let height_2 = Height::new(0, 44).unwrap();
+
+    let mut ctx = MockContext::default().with_client_config(
+        MockClientConfig::builder()
+            .client_chain_id(chain_id_b.clone())
+            .client_type(tm_client_type())
+            .client_id(client_id.clone())
+            .latest_height(latest_height)
+            .build(),
+    );
+    let mut router = MockRouter::new_with_transfer();
+
+    fn build_msg_from_header(
+        chain_id: ChainId,
+        client_id: ClientId,
+        target_height: Height,
+        trusted_height: Height,
+    ) -> MsgEnvelope {
+        let mut tm_block = HostBlock::generate_tm_block(
+            chain_id,
+            target_height.revision_height(),
+            Timestamp::now(),
+        );
+
+        tm_block.trusted_height = trusted_height;
+
+        let msg = MsgUpdateClient {
+            client_id,
+            client_message: TmHeader::from(tm_block).into(),
+            signer: dummy_account_id(),
+        };
+
+        MsgEnvelope::from(ClientMsg::from(msg))
+    }
+
+    let msg_1 = build_msg_from_header(
+        chain_id_b.clone(),
+        client_id.clone(),
+        height_1,
+        latest_height,
+    );
+
+    let msg_2 = build_msg_from_header(chain_id_b, client_id.clone(), height_2, latest_height);
+
+    // First, submit a header with `height_2` to set the client's latest
+    // height to `height_2`.
+    let _ = validate(&ctx, &router, msg_2.clone());
+    let _ = execute(&mut ctx, &mut router, msg_2);
+
+    // Then, submit a header with `height_1` to see if the client's latest
+    // height remains `height_2` and the consensus state is stored at the
+    // correct path (`height_1`).
+    let _ = validate(&ctx, &router, msg_1.clone());
+    let _ = execute(&mut ctx, &mut router, msg_1);
+
+    let client_state = ctx.client_state(&client_id).unwrap();
+    assert_eq!(client_state.latest_height(), height_2);
+
+    let cons_state_path = ClientConsensusStatePath::new(
+        client_id,
+        height_1.revision_number(),
+        height_1.revision_height(),
+    );
+    assert!(ctx.consensus_state(&cons_state_path).is_ok());
+}
+
 /// Tests that the Tendermint client consensus state pruning logic
 /// functions correctly.
 ///
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index 70756530f..a946222ae 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -222,17 +222,6 @@ fn routing_module_and_keepers() {
             want_pass: true,
             state_check: None,
         },
-        Test {
-            name: "Client update fails due to stale header".to_string(),
-            msg: MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
-                client_id: client_id.clone(),
-                client_message: MockHeader::new(update_client_height).into(),
-                signer: default_signer.clone(),
-            }))
-            .into(),
-            want_pass: false,
-            state_check: None,
-        },
         Test {
             name: "Connection open init succeeds".to_string(),
             msg: MsgEnvelope::Connection(ConnectionMsg::OpenInit(

From 5963ba5947b9117d2fe5177c6565c885eccab059 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Fri, 9 Feb 2024 11:29:23 -0800
Subject: [PATCH 113/182] deps: update time requirement from >=0.3.0, <0.3.32
 to >=0.3.0, <0.3.35 (#1076)

Updates the requirements on [time](https://github.com/time-rs/time) to permit the latest version.
- [Release notes](https://github.com/time-rs/time/releases)
- [Changelog](https://github.com/time-rs/time/blob/main/CHANGELOG.md)
- [Commits](https://github.com/time-rs/time/compare/v0.3.0...v0.3.34)

---
updated-dependencies:
- dependency-name: time
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 ibc-primitives/Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index 2c3592ebc..800b82cbd 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -25,7 +25,7 @@ displaydoc  = { workspace = true }
 prost       = { version = "0.12", default-features = false }
 schemars    = { workspace = true, optional = true }
 serde       = { workspace = true, optional = true }
-time        = { version = ">=0.3.0, <0.3.32", default-features = false }
+time        = { version = ">=0.3.0, <0.3.35", default-features = false }
 
 # ibc dependencies
 ibc-proto = { workspace = true }

From cf82f2a2180a8fdd6370888fa19220b9d454a3e1 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 9 Feb 2024 11:29:37 -0800
Subject: [PATCH 114/182] deps: upgrade `serde_json` to version "1.0.1" (#1083)

* deps: bump serde_json version

* chore: add unclog
---
 .changelog/unreleased/bug-fixes/1083-bump-serde-json.md | 3 +++
 Cargo.toml                                              | 2 +-
 ci/cw-check/Cargo.lock                                  | 8 ++++----
 ci/cw-check/Cargo.toml                                  | 2 +-
 ci/no-std-check/Cargo.lock                              | 4 ++--
 5 files changed, 11 insertions(+), 8 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1083-bump-serde-json.md

diff --git a/.changelog/unreleased/bug-fixes/1083-bump-serde-json.md b/.changelog/unreleased/bug-fixes/1083-bump-serde-json.md
new file mode 100644
index 000000000..e3ffff7b4
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1083-bump-serde-json.md
@@ -0,0 +1,3 @@
+- [ibc] Upgrade `serde_json` to "1.0.1" to address an stack overflow issue
+  within the `serde-json-wasm` crate
+  ([\#1083](https://github.com/cosmos/ibc-rs/pull/1083))
diff --git a/Cargo.toml b/Cargo.toml
index 6007c4f27..f645467b6 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -57,7 +57,7 @@ rstest              = "0.18.2"
 schemars            = { version = "0.8.15" }
 sha2                = { version = "0.10.8", default-features = false }
 serde               = { version = "1.0", default-features = false }
-serde_json          = { package = "serde-json-wasm", version = "1.0.0", default-features = false }
+serde_json          = { package = "serde-json-wasm", version = "1.0.1", default-features = false }
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 28ea56fe3..b37e44bb4 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -245,7 +245,7 @@ dependencies = [
  "cosmwasm-std",
  "ibc-apps",
  "ibc-core",
- "serde-json-wasm 1.0.0",
+ "serde-json-wasm 1.0.1",
  "thiserror",
 ]
 
@@ -573,7 +573,7 @@ version = "0.50.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
- "serde-json-wasm 1.0.0",
+ "serde-json-wasm 1.0.1",
 ]
 
 [[package]]
@@ -1296,9 +1296,9 @@ dependencies = [
 
 [[package]]
 name = "serde-json-wasm"
-version = "1.0.0"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83c37d03f3b0f6b5f77c11af1e7c772de1c9af83e50bef7bb6069601900ba67b"
+checksum = "f05da0d153dd4595bdffd5099dc0e9ce425b205ee648eb93437ff7302af8c9a5"
 dependencies = [
  "serde",
 ]
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 461de802e..72b1313f9 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -11,7 +11,7 @@ ibc-apps = { path = "../../ibc-apps", default_features = false, features = ["ser
 ibc-core = { path = "../../ibc-core", features = ["serde", "parity-scale-codec", "schema"] }
 cosmwasm-std = { version = "^1.5.0", default-features = false }
 cosmwasm-schema = { version = "^1.5.0", default-features = false }
-serde_json =  { package = "serde-json-wasm", version = "^1.0.0", default-features = false }
+serde_json =  { package = "serde-json-wasm", version = "^1.0.1", default-features = false }
 thiserror = { version = "^1.0", default-features = false }
 
 [profile.release]
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 3dfe7207c..038afd5a6 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -2622,9 +2622,9 @@ dependencies = [
 
 [[package]]
 name = "serde-json-wasm"
-version = "1.0.0"
+version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83c37d03f3b0f6b5f77c11af1e7c772de1c9af83e50bef7bb6069601900ba67b"
+checksum = "f05da0d153dd4595bdffd5099dc0e9ce425b205ee648eb93437ff7302af8c9a5"
 dependencies = [
  "serde",
 ]

From 3b260e209ec6111c1dc2520d14f65fd605fdc834 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 9 Feb 2024 12:44:52 -0800
Subject: [PATCH 115/182] fix: propagate base64 from workspace (#1085)

---
 ...4-fix-potential-base64-resolution-issue.md |  3 ++
 Cargo.toml                                    |  1 +
 ci/cw-check/Cargo.lock                        | 34 +++++++++----------
 ci/cw-check/Cargo.toml                        |  4 +--
 ibc-apps/ics721-nft-transfer/types/Cargo.toml |  2 +-
 ibc-clients/ics08-wasm/types/Cargo.toml       |  2 +-
 6 files changed, 25 insertions(+), 21 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md

diff --git a/.changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md b/.changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md
new file mode 100644
index 000000000..17ab5aca2
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md
@@ -0,0 +1,3 @@
+- [ibc] Resolve potential `base64` dependency resolution issue by bringing it to
+  the workspace `Cargo.toml`
+  ([\#1084](https://github.com/cosmos/ibc-rs/issues/1084))
diff --git a/Cargo.toml b/Cargo.toml
index f645467b6..c4590de59 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -50,6 +50,7 @@ authors      = ["Informal Systems <hello@informal.systems>"]
 
 [workspace.dependencies]
 # external dependencies
+base64              = { version = "0.21", default-features = false }
 borsh               = { version = "0.10", default-features = false }
 displaydoc          = { version = "0.2", default-features = false }
 derive_more         = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index b37e44bb4..98a8201e7 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -81,9 +81,9 @@ dependencies = [
 
 [[package]]
 name = "bnum"
-version = "0.8.1"
+version = "0.10.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ab9008b6bb9fc80b5277f2fe481c09e828743d9151203e804583eb4c9e15b31d"
+checksum = "56953345e39537a3e18bdaeba4cb0c58a78c1f61f361dc0fa7c5c7340ae87c5f"
 
 [[package]]
 name = "byte-slice-cast"
@@ -120,9 +120,9 @@ checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
 
 [[package]]
 name = "cosmwasm-crypto"
-version = "1.5.1"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ad24bc9dae9aac5dc124b4560e3f7678729d701f1bf3cb11140703d91f247d31"
+checksum = "9934c79e58d9676edfd592557dee765d2a6ef54c09d5aa2edb06156b00148966"
 dependencies = [
  "digest 0.10.7",
  "ecdsa",
@@ -134,18 +134,18 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-derive"
-version = "1.5.1"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca65635b768406eabdd28ba015cc3f2f863ca5a2677a7dc4c237b8ee1298efb3"
+checksum = "bc5e72e330bd3bdab11c52b5ecbdeb6a8697a004c57964caeb5d876f0b088b3c"
 dependencies = [
  "syn 1.0.109",
 ]
 
 [[package]]
 name = "cosmwasm-schema"
-version = "1.5.1"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77e2a6ce6dbcad572495fd9d9c1072793fe682aebfcc09752c3b0de3fa1814d7"
+checksum = "ac3e3a2136e2a60e8b6582f5dffca5d1a683ed77bf38537d330bc1dfccd69010"
 dependencies = [
  "cosmwasm-schema-derive",
  "schemars",
@@ -156,9 +156,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-schema-derive"
-version = "1.5.1"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "904408dc6d73fd1d535c764a55370803cccf6b9be5af7423c4db8967058673f0"
+checksum = "f5d803bea6bd9ed61bd1ee0b4a2eb09ee20dbb539cc6e0b8795614d20952ebb1"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -167,9 +167,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-std"
-version = "1.5.1"
+version = "1.5.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1ed4564772e5d779235f2d7353e3d66e37793065c3a5155a2978256bf4c5b7d5"
+checksum = "ef8666e572a3a2519010dde88c04d16e9339ae751b56b2bb35081fe3f7d6be74"
 dependencies = [
  "base64 0.21.6",
  "bech32",
@@ -181,7 +181,7 @@ dependencies = [
  "hex",
  "schemars",
  "serde",
- "serde-json-wasm 0.5.1",
+ "serde-json-wasm 0.5.2",
  "sha2 0.10.8",
  "static_assertions",
  "thiserror",
@@ -970,9 +970,9 @@ checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
 
 [[package]]
 name = "k256"
-version = "0.13.3"
+version = "0.13.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "956ff9b67e26e1a6a866cb758f12c6f8746208489e3e4a4b5580802f2f0a587b"
+checksum = "cadb76004ed8e97623117f3df85b17aaa6626ab0b0831e6573f104df16cd1bcc"
 dependencies = [
  "cfg-if",
  "ecdsa",
@@ -1287,9 +1287,9 @@ dependencies = [
 
 [[package]]
 name = "serde-json-wasm"
-version = "0.5.1"
+version = "0.5.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "16a62a1fad1e1828b24acac8f2b468971dade7b8c3c2e672bcadefefb1f8c137"
+checksum = "9e9213a07d53faa0b8dd81e767a54a8188a242fdb9be99ab75ec576a774bfdd7"
 dependencies = [
  "serde",
 ]
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 72b1313f9..5b24d0e3c 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -9,8 +9,8 @@ crate-type = ["cdylib", "rlib"]
 [dependencies]
 ibc-apps = { path = "../../ibc-apps", default_features = false, features = ["serde", "parity-scale-codec"] }
 ibc-core = { path = "../../ibc-core", features = ["serde", "parity-scale-codec", "schema"] }
-cosmwasm-std = { version = "^1.5.0", default-features = false }
-cosmwasm-schema = { version = "^1.5.0", default-features = false }
+cosmwasm-std = { version = "^1.5.3", default-features = false }
+cosmwasm-schema = { version = "^1.5.3", default-features = false }
 serde_json =  { package = "serde-json-wasm", version = "^1.0.1", default-features = false }
 thiserror = { version = "^1.0", default-features = false }
 
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
index beda003a3..9deb1a361 100644
--- a/ibc-apps/ics721-nft-transfer/types/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -20,7 +20,7 @@ all-features = true
 [dependencies]
 # external dependencies
 borsh           = { workspace = true, optional = true }
-base64          = { version = "0.21.6", default-features = false }
+base64          = { workspace = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
 http            = "1.0.0"
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index b920c4cba..3fbf0cb68 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -16,7 +16,7 @@ description  = """
 
 [dependencies]
 # external dependencies
-base64          = { version = "0.21", default-features = false, features = ["alloc"] }
+base64          = { workspace = true , features = ["alloc"] }
 displaydoc      = { workspace = true }
 serde           = { workspace = true , optional = true }
 cosmwasm-schema = { version = "1.4.1", default-features = false, optional = true }

From b9592792341f5371f901e110d860c5505c4e105a Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 15 Feb 2024 07:42:56 -0800
Subject: [PATCH 116/182] feat: implement convenient path methods + add
 iteration key (#1091)

* feat: implement convenient path methods + add iterateConsensusState key

* imp: just keeping iteration key func

* nitpicking
---
 .../1090-add-iterate-consensus-states-key.md  |   3 +
 .../1089-implement-convenient-path-methods.md |   3 +
 .../ics07-tendermint/src/client_state.rs      |   8 +-
 .../src/handler/conn_open_ack.rs              |   2 +-
 .../src/handler/conn_open_init.rs             |   2 +-
 .../src/handler/conn_open_try.rs              |   4 +-
 ibc-core/ics24-host/types/src/path.rs         | 276 ++++++++++++++----
 ibc-query/src/core/channel/query.rs           |   2 +-
 ibc-query/src/core/client/query.rs            |   2 +-
 ibc-query/src/core/connection/query.rs        |   4 +-
 .../testapp/ibc/clients/mock/client_state.rs  |  17 +-
 11 files changed, 258 insertions(+), 65 deletions(-)
 create mode 100644 .changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md
 create mode 100644 .changelog/unreleased/improvements/1089-implement-convenient-path-methods.md

diff --git a/.changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md b/.changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md
new file mode 100644
index 000000000..9fef7afd9
--- /dev/null
+++ b/.changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md
@@ -0,0 +1,3 @@
+- [ibc-core-host] Add iteration key for cross-compatibility with `ibc-go` used
+  for iterating over consensus states
+  ([\#1090](https://github.com/cosmos/ibc-rs/issues/1090))
diff --git a/.changelog/unreleased/improvements/1089-implement-convenient-path-methods.md b/.changelog/unreleased/improvements/1089-implement-convenient-path-methods.md
new file mode 100644
index 000000000..b93a64caf
--- /dev/null
+++ b/.changelog/unreleased/improvements/1089-implement-convenient-path-methods.md
@@ -0,0 +1,3 @@
+- [ibc-core-host] Improve path segment access by exposing path prefixes and
+  implementing some convenient parent/leaf methods
+  ([\#1089](https://github.com/cosmos/ibc-rs/issues/1089))
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 3c2c2ab5f..6bc90e506 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -328,7 +328,7 @@ where
 
         let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
 
-        ctx.store_client_state(ClientStatePath::new(client_id), self.clone().into())?;
+        ctx.store_client_state(ClientStatePath::new(client_id.clone()), self.clone().into())?;
         ctx.store_consensus_state(
             ClientConsensusStatePath::new(
                 client_id.clone(),
@@ -389,7 +389,7 @@ where
                 TmConsensusState::from(new_consensus_state).into(),
             )?;
             ctx.store_client_state(
-                ClientStatePath::new(client_id),
+                ClientStatePath::new(client_id.clone()),
                 ClientState::from(new_client_state).into(),
             )?;
             ctx.store_update_meta(
@@ -419,7 +419,7 @@ where
         let wrapped_frozen_client_state = ClientState::from(frozen_client_state);
 
         ctx.store_client_state(
-            ClientStatePath::new(client_id),
+            ClientStatePath::new(client_id.clone()),
             wrapped_frozen_client_state.into(),
         )?;
 
@@ -480,7 +480,7 @@ where
         let host_height = CommonContext::host_height(ctx)?;
 
         ctx.store_client_state(
-            ClientStatePath::new(client_id),
+            ClientStatePath::new(client_id.clone()),
             ClientState::from(new_client_state).into(),
         )?;
         ctx.store_consensus_state(
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index 865bd78ff..82b447201 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -100,7 +100,7 @@ where
                 prefix_on_b,
                 &msg.proof_client_state_of_a_on_b,
                 consensus_state_of_b_on_a.root(),
-                Path::ClientState(ClientStatePath::new(vars.client_id_on_b())),
+                Path::ClientState(ClientStatePath::new(vars.client_id_on_b().clone())),
                 msg.client_state_of_a_on_b.to_vec(),
             )
             .map_err(|e| ConnectionError::ClientStateVerificationFailure {
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_init.rs b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
index 2f4a4506d..090d1b8b3 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_init.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
@@ -74,7 +74,7 @@ where
 
     ctx_a.increase_connection_counter()?;
     ctx_a.store_connection_to_client(
-        &ClientConnectionPath::new(&msg.client_id_on_a),
+        &ClientConnectionPath::new(msg.client_id_on_a),
         conn_id_on_a.clone(),
     )?;
     ctx_a.store_connection(&ConnectionPath::new(&conn_id_on_a), conn_end_on_a)?;
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index 8ddd3c274..f19299818 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -95,7 +95,7 @@ where
                 prefix_on_a,
                 &msg.proof_client_state_of_b_on_a,
                 consensus_state_of_a_on_b.root(),
-                Path::ClientState(ClientStatePath::new(client_id_on_a)),
+                Path::ClientState(ClientStatePath::new(client_id_on_a.clone())),
                 msg.client_state_of_b_on_a.to_vec(),
             )
             .map_err(|e| ConnectionError::ClientStateVerificationFailure {
@@ -162,7 +162,7 @@ where
 
     ctx_b.increase_connection_counter()?;
     ctx_b.store_connection_to_client(
-        &ClientConnectionPath::new(&msg.client_id_on_b),
+        &ClientConnectionPath::new(msg.client_id_on_b),
         vars.conn_id_on_b.clone(),
     )?;
     ctx_b.store_connection(&ConnectionPath::new(&vars.conn_id_on_b), vars.conn_end_on_b)?;
diff --git a/ibc-core/ics24-host/types/src/path.rs b/ibc-core/ics24-host/types/src/path.rs
index ac31922b3..16b23a5ac 100644
--- a/ibc-core/ics24-host/types/src/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -11,13 +11,36 @@ use ibc_primitives::prelude::*;
 
 use crate::identifiers::{ChannelId, ClientId, ConnectionId, PortId, Sequence};
 
+pub const NEXT_CLIENT_SEQUENCE: &str = "nextClientSequence";
+pub const NEXT_CONNECTION_SEQUENCE: &str = "nextConnectionSequence";
+pub const NEXT_CHANNEL_SEQUENCE: &str = "nextChannelSequence";
+
+pub const CLIENT_PREFIX: &str = "clients";
+pub const CLIENT_STATE: &str = "clientState";
+pub const CONSENSUS_STATE_PREFIX: &str = "consensusStates";
+pub const CONNECTION_PREFIX: &str = "connections";
+pub const CHANNEL_PREFIX: &str = "channels";
+pub const CHANNEL_END_PREFIX: &str = "channelEnds";
+pub const PORT_PREFIX: &str = "ports";
+pub const SEQUENCE_PREFIX: &str = "sequences";
+pub const NEXT_SEQ_SEND_PREFIX: &str = "nextSequenceSend";
+pub const NEXT_SEQ_RECV_PREFIX: &str = "nextSequenceRecv";
+pub const NEXT_SEQ_ACK_PREFIX: &str = "nextSequenceAck";
+pub const PACKET_COMMITMENT_PREFIX: &str = "commitments";
+pub const PACKET_ACK_PREFIX: &str = "acks";
+pub const PACKET_RECEIPT_PREFIX: &str = "receipts";
+
+pub const ITERATE_CONSENSUS_STATE_PREFIX: &str = "iterateConsensusStates";
+pub const PROCESSED_TIME: &str = "processedTime";
+pub const PROCESSED_HEIGHT: &str = "processedHeight";
+
 /// ABCI client upgrade keys
 /// - The key identifying the upgraded IBC state within the upgrade sub-store
-const UPGRADED_IBC_STATE: &str = "upgradedIBCState";
-///- The key identifying the upgraded client state
-const UPGRADED_CLIENT_STATE: &str = "upgradedClient";
+pub const UPGRADED_IBC_STATE: &str = "upgradedIBCState";
+/// - The key identifying the upgraded client state
+pub const UPGRADED_CLIENT_STATE: &str = "upgradedClient";
 /// - The key identifying the upgraded consensus state
-const UPGRADED_CLIENT_CONSENSUS_STATE: &str = "upgradedConsState";
+pub const UPGRADED_CLIENT_CONSENSUS_STATE: &str = "upgradedConsState";
 
 /// The Path enum abstracts out the different sub-paths.
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, From, Display)]
@@ -56,7 +79,7 @@ pub enum Path {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextClientSequence")]
+#[display(fmt = "{NEXT_CLIENT_SEQUENCE}")]
 pub struct NextClientSequencePath;
 
 #[cfg_attr(
@@ -73,7 +96,7 @@ pub struct NextClientSequencePath;
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextConnectionSequence")]
+#[display(fmt = "{NEXT_CONNECTION_SEQUENCE}")]
 pub struct NextConnectionSequencePath;
 
 #[cfg_attr(
@@ -90,7 +113,7 @@ pub struct NextConnectionSequencePath;
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextChannelSequence")]
+#[display(fmt = "{NEXT_CHANNEL_SEQUENCE}")]
 pub struct NextChannelSequencePath;
 
 #[cfg_attr(
@@ -106,13 +129,25 @@ pub struct NextChannelSequencePath;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "clients/{_0}/clientState")]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display, From)]
+#[display(fmt = "{CLIENT_PREFIX}/{_0}/{CLIENT_STATE}")]
 pub struct ClientStatePath(pub ClientId);
 
 impl ClientStatePath {
-    pub fn new(client_id: &ClientId) -> ClientStatePath {
-        ClientStatePath(client_id.clone())
+    pub fn new(client_id: ClientId) -> ClientStatePath {
+        ClientStatePath(client_id)
+    }
+
+    /// Returns the client store prefix under which all the client states are
+    /// stored: "clients".
+    pub fn prefix() -> String {
+        CLIENT_PREFIX.to_string()
+    }
+
+    /// Returns the final part (leaf) of the path under which an individual
+    /// client state is stored: "clientState".
+    pub fn leaf() -> String {
+        CLIENT_STATE.to_string()
     }
 }
 
@@ -130,14 +165,23 @@ impl ClientStatePath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}")]
+#[display(
+    fmt = "{CLIENT_PREFIX}/{client_id}/{CONSENSUS_STATE_PREFIX}/{revision_number}-{revision_height}"
+)]
 pub struct ClientConsensusStatePath {
     pub client_id: ClientId,
     pub revision_number: u64,
     pub revision_height: u64,
 }
 
+// Returns the full consensus state path of specific client in the format:
+// "clients/{client_id}/consensusStates" as a string.
+pub fn full_consensus_state_path(client_id: &ClientId) -> String {
+    format!("{CLIENT_PREFIX}/{client_id}/{CONSENSUS_STATE_PREFIX}")
+}
+
 impl ClientConsensusStatePath {
+    /// Constructs a new `ClientConsensusStatePath`.
     pub fn new(
         client_id: ClientId,
         revision_number: u64,
@@ -149,6 +193,22 @@ impl ClientConsensusStatePath {
             revision_height,
         }
     }
+
+    /// Returns the path representing the parent group under which all consensus
+    /// states are stored: "clients/{client_id}/consensusStates".
+    pub fn parent(&self) -> String {
+        full_consensus_state_path(&self.client_id)
+    }
+
+    /// Returns the final part (leaf) of the path under which an individual
+    /// consensus state is stored:
+    /// "consensusStates/{revision_number}-{revision_height}".
+    pub fn leaf(&self) -> String {
+        format!(
+            "{CONSENSUS_STATE_PREFIX}/{}-{}",
+            self.revision_number, self.revision_height
+        )
+    }
 }
 
 #[cfg_attr(
@@ -166,7 +226,7 @@ impl ClientConsensusStatePath {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
 #[display(
-    fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}/processedTime"
+    fmt = "{CLIENT_PREFIX}/{client_id}/{CONSENSUS_STATE_PREFIX}/{revision_number}-{revision_height}/{PROCESSED_TIME}"
 )]
 pub struct ClientUpdateTimePath {
     pub client_id: ClientId,
@@ -175,6 +235,7 @@ pub struct ClientUpdateTimePath {
 }
 
 impl ClientUpdateTimePath {
+    /// Constructs a new `ClientUpdateTimePath`.
     pub fn new(client_id: ClientId, revision_number: u64, revision_height: u64) -> Self {
         Self {
             client_id,
@@ -182,6 +243,22 @@ impl ClientUpdateTimePath {
             revision_height,
         }
     }
+
+    /// Returns the path representing the parent group under which all the
+    /// processed times are stored: "clients/{client_id}/consensusStates".
+    pub fn parent(&self) -> String {
+        full_consensus_state_path(&self.client_id)
+    }
+
+    /// Returns the final part (leaf) of the path under which an individual
+    /// processed time is stored:
+    /// "consensusStates/{revision_number}-{revision_height}/processedTime".
+    pub fn leaf(&self) -> String {
+        format!(
+            "{CONSENSUS_STATE_PREFIX}/{}-{}/{PROCESSED_TIME}",
+            self.revision_number, self.revision_height
+        )
+    }
 }
 
 #[cfg_attr(
@@ -199,7 +276,7 @@ impl ClientUpdateTimePath {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
 #[display(
-    fmt = "clients/{client_id}/consensusStates/{revision_number}-{revision_height}/processedHeight"
+    fmt = "{CLIENT_PREFIX}/{client_id}/{CONSENSUS_STATE_PREFIX}/{revision_number}-{revision_height}/{PROCESSED_HEIGHT}"
 )]
 pub struct ClientUpdateHeightPath {
     pub client_id: ClientId,
@@ -215,6 +292,43 @@ impl ClientUpdateHeightPath {
             revision_height,
         }
     }
+
+    /// Returns the path representing the parent group under which all the
+    /// processed heights are stored: "clients/{client_id}/consensusStates".
+    pub fn parent(&self) -> String {
+        full_consensus_state_path(&self.client_id)
+    }
+
+    /// Returns the final part (leaf) of the path under which an individual
+    /// processed height is stored:
+    /// "consensusStates/{revision_number}-{revision_height}/processedHeight".
+    pub fn leaf(&self) -> String {
+        format!(
+            "{CONSENSUS_STATE_PREFIX}/{}-{}/{PROCESSED_HEIGHT}",
+            self.revision_number, self.revision_height
+        )
+    }
+}
+
+/// This iteration key is namely used by the `ibc-go` implementation as an
+/// efficient approach for iterating over consensus states. This is specifically
+/// incorporated to facilitate cross-compatibility with `ibc-go` when developing
+/// CosmWasm-driven light clients with `ibc-rs`.
+///
+/// The key is formatted like so:
+/// `iterateConsensusStates{BigEndianRevisionBytes}{BigEndianHeightBytes}`
+/// to ensure that the lexicographic order of iteration keys match the
+/// height order of the consensus states.
+///
+/// See `ibc-go`
+/// [documentation](https://github.com/cosmos/ibc-go/blob/016a6095b577ecb9323edad508cff19d017636a1/modules/light-clients/07-tendermint/store.go#L19-L34)
+/// for more details.
+pub fn iteration_key(revision_number: u64, revision_height: u64) -> Vec<u8> {
+    let mut path = Vec::new();
+    path.extend_from_slice(ITERATE_CONSENSUS_STATE_PREFIX.as_bytes());
+    path.extend(revision_number.to_be_bytes());
+    path.extend(revision_height.to_be_bytes());
+    path
 }
 
 #[cfg_attr(
@@ -231,12 +345,12 @@ impl ClientUpdateHeightPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "clients/{_0}/connections")]
+#[display(fmt = "{CLIENT_PREFIX}/{_0}/{CONNECTION_PREFIX}")]
 pub struct ClientConnectionPath(pub ClientId);
 
 impl ClientConnectionPath {
-    pub fn new(client_id: &ClientId) -> ClientConnectionPath {
-        ClientConnectionPath(client_id.clone())
+    pub fn new(client_id: ClientId) -> ClientConnectionPath {
+        ClientConnectionPath(client_id)
     }
 }
 
@@ -254,13 +368,19 @@ impl ClientConnectionPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "connections/{_0}")]
+#[display(fmt = "{CONNECTION_PREFIX}/{_0}")]
 pub struct ConnectionPath(pub ConnectionId);
 
 impl ConnectionPath {
     pub fn new(connection_id: &ConnectionId) -> ConnectionPath {
         ConnectionPath(connection_id.clone())
     }
+
+    /// Returns the connection store prefix under which all the connections are
+    /// stored: "connections".
+    pub fn prefix() -> String {
+        CONNECTION_PREFIX.to_string()
+    }
 }
 
 #[cfg_attr(
@@ -277,7 +397,7 @@ impl ConnectionPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "ports/{_0}")]
+#[display(fmt = "{PORT_PREFIX}/{_0}")]
 pub struct PortPath(pub PortId);
 
 #[cfg_attr(
@@ -294,13 +414,47 @@ pub struct PortPath(pub PortId);
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "channelEnds/ports/{_0}/channels/{_1}")]
+#[display(fmt = "{CHANNEL_END_PREFIX}/{PORT_PREFIX}/{_0}/{CHANNEL_PREFIX}/{_1}")]
 pub struct ChannelEndPath(pub PortId, pub ChannelId);
 
 impl ChannelEndPath {
     pub fn new(port_id: &PortId, channel_id: &ChannelId) -> ChannelEndPath {
         ChannelEndPath(port_id.clone(), channel_id.clone())
     }
+
+    /// Returns the channel end store prefix under which all the channel ends
+    /// are stored: "channelEnds".
+    pub fn prefix() -> String {
+        CHANNEL_END_PREFIX.to_string()
+    }
+
+    /// Returns the parent group path under which all the sequences of a channel are
+    /// stored with the format:
+    /// "{prefix}/ports/{port_id}/channels/{channel_id}/sequences"
+    fn full_sequences_path(&self, prefix: &str) -> String {
+        format!(
+            "{prefix}/{PORT_PREFIX}/{}/{CHANNEL_PREFIX}/{}/{SEQUENCE_PREFIX}",
+            self.0, self.1,
+        )
+    }
+
+    /// Returns the parent group path under which all the commitment packets of
+    /// a channel are stored.
+    pub fn commitments_path(&self) -> String {
+        self.full_sequences_path(PACKET_COMMITMENT_PREFIX)
+    }
+
+    /// Returns the parent group path under which all the ack packets of a
+    /// channel are stored.
+    pub fn acks_path(&self) -> String {
+        self.full_sequences_path(PACKET_ACK_PREFIX)
+    }
+
+    /// Returns the parent group path under which all the receipt packets of a
+    /// channel are stored.
+    pub fn receipts_path(&self) -> String {
+        self.full_sequences_path(PACKET_RECEIPT_PREFIX)
+    }
 }
 
 #[cfg_attr(
@@ -317,7 +471,7 @@ impl ChannelEndPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextSequenceSend/ports/{_0}/channels/{_1}")]
+#[display(fmt = "{NEXT_SEQ_SEND_PREFIX}/{PORT_PREFIX}/{_0}/{CHANNEL_PREFIX}/{_1}")]
 pub struct SeqSendPath(pub PortId, pub ChannelId);
 
 impl SeqSendPath {
@@ -340,7 +494,7 @@ impl SeqSendPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextSequenceRecv/ports/{_0}/channels/{_1}")]
+#[display(fmt = "{NEXT_SEQ_RECV_PREFIX}/{PORT_PREFIX}/{_0}/{CHANNEL_PREFIX}/{_1}")]
 pub struct SeqRecvPath(pub PortId, pub ChannelId);
 
 impl SeqRecvPath {
@@ -363,7 +517,7 @@ impl SeqRecvPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "nextSequenceAck/ports/{_0}/channels/{_1}")]
+#[display(fmt = "{NEXT_SEQ_ACK_PREFIX}/{PORT_PREFIX}/{_0}/{CHANNEL_PREFIX}/{_1}")]
 pub struct SeqAckPath(pub PortId, pub ChannelId);
 
 impl SeqAckPath {
@@ -386,7 +540,9 @@ impl SeqAckPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "commitments/ports/{port_id}/channels/{channel_id}/sequences/{sequence}")]
+#[display(
+    fmt = "{PACKET_COMMITMENT_PREFIX}/{PORT_PREFIX}/{port_id}/{CHANNEL_PREFIX}/{channel_id}/{SEQUENCE_PREFIX}/{sequence}"
+)]
 pub struct CommitmentPath {
     pub port_id: PortId,
     pub channel_id: ChannelId,
@@ -401,6 +557,12 @@ impl CommitmentPath {
             sequence,
         }
     }
+
+    /// Returns the commitment store prefix under which all the packet
+    /// commitments are stored: "commitments"
+    pub fn prefix() -> String {
+        PACKET_COMMITMENT_PREFIX.to_string()
+    }
 }
 
 #[cfg_attr(
@@ -417,7 +579,9 @@ impl CommitmentPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "acks/ports/{port_id}/channels/{channel_id}/sequences/{sequence}")]
+#[display(
+    fmt = "{PACKET_ACK_PREFIX}/{PORT_PREFIX}/{port_id}/{CHANNEL_PREFIX}/{channel_id}/{SEQUENCE_PREFIX}/{sequence}"
+)]
 pub struct AckPath {
     pub port_id: PortId,
     pub channel_id: ChannelId,
@@ -432,6 +596,12 @@ impl AckPath {
             sequence,
         }
     }
+
+    /// Returns the ack store prefix under which all the packet acks are stored:
+    /// "acks"
+    pub fn prefix() -> String {
+        PACKET_ACK_PREFIX.to_string()
+    }
 }
 
 #[cfg_attr(
@@ -448,7 +618,9 @@ impl AckPath {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash, Display)]
-#[display(fmt = "receipts/ports/{port_id}/channels/{channel_id}/sequences/{sequence}")]
+#[display(
+    fmt = "{PACKET_RECEIPT_PREFIX}/{PORT_PREFIX}/{port_id}/{CHANNEL_PREFIX}/{channel_id}/{SEQUENCE_PREFIX}/{sequence}"
+)]
 pub struct ReceiptPath {
     pub port_id: PortId,
     pub channel_id: ChannelId,
@@ -463,6 +635,12 @@ impl ReceiptPath {
             sequence,
         }
     }
+
+    /// Returns the receipt store prefix under which all the packet receipts are
+    /// stored: "receipts"
+    pub fn prefix() -> String {
+        PACKET_RECEIPT_PREFIX.to_string()
+    }
 }
 
 #[cfg_attr(
@@ -558,9 +736,9 @@ fn parse_next_sequence(components: &[&str]) -> Option<Path> {
     }
 
     match *components.first()? {
-        "nextClientSequence" => Some(NextClientSequencePath.into()),
-        "nextConnectionSequence" => Some(NextConnectionSequencePath.into()),
-        "nextChannelSequence" => Some(NextChannelSequencePath.into()),
+        NEXT_CLIENT_SEQUENCE => Some(NextClientSequencePath.into()),
+        NEXT_CONNECTION_SEQUENCE => Some(NextConnectionSequencePath.into()),
+        NEXT_CHANNEL_SEQUENCE => Some(NextChannelSequencePath.into()),
         _ => None,
     }
 }
@@ -571,7 +749,7 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "clients" {
+    if first != CLIENT_PREFIX {
         return None;
     }
 
@@ -582,13 +760,13 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
 
     if components.len() == 3 {
         match components[2] {
-            "clientState" => Some(ClientStatePath(client_id).into()),
-            "connections" => Some(ClientConnectionPath(client_id).into()),
+            CLIENT_STATE => Some(ClientStatePath(client_id).into()),
+            CONNECTION_PREFIX => Some(ClientConnectionPath(client_id).into()),
             _ => None,
         }
     } else if components.len() == 4 || components.len() == 5 {
         match components[2] {
-            "consensusStates" => {}
+            CONSENSUS_STATE_PREFIX => {}
             _ => return None,
         }
 
@@ -621,7 +799,7 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
                 .into(),
             ),
             5 => match components[4] {
-                "processedTime" => Some(
+                PROCESSED_TIME => Some(
                     ClientUpdateTimePath {
                         client_id,
                         revision_number,
@@ -629,7 +807,7 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
                     }
                     .into(),
                 ),
-                "processedHeight" => Some(
+                PROCESSED_HEIGHT => Some(
                     ClientUpdateHeightPath {
                         client_id,
                         revision_number,
@@ -656,7 +834,7 @@ fn parse_connections(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "connections" {
+    if first != CONNECTION_PREFIX {
         return None;
     }
 
@@ -683,7 +861,7 @@ fn parse_ports(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "ports" {
+    if first != PORT_PREFIX {
         return None;
     }
 
@@ -710,7 +888,7 @@ fn parse_channels(components: &[&str]) -> Option<SubPath> {
         None => return None,
     };
 
-    if first != "channels" {
+    if first != CHANNEL_PREFIX {
         return None;
     }
 
@@ -737,7 +915,7 @@ fn parse_sequences(components: &[&str]) -> Option<SubPath> {
         None => return None,
     };
 
-    if first != "sequences" {
+    if first != SEQUENCE_PREFIX {
         return None;
     }
 
@@ -762,7 +940,7 @@ fn parse_channel_ends(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "channelEnds" {
+    if first != CHANNEL_END_PREFIX {
         return None;
     }
 
@@ -810,9 +988,9 @@ fn parse_seqs(components: &[&str]) -> Option<Path> {
     };
 
     match first {
-        "nextSequenceSend" => Some(SeqSendPath(port_id, channel_id).into()),
-        "nextSequenceRecv" => Some(SeqRecvPath(port_id, channel_id).into()),
-        "nextSequenceAck" => Some(SeqAckPath(port_id, channel_id).into()),
+        NEXT_SEQ_SEND_PREFIX => Some(SeqSendPath(port_id, channel_id).into()),
+        NEXT_SEQ_RECV_PREFIX => Some(SeqRecvPath(port_id, channel_id).into()),
+        NEXT_SEQ_ACK_PREFIX => Some(SeqAckPath(port_id, channel_id).into()),
         _ => None,
     }
 }
@@ -827,7 +1005,7 @@ fn parse_commitments(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "commitments" {
+    if first != PACKET_COMMITMENT_PREFIX {
         return None;
     }
 
@@ -873,7 +1051,7 @@ fn parse_acks(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "acks" {
+    if first != PACKET_ACK_PREFIX {
         return None;
     }
 
@@ -919,7 +1097,7 @@ fn parse_receipts(components: &[&str]) -> Option<Path> {
         None => return None,
     };
 
-    if first != "receipts" {
+    if first != PACKET_RECEIPT_PREFIX {
         return None;
     }
 
@@ -995,13 +1173,13 @@ mod tests {
     use super::*;
 
     #[rstest::rstest]
-    #[case("nextClientSequence", Path::NextClientSequence(NextClientSequencePath))]
+    #[case(NEXT_CLIENT_SEQUENCE, Path::NextClientSequence(NextClientSequencePath))]
     #[case(
-        "nextConnectionSequence",
+        NEXT_CONNECTION_SEQUENCE,
         Path::NextConnectionSequence(NextConnectionSequencePath)
     )]
     #[case(
-        "nextChannelSequence",
+        NEXT_CHANNEL_SEQUENCE,
         Path::NextChannelSequence(NextChannelSequencePath)
     )]
     #[case(
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index d14a5621c..56d9bb5be 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -146,7 +146,7 @@ where
     let proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+            &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
         .ok_or(QueryError::ProofNotFound {
             description: format!(
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index 93383b6b7..5162c5de3 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -44,7 +44,7 @@ where
     let proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientState(ClientStatePath::new(&client_id)),
+            &Path::ClientState(ClientStatePath::new(client_id.clone())),
         )
         .ok_or(QueryError::ProofNotFound {
             description: format!("Proof not found for client state path: {client_id:?}"),
diff --git a/ibc-query/src/core/connection/query.rs b/ibc-query/src/core/connection/query.rs
index e7eafc92f..c75bd36b6 100644
--- a/ibc-query/src/core/connection/query.rs
+++ b/ibc-query/src/core/connection/query.rs
@@ -89,7 +89,7 @@ where
     let proof: Vec<u8> = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientConnection(ClientConnectionPath::new(&client_id)),
+            &Path::ClientConnection(ClientConnectionPath::new(client_id.clone())),
         )
         .ok_or(QueryError::ProofNotFound {
             description: format!("Proof not found for client connection path: {client_id:?}"),
@@ -122,7 +122,7 @@ where
     let proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientState(ClientStatePath::new(connection_end.client_id())),
+            &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
         .ok_or(QueryError::ProofNotFound {
             description: format!(
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 0c1ea1a8b..ab1cf2d73 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -309,7 +309,7 @@ where
     ) -> Result<(), ClientError> {
         let mock_consensus_state = MockConsensusState::try_from(consensus_state)?;
 
-        ctx.store_client_state(ClientStatePath::new(client_id), (*self).into())?;
+        ctx.store_client_state(ClientStatePath::new(client_id.clone()), (*self).into())?;
         ctx.store_consensus_state(
             ClientConsensusStatePath::new(
                 client_id.clone(),
@@ -342,7 +342,10 @@ where
             ),
             new_consensus_state.into(),
         )?;
-        ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
+        ctx.store_client_state(
+            ClientStatePath::new(client_id.clone()),
+            new_client_state.into(),
+        )?;
         ctx.store_update_meta(
             client_id.clone(),
             header_height,
@@ -361,7 +364,10 @@ where
     ) -> Result<(), ClientError> {
         let frozen_client_state = self.with_frozen_height(Height::min(0));
 
-        ctx.store_client_state(ClientStatePath::new(client_id), frozen_client_state.into())?;
+        ctx.store_client_state(
+            ClientStatePath::new(client_id.clone()),
+            frozen_client_state.into(),
+        )?;
 
         Ok(())
     }
@@ -386,7 +392,10 @@ where
             ),
             new_consensus_state.into(),
         )?;
-        ctx.store_client_state(ClientStatePath::new(client_id), new_client_state.into())?;
+        ctx.store_client_state(
+            ClientStatePath::new(client_id.clone()),
+            new_client_state.into(),
+        )?;
 
         let host_timestamp = ctx.host_timestamp()?;
         let host_height = ctx.host_height()?;

From 4b6f7ace06370e2df4ef65917a38a1affc7001ee Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 15 Feb 2024 08:42:40 -0800
Subject: [PATCH 117/182] docs: add docstring for check_misbehaviour (#1092)

---
 .../ics07-tendermint/src/client_state.rs      | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 6bc90e506..70ad6055e 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -255,6 +255,31 @@ where
         }
     }
 
+    /// Namely the following cases are covered:
+    ///
+    /// 1 - fork:
+    /// Assumes at least one consensus state before the fork point exists. Let
+    /// existing consensus states on chain B be: [Sn,.., Sf, Sf-1, S0] with
+    /// `Sf-1` being the most recent state before fork. Chain A is queried for a
+    /// header `Hf'` at `Sf.height` and if it is different than the `Hf` in the
+    /// event for the client update (the one that has generated `Sf` on chain),
+    /// then the two headers are included in the evidence and submitted. Note
+    /// that in this case the headers are different but have the same height.
+    ///
+    /// 2 - BFT time violation for unavailable header (a.k.a. Future Lunatic
+    /// Attack or FLA):
+    /// Some header with a height that is higher than the latest height on A has
+    /// been accepted and a consensus state was created on B. Note that this
+    /// implies that the timestamp of this header must be within the
+    /// `clock_drift` of the client. Assume the client on B has been updated
+    /// with `h2`(not present on/ produced by chain A) and it has a timestamp of
+    /// `t2` that is at most `clock_drift` in the future. Then the latest header
+    /// from A is fetched, let it be `h1`, with a timestamp of `t1`. If `t1 >=
+    /// t2` then evidence of misbehavior is submitted to A.
+    ///
+    /// 3 - BFT time violation for existing headers:
+    /// Ensure that consensus state times are monotonically increasing with
+    /// height.
     fn check_for_misbehaviour(
         &self,
         ctx: &V,

From e78c372a71284a3311e0958e1f7a5eb3882fa728 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 20 Feb 2024 16:40:01 +0100
Subject: [PATCH 118/182] refactor: remove new nightly lints for
 `check-substrate` workflow job (#1096)

* rm new lints

* conditional ibc_primitives import

* cargo fmt
---
 ibc-apps/ics20-transfer/src/module.rs                      | 3 ---
 ibc-apps/ics20-transfer/types/src/packet.rs                | 1 -
 ibc-apps/ics721-nft-transfer/src/module.rs                 | 2 --
 ibc-apps/ics721-nft-transfer/types/src/packet.rs           | 2 --
 ibc-clients/ics07-tendermint/src/client_state.rs           | 1 -
 ibc-clients/ics07-tendermint/src/context.rs                | 2 --
 ibc-clients/ics07-tendermint/src/lib.rs                    | 2 --
 ibc-clients/ics07-tendermint/types/src/client_state.rs     | 3 ---
 ibc-clients/ics07-tendermint/types/src/header.rs           | 1 -
 ibc-clients/ics07-tendermint/types/src/lib.rs              | 2 --
 ibc-clients/ics07-tendermint/types/src/trust_threshold.rs  | 1 -
 ibc-clients/ics08-wasm/types/src/lib.rs                    | 2 ++
 ibc-core/ics02-client/context/src/client_state.rs          | 2 --
 ibc-core/ics02-client/context/src/consensus_state.rs       | 2 --
 ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs  | 1 -
 ibc-core/ics23-commitment/types/src/commitment.rs          | 1 -
 ibc-core/ics24-host/types/src/path.rs                      | 2 --
 ibc-core/ics25-handler/types/src/events.rs                 | 2 --
 ibc-primitives/src/utils/pretty.rs                         | 1 -
 ibc-query/src/core/channel/service.rs                      | 2 --
 ibc-query/src/core/client/service.rs                       | 2 --
 ibc-query/src/core/connection/service.rs                   | 2 --
 ibc-testkit/src/fixtures/core/channel/packet.rs            | 1 -
 ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs | 3 ---
 ibc-testkit/src/testapp/ibc/core/router/types.rs           | 1 -
 ibc-testkit/src/testapp/ibc/core/types.rs                  | 3 +--
 26 files changed, 3 insertions(+), 44 deletions(-)

diff --git a/ibc-apps/ics20-transfer/src/module.rs b/ibc-apps/ics20-transfer/src/module.rs
index c9b5d75b8..f1f7d3a61 100644
--- a/ibc-apps/ics20-transfer/src/module.rs
+++ b/ibc-apps/ics20-transfer/src/module.rs
@@ -321,9 +321,6 @@ pub fn on_timeout_packet_execute(
 
 #[cfg(test)]
 mod test {
-    use ibc_app_transfer_types::ack_success_b64;
-    use ibc_app_transfer_types::error::TokenTransferError;
-
     use super::*;
 
     #[test]
diff --git a/ibc-apps/ics20-transfer/types/src/packet.rs b/ibc-apps/ics20-transfer/types/src/packet.rs
index cc8babc23..a3615a090 100644
--- a/ibc-apps/ics20-transfer/types/src/packet.rs
+++ b/ibc-apps/ics20-transfer/types/src/packet.rs
@@ -1,6 +1,5 @@
 //! Contains the `PacketData` type that defines the structure of token transfers' packet bytes
 
-use core::convert::TryFrom;
 use core::str::FromStr;
 
 use ibc_core::primitives::prelude::*;
diff --git a/ibc-apps/ics721-nft-transfer/src/module.rs b/ibc-apps/ics721-nft-transfer/src/module.rs
index fc4097016..87fdfc637 100644
--- a/ibc-apps/ics721-nft-transfer/src/module.rs
+++ b/ibc-apps/ics721-nft-transfer/src/module.rs
@@ -321,8 +321,6 @@ pub fn on_timeout_packet_execute(
 #[cfg(test)]
 mod test {
     use super::*;
-    use crate::types::ack_success_b64;
-    use crate::types::error::NftTransferError;
 
     #[test]
     fn test_ack_ser() {
diff --git a/ibc-apps/ics721-nft-transfer/types/src/packet.rs b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
index efa8e6264..c2f9d2d2f 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/packet.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/packet.rs
@@ -1,7 +1,5 @@
 //! Contains the `PacketData` type that defines the structure of NFT transfers' packet bytes
 
-use core::convert::TryFrom;
-
 use base64::prelude::BASE64_STANDARD;
 use base64::Engine;
 use ibc_core::primitives::prelude::*;
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 70ad6055e..88b00d533 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -534,7 +534,6 @@ mod tests {
     use ibc_client_tendermint_types::{
         AllowUpdate, ClientState as ClientStateType, TrustThreshold,
     };
-    use ibc_core_client::types::Height;
     use ibc_core_commitment_types::specs::ProofSpecs;
     use ibc_core_host::types::identifiers::ChainId;
 
diff --git a/ibc-clients/ics07-tendermint/src/context.rs b/ibc-clients/ics07-tendermint/src/context.rs
index 2f2579fc6..1e190f5b6 100644
--- a/ibc-clients/ics07-tendermint/src/context.rs
+++ b/ibc-clients/ics07-tendermint/src/context.rs
@@ -1,5 +1,3 @@
-use alloc::string::ToString;
-
 use ibc_core_client::context::ClientExecutionContext;
 use ibc_core_client::types::Height;
 use ibc_core_handler_types::error::ContextError;
diff --git a/ibc-clients/ics07-tendermint/src/lib.rs b/ibc-clients/ics07-tendermint/src/lib.rs
index 7971d5976..422e1d387 100644
--- a/ibc-clients/ics07-tendermint/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/src/lib.rs
@@ -13,8 +13,6 @@
     rust_2018_idioms
 )]
 
-extern crate alloc;
-
 #[cfg(any(test, feature = "std"))]
 extern crate std;
 
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 05af81f58..e88495872 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -1,7 +1,6 @@
 //! Contains the implementation of the Tendermint `ClientState` domain type.
 
 use core::cmp::max;
-use core::convert::{TryFrom, TryInto};
 use core::str::FromStr;
 use core::time::Duration;
 
@@ -422,8 +421,6 @@ pub(crate) mod serde_tests {
 
 #[cfg(test)]
 mod tests {
-    use core::time::Duration;
-
     use ibc_core_commitment_types::proto::ics23::ProofSpec as Ics23ProofSpec;
 
     use super::*;
diff --git a/ibc-clients/ics07-tendermint/types/src/header.rs b/ibc-clients/ics07-tendermint/types/src/header.rs
index 4872f9419..494fd7d43 100644
--- a/ibc-clients/ics07-tendermint/types/src/header.rs
+++ b/ibc-clients/ics07-tendermint/types/src/header.rs
@@ -1,6 +1,5 @@
 //! Defines the domain type for tendermint headers
 
-use alloc::string::ToString;
 use core::fmt::{Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
diff --git a/ibc-clients/ics07-tendermint/types/src/lib.rs b/ibc-clients/ics07-tendermint/types/src/lib.rs
index aa0e021f6..0e9903462 100644
--- a/ibc-clients/ics07-tendermint/types/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/types/src/lib.rs
@@ -17,8 +17,6 @@ use core::str::FromStr;
 
 use ibc_core_host_types::identifiers::ClientType;
 
-extern crate alloc;
-
 #[cfg(any(test, feature = "std"))]
 extern crate std;
 
diff --git a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
index c601f3e25..9ca77a660 100644
--- a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
+++ b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
@@ -2,7 +2,6 @@
 //! represented as a fraction with valid values in the
 //! range `[0, 1)`.
 
-use core::convert::TryFrom;
 use core::fmt::{Display, Error as FmtError, Formatter};
 
 use ibc_core_client_types::error::ClientError;
diff --git a/ibc-clients/ics08-wasm/types/src/lib.rs b/ibc-clients/ics08-wasm/types/src/lib.rs
index 0ef9eda55..98bd27915 100644
--- a/ibc-clients/ics08-wasm/types/src/lib.rs
+++ b/ibc-clients/ics08-wasm/types/src/lib.rs
@@ -24,7 +24,9 @@ pub mod serializer;
 use core::str::FromStr;
 
 use ibc_core_host_types::identifiers::ClientType;
+#[cfg(not(feature = "std"))]
 use ibc_primitives::prelude::Vec;
+
 pub type Bytes = Vec<u8>;
 
 /// Re-exports ICS-08 Wasm light client proto types from `ibc-proto` crate.
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index 7d6edea96..0616d0bd4 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -1,7 +1,5 @@
 //! Defines `ClientState`, the core type to be implemented by light clients
 
-use core::marker::{Send, Sync};
-
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::{Height, Status};
 use ibc_core_commitment_types::commitment::{
diff --git a/ibc-core/ics02-client/context/src/consensus_state.rs b/ibc-core/ics02-client/context/src/consensus_state.rs
index 378eab512..195e19625 100644
--- a/ibc-core/ics02-client/context/src/consensus_state.rs
+++ b/ibc-core/ics02-client/context/src/consensus_state.rs
@@ -1,7 +1,5 @@
 //! Defines the trait to be implemented by all concrete consensus state types
 
-use core::marker::{Send, Sync};
-
 use ibc_core_commitment_types::commitment::CommitmentRoot;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
index 205926738..eb8bd4cef 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_try.rs
@@ -1,4 +1,3 @@
-use core::convert::{TryFrom, TryInto};
 use core::time::Duration;
 
 use ibc_core_client_types::Height;
diff --git a/ibc-core/ics23-commitment/types/src/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
index b24b60a88..e4ae8fcf0 100644
--- a/ibc-core/ics23-commitment/types/src/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -1,6 +1,5 @@
 //! Defines core commitment types
 
-use core::convert::TryFrom;
 use core::fmt;
 
 use ibc_primitives::prelude::*;
diff --git a/ibc-core/ics24-host/types/src/path.rs b/ibc-core/ics24-host/types/src/path.rs
index 16b23a5ac..c016f772b 100644
--- a/ibc-core/ics24-host/types/src/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -1168,8 +1168,6 @@ fn parse_upgrades(components: &[&str]) -> Option<Path> {
 
 #[cfg(test)]
 mod tests {
-    use core::str::FromStr;
-
     use super::*;
 
     #[rstest::rstest]
diff --git a/ibc-core/ics25-handler/types/src/events.rs b/ibc-core/ics25-handler/types/src/events.rs
index ab3c4b0c7..d6a72140b 100644
--- a/ibc-core/ics25-handler/types/src/events.rs
+++ b/ibc-core/ics25-handler/types/src/events.rs
@@ -1,7 +1,5 @@
 //! Defines events emitted during handling of IBC messages
 
-use core::convert::{TryFrom, TryInto};
-
 use displaydoc::Display;
 use ibc_core_channel_types::{error as channel_error, events as ChannelEvents};
 use ibc_core_client_types::error as client_error;
diff --git a/ibc-primitives/src/utils/pretty.rs b/ibc-primitives/src/utils/pretty.rs
index e250ee310..6f59efdbf 100644
--- a/ibc-primitives/src/utils/pretty.rs
+++ b/ibc-primitives/src/utils/pretty.rs
@@ -23,7 +23,6 @@ impl<'a, T: Display> Display for PrettySlice<'a, T> {
 #[cfg(test)]
 mod tests {
     use super::*;
-    use crate::alloc::string::ToString;
     use crate::prelude::*;
 
     #[test]
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 3279c1b2f..105f97988 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -2,8 +2,6 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use alloc::boxed::Box;
-
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
diff --git a/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
index 0aedd93a0..6b1c06afd 100644
--- a/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -2,8 +2,6 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use alloc::boxed::Box;
-
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext;
diff --git a/ibc-query/src/core/connection/service.rs b/ibc-query/src/core/connection/service.rs
index 04811b883..a01a3b004 100644
--- a/ibc-query/src/core/connection/service.rs
+++ b/ibc-query/src/core/connection/service.rs
@@ -2,8 +2,6 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use alloc::boxed::Box;
-
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
index caa094c5a..1161dae40 100644
--- a/ibc-testkit/src/fixtures/core/channel/packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -71,7 +71,6 @@ pub fn dummy_proof() -> Vec<u8> {
 mod tests {
     use ibc::core::channel::types::channel::Order;
     use ibc::core::channel::types::events::SendPacket;
-    use ibc::core::channel::types::packet::Packet;
     use ibc::core::handler::types::events::IbcEvent;
     use ibc::core::host::types::identifiers::ConnectionId;
 
diff --git a/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
index 29ac5e080..a011680a9 100644
--- a/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
+++ b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
@@ -39,9 +39,6 @@ pub fn dummy_raw_msg_upgrade_client() -> RawMsgUpgradeClient {
 
 #[cfg(test)]
 mod tests {
-
-    use ibc::core::client::types::msgs::MsgUpgradeClient;
-
     use super::*;
 
     #[test]
diff --git a/ibc-testkit/src/testapp/ibc/core/router/types.rs b/ibc-testkit/src/testapp/ibc/core/router/types.rs
index 5e5041d3d..00aff346f 100644
--- a/ibc-testkit/src/testapp/ibc/core/router/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/types.rs
@@ -1,4 +1,3 @@
-use alloc::collections::BTreeMap;
 use alloc::sync::Arc;
 
 use ibc::apps::transfer::types::MODULE_ID_STR;
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index 603d6d00d..ddd3ec96c 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -1,6 +1,5 @@
 //! Implementation of a global context mock. Used in testing handlers of all IBC modules.
 
-use alloc::collections::btree_map::BTreeMap;
 use alloc::sync::Arc;
 use core::cmp::min;
 use core::fmt::Debug;
@@ -1153,7 +1152,7 @@ mod tests {
             (module_id, result)
         };
 
-        let _results = vec![
+        let _results = [
             on_recv_packet_result("foomodule"),
             on_recv_packet_result("barmodule"),
         ];

From 49e66de834f557e99ddb0d5d86ec8c8c81ee5d8f Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 21 Feb 2024 02:23:32 -0800
Subject: [PATCH 119/182] misc: add makefile (#1071)

* chore: add makefile

* nit: types + use make check-features

* nit

* imp: add install-tools
---
 .github/workflows/no-std.yaml  |  2 +-
 .github/workflows/release.yaml |  4 ++--
 .github/workflows/rust.yml     |  2 +-
 ci/no-std-check/Makefile       |  6 ++---
 makefile                       | 40 ++++++++++++++++++++++++++++++++++
 5 files changed, 47 insertions(+), 7 deletions(-)
 create mode 100644 makefile

diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 9f35e1cd7..bec26c15b 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -39,7 +39,7 @@ jobs:
           override: true
       - run: |
           cd ci/no-std-check
-          make check-panic-conflict
+          make check-no-std
 
   check-substrate:
     name: Check no_std substrate support
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 92c149cca..44c057990 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -32,7 +32,7 @@ jobs:
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
       - name: Publish crates (dry run)
-        run: cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive
+        run: make check-release
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
 
@@ -48,7 +48,7 @@ jobs:
       - name: Cache cargo dependencies
         uses: Swatinem/rust-cache@v2
       - name: Publish crates
-        run: yes | cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
+        run: yes | make release
         env:
           CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
 
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 51613f22e..8d25e7716 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -61,7 +61,7 @@ jobs:
         uses: taiki-e/install-action@cargo-hack
       - uses: Swatinem/rust-cache@v2
       - name: Run cargo hack
-        run: cargo hack check --workspace --feature-powerset --exclude-features default
+        run: make check-features
 
   nightly_fmt:
     runs-on: ubuntu-latest
diff --git a/ci/no-std-check/Makefile b/ci/no-std-check/Makefile
index 8d4328dfc..48fc0dfa0 100644
--- a/ci/no-std-check/Makefile
+++ b/ci/no-std-check/Makefile
@@ -2,11 +2,11 @@ NIGHTLY_VERSION=nightly
 
 .DEFAULT_GOAL := help
 
-.PHONY: all setup build-substrate check-panic-conflict check-cargo-build-std check-wasm check-substrate help
+.PHONY: all setup build-substrate check-no-std check-cargo-build-std check-wasm check-substrate help
 
 all: ## Run the setup and all checks
 	$(MAKE) build-substrate
-	$(MAKE) check-panic-conflict
+	$(MAKE) check-no-std
 	$(MAKE) check-cargo-build-std
 	$(MAKE) check-wasm
 	$(MAKE) check-substrate
@@ -21,7 +21,7 @@ build-substrate: ## Build with Substrate support
 		--no-default-features \
 		--features use-substrate,substrate-std
 
-check-panic-conflict: ## Check for `no_std` compliance by installing a panic handler, and any other crate importing `std` will cause a conflict. Runs on default target.
+check-no-std: ## Check for `no_std` compliance by installing a panic handler, and any other crate importing `std` will cause a conflict. Runs on default target.
 	cargo build \
 		--no-default-features \
 		--features panic-handler
diff --git a/makefile b/makefile
new file mode 100644
index 000000000..1b3a36914
--- /dev/null
+++ b/makefile
@@ -0,0 +1,40 @@
+.PHONY: help
+
+help: ## Display help message.
+	@echo "Usage: make <target>"
+	@awk 'BEGIN {FS = ":.*?## "}/^[a-zA-Z_-]+:.*?## / {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
+
+install-tools: ## Install development tools including nightly rustfmt, cargo-hack and cargo-release.
+	rustup component add rustfmt --toolchain nightly
+	cargo install cargo-hack
+	cargo install cargo-release
+
+lint: ## Lint the code using rustfmt, clippy and whitespace lints.
+	cargo +nightly fmt --all --check
+	cargo clippy --all-targets --all-features
+	cargo clippy --all-targets --no-default-features
+	bash ./ci/code-quality/whitespace-lints.sh
+
+check-features: ## Check that project compiles with all combinations of features.
+	cargo hack check --workspace --feature-powerset --exclude-features default
+
+check-docs: ## Build documentation with all features and without default features.
+	cargo doc --all --all-features --release
+	cargo doc --all --no-default-features --release
+
+check-no-std: ## Check that libraries compile with `no_std` feature.
+	$(MAKE) -C ./ci/no-std-check $@
+
+check-cw: ## Check that the CosmWasm smart contract compiles.
+	cd ./ci/cw-check \
+	&& cargo build --target wasm32-unknown-unknown --no-default-features --release
+
+test: ## Run tests with all features and without default features.
+	cargo test --all-targets --all-features
+	cargo test --all-targets --no-default-features
+
+check-release: ## Check that the release build compiles.
+	cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive
+
+release: ## Perform an actual release and publishes to crates.io.
+	cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute

From e048e3400ce5b826b8c6e496fbc54b3a52a2a592 Mon Sep 17 00:00:00 2001
From: Tuan Tran <tuantran@notional.ventures>
Date: Wed, 21 Feb 2024 21:20:09 +0700
Subject: [PATCH 120/182] imp: remove order_matches from ChannelEnd impl
 (#1095)

* replace if-else branch to match statement, remove order_matches helper from ChannelEnd impl

* add unclog

* deprecate instead of delete the method

* update changelog

* Update .changelog/unreleased/improvements/394-remove-order-match.md

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* fix: return err on Order::None

* Update ibc-core/ics04-channel/src/handler/timeout.rs

additional blank line for consistency

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

---------

Signed-off-by: Tuan Tran <tuantran@notional.ventures>
Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
---
 .../improvements/394-remove-order-match.md    |  2 +
 .../ics04-channel/src/handler/recv_packet.rs  | 63 +++++++++--------
 ibc-core/ics04-channel/src/handler/timeout.rs | 68 +++++++++++--------
 .../src/handler/timeout_on_close.rs           | 67 ++++++++++--------
 ibc-core/ics04-channel/types/src/channel.rs   |  4 ++
 5 files changed, 120 insertions(+), 84 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/394-remove-order-match.md

diff --git a/.changelog/unreleased/improvements/394-remove-order-match.md b/.changelog/unreleased/improvements/394-remove-order-match.md
new file mode 100644
index 000000000..1997e6026
--- /dev/null
+++ b/.changelog/unreleased/improvements/394-remove-order-match.md
@@ -0,0 +1,2 @@
+- [ibc-core] Deprecate `ChannelEnd::order_matches` method
+  ([\#394](https://github.com/cosmos/ibc-rs/issues/394))
diff --git a/ibc-core/ics04-channel/src/handler/recv_packet.rs b/ibc-core/ics04-channel/src/handler/recv_packet.rs
index bd32a3258..9e42e269d 100644
--- a/ibc-core/ics04-channel/src/handler/recv_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/recv_packet.rs
@@ -224,40 +224,49 @@ where
             .map_err(PacketError::Channel)?;
     }
 
-    if chan_end_on_b.order_matches(&Order::Ordered) {
-        let seq_recv_path_on_b =
-            SeqRecvPath::new(&msg.packet.port_id_on_b, &msg.packet.chan_id_on_b);
-        let next_seq_recv = ctx_b.get_next_sequence_recv(&seq_recv_path_on_b)?;
-        if msg.packet.seq_on_a > next_seq_recv {
-            return Err(PacketError::InvalidPacketSequence {
-                given_sequence: msg.packet.seq_on_a,
-                next_sequence: next_seq_recv,
+    match chan_end_on_b.ordering {
+        Order::Ordered => {
+            let seq_recv_path_on_b =
+                SeqRecvPath::new(&msg.packet.port_id_on_b, &msg.packet.chan_id_on_b);
+            let next_seq_recv = ctx_b.get_next_sequence_recv(&seq_recv_path_on_b)?;
+            if msg.packet.seq_on_a > next_seq_recv {
+                return Err(PacketError::InvalidPacketSequence {
+                    given_sequence: msg.packet.seq_on_a,
+                    next_sequence: next_seq_recv,
+                }
+                .into());
             }
-            .into());
-        }
 
-        if msg.packet.seq_on_a == next_seq_recv {
+            if msg.packet.seq_on_a == next_seq_recv {
+                // Case where the recvPacket is successful and an
+                // acknowledgement will be written (not a no-op)
+                validate_write_acknowledgement(ctx_b, msg)?;
+            }
+        }
+        Order::Unordered => {
+            let receipt_path_on_b = ReceiptPath::new(
+                &msg.packet.port_id_on_a,
+                &msg.packet.chan_id_on_a,
+                msg.packet.seq_on_a,
+            );
+            let packet_rec = ctx_b.get_packet_receipt(&receipt_path_on_b);
+            match packet_rec {
+                Ok(_receipt) => {}
+                Err(ContextError::PacketError(PacketError::PacketReceiptNotFound { sequence }))
+                    if sequence == msg.packet.seq_on_a => {}
+                Err(e) => return Err(e),
+            }
             // Case where the recvPacket is successful and an
             // acknowledgement will be written (not a no-op)
             validate_write_acknowledgement(ctx_b, msg)?;
         }
-    } else {
-        let receipt_path_on_b = ReceiptPath::new(
-            &msg.packet.port_id_on_a,
-            &msg.packet.chan_id_on_a,
-            msg.packet.seq_on_a,
-        );
-        let packet_rec = ctx_b.get_packet_receipt(&receipt_path_on_b);
-        match packet_rec {
-            Ok(_receipt) => {}
-            Err(ContextError::PacketError(PacketError::PacketReceiptNotFound { sequence }))
-                if sequence == msg.packet.seq_on_a => {}
-            Err(e) => return Err(e),
+        Order::None => {
+            return Err(ContextError::ChannelError(ChannelError::InvalidOrderType {
+                expected: "Channel ordering cannot be None".to_string(),
+                actual: chan_end_on_b.ordering.to_string(),
+            }))
         }
-        // Case where the recvPacket is successful and an
-        // acknowledgement will be written (not a no-op)
-        validate_write_acknowledgement(ctx_b, msg)?;
-    };
+    }
 
     Ok(())
 }
diff --git a/ibc-core/ics04-channel/src/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
index adef59bfb..bff8be649 100644
--- a/ibc-core/ics04-channel/src/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -215,38 +215,48 @@ where
 
         verify_conn_delay_passed(ctx_a, msg.proof_height_on_b, &conn_end_on_a)?;
 
-        let next_seq_recv_verification_result = if chan_end_on_a.order_matches(&Order::Ordered) {
-            if msg.packet.seq_on_a < msg.next_seq_recv_on_b {
-                return Err(PacketError::InvalidPacketSequence {
-                    given_sequence: msg.packet.seq_on_a,
-                    next_sequence: msg.next_seq_recv_on_b,
+        let next_seq_recv_verification_result = match chan_end_on_a.ordering {
+            Order::Ordered => {
+                if msg.packet.seq_on_a < msg.next_seq_recv_on_b {
+                    return Err(PacketError::InvalidPacketSequence {
+                        given_sequence: msg.packet.seq_on_a,
+                        next_sequence: msg.next_seq_recv_on_b,
+                    }
+                    .into());
                 }
-                .into());
+                let seq_recv_path_on_b =
+                    SeqRecvPath::new(&msg.packet.port_id_on_b, &msg.packet.chan_id_on_b);
+
+                client_state_of_b_on_a.verify_membership(
+                    conn_end_on_a.counterparty().prefix(),
+                    &msg.proof_unreceived_on_b,
+                    consensus_state_of_b_on_a.root(),
+                    Path::SeqRecv(seq_recv_path_on_b),
+                    msg.packet.seq_on_a.to_vec(),
+                )
+            }
+            Order::Unordered => {
+                let receipt_path_on_b = ReceiptPath::new(
+                    &msg.packet.port_id_on_b,
+                    &msg.packet.chan_id_on_b,
+                    msg.packet.seq_on_a,
+                );
+
+                client_state_of_b_on_a.verify_non_membership(
+                    conn_end_on_a.counterparty().prefix(),
+                    &msg.proof_unreceived_on_b,
+                    consensus_state_of_b_on_a.root(),
+                    Path::Receipt(receipt_path_on_b),
+                )
+            }
+            Order::None => {
+                return Err(ContextError::ChannelError(ChannelError::InvalidOrderType {
+                    expected: "Channel ordering cannot be None".to_string(),
+                    actual: chan_end_on_a.ordering.to_string(),
+                }))
             }
-            let seq_recv_path_on_b =
-                SeqRecvPath::new(&msg.packet.port_id_on_b, &msg.packet.chan_id_on_b);
-
-            client_state_of_b_on_a.verify_membership(
-                conn_end_on_a.counterparty().prefix(),
-                &msg.proof_unreceived_on_b,
-                consensus_state_of_b_on_a.root(),
-                Path::SeqRecv(seq_recv_path_on_b),
-                msg.packet.seq_on_a.to_vec(),
-            )
-        } else {
-            let receipt_path_on_b = ReceiptPath::new(
-                &msg.packet.port_id_on_b,
-                &msg.packet.chan_id_on_b,
-                msg.packet.seq_on_a,
-            );
-
-            client_state_of_b_on_a.verify_non_membership(
-                conn_end_on_a.counterparty().prefix(),
-                &msg.proof_unreceived_on_b,
-                consensus_state_of_b_on_a.root(),
-                Path::Receipt(receipt_path_on_b),
-            )
         };
+
         next_seq_recv_verification_result
             .map_err(|e| ChannelError::PacketVerificationFailed {
                 sequence: msg.next_seq_recv_on_b,
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index eb6224a4b..b448bba44 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -120,37 +120,48 @@ where
 
         verify_conn_delay_passed(ctx_a, msg.proof_height_on_b, &conn_end_on_a)?;
 
-        let next_seq_recv_verification_result = if chan_end_on_a.order_matches(&Order::Ordered) {
-            if packet.seq_on_a < msg.next_seq_recv_on_b {
-                return Err(PacketError::InvalidPacketSequence {
-                    given_sequence: packet.seq_on_a,
-                    next_sequence: msg.next_seq_recv_on_b,
+        let next_seq_recv_verification_result = match chan_end_on_a.ordering {
+            Order::Ordered => {
+                if packet.seq_on_a < msg.next_seq_recv_on_b {
+                    return Err(PacketError::InvalidPacketSequence {
+                        given_sequence: packet.seq_on_a,
+                        next_sequence: msg.next_seq_recv_on_b,
+                    }
+                    .into());
                 }
-                .into());
+                let seq_recv_path_on_b =
+                    SeqRecvPath::new(&packet.port_id_on_b, &packet.chan_id_on_b);
+
+                client_state_of_b_on_a.verify_membership(
+                    conn_end_on_a.counterparty().prefix(),
+                    &msg.proof_unreceived_on_b,
+                    consensus_state_of_b_on_a.root(),
+                    Path::SeqRecv(seq_recv_path_on_b),
+                    packet.seq_on_a.to_vec(),
+                )
+            }
+            Order::Unordered => {
+                let receipt_path_on_b = ReceiptPath::new(
+                    &msg.packet.port_id_on_b,
+                    &msg.packet.chan_id_on_b,
+                    msg.packet.seq_on_a,
+                );
+
+                client_state_of_b_on_a.verify_non_membership(
+                    conn_end_on_a.counterparty().prefix(),
+                    &msg.proof_unreceived_on_b,
+                    consensus_state_of_b_on_a.root(),
+                    Path::Receipt(receipt_path_on_b),
+                )
+            }
+            Order::None => {
+                return Err(ContextError::ChannelError(ChannelError::InvalidOrderType {
+                    expected: "Channel ordering cannot be None".to_string(),
+                    actual: chan_end_on_a.ordering.to_string(),
+                }))
             }
-            let seq_recv_path_on_b = SeqRecvPath::new(&packet.port_id_on_b, &packet.chan_id_on_b);
-
-            client_state_of_b_on_a.verify_membership(
-                conn_end_on_a.counterparty().prefix(),
-                &msg.proof_unreceived_on_b,
-                consensus_state_of_b_on_a.root(),
-                Path::SeqRecv(seq_recv_path_on_b),
-                packet.seq_on_a.to_vec(),
-            )
-        } else {
-            let receipt_path_on_b = ReceiptPath::new(
-                &msg.packet.port_id_on_b,
-                &msg.packet.chan_id_on_b,
-                msg.packet.seq_on_a,
-            );
-
-            client_state_of_b_on_a.verify_non_membership(
-                conn_end_on_a.counterparty().prefix(),
-                &msg.proof_unreceived_on_b,
-                consensus_state_of_b_on_a.root(),
-                Path::Receipt(receipt_path_on_b),
-            )
         };
+
         next_seq_recv_verification_result
             .map_err(|e| ChannelError::PacketVerificationFailed {
                 sequence: msg.next_seq_recv_on_b,
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index f42d8b86f..732e17185 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -280,6 +280,10 @@ impl ChannelEnd {
     }
 
     /// Helper function to compare the order of this end with another order.
+    #[deprecated(
+        since = "0.50.1",
+        note = "Use `Eq` or `match` directly on the `Order` enum instead"
+    )]
     pub fn order_matches(&self, other: &Order) -> bool {
         self.ordering.eq(other)
     }

From 6dd3c6465e594d4c177f21724dd896a15e8f3634 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Thu, 29 Feb 2024 09:17:28 -0600
Subject: [PATCH 121/182] feat: detach client state verifier enabling users to
 implement custom verifier (#1097)

* Add empty Verifier trait stub

* Remove verifier field from ClientState

* Implement TmVerifier for ClientState

* Move ClientState trait methods into being standalone functions

* Fix some typos

* Remove unused fn param on update_client_state_on_misbehaviour

* Call standalone functions in trait implementations

* Move update_client and misbehaviour methods out of the ClientState impl

* Define `DefaultVerifier` type

* Replace `ClientState` fn params with `ClientStateType`

* Migrate ClientState::initialise function param back to ClientState

* Change some associated type constraints

* Change From<TmConsensusState> constraint to From<ConsensusStateType>

* impl From<ConsensusStateType> for AnyConsensusState

* impl some Displays when use-substrate feature is not enabled

* Remove unused displaydoc use statement

* Revert "Remove unused displaydoc use statement"

This reverts commit 92e8e36180db9071702feaf789c1c0990da4cb0d.

* Revert "impl some Displays when use-substrate feature is not enabled"

This reverts commit 083399c3991fe4db5693518d74be1eee0421e6bb.

* Add docstring comment illustrating how to implement a custom verifier

* Ad unclog entry

* fix: set NIGHTLY_VERSION=nightly-2024-02-24

* imp: reorganize client_state.rs + clean-ups

* nit

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1097-detach-client-state-verifier.md      |   3 +
 .github/workflows/no-std.yaml                 |   2 +-
 ci/no-std-check/Makefile                      |   2 +-
 ibc-clients/ics07-tendermint/Cargo.toml       |   3 +-
 .../ics07-tendermint/src/client_state.rs      | 482 +-----------------
 .../src/client_state/common.rs                | 236 +++++++++
 .../src/client_state/execution.rs             | 348 +++++++++++++
 .../src/client_state/misbehaviour.rs          | 243 ++++-----
 .../src/client_state/update_client.rs         | 335 ++++++------
 .../src/client_state/validation.rs            | 196 +++++++
 .../ics07-tendermint/src/consensus_state.rs   |   8 +-
 ibc-clients/ics07-tendermint/src/context.rs   |  37 ++
 .../types/src/client_state.rs                 |   4 -
 .../cosmos/src/validate_self_client.rs        |   9 +-
 ibc-testkit/src/testapp/ibc/clients/mod.rs    |  13 +
 15 files changed, 1131 insertions(+), 790 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1097-detach-client-state-verifier.md
 create mode 100644 ibc-clients/ics07-tendermint/src/client_state/common.rs
 create mode 100644 ibc-clients/ics07-tendermint/src/client_state/execution.rs
 create mode 100644 ibc-clients/ics07-tendermint/src/client_state/validation.rs

diff --git a/.changelog/unreleased/improvements/1097-detach-client-state-verifier.md b/.changelog/unreleased/improvements/1097-detach-client-state-verifier.md
new file mode 100644
index 000000000..35203b08c
--- /dev/null
+++ b/.changelog/unreleased/improvements/1097-detach-client-state-verifier.md
@@ -0,0 +1,3 @@
+- [ibc-client-tendermint] Detach client state verifier such that users have a
+  way to utilize custom verifiers
+  ([\#1097](https://github.com/cosmos/ibc-rs/pull/1097))
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index bec26c15b..90a3b8e09 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -48,7 +48,7 @@ jobs:
       - uses: actions/checkout@v2
       - uses: actions-rs/toolchain@v1
         with:
-          toolchain: nightly
+          toolchain: nightly-2024-02-24
           target: wasm32-unknown-unknown
           override: true
       - run: |
diff --git a/ci/no-std-check/Makefile b/ci/no-std-check/Makefile
index 48fc0dfa0..6702a89a4 100644
--- a/ci/no-std-check/Makefile
+++ b/ci/no-std-check/Makefile
@@ -1,4 +1,4 @@
-NIGHTLY_VERSION=nightly
+NIGHTLY_VERSION=nightly-2024-02-24
 
 .DEFAULT_GOAL := help
 
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index b1727305e..f7da34cae 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -18,7 +18,8 @@ all-features = true
 
 [dependencies]
 # external dependencies
-serde = { workspace = true, optional = true }
+derive_more = { workspace = true }
+serde       = { workspace = true, optional = true }
 
 # ibc dependencies
 ibc-client-tendermint-types      = { workspace = true }
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 88b00d533..bb9415487 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -10,45 +10,31 @@
 
 use ibc_client_tendermint_types::error::Error;
 use ibc_client_tendermint_types::proto::v1::ClientState as RawTmClientState;
-use ibc_client_tendermint_types::{
-    client_type as tm_client_type, ClientState as ClientStateType,
-    ConsensusState as ConsensusStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
-    TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
-};
-use ibc_core_client::context::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation,
-};
-use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
-use ibc_core_client::types::error::{ClientError, UpgradeClientError};
-use ibc_core_client::types::{Height, Status};
-use ibc_core_commitment_types::commitment::{
-    CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
-};
-use ibc_core_commitment_types::merkle::{apply_prefix, MerkleProof};
-use ibc_core_host::types::identifiers::{ClientId, ClientType};
-use ibc_core_host::types::path::{
-    ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
-};
-use ibc_core_host::ExecutionContext;
+use ibc_client_tendermint_types::ClientState as ClientStateType;
+use ibc_core_client::types::error::ClientError;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::{Any, Protobuf};
-use ibc_primitives::ToVec;
 
-use super::consensus_state::ConsensusState as TmConsensusState;
-use crate::context::{
-    CommonContext, ExecutionContext as TmExecutionContext, ValidationContext as TmValidationContext,
-};
+use crate::context::ValidationContext as TmValidationContext;
 
+mod common;
+mod execution;
 mod misbehaviour;
 mod update_client;
+mod validation;
+
+pub use common::*;
+pub use execution::*;
+pub use misbehaviour::*;
+pub use update_client::*;
+pub use validation::*;
 
 /// Newtype wrapper around the `ClientState` type imported from the
 /// `ibc-client-tendermint-types` crate. This wrapper exists so that we can
 /// bypass Rust's orphan rules and implement traits from
 /// `ibc::core::client::context` on the `ClientState` type.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq)]
+#[derive(Clone, Debug, PartialEq, derive_more::From)]
 pub struct ClientState(ClientStateType);
 
 impl ClientState {
@@ -57,12 +43,6 @@ impl ClientState {
     }
 }
 
-impl From<ClientStateType> for ClientState {
-    fn from(client_state: ClientStateType) -> Self {
-        Self(client_state)
-    }
-}
-
 impl Protobuf<RawTmClientState> for ClientState {}
 
 impl TryFrom<RawTmClientState> for ClientState {
@@ -95,438 +75,6 @@ impl From<ClientState> for Any {
     }
 }
 
-impl ClientStateCommon for ClientState {
-    fn verify_consensus_state(&self, consensus_state: Any) -> Result<(), ClientError> {
-        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
-        if tm_consensus_state.root().is_empty() {
-            return Err(ClientError::Other {
-                description: "empty commitment root".into(),
-            });
-        };
-
-        Ok(())
-    }
-
-    fn client_type(&self) -> ClientType {
-        tm_client_type()
-    }
-
-    fn latest_height(&self) -> Height {
-        self.0.latest_height
-    }
-
-    fn validate_proof_height(&self, proof_height: Height) -> Result<(), ClientError> {
-        if self.latest_height() < proof_height {
-            return Err(ClientError::InvalidProofHeight {
-                latest_height: self.latest_height(),
-                proof_height,
-            });
-        }
-        Ok(())
-    }
-
-    /// Perform client-specific verifications and check all data in the new
-    /// client state to be the same across all valid Tendermint clients for the
-    /// new chain.
-    ///
-    /// You can learn more about how to upgrade IBC-connected SDK chains in
-    /// [this](https://ibc.cosmos.network/main/ibc/upgrades/quick-guide.html)
-    /// guide
-    fn verify_upgrade_client(
-        &self,
-        upgraded_client_state: Any,
-        upgraded_consensus_state: Any,
-        proof_upgrade_client: CommitmentProofBytes,
-        proof_upgrade_consensus_state: CommitmentProofBytes,
-        root: &CommitmentRoot,
-    ) -> Result<(), ClientError> {
-        // Make sure that the client type is of Tendermint type `ClientState`
-        let upgraded_tm_client_state = Self::try_from(upgraded_client_state.clone())?;
-
-        // Make sure that the consensus type is of Tendermint type `ConsensusState`
-        TmConsensusState::try_from(upgraded_consensus_state.clone())?;
-
-        // Make sure the latest height of the current client is not greater then
-        // the upgrade height This condition checks both the revision number and
-        // the height
-        if self.latest_height() >= upgraded_tm_client_state.0.latest_height {
-            return Err(UpgradeClientError::LowUpgradeHeight {
-                upgraded_height: self.latest_height(),
-                client_height: upgraded_tm_client_state.0.latest_height,
-            })?;
-        }
-
-        // Check to see if the upgrade path is set
-        let mut upgrade_path = self.0.upgrade_path.clone();
-        if upgrade_path.pop().is_none() {
-            return Err(ClientError::ClientSpecific {
-                description: "cannot upgrade client as no upgrade path has been set".to_string(),
-            });
-        };
-
-        let upgrade_path_prefix = CommitmentPrefix::try_from(upgrade_path[0].clone().into_bytes())
-            .map_err(ClientError::InvalidCommitmentProof)?;
-
-        let last_height = self.latest_height().revision_height();
-
-        // Verify the proof of the upgraded client state
-        self.verify_membership(
-            &upgrade_path_prefix,
-            &proof_upgrade_client,
-            root,
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(last_height)),
-            upgraded_client_state.to_vec(),
-        )?;
-
-        // Verify the proof of the upgraded consensus state
-        self.verify_membership(
-            &upgrade_path_prefix,
-            &proof_upgrade_consensus_state,
-            root,
-            Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(last_height)),
-            upgraded_consensus_state.to_vec(),
-        )?;
-
-        Ok(())
-    }
-
-    fn verify_membership(
-        &self,
-        prefix: &CommitmentPrefix,
-        proof: &CommitmentProofBytes,
-        root: &CommitmentRoot,
-        path: Path,
-        value: Vec<u8>,
-    ) -> Result<(), ClientError> {
-        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof =
-            MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
-
-        merkle_proof
-            .verify_membership(
-                &self.0.proof_specs,
-                root.clone().into(),
-                merkle_path,
-                value,
-                0,
-            )
-            .map_err(ClientError::Ics23Verification)
-    }
-
-    fn verify_non_membership(
-        &self,
-        prefix: &CommitmentPrefix,
-        proof: &CommitmentProofBytes,
-        root: &CommitmentRoot,
-        path: Path,
-    ) -> Result<(), ClientError> {
-        let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
-        let merkle_proof =
-            MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
-
-        merkle_proof
-            .verify_non_membership(&self.0.proof_specs, root.clone().into(), merkle_path)
-            .map_err(ClientError::Ics23Verification)
-    }
-}
-
-impl<V> ClientStateValidation<V> for ClientState
-where
-    V: ClientValidationContext + TmValidationContext,
-    V::AnyConsensusState: TryInto<TmConsensusState>,
-    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
-{
-    fn verify_client_message(
-        &self,
-        ctx: &V,
-        client_id: &ClientId,
-        client_message: Any,
-    ) -> Result<(), ClientError> {
-        match client_message.type_url.as_str() {
-            TENDERMINT_HEADER_TYPE_URL => {
-                let header = TmHeader::try_from(client_message)?;
-                self.verify_header(ctx, client_id, header)
-            }
-            TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
-                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-                self.verify_misbehaviour(ctx, client_id, misbehaviour)
-            }
-            _ => Err(ClientError::InvalidUpdateClientMessage),
-        }
-    }
-
-    /// Namely the following cases are covered:
-    ///
-    /// 1 - fork:
-    /// Assumes at least one consensus state before the fork point exists. Let
-    /// existing consensus states on chain B be: [Sn,.., Sf, Sf-1, S0] with
-    /// `Sf-1` being the most recent state before fork. Chain A is queried for a
-    /// header `Hf'` at `Sf.height` and if it is different than the `Hf` in the
-    /// event for the client update (the one that has generated `Sf` on chain),
-    /// then the two headers are included in the evidence and submitted. Note
-    /// that in this case the headers are different but have the same height.
-    ///
-    /// 2 - BFT time violation for unavailable header (a.k.a. Future Lunatic
-    /// Attack or FLA):
-    /// Some header with a height that is higher than the latest height on A has
-    /// been accepted and a consensus state was created on B. Note that this
-    /// implies that the timestamp of this header must be within the
-    /// `clock_drift` of the client. Assume the client on B has been updated
-    /// with `h2`(not present on/ produced by chain A) and it has a timestamp of
-    /// `t2` that is at most `clock_drift` in the future. Then the latest header
-    /// from A is fetched, let it be `h1`, with a timestamp of `t1`. If `t1 >=
-    /// t2` then evidence of misbehavior is submitted to A.
-    ///
-    /// 3 - BFT time violation for existing headers:
-    /// Ensure that consensus state times are monotonically increasing with
-    /// height.
-    fn check_for_misbehaviour(
-        &self,
-        ctx: &V,
-        client_id: &ClientId,
-        client_message: Any,
-    ) -> Result<bool, ClientError> {
-        match client_message.type_url.as_str() {
-            TENDERMINT_HEADER_TYPE_URL => {
-                let header = TmHeader::try_from(client_message)?;
-                self.check_for_misbehaviour_update_client(ctx, client_id, header)
-            }
-            TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
-                let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-                self.check_for_misbehaviour_misbehavior(&misbehaviour)
-            }
-            _ => Err(ClientError::InvalidUpdateClientMessage),
-        }
-    }
-
-    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
-        if self.0.is_frozen() {
-            return Ok(Status::Frozen);
-        }
-
-        let latest_consensus_state: TmConsensusState = {
-            let any_latest_consensus_state =
-                match ctx.consensus_state(&ClientConsensusStatePath::new(
-                    client_id.clone(),
-                    self.0.latest_height.revision_number(),
-                    self.0.latest_height.revision_height(),
-                )) {
-                    Ok(cs) => cs,
-                    // if the client state does not have an associated consensus state for its latest height
-                    // then it must be expired
-                    Err(_) => return Ok(Status::Expired),
-                };
-
-            any_latest_consensus_state.try_into()?
-        };
-
-        // Note: if the `duration_since()` is `None`, indicating that the latest
-        // consensus state is in the future, then we don't consider the client
-        // to be expired.
-        let now = ctx.host_timestamp()?;
-        if let Some(elapsed_since_latest_consensus_state) =
-            now.duration_since(&latest_consensus_state.timestamp().into())
-        {
-            if elapsed_since_latest_consensus_state > self.0.trusting_period {
-                return Ok(Status::Expired);
-            }
-        }
-
-        Ok(Status::Active)
-    }
-}
-
-impl<E> ClientStateExecution<E> for ClientState
-where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientState>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<TmConsensusState>,
-{
-    fn initialise(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        consensus_state: Any,
-    ) -> Result<(), ClientError> {
-        let host_timestamp = CommonContext::host_timestamp(ctx)?;
-        let host_height = CommonContext::host_height(ctx)?;
-
-        let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
-
-        ctx.store_client_state(ClientStatePath::new(client_id.clone()), self.clone().into())?;
-        ctx.store_consensus_state(
-            ClientConsensusStatePath::new(
-                client_id.clone(),
-                self.0.latest_height.revision_number(),
-                self.0.latest_height.revision_height(),
-            ),
-            tm_consensus_state.into(),
-        )?;
-        ctx.store_update_meta(
-            client_id.clone(),
-            self.latest_height(),
-            host_timestamp,
-            host_height,
-        )?;
-
-        Ok(())
-    }
-
-    fn update_state(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        header: Any,
-    ) -> Result<Vec<Height>, ClientError> {
-        let header = TmHeader::try_from(header)?;
-        let header_height = header.height();
-
-        self.prune_oldest_consensus_state(ctx, client_id)?;
-
-        let maybe_existing_consensus_state = {
-            let path_at_header_height = ClientConsensusStatePath::new(
-                client_id.clone(),
-                header_height.revision_number(),
-                header_height.revision_height(),
-            );
-
-            CommonContext::consensus_state(ctx, &path_at_header_height).ok()
-        };
-
-        if maybe_existing_consensus_state.is_some() {
-            // if we already had the header installed by a previous relayer
-            // then this is a no-op.
-            //
-            // Do nothing.
-        } else {
-            let host_timestamp = CommonContext::host_timestamp(ctx)?;
-            let host_height = CommonContext::host_height(ctx)?;
-
-            let new_consensus_state = ConsensusStateType::from(header.clone());
-            let new_client_state = self.0.clone().with_header(header)?;
-
-            ctx.store_consensus_state(
-                ClientConsensusStatePath::new(
-                    client_id.clone(),
-                    header_height.revision_number(),
-                    header_height.revision_height(),
-                ),
-                TmConsensusState::from(new_consensus_state).into(),
-            )?;
-            ctx.store_client_state(
-                ClientStatePath::new(client_id.clone()),
-                ClientState::from(new_client_state).into(),
-            )?;
-            ctx.store_update_meta(
-                client_id.clone(),
-                header_height,
-                host_timestamp,
-                host_height,
-            )?;
-        }
-
-        Ok(vec![header_height])
-    }
-
-    fn update_state_on_misbehaviour(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        _client_message: Any,
-    ) -> Result<(), ClientError> {
-        // NOTE: frozen height is  set to `Height {revision_height: 0,
-        // revision_number: 1}` and it is the same for all misbehaviour. This
-        // aligns with the
-        // [`ibc-go`](https://github.com/cosmos/ibc-go/blob/0e3f428e66d6fc0fc6b10d2f3c658aaa5000daf7/modules/light-clients/07-tendermint/misbehaviour.go#L18-L19)
-        // implementation.
-        let frozen_client_state = self.0.clone().with_frozen_height(Height::min(0));
-
-        let wrapped_frozen_client_state = ClientState::from(frozen_client_state);
-
-        ctx.store_client_state(
-            ClientStatePath::new(client_id.clone()),
-            wrapped_frozen_client_state.into(),
-        )?;
-
-        Ok(())
-    }
-
-    // Commit the new client state and consensus state to the store
-    fn update_state_on_upgrade(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-        upgraded_client_state: Any,
-        upgraded_consensus_state: Any,
-    ) -> Result<Height, ClientError> {
-        let mut upgraded_tm_client_state = Self::try_from(upgraded_client_state)?;
-        let upgraded_tm_cons_state = TmConsensusState::try_from(upgraded_consensus_state)?;
-
-        upgraded_tm_client_state.0.zero_custom_fields();
-
-        // Construct new client state and consensus state relayer chosen client
-        // parameters are ignored. All chain-chosen parameters come from
-        // committed client, all client-chosen parameters come from current
-        // client.
-        let new_client_state = ClientStateType::new(
-            upgraded_tm_client_state.0.chain_id,
-            self.0.trust_level,
-            self.0.trusting_period,
-            upgraded_tm_client_state.0.unbonding_period,
-            self.0.max_clock_drift,
-            upgraded_tm_client_state.0.latest_height,
-            upgraded_tm_client_state.0.proof_specs,
-            upgraded_tm_client_state.0.upgrade_path,
-            self.0.allow_update,
-        )?;
-
-        // The new consensus state is merely used as a trusted kernel against
-        // which headers on the new chain can be verified. The root is just a
-        // stand-in sentinel value as it cannot be known in advance, thus no
-        // proof verification will pass. The timestamp and the
-        // NextValidatorsHash of the consensus state is the blocktime and
-        // NextValidatorsHash of the last block committed by the old chain. This
-        // will allow the first block of the new chain to be verified against
-        // the last validators of the old chain so long as it is submitted
-        // within the TrustingPeriod of this client.
-        // NOTE: We do not set processed time for this consensus state since
-        // this consensus state should not be used for packet verification as
-        // the root is empty. The next consensus state submitted using update
-        // will be usable for packet-verification.
-        let sentinel_root = "sentinel_root".as_bytes().to_vec();
-        let new_consensus_state = ConsensusStateType::new(
-            sentinel_root.into(),
-            upgraded_tm_cons_state.timestamp(),
-            upgraded_tm_cons_state.next_validators_hash(),
-        );
-
-        let latest_height = new_client_state.latest_height;
-        let host_timestamp = CommonContext::host_timestamp(ctx)?;
-        let host_height = CommonContext::host_height(ctx)?;
-
-        ctx.store_client_state(
-            ClientStatePath::new(client_id.clone()),
-            ClientState::from(new_client_state).into(),
-        )?;
-        ctx.store_consensus_state(
-            ClientConsensusStatePath::new(
-                client_id.clone(),
-                latest_height.revision_number(),
-                latest_height.revision_height(),
-            ),
-            TmConsensusState::from(new_consensus_state).into(),
-        )?;
-        ctx.store_update_meta(
-            client_id.clone(),
-            latest_height,
-            host_timestamp,
-            host_height,
-        )?;
-
-        Ok(latest_height)
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use core::time::Duration;
@@ -534,8 +82,10 @@ mod tests {
     use ibc_client_tendermint_types::{
         AllowUpdate, ClientState as ClientStateType, TrustThreshold,
     };
+    use ibc_core_client::types::Height;
     use ibc_core_commitment_types::specs::ProofSpecs;
     use ibc_core_host::types::identifiers::ChainId;
+    use tests::common::validate_proof_height;
 
     use super::*;
 
@@ -610,7 +160,7 @@ mod tests {
                 Some(setup) => (setup)(ClientState(client_state)),
                 _ => ClientState(client_state),
             };
-            let res = client_state.validate_proof_height(test.height);
+            let res = validate_proof_height(client_state.inner(), test.height);
 
             assert_eq!(
                 test.want_pass,
diff --git a/ibc-clients/ics07-tendermint/src/client_state/common.rs b/ibc-clients/ics07-tendermint/src/client_state/common.rs
new file mode 100644
index 000000000..583a1f36a
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/client_state/common.rs
@@ -0,0 +1,236 @@
+use ibc_client_tendermint_types::{client_type as tm_client_type, ClientState as ClientStateType};
+use ibc_core_client::context::client_state::ClientStateCommon;
+use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::types::error::{ClientError, UpgradeClientError};
+use ibc_core_client::types::Height;
+use ibc_core_commitment_types::commitment::{
+    CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
+};
+use ibc_core_commitment_types::merkle::{apply_prefix, MerkleProof};
+use ibc_core_host::types::identifiers::ClientType;
+use ibc_core_host::types::path::{Path, UpgradeClientPath};
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
+use ibc_primitives::ToVec;
+
+use super::ClientState;
+use crate::consensus_state::ConsensusState as TmConsensusState;
+
+impl ClientStateCommon for ClientState {
+    fn verify_consensus_state(&self, consensus_state: Any) -> Result<(), ClientError> {
+        verify_consensus_state(consensus_state)
+    }
+
+    fn client_type(&self) -> ClientType {
+        tm_client_type()
+    }
+
+    fn latest_height(&self) -> Height {
+        self.0.latest_height
+    }
+
+    fn validate_proof_height(&self, proof_height: Height) -> Result<(), ClientError> {
+        validate_proof_height(self.inner(), proof_height)
+    }
+
+    fn verify_upgrade_client(
+        &self,
+        upgraded_client_state: Any,
+        upgraded_consensus_state: Any,
+        proof_upgrade_client: CommitmentProofBytes,
+        proof_upgrade_consensus_state: CommitmentProofBytes,
+        root: &CommitmentRoot,
+    ) -> Result<(), ClientError> {
+        verify_upgrade_client(
+            self.inner(),
+            upgraded_client_state,
+            upgraded_consensus_state,
+            proof_upgrade_client,
+            proof_upgrade_consensus_state,
+            root,
+        )
+    }
+
+    fn verify_membership(
+        &self,
+        prefix: &CommitmentPrefix,
+        proof: &CommitmentProofBytes,
+        root: &CommitmentRoot,
+        path: Path,
+        value: Vec<u8>,
+    ) -> Result<(), ClientError> {
+        verify_membership(self.inner(), prefix, proof, root, path, value)
+    }
+
+    fn verify_non_membership(
+        &self,
+        prefix: &CommitmentPrefix,
+        proof: &CommitmentProofBytes,
+        root: &CommitmentRoot,
+        path: Path,
+    ) -> Result<(), ClientError> {
+        verify_non_membership(self.inner(), prefix, proof, root, path)
+    }
+}
+
+/// Verify an `Any` consensus state by attempting to convert it to a `TmConsensusState`.
+/// Also checks whether the converted consensus state's root is present.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateCommon`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn verify_consensus_state(consensus_state: Any) -> Result<(), ClientError> {
+    let tm_consensus_state = TmConsensusState::try_from(consensus_state)?;
+
+    if tm_consensus_state.root().is_empty() {
+        return Err(ClientError::Other {
+            description: "empty commitment root".into(),
+        });
+    };
+
+    Ok(())
+}
+
+/// Validate the given proof height against the client state's latest height, returning
+/// an error if the proof height is greater than the latest height of the client state.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateCommon`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn validate_proof_height(
+    client_state: &ClientStateType,
+    proof_height: Height,
+) -> Result<(), ClientError> {
+    let latest_height = client_state.latest_height;
+
+    if latest_height < proof_height {
+        return Err(ClientError::InvalidProofHeight {
+            latest_height,
+            proof_height,
+        });
+    }
+
+    Ok(())
+}
+
+/// Perform client-specific verifications and check all data in the new
+/// client state to be the same across all valid Tendermint clients for the
+/// new chain.
+///
+/// You can learn more about how to upgrade IBC-connected SDK chains in
+/// [this](https://ibc.cosmos.network/main/ibc/upgrades/quick-guide.html)
+/// guide.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateCommon`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn verify_upgrade_client(
+    client_state: &ClientStateType,
+    upgraded_client_state: Any,
+    upgraded_consensus_state: Any,
+    proof_upgrade_client: CommitmentProofBytes,
+    proof_upgrade_consensus_state: CommitmentProofBytes,
+    root: &CommitmentRoot,
+) -> Result<(), ClientError> {
+    // Make sure that the client type is of Tendermint type `ClientState`
+    let upgraded_tm_client_state = ClientState::try_from(upgraded_client_state.clone())?;
+
+    // Make sure that the consensus type is of Tendermint type `ConsensusState`
+    TmConsensusState::try_from(upgraded_consensus_state.clone())?;
+
+    let latest_height = client_state.latest_height;
+    let upgraded_tm_client_state_height = upgraded_tm_client_state.latest_height();
+
+    // Make sure the latest height of the current client is not greater then
+    // the upgrade height This condition checks both the revision number and
+    // the height
+    if latest_height >= upgraded_tm_client_state_height {
+        Err(UpgradeClientError::LowUpgradeHeight {
+            upgraded_height: latest_height,
+            client_height: upgraded_tm_client_state_height,
+        })?
+    }
+
+    // Check to see if the upgrade path is set
+    let mut upgrade_path = client_state.upgrade_path.clone();
+
+    if upgrade_path.pop().is_none() {
+        return Err(ClientError::ClientSpecific {
+            description: "cannot upgrade client as no upgrade path has been set".to_string(),
+        });
+    };
+
+    let upgrade_path_prefix = CommitmentPrefix::try_from(upgrade_path[0].clone().into_bytes())
+        .map_err(ClientError::InvalidCommitmentProof)?;
+
+    let last_height = latest_height.revision_height();
+
+    // Verify the proof of the upgraded client state
+    verify_membership(
+        client_state,
+        &upgrade_path_prefix,
+        &proof_upgrade_client,
+        root,
+        Path::UpgradeClient(UpgradeClientPath::UpgradedClientState(last_height)),
+        upgraded_client_state.to_vec(),
+    )?;
+
+    // Verify the proof of the upgraded consensus state
+    verify_membership(
+        client_state,
+        &upgrade_path_prefix,
+        &proof_upgrade_consensus_state,
+        root,
+        Path::UpgradeClient(UpgradeClientPath::UpgradedClientConsensusState(last_height)),
+        upgraded_consensus_state.to_vec(),
+    )?;
+
+    Ok(())
+}
+
+/// Verify membership of the given value against the client's merkle proof.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateCommon`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn verify_membership(
+    client_state: &ClientStateType,
+    prefix: &CommitmentPrefix,
+    proof: &CommitmentProofBytes,
+    root: &CommitmentRoot,
+    path: Path,
+    value: Vec<u8>,
+) -> Result<(), ClientError> {
+    let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
+    let merkle_proof = MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
+
+    merkle_proof
+        .verify_membership(
+            &client_state.proof_specs,
+            root.clone().into(),
+            merkle_path,
+            value,
+            0,
+        )
+        .map_err(ClientError::Ics23Verification)
+}
+
+/// Verify that the given value does not belong in the client's merkle proof.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateCommon`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn verify_non_membership(
+    client_state: &ClientStateType,
+    prefix: &CommitmentPrefix,
+    proof: &CommitmentProofBytes,
+    root: &CommitmentRoot,
+    path: Path,
+) -> Result<(), ClientError> {
+    let merkle_path = apply_prefix(prefix, vec![path.to_string()]);
+    let merkle_proof = MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
+
+    merkle_proof
+        .verify_non_membership(&client_state.proof_specs, root.clone().into(), merkle_path)
+        .map_err(ClientError::Ics23Verification)
+}
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
new file mode 100644
index 000000000..0cc6c436d
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -0,0 +1,348 @@
+use ibc_client_tendermint_types::{
+    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
+};
+use ibc_core_client::context::client_state::ClientStateExecution;
+use ibc_core_client::context::ClientExecutionContext;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_client::types::Height;
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc_core_host::ExecutionContext;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
+
+use super::ClientState;
+use crate::consensus_state::ConsensusState as TmConsensusState;
+use crate::context::{CommonContext, ExecutionContext as TmExecutionContext};
+
+impl<E> ClientStateExecution<E> for ClientState
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+{
+    fn initialise(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        consensus_state: Any,
+    ) -> Result<(), ClientError> {
+        initialise(self.inner(), ctx, client_id, consensus_state)
+    }
+
+    fn update_state(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        header: Any,
+    ) -> Result<Vec<Height>, ClientError> {
+        update_state(self.inner(), ctx, client_id, header)
+    }
+
+    fn update_state_on_misbehaviour(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        client_message: Any,
+    ) -> Result<(), ClientError> {
+        update_on_misbehaviour(self.inner(), ctx, client_id, client_message)
+    }
+
+    fn update_state_on_upgrade(
+        &self,
+        ctx: &mut E,
+        client_id: &ClientId,
+        upgraded_client_state: Any,
+        upgraded_consensus_state: Any,
+    ) -> Result<Height, ClientError> {
+        update_on_upgrade(
+            self.inner(),
+            ctx,
+            client_id,
+            upgraded_client_state,
+            upgraded_consensus_state,
+        )
+    }
+}
+
+/// Seed the host store with initial client and consensus states.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateExecution`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn initialise<E>(
+    client_state: &ClientStateType,
+    ctx: &mut E,
+    client_id: &ClientId,
+    consensus_state: Any,
+) -> Result<(), ClientError>
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+{
+    let host_timestamp = CommonContext::host_timestamp(ctx)?;
+    let host_height = CommonContext::host_height(ctx)?;
+
+    let tm_consensus_state = ConsensusStateType::try_from(consensus_state)?;
+
+    ctx.store_client_state(
+        ClientStatePath::new(client_id.clone()),
+        client_state.clone().into(),
+    )?;
+    ctx.store_consensus_state(
+        ClientConsensusStatePath::new(
+            client_id.clone(),
+            client_state.latest_height.revision_number(),
+            client_state.latest_height.revision_height(),
+        ),
+        tm_consensus_state.into(),
+    )?;
+
+    ctx.store_update_meta(
+        client_id.clone(),
+        client_state.latest_height,
+        host_timestamp,
+        host_height,
+    )?;
+
+    Ok(())
+}
+
+/// Update the host store with a new client state, pruning old states from the
+/// store if need be.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateExecution`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn update_state<E>(
+    client_state: &ClientStateType,
+    ctx: &mut E,
+    client_id: &ClientId,
+    header: Any,
+) -> Result<Vec<Height>, ClientError>
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+{
+    let header = TmHeader::try_from(header)?;
+    let header_height = header.height();
+
+    prune_oldest_consensus_state(client_state, ctx, client_id)?;
+
+    let maybe_existing_consensus_state = {
+        let path_at_header_height = ClientConsensusStatePath::new(
+            client_id.clone(),
+            header_height.revision_number(),
+            header_height.revision_height(),
+        );
+
+        CommonContext::consensus_state(ctx, &path_at_header_height).ok()
+    };
+
+    if maybe_existing_consensus_state.is_some() {
+        // if we already had the header installed by a previous relayer
+        // then this is a no-op.
+        //
+        // Do nothing.
+    } else {
+        let host_timestamp = CommonContext::host_timestamp(ctx)?;
+        let host_height = CommonContext::host_height(ctx)?;
+
+        let new_consensus_state = ConsensusStateType::from(header.clone());
+        let new_client_state = client_state.clone().with_header(header)?;
+
+        ctx.store_consensus_state(
+            ClientConsensusStatePath::new(
+                client_id.clone(),
+                header_height.revision_number(),
+                header_height.revision_height(),
+            ),
+            new_consensus_state.into(),
+        )?;
+        ctx.store_client_state(
+            ClientStatePath::new(client_id.clone()),
+            new_client_state.into(),
+        )?;
+        ctx.store_update_meta(
+            client_id.clone(),
+            header_height,
+            host_timestamp,
+            host_height,
+        )?;
+    }
+
+    Ok(vec![header_height])
+}
+
+/// Commit a frozen client state, which was frozen as a result of having exhibited
+/// misbehaviour, to the store.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateExecution`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn update_on_misbehaviour<E>(
+    client_state: &ClientStateType,
+    ctx: &mut E,
+    client_id: &ClientId,
+    _client_message: Any,
+) -> Result<(), ClientError>
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+{
+    // NOTE: frozen height is  set to `Height {revision_height: 0,
+    // revision_number: 1}` and it is the same for all misbehaviour. This
+    // aligns with the
+    // [`ibc-go`](https://github.com/cosmos/ibc-go/blob/0e3f428e66d6fc0fc6b10d2f3c658aaa5000daf7/modules/light-clients/07-tendermint/misbehaviour.go#L18-L19)
+    // implementation.
+    let frozen_client_state = client_state.clone().with_frozen_height(Height::min(0));
+
+    ctx.store_client_state(
+        ClientStatePath::new(client_id.clone()),
+        frozen_client_state.into(),
+    )?;
+
+    Ok(())
+}
+
+/// Commit the new client state and consensus state to the store.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateExecution`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn update_on_upgrade<E>(
+    client_state: &ClientStateType,
+    ctx: &mut E,
+    client_id: &ClientId,
+    upgraded_client_state: Any,
+    upgraded_consensus_state: Any,
+) -> Result<Height, ClientError>
+where
+    E: TmExecutionContext + ExecutionContext,
+    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
+    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+{
+    let mut upgraded_tm_client_state = ClientState::try_from(upgraded_client_state)?;
+    let upgraded_tm_cons_state = TmConsensusState::try_from(upgraded_consensus_state)?;
+
+    upgraded_tm_client_state.0.zero_custom_fields();
+
+    // Construct new client state and consensus state relayer chosen client
+    // parameters are ignored. All chain-chosen parameters come from
+    // committed client, all client-chosen parameters come from current
+    // client.
+    let new_client_state = ClientStateType::new(
+        upgraded_tm_client_state.0.chain_id,
+        client_state.trust_level,
+        client_state.trusting_period,
+        upgraded_tm_client_state.0.unbonding_period,
+        client_state.max_clock_drift,
+        upgraded_tm_client_state.0.latest_height,
+        upgraded_tm_client_state.0.proof_specs,
+        upgraded_tm_client_state.0.upgrade_path,
+        client_state.allow_update,
+    )?;
+
+    // The new consensus state is merely used as a trusted kernel against
+    // which headers on the new chain can be verified. The root is just a
+    // stand-in sentinel value as it cannot be known in advance, thus no
+    // proof verification will pass. The timestamp and the
+    // NextValidatorsHash of the consensus state is the blocktime and
+    // NextValidatorsHash of the last block committed by the old chain. This
+    // will allow the first block of the new chain to be verified against
+    // the last validators of the old chain so long as it is submitted
+    // within the TrustingPeriod of this client.
+    // NOTE: We do not set processed time for this consensus state since
+    // this consensus state should not be used for packet verification as
+    // the root is empty. The next consensus state submitted using update
+    // will be usable for packet-verification.
+    let sentinel_root = "sentinel_root".as_bytes().to_vec();
+    let new_consensus_state = ConsensusStateType::new(
+        sentinel_root.into(),
+        upgraded_tm_cons_state.timestamp(),
+        upgraded_tm_cons_state.next_validators_hash(),
+    );
+
+    let latest_height = new_client_state.latest_height;
+    let host_timestamp = CommonContext::host_timestamp(ctx)?;
+    let host_height = CommonContext::host_height(ctx)?;
+
+    ctx.store_client_state(
+        ClientStatePath::new(client_id.clone()),
+        new_client_state.into(),
+    )?;
+    ctx.store_consensus_state(
+        ClientConsensusStatePath::new(
+            client_id.clone(),
+            latest_height.revision_number(),
+            latest_height.revision_height(),
+        ),
+        new_consensus_state.into(),
+    )?;
+    ctx.store_update_meta(
+        client_id.clone(),
+        latest_height,
+        host_timestamp,
+        host_height,
+    )?;
+
+    Ok(latest_height)
+}
+
+/// Removes consensus states from the client store whose timestamps
+/// are less than or equal to the host timestamp. This ensures that
+/// the client store does not amass a buildup of stale consensus states.
+pub fn prune_oldest_consensus_state<E>(
+    client_state: &ClientStateType,
+    ctx: &mut E,
+    client_id: &ClientId,
+) -> Result<(), ClientError>
+where
+    E: ClientExecutionContext + CommonContext,
+{
+    let mut heights = ctx.consensus_state_heights(client_id)?;
+
+    heights.sort();
+
+    for height in heights {
+        let client_consensus_state_path = ClientConsensusStatePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        let consensus_state = CommonContext::consensus_state(ctx, &client_consensus_state_path)?;
+        let tm_consensus_state = consensus_state
+            .try_into()
+            .map_err(|err| ClientError::Other {
+                description: err.to_string(),
+            })?;
+
+        let host_timestamp =
+            ctx.host_timestamp()?
+                .into_tm_time()
+                .ok_or_else(|| ClientError::Other {
+                    description: String::from("host timestamp is not a valid TM timestamp"),
+                })?;
+
+        let tm_consensus_state_timestamp = tm_consensus_state.timestamp();
+        let tm_consensus_state_expiry = (tm_consensus_state_timestamp
+            + client_state.trusting_period)
+            .map_err(|_| ClientError::Other {
+                description: String::from(
+                    "Timestamp overflow error occurred while attempting to parse TmConsensusState",
+                ),
+            })?;
+
+        if tm_consensus_state_expiry > host_timestamp {
+            break;
+        }
+
+        ctx.delete_consensus_state(client_consensus_state_path)?;
+        ctx.delete_update_meta(client_id.clone(), height)?;
+    }
+
+    Ok(())
+}
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index c671ffa63..777bca1da 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -1,5 +1,8 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
-use ibc_client_tendermint_types::{Header as TmHeader, Misbehaviour as TmMisbehaviour};
+use ibc_client_tendermint_types::{
+    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
+    Misbehaviour as TmMisbehaviour,
+};
 use ibc_core_client::types::error::ClientError;
 use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::ClientConsensusStatePath;
@@ -7,134 +10,146 @@ use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
 use tendermint_light_client_verifier::Verifier;
 
-use super::{ClientState as TmClientState, TmValidationContext};
-use crate::consensus_state::ConsensusState as TmConsensusState;
-
-impl TmClientState {
-    // verify_misbehaviour determines whether or not two conflicting headers at
-    // the same height would have convinced the light client.
-    pub fn verify_misbehaviour<ClientValidationContext>(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-        misbehaviour: TmMisbehaviour,
-    ) -> Result<(), ClientError>
-    where
-        ClientValidationContext: TmValidationContext,
+use super::TmValidationContext;
+use crate::context::TmVerifier;
+
+/// Determines whether or not two conflicting headers at the same height would
+/// have convinced the light client.
+pub fn verify_misbehaviour<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+    misbehaviour: &TmMisbehaviour,
+    verifier: &impl TmVerifier,
+) -> Result<(), ClientError>
+where
+    V: TmValidationContext,
+{
+    misbehaviour.validate_basic()?;
+
+    let header_1 = misbehaviour.header1();
+    let trusted_consensus_state_1 = {
+        let consensus_state_path = ClientConsensusStatePath::new(
+            client_id.clone(),
+            header_1.trusted_height.revision_number(),
+            header_1.trusted_height.revision_height(),
+        );
+        let consensus_state = ctx.consensus_state(&consensus_state_path)?;
+
+        consensus_state
+            .try_into()
+            .map_err(|err| ClientError::Other {
+                description: err.to_string(),
+            })?
+    };
+
+    let header_2 = misbehaviour.header2();
+    let trusted_consensus_state_2 = {
+        let consensus_state_path = ClientConsensusStatePath::new(
+            client_id.clone(),
+            header_2.trusted_height.revision_number(),
+            header_2.trusted_height.revision_height(),
+        );
+        let consensus_state = ctx.consensus_state(&consensus_state_path)?;
+
+        consensus_state
+            .try_into()
+            .map_err(|err| ClientError::Other {
+                description: err.to_string(),
+            })?
+    };
+
+    let current_timestamp = ctx.host_timestamp()?;
+
+    verify_misbehaviour_header(
+        client_state,
+        header_1,
+        trusted_consensus_state_1.inner(),
+        current_timestamp,
+        verifier,
+    )?;
+    verify_misbehaviour_header(
+        client_state,
+        header_2,
+        trusted_consensus_state_2.inner(),
+        current_timestamp,
+        verifier,
+    )
+}
+
+pub fn verify_misbehaviour_header(
+    client_state: &ClientStateType,
+    header: &TmHeader,
+    trusted_consensus_state: &ConsensusStateType,
+    current_timestamp: Timestamp,
+    verifier: &impl TmVerifier,
+) -> Result<(), ClientError> {
+    // ensure correctness of the trusted next validator set provided by the relayer
+    header.check_trusted_next_validator_set(trusted_consensus_state)?;
+
+    // ensure trusted consensus state is within trusting period
     {
-        misbehaviour.validate_basic()?;
-
-        let header_1 = misbehaviour.header1();
-        let trusted_consensus_state_1 = {
-            let consensus_state_path = ClientConsensusStatePath::new(
-                client_id.clone(),
-                header_1.trusted_height.revision_number(),
-                header_1.trusted_height.revision_height(),
-            );
-            let consensus_state = ctx.consensus_state(&consensus_state_path)?;
-
-            consensus_state
-                .try_into()
-                .map_err(|err| ClientError::Other {
-                    description: err.to_string(),
-                })?
-        };
-
-        let header_2 = misbehaviour.header2();
-        let trusted_consensus_state_2 = {
-            let consensus_state_path = ClientConsensusStatePath::new(
-                client_id.clone(),
-                header_2.trusted_height.revision_number(),
-                header_2.trusted_height.revision_height(),
-            );
-            let consensus_state = ctx.consensus_state(&consensus_state_path)?;
-
-            consensus_state
-                .try_into()
-                .map_err(|err| ClientError::Other {
-                    description: err.to_string(),
-                })?
-        };
-
-        let current_timestamp = ctx.host_timestamp()?;
-        self.verify_misbehaviour_header(header_1, &trusted_consensus_state_1, current_timestamp)?;
-        self.verify_misbehaviour_header(header_2, &trusted_consensus_state_2, current_timestamp)
-    }
+        let duration_since_consensus_state = current_timestamp
+            .duration_since(&(trusted_consensus_state.timestamp().into()))
+            .ok_or_else(|| ClientError::InvalidConsensusStateTimestamp {
+                time1: trusted_consensus_state.timestamp().into(),
+                time2: current_timestamp,
+            })?;
 
-    pub fn verify_misbehaviour_header(
-        &self,
-        header: &TmHeader,
-        trusted_consensus_state: &TmConsensusState,
-        current_timestamp: Timestamp,
-    ) -> Result<(), ClientError> {
-        // ensure correctness of the trusted next validator set provided by the relayer
-        header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
-
-        // ensure trusted consensus state is within trusting period
-        {
-            let duration_since_consensus_state = current_timestamp
-                .duration_since(&(trusted_consensus_state.timestamp().into()))
-                .ok_or_else(|| ClientError::InvalidConsensusStateTimestamp {
-                    time1: trusted_consensus_state.timestamp().into(),
-                    time2: current_timestamp,
-                })?;
-
-            if duration_since_consensus_state >= self.0.trusting_period {
-                return Err(Error::ConsensusStateTimestampGteTrustingPeriod {
-                    duration_since_consensus_state,
-                    trusting_period: self.0.trusting_period,
-                }
-                .into());
+        if duration_since_consensus_state >= client_state.trusting_period {
+            return Err(Error::ConsensusStateTimestampGteTrustingPeriod {
+                duration_since_consensus_state,
+                trusting_period: client_state.trusting_period,
             }
+            .into());
         }
+    }
 
-        // main header verification, delegated to the tendermint-light-client crate.
-        let untrusted_state = header.as_untrusted_block_state();
+    // main header verification, delegated to the tendermint-light-client crate.
+    let untrusted_state = header.as_untrusted_block_state();
 
-        let chain_id = self
-            .0
+    let chain_id =
+        client_state
             .chain_id
             .to_string()
             .try_into()
             .map_err(|e| ClientError::Other {
                 description: format!("failed to parse chain id: {}", e),
             })?;
-        let trusted_state =
-            header.as_trusted_block_state(trusted_consensus_state.inner(), &chain_id)?;
 
-        let options = self.0.as_light_client_options()?;
-        let current_timestamp = current_timestamp.into_tm_time().ok_or(ClientError::Other {
-            description: "host timestamp must not be zero".to_string(),
-        })?;
+    let trusted_state = header.as_trusted_block_state(trusted_consensus_state, &chain_id)?;
 
-        self.0
-            .verifier
-            .verify_misbehaviour_header(untrusted_state, trusted_state, &options, current_timestamp)
-            .into_result()?;
+    let options = client_state.as_light_client_options()?;
+    let current_timestamp = current_timestamp.into_tm_time().ok_or(ClientError::Other {
+        description: "host timestamp must not be zero".to_string(),
+    })?;
 
-        Ok(())
-    }
+    verifier
+        .verifier()
+        .verify_misbehaviour_header(untrusted_state, trusted_state, &options, current_timestamp)
+        .into_result()?;
 
-    pub fn check_for_misbehaviour_misbehavior(
-        &self,
-        misbehaviour: &TmMisbehaviour,
-    ) -> Result<bool, ClientError> {
-        let header_1 = misbehaviour.header1();
-        let header_2 = misbehaviour.header2();
-
-        if header_1.height() == header_2.height() {
-            // when the height of the 2 headers are equal, we only have evidence
-            // of misbehaviour in the case where the headers are different
-            // (otherwise, the same header was added twice in the message,
-            // and this is evidence of nothing)
-            Ok(header_1.signed_header.commit.block_id.hash
-                != header_2.signed_header.commit.block_id.hash)
-        } else {
-            // header_1 is at greater height than header_2, therefore
-            // header_1 time must be less than or equal to
-            // header_2 time in order to be valid misbehaviour (violation of
-            // monotonic time).
-            Ok(header_1.signed_header.header.time <= header_2.signed_header.header.time)
-        }
+    Ok(())
+}
+
+pub fn check_for_misbehaviour_misbehavior(
+    misbehaviour: &TmMisbehaviour,
+) -> Result<bool, ClientError> {
+    let header_1 = misbehaviour.header1();
+    let header_2 = misbehaviour.header2();
+
+    if header_1.height() == header_2.height() {
+        // when the height of the 2 headers are equal, we only have evidence
+        // of misbehaviour in the case where the headers are different
+        // (otherwise, the same header was added twice in the message,
+        // and this is evidence of nothing)
+        Ok(header_1.signed_header.commit.block_id.hash
+            != header_2.signed_header.commit.block_id.hash)
+    } else {
+        // header_1 is at greater height than header_2, therefore
+        // header_1 time must be less than or equal to
+        // header_2 time in order to be valid misbehaviour (violation of
+        // monotonic time).
+        Ok(header_1.signed_header.header.time <= header_2.signed_header.header.time)
     }
 }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index f412e6242..b5be61f49 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -1,6 +1,7 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
-use ibc_client_tendermint_types::{ConsensusState as ConsensusStateType, Header as TmHeader};
-use ibc_core_client::context::ClientExecutionContext;
+use ibc_client_tendermint_types::{
+    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
+};
 use ibc_core_client::types::error::ClientError;
 use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::ClientConsensusStatePath;
@@ -8,221 +9,171 @@ use ibc_primitives::prelude::*;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
-use super::ClientState;
 use crate::consensus_state::ConsensusState as TmConsensusState;
-use crate::context::{CommonContext, ValidationContext as TmValidationContext};
-
-impl ClientState {
-    pub fn verify_header<ClientValidationContext>(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-        header: TmHeader,
-    ) -> Result<(), ClientError>
-    where
-        ClientValidationContext: TmValidationContext,
+use crate::context::{TmVerifier, ValidationContext as TmValidationContext};
+
+pub fn verify_header<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+    header: &TmHeader,
+    verifier: &impl TmVerifier,
+) -> Result<(), ClientError>
+where
+    V: TmValidationContext,
+{
+    // Checks that the header fields are valid.
+    header.validate_basic()?;
+
+    // The tendermint-light-client crate though works on heights that are assumed
+    // to have the same revision number. We ensure this here.
+    header.verify_chain_id_version_matches_height(&client_state.chain_id())?;
+
+    // Delegate to tendermint-light-client, which contains the required checks
+    // of the new header against the trusted consensus state.
     {
-        // Checks that the header fields are valid.
-        header.validate_basic()?;
-
-        // The tendermint-light-client crate though works on heights that are assumed
-        // to have the same revision number. We ensure this here.
-        header.verify_chain_id_version_matches_height(&self.0.chain_id())?;
-
-        // Delegate to tendermint-light-client, which contains the required checks
-        // of the new header against the trusted consensus state.
-        {
-            let trusted_state =
-                {
-                    let trusted_client_cons_state_path = ClientConsensusStatePath::new(
-                        client_id.clone(),
-                        header.trusted_height.revision_number(),
-                        header.trusted_height.revision_height(),
-                    );
-                    let trusted_consensus_state: TmConsensusState = ctx
-                        .consensus_state(&trusted_client_cons_state_path)?
-                        .try_into()
-                        .map_err(|err| ClientError::Other {
-                            description: err.to_string(),
-                        })?;
+        let trusted_state = {
+            let trusted_client_cons_state_path = ClientConsensusStatePath::new(
+                client_id.clone(),
+                header.trusted_height.revision_number(),
+                header.trusted_height.revision_height(),
+            );
+            let trusted_consensus_state: TmConsensusState = ctx
+                .consensus_state(&trusted_client_cons_state_path)?
+                .try_into()
+                .map_err(|err| ClientError::Other {
+                    description: err.to_string(),
+                })?;
+
+            header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
 
-                    header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
-
-                    TrustedBlockState {
-                        chain_id: &self.0.chain_id.to_string().try_into().map_err(|e| {
-                            ClientError::Other {
-                                description: format!("failed to parse chain id: {}", e),
-                            }
-                        })?,
-                        header_time: trusted_consensus_state.timestamp(),
-                        height: header.trusted_height.revision_height().try_into().map_err(
-                            |_| ClientError::ClientSpecific {
-                                description: Error::InvalidHeaderHeight {
-                                    height: header.trusted_height.revision_height(),
-                                }
-                                .to_string(),
-                            },
-                        )?,
-                        next_validators: &header.trusted_next_validator_set,
-                        next_validators_hash: trusted_consensus_state.next_validators_hash(),
+            TrustedBlockState {
+                chain_id: &client_state.chain_id.to_string().try_into().map_err(|e| {
+                    ClientError::Other {
+                        description: format!("failed to parse chain id: {}", e),
                     }
-                };
-
-            let untrusted_state = UntrustedBlockState {
-                signed_header: &header.signed_header,
-                validators: &header.validator_set,
-                // NB: This will skip the
-                // VerificationPredicates::next_validators_match check for the
-                // untrusted state.
-                next_validators: None,
-            };
-
-            let options = self.0.as_light_client_options()?;
-            let now = ctx.host_timestamp()?.into_tm_time().ok_or_else(|| {
-                ClientError::ClientSpecific {
-                    description: "host timestamp is not a valid TM timestamp".to_string(),
-                }
-            })?;
+                })?,
+                header_time: trusted_consensus_state.timestamp(),
+                height: header
+                    .trusted_height
+                    .revision_height()
+                    .try_into()
+                    .map_err(|_| ClientError::ClientSpecific {
+                        description: Error::InvalidHeaderHeight {
+                            height: header.trusted_height.revision_height(),
+                        }
+                        .to_string(),
+                    })?,
+                next_validators: &header.trusted_next_validator_set,
+                next_validators_hash: trusted_consensus_state.next_validators_hash(),
+            }
+        };
 
-            // main header verification, delegated to the tendermint-light-client crate.
-            self.0
-                .verifier
-                .verify_update_header(untrusted_state, trusted_state, &options, now)
-                .into_result()?;
-        }
+        let untrusted_state = UntrustedBlockState {
+            signed_header: &header.signed_header,
+            validators: &header.validator_set,
+            // NB: This will skip the
+            // VerificationPredicates::next_validators_match check for the
+            // untrusted state.
+            next_validators: None,
+        };
 
-        Ok(())
-    }
+        let options = client_state.as_light_client_options()?;
+        let now =
+            ctx.host_timestamp()?
+                .into_tm_time()
+                .ok_or_else(|| ClientError::ClientSpecific {
+                    description: "host timestamp is not a valid TM timestamp".to_string(),
+                })?;
 
-    pub fn check_for_misbehaviour_update_client<ClientValidationContext>(
-        &self,
-        ctx: &ClientValidationContext,
-        client_id: &ClientId,
-        header: TmHeader,
-    ) -> Result<bool, ClientError>
-    where
-        ClientValidationContext: TmValidationContext,
-    {
-        let maybe_existing_consensus_state = {
-            let path_at_header_height = ClientConsensusStatePath::new(
-                client_id.clone(),
-                header.height().revision_number(),
-                header.height().revision_height(),
-            );
+        // main header verification, delegated to the tendermint-light-client crate.
+        verifier
+            .verifier()
+            .verify_update_header(untrusted_state, trusted_state, &options, now)
+            .into_result()?;
+    }
 
-            ctx.consensus_state(&path_at_header_height).ok()
-        };
+    Ok(())
+}
 
-        match maybe_existing_consensus_state {
-            Some(existing_consensus_state) => {
-                let existing_consensus_state: TmConsensusState = existing_consensus_state
+/// Checks for misbehaviour upon receiving a new consensus state as part
+/// of a client update.
+pub fn check_for_misbehaviour_update_client<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+    header: TmHeader,
+) -> Result<bool, ClientError>
+where
+    V: TmValidationContext,
+{
+    let maybe_existing_consensus_state = {
+        let path_at_header_height = ClientConsensusStatePath::new(
+            client_id.clone(),
+            header.height().revision_number(),
+            header.height().revision_height(),
+        );
+
+        ctx.consensus_state(&path_at_header_height).ok()
+    };
+
+    match maybe_existing_consensus_state {
+        Some(existing_consensus_state) => {
+            let existing_consensus_state =
+                existing_consensus_state
                     .try_into()
                     .map_err(|err| ClientError::Other {
                         description: err.to_string(),
                     })?;
 
-                let header_consensus_state =
-                    TmConsensusState::from(ConsensusStateType::from(header.clone()));
+            let header_consensus_state =
+                TmConsensusState::from(ConsensusStateType::from(header.clone()));
 
-                // There is evidence of misbehaviour if the stored consensus state
-                // is different from the new one we received.
-                Ok(existing_consensus_state != header_consensus_state)
-            }
-            None => {
-                // If no header was previously installed, we ensure the monotonicity of timestamps.
-
-                // 1. for all headers, the new header needs to have a larger timestamp than
-                //    the “previous header”
-                {
-                    let maybe_prev_cs = ctx.prev_consensus_state(client_id, &header.height())?;
-
-                    if let Some(prev_cs) = maybe_prev_cs {
-                        // New header timestamp cannot occur *before* the
-                        // previous consensus state's height
-                        let prev_cs: TmConsensusState =
-                            prev_cs.try_into().map_err(|err| ClientError::Other {
-                                description: err.to_string(),
-                            })?;
-
-                        if header.signed_header.header().time <= prev_cs.timestamp() {
-                            return Ok(true);
-                        }
-                    }
-                }
+            // There is evidence of misbehaviour if the stored consensus state
+            // is different from the new one we received.
+            Ok(existing_consensus_state != header_consensus_state)
+        }
+        None => {
+            // If no header was previously installed, we ensure the monotonicity of timestamps.
+
+            // 1. for all headers, the new header needs to have a larger timestamp than
+            //    the “previous header”
+            {
+                let maybe_prev_cs = ctx.prev_consensus_state(client_id, &header.height())?;
+
+                if let Some(prev_cs) = maybe_prev_cs {
+                    // New header timestamp cannot occur *before* the
+                    // previous consensus state's height
+                    let prev_cs: TmConsensusState =
+                        prev_cs.try_into().map_err(|err| ClientError::Other {
+                            description: err.to_string(),
+                        })?;
 
-                // 2. if a header comes in and is not the “last” header, then we also ensure
-                //    that its timestamp is less than the “next header”
-                if header.height() < self.0.latest_height {
-                    let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
-
-                    if let Some(next_cs) = maybe_next_cs {
-                        // New (untrusted) header timestamp cannot occur *after* next
-                        // consensus state's height
-                        let next_cs: TmConsensusState =
-                            next_cs.try_into().map_err(|err| ClientError::Other {
-                                description: err.to_string(),
-                            })?;
-
-                        if header.signed_header.header().time >= next_cs.timestamp() {
-                            return Ok(true);
-                        }
+                    if header.signed_header.header().time <= prev_cs.timestamp() {
+                        return Ok(true);
                     }
                 }
-
-                Ok(false)
             }
-        }
-    }
-
-    pub fn prune_oldest_consensus_state<E>(
-        &self,
-        ctx: &mut E,
-        client_id: &ClientId,
-    ) -> Result<(), ClientError>
-    where
-        E: ClientExecutionContext + CommonContext,
-    {
-        let mut heights = ctx.consensus_state_heights(client_id)?;
 
-        heights.sort();
+            // 2. if a header comes in and is not the “last” header, then we also ensure
+            //    that its timestamp is less than the “next header”
+            if header.height() < client_state.latest_height {
+                let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
 
-        for height in heights {
-            let client_consensus_state_path = ClientConsensusStatePath::new(
-                client_id.clone(),
-                height.revision_number(),
-                height.revision_height(),
-            );
-            let consensus_state =
-                CommonContext::consensus_state(ctx, &client_consensus_state_path)?;
-            let tm_consensus_state: TmConsensusState =
-                consensus_state
-                    .try_into()
-                    .map_err(|err| ClientError::Other {
+                if let Some(next_cs) = maybe_next_cs {
+                    // New (untrusted) header timestamp cannot occur *after* next
+                    // consensus state's height
+                    let next_cs = next_cs.try_into().map_err(|err| ClientError::Other {
                         description: err.to_string(),
                     })?;
 
-            let host_timestamp =
-                ctx.host_timestamp()?
-                    .into_tm_time()
-                    .ok_or_else(|| ClientError::Other {
-                        description: String::from("host timestamp is not a valid TM timestamp"),
-                    })?;
-            let tm_consensus_state_timestamp = tm_consensus_state.timestamp();
-            let tm_consensus_state_expiry = (tm_consensus_state_timestamp
-                + self.0.trusting_period)
-                .map_err(|_| ClientError::Other {
-                    description: String::from(
-                        "Timestamp overflow error occurred while attempting to parse TmConsensusState",
-                    ),
-                })?;
-
-            if tm_consensus_state_expiry > host_timestamp {
-                break;
+                    if header.signed_header.header().time >= next_cs.timestamp() {
+                        return Ok(true);
+                    }
+                }
             }
-            ctx.delete_consensus_state(client_consensus_state_path)?;
-            ctx.delete_update_meta(client_id.clone(), height)?;
-        }
 
-        Ok(())
+            Ok(false)
+        }
     }
 }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
new file mode 100644
index 000000000..0b79e9d45
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -0,0 +1,196 @@
+use ibc_client_tendermint_types::{
+    ClientState as ClientStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
+    TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
+};
+use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::context::ClientValidationContext;
+use ibc_core_client::types::error::ClientError;
+use ibc_core_client::types::Status;
+use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::path::ClientConsensusStatePath;
+use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
+
+use super::{
+    check_for_misbehaviour_misbehavior, check_for_misbehaviour_update_client, ClientState,
+};
+use crate::client_state::{verify_header, verify_misbehaviour};
+use crate::consensus_state::ConsensusState as TmConsensusState;
+use crate::context::{DefaultVerifier, TmVerifier, ValidationContext as TmValidationContext};
+
+impl<V> ClientStateValidation<V> for ClientState
+where
+    V: ClientValidationContext + TmValidationContext,
+    V::AnyConsensusState: TryInto<TmConsensusState>,
+    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
+{
+    /// The default verification logic exposed by ibc-rs simply delegates to a
+    /// standalone `verify_client_message` function. This is to make it as simple
+    /// as possible for those who merely need the `DefaultVerifier` behaviour, as
+    /// well as those who require custom verification logic.
+    fn verify_client_message(
+        &self,
+        ctx: &V,
+        client_id: &ClientId,
+        client_message: Any,
+    ) -> Result<(), ClientError> {
+        verify_client_message(
+            self.inner(),
+            ctx,
+            client_id,
+            client_message,
+            &DefaultVerifier,
+        )
+    }
+
+    fn check_for_misbehaviour(
+        &self,
+        ctx: &V,
+        client_id: &ClientId,
+        client_message: Any,
+    ) -> Result<bool, ClientError> {
+        check_for_misbehaviour(self.inner(), ctx, client_id, client_message)
+    }
+
+    fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
+        status(self.inner(), ctx, client_id)
+    }
+}
+
+/// Verify the client message as part of the client state validation process.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateValidation`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible. It mostly adheres to
+/// the same signature as the `ClientStateValidation::verify_client_message`
+/// function, except for an additional `verifier` parameter that allows users
+/// who require custom verification logic to easily pass in their own verifier
+/// implementation.
+pub fn verify_client_message<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+    client_message: Any,
+    verifier: &impl TmVerifier,
+) -> Result<(), ClientError>
+where
+    V: ClientValidationContext + TmValidationContext,
+{
+    match client_message.type_url.as_str() {
+        TENDERMINT_HEADER_TYPE_URL => {
+            let header = TmHeader::try_from(client_message)?;
+            verify_header(client_state, ctx, client_id, &header, verifier)
+        }
+        TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
+            let misbehaviour = TmMisbehaviour::try_from(client_message)?;
+            verify_misbehaviour(client_state, ctx, client_id, &misbehaviour, verifier)
+        }
+        _ => Err(ClientError::InvalidUpdateClientMessage),
+    }
+}
+
+/// Check for misbehaviour on the client state as part of the client state
+/// validation process.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateValidation`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+///
+/// This method covers the following cases:
+///
+/// 1 - fork:
+/// Assumes at least one consensus state before the fork point exists. Let
+/// existing consensus states on chain B be: [Sn,.., Sf, Sf-1, S0] with
+/// `Sf-1` being the most recent state before fork. Chain A is queried for a
+/// header `Hf'` at `Sf.height` and if it is different than the `Hf` in the
+/// event for the client update (the one that has generated `Sf` on chain),
+/// then the two headers are included in the evidence and submitted. Note
+/// that in this case the headers are different but have the same height.
+///
+/// 2 - BFT time violation for unavailable header (a.k.a. Future Lunatic
+/// Attack or FLA):
+/// Some header with a height that is higher than the latest height on A has
+/// been accepted and a consensus state was created on B. Note that this
+/// implies that the timestamp of this header must be within the
+/// `clock_drift` of the client. Assume the client on B has been updated
+/// with `h2`(not present on/ produced by chain A) and it has a timestamp of
+/// `t2` that is at most `clock_drift` in the future. Then the latest header
+/// from A is fetched, let it be `h1`, with a timestamp of `t1`. If `t1 >=
+/// t2` then evidence of misbehavior is submitted to A.
+///
+/// 3 - BFT time violation for existing headers:
+/// Ensure that consensus state times are monotonically increasing with
+/// height.
+pub fn check_for_misbehaviour<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+    client_message: Any,
+) -> Result<bool, ClientError>
+where
+    V: ClientValidationContext + TmValidationContext,
+{
+    match client_message.type_url.as_str() {
+        TENDERMINT_HEADER_TYPE_URL => {
+            let header = TmHeader::try_from(client_message)?;
+            check_for_misbehaviour_update_client(client_state, ctx, client_id, header)
+        }
+        TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
+            let misbehaviour = TmMisbehaviour::try_from(client_message)?;
+            check_for_misbehaviour_misbehavior(&misbehaviour)
+        }
+        _ => Err(ClientError::InvalidUpdateClientMessage),
+    }
+}
+
+/// Query the status of the client state.
+///
+/// Note that this function is typically implemented as part of the
+/// [`ClientStateValidation`] trait, but has been made a standalone function
+/// in order to make the ClientState APIs more flexible.
+pub fn status<V>(
+    client_state: &ClientStateType,
+    ctx: &V,
+    client_id: &ClientId,
+) -> Result<Status, ClientError>
+where
+    V: ClientValidationContext + TmValidationContext,
+{
+    if client_state.is_frozen() {
+        return Ok(Status::Frozen);
+    }
+
+    let latest_consensus_state: TmConsensusState = {
+        let any_latest_consensus_state = match ctx.consensus_state(&ClientConsensusStatePath::new(
+            client_id.clone(),
+            client_state.latest_height.revision_number(),
+            client_state.latest_height.revision_height(),
+        )) {
+            Ok(cs) => cs,
+            // if the client state does not have an associated consensus state for its latest height
+            // then it must be expired
+            Err(_) => return Ok(Status::Expired),
+        };
+
+        any_latest_consensus_state
+            .try_into()
+            .map_err(|err| ClientError::Other {
+                description: err.to_string(),
+            })?
+    };
+
+    // Note: if the `duration_since()` is `None`, indicating that the latest
+    // consensus state is in the future, then we don't consider the client
+    // to be expired.
+    let now = ctx.host_timestamp()?;
+
+    if let Some(elapsed_since_latest_consensus_state) =
+        now.duration_since(&latest_consensus_state.timestamp().into())
+    {
+        if elapsed_since_latest_consensus_state > client_state.trusting_period {
+            return Ok(Status::Expired);
+        }
+    }
+
+    Ok(Status::Active)
+}
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
index 020849e57..a09fc705a 100644
--- a/ibc-clients/ics07-tendermint/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -22,7 +22,7 @@ use tendermint::{Hash, Time};
 /// bypass Rust's orphan rules and implement traits from
 /// `ibc::core::client::context` on the `ConsensusState` type.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq)]
+#[derive(Clone, Debug, PartialEq, derive_more::From)]
 pub struct ConsensusState(ConsensusStateType);
 
 impl ConsensusState {
@@ -39,12 +39,6 @@ impl ConsensusState {
     }
 }
 
-impl From<ConsensusStateType> for ConsensusState {
-    fn from(consensus_state: ConsensusStateType) -> Self {
-        Self(consensus_state)
-    }
-}
-
 impl Protobuf<RawTmConsensusState> for ConsensusState {}
 
 impl TryFrom<RawTmConsensusState> for ConsensusState {
diff --git a/ibc-clients/ics07-tendermint/src/context.rs b/ibc-clients/ics07-tendermint/src/context.rs
index 1e190f5b6..cd998f6df 100644
--- a/ibc-clients/ics07-tendermint/src/context.rs
+++ b/ibc-clients/ics07-tendermint/src/context.rs
@@ -5,6 +5,7 @@ use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
+use tendermint_light_client_verifier::ProdVerifier;
 
 use crate::consensus_state::ConsensusState as TmConsensusState;
 
@@ -56,3 +57,39 @@ pub trait ValidationContext: CommonContext {
 pub trait ExecutionContext: CommonContext + ClientExecutionContext {}
 
 impl<T> ExecutionContext for T where T: CommonContext + ClientExecutionContext {}
+
+/// Specifies the Verifier interface that hosts must adhere to when customizing
+/// Tendermint client verification behaviour.
+///
+/// For users who require custom verification logic, i.e., in situations when
+/// the Tendermint `ProdVerifier` doesn't provide the desired outcome, users
+/// should define a custom verifier struct as a unit struct and then implement
+/// `TmVerifier` for it. Note that the custom verifier does need to also
+/// implement the `tendermint_light_client_verifier::Verifier` trait.
+///
+/// In order to wire up the custom verifier, the `verify_client_message` method
+/// on the `ClientStateValidation` trait must be implemented. The simplest way
+/// to do this is to import and call the standalone `verify_client_message`
+/// function located in the `ibc::clients::tendermint::client_state` module,
+/// passing in your custom verifier type as its `verifier` parameter. The rest
+/// of the methods in the `ClientStateValidation` trait can be implemented by
+/// importing and calling their analogous standalone version from the
+/// `tendermint::client_state` module, unless bespoke logic is desired for any
+/// of those functions.
+pub trait TmVerifier {
+    type Verifier: tendermint_light_client_verifier::Verifier;
+
+    fn verifier(&self) -> Self::Verifier;
+}
+
+/// The default verifier for IBC clients, the Tendermint light client
+/// ProdVerifier, for those users who don't require custom verification logic.
+pub struct DefaultVerifier;
+
+impl TmVerifier for DefaultVerifier {
+    type Verifier = ProdVerifier;
+
+    fn verifier(&self) -> Self::Verifier {
+        ProdVerifier::default()
+    }
+}
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index e88495872..5fbb53189 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -17,7 +17,6 @@ use ibc_proto::Protobuf;
 use tendermint::chain::id::MAX_LENGTH as MaxChainIdLen;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 use tendermint_light_client_verifier::options::Options;
-use tendermint_light_client_verifier::ProdVerifier;
 
 use crate::error::Error;
 use crate::header::Header as TmHeader;
@@ -46,8 +45,6 @@ pub struct ClientState {
     pub upgrade_path: Vec<String>,
     pub allow_update: AllowUpdate,
     pub frozen_height: Option<Height>,
-    #[cfg_attr(feature = "serde", serde(skip))]
-    pub verifier: ProdVerifier,
 }
 
 impl ClientState {
@@ -75,7 +72,6 @@ impl ClientState {
             upgrade_path,
             allow_update,
             frozen_height,
-            verifier: ProdVerifier::default(),
         }
     }
 
diff --git a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
index e0cdb9b81..9f32348eb 100644
--- a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
+++ b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
@@ -50,25 +50,26 @@ pub trait ValidateSelfClientContext {
             ));
         }
 
+        let latest_height = tm_client_state.latest_height();
         let self_revision_number = self_chain_id.revision_number();
-        if self_revision_number != tm_client_state.latest_height().revision_number() {
+        if self_revision_number != latest_height.revision_number() {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client is not in the same revision as the chain. expected: {}, got: {}",
                         self_revision_number,
-                        tm_client_state.latest_height().revision_number()
+                        latest_height.revision_number()
                     ),
                 },
             ));
         }
 
-        if tm_client_state.latest_height() >= self.host_current_height() {
+        if latest_height >= self.host_current_height() {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client has latest height {} greater than or equal to chain height {}",
-                        tm_client_state.latest_height(),
+                        latest_height,
                         self.host_current_height()
                     ),
                 },
diff --git a/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
index e5f7ad7be..27ce9e34c 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -4,6 +4,7 @@ use derive_more::{From, TryInto};
 use ibc::clients::tendermint::client_state::ClientState as TmClientState;
 use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
 use ibc::clients::tendermint::types::{
+    ClientState as ClientStateType, ConsensusState as ConsensusStateType,
     TENDERMINT_CLIENT_STATE_TYPE_URL, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
 };
 use ibc::core::client::types::error::ClientError;
@@ -54,6 +55,18 @@ impl From<AnyClientState> for Any {
     }
 }
 
+impl From<ClientStateType> for AnyClientState {
+    fn from(client_state: ClientStateType) -> Self {
+        AnyClientState::Tendermint(client_state.into())
+    }
+}
+
+impl From<ConsensusStateType> for AnyConsensusState {
+    fn from(consensus_state: ConsensusStateType) -> Self {
+        AnyConsensusState::Tendermint(consensus_state.into())
+    }
+}
+
 #[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
 pub enum AnyConsensusState {
     Tendermint(TmConsensusState),

From 65d84464842b3620f0bd66a07af30705bfa37761 Mon Sep 17 00:00:00 2001
From: Emmanuel Ekpenyong <39572181+gr4yha7@users.noreply.github.com>
Date: Fri, 1 Mar 2024 17:56:08 +0100
Subject: [PATCH 122/182] fix(ibc-clients/tendermint): disallow empty
 proof-specs and empty depth range in proof-specs (#1104)

* fix: disallow empty proof-specs and empty depth range in proof-specs

* chore: add changelog entry

* nits

* test: add unit test

* chore: use default option (none)

* avoid new var

* nit in changelog

* rm redundant clone

* propagate errors

* proof depth is unsigned

* use impl method

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 ...-fix-tendermint-empty-proof-specs-check.md |  2 ++
 .../types/src/client_state.rs                 | 24 +++++++++++++------
 .../ics07-tendermint/types/src/error.rs       |  9 +++++++
 ibc-core/ics23-commitment/types/src/error.rs  |  4 ++++
 ibc-core/ics23-commitment/types/src/specs.rs  | 20 ++++++++++++++++
 5 files changed, 52 insertions(+), 7 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md

diff --git a/.changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md b/.changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md
new file mode 100644
index 000000000..b4a3aa542
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md
@@ -0,0 +1,2 @@
+- [ibc-client-tendermint-types] Check ics23 proof specs for empty depth range.
+  ([\#1100](https://github.com/cosmos/ibc-rs/issues/1100))
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 5fbb53189..98ed61132 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -176,12 +176,8 @@ impl ClientState {
             });
         }
 
-        // Disallow empty proof-specs
-        if self.proof_specs.is_empty() {
-            return Err(Error::Validation {
-                reason: "ClientState proof-specs cannot be empty".to_string(),
-            });
-        }
+        // Sanity checks on client proof specs
+        self.proof_specs.validate()?;
 
         // `upgrade_path` itself may be empty, but if not then each key must be non-empty
         for (idx, key) in self.upgrade_path.iter().enumerate() {
@@ -565,7 +561,21 @@ mod tests {
             Test {
                 name: "Invalid (empty) proof specs".to_string(),
                 params: ClientStateParams {
-                    proof_specs: ProofSpecs::from(Vec::<Ics23ProofSpec>::new()),
+                    proof_specs: Vec::<Ics23ProofSpec>::new().into(),
+                    ..default_params.clone()
+                },
+                want_pass: false,
+            },
+            Test {
+                name: "Invalid (empty) proof specs depth range".to_string(),
+                params: ClientStateParams {
+                    proof_specs: vec![Ics23ProofSpec {
+                        leaf_spec: None,
+                        inner_spec: None,
+                        min_depth: 2,
+                        max_depth: 1,
+                        prehash_key_before_comparison: false,
+                    }].into(),
                     ..default_params
                 },
                 want_pass: false,
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index 556d5e6fe..3e2a51112 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -5,6 +5,7 @@ use core::time::Duration;
 use displaydoc::Display;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::Height;
+use ibc_core_commitment_types::error::CommitmentError;
 use ibc_core_host_types::error::IdentifierError;
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_primitives::prelude::*;
@@ -35,6 +36,8 @@ pub enum Error {
     MissingSignedHeader,
     /// invalid header, failed basic validation: `{reason}`
     Validation { reason: String },
+    /// invalid client proof specs: `{0}`
+    InvalidProofSpec(CommitmentError),
     /// invalid raw client state: `{reason}`
     InvalidRawClientState { reason: String },
     /// missing validator set
@@ -119,6 +122,12 @@ impl From<IdentifierError> for Error {
     }
 }
 
+impl From<CommitmentError> for Error {
+    fn from(e: CommitmentError) -> Self {
+        Self::InvalidProofSpec(e)
+    }
+}
+
 pub trait IntoResult<T, E> {
     fn into_result(self) -> Result<T, E>;
 }
diff --git a/ibc-core/ics23-commitment/types/src/error.rs b/ibc-core/ics23-commitment/types/src/error.rs
index 88625226f..0d9cf21b1 100644
--- a/ibc-core/ics23-commitment/types/src/error.rs
+++ b/ibc-core/ics23-commitment/types/src/error.rs
@@ -13,6 +13,10 @@ pub enum CommitmentError {
     EmptyMerkleRoot,
     /// empty verified value
     EmptyVerifiedValue,
+    /// empty proof specs
+    EmptyProofSpecs,
+    /// invalid depth range: [{0}, {1}]
+    InvalidDepthRange(i32, i32),
     /// mismatch between the number of proofs with that of specs
     NumberOfSpecsMismatch,
     /// mismatch between the number of proofs with that of keys
diff --git a/ibc-core/ics23-commitment/types/src/specs.rs b/ibc-core/ics23-commitment/types/src/specs.rs
index 3c2b1df75..2e18094a0 100644
--- a/ibc-core/ics23-commitment/types/src/specs.rs
+++ b/ibc-core/ics23-commitment/types/src/specs.rs
@@ -2,6 +2,8 @@
 
 use ibc_primitives::prelude::*;
 use ibc_proto::ics23::{InnerSpec as RawInnerSpec, LeafOp as RawLeafOp, ProofSpec as RawProofSpec};
+
+use crate::error::CommitmentError;
 /// An array of proof specifications.
 ///
 /// This type encapsulates different types of proof specifications, mostly predefined, e.g., for
@@ -23,6 +25,24 @@ impl ProofSpecs {
     pub fn is_empty(&self) -> bool {
         self.0.is_empty()
     }
+
+    pub fn validate(&self) -> Result<(), CommitmentError> {
+        if self.is_empty() {
+            return Err(CommitmentError::EmptyProofSpecs);
+        }
+        for proof_spec in &self.0 {
+            if proof_spec.0.max_depth < proof_spec.0.min_depth
+                || proof_spec.0.min_depth < 0
+                || proof_spec.0.max_depth < 0
+            {
+                return Err(CommitmentError::InvalidDepthRange(
+                    proof_spec.0.min_depth,
+                    proof_spec.0.max_depth,
+                ));
+            }
+        }
+        Ok(())
+    }
 }
 
 impl Default for ProofSpecs {

From 4f0ab6aaee3b4a1014fffbbcc58e87a75ea24c56 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 7 Mar 2024 20:29:49 -0800
Subject: [PATCH 123/182] imp(api)!: refactor client relevant APIs to allow
 independent ICS-02 integration (#1115)

* imp: refactor client-related APIs to allow independent ICS-02 integration

* chore: add unclog

* imp: keep self methods in ICS24 context + better signature for validate_self_client

* nit: revert naming to host_consensus_state

* imp: use client prelude for context relevant imports

* nit: rename to HostClient/ConsensusState

* imp: use trait bounds instead of ClientStateMut

* imp: move away from AnyConsensusState assoc type at ICS07

* docs: add a docstring for client_update_meta

* chore: further clean-ups

* fix: revert to the initial design approach using ClientStateMut
---
 .../1114-refactor-client-relevant-apis.md     |   3 +
 ci/no-std-check/Cargo.lock                    |   1 +
 .../src/client_state/execution.rs             |  70 +++++----
 .../src/client_state/misbehaviour.rs          |  19 +--
 .../src/client_state/update_client.rs         |  37 ++---
 .../src/client_state/validation.rs            |  34 ++---
 ibc-clients/ics07-tendermint/src/context.rs   |  57 +++++---
 .../ics02-client/context/src/client_state.rs  |  12 +-
 ibc-core/ics02-client/context/src/context.rs  |  47 ++++--
 ibc-core/ics02-client/context/src/lib.rs      |   7 +
 .../ics02-client/src/handler/create_client.rs |  26 ++--
 .../ics02-client/src/handler/update_client.rs |  41 ++----
 .../src/handler/upgrade_client.rs             |  19 +--
 ibc-core/ics03-connection/src/delay.rs        |   2 +-
 .../src/handler/conn_open_ack.rs              |  17 ++-
 .../src/handler/conn_open_confirm.rs          |  12 +-
 .../src/handler/conn_open_init.rs             |   8 +-
 .../src/handler/conn_open_try.rs              |  18 ++-
 ibc-core/ics04-channel/src/context.rs         |  36 +----
 .../src/handler/acknowledgement.rs            |  11 +-
 .../src/handler/chan_close_confirm.rs         |  11 +-
 .../src/handler/chan_close_init.rs            |   7 +-
 .../src/handler/chan_open_ack.rs              |   9 +-
 .../src/handler/chan_open_confirm.rs          |   9 +-
 .../src/handler/chan_open_init.rs             |   5 +-
 .../src/handler/chan_open_try.rs              |   9 +-
 .../ics04-channel/src/handler/recv_packet.rs  |   9 +-
 .../ics04-channel/src/handler/send_packet.rs  |  10 +-
 ibc-core/ics04-channel/src/handler/timeout.rs |   9 +-
 .../src/handler/timeout_on_close.rs           |   9 +-
 .../cosmos/src/upgrade_proposal/context.rs    |  21 +--
 .../cosmos/src/upgrade_proposal/handler.rs    |   3 +-
 .../cosmos/src/upgrade_proposal/mod.rs        |   2 +-
 .../cosmos/src/validate_self_client.rs        |  55 ++++---
 ibc-core/ics24-host/src/context.rs            |  63 ++++----
 ibc-core/ics25-handler/src/entrypoint.rs      |   9 +-
 ibc-query/src/core/channel/query.rs           |  13 +-
 ibc-query/src/core/channel/service.rs         |  11 +-
 ibc-query/src/core/client/query.rs            |  30 ++--
 ibc-query/src/core/client/service.rs          |  24 ++-
 ibc-query/src/core/connection/query.rs        |  15 +-
 ibc-query/src/core/connection/service.rs      |  11 +-
 ibc-query/src/core/context.rs                 |   8 +-
 ibc-testkit/src/relayer/context.rs            |   1 +
 .../testapp/ibc/clients/mock/client_state.rs  |  59 ++++----
 ibc-testkit/src/testapp/ibc/clients/mod.rs    |  31 +++-
 .../src/testapp/ibc/core/client_ctx.rs        |  91 +++++++-----
 ibc-testkit/src/testapp/ibc/core/core_ctx.rs  | 137 ++++++------------
 .../tests/core/ics02_client/create_client.rs  |   7 +-
 .../tests/core/ics02_client/update_client.rs  |   6 +-
 .../tests/core/ics02_client/upgrade_client.rs |   2 +-
 51 files changed, 582 insertions(+), 581 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md

diff --git a/.changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md b/.changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md
new file mode 100644
index 000000000..42bf3fa7e
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md
@@ -0,0 +1,3 @@
+- [ibc] Refactor client relevant APIs for improved modularity and allow
+  standalone ICS-02 integration
+  ([\#1114](https://github.com/cosmos/ibc-rs/issues/1114))
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 038afd5a6..fb12ae90c 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1306,6 +1306,7 @@ dependencies = [
 name = "ibc-client-tendermint"
 version = "0.50.0"
 dependencies = [
+ "derive_more",
  "ibc-client-tendermint-types",
  "ibc-core-client",
  "ibc-core-commitment-types",
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index 0cc6c436d..c42950ca0 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -1,25 +1,25 @@
 use ibc_client_tendermint_types::{
     ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
 };
-use ibc_core_client::context::client_state::ClientStateExecution;
-use ibc_core_client::context::ClientExecutionContext;
+use ibc_core_client::context::prelude::*;
 use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::Height;
 use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::{ClientConsensusStatePath, ClientStatePath};
-use ibc_core_host::ExecutionContext;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
 use super::ClientState;
-use crate::consensus_state::ConsensusState as TmConsensusState;
-use crate::context::{CommonContext, ExecutionContext as TmExecutionContext};
+use crate::context::{
+    ConsensusStateConverter, ExecutionContext as TmExecutionContext,
+    ValidationContext as TmValidationContext,
+};
 
 impl<E> ClientStateExecution<E> for ClientState
 where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     fn initialise(
         &self,
@@ -77,12 +77,12 @@ pub fn initialise<E>(
     consensus_state: Any,
 ) -> Result<(), ClientError>
 where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
-    let host_timestamp = CommonContext::host_timestamp(ctx)?;
-    let host_height = CommonContext::host_height(ctx)?;
+    let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
+    let host_height = TmValidationContext::host_height(ctx)?;
 
     let tm_consensus_state = ConsensusStateType::try_from(consensus_state)?;
 
@@ -122,9 +122,9 @@ pub fn update_state<E>(
     header: Any,
 ) -> Result<Vec<Height>, ClientError>
 where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     let header = TmHeader::try_from(header)?;
     let header_height = header.height();
@@ -138,7 +138,7 @@ where
             header_height.revision_height(),
         );
 
-        CommonContext::consensus_state(ctx, &path_at_header_height).ok()
+        ctx.consensus_state(&path_at_header_height).ok()
     };
 
     if maybe_existing_consensus_state.is_some() {
@@ -147,8 +147,8 @@ where
         //
         // Do nothing.
     } else {
-        let host_timestamp = CommonContext::host_timestamp(ctx)?;
-        let host_height = CommonContext::host_height(ctx)?;
+        let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
+        let host_height = TmValidationContext::host_height(ctx)?;
 
         let new_consensus_state = ConsensusStateType::from(header.clone());
         let new_client_state = client_state.clone().with_header(header)?;
@@ -189,9 +189,9 @@ pub fn update_on_misbehaviour<E>(
     _client_message: Any,
 ) -> Result<(), ClientError>
 where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     // NOTE: frozen height is  set to `Height {revision_height: 0,
     // revision_number: 1}` and it is the same for all misbehaviour. This
@@ -221,12 +221,12 @@ pub fn update_on_upgrade<E>(
     upgraded_consensus_state: Any,
 ) -> Result<Height, ClientError>
 where
-    E: TmExecutionContext + ExecutionContext,
-    <E as ClientExecutionContext>::AnyClientState: From<ClientStateType>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<ConsensusStateType>,
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     let mut upgraded_tm_client_state = ClientState::try_from(upgraded_client_state)?;
-    let upgraded_tm_cons_state = TmConsensusState::try_from(upgraded_consensus_state)?;
+    let upgraded_tm_cons_state = ConsensusStateType::try_from(upgraded_consensus_state)?;
 
     upgraded_tm_client_state.0.zero_custom_fields();
 
@@ -263,12 +263,12 @@ where
     let new_consensus_state = ConsensusStateType::new(
         sentinel_root.into(),
         upgraded_tm_cons_state.timestamp(),
-        upgraded_tm_cons_state.next_validators_hash(),
+        upgraded_tm_cons_state.next_validators_hash,
     );
 
     let latest_height = new_client_state.latest_height;
-    let host_timestamp = CommonContext::host_timestamp(ctx)?;
-    let host_height = CommonContext::host_height(ctx)?;
+    let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
+    let host_height = TmValidationContext::host_height(ctx)?;
 
     ctx.store_client_state(
         ClientStatePath::new(client_id.clone()),
@@ -301,7 +301,9 @@ pub fn prune_oldest_consensus_state<E>(
     client_id: &ClientId,
 ) -> Result<(), ClientError>
 where
-    E: ClientExecutionContext + CommonContext,
+    E: ClientExecutionContext + TmValidationContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     let mut heights = ctx.consensus_state_heights(client_id)?;
 
@@ -313,12 +315,8 @@ where
             height.revision_number(),
             height.revision_height(),
         );
-        let consensus_state = CommonContext::consensus_state(ctx, &client_consensus_state_path)?;
-        let tm_consensus_state = consensus_state
-            .try_into()
-            .map_err(|err| ClientError::Other {
-                description: err.to_string(),
-            })?;
+        let consensus_state = ctx.consensus_state(&client_consensus_state_path)?;
+        let tm_consensus_state = consensus_state.try_into()?;
 
         let host_timestamp =
             ctx.host_timestamp()?
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 777bca1da..63d4c47b0 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -11,7 +11,7 @@ use ibc_primitives::Timestamp;
 use tendermint_light_client_verifier::Verifier;
 
 use super::TmValidationContext;
-use crate::context::TmVerifier;
+use crate::context::{ConsensusStateConverter, TmVerifier};
 
 /// Determines whether or not two conflicting headers at the same height would
 /// have convinced the light client.
@@ -24,6 +24,7 @@ pub fn verify_misbehaviour<V>(
 ) -> Result<(), ClientError>
 where
     V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     misbehaviour.validate_basic()?;
 
@@ -36,11 +37,7 @@ where
         );
         let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
-        consensus_state
-            .try_into()
-            .map_err(|err| ClientError::Other {
-                description: err.to_string(),
-            })?
+        consensus_state.try_into()?
     };
 
     let header_2 = misbehaviour.header2();
@@ -52,11 +49,7 @@ where
         );
         let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
-        consensus_state
-            .try_into()
-            .map_err(|err| ClientError::Other {
-                description: err.to_string(),
-            })?
+        consensus_state.try_into()?
     };
 
     let current_timestamp = ctx.host_timestamp()?;
@@ -64,14 +57,14 @@ where
     verify_misbehaviour_header(
         client_state,
         header_1,
-        trusted_consensus_state_1.inner(),
+        &trusted_consensus_state_1,
         current_timestamp,
         verifier,
     )?;
     verify_misbehaviour_header(
         client_state,
         header_2,
-        trusted_consensus_state_2.inner(),
+        &trusted_consensus_state_2,
         current_timestamp,
         verifier,
     )
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index b5be61f49..d6dbaa2c8 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -9,8 +9,9 @@ use ibc_primitives::prelude::*;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
-use crate::consensus_state::ConsensusState as TmConsensusState;
-use crate::context::{TmVerifier, ValidationContext as TmValidationContext};
+use crate::context::{
+    ConsensusStateConverter, TmVerifier, ValidationContext as TmValidationContext,
+};
 
 pub fn verify_header<V>(
     client_state: &ClientStateType,
@@ -21,6 +22,7 @@ pub fn verify_header<V>(
 ) -> Result<(), ClientError>
 where
     V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     // Checks that the header fields are valid.
     header.validate_basic()?;
@@ -38,14 +40,11 @@ where
                 header.trusted_height.revision_number(),
                 header.trusted_height.revision_height(),
             );
-            let trusted_consensus_state: TmConsensusState = ctx
+            let trusted_consensus_state = ctx
                 .consensus_state(&trusted_client_cons_state_path)?
-                .try_into()
-                .map_err(|err| ClientError::Other {
-                    description: err.to_string(),
-                })?;
+                .try_into()?;
 
-            header.check_trusted_next_validator_set(trusted_consensus_state.inner())?;
+            header.check_trusted_next_validator_set(&trusted_consensus_state)?;
 
             TrustedBlockState {
                 chain_id: &client_state.chain_id.to_string().try_into().map_err(|e| {
@@ -65,7 +64,7 @@ where
                         .to_string(),
                     })?,
                 next_validators: &header.trusted_next_validator_set,
-                next_validators_hash: trusted_consensus_state.next_validators_hash(),
+                next_validators_hash: trusted_consensus_state.next_validators_hash,
             }
         };
 
@@ -106,6 +105,7 @@ pub fn check_for_misbehaviour_update_client<V>(
 ) -> Result<bool, ClientError>
 where
     V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     let maybe_existing_consensus_state = {
         let path_at_header_height = ClientConsensusStatePath::new(
@@ -119,15 +119,9 @@ where
 
     match maybe_existing_consensus_state {
         Some(existing_consensus_state) => {
-            let existing_consensus_state =
-                existing_consensus_state
-                    .try_into()
-                    .map_err(|err| ClientError::Other {
-                        description: err.to_string(),
-                    })?;
+            let existing_consensus_state = existing_consensus_state.try_into()?;
 
-            let header_consensus_state =
-                TmConsensusState::from(ConsensusStateType::from(header.clone()));
+            let header_consensus_state = ConsensusStateType::from(header.clone());
 
             // There is evidence of misbehaviour if the stored consensus state
             // is different from the new one we received.
@@ -144,10 +138,7 @@ where
                 if let Some(prev_cs) = maybe_prev_cs {
                     // New header timestamp cannot occur *before* the
                     // previous consensus state's height
-                    let prev_cs: TmConsensusState =
-                        prev_cs.try_into().map_err(|err| ClientError::Other {
-                            description: err.to_string(),
-                        })?;
+                    let prev_cs = prev_cs.try_into()?;
 
                     if header.signed_header.header().time <= prev_cs.timestamp() {
                         return Ok(true);
@@ -163,9 +154,7 @@ where
                 if let Some(next_cs) = maybe_next_cs {
                     // New (untrusted) header timestamp cannot occur *after* next
                     // consensus state's height
-                    let next_cs = next_cs.try_into().map_err(|err| ClientError::Other {
-                        description: err.to_string(),
-                    })?;
+                    let next_cs = next_cs.try_into()?;
 
                     if header.signed_header.header().time >= next_cs.timestamp() {
                         return Ok(true);
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 0b79e9d45..876c43a16 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -3,7 +3,6 @@ use ibc_client_tendermint_types::{
     TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
 };
 use ibc_core_client::context::client_state::ClientStateValidation;
-use ibc_core_client::context::ClientValidationContext;
 use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::Status;
 use ibc_core_host::types::identifiers::ClientId;
@@ -15,14 +14,14 @@ use super::{
     check_for_misbehaviour_misbehavior, check_for_misbehaviour_update_client, ClientState,
 };
 use crate::client_state::{verify_header, verify_misbehaviour};
-use crate::consensus_state::ConsensusState as TmConsensusState;
-use crate::context::{DefaultVerifier, TmVerifier, ValidationContext as TmValidationContext};
+use crate::context::{
+    ConsensusStateConverter, DefaultVerifier, TmVerifier, ValidationContext as TmValidationContext,
+};
 
 impl<V> ClientStateValidation<V> for ClientState
 where
-    V: ClientValidationContext + TmValidationContext,
-    V::AnyConsensusState: TryInto<TmConsensusState>,
-    ClientError: From<<V::AnyConsensusState as TryInto<TmConsensusState>>::Error>,
+    V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     /// The default verification logic exposed by ibc-rs simply delegates to a
     /// standalone `verify_client_message` function. This is to make it as simple
@@ -74,7 +73,8 @@ pub fn verify_client_message<V>(
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
-    V: ClientValidationContext + TmValidationContext,
+    V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
@@ -128,7 +128,8 @@ pub fn check_for_misbehaviour<V>(
     client_message: Any,
 ) -> Result<bool, ClientError>
 where
-    V: ClientValidationContext + TmValidationContext,
+    V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
@@ -154,29 +155,24 @@ pub fn status<V>(
     client_id: &ClientId,
 ) -> Result<Status, ClientError>
 where
-    V: ClientValidationContext + TmValidationContext,
+    V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     if client_state.is_frozen() {
         return Ok(Status::Frozen);
     }
 
-    let latest_consensus_state: TmConsensusState = {
-        let any_latest_consensus_state = match ctx.consensus_state(&ClientConsensusStatePath::new(
+    let latest_consensus_state = {
+        match ctx.consensus_state(&ClientConsensusStatePath::new(
             client_id.clone(),
             client_state.latest_height.revision_number(),
             client_state.latest_height.revision_height(),
         )) {
-            Ok(cs) => cs,
+            Ok(cs) => cs.try_into()?,
             // if the client state does not have an associated consensus state for its latest height
             // then it must be expired
             Err(_) => return Ok(Status::Expired),
-        };
-
-        any_latest_consensus_state
-            .try_into()
-            .map_err(|err| ClientError::Other {
-                description: err.to_string(),
-            })?
+        }
     };
 
     // Note: if the `duration_since()` is `None`, indicating that the latest
diff --git a/ibc-clients/ics07-tendermint/src/context.rs b/ibc-clients/ics07-tendermint/src/context.rs
index cd998f6df..9b61df1d7 100644
--- a/ibc-clients/ics07-tendermint/src/context.rs
+++ b/ibc-clients/ics07-tendermint/src/context.rs
@@ -1,62 +1,71 @@
-use ibc_core_client::context::ClientExecutionContext;
+use ibc_client_tendermint_types::ConsensusState as ConsensusStateType;
+use ibc_core_client::context::prelude::*;
+use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::Height;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_host::types::identifiers::ClientId;
-use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
 use tendermint_light_client_verifier::ProdVerifier;
 
-use crate::consensus_state::ConsensusState as TmConsensusState;
+/// Enables conversion (`TryInto` and `From`) between the consensus state type
+/// used by the host and the one specific to the Tendermint light client, which
+/// is `ConsensusStateType`.
+pub trait ConsensusStateConverter:
+    TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
+{
+}
 
-/// Client's context required during both validation and execution
-pub trait CommonContext {
-    type ConversionError: ToString;
-    type AnyConsensusState: TryInto<TmConsensusState, Error = Self::ConversionError>;
+impl<C> ConsensusStateConverter for C where
+    C: TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
+{
+}
 
+/// Client's context required during validation
+pub trait ValidationContext: ClientValidationContext
+where
+    Self::ConsensusStateRef: ConsensusStateConverter,
+{
     /// Returns the current timestamp of the local chain.
     fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
 
     /// Returns the current height of the local chain.
     fn host_height(&self) -> Result<Height, ContextError>;
 
-    /// Retrieve the consensus state for the given client ID at the specified
-    /// height.
-    ///
-    /// Returns an error if no such state exists.
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError>;
-
     /// Returns all the heights at which a consensus state is stored
     fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
-}
 
-/// Client's context required during validation
-pub trait ValidationContext: CommonContext {
     /// Search for the lowest consensus state higher than `height`.
     fn next_consensus_state(
         &self,
         client_id: &ClientId,
         height: &Height,
-    ) -> Result<Option<Self::AnyConsensusState>, ContextError>;
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
 
     /// Search for the highest consensus state lower than `height`.
     fn prev_consensus_state(
         &self,
         client_id: &ClientId,
         height: &Height,
-    ) -> Result<Option<Self::AnyConsensusState>, ContextError>;
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
 }
 
 /// Client's context required during execution.
 ///
 /// This trait is automatically implemented for all types that implement
-/// [`CommonContext`] and [`ClientExecutionContext`]
-pub trait ExecutionContext: CommonContext + ClientExecutionContext {}
+/// [`ValidationContext`] and [`ClientExecutionContext`]
+pub trait ExecutionContext: ValidationContext + ClientExecutionContext
+where
+    Self::ConsensusStateRef: ConsensusStateConverter,
+{
+}
 
-impl<T> ExecutionContext for T where T: CommonContext + ClientExecutionContext {}
+impl<T> ExecutionContext for T
+where
+    T: ValidationContext + ClientExecutionContext,
+    T::ConsensusStateRef: ConsensusStateConverter,
+{
+}
 
 /// Specifies the Verifier interface that hosts must adhere to when customizing
 /// Tendermint client verification behaviour.
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index 0616d0bd4..0d1c57a37 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -10,11 +10,17 @@ use ibc_core_host_types::path::Path;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
+/// Convenient trait to decode a client state from an `Any` type and obtain a
+/// handle to the local instance of `ClientState`.
+pub trait ClientStateDecoder: Into<Any> + TryFrom<Any, Error = ClientError> {}
+
+impl<T> ClientStateDecoder for T where T: Into<Any> + TryFrom<Any, Error = ClientError> {}
+
 /// `ClientState` methods needed in both validation and execution.
 ///
 /// They do not require access to a client `ValidationContext` nor
 /// `ExecutionContext`.
-pub trait ClientStateCommon {
+pub trait ClientStateCommon: ClientStateDecoder {
     /// Performs basic validation on the `consensus_state`.
     ///
     /// Notably, an implementation should verify that it can properly
@@ -90,7 +96,7 @@ pub trait ClientStateCommon {
 ///   // My Context methods
 /// }
 /// ```
-pub trait ClientStateValidation<V>
+pub trait ClientStateValidation<V>: ClientStateCommon
 where
     V: ClientValidationContext,
 {
@@ -126,7 +132,7 @@ where
 /// The generic type `E` enables light client developers to expand the set of
 /// methods available under the [`ClientExecutionContext`] trait and use them in
 /// their implementation for executing a client state transition.
-pub trait ClientStateExecution<E>
+pub trait ClientStateExecution<E>: ClientStateValidation<E>
 where
     E: ClientExecutionContext,
 {
diff --git a/ibc-core/ics02-client/context/src/context.rs b/ibc-core/ics02-client/context/src/context.rs
index a09673bb7..1b4e98e52 100644
--- a/ibc-core/ics02-client/context/src/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -4,17 +4,36 @@ use ibc_core_host_types::identifiers::ClientId;
 use ibc_core_host_types::path::{ClientConsensusStatePath, ClientStatePath};
 use ibc_primitives::Timestamp;
 
-use super::client_state::ClientState;
-use super::consensus_state::ConsensusState;
+use crate::client_state::{ClientStateExecution, ClientStateValidation};
+use crate::consensus_state::ConsensusState;
 
 /// Defines the methods available to clients for validating client state
 /// transitions. The generic `V` parameter in
 /// [crate::client_state::ClientStateValidation] must
 /// inherit from this trait.
-pub trait ClientValidationContext {
-    /// Returns the time and height when the client state for the given
-    /// [`ClientId`] was updated with a header for the given [`Height`]
-    fn update_meta(
+pub trait ClientValidationContext: Sized {
+    type ClientStateRef: ClientStateValidation<Self>;
+    type ConsensusStateRef: ConsensusState;
+
+    /// Returns the ClientState for the given identifier `client_id`.
+    ///
+    /// Note: Clients have the responsibility to store client states on client creation and update.
+    fn client_state(&self, client_id: &ClientId) -> Result<Self::ClientStateRef, ContextError>;
+
+    /// Retrieve the consensus state for the given client ID at the specified
+    /// height.
+    ///
+    /// Returns an error if no such state exists.
+    ///
+    /// Note: Clients have the responsibility to store consensus states on client creation and update.
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<Self::ConsensusStateRef, ContextError>;
+
+    /// Returns the timestamp and height of the host when it processed a client
+    /// update request at the specified height.
+    fn client_update_meta(
         &self,
         client_id: &ClientId,
         height: &Height,
@@ -29,23 +48,27 @@ pub trait ClientValidationContext {
 /// Specifically, clients have the responsibility to store their client state
 /// and consensus states. This trait defines a uniform interface to do that for
 /// all clients.
-pub trait ClientExecutionContext: Sized {
-    type V: ClientValidationContext;
-    type AnyClientState: ClientState<Self::V, Self>;
-    type AnyConsensusState: ConsensusState;
+pub trait ClientExecutionContext:
+    ClientValidationContext<ClientStateRef = Self::ClientStateMut>
+{
+    type ClientStateMut: ClientStateExecution<Self>;
+
+    fn client_state_mut(&self, client_id: &ClientId) -> Result<Self::ClientStateMut, ContextError> {
+        self.client_state(client_id)
+    }
 
     /// Called upon successful client creation and update
     fn store_client_state(
         &mut self,
         client_state_path: ClientStatePath,
-        client_state: Self::AnyClientState,
+        client_state: Self::ClientStateRef,
     ) -> Result<(), ContextError>;
 
     /// Called upon successful client creation and update
     fn store_consensus_state(
         &mut self,
         consensus_state_path: ClientConsensusStatePath,
-        consensus_state: Self::AnyConsensusState,
+        consensus_state: Self::ConsensusStateRef,
     ) -> Result<(), ContextError>;
 
     /// Delete the consensus state from the store located at the given `ClientConsensusStatePath`
diff --git a/ibc-core/ics02-client/context/src/lib.rs b/ibc-core/ics02-client/context/src/lib.rs
index 65d41640d..7b873f38f 100644
--- a/ibc-core/ics02-client/context/src/lib.rs
+++ b/ibc-core/ics02-client/context/src/lib.rs
@@ -24,6 +24,13 @@ pub mod consensus_state;
 mod context;
 pub use context::*;
 
+/// Trait preludes for the ICS-02 client implementation.
+pub mod prelude {
+    pub use crate::client_state::*;
+    pub use crate::consensus_state::*;
+    pub use crate::context::*;
+}
+
 pub mod types {
     #[doc(inline)]
     pub use ibc_core_client_types::*;
diff --git a/ibc-core/ics02-client/src/handler/create_client.rs b/ibc-core/ics02-client/src/handler/create_client.rs
index e0a47e05b..4a4148251 100644
--- a/ibc-core/ics02-client/src/handler/create_client.rs
+++ b/ibc-core/ics02-client/src/handler/create_client.rs
@@ -1,14 +1,12 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgCreateClient`.
 
-use ibc_core_client_context::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation,
-};
+use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::events::CreateClient;
 use ibc_core_client_types::msgs::MsgCreateClient;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
-use ibc_core_host::{ExecutionContext, ValidationContext};
+use ibc_core_host::{ClientStateMut, ClientStateRef, ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
 
 pub fn validate<Ctx>(ctx: &Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
@@ -26,11 +24,13 @@ where
     // Construct this client's identifier
     let id_counter = ctx.client_counter()?;
 
-    let client_state = ctx.decode_client_state(client_state)?;
+    let client_val_ctx = ctx.get_client_validation_context();
+
+    let client_state = ClientStateRef::<Ctx>::try_from(client_state)?;
 
     let client_id = client_state.client_type().build_client_id(id_counter);
 
-    let status = client_state.status(ctx.get_client_validation_context(), &client_id)?;
+    let status = client_state.status(client_val_ctx, &client_id)?;
 
     if status.is_frozen() {
         return Err(ClientError::ClientFrozen {
@@ -41,7 +41,7 @@ where
 
     client_state.verify_consensus_state(consensus_state)?;
 
-    if ctx.client_state(&client_id).is_ok() {
+    if client_val_ctx.client_state(&client_id).is_ok() {
         return Err(ClientError::ClientStateAlreadyExists { client_id }.into());
     };
 
@@ -60,15 +60,15 @@ where
 
     // Construct this client's identifier
     let id_counter = ctx.client_counter()?;
-    let client_state = ctx.decode_client_state(client_state)?;
+
+    let client_exec_ctx = ctx.get_client_execution_context();
+
+    let client_state = ClientStateMut::<Ctx>::try_from(client_state)?;
+
     let client_type = client_state.client_type();
     let client_id = client_type.build_client_id(id_counter);
 
-    client_state.initialise(
-        ctx.get_client_execution_context(),
-        &client_id,
-        consensus_state,
-    )?;
+    client_state.initialise(client_exec_ctx, &client_id, consensus_state)?;
 
     ctx.increase_client_counter()?;
 
diff --git a/ibc-core/ics02-client/src/handler/update_client.rs b/ibc-core/ics02-client/src/handler/update_client.rs
index bb00372c6..81e140b8a 100644
--- a/ibc-core/ics02-client/src/handler/update_client.rs
+++ b/ibc-core/ics02-client/src/handler/update_client.rs
@@ -1,8 +1,6 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpdateAnyClient`.
 
-use ibc_core_client_context::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation,
-};
+use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::events::{ClientMisbehaviour, UpdateClient};
 use ibc_core_client_types::msgs::MsgUpdateOrMisbehaviour;
@@ -21,20 +19,18 @@ where
 
     let client_id = msg.client_id().clone();
 
+    let client_val_ctx = ctx.get_client_validation_context();
+
     // Read client state from the host chain store. The client should already exist.
-    let client_state = ctx.client_state(&client_id)?;
+    let client_state = client_val_ctx.client_state(&client_id)?;
 
     client_state
-        .status(ctx.get_client_validation_context(), &client_id)?
+        .status(client_val_ctx, &client_id)?
         .verify_is_active()?;
 
     let client_message = msg.client_message();
 
-    client_state.verify_client_message(
-        ctx.get_client_validation_context(),
-        &client_id,
-        client_message,
-    )?;
+    client_state.verify_client_message(client_val_ctx, &client_id, client_message)?;
 
     Ok(())
 }
@@ -49,20 +45,16 @@ where
         MsgUpdateOrMisbehaviour::Misbehaviour(_) => UpdateKind::SubmitMisbehaviour,
     };
     let client_message = msg.client_message();
-    let client_state = ctx.client_state(&client_id)?;
 
-    let found_misbehaviour = client_state.check_for_misbehaviour(
-        ctx.get_client_validation_context(),
-        &client_id,
-        client_message.clone(),
-    )?;
+    let client_exec_ctx = ctx.get_client_execution_context();
+
+    let client_state = client_exec_ctx.client_state(&client_id)?;
+
+    let found_misbehaviour =
+        client_state.check_for_misbehaviour(client_exec_ctx, &client_id, client_message.clone())?;
 
     if found_misbehaviour {
-        client_state.update_state_on_misbehaviour(
-            ctx.get_client_execution_context(),
-            &client_id,
-            client_message,
-        )?;
+        client_state.update_state_on_misbehaviour(client_exec_ctx, &client_id, client_message)?;
 
         let event = IbcEvent::ClientMisbehaviour(ClientMisbehaviour::new(
             client_id,
@@ -80,11 +72,8 @@ where
 
         let header = client_message;
 
-        let consensus_heights = client_state.update_state(
-            ctx.get_client_execution_context(),
-            &client_id,
-            header.clone(),
-        )?;
+        let consensus_heights =
+            client_state.update_state(client_exec_ctx, &client_id, header.clone())?;
 
         {
             let event = {
diff --git a/ibc-core/ics02-client/src/handler/upgrade_client.rs b/ibc-core/ics02-client/src/handler/upgrade_client.rs
index 5bf1386e4..a072988a2 100644
--- a/ibc-core/ics02-client/src/handler/upgrade_client.rs
+++ b/ibc-core/ics02-client/src/handler/upgrade_client.rs
@@ -1,9 +1,6 @@
 //! Protocol logic specific to processing ICS2 messages of type `MsgUpgradeAnyClient`.
 //!
-use ibc_core_client_context::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation,
-};
-use ibc_core_client_context::consensus_state::ConsensusState;
+use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::events::UpgradeClient;
 use ibc_core_client_types::msgs::MsgUpgradeClient;
@@ -23,12 +20,14 @@ where
 
     ctx.validate_message_signer(&signer)?;
 
+    let client_val_ctx = ctx.get_client_validation_context();
+
     // Read the current latest client state from the host chain store.
-    let old_client_state = ctx.client_state(&client_id)?;
+    let old_client_state = client_val_ctx.client_state(&client_id)?;
 
     // Check if the client is active.
     old_client_state
-        .status(ctx.get_client_validation_context(), &client_id)?
+        .status(client_val_ctx, &client_id)?
         .verify_is_active()?;
 
     // Read the latest consensus state from the host chain store.
@@ -37,7 +36,7 @@ where
         old_client_state.latest_height().revision_number(),
         old_client_state.latest_height().revision_height(),
     );
-    let old_consensus_state = ctx
+    let old_consensus_state = client_val_ctx
         .consensus_state(&old_client_cons_state_path)
         .map_err(|_| ClientError::ConsensusStateNotFound {
             client_id,
@@ -62,10 +61,12 @@ where
 {
     let MsgUpgradeClient { client_id, .. } = msg;
 
-    let old_client_state = ctx.client_state(&client_id)?;
+    let client_exec_ctx = ctx.get_client_execution_context();
+
+    let old_client_state = client_exec_ctx.client_state(&client_id)?;
 
     let latest_height = old_client_state.update_state_on_upgrade(
-        ctx.get_client_execution_context(),
+        client_exec_ctx,
         &client_id,
         msg.upgraded_client_state.clone(),
         msg.upgraded_consensus_state,
diff --git a/ibc-core/ics03-connection/src/delay.rs b/ibc-core/ics03-connection/src/delay.rs
index feecf23fb..06fb03098 100644
--- a/ibc-core/ics03-connection/src/delay.rs
+++ b/ibc-core/ics03-connection/src/delay.rs
@@ -21,7 +21,7 @@ where
     let client_id = connection_end.client_id();
     let last_client_update = ctx
         .get_client_validation_context()
-        .update_meta(client_id, &packet_proof_height)?;
+        .client_update_meta(client_id, &packet_proof_height)?;
 
     // Fetch the connection delay time and height periods.
     let conn_delay_time_period = connection_end.delay_period();
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index 82b447201..aca9bad68 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -1,7 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenAck`.
 
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenAck;
 use ibc_core_connection_types::msgs::MsgConnectionOpenAck;
@@ -44,7 +43,12 @@ where
         .into());
     }
 
-    ctx_a.validate_self_client(msg.client_state_of_a_on_b.clone())?;
+    let client_val_ctx_a = ctx_a.get_client_validation_context();
+
+    let client_state_of_a_on_b =
+        Ctx::HostClientState::try_from(msg.client_state_of_a_on_b.clone())?;
+
+    ctx_a.validate_self_client(client_state_of_a_on_b)?;
 
     msg.version
         .verify_is_supported(vars.conn_end_on_a.versions())?;
@@ -53,10 +57,10 @@ where
 
     // Proof verification.
     {
-        let client_state_of_b_on_a = ctx_a.client_state(vars.client_id_on_a())?;
+        let client_state_of_b_on_a = client_val_ctx_a.client_state(vars.client_id_on_a())?;
 
         client_state_of_b_on_a
-            .status(ctx_a.get_client_validation_context(), vars.client_id_on_a())?
+            .status(client_val_ctx_a, vars.client_id_on_a())?
             .verify_is_active()?;
         client_state_of_b_on_a.validate_proof_height(msg.proofs_height_on_b)?;
 
@@ -66,7 +70,8 @@ where
             msg.proofs_height_on_b.revision_height(),
         );
 
-        let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
+        let consensus_state_of_b_on_a =
+            client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
 
         let prefix_on_a = ctx_a.commitment_prefix();
         let prefix_on_b = vars.conn_end_on_a.counterparty().prefix();
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
index f265c6029..f9ef4eb61 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_confirm.rs
@@ -1,7 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenConfirm`.
 
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenConfirm;
 use ibc_core_connection_types::msgs::MsgConnectionOpenConfirm;
@@ -42,10 +41,12 @@ where
 
     // Verify proofs
     {
-        let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
+        let client_val_ctx_b = ctx_b.get_client_validation_context();
+
+        let client_state_of_a_on_b = client_val_ctx_b.client_state(client_id_on_b)?;
 
         client_state_of_a_on_b
-            .status(ctx_b.get_client_validation_context(), client_id_on_b)?
+            .status(client_val_ctx_b, client_id_on_b)?
             .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proof_height_on_a)?;
 
@@ -54,7 +55,8 @@ where
             msg.proof_height_on_a.revision_number(),
             msg.proof_height_on_a.revision_height(),
         );
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let prefix_on_b = ctx_b.commitment_prefix();
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_init.rs b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
index 090d1b8b3..8d4286616 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_init.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_init.rs
@@ -1,5 +1,5 @@
 //! Protocol logic specific to ICS3 messages of type `MsgConnectionOpenInit`.
-use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection_types::events::OpenInit;
 use ibc_core_connection_types::msgs::MsgConnectionOpenInit;
 use ibc_core_connection_types::{ConnectionEnd, Counterparty, State};
@@ -16,11 +16,13 @@ where
 {
     ctx_a.validate_message_signer(&msg.signer)?;
 
+    let client_val_ctx_a = ctx_a.get_client_validation_context();
+
     // An IBC client running on the local (host) chain should exist.
-    let client_state_of_b_on_a = ctx_a.client_state(&msg.client_id_on_a)?;
+    let client_state_of_b_on_a = client_val_ctx_a.client_state(&msg.client_id_on_a)?;
 
     client_state_of_b_on_a
-        .status(ctx_a.get_client_validation_context(), &msg.client_id_on_a)?
+        .status(client_val_ctx_a, &msg.client_id_on_a)?
         .verify_is_active()?;
 
     if let Some(version) = msg.version {
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index f19299818..99e15f209 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -1,6 +1,5 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenTry;
 use ibc_core_connection_types::msgs::MsgConnectionOpenTry;
@@ -34,7 +33,12 @@ where
 {
     ctx_b.validate_message_signer(&msg.signer)?;
 
-    ctx_b.validate_self_client(msg.client_state_of_b_on_a.clone())?;
+    let client_val_ctx_b = ctx_b.get_client_validation_context();
+
+    let client_state_of_b_on_a =
+        Ctx::HostClientState::try_from(msg.client_state_of_b_on_a.clone())?;
+
+    ctx_b.validate_self_client(client_state_of_b_on_a)?;
 
     let host_height = ctx_b.host_height().map_err(|_| ConnectionError::Other {
         description: "failed to get host height".to_string(),
@@ -52,10 +56,11 @@ where
 
     // Verify proofs
     {
-        let client_state_of_a_on_b = ctx_b.client_state(vars.conn_end_on_b.client_id())?;
+        let client_state_of_a_on_b =
+            client_val_ctx_b.client_state(vars.conn_end_on_b.client_id())?;
 
         client_state_of_a_on_b
-            .status(ctx_b.get_client_validation_context(), &msg.client_id_on_b)?
+            .status(client_val_ctx_b, &msg.client_id_on_b)?
             .verify_is_active()?;
         client_state_of_a_on_b.validate_proof_height(msg.proofs_height_on_a)?;
 
@@ -65,7 +70,8 @@ where
             msg.proofs_height_on_a.revision_height(),
         );
 
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let prefix_on_a = vars.conn_end_on_b.counterparty().prefix();
         let prefix_on_b = ctx_b.commitment_prefix();
diff --git a/ibc-core/ics04-channel/src/context.rs b/ibc-core/ics04-channel/src/context.rs
index 8dcd05fac..1fba1de8f 100644
--- a/ibc-core/ics04-channel/src/context.rs
+++ b/ibc-core/ics04-channel/src/context.rs
@@ -2,25 +2,18 @@
 
 use ibc_core_channel_types::channel::ChannelEnd;
 use ibc_core_channel_types::commitment::PacketCommitment;
-use ibc_core_client::context::client_state::ClientState;
-use ibc_core_client::context::consensus_state::ConsensusState;
-use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::ConnectionEnd;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::IbcEvent;
-use ibc_core_host::types::identifiers::{ClientId, ConnectionId, Sequence};
-use ibc_core_host::types::path::{
-    ChannelEndPath, ClientConsensusStatePath, CommitmentPath, SeqSendPath,
-};
+use ibc_core_host::types::identifiers::{ConnectionId, Sequence};
+use ibc_core_host::types::path::{ChannelEndPath, CommitmentPath, SeqSendPath};
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
 
 /// Methods required in send packet validation, to be implemented by the host
 pub trait SendPacketValidationContext {
     type V: ClientValidationContext;
-    type E: ClientExecutionContext;
-    type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::V, Self::E>;
 
     /// Retrieve the context that implements all clients' `ValidationContext`.
     fn get_client_validation_context(&self) -> &Self::V;
@@ -31,15 +24,6 @@ pub trait SendPacketValidationContext {
     /// Returns the ConnectionState for the given identifier `connection_id`.
     fn connection_end(&self, connection_id: &ConnectionId) -> Result<ConnectionEnd, ContextError>;
 
-    /// Returns the ClientState for the given identifier `client_id`. Necessary dependency towards
-    /// proof verification.
-    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError>;
-
-    fn client_consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError>;
-
     fn get_next_sequence_send(&self, seq_send_path: &SeqSendPath)
         -> Result<Sequence, ContextError>;
 }
@@ -49,9 +33,6 @@ where
     T: ValidationContext,
 {
     type V = T::V;
-    type E = T::E;
-    type AnyConsensusState = T::AnyConsensusState;
-    type AnyClientState = T::AnyClientState;
 
     fn get_client_validation_context(&self) -> &Self::V {
         self.get_client_validation_context()
@@ -65,17 +46,6 @@ where
         self.connection_end(connection_id)
     }
 
-    fn client_state(&self, client_id: &ClientId) -> Result<T::AnyClientState, ContextError> {
-        self.client_state(client_id)
-    }
-
-    fn client_consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<T::AnyConsensusState, ContextError> {
-        self.consensus_state(client_cons_state_path)
-    }
-
     fn get_next_sequence_send(
         &self,
         seq_send_path: &SeqSendPath,
diff --git a/ibc-core/ics04-channel/src/handler/acknowledgement.rs b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
index 516d581e6..ec6aa41bc 100644
--- a/ibc-core/ics04-channel/src/handler/acknowledgement.rs
+++ b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
@@ -3,8 +3,7 @@ use ibc_core_channel_types::commitment::{compute_ack_commitment, compute_packet_
 use ibc_core_channel_types::error::{ChannelError, PacketError};
 use ibc_core_channel_types::events::AcknowledgePacket;
 use ibc_core_channel_types::msgs::MsgAcknowledgement;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
@@ -175,7 +174,10 @@ where
     // Verify proofs
     {
         let client_id_on_a = conn_end_on_a.client_id();
-        let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+
+        let client_val_ctx_a = ctx_a.get_client_validation_context();
+
+        let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
         client_state_of_b_on_a
             .status(ctx_a.get_client_validation_context(), client_id_on_a)?
@@ -187,7 +189,8 @@ where
             msg.proof_height_on_b.revision_number(),
             msg.proof_height_on_b.revision_height(),
         );
-        let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
+        let consensus_state_of_b_on_a =
+            client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let ack_commitment = compute_ack_commitment(&msg.acknowledgement);
         let ack_path_on_b =
             AckPath::new(&packet.port_id_on_b, &packet.chan_id_on_b, packet.seq_on_a);
diff --git a/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
index dd3b51b06..5385d18c3 100644
--- a/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_confirm.rs
@@ -4,8 +4,7 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as
 use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::CloseConfirm;
 use ibc_core_channel_types::msgs::MsgChannelCloseConfirm;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -112,7 +111,10 @@ where
     // Verify proofs
     {
         let client_id_on_b = conn_end_on_b.client_id();
-        let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
+
+        let client_val_ctx_b = ctx_b.get_client_validation_context();
+
+        let client_state_of_a_on_b = client_val_ctx_b.client_state(client_id_on_b)?;
 
         client_state_of_a_on_b
             .status(ctx_b.get_client_validation_context(), client_id_on_b)?
@@ -124,7 +126,8 @@ where
             msg.proof_height_on_a.revision_number(),
             msg.proof_height_on_a.revision_height(),
         );
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = &chan_end_on_b.counterparty().port_id;
         let chan_id_on_a = chan_end_on_b
diff --git a/ibc-core/ics04-channel/src/handler/chan_close_init.rs b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
index fe7588361..15c38c9f5 100644
--- a/ibc-core/ics04-channel/src/handler/chan_close_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_close_init.rs
@@ -3,7 +3,7 @@ use ibc_core_channel_types::channel::State;
 use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::CloseInit;
 use ibc_core_channel_types::msgs::MsgChannelCloseInit;
-use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -110,7 +110,10 @@ where
     conn_end_on_a.verify_state_matches(&ConnectionState::Open)?;
 
     let client_id_on_a = conn_end_on_a.client_id();
-    let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+
+    let client_val_ctx_a = ctx_a.get_client_validation_context();
+
+    let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
     client_state_of_b_on_a
         .status(ctx_a.get_client_validation_context(), client_id_on_a)?
         .verify_is_active()?;
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_ack.rs b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
index 5bf0e3211..7e5b6b240 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_ack.rs
@@ -3,8 +3,7 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as
 use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::OpenAck;
 use ibc_core_channel_types::msgs::MsgChannelOpenAck;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -109,7 +108,8 @@ where
     // Verify proofs
     {
         let client_id_on_a = conn_end_on_a.client_id();
-        let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+        let client_val_ctx_a = ctx_a.get_client_validation_context();
+        let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
         client_state_of_b_on_a
             .status(ctx_a.get_client_validation_context(), client_id_on_a)?
@@ -121,7 +121,8 @@ where
             msg.proof_height_on_b.revision_number(),
             msg.proof_height_on_b.revision_height(),
         );
-        let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
+        let consensus_state_of_b_on_a =
+            client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let prefix_on_b = conn_end_on_a.counterparty().prefix();
         let port_id_on_b = &chan_end_on_a.counterparty().port_id;
         let conn_id_on_b = conn_end_on_a.counterparty().connection_id().ok_or(
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
index bb9920d3b..dfbc777c1 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_confirm.rs
@@ -4,8 +4,7 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State, State as
 use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::OpenConfirm;
 use ibc_core_channel_types::msgs::MsgChannelOpenConfirm;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -114,7 +113,8 @@ where
     // Verify proofs
     {
         let client_id_on_b = conn_end_on_b.client_id();
-        let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
+        let client_val_ctx_b = ctx_b.get_client_validation_context();
+        let client_state_of_a_on_b = client_val_ctx_b.client_state(client_id_on_b)?;
 
         client_state_of_a_on_b
             .status(ctx_b.get_client_validation_context(), client_id_on_b)?
@@ -126,7 +126,8 @@ where
             msg.proof_height_on_a.revision_number(),
             msg.proof_height_on_a.revision_height(),
         );
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = &chan_end_on_b.counterparty().port_id;
         let chan_id_on_a = chan_end_on_b
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_init.rs b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
index 81f645204..58a161d0b 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_init.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_init.rs
@@ -3,7 +3,7 @@
 use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State};
 use ibc_core_channel_types::events::OpenInit;
 use ibc_core_channel_types::msgs::MsgChannelOpenInit;
-use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::context::prelude::*;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::types::identifiers::ChannelId;
@@ -120,7 +120,8 @@ where
     // Note: Not needed check if the connection end is OPEN. Optimistic channel handshake is allowed.
 
     let client_id_on_a = conn_end_on_a.client_id();
-    let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+    let client_val_ctx_a = ctx_a.get_client_validation_context();
+    let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
     client_state_of_b_on_a
         .status(ctx_a.get_client_validation_context(), client_id_on_a)?
diff --git a/ibc-core/ics04-channel/src/handler/chan_open_try.rs b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
index 80888b0b1..08c82deac 100644
--- a/ibc-core/ics04-channel/src/handler/chan_open_try.rs
+++ b/ibc-core/ics04-channel/src/handler/chan_open_try.rs
@@ -4,8 +4,7 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, State as Channel
 use ibc_core_channel_types::error::ChannelError;
 use ibc_core_channel_types::events::OpenTry;
 use ibc_core_channel_types::msgs::MsgChannelOpenTry;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -135,7 +134,8 @@ where
     // Verify proofs
     {
         let client_id_on_b = conn_end_on_b.client_id();
-        let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
+        let client_val_ctx_b = ctx_b.get_client_validation_context();
+        let client_state_of_a_on_b = client_val_ctx_b.client_state(client_id_on_b)?;
 
         client_state_of_a_on_b
             .status(ctx_b.get_client_validation_context(), client_id_on_b)?
@@ -148,7 +148,8 @@ where
             msg.proof_height_on_a.revision_number(),
             msg.proof_height_on_a.revision_height(),
         );
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
         let prefix_on_a = conn_end_on_b.counterparty().prefix();
         let port_id_on_a = msg.port_id_on_a.clone();
         let chan_id_on_a = msg.chan_id_on_a.clone();
diff --git a/ibc-core/ics04-channel/src/handler/recv_packet.rs b/ibc-core/ics04-channel/src/handler/recv_packet.rs
index 9e42e269d..8c0cd25a1 100644
--- a/ibc-core/ics04-channel/src/handler/recv_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/recv_packet.rs
@@ -4,8 +4,7 @@ use ibc_core_channel_types::error::{ChannelError, PacketError};
 use ibc_core_channel_types::events::{ReceivePacket, WriteAcknowledgement};
 use ibc_core_channel_types::msgs::MsgRecvPacket;
 use ibc_core_channel_types::packet::Receipt;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_connection::types::State as ConnectionState;
 use ibc_core_handler_types::error::ContextError;
@@ -179,7 +178,8 @@ where
     // Verify proofs
     {
         let client_id_on_b = conn_end_on_b.client_id();
-        let client_state_of_a_on_b = ctx_b.client_state(client_id_on_b)?;
+        let client_val_ctx_b = ctx_b.get_client_validation_context();
+        let client_state_of_a_on_b = client_val_ctx_b.client_state(client_id_on_b)?;
 
         client_state_of_a_on_b
             .status(ctx_b.get_client_validation_context(), client_id_on_b)?
@@ -193,7 +193,8 @@ where
             msg.proof_height_on_a.revision_height(),
         );
 
-        let consensus_state_of_a_on_b = ctx_b.consensus_state(&client_cons_state_path_on_b)?;
+        let consensus_state_of_a_on_b =
+            client_val_ctx_b.consensus_state(&client_cons_state_path_on_b)?;
 
         let expected_commitment_on_a = compute_packet_commitment(
             &msg.packet.data,
diff --git a/ibc-core/ics04-channel/src/handler/send_packet.rs b/ibc-core/ics04-channel/src/handler/send_packet.rs
index a0f3405c0..f1c6c29b5 100644
--- a/ibc-core/ics04-channel/src/handler/send_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/send_packet.rs
@@ -3,8 +3,7 @@ use ibc_core_channel_types::commitment::compute_packet_commitment;
 use ibc_core_channel_types::error::PacketError;
 use ibc_core_channel_types::events::SendPacket;
 use ibc_core_channel_types::packet::Packet;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::types::path::{
@@ -51,7 +50,9 @@ pub fn send_packet_validate(
 
     let client_id_on_a = conn_end_on_a.client_id();
 
-    let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+    let client_val_ctx_a = ctx_a.get_client_validation_context();
+
+    let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
     client_state_of_b_on_a
         .status(ctx_a.get_client_validation_context(), client_id_on_a)?
@@ -72,7 +73,8 @@ pub fn send_packet_validate(
         latest_height_on_a.revision_number(),
         latest_height_on_a.revision_height(),
     );
-    let consensus_state_of_b_on_a = ctx_a.client_consensus_state(&client_cons_state_path_on_a)?;
+    let consensus_state_of_b_on_a =
+        client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
     let latest_timestamp = consensus_state_of_b_on_a.timestamp();
     let packet_timestamp = packet.timeout_timestamp_on_b;
     if let Expiry::Expired = latest_timestamp.check_expiry(&packet_timestamp) {
diff --git a/ibc-core/ics04-channel/src/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
index bff8be649..aca19b9f8 100644
--- a/ibc-core/ics04-channel/src/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -3,8 +3,7 @@ use ibc_core_channel_types::commitment::compute_packet_commitment;
 use ibc_core_channel_types::error::{ChannelError, PacketError};
 use ibc_core_channel_types::events::{ChannelClosed, TimeoutPacket};
 use ibc_core_channel_types::msgs::{MsgTimeout, MsgTimeoutOnClose};
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
@@ -186,7 +185,8 @@ where
     // Verify proofs
     {
         let client_id_on_a = conn_end_on_a.client_id();
-        let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+        let client_val_ctx_a = ctx_a.get_client_validation_context();
+        let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
         client_state_of_b_on_a
             .status(ctx_a.get_client_validation_context(), client_id_on_a)?
@@ -200,7 +200,8 @@ where
             msg.proof_height_on_b.revision_number(),
             msg.proof_height_on_b.revision_height(),
         );
-        let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
+        let consensus_state_of_b_on_a =
+            client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let timestamp_of_b = consensus_state_of_b_on_a.timestamp();
 
         if !msg.packet.timed_out(&timestamp_of_b, msg.proof_height_on_b) {
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index b448bba44..49dcc9a05 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -2,8 +2,7 @@ use ibc_core_channel_types::channel::{ChannelEnd, Counterparty, Order, State};
 use ibc_core_channel_types::commitment::compute_packet_commitment;
 use ibc_core_channel_types::error::{ChannelError, PacketError};
 use ibc_core_channel_types::msgs::MsgTimeoutOnClose;
-use ibc_core_client::context::client_state::{ClientStateCommon, ClientStateValidation};
-use ibc_core_client::context::consensus_state::ConsensusState;
+use ibc_core_client::context::prelude::*;
 use ibc_core_connection::delay::verify_conn_delay_passed;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_host::types::path::{
@@ -65,7 +64,8 @@ where
     // Verify proofs
     {
         let client_id_on_a = conn_end_on_a.client_id();
-        let client_state_of_b_on_a = ctx_a.client_state(client_id_on_a)?;
+        let client_val_ctx_a = ctx_a.get_client_validation_context();
+        let client_state_of_b_on_a = client_val_ctx_a.client_state(client_id_on_a)?;
 
         client_state_of_b_on_a
             .status(ctx_a.get_client_validation_context(), client_id_on_a)?
@@ -78,7 +78,8 @@ where
             msg.proof_height_on_b.revision_number(),
             msg.proof_height_on_b.revision_height(),
         );
-        let consensus_state_of_b_on_a = ctx_a.consensus_state(&client_cons_state_path_on_a)?;
+        let consensus_state_of_b_on_a =
+            client_val_ctx_a.consensus_state(&client_cons_state_path_on_a)?;
         let prefix_on_b = conn_end_on_a.counterparty().prefix();
         let port_id_on_b = chan_end_on_a.counterparty().port_id.clone();
         let chan_id_on_b = chan_end_on_a
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
index eaa9313a8..925ab547f 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
@@ -5,21 +5,22 @@
 //! [Basecoin-rs](https://github.com/informalsystems/basecoin-rs) repository.
 //! If it proves to be generic enough, we may move it to the ICS02 section.
 
-use ibc_core_client_context::client_state::ClientState;
-use ibc_core_client_context::consensus_state::ConsensusState;
-use ibc_core_client_context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client_context::ClientValidationContext;
 use ibc_core_client_types::error::UpgradeClientError;
 use ibc_core_host_types::path::UpgradeClientPath;
 
 use super::Plan;
 
+pub type UpgradedClientStateRef<T> =
+    <<T as UpgradeValidationContext>::V as ClientValidationContext>::ClientStateRef;
+
+pub type UpgradedConsensusStateRef<T> =
+    <<T as UpgradeValidationContext>::V as ClientValidationContext>::ConsensusStateRef;
+
 /// Helper context to validate client upgrades, providing methods to retrieve
 /// an upgrade plan and related upgraded client and consensus states.
 pub trait UpgradeValidationContext {
     type V: ClientValidationContext;
-    type E: ClientExecutionContext;
-    type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::V, Self::E>;
 
     /// Returns the upgrade plan that is scheduled and not have been executed yet.
     fn upgrade_plan(&self) -> Result<Plan, UpgradeClientError>;
@@ -28,13 +29,13 @@ pub trait UpgradeValidationContext {
     fn upgraded_client_state(
         &self,
         upgrade_path: &UpgradeClientPath,
-    ) -> Result<Self::AnyClientState, UpgradeClientError>;
+    ) -> Result<UpgradedClientStateRef<Self>, UpgradeClientError>;
 
     /// Returns the upgraded consensus state at the specified upgrade path.
     fn upgraded_consensus_state(
         &self,
         upgrade_path: &UpgradeClientPath,
-    ) -> Result<Self::AnyConsensusState, UpgradeClientError>;
+    ) -> Result<UpgradedConsensusStateRef<Self>, UpgradeClientError>;
 }
 
 /// Helper context to execute client upgrades, providing methods to schedule
@@ -50,13 +51,13 @@ pub trait UpgradeExecutionContext: UpgradeValidationContext {
     fn store_upgraded_client_state(
         &mut self,
         upgrade_path: UpgradeClientPath,
-        client_state: Self::AnyClientState,
+        client_state: UpgradedClientStateRef<Self>,
     ) -> Result<(), UpgradeClientError>;
 
     /// Stores the upgraded consensus state at the specified upgrade path.
     fn store_upgraded_consensus_state(
         &mut self,
         upgrade_path: UpgradeClientPath,
-        consensus_state: Self::AnyConsensusState,
+        consensus_state: UpgradedConsensusStateRef<Self>,
     ) -> Result<(), UpgradeClientError>;
 }
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
index 31f187175..99e04f833 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
@@ -4,6 +4,7 @@ use ibc_core_host_types::path::UpgradeClientPath;
 use ibc_primitives::prelude::*;
 use tendermint::abci::Event as TmEvent;
 
+use super::UpgradedClientStateRef;
 use crate::upgrade_proposal::{UpgradeClientProposal, UpgradeExecutionContext, UpgradeProposal};
 
 /// Handles an upgrade client proposal
@@ -17,7 +18,7 @@ pub fn upgrade_client_proposal_handler<Ctx>(
 ) -> Result<TmEvent, UpgradeClientError>
 where
     Ctx: UpgradeExecutionContext,
-    Ctx::AnyClientState: From<TmClientState>,
+    UpgradedClientStateRef<Ctx>: From<TmClientState>,
 {
     let plan = proposal.plan;
 
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
index cd1500402..db4919d92 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
@@ -6,7 +6,7 @@ mod handler;
 mod plan;
 mod proposal;
 
-pub use context::{UpgradeExecutionContext, UpgradeValidationContext};
+pub use context::*;
 pub use events::{UpgradeChain, UpgradeClientProposal};
 pub use handler::upgrade_client_proposal_handler;
 pub use plan::Plan;
diff --git a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
index 9f32348eb..72974ab75 100644
--- a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
+++ b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
@@ -1,7 +1,6 @@
 use core::time::Duration;
 
-use ibc_client_tendermint::client_state::ClientState;
-use ibc_core_client_context::client_state::ClientStateCommon;
+use ibc_client_tendermint::types::ClientState as TmClientState;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::specs::ProofSpecs;
@@ -9,29 +8,23 @@ use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_host_types::identifiers::ChainId;
 use ibc_primitives::prelude::*;
-use ibc_proto::google::protobuf::Any;
 use tendermint::trust_threshold::TrustThresholdFraction as TendermintTrustThresholdFraction;
 
-/// Provides an implementation of `ValidationContext::validate_self_client` for
-/// Tendermint-based hosts.
+/// Provides a default implementation intended for implementing the
+/// `ValidationContext::validate_self_client` API.
+///
+/// This validation logic tailored for Tendermint client states of a host chain
+/// operating across various counterparty chains.
 pub trait ValidateSelfClientContext {
     fn validate_self_tendermint_client(
         &self,
-        client_state_of_host_on_counterparty: Any,
+        client_state_of_host_on_counterparty: TmClientState,
     ) -> Result<(), ContextError> {
-        let tm_client_state = ClientState::try_from(client_state_of_host_on_counterparty)
-            .map_err(|_| ConnectionError::InvalidClientState {
-                reason: "client must be a tendermint client".to_string(),
-            })
-            .map_err(ContextError::ConnectionError)?;
-
-        let tm_client_state_inner = tm_client_state.inner();
-
-        tm_client_state_inner
+        client_state_of_host_on_counterparty
             .validate()
             .map_err(ClientError::from)?;
 
-        if tm_client_state_inner.is_frozen() {
+        if client_state_of_host_on_counterparty.is_frozen() {
             return Err(ClientError::ClientFrozen {
                 description: String::new(),
             }
@@ -39,18 +32,18 @@ pub trait ValidateSelfClientContext {
         }
 
         let self_chain_id = self.chain_id();
-        if self_chain_id != &tm_client_state_inner.chain_id {
+        if self_chain_id != &client_state_of_host_on_counterparty.chain_id {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid chain-id. expected: {}, got: {}",
-                        self_chain_id, tm_client_state_inner.chain_id
+                        self_chain_id, client_state_of_host_on_counterparty.chain_id
                     ),
                 },
             ));
         }
 
-        let latest_height = tm_client_state.latest_height();
+        let latest_height = client_state_of_host_on_counterparty.latest_height;
         let self_revision_number = self_chain_id.revision_number();
         if self_revision_number != latest_height.revision_number() {
             return Err(ContextError::ConnectionError(
@@ -76,20 +69,20 @@ pub trait ValidateSelfClientContext {
             ));
         }
 
-        if self.proof_specs() != &tm_client_state_inner.proof_specs {
+        if self.proof_specs() != &client_state_of_host_on_counterparty.proof_specs {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client has invalid proof specs. expected: {:?}, got: {:?}",
                         self.proof_specs(),
-                        tm_client_state_inner.proof_specs
+                        client_state_of_host_on_counterparty.proof_specs
                     ),
                 },
             ));
         }
 
         let _ = {
-            let trust_level = tm_client_state_inner.trust_level;
+            let trust_level = client_state_of_host_on_counterparty.trust_level;
 
             TendermintTrustThresholdFraction::new(
                 trust_level.numerator(),
@@ -100,35 +93,37 @@ pub trait ValidateSelfClientContext {
             })?
         };
 
-        if self.unbonding_period() != tm_client_state_inner.unbonding_period {
+        if self.unbonding_period() != client_state_of_host_on_counterparty.unbonding_period {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid unbonding period. expected: {:?}, got: {:?}",
                         self.unbonding_period(),
-                        tm_client_state_inner.unbonding_period,
+                        client_state_of_host_on_counterparty.unbonding_period,
                     ),
                 },
             ));
         }
 
-        if tm_client_state_inner.unbonding_period < tm_client_state_inner.trusting_period {
+        if client_state_of_host_on_counterparty.unbonding_period
+            < client_state_of_host_on_counterparty.trusting_period
+        {
             return Err(ContextError::ConnectionError(ConnectionError::InvalidClientState{ reason: format!(
                 "unbonding period must be greater than trusting period. unbonding period ({:?}) < trusting period ({:?})",
-                tm_client_state_inner.unbonding_period,
-                tm_client_state_inner.trusting_period
+                client_state_of_host_on_counterparty.unbonding_period,
+                client_state_of_host_on_counterparty.trusting_period
             )}));
         }
 
-        if !tm_client_state_inner.upgrade_path.is_empty()
-            && self.upgrade_path() != tm_client_state_inner.upgrade_path
+        if !client_state_of_host_on_counterparty.upgrade_path.is_empty()
+            && self.upgrade_path() != client_state_of_host_on_counterparty.upgrade_path
         {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "invalid upgrade path. expected: {:?}, got: {:?}",
                         self.upgrade_path(),
-                        tm_client_state_inner.upgrade_path
+                        client_state_of_host_on_counterparty.upgrade_path
                     ),
                 },
             ));
diff --git a/ibc-core/ics24-host/src/context.rs b/ibc-core/ics24-host/src/context.rs
index b2525b3cb..9335fce60 100644
--- a/ibc-core/ics24-host/src/context.rs
+++ b/ibc-core/ics24-host/src/context.rs
@@ -3,9 +3,7 @@ use core::time::Duration;
 use ibc_core_channel_types::channel::ChannelEnd;
 use ibc_core_channel_types::commitment::{AcknowledgementCommitment, PacketCommitment};
 use ibc_core_channel_types::packet::Receipt;
-use ibc_core_client_context::client_state::ClientState;
-use ibc_core_client_context::consensus_state::ConsensusState;
-use ibc_core_client_context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentPrefix;
 use ibc_core_connection_types::version::{
@@ -14,13 +12,12 @@ use ibc_core_connection_types::version::{
 use ibc_core_connection_types::ConnectionEnd;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::IbcEvent;
-use ibc_core_host_types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc_core_host_types::identifiers::{ConnectionId, Sequence};
 use ibc_core_host_types::path::{
-    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
-    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
+    AckPath, ChannelEndPath, ClientConnectionPath, CommitmentPath, ConnectionPath, ReceiptPath,
+    SeqAckPath, SeqRecvPath, SeqSendPath,
 };
 use ibc_primitives::prelude::*;
-use ibc_primitives::proto::Any;
 use ibc_primitives::{Signer, Timestamp};
 
 use crate::utils::calculate_block_delay;
@@ -30,32 +27,14 @@ use crate::utils::calculate_block_delay;
 /// Trait used for the top-level `validate` entrypoint in the `ibc-core` crate.
 pub trait ValidationContext {
     type V: ClientValidationContext;
-    type E: ClientExecutionContext;
-    type AnyConsensusState: ConsensusState;
-    type AnyClientState: ClientState<Self::V, Self::E>;
+    /// The client state type for the host chain.
+    type HostClientState: ClientStateValidation<Self::V>;
+    /// The consensus state type for the host chain.
+    type HostConsensusState: ConsensusState;
 
     /// Retrieve the context that implements all clients' `ValidationContext`.
     fn get_client_validation_context(&self) -> &Self::V;
 
-    /// Returns the ClientState for the given identifier `client_id`.
-    ///
-    /// Note: Clients have the responsibility to store client states on client creation and update.
-    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError>;
-
-    /// Tries to decode the given `client_state` into a concrete light client state.
-    fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError>;
-
-    /// Retrieve the consensus state for the given client ID at the specified
-    /// height.
-    ///
-    /// Returns an error if no such state exists.
-    ///
-    /// Note: Clients have the responsibility to store consensus states on client creation and update.
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError>;
-
     /// Returns the current height of the local chain.
     fn host_height(&self) -> Result<Height, ContextError>;
 
@@ -66,7 +45,7 @@ pub trait ValidationContext {
     fn host_consensus_state(
         &self,
         height: &Height,
-    ) -> Result<Self::AnyConsensusState, ContextError>;
+    ) -> Result<Self::HostConsensusState, ContextError>;
 
     /// Returns a natural number, counting how many clients have been created
     /// thus far. The value of this counter should increase only via method
@@ -76,17 +55,18 @@ pub trait ValidationContext {
     /// Returns the ConnectionEnd for the given identifier `conn_id`.
     fn connection_end(&self, conn_id: &ConnectionId) -> Result<ConnectionEnd, ContextError>;
 
-    /// Validates the `ClientState` of the client (a client referring to host) stored on the counterparty chain against the host's internal state.
+    /// Validates the `ClientState` of the host chain stored on the counterparty
+    /// chain against the host's internal state.
     ///
     /// For more information on the specific requirements for validating the
     /// client state of a host chain, please refer to the [ICS24 host
     /// requirements](https://github.com/cosmos/ibc/tree/main/spec/core/ics-024-host-requirements#client-state-validation)
     ///
     /// Additionally, implementations specific to individual chains can be found
-    /// in the `ibc-core-hostkit` crate.
+    /// in the `ibc-core/ics24-host` module.
     fn validate_self_client(
         &self,
-        client_state_of_host_on_counterparty: Any,
+        client_state_of_host_on_counterparty: Self::HostClientState,
     ) -> Result<(), ContextError>;
 
     /// Returns the prefix that the local chain uses in the KV store.
@@ -166,6 +146,8 @@ pub trait ValidationContext {
 ///
 /// Trait used for the top-level `execute` and `dispatch` entrypoints in the `ibc-core` crate.
 pub trait ExecutionContext: ValidationContext {
+    type E: ClientExecutionContext;
+
     /// Retrieve the context that implements all clients' `ExecutionContext`.
     fn get_client_execution_context(&mut self) -> &mut Self::E;
 
@@ -262,3 +244,18 @@ pub trait ExecutionContext: ValidationContext {
     /// Log the given message.
     fn log_message(&mut self, message: String) -> Result<(), ContextError>;
 }
+
+/// Convenient type alias for `ClientStateRef`, providing access to client
+/// validation methods within the context.
+pub type ClientStateRef<Ctx> =
+    <<Ctx as ValidationContext>::V as ClientValidationContext>::ClientStateRef;
+
+/// Convenient type alias for `ClientStateMut`, providing access to client
+/// execution methods within the context.
+pub type ClientStateMut<Ctx> =
+    <<Ctx as ExecutionContext>::E as ClientExecutionContext>::ClientStateMut;
+
+/// Convenient type alias for `ConsensusStateRef`, providing access to client
+/// validation methods within the context.
+pub type ConsensusStateRef<Ctx> =
+    <<Ctx as ValidationContext>::V as ClientValidationContext>::ConsensusStateRef;
diff --git a/ibc-core/ics25-handler/src/entrypoint.rs b/ibc-core/ics25-handler/src/entrypoint.rs
index 957e147c0..f41ad4a53 100644
--- a/ibc-core/ics25-handler/src/entrypoint.rs
+++ b/ibc-core/ics25-handler/src/entrypoint.rs
@@ -22,11 +22,14 @@ use ibc_core_router::router::Router;
 use ibc_core_router::types::error::RouterError;
 
 /// Entrypoint which performs both validation and message execution
-pub fn dispatch(
-    ctx: &mut impl ExecutionContext,
+pub fn dispatch<Ctx>(
+    ctx: &mut Ctx,
     router: &mut impl Router,
     msg: MsgEnvelope,
-) -> Result<(), ContextError> {
+) -> Result<(), ContextError>
+where
+    Ctx: ExecutionContext,
+{
     validate(ctx, router, msg.clone())?;
     execute(ctx, router, msg)
 }
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index 56d9bb5be..f0e64e80b 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -3,13 +3,14 @@
 use alloc::format;
 use core::str::FromStr;
 
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
 use ibc::core::host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
     ReceiptPath, SeqRecvPath, SeqSendPath,
 };
-use ibc::core::host::ValidationContext;
+use ibc::core::host::{ConsensusStateRef, ValidationContext};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::{
     QueryChannelClientStateRequest, QueryChannelClientStateResponse,
@@ -121,7 +122,6 @@ pub fn query_channel_client_state<I>(
 ) -> Result<QueryChannelClientStateResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
 {
     let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
 
@@ -139,7 +139,9 @@ where
             description: format!("Channel {} does not have a connection", channel_id),
         })??;
 
-    let client_state = ibc_ctx.client_state(connection_end.client_id())?;
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
+
+    let client_state = client_val_ctx.client_state(connection_end.client_id())?;
 
     let current_height = ibc_ctx.host_height()?;
 
@@ -173,7 +175,7 @@ pub fn query_channel_consensus_state<I>(
 ) -> Result<QueryChannelConsensusStateResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
 
@@ -198,8 +200,9 @@ where
         height.revision_number(),
         height.revision_height(),
     );
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
 
-    let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
+    let consensus_state = client_val_ctx.consensus_state(&consensus_path)?;
 
     let current_height = ibc_ctx.host_height()?;
 
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 105f97988..7367caa48 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -2,7 +2,7 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use ibc::core::host::ValidationContext;
+use ibc::core::host::ConsensusStateRef;
 use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
@@ -37,8 +37,7 @@ use crate::core::context::QueryContext;
 pub struct ChannelQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     ibc_context: I,
 }
@@ -46,8 +45,7 @@ where
 impl<I> ChannelQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
     /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
@@ -60,8 +58,7 @@ where
 impl<I> ChannelQuery for ChannelQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     async fn channel(
         &self,
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index 5162c5de3..2b1341d43 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -4,14 +4,15 @@ use alloc::format;
 use core::str::FromStr;
 
 use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::types::path::{
     ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
 };
-use ibc::core::host::ValidationContext;
-use ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext;
+use ibc::core::host::{ConsensusStateRef, ValidationContext};
+use ibc::cosmos_host::upgrade_proposal::{UpgradeValidationContext, UpgradedConsensusStateRef};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::{
     ConsensusStateWithHeight, IdentifiedClientState, QueryClientStateRequest,
@@ -23,7 +24,7 @@ use ibc_proto::ibc::core::client::v1::{
     QueryUpgradedConsensusStateResponse,
 };
 
-use crate::core::context::{ProvableContext, QueryContext};
+use crate::core::context::QueryContext;
 use crate::error::QueryError;
 
 /// Queries for the client state of a given client id.
@@ -32,12 +33,13 @@ pub fn query_client_state<I>(
     request: &QueryClientStateRequest,
 ) -> Result<QueryClientStateResponse, QueryError>
 where
-    I: ValidationContext + ProvableContext,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
+    I: QueryContext,
 {
     let client_id = ClientId::from_str(request.client_id.as_str())?;
 
-    let client_state = ibc_ctx.client_state(&client_id)?;
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
+
+    let client_state = client_val_ctx.client_state(&client_id)?;
 
     let current_height = ibc_ctx.host_height()?;
 
@@ -64,7 +66,6 @@ pub fn query_client_states<I>(
 ) -> Result<QueryClientStatesResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
 {
     let client_states = ibc_ctx.client_states()?;
 
@@ -88,7 +89,7 @@ pub fn query_consensus_state<I>(
 ) -> Result<QueryConsensusStateResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     let client_id = ClientId::from_str(request.client_id.as_str())?;
 
@@ -103,7 +104,9 @@ where
     } else {
         let height = Height::new(request.revision_number, request.revision_height)?;
 
-        let consensus_state = ibc_ctx.consensus_state(&ClientConsensusStatePath::new(
+        let client_val_ctx = ibc_ctx.get_client_validation_context();
+
+        let consensus_state = client_val_ctx.consensus_state(&ClientConsensusStatePath::new(
             client_id.clone(),
             height.revision_number(),
             height.revision_height(),
@@ -141,7 +144,7 @@ pub fn query_consensus_states<I>(
 ) -> Result<QueryConsensusStatesResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     let client_id = ClientId::from_str(request.client_id.as_str())?;
 
@@ -191,8 +194,8 @@ where
     I: ValidationContext,
 {
     let client_id = ClientId::from_str(request.client_id.as_str())?;
-
-    let client_state = ibc_ctx.client_state(&client_id)?;
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
+    let client_state = client_val_ctx.client_state(&client_id)?;
     let client_validation_ctx = ibc_ctx.get_client_validation_context();
     let client_status = client_state.status(client_validation_ctx, &client_id)?;
 
@@ -208,7 +211,6 @@ pub fn query_upgraded_client_state<U>(
 ) -> Result<QueryUpgradedClientStateResponse, QueryError>
 where
     U: UpgradeValidationContext,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
 {
     let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
 
@@ -230,7 +232,7 @@ pub fn query_upgraded_consensus_state<U>(
 ) -> Result<QueryUpgradedConsensusStateResponse, QueryError>
 where
     U: UpgradeValidationContext,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+    UpgradedConsensusStateRef<U>: Into<Any>,
 {
     let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
 
diff --git a/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
index 6b1c06afd..a1a7d7d32 100644
--- a/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -2,9 +2,11 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use ibc::core::host::ValidationContext;
+use ibc::core::host::ConsensusStateRef;
 use ibc::core::primitives::prelude::*;
-use ibc::cosmos_host::upgrade_proposal::UpgradeValidationContext;
+use ibc::cosmos_host::upgrade_proposal::{
+    UpgradeValidationContext, UpgradedClientStateRef, UpgradedConsensusStateRef,
+};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::query_server::Query as ClientQuery;
 use ibc_proto::ibc::core::client::v1::{
@@ -33,10 +35,8 @@ pub struct ClientQueryService<I, U>
 where
     I: QueryContext + Send + Sync + 'static,
     U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+    UpgradedClientStateRef<U>: Into<Any>,
+    UpgradedConsensusStateRef<U>: Into<Any>,
 {
     ibc_context: I,
     upgrade_context: U,
@@ -46,10 +46,8 @@ impl<I, U> ClientQueryService<I, U>
 where
     I: QueryContext + Send + Sync + 'static,
     U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+    UpgradedClientStateRef<U>: Into<Any>,
+    UpgradedConsensusStateRef<U>: Into<Any>,
 {
     /// Parameters `ibc_context` and `upgrade_context` must be a type where writes from one thread are readable from another.
     /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
@@ -66,10 +64,8 @@ impl<I, U> ClientQuery for ClientQueryService<I, U>
 where
     I: QueryContext + Send + Sync + 'static,
     U: UpgradeValidationContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyClientState: Into<Any>,
-    <U as UpgradeValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
+    UpgradedConsensusStateRef<U>: Into<Any>,
 {
     async fn client_state(
         &self,
diff --git a/ibc-query/src/core/connection/query.rs b/ibc-query/src/core/connection/query.rs
index c75bd36b6..09d304806 100644
--- a/ibc-query/src/core/connection/query.rs
+++ b/ibc-query/src/core/connection/query.rs
@@ -4,12 +4,13 @@ use alloc::format;
 use alloc::vec::Vec;
 use core::str::FromStr;
 
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::types::path::{
     ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
 };
-use ibc::core::host::ValidationContext;
+use ibc::core::host::{ConsensusStateRef, ValidationContext};
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
 use ibc_proto::ibc::core::connection::v1::{
@@ -78,7 +79,6 @@ pub fn query_client_connections<I>(
 ) -> Result<QueryClientConnectionsResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
 {
     let client_id = ClientId::from_str(request.client_id.as_str())?;
 
@@ -109,13 +109,14 @@ pub fn query_connection_client_state<I>(
 ) -> Result<QueryConnectionClientStateResponse, QueryError>
 where
     I: QueryContext,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
 {
     let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
 
     let connection_end = ibc_ctx.connection_end(&connection_id)?;
 
-    let client_state = ibc_ctx.client_state(connection_end.client_id())?;
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
+
+    let client_state = client_val_ctx.client_state(connection_end.client_id())?;
 
     let current_height = ibc_ctx.host_height()?;
 
@@ -148,7 +149,7 @@ pub fn query_connection_consensus_state<I>(
 ) -> Result<QueryConnectionConsensusStateResponse, QueryError>
 where
     I: ValidationContext + ProvableContext,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
 
@@ -162,7 +163,9 @@ where
         height.revision_height(),
     );
 
-    let consensus_state = ibc_ctx.consensus_state(&consensus_path)?;
+    let client_val_ctx = ibc_ctx.get_client_validation_context();
+
+    let consensus_state = client_val_ctx.consensus_state(&consensus_path)?;
 
     let current_height = ibc_ctx.host_height()?;
 
diff --git a/ibc-query/src/core/connection/service.rs b/ibc-query/src/core/connection/service.rs
index a01a3b004..75c20b185 100644
--- a/ibc-query/src/core/connection/service.rs
+++ b/ibc-query/src/core/connection/service.rs
@@ -2,7 +2,7 @@
 //! `I` must be a type where writes from one thread are readable from another.
 //! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
-use ibc::core::host::ValidationContext;
+use ibc::core::host::ConsensusStateRef;
 use ibc::core::primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::connection::v1::query_server::Query as ConnectionQuery;
@@ -28,8 +28,7 @@ use crate::core::context::QueryContext;
 pub struct ConnectionQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     ibc_context: I,
 }
@@ -37,8 +36,7 @@ where
 impl<I> ConnectionQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
     /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
@@ -51,8 +49,7 @@ where
 impl<I> ConnectionQuery for ConnectionQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
-    <I as ValidationContext>::AnyClientState: Into<Any>,
-    <I as ValidationContext>::AnyConsensusState: Into<Any>,
+    ConsensusStateRef<I>: Into<Any>,
 {
     async fn connection(
         &self,
diff --git a/ibc-query/src/core/context.rs b/ibc-query/src/core/context.rs
index 2f4eef7a1..693dafec9 100644
--- a/ibc-query/src/core/context.rs
+++ b/ibc-query/src/core/context.rs
@@ -7,7 +7,7 @@ use ibc::core::connection::types::IdentifiedConnectionEnd;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId, Sequence};
 use ibc::core::host::types::path::{ChannelEndPath, Path};
-use ibc::core::host::ValidationContext;
+use ibc::core::host::{ClientStateRef, ConsensusStateRef, ValidationContext};
 use ibc::core::primitives::prelude::*;
 
 /// Context to be implemented by the host to provide proofs in query responses
@@ -22,15 +22,13 @@ pub trait QueryContext: ProvableContext + ValidationContext {
     // Client queries
 
     /// Returns the list of all clients.
-    fn client_states(
-        &self,
-    ) -> Result<Vec<(ClientId, <Self as ValidationContext>::AnyClientState)>, ContextError>;
+    fn client_states(&self) -> Result<Vec<(ClientId, ClientStateRef<Self>)>, ContextError>;
 
     /// Returns the list of all consensus states for the given client.
     fn consensus_states(
         &self,
         client_id: &ClientId,
-    ) -> Result<Vec<(Height, <Self as ValidationContext>::AnyConsensusState)>, ContextError>;
+    ) -> Result<Vec<(Height, ConsensusStateRef<Self>)>, ContextError>;
 
     /// Returns the list of all heights at which consensus states for the given client are.
     fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index d41331345..852f91bd3 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -1,3 +1,4 @@
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::Height;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::host::types::identifiers::ClientId;
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index ab1cf2d73..39cd35cfe 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -1,10 +1,7 @@
 use core::str::FromStr;
 use core::time::Duration;
 
-use ibc::core::client::context::client_state::{
-    ClientStateCommon, ClientStateExecution, ClientStateValidation,
-};
-use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::client::context::prelude::*;
 use ibc::core::client::types::error::{ClientError, UpgradeClientError};
 use ibc::core::client::types::{Height, Status};
 use ibc::core::commitment_types::commitment::{
@@ -126,24 +123,22 @@ impl From<MockClientState> for Any {
     }
 }
 
-pub trait MockClientContext {
-    type ConversionError: ToString;
-    type AnyConsensusState: TryInto<MockConsensusState, Error = Self::ConversionError>;
+pub trait ConsensusStateConverter:
+    TryInto<MockConsensusState, Error = ClientError> + From<MockConsensusState>
+{
+}
+
+impl<C> ConsensusStateConverter for C where
+    C: TryInto<MockConsensusState, Error = ClientError> + From<MockConsensusState>
+{
+}
 
+pub trait MockClientContext {
     /// Returns the current timestamp of the local chain.
     fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
 
     /// Returns the current height of the local chain.
     fn host_height(&self) -> Result<Height, ContextError>;
-
-    /// Retrieve the consensus state for the given client ID at the specified
-    /// height.
-    ///
-    /// Returns an error if no such state exists.
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError>;
 }
 
 impl ClientStateCommon for MockClientState {
@@ -215,8 +210,7 @@ impl ClientStateCommon for MockClientState {
 impl<V> ClientStateValidation<V> for MockClientState
 where
     V: ClientValidationContext + MockClientContext,
-    V::AnyConsensusState: TryInto<MockConsensusState>,
-    ClientError: From<<V::AnyConsensusState as TryInto<MockConsensusState>>::Error>,
+    V::ConsensusStateRef: ConsensusStateConverter,
 {
     fn verify_client_message(
         &self,
@@ -264,20 +258,17 @@ where
             return Ok(Status::Frozen);
         }
 
-        let latest_consensus_state: MockConsensusState = {
-            let any_latest_consensus_state =
-                match ctx.consensus_state(&ClientConsensusStatePath::new(
-                    client_id.clone(),
-                    self.latest_height().revision_number(),
-                    self.latest_height().revision_height(),
-                )) {
-                    Ok(cs) => cs,
-                    // if the client state does not have an associated consensus state for its latest height
-                    // then it must be expired
-                    Err(_) => return Ok(Status::Expired),
-                };
-
-            any_latest_consensus_state.try_into()?
+        let latest_consensus_state = {
+            match ctx.consensus_state(&ClientConsensusStatePath::new(
+                client_id.clone(),
+                self.latest_height().revision_number(),
+                self.latest_height().revision_height(),
+            )) {
+                Ok(cs) => cs.try_into()?,
+                // if the client state does not have an associated consensus state for its latest height
+                // then it must be expired
+                Err(_) => return Ok(Status::Expired),
+            }
         };
 
         let now = ctx.host_timestamp()?;
@@ -298,8 +289,8 @@ where
 impl<E> ClientStateExecution<E> for MockClientState
 where
     E: ClientExecutionContext + MockClientContext,
-    <E as ClientExecutionContext>::AnyClientState: From<MockClientState>,
-    <E as ClientExecutionContext>::AnyConsensusState: From<MockConsensusState>,
+    E::ClientStateRef: From<MockClientState>,
+    E::ConsensusStateRef: ConsensusStateConverter,
 {
     fn initialise(
         &self,
diff --git a/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
index 27ce9e34c..618466dc5 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -1,6 +1,6 @@
 pub mod mock;
 
-use derive_more::{From, TryInto};
+use derive_more::From;
 use ibc::clients::tendermint::client_state::ClientState as TmClientState;
 use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
 use ibc::clients::tendermint::types::{
@@ -67,7 +67,7 @@ impl From<ConsensusStateType> for AnyConsensusState {
     }
 }
 
-#[derive(Debug, Clone, From, TryInto, PartialEq, ConsensusState)]
+#[derive(Debug, Clone, From, PartialEq, ConsensusState)]
 pub enum AnyConsensusState {
     Tendermint(TmConsensusState),
     Mock(MockConsensusState),
@@ -99,3 +99,30 @@ impl From<AnyConsensusState> for Any {
         }
     }
 }
+
+impl TryFrom<AnyConsensusState> for ConsensusStateType {
+    type Error = ClientError;
+
+    fn try_from(value: AnyConsensusState) -> Result<Self, Self::Error> {
+        match value {
+            AnyConsensusState::Tendermint(cs) => Ok(cs.inner().clone()),
+            _ => Err(ClientError::Other {
+                description: "failed to convert AnyConsensusState to TmConsensusState".to_string(),
+            }),
+        }
+    }
+}
+
+impl TryFrom<AnyConsensusState> for MockConsensusState {
+    type Error = ClientError;
+
+    fn try_from(value: AnyConsensusState) -> Result<Self, Self::Error> {
+        match value {
+            AnyConsensusState::Mock(cs) => Ok(cs),
+            _ => Err(ClientError::Other {
+                description: "failed to convert AnyConsensusState to MockConsensusState"
+                    .to_string(),
+            }),
+        }
+    }
+}
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 227c647af..940e6fa43 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -1,9 +1,4 @@
-use alloc::collections::BTreeMap;
-use alloc::vec::Vec;
-
-use ibc::clients::tendermint::context::{
-    CommonContext as TmCommonContext, ValidationContext as TmValidationContext,
-};
+use ibc::clients::tendermint::context::ValidationContext as TmValidationContext;
 use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::Height;
@@ -12,6 +7,7 @@ use ibc::core::host::types::identifiers::{ChannelId, ClientId, PortId};
 use ibc::core::host::types::path::{ClientConsensusStatePath, ClientStatePath};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::Timestamp;
+use ibc::primitives::prelude::*;
 
 use crate::testapp::ibc::clients::mock::client_state::MockClientContext;
 use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
@@ -31,9 +27,6 @@ pub struct MockClientRecord {
 }
 
 impl MockClientContext for MockContext {
-    type ConversionError = &'static str;
-    type AnyConsensusState = AnyConsensusState;
-
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         ValidationContext::host_timestamp(self)
     }
@@ -41,19 +34,9 @@ impl MockClientContext for MockContext {
     fn host_height(&self) -> Result<Height, ContextError> {
         ValidationContext::host_height(self)
     }
-
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError> {
-        ValidationContext::consensus_state(self, client_cons_state_path)
-    }
 }
 
-impl TmCommonContext for MockContext {
-    type ConversionError = &'static str;
-    type AnyConsensusState = AnyConsensusState;
-
+impl TmValidationContext for MockContext {
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         ValidationContext::host_timestamp(self)
     }
@@ -62,13 +45,6 @@ impl TmCommonContext for MockContext {
         ValidationContext::host_height(self)
     }
 
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<Self::AnyConsensusState, ContextError> {
-        ValidationContext::consensus_state(self, client_cons_state_path)
-    }
-
     fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError> {
         let ibc_store = self.ibc_store.lock();
         let client_record =
@@ -83,14 +59,12 @@ impl TmCommonContext for MockContext {
 
         Ok(heights)
     }
-}
 
-impl TmValidationContext for MockContext {
     fn next_consensus_state(
         &self,
         client_id: &ClientId,
         height: &Height,
-    ) -> Result<Option<Self::AnyConsensusState>, ContextError> {
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
         let ibc_store = self.ibc_store.lock();
         let client_record =
             ibc_store
@@ -124,7 +98,7 @@ impl TmValidationContext for MockContext {
         &self,
         client_id: &ClientId,
         height: &Height,
-    ) -> Result<Option<Self::AnyConsensusState>, ContextError> {
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
         let ibc_store = self.ibc_store.lock();
         let client_record =
             ibc_store
@@ -156,7 +130,52 @@ impl TmValidationContext for MockContext {
 }
 
 impl ClientValidationContext for MockContext {
-    fn update_meta(
+    type ClientStateRef = AnyClientState;
+    type ConsensusStateRef = AnyConsensusState;
+
+    fn client_state(&self, client_id: &ClientId) -> Result<Self::ClientStateRef, ContextError> {
+        match self.ibc_store.lock().clients.get(client_id) {
+            Some(client_record) => {
+                client_record
+                    .client_state
+                    .clone()
+                    .ok_or_else(|| ClientError::ClientStateNotFound {
+                        client_id: client_id.clone(),
+                    })
+            }
+            None => Err(ClientError::ClientStateNotFound {
+                client_id: client_id.clone(),
+            }),
+        }
+        .map_err(ContextError::ClientError)
+    }
+
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<AnyConsensusState, ContextError> {
+        let client_id = &client_cons_state_path.client_id;
+        let height = Height::new(
+            client_cons_state_path.revision_number,
+            client_cons_state_path.revision_height,
+        )?;
+        match self.ibc_store.lock().clients.get(client_id) {
+            Some(client_record) => match client_record.consensus_states.get(&height) {
+                Some(consensus_state) => Ok(consensus_state.clone()),
+                None => Err(ClientError::ConsensusStateNotFound {
+                    client_id: client_id.clone(),
+                    height,
+                }),
+            },
+            None => Err(ClientError::ConsensusStateNotFound {
+                client_id: client_id.clone(),
+                height,
+            }),
+        }
+        .map_err(ContextError::ClientError)
+    }
+
+    fn client_update_meta(
         &self,
         client_id: &ClientId,
         height: &Height,
@@ -177,14 +196,12 @@ impl ClientValidationContext for MockContext {
 }
 
 impl ClientExecutionContext for MockContext {
-    type V = Self;
-    type AnyClientState = AnyClientState;
-    type AnyConsensusState = AnyConsensusState;
+    type ClientStateMut = AnyClientState;
 
     fn store_client_state(
         &mut self,
         client_state_path: ClientStatePath,
-        client_state: Self::AnyClientState,
+        client_state: Self::ClientStateRef,
     ) -> Result<(), ContextError> {
         let mut ibc_store = self.ibc_store.lock();
 
@@ -205,7 +222,7 @@ impl ClientExecutionContext for MockContext {
     fn store_consensus_state(
         &mut self,
         consensus_state_path: ClientConsensusStatePath,
-        consensus_state: Self::AnyConsensusState,
+        consensus_state: Self::ConsensusStateRef,
     ) -> Result<(), ContextError> {
         let mut ibc_store = self.ibc_store.lock();
 
diff --git a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index 5c561d14e..4901b2d2c 100644
--- a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -3,7 +3,6 @@
 use core::ops::Add;
 use core::time::Duration;
 
-use ibc::clients::tendermint::client_state::ClientState;
 use ibc::core::channel::types::channel::ChannelEnd;
 use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
 use ibc::core::channel::types::error::{ChannelError, PacketError};
@@ -15,81 +14,24 @@ use ibc::core::connection::types::error::ConnectionError;
 use ibc::core::connection::types::ConnectionEnd;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::IbcEvent;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId, Sequence};
+use ibc::core::host::types::identifiers::{ConnectionId, Sequence};
 use ibc::core::host::types::path::{
-    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, CommitmentPath,
-    ConnectionPath, ReceiptPath, SeqAckPath, SeqRecvPath, SeqSendPath,
+    AckPath, ChannelEndPath, ClientConnectionPath, CommitmentPath, ConnectionPath, ReceiptPath,
+    SeqAckPath, SeqRecvPath, SeqSendPath,
 };
 use ibc::core::host::{ExecutionContext, ValidationContext};
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::{Signer, Timestamp};
-use ibc::primitives::proto::Any;
 
 use super::types::MockContext;
 use crate::testapp::ibc::clients::mock::client_state::MockClientState;
-use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::AnyConsensusState;
 
 impl ValidationContext for MockContext {
     type V = Self;
-    type E = Self;
-    type AnyConsensusState = AnyConsensusState;
-    type AnyClientState = AnyClientState;
-
-    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError> {
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => {
-                client_record
-                    .client_state
-                    .clone()
-                    .ok_or_else(|| ClientError::ClientStateNotFound {
-                        client_id: client_id.clone(),
-                    })
-            }
-            None => Err(ClientError::ClientStateNotFound {
-                client_id: client_id.clone(),
-            }),
-        }
-        .map_err(ContextError::ClientError)
-    }
-
-    fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError> {
-        if let Ok(client_state) = ClientState::try_from(client_state.clone()) {
-            client_state.inner().validate().map_err(ClientError::from)?;
-            Ok(client_state.into())
-        } else if let Ok(client_state) = MockClientState::try_from(client_state.clone()) {
-            Ok(client_state.into())
-        } else {
-            Err(ClientError::UnknownClientStateType {
-                client_state_type: client_state.type_url,
-            })
-        }
-        .map_err(ContextError::ClientError)
-    }
-
-    fn consensus_state(
-        &self,
-        client_cons_state_path: &ClientConsensusStatePath,
-    ) -> Result<AnyConsensusState, ContextError> {
-        let client_id = &client_cons_state_path.client_id;
-        let height = Height::new(
-            client_cons_state_path.revision_number,
-            client_cons_state_path.revision_height,
-        )?;
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => match client_record.consensus_states.get(&height) {
-                Some(consensus_state) => Ok(consensus_state.clone()),
-                None => Err(ClientError::ConsensusStateNotFound {
-                    client_id: client_id.clone(),
-                    height,
-                }),
-            },
-            None => Err(ClientError::ConsensusStateNotFound {
-                client_id: client_id.clone(),
-                height,
-            }),
-        }
-        .map_err(ContextError::ClientError)
-    }
+    type HostClientState = MockClientState;
+    type HostConsensusState = MockConsensusState;
 
     fn host_height(&self) -> Result<Height, ContextError> {
         Ok(self.latest_height())
@@ -105,40 +47,31 @@ impl ValidationContext for MockContext {
             .expect("Never fails"))
     }
 
-    fn host_consensus_state(&self, height: &Height) -> Result<AnyConsensusState, ContextError> {
-        match self.host_block(height) {
-            Some(block_ref) => Ok(block_ref.clone().into()),
-            None => Err(ClientError::MissingLocalConsensusState { height: *height }),
-        }
-        .map_err(ConnectionError::Client)
-        .map_err(ContextError::ConnectionError)
-    }
-
     fn client_counter(&self) -> Result<u64, ContextError> {
         Ok(self.ibc_store.lock().client_ids_counter)
     }
 
-    fn connection_end(&self, cid: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
-        match self.ibc_store.lock().connections.get(cid) {
-            Some(connection_end) => Ok(connection_end.clone()),
-            None => Err(ConnectionError::ConnectionNotFound {
-                connection_id: cid.clone(),
-            }),
+    fn host_consensus_state(&self, height: &Height) -> Result<MockConsensusState, ContextError> {
+        let cs: AnyConsensusState = match self.host_block(height) {
+            Some(block_ref) => Ok(block_ref.clone().into()),
+            None => Err(ClientError::MissingLocalConsensusState { height: *height }),
+        }
+        .map_err(ContextError::ClientError)?;
+
+        match cs {
+            AnyConsensusState::Mock(cs) => Ok(cs),
+            _ => Err(ClientError::Other {
+                description: "unexpected consensus state type".to_string(),
+            }
+            .into()),
         }
-        .map_err(ContextError::ConnectionError)
     }
 
     fn validate_self_client(
         &self,
-        client_state_of_host_on_counterparty: Any,
+        client_state_of_host_on_counterparty: Self::HostClientState,
     ) -> Result<(), ContextError> {
-        let mock_client_state = MockClientState::try_from(client_state_of_host_on_counterparty)
-            .map_err(|_| ConnectionError::InvalidClientState {
-                reason: "client must be a mock client".to_string(),
-            })
-            .map_err(ContextError::ConnectionError)?;
-
-        if mock_client_state.is_frozen() {
+        if client_state_of_host_on_counterparty.is_frozen() {
             return Err(ClientError::ClientFrozen {
                 description: String::new(),
             }
@@ -147,25 +80,31 @@ impl ValidationContext for MockContext {
 
         let self_chain_id = &self.host_chain_id;
         let self_revision_number = self_chain_id.revision_number();
-        if self_revision_number != mock_client_state.latest_height().revision_number() {
+        if self_revision_number
+            != client_state_of_host_on_counterparty
+                .latest_height()
+                .revision_number()
+        {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client is not in the same revision as the chain. expected: {}, got: {}",
                         self_revision_number,
-                        mock_client_state.latest_height().revision_number()
+                        client_state_of_host_on_counterparty
+                            .latest_height()
+                            .revision_number()
                     ),
                 },
             ));
         }
 
         let host_current_height = self.latest_height().increment();
-        if mock_client_state.latest_height() >= host_current_height {
+        if client_state_of_host_on_counterparty.latest_height() >= host_current_height {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
                     reason: format!(
                         "client has latest height {} greater than or equal to chain height {}",
-                        mock_client_state.latest_height(),
+                        client_state_of_host_on_counterparty.latest_height(),
                         host_current_height
                     ),
                 },
@@ -175,6 +114,16 @@ impl ValidationContext for MockContext {
         Ok(())
     }
 
+    fn connection_end(&self, cid: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
+        match self.ibc_store.lock().connections.get(cid) {
+            Some(connection_end) => Ok(connection_end.clone()),
+            None => Err(ConnectionError::ConnectionNotFound {
+                connection_id: cid.clone(),
+            }),
+        }
+        .map_err(ContextError::ConnectionError)
+    }
+
     fn commitment_prefix(&self) -> CommitmentPrefix {
         CommitmentPrefix::try_from(b"mock".to_vec()).expect("Never fails")
     }
@@ -350,6 +299,8 @@ impl ValidationContext for MockContext {
 }
 
 impl ExecutionContext for MockContext {
+    type E = Self;
+
     fn get_client_execution_context(&mut self) -> &mut Self::E {
         self
     }
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index 3540aefb6..447af33fd 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -2,13 +2,14 @@ use ibc::clients::tendermint::types::{
     client_type as tm_client_type, ConsensusState as TmConsensusState,
 };
 use ibc::core::client::context::client_state::ClientStateCommon;
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient};
 use ibc::core::client::types::Height;
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::ValidationContext;
+use ibc::core::host::{ClientStateRef, ValidationContext};
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
 };
@@ -48,7 +49,7 @@ fn test_create_client_ok() {
 
     assert!(res.is_ok(), "execution happy path");
 
-    let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+    let expected_client_state = ClientStateRef::<MockContext>::try_from(msg.client_state).unwrap();
     assert_eq!(expected_client_state.client_type(), client_type);
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
@@ -84,7 +85,7 @@ fn test_tm_create_client_ok() {
 
     assert!(res.is_ok(), "tendermint client execution happy path");
 
-    let expected_client_state = ctx.decode_client_state(msg.client_state).unwrap();
+    let expected_client_state = ClientStateRef::<MockContext>::try_from(msg.client_state).unwrap();
     assert_eq!(expected_client_state.client_type(), client_type);
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index bc7bf02ad..a3fd7bec7 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -256,7 +256,7 @@ fn test_consensus_state_pruning() {
         expired_height.revision_number(),
         expired_height.revision_height(),
     );
-    assert!(ctx.update_meta(&client_id, &expired_height).is_err());
+    assert!(ctx.client_update_meta(&client_id, &expired_height).is_err());
     assert!(ctx.consensus_state(&client_cons_state_path).is_err());
 
     // Check that latest valid consensus state exists.
@@ -267,7 +267,9 @@ fn test_consensus_state_pruning() {
         earliest_valid_height.revision_height(),
     );
 
-    assert!(ctx.update_meta(&client_id, &earliest_valid_height).is_ok());
+    assert!(ctx
+        .client_update_meta(&client_id, &earliest_valid_height)
+        .is_ok());
     assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
 
     let end_host_timestamp = ctx.host_timestamp().unwrap();
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index 84d5b1fbd..d9b15c173 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -1,4 +1,5 @@
 use ibc::clients::tendermint::types::client_type;
+use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::error::{ClientError, UpgradeClientError};
 use ibc::core::client::types::msgs::{ClientMsg, MsgUpgradeClient};
 use ibc::core::client::types::Height;
@@ -7,7 +8,6 @@ use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::path::ClientConsensusStatePath;
-use ibc::core::host::ValidationContext;
 use ibc::core::primitives::downcast;
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,

From e1f19af161878f9daf779aed0f19229f97d54814 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 8 Mar 2024 11:12:25 -0800
Subject: [PATCH 124/182] docs: ADR-010 enabling standalone ICS-02 integration
 (#1116)

* docs: ADR-010 enabling standalone ICS-02 integration

* imp: explaining why decode_client_state will be removed

* imp: use diff-formatted code snippets

* chore: put a comment for decode_client_state

* chore: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* chore: apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

* imp: update with details for host_consensus_state & validate_self_client

* nit: lint markdown

* nit: rename to HostClient/ConsensusState

* imp: update ADR with changes in implementation PR

* chore: back to the original implementation idea

* fix: adjust ClientStateDecoder

* nit

* nit: add comment for minimizing associated types

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 ...010-enable-standalone-ics02-integration.md | 380 ++++++++++++++++++
 docs/architecture/assets/adr010.png           | Bin 0 -> 172082 bytes
 2 files changed, 380 insertions(+)
 create mode 100644 docs/architecture/adr-010-enable-standalone-ics02-integration.md
 create mode 100644 docs/architecture/assets/adr010.png

diff --git a/docs/architecture/adr-010-enable-standalone-ics02-integration.md b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
new file mode 100644
index 000000000..117bea108
--- /dev/null
+++ b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
@@ -0,0 +1,380 @@
+# ADR 010: ENABLE STANDALONE ICS-02 INTEGRATION
+
+## Changelog
+
+- 2024-03-05: Draft Proposed
+
+## Status
+
+Proposed
+
+## Context
+
+In ADR-07, we previously granted light client developers the flexibility to
+introduce custom APIs to the client contexts. This decision was made to
+accommodate potential scenarios where not all methods required by every future
+light client might be present in the extensive
+[`ValidationContext`](https://github.com/cosmos/ibc-rs/blob/4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce/ibc-core/ics24-host/src/context.rs#L31)
+or
+[`ExecutionContext`](https://github.com/cosmos/ibc-rs/blob/4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce/ibc-core/ics24-host/src/context.rs#L168)
+traits.
+
+In this ADR, while retaining that capability, we propose a reorganization of
+client-related APIs by consolidating them under the ICS-02 client validation and
+execution contexts. While the main top-level context traits in ICS-24
+(`ibc-core-host` crate) will still have access to these APIs through the
+existing accessor
+[`get_client_validation_context()`](https://github.com/cosmos/ibc-rs/blob/4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce/ibc-core/ics24-host/src/context.rs#L38)
+and
+[`get_client_execution_context()`](https://github.com/cosmos/ibc-rs/blob/4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce/ibc-core/ics24-host/src/context.rs#L170)
+methods.
+
+As a result of this ADR, client relevant methods, namely **`client_state()`**
+and **`consensus_state()`**, will be extracted from the large ICS-24 validation
+and execution context traits. Instead, they will find their new home under the
+ICS-02
+[`ClientValidationContext`](https://github.com/cosmos/ibc-rs/blob/caee889ad308a4aac3f9905de9cdda76c5533cfb/ibc-core/ics02-client/context/src/context.rs#L14)
+and
+[`ClientExecutionContext`](https://github.com/cosmos/ibc-rs/blob/caee889ad308a4aac3f9905de9cdda76c5533cfb/ibc-core/ics02-client/context/src/context.rs#L32)
+traits.
+
+## Objectives
+
+The primary objective is to enhance the delineation of the APIs that connect
+ibc-rs to the host’s storage, offering a more modular approach that allows
+developers who wish to integrate only the implemented client states under the
+ibc-rs to their IBC infra. In other words, this enhancement does not mandate
+hosts to implement all the IBC layers, such as connection, channel, or any of
+the IBC applications, when only light client support is required.
+
+As a result, this ADR sets the stage for several potential use cases, including:
+
+1. **Streamlines CosmWasm light client implementation**
+    - Since the refined structure allows for the independent integration of
+      ICS-02 client traits into the storage, it becomes straightforward to
+      implement light clients living in ibc-rs as CosmWasm contracts, which
+      empowers simpler Wasm client integration with ibc-go driven chains.
+
+2. **Enables client integration with various IBC implementations**
+    - Any IBC implementation, whether it is based on ibc-rs or a fork of ibc-rs,
+      will have this capability to incorporate the latest light client
+      implementations by ibc-rs. So that even if an IBC implementation diverges
+      from the ibc-rs framework, hosts can benefit from the latest version of
+      light client implementation. This is important from the security
+      standpoint, broadens the applicability of ibc-rs, and facilitates
+      collaboration with other IBC-adjacent solutions.
+
+As part of this ADR and to minimize breaking changes later, we aim to address
+the following client-relevant API deficiencies as well:
+
+1. **Refining access to validation vs execution methods**
+    - So far, unauthorized access to client execution methods [has been
+      possible](https://github.com/cosmos/ibc-rs/blob/4421b0dcd6eab6c914b8c5a7d45817b1edb6b2ce/ibc-core/ics24-host/src/context.rs#L33)
+      under the `ValidationContext`. This will be rectified to ensure that only
+      the `ClientState` validation method is callable within the validation
+      contexts. This enhances the precision of access control, aligning it more
+      closely with the intended functionality.
+
+2. **Bringing more clarity to how context APIs are related**
+    - The ambiguous relationship between the main context APIs at ICS-24, ICS-02
+      client APIs, and client-specific APIs can get cleared. This ADR aims for a
+      more transparent relationship between these contexts, making it easier to
+      understand their interactions and roles. For instance some client relevant
+      methods are located under the client contexts, while others are under the
+      main (ICS-24) contexts.
+
+3. **Minimizing associated types’ declarations**
+    - Our current APIs pose a challenge by requiring users to introduce multiple
+      yet the same associated types like `AnyClientState`, `AnyConsensusState`,
+      etc across different layers. A more efficient solution involves
+      introducing such types in fewer places, providing better access to the
+      traits across different layers. However, it's worth acknowledging that an
+      ideal solution might entail utilizing features from forthcoming stable
+      versions of Rust. This would enable us to leverage the advantages provided
+      by either
+      [associated_type_bounds](https://rust-lang.github.io/rfcs/2289-associated-type-bounds.html),
+      [associated_type_defaults](https://rust-lang.github.io/rfcs/2532-associated-type-defaults.html),
+      or
+      [implied_bounds](https://rust-lang.github.io/rfcs/2089-implied-bounds.html)
+      capabilities.
+
+## Decision
+
+Here is a high-level diagram that illustrates the optimal boundaries for each
+context trait, specifying the scope of access by each of these contexts. In
+addition, the classification of APIs should be such that they allow the
+independent integration of light client implementations.
+
+<div style="text-align: center;">
+  <img src="./assets/adr010.png" alt="Main components" width="800" height="600">
+</div>
+
+The primary `ValidationContext` and `ExecutionContext` traits at the ICS-24 host
+level will be restructured as follows, only having sufficient access to
+respective ICS-02 client contexts, without caring about the types or methods
+associated with client or consensus states of counterparty chains. It is
+noteworthy that, to better illustrate the desired outcome from the current
+state, the code snippets below are in the `diff` format.
+
+```diff
+pub trait ValidationContext {
+    type V: ClientValidationContext;
++    type HostClientState: ClientStateValidation<Self::V>;
++    type HostConsensusState: ConsensusState;
+-    type E: ClientExecutionContext;
+-    type AnyConsensusState: ConsensusState;
+-    type AnyClientState: ClientState<Self::V, Self::E>;
+
+    /// Retrieve the context that implements all clients' `ValidationContext`.
+    fn get_client_validation_context(&self) -> &Self::V;
+
+     // This method will be removed and replaced by a `ClientStateDecoder` trait that will encapsulate the ability to decode a client state from an `Any`
+-    fn decode_client_state(&self, client_state: Any) -> Result<Self::AnyClientState, ContextError>;
+
+-    fn client_state(&self, client_id: &ClientId) -> Result<Self::AnyClientState, ContextError>;
+
+-    fn consensus_state(
+-        &self,
+-        client_cons_state_path: &ClientConsensusStatePath,
+-    ) -> Result<Self::AnyConsensusState, ContextError>;
+
+    fn host_consensus_state(
+        &self,
+        height: &Height,
+-    ) -> Result<Self::AnyConsensusState, ContextError>;
++    ) -> Result<Self::HostConsensusState, ContextError>;
+
+    fn validate_self_client(
+        &self,
+-        client_state_of_host_on_counterparty: Any,
++        client_state_of_host_on_counterparty: Self::HostClientState,
+    ) -> Result<(), ContextError>;
+
+    ... // other methods
+}
+
+pub trait ExecutionContext: ValidationContext {
++    type E: ClientExecutionContext;
+
+    /// Retrieve the context that implements all clients' `ExecutionContext`.
+    fn get_client_execution_context(&mut self) -> &mut Self::E;
+
+    ... // other methods
+
+/// Convenient type aliases
++ pub type ClientStateRef<Ctx> =
++    <<Ctx as ValidationContext>::V as ClientValidationContext>::ClientStateRef;
+
++ pub type ClientStateMut<Ctx> =
++    <<Ctx as ExecutionContext>::E as ClientExecutionContext>::ClientStateMut;
+
++ pub type ConsensusStateRef<Ctx> =
++    <<Ctx as ValidationContext>::V as ClientValidationContext>::ConsensusStateRef;
+}
+```
+
+We should also highlight that ICS-02 houses various types, APIs and
+implementations essential for enabling **light clients of counterparty chains
+operating on the host chain**. Therefore, the `host_consensus_state()` and
+`validate_self_client()` methods, though initially appearing to be ICS-02
+specific, play a crucial role in the connection handshake validating receiving
+datagrams against the client and consensus states of the host.
+
+In this ADR, these methods will continue to be housed under the main context
+traits. However, we will explicitly define the accepted types for these methods
+as `HostClientState` and `HostConsensusState`. This refinement aims for more
+clarity and will optimize the decoding process, removing an unnecessary layer of
+decoding during information retrieval. Previously, the decoding process for
+these methods involved obtaining `AnyClientState` and `AnyConsensusState` types
+and then converting them into the concrete `HostClientState` and
+`HostConsensusState` types.
+
+Following the aforementioned points, in the ICS-02 level, the
+`ClientValidationContext` and `ClientExecutionContext` traits will be
+restructured as follows, containing all the client relevant methods and types:
+
+```diff
+pub trait ClientValidationContext: Sized {
+     // Given that we will be dropping `decode_client_state()` method,
+     // the client state type introduced here should have implemented `TryFrom<Any>` and `Into<Any>` traits.
++    type ClientStateRef: ClientStateValidation<Self>;
++    type ConsensusStateRef: ConsensusState;
+
++    fn client_state(&self, client_id: &ClientId) -> Result<Self::ClientStateRef, ContextError>;
+
++    fn consensus_state(
++        &self,
++        client_cons_state_path: &ClientConsensusStatePath,
++    ) -> Result<Self::ConsensusStateRef, ContextError>;
+
+    fn client_update_meta(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<(Timestamp, Height), ContextError>;
+}
+
+pub trait ClientExecutionContext:
++    ClientValidationContext<ClientStateRef = Self::ClientStateMut>
+{
+-    type V: ClientValidationContext;
+-    type AnyClientState: ClientState<Self::V, Self>;
+-    type AnyConsensusState: ConsensusState;
++    type ClientStateMut: ClientStateExecution<Self>;
+
++    fn client_state_mut(&self, client_id: &ClientId) -> Result<Self::ClientStateMut, ContextError> {
++        self.client_state(client_id)
++    }
+
+    fn store_client_state(
+        &mut self,
+        client_state_path: ClientStatePath,
+        client_state: Self::ClientStateMut,
+    ) -> Result<(), ContextError>;
+
+    fn store_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+        consensus_state: Self::ConsensusStateRef,
+    ) -> Result<(), ContextError>;
+
+    fn delete_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+    ) -> Result<(), ContextError>;
+
+    fn store_update_meta(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+        host_timestamp: Timestamp,
+        host_height: Height,
+    ) -> Result<(), ContextError>;
+
+    fn delete_update_meta(
+        &mut self,
+        client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError>;
+}
+```
+
+The introduction of the `ClientStateMut` associated type in addition to the
+`ClientStateRef` became necessary to tackle the limitation that the
+`ClientState` retrieved from the regular `client_state()` method provides access
+only to validation methods. However, in `execute` handlers, there are scenarios
+(like
+[here](https://github.com/cosmos/ibc-rs/blob/f272f30e0f773d85a99fc553b75d41f9f768d5c5/ibc-core/ics02-client/src/handler/update_client.rs#L54))
+where access to the execution methods of the client state is required. We aim to
+simplify the user experience by providing a default implementation, relieving
+users from the need to implement the `client_state_mut` method.
+
+Also, the introduction of `<ClientStateRef = Self::ClientStateMut>` is prompted
+by the need to address the characteristics of concrete `ClientState`
+definitions. For instance, in the case of ICS-07, such as `TmClientState`, the
+struct definition can't be split into two fragments, one for validation and the
+other for execution. Therefore, contexts implementing `ClientExecutionContext`
+must introduce a `ClientStateMut` type the same as `ClientStateRef`.
+
+With the mentioned classification, we can now streamline ICS-07 specific APIs,
+eliminating the requirement for implementing a redundant `consensus_state()`
+method. For the sake of simplification, we can remove the `CommonContext` trait
+and consolidate everything under the `TmValidationContext` as follows:
+
+```diff
++ /// Enables conversion (`TryInto` and `From`) between the consensus state type
++ /// used by the host and the one specific to the Tendermint light client, which
++ /// is `ConsensusStateType`.
++ pub trait ConsensusStateConverter:
++    TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
++ {
++ }
+
++ impl<C> ConsensusStateConverter for C where
++    C: TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
++ {
++ }
+
+- pub trait CommonContext {
+-    // methods will be moved to the below `ValidationContext`
+- }
+
+// Client's context required during validation
+pub trait ValidationContext:
++    ClientValidationContext<ConsensusStateRef = Self::AnyConsensusState>
+{
++    type ConversionError: ToString;
++    type AnyConsensusState: TryInto<TmConsensusState, Error = Self::ConversionError>;
+
++    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
+
++    fn host_height(&self) -> Result<Height, ContextError>;
+
+-    fn consensus_state(
+-        &self,
+-        client_cons_state_path: &ClientConsensusStatePath,
+-    ) -> Result<Self::AnyConsensusState, ContextError>;
+
++    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
+
+    fn next_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::AnyConsensusState>, ContextError>;
+
+    fn prev_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::AnyConsensusState>, ContextError>;
+}
+
+-impl<T> ExecutionContext for T where T: CommonContext + ClientExecutionContext {}
++impl<T> ExecutionContext for T where T: ValidationContext + ClientExecutionContext {}
+
+```
+
+### Remarks
+
+- We move away from the `decode_client_state()` method. Since per our design,
+  users must utilize a `ClientState` type that implements both `TryFrom<Any>`
+  and `Into<Any>`, therefore, we can offer a trait called `ClientStateDecoder`
+  as follows, making it readily available for users seeking to decode/encode a
+  client state from/into the `Any` type:
+
+    ```rust
+    pub trait ClientStateDecoder: TryFrom<Any, Error = ClientError> + Into<Any> {}
+
+    impl<T> ClientStateDecoder for T where T: TryFrom<Any, Error = ClientError> {}
+
+    ```
+
+- We will maintain the `client_counter()` and `increase_client_counter()`
+  methods within the main context traits. This stems from the fact that light
+  clients do not rely on the relative positions in their processes.
+  Additionally, these counters are globally tracked, and only IBC handlers
+  invoke these methods for setting or retrieving client identifiers.
+
+## Consequences
+
+### Positive
+
+- Enables easy light client integration without the need for integrating the
+  entire IBC stack
+- Establishes a clearer relationship between APIs (ICS-02 <> ICS-24), promoting
+  better development practices
+- Eliminates redundant methods/types, enhancing integration efficiency
+- Methods under the client contexts will align more with ibc-go client keepers,
+  improving interoperability.
+
+### Negative
+
+- Some challenges may arise in identifying trait bounds during a light client
+  implementation.
+  - Introducing user-importable type aliases helps mitigate this concern.
+- Additionally, this ADR employs significant breaking changes to the hosts.
+
+## References
+
+- [Issue link](https://github.com/cosmos/ibc-rs/issues/1114)
diff --git a/docs/architecture/assets/adr010.png b/docs/architecture/assets/adr010.png
new file mode 100644
index 0000000000000000000000000000000000000000..c64e4c40f7c95ef29f42e65e40f7db22de3da113
GIT binary patch
literal 172082
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%0DI~ZPk
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%0A~#s2<}&A&U#{bPB}FY39;MSiZ394c
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

literal 0
HcmV?d00001


From b2c252940daeede358952bee75cc2b51fccf7683 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 12 Mar 2024 14:18:10 +0100
Subject: [PATCH 125/182] fix: bump MSRV to 1.71.1 (#1119)

* bump msrv to 1.71.1

* add ci check

* rm windows

* refactor msrv check

* use cargo-msrv

* add names to steps

* apply clippy suggestions

* rm redundant import

* clippy::use_self

* clippy::cast_lossless

* clippy::match_same_arms

* apply clippy suggestions

* reuse old var

* refactor old code

* badge for license, version, downloads

* rm broken tokei loc badge

* add changelog

* clippy::derive_partial_eq_without_eq

* clippy::string_lit_as_bytes

* clippy::empty_line_after_doc_comments

* clippy::cloned_instead_of_copied

* clippy::unreadable_literal

* clippy::single_match_else

* expect over unwrap

* use let-else

* use ok_or_else

* propagate None

* clippy::match_same_arms

* return precise error

* rm downcast in favor of let-else

* chore: add unclog for 1101 + move 1118 under breaking-changes

* add msrv in clippy config

* update changelog

* use into over from

* clippy::redundant_closure_for_method_calls

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../breaking-changes/1118-bump-msrv.md        |   2 +
 .../1101-use-let-else-over-downcast.md        |   2 +
 .../1120-rm-redundant-shadowing.md            |   2 +
 .github/workflows/rust.yml                    |  45 +++++
 Cargo.toml                                    |   2 +-
 README.md                                     |  14 +-
 clippy.toml                                   |   1 +
 ibc-apps/ics20-transfer/src/module.rs         |  59 +++----
 ibc-apps/ics20-transfer/types/src/error.rs    |   8 +-
 ibc-apps/ics721-nft-transfer/src/module.rs    |  58 +++---
 .../ics721-nft-transfer/types/src/data.rs     |   2 +-
 .../ics721-nft-transfer/types/src/error.rs    |   8 +-
 .../ics07-tendermint/src/client_state.rs      |   3 +-
 .../src/client_state/execution.rs             |   2 +-
 .../src/client_state/update_client.rs         |  65 ++++---
 .../ics07-tendermint/src/consensus_state.rs   |   2 +-
 .../types/src/client_state.rs                 |  12 +-
 .../ics07-tendermint/types/src/error.rs       |   6 +-
 ibc-core/ics02-client/types/src/error.rs      |  14 +-
 ibc-core/ics02-client/types/src/height.rs     |  17 +-
 ibc-core/ics03-connection/types/src/error.rs  |  12 +-
 ibc-core/ics03-connection/types/src/events.rs |   4 +-
 .../types/src/msgs/conn_open_init.rs          |   4 +-
 .../src/handler/acknowledgement.rs            |  11 +-
 ibc-core/ics04-channel/src/handler/timeout.rs |  11 +-
 .../src/handler/timeout_on_close.rs           |   6 +-
 .../types/src/acknowledgement.rs              |   3 +-
 .../ics04-channel/types/src/commitment.rs     |   2 +-
 .../ics04-channel/types/src/events/mod.rs     |   6 +-
 ibc-core/ics23-commitment/types/src/merkle.rs |   2 +-
 ibc-core/ics23-commitment/types/src/specs.rs  |   9 +-
 .../cosmos/src/upgrade_proposal/proposal.rs   |  10 +-
 .../types/src/identifiers/chain_id.rs         |  32 ++--
 ibc-core/ics24-host/types/src/path.rs         | 167 ++++--------------
 ibc-core/ics25-handler/src/entrypoint.rs      |   4 +-
 ibc-derive/src/client_state.rs                |  23 ++-
 .../traits/client_state_common.rs             |   6 +-
 ibc-derive/src/consensus_state.rs             |   4 +-
 ibc-derive/src/utils.rs                       |   9 +-
 ibc-primitives/src/types/timestamp.rs         |  69 ++++----
 ibc-primitives/src/utils/macros.rs            |  51 ------
 ibc-primitives/src/utils/mod.rs               |   1 -
 ibc-query/src/core/client/query.rs            |   2 +-
 .../src/fixtures/clients/tendermint.rs        |   6 +-
 .../src/fixtures/core/channel/packet.rs       |   4 +-
 .../fixtures/core/client/msg_update_client.rs |   2 +-
 .../core/client/msg_upgrade_client.rs         |   2 +-
 .../testapp/ibc/clients/mock/client_state.rs  |   5 +-
 ibc-testkit/src/testapp/ibc/clients/mod.rs    |   2 +-
 .../src/testapp/ibc/core/client_ctx.rs        |   8 +-
 ibc-testkit/src/testapp/ibc/core/types.rs     |   6 +-
 .../tests/core/ics02_client/update_client.rs  |  17 +-
 .../tests/core/ics02_client/upgrade_client.rs |   6 +-
 .../core/ics03_connection/conn_open_ack.rs    |   5 +-
 .../ics03_connection/conn_open_confirm.rs     |   5 +-
 .../core/ics03_connection/conn_open_init.rs   |   5 +-
 .../core/ics03_connection/conn_open_try.rs    |   5 +-
 ibc/README.md                                 |  12 +-
 58 files changed, 348 insertions(+), 514 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1118-bump-msrv.md
 create mode 100644 .changelog/unreleased/improvements/1101-use-let-else-over-downcast.md
 create mode 100644 .changelog/unreleased/improvements/1120-rm-redundant-shadowing.md
 delete mode 100644 ibc-primitives/src/utils/macros.rs

diff --git a/.changelog/unreleased/breaking-changes/1118-bump-msrv.md b/.changelog/unreleased/breaking-changes/1118-bump-msrv.md
new file mode 100644
index 000000000..631b644d3
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1118-bump-msrv.md
@@ -0,0 +1,2 @@
+- [ibc] Increase minimum supported Rust version to 1.71.1
+  ([\#1118](https://github.com/cosmos/ibc-rs/issues/1118))
diff --git a/.changelog/unreleased/improvements/1101-use-let-else-over-downcast.md b/.changelog/unreleased/improvements/1101-use-let-else-over-downcast.md
new file mode 100644
index 000000000..876e19c91
--- /dev/null
+++ b/.changelog/unreleased/improvements/1101-use-let-else-over-downcast.md
@@ -0,0 +1,2 @@
+- [ibc-primitives] Use `let-else` over `downcast!()` and remove `utils/macros`
+  module as a result ([\#1118](https://github.com/cosmos/ibc-rs/issues/1118))
diff --git a/.changelog/unreleased/improvements/1120-rm-redundant-shadowing.md b/.changelog/unreleased/improvements/1120-rm-redundant-shadowing.md
new file mode 100644
index 000000000..80eb17307
--- /dev/null
+++ b/.changelog/unreleased/improvements/1120-rm-redundant-shadowing.md
@@ -0,0 +1,2 @@
+- [ibc-core] Remove unnecessary shadowing with same value
+  ([\#1120](https://github.com/cosmos/ibc-rs/issues/1120))
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 8d25e7716..45ff97c05 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -157,3 +157,48 @@ jobs:
         with:
           command: test
           args: --no-default-features --no-fail-fast --no-run
+
+  test-msrv:
+    timeout-minutes: 30
+    env:
+      CARGO_MSRV_VERSION: 0.16.0-beta.20
+      MSRV: 1.71.1
+    strategy:
+      matrix:
+        param:
+          [
+            { os: ubuntu-latest, system: unknown-linux-gnu },
+            { os: macos-latest, system: apple-darwin },
+          ]
+    runs-on: ${{ matrix.param.os }}
+    steps:
+      - uses: actions/checkout@v2
+
+      - name: Download cargo-msrv
+        uses: dsaltares/fetch-gh-release-asset@master
+        with:
+          repo: foresterre/cargo-msrv
+          version: "tags/v${{ env.CARGO_MSRV_VERSION }}"
+          file: "cargo-msrv-x86_64-${{ matrix.param.system }}-v${{ env.CARGO_MSRV_VERSION }}.tgz"
+
+      - uses: actions-rs/toolchain@v1
+        with:
+          toolchain: ${{ env.MSRV }}
+          override: true
+      - uses: Swatinem/rust-cache@v1
+
+      - name: Install cargo-msrv
+        run: |
+          tar -xzf "cargo-msrv-x86_64-${{ matrix.param.system }}-v${{ env.CARGO_MSRV_VERSION }}.tgz"
+          mv "cargo-msrv-x86_64-${{ matrix.param.system }}-v${{ env.CARGO_MSRV_VERSION }}/cargo-msrv" ~/.cargo/bin
+          cargo msrv --version
+
+      - name: Calculate MSRV
+        run: cargo msrv --output-format minimal --min 1.64.0
+
+      - name: Build with MSRV
+        uses: actions-rs/cargo@v1
+        with:
+          toolchain: ${{ env.MSRV }}
+          command: build
+          args: --all-features
diff --git a/Cargo.toml b/Cargo.toml
index c4590de59..e3efe6af3 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -43,7 +43,7 @@ exclude = [
 version      = "0.50.0"
 license      = "Apache-2.0"
 edition      = "2021"
-rust-version = "1.64"
+rust-version = "1.71.1"
 readme       = "README.md"
 repository   = "https://github.com/cosmos/ibc-rs"
 authors      = ["Informal Systems <hello@informal.systems>"]
diff --git a/README.md b/README.md
index 4bdeeafcf..226f0a49e 100644
--- a/README.md
+++ b/README.md
@@ -16,9 +16,9 @@
 [![Build Status][build-image]][build-link]
 [![Code Coverage][codecov-image]][codecov-link]
 [![Apache 2.0 Licensed][license-image]][license-link]
-![Rust Stable][rustc-image]
-![Rust 1.64+][rustc-version]
-![Lines of Code][loc-image]
+![Version][crates-io-version]
+![Downloads][crates-io-downloads]
+![Rust Stable][msrv-image]
 
 </div>
 </div>
@@ -94,11 +94,11 @@ specific language governing permissions and limitations under the License.
 [build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
 [codecov-image]: https://codecov.io/gh/cosmos/ibc-rs/branch/main/graph/badge.svg?token=wUm2aLCOu
 [codecov-link]: https://codecov.io/gh/cosmos/ibc-rs
-[loc-image]: https://tokei.rs/b1/github/cosmos/ibc-rs
-[license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
+[license-image]: https://img.shields.io/crates/l/ibc
 [license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
-[rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
-[rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
+[crates-io-version]: https://img.shields.io/crates/v/ibc.svg
+[crates-io-downloads]: https://img.shields.io/crates/d/ibc.svg
+[msrv-image]: https://img.shields.io/crates/msrv/ibc
 
 [//]: # (general links)
 [ibc]: https://github.com/cosmos/ibc
diff --git a/clippy.toml b/clippy.toml
index 87ee0dae3..76e4dff64 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -7,3 +7,4 @@ disallowed-types = [
 disallowed-methods = [
     "std::time::Duration::as_secs_f64",
 ]
+msrv = "1.71.1"
diff --git a/ibc-apps/ics20-transfer/src/module.rs b/ibc-apps/ics20-transfer/src/module.rs
index f1f7d3a61..392ca5939 100644
--- a/ibc-apps/ics20-transfer/src/module.rs
+++ b/ibc-apps/ics20-transfer/src/module.rs
@@ -170,13 +170,10 @@ pub fn on_recv_packet_execute(
     ctx_b: &mut impl TokenTransferExecutionContext,
     packet: &Packet,
 ) -> (ModuleExtras, Acknowledgement) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            let ack =
-                AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into());
-            return (ModuleExtras::empty(), ack.into());
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        let ack =
+            AcknowledgementStatus::error(TokenTransferError::PacketDataDeserialization.into());
+        return (ModuleExtras::empty(), ack.into());
     };
 
     let (mut extras, ack) = match process_recv_packet_execute(ctx_b, packet, data.clone()) {
@@ -225,26 +222,21 @@ pub fn on_acknowledgement_packet_execute(
     acknowledgement: &Acknowledgement,
     _relayer: &Signer,
 ) -> (ModuleExtras, Result<(), TokenTransferError>) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            return (
-                ModuleExtras::empty(),
-                Err(TokenTransferError::PacketDataDeserialization),
-            );
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        return (
+            ModuleExtras::empty(),
+            Err(TokenTransferError::PacketDataDeserialization),
+        );
     };
 
-    let acknowledgement =
-        match serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref()) {
-            Ok(ack) => ack,
-            Err(_) => {
-                return (
-                    ModuleExtras::empty(),
-                    Err(TokenTransferError::AckDeserialization),
-                );
-            }
-        };
+    let Ok(acknowledgement) =
+        serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref())
+    else {
+        return (
+            ModuleExtras::empty(),
+            Err(TokenTransferError::AckDeserialization),
+        );
+    };
 
     if !acknowledgement.is_successful() {
         if let Err(err) = refund_packet_token_execute(ctx, packet, &data) {
@@ -290,14 +282,11 @@ pub fn on_timeout_packet_execute(
     packet: &Packet,
     _relayer: &Signer,
 ) -> (ModuleExtras, Result<(), TokenTransferError>) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            return (
-                ModuleExtras::empty(),
-                Err(TokenTransferError::PacketDataDeserialization),
-            );
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        return (
+            ModuleExtras::empty(),
+            Err(TokenTransferError::PacketDataDeserialization),
+        );
     };
 
     if let Err(err) = refund_packet_token_execute(ctx, packet, &data) {
@@ -347,7 +336,7 @@ mod test {
         // Check that it's the same output as ibc-go
         // Note: this also implicitly checks that the ack bytes are non-empty,
         // which would make the conversion to `Acknowledgement` panic
-        assert_eq!(ack_success, r#"{"result":"AQ=="}"#.as_bytes());
+        assert_eq!(ack_success, br#"{"result":"AQ=="}"#);
     }
 
     #[test]
@@ -361,7 +350,7 @@ mod test {
         // which would make the conversion to `Acknowledgement` panic
         assert_eq!(
             ack_error,
-            r#"{"error":"failed to deserialize packet data"}"#.as_bytes()
+            br#"{"error":"failed to deserialize packet data"}"#
         );
     }
 
diff --git a/ibc-apps/ics20-transfer/types/src/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
index 2ef3f732a..257fbc29d 100644
--- a/ibc-apps/ics20-transfer/types/src/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -84,12 +84,12 @@ impl std::error::Error for TokenTransferError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             Self::ContextError(e) => Some(e),
-            Self::InvalidIdentifier(e) => Some(e),
-            Self::InvalidTracePortId {
+            Self::InvalidIdentifier(e)
+            | Self::InvalidTracePortId {
                 validation_error: e,
                 ..
-            } => Some(e),
-            Self::InvalidTraceChannelId {
+            }
+            | Self::InvalidTraceChannelId {
                 validation_error: e,
                 ..
             } => Some(e),
diff --git a/ibc-apps/ics721-nft-transfer/src/module.rs b/ibc-apps/ics721-nft-transfer/src/module.rs
index 87fdfc637..337bffcad 100644
--- a/ibc-apps/ics721-nft-transfer/src/module.rs
+++ b/ibc-apps/ics721-nft-transfer/src/module.rs
@@ -172,13 +172,9 @@ pub fn on_recv_packet_execute(
     ctx_b: &mut impl NftTransferExecutionContext,
     packet: &Packet,
 ) -> (ModuleExtras, Acknowledgement) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            let ack =
-                AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into());
-            return (ModuleExtras::empty(), ack.into());
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        let ack = AcknowledgementStatus::error(NftTransferError::PacketDataDeserialization.into());
+        return (ModuleExtras::empty(), ack.into());
     };
 
     let (mut extras, ack) = match process_recv_packet_execute(ctx_b, packet, data.clone()) {
@@ -227,26 +223,21 @@ pub fn on_acknowledgement_packet_execute(
     acknowledgement: &Acknowledgement,
     _relayer: &Signer,
 ) -> (ModuleExtras, Result<(), NftTransferError>) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            return (
-                ModuleExtras::empty(),
-                Err(NftTransferError::PacketDataDeserialization),
-            );
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        return (
+            ModuleExtras::empty(),
+            Err(NftTransferError::PacketDataDeserialization),
+        );
     };
 
-    let acknowledgement =
-        match serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref()) {
-            Ok(ack) => ack,
-            Err(_) => {
-                return (
-                    ModuleExtras::empty(),
-                    Err(NftTransferError::AckDeserialization),
-                );
-            }
-        };
+    let Ok(acknowledgement) =
+        serde_json::from_slice::<AcknowledgementStatus>(acknowledgement.as_ref())
+    else {
+        return (
+            ModuleExtras::empty(),
+            Err(NftTransferError::AckDeserialization),
+        );
+    };
 
     if !acknowledgement.is_successful() {
         if let Err(err) = refund_packet_nft_execute(ctx, packet, &data) {
@@ -289,14 +280,11 @@ pub fn on_timeout_packet_execute(
     packet: &Packet,
     _relayer: &Signer,
 ) -> (ModuleExtras, Result<(), NftTransferError>) {
-    let data = match serde_json::from_slice::<PacketData>(&packet.data) {
-        Ok(data) => data,
-        Err(_) => {
-            return (
-                ModuleExtras::empty(),
-                Err(NftTransferError::PacketDataDeserialization),
-            );
-        }
+    let Ok(data) = serde_json::from_slice::<PacketData>(&packet.data) else {
+        return (
+            ModuleExtras::empty(),
+            Err(NftTransferError::PacketDataDeserialization),
+        );
     };
 
     if let Err(err) = refund_packet_nft_execute(ctx, packet, &data) {
@@ -346,7 +334,7 @@ mod test {
         // Check that it's the same output as ibc-go
         // Note: this also implicitly checks that the ack bytes are non-empty,
         // which would make the conversion to `Acknowledgement` panic
-        assert_eq!(ack_success, r#"{"result":"AQ=="}"#.as_bytes());
+        assert_eq!(ack_success, br#"{"result":"AQ=="}"#);
     }
 
     #[test]
@@ -359,7 +347,7 @@ mod test {
         // which would make the conversion to `Acknowledgement` panic
         assert_eq!(
             ack_error,
-            r#"{"error":"failed to deserialize packet data"}"#.as_bytes()
+            br#"{"error":"failed to deserialize packet data"}"#
         );
     }
 
diff --git a/ibc-apps/ics721-nft-transfer/types/src/data.rs b/ibc-apps/ics721-nft-transfer/types/src/data.rs
index c94e9ee31..e6e4afbee 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/data.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/data.rs
@@ -161,7 +161,7 @@ impl borsh::BorshSerialize for DataValue {
             Some(mime) => mime.to_string(),
             None => String::default(),
         };
-        borsh::BorshSerialize::serialize(&mime.to_string(), writer)?;
+        borsh::BorshSerialize::serialize(&mime, writer)?;
         Ok(())
     }
 }
diff --git a/ibc-apps/ics721-nft-transfer/types/src/error.rs b/ibc-apps/ics721-nft-transfer/types/src/error.rs
index 08ab598e5..7651e7cb7 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/error.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/error.rs
@@ -97,16 +97,16 @@ impl std::error::Error for NftTransferError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             Self::ContextError(e) => Some(e),
-            Self::InvalidIdentifier(e) => Some(e),
             Self::InvalidUri {
                 validation_error: e,
                 ..
             } => Some(e),
-            Self::InvalidTracePortId {
+            Self::InvalidIdentifier(e)
+            | Self::InvalidTracePortId {
                 validation_error: e,
                 ..
-            } => Some(e),
-            Self::InvalidTraceChannelId {
+            }
+            | Self::InvalidTraceChannelId {
                 validation_error: e,
                 ..
             } => Some(e),
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index bb9415487..13c10b963 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -85,7 +85,6 @@ mod tests {
     use ibc_core_client::types::Height;
     use ibc_core_commitment_types::specs::ProofSpecs;
     use ibc_core_host::types::identifiers::ChainId;
-    use tests::common::validate_proof_height;
 
     use super::*;
 
@@ -109,7 +108,7 @@ mod tests {
             id: ChainId::new("ibc-1").unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
-            unbonding_period: Duration::new(128000, 0),
+            unbonding_period: Duration::new(128_000, 0),
             max_clock_drift: Duration::new(3, 0),
             latest_height: Height::new(1, 10).expect("Never fails"),
             proof_specs: ProofSpecs::default(),
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index c42950ca0..58e1d337b 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -259,7 +259,7 @@ where
     // this consensus state should not be used for packet verification as
     // the root is empty. The next consensus state submitted using update
     // will be usable for packet-verification.
-    let sentinel_root = "sentinel_root".as_bytes().to_vec();
+    let sentinel_root = b"sentinel_root".to_vec();
     let new_consensus_state = ConsensusStateType::new(
         sentinel_root.into(),
         upgraded_tm_cons_state.timestamp(),
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index d6dbaa2c8..56afd0b7c 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -117,52 +117,49 @@ where
         ctx.consensus_state(&path_at_header_height).ok()
     };
 
-    match maybe_existing_consensus_state {
-        Some(existing_consensus_state) => {
-            let existing_consensus_state = existing_consensus_state.try_into()?;
+    if let Some(existing_consensus_state) = maybe_existing_consensus_state {
+        let existing_consensus_state = existing_consensus_state.try_into()?;
 
-            let header_consensus_state = ConsensusStateType::from(header.clone());
+        let header_consensus_state = ConsensusStateType::from(header);
 
-            // There is evidence of misbehaviour if the stored consensus state
-            // is different from the new one we received.
-            Ok(existing_consensus_state != header_consensus_state)
-        }
-        None => {
-            // If no header was previously installed, we ensure the monotonicity of timestamps.
+        // There is evidence of misbehaviour if the stored consensus state
+        // is different from the new one we received.
+        Ok(existing_consensus_state != header_consensus_state)
+    } else {
+        // If no header was previously installed, we ensure the monotonicity of timestamps.
 
-            // 1. for all headers, the new header needs to have a larger timestamp than
-            //    the “previous header”
-            {
-                let maybe_prev_cs = ctx.prev_consensus_state(client_id, &header.height())?;
+        // 1. for all headers, the new header needs to have a larger timestamp than
+        //    the “previous header”
+        {
+            let maybe_prev_cs = ctx.prev_consensus_state(client_id, &header.height())?;
 
-                if let Some(prev_cs) = maybe_prev_cs {
-                    // New header timestamp cannot occur *before* the
-                    // previous consensus state's height
-                    let prev_cs = prev_cs.try_into()?;
+            if let Some(prev_cs) = maybe_prev_cs {
+                // New header timestamp cannot occur *before* the
+                // previous consensus state's height
+                let prev_cs = prev_cs.try_into()?;
 
-                    if header.signed_header.header().time <= prev_cs.timestamp() {
-                        return Ok(true);
-                    }
+                if header.signed_header.header().time <= prev_cs.timestamp() {
+                    return Ok(true);
                 }
             }
+        }
 
-            // 2. if a header comes in and is not the “last” header, then we also ensure
-            //    that its timestamp is less than the “next header”
-            if header.height() < client_state.latest_height {
-                let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
+        // 2. if a header comes in and is not the “last” header, then we also ensure
+        //    that its timestamp is less than the “next header”
+        if header.height() < client_state.latest_height {
+            let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
 
-                if let Some(next_cs) = maybe_next_cs {
-                    // New (untrusted) header timestamp cannot occur *after* next
-                    // consensus state's height
-                    let next_cs = next_cs.try_into()?;
+            if let Some(next_cs) = maybe_next_cs {
+                // New (untrusted) header timestamp cannot occur *after* next
+                // consensus state's height
+                let next_cs = next_cs.try_into()?;
 
-                    if header.signed_header.header().time >= next_cs.timestamp() {
-                        return Ok(true);
-                    }
+                if header.signed_header.header().time >= next_cs.timestamp() {
+                    return Ok(true);
                 }
             }
-
-            Ok(false)
         }
+
+        Ok(false)
     }
 }
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
index a09fc705a..242c82be4 100644
--- a/ibc-clients/ics07-tendermint/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -22,7 +22,7 @@ use tendermint::{Hash, Time};
 /// bypass Rust's orphan rules and implement traits from
 /// `ibc::core::client::context` on the `ConsensusState` type.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, PartialEq, derive_more::From)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub struct ConsensusState(ConsensusStateType);
 
 impl ConsensusState {
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 98ed61132..a533858a2 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -320,12 +320,10 @@ impl From<ClientState> for RawTmClientState {
             // decode the `ClientState` value. In `RawClientState`, a
             // `frozen_height` of `0` means "not frozen". See:
             // https://github.com/cosmos/ibc-go/blob/8422d0c4c35ef970539466c5bdec1cd27369bab3/modules/light-clients/07-tendermint/types/client_state.go#L74
-            frozen_height: Some(value.frozen_height.map(|height| height.into()).unwrap_or(
-                RawHeight {
-                    revision_number: 0,
-                    revision_height: 0,
-                },
-            )),
+            frozen_height: Some(value.frozen_height.map(Into::into).unwrap_or(RawHeight {
+                revision_number: 0,
+                revision_height: 0,
+            })),
             latest_height: Some(value.latest_height.into()),
             proof_specs: value.proof_specs.into(),
             upgrade_path: value.upgrade_path,
@@ -437,7 +435,7 @@ mod tests {
             id: ChainId::new("ibc-0").unwrap(),
             trust_level: TrustThreshold::ONE_THIRD,
             trusting_period: Duration::new(64000, 0),
-            unbonding_period: Duration::new(128000, 0),
+            unbonding_period: Duration::new(128_000, 0),
             max_clock_drift: Duration::new(3, 0),
             latest_height: Height::new(0, 10).expect("Never fails"),
             proof_specs: ProofSpecs::default(),
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index 3e2a51112..ad53989fb 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -100,9 +100,9 @@ impl std::error::Error for Error {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             Self::InvalidIdentifier(e) => Some(e),
-            Self::InvalidHeader { error: e, .. } => Some(e),
-            Self::InvalidTendermintTrustThreshold(e) => Some(e),
-            Self::InvalidRawHeader(e) => Some(e),
+            Self::InvalidHeader { error: e, .. }
+            | Self::InvalidTendermintTrustThreshold(e)
+            | Self::InvalidRawHeader(e) => Some(e),
             _ => None,
         }
     }
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index c34eb0436..181d2ca5f 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -107,12 +107,11 @@ impl From<&'static str> for ClientError {
 impl std::error::Error for ClientError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            Self::InvalidMsgUpdateClientId(e) => Some(e),
-            Self::InvalidClientIdentifier(e) => Some(e),
-            Self::InvalidRawMisbehaviour(e) => Some(e),
-            Self::InvalidCommitmentProof(e) => Some(e),
+            Self::InvalidMsgUpdateClientId(e)
+            | Self::InvalidClientIdentifier(e)
+            | Self::InvalidRawMisbehaviour(e) => Some(e),
+            Self::InvalidCommitmentProof(e) | Self::Ics23Verification(e) => Some(e),
             Self::InvalidPacketTimestamp(e) => Some(e),
-            Self::Ics23Verification(e) => Some(e),
             _ => None,
         }
     }
@@ -148,8 +147,9 @@ impl From<UpgradeClientError> for ClientError {
 impl std::error::Error for UpgradeClientError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            Self::InvalidUpgradeClientProof(e) => Some(e),
-            Self::InvalidUpgradeConsensusStateProof(e) => Some(e),
+            Self::InvalidUpgradeClientProof(e) | Self::InvalidUpgradeConsensusStateProof(e) => {
+                Some(e)
+            }
             _ => None,
         }
     }
diff --git a/ibc-core/ics02-client/types/src/height.rs b/ibc-core/ics02-client/types/src/height.rs
index 889c47c81..db809591a 100644
--- a/ibc-core/ics02-client/types/src/height.rs
+++ b/ibc-core/ics02-client/types/src/height.rs
@@ -149,7 +149,7 @@ impl core::fmt::Display for Height {
 }
 
 /// Encodes all errors related to chain heights
-#[derive(Debug, Display, PartialEq)]
+#[derive(Debug, Display, PartialEq, Eq)]
 pub enum HeightError {
     /// cannot convert into a `Height` type from string `{height}`
     HeightConversion {
@@ -167,8 +167,7 @@ impl std::error::Error for HeightError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
             HeightError::HeightConversion { error: e, .. } => Some(e),
-            HeightError::ZeroHeight => None,
-            HeightError::InvalidFormat { .. } => None,
+            HeightError::ZeroHeight | HeightError::InvalidFormat { .. } => None,
         }
     }
 }
@@ -177,14 +176,12 @@ impl TryFrom<&str> for Height {
     type Error = HeightError;
 
     fn try_from(value: &str) -> Result<Self, Self::Error> {
-        let (rev_number_str, rev_height_str) = match value.split_once('-') {
-            Some((rev_number_str, rev_height_str)) => (rev_number_str, rev_height_str),
-            None => {
-                return Err(HeightError::InvalidFormat {
+        let (rev_number_str, rev_height_str) =
+            value
+                .split_once('-')
+                .ok_or_else(|| HeightError::InvalidFormat {
                     raw_height: value.to_owned(),
-                })
-            }
-        };
+                })?;
 
         let revision_number =
             rev_number_str
diff --git a/ibc-core/ics03-connection/types/src/error.rs b/ibc-core/ics03-connection/types/src/error.rs
index b9cb0460b..bdd7e1299 100644
--- a/ibc-core/ics03-connection/types/src/error.rs
+++ b/ibc-core/ics03-connection/types/src/error.rs
@@ -91,15 +91,15 @@ pub enum ConnectionError {
 impl std::error::Error for ConnectionError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            Self::Client(e) => Some(e),
-            Self::InvalidIdentifier(e) => Some(e),
-            Self::VerifyConnectionState(e) => Some(e),
-            Self::ConsensusStateVerificationFailure {
+            Self::Client(e)
+            | Self::VerifyConnectionState(e)
+            | Self::ConsensusStateVerificationFailure {
                 client_error: e, ..
-            } => Some(e),
-            Self::ClientStateVerificationFailure {
+            }
+            | Self::ClientStateVerificationFailure {
                 client_error: e, ..
             } => Some(e),
+            Self::InvalidIdentifier(e) => Some(e),
             Self::TimestampOverflow(e) => Some(e),
             _ => None,
         }
diff --git a/ibc-core/ics03-connection/types/src/events.rs b/ibc-core/ics03-connection/types/src/events.rs
index 0d10512a4..1866a3982 100644
--- a/ibc-core/ics03-connection/types/src/events.rs
+++ b/ibc-core/ics03-connection/types/src/events.rs
@@ -366,7 +366,7 @@ mod tests {
                 )
                 .into(),
                 expected_keys: expected_keys.clone(),
-                expected_values: expected_values.iter().rev().cloned().collect(),
+                expected_values: expected_values.iter().rev().copied().collect(),
             },
             Test {
                 kind: CONNECTION_OPEN_ACK_EVENT,
@@ -385,7 +385,7 @@ mod tests {
                 event: OpenConfirm::new(conn_id_on_b, client_id_on_b, conn_id_on_a, client_id_on_a)
                     .into(),
                 expected_keys: expected_keys.clone(),
-                expected_values: expected_values.iter().rev().cloned().collect(),
+                expected_values: expected_values.iter().rev().copied().collect(),
             },
         ];
 
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
index f077945be..2a93b1bd3 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_init.rs
@@ -100,7 +100,7 @@ impl TryFrom<RawMsgConnectionOpenInit> for MsgConnectionOpenInit {
                 .parse()
                 .map_err(ConnectionError::InvalidIdentifier)?,
             counterparty,
-            version: msg.version.map(|version| version.try_into()).transpose()?,
+            version: msg.version.map(TryInto::try_into).transpose()?,
             delay_period: Duration::from_nanos(msg.delay_period),
             signer: msg.signer.into(),
         })
@@ -112,7 +112,7 @@ impl From<MsgConnectionOpenInit> for RawMsgConnectionOpenInit {
         RawMsgConnectionOpenInit {
             client_id: ics_msg.client_id_on_a.as_str().to_string(),
             counterparty: Some(ics_msg.counterparty.into()),
-            version: ics_msg.version.map(|version| version.into()),
+            version: ics_msg.version.map(Into::into),
             delay_period: ics_msg.delay_period.as_nanos() as u64,
             signer: ics_msg.signer.to_string(),
         }
diff --git a/ibc-core/ics04-channel/src/handler/acknowledgement.rs b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
index ec6aa41bc..c58edc74a 100644
--- a/ibc-core/ics04-channel/src/handler/acknowledgement.rs
+++ b/ibc-core/ics04-channel/src/handler/acknowledgement.rs
@@ -74,11 +74,6 @@ where
 
     // apply state changes
     {
-        let commitment_path_on_a = CommitmentPath {
-            port_id: msg.packet.port_id_on_a.clone(),
-            channel_id: msg.packet.chan_id_on_a.clone(),
-            sequence: msg.packet.seq_on_a,
-        };
         ctx_a.delete_packet_commitment(&commitment_path_on_a)?;
 
         if let Order::Ordered = chan_end_on_a.ordering {
@@ -136,14 +131,12 @@ where
         CommitmentPath::new(&packet.port_id_on_a, &packet.chan_id_on_a, packet.seq_on_a);
 
     // Verify packet commitment
-    let commitment_on_a = match ctx_a.get_packet_commitment(&commitment_path_on_a) {
-        Ok(commitment_on_a) => commitment_on_a,
-
+    let Ok(commitment_on_a) = ctx_a.get_packet_commitment(&commitment_path_on_a) else {
         // This error indicates that the timeout has already been relayed
         // or there is a misconfigured relayer attempting to prove a timeout
         // for a packet never sent. Core IBC will treat this error as a no-op in order to
         // prevent an entire relay transaction from failing and consuming unnecessary fees.
-        Err(_) => return Ok(()),
+        return Ok(());
     };
 
     if commitment_on_a
diff --git a/ibc-core/ics04-channel/src/handler/timeout.rs b/ibc-core/ics04-channel/src/handler/timeout.rs
index aca19b9f8..ef478ed4e 100644
--- a/ibc-core/ics04-channel/src/handler/timeout.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout.rs
@@ -82,11 +82,6 @@ where
 
     // apply state changes
     let chan_end_on_a = {
-        let commitment_path_on_a = CommitmentPath {
-            port_id: packet.port_id_on_a.clone(),
-            channel_id: packet.chan_id_on_a.clone(),
-            sequence: packet.seq_on_a,
-        };
         ctx_a.delete_packet_commitment(&commitment_path_on_a)?;
 
         if let Order::Ordered = chan_end_on_a.ordering {
@@ -160,14 +155,12 @@ where
         &msg.packet.chan_id_on_a,
         msg.packet.seq_on_a,
     );
-    let commitment_on_a = match ctx_a.get_packet_commitment(&commitment_path_on_a) {
-        Ok(commitment_on_a) => commitment_on_a,
-
+    let Ok(commitment_on_a) = ctx_a.get_packet_commitment(&commitment_path_on_a) else {
         // This error indicates that the timeout has already been relayed
         // or there is a misconfigured relayer attempting to prove a timeout
         // for a packet never sent. Core IBC will treat this error as a no-op in order to
         // prevent an entire relay transaction from failing and consuming unnecessary fees.
-        Err(_) => return Ok(()),
+        return Ok(());
     };
 
     let expected_commitment_on_a = compute_packet_commitment(
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index 49dcc9a05..0aa5a4027 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -36,14 +36,12 @@ where
     );
 
     //verify the packet was sent, check the store
-    let commitment_on_a = match ctx_a.get_packet_commitment(&commitment_path_on_a) {
-        Ok(commitment_on_a) => commitment_on_a,
-
+    let Ok(commitment_on_a) = ctx_a.get_packet_commitment(&commitment_path_on_a) else {
         // This error indicates that the timeout has already been relayed
         // or there is a misconfigured relayer attempting to prove a timeout
         // for a packet never sent. Core IBC will treat this error as a no-op in order to
         // prevent an entire relay transaction from failing and consuming unnecessary fees.
-        Err(_) => return Ok(()),
+        return Ok(());
     };
 
     let expected_commitment_on_a = compute_packet_commitment(
diff --git a/ibc-core/ics04-channel/types/src/acknowledgement.rs b/ibc-core/ics04-channel/types/src/acknowledgement.rs
index b30f14454..7364857d1 100644
--- a/ibc-core/ics04-channel/types/src/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/acknowledgement.rs
@@ -114,8 +114,7 @@ impl AcknowledgementStatus {
 impl Display for AcknowledgementStatus {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
         match self {
-            AcknowledgementStatus::Success(v) => write!(f, "{v}"),
-            AcknowledgementStatus::Error(v) => write!(f, "{v}"),
+            AcknowledgementStatus::Success(v) | AcknowledgementStatus::Error(v) => write!(f, "{v}"),
         }
     }
 }
diff --git a/ibc-core/ics04-channel/types/src/commitment.rs b/ibc-core/ics04-channel/types/src/commitment.rs
index ba5da70c5..dbea7e968 100644
--- a/ibc-core/ics04-channel/types/src/commitment.rs
+++ b/ibc-core/ics04-channel/types/src/commitment.rs
@@ -124,7 +124,7 @@ mod test {
             0x4f, 0x84, 0xcc, 0x15,
         ];
         let actual = compute_packet_commitment(
-            "packet data".as_bytes(),
+            b"packet data",
             &TimeoutHeight::At(ibc_core_client_types::Height::new(42, 24).unwrap()),
             &Timestamp::from_nanoseconds(0x42).unwrap(),
         );
diff --git a/ibc-core/ics04-channel/types/src/events/mod.rs b/ibc-core/ics04-channel/types/src/events/mod.rs
index 606d248db..fbb78d6e7 100644
--- a/ibc-core/ics04-channel/types/src/events/mod.rs
+++ b/ibc-core/ics04-channel/types/src/events/mod.rs
@@ -532,7 +532,7 @@ impl ChannelClosed {
             port_id_attr_on_a: port_id_on_a.into(),
             chan_id_attr_on_a: chan_id_on_a.into(),
             port_id_attr_on_b: port_id_on_b.into(),
-            maybe_chan_id_attr_on_b: maybe_chan_id_on_b.map(|c| c.into()),
+            maybe_chan_id_attr_on_b: maybe_chan_id_on_b.map(Into::into),
             conn_id_attr_on_a: conn_id_on_a.into(),
             channel_ordering_attr: channel_ordering.into(),
         }
@@ -547,7 +547,7 @@ impl ChannelClosed {
         &self.port_id_attr_on_b.counterparty_port_id
     }
     pub fn chan_id_on_a(&self) -> Option<&ChannelId> {
-        self.maybe_chan_id_attr_on_b.as_ref().map(|c| c.as_ref())
+        self.maybe_chan_id_attr_on_b.as_ref().map(AsRef::as_ref)
     }
     pub fn conn_id_on_b(&self) -> &ConnectionId {
         &self.conn_id_attr_on_a.connection_id
@@ -571,7 +571,7 @@ impl From<ChannelClosed> for abci::Event {
                 ev.port_id_attr_on_b.into(),
                 ev.maybe_chan_id_attr_on_b.map_or_else(
                     || (COUNTERPARTY_CHANNEL_ID_ATTRIBUTE_KEY, "").into(),
-                    |c| c.into(),
+                    Into::into,
                 ),
                 ev.conn_id_attr_on_a.into(),
                 ev.channel_ordering_attr.into(),
diff --git a/ibc-core/ics23-commitment/types/src/merkle.rs b/ibc-core/ics23-commitment/types/src/merkle.rs
index 3e0624968..308cb424e 100644
--- a/ibc-core/ics23-commitment/types/src/merkle.rs
+++ b/ibc-core/ics23-commitment/types/src/merkle.rs
@@ -109,7 +109,7 @@ impl MerkleProof {
                     ) {
                         return Err(CommitmentError::VerificationFailure);
                     }
-                    value = subroot.clone();
+                    value.clone_from(&subroot);
                 }
                 _ => return Err(CommitmentError::InvalidMerkleProof),
             }
diff --git a/ibc-core/ics23-commitment/types/src/specs.rs b/ibc-core/ics23-commitment/types/src/specs.rs
index 2e18094a0..b7789cebc 100644
--- a/ibc-core/ics23-commitment/types/src/specs.rs
+++ b/ibc-core/ics23-commitment/types/src/specs.rs
@@ -53,18 +53,13 @@ impl Default for ProofSpecs {
 
 impl From<Vec<RawProofSpec>> for ProofSpecs {
     fn from(ics23_specs: Vec<RawProofSpec>) -> Self {
-        Self(
-            ics23_specs
-                .into_iter()
-                .map(|ics23_spec| ics23_spec.into())
-                .collect(),
-        )
+        Self(ics23_specs.into_iter().map(Into::into).collect())
     }
 }
 
 impl From<ProofSpecs> for Vec<RawProofSpec> {
     fn from(specs: ProofSpecs) -> Self {
-        specs.0.into_iter().map(|spec| spec.into()).collect()
+        specs.0.into_iter().map(Into::into).collect()
     }
 }
 
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
index 5f24c9523..d9e855a48 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
@@ -49,13 +49,11 @@ impl TryFrom<RawUpgradeProposal> for UpgradeProposal {
             });
         };
 
-        let upgraded_client_state = if let Some(upgraded_client_state) = raw.upgraded_client_state {
-            upgraded_client_state
-        } else {
-            return Err(UpgradeClientError::InvalidUpgradeProposal {
+        let upgraded_client_state = raw.upgraded_client_state.ok_or_else(|| {
+            UpgradeClientError::InvalidUpgradeProposal {
                 reason: "upgraded client state cannot be empty".to_string(),
-            });
-        };
+            }
+        })?;
 
         Ok(Self {
             title: raw.title,
diff --git a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
index c40904b1b..38a61f5af 100644
--- a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
@@ -265,24 +265,20 @@ impl FromStr for ChainId {
 
         // Validates the chain name for allowed characters according to ICS-24.
         validate_identifier_chars(id)?;
-        match parse_chain_id_string(id) {
-            Ok((chain_name, revision_number)) => {
-                // Validate if the chain name with revision number has a valid length.
-                validate_prefix_length(chain_name, 1, 64)?;
-                Ok(Self {
-                    id: id.into(),
-                    revision_number,
-                })
-            }
-
-            _ => {
-                // Validate if the identifier has a valid length.
-                validate_identifier_length(id, 1, 64)?;
-                Ok(Self {
-                    id: id.into(),
-                    revision_number: 0,
-                })
-            }
+        if let Ok((chain_name, revision_number)) = parse_chain_id_string(id) {
+            // Validate if the chain name with revision number has a valid length.
+            validate_prefix_length(chain_name, 1, 64)?;
+            Ok(Self {
+                id: id.into(),
+                revision_number,
+            })
+        } else {
+            // Validate if the identifier has a valid length.
+            validate_identifier_length(id, 1, 64)?;
+            Ok(Self {
+                id: id.into(),
+                revision_number: 0,
+            })
         }
     }
 }
diff --git a/ibc-core/ics24-host/types/src/path.rs b/ibc-core/ics24-host/types/src/path.rs
index c016f772b..3247f5a63 100644
--- a/ibc-core/ics24-host/types/src/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -744,19 +744,13 @@ fn parse_next_sequence(components: &[&str]) -> Option<Path> {
 }
 
 fn parse_client_paths(components: &[&str]) -> Option<Path> {
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != CLIENT_PREFIX {
         return None;
     }
 
-    let client_id = match ClientId::from_str(components[1]) {
-        Ok(s) => s,
-        Err(_) => return None,
-    };
+    let client_id = ClientId::from_str(components[1]).ok()?;
 
     if components.len() == 3 {
         match components[2] {
@@ -779,15 +773,9 @@ fn parse_client_paths(components: &[&str]) -> Option<Path> {
         let revision_number = epoch_height[0];
         let revision_height = epoch_height[1];
 
-        let revision_number = match revision_number.parse::<u64>() {
-            Ok(ep) => ep,
-            Err(_) => return None,
-        };
+        let revision_number = revision_number.parse::<u64>().ok()?;
 
-        let revision_height = match revision_height.parse::<u64>() {
-            Ok(h) => h,
-            Err(_) => return None,
-        };
+        let revision_height = revision_height.parse::<u64>().ok()?;
 
         match components.len() {
             4 => Some(
@@ -829,24 +817,15 @@ fn parse_connections(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != CONNECTION_PREFIX {
         return None;
     }
 
-    let connection_id = match components.last() {
-        Some(c) => *c,
-        None => return None,
-    };
+    let connection_id = *components.last()?;
 
-    let connection_id = match ConnectionId::from_str(connection_id) {
-        Ok(c) => c,
-        Err(_) => return None,
-    };
+    let connection_id = ConnectionId::from_str(connection_id).ok()?;
 
     Some(ConnectionPath(connection_id).into())
 }
@@ -856,24 +835,15 @@ fn parse_ports(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != PORT_PREFIX {
         return None;
     }
 
-    let port_id = match components.last() {
-        Some(p) => *p,
-        None => return None,
-    };
+    let port_id = *components.last()?;
 
-    let port_id = match PortId::from_str(port_id) {
-        Ok(p) => p,
-        Err(_) => return None,
-    };
+    let port_id = PortId::from_str(port_id).ok()?;
 
     Some(PortPath(port_id).into())
 }
@@ -883,24 +853,15 @@ fn parse_channels(components: &[&str]) -> Option<SubPath> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != CHANNEL_PREFIX {
         return None;
     }
 
-    let channel_id = match components.last() {
-        Some(c) => *c,
-        None => return None,
-    };
+    let channel_id = *components.last()?;
 
-    let channel_id = match ChannelId::from_str(channel_id) {
-        Ok(c) => c,
-        Err(_) => return None,
-    };
+    let channel_id = ChannelId::from_str(channel_id).ok()?;
 
     Some(SubPath::Channels(channel_id))
 }
@@ -910,19 +871,13 @@ fn parse_sequences(components: &[&str]) -> Option<SubPath> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != SEQUENCE_PREFIX {
         return None;
     }
 
-    let sequence_number = match components.last() {
-        Some(s) => *s,
-        None => return None,
-    };
+    let sequence_number = *components.last()?;
 
     match Sequence::from_str(sequence_number) {
         Ok(seq) => Some(SubPath::Sequences(seq)),
@@ -935,10 +890,7 @@ fn parse_channel_ends(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != CHANNEL_END_PREFIX {
         return None;
@@ -947,15 +899,11 @@ fn parse_channel_ends(components: &[&str]) -> Option<Path> {
     let port = parse_ports(&components[1..=2]);
     let channel = parse_channels(&components[3..=4]);
 
-    let port_id = if let Some(Path::Ports(PortPath(port_id))) = port {
-        port_id
-    } else {
+    let Some(Path::Ports(PortPath(port_id))) = port else {
         return None;
     };
 
-    let channel_id = if let Some(SubPath::Channels(channel_id)) = channel {
-        channel_id
-    } else {
+    let Some(SubPath::Channels(channel_id)) = channel else {
         return None;
     };
 
@@ -967,23 +915,16 @@ fn parse_seqs(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     let port = parse_ports(&components[1..=2]);
     let channel = parse_channels(&components[3..=4]);
 
-    let port_id = if let Some(Path::Ports(PortPath(port_id))) = port {
-        port_id
-    } else {
+    let Some(Path::Ports(PortPath(port_id))) = port else {
         return None;
     };
 
-    let channel_id = if let Some(SubPath::Channels(channel_id)) = channel {
-        channel_id
-    } else {
+    let Some(SubPath::Channels(channel_id)) = channel else {
         return None;
     };
 
@@ -1000,10 +941,7 @@ fn parse_commitments(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != PACKET_COMMITMENT_PREFIX {
         return None;
@@ -1013,21 +951,15 @@ fn parse_commitments(components: &[&str]) -> Option<Path> {
     let channel = parse_channels(&components[3..=4]);
     let sequence = parse_sequences(&components[5..]);
 
-    let port_id = if let Some(Path::Ports(PortPath(port_id))) = port {
-        port_id
-    } else {
+    let Some(Path::Ports(PortPath(port_id))) = port else {
         return None;
     };
 
-    let channel_id = if let Some(SubPath::Channels(channel_id)) = channel {
-        channel_id
-    } else {
+    let Some(SubPath::Channels(channel_id)) = channel else {
         return None;
     };
 
-    let sequence = if let Some(SubPath::Sequences(seq)) = sequence {
-        seq
-    } else {
+    let Some(SubPath::Sequences(sequence)) = sequence else {
         return None;
     };
 
@@ -1046,10 +978,7 @@ fn parse_acks(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != PACKET_ACK_PREFIX {
         return None;
@@ -1059,21 +988,15 @@ fn parse_acks(components: &[&str]) -> Option<Path> {
     let channel = parse_channels(&components[3..=4]);
     let sequence = parse_sequences(&components[5..]);
 
-    let port_id = if let Some(Path::Ports(PortPath(port_id))) = port {
-        port_id
-    } else {
+    let Some(Path::Ports(PortPath(port_id))) = port else {
         return None;
     };
 
-    let channel_id = if let Some(SubPath::Channels(channel_id)) = channel {
-        channel_id
-    } else {
+    let Some(SubPath::Channels(channel_id)) = channel else {
         return None;
     };
 
-    let sequence = if let Some(SubPath::Sequences(seq)) = sequence {
-        seq
-    } else {
+    let Some(SubPath::Sequences(sequence)) = sequence else {
         return None;
     };
 
@@ -1092,10 +1015,7 @@ fn parse_receipts(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != PACKET_RECEIPT_PREFIX {
         return None;
@@ -1105,21 +1025,15 @@ fn parse_receipts(components: &[&str]) -> Option<Path> {
     let channel = parse_channels(&components[3..=4]);
     let sequence = parse_sequences(&components[5..]);
 
-    let port_id = if let Some(Path::Ports(PortPath(port_id))) = port {
-        port_id
-    } else {
+    let Some(Path::Ports(PortPath(port_id))) = port else {
         return None;
     };
 
-    let channel_id = if let Some(SubPath::Channels(channel_id)) = channel {
-        channel_id
-    } else {
+    let Some(SubPath::Channels(channel_id)) = channel else {
         return None;
     };
 
-    let sequence = if let Some(SubPath::Sequences(seq)) = sequence {
-        seq
-    } else {
+    let Some(SubPath::Sequences(sequence)) = sequence else {
         return None;
     };
 
@@ -1138,24 +1052,15 @@ fn parse_upgrades(components: &[&str]) -> Option<Path> {
         return None;
     }
 
-    let first = match components.first() {
-        Some(f) => *f,
-        None => return None,
-    };
+    let first = *components.first()?;
 
     if first != UPGRADED_IBC_STATE {
         return None;
     }
 
-    let last = match components.last() {
-        Some(l) => *l,
-        None => return None,
-    };
+    let last = *components.last()?;
 
-    let height = match components[1].parse::<u64>() {
-        Ok(h) => h,
-        Err(_) => return None,
-    };
+    let height = components[1].parse::<u64>().ok()?;
 
     match last {
         UPGRADED_CLIENT_STATE => Some(UpgradeClientPath::UpgradedClientState(height).into()),
diff --git a/ibc-core/ics25-handler/src/entrypoint.rs b/ibc-core/ics25-handler/src/entrypoint.rs
index f41ad4a53..b3391280a 100644
--- a/ibc-core/ics25-handler/src/entrypoint.rs
+++ b/ibc-core/ics25-handler/src/entrypoint.rs
@@ -61,7 +61,7 @@ where
             ConnectionMsg::OpenInit(msg) => conn_open_init::validate(ctx, msg),
             ConnectionMsg::OpenTry(msg) => conn_open_try::validate(ctx, msg),
             ConnectionMsg::OpenAck(msg) => conn_open_ack::validate(ctx, msg),
-            ConnectionMsg::OpenConfirm(ref msg) => conn_open_confirm::validate(ctx, msg),
+            ConnectionMsg::OpenConfirm(msg) => conn_open_confirm::validate(ctx, &msg),
         },
         MsgEnvelope::Channel(msg) => {
             let port_id = channel_msg_to_port_id(&msg);
@@ -132,7 +132,7 @@ where
             ConnectionMsg::OpenInit(msg) => conn_open_init::execute(ctx, msg),
             ConnectionMsg::OpenTry(msg) => conn_open_try::execute(ctx, msg),
             ConnectionMsg::OpenAck(msg) => conn_open_ack::execute(ctx, msg),
-            ConnectionMsg::OpenConfirm(ref msg) => conn_open_confirm::execute(ctx, msg),
+            ConnectionMsg::OpenConfirm(msg) => conn_open_confirm::execute(ctx, &msg),
         },
         MsgEnvelope::Channel(msg) => {
             let port_id = channel_msg_to_port_id(&msg);
diff --git a/ibc-derive/src/client_state.rs b/ibc-derive/src/client_state.rs
index b33862fb2..4e3055199 100644
--- a/ibc-derive/src/client_state.rs
+++ b/ibc-derive/src/client_state.rs
@@ -24,7 +24,7 @@ pub(crate) struct ClientCtx {
 
 impl ClientCtx {
     fn new(ident: Ident, generics: Vec<GenericArgument>, predicates: Vec<WherePredicate>) -> Self {
-        ClientCtx {
+        Self {
             ident,
             generics,
             predicates,
@@ -73,8 +73,8 @@ impl Opts {
             return Err(Error::new_spanned(ast, MISSING_ATTR));
         }
 
-        for attr in ast.attrs.iter() {
-            if let syn::Meta::List(ref meta_list) = attr.meta {
+        for attr in &ast.attrs {
+            if let syn::Meta::List(meta_list) = &attr.meta {
                 let path: syn::Path = syn::parse2(meta_list.tokens.clone())?;
 
                 let path_segment = match path.segments.last() {
@@ -104,7 +104,7 @@ impl Opts {
         let client_execution_context = client_execution_context
             .ok_or_else(|| Error::new_spanned(ast, MISSING_EXECUTION_ATTR))?;
 
-        Ok(Opts {
+        Ok(Self {
             client_validation_context,
             client_execution_context,
         })
@@ -117,16 +117,13 @@ fn split_for_impl(
     let mut generics = vec![];
     let mut predicates = vec![];
 
-    if let syn::PathArguments::AngleBracketed(ref gen) = args {
-        for arg in gen.args.clone() {
+    if let syn::PathArguments::AngleBracketed(gen) = args {
+        for arg in gen.args {
             match arg.clone() {
-                syn::GenericArgument::Type(_) => {
+                GenericArgument::Type(_) | GenericArgument::Lifetime(_) => {
                     generics.push(arg);
                 }
-                syn::GenericArgument::Lifetime(_) => {
-                    generics.push(arg);
-                }
-                syn::GenericArgument::Constraint(c) => {
+                GenericArgument::Constraint(c) => {
                     let ident = c.ident.into_token_stream();
 
                     let gen = syn::parse2(ident.into_token_stream())?;
@@ -153,8 +150,8 @@ pub fn client_state_derive_impl(ast: DeriveInput, imports: &Imports) -> TokenStr
     };
 
     let enum_name = &ast.ident;
-    let enum_variants = match ast.data {
-        syn::Data::Enum(ref enum_data) => &enum_data.variants,
+    let enum_variants = match &ast.data {
+        syn::Data::Enum(enum_data) => &enum_data.variants,
         _ => panic!("ClientState only supports enums"),
     };
 
diff --git a/ibc-derive/src/client_state/traits/client_state_common.rs b/ibc-derive/src/client_state/traits/client_state_common.rs
index 42a144b2e..56bfe9349 100644
--- a/ibc-derive/src/client_state/traits/client_state_common.rs
+++ b/ibc-derive/src/client_state/traits/client_state_common.rs
@@ -136,9 +136,9 @@ pub(crate) fn impl_ClientStateCommon(
 ///
 /// Generates the per-enum variant function call delegation token streams.
 ///
-/// enum_name:     The user's enum identifier (e.g. `HostClientState`)
-/// enum_variants: An iterator of all enum variants (e.g. `[HostClientState::Tendermint, HostClientState::Mock]`)
-/// fn_call:       The tokens for the function call. Fully-qualified syntax is assumed, where the name for `self`
+/// `enum_name`:     The user's enum identifier (e.g. `HostClientState`)
+/// `enum_variants`: An iterator of all enum variants (e.g. `[HostClientState::Tendermint, HostClientState::Mock]`)
+/// `fn_call`:       The tokens for the function call. Fully-qualified syntax is assumed, where the name for `self`
 ///                  is `cs` (e.g. `client_type(cs)`).
 ///
 /// For example,
diff --git a/ibc-derive/src/consensus_state.rs b/ibc-derive/src/consensus_state.rs
index 811f69fc6..4ac97a578 100644
--- a/ibc-derive/src/consensus_state.rs
+++ b/ibc-derive/src/consensus_state.rs
@@ -7,8 +7,8 @@ use crate::utils::{get_enum_variant_type_path, Imports};
 
 pub fn consensus_state_derive_impl(ast: DeriveInput, imports: &Imports) -> TokenStream {
     let enum_name = &ast.ident;
-    let enum_variants = match ast.data {
-        syn::Data::Enum(ref enum_data) => &enum_data.variants,
+    let enum_variants = match &ast.data {
+        syn::Data::Enum(enum_data) => &enum_data.variants,
         _ => panic!("ConsensusState only supports enums"),
     };
 
diff --git a/ibc-derive/src/utils.rs b/ibc-derive/src/utils.rs
index e33f13974..ab3986951 100644
--- a/ibc-derive/src/utils.rs
+++ b/ibc-derive/src/utils.rs
@@ -29,9 +29,7 @@ impl Imports {
     pub fn prefix(&self) -> &TokenStream {
         &self.prefix
     }
-}
 
-impl Imports {
     pub fn commitment_root(&self) -> TokenStream {
         let Prefix = self.prefix();
         quote! {#Prefix::commitment_types::commitment::CommitmentRoot}
@@ -123,10 +121,9 @@ impl Imports {
 ///
 pub fn get_enum_variant_type_path(enum_variant: &Variant) -> &Path {
     let variant_name = &enum_variant.ident;
-    let variant_unnamed_fields = match &enum_variant.fields {
-            syn::Fields::Unnamed(fields) => fields,
-            _ => panic!("\"{variant_name}\" variant must be unnamed, such as `{variant_name}({variant_name}ClientState)`")
-        };
+    let syn::Fields::Unnamed(variant_unnamed_fields) = &enum_variant.fields else {
+        panic!("\"{variant_name}\" variant must be unnamed, such as `{variant_name}({variant_name}ClientState)`")
+    };
 
     if variant_unnamed_fields.unnamed.iter().len() != 1 {
         panic!("\"{variant_name}\" must contain exactly one field, such as `{variant_name}({variant_name}ClientState)`");
diff --git a/ibc-primitives/src/types/timestamp.rs b/ibc-primitives/src/types/timestamp.rs
index c7d8e5aae..9454b2b91 100644
--- a/ibc-primitives/src/types/timestamp.rs
+++ b/ibc-primitives/src/types/timestamp.rs
@@ -48,8 +48,7 @@ impl borsh::BorshDeserialize for Timestamp {
         reader: &mut R,
     ) -> borsh::maybestd::io::Result<Self> {
         let timestamp = u64::deserialize_reader(reader)?;
-        Ok(Timestamp::from_nanoseconds(timestamp)
-            .map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
+        Ok(Self::from_nanoseconds(timestamp).map_err(|_| borsh::maybestd::io::ErrorKind::Other)?)
     }
 }
 
@@ -66,7 +65,7 @@ impl parity_scale_codec::Decode for Timestamp {
         input: &mut I,
     ) -> Result<Self, parity_scale_codec::Error> {
         let timestamp = u64::decode(input)?;
-        Timestamp::from_nanoseconds(timestamp)
+        Self::from_nanoseconds(timestamp)
             .map_err(|_| parity_scale_codec::Error::from("from nanoseconds error"))
     }
 }
@@ -108,14 +107,14 @@ impl Timestamp {
     /// is not set. In this case, our domain type takes the
     /// value of None.
     ///
-    pub fn from_nanoseconds(nanoseconds: u64) -> Result<Timestamp, ParseTimestampError> {
+    pub fn from_nanoseconds(nanoseconds: u64) -> Result<Self, ParseTimestampError> {
         if nanoseconds == 0 {
-            Ok(Timestamp { time: None })
+            Ok(Self { time: None })
         } else {
             // As the `u64` representation can only represent times up to
             // about year 2554, there is no risk of overflowing `Time`
             // or `OffsetDateTime`.
-            let ts = OffsetDateTime::from_unix_timestamp_nanos(nanoseconds as i128)
+            let ts = OffsetDateTime::from_unix_timestamp_nanos(nanoseconds.into())
                 .map_err(|e: time::error::ComponentRange| {
                     ParseTimestampError::DataOutOfRange(e.to_string())
                 })?
@@ -123,26 +122,26 @@ impl Timestamp {
                 .map_err(|e: tendermint::error::Error| {
                     ParseTimestampError::DataOutOfRange(e.to_string())
                 })?;
-            Ok(Timestamp { time: Some(ts) })
+            Ok(Self { time: Some(ts) })
         }
     }
 
     /// Returns a `Timestamp` representation of the current time.
     #[cfg(feature = "std")]
-    pub fn now() -> Timestamp {
+    pub fn now() -> Self {
         Time::now().into()
     }
 
     /// Returns a `Timestamp` representation of a timestamp not being set.
     pub fn none() -> Self {
-        Timestamp { time: None }
+        Self { time: None }
     }
 
     /// Computes the duration difference of another `Timestamp` from the current one.
     /// Returns the difference in time as an [`core::time::Duration`].
     /// Returns `None` if the other `Timestamp` is more advanced
     /// than the current or if either of the `Timestamp`s is not set.
-    pub fn duration_since(&self, other: &Timestamp) -> Option<Duration> {
+    pub fn duration_since(&self, other: &Self) -> Option<Duration> {
         match (self.time, other.time) {
             (Some(time1), Some(time2)) => time1.duration_since(time2).ok(),
             _ => None,
@@ -197,7 +196,7 @@ impl Timestamp {
 
     /// Checks whether the timestamp has expired when compared to the
     /// `other` timestamp. Returns an [`Expiry`] result.
-    pub fn check_expiry(&self, other: &Timestamp) -> Expiry {
+    pub fn check_expiry(&self, other: &Self) -> Expiry {
         match (self.time, other.time) {
             (Some(time1), Some(time2)) => {
                 if time1 > time2 {
@@ -237,32 +236,26 @@ pub enum TimestampOverflowError {
 impl std::error::Error for TimestampOverflowError {}
 
 impl Add<Duration> for Timestamp {
-    type Output = Result<Timestamp, TimestampOverflowError>;
-
-    fn add(self, duration: Duration) -> Result<Timestamp, TimestampOverflowError> {
-        match self.time {
-            Some(time) => {
-                let time =
-                    (time + duration).map_err(|_| TimestampOverflowError::TimestampOverflow)?;
-                Ok(Timestamp { time: Some(time) })
-            }
-            None => Ok(self),
-        }
+    type Output = Result<Self, TimestampOverflowError>;
+
+    fn add(self, duration: Duration) -> Result<Self, TimestampOverflowError> {
+        self.time
+            .map(|time| time + duration)
+            .transpose()
+            .map(|time| Self { time })
+            .map_err(|_| TimestampOverflowError::TimestampOverflow)
     }
 }
 
 impl Sub<Duration> for Timestamp {
-    type Output = Result<Timestamp, TimestampOverflowError>;
-
-    fn sub(self, duration: Duration) -> Result<Timestamp, TimestampOverflowError> {
-        match self.time {
-            Some(time) => {
-                let time =
-                    (time - duration).map_err(|_| TimestampOverflowError::TimestampOverflow)?;
-                Ok(Timestamp { time: Some(time) })
-            }
-            None => Ok(self),
-        }
+    type Output = Result<Self, TimestampOverflowError>;
+
+    fn sub(self, duration: Duration) -> Result<Self, TimestampOverflowError> {
+        self.time
+            .map(|time| time - duration)
+            .transpose()
+            .map(|time| Self { time })
+            .map_err(|_| TimestampOverflowError::TimestampOverflow)
     }
 }
 
@@ -278,8 +271,8 @@ pub enum ParseTimestampError {
 impl std::error::Error for ParseTimestampError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {
         match &self {
-            ParseTimestampError::ParseInt(e) => Some(e),
-            ParseTimestampError::DataOutOfRange(_) => None,
+            Self::ParseInt(e) => Some(e),
+            Self::DataOutOfRange(_) => None,
         }
     }
 }
@@ -290,13 +283,13 @@ impl FromStr for Timestamp {
     fn from_str(s: &str) -> Result<Self, Self::Err> {
         let nanoseconds = u64::from_str(s).map_err(ParseTimestampError::ParseInt)?;
 
-        Timestamp::from_nanoseconds(nanoseconds)
+        Self::from_nanoseconds(nanoseconds)
     }
 }
 
 impl From<Time> for Timestamp {
-    fn from(tendermint_time: Time) -> Timestamp {
-        Timestamp {
+    fn from(tendermint_time: Time) -> Self {
+        Self {
             time: Some(tendermint_time),
         }
     }
diff --git a/ibc-primitives/src/utils/macros.rs b/ibc-primitives/src/utils/macros.rs
deleted file mode 100644
index e926ae23f..000000000
--- a/ibc-primitives/src/utils/macros.rs
+++ /dev/null
@@ -1,51 +0,0 @@
-//! Macros used across the ibc-rs crates.
-
-/// Downcast an enum variant that contains a single value into its inner value.
-///
-/// ## Note
-/// Only works for enums whose variants only hold a single value.
-///
-/// ## Example
-///
-/// ```rust
-/// use ibc_primitives::downcast;
-///
-/// enum Foo {
-///     Bar(u32),
-///     Baz(bool),
-/// }
-///
-/// let bar = Foo::Bar(42);
-/// let baz = Foo::Baz(true);
-///
-/// if let Some(value) = downcast!(bar => Foo::Bar) {
-///     println!("value is a u32: {}", value);
-/// }
-///
-/// if let Some(value) = downcast!(baz => Foo::Baz) {
-///     println!("value is a bool: {}", value);
-/// }
-///
-/// if let Some((a, b)) = downcast!(bar => Foo::Bar, baz => Foo::Baz) {
-///     println!("a is a u32: {}", a);
-///     println!("b is a bool: {}", b);
-/// }
-/// ```
-#[macro_export]
-macro_rules! downcast {
-    ( $e1:expr => $p1:path, $( $e:expr => $p:path ),+ $(,)? ) => {
-        downcast!($e1 => $p1).zip(downcast!($($e => $p),+))
-    };
-
-    ($e:expr => $p:path) => {
-        match $e {
-            $p(e) => Some(e),
-            #[allow(unreachable_patterns)]
-            _ => None,
-        }
-    };
-
-    () => {
-        None
-    }
-}
diff --git a/ibc-primitives/src/utils/mod.rs b/ibc-primitives/src/utils/mod.rs
index cd8e30c13..b61030b5d 100644
--- a/ibc-primitives/src/utils/mod.rs
+++ b/ibc-primitives/src/utils/mod.rs
@@ -1,5 +1,4 @@
 //! Contains various internally-used utilities.
-mod macros;
 pub mod pretty;
 
 pub use pretty::*;
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index 2b1341d43..e92d320af 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -178,7 +178,7 @@ where
     Ok(QueryConsensusStateHeightsResponse {
         consensus_state_heights: consensus_state_heights
             .into_iter()
-            .map(|height| height.into())
+            .map(Into::into)
             .collect(),
         // no support for pagination yet
         pagination: None,
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index 39f8de82f..0e4aa261a 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -28,7 +28,7 @@ pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> TmClientState {
         chain_id.clone(),
         Default::default(),
         Duration::from_secs(64000),
-        Duration::from_secs(128000),
+        Duration::from_secs(128_000),
         Duration::from_millis(3000),
         Height::new(chain_id.revision_number(), u64::from(tm_header.height)).expect("Never fails"),
         Default::default(),
@@ -53,7 +53,7 @@ pub fn dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
             denominator: 3,
         }),
         trusting_period: Some(Duration::from_secs(64000).into()),
-        unbonding_period: Some(Duration::from_secs(128000).into()),
+        unbonding_period: Some(Duration::from_secs(128_000).into()),
         max_clock_drift: Some(Duration::from_millis(3000).into()),
         latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
         proof_specs: ProofSpecs::default().into(),
@@ -71,7 +71,7 @@ pub struct ClientStateConfig {
     pub trust_level: TrustThreshold,
     #[builder(default = Duration::from_secs(64000))]
     pub trusting_period: Duration,
-    #[builder(default = Duration::from_secs(128000))]
+    #[builder(default = Duration::from_secs(128_000))]
     pub unbonding_period: Duration,
     #[builder(default = Duration::from_millis(3000))]
     max_clock_drift: Duration,
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
index 1161dae40..02b99a8bc 100644
--- a/ibc-testkit/src/fixtures/core/channel/packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -62,9 +62,7 @@ pub fn dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacke
 }
 
 pub fn dummy_proof() -> Vec<u8> {
-    "Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy"
-        .as_bytes()
-        .to_vec()
+    b"Y29uc2Vuc3VzU3RhdGUvaWJjb25lY2xpZW50LzIy".to_vec()
 }
 
 #[cfg(test)]
diff --git a/ibc-testkit/src/fixtures/core/client/msg_update_client.rs b/ibc-testkit/src/fixtures/core/client/msg_update_client.rs
index 980dee50b..83de78d04 100644
--- a/ibc-testkit/src/fixtures/core/client/msg_update_client.rs
+++ b/ibc-testkit/src/fixtures/core/client/msg_update_client.rs
@@ -6,7 +6,7 @@ use crate::fixtures::core::signer::dummy_bech32_account;
 
 /// Returns a dummy `RawMsgUpdateClient`, for testing purposes only!
 pub fn dummy_raw_msg_update_client() -> RawMsgUpdateClient {
-    let client_id = "07-tendermint-0".parse().unwrap();
+    let client_id = "07-tendermint-0".parse().expect("no error");
 
     let tm_header = dummy_ics07_header();
 
diff --git a/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
index a011680a9..5b1dbbbe2 100644
--- a/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
+++ b/ibc-testkit/src/fixtures/core/client/msg_upgrade_client.rs
@@ -23,7 +23,7 @@ pub fn dummy_msg_upgrade_client(client_id: ClientId, upgrade_height: Height) ->
 
 /// Returns a dummy `RawMsgUpgradeClient`, for testing purposes only!
 pub fn dummy_raw_msg_upgrade_client() -> RawMsgUpgradeClient {
-    let client_id = "07-tendermint-0".parse().unwrap();
+    let client_id = "07-tendermint-0".parse().expect("no error");
 
     let upgrade_height = Height::new(0, 10).expect("Never fails");
 
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 39cd35cfe..89645d1b5 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -31,7 +31,6 @@ pub fn client_type() -> ClientType {
 
 /// A mock of a client state. For an example of a real structure that this mocks, you can see
 /// `ClientState` of ics07_tendermint/client_state.rs.
-
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(Copy, Clone, Debug, PartialEq, Eq)]
 pub struct MockClientState {
@@ -249,7 +248,9 @@ where
 
                 Ok(header_heights_equal && headers_are_in_future)
             }
-            _ => Ok(false),
+            header_type => Err(ClientError::UnknownHeaderType {
+                header_type: header_type.to_owned(),
+            }),
         }
     }
 
diff --git a/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
index 618466dc5..1f7e364c6 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -67,7 +67,7 @@ impl From<ConsensusStateType> for AnyConsensusState {
     }
 }
 
-#[derive(Debug, Clone, From, PartialEq, ConsensusState)]
+#[derive(Debug, Clone, From, PartialEq, Eq, ConsensusState)]
 pub enum AnyConsensusState {
     Tendermint(TmConsensusState),
     Mock(MockConsensusState),
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 940e6fa43..6f28e75dc 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -55,7 +55,7 @@ impl TmValidationContext for MockContext {
                     client_id: client_id.clone(),
                 })?;
 
-        let heights = client_record.consensus_states.keys().cloned().collect();
+        let heights = client_record.consensus_states.keys().copied().collect();
 
         Ok(heights)
     }
@@ -75,7 +75,7 @@ impl TmValidationContext for MockContext {
                 })?;
 
         // Get the consensus state heights and sort them in ascending order.
-        let mut heights: Vec<Height> = client_record.consensus_states.keys().cloned().collect();
+        let mut heights: Vec<Height> = client_record.consensus_states.keys().copied().collect();
         heights.sort();
 
         // Search for next state.
@@ -109,7 +109,7 @@ impl TmValidationContext for MockContext {
                 })?;
 
         // Get the consensus state heights and sort them in descending order.
-        let mut heights: Vec<Height> = client_record.consensus_states.keys().cloned().collect();
+        let mut heights: Vec<Height> = client_record.consensus_states.keys().copied().collect();
         heights.sort_by(|a, b| b.cmp(a));
 
         // Search for previous state.
@@ -276,7 +276,7 @@ impl ClientExecutionContext for MockContext {
         client_id: ClientId,
         height: Height,
     ) -> Result<(), ContextError> {
-        let key = (client_id.clone(), height);
+        let key = (client_id, height);
         let mut ibc_store = self.ibc_store.lock();
         ibc_store.client_processed_times.remove(&key);
         ibc_store.client_processed_heights.remove(&key);
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index ddd3ec96c..549e39f8f 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -139,7 +139,7 @@ pub struct MockClientConfig {
     trusting_period: Duration,
     #[builder(default = Duration::from_millis(3000))]
     max_clock_drift: Duration,
-    #[builder(default = Duration::from_secs(128000))]
+    #[builder(default = Duration::from_secs(128_000))]
     unbonding_period: Duration,
 }
 
@@ -296,7 +296,7 @@ impl MockContext {
 
         MockContext {
             host_chain_type: host_type,
-            host_chain_id: host_id.clone(),
+            host_chain_id: host_id,
             max_history_size,
             history,
             block_time,
@@ -535,7 +535,7 @@ impl MockContext {
         self.ibc_store
             .lock()
             .clients
-            .insert(client.client_id.clone(), client_record);
+            .insert(client.client_id, client_record);
         self
     }
 
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index a3fd7bec7..61956e336 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -19,7 +19,7 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChainId, ClientId, ClientType};
 use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
-use ibc::core::primitives::{downcast, Timestamp};
+use ibc::core::primitives::Timestamp;
 use ibc::primitives::proto::Any;
 use ibc::primitives::ToVec;
 use ibc_testkit::fixtures::core::context::MockContextConfig;
@@ -656,7 +656,9 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
         // chain B
         let consensus_state: AnyConsensusState = block.clone().into();
 
-        let tm_block = downcast!(block.clone() => HostBlock::SyntheticTendermint).unwrap();
+        let HostBlock::SyntheticTendermint(tm_block) = &block else {
+            panic!("unexpected host block type");
+        };
 
         let chain_id = ChainId::from_str(tm_block.header().chain_id.as_str()).unwrap();
 
@@ -669,7 +671,7 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
                     denominator: 3,
                 }),
                 trusting_period: Some(Duration::from_secs(64000).into()),
-                unbonding_period: Some(Duration::from_secs(128000).into()),
+                unbonding_period: Some(Duration::from_secs(128_000).into()),
                 max_clock_drift: Some(Duration::from_millis(3000).into()),
                 latest_height: Some(
                     Height::new(
@@ -802,7 +804,9 @@ fn test_update_client_events(fixture: Fixture) {
         ibc_events[0],
         IbcEvent::Message(MessageEvent::Client)
     ));
-    let update_client_event = downcast!(&ibc_events[1] => IbcEvent::UpdateClient).unwrap();
+    let IbcEvent::UpdateClient(update_client_event) = &ibc_events[1] else {
+        panic!("unexpected event variant");
+    };
 
     assert_eq!(update_client_event.client_id(), &client_id);
     assert_eq!(update_client_event.client_type(), &mock_client_type());
@@ -824,8 +828,9 @@ fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &Cl
         ibc_events[0],
         IbcEvent::Message(MessageEvent::Client),
     ));
-    let misbehaviour_client_event =
-        downcast!(&ibc_events[1] => IbcEvent::ClientMisbehaviour).unwrap();
+    let IbcEvent::ClientMisbehaviour(misbehaviour_client_event) = &ibc_events[1] else {
+        panic!("unexpected event variant");
+    };
     assert_eq!(misbehaviour_client_event.client_id(), client_id);
     assert_eq!(misbehaviour_client_event.client_type(), client_type);
 }
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index d9b15c173..c9bdadab5 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -8,7 +8,6 @@ use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::path::ClientConsensusStatePath;
-use ibc::core::primitives::downcast;
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
 };
@@ -102,8 +101,9 @@ fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
                 ibc_events[0],
                 IbcEvent::Message(MessageEvent::Client)
             ));
-            let upgrade_client_event =
-                downcast!(&ibc_events[1] => IbcEvent::UpgradeClient).unwrap();
+            let IbcEvent::UpgradeClient(upgrade_client_event) = &ibc_events[1] else {
+                panic!("unexpected event variant");
+            };
             let plan_height = Height::new(1, 26).unwrap();
 
             assert_eq!(upgrade_client_event.client_id(), &fxt.msg.client_id);
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 9bfa34469..654c894c1 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -153,9 +153,8 @@ fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect
             let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenAckConnection(_)));
 
-            let conn_open_try_event = match event {
-                IbcEvent::OpenAckConnection(e) => e,
-                _ => unreachable!(),
+            let IbcEvent::OpenAckConnection(conn_open_try_event) = event else {
+                unreachable!()
             };
             let conn_end = <MockContext as ValidationContext>::connection_end(
                 &fxt.ctx,
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index 67eafe48f..ba0e4479f 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -105,9 +105,8 @@ fn conn_open_confirm_execute(fxt: &mut Fixture<MsgConnectionOpenConfirm>, expect
             let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenConfirmConnection(_)));
 
-            let conn_open_try_event = match event {
-                IbcEvent::OpenConfirmConnection(e) => e,
-                _ => unreachable!(),
+            let IbcEvent::OpenConfirmConnection(conn_open_try_event) = event else {
+                unreachable!()
             };
             let conn_end =
                 ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index 007be597e..76c974892 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -97,9 +97,8 @@ fn conn_open_init_execute(
             let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenInitConnection(_)));
 
-            let conn_open_init_event = match event {
-                IbcEvent::OpenInitConnection(e) => e,
-                _ => unreachable!(),
+            let IbcEvent::OpenInitConnection(conn_open_init_event) = event else {
+                unreachable!()
             };
             let conn_end =
                 ValidationContext::connection_end(&fxt.ctx, conn_open_init_event.conn_id_on_a())
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index 5afca6581..e5e718e5b 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -106,9 +106,8 @@ fn conn_open_try_execute(fxt: &mut Fixture<MsgConnectionOpenTry>, expect: Expect
             let event = &ibc_events[1];
             assert!(matches!(event, &IbcEvent::OpenTryConnection(_)));
 
-            let conn_open_try_event = match event {
-                IbcEvent::OpenTryConnection(e) => e,
-                _ => unreachable!(),
+            let IbcEvent::OpenTryConnection(conn_open_try_event) = event else {
+                unreachable!()
             };
             let conn_end =
                 ValidationContext::connection_end(&fxt.ctx, conn_open_try_event.conn_id_on_b())
diff --git a/ibc/README.md b/ibc/README.md
index 20eb03295..c168ff1e6 100644
--- a/ibc/README.md
+++ b/ibc/README.md
@@ -10,8 +10,9 @@
 [![Docs][docs-image]][docs-link]
 [![Build Status][build-image]][build-link]
 [![Apache 2.0 Licensed][license-image]][license-link]
-![Rust Stable][rustc-image]
-![Rust 1.64+][rustc-version]
+![Version][crates-io-version]
+![Downloads][crates-io-downloads]
+![Rust Stable][msrv-image]
 
 </div>
 
@@ -58,10 +59,11 @@ specific language governing permissions and limitations under the License.
 [docs-link]: https://docs.rs/ibc/
 [build-image]: https://github.com/cosmos/ibc-rs/workflows/Rust/badge.svg
 [build-link]: https://github.com/cosmos/ibc-rs/actions?query=workflow%3ARust
-[license-image]: https://img.shields.io/badge/license-Apache2.0-blue.svg
+[license-image]: https://img.shields.io/crates/l/ibc
 [license-link]: https://github.com/cosmos/ibc-rs/blob/main/LICENSE
-[rustc-image]: https://img.shields.io/badge/rustc-stable-blue.svg
-[rustc-version]: https://img.shields.io/badge/rustc-1.60+-blue.svg
+[crates-io-version]: https://img.shields.io/crates/v/ibc.svg
+[crates-io-downloads]: https://img.shields.io/crates/d/ibc.svg
+[msrv-image]: https://img.shields.io/crates/msrv/ibc
 
 [//]: # (general links)
 

From d0511b7a52c40c7451c1257c1980fee26e49d5b6 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 12 Mar 2024 16:06:02 +0100
Subject: [PATCH 126/182] fix(ci): failing `cw-check` workflow (#1121)

* update triggering path patterns on ci

* bump nightly for cw-check

* add missing path patterns

* minimal pr triggers for cw and no-std check
---
 .github/workflows/coverage.yml  | 2 ++
 .github/workflows/cw-check.yaml | 3 ++-
 .github/workflows/no-std.yaml   | 2 ++
 ci/cw-check/rust-toolchain.toml | 2 +-
 4 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yml
index 3176c269a..f0e01d793 100644
--- a/.github/workflows/coverage.yml
+++ b/.github/workflows/coverage.yml
@@ -14,6 +14,8 @@ on:
       - ibc-clients/**
       - ibc-primitives/**
       - ibc-query/**
+      - ibc-testkit/**
+      - ibc-derive/**
   push:
     branches:
       - main
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index 8455a187e..bd5e003e8 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -3,6 +3,8 @@ on:
   pull_request:
     paths:
       - .github/workflows/cw-check.yml
+      - Cargo.toml
+      - Cargo.lock
       - ci/cw-check/**
   push:
     tags:
@@ -22,7 +24,6 @@ on:
       - ibc-data-types/**
       - ibc-clients/**
       - ibc-primitives/**
-      - ibc-query/**
       - ibc-derive/**
 jobs:
   cw-check:
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 90a3b8e09..130b0f7a1 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -13,6 +13,7 @@ on:
       - ibc-data-types/**
       - ibc-clients/**
       - ibc-primitives/**
+      - ibc-derive/**
   push:
     branches: main
     paths:
@@ -27,6 +28,7 @@ on:
       - ibc-data-types/**
       - ibc-clients/**
       - ibc-primitives/**
+      - ibc-derive/**
 jobs:
   check-no-std-panic-conflict:
     name: Check no_std panic conflict
diff --git a/ci/cw-check/rust-toolchain.toml b/ci/cw-check/rust-toolchain.toml
index 0ce1c5cca..50431042f 100644
--- a/ci/cw-check/rust-toolchain.toml
+++ b/ci/cw-check/rust-toolchain.toml
@@ -1,5 +1,5 @@
 [toolchain]
-channel = "nightly-2023-03-09"
+channel = "nightly-2024-02-24"
 targets = [
   "wasm32-unknown-unknown",
 ]

From 04520a81f560c0010d4e482bb06d8e7714a91b01 Mon Sep 17 00:00:00 2001
From: Tuan Tran <tuantran@notional.ventures>
Date: Wed, 13 Mar 2024 02:15:02 +0700
Subject: [PATCH 127/182] imp(types): refactor Default implementations with
 concrete names (#1099)

* use concrete channel order enum

* refactor(ics04): remove Version::default()

* refactor(ics04): remove TimeoutHeight::default()

* refactor: remove channelId::default()

* fix: Version::default() to Version::empty()

* remove derive default from Timestamp

* refactor default builder

* remove Sequence::default()

* remove Memo::default()

* refactor: add ChannelId::zero()

* add From<&str> implmentation

* refactor(ibccore): remove ClientId::default()

* refactor(ibccore): remove version::Default()

* refactor(ibccore): remove ConnectionEnd::default()

* refactor(ibc-apps): remove TracePath::default()

* refactor(ibc-core): remove ProofSpecs::default()

* fix(ibc-app): remove upgrade path default

* remove trust threshold default

* refactor(ibc-testkit): remove Default from client_state initialization

* refactor(ibc-testkit): remove Default() of ClientId, ConnectionId,...

* chore: add unclog

* refactor: add Connection::zero()

* use into() instead of ::from()

* refactor: add Version::compatibles()

* refactor(ics24-host): make 07-tendermint-0 a constant in tests

* chore: remove commented out impl Default

* add dummy ClientId

* refactor(ics24-host): remove From<&str> to avoid panic on host

* remove get_compatible_versions

* fix syntax error when import Version

* chore: run cargo fmt

* revert markdown format

* various refactor

* chore: update unclog
---
 .../1074-refactor-default-implemetation.md    |  2 +
 .../architecture/adr-005-handlers-redesign.md |  2 +-
 ibc-apps/ics20-transfer/types/src/denom.rs    | 11 ++-
 ibc-apps/ics20-transfer/types/src/memo.rs     |  6 ++
 .../src/handler/send_transfer.rs              | 10 +--
 ibc-apps/ics721-nft-transfer/src/module.rs    |  7 +-
 .../ics721-nft-transfer/types/src/class.rs    | 11 ++-
 .../ics721-nft-transfer/types/src/data.rs     |  6 +-
 .../ics721-nft-transfer/types/src/memo.rs     |  8 +-
 .../ics07-tendermint/src/client_state.rs      |  4 +-
 .../types/src/client_state.rs                 |  4 +-
 .../types/src/trust_threshold.rs              |  6 --
 .../ics03-connection/types/src/connection.rs  | 27 ++++---
 ibc-core/ics03-connection/types/src/events.rs |  4 +-
 .../ics03-connection/types/src/version.rs     | 55 ++++++++------
 ibc-core/ics04-channel/types/src/channel.rs   |  3 +-
 .../ics04-channel/types/src/events/mod.rs     |  4 +-
 ibc-core/ics04-channel/types/src/timeout.rs   |  6 --
 ibc-core/ics04-channel/types/src/version.rs   |  7 --
 .../ics23-commitment/types/src/commitment.rs  |  6 +-
 ibc-core/ics23-commitment/types/src/specs.rs  |  6 --
 ibc-core/ics24-host/src/context.rs            |  6 +-
 .../types/src/identifiers/channel_id.rs       | 10 +--
 .../types/src/identifiers/client_id.rs        |  6 --
 .../types/src/identifiers/connection_id.rs    | 11 ++-
 .../types/src/identifiers/sequence.rs         |  2 +-
 ibc-core/ics24-host/types/src/path.rs         | 74 ++++++++++---------
 ibc-primitives/src/types/timestamp.rs         |  4 +-
 .../src/fixtures/applications/transfer.rs     | 12 ++-
 .../src/fixtures/clients/tendermint.rs        | 14 ++--
 .../core/channel/chan_close_confirm.rs        |  2 +-
 .../fixtures/core/channel/chan_close_init.rs  |  2 +-
 .../fixtures/core/channel/chan_open_ack.rs    |  4 +-
 .../core/channel/chan_open_confirm.rs         |  2 +-
 ibc-testkit/src/fixtures/core/channel/mod.rs  |  2 +-
 .../src/fixtures/core/channel/packet.rs       | 16 ++--
 .../fixtures/core/connection/conn_open_ack.rs |  6 +-
 .../core/connection/conn_open_init.rs         |  8 +-
 .../fixtures/core/connection/conn_open_try.rs |  8 +-
 .../src/fixtures/core/connection/mod.rs       |  4 +-
 .../src/testapp/ibc/clients/mock/header.rs    |  2 +-
 .../testapp/ibc/clients/mock/misbehaviour.rs  |  2 +-
 ibc-testkit/src/testapp/ibc/core/types.rs     |  2 +-
 .../tests/core/ics02_client/update_client.rs  | 14 ++--
 .../core/ics04_channel/acknowledgement.rs     | 40 +++++-----
 .../core/ics04_channel/chan_close_confirm.rs  | 14 ++--
 .../core/ics04_channel/chan_close_init.rs     | 14 ++--
 .../tests/core/ics04_channel/chan_open_ack.rs |  4 +-
 .../core/ics04_channel/chan_open_confirm.rs   | 30 +++-----
 .../core/ics04_channel/chan_open_init.rs      |  6 +-
 .../tests/core/ics04_channel/chan_open_try.rs |  4 +-
 .../tests/core/ics04_channel/recv_packet.rs   | 40 +++++-----
 .../tests/core/ics04_channel/send_packet.rs   | 57 ++++++--------
 .../tests/core/ics04_channel/timeout.rs       | 64 ++++++++--------
 .../core/ics04_channel/timeout_on_close.rs    | 29 +++++---
 55 files changed, 352 insertions(+), 358 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1074-refactor-default-implemetation.md

diff --git a/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md b/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md
new file mode 100644
index 000000000..fcf1cafe6
--- /dev/null
+++ b/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md
@@ -0,0 +1,2 @@
+- [types] Refactor `Default` implementations with concrete names
+  ([\#1074](https://github.com/cosmos/ibc-rs/issues/1074))
diff --git a/docs/architecture/adr-005-handlers-redesign.md b/docs/architecture/adr-005-handlers-redesign.md
index a4c25890a..855a2b668 100644
--- a/docs/architecture/adr-005-handlers-redesign.md
+++ b/docs/architecture/adr-005-handlers-redesign.md
@@ -296,7 +296,7 @@ trait ValidationContext {
     /// Function required by ICS 03. Returns the list of all possible versions that the connection
     /// handshake protocol supports.
     fn get_compatible_versions(&self) -> Vec<Version> {
-        get_compatible_versions()
+        ConnectionVersion::compatibles()
     }
 
     /// Function required by ICS 03. Returns one version out of the supplied list of versions, which the
diff --git a/ibc-apps/ics20-transfer/types/src/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
index c76eaf062..65b38fe67 100644
--- a/ibc-apps/ics20-transfer/types/src/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -109,7 +109,7 @@ impl Display for TracePrefix {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, Eq, PartialEq, PartialOrd, Ord, From)]
+#[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord, From)]
 pub struct TracePath(Vec<TracePrefix>);
 
 impl TracePath {
@@ -134,6 +134,11 @@ impl TracePath {
     pub fn is_empty(&self) -> bool {
         self.0.is_empty()
     }
+
+    /// Return empty trace path
+    pub fn empty() -> Self {
+        Self(vec![])
+    }
 }
 
 impl<'a> TryFrom<Vec<&'a str>> for TracePath {
@@ -294,7 +299,7 @@ impl FromStr for PrefixedDenom {
 
         let (base_denom, trace_path) = {
             if last_part == s {
-                (BaseDenom::from_str(s)?, TracePath::default())
+                (BaseDenom::from_str(s)?, TracePath::empty())
             } else {
                 let base_denom = BaseDenom::from_str(last_part)?;
                 let trace_path = TracePath::try_from(parts)?;
@@ -334,7 +339,7 @@ impl From<PrefixedDenom> for RawDenomTrace {
 impl From<BaseDenom> for PrefixedDenom {
     fn from(denom: BaseDenom) -> Self {
         Self {
-            trace_path: Default::default(),
+            trace_path: TracePath::empty(),
             base_denom: denom,
         }
     }
diff --git a/ibc-apps/ics20-transfer/types/src/memo.rs b/ibc-apps/ics20-transfer/types/src/memo.rs
index 9a3caea74..a49c40beb 100644
--- a/ibc-apps/ics20-transfer/types/src/memo.rs
+++ b/ibc-apps/ics20-transfer/types/src/memo.rs
@@ -45,6 +45,12 @@ impl From<String> for Memo {
     }
 }
 
+impl From<&str> for Memo {
+    fn from(memo: &str) -> Self {
+        Self(memo.to_owned())
+    }
+}
+
 impl FromStr for Memo {
     type Err = Infallible;
 
diff --git a/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs b/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
index 270164701..4cf1a759c 100644
--- a/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
+++ b/ibc-apps/ics721-nft-transfer/src/handler/send_transfer.rs
@@ -81,14 +81,14 @@ where
                 &msg.chan_id_on_a,
                 class_id,
                 token_id,
-                &packet_data.memo.clone().unwrap_or_default(),
+                &packet_data.memo.clone().unwrap_or("".into()),
             )?;
         } else {
             transfer_ctx.burn_nft_validate(
                 &sender,
                 class_id,
                 token_id,
-                &packet_data.memo.clone().unwrap_or_default(),
+                &packet_data.memo.clone().unwrap_or("".into()),
             )?;
         }
         let nft = transfer_ctx.get_nft(class_id, token_id)?;
@@ -184,14 +184,14 @@ where
                 &msg.chan_id_on_a,
                 class_id,
                 token_id,
-                &packet_data.memo.clone().unwrap_or_default(),
+                &packet_data.memo.clone().unwrap_or("".into()),
             )?;
         } else {
             transfer_ctx.burn_nft_execute(
                 &sender,
                 class_id,
                 token_id,
-                &packet_data.memo.clone().unwrap_or_default(),
+                &packet_data.memo.clone().unwrap_or("".into()),
             )?;
         }
         let nft = transfer_ctx.get_nft(class_id, token_id)?;
@@ -242,7 +242,7 @@ where
             receiver: packet_data.receiver,
             class: packet_data.class_id,
             tokens: packet_data.token_ids,
-            memo: packet_data.memo.unwrap_or_default(),
+            memo: packet_data.memo.unwrap_or("".into()),
         };
         send_packet_ctx_a.emit_ibc_event(ModuleEvent::from(transfer_event).into())?;
 
diff --git a/ibc-apps/ics721-nft-transfer/src/module.rs b/ibc-apps/ics721-nft-transfer/src/module.rs
index 337bffcad..074e7c869 100644
--- a/ibc-apps/ics721-nft-transfer/src/module.rs
+++ b/ibc-apps/ics721-nft-transfer/src/module.rs
@@ -1,5 +1,4 @@
 //! Provides IBC module callbacks implementation for the ICS-721 transfer.
-
 use ibc_core::channel::types::acknowledgement::{Acknowledgement, AcknowledgementStatus};
 use ibc_core::channel::types::channel::{Counterparty, Order};
 use ibc_core::channel::types::packet::Packet;
@@ -190,7 +189,7 @@ pub fn on_recv_packet_execute(
         receiver: data.receiver,
         class: data.class_id,
         tokens: data.token_ids,
-        memo: data.memo.unwrap_or_default(),
+        memo: data.memo.unwrap_or("".into()),
         success: ack.is_successful(),
     };
     extras.events.push(recv_event.into());
@@ -250,7 +249,7 @@ pub fn on_acknowledgement_packet_execute(
         receiver: data.receiver,
         class: data.class_id,
         tokens: data.token_ids,
-        memo: data.memo.unwrap_or_default(),
+        memo: data.memo.unwrap_or("".into()),
         acknowledgement: acknowledgement.clone(),
     };
 
@@ -295,7 +294,7 @@ pub fn on_timeout_packet_execute(
         refund_receiver: data.sender,
         refund_class: data.class_id,
         refund_tokens: data.token_ids,
-        memo: data.memo.unwrap_or_default(),
+        memo: data.memo.unwrap_or("".into()),
     };
 
     let extras = ModuleExtras {
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
index adbc95f92..c2ff9afd4 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/class.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -106,7 +106,7 @@ impl Display for TracePrefix {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, Eq, PartialEq, PartialOrd, Ord, From)]
+#[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord, From)]
 pub struct TracePath(Vec<TracePrefix>);
 
 impl TracePath {
@@ -131,6 +131,11 @@ impl TracePath {
     pub fn is_empty(&self) -> bool {
         self.0.is_empty()
     }
+
+    /// Return empty trace path
+    pub fn empty() -> Self {
+        Self(vec![])
+    }
 }
 
 impl<'a> TryFrom<Vec<&'a str>> for TracePath {
@@ -268,7 +273,7 @@ impl FromStr for PrefixedClassId {
 
         let (base_class_id, trace_path) = {
             if last_part == s {
-                (ClassId::from_str(s)?, TracePath::default())
+                (ClassId::from_str(s)?, TracePath::empty())
             } else {
                 let base_class_id = ClassId::from_str(last_part)?;
                 let trace_path = TracePath::try_from(parts)?;
@@ -308,7 +313,7 @@ impl From<PrefixedClassId> for RawClassTrace {
 impl From<ClassId> for PrefixedClassId {
     fn from(class_id: ClassId) -> Self {
         Self {
-            trace_path: Default::default(),
+            trace_path: TracePath::empty(),
             base_class_id: class_id,
         }
     }
diff --git a/ibc-apps/ics721-nft-transfer/types/src/data.rs b/ibc-apps/ics721-nft-transfer/types/src/data.rs
index e6e4afbee..ef4b86e55 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/data.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/data.rs
@@ -24,7 +24,7 @@ use crate::error::NftTransferError;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, PartialEq, Eq, derive_more::From)]
+#[derive(Clone, Debug, PartialEq, Eq, derive_more::From)]
 pub struct Data(String);
 
 #[cfg(feature = "serde")]
@@ -88,7 +88,7 @@ impl<'de> serde::Deserialize<'de> for Data {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Ics721Data(BTreeMap<String, DataValue>);
 
 #[cfg(feature = "serde")]
@@ -100,7 +100,7 @@ impl FromStr for Ics721Data {
     }
 }
 
-#[derive(Clone, Debug, Default, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub struct DataValue {
     value: String,
     mime: Option<Mime>,
diff --git a/ibc-apps/ics721-nft-transfer/types/src/memo.rs b/ibc-apps/ics721-nft-transfer/types/src/memo.rs
index 432dd4fc6..b18f2027d 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/memo.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/memo.rs
@@ -24,7 +24,7 @@ use ibc_core::primitives::prelude::*;
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Memo(String);
 
 impl AsRef<str> for Memo {
@@ -45,6 +45,12 @@ impl From<String> for Memo {
     }
 }
 
+impl From<&str> for Memo {
+    fn from(memo: &str) -> Self {
+        Self(memo.to_owned())
+    }
+}
+
 impl FromStr for Memo {
     type Err = Infallible;
 
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 13c10b963..9f1fe3139 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -111,8 +111,8 @@ mod tests {
             unbonding_period: Duration::new(128_000, 0),
             max_clock_drift: Duration::new(3, 0),
             latest_height: Height::new(1, 10).expect("Never fails"),
-            proof_specs: ProofSpecs::default(),
-            upgrade_path: Default::default(),
+            proof_specs: ProofSpecs::cosmos(),
+            upgrade_path: Vec::new(),
             allow_update: AllowUpdate {
                 after_expiry: false,
                 after_misbehaviour: false,
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index a533858a2..0208d0426 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -438,8 +438,8 @@ mod tests {
             unbonding_period: Duration::new(128_000, 0),
             max_clock_drift: Duration::new(3, 0),
             latest_height: Height::new(0, 10).expect("Never fails"),
-            proof_specs: ProofSpecs::default(),
-            upgrade_path: Default::default(),
+            proof_specs: ProofSpecs::cosmos(),
+            upgrade_path: Vec::new(),
             allow_update: AllowUpdate {
                 after_expiry: false,
                 after_misbehaviour: false,
diff --git a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
index 9ca77a660..07f2bbb70 100644
--- a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
+++ b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
@@ -134,12 +134,6 @@ impl TryFrom<Fraction> for TrustThreshold {
     }
 }
 
-impl Default for TrustThreshold {
-    fn default() -> Self {
-        Self::ONE_THIRD
-    }
-}
-
 impl Display for TrustThreshold {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
         write!(f, "{}/{}", self.numerator, self.denominator)
diff --git a/ibc-core/ics03-connection/types/src/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
index d73d53930..8225763a4 100644
--- a/ibc-core/ics03-connection/types/src/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -1,6 +1,7 @@
 //! Defines the types that define a connection
 
 use core::fmt::{Display, Error as FmtError, Formatter};
+use core::str::FromStr;
 use core::time::Duration;
 use core::u64;
 
@@ -200,18 +201,6 @@ mod sealed {
     }
 }
 
-impl Default for ConnectionEnd {
-    fn default() -> Self {
-        Self {
-            state: State::Uninitialized,
-            client_id: Default::default(),
-            counterparty: Default::default(),
-            versions: Vec::new(),
-            delay_period: ZERO_DURATION,
-        }
-    }
-}
-
 impl Protobuf<RawConnectionEnd> for ConnectionEnd {}
 
 impl TryFrom<RawConnectionEnd> for ConnectionEnd {
@@ -220,7 +209,17 @@ impl TryFrom<RawConnectionEnd> for ConnectionEnd {
         let state = value.state.try_into()?;
 
         if state == State::Uninitialized {
-            return Ok(ConnectionEnd::default());
+            return ConnectionEnd::new(
+                State::Uninitialized,
+                ClientId::from_str("07-tendermint-0").expect("should not fail"),
+                Counterparty::new(
+                    ClientId::from_str("07-tendermint-0").expect("should not fail"),
+                    None,
+                    CommitmentPrefix::empty(),
+                ),
+                Vec::new(),
+                ZERO_DURATION,
+            );
         }
 
         if value.client_id.is_empty() {
@@ -378,7 +377,7 @@ impl ConnectionEnd {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Default, PartialEq, Eq, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, Hash)]
 pub struct Counterparty {
     pub client_id: ClientId,
     pub connection_id: Option<ConnectionId>,
diff --git a/ibc-core/ics03-connection/types/src/events.rs b/ibc-core/ics03-connection/types/src/events.rs
index 1866a3982..1c2879852 100644
--- a/ibc-core/ics03-connection/types/src/events.rs
+++ b/ibc-core/ics03-connection/types/src/events.rs
@@ -29,7 +29,7 @@ pub const COUNTERPARTY_CLIENT_ID_ATTRIBUTE_KEY: &str = "counterparty_client_id";
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[derive(Clone, Debug, Default, PartialEq, Eq, PartialOrd, Ord, Hash)]
+#[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)]
 struct Attributes {
     pub connection_id: ConnectionId,
     pub client_id: ClientId,
@@ -323,7 +323,7 @@ mod tests {
 
         let client_type = ClientType::from_str("07-tendermint")
             .expect("never fails because it's a valid client type");
-        let conn_id_on_a = ConnectionId::default();
+        let conn_id_on_a = ConnectionId::zero();
         let client_id_on_a = client_type.build_client_id(0);
         let conn_id_on_b = ConnectionId::new(1);
         let client_id_on_b = client_type.build_client_id(1);
diff --git a/ibc-core/ics03-connection/types/src/version.rs b/ibc-core/ics03-connection/types/src/version.rs
index 46029c68c..2979e2622 100644
--- a/ibc-core/ics03-connection/types/src/version.rs
+++ b/ibc-core/ics03-connection/types/src/version.rs
@@ -58,6 +58,14 @@ impl Version {
         }
         Ok(())
     }
+
+    /// Returns the lists of supported versions
+    pub fn compatibles() -> Vec<Self> {
+        vec![Self {
+            identifier: "1".to_string(),
+            features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
+        }]
+    }
 }
 
 impl Protobuf<RawVersion> for Version {}
@@ -89,15 +97,6 @@ impl From<Version> for RawVersion {
     }
 }
 
-impl Default for Version {
-    fn default() -> Self {
-        Version {
-            identifier: "1".to_string(),
-            features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
-        }
-    }
-}
-
 impl Display for Version {
     fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
         write!(
@@ -109,11 +108,6 @@ impl Display for Version {
     }
 }
 
-/// Returns the lists of supported versions
-pub fn get_compatible_versions() -> Vec<Version> {
-    vec![Version::default()]
-}
-
 /// Iterates over the descending ordered set of compatible IBC versions and
 /// selects the first version with a version identifier that is supported by the
 /// counterparty. The returned version contains a feature set with the
@@ -189,7 +183,7 @@ mod tests {
     use ibc_proto::ibc::core::connection::v1::Version as RawVersion;
 
     use crate::error::ConnectionError;
-    use crate::version::{get_compatible_versions, pick_version, Version};
+    use crate::version::{pick_version, Version};
 
     fn get_dummy_features() -> Vec<String> {
         vec!["ORDER_RANDOM".to_string(), "ORDER_UNORDERED".to_string()]
@@ -197,7 +191,11 @@ mod tests {
 
     fn good_versions() -> Vec<RawVersion> {
         vec![
-            Version::default().into(),
+            Version {
+                identifier: "1".to_string(),
+                features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
+            }
+            .into(),
             RawVersion {
                 identifier: "2".to_string(),
                 features: get_dummy_features(),
@@ -228,7 +226,10 @@ mod tests {
     fn overlapping() -> (Vec<Version>, Vec<Version>, Version) {
         (
             vec![
-                Version::default(),
+                Version {
+                    identifier: "1".to_string(),
+                    features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
+                },
                 Version {
                     identifier: "3".to_string(),
                     features: get_dummy_features(),
@@ -291,7 +292,11 @@ mod tests {
         let tests: Vec<Test> = vec![
             Test {
                 name: "Compatible versions".to_string(),
-                versions: vec![Version::default().into()],
+                versions: vec![Version {
+                    identifier: "1".to_string(),
+                    features: get_dummy_features(),
+                }
+                .into()],
                 want_pass: true,
             },
             Test {
@@ -344,9 +349,12 @@ mod tests {
         let tests: Vec<Test> = vec![
             Test {
                 name: "Compatible versions".to_string(),
-                supported: get_compatible_versions(),
-                counterparty: get_compatible_versions(),
-                picked: Ok(Version::default()),
+                supported: Version::compatibles(),
+                counterparty: Version::compatibles(),
+                picked: Ok(Version {
+                    identifier: "1".to_string(),
+                    features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
+                }),
                 want_pass: true,
             },
             Test {
@@ -382,7 +390,10 @@ mod tests {
     }
     #[test]
     fn serialize() {
-        let def = Version::default();
+        let def = Version {
+            identifier: "1".to_string(),
+            features: vec!["ORDER_ORDERED".to_string(), "ORDER_UNORDERED".to_string()],
+        };
         let def_raw: RawVersion = def.clone().into();
         let def_back = def_raw.try_into().unwrap();
         assert_eq!(def, def_back);
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index 732e17185..20c3957ff 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -439,10 +439,9 @@ impl From<Counterparty> for RawCounterparty {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
+#[derive(Clone, Copy, Debug, PartialEq, Eq)]
 pub enum Order {
     None = 0isize,
-    #[default]
     Unordered = 1isize,
     Ordered = 2isize,
 }
diff --git a/ibc-core/ics04-channel/types/src/events/mod.rs b/ibc-core/ics04-channel/types/src/events/mod.rs
index fbb78d6e7..3fee6bb6e 100644
--- a/ibc-core/ics04-channel/types/src/events/mod.rs
+++ b/ibc-core/ics04-channel/types/src/events/mod.rs
@@ -1132,8 +1132,8 @@ mod tests {
         }
 
         let port_id = PortId::transfer();
-        let channel_id = ChannelId::new(0);
-        let connection_id = ConnectionId::new(0);
+        let channel_id = ChannelId::zero();
+        let connection_id = ConnectionId::zero();
         let counterparty_port_id = PortId::transfer();
         let counterparty_channel_id = ChannelId::new(1);
         let version = Version::new("ics20-1".to_string());
diff --git a/ibc-core/ics04-channel/types/src/timeout.rs b/ibc-core/ics04-channel/types/src/timeout.rs
index 3a7e825ce..e20ccf0d8 100644
--- a/ibc-core/ics04-channel/types/src/timeout.rs
+++ b/ibc-core/ics04-channel/types/src/timeout.rs
@@ -84,12 +84,6 @@ impl TimeoutHeight {
     }
 }
 
-impl Default for TimeoutHeight {
-    fn default() -> Self {
-        Self::Never
-    }
-}
-
 impl TryFrom<RawHeight> for TimeoutHeight {
     type Error = ClientError;
 
diff --git a/ibc-core/ics04-channel/types/src/version.rs b/ibc-core/ics04-channel/types/src/version.rs
index bf41109da..2cfc1e46c 100644
--- a/ibc-core/ics04-channel/types/src/version.rs
+++ b/ibc-core/ics04-channel/types/src/version.rs
@@ -74,13 +74,6 @@ impl FromStr for Version {
     }
 }
 
-/// The default version is empty (unspecified).
-impl Default for Version {
-    fn default() -> Self {
-        Version::empty()
-    }
-}
-
 impl Display for Version {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
         write!(f, "{}", self.0)
diff --git a/ibc-core/ics23-commitment/types/src/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
index e4ae8fcf0..25f4ca579 100644
--- a/ibc-core/ics23-commitment/types/src/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -143,7 +143,7 @@ impl<'a> TryFrom<&'a CommitmentProofBytes> for MerkleProof {
 )]
 #[cfg_attr(feature = "serde", derive(serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, PartialEq, Eq, Hash, Default)]
+#[derive(Clone, PartialEq, Eq, Hash)]
 pub struct CommitmentPrefix {
     bytes: Vec<u8>,
 }
@@ -156,6 +156,10 @@ impl CommitmentPrefix {
     pub fn into_vec(self) -> Vec<u8> {
         self.bytes
     }
+
+    pub fn empty() -> Self {
+        Self { bytes: Vec::new() }
+    }
 }
 
 impl TryFrom<Vec<u8>> for CommitmentPrefix {
diff --git a/ibc-core/ics23-commitment/types/src/specs.rs b/ibc-core/ics23-commitment/types/src/specs.rs
index b7789cebc..3cd40ac84 100644
--- a/ibc-core/ics23-commitment/types/src/specs.rs
+++ b/ibc-core/ics23-commitment/types/src/specs.rs
@@ -45,12 +45,6 @@ impl ProofSpecs {
     }
 }
 
-impl Default for ProofSpecs {
-    fn default() -> Self {
-        Self::cosmos()
-    }
-}
-
 impl From<Vec<RawProofSpec>> for ProofSpecs {
     fn from(ics23_specs: Vec<RawProofSpec>) -> Self {
         Self(ics23_specs.into_iter().map(Into::into).collect())
diff --git a/ibc-core/ics24-host/src/context.rs b/ibc-core/ics24-host/src/context.rs
index 9335fce60..b390d6b83 100644
--- a/ibc-core/ics24-host/src/context.rs
+++ b/ibc-core/ics24-host/src/context.rs
@@ -6,9 +6,7 @@ use ibc_core_channel_types::packet::Receipt;
 use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::Height;
 use ibc_core_commitment_types::commitment::CommitmentPrefix;
-use ibc_core_connection_types::version::{
-    get_compatible_versions, pick_version, Version as ConnectionVersion,
-};
+use ibc_core_connection_types::version::{pick_version, Version as ConnectionVersion};
 use ibc_core_connection_types::ConnectionEnd;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::IbcEvent;
@@ -78,7 +76,7 @@ pub trait ValidationContext {
     /// Function required by ICS-03. Returns the list of all possible versions that the connection
     /// handshake protocol supports.
     fn get_compatible_versions(&self) -> Vec<ConnectionVersion> {
-        get_compatible_versions()
+        ConnectionVersion::compatibles()
     }
 
     /// Function required by ICS-03. Returns one version out of the supplied list of versions, which the
diff --git a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
index 3cfeacb7b..5d4583dc6 100644
--- a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
@@ -57,6 +57,10 @@ impl ChannelId {
     pub fn as_bytes(&self) -> &[u8] {
         self.0.as_bytes()
     }
+
+    pub fn zero() -> Self {
+        Self::new(0)
+    }
 }
 
 /// This implementation provides a `to_string` method.
@@ -80,12 +84,6 @@ impl AsRef<str> for ChannelId {
     }
 }
 
-impl Default for ChannelId {
-    fn default() -> Self {
-        Self::new(0)
-    }
-}
-
 /// Equality check against string literal (satisfies &ChannelId == &str).
 /// ```
 /// use core::str::FromStr;
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_id.rs b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
index 62a5662d6..ecbfe1cca 100644
--- a/ibc-core/ics24-host/types/src/identifiers/client_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_id.rs
@@ -76,12 +76,6 @@ impl FromStr for ClientId {
     }
 }
 
-impl Default for ClientId {
-    fn default() -> Self {
-        Self::from_str("07-tendermint-0").expect("Never fails because we use a valid client id")
-    }
-}
-
 /// Equality check against string literal (satisfies &ClientId == &str).
 /// ```
 /// use core::str::FromStr;
diff --git a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
index a0283f5f4..883c41138 100644
--- a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
@@ -56,6 +56,11 @@ impl ConnectionId {
     pub fn as_bytes(&self) -> &[u8] {
         self.0.as_bytes()
     }
+
+    /// Return ConnectionId with identifier 0
+    pub fn zero() -> Self {
+        Self::new(0)
+    }
 }
 
 /// This implementation provides a `to_string` method.
@@ -73,12 +78,6 @@ impl FromStr for ConnectionId {
     }
 }
 
-impl Default for ConnectionId {
-    fn default() -> Self {
-        Self::new(0)
-    }
-}
-
 /// Equality check against string literal (satisfies &ConnectionId == &str).
 /// ```
 /// use core::str::FromStr;
diff --git a/ibc-core/ics24-host/types/src/identifiers/sequence.rs b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
index 7919ba56e..9e8b2ccbc 100644
--- a/ibc-core/ics24-host/types/src/identifiers/sequence.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/sequence.rs
@@ -17,7 +17,7 @@ use crate::error::IdentifierError;
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 /// The sequence number of a packet enforces ordering among packets from the same source.
-#[derive(Copy, Clone, Debug, Default, PartialEq, Eq, Hash, PartialOrd, Ord)]
+#[derive(Copy, Clone, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
 pub struct Sequence(u64);
 
 impl core::str::FromStr for Sequence {
diff --git a/ibc-core/ics24-host/types/src/path.rs b/ibc-core/ics24-host/types/src/path.rs
index 3247f5a63..43e99347e 100644
--- a/ibc-core/ics24-host/types/src/path.rs
+++ b/ibc-core/ics24-host/types/src/path.rs
@@ -1074,7 +1074,13 @@ fn parse_upgrades(components: &[&str]) -> Option<Path> {
 #[cfg(test)]
 mod tests {
     use super::*;
-
+    const DEFAULT_CLIENT_ID_STR: &str = "07-tendermint-0";
+    impl ClientId {
+        pub fn new_dummy() -> Self {
+            ClientId::from_str(DEFAULT_CLIENT_ID_STR)
+                .expect("should not fail since we use a valid client id")
+        }
+    }
     #[rstest::rstest]
     #[case(NEXT_CLIENT_SEQUENCE, Path::NextClientSequence(NextClientSequencePath))]
     #[case(
@@ -1087,12 +1093,12 @@ mod tests {
     )]
     #[case(
         "clients/07-tendermint-0/clientState",
-        Path::ClientState(ClientStatePath(ClientId::default()))
+        Path::ClientState(ClientStatePath(ClientId::new_dummy()))
     )]
     #[case(
         "clients/07-tendermint-0/consensusStates/15-31",
         Path::ClientConsensusState(ClientConsensusStatePath {
-            client_id: ClientId::default(),
+            client_id: ClientId::new_dummy(),
             revision_number: 15,
             revision_height: 31,
         })
@@ -1100,7 +1106,7 @@ mod tests {
     #[case(
         "clients/07-tendermint-0/consensusStates/15-31/processedTime",
         Path::ClientUpdateTime(ClientUpdateTimePath {
-            client_id: ClientId::default(),
+            client_id: ClientId::new_dummy(),
             revision_number: 15,
             revision_height: 31,
         })
@@ -1108,58 +1114,58 @@ mod tests {
     #[case(
         "clients/07-tendermint-0/consensusStates/15-31/processedHeight",
         Path::ClientUpdateHeight(ClientUpdateHeightPath {
-            client_id: ClientId::default(),
+            client_id: ClientId::new_dummy(),
             revision_number: 15,
             revision_height: 31,
         })
     )]
     #[case(
         "clients/07-tendermint-0/connections",
-        Path::ClientConnection(ClientConnectionPath(ClientId::default()))
+        Path::ClientConnection(ClientConnectionPath(ClientId::new_dummy()))
     )]
     #[case(
         "connections/connection-0",
-        Path::Connection(ConnectionPath(ConnectionId::new(0)))
+        Path::Connection(ConnectionPath(ConnectionId::zero()))
     )]
     #[case("ports/transfer", Path::Ports(PortPath(PortId::transfer())))]
     #[case(
         "channelEnds/ports/transfer/channels/channel-0",
-        Path::ChannelEnd(ChannelEndPath(PortId::transfer(), ChannelId::default()))
+        Path::ChannelEnd(ChannelEndPath(PortId::transfer(), ChannelId::zero()))
     )]
     #[case(
         "nextSequenceSend/ports/transfer/channels/channel-0",
-        Path::SeqSend(SeqSendPath(PortId::transfer(), ChannelId::default()))
+        Path::SeqSend(SeqSendPath(PortId::transfer(), ChannelId::zero()))
     )]
     #[case(
         "nextSequenceRecv/ports/transfer/channels/channel-0",
-        Path::SeqRecv(SeqRecvPath(PortId::transfer(), ChannelId::default()))
+        Path::SeqRecv(SeqRecvPath(PortId::transfer(), ChannelId::zero()))
     )]
     #[case(
         "nextSequenceAck/ports/transfer/channels/channel-0",
-        Path::SeqAck(SeqAckPath(PortId::transfer(), ChannelId::default()))
+        Path::SeqAck(SeqAckPath(PortId::transfer(), ChannelId::zero()))
     )]
     #[case(
         "commitments/ports/transfer/channels/channel-0/sequences/0",
         Path::Commitment(CommitmentPath {
             port_id: PortId::transfer(),
-            channel_id: ChannelId::default(),
-            sequence: Sequence::default(),
+            channel_id: ChannelId::zero(),
+            sequence: Sequence::from(0),
         })
     )]
     #[case(
         "acks/ports/transfer/channels/channel-0/sequences/0",
         Path::Ack(AckPath {
             port_id: PortId::transfer(),
-            channel_id: ChannelId::default(),
-            sequence: Sequence::default(),
+            channel_id: ChannelId::zero(),
+            sequence: Sequence::from(0),
         })
     )]
     #[case(
         "receipts/ports/transfer/channels/channel-0/sequences/0",
         Path::Receipt(ReceiptPath {
             port_id: PortId::transfer(),
-            channel_id: ChannelId::default(),
-            sequence: Sequence::default(),
+            channel_id: ChannelId::zero(),
+            sequence: Sequence::from(0),
         })
     )]
     #[case(
@@ -1193,7 +1199,7 @@ mod tests {
 
         assert_eq!(
             parse_client_paths(&components),
-            Some(Path::ClientState(ClientStatePath(ClientId::default())))
+            Some(Path::ClientState(ClientStatePath(ClientId::new_dummy())))
         );
 
         let path = "clients/07-tendermint-0/consensusStates/15-31";
@@ -1202,7 +1208,7 @@ mod tests {
         assert_eq!(
             parse_client_paths(&components),
             Some(Path::ClientConsensusState(ClientConsensusStatePath {
-                client_id: ClientId::default(),
+                client_id: ClientId::new_dummy(),
                 revision_number: 15,
                 revision_height: 31,
             }))
@@ -1217,7 +1223,7 @@ mod tests {
         assert_eq!(
             parse_client_paths(&components),
             Some(Path::ClientUpdateTime(ClientUpdateTimePath {
-                client_id: ClientId::default(),
+                client_id: ClientId::new_dummy(),
                 revision_number: 15,
                 revision_height: 31,
             }))
@@ -1229,7 +1235,7 @@ mod tests {
         assert_eq!(
             parse_client_paths(&components),
             Some(Path::ClientUpdateHeight(ClientUpdateHeightPath {
-                client_id: ClientId::default(),
+                client_id: ClientId::new_dummy(),
                 revision_number: 15,
                 revision_height: 31,
             }))
@@ -1243,7 +1249,7 @@ mod tests {
 
         assert_eq!(
             parse_connections(&components),
-            Some(Path::Connection(ConnectionPath(ConnectionId::new(0)))),
+            Some(Path::Connection(ConnectionPath(ConnectionId::zero()))),
         );
     }
 
@@ -1265,7 +1271,7 @@ mod tests {
 
         assert_eq!(
             parse_channels(&components),
-            Some(SubPath::Channels(ChannelId::default())),
+            Some(SubPath::Channels(ChannelId::zero())),
         );
     }
 
@@ -1276,7 +1282,7 @@ mod tests {
 
         assert_eq!(
             parse_sequences(&components),
-            Some(SubPath::Sequences(Sequence::default()))
+            Some(SubPath::Sequences(Sequence::from(0)))
         );
     }
 
@@ -1289,7 +1295,7 @@ mod tests {
             parse_channel_ends(&components),
             Some(Path::ChannelEnd(ChannelEndPath(
                 PortId::transfer(),
-                ChannelId::default()
+                ChannelId::zero()
             ))),
         );
     }
@@ -1303,7 +1309,7 @@ mod tests {
             parse_seqs(&components),
             Some(Path::SeqSend(SeqSendPath(
                 PortId::transfer(),
-                ChannelId::default()
+                ChannelId::zero()
             ))),
         );
 
@@ -1314,7 +1320,7 @@ mod tests {
             parse_seqs(&components),
             Some(Path::SeqRecv(SeqRecvPath(
                 PortId::transfer(),
-                ChannelId::default()
+                ChannelId::zero()
             ))),
         );
 
@@ -1325,7 +1331,7 @@ mod tests {
             parse_seqs(&components),
             Some(Path::SeqAck(SeqAckPath(
                 PortId::transfer(),
-                ChannelId::default()
+                ChannelId::zero()
             ))),
         );
     }
@@ -1339,8 +1345,8 @@ mod tests {
             parse_commitments(&components),
             Some(Path::Commitment(CommitmentPath {
                 port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
+                channel_id: ChannelId::zero(),
+                sequence: Sequence::from(0),
             })),
         );
     }
@@ -1354,8 +1360,8 @@ mod tests {
             parse_acks(&components),
             Some(Path::Ack(AckPath {
                 port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
+                channel_id: ChannelId::zero(),
+                sequence: Sequence::from(0),
             })),
         );
     }
@@ -1369,8 +1375,8 @@ mod tests {
             parse_receipts(&components),
             Some(Path::Receipt(ReceiptPath {
                 port_id: PortId::transfer(),
-                channel_id: ChannelId::default(),
-                sequence: Sequence::default(),
+                channel_id: ChannelId::zero(),
+                sequence: Sequence::from(0),
             })),
         );
     }
diff --git a/ibc-primitives/src/types/timestamp.rs b/ibc-primitives/src/types/timestamp.rs
index 9454b2b91..7023c948e 100644
--- a/ibc-primitives/src/types/timestamp.rs
+++ b/ibc-primitives/src/types/timestamp.rs
@@ -24,7 +24,7 @@ pub const ZERO_DURATION: Duration = Duration::from_secs(0);
 /// of timestamp.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(PartialEq, Eq, Copy, Clone, Debug, Default, PartialOrd, Ord, Hash)]
+#[derive(PartialEq, Eq, Copy, Clone, Debug, PartialOrd, Ord, Hash)]
 pub struct Timestamp {
     // Note: The schema representation is the timestamp in nanoseconds (as we do with borsh).
     #[cfg_attr(feature = "schema", schemars(with = "u64"))]
@@ -169,7 +169,7 @@ impl Timestamp {
     /// let ti = Timestamp::from_nanoseconds(min).unwrap();
     /// let uti = ti.nanoseconds();
     /// assert_eq!(uti, min);
-    /// let tz = Timestamp::default();
+    /// let tz = Timestamp::none();
     /// let utz = tz.nanoseconds();
     /// assert_eq!(utz, 0);
     /// ```
diff --git a/ibc-testkit/src/fixtures/applications/transfer.rs b/ibc-testkit/src/fixtures/applications/transfer.rs
index b352f1a42..35e71fac0 100644
--- a/ibc-testkit/src/fixtures/applications/transfer.rs
+++ b/ibc-testkit/src/fixtures/applications/transfer.rs
@@ -1,5 +1,3 @@
-use alloc::string::ToString;
-
 use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
 use ibc::apps::transfer::types::packet::PacketData;
 use ibc::apps::transfer::types::{Memo, PrefixedCoin};
@@ -17,12 +15,12 @@ use crate::fixtures::core::signer::dummy_account_id;
 pub struct MsgTransferConfig {
     #[builder(default = PortId::transfer())]
     pub port_id_on_a: PortId,
-    #[builder(default)]
+    #[builder(default = ChannelId::zero())]
     pub chan_id_on_a: ChannelId,
     pub packet_data: PacketData,
-    #[builder(default)]
+    #[builder(default = TimeoutHeight::Never)]
     pub timeout_height_on_b: TimeoutHeight,
-    #[builder(default)]
+    #[builder(default = Timestamp::none())]
     pub timeout_timestamp_on_b: Timestamp,
 }
 
@@ -47,7 +45,7 @@ pub fn extract_transfer_packet(msg: &MsgTransfer, sequence: Sequence) -> Packet
         port_id_on_a: msg.port_id_on_a.clone(),
         chan_id_on_a: msg.chan_id_on_a.clone(),
         port_id_on_b: PortId::transfer(),
-        chan_id_on_b: ChannelId::default(),
+        chan_id_on_b: ChannelId::zero(),
         data,
         timeout_height_on_b: msg.timeout_height_on_b,
         timeout_timestamp_on_b: msg.timeout_timestamp_on_b,
@@ -63,7 +61,7 @@ pub struct PacketDataConfig {
     pub sender: Signer,
     #[builder(default = dummy_account_id())]
     pub receiver: Signer,
-    #[builder(default = Memo::from("".to_string()))]
+    #[builder(default = "".into())]
     pub memo: Memo,
 }
 
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index 0e4aa261a..f96ad0e6b 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -26,13 +26,13 @@ pub fn dummy_tm_client_state_from_header(tm_header: TmHeader) -> TmClientState {
     let chain_id = ChainId::from_str(tm_header.chain_id.as_str()).expect("Never fails");
     let client_state = ClientStateType::new(
         chain_id.clone(),
-        Default::default(),
+        TrustThreshold::ONE_THIRD,
         Duration::from_secs(64000),
         Duration::from_secs(128_000),
         Duration::from_millis(3000),
         Height::new(chain_id.revision_number(), u64::from(tm_header.height)).expect("Never fails"),
-        Default::default(),
-        Default::default(),
+        ProofSpecs::cosmos(),
+        Vec::new(),
         AllowUpdate {
             after_expiry: false,
             after_misbehaviour: false,
@@ -56,8 +56,8 @@ pub fn dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
         unbonding_period: Some(Duration::from_secs(128_000).into()),
         max_clock_drift: Some(Duration::from_millis(3000).into()),
         latest_height: Some(Height::new(0, 10).expect("Never fails").into()),
-        proof_specs: ProofSpecs::default().into(),
-        upgrade_path: Default::default(),
+        proof_specs: ProofSpecs::cosmos().into(),
+        upgrade_path: Vec::new(),
         frozen_height: Some(frozen_height),
         allow_update_after_expiry: false,
         allow_update_after_misbehaviour: false,
@@ -67,7 +67,7 @@ pub fn dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
 #[derive(typed_builder::TypedBuilder, Debug)]
 pub struct ClientStateConfig {
     pub chain_id: ChainId,
-    #[builder(default)]
+    #[builder(default = TrustThreshold::ONE_THIRD)]
     pub trust_level: TrustThreshold,
     #[builder(default = Duration::from_secs(64000))]
     pub trusting_period: Duration,
@@ -76,7 +76,7 @@ pub struct ClientStateConfig {
     #[builder(default = Duration::from_millis(3000))]
     max_clock_drift: Duration,
     pub latest_height: Height,
-    #[builder(default)]
+    #[builder(default = ProofSpecs::cosmos())]
     pub proof_specs: ProofSpecs,
     #[builder(default)]
     pub upgrade_path: Vec<String>,
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
index 650c735ac..df833f545 100644
--- a/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
+++ b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
@@ -10,7 +10,7 @@ use crate::fixtures::core::signer::dummy_bech32_account;
 pub fn dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelCloseConfirm {
     RawMsgChannelCloseConfirm {
         port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
+        channel_id: ChannelId::zero().to_string(),
         proof_init: dummy_proof(),
         proof_height: Some(Height {
             revision_number: 0,
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs b/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
index dd770443d..89956ddab 100644
--- a/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
+++ b/ibc-testkit/src/fixtures/core/channel/chan_close_init.rs
@@ -8,7 +8,7 @@ use crate::fixtures::core::signer::dummy_bech32_account;
 pub fn dummy_raw_msg_chan_close_init() -> RawMsgChannelCloseInit {
     RawMsgChannelCloseInit {
         port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
+        channel_id: ChannelId::zero().to_string(),
         signer: dummy_bech32_account(),
     }
 }
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
index 8b9a0b952..2b89bd3b4 100644
--- a/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_ack.rs
@@ -10,8 +10,8 @@ use crate::fixtures::core::signer::dummy_bech32_account;
 pub fn dummy_raw_msg_chan_open_ack(proof_height: u64) -> RawMsgChannelOpenAck {
     RawMsgChannelOpenAck {
         port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
-        counterparty_channel_id: ChannelId::default().to_string(),
+        channel_id: ChannelId::zero().to_string(),
+        counterparty_channel_id: ChannelId::zero().to_string(),
         counterparty_version: "".to_string(),
         proof_try: dummy_proof(),
         proof_height: Some(Height {
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs b/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
index dfb1c797e..3871fc9f2 100644
--- a/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
+++ b/ibc-testkit/src/fixtures/core/channel/chan_open_confirm.rs
@@ -10,7 +10,7 @@ use crate::fixtures::core::signer::dummy_bech32_account;
 pub fn dummy_raw_msg_chan_open_confirm(proof_height: u64) -> RawMsgChannelOpenConfirm {
     RawMsgChannelOpenConfirm {
         port_id: PortId::transfer().to_string(),
-        channel_id: ChannelId::default().to_string(),
+        channel_id: ChannelId::zero().to_string(),
         proof_ack: dummy_proof(),
         proof_height: Some(Height {
             revision_number: 0,
diff --git a/ibc-testkit/src/fixtures/core/channel/mod.rs b/ibc-testkit/src/fixtures/core/channel/mod.rs
index 0f0df1bf4..a1375cd72 100644
--- a/ibc-testkit/src/fixtures/core/channel/mod.rs
+++ b/ibc-testkit/src/fixtures/core/channel/mod.rs
@@ -46,7 +46,7 @@ pub fn dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel
         state,
         ordering: 2,
         counterparty: Some(dummy_raw_counterparty_chan(channel_id)),
-        connection_hops: vec![ConnectionId::default().to_string()],
+        connection_hops: vec![ConnectionId::zero().to_string()],
         version: "".to_string(), // The version is not validated.
     }
 }
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
index 02b99a8bc..b33e1b2a4 100644
--- a/ibc-testkit/src/fixtures/core/channel/packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -11,21 +11,21 @@ use typed_builder::TypedBuilder;
 #[derive(TypedBuilder, Debug)]
 #[builder(build_method(into = Packet))]
 pub struct PacketConfig {
-    #[builder(default)]
+    #[builder(default = Sequence::from(0))]
     pub seq_on_a: Sequence,
     #[builder(default = PortId::transfer())]
     pub port_id_on_a: PortId,
-    #[builder(default)]
+    #[builder(default = ChannelId::zero())]
     pub chan_id_on_a: ChannelId,
     #[builder(default = PortId::transfer())]
     pub port_id_on_b: PortId,
-    #[builder(default)]
+    #[builder(default = ChannelId::zero())]
     pub chan_id_on_b: ChannelId,
     #[builder(default)]
     pub data: Vec<u8>,
-    #[builder(default)]
+    #[builder(default = TimeoutHeight::Never)]
     pub timeout_height_on_b: TimeoutHeight,
-    #[builder(default)]
+    #[builder(default = Timestamp::none())]
     pub timeout_timestamp_on_b: Timestamp,
 }
 
@@ -49,9 +49,9 @@ pub fn dummy_raw_packet(timeout_height: u64, timeout_timestamp: u64) -> RawPacke
     RawPacket {
         sequence: 1,
         source_port: PortId::transfer().to_string(),
-        source_channel: ChannelId::default().to_string(),
+        source_channel: ChannelId::zero().to_string(),
         destination_port: PortId::transfer().to_string(),
-        destination_channel: ChannelId::default().to_string(),
+        destination_channel: ChannelId::zero().to_string(),
         data: vec![0],
         timeout_height: Some(RawHeight {
             revision_number: 0,
@@ -265,7 +265,7 @@ mod tests {
         let ibc_event = IbcEvent::SendPacket(SendPacket::new(
             packet,
             Order::Unordered,
-            ConnectionId::default(),
+            ConnectionId::zero(),
         ));
         let _ = tendermint::abci::Event::try_from(ibc_event);
     }
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
index f690e430a..863e79343 100644
--- a/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_ack.rs
@@ -2,7 +2,7 @@ use ibc::core::client::types::proto::v1::Height as RawHeight;
 use ibc::core::client::types::Height;
 use ibc::core::connection::types::msgs::MsgConnectionOpenAck;
 use ibc::core::connection::types::proto::v1::MsgConnectionOpenAck as RawMsgConnectionOpenAck;
-use ibc::core::connection::types::version::Version;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::primitives::prelude::*;
 
@@ -24,7 +24,7 @@ pub fn dummy_raw_msg_conn_open_ack(
 ) -> RawMsgConnectionOpenAck {
     let client_state_height = Height::new(0, consensus_height).expect("invalid height");
     RawMsgConnectionOpenAck {
-        connection_id: ConnectionId::new(0).to_string(),
+        connection_id: ConnectionId::zero().to_string(),
         counterparty_connection_id: ConnectionId::new(1).to_string(),
         proof_try: dummy_proof(),
         proof_height: Some(RawHeight {
@@ -38,7 +38,7 @@ pub fn dummy_raw_msg_conn_open_ack(
         }),
         client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
         proof_client: dummy_proof(),
-        version: Some(Version::default().into()),
+        version: Some(ConnectionVersion::compatibles()[0].clone().into()),
         signer: dummy_bech32_account(),
         host_consensus_state_proof: vec![],
     }
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
index 07302e0de..07036f4fc 100644
--- a/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_init.rs
@@ -2,7 +2,7 @@ use ibc::core::connection::types::msgs::MsgConnectionOpenInit;
 use ibc::core::connection::types::proto::v1::{
     MsgConnectionOpenInit as RawMsgConnectionOpenInit, Version as RawVersion,
 };
-use ibc::core::connection::types::version::Version;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::Counterparty;
 use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::primitives::prelude::*;
@@ -57,7 +57,7 @@ pub fn msg_conn_open_with_version(
     identifier: Option<&str>,
 ) -> MsgConnectionOpenInit {
     let version = match identifier {
-        Some(v) => Version::try_from(RawVersion {
+        Some(v) => ConnectionVersion::try_from(RawVersion {
             identifier: v.to_string(),
             features: vec![],
         })
@@ -71,9 +71,9 @@ pub fn msg_conn_open_with_version(
 /// Returns a dummy `RawMsgConnectionOpenInit`, for testing purposes only!
 pub fn dummy_raw_msg_conn_open_init() -> RawMsgConnectionOpenInit {
     RawMsgConnectionOpenInit {
-        client_id: ClientId::default().to_string(),
+        client_id: "07-tendermint-0".into(),
         counterparty: Some(dummy_raw_counterparty_conn(None)),
-        version: Some(Version::default().into()),
+        version: Some(ConnectionVersion::compatibles()[0].clone().into()),
         delay_period: 0,
         signer: dummy_bech32_account(),
     }
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
index 5780dd928..d3f9f60ea 100644
--- a/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_try.rs
@@ -2,7 +2,7 @@ use ibc::core::client::types::proto::v1::Height as RawHeight;
 use ibc::core::client::types::Height;
 use ibc::core::connection::types::msgs::MsgConnectionOpenTry;
 use ibc::core::connection::types::proto::v1::MsgConnectionOpenTry as RawMsgConnectionOpenTry;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::primitives::prelude::*;
 
@@ -40,12 +40,12 @@ pub fn dummy_raw_msg_conn_open_try(
 
     #[allow(deprecated)]
     RawMsgConnectionOpenTry {
-        client_id: ClientId::default().to_string(),
-        previous_connection_id: ConnectionId::default().to_string(),
+        client_id: "07-tendermint-0".into(),
+        previous_connection_id: ConnectionId::zero().to_string(),
         client_state: Some(MockClientState::new(MockHeader::new(client_state_height)).into()),
         counterparty: Some(dummy_raw_counterparty_conn(Some(0))),
         delay_period: 0,
-        counterparty_versions: get_compatible_versions()
+        counterparty_versions: ConnectionVersion::compatibles()
             .iter()
             .map(|v| v.clone().into())
             .collect(),
diff --git a/ibc-testkit/src/fixtures/core/connection/mod.rs b/ibc-testkit/src/fixtures/core/connection/mod.rs
index 0567705c0..5b8388147 100644
--- a/ibc-testkit/src/fixtures/core/connection/mod.rs
+++ b/ibc-testkit/src/fixtures/core/connection/mod.rs
@@ -9,7 +9,7 @@ pub use conn_open_init::*;
 pub use conn_open_try::*;
 use ibc::core::commitment_types::proto::v1::MerklePrefix;
 use ibc::core::connection::types::proto::v1::Counterparty as RawCounterparty;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::primitives::prelude::*;
 use typed_builder::TypedBuilder;
 
@@ -42,7 +42,7 @@ pub fn dummy_raw_counterparty_conn(conn_id: Option<u64>) -> RawCounterparty {
         None => "".to_string(),
     };
     RawCounterparty {
-        client_id: ClientId::default().to_string(),
+        client_id: "07-tendermint-0".into(),
         connection_id,
         prefix: Some(MerklePrefix {
             key_prefix: b"ibc".to_vec(),
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/header.rs b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
index 072b7bba7..a861ac311 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
@@ -21,7 +21,7 @@ impl Default for MockHeader {
     fn default() -> Self {
         Self {
             height: Height::min(0),
-            timestamp: Default::default(),
+            timestamp: Timestamp::none(),
         }
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
index f0769e4df..15ea17a40 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
@@ -23,7 +23,7 @@ impl TryFrom<RawMisbehaviour> for Misbehaviour {
 
     fn try_from(raw: RawMisbehaviour) -> Result<Self, Self::Error> {
         Ok(Self {
-            client_id: Default::default(),
+            client_id: ClientId::new("07-tendermint", 0).expect("no error"),
             header1: raw
                 .header1
                 .ok_or(ClientError::MissingRawMisbehaviour)?
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index 549e39f8f..7e365c49c 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -125,7 +125,7 @@ pub struct MockContext {
 pub struct MockClientConfig {
     #[builder(default = ChainId::new("mockZ-1").expect("no error"))]
     client_chain_id: ChainId,
-    #[builder(default)]
+    #[builder(default = ClientId::new("07-tendermint", 0).expect("no error"))]
     client_id: ClientId,
     #[builder(default = mock_client_type())]
     client_type: ClientType,
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 61956e336..20828b529 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -43,7 +43,7 @@ struct Fixture {
 
 #[fixture]
 fn fixture() -> Fixture {
-    let client_id = ClientId::default();
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
 
     let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -82,7 +82,7 @@ fn test_update_client_ok(fixture: Fixture) {
         mut router,
     } = fixture;
 
-    let client_id = ClientId::default();
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let signer = dummy_account_id();
     let timestamp = Timestamp::now();
 
@@ -114,7 +114,7 @@ fn test_update_client_ok(fixture: Fixture) {
 // client's height and ensures that `ConsensusState` is stored at the correct
 // path (header height).
 fn test_update_client_with_prev_header() {
-    let client_id = ClientId::default();
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let chain_id_b = ChainId::new("mockgaiaA-0").unwrap();
     let latest_height = Height::new(0, 42).unwrap();
     let height_1 = Height::new(0, 43).unwrap();
@@ -681,8 +681,8 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
                     .unwrap()
                     .into(),
                 ),
-                proof_specs: ProofSpecs::default().into(),
-                upgrade_path: Default::default(),
+                proof_specs: ProofSpecs::cosmos().into(),
+                upgrade_path: Vec::new(),
                 frozen_height: Some(RawHeight {
                     revision_number: 0,
                     revision_height: 0,
@@ -782,7 +782,7 @@ fn test_update_client_events(fixture: Fixture) {
         mut router,
     } = fixture;
 
-    let client_id = ClientId::default();
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let signer = dummy_account_id();
     let timestamp = Timestamp::now();
 
@@ -846,7 +846,7 @@ fn test_misbehaviour_client_ok(fixture: Fixture) {
         mut router,
     } = fixture;
 
-    let client_id = ClientId::default();
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let msg_envelope = msg_update_client(&client_id);
 
     let res = validate(&ctx, &router, msg_envelope.clone());
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index 056936fd1..7ac747dc5 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -4,7 +4,8 @@ use ibc::core::channel::types::msgs::{MsgAcknowledgement, PacketMsg};
 use ibc::core::channel::types::Version;
 use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -33,6 +34,8 @@ struct Fixture {
 
 #[fixture]
 fn fixture() -> Fixture {
+    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     let client_height = Height::new(0, 2).unwrap();
     let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -59,7 +62,7 @@ fn fixture() -> Fixture {
         State::Open,
         Order::Unordered,
         Counterparty::new(packet.port_id_on_b, Some(packet.chan_id_on_b)),
-        vec![ConnectionId::default()],
+        vec![ConnectionId::zero()],
         Version::new("ics20-1".to_string()),
     )
     .unwrap();
@@ -69,13 +72,13 @@ fn fixture() -> Fixture {
 
     let conn_end_on_a = ConnectionEnd::new(
         ConnectionState::Open,
-        ClientId::default(),
+        default_client_id.clone(),
         ConnectionCounterparty::new(
-            ClientId::default(),
-            Some(ConnectionId::default()),
-            Default::default(),
+            default_client_id.clone(),
+            Some(ConnectionId::zero()),
+            CommitmentPrefix::empty(),
         ),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -128,10 +131,10 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
         )
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a);
+        .with_connection(ConnectionId::zero(), conn_end_on_a);
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
@@ -145,6 +148,7 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
 
 #[rstest]
 fn ack_success_happy_path(fixture: Fixture) {
+    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let Fixture {
         ctx,
         router,
@@ -163,10 +167,10 @@ fn ack_success_happy_path(fixture: Fixture) {
         )
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
@@ -175,7 +179,7 @@ fn ack_success_happy_path(fixture: Fixture) {
         );
     ctx.get_client_execution_context()
         .store_update_meta(
-            ClientId::default(),
+            default_client_id,
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 4).unwrap(),
@@ -206,10 +210,10 @@ fn ack_unordered_chan_execute(fixture: Fixture) {
     let mut ctx = ctx
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
@@ -245,12 +249,8 @@ fn ack_ordered_chan_execute(fixture: Fixture) {
         ..
     } = fixture;
     let mut ctx = ctx
-        .with_channel(
-            PortId::transfer(),
-            ChannelId::default(),
-            chan_end_on_a_ordered,
-        )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a_ordered)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index d337c7d4a..14b358702 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -1,7 +1,7 @@
 use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelCloseConfirm};
 use ibc::core::channel::types::Version;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -28,7 +28,7 @@ fn test_chan_close_confirm_validate() {
         ConnectionState::Open,
         client_id.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -42,13 +42,13 @@ fn test_chan_close_confirm_validate() {
 
     let chan_end = ChannelEnd::new(
         ChannelState::Open,
-        Order::default(),
+        Order::Unordered,
         Counterparty::new(
             msg_chan_close_confirm.port_id_on_b.clone(),
             Some(msg_chan_close_confirm.chan_id_on_b.clone()),
         ),
         vec![conn_id.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
 
@@ -87,7 +87,7 @@ fn test_chan_close_confirm_execute() {
         ConnectionState::Open,
         client_id.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -101,13 +101,13 @@ fn test_chan_close_confirm_execute() {
 
     let chan_end = ChannelEnd::new(
         ChannelState::Open,
-        Order::default(),
+        Order::Unordered,
         Counterparty::new(
             msg_chan_close_confirm.port_id_on_b.clone(),
             Some(msg_chan_close_confirm.chan_id_on_b.clone()),
         ),
         vec![conn_id.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index ccf040f85..00ee8cdab 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -1,7 +1,7 @@
 use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State as ChannelState};
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelCloseInit};
 use ibc::core::channel::types::Version;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -26,7 +26,7 @@ fn test_chan_close_init_validate() {
         ConnectionState::Open,
         client_id.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -38,13 +38,13 @@ fn test_chan_close_init_validate() {
 
     let chan_end = ChannelEnd::new(
         ChannelState::Open,
-        Order::default(),
+        Order::Unordered,
         Counterparty::new(
             msg_chan_close_init.port_id_on_a.clone(),
             Some(msg_chan_close_init.chan_id_on_a.clone()),
         ),
         vec![conn_id.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
 
@@ -86,7 +86,7 @@ fn test_chan_close_init_execute() {
         ConnectionState::Open,
         client_id.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -98,13 +98,13 @@ fn test_chan_close_init_execute() {
 
     let chan_end = ChannelEnd::new(
         ChannelState::Open,
-        Order::default(),
+        Order::Unordered,
         Counterparty::new(
             msg_chan_close_init.port_id_on_a.clone(),
             Some(msg_chan_close_init.chan_id_on_a.clone()),
         ),
         vec![conn_id.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index 6a584e2ca..8c3140910 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -2,7 +2,7 @@ use ibc::apps::transfer::types::MODULE_ID_STR;
 use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenAck};
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -46,7 +46,7 @@ fn fixture() -> Fixture {
         ConnectionState::Open,
         client_id_on_a.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index f01b4adfd..c97338f2e 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -2,7 +2,7 @@ use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State}
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenConfirm};
 use ibc::core::channel::types::Version;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -43,7 +43,7 @@ fn fixture() -> Fixture {
         ConnectionState::Open,
         client_id_on_b.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -54,9 +54,9 @@ fn fixture() -> Fixture {
     let chan_end_on_b = ChannelEnd::new(
         State::TryOpen,
         Order::Unordered,
-        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
+        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::zero())),
         vec![conn_id_on_b.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
 
@@ -94,11 +94,7 @@ fn chan_open_confirm_validate_happy_path(fixture: Fixture) {
                 .build(),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
-        .with_channel(
-            msg.port_id_on_b.clone(),
-            ChannelId::default(),
-            chan_end_on_b,
-        );
+        .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), chan_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
@@ -129,11 +125,7 @@ fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
                 .build(),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
-        .with_channel(
-            msg.port_id_on_b.clone(),
-            ChannelId::default(),
-            chan_end_on_b,
-        );
+        .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), chan_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
@@ -200,9 +192,9 @@ fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
     let wrong_chan_end = ChannelEnd::new(
         State::Init,
         Order::Unordered,
-        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::default())),
+        Counterparty::new(msg.port_id_on_b.clone(), Some(ChannelId::zero())),
         vec![conn_id_on_b.clone()],
-        Version::default(),
+        Version::empty(),
     )
     .unwrap();
     let context = context
@@ -213,11 +205,7 @@ fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
                 .build(),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
-        .with_channel(
-            msg.port_id_on_b.clone(),
-            ChannelId::default(),
-            wrong_chan_end,
-        );
+        .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), wrong_chan_end);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index d79f8989c..a76f34d03 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -1,7 +1,7 @@
 use ibc::clients::tendermint::types::client_type as tm_client_type;
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenInit};
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{ConnectionEnd, State as ConnectionState};
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
@@ -40,7 +40,7 @@ fn fixture() -> Fixture {
         ConnectionState::Init,
         msg_conn_init.client_id_on_a.clone(),
         msg_conn_init.counterparty.clone(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         msg_conn_init.delay_period,
     )
     .unwrap();
@@ -52,7 +52,7 @@ fn fixture() -> Fixture {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a);
+        .with_connection(ConnectionId::zero(), conn_end_on_a);
 
     Fixture { ctx, router, msg }
 }
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index 35d8a55a7..e9b121dba 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -1,6 +1,6 @@
 use ibc::core::channel::types::msgs::{ChannelMsg, MsgChannelOpenTry};
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -39,7 +39,7 @@ fn fixture() -> Fixture {
         ConnectionState::Open,
         client_id_on_b.clone(),
         ConnectionCounterparty::try_from(dummy_raw_counterparty_conn(Some(0))).unwrap(),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index 773390f17..a11a90837 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -4,7 +4,8 @@ use ibc::core::channel::types::packet::Packet;
 use ibc::core::channel::types::Version;
 use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -30,10 +31,13 @@ pub struct Fixture {
     pub msg: MsgRecvPacket,
     pub conn_end_on_b: ConnectionEnd,
     pub chan_end_on_b: ChannelEnd,
+    pub client_id: ClientId,
 }
 
 #[fixture]
 fn fixture() -> Fixture {
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     let context = MockContext::default();
 
     let router = MockRouter::new_with_transfer();
@@ -49,22 +53,22 @@ fn fixture() -> Fixture {
 
     let chan_end_on_b = ChannelEnd::new(
         State::Open,
-        Order::default(),
+        Order::Unordered,
         Counterparty::new(packet.port_id_on_a, Some(packet.chan_id_on_a)),
-        vec![ConnectionId::default()],
+        vec![ConnectionId::zero()],
         Version::new("ics20-1".to_string()),
     )
     .unwrap();
 
     let conn_end_on_b = ConnectionEnd::new(
         ConnectionState::Open,
-        ClientId::default(),
+        client_id.clone(),
         ConnectionCounterparty::new(
-            ClientId::default(),
-            Some(ConnectionId::default()),
-            Default::default(),
+            client_id.clone(),
+            Some(ConnectionId::zero()),
+            CommitmentPrefix::empty(),
         ),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -77,6 +81,7 @@ fn fixture() -> Fixture {
         msg,
         conn_end_on_b,
         chan_end_on_b,
+        client_id,
     }
 }
 
@@ -109,6 +114,7 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
         chan_end_on_b,
         client_height,
         host_height,
+        client_id,
         ..
     } = fixture;
 
@@ -119,7 +125,7 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_b)
+        .with_connection(ConnectionId::zero(), conn_end_on_b)
         .with_channel(
             packet.port_id_on_b.clone(),
             packet.chan_id_on_b.clone(),
@@ -141,7 +147,7 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
     context
         .get_client_execution_context()
         .store_update_meta(
-            ClientId::default(),
+            client_id,
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 5).unwrap(),
@@ -174,9 +180,9 @@ fn recv_packet_timeout_expired(fixture: Fixture) {
     let packet_old = Packet {
         seq_on_a: 1.into(),
         port_id_on_a: PortId::transfer(),
-        chan_id_on_a: ChannelId::default(),
+        chan_id_on_a: ChannelId::zero(),
         port_id_on_b: PortId::transfer(),
-        chan_id_on_b: ChannelId::default(),
+        chan_id_on_b: ChannelId::zero(),
         data: Vec::new(),
         timeout_height_on_b: client_height.into(),
         timeout_timestamp_on_b: Timestamp::from_nanoseconds(1).unwrap(),
@@ -197,9 +203,9 @@ fn recv_packet_timeout_expired(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_b)
-        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b)
-        .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into())
+        .with_connection(ConnectionId::zero(), conn_end_on_b)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_b)
+        .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into())
         .with_height(host_height);
 
     let res = validate(&context, &router, msg_envelope);
@@ -227,8 +233,8 @@ fn recv_packet_execute_happy_path(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_b)
-        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_b);
+        .with_connection(ConnectionId::zero(), conn_end_on_b)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_b);
 
     let msg_env = MsgEnvelope::from(PacketMsg::from(msg));
 
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index 333563ee0..acd58417a 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -6,7 +6,8 @@ use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State}
 use ibc::core::channel::types::packet::Packet;
 use ibc::core::channel::types::Version;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -19,6 +20,8 @@ use test_log::test;
 
 #[test]
 fn send_packet_processing() {
+    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     struct Test {
         name: String,
         ctx: MockContext,
@@ -30,22 +33,22 @@ fn send_packet_processing() {
 
     let chan_end_on_a = ChannelEnd::new(
         State::Open,
-        Order::default(),
-        Counterparty::new(PortId::transfer(), Some(ChannelId::default())),
-        vec![ConnectionId::default()],
+        Order::Unordered,
+        Counterparty::new(PortId::transfer(), Some(ChannelId::zero())),
+        vec![ConnectionId::zero()],
         Version::new("ics20-1".to_string()),
     )
     .unwrap();
 
     let conn_end_on_a = ConnectionEnd::new(
         ConnectionState::Open,
-        ClientId::default(),
+        default_client_id.clone(),
         ConnectionCounterparty::new(
-            ClientId::default(),
-            Some(ConnectionId::default()),
-            Default::default(),
+            default_client_id.clone(),
+            Some(ConnectionId::zero()),
+            CommitmentPrefix::empty(),
         ),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -97,13 +100,9 @@ fn send_packet_processing() {
                         .latest_height(client_height)
                         .build(),
                 )
-                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                .with_channel(
-                    PortId::transfer(),
-                    ChannelId::default(),
-                    chan_end_on_a.clone(),
-                )
-                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+                .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
+                .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
+                .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into()),
             packet,
             want_pass: true,
         },
@@ -116,13 +115,9 @@ fn send_packet_processing() {
                         .latest_height(client_height)
                         .build(),
                 )
-                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                .with_channel(
-                    PortId::transfer(),
-                    ChannelId::default(),
-                    chan_end_on_a.clone(),
-                )
-                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+                .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
+                .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
+                .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into()),
             packet: packet_timeout_equal_client_height,
             want_pass: true,
         },
@@ -135,13 +130,9 @@ fn send_packet_processing() {
                         .latest_height(client_height)
                         .build(),
                 )
-                .with_connection(ConnectionId::default(), conn_end_on_a.clone())
-                .with_channel(
-                    PortId::transfer(),
-                    ChannelId::default(),
-                    chan_end_on_a.clone(),
-                )
-                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+                .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
+                .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
+                .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into()),
             packet: packet_timeout_one_before_client_height,
             want_pass: false,
         },
@@ -153,9 +144,9 @@ fn send_packet_processing() {
                         .latest_height(client_height)
                         .build(),
                 )
-                .with_connection(ConnectionId::default(), conn_end_on_a)
-                .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
-                .with_send_sequence(PortId::transfer(), ChannelId::default(), 1.into()),
+                .with_connection(ConnectionId::zero(), conn_end_on_a)
+                .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a)
+                .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into()),
             packet: packet_with_timestamp_old,
             want_pass: false,
         },
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index 55d964b68..05036636a 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -4,7 +4,8 @@ use ibc::core::channel::types::msgs::{MsgTimeout, PacketMsg};
 use ibc::core::channel::types::Version;
 use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -28,10 +29,13 @@ struct Fixture {
     conn_end_on_a: ConnectionEnd,
     chan_end_on_a_ordered: ChannelEnd,
     chan_end_on_a_unordered: ChannelEnd,
+    client_id: ClientId,
 }
 
 #[fixture]
 fn fixture() -> Fixture {
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     let client_height = Height::new(0, 2).unwrap();
     let ctx = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -66,7 +70,7 @@ fn fixture() -> Fixture {
         State::Open,
         Order::Unordered,
         Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
-        vec![ConnectionId::default()],
+        vec![ConnectionId::zero()],
         Version::new("ics20-1".to_string()),
     )
     .unwrap();
@@ -76,13 +80,13 @@ fn fixture() -> Fixture {
 
     let conn_end_on_a = ConnectionEnd::new(
         ConnectionState::Open,
-        ClientId::default(),
+        client_id.clone(),
         ConnectionCounterparty::new(
-            ClientId::default(),
-            Some(ConnectionId::default()),
-            Default::default(),
+            client_id.clone(),
+            Some(ConnectionId::zero()),
+            CommitmentPrefix::empty(),
         ),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -96,6 +100,7 @@ fn fixture() -> Fixture {
         conn_end_on_a,
         chan_end_on_a_ordered,
         chan_end_on_a_unordered,
+        client_id,
     }
 }
 
@@ -139,10 +144,10 @@ fn timeout_fail_no_consensus_state_for_height(fixture: Fixture) {
     let ctx = ctx
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             packet.port_id_on_a,
             packet.chan_id_on_a,
@@ -169,6 +174,7 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
         chan_end_on_a_unordered,
         conn_end_on_a,
         client_height,
+        client_id,
         ..
     } = fixture;
 
@@ -190,10 +196,10 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
         .with_packet_commitment(
@@ -204,7 +210,7 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
         );
 
     ctx.store_update_meta(
-        ClientId::default(),
+        client_id,
         client_height,
         Timestamp::from_nanoseconds(5).unwrap(),
         Height::new(0, 4).unwrap(),
@@ -235,10 +241,10 @@ fn timeout_success_no_packet_commitment(fixture: Fixture) {
     let ctx = ctx
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a);
+        .with_connection(ConnectionId::zero(), conn_end_on_a);
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
@@ -260,6 +266,7 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
         conn_end_on_a,
         packet_commitment,
         client_height,
+        client_id,
         ..
     } = fixture;
 
@@ -271,10 +278,10 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
         .with_packet_commitment(
@@ -286,7 +293,7 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
 
     ctx.get_client_execution_context()
         .store_update_meta(
-            ClientId::default(),
+            client_id,
             client_height,
             Timestamp::from_nanoseconds(1000).unwrap(),
             Height::new(0, 5).unwrap(),
@@ -310,6 +317,7 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
         conn_end_on_a,
         packet_commitment,
         client_height,
+        client_id,
         ..
     } = fixture;
 
@@ -321,12 +329,8 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
                 .latest_height(client_height)
                 .build(),
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
-        .with_channel(
-            PortId::transfer(),
-            ChannelId::default(),
-            chan_end_on_a_ordered,
-        )
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a_ordered)
         .with_packet_commitment(
             packet.port_id_on_a,
             packet.chan_id_on_a,
@@ -335,7 +339,7 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
         );
 
     ctx.store_update_meta(
-        ClientId::default(),
+        client_id,
         client_height,
         Timestamp::from_nanoseconds(1000).unwrap(),
         Height::new(0, 4).unwrap(),
@@ -363,10 +367,10 @@ fn timeout_unordered_chan_execute(fixture: Fixture) {
     let mut ctx = ctx
         .with_channel(
             PortId::transfer(),
-            ChannelId::default(),
+            ChannelId::zero(),
             chan_end_on_a_unordered,
         )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
@@ -403,12 +407,8 @@ fn timeout_ordered_chan_execute(fixture: Fixture) {
         ..
     } = fixture;
     let mut ctx = ctx
-        .with_channel(
-            PortId::transfer(),
-            ChannelId::default(),
-            chan_end_on_a_ordered,
-        )
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a_ordered)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index c0321e8b1..39a4c306a 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -4,7 +4,8 @@ use ibc::core::channel::types::msgs::{MsgTimeoutOnClose, PacketMsg};
 use ibc::core::channel::types::Version;
 use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
-use ibc::core::connection::types::version::get_compatible_versions;
+use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::connection::types::version::Version as ConnectionVersion;
 use ibc::core::connection::types::{
     ConnectionEnd, Counterparty as ConnectionCounterparty, State as ConnectionState,
 };
@@ -29,6 +30,8 @@ pub struct Fixture {
 
 #[fixture]
 fn fixture() -> Fixture {
+    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     let client_height = Height::new(0, 2).unwrap();
     let context = MockContext::default().with_client_config(
         MockClientConfig::builder()
@@ -56,20 +59,20 @@ fn fixture() -> Fixture {
         State::Open,
         Order::Ordered,
         Counterparty::new(packet.port_id_on_b.clone(), Some(packet.chan_id_on_b)),
-        vec![ConnectionId::default()],
+        vec![ConnectionId::zero()],
         Version::new("ics20-1".to_string()),
     )
     .unwrap();
 
     let conn_end_on_a = ConnectionEnd::new(
         ConnectionState::Open,
-        ClientId::default(),
+        default_client_id.clone(),
         ConnectionCounterparty::new(
-            ClientId::default(),
-            Some(ConnectionId::default()),
-            Default::default(),
+            default_client_id.clone(),
+            Some(ConnectionId::zero()),
+            CommitmentPrefix::empty(),
         ),
-        get_compatible_versions(),
+        ConnectionVersion::compatibles(),
         ZERO_DURATION,
     )
     .unwrap();
@@ -115,8 +118,8 @@ fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
         ..
     } = fixture;
     let context = context
-        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
-        .with_connection(ConnectionId::default(), conn_end_on_a);
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a);
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
@@ -130,6 +133,8 @@ fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
 
 #[rstest]
 fn timeout_on_close_success_happy_path(fixture: Fixture) {
+    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
+
     let Fixture {
         context,
         router,
@@ -140,8 +145,8 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
         ..
     } = fixture;
     let mut context = context
-        .with_channel(PortId::transfer(), ChannelId::default(), chan_end_on_a)
-        .with_connection(ConnectionId::default(), conn_end_on_a)
+        .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a)
+        .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
             msg.packet.port_id_on_a.clone(),
             msg.packet.chan_id_on_a.clone(),
@@ -152,7 +157,7 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
     context
         .get_client_execution_context()
         .store_update_meta(
-            ClientId::default(),
+            default_client_id,
             Height::new(0, 2).unwrap(),
             Timestamp::from_nanoseconds(5000).unwrap(),
             Height::new(0, 5).unwrap(),

From 5e7ff8e42c15592cff22a14536cc479f08cf8024 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 13 Mar 2024 14:39:08 +0100
Subject: [PATCH 128/182] fix(ci): check wasm compile on ci (#1122)

* check wasm compile on ci

* fix wasm compile

* revert wasm compile check at prs
---
 ci/cw-check/src/lib.rs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ci/cw-check/src/lib.rs b/ci/cw-check/src/lib.rs
index 7ebe4effb..e567d844e 100644
--- a/ci/cw-check/src/lib.rs
+++ b/ci/cw-check/src/lib.rs
@@ -36,7 +36,7 @@ pub fn instantiate(
     let d =
         serde_json::to_string(&ConnectionId::from_str(msg.test.as_str()).unwrap()).expect("test");
     let e = serde_json::to_string(&PrefixedDenom {
-        trace_path: TracePath::default(),
+        trace_path: TracePath::empty(),
         base_denom: BaseDenom::from_str(msg.test.as_str()).unwrap(),
     })
     .expect("test");

From 3b11b12cc7963f8391a547bd2d60744708e91cbd Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 15 Mar 2024 00:59:58 +0100
Subject: [PATCH 129/182] deps: upgrade `ibc-proto-rs` to `0.42.2` (#1125)

* ibc-proto v0.42.1

* handle new data fields

* impl new service methods

* new mock client header in testkit

* update fixtures with new fields

* patch crates-io release

* refactor MockClientState methods

* chore: set ibc-proto-rs to v0.42.2

* chore: add changelog

* fix: make fmt happy

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
---
 .../1125-upgrade-ibc-proto-to-v042.md         |  2 +
 .../breaking-changes/973-update-meta.md       |  6 +--
 .../1074-refactor-default-implemetation.md    |  2 +-
 Cargo.toml                                    |  2 +-
 ci/cw-check/Cargo.lock                        |  4 +-
 ci/no-std-check/Cargo.lock                    |  4 +-
 ci/no-std-check/Cargo.toml                    |  2 +-
 ibc-core/ics04-channel/types/src/channel.rs   |  7 +++
 ibc-core/ics04-channel/types/src/error.rs     |  2 +
 .../types/src/msgs/chan_close_confirm.rs      |  5 ++
 .../types/src/msgs/timeout_on_close.rs        |  9 +++-
 ibc-query/src/core/channel/service.rs         | 31 ++++++++++-
 .../core/channel/chan_close_confirm.rs        |  1 +
 ibc-testkit/src/fixtures/core/channel/mod.rs  |  1 +
 .../fixtures/core/channel/timeout_on_close.rs |  1 +
 .../testapp/ibc/clients/mock/client_state.rs  | 54 ++++++++++++++-----
 16 files changed, 107 insertions(+), 26 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md

diff --git a/.changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md b/.changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md
new file mode 100644
index 000000000..8df9dec51
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md
@@ -0,0 +1,2 @@
+- [ibc] Upgrade `ibc-proto-rs` to `v0.42.2`
+  ([\#1125](https://github.com/cosmos/ibc-rs/pull/1125))
diff --git a/.changelog/unreleased/breaking-changes/973-update-meta.md b/.changelog/unreleased/breaking-changes/973-update-meta.md
index 2aabe1231..97702e220 100644
--- a/.changelog/unreleased/breaking-changes/973-update-meta.md
+++ b/.changelog/unreleased/breaking-changes/973-update-meta.md
@@ -1,6 +1,6 @@
-- Merge client update time and height modification method pairs into
-  one, that is replace
+- [ibc-core-client] Merge client update time and height modification method
+  pairs into one, that is replace
   a) client_update_{time,height} by update_meta,
   b) store_update_{time,height} by store_update_meta and
   c) delete_update_{time,height} by delete_update_meta.
-  ([\#972](https://github.com/cosmos/ibc-rs/pull/972))
+  ([\#973](https://github.com/cosmos/ibc-rs/issues/973))
diff --git a/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md b/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md
index fcf1cafe6..908463b41 100644
--- a/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md
+++ b/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md
@@ -1,2 +1,2 @@
-- [types] Refactor `Default` implementations with concrete names
+- [ibc-data-types] Refactor `Default` implementations with concrete names
   ([\#1074](https://github.com/cosmos/ibc-rs/issues/1074))
diff --git a/Cargo.toml b/Cargo.toml
index e3efe6af3..946a3efdc 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -93,7 +93,7 @@ ibc-client-wasm-types       = { version = "0.50.0", path = "./ibc-clients/ics08-
 ibc-app-transfer-types      = { version = "0.50.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 ibc-app-nft-transfer-types  = { version = "0.50.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
-ibc-proto = { version = "0.41.0", default-features = false }
+ibc-proto = { version = "0.42.2", default-features = false }
 
 # cosmos dependencies
 tendermint                       = { version = "0.34.0", default-features = false }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 98a8201e7..d191ea07d 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -862,9 +862,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.41.0"
+version = "0.42.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
+checksum = "c1a6f2bbf7e1d12f98d8d54d9114231b865418d0f8b619c0873180eafdee07fd"
 dependencies = [
  "base64 0.21.6",
  "bytes",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index fb12ae90c..e430db282 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1617,9 +1617,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.41.0"
+version = "0.42.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dd4ee32b22d3b06f31529b956f4928e5c9a068d71e46cf6abfa19c31ca550553"
+checksum = "c1a6f2bbf7e1d12f98d8d54d9114231b865418d0f8b619c0873180eafdee07fd"
 dependencies = [
  "base64 0.21.7",
  "borsh",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 815a42f96..d7f6f8965 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,7 +6,7 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.41.0", default-features = false, features = [
+ibc-proto = { version = "0.42.2", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index 20c3957ff..81d4fee84 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -52,12 +52,17 @@ impl TryFrom<RawIdentifiedChannel> for IdentifiedChannelEnd {
     type Error = ChannelError;
 
     fn try_from(value: RawIdentifiedChannel) -> Result<Self, Self::Error> {
+        if value.upgrade_sequence != 0 {
+            return Err(ChannelError::UnsupportedChannelUpgradeSequence);
+        }
+
         let raw_channel_end = RawChannel {
             state: value.state,
             ordering: value.ordering,
             counterparty: value.counterparty,
             connection_hops: value.connection_hops,
             version: value.version,
+            upgrade_sequence: value.upgrade_sequence,
         };
 
         Ok(IdentifiedChannelEnd {
@@ -83,6 +88,7 @@ impl From<IdentifiedChannelEnd> for RawIdentifiedChannel {
             version: value.channel_end.version.to_string(),
             port_id: value.port_id.to_string(),
             channel_id: value.channel_id.to_string(),
+            upgrade_sequence: 0,
         }
     }
 }
@@ -161,6 +167,7 @@ impl From<ChannelEnd> for RawChannel {
                 .map(|v| v.as_str().to_string())
                 .collect(),
             version: value.version.to_string(),
+            upgrade_sequence: 0,
         }
     }
 }
diff --git a/ibc-core/ics04-channel/types/src/error.rs b/ibc-core/ics04-channel/types/src/error.rs
index 652ad0878..9fb77c7c0 100644
--- a/ibc-core/ics04-channel/types/src/error.rs
+++ b/ibc-core/ics04-channel/types/src/error.rs
@@ -33,6 +33,8 @@ pub enum ChannelError {
     NonUtf8PacketData,
     /// missing counterparty
     MissingCounterparty,
+    /// unsupported channel upgrade sequence
+    UnsupportedChannelUpgradeSequence,
     /// version not supported: expected `{expected}`, actual `{actual}`
     VersionNotSupported { expected: Version, actual: Version },
     /// missing channel end
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
index c60d3bf5e..c533fc59c 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_close_confirm.rs
@@ -35,6 +35,10 @@ impl TryFrom<RawMsgChannelCloseConfirm> for MsgChannelCloseConfirm {
     type Error = ChannelError;
 
     fn try_from(raw_msg: RawMsgChannelCloseConfirm) -> Result<Self, Self::Error> {
+        if raw_msg.counterparty_upgrade_sequence != 0 {
+            return Err(ChannelError::UnsupportedChannelUpgradeSequence);
+        }
+
         Ok(MsgChannelCloseConfirm {
             port_id_on_b: raw_msg.port_id.parse()?,
             chan_id_on_b: raw_msg.channel_id.parse()?,
@@ -59,6 +63,7 @@ impl From<MsgChannelCloseConfirm> for RawMsgChannelCloseConfirm {
             proof_init: domain_msg.proof_chan_end_on_a.clone().into(),
             proof_height: Some(domain_msg.proof_height_on_a.into()),
             signer: domain_msg.signer.to_string(),
+            counterparty_upgrade_sequence: 0,
         }
     }
 }
diff --git a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
index 95cdb826d..7673d5f33 100644
--- a/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/timeout_on_close.rs
@@ -6,7 +6,7 @@ use ibc_primitives::Signer;
 use ibc_proto::ibc::core::channel::v1::MsgTimeoutOnClose as RawMsgTimeoutOnClose;
 use ibc_proto::Protobuf;
 
-use crate::error::PacketError;
+use crate::error::{ChannelError, PacketError};
 use crate::packet::Packet;
 
 pub const TIMEOUT_ON_CLOSE_TYPE_URL: &str = "/ibc.core.channel.v1.MsgTimeoutOnClose";
@@ -39,6 +39,12 @@ impl TryFrom<RawMsgTimeoutOnClose> for MsgTimeoutOnClose {
             return Err(PacketError::ZeroPacketSequence);
         }
 
+        if raw_msg.counterparty_upgrade_sequence != 0 {
+            return Err(PacketError::Channel(
+                ChannelError::UnsupportedChannelUpgradeSequence,
+            ));
+        }
+
         Ok(MsgTimeoutOnClose {
             packet: raw_msg
                 .packet
@@ -71,6 +77,7 @@ impl From<MsgTimeoutOnClose> for RawMsgTimeoutOnClose {
             proof_height: Some(domain_msg.proof_height_on_b.into()),
             next_sequence_recv: domain_msg.next_seq_recv_on_b.into(),
             signer: domain_msg.signer.to_string(),
+            counterparty_upgrade_sequence: 0,
         }
     }
 }
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 7367caa48..05d64428b 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -8,7 +8,8 @@ use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::core::channel::v1::query_server::Query as ChannelQuery;
 use ibc_proto::ibc::core::channel::v1::{
     QueryChannelClientStateRequest, QueryChannelClientStateResponse,
-    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
+    QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse,
+    QueryChannelParamsRequest, QueryChannelParamsResponse, QueryChannelRequest,
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
     QueryConnectionChannelsRequest, QueryConnectionChannelsResponse,
     QueryNextSequenceReceiveRequest, QueryNextSequenceReceiveResponse,
@@ -18,6 +19,7 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryPacketCommitmentResponse, QueryPacketCommitmentsRequest, QueryPacketCommitmentsResponse,
     QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
     QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
+    QueryUpgradeErrorRequest, QueryUpgradeErrorResponse, QueryUpgradeRequest, QueryUpgradeResponse,
 };
 use tonic::{Request, Response, Status};
 
@@ -188,4 +190,31 @@ where
 
         Ok(Response::new(response))
     }
+
+    async fn upgrade_error(
+        &self,
+        _request: Request<QueryUpgradeErrorRequest>,
+    ) -> Result<Response<QueryUpgradeErrorResponse>, Status> {
+        Err(Status::unimplemented(
+            "Querying UpgradeError is not supported yet",
+        ))
+    }
+
+    async fn upgrade(
+        &self,
+        _request: Request<QueryUpgradeRequest>,
+    ) -> Result<Response<QueryUpgradeResponse>, Status> {
+        Err(Status::unimplemented(
+            "Querying Upgrade is not supported yet",
+        ))
+    }
+
+    async fn channel_params(
+        &self,
+        _request: Request<QueryChannelParamsRequest>,
+    ) -> Result<Response<QueryChannelParamsResponse>, Status> {
+        Err(Status::unimplemented(
+            "Querying ChannelParams is not supported yet",
+        ))
+    }
 }
diff --git a/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
index df833f545..57694974f 100644
--- a/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
+++ b/ibc-testkit/src/fixtures/core/channel/chan_close_confirm.rs
@@ -17,6 +17,7 @@ pub fn dummy_raw_msg_chan_close_confirm(proof_height: u64) -> RawMsgChannelClose
             revision_height: proof_height,
         }),
         signer: dummy_bech32_account(),
+        counterparty_upgrade_sequence: 0,
     }
 }
 
diff --git a/ibc-testkit/src/fixtures/core/channel/mod.rs b/ibc-testkit/src/fixtures/core/channel/mod.rs
index a1375cd72..96834609e 100644
--- a/ibc-testkit/src/fixtures/core/channel/mod.rs
+++ b/ibc-testkit/src/fixtures/core/channel/mod.rs
@@ -48,6 +48,7 @@ pub fn dummy_raw_channel_end(state: i32, channel_id: Option<u64>) -> RawChannel
         counterparty: Some(dummy_raw_counterparty_chan(channel_id)),
         connection_hops: vec![ConnectionId::zero().to_string()],
         version: "".to_string(), // The version is not validated.
+        upgrade_sequence: 0,
     }
 }
 
diff --git a/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
index 42db0e35f..2fc633160 100644
--- a/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
+++ b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
@@ -17,6 +17,7 @@ pub fn dummy_raw_msg_timeout_on_close(height: u64, timeout_timestamp: u64) -> Ra
         }),
         next_sequence_recv: 1,
         signer: dummy_bech32_account(),
+        counterparty_upgrade_sequence: 0,
     }
 }
 
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 89645d1b5..2b597b1e1 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -18,9 +18,7 @@ use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client
 use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use crate::testapp::ibc::clients::mock::header::{MockHeader, MOCK_HEADER_TYPE_URL};
 use crate::testapp::ibc::clients::mock::misbehaviour::{Misbehaviour, MOCK_MISBEHAVIOUR_TYPE_URL};
-use crate::testapp::ibc::clients::mock::proto::{
-    ClientState as RawMockClientState, Header as RawMockHeader,
-};
+use crate::testapp::ibc::clients::mock::proto::ClientState as RawMockClientState;
 
 pub const MOCK_CLIENT_STATE_TYPE_URL: &str = "/ibc.mock.ClientState";
 pub const MOCK_CLIENT_TYPE: &str = "9999-mock";
@@ -35,14 +33,16 @@ pub fn client_type() -> ClientType {
 #[derive(Copy, Clone, Debug, PartialEq, Eq)]
 pub struct MockClientState {
     pub header: MockHeader,
-    pub frozen_height: Option<Height>,
+    pub trusting_period: Duration,
+    pub frozen: bool,
 }
 
 impl MockClientState {
     pub fn new(header: MockHeader) -> Self {
         Self {
             header,
-            frozen_height: None,
+            trusting_period: Duration::from_nanos(0),
+            frozen: false,
         }
     }
 
@@ -54,15 +54,29 @@ impl MockClientState {
         None
     }
 
-    pub fn with_frozen_height(self, frozen_height: Height) -> Self {
+    pub fn with_trusting_period(self, trusting_period: Duration) -> Self {
+        Self {
+            trusting_period,
+            ..self
+        }
+    }
+
+    pub fn frozen(self) -> Self {
         Self {
-            frozen_height: Some(frozen_height),
+            frozen: true,
+            ..self
+        }
+    }
+
+    pub fn unfrozen(self) -> Self {
+        Self {
+            frozen: false,
             ..self
         }
     }
 
     pub fn is_frozen(&self) -> bool {
-        self.frozen_height.is_some()
+        self.frozen
     }
 
     fn expired(&self, _elapsed: Duration) -> bool {
@@ -76,17 +90,29 @@ impl TryFrom<RawMockClientState> for MockClientState {
     type Error = ClientError;
 
     fn try_from(raw: RawMockClientState) -> Result<Self, Self::Error> {
-        Ok(Self::new(raw.header.expect("Never fails").try_into()?))
+        Ok(Self {
+            header: raw
+                .header
+                .ok_or(ClientError::Other {
+                    description: "header is not present".into(),
+                })?
+                .try_into()?,
+            trusting_period: Duration::from_nanos(raw.trusting_period),
+            frozen: raw.frozen,
+        })
     }
 }
 
 impl From<MockClientState> for RawMockClientState {
     fn from(value: MockClientState) -> Self {
         RawMockClientState {
-            header: Some(RawMockHeader {
-                height: Some(value.header.height().into()),
-                timestamp: value.header.timestamp.nanoseconds(),
-            }),
+            header: Some(value.header.into()),
+            trusting_period: value
+                .trusting_period
+                .as_nanos()
+                .try_into()
+                .expect("no error"),
+            frozen: value.frozen,
         }
     }
 }
@@ -354,7 +380,7 @@ where
         client_id: &ClientId,
         _client_message: Any,
     ) -> Result<(), ClientError> {
-        let frozen_client_state = self.with_frozen_height(Height::min(0));
+        let frozen_client_state = self.frozen();
 
         ctx.store_client_state(
             ClientStatePath::new(client_id.clone()),

From bef3683a79b69fe648a86e21fd35a717d94c37ec Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 15 Mar 2024 17:38:46 +0100
Subject: [PATCH 130/182] imp(core): remove `State::Uninitialized` check while
 parsing `ConnectionEnd` (#1126)

* rm check for uninitialized connection end state

* add changelog

* Update .changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* md fmt

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 ...check-for-unitialized-connection-end-state.md |  3 +++
 .../ics03-connection/types/src/connection.rs     | 16 ----------------
 2 files changed, 3 insertions(+), 16 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md

diff --git a/.changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md b/.changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md
new file mode 100644
index 000000000..cf37686ec
--- /dev/null
+++ b/.changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md
@@ -0,0 +1,3 @@
+- [ibc-core-connection] Remove `State::Uninitialized` check while parsing
+  `ConnectionEnd` from Protobuf
+  ([\#1123](https://github.com/cosmos/ibc-rs/issues/1123))
diff --git a/ibc-core/ics03-connection/types/src/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
index 8225763a4..a1bfb2670 100644
--- a/ibc-core/ics03-connection/types/src/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -1,7 +1,6 @@
 //! Defines the types that define a connection
 
 use core::fmt::{Display, Error as FmtError, Formatter};
-use core::str::FromStr;
 use core::time::Duration;
 use core::u64;
 
@@ -9,7 +8,6 @@ use ibc_core_client_types::error::ClientError;
 use ibc_core_commitment_types::commitment::CommitmentPrefix;
 use ibc_core_host_types::identifiers::{ClientId, ConnectionId};
 use ibc_primitives::prelude::*;
-use ibc_primitives::ZERO_DURATION;
 use ibc_proto::ibc::core::connection::v1::{
     ConnectionEnd as RawConnectionEnd, Counterparty as RawCounterparty,
     IdentifiedConnection as RawIdentifiedConnection,
@@ -208,20 +206,6 @@ impl TryFrom<RawConnectionEnd> for ConnectionEnd {
     fn try_from(value: RawConnectionEnd) -> Result<Self, Self::Error> {
         let state = value.state.try_into()?;
 
-        if state == State::Uninitialized {
-            return ConnectionEnd::new(
-                State::Uninitialized,
-                ClientId::from_str("07-tendermint-0").expect("should not fail"),
-                Counterparty::new(
-                    ClientId::from_str("07-tendermint-0").expect("should not fail"),
-                    None,
-                    CommitmentPrefix::empty(),
-                ),
-                Vec::new(),
-                ZERO_DURATION,
-            );
-        }
-
         if value.client_id.is_empty() {
             return Err(ConnectionError::EmptyProtoConnectionEnd);
         }

From d773a23aea09bae6cccb7c185db2c4101c090097 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 18 Mar 2024 07:52:49 -0700
Subject: [PATCH 131/182] feat(ibc-query): define request/response domain types
 (#1129)

* feat: Add domain definitions for request/response query types in ibc-query

* chore: add unclog

* feat: define serde & schema features

* fix: derive missing schemars

* docs: add remarks to README + additional unclog

* chore: some clean-ups

* chore: organize orders

* feat: add TryFrom for response types

* use invalid_argument error code

* rm redudant lint relaxing

* use proof_not_found method

* consistent QueryError enum structure

* Update ibc-query/README.md

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* clippy::match_bool

* clippy::use_self

* clippy::or_fun_call

* use if-let-some over match

* clippy::redundant_closure_for_method_calls

* Into::into over T::from

* clippy::uninlined_format_args

* clippy::cast_lossless

* clippy::impl_trait_in_params

* clippy::shadow_reuse

* clippy::pattern_type_mismatch

* safe use of u64::MAX

* then over then_some

* rename IntoProto to IntoResponse

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 ...erive-schemars-on-some-ibc-core-structs.md |   3 +
 ...128-domain-request-response-query-types.md |   3 +
 ibc-core/ics02-client/types/src/status.rs     |  23 +-
 .../ics03-connection/types/src/connection.rs  |   3 +
 ibc-core/ics04-channel/types/src/channel.rs   |   4 +
 .../ics04-channel/types/src/commitment.rs     |   2 +
 ibc-query/Cargo.toml                          |  28 +-
 ibc-query/README.md                           |  34 +-
 ibc-query/src/core/channel/mod.rs             |   2 +
 ibc-query/src/core/channel/query.rs           | 318 +++-----
 ibc-query/src/core/channel/service.rs         |  60 +-
 ibc-query/src/core/channel/types/mod.rs       |   5 +
 ibc-query/src/core/channel/types/request.rs   | 410 ++++++++++
 ibc-query/src/core/channel/types/response.rs  | 738 ++++++++++++++++++
 ibc-query/src/core/client/mod.rs              |   2 +
 ibc-query/src/core/client/query.rs            | 141 ++--
 ibc-query/src/core/client/service.rs          |  35 +-
 ibc-query/src/core/client/types/mod.rs        |   5 +
 ibc-query/src/core/client/types/request.rs    | 229 ++++++
 ibc-query/src/core/client/types/response.rs   | 508 ++++++++++++
 ibc-query/src/core/connection/mod.rs          |   2 +
 ibc-query/src/core/connection/query.rs        | 128 ++-
 ibc-query/src/core/connection/service.rs      |  44 +-
 ibc-query/src/core/connection/types/mod.rs    |   5 +
 .../src/core/connection/types/request.rs      | 161 ++++
 .../src/core/connection/types/response.rs     | 336 ++++++++
 ibc-query/src/error.rs                        |  52 +-
 ibc-query/src/lib.rs                          |   5 +
 ibc-query/src/types.rs                        |  94 +++
 ibc-query/src/utils.rs                        |  40 +
 30 files changed, 2965 insertions(+), 455 deletions(-)
 create mode 100644 .changelog/v0.50.0/features/1128-derive-schemars-on-some-ibc-core-structs.md
 create mode 100644 .changelog/v0.50.0/features/1128-domain-request-response-query-types.md
 create mode 100644 ibc-query/src/core/channel/types/mod.rs
 create mode 100644 ibc-query/src/core/channel/types/request.rs
 create mode 100644 ibc-query/src/core/channel/types/response.rs
 create mode 100644 ibc-query/src/core/client/types/mod.rs
 create mode 100644 ibc-query/src/core/client/types/request.rs
 create mode 100644 ibc-query/src/core/client/types/response.rs
 create mode 100644 ibc-query/src/core/connection/types/mod.rs
 create mode 100644 ibc-query/src/core/connection/types/request.rs
 create mode 100644 ibc-query/src/core/connection/types/response.rs
 create mode 100644 ibc-query/src/types.rs
 create mode 100644 ibc-query/src/utils.rs

diff --git a/.changelog/v0.50.0/features/1128-derive-schemars-on-some-ibc-core-structs.md b/.changelog/v0.50.0/features/1128-derive-schemars-on-some-ibc-core-structs.md
new file mode 100644
index 000000000..9c1693c4e
--- /dev/null
+++ b/.changelog/v0.50.0/features/1128-derive-schemars-on-some-ibc-core-structs.md
@@ -0,0 +1,3 @@
+- [ibc-core] Add `schemars` derivation on some more IBC core structs like
+  `Status`, `ConnectionEnd` and `ChannelEnd`
+  ([\#1129](https://github.com/cosmos/ibc-rs/pull/1129))
diff --git a/.changelog/v0.50.0/features/1128-domain-request-response-query-types.md b/.changelog/v0.50.0/features/1128-domain-request-response-query-types.md
new file mode 100644
index 000000000..ca903f850
--- /dev/null
+++ b/.changelog/v0.50.0/features/1128-domain-request-response-query-types.md
@@ -0,0 +1,3 @@
+- [ibc-query] Add domain definitions for request/response query types and their
+  corresponding conversions to/from protos
+  ([\#1128](https://github.com/cosmos/ibc-rs/issues/1128))
diff --git a/ibc-core/ics02-client/types/src/status.rs b/ibc-core/ics02-client/types/src/status.rs
index 9660758f4..1fb931f23 100644
--- a/ibc-core/ics02-client/types/src/status.rs
+++ b/ibc-core/ics02-client/types/src/status.rs
@@ -1,4 +1,7 @@
 use core::fmt::{Debug, Display, Formatter};
+use core::str::FromStr;
+
+use ibc_primitives::prelude::*;
 
 use crate::error::ClientError;
 
@@ -16,7 +19,9 @@ pub enum UpdateKind {
 }
 
 /// Represents the status of a client
-#[derive(Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub enum Status {
     /// The client is active and allowed to be used
     Active,
@@ -55,3 +60,19 @@ impl Display for Status {
         write!(f, "{self:?}")
     }
 }
+
+impl FromStr for Status {
+    type Err = ClientError;
+
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match s {
+            "ACTIVE" => Ok(Status::Active),
+            "FROZEN" => Ok(Status::Frozen),
+            "EXPIRED" => Ok(Status::Expired),
+            "UNAUTHORIZED" => Ok(Status::Unauthorized),
+            _ => Err(ClientError::Other {
+                description: format!("invalid status string: {s}"),
+            }),
+        }
+    }
+}
diff --git a/ibc-core/ics03-connection/types/src/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
index a1bfb2670..444a27548 100644
--- a/ibc-core/ics03-connection/types/src/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -30,6 +30,7 @@ use crate::version::Version;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, Hash)]
 pub struct IdentifiedConnectionEnd {
     pub connection_id: ConnectionId,
@@ -100,6 +101,7 @@ impl From<IdentifiedConnectionEnd> for RawIdentifiedConnection {
     derive(parity_scale_codec::Encode, parity_scale_codec::Decode,)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq, Hash)]
 pub struct ConnectionEnd {
     pub state: State,
@@ -466,6 +468,7 @@ impl Counterparty {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Copy, Clone, Debug, PartialEq, Eq, Hash)]
 pub enum State {
     Uninitialized = 0isize,
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index 81d4fee84..c8350805c 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -29,6 +29,7 @@ use crate::Version;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct IdentifiedChannelEnd {
     pub port_id: PortId,
@@ -107,6 +108,7 @@ impl From<IdentifiedChannelEnd> for RawIdentifiedChannel {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct ChannelEnd {
     pub state: State,
@@ -349,6 +351,7 @@ pub(crate) fn verify_connection_hops_length(
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Counterparty {
     pub port_id: PortId,
@@ -514,6 +517,7 @@ impl FromStr for Order {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Copy, Clone, Debug, PartialEq, Eq)]
 pub enum State {
     Uninitialized = 0isize,
diff --git a/ibc-core/ics04-channel/types/src/commitment.rs b/ibc-core/ics04-channel/types/src/commitment.rs
index dbea7e968..1f1fc464c 100644
--- a/ibc-core/ics04-channel/types/src/commitment.rs
+++ b/ibc-core/ics04-channel/types/src/commitment.rs
@@ -20,6 +20,7 @@ use crate::timeout::TimeoutHeight;
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct PacketCommitment(Vec<u8>);
 
@@ -55,6 +56,7 @@ impl From<Vec<u8>> for PacketCommitment {
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct AcknowledgementCommitment(Vec<u8>);
 
diff --git a/ibc-query/Cargo.toml b/ibc-query/Cargo.toml
index 3f6e4e14f..bf6c0de1d 100644
--- a/ibc-query/Cargo.toml
+++ b/ibc-query/Cargo.toml
@@ -9,19 +9,37 @@ repository   = { workspace = true }
 readme       = "README.md"
 keywords     = ["blockchain", "cosmos", "ibc", "rpc", "grpc"]
 description  = """
-    Maintained by `ibc-rs`, contains essential IBC query methods and
-    gRPC query service implementations for the IBC core.
+    Maintained by `ibc-rs`, contains essential IBC query types, utility functions and
+    gRPC service implementations for the IBC core.
 """
 
 [dependencies]
 # external dependencies
 displaydoc = { version = "0.2", default-features = false }
-tonic = "0.10"
+schemars   = { workspace = true , optional = true }
+serde      = { workspace = true, optional = true }
+tonic      = "0.10"
 
 # ibc dependencies
-ibc = { workspace = true }
+ibc       = { workspace = true }
 ibc-proto = { workspace = true, features = ["server"] }
 
 [features]
 default = ["std"]
-std = ["ibc-proto/std", "ibc/std"]
+std = [
+    "ibc/std",
+    "ibc-proto/std",
+]
+serde = [
+    "dep:serde",
+    "ibc/serde",
+    "ibc-proto/serde",
+]
+schema = [
+    "dep:schemars",
+    "ibc/schema",
+    "ibc-proto/json-schema",
+    "serde",
+    "std",
+]
+
diff --git a/ibc-query/README.md b/ibc-query/README.md
index 80117ebc8..c5a5f684e 100644
--- a/ibc-query/README.md
+++ b/ibc-query/README.md
@@ -1,7 +1,33 @@
 # IBC Query
 
-This crate provides a set of utility traits and implementations for querying the
-state of an [`ibc-rs`](https://github.com/cosmos/ibc-rs) enabled chain.
+## Overview
 
-Implementations contain essential IBC query methods and gRPC query services for
-each of the IBC core client, connection, and channel layers.
+This crate offers a comprehensive set of utility types, traits, and functions
+designed for integrating either a gRPC query server or implementing RPC methods
+in hosts. It specifically facilitates querying the state of the IBC core client,
+connection, and channel layers of a chain enabled with `ibc-rs`.
+
+## Features
+
+- Provides essential utility request/response domain types and their conversions
+to the proto types for efficient integration.
+- Provides convenient query objects with pre-implemented gRPC query services.
+- Offers convenient objects on which query service has been implemented and
+- Includes convenient `QueryContext` and `ProvableContext` traits that extend
+  the capabilities of an implemented IBC module, enabling the retrieval of state
+  from the chain.
+- Derives `serde` and `schema` for all the domain types enabling easy
+  (de)serialization. This feature is particularly beneficial for JSON RPC
+  implementations.
+
+## Remarks
+
+- At present, the Protobuf representation of request types does not include
+  support for querying at a specific height. Consequently, the current state of
+  `ibc-query` allows conversion from protos as a compatible direction but does
+  not support conversion into protos due to the absence of the `query_height`
+  fields.
+
+- Currently `ibc-query` does not support pagination. If pagination is a
+  requirement for your project, please open an issue and provide details about
+  your usage.
diff --git a/ibc-query/src/core/channel/mod.rs b/ibc-query/src/core/channel/mod.rs
index b24e36180..7cdb244ce 100644
--- a/ibc-query/src/core/channel/mod.rs
+++ b/ibc-query/src/core/channel/mod.rs
@@ -1,5 +1,7 @@
 mod query;
 mod service;
+mod types;
 
 pub use query::*;
 pub use service::*;
+pub use types::*;
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index f0e64e80b..ff39fec72 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -1,18 +1,15 @@
 //! Provides utility functions for querying IBC channel states.
 
-use alloc::format;
-use core::str::FromStr;
-
 use ibc::core::client::context::ClientValidationContext;
-use ibc::core::client::types::Height;
-use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
 use ibc::core::host::types::path::{
     AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, Path,
     ReceiptPath, SeqRecvPath, SeqSendPath,
 };
 use ibc::core::host::{ConsensusStateRef, ValidationContext};
+use ibc::primitives::prelude::format;
 use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::channel::v1::{
+
+use super::{
     QueryChannelClientStateRequest, QueryChannelClientStateResponse,
     QueryChannelConsensusStateRequest, QueryChannelConsensusStateResponse, QueryChannelRequest,
     QueryChannelResponse, QueryChannelsRequest, QueryChannelsResponse,
@@ -25,8 +22,7 @@ use ibc_proto::ibc::core::channel::v1::{
     QueryPacketReceiptRequest, QueryPacketReceiptResponse, QueryUnreceivedAcksRequest,
     QueryUnreceivedAcksResponse, QueryUnreceivedPacketsRequest, QueryUnreceivedPacketsResponse,
 };
-use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
-
+use crate::core::client::IdentifiedClientState;
 use crate::core::context::{ProvableContext, QueryContext};
 use crate::error::QueryError;
 
@@ -39,29 +35,24 @@ pub fn query_channel<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
 
     let current_height = ibc_ctx.host_height()?;
     let proof = ibc_ctx
         .get_proof(current_height, &Path::ChannelEnd(channel_end_path.clone()))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Proof not found for channel end path {:?}",
-                channel_end_path
-            ),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for channel end path {channel_end_path:?}"
+            ))
         })?;
 
-    Ok(QueryChannelResponse {
-        channel: Some(channel_end.into()),
+    Ok(QueryChannelResponse::new(
+        channel_end,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all existing IBC channels and returns the corresponding channel ends
@@ -74,12 +65,11 @@ where
 {
     let channel_ends = ibc_ctx.channel_ends()?;
 
-    Ok(QueryChannelsResponse {
-        channels: channel_ends.into_iter().map(Into::into).collect(),
-        height: Some(ibc_ctx.host_height()?.into()),
-        // no support for pagination yet
-        pagination: None,
-    })
+    Ok(QueryChannelsResponse::new(
+        channel_ends,
+        ibc_ctx.host_height()?,
+        None,
+    ))
 }
 
 /// Queries for all channels associated with a given connection
@@ -90,8 +80,6 @@ pub fn query_connection_channels<I>(
 where
     I: QueryContext,
 {
-    let connection_id = ConnectionId::from_str(request.connection.as_str())?;
-
     let all_channel_ends = ibc_ctx.channel_ends()?;
 
     let connection_channel_ends = all_channel_ends
@@ -101,17 +89,16 @@ where
                 .channel_end
                 .connection_hops()
                 .iter()
-                .any(|connection_hop| connection_hop == &connection_id)
+                .any(|connection_hop| connection_hop == &request.connection_id)
         })
         .map(Into::into)
         .collect();
 
-    Ok(QueryConnectionChannelsResponse {
-        channels: connection_channel_ends,
-        height: Some(ibc_ctx.host_height()?.into()),
-        // no support for pagination yet
-        pagination: None,
-    })
+    Ok(QueryConnectionChannelsResponse::new(
+        connection_channel_ends,
+        ibc_ctx.host_height()?,
+        None,
+    ))
 }
 
 /// Queries for the client state associated with a channel by the given channel
@@ -123,11 +110,7 @@ pub fn query_channel_client_state<I>(
 where
     I: QueryContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
 
@@ -135,8 +118,11 @@ where
         .connection_hops()
         .first()
         .map(|connection_id| ibc_ctx.connection_end(connection_id))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Channel {} does not have a connection", channel_id),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Channel {} does not have a connection",
+                request.channel_id
+            ))
         })??;
 
     let client_val_ctx = ibc_ctx.get_client_validation_context();
@@ -150,21 +136,18 @@ where
             current_height,
             &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
                 "Proof not found for client state path: {:?}",
                 connection_end.client_id()
-            ),
+            ))
         })?;
 
-    Ok(QueryChannelClientStateResponse {
-        identified_client_state: Some(IdentifiedClientState {
-            client_id: connection_end.client_id().as_str().into(),
-            client_state: Some(client_state.into()),
-        }),
+    Ok(QueryChannelClientStateResponse::new(
+        IdentifiedClientState::new(connection_end.client_id().clone(), client_state.into()),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the consensus state associated with a channel by the given
@@ -177,13 +160,7 @@ where
     I: QueryContext,
     ConsensusStateRef<I>: Into<Any>,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let height = Height::new(request.revision_number, request.revision_height)?;
-
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
 
@@ -191,14 +168,17 @@ where
         .connection_hops()
         .first()
         .map(|connection_id| ibc_ctx.connection_end(connection_id))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Channel {} does not have a connection", channel_id),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Channel {} does not have a connection",
+                request.channel_id
+            ))
         })??;
 
     let consensus_path = ClientConsensusStatePath::new(
         connection_end.client_id().clone(),
-        height.revision_number(),
-        height.revision_height(),
+        request.consensus_height.revision_number(),
+        request.consensus_height.revision_height(),
     );
     let client_val_ctx = ibc_ctx.get_client_validation_context();
 
@@ -211,19 +191,18 @@ where
             current_height,
             &Path::ClientConsensusState(consensus_path.clone()),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Proof not found for client consensus state path: {:?}",
-                consensus_path
-            ),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for client consensus state path: {consensus_path:?}"
+            ))
         })?;
 
-    Ok(QueryChannelConsensusStateResponse {
-        client_id: connection_end.client_id().as_str().into(),
-        consensus_state: Some(consensus_state.into()),
+    Ok(QueryChannelConsensusStateResponse::new(
+        consensus_state.into(),
+        connection_end.client_id().clone(),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the packet commitment associated with a channel by the given
@@ -235,13 +214,8 @@ pub fn query_packet_commitment<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let sequence = Sequence::from(request.sequence);
-
-    let commitment_path = CommitmentPath::new(&port_id, &channel_id, sequence);
+    let commitment_path =
+        CommitmentPath::new(&request.port_id, &request.channel_id, request.sequence);
 
     let packet_commitment_data = ibc_ctx.get_packet_commitment(&commitment_path)?;
 
@@ -249,18 +223,17 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::Commitment(commitment_path.clone()))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Proof not found for packet commitment path: {:?}",
-                commitment_path
-            ),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for packet commitment path: {commitment_path:?}"
+            ))
         })?;
 
-    Ok(QueryPacketCommitmentResponse {
-        commitment: packet_commitment_data.into_vec(),
+    Ok(QueryPacketCommitmentResponse::new(
+        packet_commitment_data,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all packet commitments associated with a channel
@@ -271,11 +244,7 @@ pub fn query_packet_commitments<I>(
 where
     I: QueryContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let commitments = ibc_ctx
         .packet_commitments(&channel_end_path)?
@@ -283,12 +252,11 @@ where
         .map(Into::into)
         .collect();
 
-    Ok(QueryPacketCommitmentsResponse {
+    Ok(QueryPacketCommitmentsResponse::new(
         commitments,
-        height: Some(ibc_ctx.host_height()?.into()),
-        // no support for pagination yet
-        pagination: None,
-    })
+        ibc_ctx.host_height()?,
+        None,
+    ))
 }
 
 /// Queries for the packet receipt associated with a channel by the given
@@ -300,13 +268,7 @@ pub fn query_packet_receipt<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let sequence = Sequence::from(request.sequence);
-
-    let receipt_path = ReceiptPath::new(&port_id, &channel_id, sequence);
+    let receipt_path = ReceiptPath::new(&request.port_id, &request.channel_id, request.sequence);
 
     // Receipt only has one enum
     // Unreceived packets are not stored
@@ -316,18 +278,17 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::Receipt(receipt_path.clone()))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Proof not found for packet receipt path: {:?}",
-                receipt_path
-            ),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for packet receipt path: {receipt_path:?}"
+            ))
         })?;
 
-    Ok(QueryPacketReceiptResponse {
-        received: packet_receipt_data.is_ok(),
+    Ok(QueryPacketReceiptResponse::new(
+        packet_receipt_data.is_ok(),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the packet acknowledgement associated with a channel by the
@@ -339,13 +300,8 @@ pub fn query_packet_acknowledgement<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let sequence = Sequence::from(request.sequence);
-
-    let acknowledgement_path = AckPath::new(&port_id, &channel_id, sequence);
+    let acknowledgement_path =
+        AckPath::new(&request.port_id, &request.channel_id, request.sequence);
 
     let packet_acknowledgement_data = ibc_ctx.get_packet_acknowledgement(&acknowledgement_path)?;
 
@@ -353,18 +309,17 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::Ack(acknowledgement_path.clone()))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
-                "Proof not found for packet acknowledgement path: {:?}",
-                acknowledgement_path
-            ),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for packet acknowledgement path: {acknowledgement_path:?}"
+            ))
         })?;
 
-    Ok(QueryPacketAcknowledgementResponse {
-        acknowledgement: packet_acknowledgement_data.into_vec(),
+    Ok(QueryPacketAcknowledgementResponse::new(
+        packet_acknowledgement_data,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all packet acknowledgements associated with a channel
@@ -375,17 +330,13 @@ pub fn query_packet_acknowledgements<I>(
 where
     I: QueryContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
     let commitment_sequences = request
         .packet_commitment_sequences
         .iter()
         .copied()
-        .map(Sequence::from);
+        .map(Into::into);
 
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let acknowledgements = ibc_ctx
         .packet_acknowledgements(&channel_end_path, commitment_sequences)?
@@ -393,12 +344,11 @@ where
         .map(Into::into)
         .collect();
 
-    Ok(QueryPacketAcknowledgementsResponse {
+    Ok(QueryPacketAcknowledgementsResponse::new(
         acknowledgements,
-        height: Some(ibc_ctx.host_height()?.into()),
-        // no support for pagination yet
-        pagination: None,
-    })
+        ibc_ctx.host_height()?,
+        None,
+    ))
 }
 
 /// Queries for all unreceived packets associated with a channel
@@ -409,24 +359,20 @@ pub fn query_unreceived_packets<I>(
 where
     I: QueryContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
     let sequences = request
         .packet_commitment_sequences
         .iter()
         .copied()
-        .map(Sequence::from);
+        .map(Into::into);
 
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let unreceived_packets = ibc_ctx.unreceived_packets(&channel_end_path, sequences)?;
 
-    Ok(QueryUnreceivedPacketsResponse {
-        sequences: unreceived_packets.into_iter().map(Into::into).collect(),
-        height: Some(ibc_ctx.host_height()?.into()),
-    })
+    Ok(QueryUnreceivedPacketsResponse::new(
+        unreceived_packets,
+        ibc_ctx.host_height()?,
+    ))
 }
 
 /// Queries for all unreceived acknowledgements associated with a channel
@@ -437,24 +383,16 @@ pub fn query_unreceived_acks<I>(
 where
     I: QueryContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
+    let sequences = request.packet_ack_sequences.iter().copied().map(Into::into);
 
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let sequences = request
-        .packet_ack_sequences
-        .iter()
-        .copied()
-        .map(Sequence::from);
-
-    let channel_end_path = ChannelEndPath::new(&port_id, &channel_id);
+    let channel_end_path = ChannelEndPath::new(&request.port_id, &request.channel_id);
 
     let unreceived_acks = ibc_ctx.unreceived_acks(&channel_end_path, sequences)?;
 
-    Ok(QueryUnreceivedAcksResponse {
-        sequences: unreceived_acks.into_iter().map(Into::into).collect(),
-        height: Some(ibc_ctx.host_height()?.into()),
-    })
+    Ok(QueryUnreceivedAcksResponse::new(
+        unreceived_acks,
+        ibc_ctx.host_height()?,
+    ))
 }
 
 /// Queries for the next sequence to send for the channel specified
@@ -466,11 +404,7 @@ pub fn query_next_sequence_send<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let next_seq_send_path = SeqSendPath::new(&port_id, &channel_id);
+    let next_seq_send_path = SeqSendPath::new(&request.port_id, &request.channel_id);
 
     let next_sequence_send = ibc_ctx.get_next_sequence_send(&next_seq_send_path)?;
 
@@ -478,18 +412,18 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
                 "Next sequence send proof not found for channel {}",
-                channel_id
-            ),
+                request.channel_id
+            ))
         })?;
 
-    Ok(QueryNextSequenceSendResponse {
-        next_sequence_send: next_sequence_send.into(),
+    Ok(QueryNextSequenceSendResponse::new(
+        next_sequence_send,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the next sequence receive associated with a channel
@@ -500,11 +434,7 @@ pub fn query_next_sequence_receive<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let channel_id = ChannelId::from_str(request.channel_id.as_str())?;
-
-    let port_id = PortId::from_str(request.port_id.as_str())?;
-
-    let next_seq_recv_path = SeqRecvPath::new(&port_id, &channel_id);
+    let next_seq_recv_path = SeqRecvPath::new(&request.port_id, &request.channel_id);
 
     let next_sequence_recv = ibc_ctx.get_next_sequence_recv(&next_seq_recv_path)?;
 
@@ -512,16 +442,16 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::SeqRecv(next_seq_recv_path))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
                 "Next sequence receive proof not found for channel {}",
-                channel_id
-            ),
+                request.channel_id
+            ))
         })?;
 
-    Ok(QueryNextSequenceReceiveResponse {
-        next_sequence_receive: next_sequence_recv.into(),
+    Ok(QueryNextSequenceReceiveResponse::new(
+        next_sequence_recv,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 05d64428b..9c4f7fa26 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -31,6 +31,7 @@ use super::{
     query_unreceived_packets,
 };
 use crate::core::context::QueryContext;
+use crate::utils::{IntoDomain, IntoResponse, TryIntoDomain};
 
 // TODO(rano): currently the services don't support pagination, so we return all the results.
 
@@ -66,81 +67,65 @@ where
         &self,
         request: Request<QueryChannelRequest>,
     ) -> Result<Response<QueryChannelResponse>, Status> {
-        let response = query_channel(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_channel(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn channels(
         &self,
         request: Request<QueryChannelsRequest>,
     ) -> Result<Response<QueryChannelsResponse>, Status> {
-        let response = query_channels(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_channels(&self.ibc_context, &request.into_domain())?.into_response()
     }
 
     async fn connection_channels(
         &self,
         request: Request<QueryConnectionChannelsRequest>,
     ) -> Result<Response<QueryConnectionChannelsResponse>, Status> {
-        let response = query_connection_channels(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connection_channels(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn channel_client_state(
         &self,
         request: Request<QueryChannelClientStateRequest>,
     ) -> Result<Response<QueryChannelClientStateResponse>, Status> {
-        let response = query_channel_client_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_channel_client_state(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn channel_consensus_state(
         &self,
         request: Request<QueryChannelConsensusStateRequest>,
     ) -> Result<Response<QueryChannelConsensusStateResponse>, Status> {
-        let response = query_channel_consensus_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_channel_consensus_state(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     async fn packet_commitment(
         &self,
         request: Request<QueryPacketCommitmentRequest>,
     ) -> Result<Response<QueryPacketCommitmentResponse>, Status> {
-        let response = query_packet_commitment(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_packet_commitment(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn packet_commitments(
         &self,
         request: Request<QueryPacketCommitmentsRequest>,
     ) -> Result<Response<QueryPacketCommitmentsResponse>, Status> {
-        let response = query_packet_commitments(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_packet_commitments(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn packet_receipt(
         &self,
         request: Request<QueryPacketReceiptRequest>,
     ) -> Result<Response<QueryPacketReceiptResponse>, Status> {
-        let response = query_packet_receipt(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_packet_receipt(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn packet_acknowledgement(
         &self,
         request: Request<QueryPacketAcknowledgementRequest>,
     ) -> Result<Response<QueryPacketAcknowledgementResponse>, Status> {
-        let response = query_packet_acknowledgement(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_packet_acknowledgement(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     /// Returns all the acknowledgements if sequences is omitted.
@@ -148,9 +133,8 @@ where
         &self,
         request: Request<QueryPacketAcknowledgementsRequest>,
     ) -> Result<Response<QueryPacketAcknowledgementsResponse>, Status> {
-        let response = query_packet_acknowledgements(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_packet_acknowledgements(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     /// Returns all the unreceived packets if sequences is omitted.
@@ -158,9 +142,7 @@ where
         &self,
         request: Request<QueryUnreceivedPacketsRequest>,
     ) -> Result<Response<QueryUnreceivedPacketsResponse>, Status> {
-        let response = query_unreceived_packets(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_unreceived_packets(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     /// Returns all the unreceived acknowledgements if sequences is omitted.
@@ -168,27 +150,21 @@ where
         &self,
         request: Request<QueryUnreceivedAcksRequest>,
     ) -> Result<Response<QueryUnreceivedAcksResponse>, Status> {
-        let response = query_unreceived_acks(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_unreceived_acks(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn next_sequence_receive(
         &self,
         request: Request<QueryNextSequenceReceiveRequest>,
     ) -> Result<Response<QueryNextSequenceReceiveResponse>, Status> {
-        let response = query_next_sequence_receive(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_next_sequence_receive(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn next_sequence_send(
         &self,
         request: Request<QueryNextSequenceSendRequest>,
     ) -> Result<Response<QueryNextSequenceSendResponse>, Status> {
-        let response = query_next_sequence_send(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_next_sequence_send(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn upgrade_error(
diff --git a/ibc-query/src/core/channel/types/mod.rs b/ibc-query/src/core/channel/types/mod.rs
new file mode 100644
index 000000000..b8be6322b
--- /dev/null
+++ b/ibc-query/src/core/channel/types/mod.rs
@@ -0,0 +1,5 @@
+mod request;
+mod response;
+
+pub use request::*;
+pub use response::*;
diff --git a/ibc-query/src/core/channel/types/request.rs b/ibc-query/src/core/channel/types/request.rs
new file mode 100644
index 000000000..d626df5d9
--- /dev/null
+++ b/ibc-query/src/core/channel/types/request.rs
@@ -0,0 +1,410 @@
+//! Contains all the RPC method request domain types and their conversions to
+//! and from the corresponding gRPC proto types for the channel module.
+
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId, Sequence};
+use ibc::primitives::prelude::*;
+use ibc_proto::ibc::core::channel::v1::{
+    QueryChannelClientStateRequest as RawQueryChannelClientStateRequest,
+    QueryChannelConsensusStateRequest as RawQueryChannelConsensusStateRequest,
+    QueryChannelRequest as RawQueryChannelRequest, QueryChannelsRequest as RawQueryChannelsRequest,
+    QueryConnectionChannelsRequest as RawQueryConnectionChannelsRequest,
+    QueryNextSequenceReceiveRequest as RawQueryNextSequenceReceiveRequest,
+    QueryNextSequenceSendRequest as RawQueryNextSequenceSendRequest,
+    QueryPacketAcknowledgementRequest as RawQueryPacketAcknowledgementRequest,
+    QueryPacketAcknowledgementsRequest as RawQueryPacketAcknowledgementsRequest,
+    QueryPacketCommitmentRequest as RawQueryPacketCommitmentRequest,
+    QueryPacketCommitmentsRequest as RawQueryPacketCommitmentsRequest,
+    QueryPacketReceiptRequest as RawQueryPacketReceiptRequest,
+    QueryUnreceivedAcksRequest as RawQueryUnreceivedAcksRequest,
+    QueryUnreceivedPacketsRequest as RawQueryUnreceivedPacketsRequest,
+};
+
+use crate::error::QueryError;
+use crate::types::PageRequest;
+
+/// Defines the RPC method request type for querying a channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryChannelRequest> for QueryChannelRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryChannelRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying all channels
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelsRequest {
+    pub pagination: Option<PageRequest>,
+}
+
+impl From<RawQueryChannelsRequest> for QueryChannelsRequest {
+    fn from(request: RawQueryChannelsRequest) -> Self {
+        Self {
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying all channels associated
+/// with a connection identifier
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionChannelsRequest {
+    pub connection_id: ConnectionId,
+    pub pagination: Option<PageRequest>,
+}
+
+impl TryFrom<RawQueryConnectionChannelsRequest> for QueryConnectionChannelsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConnectionChannelsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_id: request.connection.parse()?,
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the client state associated
+/// with a channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelClientStateRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryChannelClientStateRequest> for QueryChannelClientStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryChannelClientStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the consensus state
+/// associated with a channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelConsensusStateRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub consensus_height: Height,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryChannelConsensusStateRequest> for QueryChannelConsensusStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryChannelConsensusStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            consensus_height: Height::new(request.revision_number, request.revision_height)?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the packet commitment
+/// associated with the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketCommitmentRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub sequence: Sequence,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryPacketCommitmentRequest> for QueryPacketCommitmentRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryPacketCommitmentRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            sequence: request.sequence.into(),
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying all packet commitments
+/// associated with the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketCommitmentsRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub pagination: Option<PageRequest>,
+}
+
+impl TryFrom<RawQueryPacketCommitmentsRequest> for QueryPacketCommitmentsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryPacketCommitmentsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryPacketCommitmentsRequest> for RawQueryPacketCommitmentsRequest {
+    fn from(request: QueryPacketCommitmentsRequest) -> Self {
+        Self {
+            port_id: request.port_id.to_string(),
+            channel_id: request.channel_id.to_string(),
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the packet receipt
+/// associated with the specified channel and sequence number
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketReceiptRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub sequence: Sequence,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryPacketReceiptRequest> for QueryPacketReceiptRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryPacketReceiptRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            sequence: request.sequence.into(),
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the packet acknowledgement
+/// associated with the specified channel and sequence number
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketAcknowledgementRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub sequence: Sequence,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryPacketAcknowledgementRequest> for QueryPacketAcknowledgementRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryPacketAcknowledgementRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            sequence: request.sequence.into(),
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the packet acknowledgements
+/// associated with the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketAcknowledgementsRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub packet_commitment_sequences: Vec<Sequence>,
+    pub pagination: Option<PageRequest>,
+}
+
+impl TryFrom<RawQueryPacketAcknowledgementsRequest> for QueryPacketAcknowledgementsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryPacketAcknowledgementsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            packet_commitment_sequences: request
+                .packet_commitment_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryPacketAcknowledgementsRequest> for RawQueryPacketAcknowledgementsRequest {
+    fn from(request: QueryPacketAcknowledgementsRequest) -> Self {
+        Self {
+            port_id: request.port_id.to_string(),
+            channel_id: request.channel_id.to_string(),
+            packet_commitment_sequences: request
+                .packet_commitment_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the unreceived packets
+/// associated with the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUnreceivedPacketsRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub packet_commitment_sequences: Vec<Sequence>,
+}
+
+impl TryFrom<RawQueryUnreceivedPacketsRequest> for QueryUnreceivedPacketsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryUnreceivedPacketsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            packet_commitment_sequences: request
+                .packet_commitment_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+        })
+    }
+}
+
+impl From<QueryUnreceivedPacketsRequest> for RawQueryUnreceivedPacketsRequest {
+    fn from(request: QueryUnreceivedPacketsRequest) -> Self {
+        Self {
+            port_id: request.port_id.to_string(),
+            channel_id: request.channel_id.to_string(),
+            packet_commitment_sequences: request
+                .packet_commitment_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+        }
+    }
+}
+
+/// gRPC query to fetch the unreceived acknowledgements sequences associated with
+/// the specified channel.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUnreceivedAcksRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub packet_ack_sequences: Vec<Sequence>,
+}
+
+impl TryFrom<RawQueryUnreceivedAcksRequest> for QueryUnreceivedAcksRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryUnreceivedAcksRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            packet_ack_sequences: request
+                .packet_ack_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+        })
+    }
+}
+
+impl From<QueryUnreceivedAcksRequest> for RawQueryUnreceivedAcksRequest {
+    fn from(request: QueryUnreceivedAcksRequest) -> Self {
+        Self {
+            port_id: request.port_id.to_string(),
+            channel_id: request.channel_id.to_string(),
+            packet_ack_sequences: request
+                .packet_ack_sequences
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the next sequence receive
+/// number for the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryNextSequenceReceiveRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryNextSequenceReceiveRequest> for QueryNextSequenceReceiveRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryNextSequenceReceiveRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+/// Defines the RPC method request type for querying the next sequence send
+/// number for the specified channel
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryNextSequenceSendRequest {
+    pub port_id: PortId,
+    pub channel_id: ChannelId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryNextSequenceSendRequest> for QueryNextSequenceSendRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryNextSequenceSendRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            port_id: request.port_id.parse()?,
+            channel_id: request.channel_id.parse()?,
+            query_height: None,
+        })
+    }
+}
diff --git a/ibc-query/src/core/channel/types/response.rs b/ibc-query/src/core/channel/types/response.rs
new file mode 100644
index 000000000..8b4f3aa54
--- /dev/null
+++ b/ibc-query/src/core/channel/types/response.rs
@@ -0,0 +1,738 @@
+//! Contains all the RPC method response domain types and their conversions to
+//! and from the corresponding gRPC proto types for the channel module.
+
+use ibc::core::channel::types::channel::{ChannelEnd, IdentifiedChannelEnd};
+use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
+use ibc::core::channel::types::packet::PacketState;
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::{ClientId, Sequence};
+use ibc::core::primitives::proto::Any;
+use ibc::primitives::prelude::*;
+use ibc::primitives::proto::Protobuf;
+use ibc_proto::ibc::core::channel::v1::{
+    QueryChannelClientStateResponse as RawQueryChannelClientStateResponse,
+    QueryChannelConsensusStateResponse as RawQueryChannelConsensusStateResponse,
+    QueryChannelResponse as RawQueryChannelResponse,
+    QueryChannelsResponse as RawQueryChannelsResponse,
+    QueryConnectionChannelsResponse as RawQueryConnectionChannelsResponse,
+    QueryNextSequenceReceiveResponse as RawQueryNextSequenceReceiveResponse,
+    QueryNextSequenceSendResponse as RawQueryNextSequenceSendResponse,
+    QueryPacketAcknowledgementResponse as RawQueryPacketAcknowledgementResponse,
+    QueryPacketAcknowledgementsResponse as RawQueryPacketAcknowledgementsResponse,
+    QueryPacketCommitmentResponse as RawQueryPacketCommitmentResponse,
+    QueryPacketCommitmentsResponse as RawQueryPacketCommitmentsResponse,
+    QueryPacketReceiptResponse as RawQueryPacketReceiptResponse,
+    QueryUnreceivedAcksResponse as RawQueryUnreceivedAcksResponse,
+    QueryUnreceivedPacketsResponse as RawQueryUnreceivedPacketsResponse,
+};
+
+use crate::core::client::IdentifiedClientState;
+use crate::error::QueryError;
+use crate::types::{PageResponse, Proof};
+
+/// Defines the RPC method response type when querying a channel.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelResponse {
+    pub channel: ChannelEnd,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryChannelResponse {
+    pub fn new(channel: ChannelEnd, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            channel,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryChannelResponse> for QueryChannelResponse {}
+
+impl TryFrom<RawQueryChannelResponse> for QueryChannelResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryChannelResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            channel: value
+                .channel
+                .ok_or_else(|| QueryError::missing_field("channel"))?
+                .try_into()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryChannelResponse> for RawQueryChannelResponse {
+    fn from(response: QueryChannelResponse) -> Self {
+        Self {
+            channel: Some(response.channel.into()),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of channels.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelsResponse {
+    pub channels: Vec<IdentifiedChannelEnd>,
+    pub query_height: Height,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryChannelsResponse {
+    pub fn new(
+        channels: Vec<IdentifiedChannelEnd>,
+        query_height: Height,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            channels,
+            query_height,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryChannelsResponse> for QueryChannelsResponse {}
+
+impl TryFrom<RawQueryChannelsResponse> for QueryChannelsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryChannelsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            channels: value
+                .channels
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            query_height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryChannelsResponse> for RawQueryChannelsResponse {
+    fn from(response: QueryChannelsResponse) -> Self {
+        Self {
+            channels: response.channels.into_iter().map(Into::into).collect(),
+            height: Some(response.query_height.into()),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of channels associated with a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionChannelsResponse {
+    pub channels: Vec<IdentifiedChannelEnd>,
+    pub query_height: Height,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryConnectionChannelsResponse {
+    pub fn new(
+        channels: Vec<IdentifiedChannelEnd>,
+        query_height: Height,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            channels,
+            query_height,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionChannelsResponse> for QueryConnectionChannelsResponse {}
+
+impl TryFrom<RawQueryConnectionChannelsResponse> for QueryConnectionChannelsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionChannelsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            channels: value
+                .channels
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            query_height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConnectionChannelsResponse> for RawQueryConnectionChannelsResponse {
+    fn from(response: QueryConnectionChannelsResponse) -> Self {
+        Self {
+            channels: response.channels.into_iter().map(Into::into).collect(),
+            height: Some(response.query_height.into()),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a channel client state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelClientStateResponse {
+    pub identified_client_state: IdentifiedClientState,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryChannelClientStateResponse {
+    pub fn new(
+        identified_client_state: IdentifiedClientState,
+        proof: Proof,
+        proof_height: Height,
+    ) -> Self {
+        Self {
+            identified_client_state,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryChannelClientStateResponse> for QueryChannelClientStateResponse {}
+
+impl TryFrom<RawQueryChannelClientStateResponse> for QueryChannelClientStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryChannelClientStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            identified_client_state: value
+                .identified_client_state
+                .ok_or_else(|| QueryError::missing_field("identified_client_state"))?
+                .try_into()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryChannelClientStateResponse> for RawQueryChannelClientStateResponse {
+    fn from(response: QueryChannelClientStateResponse) -> Self {
+        Self {
+            identified_client_state: Some(response.identified_client_state.into()),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response when for querying a channel consensus state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryChannelConsensusStateResponse {
+    pub consensus_state: Any,
+    pub client_id: ClientId,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryChannelConsensusStateResponse {
+    pub fn new(
+        consensus_state: Any,
+        client_id: ClientId,
+        proof: Proof,
+        proof_height: Height,
+    ) -> Self {
+        Self {
+            consensus_state,
+            client_id,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryChannelConsensusStateResponse> for QueryChannelConsensusStateResponse {}
+
+impl TryFrom<RawQueryChannelConsensusStateResponse> for QueryChannelConsensusStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryChannelConsensusStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            consensus_state: value
+                .consensus_state
+                .ok_or_else(|| QueryError::missing_field("consensus_state"))?,
+            client_id: value.client_id.parse()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryChannelConsensusStateResponse> for RawQueryChannelConsensusStateResponse {
+    fn from(response: QueryChannelConsensusStateResponse) -> Self {
+        Self {
+            consensus_state: Some(response.consensus_state),
+            client_id: response.client_id.to_string(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a packet commitment.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketCommitmentResponse {
+    pub packet_commitment: PacketCommitment,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryPacketCommitmentResponse {
+    pub fn new(packet_commitment: PacketCommitment, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            packet_commitment,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryPacketCommitmentResponse> for QueryPacketCommitmentResponse {}
+
+impl TryFrom<RawQueryPacketCommitmentResponse> for QueryPacketCommitmentResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryPacketCommitmentResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            packet_commitment: value.commitment.into(),
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryPacketCommitmentResponse> for RawQueryPacketCommitmentResponse {
+    fn from(response: QueryPacketCommitmentResponse) -> Self {
+        Self {
+            commitment: response.packet_commitment.into_vec(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of packet commitments.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketCommitmentsResponse {
+    pub commitments: Vec<PacketState>,
+    pub height: Height,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryPacketCommitmentsResponse {
+    pub fn new(
+        commitments: Vec<PacketState>,
+        height: Height,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            commitments,
+            height,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryPacketCommitmentsResponse> for QueryPacketCommitmentsResponse {}
+
+impl TryFrom<RawQueryPacketCommitmentsResponse> for QueryPacketCommitmentsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryPacketCommitmentsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            commitments: value
+                .commitments
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryPacketCommitmentsResponse> for RawQueryPacketCommitmentsResponse {
+    fn from(response: QueryPacketCommitmentsResponse) -> Self {
+        Self {
+            commitments: response.commitments.into_iter().map(Into::into).collect(),
+            height: Some(response.height.into()),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a packet receipt.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketReceiptResponse {
+    pub received: bool,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryPacketReceiptResponse {
+    pub fn new(received: bool, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            received,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryPacketReceiptResponse> for QueryPacketReceiptResponse {}
+
+impl TryFrom<RawQueryPacketReceiptResponse> for QueryPacketReceiptResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryPacketReceiptResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            received: value.received,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryPacketReceiptResponse> for RawQueryPacketReceiptResponse {
+    fn from(response: QueryPacketReceiptResponse) -> Self {
+        Self {
+            received: response.received,
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a packet acknowledgement.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketAcknowledgementResponse {
+    pub acknowledgement: AcknowledgementCommitment,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryPacketAcknowledgementResponse {
+    pub fn new(
+        acknowledgement: AcknowledgementCommitment,
+        proof: Proof,
+        proof_height: Height,
+    ) -> Self {
+        Self {
+            acknowledgement,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryPacketAcknowledgementResponse> for QueryPacketAcknowledgementResponse {}
+
+impl TryFrom<RawQueryPacketAcknowledgementResponse> for QueryPacketAcknowledgementResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryPacketAcknowledgementResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            acknowledgement: value.acknowledgement.into(),
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryPacketAcknowledgementResponse> for RawQueryPacketAcknowledgementResponse {
+    fn from(response: QueryPacketAcknowledgementResponse) -> Self {
+        Self {
+            acknowledgement: response.acknowledgement.into_vec(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of packet
+/// acknowledgements.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryPacketAcknowledgementsResponse {
+    pub acknowledgements: Vec<PacketState>,
+    pub height: Height,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryPacketAcknowledgementsResponse {
+    pub fn new(
+        acknowledgements: Vec<PacketState>,
+        height: Height,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            acknowledgements,
+            height,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryPacketAcknowledgementsResponse> for QueryPacketAcknowledgementsResponse {}
+
+impl TryFrom<RawQueryPacketAcknowledgementsResponse> for QueryPacketAcknowledgementsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryPacketAcknowledgementsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            acknowledgements: value
+                .acknowledgements
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryPacketAcknowledgementsResponse> for RawQueryPacketAcknowledgementsResponse {
+    fn from(response: QueryPacketAcknowledgementsResponse) -> Self {
+        Self {
+            acknowledgements: response
+                .acknowledgements
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            height: Some(response.height.into()),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of unreceived acks.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUnreceivedAcksResponse {
+    pub sequences: Vec<Sequence>,
+    pub height: Height,
+}
+
+impl QueryUnreceivedAcksResponse {
+    pub fn new(sequences: Vec<Sequence>, height: Height) -> Self {
+        Self { sequences, height }
+    }
+}
+
+impl Protobuf<RawQueryUnreceivedAcksResponse> for QueryUnreceivedAcksResponse {}
+
+impl TryFrom<RawQueryUnreceivedAcksResponse> for QueryUnreceivedAcksResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryUnreceivedAcksResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            sequences: value.sequences.into_iter().map(Into::into).collect(),
+            height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryUnreceivedAcksResponse> for RawQueryUnreceivedAcksResponse {
+    fn from(response: QueryUnreceivedAcksResponse) -> Self {
+        Self {
+            sequences: response.sequences.into_iter().map(Into::into).collect(),
+            height: Some(response.height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying a list of unreceived packets.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUnreceivedPacketsResponse {
+    pub sequences: Vec<Sequence>,
+    pub height: Height,
+}
+
+impl QueryUnreceivedPacketsResponse {
+    pub fn new(sequences: Vec<Sequence>, height: Height) -> Self {
+        Self { sequences, height }
+    }
+}
+
+impl Protobuf<RawQueryUnreceivedPacketsResponse> for QueryUnreceivedPacketsResponse {}
+
+impl TryFrom<RawQueryUnreceivedPacketsResponse> for QueryUnreceivedPacketsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryUnreceivedPacketsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            sequences: value.sequences.into_iter().map(Into::into).collect(),
+            height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryUnreceivedPacketsResponse> for RawQueryUnreceivedPacketsResponse {
+    fn from(response: QueryUnreceivedPacketsResponse) -> Self {
+        Self {
+            sequences: response.sequences.into_iter().map(Into::into).collect(),
+            height: Some(response.height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying the next sequence to be received on a channel.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryNextSequenceReceiveResponse {
+    pub next_sequence_receive: Sequence,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryNextSequenceReceiveResponse {
+    pub fn new(next_sequence_receive: Sequence, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            next_sequence_receive,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryNextSequenceReceiveResponse> for QueryNextSequenceReceiveResponse {}
+
+impl TryFrom<RawQueryNextSequenceReceiveResponse> for QueryNextSequenceReceiveResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryNextSequenceReceiveResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            next_sequence_receive: value.next_sequence_receive.into(),
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryNextSequenceReceiveResponse> for RawQueryNextSequenceReceiveResponse {
+    fn from(response: QueryNextSequenceReceiveResponse) -> Self {
+        Self {
+            next_sequence_receive: response.next_sequence_receive.into(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying the next sequence to be
+/// sent on a channel.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryNextSequenceSendResponse {
+    pub next_sequence_send: Sequence,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryNextSequenceSendResponse {
+    pub fn new(next_sequence_send: Sequence, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            next_sequence_send,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryNextSequenceSendResponse> for QueryNextSequenceSendResponse {}
+
+impl TryFrom<RawQueryNextSequenceSendResponse> for QueryNextSequenceSendResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryNextSequenceSendResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            next_sequence_send: value.next_sequence_send.into(),
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryNextSequenceSendResponse> for RawQueryNextSequenceSendResponse {
+    fn from(response: QueryNextSequenceSendResponse) -> Self {
+        Self {
+            next_sequence_send: response.next_sequence_send.into(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
diff --git a/ibc-query/src/core/client/mod.rs b/ibc-query/src/core/client/mod.rs
index b24e36180..7cdb244ce 100644
--- a/ibc-query/src/core/client/mod.rs
+++ b/ibc-query/src/core/client/mod.rs
@@ -1,5 +1,7 @@
 mod query;
 mod service;
+mod types;
 
 pub use query::*;
 pub use service::*;
+pub use types::*;
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index e92d320af..52ce7d5b1 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -1,29 +1,26 @@
 //! Provides utility functions for querying IBC client states.
 
-use alloc::format;
-use core::str::FromStr;
-
 use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::error::ClientError;
-use ibc::core::client::types::Height;
-use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::types::path::{
     ClientConsensusStatePath, ClientStatePath, Path, UpgradeClientPath,
 };
 use ibc::core::host::{ConsensusStateRef, ValidationContext};
 use ibc::cosmos_host::upgrade_proposal::{UpgradeValidationContext, UpgradedConsensusStateRef};
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::client::v1::{
-    ConsensusStateWithHeight, IdentifiedClientState, QueryClientStateRequest,
-    QueryClientStateResponse, QueryClientStatesRequest, QueryClientStatesResponse,
-    QueryClientStatusRequest, QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
+use ibc::primitives::prelude::format;
+use ibc::primitives::proto::Any;
+
+use super::{
+    ConsensusStateWithHeight, IdentifiedClientState, QueryClientStateResponse,
+    QueryClientStatesRequest, QueryClientStatesResponse, QueryClientStatusRequest,
+    QueryClientStatusResponse, QueryConsensusStateHeightsRequest,
     QueryConsensusStateHeightsResponse, QueryConsensusStateRequest, QueryConsensusStateResponse,
     QueryConsensusStatesRequest, QueryConsensusStatesResponse, QueryUpgradedClientStateRequest,
     QueryUpgradedClientStateResponse, QueryUpgradedConsensusStateRequest,
     QueryUpgradedConsensusStateResponse,
 };
-
+use crate::core::client::QueryClientStateRequest;
 use crate::core::context::QueryContext;
 use crate::error::QueryError;
 
@@ -35,7 +32,7 @@ pub fn query_client_state<I>(
 where
     I: QueryContext,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
+    let client_id = request.client_id.clone();
 
     let client_val_ctx = ibc_ctx.get_client_validation_context();
 
@@ -48,15 +45,17 @@ where
             current_height,
             &Path::ClientState(ClientStatePath::new(client_id.clone())),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Proof not found for client state path: {client_id:?}"),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for client state path: {client_id:?}"
+            ))
         })?;
 
-    Ok(QueryClientStateResponse {
-        client_state: Some(client_state.into()),
+    Ok(QueryClientStateResponse::new(
+        client_state.into(),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all the existing client states.
@@ -69,17 +68,14 @@ where
 {
     let client_states = ibc_ctx.client_states()?;
 
-    Ok(QueryClientStatesResponse {
-        client_states: client_states
+    Ok(QueryClientStatesResponse::new(
+        client_states
             .into_iter()
-            .map(|(id, state)| IdentifiedClientState {
-                client_id: id.into(),
-                client_state: Some(state.into()),
-            })
+            .map(|(id, state)| IdentifiedClientState::new(id, state.into()))
             .collect(),
         // no support for pagination yet
-        pagination: None,
-    })
+        None,
+    ))
 }
 
 /// Queries for the consensus state of a given client id and height.
@@ -91,19 +87,9 @@ where
     I: QueryContext,
     ConsensusStateRef<I>: Into<Any>,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
-
-    let (height, consensus_state) = if request.latest_height {
-        ibc_ctx
-            .consensus_states(&client_id)?
-            .into_iter()
-            .max_by_key(|(h, _)| *h)
-            .ok_or(QueryError::ProofNotFound {
-                description: format!("No consensus state found for client: {client_id:?}"),
-            })?
-    } else {
-        let height = Height::new(request.revision_number, request.revision_height)?;
+    let client_id = request.client_id.clone();
 
+    let (height, consensus_state) = if let Some(height) = request.consensus_height {
         let client_val_ctx = ibc_ctx.get_client_validation_context();
 
         let consensus_state = client_val_ctx.consensus_state(&ClientConsensusStatePath::new(
@@ -113,6 +99,16 @@ where
         ))?;
 
         (height, consensus_state)
+    } else {
+        ibc_ctx
+            .consensus_states(&client_id)?
+            .into_iter()
+            .max_by_key(|&(h, _)| h)
+            .ok_or_else(|| {
+                QueryError::proof_not_found(format!(
+                    "No consensus state found for client: {client_id:?}"
+                ))
+            })?
     };
 
     let current_height = ibc_ctx.host_height()?;
@@ -126,15 +122,17 @@ where
                 height.revision_height(),
             )),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Proof not found for consensus state path: {client_id:?}"),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for consensus state path: {client_id:?}"
+            ))
         })?;
 
-    Ok(QueryConsensusStateResponse {
-        consensus_state: Some(consensus_state.into()),
+    Ok(QueryConsensusStateResponse::new(
+        consensus_state.into(),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all the consensus states of a given client id.
@@ -146,21 +144,16 @@ where
     I: QueryContext,
     ConsensusStateRef<I>: Into<Any>,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
-
-    let consensus_states = ibc_ctx.consensus_states(&client_id)?;
+    let consensus_states = ibc_ctx.consensus_states(&request.client_id)?;
 
-    Ok(QueryConsensusStatesResponse {
-        consensus_states: consensus_states
+    Ok(QueryConsensusStatesResponse::new(
+        consensus_states
             .into_iter()
-            .map(|(height, state)| ConsensusStateWithHeight {
-                height: Some(height.into()),
-                consensus_state: Some(state.into()),
-            })
+            .map(|(height, state)| ConsensusStateWithHeight::new(height, state.into()))
             .collect(),
-        // no support for pagination yet
-        pagination: None,
-    })
+        // no support for pagination yet,
+        None,
+    ))
 }
 
 /// Queries for the heights of all the consensus states of a given client id.
@@ -171,18 +164,13 @@ pub fn query_consensus_state_heights<I>(
 where
     I: QueryContext,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
-
-    let consensus_state_heights = ibc_ctx.consensus_state_heights(&client_id)?;
+    let consensus_state_heights = ibc_ctx.consensus_state_heights(&request.client_id)?;
 
-    Ok(QueryConsensusStateHeightsResponse {
-        consensus_state_heights: consensus_state_heights
-            .into_iter()
-            .map(Into::into)
-            .collect(),
+    Ok(QueryConsensusStateHeightsResponse::new(
+        consensus_state_heights,
         // no support for pagination yet
-        pagination: None,
-    })
+        None,
+    ))
 }
 
 /// Queries for the status (Active, Frozen, Expired, Unauthorized) of a given client.
@@ -193,15 +181,12 @@ pub fn query_client_status<I>(
 where
     I: ValidationContext,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
     let client_val_ctx = ibc_ctx.get_client_validation_context();
-    let client_state = client_val_ctx.client_state(&client_id)?;
+    let client_state = client_val_ctx.client_state(&request.client_id)?;
     let client_validation_ctx = ibc_ctx.get_client_validation_context();
-    let client_status = client_state.status(client_validation_ctx, &client_id)?;
+    let client_status = client_state.status(client_validation_ctx, &request.client_id)?;
 
-    Ok(QueryClientStatusResponse {
-        status: format!("{client_status}"),
-    })
+    Ok(QueryClientStatusResponse::new(client_status))
 }
 
 /// Queries for the upgraded client state.
@@ -220,9 +205,9 @@ where
         .upgraded_client_state(&upgraded_client_state_path)
         .map_err(ClientError::from)?;
 
-    Ok(QueryUpgradedClientStateResponse {
-        upgraded_client_state: Some(upgraded_client_state.into()),
-    })
+    Ok(QueryUpgradedClientStateResponse::new(
+        upgraded_client_state.into(),
+    ))
 }
 
 /// Queries for the upgraded consensus state.
@@ -243,7 +228,7 @@ where
         .upgraded_consensus_state(&upgraded_consensus_state_path)
         .map_err(ClientError::from)?;
 
-    Ok(QueryUpgradedConsensusStateResponse {
-        upgraded_consensus_state: Some(upgraded_consensus_state.into()),
-    })
+    Ok(QueryUpgradedConsensusStateResponse::new(
+        upgraded_consensus_state.into(),
+    ))
 }
diff --git a/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
index a1a7d7d32..b5bd21d1e 100644
--- a/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -26,6 +26,7 @@ use super::{
     query_upgraded_consensus_state,
 };
 use crate::core::context::QueryContext;
+use crate::utils::{IntoDomain, IntoResponse, TryIntoDomain};
 
 // TODO(rano): currently the services don't support pagination, so we return all the results.
 
@@ -71,54 +72,43 @@ where
         &self,
         request: Request<QueryClientStateRequest>,
     ) -> Result<Response<QueryClientStateResponse>, Status> {
-        let response = query_client_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_client_state(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn client_states(
         &self,
         request: Request<QueryClientStatesRequest>,
     ) -> Result<Response<QueryClientStatesResponse>, Status> {
-        let response = query_client_states(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_client_states(&self.ibc_context, &request.into_domain())?.into_response()
     }
 
     async fn consensus_state(
         &self,
         request: Request<QueryConsensusStateRequest>,
     ) -> Result<Response<QueryConsensusStateResponse>, Status> {
-        let response = query_consensus_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_consensus_state(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn consensus_states(
         &self,
         request: Request<QueryConsensusStatesRequest>,
     ) -> Result<Response<QueryConsensusStatesResponse>, Status> {
-        let response = query_consensus_states(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_consensus_states(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn consensus_state_heights(
         &self,
         request: Request<QueryConsensusStateHeightsRequest>,
     ) -> Result<Response<QueryConsensusStateHeightsResponse>, Status> {
-        let response = query_consensus_state_heights(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_consensus_state_heights(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     async fn client_status(
         &self,
         request: Request<QueryClientStatusRequest>,
     ) -> Result<Response<QueryClientStatusResponse>, Status> {
-        let response = query_client_status(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_client_status(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn client_params(
@@ -134,17 +124,14 @@ where
         &self,
         request: Request<QueryUpgradedClientStateRequest>,
     ) -> Result<Response<QueryUpgradedClientStateResponse>, Status> {
-        let response = query_upgraded_client_state(&self.upgrade_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_upgraded_client_state(&self.upgrade_context, &request.into_domain())?.into_response()
     }
 
     async fn upgraded_consensus_state(
         &self,
         request: Request<QueryUpgradedConsensusStateRequest>,
     ) -> Result<Response<QueryUpgradedConsensusStateResponse>, Status> {
-        let response = query_upgraded_consensus_state(&self.upgrade_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_upgraded_consensus_state(&self.upgrade_context, &request.into_domain())?
+            .into_response()
     }
 }
diff --git a/ibc-query/src/core/client/types/mod.rs b/ibc-query/src/core/client/types/mod.rs
new file mode 100644
index 000000000..b8be6322b
--- /dev/null
+++ b/ibc-query/src/core/client/types/mod.rs
@@ -0,0 +1,5 @@
+mod request;
+mod response;
+
+pub use request::*;
+pub use response::*;
diff --git a/ibc-query/src/core/client/types/request.rs b/ibc-query/src/core/client/types/request.rs
new file mode 100644
index 000000000..ffb9d6170
--- /dev/null
+++ b/ibc-query/src/core/client/types/request.rs
@@ -0,0 +1,229 @@
+//! Contains all the RPC method request domain types and their conversions to
+//! and from the corresponding gRPC proto types for the client module.
+
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::primitives::prelude::*;
+use ibc_proto::ibc::core::client::v1::{
+    QueryClientParamsRequest as RawQueryClientParamsRequest,
+    QueryClientStateRequest as RawQueryClientStateRequest,
+    QueryClientStatesRequest as RawQueryClientStatesRequest,
+    QueryClientStatusRequest as RawQueryClientStatusRequest,
+    QueryConsensusStateHeightsRequest as RawQueryConsensusStateHeightsRequest,
+    QueryConsensusStateRequest as RawQueryConsensusStateRequest,
+    QueryConsensusStatesRequest as RawQueryConsensusStatesRequest,
+    QueryUpgradedClientStateRequest as RawUpgradedClientStateRequest,
+    QueryUpgradedConsensusStateRequest as RawUpgradedConsensusStateRequest,
+};
+use ibc_proto::Protobuf;
+
+use crate::error::QueryError;
+use crate::types::PageRequest;
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStateRequest {
+    /// The client identifier.
+    pub client_id: ClientId,
+    /// The height at which to query the client state. If not provided, the
+    /// latest height should be used.
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryClientStateRequest> for QueryClientStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryClientStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying all client states.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStatesRequest {
+    pub pagination: Option<PageRequest>,
+}
+
+impl From<RawQueryClientStatesRequest> for QueryClientStatesRequest {
+    fn from(request: RawQueryClientStatesRequest) -> Self {
+        Self {
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the consensus state of a
+/// client.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStateRequest {
+    /// The client identifier.
+    pub client_id: ClientId,
+    /// The consensus state height to be queried. If not provided, the latest
+    /// height
+    pub consensus_height: Option<Height>,
+    /// The height at which to query the consensus state. If not provided, the
+    /// latest height should be used.
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryConsensusStateRequest> for QueryConsensusStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConsensusStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+            consensus_height: (!request.latest_height)
+                .then(|| Height::new(request.revision_number, request.revision_height))
+                .transpose()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying all consensus states.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStatesRequest {
+    pub client_id: ClientId,
+    pub pagination: Option<PageRequest>,
+}
+
+impl Protobuf<RawQueryConsensusStatesRequest> for QueryConsensusStatesRequest {}
+
+impl TryFrom<RawQueryConsensusStatesRequest> for QueryConsensusStatesRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConsensusStatesRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConsensusStatesRequest> for RawQueryConsensusStatesRequest {
+    fn from(request: QueryConsensusStatesRequest) -> Self {
+        Self {
+            client_id: request.client_id.to_string(),
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the consensus state
+/// heights.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStateHeightsRequest {
+    pub client_id: ClientId,
+    pub pagination: Option<PageRequest>,
+}
+
+impl Protobuf<RawQueryConsensusStateHeightsRequest> for QueryConsensusStateHeightsRequest {}
+
+impl TryFrom<RawQueryConsensusStateHeightsRequest> for QueryConsensusStateHeightsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConsensusStateHeightsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConsensusStateHeightsRequest> for RawQueryConsensusStateHeightsRequest {
+    fn from(request: QueryConsensusStateHeightsRequest) -> Self {
+        Self {
+            client_id: request.client_id.to_string(),
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the host consensus state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryHostConsensusStateRequest {
+    pub query_height: Option<Height>,
+}
+
+/// Defines the RPC method request type for querying the status of a client.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStatusRequest {
+    pub client_id: ClientId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryClientStatusRequest> for QueryClientStatusRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryClientStatusRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the parameters of a client.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientParamsRequest {
+    pub query_height: Option<Height>,
+}
+
+impl From<RawQueryClientParamsRequest> for QueryClientParamsRequest {
+    fn from(_request: RawQueryClientParamsRequest) -> Self {
+        Self { query_height: None }
+    }
+}
+
+/// Defines the RPC method request type for querying the upgraded client state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUpgradedClientStateRequest {
+    /// Height at which the chain is scheduled to halt for upgrade
+    pub upgrade_height: Option<Height>,
+}
+
+impl From<RawUpgradedClientStateRequest> for QueryUpgradedClientStateRequest {
+    fn from(_request: RawUpgradedClientStateRequest) -> Self {
+        Self {
+            upgrade_height: None,
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying the upgraded consensus
+/// state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUpgradedConsensusStateRequest {
+    /// Height at which the chain is scheduled to halt for upgrade.
+    pub upgrade_height: Option<Height>,
+}
+
+impl From<RawUpgradedConsensusStateRequest> for QueryUpgradedConsensusStateRequest {
+    fn from(_request: RawUpgradedConsensusStateRequest) -> Self {
+        Self {
+            upgrade_height: None,
+        }
+    }
+}
diff --git a/ibc-query/src/core/client/types/response.rs b/ibc-query/src/core/client/types/response.rs
new file mode 100644
index 000000000..587fe2127
--- /dev/null
+++ b/ibc-query/src/core/client/types/response.rs
@@ -0,0 +1,508 @@
+//! Contains all the RPC method response domain types and their conversions to
+//! and from the corresponding gRPC proto types for the client module.
+
+use ibc::core::client::types::{Height, Status};
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::primitives::proto::Any;
+use ibc::primitives::prelude::*;
+use ibc::primitives::proto::Protobuf;
+use ibc_proto::ibc::core::client::v1::{
+    ConsensusStateWithHeight as RawConsensusStateWithHeight,
+    IdentifiedClientState as RawIdentifiedClientState, Params as RawParams,
+    QueryClientParamsResponse as RawQueryClientParamsResponse,
+    QueryClientStateResponse as RawQueryClientStateResponse,
+    QueryClientStatesResponse as RawQueryClientStatesResponse,
+    QueryClientStatusResponse as RawQueryClientStatusResponse,
+    QueryConsensusStateHeightsResponse as RawQueryConsensusStateHeightsResponse,
+    QueryConsensusStateResponse as RawQueryConsensusStateResponse,
+    QueryConsensusStatesResponse as RawQueryConsensusStatesResponse,
+    QueryUpgradedClientStateResponse as RawQueryUpgradedClientStateResponse,
+    QueryUpgradedConsensusStateResponse as RawQueryUpgradedConsensusStateResponse,
+};
+
+use crate::error::QueryError;
+use crate::types::{PageResponse, Proof};
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStateResponse {
+    /// The client identifier.
+    pub client_state: Any,
+    /// The proof that the client state was retrieved.
+    pub proof: Proof,
+    /// The height at which the client state was retrieved.
+    pub proof_height: Height,
+}
+
+impl QueryClientStateResponse {
+    pub fn new(client_state: Any, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            client_state,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryClientStateResponse> for QueryClientStateResponse {}
+
+impl TryFrom<RawQueryClientStateResponse> for QueryClientStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryClientStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_state: value
+                .client_state
+                .ok_or_else(|| QueryError::missing_field("client_state"))?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryClientStateResponse> for RawQueryClientStateResponse {
+    fn from(response: QueryClientStateResponse) -> Self {
+        Self {
+            client_state: Some(response.client_state),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStatesResponse {
+    pub client_states: Vec<IdentifiedClientState>,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryClientStatesResponse {
+    pub fn new(
+        client_states: Vec<IdentifiedClientState>,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            client_states,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryClientStatesResponse> for QueryClientStatesResponse {}
+
+impl TryFrom<RawQueryClientStatesResponse> for QueryClientStatesResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryClientStatesResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_states: value
+                .client_states
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryClientStatesResponse> for RawQueryClientStatesResponse {
+    fn from(response: QueryClientStatesResponse) -> Self {
+        Self {
+            client_states: response.client_states.into_iter().map(Into::into).collect(),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct IdentifiedClientState {
+    pub client_id: ClientId,
+    pub client_state: Any,
+}
+
+impl IdentifiedClientState {
+    pub fn new(client_id: ClientId, client_state: Any) -> Self {
+        Self {
+            client_id,
+            client_state,
+        }
+    }
+}
+
+impl Protobuf<RawIdentifiedClientState> for IdentifiedClientState {}
+
+impl TryFrom<RawIdentifiedClientState> for IdentifiedClientState {
+    type Error = QueryError;
+
+    fn try_from(value: RawIdentifiedClientState) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: value.client_id.parse()?,
+            client_state: value
+                .client_state
+                .ok_or_else(|| QueryError::missing_field("client_state"))?,
+        })
+    }
+}
+
+impl From<IdentifiedClientState> for RawIdentifiedClientState {
+    fn from(ics: IdentifiedClientState) -> Self {
+        Self {
+            client_id: ics.client_id.to_string(),
+            client_state: Some(ics.client_state),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStateResponse {
+    consensus_state: Any,
+    proof: Proof,
+    proof_height: Height,
+}
+
+impl QueryConsensusStateResponse {
+    pub fn new(consensus_state: Any, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            consensus_state,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConsensusStateResponse> for QueryConsensusStateResponse {}
+
+impl TryFrom<RawQueryConsensusStateResponse> for QueryConsensusStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConsensusStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            consensus_state: value
+                .consensus_state
+                .ok_or_else(|| QueryError::missing_field("consensus_state"))?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryConsensusStateResponse> for RawQueryConsensusStateResponse {
+    fn from(response: QueryConsensusStateResponse) -> Self {
+        Self {
+            consensus_state: Some(response.consensus_state),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct ConsensusStateWithHeight {
+    height: Height,
+    consensus_state: Any,
+}
+
+impl ConsensusStateWithHeight {
+    pub fn new(height: Height, consensus_state: Any) -> Self {
+        Self {
+            height,
+            consensus_state,
+        }
+    }
+}
+
+impl Protobuf<RawConsensusStateWithHeight> for ConsensusStateWithHeight {}
+
+impl TryFrom<RawConsensusStateWithHeight> for ConsensusStateWithHeight {
+    type Error = QueryError;
+
+    fn try_from(value: RawConsensusStateWithHeight) -> Result<Self, Self::Error> {
+        Ok(Self {
+            height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            consensus_state: value
+                .consensus_state
+                .ok_or_else(|| QueryError::missing_field("consensus_state"))?,
+        })
+    }
+}
+
+impl From<ConsensusStateWithHeight> for RawConsensusStateWithHeight {
+    fn from(ics: ConsensusStateWithHeight) -> Self {
+        Self {
+            height: Some(ics.height.into()),
+            consensus_state: Some(ics.consensus_state),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStatesResponse {
+    consensus_states: Vec<ConsensusStateWithHeight>,
+    pagination: Option<PageResponse>,
+}
+
+impl QueryConsensusStatesResponse {
+    pub fn new(
+        consensus_states: Vec<ConsensusStateWithHeight>,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            consensus_states,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConsensusStatesResponse> for QueryConsensusStatesResponse {}
+
+impl TryFrom<RawQueryConsensusStatesResponse> for QueryConsensusStatesResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConsensusStatesResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            consensus_states: value
+                .consensus_states
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConsensusStatesResponse> for RawQueryConsensusStatesResponse {
+    fn from(response: QueryConsensusStatesResponse) -> Self {
+        Self {
+            consensus_states: response
+                .consensus_states
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type for querying the consensus state heights.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConsensusStateHeightsResponse {
+    consensus_state_heights: Vec<Height>,
+    pagination: Option<PageResponse>,
+}
+
+impl QueryConsensusStateHeightsResponse {
+    pub fn new(consensus_state_heights: Vec<Height>, pagination: Option<PageResponse>) -> Self {
+        Self {
+            consensus_state_heights,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConsensusStateHeightsResponse> for QueryConsensusStateHeightsResponse {}
+
+impl TryFrom<RawQueryConsensusStateHeightsResponse> for QueryConsensusStateHeightsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConsensusStateHeightsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            consensus_state_heights: value
+                .consensus_state_heights
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConsensusStateHeightsResponse> for RawQueryConsensusStateHeightsResponse {
+    fn from(response: QueryConsensusStateHeightsResponse) -> Self {
+        Self {
+            consensus_state_heights: response
+                .consensus_state_heights
+                .into_iter()
+                .map(Into::into)
+                .collect(),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type for querying the client status.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientStatusResponse {
+    status: Status,
+}
+
+impl QueryClientStatusResponse {
+    pub fn new(status: Status) -> Self {
+        Self { status }
+    }
+}
+
+impl Protobuf<RawQueryClientStatusResponse> for QueryClientStatusResponse {}
+
+impl TryFrom<RawQueryClientStatusResponse> for QueryClientStatusResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryClientStatusResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            status: value.status.parse()?,
+        })
+    }
+}
+
+impl From<QueryClientStatusResponse> for RawQueryClientStatusResponse {
+    fn from(response: QueryClientStatusResponse) -> Self {
+        Self {
+            status: response.status.to_string(),
+        }
+    }
+}
+
+/// Defines the RPC method response type for querying the client parameters.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientParamsResponse {
+    allowed_clients: Vec<ClientId>,
+}
+
+impl QueryClientParamsResponse {
+    pub fn new(allowed_clients: Vec<ClientId>) -> Self {
+        Self { allowed_clients }
+    }
+}
+
+impl Protobuf<RawQueryClientParamsResponse> for QueryClientParamsResponse {}
+
+impl TryFrom<RawQueryClientParamsResponse> for QueryClientParamsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryClientParamsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            allowed_clients: value
+                .params
+                .ok_or_else(|| QueryError::missing_field("params"))?
+                .allowed_clients
+                .into_iter()
+                .map(|id| id.parse())
+                .collect::<Result<_, _>>()?,
+        })
+    }
+}
+
+impl From<QueryClientParamsResponse> for RawQueryClientParamsResponse {
+    fn from(response: QueryClientParamsResponse) -> Self {
+        Self {
+            params: Some(RawParams {
+                allowed_clients: response
+                    .allowed_clients
+                    .into_iter()
+                    .map(|id| id.to_string())
+                    .collect(),
+            }),
+        }
+    }
+}
+
+/// Defines the RPC method response type for querying the upgraded client state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUpgradedClientStateResponse {
+    upgraded_client_state: Any,
+}
+
+impl QueryUpgradedClientStateResponse {
+    pub fn new(upgraded_client_state: Any) -> Self {
+        Self {
+            upgraded_client_state,
+        }
+    }
+}
+
+impl Protobuf<RawQueryUpgradedClientStateResponse> for QueryUpgradedClientStateResponse {}
+
+impl TryFrom<RawQueryUpgradedClientStateResponse> for QueryUpgradedClientStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryUpgradedClientStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            upgraded_client_state: value
+                .upgraded_client_state
+                .ok_or_else(|| QueryError::missing_field("upgraded_client_state"))?,
+        })
+    }
+}
+
+impl From<QueryUpgradedClientStateResponse> for RawQueryUpgradedClientStateResponse {
+    fn from(response: QueryUpgradedClientStateResponse) -> Self {
+        Self {
+            upgraded_client_state: Some(response.upgraded_client_state),
+        }
+    }
+}
+
+/// Defines the RPC method response type for querying the upgraded consensus state.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryUpgradedConsensusStateResponse {
+    upgraded_consensus_state: Any,
+}
+
+impl QueryUpgradedConsensusStateResponse {
+    pub fn new(upgraded_consensus_state: Any) -> Self {
+        Self {
+            upgraded_consensus_state,
+        }
+    }
+}
+
+impl Protobuf<RawQueryUpgradedConsensusStateResponse> for QueryUpgradedConsensusStateResponse {}
+
+impl TryFrom<RawQueryUpgradedConsensusStateResponse> for QueryUpgradedConsensusStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryUpgradedConsensusStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            upgraded_consensus_state: value
+                .upgraded_consensus_state
+                .ok_or_else(|| QueryError::missing_field("upgraded_consensus_state"))?,
+        })
+    }
+}
+
+impl From<QueryUpgradedConsensusStateResponse> for RawQueryUpgradedConsensusStateResponse {
+    fn from(response: QueryUpgradedConsensusStateResponse) -> Self {
+        Self {
+            upgraded_consensus_state: Some(response.upgraded_consensus_state),
+        }
+    }
+}
diff --git a/ibc-query/src/core/connection/mod.rs b/ibc-query/src/core/connection/mod.rs
index b24e36180..7cdb244ce 100644
--- a/ibc-query/src/core/connection/mod.rs
+++ b/ibc-query/src/core/connection/mod.rs
@@ -1,5 +1,7 @@
 mod query;
 mod service;
+mod types;
 
 pub use query::*;
 pub use service::*;
+pub use types::*;
diff --git a/ibc-query/src/core/connection/query.rs b/ibc-query/src/core/connection/query.rs
index 09d304806..419c45417 100644
--- a/ibc-query/src/core/connection/query.rs
+++ b/ibc-query/src/core/connection/query.rs
@@ -1,28 +1,24 @@
 //! Provides utility functions for querying IBC connection states.
 
-use alloc::format;
-use alloc::vec::Vec;
-use core::str::FromStr;
-
 use ibc::core::client::context::ClientValidationContext;
-use ibc::core::client::types::Height;
-use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::types::path::{
     ClientConnectionPath, ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path,
 };
 use ibc::core::host::{ConsensusStateRef, ValidationContext};
-use ibc_proto::google::protobuf::Any;
-use ibc_proto::ibc::core::client::v1::IdentifiedClientState;
-use ibc_proto::ibc::core::connection::v1::{
-    Params as ConnectionParams, QueryClientConnectionsRequest, QueryClientConnectionsResponse,
+use ibc::primitives::prelude::format;
+use ibc::primitives::proto::Any;
+
+use super::{
+    QueryClientConnectionsRequest, QueryClientConnectionsResponse,
     QueryConnectionClientStateRequest, QueryConnectionClientStateResponse,
     QueryConnectionConsensusStateRequest, QueryConnectionConsensusStateResponse,
     QueryConnectionParamsRequest, QueryConnectionParamsResponse, QueryConnectionRequest,
     QueryConnectionResponse, QueryConnectionsRequest, QueryConnectionsResponse,
 };
-
+use crate::core::client::IdentifiedClientState;
 use crate::core::context::{ProvableContext, QueryContext};
 use crate::error::QueryError;
+use crate::types::Proof;
 
 /// Queries for the connection end of a given connection id.
 pub fn query_connection<I>(
@@ -32,26 +28,27 @@ pub fn query_connection<I>(
 where
     I: ValidationContext + ProvableContext,
 {
-    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
-
-    let connection_end = ibc_ctx.connection_end(&connection_id)?;
+    let connection_end = ibc_ctx.connection_end(&request.connection_id)?;
 
     let current_height = ibc_ctx.host_height()?;
 
     let proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::Connection(ConnectionPath::new(&connection_id)),
+            &Path::Connection(ConnectionPath::new(&request.connection_id)),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Proof not found for connection path: {connection_id:?}"),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for connection path: {:?}",
+                request.connection_id
+            ))
         })?;
 
-    Ok(QueryConnectionResponse {
-        connection: Some(connection_end.into()),
+    Ok(QueryConnectionResponse::new(
+        connection_end,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for all the existing connection ends.
@@ -64,12 +61,11 @@ where
 {
     let connections = ibc_ctx.connection_ends()?;
 
-    Ok(QueryConnectionsResponse {
-        connections: connections.into_iter().map(Into::into).collect(),
-        height: Some(ibc_ctx.host_height()?.into()),
-        // no support for pagination yet
-        pagination: None,
-    })
+    Ok(QueryConnectionsResponse::new(
+        connections,
+        ibc_ctx.host_height()?,
+        None,
+    ))
 }
 
 /// Queries for all the existing connection ends for a given client.
@@ -80,26 +76,27 @@ pub fn query_client_connections<I>(
 where
     I: QueryContext,
 {
-    let client_id = ClientId::from_str(request.client_id.as_str())?;
-
-    let connections = ibc_ctx.client_connection_ends(&client_id)?;
+    let connections = ibc_ctx.client_connection_ends(&request.client_id)?;
 
     let current_height = ibc_ctx.host_height()?;
 
-    let proof: Vec<u8> = ibc_ctx
+    let proof: Proof = ibc_ctx
         .get_proof(
             current_height,
-            &Path::ClientConnection(ClientConnectionPath::new(client_id.clone())),
+            &Path::ClientConnection(ClientConnectionPath::new(request.client_id.clone())),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!("Proof not found for client connection path: {client_id:?}"),
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for client connection path: {:?}",
+                request.client_id
+            ))
         })?;
 
-    Ok(QueryClientConnectionsResponse {
-        connection_paths: connections.into_iter().map(|x| x.as_str().into()).collect(),
+    Ok(QueryClientConnectionsResponse::new(
+        connections,
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the client state of a given connection id.
@@ -110,9 +107,7 @@ pub fn query_connection_client_state<I>(
 where
     I: QueryContext,
 {
-    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
-
-    let connection_end = ibc_ctx.connection_end(&connection_id)?;
+    let connection_end = ibc_ctx.connection_end(&request.connection_id)?;
 
     let client_val_ctx = ibc_ctx.get_client_validation_context();
 
@@ -125,21 +120,18 @@ where
             current_height,
             &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
                 "Proof not found for client state path: {:?}",
                 connection_end.client_id()
-            ),
+            ))
         })?;
 
-    Ok(QueryConnectionClientStateResponse {
-        identified_client_state: Some(IdentifiedClientState {
-            client_id: connection_end.client_id().as_str().into(),
-            client_state: Some(client_state.into()),
-        }),
+    Ok(QueryConnectionClientStateResponse::new(
+        IdentifiedClientState::new(connection_end.client_id().clone(), client_state.into()),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the consensus state of a given connection id and height.
@@ -151,16 +143,12 @@ where
     I: ValidationContext + ProvableContext,
     ConsensusStateRef<I>: Into<Any>,
 {
-    let connection_id = ConnectionId::from_str(request.connection_id.as_str())?;
-
-    let connection_end = ibc_ctx.connection_end(&connection_id)?;
-
-    let height = Height::new(request.revision_number, request.revision_height)?;
+    let connection_end = ibc_ctx.connection_end(&request.connection_id)?;
 
     let consensus_path = ClientConsensusStatePath::new(
         connection_end.client_id().clone(),
-        height.revision_number(),
-        height.revision_height(),
+        request.height.revision_number(),
+        request.height.revision_height(),
     );
 
     let client_val_ctx = ibc_ctx.get_client_validation_context();
@@ -171,19 +159,19 @@ where
 
     let proof = ibc_ctx
         .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
-        .ok_or(QueryError::ProofNotFound {
-            description: format!(
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
                 "Proof not found for consensus state path: {:?}",
                 connection_end.client_id()
-            ),
+            ))
         })?;
 
-    Ok(QueryConnectionConsensusStateResponse {
-        consensus_state: Some(consensus_state.into()),
-        client_id: connection_end.client_id().as_str().into(),
+    Ok(QueryConnectionConsensusStateResponse::new(
+        consensus_state.into(),
+        connection_end.client_id().clone(),
         proof,
-        proof_height: Some(current_height.into()),
-    })
+        current_height,
+    ))
 }
 
 /// Queries for the connection parameters.
@@ -194,9 +182,7 @@ pub fn query_connection_params<I>(
 where
     I: QueryContext,
 {
-    Ok(QueryConnectionParamsResponse {
-        params: Some(ConnectionParams {
-            max_expected_time_per_block: ibc_ctx.max_expected_time_per_block().as_secs(),
-        }),
-    })
+    Ok(QueryConnectionParamsResponse::new(
+        ibc_ctx.max_expected_time_per_block().as_secs(),
+    ))
 }
diff --git a/ibc-query/src/core/connection/service.rs b/ibc-query/src/core/connection/service.rs
index 75c20b185..3828f071e 100644
--- a/ibc-query/src/core/connection/service.rs
+++ b/ibc-query/src/core/connection/service.rs
@@ -1,6 +1,7 @@
-//! [`ConnectionQueryService`](ConnectionQueryService) takes a generic `I` to store `ibc_context` that implements [`QueryContext`](QueryContext).
-//! `I` must be a type where writes from one thread are readable from another.
-//! This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+//! [`ConnectionQueryService`](ConnectionQueryService) takes a generic `I` to
+//! store `ibc_context` that implements [`QueryContext`](QueryContext). `I` must
+//! be a type where writes from one thread are readable from another. This means
+//! using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
 
 use ibc::core::host::ConsensusStateRef;
 use ibc::core::primitives::prelude::*;
@@ -20,11 +21,13 @@ use super::{
     query_connection_consensus_state, query_connection_params, query_connections,
 };
 use crate::core::context::QueryContext;
+use crate::utils::{IntoDomain, IntoResponse, TryIntoDomain};
 
 // TODO(rano): currently the services don't support pagination, so we return all the results.
 
-/// The generic `I` must be a type where writes from one thread are readable from another.
-/// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+/// The generic `I` must be a type where writes from one thread are readable
+/// from another. This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most
+/// cases.
 pub struct ConnectionQueryService<I>
 where
     I: QueryContext + Send + Sync + 'static,
@@ -38,8 +41,9 @@ where
     I: QueryContext + Send + Sync + 'static,
     ConsensusStateRef<I>: Into<Any>,
 {
-    /// The parameter `ibc_context` must be a type where writes from one thread are readable from another.
-    /// This means using `Arc<Mutex<_>>` or `Arc<RwLock<_>>` in most cases.
+    /// The parameter `ibc_context` must be a type where writes from one thread
+    /// are readable from another. This means using `Arc<Mutex<_>>` or
+    /// `Arc<RwLock<_>>` in most cases.
     pub fn new(ibc_context: I) -> Self {
         Self { ibc_context }
     }
@@ -55,53 +59,43 @@ where
         &self,
         request: Request<QueryConnectionRequest>,
     ) -> Result<Response<QueryConnectionResponse>, Status> {
-        let response = query_connection(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connection(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn connections(
         &self,
         request: Request<QueryConnectionsRequest>,
     ) -> Result<Response<QueryConnectionsResponse>, Status> {
-        let response = query_connections(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connections(&self.ibc_context, &request.into_domain())?.into_response()
     }
 
     async fn client_connections(
         &self,
         request: Request<QueryClientConnectionsRequest>,
     ) -> Result<Response<QueryClientConnectionsResponse>, Status> {
-        let response = query_client_connections(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_client_connections(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
     async fn connection_client_state(
         &self,
         request: Request<QueryConnectionClientStateRequest>,
     ) -> Result<Response<QueryConnectionClientStateResponse>, Status> {
-        let response = query_connection_client_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connection_client_state(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     async fn connection_consensus_state(
         &self,
         request: Request<QueryConnectionConsensusStateRequest>,
     ) -> Result<Response<QueryConnectionConsensusStateResponse>, Status> {
-        let response = query_connection_consensus_state(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connection_consensus_state(&self.ibc_context, &request.try_into_domain()?)?
+            .into_response()
     }
 
     async fn connection_params(
         &self,
         request: Request<QueryConnectionParamsRequest>,
     ) -> Result<Response<QueryConnectionParamsResponse>, Status> {
-        let response = query_connection_params(&self.ibc_context, request.get_ref())?;
-
-        Ok(Response::new(response))
+        query_connection_params(&self.ibc_context, &request.into_domain())?.into_response()
     }
 }
diff --git a/ibc-query/src/core/connection/types/mod.rs b/ibc-query/src/core/connection/types/mod.rs
new file mode 100644
index 000000000..b8be6322b
--- /dev/null
+++ b/ibc-query/src/core/connection/types/mod.rs
@@ -0,0 +1,5 @@
+mod request;
+mod response;
+
+pub use request::*;
+pub use response::*;
diff --git a/ibc-query/src/core/connection/types/request.rs b/ibc-query/src/core/connection/types/request.rs
new file mode 100644
index 000000000..ad11e62f5
--- /dev/null
+++ b/ibc-query/src/core/connection/types/request.rs
@@ -0,0 +1,161 @@
+//! Contains all the RPC method request domain types and their conversions to
+//! and from the corresponding gRPC proto types for the connection module.
+
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::primitives::prelude::*;
+use ibc_proto::ibc::core::channel::v1::QueryConnectionChannelsRequest as RawQueryConnectionChannelsRequest;
+use ibc_proto::ibc::core::connection::v1::{
+    QueryClientConnectionsRequest as RawQueryClientConnectionsRequest,
+    QueryConnectionClientStateRequest as RawQueryConnectionClientStateRequest,
+    QueryConnectionConsensusStateRequest as RawQueryConnectionConsensusStateRequest,
+    QueryConnectionParamsRequest as RawQueryConnectionParamsRequest,
+    QueryConnectionRequest as RawQueryConnectionRequest,
+    QueryConnectionsRequest as RawQueryConnectionsRequest,
+};
+
+use crate::error::QueryError;
+use crate::types::PageRequest;
+
+/// Defines the RPC method request type for querying a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionRequest {
+    pub connection_id: ConnectionId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryConnectionRequest> for QueryConnectionRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConnectionRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_id: request.connection_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying connections.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionsRequest {
+    pub pagination: Option<PageRequest>,
+}
+
+impl From<RawQueryConnectionsRequest> for QueryConnectionsRequest {
+    fn from(request: RawQueryConnectionsRequest) -> Self {
+        Self {
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method request type for querying connections associated with
+/// a client.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientConnectionsRequest {
+    pub client_id: ClientId,
+}
+
+impl TryFrom<RawQueryClientConnectionsRequest> for QueryClientConnectionsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryClientConnectionsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            client_id: request.client_id.parse()?,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the client state associated
+/// with a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionClientStateRequest {
+    pub connection_id: ConnectionId,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryConnectionClientStateRequest> for QueryConnectionClientStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConnectionClientStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_id: request.connection_id.parse()?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the consensus state
+/// associated with a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionConsensusStateRequest {
+    pub connection_id: ConnectionId,
+    pub height: Height,
+    pub query_height: Option<Height>,
+}
+
+impl TryFrom<RawQueryConnectionConsensusStateRequest> for QueryConnectionConsensusStateRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConnectionConsensusStateRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_id: request.connection_id.parse()?,
+            height: Height::new(request.revision_number, request.revision_height)?,
+            query_height: None,
+        })
+    }
+}
+
+/// Defines the RPC method request type for querying the connection parameters.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionParamsRequest {
+    pub query_height: Option<Height>,
+}
+
+impl From<RawQueryConnectionParamsRequest> for QueryConnectionParamsRequest {
+    fn from(_request: RawQueryConnectionParamsRequest) -> Self {
+        Self { query_height: None }
+    }
+}
+
+/// Defines the RPC method request type for querying the channels associated
+/// with a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionChannelsRequest {
+    pub connection_id: ConnectionId,
+    pub pagination: Option<PageRequest>,
+}
+
+impl TryFrom<RawQueryConnectionChannelsRequest> for QueryConnectionChannelsRequest {
+    type Error = QueryError;
+
+    fn try_from(request: RawQueryConnectionChannelsRequest) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_id: request.connection.parse()?,
+            pagination: request.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConnectionChannelsRequest> for RawQueryConnectionChannelsRequest {
+    fn from(request: QueryConnectionChannelsRequest) -> Self {
+        Self {
+            connection: request.connection_id.to_string(),
+            pagination: request.pagination.map(Into::into),
+        }
+    }
+}
diff --git a/ibc-query/src/core/connection/types/response.rs b/ibc-query/src/core/connection/types/response.rs
new file mode 100644
index 000000000..5b252e594
--- /dev/null
+++ b/ibc-query/src/core/connection/types/response.rs
@@ -0,0 +1,336 @@
+//! Contains all the RPC method response domain types and their conversions to
+//! and from the corresponding gRPC proto types for the connection module.
+
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::{ConnectionEnd, IdentifiedConnectionEnd};
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
+use ibc::core::primitives::proto::Any;
+use ibc::primitives::prelude::*;
+use ibc::primitives::proto::Protobuf;
+use ibc_proto::ibc::core::connection::v1::{
+    Params as RawParams, QueryClientConnectionsResponse as RawQueryClientConnectionsResponse,
+    QueryConnectionClientStateResponse as RawQueryConnectionClientStateResponse,
+    QueryConnectionConsensusStateResponse as RawQueryConnectionConsensusStateResponse,
+    QueryConnectionParamsResponse as RawQueryConnectionParamsResponse,
+    QueryConnectionResponse as RawQueryConnectionResponse,
+    QueryConnectionsResponse as RawQueryConnectionsResponse,
+};
+
+use crate::core::client::IdentifiedClientState;
+use crate::error::QueryError;
+use crate::types::{PageResponse, Proof};
+
+/// Defines the RPC method response type when querying a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionResponse {
+    pub conn_end: ConnectionEnd,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryConnectionResponse {
+    pub fn new(connection: ConnectionEnd, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            conn_end: connection,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionResponse> for QueryConnectionResponse {}
+
+impl TryFrom<RawQueryConnectionResponse> for QueryConnectionResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            conn_end: value
+                .connection
+                .ok_or_else(|| QueryError::missing_field("connection"))?
+                .try_into()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryConnectionResponse> for RawQueryConnectionResponse {
+    fn from(response: QueryConnectionResponse) -> Self {
+        Self {
+            connection: Some(response.conn_end.into()),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying all the existing connection ends.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionsResponse {
+    pub connections: Vec<IdentifiedConnectionEnd>,
+    pub query_height: Height,
+    pub pagination: Option<PageResponse>,
+}
+
+impl QueryConnectionsResponse {
+    pub fn new(
+        connections: Vec<IdentifiedConnectionEnd>,
+        query_height: Height,
+        pagination: Option<PageResponse>,
+    ) -> Self {
+        Self {
+            connections,
+            query_height,
+            pagination,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionsResponse> for QueryConnectionsResponse {}
+
+impl TryFrom<RawQueryConnectionsResponse> for QueryConnectionsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connections: value
+                .connections
+                .into_iter()
+                .map(TryInto::try_into)
+                .collect::<Result<_, _>>()?,
+            query_height: value
+                .height
+                .ok_or_else(|| QueryError::missing_field("height"))?
+                .try_into()?,
+            pagination: value.pagination.map(Into::into),
+        })
+    }
+}
+
+impl From<QueryConnectionsResponse> for RawQueryConnectionsResponse {
+    fn from(response: QueryConnectionsResponse) -> Self {
+        Self {
+            connections: response.connections.into_iter().map(Into::into).collect(),
+            height: Some(response.query_height.into()),
+            pagination: response.pagination.map(Into::into),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying client state associated
+/// with a connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionClientStateResponse {
+    pub identified_client_state: IdentifiedClientState,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryConnectionClientStateResponse {
+    pub fn new(
+        identified_client_state: IdentifiedClientState,
+        proof: Proof,
+        proof_height: Height,
+    ) -> Self {
+        Self {
+            identified_client_state,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionClientStateResponse> for QueryConnectionClientStateResponse {}
+
+impl TryFrom<RawQueryConnectionClientStateResponse> for QueryConnectionClientStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionClientStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            identified_client_state: value
+                .identified_client_state
+                .ok_or_else(|| QueryError::missing_field("identified_client_state"))?
+                .try_into()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryConnectionClientStateResponse> for RawQueryConnectionClientStateResponse {
+    fn from(response: QueryConnectionClientStateResponse) -> Self {
+        Self {
+            identified_client_state: Some(response.identified_client_state.into()),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying all the existing
+/// connection ends for a given client.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryClientConnectionsResponse {
+    pub connection_paths: Vec<ConnectionId>,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryClientConnectionsResponse {
+    pub fn new(connection_paths: Vec<ConnectionId>, proof: Proof, proof_height: Height) -> Self {
+        Self {
+            connection_paths,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryClientConnectionsResponse> for QueryClientConnectionsResponse {}
+
+impl TryFrom<RawQueryClientConnectionsResponse> for QueryClientConnectionsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryClientConnectionsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            connection_paths: value
+                .connection_paths
+                .into_iter()
+                .map(|id| id.parse())
+                .collect::<Result<_, _>>()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryClientConnectionsResponse> for RawQueryClientConnectionsResponse {
+    fn from(response: QueryClientConnectionsResponse) -> Self {
+        Self {
+            connection_paths: response
+                .connection_paths
+                .into_iter()
+                .map(|id| id.to_string())
+                .collect(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+/// Defines the RPC method response type when querying the consensus state for a
+/// connection.
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionConsensusStateResponse {
+    pub consensus_state: Any,
+    pub client_id: ClientId,
+    pub proof: Proof,
+    pub proof_height: Height,
+}
+
+impl QueryConnectionConsensusStateResponse {
+    pub fn new(
+        consensus_state: Any,
+        client_id: ClientId,
+        proof: Proof,
+        proof_height: Height,
+    ) -> Self {
+        Self {
+            consensus_state,
+            client_id,
+            proof,
+            proof_height,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionConsensusStateResponse> for QueryConnectionConsensusStateResponse {}
+
+impl TryFrom<RawQueryConnectionConsensusStateResponse> for QueryConnectionConsensusStateResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionConsensusStateResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            consensus_state: value
+                .consensus_state
+                .ok_or_else(|| QueryError::missing_field("consensus_state"))?,
+            client_id: value.client_id.parse()?,
+            proof: value.proof,
+            proof_height: value
+                .proof_height
+                .ok_or_else(|| QueryError::missing_field("proof_height"))?
+                .try_into()?,
+        })
+    }
+}
+
+impl From<QueryConnectionConsensusStateResponse> for RawQueryConnectionConsensusStateResponse {
+    fn from(response: QueryConnectionConsensusStateResponse) -> Self {
+        Self {
+            consensus_state: Some(response.consensus_state),
+            client_id: response.client_id.to_string(),
+            proof: response.proof,
+            proof_height: Some(response.proof_height.into()),
+        }
+    }
+}
+
+#[derive(Clone, Debug)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct QueryConnectionParamsResponse {
+    pub max_expected_time_per_block: u64,
+}
+
+impl QueryConnectionParamsResponse {
+    pub fn new(max_expected_time_per_block: u64) -> Self {
+        Self {
+            max_expected_time_per_block,
+        }
+    }
+}
+
+impl Protobuf<RawQueryConnectionParamsResponse> for QueryConnectionParamsResponse {}
+
+impl TryFrom<RawQueryConnectionParamsResponse> for QueryConnectionParamsResponse {
+    type Error = QueryError;
+
+    fn try_from(value: RawQueryConnectionParamsResponse) -> Result<Self, Self::Error> {
+        Ok(Self {
+            max_expected_time_per_block: value
+                .params
+                .ok_or_else(|| QueryError::missing_field("params"))?
+                .max_expected_time_per_block,
+        })
+    }
+}
+
+impl From<QueryConnectionParamsResponse> for RawQueryConnectionParamsResponse {
+    fn from(response: QueryConnectionParamsResponse) -> Self {
+        Self {
+            params: Some(RawParams {
+                max_expected_time_per_block: response.max_expected_time_per_block,
+            }),
+        }
+    }
+}
diff --git a/ibc-query/src/error.rs b/ibc-query/src/error.rs
index 9b8eb54f2..6d11fd2d8 100644
--- a/ibc-query/src/error.rs
+++ b/ibc-query/src/error.rs
@@ -1,7 +1,9 @@
 use alloc::string::{String, ToString};
 
 use displaydoc::Display;
+use ibc::core::channel::types::error::{ChannelError, PacketError};
 use ibc::core::client::types::error::ClientError;
+use ibc::core::connection::types::error::ConnectionError;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::host::types::error::IdentifierError;
 use tonic::Status;
@@ -10,39 +12,67 @@ use tonic::Status;
 pub enum QueryError {
     /// Context error: {0}
     ContextError(ContextError),
-    /// Client error: {0}
-    ClientError(ClientError),
     /// Identifier error: {0}
     IdentifierError(IdentifierError),
-    /// Proof not found: {description}
-    ProofNotFound { description: String },
+    /// Proof not found: {0}
+    ProofNotFound(String),
+    /// Missing field: {0}
+    MissingField(String),
+}
+
+impl QueryError {
+    pub fn proof_not_found<T: ToString>(description: T) -> Self {
+        Self::ProofNotFound(description.to_string())
+    }
+
+    pub fn missing_field<T: ToString>(description: T) -> Self {
+        Self::MissingField(description.to_string())
+    }
 }
 
 impl From<QueryError> for Status {
     fn from(e: QueryError) -> Self {
         match e {
-            QueryError::ContextError(e) => Status::internal(e.to_string()),
-            QueryError::ClientError(e) => Status::internal(e.to_string()),
-            QueryError::IdentifierError(e) => Status::internal(e.to_string()),
-            QueryError::ProofNotFound { description } => Status::not_found(description),
+            QueryError::ContextError(ctx_err) => Self::internal(ctx_err.to_string()),
+            QueryError::IdentifierError(id_err) => Self::internal(id_err.to_string()),
+            QueryError::ProofNotFound(description) => Self::not_found(description),
+            QueryError::MissingField(description) => Self::invalid_argument(description),
         }
     }
 }
 
 impl From<ContextError> for QueryError {
     fn from(e: ContextError) -> Self {
-        QueryError::ContextError(e)
+        Self::ContextError(e)
     }
 }
 
 impl From<ClientError> for QueryError {
     fn from(e: ClientError) -> Self {
-        QueryError::ClientError(e)
+        Self::ContextError(ContextError::ClientError(e))
+    }
+}
+
+impl From<ConnectionError> for QueryError {
+    fn from(e: ConnectionError) -> Self {
+        Self::ContextError(ContextError::ConnectionError(e))
+    }
+}
+
+impl From<ChannelError> for QueryError {
+    fn from(e: ChannelError) -> Self {
+        Self::ContextError(ContextError::ChannelError(e))
+    }
+}
+
+impl From<PacketError> for QueryError {
+    fn from(e: PacketError) -> Self {
+        Self::ContextError(ContextError::PacketError(e))
     }
 }
 
 impl From<IdentifierError> for QueryError {
     fn from(e: IdentifierError) -> Self {
-        QueryError::IdentifierError(e)
+        Self::IdentifierError(e)
     }
 }
diff --git a/ibc-query/src/lib.rs b/ibc-query/src/lib.rs
index e9db0806f..504298398 100644
--- a/ibc-query/src/lib.rs
+++ b/ibc-query/src/lib.rs
@@ -66,5 +66,10 @@
 
 extern crate alloc;
 
+#[cfg(feature = "std")]
+extern crate std;
+
 pub mod core;
 pub mod error;
+pub mod types;
+pub mod utils;
diff --git a/ibc-query/src/types.rs b/ibc-query/src/types.rs
new file mode 100644
index 000000000..147307a98
--- /dev/null
+++ b/ibc-query/src/types.rs
@@ -0,0 +1,94 @@
+use ibc::core::primitives::prelude::*;
+use ibc_proto::cosmos::base::query::v1beta1::{
+    PageRequest as RawPageRequest, PageResponse as RawPageResponse,
+};
+
+pub type Proof = Vec<u8>;
+
+#[derive(Clone, Debug, Default)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct PageRequest {
+    /// key is a value returned in PageResponse.next_key to begin
+    /// querying the next page most efficiently. Only one of offset or key
+    /// should be set.
+    pub key: Vec<u8>,
+    /// offset is a numeric offset that can be used when key is unavailable.
+    /// It is less efficient than using key. Only one of offset or key should
+    /// be set.
+    pub offset: u64,
+    /// limit is the total number of results to be returned in the result page.
+    /// If left empty it will default to a value to be set by each app.
+    pub limit: u64,
+    /// count_total is set to true  to indicate that the result set should include
+    /// a count of the total number of items available for pagination in UIs.
+    /// count_total is only respected when offset is used. It is ignored when key
+    /// is set.
+    pub count_total: bool,
+    /// reverse is set to true if results are to be returned in the descending order.
+    pub reverse: bool,
+}
+
+impl PageRequest {
+    pub fn all() -> Self {
+        Self {
+            limit: u64::MAX,
+            ..Default::default()
+        }
+    }
+}
+
+impl From<PageRequest> for RawPageRequest {
+    fn from(request: PageRequest) -> Self {
+        Self {
+            key: request.key,
+            offset: request.offset,
+            limit: request.limit,
+            count_total: request.count_total,
+            reverse: request.reverse,
+        }
+    }
+}
+
+impl From<RawPageRequest> for PageRequest {
+    fn from(request: RawPageRequest) -> Self {
+        Self {
+            key: request.key,
+            offset: request.offset,
+            limit: request.limit,
+            count_total: request.count_total,
+            reverse: request.reverse,
+        }
+    }
+}
+
+#[derive(Clone, Debug, Default)]
+#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+pub struct PageResponse {
+    /// next_key is the key to be passed to PageRequest.key to
+    /// query the next page most efficiently. It will be empty if
+    /// there are no more results.
+    pub next_key: Vec<u8>,
+    /// total is total number of results available if PageRequest.count_total
+    /// was set, its value is undefined otherwise
+    pub total: u64,
+}
+
+impl From<PageResponse> for RawPageResponse {
+    fn from(response: PageResponse) -> Self {
+        Self {
+            next_key: response.next_key,
+            total: response.total,
+        }
+    }
+}
+
+impl From<RawPageResponse> for PageResponse {
+    fn from(response: RawPageResponse) -> Self {
+        Self {
+            next_key: response.next_key,
+            total: response.total,
+        }
+    }
+}
diff --git a/ibc-query/src/utils.rs b/ibc-query/src/utils.rs
new file mode 100644
index 000000000..7b1adeebe
--- /dev/null
+++ b/ibc-query/src/utils.rs
@@ -0,0 +1,40 @@
+use tonic::{Request, Response, Status};
+
+use crate::error::QueryError;
+
+pub trait TryIntoDomain<T> {
+    fn try_into_domain(self) -> Result<T, Status>;
+}
+
+pub trait IntoDomain<T> {
+    fn into_domain(self) -> T;
+}
+
+impl<T, Raw> TryIntoDomain<T> for Request<Raw>
+where
+    T: TryFrom<Raw, Error = QueryError>,
+{
+    fn try_into_domain(self) -> Result<T, Status> {
+        Ok(self.into_inner().try_into()?)
+    }
+}
+
+impl<T, Raw> IntoDomain<T> for Request<Raw>
+where
+    T: From<Raw>,
+{
+    fn into_domain(self) -> T {
+        self.into_inner().into()
+    }
+}
+
+pub trait IntoResponse<Raw>: Sized
+where
+    Self: Into<Raw>,
+{
+    fn into_response(self) -> Result<Response<Raw>, Status> {
+        Ok(Response::new(self.into()))
+    }
+}
+
+impl<T, Raw> IntoResponse<Raw> for T where T: Into<Raw> {}

From 49e907ae4442f55901a57c1896c63011393d4542 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 22 Mar 2024 11:42:12 +0100
Subject: [PATCH 132/182] Release v0.51.0 (#1137)

* prepend current changelogs

* add summary to changelog-md

* unclog release

* s/old_ver/new_ver/

* update cw-check cargo lockfile

* update no-std-check cargo lockfile
---
 .../1114-refactor-client-relevant-apis.md     |  0
 .../breaking-changes/1118-bump-msrv.md        |  0
 .../1125-upgrade-ibc-proto-to-v042.md         |  0
 ...date-client-handler-accept-misbehaviour.md |  0
 .../breaking-changes/973-update-meta.md       |  0
 ...1059-add-missing-deps-for-feature-flags.md |  0
 ...ease-frozen-height-check-ics07-try-from.md |  0
 ...r-height-for-tm-consensus-state-storage.md |  0
 .../bug-fixes/1083-bump-serde-json.md         |  0
 ...4-fix-potential-base64-resolution-issue.md |  0
 ...-fix-tendermint-empty-proof-specs-check.md |  0
 .../feature/1065-add-new-storage-paths.md     |  0
 .../1090-add-iterate-consensus-states-key.md  |  0
 ...60-ease-serde-derive-on-ics20-721-types.md |  0
 .../1074-refactor-default-implemetation.md    |  0
 .../1077-deprecate-msgsubmitmisbehaviour.md   |  0
 .../1089-implement-convenient-path-methods.md |  0
 .../1097-detach-client-state-verifier.md      |  0
 .../1101-use-let-else-over-downcast.md        |  0
 .../1120-rm-redundant-shadowing.md            |  0
 ...ck-for-unitialized-connection-end-state.md |  0
 .../improvements/394-remove-order-match.md    |  0
 .changelog/v0.51.0/summary.md                 | 11 +++
 CHANGELOG.md                                  | 88 +++++++++++++++++++
 Cargo.toml                                    | 56 ++++++------
 ci/cw-check/Cargo.lock                        | 38 ++++----
 ci/no-std-check/Cargo.lock                    | 50 +++++------
 27 files changed, 171 insertions(+), 72 deletions(-)
 rename .changelog/{unreleased => v0.51.0}/breaking-changes/1114-refactor-client-relevant-apis.md (100%)
 rename .changelog/{unreleased => v0.51.0}/breaking-changes/1118-bump-msrv.md (100%)
 rename .changelog/{unreleased => v0.51.0}/breaking-changes/1125-upgrade-ibc-proto-to-v042.md (100%)
 rename .changelog/{unreleased => v0.51.0}/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md (100%)
 rename .changelog/{unreleased => v0.51.0}/breaking-changes/973-update-meta.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1059-add-missing-deps-for-feature-flags.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1083-bump-serde-json.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1084-fix-potential-base64-resolution-issue.md (100%)
 rename .changelog/{unreleased => v0.51.0}/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md (100%)
 rename .changelog/{unreleased => v0.51.0}/feature/1065-add-new-storage-paths.md (100%)
 rename .changelog/{unreleased => v0.51.0}/feature/1090-add-iterate-consensus-states-key.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1060-ease-serde-derive-on-ics20-721-types.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1074-refactor-default-implemetation.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1077-deprecate-msgsubmitmisbehaviour.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1089-implement-convenient-path-methods.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1097-detach-client-state-verifier.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1101-use-let-else-over-downcast.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1120-rm-redundant-shadowing.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/1123-remove-check-for-unitialized-connection-end-state.md (100%)
 rename .changelog/{unreleased => v0.51.0}/improvements/394-remove-order-match.md (100%)
 create mode 100644 .changelog/v0.51.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md b/.changelog/v0.51.0/breaking-changes/1114-refactor-client-relevant-apis.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1114-refactor-client-relevant-apis.md
rename to .changelog/v0.51.0/breaking-changes/1114-refactor-client-relevant-apis.md
diff --git a/.changelog/unreleased/breaking-changes/1118-bump-msrv.md b/.changelog/v0.51.0/breaking-changes/1118-bump-msrv.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1118-bump-msrv.md
rename to .changelog/v0.51.0/breaking-changes/1118-bump-msrv.md
diff --git a/.changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md b/.changelog/v0.51.0/breaking-changes/1125-upgrade-ibc-proto-to-v042.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1125-upgrade-ibc-proto-to-v042.md
rename to .changelog/v0.51.0/breaking-changes/1125-upgrade-ibc-proto-to-v042.md
diff --git a/.changelog/unreleased/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md b/.changelog/v0.51.0/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md
rename to .changelog/v0.51.0/breaking-changes/835-msg-update-client-handler-accept-misbehaviour.md
diff --git a/.changelog/unreleased/breaking-changes/973-update-meta.md b/.changelog/v0.51.0/breaking-changes/973-update-meta.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/973-update-meta.md
rename to .changelog/v0.51.0/breaking-changes/973-update-meta.md
diff --git a/.changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md b/.changelog/v0.51.0/bug-fixes/1059-add-missing-deps-for-feature-flags.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1059-add-missing-deps-for-feature-flags.md
rename to .changelog/v0.51.0/bug-fixes/1059-add-missing-deps-for-feature-flags.md
diff --git a/.changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md b/.changelog/v0.51.0/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
rename to .changelog/v0.51.0/bug-fixes/1061-ease-frozen-height-check-ics07-try-from.md
diff --git a/.changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md b/.changelog/v0.51.0/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md
rename to .changelog/v0.51.0/bug-fixes/1080-use-header-height-for-tm-consensus-state-storage.md
diff --git a/.changelog/unreleased/bug-fixes/1083-bump-serde-json.md b/.changelog/v0.51.0/bug-fixes/1083-bump-serde-json.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1083-bump-serde-json.md
rename to .changelog/v0.51.0/bug-fixes/1083-bump-serde-json.md
diff --git a/.changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md b/.changelog/v0.51.0/bug-fixes/1084-fix-potential-base64-resolution-issue.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1084-fix-potential-base64-resolution-issue.md
rename to .changelog/v0.51.0/bug-fixes/1084-fix-potential-base64-resolution-issue.md
diff --git a/.changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md b/.changelog/v0.51.0/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md
rename to .changelog/v0.51.0/bug-fixes/1100-fix-tendermint-empty-proof-specs-check.md
diff --git a/.changelog/unreleased/feature/1065-add-new-storage-paths.md b/.changelog/v0.51.0/feature/1065-add-new-storage-paths.md
similarity index 100%
rename from .changelog/unreleased/feature/1065-add-new-storage-paths.md
rename to .changelog/v0.51.0/feature/1065-add-new-storage-paths.md
diff --git a/.changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md b/.changelog/v0.51.0/feature/1090-add-iterate-consensus-states-key.md
similarity index 100%
rename from .changelog/unreleased/feature/1090-add-iterate-consensus-states-key.md
rename to .changelog/v0.51.0/feature/1090-add-iterate-consensus-states-key.md
diff --git a/.changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md b/.changelog/v0.51.0/improvements/1060-ease-serde-derive-on-ics20-721-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/1060-ease-serde-derive-on-ics20-721-types.md
rename to .changelog/v0.51.0/improvements/1060-ease-serde-derive-on-ics20-721-types.md
diff --git a/.changelog/unreleased/improvements/1074-refactor-default-implemetation.md b/.changelog/v0.51.0/improvements/1074-refactor-default-implemetation.md
similarity index 100%
rename from .changelog/unreleased/improvements/1074-refactor-default-implemetation.md
rename to .changelog/v0.51.0/improvements/1074-refactor-default-implemetation.md
diff --git a/.changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md b/.changelog/v0.51.0/improvements/1077-deprecate-msgsubmitmisbehaviour.md
similarity index 100%
rename from .changelog/unreleased/improvements/1077-deprecate-msgsubmitmisbehaviour.md
rename to .changelog/v0.51.0/improvements/1077-deprecate-msgsubmitmisbehaviour.md
diff --git a/.changelog/unreleased/improvements/1089-implement-convenient-path-methods.md b/.changelog/v0.51.0/improvements/1089-implement-convenient-path-methods.md
similarity index 100%
rename from .changelog/unreleased/improvements/1089-implement-convenient-path-methods.md
rename to .changelog/v0.51.0/improvements/1089-implement-convenient-path-methods.md
diff --git a/.changelog/unreleased/improvements/1097-detach-client-state-verifier.md b/.changelog/v0.51.0/improvements/1097-detach-client-state-verifier.md
similarity index 100%
rename from .changelog/unreleased/improvements/1097-detach-client-state-verifier.md
rename to .changelog/v0.51.0/improvements/1097-detach-client-state-verifier.md
diff --git a/.changelog/unreleased/improvements/1101-use-let-else-over-downcast.md b/.changelog/v0.51.0/improvements/1101-use-let-else-over-downcast.md
similarity index 100%
rename from .changelog/unreleased/improvements/1101-use-let-else-over-downcast.md
rename to .changelog/v0.51.0/improvements/1101-use-let-else-over-downcast.md
diff --git a/.changelog/unreleased/improvements/1120-rm-redundant-shadowing.md b/.changelog/v0.51.0/improvements/1120-rm-redundant-shadowing.md
similarity index 100%
rename from .changelog/unreleased/improvements/1120-rm-redundant-shadowing.md
rename to .changelog/v0.51.0/improvements/1120-rm-redundant-shadowing.md
diff --git a/.changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md b/.changelog/v0.51.0/improvements/1123-remove-check-for-unitialized-connection-end-state.md
similarity index 100%
rename from .changelog/unreleased/improvements/1123-remove-check-for-unitialized-connection-end-state.md
rename to .changelog/v0.51.0/improvements/1123-remove-check-for-unitialized-connection-end-state.md
diff --git a/.changelog/unreleased/improvements/394-remove-order-match.md b/.changelog/v0.51.0/improvements/394-remove-order-match.md
similarity index 100%
rename from .changelog/unreleased/improvements/394-remove-order-match.md
rename to .changelog/v0.51.0/improvements/394-remove-order-match.md
diff --git a/.changelog/v0.51.0/summary.md b/.changelog/v0.51.0/summary.md
new file mode 100644
index 000000000..ab4260e79
--- /dev/null
+++ b/.changelog/v0.51.0/summary.md
@@ -0,0 +1,11 @@
+This release introduces a few changes for better customizability. The main one is modularizing ICS-24, ICS-02, and ICS-07 trait implementations. This change empowers developers to write Rust light clients succinctly in a smart-contract context like CosmWasm. Also, the default Tendermint client state verifier is now detached to support custom verifiers, if required.
+
+In addition, this version fixes a bug where the consensus state is incorrectly stored when a header with an older height is submitted.
+
+Furthermore, a set of new host keys is added. This makes `ibc-rs` more consistent with the storage access of `ibc-go`. Also, access to client update information is merged into a single method; instead of individual details.
+
+This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`.
+
+Finally, the minimum supported Rust version is corrected and updated to `1.71.1`.
+
+There are no consensus-breaking changes.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7b962fb25..3d9a3c07d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,93 @@
 # CHANGELOG
 
+## v0.51.0
+
+*March 22, 2024*
+
+This release introduces a few changes for better customizability. The main one is modularizing ICS-24, ICS-02, and ICS-07 trait implementations. This change empowers developers to write Rust light clients succinctly in a smart-contract context like CosmWasm. Also, the default Tendermint client state verifier is now detached to support custom verifiers, if required.
+
+In addition, this version fixes a bug where the consensus state is incorrectly stored when a header with an older height is submitted.
+
+Furthermore, a set of new host keys is added. This makes `ibc-rs` more consistent with the storage access of `ibc-go`. Also, access to client update information is merged into a single method; instead of individual details.
+
+This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`.
+
+Finally, the minimum supported Rust version is corrected and updated to `1.71.1`.
+
+There are no consensus-breaking changes.
+
+### BREAKING CHANGES
+
+- [ibc-core] Update `MsgUpdateClient` handler to accept misbehaviour reports via
+  its `client_message` field
+  ([\#835](https://github.com/cosmos/ibc-rs/issues/835))
+- [ibc-core-client] Merge client update time and height modification method
+  pairs into one, that is replace
+  a) client_update_{time,height} by update_meta,
+  b) store_update_{time,height} by store_update_meta and
+  c) delete_update_{time,height} by delete_update_meta.
+  ([\#973](https://github.com/cosmos/ibc-rs/issues/973))
+- [ibc] Refactor client relevant APIs for improved modularity and allow
+  standalone ICS-02 integration
+  ([\#1114](https://github.com/cosmos/ibc-rs/issues/1114))
+- [ibc] Increase minimum supported Rust version to 1.71.1
+  ([\#1118](https://github.com/cosmos/ibc-rs/issues/1118))
+- [ibc] Upgrade `ibc-proto-rs` to `v0.42.2`
+  ([\#1125](https://github.com/cosmos/ibc-rs/pull/1125))
+
+### BUG FIXES
+
+- [ibc] Add missing dependencies for some feature flags across multiple crates
+  ([\#1059](https://github.com/cosmos/ibc-rs/issues/1059))
+- [ibc-client-tendermint-types] Ease frozen Height check in the tendermint
+  `ClientState` protobuf deserialization, and consequently include frozen client
+  check for client creation path.
+  ([\#1061](https://github.com/cosmos/ibc-rs/issues/1061)),
+  ([\#1063](https://github.com/cosmos/ibc-rs/pull/1063))
+- [ibc-client-tendermint] Use header height for Tendermint consensus state storage
+  ([\#1080](https://github.com/cosmos/ibc-rs/issues/1080))
+- [ibc] Upgrade `serde_json` to "1.0.1" to address an stack overflow issue
+  within the `serde-json-wasm` crate
+  ([\#1083](https://github.com/cosmos/ibc-rs/pull/1083))
+- [ibc] Resolve potential `base64` dependency resolution issue by bringing it to
+  the workspace `Cargo.toml`
+  ([\#1084](https://github.com/cosmos/ibc-rs/issues/1084))
+- [ibc-client-tendermint-types] Check ics23 proof specs for empty depth range.
+  ([\#1100](https://github.com/cosmos/ibc-rs/issues/1100))
+
+### FEATURE
+
+- [ibc-core-host] Add remaining storage paths.
+  ([\#1065](https://github.com/cosmos/ibc-rs/issues/1065))
+- [ibc-core-host] Add iteration key for cross-compatibility with `ibc-go` used
+  for iterating over consensus states
+  ([\#1090](https://github.com/cosmos/ibc-rs/issues/1090))
+
+### IMPROVEMENTS
+
+- [ibc-core] Deprecate `ChannelEnd::order_matches` method
+  ([\#394](https://github.com/cosmos/ibc-rs/issues/394))
+- [ibc-apps] Ease `serde` derive on `ICS-20` and `ICS-721` types
+  ([\#1060](https://github.com/cosmos/ibc-rs/pull/1060))
+- [ibc-data-types] Refactor `Default` implementations with concrete names
+  ([\#1074](https://github.com/cosmos/ibc-rs/issues/1074))
+- [ibc-core] Deprecate `MsgSubmitMisbehaviour` in favor of `MsgUpdateClient` for
+  submitting misbehaviour reports
+  ([\#1077](https://github.com/cosmos/ibc-rs/issues/1077))
+- [ibc-core-host] Improve path segment access by exposing path prefixes and
+  implementing some convenient parent/leaf methods
+  ([\#1089](https://github.com/cosmos/ibc-rs/issues/1089))
+- [ibc-client-tendermint] Detach client state verifier such that users have a
+  way to utilize custom verifiers
+  ([\#1097](https://github.com/cosmos/ibc-rs/pull/1097))
+- [ibc-primitives] Use `let-else` over `downcast!()` and remove `utils/macros`
+  module as a result ([\#1118](https://github.com/cosmos/ibc-rs/issues/1118))
+- [ibc-core] Remove unnecessary shadowing with same value
+  ([\#1120](https://github.com/cosmos/ibc-rs/issues/1120))
+- [ibc-core-connection] Remove `State::Uninitialized` check while parsing
+  `ConnectionEnd` from Protobuf
+  ([\#1123](https://github.com/cosmos/ibc-rs/issues/1123))
+
 ## v0.50.0
 
 *January 24, 2024*
diff --git a/Cargo.toml b/Cargo.toml
index 946a3efdc..7f4e21941 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -40,7 +40,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.50.0"
+version      = "0.51.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.71.1"
@@ -62,36 +62,36 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.1", default-
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.50.0", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.50.0", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.50.0", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.50.0", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.50.0", path = "./ibc-primitives", default-features = false }
+ibc                 = { version = "0.51.0", path = "./ibc", default-features = false }
+ibc-core            = { version = "0.51.0", path = "./ibc-core", default-features = false }
+ibc-clients         = { version = "0.51.0", path = "./ibc-clients", default-features = false }
+ibc-apps            = { version = "0.51.0", path = "./ibc-apps", default-features = false }
+ibc-primitives      = { version = "0.51.0", path = "./ibc-primitives", default-features = false }
 ibc-derive          = { version = "0.6.0", path = "./ibc-derive" }
 
-ibc-core-client       = { version = "0.50.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.50.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.50.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.50.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.50.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.50.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.50.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.50.0", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer  = { version = "0.50.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-core-client       = { version = "0.51.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection   = { version = "0.51.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel      = { version = "0.51.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host         = { version = "0.51.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler      = { version = "0.51.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router       = { version = "0.51.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-client-tendermint = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-app-transfer      = { version = "0.51.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer  = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.50.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.50.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.50.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.50.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.50.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.50.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.50.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.50.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.50.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.50.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-client-wasm-types       = { version = "0.50.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.50.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
-ibc-app-nft-transfer-types  = { version = "0.50.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.51.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.51.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.51.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.51.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.51.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.51.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.51.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.51.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.51.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-client-wasm-types       = { version = "0.51.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.51.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-app-nft-transfer-types  = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.42.2", default-features = false }
 
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index d191ea07d..cc49e5efa 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -569,7 +569,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -578,7 +578,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -593,14 +593,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -615,7 +615,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -629,7 +629,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -650,7 +650,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -662,7 +662,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -677,7 +677,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -695,7 +695,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -711,7 +711,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -722,7 +722,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -741,7 +741,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -755,7 +755,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -777,7 +777,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -794,7 +794,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -807,7 +807,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -820,7 +820,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -846,7 +846,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index e430db282..b2c10bc28 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1263,7 +1263,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1275,7 +1275,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1284,7 +1284,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1297,14 +1297,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "ibc-client-tendermint-types",
@@ -1320,7 +1320,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1336,7 +1336,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-wasm-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "base64 0.21.7",
  "displaydoc",
@@ -1349,7 +1349,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-client-tendermint",
  "ibc-client-wasm-types",
@@ -1357,7 +1357,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1372,7 +1372,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1386,7 +1386,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1404,7 +1404,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1416,7 +1416,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1431,7 +1431,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1446,7 +1446,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1459,7 +1459,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1470,7 +1470,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1486,7 +1486,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1500,7 +1500,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1519,7 +1519,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1536,7 +1536,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1558,7 +1558,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1568,7 +1568,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1581,7 +1581,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1604,7 +1604,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.50.0"
+version = "0.51.0"
 dependencies = [
  "derive_more",
  "displaydoc",

From 6f4c52c0d40eb26081c13297154b140f75464331 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Mon, 25 Mar 2024 16:00:49 +0100
Subject: [PATCH 133/182] fix(ci/release): specify correct environment variable
 (#1140)

* fix release on CI

* add comments
---
 .github/workflows/release.yaml | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index 44c057990..c2eb1fdb2 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -33,8 +33,6 @@ jobs:
         uses: Swatinem/rust-cache@v2
       - name: Publish crates (dry run)
         run: make check-release
-        env:
-          CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
 
   publish:
     if: github.ref_type == 'tag'
@@ -50,7 +48,9 @@ jobs:
       - name: Publish crates
         run: yes | make release
         env:
-          CRATES_TOKEN: ${{ secrets.CRATES_TOKEN }}
+          # https://doc.rust-lang.org/cargo/commands/cargo-publish.html#options
+          # argument for `--token` is specified with this environment variable
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
 
   gh-release:
     if: github.ref_type == 'tag'

From aa9c9a82768eff96629486e6227353ba4c3b6e9c Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 25 Mar 2024 09:33:55 -0700
Subject: [PATCH 134/182] fix: make client response fields public + remove
 reduntant QueryConnectionChannelsRequest (#1139)

---
 ibc-query/src/core/client/types/response.rs   | 26 ++++++++--------
 .../src/core/connection/types/request.rs      | 31 -------------------
 2 files changed, 13 insertions(+), 44 deletions(-)

diff --git a/ibc-query/src/core/client/types/response.rs b/ibc-query/src/core/client/types/response.rs
index 587fe2127..a1339d3a5 100644
--- a/ibc-query/src/core/client/types/response.rs
+++ b/ibc-query/src/core/client/types/response.rs
@@ -165,9 +165,9 @@ impl From<IdentifiedClientState> for RawIdentifiedClientState {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryConsensusStateResponse {
-    consensus_state: Any,
-    proof: Proof,
-    proof_height: Height,
+    pub consensus_state: Any,
+    pub proof: Proof,
+    pub proof_height: Height,
 }
 
 impl QueryConsensusStateResponse {
@@ -213,8 +213,8 @@ impl From<QueryConsensusStateResponse> for RawQueryConsensusStateResponse {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct ConsensusStateWithHeight {
-    height: Height,
-    consensus_state: Any,
+    pub height: Height,
+    pub consensus_state: Any,
 }
 
 impl ConsensusStateWithHeight {
@@ -257,8 +257,8 @@ impl From<ConsensusStateWithHeight> for RawConsensusStateWithHeight {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryConsensusStatesResponse {
-    consensus_states: Vec<ConsensusStateWithHeight>,
-    pagination: Option<PageResponse>,
+    pub consensus_states: Vec<ConsensusStateWithHeight>,
+    pub pagination: Option<PageResponse>,
 }
 
 impl QueryConsensusStatesResponse {
@@ -308,8 +308,8 @@ impl From<QueryConsensusStatesResponse> for RawQueryConsensusStatesResponse {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryConsensusStateHeightsResponse {
-    consensus_state_heights: Vec<Height>,
-    pagination: Option<PageResponse>,
+    pub consensus_state_heights: Vec<Height>,
+    pub pagination: Option<PageResponse>,
 }
 
 impl QueryConsensusStateHeightsResponse {
@@ -356,7 +356,7 @@ impl From<QueryConsensusStateHeightsResponse> for RawQueryConsensusStateHeightsR
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryClientStatusResponse {
-    status: Status,
+    pub status: Status,
 }
 
 impl QueryClientStatusResponse {
@@ -390,7 +390,7 @@ impl From<QueryClientStatusResponse> for RawQueryClientStatusResponse {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryClientParamsResponse {
-    allowed_clients: Vec<ClientId>,
+    pub allowed_clients: Vec<ClientId>,
 }
 
 impl QueryClientParamsResponse {
@@ -436,7 +436,7 @@ impl From<QueryClientParamsResponse> for RawQueryClientParamsResponse {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryUpgradedClientStateResponse {
-    upgraded_client_state: Any,
+    pub upgraded_client_state: Any,
 }
 
 impl QueryUpgradedClientStateResponse {
@@ -474,7 +474,7 @@ impl From<QueryUpgradedClientStateResponse> for RawQueryUpgradedClientStateRespo
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryUpgradedConsensusStateResponse {
-    upgraded_consensus_state: Any,
+    pub upgraded_consensus_state: Any,
 }
 
 impl QueryUpgradedConsensusStateResponse {
diff --git a/ibc-query/src/core/connection/types/request.rs b/ibc-query/src/core/connection/types/request.rs
index ad11e62f5..e62262adf 100644
--- a/ibc-query/src/core/connection/types/request.rs
+++ b/ibc-query/src/core/connection/types/request.rs
@@ -4,7 +4,6 @@
 use ibc::core::client::types::Height;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::primitives::prelude::*;
-use ibc_proto::ibc::core::channel::v1::QueryConnectionChannelsRequest as RawQueryConnectionChannelsRequest;
 use ibc_proto::ibc::core::connection::v1::{
     QueryClientConnectionsRequest as RawQueryClientConnectionsRequest,
     QueryConnectionClientStateRequest as RawQueryConnectionClientStateRequest,
@@ -129,33 +128,3 @@ impl From<RawQueryConnectionParamsRequest> for QueryConnectionParamsRequest {
         Self { query_height: None }
     }
 }
-
-/// Defines the RPC method request type for querying the channels associated
-/// with a connection.
-#[derive(Clone, Debug)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-pub struct QueryConnectionChannelsRequest {
-    pub connection_id: ConnectionId,
-    pub pagination: Option<PageRequest>,
-}
-
-impl TryFrom<RawQueryConnectionChannelsRequest> for QueryConnectionChannelsRequest {
-    type Error = QueryError;
-
-    fn try_from(request: RawQueryConnectionChannelsRequest) -> Result<Self, Self::Error> {
-        Ok(Self {
-            connection_id: request.connection.parse()?,
-            pagination: request.pagination.map(Into::into),
-        })
-    }
-}
-
-impl From<QueryConnectionChannelsRequest> for RawQueryConnectionChannelsRequest {
-    fn from(request: QueryConnectionChannelsRequest) -> Self {
-        Self {
-            connection: request.connection_id.to_string(),
-            pagination: request.pagination.map(Into::into),
-        }
-    }
-}

From 5407030c40d53c7e84ac7c94cfe761ecafbdfa30 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 26 Mar 2024 16:57:57 +0100
Subject: [PATCH 135/182] Release v0.51.0 (#1141)

* bump ibc-derive patch version

* update community call info

* run release jobs in seq

* update adr toc

* publish-check and publish never run together

* format

* fix community call frequency

Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* minor changes in changelog

* update ADR status

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .changelog/v0.51.0/summary.md                 |  2 +-
 .github/workflows/release.yaml                |  1 +
 CHANGELOG.md                                  |  5 ++---
 Cargo.toml                                    |  2 +-
 README.md                                     | 15 +++++++-------
 docs/architecture/README.md                   | 20 ++++++++++---------
 .../adr-008-restructure-ibc-crate.md          |  2 +-
 ...010-enable-standalone-ics02-integration.md |  2 +-
 ibc-derive/Cargo.toml                         |  2 +-
 9 files changed, 27 insertions(+), 24 deletions(-)

diff --git a/.changelog/v0.51.0/summary.md b/.changelog/v0.51.0/summary.md
index ab4260e79..98bae05bc 100644
--- a/.changelog/v0.51.0/summary.md
+++ b/.changelog/v0.51.0/summary.md
@@ -4,7 +4,7 @@ In addition, this version fixes a bug where the consensus state is incorrectly s
 
 Furthermore, a set of new host keys is added. This makes `ibc-rs` more consistent with the storage access of `ibc-go`. Also, access to client update information is merged into a single method; instead of individual details.
 
-This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`.
+This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`. Also, `ibc-derive` dependency is updated to `v0.6.1`.
 
 Finally, the minimum supported Rust version is corrected and updated to `1.71.1`.
 
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index c2eb1fdb2..ade278800 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -54,6 +54,7 @@ jobs:
 
   gh-release:
     if: github.ref_type == 'tag'
+    needs: publish
     name: Create GitHub release
     runs-on: ubuntu-latest
     permissions:
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3d9a3c07d..2298b234b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
 
 ## v0.51.0
 
-*March 22, 2024*
+*March 26, 2024*
 
 This release introduces a few changes for better customizability. The main one is modularizing ICS-24, ICS-02, and ICS-07 trait implementations. This change empowers developers to write Rust light clients succinctly in a smart-contract context like CosmWasm. Also, the default Tendermint client state verifier is now detached to support custom verifiers, if required.
 
@@ -10,8 +10,7 @@ In addition, this version fixes a bug where the consensus state is incorrectly s
 
 Furthermore, a set of new host keys is added. This makes `ibc-rs` more consistent with the storage access of `ibc-go`. Also, access to client update information is merged into a single method; instead of individual details.
 
-This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`.
-
+This release updates the `ibc-proto-rs` dependency to `v0.42.2`. This takes account of the updated `MsgUpdateClient` and deprecates `MsgSubmitMisbehaviour`. Also, `ibc-derive` dependency is updated to `v0.6.1`.
 Finally, the minimum supported Rust version is corrected and updated to `1.71.1`.
 
 There are no consensus-breaking changes.
diff --git a/Cargo.toml b/Cargo.toml
index 7f4e21941..3b04052e5 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -67,7 +67,7 @@ ibc-core            = { version = "0.51.0", path = "./ibc-core", default-feature
 ibc-clients         = { version = "0.51.0", path = "./ibc-clients", default-features = false }
 ibc-apps            = { version = "0.51.0", path = "./ibc-apps", default-features = false }
 ibc-primitives      = { version = "0.51.0", path = "./ibc-primitives", default-features = false }
-ibc-derive          = { version = "0.6.0", path = "./ibc-derive" }
+ibc-derive          = { version = "0.6.1", path = "./ibc-derive" }
 
 ibc-core-client       = { version = "0.51.0", path = "./ibc-core/ics02-client", default-features = false }
 ibc-core-connection   = { version = "0.51.0", path = "./ibc-core/ics03-connection", default-features = false }
diff --git a/README.md b/README.md
index 226f0a49e..e6412b710 100644
--- a/README.md
+++ b/README.md
@@ -52,13 +52,14 @@ community contributions!
 
 ## Community calls
 
-We run monthly community calls to update the community with current our
-direction and gather feedback on what to work on next. The community calls are
-also a platform for you to update everyone else with what you're working on, and
-find opportunities to collaborate.
-
-Please join the [Google group](https://groups.google.com/g/ibc-rs-community) to
-receive a calendar invitation for the monthly meeting.
+The IBC-rs community calls are now part of the IBC Core community calls. During
+these calls, we update the community on our current direction and gather
+feedback on what to work on next. The community calls are also a platform for
+you to update everyone else on what you're working on and find opportunities to
+collaborate.
+
+Please join the [Google group](https://groups.google.com/g/ibc-community) to
+receive a calendar invitation to the monthly meetings.
 
 ## Versioning
 
diff --git a/docs/architecture/README.md b/docs/architecture/README.md
index 181417010..8e4d40e1e 100644
--- a/docs/architecture/README.md
+++ b/docs/architecture/README.md
@@ -25,12 +25,14 @@ To suggest an ADR, please make use of the [ADR template](./adr-template.md) prov
 
 ## Table of Contents
 
-| ADR \#                                             | Description                                           | Status   |
-|----------------------------------------------------|-------------------------------------------------------|----------|
-| [001](./adr-001-handler-implementation.md)         | IBC handlers implementation                           | Accepted |
-| [002](./adr-002-error.md)                          | Error Management                                      | Accepted |
-| [003](./adr-003-ics20-implementation.md)           | ICS20 implementation                                  | Accepted |
-| [004](./adr-004-light-client-crates-extraction.md) | Light client crates extraction                        | Accepted |
-| [005](./adr-005-handlers-redesign.md)              | Handlers validation and execution separation          | Accepted |
-| [006](./adr-006-upgrade-client-implementation.md)  | Chain and client upgradability                        | Accepted |
-| [007](./adr-007-light-client-contexts.md)          | Light client contexts                                 | Accepted |
+| ADR \#                                                  | Description                                  | Status   |
+| ------------------------------------------------------- | -------------------------------------------- | -------- |
+| [001](./adr-001-handler-implementation.md)              | IBC handlers implementation                  | Accepted |
+| [002](./adr-002-error.md)                               | Error Management                             | Accepted |
+| [003](./adr-003-ics20-implementation.md)                | ICS20 implementation                         | Accepted |
+| [004](./adr-004-light-client-crates-extraction.md)      | Light client crates extraction               | Accepted |
+| [005](./adr-005-handlers-redesign.md)                   | Handlers validation and execution separation | Accepted |
+| [006](./adr-006-upgrade-client-implementation.md)       | Chain and client upgradability               | Accepted |
+| [007](./adr-007-light-client-contexts.md)               | Light client contexts                        | Accepted |
+| [008](./adr-008-restructure-ibc-crate.md)               | Restructure `ibc` crate                      | Accepted |
+| [010](./adr-010-enable-standalone-ics02-integration.md) | Enable standalone `ics-02` integration       | Accepted |
diff --git a/docs/architecture/adr-008-restructure-ibc-crate.md b/docs/architecture/adr-008-restructure-ibc-crate.md
index 45c7be6e8..7e32a41ed 100644
--- a/docs/architecture/adr-008-restructure-ibc-crate.md
+++ b/docs/architecture/adr-008-restructure-ibc-crate.md
@@ -162,7 +162,7 @@ the release process as well.
 
 ## **Status**
 
-Proposed
+Accepted
 
 ## **Consequences**
 
diff --git a/docs/architecture/adr-010-enable-standalone-ics02-integration.md b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
index 117bea108..913aa0c70 100644
--- a/docs/architecture/adr-010-enable-standalone-ics02-integration.md
+++ b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
@@ -6,7 +6,7 @@
 
 ## Status
 
-Proposed
+Accepted
 
 ## Context
 
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 830595fbd..3161d8d1c 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name        = "ibc-derive"
-version     = "0.6.0"
+version     = "0.6.1"
 license     = { workspace = true }
 repository  = { workspace = true }
 edition     = { workspace = true }

From 1f158bbe242faffefabf6d3f794ce2bcb915858b Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 27 Mar 2024 17:56:40 +0100
Subject: [PATCH 136/182] chore(ci): fix broken links in markdown files (#1143)

* trigger on markdown files

* update markdown link check

* comment on cron expr

* fix links in epilogue

* fix ibc-rs issue links

* fix links in adr-006

* fix contributing link on ibc-clients

* links depend on project structure

* fix links in changelog

* suppress verbosity

* fix ibc-go links

* check docs links only in pr

* rm redundant URI fragments
---
 .changelog/epilogue.md                        |  4 ++--
 ...61-add-getter-function-of-prefixeddenom.md |  4 ++--
 .../166-channel-proof-verification.md         |  4 ++--
 ...393-finish-validation-execution-context.md |  4 ++--
 .../breaking-changes/279-remove-legacy-api.md |  4 ++--
 .../v0.33.0/improvement/547-error-strings.md  |  4 ++--
 .../v0.34.0/bug/550-fix-conn-proof-verify.md  |  4 ++--
 .github/workflows/markdown-link-check.yml     | 11 +++++-----
 CHANGELOG.md                                  |  4 ++--
 .../adr-006-upgrade-client-implementation.md  | 20 +++++++++----------
 ibc-clients/README.md                         |  2 +-
 11 files changed, 33 insertions(+), 32 deletions(-)

diff --git a/.changelog/epilogue.md b/.changelog/epilogue.md
index ac475d976..3df319cee 100644
--- a/.changelog/epilogue.md
+++ b/.changelog/epilogue.md
@@ -193,7 +193,7 @@
 
 - Delete packet commitment instead of acknowledgement in acknowledgePacket
   [#1573](https://github.com/informalsystems/ibc-rs/issues/1573)
-- Set the `counterparty_channel_id` correctly to fix ICS04 [`chanOpenAck` handler verification](https://github.com/cosmos/ibc-rs/blob/main/crates/ibc/src/core/ics04_channel/handler/chan_open_ack.rs)
+- Set the `counterparty_channel_id` correctly to fix ICS04 [`chanOpenAck` handler verification](https://github.com/cosmos/ibc-rs/blob/v0.10.0/modules/src/core/ics04_channel/handler/chan_open_ack.rs)
   ([#1649](https://github.com/informalsystems/ibc-rs/issues/1649))
 - Add missing assertion for non-zero trust-level in Tendermint client initialization.
   ([#1697](https://github.com/informalsystems/ibc-rs/issues/1697))
@@ -220,7 +220,7 @@
 - Set the connection counterparty in the ICS 003 [`connOpenAck` handler][conn-open-ack-handler]
   ([#1532](https://github.com/informalsystems/ibc-rs/issues/1532))
 
-[conn-open-ack-handler]: https://github.com/cosmos/ibc-rs/blob/main/crates/ibc/src/core/ics03_connection/handler/conn_open_ack.rs
+[conn-open-ack-handler]: https://github.com/cosmos/ibc-rs/blob/v0.9.0/modules/src/core/ics03_connection/handler/conn_open_ack.rs
 
 ### IMPROVEMENTS
 
diff --git a/.changelog/v0.20.0/feature/161-add-getter-function-of-prefixeddenom.md b/.changelog/v0.20.0/feature/161-add-getter-function-of-prefixeddenom.md
index 428eaf8ce..3f6376122 100644
--- a/.changelog/v0.20.0/feature/161-add-getter-function-of-prefixeddenom.md
+++ b/.changelog/v0.20.0/feature/161-add-getter-function-of-prefixeddenom.md
@@ -1,2 +1,2 @@
-- Public PrefixedDenom inner type and add as_str func for BaseDenom ([#161](https://github.com/cosmos/ibc-
-  rs/issues/161))
\ No newline at end of file
+- Public PrefixedDenom inner type and add as_str func for BaseDenom
+  ([#161](https://github.com/cosmos/ibc-rs/issues/161))
diff --git a/.changelog/v0.22.0/breaking-changes/166-channel-proof-verification.md b/.changelog/v0.22.0/breaking-changes/166-channel-proof-verification.md
index 77f5ef3a8..da9fa2779 100644
--- a/.changelog/v0.22.0/breaking-changes/166-channel-proof-verification.md
+++ b/.changelog/v0.22.0/breaking-changes/166-channel-proof-verification.md
@@ -1,3 +1,3 @@
 - Refactor channel handlers. Proof calls were inlined, and our handshake
-  variable naming convention was applied ([#166](https://github.com/cosmos/ibc-
-  rs/issues/166))
\ No newline at end of file
+  variable naming convention was applied
+  ([#166](https://github.com/cosmos/ibc-rs/issues/166))
diff --git a/.changelog/v0.28.0/feature/393-finish-validation-execution-context.md b/.changelog/v0.28.0/feature/393-finish-validation-execution-context.md
index a9981e46b..464a9df92 100644
--- a/.changelog/v0.28.0/feature/393-finish-validation-execution-context.md
+++ b/.changelog/v0.28.0/feature/393-finish-validation-execution-context.md
@@ -1,3 +1,3 @@
 - Finish implementing ValidationContext::validate() and
-  ExecutionContext::execute() ([#393](https://github.com/cosmos/ibc-
-  rs/issues/393))
\ No newline at end of file
+  ExecutionContext::execute()
+  ([#393](https://github.com/cosmos/ibc-rs/issues/393))
diff --git a/.changelog/v0.29.0/breaking-changes/279-remove-legacy-api.md b/.changelog/v0.29.0/breaking-changes/279-remove-legacy-api.md
index 74e43597b..5fe71954e 100644
--- a/.changelog/v0.29.0/breaking-changes/279-remove-legacy-api.md
+++ b/.changelog/v0.29.0/breaking-changes/279-remove-legacy-api.md
@@ -1,2 +1,2 @@
-- Remove Reader and Keeper API ([#279](https://github.com/cosmos/ibc-
-  rs/issues/279))
\ No newline at end of file
+- Remove Reader and Keeper API
+  ([#279](https://github.com/cosmos/ibc-rs/issues/279))
diff --git a/.changelog/v0.33.0/improvement/547-error-strings.md b/.changelog/v0.33.0/improvement/547-error-strings.md
index d019bc189..661201f75 100644
--- a/.changelog/v0.33.0/improvement/547-error-strings.md
+++ b/.changelog/v0.33.0/improvement/547-error-strings.md
@@ -1,2 +1,2 @@
-- Fix ContextError Display output ([#547](https://github.com/cosmos/ibc-
-  rs/issues/547))
\ No newline at end of file
+- Fix ContextError Display output
+  ([#547](https://github.com/cosmos/ibc-rs/issues/547))
diff --git a/.changelog/v0.34.0/bug/550-fix-conn-proof-verify.md b/.changelog/v0.34.0/bug/550-fix-conn-proof-verify.md
index a92bc24fb..0368dd262 100644
--- a/.changelog/v0.34.0/bug/550-fix-conn-proof-verify.md
+++ b/.changelog/v0.34.0/bug/550-fix-conn-proof-verify.md
@@ -1,2 +1,2 @@
-- Fix client IDs for the proof verifications in `ConnectionOpenTry` and `ConnectionOpenAck` ([#550](https://github.com/cosmos/ibc-
-  rs/issues/550))
+- Fix client IDs for the proof verifications in `ConnectionOpenTry` and
+  `ConnectionOpenAck` ([#550](https://github.com/cosmos/ibc-rs/issues/550))
diff --git a/.github/workflows/markdown-link-check.yml b/.github/workflows/markdown-link-check.yml
index 9df23cd42..e3143e575 100644
--- a/.github/workflows/markdown-link-check.yml
+++ b/.github/workflows/markdown-link-check.yml
@@ -2,9 +2,10 @@ name: Check Markdown links
 
 on:
   schedule:
-    - cron: "0 0 * * *"
-
-  workflow_dispatch:
+    - cron: "0 0 * * *" # At 00:00
+  push:
+    branches: main
+  pull_request:
 
 jobs:
   md-link-check:
@@ -12,8 +13,8 @@ jobs:
     steps:
       - uses: actions/checkout@v2
       - name: markdown-link-check
-        uses: gaurav-nelson/github-action-markdown-link-check@1.0.13
+        uses: gaurav-nelson/github-action-markdown-link-check@1.0.15
         with:
           config-file: ".github/markdown-link-check.json"
           use-quiet-mode: "yes"
-          use-verbose-mode: "yes"
+          folder-path: ${{ github.event_name == 'pull_request' && 'docs' || '.' }}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2298b234b..63a24bed5 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1427,7 +1427,7 @@ This is a major release, which implemented [ADR 4](https://github.com/cosmos/ibc
 
 - Delete packet commitment instead of acknowledgement in acknowledgePacket
   [#1573](https://github.com/informalsystems/ibc-rs/issues/1573)
-- Set the `counterparty_channel_id` correctly to fix ICS04 [`chanOpenAck` handler verification](https://github.com/informalsystems/ibc-rs/blob/master/modules/src/core/ics04_channel/handler/chan_open_ack.rs)
+- Set the `counterparty_channel_id` correctly to fix ICS04 [`chanOpenAck` handler verification](https://github.com/informalsystems/ibc-rs/blob/v0.10.0/modules/src/core/ics04_channel/handler/chan_open_ack.rs)
   ([#1649](https://github.com/informalsystems/ibc-rs/issues/1649))
 - Add missing assertion for non-zero trust-level in Tendermint client initialization.
   ([#1697](https://github.com/informalsystems/ibc-rs/issues/1697))
@@ -1454,7 +1454,7 @@ This is a major release, which implemented [ADR 4](https://github.com/cosmos/ibc
 - Set the connection counterparty in the ICS 003 [`connOpenAck` handler][conn-open-ack-handler]
   ([#1532](https://github.com/informalsystems/ibc-rs/issues/1532))
 
-[conn-open-ack-handler]: https://github.com/informalsystems/ibc-rs/blob/master/modules/src/core/ics03_connection/handler/conn_open_ack.rs
+[conn-open-ack-handler]: https://github.com/informalsystems/ibc-rs/blob/v0.9.0/modules/src/core/ics03_connection/handler/conn_open_ack.rs
 
 ### IMPROVEMENTS
 
diff --git a/docs/architecture/adr-006-upgrade-client-implementation.md b/docs/architecture/adr-006-upgrade-client-implementation.md
index 9d8137409..d1aa8fc86 100644
--- a/docs/architecture/adr-006-upgrade-client-implementation.md
+++ b/docs/architecture/adr-006-upgrade-client-implementation.md
@@ -20,7 +20,7 @@ justify the chain-wide logic behind upgrading light clients, list requisites for
 validation and execution steps, determine the boundary between basic and
 upgrade-specific validations by an IBC handler, and explain Tendermint's upgrade
 client implementation within the
-[ics07_tendermint](../../ibc/src/clients/ics07_tendermint).
+[ics07_tendermint](../../ibc-clients/ics07-tendermint).
 
 ## Decision
 
@@ -41,9 +41,9 @@ we will explain how we have implemented this rationale in IBC-rs.
 * There **MUST** be a proof verification process to check upgraded client and
   consensus states against the host chain's state.
 * Chain upgrades **MUST NOT** result in changing
-  [ClientState](../../ibc/src/core/ics02_client/client_state.rs#ClientState)
+  [ClientState](../../ibc-core/ics02-client/context/src/client_state.rs)
   or
-  [ConsensusState](../../ibc/src/core/ics02_client/consensus_state.rs#ConsensusState)
+  [ConsensusState](../../ibc-core/ics02-client/context/src/consensus_state.rs)
   implementations
 * It is **UP TO** the chain's architecture how upgraded client and consensus
   states are committed, either through decentralized approaches, like governance
@@ -104,9 +104,9 @@ supported by `IBC-rs`:
    recommended that chains reduce the unbonding period.
 7. (P) Changing the Tendermint LightClient algorithm: Changes to the light
    client algorithm that do not change the
-   [ClientState](../../ibc/src/clients/ics07_tendermint/client_state.rs#ClientState)
+   [ClientState](../../ibc-clients/ics07-tendermint/src/client_state.rs)
    or
-   [ConsensusState](../../ibc/src/clients/ics07_tendermint/consensus_state.rs#ConsensusState)
+   [ConsensusState](../../ibc-clients/ics07-tendermint/src/consensus_state.rs)
    struct abstraction may be supported, provided that the counterparty is also
    upgraded to support the new light client algorithm. Changes that require
    updating the `ClientState` and `ConsensusState` structs themselves are
@@ -131,7 +131,7 @@ is entirely handled.
 
 1. Upgrade chain through governance
    1. Create a 02-client
-      [UpgradeProposal](https://github.com/cosmos/ibc-go/blob/main/docs/ibc/proto-docs.md#upgradeproposal)
+      [UpgradeProposal](https://github.com/cosmos/ibc-go/blob/main/docs/docs/01-ibc/09-proto-docs.md#upgradeproposal)
       with an `UpgradePlan` and a new IBC `ClientState` in the
       `UpgradedClientState` field with the following remarks:
         * The `UpgradePlan` must specify an upgrade height only (no upgrade
@@ -206,7 +206,7 @@ validations (SV) and lastly execution (E) steps as follows:
 
 Whenever the IBC handler receives an `MsgUpgradeClient`, it dispatches the
 decoded message to the router and triggers the
-[process](../../ibc/src/core/ics02_client/handler/upgrade_client.rs#process)
+[process](../../ibc-core/ics02-client/src/handler/upgrade_client.rs)
 function of `upgrade_client` handler, which would go through the steps outlined
 in 3rd section of [Upgrade Process Step-by-Step](#upgrade-process-step-by-step).
 Just note that the `process` function will be rendered into `validate` and
@@ -419,13 +419,13 @@ Accepted
 ## References
 
 * [How to Upgrade IBC Chains and their
-  Clients](https://github.com/cosmos/ibc-go/blob/main/docs/ibc/upgrades/quick-guide.md)
+  Clients](https://github.com/cosmos/ibc-go/blob/main/docs/docs/01-ibc/05-upgrades/01-quick-guide.md)
 * [IBC Client Developer Guide to
-  Upgrades](https://github.com/cosmos/ibc-go/blob/main/docs/ibc/upgrades/developer-guide.md)
+  Upgrades](https://github.com/cosmos/ibc-go/blob/main/docs/docs/01-ibc/05-upgrades/02-developer-guide.md)
 * [cosmos/ibc-go/Issue 445: IBC upgrade plan
   summary](https://github.com/cosmos/ibc/issues/445)
 * [cosmos/cosmos-sdk/PR 7367: Upgrade
-  Client](https://github.com/cosmos/cosmos-sdk/åpull/7367)
+  Client](https://github.com/cosmos/cosmos-sdk/pull/7367)
 * [cosmos/ibc-go/Issue 2501: Create importable workflow for chains to run
   upgrade tests](https://github.com/cosmos/ibc-go/issues/2501)
 * [Hermes relayer documentation: Client
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
index 4c0e32a9d..02b7d3ff1 100644
--- a/ibc-clients/README.md
+++ b/ibc-clients/README.md
@@ -46,5 +46,5 @@ repo](https://github.com/cosmos/ibc). Any protocol changes or clarifications
 should be contributed there.
 
 If you're interested in contributing, please take a look at the
-[CONTRIBUTING](./../../CONTRIBUTING.md) guidelines. We welcome and appreciate
+[CONTRIBUTING](./../CONTRIBUTING.md) guidelines. We welcome and appreciate
 community contributions!

From 987ec42335b3d424346076c030ef02d0eeedc0b9 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 27 Mar 2024 20:56:45 +0100
Subject: [PATCH 137/182] chore(ci): enable `merge_group` trigger from merge
 queue (#1144)

* add merge_group trigger

* run check-features only on merge queue

* check-features on main
---
 .github/workflows/code-quality.yml        | 2 ++
 .github/workflows/cw-check.yaml           | 3 +++
 .github/workflows/markdown-link-check.yml | 2 ++
 .github/workflows/no-std.yaml             | 3 +++
 .github/workflows/rust.yml                | 3 +++
 5 files changed, 13 insertions(+)

diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml
index 24bdad7f5..f2f26b918 100644
--- a/.github/workflows/code-quality.yml
+++ b/.github/workflows/code-quality.yml
@@ -1,6 +1,8 @@
 name: Code Quality Checks
 on:
   pull_request:
+  merge_group:
+    types: [checks_requested]
 
 jobs:
   code-quality:
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index bd5e003e8..38655d83b 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -25,6 +25,9 @@ on:
       - ibc-clients/**
       - ibc-primitives/**
       - ibc-derive/**
+  merge_group:
+    types: [checks_requested]
+
 jobs:
   cw-check:
     runs-on: ubuntu-20.04
diff --git a/.github/workflows/markdown-link-check.yml b/.github/workflows/markdown-link-check.yml
index e3143e575..52a1601ac 100644
--- a/.github/workflows/markdown-link-check.yml
+++ b/.github/workflows/markdown-link-check.yml
@@ -6,6 +6,8 @@ on:
   push:
     branches: main
   pull_request:
+  merge_group:
+    types: [checks_requested]
 
 jobs:
   md-link-check:
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 130b0f7a1..60228dde3 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -29,6 +29,9 @@ on:
       - ibc-clients/**
       - ibc-primitives/**
       - ibc-derive/**
+  merge_group:
+    types: [checks_requested]
+
 jobs:
   check-no-std-panic-conflict:
     name: Check no_std panic conflict
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 45ff97c05..3bdb7811f 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -29,6 +29,8 @@ on:
       - ibc-query/**
       - ibc-testkit/**
       - ibc-derive/**
+  merge_group:
+    types: [checks_requested]
 
 env:
   CARGO_INCREMENTAL: 0
@@ -48,6 +50,7 @@ jobs:
     if: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
 
   check-features:
+    if: ${{ github.event_name != 'pull_request' }}
     name: Check features
     runs-on: ubuntu-latest
     timeout-minutes: 60

From ee1107f65e246668a03b43c7eed9915f565af442 Mon Sep 17 00:00:00 2001
From: Michal Nazarewicz <mina86@mina86.com>
Date: Thu, 28 Mar 2024 14:42:52 +0100
Subject: [PATCH 138/182] tendermint: box headers in Misbehaviour message
 (#1145)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Header type is quite large.  Misbehaviour holds two of those.  This becomes
an issue on platforms with small stack—such as Solana—where keeping (even
temporary) local variable may lead to stack overflow.

Fix that by Boxing each of the headers in the Misbehaviour message.

Co-authored-by: dhruvja <dhruv@iamsizzling.com>
---
 .../improvements/1145-tendermint-boxed-header.md     |  4 ++++
 .../ics07-tendermint/types/src/misbehaviour.rs       | 12 ++++++------
 2 files changed, 10 insertions(+), 6 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1145-tendermint-boxed-header.md

diff --git a/.changelog/unreleased/improvements/1145-tendermint-boxed-header.md b/.changelog/unreleased/improvements/1145-tendermint-boxed-header.md
new file mode 100644
index 000000000..65f090962
--- /dev/null
+++ b/.changelog/unreleased/improvements/1145-tendermint-boxed-header.md
@@ -0,0 +1,4 @@
+- [ibc-client-tendermint-types] Box header fields inside of Misbehaviour type so
+  that the type is smaller (i.e. trade size of the type for heap memory).  This
+  prevents stack overflows on systems with small stack (e.g. Solana).
+  ([\#1145](https://github.com/cosmos/ibc-rs/pull/1145))
diff --git a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
index 68348d0dc..5441ea12a 100644
--- a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
@@ -17,16 +17,16 @@ pub const TENDERMINT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.lightclients.tendermint
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct Misbehaviour {
     client_id: ClientId,
-    header1: Header,
-    header2: Header,
+    header1: Box<Header>,
+    header2: Box<Header>,
 }
 
 impl Misbehaviour {
     pub fn new(client_id: ClientId, header1: Header, header2: Header) -> Self {
         Self {
             client_id,
-            header1,
-            header2,
+            header1: Box::new(header1),
+            header2: Box::new(header2),
         }
     }
 
@@ -98,8 +98,8 @@ impl From<Misbehaviour> for RawMisbehaviour {
         #[allow(deprecated)]
         RawMisbehaviour {
             client_id: value.client_id.to_string(),
-            header_1: Some(value.header1.into()),
-            header_2: Some(value.header2.into()),
+            header_1: Some((*value.header1).into()),
+            header_2: Some((*value.header2).into()),
         }
     }
 }

From b0ea4eab7247c50519099f86f9d2c42db51eed07 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Tue, 2 Apr 2024 16:21:38 -0700
Subject: [PATCH 139/182] imp: flatten arguments of ICS07 Header/Misbehavior
 verification functions (#1150)

* imp: flatten arguments of ICS07 Header/Misbehavior verification functions

* nit: use as_str() to not allocate

* fix: downgrade typos version for code quality job
---
 ...ten-client-message-verification-methods.md |  4 +
 .github/workflows/code-quality.yml            |  2 +-
 .../src/client_state/misbehaviour.rs          | 76 ++++++++++---------
 .../src/client_state/update_client.rs         | 38 +++++-----
 .../src/client_state/validation.rs            | 26 +++++--
 .../types/src/client_state.rs                 |  4 +-
 .../ics07-tendermint/types/src/header.rs      | 19 ++---
 makefile                                      |  2 +
 8 files changed, 99 insertions(+), 72 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md

diff --git a/.changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md b/.changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md
new file mode 100644
index 000000000..75bb28043
--- /dev/null
+++ b/.changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md
@@ -0,0 +1,4 @@
+- [ibc-client-tendermint] Decouple the arguments of ICS07 Header/Misbehavior
+  verification functions from the Tendermint client type by flattening and
+  passing only the required fields.
+  ([\#1149](https://github.com/cosmos/ibc-rs/issues/1149))
diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml
index f2f26b918..9b656e1b4 100644
--- a/.github/workflows/code-quality.yml
+++ b/.github/workflows/code-quality.yml
@@ -18,6 +18,6 @@ jobs:
         run: bash ci/code-quality/whitespace-lints.sh
 
       - name: Spell Check with Typos
-        uses: crate-ci/typos@master
+        uses: crate-ci/typos@v1.19.0 # NOTE: Newer versions detect false positives. Test locally before upgrading.
         with:
           config: ./.github/typos.toml
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 63d4c47b0..8baa95c27 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -1,25 +1,26 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
-use ibc_client_tendermint_types::{
-    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
-    Misbehaviour as TmMisbehaviour,
-};
+use ibc_client_tendermint_types::{Header as TmHeader, Misbehaviour as TmMisbehaviour};
 use ibc_core_client::types::error::ClientError;
-use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_host::types::identifiers::{ChainId, ClientId};
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
+use tendermint::{Hash, Time};
+use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::Verifier;
 
 use super::TmValidationContext;
 use crate::context::{ConsensusStateConverter, TmVerifier};
+use crate::types::Header;
 
 /// Determines whether or not two conflicting headers at the same height would
 /// have convinced the light client.
 pub fn verify_misbehaviour<V>(
-    client_state: &ClientStateType,
     ctx: &V,
-    client_id: &ClientId,
     misbehaviour: &TmMisbehaviour,
+    client_id: &ClientId,
+    chain_id: &ChainId,
+    options: &Options,
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
@@ -55,44 +56,50 @@ where
     let current_timestamp = ctx.host_timestamp()?;
 
     verify_misbehaviour_header(
-        client_state,
         header_1,
-        &trusted_consensus_state_1,
+        chain_id,
+        options,
+        trusted_consensus_state_1.timestamp(),
+        trusted_consensus_state_1.next_validators_hash,
         current_timestamp,
         verifier,
     )?;
     verify_misbehaviour_header(
-        client_state,
         header_2,
-        &trusted_consensus_state_2,
+        chain_id,
+        options,
+        trusted_consensus_state_2.timestamp(),
+        trusted_consensus_state_2.next_validators_hash,
         current_timestamp,
         verifier,
     )
 }
 
 pub fn verify_misbehaviour_header(
-    client_state: &ClientStateType,
     header: &TmHeader,
-    trusted_consensus_state: &ConsensusStateType,
+    chain_id: &ChainId,
+    options: &Options,
+    trusted_timestamp: Time,
+    trusted_next_validator_hash: Hash,
     current_timestamp: Timestamp,
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError> {
     // ensure correctness of the trusted next validator set provided by the relayer
-    header.check_trusted_next_validator_set(trusted_consensus_state)?;
+    header.check_trusted_next_validator_set(&trusted_next_validator_hash)?;
 
     // ensure trusted consensus state is within trusting period
     {
         let duration_since_consensus_state = current_timestamp
-            .duration_since(&(trusted_consensus_state.timestamp().into()))
+            .duration_since(&trusted_timestamp.into())
             .ok_or_else(|| ClientError::InvalidConsensusStateTimestamp {
-                time1: trusted_consensus_state.timestamp().into(),
+                time1: trusted_timestamp.into(),
                 time2: current_timestamp,
             })?;
 
-        if duration_since_consensus_state >= client_state.trusting_period {
+        if duration_since_consensus_state >= options.trusting_period {
             return Err(Error::ConsensusStateTimestampGteTrustingPeriod {
                 duration_since_consensus_state,
-                trusting_period: client_state.trusting_period,
+                trusting_period: options.trusting_period,
             }
             .into());
         }
@@ -101,36 +108,35 @@ pub fn verify_misbehaviour_header(
     // main header verification, delegated to the tendermint-light-client crate.
     let untrusted_state = header.as_untrusted_block_state();
 
-    let chain_id =
-        client_state
-            .chain_id
-            .to_string()
-            .try_into()
-            .map_err(|e| ClientError::Other {
-                description: format!("failed to parse chain id: {}", e),
-            })?;
-
-    let trusted_state = header.as_trusted_block_state(trusted_consensus_state, &chain_id)?;
+    let tm_chain_id = &chain_id
+        .as_str()
+        .try_into()
+        .map_err(|e| ClientError::Other {
+            description: format!("failed to parse chain id: {e}"),
+        })?;
+
+    let trusted_state = header.as_trusted_block_state(
+        tm_chain_id,
+        trusted_timestamp,
+        trusted_next_validator_hash,
+    )?;
 
-    let options = client_state.as_light_client_options()?;
     let current_timestamp = current_timestamp.into_tm_time().ok_or(ClientError::Other {
         description: "host timestamp must not be zero".to_string(),
     })?;
 
     verifier
         .verifier()
-        .verify_misbehaviour_header(untrusted_state, trusted_state, &options, current_timestamp)
+        .verify_misbehaviour_header(untrusted_state, trusted_state, options, current_timestamp)
         .into_result()?;
 
     Ok(())
 }
 
-pub fn check_for_misbehaviour_misbehavior(
-    misbehaviour: &TmMisbehaviour,
+pub fn check_for_misbehaviour_on_misbehavior(
+    header_1: &Header,
+    header_2: &Header,
 ) -> Result<bool, ClientError> {
-    let header_1 = misbehaviour.header1();
-    let header_2 = misbehaviour.header2();
-
     if header_1.height() == header_2.height() {
         // when the height of the 2 headers are equal, we only have evidence
         // of misbehaviour in the case where the headers are different
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 56afd0b7c..195aad6d2 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -1,11 +1,11 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
-use ibc_client_tendermint_types::{
-    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
-};
+use ibc_client_tendermint_types::{ConsensusState as ConsensusStateType, Header as TmHeader};
 use ibc_core_client::types::error::ClientError;
-use ibc_core_host::types::identifiers::ClientId;
+use ibc_core_client::types::Height;
+use ibc_core_host::types::identifiers::{ChainId, ClientId};
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
+use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
@@ -14,10 +14,11 @@ use crate::context::{
 };
 
 pub fn verify_header<V>(
-    client_state: &ClientStateType,
     ctx: &V,
-    client_id: &ClientId,
     header: &TmHeader,
+    client_id: &ClientId,
+    chain_id: &ChainId,
+    options: &Options,
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
@@ -29,7 +30,7 @@ where
 
     // The tendermint-light-client crate though works on heights that are assumed
     // to have the same revision number. We ensure this here.
-    header.verify_chain_id_version_matches_height(&client_state.chain_id())?;
+    header.verify_chain_id_version_matches_height(chain_id)?;
 
     // Delegate to tendermint-light-client, which contains the required checks
     // of the new header against the trusted consensus state.
@@ -44,14 +45,16 @@ where
                 .consensus_state(&trusted_client_cons_state_path)?
                 .try_into()?;
 
-            header.check_trusted_next_validator_set(&trusted_consensus_state)?;
+            header
+                .check_trusted_next_validator_set(&trusted_consensus_state.next_validators_hash)?;
 
             TrustedBlockState {
-                chain_id: &client_state.chain_id.to_string().try_into().map_err(|e| {
-                    ClientError::Other {
+                chain_id: &chain_id
+                    .as_str()
+                    .try_into()
+                    .map_err(|e| ClientError::Other {
                         description: format!("failed to parse chain id: {}", e),
-                    }
-                })?,
+                    })?,
                 header_time: trusted_consensus_state.timestamp(),
                 height: header
                     .trusted_height
@@ -77,7 +80,6 @@ where
             next_validators: None,
         };
 
-        let options = client_state.as_light_client_options()?;
         let now =
             ctx.host_timestamp()?
                 .into_tm_time()
@@ -88,7 +90,7 @@ where
         // main header verification, delegated to the tendermint-light-client crate.
         verifier
             .verifier()
-            .verify_update_header(untrusted_state, trusted_state, &options, now)
+            .verify_update_header(untrusted_state, trusted_state, options, now)
             .into_result()?;
     }
 
@@ -97,11 +99,11 @@ where
 
 /// Checks for misbehaviour upon receiving a new consensus state as part
 /// of a client update.
-pub fn check_for_misbehaviour_update_client<V>(
-    client_state: &ClientStateType,
+pub fn check_for_misbehaviour_on_update<V>(
     ctx: &V,
-    client_id: &ClientId,
     header: TmHeader,
+    client_id: &ClientId,
+    client_latest_height: &Height,
 ) -> Result<bool, ClientError>
 where
     V: TmValidationContext,
@@ -146,7 +148,7 @@ where
 
         // 2. if a header comes in and is not the “last” header, then we also ensure
         //    that its timestamp is less than the “next header”
-        if header.height() < client_state.latest_height {
+        if &header.height() < client_latest_height {
             let maybe_next_cs = ctx.next_consensus_state(client_id, &header.height())?;
 
             if let Some(next_cs) = maybe_next_cs {
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 876c43a16..0a5de800d 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -10,9 +10,7 @@ use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
-use super::{
-    check_for_misbehaviour_misbehavior, check_for_misbehaviour_update_client, ClientState,
-};
+use super::{check_for_misbehaviour_on_misbehavior, check_for_misbehaviour_on_update, ClientState};
 use crate::client_state::{verify_header, verify_misbehaviour};
 use crate::context::{
     ConsensusStateConverter, DefaultVerifier, TmVerifier, ValidationContext as TmValidationContext,
@@ -79,11 +77,25 @@ where
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
             let header = TmHeader::try_from(client_message)?;
-            verify_header(client_state, ctx, client_id, &header, verifier)
+            verify_header(
+                ctx,
+                &header,
+                client_id,
+                client_state.chain_id(),
+                &client_state.as_light_client_options()?,
+                verifier,
+            )
         }
         TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
             let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-            verify_misbehaviour(client_state, ctx, client_id, &misbehaviour, verifier)
+            verify_misbehaviour(
+                ctx,
+                &misbehaviour,
+                client_id,
+                client_state.chain_id(),
+                &client_state.as_light_client_options()?,
+                verifier,
+            )
         }
         _ => Err(ClientError::InvalidUpdateClientMessage),
     }
@@ -134,11 +146,11 @@ where
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
             let header = TmHeader::try_from(client_message)?;
-            check_for_misbehaviour_update_client(client_state, ctx, client_id, header)
+            check_for_misbehaviour_on_update(ctx, header, client_id, &client_state.latest_height)
         }
         TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
             let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-            check_for_misbehaviour_misbehavior(&misbehaviour)
+            check_for_misbehaviour_on_misbehavior(misbehaviour.header1(), misbehaviour.header2())
         }
         _ => Err(ClientError::InvalidUpdateClientMessage),
     }
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 0208d0426..97fde1674 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -212,8 +212,8 @@ impl ClientState {
         })
     }
 
-    pub fn chain_id(&self) -> ChainId {
-        self.chain_id.clone()
+    pub fn chain_id(&self) -> &ChainId {
+        &self.chain_id
     }
 
     pub fn is_frozen(&self) -> bool {
diff --git a/ibc-clients/ics07-tendermint/types/src/header.rs b/ibc-clients/ics07-tendermint/types/src/header.rs
index 494fd7d43..2cedca12a 100644
--- a/ibc-clients/ics07-tendermint/types/src/header.rs
+++ b/ibc-clients/ics07-tendermint/types/src/header.rs
@@ -15,9 +15,9 @@ use pretty::{PrettySignedHeader, PrettyValidatorSet};
 use tendermint::block::signed_header::SignedHeader;
 use tendermint::chain::Id as TmChainId;
 use tendermint::validator::Set as ValidatorSet;
+use tendermint::{Hash, Time};
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 
-use crate::consensus_state::ConsensusState as TmConsensusState;
 use crate::error::Error;
 
 pub const TENDERMINT_HEADER_TYPE_URL: &str = "/ibc.lightclients.tendermint.v1.Header";
@@ -69,12 +69,13 @@ impl Header {
 
     pub fn as_trusted_block_state<'a>(
         &'a self,
-        consensus_state: &TmConsensusState,
         chain_id: &'a TmChainId,
+        header_time: Time,
+        next_validators_hash: Hash,
     ) -> Result<TrustedBlockState<'a>, Error> {
         Ok(TrustedBlockState {
             chain_id,
-            header_time: consensus_state.timestamp,
+            header_time,
             height: self
                 .trusted_height
                 .revision_height()
@@ -83,7 +84,7 @@ impl Header {
                     height: self.trusted_height.revision_height(),
                 })?,
             next_validators: &self.trusted_next_validator_set,
-            next_validators_hash: consensus_state.next_validators_hash,
+            next_validators_hash,
         })
     }
 
@@ -97,14 +98,14 @@ impl Header {
         Ok(())
     }
 
-    // `header.trusted_validator_set` was given to us by the relayer. Thus, we
-    // need to ensure that the relayer gave us the right set, i.e. by ensuring
-    // that it matches the hash we have stored on chain.
+    /// `header.trusted_next_validator_set` was given to us by the relayer.
+    /// Thus, we need to ensure that the relayer gave us the right set, i.e. by
+    /// ensuring that it matches the hash we have stored on chain.
     pub fn check_trusted_next_validator_set(
         &self,
-        trusted_consensus_state: &TmConsensusState,
+        trusted_next_validator_hash: &Hash,
     ) -> Result<(), ClientError> {
-        if self.trusted_next_validator_set.hash() == trusted_consensus_state.next_validators_hash {
+        if &self.trusted_next_validator_set.hash() == trusted_next_validator_hash {
             Ok(())
         } else {
             Err(ClientError::HeaderVerificationFailure {
diff --git a/makefile b/makefile
index 1b3a36914..f185a1045 100644
--- a/makefile
+++ b/makefile
@@ -8,11 +8,13 @@ install-tools: ## Install development tools including nightly rustfmt, cargo-hac
 	rustup component add rustfmt --toolchain nightly
 	cargo install cargo-hack
 	cargo install cargo-release
+	cargo install typos-cli
 
 lint: ## Lint the code using rustfmt, clippy and whitespace lints.
 	cargo +nightly fmt --all --check
 	cargo clippy --all-targets --all-features
 	cargo clippy --all-targets --no-default-features
+	typos --config $(CURDIR)/.github/typos.toml
 	bash ./ci/code-quality/whitespace-lints.sh
 
 check-features: ## Check that project compiles with all combinations of features.

From 2b9de3413eb34179dc0266e851a1c4d4715c8cb8 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Wed, 3 Apr 2024 16:09:35 -0500
Subject: [PATCH 140/182] feat: implement client recovery feature (#1127)

* Add `MsgRecoverClient` domain type

* Working on client recovery validation handler logic

* Implement recover_client::validate function

* Add ClientStateValidation::check_substitute function

* Working on `recover_client::execute` function

* Stub out `update_on_recovery` function

* Implement standalone `update_on_recovery` function

* Change `update_on_recovery` function param

* Remove `ClientState::initialise` call from `execute`

* Implement `check_substitute` in ics07

* Update `update_on_recovery` function

* Add `MsgRecoverClient` domain type

* Working on client recovery validation handler logic

* Implement recover_client::validate function

* Add ClientStateValidation::check_substitute function

* Working on `recover_client::execute` function

* Stub out `update_on_recovery` function

* Implement standalone `update_on_recovery` function

* Change `update_on_recovery` function param

* Remove `ClientState::initialise` call from `execute`

* Implement `check_substitute` in ics07

* Update `update_on_recovery` function

* Resolve errors upon rebasing

* Add additional bounds on `check_substitute` and `update_on_recovery`

* Implement TryFrom<AnyClientState> for ClientStateType

* Attempt to implement check_substitute and update_on_recovery in ibc-derive

* fix: introduce fully-qualified path to get ibc-derive work

* Change substitute client state function params to Any

* Update change_substitute and update_on_recovery call sites

* Add additional bounds on other validation and execution context methods

* Implement `update_on_recovery` for MockClientState

* Silence unused variables warning

* Add missing MockClientState fields

* Fix some typos in doc comments

* Remove unnecessary trait bound

* Change `upgrade_client_proposal_handler` -> `execute_upgrade_client_proposal`

* Add upgrade proposal type url

* Remove commented-out trait bounds

* Convert Any to ClientState instead of ClientStateType

* Improve error message wording

* Improve error message wording

* Remove unnused function paramter

* Replace `self` with `&self`

* Convert substitute client state to MockClientState instead of Tm client state

* Update ClientNotInactive error variant message

* Improve `check_substitute` implementation

* Make `Status` type `Copy`

* Remove some imports and streamline mock client state initialization

* rm redundant methods

* Remove unnecessary TryFrom impl

* tests: add unit tests for client recovery (#1151)

* Initial scaffolding for testing client recovery

* Add MsgRecoverClient variant to ClientMsg

* Stub out `test_recover_client_ok`

* Update recover client test fixture

* Perform client updates on subject and substitute clients

* Create mock headers with timestamps

* Extend substitute client state's trusting period

* Remove eprintln statements

* Add some more tests

* Refactor to not require call to `sleep`

* Add docstring for `MockClientState::new`

* Formatting

* Remove recover_client validate and execute calls from dispatch

* Remove recover_client validate and execute calls from dispatch

* Call recover_client::validate and execute correctly

* Change MockClientState default trusting period to 10 seconds

* Add changelog entry

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../features/738-client-recovery.md           |   4 +
 .../src/client_state/execution.rs             |  75 ++++++-
 .../src/client_state/validation.rs            |  55 +++++
 .../ics02-client/context/src/client_state.rs  |  25 ++-
 ibc-core/ics02-client/src/handler/mod.rs      |   1 +
 .../src/handler/recover_client.rs             |  83 ++++++++
 ibc-core/ics02-client/types/src/error.rs      |  12 +-
 ibc-core/ics02-client/types/src/msgs/mod.rs   |   3 +
 .../types/src/msgs/recover_client.rs          |  66 ++++++
 ibc-core/ics02-client/types/src/status.rs     |  14 +-
 .../cosmos/src/upgrade_proposal/handler.rs    |   4 +-
 .../cosmos/src/upgrade_proposal/mod.rs        |   4 +-
 .../cosmos/src/upgrade_proposal/proposal.rs   |   2 +
 ibc-core/ics25-handler/src/entrypoint.rs      |  10 +
 .../traits/client_state_execution.rs          |  31 ++-
 .../traits/client_state_validation.rs         |  27 ++-
 .../testapp/ibc/clients/mock/client_state.rs  |  46 ++++-
 ibc-testkit/tests/core/ics02_client/mod.rs    |   1 +
 .../tests/core/ics02_client/recover_client.rs | 193 ++++++++++++++++++
 19 files changed, 632 insertions(+), 24 deletions(-)
 create mode 100644 .changelog/unreleased/features/738-client-recovery.md
 create mode 100644 ibc-core/ics02-client/src/handler/recover_client.rs
 create mode 100644 ibc-core/ics02-client/types/src/msgs/recover_client.rs
 create mode 100644 ibc-testkit/tests/core/ics02_client/recover_client.rs

diff --git a/.changelog/unreleased/features/738-client-recovery.md b/.changelog/unreleased/features/738-client-recovery.md
new file mode 100644
index 000000000..4717438e7
--- /dev/null
+++ b/.changelog/unreleased/features/738-client-recovery.md
@@ -0,0 +1,4 @@
+- [ibc-client] Implement [client recovery][client-recovery] feature.
+([\#738](https://github.com/cosmos/ibc-rs/issues/738))
+
+client-recovery: https://github.com/cosmos/ibc-go/blob/main/docs/architecture/adr-026-ibc-client-recovery-mechanisms.md
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index 58e1d337b..ba6d09186 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -63,6 +63,22 @@ where
             upgraded_consensus_state,
         )
     }
+
+    fn update_on_recovery(
+        &self,
+        ctx: &mut E,
+        subject_client_id: &ClientId,
+        substitute_client_state: Any,
+    ) -> Result<(), ClientError> {
+        let subject_client_state = self.inner().clone();
+
+        update_on_recovery(
+            subject_client_state,
+            ctx,
+            subject_client_id,
+            substitute_client_state,
+        )
+    }
 }
 
 /// Seed the host store with initial client and consensus states.
@@ -208,7 +224,8 @@ where
     Ok(())
 }
 
-/// Commit the new client state and consensus state to the store.
+/// Commit the new client state and consensus state to the store upon a
+/// successful client upgrade.
 ///
 /// Note that this function is typically implemented as part of the
 /// [`ClientStateExecution`] trait, but has been made a standalone function
@@ -344,3 +361,59 @@ where
 
     Ok(())
 }
+
+/// Update the `client_state`'s ID, trusting period, latest height, processed height,
+/// and processed time metadata values to those values provided by a verified substitute
+/// client state in response to a successful client recovery.
+///
+/// Note that unlike the `update_on_upgrade` function, `update_on_recovery` assumes
+/// that the client being updated has already been re-initialised such that its original
+/// client and consensus states have been overwritten to their new states.
+///
+/// This function is typically implemented as part of the [`ClientStateExecution`]
+/// trait, but has been made standalone in order to enable greater flexibility
+/// of the ClientState APIs.
+pub fn update_on_recovery<E>(
+    subject_client_state: ClientStateType,
+    ctx: &mut E,
+    subject_client_id: &ClientId,
+    substitute_client_state: Any,
+) -> Result<(), ClientError>
+where
+    E: TmExecutionContext,
+    E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: ConsensusStateConverter,
+{
+    let substitute_client_state = ClientState::try_from(substitute_client_state)?
+        .inner()
+        .clone();
+
+    let chain_id = substitute_client_state.chain_id;
+    let trusting_period = substitute_client_state.trusting_period;
+    let latest_height = substitute_client_state.latest_height;
+
+    let new_client_state = ClientStateType {
+        chain_id,
+        trusting_period,
+        latest_height,
+        frozen_height: None,
+        ..subject_client_state
+    };
+
+    let host_timestamp = E::host_timestamp(ctx)?;
+    let host_height = E::host_height(ctx)?;
+
+    ctx.store_client_state(
+        ClientStatePath::new(subject_client_id.clone()),
+        new_client_state.into(),
+    )?;
+
+    ctx.store_update_meta(
+        subject_client_id.clone(),
+        latest_height,
+        host_timestamp,
+        host_height,
+    )?;
+
+    Ok(())
+}
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 0a5de800d..2510a8ade 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -52,6 +52,10 @@ where
     fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError> {
         status(self.inner(), ctx, client_id)
     }
+
+    fn check_substitute(&self, _ctx: &V, substitute_client_state: Any) -> Result<(), ClientError> {
+        check_substitute::<V>(self.inner(), substitute_client_state)
+    }
 }
 
 /// Verify the client message as part of the client state validation process.
@@ -202,3 +206,54 @@ where
 
     Ok(Status::Active)
 }
+
+/// Check that the subject and substitute client states match as part of
+/// the client recovery validation step.
+///
+/// The subject and substitute client states match if all their respective
+/// client state parameters match except for frozen height, latest height,
+/// trusting period, and chain ID.
+pub fn check_substitute<V>(
+    subject_client_state: &ClientStateType,
+    substitute_client_state: Any,
+) -> Result<(), ClientError>
+where
+    V: TmValidationContext,
+    V::ConsensusStateRef: ConsensusStateConverter,
+{
+    let ClientStateType {
+        latest_height: _,
+        frozen_height: _,
+        trusting_period: _,
+        chain_id: _,
+        allow_update: _,
+        trust_level: subject_trust_level,
+        unbonding_period: subject_unbonding_period,
+        max_clock_drift: subject_max_clock_drift,
+        proof_specs: subject_proof_specs,
+        upgrade_path: subject_upgrade_path,
+    } = subject_client_state.clone();
+
+    let substitute_client_state = ClientStateType::try_from(substitute_client_state)?;
+
+    let ClientStateType {
+        latest_height: _,
+        frozen_height: _,
+        trusting_period: _,
+        chain_id: _,
+        allow_update: _,
+        trust_level: substitute_trust_level,
+        unbonding_period: substitute_unbonding_period,
+        max_clock_drift: substitute_max_clock_drift,
+        proof_specs: substitute_proof_specs,
+        upgrade_path: substitute_upgrade_path,
+    } = substitute_client_state;
+
+    (subject_trust_level == substitute_trust_level
+        && subject_unbonding_period == substitute_unbonding_period
+        && subject_max_clock_drift == substitute_max_clock_drift
+        && subject_proof_specs == substitute_proof_specs
+        && subject_upgrade_path == substitute_upgrade_path)
+        .then_some(())
+        .ok_or(ClientError::ClientRecoveryStateMismatch)
+}
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index 0d1c57a37..849678b77 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -124,6 +124,20 @@ where
 
     /// Returns the status of the client. Only Active clients are allowed to process packets.
     fn status(&self, ctx: &V, client_id: &ClientId) -> Result<Status, ClientError>;
+
+    /// Verifies whether the calling (subject) client state matches the substitute
+    /// client state for the purposes of client recovery.
+    ///
+    /// Note that this validation function does not need to perform *all* of the
+    /// validation steps necessary to confirm client recovery. Some checks, such
+    /// as checking that the subject client state's latest height < the substitute
+    /// client's latest height, as well as checking that the subject client is
+    /// inactive and that the substitute client is active, are performed by the
+    /// `validate` function in the `recover_client` module at the ics02-client
+    /// level.
+    ///
+    /// Returns `Ok` if the subject and substitute client states match, `Err` otherwise.
+    fn check_substitute(&self, ctx: &V, substitute_client_state: Any) -> Result<(), ClientError>;
 }
 
 /// `ClientState` methods which require access to the client's
@@ -172,7 +186,7 @@ where
         client_message: Any,
     ) -> Result<(), ClientError>;
 
-    // Update the client state and consensus state in the store with the upgraded ones.
+    /// Update the client state and consensus state in the store with the upgraded ones.
     fn update_state_on_upgrade(
         &self,
         ctx: &mut E,
@@ -180,6 +194,15 @@ where
         upgraded_client_state: Any,
         upgraded_consensus_state: Any,
     ) -> Result<Height, ClientError>;
+
+    /// Update the subject client using the `substitute_client_state` in response
+    /// to a successful client recovery.
+    fn update_on_recovery(
+        &self,
+        ctx: &mut E,
+        subject_client_id: &ClientId,
+        substitute_client_state: Any,
+    ) -> Result<(), ClientError>;
 }
 
 use crate::context::{ClientExecutionContext, ClientValidationContext};
diff --git a/ibc-core/ics02-client/src/handler/mod.rs b/ibc-core/ics02-client/src/handler/mod.rs
index 65c5e59c8..791b5ce39 100644
--- a/ibc-core/ics02-client/src/handler/mod.rs
+++ b/ibc-core/ics02-client/src/handler/mod.rs
@@ -1,5 +1,6 @@
 //! This module implements the processing logic for ICS2 (client abstractions and functions) msgs.
 
 pub mod create_client;
+pub mod recover_client;
 pub mod update_client;
 pub mod upgrade_client;
diff --git a/ibc-core/ics02-client/src/handler/recover_client.rs b/ibc-core/ics02-client/src/handler/recover_client.rs
new file mode 100644
index 000000000..431afadf5
--- /dev/null
+++ b/ibc-core/ics02-client/src/handler/recover_client.rs
@@ -0,0 +1,83 @@
+//! Protocol logic for processing ICS02 messages of type `MsgRecoverClient`.
+
+use ibc_core_client_context::prelude::*;
+use ibc_core_client_types::error::ClientError;
+use ibc_core_client_types::msgs::MsgRecoverClient;
+use ibc_core_handler_types::error::ContextError;
+use ibc_core_host::{ExecutionContext, ValidationContext};
+
+/// Performs the validation steps associated with the client recovery process. This
+/// includes validating that the parameters of the subject and substitute clients match,
+/// as well as validating that the substitute client *is* active and that the subject
+/// client is *not* active.
+pub fn validate<Ctx>(ctx: &Ctx, msg: MsgRecoverClient) -> Result<(), ContextError>
+where
+    Ctx: ValidationContext,
+{
+    let signer = msg.signer;
+    let subject_client_id = msg.subject_client_id.clone();
+    let substitute_client_id = msg.substitute_client_id.clone();
+
+    ctx.validate_message_signer(&signer)?;
+
+    let client_val_ctx = ctx.get_client_validation_context();
+
+    let subject_client_state = client_val_ctx.client_state(&subject_client_id)?;
+    let substitute_client_state = client_val_ctx.client_state(&substitute_client_id)?;
+
+    let subject_height = subject_client_state.latest_height();
+    let substitute_height = substitute_client_state.latest_height();
+
+    if subject_height >= substitute_height {
+        return Err(ClientError::ClientRecoveryHeightMismatch {
+            subject_height,
+            substitute_height,
+        }
+        .into());
+    }
+
+    substitute_client_state
+        .status(ctx.get_client_validation_context(), &substitute_client_id)?
+        .verify_is_active()?;
+
+    // Verify that the subject client is inactive, i.e., that it is either frozen or expired
+    subject_client_state
+        .status(ctx.get_client_validation_context(), &subject_client_id)?
+        .verify_is_inactive()?;
+
+    // Check that the subject client state and substitute client states match, i.e., that
+    // all their respective client state parameters match except for frozen height, latest
+    // height, trusting period, and chain ID
+    subject_client_state.check_substitute(
+        ctx.get_client_validation_context(),
+        substitute_client_state.into(),
+    )?;
+
+    Ok(())
+}
+
+/// Executes the steps needed to recover the subject client, namely:
+///  - setting the subject's status from either `frozen` or `expired` to `active`
+///  - copying the substitute client's consensus state as the subject's consensus state
+///  - setting the subject client's processed height and processed time values to match the substitute client's
+///  - setting the subject client's latest height, trusting period, and chain ID values to match the substitute client's
+pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgRecoverClient) -> Result<(), ContextError>
+where
+    Ctx: ExecutionContext,
+{
+    let subject_client_id = msg.subject_client_id.clone();
+    let substitute_client_id = msg.substitute_client_id.clone();
+
+    let client_exec_ctx = ctx.get_client_execution_context();
+
+    let subject_client_state = client_exec_ctx.client_state(&subject_client_id)?;
+    let substitute_client_state = client_exec_ctx.client_state(&substitute_client_id)?;
+
+    subject_client_state.update_on_recovery(
+        ctx.get_client_execution_context(),
+        &subject_client_id,
+        substitute_client_state.into(),
+    )?;
+
+    Ok(())
+}
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 181d2ca5f..0783c906b 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -1,7 +1,6 @@
 //! Defines the client error type
 
 use displaydoc::Display;
-// use ibc::core::ContextError;
 use ibc_core_commitment_types::error::CommitmentError;
 use ibc_core_host_types::error::IdentifierError;
 use ibc_core_host_types::identifiers::{ClientId, ClientType};
@@ -20,10 +19,19 @@ pub enum ClientError {
     ClientFrozen { description: String },
     /// client is not active. Status=`{status}`
     ClientNotActive { status: Status },
+    /// client is not frozen or expired. Status=`{status}`
+    ClientNotInactive { status: Status },
     /// client state not found: `{client_id}`
     ClientStateNotFound { client_id: ClientId },
     /// client state already exists: `{client_id}`
     ClientStateAlreadyExists { client_id: ClientId },
+    /// Substitute client height `{substitute_height}` is not greater than subject client height `{subject_height}` during client recovery
+    ClientRecoveryHeightMismatch {
+        subject_height: Height,
+        substitute_height: Height,
+    },
+    /// Subject and substitute client state mismatch during client recovery
+    ClientRecoveryStateMismatch,
     /// consensus state not found at: `{client_id}` at height `{height}`
     ConsensusStateNotFound { client_id: ClientId, height: Height },
     /// Processed time or height for the client `{client_id}` at height `{height}` not found
@@ -50,6 +58,8 @@ pub enum ClientError {
     MissingRawConsensusState,
     /// invalid client id in the update client message: `{0}`
     InvalidMsgUpdateClientId(IdentifierError),
+    /// invalid client id in recover client message: `{0}`
+    InvalidMsgRecoverClientId(IdentifierError),
     /// invalid client identifier error: `{0}`
     InvalidClientIdentifier(IdentifierError),
     /// invalid raw header error: `{reason}`
diff --git a/ibc-core/ics02-client/types/src/msgs/mod.rs b/ibc-core/ics02-client/types/src/msgs/mod.rs
index ab9a145ed..fbb76a821 100644
--- a/ibc-core/ics02-client/types/src/msgs/mod.rs
+++ b/ibc-core/ics02-client/types/src/msgs/mod.rs
@@ -9,11 +9,13 @@ use ibc_proto::google::protobuf::Any;
 
 mod create_client;
 mod misbehaviour;
+mod recover_client;
 mod update_client;
 mod upgrade_client;
 
 pub use create_client::*;
 pub use misbehaviour::*;
+pub use recover_client::*;
 pub use update_client::*;
 pub use upgrade_client::*;
 
@@ -30,6 +32,7 @@ pub enum ClientMsg {
     UpdateClient(MsgUpdateClient),
     Misbehaviour(MsgSubmitMisbehaviour),
     UpgradeClient(MsgUpgradeClient),
+    RecoverClient(MsgRecoverClient),
 }
 
 pub enum MsgUpdateOrMisbehaviour {
diff --git a/ibc-core/ics02-client/types/src/msgs/recover_client.rs b/ibc-core/ics02-client/types/src/msgs/recover_client.rs
new file mode 100644
index 000000000..5bc6c0594
--- /dev/null
+++ b/ibc-core/ics02-client/types/src/msgs/recover_client.rs
@@ -0,0 +1,66 @@
+//! Definition of domain type message `MsgRecoverClient`.
+
+use ibc_core_host_types::identifiers::ClientId;
+use ibc_primitives::prelude::*;
+use ibc_primitives::Signer;
+use ibc_proto::ibc::core::client::v1::MsgRecoverClient as RawMsgRecoverClient;
+use ibc_proto::Protobuf;
+
+use crate::error::ClientError;
+
+pub const RECOVER_CLIENT_TYPE_URL: &str = "/ibc.core.client.v1.MsgRecoverClient";
+
+/// Defines the message used to recover a frozen or expired client.
+///
+/// Note that a frozen or expired client can only be recovered by passing
+/// a governance proposal. For this reason, ibc-rs does not export dispatching
+/// a `MsgRecoverClient` via the `dispatch` function. In other words, the
+/// client recovery functionality is not part of ibc-rs's public API. The
+/// intended usage of this message type is to be integrated with hosts'
+/// governance modules, not to be called directly via `dispatch`.
+#[cfg_attr(
+    feature = "borsh",
+    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
+)]
+#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
+#[derive(Clone, Debug, PartialEq, Eq)]
+pub struct MsgRecoverClient {
+    /// Client identifier of the client to be updated if the proposal passes.
+    pub subject_client_id: ClientId,
+    /// Client identifier of the client that will replace the subject client
+    /// if the proposal passes.
+    pub substitute_client_id: ClientId,
+    /// The address of the signer who serves as the authority for the IBC
+    /// module.
+    pub signer: Signer,
+}
+
+impl Protobuf<RawMsgRecoverClient> for MsgRecoverClient {}
+
+impl TryFrom<RawMsgRecoverClient> for MsgRecoverClient {
+    type Error = ClientError;
+
+    fn try_from(raw: RawMsgRecoverClient) -> Result<Self, Self::Error> {
+        Ok(MsgRecoverClient {
+            subject_client_id: raw
+                .subject_client_id
+                .parse()
+                .map_err(ClientError::InvalidMsgRecoverClientId)?,
+            substitute_client_id: raw
+                .substitute_client_id
+                .parse()
+                .map_err(ClientError::InvalidMsgRecoverClientId)?,
+            signer: raw.signer.into(),
+        })
+    }
+}
+
+impl From<MsgRecoverClient> for RawMsgRecoverClient {
+    fn from(ics_msg: MsgRecoverClient) -> Self {
+        RawMsgRecoverClient {
+            subject_client_id: ics_msg.subject_client_id.to_string(),
+            substitute_client_id: ics_msg.substitute_client_id.to_string(),
+            signer: ics_msg.signer.to_string(),
+        }
+    }
+}
diff --git a/ibc-core/ics02-client/types/src/status.rs b/ibc-core/ics02-client/types/src/status.rs
index 1fb931f23..d77a7bbe6 100644
--- a/ibc-core/ics02-client/types/src/status.rs
+++ b/ibc-core/ics02-client/types/src/status.rs
@@ -19,7 +19,7 @@ pub enum UpdateKind {
 }
 
 /// Represents the status of a client
-#[derive(Clone, Debug, PartialEq, Eq)]
+#[derive(Clone, Debug, PartialEq, Eq, Copy)]
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub enum Status {
@@ -47,10 +47,18 @@ impl Status {
     }
 
     /// Checks whether the status is active; returns `Err` if not.
-    pub fn verify_is_active(self) -> Result<(), ClientError> {
+    pub fn verify_is_active(&self) -> Result<(), ClientError> {
         match self {
             Self::Active => Ok(()),
-            status => Err(ClientError::ClientNotActive { status }),
+            &status => Err(ClientError::ClientNotActive { status }),
+        }
+    }
+
+    /// Checks whether the client is either frozen or expired; returns `Err` if not.
+    pub fn verify_is_inactive(&self) -> Result<(), ClientError> {
+        match self {
+            Self::Frozen | Self::Expired => Ok(()),
+            &status => Err(ClientError::ClientNotInactive { status }),
         }
     }
 }
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
index 99e04f833..2b76c089f 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
@@ -7,12 +7,12 @@ use tendermint::abci::Event as TmEvent;
 use super::UpgradedClientStateRef;
 use crate::upgrade_proposal::{UpgradeClientProposal, UpgradeExecutionContext, UpgradeProposal};
 
-/// Handles an upgrade client proposal
+/// Executes an upgrade client proposal.
 ///
 /// It clears both IBC client and consensus states if a previous plan was set.
 /// Then it will schedule an upgrade and finally set the upgraded client state
 /// in upgrade store.
-pub fn upgrade_client_proposal_handler<Ctx>(
+pub fn execute_upgrade_client_proposal<Ctx>(
     ctx: &mut Ctx,
     proposal: UpgradeProposal,
 ) -> Result<TmEvent, UpgradeClientError>
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
index db4919d92..dbeb53074 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/mod.rs
@@ -8,6 +8,6 @@ mod proposal;
 
 pub use context::*;
 pub use events::{UpgradeChain, UpgradeClientProposal};
-pub use handler::upgrade_client_proposal_handler;
+pub use handler::execute_upgrade_client_proposal;
 pub use plan::Plan;
-pub use proposal::UpgradeProposal;
+pub use proposal::*;
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
index d9e855a48..a12f4fab4 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/proposal.rs
@@ -8,6 +8,8 @@ use ibc_proto::Protobuf;
 
 use super::Plan;
 
+pub const UPGRADE_PROPOSAL_TYPE_URL: &str = "/ibc.core.client.v1.UpgradeProposal";
+
 /// Defines a governance proposal of type `Content` that enables the initiation
 /// of an IBC breaking upgrade and specifies the new client state that should be
 /// utilized following the upgrade.
diff --git a/ibc-core/ics25-handler/src/entrypoint.rs b/ibc-core/ics25-handler/src/entrypoint.rs
index b3391280a..1de98b062 100644
--- a/ibc-core/ics25-handler/src/entrypoint.rs
+++ b/ibc-core/ics25-handler/src/entrypoint.rs
@@ -56,6 +56,11 @@ where
                 update_client::validate(ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg))
             }
             ClientMsg::UpgradeClient(msg) => upgrade_client::validate(ctx, msg),
+            ClientMsg::RecoverClient(_msg) => {
+                // Recover client messages are not dispatched by ibc-rs as they can only be
+                // authorized via a passing governance proposal
+                Ok(())
+            }
         },
         MsgEnvelope::Connection(msg) => match msg {
             ConnectionMsg::OpenInit(msg) => conn_open_init::validate(ctx, msg),
@@ -127,6 +132,11 @@ where
                 update_client::execute(ctx, MsgUpdateOrMisbehaviour::Misbehaviour(msg))
             }
             ClientMsg::UpgradeClient(msg) => upgrade_client::execute(ctx, msg),
+            ClientMsg::RecoverClient(_msg) => {
+                // Recover client messages are not dispatched by ibc-rs as they can only be
+                // authorized via a passing governance proposal
+                Ok(())
+            }
         },
         MsgEnvelope::Connection(msg) => match msg {
             ConnectionMsg::OpenInit(msg) => conn_open_init::execute(ctx, msg),
diff --git a/ibc-derive/src/client_state/traits/client_state_execution.rs b/ibc-derive/src/client_state/traits/client_state_execution.rs
index 12a1b1de0..64c9770c2 100644
--- a/ibc-derive/src/client_state/traits/client_state_execution.rs
+++ b/ibc-derive/src/client_state/traits/client_state_execution.rs
@@ -43,6 +43,14 @@ pub(crate) fn impl_ClientStateExecution(
         imports,
     );
 
+    let update_on_recovery_impl = delegate_call_in_match(
+        client_state_enum_name,
+        enum_variants.iter(),
+        opts,
+        quote! { update_on_recovery(cs, ctx, client_id, substitute_client_state) },
+        imports,
+    );
+
     // The imports we need for the generated code.
     let Any = imports.any();
     let ClientId = imports.client_id();
@@ -52,7 +60,7 @@ pub(crate) fn impl_ClientStateExecution(
 
     // The types we need for the generated code.
     let HostClientState = client_state_enum_name;
-    let ClientExecutionContext = &opts.client_execution_context.clone().into_token_stream();
+    let E = &opts.client_execution_context.clone().into_token_stream();
 
     // The `impl` block quote based on whether the context includes generics.
     let Impl = opts.client_execution_context.impl_ts();
@@ -62,10 +70,10 @@ pub(crate) fn impl_ClientStateExecution(
     let Where = opts.client_execution_context.where_clause_ts();
 
     quote! {
-        #Impl #ClientStateExecution<#ClientExecutionContext> for #HostClientState #Where {
+        #Impl #ClientStateExecution<#E> for #HostClientState #Where {
             fn initialise(
                 &self,
-                ctx: &mut #ClientExecutionContext,
+                ctx: &mut #E,
                 client_id: &#ClientId,
                 consensus_state: #Any,
             ) -> Result<(), #ClientError> {
@@ -76,7 +84,7 @@ pub(crate) fn impl_ClientStateExecution(
 
             fn update_state(
                 &self,
-                ctx: &mut #ClientExecutionContext,
+                ctx: &mut #E,
                 client_id: &#ClientId,
                 header: #Any,
             ) -> core::result::Result<Vec<#Height>, #ClientError> {
@@ -87,7 +95,7 @@ pub(crate) fn impl_ClientStateExecution(
 
             fn update_state_on_misbehaviour(
                 &self,
-                ctx: &mut #ClientExecutionContext,
+                ctx: &mut #E,
                 client_id: &#ClientId,
                 client_message: #Any,
             ) -> core::result::Result<(), #ClientError> {
@@ -98,7 +106,7 @@ pub(crate) fn impl_ClientStateExecution(
 
             fn update_state_on_upgrade(
                 &self,
-                ctx: &mut #ClientExecutionContext,
+                ctx: &mut #E,
                 client_id: &#ClientId,
                 upgraded_client_state: #Any,
                 upgraded_consensus_state: #Any,
@@ -107,6 +115,17 @@ pub(crate) fn impl_ClientStateExecution(
                     #(#update_state_with_upgrade_client_impl),*
                 }
             }
+
+            fn update_on_recovery(
+                &self,
+                ctx: &mut #E,
+                client_id: &#ClientId,
+                substitute_client_state: #Any,
+            ) -> core::result::Result<(), #ClientError> {
+                match self {
+                    #(#update_on_recovery_impl),*
+                }
+            }
         }
 
     }
diff --git a/ibc-derive/src/client_state/traits/client_state_validation.rs b/ibc-derive/src/client_state/traits/client_state_validation.rs
index d87fed4c2..263411b15 100644
--- a/ibc-derive/src/client_state/traits/client_state_validation.rs
+++ b/ibc-derive/src/client_state/traits/client_state_validation.rs
@@ -37,6 +37,14 @@ pub(crate) fn impl_ClientStateValidation(
         imports,
     );
 
+    let check_substitute_impl = delegate_call_in_match(
+        client_state_enum_name,
+        enum_variants.iter(),
+        opts,
+        quote! { check_substitute(cs, ctx, substitute_client_state) },
+        imports,
+    );
+
     // The imports we need for the generated code.
     let Any = imports.any();
     let ClientId = imports.client_id();
@@ -46,7 +54,7 @@ pub(crate) fn impl_ClientStateValidation(
 
     // The types we need for the generated code.
     let HostClientState = client_state_enum_name;
-    let ClientValidationContext = opts.client_validation_context.clone().into_token_stream();
+    let V = opts.client_validation_context.clone().into_token_stream();
 
     // The `impl` block quote based on whether the context includes generics.
     let Impl = opts.client_validation_context.impl_ts();
@@ -56,10 +64,10 @@ pub(crate) fn impl_ClientStateValidation(
     let Where = opts.client_validation_context.where_clause_ts();
 
     quote! {
-        #Impl #ClientStateValidation<#ClientValidationContext> for #HostClientState #Where {
+        #Impl #ClientStateValidation<#V> for #HostClientState #Where {
             fn verify_client_message(
                 &self,
-                ctx: &#ClientValidationContext,
+                ctx: &#V,
                 client_id: &#ClientId,
                 client_message: #Any,
             ) -> core::result::Result<(), #ClientError> {
@@ -70,7 +78,7 @@ pub(crate) fn impl_ClientStateValidation(
 
             fn check_for_misbehaviour(
                 &self,
-                ctx: &#ClientValidationContext,
+                ctx: &#V,
                 client_id: &#ClientId,
                 client_message: #Any,
             ) -> core::result::Result<bool, #ClientError> {
@@ -81,13 +89,22 @@ pub(crate) fn impl_ClientStateValidation(
 
             fn status(
                 &self,
-                ctx: &#ClientValidationContext,
+                ctx: &#V,
                 client_id: &#ClientId,
             ) -> core::result::Result<#Status, #ClientError> {
                 match self {
                     #(#status_impl),*
                 }
+            }
 
+            fn check_substitute(
+                &self,
+                ctx: &#V,
+                substitute_client_state: #Any,
+            ) -> core::result::Result<(), #ClientError> {
+                match self {
+                    #(#check_substitute_impl),*
+                }
             }
         }
 
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 2b597b1e1..6bb841f0e 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -38,10 +38,13 @@ pub struct MockClientState {
 }
 
 impl MockClientState {
+    /// Initializes a new `MockClientState` with the given `MockHeader` and a
+    /// trusting period of 10 seconds as a default. If the trusting period
+    /// needs to be changed, use the `with_trusting_period` method to override it.
     pub fn new(header: MockHeader) -> Self {
         Self {
             header,
-            trusting_period: Duration::from_nanos(0),
+            trusting_period: Duration::from_secs(10),
             frozen: false,
         }
     }
@@ -79,8 +82,8 @@ impl MockClientState {
         self.frozen
     }
 
-    fn expired(&self, _elapsed: Duration) -> bool {
-        false
+    fn expired(&self, elapsed: Duration) -> bool {
+        elapsed > self.trusting_period
     }
 }
 
@@ -311,6 +314,10 @@ where
 
         Ok(Status::Active)
     }
+
+    fn check_substitute(&self, _ctx: &V, _substitute_client_state: Any) -> Result<(), ClientError> {
+        Ok(())
+    }
 }
 
 impl<E> ClientStateExecution<E> for MockClientState
@@ -427,6 +434,39 @@ where
 
         Ok(latest_height)
     }
+
+    fn update_on_recovery(
+        &self,
+        ctx: &mut E,
+        subject_client_id: &ClientId,
+        substitute_client_state: Any,
+    ) -> Result<(), ClientError> {
+        let substitute_client_state = MockClientState::try_from(substitute_client_state)?;
+
+        let latest_height = substitute_client_state.latest_height();
+
+        let new_mock_client_state = MockClientState {
+            frozen: false,
+            ..substitute_client_state
+        };
+
+        let host_timestamp = ctx.host_timestamp()?;
+        let host_height = ctx.host_height()?;
+
+        ctx.store_client_state(
+            ClientStatePath::new(subject_client_id.clone()),
+            new_mock_client_state.into(),
+        )?;
+
+        ctx.store_update_meta(
+            subject_client_id.clone(),
+            latest_height,
+            host_timestamp,
+            host_height,
+        )?;
+
+        Ok(())
+    }
 }
 
 impl From<MockConsensusState> for MockClientState {
diff --git a/ibc-testkit/tests/core/ics02_client/mod.rs b/ibc-testkit/tests/core/ics02_client/mod.rs
index 1a11ad044..267b760cc 100644
--- a/ibc-testkit/tests/core/ics02_client/mod.rs
+++ b/ibc-testkit/tests/core/ics02_client/mod.rs
@@ -1,5 +1,6 @@
 #[cfg(feature = "serde")]
 pub mod create_client;
+pub mod recover_client;
 pub mod update_client;
 #[cfg(feature = "serde")]
 pub mod upgrade_client;
diff --git a/ibc-testkit/tests/core/ics02_client/recover_client.rs b/ibc-testkit/tests/core/ics02_client/recover_client.rs
new file mode 100644
index 000000000..22fc227a7
--- /dev/null
+++ b/ibc-testkit/tests/core/ics02_client/recover_client.rs
@@ -0,0 +1,193 @@
+use core::time::Duration;
+
+use ibc::core::client::context::ClientValidationContext;
+use ibc::core::client::handler::recover_client;
+use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient, MsgRecoverClient};
+use ibc::core::client::types::Height;
+use ibc::core::entrypoint::{execute, validate};
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::ValidationContext;
+use ibc::core::primitives::{Signer, Timestamp};
+use ibc_testkit::fixtures::core::signer::dummy_account_id;
+use ibc_testkit::testapp::ibc::clients::mock::client_state::{
+    client_type as mock_client_type, MockClientState,
+};
+use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::core::router::MockRouter;
+use ibc_testkit::testapp::ibc::core::types::MockContext;
+use rstest::*;
+
+struct Fixture {
+    ctx: MockContext,
+    subject_client_id: ClientId,
+    substitute_client_id: ClientId,
+    signer: Signer,
+}
+
+/// Initializes the testing fixture for validating client recovery logic.
+///
+/// Creates the subject and substitute clients via sending two `MsgCreateClient`
+/// messages. The subject client is initialized in an expired state by sleeping
+/// for the duration of its trusting period. The substitute client state is
+/// initialized with a much longer trusting period and at a height higher than
+/// the subject client state's in order to ensure that it remains in an active
+/// state.
+fn setup_client_recovery_fixture(
+    subject_trusting_period: Duration,
+    subject_height: Height,
+    substitute_trusting_period: Duration,
+    substitute_height: Height,
+) -> Fixture {
+    let mut ctx = MockContext::default();
+    let mut router = MockRouter::new_with_transfer();
+    let signer = dummy_account_id();
+
+    let subject_timestamp = (Timestamp::now() - subject_trusting_period).unwrap();
+
+    // Create the subject client state such that it will be in an expired state by initializing it with
+    // a timestamp that is of duration `subject_trusting_period` in the past
+    let subject_client_state =
+        MockClientState::new(MockHeader::new(subject_height).with_timestamp(subject_timestamp))
+            .with_trusting_period(subject_trusting_period);
+
+    // Create the subject client
+    let msg = MsgCreateClient::new(
+        subject_client_state.into(),
+        MockConsensusState::new(MockHeader::new(subject_height).with_current_timestamp()).into(),
+        signer.clone(),
+    );
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let client_type = mock_client_type();
+    let subject_client_id = client_type.build_client_id(ctx.client_counter().unwrap());
+
+    validate(&ctx, &router, msg_envelope.clone()).expect("create subject client validation");
+    execute(&mut ctx, &mut router, msg_envelope).expect("create subject client execution");
+
+    // Create the substitute client
+    let substitute_client_state =
+        MockClientState::new(MockHeader::new(substitute_height).with_current_timestamp())
+            .with_trusting_period(substitute_trusting_period);
+
+    let msg = MsgCreateClient::new(
+        substitute_client_state.into(),
+        MockConsensusState::new(MockHeader::new(substitute_height).with_current_timestamp()).into(),
+        signer.clone(),
+    );
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let substitute_client_id = client_type.build_client_id(ctx.client_counter().unwrap());
+
+    validate(&ctx, &router, msg_envelope.clone()).expect("create substitute client validation");
+    execute(&mut ctx, &mut router, msg_envelope).expect("create substitute client execution");
+
+    Fixture {
+        ctx,
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    }
+}
+
+#[rstest]
+fn test_recover_client_ok() {
+    let subject_trusting_period = Duration::from_nanos(100);
+    let substitute_trusting_period = Duration::from_secs(3);
+    let subject_height = Height::new(0, 42).unwrap();
+    let substitute_height = Height::new(0, 43).unwrap();
+
+    let Fixture {
+        mut ctx,
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    } = setup_client_recovery_fixture(
+        subject_trusting_period,
+        subject_height,
+        substitute_trusting_period,
+        substitute_height,
+    );
+
+    let msg = MsgRecoverClient {
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    };
+
+    let res = recover_client::validate(&ctx, msg.clone());
+
+    assert!(res.is_ok(), "client recovery validation happy path");
+
+    let res = recover_client::execute(&mut ctx, msg.clone());
+
+    assert!(res.is_ok(), "client recovery execution happy path");
+
+    assert_eq!(
+        ctx.client_state(&msg.subject_client_id).unwrap(),
+        ctx.client_state(&msg.substitute_client_id).unwrap(),
+    );
+}
+
+#[rstest]
+fn test_recover_client_with_expired_substitute() {
+    let subject_trusting_period = Duration::from_nanos(100);
+    let substitute_trusting_period = Duration::from_nanos(100);
+    let subject_height = Height::new(0, 42).unwrap();
+    let substitute_height = Height::new(0, 43).unwrap();
+
+    let Fixture {
+        ctx,
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    } = setup_client_recovery_fixture(
+        subject_trusting_period,
+        subject_height,
+        substitute_trusting_period,
+        substitute_height,
+    );
+
+    let msg = MsgRecoverClient {
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    };
+
+    let res = recover_client::validate(&ctx, msg);
+
+    assert!(res.is_err(), "expected client recovery validation to fail");
+}
+
+#[rstest]
+fn test_recover_client_with_matching_heights() {
+    let subject_trusting_period = Duration::from_nanos(100);
+    let substitute_trusting_period = Duration::from_secs(3);
+    let subject_height = Height::new(0, 42).unwrap();
+    let substitute_height = Height::new(0, 42).unwrap();
+
+    let Fixture {
+        ctx,
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    } = setup_client_recovery_fixture(
+        subject_trusting_period,
+        subject_height,
+        substitute_trusting_period,
+        substitute_height,
+    );
+
+    let msg = MsgRecoverClient {
+        subject_client_id,
+        substitute_client_id,
+        signer,
+    };
+
+    let res = recover_client::validate(&ctx, msg);
+
+    assert!(res.is_err(), "expected client recovery validation to fail");
+}

From d4c36554baf62508c1ee79e0f67904fc58b83b14 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Thu, 4 Apr 2024 19:06:48 -0700
Subject: [PATCH 141/182] imp: include `query_height` and `proof` for client
 upgrade query request/response types (#1153)

* feat: include proof for upgrade client query response

* chore: add changelog

* nit: remove path duplicaitons
---
 .../features/738-client-recovery.md           |  4 +-
 ...ht-and-proof-for-client-upgrade-queries.md |  3 +
 ibc-query/src/core/client/query.rs            | 73 +++++++++++++++++--
 ibc-query/src/core/client/service.rs          | 15 +++-
 ibc-query/src/core/client/types/request.rs    |  8 ++
 ibc-query/src/core/client/types/response.rs   | 46 ++++--------
 6 files changed, 106 insertions(+), 43 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md

diff --git a/.changelog/unreleased/features/738-client-recovery.md b/.changelog/unreleased/features/738-client-recovery.md
index 4717438e7..a1d7c717f 100644
--- a/.changelog/unreleased/features/738-client-recovery.md
+++ b/.changelog/unreleased/features/738-client-recovery.md
@@ -1,4 +1,4 @@
-- [ibc-client] Implement [client recovery][client-recovery] feature.
+- [ibc-core-client] Implement [client recovery][client-recovery] feature.
 ([\#738](https://github.com/cosmos/ibc-rs/issues/738))
 
-client-recovery: https://github.com/cosmos/ibc-go/blob/main/docs/architecture/adr-026-ibc-client-recovery-mechanisms.md
+[client-recovery]: https://github.com/cosmos/ibc-go/blob/main/docs/architecture/adr-026-ibc-client-recovery-mechanisms.md
diff --git a/.changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md b/.changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md
new file mode 100644
index 000000000..4b7bee3d2
--- /dev/null
+++ b/.changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md
@@ -0,0 +1,3 @@
+- [ibc-query] Add support for querying `upgraded_client/consensus_state` at a
+  given height along with returning their proof of existence in the response.
+ ([\#1152](https://github.com/cosmos/ibc-rs/issues/1152))
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index 52ce7d5b1..c7e98170a 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -190,45 +190,102 @@ where
 }
 
 /// Queries for the upgraded client state.
-pub fn query_upgraded_client_state<U>(
+pub fn query_upgraded_client_state<I, U>(
+    ibc_ctx: &I,
     upgrade_ctx: &U,
-    _request: &QueryUpgradedClientStateRequest,
+    request: &QueryUpgradedClientStateRequest,
 ) -> Result<QueryUpgradedClientStateResponse, QueryError>
 where
+    I: QueryContext,
     U: UpgradeValidationContext,
 {
-    let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
+    let upgrade_revision_height = match request.upgrade_height {
+        Some(height) => height.revision_height(),
+        None => {
+            upgrade_ctx
+                .upgrade_plan()
+                .map_err(ClientError::from)?
+                .height
+        }
+    };
 
-    let upgraded_client_state_path = UpgradeClientPath::UpgradedClientState(plan.height);
+    let upgraded_client_state_path =
+        UpgradeClientPath::UpgradedClientState(upgrade_revision_height);
 
     let upgraded_client_state = upgrade_ctx
         .upgraded_client_state(&upgraded_client_state_path)
         .map_err(ClientError::from)?;
 
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
+
+    let proof = ibc_ctx
+        .get_proof(
+            proof_height,
+            &Path::UpgradeClient(upgraded_client_state_path),
+        )
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for upgraded client state at: {proof_height:?}"
+            ))
+        })?;
+
     Ok(QueryUpgradedClientStateResponse::new(
         upgraded_client_state.into(),
+        proof,
+        proof_height,
     ))
 }
 
 /// Queries for the upgraded consensus state.
-pub fn query_upgraded_consensus_state<U>(
+pub fn query_upgraded_consensus_state<I, U>(
+    ibc_ctx: &I,
     upgrade_ctx: &U,
-    _request: &QueryUpgradedConsensusStateRequest,
+    request: &QueryUpgradedConsensusStateRequest,
 ) -> Result<QueryUpgradedConsensusStateResponse, QueryError>
 where
+    I: QueryContext,
     U: UpgradeValidationContext,
     UpgradedConsensusStateRef<U>: Into<Any>,
 {
-    let plan = upgrade_ctx.upgrade_plan().map_err(ClientError::from)?;
+    let upgrade_revision_height = match request.upgrade_height {
+        Some(height) => height.revision_height(),
+        None => {
+            upgrade_ctx
+                .upgrade_plan()
+                .map_err(ClientError::from)?
+                .height
+        }
+    };
 
     let upgraded_consensus_state_path =
-        UpgradeClientPath::UpgradedClientConsensusState(plan.height);
+        UpgradeClientPath::UpgradedClientConsensusState(upgrade_revision_height);
 
     let upgraded_consensus_state = upgrade_ctx
         .upgraded_consensus_state(&upgraded_consensus_state_path)
         .map_err(ClientError::from)?;
 
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
+
+    let proof = ibc_ctx
+        .get_proof(
+            proof_height,
+            &Path::UpgradeClient(upgraded_consensus_state_path),
+        )
+        .ok_or_else(|| {
+            QueryError::proof_not_found(format!(
+                "Proof not found for upgraded consensus state at: {proof_height:?}"
+            ))
+        })?;
+
     Ok(QueryUpgradedConsensusStateResponse::new(
         upgraded_consensus_state.into(),
+        proof,
+        proof_height,
     ))
 }
diff --git a/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
index b5bd21d1e..3c0a96163 100644
--- a/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -124,14 +124,23 @@ where
         &self,
         request: Request<QueryUpgradedClientStateRequest>,
     ) -> Result<Response<QueryUpgradedClientStateResponse>, Status> {
-        query_upgraded_client_state(&self.upgrade_context, &request.into_domain())?.into_response()
+        query_upgraded_client_state(
+            &self.ibc_context,
+            &self.upgrade_context,
+            &request.into_domain(),
+        )?
+        .into_response()
     }
 
     async fn upgraded_consensus_state(
         &self,
         request: Request<QueryUpgradedConsensusStateRequest>,
     ) -> Result<Response<QueryUpgradedConsensusStateResponse>, Status> {
-        query_upgraded_consensus_state(&self.upgrade_context, &request.into_domain())?
-            .into_response()
+        query_upgraded_consensus_state(
+            &self.ibc_context,
+            &self.upgrade_context,
+            &request.into_domain(),
+        )?
+        .into_response()
     }
 }
diff --git a/ibc-query/src/core/client/types/request.rs b/ibc-query/src/core/client/types/request.rs
index ffb9d6170..99e5f61a7 100644
--- a/ibc-query/src/core/client/types/request.rs
+++ b/ibc-query/src/core/client/types/request.rs
@@ -200,12 +200,16 @@ impl From<RawQueryClientParamsRequest> for QueryClientParamsRequest {
 pub struct QueryUpgradedClientStateRequest {
     /// Height at which the chain is scheduled to halt for upgrade
     pub upgrade_height: Option<Height>,
+    /// The height at which to query the upgraded client state. If not provided,
+    /// the latest height should be used.
+    pub query_height: Option<Height>,
 }
 
 impl From<RawUpgradedClientStateRequest> for QueryUpgradedClientStateRequest {
     fn from(_request: RawUpgradedClientStateRequest) -> Self {
         Self {
             upgrade_height: None,
+            query_height: None,
         }
     }
 }
@@ -218,12 +222,16 @@ impl From<RawUpgradedClientStateRequest> for QueryUpgradedClientStateRequest {
 pub struct QueryUpgradedConsensusStateRequest {
     /// Height at which the chain is scheduled to halt for upgrade.
     pub upgrade_height: Option<Height>,
+    /// The height at which to query the upgraded consensus state. If not
+    /// provided, the latest height should be used.
+    pub query_height: Option<Height>,
 }
 
 impl From<RawUpgradedConsensusStateRequest> for QueryUpgradedConsensusStateRequest {
     fn from(_request: RawUpgradedConsensusStateRequest) -> Self {
         Self {
             upgrade_height: None,
+            query_height: None,
         }
     }
 }
diff --git a/ibc-query/src/core/client/types/response.rs b/ibc-query/src/core/client/types/response.rs
index a1339d3a5..fa934c90c 100644
--- a/ibc-query/src/core/client/types/response.rs
+++ b/ibc-query/src/core/client/types/response.rs
@@ -436,31 +436,24 @@ impl From<QueryClientParamsResponse> for RawQueryClientParamsResponse {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryUpgradedClientStateResponse {
+    /// The upgraded client state.
     pub upgraded_client_state: Any,
+    /// The proof of the upgraded client state existence.
+    pub proof: Proof,
+    /// The height at which the proof was retrieved.
+    pub proof_height: Height,
 }
 
 impl QueryUpgradedClientStateResponse {
-    pub fn new(upgraded_client_state: Any) -> Self {
+    pub fn new(upgraded_client_state: Any, proof: Proof, proof_height: Height) -> Self {
         Self {
             upgraded_client_state,
+            proof,
+            proof_height,
         }
     }
 }
 
-impl Protobuf<RawQueryUpgradedClientStateResponse> for QueryUpgradedClientStateResponse {}
-
-impl TryFrom<RawQueryUpgradedClientStateResponse> for QueryUpgradedClientStateResponse {
-    type Error = QueryError;
-
-    fn try_from(value: RawQueryUpgradedClientStateResponse) -> Result<Self, Self::Error> {
-        Ok(Self {
-            upgraded_client_state: value
-                .upgraded_client_state
-                .ok_or_else(|| QueryError::missing_field("upgraded_client_state"))?,
-        })
-    }
-}
-
 impl From<QueryUpgradedClientStateResponse> for RawQueryUpgradedClientStateResponse {
     fn from(response: QueryUpgradedClientStateResponse) -> Self {
         Self {
@@ -474,31 +467,24 @@ impl From<QueryUpgradedClientStateResponse> for RawQueryUpgradedClientStateRespo
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryUpgradedConsensusStateResponse {
+    /// The upgraded consensus state.
     pub upgraded_consensus_state: Any,
+    /// The proof of the upgraded consensus state existence.
+    pub proof: Proof,
+    /// The height at which the proof was retrieved.
+    pub proof_height: Height,
 }
 
 impl QueryUpgradedConsensusStateResponse {
-    pub fn new(upgraded_consensus_state: Any) -> Self {
+    pub fn new(upgraded_consensus_state: Any, proof: Proof, proof_height: Height) -> Self {
         Self {
             upgraded_consensus_state,
+            proof,
+            proof_height,
         }
     }
 }
 
-impl Protobuf<RawQueryUpgradedConsensusStateResponse> for QueryUpgradedConsensusStateResponse {}
-
-impl TryFrom<RawQueryUpgradedConsensusStateResponse> for QueryUpgradedConsensusStateResponse {
-    type Error = QueryError;
-
-    fn try_from(value: RawQueryUpgradedConsensusStateResponse) -> Result<Self, Self::Error> {
-        Ok(Self {
-            upgraded_consensus_state: value
-                .upgraded_consensus_state
-                .ok_or_else(|| QueryError::missing_field("upgraded_consensus_state"))?,
-        })
-    }
-}
-
 impl From<QueryUpgradedConsensusStateResponse> for RawQueryUpgradedConsensusStateResponse {
     fn from(response: QueryUpgradedConsensusStateResponse) -> Self {
         Self {

From 1f581fa8cb03f66bab72e181ceca03ed148fb8f1 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 5 Apr 2024 11:12:13 -0700
Subject: [PATCH 142/182] chore: add `into_inner()` for ICS07 `ConsensusState`
 (#1156)

* chore: add into_inner() for TmConsensusState + remove redundant cloning in check_substitute

* fix: markdown-lint-check

* chore: add unclog

* nit

* fix: revert adr007 playground
---
 ...156-add-into-inner-for-ics07-consensus-state.md |  2 ++
 docs/architecture/adr-007-light-client-contexts.md | 14 +++++++-------
 .../src/client_state/validation.rs                 | 12 ++++++------
 .../ics07-tendermint/src/consensus_state.rs        |  4 ++++
 4 files changed, 19 insertions(+), 13 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md

diff --git a/.changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md b/.changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md
new file mode 100644
index 000000000..08c42925b
--- /dev/null
+++ b/.changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md
@@ -0,0 +1,2 @@
+- [ibc-client-tendermint] Add `into_inner()` method to ICS07 `ConsensusState`
+  ([\#1156](https://github.com/cosmos/ibc-rs/pull/1156))
diff --git a/docs/architecture/adr-007-light-client-contexts.md b/docs/architecture/adr-007-light-client-contexts.md
index 834a74bfb..b0caabdd5 100644
--- a/docs/architecture/adr-007-light-client-contexts.md
+++ b/docs/architecture/adr-007-light-client-contexts.md
@@ -13,7 +13,7 @@ This ADR is meant to address the main limitation of our current light client API
     + By giving the light clients access to `ValidationContext` and `ExecutionContext`, we're effectively giving them the same capabilities as the core handlers.
     + Although our current model is that all code is trusted (including light clients we didn't write), restraining the capabilities we give to light clients at the very least eliminates a class of bugs (e.g. calling the wrong method), and serves as documentation for exactly which methods the light client needs.
 
-This ADR is all about fixing this issue; namely, to enable light clients to define their own `ValidationContext` and `ExecutionContext` traits for the host to implement. 
+This ADR is all about fixing this issue; namely, to enable light clients to define their own `ValidationContext` and `ExecutionContext` traits for the host to implement.
 
 [ADR 4]: ../architecture/adr-004-light-client-crates-extraction.md
 [later improved]: https://github.com/cosmos/ibc-rs/pull/584
@@ -26,9 +26,9 @@ This ADR is all about fixing this issue; namely, to enable light clients to defi
 
 ### Changes to `ClientState`
 
-The `ClientState` functionality is split into 3 traits: 
-+ `ClientStateCommon`, 
-+ `ClientStateValidation<ClientValidationContext>`, and 
+The `ClientState` functionality is split into 3 traits:
++ `ClientStateCommon`,
++ `ClientStateValidation<ClientValidationContext>`, and
 + `ClientStateExecution<ClientExecutionContext>`
 
 Then, `ClientState` is defined as
@@ -68,7 +68,7 @@ where
         &self,
         ctx: &ClientValidationContext,
         // ...
-    ) -> Result<(), ClientError> { 
+    ) -> Result<(), ClientError> {
         // `get_resource_Y()` accessible through `ctx`
     }
 
@@ -93,7 +93,7 @@ where `ClientExecutionContext` is defined as (simplified)
 
 ```rust
 pub trait ClientExecutionContext: Sized {
-    // ... a few associated types 
+    // ... a few associated types
 
     /// Called upon successful client creation and update
     fn store_client_state(
@@ -235,7 +235,7 @@ We ended up having to write our own custom derive macros because existing crates
 
 ### Negative
 + Increased complexity.
-+ Harder to document. 
++ Harder to document.
     + Specifically, we do not write any trait bounds on the `Client{Validation, Execution}Context` generic parameters. The effective trait bounds are spread across all light client implementations that a given host uses.
 
 
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 2510a8ade..d3d53f018 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -232,7 +232,7 @@ where
         max_clock_drift: subject_max_clock_drift,
         proof_specs: subject_proof_specs,
         upgrade_path: subject_upgrade_path,
-    } = subject_client_state.clone();
+    } = subject_client_state;
 
     let substitute_client_state = ClientStateType::try_from(substitute_client_state)?;
 
@@ -249,11 +249,11 @@ where
         upgrade_path: substitute_upgrade_path,
     } = substitute_client_state;
 
-    (subject_trust_level == substitute_trust_level
-        && subject_unbonding_period == substitute_unbonding_period
-        && subject_max_clock_drift == substitute_max_clock_drift
-        && subject_proof_specs == substitute_proof_specs
-        && subject_upgrade_path == substitute_upgrade_path)
+    (subject_trust_level == &substitute_trust_level
+        && subject_unbonding_period == &substitute_unbonding_period
+        && subject_max_clock_drift == &substitute_max_clock_drift
+        && subject_proof_specs == &substitute_proof_specs
+        && subject_upgrade_path == &substitute_upgrade_path)
         .then_some(())
         .ok_or(ClientError::ClientRecoveryStateMismatch)
 }
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
index 242c82be4..f2473d63a 100644
--- a/ibc-clients/ics07-tendermint/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -30,6 +30,10 @@ impl ConsensusState {
         &self.0
     }
 
+    pub fn into_inner(self) -> ConsensusStateType {
+        self.0
+    }
+
     pub fn timestamp(&self) -> Time {
         self.0.timestamp
     }

From 91bee674161dc2b84708fbf06dda55c04c3c55f0 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 8 Apr 2024 09:01:20 -0700
Subject: [PATCH 143/182] fix: update standalone query functions to use the
 specified `query_height` (#1155)

* fix: use query_height in query functions

* chore: add changelog

* nit
---
 ...-query-height-in-query-helper-functions.md |  2 +
 ibc-query/src/core/channel/query.rs           | 77 ++++++++++++-------
 ibc-query/src/core/client/query.rs            | 18 +++--
 ibc-query/src/core/connection/query.rs        | 36 ++++++---
 .../src/core/connection/types/request.rs      |  2 +
 5 files changed, 89 insertions(+), 46 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md

diff --git a/.changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md b/.changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md
new file mode 100644
index 000000000..cf1e2bde2
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md
@@ -0,0 +1,2 @@
+- [ibc-query] Update standalone query functions to use the specified query
+  height ([\#1154](https://github.com/cosmos/ibc-rs/issues/1154))
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index ff39fec72..19875c78f 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -39,20 +39,20 @@ where
 
     let channel_end = ibc_ctx.channel_end(&channel_end_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
+
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::ChannelEnd(channel_end_path.clone()))
+        .get_proof(proof_height, &Path::ChannelEnd(channel_end_path.clone()))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Proof not found for channel end path {channel_end_path:?}"
             ))
         })?;
 
-    Ok(QueryChannelResponse::new(
-        channel_end,
-        proof,
-        current_height,
-    ))
+    Ok(QueryChannelResponse::new(channel_end, proof, proof_height))
 }
 
 /// Queries for all existing IBC channels and returns the corresponding channel ends
@@ -129,11 +129,14 @@ where
 
     let client_state = client_val_ctx.client_state(connection_end.client_id())?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
         .ok_or_else(|| {
@@ -146,7 +149,7 @@ where
     Ok(QueryChannelClientStateResponse::new(
         IdentifiedClientState::new(connection_end.client_id().clone(), client_state.into()),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -184,11 +187,14 @@ where
 
     let consensus_state = client_val_ctx.consensus_state(&consensus_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientConsensusState(consensus_path.clone()),
         )
         .ok_or_else(|| {
@@ -201,7 +207,7 @@ where
         consensus_state.into(),
         connection_end.client_id().clone(),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -219,10 +225,13 @@ where
 
     let packet_commitment_data = ibc_ctx.get_packet_commitment(&commitment_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::Commitment(commitment_path.clone()))
+        .get_proof(proof_height, &Path::Commitment(commitment_path.clone()))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Proof not found for packet commitment path: {commitment_path:?}"
@@ -232,7 +241,7 @@ where
     Ok(QueryPacketCommitmentResponse::new(
         packet_commitment_data,
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -274,10 +283,13 @@ where
     // Unreceived packets are not stored
     let packet_receipt_data = ibc_ctx.get_packet_receipt(&receipt_path);
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::Receipt(receipt_path.clone()))
+        .get_proof(proof_height, &Path::Receipt(receipt_path.clone()))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Proof not found for packet receipt path: {receipt_path:?}"
@@ -287,7 +299,7 @@ where
     Ok(QueryPacketReceiptResponse::new(
         packet_receipt_data.is_ok(),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -305,10 +317,13 @@ where
 
     let packet_acknowledgement_data = ibc_ctx.get_packet_acknowledgement(&acknowledgement_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::Ack(acknowledgement_path.clone()))
+        .get_proof(proof_height, &Path::Ack(acknowledgement_path.clone()))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Proof not found for packet acknowledgement path: {acknowledgement_path:?}"
@@ -318,7 +333,7 @@ where
     Ok(QueryPacketAcknowledgementResponse::new(
         packet_acknowledgement_data,
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -408,10 +423,13 @@ where
 
     let next_sequence_send = ibc_ctx.get_next_sequence_send(&next_seq_send_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::SeqSend(next_seq_send_path))
+        .get_proof(proof_height, &Path::SeqSend(next_seq_send_path))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Next sequence send proof not found for channel {}",
@@ -422,7 +440,7 @@ where
     Ok(QueryNextSequenceSendResponse::new(
         next_sequence_send,
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -438,10 +456,13 @@ where
 
     let next_sequence_recv = ibc_ctx.get_next_sequence_recv(&next_seq_recv_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::SeqRecv(next_seq_recv_path))
+        .get_proof(proof_height, &Path::SeqRecv(next_seq_recv_path))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Next sequence receive proof not found for channel {}",
@@ -452,6 +473,6 @@ where
     Ok(QueryNextSequenceReceiveResponse::new(
         next_sequence_recv,
         proof,
-        current_height,
+        proof_height,
     ))
 }
diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index c7e98170a..ab9ee05c2 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -38,11 +38,14 @@ where
 
     let client_state = client_val_ctx.client_state(&client_id)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientState(ClientStatePath::new(client_id.clone())),
         )
         .ok_or_else(|| {
@@ -54,7 +57,7 @@ where
     Ok(QueryClientStateResponse::new(
         client_state.into(),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -111,11 +114,14 @@ where
             })?
     };
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientConsensusState(ClientConsensusStatePath::new(
                 client_id.clone(),
                 height.revision_number(),
@@ -131,7 +137,7 @@ where
     Ok(QueryConsensusStateResponse::new(
         consensus_state.into(),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
diff --git a/ibc-query/src/core/connection/query.rs b/ibc-query/src/core/connection/query.rs
index 419c45417..d156c4c1c 100644
--- a/ibc-query/src/core/connection/query.rs
+++ b/ibc-query/src/core/connection/query.rs
@@ -30,11 +30,14 @@ where
 {
     let connection_end = ibc_ctx.connection_end(&request.connection_id)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::Connection(ConnectionPath::new(&request.connection_id)),
         )
         .ok_or_else(|| {
@@ -47,7 +50,7 @@ where
     Ok(QueryConnectionResponse::new(
         connection_end,
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -78,11 +81,14 @@ where
 {
     let connections = ibc_ctx.client_connection_ends(&request.client_id)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof: Proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientConnection(ClientConnectionPath::new(request.client_id.clone())),
         )
         .ok_or_else(|| {
@@ -95,7 +101,7 @@ where
     Ok(QueryClientConnectionsResponse::new(
         connections,
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -113,11 +119,14 @@ where
 
     let client_state = client_val_ctx.client_state(connection_end.client_id())?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
         .get_proof(
-            current_height,
+            proof_height,
             &Path::ClientState(ClientStatePath::new(connection_end.client_id().clone())),
         )
         .ok_or_else(|| {
@@ -130,7 +139,7 @@ where
     Ok(QueryConnectionClientStateResponse::new(
         IdentifiedClientState::new(connection_end.client_id().clone(), client_state.into()),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
@@ -155,10 +164,13 @@ where
 
     let consensus_state = client_val_ctx.consensus_state(&consensus_path)?;
 
-    let current_height = ibc_ctx.host_height()?;
+    let proof_height = match request.query_height {
+        Some(height) => height,
+        None => ibc_ctx.host_height()?,
+    };
 
     let proof = ibc_ctx
-        .get_proof(current_height, &Path::ClientConsensusState(consensus_path))
+        .get_proof(proof_height, &Path::ClientConsensusState(consensus_path))
         .ok_or_else(|| {
             QueryError::proof_not_found(format!(
                 "Proof not found for consensus state path: {:?}",
@@ -170,7 +182,7 @@ where
         consensus_state.into(),
         connection_end.client_id().clone(),
         proof,
-        current_height,
+        proof_height,
     ))
 }
 
diff --git a/ibc-query/src/core/connection/types/request.rs b/ibc-query/src/core/connection/types/request.rs
index e62262adf..cf0f5a6f9 100644
--- a/ibc-query/src/core/connection/types/request.rs
+++ b/ibc-query/src/core/connection/types/request.rs
@@ -59,6 +59,7 @@ impl From<RawQueryConnectionsRequest> for QueryConnectionsRequest {
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryClientConnectionsRequest {
     pub client_id: ClientId,
+    pub query_height: Option<Height>,
 }
 
 impl TryFrom<RawQueryClientConnectionsRequest> for QueryClientConnectionsRequest {
@@ -67,6 +68,7 @@ impl TryFrom<RawQueryClientConnectionsRequest> for QueryClientConnectionsRequest
     fn try_from(request: RawQueryClientConnectionsRequest) -> Result<Self, Self::Error> {
         Ok(Self {
             client_id: request.client_id.parse()?,
+            query_height: None,
         })
     }
 }

From f7a3c2b23f42977392b2f2ca908cc98d00765ff5 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 8 Apr 2024 13:38:41 -0700
Subject: [PATCH 144/182] feat: allow custom `HostFunctionsProvider` in
 `MerkleProof` (#1158)

* feat: allow HostFunctionsProvider in MerkleProof

* nit: consistent generic name H

* feat: use hash_with<H> for hashing validator sets

* fix: make verify_upgrade_client func generic over HostFunctionsProvider

* chore: add changelog
---
 ...1147-allow-custom-HostFunctionsProvider.md |  4 ++
 .../src/client_state/common.rs                | 49 +++++++++++--------
 .../src/client_state/misbehaviour.rs          | 20 +++++---
 .../src/client_state/update_client.rs         | 12 +++--
 .../src/client_state/validation.rs            | 12 +++--
 .../ics07-tendermint/types/src/header.rs      | 14 ++++--
 .../types/src/misbehaviour.rs                 |  8 +--
 ibc-core/ics23-commitment/types/src/merkle.rs | 46 +++++++----------
 8 files changed, 93 insertions(+), 72 deletions(-)
 create mode 100644 .changelog/v0.51.0/feature/1147-allow-custom-HostFunctionsProvider.md

diff --git a/.changelog/v0.51.0/feature/1147-allow-custom-HostFunctionsProvider.md b/.changelog/v0.51.0/feature/1147-allow-custom-HostFunctionsProvider.md
new file mode 100644
index 000000000..dd792f66b
--- /dev/null
+++ b/.changelog/v0.51.0/feature/1147-allow-custom-HostFunctionsProvider.md
@@ -0,0 +1,4 @@
+- [ibc] Enable the use of custom hashing functions by making `MerkleProof`
+  validation methods generic over `HostFunctionsProvider` and using
+  `hash_with<H>()` instead of `hash()` wherever validators' hash is computed.
+  ([\#1147](https://github.com/cosmos/ibc-rs/issues/1147))
diff --git a/ibc-clients/ics07-tendermint/src/client_state/common.rs b/ibc-clients/ics07-tendermint/src/client_state/common.rs
index 583a1f36a..b7a7daf5b 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/common.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/common.rs
@@ -7,6 +7,8 @@ use ibc_core_commitment_types::commitment::{
     CommitmentPrefix, CommitmentProofBytes, CommitmentRoot,
 };
 use ibc_core_commitment_types::merkle::{apply_prefix, MerkleProof};
+use ibc_core_commitment_types::proto::ics23::{HostFunctionsManager, HostFunctionsProvider};
+use ibc_core_commitment_types::specs::ProofSpecs;
 use ibc_core_host::types::identifiers::ClientType;
 use ibc_core_host::types::path::{Path, UpgradeClientPath};
 use ibc_primitives::prelude::*;
@@ -41,7 +43,7 @@ impl ClientStateCommon for ClientState {
         proof_upgrade_consensus_state: CommitmentProofBytes,
         root: &CommitmentRoot,
     ) -> Result<(), ClientError> {
-        verify_upgrade_client(
+        verify_upgrade_client::<HostFunctionsManager>(
             self.inner(),
             upgraded_client_state,
             upgraded_consensus_state,
@@ -59,7 +61,14 @@ impl ClientStateCommon for ClientState {
         path: Path,
         value: Vec<u8>,
     ) -> Result<(), ClientError> {
-        verify_membership(self.inner(), prefix, proof, root, path, value)
+        verify_membership::<HostFunctionsManager>(
+            &self.inner().proof_specs,
+            prefix,
+            proof,
+            root,
+            path,
+            value,
+        )
     }
 
     fn verify_non_membership(
@@ -69,7 +78,13 @@ impl ClientStateCommon for ClientState {
         root: &CommitmentRoot,
         path: Path,
     ) -> Result<(), ClientError> {
-        verify_non_membership(self.inner(), prefix, proof, root, path)
+        verify_non_membership::<HostFunctionsManager>(
+            &self.inner().proof_specs,
+            prefix,
+            proof,
+            root,
+            path,
+        )
     }
 }
 
@@ -124,7 +139,7 @@ pub fn validate_proof_height(
 /// Note that this function is typically implemented as part of the
 /// [`ClientStateCommon`] trait, but has been made a standalone function
 /// in order to make the ClientState APIs more flexible.
-pub fn verify_upgrade_client(
+pub fn verify_upgrade_client<H: HostFunctionsProvider>(
     client_state: &ClientStateType,
     upgraded_client_state: Any,
     upgraded_consensus_state: Any,
@@ -166,8 +181,8 @@ pub fn verify_upgrade_client(
     let last_height = latest_height.revision_height();
 
     // Verify the proof of the upgraded client state
-    verify_membership(
-        client_state,
+    verify_membership::<H>(
+        &client_state.proof_specs,
         &upgrade_path_prefix,
         &proof_upgrade_client,
         root,
@@ -176,8 +191,8 @@ pub fn verify_upgrade_client(
     )?;
 
     // Verify the proof of the upgraded consensus state
-    verify_membership(
-        client_state,
+    verify_membership::<H>(
+        &client_state.proof_specs,
         &upgrade_path_prefix,
         &proof_upgrade_consensus_state,
         root,
@@ -193,8 +208,8 @@ pub fn verify_upgrade_client(
 /// Note that this function is typically implemented as part of the
 /// [`ClientStateCommon`] trait, but has been made a standalone function
 /// in order to make the ClientState APIs more flexible.
-pub fn verify_membership(
-    client_state: &ClientStateType,
+pub fn verify_membership<H: HostFunctionsProvider>(
+    proof_specs: &ProofSpecs,
     prefix: &CommitmentPrefix,
     proof: &CommitmentProofBytes,
     root: &CommitmentRoot,
@@ -205,13 +220,7 @@ pub fn verify_membership(
     let merkle_proof = MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
 
     merkle_proof
-        .verify_membership(
-            &client_state.proof_specs,
-            root.clone().into(),
-            merkle_path,
-            value,
-            0,
-        )
+        .verify_membership::<H>(proof_specs, root.clone().into(), merkle_path, value, 0)
         .map_err(ClientError::Ics23Verification)
 }
 
@@ -220,8 +229,8 @@ pub fn verify_membership(
 /// Note that this function is typically implemented as part of the
 /// [`ClientStateCommon`] trait, but has been made a standalone function
 /// in order to make the ClientState APIs more flexible.
-pub fn verify_non_membership(
-    client_state: &ClientStateType,
+pub fn verify_non_membership<H: HostFunctionsProvider>(
+    proof_specs: &ProofSpecs,
     prefix: &CommitmentPrefix,
     proof: &CommitmentProofBytes,
     root: &CommitmentRoot,
@@ -231,6 +240,6 @@ pub fn verify_non_membership(
     let merkle_proof = MerkleProof::try_from(proof).map_err(ClientError::InvalidCommitmentProof)?;
 
     merkle_proof
-        .verify_non_membership(&client_state.proof_specs, root.clone().into(), merkle_path)
+        .verify_non_membership::<H>(proof_specs, root.clone().into(), merkle_path)
         .map_err(ClientError::Ics23Verification)
 }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 8baa95c27..b9b6132b2 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -5,6 +5,8 @@ use ibc_core_host::types::identifiers::{ChainId, ClientId};
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
+use tendermint::crypto::Sha256;
+use tendermint::merkle::MerkleHash;
 use tendermint::{Hash, Time};
 use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::Verifier;
@@ -15,7 +17,7 @@ use crate::types::Header;
 
 /// Determines whether or not two conflicting headers at the same height would
 /// have convinced the light client.
-pub fn verify_misbehaviour<V>(
+pub fn verify_misbehaviour<V, H>(
     ctx: &V,
     misbehaviour: &TmMisbehaviour,
     client_id: &ClientId,
@@ -26,8 +28,9 @@ pub fn verify_misbehaviour<V>(
 where
     V: TmValidationContext,
     V::ConsensusStateRef: ConsensusStateConverter,
+    H: MerkleHash + Sha256 + Default,
 {
-    misbehaviour.validate_basic()?;
+    misbehaviour.validate_basic::<H>()?;
 
     let header_1 = misbehaviour.header1();
     let trusted_consensus_state_1 = {
@@ -55,7 +58,7 @@ where
 
     let current_timestamp = ctx.host_timestamp()?;
 
-    verify_misbehaviour_header(
+    verify_misbehaviour_header::<H>(
         header_1,
         chain_id,
         options,
@@ -64,7 +67,7 @@ where
         current_timestamp,
         verifier,
     )?;
-    verify_misbehaviour_header(
+    verify_misbehaviour_header::<H>(
         header_2,
         chain_id,
         options,
@@ -75,7 +78,7 @@ where
     )
 }
 
-pub fn verify_misbehaviour_header(
+pub fn verify_misbehaviour_header<H>(
     header: &TmHeader,
     chain_id: &ChainId,
     options: &Options,
@@ -83,9 +86,12 @@ pub fn verify_misbehaviour_header(
     trusted_next_validator_hash: Hash,
     current_timestamp: Timestamp,
     verifier: &impl TmVerifier,
-) -> Result<(), ClientError> {
+) -> Result<(), ClientError>
+where
+    H: MerkleHash + Sha256 + Default,
+{
     // ensure correctness of the trusted next validator set provided by the relayer
-    header.check_trusted_next_validator_set(&trusted_next_validator_hash)?;
+    header.check_trusted_next_validator_set::<H>(&trusted_next_validator_hash)?;
 
     // ensure trusted consensus state is within trusting period
     {
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 195aad6d2..5fe5ad05d 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -5,6 +5,8 @@ use ibc_core_client::types::Height;
 use ibc_core_host::types::identifiers::{ChainId, ClientId};
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
+use tendermint::crypto::Sha256;
+use tendermint::merkle::MerkleHash;
 use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
@@ -13,7 +15,7 @@ use crate::context::{
     ConsensusStateConverter, TmVerifier, ValidationContext as TmValidationContext,
 };
 
-pub fn verify_header<V>(
+pub fn verify_header<V, H>(
     ctx: &V,
     header: &TmHeader,
     client_id: &ClientId,
@@ -24,9 +26,10 @@ pub fn verify_header<V>(
 where
     V: TmValidationContext,
     V::ConsensusStateRef: ConsensusStateConverter,
+    H: MerkleHash + Sha256 + Default,
 {
     // Checks that the header fields are valid.
-    header.validate_basic()?;
+    header.validate_basic::<H>()?;
 
     // The tendermint-light-client crate though works on heights that are assumed
     // to have the same revision number. We ensure this here.
@@ -45,8 +48,9 @@ where
                 .consensus_state(&trusted_client_cons_state_path)?
                 .try_into()?;
 
-            header
-                .check_trusted_next_validator_set(&trusted_consensus_state.next_validators_hash)?;
+            header.check_trusted_next_validator_set::<H>(
+                &trusted_consensus_state.next_validators_hash,
+            )?;
 
             TrustedBlockState {
                 chain_id: &chain_id
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index d3d53f018..bf7d62f44 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -9,6 +9,9 @@ use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
+use tendermint::crypto::default::Sha256;
+use tendermint::crypto::Sha256 as Sha256Trait;
+use tendermint::merkle::MerkleHash;
 
 use super::{check_for_misbehaviour_on_misbehavior, check_for_misbehaviour_on_update, ClientState};
 use crate::client_state::{verify_header, verify_misbehaviour};
@@ -31,7 +34,7 @@ where
         client_id: &ClientId,
         client_message: Any,
     ) -> Result<(), ClientError> {
-        verify_client_message(
+        verify_client_message::<V, Sha256>(
             self.inner(),
             ctx,
             client_id,
@@ -67,7 +70,7 @@ where
 /// function, except for an additional `verifier` parameter that allows users
 /// who require custom verification logic to easily pass in their own verifier
 /// implementation.
-pub fn verify_client_message<V>(
+pub fn verify_client_message<V, H>(
     client_state: &ClientStateType,
     ctx: &V,
     client_id: &ClientId,
@@ -77,11 +80,12 @@ pub fn verify_client_message<V>(
 where
     V: TmValidationContext,
     V::ConsensusStateRef: ConsensusStateConverter,
+    H: MerkleHash + Sha256Trait + Default,
 {
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
             let header = TmHeader::try_from(client_message)?;
-            verify_header(
+            verify_header::<V, H>(
                 ctx,
                 &header,
                 client_id,
@@ -92,7 +96,7 @@ where
         }
         TENDERMINT_MISBEHAVIOUR_TYPE_URL => {
             let misbehaviour = TmMisbehaviour::try_from(client_message)?;
-            verify_misbehaviour(
+            verify_misbehaviour::<V, H>(
                 ctx,
                 &misbehaviour,
                 client_id,
diff --git a/ibc-clients/ics07-tendermint/types/src/header.rs b/ibc-clients/ics07-tendermint/types/src/header.rs
index 2cedca12a..97b421ff3 100644
--- a/ibc-clients/ics07-tendermint/types/src/header.rs
+++ b/ibc-clients/ics07-tendermint/types/src/header.rs
@@ -14,6 +14,8 @@ use ibc_proto::Protobuf;
 use pretty::{PrettySignedHeader, PrettyValidatorSet};
 use tendermint::block::signed_header::SignedHeader;
 use tendermint::chain::Id as TmChainId;
+use tendermint::crypto::Sha256;
+use tendermint::merkle::MerkleHash;
 use tendermint::validator::Set as ValidatorSet;
 use tendermint::{Hash, Time};
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
@@ -101,11 +103,11 @@ impl Header {
     /// `header.trusted_next_validator_set` was given to us by the relayer.
     /// Thus, we need to ensure that the relayer gave us the right set, i.e. by
     /// ensuring that it matches the hash we have stored on chain.
-    pub fn check_trusted_next_validator_set(
+    pub fn check_trusted_next_validator_set<H: MerkleHash + Sha256 + Default>(
         &self,
         trusted_next_validator_hash: &Hash,
     ) -> Result<(), ClientError> {
-        if &self.trusted_next_validator_set.hash() == trusted_next_validator_hash {
+        if &self.trusted_next_validator_set.hash_with::<H>() == trusted_next_validator_hash {
             Ok(())
         } else {
             Err(ClientError::HeaderVerificationFailure {
@@ -117,7 +119,7 @@ impl Header {
     }
 
     /// Checks if the fields of a given header are consistent with the trusted fields of this header.
-    pub fn validate_basic(&self) -> Result<(), Error> {
+    pub fn validate_basic<H: MerkleHash + Sha256 + Default>(&self) -> Result<(), Error> {
         if self.height().revision_number() != self.trusted_height.revision_number() {
             return Err(Error::MismatchHeightRevisions {
                 trusted_revision: self.trusted_height.revision_number(),
@@ -135,10 +137,12 @@ impl Header {
             });
         }
 
-        if self.validator_set.hash() != self.signed_header.header.validators_hash {
+        let validators_hash = self.validator_set.hash_with::<H>();
+
+        if validators_hash != self.signed_header.header.validators_hash {
             return Err(Error::MismatchValidatorsHashes {
                 signed_header_validators_hash: self.signed_header.header.validators_hash,
-                validators_hash: self.validator_set.hash(),
+                validators_hash,
             });
         }
 
diff --git a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
index 5441ea12a..c51f1892f 100644
--- a/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/types/src/misbehaviour.rs
@@ -6,6 +6,8 @@ use ibc_primitives::prelude::*;
 use ibc_proto::google::protobuf::Any;
 use ibc_proto::ibc::lightclients::tendermint::v1::Misbehaviour as RawMisbehaviour;
 use ibc_proto::Protobuf;
+use tendermint::crypto::Sha256;
+use tendermint::merkle::MerkleHash;
 
 use crate::error::Error;
 use crate::header::Header;
@@ -42,9 +44,9 @@ impl Misbehaviour {
         &self.header2
     }
 
-    pub fn validate_basic(&self) -> Result<(), Error> {
-        self.header1.validate_basic()?;
-        self.header2.validate_basic()?;
+    pub fn validate_basic<H: MerkleHash + Sha256 + Default>(&self) -> Result<(), Error> {
+        self.header1.validate_basic::<H>()?;
+        self.header2.validate_basic::<H>()?;
 
         if self.header1.signed_header.header.chain_id != self.header2.signed_header.header.chain_id
         {
diff --git a/ibc-core/ics23-commitment/types/src/merkle.rs b/ibc-core/ics23-commitment/types/src/merkle.rs
index 308cb424e..cb36590ca 100644
--- a/ibc-core/ics23-commitment/types/src/merkle.rs
+++ b/ibc-core/ics23-commitment/types/src/merkle.rs
@@ -1,13 +1,13 @@
 //! Merkle proof utilities
 
 use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Protobuf;
 use ibc_proto::ibc::core::commitment::v1::{MerklePath, MerkleProof as RawMerkleProof, MerkleRoot};
 use ibc_proto::ics23::commitment_proof::Proof;
 use ibc_proto::ics23::{
     calculate_existence_root, verify_membership, verify_non_membership, CommitmentProof,
-    NonExistenceProof,
+    HostFunctionsProvider, NonExistenceProof,
 };
-use ibc_proto::Protobuf;
 
 use crate::commitment::{CommitmentPrefix, CommitmentRoot};
 use crate::error::CommitmentError;
@@ -53,7 +53,7 @@ impl From<MerkleProof> for RawMerkleProof {
 }
 
 impl MerkleProof {
-    pub fn verify_membership(
+    pub fn verify_membership<H: HostFunctionsProvider>(
         &self,
         specs: &ProofSpecs,
         root: MerkleRoot,
@@ -96,17 +96,10 @@ impl MerkleProof {
         {
             match &proof.proof {
                 Some(Proof::Exist(existence_proof)) => {
-                    subroot =
-                        calculate_existence_root::<ics23::HostFunctionsManager>(existence_proof)
-                            .map_err(|_| CommitmentError::InvalidMerkleProof)?;
-
-                    if !verify_membership::<ics23::HostFunctionsManager>(
-                        proof,
-                        spec,
-                        &subroot,
-                        key.as_bytes(),
-                        &value,
-                    ) {
+                    subroot = calculate_existence_root::<H>(existence_proof)
+                        .map_err(|_| CommitmentError::InvalidMerkleProof)?;
+
+                    if !verify_membership::<H>(proof, spec, &subroot, key.as_bytes(), &value) {
                         return Err(CommitmentError::VerificationFailure);
                     }
                     value.clone_from(&subroot);
@@ -122,7 +115,7 @@ impl MerkleProof {
         Ok(())
     }
 
-    pub fn verify_non_membership(
+    pub fn verify_non_membership<H: HostFunctionsProvider>(
         &self,
         specs: &ProofSpecs,
         root: MerkleRoot,
@@ -159,19 +152,14 @@ impl MerkleProof {
             .ok_or(CommitmentError::InvalidMerkleProof)?;
         match &proof.proof {
             Some(Proof::Nonexist(non_existence_proof)) => {
-                let subroot = calculate_non_existence_root(non_existence_proof)?;
-
-                if !verify_non_membership::<ics23::HostFunctionsManager>(
-                    proof,
-                    spec,
-                    &subroot,
-                    key.as_bytes(),
-                ) {
+                let subroot = calculate_non_existence_root::<H>(non_existence_proof)?;
+
+                if !verify_non_membership::<H>(proof, spec, &subroot, key.as_bytes()) {
                     return Err(CommitmentError::VerificationFailure);
                 }
 
                 // verify membership proofs starting from index 1 with value = subroot
-                self.verify_membership(specs, root, keys, subroot, 1)
+                self.verify_membership::<H>(specs, root, keys, subroot, 1)
             }
             _ => Err(CommitmentError::InvalidMerkleProof),
         }
@@ -179,13 +167,13 @@ impl MerkleProof {
 }
 
 // TODO move to ics23
-fn calculate_non_existence_root(proof: &NonExistenceProof) -> Result<Vec<u8>, CommitmentError> {
+fn calculate_non_existence_root<H: HostFunctionsProvider>(
+    proof: &NonExistenceProof,
+) -> Result<Vec<u8>, CommitmentError> {
     if let Some(left) = &proof.left {
-        calculate_existence_root::<ics23::HostFunctionsManager>(left)
-            .map_err(|_| CommitmentError::InvalidMerkleProof)
+        calculate_existence_root::<H>(left).map_err(|_| CommitmentError::InvalidMerkleProof)
     } else if let Some(right) = &proof.right {
-        calculate_existence_root::<ics23::HostFunctionsManager>(right)
-            .map_err(|_| CommitmentError::InvalidMerkleProof)
+        calculate_existence_root::<H>(right).map_err(|_| CommitmentError::InvalidMerkleProof)
     } else {
         Err(CommitmentError::InvalidMerkleProof)
     }

From c659e210d202490b69719bc5aa4138aaeb8d82be Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Fri, 12 Apr 2024 17:01:59 -0700
Subject: [PATCH 145/182] fix: use upgrade_ctx in updgraded_client/cons_states
 for querying proof (#1161)

---
 ibc-query/src/core/client/query.rs   | 14 +++++++-------
 ibc-query/src/core/client/service.rs |  4 ++--
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/ibc-query/src/core/client/query.rs b/ibc-query/src/core/client/query.rs
index ab9ee05c2..076aa8329 100644
--- a/ibc-query/src/core/client/query.rs
+++ b/ibc-query/src/core/client/query.rs
@@ -21,7 +21,7 @@ use super::{
     QueryUpgradedConsensusStateResponse,
 };
 use crate::core::client::QueryClientStateRequest;
-use crate::core::context::QueryContext;
+use crate::core::context::{ProvableContext, QueryContext};
 use crate::error::QueryError;
 
 /// Queries for the client state of a given client id.
@@ -202,8 +202,8 @@ pub fn query_upgraded_client_state<I, U>(
     request: &QueryUpgradedClientStateRequest,
 ) -> Result<QueryUpgradedClientStateResponse, QueryError>
 where
-    I: QueryContext,
-    U: UpgradeValidationContext,
+    I: ValidationContext,
+    U: UpgradeValidationContext + ProvableContext,
 {
     let upgrade_revision_height = match request.upgrade_height {
         Some(height) => height.revision_height(),
@@ -227,7 +227,7 @@ where
         None => ibc_ctx.host_height()?,
     };
 
-    let proof = ibc_ctx
+    let proof = upgrade_ctx
         .get_proof(
             proof_height,
             &Path::UpgradeClient(upgraded_client_state_path),
@@ -252,8 +252,8 @@ pub fn query_upgraded_consensus_state<I, U>(
     request: &QueryUpgradedConsensusStateRequest,
 ) -> Result<QueryUpgradedConsensusStateResponse, QueryError>
 where
-    I: QueryContext,
-    U: UpgradeValidationContext,
+    I: ValidationContext,
+    U: UpgradeValidationContext + ProvableContext,
     UpgradedConsensusStateRef<U>: Into<Any>,
 {
     let upgrade_revision_height = match request.upgrade_height {
@@ -278,7 +278,7 @@ where
         None => ibc_ctx.host_height()?,
     };
 
-    let proof = ibc_ctx
+    let proof = upgrade_ctx
         .get_proof(
             proof_height,
             &Path::UpgradeClient(upgraded_consensus_state_path),
diff --git a/ibc-query/src/core/client/service.rs b/ibc-query/src/core/client/service.rs
index 3c0a96163..c710802cc 100644
--- a/ibc-query/src/core/client/service.rs
+++ b/ibc-query/src/core/client/service.rs
@@ -25,7 +25,7 @@ use super::{
     query_consensus_state_heights, query_consensus_states, query_upgraded_client_state,
     query_upgraded_consensus_state,
 };
-use crate::core::context::QueryContext;
+use crate::core::context::{ProvableContext, QueryContext};
 use crate::utils::{IntoDomain, IntoResponse, TryIntoDomain};
 
 // TODO(rano): currently the services don't support pagination, so we return all the results.
@@ -64,7 +64,7 @@ where
 impl<I, U> ClientQuery for ClientQueryService<I, U>
 where
     I: QueryContext + Send + Sync + 'static,
-    U: UpgradeValidationContext + Send + Sync + 'static,
+    U: UpgradeValidationContext + ProvableContext + Send + Sync + 'static,
     ConsensusStateRef<I>: Into<Any>,
     UpgradedConsensusStateRef<U>: Into<Any>,
 {

From 68513d8f80c62a289dad18aa3bb7e69ba5295fb2 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Mon, 15 Apr 2024 12:08:35 -0700
Subject: [PATCH 146/182] imp: make custom `Validation/ExecutionContext` under
 ICS-07 usable by any light clients (#1166)

* imp: move TmValidation/ExecutionContext into ICS-02 for general usage

* chore: add changelog

* review: rename context.rs to verifier.rs

* review: better docstring for ExtClientExecutionContext

* fix: apply review comments

* nit: update changelog

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>

---------

Signed-off-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 ...ke-ics07-custom-context-traits-portable.md |   5 +
 ...010-enable-standalone-ics02-integration.md |   8 +-
 .../ics07-tendermint/src/client_state.rs      |   2 -
 .../src/client_state/execution.rs             |  42 +++----
 .../src/client_state/misbehaviour.rs          |  12 +-
 .../src/client_state/update_client.rs         |  13 +--
 .../src/client_state/validation.rs            |  29 +++--
 ibc-clients/ics07-tendermint/src/context.rs   | 104 ------------------
 ibc-clients/ics07-tendermint/src/lib.rs       |   2 +-
 ibc-clients/ics07-tendermint/src/verifier.rs  |  37 +++++++
 ibc-core/ics02-client/context/src/context.rs  |  59 ++++++++++
 .../src/testapp/ibc/core/client_ctx.rs        |   7 +-
 12 files changed, 155 insertions(+), 165 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
 delete mode 100644 ibc-clients/ics07-tendermint/src/context.rs
 create mode 100644 ibc-clients/ics07-tendermint/src/verifier.rs

diff --git a/.changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md b/.changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
new file mode 100644
index 000000000..726da305b
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
@@ -0,0 +1,5 @@
+- [ibc] Enhance portability of custom `Validation/ExecutionContext` traits under
+  ICS-07. They are relocated, along with the rest of the
+  client-relevant context APIs, under ICS-02, with the traits renamed to
+  `ExtClientValidationContext` and `ExtClientExecutionContext` for improved
+  self-description ([\#1163](https://github.com/cosmos/ibc-rs/issues/1163))
diff --git a/docs/architecture/adr-010-enable-standalone-ics02-integration.md b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
index 913aa0c70..24dbe1149 100644
--- a/docs/architecture/adr-010-enable-standalone-ics02-integration.md
+++ b/docs/architecture/adr-010-enable-standalone-ics02-integration.md
@@ -279,7 +279,7 @@ must introduce a `ClientStateMut` type the same as `ClientStateRef`.
 With the mentioned classification, we can now streamline ICS-07 specific APIs,
 eliminating the requirement for implementing a redundant `consensus_state()`
 method. For the sake of simplification, we can remove the `CommonContext` trait
-and consolidate everything under the `TmValidationContext` as follows:
+and consolidate everything under the `ExtClientValidationContext` as follows:
 
 ```diff
 + /// Enables conversion (`TryInto` and `From`) between the consensus state type
@@ -296,11 +296,11 @@ and consolidate everything under the `TmValidationContext` as follows:
 + }
 
 - pub trait CommonContext {
--    // methods will be moved to the below `ValidationContext`
+-    // methods will be moved to the below `ExtClientValidationContext`
 - }
 
 // Client's context required during validation
-pub trait ValidationContext:
+pub trait ExtClientValidationContext:
 +    ClientValidationContext<ConsensusStateRef = Self::AnyConsensusState>
 {
 +    type ConversionError: ToString;
@@ -331,7 +331,7 @@ pub trait ValidationContext:
 }
 
 -impl<T> ExecutionContext for T where T: CommonContext + ClientExecutionContext {}
-+impl<T> ExecutionContext for T where T: ValidationContext + ClientExecutionContext {}
++impl<T> ExtClientExecutionContext for T where T: ExtClientValidationContext + ClientExecutionContext {}
 
 ```
 
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index 9f1fe3139..d1b3e1ab6 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -15,8 +15,6 @@ use ibc_core_client::types::error::ClientError;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::{Any, Protobuf};
 
-use crate::context::ValidationContext as TmValidationContext;
-
 mod common;
 mod execution;
 mod misbehaviour;
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index ba6d09186..50d372fa3 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -10,16 +10,12 @@ use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
 use super::ClientState;
-use crate::context::{
-    ConsensusStateConverter, ExecutionContext as TmExecutionContext,
-    ValidationContext as TmValidationContext,
-};
 
 impl<E> ClientStateExecution<E> for ClientState
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     fn initialise(
         &self,
@@ -93,12 +89,12 @@ pub fn initialise<E>(
     consensus_state: Any,
 ) -> Result<(), ClientError>
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
-    let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
-    let host_height = TmValidationContext::host_height(ctx)?;
+    let host_timestamp = ExtClientValidationContext::host_timestamp(ctx)?;
+    let host_height = ExtClientValidationContext::host_height(ctx)?;
 
     let tm_consensus_state = ConsensusStateType::try_from(consensus_state)?;
 
@@ -138,9 +134,9 @@ pub fn update_state<E>(
     header: Any,
 ) -> Result<Vec<Height>, ClientError>
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let header = TmHeader::try_from(header)?;
     let header_height = header.height();
@@ -163,8 +159,8 @@ where
         //
         // Do nothing.
     } else {
-        let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
-        let host_height = TmValidationContext::host_height(ctx)?;
+        let host_timestamp = ExtClientValidationContext::host_timestamp(ctx)?;
+        let host_height = ExtClientValidationContext::host_height(ctx)?;
 
         let new_consensus_state = ConsensusStateType::from(header.clone());
         let new_client_state = client_state.clone().with_header(header)?;
@@ -205,9 +201,8 @@ pub fn update_on_misbehaviour<E>(
     _client_message: Any,
 ) -> Result<(), ClientError>
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
 {
     // NOTE: frozen height is  set to `Height {revision_height: 0,
     // revision_number: 1}` and it is the same for all misbehaviour. This
@@ -238,9 +233,9 @@ pub fn update_on_upgrade<E>(
     upgraded_consensus_state: Any,
 ) -> Result<Height, ClientError>
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let mut upgraded_tm_client_state = ClientState::try_from(upgraded_client_state)?;
     let upgraded_tm_cons_state = ConsensusStateType::try_from(upgraded_consensus_state)?;
@@ -284,8 +279,8 @@ where
     );
 
     let latest_height = new_client_state.latest_height;
-    let host_timestamp = TmValidationContext::host_timestamp(ctx)?;
-    let host_height = TmValidationContext::host_height(ctx)?;
+    let host_timestamp = ExtClientValidationContext::host_timestamp(ctx)?;
+    let host_height = ExtClientValidationContext::host_height(ctx)?;
 
     ctx.store_client_state(
         ClientStatePath::new(client_id.clone()),
@@ -318,9 +313,9 @@ pub fn prune_oldest_consensus_state<E>(
     client_id: &ClientId,
 ) -> Result<(), ClientError>
 where
-    E: ClientExecutionContext + TmValidationContext,
+    E: ClientExecutionContext + ExtClientValidationContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let mut heights = ctx.consensus_state_heights(client_id)?;
 
@@ -380,9 +375,8 @@ pub fn update_on_recovery<E>(
     substitute_client_state: Any,
 ) -> Result<(), ClientError>
 where
-    E: TmExecutionContext,
+    E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: ConsensusStateConverter,
 {
     let substitute_client_state = ClientState::try_from(substitute_client_state)?
         .inner()
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index b9b6132b2..26a96de19 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -1,5 +1,8 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
-use ibc_client_tendermint_types::{Header as TmHeader, Misbehaviour as TmMisbehaviour};
+use ibc_client_tendermint_types::{
+    ConsensusState as ConsensusStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
+};
+use ibc_core_client::context::{Convertible, ExtClientValidationContext};
 use ibc_core_client::types::error::ClientError;
 use ibc_core_host::types::identifiers::{ChainId, ClientId};
 use ibc_core_host::types::path::ClientConsensusStatePath;
@@ -11,9 +14,8 @@ use tendermint::{Hash, Time};
 use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::Verifier;
 
-use super::TmValidationContext;
-use crate::context::{ConsensusStateConverter, TmVerifier};
 use crate::types::Header;
+use crate::verifier::TmVerifier;
 
 /// Determines whether or not two conflicting headers at the same height would
 /// have convinced the light client.
@@ -26,8 +28,8 @@ pub fn verify_misbehaviour<V, H>(
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
     H: MerkleHash + Sha256 + Default,
 {
     misbehaviour.validate_basic::<H>()?;
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 5fe5ad05d..7b94f2d0e 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -1,5 +1,6 @@
 use ibc_client_tendermint_types::error::{Error, IntoResult};
 use ibc_client_tendermint_types::{ConsensusState as ConsensusStateType, Header as TmHeader};
+use ibc_core_client::context::{Convertible, ExtClientValidationContext};
 use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::Height;
 use ibc_core_host::types::identifiers::{ChainId, ClientId};
@@ -11,9 +12,7 @@ use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
-use crate::context::{
-    ConsensusStateConverter, TmVerifier, ValidationContext as TmValidationContext,
-};
+use crate::verifier::TmVerifier;
 
 pub fn verify_header<V, H>(
     ctx: &V,
@@ -24,8 +23,8 @@ pub fn verify_header<V, H>(
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
     H: MerkleHash + Sha256 + Default,
 {
     // Checks that the header fields are valid.
@@ -110,8 +109,8 @@ pub fn check_for_misbehaviour_on_update<V>(
     client_latest_height: &Height,
 ) -> Result<bool, ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let maybe_existing_consensus_state = {
         let path_at_header_height = ClientConsensusStatePath::new(
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index bf7d62f44..3fcad0dc1 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -1,8 +1,9 @@
 use ibc_client_tendermint_types::{
-    ClientState as ClientStateType, Header as TmHeader, Misbehaviour as TmMisbehaviour,
-    TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
+    ClientState as ClientStateType, ConsensusState as ConsensusStateType, Header as TmHeader,
+    Misbehaviour as TmMisbehaviour, TENDERMINT_HEADER_TYPE_URL, TENDERMINT_MISBEHAVIOUR_TYPE_URL,
 };
 use ibc_core_client::context::client_state::ClientStateValidation;
+use ibc_core_client::context::{Convertible, ExtClientValidationContext};
 use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::Status;
 use ibc_core_host::types::identifiers::ClientId;
@@ -15,14 +16,12 @@ use tendermint::merkle::MerkleHash;
 
 use super::{check_for_misbehaviour_on_misbehavior, check_for_misbehaviour_on_update, ClientState};
 use crate::client_state::{verify_header, verify_misbehaviour};
-use crate::context::{
-    ConsensusStateConverter, DefaultVerifier, TmVerifier, ValidationContext as TmValidationContext,
-};
+use crate::verifier::{DefaultVerifier, TmVerifier};
 
 impl<V> ClientStateValidation<V> for ClientState
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     /// The default verification logic exposed by ibc-rs simply delegates to a
     /// standalone `verify_client_message` function. This is to make it as simple
@@ -78,8 +77,8 @@ pub fn verify_client_message<V, H>(
     verifier: &impl TmVerifier,
 ) -> Result<(), ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
     H: MerkleHash + Sha256Trait + Default,
 {
     match client_message.type_url.as_str() {
@@ -148,8 +147,8 @@ pub fn check_for_misbehaviour<V>(
     client_message: Any,
 ) -> Result<bool, ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
@@ -175,8 +174,8 @@ pub fn status<V>(
     client_id: &ClientId,
 ) -> Result<Status, ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     if client_state.is_frozen() {
         return Ok(Status::Frozen);
@@ -222,8 +221,8 @@ pub fn check_substitute<V>(
     substitute_client_state: Any,
 ) -> Result<(), ClientError>
 where
-    V: TmValidationContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    V: ExtClientValidationContext,
+    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let ClientStateType {
         latest_height: _,
diff --git a/ibc-clients/ics07-tendermint/src/context.rs b/ibc-clients/ics07-tendermint/src/context.rs
deleted file mode 100644
index 9b61df1d7..000000000
--- a/ibc-clients/ics07-tendermint/src/context.rs
+++ /dev/null
@@ -1,104 +0,0 @@
-use ibc_client_tendermint_types::ConsensusState as ConsensusStateType;
-use ibc_core_client::context::prelude::*;
-use ibc_core_client::types::error::ClientError;
-use ibc_core_client::types::Height;
-use ibc_core_handler_types::error::ContextError;
-use ibc_core_host::types::identifiers::ClientId;
-use ibc_primitives::prelude::*;
-use ibc_primitives::Timestamp;
-use tendermint_light_client_verifier::ProdVerifier;
-
-/// Enables conversion (`TryInto` and `From`) between the consensus state type
-/// used by the host and the one specific to the Tendermint light client, which
-/// is `ConsensusStateType`.
-pub trait ConsensusStateConverter:
-    TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
-{
-}
-
-impl<C> ConsensusStateConverter for C where
-    C: TryInto<ConsensusStateType, Error = ClientError> + From<ConsensusStateType>
-{
-}
-
-/// Client's context required during validation
-pub trait ValidationContext: ClientValidationContext
-where
-    Self::ConsensusStateRef: ConsensusStateConverter,
-{
-    /// Returns the current timestamp of the local chain.
-    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
-
-    /// Returns the current height of the local chain.
-    fn host_height(&self) -> Result<Height, ContextError>;
-
-    /// Returns all the heights at which a consensus state is stored
-    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
-
-    /// Search for the lowest consensus state higher than `height`.
-    fn next_consensus_state(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
-
-    /// Search for the highest consensus state lower than `height`.
-    fn prev_consensus_state(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
-}
-
-/// Client's context required during execution.
-///
-/// This trait is automatically implemented for all types that implement
-/// [`ValidationContext`] and [`ClientExecutionContext`]
-pub trait ExecutionContext: ValidationContext + ClientExecutionContext
-where
-    Self::ConsensusStateRef: ConsensusStateConverter,
-{
-}
-
-impl<T> ExecutionContext for T
-where
-    T: ValidationContext + ClientExecutionContext,
-    T::ConsensusStateRef: ConsensusStateConverter,
-{
-}
-
-/// Specifies the Verifier interface that hosts must adhere to when customizing
-/// Tendermint client verification behaviour.
-///
-/// For users who require custom verification logic, i.e., in situations when
-/// the Tendermint `ProdVerifier` doesn't provide the desired outcome, users
-/// should define a custom verifier struct as a unit struct and then implement
-/// `TmVerifier` for it. Note that the custom verifier does need to also
-/// implement the `tendermint_light_client_verifier::Verifier` trait.
-///
-/// In order to wire up the custom verifier, the `verify_client_message` method
-/// on the `ClientStateValidation` trait must be implemented. The simplest way
-/// to do this is to import and call the standalone `verify_client_message`
-/// function located in the `ibc::clients::tendermint::client_state` module,
-/// passing in your custom verifier type as its `verifier` parameter. The rest
-/// of the methods in the `ClientStateValidation` trait can be implemented by
-/// importing and calling their analogous standalone version from the
-/// `tendermint::client_state` module, unless bespoke logic is desired for any
-/// of those functions.
-pub trait TmVerifier {
-    type Verifier: tendermint_light_client_verifier::Verifier;
-
-    fn verifier(&self) -> Self::Verifier;
-}
-
-/// The default verifier for IBC clients, the Tendermint light client
-/// ProdVerifier, for those users who don't require custom verification logic.
-pub struct DefaultVerifier;
-
-impl TmVerifier for DefaultVerifier {
-    type Verifier = ProdVerifier;
-
-    fn verifier(&self) -> Self::Verifier {
-        ProdVerifier::default()
-    }
-}
diff --git a/ibc-clients/ics07-tendermint/src/lib.rs b/ibc-clients/ics07-tendermint/src/lib.rs
index 422e1d387..808679b6c 100644
--- a/ibc-clients/ics07-tendermint/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/src/lib.rs
@@ -18,7 +18,7 @@ extern crate std;
 
 pub mod client_state;
 pub mod consensus_state;
-pub mod context;
+pub mod verifier;
 
 pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
 
diff --git a/ibc-clients/ics07-tendermint/src/verifier.rs b/ibc-clients/ics07-tendermint/src/verifier.rs
new file mode 100644
index 000000000..11bbaa756
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/src/verifier.rs
@@ -0,0 +1,37 @@
+use tendermint_light_client_verifier::ProdVerifier;
+
+/// Specifies the Verifier interface that hosts must adhere to when customizing
+/// Tendermint client verification behaviour.
+///
+/// For users who require custom verification logic, i.e., in situations when
+/// the Tendermint [`ProdVerifier`] doesn't provide the desired outcome, users
+/// should define a custom verifier struct as a unit struct and then implement
+/// `TmVerifier` for it. Note that the custom verifier does need to also
+/// implement the `tendermint_light_client_verifier::Verifier` trait.
+///
+/// In order to wire up the custom verifier, the `verify_client_message` method
+/// on the `ClientStateValidation` trait must be implemented. The simplest way
+/// to do this is to import and call the standalone `verify_client_message`
+/// function located in the `ibc::clients::tendermint::client_state` module,
+/// passing in your custom verifier type as its `verifier` parameter. The rest
+/// of the methods in the `ClientStateValidation` trait can be implemented by
+/// importing and calling their analogous standalone version from the
+/// `tendermint::client_state` module, unless bespoke logic is desired for any
+/// of those functions.
+pub trait TmVerifier {
+    type Verifier: tendermint_light_client_verifier::Verifier;
+
+    fn verifier(&self) -> Self::Verifier;
+}
+
+/// The default verifier for IBC clients, the Tendermint light client
+/// ProdVerifier, for those users who don't require custom verification logic.
+pub struct DefaultVerifier;
+
+impl TmVerifier for DefaultVerifier {
+    type Verifier = ProdVerifier;
+
+    fn verifier(&self) -> Self::Verifier {
+        ProdVerifier::default()
+    }
+}
diff --git a/ibc-core/ics02-client/context/src/context.rs b/ibc-core/ics02-client/context/src/context.rs
index 1b4e98e52..8f7b4922a 100644
--- a/ibc-core/ics02-client/context/src/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -2,6 +2,7 @@ use ibc_core_client_types::Height;
 use ibc_core_handler_types::error::ContextError;
 use ibc_core_host_types::identifiers::ClientId;
 use ibc_core_host_types::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc_primitives::prelude::*;
 use ibc_primitives::Timestamp;
 
 use crate::client_state::{ClientStateExecution, ClientStateValidation};
@@ -102,3 +103,61 @@ pub trait ClientExecutionContext:
         height: Height,
     ) -> Result<(), ContextError>;
 }
+
+/// An optional trait that extends the client validation context capabilities by
+/// providing additional methods for validating a client state. Mainly
+/// benefiting ICS-07 Tendermint clients by granting access to essential
+/// information from hosts.
+///
+/// Categorized under ICS-02, as it may also be utilized by other types of light
+/// clients. Developers may view this trait as an example of a custom context
+/// definition that expands client validation capabilities, according to their
+/// specific light client requirements.
+pub trait ExtClientValidationContext: ClientValidationContext {
+    /// Returns the current timestamp of the local chain.
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
+
+    /// Returns the current height of the local chain.
+    fn host_height(&self) -> Result<Height, ContextError>;
+
+    /// Returns all the heights at which a consensus state is stored.
+    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError>;
+
+    /// Search for the lowest consensus state higher than `height`.
+    fn next_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
+
+    /// Search for the highest consensus state lower than `height`.
+    fn prev_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError>;
+}
+
+/// An optional trait that extends the client context required during execution.
+///
+/// This trait, as it stands right now, serves as a trait alias for types that
+/// implement both [`ExtClientValidationContext`] and
+/// [`ClientExecutionContext`], and it is auto-implemented for such types.
+///
+/// Light client developers who wish to define and utilize their own custom
+/// client contexts may choose to introduce execution methods within a similar
+/// trait, which would allow them to store additional client-specific data and
+/// conduct execution operations more efficiently, tailored to their light
+/// client implementation.
+pub trait ExtClientExecutionContext: ExtClientValidationContext + ClientExecutionContext {}
+
+impl<T> ExtClientExecutionContext for T where T: ExtClientValidationContext + ClientExecutionContext {}
+
+/// General-purpose helper converter enabling `TryInto` and `From` conversions
+/// primarily intended between an enum and its variants. This usually used by
+/// standalone functions as a trait bound allowing them to obtain the concrete
+/// local type from the enum containing that concrete type as its variant, like
+/// when enum `AnyConsensusState` contains the Tendermint `ConsensusState`.
+pub trait Convertible<C, E>: TryInto<C, Error = E> + From<C> {}
+
+impl<T, C, E> Convertible<C, E> for T where T: TryInto<C, Error = E> + From<C> {}
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index 6f28e75dc..cc7c29b30 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -1,5 +1,6 @@
-use ibc::clients::tendermint::context::ValidationContext as TmValidationContext;
-use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::client::context::{
+    ClientExecutionContext, ClientValidationContext, ExtClientValidationContext,
+};
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::Height;
 use ibc::core::handler::types::error::ContextError;
@@ -36,7 +37,7 @@ impl MockClientContext for MockContext {
     }
 }
 
-impl TmValidationContext for MockContext {
+impl ExtClientValidationContext for MockContext {
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         ValidationContext::host_timestamp(self)
     }

From 45d32509c65c4dea425e7057005d9077ee43190d Mon Sep 17 00:00:00 2001
From: Tuan Tran <tuantran@notional.ventures>
Date: Wed, 17 Apr 2024 04:27:50 +0700
Subject: [PATCH 147/182] imp(ics23): fallible conversion for `ProofSpec`,
 `LeafOp`, `InnerSpec` (#1160)

* feat(ics23): add conversion checks

* fix compiler error

* comment out depth range tests

* Update ibc-core/ics23-commitment/types/src/specs.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* Update ibc-core/ics23-commitment/types/src/specs.rs

fix for consistency

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* add tests and linting

* refactor loop

* Update ibc-core/ics23-commitment/types/src/specs.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* Update ibc-core/ics23-commitment/types/src/specs.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* add parameterized test

* Update ibc-core/ics23-commitment/types/src/specs.rs

Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Tuan Tran <tuantran@notional.ventures>

* update err comment

* update tests

* add rstest in dev-deps

* code opt

* add HashOp and LengthOp validations

* code opt

* update the range validation predicates and comments

* empty proof specs are disallowed

* rename test fn

* update test cases

---------

Signed-off-by: Tuan Tran <tuantran@notional.ventures>
Co-authored-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../types/src/client_state.rs                 |  26 +-
 ibc-core/ics23-commitment/types/Cargo.toml    |   3 +
 ibc-core/ics23-commitment/types/src/error.rs  |   8 +
 ibc-core/ics23-commitment/types/src/specs.rs  | 237 ++++++++++++++----
 4 files changed, 199 insertions(+), 75 deletions(-)

diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 97fde1674..474aa32f5 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -296,7 +296,7 @@ impl TryFrom<RawTmClientState> for ClientState {
             unbonding_period,
             max_clock_drift,
             latest_height,
-            raw.proof_specs.into(),
+            raw.proof_specs.try_into()?,
             raw.upgrade_path,
             frozen_height,
             allow_update,
@@ -411,8 +411,6 @@ pub(crate) mod serde_tests {
 
 #[cfg(test)]
 mod tests {
-    use ibc_core_commitment_types::proto::ics23::ProofSpec as Ics23ProofSpec;
-
     use super::*;
 
     #[derive(Clone, Debug, PartialEq)]
@@ -556,28 +554,6 @@ mod tests {
                 },
                 want_pass: false,
             },
-            Test {
-                name: "Invalid (empty) proof specs".to_string(),
-                params: ClientStateParams {
-                    proof_specs: Vec::<Ics23ProofSpec>::new().into(),
-                    ..default_params.clone()
-                },
-                want_pass: false,
-            },
-            Test {
-                name: "Invalid (empty) proof specs depth range".to_string(),
-                params: ClientStateParams {
-                    proof_specs: vec![Ics23ProofSpec {
-                        leaf_spec: None,
-                        inner_spec: None,
-                        min_depth: 2,
-                        max_depth: 1,
-                        prehash_key_before_comparison: false,
-                    }].into(),
-                    ..default_params
-                },
-                want_pass: false,
-            },
         ]
         .into_iter()
         .collect();
diff --git a/ibc-core/ics23-commitment/types/Cargo.toml b/ibc-core/ics23-commitment/types/Cargo.toml
index 15cd37dd4..905689347 100644
--- a/ibc-core/ics23-commitment/types/Cargo.toml
+++ b/ibc-core/ics23-commitment/types/Cargo.toml
@@ -35,6 +35,9 @@ ics23           = { version = "0.11", default-features = false, features = ["hos
 parity-scale-codec  = { workspace = true, optional = true }
 scale-info          = { workspace = true, optional = true }
 
+[dev-dependencies]
+rstest = { workspace = true }
+
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-core/ics23-commitment/types/src/error.rs b/ibc-core/ics23-commitment/types/src/error.rs
index 0d9cf21b1..fdbdd24c7 100644
--- a/ibc-core/ics23-commitment/types/src/error.rs
+++ b/ibc-core/ics23-commitment/types/src/error.rs
@@ -29,6 +29,14 @@ pub enum CommitmentError {
     EncodingFailure(String),
     /// decoding commitment proof bytes failed: `{0}`
     DecodingFailure(String),
+    /// invalid prefix length range: `[{0}, {1}]`
+    InvalidPrefixLengthRange(i32, i32),
+    /// invalid child size: `{0}`
+    InvalidChildSize(i32),
+    /// invalid hash operation: `{0}`
+    InvalidHashOp(i32),
+    /// invalid length operation: `{0}`
+    InvalidLengthOp(i32),
 }
 
 #[cfg(feature = "std")]
diff --git a/ibc-core/ics23-commitment/types/src/specs.rs b/ibc-core/ics23-commitment/types/src/specs.rs
index 3cd40ac84..46bf79a95 100644
--- a/ibc-core/ics23-commitment/types/src/specs.rs
+++ b/ibc-core/ics23-commitment/types/src/specs.rs
@@ -2,6 +2,7 @@
 
 use ibc_primitives::prelude::*;
 use ibc_proto::ics23::{InnerSpec as RawInnerSpec, LeafOp as RawLeafOp, ProofSpec as RawProofSpec};
+use ics23::{HashOp, LengthOp};
 
 use crate::error::CommitmentError;
 /// An array of proof specifications.
@@ -19,7 +20,8 @@ impl ProofSpecs {
             ics23::iavl_spec(),       // Format of proofs-iavl (iavl merkle proofs)
             ics23::tendermint_spec(), // Format of proofs-tendermint (crypto/ merkle SimpleProof)
         ]
-        .into()
+        .try_into()
+        .expect("should convert successfully")
     }
 
     pub fn is_empty(&self) -> bool {
@@ -31,9 +33,15 @@ impl ProofSpecs {
             return Err(CommitmentError::EmptyProofSpecs);
         }
         for proof_spec in &self.0 {
-            if proof_spec.0.max_depth < proof_spec.0.min_depth
+            // A non-positive `min_depth` or `max_depth` indicates no limit on the respective bound.
+            // For simplicity, negative values for `min_depth` and `max_depth` are not allowed
+            // and only `0` is used to indicate no limit. When `min_depth` and `max_depth` are both positive,
+            // `max_depth` must be greater than or equal to `min_depth` to ensure a valid range.
+            if proof_spec.0.max_depth < 0
                 || proof_spec.0.min_depth < 0
-                || proof_spec.0.max_depth < 0
+                || (0 < proof_spec.0.min_depth
+                    && 0 < proof_spec.0.max_depth
+                    && proof_spec.0.max_depth < proof_spec.0.min_depth)
             {
                 return Err(CommitmentError::InvalidDepthRange(
                     proof_spec.0.min_depth,
@@ -45,9 +53,19 @@ impl ProofSpecs {
     }
 }
 
-impl From<Vec<RawProofSpec>> for ProofSpecs {
-    fn from(ics23_specs: Vec<RawProofSpec>) -> Self {
-        Self(ics23_specs.into_iter().map(Into::into).collect())
+impl TryFrom<Vec<RawProofSpec>> for ProofSpecs {
+    type Error = CommitmentError;
+    fn try_from(ics23_specs: Vec<RawProofSpec>) -> Result<Self, CommitmentError> {
+        // no proof specs provided
+        if ics23_specs.is_empty() {
+            return Err(CommitmentError::EmptyProofSpecs);
+        }
+
+        ics23_specs
+            .into_iter()
+            .map(ProofSpec::try_from)
+            .collect::<Result<_, _>>()
+            .map(Self)
     }
 }
 
@@ -61,28 +79,47 @@ impl From<ProofSpecs> for Vec<RawProofSpec> {
 #[derive(Clone, Debug, PartialEq)]
 struct ProofSpec(RawProofSpec);
 
-impl From<RawProofSpec> for ProofSpec {
-    fn from(spec: RawProofSpec) -> Self {
-        Self(RawProofSpec {
-            leaf_spec: spec.leaf_spec.map(|lop| LeafOp::from(lop).0),
-            inner_spec: spec.inner_spec.map(|ispec| InnerSpec::from(ispec).0),
+impl TryFrom<RawProofSpec> for ProofSpec {
+    type Error = CommitmentError;
+    fn try_from(spec: RawProofSpec) -> Result<Self, CommitmentError> {
+        // A non-positive `min_depth` or `max_depth` indicates no limit on the respective bound.
+        // For simplicity, negative values for `min_depth` and `max_depth` are not allowed
+        // and only `0` is used to indicate no limit. When `min_depth` and `max_depth` are both positive,
+        // `max_depth` must be greater than or equal to `min_depth` to ensure a valid range.
+        if spec.max_depth < 0
+            || spec.min_depth < 0
+            || (0 < spec.min_depth && 0 < spec.max_depth && spec.max_depth < spec.min_depth)
+        {
+            return Err(CommitmentError::InvalidDepthRange(
+                spec.min_depth,
+                spec.max_depth,
+            ));
+        }
+
+        let leaf_spec = spec
+            .leaf_spec
+            .map(LeafOp::try_from)
+            .transpose()?
+            .map(|lop| lop.0);
+        let inner_spec = spec
+            .inner_spec
+            .map(InnerSpec::try_from)
+            .transpose()?
+            .map(|ispec| ispec.0);
+
+        Ok(Self(RawProofSpec {
+            leaf_spec,
+            inner_spec,
             max_depth: spec.max_depth,
             min_depth: spec.min_depth,
             prehash_key_before_comparison: spec.prehash_key_before_comparison,
-        })
+        }))
     }
 }
 
 impl From<ProofSpec> for RawProofSpec {
     fn from(spec: ProofSpec) -> Self {
-        let spec = spec.0;
-        RawProofSpec {
-            leaf_spec: spec.leaf_spec.map(|lop| LeafOp(lop).into()),
-            inner_spec: spec.inner_spec.map(|ispec| InnerSpec(ispec).into()),
-            max_depth: spec.max_depth,
-            min_depth: spec.min_depth,
-            prehash_key_before_comparison: spec.prehash_key_before_comparison,
-        }
+        spec.0
     }
 }
 
@@ -90,28 +127,25 @@ impl From<ProofSpec> for RawProofSpec {
 #[derive(Clone, Debug, PartialEq)]
 struct LeafOp(RawLeafOp);
 
-impl From<RawLeafOp> for LeafOp {
-    fn from(leaf_op: RawLeafOp) -> Self {
-        Self(RawLeafOp {
-            hash: leaf_op.hash,
-            prehash_key: leaf_op.prehash_key,
-            prehash_value: leaf_op.prehash_value,
-            length: leaf_op.length,
-            prefix: leaf_op.prefix,
-        })
+impl TryFrom<RawLeafOp> for LeafOp {
+    type Error = CommitmentError;
+    fn try_from(leaf_op: RawLeafOp) -> Result<Self, Self::Error> {
+        let _ = HashOp::try_from(leaf_op.hash)
+            .map_err(|_| CommitmentError::InvalidHashOp(leaf_op.hash))?;
+        let _ = HashOp::try_from(leaf_op.prehash_key)
+            .map_err(|_| CommitmentError::InvalidHashOp(leaf_op.prehash_key))?;
+        let _ = HashOp::try_from(leaf_op.prehash_value)
+            .map_err(|_| CommitmentError::InvalidHashOp(leaf_op.prehash_value))?;
+        let _ = LengthOp::try_from(leaf_op.length)
+            .map_err(|_| CommitmentError::InvalidLengthOp(leaf_op.length))?;
+
+        Ok(Self(leaf_op))
     }
 }
 
 impl From<LeafOp> for RawLeafOp {
     fn from(leaf_op: LeafOp) -> Self {
-        let leaf_op = leaf_op.0;
-        RawLeafOp {
-            hash: leaf_op.hash,
-            prehash_key: leaf_op.prehash_key,
-            prehash_value: leaf_op.prehash_value,
-            length: leaf_op.length,
-            prefix: leaf_op.prefix,
-        }
+        leaf_op.0
     }
 }
 
@@ -119,29 +153,132 @@ impl From<LeafOp> for RawLeafOp {
 #[derive(Clone, Debug, PartialEq)]
 struct InnerSpec(RawInnerSpec);
 
-impl From<RawInnerSpec> for InnerSpec {
-    fn from(inner_spec: RawInnerSpec) -> Self {
-        Self(RawInnerSpec {
+impl TryFrom<RawInnerSpec> for InnerSpec {
+    type Error = CommitmentError;
+    fn try_from(inner_spec: RawInnerSpec) -> Result<Self, CommitmentError> {
+        if inner_spec.child_size <= 0 {
+            return Err(CommitmentError::InvalidChildSize(inner_spec.child_size));
+        }
+
+        // Negative prefix lengths are not allowed and the maximum prefix length must
+        // be greater than or equal to the minimum prefix length.
+        if inner_spec.min_prefix_length < 0
+            || inner_spec.max_prefix_length < 0
+            || inner_spec.max_prefix_length < inner_spec.min_prefix_length
+        {
+            return Err(CommitmentError::InvalidPrefixLengthRange(
+                inner_spec.min_prefix_length,
+                inner_spec.max_prefix_length,
+            ));
+        }
+
+        Ok(Self(RawInnerSpec {
             child_order: inner_spec.child_order,
             child_size: inner_spec.child_size,
             min_prefix_length: inner_spec.min_prefix_length,
             max_prefix_length: inner_spec.max_prefix_length,
             empty_child: inner_spec.empty_child,
             hash: inner_spec.hash,
-        })
+        }))
     }
 }
 
 impl From<InnerSpec> for RawInnerSpec {
     fn from(inner_spec: InnerSpec) -> Self {
-        let inner_spec = inner_spec.0;
-        RawInnerSpec {
-            child_order: inner_spec.child_order,
-            child_size: inner_spec.child_size,
-            min_prefix_length: inner_spec.min_prefix_length,
-            max_prefix_length: inner_spec.max_prefix_length,
-            empty_child: inner_spec.empty_child,
-            hash: inner_spec.hash,
-        }
+        inner_spec.0
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc_proto::ics23::{InnerSpec as RawInnerSpec, ProofSpec as RawProofSpec};
+    use rstest::rstest;
+
+    use super::*;
+
+    #[rstest]
+    #[case(0, 0)]
+    #[case(2, 2)]
+    #[case(5, 6)]
+    #[should_panic(expected = "InvalidDepthRange")]
+    #[case(-3,3)]
+    #[should_panic(expected = "InvalidDepthRange")]
+    #[case(2,-6)]
+    #[should_panic(expected = "InvalidDepthRange")]
+    #[case(-2,-6)]
+    #[should_panic(expected = "InvalidDepthRange")]
+    #[case(-6,-2)]
+    #[should_panic(expected = "InvalidDepthRange")]
+    #[case(5, 3)]
+    fn test_proof_specs_try_from(#[case] min_depth: i32, #[case] max_depth: i32) {
+        let raw_proof_spec = RawProofSpec {
+            leaf_spec: None,
+            inner_spec: None,
+            max_depth,
+            min_depth,
+            prehash_key_before_comparison: false,
+        };
+        ProofSpec::try_from(raw_proof_spec).unwrap();
+    }
+
+    #[rstest]
+    #[case(0, 0)]
+    #[case(1, 2)]
+    #[case(2, 2)]
+    #[should_panic(expected = "InvalidPrefixLengthRange")]
+    #[case(2, 1)]
+    #[should_panic(expected = "InvalidPrefixLengthRange")]
+    #[case(-2,1)]
+    #[should_panic(expected = "InvalidPrefixLengthRange")]
+    #[case(2,-1)]
+    #[should_panic(expected = "InvalidPrefixLengthRange")]
+    #[case(-2,-1)]
+    #[should_panic(expected = "InvalidPrefixLengthRange")]
+    #[case(-1,-2)]
+    fn test_inner_specs_try_from(#[case] min_prefix_length: i32, #[case] max_prefix_length: i32) {
+        let raw_inner_spec = RawInnerSpec {
+            child_order: vec![1],
+            child_size: 2,
+            min_prefix_length,
+            max_prefix_length,
+            empty_child: vec![],
+            hash: 1,
+        };
+        InnerSpec::try_from(raw_inner_spec).unwrap();
+    }
+
+    #[rstest]
+    #[case(0, 0, 0, 0)]
+    #[case(9, 9, 9, 8)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(-1, 4, 4, 4)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(10, 4, 4, 4)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(4, -1, 4, 4)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(4, 10, 4, 4)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(4, 4, -1, 4)]
+    #[should_panic(expected = "InvalidHashOp")]
+    #[case(4, 4, 10, 4)]
+    #[should_panic(expected = "InvalidLengthOp")]
+    #[case(4, 4, 4, -1)]
+    #[should_panic(expected = "InvalidLengthOp")]
+    #[case(4, 4, 4, 9)]
+    fn test_leaf_op_try_from(
+        #[case] hash: i32,
+        #[case] prehash_key: i32,
+        #[case] prehash_value: i32,
+        #[case] length: i32,
+    ) {
+        let raw_leaf_op = RawLeafOp {
+            hash,
+            prehash_key,
+            prehash_value,
+            length,
+            prefix: vec![],
+        };
+        LeafOp::try_from(raw_leaf_op).unwrap();
     }
 }

From 2eecb5f515fd451c554b41928e6983c89fc925b6 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 17 Apr 2024 06:43:14 -0700
Subject: [PATCH 148/182] imp: make it easier to use custom verifiers for
 Tendermint clients (#1168)

* imp: simplify introducing custom verifier object

* chore: add changelog

* Update .changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Sean Chen <seanchen11235@gmail.com>

* Update ibc-clients/ics07-tendermint/src/client_state/validation.rs

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Sean Chen <seanchen11235@gmail.com>

* Update .changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Sean Chen <seanchen11235@gmail.com>

* Update ibc-clients/ics07-tendermint/src/client_state/validation.rs

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Sean Chen <seanchen11235@gmail.com>

* Update ibc-clients/ics07-tendermint/src/client_state/validation.rs

Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
Signed-off-by: Sean Chen <seanchen11235@gmail.com>

* docs: nudge toward implementing a newtype wrapper

* nit

---------

Signed-off-by: Sean Chen <seanchen11235@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 .../1168-discard-TmVerifier.md                |  4 ++
 .../src/client_state/misbehaviour.rs          |  6 +--
 .../src/client_state/update_client.rs         |  5 +--
 .../src/client_state/validation.rs            | 33 ++++++++++++-----
 ibc-clients/ics07-tendermint/src/lib.rs       |  8 ++--
 ibc-clients/ics07-tendermint/src/verifier.rs  | 37 -------------------
 6 files changed, 35 insertions(+), 58 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md
 delete mode 100644 ibc-clients/ics07-tendermint/src/verifier.rs

diff --git a/.changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md b/.changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md
new file mode 100644
index 000000000..3c84200a6
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md
@@ -0,0 +1,4 @@
+- [ibc-client-tendermint] Simplify custom verifiers usage for Tendermint
+  clients by directly binding with `tendermint_light_client_verifier::Verifier`
+  and removing the unused `TmVerifier` trait.
+  ([\#1168](https://github.com/cosmos/ibc-rs/pull/1168))
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 26a96de19..6750a44eb 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -15,7 +15,6 @@ use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::Verifier;
 
 use crate::types::Header;
-use crate::verifier::TmVerifier;
 
 /// Determines whether or not two conflicting headers at the same height would
 /// have convinced the light client.
@@ -25,7 +24,7 @@ pub fn verify_misbehaviour<V, H>(
     client_id: &ClientId,
     chain_id: &ChainId,
     options: &Options,
-    verifier: &impl TmVerifier,
+    verifier: &impl Verifier,
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
@@ -87,7 +86,7 @@ pub fn verify_misbehaviour_header<H>(
     trusted_timestamp: Time,
     trusted_next_validator_hash: Hash,
     current_timestamp: Timestamp,
-    verifier: &impl TmVerifier,
+    verifier: &impl Verifier,
 ) -> Result<(), ClientError>
 where
     H: MerkleHash + Sha256 + Default,
@@ -134,7 +133,6 @@ where
     })?;
 
     verifier
-        .verifier()
         .verify_misbehaviour_header(untrusted_state, trusted_state, options, current_timestamp)
         .into_result()?;
 
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index 7b94f2d0e..e715643fb 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -12,15 +12,13 @@ use tendermint_light_client_verifier::options::Options;
 use tendermint_light_client_verifier::types::{TrustedBlockState, UntrustedBlockState};
 use tendermint_light_client_verifier::Verifier;
 
-use crate::verifier::TmVerifier;
-
 pub fn verify_header<V, H>(
     ctx: &V,
     header: &TmHeader,
     client_id: &ClientId,
     chain_id: &ChainId,
     options: &Options,
-    verifier: &impl TmVerifier,
+    verifier: &impl Verifier,
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
@@ -92,7 +90,6 @@ where
 
         // main header verification, delegated to the tendermint-light-client crate.
         verifier
-            .verifier()
             .verify_update_header(untrusted_state, trusted_state, options, now)
             .into_result()?;
     }
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 3fcad0dc1..73349d1ec 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -13,10 +13,10 @@ use ibc_primitives::proto::Any;
 use tendermint::crypto::default::Sha256;
 use tendermint::crypto::Sha256 as Sha256Trait;
 use tendermint::merkle::MerkleHash;
+use tendermint_light_client_verifier::{ProdVerifier, Verifier};
 
 use super::{check_for_misbehaviour_on_misbehavior, check_for_misbehaviour_on_update, ClientState};
 use crate::client_state::{verify_header, verify_misbehaviour};
-use crate::verifier::{DefaultVerifier, TmVerifier};
 
 impl<V> ClientStateValidation<V> for ClientState
 where
@@ -24,9 +24,24 @@ where
     V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     /// The default verification logic exposed by ibc-rs simply delegates to a
-    /// standalone `verify_client_message` function. This is to make it as simple
-    /// as possible for those who merely need the `DefaultVerifier` behaviour, as
-    /// well as those who require custom verification logic.
+    /// standalone `verify_client_message` function. This is to make it as
+    /// simple as possible for those who merely need the default
+    /// [`ProdVerifier`] behaviour, as well as those who require custom
+    /// verification logic.
+    ///
+    /// In a situation where the Tendermint [`ProdVerifier`] doesn't provide the
+    /// desired outcome, users should define a custom verifier struct and then
+    /// implement the [`Verifier`] trait for it.
+    ///
+    /// In order to wire up the custom verifier, create a newtype `ClientState`
+    /// wrapper similar to [`ClientState`] and implement all client state traits
+    /// for it. For method implementation, the simplest way is to import and
+    /// call their analogous standalone versions under the
+    /// [`crate::client_state`] module, unless bespoke logic is desired for any
+    /// of those functions. Then, when it comes to implementing the
+    /// `verify_client_message` method, use the [`verify_client_message`]
+    /// function and pass your custom verifier object as the `verifier`
+    /// parameter.
     fn verify_client_message(
         &self,
         ctx: &V,
@@ -38,7 +53,7 @@ where
             ctx,
             client_id,
             client_message,
-            &DefaultVerifier,
+            &ProdVerifier::default(),
         )
     }
 
@@ -63,9 +78,9 @@ where
 /// Verify the client message as part of the client state validation process.
 ///
 /// Note that this function is typically implemented as part of the
-/// [`ClientStateValidation`] trait, but has been made a standalone function
-/// in order to make the ClientState APIs more flexible. It mostly adheres to
-/// the same signature as the `ClientStateValidation::verify_client_message`
+/// [`ClientStateValidation`] trait, but has been made a standalone function in
+/// order to make the ClientState APIs more flexible. It mostly adheres to the
+/// same signature as the `ClientStateValidation::verify_client_message`
 /// function, except for an additional `verifier` parameter that allows users
 /// who require custom verification logic to easily pass in their own verifier
 /// implementation.
@@ -74,7 +89,7 @@ pub fn verify_client_message<V, H>(
     ctx: &V,
     client_id: &ClientId,
     client_message: Any,
-    verifier: &impl TmVerifier,
+    verifier: &impl Verifier,
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
diff --git a/ibc-clients/ics07-tendermint/src/lib.rs b/ibc-clients/ics07-tendermint/src/lib.rs
index 808679b6c..594aa0011 100644
--- a/ibc-clients/ics07-tendermint/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/src/lib.rs
@@ -1,5 +1,5 @@
-//! ICS 07: Tendermint light client implementation along with re-exporting data
-//! structures and implementations of IBC core client module.
+//! ICS 07: Tendermint light client implementation along with re-exporting the
+//! necessary types from `ibc-client-tendermint-types` crate.
 #![no_std]
 #![forbid(unsafe_code)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
@@ -18,11 +18,11 @@ extern crate std;
 
 pub mod client_state;
 pub mod consensus_state;
-pub mod verifier;
 
 pub const TENDERMINT_CLIENT_TYPE: &str = "07-tendermint";
 
-/// Re-export of Tendermint light client data structures from `ibc-client-tendermint` crate.
+/// Re-exports Tendermint light client data structures from the
+/// `ibc-client-tendermint-type` crate.
 pub mod types {
     #[doc(inline)]
     pub use ibc_client_tendermint_types::*;
diff --git a/ibc-clients/ics07-tendermint/src/verifier.rs b/ibc-clients/ics07-tendermint/src/verifier.rs
deleted file mode 100644
index 11bbaa756..000000000
--- a/ibc-clients/ics07-tendermint/src/verifier.rs
+++ /dev/null
@@ -1,37 +0,0 @@
-use tendermint_light_client_verifier::ProdVerifier;
-
-/// Specifies the Verifier interface that hosts must adhere to when customizing
-/// Tendermint client verification behaviour.
-///
-/// For users who require custom verification logic, i.e., in situations when
-/// the Tendermint [`ProdVerifier`] doesn't provide the desired outcome, users
-/// should define a custom verifier struct as a unit struct and then implement
-/// `TmVerifier` for it. Note that the custom verifier does need to also
-/// implement the `tendermint_light_client_verifier::Verifier` trait.
-///
-/// In order to wire up the custom verifier, the `verify_client_message` method
-/// on the `ClientStateValidation` trait must be implemented. The simplest way
-/// to do this is to import and call the standalone `verify_client_message`
-/// function located in the `ibc::clients::tendermint::client_state` module,
-/// passing in your custom verifier type as its `verifier` parameter. The rest
-/// of the methods in the `ClientStateValidation` trait can be implemented by
-/// importing and calling their analogous standalone version from the
-/// `tendermint::client_state` module, unless bespoke logic is desired for any
-/// of those functions.
-pub trait TmVerifier {
-    type Verifier: tendermint_light_client_verifier::Verifier;
-
-    fn verifier(&self) -> Self::Verifier;
-}
-
-/// The default verifier for IBC clients, the Tendermint light client
-/// ProdVerifier, for those users who don't require custom verification logic.
-pub struct DefaultVerifier;
-
-impl TmVerifier for DefaultVerifier {
-    type Verifier = ProdVerifier;
-
-    fn verifier(&self) -> Self::Verifier {
-        ProdVerifier::default()
-    }
-}

From d5e3887770d3579d49942569833499b57c09af18 Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 17 Apr 2024 10:57:56 -0700
Subject: [PATCH 149/182] feat: implement CosmWasm context for light clients +
 contract for Tendermint clients (#1167)

* imp: move TmValidation/ExecutionContext into ICS-02 for general usage

* chore: add changelog

* feat: implement ibc-client-cw + ibc-client-tendermint-cw

* imp: improve namings and comments

* imp: error trimming

* docs: add minimal comments for methods

* fix: clippy catches

* chore: add make build-tendermint-cw

* chore: add changelog

* deps: set cosmwasm version to 1.5.2

* imp: use cw-context as it relates more

* fix: parsing height

* test: add create/update/recovery tests

* deps: update cosmwasm-schema to v1.5.2

* imp: move cosmwasm deps into workspace

* fix: apply review comments

* fix: make tests happy

* nits on changelog entries

* convert tabs to spaces

* terminate file with endline

* rm DISCLAIMER

* capitalize first word

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 ...4-implement-cosmwasm-integrator-library.md |   3 +
 ...osmwasm-contract-for-tendermint-clients.md |   3 +
 .gitignore                                    |   5 +-
 Cargo.toml                                    |  47 ++-
 ci/cw-check/Cargo.lock                        |   2 +-
 ibc-clients/README.md                         |  17 +-
 ibc-clients/cw-context/Cargo.toml             |  39 +++
 ibc-clients/cw-context/src/api.rs             |  14 +
 .../cw-context/src/context/client_ctx.rs      | 189 +++++++++++
 .../cw-context/src/context/custom_ctx.rs      |  77 +++++
 ibc-clients/cw-context/src/context/mod.rs     | 292 +++++++++++++++++
 ibc-clients/cw-context/src/handlers.rs        | 189 +++++++++++
 ibc-clients/cw-context/src/lib.rs             |  27 ++
 ibc-clients/cw-context/src/types/error.rs     |  36 +++
 ibc-clients/cw-context/src/types/helper.rs    |  31 ++
 ibc-clients/cw-context/src/types/mod.rs       |   9 +
 ibc-clients/cw-context/src/types/msgs.rs      | 295 ++++++++++++++++++
 ibc-clients/cw-context/src/types/response.rs  |  72 +++++
 ibc-clients/cw-context/src/utils/codec.rs     |  27 ++
 ibc-clients/cw-context/src/utils/mod.rs       |  25 ++
 .../ics07-tendermint/cw-contract/Cargo.toml   |  42 +++
 .../cw-contract/src/client_type.rs            |  63 ++++
 .../cw-contract/src/entrypoint.rs             |  40 +++
 .../ics07-tendermint/cw-contract/src/lib.rs   |  18 ++
 .../cw-contract/src/tests/fixture.rs          | 180 +++++++++++
 .../cw-contract/src/tests/helper.rs           |  26 ++
 .../cw-contract/src/tests/mod.rs              | 108 +++++++
 ibc-clients/ics08-wasm/types/Cargo.toml       |   2 +-
 ibc-primitives/Cargo.toml                     |   2 +-
 makefile                                      |   6 +
 30 files changed, 1865 insertions(+), 21 deletions(-)
 create mode 100644 .changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md
 create mode 100644 .changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
 create mode 100644 ibc-clients/cw-context/Cargo.toml
 create mode 100644 ibc-clients/cw-context/src/api.rs
 create mode 100644 ibc-clients/cw-context/src/context/client_ctx.rs
 create mode 100644 ibc-clients/cw-context/src/context/custom_ctx.rs
 create mode 100644 ibc-clients/cw-context/src/context/mod.rs
 create mode 100644 ibc-clients/cw-context/src/handlers.rs
 create mode 100644 ibc-clients/cw-context/src/lib.rs
 create mode 100644 ibc-clients/cw-context/src/types/error.rs
 create mode 100644 ibc-clients/cw-context/src/types/helper.rs
 create mode 100644 ibc-clients/cw-context/src/types/mod.rs
 create mode 100644 ibc-clients/cw-context/src/types/msgs.rs
 create mode 100644 ibc-clients/cw-context/src/types/response.rs
 create mode 100644 ibc-clients/cw-context/src/utils/codec.rs
 create mode 100644 ibc-clients/cw-context/src/utils/mod.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs

diff --git a/.changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md b/.changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md
new file mode 100644
index 000000000..3effca115
--- /dev/null
+++ b/.changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md
@@ -0,0 +1,3 @@
+- [ibc-clients] Introduce CosmWasm context library as `ibc-client-cw` crate to
+  facilitate CosmWasm contract creation for light clients built using `ibc-rs`
+  ([\#1164](https://github.com/cosmos/ibc-rs/issues/1164))
diff --git a/.changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md b/.changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
new file mode 100644
index 000000000..6f3d68acb
--- /dev/null
+++ b/.changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
@@ -0,0 +1,3 @@
+- [ibc-client-tendermint] Introduce `ibc-client-tendermint-cw` crate
+  implementing CosmWasm contract for ICS-07 Tendermint light client.
+  ([\#1165](https://github.com/cosmos/ibc-rs/issues/1165))
diff --git a/.gitignore b/.gitignore
index a7c66805b..42f1212d9 100644
--- a/.gitignore
+++ b/.gitignore
@@ -29,5 +29,8 @@ mc.log
 # Specifically, we want the ci/no-std-check/Cargo.lock to be committed
 # to ensure a reproducible CI build for that crate.
 # This will make it easier to spot bugs such as [this one](https://github.com/cosmos/ibc-rs/pull/560)
-# caused by a dependency updated to a faulty version. 
+# caused by a dependency updated to a faulty version.
 /Cargo.lock
+
+# Ignore CosmWasm artifacts
+/cw-contracts
diff --git a/Cargo.toml b/Cargo.toml
index 3b04052e5..b85c7e0c1 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -22,6 +22,8 @@ members = [
     "ibc-clients/ics07-tendermint/types",
     "ibc-clients/ics07-tendermint",
     "ibc-clients/ics08-wasm/types",
+    "ibc-clients/cw-context",
+    "ibc-clients/ics07-tendermint/cw-contract",
     "ibc-clients",
     "ibc-apps/ics20-transfer/types",
     "ibc-apps/ics20-transfer",
@@ -53,6 +55,7 @@ authors      = ["Informal Systems <hello@informal.systems>"]
 base64              = { version = "0.21", default-features = false }
 borsh               = { version = "0.10", default-features = false }
 displaydoc          = { version = "0.2", default-features = false }
+prost               = { version = "0.12", default-features = false }
 derive_more         = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
 rstest              = "0.18.2"
 schemars            = { version = "0.8.15" }
@@ -62,22 +65,28 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.1", default-
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                 = { version = "0.51.0", path = "./ibc", default-features = false }
-ibc-core            = { version = "0.51.0", path = "./ibc-core", default-features = false }
-ibc-clients         = { version = "0.51.0", path = "./ibc-clients", default-features = false }
-ibc-apps            = { version = "0.51.0", path = "./ibc-apps", default-features = false }
-ibc-primitives      = { version = "0.51.0", path = "./ibc-primitives", default-features = false }
-ibc-derive          = { version = "0.6.1", path = "./ibc-derive" }
+ibc                         = { version = "0.51.0", path = "./ibc", default-features = false }
+ibc-core                    = { version = "0.51.0", path = "./ibc-core", default-features = false }
+ibc-clients                 = { version = "0.51.0", path = "./ibc-clients", default-features = false }
+ibc-apps                    = { version = "0.51.0", path = "./ibc-apps", default-features = false }
+ibc-primitives              = { version = "0.51.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit                 = { version = "0.51.0", path = "./ibc-testkit", default-features = false }
 
-ibc-core-client       = { version = "0.51.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection   = { version = "0.51.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel      = { version = "0.51.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host         = { version = "0.51.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler      = { version = "0.51.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router       = { version = "0.51.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-client-tendermint = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-app-transfer      = { version = "0.51.0", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer  = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-derive                  = { version = "0.6.1", path = "./ibc-derive" }
+
+ibc-core-client             = { version = "0.51.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection         = { version = "0.51.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel            = { version = "0.51.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host               = { version = "0.51.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler            = { version = "0.51.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router             = { version = "0.51.0", path = "./ibc-core/ics26-routing", default-features = false }
+
+ibc-client-cw               = { version = "0.51.0", path = "./ibc-clients/cw-context", default-features = false }
+ibc-client-tendermint       = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-client-tendermint-cw    = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
+
+ibc-app-transfer            = { version = "0.51.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer        = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
 ibc-core-client-context     = { version = "0.51.0", path = "./ibc-core/ics02-client/context", default-features = false }
 ibc-core-client-types       = { version = "0.51.0", path = "./ibc-core/ics02-client/types", default-features = false }
@@ -103,6 +112,14 @@ tendermint-proto                 = { version = "0.34.0", default-features = fals
 tendermint-rpc                   = { version = "0.34.0", default-features = false }
 tendermint-testgen               = { version = "0.34.0", default-features = false }
 
+# cosmwasm dependencies
+### Note: Kept at the following version to match the CosmWasm module version
+### used by chains supporting the wasm-enabled version of ibc-go v7.3
+### (This is the min version of `ibc-go` that supports `08-wasm` light clients)
+cosmwasm-schema    = { version = "1.5.2" }
+cosmwasm-std       = { version = "1.5.2" }
+cosmwasm-vm        = { version = "1.5.2" }
+
 # parity dependencies
 parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"] }
 scale-info         = { version = "2.10.0", default-features = false, features = ["derive"] }
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index cc49e5efa..35694830f 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -837,7 +837,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.6.0"
+version = "0.6.1"
 dependencies = [
  "proc-macro2",
  "quote",
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
index 02b7d3ff1..014ab3248 100644
--- a/ibc-clients/README.md
+++ b/ibc-clients/README.md
@@ -23,13 +23,26 @@ IBC light clients:
 
 ### ICS-07: Tendermint Light Client
 
-- [ibc-client-tendermint](./ics07-tendermint)
-- [ibc-client-tendermint-types](./ics07-tendermint/types)
+- [ibc-client-tendermint-types](./ics07-tendermint/types): Data Structures
+- [ibc-client-tendermint](./ics07-tendermint): Implementation
+- [ibc-client-tendermint-cw](./ics07-tendermint/cw-contract): CosmWasm Contract
 
 ### ICS-08: WASM Proxy Light Client
 
 - [ibc-client-wasm-types](./ics08-wasm/types)
 
+### CosmWasm Integration
+
+- [ibc-client-cw](./cw-context): Types and Utilities for CosmWasm Integration
+  - To utilize the CosmWasm contracts developed with this library, hosting
+    environments must support the CosmWasm module and be using the version of
+    `ibc-go` that supports the `08-wasm` proxy light client.
+
+> [!CAUTION]
+> The `ibc-client-cw` is currently in development and should not be
+  deployed for production use. Users are advised to exercise caution and test
+  thoroughly in non-production environments.
+
 ## Third-party Clients
 
 Here, we list IBC third-party clients that are compatible with `ibc-rs`. You
diff --git a/ibc-clients/cw-context/Cargo.toml b/ibc-clients/cw-context/Cargo.toml
new file mode 100644
index 000000000..c3fd8ecb5
--- /dev/null
+++ b/ibc-clients/cw-context/Cargo.toml
@@ -0,0 +1,39 @@
+[package]
+name         = "ibc-client-cw"
+authors      = { workspace = true }
+edition      = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+rust-version = { workspace = true }
+version      = { workspace = true }
+keywords     = ["ibc", "light-client", "CosmWasm", "ICS-08"]
+readme       = "./../README.md"
+description  = """
+    Contains types and implementations that are needed to integrate a light client, built using ibc-rs,
+    into CosmWasm contract. It functions as a library, allowing users to import the ready-made `Context`
+    object that is generic across light clients, introduce their concrete client type and integrate
+    their assembled context into the CosmWasm contract's entrypoint.
+"""
+
+[dependencies]
+# external dependencies
+derive_more = { workspace = true }
+prost       = { workspace = true }
+serde       = { workspace = true, features = ["derive"] }
+
+# ibc dependencies
+ibc-core              = { workspace = true }
+ibc-client-wasm-types = { workspace = true, features = ["cosmwasm"] }
+
+# cosmwasm dependencies
+cosmwasm-schema       = { workspace = true }
+cosmwasm-std          = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "prost/std",
+    "serde/std",
+    "ibc-core/std",
+    "ibc-client-wasm-types/std",
+]
diff --git a/ibc-clients/cw-context/src/api.rs b/ibc-clients/cw-context/src/api.rs
new file mode 100644
index 000000000..cdab7a745
--- /dev/null
+++ b/ibc-clients/cw-context/src/api.rs
@@ -0,0 +1,14 @@
+use ibc_core::client::context::client_state::ClientStateExecution;
+use ibc_core::client::context::consensus_state::ConsensusState as ConsensusStateTrait;
+use ibc_core::client::types::error::ClientError;
+use ibc_core::primitives::proto::Any;
+
+use crate::context::Context;
+
+/// Enables users to integrate their implemented light client by introducing
+/// their client state and consensus state types into the generic [`Context`]
+/// object.
+pub trait ClientType<'a>: Sized {
+    type ClientState: ClientStateExecution<Context<'a, Self>> + Clone;
+    type ConsensusState: ConsensusStateTrait + Into<Any> + TryFrom<Any, Error = ClientError>;
+}
diff --git a/ibc-clients/cw-context/src/context/client_ctx.rs b/ibc-clients/cw-context/src/context/client_ctx.rs
new file mode 100644
index 000000000..ca1b2f6f9
--- /dev/null
+++ b/ibc-clients/cw-context/src/context/client_ctx.rs
@@ -0,0 +1,189 @@
+//! Implementation of the `ClientValidationContext` and `ClientExecutionContext`
+//! traits for the `Context` type.
+use ibc_client_wasm_types::client_state::ClientState as WasmClientState;
+use ibc_client_wasm_types::consensus_state::ConsensusState as WasmConsensusState;
+use ibc_core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc_core::client::types::error::ClientError;
+use ibc_core::client::types::Height;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::ClientId;
+use ibc_core::host::types::path::{iteration_key, ClientConsensusStatePath, ClientStatePath};
+use ibc_core::primitives::proto::{Any, Protobuf};
+use ibc_core::primitives::Timestamp;
+
+use super::Context;
+use crate::api::ClientType;
+use crate::utils::AnyCodec;
+
+impl<'a, C: ClientType<'a>> ClientValidationContext for Context<'a, C> {
+    type ClientStateRef = C::ClientState;
+    type ConsensusStateRef = C::ConsensusState;
+
+    fn client_state(&self, _client_id: &ClientId) -> Result<Self::ClientStateRef, ContextError> {
+        let client_state_value = self.retrieve(ClientStatePath::leaf())?;
+
+        let any_wasm: WasmClientState = Protobuf::<Any>::decode(client_state_value.as_slice())
+            .map_err(|e| ClientError::Other {
+                description: e.to_string(),
+            })?;
+
+        let sov_client_state = C::ClientState::decode_any_vec(any_wasm.data)?;
+
+        Ok(sov_client_state)
+    }
+
+    fn consensus_state(
+        &self,
+        client_cons_state_path: &ClientConsensusStatePath,
+    ) -> Result<Self::ConsensusStateRef, ContextError> {
+        let consensus_state_value = self.retrieve(client_cons_state_path.leaf())?;
+
+        let any_wasm: WasmConsensusState =
+            C::ConsensusState::decode_any_vec(consensus_state_value)?;
+
+        let consensus_state = C::ConsensusState::decode_any_vec(any_wasm.data)?;
+
+        Ok(consensus_state)
+    }
+
+    fn client_update_meta(
+        &self,
+        _client_id: &ClientId,
+        height: &Height,
+    ) -> Result<(Timestamp, Height), ContextError> {
+        let time_key = self.client_update_time_key(height);
+
+        let time_vec = self.retrieve(time_key)?;
+
+        let time = u64::from_be_bytes(time_vec.try_into().map_err(|_| ClientError::Other {
+            description: "time key cannot be converted to u64".to_string(),
+        })?);
+
+        let timestamp = Timestamp::from_nanoseconds(time).map_err(|e| ClientError::Other {
+            description: e.to_string(),
+        })?;
+
+        let height_key = self.client_update_height_key(height);
+
+        let revision_height_vec = self.retrieve(height_key)?;
+
+        let revision_height =
+            u64::from_be_bytes(
+                revision_height_vec
+                    .try_into()
+                    .map_err(|_| ClientError::Other {
+                        description: "revision height key cannot be converted to u64".to_string(),
+                    })?,
+            );
+
+        let height = Height::new(0, revision_height)?;
+
+        Ok((timestamp, height))
+    }
+}
+
+impl<'a, C: ClientType<'a>> ClientExecutionContext for Context<'a, C> {
+    type ClientStateMut = C::ClientState;
+
+    fn store_client_state(
+        &mut self,
+        _client_state_path: ClientStatePath,
+        client_state: Self::ClientStateMut,
+    ) -> Result<(), ContextError> {
+        let prefixed_key = self.prefixed_key(ClientStatePath::leaf());
+
+        let encoded_client_state = self.encode_client_state(client_state)?;
+
+        self.insert(prefixed_key, encoded_client_state);
+
+        Ok(())
+    }
+
+    fn store_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+        consensus_state: Self::ConsensusStateRef,
+    ) -> Result<(), ContextError> {
+        let prefixed_key = self.prefixed_key(consensus_state_path.leaf());
+
+        let encoded_consensus_state = C::ConsensusState::encode_to_any_vec(consensus_state);
+
+        let wasm_consensus_state = WasmConsensusState {
+            data: encoded_consensus_state,
+        };
+
+        let encoded_wasm_consensus_state =
+            C::ConsensusState::encode_to_any_vec(wasm_consensus_state);
+
+        self.insert(prefixed_key, encoded_wasm_consensus_state);
+
+        Ok(())
+    }
+
+    fn delete_consensus_state(
+        &mut self,
+        consensus_state_path: ClientConsensusStatePath,
+    ) -> Result<(), ContextError> {
+        let prefixed_key = self.prefixed_key(consensus_state_path.leaf());
+
+        self.remove(prefixed_key);
+
+        Ok(())
+    }
+
+    fn store_update_meta(
+        &mut self,
+        _client_id: ClientId,
+        height: Height,
+        host_timestamp: Timestamp,
+        host_height: Height,
+    ) -> Result<(), ContextError> {
+        let time_key = self.client_update_time_key(&height);
+
+        let prefixed_time_key = self.prefixed_key(time_key);
+
+        let time_vec = host_timestamp.nanoseconds().to_be_bytes();
+
+        self.insert(prefixed_time_key, time_vec);
+
+        let height_key = self.client_update_height_key(&height);
+
+        let prefixed_height_key = self.prefixed_key(height_key);
+
+        let revision_height_vec = host_height.revision_height().to_be_bytes();
+
+        self.insert(prefixed_height_key, revision_height_vec);
+
+        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
+
+        let height_vec = height.to_string().into_bytes();
+
+        self.insert(iteration_key, height_vec);
+
+        Ok(())
+    }
+
+    fn delete_update_meta(
+        &mut self,
+        _client_id: ClientId,
+        height: Height,
+    ) -> Result<(), ContextError> {
+        let time_key = self.client_update_time_key(&height);
+
+        let prefixed_time_key = self.prefixed_key(time_key);
+
+        self.remove(prefixed_time_key);
+
+        let height_key = self.client_update_height_key(&height);
+
+        let prefixed_height_key = self.prefixed_key(height_key);
+
+        self.remove(prefixed_height_key);
+
+        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
+
+        self.remove(iteration_key);
+
+        Ok(())
+    }
+}
diff --git a/ibc-clients/cw-context/src/context/custom_ctx.rs b/ibc-clients/cw-context/src/context/custom_ctx.rs
new file mode 100644
index 000000000..36fe86393
--- /dev/null
+++ b/ibc-clients/cw-context/src/context/custom_ctx.rs
@@ -0,0 +1,77 @@
+//! Implementation of the `ExtClientValidationContext` trait for the `Context`
+//! type.
+use ibc_core::client::context::prelude::*;
+use ibc_core::client::types::error::ClientError;
+use ibc_core::client::types::Height;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::identifiers::ClientId;
+use ibc_core::host::types::path::ClientConsensusStatePath;
+use ibc_core::primitives::Timestamp;
+
+use super::Context;
+use crate::api::ClientType;
+use crate::types::HeightTravel;
+
+impl<'a, C: ClientType<'a>> ExtClientValidationContext for Context<'a, C> {
+    fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
+        let time = self.env().block.time;
+
+        let host_timestamp =
+            Timestamp::from_nanoseconds(time.nanos()).map_err(|e| ClientError::Other {
+                description: e.to_string(),
+            })?;
+
+        Ok(host_timestamp)
+    }
+
+    fn host_height(&self) -> Result<Height, ContextError> {
+        let host_height = Height::new(0, self.env().block.height)?;
+
+        Ok(host_height)
+    }
+
+    fn consensus_state_heights(&self, _client_id: &ClientId) -> Result<Vec<Height>, ContextError> {
+        let heights = self.get_heights()?;
+
+        Ok(heights)
+    }
+    fn next_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
+        let next_height = self.get_adjacent_height(height, HeightTravel::Next)?;
+
+        match next_height {
+            Some(h) => {
+                let cons_state_path = ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    h.revision_number(),
+                    h.revision_height(),
+                );
+                self.consensus_state(&cons_state_path).map(Some)
+            }
+            None => Ok(None),
+        }
+    }
+
+    fn prev_consensus_state(
+        &self,
+        client_id: &ClientId,
+        height: &Height,
+    ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
+        let prev_height = self.get_adjacent_height(height, HeightTravel::Prev)?;
+
+        match prev_height {
+            Some(prev_height) => {
+                let cons_state_path = ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    prev_height.revision_number(),
+                    prev_height.revision_height(),
+                );
+                self.consensus_state(&cons_state_path).map(Some)
+            }
+            None => Ok(None),
+        }
+    }
+}
diff --git a/ibc-clients/cw-context/src/context/mod.rs b/ibc-clients/cw-context/src/context/mod.rs
new file mode 100644
index 000000000..19b6d0006
--- /dev/null
+++ b/ibc-clients/cw-context/src/context/mod.rs
@@ -0,0 +1,292 @@
+pub mod client_ctx;
+pub mod custom_ctx;
+
+use std::str::FromStr;
+
+use cosmwasm_std::{Deps, DepsMut, Env, Order, Storage};
+use ibc_client_wasm_types::client_state::ClientState as WasmClientState;
+use ibc_core::client::context::client_state::ClientStateCommon;
+use ibc_core::client::types::error::ClientError;
+use ibc_core::client::types::Height;
+use ibc_core::host::types::identifiers::ClientId;
+use ibc_core::host::types::path::{
+    iteration_key, ClientStatePath, ClientUpdateHeightPath, ClientUpdateTimePath,
+    ITERATE_CONSENSUS_STATE_PREFIX,
+};
+use ibc_core::primitives::proto::{Any, Protobuf};
+use prost::Message;
+
+use crate::api::ClientType;
+use crate::types::{ContractError, GenesisMetadata, HeightTravel, MigrationPrefix};
+use crate::utils::{parse_height, AnyCodec};
+
+type Checksum = Vec<u8>;
+
+/// Context is a wrapper around the deps and env that gives access to the
+/// methods under the ibc-rs Validation and Execution traits.
+pub struct Context<'a, C: ClientType<'a>> {
+    deps: Option<Deps<'a>>,
+    deps_mut: Option<DepsMut<'a>>,
+    env: Env,
+    client_id: ClientId,
+    checksum: Option<Checksum>,
+    migration_prefix: MigrationPrefix,
+    client_type: std::marker::PhantomData<C>,
+}
+
+impl<'a, C: ClientType<'a>> Context<'a, C> {
+    /// Constructs a new Context object with the given deps and env.
+    pub fn new_ref(deps: Deps<'a>, env: Env) -> Result<Self, ContractError> {
+        let client_id = ClientId::from_str(env.contract.address.as_str())?;
+
+        Ok(Self {
+            deps: Some(deps),
+            deps_mut: None,
+            env,
+            client_id,
+            checksum: None,
+            migration_prefix: MigrationPrefix::None,
+            client_type: std::marker::PhantomData::<C>,
+        })
+    }
+
+    /// Constructs a new Context object with the given deps_mut and env.
+    pub fn new_mut(deps_mut: DepsMut<'a>, env: Env) -> Result<Self, ContractError> {
+        let client_id = ClientId::from_str(env.contract.address.as_str())?;
+
+        Ok(Self {
+            deps: None,
+            deps_mut: Some(deps_mut),
+            env,
+            client_id,
+            checksum: None,
+            migration_prefix: MigrationPrefix::None,
+            client_type: std::marker::PhantomData::<C>,
+        })
+    }
+
+    /// Returns the env of the context.
+    pub fn env(&self) -> &Env {
+        &self.env
+    }
+
+    /// Logs the given message.
+    pub fn log(&self, msg: &str) -> Option<()> {
+        self.deps.map(|deps| deps.api.debug(msg))
+    }
+
+    /// Returns the client id of the context.
+    pub fn client_id(&self) -> ClientId {
+        self.client_id.clone()
+    }
+
+    /// Sets the checksum of the context.
+    pub fn set_checksum(&mut self, checksum: Checksum) {
+        self.checksum = Some(checksum);
+    }
+
+    /// Enables the migration mode with the subject prefix.
+    pub fn set_subject_prefix(&mut self) {
+        self.migration_prefix = MigrationPrefix::Subject;
+    }
+
+    /// Enables the migration mode with the substitute prefix.
+    pub fn set_substitute_prefix(&mut self) {
+        self.migration_prefix = MigrationPrefix::Substitute;
+    }
+
+    /// Prefixes the given key with the migration prefix.
+    pub fn prefixed_key(&self, key: impl AsRef<[u8]>) -> Vec<u8> {
+        let mut prefixed_key = Vec::new();
+        prefixed_key.extend_from_slice(self.migration_prefix.key());
+        prefixed_key.extend_from_slice(key.as_ref());
+
+        prefixed_key
+    }
+
+    /// Retrieves the value of the given key.
+    pub fn retrieve(&self, key: impl AsRef<[u8]>) -> Result<Vec<u8>, ClientError> {
+        let prefixed_key = self.prefixed_key(key);
+
+        let value = self
+            .storage_ref()
+            .get(prefixed_key.as_ref())
+            .ok_or(ClientError::Other {
+                description: "key not found upon retrieval".to_string(),
+            })?;
+
+        Ok(value)
+    }
+
+    /// Inserts the given key-value pair.
+    pub fn insert(&mut self, key: impl AsRef<[u8]>, value: impl AsRef<[u8]>) {
+        self.storage_mut().set(key.as_ref(), value.as_ref());
+    }
+
+    /// Removes the value of the given key.
+    pub fn remove(&mut self, key: impl AsRef<[u8]>) {
+        self.storage_mut().remove(key.as_ref());
+    }
+
+    /// Returns the storage of the context.
+    pub fn get_heights(&self) -> Result<Vec<Height>, ClientError> {
+        let iterator = self.storage_ref().range(None, None, Order::Ascending);
+
+        let heights: Vec<_> = iterator
+            .filter_map(|(_, value)| parse_height(value).transpose())
+            .collect::<Result<_, _>>()?;
+
+        Ok(heights)
+    }
+
+    /// Searches for either the earliest next or latest previous height based on
+    /// the given height and travel direction.
+    pub fn get_adjacent_height(
+        &self,
+        height: &Height,
+        travel: HeightTravel,
+    ) -> Result<Option<Height>, ClientError> {
+        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
+
+        let mut iterator = match travel {
+            HeightTravel::Prev => {
+                self.storage_ref()
+                    .range(None, Some(&iteration_key), Order::Descending)
+            }
+            HeightTravel::Next => {
+                self.storage_ref()
+                    .range(Some(&iteration_key), None, Order::Ascending)
+            }
+        };
+
+        iterator
+            .next()
+            .map_or(Ok(None), |(_, height)| parse_height(height))
+    }
+
+    /// Returns the key for the client update time.
+    pub fn client_update_time_key(&self, height: &Height) -> Vec<u8> {
+        let client_update_time_path = ClientUpdateTimePath::new(
+            self.client_id(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+
+        client_update_time_path.leaf().into_bytes()
+    }
+
+    /// Returns the key for the client update height.
+    pub fn client_update_height_key(&self, height: &Height) -> Vec<u8> {
+        let client_update_height_path = ClientUpdateHeightPath::new(
+            self.client_id(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+
+        client_update_height_path.leaf().into_bytes()
+    }
+
+    /// Returns the genesis metadata by iterating over the stored consensus
+    /// state metadata.
+    pub fn get_metadata(&self) -> Result<Option<Vec<GenesisMetadata>>, ContractError> {
+        let mut metadata = Vec::<GenesisMetadata>::new();
+
+        let start_key = ITERATE_CONSENSUS_STATE_PREFIX.to_string().into_bytes();
+
+        let iterator = self
+            .storage_ref()
+            .range(Some(&start_key), None, Order::Ascending);
+
+        for (_, encoded_height) in iterator {
+            let height = parse_height(encoded_height)?;
+
+            match height {
+                Some(height) => {
+                    let processed_height_key = self.client_update_height_key(&height);
+                    metadata.push(GenesisMetadata {
+                        key: processed_height_key.clone(),
+                        value: self.retrieve(&processed_height_key)?,
+                    });
+                    let processed_time_key = self.client_update_time_key(&height);
+                    metadata.push(GenesisMetadata {
+                        key: processed_time_key.clone(),
+                        value: self.retrieve(&processed_time_key)?,
+                    });
+                }
+                None => continue,
+            }
+        }
+
+        let iterator = self
+            .storage_ref()
+            .range(Some(&start_key), None, Order::Ascending);
+
+        for (key, height) in iterator {
+            metadata.push(GenesisMetadata { key, value: height });
+        }
+
+        Ok(Some(metadata))
+    }
+
+    /// Returns the checksum of the current contract.
+    pub fn obtain_checksum(&self) -> Result<Checksum, ClientError> {
+        match &self.checksum {
+            Some(checksum) => Ok(checksum.clone()),
+            None => {
+                let client_state_value = self.retrieve(ClientStatePath::leaf())?;
+
+                let wasm_client_state: WasmClientState =
+                    Protobuf::<Any>::decode(client_state_value.as_slice()).map_err(|e| {
+                        ClientError::Other {
+                            description: e.to_string(),
+                        }
+                    })?;
+
+                Ok(wasm_client_state.checksum)
+            }
+        }
+    }
+
+    /// Encodes the given client state into a byte vector.
+    pub fn encode_client_state(
+        &self,
+        client_state: C::ClientState,
+    ) -> Result<Vec<u8>, ClientError> {
+        let wasm_client_state = WasmClientState {
+            data: C::ClientState::encode_to_any_vec(client_state.clone()),
+            checksum: self.obtain_checksum()?,
+            latest_height: client_state.latest_height(),
+        };
+
+        Ok(Any::from(wasm_client_state).encode_to_vec())
+    }
+}
+
+pub trait StorageRef {
+    fn storage_ref(&self) -> &dyn Storage;
+}
+
+impl<'a, C: ClientType<'a>> StorageRef for Context<'a, C> {
+    fn storage_ref(&self) -> &dyn Storage {
+        match self.deps {
+            Some(ref deps) => deps.storage,
+            None => match self.deps_mut {
+                Some(ref deps) => deps.storage,
+                None => panic!("Either deps or deps_mut should be available"),
+            },
+        }
+    }
+}
+
+pub trait StorageMut: StorageRef {
+    fn storage_mut(&mut self) -> &mut dyn Storage;
+}
+
+impl<'a, C: ClientType<'a>> StorageMut for Context<'a, C> {
+    fn storage_mut(&mut self) -> &mut dyn Storage {
+        match self.deps_mut {
+            Some(ref mut deps) => deps.storage,
+            None => panic!("deps_mut should be available"),
+        }
+    }
+}
diff --git a/ibc-clients/cw-context/src/handlers.rs b/ibc-clients/cw-context/src/handlers.rs
new file mode 100644
index 000000000..c7ab323dd
--- /dev/null
+++ b/ibc-clients/cw-context/src/handlers.rs
@@ -0,0 +1,189 @@
+use cosmwasm_std::{to_json_binary, Binary};
+use ibc_core::client::context::prelude::*;
+use ibc_core::host::types::path::ClientConsensusStatePath;
+use ibc_core::primitives::proto::Any;
+use prost::Message;
+
+use crate::api::ClientType;
+use crate::context::Context;
+use crate::types::{
+    CheckForMisbehaviourMsg, ContractError, ContractResult, ExportMetadataMsg, InstantiateMsg,
+    QueryMsg, QueryResponse, StatusMsg, SudoMsg, UpdateStateMsg, UpdateStateOnMisbehaviourMsg,
+    VerifyClientMessageMsg, VerifyMembershipMsg, VerifyNonMembershipMsg,
+    VerifyUpgradeAndUpdateStateMsg,
+};
+
+impl<'a, C: ClientType<'a>> Context<'a, C> {
+    /// Instantiates a new client with the given [`InstantiateMsg`] message.
+    pub fn instantiate(&mut self, msg: InstantiateMsg) -> Result<Binary, ContractError> {
+        let any = Any::decode(&mut msg.client_state.as_slice())?;
+
+        let client_state = C::ClientState::try_from(any)?;
+
+        let any_consensus_state = Any::decode(&mut msg.consensus_state.as_slice())?;
+
+        self.set_checksum(msg.checksum);
+
+        client_state.initialise(self, &self.client_id(), any_consensus_state)?;
+
+        Ok(to_json_binary(&ContractResult::success())?)
+    }
+
+    /// Executes the given [`SudoMsg`].
+    pub fn sudo(&mut self, msg: SudoMsg) -> Result<Binary, ContractError> {
+        let client_id = self.client_id();
+
+        if let SudoMsg::MigrateClientStore(_) = msg {
+            self.set_subject_prefix();
+        };
+
+        let client_state = self.client_state(&client_id)?;
+
+        let result = match msg {
+            SudoMsg::UpdateState(msg_raw) => {
+                let msg = UpdateStateMsg::try_from(msg_raw)?;
+
+                let heights = client_state.update_state(self, &client_id, msg.client_message)?;
+
+                ContractResult::success().heights(heights)
+            }
+            SudoMsg::UpdateStateOnMisbehaviour(msg_raw) => {
+                let msg = UpdateStateOnMisbehaviourMsg::try_from(msg_raw)?;
+
+                client_state.update_state_on_misbehaviour(self, &client_id, msg.client_message)?;
+
+                ContractResult::success()
+            }
+            SudoMsg::VerifyMembership(msg) => {
+                let msg = VerifyMembershipMsg::try_from(msg)?;
+
+                let client_cons_state_path = ClientConsensusStatePath::new(
+                    self.client_id(),
+                    msg.height.revision_number(),
+                    msg.height.revision_height(),
+                );
+
+                let consensus_state = self.consensus_state(&client_cons_state_path)?;
+
+                client_state.verify_membership(
+                    &msg.prefix,
+                    &msg.proof,
+                    consensus_state.root(),
+                    msg.path,
+                    msg.value,
+                )?;
+
+                ContractResult::success()
+            }
+            SudoMsg::VerifyNonMembership(msg) => {
+                let msg = VerifyNonMembershipMsg::try_from(msg)?;
+
+                let client_cons_state_path = ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    msg.height.revision_number(),
+                    msg.height.revision_height(),
+                );
+
+                let consensus_state = self.consensus_state(&client_cons_state_path)?;
+
+                client_state.verify_non_membership(
+                    &msg.prefix,
+                    &msg.proof,
+                    consensus_state.root(),
+                    msg.path,
+                )?;
+
+                ContractResult::success()
+            }
+            SudoMsg::VerifyUpgradeAndUpdateState(msg) => {
+                let msg = VerifyUpgradeAndUpdateStateMsg::try_from(msg)?;
+
+                let client_cons_state_path = ClientConsensusStatePath::new(
+                    client_id.clone(),
+                    client_state.latest_height().revision_number(),
+                    client_state.latest_height().revision_height(),
+                );
+
+                let consensus_state = self.consensus_state(&client_cons_state_path)?;
+
+                client_state.verify_upgrade_client(
+                    msg.upgrade_client_state.clone(),
+                    msg.upgrade_consensus_state.clone(),
+                    msg.proof_upgrade_client,
+                    msg.proof_upgrade_consensus_state,
+                    consensus_state.root(),
+                )?;
+
+                client_state.update_state_on_upgrade(
+                    self,
+                    &client_id,
+                    msg.upgrade_client_state,
+                    msg.upgrade_consensus_state,
+                )?;
+
+                ContractResult::success()
+            }
+            SudoMsg::MigrateClientStore(_) => {
+                self.set_substitute_prefix();
+                let substitute_client_state = self.client_state(&client_id)?;
+
+                self.set_subject_prefix();
+                client_state.check_substitute(self, substitute_client_state.clone().into())?;
+
+                client_state.update_on_recovery(
+                    self,
+                    &self.client_id(),
+                    substitute_client_state.into(),
+                )?;
+
+                ContractResult::success()
+            }
+        };
+        Ok(to_json_binary(&result)?)
+    }
+
+    /// Queries the client with the given [`QueryMsg`] message.
+    pub fn query(&self, msg: QueryMsg) -> Result<Binary, ContractError> {
+        let client_id = self.client_id();
+
+        let client_state = self.client_state(&client_id)?;
+
+        let resp = match msg {
+            QueryMsg::Status(StatusMsg {}) => match client_state.status(self, &client_id) {
+                Ok(status) => QueryResponse::success().status(status.to_string()),
+                Err(err) => QueryResponse::success().status(err.to_string()),
+            },
+            QueryMsg::ExportMetadata(ExportMetadataMsg {}) => {
+                QueryResponse::success().genesis_metadata(self.get_metadata()?)
+            }
+            QueryMsg::TimestampAtHeight(msg) => {
+                let client_cons_state_path = ClientConsensusStatePath::new(
+                    client_id,
+                    msg.height.revision_number(),
+                    msg.height.revision_height(),
+                );
+
+                let consensus_state = self.consensus_state(&client_cons_state_path)?;
+
+                QueryResponse::success().timestamp(consensus_state.timestamp().nanoseconds())
+            }
+            QueryMsg::VerifyClientMessage(msg) => {
+                let msg = VerifyClientMessageMsg::try_from(msg)?;
+
+                client_state.verify_client_message(self, &client_id, msg.client_message)?;
+
+                QueryResponse::success()
+            }
+            QueryMsg::CheckForMisbehaviour(msg) => {
+                let msg = CheckForMisbehaviourMsg::try_from(msg)?;
+
+                let result =
+                    client_state.check_for_misbehaviour(self, &client_id, msg.client_message)?;
+
+                QueryResponse::success().misbehaviour(result)
+            }
+        };
+
+        Ok(to_json_binary(&resp)?)
+    }
+}
diff --git a/ibc-clients/cw-context/src/lib.rs b/ibc-clients/cw-context/src/lib.rs
new file mode 100644
index 000000000..792811815
--- /dev/null
+++ b/ibc-clients/cw-context/src/lib.rs
@@ -0,0 +1,27 @@
+//! Contains types and implementations that are needed to integrate a light
+//! client, built using ibc-rs, into CosmWasm contract. This crate functions as
+//! a library, allowing users to import the ready-made `Context` object that is
+//! generic across light clients, introduce their concrete client type and
+//! integrate their assembled context into the CosmWasm contract's entrypoint.
+//! NOTE: To utilize the CosmWasm contract developed using this library, hosting
+//! environments must support CosmWasm module and be using one the versions of
+//! `ibc-go` that supports the `08-wasm` proxy light client.
+
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+#![forbid(unsafe_code)]
+
+extern crate alloc;
+
+pub mod api;
+pub mod context;
+pub mod handlers;
+pub mod types;
+pub mod utils;
diff --git a/ibc-clients/cw-context/src/types/error.rs b/ibc-clients/cw-context/src/types/error.rs
new file mode 100644
index 000000000..d191638ad
--- /dev/null
+++ b/ibc-clients/cw-context/src/types/error.rs
@@ -0,0 +1,36 @@
+use cosmwasm_std::StdError;
+use derive_more::{Display, From};
+use ibc_core::client::types::error::ClientError;
+use ibc_core::commitment_types::error::CommitmentError;
+use ibc_core::handler::types::error::ContextError;
+use ibc_core::host::types::error::IdentifierError;
+use ibc_core::host::types::path::PathError;
+use prost::DecodeError;
+
+#[derive(From, Display, Debug)]
+pub enum ContractError {
+    #[display(fmt = "CosmWasm standard error: {_0}")]
+    Std(StdError),
+    #[display(fmt = "IBC validation/execution context error: {_0}")]
+    Context(ContextError),
+    #[display(fmt = "IBC commitment error: {_0}")]
+    Commitment(CommitmentError),
+    #[display(fmt = "IBC identifier error: {_0}")]
+    Identifier(IdentifierError),
+    #[display(fmt = "IBC path error: {_0}")]
+    Path(PathError),
+    #[display(fmt = "Proto decoding error: {_0}")]
+    ProtoDecode(DecodeError),
+}
+
+impl From<ContractError> for StdError {
+    fn from(err: ContractError) -> StdError {
+        StdError::generic_err(err.to_string())
+    }
+}
+
+impl From<ClientError> for ContractError {
+    fn from(err: ClientError) -> ContractError {
+        ContractError::Context(ContextError::ClientError(err))
+    }
+}
diff --git a/ibc-clients/cw-context/src/types/helper.rs b/ibc-clients/cw-context/src/types/helper.rs
new file mode 100644
index 000000000..05c82de7a
--- /dev/null
+++ b/ibc-clients/cw-context/src/types/helper.rs
@@ -0,0 +1,31 @@
+use ibc_client_wasm_types::{SUBJECT_PREFIX, SUBSTITUTE_PREFIX};
+
+/// The MigrationPrefix enumerates the prefix type used during migration mode.
+/// The migration mode is activated when there is an incoming
+/// [`MigrateClientStoreMsg`](crate::types::msgs::MigrateClientStoreMsg)
+/// message. It specifies the prefix key for either the
+/// subject or substitute store, or none if the migration is not active.
+#[derive(Clone, Debug)]
+pub enum MigrationPrefix {
+    Subject,
+    Substitute,
+    None,
+}
+
+impl MigrationPrefix {
+    pub fn key(&self) -> &[u8] {
+        match self {
+            MigrationPrefix::Subject => SUBJECT_PREFIX,
+            MigrationPrefix::Substitute => SUBSTITUTE_PREFIX,
+            MigrationPrefix::None => b"",
+        }
+    }
+}
+
+/// Travel is an enum to represent the direction of travel in the context of
+/// height.
+#[derive(Clone, Debug)]
+pub enum HeightTravel {
+    Next,
+    Prev,
+}
diff --git a/ibc-clients/cw-context/src/types/mod.rs b/ibc-clients/cw-context/src/types/mod.rs
new file mode 100644
index 000000000..28b7dfd35
--- /dev/null
+++ b/ibc-clients/cw-context/src/types/mod.rs
@@ -0,0 +1,9 @@
+mod error;
+mod helper;
+mod msgs;
+mod response;
+
+pub use error::*;
+pub use helper::*;
+pub use msgs::*;
+pub use response::*;
diff --git a/ibc-clients/cw-context/src/types/msgs.rs b/ibc-clients/cw-context/src/types/msgs.rs
new file mode 100644
index 000000000..58ca50470
--- /dev/null
+++ b/ibc-clients/cw-context/src/types/msgs.rs
@@ -0,0 +1,295 @@
+//! Defines the messages sent to the CosmWasm contract by the 08-wasm proxy
+//! light client.
+use std::str::FromStr;
+
+use cosmwasm_schema::cw_serde;
+use ibc_client_wasm_types::serializer::Base64;
+use ibc_client_wasm_types::Bytes;
+use ibc_core::client::types::proto::v1::Height as RawHeight;
+use ibc_core::client::types::Height;
+use ibc_core::commitment_types::commitment::{CommitmentPrefix, CommitmentProofBytes};
+use ibc_core::host::types::path::Path;
+use ibc_core::primitives::proto::Any;
+use prost::Message;
+
+use super::error::ContractError;
+
+// ------------------------------------------------------------
+// Implementation of the InstantiateMsg struct
+// ------------------------------------------------------------
+
+#[cw_serde]
+pub struct InstantiateMsg {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub client_state: Bytes,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub consensus_state: Bytes,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub checksum: Bytes,
+}
+
+// ------------------------------------------------------------
+// Implementation of the SudoMsg enum and its variants
+// ------------------------------------------------------------
+
+#[derive(derive_more::From)]
+#[cw_serde]
+pub enum SudoMsg {
+    UpdateState(UpdateStateMsgRaw),
+    UpdateStateOnMisbehaviour(UpdateStateOnMisbehaviourMsgRaw),
+    VerifyUpgradeAndUpdateState(VerifyUpgradeAndUpdateStateMsgRaw),
+    VerifyMembership(VerifyMembershipMsgRaw),
+    VerifyNonMembership(VerifyNonMembershipMsgRaw),
+    MigrateClientStore(MigrateClientStoreMsg),
+}
+
+#[cw_serde]
+pub struct UpdateStateOnMisbehaviourMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub client_message: Bytes,
+}
+
+pub struct UpdateStateOnMisbehaviourMsg {
+    pub client_message: Any,
+}
+
+impl TryFrom<UpdateStateOnMisbehaviourMsgRaw> for UpdateStateOnMisbehaviourMsg {
+    type Error = ContractError;
+
+    fn try_from(raw: UpdateStateOnMisbehaviourMsgRaw) -> Result<Self, Self::Error> {
+        let client_message = Any::decode(&mut raw.client_message.as_slice())?;
+
+        Ok(Self { client_message })
+    }
+}
+
+#[cw_serde]
+pub struct UpdateStateMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub client_message: Bytes,
+}
+
+pub struct UpdateStateMsg {
+    pub client_message: Any,
+}
+
+impl TryFrom<UpdateStateMsgRaw> for UpdateStateMsg {
+    type Error = ContractError;
+
+    fn try_from(raw: UpdateStateMsgRaw) -> Result<Self, Self::Error> {
+        let client_message = Any::decode(&mut raw.client_message.as_slice())?;
+
+        Ok(Self { client_message })
+    }
+}
+
+#[cw_serde]
+pub struct CheckSubstituteAndUpdateStateMsg {}
+
+#[cw_serde]
+pub struct VerifyUpgradeAndUpdateStateMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub upgrade_client_state: Bytes,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub upgrade_consensus_state: Bytes,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub proof_upgrade_client: Bytes,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub proof_upgrade_consensus_state: Bytes,
+}
+
+pub struct VerifyUpgradeAndUpdateStateMsg {
+    pub upgrade_client_state: Any,
+    pub upgrade_consensus_state: Any,
+    pub proof_upgrade_client: CommitmentProofBytes,
+    pub proof_upgrade_consensus_state: CommitmentProofBytes,
+}
+
+impl TryFrom<VerifyUpgradeAndUpdateStateMsgRaw> for VerifyUpgradeAndUpdateStateMsg {
+    type Error = ContractError;
+
+    fn try_from(raw: VerifyUpgradeAndUpdateStateMsgRaw) -> Result<Self, Self::Error> {
+        let upgrade_client_state = Any::decode(&mut raw.upgrade_client_state.as_slice())?;
+
+        let upgrade_consensus_state = Any::decode(&mut raw.upgrade_consensus_state.as_slice())?;
+
+        Ok(VerifyUpgradeAndUpdateStateMsg {
+            upgrade_client_state,
+            upgrade_consensus_state,
+            proof_upgrade_client: CommitmentProofBytes::try_from(raw.proof_upgrade_client)?,
+            proof_upgrade_consensus_state: CommitmentProofBytes::try_from(
+                raw.proof_upgrade_consensus_state,
+            )?,
+        })
+    }
+}
+
+#[cw_serde]
+pub struct MerklePath {
+    pub key_path: Vec<String>,
+}
+
+#[cw_serde]
+pub struct VerifyMembershipMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub proof: Bytes,
+    pub path: MerklePath,
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub value: Bytes,
+    pub height: RawHeight,
+    pub delay_block_period: u64,
+    pub delay_time_period: u64,
+}
+
+pub struct VerifyMembershipMsg {
+    pub prefix: CommitmentPrefix,
+    pub proof: CommitmentProofBytes,
+    pub path: Path,
+    pub value: Vec<u8>,
+    pub height: Height,
+    pub delay_block_period: u64,
+    pub delay_time_period: u64,
+}
+
+impl TryFrom<VerifyMembershipMsgRaw> for VerifyMembershipMsg {
+    type Error = ContractError;
+
+    fn try_from(mut raw: VerifyMembershipMsgRaw) -> Result<Self, Self::Error> {
+        let proof = CommitmentProofBytes::try_from(raw.proof)?;
+        let prefix = raw.path.key_path.remove(0).into_bytes();
+        let path_str = raw.path.key_path.join("");
+        let path = Path::from_str(&path_str)?;
+        let height = Height::try_from(raw.height)?;
+
+        Ok(Self {
+            proof,
+            path,
+            value: raw.value,
+            height,
+            prefix: CommitmentPrefix::try_from(prefix)?,
+            delay_block_period: raw.delay_block_period,
+            delay_time_period: raw.delay_time_period,
+        })
+    }
+}
+
+#[cw_serde]
+pub struct VerifyNonMembershipMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub proof: Bytes,
+    pub path: MerklePath,
+    pub height: RawHeight,
+    pub delay_block_period: u64,
+    pub delay_time_period: u64,
+}
+
+pub struct VerifyNonMembershipMsg {
+    pub prefix: CommitmentPrefix,
+    pub proof: CommitmentProofBytes,
+    pub path: Path,
+    pub height: Height,
+    pub delay_block_period: u64,
+    pub delay_time_period: u64,
+}
+
+impl TryFrom<VerifyNonMembershipMsgRaw> for VerifyNonMembershipMsg {
+    type Error = ContractError;
+
+    fn try_from(mut raw: VerifyNonMembershipMsgRaw) -> Result<Self, Self::Error> {
+        let proof = CommitmentProofBytes::try_from(raw.proof)?;
+        let prefix = raw.path.key_path.remove(0).into_bytes();
+        let path_str = raw.path.key_path.join("");
+        let path = Path::from_str(&path_str)?;
+        let height = raw.height.try_into()?;
+        Ok(Self {
+            proof,
+            path,
+            height,
+            prefix: CommitmentPrefix::try_from(prefix)?,
+            delay_block_period: raw.delay_block_period,
+            delay_time_period: raw.delay_time_period,
+        })
+    }
+}
+
+#[cw_serde]
+pub struct MigrateClientStoreMsg {}
+
+// ------------------------------------------------------------
+// Implementation of the QueryMsg enum and its variants
+// ------------------------------------------------------------
+
+#[derive(derive_more::From)]
+#[cw_serde]
+pub enum QueryMsg {
+    Status(StatusMsg),
+    ExportMetadata(ExportMetadataMsg),
+    TimestampAtHeight(TimestampAtHeightMsg),
+    VerifyClientMessage(VerifyClientMessageRaw),
+    CheckForMisbehaviour(CheckForMisbehaviourMsgRaw),
+}
+
+#[cw_serde]
+pub struct StatusMsg {}
+
+#[cw_serde]
+pub struct ExportMetadataMsg {}
+
+#[cw_serde]
+pub struct TimestampAtHeightMsg {
+    pub height: Height,
+}
+
+#[cw_serde]
+pub struct VerifyClientMessageRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub client_message: Bytes,
+}
+
+pub struct VerifyClientMessageMsg {
+    pub client_message: Any,
+}
+
+impl TryFrom<VerifyClientMessageRaw> for VerifyClientMessageMsg {
+    type Error = ContractError;
+
+    fn try_from(raw: VerifyClientMessageRaw) -> Result<Self, Self::Error> {
+        let client_message = Any::decode(&mut raw.client_message.as_slice())?;
+
+        Ok(Self { client_message })
+    }
+}
+
+#[cw_serde]
+pub struct CheckForMisbehaviourMsgRaw {
+    #[schemars(with = "String")]
+    #[serde(with = "Base64", default)]
+    pub client_message: Bytes,
+}
+
+pub struct CheckForMisbehaviourMsg {
+    pub client_message: Any,
+}
+
+impl TryFrom<CheckForMisbehaviourMsgRaw> for CheckForMisbehaviourMsg {
+    type Error = ContractError;
+
+    fn try_from(raw: CheckForMisbehaviourMsgRaw) -> Result<Self, Self::Error> {
+        let client_message = Any::decode(&mut raw.client_message.as_slice())?;
+
+        Ok(Self { client_message })
+    }
+}
diff --git a/ibc-clients/cw-context/src/types/response.rs b/ibc-clients/cw-context/src/types/response.rs
new file mode 100644
index 000000000..4aebdbe63
--- /dev/null
+++ b/ibc-clients/cw-context/src/types/response.rs
@@ -0,0 +1,72 @@
+//! Contains the response types for the CosmWasm contract.
+use cosmwasm_schema::cw_serde;
+use ibc_client_wasm_types::Bytes;
+use ibc_core::client::types::Height;
+
+#[cw_serde]
+pub struct GenesisMetadata {
+    pub key: Bytes,
+    pub value: Bytes,
+}
+
+#[cw_serde]
+pub struct QueryResponse {
+    pub is_valid: bool,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub status: Option<String>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub genesis_metadata: Option<Vec<GenesisMetadata>>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub found_misbehaviour: Option<bool>,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub timestamp: Option<u64>,
+}
+
+impl QueryResponse {
+    pub fn success() -> Self {
+        Self {
+            is_valid: true,
+            status: None,
+            genesis_metadata: None,
+            found_misbehaviour: None,
+            timestamp: None,
+        }
+    }
+
+    pub fn status(mut self, status: String) -> Self {
+        self.status = Some(status);
+        self
+    }
+
+    pub fn genesis_metadata(mut self, genesis_metadata: Option<Vec<GenesisMetadata>>) -> Self {
+        self.genesis_metadata = genesis_metadata;
+        self
+    }
+
+    pub fn misbehaviour(mut self, found_misbehavior: bool) -> Self {
+        self.found_misbehaviour = Some(found_misbehavior);
+        self
+    }
+
+    pub fn timestamp(mut self, timestamp: u64) -> Self {
+        self.timestamp = Some(timestamp);
+        self
+    }
+}
+
+#[cw_serde]
+pub struct ContractResult {
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub heights: Option<Vec<Height>>,
+}
+
+impl ContractResult {
+    pub fn success() -> Self {
+        Self { heights: None }
+    }
+
+    pub fn heights(mut self, heights: Vec<Height>) -> Self {
+        self.heights = Some(heights);
+        self
+    }
+}
diff --git a/ibc-clients/cw-context/src/utils/codec.rs b/ibc-clients/cw-context/src/utils/codec.rs
new file mode 100644
index 000000000..f31d9ab2f
--- /dev/null
+++ b/ibc-clients/cw-context/src/utils/codec.rs
@@ -0,0 +1,27 @@
+use ibc_core::client::types::error::ClientError;
+use ibc_core::primitives::proto::Any;
+use prost::Message;
+
+/// AnyCodec is a convenient trait that provides a generic way to encode and
+/// decode domain types through the `Any` type.
+pub trait AnyCodec {
+    fn decode_any_vec<C>(data: Vec<u8>) -> Result<C, ClientError>
+    where
+        C: TryFrom<Any, Error = ClientError>,
+    {
+        let raw = Any::decode(&mut data.as_slice()).map_err(|e| ClientError::Other {
+            description: e.to_string(),
+        })?;
+
+        C::try_from(raw)
+    }
+
+    fn encode_to_any_vec<C>(value: C) -> Vec<u8>
+    where
+        C: Into<Any>,
+    {
+        value.into().encode_to_vec()
+    }
+}
+
+impl<T> AnyCodec for T where T: TryFrom<Any, Error = ClientError> + Into<Any> {}
diff --git a/ibc-clients/cw-context/src/utils/mod.rs b/ibc-clients/cw-context/src/utils/mod.rs
new file mode 100644
index 000000000..612a46d5c
--- /dev/null
+++ b/ibc-clients/cw-context/src/utils/mod.rs
@@ -0,0 +1,25 @@
+mod codec;
+
+pub use codec::*;
+use ibc_core::client::types::error::ClientError;
+use ibc_core::client::types::{Height, HeightError};
+
+/// Decodes a `Height` from a UTF-8 encoded byte array.
+pub fn parse_height(encoded_height: Vec<u8>) -> Result<Option<Height>, ClientError> {
+    let height_str = match alloc::str::from_utf8(encoded_height.as_slice()) {
+        Ok(s) => s,
+        // In cases where the height is unavailable, the encoded representation
+        // might not be valid UTF-8, resulting in an invalid string. In such
+        // instances, we return None.
+        Err(_) => return Ok(None),
+    };
+    match Height::try_from(height_str) {
+        Ok(height) => Ok(Some(height)),
+        // This is a valid case, as the key may contain other data. We just skip
+        // it.
+        Err(HeightError::InvalidFormat { .. }) => Ok(None),
+        Err(e) => Err(ClientError::Other {
+            description: e.to_string(),
+        }),
+    }
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
new file mode 100644
index 000000000..34eb32812
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
@@ -0,0 +1,42 @@
+[package]
+name         = "ibc-client-tendermint-cw"
+authors      = { workspace = true }
+edition      = { workspace = true }
+license      = { workspace = true }
+repository   = { workspace = true }
+rust-version = { workspace = true }
+version      = { workspace = true }
+keywords     = ["ibc", "light-client", "ics07", "tendermint", "CosmWasm"]
+readme       = "./../../README.md"
+description  = """
+    The ICS-08 CosmWasm contract implementation of the ICS-07 Tendermint light client.
+"""
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+# ibc dependencies
+ibc-core              = { workspace = true }
+ibc-client-cw         = { workspace = true }
+ibc-client-tendermint = { workspace = true }
+
+# cosmwasm dependencies
+cosmwasm-std          = { workspace = true }
+
+[dev-dependencies]
+cosmwasm-vm           = { workspace = true }
+hex                   = { version = "0.4.2" }
+ibc-testkit           = { workspace = true }
+ibc-client-tendermint = { workspace = true }
+tendermint            = { workspace = true }
+tendermint-testgen    = { workspace = true }
+
+[features]
+default = ["std"]
+std = [
+    "ibc-core/std",
+    "ibc-client-cw/std",
+    "ibc-client-tendermint/std",
+]
+
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs b/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
new file mode 100644
index 000000000..dde85427b
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
@@ -0,0 +1,63 @@
+use ibc_client_cw::api::ClientType;
+use ibc_client_tendermint::client_state::ClientState;
+use ibc_client_tendermint::consensus_state::ConsensusState;
+use ibc_client_tendermint::types::{
+    ConsensusState as ConsensusStateType, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
+};
+use ibc_core::client::types::error::ClientError;
+use ibc_core::derive::ConsensusState as ConsensusStateDerive;
+use ibc_core::primitives::proto::Any;
+
+/// A unit struct that represents the Tendermint client type.
+#[derive(Clone, Debug)]
+pub struct TendermintClient;
+
+impl<'a> ClientType<'a> for TendermintClient {
+    type ClientState = ClientState;
+    type ConsensusState = AnyConsensusState;
+}
+
+#[derive(Clone, Debug, ConsensusStateDerive)]
+pub enum AnyConsensusState {
+    Tendermint(ConsensusState),
+}
+
+impl From<ConsensusStateType> for AnyConsensusState {
+    fn from(value: ConsensusStateType) -> Self {
+        AnyConsensusState::Tendermint(value.into())
+    }
+}
+
+impl TryFrom<AnyConsensusState> for ConsensusStateType {
+    type Error = ClientError;
+
+    fn try_from(value: AnyConsensusState) -> Result<Self, Self::Error> {
+        match value {
+            AnyConsensusState::Tendermint(state) => Ok(state.into_inner()),
+        }
+    }
+}
+
+impl From<AnyConsensusState> for Any {
+    fn from(value: AnyConsensusState) -> Self {
+        match value {
+            AnyConsensusState::Tendermint(cs) => cs.into(),
+        }
+    }
+}
+
+impl TryFrom<Any> for AnyConsensusState {
+    type Error = ClientError;
+
+    fn try_from(raw: Any) -> Result<Self, Self::Error> {
+        match raw.type_url.as_str() {
+            TENDERMINT_CONSENSUS_STATE_TYPE_URL => {
+                let cs = ConsensusState::try_from(raw)?;
+                Ok(AnyConsensusState::Tendermint(cs))
+            }
+            _ => Err(ClientError::UnknownConsensusStateType {
+                consensus_state_type: raw.type_url,
+            }),
+        }
+    }
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs b/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
new file mode 100644
index 000000000..b496c97c1
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
@@ -0,0 +1,40 @@
+use cosmwasm_std::{
+    entry_point, Binary, Deps, DepsMut, Env, MessageInfo, Response, StdError, StdResult,
+};
+use ibc_client_cw::context::Context;
+use ibc_client_cw::types::{ContractError, InstantiateMsg, QueryMsg, SudoMsg};
+
+use crate::client_type::TendermintClient;
+
+pub type TendermintContext<'a> = Context<'a, TendermintClient>;
+
+#[entry_point]
+pub fn instantiate(
+    deps: DepsMut<'_>,
+    env: Env,
+    _info: MessageInfo,
+    msg: InstantiateMsg,
+) -> Result<Response, ContractError> {
+    let mut ctx = TendermintContext::new_mut(deps, env)?;
+
+    let data = ctx.instantiate(msg)?;
+
+    Ok(Response::default().set_data(data))
+}
+
+#[entry_point]
+pub fn sudo(deps: DepsMut<'_>, env: Env, msg: SudoMsg) -> Result<Response, ContractError> {
+    let mut ctx = TendermintContext::new_mut(deps, env)?;
+
+    let data = ctx.sudo(msg)?;
+
+    Ok(Response::default().set_data(data))
+}
+
+#[entry_point]
+pub fn query(deps: Deps<'_>, env: Env, msg: QueryMsg) -> StdResult<Binary> {
+    let ctx = TendermintContext::new_ref(deps, env)?;
+
+    ctx.query(msg)
+        .map_err(|e| StdError::generic_err(e.to_string()))
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs b/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
new file mode 100644
index 000000000..cbed3ebe5
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
@@ -0,0 +1,18 @@
+//! The CosmWasm contract implementation of the ICS-07 Tendermint light client
+//! built using `ibc-rs`.
+#![cfg_attr(not(test), deny(clippy::unwrap_used))]
+#![deny(
+    warnings,
+    trivial_casts,
+    trivial_numeric_casts,
+    unused_import_braces,
+    unused_qualifications,
+    rust_2018_idioms
+)]
+#![forbid(unsafe_code)]
+
+pub mod client_type;
+pub mod entrypoint;
+
+#[cfg(test)]
+pub mod tests;
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
new file mode 100644
index 000000000..96ec1434a
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
@@ -0,0 +1,180 @@
+use std::ops::Add;
+use std::time::Duration;
+
+use cosmwasm_std::testing::mock_env;
+use cosmwasm_std::{from_json, Deps, DepsMut, Empty, StdError};
+use ibc_client_cw::types::{
+    CheckForMisbehaviourMsgRaw, ExportMetadataMsg, GenesisMetadata, InstantiateMsg, QueryMsg,
+    QueryResponse, StatusMsg, VerifyClientMessageRaw,
+};
+use ibc_client_cw::utils::AnyCodec;
+use ibc_client_tendermint::client_state::ClientState as TmClientState;
+use ibc_client_tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc_client_tendermint::types::Header;
+use ibc_core::client::types::{Height, Status};
+use ibc_core::host::types::identifiers::ChainId;
+use ibc_core::primitives::Timestamp;
+use ibc_testkit::fixtures::clients::tendermint::ClientStateConfig;
+use tendermint_testgen::{Generator, Validator};
+
+use super::helper::{dummy_checksum, dummy_sov_consensus_state};
+use crate::entrypoint::TendermintContext;
+
+/// Test fixture
+#[derive(Clone, Debug)]
+pub struct Fixture {
+    pub chain_id: ChainId,
+    pub trusted_timestamp: Timestamp,
+    pub trusted_height: Height,
+    pub target_height: Height,
+    pub validators: Vec<Validator>,
+    pub migration_mode: bool,
+}
+
+impl Default for Fixture {
+    fn default() -> Self {
+        Fixture {
+            chain_id: ChainId::new("test-chain").unwrap(),
+            // Returns a dummy timestamp for testing purposes. The value corresponds to the
+            // timestamp of the `mock_env()`.
+            trusted_timestamp: Timestamp::from_nanoseconds(1_571_797_419_879_305_533)
+                .expect("never fails"),
+            trusted_height: Height::new(0, 5).unwrap(),
+            target_height: Height::new(0, 10).unwrap(),
+            validators: vec![
+                Validator::new("1").voting_power(40),
+                Validator::new("2").voting_power(30),
+                Validator::new("3").voting_power(30),
+            ],
+            migration_mode: false,
+        }
+    }
+}
+
+impl Fixture {
+    pub fn migration_mode(mut self) -> Self {
+        self.migration_mode = true;
+        self
+    }
+
+    pub fn ctx_ref<'a>(&self, deps: Deps<'a, Empty>) -> TendermintContext<'a> {
+        let mut ctx = TendermintContext::new_ref(deps, mock_env()).expect("never fails");
+
+        if self.migration_mode {
+            ctx.set_subject_prefix();
+        };
+
+        ctx
+    }
+
+    pub fn ctx_mut<'a>(&self, deps: DepsMut<'a, Empty>) -> TendermintContext<'a> {
+        let mut ctx = TendermintContext::new_mut(deps, mock_env()).expect("never fails");
+
+        if self.migration_mode {
+            ctx.set_subject_prefix();
+        };
+
+        ctx
+    }
+
+    pub fn dummy_instantiate_msg(&self) -> InstantiateMsg {
+        // Setting the `trusting_period` to 1 second allows the quick client
+        // freeze for the `happy_cw_client_recovery` test.
+
+        let tm_client_state: TmClientState = ClientStateConfig::builder()
+            .chain_id("test-chain".parse().unwrap())
+            .trusting_period(Duration::from_secs(1))
+            .latest_height(self.trusted_height)
+            .build()
+            .try_into()
+            .expect("never fails");
+
+        let tm_consensus_state = dummy_sov_consensus_state(self.trusted_timestamp);
+
+        InstantiateMsg {
+            client_state: TmClientState::encode_to_any_vec(tm_client_state),
+            consensus_state: TmConsensusState::encode_to_any_vec(tm_consensus_state),
+            checksum: dummy_checksum(),
+        }
+    }
+
+    fn dummy_header(&self, header_height: Height) -> Vec<u8> {
+        // NOTE: since mock context has a fixed timestamp, we only can add up
+        // to allowed clock drift (3s)
+        let future_time = self
+            .trusted_timestamp
+            .add(Duration::from_secs(2))
+            .expect("never fails")
+            .into_tm_time()
+            .expect("Time exists");
+
+        let header = tendermint_testgen::Header::new(&self.validators)
+            .chain_id(self.chain_id.as_str())
+            .height(header_height.revision_height())
+            .time(future_time)
+            .next_validators(&self.validators)
+            .app_hash(vec![0; 32].try_into().expect("never fails"));
+
+        let light_block = tendermint_testgen::LightBlock::new_default_with_header(header)
+            .generate()
+            .expect("failed to generate light block");
+
+        let tm_header = Header {
+            signed_header: light_block.signed_header,
+            validator_set: light_block.validators,
+            trusted_height: self.trusted_height,
+            trusted_next_validator_set: light_block.next_validators,
+        };
+
+        Header::encode_to_any_vec(tm_header)
+    }
+
+    pub fn dummy_client_message(&self) -> Vec<u8> {
+        self.dummy_header(self.target_height)
+    }
+
+    /// Constructs a dummy misbehaviour message that is one block behind the
+    /// trusted height, but with a future timestamp.
+    pub fn dummy_misbehaviour_message(&self) -> Vec<u8> {
+        let prev_height = self.trusted_height.decrement().expect("never fails");
+
+        self.dummy_header(prev_height)
+    }
+
+    pub fn verify_client_message(&self, deps: Deps<'_>, client_message: Vec<u8>) {
+        let resp = self.query(deps, VerifyClientMessageRaw { client_message }.into());
+
+        assert!(resp.is_valid);
+        assert!(resp.status.is_none());
+        assert!(resp.found_misbehaviour.is_none());
+    }
+
+    pub fn check_for_misbehaviour(&self, deps: Deps<'_>, client_message: Vec<u8>) {
+        let resp = self.query(deps, CheckForMisbehaviourMsgRaw { client_message }.into());
+
+        assert!(resp.is_valid);
+        assert_eq!(resp.found_misbehaviour, Some(true));
+    }
+
+    pub fn check_client_status(&self, deps: Deps<'_>, expected: Status) {
+        let resp = self.query(deps, StatusMsg {}.into());
+
+        assert_eq!(resp.status, Some(expected.to_string()));
+    }
+
+    pub fn get_metadata(&self, deps: Deps<'_>) -> Option<Vec<GenesisMetadata>> {
+        self.query(deps, ExportMetadataMsg {}.into())
+            .genesis_metadata
+    }
+
+    pub fn query(&self, deps: Deps<'_>, msg: QueryMsg) -> QueryResponse {
+        let ctx = self.ctx_ref(deps);
+
+        let resp_bytes = ctx
+            .query(msg)
+            .map_err(|e| StdError::generic_err(e.to_string()))
+            .unwrap();
+
+        from_json(resp_bytes).unwrap()
+    }
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
new file mode 100644
index 000000000..57bf8c9e3
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
@@ -0,0 +1,26 @@
+use std::str::FromStr;
+
+use cosmwasm_std::testing::mock_info;
+use cosmwasm_std::{coins, MessageInfo};
+use ibc_client_tendermint::types::ConsensusState;
+use ibc_core::primitives::Timestamp;
+use tendermint::Hash;
+
+pub fn dummy_msg_info() -> MessageInfo {
+    mock_info("creator", &coins(1000, "ibc"))
+}
+
+pub fn dummy_checksum() -> Vec<u8> {
+    hex::decode("2469f43c3ca20d476442bd3d98cbd97a180776ab37332aa7b02cae5a620acfc6")
+        .expect("Never fails")
+}
+
+pub fn dummy_sov_consensus_state(timestamp: Timestamp) -> ConsensusState {
+    ConsensusState::new(
+        vec![0].into(),
+        timestamp.into_tm_time().expect("Time exists"),
+        // Hash of default validator set
+        Hash::from_str("D6B93922C33AAEBEC9043566CB4B1B48365B1358B67C7DEF986D9EE1861BC143")
+            .expect("Never fails"),
+    )
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
new file mode 100644
index 000000000..3918b52d6
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
@@ -0,0 +1,108 @@
+pub mod fixture;
+pub mod helper;
+
+use cosmwasm_std::from_json;
+use cosmwasm_std::testing::{mock_dependencies, mock_env};
+use ibc_client_cw::types::{
+    ContractResult, MigrateClientStoreMsg, UpdateStateMsgRaw, UpdateStateOnMisbehaviourMsgRaw,
+};
+use ibc_core::client::types::Status;
+
+use crate::entrypoint::{instantiate, sudo};
+use crate::tests::fixture::Fixture;
+use crate::tests::helper::dummy_msg_info;
+
+#[test]
+fn happy_cw_create_client() {
+    let fxt = Fixture::default();
+
+    let mut deps = mock_dependencies();
+
+    let instantiate_msg = fxt.dummy_instantiate_msg();
+
+    let resp = instantiate(deps.as_mut(), mock_env(), dummy_msg_info(), instantiate_msg).unwrap();
+
+    assert_eq!(0, resp.messages.len());
+
+    let contract_result: ContractResult = from_json(resp.data.unwrap()).unwrap();
+
+    assert!(contract_result.heights.is_none());
+
+    fxt.check_client_status(deps.as_ref(), Status::Active);
+}
+
+#[test]
+fn happy_cw_update_client() {
+    let fxt = Fixture::default();
+
+    let mut deps = mock_dependencies();
+
+    // ------------------- Create client -------------------
+
+    let instantiate_msg = fxt.dummy_instantiate_msg();
+
+    instantiate(deps.as_mut(), mock_env(), dummy_msg_info(), instantiate_msg).unwrap();
+
+    // ------------------- Verify and Update client -------------------
+
+    let client_message = fxt.dummy_client_message();
+
+    fxt.verify_client_message(deps.as_ref(), client_message.clone());
+
+    let resp = sudo(
+        deps.as_mut(),
+        mock_env(),
+        UpdateStateMsgRaw { client_message }.into(),
+    )
+    .unwrap();
+
+    // ------------------- Check response -------------------
+
+    assert_eq!(0, resp.messages.len());
+
+    let contract_result: ContractResult = from_json(resp.data.unwrap()).unwrap();
+
+    assert_eq!(contract_result.heights, Some(vec![fxt.target_height]));
+
+    fxt.check_client_status(deps.as_ref(), Status::Active);
+}
+
+#[test]
+fn happy_cw_recovery_client() {
+    let fxt = Fixture::default().migration_mode();
+
+    let mut deps = mock_dependencies();
+
+    let mut ctx = fxt.ctx_mut(deps.as_mut());
+
+    // ------------------- Create subject client -------------------
+
+    let instantiate_msg = fxt.dummy_instantiate_msg();
+
+    ctx.instantiate(instantiate_msg.clone()).unwrap();
+
+    // ------------------- Freeze subject client -------------------
+
+    let client_message = fxt.dummy_misbehaviour_message();
+
+    fxt.check_for_misbehaviour(deps.as_ref(), client_message.clone());
+
+    let mut ctx = fxt.ctx_mut(deps.as_mut());
+
+    ctx.sudo(UpdateStateOnMisbehaviourMsgRaw { client_message }.into())
+        .unwrap();
+
+    // ------------------- Create substitute client -------------------
+
+    ctx.set_substitute_prefix();
+
+    ctx.instantiate(instantiate_msg).unwrap();
+
+    // ------------------- Recover subject client -------------------
+
+    let resp = sudo(deps.as_mut(), mock_env(), MigrateClientStoreMsg {}.into()).unwrap();
+
+    assert_eq!(0, resp.messages.len());
+
+    fxt.check_client_status(deps.as_ref(), Status::Active);
+}
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index 3fbf0cb68..db986dc74 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -19,7 +19,7 @@ description  = """
 base64          = { workspace = true , features = ["alloc"] }
 displaydoc      = { workspace = true }
 serde           = { workspace = true , optional = true }
-cosmwasm-schema = { version = "1.4.1", default-features = false, optional = true }
+cosmwasm-schema = { workspace = true , optional = true }
 
 # ibc dependencies
 ibc-core-client     = { workspace = true }
diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index 800b82cbd..c00344252 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -22,7 +22,7 @@ all-features = true
 borsh       = { workspace = true, optional = true }
 derive_more = { workspace = true }
 displaydoc  = { workspace = true }
-prost       = { version = "0.12", default-features = false }
+prost       = { workspace = true }
 schemars    = { workspace = true, optional = true }
 serde       = { workspace = true, optional = true }
 time        = { version = ">=0.3.0, <0.3.35", default-features = false }
diff --git a/makefile b/makefile
index f185a1045..ee1a28e72 100644
--- a/makefile
+++ b/makefile
@@ -40,3 +40,9 @@ check-release: ## Check that the release build compiles.
 
 release: ## Perform an actual release and publishes to crates.io.
 	cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
+
+build-tendermint-cw: ## Build the WASM file for the ICS-07 Tendermint light client.
+	@echo "Building the WASM file for the ICS-07 Tendermint light client"
+	RUSTFLAGS='-C link-arg=-s' cargo build -p ibc-client-tendermint-cw --target wasm32-unknown-unknown --release --lib --locked
+	mkdir -p cw-contracts
+	cp target/wasm32-unknown-unknown/release/ibc_client_tendermint_cw.wasm cw-contracts/

From 80b8084c0415a4636e71a0f4520e18ad3c1dae16 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Sat, 20 Apr 2024 07:47:57 -0400
Subject: [PATCH 150/182] ci(ibc-clients): upload Tendermint CosmWasm client as
 workflow artifact (#1173)

* tendermint wasm08 client as workflow artifact

* rm retention days

* lints on comments

* conditional retention days

* use actions-rust-lang over dtolnay

* imp docker run

* use cosmwasm/optimizer 0.15.1

* correct mount paths

* validate checksum

* s/wasm08/cosmwasm

* .yaml over .yml

* install cargo binary before wasm compile to avoid docker mount permission

* fix permissions manually

* use id

* tendermint over tm

* document tendermint cw artifact

* grammar
---
 .github/workflows/upload-cw-clients.yaml | 96 ++++++++++++++++++++++++
 ibc-clients/README.md                    |  8 ++
 2 files changed, 104 insertions(+)
 create mode 100644 .github/workflows/upload-cw-clients.yaml

diff --git a/.github/workflows/upload-cw-clients.yaml b/.github/workflows/upload-cw-clients.yaml
new file mode 100644
index 000000000..b67bdf317
--- /dev/null
+++ b/.github/workflows/upload-cw-clients.yaml
@@ -0,0 +1,96 @@
+name: Upload CosmWasm clients as Github workflow artifact
+on:
+  pull_request:
+    paths:
+      - .github/workflows/upload-cw-clients.yaml
+      - Cargo.toml
+      - ci/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
+      - ibc-testkit/**
+      - ibc-derive/**
+  push:
+    branches: main
+    paths:
+      - .github/workflows/upload-cw-clients.yaml
+      - Cargo.toml
+      - ci/**
+      - ibc/**
+      - ibc-core/**
+      - ibc-apps/**
+      - ibc-data-types/**
+      - ibc-clients/**
+      - ibc-primitives/**
+      - ibc-query/**
+      - ibc-testkit/**
+      - ibc-derive/**
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  upload-tendermint-cw-client:
+    name: Compile and upload Tendermint CosmWasm client
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+
+      # `cosmwasm/optimizer` requires `Cargo.lock`. but currently,
+      # `Cargo.lock` is not committed, because `ibc-rs` is treated as library.
+      - name: Produce `Cargo.lock` file
+        run: cargo update -p ibc-client-tendermint-cw
+
+      - name: Create mount directories
+        run: mkdir -p "${HOME}/.cargo/registry" "$(pwd)"/target
+
+      - name: Compile cosmwasm blob for tendermint light client
+        run: |
+          docker run \
+          -v "$(pwd)":/code \
+          -v "$(pwd)"/target:/target \
+          -v "${HOME}/.cargo/registry":/usr/local/cargo/registry \
+          cosmwasm/optimizer:0.15.1 ./ibc-clients/ics07-tendermint/cw-contract
+
+      - name: Fix permissions
+        run: |
+          sudo chown -R $(id -u):$(id -g) "$(pwd)"/target
+          sudo chown -R $(id -u):$(id -g) "${HOME}/.cargo/registry"
+
+      - name: Install `cosmwasm-check` from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: cosmwasm-check
+
+      - name: Check compiled CosmWasm contract
+        working-directory: artifacts
+        run: |
+          sha256sum -c checksums.txt
+          cosmwasm-check ibc_client_tendermint_cw.wasm
+
+      - name: Upload compiled CosmWasm contract
+        uses: actions/upload-artifact@v4
+        with:
+          name: tendermint-cw-${{ github.sha }}
+          path: artifacts/ibc_client_tendermint_cw.wasm
+          # Retain the artifact for 1 week for PRs and 3 months for `main` branch
+          retention-days: ${{ github.event_name == 'pull_request' && 7 || 90 }}
+          overwrite: true
+
+  # # An example workflow to download the artifact:
+  # download-tendermint-cw-client:
+  #   name: Download pre-compiled Tendermint CosmWasm client
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/download-artifact@v4
+  #       with:
+  #         name: tendermint-cw-${{ env.IBC_RS_COMMIT_HASH }}
+  #         repository: cosmos/ibc-rs
+  #     - run: ls -l ibc_client_tendermint_cw.wasm
diff --git a/ibc-clients/README.md b/ibc-clients/README.md
index 014ab3248..f65b3c7bd 100644
--- a/ibc-clients/README.md
+++ b/ibc-clients/README.md
@@ -27,6 +27,14 @@ IBC light clients:
 - [ibc-client-tendermint](./ics07-tendermint): Implementation
 - [ibc-client-tendermint-cw](./ics07-tendermint/cw-contract): CosmWasm Contract
 
+> [!TIP]
+> The pre-compiled CosmWasm contract for `ibc-client-tendermint-cw` is available
+> as Github workflow artifacts at
+> [_Actions_](https://github.com/cosmos/ibc-rs/actions/workflows/upload-cw-clients.yaml)
+> tab. They can be downloaded
+> [during a Github workflow](https://github.com/cosmos/ibc-rs/blob/1098f252c04152812f026520e28e323f3bc0507e/.github/workflows/upload-cw-clients.yaml#L87-L96)
+> using `actions/download-artifact@v4` action.
+
 ### ICS-08: WASM Proxy Light Client
 
 - [ibc-client-wasm-types](./ics08-wasm/types)

From d0f7cc41c413bdb1e801acaa566f3e7cf06c2c93 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Mon, 22 Apr 2024 06:22:16 -0400
Subject: [PATCH 151/182] fix(cw-context): encoding, decoding and iteration of 
 `ConsensusState` heights (#1176)

* only consider ITERATE_CONSENSUS_STATE_PREFIX keys

* use proto codec

* refactor with updated parse_height type sig

* encode and decode height funcs

* fix clippy

* rm redundant type annotation

* add changelog entry

* correct link on changelog

* rm changelog entry

* handle missing case

* use cw_storage_plus::Map

* store or delete height keys at cw_storage_plus::Map

* use cw_storage_plus::Map range or keys

* rm redundant encode_height and decode_height

* add comment

* use imports

* cargo format

* deserialized result must be handled

* update doc string
---
 Cargo.toml                                    |   1 +
 ibc-clients/cw-context/Cargo.toml             |   1 +
 .../cw-context/src/context/client_ctx.rs      |  26 ++--
 ibc-clients/cw-context/src/context/mod.rs     | 137 +++++++++++-------
 ibc-clients/cw-context/src/lib.rs             |   2 -
 ibc-clients/cw-context/src/utils/mod.rs       |  22 ---
 6 files changed, 105 insertions(+), 84 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index b85c7e0c1..62981c026 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -119,6 +119,7 @@ tendermint-testgen               = { version = "0.34.0", default-features = fals
 cosmwasm-schema    = { version = "1.5.2" }
 cosmwasm-std       = { version = "1.5.2" }
 cosmwasm-vm        = { version = "1.5.2" }
+cw-storage-plus    = { version = "1.2.0" }
 
 # parity dependencies
 parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"] }
diff --git a/ibc-clients/cw-context/Cargo.toml b/ibc-clients/cw-context/Cargo.toml
index c3fd8ecb5..95132d252 100644
--- a/ibc-clients/cw-context/Cargo.toml
+++ b/ibc-clients/cw-context/Cargo.toml
@@ -28,6 +28,7 @@ ibc-client-wasm-types = { workspace = true, features = ["cosmwasm"] }
 # cosmwasm dependencies
 cosmwasm-schema       = { workspace = true }
 cosmwasm-std          = { workspace = true }
+cw-storage-plus       = { workspace = true }
 
 [features]
 default = ["std"]
diff --git a/ibc-clients/cw-context/src/context/client_ctx.rs b/ibc-clients/cw-context/src/context/client_ctx.rs
index ca1b2f6f9..acb45c311 100644
--- a/ibc-clients/cw-context/src/context/client_ctx.rs
+++ b/ibc-clients/cw-context/src/context/client_ctx.rs
@@ -7,12 +7,13 @@ use ibc_core::client::types::error::ClientError;
 use ibc_core::client::types::Height;
 use ibc_core::handler::types::error::ContextError;
 use ibc_core::host::types::identifiers::ClientId;
-use ibc_core::host::types::path::{iteration_key, ClientConsensusStatePath, ClientStatePath};
+use ibc_core::host::types::path::{ClientConsensusStatePath, ClientStatePath};
 use ibc_core::primitives::proto::{Any, Protobuf};
 use ibc_core::primitives::Timestamp;
 
-use super::Context;
+use super::{Context, StorageMut};
 use crate::api::ClientType;
+use crate::context::CONSENSUS_STATE_HEIGHT_MAP;
 use crate::utils::AnyCodec;
 
 impl<'a, C: ClientType<'a>> ClientValidationContext for Context<'a, C> {
@@ -154,11 +155,15 @@ impl<'a, C: ClientType<'a>> ClientExecutionContext for Context<'a, C> {
 
         self.insert(prefixed_height_key, revision_height_vec);
 
-        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
-
-        let height_vec = height.to_string().into_bytes();
-
-        self.insert(iteration_key, height_vec);
+        CONSENSUS_STATE_HEIGHT_MAP
+            .save(
+                self.storage_mut(),
+                (height.revision_number(), height.revision_height()),
+                &Default::default(),
+            )
+            .map_err(|e| ClientError::Other {
+                description: e.to_string(),
+            })?;
 
         Ok(())
     }
@@ -180,9 +185,10 @@ impl<'a, C: ClientType<'a>> ClientExecutionContext for Context<'a, C> {
 
         self.remove(prefixed_height_key);
 
-        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
-
-        self.remove(iteration_key);
+        CONSENSUS_STATE_HEIGHT_MAP.remove(
+            self.storage_mut(),
+            (height.revision_number(), height.revision_height()),
+        );
 
         Ok(())
     }
diff --git a/ibc-clients/cw-context/src/context/mod.rs b/ibc-clients/cw-context/src/context/mod.rs
index 19b6d0006..1000f837c 100644
--- a/ibc-clients/cw-context/src/context/mod.rs
+++ b/ibc-clients/cw-context/src/context/mod.rs
@@ -3,7 +3,8 @@ pub mod custom_ctx;
 
 use std::str::FromStr;
 
-use cosmwasm_std::{Deps, DepsMut, Env, Order, Storage};
+use cosmwasm_std::{Deps, DepsMut, Empty, Env, Order, Storage};
+use cw_storage_plus::{Bound, Map};
 use ibc_client_wasm_types::client_state::ClientState as WasmClientState;
 use ibc_core::client::context::client_state::ClientStateCommon;
 use ibc_core::client::types::error::ClientError;
@@ -18,10 +19,18 @@ use prost::Message;
 
 use crate::api::ClientType;
 use crate::types::{ContractError, GenesisMetadata, HeightTravel, MigrationPrefix};
-use crate::utils::{parse_height, AnyCodec};
+use crate::utils::AnyCodec;
 
 type Checksum = Vec<u8>;
 
+/// - [`Height`] can not be used directly as keys in the map,
+/// as it doesn't implement some cw_storage specific traits.
+/// - Only a sorted set is needed. So the value type is set to
+/// [`Empty`] following
+/// ([cosmwasm-book](https://book.cosmwasm.com/cross-contract/map-storage.html#maps-as-sets)).
+pub const CONSENSUS_STATE_HEIGHT_MAP: Map<'_, (u64, u64), Empty> =
+    Map::new(ITERATE_CONSENSUS_STATE_PREFIX);
+
 /// Context is a wrapper around the deps and env that gives access to the
 /// methods under the ibc-rs Validation and Execution traits.
 pub struct Context<'a, C: ClientType<'a>> {
@@ -130,13 +139,16 @@ impl<'a, C: ClientType<'a>> Context<'a, C> {
 
     /// Returns the storage of the context.
     pub fn get_heights(&self) -> Result<Vec<Height>, ClientError> {
-        let iterator = self.storage_ref().range(None, None, Order::Ascending);
-
-        let heights: Vec<_> = iterator
-            .filter_map(|(_, value)| parse_height(value).transpose())
-            .collect::<Result<_, _>>()?;
-
-        Ok(heights)
+        CONSENSUS_STATE_HEIGHT_MAP
+            .keys(self.storage_ref(), None, None, Order::Ascending)
+            .map(|deserialized_result| {
+                let (rev_number, rev_height) =
+                    deserialized_result.map_err(|e| ClientError::Other {
+                        description: e.to_string(),
+                    })?;
+                Height::new(rev_number, rev_height)
+            })
+            .collect()
     }
 
     /// Searches for either the earliest next or latest previous height based on
@@ -146,22 +158,37 @@ impl<'a, C: ClientType<'a>> Context<'a, C> {
         height: &Height,
         travel: HeightTravel,
     ) -> Result<Option<Height>, ClientError> {
-        let iteration_key = iteration_key(height.revision_number(), height.revision_height());
-
-        let mut iterator = match travel {
-            HeightTravel::Prev => {
-                self.storage_ref()
-                    .range(None, Some(&iteration_key), Order::Descending)
-            }
-            HeightTravel::Next => {
-                self.storage_ref()
-                    .range(Some(&iteration_key), None, Order::Ascending)
-            }
+        let iterator = match travel {
+            HeightTravel::Prev => CONSENSUS_STATE_HEIGHT_MAP.range(
+                self.storage_ref(),
+                None,
+                Some(Bound::exclusive((
+                    height.revision_number(),
+                    height.revision_height(),
+                ))),
+                Order::Descending,
+            ),
+            HeightTravel::Next => CONSENSUS_STATE_HEIGHT_MAP.range(
+                self.storage_ref(),
+                Some(Bound::exclusive((
+                    height.revision_number(),
+                    height.revision_height(),
+                ))),
+                None,
+                Order::Ascending,
+            ),
         };
 
         iterator
+            .map(|deserialized_result| {
+                let ((rev_number, rev_height), _) =
+                    deserialized_result.map_err(|e| ClientError::Other {
+                        description: e.to_string(),
+                    })?;
+                Height::new(rev_number, rev_height)
+            })
             .next()
-            .map_or(Ok(None), |(_, height)| parse_height(height))
+            .transpose()
     }
 
     /// Returns the key for the client update time.
@@ -191,38 +218,48 @@ impl<'a, C: ClientType<'a>> Context<'a, C> {
     pub fn get_metadata(&self) -> Result<Option<Vec<GenesisMetadata>>, ContractError> {
         let mut metadata = Vec::<GenesisMetadata>::new();
 
-        let start_key = ITERATE_CONSENSUS_STATE_PREFIX.to_string().into_bytes();
-
-        let iterator = self
-            .storage_ref()
-            .range(Some(&start_key), None, Order::Ascending);
-
-        for (_, encoded_height) in iterator {
-            let height = parse_height(encoded_height)?;
-
-            match height {
-                Some(height) => {
-                    let processed_height_key = self.client_update_height_key(&height);
-                    metadata.push(GenesisMetadata {
-                        key: processed_height_key.clone(),
-                        value: self.retrieve(&processed_height_key)?,
-                    });
-                    let processed_time_key = self.client_update_time_key(&height);
-                    metadata.push(GenesisMetadata {
-                        key: processed_time_key.clone(),
-                        value: self.retrieve(&processed_time_key)?,
-                    });
-                }
-                None => continue,
-            }
+        let iterator = CONSENSUS_STATE_HEIGHT_MAP
+            .keys(self.storage_ref(), None, None, Order::Ascending)
+            .map(|deserialized_result| {
+                let (rev_number, rev_height) =
+                    deserialized_result.map_err(|e| ClientError::Other {
+                        description: e.to_string(),
+                    })?;
+                Height::new(rev_number, rev_height)
+            });
+
+        for height_result in iterator {
+            let height = height_result?;
+
+            let processed_height_key = self.client_update_height_key(&height);
+            metadata.push(GenesisMetadata {
+                key: processed_height_key.clone(),
+                value: self.retrieve(&processed_height_key)?,
+            });
+            let processed_time_key = self.client_update_time_key(&height);
+            metadata.push(GenesisMetadata {
+                key: processed_time_key.clone(),
+                value: self.retrieve(&processed_time_key)?,
+            });
         }
 
-        let iterator = self
-            .storage_ref()
-            .range(Some(&start_key), None, Order::Ascending);
+        let iterator = CONSENSUS_STATE_HEIGHT_MAP
+            .keys(self.storage_ref(), None, None, Order::Ascending)
+            .map(|deserialized_result| {
+                let (rev_number, rev_height) =
+                    deserialized_result.map_err(|e| ClientError::Other {
+                        description: e.to_string(),
+                    })?;
+                Height::new(rev_number, rev_height)
+            });
+
+        for height_result in iterator {
+            let height = height_result?;
 
-        for (key, height) in iterator {
-            metadata.push(GenesisMetadata { key, value: height });
+            metadata.push(GenesisMetadata {
+                key: iteration_key(height.revision_number(), height.revision_height()),
+                value: height.encode_vec(),
+            });
         }
 
         Ok(Some(metadata))
diff --git a/ibc-clients/cw-context/src/lib.rs b/ibc-clients/cw-context/src/lib.rs
index 792811815..b1f72df01 100644
--- a/ibc-clients/cw-context/src/lib.rs
+++ b/ibc-clients/cw-context/src/lib.rs
@@ -18,8 +18,6 @@
 )]
 #![forbid(unsafe_code)]
 
-extern crate alloc;
-
 pub mod api;
 pub mod context;
 pub mod handlers;
diff --git a/ibc-clients/cw-context/src/utils/mod.rs b/ibc-clients/cw-context/src/utils/mod.rs
index 612a46d5c..38e96fd59 100644
--- a/ibc-clients/cw-context/src/utils/mod.rs
+++ b/ibc-clients/cw-context/src/utils/mod.rs
@@ -1,25 +1,3 @@
 mod codec;
 
 pub use codec::*;
-use ibc_core::client::types::error::ClientError;
-use ibc_core::client::types::{Height, HeightError};
-
-/// Decodes a `Height` from a UTF-8 encoded byte array.
-pub fn parse_height(encoded_height: Vec<u8>) -> Result<Option<Height>, ClientError> {
-    let height_str = match alloc::str::from_utf8(encoded_height.as_slice()) {
-        Ok(s) => s,
-        // In cases where the height is unavailable, the encoded representation
-        // might not be valid UTF-8, resulting in an invalid string. In such
-        // instances, we return None.
-        Err(_) => return Ok(None),
-    };
-    match Height::try_from(height_str) {
-        Ok(height) => Ok(Some(height)),
-        // This is a valid case, as the key may contain other data. We just skip
-        // it.
-        Err(HeightError::InvalidFormat { .. }) => Ok(None),
-        Err(e) => Err(ClientError::Other {
-            description: e.to_string(),
-        }),
-    }
-}

From 41348affc4047870d976eb8d2e26863b01745eee Mon Sep 17 00:00:00 2001
From: Fabien Penso <fabien@pen.so>
Date: Mon, 22 Apr 2024 19:01:11 +0200
Subject: [PATCH 152/182] fix(ics04): packet receive event type identifier
 (#1179)

* fix: ics04 packet event name

* Add Changelog

* Fix Changelog

* nit on const decl group

* nits on changelog entry

* Add link to ibc-go channel events

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 .../bug-fixes/1179-fix-packet-attribute-name.md           | 2 ++
 ibc-core/ics04-channel/types/src/events/mod.rs            | 8 +++++---
 2 files changed, 7 insertions(+), 3 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md

diff --git a/.changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md b/.changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md
new file mode 100644
index 000000000..3040ade5d
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md
@@ -0,0 +1,2 @@
+- [ibc-core-channel-types] Make receive packet event type identifier consistent
+  with `ibc-go`. ([\#1180](https://github.com/cosmos/ibc-rs/issues/1180))
diff --git a/ibc-core/ics04-channel/types/src/events/mod.rs b/ibc-core/ics04-channel/types/src/events/mod.rs
index 3fee6bb6e..443119b3e 100644
--- a/ibc-core/ics04-channel/types/src/events/mod.rs
+++ b/ibc-core/ics04-channel/types/src/events/mod.rs
@@ -25,20 +25,22 @@ use super::Version;
 use crate::error::ChannelError;
 use crate::packet::Packet;
 
-/// Channel event types
+/// Channel event types corresponding to ibc-go's channel events:
+/// https://github.com/cosmos/ibc-go/blob/c4413c5877f9ef883494da1721cb18caaba7f7f5/modules/core/04-channel/types/events.go#L52-L72
 const CHANNEL_OPEN_INIT_EVENT: &str = "channel_open_init";
 const CHANNEL_OPEN_TRY_EVENT: &str = "channel_open_try";
 const CHANNEL_OPEN_ACK_EVENT: &str = "channel_open_ack";
 const CHANNEL_OPEN_CONFIRM_EVENT: &str = "channel_open_confirm";
 const CHANNEL_CLOSE_INIT_EVENT: &str = "channel_close_init";
 const CHANNEL_CLOSE_CONFIRM_EVENT: &str = "channel_close_confirm";
+const CHANNEL_CLOSED_EVENT: &str = "channel_close";
+
 /// Packet event types
 const SEND_PACKET_EVENT: &str = "send_packet";
-const RECEIVE_PACKET_EVENT: &str = "receive_packet";
+const RECEIVE_PACKET_EVENT: &str = "recv_packet";
 const WRITE_ACK_EVENT: &str = "write_acknowledgement";
 const ACK_PACKET_EVENT: &str = "acknowledge_packet";
 const TIMEOUT_EVENT: &str = "timeout_packet";
-const CHANNEL_CLOSED_EVENT: &str = "channel_close";
 
 #[cfg_attr(
     feature = "parity-scale-codec",

From 68f8c487fe83872c783ef28ba90b86d5698c344f Mon Sep 17 00:00:00 2001
From: Carlos Rodriguez <carlos@interchain.io>
Date: Wed, 24 Apr 2024 13:31:14 +0200
Subject: [PATCH 153/182] imp: add macro for schema support to queries (#1187)

---
 ibc-clients/cw-context/src/types/msgs.rs | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/ibc-clients/cw-context/src/types/msgs.rs b/ibc-clients/cw-context/src/types/msgs.rs
index 58ca50470..506d65695 100644
--- a/ibc-clients/cw-context/src/types/msgs.rs
+++ b/ibc-clients/cw-context/src/types/msgs.rs
@@ -2,7 +2,7 @@
 //! light client.
 use std::str::FromStr;
 
-use cosmwasm_schema::cw_serde;
+use cosmwasm_schema::{cw_serde, QueryResponses};
 use ibc_client_wasm_types::serializer::Base64;
 use ibc_client_wasm_types::Bytes;
 use ibc_core::client::types::proto::v1::Height as RawHeight;
@@ -231,13 +231,18 @@ pub struct MigrateClientStoreMsg {}
 // Implementation of the QueryMsg enum and its variants
 // ------------------------------------------------------------
 
-#[derive(derive_more::From)]
+#[derive(QueryResponses, derive_more::From)]
 #[cw_serde]
 pub enum QueryMsg {
+    #[returns(crate::types::response::QueryResponse)]
     Status(StatusMsg),
+    #[returns(crate::types::response::QueryResponse)]
     ExportMetadata(ExportMetadataMsg),
+    #[returns(crate::types::response::QueryResponse)]
     TimestampAtHeight(TimestampAtHeightMsg),
+    #[returns(crate::types::response::QueryResponse)]
     VerifyClientMessage(VerifyClientMessageRaw),
+    #[returns(crate::types::response::QueryResponse)]
     CheckForMisbehaviour(CheckForMisbehaviourMsgRaw),
 }
 

From 1984880192c53d47f7042ad1b933f99348e91792 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Wed, 24 Apr 2024 06:35:38 -0500
Subject: [PATCH 154/182] chore(deps): update CosmWasm dependencies (#1189)

* Update cosmwasm dependencies

* update cw-check cargo lockfile

* update no-std-check cargo lockfile

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 Cargo.toml                 |   6 +-
 ci/cw-check/Cargo.lock     | 276 ++++++++-------
 ci/cw-check/Cargo.toml     |   4 +-
 ci/no-std-check/Cargo.lock | 707 +++++++++++++++++--------------------
 4 files changed, 479 insertions(+), 514 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 62981c026..d1abc6906 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -116,9 +116,9 @@ tendermint-testgen               = { version = "0.34.0", default-features = fals
 ### Note: Kept at the following version to match the CosmWasm module version
 ### used by chains supporting the wasm-enabled version of ibc-go v7.3
 ### (This is the min version of `ibc-go` that supports `08-wasm` light clients)
-cosmwasm-schema    = { version = "1.5.2" }
-cosmwasm-std       = { version = "1.5.2" }
-cosmwasm-vm        = { version = "1.5.2" }
+cosmwasm-schema    = { version = "1.5.4" }
+cosmwasm-std       = { version = "1.5.4" }
+cosmwasm-vm        = { version = "1.5.4" }
 cw-storage-plus    = { version = "1.2.0" }
 
 # parity dependencies
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 35694830f..5e715058c 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -4,9 +4,9 @@ version = 3
 
 [[package]]
 name = "ahash"
-version = "0.7.7"
+version = "0.7.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a824f2aa7e75a0c98c5a504fceb80649e9c35265d44525b5f94de4771a395cd"
+checksum = "891477e0c6a8957309ee5c45a6368af3ae14bb510732d2684ffa19af310920f9"
 dependencies = [
  "getrandom",
  "once_cell",
@@ -15,9 +15,15 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.79"
+version = "1.0.82"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f538837af36e6f6a9be0faa67f9a314f8119e4e4b5867c6ab40ed60360142519"
+
+[[package]]
+name = "arrayref"
+version = "0.3.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "080e9890a082662b09c1ad45f567faeeb47f22b5fb23895fbe1e651e718e25ca"
+checksum = "6b4930d2cb77ce62f89ee5d5289b4ac049559b1c45539271f5ed4fdc7db34545"
 
 [[package]]
 name = "arrayvec"
@@ -27,9 +33,9 @@ checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "autocfg"
-version = "1.1.0"
+version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
+checksum = "f1fdabc7756949593fe60f30ec81974b613357de856987752631dea1e3394c80"
 
 [[package]]
 name = "base16ct"
@@ -39,15 +45,9 @@ checksum = "4c7f02d4ea65f2c1853089ffd8d2787bdbc63de2f0d29dedbcf8ccdfa0ccd4cf"
 
 [[package]]
 name = "base64"
-version = "0.13.1"
+version = "0.21.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9e1b586273c5702936fe7b7d6896644d8be71e6314cfe09d3167c95f712589e8"
-
-[[package]]
-name = "base64"
-version = "0.21.6"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c79fed4cdb43e993fcdadc7e58a09fd0e3e649c4436fa11da71c9f1f3ee7feb9"
+checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
 [[package]]
 name = "base64ct"
@@ -61,6 +61,28 @@ version = "0.9.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d86b93f97252c47b41663388e6d155714a9d0c398b99f1005cbc5f978b29f445"
 
+[[package]]
+name = "blake2"
+version = "0.10.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "46502ad458c9a52b69d4d4d32775c788b7a1b85e8bc9d482d92250fc0e3f8efe"
+dependencies = [
+ "digest 0.10.7",
+]
+
+[[package]]
+name = "blake3"
+version = "1.5.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "30cca6d3674597c30ddf2c587bf8d9d65c9a84d2326d941cc79c9842dfe0ef52"
+dependencies = [
+ "arrayref",
+ "arrayvec",
+ "cc",
+ "cfg-if",
+ "constant_time_eq",
+]
+
 [[package]]
 name = "block-buffer"
 version = "0.9.0"
@@ -99,13 +121,19 @@ checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
 
 [[package]]
 name = "bytes"
-version = "1.5.0"
+version = "1.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a2bd12c1caf447e69cd4528f47f94d203fd2582878ecb9e9465484c4148a8223"
+checksum = "514de17de45fdb8dc022b1a7975556c53c86f9f0aa5f534b98977b171857c2c9"
 dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "cc"
+version = "1.0.95"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d32a725bc159af97c3e629873bb9f88fb8cf8a4867175f76dc987815ea07c83b"
+
 [[package]]
 name = "cfg-if"
 version = "1.0.0"
@@ -118,11 +146,17 @@ version = "0.9.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c2459377285ad874054d797f3ccebf984978aa39129f6eafde5cdc8315b612f8"
 
+[[package]]
+name = "constant_time_eq"
+version = "0.3.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f7144d30dcf0fafbce74250a3963025d8d52177934239851c917d29f1df280c2"
+
 [[package]]
 name = "cosmwasm-crypto"
-version = "1.5.3"
+version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9934c79e58d9676edfd592557dee765d2a6ef54c09d5aa2edb06156b00148966"
+checksum = "e6b4c3f9c4616d6413d4b5fc4c270a4cc32a374b9be08671e80e1a019f805d8f"
 dependencies = [
  "digest 0.10.7",
  "ecdsa",
@@ -134,18 +168,18 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-derive"
-version = "1.5.3"
+version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc5e72e330bd3bdab11c52b5ecbdeb6a8697a004c57964caeb5d876f0b088b3c"
+checksum = "c586ced10c3b00e809ee664a895025a024f60d65d34fe4c09daed4a4db68a3f3"
 dependencies = [
  "syn 1.0.109",
 ]
 
 [[package]]
 name = "cosmwasm-schema"
-version = "1.5.3"
+version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ac3e3a2136e2a60e8b6582f5dffca5d1a683ed77bf38537d330bc1dfccd69010"
+checksum = "8467874827d384c131955ff6f4d47d02e72a956a08eb3c0ff24f8c903a5517b4"
 dependencies = [
  "cosmwasm-schema-derive",
  "schemars",
@@ -156,9 +190,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-schema-derive"
-version = "1.5.3"
+version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f5d803bea6bd9ed61bd1ee0b4a2eb09ee20dbb539cc6e0b8795614d20952ebb1"
+checksum = "f6db85d98ac80922aef465e564d5b21fa9cfac5058cb62df7f116c3682337393"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -167,11 +201,11 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-std"
-version = "1.5.3"
+version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ef8666e572a3a2519010dde88c04d16e9339ae751b56b2bb35081fe3f7d6be74"
+checksum = "712fe58f39d55c812f7b2c84e097cdede3a39d520f89b6dc3153837e31741927"
 dependencies = [
- "base64 0.21.6",
+ "base64",
  "bech32",
  "bnum",
  "cosmwasm-crypto",
@@ -251,9 +285,9 @@ dependencies = [
 
 [[package]]
 name = "der"
-version = "0.7.8"
+version = "0.7.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fffa369a668c8af7dbf8b5e56c9f744fbd399949ed171606040001947de40b1c"
+checksum = "f55bf8e7b65898637379c1b74eb1551107c8294ed26d855ceb9fd1a09cfc9bc0"
 dependencies = [
  "const-oid",
  "zeroize",
@@ -319,14 +353,14 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "dyn-clone"
-version = "1.0.16"
+version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "545b22097d44f8a9581187cdf93de7a71e4722bf51200cfaba810865b49a495d"
+checksum = "0d6ef0072f8a535281e4876be788938b528e9a1d43900b82c2569af7da799125"
 
 [[package]]
 name = "ecdsa"
@@ -369,9 +403,9 @@ dependencies = [
 
 [[package]]
 name = "either"
-version = "1.9.0"
+version = "1.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
+checksum = "a47c1c47d2f5964e29c61246e81db715514cd532db6b5116a25ea3c03d6780a2"
 
 [[package]]
 name = "elliptic-curve"
@@ -400,9 +434,9 @@ checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
 [[package]]
 name = "eyre"
-version = "0.6.11"
+version = "0.6.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6267a1fa6f59179ea4afc8e50fd8612a3cc60bc858f786ff877a4a8cb042799"
+checksum = "7cd915d99f24784cdc19fd37ef22b97e3ff0ae756c7e492e9fbfe897d61e2aec"
 dependencies = [
  "indenter",
  "once_cell",
@@ -517,9 +551,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.12"
+version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
+checksum = "94b22e06ecb0110981051723910cbf0b5f5e09a2062dd7663334ee79a9d1286c"
 dependencies = [
  "cfg-if",
  "libc",
@@ -841,7 +875,7 @@ version = "0.6.1"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -866,11 +900,11 @@ version = "0.42.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c1a6f2bbf7e1d12f98d8d54d9114231b865418d0f8b619c0873180eafdee07fd"
 dependencies = [
- "base64 0.21.6",
+ "base64",
  "bytes",
  "flex-error",
  "ics23",
- "informalsystems-pbjson 0.7.0",
+ "informalsystems-pbjson",
  "parity-scale-codec",
  "prost",
  "scale-info",
@@ -882,14 +916,16 @@ dependencies = [
 
 [[package]]
 name = "ics23"
-version = "0.11.0"
+version = "0.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "661e2d6f79952a65bc92b1c81f639ebd37228dae6ff412a5aba7d474bdc4b957"
+checksum = "dc3b8be84e7285c73b88effdc3294b552277d6b0ec728ee016c861b7b9a2c19c"
 dependencies = [
  "anyhow",
+ "blake2",
+ "blake3",
  "bytes",
  "hex",
- "informalsystems-pbjson 0.6.0",
+ "informalsystems-pbjson",
  "prost",
  "ripemd",
  "serde",
@@ -925,48 +961,38 @@ checksum = "ce23b50ad8242c51a442f3ff322d56b02f08852c77e4c0b4d3fd684abc89c683"
 
 [[package]]
 name = "indexmap"
-version = "2.1.0"
+version = "2.2.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d530e1a18b1cb4c484e6e34556a0d948706958449fca0cab753d649f2bce3d1f"
+checksum = "168fb715dda47215e360912c096649d23d58bf392ac62f73919e831745e40f26"
 dependencies = [
  "equivalent",
  "hashbrown 0.14.3",
 ]
 
-[[package]]
-name = "informalsystems-pbjson"
-version = "0.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4eecd90f87bea412eac91c6ef94f6b1e390128290898cbe14f2b926787ae1fb"
-dependencies = [
- "base64 0.13.1",
- "serde",
-]
-
 [[package]]
 name = "informalsystems-pbjson"
 version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
 dependencies = [
- "base64 0.21.6",
+ "base64",
  "serde",
 ]
 
 [[package]]
 name = "itertools"
-version = "0.11.0"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57"
+checksum = "ba291022dbbd398a455acf126c1e341954079855bc60dfdda641363bd6922569"
 dependencies = [
  "either",
 ]
 
 [[package]]
 name = "itoa"
-version = "1.0.10"
+version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
+checksum = "49f1f14873335454500d59611f1cf4a4b0f786f9ac11f4312a78e4cf2566695b"
 
 [[package]]
 name = "k256"
@@ -984,24 +1010,30 @@ dependencies = [
 
 [[package]]
 name = "keccak"
-version = "0.1.4"
+version = "0.1.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f6d5ed8676d904364de097082f4e7d240b571b67989ced0240f08b7f966f940"
+checksum = "ecc2af9a1119c51f12a14607e783cb977bde58bc069ff0c3da1095e635d70654"
 dependencies = [
  "cpufeatures",
 ]
 
 [[package]]
 name = "libc"
-version = "0.2.152"
+version = "0.2.153"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "13e3bf6590cbc649f4d1a3eefc9d5d6eb746f5200ffb04e5e142700b8faa56e7"
+checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd"
 
 [[package]]
 name = "memchr"
-version = "2.7.1"
+version = "2.7.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6c8640c5d730cb13ebd907d8d04b52f55ac9a2eec55b440c8892f40d56c76c1d"
+
+[[package]]
+name = "num-conv"
+version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "523dc4f511e55ab87b694dc30d0f820d60906ef06413f93d4d7a1385599cc149"
+checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
 [[package]]
 name = "num-derive"
@@ -1016,9 +1048,9 @@ dependencies = [
 
 [[package]]
 name = "num-traits"
-version = "0.2.17"
+version = "0.2.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c"
+checksum = "da0df0e5185db44f69b44f26786fe401b6c293d1907744beaa7fa62b2e5a517a"
 dependencies = [
  "autocfg",
 ]
@@ -1031,9 +1063,9 @@ checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
 
 [[package]]
 name = "opaque-debug"
-version = "0.3.0"
+version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
+checksum = "c08d65885ee38876c4f86fa503fb49d7b507c2b62552df7c70b2fce627e06381"
 
 [[package]]
 name = "parity-scale-codec"
@@ -1053,7 +1085,7 @@ version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
 dependencies = [
- "proc-macro-crate 2.0.1",
+ "proc-macro-crate 2.0.2",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1067,9 +1099,9 @@ checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
 
 [[package]]
 name = "pin-project-lite"
-version = "0.2.13"
+version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8afb450f006bf6385ca15ef45d71d2288452bc3683ce2e2cacc0d18e4be60b58"
+checksum = "bda66fc9667c18cb2758a2ac84d1167245054bcf85d5d1aaa6923f45801bdd02"
 
 [[package]]
 name = "pin-utils"
@@ -1116,9 +1148,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro-crate"
-version = "2.0.1"
+version = "2.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "97dc5fea232fc28d2f597b37c4876b348a40e33f3b02cc975c8d006d78d94b1a"
+checksum = "b00f26d3400549137f92511a46ac1cd8ce37cb5598a96d382381458b992a5d24"
 dependencies = [
  "toml_datetime",
  "toml_edit 0.20.2",
@@ -1126,18 +1158,18 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.76"
+version = "1.0.81"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "95fc56cda0b5c3325f5fbbd7ff9fda9e02bb00bb3dac51252d2f1bfa1cb8cc8c"
+checksum = "3d1597b0c024618f09a9c3b8655b7e430397a36d23fdafec26d6965e9eec3eba"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "prost"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "146c289cda302b98a28d40c8b3b90498d6e526dd24ac2ecea73e4e491685b94a"
+checksum = "d0f5d036824e4761737860779c906171497f6d55681139d8312388f8fe398922"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -1145,31 +1177,31 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efb6c9a1dd1def8e2124d17e83a20af56f1570d6c2d2bd9e266ccb768df3840e"
+checksum = "19de2de2a00075bf566bee3bd4db014b11587e84184d3f7a791bc17f1a8e9e48"
 dependencies = [
  "anyhow",
  "itertools",
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "prost-types"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "193898f59edcf43c26227dcd4c8427f00d99d61e95dcde58dabd49fa291d470e"
+checksum = "3235c33eb02c1f1e212abdbe34c78b264b038fb58ca612664343271e36e55ffe"
 dependencies = [
  "prost",
 ]
 
 [[package]]
 name = "quote"
-version = "1.0.35"
+version = "1.0.36"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "291ec9ab5efd934aaf503a6466c5d5251535d108ee747472c3977cc5acc868ef"
+checksum = "0fa76aaf39101c457836aec0ce2316dbdc3ab723cdda1c6bd4e6ad4208acaca7"
 dependencies = [
  "proc-macro2",
 ]
@@ -1210,15 +1242,15 @@ dependencies = [
 
 [[package]]
 name = "ryu"
-version = "1.0.16"
+version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f98d2aa92eebf49b69786be48e4477826b256916e84a57ff2a4f21923b48eb4c"
+checksum = "e86697c916019a8588c99b5fac3cead74ec0b4b819707a682fd4d23fa0ce1ba1"
 
 [[package]]
 name = "scale-info"
-version = "2.10.0"
+version = "2.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f7d66a1128282b7ef025a8ead62a4a9fcf017382ec53b8ffbf4d7bf77bd3c60"
+checksum = "7c453e59a955f81fb62ee5d596b450383d699f152d350e9d23a0db2adb78e4c0"
 dependencies = [
  "cfg-if",
  "derive_more",
@@ -1228,9 +1260,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.10.0"
+version = "2.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "abf2c68b89cafb3b8d918dd07b42be0da66ff202cf1155c5739a4e0c1ea0dc19"
+checksum = "18cf6c6447f813ef19eb450e985bcce6705f9ce7660db221b59093d15c79c4b7"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -1278,9 +1310,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.195"
+version = "1.0.198"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63261df402c67811e9ac6def069e4786148c4563f4b50fd4bf30aa370d626b02"
+checksum = "9846a40c979031340571da2545a4e5b7c4163bdae79b301d5f86d03979451fcc"
 dependencies = [
  "serde_derive",
 ]
@@ -1314,13 +1346,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.195"
+version = "1.0.198"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46fe8f8603d81ba86327b23a2e9cdf49e1255fb94a4c5f297f6ee0547178ea2c"
+checksum = "e88edab869b01783ba905e7d0153f9fc1a6505a96e4ad3018011eedb838566d9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1336,9 +1368,9 @@ dependencies = [
 
 [[package]]
 name = "serde_json"
-version = "1.0.111"
+version = "1.0.116"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "176e46fa42316f18edd598015a5166857fc835ec732f5215eac6b7bdbf0a84f4"
+checksum = "3e17db7126d17feb94eb3fad46bf1a96b034e8aacbc2e775fe81505f8b0b2813"
 dependencies = [
  "itoa",
  "ryu",
@@ -1347,13 +1379,13 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.18"
+version = "0.1.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b2e6b945e9d3df726b65d6ee24060aff8e3533d431f677a9695db04eff9dfdb"
+checksum = "6c64451ba24fc7a6a2d60fc75dd9c83c90903b19028d4eff35e88fc1e86564e9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1444,9 +1476,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.48"
+version = "2.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0f3531638e407dfc0814761abb7c00a5b54992b849452a0646b7f65c9f770f3f"
+checksum = "909518bc7b1c9b779f1bbf07f2929d35af9f0f37e47c6e9ef7f9dddc1e1821f3"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1455,9 +1487,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint"
-version = "0.34.0"
+version = "0.34.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc2294fa667c8b548ee27a9ba59115472d0a09c2ba255771092a7f1dcf03a789"
+checksum = "15ab8f0a25d0d2ad49ac615da054d6a76aa6603ff95f7d18bafdd34450a1a04b"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -1482,9 +1514,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.34.0"
+version = "0.34.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2cc728a4f9e891d71adf66af6ecaece146f9c7a11312288a3107b3e1d6979aaf"
+checksum = "b797dd3d2beaaee91d2f065e7bdf239dc8d80bba4a183a288bc1279dd5a69a1e"
 dependencies = [
  "bytes",
  "flex-error",
@@ -1500,31 +1532,32 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.56"
+version = "1.0.59"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d54378c645627613241d077a3a79db965db602882668f9136ac42af9ecb730ad"
+checksum = "f0126ad08bff79f29fc3ae6a55cc72352056dfff61e3ff8bb7129476d44b23aa"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.56"
+version = "1.0.59"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa0faa943b50f3db30a20aa7e265dbc66076993efed8463e8de414e5d06d3471"
+checksum = "d1cd413b5d558b4c5bf3680e324a6fa5014e7b7c067a51e69dbdf47eb7148b66"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "time"
-version = "0.3.31"
+version = "0.3.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f657ba42c3f86e7680e53c8cd3af8abbe56b5491790b46e22e19c0d57463583e"
+checksum = "c8248b6521bb14bc45b4067159b9b6ad792e2d6d754d6c41fb50e29fefe38749"
 dependencies = [
  "deranged",
+ "num-conv",
  "powerfmt",
  "serde",
  "time-core",
@@ -1539,10 +1572,11 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.16"
+version = "0.2.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26197e33420244aeb70c3e8c78376ca46571bc4e701e4791c2cd9f57dcb3a43f"
+checksum = "7ba3a3ef41e6672a2f0f001392bb5dcd3ff0a9992d618ca761a11c3121547774"
 dependencies = [
+ "num-conv",
  "time-core",
 ]
 
@@ -1612,9 +1646,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "winnow"
-version = "0.5.33"
+version = "0.5.40"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7520bbdec7211caa7c4e682eb1fbe07abe20cee6756b6e00f537c82c11816aa"
+checksum = "f593a95398737aeed53e489c785df13f3618e41dbcd6718c6addbf1395aa6876"
 dependencies = [
  "memchr",
 ]
@@ -1636,5 +1670,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 5b24d0e3c..86af97be6 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -9,8 +9,8 @@ crate-type = ["cdylib", "rlib"]
 [dependencies]
 ibc-apps = { path = "../../ibc-apps", default_features = false, features = ["serde", "parity-scale-codec"] }
 ibc-core = { path = "../../ibc-core", features = ["serde", "parity-scale-codec", "schema"] }
-cosmwasm-std = { version = "^1.5.3", default-features = false }
-cosmwasm-schema = { version = "^1.5.3", default-features = false }
+cosmwasm-std = { version = "1.5.4", default-features = false }
+cosmwasm-schema = { version = "1.5.4", default-features = false }
 serde_json =  { package = "serde-json-wasm", version = "^1.0.1", default-features = false }
 thiserror = { version = "^1.0", default-features = false }
 
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index b2c10bc28..0632fefdd 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -43,14 +43,14 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d122413f284cf2d62fb1b7db97e02edb8cda96d769b16e443a4f6195e35662b0"
 dependencies = [
  "crypto-common",
- "generic-array 0.14.7",
+ "generic-array",
 ]
 
 [[package]]
 name = "ahash"
-version = "0.7.7"
+version = "0.7.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5a824f2aa7e75a0c98c5a504fceb80649e9c35265d44525b5f94de4771a395cd"
+checksum = "891477e0c6a8957309ee5c45a6368af3ae14bb510732d2684ffa19af310920f9"
 dependencies = [
  "getrandom",
  "once_cell",
@@ -59,9 +59,9 @@ dependencies = [
 
 [[package]]
 name = "ahash"
-version = "0.8.7"
+version = "0.8.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77c3a9648d43b9cd48db467b3f87fdd6e146bcc88ab0180006cef2179fe11d01"
+checksum = "e89da841a80418a9b391ebaea17f5c112ffaaa96f621d2c285b5174da76b9011"
 dependencies = [
  "cfg-if",
  "getrandom",
@@ -72,9 +72,9 @@ dependencies = [
 
 [[package]]
 name = "aho-corasick"
-version = "1.1.2"
+version = "1.1.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b2969dcb958b36655471fc61f7e416fa76033bdd4bfed0678d8fee1e2d07a1f0"
+checksum = "8e60d3430d3a69478ad0993f19238d2df97c507009a52b3c10addcd7f6bcb916"
 dependencies = [
  "memchr",
 ]
@@ -105,9 +105,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.79"
+version = "1.0.82"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "080e9890a082662b09c1ad45f567faeeb47f22b5fb23895fbe1e651e718e25ca"
+checksum = "f538837af36e6f6a9be0faa67f9a314f8119e4e4b5867c6ab40ed60360142519"
 
 [[package]]
 name = "ark-bls12-377"
@@ -250,12 +250,6 @@ version = "0.3.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6b4930d2cb77ce62f89ee5d5289b4ac049559b1c45539271f5ed4fdc7db34545"
 
-[[package]]
-name = "arrayvec"
-version = "0.5.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "23b62fc65de8e4e7f52534fb52b0f3ed04746ae267519eef2a83941e8085068b"
-
 [[package]]
 name = "arrayvec"
 version = "0.7.4"
@@ -264,15 +258,15 @@ checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "autocfg"
-version = "1.1.0"
+version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d468802bab17cbc0cc575e9b053f41e72aa36bfa6b7f55e3529ffa43161b97fa"
+checksum = "f1fdabc7756949593fe60f30ec81974b613357de856987752631dea1e3394c80"
 
 [[package]]
 name = "backtrace"
-version = "0.3.69"
+version = "0.3.71"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2089b7e3f35b9dd2d0ed921ead4f6d318c27680d4a5bd167b3ee120edb105837"
+checksum = "26b05800d2e817c8b3b4b54abd461726265fa9789ae34330622f2db9ee696f9d"
 dependencies = [
  "addr2line 0.21.0",
  "cc",
@@ -337,9 +331,9 @@ checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
 [[package]]
 name = "bitflags"
-version = "2.4.2"
+version = "2.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed570934406eb16438a4e976b1b4500774099c13b8cb96eec99f620f05090ddf"
+checksum = "cf4b9d6a944f767f8e5e0db018570623c85f3d925ac718db4e06d0187adb21c1"
 
 [[package]]
 name = "bitvec"
@@ -369,20 +363,21 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "23285ad32269793932e830392f2fe2f83e26488fd3ec778883a93c8323735780"
 dependencies = [
  "arrayref",
- "arrayvec 0.7.4",
+ "arrayvec",
  "constant_time_eq",
 ]
 
 [[package]]
-name = "block-buffer"
-version = "0.7.3"
+name = "blake3"
+version = "1.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c0940dc441f31689269e10ac70eb1002a3a1d3ad1390e030043662eb7fe4688b"
+checksum = "30cca6d3674597c30ddf2c587bf8d9d65c9a84d2326d941cc79c9842dfe0ef52"
 dependencies = [
- "block-padding",
- "byte-tools",
- "byteorder",
- "generic-array 0.12.4",
+ "arrayref",
+ "arrayvec",
+ "cc",
+ "cfg-if",
+ "constant_time_eq",
 ]
 
 [[package]]
@@ -391,7 +386,7 @@ version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4152116fd6e9dadb291ae18fc1ec3575ed6d84c29642d97890f4b4a3417297e4"
 dependencies = [
- "generic-array 0.14.7",
+ "generic-array",
 ]
 
 [[package]]
@@ -400,16 +395,7 @@ version = "0.10.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
 dependencies = [
- "generic-array 0.14.7",
-]
-
-[[package]]
-name = "block-padding"
-version = "0.1.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa79dedbb091f449f1f39e53edf88d5dbe95f895dae6135a8d7b881fb5af73f5"
-dependencies = [
- "byte-tools",
+ "generic-array",
 ]
 
 [[package]]
@@ -471,18 +457,18 @@ dependencies = [
 
 [[package]]
 name = "bs58"
-version = "0.5.0"
+version = "0.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f5353f36341f7451062466f0b755b96ac3a9547e4d7f6b70d603fc721a7d7896"
+checksum = "bf88ba1141d185c399bee5288d850d63b8369520c1eafc32a0430b5b6c287bf4"
 dependencies = [
  "tinyvec",
 ]
 
 [[package]]
 name = "bumpalo"
-version = "3.14.0"
+version = "3.16.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f30e7476521f6f8af1a1c4c0b8cc94f0bee37d91763d0ca2665f299b6cd8aec"
+checksum = "79296716171880943b8470b5f8d03aa55eb2e645a4874bdbb28adb49162e012c"
 
 [[package]]
 name = "byte-slice-cast"
@@ -490,12 +476,6 @@ version = "1.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c3ac9f8b63eca6fd385229b3675f6cc0dc5c8a5c8a54a59d4f52ffd670d87b0c"
 
-[[package]]
-name = "byte-tools"
-version = "0.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3b5ca7a04898ad4bcd41c90c5285445ff5b791899bb1b0abdd2a2aa791211d7"
-
 [[package]]
 name = "byteorder"
 version = "1.5.0"
@@ -504,21 +484,18 @@ checksum = "1fd0f2584146f6f2ef48085050886acf353beff7305ebd1ae69500e27c67f64b"
 
 [[package]]
 name = "bytes"
-version = "1.5.0"
+version = "1.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a2bd12c1caf447e69cd4528f47f94d203fd2582878ecb9e9465484c4148a8223"
+checksum = "514de17de45fdb8dc022b1a7975556c53c86f9f0aa5f534b98977b171857c2c9"
 dependencies = [
  "serde",
 ]
 
 [[package]]
 name = "cc"
-version = "1.0.83"
+version = "1.0.95"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1174fb0b6ec23863f8b971027804a42614e347eafb0a95bf0b12cdae21fc4d0"
-dependencies = [
- "libc",
-]
+checksum = "d32a725bc159af97c3e629873bb9f88fb8cf8a4867175f76dc987815ea07c83b"
 
 [[package]]
 name = "cfg-if"
@@ -528,14 +505,14 @@ checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
 
 [[package]]
 name = "chrono"
-version = "0.4.32"
+version = "0.4.38"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "41daef31d7a747c5c847246f36de49ced6f7403b4cdabc807a97b5cc184cda7a"
+checksum = "a21f936df1771bf62b77f047b726c4625ff2e8aa607c01ec06e5a05bd8463401"
 dependencies = [
  "android-tzdata",
  "iana-time-zone",
  "num-traits",
- "windows-targets 0.52.0",
+ "windows-targets 0.52.5",
 ]
 
 [[package]]
@@ -597,9 +574,9 @@ dependencies = [
 
 [[package]]
 name = "crc32fast"
-version = "1.3.2"
+version = "1.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b540bd8bc810d3885c6ea91e2018302f68baba2129ab3e88f32389ee9370880d"
+checksum = "b3855a8a784b474f333699ef2bbca9db2c4a1f6d9088a90a2d25b1eb53111eaa"
 dependencies = [
  "cfg-if",
 ]
@@ -616,7 +593,7 @@ version = "0.1.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
 dependencies = [
- "generic-array 0.14.7",
+ "generic-array",
  "rand_core 0.6.4",
  "typenum",
 ]
@@ -627,31 +604,18 @@ version = "0.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b584a330336237c1eecd3e94266efb216c56ed91225d634cb2991c5f3fd1aeab"
 dependencies = [
- "generic-array 0.14.7",
+ "generic-array",
  "subtle",
 ]
 
 [[package]]
 name = "crypto-mac"
-version = "0.11.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1d1a86f49236c215f271d40892d5fc950490551400b02ef360692c29815c714"
-dependencies = [
- "generic-array 0.14.7",
- "subtle",
-]
-
-[[package]]
-name = "curve25519-dalek"
-version = "2.1.3"
+version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4a9b85542f99a2dfa2a1b8e192662741c9859a846b296bef1c92ef9b58b5a216"
+checksum = "25fab6889090c8133f3deb8f73ba3c65a7f456f66436fc012a1b1e272b1e103e"
 dependencies = [
- "byteorder",
- "digest 0.8.1",
- "rand_core 0.5.1",
+ "generic-array",
  "subtle",
- "zeroize",
 ]
 
 [[package]]
@@ -669,9 +633,9 @@ dependencies = [
 
 [[package]]
 name = "curve25519-dalek"
-version = "4.1.1"
+version = "4.1.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e89b8c6a2e4b1f45971ad09761aafb85514a84744b67a95e32c3cc1352d1f65c"
+checksum = "0a677b8922c94e01bdbb12126b0bc852f00447528dee1782229af9c720c3f348"
 dependencies = [
  "cfg-if",
  "cpufeatures",
@@ -692,7 +656,7 @@ checksum = "f46882e17999c6cc590af592290432be3bce0428cb0d5f8b6715e4dc7b383eb3"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -710,9 +674,9 @@ dependencies = [
 
 [[package]]
 name = "der"
-version = "0.7.8"
+version = "0.7.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fffa369a668c8af7dbf8b5e56c9f744fbd399949ed171606040001947de40b1c"
+checksum = "f55bf8e7b65898637379c1b74eb1551107c8294ed26d855ceb9fd1a09cfc9bc0"
 dependencies = [
  "const-oid",
  "zeroize",
@@ -740,13 +704,13 @@ dependencies = [
 
 [[package]]
 name = "derive-syn-parse"
-version = "0.1.5"
+version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e79116f119dd1dba1abf1f3405f03b9b0e79a27a3883864bfebded8a3dc768cd"
+checksum = "d65d7ce8132b7c0e54497a4d9a55a1c2a0912a0d786cf894472ba818fba45762"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -760,22 +724,13 @@ dependencies = [
  "syn 1.0.109",
 ]
 
-[[package]]
-name = "digest"
-version = "0.8.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f3d0c8c8752312f9713efd397ff63acb9f85585afbf179282e720e7704954dd5"
-dependencies = [
- "generic-array 0.12.4",
-]
-
 [[package]]
 name = "digest"
 version = "0.9.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d3dd60d1080a57a05ab032377049e0591415d2b31afd7028356dbf3cc6dcb066"
 dependencies = [
- "generic-array 0.14.7",
+ "generic-array",
 ]
 
 [[package]]
@@ -797,23 +752,23 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "docify"
-version = "0.2.7"
+version = "0.2.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7cc4fd38aaa9fb98ac70794c82a00360d1e165a87fbf96a8a91f9dfc602aaee2"
+checksum = "43a2f138ad521dc4a2ced1a4576148a6a610b4c5923933b062a263130a6802ce"
 dependencies = [
  "docify_macros",
 ]
 
 [[package]]
 name = "docify_macros"
-version = "0.2.7"
+version = "0.2.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63fa215f3a0d40fb2a221b3aa90d8e1fbb8379785a990cb60d62ac71ebdc6460"
+checksum = "1a081e51fb188742f5a7a1164ad752121abcb22874b21e2c3b0dd040c515fdad"
 dependencies = [
  "common-path",
  "derive-syn-parse",
@@ -821,9 +776,9 @@ dependencies = [
  "proc-macro2",
  "quote",
  "regex",
- "syn 2.0.48",
+ "syn 2.0.60",
  "termcolor",
- "toml 0.8.2",
+ "toml 0.8.12",
  "walkdir",
 ]
 
@@ -850,9 +805,9 @@ dependencies = [
 
 [[package]]
 name = "dyn-clone"
-version = "1.0.16"
+version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "545b22097d44f8a9581187cdf93de7a71e4722bf51200cfaba810865b49a495d"
+checksum = "0d6ef0072f8a535281e4876be788938b528e9a1d43900b82c2569af7da799125"
 
 [[package]]
 name = "ed25519"
@@ -879,11 +834,11 @@ dependencies = [
 
 [[package]]
 name = "ed25519-dalek"
-version = "2.1.0"
+version = "2.1.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1f628eaec48bfd21b865dc2950cfa014450c01d2fa2b69a86c2fd5844ec523c0"
+checksum = "4a3daa8e81a3963a60642bcc1f90a670680bd4a77535faa384e9d1c79d620871"
 dependencies = [
- "curve25519-dalek 4.1.1",
+ "curve25519-dalek 4.1.2",
  "ed25519",
  "serde",
  "sha2 0.10.8",
@@ -907,9 +862,9 @@ dependencies = [
 
 [[package]]
 name = "either"
-version = "1.9.0"
+version = "1.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a26ae43d7bcc3b814de94796a5e736d4029efb0ee900c12e2d54c993ad1a1e07"
+checksum = "a47c1c47d2f5964e29c61246e81db715514cd532db6b5116a25ea3c03d6780a2"
 
 [[package]]
 name = "environmental"
@@ -935,23 +890,18 @@ dependencies = [
 
 [[package]]
 name = "expander"
-version = "2.0.0"
+version = "2.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5f86a749cf851891866c10515ef6c299b5c69661465e9c3bbe7e07a2b77fb0f7"
+checksum = "00e83c02035136f1592a47964ea60c05a50e4ed8b5892cfac197063850898d4d"
 dependencies = [
  "blake2",
  "fs-err",
+ "prettier-please",
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
-[[package]]
-name = "fake-simd"
-version = "0.1.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e88a8acf291dafb59c2d96e8f59828f3838bb1a70398823ade51a84de6a6deed"
-
 [[package]]
 name = "fallible-iterator"
 version = "0.2.0"
@@ -960,9 +910,9 @@ checksum = "4443176a9f2c162692bd3d352d745ef9413eec5782a80d8fd6f8a1ac692a07f7"
 
 [[package]]
 name = "fiat-crypto"
-version = "0.2.5"
+version = "0.2.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "27573eac26f4dd11e2b1916c3fe1baa56407c83c71a773a8ba17ec0bca03b6b7"
+checksum = "38793c55593b33412e3ae40c2c9781ffaa6f438f6f8c10f24e71846fbd7ae01e"
 
 [[package]]
 name = "fixed-hash"
@@ -1066,7 +1016,7 @@ checksum = "87750cf4b7a4c0625b1529e4c543c2182106e4dedc60a2a6455e00d212c489ac"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1099,15 +1049,6 @@ dependencies = [
  "slab",
 ]
 
-[[package]]
-name = "generic-array"
-version = "0.12.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ffdf9f34f1447443d37393cc6c2b8313aebddcd96906caf34e54c68d8e57d7bd"
-dependencies = [
- "typenum",
-]
-
 [[package]]
 name = "generic-array"
 version = "0.14.7"
@@ -1120,9 +1061,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.12"
+version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "190092ea657667030ac6a35e305e62fc4dd69fd98ac98631e5d3a2b1575a12b5"
+checksum = "94b22e06ecb0110981051723910cbf0b5f5e09a2062dd7663334ee79a9d1286c"
 dependencies = [
  "cfg-if",
  "libc",
@@ -1177,7 +1118,7 @@ version = "0.12.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8a9ee70c43aaf417c914396645a0fa852624801b24ebb7ae78fe8272889ac888"
 dependencies = [
- "ahash 0.7.7",
+ "ahash 0.7.8",
 ]
 
 [[package]]
@@ -1186,7 +1127,7 @@ version = "0.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "43a3c133739dddd0d2990f9a4bdf8eb4b21ef50e4851ca85ab661199821d510e"
 dependencies = [
- "ahash 0.8.7",
+ "ahash 0.8.11",
 ]
 
 [[package]]
@@ -1197,9 +1138,9 @@ checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
 
 [[package]]
 name = "hermit-abi"
-version = "0.3.4"
+version = "0.3.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5d3d0e0f38255e7fa3cf31335b3a56f05febd18025f4db5ef7a0cfb4f8da651f"
+checksum = "d231dfb89cfffdbc30e7fc41579ed6066ad03abda9e567ccafae602b97ec5024"
 
 [[package]]
 name = "hex"
@@ -1223,7 +1164,7 @@ version = "0.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2a2a2320eb7ec0ebe8da8f744d7812d9fc4cb4d09344ac01898dbcb6a20ae69b"
 dependencies = [
- "crypto-mac 0.11.1",
+ "crypto-mac 0.11.0",
  "digest 0.9.0",
 ]
 
@@ -1234,15 +1175,15 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "17ea0a1394df5b6574da6e0c1ade9e78868c9fb0a4e5ef4428e32da4676b85b1"
 dependencies = [
  "digest 0.9.0",
- "generic-array 0.14.7",
+ "generic-array",
  "hmac 0.8.1",
 ]
 
 [[package]]
 name = "iana-time-zone"
-version = "0.1.59"
+version = "0.1.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6a67363e2aa4443928ce15e57ebae94fd8949958fd1223c4cfc0cd473ad7539"
+checksum = "e7ffbb5a1b541ea2561f8c41c087286cc091e21e556a4f09a8f6cbf17b69b141"
 dependencies = [
  "android_system_properties",
  "core-foundation-sys",
@@ -1595,11 +1536,11 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.6.0"
+version = "0.6.1"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1626,7 +1567,7 @@ dependencies = [
  "bytes",
  "flex-error",
  "ics23",
- "informalsystems-pbjson 0.7.0",
+ "informalsystems-pbjson",
  "parity-scale-codec",
  "prost",
  "scale-info",
@@ -1637,14 +1578,16 @@ dependencies = [
 
 [[package]]
 name = "ics23"
-version = "0.11.0"
+version = "0.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "661e2d6f79952a65bc92b1c81f639ebd37228dae6ff412a5aba7d474bdc4b957"
+checksum = "dc3b8be84e7285c73b88effdc3294b552277d6b0ec728ee016c861b7b9a2c19c"
 dependencies = [
  "anyhow",
+ "blake2",
+ "blake3",
  "bytes",
  "hex",
- "informalsystems-pbjson 0.6.0",
+ "informalsystems-pbjson",
  "prost",
  "ripemd",
  "serde",
@@ -1704,24 +1647,14 @@ dependencies = [
 
 [[package]]
 name = "indexmap"
-version = "2.1.0"
+version = "2.2.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d530e1a18b1cb4c484e6e34556a0d948706958449fca0cab753d649f2bce3d1f"
+checksum = "168fb715dda47215e360912c096649d23d58bf392ac62f73919e831745e40f26"
 dependencies = [
  "equivalent",
  "hashbrown 0.14.3",
 ]
 
-[[package]]
-name = "informalsystems-pbjson"
-version = "0.6.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b4eecd90f87bea412eac91c6ef94f6b1e390128290898cbe14f2b926787ae1fb"
-dependencies = [
- "base64 0.13.1",
- "serde",
-]
-
 [[package]]
 name = "informalsystems-pbjson"
 version = "0.7.0"
@@ -1763,24 +1696,24 @@ dependencies = [
 
 [[package]]
 name = "itertools"
-version = "0.11.0"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1c173a5686ce8bfa551b3563d0c2170bf24ca44da99c7ca4bfdab5418c3fe57"
+checksum = "ba291022dbbd398a455acf126c1e341954079855bc60dfdda641363bd6922569"
 dependencies = [
  "either",
 ]
 
 [[package]]
 name = "itoa"
-version = "1.0.10"
+version = "1.0.11"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1a46d1a171d865aa5f83f92695765caa047a9b4cbae2cbf37dbd613a793fd4c"
+checksum = "49f1f14873335454500d59611f1cf4a4b0f786f9ac11f4312a78e4cf2566695b"
 
 [[package]]
 name = "js-sys"
-version = "0.3.67"
+version = "0.3.69"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9a1d36f1235bc969acba30b7f5990b864423a6068a10f7c90ae8f0112e3a59d1"
+checksum = "29c15563dc2726973df627357ce0c9ddddbea194836909d655df6a75d2cf296d"
 dependencies = [
  "wasm-bindgen",
 ]
@@ -1802,9 +1735,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.152"
+version = "0.2.153"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "13e3bf6590cbc649f4d1a3eefc9d5d6eb746f5200ffb04e5e142700b8faa56e7"
+checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd"
 
 [[package]]
 name = "libsecp256k1"
@@ -1878,9 +1811,9 @@ dependencies = [
 
 [[package]]
 name = "log"
-version = "0.4.20"
+version = "0.4.21"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b5e6163cb8c49088c2c36f57875e58ccd8c87c7427f7fbd50ea6710b2f3f2e8f"
+checksum = "90ed8c1e510134f979dbc4f070f87d4313098b704861a105fe34231c70a3901c"
 
 [[package]]
 name = "mach"
@@ -1902,9 +1835,9 @@ dependencies = [
 
 [[package]]
 name = "memchr"
-version = "2.7.1"
+version = "2.7.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "523dc4f511e55ab87b694dc30d0f820d60906ef06413f93d4d7a1385599cc149"
+checksum = "6c8640c5d730cb13ebd907d8d04b52f55ac9a2eec55b440c8892f40d56c76c1d"
 
 [[package]]
 name = "memfd"
@@ -1912,7 +1845,7 @@ version = "0.6.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
 dependencies = [
- "rustix 0.38.30",
+ "rustix 0.38.34",
 ]
 
 [[package]]
@@ -1933,18 +1866,6 @@ dependencies = [
  "hash-db",
 ]
 
-[[package]]
-name = "merlin"
-version = "2.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4e261cf0f8b3c42ded9f7d2bb59dea03aa52bc8a1cbc7482f9fc3fd1229d3b42"
-dependencies = [
- "byteorder",
- "keccak",
- "rand_core 0.5.1",
- "zeroize",
-]
-
 [[package]]
 name = "merlin"
 version = "3.0.0"
@@ -1959,9 +1880,9 @@ dependencies = [
 
 [[package]]
 name = "miniz_oxide"
-version = "0.7.1"
+version = "0.7.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e7810e0be55b428ada41041c41f32c9f1a42817901b4ccf45fa3d4b6561e74c7"
+checksum = "9d811f3e15f28568be3407c8e7fdb6514c1cda3cb30683f15b6a1a1dc4ea14a7"
 dependencies = [
  "adler",
 ]
@@ -1976,7 +1897,7 @@ dependencies = [
  "sp-io",
  "sp-runtime",
  "sp-std",
- "syn 2.0.48",
+ "syn 2.0.60",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1999,6 +1920,12 @@ dependencies = [
  "num-traits",
 ]
 
+[[package]]
+name = "num-conv"
+version = "0.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
+
 [[package]]
 name = "num-derive"
 version = "0.3.3"
@@ -2016,25 +1943,24 @@ version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a652d9771a63711fd3c3deb670acfbe5c30a4072e664d7a3bf5a9e1056ac72c3"
 dependencies = [
- "arrayvec 0.7.4",
+ "arrayvec",
  "itoa",
 ]
 
 [[package]]
 name = "num-integer"
-version = "0.1.45"
+version = "0.1.46"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "225d3389fb3509a24c93f5c29eb6bde2586b98d9f016636dff58d7c6f7569cd9"
+checksum = "7969661fd2958a5cb096e56c8e1ad0444ac2bbcd0061bd28660485a44879858f"
 dependencies = [
- "autocfg",
  "num-traits",
 ]
 
 [[package]]
 name = "num-traits"
-version = "0.2.17"
+version = "0.2.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "39e3200413f237f41ab11ad6d161bc7239c84dcb631773ccd7de3dfe4b5c267c"
+checksum = "da0df0e5185db44f69b44f26786fe401b6c293d1907744beaa7fa62b2e5a517a"
 dependencies = [
  "autocfg",
 ]
@@ -2078,15 +2004,9 @@ checksum = "3fdb12b2476b595f9358c5161aa467c2438859caa136dec86c26fdd2efe17b92"
 
 [[package]]
 name = "opaque-debug"
-version = "0.2.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2839e79665f131bdb5782e51f2c6c9599c133c6098982a54c794358bf432529c"
-
-[[package]]
-name = "opaque-debug"
-version = "0.3.0"
+version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "624a8340c38c1b80fd549087862da4ba43e08858af025b236e509b6649fc13d5"
+checksum = "c08d65885ee38876c4f86fa503fb49d7b507c2b62552df7c70b2fce627e06381"
 
 [[package]]
 name = "parity-scale-codec"
@@ -2094,7 +2014,7 @@ version = "3.6.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "881331e34fa842a2fb61cc2db9643a8fedc615e47cfcc52597d1af0db9a7e8fe"
 dependencies = [
- "arrayvec 0.7.4",
+ "arrayvec",
  "bitvec",
  "byte-slice-cast",
  "bytes",
@@ -2150,7 +2070,7 @@ version = "0.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d95f5254224e617595d2cc3cc73ff0a5eaf2637519e25f03388154e9378b6ffa"
 dependencies = [
- "crypto-mac 0.11.1",
+ "crypto-mac 0.11.0",
 ]
 
 [[package]]
@@ -2161,9 +2081,9 @@ checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
 
 [[package]]
 name = "pin-project-lite"
-version = "0.2.13"
+version = "0.2.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8afb450f006bf6385ca15ef45d71d2288452bc3683ce2e2cacc0d18e4be60b58"
+checksum = "bda66fc9667c18cb2758a2ac84d1167245054bcf85d5d1aaa6923f45801bdd02"
 
 [[package]]
 name = "pin-utils"
@@ -2183,9 +2103,9 @@ dependencies = [
 
 [[package]]
 name = "platforms"
-version = "3.3.0"
+version = "3.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "626dec3cac7cc0e1577a2ec3fc496277ec2baa084bebad95bb6fdbfae235f84c"
+checksum = "db23d408679286588f4d4644f965003d056e3dd5abcaaa938116871d7ce2fee7"
 
 [[package]]
 name = "powerfmt"
@@ -2199,6 +2119,16 @@ version = "0.2.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5b40af805b3121feab8a3c29f04d8ad262fa8e0561883e7653e024ae4479e6de"
 
+[[package]]
+name = "prettier-please"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "22020dfcf177fcc7bf5deaf7440af371400c67c0de14c399938d8ed4fb4645d3"
+dependencies = [
+ "proc-macro2",
+ "syn 2.0.60",
+]
+
 [[package]]
 name = "primitive-types"
 version = "0.12.2"
@@ -2237,7 +2167,7 @@ version = "2.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7e8366a6159044a37876a2b9817124296703c586a5c92e2c53751fa06d8d43e8"
 dependencies = [
- "toml_edit 0.20.2",
+ "toml_edit 0.20.7",
 ]
 
 [[package]]
@@ -2246,23 +2176,23 @@ version = "3.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6d37c51ca738a55da99dc0c4a34860fd675453b8b36209178c2249bb13651284"
 dependencies = [
- "toml_edit 0.21.0",
+ "toml_edit 0.21.1",
 ]
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.78"
+version = "1.0.81"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e2422ad645d89c99f8f3e6b88a9fdeca7fabeac836b1002371c4367c8f984aae"
+checksum = "3d1597b0c024618f09a9c3b8655b7e430397a36d23fdafec26d6965e9eec3eba"
 dependencies = [
  "unicode-ident",
 ]
 
 [[package]]
 name = "prost"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "146c289cda302b98a28d40c8b3b90498d6e526dd24ac2ecea73e4e491685b94a"
+checksum = "d0f5d036824e4761737860779c906171497f6d55681139d8312388f8fe398922"
 dependencies = [
  "bytes",
  "prost-derive",
@@ -2270,22 +2200,22 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "efb6c9a1dd1def8e2124d17e83a20af56f1570d6c2d2bd9e266ccb768df3840e"
+checksum = "19de2de2a00075bf566bee3bd4db014b11587e84184d3f7a791bc17f1a8e9e48"
 dependencies = [
  "anyhow",
- "itertools 0.11.0",
+ "itertools 0.12.1",
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "prost-types"
-version = "0.12.3"
+version = "0.12.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "193898f59edcf43c26227dcd4c8427f00d99d61e95dcde58dabd49fa291d470e"
+checksum = "3235c33eb02c1f1e212abdbe34c78b264b038fb58ca612664343271e36e55ffe"
 dependencies = [
  "prost",
 ]
@@ -2301,9 +2231,9 @@ dependencies = [
 
 [[package]]
 name = "quote"
-version = "1.0.35"
+version = "1.0.36"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "291ec9ab5efd934aaf503a6466c5d5251535d108ee747472c3977cc5acc868ef"
+checksum = "0fa76aaf39101c457836aec0ce2316dbdc3ab723cdda1c6bd4e6ad4208acaca7"
 dependencies = [
  "proc-macro2",
 ]
@@ -2376,19 +2306,19 @@ checksum = "5fddb4f8d99b0a2ebafc65a87a69a7b9875e4b1ae1f00db265d300ef7f28bccc"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "regex"
-version = "1.10.3"
+version = "1.10.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b62dbe01f0b06f9d8dc7d49e05a0785f153b00b2c227856282f671e0318c9b15"
+checksum = "c117dbdfde9c8308975b6a18d71f3f385c89461f7b3fb054288ecf2a2058ba4c"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-automata 0.4.4",
- "regex-syntax 0.8.2",
+ "regex-automata 0.4.6",
+ "regex-syntax 0.8.3",
 ]
 
 [[package]]
@@ -2402,13 +2332,13 @@ dependencies = [
 
 [[package]]
 name = "regex-automata"
-version = "0.4.4"
+version = "0.4.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3b7fa1134405e2ec9353fd416b17f8dacd46c473d7d3fd1cf202706a14eb792a"
+checksum = "86b83b8b9847f9bf95ef68afb0b8e6cdb80f498442f5179a29fad448fcc1eaea"
 dependencies = [
  "aho-corasick",
  "memchr",
- "regex-syntax 0.8.2",
+ "regex-syntax 0.8.3",
 ]
 
 [[package]]
@@ -2419,9 +2349,9 @@ checksum = "f162c6dd7b008981e4d40210aca20b4bd0f9b60ca9271061b07f78537722f2e1"
 
 [[package]]
 name = "regex-syntax"
-version = "0.8.2"
+version = "0.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c08c74e62047bb2de4ff487b251e4a92e24f48745648451635cec7d591162d9f"
+checksum = "adad44e29e4c806119491a7f06f03de4d1af22c3a680dd47f1e6e179439d1f56"
 
 [[package]]
 name = "ripemd"
@@ -2469,11 +2399,11 @@ dependencies = [
 
 [[package]]
 name = "rustix"
-version = "0.38.30"
+version = "0.38.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "322394588aaf33c24007e8bb3238ee3e4c5c09c084ab32bc73890b99ff326bca"
+checksum = "70dc5ec042f7a43c4a73241207cecc9873a06d45debb38b329f8541d85c2730f"
 dependencies = [
- "bitflags 2.4.2",
+ "bitflags 2.5.0",
  "errno",
  "libc",
  "linux-raw-sys 0.4.13",
@@ -2482,15 +2412,15 @@ dependencies = [
 
 [[package]]
 name = "rustversion"
-version = "1.0.14"
+version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ffc183a10b4478d04cbbbfc96d0873219d962dd5accaff2ffbd4ceb7df837f4"
+checksum = "80af6f9131f277a45a3fba6ce8e2258037bb0477a67e610d3c1fe046ab31de47"
 
 [[package]]
 name = "ryu"
-version = "1.0.16"
+version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f98d2aa92eebf49b69786be48e4477826b256916e84a57ff2a4f21923b48eb4c"
+checksum = "e86697c916019a8588c99b5fac3cead74ec0b4b819707a682fd4d23fa0ce1ba1"
 
 [[package]]
 name = "same-file"
@@ -2503,9 +2433,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info"
-version = "2.10.0"
+version = "2.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f7d66a1128282b7ef025a8ead62a4a9fcf017382ec53b8ffbf4d7bf77bd3c60"
+checksum = "7c453e59a955f81fb62ee5d596b450383d699f152d350e9d23a0db2adb78e4c0"
 dependencies = [
  "bitvec",
  "cfg-if",
@@ -2517,9 +2447,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.10.0"
+version = "2.11.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "abf2c68b89cafb3b8d918dd07b42be0da66ff202cf1155c5739a4e0c1ea0dc19"
+checksum = "18cf6c6447f813ef19eb450e985bcce6705f9ce7660db221b59093d15c79c4b7"
 dependencies = [
  "proc-macro-crate 1.3.1",
  "proc-macro2",
@@ -2533,27 +2463,11 @@ version = "0.2.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "772575a524feeb803e5b0fcbc6dd9f367e579488197c94c6e4023aad2305774d"
 dependencies = [
- "ahash 0.8.7",
+ "ahash 0.8.11",
  "cfg-if",
  "hashbrown 0.13.2",
 ]
 
-[[package]]
-name = "schnorrkel"
-version = "0.9.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "021b403afe70d81eea68f6ea12f6b3c9588e5d536a94c3bf80f15e7faa267862"
-dependencies = [
- "arrayref",
- "arrayvec 0.5.2",
- "curve25519-dalek 2.1.3",
- "merlin 2.0.1",
- "rand_core 0.5.1",
- "sha2 0.8.2",
- "subtle",
- "zeroize",
-]
-
 [[package]]
 name = "schnorrkel"
 version = "0.11.4"
@@ -2562,10 +2476,10 @@ checksum = "8de18f6d8ba0aad7045f5feae07ec29899c1112584a38509a84ad7b04451eaa0"
 dependencies = [
  "aead",
  "arrayref",
- "arrayvec 0.7.4",
- "curve25519-dalek 4.1.1",
+ "arrayvec",
+ "curve25519-dalek 4.1.2",
  "getrandom_or_panic",
- "merlin 3.0.0",
+ "merlin",
  "rand_core 0.6.4",
  "serde_bytes",
  "sha2 0.10.8",
@@ -2581,9 +2495,9 @@ checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
 [[package]]
 name = "secp256k1"
-version = "0.28.1"
+version = "0.28.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3f622567e3b4b38154fb8190bcf6b160d7a4301d70595a49195b48c116007a27"
+checksum = "d24b59d129cdadea20aea4fb2352fa053712e5d713eee47d700cd4b2bc002f10"
 dependencies = [
  "secp256k1-sys",
 ]
@@ -2608,15 +2522,15 @@ dependencies = [
 
 [[package]]
 name = "semver"
-version = "1.0.21"
+version = "1.0.22"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b97ed7a9823b74f99c7742f5336af7be5ecd3eeafcb1507d1fa93347b1d589b0"
+checksum = "92d43fe69e652f3df9bdc2b85b2854a0825b86e4fb76bc44d945137d053639ca"
 
 [[package]]
 name = "serde"
-version = "1.0.195"
+version = "1.0.198"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63261df402c67811e9ac6def069e4786148c4563f4b50fd4bf30aa370d626b02"
+checksum = "9846a40c979031340571da2545a4e5b7c4163bdae79b301d5f86d03979451fcc"
 dependencies = [
  "serde_derive",
 ]
@@ -2641,20 +2555,20 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.195"
+version = "1.0.198"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "46fe8f8603d81ba86327b23a2e9cdf49e1255fb94a4c5f297f6ee0547178ea2c"
+checksum = "e88edab869b01783ba905e7d0153f9fc1a6505a96e4ad3018011eedb838566d9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "serde_json"
-version = "1.0.111"
+version = "1.0.116"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "176e46fa42316f18edd598015a5166857fc835ec732f5215eac6b7bdbf0a84f4"
+checksum = "3e17db7126d17feb94eb3fad46bf1a96b034e8aacbc2e775fe81505f8b0b2813"
 dependencies = [
  "itoa",
  "ryu",
@@ -2663,13 +2577,13 @@ dependencies = [
 
 [[package]]
 name = "serde_repr"
-version = "0.1.18"
+version = "0.1.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b2e6b945e9d3df726b65d6ee24060aff8e3533d431f677a9695db04eff9dfdb"
+checksum = "6c64451ba24fc7a6a2d60fc75dd9c83c90903b19028d4eff35e88fc1e86564e9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -2681,18 +2595,6 @@ dependencies = [
  "serde",
 ]
 
-[[package]]
-name = "sha2"
-version = "0.8.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a256f46ea78a0c0d9ff00077504903ac881a1dafdc20da66545699e7776b3e69"
-dependencies = [
- "block-buffer 0.7.3",
- "digest 0.8.1",
- "fake-simd",
- "opaque-debug 0.2.3",
-]
-
 [[package]]
 name = "sha2"
 version = "0.9.9"
@@ -2703,7 +2605,7 @@ dependencies = [
  "cfg-if",
  "cpufeatures",
  "digest 0.9.0",
- "opaque-debug 0.3.0",
+ "opaque-debug",
 ]
 
 [[package]]
@@ -2762,9 +2664,9 @@ dependencies = [
 
 [[package]]
 name = "smallvec"
-version = "1.13.1"
+version = "1.13.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6ecd384b10a64542d77071bd64bd7b231f4ed5940fba55e98c3de13824cf3d7"
+checksum = "3c5e1a9a646d36c3599cd173a41282daf47c44583ad367b8e6837255952e5c67"
 
 [[package]]
 name = "sp-application-crypto"
@@ -2816,14 +2718,14 @@ dependencies = [
  "itertools 0.10.5",
  "libsecp256k1",
  "log",
- "merlin 3.0.0",
+ "merlin",
  "parity-scale-codec",
  "parking_lot",
  "paste",
  "primitive-types",
  "rand",
  "scale-info",
- "schnorrkel 0.11.4",
+ "schnorrkel",
  "secp256k1",
  "secrecy",
  "serde",
@@ -2863,7 +2765,7 @@ checksum = "48d09fa0a5f7299fb81ee25ae3853d26200f7a348148aed6de76be905c007dbe"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -2982,7 +2884,7 @@ dependencies = [
  "proc-macro-crate 3.1.0",
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -3046,7 +2948,7 @@ version = "29.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "2e4d24d84a0beb44a71dcac1b41980e1edf7fb722c7f3046710136a283cd479b"
 dependencies = [
- "ahash 0.8.7",
+ "ahash 0.8.11",
  "hash-db",
  "lazy_static",
  "memory-db",
@@ -3107,9 +3009,9 @@ dependencies = [
 
 [[package]]
 name = "ss58-registry"
-version = "1.46.0"
+version = "1.47.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1114ee5900b8569bbc8b1a014a942f937b752af4b44f4607430b5f86cedaac0"
+checksum = "4743ce898933fbff7bbf414f497c459a782d496269644b3d650a398ae6a487ba"
 dependencies = [
  "Inflector",
  "num-format",
@@ -3134,22 +3036,22 @@ checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
 
 [[package]]
 name = "substrate-bip39"
-version = "0.4.5"
+version = "0.4.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e620c7098893ba667438b47169c00aacdd9e7c10e042250ce2b60b087ec97328"
+checksum = "6a7590dc041b9bc2825e52ce5af8416c73dbe9d0654402bfd4b4941938b94d8f"
 dependencies = [
  "hmac 0.11.0",
  "pbkdf2",
- "schnorrkel 0.9.1",
+ "schnorrkel",
  "sha2 0.9.9",
  "zeroize",
 ]
 
 [[package]]
 name = "subtle"
-version = "2.4.1"
+version = "2.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6bdef32e8150c2a081110b42772ffe7d7c9032b606bc226c8260fd97e0976601"
+checksum = "81cdd64d312baedb58e21336b31bc043b77e01cc99033ce76ef539f78e965ebc"
 
 [[package]]
 name = "subtle-encoding"
@@ -3179,9 +3081,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.48"
+version = "2.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0f3531638e407dfc0814761abb7c00a5b54992b849452a0646b7f65c9f770f3f"
+checksum = "909518bc7b1c9b779f1bbf07f2929d35af9f0f37e47c6e9ef7f9dddc1e1821f3"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3196,15 +3098,15 @@ checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369"
 
 [[package]]
 name = "target-lexicon"
-version = "0.12.13"
+version = "0.12.14"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "69758bda2e78f098e4ccb393021a0963bb3442eac05f135c30f61b7370bbafae"
+checksum = "e1fc403891a21bcfb7c37834ba66a547a8f402146eba7265b5a6d88059c9ff2f"
 
 [[package]]
 name = "tendermint"
-version = "0.34.0"
+version = "0.34.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bc2294fa667c8b548ee27a9ba59115472d0a09c2ba255771092a7f1dcf03a789"
+checksum = "15ab8f0a25d0d2ad49ac615da054d6a76aa6603ff95f7d18bafdd34450a1a04b"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -3231,9 +3133,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.34.0"
+version = "0.34.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74994da9de4b1144837a367ca2c60c650f5526a7c1a54760a3020959b522e474"
+checksum = "9b8090d0eef9ad57b1b913b5e358e26145c86017e87338136509b94383a4af25"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -3244,9 +3146,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.34.0"
+version = "0.34.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2cc728a4f9e891d71adf66af6ecaece146f9c7a11312288a3107b3e1d6979aaf"
+checksum = "b797dd3d2beaaee91d2f065e7bdf239dc8d80bba4a183a288bc1279dd5a69a1e"
 dependencies = [
  "bytes",
  "flex-error",
@@ -3271,29 +3173,29 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.56"
+version = "1.0.59"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d54378c645627613241d077a3a79db965db602882668f9136ac42af9ecb730ad"
+checksum = "f0126ad08bff79f29fc3ae6a55cc72352056dfff61e3ff8bb7129476d44b23aa"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.56"
+version = "1.0.59"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fa0faa943b50f3db30a20aa7e265dbc66076993efed8463e8de414e5d06d3471"
+checksum = "d1cd413b5d558b4c5bf3680e324a6fa5014e7b7c067a51e69dbdf47eb7148b66"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
 name = "thread_local"
-version = "1.1.7"
+version = "1.1.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3fdd6f064ccff2d6567adcb3873ca630700f00b5ad3f060c25b5dcfd9a4ce152"
+checksum = "8b9ef9bad013ada3808854ceac7b46812a6465ba368859a37e2100283d2d719c"
 dependencies = [
  "cfg-if",
  "once_cell",
@@ -3301,11 +3203,12 @@ dependencies = [
 
 [[package]]
 name = "time"
-version = "0.3.31"
+version = "0.3.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f657ba42c3f86e7680e53c8cd3af8abbe56b5491790b46e22e19c0d57463583e"
+checksum = "c8248b6521bb14bc45b4067159b9b6ad792e2d6d754d6c41fb50e29fefe38749"
 dependencies = [
  "deranged",
+ "num-conv",
  "powerfmt",
  "time-core",
  "time-macros",
@@ -3319,10 +3222,11 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.16"
+version = "0.2.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26197e33420244aeb70c3e8c78376ca46571bc4e701e4791c2cd9f57dcb3a43f"
+checksum = "7ba3a3ef41e6672a2f0f001392bb5dcd3ff0a9992d618ca761a11c3121547774"
 dependencies = [
+ "num-conv",
  "time-core",
 ]
 
@@ -3352,14 +3256,14 @@ dependencies = [
 
 [[package]]
 name = "toml"
-version = "0.8.2"
+version = "0.8.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "185d8ab0dfbb35cf1399a6344d8484209c088f75f8f68230da55d48d95d43e3d"
+checksum = "e9dd1545e8208b4a5af1aa9bbd0b4cf7e9ea08fabc5d0a5c67fcaafa17433aa3"
 dependencies = [
  "serde",
  "serde_spanned",
  "toml_datetime",
- "toml_edit 0.20.2",
+ "toml_edit 0.22.12",
 ]
 
 [[package]]
@@ -3377,33 +3281,44 @@ version = "0.19.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
 dependencies = [
- "indexmap 2.1.0",
+ "indexmap 2.2.6",
  "toml_datetime",
- "winnow",
+ "winnow 0.5.40",
 ]
 
 [[package]]
 name = "toml_edit"
-version = "0.20.2"
+version = "0.20.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
+checksum = "70f427fce4d84c72b5b732388bf4a9f4531b53f74e2887e3ecb2481f68f66d81"
 dependencies = [
- "indexmap 2.1.0",
- "serde",
- "serde_spanned",
+ "indexmap 2.2.6",
  "toml_datetime",
- "winnow",
+ "winnow 0.5.40",
 ]
 
 [[package]]
 name = "toml_edit"
-version = "0.21.0"
+version = "0.21.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a8534fd7f78b5405e860340ad6575217ce99f38d4d5c8f2442cb5ecb50090e1"
+dependencies = [
+ "indexmap 2.2.6",
+ "toml_datetime",
+ "winnow 0.5.40",
+]
+
+[[package]]
+name = "toml_edit"
+version = "0.22.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d34d383cd00a163b4a5b85053df514d45bc330f6de7737edfe0a93311d1eaa03"
+checksum = "d3328d4f68a705b2a4498da1d580585d39a6510f98318a2cec3018a7ec61ddef"
 dependencies = [
- "indexmap 2.1.0",
+ "indexmap 2.2.6",
+ "serde",
+ "serde_spanned",
  "toml_datetime",
- "winnow",
+ "winnow 0.6.6",
 ]
 
 [[package]]
@@ -3425,7 +3340,7 @@ checksum = "34704c8d6ebcbc939824180af020566b01a7c01f80641264eba0999f6c2b6be7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -3609,9 +3524,9 @@ dependencies = [
 
 [[package]]
 name = "walkdir"
-version = "2.4.0"
+version = "2.5.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d71d857dc86794ca4c280d616f7da00d2dbfd8cd788846559a6813e6aa4b54ee"
+checksum = "29790946404f91d9c5d06f9874efddea1dc06c5efe94541a7d6863108e3a5e4b"
 dependencies = [
  "same-file",
  "winapi-util",
@@ -3625,9 +3540,9 @@ checksum = "9c8d87e72b64a3b4db28d11ce29237c246188f4f51057d65a7eab63b7987e423"
 
 [[package]]
 name = "wasm-bindgen"
-version = "0.2.90"
+version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1223296a201415c7fad14792dbefaace9bd52b62d33453ade1c5b5f07555406"
+checksum = "4be2531df63900aeb2bca0daaaddec08491ee64ceecbee5076636a3b026795a8"
 dependencies = [
  "cfg-if",
  "wasm-bindgen-macro",
@@ -3635,24 +3550,24 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-backend"
-version = "0.2.90"
+version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fcdc935b63408d58a32f8cc9738a0bffd8f05cc7c002086c6ef20b7312ad9dcd"
+checksum = "614d787b966d3989fa7bb98a654e369c762374fd3213d212cfc0251257e747da"
 dependencies = [
  "bumpalo",
  "log",
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-macro"
-version = "0.2.90"
+version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3e4c238561b2d428924c49815533a8b9121c664599558a5d9ec51f8a1740a999"
+checksum = "a1f8823de937b71b9460c0c34e25f3da88250760bec0ebac694b49997550d726"
 dependencies = [
  "quote",
  "wasm-bindgen-macro-support",
@@ -3660,22 +3575,22 @@ dependencies = [
 
 [[package]]
 name = "wasm-bindgen-macro-support"
-version = "0.2.90"
+version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bae1abb6806dc1ad9e560ed242107c0f6c84335f1749dd4e8ddb012ebd5e25a7"
+checksum = "e94f17b526d0a461a191c78ea52bbce64071ed5c04c9ffe424dcb38f74171bb7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
 
 [[package]]
 name = "wasm-bindgen-shared"
-version = "0.2.90"
+version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4d91413b1c31d7539ba5ef2451af3f0b833a005eb27a631cec32bc0635a8602b"
+checksum = "af190c94f2773fdb3729c55b007a722abb5384da03bc0986df4c289bf5567e96"
 
 [[package]]
 name = "wasmparser"
@@ -3837,11 +3752,11 @@ checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
 
 [[package]]
 name = "winapi-util"
-version = "0.1.6"
+version = "0.1.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f29e6f9198ba0d26b4c9f07dbe6f9ed633e1f3d5b8b414090084349e46a52596"
+checksum = "134306a13c5647ad6453e8deaec55d3a44d6021970129e6188735e74bf546697"
 dependencies = [
- "winapi",
+ "windows-sys 0.52.0",
 ]
 
 [[package]]
@@ -3856,7 +3771,7 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "33ab640c8d7e35bf8ba19b884ba838ceb4fba93a4e8c65a9059d08afcfc683d9"
 dependencies = [
- "windows-targets 0.52.0",
+ "windows-targets 0.52.5",
 ]
 
 [[package]]
@@ -3883,7 +3798,7 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
 dependencies = [
- "windows-targets 0.52.0",
+ "windows-targets 0.52.5",
 ]
 
 [[package]]
@@ -3918,17 +3833,18 @@ dependencies = [
 
 [[package]]
 name = "windows-targets"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8a18201040b24831fbb9e4eb208f8892e1f50a37feb53cc7ff887feb8f50e7cd"
+checksum = "6f0713a46559409d202e70e28227288446bf7841d3211583a4b53e3f6d96e7eb"
 dependencies = [
- "windows_aarch64_gnullvm 0.52.0",
- "windows_aarch64_msvc 0.52.0",
- "windows_i686_gnu 0.52.0",
- "windows_i686_msvc 0.52.0",
- "windows_x86_64_gnu 0.52.0",
- "windows_x86_64_gnullvm 0.52.0",
- "windows_x86_64_msvc 0.52.0",
+ "windows_aarch64_gnullvm 0.52.5",
+ "windows_aarch64_msvc 0.52.5",
+ "windows_i686_gnu 0.52.5",
+ "windows_i686_gnullvm",
+ "windows_i686_msvc 0.52.5",
+ "windows_x86_64_gnu 0.52.5",
+ "windows_x86_64_gnullvm 0.52.5",
+ "windows_x86_64_msvc 0.52.5",
 ]
 
 [[package]]
@@ -3945,9 +3861,9 @@ checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
 
 [[package]]
 name = "windows_aarch64_gnullvm"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cb7764e35d4db8a7921e09562a0304bf2f93e0a51bfccee0bd0bb0b666b015ea"
+checksum = "7088eed71e8b8dda258ecc8bac5fb1153c5cffaf2578fc8ff5d61e23578d3263"
 
 [[package]]
 name = "windows_aarch64_msvc"
@@ -3963,9 +3879,9 @@ checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
 
 [[package]]
 name = "windows_aarch64_msvc"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bbaa0368d4f1d2aaefc55b6fcfee13f41544ddf36801e793edbbfd7d7df075ef"
+checksum = "9985fd1504e250c615ca5f281c3f7a6da76213ebd5ccc9561496568a2752afb6"
 
 [[package]]
 name = "windows_i686_gnu"
@@ -3981,9 +3897,15 @@ checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
 
 [[package]]
 name = "windows_i686_gnu"
-version = "0.52.0"
+version = "0.52.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "88ba073cf16d5372720ec942a8ccbf61626074c6d4dd2e745299726ce8b89670"
+
+[[package]]
+name = "windows_i686_gnullvm"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a28637cb1fa3560a16915793afb20081aba2c92ee8af57b4d5f28e4b3e7df313"
+checksum = "87f4261229030a858f36b459e748ae97545d6f1ec60e5e0d6a3d32e0dc232ee9"
 
 [[package]]
 name = "windows_i686_msvc"
@@ -3999,9 +3921,9 @@ checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
 
 [[package]]
 name = "windows_i686_msvc"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ffe5e8e31046ce6230cc7215707b816e339ff4d4d67c65dffa206fd0f7aa7b9a"
+checksum = "db3c2bf3d13d5b658be73463284eaf12830ac9a26a90c717b7f771dfe97487bf"
 
 [[package]]
 name = "windows_x86_64_gnu"
@@ -4017,9 +3939,9 @@ checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
 
 [[package]]
 name = "windows_x86_64_gnu"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d6fa32db2bc4a2f5abeacf2b69f7992cd09dca97498da74a151a3132c26befd"
+checksum = "4e4246f76bdeff09eb48875a0fd3e2af6aada79d409d33011886d3e1581517d9"
 
 [[package]]
 name = "windows_x86_64_gnullvm"
@@ -4035,9 +3957,9 @@ checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
 
 [[package]]
 name = "windows_x86_64_gnullvm"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1a657e1e9d3f514745a572a6846d3c7aa7dbe1658c056ed9c3344c4109a6949e"
+checksum = "852298e482cd67c356ddd9570386e2862b5673c85bd5f88df9ab6802b334c596"
 
 [[package]]
 name = "windows_x86_64_msvc"
@@ -4053,15 +3975,24 @@ checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
 
 [[package]]
 name = "windows_x86_64_msvc"
-version = "0.52.0"
+version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dff9641d1cd4be8d1a070daf9e3773c5f67e78b4d9d42263020c057706765c04"
+checksum = "bec47e5bfd1bff0eeaf6d8b485cc1074891a197ab4225d504cb7a1ab88b02bf0"
+
+[[package]]
+name = "winnow"
+version = "0.5.40"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f593a95398737aeed53e489c785df13f3618e41dbcd6718c6addbf1395aa6876"
+dependencies = [
+ "memchr",
+]
 
 [[package]]
 name = "winnow"
-version = "0.5.34"
+version = "0.6.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b7cf47b659b318dccbd69cc4797a39ae128f533dce7902a1096044d1967b9c16"
+checksum = "f0c976aaaa0e1f90dbb21e9587cdaf1d9679a1cde8875c0d6bd83ab96a208352"
 dependencies = [
  "memchr",
 ]
@@ -4092,7 +4023,7 @@ checksum = "9ce1b18ccd8e73a9321186f97e46f9f04b778851177567b1975109d26a08d2a6"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -4112,5 +4043,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.48",
+ "syn 2.0.60",
 ]

From 74208d0587bd2c049a2a65464fd5b6de1ab9da7b Mon Sep 17 00:00:00 2001
From: Farhad Shabani <Farhad.Shabani@gmail.com>
Date: Wed, 24 Apr 2024 06:41:57 -0700
Subject: [PATCH 155/182] imp: use Timestamp::now() + add test_cw_client_expiry
 (#1181)

---
 .../cw-contract/src/tests/fixture.rs          | 138 ++++++++++++------
 .../cw-contract/src/tests/helper.rs           |  17 ++-
 .../cw-contract/src/tests/mod.rs              |  92 +++++++-----
 3 files changed, 157 insertions(+), 90 deletions(-)

diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
index 96ec1434a..8961f10f1 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
@@ -1,11 +1,10 @@
-use std::ops::Add;
 use std::time::Duration;
 
-use cosmwasm_std::testing::mock_env;
-use cosmwasm_std::{from_json, Deps, DepsMut, Empty, StdError};
+use cosmwasm_std::{from_json, Deps, DepsMut, Empty, Response, StdError, StdResult};
 use ibc_client_cw::types::{
-    CheckForMisbehaviourMsgRaw, ExportMetadataMsg, GenesisMetadata, InstantiateMsg, QueryMsg,
-    QueryResponse, StatusMsg, VerifyClientMessageRaw,
+    CheckForMisbehaviourMsgRaw, ContractError, ExportMetadataMsg, GenesisMetadata, InstantiateMsg,
+    MigrationPrefix, QueryMsg, QueryResponse, StatusMsg, UpdateStateMsgRaw,
+    UpdateStateOnMisbehaviourMsgRaw, VerifyClientMessageRaw,
 };
 use ibc_client_cw::utils::AnyCodec;
 use ibc_client_tendermint::client_state::ClientState as TmClientState;
@@ -15,9 +14,10 @@ use ibc_core::client::types::{Height, Status};
 use ibc_core::host::types::identifiers::ChainId;
 use ibc_core::primitives::Timestamp;
 use ibc_testkit::fixtures::clients::tendermint::ClientStateConfig;
+use tendermint::Time;
 use tendermint_testgen::{Generator, Validator};
 
-use super::helper::{dummy_checksum, dummy_sov_consensus_state};
+use super::helper::{dummy_checksum, dummy_sov_consensus_state, mock_env_with_timestamp_now};
 use crate::entrypoint::TendermintContext;
 
 /// Test fixture
@@ -26,63 +26,70 @@ pub struct Fixture {
     pub chain_id: ChainId,
     pub trusted_timestamp: Timestamp,
     pub trusted_height: Height,
-    pub target_height: Height,
     pub validators: Vec<Validator>,
-    pub migration_mode: bool,
+    pub migration_prefix: MigrationPrefix,
 }
 
 impl Default for Fixture {
     fn default() -> Self {
         Fixture {
             chain_id: ChainId::new("test-chain").unwrap(),
-            // Returns a dummy timestamp for testing purposes. The value corresponds to the
-            // timestamp of the `mock_env()`.
-            trusted_timestamp: Timestamp::from_nanoseconds(1_571_797_419_879_305_533)
-                .expect("never fails"),
+            trusted_timestamp: Timestamp::now(),
             trusted_height: Height::new(0, 5).unwrap(),
-            target_height: Height::new(0, 10).unwrap(),
             validators: vec![
                 Validator::new("1").voting_power(40),
                 Validator::new("2").voting_power(30),
                 Validator::new("3").voting_power(30),
             ],
-            migration_mode: false,
+            migration_prefix: MigrationPrefix::None,
         }
     }
 }
 
 impl Fixture {
-    pub fn migration_mode(mut self) -> Self {
-        self.migration_mode = true;
-        self
+    pub fn set_migration_prefix(&mut self, migration_mode: MigrationPrefix) {
+        self.migration_prefix = migration_mode;
     }
 
     pub fn ctx_ref<'a>(&self, deps: Deps<'a, Empty>) -> TendermintContext<'a> {
-        let mut ctx = TendermintContext::new_ref(deps, mock_env()).expect("never fails");
-
-        if self.migration_mode {
-            ctx.set_subject_prefix();
+        let mut ctx =
+            TendermintContext::new_ref(deps, mock_env_with_timestamp_now()).expect("never fails");
+
+        match self.migration_prefix {
+            MigrationPrefix::None => {}
+            MigrationPrefix::Subject => {
+                ctx.set_subject_prefix();
+            }
+            MigrationPrefix::Substitute => {
+                ctx.set_substitute_prefix();
+            }
         };
 
         ctx
     }
 
     pub fn ctx_mut<'a>(&self, deps: DepsMut<'a, Empty>) -> TendermintContext<'a> {
-        let mut ctx = TendermintContext::new_mut(deps, mock_env()).expect("never fails");
-
-        if self.migration_mode {
-            ctx.set_subject_prefix();
+        let mut ctx =
+            TendermintContext::new_mut(deps, mock_env_with_timestamp_now()).expect("never fails");
+
+        match self.migration_prefix {
+            MigrationPrefix::None => {}
+            MigrationPrefix::Subject => {
+                ctx.set_subject_prefix();
+            }
+            MigrationPrefix::Substitute => {
+                ctx.set_substitute_prefix();
+            }
         };
 
         ctx
     }
 
     pub fn dummy_instantiate_msg(&self) -> InstantiateMsg {
-        // Setting the `trusting_period` to 1 second allows the quick client
-        // freeze for the `happy_cw_client_recovery` test.
-
+        // Setting the `trusting_period` to 1 second allows the quick
+        // client expiry for the tests.
         let tm_client_state: TmClientState = ClientStateConfig::builder()
-            .chain_id("test-chain".parse().unwrap())
+            .chain_id(self.chain_id.clone())
             .trusting_period(Duration::from_secs(1))
             .latest_height(self.trusted_height)
             .build()
@@ -99,19 +106,10 @@ impl Fixture {
     }
 
     fn dummy_header(&self, header_height: Height) -> Vec<u8> {
-        // NOTE: since mock context has a fixed timestamp, we only can add up
-        // to allowed clock drift (3s)
-        let future_time = self
-            .trusted_timestamp
-            .add(Duration::from_secs(2))
-            .expect("never fails")
-            .into_tm_time()
-            .expect("Time exists");
-
         let header = tendermint_testgen::Header::new(&self.validators)
             .chain_id(self.chain_id.as_str())
             .height(header_height.revision_height())
-            .time(future_time)
+            .time(Time::now())
             .next_validators(&self.validators)
             .app_hash(vec![0; 32].try_into().expect("never fails"));
 
@@ -129,8 +127,8 @@ impl Fixture {
         Header::encode_to_any_vec(tm_header)
     }
 
-    pub fn dummy_client_message(&self) -> Vec<u8> {
-        self.dummy_header(self.target_height)
+    pub fn dummy_client_message(&self, target_height: Height) -> Vec<u8> {
+        self.dummy_header(target_height)
     }
 
     /// Constructs a dummy misbehaviour message that is one block behind the
@@ -142,7 +140,9 @@ impl Fixture {
     }
 
     pub fn verify_client_message(&self, deps: Deps<'_>, client_message: Vec<u8>) {
-        let resp = self.query(deps, VerifyClientMessageRaw { client_message }.into());
+        let resp = self
+            .query(deps, VerifyClientMessageRaw { client_message }.into())
+            .unwrap();
 
         assert!(resp.is_valid);
         assert!(resp.status.is_none());
@@ -150,31 +150,73 @@ impl Fixture {
     }
 
     pub fn check_for_misbehaviour(&self, deps: Deps<'_>, client_message: Vec<u8>) {
-        let resp = self.query(deps, CheckForMisbehaviourMsgRaw { client_message }.into());
+        let resp = self
+            .query(deps, CheckForMisbehaviourMsgRaw { client_message }.into())
+            .unwrap();
 
         assert!(resp.is_valid);
         assert_eq!(resp.found_misbehaviour, Some(true));
     }
 
     pub fn check_client_status(&self, deps: Deps<'_>, expected: Status) {
-        let resp = self.query(deps, StatusMsg {}.into());
+        let resp = self.query(deps, StatusMsg {}.into()).unwrap();
 
         assert_eq!(resp.status, Some(expected.to_string()));
     }
 
     pub fn get_metadata(&self, deps: Deps<'_>) -> Option<Vec<GenesisMetadata>> {
         self.query(deps, ExportMetadataMsg {}.into())
-            .genesis_metadata
+            .map(|resp| resp.genesis_metadata)
+            .unwrap()
     }
 
-    pub fn query(&self, deps: Deps<'_>, msg: QueryMsg) -> QueryResponse {
+    pub fn query(&self, deps: Deps<'_>, msg: QueryMsg) -> StdResult<QueryResponse> {
         let ctx = self.ctx_ref(deps);
 
         let resp_bytes = ctx
             .query(msg)
-            .map_err(|e| StdError::generic_err(e.to_string()))
+            .map_err(|e| StdError::generic_err(e.to_string()))?;
+
+        from_json(resp_bytes)
+    }
+
+    pub fn create_client(&self, deps_mut: DepsMut<'_>) -> Result<Response, ContractError> {
+        let mut ctx = self.ctx_mut(deps_mut);
+
+        let instantiate_msg = self.dummy_instantiate_msg();
+
+        let data = ctx.instantiate(instantiate_msg)?;
+
+        Ok(Response::default().set_data(data))
+    }
+
+    pub fn update_client(
+        &self,
+        deps_mut: DepsMut<'_>,
+        target_height: Height,
+    ) -> Result<Response, ContractError> {
+        let client_message = self.dummy_client_message(target_height);
+
+        self.verify_client_message(deps_mut.as_ref(), client_message.clone());
+
+        let mut ctx = self.ctx_mut(deps_mut);
+
+        let data = ctx.sudo(UpdateStateMsgRaw { client_message }.into())?;
+
+        Ok(Response::default().set_data(data))
+    }
+
+    pub fn update_client_on_misbehaviour(&self, deps_mut: DepsMut<'_>) -> Response {
+        let client_message = self.dummy_misbehaviour_message();
+
+        self.check_for_misbehaviour(deps_mut.as_ref(), client_message.clone());
+
+        let mut ctx = self.ctx_mut(deps_mut);
+
+        let data = ctx
+            .sudo(UpdateStateOnMisbehaviourMsgRaw { client_message }.into())
             .unwrap();
 
-        from_json(resp_bytes).unwrap()
+        Response::default().set_data(data)
     }
 }
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
index 57bf8c9e3..45b5137b0 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
@@ -1,9 +1,9 @@
 use std::str::FromStr;
 
-use cosmwasm_std::testing::mock_info;
-use cosmwasm_std::{coins, MessageInfo};
+use cosmwasm_std::testing::{mock_env, mock_info};
+use cosmwasm_std::{coins, Env, MessageInfo, Timestamp as CwTimestamp};
 use ibc_client_tendermint::types::ConsensusState;
-use ibc_core::primitives::Timestamp;
+use ibc_core::primitives::Timestamp as IbcTimestamp;
 use tendermint::Hash;
 
 pub fn dummy_msg_info() -> MessageInfo {
@@ -15,7 +15,7 @@ pub fn dummy_checksum() -> Vec<u8> {
         .expect("Never fails")
 }
 
-pub fn dummy_sov_consensus_state(timestamp: Timestamp) -> ConsensusState {
+pub fn dummy_sov_consensus_state(timestamp: IbcTimestamp) -> ConsensusState {
     ConsensusState::new(
         vec![0].into(),
         timestamp.into_tm_time().expect("Time exists"),
@@ -24,3 +24,12 @@ pub fn dummy_sov_consensus_state(timestamp: Timestamp) -> ConsensusState {
             .expect("Never fails"),
     )
 }
+
+/// Returns a mock environment with the current timestamp. This is define to use
+/// for testing client expiry and other time-sensitive operations.
+pub fn mock_env_with_timestamp_now() -> Env {
+    let mut env = mock_env();
+    let now_nanos = IbcTimestamp::now().nanoseconds();
+    env.block.time = CwTimestamp::from_nanos(now_nanos);
+    env
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs b/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
index 3918b52d6..9c302f1f2 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
@@ -1,26 +1,25 @@
 pub mod fixture;
 pub mod helper;
 
+use std::time::Duration;
+
 use cosmwasm_std::from_json;
 use cosmwasm_std::testing::{mock_dependencies, mock_env};
 use ibc_client_cw::types::{
-    ContractResult, MigrateClientStoreMsg, UpdateStateMsgRaw, UpdateStateOnMisbehaviourMsgRaw,
+    ContractResult, MigrateClientStoreMsg, MigrationPrefix, VerifyClientMessageRaw,
 };
-use ibc_core::client::types::Status;
+use ibc_core::client::types::{Height, Status};
 
-use crate::entrypoint::{instantiate, sudo};
+use crate::entrypoint::sudo;
 use crate::tests::fixture::Fixture;
-use crate::tests::helper::dummy_msg_info;
 
 #[test]
-fn happy_cw_create_client() {
+fn test_cw_create_client_ok() {
     let fxt = Fixture::default();
 
     let mut deps = mock_dependencies();
 
-    let instantiate_msg = fxt.dummy_instantiate_msg();
-
-    let resp = instantiate(deps.as_mut(), mock_env(), dummy_msg_info(), instantiate_msg).unwrap();
+    let resp = fxt.create_client(deps.as_mut()).unwrap();
 
     assert_eq!(0, resp.messages.len());
 
@@ -32,29 +31,20 @@ fn happy_cw_create_client() {
 }
 
 #[test]
-fn happy_cw_update_client() {
+fn test_cw_update_client_ok() {
     let fxt = Fixture::default();
 
     let mut deps = mock_dependencies();
 
     // ------------------- Create client -------------------
 
-    let instantiate_msg = fxt.dummy_instantiate_msg();
-
-    instantiate(deps.as_mut(), mock_env(), dummy_msg_info(), instantiate_msg).unwrap();
+    fxt.create_client(deps.as_mut()).unwrap();
 
     // ------------------- Verify and Update client -------------------
 
-    let client_message = fxt.dummy_client_message();
-
-    fxt.verify_client_message(deps.as_ref(), client_message.clone());
+    let target_height = Height::new(0, 10).unwrap();
 
-    let resp = sudo(
-        deps.as_mut(),
-        mock_env(),
-        UpdateStateMsgRaw { client_message }.into(),
-    )
-    .unwrap();
+    let resp = fxt.update_client(deps.as_mut(), target_height).unwrap();
 
     // ------------------- Check response -------------------
 
@@ -62,41 +52,32 @@ fn happy_cw_update_client() {
 
     let contract_result: ContractResult = from_json(resp.data.unwrap()).unwrap();
 
-    assert_eq!(contract_result.heights, Some(vec![fxt.target_height]));
+    assert_eq!(contract_result.heights, Some(vec![target_height]));
 
     fxt.check_client_status(deps.as_ref(), Status::Active);
 }
 
 #[test]
-fn happy_cw_recovery_client() {
-    let fxt = Fixture::default().migration_mode();
+fn test_cw_recovery_client_ok() {
+    let mut fxt = Fixture::default();
 
     let mut deps = mock_dependencies();
 
-    let mut ctx = fxt.ctx_mut(deps.as_mut());
-
     // ------------------- Create subject client -------------------
 
-    let instantiate_msg = fxt.dummy_instantiate_msg();
+    fxt.set_migration_prefix(MigrationPrefix::Subject);
 
-    ctx.instantiate(instantiate_msg.clone()).unwrap();
+    fxt.create_client(deps.as_mut()).unwrap();
 
     // ------------------- Freeze subject client -------------------
 
-    let client_message = fxt.dummy_misbehaviour_message();
-
-    fxt.check_for_misbehaviour(deps.as_ref(), client_message.clone());
-
-    let mut ctx = fxt.ctx_mut(deps.as_mut());
-
-    ctx.sudo(UpdateStateOnMisbehaviourMsgRaw { client_message }.into())
-        .unwrap();
+    fxt.update_client_on_misbehaviour(deps.as_mut());
 
     // ------------------- Create substitute client -------------------
 
-    ctx.set_substitute_prefix();
+    fxt.set_migration_prefix(MigrationPrefix::Substitute);
 
-    ctx.instantiate(instantiate_msg).unwrap();
+    fxt.create_client(deps.as_mut()).unwrap();
 
     // ------------------- Recover subject client -------------------
 
@@ -106,3 +87,38 @@ fn happy_cw_recovery_client() {
 
     fxt.check_client_status(deps.as_ref(), Status::Active);
 }
+
+#[test]
+fn test_cw_client_expiry() {
+    let fxt = Fixture::default();
+
+    let mut deps = mock_dependencies();
+
+    // ------------------- Create client -------------------
+
+    fxt.create_client(deps.as_mut()).unwrap();
+
+    // ------------------- Expire client -------------------
+
+    std::thread::sleep(Duration::from_millis(1200));
+
+    // ------------------- Try update client -------------------
+
+    let target_height = Height::new(0, 10).unwrap();
+
+    let client_message = fxt.dummy_client_message(target_height);
+
+    let resp = fxt.query(
+        deps.as_ref(),
+        VerifyClientMessageRaw {
+            client_message: client_message.clone(),
+        }
+        .into(),
+    );
+
+    assert!(resp.is_err());
+
+    // ------------------- Check client status -------------------
+
+    fxt.check_client_status(deps.as_ref(), Status::Expired);
+}

From ee7f671c8a2033ac9f7cef31f477019f5177a3b1 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 24 Apr 2024 10:43:36 -0400
Subject: [PATCH 156/182] chore(deps): update `ibc-proto` and `tendermint`
 dependencies (#1192)

* update ibc-proto to 0.43.0

* update tendermint to 0.35.0

* update tonic for ibc-proto

* changelog entry

* boxing large elements in enum variants

* update cargo lockfiles
---
 ...71-update-ibc-proto-and-tendermint-deps.md |  2 +
 Cargo.toml                                    | 14 +++---
 ci/cw-check/Cargo.lock                        | 47 +++++++------------
 ci/no-std-check/Cargo.lock                    | 30 +++++++-----
 ci/no-std-check/Cargo.toml                    |  8 ++--
 .../ics07-tendermint/types/src/error.rs       |  6 ++-
 ibc-query/Cargo.toml                          |  2 +-
 7 files changed, 54 insertions(+), 55 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md

diff --git a/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md b/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
new file mode 100644
index 000000000..c4599670b
--- /dev/null
+++ b/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
@@ -0,0 +1,2 @@
+- Update `ibc-proto` to v0.43.0 and `tendermint` dependencies to v0.35.0.
+  ([#1171](https://github.com/cosmos/ibc-rs/issues/1171))
diff --git a/Cargo.toml b/Cargo.toml
index d1abc6906..70c351cd9 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -102,15 +102,15 @@ ibc-client-wasm-types       = { version = "0.51.0", path = "./ibc-clients/ics08-
 ibc-app-transfer-types      = { version = "0.51.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 ibc-app-nft-transfer-types  = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
-ibc-proto = { version = "0.42.2", default-features = false }
+ibc-proto = { version = "0.43.0", default-features = false }
 
 # cosmos dependencies
-tendermint                       = { version = "0.34.0", default-features = false }
-tendermint-light-client          = { version = "0.34.0", default-features = false }
-tendermint-light-client-verifier = { version = "0.34.0", default-features = false }
-tendermint-proto                 = { version = "0.34.0", default-features = false }
-tendermint-rpc                   = { version = "0.34.0", default-features = false }
-tendermint-testgen               = { version = "0.34.0", default-features = false }
+tendermint                       = { version = "0.35.0", default-features = false }
+tendermint-light-client          = { version = "0.35.0", default-features = false }
+tendermint-light-client-verifier = { version = "0.35.0", default-features = false }
+tendermint-proto                 = { version = "0.35.0", default-features = false }
+tendermint-rpc                   = { version = "0.35.0", default-features = false }
+tendermint-testgen               = { version = "0.35.0", default-features = false }
 
 # cosmwasm dependencies
 ### Note: Kept at the following version to match the CosmWasm module version
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 5e715058c..1e15c0efa 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -49,6 +49,12 @@ version = "0.21.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
+[[package]]
+name = "base64"
+version = "0.22.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9475866fec1451be56a3c2400fd081ff546538961565ccb5b7142cbd22bc7a51"
+
 [[package]]
 name = "base64ct"
 version = "1.6.0"
@@ -205,7 +211,7 @@ version = "1.5.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "712fe58f39d55c812f7b2c84e097cdede3a39d520f89b6dc3153837e31741927"
 dependencies = [
- "base64",
+ "base64 0.21.7",
  "bech32",
  "bnum",
  "cosmwasm-crypto",
@@ -432,16 +438,6 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
-[[package]]
-name = "eyre"
-version = "0.6.12"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7cd915d99f24784cdc19fd37ef22b97e3ff0ae756c7e492e9fbfe897d61e2aec"
-dependencies = [
- "indenter",
- "once_cell",
-]
-
 [[package]]
 name = "ff"
 version = "0.13.0"
@@ -467,7 +463,6 @@ version = "0.4.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c606d892c9de11507fa0dcffc116434f94e105d0bbdc4e405b61519464c49d7b"
 dependencies = [
- "eyre",
  "paste",
 ]
 
@@ -896,11 +891,11 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.42.2"
+version = "0.43.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c1a6f2bbf7e1d12f98d8d54d9114231b865418d0f8b619c0873180eafdee07fd"
+checksum = "af781637b107aa33042426c9d17b181ced05ae97b1d88dba50f40f19ad44e36f"
 dependencies = [
- "base64",
+ "base64 0.22.0",
  "bytes",
  "flex-error",
  "ics23",
@@ -953,12 +948,6 @@ dependencies = [
  "syn 1.0.109",
 ]
 
-[[package]]
-name = "indenter"
-version = "0.3.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ce23b50ad8242c51a442f3ff322d56b02f08852c77e4c0b4d3fd684abc89c683"
-
 [[package]]
 name = "indexmap"
 version = "2.2.6"
@@ -975,7 +964,7 @@ version = "0.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9aa4a0980c8379295100d70854354e78df2ee1c6ca0f96ffe89afeb3140e3a3d"
 dependencies = [
- "base64",
+ "base64 0.21.7",
  "serde",
 ]
 
@@ -1037,13 +1026,13 @@ checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
 [[package]]
 name = "num-derive"
-version = "0.3.3"
+version = "0.4.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "876a53fff98e03a936a674b29568b0e605f06b29372c2489ff4de23f1949743d"
+checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1487,9 +1476,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint"
-version = "0.34.1"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "15ab8f0a25d0d2ad49ac615da054d6a76aa6603ff95f7d18bafdd34450a1a04b"
+checksum = "43f8a10105d0a7c4af0a242e23ed5a12519afe5cc0e68419da441bb5981a6802"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -1514,9 +1503,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.34.1"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b797dd3d2beaaee91d2f065e7bdf239dc8d80bba4a183a288bc1279dd5a69a1e"
+checksum = "ff525d5540a9fc535c38dc0d92a98da3ee36fcdfbda99cecb9f3cce5cd4d41d7"
 dependencies = [
  "bytes",
  "flex-error",
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 0632fefdd..cad12ee79 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -289,6 +289,12 @@ version = "0.21.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
+[[package]]
+name = "base64"
+version = "0.22.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9475866fec1451be56a3c2400fd081ff546538961565ccb5b7142cbd22bc7a51"
+
 [[package]]
 name = "base64ct"
 version = "1.6.0"
@@ -1558,11 +1564,11 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.42.2"
+version = "0.43.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c1a6f2bbf7e1d12f98d8d54d9114231b865418d0f8b619c0873180eafdee07fd"
+checksum = "af781637b107aa33042426c9d17b181ced05ae97b1d88dba50f40f19ad44e36f"
 dependencies = [
- "base64 0.21.7",
+ "base64 0.22.0",
  "borsh",
  "bytes",
  "flex-error",
@@ -1928,13 +1934,13 @@ checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
 [[package]]
 name = "num-derive"
-version = "0.3.3"
+version = "0.4.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "876a53fff98e03a936a674b29568b0e605f06b29372c2489ff4de23f1949743d"
+checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -3104,9 +3110,9 @@ checksum = "e1fc403891a21bcfb7c37834ba66a547a8f402146eba7265b5a6d88059c9ff2f"
 
 [[package]]
 name = "tendermint"
-version = "0.34.1"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "15ab8f0a25d0d2ad49ac615da054d6a76aa6603ff95f7d18bafdd34450a1a04b"
+checksum = "43f8a10105d0a7c4af0a242e23ed5a12519afe5cc0e68419da441bb5981a6802"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -3133,9 +3139,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.34.1"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9b8090d0eef9ad57b1b913b5e358e26145c86017e87338136509b94383a4af25"
+checksum = "35678b66e819659617c2e83f9662b8544425694441990c07137904a07872d871"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -3146,9 +3152,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.34.1"
+version = "0.35.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b797dd3d2beaaee91d2f065e7bdf239dc8d80bba4a183a288bc1279dd5a69a1e"
+checksum = "ff525d5540a9fc535c38dc0d92a98da3ee36fcdfbda99cecb9f3cce5cd4d41d7"
 dependencies = [
  "bytes",
  "flex-error",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index d7f6f8965..3326ac75c 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -6,14 +6,14 @@ resolver = "2"
 
 [dependencies]
 ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.42.2", default-features = false, features = [
+ibc-proto = { version = "0.43", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
 ] }
-tendermint = { version = "0.34", default-features = false }
-tendermint-proto = { version = "0.34", default-features = false }
-tendermint-light-client-verifier = { version = "0.34", default-features = false, features = ["rust-crypto"] }
+tendermint = { version = "0.35", default-features = false }
+tendermint-proto = { version = "0.35", default-features = false }
+tendermint-light-client-verifier = { version = "0.35", default-features = false, features = ["rust-crypto"] }
 
 sp-core = { version = "28.0.0", default-features = false, optional = true }
 sp-io = { version = "30.0.0", default-features = false, optional = true }
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index ad53989fb..4376e902e 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -76,7 +76,7 @@ pub enum Error {
     /// not enough trust because insufficient validators overlap: `{reason}`
     NotEnoughTrustedValsSigned { reason: VotingPowerTally },
     /// verification failed: `{detail}`
-    VerificationError { detail: LightClientErrorDetail },
+    VerificationError { detail: Box<LightClientErrorDetail> },
     /// Processed time or height for the client `{client_id}` at height `{height}` not found
     UpdateMetaDataNotFound { client_id: ClientId, height: Height },
     /// The given hash of the validators does not matches the given hash in the signed header. Expected: `{signed_header_validators_hash}`, got: `{validators_hash}`
@@ -137,7 +137,9 @@ impl IntoResult<(), Error> for Verdict {
         match self {
             Verdict::Success => Ok(()),
             Verdict::NotEnoughTrust(reason) => Err(Error::NotEnoughTrustedValsSigned { reason }),
-            Verdict::Invalid(detail) => Err(Error::VerificationError { detail }),
+            Verdict::Invalid(detail) => Err(Error::VerificationError {
+                detail: Box::new(detail),
+            }),
         }
     }
 }
diff --git a/ibc-query/Cargo.toml b/ibc-query/Cargo.toml
index bf6c0de1d..7d71d7424 100644
--- a/ibc-query/Cargo.toml
+++ b/ibc-query/Cargo.toml
@@ -18,7 +18,7 @@ description  = """
 displaydoc = { version = "0.2", default-features = false }
 schemars   = { workspace = true , optional = true }
 serde      = { workspace = true, optional = true }
-tonic      = "0.10"
+tonic      = { version = "0.11" }
 
 # ibc dependencies
 ibc       = { workspace = true }

From ddd3f487afb395c02c12c689cf30cf39175c0ba9 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 24 Apr 2024 13:09:57 -0400
Subject: [PATCH 157/182] chore(deps): update MSRV to 1.72 (#1194)

* update msrv to 1.72

* changelog entry

* nit on older changelog
---
 .changelog/unreleased/breaking-changes/1193-bump-msrv.md        | 2 ++
 .../improvements/1171-update-ibc-proto-and-tendermint-deps.md   | 2 +-
 .github/workflows/rust.yml                                      | 2 +-
 Cargo.toml                                                      | 2 +-
 clippy.toml                                                     | 2 +-
 5 files changed, 6 insertions(+), 4 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1193-bump-msrv.md

diff --git a/.changelog/unreleased/breaking-changes/1193-bump-msrv.md b/.changelog/unreleased/breaking-changes/1193-bump-msrv.md
new file mode 100644
index 000000000..11e82593f
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1193-bump-msrv.md
@@ -0,0 +1,2 @@
+- [ibc] Update minimum supported Rust version to 1.72.
+  ([\#1193](https://github.com/cosmos/ibc-rs/issues/1193))
diff --git a/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md b/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
index c4599670b..0b48c06b4 100644
--- a/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
+++ b/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
@@ -1,2 +1,2 @@
 - Update `ibc-proto` to v0.43.0 and `tendermint` dependencies to v0.35.0.
-  ([#1171](https://github.com/cosmos/ibc-rs/issues/1171))
+  ([\#1171](https://github.com/cosmos/ibc-rs/issues/1171))
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yml
index 3bdb7811f..62b194527 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yml
@@ -165,7 +165,7 @@ jobs:
     timeout-minutes: 30
     env:
       CARGO_MSRV_VERSION: 0.16.0-beta.20
-      MSRV: 1.71.1
+      MSRV: 1.72
     strategy:
       matrix:
         param:
diff --git a/Cargo.toml b/Cargo.toml
index 70c351cd9..013dcdf8b 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -45,7 +45,7 @@ exclude = [
 version      = "0.51.0"
 license      = "Apache-2.0"
 edition      = "2021"
-rust-version = "1.71.1"
+rust-version = "1.72"
 readme       = "README.md"
 repository   = "https://github.com/cosmos/ibc-rs"
 authors      = ["Informal Systems <hello@informal.systems>"]
diff --git a/clippy.toml b/clippy.toml
index 76e4dff64..24256e918 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -7,4 +7,4 @@ disallowed-types = [
 disallowed-methods = [
     "std::time::Duration::as_secs_f64",
 ]
-msrv = "1.71.1"
+msrv = "1.72"

From d72fb58692bbe7b8dba6bd153cada9513882fba6 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 24 Apr 2024 13:26:23 -0400
Subject: [PATCH 158/182] chore: miscellaneous repository maintenance (#1174)

* use renamed branch

* conventionalcommits-org is down

* add missing changelog entry

* rename to Makefile

* use native concurrency option

* upgrade substrate deps

* remove redundant nix use

* correct cw-check workflow file

* use yml extension over yml

* delete nix script

* rm merge group trigger and always trigger on main

* rm md link check from main

* forbid concurrent runs for cw and no-std checks

* nit

* use actions-rust-lang/setup-rust-toolchain over actions-rs/toolchain

* imp docker run

* use cosmwasm/optimizer 0.15.1

* correct mount paths

* validate checksum

* .yaml over .yml

https://yaml.org/faq.html

* install cargo binary before wasm compile to avoid docker mount permission

* fix permissions manually

* conventionalcommits.org is up

* update upload cw client action

* correct download path

* update cargo lockfiles

* redundant Swatinem/rust-cache

actions-rust-lang/setup-rust-toolchain@v1 uses it already

* update release workflow
---
 ...1108-fallible-conversion-of-ics23-types.md |   2 +
 .../{code-quality.yml => code-quality.yaml}   |   2 -
 .../workflows/{coverage.yml => coverage.yaml} |  11 +-
 .github/workflows/cw-check.yaml               |  59 +-
 ...ink-check.yml => markdown-link-check.yaml} |   4 -
 .github/workflows/no-std.yaml                 |  33 +-
 .github/workflows/release.yaml                |  22 +-
 .github/workflows/{rust.yml => rust.yaml}     |  66 +-
 .github/workflows/upload-cw-clients.yaml      |  20 +-
 CONTRIBUTING.md                               |   4 +-
 makefile => Makefile                          |   0
 RELEASES.md                                   |   4 +-
 ci/cw-check/Cargo.lock                        |   4 +-
 ci/cw-check/shell.nix                         |  16 -
 ci/no-std-check/Cargo.lock                    | 805 ++++++------------
 ci/no-std-check/Cargo.toml                    |   8 +-
 16 files changed, 371 insertions(+), 689 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md
 rename .github/workflows/{code-quality.yml => code-quality.yaml} (92%)
 rename .github/workflows/{coverage.yml => coverage.yaml} (85%)
 rename .github/workflows/{markdown-link-check.yml => markdown-link-check.yaml} (86%)
 rename .github/workflows/{rust.yml => rust.yaml} (74%)
 rename makefile => Makefile (100%)
 delete mode 100644 ci/cw-check/shell.nix

diff --git a/.changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md b/.changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md
new file mode 100644
index 000000000..3c9b5762a
--- /dev/null
+++ b/.changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md
@@ -0,0 +1,2 @@
+- [ibc-core-commitment-types] Fallible conversion for `ProofSpec`, `LeafOp` and
+  `InnerSpec`. ([\#1108](https://github.com/cosmos/ibc-rs/issues/1108))
diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yaml
similarity index 92%
rename from .github/workflows/code-quality.yml
rename to .github/workflows/code-quality.yaml
index 9b656e1b4..c9e11b972 100644
--- a/.github/workflows/code-quality.yml
+++ b/.github/workflows/code-quality.yaml
@@ -1,8 +1,6 @@
 name: Code Quality Checks
 on:
   pull_request:
-  merge_group:
-    types: [checks_requested]
 
 jobs:
   code-quality:
diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yaml
similarity index 85%
rename from .github/workflows/coverage.yml
rename to .github/workflows/coverage.yaml
index f0e01d793..bd234f66b 100644
--- a/.github/workflows/coverage.yml
+++ b/.github/workflows/coverage.yaml
@@ -2,9 +2,9 @@ name: Coverage
 on:
   pull_request:
     paths:
-      - .codecov.yml
-      - .github/workflows/rust.yml
-      - .github/workflows/coverage.yml
+      - .codecov.yaml
+      - .github/workflows/rust.yaml
+      - .github/workflows/coverage.yaml
       - Cargo.toml
       - ci/**
       - ibc/**
@@ -24,7 +24,7 @@ permissions:
   contents: read
 
 concurrency:
-  group: rust-ci-${{ github.ref }}
+  group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 env:
@@ -43,10 +43,9 @@ jobs:
     steps:
       - uses: actions/checkout@v3
       - name: Install Rust
-        uses: actions-rs/toolchain@v1
+        uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
       - name: Install cargo-llvm-cov
         uses: taiki-e/install-action@cargo-llvm-cov
       - name: Install cargo-nextest
diff --git a/.github/workflows/cw-check.yaml b/.github/workflows/cw-check.yaml
index 38655d83b..b0a66d4e4 100644
--- a/.github/workflows/cw-check.yaml
+++ b/.github/workflows/cw-check.yaml
@@ -2,18 +2,7 @@ name: CosmWasm Compilation Check
 on:
   pull_request:
     paths:
-      - .github/workflows/cw-check.yml
-      - Cargo.toml
-      - Cargo.lock
-      - ci/cw-check/**
-  push:
-    tags:
-      - v[0-9]+.*
-    branches:
-      - "release/*"
-      - main
-    paths:
-      - .github/workflows/cw-check.yml
+      - .github/workflows/cw-check.yaml
       - Cargo.toml
       - Cargo.lock
       - ci/cw-check/**
@@ -25,17 +14,49 @@ on:
       - ibc-clients/**
       - ibc-primitives/**
       - ibc-derive/**
-  merge_group:
-    types: [checks_requested]
+  push:
+    tags:
+      - v[0-9]+.*
+    branches:
+      - "release/*"
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
 
 jobs:
   cw-check:
     runs-on: ubuntu-20.04
     steps:
       - uses: actions/checkout@v4
-      - uses: DeterminateSystems/nix-installer-action@main
-      - uses: DeterminateSystems/magic-nix-cache-action@main
-      - name: Run cw-check
+
+      # only for caching cargo build artifacts from `cosmwasm/optimizer`
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+
+      - name: Create mount directories
+        run: mkdir -p "${HOME}/.cargo/registry" "$(pwd)"/target
+
+      - name: Compile `cw-check`
+        run: |
+          docker run \
+          -v "$(pwd)":/code \
+          -v "$(pwd)"/target:/target \
+          -v "${HOME}/.cargo/registry":/usr/local/cargo/registry \
+          cosmwasm/optimizer:0.15.1 ./ci/cw-check
+
+      - name: Fix permissions
+        run: |
+          sudo chown -R $(id -u):$(id -g) "$(pwd)"/target
+          sudo chown -R $(id -u):$(id -g) "${HOME}/.cargo/registry"
+
+      - name: Install `cosmwasm-check` from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: cosmwasm-check
+
+      - name: Check compiled CosmWasm contract
+        working-directory: artifacts
         run: |
-          cd ci/cw-check
-          nix-shell --run "cw-check"
+          sha256sum -c checksums.txt
+          cosmwasm-check cw_check.wasm
diff --git a/.github/workflows/markdown-link-check.yml b/.github/workflows/markdown-link-check.yaml
similarity index 86%
rename from .github/workflows/markdown-link-check.yml
rename to .github/workflows/markdown-link-check.yaml
index 52a1601ac..6a2932200 100644
--- a/.github/workflows/markdown-link-check.yml
+++ b/.github/workflows/markdown-link-check.yaml
@@ -3,11 +3,7 @@ name: Check Markdown links
 on:
   schedule:
     - cron: "0 0 * * *" # At 00:00
-  push:
-    branches: main
   pull_request:
-  merge_group:
-    types: [checks_requested]
 
 jobs:
   md-link-check:
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 60228dde3..27ba597bf 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -2,7 +2,7 @@ name: no_std check
 on:
   pull_request:
     paths:
-      - .github/workflows/no-std.yml
+      - .github/workflows/no-std.yaml
       - Cargo.toml
       - Cargo.lock
       - ci/no-std-check/**
@@ -15,22 +15,15 @@ on:
       - ibc-primitives/**
       - ibc-derive/**
   push:
-    branches: main
-    paths:
-      - .github/workflows/no-std.yml
-      - Cargo.toml
-      - Cargo.lock
-      - ci/no-std-check/**
-      - ci/**
-      - ibc/**
-      - ibc-core/**
-      - ibc-apps/**
-      - ibc-data-types/**
-      - ibc-clients/**
-      - ibc-primitives/**
-      - ibc-derive/**
-  merge_group:
-    types: [checks_requested]
+    tags:
+      - v[0-9]+.*
+    branches:
+      - "release/*"
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
 
 jobs:
   check-no-std-panic-conflict:
@@ -38,10 +31,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
       - run: |
           cd ci/no-std-check
           make check-no-std
@@ -51,11 +43,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: nightly-2024-02-24
           target: wasm32-unknown-unknown
-          override: true
       - run: |
           cd ci/no-std-check
           make check-substrate
diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
index ade278800..786d1c68f 100644
--- a/.github/workflows/release.yaml
+++ b/.github/workflows/release.yaml
@@ -27,10 +27,13 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      - name: Install cargo-release
-        run: cargo install cargo-release
-      - name: Cache cargo dependencies
-        uses: Swatinem/rust-cache@v2
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+      - name: Install `cargo-release` from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: cargo-release
       - name: Publish crates (dry run)
         run: make check-release
 
@@ -41,10 +44,13 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      - name: Install cargo-release
-        run: cargo install cargo-release
-      - name: Cache cargo dependencies
-        uses: Swatinem/rust-cache@v2
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+        with:
+          toolchain: stable
+      - name: Install `cargo-release` from crates.io
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: cargo-release
       - name: Publish crates
         run: yes | make release
         env:
diff --git a/.github/workflows/rust.yml b/.github/workflows/rust.yaml
similarity index 74%
rename from .github/workflows/rust.yml
rename to .github/workflows/rust.yaml
index 62b194527..a653aabbc 100644
--- a/.github/workflows/rust.yml
+++ b/.github/workflows/rust.yaml
@@ -2,7 +2,7 @@ name: Rust
 on:
   pull_request:
     paths:
-      - .github/workflows/rust.yml
+      - .github/workflows/rust.yaml
       - Cargo.toml
       - ci/**
       - ibc/**
@@ -15,22 +15,15 @@ on:
       - ibc-testkit/**
       - ibc-derive/**
   push:
-    branches: main
-    paths:
-      - .github/workflows/rust.yml
-      - Cargo.toml
-      - ci/**
-      - ibc/**
-      - ibc-core/**
-      - ibc-apps/**
-      - ibc-data-types/**
-      - ibc-clients/**
-      - ibc-primitives/**
-      - ibc-query/**
-      - ibc-testkit/**
-      - ibc-derive/**
-  merge_group:
-    types: [checks_requested]
+    tags:
+      - v[0-9]+.*
+    branches:
+      - "release/*"
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
 
 env:
   CARGO_INCREMENTAL: 0
@@ -41,14 +34,6 @@ env:
   RUSTUP_MAX_RETRIES: 10
 
 jobs:
-  cleanup-runs:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: rokroskar/workflow-run-cleanup-action@master
-        env:
-          GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
-    if: ${{ !startsWith(github.ref, 'refs/tags/') && github.ref != 'refs/heads/main' }}
-
   check-features:
     if: ${{ github.event_name != 'pull_request' }}
     name: Check features
@@ -56,13 +41,11 @@ jobs:
     timeout-minutes: 60
     steps:
       - uses: actions/checkout@v4
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
       - name: Install cargo-hack
         uses: taiki-e/install-action@cargo-hack
-      - uses: Swatinem/rust-cache@v2
       - name: Run cargo hack
         run: make check-features
 
@@ -70,11 +53,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: nightly # Since fmt uses unstable features for organizing imports
           components: rustfmt
-          override: true
       - uses: actions-rs/cargo@v1
         with:
           command: fmt
@@ -84,12 +66,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
           components: clippy
-          override: true
-      - uses: Swatinem/rust-cache@v1
       - uses: actions-rs/clippy-check@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -99,12 +79,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
           components: clippy
-          override: true
-      - uses: Swatinem/rust-cache@v1
       - uses: actions-rs/clippy-check@v1
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -114,11 +92,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
-      - uses: Swatinem/rust-cache@v1
       - uses: actions-rs/cargo@v1
         with:
           command: doc
@@ -128,11 +104,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
-      - uses: Swatinem/rust-cache@v1
       - uses: actions-rs/cargo@v1
         with:
           command: doc
@@ -143,11 +117,9 @@ jobs:
     timeout-minutes: 30
     steps:
       - uses: actions/checkout@v2
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
-          override: true
-      - uses: Swatinem/rust-cache@v1
       - uses: actions-rs/cargo@v1
         with:
           command: test
@@ -184,11 +156,9 @@ jobs:
           version: "tags/v${{ env.CARGO_MSRV_VERSION }}"
           file: "cargo-msrv-x86_64-${{ matrix.param.system }}-v${{ env.CARGO_MSRV_VERSION }}.tgz"
 
-      - uses: actions-rs/toolchain@v1
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: ${{ env.MSRV }}
-          override: true
-      - uses: Swatinem/rust-cache@v1
 
       - name: Install cargo-msrv
         run: |
diff --git a/.github/workflows/upload-cw-clients.yaml b/.github/workflows/upload-cw-clients.yaml
index b67bdf317..224d54bec 100644
--- a/.github/workflows/upload-cw-clients.yaml
+++ b/.github/workflows/upload-cw-clients.yaml
@@ -78,19 +78,17 @@ jobs:
       - name: Upload compiled CosmWasm contract
         uses: actions/upload-artifact@v4
         with:
-          name: tendermint-cw-${{ github.sha }}
+          name: tendermint-cw-client
           path: artifacts/ibc_client_tendermint_cw.wasm
           # Retain the artifact for 1 week for PRs and 3 months for `main` branch
           retention-days: ${{ github.event_name == 'pull_request' && 7 || 90 }}
           overwrite: true
 
-  # # An example workflow to download the artifact:
-  # download-tendermint-cw-client:
-  #   name: Download pre-compiled Tendermint CosmWasm client
-  #   runs-on: ubuntu-latest
-  #   steps:
-  #     - uses: actions/download-artifact@v4
-  #       with:
-  #         name: tendermint-cw-${{ env.IBC_RS_COMMIT_HASH }}
-  #         repository: cosmos/ibc-rs
-  #     - run: ls -l ibc_client_tendermint_cw.wasm
+      # # An example workflow to download the artifact:
+      # - uses: actions/download-artifact@v4
+      #   with:
+      #     name: tendermint-cw-client
+      #     repository: cosmos/ibc-rs
+      #     run-id: ${{ env.UPLOAD_WASM_RUN_ID }}
+      #     github-token: ${{ secrets.GITHUB_TOKEN }}
+      # - run: ls ibc_client_tendermint_cw.wasm
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0e83c5585..5b15898ef 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -123,7 +123,7 @@ these guidelines when opening a pull request:
     changes.
 
 - Commit messages should follow the [Conventional Commits
-  specification](https://www.conventionalcommits.org/en/v1.0.0/).
+  specification](https://www.conventionalcommits.org).
 
 - Make reference to the relevant issue by including `Closes: #<issue number>` in
   the PR’s description to auto-close the related issue once the PR is merged.
@@ -211,7 +211,7 @@ things than users do. Changelogs are for users.
 
 Changelog structure is modeled after [Tendermint
 Core](https://github.com/tendermint/tendermint/blob/master/CHANGELOG.md) and
-[Hashicorp Consul](http://github.com/hashicorp/consul/tree/master/CHANGELOG.md).
+[Hashicorp Consul](http://github.com/hashicorp/consul/tree/main/CHANGELOG.md).
 See those changelogs for examples.
 
 We currently split changes for a given release between these four sections:
diff --git a/makefile b/Makefile
similarity index 100%
rename from makefile
rename to Makefile
diff --git a/RELEASES.md b/RELEASES.md
index 6d10f734d..881f7c9b5 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -34,7 +34,7 @@ Our release process is as follows:
 8. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
    version and the link to the corresponding section of the changelog. Then push
    the tag to GitHub with `git push origin vX.Y.Z`.
-   - The [release workflow][release.yml] will run the `cargo release --execute`
+   - The [release workflow][release.yaml] will run the `cargo release --execute`
    command in a CI worker.
 9. If some crates have not been released, check the cause of the failure and
    act accordingly:
@@ -56,4 +56,4 @@ Our release process is as follows:
 All done! 🎉
 
 [crates.io]: https://crates.io
-[release.yml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yaml
+[release.yaml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yaml
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 1e15c0efa..69876a2c1 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -1644,9 +1644,9 @@ dependencies = [
 
 [[package]]
 name = "zeroize"
-version = "1.7.0"
+version = "1.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
+checksum = "63381fa6624bf92130a6b87c0d07380116f80b565c42cf0d754136f0238359ef"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ci/cw-check/shell.nix b/ci/cw-check/shell.nix
deleted file mode 100644
index 3482d1228..000000000
--- a/ci/cw-check/shell.nix
+++ /dev/null
@@ -1,16 +0,0 @@
-# install nix and `nix-shell` in this directory, run `cw-check` command
-{ pkgs ? import <nixpkgs> { overlays = [ (import (builtins.fetchTarball "https://github.com/oxalica/rust-overlay/archive/refs/heads/stable.zip")) ]; } }:
-let
-  rust-as-on-ci = pkgs.rust-bin.fromRustupToolchainFile ./rust-toolchain.toml;
-  cw-check = pkgs.writeShellApplication rec {
-    name = "cw-check";
-    runtimeInputs = [ rust-as-on-ci ];
-    text = ''
-        cargo build --target wasm32-unknown-unknown --no-default-features --release
-        nix run github:informalsystems/cosmos.nix#cosmwasm-check ./target/wasm32-unknown-unknown/release/cw_check.wasm
-    '';
-  };
-in
-pkgs.mkShell {
-  nativeBuildInputs = [ rust-as-on-ci cw-check];
-}
\ No newline at end of file
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index cad12ee79..4c35268f5 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -12,22 +12,13 @@ dependencies = [
  "regex",
 ]
 
-[[package]]
-name = "addr2line"
-version = "0.19.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a76fd60b23679b7d19bd066031410fb7e458ccc5e958eb5c325888ce4baedc97"
-dependencies = [
- "gimli 0.27.3",
-]
-
 [[package]]
 name = "addr2line"
 version = "0.21.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8a30b2e23b9e17a9f90641c7ab1549cd9b44f296d3ccbf309d2863cfe398a0cb"
 dependencies = [
- "gimli 0.28.1",
+ "gimli",
 ]
 
 [[package]]
@@ -268,15 +259,21 @@ version = "0.3.71"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "26b05800d2e817c8b3b4b54abd461726265fa9789ae34330622f2db9ee696f9d"
 dependencies = [
- "addr2line 0.21.0",
+ "addr2line",
  "cc",
  "cfg-if",
  "libc",
  "miniz_oxide",
- "object 0.32.2",
+ "object",
  "rustc-demangle",
 ]
 
+[[package]]
+name = "base16ct"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c7f02d4ea65f2c1853089ffd8d2787bdbc63de2f0d29dedbcf8ccdfa0ccd4cf"
+
 [[package]]
 name = "base64"
 version = "0.13.1"
@@ -302,45 +299,27 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8c3c1a368f70d6cf7302d78f8f7093da241fb8e8807c05cc9e51a125895a6d5b"
 
 [[package]]
-name = "bincode"
-version = "1.3.3"
+name = "bitcoin-internals"
+version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b1f45e9417d87227c7a56d22e471c6206462cba514c7590c09aff4cf6d1ddcad"
-dependencies = [
- "serde",
-]
+checksum = "9425c3bf7089c983facbae04de54513cce73b41c7f9ff8c845b54e7bc64ebbfb"
 
 [[package]]
-name = "bip39"
-version = "2.0.0"
+name = "bitcoin_hashes"
+version = "0.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "93f2635620bf0b9d4576eb7bb9a38a55df78bd1205d26fa994b25911a69f212f"
+checksum = "1930a4dabfebb8d7d9992db18ebe3ae2876f0a305fab206fd168df931ede293b"
 dependencies = [
- "bitcoin_hashes",
- "rand",
- "rand_core 0.6.4",
- "serde",
- "unicode-normalization",
+ "bitcoin-internals",
+ "hex-conservative",
 ]
 
-[[package]]
-name = "bitcoin_hashes"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "90064b8dee6815a6470d60bad07bbbaee885c0e12d04177138fa3291a01b7bc4"
-
 [[package]]
 name = "bitflags"
 version = "1.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
-[[package]]
-name = "bitflags"
-version = "2.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cf4b9d6a944f767f8e5e0db018570623c85f3d925ac718db4e06d0187adb21c1"
-
 [[package]]
 name = "bitvec"
 version = "1.0.1"
@@ -451,9 +430,9 @@ dependencies = [
 
 [[package]]
 name = "bounded-collections"
-version = "0.1.9"
+version = "0.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ca548b6163b872067dc5eb82fd130c56881435e30367d2073594a3d9744120dd"
+checksum = "d32385ecb91a31bddaf908e8dcf4a15aef1bcd3913cc03ebfad02ff6d568abc1"
 dependencies = [
  "log",
  "parity-scale-codec",
@@ -551,15 +530,6 @@ version = "0.8.6"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "06ea2b9bc92be3c2baa9334a323ebca2d6f074ff852cd1d7b11064035cd3868f"
 
-[[package]]
-name = "cpp_demangle"
-version = "0.3.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eeaa953eaad386a53111e47172c2fedba671e5684c8dd601a5f474f4f118710f"
-dependencies = [
- "cfg-if",
-]
-
 [[package]]
 name = "cpufeatures"
 version = "0.2.12"
@@ -570,29 +540,23 @@ dependencies = [
 ]
 
 [[package]]
-name = "cranelift-entity"
-version = "0.95.1"
+name = "crunchy"
+version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "40099d38061b37e505e63f89bab52199037a72b931ad4868d9089ff7268660b0"
-dependencies = [
- "serde",
-]
+checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7"
 
 [[package]]
-name = "crc32fast"
-version = "1.4.0"
+name = "crypto-bigint"
+version = "0.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b3855a8a784b474f333699ef2bbca9db2c4a1f6d9088a90a2d25b1eb53111eaa"
+checksum = "0dc92fb57ca44df6db8059111ab3af99a63d5d0f8375d9972e319a379c6bab76"
 dependencies = [
- "cfg-if",
+ "generic-array",
+ "rand_core 0.6.4",
+ "subtle",
+ "zeroize",
 ]
 
-[[package]]
-name = "crunchy"
-version = "0.2.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7a81dae078cea95a014a339291cec439d2f232ebe854a9d672b796c6afafa9b7"
-
 [[package]]
 name = "crypto-common"
 version = "0.1.6"
@@ -614,16 +578,6 @@ dependencies = [
  "subtle",
 ]
 
-[[package]]
-name = "crypto-mac"
-version = "0.11.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "25fab6889090c8133f3deb8f73ba3c65a7f456f66436fc012a1b1e272b1e103e"
-dependencies = [
- "generic-array",
- "subtle",
-]
-
 [[package]]
 name = "curve25519-dalek"
 version = "3.2.0"
@@ -746,6 +700,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
 dependencies = [
  "block-buffer 0.10.4",
+ "const-oid",
  "crypto-common",
  "subtle",
 ]
@@ -815,6 +770,21 @@ version = "1.0.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "0d6ef0072f8a535281e4876be788938b528e9a1d43900b82c2569af7da799125"
 
+[[package]]
+name = "ecdsa"
+version = "0.16.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ee27f32b5c5292967d2d4a9d7f1e0b0aed2c15daded5a60300e4abb9d8020bca"
+dependencies = [
+ "der",
+ "digest 0.10.7",
+ "elliptic-curve",
+ "rfc6979",
+ "serdect",
+ "signature",
+ "spki",
+]
+
 [[package]]
 name = "ed25519"
 version = "2.2.3"
@@ -872,6 +842,26 @@ version = "1.11.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "a47c1c47d2f5964e29c61246e81db715514cd532db6b5116a25ea3c03d6780a2"
 
+[[package]]
+name = "elliptic-curve"
+version = "0.13.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b5e6043086bf7973472e0c7dff2142ea0b680d30e18d9cc40f267efbf222bd47"
+dependencies = [
+ "base16ct",
+ "crypto-bigint",
+ "digest 0.10.7",
+ "ff",
+ "generic-array",
+ "group",
+ "pkcs8",
+ "rand_core 0.6.4",
+ "sec1",
+ "serdect",
+ "subtle",
+ "zeroize",
+]
+
 [[package]]
 name = "environmental"
 version = "1.1.4"
@@ -884,16 +874,6 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "5443807d6dff69373d433ab9ef5378ad8df50ca6298caf15de6e52e24aaf54d5"
 
-[[package]]
-name = "errno"
-version = "0.3.8"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a258e46cdc063eb8519c00b9fc845fc47bcfca4130e2f08e88665ceda8474245"
-dependencies = [
- "libc",
- "windows-sys 0.52.0",
-]
-
 [[package]]
 name = "expander"
 version = "2.1.0"
@@ -909,10 +889,14 @@ dependencies = [
 ]
 
 [[package]]
-name = "fallible-iterator"
-version = "0.2.0"
+name = "ff"
+version = "0.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4443176a9f2c162692bd3d352d745ef9413eec5782a80d8fd6f8a1ac692a07f7"
+checksum = "ded41244b729663b1e574f1b4fb731469f69f79c17667b5d776b16cda0479449"
+dependencies = [
+ "rand_core 0.6.4",
+ "subtle",
+]
 
 [[package]]
 name = "fiat-crypto"
@@ -941,15 +925,6 @@ dependencies = [
  "paste",
 ]
 
-[[package]]
-name = "form_urlencoded"
-version = "1.2.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e13624c2627564efccf4934284bdd98cbaa14e79b0b5a141218e507b3a823456"
-dependencies = [
- "percent-encoding",
-]
-
 [[package]]
 name = "fs-err"
 version = "2.11.0"
@@ -1063,6 +1038,7 @@ checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
 dependencies = [
  "typenum",
  "version_check",
+ "zeroize",
 ]
 
 [[package]]
@@ -1088,20 +1064,20 @@ dependencies = [
 
 [[package]]
 name = "gimli"
-version = "0.27.3"
+version = "0.28.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b6c80984affa11d98d1b88b66ac8853f143217b399d3c74116778ff8fdb4ed2e"
-dependencies = [
- "fallible-iterator",
- "indexmap 1.9.3",
- "stable_deref_trait",
-]
+checksum = "4271d37baee1b8c7e4b708028c57d816cf9d2434acb33a549475f78c181f6253"
 
 [[package]]
-name = "gimli"
-version = "0.28.1"
+name = "group"
+version = "0.13.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4271d37baee1b8c7e4b708028c57d816cf9d2434acb33a549475f78c181f6253"
+checksum = "f0f9ef7462f7c099f518d754361858f86d8a07af53ba9af0fe635bbccb151a63"
+dependencies = [
+ "ff",
+ "rand_core 0.6.4",
+ "subtle",
+]
 
 [[package]]
 name = "hash-db"
@@ -1154,24 +1130,29 @@ version = "0.4.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
 
+[[package]]
+name = "hex-conservative"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "30ed443af458ccb6d81c1e7e661545f94d3176752fb1df2f543b902a1e0f51e2"
+
 [[package]]
 name = "hmac"
 version = "0.8.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "126888268dcc288495a26bf004b38c5fdbb31682f992c84ceb046a1f0fe38840"
 dependencies = [
- "crypto-mac 0.8.0",
+ "crypto-mac",
  "digest 0.9.0",
 ]
 
 [[package]]
 name = "hmac"
-version = "0.11.0"
+version = "0.12.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2a2a2320eb7ec0ebe8da8f744d7812d9fc4cb4d09344ac01898dbcb6a20ae69b"
+checksum = "6c49c37c09c17a53d937dfbb742eb3a961d65a994e6bcdcf37e7399d0cc8ab5e"
 dependencies = [
- "crypto-mac 0.11.0",
- "digest 0.9.0",
+ "digest 0.10.7",
 ]
 
 [[package]]
@@ -1601,16 +1582,6 @@ dependencies = [
  "sha3",
 ]
 
-[[package]]
-name = "idna"
-version = "0.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "634d9b1461af396cad843f47fdba5597a4f9e6ddd4bfb6ff5d85028c25cb12f6"
-dependencies = [
- "unicode-bidi",
- "unicode-normalization",
-]
-
 [[package]]
 name = "impl-codec"
 version = "0.6.0"
@@ -1640,17 +1611,6 @@ dependencies = [
  "syn 1.0.109",
 ]
 
-[[package]]
-name = "indexmap"
-version = "1.9.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "bd070e393353796e801d209ad339e89596eb4c8d430d18ede6a1cced8fafbd99"
-dependencies = [
- "autocfg",
- "hashbrown 0.12.3",
- "serde",
-]
-
 [[package]]
 name = "indexmap"
 version = "2.2.6"
@@ -1680,17 +1640,6 @@ dependencies = [
  "num-traits",
 ]
 
-[[package]]
-name = "io-lifetimes"
-version = "1.0.11"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "eae7b9aee968036d54dce06cebaefd919e4472e753296daccd6d344e3e2df0c2"
-dependencies = [
- "hermit-abi",
- "libc",
- "windows-sys 0.48.0",
-]
-
 [[package]]
 name = "itertools"
 version = "0.10.5"
@@ -1724,6 +1673,20 @@ dependencies = [
  "wasm-bindgen",
 ]
 
+[[package]]
+name = "k256"
+version = "0.13.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "956ff9b67e26e1a6a866cb758f12c6f8746208489e3e4a4b5580802f2f0a587b"
+dependencies = [
+ "cfg-if",
+ "ecdsa",
+ "elliptic-curve",
+ "once_cell",
+ "serdect",
+ "sha2 0.10.8",
+]
+
 [[package]]
 name = "keccak"
 version = "0.1.5"
@@ -1793,18 +1756,6 @@ dependencies = [
  "libsecp256k1-core",
 ]
 
-[[package]]
-name = "linux-raw-sys"
-version = "0.1.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f051f77a7c8e6957c0696eac88f26b0117e54f52d3fc682ab19397a8812846a4"
-
-[[package]]
-name = "linux-raw-sys"
-version = "0.4.13"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "01cda141df6706de531b6c46c3a33ecca755538219bd484262fa09410c13539c"
-
 [[package]]
 name = "lock_api"
 version = "0.4.11"
@@ -1821,15 +1772,6 @@ version = "0.4.21"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "90ed8c1e510134f979dbc4f070f87d4313098b704861a105fe34231c70a3901c"
 
-[[package]]
-name = "mach"
-version = "0.3.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b823e83b2affd8f40a9ee8c29dbc56404c1e34cd2710921f2801e2cf29527afa"
-dependencies = [
- "libc",
-]
-
 [[package]]
 name = "matchers"
 version = "0.0.1"
@@ -1845,24 +1787,6 @@ version = "2.7.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6c8640c5d730cb13ebd907d8d04b52f55ac9a2eec55b440c8892f40d56c76c1d"
 
-[[package]]
-name = "memfd"
-version = "0.6.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b2cffa4ad52c6f791f4f8b15f0c05f9824b2ced1160e88cc393d64fff9a8ac64"
-dependencies = [
- "rustix 0.38.34",
-]
-
-[[package]]
-name = "memoffset"
-version = "0.8.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d61c719bcfbcf5d62b3a09efa6088de8c54bc0bfcd3ea7ae39fcc186108b8de1"
-dependencies = [
- "autocfg",
-]
-
 [[package]]
 name = "memory-db"
 version = "0.32.0"
@@ -1981,18 +1905,6 @@ dependencies = [
  "libc",
 ]
 
-[[package]]
-name = "object"
-version = "0.30.4"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "03b4680b86d9cfafba8fc491dc9b6df26b68cf40e9e6cd73909194759a63c385"
-dependencies = [
- "crc32fast",
- "hashbrown 0.13.2",
- "indexmap 1.9.3",
- "memchr",
-]
-
 [[package]]
 name = "object"
 version = "0.32.2"
@@ -2014,6 +1926,19 @@ version = "0.3.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "c08d65885ee38876c4f86fa503fb49d7b507c2b62552df7c70b2fce627e06381"
 
+[[package]]
+name = "parity-bip39"
+version = "2.0.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4e69bf016dc406eff7d53a7d3f7cf1c2e72c82b9088aac1118591e36dd2cd3e9"
+dependencies = [
+ "bitcoin_hashes",
+ "rand",
+ "rand_core 0.6.4",
+ "serde",
+ "unicode-normalization",
+]
+
 [[package]]
 name = "parity-scale-codec"
 version = "3.6.9"
@@ -2064,6 +1989,17 @@ dependencies = [
  "windows-targets 0.48.5",
 ]
 
+[[package]]
+name = "password-hash"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "346f04948ba92c43e8469c1ee6736c7563d71012b17d40745260fe106aac2166"
+dependencies = [
+ "base64ct",
+ "rand_core 0.6.4",
+ "subtle",
+]
+
 [[package]]
 name = "paste"
 version = "1.0.14"
@@ -2072,19 +2008,14 @@ checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
 
 [[package]]
 name = "pbkdf2"
-version = "0.8.0"
+version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d95f5254224e617595d2cc3cc73ff0a5eaf2637519e25f03388154e9378b6ffa"
+checksum = "f8ed6a7761f76e3b9f92dfb0a60a6a6477c61024b775147ff0973a02653abaf2"
 dependencies = [
- "crypto-mac 0.11.0",
+ "digest 0.10.7",
+ "password-hash",
 ]
 
-[[package]]
-name = "percent-encoding"
-version = "2.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e3148f5046208a5d56bcfc03053e3ca6334e51da8dfb19b6cdc8b306fae3283e"
-
 [[package]]
 name = "pin-project-lite"
 version = "0.2.14"
@@ -2113,6 +2044,43 @@ version = "3.4.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "db23d408679286588f4d4644f965003d056e3dd5abcaaa938116871d7ce2fee7"
 
+[[package]]
+name = "polkavm-common"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1d9428a5cfcc85c5d7b9fc4b6a18c4b802d0173d768182a51cc7751640f08b92"
+
+[[package]]
+name = "polkavm-derive"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ae8c4bea6f3e11cd89bb18bcdddac10bd9a24015399bd1c485ad68a985a19606"
+dependencies = [
+ "polkavm-derive-impl-macro",
+]
+
+[[package]]
+name = "polkavm-derive-impl"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5c4fdfc49717fb9a196e74a5d28e0bc764eb394a2c803eb11133a31ac996c60c"
+dependencies = [
+ "polkavm-common",
+ "proc-macro2",
+ "quote",
+ "syn 2.0.60",
+]
+
+[[package]]
+name = "polkavm-derive-impl-macro"
+version = "0.9.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ba81f7b5faac81e528eb6158a6f3c9e0bb1008e0ffa19653bc8dea925ecb429"
+dependencies = [
+ "polkavm-derive-impl",
+ "syn 2.0.60",
+]
+
 [[package]]
 name = "powerfmt"
 version = "0.2.0"
@@ -2226,15 +2194,6 @@ dependencies = [
  "prost",
 ]
 
-[[package]]
-name = "psm"
-version = "0.1.21"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5787f7cda34e3033a72192c018bc5883100330f362ef279a8cbccfce8bb4e874"
-dependencies = [
- "cc",
-]
-
 [[package]]
 name = "quote"
 version = "1.0.36"
@@ -2292,7 +2251,7 @@ version = "0.4.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa"
 dependencies = [
- "bitflags 1.3.2",
+ "bitflags",
 ]
 
 [[package]]
@@ -2359,6 +2318,16 @@ version = "0.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "adad44e29e4c806119491a7f06f03de4d1af22c3a680dd47f1e6e179439d1f56"
 
+[[package]]
+name = "rfc6979"
+version = "0.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f8dd2a808d456c4a54e300a23e9f5a67e122c3024119acbfd73e3bf664491cb2"
+dependencies = [
+ "hmac 0.12.1",
+ "subtle",
+]
+
 [[package]]
 name = "ripemd"
 version = "0.1.3"
@@ -2389,33 +2358,6 @@ dependencies = [
  "semver",
 ]
 
-[[package]]
-name = "rustix"
-version = "0.36.17"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "305efbd14fde4139eb501df5f136994bb520b033fa9fbdce287507dc23b8c7ed"
-dependencies = [
- "bitflags 1.3.2",
- "errno",
- "io-lifetimes",
- "libc",
- "linux-raw-sys 0.1.4",
- "windows-sys 0.45.0",
-]
-
-[[package]]
-name = "rustix"
-version = "0.38.34"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "70dc5ec042f7a43c4a73241207cecc9873a06d45debb38b329f8541d85c2730f"
-dependencies = [
- "bitflags 2.5.0",
- "errno",
- "libc",
- "linux-raw-sys 0.4.13",
- "windows-sys 0.52.0",
-]
-
 [[package]]
 name = "rustversion"
 version = "1.0.15"
@@ -2499,6 +2441,21 @@ version = "1.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "94143f37725109f92c262ed2cf5e59bce7498c01bcc1502d7b9afe439a4e9f49"
 
+[[package]]
+name = "sec1"
+version = "0.7.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d3e97a565f76233a6003f9f5c54be1d9c5bdfa3eccfb189469f11ec4901c47dc"
+dependencies = [
+ "base16ct",
+ "der",
+ "generic-array",
+ "pkcs8",
+ "serdect",
+ "subtle",
+ "zeroize",
+]
+
 [[package]]
 name = "secp256k1"
 version = "0.28.2"
@@ -2601,6 +2558,16 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "serdect"
+version = "0.2.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a84f14a19e9a014bb9f4512488d9829a68e04ecabffb0f9904cd1ace94598177"
+dependencies = [
+ "base16ct",
+ "serde",
+]
+
 [[package]]
 name = "sha2"
 version = "0.9.9"
@@ -2650,6 +2617,7 @@ version = "2.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
 dependencies = [
+ "digest 0.10.7",
  "rand_core 0.6.4",
 ]
 
@@ -2676,9 +2644,9 @@ checksum = "3c5e1a9a646d36c3599cd173a41282daf47c44583ad367b8e6837255952e5c67"
 
 [[package]]
 name = "sp-application-crypto"
-version = "30.0.0"
+version = "34.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e4fe7a9b7fa9da76272b201e2fb3c7900d97d32a46b66af9a04dad457f73c71"
+checksum = "1505fad69251900048ddddc6387265e1545d1a366e3b4dcd57b76a03f0a65ae7"
 dependencies = [
  "parity-scale-codec",
  "scale-info",
@@ -2690,10 +2658,11 @@ dependencies = [
 
 [[package]]
 name = "sp-arithmetic"
-version = "23.0.0"
+version = "26.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f42721f072b421f292a072e8f52a3b3c0fbc27428f0c9fe24067bc47046bad63"
+checksum = "46d0d0a4c591c421d3231ddd5e27d828618c24456d51445d21a1f79fcee97c23"
 dependencies = [
+ "docify",
  "integer-sqrt",
  "num-traits",
  "parity-scale-codec",
@@ -2705,13 +2674,12 @@ dependencies = [
 
 [[package]]
 name = "sp-core"
-version = "28.0.0"
+version = "32.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f230cb12575455070da0fc174815958423a0b9a641d5e304a9457113c7cb4007"
+checksum = "bb2dac7e47c7ddbb61efe196d5cce99f6ea88926c961fa39909bfeae46fc5a7b"
 dependencies = [
  "array-bytes",
- "bip39",
- "bitflags 1.3.2",
+ "bitflags",
  "blake2",
  "bounded-collections",
  "bs58",
@@ -2722,9 +2690,11 @@ dependencies = [
  "hash256-std-hasher",
  "impl-serde",
  "itertools 0.10.5",
+ "k256",
  "libsecp256k1",
  "log",
  "merlin",
+ "parity-bip39",
  "parity-scale-codec",
  "parking_lot",
  "paste",
@@ -2735,7 +2705,7 @@ dependencies = [
  "secp256k1",
  "secrecy",
  "serde",
- "sp-core-hashing",
+ "sp-crypto-hashing",
  "sp-debug-derive",
  "sp-externalities",
  "sp-runtime-interface",
@@ -2750,10 +2720,10 @@ dependencies = [
 ]
 
 [[package]]
-name = "sp-core-hashing"
-version = "15.0.0"
+name = "sp-crypto-hashing"
+version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1e0f4990add7b2cefdeca883c0efa99bb4d912cb2196120e1500c0cc099553b0"
+checksum = "bc9927a7f81334ed5b8a98a4a978c81324d12bd9713ec76b5c68fd410174c5eb"
 dependencies = [
  "blake2b_simd",
  "byteorder",
@@ -2776,30 +2746,31 @@ dependencies = [
 
 [[package]]
 name = "sp-externalities"
-version = "0.25.0"
+version = "0.28.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63867ec85950ced90d4ab1bba902a47db1b1efdf2829f653945669b2bb470a9c"
+checksum = "33abaec4be69b1613796bbf430decbbcaaf978756379e2016e683a4d6379cd02"
 dependencies = [
  "environmental",
  "parity-scale-codec",
- "sp-std",
  "sp-storage",
 ]
 
 [[package]]
 name = "sp-io"
-version = "30.0.0"
+version = "34.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c55f26d89feedaf0faf81688b6e1e1e81329cd8b4c6a4fd6c5b97ed9dd068b8a"
+checksum = "c44ed47247b6eee76ff703f9fa9f04f99c4104ac1faf629e6d1128e09066b57b"
 dependencies = [
  "bytes",
  "ed25519-dalek",
  "libsecp256k1",
  "log",
  "parity-scale-codec",
+ "polkavm-derive",
  "rustversion",
  "secp256k1",
  "sp-core",
+ "sp-crypto-hashing",
  "sp-externalities",
  "sp-keystore",
  "sp-runtime-interface",
@@ -2813,15 +2784,14 @@ dependencies = [
 
 [[package]]
 name = "sp-keystore"
-version = "0.34.0"
+version = "0.38.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "96806a28a62ed9ddecd0b28857b1344d029390f7c5c42a2ff9199cbf5638635c"
+checksum = "4e6c7a7abd860a5211a356cf9d5fcabf0eb37d997985e5d722b6b33dcc815528"
 dependencies = [
  "parity-scale-codec",
  "parking_lot",
  "sp-core",
  "sp-externalities",
- "thiserror",
 ]
 
 [[package]]
@@ -2837,9 +2807,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime"
-version = "31.0.1"
+version = "35.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a3bb49a4475d390198dfd3d41bef4564ab569fbaf1b5e38ae69b35fc01199d91"
+checksum = "42ce931b7fbfdeeca1340801dbd4a1cae54ad4c97a1e3dcfcc79709bc800dd46"
 dependencies = [
  "docify",
  "either",
@@ -2862,13 +2832,14 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface"
-version = "24.0.0"
+version = "27.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f66b66d8cec3d785fa6289336c1d9cbd4305d5d84f7134378c4d79ed7983e6fb"
+checksum = "647db5e1dc481686628b41554e832df6ab400c4b43a6a54e54d3b0a71ca404aa"
 dependencies = [
  "bytes",
  "impl-trait-for-tuples",
  "parity-scale-codec",
+ "polkavm-derive",
  "primitive-types",
  "sp-externalities",
  "sp-runtime-interface-proc-macro",
@@ -2881,9 +2852,9 @@ dependencies = [
 
 [[package]]
 name = "sp-runtime-interface-proc-macro"
-version = "17.0.0"
+version = "18.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "cfaf6e85b2ec12a4b99cd6d8d57d083e30c94b7f1b0d8f93547121495aae6f0c"
+checksum = "0195f32c628fee3ce1dfbbf2e7e52a30ea85f3589da9fe62a8b816d70fc06294"
 dependencies = [
  "Inflector",
  "expander",
@@ -2895,9 +2866,9 @@ dependencies = [
 
 [[package]]
 name = "sp-state-machine"
-version = "0.35.0"
+version = "0.39.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "718c779ad1d6fcc0be64c7ce030b33fa44b5c8914b3a1319ef63bb5f27fb98df"
+checksum = "21d9078306c3066f1824e41153e1ceec34231d39d9a7e7956b101eadf7b9fd3a"
 dependencies = [
  "hash-db",
  "log",
@@ -2908,7 +2879,6 @@ dependencies = [
  "sp-core",
  "sp-externalities",
  "sp-panic-handler",
- "sp-std",
  "sp-trie",
  "thiserror",
  "tracing",
@@ -2923,26 +2893,24 @@ checksum = "12f8ee986414b0a9ad741776762f4083cd3a5128449b982a3919c4df36874834"
 
 [[package]]
 name = "sp-storage"
-version = "19.0.0"
+version = "21.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1fb92d7b24033a8a856d6e20dd980b653cbd7af7ec471cc988b1b7c1d2e3a32b"
+checksum = "99c82989b3a4979a7e1ad848aad9f5d0b4388f1f454cc131766526601ab9e8f8"
 dependencies = [
  "impl-serde",
  "parity-scale-codec",
  "ref-cast",
  "serde",
  "sp-debug-derive",
- "sp-std",
 ]
 
 [[package]]
 name = "sp-tracing"
-version = "16.0.0"
+version = "17.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0351810b9d074df71c4514c5228ed05c250607cba131c1c9d1526760ab69c05c"
+checksum = "90b3decf116db9f1dfaf1f1597096b043d0e12c952d3bcdc018c6d6b77deec7e"
 dependencies = [
  "parity-scale-codec",
- "sp-std",
  "tracing",
  "tracing-core",
  "tracing-subscriber",
@@ -2950,9 +2918,9 @@ dependencies = [
 
 [[package]]
 name = "sp-trie"
-version = "29.0.0"
+version = "33.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2e4d24d84a0beb44a71dcac1b41980e1edf7fb722c7f3046710136a283cd479b"
+checksum = "d1f5b3620a1c87c265a83d85d7519c6b60c47acf7f77593966afe313d086f00e"
 dependencies = [
  "ahash 0.8.11",
  "hash-db",
@@ -2966,7 +2934,6 @@ dependencies = [
  "schnellru",
  "sp-core",
  "sp-externalities",
- "sp-std",
  "thiserror",
  "tracing",
  "trie-db",
@@ -2975,23 +2942,20 @@ dependencies = [
 
 [[package]]
 name = "sp-wasm-interface"
-version = "20.0.0"
+version = "21.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ef97172c42eb4c6c26506f325f48463e9bc29b2034a587f1b9e48c751229bee"
+checksum = "3b04b919e150b4736d85089d49327eab65507deb1485eec929af69daa2278eb3"
 dependencies = [
- "anyhow",
  "impl-trait-for-tuples",
  "log",
  "parity-scale-codec",
- "sp-std",
- "wasmtime",
 ]
 
 [[package]]
 name = "sp-weights"
-version = "27.0.0"
+version = "31.0.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9e874bdf9dd3fd3242f5b7867a4eaedd545b02f29041a46d222a9d9d5caaaa5c"
+checksum = "93cdaf72a1dad537bbb130ba4d47307ebe5170405280ed1aa31fa712718a400e"
 dependencies = [
  "bounded-collections",
  "parity-scale-codec",
@@ -3000,7 +2964,6 @@ dependencies = [
  "smallvec",
  "sp-arithmetic",
  "sp-debug-derive",
- "sp-std",
 ]
 
 [[package]]
@@ -3028,12 +2991,6 @@ dependencies = [
  "unicode-xid",
 ]
 
-[[package]]
-name = "stable_deref_trait"
-version = "1.2.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a8f112729512f8e442d81f95a8a7ddf2b7c6b8a1a6f509a95864142b30cab2d3"
-
 [[package]]
 name = "static_assertions"
 version = "1.1.0"
@@ -3042,14 +2999,14 @@ checksum = "a2eb9349b6444b326872e140eb1cf5e7c522154d69e7a0ffb0fb81c06b37543f"
 
 [[package]]
 name = "substrate-bip39"
-version = "0.4.6"
+version = "0.6.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6a7590dc041b9bc2825e52ce5af8416c73dbe9d0654402bfd4b4941938b94d8f"
+checksum = "ca58ffd742f693dc13d69bdbb2e642ae239e0053f6aab3b104252892f856700a"
 dependencies = [
- "hmac 0.11.0",
+ "hmac 0.12.1",
  "pbkdf2",
  "schnorrkel",
- "sha2 0.9.9",
+ "sha2 0.10.8",
  "zeroize",
 ]
 
@@ -3102,12 +3059,6 @@ version = "1.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369"
 
-[[package]]
-name = "target-lexicon"
-version = "0.12.14"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e1fc403891a21bcfb7c37834ba66a547a8f402146eba7265b5a6d88059c9ff2f"
-
 [[package]]
 name = "tendermint"
 version = "0.35.0"
@@ -3287,7 +3238,7 @@ version = "0.19.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
 dependencies = [
- "indexmap 2.2.6",
+ "indexmap",
  "toml_datetime",
  "winnow 0.5.40",
 ]
@@ -3298,7 +3249,7 @@ version = "0.20.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "70f427fce4d84c72b5b732388bf4a9f4531b53f74e2887e3ecb2481f68f66d81"
 dependencies = [
- "indexmap 2.2.6",
+ "indexmap",
  "toml_datetime",
  "winnow 0.5.40",
 ]
@@ -3309,7 +3260,7 @@ version = "0.21.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6a8534fd7f78b5405e860340ad6575217ce99f38d4d5c8f2442cb5ecb50090e1"
 dependencies = [
- "indexmap 2.2.6",
+ "indexmap",
  "toml_datetime",
  "winnow 0.5.40",
 ]
@@ -3320,7 +3271,7 @@ version = "0.22.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "d3328d4f68a705b2a4498da1d580585d39a6510f98318a2cec3018a7ec61ddef"
 dependencies = [
- "indexmap 2.2.6",
+ "indexmap",
  "serde",
  "serde_spanned",
  "toml_datetime",
@@ -3454,12 +3405,6 @@ dependencies = [
  "static_assertions",
 ]
 
-[[package]]
-name = "unicode-bidi"
-version = "0.3.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "08f95100a766bf4f8f28f90d77e0a5461bbdb219042e7679bebe79004fed8d75"
-
 [[package]]
 name = "unicode-ident"
 version = "1.0.12"
@@ -3481,17 +3426,6 @@ version = "0.2.4"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f962df74c8c05a667b5ee8bcf162993134c104e96440b663c8daa176dc772d8c"
 
-[[package]]
-name = "url"
-version = "2.5.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "31e6302e3bb753d46e83516cae55ae196fc0c309407cf11ab35cc51a4c2a4633"
-dependencies = [
- "form_urlencoded",
- "idna",
- "percent-encoding",
-]
-
 [[package]]
 name = "valuable"
 version = "0.1.0"
@@ -3598,148 +3532,6 @@ version = "0.2.92"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "af190c94f2773fdb3729c55b007a722abb5384da03bc0986df4c289bf5567e96"
 
-[[package]]
-name = "wasmparser"
-version = "0.102.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "48134de3d7598219ab9eaf6b91b15d8e50d31da76b8519fe4ecfcec2cf35104b"
-dependencies = [
- "indexmap 1.9.3",
- "url",
-]
-
-[[package]]
-name = "wasmtime"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f907fdead3153cb9bfb7a93bbd5b62629472dc06dee83605358c64c52ed3dda9"
-dependencies = [
- "anyhow",
- "bincode",
- "cfg-if",
- "indexmap 1.9.3",
- "libc",
- "log",
- "object 0.30.4",
- "once_cell",
- "paste",
- "psm",
- "serde",
- "target-lexicon",
- "wasmparser",
- "wasmtime-environ",
- "wasmtime-jit",
- "wasmtime-runtime",
- "windows-sys 0.45.0",
-]
-
-[[package]]
-name = "wasmtime-asm-macros"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d3b9daa7c14cd4fa3edbf69de994408d5f4b7b0959ac13fa69d465f6597f810d"
-dependencies = [
- "cfg-if",
-]
-
-[[package]]
-name = "wasmtime-environ"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a990198cee4197423045235bf89d3359e69bd2ea031005f4c2d901125955c949"
-dependencies = [
- "anyhow",
- "cranelift-entity",
- "gimli 0.27.3",
- "indexmap 1.9.3",
- "log",
- "object 0.30.4",
- "serde",
- "target-lexicon",
- "thiserror",
- "wasmparser",
- "wasmtime-types",
-]
-
-[[package]]
-name = "wasmtime-jit"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0de48df552cfca1c9b750002d3e07b45772dd033b0b206d5c0968496abf31244"
-dependencies = [
- "addr2line 0.19.0",
- "anyhow",
- "bincode",
- "cfg-if",
- "cpp_demangle",
- "gimli 0.27.3",
- "log",
- "object 0.30.4",
- "rustc-demangle",
- "serde",
- "target-lexicon",
- "wasmtime-environ",
- "wasmtime-jit-icache-coherence",
- "wasmtime-runtime",
- "windows-sys 0.45.0",
-]
-
-[[package]]
-name = "wasmtime-jit-debug"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6e0554b84c15a27d76281d06838aed94e13a77d7bf604bbbaf548aa20eb93846"
-dependencies = [
- "once_cell",
-]
-
-[[package]]
-name = "wasmtime-jit-icache-coherence"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "aecae978b13f7f67efb23bd827373ace4578f2137ec110bbf6a4a7cde4121bbd"
-dependencies = [
- "cfg-if",
- "libc",
- "windows-sys 0.45.0",
-]
-
-[[package]]
-name = "wasmtime-runtime"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "658cf6f325232b6760e202e5255d823da5e348fdea827eff0a2a22319000b441"
-dependencies = [
- "anyhow",
- "cc",
- "cfg-if",
- "indexmap 1.9.3",
- "libc",
- "log",
- "mach",
- "memfd",
- "memoffset",
- "paste",
- "rand",
- "rustix 0.36.17",
- "wasmtime-asm-macros",
- "wasmtime-environ",
- "wasmtime-jit-debug",
- "windows-sys 0.45.0",
-]
-
-[[package]]
-name = "wasmtime-types"
-version = "8.0.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a4f6fffd2a1011887d57f07654dd112791e872e3ff4a2e626aee8059ee17f06f"
-dependencies = [
- "cranelift-entity",
- "serde",
- "thiserror",
- "wasmparser",
-]
-
 [[package]]
 name = "winapi"
 version = "0.3.9"
@@ -3762,7 +3554,7 @@ version = "0.1.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "134306a13c5647ad6453e8deaec55d3a44d6021970129e6188735e74bf546697"
 dependencies = [
- "windows-sys 0.52.0",
+ "windows-sys",
 ]
 
 [[package]]
@@ -3780,24 +3572,6 @@ dependencies = [
  "windows-targets 0.52.5",
 ]
 
-[[package]]
-name = "windows-sys"
-version = "0.45.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "75283be5efb2831d37ea142365f009c02ec203cd29a3ebecbc093d52315b66d0"
-dependencies = [
- "windows-targets 0.42.2",
-]
-
-[[package]]
-name = "windows-sys"
-version = "0.48.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "677d2418bec65e3338edb076e806bc1ec15693c5d0104683f2efe857f61056a9"
-dependencies = [
- "windows-targets 0.48.5",
-]
-
 [[package]]
 name = "windows-sys"
 version = "0.52.0"
@@ -3807,21 +3581,6 @@ dependencies = [
  "windows-targets 0.52.5",
 ]
 
-[[package]]
-name = "windows-targets"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8e5180c00cd44c9b1c88adb3693291f1cd93605ded80c250a75d472756b4d071"
-dependencies = [
- "windows_aarch64_gnullvm 0.42.2",
- "windows_aarch64_msvc 0.42.2",
- "windows_i686_gnu 0.42.2",
- "windows_i686_msvc 0.42.2",
- "windows_x86_64_gnu 0.42.2",
- "windows_x86_64_gnullvm 0.42.2",
- "windows_x86_64_msvc 0.42.2",
-]
-
 [[package]]
 name = "windows-targets"
 version = "0.48.5"
@@ -3853,12 +3612,6 @@ dependencies = [
  "windows_x86_64_msvc 0.52.5",
 ]
 
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "597a5118570b68bc08d8d59125332c54f1ba9d9adeedeef5b99b02ba2b0698f8"
-
 [[package]]
 name = "windows_aarch64_gnullvm"
 version = "0.48.5"
@@ -3871,12 +3624,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7088eed71e8b8dda258ecc8bac5fb1153c5cffaf2578fc8ff5d61e23578d3263"
 
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e08e8864a60f06ef0d0ff4ba04124db8b0fb3be5776a5cd47641e942e58c4d43"
-
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.48.5"
@@ -3889,12 +3636,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9985fd1504e250c615ca5f281c3f7a6da76213ebd5ccc9561496568a2752afb6"
 
-[[package]]
-name = "windows_i686_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c61d927d8da41da96a81f029489353e68739737d3beca43145c8afec9a31a84f"
-
 [[package]]
 name = "windows_i686_gnu"
 version = "0.48.5"
@@ -3913,12 +3654,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "87f4261229030a858f36b459e748ae97545d6f1ec60e5e0d6a3d32e0dc232ee9"
 
-[[package]]
-name = "windows_i686_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "44d840b6ec649f480a41c8d80f9c65108b92d89345dd94027bfe06ac444d1060"
-
 [[package]]
 name = "windows_i686_msvc"
 version = "0.48.5"
@@ -3931,12 +3666,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "db3c2bf3d13d5b658be73463284eaf12830ac9a26a90c717b7f771dfe97487bf"
 
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8de912b8b8feb55c064867cf047dda097f92d51efad5b491dfb98f6bbb70cb36"
-
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.48.5"
@@ -3949,12 +3678,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4e4246f76bdeff09eb48875a0fd3e2af6aada79d409d33011886d3e1581517d9"
 
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "26d41b46a36d453748aedef1486d5c7a85db22e56aff34643984ea85514e94a3"
-
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.48.5"
@@ -3967,12 +3690,6 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "852298e482cd67c356ddd9570386e2862b5673c85bd5f88df9ab6802b334c596"
 
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.42.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9aec5da331524158c6d1a4ac0ab1541149c0b9505fde06423b02f5ef0106b9f0"
-
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.48.5"
@@ -4034,9 +3751,9 @@ dependencies = [
 
 [[package]]
 name = "zeroize"
-version = "1.7.0"
+version = "1.8.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
+checksum = "63381fa6624bf92130a6b87c0d07380116f80b565c42cf0d754136f0238359ef"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 3326ac75c..07dd884ac 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -15,10 +15,10 @@ tendermint = { version = "0.35", default-features = false }
 tendermint-proto = { version = "0.35", default-features = false }
 tendermint-light-client-verifier = { version = "0.35", default-features = false, features = ["rust-crypto"] }
 
-sp-core = { version = "28.0.0", default-features = false, optional = true }
-sp-io = { version = "30.0.0", default-features = false, optional = true }
-sp-runtime = { version = "31.0.1", default-features = false, optional = true }
-sp-std = { version = "14.0.0", default-features = false, optional = true }
+sp-core = { version = "32.0", default-features = false, optional = true }
+sp-io = { version = "34.0", default-features = false, optional = true }
+sp-runtime = { version = "35.0", default-features = false, optional = true }
+sp-std = { version = "14.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.

From 23b26bb8e6db88ed53ed4108ae2ed52514504d51 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Wed, 24 Apr 2024 16:18:25 -0400
Subject: [PATCH 159/182] fix(ibc-app-nft-transfer): compile without default
 features (#1195)

* enable cargo feature check

* fix no default compile

* nit
---
 .github/workflows/rust.yaml                   | 1 -
 ibc-apps/ics721-nft-transfer/types/Cargo.toml | 6 +++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/rust.yaml b/.github/workflows/rust.yaml
index a653aabbc..8e2a0a008 100644
--- a/.github/workflows/rust.yaml
+++ b/.github/workflows/rust.yaml
@@ -35,7 +35,6 @@ env:
 
 jobs:
   check-features:
-    if: ${{ github.event_name != 'pull_request' }}
     name: Check features
     runs-on: ubuntu-latest
     timeout-minutes: 60
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
index 9deb1a361..3b5189b92 100644
--- a/ibc-apps/ics721-nft-transfer/types/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -20,11 +20,11 @@ all-features = true
 [dependencies]
 # external dependencies
 borsh           = { workspace = true, optional = true }
-base64          = { workspace = true }
+base64          = { workspace = true, features = ["alloc"] }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-http            = "1.0.0"
-mime            = "0.3.17"
+http            = { version = "1.0.0" }
+mime            = { version = "0.3.17" }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 serde_json      = { workspace = true }

From cdf6cf5f5c7b0343ebf176c0c9dd727953a22501 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Fri, 26 Apr 2024 08:56:15 -0500
Subject: [PATCH 160/182] fix(ibc-core): copy substitute consensus state during
 client recovery (#1197)

* Pass substitute consensus state into client recovery methods

* Fix update_on_recovery call in ibc-clients/cw-context

* refactor encode_vec to into_any

* consume new_client_state later

* update ibc_derive

* update mock client state

* cargo format

* Change `use` statement formatting

* add store_update_meta at MockClientState::initialise

* consistent naming

* Remove `into_any` trait methods

* rm ConsensusState::into_any from ibc-derive

* test consensus state recovery

* link on doc strings

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 ibc-clients/cw-context/src/handlers.rs         |  7 +++++++
 .../src/client_state/execution.rs              | 15 +++++++++++++++
 .../ics07-tendermint/src/consensus_state.rs    |  4 ----
 .../ics02-client/context/src/client_state.rs   |  5 +++--
 .../context/src/consensus_state.rs             | 15 +++++++++------
 .../ics02-client/src/handler/recover_client.rs |  8 ++++++++
 .../src/handler/conn_open_ack.rs               |  2 +-
 .../src/handler/conn_open_try.rs               |  2 +-
 .../traits/client_state_execution.rs           |  3 ++-
 ibc-derive/src/consensus_state.rs              | 12 ------------
 .../testapp/ibc/clients/mock/client_state.rs   | 18 ++++++++++++++++++
 .../ibc/clients/mock/consensus_state.rs        |  4 ----
 .../tests/core/ics02_client/recover_client.rs  | 18 ++++++++++++++++++
 13 files changed, 82 insertions(+), 31 deletions(-)

diff --git a/ibc-clients/cw-context/src/handlers.rs b/ibc-clients/cw-context/src/handlers.rs
index c7ab323dd..024d8e08a 100644
--- a/ibc-clients/cw-context/src/handlers.rs
+++ b/ibc-clients/cw-context/src/handlers.rs
@@ -126,6 +126,12 @@ impl<'a, C: ClientType<'a>> Context<'a, C> {
             SudoMsg::MigrateClientStore(_) => {
                 self.set_substitute_prefix();
                 let substitute_client_state = self.client_state(&client_id)?;
+                let substitute_consensus_state =
+                    self.consensus_state(&ClientConsensusStatePath::new(
+                        client_id.clone(),
+                        substitute_client_state.latest_height().revision_number(),
+                        substitute_client_state.latest_height().revision_height(),
+                    ))?;
 
                 self.set_subject_prefix();
                 client_state.check_substitute(self, substitute_client_state.clone().into())?;
@@ -134,6 +140,7 @@ impl<'a, C: ClientType<'a>> Context<'a, C> {
                     self,
                     &self.client_id(),
                     substitute_client_state.into(),
+                    substitute_consensus_state.into(),
                 )?;
 
                 ContractResult::success()
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index 50d372fa3..7e844b21c 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -65,6 +65,7 @@ where
         ctx: &mut E,
         subject_client_id: &ClientId,
         substitute_client_state: Any,
+        substitute_consensus_state: Any,
     ) -> Result<(), ClientError> {
         let subject_client_state = self.inner().clone();
 
@@ -73,6 +74,7 @@ where
             ctx,
             subject_client_id,
             substitute_client_state,
+            substitute_consensus_state,
         )
     }
 }
@@ -373,10 +375,12 @@ pub fn update_on_recovery<E>(
     ctx: &mut E,
     subject_client_id: &ClientId,
     substitute_client_state: Any,
+    substitute_consensus_state: Any,
 ) -> Result<(), ClientError>
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
+    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
 {
     let substitute_client_state = ClientState::try_from(substitute_client_state)?
         .inner()
@@ -397,6 +401,17 @@ where
     let host_timestamp = E::host_timestamp(ctx)?;
     let host_height = E::host_height(ctx)?;
 
+    let tm_consensus_state = ConsensusStateType::try_from(substitute_consensus_state)?;
+
+    ctx.store_consensus_state(
+        ClientConsensusStatePath::new(
+            subject_client_id.clone(),
+            new_client_state.latest_height.revision_number(),
+            new_client_state.latest_height.revision_height(),
+        ),
+        tm_consensus_state.into(),
+    )?;
+
     ctx.store_client_state(
         ClientStatePath::new(subject_client_id.clone()),
         new_client_state.into(),
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
index f2473d63a..d923ebb73 100644
--- a/ibc-clients/ics07-tendermint/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -89,8 +89,4 @@ impl ConsensusStateTrait for ConsensusState {
     fn timestamp(&self) -> Timestamp {
         self.0.timestamp.into()
     }
-
-    fn encode_vec(self) -> Vec<u8> {
-        <Self as Protobuf<Any>>::encode_vec(self)
-    }
 }
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index 849678b77..abe496e2f 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -10,8 +10,8 @@ use ibc_core_host_types::path::Path;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
-/// Convenient trait to decode a client state from an `Any` type and obtain a
-/// handle to the local instance of `ClientState`.
+/// Convenient trait to decode a client state from an [`Any`] type and obtain a
+/// handle to the local instance of [`ClientState`].
 pub trait ClientStateDecoder: Into<Any> + TryFrom<Any, Error = ClientError> {}
 
 impl<T> ClientStateDecoder for T where T: Into<Any> + TryFrom<Any, Error = ClientError> {}
@@ -202,6 +202,7 @@ where
         ctx: &mut E,
         subject_client_id: &ClientId,
         substitute_client_state: Any,
+        substitute_consensus_state: Any,
     ) -> Result<(), ClientError>;
 }
 
diff --git a/ibc-core/ics02-client/context/src/consensus_state.rs b/ibc-core/ics02-client/context/src/consensus_state.rs
index 195e19625..7d1bfcb77 100644
--- a/ibc-core/ics02-client/context/src/consensus_state.rs
+++ b/ibc-core/ics02-client/context/src/consensus_state.rs
@@ -1,22 +1,25 @@
 //! Defines the trait to be implemented by all concrete consensus state types
 
+use ibc_core_client_types::error::ClientError;
 use ibc_core_commitment_types::commitment::CommitmentRoot;
 use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
 use ibc_primitives::Timestamp;
 
+/// Convenient trait to decode a consensus state from an [`Any`] type and obtain
+/// a handle to the local instance of [`ConsensusState`].
+pub trait ConsensusStateDecoder: Into<Any> + TryFrom<Any, Error = ClientError> {}
+
+impl<T> ConsensusStateDecoder for T where T: Into<Any> + TryFrom<Any, Error = ClientError> {}
+
 /// Defines methods that all `ConsensusState`s should provide.
 ///
 /// One can think of a "consensus state" as a pruned header, to be stored on chain. In other words,
 /// a consensus state only contains the header's information needed by IBC message handlers.
-pub trait ConsensusState: Send + Sync {
+pub trait ConsensusState: Send + Sync + ConsensusStateDecoder {
     /// Commitment root of the consensus state, which is used for key-value pair verification.
     fn root(&self) -> &CommitmentRoot;
 
     /// The timestamp of the consensus state
     fn timestamp(&self) -> Timestamp;
-
-    /// Serializes the `ConsensusState`. This is expected to be implemented as
-    /// first converting to the raw type (i.e. the protobuf definition), and then
-    /// serializing that.
-    fn encode_vec(self) -> Vec<u8>;
 }
diff --git a/ibc-core/ics02-client/src/handler/recover_client.rs b/ibc-core/ics02-client/src/handler/recover_client.rs
index 431afadf5..1676c6e80 100644
--- a/ibc-core/ics02-client/src/handler/recover_client.rs
+++ b/ibc-core/ics02-client/src/handler/recover_client.rs
@@ -4,6 +4,7 @@ use ibc_core_client_context::prelude::*;
 use ibc_core_client_types::error::ClientError;
 use ibc_core_client_types::msgs::MsgRecoverClient;
 use ibc_core_handler_types::error::ContextError;
+use ibc_core_host::types::path::ClientConsensusStatePath;
 use ibc_core_host::{ExecutionContext, ValidationContext};
 
 /// Performs the validation steps associated with the client recovery process. This
@@ -72,11 +73,18 @@ where
 
     let subject_client_state = client_exec_ctx.client_state(&subject_client_id)?;
     let substitute_client_state = client_exec_ctx.client_state(&substitute_client_id)?;
+    let substitute_consensus_state =
+        client_exec_ctx.consensus_state(&ClientConsensusStatePath::new(
+            substitute_client_id.clone(),
+            substitute_client_state.latest_height().revision_number(),
+            substitute_client_state.latest_height().revision_height(),
+        ))?;
 
     subject_client_state.update_on_recovery(
         ctx.get_client_execution_context(),
         &subject_client_id,
         substitute_client_state.into(),
+        substitute_consensus_state.into(),
     )?;
 
     Ok(())
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index aca9bad68..4e76a493a 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -128,7 +128,7 @@ where
                 &msg.proof_consensus_state_of_a_on_b,
                 consensus_state_of_b_on_a.root(),
                 Path::ClientConsensusState(client_cons_state_path_on_b),
-                expected_consensus_state_of_a_on_b.encode_vec(),
+                expected_consensus_state_of_a_on_b.into().to_vec(),
             )
             .map_err(|e| ConnectionError::ConsensusStateVerificationFailure {
                 height: msg.proofs_height_on_b,
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index 99e15f209..d7eb9592f 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -124,7 +124,7 @@ where
                 &msg.proof_consensus_state_of_b_on_a,
                 consensus_state_of_a_on_b.root(),
                 Path::ClientConsensusState(client_cons_state_path_on_a),
-                expected_consensus_state_of_b_on_a.encode_vec(),
+                expected_consensus_state_of_b_on_a.into().to_vec(),
             )
             .map_err(|e| ConnectionError::ConsensusStateVerificationFailure {
                 height: msg.proofs_height_on_a,
diff --git a/ibc-derive/src/client_state/traits/client_state_execution.rs b/ibc-derive/src/client_state/traits/client_state_execution.rs
index 64c9770c2..ddecb00ad 100644
--- a/ibc-derive/src/client_state/traits/client_state_execution.rs
+++ b/ibc-derive/src/client_state/traits/client_state_execution.rs
@@ -47,7 +47,7 @@ pub(crate) fn impl_ClientStateExecution(
         client_state_enum_name,
         enum_variants.iter(),
         opts,
-        quote! { update_on_recovery(cs, ctx, client_id, substitute_client_state) },
+        quote! { update_on_recovery(cs, ctx, client_id, substitute_client_state, substitute_consensus_state) },
         imports,
     );
 
@@ -121,6 +121,7 @@ pub(crate) fn impl_ClientStateExecution(
                 ctx: &mut #E,
                 client_id: &#ClientId,
                 substitute_client_state: #Any,
+                substitute_consensus_state: #Any,
             ) -> core::result::Result<(), #ClientError> {
                 match self {
                     #(#update_on_recovery_impl),*
diff --git a/ibc-derive/src/consensus_state.rs b/ibc-derive/src/consensus_state.rs
index 4ac97a578..87fafcffe 100644
--- a/ibc-derive/src/consensus_state.rs
+++ b/ibc-derive/src/consensus_state.rs
@@ -20,12 +20,6 @@ pub fn consensus_state_derive_impl(ast: DeriveInput, imports: &Imports) -> Token
         quote! {timestamp(cs)},
         imports,
     );
-    let encode_vec_impl = delegate_call_in_match(
-        enum_name,
-        enum_variants.iter(),
-        quote! {encode_vec(cs)},
-        imports,
-    );
 
     let CommitmentRoot = imports.commitment_root();
     let ConsensusState = imports.consensus_state();
@@ -44,12 +38,6 @@ pub fn consensus_state_derive_impl(ast: DeriveInput, imports: &Imports) -> Token
                     #(#timestamp_impl),*
                 }
             }
-
-            fn encode_vec(self) -> Vec<u8> {
-                match self {
-                    #(#encode_vec_impl),*
-                }
-            }
         }
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 6bb841f0e..05ff95440 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -343,6 +343,12 @@ where
             ),
             mock_consensus_state.into(),
         )?;
+        ctx.store_update_meta(
+            client_id.clone(),
+            self.latest_height(),
+            ctx.host_timestamp()?,
+            ctx.host_height()?,
+        )?;
 
         Ok(())
     }
@@ -440,6 +446,7 @@ where
         ctx: &mut E,
         subject_client_id: &ClientId,
         substitute_client_state: Any,
+        substitute_consensus_state: Any,
     ) -> Result<(), ClientError> {
         let substitute_client_state = MockClientState::try_from(substitute_client_state)?;
 
@@ -453,6 +460,17 @@ where
         let host_timestamp = ctx.host_timestamp()?;
         let host_height = ctx.host_height()?;
 
+        let mock_consensus_state = MockConsensusState::try_from(substitute_consensus_state)?;
+
+        ctx.store_consensus_state(
+            ClientConsensusStatePath::new(
+                subject_client_id.clone(),
+                new_mock_client_state.latest_height().revision_number(),
+                new_mock_client_state.latest_height().revision_height(),
+            ),
+            mock_consensus_state.into(),
+        )?;
+
         ctx.store_client_state(
             ClientStatePath::new(subject_client_id.clone()),
             new_mock_client_state.into(),
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
index 8a2e31e58..dec5e9431 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
@@ -98,8 +98,4 @@ impl ConsensusState for MockConsensusState {
     fn timestamp(&self) -> Timestamp {
         self.header.timestamp
     }
-
-    fn encode_vec(self) -> Vec<u8> {
-        <Self as Protobuf<Any>>::encode_vec(self)
-    }
 }
diff --git a/ibc-testkit/tests/core/ics02_client/recover_client.rs b/ibc-testkit/tests/core/ics02_client/recover_client.rs
index 22fc227a7..e99098d65 100644
--- a/ibc-testkit/tests/core/ics02_client/recover_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/recover_client.rs
@@ -7,6 +7,7 @@ use ibc::core::client::types::Height;
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::{Signer, Timestamp};
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
@@ -126,10 +127,27 @@ fn test_recover_client_ok() {
 
     assert!(res.is_ok(), "client recovery execution happy path");
 
+    // client state is copied.
     assert_eq!(
         ctx.client_state(&msg.subject_client_id).unwrap(),
         ctx.client_state(&msg.substitute_client_id).unwrap(),
     );
+
+    // latest consensus state is copied.
+    assert_eq!(
+        ctx.consensus_state(&ClientConsensusStatePath::new(
+            msg.subject_client_id,
+            substitute_height.revision_number(),
+            substitute_height.revision_height(),
+        ))
+        .unwrap(),
+        ctx.consensus_state(&ClientConsensusStatePath::new(
+            msg.substitute_client_id,
+            substitute_height.revision_number(),
+            substitute_height.revision_height(),
+        ))
+        .unwrap(),
+    );
 }
 
 #[rstest]

From e5c626f2f78c8c6d08b4c4c2755af5dfa16436a2 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 26 Apr 2024 17:47:17 +0200
Subject: [PATCH 161/182] fix(ics20): `PrefixedDenom` parsing (#1178)

* add failing test

* add TracePath::new

* imp PrefixedDenom parsing

* add validate_named_u64_index

* validate_named_u64_index in channel and connection validation

* add tests for validate_named_u64_index

* update PrefixDenom parsing tests

* update accepted cases in ibc-go

* update accepted cases

* add test cases from ibc-go

* use valid connection id

* failing doc tests

* use existing constants

* changelog entry

* refactor tests

* apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* add comment for PrefixedDenom::from_str

* rm TracePath::new

* collect the same tests

* test parsed PrefixedDenom string repr

* test trace order

* more tests

* update tests

* rm redundant error variant

* refactor tests

* update doc string

* add comment on virtual split_twice

* update doc str

* add TracePrefix::strip and TracePath::trim

* add whitespace cases

* refactor tests

* spelling

* parse over from_str

* nit

* apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* add failing test

* fix TracePath::from_str

* fix parsing

* fix test

* add ibc-app-transfer-types dep

* rm reusable code

* update impls

* update tests

* accepted class ids

* refactor tests

* update changelog entry

* opt trace prefix and path parsing

* add new tests

* Update changelog entry

* fix trace-prefix index order

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Co-authored-by: Farhad Shabani <Farhad.Shabani@gmail.com>
---
 .../1177-fix-prefixed-denom-parsing.md        |   5 +
 ibc-apps/ics20-transfer/types/src/denom.rs    | 415 +++++++++++++-----
 ibc-apps/ics20-transfer/types/src/error.rs    |   2 +
 ibc-apps/ics721-nft-transfer/types/Cargo.toml |  16 +-
 .../ics721-nft-transfer/types/src/class.rs    | 284 +++---------
 .../types/src/identifiers/channel_id.rs       |   4 +-
 .../types/src/identifiers/connection_id.rs    |   4 +-
 ibc-core/ics24-host/types/src/validate.rs     |  78 +++-
 .../core/connection/conn_open_confirm.rs      |   2 +-
 9 files changed, 469 insertions(+), 341 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md

diff --git a/.changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md b/.changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md
new file mode 100644
index 000000000..cf89e9a52
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md
@@ -0,0 +1,5 @@
+- [ibc-app-transfer] Bring `PrefixedDenom` parsing up to parity with `ibc-go`.
+  ([\#1177](https://github.com/cosmos/ibc-rs/issues/1177))
+- [ibc-app-nft-transfer] Reuse `TracePrefix` and `TracePath` from
+  `ibc-app-transfer-types` when parsing `PrefixedClassId`.
+  ([\#1178](https://github.com/cosmos/ibc-rs/pull/1178))
diff --git a/ibc-apps/ics20-transfer/types/src/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
index 65b38fe67..8ac632fea 100644
--- a/ibc-apps/ics20-transfer/types/src/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -83,6 +83,33 @@ impl TracePrefix {
             channel_id,
         }
     }
+
+    /// Returns a string slice with [`TracePrefix`] removed.
+    ///
+    /// If the string starts with a [`TracePrefix`], i.e. `{port-id}/channel-{id}`,
+    /// it returns a tuple of the removed [`TracePrefix`] and the substring after the prefix.
+    ///
+    /// If the substring is empty, it returns `None`.
+    /// Otherwise the substring starts with `/`. In that case,
+    /// the leading `/` is stripped and returned.
+    ///
+    /// If the string does not start with a [`TracePrefix`], this method returns `None`.
+    ///
+    /// This method is analogous to `strip_prefix` from the standard library.
+    pub fn strip(s: &str) -> Option<(Self, Option<&str>)> {
+        // The below two chained `split_once` calls emulate a virtual `split_twice` call,
+        // which is not available in the standard library.
+        let (port_id_s, remaining) = s.split_once('/')?;
+        let (channel_id_s, remaining) = remaining
+            .split_once('/')
+            .map(|(a, b)| (a, Some(b)))
+            .unwrap_or_else(|| (remaining, None));
+
+        let port_id = port_id_s.parse().ok()?;
+        let channel_id = channel_id_s.parse().ok()?;
+
+        Some((Self::new(port_id, channel_id), remaining))
+    }
 }
 
 impl Display for TracePrefix {
@@ -92,9 +119,10 @@ impl Display for TracePrefix {
 }
 
 /// A full trace path modelled as a collection of `TracePrefix`s.
-// Internally, the `TracePath` is modelled as a `Vec<TracePrefix>` but with the order reversed, i.e.
-// "transfer/channel-0/transfer/channel-1/uatom" => `["transfer/channel-1", "transfer/channel-0"]`
-// This is done for ease of addition/removal of prefixes.
+///
+/// Internally, the `TracePath` is modelled as a `Vec<TracePrefix>` but with the order reversed, i.e.
+/// "transfer/channel-0/transfer/channel-1/uatom" => `["transfer/channel-1", "transfer/channel-0"]`
+/// This is done for ease of addition/removal of prefixes.
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -139,39 +167,43 @@ impl TracePath {
     pub fn empty() -> Self {
         Self(vec![])
     }
-}
 
-impl<'a> TryFrom<Vec<&'a str>> for TracePath {
-    type Error = TokenTransferError;
-
-    fn try_from(v: Vec<&'a str>) -> Result<Self, Self::Error> {
-        if v.len() % 2 != 0 {
-            return Err(TokenTransferError::InvalidTraceLength {
-                len: v.len() as u64,
-            });
-        }
-
-        let mut trace = vec![];
-        let id_pairs = v.chunks_exact(2).map(|paths| (paths[0], paths[1]));
-        for (pos, (port_id, channel_id)) in id_pairs.rev().enumerate() {
-            let port_id =
-                PortId::from_str(port_id).map_err(|e| TokenTransferError::InvalidTracePortId {
-                    pos: pos as u64,
-                    validation_error: e,
-                })?;
-            let channel_id = ChannelId::from_str(channel_id).map_err(|e| {
-                TokenTransferError::InvalidTraceChannelId {
-                    pos: pos as u64,
-                    validation_error: e,
-                }
-            })?;
-            trace.push(TracePrefix {
-                port_id,
-                channel_id,
-            });
+    /// Returns a string slice with [`TracePath`] or all [`TracePrefix`]es repeatedly removed.
+    ///
+    /// If the string starts with a [`TracePath`], it returns a tuple of the removed
+    /// [`TracePath`] and the substring after the [`TracePath`].
+    ///
+    /// If the substring is empty, it returns `None`.
+    /// Otherwise the substring starts with `/`. In that case,
+    /// the leading `/` is stripped and returned.
+    ///
+    /// If the string does not contain any [`TracePrefix`], it returns the original string.
+    ///
+    /// This method is analogous to `trim_start_matches` from the standard library.
+    pub fn trim(s: &str) -> (Self, Option<&str>) {
+        // We can't use `TracePrefix::empty()` with `TracePrefix::add_prefix()`.
+        // Because we are stripping prefixes in reverse order.
+        let mut trace_prefixes = vec![];
+        let mut current_remaining_opt = Some(s);
+
+        loop {
+            let Some(current_remaining_s) = current_remaining_opt else {
+                break;
+            };
+
+            let Some((trace_prefix, next_remaining_opt)) = TracePrefix::strip(current_remaining_s)
+            else {
+                break;
+            };
+
+            trace_prefixes.push(trace_prefix);
+            current_remaining_opt = next_remaining_opt;
         }
 
-        Ok(trace.into())
+        // Reversing is needed, as [`TracePath`] requires quick addition/removal
+        // of prefixes which is more performant from the end of a [`Vec`].
+        trace_prefixes.reverse();
+        (Self(trace_prefixes), current_remaining_opt)
     }
 }
 
@@ -179,15 +211,15 @@ impl FromStr for TracePath {
     type Err = TokenTransferError;
 
     fn from_str(s: &str) -> Result<Self, Self::Err> {
-        let parts = {
-            let parts: Vec<&str> = s.split('/').collect();
-            if parts.len() == 1 && parts[0].trim().is_empty() {
-                vec![]
-            } else {
-                parts
-            }
-        };
-        parts.try_into()
+        if s.is_empty() {
+            return Ok(TracePath::empty());
+        }
+
+        let (trace_path, remaining_parts) = TracePath::trim(s);
+        remaining_parts
+            .is_none()
+            .then_some(trace_path)
+            .ok_or_else(|| TokenTransferError::MalformedTrace(s.to_string()))
     }
 }
 
@@ -293,24 +325,38 @@ pub fn is_receiver_chain_source(
 impl FromStr for PrefixedDenom {
     type Err = TokenTransferError;
 
+    /// Initializes a [`PrefixedDenom`] from a string that adheres to the format
+    /// `{nth-port-id/channel-<index>}/{(n-1)th-port-id/channel-<index>}/.../{1st-port-id/channel-<index>}/<base_denom>`.
+    /// A [`PrefixedDenom`] exhibits a sequence of `{ith-port-id/channel-<index>}` pairs.
+    /// This sequence makes up the [`TracePath`] of the [`PrefixedDenom`].
+    ///
+    /// This [`PrefixedDenom::from_str`] implementation _left-split-twice_ the argument string
+    /// using `/` delimiter. Then it peeks into the first two segments and attempts to convert
+    /// the first segment into a [`PortId`] and the second into a [`ChannelId`].
+    /// This continues on the third remaining segment in a loop until a
+    /// `{port-id/channel-id}` pair cannot be created from the top two segments.
+    /// The remaining parts of the string are then considered the [`BaseDenom`].
+    ///
+    /// For example, given the following denom trace:
+    /// "transfer/channel-75/factory/stars16da2uus9zrsy83h23ur42v3lglg5rmyrpqnju4/dust",
+    /// the first two `/`-delimited segments are `"transfer"` and `"channel-75"`. The
+    /// first is a valid [`PortId`], and the second is a valid [`ChannelId`], so that becomes
+    /// the first `{port-id/channel-id}` pair that gets added as part of the [`TracePath`]
+    /// of the [`PrefixedDenom`]. The next two segments are `"factory"`, a
+    /// valid [`PortId`], and `"stars16da2uus9zrsy83h23ur42v3lglg5rmyrpqnju4"`, an invalid [`ChannelId`].
+    /// The loop breaks at this point, resulting in a [`TracePath`] of `"transfer/channel-75"`
+    /// and a [`BaseDenom`] of `"factory/stars16da2uus9zrsy83h23ur42v3lglg5rmyrpqnju4/dust"`.
     fn from_str(s: &str) -> Result<Self, Self::Err> {
-        let mut parts: Vec<&str> = s.split('/').collect();
-        let last_part = parts.pop().expect("split() returned an empty iterator");
-
-        let (base_denom, trace_path) = {
-            if last_part == s {
-                (BaseDenom::from_str(s)?, TracePath::empty())
-            } else {
-                let base_denom = BaseDenom::from_str(last_part)?;
-                let trace_path = TracePath::try_from(parts)?;
-                (base_denom, trace_path)
-            }
-        };
-
-        Ok(Self {
-            trace_path,
-            base_denom,
-        })
+        match TracePath::trim(s) {
+            (trace_path, Some(remaining_parts)) => Ok(Self {
+                trace_path,
+                base_denom: BaseDenom::from_str(remaining_parts)?,
+            }),
+            (_, None) => Ok(Self {
+                trace_path: TracePath::empty(),
+                base_denom: BaseDenom::from_str(s)?,
+            }),
+        }
     }
 }
 
@@ -357,80 +403,217 @@ impl Display for PrefixedDenom {
 
 #[cfg(test)]
 mod tests {
+    use rstest::rstest;
+
     use super::*;
 
-    #[test]
-    fn test_denom_validation() -> Result<(), TokenTransferError> {
-        assert!(BaseDenom::from_str("").is_err(), "empty base denom");
-        assert!(BaseDenom::from_str("uatom").is_ok(), "valid base denom");
-        assert!(PrefixedDenom::from_str("").is_err(), "empty denom trace");
-        assert!(
-            PrefixedDenom::from_str("transfer/channel-0/").is_err(),
-            "empty base denom with trace"
-        );
-        assert!(PrefixedDenom::from_str("/uatom").is_err(), "empty prefix");
-        assert!(PrefixedDenom::from_str("//uatom").is_err(), "empty ids");
-        assert!(
-            PrefixedDenom::from_str("transfer/").is_err(),
-            "single trace"
-        );
-        assert!(
-            PrefixedDenom::from_str("transfer/atom").is_err(),
-            "single trace with base denom"
+    #[rstest]
+    #[case("transfer")]
+    #[case("transfer/channel-1/ica")]
+    fn test_invalid_raw_demon_trace_parsing(#[case] trace_path: &str) {
+        let raw_denom_trace = RawDenomTrace {
+            path: trace_path.to_string(),
+            base_denom: "uatom".to_string(),
+        };
+
+        PrefixedDenom::try_from(raw_denom_trace).expect_err("failure");
+    }
+
+    #[rstest]
+    #[case("uatom")]
+    #[case("atom")]
+    fn test_accepted_denom(#[case] denom_str: &str) {
+        BaseDenom::from_str(denom_str).expect("success");
+    }
+
+    #[rstest]
+    #[case("")]
+    #[case(" ")]
+    fn test_rejected_denom(#[case] denom_str: &str) {
+        BaseDenom::from_str(denom_str).expect_err("failure");
+    }
+
+    #[rstest]
+    #[case(
+        "transfer/channel-75",
+        "factory/stars16da2uus9zrsy83h23ur42v3lglg5rmyrpqnju4/dust"
+    )]
+    #[case(
+        "transfer/channel-75/transfer/channel-123/transfer/channel-1023/transfer/channel-0",
+        "factory/stars16da2uus9zrsy83h23ur42v3lglg5rmyrpqnju4/dust"
+    )]
+    #[case(
+        "transfer/channel-75/transfer/channel-123/transfer/channel-1023/transfer/channel-0",
+        "//////////////////////dust"
+    )]
+    #[case("transfer/channel-0", "uatom")]
+    #[case("transfer/channel-0/transfer/channel-1", "uatom")]
+    #[case("", "/")]
+    #[case("", "transfer/uatom")]
+    #[case("", "transfer/atom")]
+    #[case("", "transfer//uatom")]
+    #[case("", "/uatom")]
+    #[case("", "//uatom")]
+    #[case("", "transfer/")]
+    #[case("", "(transfer)/channel-0/uatom")]
+    #[case("", "transfer/(channel-0)/uatom")]
+    // https://github.com/cosmos/ibc-go/blob/e2ad31975f2ede592912b86346b5ebf055c9e05f/modules/apps/transfer/types/trace_test.go#L17-L38
+    #[case("", "uatom")]
+    #[case("", "uatom/")]
+    #[case("", "gamm/pool/1")]
+    #[case("", "gamm//pool//1")]
+    #[case("transfer/channel-1", "uatom")]
+    #[case("customtransfer/channel-1", "uatom")]
+    #[case("transfer/channel-1", "uatom/")]
+    #[case(
+        "transfer/channel-1",
+        "erc20/0x85bcBCd7e79Ec36f4fBBDc54F90C643d921151AA"
+    )]
+    #[case("transfer/channel-1", "gamm/pool/1")]
+    #[case("transfer/channel-1", "gamm//pool//1")]
+    #[case("transfer/channel-1/transfer/channel-2", "uatom")]
+    #[case("customtransfer/channel-1/alternativetransfer/channel-2", "uatom")]
+    #[case("", "transfer/uatom")]
+    #[case("", "transfer//uatom")]
+    #[case("", "channel-1/transfer/uatom")]
+    #[case("", "uatom/transfer")]
+    #[case("", "transfer/channel-1")]
+    #[case("transfer/channel-1", "transfer")]
+    #[case("", "transfer/channelToA/uatom")]
+    fn test_strange_but_accepted_prefixed_denom(
+        #[case] prefix: &str,
+        #[case] denom: &str,
+    ) -> Result<(), TokenTransferError> {
+        let pd_s = if prefix.is_empty() {
+            denom.to_owned()
+        } else {
+            format!("{prefix}/{denom}")
+        };
+        let pd = PrefixedDenom::from_str(&pd_s)?;
+
+        assert_eq!(pd.to_string(), pd_s);
+        assert_eq!(pd.trace_path.to_string(), prefix);
+        assert_eq!(pd.base_denom.to_string(), denom);
+
+        Ok(())
+    }
+
+    #[rstest]
+    #[case("")]
+    #[case("   ")]
+    #[case("transfer/channel-1/")]
+    #[case("transfer/channel-1/transfer/channel-2/")]
+    #[case("transfer/channel-21/transfer/channel-23/  ")]
+    #[case("transfer/channel-0/")]
+    #[should_panic(expected = "EmptyBaseDenom")]
+    fn test_prefixed_empty_base_denom(#[case] pd_s: &str) {
+        PrefixedDenom::from_str(pd_s).expect("error");
+    }
+
+    #[rstest]
+    fn test_trace_path_order() {
+        let mut prefixed_denom =
+            PrefixedDenom::from_str("customtransfer/channel-1/alternativetransfer/channel-2/uatom")
+                .expect("no error");
+
+        assert_eq!(
+            prefixed_denom.trace_path.to_string(),
+            "customtransfer/channel-1/alternativetransfer/channel-2"
         );
-        assert!(
-            PrefixedDenom::from_str("transfer/channel-0/uatom").is_ok(),
-            "valid single trace info"
+        assert_eq!(prefixed_denom.base_denom.to_string(), "uatom");
+
+        let trace_prefix_1 = TracePrefix::new(
+            "alternativetransfer".parse().unwrap(),
+            "channel-2".parse().unwrap(),
         );
-        assert!(
-            PrefixedDenom::from_str("transfer/channel-0/transfer/channel-1/uatom").is_ok(),
-            "valid multiple trace info"
+
+        let trace_prefix_2 = TracePrefix::new(
+            "customtransfer".parse().unwrap(),
+            "channel-1".parse().unwrap(),
         );
-        assert!(
-            PrefixedDenom::from_str("(transfer)/channel-0/uatom").is_err(),
-            "invalid port"
+
+        let trace_prefix_3 =
+            TracePrefix::new("transferv2".parse().unwrap(), "channel-10".parse().unwrap());
+        let trace_prefix_4 = TracePrefix::new(
+            "transferv3".parse().unwrap(),
+            "channel-101".parse().unwrap(),
         );
-        assert!(
-            PrefixedDenom::from_str("transfer/(channel-0)/uatom").is_err(),
-            "invalid channel"
+
+        prefixed_denom.trace_path.add_prefix(trace_prefix_3.clone());
+
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_1));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_2));
+        assert!(prefixed_denom.trace_path.starts_with(&trace_prefix_3));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_4));
+
+        assert_eq!(
+            prefixed_denom.to_string(),
+            "transferv2/channel-10/customtransfer/channel-1/alternativetransfer/channel-2/uatom"
         );
 
-        Ok(())
-    }
+        prefixed_denom.trace_path.remove_prefix(&trace_prefix_4);
 
-    #[test]
-    fn test_denom_trace() -> Result<(), TokenTransferError> {
+        assert!(!prefixed_denom.trace_path.is_empty());
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_1));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_2));
+        assert!(prefixed_denom.trace_path.starts_with(&trace_prefix_3));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_4));
         assert_eq!(
-            PrefixedDenom::from_str("transfer/channel-0/uatom")?,
-            PrefixedDenom {
-                trace_path: "transfer/channel-0".parse()?,
-                base_denom: "uatom".parse()?
-            },
-            "valid single trace info"
+            prefixed_denom.to_string(),
+            "transferv2/channel-10/customtransfer/channel-1/alternativetransfer/channel-2/uatom"
         );
+
+        prefixed_denom.trace_path.remove_prefix(&trace_prefix_3);
+
+        assert!(!prefixed_denom.trace_path.is_empty());
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_1));
+        assert!(prefixed_denom.trace_path.starts_with(&trace_prefix_2));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_3));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_4));
         assert_eq!(
-            PrefixedDenom::from_str("transfer/channel-0/transfer/channel-1/uatom")?,
-            PrefixedDenom {
-                trace_path: "transfer/channel-0/transfer/channel-1".parse()?,
-                base_denom: "uatom".parse()?
-            },
-            "valid multiple trace info"
+            prefixed_denom.to_string(),
+            "customtransfer/channel-1/alternativetransfer/channel-2/uatom"
         );
 
-        Ok(())
-    }
+        prefixed_denom.trace_path.remove_prefix(&trace_prefix_2);
 
-    #[test]
-    fn test_denom_serde() -> Result<(), TokenTransferError> {
-        let dt_str = "transfer/channel-0/uatom";
-        let dt = PrefixedDenom::from_str(dt_str)?;
-        assert_eq!(dt.to_string(), dt_str, "valid single trace info");
+        assert!(!prefixed_denom.trace_path.is_empty());
+        assert!(prefixed_denom.trace_path.starts_with(&trace_prefix_1));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_2));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_3));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_4));
+        assert_eq!(
+            prefixed_denom.to_string(),
+            "alternativetransfer/channel-2/uatom"
+        );
 
-        let dt_str = "transfer/channel-0/transfer/channel-1/uatom";
-        let dt = PrefixedDenom::from_str(dt_str)?;
-        assert_eq!(dt.to_string(), dt_str, "valid multiple trace info");
+        prefixed_denom.trace_path.remove_prefix(&trace_prefix_1);
 
-        Ok(())
+        assert!(prefixed_denom.trace_path.is_empty());
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_1));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_2));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_3));
+        assert!(!prefixed_denom.trace_path.starts_with(&trace_prefix_4));
+        assert_eq!(prefixed_denom.to_string(), "uatom");
+    }
+
+    #[rstest]
+    #[case("", TracePath::empty(), Some(""))]
+    #[case("transfer", TracePath::empty(), Some("transfer"))]
+    #[case("transfer/", TracePath::empty(), Some("transfer/"))]
+    #[case("transfer/channel-1", TracePath::from(vec![TracePrefix::new("transfer".parse().unwrap(), ChannelId::new(1))]), None)]
+    #[case("transfer/channel-1/", TracePath::from(vec![TracePrefix::new("transfer".parse().unwrap(), ChannelId::new(1))]), Some(""))]
+    #[case("transfer/channel-1/uatom", TracePath::from(vec![TracePrefix::new("transfer".parse().unwrap(), ChannelId::new(1))]), Some("uatom"))]
+    #[case("transfer/channel-1/uatom/", TracePath::from(vec![TracePrefix::new("transfer".parse().unwrap(), ChannelId::new(1))]), Some("uatom/"))]
+    fn test_trace_path_cases(
+        #[case] trace_path_s: &str,
+        #[case] trace_path: TracePath,
+        #[case] remaining: Option<&str>,
+    ) {
+        let (parsed_trace_path, parsed_remaining) = TracePath::trim(trace_path_s);
+
+        assert_eq!(parsed_trace_path, trace_path);
+        assert_eq!(parsed_remaining, remaining);
     }
 
     #[test]
diff --git a/ibc-apps/ics20-transfer/types/src/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
index 257fbc29d..7bd938408 100644
--- a/ibc-apps/ics20-transfer/types/src/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -39,6 +39,8 @@ pub enum TokenTransferError {
         pos: u64,
         validation_error: IdentifierError,
     },
+    /// malformed trace: `{0}`
+    MalformedTrace(String),
     /// trace length must be even but got: `{len}`
     InvalidTraceLength { len: u64 },
     /// invalid amount error: `{0}`
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
index 3b5189b92..8b7d27b91 100644
--- a/ibc-apps/ics721-nft-transfer/types/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -30,8 +30,9 @@ serde           = { workspace = true, optional = true }
 serde_json      = { workspace = true }
 
 # ibc dependencies
-ibc-core  = { workspace = true }
-ibc-proto = { workspace = true }
+ibc-core               = { workspace = true }
+ibc-proto              = { workspace = true }
+ibc-app-transfer-types = { workspace = true }
 
 ## parity dependencies
 parity-scale-codec = { workspace = true , optional = true }
@@ -50,27 +51,32 @@ std = [
     "http/std",
     "ibc-core/std",
     "ibc-proto/std",
+    "ibc-app-transfer-types/std",
 ]
 serde = [
     "dep:serde",
     "ibc-core/serde",
     "ibc-proto/serde",
+    "ibc-app-transfer-types/serde",
 ]
 schema = [
     "dep:schemars",
     "ibc-core/schema",
     "ibc-proto/json-schema",
     "serde",
-    "std"
+    "std",
+    "ibc-app-transfer-types/schema",
 ]
 borsh = [
     "dep:borsh",
     "ibc-core/borsh",
-    "ibc-proto/borsh"
+    "ibc-proto/borsh",
+    "ibc-app-transfer-types/borsh",
 ]
 parity-scale-codec = [
     "dep:parity-scale-codec",
     "dep:scale-info",
     "ibc-core/parity-scale-codec",
-    "ibc-proto/parity-scale-codec"
+    "ibc-proto/parity-scale-codec",
+    "ibc-app-transfer-types/parity-scale-codec",
 ]
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
index c2ff9afd4..ff1293f89 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/class.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -2,8 +2,8 @@
 use core::fmt::{self, Display, Error as FmtError, Formatter};
 use core::str::FromStr;
 
-use derive_more::From;
 use http::Uri;
+pub use ibc_app_transfer_types::{TracePath, TracePrefix};
 use ibc_core::host::types::identifiers::{ChannelId, PortId};
 use ibc_core::primitives::prelude::*;
 #[cfg(feature = "serde")]
@@ -55,152 +55,6 @@ impl FromStr for ClassId {
     }
 }
 
-/// Class prefix, the same as ICS-20 TracePrefix
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Ord, PartialOrd, Eq, PartialEq)]
-pub struct TracePrefix {
-    port_id: PortId,
-    channel_id: ChannelId,
-}
-
-impl TracePrefix {
-    pub fn new(port_id: PortId, channel_id: ChannelId) -> Self {
-        Self {
-            port_id,
-            channel_id,
-        }
-    }
-}
-
-impl Display for TracePrefix {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        write!(f, "{}/{}", self.port_id, self.channel_id)
-    }
-}
-
-/// Class trace path, the same as ICS-20 TracePath
-#[cfg_attr(
-    feature = "parity-scale-codec",
-    derive(
-        parity_scale_codec::Encode,
-        parity_scale_codec::Decode,
-        scale_info::TypeInfo
-    )
-)]
-#[cfg_attr(
-    feature = "borsh",
-    derive(borsh::BorshSerialize, borsh::BorshDeserialize)
-)]
-#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
-#[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
-#[derive(Clone, Debug, Eq, PartialEq, PartialOrd, Ord, From)]
-pub struct TracePath(Vec<TracePrefix>);
-
-impl TracePath {
-    /// Returns true iff this path starts with the specified prefix
-    pub fn starts_with(&self, prefix: &TracePrefix) -> bool {
-        self.0.last().map(|p| p == prefix).unwrap_or(false)
-    }
-
-    /// Removes the specified prefix from the path if there is a match, otherwise does nothing.
-    pub fn remove_prefix(&mut self, prefix: &TracePrefix) {
-        if self.starts_with(prefix) {
-            self.0.pop();
-        }
-    }
-
-    /// Adds the specified prefix to the path.
-    pub fn add_prefix(&mut self, prefix: TracePrefix) {
-        self.0.push(prefix)
-    }
-
-    /// Returns true if the path is empty and false otherwise.
-    pub fn is_empty(&self) -> bool {
-        self.0.is_empty()
-    }
-
-    /// Return empty trace path
-    pub fn empty() -> Self {
-        Self(vec![])
-    }
-}
-
-impl<'a> TryFrom<Vec<&'a str>> for TracePath {
-    type Error = NftTransferError;
-
-    fn try_from(v: Vec<&'a str>) -> Result<Self, Self::Error> {
-        if v.len() % 2 != 0 {
-            return Err(NftTransferError::InvalidTraceLength {
-                len: v.len() as u64,
-            });
-        }
-
-        let mut trace = vec![];
-        let id_pairs = v.chunks_exact(2).map(|paths| (paths[0], paths[1]));
-        for (pos, (port_id, channel_id)) in id_pairs.rev().enumerate() {
-            let port_id =
-                PortId::from_str(port_id).map_err(|e| NftTransferError::InvalidTracePortId {
-                    pos: pos as u64,
-                    validation_error: e,
-                })?;
-            let channel_id = ChannelId::from_str(channel_id).map_err(|e| {
-                NftTransferError::InvalidTraceChannelId {
-                    pos: pos as u64,
-                    validation_error: e,
-                }
-            })?;
-            trace.push(TracePrefix {
-                port_id,
-                channel_id,
-            });
-        }
-
-        Ok(trace.into())
-    }
-}
-
-impl FromStr for TracePath {
-    type Err = NftTransferError;
-
-    fn from_str(s: &str) -> Result<Self, Self::Err> {
-        let parts = {
-            let parts: Vec<&str> = s.split('/').collect();
-            if parts.len() == 1 && parts[0].trim().is_empty() {
-                vec![]
-            } else {
-                parts
-            }
-        };
-        parts.try_into()
-    }
-}
-
-impl Display for TracePath {
-    fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        let path = self
-            .0
-            .iter()
-            .rev()
-            .map(|prefix| prefix.to_string())
-            .collect::<Vec<String>>()
-            .join("/");
-        write!(f, "{path}")
-    }
-}
-
 /// Prefixed class to trace sources like ICS-20 PrefixedDenom
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
@@ -267,24 +121,19 @@ pub fn is_receiver_chain_source(
 impl FromStr for PrefixedClassId {
     type Err = NftTransferError;
 
+    /// The parsing logic is same as [`FromStr`] impl of
+    /// [`PrefixedDenom`](ibc_app_transfer_types::PrefixedDenom) from ICS-20.
     fn from_str(s: &str) -> Result<Self, Self::Err> {
-        let mut parts: Vec<&str> = s.split('/').collect();
-        let last_part = parts.pop().expect("split() returned an empty iterator");
-
-        let (base_class_id, trace_path) = {
-            if last_part == s {
-                (ClassId::from_str(s)?, TracePath::empty())
-            } else {
-                let base_class_id = ClassId::from_str(last_part)?;
-                let trace_path = TracePath::try_from(parts)?;
-                (base_class_id, trace_path)
-            }
-        };
-
-        Ok(Self {
-            trace_path,
-            base_class_id,
-        })
+        match TracePath::trim(s) {
+            (trace_path, Some(remaining_parts)) => Ok(Self {
+                trace_path,
+                base_class_id: ClassId::from_str(remaining_parts)?,
+            }),
+            (_, None) => Ok(Self {
+                trace_path: TracePath::empty(),
+                base_class_id: ClassId::from_str(s)?,
+            }),
+        }
     }
 }
 
@@ -293,7 +142,9 @@ impl TryFrom<RawClassTrace> for PrefixedClassId {
 
     fn try_from(value: RawClassTrace) -> Result<Self, Self::Error> {
         let base_class_id = ClassId::from_str(&value.base_class_id)?;
-        let trace_path = TracePath::from_str(&value.path)?;
+        // FIXME: separate `TracePath` error.
+        let trace_path = TracePath::from_str(&value.path)
+            .map_err(|err| NftTransferError::Other(err.to_string()))?;
         Ok(Self {
             trace_path,
             base_class_id,
@@ -321,7 +172,7 @@ impl From<ClassId> for PrefixedClassId {
 
 impl Display for PrefixedClassId {
     fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), FmtError> {
-        if self.trace_path.0.is_empty() {
+        if self.trace_path.is_empty() {
             write!(f, "{}", self.base_class_id)
         } else {
             write!(f, "{}/{}", self.trace_path, self.base_class_id)
@@ -446,48 +297,50 @@ impl FromStr for ClassData {
 
 #[cfg(test)]
 mod tests {
-    use super::*;
+    use rstest::rstest;
 
-    #[test]
-    fn test_class_id_validation() -> Result<(), NftTransferError> {
-        assert!(ClassId::from_str("").is_err(), "empty base class ID");
-        assert!(ClassId::from_str("myclass").is_ok(), "valid base class ID");
-        assert!(PrefixedClassId::from_str("").is_err(), "empty class trace");
-        assert!(
-            PrefixedClassId::from_str("transfer/channel-0/").is_err(),
-            "empty base class ID with trace"
-        );
-        assert!(
-            PrefixedClassId::from_str("/myclass").is_err(),
-            "empty prefix"
-        );
-        assert!(PrefixedClassId::from_str("//myclass").is_err(), "empty ids");
-        assert!(
-            PrefixedClassId::from_str("transfer/").is_err(),
-            "single trace"
-        );
-        assert!(
-            PrefixedClassId::from_str("transfer/myclass").is_err(),
-            "single trace with base class ID"
-        );
-        assert!(
-            PrefixedClassId::from_str("transfer/channel-0/myclass").is_ok(),
-            "valid single trace info"
-        );
-        assert!(
-            PrefixedClassId::from_str("transfer/channel-0/transfer/channel-1/myclass").is_ok(),
-            "valid multiple trace info"
-        );
-        assert!(
-            PrefixedClassId::from_str("(transfer)/channel-0/myclass").is_err(),
-            "invalid port"
-        );
-        assert!(
-            PrefixedClassId::from_str("transfer/(channel-0)/myclass").is_err(),
-            "invalid channel"
-        );
+    use super::*;
 
-        Ok(())
+    #[rstest]
+    #[case("myclass")]
+    #[case("transfer/channel-0/myclass")]
+    #[case("transfer/channel-0/transfer/channel-1/myclass")]
+    #[case("(transfer)/channel-0/myclass")]
+    #[case("transfer/(channel-0)/myclass")]
+    fn test_valid_class_id(#[case] class_id: &str) {
+        ClassId::from_str(class_id).expect("success");
+    }
+
+    #[rstest]
+    #[case("")]
+    #[case("")]
+    #[case("  ")]
+    fn test_invalid_class_id(#[case] class_id: &str) {
+        ClassId::from_str(class_id).expect_err("failure");
+    }
+
+    #[rstest]
+    #[case("transfer/channel-0/myclass")]
+    #[case("/myclass")]
+    #[case("//myclass")]
+    #[case("transfer/")]
+    #[case("transfer/myclass")]
+    #[case("transfer/channel-0/myclass")]
+    #[case("transfer/channel-0/transfer/channel-1/myclass")]
+    #[case("(transfer)/channel-0/myclass")]
+    #[case("transfer/(channel-0)/myclass")]
+    #[case("transfer/channel-0///")]
+    fn test_valid_prefixed_class_id(#[case] class_id: &str) {
+        PrefixedClassId::from_str(class_id).expect("success");
+    }
+
+    #[rstest]
+    #[case("")]
+    #[case("  ")]
+    #[case("transfer/channel-0/")]
+    #[case("transfer/channel-0/  ")]
+    fn test_invalid_prefixed_class_id(#[case] class_id: &str) {
+        PrefixedClassId::from_str(class_id).expect_err("failure");
     }
 
     #[test]
@@ -495,7 +348,7 @@ mod tests {
         assert_eq!(
             PrefixedClassId::from_str("transfer/channel-0/myclass")?,
             PrefixedClassId {
-                trace_path: "transfer/channel-0".parse()?,
+                trace_path: "transfer/channel-0".parse().expect("success"),
                 base_class_id: "myclass".parse()?
             },
             "valid single trace info"
@@ -503,7 +356,9 @@ mod tests {
         assert_eq!(
             PrefixedClassId::from_str("transfer/channel-0/transfer/channel-1/myclass")?,
             PrefixedClassId {
-                trace_path: "transfer/channel-0/transfer/channel-1".parse()?,
+                trace_path: "transfer/channel-0/transfer/channel-1"
+                    .parse()
+                    .expect("success"),
                 base_class_id: "myclass".parse()?
             },
             "valid multiple trace info"
@@ -543,21 +398,24 @@ mod tests {
 
         let prefix_1 = TracePrefix::new("transfer".parse().unwrap(), "channel-1".parse().unwrap());
         let prefix_2 = TracePrefix::new("transfer".parse().unwrap(), "channel-0".parse().unwrap());
-        let mut trace_path = TracePath(vec![prefix_1.clone()]);
+        let mut trace_path = TracePath::from(vec![prefix_1.clone()]);
 
         trace_path.add_prefix(prefix_2.clone());
         assert_eq!(
-            TracePath::from_str("transfer/channel-0/transfer/channel-1")?,
+            TracePath::from_str("transfer/channel-0/transfer/channel-1").expect("success"),
             trace_path
         );
         assert_eq!(
-            TracePath(vec![prefix_1.clone(), prefix_2.clone()]),
+            TracePath::from(vec![prefix_1.clone(), prefix_2.clone()]),
             trace_path
         );
 
         trace_path.remove_prefix(&prefix_2);
-        assert_eq!(TracePath::from_str("transfer/channel-1")?, trace_path);
-        assert_eq!(TracePath(vec![prefix_1.clone()]), trace_path);
+        assert_eq!(
+            TracePath::from_str("transfer/channel-1").expect("success"),
+            trace_path
+        );
+        assert_eq!(TracePath::from(vec![prefix_1.clone()]), trace_path);
 
         trace_path.remove_prefix(&prefix_1);
         assert!(trace_path.is_empty());
diff --git a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
index 5d4583dc6..c8f9e30d7 100644
--- a/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/channel_id.rs
@@ -88,9 +88,9 @@ impl AsRef<str> for ChannelId {
 /// ```
 /// use core::str::FromStr;
 /// use ibc_core_host_types::identifiers::ChannelId;
-/// let channel_id = ChannelId::from_str("channelId-0");
+/// let channel_id = ChannelId::from_str("channel-0");
 /// assert!(channel_id.is_ok());
-/// channel_id.map(|id| {assert_eq!(&id, "channelId-0")});
+/// channel_id.map(|id| {assert_eq!(&id, "channel-0")});
 /// ```
 impl PartialEq<str> for ChannelId {
     fn eq(&self, other: &str) -> bool {
diff --git a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
index 883c41138..9fe9657cc 100644
--- a/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/connection_id.rs
@@ -82,9 +82,9 @@ impl FromStr for ConnectionId {
 /// ```
 /// use core::str::FromStr;
 /// use ibc_core_host_types::identifiers::ConnectionId;
-/// let conn_id = ConnectionId::from_str("connectionId-0");
+/// let conn_id = ConnectionId::from_str("connection-0");
 /// assert!(conn_id.is_ok());
-/// conn_id.map(|id| {assert_eq!(&id, "connectionId-0")});
+/// conn_id.map(|id| {assert_eq!(&id, "connection-0")});
 /// ```
 impl PartialEq<str> for ConnectionId {
     fn eq(&self, other: &str) -> bool {
diff --git a/ibc-core/ics24-host/types/src/validate.rs b/ibc-core/ics24-host/types/src/validate.rs
index 47a92ac72..8346ff912 100644
--- a/ibc-core/ics24-host/types/src/validate.rs
+++ b/ibc-core/ics24-host/types/src/validate.rs
@@ -1,6 +1,7 @@
 use ibc_primitives::prelude::*;
 
 use crate::error::IdentifierError as Error;
+use crate::identifiers::{ChannelId, ConnectionId};
 
 const VALID_SPECIAL_CHARS: &str = "._+-#[]<>";
 
@@ -61,6 +62,26 @@ pub fn validate_prefix_length(
     validate_identifier_length(prefix, min, max)
 }
 
+/// Checks if the identifier is a valid named u64 index: {name}-{u64}.
+/// Example: "connection-0", "connection-100", "channel-0", "channel-100".
+pub fn validate_named_u64_index(id: &str, name: &str) -> Result<(), Error> {
+    let number_s = id
+        .strip_prefix(name)
+        .ok_or_else(|| Error::InvalidPrefix { prefix: id.into() })?
+        .strip_prefix('-')
+        .ok_or_else(|| Error::InvalidPrefix { prefix: id.into() })?;
+
+    if number_s.starts_with('0') && number_s.len() > 1 {
+        return Err(Error::InvalidPrefix { prefix: id.into() });
+    }
+
+    _ = number_s
+        .parse::<u64>()
+        .map_err(|_| Error::InvalidPrefix { prefix: id.into() })?;
+
+    Ok(())
+}
+
 /// Default validator function for the Client types.
 pub fn validate_client_type(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
@@ -82,7 +103,9 @@ pub fn validate_client_identifier(id: &str) -> Result<(), Error> {
 /// in the ICS-24 spec.
 pub fn validate_connection_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
-    validate_identifier_length(id, 10, 64)
+    validate_identifier_length(id, 10, 64)?;
+    validate_named_u64_index(id, ConnectionId::prefix())?;
+    Ok(())
 }
 
 /// Default validator function for Port identifiers.
@@ -100,7 +123,9 @@ pub fn validate_port_identifier(id: &str) -> Result<(), Error> {
 /// the ICS-24 spec.
 pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
-    validate_identifier_length(id, 8, 64)
+    validate_identifier_length(id, 8, 64)?;
+    validate_named_u64_index(id, ChannelId::prefix())?;
+    Ok(())
 }
 
 #[cfg(test)]
@@ -141,6 +166,24 @@ mod tests {
         assert!(id.is_err())
     }
 
+    #[test]
+    fn parse_invalid_connection_id_indexed() {
+        // valid connection id with index
+        validate_connection_identifier("connection-0").expect("success");
+        validate_connection_identifier("connection-123").expect("success");
+        validate_connection_identifier("connection-18446744073709551615").expect("success");
+    }
+
+    #[test]
+    fn parse_invalid_connection_id_non_indexed() {
+        // invalid indexing for connection id
+        validate_connection_identifier("connection-0123").expect_err("failure");
+        validate_connection_identifier("connection0123").expect_err("failure");
+        validate_connection_identifier("connection000").expect_err("failure");
+        // 1 << 64 = 18446744073709551616
+        validate_connection_identifier("connection-18446744073709551616").expect_err("failure");
+    }
+
     #[test]
     fn parse_invalid_channel_id_min() {
         // invalid channel id, must be at least 8 characters
@@ -157,6 +200,24 @@ mod tests {
         assert!(id.is_err())
     }
 
+    #[test]
+    fn parse_invalid_channel_id_indexed() {
+        // valid channel id with index
+        validate_channel_identifier("channel-0").expect("success");
+        validate_channel_identifier("channel-123").expect("success");
+        validate_channel_identifier("channel-18446744073709551615").expect("success");
+    }
+
+    #[test]
+    fn parse_invalid_channel_id_non_indexed() {
+        // invalid indexing for channel id
+        validate_channel_identifier("channel-0123").expect_err("failure");
+        validate_channel_identifier("channel0123").expect_err("failure");
+        validate_channel_identifier("channel000").expect_err("failure");
+        // 1 << 64 = 18446744073709551616
+        validate_channel_identifier("channel-18446744073709551616").expect_err("failure");
+    }
+
     #[test]
     fn parse_invalid_client_id_min() {
         // invalid min client id
@@ -242,4 +303,17 @@ mod tests {
         let result = validate_prefix_length(prefix, min, max);
         assert_eq!(result.is_ok(), success);
     }
+
+    #[rstest]
+    #[case::zero_padded("channel", "001", false)]
+    #[case::only_zero("connection", "000", false)]
+    #[case::zero("channel", "0", true)]
+    #[case::one("connection", "1", true)]
+    #[case::n1234("channel", "1234", true)]
+    #[case::u64_max("chan", "18446744073709551615", true)]
+    #[case::u64_max_plus_1("chan", "18446744073709551616", false)]
+    fn test_named_index_validation(#[case] name: &str, #[case] id: &str, #[case] success: bool) {
+        let result = validate_named_u64_index(format!("{name}-{id}").as_str(), name);
+        assert_eq!(result.is_ok(), success, "{result:?}");
+    }
 }
diff --git a/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs b/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
index 151ab7e37..9a5014b87 100644
--- a/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
+++ b/ibc-testkit/src/fixtures/core/connection/conn_open_confirm.rs
@@ -14,7 +14,7 @@ pub fn dummy_conn_open_confirm() -> MsgConnectionOpenConfirm {
 /// Returns a dummy `RawMsgConnectionOpenConfirm` for testing purposes only!
 pub fn dummy_raw_msg_conn_open_confirm() -> RawMsgConnectionOpenConfirm {
     RawMsgConnectionOpenConfirm {
-        connection_id: "srcconnection".to_string(),
+        connection_id: "connection-118".to_string(),
         proof_ack: dummy_proof(),
         proof_height: Some(Height {
             revision_number: 0,

From 67d0735d3acc41ddadf8b20eb4b77c02f3707435 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Fri, 26 Apr 2024 13:59:52 -0500
Subject: [PATCH 162/182] Release v0.52.0 (#1199)

* Add 0.52 release summary

* Update changelog file and summary.md

* Bump ibc-derive version

* Update ibc-derive deps version

* Update Cargo.lock

* Update ibc crate versions

* Ensure changelog file's format isn't changed

* Run unclog release

* Update cw-check Cargo.lock

* update no-std-check cargo lockfile

* Incorporate PR feedback

* update summary.md

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 ...ke-ics07-custom-context-traits-portable.md |   0
 .../1168-discard-TmVerifier.md                |   0
 .../breaking-changes/1193-bump-msrv.md        |   0
 ...-query-height-in-query-helper-functions.md |   0
 .../1177-fix-prefixed-denom-parsing.md        |   0
 .../1179-fix-packet-attribute-name.md         |   0
 ...4-implement-cosmwasm-integrator-library.md |   0
 ...osmwasm-contract-for-tendermint-clients.md |   0
 .../features/738-client-recovery.md           |   0
 ...1108-fallible-conversion-of-ics23-types.md |   0
 .../1145-tendermint-boxed-header.md           |   0
 ...ten-client-message-verification-methods.md |   0
 ...ht-and-proof-for-client-upgrade-queries.md |   0
 ...dd-into-inner-for-ics07-consensus-state.md |   0
 ...71-update-ibc-proto-and-tendermint-deps.md |   0
 .changelog/v0.52.0/summary.md                 |  18 ++
 CHANGELOG.md                                  |  82 +++++++++
 Cargo.toml                                    |  64 +++----
 ci/cw-check/Cargo.lock                        |  44 ++---
 ci/no-std-check/Cargo.lock                    | 171 ++++++------------
 ibc-derive/Cargo.toml                         |   2 +-
 21 files changed, 215 insertions(+), 166 deletions(-)
 rename .changelog/{unreleased => v0.52.0}/breaking-changes/1163-make-ics07-custom-context-traits-portable.md (100%)
 rename .changelog/{unreleased => v0.52.0}/breaking-changes/1168-discard-TmVerifier.md (100%)
 rename .changelog/{unreleased => v0.52.0}/breaking-changes/1193-bump-msrv.md (100%)
 rename .changelog/{unreleased => v0.52.0}/bug-fixes/1154-use-query-height-in-query-helper-functions.md (100%)
 rename .changelog/{unreleased => v0.52.0}/bug-fixes/1177-fix-prefixed-denom-parsing.md (100%)
 rename .changelog/{unreleased => v0.52.0}/bug-fixes/1179-fix-packet-attribute-name.md (100%)
 rename .changelog/{unreleased => v0.52.0}/features/1164-implement-cosmwasm-integrator-library.md (100%)
 rename .changelog/{unreleased => v0.52.0}/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md (100%)
 rename .changelog/{unreleased => v0.52.0}/features/738-client-recovery.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1108-fallible-conversion-of-ics23-types.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1145-tendermint-boxed-header.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1149-flatten-client-message-verification-methods.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1156-add-into-inner-for-ics07-consensus-state.md (100%)
 rename .changelog/{unreleased => v0.52.0}/improvements/1171-update-ibc-proto-and-tendermint-deps.md (100%)
 create mode 100644 .changelog/v0.52.0/summary.md

diff --git a/.changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md b/.changelog/v0.52.0/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
rename to .changelog/v0.52.0/breaking-changes/1163-make-ics07-custom-context-traits-portable.md
diff --git a/.changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md b/.changelog/v0.52.0/breaking-changes/1168-discard-TmVerifier.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1168-discard-TmVerifier.md
rename to .changelog/v0.52.0/breaking-changes/1168-discard-TmVerifier.md
diff --git a/.changelog/unreleased/breaking-changes/1193-bump-msrv.md b/.changelog/v0.52.0/breaking-changes/1193-bump-msrv.md
similarity index 100%
rename from .changelog/unreleased/breaking-changes/1193-bump-msrv.md
rename to .changelog/v0.52.0/breaking-changes/1193-bump-msrv.md
diff --git a/.changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md b/.changelog/v0.52.0/bug-fixes/1154-use-query-height-in-query-helper-functions.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1154-use-query-height-in-query-helper-functions.md
rename to .changelog/v0.52.0/bug-fixes/1154-use-query-height-in-query-helper-functions.md
diff --git a/.changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md b/.changelog/v0.52.0/bug-fixes/1177-fix-prefixed-denom-parsing.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1177-fix-prefixed-denom-parsing.md
rename to .changelog/v0.52.0/bug-fixes/1177-fix-prefixed-denom-parsing.md
diff --git a/.changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md b/.changelog/v0.52.0/bug-fixes/1179-fix-packet-attribute-name.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1179-fix-packet-attribute-name.md
rename to .changelog/v0.52.0/bug-fixes/1179-fix-packet-attribute-name.md
diff --git a/.changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md b/.changelog/v0.52.0/features/1164-implement-cosmwasm-integrator-library.md
similarity index 100%
rename from .changelog/unreleased/features/1164-implement-cosmwasm-integrator-library.md
rename to .changelog/v0.52.0/features/1164-implement-cosmwasm-integrator-library.md
diff --git a/.changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md b/.changelog/v0.52.0/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
similarity index 100%
rename from .changelog/unreleased/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
rename to .changelog/v0.52.0/features/1165-implement-cosmwasm-contract-for-tendermint-clients.md
diff --git a/.changelog/unreleased/features/738-client-recovery.md b/.changelog/v0.52.0/features/738-client-recovery.md
similarity index 100%
rename from .changelog/unreleased/features/738-client-recovery.md
rename to .changelog/v0.52.0/features/738-client-recovery.md
diff --git a/.changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md b/.changelog/v0.52.0/improvements/1108-fallible-conversion-of-ics23-types.md
similarity index 100%
rename from .changelog/unreleased/improvements/1108-fallible-conversion-of-ics23-types.md
rename to .changelog/v0.52.0/improvements/1108-fallible-conversion-of-ics23-types.md
diff --git a/.changelog/unreleased/improvements/1145-tendermint-boxed-header.md b/.changelog/v0.52.0/improvements/1145-tendermint-boxed-header.md
similarity index 100%
rename from .changelog/unreleased/improvements/1145-tendermint-boxed-header.md
rename to .changelog/v0.52.0/improvements/1145-tendermint-boxed-header.md
diff --git a/.changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md b/.changelog/v0.52.0/improvements/1149-flatten-client-message-verification-methods.md
similarity index 100%
rename from .changelog/unreleased/improvements/1149-flatten-client-message-verification-methods.md
rename to .changelog/v0.52.0/improvements/1149-flatten-client-message-verification-methods.md
diff --git a/.changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md b/.changelog/v0.52.0/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md
similarity index 100%
rename from .changelog/unreleased/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md
rename to .changelog/v0.52.0/improvements/1152-add-query-height-and-proof-for-client-upgrade-queries.md
diff --git a/.changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md b/.changelog/v0.52.0/improvements/1156-add-into-inner-for-ics07-consensus-state.md
similarity index 100%
rename from .changelog/unreleased/improvements/1156-add-into-inner-for-ics07-consensus-state.md
rename to .changelog/v0.52.0/improvements/1156-add-into-inner-for-ics07-consensus-state.md
diff --git a/.changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md b/.changelog/v0.52.0/improvements/1171-update-ibc-proto-and-tendermint-deps.md
similarity index 100%
rename from .changelog/unreleased/improvements/1171-update-ibc-proto-and-tendermint-deps.md
rename to .changelog/v0.52.0/improvements/1171-update-ibc-proto-and-tendermint-deps.md
diff --git a/.changelog/v0.52.0/summary.md b/.changelog/v0.52.0/summary.md
new file mode 100644
index 000000000..eeb7f51bb
--- /dev/null
+++ b/.changelog/v0.52.0/summary.md
@@ -0,0 +1,18 @@
+This release adds some exciting changes, improvements, and new features to ibc-rs.
+First and foremost, support for the IBC protocol's [client recovery][client-recovery]
+mechanism has been implemented, which provides a route for frozen and expired IBC clients
+to be re-instated following a successful governance vote. In addition, a new crate,
+`ibc-client-cw`, facilitates CosmWasm contract creation for light clients built using
+`ibc-rs`. Lastly, the ics07 tendermint light client has also been packaged and included
+as a CosmWasm contract.
+
+This release also includes a myriad of other bug-fixes and improvements,
+such as enhancing the portability of ibc-rs's Validation and Execution Context traits,
+as well as fixing an incompatibility with how ibc-rs parses `PrefixDenom`s compared
+to ibc-go, among many others.
+
+The minimum-supported Rust version has been updated to `1.72`. `ibc-proto` has been
+bumped to `0.43`. `tendermint` has been bumped to `0.35`. `ibc-derive` has been
+bumped to `0.7`.
+
+There are no consensus-breaking changes as part of this release.
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 63a24bed5..772427d3b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,87 @@
 # CHANGELOG
 
+## v0.52.0
+
+*April 26, 2024*
+
+This release adds some exciting changes, improvements, and new features to ibc-rs.
+First and foremost, support for the IBC protocol's [client recovery][client-recovery]
+mechanism has been implemented, which provides a route for frozen and expired IBC clients
+to be re-instated following a successful governance vote. In addition, a new crate,
+`ibc-client-cw`, facilitates CosmWasm contract creation for light clients built using
+`ibc-rs`. Lastly, the ics07 tendermint light client has also been packaged and included
+as a CosmWasm contract.
+
+This release also includes a myriad of other bug-fixes and improvements,
+such as enhancing the portability of ibc-rs's Validation and Execution Context traits,
+as well as fixing an incompatibility with how ibc-rs parses `PrefixDenom`s compared
+to ibc-go, among many others.
+
+The minimum-supported Rust version has been updated to `1.72`. `ibc-proto` has been
+bumped to `0.43`. `tendermint` has been bumped to `0.35`. `ibc-derive` has been
+bumped to `0.7`.
+
+There are no consensus-breaking changes as part of this release.
+
+### BREAKING CHANGES
+
+- [ibc] Enhance portability of custom `Validation/ExecutionContext` traits under
+  ICS-07. They are relocated, along with the rest of the
+  client-relevant context APIs, under ICS-02, with the traits renamed to
+  `ExtClientValidationContext` and `ExtClientExecutionContext` for improved
+  self-description ([\#1163](https://github.com/cosmos/ibc-rs/issues/1163))
+- [ibc-client-tendermint] Simplify custom verifiers usage for Tendermint
+  clients by directly binding with `tendermint_light_client_verifier::Verifier`
+  and removing the unused `TmVerifier` trait.
+  ([\#1168](https://github.com/cosmos/ibc-rs/pull/1168))
+- [ibc] Update minimum supported Rust version to 1.72.
+  ([\#1193](https://github.com/cosmos/ibc-rs/issues/1193))
+
+### BUG FIXES
+
+- [ibc-query] Update standalone query functions to use the specified query
+  height ([\#1154](https://github.com/cosmos/ibc-rs/issues/1154))
+- [ibc-app-transfer] Bring `PrefixedDenom` parsing up to parity with `ibc-go`.
+  ([\#1177](https://github.com/cosmos/ibc-rs/issues/1177))
+- [ibc-app-nft-transfer] Reuse `TracePrefix` and `TracePath` from
+  `ibc-app-transfer-types` when parsing `PrefixedClassId`.
+  ([\#1178](https://github.com/cosmos/ibc-rs/pull/1178))
+- [ibc-core-channel-types] Make receive packet event type identifier consistent
+  with `ibc-go`. ([\#1180](https://github.com/cosmos/ibc-rs/issues/1180))
+
+### FEATURES
+
+- [ibc-core-client] Implement [client recovery][client-recovery] feature.
+  ([\#738](https://github.com/cosmos/ibc-rs/issues/738))
+- [ibc-clients] Introduce CosmWasm context library as `ibc-client-cw` crate to
+  facilitate CosmWasm contract creation for light clients built using `ibc-rs`
+  ([\#1164](https://github.com/cosmos/ibc-rs/issues/1164))
+- [ibc-client-tendermint] Introduce `ibc-client-tendermint-cw` crate
+  implementing CosmWasm contract for ICS-07 Tendermint light client.
+  ([\#1165](https://github.com/cosmos/ibc-rs/issues/1165))
+
+[client-recovery]: https://github.com/cosmos/ibc-go/blob/main/docs/architecture/adr-026-ibc-client-recovery-mechanisms.md
+
+### IMPROVEMENTS
+
+- [ibc-core-commitment-types] Fallible conversion for `ProofSpec`, `LeafOp` and
+  `InnerSpec`. ([\#1108](https://github.com/cosmos/ibc-rs/issues/1108))
+- [ibc-client-tendermint-types] Box header fields inside of Misbehaviour type so
+  that the type is smaller (i.e. trade size of the type for heap memory). This
+  prevents stack overflows on systems with small stack (e.g. Solana).
+  ([\#1145](https://github.com/cosmos/ibc-rs/pull/1145))
+- [ibc-client-tendermint] Decouple the arguments of ICS07 Header/Misbehavior
+  verification functions from the Tendermint client type by flattening and
+  passing only the required fields.
+  ([\#1149](https://github.com/cosmos/ibc-rs/issues/1149))
+- [ibc-query] Add support for querying `upgraded_client/consensus_state` at a
+  given height along with returning their proof of existence in the response.
+  ([\#1152](https://github.com/cosmos/ibc-rs/issues/1152))
+- [ibc-client-tendermint] Add `into_inner()` method to ICS07 `ConsensusState`
+  ([\#1156](https://github.com/cosmos/ibc-rs/pull/1156))
+- Update `ibc-proto` to v0.43.0 and `tendermint` dependencies to v0.35.0.
+  ([\#1171](https://github.com/cosmos/ibc-rs/issues/1171))
+
 ## v0.51.0
 
 *March 26, 2024*
diff --git a/Cargo.toml b/Cargo.toml
index 013dcdf8b..fc9a7c5ad 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -42,7 +42,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.51.0"
+version      = "0.52.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.72"
@@ -65,42 +65,42 @@ serde_json          = { package = "serde-json-wasm", version = "1.0.1", default-
 subtle-encoding     = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                         = { version = "0.51.0", path = "./ibc", default-features = false }
-ibc-core                    = { version = "0.51.0", path = "./ibc-core", default-features = false }
-ibc-clients                 = { version = "0.51.0", path = "./ibc-clients", default-features = false }
-ibc-apps                    = { version = "0.51.0", path = "./ibc-apps", default-features = false }
-ibc-primitives              = { version = "0.51.0", path = "./ibc-primitives", default-features = false }
-ibc-testkit                 = { version = "0.51.0", path = "./ibc-testkit", default-features = false }
+ibc                         = { version = "0.52.0", path = "./ibc", default-features = false }
+ibc-core                    = { version = "0.52.0", path = "./ibc-core", default-features = false }
+ibc-clients                 = { version = "0.52.0", path = "./ibc-clients", default-features = false }
+ibc-apps                    = { version = "0.52.0", path = "./ibc-apps", default-features = false }
+ibc-primitives              = { version = "0.52.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit                 = { version = "0.52.0", path = "./ibc-testkit", default-features = false }
 
-ibc-derive                  = { version = "0.6.1", path = "./ibc-derive" }
+ibc-derive                  = { version = "0.7.0", path = "./ibc-derive" }
 
-ibc-core-client             = { version = "0.51.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection         = { version = "0.51.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel            = { version = "0.51.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host               = { version = "0.51.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler            = { version = "0.51.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router             = { version = "0.51.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-core-client             = { version = "0.52.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection         = { version = "0.52.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel            = { version = "0.52.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host               = { version = "0.52.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler            = { version = "0.52.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router             = { version = "0.52.0", path = "./ibc-core/ics26-routing", default-features = false }
 
-ibc-client-cw               = { version = "0.51.0", path = "./ibc-clients/cw-context", default-features = false }
-ibc-client-tendermint       = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-client-tendermint-cw    = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
+ibc-client-cw               = { version = "0.52.0", path = "./ibc-clients/cw-context", default-features = false }
+ibc-client-tendermint       = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-client-tendermint-cw    = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
 
-ibc-app-transfer            = { version = "0.51.0", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer        = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-app-transfer            = { version = "0.52.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer        = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.51.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.51.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.51.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.51.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.51.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.51.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.51.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.51.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.51.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.51.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-client-wasm-types       = { version = "0.51.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.51.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
-ibc-app-nft-transfer-types  = { version = "0.51.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.52.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.52.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.52.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.52.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.52.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.52.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.52.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.52.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.52.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-client-wasm-types       = { version = "0.52.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.52.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-app-nft-transfer-types  = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.43.0", default-features = false }
 
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index 69876a2c1..db9237c00 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -598,7 +598,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -607,7 +607,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -622,14 +622,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -644,7 +644,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -658,7 +658,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -679,7 +679,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -691,7 +691,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -706,7 +706,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -724,7 +724,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -740,7 +740,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -751,7 +751,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -770,7 +770,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -784,7 +784,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -806,7 +806,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -823,7 +823,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -836,7 +836,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -849,7 +849,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -866,7 +866,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.6.1"
+version = "0.7.0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -875,7 +875,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1644,9 +1644,9 @@ dependencies = [
 
 [[package]]
 name = "zeroize"
-version = "1.8.0"
+version = "1.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63381fa6624bf92130a6b87c0d07380116f80b565c42cf0d754136f0238359ef"
+checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 4c35268f5..8b98fa57e 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -320,6 +320,12 @@ version = "1.3.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bef38d45163c2f1dde094a7dfd33ccf595c92905c8f8f4fdc18d06fb1037718a"
 
+[[package]]
+name = "bitflags"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "cf4b9d6a944f767f8e5e0db018570623c85f3d925ac718db4e06d0187adb21c1"
+
 [[package]]
 name = "bitvec"
 version = "1.0.1"
@@ -497,7 +503,7 @@ dependencies = [
  "android-tzdata",
  "iana-time-zone",
  "num-traits",
- "windows-targets 0.52.5",
+ "windows-targets",
 ]
 
 [[package]]
@@ -1191,7 +1197,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1203,7 +1209,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1212,7 +1218,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1225,14 +1231,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "ibc-client-tendermint-types",
@@ -1248,7 +1254,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1264,7 +1270,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-wasm-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "base64 0.21.7",
  "displaydoc",
@@ -1277,7 +1283,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-client-tendermint",
  "ibc-client-wasm-types",
@@ -1285,7 +1291,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1300,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1314,7 +1320,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1332,7 +1338,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1344,7 +1350,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1359,7 +1365,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1374,7 +1380,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1387,7 +1393,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1398,7 +1404,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1414,7 +1420,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1428,7 +1434,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1447,7 +1453,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1464,7 +1470,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1486,7 +1492,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1496,7 +1502,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1509,7 +1515,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1523,7 +1529,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-derive"
-version = "0.6.1"
+version = "0.7.0"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1532,7 +1538,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-primitives"
-version = "0.51.0"
+version = "0.52.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1758,9 +1764,9 @@ dependencies = [
 
 [[package]]
 name = "lock_api"
-version = "0.4.11"
+version = "0.4.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3c168f8615b12bc01f9c17e2eb0cc07dcae1940121185446edc3744920e8ef45"
+checksum = "07af8b9cdd281b7915f413fa73f29ebd5d55d0d3f0155584dade1ff18cea1b17"
 dependencies = [
  "autocfg",
  "scopeguard",
@@ -1968,9 +1974,9 @@ dependencies = [
 
 [[package]]
 name = "parking_lot"
-version = "0.12.1"
+version = "0.12.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3742b2c103b9f06bc9fff0a37ff4912935851bee6d36f3c02bcc755bcfec228f"
+checksum = "7e4af0ca4f6caed20e900d564c242b8e5d4903fdacf31d3daf527b66fe6f42fb"
 dependencies = [
  "lock_api",
  "parking_lot_core",
@@ -1978,15 +1984,15 @@ dependencies = [
 
 [[package]]
 name = "parking_lot_core"
-version = "0.9.9"
+version = "0.9.10"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4c42a9226546d68acdd9c0a280d17ce19bfe27a46bf68784e4066115788d008e"
+checksum = "1e401f977ab385c9e4e3ab30627d6f26d00e2c73eef317493c4ec6d468726cf8"
 dependencies = [
  "cfg-if",
  "libc",
  "redox_syscall",
  "smallvec",
- "windows-targets 0.48.5",
+ "windows-targets",
 ]
 
 [[package]]
@@ -2247,11 +2253,11 @@ dependencies = [
 
 [[package]]
 name = "redox_syscall"
-version = "0.4.1"
+version = "0.5.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "4722d768eff46b75989dd134e5c353f0d6296e5aaa3132e776cbdb56be7731aa"
+checksum = "469052894dcb553421e483e4209ee581a45100d31b4018de03e5a7ad86374a7e"
 dependencies = [
- "bitflags",
+ "bitflags 2.5.0",
 ]
 
 [[package]]
@@ -2679,7 +2685,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "bb2dac7e47c7ddbb61efe196d5cce99f6ea88926c961fa39909bfeae46fc5a7b"
 dependencies = [
  "array-bytes",
- "bitflags",
+ "bitflags 1.3.2",
  "blake2",
  "bounded-collections",
  "bs58",
@@ -3275,7 +3281,7 @@ dependencies = [
  "serde",
  "serde_spanned",
  "toml_datetime",
- "winnow 0.6.6",
+ "winnow 0.6.7",
 ]
 
 [[package]]
@@ -3550,9 +3556,9 @@ checksum = "ac3b87c63620426dd9b991e5ce0329eff545bccbbb34f3be09ff6fb6ab51b7b6"
 
 [[package]]
 name = "winapi-util"
-version = "0.1.7"
+version = "0.1.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "134306a13c5647ad6453e8deaec55d3a44d6021970129e6188735e74bf546697"
+checksum = "4d4cc384e1e73b93bafa6fb4f1df8c41695c8a91cf9c4c64358067d15a7b6c6b"
 dependencies = [
  "windows-sys",
 ]
@@ -3569,7 +3575,7 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "33ab640c8d7e35bf8ba19b884ba838ceb4fba93a4e8c65a9059d08afcfc683d9"
 dependencies = [
- "windows-targets 0.52.5",
+ "windows-targets",
 ]
 
 [[package]]
@@ -3578,22 +3584,7 @@ version = "0.52.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "282be5f36a8ce781fad8c8ae18fa3f9beff57ec1b52cb3de0789201425d9a33d"
 dependencies = [
- "windows-targets 0.52.5",
-]
-
-[[package]]
-name = "windows-targets"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9a2fa6e2155d7247be68c096456083145c183cbbbc2764150dda45a87197940c"
-dependencies = [
- "windows_aarch64_gnullvm 0.48.5",
- "windows_aarch64_msvc 0.48.5",
- "windows_i686_gnu 0.48.5",
- "windows_i686_msvc 0.48.5",
- "windows_x86_64_gnu 0.48.5",
- "windows_x86_64_gnullvm 0.48.5",
- "windows_x86_64_msvc 0.48.5",
+ "windows-targets",
 ]
 
 [[package]]
@@ -3602,46 +3593,28 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6f0713a46559409d202e70e28227288446bf7841d3211583a4b53e3f6d96e7eb"
 dependencies = [
- "windows_aarch64_gnullvm 0.52.5",
- "windows_aarch64_msvc 0.52.5",
- "windows_i686_gnu 0.52.5",
+ "windows_aarch64_gnullvm",
+ "windows_aarch64_msvc",
+ "windows_i686_gnu",
  "windows_i686_gnullvm",
- "windows_i686_msvc 0.52.5",
- "windows_x86_64_gnu 0.52.5",
- "windows_x86_64_gnullvm 0.52.5",
- "windows_x86_64_msvc 0.52.5",
+ "windows_i686_msvc",
+ "windows_x86_64_gnu",
+ "windows_x86_64_gnullvm",
+ "windows_x86_64_msvc",
 ]
 
-[[package]]
-name = "windows_aarch64_gnullvm"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2b38e32f0abccf9987a4e3079dfb67dcd799fb61361e53e2882c3cbaf0d905d8"
-
 [[package]]
 name = "windows_aarch64_gnullvm"
 version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7088eed71e8b8dda258ecc8bac5fb1153c5cffaf2578fc8ff5d61e23578d3263"
 
-[[package]]
-name = "windows_aarch64_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "dc35310971f3b2dbbf3f0690a219f40e2d9afcf64f9ab7cc1be722937c26b4bc"
-
 [[package]]
 name = "windows_aarch64_msvc"
 version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "9985fd1504e250c615ca5f281c3f7a6da76213ebd5ccc9561496568a2752afb6"
 
-[[package]]
-name = "windows_i686_gnu"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "a75915e7def60c94dcef72200b9a8e58e5091744960da64ec734a6c6e9b3743e"
-
 [[package]]
 name = "windows_i686_gnu"
 version = "0.52.5"
@@ -3654,48 +3627,24 @@ version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "87f4261229030a858f36b459e748ae97545d6f1ec60e5e0d6a3d32e0dc232ee9"
 
-[[package]]
-name = "windows_i686_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8f55c233f70c4b27f66c523580f78f1004e8b5a8b659e05a4eb49d4166cca406"
-
 [[package]]
 name = "windows_i686_msvc"
 version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "db3c2bf3d13d5b658be73463284eaf12830ac9a26a90c717b7f771dfe97487bf"
 
-[[package]]
-name = "windows_x86_64_gnu"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "53d40abd2583d23e4718fddf1ebec84dbff8381c07cae67ff7768bbf19c6718e"
-
 [[package]]
 name = "windows_x86_64_gnu"
 version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "4e4246f76bdeff09eb48875a0fd3e2af6aada79d409d33011886d3e1581517d9"
 
-[[package]]
-name = "windows_x86_64_gnullvm"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0b7b52767868a23d5bab768e390dc5f5c55825b6d30b86c844ff2dc7414044cc"
-
 [[package]]
 name = "windows_x86_64_gnullvm"
 version = "0.52.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "852298e482cd67c356ddd9570386e2862b5673c85bd5f88df9ab6802b334c596"
 
-[[package]]
-name = "windows_x86_64_msvc"
-version = "0.48.5"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed94fce61571a4006852b7389a063ab983c02eb1bb37b47f8272ce92d06d9538"
-
 [[package]]
 name = "windows_x86_64_msvc"
 version = "0.52.5"
@@ -3713,9 +3662,9 @@ dependencies = [
 
 [[package]]
 name = "winnow"
-version = "0.6.6"
+version = "0.6.7"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f0c976aaaa0e1f90dbb21e9587cdaf1d9679a1cde8875c0d6bd83ab96a208352"
+checksum = "14b9415ee827af173ebb3f15f9083df5a122eb93572ec28741fb153356ea2578"
 dependencies = [
  "memchr",
 ]
@@ -3751,9 +3700,9 @@ dependencies = [
 
 [[package]]
 name = "zeroize"
-version = "1.8.0"
+version = "1.7.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63381fa6624bf92130a6b87c0d07380116f80b565c42cf0d754136f0238359ef"
+checksum = "525b4ec142c6b68a2d10f01f7bbf6755599ca3f81ea53b8431b7dd348f5fdb2d"
 dependencies = [
  "zeroize_derive",
 ]
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 3161d8d1c..90abcab43 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name        = "ibc-derive"
-version     = "0.6.1"
+version     = "0.7.0"
 license     = { workspace = true }
 repository  = { workspace = true }
 edition     = { workspace = true }

From ed4f8cd9ca2aec733a5277a07ce0d93cd2d8c003 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 30 Apr 2024 16:24:27 +0200
Subject: [PATCH 163/182] ci(release): enforce acyclic dep order during release
 (#1200)

* mv tendermint client cw tests to testkit

this is to remove ibc-testkit dev-dependency

* note for acyclic release order

* test proto::Any json ser-der

* nit

* fix unused imports

* cargo format

* update releases process

* Add more instructions on how to deal with cyclic dependencies

---------

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 RELEASES.md                                   |  19 +++++++++++++++++-
 docs/dev-deps-graph.png                       | Bin 0 -> 901189 bytes
 .../ics07-tendermint/cw-contract/Cargo.toml   |   8 --------
 .../ics07-tendermint/cw-contract/src/lib.rs   |   3 ---
 ibc-testkit/Cargo.toml                        |  13 ++++++++----
 .../testapp/ibc/clients/mock/client_state.rs  |  19 ++++++++++++++++++
 .../tests/cosmwasm}/fixture.rs                |  14 ++++++-------
 .../tests/cosmwasm}/helper.rs                 |   4 ++--
 .../tests/cosmwasm}/mod.rs                    |   7 +++----
 ibc-testkit/tests/mod.rs                      |   1 +
 10 files changed, 59 insertions(+), 29 deletions(-)
 create mode 100644 docs/dev-deps-graph.png
 rename {ibc-clients/ics07-tendermint/cw-contract/src/tests => ibc-testkit/tests/cosmwasm}/fixture.rs (94%)
 rename {ibc-clients/ics07-tendermint/cw-contract/src/tests => ibc-testkit/tests/cosmwasm}/helper.rs (91%)
 rename {ibc-clients/ics07-tendermint/cw-contract/src/tests => ibc-testkit/tests/cosmwasm}/mod.rs (96%)

diff --git a/RELEASES.md b/RELEASES.md
index 881f7c9b5..06d94af6b 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -25,6 +25,21 @@ Our release process is as follows:
    the root `Cargo.toml` as well, and push these changes to the release PR.
    - If you released a new version of `ibc-derive` in step 3, make sure to
         update that dependency.
+   - Verify that there is no dev-dependency among the workspace crates,
+     except `ibc-testkit`. This is important, as `cargo-release` ignores
+     dev-dependency edges. You may use `cargo-depgraph`:
+      ```sh
+      cargo depgraph --all-features --workspace-only --dev-deps | dot -Tpng > graph.png
+      ```
+     The command will generate a graph similar to this:
+     ![alt test](docs/dev-deps-graph.png)
+     The blue lines indicate dev dependencies; there should only be one blue line
+     referring to the `ibc-testkit` dependency. So the above example would result
+     in an unsuccessful release.
+   - In order to resolve such a situation, the dev dependencies other than `ibc-testkit`
+     can be manually released to crates.io first so that the subsequent crates that
+     depend on them can then be released via the release process. For instructions
+     on how to release a crate on crates.io, refer [here](https://doc.rust-lang.org/cargo/reference/publishing.html).
 5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
    the documentation compiles and seems up-to-date and coherent. Fix any
    potential issues here and push them to the release PR.
@@ -41,7 +56,9 @@ Our release process is as follows:
     1. In case of intermittent problems with the registry, try `cargo release`
       locally to publish any missing crates from this release. This step
       requires the appropriate privileges to push crates to [crates.io].
-    2. In case the problems arise from the source files, fix them, bump a new
+    2. If there is any new crate published locally, add
+      [ibcbot](https://crates.io/users/ibcbot) to its owners list.
+    3. In case problems arise from the source files, fix them, bump a new
       patch version (e.g. `v0.48.1`) and repeat the process with its
       corresponding new tag.
 10. Once the tag is pushed, wait for the CI bot to create a GitHub release,
diff --git a/docs/dev-deps-graph.png b/docs/dev-deps-graph.png
new file mode 100644
index 0000000000000000000000000000000000000000..7386f9cf27fcdb5a5eefe27d37266d4c1c51af56
GIT binary patch
literal 901189
zcmd43cRbf^_&)q;-wj$?goX&AVH8;<h0KiXO0v^1LPkr=C_*WF?>(}cD&b>(La1bi
zGP9rKLf!ZG_57ai^ZfaI?$^s*;{CqHd7bBR9_Mjhca;>5(k)|LMxjvXWR6LxP$<jp
zP$)~Z|5=Rhcy5fV!~Yhakvl3ynI``Q=SO){C|f8pQj)4yp8aUFyP`T&H~mZTka{Zp
zR_>*2FSZ=tcK;4fYDXC7y*uj`axuJ$ymN1x+WmVUwuy<YlRFZpUj0FR-NhL7Tg%4G
zxYLigTc1|8`G;-mJTIAd1t0r7_g6hRoBH7RrPMrqnosw~OJyUU+aE}{DE2nIGR@Fh
zgu(ph<D&4Ys$>3tzCr%@MQ@?hy#M(<;Z5^H|L1oo0d9U3|9P6k<^0jMr_z3ubcc%<
zFEWZ<&8{%SZv?yBolH=Vt2pxSZ%bUha^=cK-TBmBd4GPHr$Uy3IV<q5>3f9l{5z5k
zs-Q)EIOmDTjk=4eyz+qu>pIrphfb|h3|s#1qh|i(;;?$ve+ELn*Kzir|2%8vr>yq=
zf11>adCD_C{`ZTEf~(8Uzki$gg9OK635Ngqtzhr1TZjSt=R<wJ>i=iM3NCq9QsP}_
zUYldx%_ie8(pz(V(Q<zCPsxHw5vi#vmW7j<Dkn~4*bjBtoBjCc!7LK_=Kcn5F|j79
za89M@5(-6vCi$O<OZa_lZH-7y-o0q?Vp%Vb%?Cmgw6nSfJF6`8O75=Zc=Y5+jH1}6
z)Vg)+hH5($3=ItvQY|kti(NhGJl@c3_3iatb#aZuT9?WjzKIcQEB&9(Ud_M|UM@C%
zT&U?v7@NuG?29?Szul*c*&!yTR~0EAH(=kx*l6<W+nd<LM4Rz~(joEb0ddAXXQbi+
z!#MvRAKKQ_WAW*EeqLVv51nSmk$|b6x5cv^n|=58Pi3iUH*sJXU#?~}HVgi{k42{<
zA|mSZ?9#Sv-!5?O<3<^;+qZ8YJa~{zMmy_#P4o1WE#0QQQYRvhU$pxXDC)p}_4ft$
zP5Y#$rl#b@qT*W2+b!ayWw>_kq(;g=O}A_o+riFm+V=6u@WYNJD_N@RGt4rsj$UFG
zwmN26FdDgS+cy5oZO82#9L(Cw0{jIn{O{enH~5yx@?ArNwl{~Oji%+{@yzhWPw(AZ
zmOtK`J67&I6~>*I{nBux)V1t#2X$+LZmznVA8(B>k9N9kpB|4+wi1V8V0BzlLF^Ki
zD-ux(0hM^?x=ov6VopSH@$;+Rrf05fD}CD9(h{bbcJBSzy#iOt8|@UC#&xbtPmZXm
zs<O$*9zR~aXoF6$r})$-C!Mor!xQuRWev}sH7@pG_6n~EI~u2vq(>LH5{stG#QY!E
zVYRf`c{)E*As{wAo!@bCh^Ek|nV`<2mv^$nm#4~=j%o0|{=^}n=BsIwlLo~eCLbT~
z;o|15niw4z`jJ-7wPVK-tUX=ez*Wz<q_+!}&>N2pc6L=od7k_DIAnwVRplE?R;oKW
z71SnZM?KtrwCh(fEA2L`Q#6_A^cby>-?mprboi6Oa5s~H=_58yHa4lPTel9?>NFSd
zBuIMgT7Uno2Xma`_;BaccpnYxk#1VU6*VAa6*$yQGyDGTp;pS7TY~35M;~Q%RK35R
zr!s$}DNZ>|+GMo9b?oP>l|vn2o?TyF+{o!p%;h&K+dSFAI!%4GQarvf*Ve2e^oYNh
zqy3GM&y6GLDdo4q!`T`gM;de5105cDd4=NG9FdaR$-^UGE;{mzx8U~~8I>fx{6TE!
z3H__TZo%4^4zglJC6@ekNG|H9GPHbxf||dGVO_X5IZZCG-hcBgH8)WH$dOxR0V1|d
zLuwitC1+Beja>AQm6c_rD;8iE7uQ#h%cv{%^Yd%S?G?~CeL4h-{M0c|q}Nbm?W$E<
zSXqMv#Vx0&CWk&>F7LzuE(eU1Jv$J_bUs@WTb}*l!w0KIYnn;RTX$JGxvFxf;eCzv
z-3g4lPr00b-nw3<^5w1N0!|ZGEb3B^tYtqQJ@TyGLB~;`$*w&hr^Q3$M<b6$qE1YT
zL9uB~teRHA)#t;#jd2`7S5?&G)QHbv>-@l-R85WtPJ;X911dpIV=-)<^=3)db<e9K
z3mmnzZm@|CQV%a%wye@?ha8)XiHQk0k(uUomEX-83!MvDoF^{IRBGruMzA{lmYf_L
zI#C`dnsN61n$h3Cjqz76)9X*m#i#SmXMbIsKQ-3v6@K&P!i1A4hZZebw2YqK#;)Ax
z<KwTj4qO6L&o992yI(9}Rh5*yHh=zns~R<pPFJS$R2W>ymoKMeyrQC_Qd3jYPrq7h
zXZNdl5_@F4v3bv*&_%slP2W(nL5G{0`vd}E04**yR#i!f8lGX%wVYP7fhC@g`bjA`
zwcx>7W#xw-N=mx(^qPkRGW84ugoSN;pK)<<F@BEX{%7gZhfziYw`<`G8j7WbG)|og
zuKL|I(AwEqXWU-+_V?(hfJyZg4Yl#^9ejM{$y#0GSG()dqHw6#W%`GPYCb=|oZ&cb
z<2doFSoYX4YNkcQV8v0^x)D~P^UqS#($=kBt=#vVp5@@D_!d*zV;`Rgi-t^-pI=_U
zJNSkBJJ`S9;rGcoY570@JWyS$nl2+FlhW6$(i^>%gX1V){-Bq7l3q{xaM85|J@YCe
zpA`>h2wHck%2eLkptrNLaKvJ;qhdH?2^}L_4EvyIRiU%9OyzrTj-D5C8bKR+^P=QO
zb&kQ5zP-7haj`|Z(Rq5(i_QCeIPn1unHD)?U2)bwKJ7Vj^yt7i9oE<X=HCz;{3?c-
zEuPslp1Jq(I(w@cYpR;iQH^<08rR;{f0fZVUHsvL?7H>q1+{L+or;JPhRLX^sqF}>
z+29t(_q+Y;*AOaI$<J)jk|l9)-`0A4P5HT39UZ&#n!=8*w8r1cx*Kz>({4NI{2CeY
z3kuTD?~_w8Ha5P|_~q)=t3SSmj4fQWNZ`}g1kM*yw$)m!huk|>l#N_2jJejf$KWl(
ztK5?(PwKNQgTiyR9@0+k8z>j2J>op^tVuiF_~97?1EzzCF#;_6FGzR|cI!`Ti8>6M
zSME`fFG>mN%^s?89Pi1Z)zO#*t`3w6#YRUfsj5Dz67wi@l|P{9SlE_1AX3oRRZg!x
zqE$>yjjM;7e%k+h)w*>N<Zxl!Inz_))?L+{GAco0j)RqQe4Sl!NhI3yo7KkKmlFrQ
zf7@T25^${N{KJeJUKzPuwe;I+>9^L>AFA!m>G(7+G37yIZh0f4&LT!fEY8AJy0_Np
zTJMf;)U3b^@7}$uFrK|^Z%*thwFl*D%!%{wCJG-EWC)JuGyhb{>rSCQym|BHyXIzn
zSj{jZ09>(Yb+od=cxzi5*WSIU3dWXSimnZ_3P<;4|NQxrz2?kvey5=tjp3AT!CSX(
zVb4s*ZXJkD>aC4^F?@K9rl#glZ<Q9UUR`VK`EIP3{Nvq{`c9(}O%8pc#HZf7f4|DW
zQ#A6&4|7K>oIMP^q3sMNOa1yUGF<ZJ%^UbV@9&@MQfz)!?uqZ%Xl}JavX=h1uq!9?
zD^CwenPMfw9{NWfjoZ58sv1p~tTJ1&(9G6>|H<*;;tY}Pix)23Z@nU}(J{q_lA3av
zMlUL8)mz_3%fhk>*45Q<?b=n{Q4v-HW4E)n@8WYFy^kP#ZaS@x8gjTEPKpGZ9df?a
zn%np7ORH${|Mqe@pK8|m#&q~8-HUJ54X-jhe?GCvY22dpsZd{DVnS@Jte&1833w$r
zx;@<<jOJmDS>|=2BE8wKIz<~s)OrhQGb=xdT6DF)%)Z#duzGb!dyunUYip~ljEu6e
zakMY5Zfsqekr~jFg}p8oq~p_HTx_hCsT5{VRJljWuJ`kS@hghjE|q)OIyc@-zqQxQ
zv(v`tXKKV|5%F4<u%3;PRx8AX7w>>A1W3CJyKY%9fBuiHON$eIF+7FF^v${Awe*s;
zO<5@q*eR3%_nz@<_2N3pIy&*+zMUBlO5)Z?tp509pLMH`hOAd*Wo5cej}{QU=0JNn
zt-x_S{c^j)WT&EY?1;{uJ$u|)+G7Ljlb#%B$0{h!1joXOONc+ZTzq^qv!wh;d|%G1
zEKrm?rfr<HA!x|Q$A_F1P0c4b$vwJURaI4LdU}bcU%9?7FE2OjNgTE?p*xqRNz=LP
zF82G&0s@it8I`Hp**!0q8Z!eT0hZY*ESys@@TtJ|;N>>A(6BJwCZUEA@k~bx=7Saj
z0ygE1j^wOuskzE`z;VnfK`TQx=xYC6Hcml7^_k~R4xY##t~cX#&c`xSH2y9#^J9bd
zW5v9_qobp#S_ul0vc<_~FCThZDyngLzej=1ie2^6MnVjEZf<T?oATnBADPSkOdbB`
zd@=0MAa8PVvYSqWLU9@1zJ2>)#e=_YvUMh8HC6un`pUXgfYy=OaK374a@_jYn+<05
z=_bPVgVD#?y#t-6?8Z}o$$a0OsmSdsh_h{W)cE!57YUh@xA%5cQ7__15p2WOSt`_A
z4Fp4;kQ@K&Jx7o#;6ZJYev<R_crzj+aUKk7)`X5UIVkoOj3=^nK0L}&fwW<8v^}W1
zC#%`F#<XU;=fO~bQAM&41SQ-2IGLdHJhd$P^3lX$>!Wm;F5lxd(*|F!Rg89?p4$85
z__7r%s=XD(VgS^FUkv0;4ma2X9PW@=zJAvXe!8|`i7Da$rsU1mnNrMB1%zQuz^!JQ
zv=@0!2d!`_Lm^1aV%l0a!_>!@Pd~A!s7QDuFFyWb&q#Vq(BU+r@>&AU9rkN_5tMSv
z)m7MWCCM}S-;zAoop&x^ckDEOakRMNYi6Qvrh=bG0GGvAS?w>C>t9;^IAzj(MN>;F
z*2`;66g9F(pm@^Mw$PluSh+Ei8fMTgSKRBHxutdVrXcf;C#45A0IQv_yK==C>52bd
zL)rVZ4`pSwNQC%L6;Yz-8$9;z+voH2DR)|(`7}!ur@w=aMU-Mt?XQ+%fm1~;=d33a
zVZ_Liygd>un|*7y)VQf9#m1_rsCap>h{gghMzMapNVBVdIr{lTj7iY)O`A5s@ui6;
z#mB2ED0rMXbEYh}06|vHD}Mnu=9xqPCuKJt@n?)ow|<j;Yd^DyR(+06y|BKp&8v96
z*PW(41BS~F)(amO_87@@pO<BwWVJ#qhdaIVlR#C<KAdI=qpxKyJE@yy9BD_+#yup6
zz#`dGtl!65nk_$7+f@J3FVo_1qaf3=i-9Y(S5@xWY{DdYez~&nV(ylf762BLm8XPV
z_gYBGYi~HNeWxl#JCet()6`<-LHOb(F_%;Z-$+@+ZDwf^@}XW^TjL|XaFpRo)W`aU
z$kau9EbvFUhT8R!@W?~1`=3@?q=l>^Dcj6Pmw7I8cR81Oi^J?TpYARG`}gkYxC-CD
zf4?WJ(#%pfUtLS9{`;8uR=L@yQ}=RleP~)&b<u3OHl{H@Fe5AT!ruq(W|?~+m9u6;
z;x0~3Wq3PpJ+lu}@`g;JO`in$`O{^_1u`>k3H~8VBxtXv2}^<X5j12n2=wza>dQ9i
zjx<R*sj93Ta{c;z2U~e<BL$7|h8$b1UB1HOLT_tVSFMj-K~L|Sm6dhq(4il?g7B_q
z_dYo*__QZrAM?mae?I_7bk%<AhHj5Wfj_UJ)HBWvZ;Q<EPeWi;1UKXcmaOjQnY;so
zf|8IT0tnTMn5<vFJ~lM;rHQk~HN}Q0_g_DMD&c{mMJ7zQS=OxCW@%|j;LuS|mj02E
zEYE{NPmc4Fw_aLyRk(L{w=p5=lethDydYL|I4`7FzA-7LrE+p&0%PrR6UfS6zj?Dx
zpM!h;Ii{4}uU{)Z*shvc3495@ynPmQNN^`>C449^*SL5w1*t@jr<|<p*_4xAjykHU
z;gyvt<1IL9>lhgJi=Mw@@!C#8!bLQ`^LMsUdEjvIwQJXgl{-B=u{z&dS`7NWb?#SZ
z{__S3^Mcvcknpn=Yux{I?9-W)=$xFK7X!7up`E|?3k%n`cDsv4j>DqoK5Vn6!-f8J
zt<M0!^6<+0Z_e~3lVFGuygQRpT^AJ|E(O$};5jfbV3?uBbTI1u*;G$4+jZ|?fwBq;
zzJ-N_qQRQYExnDoCFSLcAt50aR>gl_K%uJ5Em=C3_Jy?Q=wo(vcJlPL>({M|NlvD6
zuF_IfRqeBzn4Da<abt9F@D{izt}R<6Fj4qNRUkM<x(l`R*Xvmp{Cy<z>bYq$C%%nr
z5Hl^Tr4AsJMd#(^H4S7ldY|9>q&nZhcBrG`)zs%2F^}?BFJFG|?rw0k{pas9jGJeJ
zlLUv7ib|#Ng|wKjWv*`%8*)r*H&h=#ems7_$?<F1g9odCVlsaP{K;$JP!`WF*{NU>
z)*oBnf3xlWo6w1gtK$YR&4#?ZgT&s76E`q0ROc3WdV0=ZuwWe{V=SgN{%HsgJR&X4
zwR^YHym|8wS=5gmyW_~_fV2i7tLpJEl}Z)N+xK^r6s_yCn4kXyBGQTEs^L#+MQH^i
zNUL-cnb)j2Go5@(=*Ep3HCdMWWa0Mj|HRT{wXSys9i1AU39w%OJ8|Y|)ZwY2B<D@w
z8_x&qzj!DmB}LkgoT3F+PIf<Knpu~ClLld*m>5fNV54T2^K)yxySqlxr1JRWojd;^
z&l|Wp^DzEfV1FuhJmb)p5t13xsT8|mw&z}9_?oc$9V+bd{^7tTOuCElqxBnScZyk|
zC%J8O@xjZNFL(ER?&NxBCpNGA-MeGf-L(nseY3k_+_!gcxcG#medi8Naee#V1D&<n
z?ulI!0b-6?U%!4GD;A#$0qqbl^2@eyM^7WSW53L+aWyqH6J%KgbprJ9ii;PXQzzlg
zN;f^6Oph7~>gW+BgbiwKZ*O1~@i?88Z^ZPzH=AeY&I`{Iu|bY29N-D?71?rtbo%X^
zH}~iF{kE5okYH*ic^95i7ZD{Fry*yVw{@svYiS@)qg@ok1|uuOQtyWkx60rZrnSFT
zudXa+6)MmNmL*)3F*R6H3+WD0#K!mmG8WxUvy0Il0YAj~NmHal(?NTD62C2MHa0p6
zVkTUnXdgSf^n%4Jl9%k)T_j<VG&(-cbU|ol5R@)19-pSGC&qd#BP<JjT<LwBrX4tW
z<hwfDcPj=S<dnI0_pV9puauNZPdR=rUS0*hg5RM|zwYbr6cA8rDfYCiJ%CZTB;K2`
zDC!~sevkZ=iXL!bD%RH40Rp=2r##)<RKb9BGnbxcD#s~Wkv+#U_geo>PCw^9*k4ll
z{Bq?GjppXVD)zbK!{_$bch>^Slm@=8jPnCa*4i!?65`$`Zr6X-@#l*r{`-tP3P#(Q
zki!af=V2NW8d5W1t|Qo=u|IzDBB(6;+$*&knsDUIcYjATk2&9%v*`k01o^lb5`?L;
zc7<bmfdA^Qfp(hP!<8$Aa)d`j?E1q&(boKEvA7LdJl!RlO?2e*WkzAE=yPSyV!*+E
zc=al*u6+rflCx&!$husMjg9^Bq7<Mgkd~RAo?d2;L)cXjb{l8U(X9KM=D2kOIf6=n
z-7t3AtjBSQ<l6N}&so>LZIekki^=Od{_Shoj|GedX(~M1AM)wbr*o`*8&}CIoUh*l
zr)A%hL9?ne^y{=O91n0BiqjVupTH0#G%D{-n-VXQ9)O?{aNx2uMp1*bq{kBxJvq(h
zT@{?IW=TUs1Lr#vhtB{-!duJhwOLtN7bLRa_Ygq3kulr1uIqfWA)->nr2lMZ1}*&B
z0{6sti)RPzRPr50&JX_z2~m-70j)gBEM(Q8#G{>ge5L5%0}$E*$#I`Akf$t~b$s;k
z>TxA5QE@$;RZ%^j<pClZMhV3I-nw;Qk?8nvPlNHheLHu)bKxc{hzU5x#ziQK`=}@R
zicKiV9)AROF=t3U=IF|>I5TY|emTgrwbP}o(jNslP8Clg+pPs7DF8ksA}R`TA?b)U
zc}~DAK(W%=v17;ZubxCPkVxRjI|sFp^&xn7#~bc_!obXIvC>}p$PtqwmwChOnVydy
zZ-fbP@7i^|prBx}jsSTQh4T5$nTNHB2}@mBM7eaWeSnksFNRhpJgunNv>gP^!-o%f
zw6-7A`A{l4-EvS=bO<znDYzZ2)U$V;2A(#jN7LgW!D%yL*@ZqNIavv-u8wgKOx^dz
zuI=L{lB){|X&99~yV&(pQ%|oq-4(=FeppnCASdVhPCMc<hL`^H&+d*`a>P-ZxtUbx
zt9M1RK3loJ-|Kvij8?M5-ly(~A5YfQ)CeQ1dim;=cDjPp%}3r<c?N6OtRZY`DOMk>
zPt7_For+K`JjJEVZRV8L>&VF575)6g+xrB^PrI=}lh*Iw_vfpttGA`QCM6}=5C1S(
zX(cTs)e(B1SLNi%$0e(b@fGGQsX@FT9yFX7D?8S)z4M7tcuzxw(`5Mcq`pbnX3pKz
zj;{LKI0~_-d8}T&nn#Oc+acjg;iJXnPxc+v&NQze$qEvqo%{D^9~mOg3RpMeztT?v
z0R|}d47p#(%GY}u6cprmF!%jg6?5}=-kgqYQ7JthVV}do!dkz6JzZ2Y8#sgay?_5u
z&r!{O%C7VEQZStnBh7w^xeDKcf}XWbd>XD|o>x&WZmG$`m-q8Jc?x0dlfbW+tS5(1
zm~-X;Ur<q3KgZe{7!Z(96{Xk^6eMi@LF`-Oa9(h5QRkJFD_1&bC>HkyzJLFI*~*nk
z1A14kWFI<wm@bE`C_Ywdot>5b0+p_GUY?%(2CnHBLKs*rtqgnoa_5JB{aVVpXS!M7
zWyZNu#>t6xaasmVFOJDFFU4><nM1%TGI<w;#E_z>xOSWph2rtwzdzl01}nqcG!7lQ
zJ~?9z^Mg*GKHWb!$lqZ)YY{GEK7Mk2`5dB?>EN|x54%<$3>4GtYHGv=6n_4!1Aq|=
z*oh4wrs@-4>uYU7*jWLy+Fgwoi<uck?bC_Ts1lz@t(z&Qb(|t}Gzuv8#o06`Cy-rW
zyhRdDGgX{tq6K<+eH;9IG2B5_mEoEqnK|Zetf^UfpRd;KVR^Y9814E@d0BaZoK%k;
zux?TN!3TaCB~woiY&#Si|ERw|eEm83p}{J}ZltFbs6%9!R7Lvokbpi{Kdisz<>e*(
zwQP*V$jGR~G((tKU*zYLXU~p*Sv&JOimsl0PP%;t0-=E9>$<cEk-kUYzPTmF8_XPm
zmoK&QJa`!Fhs{eCguZz3!XC7jkH3E`@;0-|a2cLN0=PSN%{Z!bFBoZ8b<BwmrKM`>
z>b{pQU3$jS{{8z-5fSYJ2M!?6*$CIJ|Goly0G@F1ijBc2#c*?R$-=0~#^8jKIuC%?
zjl?-DZtN^87a`RA$Z1@=v%xYV<Zwjuw4SV-_r!!-VxmFX$z99n=q!E-XYSbLyPj`{
zOiup?ZUGcF8lA>_$Y!8C^*L=fMo4`z18w)O1f+Gh`Tg<3he{;6s_+t4@i-PIILeX2
zcfsq}*z+K)19SEN`n9KH*_>T?bpAYTQp(ub>KAdjJ-j=~4{jsp$KEjR?t>`GXgi&1
zT)(Qc-13)-P2psZ<q(p6HAFa1J%=8F5uO>4bBYvmCHyp$l!8BgJPzN`@%_EGuyxlX
zP}|^xB2Gjp)HRo2-K?!MCif$h0Jm}P-CNnzQ)Mm)EL6a<di9HwwzFGSR2r||>8)sb
zJ)|#h`w^*Qe}ipK8Hc!dGY_-W;X`aISB_Y(@-dYzo&M$NT>W^D0l!HloBXr=6^{4G
zL1ktjr-aIhg4s@ZU=S?G{%w}o*V13}ee~#)C*a;wEFS~NTDbH#uU{K~N<Mur%4e<o
zA1%P0J4#YgH$gr1Tq{SmzaVLD&pL9JEsvn-`vuxb*QXt2+!NY1dUL7QhUo?MrdX_R
zEiKx43R&k7`y52>$f}r{#u5}@H_&DR%5@pX4lI`ouSX%vJc<i_M0oh?R^yTShG)+<
z13%W0#3s%2f~SXvx~%Lyr{T1qnoWI8xwe*ezxdwGu8l;l)fbn+58OCHvJnxL-``i7
zCCMyU!l<iB`;tf>s#5yc&empC#%N=oQxqx)of?H>K7!_-zD&&=2j+h|5k#rH&k*&o
zB*K6$WP=_)3?Uno>sT**O|ZIW-?nXsP|C}+9do;PFSU?{3}!(RiBR}RTvpSN3v%L0
z(BpCZ9rEb$PSKw(R^16Io-EQDw2YIx*5A5$GutqscG(@*n>Ra9exUyT)goZ{fx(?s
zylIky7@Y7w#D@l}p+2Snm_=9_Qj6HC)KFVHl$M@e?c|0;4v;FMqr(`%w%bdN_u{f^
z!(BBcV*QO^6N}>JGBB#vuJtB8_5P>8^H!>9$UGI4S<6xDw)1EM!o01v1V7vB$?a_x
ziMhSP@<C#{wx2KF<^_3)^g65TE=J;F<3WO(v2SYXUI&_@#`dPP)KshAKTm_Qt@8v$
zr;Hfp81HcDQYvsuPq{?{Mg&S}<CPf%fhV~2578=@^BrRn0ySJIF9gc$*txU{pBHCR
z(#Ka12r7zCrV~$qGU&<jg9FFA14xQtTs-4YIB+r)wl{TmPuUIs&>Y_r7#MgDxcB&R
zH;_jROiXd0Ok+^W1uiEsEi^QgVbdm)FFv!UmSPM#D%?}dix^^oZWm2)ta;j}?c>Aw
z0AloBsvydMXy_{>RlQ!me3^c!Rkk!xR9mRg%9}U$M{2FeCJcnCK>SAVa!ydW1bsD%
z>RL}6behNp{^==3O^XxW0`-M^9v-z1wjO?#<M{UV>uB4)rvCnK4S)0%?KofdLu#F)
z?GbA^!nu<kH970&^a|hIdbsC)Yq3pG?~g71Pda@gx&#c~t{}v6WuD!@qrgC3OUu4m
z(XC_{We>i?BD{C<@)G{dy8pXO0B|IXgIFj5w`(~RcJA8;BMnIH>+9)Bh>qR~CV(ss
zsPzg2NV7hQY4=!XcemLWwYl}_aI36}5HJg;V`5`vHF>+j<m(|$v8Ij>N<kB>4URc+
zH;m0ZA7`P+?haCKu=<2zC#sC*lWR$k?fHke4`CMsm&LhG=gytuf|Eym)C*ik7`%Z)
zdpR<|1J?5*x;gOU__$=M>+$A~1R~a?UykBGduMR4s&cSXWu#YH<M!L^+}XF?_4K5X
zDw}!TUid2I4SH8jcLx#eiZRErTfl6|m)pxaKcyH5V-NQ3-TUa_!>`p#2XTZDT{8Pv
zSFH+e%6DiGafBE|9ppR+#}lv&VlJy!pZ>CLZstYKhK4fTG`VsyZbKtEgJRi+OqrM%
zX${wbuf6o4Ten(N!6<qQr=2XC@-zq9N~@x9qF1i;%sj9MLpimZoX_;o*jO&mp9dC6
zc(RHoB5mu&xIVmlr=+JB=s1naE7<^;0;y(3D~Az#)yuc9JNhEGJ1T8%Ai)9=Q8cUN
zjxBV6=O%5(JIh2OviFB^AHEDv0k{Dj#yg(wI_Zzv2`Xmo0uX`>e!I_S`upcstwN`K
z$O<ZQI2K|^^-E`l<kHe%Tl}jpv%T1pRm0FQ!qFK;%Ga-@pyBAc$DNq$>1exoa?Vjv
znAJ>T2HT!i#;R2cH6J^CTefgI|B)~I=;$V0X02_g!Xw-R9a)vwZ{4b*=3~|S?0e)#
zlN%`5Mxvl|c%;!b=&d_b6f`86Q!->eH)hVtJcQWc<fu4Gw84m?xVU&!QTv_M+n)uF
z^fqei=}lD3<*C5~2d<vfN|Ux9ZS^l|9>QLT^Xb|=foIS~lxTQcA}7EsWmaqPl%$JO
zzgz54Y8?7<V`W!_pPuPcZ(@Usw?)jSbfgk|h2kr-h|O_;vkd1?fj~MaV$06h;-^n1
zhwx^kT(#Jq8pMk6{lCQ=$98VnQuKwJJO&?^%nXCugCF-*iu4@=IWRFQVDSCbEBC||
zz3NIzUus>VEjaHVx#w=(kV;2t`X>}cBj63pAUYVsajh5RAb@MdA>_+c6CXdn+!Zb?
zqV}psJvJ)?1|fT6<J`ahB;4gaST~Am0vEp#o{kflzvI}TGQbe@IV%db&5VUY*{ydv
zWDuzG1y$6+^zA#u@5*$OHHRMwCxwP?%Mz6BXll$%Z16Srf&!$g)la{c;65`NFQI5G
zW|p^pmGhAW6swbvGQl9D_YF4=U&InQEK!1W0CY2oJLNeJI#^ky<7BKTV4QogaWnnq
z2YPl#?0+4JNmunhsA=CLVDd!*=BN$Nqi(AmTSaFsw{AnO#d~&#;W{IMD?d-=PxP1M
z^kg>F7m$YpyA#lxu1#KCT57#%%6uoq|MBDK>T1=fpGJoc&1aUFv-~dy|DWUJ?ab;Y
z^FvVqLm?=O#lB-JaRnfjEcA)3Qx}uqu)-QS77=Gb4|J)X1%E&xdzfMj4i*r@=fQ(u
z6q>q$=rTQTf;l4KlCEHu>jq#2Z2P~(McL!ud;LE%uNoThJ9yA-=^a_3-I(ErpxV-c
z7u++W2}~gQUa%SfZWr9nkgEjG`ul9}A$KBMdFD*$$8%{o7VQj_)+pOQr+mn9I)Cux
za)Ge#qM{KoCn6RtXG^Q=_;4y6#3V?@91BrJ#rHH?wu`Zn(gSsfPl$C5|EMF@WqN!o
zCN05D>fpvHAe{}*oy*z0pb%mypGS|5U1C`vZvJU^>Ek_zv9VA-sX`Rc+WLl7j_e0M
zR28GLYOB!|bQbkfYHF27S!K!(ZntRW9qQ%~?Z0EyU?H!+ARs6gSWLj6&3S@v;o;)}
z!fJel6RB<GK}ou~HZe>+7cmj)`v<S*QTS!x-AX7OUtis}{{C(?YLPNt$S5)IHEY+B
z#Nhem_WB?WHnw-KUcLIlJ+}ZZW!=9oatf&Vi)iHZ6}XO+{-09J#B+l}U!t?KPeO`z
zUN_Cbwng|({lW1cX^aQ2B<tC=u0!rk`*eoPNr(^u57>}Naih+-gnsjdvE*A4a&mGz
zYOLnTV-1=M9DN{K>P{+bnmV|3t0dtf^p}!f#m7qCVfdJauG-p(t79f6Utjtwgl2#>
zG^;(vBzR0rtkP|h!1&wZEW7s|5?XOLqATVpr`5%yE~$Ng179t~5e%{oI^;3ifa!zp
zAGrAKCS)lmIsUQ#`9%_lMaB!MEVd?`D5$QqxOX*VCFL(ShFEGv!JNOLNLYXZ)pg8(
zQ$3p@`{YUGZB|*DzW#ud-SfdFhsv&+%CdmU2U`WUR(4jI9kQ1&AOm>_sOGy%Gt`|)
z$n?#<b@p8`QEt41^SQtT?@wJ?!?L8%sGOyzF;`=Jq>t#P*kDu|`SwFz&`_cvZM4#*
zUW}{&`7pm)!g|b`UB<^pMNO^LEHF@D9`*FA@S*MqqadHuG)Od{urYm0UC<tuX0ysC
z9E=l>W~vm)YtHBP2!a&aq)X1zm-Q^_aW$q^t0^u68X^l#mtXH~%GX|h|HvQri{SIY
zT#);~fjSn7{IO#XKuEvPm@^ED@m)HmaLqK+99MM>nq#515a&T1Sc$)o;ysV^<BSyt
zpv>sVDx6FpHPNhuC;nWz7p@IL1Zna99DIBwYQbcwZJX?hJ1&uFWd+~ZNl7=r@WvpL
z8-lvc7(6MFGdLcc0Eq_+nNKXF&}ouL9~+@u8UFPX3E#~>o+;Q{D_=`1JDGiR*F8VK
zLGkGmRi~?qqb$r0w^uzODGQ;Ek#ci`tZm4$)ZntPA;)7WJfDlr7GOP4a%s0EEj$S<
z=;|^>JmiE4LR&&a#*h<Oy;!tiCnu*2Vv;(Z<yJtv8u>^trD#PgVR;aEHTCNx7k31+
zNVpdWQR64zA>nUqx)2L>t!vbB+WgI|p!(t#71aeMmi8kLNGFKQcsmS`U?WF{2>>B$
zK=mH%21q|I)0}Id3N_#){P!5RI<n=}nUi|Z3yqmqQ>c3(EvwJ5j;k=V+C)5wf&ygD
zR(pxcvtoyp%$!C#+@IQ>kR{tq6YBZY-|z3(mlL;cxm1+Kgu%Tuf%&20QyXM*Q^1qa
zZQieha8w0qYSu=LSFeoAC<s|gacSEL$>fV0OM2!hX>YW`NgZ~U*z@H0-lwGs^Qhmy
zpWVU6wtLMik7}jmF#JOqsU8`WobRrR$_P1k-UR_GrkzaOWW3o;fX%qLyx5OF5Svtu
zjWr$nwRCA^$l*1GSB(?n<98uz?MN#Zt9tivdt+wr#As!2V`cMHTjq|&ZyqAORFS^C
zFo-mF0%OhCj?1|)*be^*c(@ZBN)0VxM?GV6a<rP7ngAmqLsmzw+Ex~Tf_S{-jm5t_
zXZ=aATtmKtPymnilR9(3oP}0ro(fu2!b`aEhLt=%XqU>?`EgTcS6sy4;B-NI4^JKY
zDGd#p)duSt#<prslXivo?$5=n_GB*J*c)h5+a&$5VHcR-q{68j5(ipK{FrnJV56E7
zXS14!wbG0{Ck=q6>T_+AfJWG4KnhWjNJh_Fu-F(CmagW)!m*LQBq#<!jW_I?-Cs(u
zp{(rjoUg9_4?2pjshoVwz`}dWRhHemJE6tE(lRWG!mMlN{&-}>GH71K&z~2Fev#0x
z=ktfufmLSDI&~MDALYwYA_G8Zj)DQ3Vj#m39pqrifX2xIy$ON#?$T!mPE3xE_+imN
z?Y;1s%SS1~`<$l_I{v&?p%%>DZ8}d`CI>o<A?S*X-+S#CgB;b^>Hx+ok%q%WZ3PBq
zK6r&Hwx;Rg@jNzE&0;N^3t%UVkOU&k@;?8*2I()84*8Xtk3@r6f{XD;uZqlFZ9gj}
zeSLi%{Q@0S$f}{b;((CBN(MhyWQXt(T!j>ln4wQ#U@yZ$(M#X&0H|HRLEH&~b3EeM
ztk=?9x^!v(&!4+<W(#WgeHWXM@5KyJI6T@koUTdY9YMQw#zX~HhIxv`W;NND%o@~y
zv;>31Z4EuW^Q=qz_A^cafkIT%1r49*!~x5ugWxybnG41#28l`g{ek5aYA*>Qv7ND<
z3Swd^cF!>rZbd~!G86IX(ej}_=V@(mq>1jl!~pm6!7!|L!pRWBIH5rWV)ya&{Qy7$
zkAqWO>$Yj%qi4@{VNO6qL`C@DcWnh+EqV3oFpT`XZdU#hsU4kT-AOb<Ki$ZqEOt^5
zwd~8;jMse0BRj%NP!CddYF4vT96W=xzVl=TsTvs?8OeD8OY&d%B0&_fL@5<4dE*h*
zl8?_x`_J}ME=0kVLF1b3sLRS4lcNO=vwpz&*F^L5WRSEcO9Ii~YoI_-(TaCc<ZC?&
zOBYks7#J8j8Y~N~yZ#vqnw~fcbL@x603ICkif=fdD}VSleNFP|S0Jkltw{IE>__*I
z*<z#+md*1jkc)Qun<ZA<SSc0_Nb?@xq{9n8<-%@K+<b09ha1tlz!3PiIl&=ekCrW6
zO8ky1Ju{JlKPf#&$1JQ0U?S}|TW7@YQVlcIC8}vz=d{(?t^0b1TN}HC3P;^tS8NI;
z`{cj-^!2%EATf}LBVLazTT;Q8?98%F4r{|IZBY<?ghB;x_Luo|jQqz6CtCRgjHz3Q
z1BK81&-+}o>O*fBI|yNkNgv8evERXOJz4pZhCla{1o`*s=8XBqd$c!J*KXoRV92%Y
zQ-{j>`t|E%Q^=$Do%@JN=MAFfc5$JEm5`)m<|6@BbwbLSH_LW#aC9p=k9i}pJUx35
z!+^E-^T8m;zTRei_A<D$vy+R5hg7T=(=mpVWes%btsptgsUivzRz}@_TM_*4x){3y
z1QBOI^z-Q^Ro~IiFmnbaZs5Vu8Yf-`lf8qSVd;%O*ob1Kg7jgbl=C1Y>t;}i)@NS~
zJ6Gy&I6ETpiw~qW{@c%zSRpxBXg|`M0MOh`B=snT?Be5_Dj{l%o(;_j^K~Ipim>Tx
zN`RzVhX^q%tEz??ZJT34Lk~$xN;2*}dxtlFP-TWSMpbfbsQc)@&kw%8ZA;gWklQSk
z_&(@$_Q`&~LjIXU5sbd0YrI>)d=LeEK6eLLhewdK^sNxS^!*sm$z+$Z;Mo<%*XXc}
z1)+w9=k;^ch7gBA)zq|jiYFq6>vuN8zZ+-$R#?|@7G5a>AdV=<pc=>dRY#VVSU6>G
z@hMr7-CKtAO8DtJaYD&}jMo@-)nUic<#SHH-W#F@7%OV33SKkq6ep7<Ub)ik%ic?o
zuc#|<1${?E>u-vS<C2q;n<h>5g{T$S-3-|oOKzwTM%qK<ad6(<Q10!`A?qBhXSHgP
za5ji*6bMP9M}3OHZLFahC^YaKy7rwB{)lwsu&mxL9gQqp+HWQgrBI%2;N#;%4Tcjs
z3NI^U3>J+!YOTzBWae8*N?)b(^YM94^A)~4V2@<E0>?%XlZt;~V5)CxR<k&Lo%BZ<
zfp;X-qldwt-(-#aNeqa}`%9OLdJX6Ofc1nMvO9olek9eCt$fZT2SX)40X+@eATi*<
zs(>1Z-v4C?eifgN2RIaibw)v*DE>cU1DsZXRzBs0+B{>f?FFtI`1Inty1LXg`%+7I
ztH7KxiAD}vXQ^9AXm8!pRZl!TX~CErX%?DUouVD{LnTC@w;95>h`r`OA4pPT1S}#W
z)_Q&^0t_X;^VC&GB+aQOcM(rbG>eEaTn7$lvaqm7>(5y~l`Ahl-<@}!#Paku+D{T>
z#V5Y5OvnlJ(->Gh_&irIm}m7W>r!*U?soC%=g<-I66`$_Gnw5UFR8x^Qpyp~u>Sew
zs7%Y|L{g7HChh~V)?)h2(ItF^I)!63N&Kid<FGU7^3E;^l^yb?47-7I$VN@k)#8Qn
z!OHQK$1Jg1L|G|t_T4J^Cwt$trT~ytK+Z`zi=cQA>da$x9DF!6+2>qRRdoVgMHSEx
zTlM9Sm_k*ERwtqogU*Ca1`QZl(3EX;c6M&O@QQ9&0MG>vfxV|8OA!RB|AEVqj-LlZ
z4&NqXTOQpURZ`dlg!KV?0A<*?K$BIKyjM5`=p+>Qu#ui6l<!LO10<fBl_Y%yS#Apb
zCAtwRQ3~7&kr+|zs=U(o^h!4<rYF4~aHrt2s^M(9b(3svxI%St2t7@Y*v9)dfyh&!
zH7Z$190h%sh+HQtsk@WY&d&O?OSEd$5yHCFqN^tSV$0i2Gl1;NP5Mw5NvztCr}M;N
zZuNL-jfQ>#6bXpw9q^UJ_p)65DcMt>A$R1+k+J>~z8-_trMGAIIXLb&vXhyTdqhMh
z(o`G!a?=b`LNsKWKS4brSbyT%h8#2~_VlrW*fMzQrVPC>$;gd@9Mw5FIpKvZem(<c
zCvk>;^ZsBG2X8E<t5kIAUrWH7S2(oC>O_x>;-i81xz~4A+kd;uVFezoL0{y;7nexI
zphOU1#&6v=*+WiCEEc*OGjyLY9=H^)9)B_fC!-5J7&W0s?xQ0l*r6|91G`$a!%ydo
zz8UKM_7F&0ftiPVE9}S!gRz{&q=0#bmVjyXP8k)*r63Pv6POs<DMNaZz*}cr`E>?|
zq6<2BiwpVnD3w~b2iQXEcZjBI8{qW&>uq6LV|9khaBN<l4pR1n)J#vsV){EIy+$(+
z(afK-;)KOYFvIZ*UV`+^qPakqxJ1(A11*TI(`c*x)M)!UNPyRIt9QWOQICuo?9J^n
z{rd72Q9f+)o9(@H;f-^ip0e+K-mX(%3;h7GN=PB5A`p-`k=ii{ov%g{3Y!ezTpTG;
zXrF(61bL!X_Jt7AI|#uB|CO>M_t%pW0EECw#0Q;zxiE^?c`l|@?Ww4!7<;ei^lh*{
zz_uxdDBE$i82OE7I3B#m1Pw+oq07r2lXe1<u#!@;=uq_uukcs5S2i@Gg5d>GH0l9e
zR=f-A(=w+RS+F^XL>w{fA1%61)>CN)urxxC=w5oigFwskIi2j|G$Y6E17JogA$d;3
z*?_soLqfxwl*?&0uSXL|-%r>{Le-1K>Gx@3qSJlTlj31=BrSio`wWZm4is!jXN^to
z=NP!;4)ld+;5{ID1kSwvCqXY?YrC{t@OBi3$cIWPUQP9Y#vuk385u9g+6B<cM)ro)
zc_L*Eq!Shmf|Jg}y$2J!gqvG_Kb5bezt41k+jEy?rKdt8=O5ViTxz{{NSH3qQ=NWw
z^(uZF?esThg7V(#f~GWSrOg7tm9lSA&)@M4t=ZY@zx>|vr@K;_vz-~*Wxx6VY`LIU
zUfeSB^I7v~K(pO+S=g&r9+qOws4P`qx(f0iW$5Ze-CVf>b*PTl^Xgnto>y92998D%
zFn-^NPba$%l~`;7>A)HSbT~HFx#1mpO%p)1$)xV`79~BDB<E+7K|)B-G`QI$?PX_U
zVq!>Mc;m*a9cc^X)eM|myDvwShk1K@L)8H+oPO%Xd^%P!9W;ghPz!JX3xWQ+9MS`V
zUZG#HiA>4rbh@i}_$(is5c1cy%vV!ZRvsH~o=!w^xrv$ZI?2IXmVMsBq3|sEk)#m1
zi{UFvnws<wVoso`k;wN@ZiCMJMMw0^Hc(t@qLbV-gSH-aeOFPTj9;We>A6E!hZ@V{
zOL}z}1x!@~il+czkn|pd%ms~ClWI>!`kMJ<?8iEzYS7eX@A<r%O=-!JB_x<uKr}W4
z6C#Nhu=gk{D4_2ehV$Jj9|yt7IsFbD&?{~Kg`cQJLx)u{vn^4~k0Cb2;Oyw_86a&g
z$g!)nn+oc?7staB9=VZVPfLv$Qbg87n(7FlM6ekc^NlmJejp{ukbR!u0hAij(Qf64
zvq3nGX8{2<QHrc|OoGQDIJt-FG^D(49&=?jeg{w?mo8pZ28C)U+)nxc)~!=(&qnt5
zuDJLpY4l5*CQOn7QQ)EUUY+zoMdY*v*qRMI+jUh{t={ylK;0zi$vz{~+IVo^8MN=M
ztwV8gaS|tNw~M_RdhTCt0DB_N76^=VgJ^(jB{rjz@@0s)7{F`dJEumRr?Xx}a?h8S
zL|nPCPKud1A~tsM0qZc*d08DHw}G^ZkoJU%i)7<u7^JSn`9k_gm_5L?`sC9$@Rlta
z8X6=Xe|W@681`z+{eXxF6Z5*+%}&M<JwW1}MOI@ZQS`zz&_q#tpRd69Nv|!)ND^D&
zMrg2EUg2VZ369RF9gS#V9F{Ba1r7JXIc5EMd3kr_(&0hA_iZm+pc3=WZJsPsVHAM^
z%FEjurRhf{dUEjKGZjG6aREON=rq>3<|R+rA1y$f^L7fiH5O?D((_AJR(aprFQSPD
zEuEFbf<_9bb;G3HRiGCjtq*>B_MM>vx*d^E&y#im*Ojb^q+=CMG&|NTp-)HR1nt3e
zqoCjQ==}VAm}Df%Z(3la`*%dmh>YCt4)M6i?RTEaBassO)ivB;=?9jdq>#YArf7vF
zCmQ-N(rQa0CeGHQ!?UEL3sXEuW-nE|+Q`|&BnCgpGeUa4x~?r@Q3BeA!kNIuNu(d7
zU_<&S!7m;q{g|*woA<P3%a@-(nwVi+v27B_M+1HZwB93MU-kCvq9O^T)ZB2l0s;c0
zX9ZPC)srWqU%os<dM&V*^{IyU2^K?UG&vA7O{j?|^x_>GGg<SL4Jx+Ur-tY?M|)fb
zJ*yaDnsmpRmhi83AKm18R+CW-RbG-l>gee3j@!j2CK8XNs;<s1LwFwm+g<IWt)uY#
zT{=~$NTce&XN<^4%4d8IjY9#;lh;E@;hQ?_-u7k7<b=q2^*&T}AH~JRO+hEJk(mU?
z2d@_@7lnfQ60!M_eEc7IMMVvO4>WtmLkdE2PgGX>hld4)xn?c#)LPPekMJhvMf#P7
z`kM7&#Z~aD8E7C!ih>fWM-5tYcLJ7`28lQK1B11rMMMccR90TTMqa2fTrE!heOXzr
zR}!jsQ4w-}rUbC`zvq}yHvwDKkVr<bsBa5tOv3|A-#yq0nN9`iv4ZHCh^2{NAh?F6
z=YSUDBc${SJo^3X*AO(ay#qo8vq?I7*-U^HN$ls<VreKXl}9qYMXuyktiZ6*NiS?N
zI}|v?cRNpZ>mwPpt}8b{^D7{0HRRi*8U?=P-km$i$HyjHM-gBKv4+RINE9ZuO40!r
z9wb(d!h{kW2BZ;uIlW`4^J-t33ksc-tgc8IWsuU<)g^Vn{GnQH!sKt{B_zqKx|-_h
z>W$3vcYgpB-gS#gGFH6Hl$IDkYzFI3hzO`xrHkiSWB*$qG&<X!TGpbW8uInAxN<*l
z?=aM(NsGj#%a`Lu9zz|_frd7a8V|j_tJDH$=7MIlL|w@C3H1<Y*S0DD*IOoQU!SCy
zm<l|m1}^G(PL3&JRu?to25hbCS@(~+G}5qTKiF}x!a!pU%GuZ@JsMvEWZ1^Ya{%Gn
z1jILFZx#^|A+5?d@MAUYrqSgWkbOhXo7gpQ^2CWSxXlv09*>5o-ZwXQTrHr_UZ?yy
zs&+eM;?xt6ovhSJLcs0<unxo6o-jG}28u>}I%!fH&*Wr!_!;&&K-juceCpRqbXLCT
z*pG!vzIc4qEqRQ<tze>Gj^xVSv?LlaIUyk-Vvs~=f}mUt56L~Xc<-#?Qd&mG#`G?}
zj0Bg5Q=inCM^8_`L4I&z2j(!@CRCX6dF8TYu_M{I+ap^3sUU4|%nOo(5YQ*;{D;zN
zm4Z%la75Xcgbz8g^!)hoy{n5$rmH57CV(k@es_7Edko6Z9v*Z9iY28c*P{ok$`c@Y
z>vk7vqApl@u&7W3*+7vJgH%O4QO5&YYvtM`050q!z6WMSI4*)IL1afG0@DqPr_T*M
zULT$dT!EUVW?k@`MEG=daA)D9@&q**P$d5+vw4&YJdBs_+AUdvVMr=iJdO&qmqh|q
z4Fe}>0Mksk6?9YI>>of{QIVXI_Y<EAZ-vyt1UiGUzUe7TkWoLq<Z9;LU37~i2Ut*5
z8ylOkr0Fp}(Xo!OE|8ly@|(ahwto8-iaQccARf~V3sWdM%h~VfJ#C&E&LYsa=}HUT
zvQRu~H^U<3llkye_akqj^~Ll{(KV7#5c=4<r@p4+@t>(ukzNSE?4<1y(0xe+hVK0k
ziq1SXmm~1XA=^f4KhmR5^yss5x_5nNyb5@HvFVA+1gv7$)zNY^=fY;>=cvVeZftb-
zm}T+FyH1K?oVi5Xfb&Hf0`#0Gt;1UIFGbSIt8UeNLYuVM)NcdA&433>&B~&opIiX<
zUo_(CfUe4j`xUEaLkxb!<=pM1p|mo@Wao(%)*+nFE*}lOhiPeP6%X;xr*7=L6Z#&(
zQdUus<}YA22;#~NF$Gr+`1EGC(4&53(m@R&>QrHN{QT^P8ZYpDq4JX3Z3m!FA%*dL
zBs4_egSB_}AP$5H;7MK<-Wv1_E=Dm$U!w|OLf7Z#X}x&^3i$(NB8>Yl1V4NB%<Vrj
z|K#SXcc$Qg!YUs&aOPw-$a1zWg2IQg@%r_hE1=g5C;N@Oa|{<<sG?Jr09MlA`R&^`
zhRvJJt)%9Lh{ZZ5Ft}!*)cSff8;KPFAR16XAQyC-9pPa~2G{)#!|`GeJ4ZxD62L<^
zeT?c{d0;|z_I?D7rj9#*pGO%yA^8YvX@vD4i%bwSaaYpCSZo*f6d_@X`BB`efi#03
zxd~W_ZuERU3<wCoH6c;(gJyWcSo!pX;)jsG50zM}JapN?8;>n6D^nm`YLoM{BZzax
zSp#ytzLQZE4<+9vfj~@53_X(fke$cC>vh2wYUSH!5M~3BA}nl<y`i|+t7>R;lO}pZ
zbt5YV%Hn9AJ9{Mu$3%aBxq%BXW@=evSx*`4yz|W!Faa50+|01Y#=3y0eIdst6C?^z
zkkv#u^u4X^oR#XIkzZH}uU;d^mmdxn$%WMO_DWVk;Wd;6kDXci-Y=}^Ztw1n%k9mP
zTfTvpUzlKH^W(23{5O~@0Jae{ggDEIi%I}YyJ$&4P4?Y9?ku8Oq>OlUE~20vn2;d2
zQ-piZ9%Y1Rw2crTgoB5MDR#KVu<i4W&${oCOn<&XYKIAQz@(YOrl&pv{KwpZQCjuJ
zIxZ$g+1@?}5jYZWjR_8xAgKV7*+HZ^dMG*k_mx|@x#du5(aO7$f}pjInK=Of2~<BK
z_WO=2lohHXlIbDKLh0#Co$uO_4jN?;kpzOxT;nur3&C6NnPsB6f`lK!3ZT40m;eGU
zN1B}r0s7Bc9h_T9`OioZ(jl7(GvFtj=04&1@e-(+6W@l?8Jc-zkjMKATgS2=e;kZ%
zT{$sJlpEb2uOZ?ps7~BG<}s<0LHRz;@>v=>JUndw<=T?LGLgQHA)3Br@=G4P>B82j
z+PiUH!1kC;KCU~cFL2Biw)qha#MdD{)go?%3jmmy=h_xs){RyLO`Ww`Safbq+W=~e
zFhW4+(rz0=P>P^qIrux)_klBh?THiZU2pz~UfA{`*FBPhZ#RKDB{$6w%m8vhK$w)2
z%qfeMb<j4H0fagTf}tA~@khu}5pIV-f9{0*8YBO^5vPtIgs7c3VPNHEb`C%cBnpY`
z(nsedYTMXkk_LTH9-Sz=L$OUmb(jDA=lvO`HC?gg2JS(pDTN9alIdGH?$palreg<)
z_5p}rL6XqO?r<f%m!Lx;&h5qZMZ#BqCxZhLKp~8<dF<X~pXWYbxX=nlxG17%LERN8
zHIen8-UD%ASj)WRH5rR4Tp3vmEcxnGMy`TZA+!%k!al%eW*~ua+s1iIWyBq22;)ua
zAMon_LY9FfNk9}d1~W_u<yNIX?~Ip#pCafH;T;d*1bd7U8WCx)-*r;r07H>L3<%BY
z<V6)h`Y+i5yQSO9gNXBX^C0J+sc4}xlP$WwNk>Fq;dB9tR94`(OaXuy1<g<1;92`O
zI-HM3ge6uAizi*<q)LPS8*)*^47OWv>W!%rOJAMRB4rVg2Ch4qW;6wmNyw*Eu3pWX
z$r`C2l~-j*B8MLXH<^Cn>md-2q_#!)K*H)2u>EmLMY3>8L@4urGNzM=;n;oZifV;b
z7STbRnSzq4V<z{AJRNyVlzM{JY)CELDEG190d&|T<dA-N)O?^F4@beCDDP0!;`;AO
z!d5^#hM_tD7|w~DCGA|P3cg8-+5oZe#OEKsJ$YuTeQShZ3ra{2(He<_Y-S~0&Uq{i
z6+DH@n*2p<6G<~9>UD>Sk0z7{;3*UH-y)pOEff?J^b7ScH)Ik%&>~@hkhj89ox@o#
zJ!!xoWnpnW8tE<xfH1vI)N=ODoDKgy%R)<4aW=$8zpo`JIg_Bd5||!xHxdE)iHV8Q
z#eZv;8vidI%3PwfyhW7rPSZ)SwH4&*C4#|m5N86F#J)EOipSw#2mk`WQ3D-)$;PIZ
zkQ^xZ0A0FYnxoTD`P9J=f~$%~=OyVDg~KKVBjg0gG9!QgzJdj0l<!#x>&RVvpfDi7
zV!f1sfdORM5je54SzPJHwNg*-qW#8fYGRZaKHws`>R={AK`UKF#UH~jTKB&gNcM|+
znv@GW+*4jplpmJ0kR?n2ao;3k9*h#7d_Q~GB6r@=dJgwad>;+Mx$m8wG2$qL+Jn`_
zunevE|Ge$OBFIs+a;#$3^Js-bM$dKdpbo5~5(H9ptQt2Cx5N#;J(h865n9NdRtN|r
zy~LrM2`#~!LbsSk6iiP!ptRv!)!$mO4ys>VrKIM~F7Jij`Txwz@PBtA63le@uTgL5
zSucgKi*7b@;}E$pV$ZC3gt(3h@bNz;g>HgkKoDl&>JL(!fWC@`>c!4EIv)(^O$1aE
z^hhrI=N}~<ooD?61Eg?;O(UKT)C0c^RxmGNy%g#iF$80RJPWBHP=I<I2YC(Z@@mKx
z!R$ss<w**7&=%2vd|Ppb{st|Ik|!JoaWJHr39ZAZQIqS+2xkq-0TNSW4SRtYbyN;-
zkm~sn9;A_yB|~JC1!G;@*oRFs34ZCSMHTG5&C^p^((a5A1j-@D9Q)nki5hq!*u#zg
z9<b^#@Bl!&q`-%Jf|8J>yvI#B<VGv#Pe|(q7>_W6`9*3mqtEjJKwMWdF>!-FbVTls
zumQ4upOj?!T~d&8LiSEN1I4F)hk;=W!;v#XmM?wu?-?6<hh_&fUjS0ZL&6TJBcb9*
z2gC;-?saR|ZYSUaFB6Cf*ix?~UTB`b#dPlze$>m!y-{<o`)+JSskWZ@eUXSFp&BAh
z3Iw+kTq|At$175Xc0$yT^(GZ2=u=TWKv@(rHBFS2aO_?56GHqRXAJ?ylHM*t7N}}!
za&mBR%$eco>&9!zoiRu{Ny!s561fO2!@67jU!2J=i7paC`{H6Qh7B7?Z!_^gKvG)C
zr{=+7mP#Lnts8MnPOK5+78Fzm5UB!ebte(U<(%u%(8Y1_@zvvfg-MXY6LldO2fsx<
z{|poOuNw>onSvse5}Mn{J(MV5$wS2n(o+eg`iftaV9DgyS6_7_4fs?0#9b`=X3c!{
zve3mO@ndoLF{7gP6dQ{soB(d}Vq%`F<5DOS@h}8*9FWWPQVmOR-2<rv;9fU!2^XFE
z<M}R;*LSor6{9#f)EO0I3i;~Xe!N^Wuy{Z8H5fSy!P2BANow5W{+U0d9O~cO&}l=O
zx6pk;n!+G;LTL5HH#5+hfecuQe$lD5JMRd3KzrIvL?}q5=ho@w(opwkbVm}|$>nlU
zG(m|wg3g|~)HCIe-*E~5-$TW2DNv!|uH1L(>tw_WZ_1COMTld=h7FivC!r!{qwewD
zlIaiQaU&0I=Cen}OzxmF!LI#hBJ<H!!jDUL7A;%|*|Y*~(jh!3%21>t0NXIv>cKJb
z_y4%CB51#e2sgTkP;8n7>;9|R?+7NNiZA->^;$w-kvIZcn4Iu`ZMP^A;f-iO$xnbF
zg+L}8&o_N}b16bIzc34he-oXkWc3Tly-%6GSF0O=m?jJ$fL+z8TSUD2Y5lTLI^$A*
z0g}}KT@v07!kx;FV}F+G6N=!b<f0+u08np`YdE3fC*cRE`o!CLF82I`3za7dQGyVK
zNSAnn9NWJ0RzxktzhKv%W(s<96HxUdN1WWfhf<Qv0fGZ(J~z%984&?Jxmf`Mc<66P
z=?gj{v(^tjK=&cP7gBcX5G^yvJ5*|4c97s`%>H<b{SA^ef+D?SYfB?{g`qYbw*3#Z
zI&~RW)MYqL+Cz5Ag)$x_6Yz>eM*%N@gHY7Pullg5OkvD!ox{`ij*e)!8H>-^%J9^)
zfZ2Z@`<<pO1lf_B5gmG;A4Q;s_u}{$-Y{zZ??91~s7%*WDot`2u-0B9M2I4^aIKW3
z3q*+o>JkS?vLalA#>o7afOrZ=6^-z{6KYY22vtzXAijO+TK1j0(FA;j;!<+zy0I=~
zcEU)XA?A$wOL(YzT<=IC3IkF*%xU%29>m~(9+_+L1oRI6-wtmk!(PfKE~i964>YK}
zuc=YP+e66>C@%W$JKB<}MhDsj0Q1S!l!U4r1RJYNKU+nGIOH1HwEt}<UoWHxt&$56
z;)U-dy%=yJbDp6H`RW7o2$NNwQ+oF1bo2hZo9A8N`t%VAlhVpxypVLB8VDLfC0%<M
zoCZ1|#UA3uJA<R?GKg%XA!b&C&V{BIKqTlJ5NtkT-A=7#jJ;aEW?%yo%#hFyVFuWd
z;7!3>?A?jCB!z8=FvdXAklRT9^ZEy<t8j1K`ZaVC9zNmnG=3s-bNxT06CND~<hEHf
z<<0?fMEx0BWeG*_8vKzZ3gqNc1zh|UhnLLOw$$CQo-a^OCm{<7wjz>{u+4K7EK2D|
z@Hk2Px0b$tFN1v5dHar3QD|pK#TnOBk*i4_Jz^k!9oeUfmX<#<B2FL>{|u0Ba$W@x
zl-=;g#ER;bSLMr+OApx<1LKX*{s!I#IlT1IKe6xgDP$R4jkzO+a-m=z$6m2cQSZd~
z7vjVdg-`$Y_omGSr1HWJxdw6ZIEO@`feTUyVI~NxU{ZvUK$0N@a9=fZHj^*y+T*+k
zRS#k#<SJ7z{rXUZ>;XG5`w5<hCPzIK6_nJ}YL0l;H8jNO7djD!dER^fAW)D5S^-~H
zlDwUTB@wM>Ca5A2P7EiPa^|jG*dU4tFb5%FB3_H%yr`lC2bc=sO%j%d<drkY>YsV?
zClk6A)LPQW9v}z2z2M<m0lxp;T3n>xF02?MRSOiPcK>~m91-wAG?swEzcEVYgv*?v
z@@D4d9*kyE!eJ4d^`x}zJ_{=ff%9VG_2DW=0UXi?azlZzuoiMkqI!j@VmYubB{3KT
z!qG`0h8XNnCf7~iNwcmf{!xC#JpWM0Uw}-^Ag3m&-e1h=;=W1f{O2QbUBdhKcc1{K
zfel$9Yv_pTR0h&PR1V2?x!8KbVbC)Rhl4%9b577Na$)z_(dNFIg@spU*FI1WF8a5w
zckn$fJx8{O=pKq$oy|w@3(aj?kqu&;=q0Q8+<!C>BGKJqq_nMDSywj!T2rF3L7kDH
z;qQHYNq7h8KS0q{l>m=D^C<EQ<v!Aqklp|pQvu{>lVxsc$-((ZUI}HA4xW;rMf7&^
z|FxAO3QpubclU%7YpgF_s?@b@G&~g>$pfw3<+hK?7cL~D+mqbb3>)FZH*sYj`a)Nf
ztX<%;uEpp|%W`02tbD~D%;D6V%}H19^jv}Zh16+C)FV4JTYDvQT#Tla@j<X}vR<2+
znXMtpENN_P{Guu^hb#ApPzx<|h&dn5?&ZX7&fuf4#QP9rzbrQH*wOZ6i@gbMQX&c;
zcMlSVxM4p*JX-0;Ec1taiDClEni<SU-bMMpD0>f}tj{g#_qCs>i7`QAi8W|Yv3D$>
z#)4gn*fA;*#e#~lp`g(u8Y?Q;P%I!t#Rh^{(AY^t1jUM2P_SS@tO)nF{x6<$XYS0M
z?_<uKL<7A4@;v+5d+oK>E?bfOn9i=fL>WQ}J-3DY0QN<p<|6UZy?amyBSDLR0Nu^C
zLr~>W3*7HNp=MK~oK3oYJHIHt=YX%*A`>-wr*dO3u%P?Khwy(JOcMOhIFp^74f?R|
z#NwsS950K?e21f@1J^6qm^@TAb?k867?<3H(jmR1N9GsXVh*Ci2M>J=dESWDzH9ft
zuk&yP%onVS>yxTNCv9RRkov@+FN8ixodPHH`k43o{(sJ!-m8n5^2QS^^w`Mn9C=X&
zG^f;IP_2!dYYrJaIE+uZK%oIZ;=StgSra;%TvIJS1Mi-Co5V#<x~#wF;agU7kdTYx
zf-#70?}dN<NdcZ(!(Xm#-~v$k`}33{@n>F4JN}YBtjs>i%s<~)))(7k!K0@Om~rmk
zfB!X#THTn*o~6~orgJr-ybVd+>I-7J^3?7wIZJ0y@kY5bEwUDzV7;oNas2-vr!MHD
zkr+=J<8AV-FwVSWW&zcxo(DzbLmIdpD3L@t^hAwL>ak#ozW*(md97x@cHjQPurY8T
zyLAs8P2vZWBgJh+Tl#U}2Vz+C@H236)Oc*vkNt{qcS;V?(&FJ4L6WAr19)s8@wLiR
z6o2t+p+MLh=&=z?*Ys)B)YZXZ8y<&t+^h1!|Lu_DdtnFDn%sNk!0=^kmcB3`uV9&=
zipU;*;m4?^mY=x*SKtlRvHw3fw;qpNJZrSq<CMi;Y~vBcOlsA((`(e7muV!+WjDXO
zu1jB+c3DD9KK3zNA`EBewQk2ji_|PY9?<}3gr?nL3?Ex!wMx``HMcE{RqLjccl8al
z$zu76lHloSUaPy7{#)Uva`e?P9Ke)k#A-T!|GUkYpV4<jsHJrI^rFpBDW(4f3Y6=G
zG9ZA?3xCp=YH+IYH<h*{MaIYT5=IghUw=K)NPGuX-q_$z^4{SJi9l#ZePY~0{Ff}s
zt$c6&rcGb&U!C^-_usdGWI$ZpT|T*pY1iN`{k}e(p;zMP#g;TWWHG<I=~l|U_Z{z?
zW#DkZs+-0qZCmue>wR}c7$b?j$MyYgF4ixx4$k6;nz&;O?Xk+e{&C%m^^8K=y;EP9
zV@B!gPMu_hDF=@1V;?6Oe`{Rei->BN7V%!4yLJ2hpI>sEJ3IpAg{;u4*pJ0bEn4$H
z%g&iI2cc<Sk}vblsjz?j0(W+=T86N%s~X^few(lBGpKh?Xg}cYh0^>@sO~X&a$^!e
ze%9WvV&f6FD$y(Z*N*Bpv3OF0oZQ@CBjJ2<&)v)SOf#|vL1YGs{W&`_9lyZQ6XliV
z0Dg3yUOth{&k{y~;c(4e0^mHL^+;lUfgF}afowx+vsEvPnBrT$$jRAm{)kcEmPn!y
zm*Z08(Kj2OKAZT9dwt^>5XaUVJ<7Rnhbu>%@Sk4)R6UD^j_j|cITKjf=U|<HM#Jla
zaBy0t8JSPv&yH+4XjIzF-WsA1pSyqYf=r6kQ1r(M-?S_I4*g@$Z@f$V1QIhV@u$6=
z|2<Z72;@o>KSR{VG$5hEZ;!9vGUc0`-d`VWhW>+!uS&II{Fi~D*T4J87R1v2GMb07
zeLp8V{HLqIKo)1$!ov^83XsgMFu;v_Qz8j<a6QUu9D$6#Ec^&lL`wf}f12V(|0kSo
z4I~HS0!F%RnA@oZuq_CDbK}Mfzkg8R@0)90_$J5YVOCZ>jR|PdM)k|CJ_j2834=*3
zOyh9;?@Qx9rtXTaIb_fvcTeSkgEsy${Oj9*K`e@t17rLBZvnDuu8a>g&QrHWjT-sw
zz;vQ8pKbARK`0EB!(LgV=&6~%?7m&iImsa<RifV-y52xjVMu98vRs3*bTUtI>)W@l
z-wyJp!r#-TO0}R`a0hzQ&ND*7=gSOQJjKh)i3}?vJG+s+8WUId4Da=xN86$vjRrir
zKVQj{FSZfdjK1vW@D%g~$@K?Ffh}SE+slapZw@z4mehv2{_9%zCE{8RFjhsBu>y_j
zk53%`qZb}0TlSth@^YPdVP4r4u&%L{6|BF)dkhuthUHR6bQGpGT<({gH2%jOG6Z&=
zo4Zz;$YoVphNnHshQbMDKNZFgTi|kLDi1Si^n%Q_S1SGlm||We9?83Y{F7ok)Gfik
z+u6d8FtunZO1J!B2uI{2Gp1LkZ<mB_E<z&<z}4lXqoi+E9>G*%2`cQ|b3d%el(jGH
zw_TJ&XO7|9GO`#^&C>pt1J~0z4NQAm{d@Sow_-OJbYKrWs-0<P)!zdQ(|JdTq1czM
zk6fd!{f0JEw$bSap`YD@855Vj?bm)Q(CZVf#^aw}g_qnYVsPU^TUT~ka7<iWYTR)G
zsc1KrVcZ;T9Y2L63akj~dLeT#$i}zrNY+C9flM=e`vZT2PD%5ZFv10`-neliu9Tv1
zz!)J#XfdRs`SV)zvH0(Zh}J3aj$m7bAl&Bk58Jh?H~kH~CkFDO=uGUy4-}9Nzs&w1
z2zq+}!BwZP|8)+^t1%uBmLSKaa0(oxOKJaIK(DF?zOQeO*?AJ6XQMew&yVrrI))7&
zo`Fy%b|L`{H`;ouXV0E};r8v}>|NDDAl7t^8zelt;Wp6>dyE`z^?7`Z@0W)+-1`M`
z2*e6V+nxg!=YUGGQRO$ylTZ@K#sZuk_GY>`D;XJe0J(q@6OfEuym%1`<tj!m;KEil
zt6I$L|B)(5aV+iGB97RA2HvOO-wwsIRnHIslW={o8+;^B6=<{2$RiFObRy$`p18mL
zK(Y#~WckQY{+8z@8d1h92qt=Pa)Pa2|MAiM8z(atola_Sd(YfR^MfB*);I<Ahf51t
zFcG)`IiyD%RhE*Mm*-J`(ug+KbEZCh_N?Kzb%E6fPhOmitEsM-PLuVx?59tyXUv!Z
zu*=;Itvkr3UAxq_ch*`DKm5Ae(YdXEg0_b)0|oq{F!;WrbHLrnrNkN%;!(Z*%>FP#
zlR-19w%qu~A7{TD-uD=^L2z>U!HyV_*7cCbA-PIicfI4|$a9<CGnlACayo#T{z~-3
zq2PXlCw=_zA??x=^Zn3?E&P|5t>brkVzU&AuWGZcIVV3xElMo&JhksEYg|mecjdL6
zPYnw^mBnHlJND6EAyc&gIEGjN+?szx#FIL`Hfi1R2M)Mfw{E3?DRlEbyVP;$_`Hmi
z<QwNV(7f{7ah&d%N-S*p8rsYCA^&}%PknOz742XBsdSfZGmhM0*_<L@#<Rlso$z?>
zx9kwfo=)pL?%6YJ&lE5<7e%j}Dy2c=#*r7>ij2$qx9NJB#te$SP|j-D#Lhf4Mzdh*
zx3lW3LMh(A-~9K+TSbP3p4$%}y)Qx3|J6g*jP(kZ%g{-weIM*<xUk}P-+@t23-JDu
z^EKgMceY||Y^)A@a6DeD9Di@kV7JD_%?bQCY0@O}pZyl^#wYw0(~*8*GQ5mB_BFg;
z%$EQbF8Vm23{5wXSrTB|V+z|fC{oZ-OvX4jcA9nr*gwVHW5}pjp+o>nj!ns^bdf60
z;pvefY;yUa>DC!%Gh`BWW|>S3lI;$6AHv@eE>d5$2VLMH3@W{S-n@CjPBP|E%K`eQ
z08suO<79sC5uJ=aIDhcH65epah(Y(Pt*xD483djjYo-@kA8MR;0G<RWO77<4zg`X@
zAn<|}n1De!3Bq7f`cEA@asGj5)8p*y5s!{3UJM&n<^An_8d<dLl?^oi4Yoe>0`Kj#
z{IXILJLXl1_`V!5IuvVao81?iQd+D0BM#wAR~bjDCP}Ys4!S3GCT(@$4PL>>Ex{;d
z^!jlcf=V8fnJ6IublwZ+&+qfz%!V6RZ{>%NA0x<v#V^X3*T4VQ2{)9Y(7IT*ps<<g
z+igaE-mHW*7jIx%X~(Ab|M;DMo5q_mXZ?I4$ALSu4!(F}!A?Ss4Wgv6TXefek3P8-
z*>J8_eOlVF@^>oSbaZwOX1CR662Zl*7VkcMU^~3sfA-zSj|q3~9AEX#^=Q(*A!*MU
z&(N#73t{Mo?#nar=YVRlPIlx__hr`sPi=)%Xo0pqX;ZzQHG3mlQLdfxa|hMJ;7N{8
z&8Pa+rT@Kt5Bw3_>P>j~=#i__>pZut1IO+wV0AdeB?oUB+-`32m}X%-1OJSxjjd<S
zo-@bQ>D`#xBa^9(!lX(f9H<y&xxAKimlZ``Dz!*Tq^oU*SLc4H()^dDNmG6fChT8f
zst0PC`+jF({fJSg>ksZdn@iUGB6cb@=)sIZxaa=Wb9>Ywps>cJN@1U576AG_>HK+x
z?QN<92nLfI4#aWpu5*Vzn_@PQ&F%VVI&p(eDSKGw%yoh(p7{=AUFV)vdcS<Rx7+pa
zfrFkgpXH*{B^JdK&Jf^s7cg{a_ph&wUQv&(EyDBA=DXKIm2%)*xWZEJ)yTt@mY9xg
zA}23&Wkw>v97p-NX7dli9O0g}AO7{3WP|GSph95z)3X>;R7ee^!0+!w7bdg=Lr?*+
zUZ!8z_+8rZlxH^<Z_XuF1-ng!v$|7Tf}@MXh~JYs>*>jV@nfC3aq7;A;gMwzqxg~t
z8XQ%>9;OQKo(VErfpeQrFW+ZFTwI)dMKclX_BpzOO`TG2MfRQJu6O2r+$~_9Wp8i$
zsrR$X!3kYYCvmX^^Og@Yj7v0CJ<~ec{BOQRP=G{+rwqRH40_F97x_ghNH`=0*PS|h
z)-0VXEcc4GK7(I-O_|a(eYkJS@P>a&1IemLmb{OIfzv4hi&<S}mvS9;Aiifu_AlA>
z!2Ksr8o<YczFM$NNmG<h!8~3@KOIa!zT9C5(0qj0>?k3u7bQWz;zzB3{XiFj-Oa3`
zNmj?knJ?G0C;5tX!iYPP8W1@Dy7)GsPO3-1&(BlBRudteAMJCUgzU<C?9!^)MA8p{
ziccmGf5k-Q&C}i9PBTLGX0)DzZ<XBW!Ympns*Pq_bHLIQKV;DZKL8C4$>jAT{}b9E
zdSJb!xZPPX&x+Tf4t4r?<BEKv?%#wUs;_GYDYpS;haVILKJNL+ZDZ$--|01?&FKT&
z%j2uNZ+89YGb@hlZkcy(e1W>6<!tkU<WJ@BQd(z_Nv&gGV_RqkkhA;GoY}^4?0k=u
zV{_*~DI9T}hTh|+wx|Yl@M+`~c_3Mm%xhrUBapY|)cR}5c2Ft0QXy;1-PJ~aO)iw?
zU$V~IpE=m|M9#^x<7?Q?$iCI}k@O~TmaT_s{qGyyJ@@H#M`mpt9&;l3=FN@uHt($h
zR3GkG@^<vZjbzQt76{uo`Pg8zQ<pU1Y~H62VW7R;&X(BFkR(i)Gj1*62aeOr<RuFj
z3vP3m_9vKXs>An~PdQLh0~M<mfbmv1$9Ku$<_41c_|G|D(D_);tT!A@j|tW;!=gU{
z^YJeBOxx_*=z2EU5}St6L7)73MSUcGvTuSKl&W$DkHIJsx?YvNpt<=6-}`OB0_^m{
z(B5jV)9wVSYi`qQWDZ>p3qGI42An+f4PlTF(@PnG+fZzh$av`p5o>J1w5rRLIWR${
zdQ-kL@9VPgKh3ZF%WWYcXPSlOu+#!JJ)G6>+YXQ*Ca!;sNnHeWUBa<4H6m^gDq1xf
zsl-o`BCP4u9GU*wwRP+jvlWQ)auOSGahwePFl$dNE;39rY##d$os`t@&@G3t1;YQ=
zbo&+%7Md;q788#W94acXX*KIW#N{j~!hAu?=6??QdoEn*oqNQy04NHE_25U}_kLY`
z(h({w51!2p=8~Z55O)x*HIX3<Znhv~d>#*l%luEQ-A2A8FS8=hdJW)p?|n)cc9|7B
zvfi>uXi-tfZYCS2+}uOYO=YY9ZqAUBBg_eXOw#9<c}?c^YzfUNRNK$(!q{h)i67n+
z?0=dC*dby%mA&)<@W^ySV)Q{D*>m9duZMs9w!?haoh02v8%JOrUA0?6MKu{fKLpP}
ziPuAXa&_orXEK(gDMc#%1I$fJnl_{VTs*j_4)^u0l!j;}ZQjR;vWp-a(+E5*L)HiV
zQ%LkxW|}eD^wiJQ>&OiD7W|tT*T-%CZW53UMh8bS+r#=~fgI?a{gjgcP?V;D>)3)t
zt2-2Fv8&L;P`yuRqsp)37J<nkub4W{8POYku)+1K$2(8)^wdxY$cmEc*xUB`;trbh
z=t;N3rT?KlW9W^M8<3qQEKGto9?mnSPA}<dzR;K|pR2kJE9L9Hx*hbM2w8=!e=s;M
z^36*Ey3Hd`<UqY&><UcFqPKx!-sYp8GFPUZXVJm8ZV&{2t$gU#Yw1P^#Zhw?G^zp=
z7T8;&Kx17-z--Bq_~q2;(_Jx*zvNq_nDs|K_cg7np>>zl#h`Ef*v(?Waf*iUa~ihC
zn<V#c)}({6JYy_AmqTAZ<v5-mGAn=T{zr@6_6xKLMz3y@ID@LE_tV!oIgW9^K1<;_
z*sN~fc+-n4(s8os-}Y3Dzru-_1PS;_@BcJpv=qmvc7a-~(23NeCk0uyyiEKVjHweA
z-W$SO!#~cL1c_8za}dFlbcAO-g8R3Ir~f|gKgPxN`CQ!idhpJ7QYH)ynYp?Btjo==
z<Y?tWqRhxgspSN<bk-hj({1Wl7G;KctKa_h=0q)FrXW1-{cZx%CyKf+j|?%jUO<zC
zKxf_c67B=!w}b1x#2MFv++7hKjq%f`PnRyA5CfJ_wOWz*#!RdnVK&+eu%zJB#7F-v
z6V)Bzz<a=M(@S*hhLK{~zQ*zB`)q3=Mlm6c!}Lku!@+lUB#OC5gXv<9Pusf(NV%a(
zy9S1B{;qF<m)C;^m4jm2u@zfQPTR%jidiZ47B#mj^W#1~pYE3P(HoXni0X6u{Z{sH
z$U@S*bNYZP#+0S1Nm!F4rw^cM5u>zvkd**utC22<fatYNif)j2Y5%zLNnYN@lituF
zzhzO=3m*pY4qD?@kpFUZwNuOb7cc(Pu*$u=-uk*l@_^1MElN17ZgFVp-wk(LA8OWc
zTCZpI0(!RSW7TqB3$)w&y<4<AU9I)0Iu&NrDL&7qz3ZbNuWt)ZvwogB<)0J(cqaZc
zYe4O(TXJIgG~c3+AR`_2ynC|4+Kx;v2!qm_F+1<s$wz^w`;vpkMNfVE`ZX^+K<{fv
zJ>Mg>8#es6S*OWJSw4U=uMG@r2p5N(B$Q*0J%DjYO~?7qPXw+GC<vo}AeN9A(e<6f
zUz;309i<+W!?qGf)<X639z|y@Ubbu*HVRwmc!aWr{dQ2VN#8?VBT|?&RM&6Z2!{$W
z{_>8+KtJ0^*V@|HRM}*BNck@KqcEtS%OUfy9(our^2d`8&A>o+{GPMz+O`dI3UeU0
zJv8Cjh^X<-3C|pYdk&7C(Rldb79~oUd?0*vrxuhXQ<F6jpQ@|?EO23KiUdV#2EP_N
z5X)|78?K=xFEd|y1|9ZK4YgGCmzR@h*<fFfRvm4$GJy0jjA~hZZ_6wWzacOe@KIHZ
zSZc8SQBlsIdi-v;RvWK`4)`I>*QlxDi`f;PoRuB|$N99mo%8msL~k&qVyi#7chApb
z!y_z3CdGdGXupLLj}pF_`&!ehI9Ml28x>cPTY_w=WIKQT`d}zGny1P~L6fg-P}?fb
zmTGN9^$w~|rf1)Jzv@^tQVRL2h|7Z_sQ!o}?|zs&x2CP<v}w{I6O!xLbKGC%qS$g{
zuKT6&t2tKvPg*4#lS@qR#_pP0{nUsKvw)7)>?k-oRGmJPseKhPFh__CDz7OyB~sU{
z1zHKXJ7x`gOU*N=`q<H<fA}8`K+Vs~3P3kD{H+KnCHH)7*J;M557SYb-`?+*Cv8*K
z<vL`o8c(4mN01<WOjsD#{vn;IaF@u<)ICv5!|am(aR&nr5C^MK%do>5@1GQVe;d;Y
zIm=7sLspke$JFVt*SMDBF8@S>^b+2m7_qm8gt(|DOk?b?bNBXbaQ1Akq$GzE9Xvjb
z95i_FIA*E(PfO<x<ByIkTz&6Ed$IA!&vWhj{>WTcO4~hWZD0e`<=<w9lLO4?^Zqq^
z2^H&viSM0D_;!EJ>iz(CLA@}k5kyYr496-|*%ygT1M+-2QlqL&sh*0jsbCsHYV%!3
zSPR=USP$~W0LJpXi~BOBAKpcPCocR^Em10YwZWC)Q|tGGX9+^sgL6v#B@|YFdzqoC
z{Nl&g8);k6*S-4nD@fk|C@_^x80azNpTOXLq^vrfEiElwUSd1#$l0zO(Q}c>^U%$k
zmG3lKm``p2do$X*@f=J^uIw7zd~IXbw9L?$a-0yUoMKW>pG!?my<`m&_^KKv6c2-<
zlS+CP?ApB>)rbT#y}JBfHVH6S1|`tC#uNQjGpk<SVgD^TSk$E3Lx8Tjoi&R0nu&!u
zh+UCsaj)NxbxXWiLx(%tAmKhI^YaZ)E7P#6Hz(~_BA6#Ep4Pf#A2x@z+a<_$GG&R5
zjt(EN{dZ(b5~Ou_|6nySYE9CBm*qa;{U;P$)LBD}5bFK@mE^kUMA)G-eV16&t4%S1
z;TD`cQMbjrM|3J~FVbgwxHrW8@szUkn&Qn*+HPw%^XB&TmY)z)EcUIzpYGP+yu7(t
z$xxq!b+J4^dr+-0fJwSWQ0ma$>zmbg3|R_Xn*o6)y>yZE6X&pffM}uA;t6MaD*KX+
z+?F!4fw?zMI9&zQxwCfHC6%guS1z6<4nVk@t@D_cXmgw8r-9{FVvywUc28xtv77(k
z(W9O8vQD2l^BBst#7`2+sEdlV#VYD)rGr%1RIkUL8}X`iwZeR*k__g#qa@D%HCTl5
z>YvaXjqSNblb%VjNnjf$++Xrt<2?{d83xmZDi0?A{xx>bt$#Zl6H_V1#x(QYr0+U&
z3P<wI;}CQmp80ZH&$ab~DHM(}epMTt!fOmxFkQ-Q;7O>HO8O%1)PxBWmM$Mt9w88K
zKvN5l+jkF|`SPBTHAi{uMAh)@+CIa?Wl4nw!b-`P04N#7v02<l=lx^sxBp<=)Qd|m
ztD3h)bw8Lgx1x4`<R!21^BWaAk0vV{X-M_^blb0A#E9LIAQ(Go4s-*ikk;wBrirJU
zY2+p@P86BKXiQhT-S8OCPW1F0sr_)SkHiwLL6ascCoU>8pIz=jGAjoxZr06fQ(Rem
z!PFUnI^eW#R98p>i+-mh(&#Fta!L0r>SC&^&u&CaJgYvGFX67okBLCWje&=Mz7x<o
zBNa~X_-XLVoQo@vHKksOaA~-LR@fTQq2LGXl9~sud%L`6b0^2IEn=6JGj@?E1yWif
z`LbGcsWYNBd#SsnLXZ1(;`aM_)n+tDDO%HH|5GQYt%$<pK}z<11%?m`K#L(%qEc_+
z;@)V)kx)KSDl;9Daunn2riC9)$xpu4%*Jd_RIY3xfSjLr)WX)$(Q*3wS8fTTX*LOo
z8eDoapex$u*ob#ockiOoXi&_hl<9pJ(&1m9Ufaq;$hgt$7^i~Py>_i^CjkDuT^pVf
zEDAS@X__qQ+-5cxx9s1yZ-8XC-poa>(z2&CAl-|WK8mD4#2NDB!&C16&T%aQARLwP
z(EOy2!<U|u)G4@Uh3)r^i1{LN5DcCNm8#wQdGV4ZewNhARW}vau{UzZoO<)fjUDJC
z?{9wwi6|f9)8;PkfFRa;S2157DfDFD2X7b>v=;#C+D5~NfDbsjyIXzRc~vhC0$4qv
zBthd@p!FSg{F$^W|1wOM2l%hEHXcJHfkftOJ0<5~AMxS}t%WXbv5h2?vf@@aFZ`ef
zpjrL<6vTI)K)ELer+Oc;sMfH;tpiufX;~rB7}K_t@Q+)Fc#ZpdwVMU33KC(U|HRvq
z13L7>e_neUv;k;uLq=01MT$v4bWS0?D?5idbmd9<fxBnSWBqX_H?){e{0ge6Qx+WN
zitduxC~K_-be5`A8kv?8Z>;%Z>pMr4OVn>fU0byFp_VXYd&}~YvO>%%ScFxpeGy-S
zQq74+aRtHx1}VLCbhA>Gj7co2_&|<=C5XCRg|Eo7UtyK~Y6tU7hq)!fUQ<FvSUR|-
zQzA(TMMuKuo&k*-(tw8!A2BuKf;<VFX*R{i#SQJ~U(fOPljTkAM=5QQmH^F1;Q>PH
zStf!UJc^{^lo(2@uGJ4g&YO$U1WBa}hugB{(-O%&<OL;Nhg>Egc;tOKbm&k{HvUHt
z?!zN;hF>agL4q)8TW=O3eTKQmtisK~wy`<b`gYHLJM<W0!&_0$J`z31z$eaH%5DZ5
zQwxFqp(t}4B?oUkVyTQey`*wXeN+5IEYz+5omk&I1DG+qRjXDy{f0!1$F6#(c!bNB
zFYng9YsdZcEdi*zXp%h$6&LS%!M|aI3S9(K_(B{RT;g1JBCfSt67kU;#u5;zBciGl
z3L~A<d=Exl^?afYq+`}s=B*uHOwtol`)aoHZZ&(E^XBZ$R3P&4ZPUPTX?yvf-vTV>
z|KyM@kGva~S8`8j(+ihLX-C3%-a|@n6|0ms2XRn2f%53_*Y<8D(_6NDiT7hpJBn=w
zHc&1pPt|IVYRr0{5#W5_mp<xva~h-3dQq-T+qU)0dmL!S5h(@4O-N+TN!X2}fc<Jw
zsgir47}wm>XJ`BYLri@U8$4=)pUy&fLO)5|b9JOhTN<7XU|9?Jc=Kjp?9>df_S(4O
zC7fbW^}}YNN=$82ye)#|-D($bjs6qwPrenim4qXdcO@0W=9%}tP`1k}D6$fF2iYSq
zW0v^fM{>^AU#0R0b21v}wMz^LGQD{H+6f{83oD8@CMGUq)=Ojqk-XEa*hia*$btV;
z7TeV-Oh0PctKbI;EbzSfwq4|%hnbmHTKk+~oM&X4`-i;+U|3YTf)j^gF_+?|nJdNf
zr!JDEaY8_2nlBsJF}uk+Ja9V!|8wM?mo8si)SaVOma=F7>+w4|DjH}Rfu9OWb7uM;
zth?$fS)$|e-o2Dw!En?=y(R{N%r&%r0B&87i;bB$aiaM}*wrdT6id%vy0mP<n#6WL
z&Pz)x*^w8(QF!S4=iGuBl$T38IW8v)g4_TK%);ikaU0hF;=)1221PHs16nJPlZ*kF
z9k&V{$NS4v4@a}rNt7Y(&823@B*uA(NT|b&_C1GNdXWRs(F3t6yAm^HwA4ogq-2aY
zATu}Oj^#Tbt2Iy$kI&a$*b*%5OY%P~xucKmrySZoKxclIM79Jdvdyw`7XP?;@37+?
ziln5b2AnKsvS`MB!Xdm}!$p@^UqWBaIi)(hfHD~*AYM)u-;i?+pg;p<Gc*$S+keeG
zGQm9Rj?xZ=Q*ax>NA+(=cSILv?Mv83Nt%n#PbSh6M__;TPO(?He(hQ%v-MDaUxUqJ
z@@?M;=tK5Yy+5|64Bm573!d$0eU^MsbOIXU;RAPXkb>ExN+^H1YuB!_!^)d#M)t6`
z-)GU;1y&o7g5;g-?hQ<m0MvzoG2W}UMQ0Kh!MwbP7L(JC6wN)5fUZ6ggGoae4`D?Q
zynLub@Dd5Mxg9cUH%W$WL{DtM3uhzgBoMJfJY>E~d~FUkO|E_FUEl?R$PYAJ-O&S1
zg~zM0YwJ5Z9dsY?8*BPp1RE@bUf6iVC@PY~lGV8bnwKP<;*nX?oJ0Gc$Xw?;f*DT+
z96@ot_?tRQm*?2Eg^zvuJJ%Ev9@P%y-8!It7&UovB%+N7D0U(k;b<BxUrPw2hV>R@
z7$@FAyS4X>YdvEKFifU$1Ah4>1P2+Ag#V7X=$)UpJxdinY=c!CtKz^iF~xz$?f-FI
z{bHsVS7_f7YLTj|(xr|*2QxyLFS{*e@6TPh#!A(`-P?ojS@^}b61;L0C1kcK*HxBQ
z@I=R_9hs%IimgPvsX~1xV@whJrn$(hKQM<wagi-M9D<k;O3(p&_0~hS>)72~$>c9$
zJN9~?b1{K5NfSDt84nKeu>o-z7CY7d<XG_AjA$+&)T~~n$&??3e9MEXR9O#sIHM82
z;GOi8uZe6JKtw|)T;GrJO}?^Ui*LUb+#Sl%*zN2rcX1%X9Dfwtinx1CR8$n?{7R=d
zJ;)`U!5JjX)0Px-RgOV|-G$X-?QC|~sJUf7@aXxbHmCmnhBU#R^SQM_Zu8BnuXWyU
zbKc*(aS`|whgekg)}u#bV{fH>xXqKLYqlw`l&QTZi&o~S$`45ev^lBfIIq{hTvc`w
z)TvnhSDiP{AS+X+j-6|p_oB=EEt?L}+XE{UnGNK&6{%bM2W-R-4_5b+-0u_gGA$EX
z17C@By_4x~wF9h45~Dw+4{6(R#FFLyrLzY=DfKs8HJWbwHx-kETy}|X4epY~_|}ut
zVCQTIe)0Ze?Mz;X^^bP*Tum)E{u{d_s1Pff+12EGGW}w`t%_P;FltV)O0yteLA+JN
zIH~FUkC%ZOs<oZ^QvuFbWxU%u`Gq@$ZIiPM=>3kGrE7jiVJeF@rENHGg(!cZ>?8w}
zS-*%&`Ol1wRm_iO1m40upt0*!aup4fNXSsro4&Fnzsy@0vb-UgBuL0kQZG$WVMDGa
zYsF&FdC#!6?8$%P*P2YF2@~JTZ%{^@Dt@-i`(RHAuN+{+y!UQk#_$C0WUh<1ZH3HC
z;y~$&Ns8F8=gQ(QNtSg5i<2F|?^uA?RllE}9wcUypkvi&(mAj_SHTyS&n=e+u5r<9
zQsdj+%ogzVeg<6XUo<nY>!q8iiCb(Zx4lYe1J-rn2!x_jrdQ?Hzm`APq<45x(}Nl;
z%4Fh|><Q*#=OFnyu}aaJmy9dIFqMopbzek2yA|t*^Q001+7F|>Hgyjta!7=a&%8v1
zRDtLI-q31dIFcPXvh%MS6t-O$=0aI>8Jn8->$N#eFaFpyb<*>-gG|t{?EP3lUmE<;
z^gBKJ^*ioS=H1Nzm=c=h<Oh$iHY1OQ-Hg9;41}~R&HI)!>!1UTlF|kghScr@h7u~?
zOOz~$S$YIzJ1Otay#`xYp%|u!i`I*y!b>=F=1gXf6}M#lfgzci!-OtW*1q2NKvTun
zgU+q0J2xx2JGVM@`t+7IRZ0gT<I;e$p92RjUlFivd+>reS3jKCyMO;>=uXy;;)#^L
zb50aD3i97SMikA|a4fFJzToDFNMeQm<(=0jL=TJXzjZ-Rf9r8CdO|a|rD|74L;I7%
zM;=#vn#AMUXa7Z#idSDEvx65W%c$PN0HVKD!dAc6xZh~{(rnPITnP7gBiMDkOCDX%
zF(gyAPL#p=HCipqgGpk=I|Cl#m!gON%4AN`s~=Xz$V2eI{OH-lbmp1+5D)DAaJzGh
zn*m_XLEyxy31FdL2x#1x9rc?_QB(Z!84UiC54<)gSmtzoibpRyVs%3}?8;0;n3v3|
zkRlX3=i%W3c{6H95QHoq*FH$PsGg6=P+afGjqawmr(sL0BhAH%LNAXXNtV@!f<guP
zD!I^&r<nQNe-SBn8Uw)z;+*lnc|89^gys1gH-@kPoLLsm$Gm6p))S}Rrt}w<Lo_}S
zQN)yf;-i`Z=&cdd&=BZDjfB2?J#Qm~N>d|aGXIS4(wvdRVr0Q&Ctm(G2Kz7_#drZ|
zp^)D!Tkal1_|6jll*CKhMLXaRvi%C!l0ov2%ZYKYaX-ofkYP5n_0T)8tL3&9`;*aL
zfBpeGv8SI!jT(~;Vsgy_63#o|Qy>1g8UGx(ob9>V>uswSGe(fZz{4AByo0}Iu)gFb
zOsbnofjM16U#QLdb;w<#atZvaLc<{`M4B##=6?JY{))XHSr0rg54n4&xK-iKZmPVg
z$@4##ExRI#hM!+;7-YJMNAzeVo|8<JP4pN;SNst#Ui|)D_y3D{KL}vE;O8POfDve?
zID>>(o~I|_@S(-Ve;?EQ&WMhTZ0u-P#I)!#;NNSWbUm}oH<>K~mxNhZiJ}SPXj#Ok
z`?gDrWeZ^C$R(fZLxu>fV0p)}Z6|siY44UEKVM@-AolMf`7~|>ct!+o4dIZJ5owbY
z@VE<DwQA+xI^6s+%;~SyPyA-d-x%n0ZU3i_fj3Xy*<5ry2@?s7Ce=HKI}PAevo3L|
zbcOn%Jyz8&8Cl%qd!*L?z*Wh#046vaUGX9bCkKom_*AV{zDWv&61~}Rv4QK?*Yoi3
zP;mwWlHJn0$?&v$bRcP>E7^sdojxD%D}_aePh4Y-M5Gaz%678uI-q;^?uFa9dTnDH
z+ZD+fJM_f!>j%2iF}cK{ZJDvT=<KmYQn+57QuM7(G$>-K`5arrtCZFUQ7%YxK#Cmz
znH{_|7Z37!_#p^^wyC@F#|a!@pm4{Z<Z~x*C?cQ_4LLL^5SIn{4ix+5VF!>;N3L8+
zUCRmAE>SR*{+gw!1DC%}CYY)r^$7#kB#0(qkT9BN7|oW_R_2TD=tZvt0I>(kpR1%%
z)&U}GQN8-_PNy6Itf}L?YtR6|AqN$CK#cmMPNJFkjy@<yvq^d<DZMnwfGU!H+1l5j
zGf!|vcL1K6yvvjyk3s6V>m%|Ltude%zZ`##I*c>yzOK>aaL1j?nX{qB9hX#n2|u63
z(@&O{8rLq}hbk&ADfiU3{VJKgkzN$m9Ipg<sZYc&9Y8;C&$u8KcoazSrsDMIx}dpN
zrc2&9YC&a_sX%bPB0bU6BkOXo7!+6u$*EW>3{8Id({A%y-oq!iwkc=MbOSPG&CiEX
zS^ekzM<yaS1KEQ?^pQ@BGt1g4NN|TNV&(PPbkss-kqGH0{%fL~*}%xR)Iy`{GZK2z
z>$vCz$LF@i{(!5s{1jOnzY63+;HneqEgbmyT;<VPlx4e<`ihPun<esEndVEzE59i7
zVm{Y;UjF;BbZ?&avz<J8^mg#_$KYaDkV3!z&+3f1%21eRtAJX$`7daW?TWZ?;b4zX
za8190JOBVARJ?xpkuv?1u9mL?GetMOR@~H#C6esO$%XSkbCdK(+Lc*sBR@;=Tt9pW
z2Q~^H5*02xG;ry#&WlRdcRhAQP2dq=$|aKN;~EpGQL<BTFbvwC4tk_a0g;#(DR=Fa
zjT!WlclXUJ(lk=3fpn(iB~_uG!>OQ!vjW&XfET&I;hJe<^j=n(EQ;dIp%X(!=t^#2
z<0NB|rbfF_pBgRw7v;?7RCQkp5JeP+qDOP?lZRS<dOjwGGqt|Uo?U>=nbJWOE^?65
zzR}TnGruy$Z}%h+$#YoxIT$-NNlSDf%cF*8z5AOwJu6i!f9@^bf;n*)whAg6v~L@_
zO{blGtNrGeQBE5X<Ca{^WaOX-wA8=HprJz>)U7LN?-lJ!`3KX3y#j`*l0Z6OzVeG)
zv=f^5wiXMVQY1Ed!5u~gym@{nlHL_b%~xrxZJ5x282-=F`_x@caa>lEp+(6w(>cmC
z^hb8y0LoGdC{raPO@KwfI-kD}_Zm|7Q&Vpudtjxji-r69-(Goh`tRsb9!}VB`Bs%I
zSN)&2R;Cqf{?l?!S4SQtt~2!-PEBofjA07g6ag$>=^f2&gn2)9=y2O1@5q6&=sZRY
zKR$2x<$}iZKR}M6i6;RnWN4?@scy>H(^>8&dz+arf`Tm$b4_c3^tfsn#;V^PGNV|z
z^Q_TYK%hL!URSSP4Ig|UM5C9Gqcg6&fut^cvt-VMiz|wPTUm!$JlZ54ZCIz@N@`uI
zNl3EucXW=fbY;I6Lp}MYMNcL?qyX&b=uS9$Gk~M4hu@Nl4a3=E5kw;qF=20z^wy!q
z7))osq!bBxtJ)n}aR;+5^&QFO<vYi>?zAY~zNo-8PJl6-SQxvxqw}y>oL>aUhwN1y
zC;1kV1uR`&JZPo5P740O3LaP*!qq+|8yzZvDrVcA7p>ndYr_YYKG^Qi!sFA7at+Hi
zdEbCR>o_DG8c6?yM@n1nM<}9$hYqcJl;*;V)~cI0!|TgKqV?pfqw(J+wbJlr$@0Z+
z_xdU5(lxBzX?LaoQ^`0-n>T6It0*l?gr%3@!CS~b>wD9pL91$aeGNNI)DKY90Gh+w
z>5zLs->N_4U}$0d@WI-RD}Hs9?;1x&EzUj5c5>|Z=qPA>`&k0~)1Y%MJjf*#*V6_F
z=-s@isb-B2bL*u*je>Nxrt>Ns`Mn48R$ADc`C&ELqRM>4U7Ah?!|Q|H7TcON?P%bX
zd)+o?Ka~Dqf@K&I0-AsB+xi1{$yym=PCtT}6VbFI6*lG6txR_=(d27urct~<bF^=<
zmUM3Z{BtEClTy&>=<Mn61}ayp!OQL?1f@q08S03LhCt~F-M}RFwXnUk*Yn$FaY8Zo
zw-p!J8U@cEuZ|E?t({5?u$P1oAnPDYoAvxR%d;jJ9f^>JJpr!^6Xo@V^j=@vXhs;D
zKihm+vwG6np(EwxQeLys)KF3C)|D0)Z6=Uv|0isy;7UbJbhqgX%>~B>VNYmT4_^DK
z-le-91ESCF>@vao5(iyU`LdGvV~C*wg;PS#R)c2Fo^6bpz=KP?4gs$4a9GQ&Z4d^t
zrwfcd9sfh2k+4*K@^^9T^^Q_Q?nQo<NI{hta4n$d|B5V<Q1K<b`xYVsrvHpo&rdl*
zi82*MG(f0wwRvLu?HUh5>AF8E!)1u6bUB`i<{YU~;&^Jv%n`gd>>6>34FE(X!D)iQ
zV`ort!{mC`pr+fm>si@tJv$lAtm(xiJREzGF(tPA!iz==B~iehVX?LAy=`%c&U`}j
z3*d&;kj+js;HOsT$#Uuk6C*`s14DJ-(&fAw0Y=0nwz8>hsuV(8o_&8=YdQEVtJdx+
zZ_hJ;?%!jjH@a2u4_T<mE=#S3&zEEd&<lnD*D;WJRYdU(m=!`yeN0=(FW;p&OHJNj
z;IWE?yN9%-fmBr-rAn9$4`r_oWT{bS24UPO4LeO$b*!Aio$8Ty+HFn;kPv%7GgibM
zrUI6COul4F48Q84GKVMa$nKL=Sqvz1I4NDn$oyi);`_dl!+af=#t10Q#{t&j^c9N8
z4uI;Qd>s&qMf=;t(`=Q~Q11X=+fzE|t+N1iWZ<G}ZQ%Ds>^AG<J&K!!ocaj0qX`-B
z9624N=#$0|hBJd!qdvd`aaIOZ`2Ng@{ft<e_)xDmMHD}*!IczUoJvqgR)Y$%dXe`F
zsg}S9nF(2cx3hp+vt;}v<4;8{8wQzx1z`=Qo=7-BU)EjipYJ<cJsH!Aoh-I2u-G-E
z6X1dAja7|+ruWyAg<L{**cZ6L?5yP5d6A-+U9Ddc#Xu46&PIx|u%lX>&R^I&!0ORG
z@PMFG42Dp{^MK2Ge~cy5w}x`4I6(*^4>$--Mbr%TiVR?Qu9UEDIOLvlQHxuS6%<=6
za&5-E-2hwTIOarHHH^%F7KDV8f-YTd@L3iW6>RO>IsM||AQ5?S6A*))mTNCRV2v<J
zqH}O|DI`b@2#d(DjEXy}h{<l=RLWJE0JEx{iG>p;PQ0>bcso^>-220^WlZnBQ#zzG
z0!t+jxd&BQ5_FTq?$l$|+)w(FEU)I~=wLC^!0k$}RIF#$#Wp(LctOeH#X~87MT5yW
z42pH)ygodj_K5sppSb{R2h4pL;_AZuK;|m16sQZZF6x8aG%PBK0z`}oqe=>8;gC4_
z&iSR)#wgSr)3YwCiF{cp0vmAqXd@2HH#Qxo2bH@Qr#Y5Ck2aK+S_XsyW_Krm>;8Na
z3(2jvdXd*Jkb1OlqD-6EPDho}Pl}BW<Z_Sk*QoClDziPSm8A8%06@m0ACnU_9oh6_
zF|n~4)q^<UScKL!$)`+lp!<w6yBk`qH2TR8ex^v$!VLb;?2q@U9bjBFER2_hdLu#r
zRW_$!;+x%s%dMj95WPfFSLP`W0vL}BoXI@bwBBxt|KV$p4V*JIGB7bQQBld2j6w|t
z!SI^%!?6=2zp2)h^l;+47zawta_0~qq4b*Cr`YZPC6nwkb;DRNG?M*myAvqgFpw0-
zwEus=ox3Zuh9|L&btBjnLZ>6$9cLOOGHBciLLMy7MbWr8d1=L%3VOgN7vVxp4&v+w
zYC`ECKffzOnv`Ci+GQP6dcOOFUy1^@{{0!!8^W=AnPmDq*zn{{3COBgQcA92#3iA|
zXg@@m8z3T98xxe~lC=*c-pLq{muOs=n}<gPkNh#bvK0Kv)TQK1iMPG??AdPMco_~U
z0h609P9>Gi{&uCy4$)34cb+m){ZixF;N=Ee%!W&7FPemUEFGYJLDf6VJ_Gcw%`5#4
zD-++7lQ^u@c%ofAhN27rL<RT&rZH&;zq1tt3#=`04HY+ZD$|P<#AjI>su&g?r+I7g
zv!b<N_OGmY$IyzuXiVtP!21~!%N=K!f=~gNOMJW^S0O`29v1Ps3prma8?-dOr$G}c
zPzg}~xdUM-X5&Oe#apj1*O<4HU-0-wR0R2l*aR$v$~s8a66_^1r9z`YAI9lj8{o0<
z?Hx0AT6#xtr8~~WKT$bN2S<Q-dja~Sc@=TGtwgQ}Kn`<n*>XrDFaA*Kq+*#KuGTaR
z86CICzRr=1`5tdNGTtPV1(O%C%C*Z}J<^WEifIc?U34|LbKF8<fcE}N0Xn{hmNW&=
z)C!#r@d2O(_I`v*c9dXGHi^zKXoFpsSTt?ZmLIs&ixCzaud0i6?!k3L9y9QN3)+-D
z0EAwsS78*isKhTw2DL%AH&pyyjSU1=AMa%-?al>gr~7t(&YKZ|TVs;=j;;{znLqmn
zZUls)9|0pmf#GM1YCvwuJ`H?!m$-OLRyE+UatCx}av*iH8aYHq(A+B3%EecM5H90t
z;MXh_sYHC)mdT9-rg=-7>aW%*Rfpr2M37Pz4>S>9?C!&dA^h4<0<-X7!W$g+rOQdk
zOs4k+(W1Zm7^t4m8`*`IXdo-Jiuy)Cge~kK?3N3qH;~0^av|nB0{|J7H6C{9HN<+C
ztuLHC`L3V|`jF_8za0q(viizgc#XYLQEPz}+_pWZ$8-?o60`6om;ABI2$91y5YM3B
z6|u0wo&yWa`KnMgp9M0JvgV|Hy4ISm1}DGt4lq_=km0e>e~^L3O}Z6RiyDX$LaIJ>
z!{q$R#$z`)7~Id9Bc%YLRFIt!?HTdRpfa;C*of(qE$HCFqTPFI`JaDYf_xf<7N(eE
zt;SXPWI~bV*<v|#NBc8gG+yi!;R>jGGMy=BhTX>?UEj*dMt=N$1PwJ-xPOFE^K#^b
zjydnAB#$FU5EEOI{J0OdYQDPkc^{v(R(#j7L5onBlF)X6yqm;SDV6TJS0byTul8!>
zjoPlHUAZ_@$(Fu)47)WpCMJ};M51JRb9IIe?K@4qh4?#nUHkIn?tI=FYdiVmz3i^G
zp)t!399q;Cjvsat{}VUd*cyMsv>vBJnMf|`2B+Otu=@xeVxD#J2VK-RWaq%-*bb7=
z>%*PmQ8#@yyI|w2<|Y6Y;lk(LHF~Z}TB*9I8ItcDdx(XbxV@R6+u^8@D0mxgX-C^z
zepu{!SuV=26rl7<?6k4euXl2q`dM$udGp4fZUIm4edO^GD~TlfZh2qOmm0XfnHwdv
zsoXHCCuKfbIcn$dF6%8eKZbPIK0Jngsy{ec0^;iaMkBj<YQ>jw@RcUJSg{Nd3?>jN
zyGxrZcQlQO(1T^M;fi+%W{B2H4OOut=H@!fmhSnHoaMna>)W%?)rXUPEe%h1h$`x{
zb0%5Z6HXj)0#(w)2^7vQ)RLyM`k{OGv$k{p1#<A<dqjcJXhtd&rJo?W$-qFlk0T;E
z>P8{+6pAat!R?qSvh0@WTXt3@dx0ntLfrlP583^Yu9PZ~R7%&Z0I&G4tWwjHTD<)a
z!jqAdl_FH}Yc75KrxwMvbbU^IcwUb5U}g-Q0yqQBNU9_k^M`k?Cn^rGI!5eX(O>Y>
zawo-83yk~NPK1I0OsfwQIY6gw6jbE9f)v?4vd&dHKz1%o)`hKh9fdv8bH88CRvK`I
zr*@;;{hL{AxeK+82NA|^2j#tJGz4Z?IRP4TLm}->R_OD71Kyid%c}_~>~pyh>RtG$
z>VOWANq0bsCNh67CY>V$euC=|CejhvS?i$g{ky(-cR?kBFlgMd4kwj+^OwsxFvg#B
zCey4#>)1!Jvr951lnmJ==29#GIyC!0+HLMCK0|v4P%!msa@kT5v~LWCBYK~ZK2<e2
z1$5Uz)CsM5l2q+a)tZPtx&zm);b2q=lE5pN`2cBI3uYur2f{DaS*`=GAph-gdNYqY
zOsw@~O&_Zv2QzD=xl;XI33Kf3_W)w-`eU(7Ru^`!aVGGGt<QGnA+UH@$Io1krK!!Q
z648&$%T~e__QqassWHe2Tqt=g?P>LEdbZ`@3t>JpmXdElw5TgAdKYgcuj8@$G2aPX
zBM(w@LT=I3!=YH~$w+^|eyMjx5M}(9k$=rn1-=7!NdDG8LCteC96dkWIe(Ix!LW%(
zuZmM2MVXuDDE8Ztu}Yb-c#%mW<*#N)D(i;3q5W2CU-Yp<Z*z$_!ze-I+5*s2=l1YM
zM?W3CM?7>uJ+dcJtqy_WlvM}Eoc~6ZJfJW&&lOl})2ey6xvhQj=GnH#q`cYh*Fj^D
z*hR7idJZxs4u=T*_Ta!<8=JXZ5bakU$(%9I-xt&|om-(CnwV|O@)lshgEP=mbKKu)
z#Qk!oo+kupJSix*@;y>kjngCD^TU1~xrvOF4VLwT!6a8=KgpYog3q4yo(ztzwD|gs
zS5Lk-6*zAD=?h{?7`UT<y_4Fs+UHMVnDOOI9X)_cn|9lkL)rc^td}UTRbX>X_aoiN
zxN|I;o-vI!SijQ}&;G<};G1ScCdkF;P!l;MAjx?C+{g9F8P}@R?#N$^VL>3sDzE;K
z@&x8{6#npg6irD-O4v3w-f*>d-(lDk(^!-i0wJFIGHq7dR=^@{!!e}VfOyKLMBm0(
znn+*;!nl1jzu-X`a6i>f45^N!6qcrxb?bk9LMxjpzU{SaQ8q83(%iv@y+HT4&}s<s
zsHJ@At_spd&P^yv%l)1;mJCzrAf1O{j;ZXnsny<o+&zcIvWu;HW%tmxo0rD|mI*;2
zptw`GiSfzXkc~c|Y~GW|68Xo$y3R9w%3SJNlqNb{Wd|UDx)SB#!Z8@|#RY}Q7d}RQ
zXDc!R#ffd|m`gIhATY?UkcO8MO~5R@cXAQ`u$KH#%nS&kmszOc2>V?)2^>+69(#AM
z4CyGqN0WHY)jIaP(1hs)9G*&`6^Z;b;Ysx^DCR0l0Tk?BX<a|Oc@{xRqDi`%x|9Dp
zYLaa#xC*i`XbLuBg{aU3Mt3WHll<Qc=4nEUOB6-nym?hQ8L|0~*YVKRI~SL(P?pMu
z+;=*!OEcKh@(Y$y5AlFI*v-sL=|Y4b^R`&~8Xc$;m#<j{3Q;r5XLToO{5dnm!?C8%
zx>18)SQ2tu06gxG3?qeysf+`dR-|Xia?Yh{XeubAJ7O=@0z4~CAzs^X=v8WgvQuGu
z={WRz4P2vCLJf6sSO9TDiKMCzF!HER5i|G2iBkS&X>B^|c>~QU4$zen<_*Eo=fiBU
z8Qm@kQZV;2o(2*Mu#KwuRE&_;`B~D=<sI}RbSQskaX+7(eZ1Yn!gNI*RKnqKEWjA@
z-rw(<Rh-SYiW9A>iH&b0WQ!>%9&0ozZ;P(L`u>JxfS7xBTXllV=s`RwanHm~;@vxP
z7|}}VqeeBj=K!9T(!hiixxwYlu`S3uAlF{D7k&Y~CLekE`v~usUE#%_)Khv$6{}fw
zE-xMZ6skl>6`I0?6y}$q0NV6q9k<{C+h6gMZHXDOSHH<mA#WvvS36S<C%lwgp1;Ug
zM=MKa)3llZe_hD_pU>WW+$O|5X&V^dCUQi9D(Zo7-W`pM{4%?r+1yNCI$R!nLDP#K
z&>XvI2sC}4M!X#W-AiT{@sU;=fHy6QGAkf9dT{}fC>QwT!quw-RkxEP>zw7N&;h3$
zS$>aJp6qP#5ysJIkZ6h`IZO`wz@bMfmx}K&%`E<Nt$rT^x_<o<Kh93OGdXwO*tV}*
zQIDfA%W1sjQR4D_T>ONwuHX<KFZ}Kk!cQw}(_H)YJ<FIDohZ}zh`b||Si+jrUNL+5
z#y8nC7Z*U^Snv1yS=Vm$exvFbz%bHPmOy%P)=(bFwG-`7cZ@O4wFM11YsCklJ0J@M
zn0>NpQ3sA<K7I2rx?#NfkEv(VldzrZPo99B&=N2FO^bJ%O0OkXe!`Dx$*Q{yU<_eY
zd#>!y6TSGyi^SnaXBz{FsRoo@Qdq3D9_+wTn1V=bJ2yhuFx+8yZDbef1X3$dZ#gJY
zoB1bEOPBzgI|8CxID9B=TJ{_NePv^6!pEX$@WInFE>w_S0y5gs=c7k%;skzj=*~Pr
zL9*VP`9RB`eWk9RSge%ne8qn)*Tb4yVx~XwSKDWO*~1#`O<~F5QU86xwYax2o1dR4
zxS!bf;!n$e-Z*Zb=a&r{t@$~kQkBt5$6Y`3)99_`n|~Yk&(fY3IsKL%tW`Fu%Y%dG
z&zxE6{LlM!53ZemzT!#TynrVsM?KCBtN!-pzcn6zdhcC*Zhp+K!DFAhoL)lK>`0*p
zby)q*2;xS_YO>rV!Em^URDA(xl7Tl;Fl11|z%ytWSkm<N6n#)iB1*P*LsR3wr_o#J
zHo#vJqnZX5H<f_8)(tjc*yh=f>tXSvu|a~QvJ4!+s()Gdm3!?th6G5c<1-ih_5&50
zhPogJ!@y{S*{A9<EsothI%ED!U|E2+r<9CJL3DLY@Y4`iIo+*hZ)UYH*)_$(u8I0s
zYM~Qz`#dt)%~z{VrVZ5Hj+*7iJ9G0$SfN21CW{*0rJ%)>i1EC;KtLRglZW}j*u}>u
zRKfQiPA6Xtn+JHK(S1oi&yT&c_4%sH9V{=a(X1m2Po?*|mA2X~FS<drMN}KWO04u}
zQ7eCT%5DG_(d6X$#(M1YqdwYh{?CefMH1k;2$@;2xF6kf{!NWbVy!k0!Bl-|+V>*k
z*+9=Q9eVkw3Dn?y5`4=akX021v>KAkX?hxhoU&^LP7vW1fyGQEvf-ttQ0-k|7OohQ
zJb@OxB)&>4m=84c{wcXPVZ|l8rWY^jFlH)bC_CZn%e4Z$g2Qwf>BcWM-|;g(wQ#r;
zmyXB?1#26*&^THsk_hwsO_QF4?c99Xw%~m~w19YLUhw+LR4EDcSz%qgXPy9Dp<>DQ
zx`36>c|fKYCf@mYHn{L*@OH{wx%L2|2+@XUcm)kcV;Wsz6wuf<mZ@hs-l#GPVhgAB
z2oY?+1Nw|DVtNq(LQ<a&FB&ew^m$zZ9lbr=cqrwJ2$;@WJC`WDgh=BOS~DTD_S<#u
zAlV5dr3hF_mPq{+qDl+0A1X7#P?Nwi<m4X>@)zf=pev1)V{eEy6mozw`v5<XsdA8H
z4RPnsHl<8U0VtA5nY7h}vodXXB|<Utb~x8s+u@u768)1O--f<}z$vX5`MjPg+T|9M
z^JreeY0>BXU7Lkd{so7^cx>KD*Zg3VF$TVr<hHtin6a=cs<fZEH;vV)HdFYp*!@|S
zrY0vzfVC;1jvFIGiWgsJ@K}Al|F*L*`L=tP821|*MQ3?&aG*Ru0)pkXhJaB3$;b*W
zP@hL22I)oQu%-08AxtG&{d)E?qqZpnKAE9mM&idaS%K<u<HaJT(TqMGr-^xjpy;SW
z-~XZT={MHXuc={I_z_(N7&@q9pL`kWxD(m{Ju?1wJj2RVkC2QRmr!%d4(3^quZnaD
z)i4}%O{3}eM@P2`EE%*CK~9rE(*tdMb;E?~(#@|wVB11HiC^^OAZGxOMZq`BZ(W|X
zXt(MVkD<S{%>2niV`r3-0nr`=E~3vN+C>Cnno)|Q!Kxd4!`D)KAmbf?fQqfM69h9H
zB#T{W;lPhe!P1g$XmY*yhQjNpsXVC8DY;s*C(m5FapN&j%aJrym?eV??syrF|Lr}s
z8cv@KT>e)i5D>cMT$XDBjA+(aMz-dzo$kR$qM?^r3fO@RGOM8V0TAu8vxwCLx-&a?
z8VR7%avKjU_CTa!1qu>Lxj_iVV*j5(xut|bcnhjS#=W;QzmpesO*xn>+Ny@3`2j$`
z20j6c@)OyJj1~yJqPbIDb8rtN{It}rFm(~v5?F(}C5(=NN@l&Tu|=$E3)lm2kgl6+
zy2SI+kmKaRi*Ar=_WseLvdjdiXkW8$9#e0&;u&?55uXOqs&Tu;Cx0;Yb!&6nDp$7H
z0J6my^ci$==v6^;-~&QPAHsN5@}6b}N-bgrthNhYjkvtBAMtt6)JWCk6ecOC{r4CV
zyP|LHGbC8i(FFxtTybzJd)0JEQ3u-s4QDL5%~UgsMz-c;!Tj0ItJI<<4wU+x_!)Gm
zErD2132`ecH;bcxwI#^dIZh5V4$5c<OkW1DbK?Dm#r@hxfY0&#+{S7_2+!jX?#)w@
zIbvP%F<SU9_N4Ov{W&46gTg<Kh0M#%%kM12vA-QzlxhX_f7qP7U{g1-L_qYN(cr4p
z4n}pka5;Ug<y5gTFcYYd$XOiq(hN{zXVKGLNz+(LATk?~e?lC&uaR4|xQMJI^X{B8
znp4?xjn&UKW$bEsy}Z{|WJBy?)b3=q+!&iLVj7bU&Ze<Ud~SgzY6DN_zNBZuohT~+
z`{?Ecvh(<QcT+pwx+nBn4TUGsz|gd>YIs?}($@_mZ`Mp(DKF_~L}*h@(`DVI;E;G#
z${|{I`!#-tj?jjSMf?9LS_P$G5-6aKzvQ;@a}U6Hhr6d{pV(JaSxvO+xjrhAZfIM1
z{M&m!(ly23Im6Z;iASx!5W9s77v37+PI&;2JW}IR)Ml0sj{ZIGOe=okm9@t6jZM6Y
zq)I(;N&KO@Gz}~f^yfN+1X;z?=Vvm<Q88FRF{fzAG*f&GQPQ1Irg?)SX5K9!d1A<F
zT|)X~<pNgyDNbRHOwL~Q60l?d*s{O}5+L;x@$yuY34GUxfk9szQ_<;;lT$N?$bodI
z)!FmKOrBLmCJ;50<{2S40`!JYiH|vyHoF%)DHc3e#c(oh9unn4dyf<`J&1riq}~cw
z3VtshD@sR=2p3UXj9vkTQ0YmURcVrxEbYQu@l2FDTC_r-nk05fI8ayvOUs2*tbE(Y
zQ4k1D-95B*ay`5GmBCVI(nL{tCf75KERPM51?~rwlpcf>o{#Yy?tZn6omIa>hvDsJ
zWdC!tOQtOA%y5MZhp?zeoOslx9yX%Hb?t#Y3L4+q5Z@$wpe`p$1bwZ^?t;v8e(_M{
zu@PAOK^(g=3%`6gx1k&iiH)BX_0_&JfM+lyCL%W&I&|KS(){Ki&wFu|SsPRFfso?$
z1{P+7xLn}UOm>lEGBUOjK~rEbUC1mae$1j1prKZtJP}Ajh}-IBa5P&u&_KH?2UQwG
zdLSyVjN!=4VkGZW)T>yFa!EDHf)ZtDbx&y;I`T6YU^1BmU)f~{e(@dbDOI@&13MLk
z4-K?6L~U8FB(~34%BHSK^rH^F?p2?kS`tIUNzX$45z<<DB-?ypSL-dF)a&}1mU299
zRc91{op|@cM+!nD0+4wIg8E8jVcxzmV>eYmD;Gh^rF~ntTIl;3GrdRzbxJe6bPt<@
zymz>0TObaV7`a1>3Ze2auvisyD8Y6D$1T!2dCyCe=-Q^(-X5fLsYK8Ss`L|HrA>pD
zQZ`FlgVv;3Aio5r=OUtRdPR;WbrHy2aX_p?83Hss?z~?ebxuTerF?~sW)FI*Do4b`
z<m>#jRb5@3q~&CWN;pw#(x@42Q^t2uJNO40cg^{vF{-S{zfijd6XmRG*FLGMDa+@m
z`=qpkgwL(;l~m@HSUqHoO)Irk`b{z}PBSfTf~qDQQucXf*A&YgIdHQ;AP?VBbs?+@
zbb%m9SlB@kA&6Y-<Qp<LW?Z{4oaOA;Vl$co`RLH1IrT@Dg=udkP*V}eTcFctBk|>#
zIH3=Vqx1-xo@y>YBBGQXeq`nV;ImYnW1Rguk62kP0#zpW@H>|O!9y+}$Yw875aoiF
zZRlIH|G73;o^<S(=2dd!%Mr7)>KJ!R>rI3}0>;Sl+)=Os3DG86laLjH&3R<|`)u9*
zWtltCfVLUgwiAah1^*6xyPB1p7%HLJ1)9UAeCoaunn4R;>QeuogIq!BmP-9xnf0=A
zg#rZKN*SgA;VFQQD$5dPH?gdm7p{hdtOg6gF(QTXs8u-u4v%Aknuvfpu_bI1)d(O4
zK$}(;Q#~6PtHEv$Ei&?>Up1<cdQII|==`U>Dw@i8J-gA81>K8jh)n~FT6`g9B$<~s
ztio4QJqVB(HB1l<H)ZqkHA^SS65qmLO0gqvayFCtJs9PwX9IUilzPe+olWr023@_H
z_oIH;UzL;`xpWl5DjtDCnZP|Ll;@*-K!PJWS=6*$JM;e4(NT0^CzziNv_N`;$to~+
z>i5}g-uG2e-_BA@QrJ0y>yl3@_{iE*6Ed{pHJOB$qkNceK%?mlx^6t2_~G);)dX>f
z51W1RXQ5zwT%+LK9~3SX{~=?7c`8d}`uVz~ZXi6e4d!gVZ0uZ`1@3UUHAa=N&$k$t
zbZrAHhX;MkD|KoCd3-qjA|gR?%*mV9IMY?1W+%{{xPrT{tY5aweX}0o<wON7#ABmv
zidappKKJzi>BBX51@uv+mh~A}$O4Bo97)8xEJMlht`~VweCOe@Q@djS>q3{G$A6F_
zQ#5MeM73PF^<0#r?1u|R$b50gvTj}Vzf?A;`ADCSl|Hf)U=gI{$u`BTeifoco<jTw
zC%8?aIcOnuo){s@bE{51Qp>~RD-Yew$m{R+lrUNUMBbxzE^;m6)p_VvF!*#m^iM5d
zD+xfwaUT;LGEg^7IrHt@nBAmnWHo6-T@&CZ4<e`n2ge|;@hy_u+U>hff&wGWit%lF
z`fGG99WTg_qfO>+W6&A$znMW||6BI26Y`kut)ajPe2!OLuI@!VCAh?GY76HwjvL@%
zVcc^71%Lq+<BR_IBLZ<?$TZ(k;^*tL=M{XKVI(l@%i0_kb~<-73YwnCRUQRjw<;(w
z+DWSl$9huRR>$}qlALGndr1Zn(wq#!*Lylir9^`Ql?DBao=*B&M#(x=<A&tsCd1*8
zC`ladY_4id6@Q?SE((_j0+RO@eq?z*@|+^TjiYl8N#R7y%LG6Ou!N@^#_JUAk{*j_
z5q}4Bk#;8#)@v}ju0scX-U18XcK7DE#ka3owW`ogW)lx!Z@~GRVDp8^y0bVi=oUWD
zYBTTr8K<sKG`;XeDW%}13|5de)RNvvv|aS>IOU!|6O-0i#WN|`h8i<@0zucVap$zW
z>hXCXH-S^E`Y#nE0(nxEHZk94D;1U2A(lk!ZQs*-qoe)dpNcL_a4=_bp50mG=|w0H
z2mbWaLOIE7@Ajp7iXSopTw8di+X>kKmX*JOvQJ1M=Z(^+f4bVPgy!@A{@X`QBUTxA
z>RU@9MQRtdZ;dnIE8pY&(J3Cy|L{a~49Z{<Xy4N_Aq|M`3FUQtUv3C6VHDZyTP+hg
znK0F?I@7gzCt0oq9|A;IV_s?x`M;1=%Gv{<fhe}VFKD)D>0ngGY9;`c$k~I(zKP_c
zBtI_kxnM7`W^E807cW^70C<|Zg~q`sZ6xIuin<BrC7*rnDqyfhMUDqu2owkeG6>tk
z)PztT$ZIEgX)t)`fjACOQ+~3vkrWxw0y@hRpYTyJ=%>ZsNJW`d*7P<=Z57(D44JHt
z=yYD?DyIAuya-ZiEg$NTB=b7VE9c+a<XKAH3wAdV&X^d%xg=%I@WThSQ8;^)Bgq<o
zC~~5W1y}H{u~=4+E>t?4*~-OFrL&(xP~Apn;)W4erA4A?GbDCuFt^QDOv7xRcY&mR
zoG#pHGCadz(Deu)Bk3sQr3f&<q~MFjejoXgD^gP6jxQV@cdY}91^MpSvBRB=Rx}Xf
zkZWtI9;8HxqE<Q<;v+HKx9eVf9C>USDul~+;kL^wN7}d~inS;N8-9hXcL;QH{h?vl
z7pn?&qqyCPHs5l^R!(P@SBpSjq(yE<MS@HU0^~hv39!h|l>#n;XPrboAXVEs%F4ek
zQA^OadQ6xya4jRc$CO~tpS}n=LS>EYk+9ME=V&iEnaa!vAk{NKnMQg?W5Vx`eN$L9
z<QS(fu|jeFuwvtJroU3^u5n0|JwRLWMm$%Cmwb#&De_(Q|L{wEPw#65v#UfcvP)XR
z+)|*5G>8Plp@b=sfEKU|6l5HECI7XWk>v2v9MyW2LWThJ*t2DsJ>Tkn|DgY<R;39o
z`al*5txogW*O>Ikj|{;b+WeB=)nI#D43@{WPIAx^jJ(E4Q^E#O!<PKQok9v^{?ZRC
z+K)2IBdgcqo{==j@)?AlU;W@W0RFiMcSD++DqSUqQ1Q%wK$09&#qBU~bgN$X&wN>!
zTb9wAT?!J@fP|lnL~s(R+z#Y(!lreBjfTYpfpF6ZIFDtIIi`%!z+agVQj@Dw%6{#L
zbk`Z~jx4?5ErSz`>`%ttlF+0?3xbrgsES)zK5BEzLg4>(4W*-WIHEsB)*(hI0ggmh
zN*+mz$@P_JaEv-Be~INq*{wPNFICf1c^OyCS;{+g*x%;H(8ZIUSWSACz+2x4lSL~Y
zk1|GL>L{Xzb!RnY4~}zOzFv`G<P@dY@kiCb5yZyrijPH5QpF<-1?<$^rqCj>D1*ep
zg~~^sAIsO5C_Ntq#ZicTIAjE@U3;ZN2Pgrp)TZvZwusdP;PsG>b3br+%L8I%RLi#%
z!6;hX$>(@Ye5F^+i}=#F^Uq+G_yw#Yt5o)*(a?TES_5r;M!*QwQ~+Z%s>Mp}e(oF4
zTGFJL(Y7P+V!mrl;-bd|F$Lr(=sz=oHl+1rk8U7z|3z(BRV@u1YMPi6>{#%cy*&WL
z;YJS2&O88kA{hr+bU24wCd>>NgVI6>fD}AzI^DM*|C7!G&0M11<b%>1Q8{11R9>zs
zG=~5bj%VbsJ(F4Xm1h-+`4JSr1*$7Ho#Ty%PyYttmF697G#@F$Sp9>Rsxi+qc?{zW
z*tb4+1GOVlkn;-Le1ii8b&a5LH~S~9#J3Y06pUO1gA2p+ij+A7dr^~@87|>OCPu}k
z>GXOaeqM0;u$_4VI4^^sFH?(JO(4CKFhL+=h$8?B@RUaVf`0KwzG?>S&f<QD;=B!1
zwG$HaZc2GI517bdQ1!DeFRIZ>l|jW{xLZ{~b^C6TwG!Judlbc~9BnyA1(1E50)~OA
zcMd^#wL*$Gg#_QcW_5k%yn&x2f}w0Gkh+dnTfyUI^lr{0Hyfk$m^!7@0J=Ra=h(A<
zx3jTP7Amty8CY@BJcfdwj67AP6_@jn2r3RG$7v8qt}f?Z;^>UYK;sE*ocsWZm5$O5
zvB!k2H6iRRxZBTqmNk6xe&!V|^`I>z2oFl%I^z|Y>=mF^Vo0WbA$73Up8SWvr{r{|
z9RV$pqf%x|MtF*^c7(<$Z9`6hzohuEDHUIB0;C_p2pB%@WEUq!?xTAGU%qrqS-Sz!
zm{TB(Cj-zMX#>Uqp<1j8^Bb}IhNIxUR%Pt=OFV9O=u(I0eL5_D02lgTx%f1b%%AN#
zC~Ev#IdbB}W<I!m+g;<)6GI>)Pd_^))KXco76dfJGJC(W8=xiGI&Eeb1ORXaniH+M
zNd?P#(fTXQvn|2TU-+^k^Zf^eLhZH`dVCq!SVjx+@pd5Q|9Yx!_dTLQ5E6pU1Go<-
zyuP9hL-f_etmEJRkuQG;fRLYytSMsknD3K$g>f*IHdSJJtfOpI&Edhg?{e_~|C1{(
z;;r;IM}>}a<sFCMW;F=TT?anX^!5iBCISeN==a`fiunz`j)aOcs{P@Q<r;FdHBq_8
z3+$T!y71Rmum>sAtb$#6$=Wr2UaSZ7S|mnI<fx)7o5YB(m6q2j?fSQ=)?v1j7~1ft
z57J#R?1*eX9Tdrk5E+JiG2~k%iS13skVaUsWa#pP<!rijhI#{H(xHONZX|@Nk3=^j
zAKgXvA4-KtEc35EJF^z71;=t7UazE0J2CWoy8+GA_ubrKD6(C4K!7eUgzaL(=of&R
zV3vaN2O7x#@OD;?Wi6(v0RXPfX)|1dtR#JcH+2CNg5tVapu%{15oFd^85t;xNHiK7
zFP`v;AwQzaJkq9E#dLan%EDAf(=(-<>I68U!~{hpNyWyS9kV&^AvXR~tZn{5sOg}F
zckj%rZdx=Hw*bNT@C}-MU84Uk^)|`rAZTw%+1jO)Iip|Fma{iou66npnDrsV!w8h)
zvvHJ?{WOv?(OkT0bFIGK-!NJLl!7zzf>-JM1W2Wt%(da7$<m&@V06vWc783eqf!%C
z=rWr|30-;K(B&=+QDI}R0!-oSJ~97Y4V+_LfJ{_l5Q!34iy+X7{kizj$VAut9v>W_
z0u>EO#&m#%y&t821<&rg-)A*Z$1>zw)1Z~SI1QNtb$6>-I%tr`t(blKmSpv_P4RXX
z@y8Kq7;<}<I6!3eMc$BgG+Ziec^QY9Z?dR#EW#y7e6;25YJEeiLOoXiZ#5x|TcQw9
znN_$jqX^Ou0iwj)Q38W7n&d&{zoM;5EZR3}vMS$(Lof}NnQX7bB;rMqx^SS^1|@Q)
z&t&fEnMTSxLe|~p;L8I$t%(ULW?=KF*H6Pmy){np9sH<#35*_u(6{)NaFyhC$Rlf|
zW43f<GEjsJM#%>sMay>^yG8M#(eT4#h_|}1vvw9%b;SuILDhnhx{DUpE=qX}VVllq
z@`03a{Y3+B7(_P%Ia=-wkI3_E3RNXm3jz9e0;QoBnWgagCrXH(eu$dO2Jrh$R@vM}
z*K6d_45_F`Xzjr4r`e3%kawF7Nf?GIEjN3=vQJ*GpRhg$Rw^0*8K!YgFLHu!F55~;
zR9HY17Mw|_`cc=lJo}FhswT_lTlGIR3~&+!xUhU3b!<G*DrMR$YeXPF8QifUjFyyX
zP!P$Q2&VLaRx2Iu|EHwnGBjpa{KDfYJq$XiDsDt1=8VDE=}UY`cBxCxo1s_PX~|qj
z>O6%2c9zg%rT<~Z{S2bzg4ufmYCEN#K`SFzEMk+%+8Df@7!?#R@)dP-(?A83pmhgY
zRx_pNYZB}h?^laEetPW~h#@LX^9{JW7=^Z0uay73ogXH)^TspawkONLs<ha30-H$#
zH2{sbZq;8J8p3#=vAQ0shrE$Ry}77?kt22!n=@(r4<uRE5D3T-7}8%a{LR*oVmNb&
zWUaNLmiYSQ-LGK?J}OoOl(gFi1+xN-i1iosi~IjG<y8Cr|H*q){uNo=8cr!y<!tjO
z%&SyEY9RJVH21h3-$OhOhXZ45xANL<q^?pi@)tpN>OE2pHZOb_M43T*Y3KE!H2{l1
zrjhbupu_E|2QC%_vo-X<jRmyCmtPLP=%F&oc(Dr^<=cr)#U(g$oKJT138&3C)cHC?
z=(g6wpuo4r4U{IUJ1Qwz?#Y)x@CMu4plN8A1^xLR-~t6v2VU4&Drb{b=R*0PI+Nr^
z20unkW9>71QO6bTGoII8Q^Bl--jo27+IG%|Rr7r<`DE0*gPv%894VBq_sdrajTP}J
zyISzXON0OjD`z1YG#6~AD-|0MA9S-?E!!#gP7PhY@(^3V0N;ZuUBe@U2KfX94~tH`
zSNZ42QE>P%@9S(;i$8fCJ^ZMvM#gA2+fCt;tVY5LRFNakBuV(Ghn%ngY17$QTTLlm
z9q3w;rt{oPzO~2W#3E->QY+&@S^+y)X7Q|l@5Qe)S&Y54;cKg!Fo>66*Fsd#lpyd|
z)z66?KU&ZDLP2L_iU^U)?9gB_L1rboKEjG>HV8T}NPN8o7~4CbYq)Dr7*1CPW_+dI
zC191*-r#Qah`dsRfC8Q=|4N^3eMampmP5FRXO1gZpskQ|)vb1i)Y;}eiu821S&rr$
z&;k_6%77hk_D{C=={4ZvY?DPbb&Cic_!^Gp)x8={HCe}={JY68CAmRuSd9;UBZ-w3
znlp&<2*ZM0Www+?>Zy{wwK7h6Q>;LDmcsgrb{!AEa-hnfd)C(8p=Zw}8jK1fzH+1H
zPe?Ari$y;j#dvRWPdR-6S|sL78+5tcr{}M8Js;IK`3Diq1bFbMfHLfkaUon#{5MU$
zE>T?>GHvL`>c3ORfs){Lx<}Q!7$VF;GGEXkx%<LBS;qx6fXEU(;rh1h+i|`8)GdNr
zc-eF9EUKi-+`r-;ZzGdrI~9~#Q)!{eJ;-WH_ha=VkDQx<$2QxpXj8(JOhqG}0{jPZ
zc3<z@M+F6f>bNw^lH20%hy=-%hk*`BAcK+8ZnA;_;yHn<JAwTrFXo#~o+@qc%?TJK
zLqD$tQ^Xl!`LF%>mc~>Vxf~$tq|Ma}xS&VxZ!GYPi`+@pTk<bcy2w4w)IHqtB)zf<
z!lYSdUl8aF4;P+;6BvQ${<2KuTa%F`wD7oUO>gs*kp!3?44ysPrdZObbj~wLgDA+?
zd~8Znhn&&g7-LKBBfiZH@27P6526X?2yWOfaux(*L@<&d3FVmdei*|&zyj;qiyJ{R
zpMj3shGw5yAK;PwfS8pkswgLj1SFIXDZ<SW$=F}k;4hRwVzmKVB;hGEwIB^qmO2b-
zv6K8}zpFCia4SF}I+1b{(+m+7a+9~ypTF6h=bW=8-@CC!r=L4_E^b~29|Lwnkff5H
zXOKc>I(gQX=P6}O?`x4eaD?~l+gHiLd$CUV>P6lZQ%Vpm6_qnmL1C5vGRnx+u255+
zJin=VHNCa|;fEjI{t;lcK{XqYnmkc#DIgkdiJO%ZqBa?sz6Tpf;WU@n_Gn%{X951p
zS4r-Ki7F*h#zD37{KE!K=i%`Se<5M(NjfW`c^!MbKbp0#p>vL>Z6|3T8fVc#81&XW
zG4<AY;*pvryj8kB(^V7ea*GrznMpdf+EROpHUUN9DpYME_sX$J9ryo-tTzFxdH>$O
zw;`O&B$-3VEJWrEMJG{8C_{uqAwz^z#tKQu973i-q7*7aWu}xOgeXm>3YF^rS{vv0
zeXeI;=Umr0)ZU-{9@cQLd)<o~krn{c^zYxluUK;^ecDx~zkuz16i`{*uCU#hLidbS
zUYz<vtLH;M=I8};Hb)AA&vAg&vMlxd=+YnBDI~`-&sF*b2sUJ58^Of8X{)Pf#uVj0
z7uDt@B6sE81ybFiMQ+-xhcbaUh!?83$(o2TI$lURU4c`c$WZ~;5FWYEG;#!hpoo<V
zYbrH(O4!1(ND2XG$u?wo51ovZ;7_vy7QDURaX}AZ(g|w;PZ&a`fSmmYw@+(JGDIIv
z+QV1n71L?{dqx02geWq@NFx95U?g-uu?pmC5~PUk2p^D)th;FG5M8)LWsQ@sN`(4v
z=?~97#0rAZa<4^6(`dq<0=@`*37RO9MN(Lkp_|xCEhFp&GhlzTnvw0CD*8lJBO+7t
zUthPD!8fo$KbHo)KQRDKjD&R9G--Xrj(muIb||{Fkw}9SNgPUQ#kxHs^Aya9u~JvR
zSJht|diin+ahWbK7A5OH_&MlZ9OrvIvNUq8*$?R`m+=L{5rZLMPRWk{9otDPy~5WH
zdwsPa;Vi<c7<!}9A3A#lNz;-JA}ND``_rzH`Z8}2>jYOydW2*0@`yghNfVNmU_4Qr
zgzlrC?&)qVu$3vURm%tscftO(KKPgyE_rz9m&=a_II*m?!QfzI4r$Zc{LtJ5MaEBv
zS4I<{4RBI+pZxKD;X{%1$8Lk0FRdBH35;AI1x*0~uz^wsXbx=;+^7>R<I`B?bJrEV
zhspBiI68(9ga3|V30f{<8Y|zjuTsJw?1JXyDglf%olzy099G`(cQ!`z(X(eRWp<ii
zOxz?HXIKh6)}j3Kl}p48eicKO1e>3H)ZGnSxV@3kIuYQQj@+xDe$pIGhPlWkpt5z_
ziUAgk444;iE;2nY<5M1V;(XUuUtJ<nBM%MQ*0nNs$X(+?u87Q)kdaMNp`1TIcUpS=
zRs*$+#CyP-0JiC9k8KfhcVFIJx!*#imljb0#G&R8QY$X3B-F1g93qUKFOvjm^?yS|
zqEzz5@{9Q;x_e5FErXIJdUTOpNB;uCoG_GdLy;@|0k4kXvs~{lr?xba+L3gKzW(-A
zsu)QzHNC`GVwpuBhKo`8VS$LuOY{Z6aPZ`UPv1-HC#_#~sLW-2g*DMs5ztv4Hc3V#
zGfprFj?TTfxDVl}@@q*k+kJj~{~rBeDX2gD{A);mMeO?Ca5Wwt93YZys~{Q)zsx3)
z?kw;<=q)_)M!1V=3qU%PVED+aNbaF@G)jVB@pZe~-f>DWFV>SY+8Gj*wDgFM0^PnM
zhK7N8T;Aaxw?g)dFiprRKZZTt0Y#H?&PT|S6G()X46DdkaW#?*p}U(Xv(u1qlmnEV
zvww7Jm-pf4E02I=-GBD1-}v(sO;-4&a$e6(jSPg2nagRJgvA#10|cnp_OZ14T`90d
zjjksv&jlXGX?xgeE6o9xxTWTLi){jCv{AIa#CwmzqRYGu3D_&vVZX@%#!4!4#P_YI
zi`pRYa!&D1*zqE62Pa7yP^l20EUcrflW^~saiWYWTQ{pX305a#2qN7MQ{fjEqEwS0
zBSU%W5^a4lRY5=`ZoIVDNRqN*O$fY$F@9LG6I7!}{UlSNH6ukd2G9&Ok|rO4I?Aqq
zJ2BhYgvj!7`Q+*6A`cNzkMW}<>0cJg?+W<G>PEIPHZhrKW%Z)_cFy>j<8IprMmRkG
zHmrS0Ow{+s$NbPNb{qfs?hIWf+0NqxMh;=kcEJT&c&i{ffT+kGp-(|0ge@iujAn%y
zwnb?$q8xiF)OOJoH;-n8QiS6qbhk;ovR+*Lr<$CV76kp$&daP$nA<Y)PGEOnb3C0t
zI!%B4%(pl~o~56AA<6KsFeLp%E{t%+LZrZ@JRxIl`~Xk#UnZczFFJmyBKu|+;9|&8
zOCiO<a4k<rUFzhN2*oW}Dzq3(2GRQoYC!ZO15o(WQ(7|pO}G`JKTLbEAOoEDh`}qS
zpDS6!o;~A@I~z40<QxpNAPz=|c^p6a6Nx_1dlhv>cq+mzr83aLNLXQVUtuBT;tL{P
zel3hC|8ZF+lHmQdWd4)zA_HFUq!FuPP9Z&M!bKG*OPCg%AfY7FJ0W1%ieIaQu0%P?
z9?(7a>B;RxNa!ADVk~%+jPRxkRd2kMj0HooO_IJX@vX>k6pM$E2HqcFxp6Fqrh^ge
zTr!EBd<#*w61Katjk<2@!IKGs`cIW|wZh-y^WoZu$tO-rX@pWcTJg7H%GU@DkV7f;
zM83l7@B3N8k604X%7oeUt>~H<DWa04=f`uvz#O%Va34<z;5ny(Soiy{Uk_cOS9<c=
z)SWX#Mt1k^6Bxx|PZmf3xf?qziL(Hd9Bm8IT#}g{<G1fVPO6dv9PPVhi*bNeVW8B2
z(XXZXxAmRE8!ZWw(L)~mBjz9d;ibfRDc4u85E&`L4@~hJkIr2xU8jZ4+9;^Uht%!6
zCk6XXUt`uKYS`tqy+n0`$t=L(O7EoKcGiM{iaR|eheRHNuPJ?b62TH3c3hz<k-g$g
z41E8QU|(1AbUC^fpckKWTq+AcE;Wj1H9|0Fn7fgAh3`M?ulexNqaKe(rmc?b*Yoq;
zL+D9-Xg#qKQchNhliL}l7SQ*-<ni`u?!TU$Fm8%1kp@}5t#Iny4c<XNqZZz#rOx(t
zpg^NR#ANIp8!ZR~s%jsJXGLsVSs_!nZ@faQ3s&!2#Q7=;wY7AX$Z>>2a~y`YP`qQ?
zkyL398kD|FHd?h=jX>>2pmE1R-@vFRky7mD0uotpPkM0LK9uy3Oq?LiP3RkNiDh05
zc!1Qp$pT&#>MGm=KQLx!A{-db?qI=~CTmIYp01J`4GXoC1>NI*2tb8Plz31E*bv<P
zaSV!xnbaWM-4zI>{0dnB0oEAAO)fhcSweafa)EF)yLpF%giyx$YklhlYVU&HdR9bG
z@RqXkA~_&vJ;iw?nO7eDNCRnwrnR<%bm$A@b3u<lM%hro1#uri_My6)VkUiEB1<PN
z0z$V$17I3yn@l+wn=Ns&ygr$8rva6EQg+|nepwaR4IJ|%T*#lNg7mya1oNalieU^y
zW73u>SQqp`5vAp$|HL)CU44BhW+JW18%VV>HgH$BDSpaq=o1vo$-y!`N5XGz7?s>J
zU?}q_mq)H>cv*TL1kjh)N_TP&EueF-_up?rR!#<7Zo|_o<(qRJjmRM`h^zvv7-94a
zbp+DT%z=Ue$;)>;sdN#(G7lt1@E`X$ZHC<emo5Cy&rjY;#GfaU+|=U(=|R<(kPWC*
z`frrfslwlH2Akjr2852DP((jSI-nQ+p9|1fK`mAIku(cKtF?qqBMbxbC-h|J2mRlB
zbR$oc<dXpPw^1WQ<O6=J_t4%dYPymq3U3L<qO`PO*|7;qX6)~1ik}@RoKKlPMZcTy
zZQTvtc*<YCgx{gP7#fX0C|D_x*^*@vL>M-LviAFT*Xwkha`8B7U7~{b2hUQ(OL6kg
z+w|gXWUeA1?<MB~D?y5hhbHi~q?q&H3fm0lJ$B*mFlA|i-u=&e+*v{5Ay5?2!ATCI
z3?~p`P>nhoi~=0=CpzQ<Ya;@o3789ijj0mpf`S_g=Z}stT|q3}N5sPr@;)aeO7!Om
z0Px&l!ls}cPo+9u`uTVn+$0iEHmx+%j#nb`RrDM7mzvZ6r`M3O01kK=4WY`?hW2a?
z&vzcia3pKCS>rpX&a?|QRc;9pg${z@oaG#_y>GkuKw<wWVOoW0Fx}mjFy{LGe!NZX
zv%bc{%n{}&mr3N6WO_k4;((O(Y=4`w*lIGLq<q--PlJYf&#$cfIp~nDX}hBxc8zHg
zI4Mf=hT>?`;hM|Z1*&zOZt8n>>P>^sO&YkVsyEo>xv^2hhQ8xQ+1F4p*xzWB)yG4=
zBm4@>ZY}zz>36a1oQuy>3%`D8`}|O!!hq)k?mo)5d#n@xKHW{&wy5+;kqf{O->p3(
zb%sUd&f~PdTL;{FU0J(+{fO|93hnP=`6S!n8d{F##`b0|)mEjsn|e%N&BYlYrs(Dq
zq3Cf<PV`c;nG}OUMXGy#@)%(h3KNVn3Dtfp%LIDGrh$1C#a65T5!H}O134D{U%!8!
ztDI->zPU=^6<d0{pGhr`yJ1h+OK8DTgCWK;)exkM_PG_H#iHCR+)E7BC1@gYDM<P*
zh+bcW3*|L|cSHy|mq={#O(xSflmNkZftqJK3Wir@Mu!a06}1N1LMrD$%#bwv;GqF0
z<U<tN_XN2FoXdsm2LOFi64&`$9d6Ji`IIR#UyZ!BF9LRFj|l_@nDFYFi#bE=WUUnL
zt&Z-m-;W$$7`>t~B?(hyX==<e#FkN3nofzqGC`RxD4vfY!X>y6v|9#aP`KGH^C>Cq
zpFLJZ;oF`r^C5)~`jmdTRe$;0n<{5BsR4W>pzPpfpC#X`E8lChwB&M9j}TVK94gW3
z7E1##L@Vgi+?C2Nrdd;T#5uhIuHUB!JrZ&DNs}jQ^zl$A^6wEx3N?gGdI~})?j!bC
zYToNBChAVzp(^_RTXmGOmRKQ}omMjM1cP;2&=1Okmw(G6EAHIDz>ACp$ehedgtD6|
zjlf`wQ_$yhpV}2mE91S$w07n!ucD~8S-CljJ83sC2oiRV{32W$=}93r>T4Tc2hy0;
zZ*5OSnhil0MW=w*3}=@$C5aK%bxJ5txl@L~QqOpbMnbR;im^w<p=#w|Xw*B&rVKf%
zuhy(3#U2c{Fs8Y>MRb-arB11&2Ky+3LWRR(ruWDhBZoFccSdr_1?2o=JJnZcs}sir
zg263-#?U){GCEc6BhV;qW|TxO-(AV3UwyMvHD9emOgt3M7_`)rf@9&}q<dNPuVq{1
z)j~vlgq1D*uqX^l%MSBmb5UP;e^#ck$ZpXilY;%#?u+{s)QG5O)^fRQX$@6JwR%Y~
zE3@=oac!&+HW79zak5-o%hA8jS3jwch_nRAl%PMNkwOEa!*W`>RY!5nil2<EFPXla
z+#^ruEj&%v(Vv^{ba|j6cn2{pw1(V_%8CdAYS~`NJ>(4k`HaX56n-Umq|HYPf#gfJ
z%ZX%EU&7szk-JhD;87!x099-ZqyYWr{byD;t4Xz}qtax+2$qP6h=S%7|98KwZT=l%
zW2t>Zb}$hnfuhF0PTGptnakKBkgo00${@GUbRLMKu`;GuvazaJ%_VH3v@+9(jd^$i
z0Iw^j>F3YMe@@f;o7@)Zd*l-+A564Dp^c<(j&fzTQLdD0BB=v*Dg3`DAFD$k;Xd`K
zesUGY+joYX$CFJ&`-DMne^kPr<jzxWux8Ug%Z1zdh(t{?d3Q45?^)X_3L7s;@g%0=
z?uRIktIcmysIC$iH<?&UXcuA$fqP(Xq{{EYI{0&V+^5R63UVk+OyX4m(*arR<l(!S
zBYYuJR}_E)NYX;ktJL?f{lB+ICM#VCa-!@jwu}%7-I|_&2LHXiWVF)mEm5Y(STUAk
zp=_!52BB4AN0lN8auQWrwx=&pp&6mwp!?iMOdb{p6r~toJy9VLBl&81>a_pP%IvKo
ze;gu>iv+%CN<SM`@wL9JiRo;MQ>Me=K_o*S*tLKE{N<2DRV|3Pg`s=amPL*AG1ash
zd)%Z`8}^OhU6fl$HD#FW-~0P1mi<hoWnM_B(qJI$3lbbF)GyuJ+0n!&@kVq>Rtx2+
zIU>D+WFk{q$$fF&P?h3@$S*N~qX_QmJRkrOouS1f*hiTaDLy?B^(Vw_=V5JRouq0*
zN;5_I0YVo5bWNtU%U-!Wy9jnD2gaUy&ih|zrV{9!4^=`CL}^mTSjh~dRj@i?b$9-|
z{(}Ty+T41TB=VFWuF5#2v+Y@;_abIX&MuUDrD5oW;h99GtH+FJhu?<bAJtI>rW_!l
zv2m=8g$qP(-2@W@hv~mhU?1>KDOCI=E5<hqOe>c3LT&M`V5>!_8Cr`ksA^9A$Y|Dn
zi6_&xRy7+G284s;jX<HR-g$Kr;gsTn^i(ljyfo|oVPyz+OwOPnmO!P-b3aM?QDpEJ
z34WMF0V?eZj5nys5sI}`^L*h&P$)eMWGGVE0Y8`KRHWdo|6bc0Kry0iAqX%STnf2i
z2&z5q)4;Qih#)#LWC`N@)oM}VU}JJ%%>DMuhmPnc*INT%EIoii<ObH2o^gra<*W13
zZ%s?6%z_p<MXc{%TbA!nIx4al5^qpB3Kfe`@`%<f9_M!y!_p+S%SWb7FjV@LD4cZ{
zaskla9!z&i;-3$Yt{8G@bM}aa-Q_%vwJ4xm?T<{FbRkd~R~lpepQWX}l~VH#h92`8
zLhU#W?ITx+1aLWo|AyI;Qzx(Y>j61~+}akw7TgIdAY}($LmeL{x<kTWr3j_8VkPIO
z@+s}F;((c^)$M~&&B)m-qy?E(6+i*;ABouHRq`J9H;HnCL~iqlW4l;~2P@y(QYueU
zHsOBC<7#H$y#kc(+@_D}s4c!A;b$o&$W#p>1dAnI@oM>=zw11dLBTQ<ScU}&RtZJP
za&%RCDk3Qc6%*}<kNy3|gaH4u4vQI`OGV0@?Ba@)MnC~YWA*RhYa{1kTGX;cN!?)I
zPf$84d1FDbM7xw9u##iFCQj{le4{$5yE==z`t$Wke}HDG=+ox&-{KzQcL+SDi?w9!
zsniE^<n%+IQK|U@W!?GmQ`#RvSgd!c!VoMhE}rA9yfF__auq%_?3+u)Ox%Q^+Jdue
zJgQt{wUN@=#4#k;>?Ff-mpEsYMOm)ozqtPA>THKDp`5Wu`6a2%QZy6c(lK7*!%d%B
zYWoS3axqv@1z(97-iB9vA-rZz<i8u6)xXnU%4fpq{X??AdBUkIo@A87m4M7`?=%9@
zlkL9)<Q8h4R+`vT8Okf15;jGc*0L$`QnA76)3gyLT6D~!h>Tj&HNJ~@U_900^i1ya
z{V#=p?#52q-q%-uiX07A`_*xK8(K#pkc_V^;S?OxQ*#a>IuSiVsxyIz6L3LK3|oQZ
zC=u|ho6ATwn{jPL4pOMglr_bDVYz+Uc2!M;eI=${9G4g#iT}MvD#I!5APIQI(|Xiw
zEn~aE{pT*%+T3sPo7g%VhwpP@*<f>8jqy_CJ!xb5QdE5f=$Af4kWcA}rJ0VdIHMU^
zxMcN?)fI0ZaiXXDX&6Yn)$geOC0_^dS&GXsBD{*1Q4SR={heoepT>y@9aBcd!1L`Q
z-n9LIYlNR-%bu&pfozG=#m2p=7YxZBk|9_O7-Z+VnviP>*+tje7W%JG)J-yl5}>3=
ztu0@*De#H48A;cLN%ks%GT&7>qA|aUN}x(Nh#7y!<$!!i79*SU_jXkgc{t(&En87$
zWE#<;v+dtjZrHey@d_QDX44xaQ$4^7PWYNvc~+}-?fVyPUZ9;QdRygHoKHgb6so?=
z;-rw@Z4cn`%w#~YSG0WWzFjMj6}eEC$B@rudS;|Jo9mSoWx`0Aw&ImCh~j5V^?3)O
zoJc&(+z2z0wqTzP)<vk1#qS+^cqu}XlP6DZ+o@{s&Q~9g6xB=%6P7Ohl6RapOr^O9
zJ(Zvah#UC20WrwT1XW4qY#OVMs;w_RPDW?bh$*yK2{vdv6EDNdy=p(23B?xB25Lq$
z6zsD;rZZJN40BjZ1Bwu@Hy*5YVH`SODOjM=YTm67F_y28%Wd?}j<|gajIJyzFYkUv
zZ{9DB$Y2fDV}Jyr)K#ARm5(8|{%b5%@~IFc641&ZncSnBTVEVl?_#gncYM<g8!mTp
zG9#CMdUAgCmIlt{M_FL?6IH)GV$DU{McS-Tih2Eg4gHlwQ45Ciq2ERmL{WU}{5$rk
zXR5h>dvy7Cr9`vLu0?t8<d-jB9Ab_tdAthm&Cs)@=!%S6prl!6Gc{Wf8byUnzN2xB
zVPunc)w)oxyh_|Y+>yYg)G#xg0~nxfYEeybVF69e16{ryPtoD~+SJr;@USM$8A2Pz
z{!2SV0d-@zofihG%L*&Bt4nV#enX1&WP-19_3jLZIUwcQI&mWqf?D<S?dI-dRVE(;
zs}k}Jy)Q{^jtx7a=d@x)DvmORwW^aHsU@50{1DWTlDcIAZ|&adh<@Mgl7~a?$pfqt
zZN5t+_R9GEx5rbfYP(emY}_lQns`{B2&?=XFp-qSBDydqibz&LfumEG*yhrC&B`8+
zDIH0HAg8{zr3k=+a0(f(nfIv2hX&cr?81_7`t8BG4!wM5z0jM%;AKLmC`?hOQ95d#
zPc0CNvOT+_Op1w)&Su6M3eQw{Oy#<L9`G35##Ntu68kOn{!woFUni0$IwrT%A{qb9
z1;CilxsqcL$TIHIiGMd+Y#)%<e@FbYK94MllE5G$C<W_dC(KkE3G#WFdWts_wus2?
z5$bhiznh}?aTEw_j2{?*IFv1ot33Pq<;$HXZK!(Bb82_QhOnXw-8c*<La%Bk#7xma
zlWVhhG(~KYPQ#1|2mpH4QYA2QnVfnG#UP7GGSm{LbMFsI#+agBM}|9WAM$;#FuNt-
zwoJIuN`p8|>olWZ0P!RA>e_@{s(8Z46t0-A6rEmQ8{nG!89dbLU@aOBGe3XsX+#tA
zWu<NN9;iBM=}bJ0kjMo60j66(|H5A{q`nfHEyHr9hZC}}d|oXk&jSoRt(~bDjS`Wy
zv_%0>To|Zo`bIQ_;j38^C8v_a2IEU&TYZIAuN5TSLHa&ZL+aV|lw6A%kSNdyEF^;w
zB-!C*<ADj8PXH^p41-KAJM7^?ok0=Ve9T>6Yg}0hoKI24ID1U9F~u%GqHey+pY~rg
z+U?4;;Q{MQ1VJ0fu=Et2{6`|h$K{wX*?dEh#LKl5HvI|F&?<<_&{6omv%3BDOF*j&
z<JCN~G+9`(^QRC{WKx(A_?I|2h5osE7xXFqi#!oPRt_ZHhfXDgVxsrI(YMZu`EPG-
zv>dIkP95LECeEek;e*6By}R65+H06N7LiyE_Nnr|8T~E#pDfNz-Pbv*%4F{a4HIsy
zc8(otrn!F`os4G?9Fit0p#oCBljK8QwdFxX@0V))l9YvXGdr8juCCUE?7ru&f+ziV
z?7lg$W}z`vQZg9(<#pcpbenQ<L!hhTN;SH_2s>k!Ox>ba<8@fI@7t;-c5{G+#d=EW
zA!nKJ*6OzypknezqN%4eVjtzEiNuX%g7OLUdU1vf1@_nXIT%vUR89KDsSU}*L}{`%
z{Zk`a-zWZ~=%)z)LwNKeS5Nu;HM1E*p>$t&8ma_F^orLegO}Q<p-;=x5-rld^4FZJ
zAE4n_LRSg-DYE^20==NU93A)WduLTtf&tj0<3ysqTSTerwi=k6J4X3QM`~Sx<SYf;
z?10tda6mW%<zImQKBWq}>)^p|lO_%QE~hYS<w@<%bdLi$Jpp(Wa2+E0i@)#WS*w11
znWD&k&Q|7l3WZj=ZrmCiASSXs3nHi>wAm#;J7>8uGfzTNqE)DP>Dr=+$SX(cw;a_x
zDPmE0lAFNGUF$^CjlCZZ=07iHK2Zr2StDpcf<~4TgUiGQiS~KvH|#z4frcn~QY}(u
zZv0^m^?VVEK(s=#X~mIROVc`MwQtw1FS;3$R}vH<k$<bT62DdWddW0R;($c3un+Iv
z&5{hCSCWvy&RzX9ONmj;zTb9q188YyL|RycOen^jRQA{^6tjInqoj>iIAGv6c7NVs
zA!cN}68yRN!F2Zy{MM?heReWiR9w0Q-v50Kr2v>5E=sb3yztTw5-BonkhKy8FxY!b
z&9fs@f8pU;QBW0EiAkOO=V+=8CrT7#fr4)kfo{T|vo*U54LUKuzHL!DP}2<qZmSiF
zhomuEl5aQ@e_~aAe+<eo){F!>Q8HCtvriL9h^P7U%T3A}j%wVfkz_|uj3(0dG4uWJ
z5|;0YD_8W&f5cSEAjH$80#?9~yxhA{Srj>L<|_Izem=#CKQyi0Bv1K9(hfH*X6-bv
z1GUY{FYWFiy_+;Uh^UcZ3B2xDlH%>&zyAy+@5#SCfJJEc2IbH}`3fD3M7ZcvblF0j
ziu|~HU^n7sspAW7k3+Zq^C%8H%9zr;FnI*cK5-ZIi&$`TKnBq!BI<y{`1rrmT?T7i
z+ExLUU;J5(_owKUk#Pk0T;(3Qw>y*8#Pbu$DbTPPj#pqyIt_09_b$e0$`B+7R(OAO
z{p<Al2vLP3ak8H@j0kE?R)4wgB(udN8-gA~NU&rOi`=%e?LQbfr5}Fh6Ky}FbZo`q
zqNOG9uY^Cw`UU|>$OZGYBcnf|ujW4OLaEhzdYxC%KL2#|j2ep3X2GhX&=C?JEH{Kj
z7T-7Ux0Ae34ZV$lZWY(4sVrEoCW3%OfABN?wS*`u*MVHQ`?$Fwpv0%Rw^ELvc}JS-
zsdNfgpx^oSIy#|>##!Sm%XUJ+JD=Y9-!g~KEkhTnpC~+ep>%8e#kZH1Sc;G|aF=K!
zH?vh;W^Hg9`Frp4?(PaqmQB;(X!Q~hZzU0ruNOIg&*9H`k%kJJjkC-(qbP-omnQ=_
zLXz5<n#NzFKS(Z}Nb$j5q5c;!&<A^bLUc|<TvtnU#l*hp?JgGKCV>pG^>{1k4ZJk>
zVRI?akzDl)$%JGP?(%${e@eysA58<cBn?d;G&=u)LC&wv!9z1^wfs6YdLryVf{CLe
zo?Dvbj#Rk6>#C{gPE3}ja`wD|5OMf^Sy9v0MxW1aUd6qMw}Hn;vf49*3NkfMe4Dfp
z|M%pfcxG8-Txr<Ae?_V;*vBRk$iVJOwy2RylN+H(_~~-qWq#qsjcvoqU65QZT;9UK
z@$i;o?_T!b@}k6C!!>?KlkBAf`fLo1F$hsEDv4bmz?rKP(^A_-zMB5$fhH19_)Zeu
zqV#8SrR{-7{$9ALE;Q{*R}>0nw{o@pj&ra?)(n|%=_b{pI%h;o<98gk#XQn3L8(AE
z4%nv)NrhZoeo9!0FSE${W#*_11&~Nd6pSlgQlJ)YyUcfziz?N4Qa~Bdh_Gq6%f8^-
zXn>L7SC%|>lNka6!wEJHCrMaxLaqdwP2qmZG&6GTf0f4{a*m|OI9Sodff(QCRXjh_
zXWDmaMlyQ^(wTe~HS)Z}mA_81$QOrn9583xPUmjY>q}b|NlCl=<;{B8xGM`XGLByS
z5q4S5RF3)iIeSw5U7g7aC?IK-FCT|M!3@7kXbs9}GCygolY(?mYM-mYQwm~+EIl5b
z<H?>(cIuIx+=EaFPR%ojN+M20*WhV*WjT-SepqD{UDY1MlFEQ8q2qEB=upwVRkFjp
zN9V%AerJbT_$Fwd?dDfR^+<p>fdrOOwWl_7ifuva$X$rcv@3`-67`K$`Jo9k!t9)R
z-Q{^d#gR97%4zgmn-Zx{omNnh>86O=+a$G}6yyM%1)vaVgQtmu!lD8mesXnnPL197
zc4%FNaWf>=pR~=)&bDj4=F9M<)Hc!s>esES3#UU}OX-_q*Xn&ME(C8_q_q!NuIZgp
zkm3be`?z#3F8yLxgzL0Ts}C7sQNpd8H^=JhyO$tPIEPk~g+%iF)ygk#isn@ODjW}F
z)U^-Za4Dt%w=#>kcqXNRuvb~ASuP-anS&hMB6igd&7%iEj0?Bw%q7Z=Pft%LM0~ym
zPDvKAP#<7AL%$rlxF6o1-2rhe3xqSq^hUt{a*lLwA~>{THl5P*w(1CsGMDtaBjDW6
zva$n&;L3lo8?RA=x-+IXVoQBVkRC1>w6A*^b*TfGm1agAc~=CMo{Z^@=F7wHd(-@$
zYuHl6w;NiP-=}fYrgjwh=aJlmy=r5-wWRz<h6&5^5F_~z<jUdG^&ivCfl#1>oNy?7
z5%n0pK`*eHetr+QGf8_)jEr>XaLPgfR0qcUrJUjiJr+2ZEfN{!eE>Bd&X_EG(m(9;
z0iQIxigQOE-}ohf6TG4}2mCL;oBHVVG$L<%2<=ly6e965`<R8*nX={-22AS2&n{D*
zxvuB0f8W1jHnwUmm4mTJmF<{4eRaX*qB%?M%^CYF+i_uq;fDmBdp+)h%$s0@wrVvd
zUZ(yvi^9Te=>(#k;{hky1o-YD+2mH@KfaRjCI^@2;UOZFlK(5Si>9&P1F)_TpB;88
zuf{j+*>BT~YAY5Ja2WaxkXXV@p||(t)GZpes^wPiu@xP)v~F+My!ilhiM_(kxWZV*
zrcL)0&AE6r;9)MO)A8c0&p+%}KCYM6|7yW?=&ib<Jwa|X<#oQ(`}$YJ>nkqoZa-t#
zkKB~|eR0OI&km=z>ubAp0Ln-~{qGx7K?Bv^rW3EFrL~tTPcx&rP)p-AY{@1T(Kol_
z^<3O{JhpBP?(_M=^OOU#2ue*Vh4mUl3YIhMM_%gVl`by(D6}MN*p8)_)gG;e9lO@r
zzVx4Su{Zfp`_9+j+~+;1G=i+|oGHJ%kMv>gN(aPc4gHKvOddM7n9{urw$#a{Et}as
zKzH0^{`~nq30fx~5WfZCg0l!pjNR5!#Tf8uJZaiPZfuepnDz2a?V^IeWz9W249S7?
z>3d-9(#YOeCJ+a7KPg5iJl}1cx0S~!9iP<xtwJBaJaa|ev$^@t>?Pw0ARo;mat%%Y
zewW&N%VBF@YV0gtu<z*r-`$t0CR%T4DUIQc8#M5(SUN6p$-qTR3;TCDpK#|{w}|gI
zP6n*HH>NjS{4s9%yC+T8@q570{Z^otwyypGvx8=u^YcnOH+Z<^QcM8`FP!p8P4ndQ
z22z%IiWjT19dN4qNRN5rQp5ILKmYi&iDiDt(7K<WS1I!^Z#lyt89soB&tCl$WlX3c
zm9?;`&os<E@BZG_@jffde~BUF)~<THv1zc6-*C&P?@F10jc=9FO52O<k6<KDQlu5Z
z1nLH3XGC*_2hyz#KY52kL<FT^Q8e~D4i?qSmcFFJ71!t`6jg4p6eB;{6oLh>@H<Y<
zn0{@nB^|w5MgaCkZuvsEfE{(waZj71pmxRw&P0*lLPWlpvv>BM=P-ULm`;%12S`jt
zNswI+I{M?a?14{ZHiINv|1|C>^ZjJ>R_QX^DIXqg<77yCg!D2bwIPn)Cj@CZ^yT+I
z6+h^lcPKw*$l^=U`<ji;?-OS>GvNM!%U2lzB#AG4&^iUuGz;r>0p7u{w_A7e;zOAO
ze0N$uzDofQ%yp^XZ1Z!!N~i5<lc0UFoBjC`TC#Ulq+ytP8mX$P{_B=cSH=!u1YCTw
zy&9-8-Dy*pF)x!nCANLu<-vj-?B4uOFC%lzpPwvA7*?_4ZT7))c72w1a=ducwK)?0
zln^4N3W}{4i3Paw)57D9@?Wg{vbI6L{YAx<D_692bP{tlHZH_=3snm%!Y+D*g*j$q
z7Z5!#xIy|DD6)=;DmPpW9E-ONivp}^7SLkY+H3M<h0rHL;leV8kw#XddA*m`!;IQz
zk`}%I&VLy+=VJQWxn+4sERy`?*VpfOF@4<Ji(S<2=U}Z%Fs+HmXiBMDCfXAG!m?lE
z|NM7<0qVl^;5j}zknZYChzJ2#mt0X;3zUO}<x-3%u)7*!J!8D}#VqH_0*_<G4<D#)
z9=iVKkUeyX_&Ht$b&+nFCCeZFG&8_)c2G8o9Dgw5{=r8cF9R|_9_a{~dv3{xtZUsr
z+U}a>e<}6Xv&@fg-#S?vg3B9qd6KEnYffB3xy`Co`^SLPjumB2c6obL7Z=9`fQm^z
zIIQy5Q}Pktkek=k83Eu=pQ!*5b5?%(oT?r^b#>)5XU8k!s~yq4c(!UHl?)-Z|H-;>
znUM~AdQvMx<Sb&uzrPbSSDAOksSoinJC$U3z4@@UzZ?zfe-Fe0(miM)^oG%v)@X7I
zoG=r(>d|Rp5Q#W?4-V)z>*f`w%w=z4t4PR*vXvF>&_3zJOncBQAx)Y4wD)tzVZ%P8
zI)8e<_m|9Ikm(81TR>69TspgeM^0hg_VqYyxhsrYn{F6!g)#x(X}A5=LC>?%5T*2*
zcR6+XQ-E0u`WDlN_PX0`#)~|A<7Y2FxjDV_bbT67TE}5eo9rbov<FVP3`1^5(WJKT
zLfY&Nay>PL*sELNhh_ENfA|%yJ89vg^mRiGRlcrHz2{ghZsXard97T(o<4=~HEI(V
zZ1b#VlQ+4oM(FD+AP{Kx`<7|-o~{(Xiv6zb2CY~!<iNBRpPnkTz4Nmg`|jGMCSU@t
z{0ZUEdA@8`nsn_FM>@4V{wG*^HE@>yvB~ft5Yk+Db>@Qc(vQx!6m6d*nxfjX-=f9|
zxHYcwi^Q&_+))|G1|KpfeEBalIYb^*LRnOXjt^V7_3nkKRJ%4EmcffOqY{=s2$~}V
zq@3@C#uVMTO^z?dy|_3fw0Q6APQ=JU;)E)3uJT7^#bGH<5&;MrCzAtr+8@9{(T8Hd
zUQ7^z{Gv~X2dx+<^?7<7dpoY^RF)4HUZ_7(w}a(L)U(3+K>qZ{2QSuZ)>|vJY{o&g
zi0COV|7-#6Dd7clBX^@NLPMkO$g7u5zpkvP@+HJ!K+R7@i^hZ0EPXI1&*i|=j8nh#
z3|Ay=RxQ(0`0xxJuBW{SXi`)w5U6n)Ie)X^G@9>dliH5D!XB-V>DR63U$NMfon-jq
z(Zgbg7iFafUo1Xc10j|E>x;qFt)yFkfWq;dO$<^D*pvfn!<4Xs;-wVD*<;HDZ42}>
zqz>yhwADm2zkd4{5ZG)=K&s{_?&o;rU~CtNnFaTGH#$Tj<H;NeQeKf)T7{sWuG70w
zQvbN`C=)>ZiU<=rQ!SIGJ<(NT<#Nbf2Evfl%7Og?z&&}@Rdz}E%_t46D76jmwsYT>
zrak|iP+DugACOxxezObw^72smWqzmGiy)JY#S9_Jq0k*uFxO?={h%g>Gp;OdJ4qr1
z(pFG_39ACYfP_-qEa+2dSp`b}^WeryZwTe2VoHf!Nvo(aNVBb0=cm`6-~IHn4umKo
zou>eL$<W%;U(EfnDr;AYe|f}cpJx&@=y~59yl3hBNsKfQX(Ra>psGpfGBi;N&1AyZ
zG-K;W9>K>8vO~%akcG?RckX;QXzGAN5#bfv?rpc-W$yoAdf_G8(jRMG@|Ki@I>sjI
ztUKknch=C)+6`1}>Z=x79mfSqlq9uhSY}4hlKj>J6E?F2Dfn76;$HqayUL2_p#`-Y
z514k|Zc|xbMK|00SRjIJ6pE&x1b6NQg*XwO-$&Iz%~T3va0W9ZcYsYD>|-_$4w9|b
zK46t5Kf__G|CgrFNbvxi%3f<9klz6cE-h@gK1cN3o}%Gt6o2>O7G1D#@N#S)ko+a3
zPmf#@H~8C~_J)2tW<w-?Km~||7l*PHzU^tIk?b3?I^2ad+Q$F85T<O^iLcY5-vbF4
zH@8`vb`Ac(T=?{oceEU^M9a069D?)FrT3~=udZP<mvAqO*tZw?Y;P)P5k%%ROf1E)
z7G@n-)Lep`4^m~b-KrzPz4D3ZM(L1`-*>iloADi4p<cvUx_)EP)+2<S;V`gc_-r39
zFCB6tWsXE%(HH%yEar0e;UZ)a<4^fC9$meEYS%V)tINqdw02mxtJlIm6=v|2A6)~L
zj~KG>e%`)m&$w4}BP+wj$m|1tdU!uu-L-H`R*UN!+kf9@-K1#1-oqlIDE~gaXnBxe
z1slx7udO=dSN(x7`wN<#gM_))_U--SXEURHMZMV{$mse>t$xRB8R^iNwtEirY{>$(
z_Bmz7?*n4Z-rMzL#`4IL7Q0i$W%3pG!H7s5(;ErQ-ZD;|r(86ao2kqzZHQP}hr!)z
ztfn?wYaj6FUh@BJm-KK+?n8HOKkGiVkYy8aWuRdIWt_*mU==7*7mclQ?sZ$qC*x6G
zMROR6k-m;I$}LODhr^g65k{TwDUxFc&Kqpi*|@g*5(K^^e{Fvk4n@M?Utey`1(=o0
zbTGu&ERN}b>8tI&M-M&OZ%Sx(S>J1RHS-Vb)QQ}imr#|De<m`@q!sp*ks=pnz<U#|
zZL-j{RsOh+3IUl(HdBapf_)}v2e@Q46EOwI?NrCiJr*vY${mH7lZkYQy=1w#3Rjs(
zRhoC;iOh)_`@*3Mo?UuYO!9_+#()|ei2emPNK`Y7MBfIP+~xvB3F{UBei`=7Zr-B%
zy;VLC%fQa@KY7wFy2pW6I(NNv3^{Rd5rhM40p%9@Q+l$cpD4D|jdB_v-fzysan5Bg
zVFU_;KB8dK!s(A6T+CWtc_PNJR0Qm4M_8Kj$g;>JU2oQ5Bl9QOHfymdyR`@&vRtOA
zEboz?)PuRPHS4z)VTImfQ|4`1r&p8g^uEi114Ff5mFV2to^f?R=R1x)L5T>k?=R~z
zKK8XRB5<J5j`OWo3!ZTO=esRYG>TOTnX&4t!D)BP&kdwh%HjIR9n-$FKt~aGi(4;N
z9D>p~1efoA`Aj-3f~q-{(aU#@H~J&);Qj0J9S|%Lr6HNmBbgVDiv{iVMcGRMPx4*M
z4^6L@p6A+Jsz(orh@Vf1Sa?WSnkM^tfAH}h*#U#HP&80PbRaTHJ?E9O_7U5NfH3Fj
zR`nGyN}f;*Iz!F$MC_K4wMC4X()0<3JyH@pe0avWXJtP+pXhz{XaSB`GV!aet^MyV
z;`jTxY5N|S<2az>6sILi{ypq`m7KU=gmGqGUe_5jGNwk{A8T25jd570s_3SdU;I$~
zpxc7!KQdZ3NmU|MiA|Ct9gGLjyMi8cuhhKVs^44Q>9VIgNI<FYvh0LYz1DuVigb((
z(22Viq6|ap9VKb;6S+d_!P;yU!PNvZVJI%UKE#YasCQIM#XM_3OgflOOJg~bn^Nuq
z3%!$&(5c*sTC#M6;Fs=2JWz4zK7k5uk(=H3LA_7rJ%8{zH6us2*AIIII%<|<D<Jzx
z(-MssM+p2&d{X;B9AjY(C<%!yrQh~{l$gJE>z1eWi=<r@gI1${YgmV*OYwDS*!<wq
zY;sRJ)FpbMDMXsLNMGkhwLE{)^~j>C3ezH(Oxhhf#N}$Z`0w8jFqmD{dYDR}OE#-W
zKLR5PWC#g$HdBQ|=hDH;b9as7d(uQv$I*4onxxu8%YXf10CZ*@mBaRx=ZKQeMZei_
z4LHsH<^-+Uqeyl{i%3K;=yDhr@JzV(f@z~*QcopN>9l6w+@U%OMz-y8s@e$+|M`--
zYZ8HW3U?43TURKH@U}$&eaYoI-u|@Pkj0zJm=k#QJKqkNKE6ypqq-t?Z7-bc1oIPB
zgNH5GAmm8q=!W=I(QGRFlc{}}-AW?eUIfy-AkhxK&tAufTAA{srtd3MMX@z@tV(Xm
zUoHS*cg$QMweEx>$>8%#5y_&cnaER-upg}7`S;QfMFxCPiz!F+sF$ZmU(3A2c4v>J
zsX(rj*@iNr=i8+^-aZ0<5=&1R`Z&+N&Bp_<SLz!!xLmirXV!KWt#ikY@wpoAx56%e
zEQFvP;p(Ls^080IoiNrdqRASfgeiFWZclEys@0Payqm!}{bl%P(GcW;n6P=cXPyHR
zhN7P4R-QLQz-FM4Z*#6ImsqVPo!QGg?Y)PVyl*T$-b7*%LiJQAYR1+I44+v&@s}Cg
zNC;*Ray9frcUczgd#d)Crpkw3;uOTP!WVAlJt(Y8X)w3bLp`%v$qmRMsLCQieS&~P
znr0qZ$JSFjT{V$_M(S81GcFQ~=kp-Ar6MxdM;HPG!1q&^D-#5p$D(b(ov~_lELK|N
z<h0XBD!l@5Pphb%tZHW1pnGXj(B7UO8_w`}Cl&anJ*M7q+Vz-HoeXv&7|d}r-lg3Z
zP@_)VA*%f>SJ1W^_Y`xr$FX=P_(n2PUBpPGy8uhn<@d}?=~9qUEX&6#+{|YyYel*g
zs;+;#*A<9aKl*$O=A=2CU?EkCOhNj`<I1&6yDF1gx&6cu%97GJk2GXLgv3WxT1j(N
zC|UyPZALdD7#NUeR2jHVTP3jM81_Rbv~XPMR+&fzYhw>cV^ky`n7-UM@oP51hI6(W
zEjnOX<g&oY&eGs8RU7qBa}sB6J*xStN_kmErGHWCp3%~`CnN|Uf&D~YfGnC6re3*K
zmgltJ8qPdKX62}#tYHd^rzbs@5FpP|CzGhz!_kg4m%)ZoDa8vEZvI^dE}zJ7X;S6x
z;r;UkmWQ({0|fpa5;OSgn3E}F=6h$o9?FbkV?UIFMtW#_ZzIn>U|2G?>_<q&^r9(|
zOXdju3oG-;^h*xCltT2rwD~)7S)v!8N`NnN$GGUz1n-s!>r}`<MA9E7v=F8ID1*E$
zT9=6HrVKa5@3?eKZ|~I{sVqtbwRcwYx%;iEneA42enM|a<y2NV$@94)wz7&skq8w8
zO$t{Yu{U>;R7ahk8actC_9&RGGBT`ph|FGdACU=GLe4XpucW$agPvi7hix!1((%t1
zJ4WXVy(D)gI2#;}7^)6Fg9fafn07CY8O;$=l3&!~Ll}HtX=*W8J^9*g5GlN}C};~4
z7(iDW<~bqQBzh52zM9?<K7|klR&5u3ev!^2zk)WPF`OR|Nh0<%mujFT%ASJBF%bc3
ziZEx*crw-1{S}*ST|8uR?PWUC4GauK9Y`hmx)9%qK39E;%$93Nr_A-(2<XdH(aoF}
zc+7K>rkXAtI~r2RP_nKSZ}c^WCqFAT*W5pYTGeT4DU{jkaj0JhnGOBVk(K=je0=Hj
ztIDAvtNDDU_AE?nJ<y+pP<~CS@KRfZVr9Z!rOLEo!S%5Aez&jpt10X>4xNb%86_%j
zz4DDmw;10UASCjg09JMurGEATkrY)C_92;sF9cM9V6F?qDhdKL<p*79p{?*&_xywq
z_W5hyyctnlNhiapC*fs419^DGMAAEuk&f8=;3whA`KS73<}YiHLZW9Pn(b`Wo!=Gg
zmY!gq(o?#8>tJJsl`s)a)uG(WYXZUVQ901$pq2^xIx~$EvuWWFMiXat&b&NIOGmGS
z;ZP&CeaoSm1=exz;lqc4LvDvi_$T}cG)%$&4w1!)yq~yezV;5`d^a?!o)5WPet;nS
z^_oHx5qT4;1Xa5f?uLWiB0-wSEXiACmVxkWDHllZ`Xzez#FA1jqYroZs+sntrluaz
zHLJATI7dY|Y8I3tQlN+vEr&mes06GP&1=!36_SjIe?IA>G+L%=YCozb68oNkkTkZZ
z&=!uEN(PUKzf3Z~IEs6>ZXKg?;HxPZ(7ym)0_mQ$JyOf~K-7?{91EmBNoGWRpxKKo
zi=utsD^b*9p5M2-4l~yiKT0`{3@!;{DSA8<{Y0#F0;rcLm!EAP==l!~uS6jP!nA)z
z7tKn9bdz;vvPEg0Yf?!2tpNxxOCtroOH{(xgnKx8>e&At_8Y3Fw>NOfn|hPKO?s{*
zPTqm02`Yc#eYNJ;K2gb~cTxs~3$cS5tJ<pH+@9d9tgMcB@L5xo^>o@0CsVBxpq^Jv
zjKIWhL3_uK9oy|o!%+bFZS2h-w6Oi@cf8u&(;xd3RKfu_2ku@q2#^w+)??%jJ055u
zH=poM261A&y1g`hzXwPoSEj#HV3%sX46qY%d*KSwF`?}F^SscwWJ<R#Mp$P76Sx&x
zIdB%FKT8I%3o!!dT>9CiB*55n0;L@Td&V02t9h=)u*qz|=*o)K!nkaRDh0!M1z92g
zU;ujvZ*gbL?}%!%1;j=;Dk-@dB@3w>0G&2}dS48p_A-%ZA;T5NgvhnZ&~@5j3Cb8G
z2SW>VeF@9su)O6<Vmz%w!`y}@m<_eHwOtND;{+j6MDdp|PlQcuo@hs;&KOUJw*i3{
zkm?vY!?k#~H2adJ!e}-SzCUXr9a7#ScGyLzZ=vY<7&5X2BNOI6I(S+NzjQnzYi@=$
zaGY)j<|UCh6wk3zXO6}Rkk92tW(UX_Akpk3P`e;gd-hBkUeL}aRrR`l5xpi#l`V!x
zN<Dt#^^$ba5W*bD915X-gkb);MPYx4dK+`0H6>9>X9+&b03#5Jy*te1IH*Ov>$`5=
zaCOh#>*iGmzN|%Hwuu%J;ZzcMTsZwvWO`6QF<GQ^1se|`6G^gkE#yrfN7a>|JoNnl
zu8U=U@QrmUz`>{gXm#UC$4mDj^}-Mz&sieoDxLKdAa$kvSU9W2qVk1v78j;F`%VLl
zYR}YaszFVT4h1HV)RX)xnAH(!J8}Ck#*1kIIko!7CsBN)a)0~t$TyX0^F3tXnotq>
zqmLPt6)R>g9B3_kY)py_x{*<X7^MFpr)&2myiDdcvL@$c@C;=naVeIg6G{A}R~x>w
z^RWwteS;RY>-xRlneXh3jJ@WMSInkP=Xabxm``Vxpd@i#?!U~Z61jcsoYic2-%3i&
zGX50%inrXI;^ciDmId-uItl9@3+9JI>m7eQ;-N|6NifHatN&TOl&)N8&0{1DAc_~2
zCW6{Z5%y>1PTZP|)~R$K6bxCt@I;d>Okc{AT9d@KlKhIGujr%GYIqv+2Eu<oW!1E)
zQ%O^7B{ac^rSesUWF(LRmMc}5<Ct|BT_&Vx5N3_eP3wi2)*f}z<UkPB!Qu3^672PS
zV3K``n=OKO!lxSo@*yE^1@sN+X5-~P!i@P?hlaYo;POe?PQn9Bdx%dUz?)U8D*7Ei
z9?<R~DLL+v9=AI?MY#+x?2M=&(BLLhp1Gx$2CDmZiknkCkr{eZw}0E+!pqAqVueS@
z>!W~vLZ_e|Ds-UtD|9g;>~}rB<d%{9+2HWs(4_0nU^G5BPPU1y1NB6<TcSD<e<TRo
zgJ&XWKsBrv?pFO{c%-^VcaD=xDkSK*Ui{2jG?avcTcui!Q*@tVuTsGK7!tc|bl!Q)
z9+3-O_CYx8a#W0^)0Novgy=E=xe56b1_1u2zv1&ux14%MtTj2IkUl1G{X{$z+i>M(
z+WS_kDaGgl5p&kZgXSIcR+0}*^QEPZ=Zwi*w7#hUp@7I-3CCc$+WTXi)Kh;%o&X|d
zEk8I|G=*RjNfk{VfO~dfpx;R8$CK_`aSg%};iHOS3|qCjKNl{dq%B)@fQxIIpL**f
z5<1{<&*-EK!lcT0FA`KA?$D~yc|v33FV9JdR1PqMa1O_K^wFW_EzTL2V@^`zxKQT5
zX(L2Tfb`fok~CFZpge_;)(S34&n8snqe5xrdR-b|yzm+TmXIQ4B`LLu7LdxtL;2Lf
zl_LP<z5}%`U|{@;q8kgj)Y6YF;wu22A`Qpby~8K#dsjIt$rF>S_o9Cp;^WszJfT?A
z6`x*Ko#IyZeZscpNe2h0TwJyJDa2uv`Ek`rx!MNt8C!;ib@@4%4g;!Ven%aNi59ka
z*eA?w61wVsF}D^w$W!C-PohT9mG*IfDY=BAmrWP^+05tfK~hVzhgF`I5f;)}DCNon
zFQj7+za(jw%mMs7c<obB<v;}Q2?@Z`sn6h5;V~^i@xrF{0I8SGZ0^Um!K?B_WfEBi
zp+dciDtG(-Y4ExDqRKWu&khL+jQ8(Qrd~sLeaHB%y~6`fX)pix(hmQ&2^L!S=OtQ<
z8R(UJWSe2_2^Z(In6o8+^@+GfO$xG0%XKoowkT|tJm5#p!pMN_34@2Wc8z+SdiMRY
zN0Avn%90i&?*}`a1wQ>TBW4&w7JIR?J9>ML96r1Xu6r}Na^~ynt2KtM(HlE<tj(M`
z8@aeT7ZZ5?#n`FiK|$@hcdtv>VLEA2<&$n_m?@bt`sj;mbL|_1K(qzWu1RMmO?^=l
zf3-s~YyIidoxyb6;fzAM@hljlW?=T`pAP+q4QTzj#gKtCpPQcE-l|+a73TTIv(C?b
zM(VtWF#P1n6L$}fDx^<w&Mo6DEG%p&YP|WnvRA);HMS>=#O*!zNy$n{PSzYSpc!MS
z^j3UoiRrI_WK%aT!~5FC4<BY^wBe#&SyR#*n)O}hmS=W1tW~{@PwAFz+YIK+>2T@N
zrP#NNZRXGKvg{br(dvkje0_hn@s-HP8-$5>6KeFE$loDawT;#3fBN)9%?3w6`o0tu
zZP>EqzTL2h=;+q;+>V+(TkFAt2ho$$A3Uf74Z0KL0hIv*A`R{4do!dNh3FB}r?<v`
z+@grs)894vJs9Md@89FWX^w`3)a|jS_K+b%j`j%m-@O|%P=$X{8QT~YHBhf*J@}aG
zpa@#k$?5#>U~+968yoli`}eD_h?-@NU9PV&WL012)*byzcXq5|n^4s{!u!OUtC?@#
zdZ183#In9Xd)CB>6H`ugJ`7xU>eQ*9^9oMxA6i)+%5F#Gx?QzMFUoq@g0!xE-@a;u
zv9~Bt&a}7xhuM$}wA)><(u7Z~TC--&zJ2>@YH3x+TRA32(OH)XV`CFa?u=?ngr>A(
z$>23V8xZIWCqX#2zh{edO{<9$H}WaB9zLuK{-NI4cI3!vC@@}toc3kq;K|n3{pY{J
zPt9DgU<<ro8+urNQW^b9wasgn!Bm=;zr0;;@8U9m*-5Hw>&KiNoo9BIyeW#Rav*he
zo8bOFzPj2UUURjPBS(%67~Cu=>ESAk{sy{RIGM%8#T${g#yMI~JobSkb>^&D>v(jC
z;#IN4wu2h|cPI_K4A@4V&UE6$IA=A(mIIg7;zvfBnKh((8t>fFyUOzA%l8g;>CG%a
zCp3flxxCMZNfC;q=$(7_+I8uo3O+q|(1Zg;U*3)c7?ICFDtvDryLt|ejz`a)z3<%j
z=*z1s>Vr~xT)jF7J|#!}ayu}BH-#mhK0dTpCvL7W*x1;ZO3}!VQHx$*^VqYeDN?6C
zaA0NWu`P3YmAI`gE$ZA?S62rZ{L9K~9Yd}!`Jl@GJ5kD5gObOLU%!CwZzd<JQR^*x
zm#wa*W&_zV?TS-->c$6lo$bu^oXG`eM(WCyD{Y8NrO=(e_V7~TUz&8@aRM}S=c|$5
zdk{gYx|;pqz|sql0QV17o%s00ix<a2pxC$7#B7!mtVLOO(#Vj~<#+jG9s49L2PEFQ
z6(?+~)^U7|U*&NVqF;IW_-qOZ>CSmb?NXzE`P1KraNWA9$<Lmxy<|CMO34=Up-4}7
zQPS}&4{GAwXfr-$eM06;GJS}^>o5j-EytZ*)7^T)gsRMJL{dYZg;8jounx^Hf5(C|
zO1C*Q8!rrPuOzjr00^+b-mp#ER=sp^KqK!;R8+gpo&TxddT@i1k^yb2!(^Epvvvrq
zMItV5!}FPiC5x9YH^92w$ozWb*s=B#)Sb?pK0O>eKte}6=|Q{S&G`5lboUL12H7lq
zbAxpp?sga<$~HIg@kav#tGc?nYBX>DjvErxX`H#^rnDBL4i8yfgA;V+>eX8~-h<X&
z2FsW0vLT_&lc86oI(#?N2@_@wQvbgrsnZ3M3(Gwg2<Qo!L3pO;gBv%h(7DQ7uDOF$
z;~KCGqYMm~OxFVEY&*y&ZI{3Q%}0;wf!a-uUNe9$iQE00&J8IkOPket`(~&Fs8_U7
zS65%WY}qK5^|?={z8?DSGy?uZDq`U5-0%7m6IZjfYlq@v8#Zg^1&v|2iAmj{prFZ@
z<~1Zz=(41ouvTy2z!4KBG{TI(S*%y*c*Vv2`<u^Ou;AFabM?sA9ljY{Bkyr|eXZGv
z6DPJs%{zPke0`2bKII{^VoY7bMvc}{jgrw(CikAHZD>F{P7_G_Hz}z#Y}INT=!%zP
zOi!vXs!Sl-%464QJy?Sl>8=m3iwiARm3{9nJ`341#$(r|E7F~5y=?#JHkGH;^8l!S
zQZihe{iu~;YrE&tKJs9{Zf!JG8X1=_imsCNph`c72F4}M+3*@QhOHgkdhkkjj`qb?
zHBmI2aq!y|3yTfEeyvGPNpZdOJqBZWwj>O@zwBL$l#bZaw*C644|2}eA2+TZu<3g6
z1}@vBltXL2M#$Re>FHxM2Dh$Hn(J8ff}*SqMQYqxEZ0&a=M_llaQc+q<mcC+=4%*Y
z|L^*bl&FrJJLki(wILx1j8{=quUYd}N{Xz?y6xM?A4`Q9ZA;Ef7&^?x*0!3PTcvtN
zrG=@fJJ1v(fYo}=h`vpqwhguv0#EO?jc*h3J5kxhP`)Fr^yTRK_|)6FZJQ4BFjl>&
zpK`|Q`tW5u*_G8ldWeNAKJXl(ODt>Bwr9`ntnJtX{kHwD-;UeMK?l&OMh|NoadMhZ
z`-?2wO}t)<k4@tHwH-RNHTB#Cu6QVo+Todfw}5=fS>Xt+8QO+WY0jVtXDzI(ya^3$
zxMM4^WXqN<<DqMh9C@psQxz9X*5uGxDm|uOt4019o@v_MV#<_ec$C=e!X5ke{lf-n
zG;4O_=FO@vUc4C5s<M0$fGq>&MlV^?o5RsiO)dH3Kl)=YgoTY{7%t<QHqMX5K@q36
z^7Zw7a_aF6-ks*9rypCGVaRnzL3zKK3;G;9d~oN^YJK|jq0_JihttmWOftLjCNFOb
zNXje<zm##SA-~-<>G5ky-VIx}+)9m10v9CbxKC;es`W7V=h%@W3Q(~d*v($_0f%SS
zk|{{N`t-R)iWxV-?W1Yz&8kOkJ=teAeYy{k^IL4~UV4oufB!k*X?8|s*}J&f$*HMs
zlW7XB*`&$tp5sa^CQdXU&#-<~-NJj;zt)3Fsw%*ce27)s4;j)58<_yhWB;<`5(po?
zP*D4rm$&|LcAsZ%$T@8z#d-q}zb#<g^IbK}6hG;q6ib448?)<Fo9EY8_s2Pf0#$R~
z`sYLzgQCC9&)*8VH4E#uxAz=X+sNA|!o$_EC<I@39z3`W7AYr?_`opePKC9TlMVrb
z@7}$h_&;*Ws^}7VczJ<>)j1Lz{NQJRS_jKfTVdVnV~WSjog1VVVc+lkjF^t$;o;R4
zI{o@}q<l8(e?76zJK9pJD+aih_Dwe%<^1E*w5sm2=gbLhwQ*J~d*SKl*JujHE!}Lt
zL=Sh#w7hU-U%!28hrf3iJzp0n%M(`vN2gj&^6AFNMR&l<IwZ_W=I6a|IbVy4W)D(L
zsmf*EL6|hl!C@>P;C1cV;KZj-+fxHS&a}+L>jd@240gH;4f+ldX|s@58k~$ysEoWv
za&$z<`Lk!+)AYpmI-a<Ii(y3ZZU3e5D_836@b~Ws72je0sH3~~?Ab{+(|~mBB1mTv
zhM-&7+DGyvJR>4U?ch1I<1^c(cI(zn3%RrR<Y6884!3XKTsJjl?IDj#YH?fd-TSwy
zJG7Dw1={U$QqQ;fT3p=3+ErI~1SZ}xdfJ4E6FcBRwpIMf&7Dtc`xr=rMvMt#*tyz2
zs;cd#_Si$edjpJb;OWyw94Rkcew8n8hp{k$XU_bKt@Ao}u1DyF3!31tM1!00D?3=$
zB}|aw{nFa4ZDVF(OoVEH36WpUc^=m3?UG2XVZ#m=Ol}8Xr#;QRvjK45LrpcAUWv+K
z1Jv~|5+B89v`9=!YDZ_AiB&asS{HRo3xV6@U0j$DZ=UJ;3_Ie9f-Zg7_TMrW*xPsB
zH)utV9lpMr^gq5QaN9b!@kz$JH|Vj)7-#Q^!oHjwM)Qr*Y~VR32DQeEa3p5g*yz*L
z>cu-jk5@<Oqa9IH!}|ehaeYHg8ibrW<xW&hIO$D5zs0upGmN9S%MA@SY}zynv*0i~
zP}}?OKRbwc^+^kWbhbs8T|WW*(t={mdbIY!z5ekin1TZ*h0tu@emzq{EL{g~yHLGq
z6@u{^MD%s*)*Ur^v@Pr5kT8G8nX_jbwrR7S>W?@q;`a-eFUOJW9O%3IxUS{~G5RaN
z=Qley{kkd}65igdySu(-EZ5*hc45O7Ew-@x^X%<CZoQ2qtfL;f_0uFPE7h7cH`h;S
zT%&sRzGXUl_&xDuM6hq@Y_`}&;x@wAxHgSuH?c7-E(>4fNn+w~?rRhV{FH804+VI_
zNJw?Q)Wj_;XA+Zln-SeIDk_SA^x?qg#pZOvy(uWzhF25unx7!Py}<5w%&#aP6#Mvb
zeLnKZvuB&2LrwMxIDRS!(#kFLuB?l-ei0?DyZ_-P@O8K1)kTWIgWW&eCkmWK`=Y9(
zg~Um2U+4WmTjJR9<JGHryt%c?#ihj1q~upwt(6@+`k7m-o@i~oh3t`$t?%f0+S}K@
z5h!#oh#Z!cgR_8HCSRW4WaZ%2T$&4bmX0xV$BY>h%bJE#oMt--Q2avIFiJ!+B+B_7
zB6pCOw}0U9ON1$e(i^vJt4lk_#%*PX0Rz49nm3<3X#fOfvbJYm(lCYwe0+U<5KRSN
z`Qp9zk3YyRa$naWk#}&=ih4v`>v!*N0vYo5_o!^nD8{k+;m6{M6gJS_NK`iwv(hzp
z`(jT6uYVot1~P1cKtCS8a=Z7VJ&xkD;WDzpwb9u9SyFQO?)ja6PoMYvVJI0^0g(p@
z3vFefwQ18P%?-U)IW&&*0Rm>2=sz4pLuw<>eQup0LIkX;%4V*Mi5Z4Xf9{h!>t&2v
z8(7d1xszP?BDl76D|)?$eI`iJ?Ao<<hMVQqb-Vs@0V;>2J8Aoqvv@qtZa;8fb82rS
z`!zS;@;Gs#1JBade+Vr+7hp*(%TH^_JI?(u<|Zd|Ynx%MF@t*8Ypm$TGhuL`Dbv>_
zH`}&wVM*DYj}ikxjNkS;4`VG(g^Ad`kXJhTO*NAR=+(QogcYF3)(>=2i6BXzYO-Zj
zrcIm1s?3Cx&@M%5!y8Bgwd&Q22SMqDv`6sN$VMpM7JM^od}fa96nC>40de@TS|$bt
zDlo@dkkH3Xh*@eE`?&s*@lG+pXU?24t9y8Sz~CF$@nKf!X+b!-)k(*ec0SYWnroRl
z@qMjYwe)AsYzub(4@=Lb3vIQnAt~c#X7S8lu%Kb<*7aOn%R8nrnUwFR!tOU{)ad5Q
zK2ht}R~r{F*b6|f|7mCQ7EBL+^{N$bC^63L*|Rrzl^G#bv;OGOwnfFoq1?cZscu|(
z7)u*ud4Rhmz{qSCSHOzkYSSVXwZXI4%$-|<(ho$#u@0-FiA`|Co?Euu0y}8ip~FTp
zLmNQ&C#k8U32|<Rllbn_i}!mSwS3DMW8<9!hhE3lZ1LN>cMN?-2DIyqh1#ewEMW70
z$1HIFeQ8G_*}LIfXGg8-Rg)-Pc5HQG^yRUfol#V22^KsHw7VN(?lAbH;2%TESU=dU
z;$Xp;VEcLVH0h}sHEGfw?w>Dqyb+9=Z-g=7$GoPok~uFU`yhg2OS%#WP`v}_RU-1L
z?x#+lZiqRj`=I?Z*ZcSGiOa5{&vhQ-;u1OeM_Ef0hmrtSCzzUQPB=uJtWlpnVI4z2
zaNffLYLwgDGdg;x*`!IG$f``HclG8r_(3gbOnSt~spR0*ZbnvC%@dQ8wTMq{zkGQx
z)YgJ5#{?;D@gKB}H5JcD8f1ICpMh>1h~HhRL(hHM`oU!KWyWJ@%ATF=wYvQ4@WJ}p
zkIxx9Z{8e%i5tnkMz~d6c3bh4c<GP1xs7-VCTssnO#JjSCi7LzIvV<yE?@Qv2xu+g
z2VVX5lPA8*a+AHdB0IRPN$nSRKBMBo;gDD+CoQx+6Ph~`?$2+WaHp~WbF$(7hemAn
zEMSSEydnahMuZTd*T3V%G$rcj)$79D1&O!YXZ=%>_jww-(vtSwyJfoZEP_{HU^@wA
zQc_Y(ruS@6YYcLm@)^zOf=HWT?QKj@{q@I>PME<Ctj=sUK}hhkGJe38m<<Z_p47D?
zVfQE_BQI37cMz`Z+_b4i=;!ffGurw86G(3kYRd@}3pHAOemUW~TV-ol9A63xN3x!w
zl&Upav<Pdp<$q4u?X)zF4Gl=z-3zow+`oVS7B#IMhYr0u<1;F7s53;av3q+}VLj8X
zx%5eQvN}j6vHsTEBP7$LQt-KF4w?|g0u1MyVD<5Vy-@h;HZ4jGX6S;ZpGQ`WWfHgK
ze0bPx<BrX<yLay%utC+KhqnV4X?N{<>&~58q`r78^|Hisglg*|BL_5Z-aIz*>xTV`
z+e|rXpf_kxCPoG~*)VFHqhohMjRtCJ8wjHN+800+?&Vs#3=Vc*`&W<&j*_rZr_(L#
zJC7V1hh~dMARh*hu-mflj8Ux{w0?zBUS{ZUCNeeL@UEJ4H!mqjN}7O4s|Jt9clYi%
z%Hwa|y;}zc-pBV~VDwm=ww0BYAYspa+U;V|xyYH!D%{(DQR~d&yj;bUDVjPBd-a`t
zZSVpNTD0DWu;Ac27^9UyjH4G|zgsN7bd`)8anH)7l^}Fn*J=dWjnZ|lsu}1$B=&jx
zJFOWpabgpiA#YQ{+`s1iDr4v3+=+Yl?K^tqiUuGgSxe(H<5+LO>>!cGZ=YRh&8P;!
zg{b0m95zn1&u}#bMH;~>kDol*-+r1c3EE5yu>fTdc(ju{O9WDN^Q{|r?1mZ|Y4gWl
z;0Eih`PmCGD{qdKElaW3$;pGXIPK)I=(Xj|$wKv)E$a*IpgsY*q<b7407A9A*J{O`
zxAyl87_hVk$%Y{_orvY`&CXFjPufNKBkk&np5&7aG&DR(hA#f^`D-2r3dyFA0OUwF
z+o0aOxi`d(qpTdh$RXkA2Gc21ygo;l)nj!MFs?ZnnVksT1-s<@ac)q1DS03FHvA3d
zIW1~=SGqlpoI2%68g}dT>()?WYzJ9|aV(i(p(~DndYVUpo<*Ni=gt`#8rJx^W+)d;
z6R(X^TddboLqntQ{ZKbD7D0l+E@lGkl5|^cKXiR<`9RoC3j7Z$EQZIe2%`}+YC{fM
ztxik53q}h}#*P(uT!ulq%%DU;fAt%(?vLd8J5#shQf}|1s~hLpu)U;ZL}dL}ZyJ9Z
zl%BNi0tG?s&Yfp+YdEW0lh>Af>mU##K@H)q4W(O&s~iso-d+f(DsB~s;Fh!6QSpxi
zE{51t^3C{_<rjPF8>oyKU(>4e#E1BPu36dH#{vW29lKoVQ2J|Xp&by1MoD=EczV(2
zj5gGjV>kTMc+|PkX1l(CHiR-)IX@$&jl^L)cQ(dRTR+$~a4exPhj{VQrR)9u)mgGt
zKR$K02!U#smX>D2^+I*ZMlYxG<k6!ZfO@ry%ci8&NF>6l-`|x+mE(8I`o*&$I)oO|
zRf9unkh|jFY13LkaIA@2dT^kBeF*Zw*A~va$Io#dJpq@1TdN_TQ5#>r|HObY%qPyB
zM(paJGGew<n7wuTc6Im_8qDTQ`*HGAjLr+qe`|S!hxg-yef|C8EuLFuQ{Ckd4+rOO
z*{W42m&G!p*RlUniBs`u(XN9CHo=YYi?tpCnQ&3`RuyTdn`yV*ci;d-o@x-&42Vab
z`#gOIQ$_L;+W4rB%r`e#Um5Vd7ra>FwphSNiVm{}O%G$fdOVwKvv8qoA7IHWtp>Fg
zSNwAMQnKcDe0<==i;b`(Y%{09@!8xjU|QX#UTMGx$S+^N(wnz5te|`bL9G<|5L;@-
zfWr-Zr!mDmDZbwWcdhFZa`I#+PVQoIg^uUDV@64RXWH7{dT~6TAj+20K~X`VEvuLB
zi*Y-_))Dn+mApx$2O6^h;?SlYFQ^+~S8D>Znwgsmbg(#bYU#E0jShg5yyM2{E&JGj
zTS=nn$vMshZpKW{y#^3@B&f#0VfE+P>rAiMQt`Z~Br@yq{~t5{M_2dq+?cN>nhgYc
z!*pG^cya!->z%zz@ACl{m;l&v$SO5}_ZyT_yy4_uj(pnlb+l`3#?xrA)K8x_hDy<}
z)MeG0HG?VTyvfP&g5jalqNt5nAxB5Ysn=FE#8@r*wrXaJQ7Todki#fQVJZ6ecgcv4
zTKu*umtqq^N;|r-K4uJ;rNq4)KXD=y5s=Wq_2-RaYe$-zHULH*cCg!<_wP5r*zJ42
zf+R}t|E*hbwf_L)Qw^z2pwmy+Xz%=e8jcONd3ky8PT&E(s38a43;&nY($mw^oqZu7
zeVd!BN_@zbCQ$u9cUytVXBPrZV5ZmeJ2eEtzJZm(L^_N<y5RzRaauMtyLS(Hb!cpR
zZ~PJWOOtX6!>jP&3sQEDVRg0;0+D^S8#b(sU^-mWqN1YPYd1I>gUSx3eyakn{YcY#
zFHXhuRHu>h*r`*sa&vPzZx=3I8bvCyf5>Cb#RU+6WqHr)lG~GtEeo^z*`Hz#D8O4F
zF=-jNQ@r-q*U?Dx)hApwnckvF6BQ)+udV(u?o{nJkZ<2CiM&F4#?F&_dVj#p?uD;|
zQr#A;!qM%DCMSvI$dCjBXCQ}EIjG0p8&g14G5=*`V?Yt@o;^2{>%n2RP98P!j3Z#(
zZOB23Y46}Je!xCz^mEWa?Y5(ThDyYuYPq@k3w!jMuhvJGs8rl5-%Dy|XU~?+D{#|w
zt(a73hf}lqWnWW{6yh(FuQu}td~p_@5Y0euF~5=)lfxkO`nuzc$51s6a|I1BM8MXa
zl1$Fh{&1UdPI3xB%4?Wc^sKje{mYkAiCs)i72oXVSv8hg=KrJXti!TQx3-Vnih?aB
zB4ME*)_@>wP>PCJfB^;;hzMdKDkWuL&=R6p*olFlh$4t$2clRAcEI;r&Ys!tAK!kD
zeY~@`GXu|a-`BO`JkND5MKDGV`_*gLnq>MpOV0_Wo6YZ2R8s1(^!9sNd?9M#82`iL
z>^qxt;`HfGG<vH;Lt9V)O^5G->Yq;P$UEf6?<WJS2Yi)xO>^I0Tl)gJzk*srZ&dv>
zmF`W+!rd6sRi&{S9W_r0NM{2-NlH`x>!oYg0)a=@znl19GWW9qDhES_&6Ko<R7}(%
zR=O%&MR;;I#Hi6zuw>)0V?(g7T>VacpFKr0Ht=0RxmAgEGlz|hcz9;TR$g8h!jMfI
z;g;;PUrY&i)H$;usLP+`W0+^qJ9XuY^l7FP9apKs8Y;x^*<*U#vF~1kpA-m}a&k6G
zq;Jxsi7gwz9k%#cjvlS5U_NhN?;f8ikTwA80T3#?{iellsKA)MQrw;5J9ok{CKR*S
zCYif6NW)TYqZP|4U2H)wx_5c?DE=Y<>FZkw4P-B@1(gt`OHh$tP4!=ll4(f?A>W7M
zJ~2Li&A}haSesg)$G+^@G>&zeiV82N0G(3(UbpI|&@HsHZ*|qwb1TOPGRK+~b3)Dk
zADN?K6J(A)=6@q|pqA2#u;<Cb*Z0iCv!+L{#~8%GIUQ128($L4Q4&y-{_!eV*BnUV
ze%K|`u8N!Kz8Ekc38y_~>RBHR+cV@p`2%z@?Jd8#f=H-xE>y9?f7L<3oJkAoxooQ%
zO9N|;eD~&0J$q`Iu&rBrZP~J=`(ODrKR--nZS<>GuQmha4BQs}7dwYkQ87w$2Ri38
zV}{{^$7dg=x0i1YLa~8*w$=!UBumEc*R9-TVH1;ex9%;{*DoHiP!T|37mafUm44_k
z3N3rro;~Z))2AcGDH`h%_isim+0Fgt#B}2zGhO1uSz^K{ix?+>-y4;0%2gcy*woaG
zwd&Lt;Glb#_78UdwY;(}ADo5kt)wE*(>vDYuX~1F6`z2O39>-4*9KXDvT!0(FSUGG
zvz+n>^N3n?>eRu+^q@+B(}@4gN2HH!<6ZHj7R6iuT8r+zdpD(tnce4_LF+bcoTxIk
zfoama^w33oTuVhog*jAZtRVnP%Zs#xNnkOYk<}S}k|9JxAoSS5m6v|f7(9LPqAs5R
zNS1ioJpJYOepLAa7jPqD_w5U&ZZu8)b($s&ozBmND%n)60H^!BHT8-H2)V}XgkEk*
zij|?ZU$98(ef!Q@nzaCC2DZ)LIXidy{3+|+-H%B)TYawAN*+>tT-?)(4rC`<C%?)$
zU;S35BS`A=<NJZZ{2@8E7BSFiSYwk+DEj46#M1ls$4c7E+dJ#()s!(~o7P*!p}6?q
zK_~ta04zmmWb(t|c0mCm1_iDwK-59D%`JG?nE52|1jkojRgAZHZT!o_=qgl`7%s=%
z(KDgU7k(dZ<}C}G6F+=_aYMARiI&`%Zj)|pMt_YJWFEp|9jd$sXI8XDG`orb46MCF
zH(Tf$$V__b=X4?4^nHh>@7os#DcQdL_E~vGnSTZ8Y_Oj&!TJ2ETEf&YJH72{(JadF
z4zPYE)2DaEZQuX~M?|X3t9q0FJ%lM=l6gn+)#>5xh7`CEkgw1g?kLS0ziG%i#p}C<
z$<8UZMrk7A%JNLKx9X}momV6!wv2j$5FhsR`ItP;-oE>Q0j<b&UY}mIq>`x5%sBMh
zzPzc%N?TCU08OtYj8UX*e>XUCvjCA{VYO&&6BAX<EiH{EOlaGwd4u}(>-Tx)WJQHe
z4RiCHpPx|VeCyf6TCF<Q`8J)AwWDJY`O=3e)}X@AU%r?EE_60n*?Xxdd*+oKY1F)V
zbE9I(UO_>l1HGyj1J4UT#<YU@*s<%mbN9ol?G`NPi_R{H50vhZ*%+Vepz4m^zkldL
zH%rPQp+a%1z>vEhYc?zL6`j%n_`pI)(%g=5?5kRX3@q-@p~}F}3jh>e^iI7(J!{Ic
zK{dK6Hq=l5ed=}9xejPlW)t3j>^#_#iLMqPq?82vO@<f8rW}1qhej_j!qKslIO=<?
zSTS<iv~yz&^r@;ZP_FZnsNpYj?@iK{p>e;ybBGcT2!rvw$}=5@dG@B)QEb_=+tOw>
z9gXd5ZGn|LftH?|^eDr^(sIqggW70jLrBeGZfEFwpsEIYRdhwKy$XEf*!Gy^bo{*N
zi)3bY)@K8q9K<#`%<smIv^{(3bB!tKgsQ!X7X|tsYWe+_PmfJ@=%#jMGx2a2o0-Bu
zlhkrEoAjG{x-0AqOUzeOB?VJJgpnK%{-55}t&Fm8<BlC2?`y9cFz061L$nu1ovp`+
zwH~6ZF(eZX-%Bj+!fA?>VA{h%#yZ;~?3#4OTUT;7{emiQ_EWp>`Q{cD-4x6r@1^nJ
zDQt!-ahf}K6m|aw4%4kWchq=FiKkEReCO2#G!RgBB$DV29Kz*a->cjY)30P;9n+xp
zi`lwp`i5)Q3ZO2`4LNQ&s>KcCp7S*7D&$<fs+ii`4k?rgegva1CwLSes+$gDhM3rR
z>eSsq)Q2BqS{OB44hkw58EDfBY`}W5;WOxiVP*@O_3jGh&=o|jtg@<&e7c+)H`D+d
zRW&s?0mCT5kxGJD>fx~w0Kx_e3~H{6%7?!F`dJCZwP%l-fM7K5B=>MqAJC)~PisTW
z<1yWPj=%C{>peC0FZ(OR<{#78G((af2)!{0t!euK>qwr8t4Eyo?0t|>)dMcgc-pj>
z$f%9g$9?(c@rjAXqsNRf8Crc>gMPM=!eVqVVdW#%{lVi-05xk)LdkAEBpTjpJ$JMf
z?&7B9z%(ss=i`%;v#;il90eOVg6nY=HK06w;j~~Z(p@xQ0_8c4851o3Dv*JEbe{FZ
zoROJRyIcLy+(E(jXW(?+<FivPc@}+1rc4D=0y<V~SQmcDKQOQf{d1nD&cBRSnhIZI
z4Zn!DdM~6v6@>p4i~h{BPuu2w;I$D-SI5M3L6t%isy3dGh=o$c*RKJf*39+f<VN0k
zQ!JyvD$p3~;bDbsdiBb@*Oir50KT=c!3GK?l!b$QD8a=24<_M)=jl)`b8`kMjGUah
zBlxV_ck4CJ#89Zi20(HPmn{pRy>a$<^X84nX>c07d+%PODYL78eNWl9?=lYW-E4PD
z6ghH4nTaR2mbaJv2NC2PKY{Pc)7MVcK-Zx_hqv>u6>S(MU4;_txmniZlO9b_8H|Lf
z=HNUnD=Usa*K6E0WNj)qCv=kQtoPXGqGu<C5y<9xCHquY<+HIfn-r?=pw+M6W0Z6-
z{Hw#m3)&uD7f@%xg7fE&#<i=c{=Gt7Q}Y=>U4I=NmtoCKGQHVm+OS!(%jm~wwSvJ)
zvo2ru|5(<!&lsR|9vzy7r*xX&?VE;A`c3h%ZSbP*q^w0Ru7=I}+4&?b+K?gbTXfM^
ze!cuyiV~Cpd7T=SBw=%SOd76j0v;-M?kr+}K*tZX%~bSYbG4E0Xfx+m-}Y#yb&5iA
z-oM|G<q@mH!dmjM*HM=0t=K{-wsZLMR=``VV|;aIUq|GIe5#wr+#k=%ADOA&U2g-6
zKhL8$LVhq3zwLILimFA3$^R6ZgsTb3uivST=|9R&6PrB$Yo*kab@*j7hFM0?<y|2E
z6P20inLey}Q9~3#0$uUD0TmpKM~<G%!5RV}Cg*{V!r*+HpS#y7y3Cr@eemFRI7?mu
za1e#U-I9`csvoDv=Q0l;I+O(qw0Y~+VyDpMd#cZYY|zI`4h6ej3--y?6dtgt%FxJn
zUNvylv!(djJ$(5ZW-2+Ohg4qopy(&lnfm(vh1}%ot6Rs()!%SX=f^ex&5wISS0(i)
zH?n)_iAB%ri`s{O9cVjnT%ZP(u0XN?1fc+NqV<|Jte{s*BY7XZ>v*aqVcx(&+CMI%
zz??`hW?M>Aq6xw4$nibyX)}?atmWX|b)U62E$xTX#n}{>fIik!r&ix8$=CIzYE~iO
zNx{lhZbsxVUDBX_?OL@)7}iRdnOZZDbO1cB?VV81BvbDXysqHbw=F3^<X?2W9gFHd
zF8Rx=LP4~QurXxP{Hsf{==ewP9NZGK+bq-}JKp)8E-7*N^!{N-0Ql|(Y6EU{^~TXF
zsGW9gqA`TsCiCUdf|3xE=m)d8rY8Ggpf@3GV0~Ukz@qNHRt}m*4Z(aj&~QHCFdsO2
z^a@T@H}RdcuM}-4Z<o&0kgo_ZF~i+G6u6||>x5LRR;kU-#KqNuKma>9GGv@Fk7S{z
zr<76$aR+^H*0<wh->)jz`)xonaP;|qkK4OT1i^(L9{sh!%fR*UDIOE;m&uNilN+rb
zp+H&!Iwx|6pIv^hDQwIl;BBH@1K5OG0T&Ht&P<y4MZ|r8&HQWrd>j~@rf@FDmy|W9
zBXV6brw2Z2o#2E)f8+Av`tYpVLkMfL`wAoNwgkg$#==4I{Q-Q=XJ;p09u%;9s7K?+
zD}VMWfAdE8jc3s#YfT4jMbc}+FG|RZQ{bPkN4+JSUgA)??Mr-7la-HjD4u&yJfMJN
zIVB^bZE71kCJ}_fK(&FWrw4iDoq3EZl{alN**=~rHzM{0W;(1VPrmj_AC%?-PC$PO
zU7+B0tl5L@gTu{!r9bX|0^f}j4jZAjd_KT`=fAwyaof6c!g(`<#I=a%(0=#F{05j=
z5ya^glo7Ua8?d#R0njHWm<+p+^rx_j<cbpH>4y)Y^rDbjPkH6UW)u0z`aa)g#IUWs
z#ZR=~4M7gt^`EZroNsPDsgb(ofT>%47_e$#1Ze4fZS}OG+?<>XNTWkJP16};#yqkX
ztzU`Bl2;;W0-ThhW!SJCVJ~l1RxTbLqyPJ&%axZtUHZ}d!E3-SxE}q>zzleUV>0D%
zOuIuMenJg_+M>;Ebz&;5%I4j>Ls%I%gA{@~Z0?f$(4MfX5VMrAC==-g+RLYe9Yls%
z@OC-hTlV<8C@Vuv1@BTU+ERjZOPB-LTiq3EX{Ac8YhIz4y6|-2LavJx4LOeQI(MsU
z7Sd@o{SHP@!I;3eVT$%5Xb<F1zUT1&CgWgsY4v7QR<wrPy&dlc2Y;bvbiy~4Bo0v5
zVFub<@VJWr7qqfDo;y9u2!_br0sva^?CFov*0h{vO~hJ4O3>491k!M3B5eNq4cd#y
zSJ~7Su}Mk(1TGNb8rvyTf|2!r5Ucj=iB!9l$UQ)a`}d#z_^(%*|7ZbDhuL(37HAH+
z0I<*n&|J;}#eX&hur`aQ5ct+3SOgWv5Ci3?M@FjJ?gF2Bj_}9W#wP4)glY`omWI^{
zNdLgWgDq3rM4*om$*b>A&${*M&0ub5p4pGyMhzK9cv4=ziL~U*tVBC~pTW<6Qovm(
zE^dp)^wsU;7BsrT_g(oKSJGTpSC>v~2IBy<razxW=JPOkO*K|){b?%NhI)QLnnbrj
z(#<pXWUe3Zcig<>(dkp0xy-74@1B#!<M$^{o$A39%L~_H<)TMi31=orM4EwwQd$^x
zKORuoJ4w;#0A+ppv~!(##sXmX_)C+dz71^=g{?m|gYHkolO&gflP5b+^>;4@Z&Ozg
za!+VAy8l~{fniH@?ZJ{5G+M=z-${4?Hk^^zHzq&e%$dKKoeX8Toc7;8>|`HAkIm3R
ze54SLLv=^la-LC|HG+?2j+QiRZr+fQh<fb!CKg?|e7T<VcYTzK4s9sxDn3+F!-#xw
zfYRrFR7OS%7xqVcr$D8L-d>n0HWW-B*5O}~anY62ULR{y=82*pE+OHf=T6gZ>jdPW
z;8~BT;r^nOej@v0{urf0ZIIcc&yP$d!|+Nka6b<qvgQd*eYMdV$X9+J2zMNO94J3>
zqMexuM;(R%_`*&r0u)G{fz0GrQP*Yvf1<+QNvr(|(}uOSUb{>qF4#Si>BB0o4H)$p
zVP~g=q`_p?EH%}hCPN#(Ge}KKd&YqDYUYH@J;<ClnM9C!4|Qnwvc&+sl!~i)9><Pf
znF2H*>T85cyd0NdH`)puM2I-fd<gLdFjjTT#!?msU6Dslsc`{45D38h@p_YNu75|L
zNrs>x@aOvf&QE-DZil`>aRr}X6CLkJOUtx-=LXTY1C0BJX*kzhzSZ*TH8dg0D2>q_
z_)0!RG}CTwhdn7r)6pQIAzp>RU%7Q_2=hH{1}-`@ghM}rfl~9)qb~takt6fXrx;xg
zSTAB;XPm!+3g@R&cEdI`000nz_C#m9X7T)Ze;N*9RN<;O?A)s%tPW)La5BG~0>T4(
zrtld7AvChIYz)lXJ*MPl_;`E!XGC7J5hE1jWAL!4#15WbKR=x!P|7J93gP+5n#e+%
zf?0X5v0Gub4ppRy!e)#L?e4Z3rxX<#smQ}EVA%%ZdJD>G3&73PjEvd;_n@tZCqjd(
zc+^>^1T{lLg~j+v9!;>GwmBxo3e4V;3v%95xx5CLt0l8U14xI9!3G#`Ag^l=7|>mm
z3JB^{b#x-Zx~7h{xE}y5tVl&ny$eUVNm0~_Ah;WO7_~--rV;R3LsQdfm_r1|M-d1~
z8fFgYy^yL&<XK}w!_~uA{+ihPGeFWPh0WL*Y;YU}PWm4ONd54Z*v*U<3jiwZHm2p;
zefZ@fbRi)eR!Opff!PSoBr;BNsYqE{-Ji<kl+P(qkT7@a&7k?0s1$M-kF@|j6;&cg
zkKoOef^>pr(%$ol<%cNf|DvlklkSz4_Eu3*PrBDc5N8*HiuAo0S78U+NhF>$N_VRV
zoV!|55=~B=GVgPrK8<eOR+{|X^8<ppx(X+Je?oPur(M2w{kp1v?o7-H)IbS;KqYn3
z8Ly9PMn~&xB#1_!kT9LQ!rQx*^z~RZo4y&eg#;$*S?T(Fd{)?u6wlNRZ<82={sV3I
zra};nVyemlbNNw}vF-Q%tSlW>iPfVbv1aj$t1YjT9~~zxHCe*g!6ACioH?5z?GLGJ
z<h_LP(<)&dloVXRMOC|ZU&A+sz;fDnQ^^>vcmv&J;Jd-K%5Re~M7#$;+)3Z39l<UD
znGopHgIQ)ecK^~4d1k04M9oO}xo^{<XWzcfd6mY*o4_4MO@0f_F4AXfN>&VG><2E&
z_{;0pH*Fdos+<EDWi#{T>sfMvP%hGl!oqQ|EcF2cxMB%P8;w8F-N|f?q$Y5RyCJt1
zVEK(VeoL+)UX~q5Hv&l_%$vci&Ae<SoGa=D1qBHkD=IEfZBkt#xV#S|nsiUloi8by
zrA&WxdU=meFJAcBPM8otgT~}#{)nN|B_VCtaGn`ChZi3#JBK#l|70>PJ3D|vA)FGD
z(=3G%s(Ze<(lvdsG~snQ@}MmtjJ+OwXVNGcJc?8K<JqnEbg^b|jCE^Y2*?EFXI*^t
zocOY2wUv-0)%ol8h*q2j5Y%bz{Rfh)=+XG-8<Nh3wd~rX&ZSEm7%ZDGWlA&dCVkxu
zJ~q0Els2gdIC;nP1p*VSL?}ATpnB(g<j?C6Xn`Hc@D9b{K>K057Dh?viD$l3-40eY
zlDCGc*CnyD9o;SY`p>ir811C(N56mj=q!>TZa6$pZRgwl=DN8ZU>X}{TRKCK*O`e6
zMtRb=^H_ujppt3WxN#PY_}vhHLVQ;Mc*YLM3KLH*)!@A&Cd%^ENo(JzsOt}ic!{Ez
zg)rF?Hh8g3@KS{4=td>#QDF$n2uduoOhY?w`<Ga4wF${5=%UO-9!=26<)YE8x1<_B
zq~iZ02mnles~;wZfnG}@e@vvgqy!hy1y`++v_I$~^ncYLzLnM%l5g{_UCkhvA;hWi
z4{tj;f03uBDNGq}NLnY7trqPwFS-`mQW77bcZQ2gT|x&J@mTrSN$@iv0)_Az<VRAb
z+za_+0ZF{A|BTuY(2JPrI;fI>CNx;4_EbmCZcjSsC~YSa!ycan{}+-(Buadp_Nh5X
z$gvlIEXV6^JnQql6~HNBL6}vhpL-tlyH7Q}hRTHjJq3c5uzQa#sha)=$~DW|72{UT
zevT^!{Q|2We)^u2@UW)(usZW@BAz7>2L9-&cM9QREI8-g%(+`9mRs$p|LGlcfRlz*
zt#$)k8ZyaokVi&x7#C>N@B-YQR2d>s;C)FQe*a+f6lekIR=}KOR*#Q7GyRJc$_WW|
z$ilM2(*BqR6Ck2)a6G=S7Gpxw6V)P`#q;b*D{CRuG0D}dU!ePtQ_p~26L@rnmbM=}
zxlR$;=~H<iBF}Bt?rQnRH+eldo>JA3yF>#EP#Z@9I4|1>Vns6V&70QXr4Z@oFJCTA
z_*#>4bX3ayAIpb#rYze)Q9f{2fLlD}aCdd}hRh;m;nE{e0sXhA#AUv!cb`75JLdiy
z)W$^sUnnDZo-xcc0i3cP0e@b0tbPwVHu5r(fkax;Na#Yi&{@~F)#6M9b<k~0A3YHt
zQJIj!7)n}kCQQ^&8>~a$6!Pxs{9Hs4)N*TJ(0@#wIxzMBqfipy=KOgD;KF%k%J;}z
z+Em|yZ{hlGZD;2^tY9{)R-Q0wb$oH@rn}K2SD)Ksfv$aky*vI0$I(MLf5x(4t`zFD
zKXL&<=GyJeizLd#f*{g!kP%jqWbTKZP2n=LkNh&tQhn-mm)WzOIigP63)0ZoQToU%
zC0=+?5LY-0(x6`X>IPzh_d{vb2ZNg1lwwc?ajB`_4U`O45IWP_mQ!nmfUVBDA8PT3
z6I}A`(17XJ+Z~KbRuEu=+`z+3X;VrZq9MG9wSz<#ygElv6ug_57n1#a1`}6^le74x
z(!5Q4N0&bxt>n$3qM7?Xwp0M=k_jRN(7Q96#`Hkk1?C{Kf22xIzI{Gv5WMP!X0J_3
zDh*Hy+TNAcz3<jQI>w8+xs9Q(%#a)f`UGE0L~}F}4o7q|h$33TW6^q2irKpZLXN)-
zqeus~n)k)W`$Hfdm|ly^=r1a_Ey1nMsaYw`pEKt?gDP~ig_=`89W$eVlQ2TtE&~fr
zm?Y4UuY%cNLCE?4+lKlx`oE4pM|hL{s^i6H=zk}mJF8Djrw6UR$n)pc)k2~4Hv{Un
zju8{W6%y}vBO@NL(NpwJOz3SZT{_>2{smUyCd;=G1Rg7Qjq0=Oe@-$SG3i{^C!I?q
ziotfUGOX7OZKJ*K#S&3o@m|=oQwMs<={~Ch>*9ED9?-9Xoj?O^m(WuR@do48F15k0
zq9EPr=ViFl3A2KrqM03H^0N^(&{USB?QaXr)tFw)3~W#);=m-#=dEC%?jq18Xb+8y
z>#@9E=gW5J*L*(+SNWXt-en&KEbfJo`HZ6;xx0QXGZ2E!5ajl~S6j!Ox=775FVt-0
zdIfv?Ri{o(%(eSAcg;KQ_d;q=B9}57bKfxOSepYaa0)N5o!){@61ivw9UUFz2I5;Q
zVP@u$m5e!qP<8t=OVaxfKX=DHT|l|F_mnvLXkhqSi)k)pgqY)Xk;gM>m(!c~??brc
zk~%?uW*m_SIDO8X4SZ@k6_XdQ-|o9iBlo1V)SuFu8`qU#rOOYNPGPtLM1U|S!+yKl
z6kgFiVW<Pz%#;Bv{Qim4bnN2y0=4tRfvK@Z_v2dBVuXjgk`OWezZ|Gl?%!HotfPY4
z_?1;~TyD__fC$}69o@&8^T78)rX9emD(E<2@@miy0S`FqKW?683Ly~v*GMa?P)-kS
zt9upOv{{c+){$?GLiddaAwmTR;>Jqkx?r+g3FtI|R_A3qJ2IOiI(^s?Y62sKCctAR
z4KL8cSN!-q7t(e^=Av={`H9>X$#TrwY1>vI&yjeDJfPkDOTvLd@WO$LAn!`~fIez!
z^(nb4Dl6S?<)zoyqe$bCK7)jZ(%Xh1&BU*PK|$;G?$v_QE!eYXBlGCGZn?90I6Mdg
zho7l?^8NhMX%RvBX1>;PxdApG2mV6nh^0@Pm+jh$D@`Nn4E*7g`Z!bT$-8E~r)X}e
zRIc_;KZ<gS53=LiS7Vzj47lo{oRx$_Hk5gXf&wFzllRk#?%c@&R;P;-9)_AR;WL^v
z5#sXXp5UnA@;Ney5?j=MOgk9T+_c|&Z7K85)C?neC5UT+ispgWl0g^3@$#%<K@)@S
z_`yHR&jCW0`@46y__a$IWT{+t%t<yd!sLU|;k@kH6~&KNxVdR!s=o*XpGgT!6YBiY
zVsyA1t5$PV9#crj*i%0ON*r=>bB(4=>w;=ry?1Y8U{JzR9co&t6ro2iT}m8twvpw(
zxNakNGNMQ;@%D1?S^Ek&9p&ssj{IS&tQI$J+&I4MLuYb32yK(EHFr-{9q&-}HS~E#
zW8E+9Y+Y2Gb9QU=Y_Hs1H9Rx5y-R+ZN!L0L_~P5&P1ATwxca^B?Zf7q>NGnP&_U;2
z*{|w~BKM$&JD0p)Qn|c(VCOwmCmwAaTBcv@I|Uc!26PcFK%=O2nFPItvy6b2_^8L@
zM-=n>#lV?^{i=scDGK5iKV;kmjFB2OYgQ`id2Q`5%Bkl_yP<ALNfASL7jRA`yyDzt
zj2D{e=+q_+8;baZbgS`~JBlR&!uW|x)K5>;Zqe`2+i@?ZujgJdn%<bzzPa!_tv&b0
z(|U%|NIZD(K;3RnQ*vq4(1Hf34w;%<i<xvE$X5<wEkeN+WuISE6eY@XET^bu+cOHq
zHMGBGy03-nkJCIuvV@wR-q)yXg4MZ#2d-{zKdx+yVXVHx$KMuV0KBW)8pP=AGt@yN
zlp2vz^P@@O@fK&zp_wFZfc#>}qVCbj(E0?d6a2r#<m=ai_$4ck{_YETAiySpMv9T(
z;NYye*LVN5gI;tYO{T?;kxxzhn3CS5T+%76H{BLZ*Lu`!ISUjKi8#qD@WhG0GCZJO
z$|t9!0epd;Z9=K%G;^ldH4yCW?tU*PTg~FhN{5cBNVKH<{#hI$Tj?<N9ys<EG@R(Y
z3eawbn_Dhu#=&F9+TLHVX;o-+*XXb?L!AG_1_1bY*MKFBEW2;LwlO$(CY%WkLHPFV
z7R=VXV(1ciq}wU)k&1N<|Nf8lJ_`5(s&w=zJv<_pMQc0Pr=NKNq_TDBriy+@Jrd~M
z@ivlDKJ|G+cL}5iAf{xlot#T@BNCkZQhx-v9xQ<DKSr;Ud3CgYge@`)x}|Yx<2Lel
z0t4SQ2ErCOK9WZ1h4B~=dY7C(2ly_mX5h*pLynM4fgD_otBQ!jsngEsBldIQ@L6UQ
zvof49#fca<X5FB`PQu}dq2K3hQ9Q7u*30~ud?0Gtj5v09H~wq#E%_7PN5iH~6A4?k
z+27SU=9l4sFnuLmCw%f7#@^nbPD8>Ono*)gCXeka^d9lF{L8X2-{ou(o}hrwRNnQ|
z^F2HN*=zt?gKHY|x}?R%u3}U08ZNg$Mybzz4uEK&Eu|lcvAq+l@7H{0?g-<$ckgNZ
z@_On=hpvuN7RaP=&7__U%il}UdGh39)Ip;D=QBcrgbm%I%A7Z^wTw$=Y;24udVfU+
zm>bc|fLTAsSh=FgKxXd%#Mj&IPS$c>1F~$Tt)p`(KVNj-T5lg%g|USS`gbH<8VBM`
zR(?LvCqJGMtpgZ@$s)Ll4&}Z7`fC>@+hKqMD!7Tq7N}sf8$R@omJo@MWB2f+Kw&zI
zuAlRN>gu!!8oB!AQ6-$*n*{|~7cLl1T3)v&XFQ(!4zRi&3b<A4)+QVR?uHA>F38Sj
zFJ6d8gT|yoiG_>m{pZ9f*4?P%TCk2+VWIN;4BVqQN+pGK`*n>UA%qX%pmkoHTRC+)
z$sGl@cxc}{;;IC6;y2eh02MDXS*g~zP1=m8BL&>IB_h8t@BSV?1WQ|C*a*%&`W~oh
zfKXhpI7P+t)P^WS2n*|J&YwSd65Dc2_$Il-;C7pK?NXr~=}@)Y3c~;bQ`G3IKGna5
zh~)p;wNY_pThwi8qm`z(YvI4UNk6qkph7#rWy9cm)PMPyurFK_@cj7k<JS8fhrHEE
zxjh%-8dh;_ri!T`lpew&BWdiYrHd9pChw$Iy@~CnAQS-s*=8|SXZPf9tr-K;XJBxy
zVi6l|VzKhb&{=+G|CFD>c`>M>V&*Fa$G?8{ipt0wgQ-FreM`E>RRz^!TwE&7RYfg6
zU10!vK$HkzqgWJ<j|;&j>6k9jx8X5=(ko9*d6FFW4!WE0n*;5vnKaGdq+g9bwIyA^
zTB4Z7%)MD0X^9ggsBpc2tiTLEJS>=@IK^)?Cy6dvx>N?MwwyK;BkQckk7FR=ZsOiY
zELZkki7P9%NX|4+yneJ5vS+Qe!^mB)0S1^Of{}t68Y!aP`}cPc6VvjRe1Jb<{I$7!
zR$lq*`^WlGqrvTlp~i~`D)TUY+QYZ7t_?Z}SXZD@n^|gxwdv>Kyh14n`S5HJQ<kZh
zoSa6W`-_T`yEa_&=RaAqX9>ttazrMzQxi_x;g^XtV}jS=fQr`x1`gEL(@Vz9Yv<ra
zMmmaV+bOXRGmMzkNI_a{#B^PJYB}`Xim9k6B!?^oVdN|sTPe%2`|gpATuY8<K<{AB
z-`ML`?0w=B38dY?SwWW?>4uJ0d(P{i-4U_6_#H58iKG#gcqq=q<|;NxQwIfjLYj!9
z?ujicUKjMlckBYOVUdT&c<(d7_qQ-Qc>m~3Al-{m{?UU6#n^n_gX1=FWwmjL+D6mA
zgt0SC`}CBGs@4{Lw+^J0!^3WfS4HfVF+0vu@Gt@#*=O<=u8x*(GcV$?n6bbgphzVI
zjzn9(BH4$#u@&HjF-2>yEzHof+0g4vB#T#0vMJ_Svnet^2d3YIv8iqzku7A#ie=j8
zDGOa696y+qf6k|U2fg)=S7Mj0yz<v<D7(<del=$fv}6c*HK~*Mx2kRMvjN+KsGOl+
z=dhCO(#Cp*2WgV>p##x2U%Guef*k03r&vvv?g2QMQ!_{+<jOYA2#bi2NoB}i{J9+Z
ztPj(jb8{64_W^ch`N!-FY83wmjN*2KZ`{OO*MIkK4Kk^Kla#IFa`QKl-2oMEz{n7s
z)@F6I(Un;j{LFjcprgZ&6Au|XJG)fpGcUnRdOIB1fZmGl$(TZ!*%T|~#IF~c#Y13S
zynA;Wax_#!DQ_LutfQH}NNpfOXqsazoS@w?x{qfz>si+7{~kn8H3VbcxR@AnkCH;F
zOwmGMff-FaUunN=``%%IH|UFj=3}W}ZL?ce_Zl>43qVIJFc#*Q5ozDOf8Ve2MJ{KV
z?u&mAzP<s%(?xl&njs2PpRm6ZD*ti&9HO|zPV?uFVHi{0CcZ9P78TpxHprp~1-CuV
zrKR?}#Z%&^h+HHE3&O&Wsx67%5MT@!NWn-s%89zo7F`?ykRp!HQGUo9B9_W-^{jl>
zCzX*mWijTjw{((N?p<c<*SG<$pU>gleg59P?Rcj!mu^W#ofz`ThQd;k8znGA+GgYm
zzmuyt8KBr7hwaeMm~zS#k@tY@Z>i*7zxK7hSaz*-g;R&jAK-0Wh~sY`ota#&-sLTr
zCpDF@)k!+ay9U>~b7$e#zUs%9)f_%b6yf0$=J$AgeC8h<SF<N6=`y57V|S-k>*7UJ
z)wEszRY>|}R|ZDFeLPs72G=ECA#>(jCEld4CCj#)f<~!RCu*$Oh0oLqq`P->vqY##
z@UZ>%J=aY!D#ryXs}3)WvMJ%_VFMGICrnfv@w%YRW(#_3MTf;FcCtcBN+k&jYzWJm
zJ7*2Yvp<)V>5prP77>gB)F*1&W_#!HZh*XIJT>j^?(PoKn;6p5XH|;@ic^lxYtI2i
z+8IN|VRY|AU0sN3W5#eO&7K3b@VZ-bn<=D%(eoUy==Yz{x5nBSi{iDo)-#>I_h{SO
ztS(`7%n+F>Z+7W;`%GR|eQv~9c95Fx+tMc&lJz{9e+Ztu&@9s_6pr8k-EDSRS=nJ=
zCHmBj3<k0WE{>n+{_8HBq}XjS_}1EXvfb&O)wL+gb6o~tqnJgxGK5tg4x{VZETf2`
z2CW42h+v4DN>0o_00b;21*TZg(E9J&H~(n|qcN_{>)j>GGvTxIuNC$)o2}!4j!T~y
z#!3Z~r?dM}{BlDrH0Hj<{%HHf@Sda4t*p155Tj*D7tJM7gV&_UQTK7$dx-w-&5^6h
z|7ZcGLD8(G;$V`gx;VNqZ5OT`IYhoa$;nG<s(q`!4|;GvTK^h-_c#6P7=THe!OUY?
zbz!}pJMe9w+msK*`Rfh1PLA2F@0%9c=;4eRH_r@nnYnuR?yS(7c{!zv8U7X<KcG4H
z--7|1hz<!^E^A_ka~hylWUdeIiW|UTy3dwJ4A=$HixfuUJ_udpQP&F?{&B1z&=)OS
zXl)rBstZ);`QgzR?wsv{cpLk*>gonRvqhv&WqoAcy>RlLR-fB415;U<Rb0FkrHe+=
z`jZhkF6mRxL_^EskKYUgzwpcYQ&{Z`gj2;8CXiQ2=He!qtBmprXz~92edhZpwUzVY
zVzx7BuZ=Dfwo;g7v|%sFWJl)T--0P5?Vu5ED#NBZ{&Uc}HjGZ@I!E@KwwtcSQl)es
z{~|NC?eGB(8@lOyU}ics-AoK6=r5ZI)Qv+N*uxsg6_#j&Hfp60QI5qm2^Y5Q<O?E&
zYhg-Dx&)3H>t=R?H!cB_@-Hf`i*i%Tappv9qa6E+`<1emeGn01)XuTKNy*9VG7qI>
zz+F`ws~7}cgmjwmp4Ax{A7(%9<c;nJE#rD-sW`{CQeHx~#|%IUB|Gd7>79D9c!+p(
z!KhmfIY$sicX;+t<>WAt%`wi2qTfFE`=&3K+fD=HF(r&MKvO)qS8-|t8e|gnC}<uS
ziflv;yn6}+CdMu>t<BYgNyGEDUkXhwXjdWum?+bB|D(}XR>{<{pv>ABlOR~RL0KeE
zodU<-gE%pYeu=tG*Z>X>G;x#UUaW=QPRLEInOL{pKoqy=K+4;7>4|C)ep~iMCRQ0v
zn4lA&8O^6=F0h+{LCvl%U#BIjHd%8LMcG9rGYK;|GaAjA^NI%(&CR5X?XRcDI;-E7
zbDOj5bp|00`pR&A^vIb5+Cyh1b9>xwP5*w7ux|zhk9~lxS*`Qu&#z*L99xMS{CSl9
zY-}<F=wVJ=hT@WnY-S^65Un&9@FPo~oMz2h9~v53Fm-lyTMVN`_(M|fz$b@2Kt^4P
z1B$Jg(xdph0X{c5dxMv}Yzi`H<Js9Tc>A_(G7u)5xP}H`F6g8YDLK_Tt~T_^W#*^|
zD6OY{Yx7TktEdyfBcPykWKCwdy1NIp3ogukrmjts;ZU)Cq?6>EgblqhyAS!6pfA)f
zO_9h1<ss{yL!VEdl24P4vtCc~IGu{^K_?Rhyu8h6;`x5e-79tMIO?ENm!*?zpTi%Y
z@pR4{t=0pJk_HVLaGx&oaGKPl>(Bn*Ey)Nbc9KF;20_n?R0$8>8DPX6zJ72;@kJl{
z6eICN(TFL9?@w(OPmm#A2hc5Q{rZK?x#(p9SvIlKqM$>jaw-@lfwzF-ob9-ns+`Lm
z2&Q>vz^$tJcKRPETj&%%=Q@A>^r>+#pUxOFQO3|re=7NuFF!N=sgar4pPA#ly!JYC
z6cG>s-vr1SlovjR-qdAKbLazucduV+Jj=z!`mE3LB;C6%F00O-wGF9$%ZimXl*+uK
z$}5HjG&PFN;*G+j<&yKmcOBySc3Z*j53b=HjMihDGf8)>VCBoJE(7Q#*tU4mA$_DD
zmJiOTCwD+K5m+L&MMoD<w@~9w+u_o$wM<l;J}oREGBdl9W`fIzofC+Y4cmPPN=cDJ
z%lGqF$`qM@QM1}D>ujZp2T8FtTM-P0CUbgbW&^o?#9>3I=8Dgslem+%*-F(<*Q#wm
zguR)5?ABS|6*J3P>KOC8K2|VGF=z|OqBijvQ(ifR^x-d<ESQZ_<`>EUTeH^xo<e;a
z5VyjUhB_J=uMfv`O>R!4Aq6s&#-x9WjosT#;lw?7jS=u_=qyWtcxhZU&J6jKMB1+n
zmx3;pX|_&sW4NM_(of)19Q!5%MNs0T6?HVr6-|qgQI^(T|7qblE(+2g@u-zLcivy_
z)tI*U66JzHxi)n;zYJ-ucK`lpqgO*S9fF)h^C%`8kS6g%K6Rl~HI|5g5}X#k!|myx
z3WU`@vA8GI$hZ`1!<in>pFc<5kwl95J6bBx^N!Rgs}s~wFN7vKY3w^2b`z8zr2Rqs
zCa{gsjq4bVlBfCol)5tig&r4?vWT95c4!RaIJJ?zCsjsS!~iYPJt4Re3oEWLF;W!K
zoYHJ!qztDpgrboy30%x^DJ*%D0^#=Rm7Fy+ciWYjvuB$Tk(nTuOaR~QU#yroW8S<V
z$G*iWQIGm{G>%%P@AGnGb)*~Zjk~X}y|wiSnwW7r%@vi+==;DR+0+wC;|3I<m=|~2
zYswwgIFuJ><O7OCo$Tht&BSVqO>T+y8KXFsQep8?ZOy*B&_WBrbS5Hpd=8Qa4xu&-
zPtt;RU$6kcDOR9DgvRRoLQaCCpy&~XhJttwO(lui@42p;2R3yV>GJO3+l9iNE=4RA
z=$iU@=sfk)e|6^>1J0xw-Dms98GgnRT`CxHCxX83C9(wgA{m}TeoH|6V}<bL3rMiJ
z%7lLrz;7eKdDQy%S3Kdke~Z?3Qa1qX+Cpvp6|kN{Vj7#8ii3;C&it{!ySy);yKQK@
zmJlXo1T3c###j`!d_xn6^%Tbwm0Ip|Q2xqH5|(3=U$~ow1_rM9utSY1h(P7~Yw2-1
z(&umAjs`HGA2*x)^Wl<4a*dF2k?dfILct{^Gs}XEv~j8N@rBVa^#N2#;fSrUHb4mr
zYHYRxn~w2m<7RM{H1~C6#Ds1Ga&vs{cmC86QU*R@`uzF(B0HdLxWrHwtGyV9j4Rap
z*%~q2SPT_HIZd{#qeD15_2)K@q2Ac9zrKEWNZ26~P3VmI=d{6jw=rL_v%6iq$EO41
zWb@|zvdDYM$zrZ^4YjDifDF;J??3%~ubSmPDL^bToh^ZvdW05YCIzQuhL-wPFjECe
zVhSp=XF6R>bvC#ig)@5g`gIQI<<z+YS~ZJbqxO?HB9=o$6&ZEpsF;?UyFKMLvvFZJ
z*I21#%ecbo-TYu}9x@DuD|?a(%6-zgc%r_ntPCHT>o<S{hc0l##*J}QV7A${q{xy3
zL7z(rnq1h-2+j+~$5j-G7&-5&EDkLvRIY=0q2AA7@>YCKsFiH4jnU!Tas{70d2*g6
z8l6tJ{{1)e=m0a6lg@N*tABk(N8_0TCOuW3Xy_F~nvls5W?*P3QOB-f!V{s@H9U&s
zj(|(ZM7{Le&l~@Z)$sp6++<fcrFAa!Ws_dcsZCBe-Vjt!+i4y6(_DlE7Z~6kvg9TA
zq6Y^u7wG{uf<1>1-^qcb${GnLml#s-^hEzo^r@IH&?K#RSA&rAHZMrT5}BuC_o-7v
zCa?!MLwDdAa+nFX<Q~#v&|SMlLoa&`$(#-B2_1x8XAb=Iqr0bLqN6SGjWMYCHIRGA
z?m`u0#T<@HI<H!E-FmJ4aIgNDeyI)`WZ%R6k^zJYzqbeLaZ25r;#u!JV@BMOs>~xt
z{@}K~Hq;h$ix%lHaDS#>^T^%1r`~<Qtkrym4c6n>3s2k?1BC;x2kPp6&YblF^jVO=
z%=K2l3+(+EO_`z7pwyu1^JkM$qXNbAWkk<0@!sCvxH(jPE}k}!iz6@!3&}M0XwE$V
zj1$Ma7N|gCNaY3NwJ9&FDl46M^{6YKWTra9$81%P>gscnm?6Zs0G+^Ufxm(Sx@fYx
zlw@ebLOA{?YC!3)BwPYO4p<i6nh<Tdw@QQeYi?y#eD`x@zakJwam+yOmg%bK-_}5n
z!`U8NKRUEMU?P@#rK153yMf9{244XLE%zq9M{+qyBp+YCNRQ6pqyrxf43QM_#T1}v
zHbF`L20fJI0P+c{@&u}A+w7n7Tyq`|^c$qFzZ-aLQE6^#7@d?fN28Vz<U^P`cxy_<
zMa)=$QP6Gnk;C`?!6e7Re}ka)K%`~KtZ8BtZ5KqVg-Tg#E-5d17Xk<@3VL$d3K0Kc
zf{--h;(C7GnPpC~vF+$zP?w)OpuH40&25OqSHuJ)n=>9N4pcbe--$%dZAjcik;V*R
z>T0h0rE`u|L$IF+KC5AX{FQ@5tFm^qTAisrQ!oy?%6DJgwi#oAGsu1mzg5ft^?Z#3
z4v8rqOAnJTb2FNfgM|$uh&s=mtL3rNO3)sTyI@_fi}eYVgxP~kSF(B_<H%5X_I!76
zPzzUG1=G;Zc|d*^W5@2{5?Jp0?2h4$Pw}OEfSw6wYZ!=(&&aSs=Q(ufP=BR8j|)G!
zPM=<J$K$GP#I;gUitrl60D0}&wYhF6)dSd)!l%6eOQ*Yd&4CIdwhzc40?l~j(A);g
zhYVT94WmYw(C=oEe{9#JPW^u6L-AgRWU9%nvV{iPJ$!lh8JdRQym+3Ff3_?lBF*<&
zpz||^I~Rc?C7e!c<^>{G)_I2Q7HHcu+63Oul+;Z9EsTAjSQRKLGlX(qdKH$<TkbuG
z$_Xc!6Mi*k9p<;#e617!Z3!I!T~t&_P*XAR6GoWQ*mhdJ>n0JGm6uzR?3i|O24!&b
z8}o&4#g=h@PzZmnfsAowMi2jW!pnVa3T+6=ggYsx?$!M)r32*|&w)KsTNzLUl{H7W
z{Hi2Vi{V?Tn98^P8|Z5HyK`4C3BdVLDy6O2ri3A3*pVYTXMa_Wf==>u8PJ|n>Uh>?
zJ0X5!#_Gm94g7YKuaLJ23PX|$UmEr66s)%}2^c9nF6r91-y`cunQl=fRu_IM(`Eqt
ze#uPr;`Ss{z6ySp8Zjuc4?07{?6O_G`0N$5Oqaj|DeVs9K8nskI#$|OnwCWo-+Cc*
zOhO2NBTfjq5KEP^2>Es-;Z|+i1~64-IhS4+uYC)FCngMS(Q%M8<4ZWSNks}+p0we>
z&ZJ%z^Ua#q>5ydT6n@=V54QXRzKR+_S>N8uss)CGdi$5?>FD^BekI$l!I}tOcMmyU
zPzOF;O|e1a97IoRXr38+jw^WmkcTUKtOa&JW}4+ux@H#MPfZ{~g?FU_>k3MnNEeU1
z&rqZ6n0t%QZ!SjbS`L}|t;_b&>lp_|Rn*t#{Va|yPgZrTTEi}VF@6x+D`Z?-h+x4F
zvts9vznC@)C(S8hM+|6U`-XL!QkfyLkN3>;rbfC*6U>ahmTyU-W(VUBkIz{_r`@G$
zL-}Cuu*+%@%1qXcUtd+L4jI_L;LUPx??WtqrRpnki%%OzJHViXI7|wcCTER}zve1$
z&M-EAkroIQ_-yD1_%It5_oX`f4tjKI#dC5gL#3(R11q-66cvgr8X^w#RdS{ni4pij
zw{yaAEI{xpo(+f^3tmT$R{A&aZ8oRM8?xd{dZG5z2yjLJ#;uK=<Bg%F#J~(XzV);^
zJy~ovi`zhKR3Tw=3(*^e4ZSmr29$xcqOU7=I`*B7x?4Uw^u^w;+sk3O%QIhEBMX(L
zhGk-=k30F&`Z1j;HFL*~t7@u$x|3!{l8c4hW4K%PL9IzN8OcZwy^+k8Iqw)*x_Ah|
z?o)ZusM5T+3a3#Hn9!w8Id#<b4e-R;loa)(I|?+5-cNV9@-Jmf8J2(J#!JeA54$S2
z@7{d_{Gf3!g^M+MzSW0M+`e?_Mdr)=ty)hEzMS;s4T)pMojY47fZg6kUnQ)C!B6wP
zrC{RhX{O$17ZEd1V~Ag_q&pzbWH4~e)IRFq3?AmAM@J65(qP4>S7Ej_AqGAT=a;Cz
zgYV@UF}LpV^h+>=R$$JQHCHz0xCpkzZ4>)hDZRejt{m5s!9y+@I@!BS?icJBiT18N
zYYPb1_NQK2ufkdkca~VsyvUd|QaErdNVR9m!!r8Dbxb+)<z{gzEd6#JBPZelCyOKq
zVl{7L>fk^uf;-w<eo7KwM#hye1oSwv4BqQGGo5$~MKn@Uv!?Q;i5BtNA1GR@^3lDn
z(SJJ0+DNzU$9H}@@Dnw~^S`S(1QEnpWS=)ERz%3keS5~N&*evtcGDBt0Rp7<X!1{>
z^BKe#E9i=0->rL#@>U>KE6kWSt-M`K5<mLcyLWjkQ`^8mZQ-I#=|n#OsVp=QDLmt+
zml}HfSoTegyj(^q5TXQKn;l&}W%lDAAL%5>VIayW_FA{A_X=se@_oO@r*~>QuQyGv
z_TI_{F6FU4zspoF_!Zo`6~|M+OJYRStxbu7`%vT{975EYTDVAm5~UsG8-Z|I_zynq
zwjDdPe*c_}Hp61fn55X)5l^)W7}%ZaTA4l}qq7u&RA{kO3mH1TkIwnkM77SUS?~kV
z;HARCPr*tCQ4hx{+}uB97|iA+@mxfKFHLer>Ku?FO0?SvW-Vwo2Cw`zxLF4sYm0X@
z00KI3Ip!4aSAp%*+~uVCYZ=$rzT~9mOtI9Udl~oad)N1RcFhDmUG`xtJ<zJ$v+j+u
z{K9tZ2t>}szemMD2cnSLBefZ&Gt}A%kVNPo>zq&LDV-JpqRMXJPYy9o+&lWVlovzx
zr3v_m#F%pdks4XJXeyRmmULo*rs(TWeVVbl+JZWhYa-T0Vors0;IfWyEH?&S@@i~|
zZUT;QtYua>Ddh9mzgq<v9Ycf>%Gf$XNRkJL=Jw@YCMClrT+c>Gv}a65z^)WFxM?nF
zR9k_O>u!|tLK|W7G+Hfzb3n$vjfE=6OxzdupnoCfIfv-oZb42ZWz76NkyHs&VB>5*
zuuW_Hn_}@tqX;|5mX?pvj*UoHGR7;T&Xo8}uC<qRq^$Mjk;w=*UhgU#gb?U$+_2#Z
zA0PZ_Q`>&k4j1Q8z<sa&`9W4?8@sm7AeD)Bhg50<$&XLG&dJrZqz#rW``V&<_vG}6
z+BD`Fh3muP$M)U&98Uozh+wOkSF%)j9dWgEakQTM4J0Ocd^yz|Ys!5F3Af{%Z~Nx7
z<4iwZ4NKXoABEN|yIpolZ6(yixyp%j?nDy}z;rYZ?v5Y#Q<)LC3K#!&quc{`E#*~+
z@er$JEci7HojZ}41U5zWX<6Lk<%<`1bBa`(0bm@|rq0atubBlzg%MxH+j|2u=YH~v
zpn*MvK2LgW|Cl~oM{aEO<U@<!KSaFJOkNNw9AZ7Ropt)_)`bpe_{nQ(0ANI_0yt{U
zThvyqV=b`AM`si{^#ey?+qP}}ov$>_oHv4*f%ec_vv~igUNq0_*0jHVF|ea<(`L=6
z<FZ&WMGYs)X;YLSlMcBw!cN}S`wS(V91w933=VF6v9wwc8RDGS)KTym{QeYi<-xjL
z;o(`_F)Dy3?80^CojFa83O{|=un<WMrB4->ljCQ#TBqmDv<x5a8EQ%pjqoj7OofVK
zJV>epqC<x>yGQ+-7FB)&;6-Xp2!WeVn)c~eJ7BjgL^NPA)N6;kMdaXAsf2ml6ChEy
zdkf=ph)UlvN!t#i2M6nayGW;W&HJAy5TzIr?2hY7C6z?_zgk+EWf3V#>07sKo+Z{y
z!O)Wc-Lqf67F=x(7J_Z0IK56W!%d)hLZR#Ks8ORvIS!@M0R*ULverp@9dU=D9kuzX
zyXb=`OeCE;ImN5)od=)<3^Rby9!qykQ5r&KA(ayO!?Hnsk3fy#Io?ENzj^)oOy;es
zm~;5H4`ub>Q+}e1_sEDRTKuGy3vxvaER-I_#-!6;2ML$=uo0AOh!&E$)JP6bTKZAP
zzS$sHM65$}9kR6UP)SzuDWVTi<0U)|qv7V|gFi$fMWae<)S^W);AvxnnjEE+i7n&f
z&tEZpn%%@*&{UE@<pn*RhHI4R3S>%y<lBR=z!$bqvDk<H;b295{qetleP9q18bB4e
z?X=gTsKQ_E5b-ccvj{*i>QhiknxXP}$QRm+oCU{M#0VLS%$xC^Wl@elWk8;%5f2Q^
zaj+$?Bo!Ab^T6=>j3HVanw{S{_{WegZQ5L+YZq&K$`Du#hXlQfl!Rr2Hhd{BYO;Ow
z6>{GA?G}oUMyW-}n2M070L(xXO)H!}1F66%3_>8fsZ0HTa$>{Af^rc5;d|o>Z5nem
zngdD!6?ONB%)bIKG>KUQu-ACPm~FPk0D1uqixb7+aG!6RfjMOx>Wk#Aj%U21xaf<Y
zoUbJ`JIh=MZ_g<?I(XFjIR=*^BhI_H&eK8^9e<rsvlN{yF6b9{e+EAe^6kayu~F)#
zv%rncure&(El8fKdHdSyIPQis<U_a%1`x@#*}x>emB#l0$G(pJ4rkR%S2v10D$=+?
zzGwG-zkT=aw}?k`jvY7<OQT6?Q5B)Dm&(rIjr0w)TM4(`)CF1JgpPp+B8D$XN_VL3
zm|*NZ`DhRTL=}T~Dd|TmT&pPz;jr=u+aQ*w3Ku<kO*kn`pA>=C%~?coRT)#(dVhZM
zYx$fzqvh0m{PfyRC{%vRWz&X+eT4U>ZHvInpLZe7cS#|M_J9<i>J3ES3l*uEdIDpH
zojZ2|a2+UFAPb?o>gjD|Kq0EoZsyuoz>gw!$GT+Pwb##)YH)xXQlEi5jI*tRcag>f
zb=Lu$qN7-804*a89Yu^}hH?*kf+Q{tY+rA|MFO1);HDNH+!VyovEOSS%xm0Rx?zst
zw`4dbhCGl#bHSs5fGxQIUN+Dxrs)Z7|6vfm8PhBO#YEZ*R1C0gQ%84CXW8P!jmbs;
z3}U-Py|dv;oqA!{N~N$PD^#J=8i3;}7LH>n(jNWThWKD1@JQ=D<AP70mQ`#r<w6%n
zRCfEMyAy<tt|KwhwDEXyd<W=P##pM3j=IVQS?@Q-4PfXn^{sfMaa`~OaQd1d?lxd#
z7PJsh38JsSM$eoq^bXrfCYX5dA`nt-&uGsDvK~f2-lbn_@Ic-FGM^?rV#ki3@K2vV
zKQ4JSgq=Q^yI<${r^5Xdbi9PW4c?ml7_my?l3MOd>Wz4n%f9$&Ry}4x!2hh;sHlvg
z4cvzO4qRF@!+;SVeCMvA-+{qDlKZAfmuz5LtCNK%O#jgWSXt4c^g`;&hWA*)F5{?_
z5-R>Ne&xzX7BoBNKC&pSvBA`Co64&`5TbnVj9K>Vd-4zX>Q?f#!6AqjXRAJcEPF-l
zmtZN1E}~po;!B8_Id>1RU1<<c$E2sO!5#iYj0w0-1g6x)J(?Yji+uBjpWf!^I(v3D
zyf(ow(9-Sfye(Klt0B&^rsS0KEK)hH4u%z(SEgLUE?G2{7-)vjHV^cx_Q{+Va!1E~
zzTz30Z0PPM9PJK8HoY5GIPJ1xXolKfV0!Q%S+@sbz-N*HeJ-bkirv3?t_KN4Gy<|T
zFmvKNaoHyae<%5&ygf@*ewsm2Va2Ex8#QejIdp6o%E5dT5@1<6WX+jiS6x2sIRzBL
z#j-UtGPK@BGzr|OSks@ytE^9zMM641ek3X19(nur?P+sAIkLZqR8|O^Uh$QFGUwX0
z6{QE=-G2DozLbx^;N0QYhlyC|TE@?`n@9SW@&gD3`qi|jZtHiH{oKV3fKCGMq(1-E
z3&>$M{%(++&k%N2{t)dnaQh$RTxFPj>1Y2Ivyof#0kN%%Dztg@n#x#IwU`<33zI9V
zzP<<XxO$`hlqvpQG8CVEUv^7%w_jSaNGS;<x9I}WOze&PFf95l0bk~5brw9>#)XNR
zpC+ddz=7GRjWlVgi7&HlKYK5?p1)Ro6*>d7bk_HEt16yd$>0miz<AW}-;U^Qu@8|s
zD9xV^a~cCjP$To?Wn73{5PY&$CUq(7kodK8DTTR%8jl*f#dO7+bGhQSuypAhcB5)m
zHC$sviAe-mgIgAZtz!Cxkc%@QTX`Tu=|ZF#5h4rc2d{9Ae~RdeHh?KF@DpbB+oV2w
zf*#;2r65~vB9wh8_r%T?%f_fN$?CZ{zU5&~FB8agGd)-z)}%>b=+FdS!mls)-7PKE
z8>TH0<W<*A)uU-9N?_r;@#4Gl>ZP@pcAjwh3?_az*j2S>PrlxmUwFj-Eq0~n1RGn8
z{IHU(iC7w1Q6@gVE0AOC0li$--sce3TQ9y7AYd^dgJ9>7^lmRA`+$avv<mQD7FOX1
zRBj$~{ozBAV1ZA=-zW3=H1~a=G^Q>T5L%Q7a4AWghzVSJYTLw+k5lRR<57%R?l|)8
zRm(_?gtK{Z{Wg|8HVN>mPCbhgx&<)?Ltv)%Kb@J}P+t#hO+ZSPcLPlBIrQ=rvFtEt
z4xwl7Q9&uvs;|}0jmH#bBbF2q+qb74jZof-*a8SwhENg1Pq4@XMi!F{>9t73vhQu2
z?F1#6O^4B;;#xyXcdn*-7>6W*Ueng>XIHL`2q}O&v{^s_#3JTF0O7Y^<tf>Ezp)Cz
zwI`TAPI;%-*6^D(|2S>Xj9Ig;fXo293<1w6B}xk!&c~&(aJ>~@4|FXV@dO&rjpu&;
zTcp(723G`>=bj&N(Aj{BHiFZ=v3S0w3@<V`JA(EGJR@>w$d%md*Ik$%5$!d?;{&i7
zQUKnXTUgJ~I-NVV^4rq}Sm*_^W~Xpb^+3pML}UEw%Ub7R$kCJ|kB{H@{rKF<Zx!7*
z!TzB|>^qw_ttRT_SS6(hz5OdPY?B&O1<G-&Tfe>&0_gDkQ_zi2<f(~wMgjb=9xssM
z)9r2KFx34()9o=tra(yo;kGsV;X>+DW!4>`9Ee&%rCvV*THxQP6-3WQk1Dr6vl)m>
z%iDd3Vr~aZj?^P%>8`G^SALtW>6&ttH;H^PnU;%Th*)?n57o?pUKP_(#GCr~oVMI?
zYR~BHMkHEct8(2|rt{ld@4wYISHvHbkaQ>#2x#79g{{|$6}PdsjA}M#GQ}RngS2C8
z&4Ou73_lr7Q?wDGQo)%O%aEtsW6GHf5;62ngMkAEII(t)kI)~r2Ytm=+Mz#$?Jb=f
zlRFwmuqY&YP@K6Y^9FRqbkBAAy<Zg+7$}GjDhFwxBy_+rlMw&_gxlC1^bZABajyVI
zAEbbBo~O^Ab@%8*>NVkaCxzI&;Gl$3tR6x<`S;9BuxdokHxxZ6&$=@ON6qp4>C<le
zwHvOfh=w<VsLlBDX8mJTjE_h}%7d0&0Xgc}@fs*7R`bh~zE@G6U3EE>m3<b+{n<;(
z(BLsoWsqi}fh7Q~FOX?^kk!v%qJRa1TAU5d$&V)-a<PEHy?{mqnzP{U#>pKA&5MP=
z6iGC>4DKf4HU4OncYsgrnJ8elu4aCJ5Ds8g7%RDAJiMscijVdI<B4h^>9LmnWzOOE
z%4_|iJgXDTVlO?fXLwVAet?@^006P_dudy6fxf);=gd)Y@e#Tw@N_iyuD~IIvhXef
zx|43h%ZDHkLgy^&hCGy$e()2U>_{ofG*q4r@&NjC7$;Fsk&N(Y?x!5*1q;R^u^6)W
z#Ri9(T~S7)DOp4WAWGjLZ5^?{mq&W2Oj8gG+GF5AHWaHSuAlYErLL(7u0h8JZ6GSN
zMoTz;R?E5;KHp2XN>Rw?tED{k((uJE8sgP5{b`oJ&&SJcQT-|JPt+SY(C*$V&ws}<
zJf?%=W072_y{c`qcxsBxLrufB?A*!WX+p%BEz?NZx6E;dnt^0js0oqg(dk(KfutL)
ziCs@IApR8;A8v=+XlrS`S-a;SiRFvM%bz-ve>Bh|Q_@|=n1=Ap3qm#Hll1g3g^A^^
zRZFp;1SZ*E;2KHtQ$<J)BboAP))pBP=DF3bQwOf~KyJCFE$AHJi5kI@=@y&PH}_iS
zAj}4|C;mat`K#`I1QZ&|9j7kmj;DTpk&%CE!ZcqKRPe|Y;^`-CvzPBBCTg5995-6A
z^}75CEWShk!Yh|U{_)Yzj?{VsNWr3HqhlNAaG&uZTr0TKNd+gnXkn!SIJr0Pjrz=T
zuvfT3RV}Si^W7WYE-s!;mw^LrGy3(YDd&oci+gb}_@&y^<V@SAam_DXy}E%@C#}y-
zbS2R0dlu=1kKgaOoq!C*CVS5?TXCW?kV4be>~=%<Um99lubp7QhM*)KoeekdjEn0g
zmPjDM=L6T@LRtfu^_@&D>SB&aB5fqWos9=0DN~BR1RVHBl)k1rC*c5$7Fa;PsC^B+
zcR*)BJa%(kAKx2nni8Iyw=pIrrf`wY4bt#-@LqhAMeo7DWYpLUrMiZPX$_yge}98a
z1jP_&JJ)y4?J`8E*r$4x9)y$5&{+n1y@M9$+@R8dOq$@|D3eIMr^LeiGG7J)s447R
z^R~LLO7kvRPPZX`SyYi_0bN#FmkgaVvm>cn&MzgfIAJ*(v=H&XScl@MClxE#J~(%v
zm~CtyZU1d*%$!!^yY$l=j3n6iPP2HY%cr~goRwM>@JD17lo$koQ7RViq=yC@6I0r#
z$MgPd;B#^syy)3F2ZJuxU=lz*m;^8{SJxECSlnWWo=+<VdQgI@^OYtH9y4w{ktmyh
zAXFcx(wTswxp$ui<6sgT=M*G10_=WCUrw>@@VvvPT|0N;q%?~!BVrD~(+Z?awrS%u
zQWH`$^;Sl?KRkJvNtDZ*mK#1XxtJ0WVfQrUJ&Yn9)D`p=ID|NHk+Fb8Noh(%;LA4?
z2ert9|GZce@%TXI#pN(RyXXa<6Mf>S=s5L`unPj2V2ZM%n}LzH_fQ!RMaWv1Ha?JY
zmcCEZqqm`A;RDp+>f_T2d+EKPboRX&Dg9a%+WQHee|8%a1DrH&ul>8V$qR=L8FK50
zs~rOy-z;K6<014GGRT6sY`nuU3Wi8^n>Dl$QFrQLcFgL(NRIn$BtcQd6V`#G%AO^$
zKSoG-l}DWv@+oHYuAxzs|Dw#4lQCd`?ehA}I1suy@azK&qygGHd~L-^nmjuq56G1z
z8Igesd+Ipba-GL!p(EA?)N8V)f<>8YWWE7~k&N!SJzS+8MIyRMI2Z6AT-S0g>UL2}
z2z18n81L}Y8S(oDdU7E4z8=a^bZ_Sw2Spj3;<0wl##TN5IA-3sA?hveYg)P|NR3#n
zfMm#6@w1Z;IudO}%!|%6m>Q0z-9@037VExEWReRWb_aF0q$6IajBX?3wl%Yx>^@I%
zjHPAmsY@sF(bI@9HUK7Bfp(yVrGF=Hr4Ai(*<OI<=N^#pBMTmOfbXNOw}KPvIkxY=
zb^U8hP2o_~Ak)JKZ2$pgc|x72v86wDf&t2IJBVx(?m$vVLQ5f^4$W)=v|^?fAxm#X
z3cYCA<0fm=a&O!)<;la=%;SpD>;|wdmd@Mm+s`fqpO&Mipe-1)V8MH>+05Ry9rQ;S
z#rSPWq!sFCCT}&So<4455W~?m8aeXbLFa%M?w@+~?D-Mi|MuzSOQP;D1%3t7k?{Jr
zSRzOI$)Ow5J!+^N%aIOJ8P<m1&WW_7w&Y~wAWvxAaVi{KK1YDLNSoy$h~2|jKt*}Q
zVO3_jN;ALf>HVlq{Xb-<X^kJPIR4p3inlnK?I8|}SX9q_cj2N!ThMbNJ*rw^38-_&
zJNP|3=>ZsUn9vk;=eIJT*JZ?1;X4*4(p8@4`c7h;(qY;%Bzm0O*3yS?uhWivVUR-%
zln`U|>f1L2;3)0L**yyvFMh^^oDBL?gSP}m1p4no8b@3%`g3N5d4bV1$FfT<C&MBo
zL2qTY{2WTiR?X(Gsi=iyeCqc8-aO}!E(SNKKS7W*PFJO(Zp8`D8N~-Dmh>4p_{2XK
zKP&qneF~^vK~s2;5o!^xOAoU!lr_|>wV#1AC1wnE<%2tP18Tw-0dq1BKJOLYt?v7f
z6^1u;2pSx9S$HA^J4)ihFnx1x?;l!Yc1tfpSW2eSf`^t#23lb=$})PzjNxBK?$D>f
z?fZHMo=Im5iHv<#t{2fltDctTm9wT(_X4?w<i4pb9Soy3mB3SJpG(TWLbze$9m&Vx
zzIXT7S(8Y&gHL`F&^B2jaO~JI)gh=jD3VzrwK5hMg9L3EKJuF%DM^N9ZL__S$@N;F
z&pa~=y+qjjwiA>%j0OwIbRKg&9Q32ZhYx4#;BzLi$L)8Vl$6Of^DDr3xcD?>PQk|Y
zU1-mU9C+B8*~d&Dus#j_x(ugKvVcJ5{0-xg>ys-rGGNo6aZ>pdvWp;hYrl+wAJKx=
zqGOLnI4gw|gRtB%N_I05=<~QC@L0-|1LV_)87z2(@;Pp$!4m?R5Lt`pBJFTPqcHKk
zV5!m5lNV_oShs2g2hZQboNzZs5x(T$p+lNG2b6GmXx@5`{dd-<!V|{_S(3JWwA#Hl
zGR#*y<yZIRHpr2dNN7XqwSCyK{T%$MxK$H_%fO4s35We^R=O3YbR*`g7cfHh4GKeK
zSky<gH~$I_l)2}3#r!XTgqo=AvpXM6Vk|G~^ZS|w--PevYlLrH+eHgBm|;15zcShs
z4@QTF5I2s_OEY6WlF^*HHmfL3kps$hLiBo3s%yKW@eQZMy9s*)X1;3Iu3d#;)rh2{
z#b_UxaTU-xNiF<^#8&411Z1PCxQ!jX#o~tjK##2UB_Gal8Nl;SJW@P`jZkm5Z|kbr
zFeZ?RWNq965HM;)k9<6X*p)uz)D{{yi$iM5X=Jgw63t>%arHzVt{4nL!lx#rj3WTJ
z-i)oq%^&}>z759@cv$drWD|`aPyg7LVn(93JMuP=Uy-5QQJRnh8874gvfoT(`_wJ7
zY4B{bf6RdeMcX_bgLn8g*L#P0!cVx>d@zoB^sV0$4g!;>CPkC#(yifw@OL|=uo=xE
zs-PjuD^>Y$*euJy;PwGC8O`W7uigBICv~U!eDuHc`rmQt>KHI}hDClsRl>QMha2i_
z(9A|$$DD^KM8b7$&)Gy1&J9A8pxejc$P?f@3PKB&QHq<0sX8*rkD7o1X1GuCEWzzL
zjalQ2uZLb&`D#7tf-s!f^{3AXlT2D<Y31#5pZjAtpAd;N<2)%9(Q$hwpZ3xwyTP7J
zD_1`s*eIS#C?e65Yd;v7ziK9!+zp|S=ys_}5*ghOe__3j4EXHTD_M#2#~|9<n_k@t
zecBk{D_P=$0|j~j%Wy0&Lxm4KwalH<GJ>L~XHK`%+q!x~_2BSSxHzqdSj?IsyON)m
zzkWFPEo0)*UJXqi(;PEWp0cgekIp<zaTdkpkqePf`2&5?EQ$h=(E(bdoUYC;K{5j$
zAIn*_HM1GQp#VpKkK71ic#X*_Kn<ChlLT2%BAR2mHj%ubHko@VX6v~BTkx3%i#|;X
zz8*W=Se7Ox8w~U&0h!`-xQnPW=Th*o+%I?P+mI{A&u+Oc-v})<Tff*xyNRD@XKj5R
ziD;9KroVsxmQ~Qa6;ToRH%s6ow{~CkPs`pll}lqy^+>epIce=H7$F%n!f@b->gT|C
zK#^7mzF{9B>!XH-I4~I?7Gbbq)=<{G`|J2GFw-ACG`g$uBykLp6U?YHrQGR3s|SK0
zG9YmFD|g|Kc<Yfyj8r5S*48+GxbfUAx5i-AIfp3E$$@R64`z1lY2&ida#BZ=o}(Ji
z2)7-r9<*;=Q`0+d?}cx&oaC^ry=qv0&yri~E$^3o4aoSp!+gi&m=#sa^*dMfe|V#E
z=&^T8ZY+=a+N&)dMLRtZS#|BzYeK?tFygAcYx48$&g;EcCSGL-Z?V$7Zg1Bqdh6Bz
zsAwlX?(nM3hOD9qv~vEoon_jY&EpkBf6mo!Lk_+SdYn@FWIdJF2+WJ%Ht_k_qf&N?
zf!OKX&Ye5<v(YMXi!-I97k-gQl><4lMhM6)w{)3;#H*G9T+k(;3-#phC1nBqqxX)`
z8P>7p{>sDicF$<n`NF1=9ba;Bw_$)Ub4=iCn(e7KV!?5xN51FhOjEjO*3#d%n2%^q
z=DrA>aFYXFvZ%ZeM-?$C2BlgD;YmbsSXzVY!A0^U;`Lxo<j3FNZI-lBR208eYNAb?
zpeNAVXh^&Q{ql|*BG)7ZW^-?~m%VpnCgC}~qroqa5AJO?d;uU&I^6$y3&~1YoZT!e
zTnB@`%4+R-YBNXnd8358LI-1wwX)<dTK#r|7j~tL6w_uUyFuDbFZP%JR5>&FCOe^_
zc3A0S+>;6N&J<CpZ%^r3jv3>B>eR3;{iZeNjg>6&vSmgL<}LsQK8AAjBx_y^OlW$s
zA96)0`~k7VGz1^<$Btj%!=M_?ATg=0{$qXwA=j4T;wp70rEIVVe$R0%tmL4JoZWi-
zcz>4D(ni*0-bxlaizVc^as1f2#i8yXzA0&GvP-)7*cce9$>P5Qa9j{l`^oL4Uoli$
z9TL(!>Nh2H514n>5shm+izc%nVsTIzVf!<>%(AwzSq(H#+g=ZBW$C+;D9^+X1@!7v
z(y|w5)~s2DL*F-U)aWU}O$L#G>qLU=*23@iRXC&Cd~h<%s$NZumsA%&JAC5CnZ=70
zYSmh`t3-SBo6B-&s2fFm1^E@k-L-9hDk(9stEy^UI+YjO8=Nf{&CPK3EQwNI#lJCh
zHh!l)z!J)u7}uIk?<OiX66-<0o;Htb5GB^8cEO7xmP9r$_oFw(VgmXbp))BdMY?sY
zYzFX>sKpoy!ESIZN}uVhY&ha<Q<YcS#`CcMj8~$i{C`}%2UyR2`~UwD8CfA)l$ntc
z85LR-8nVllsEmX%uA(TrtgJ*TG)T0Ji%O}iB#}$DC`v|&Q2ZWe-2eaY_<fJ-K92i)
z-PGsve!pJlcs`%!^OP@uR#XwJ*HBIg5UhyvWH%_*Zzgtj?T`S-L6Kd8PzBP?E?>K8
zZkw8a?BZx`=WuiGfBlV_)!=`X4ydt3iXxPr>R4XLh663t)KW0Wrn3~^O-{x4SE>4G
zpTclwgXwA_1?QRB$xR?QCrzFD@NJ>3z=(5buY;_DgZ0<qouCY&z9BSpo?qW!A?Nh`
zTtKBoPECnpVrAuT*JNogd>pZqZ$K|`^w1pxoCjqXcHP2L5fR7myoT8oW#qm_>{~Kq
zuu7KP!@Etmk)q9Rk5ul{OA2<ZNb_Bj4x<?bxoe7K8wa*6`QN~F>+>|kGf#30YM+s>
z)uIQXY6<0muLjO8)k=T{@Q#RZjH|wK^G2=Lue}B@33MoLlr}ztmw%E^08C5bN~4xN
z{H9jICPoa?i8B2$HtF@#<ut#UC1FM^ZgE%ZCGsx11xAtg_gk05FrP4BeXxlq8hQr?
z+HGGrEp9<$Tx3xC!ALGO95w1h`oK>uU~c98acSg7%V0{4eah+X;<mwa9{~A^=*^xm
zO0OKQzI|JaiYe}d+{2OuhjqN>9?aOgd$))QIo`Fr25NgUs!!v+jkd9XZmynY9a&zY
zqqBkcNR<GMlik|-M@`6(z|l#3_6rI&BC;EQ@fb3LOcm3MUaA|oj%=Z+Lwpu*w^DP1
zjjA=S)hJ0Udt~?5#xtQ2Z!(kr42ya2K=(^B$ezuN8I4?BKNoJx)a^8K-8E|X0c*cF
ziVv`Rhcn*|%5(TPPG&F7$BemZJ+j&~`Z3Zy9WU!67EUdHQ{!AsNl}Qy(N85**EV-t
zLHI=8%e5|Kc$nA$X3mD6qxnNE&~pQ2g6G$fTaEX$yUSVM3heAeW2PQ91?rql8!m|h
zmRU797V%%7!wcGMisd?|;X^_wpWierPb|_T_an**iHaKAEsd|dD<Hs!xSMqG14Fa^
z^gU&k&kFk!$RX}q;4E|e>y_L#RIO=LM=wfC{QzIjSN;P0c121A*EbIq3@SZz%C4+_
zjQs6Bc(6XT3bo%Hl9zyfrPC~NvEIt1PGRpbJzFO8G%ReNb#%@3gcBaRLn^p(EE`JK
z+oIE`=}!agE4ZYCmB<<ju4rfIJt{jbZS8b~iT&X?P@Xmc@{yxSX~Ob6GyM^N5<*&k
zkJ~)ZdGqE8-4?rkaJs=NPN@cVm&gw1_$q$mN3;Xp<|-|fY<D2Uy?F8Blgaaya}E{`
z=EWf>7mIvh@rsO!zy|OCjGGD<g^PKj>Ftk+IDCkxjjt9Tw#*V&cNtERRe{b6^ZGHP
z)t-{-MB;iL54TYRc+sw|LRN3^pzYEtUJ!$1-z*P7oP$e;J`Z=Xu>YSHAevS|2AuvT
zq$pdkOk6OOi8vsmFX%TWl~*~gzG4_ZEV~79+r3?C|LANwadMvz+JSSg?ye=>%%O1r
zm6N4g`x=qXrlDbD(p0{-&5gU$pbJF`5BhJSuQHh`(3iI_#z*>NH}aX~Z_6HC*+SWE
zBi<fNMt)+Q9_{4@RpV~;M(*CVD+PhN0JZ$P)CUg|o*kOC`VbkMQ{@WUCj2j@M|_ur
z2=493;40Lb=T{Sj0}*1jV;qrzR@nwje#DY)6M{EGtU3jS2Uo%cttnpk;8}Hf4YbIM
zTDE@hCxW-x<kS`kk2iDr50q^3jK2JoxmGbqgOd2}zE)%Dt?cX~i^x1=dJLp$Fb_7f
zll{R~8n}GRbH|;8kO(thn~jlMp^oOkR8_Rv0R)n`^7ZJSL=G`*r!?D?J2O`IKUP(u
zIy)y*mp0DFW@=y~QlHdbtQ^YZ%_gp<=;(CootFc~N>{+@lj^>`X<@h}jXQM;Zl@mL
z#BZn#{tYVR%X<oA3z+lKPGiVINF4UoU3F*a7@En`h5>UAjs{M-O8wrSSsb>&ZFBE%
zbbnx=3KXH}DJSWdaim@%>Yw(nyLLh&KQ~w&bm5;p4^(~Z#usG4!V4lzeAu9afUWcf
zb;vNzZLtOy&jFBtb__D!U;at<w=%r{3T2&qL25$+n1%k7y=~jKFQ7aU6HUq(?2k<K
zCv5*7Wf;$vla%m=OB<zqiuvu{wsE6I*SNl)3$xlocg}^rWW_Y>Wt(BkyHY4h_LhM-
zYFHXR6Ly!Bn#}p%>oenbOw?8_r7hj(d0vEx2N{=yI90~dGv77h)R{9G+(>G#rm{x~
zlroJkjMw8R{dQ?pX9>1qDoi!O^n3%#S58M7K$t8ZWY9(NLe0O-#5)3WKrvO|Q{44W
z)#dzCQ+wgkW$hN)w@;sIl+k=h6Wz`1-m6fup&-H=Y95n~(V_bOtOB4&mK_ynjdK0d
zTC#J`h_@xhW%VMdi;2&#NJA3WDhx)dzz?$2ynv4!ALh}GNnhKAORwKqpd8vLH&8yM
zqzfQQA)zTj?ST2vtlee!FG|^&Mm7a$pX{pVagV>1GmQ+u=G_094$)n?1nUm*%nI1Q
z|DON7Iam<m3#=kUw{{w(G;6jtv$e4^Z{DuSI#d$kC-M?xovfG2S9COU*5Rw;ey2<p
z-AJXt&o$(YRxa?4ICyZ{_RVwKoLmEjb(PK8%z79yWhD3U(4nm$pwbdxb9t2!P_|(<
zrk%fY|BI~HrMYp;T=@UJPZl>75P?@S!?gXw0o4uc`ig53YB>o{bIMayV>W+OrCA?d
zhh|eIKcEsBKV5Pv$SR3-7ML#&UG{?5H+;A{@Z;O($s^y)AL)-23_MS!N5ETT@<Dy;
zM_#l&AO`9q-CxM@*sK8K&=3gUi`rj&^Y!N)K~E>%@XR>-O?;ByjyTBBqS&{@huz08
zUCFrq1A4Gyr%yk5Rd75Xu&DqE+ljApnx1EMNf=Q(dcjRQnQ~KB)}+rbKOfkA=FFMY
zHmyL^opnDBh$&$U3PyO#7@o<uNlHC=(52n1cI&6I@c|-&S#hH|b6yM?sB`<<55{Fh
z!46?6b`sIWL4l9)R-UtPp&UANLB^)0K6d+=e|$xHhOQ3XA99YRKB`PHaguWVQ(N%%
zv6Ii3YF{nMDm7I}d~zPt+atXuP$zRXHXjSKt!arw5KGuLWNe8D65mDl5aAq$|61r8
zL=1y}(&CDNJ<lrHZ2Eq+dex=xFmgOVO)5`@`;Ga0t_(}dK1c8&`ju<=*oZI{RmKa7
z!1#iJf1526p{q1|^~!(M+I!pf?JUB+qqk*n4uGcweV+F*9%6jK`0}r%)9<V-0~T2F
zAom7pLwUFq8Fdr}|9ou(P`<jnu<@JuSw-B9_%6$Ev6dZ0?BJ0xda<PfMR%><FtDHc
zigAvQ6SV<2wgSz)KpB+E1hAvokCQAd5+n=oKYFRkHL~Vaaw^^SpI5zsj?8Gxn61uD
zX1&!=QE+B6C^OFjtmoTYFt)I0gpMv9yo*x6LchsWFrrSf-IQk0dZj7014F@8Hv?46
z;~T^m#IGgi7=byijwSEvZ)vXdx-jvMk`1qZ;r#j7?KY&0Bow9(8Mr)m=it5$BP{og
zppXztY~td^Kb2$_i!GTaxQZwta@J$sbt<wy868bpTVEd~2zf>3GSq#0X!Yt9%Cw+|
zZkB<9LANIGV?yl*QZ1|32%gwUlXO()%88z|UFZ_<7naxy0ZG8#D_}0G>8KNjVw^;s
zh|jO7{*<`66K@Y}G;t&4J3x9vm{c(KdaFJ>F@j!Y&|L{OVhhYJVUUku!ihh2^5iDo
z$2@Q|{s&|F>i<8GpFEVX<Z&zDM?AkAbE?65l@wI}(^n=(UnO9l!&(o)p)!csarMpH
zSj16<OQ&GDvg(QF0a@RczCS)p_pe|YkVz#a{6ljvhOnThHEaI)hy6c+?u`_NI6%z0
zyt)<@0rLWyw4t1zpvatyz6bmdMc%-jh}a}XqorCiBqNG9N71FtN-2m#BCY#1RnUeN
zZsp!%dg_C&G9hqtb-2Z$4FDOkkeCvV@3%-ilVLt+#TA$_Z;XlQCu5j2Q~9oT!<iX7
z+FLdH^yzC<sfVLCI<6Zre%3R+hNf$rs-6P>l0DW{{5a6|;#R+L>-+EkH*Ve9fEig=
zR0&faXeSTrpzq#@q)WoB2P7A<0Jo2Nnm!9NI?9SzUqPb7gV%+s`!1x$`!v%#f?-2Z
zcgU)r;^&Qkt|fVc4_qb6M7j@pGX$lqC^7`g0D)tt(}9@hBe`dg$1UL;H(+0!9dv6&
z`x1?t{VlG5QeY3zhzu(^RaRE;%E3$I@KLtE0(lo7^UIe#{LUPw(gfZ(=~@5poljeK
zh$@l;axe5}RaKoBSz`O)z;kwSr{LMcPIH7aA-rSSOKD_Kvm6|_kg{mC7neB4f0S}o
z&-a0kDO}HqaAbh2`f#3M-;(7rpnMlDHJzoupzycD{P|LJ;>gjKr6o?8FMF|`5|-+-
zsb=8;{>JLg2MC*Fr`7YeT_W9>aD|~1q}ZbLl7&W+<~Z{41<OWpXJs1};Yem7;tLcC
zYy!Q3r$l?tfe%p+pUgPItBXoGWEvXzA=B&S1O-|D?$vAXt->`;vOcdG*XsQ_*LOR`
zzlhTCElbIbO-yXd&#lFO2_;km^j(tvAM}xzLdrdd9U0aiHd*(k(H3mPo};vlfdeuR
zk?Hd+4E4u`0ll^pz>e@9SqM}#iWx8F*Gc1Mx($=XH;4fzcu-&B4tA#AJ?^YOJeFl1
z>wi}dkx@BRv+&mWyDxk=W%IHq?_*8Lc<K7}>nR9|>4kzG%8EZS6O>^WT*pBsuF)+S
z*7s(Ym+0oC*EITUHtgr$?0s+w(%`w`v<hG?S+VoaDubuii-J@xUu1i7YJPq@&RO(=
zwU07r_+=%YDrjFV)>`n5qc7RNJ%Hc0I9&r4$RZ`hh?aR2S_%c#E}%tIdVGMMhnGGO
ze*3cmT=poS3a$81&LfZ(l+s!XH?WF3MMs&e;JS&sHZyq=Z@5RY6OcA$@ajYPa<UN_
zN$HN9oo;Re$Ll3W0jy~g*OeJitbCgwwd2;_KU6`fEhrQp`V&fG>@<}ak4)wMEPC?#
zcaRO6WTd@hEeNA79PSM;g|BF9p$6J`S<n3FWu1Hrj?*7**MuE-pbAA6pKYf;+teYB
z2~U=l44qxVFRxvB|7p<*?`-Ja@mP=@`*!in>F0Xu3R`g3h~o2dLPrr`9)Ns^%$;g*
zt9w9<M^$ArISB9wj%MCK0W6l1?m#NQtj>Q{5enOg5aM-J;};7dF=WpbhH7&VPFCEx
zJ&2oemCMH|WcvTj)_+!l5~he30Es~y|6)!ad(#7DsVFST(`yP1dK9g18I<+F=*tT0
z-Fg2R1!PqId#1wq=aJddM<4s(I@{B}z{M~9@E&~wgAUZB3Pr@JQw7kW8N|e)CFr5;
zdGOSDEjbVh1<b7x$GpTdrp*U-o^OKgq1jr-u!)QyxOY9eKR8${Oy(f~GO+PVq?91c
z%wx)y-sC0%^ktAF;%nfpc2o>O*wb8#pJzfL;*{xhHv3^GfowrNqYBo*MMy1(O$y(q
z4JLRAeX1OBHV|ox`13%kNr8q$;+XoWF;o)rps@t#NX=_P>R^b)SijY`UHv+YTo-h|
zOed|s#a?Qk-Avetx3w6$gocC|5k=}NLL(v=ptZP8nK4#K9p+aZGadexx+lH4j9bwg
zpdns*&XWt*T=AOPO*_$g-FevQ&fU9@CQ><?Ik^%-Wy>&Y68C`a?;`u<?@l_5ARTkI
zsT&V~5gF7nq!>?Glf^w35xi7sP?ugJ0as{%zXds9NMTjCX-5mO+9N}ZLSSe_D>nvP
zfg?Ys<GwEzA27U)FETQL2c`y)dJiAfGR&~$2FZ7kfg4!at$3%@GUQ>kyL|gR;|k&y
zsN_W#gSftp%<6<PP^#F4P>qXgqS(b%$UCIV+&TBUg`z8iPNFOzHK{7*10Dr=lJ@ri
z<?P}R@1iDY#;-H3uL&;xns_S;GWi<3mHqM`RpaZxrsD)_0F${+R^Eysf~diS!aK62
z{o30=w>^kmbrfqDD_!`A=cU62npj+#5WVHqy^`(b5M5H)z84FB6^{EJZv6GVs8eSR
zjg;?~&UYsPnL>%U@34~@8-+#<5avr8s;XeCr?<NrpA2HHFw)@3Cx#g0EkP@c)>nB5
zhSMA{;Lh_dvp!L;mgQQHY{qFT`&?i~(mz4?R8@!;oxEH?TU|%dvv1#}`%63NnQn>D
z(tPkBD|XG9R~4UEd6tmGn<>P!fbYtQSd=yG;e{AY`-1$86P8&=7~qzPb6A0E!@l7<
z)CDx<+TFXm2DXZhis}pu)Ps9`ocLulJ2=na*W#X>58hIDQ|ecP^}m8Z0YIO|uzr3E
zPlme~roQ>I$M-!hnbu^wE*w&WfgNiZ60NNC>uUO_@^*C?bjTmjt`rEybkd{%8NaD{
z5KMDuKxXKkInlrI0p<<auyq~V3kxb<bNxH3q@0BGJx(?Knp%Zi+PJr>Lz|Q752g$P
z`7l?gf>g}Imvr0cwtq48rl8D02&59yzpld0s&k({7E#|{T6J#9CY`Rp+VcUh<HO=3
za3hqfrsO54D0KHd|7*H_SB#DvI%HeY*qH)XgdfJ&!?z#ho3mz(Gp*^f3yo!S3e`J$
z!N~_mz$H(Dp^ar0WLT#~j*hAT{C6_>!0fWxAhRW^W$za0l4z8?R<yXNdCTJ#l86Rg
z?UK8|G!Iigz~w-7#InwrE;u|`D;*o{{T%w#oJ7+=(}x~@FIE4;3vWw{i|xAXL=p3j
zJmvRLBz9tY@O@~nUQroY6)ta<+#b*gaqOvYrvP&pbKQOO=2)x5AJ2*|#SVU5S&|#*
za+j+S1PFG||Ee3XVRus2YtSB=6C_wO<@5IFSf7W&mbT8XDZfY(^dQNj2TWMRewDEV
zs2h|wj%F|0!46|jHcIv~n7x#_$=&<+%T&%W^%IlX<kOvyBc59PfcMXngXxloJpNi;
z-N44iDKTqB%b1<XCDT9NQp$00IPJ2-?)iTQcjaetD6ha8vopyYfyK~URS1HKSJ4^I
z*FZh-11Eg^HDXa#LH2&wH%o-^TcPAHviPoas0V@g2p#!up!~c3TrE`Dz7dg;pDlJf
z*dwF4^sJuQ^yd9qZV~f767jCoRO5V`c1zGWm`<L&uSZf3=1IqJCdQy7Glw|kM{?@6
z%R}Vhmsh84g=xJ8+D;*%%G^o5>xEa3%XMJ;2DKpawQ1Y->VpR@|Kbq1L(8Nzk_1C?
zG%$|TWPopwwBH_-`Kab^zWNvNA9)#YOrvk#GwB&c^jTnzOIuD18+=~2_+Tr05ZSH_
zrRiI3j{tx|Krfy{QgYPv8co+v`h7&DDw%8SMblVY!Cy%`)T#;qLN?xkdCK<IJ7si1
z6oFUiP>Y{DXTwQ<cuz$N9kfw>BPXYxMdiqe1n$J#U17+VhjOj0V95gYO-7}`mBONT
zPjPObQSh$opgi8*d4RUIHjzxB0CHgSj50D7y3AS%j&sTFJ@_2b#|w)B?vu_ytE>#+
zLAsvw{XOMbhO83hZttM>SUyXi=}-K^n<ACH^Z7x=h=&IfdS?C(lW9Au4j*6;a`Bn+
z@^bck+g(X+=qRrnRYGkeqaWvoOJg4qasB&|s|`D-tN&frn**};?AbG+rp4HazB+>j
zmjlH_Q_E7V4u7#7^61^DXNzWOYG^1x%AR2C?XKoeIG{Wl{P^pN<#t71$_#J$Cm+7_
z>_FT0I-{dq7C&jz_(tiA7Yg!&T<f?U5dE}(SBLdrCPtadF|1(W$?sq`qMec^R|G}+
zO|q$i+7NTZ-d<>O_YNR<_8d0Zl=a}<<-@Xxnm4`))~Hm=;0CZ4hm9)}rhX!a5yuTE
zn#2g&U5yj|lCi(lKfh{oEbbKB1j_58dH04*5-@_Sm*anbzWlOp-!j3TU%q+spx2o-
z4RV{L^lwzVYJE-wEm%<kmAA|=0Ua2_Pmx|_R|Pbaz!L!8G`l9iq&eqZW>avLUsIm*
zH>`fQ5$u4+djUIqWKDsd>w_Db9=bG{P4Uc;u}wLZ8k}OO8J<vV&>0NV>dT3nhr%o9
z@WGL>n~rwbNx4m`p$bVQDb@1uET~)&Qp#zBikn%m0`qQJ-;RXK6^T2DR4Oy0GcT<)
zf<X3jNbcia<q=jzz0%n3<eBP+h11jbRX9ZB9f<iM0~$pIfID;1lS@e^>#V6BAiU4z
zRo9aBiV9h{4e)KUv3&5?gT8cPZ{8?lO+ay~4nr$eFdU5WMM=MYju_H)k^Ro!W`^~z
zZfn^aX_7Z&=RN<l$#7ZXwhsStt>>UZT^hHSk@J*U<a4x_YC>Y-CWNfy1X2AFBtm&3
zqJu^7)s&0@)t2M`<tfqW9Bd7vI1N!^A}I+~Z=euf3y(Y{0UUwzP#cccpKvNPIy!5j
zawu2=pxe@n(%M-U)<oGYud4pO=u31(yTEgr1xcHB_$7ZCei4$GO&I=Q8*=~<@WxbD
z5CZ24aH6Z54z7U9zz&xW!7tBvc_{=1!9yzrizwRKHM}l#n5oqAs|!P(G9inT<o<q{
z-jq<nZqY{&^vCcPH-f;^EHMl-O5Z9Be%+p+BfT02vdP@Jm%1$mP819P!|WymN>=CD
zWTowtS-W=aRA_^QGz9&mACI@!eZ)w-=spnXhQ!7;m+=(!$Q#qVwbJ?<j6<kFv3$z)
zT;zodZAitegcIX)*|g1R35$wSq3TECJDLR^cR8x8-)K)U{@i2U-oM29!H;3#;q@pE
zc;E@<-j1%W1BhFJo+GR7WMwr*oRdxzx{Js<-!*VDq!%-CvVBPwuoKn<2eSXH&ZC#R
z2#yfc!~o0#{%x7xn_0>08n0RNJ!a`O<{jIogde_1wU|lkrOE1c+OmiLx&WC&n$+ca
z)ST5JqbJ6$y8&KG;>`e>gwAY2SbPcPE>@~ZYdR?KYLAXtx|qK7!(m@b%V7&(D`7+g
z>0)+mBhg8%*y%yV^KTb5ZQK7-HF5*E(M!;}3v0@|12eU5)22Sp>1a|&5QaYQl5RDm
z?_lSorGDMbgermUS&4S^m)_w0Xk+Lz&r-%t$$6k$`9<FYO5@X)FR}!K^MLn)GA_*x
z*(5>NZZc|=ulw;SCex?4$2le5ei<cdD9ZD!#OfW5*d?{#vBB&Y8I?a*eEaDV{qSzR
zRe^e=qqDyi%Al?Y6rrD9QGr+DjS~_Yx`E5v1ve0m9KUAN-q-<tkn(L;uU*TMj81%`
z6Y86b*tlvB^eX0P*=o(-6c!5pCukbjuVbcDJgox)-MxOpi^b&_xHi{6rz>$udTXk)
z)vpZFK_8$dVCgp}Cc685cw~_VPB)h)Je~z*AgZJUaD$ZdaT_dyN2qhA!FkQ-zq!}~
zR|+aUw-VXkASiiYs@rR#FJJBei1kX%562PNSRrV!mv!`MmX!(n!#;18t|6M*=<-|f
zKOImEtd%%IxI&l+Tb7lS{OZ-bJfrxIu)ZnO7D83aS8)$o;6|dvWwR-jfP`--j{i<K
zw+vvT14mWt|0FH|xzNXX!x1jmQy#%qYwV%=fu^DwD1R^*e)c8gJnNU+4GBsL+H;Eb
zDkGCZEDg;QpvLoK4iwkUPk*mxG1-GhZlNKzC1o$u>M<;$hRXZD%WDSWk~$Z4ErH8(
zh20B8P9i;GXdHQ<R?&hg+BsKb5om?O^C|+D-=;y3fdwMR_*t`>SX*bu<VBWvp6OS@
z18VPC6+IK84QEYpb7JQGE&((+{1e8mFCIC~U_NMfaB%j(r>(rLpJt1hd1izJZxQ#=
z?b&5DcIWakbT1B!;CbGh;!^YHmU#L@8Nx@kfptn5_%xO_c^M6(;N^fZVhUc-*E-r4
zyt1sk9Ovbyrzie9WD*%9&V6gvbw$Pws?c)fr8|;QJQUB2(d58Z@6Rr{=i)cFec)s6
zsDLtv3gjzM>`1OceuEqnqHk2#@&T5desu;B+1=1qc$|Vym+66^J|v1!%ovof(xI@R
zWIc!=u~f^lIm3K<5Azr(t%J+>Rj`J;Fn0N_?MCr<P|a4-Jj`Xzy~W5Oz$@3lhUd7r
z?BrPs+Hq2SYd`H77j~6bfYql_>1lTEYz!~TbdjN8bMEdEqxra%XP#}DsSAwuky$8X
z7O10Ls^6%QDbix%l^?SjKAShEQK-^v4Mmj-_1;Ln9>pQIg%2e|76euDxbe^N|Krj=
zlJjFqhxLIEQ;ab+nxsUnGMY0Q_Yq~#7B|)CG%~B8*zEWLd-dle?`6>~u?v>Tn4m#{
zj3B}xJtSfE?_a~ctkZY=p3I{u=<pvGo>-X)YbYyi`5QE}_0Tq_LLi<6D+Os5;n?#h
z4~v#2z<|-3n4&e|q+s{ug&O81J~N6D)g6*)JmY2|0td%-w%C}r%fY$);^Xn83-Dwc
z=&J8ezi`<`J7i^N*Hc(+?xK(%#cdz4u4)S^Dr)s*+xn0Yw@|S>czb^mKb|7#P9{%E
zaAV>2gi@p@5@3%?IlN@<k~QuBxgE?270)aXRom!M9o?>ES2!%W{`t2flGxAeHOAq6
z4>fE<6%}KiSy)3;J7!hCDUOZO3mg&v&dV=w%#08ojqEC$9_gogktbz%32BS)0E7>m
z18qOnR?@b_rC9<81RYE2#_3y~!a1d}!eHX0XF=+wr%rjlf1jtH?lI0kxqa-cC2NvA
zqBZUB|H#NNd|GfXqp+@m&_M#0;!}DHFYAfT4j(%7k^!OUA3+DEUiSRiipe}vYCksN
zn(H^2jf8=jT?6X1)rC*q0+Rg4x+_+4-;Qhg&x1Go{}(98!KSDVoJ3)U^q}vo%jWuH
z_cFIzKr&%MtPWK-1cj{Roa^8)x!_}`+@buIYt)4(!)pPvUjFBszx(m-aiEDj0MXwt
zA${JaX<&JsGGBuGUb|TchMZag#$1Qtzd<ci1BOu~Zsj-DGUQsy4s{vnAW{i51nHCG
zfBSEnWl+kcp?in@iTfxEr>^DYB|iF=wiD=V3}3dU^FuIGIy5UZDr%dASk7$dnKM?D
z#!hC=uKdvBs6ZOeTE`GV9YxOFyBcJ7A5~+Sse<V=Cof#5tG|Ib<T{~{I<LXPD;yvl
z#A!-i3JnTaO-zs?R>=;$Zlqq*S+kA`{vl#?c9iUbG*mUNFLRoRSTqQ}-FRd@5Elt<
z1v|MT&Tmtna&73hZqN;;DE7#xo5f~J%v2N_T$;{g)W$d4v2Ou2qOn4i?HFZ1OEh=J
zG8?4Wg$i~rX`lriDP^T4qm^T^oR!aP&PviXbQR(+C_{1!+l#{(zyzs5W_s4RU_EyO
zp-_Fz<99AM9$wfFTgE-$F`gA`O$1+P)w=ci^1o1+2G6eXtj$v=PnoiZ;^q*hX*6YS
z=tia2W=L?0dw`yDojR(>M)C(Z|A*FtZPB6X1-&VTO-Y~bjm}VQsSBdOACVg{@^=*g
zAmV|0{$=|Jj?HPo#N8y{#!jdzvE<4hV9s@huISADaNJ+I(4m=<YFTnfvusKtO?hs-
zz-|~LYXV3YzWcmtW(hU>gX=ALUbB)sY!_u*%J6L5wtZ1yVV-{9C5|6{b2z$Sx}ZC&
zVdKV2%G|v32K`#Rly4#aB7&pVz(r}TMW4ipxxsLxqgkY^>jF3SzP$eTQTKrE0C}2R
zp5tfF?s5-kr`T0fsn~2hbf_&V`w;c88v<jnd_6KMO7J}1kT`5zV<nKgTGA@`b1@CO
z$Nc*qk&@k6CDRVvVNDK(K}EG)r&`9&`{R$oA^<m4O?`K>f1_L;@?_~pnK_zjANYe|
z0Hw+=Uyg6uG}_Op7;ELbXpnB+_#aR<1nDmd-gA%iJNR`N)?9W&05b%-jjVFS$P#+j
zgc$nVvfBey&`KG9;#J9-Tj2ov>Cg7)2bV7_1{}`wE79a<3T#>SjTwD}+aW5}%j>FX
zx!W~9s#HwX&Z5*eeP*NBKlI@tIya%*VWQAsvJJQV!M8;w`y<Ek8hiEb-Tq6p&D6Xf
zs>b8-gd({bto>3Swr=zB<MTJJNLo`~7yX~9)XhKtxp>At@$A`@muZ`m_0D8m&Q5Ts
zepXO#gqz2GcBrE38l<b+KA~?6@4_3+xa=Dy$mdXr5bs5PBO76PXy{gN$T-ui%i>Q<
z&|;>Y6=jXYxG?K^+#r#3iH4UNOSaz9-4*hIL|l!>0qZ2j>Nk0aw$Mv8b??(-%s`7~
zf=gU}E&grQQYcr<Mov5%Rss#pR_!#{G$EhPxcts&Y&g5q>Z&%C?|PhZNt)uLicDOz
zW(aO+;zl9#24xfHLZ0TGqF;}z)fJN_O+uu7BbO~Mwjakm*B`y)_OuR;(?0OvjVRX3
zU1^006UUApzyH=F+NtW%6Kp<^yzBs$VjPw>wp_S16j2n*Ws}0cib|PEgj%LX?H@jd
zAqHVXplEaaCv2o)1jiNXBj08y=)&2hPxbhepWpP+=WlKXIG2_eT}i&{P`JYZ@I81)
zD*hDnF~iYhGrFnaqrt-6kqP(boNX&wC5$7ykyE;Vcygol$Q7yawTaeuyF;W?PXjyH
zGo=;u5b~HfkkPY^B@4khnRLN*xd1Y<Ke2yQNQgJQ-!XoV+D@OpP2XF(-BF~ZxYk?t
z@7rf&VR72_+tr;U|IJ_l;0cMBUfqSX#p1aE>LM@tSx$p8Wl;V(JHm~!mX_B2i#zu0
znGoi3dEGF-Sxb};P~&2-<Z|S(({-H$e!J5r%g>wUSGNKZyECc6vgg@iv~-|wci&bx
zmq*(tF`LL6DmFN?>F;55SyEM9{rOhE<oHXk#w-3-*=sHhRjZuz2?Etne{|#E^_en%
zdf%@f@G&vHHkM@0lSd{?4GECKJU{a4Jm-uZBDaBb@uomd1+I4wYDYRbM*ji8F1wM<
z&9}IBO*+ZDML?P3?@iUGa7^r3I8aB_^z9G#>)qP~v6q}F2137|r~l4a#6_Y!QC@h3
z?&lamfC_K}=?l`EkEft;xwD8uMb0hl=EW)Tk7xY9NAGv5%}QQ~IHvmV`<@7}Bl98B
zaHWSd9*;<sDH{2?R5hXM;hUJ8d_gFb%8KIHo!*FI`mX=g*1R{_)*;vC&Cq0yv*0)!
zxYbdHT;}FrBhm)&&Y1cgrQiJdgsD?yaRvR4Y^#7bO7fhO#vh~x2Wa%>Ur3hIpKzrH
zQ@A}uD*6A>((G`?#nvB*vxcs&n3xOqi)5>zg70a<$Pzo|8=$dpbaoEqlgRaTYx7rq
zkoz7(29{*4lah%t$R)8F`gFHj+3!@56d=q5_z?F8$chJ;Bc;Eqe;&j~j5qon%~+5W
zO}Pu9S^2@?pv%8l6fo6WhyD>4#4b8Iv3YO)`+0jf!4Wm=lvD4QdLn~@;g=p5sD7*J
z2I${3#x6)Hs}l^>D(`=Hg>nHR_<6=^#pMjJ4d&+rq~aDkX1?4;WK6?G0(iv`--gnm
zx}vTC`3drn!&GYS5zRvAX>2Tk`PRgiLECJ>g6`zB67BhmqiFF>>K!}N?gPinuHo?H
zK1x|PZbS~~a*~G|o-&b2N0Ow<h>^dO*&L`JGv}ZSKR%UIA-jx^7Vo%z3t(6bRV9F;
zcMDbDEZ~g{PyyQ>uCSZALM$h7v8xM`oNrTUEYBWPh$cU&kE*h4^1$P`(eJAArp!+m
z>NnZU5T1~2(D(&Z7%vU_-x_q3<NB(gKthlFVbZI3BOvhB0augumJEpoz397DmM9e3
zoNP8?RbFN6zoYr8^b@W$bVzjC6Z3)i83$0Nrp#gfoe^~-X6Yvy{D6o%7asK|aUPr^
zOP^F(xk_(E8}(%I&$;TRi<q(-PXC-k!WO?UWcCyvqEHYi2)O~huZoDl><2st2~lEP
zOsZ>qx;B#)>>0-pkng^ZMVe$gAPE^bC!sof_+QC>avpMowLXbAKaAz|0z>u3vmR;m
z5z3dXfC@)T3_6oGD2>GI+`p_P{S<u->vvkwpq*6TyoiuJchMrTr<IidK+Q|rHntA6
zW;*S}>JJN&xmUoqo3X-3;SSNJ(0RJBOBG}oi3k19#9O%7ZKcy(e&t<y(bC`>H#Y3r
z<Gg+5zs7<0ODBRw%Tc)G*^4<0TiZjr#d8jR3<wTxisBM!fbP#m1ER%li&%J$+3};j
zmq9+NiHM3)HQy$%51*89XE0go`Yk$ou|)&8yUM~#_n_`#PlI+ztop(I!4YVJH=x)O
z^DT%<gNND&pCdYvCk$ASM$go&MT^?Z0Og+xyoQL2JDN#%$+=2d(e%u(*1{ledbt79
zvM`!?-M$epwy$^#!evp9$Pxsod9gL5plZ1=@JIH<`|E$5ClEvzzUuZz(_d~cv<X5_
z805eN!vK0=Cn&k=+1Z&?a+-af==J>!@;L`x!0PHBy7+3;0&M1d-StoR=s_Z3_K1P6
zH~;RRTO1w}!=~>iF6)l+s@-56ML8tS?drZIT#ZfauMw$$d%#)(OjE@%!~w&`Si;kZ
z5wdlwEm4t?(!|$f4P{him{3c;+r0UF;D=%uAh`_$(q*_OQ|O3A3^rwTvG138n(33L
z=I=ia4FOpWF|d8Dx1;^Z11^r|v#Dc#N4vK1YJ>%E`<i#W`$*IN77bZ%YwG5vOIpob
z_n{rr1hq-RzNGUSzUt0Y8I{E|`_qgbKQn+&<$XN*FSMD&cSOZFknt~b{d2oYL|?Wn
z1r#8Jc8jY`sRyFEoxdw18K61wT|Os3jdy09pdbT4(YVVuCQ0&Q=W}JQv$dIEqsb}<
zv>o^SC!NZ3{pLk6P_F^iD+F9|aj}$fMHOf>xmQ~z4hm$_g5)URfrgLa*s&@+(iodT
zJi;3jYis<E>)3-dnO|Jj*gWp3xgg!jp}))FNnXG~V?wzJMK)6s(Gd~#Ar+*H5r7pT
z!sw?5=~hEzK_PiC6DpVP_!0x)@-t{Y3E{o9wHqT+niM|&S1WA1^tLBDk&n~p9DzdW
zp<U#B>*8qZg@lFMGTqWUf)ecSM3q4IV#TW-S(m%cSFeXX5{D`UFx}DY)pQz&QGBNd
zjc_1`ii}9OTYhUpHlR&tZ0w%6Gf1rcURhCN!2{>5&Pp?Bjd7XL`0+i{!{)as9LGH|
zBS}CW=7gBkLm57c*UU@x=hn{yB#tle=!Pm(f-&#df=-{(Sr7!-1*YyBLzF|a)kq*m
zMytVUn^QH)<P{kzjVWWt%*eSsglQ;6s7aaQzrMiWhZRCrSuG$VoK&QoY9-#!36wL;
z6Z(=?04)ljHT&!6gsQ*m{U?C?{sp<f>1Fo3sDc>C`;8c#nZv`rvo`^RH>hGnYd=Bg
z0rW!MwEm|Z#OZAlQz@F{eV*2m{hpG%EeAAxL3J~Y`E1s~Y~^#@^DloY<t%(D_1p_s
zy&9hyvw3YcMNXwIXX)T}{=Rg#q%1LXVtO*8wR#l(jcb;!{hrNa@aou&TA!SHT?Py3
z0#W~<x^!l|W3x?7)Nk&c7(3(v3VbPe__lLJlvUty0#r-jcRF*)Wk*Zi-s*>{e>1H0
zg2%szxwBiX{q-#Y^<8VWnCf=Sqa8Vw^JwDCnO8=C%gzp7WPU#Tyi2W?`xfY%GS{NP
zNuzJh-~|m3^@VF?DxVQ+%AM4YWv@352At18@hH6rA^1J<kOJ6oU(*8J9(2}KRpr^t
zD-}IfvH^Z$1YE&zs%#Y`D><4)iD|1am$X$P)urmn-(4Aq5)GBNHzl8>5!8<!KhHZd
zSW5A=fddU7Q8UfE+xbQHDScka$oe1#v?az<r=HI!p#<06Hkv0W{GW7>DdF1((m}GT
z>W$jY;<s-<y>8IpPyEeYOYCY2Dugc2IZ-Kx7v3q!FdhXz$)2;43j6Go`MobuEy#GY
z2=ic`O*zC)nY==$UA#LZG!F~IoBZsE^_jH7jMyNR+69yU>3x>VtiGzHl=iZmitv_j
zNy&zJ2I|3i9B)CwN{7zKfj(mGi898+8<_8~wyG}SeG<<o&_sdse!-d+0N=7o8mTa<
z@g*DcdTMJgx%=fq<I=D2+3wt!IS3J?<fboqc=BtvI@fR43D|crcG#x57ha(LLuR*$
z+>H8+2szu_+By@B*jYBw!Bpk?m+wP;0u?W|vW$8h01=Y~2n##aDR2-;9QAQ&o97NB
zAy!dc<yaGejrFY>%bjDUMRu)8GsGz&-3xNunI4S5E3>wo{_nASBgnH&I*n+=v@&9f
zc6|Abgz3_09cnJ(Cbo$Sfc*B<;QKVsDbx*;7GX|A;L9H-?rp^M0+pD6mHZ!;QYN6&
zMBUA@m!ix6=3ocXQ0)MPfMv^?asl&&%uZ{!tud~TK?NU61-bH$7?(@Ih=oCl(CwQd
zx0PLL`puEgZER+Ima2lTG3=_cK~+~qqCmzChB^GR<X82#*<vPu8mp(4)(gtvczch%
z3?ng71H7ODAVxQjgO}|z)?mW|a%(Kn-$QcLThD?xPVAh;i!Jo;Or<Ckcv6T4d6RIx
zRL=}T)guUA_~%<+ypU!syt<GzeC!B7;6BN|eX#zTU*|u?B`ys{o|&*fh`h*1r#Or4
z-@j^)x4Wrg+IG_cD2~pIaPz%AJpDpWh!T?*fRCp)L|y67g#5ULO+hq8&cS@gIGjn4
z;58!pQ!UH#0$JIYwC?UKelI7VCJPa<jY3R;C6Y;PNwr#251V_)N;pyfb7y6CACZPE
ze{(-QngvT{C==x;|B-C(TX@IJR=C(k!BogdFxp`_F|(io90FEwg`WRtGqWzx9N=g&
z?9P$k6%Wh3j|S=(fSZ*1E4%&)xfY8g<N__qSb9nBZ&l-Ul|2iGEdI}nx@HEV`<jFn
zK871C^#KN3poViP<lfJquTNS5)`yKo9ej;}17}h*gKlkRLXrU_4G4KcmLU)<_}e}p
z^=x-l<q<8n;MEpGp3acTjLer&%r~Sle?W{vUQ0FHTNXis3(M*_16vIhkDC`zOXIQK
zh%)2Hf@ZI9EQ*i6^X@5ToTx;+n05(4`XBe~{3XwIwx2-kROY@s`TPfrf*JA4@7<e=
zJ-Za-Cd-{zZ9<tVWegKbaB*bw)?8kHz*mT6-yRK}85urH_sEoDSw-zUA60~PsZ!^v
zB@JTfHM6QO(a>j=rI?L7MDq{A{0UQ}&#!khqtrkJ;*IAElY)<mJ6;Gg;+;|TrE*>7
zLjU7<3k!MI|A8ZXf(eX>jGR+|Qwf%vp3|=>dz~C0h5?6s2H0mTo7KBtzf6LRn8Dv!
zkH-+lCzVfHO968&j3YXayQil1yYqV$xMp6+UrgO216_uXDtv58etzJo$9?<tV|E~>
z-?H^Pam;Th&<b7J>{(B``OFdSmaK~P*%pr5=Qop#I2DSs_)cQZczm+esy1qBJ_6*>
zh9bqiUi2a8vYkd0Eg;etRpZsm$1Wp;Q?JN4Q}h`_RN$>B*QvwIPW7ZgL|GxJiLS`;
zdD3w1iyg`uwEp#3-7E4l_n=nrMdMx0XA>#aTDN{UEr#nzq7m>8(*mSBY~UzrRq{6I
zbF#{v!d|Lbx3B$9eBS5qLi$9mZGU{EVcX&_4KQ4RHAD^Th9bTOMx1zx{^2F0w#RRc
z#~ewT%*~qY`S4FYAQ2D3n}D2jc~j-1qVju$!J~atQEFTRE*8;(oHwE#6R9dxJt7(s
zr$;RF#KM7xg-9Zh(8vEK<He%K6&AeIye9G%nn}AO5XGWJ>nkpDFRjk!eEG6cj0S1%
zrRVUnZXKEQeki5wRuomAuI+8|w+8wseFMXoK3u>vt+z~>G)Ympa`#)ay?lH!r3~M}
zL>^ZU&tc7=3T+FGObT*mMqfv+>@f{)d^!?!K9`+CPA)|R@{Vo5^n2X{>i)wxKf-IY
zSr9?d)IiXv{uq58)h>i@mAy5UYgKN#$jQcLL8io#f{vaY3@)F6u5}xCriL<@*qeBW
zqf<vhp=fBHCw*)D?&~2G>D+OUDc8K8&z1)B2`;Su+?mG0u54K?1qn#uwV<SHW!12|
zXVg==tIlcjLstDF_`|E>o_}g<VEqBOpTkX-t^Di&mCRpVo#>SiLX;Qh3tkL=>^xym
z(9-+?Nr!=m!DoD+J3@f4q();*OImYQX4R}a>(S8m`)<$*c}obtC54gsISAqEr*ar^
zXr`tn<mSqc&(wcsKJ(nH>-N<}k-Sl7pP$A+Lxs_@(4phUmqfL1J<sS=-sk)%w-@j4
zUW$4!WqWjtU5WFlEvM$C&unI6nxmJpK~-b1+W2OVKK)D^^1W7PojnG_UjDq;w_l%K
zMNcACUIzX22qw%8%ra57F|O}ac&&xmqNB^ex%LK(PItjFTT@M?mV$mrwSJukW5al^
zplMEt6OYt~>oKn1A9b_1XOgcM-TS&p7XnAgFz(+m>=aevwd11QO?Kk!%FTRs0xiVI
zs!z3(eiY02wKQi?Tyxd8s~QJ(Wko6jd*Y%|qBY?>8Ig)96<)+GVC{B4Kbpjisq5A=
z4XLeQ4szn$hM_IGTcl9kqmf8=)^FakHh>SE@e2Urmy5@oI|(LXkNN?|`gm$9(^@h`
zCW8g&BbL!8`+gr{N9lwQ*aO?j+qZ6+(EGsppBkQ67;n9BVUe@1HFXOzaYnh%k7@h#
z$&<4vxH*-wl*iKURETNkW)O)X+F^AUF4svZx;5X)*jzTBykht%6_b$E8>x*O3TsbM
z_gO$7|1v9J9YG60Wo^xzVu3voAN_0ltZQFwYD!<$<grxc=3(YPD7H6AanHc&>4N*t
zh^2-yMlT14$_IJYIsfBooDk7Sekpz2ntJUjq2$fr$+H8gL&T2I<Hx)3w@)q(%zbKi
z;paXtRpTud?@CI-NU$z`N7pk+!MW{v!X{+=7J`eI_)xY>Tsv{%&GZ&#47<EpXUuEi
z6<>c&P>{WR6pQ9=?Zb#Gitz`x-ztlR7!|=LrMk+R@Tz}7UFPyhsj5@4f%S!qU;e{q
zkfzTTb#Sz>2P1S_|4$3R+N(=rw(}eRqe8*fSqU6H&$XCc9#iI?KTt2KwJCmOZNnpv
z&`YoV`hF{*Z||8#YO7b+tf3*GX&oQ9M{1lA-(R;tR6Zl5-yVW$OYq@qXsM(DI@Ix0
zaeVfrlj{~ZIE-0$M)Azz=V`r16KDKTOSZ1cLr;NE*RFRfRH2bgU@>_OJ-#iOJF0Ut
zlrQrW*YQTLsv9@3=|%A^GF;5<`Xl(xa~=AUGO!Z%Rkkj3I?no+TLG(XMjuH@nXWf>
zFJs(2zxef^A^jP!j|jD1e({?CRwf?w>#8fJ`f6`cO5rzR0KGwWi_#m-Q#W%Gp#W{U
zlwVR|Q9N5U>Gc?DwIkDK$i8GW`cYQc$^}PNjm<Zr0Tb;oK*)n<vpL8J{3jhAx|YFJ
zStAGZuF$v`cd7VV4h?uJ#=YqiYc8v%&WpEi>*F~Cj59i_^`OHAb#m~dvPUu}vzX7;
zR!2ubqn%?r3zTbpC2s}xn#UtUd{j^D4h-DJOp_=R+|(jrH`#@)#F6AnZ-hZW>T<ws
z$10scgM29YsAFx-B6F!OK4%SiPSIfcuKP0vFPf3zQ&1uGr(Vf(JwA^D^Tp@YApYKT
zhb2Ql!j6jHR~je?#f8hK^e43E0F#$j<%gSh6?sq8@Wc_hBRDW2Y;w&C@6(dSP0T7^
z<pBr8YK+y7X`Y&Q{`tCwoNSse-GAFJYad1=5}683g>3WXq^$(cLTa$$*QSFE7jH4`
zyn6NOv;L`0h?)8i9-INoHgu+{^0OzO5_k}Ts?s@d5pOa?#`3^!Nxyz9l96%>%hO$Y
zHug5uIMfw?p&7Eg(d~F$AkC}DKGD8!1D%lS!{UtVc%uL=;Uq5aRpdV~vA7v+cwPPK
z)mu*YXRMwX=8!d?awP!NYh8X+m_*(H=JEm`1M<#c$pFyxt<pP-<yxwC9?psbL(l_R
z5*-=+=t=i2&}FHZLP%ibB-v(09v~Od!l-jar-2`c73_)LhlsZDHyYw_ixbu9F!QHK
zBgD1U_sDYF!vIv&mA$^yvFW(89*wJSzb#f6{|X#HOYj*RzF7Y*lW7><KD(k%DBE{Z
zBMQAFGYHIMP6%ljsu0*(EKNx40~tK6f9$JMaDrv^=|%bBP}o3%r&^A%wfGsZk4sPh
z7Px%m8S}1toVIrD+2G)yF$-?BFn-3ihXxQ2DPS0ys`aO3zVrdfLV5F&zoO!qwwyv4
z^i&+(WBu>R$iPN~8~~xy%w7)SW0MN#xda<IT`)+r8e-VPfwD)Ve7fLrE+z{|RkmQM
z@Pa45ba2txH)44uHX$fb{ed&=>8($9(LKntC=7<+q9pRUn8Yp5Hk34}sWUlYsNG}`
zf0R#MPvnrttC*6PQjBh->&}F@xPML=6r=lQ3a6Fz=9*A?U%;(TxKV2`=S-V9!8UG~
zrK&cKE~j5$YDT*AT%V0I&|OJVgNibu>q3QbQ*ZyhwcpFSv4-fTUR_N~d^B$A8E>Q%
z6+R*8$-UEk`R^i{kvS~xBUKl0nguT-<?xci^rA~@`<UXS&Gbh?qeUnc)%`j24~R)7
zI{m6%3+;p<l~$iVJ||ChFB!Ur7uIq(Gs3dR08m}<AVT4uO!%&=ckiCH%ZV!-{1NRl
znmbu0nzm4DHhsA)TzRu@#%}XEcv>7fJ#$i>`3qO9*uI9SVsN4I$HYMTN-=Y?YPD#Z
z>Q>WAMm5A?$v1gxF^dYl3^m4Yo8UlW!ixl{zN)8ER6%w_e2JD+IXpYOY_);J5GJtn
z$?oB2)5Uj8P!*YJrO4Pxt4L~`B*=?P()YSJOl`o%g<d8_Z^A}#7Q!JwEX#=JFFt(e
z`><f5+{*ebm|s7ekRZE@5l~MlwHG#@cG1UJlYdb2h#^4Lmt5;Tr5kun-FC)Ya=1c$
zN2fQ<pj*vtEE_2)9Joc$Jy5%G4q1hRj8<YFCe#4g>BOhjsca9Bg(Gq_dB1~nCpBT-
z33HV!UTT)Vj!VDwSewvR%x#{TaVb3`V?$=an9>DmwgYr^Cs#JWa1UF3!PZcrO}g}O
zI`7hlFN1W7V>SA$f0vd>wXaftY~u<2j9zi--lXSF!Qi=j+F$Z2&K;rNp#uU7FK(RJ
zCOx<rjOzW(%DF~Uc;26o*>+*}pMj<2!xk{#0n?vSRPGQ<E*x*$;JV|QL!l3!o3`b*
zj}&nr6>#<KS=RD|ITNYLzhWXH4AB9yiYP=a<|T_)WrarGfPf8~H`il%TeJ4<8`2Ks
zxdzTh@-JMrc-FvS#gRef=qwEOth;{wdhyBOToG3HiK8poR$Sizl!gs!{14?&C6`RB
zu1LDKDn8bai7mEXtl(a#(6rrOJ%qRzs)~j|R>{INj#)E^s7h76=bl%kRe7ND1Yl*o
zm*zF`vj-i!F?cM`PitQVNcvnv!NQN{=1%Ojs8=XNh~QS@+JY+8HgipQ)I<}OxC?;`
z^b+eo>RA{tK5H}0cp4(y!&OLzHR&i%hcyfR1asp}wWz7DKi#Rj>NdPD>yxE2$ZwQ?
zyBMaN!_P+aHCO$FRj@}{16V9^{K&H@UdiAyzv30qPTbQ<hEC}5EU*kVgkbH*z5q_?
zCM0b`-nx?Mk$XfZytS=ZLJ3Qo(rxENq{`mjM$wNiO+E7UMo~F?97~)tt5^!WkpaCf
zefu`io__Cr;I|uDS-uo5NaMB7Pgnsww0Ox9=p}E|yXKzN4O@F@ns^0u02MF3)uJc!
zioPf|WXF52j9$CR7_TTf(U6~<5K!Nt6yO2TbS7f2`D?pu8YDDSCy!6HxH~yXp8xRL
zU&C#Q**6(cjxkC2TES;kf-v+;EVVIGF|gWn8S)_(9CQonUIK<{FnqWu-gzX#2vWC*
zu$^0fx<Km)%^7K1JUv9oj&J-lGv~7imqN+=d=_5Ht|$KEM*220uK!XEN{>8Tk3}|-
zUw@I}AjYTk-l^hiT!oFpo+X!Qx=A$8dhK*CzCY$=kAeIpO`m01C^uzno3bR;P-Uv(
za9W+5*RSV$;QxRU@}%(r6PBO>hcrSVBK`~5!};CYcOqa6GXsc>y~wgbBRtz-3?vas
z(yw^vqfI^CrFm)t*@@~^t9HPLl9}j@L@X*;rCUJV?O^Au@*s0O`FGV$w;kV#IRuPM
z%24u&K3gPOQ?P0E>u1LOo0hp-h2+a882d}VU%!|;so|COZk9g>4IBv4xF{hte9%cx
zx_GtZs<MWH$BrDC+<oLKhlNNq5Pv{lPhYBRL(EnX%=g^*apQ(p;^2KI7Y!jWflHv3
z=BWFc-$0JwOQnc0qD5qOr1?0sLNaB97kE#PVQLCdniLn`{JvaEK@)`ZMG1QKbeNVh
z5GOOi$}r?(ZB#3Ok_kUzXyChUcuaJ(ADvQjzJw6}b6s4r_4Z82xqtr}@BA*iS)_CU
zt_=G5Of0a#WIE9lr3?CuzwpHl2UJ37Km#^F<sAQFTYe@MVAeTzw6C$IjDfM{lu%l0
z^+bc{OOvl$Fn|MyxZ6*M;Yd|uwFgAZyP=~R(qNA}@m?!wOZ4d$FSl>sUgL5zZJKP3
zqTU-zBEGSwn+VHg<bzL?cg|d!&RBE_IP=!$ri*A!c0UoV#B33R1$nnUK{r|MozBgh
zX14p%$X}JUnKKT$P&sq&c&*o_M)wg`AOSvYf4TL}%o^Gmn<`?(IsYzhpg|c@ps?gA
z@}5zaQ}E>NM`h{+!3awxSb-OB7w)<3))A^b1k#?1io@wSW+b*tM7ly9f!F_*og;pj
zJI&4=#|F6e#LhSF2E1R$yF*Kyf`b}On@+ddxi$sJB-P2y(IyIh4TtqD??uZA|1t}W
zA%T+k_o~0SLNg$YitHYu>KC82N{^)5Nv(CwAQ~gwO`09>!$_VM1`D7%tR<l6%%!(D
zi#-ON!h|y|Iv;L0B6uekK@5|G&7)<v<)ZQy3&<szRo}}+_yDkSv+Cd^)oujvFXUJb
z(~rFU2Z#!)D!wcz9fe{7X~QSVwO2%AOg-v;Dx4pMq#7;csVkIQ8zG5`KA6kvt-rf9
z@RrA?tMz2n#H5CyH-G$CMDh?ynWu<C=Z4;$>0~%raUo0JPHyU@<=S%);6H<^8FcIt
zv^)@t9Mo}8Au8IMb@hqkL2|_#iZ!J)K;WIUhOZ~6?qy?99r4fRqU!YTZ^-_Wk~S4(
z6w0y;6`8!u*%89uyn3a?z$m}ZN>e4Y;>g!SyLa1^x=s%FY}dYh7$X2|8Sx4aUzp$&
z%&S%Tc4-aeCQ!>&TF3?zRC%syv%o}a8midX34Pb^@4UM{o>Dr!KX&g?+at+he|H@X
z)%v79>WSSOI7Z?$2qwEw-M0mB<R`Xe$ZAG08=%#4L%V`<sCSk7`-+yVy(j9Q^$(du
zEpV2ID-;@V4CV7y`YfKYoB~>bM8_N@wqVtm7%^xt(P(yEiP1m-GKEHYUGTbZ8|G<c
zBxnG&&WsDoj0$7EM{0~k1pH_MMj=pM>`VLi{D`lZr;nLCh;$^@Tr`E^Xv8dd^OVCa
zVs*!by?Q=<+BB^vW2V&<SZhFU`iNgWkRZV25GU==zBl3KolGZcu`}l?sS?0!Qpuu;
zc@*sZaolXvrp*h~)zVOxn7>~CY_bX(;J)A^LkHOIRP8H{*eJkSmMvO25!~?wMZdUv
zmS{C5>TSX&&??|LtP`UqJINQm{ayhLx1ms!F;hlU2)mc$40C=fi%-SOk6lOec10za
zcf#G@lj-E>czN=N(@XNhIhWv$r_^(y_N2Uey#H)ZBvz6I#oUXd@Pe)v%o<nWTMmmR
z>^AQjSNf)wM$ZOs?@Kq-vqk+nm0T6uObyFP_~nxL?Qx2tGn}KoxrHqM;x(=)toTgw
z#TtJr&PiweJGUg_G7q#+-6T?Ufm|dC(W9vcdX<R#g-kqg<895>#85hlA+bR1AdwM6
zG-^wa&Je91nOQ0j%cNf#F2H{>=g4g8MlwN5X0~^|`y3%})#pCrsUoIHuu@ZXvF-P(
zrMkLy&z(uDKP#mi*8Zs7r%%+9sr{ZMJp=GhwCT+CG>_|#pVaN6!-ZBkIMj9C-aO|=
zWm!FUM77S{XM~DYfG!Gw4lp_P>fwQ?h;C!&CFxSM4gd-=F6DN5L5y?HFMw0x@H0V6
zQ^y^_n;5UUHHwtsSpc%nSL<~;i`yJjBf~Clu01sP-1QDmTAV#x11}*`5^$PNG1gX9
zU1xrM=^^-^IXU-#y1sG>*4=(ocib^pga;i_+B5|b9P>SwDFC~d6RXahwD|e{VN55)
z{P_`?u@Xweq*ey2=+<pBZ5+Wiy=hB%s;{T0zPYvR8c1P(=YZS$drVk>b(*jWfAGZ9
z1-nM;G5u)SbP2vi1}s--#-!5nN5xayQC1G%pq$V;O8<q*ZhQAFV-GRS5B#j!wr!-E
zvd!nL(a<mWJlU%kT|r#Y2w9X^G=T!lQ8#-Bk@SKvBv_yz+FXHH|NC<UDq}{-pQ6kj
zxKOA1R}J{9dEEP1g2V9f|Ew7VMZmS%ZP78>j(<9wDASV28sJAP<HF;?xV3w0)AZau
zRGcT8S!(i4<}fiU<Dj4~xAd%ZMX5L9=lg*&&B)b|0;t41EC1iIA-}(8uV)VB*4DkR
ze3nf%GO8sAIFB#S=J*E?qc*zE0jbsrr~Srj)lpcrG+nWLxmuEj%H>B3ezAgD#tQEp
z32TR>dbL4EF}tBh80U~5PV+|oId$dZ%-j(UAtX#O<3ldfb;zWivA{9n$wk*N^}@sC
zZKLrh2V9Xs&KE^RJ<1EVnsz?4Z~549-d|Rx<lA+>)uJsA)Px$x$2jDkMfb)2vb$Rl
zdeVo4Q#4UhKJ>AT^#PwA1Gf&?v5`_V?$6B=)Vs&|ty5Og+L&QQSkh*K%tg!OCY6rt
zTp$8JV1K*xv&7L%zW2V++tH3hBq?}N;HBKUwSDi9Z-mNLs0@V45C{6W0<B-x+a<?s
z9u#lT4uf0NLKD|W7ppn;7BlPAXkv&Z>h&xBI##OHw5@~!ERwZ+dlrF~b`a}Z(x^Y-
z;uYOg_|^eC?oU>!ejB#)wa%Drs!B3V#bIMUZ;tw?D3Cm<cF^JkxCM-c#zOl%YvW17
z*a-<5H<c+v(_m(nA&0TDTDJCiyfyV6HF_vWe11W(erYbteR2k#nhDp47oQI>iItic
z4EHBy$L;Cdr~T_5J!5SAj69s$XIx%w(>HVMm@&H_wJMK{G+Z-GBdyj6)0=gaYVkKv
zpI9r~_)}4}!phYf^gPdID8fAS$+hHxE=<%KfiVDITy*xFrB`4CVpn=(<DOcKM!jdf
z9+3f%J6*VM(wUW-srQh_$C$-#yS}=jwJg2U^Pf<L|0=IQ4y5dZ9ymLbPF+`^8R75g
zFEX^+`aKQbAornj4@>Qx7#?9&9&|HI-pb1W*2m1n90+=8-d?MvTl#hEJ<f=J?x`qi
zk@?kLq}=v|Fw;`pQhP}xMuI^}<Q}!(7=ar4>QN`g8@JiMV~6ac8y1%}-}4CK1tCWU
zIjWXu`R&25cI&$k#T+X5jyp3CZHS;Htn?UxFNfMm4ZCU6DxZ};MGC_RqaPXaMuGF;
zueOY)5l3r4jGfE~xX$~rU<q|=Q{I;tsJBqIQB=O(Yb{oxBJpFOo*pZn2EBl#Fe#va
zh{b!y6^P{_?TpUjc_W5>&zjzA%ks?(qR^Yj-da5sr{f|MMM_MgHJ5vWOn)nVny?Y4
z!|p!@Kx9qHqvMCqwH(7H#?;GSCk>{KOcA~S9uiH<S^wPmLT3O6Yy$d4(GNf{3!Wdl
z%q}uO&}+-hyI|VF_fs--hGKUMs$2f$iw~u*ILHYh%z*NQk#&cxe?>KE9AII8GmJ)C
z<m+C=Z*l^YNxsKO${)i`$zG~T3Nd9AngKjzP^3n$B*&OW({GPtZwZChFp)wu9a*)@
zt%Dlw>fk1#nd7#K0o;xFft~-EJT3(B)hGnP(guiEEC5GMa^AgbK`Gsi;H2FD)>QbY
z0bIXsh@}OvFrp@C$>4cV&n-$WiHAo1^R>^Em|5Dn1^0u#+D>mU2*eE(D&p(V&+*w&
z>Dhs~BUp2BEGFi6-T*WUvce*4{qJ8o7vFZ5+|2Jw0pA?pbgwI&bvgnn2Kuk@_98WY
zbYwn*EMQ21E=$nk3hMhBE7+auXOU-ZuCO~_cZZ)ttikSPG=t!VXZ?-ZX;PCBbHqNZ
zL@Q|gj2SyRt*flXlBb?9uhTLk&l9m$EZFc02zTF0e#yZRo_Zx(W5E*|8+2?+=P+g4
zhET>^z_DG440i%vOhu4~9`zLy>|+O3OwAGX61blHMbv$p2y&8@nBVdRR%4x=ESVYO
z>Dg;bbK;uHnKNaMYuD<Ds~V*?AJR}u?G?XQJ|NgqEd^|jh#m<P{6oEds(RM`RlzN!
za8#r~_~YHLhj?Mo+TL!kPCSfd>oz!Y9$0U;g}V3p<&`#_u(e1<SI6YLAEk2*opF4D
z=&hN+TYXARkBXA0EaM0?c*ehqc(Y?yg~TGs7f-vy#g9_;#)fr6x67c{Y5V(!NtEF#
zq0+EYL+#$XH}}Qi(Z`3C=01H|9bNkLuwH2#^bkFKCMksu==bQDFmus5AR;^KpQ9mw
z5SvGQ5JX`eALk!-mXuF<FU0quR;Fm)b7CFF9kRS-Wv*Dfq*h03Nm}RP;=&q)c4(=p
zD&mbpOKeUp7Ci|i4N3<uGL?8jGrn+U(5N^Ltwhg1ZF)Dhfr`fh>)?8-ghKn!SJ1z{
zu`r6~&&fbN$nvp4zn8Y89`3|f-^@X$P28~J-x$=ct$3F;I@B9Ig3Ud9^!)SQWC*t|
z)7lK_Csmw7Y0sNunCE1EoqK2$G}(&0y!ouzvy<~~gvGlJm-6Dc10qkVRx`vXdlO@c
zO>e%`$-$6F7CmD1n8}rwyt}}b#EuWa6j{XiR*JA07mZsNIqVo4;<GFpt_PXd@s%x1
z)Bad}H&WM=<kdpO7nIjQJ?t6GZMPw1%e^_H6cLQtiS0iJ<OSN^gjOR?CG|t&$*9=r
z#3`O9Jp&IPHUVMjo1MkIqQOU0IX-ZMBPmV9D0u_g%?E{dd=S-A^oy97o%0X7D>5PU
zNQXL_XsO|U-yBtpj$Nl0*Y7Tz;A^OnLfu6<-*^(t9sTwkhzg7BVarB=yGo%Uo2CRL
zD!4x#TSdF`OS5h?Sd(xOrI=lUvogZ5Jez<ioLBKj%o}k0q|5Up0UMYYm}VAvo@X?V
zk`K?S<2vy>KCLzoMi8P<oD@Fug3fZ&@J_hOrF+5DKWNz)w<Ukx*x0cYMsQPToz|7u
z(=&ihMo#I_@_<>vt5;p8KRgBepPCw)R~A82$Y&vjj*=MKBsMW|G^0B;WnoLx>4}SP
zylW6D-9B)i?6N%Bx+8oIwbo|((E`f2H2S8iVXh-|Y!cMkq2r+#9@BH>z2jq6e%`36
zyo#uyh;TD&+E*XGoOlfs4Q3j^L4I9Sltw4PSsvKG|M=?-Lg}CL`gq`Dufltmm1E*Q
z2uXdT00~l*<=4~0N+$~CYpQvxr<A=wu+uVk1=1xMc5VKW7ZLQRr@5tNV<}|__+ylF
zzRBhe1k_A`=N*4{(QS-{MS#=05t_9k9Fl6;@NC?9EJi?lfQGi2niXGAS!oU#a=^V_
zWH_KP&Ey<Vqtju7%z1kp1nsza$(NrdukQqlsPg@ijqS?f`wggCPTQONaRNmpg0%fk
zm44-mjZKAzgK>EwU~hp|G^uVL)5EfINL<)~HS%`1JI)5-{}Pw9A5r<DHbv99F%Ks=
zht?D%_Zp!v8@ugj0?umiPrdr?qT@ut-8|*r@SS@4`f1bvN3FL?wWzX`dY#x<512aV
zZHuHCM>X031CXL+f2WKr?rnrtSolbBkL7v2;PJ@p-QGSo-_Ja87yA{Po&l=<7a=%g
zd<BS(s;ihcPzlFno9Q@6Kt-L$Dz>d&UrhJlc`*!D{N&m2e%5a8!T-|&^lOSLVo!UY
z^e8KVEKNX9Aa$lJDOrV_@J@j0^Al(^L^eYTwWn($7(h>okqFo0G5D-FhciKn&MTH6
zNedt_Je;lhg7rxlNW-G-zLB4Dc*EN-?{uagy}kv=h%SB?tGq_0ExRsYB2reXD^~NI
zDAL-{1com)Q1U{nGnePiE6Sq4&S9PwF2fEV;a$++d?J*qTfnF(JWOd|a6Q>xgP%-v
z!4o`{vn>!OZRA=1uz1qCACO67ZpBs1d8c6tNs%IHLLwcGcK2_V*8pF}*QftMzU)c@
z0uV@xd!})SDif%Co_9h+(RsIdtlJd^NB$(aZZ2$pn`3WZ8&K)c)6Z6N5z_}DevqJu
z>2+P4ksn9sa!7H+@AGDU?196F8$y!^5C?>AzlR9imQfBdmSi}82dww<!Y2Rpjj&T0
zPGV)8rQ3<|{CQ+m=lsp<JNc03roQ`CeG;7*1NXA|bDEjcpfjyZF?)M{T(>yzt8Inn
z$HQNHCPjYp%pC!$Bm3FeEoS|$?<^|8wlbS~=guZL)smr>8Aat+3qBL5uSITnON}Xu
zieyIT_`iBX_4Q3Kl!CR^`B~ml#TP5}WQ)9YzdBsM6{cNyk)P2-@wXk2Sy!A!nCM8;
zQ|SSdFDCT}RqfSJ7{SaUDb9PlV$rs@yl0Sx&LwTeTFyxEto#&mJE`c_UJf%pEw1Q+
z=rcV%JkFx!6kHekY<g!W6f>ekkmN>9JapK7XP%oZp_3gM7<rCyuykG^cj>qh^ut}u
zlYzS5MDJw5dFNrnF50;c;tf(r0b!ywReW0T&opt2n;Ty!N%Q7UCt(>(Go%cM8-qTN
z&FOJYS69~t+>7@$nF&Y{zoMFwnPU{|PX;nyH<vFf)2gPXKKGXFyM2?68jq1{%o)^B
zEzKHeTB@~gzn%Ih&R=tKNJxn2dSKz`9J)8(I%od;IwH5RDK4Gaf(Cv>NiUBD_<ob{
z{%?jie|~mgx;3ncxN(@7h1(n&{`-8VFLb!b3?njzyDGnV|Gtp|r7X2x1f(&~5&!Yq
zkk9A}LXl(&WEH7lSC7|<Q%wu1s1&HlUKJH|sf>enj?*qID0qJP#0ITzvTBt$wWalM
z&E~$}7?wH4m<2ZS^XMS>va->54xp7pREU3iLFX%@Ge?26fy@jtnv{{BxTGNk(Uau$
zv#DMvLCJPPyMpE2yX3YAm&OL5j&dzIansBu*ztZ-glVEtc*%#FryhQlBqQl5Ch3RD
zvuDqk<y=%2_~%w`xi1p`J9n&>uX43aSTZx1@lW*K^~8~hLb%rDLroSeT{^4eYXx-^
zD1VuUopge`_s~VYqSgG5j}T_%h1z$_tbWVV;qGK71w`Xb&xYae-!B$JFAhm1)ap69
zFG`>5x*K)2p+N?<`1IH%S(9D>)g2n}Gz!!RwXs|FYz4^%SRs)`@e#zF1rmhkV+RL_
zglSr4#6*Y#8AD?bABEL~=sJPS;1N7;6#NOaHQZ41h)Ou%B@XLyw-Q!@jvT=bFKVT-
z4L}#cOG8i3u4ms}wY?G&bc<AKqyz^LrcubPJz}?+^JR~+LdRCWTQ_A&1!)O2YXJ|B
z|J3jCYjsAzAe&S4>PCiBPS0bg)sf|jC0Z&m%=rkX3e!9E{J%HR{R0Q<pZLBa33oWE
zF(#r@^tRnAAvNt?r8~Z>;54*m(=r{;f>_8j>jg;1drx;onM+^Jw5ZrD%W5~A@Jh@Z
zf2GWkrAe7kl(NRIdyH9)V8iFS<;>|1YbUfe|4R^|{JGJ}Nkj|@3HxSrh_usiV>}Hi
z<MsD=iKP>)X@W&JD=S2);fGXyrUwrS)L@Euvg{%j9oU<7sUHQ=p^>57V35lJCcyek
z=G4Iq;)*7kcc`JJBE*dV0~r2`puS|ak7`?)Du$00T@QJ)7iPsgs0Hd_V`O-HalhHX
zC4lkYtbVE;h`uJGVAQxQq<|GHIFdU8aR#d_w7(TiZvBV-i}lxRK`UX#bOWg}t*CrA
zp;d46MmEm13-<ilw(snu+ZP)wEqndpgFk}VcAUov$rrTIb{Z~dVcMekvjCG}dC8rB
z0|b5`V2MRbjhaNIM-@+$@sXm}S#yBZMuFPcQb5Txaen@#oQWUDRI}l=0SRk?x`{I`
zA{)Q}gd7g)WwELxud%#9dcO#bUiL66nMiuhN#*{#`Wx&*o8atBPQqCT1Yo1V-$&2>
zQ;C|+y+2t)n~6|o=i=#aazL-3>iFtm`FaVKo!A<y9Gore=ihf#Hj*ok6;~#MDgj9v
zfs}xB$g*Pt;OyuV|LHtT8Qo&;0J&8rr7x{?zw-sXTe$Z80$^!^mW^F)g30&tZGO)J
zL7S4-gqEhW8IpxaWWHyUTR`__TTLfi(K>qIz&A+N_>-Otp*E8SkK?I!rjDJw2n01P
zXjG<NdOAa{lW;Mc?#sk6Lq(_U2OZ>$&X_Ud6X$cHQGAmtYb#(c+wpPgVvQPkhPMG(
zzlfVXI;!N??;r733=TA?qeN4*(XG)0cHULACeffqx<Rs&%}#XrK3*GVALDq+0Pb0T
zO<nN}E`9UnIC>_a3PZ8#>|T_2l7fc5H-#fMbZR`=th=Oq&dbDMcAGd{;{PR$0{{mK
zxCQEwSCcAVH5AHK?kY9i;rLc9O@%y7ZNMz@o;?ef;OXrDf0+6XaIV|-{jU^~L{xT0
z2}wjkHc>W7WfdBztdN~D%c>-0BqSth5E;o1Ss^5Z3fUD=s^59j^Zx%Gj`w+v=Pmhu
zKKFf%^E|Kff{;JoFA)?sDlK?mUVDIZhqJzabi1eHZ$b`8?IPosh!q&Y{Y=xB%Xj-l
z+A!)b;J;y*((4B_4FRBw>;#65r&=^Ol9~h^a9~bOj(KF3j{OZ)C@zSyoxBzXXkv&p
z6zDMsA#^cti0>qGZu)`X)xCizNjm0bcc%NkIQ8Y^nN~$C_F1a_0YNfglocU8>)Z(d
zY!qdPJ`m54n6MJ@VBy!>&<LT<uEv|1n)lIjkXS<jd{u^AceuuYY?%ek8naJDN<zZ$
zM0Y*4qhP2=OUe3%NM&ASYwMIZ*DqZ^j1q*{Tc6jPnfm%k8>AN%rnFCRr<GOi+9uq+
z+|cg4qd*?a%~)VyPNXncaR*JrYv>8#hfYR-hWx5$06Zc^5oA*5w)`zOt~6;V&WV&=
z2|_wlkqvTs@PN71k9GFdsF4XmnR~ixE^f=xi%DUHjn%&*B<*cf$1`7FoNB0B=<sx4
z%uaC>qq!9ye=uIo)NQLbgfKV{ufAoH8bs?jFe^Z@+t3Pg6pzau6b$v7uG&xlj{zuo
zU{kmC+aPq^14zxp=$*Kb!Ta>!2{UyO0bC%QW=+VYVpLc1L1}9YzRG3me7zdp4~Roq
z*_~>LkSECi8gdm#y6<miCk|-eInXXW{?vY@@q#zf&8>x7oE#j>JoXbe%o{&{K6!(7
z0+lCLR~wJer;xygw+4}p>~BZa*O>7o^E*UwzDI36S*4B6&dI^s!1Ehi<sfEHd*Ogr
zqjTPU?_Nsq>gcYo>eWa{#0KQ*-pbm2VGVnLk;8oiR^u;ml?dXA<3Lu?p=OvxY2aTo
zm`r+%)V+I9-@_un?qWs)ejXKciZCxZh@xk%uN=t>C9pUVmtdq2-9gI5jBo^2D-4Bo
zV$zQ|zk@?W%k~;|r1$KY3M5jBKZjE_aw@Wu)-GxhI5HoOkD@H(TYCw`a3JI*7~<fA
z{*lxdm@gqyaX@h?j)Jj=&CC#TIeZj1`Y0axN?u`FoR}JJ*{h4_$H|6EV1T>s^O_nM
z@WvlCa)Dfg%;@1L-l$g(0i~&vD7Ow=%psWCzJO6OjsA%<k(Fu9M4o_ZoeHs-2wvbm
zRZvv4^#ETu(;FG6yB_7{9^+QK4-p&L?(sNs`UZ~44~NOygunjWh)A!drZ$-ElAe_{
zYPP7&y`|rJ-<0W79MmEGfc(%!C3;v}ySO|tVpWd_4=2_hXyqFfHo_AK7$P4A0YHAE
z<hJs}8XOQ5M%#C;3R1o0>nJ2f1K;{EPqC-@`Lq-;r2AEjFIYfb1kD5S76d*?mNt;2
zyQ4o5Gj7&!GiAgJAp`(I0?zmyyg5?AVbcZPoTE{#4yG;&KA<^5K)wta`M*gI%p0JC
zY$F^qC{_W80pJ9Q6m=7H8vzOt4=QSE(pv%^Eb*RKPJrxKx9q})#4XRkf=$CU3-hhU
z@yf8djzYM_)+NIo4H(Q>jp*a3%d_t9z_)qhcf5g2Z^q{5=02dZ+k=^)fM+M$A$dV+
zJbv?mUFGox%+XlEV19>EFQFj_kqu=yxD2hls+*$4S*#dPD>Xvn{q+W#d5lpY@gE?A
z)v)pv&L0G&fQbgyQkec_&C2-t{<e=+$kO`-Ua5)<OMvtzTUI5H6rtF;bN_x_?L}KS
zp+17nIjzXa&dQ1k_W*Nxsc;j;XNN?A*?-r5_va=|J9q60K_Q4&pTTPyf(6~g?gEDi
z6B`L_Z*_r@bbY*EseUJA*`0>f1=>fBY(!{VQV+F}MK@p`gCYMV6(F2hp_;1!@{8MZ
z9h?w;EvBxGih)p*rVEapwZLT}a}0pDs(X8RAZP@J9x?FgQ&5xQF9tXqTpMi~X@IW;
zJ80|>h=cVo<3YBy5~34C2uDc~?NV4&?Ij*XfYYw6+MkzsX4Nl@I+0yaXiYKdly_{K
zwsyT~JsE3(&S&7g$x#&Vd)4rQjzWHcaSfjUJ%6m(*7~Y&pasjzh`<`X3Sf~aov0ZE
z`?+6>!+@kZhlHTz{(-Hxc%rj#t8f>I)(&a{VkAI<<0Klx;5CYK{@|hZ>FQPiu!@sU
z90Fl^>V`62((<Xdx%vQZar+K>9|7`+CkV!SJ^4)OFM_{$$YXT(>=WL1z=-gp44|pS
zeWiuAB=z1s8bnd_zc}|P_A1xINKhmknFMPb_VAL}fFrpto5TixG#$6jNNk^AHB!0W
z4KQJy`Z{FzA#uVUNXU>?WMn(W$@)VWaRsAmjk1ooU1@68Xy{i6tR8}EBfi;V6dSOL
zguq1wpv};|W%&St0VflW$djdl&b9cSXyGrQP(15m?~JBg0^{NUodOnhTXcM)?Rh~8
zQ|=dxeW=D!9zo?(g|3KFEPMq(RJ$op+A?9(8^_^dxDtYHE=8XLl`Su^0%96Zon7!$
zF$x~C=ADR=Ac{KXo`CTL6p{ScT?m@)9!qGR$3bC?Pn8(cZw_oT1A~BD@UL_YKzv7q
zl;>BBX##L%)5yH`QCYy}7wP?{Uuy31DJXE`O((p+1u){E)sdREDgX~?@CwcjMWQyO
zdI?4u$^t~UAb|a7UD8*jVERoR2_SLv^ykLbRu&Y+H{N*-yh(aMpQ6gwd~fxgRDtME
zml9z5$%iGVZVX=;@r-dxP_m7Vz*L`%PQnp_+zX6!90jmUP{Jp=>YtX;($eDnrgd>E
zFZ|eogN2lLEa6^1+3yE?6NJ&0yd&(R=q`}y$e8E?P&i!SIyAWSkPo4xO+hKX+E4!X
zYJtTDH6WOEZ`FnmkT?^)9Ihd-)q`f*=4{z#)@EXKtN8YMJpVVg@G&GSHxc`T5QaKN
zCEy%EfA|6MYbM?xuu#QjVoSjq<l_p^vxKE17!wLd%q(Z>L{{w?Fd9Z-&V<4TiH?{%
zBYeFPBD<TAT!&VrAedis8NzP?rRk4cUwU8}oVzqUJ)eJchES?@fTkLTR8Vc0Jgm9C
z9*C2tJP&C!&=%mlM>Y*@)m`M%U?h{UEfkaoC-m^d_xz*!M$c)K1b|zvL`PGrsZ|K(
z{J;twQVLgBYtWDMuHQi0*-i9tn!t6j?ptP*?ISlSdXkd~Yy8%b)e><I#BIQ0ef>s=
zm|kgU1RJdr0VYmL*2j@84-mlafGUCzgD}oOw=j3K0+}D<$AM2*w2;;V{T;?|f$8q#
zi3)+s0TKUpV!Q{=x<t5&4^MU!{rx?8p7VeUP!T+O)zD=gM=nS~mJJCrF|tN?kGV78
zT9}+hC1ZRhUJeT&4jn#xp=qcBrxCFR$$EKG6Kzsc2!^M&q-O((Fcc#bAsBpvmm352
zczP*l09^ySc*Xfi@TI85g^p86e-~(x?{>&)KnM&Q31Ve)8bej+P}9o={*<zEK&wj-
zKqLC!5Rw6fptHLMa*ATmdC?YF0|q>Fw6(oQz3*Y78w#xZ>y%C{BD(vB;~7B$$$AF_
zrt}UQZNz4*3W&pS59Jh-a*UhmU%kqBH_s<#hsjbjBGbby0wSSrlfh|FdRfcwN~nlo
zSOOVzM?5dym5^anX4hIri6e%FD&5Lk?_ds<<g@5K8$8JXDW*>Ay6m!Wr-()#Bn{dh
zc)7-Wo_7ku=(=gH?FF3kG@;P@AVhhYKA=eiYH}I>7s4PRkyaSW-js6_A($<qvo)9)
zQUQQYfUjWy`dVxJ_@H_Y1n@wNfXW%%2d0lMT)I@dJOAuf5fN1{ub*ZtdvP?JfD)jR
z>qpsettm$?DEIRwqYKIu5N)0cJMkwQt|PaSQCj4Qjv`(WF%t|Zi>S{-NKXd@iY!S&
zk$=o39QXVvVlt7|px)%j^9|qOiMWRSLL{#3)dllRdF5twyd5v$%%qrKd}5+S4zx@8
z=Qg51A{-)SAv7GC_N|BF5f<!KavG^l&w0TbUxo~XC+A3MFofMmA~wg52cbwr%GEG4
zD|*K$W&Q>fBbnp@kaUcDPcl0j8`(4u03g~_rOh%}Kru<4Dr5AeFRl(&Cuu;%jQy*i
zM0S!r0T2V)a0jrU$|ifUNXKKy@d*zc+L*N0_Y~{n4TMOje5%y6nNZlszN*lEVfb?p
z-k~EygGe2V2`p{}7I_fyHjx60Vs;MyKHYxsNIwuFyes<v9_@dxVl$>j_=LS*Xj^o5
zhW#!2;<YpXVU8*Pr*HF8K~Tu-jV4(g61JIMenZ><luCeQGk!e#{zM8(YC(%*!f2oG
z7d=Z$9%3GW(PC><6hsvWvOdj=;UQD3Dk0y&VS!m(hWwER-I@9c@EW-NZ$5Gk5t${L
z9n)1w2l`^;;(nSq8-U;hnEGy!M(o&X1LrdYTwnw7-+frIo<Q(qzCn9S3rV4*z`;u)
zhC@(fM4Rn;5r)-!Ah-=pP4BbjJOvRL0nQll#+Gb|x@fCF^zYc$V03t^qN3%As)PY+
z<xMFoQ|ibvyO;5$+oA6jMQruJCL$EMb?9_3dy<SH(1gUm_=E%o%;KbZG%PE=6<Rkq
zz3GTe=z>#;!C@Bk0gEh|Z7#-|iRBw!ZZMQ=qcU2Kz#<441u@TZ(%Cq3yoP@iCedCZ
z6ECVf5w`4qyf`xk=tQ`y&~nq-eb1gmMMi3%MJAL&v^@eI79$v*8TCTtW#8Sk%QY9|
z@0HIrP%jZ)5`~!r24{cxy?FRg%zszk(?c87aR9?{_y-`oaO=I(!iF)0n^?6={He(`
z#hkB^Mbau1T@V@*bAk8oiFmLAut+8X)z#-v)d7}%@$Fv0eIVX(Kgm4!B1c%cYv9rr
z@3#rF!hWX^_}V$Y66<G6OR-jA=dagp-4gDoefZ{XR#q6$LNL91c$r?ld`W?guhs#k
zGw{5HJ{sJ9MOW#;11J*dk#^8jn1ULfTAcY!o`P6zy6^9w4PcW4BO~>q-(E(*h2SUc
z`h(B!AaPo!9)swy5@ijx%thfLK8;knPd3Kc*^TTz$1Ttf=-vj`pL|=~uYVN`cBQ}@
zO~uR%<IyK-%F3wl6Olpz@DfZn2=|803WAjZl%$x2I0+#jf)^uk3CCP68QI30`$T{Q
zIAZ~)rCd-pn5;2eoQ8sC!b7qF)4XYo+f453@ny?h0)YP%hCVfr0c}b$bECIwA4whf
z`}y1a>v{#e?@oJ=-^5)Kp-h`TrK+lm)CLen{(QT_dU{1Oa?MMCFeGzg`ky!hprFb<
zEu7TK1(ftAz$lCoEJKZwnQaE`El_zYgjv#!BbA%w)ZVXC6=KDPA37jI#JvS76tWzS
ztd+x|_&j!fjVj$P<HT7kU04at0D9h$?6tO9T6Jb-G93xCBV%LcXS~m$KE}lEUI*7J
z`LMg7*fs}I?=gl=EXc!~adDU<6f*C%zKyyN;sh->K6YRcEBsMNis-6bA7xSBZ)7xu
zB2iG^$>anmL1Ow3-0tn&uy?p&05@X0K0Ygu@vot_6;E)%sQhB<6VL{g<|XhKLJc<t
zpAcFGMEByb=^NWR6DHrUA6K5)-V_QR3X>VH2~>FK5V1u=Xi9iLZ-CPV?EvC!>ctE$
z$Up#+@sKgUldFiZgzScN#%>0f1{U^4r7o2WbeZ`-bom-Ui`m<Ypjf~cP6Qd=1+oA;
z4}pI~Pm?25PpC9;6{!$kQA6ze6OSsQt?hcWQZqoIOeH{);Sl%3{a6K;7X)x1wAVOx
zq;LiYSB;y8U?*AImJNI_6<QLo02B%yGxW&XI}buVi8|sjY9ISO*Acg@pcy6A5o*XS
zc|>vP^SwnAwKOBlHZP+h*cB#x3os%%I;bC*cz76r_xjBBhs?phLIMs6Ufjxbc2BDH
zenACI^xm8I=sS<>e+#)M6ueZ`)zz=*@4w;yBRODyRUeeqJKY%bLBvx`QX{3^w^uP{
zCqxtSrVV#$OXV(6B@Ffwomzs1Gdl+dd7@ZJtrab1UsF?qnPJs?D-5-@m9@2@tdWJC
zOZ0muRaO!hZM|$2NF|N?xHz396alr&J>%&2n3lz2ZGi4iKYsY&50)6JfDP#3NF$A#
z3C#-BMGal?D|>o+nBjecnGvXyMTxEy5R3p~iLB?J5<IXuh%uKy23#%)adCgJGtdUj
zH8z3Qk2Vj*l_Z00crzFFZc>G5;>T}QX4~IN2esjvVIW${Fq}zMMg#{5W*ER%*|1O-
zVRzH6weT?!kda}-&lZF_4L{MQszmhS+HY-JQdVH~jnK?#B81v_e&GV(FFxEk05cQ{
z=07$dZB$`{A{Ob+_PUWxCT?ysa`kFRhBdG}va+`)TT|QTeT~@xQWRpYle{~Z_~qJk
z{STL>xZ4)376SHex-YG(4_pMRe%pILDoy>T1rYRpD?R>=h<vfd1rFIwQ-`(m)$+Ob
z8w2*FyzC0|gGhnCSeV%DuS2LMnj6$DFq`#9sf2r)ixC>s$skc$P>3X_r-xvk!${@3
z0!Bdnp^V*S7lEq}Nz5(Z^B!N9Kgy4-eG^Cp;aghKK4o@5nj6seJg{+61tm^co}6zo
zm$kYCL#ttJ02MuAur@kgO78-@klM(hg-QOMJ7b<IZ3UFHf#_~w2A{YgCID@@&8NB;
z57eV4n<_B0W&_$7A>C`pAU$r_ku+7H2e$&Gs$G8jTxMa6Z~G2Ac<zuc3~2_XzR%VC
zXJ0esegNoBC|-qkdEM~eL>VH_AmGX6Q8mQ3fMOiK!vYZ#7(qWco%^$Y-n~lU^}-Y>
z0IvbuDWVt!775gwns~;`08J{<uS4n2hR!yxw*eCtp-_ClGV6RGu}A&Y_g7VWpXL}T
zT=CajzpjcTPwpPzch&ouXWpGWv$+{s#GQ-M8Yt|uO@K8K4za{RtiGw~;N^WH*64zE
z#4~NtM>wXugbv7jdni`N3=*`0h`?oxh^h`hQ5w{vo?)Jt*Tyr7Gdi>eM{TiFi;2N@
zuxO2JvUe3F3V=B+*&a@3=a+wj%hzt^MU>8pezy2XkgP}LYxMpcfw*yTD8n`vX&swp
za2TY31K`|TOX0t|9T5)S1@kZ_c8dft>dr-3rcA_}bp4I!dj+t7=V{O$F-$?PB9Z_I
zbQ}Ntop_tg2{|EFA3HD6Qh`hpUVSFBn7SkqAVgSjb@$Jl{7V!-n>VMud+Uq%5Dbqn
z9KX$Gop`(`Ma;h{E>`^ta94SYW4#8Mj*?+Ak(rsB%ZktJ5BV;D%ij6t2>aJYZohHG
zc9+`qvlKFvOHCpAAU?I=wo?)4#fWAa7n&@WM`f{jV;I~v02>gaZy<;^A75R4<GYOB
zA38XuJASQ-k~?-luwptMOd-~d7;BJ&7^;tOo{NLq&x|FN;GdBxW&#K8mkkXOZsCIU
zuV153VLa)04^Coa(;HNr$4y>c+YDd|mUKb~Fg=bZM8^Kp(t<!pKE)CpAH}5B{RW?^
z0C`}pRUNt~Af}xeI{}<qZLeTXBJa*`OhAkDT)>M#eGZI8aMTH+wZms7ra}Z4eDsJ3
zdKZ{3T4RS9#^~X)c3)~m3xJS27<jtZ7xJno^Z)DH_6DIQg_IA;tq$5t%+nEc9tHZq
zX{)Q+kO_#}HuEMZo#)ZMA!-FnB4Vq7Y1Y%7kCH8u^iK{f!tZoLAlzT}_P%Ijp@Xow
zy$*9n5M!Wv<iv<N`hzPzFVG%=R42ePP9riUu{lCVidH)i03;s9r|Itya%4teNg1(x
zft>lk&=AB^R20a_u+%H}oZoGr$Vj($<ED|h921Qn;DaD6ko-+%o}tlodw3NtN)XIx
z3AXEEEC8jExRg{SreQ--vymO@NKcpFBz&OtM=B>v9PpN<sG)&ybC?wS<BMJb8Dw)*
z^lYyFVYtc0dW~F<A#$nBo6Fw5y#fBx`{#Gz^z(wP?d>ZlWa(z~3gYpAPb=@Ya1%3a
zZ`#|l-2;SU^K4sGcic+KBARk+imoy6fKYiDcL5#po4Xe?9^BI|^;voBIF*)b&Yq`R
z{uHfU)aI`s%ogC|w3}<UpTbWMacjt`kQxpcZBZ+yrfY1C!_ST23zF@vVca&wq%|O8
zQ1cL6=j&u(7@90Xh7-3{RJArQ{i(>*1EBR};M8(@sbsdAh^P<)N8MPKC&pkyEFrJ<
zff6JH5df9GdD($&qFD~dxBGFfUHkRzit)Jau8#M0y?A4wO^EADN9(3QCOwE3*8$U9
zI6v0o>1q~qOL|JP=y?6JV`k5e)oUL+{xmUg({ehi)n%KOzhkl$I-X7)wEl$RtdY?5
z{icmNt0d3R-pk!je?3{5cjf9U$~&5KS5j&1y?Cz1ou&T9!NX6A>z{o8-TyrQ#x}=k
zm+aA@bCFTcymKt;pNWnr{_vgt9PfBprMW+FG^c1nPX2qd8e$X2<8Y1CGC<<@N?w4F
z=H!SFd=QXfu>aJltzrcqmMwfwSE^E5qagLgqh!+WM-fKgSkArimgn&q<m~ge%&9@A
zHifET0CN?wq6<=q!NICZu*bQH;g#NEb|~1zF&N60xA6&cgJwxd3I05%<WyI4GbO#1
zeU?ku^%vK>E=eO|-Fupifo5fC#ibDl1>T9pR6Or-fGkb-R~f63Q&A7n>y5(jR>1|m
zJ!eB|&{qM7*0QM1MOy=5YDn90omJ15tAAoOxw#K)Uk#^YvGcppBn)|#M>7j%J#m@3
zPGva%sOxm|=nNrcJckmuxXA{V`Dcg=##O^lY<Y<#8NtfbmObN;&q;wDAiwkG)`}5V
z<l1#|iF#j*K4$|9#DY_8{H^-{ilGU@-?|S-A{0`0#cX;HVGT%OQIYdlrv!+5jV~^G
z^@mR;1_Adk{xwm=5V{uKBXh)_oQ?{I{HQM7^!)q{VzJuq*%hU9ykHDNeiJb4W1Yh`
z(X~?c{%sEV*gY3*#m*ns!AidZ55JErY(m|$k-2g?&2D#^02Ny)j`wGq6y{o@{G|AG
zIOvu;)ozZ}@%D8rp4O<0qlE76DFw2(IPkjh@0_M>-n&P~$#!()4TZ77KY#odFcTHr
zb-H>>lF!<_jq)qm=r>;$vvK>y#jz|A-mJ+N^!tn3?YVb~Z;SxQi6s$R+}K;oKe<p*
z9++fR#^_ieIvdlf2lZtpM~kL308S@PE&pCjNYhYsVYnS%h`+6g$$H3{kFRS>5+<)l
z-|s66B8mMQ?oKanZ^I);lxz}dw{E41pm|k$>uN*va(v)1_uUwANfQhDqmQ1are5Cw
zwFo>GQVKHzy2pc!G6P#|uNPjo1EjJgjJh-BR>KLhZYoX8<{d)MC6zC>2f#V>{h7@-
zij{CAwn8VK5{^IoUDL=q`W0eDV>^hH0W-_P1@)4=TJV`tmkP#&z{;S#qobq!F3+95
zv<VlOi?wxhfTmdwB7rpam=oU=yf;Q`v*`LTnL<TLNfzn&)mSKk+;Xwqeh(_hD9RT8
z!+=mouRt~@f+SEM+w|qfFL-<h6ipPa(pQ)<t~`$Gb<r+6D>v8meWIm(9tZTO1%r{h
zH3HS*<KvyX&*ZBl8w3VDSPt#26*#5nckdQ$Qy79cA~ejMtJX0Dt=;$0waB-+vND|R
z9J*e)2i@sY9BwcESe$cns};PtX}LNWhRqL;eL)xn$GgdmJzbZPss)z^AE{z=rcUq<
z@z(wM(<`(7=6V;pP<j>3^w!!Btul=YKg@?`yoljI!KWK$f_V<`RlZpEA)H2igD4xr
zrE5O0CfLC%7Xs{1<IJ7o&k%mCfLY;5Z^qBNS4SuO%au_By>u2-Limq4$4{In$6aEj
zuN^qr1Y@O)N!3!6>No@Rh{uqc8pR5D(+4dBzf%S2lG9|#4=syEyY2#K0ZY$MF)Mv7
z%l(DO{b^yXs;uNie*+?32K1w*MdRRfpd0VHM(ko9=sDLHQSi;rgZ52-I+vZkddq9;
z#~)ziU-NwEb{MASnJ;MZ@y3Dfj&~?rxxM83+6BK-4{sHfvfQW+uhHy${>WHbnsbG;
z0V+P<;`=JMpP$#hsdJCH{yqFBhR4Rj*%;Shc6K%DFvDr9q}Gv2=r?d>;`XTKH?=HF
zQp@42JGLXpZ8l+hkK)OT3346J&BZ`~XjJ`8m@epX_^9r@TMl80ikMF0qsA1(jg&Ee
zI~&HtqyPsW>Xbo{2W3Fkrh)J4%JG^WIIto}Rl;WQhJL~a4^LSa8Lqj}BY#EQ*uS4A
z6Y>?SckQ*%Fa}IkeLU7e(2afn+VRBiAz7FV!vr#Jf+eadbx@+FW@c8>@o8cw>j2_A
zAwc1UUxQOMAVG{Dy!u@7);u4!Jn}!@pCzv_*3wHDHxM^N!2E2(P8+fMe-B?&;+D>#
z60e=WsTIELsGz2*2)HX2yY=+<bd#(-fFmoXGMGd$Fm%0&(Te|Cx@4mabxz4F2Rd!J
zfoI8l4Ve2=I{iA*B&!N_PI}305{Im1jI&Jy$lMX$2c%z2&OIBB_%K5~z$3{eCoWEj
ztq<BgS<HfO^e(quA+ef1$kM&*xIp2(wJmd?#j3d{dz+j6amF7x)K(Pvz8iOcV3sd7
zRyf}~ezp*zJIGUBov8G|hyj3T1Zq=tZ(2h>SFQ%C7Gxd3cBIOa-o5S9dZvgrXQepg
zE=-Jkz_`Cr?Amo$h8l&DRlhf*iA$S<Bxg$>K3U5)IA?d+2#3%Ef|WF}07~w&XXWGW
zHq6nTgKGuFFqgX5qVBr-uh9?v33^)|7Jt>kBkwpZ&FNp36lA_E1-FDeX%vqDxHO%e
zAD`|$)!+s>p*l?9@w(DWR#u(H)0P>1@Dzpu8^xCb6sxX|APc_W8K`M-Z!v>xwJtz!
zOar>}<Srxr%Oa#y*{`n<RKw#fDrzp9Yc>on*8mL{A|2iD-@m7R{Vw=;P5WM6BqU&<
z?}9A0xUMdld22TPTCxcaQHleFsC+9Ge!Q1FA!FQWi9r%D|B>;IFFYGvAG7h$gLAKp
zIcQmHAk-ow_-4HIlS|p?OmOzD;_mbwhmF%ebqXR*9K>w)#j-o6<wB*Uq+Z(Rk&F;J
z+qe(7fI+6QAve<jkr=qDUwELw0MrBOt$p|nSJY??kBUD6biLh;-LU_fwpf`>ltM5x
zL>L2gEgy}Ejcqy<^45SZBZD$gV51?ezZN%Q%BuwRf#L7JhZymsDe7(~XS$5wll)<$
zMRRIQ!k>wYWxQmMvbCi(f{}p`tCL(JlqfN6pL7lz8LfTqkdHKeNj3Q;l9#5Bw63J)
zFq~HArtSKg#N)*Zhxv<t&vp-r)ht~B!|T9`F7!Br;G??TIw}tHGeHtf@eoE_Q$XIK
z;c<FyF5~i%4&*|)d!SvO>7i_s&ePHmY4C#Dm5$dfZnS<3v`tOA=X$8E!+hBqKYt8j
z6i-)kS`VcrQyEe`K3t$BFP*|RHtgB!Ii!1PHJt9(aBj~r$+CKUXbJ{a#8NEv;RXg8
z=fQ|w8e{VG6pjcQ@H|K)L^lpx!fB@cV3_8pcG|;-jE<$hrPY$vD;{+ZExhgNSxsRG
zZB*fj+VW-h7HHcv+>}|_80c!Z@rtA~rXUa8gCA;M-hnSWQpzzoK;%JinbH;EHH8fT
zV4{Y-x^8aDnzZ7VT!ge_xELwQZf<#}FWR?Y#Ss<d=;K419v+*>%FYhbNWJuvdJ@8D
z9l>Zk<S_hIbHDv+m002@(Rg0LVgqzincBD3gU&{EJ}{KiBC>loCuEkm8;<bGDYwrX
z0NsM~qA*$fZ3;8Rsn4IYgWXLP+fZ_zouq7aDUmdzm09g_6OA7p7hYYzVZ)&Q`Jb&B
zJ$p4r)$Q|4F@#K&+9K21C&*m;`uyJ?=ZWP7M$A>j*|?aQdLCH?cx;-%r@W`|NGx!F
z(8J`uU%fx3T9f{`zQ59Zexc?(8Hus#QOh&kw&14(`$}?^w&oPC#XW;td3o+z`NIrB
zZ+xVSyHDPIm^3ppW9#U+#!P>BR#s}R)*<QZ=7q_Y5!bZ`cPIe3dj#Du0>KVYrKNov
zXQ*J{R*<nK6w_S;0O#?k&wTe%KuLtyZTd=>mt&m!&WSLswDPJAN5WA|GyPp?`YYc*
z1N~t&w~A+B;Jt&|H(tN`yic{OtE<^QkCe8kIXAn>eltb9BW<ua+g-8ajc4T&v2P^w
zXXatWBz@@%N0X_=c86+hhok9&r+N{<DP#h`DnvVky44Il9c(9r+}OX>VV|@Ua0rqx
z0FbL>8voOlk7m?M{41KGbnkKsi+kN6$Dep&07<Lo6=v2w49whpvNr+(PyAn2>dLGX
z9<O1(_sF!J7!=9vJ%?C_3>s`8L<X^nAq^`SP6?~FAX@Dx`LA^7%G>OBLf*b!^pO9l
zhtFw_{Cd|xmLAuhQ%AhDMoH%JDdwOPa0`TSBH;2EN<4=bBoxoY+Mo~g!zS|F20heM
z6{?b{sA_rUUf0!K{xZQL<yk&@__?cRj9Q28QKw>g|BT5)>p3~Mx@Sh1kf4scLkh`Z
zS2-H>p_}L*7eJ857KUdykEF#80MgPta-=WNvICtE%DdN{q4Q66ygW@~WOU-#w@rL8
zT0zJx=qvYG)D>?@XPlO77;&xR5AAGk-yENb9Tjc{A~EtWT^O(IS2mveMJkJ*{zAJ$
z8y^Dc=8|zz{<7oVCSc2CTt@ji=KexM?=>FVQFd$xpOVt~*Pl*^?2Ws9TP$8ePF?C5
z$Z*gkwD{nbl~>0*EY5NBcz(Ppq4^>yk~DNEs@BL)QEvNu-8Ve*)42n>-hz>P@n8y^
zX1h)f!b7CG<Hc+qdv}){J2bBz&_|OYBJwTe5*bOcK6(DHHz@<2uqWz#-Fej^2|qt>
ztJSFP-R>=G43Zze+Q$23#_Ra>FR|t7sS0BvA&e=EA=LP0Pv(0rU%G^wrVfj>w!b}D
z?e>S4FESc9&!}A53dWw)JK-lEh}Ksu!+(>X_=-xB;=ft4ZQ$vHaHz^&_dDGwEHwSH
z<8uiHzPntb6YN}8hJyI5yJz#DbwnLl*p|-MRH(sGl;Qqt3-q_mE$yg7-LrpxYv7uN
z<V>>yCq6%vb9*hSuLCAy#E5I{&H8@{RlPM>#faZ?dfo><BRQLX`2OfQX9MjHcziBr
zGpIF@Q+j>AHP{uEp6m17p!8=ts^3WlmN646v-d+!xbxK84~@Gg)uBVBd;m=-Q2hq5
zUevE*nd>MI$MgFlm41)tNB?~3V=F{7LAazu+i&SJy~o^lrv1r?v`Wh<tgd-n=%?{z
zRyOzPmLlIbI%^9LYI+;!0C79UJOKR_g=r>d<`WZ>1s0J|NM-V5u4k=#@$AgZp5J{X
z338#3k!j(1LKIa-yh_l6=?U?g!pR!_4Erh_30@ILyb|K9Q5fzS#jU>OAv&5^3-?<H
z%eV073(dulpY~eNSc&ugMCQS>%4J&C*7C;^5GG7b>CmbA^zD&6g^^L9amt_^j5qp_
z?xq;DEZy>DseaOR`Z|}$QMG+5u~&<go0L5zv!<E#p~I*aZq1&-F2nQh@>f#y<)<qH
zsZ;O>t9F&n>*nU?lYtI+^L@KnU)1AJ{G->~TF5xH<pU`I06OdrR<$!h-oTBIl<n;q
zoPLQ+3*qVMp8g)iZ_vLjOESq?Cmp}-eocVk_pAG9ThQ1dnAHxrIeL5V_AhI(Ytdm8
z_<V*GU(<JBGjpXNE)xwJl{gzy#B8HE4iqw;IIrA3P-<j|a2kmws^~P@PU0gPqqS2Y
z?|KZCjn1>XLKtQX+tur#Mh+y>S%U9umr*S9x{q&EjP<At^Sf6+?Gklk4=f9CSt=~T
zk_A4e-kS0`01H+BVbQ~|L-jAyU~1uE8Xp<K`opS>Uwmv#n_)%5pCTKkVwCbcxuC$q
zh+BMQBYIuITyt@@%Bb@THuCcyVd2GUkk#(-tznk{jXFDhT9<f>LlPFT(a{79c%ky8
zPj2e}Yt#DX%?Z()%2MmfNB78v%YXMOq40)@MZww_&BdjkVr8b;CSyjN*|4=bD#by%
zXE)(i)nVRu-Q8QAH}6k3%4A}oVWtndV<2=_Y$$g#M49R7w4jb4l#3}$$RPP|=(aZ_
zxIWCUa-Z!2@{Lt-9vWYqiZ0w(@6Hq>8B%fK^XC(A?8;EG6^MHrFkI<+?p(#Vdp$qz
zyRI(b_$IIab)?JTV!m>GeB8#JD}22RyF}8B8#IY}wCSzFZo=O*pq*o&p(gXqtHcVF
zNoK<IJW2=RDYauM`=}!%@!BE8oINWELo0$M4B+)C?eX<hz;F`cTqSnx3|zq&5~wIc
z{WH>LZRg_o_(wo}_ZN;nB$xp{Ek;l9v55!D!slJ37xdCOC0QXVGf|{%2?PvPHtrtP
zJ&v8f?&=*umt23rdE#TF^<^)YFT5hLkH=nqh*Xqa$Y~vMg;Eljhw#&`(-}EANEmh!
zxdFDhER4l?Nrt{mL`vmf7LdZmlz0;g9kr}>Yn=T8Y=5XRe+GKupoLp|c$=Y#v`3wP
zhL7x0ZM73-5W>zoza0d}X?#vLep`8&C=SqSnt<W)@t6b3#>0E{-)I4n5@NmBF}m)^
z`8`=s8ws&q&Y0xAZy<E#>eVtFJtHAjU=){s)|jWZ@PeZNr&|@VtC!80oko4>-dZ9n
zJvt<cFPXt`$!c@=2a$J^;6;H7G%=KWUr6w=;M*I$?4NcWYq@$k^j-~g&eJnF=egnO
zU}eE}p^T9k!E+<=se?A}zl4l|C1(tVs^xTO8}Dq`d9~12<I7K3ll&&&VqlQv2L5h$
z|8;j>9k(YrAcJdJipxmc-FExq%<8#ar^k5ZXjlHtqQ0PP{I_p?A&+-SZ^oLL*EjI-
z63#Zt4$`R8($HYSLehp?y}phTKy`FN^970p3NkQwMjG|aZ@Rm~V2^sZ_(i-Ot_lLF
z)jQ}rQ0^QqUQa`_h5{(>Mj^wpO1+0@$qYA=#-w?~)v!;6mCdJd?d?)q_g9~Ok7FZ|
zp^?#!FXR7UJm%GsS0nEtF5-Jy)4suJ2T=4_djvY8X*fHkzIfqRc{K}=&R%V8HRvZG
zK|upf3~?ZyJ|wyxEdk2g$lV-~p()*{CNJ)uC?IT^Rbto*t+ch<i>H=>y$?hqd^J&Z
zh&{P`=+IyfCkKZC^h44Q4`sDu&{I})Sk~utQSC8Rplc}gHZL$<`g{+REhY4eQw;W{
zQd5pi=Zm4F$NfTTJPu+kBRe~WKyqBgyS|?n-lsjx@vgO1z<F~^8c2}RpY1ug2e|nB
zVrPlEeRj6dR@t?7?a}K+TiB7gu)U0IMQ%%bZ3fhaBJ<p8*~d4!N9N88#Rdd+zk8SR
z=Oq6IRpqvEcWv|9@36g7J9mzBSGQ`9tz9#Fw~H^<e;6v?X@JF1Uc0GN7VCHQbO2pC
z1p;=Cj@uCyG*-_O2Rz{Q=+g!weafb;zPKt^w6cTQ&=tqMia<PlzbDSwh@trb@*f5W
zK5S55_@{1e_emQY0oCLy1-<G;zNVt<g<`Z;ma3%;3%Yj2RP<eabQW144y@~O7N!`q
znpy3a!8Mwr)(T>}%lT6&_U>l+leNjzZKp*<MJrRI6fc85#>xxPfgOuQ3E0kty{nHO
z=i08c5nYe*!GnN;i#G#xcA_-veDf+H=jN~HWhbUEb3r3WMI~<TeZ%oi#h6iwL$|Xs
z-}bl^2Rl>Zanvdpj3b%1i*)8@W;md?LuuFjSCL3n1R6v!4YSube=xY~;0$$xb-Gb<
zMU2x%E@yqIAMJ174&2XrNX+hcCV%qw@*<0b%mI=~nzQRxO;J;6c=Mc-OSIZ(GU_S^
zBs56joaUF=TZxI=!j7^UN-?Qgr@9>p6GU;0>;A-JyaPpP*yFgRBzPw+ZO`HZq1jO0
z@4__RbVOCzm=R4#D_kCqO2-ptvv77MU2W}v7TbiY9Cda6tHf?z)otY(aFW613^B9}
zH=K^j?hcJ?0>GHEKP_Qd3bdklbH|lkBXJ}G^wOhsm5sC7>#Rlmf#B}hRd0I@_hJc!
zd;((x0XBw|!a@!Z?E(%b|CPVCj4h)xkGjY4H7GVZ?NQCZ&n@e+oG0q!dokD46<SDo
z$0RIcY#);P)w##510?*GfxYv4(LbPk(?ulUmv4%c?zJd5!{4JQpwRcEdrQlEfqZ{k
z9i2$a2%rD70O6u9Hn=k-n!P?D`QG8j&C~~}K~sJwhs(~jXo*=E%y=mP7o$#zzH2Ok
zY3WdCB+;t#gcj%^lZQvdPEODy=;4pAfqHHlgX(}iimMn?ScYc2PKq)q#eZaFT6ZxN
z%{MocwfKhw0^BeBRmGOu7yQl}D|N_mG2+w$RsAo!ZQ3Fjy>Co<*Nth7_p4NlA`7;}
zu_Nq&os+rk^+gzQEW=m?xc<r&B0qoqBJM!QRx0VO4XSxxcUkl(W}9p!BV2k7>N^B#
z{4=;*-QAxA40Bma$G7zLMa|C6W~{M%6fpcg)j;S@$Ed9JA1N}rli%yL74^W?n>S?!
zW^XZI;R>aUmpbJekqdqq9c}69+2+2G)>VOzwk4!Pm{Qra`Qwyq0F$~7qG<tEJb?Qf
zoF+wNv#rz<x=^tGK#S`Ghwfs|0^#pcmaH$JAd+cdb6eTXzElD6Uwd8~Uf_s@Te!$b
z-j#;4&;bm%q0du8dIy70A=d^x^|FO#!wE?M@E*jGe@s4VZTkGZygcYy9=yys|NGQ*
zAuRHlE!2G#`$8uUSmtcN69cGl2p)<L+BmZX-;F;_PUbsZa>@Nyu4%U6#sc1yX`mnX
zJ4Q+0jnc8~v^4Ja_1ew6ao8YEft>f!&ksR3$}S_k^b9XbkI}Z&k{t<vmj3)W|91lv
zDBRB8hYxp!>k0~OrOq|w-E|J|)Y;IAes~6{B1u$E7)w0`71(B<ciM8WVbgOrrgmE?
zpaO0<0zWYMQhz^SxS6^nbsgG3#s1&f-Q$s8{Dmk0jsP!d7DrGSk{Xepe=RZOL(K&K
z6(NvrdGq`C;V48g1x)TP!*%q7z%$np$(pwIDnJh9?k0diBt-2WAHoF&X-ywiMK+{P
z7k8Zo^%HE`kpGai2ZwN?V2}~jx)ve>3%w8IJi#j*Y^<%z%M;y;xB)70wycl^V6cAo
z;ZWP3sFrutrUhh}SM$(Y_24&WDEaR}4wto3{{9`W->M;QCx%s;Lj5yp2363C6->_P
zA9R*@<RS4gfATBwga}f-@a2m=Zsvz?^D>rx7eB6NiqWPu1Y#SO6lVVFOl2`}QdJfz
za4o<yE;g&6VmmOPbx#cXBDA2)j)V2COV1=u3h0dc=ETswiNAwy=iI-~;r9A>^Ms#T
zg+)bE_vvS$Hs3>SCzx-uXmCzWxIF*h@?3*U!g0r~@;`sZ-MtTe*k2IQqj+i9Rf2q|
z<Kfxna-nfLf|M&&GFq}U>Yt_-)@|5O!~88Bt_ZqwsCZxz$U0ku9eB$qk{nFOO`QCQ
zRV<2C*zEvqv4rRE2aoxcU%g7O{^06ji?u8T858>O(=_5Co3K9%DUu+b^<^F!smwT@
zfMrO3wH0%yaED%heif26e5MXncF(=mUdoe_fB<yos3ZEhsY8--V2J}|OaHV-Go}*X
zCc1ibynNhfCc54^M7+g(@Z0=UeBS~M7*~(6$2E7wPO5f}M~8m&r)qhgSz3Bz{a<Qh
zk#&%W0S>Rj_RM5skrou@Zo>No)BS}sU$aom{pLS;K%+VZ#WUGIFfapqQE@f~lmH1=
ze{B<^dGULky-TV=1!zge!-wEzJ@<)Ow4YS-_AU}F%&rsWeb><ua`PrzX8j$$k1iBW
z3b;x%|3Nfts74U_*5;Y6F0oWfao#6Y_v+P4@5z!4)6)Mc(NJ4GgnLl6WOx&Ue5j29
zb)!DBp#d$g4QdXjp6i*KWqK>Ff}OgPlu?FMT!0-q$L+Y16QzIsj$r|d1!Dwo+5Xtl
zh0TAyDg9+Z9-8~vQ7Y!PPXJZuPqVC?98E}oI=xuNXJuRTD%I7Ws?c4k<>Liccl@yc
zJ7w7ge^I&B!ZBKhmotMhL>qDJF|{sE`30`qrET_Zom6|IoH08T+-_e*s11JJ!eh19
z*yn!_e_5uNXieKPU)k^UC?G=}q51f?pAPqGH-`)P+z<{iY=sJI;di3V$2V>)Yz(1w
zR+Yti>C}|21@n|3b3wM74JXj;Y7}q#sbq-N!T6Qpsm-QDEFfScD-pYT`Ld-|&#TC;
z$@lN&2jFw_*u!r)L>$#4custw_(XginD37bYJE-;Dj1b&ki{WcIWIT}Bm{w$fZJgy
z9mvQ0W}hbY<4v!iOjGNox5^6q=xA+~{OobA-__%hSFS@+1$7c!RG!d%WolUvaQzUi
z7CVhX^YGYSnvW=^aBC?z8;E2zuQCHN68@N+h*wQk26{qlG&FfU)r((%=d7--kG+mW
zBHn1`a_uVEcET^BFx`%s=~n|gTTWlmruFLId6~<yqke=U{rt-QrD)JmQU2`)SNX%1
zO=4nt>n9x}Gz8!&B;XfZesImw)sWhr(Qc2L8egIifWQCL<B-p`9zHbyfmpz%RMjJe
zuu!Kv<a<~8uCy|I+7%AiOhN`Z<}&_edKRrAJNJe`m**6Q33W0;ONs_!ElfI^7c<$8
z&NUY+Be`TR!XR)xByV!YBJH7T{^IEi=9Of+gD+p;>K&IvWYS1=uIrOzZZQ{3Xa0tB
zu0T=-WqNuVPe-%1e?E+=C9?~u<6-F^F9b9a%3pq<vfE(c+7kZ$h_eI}=c>+e$tRw1
z0bGo<_NPv<&tCI4w`6Gu2B>jZ-Xy_ES#lqWCqdr(#v<%YX{~~>j44YY1osLm3C5yr
zKmQ6WY7Ll~8;E2F$;AfxG8R)yy3d~Sx0!7wLLv))c*rlRKUlnmWhSPpd(A{|tUM=u
z%E4iM)2fZ4sCWBsm^px%n4(@37&M-HQSqTql%6KQ1JvwP+kX9i_^gCzqypRvXVU=z
zGd8<VT`CL(4%$*u*|^Y`pz(h%5W+pMO!jy7-efcwz#>6Y)nF>BxvOg>&RHtA`nRtX
zcB#I5E5YPIDE1N!)MMKg{>=JY2S0v|vz5kt%wboinASk*(!TAHP4}Lw=m~uO<RZ>P
zo$?0gDK?5&ZvU^5P?uDpbJ1(_xbOzd78iyYa+js4HRb2!MHDz%nE{z6v2Y4*lLJup
z)|C9{4TJlNumYo$Txnkvs7P*t?in69usPVh`sd50$sYm`?iD|1v4xfmNpl$*1{{_L
z=FiuHfk0@|G&POu6h4^K(KPo%U47Fo7y3{}oMdaw9lS~6f#&X}%amas4oL{AiaI=*
z7#14!^y*_ftYCCS{H^dD$cQz(URQ2hkU3mcrL0mGemd^6P)G$81yH`Vvg?i7Pvl<I
zhkDAED8U!VhPFjkLyub>?nI)Nt&+SVtDhH_a&s_oN9OPl><zy*iN`39Oo`h8|HoKJ
zrLvuk&0yeex)qBih4P@x=h}1pf{0fJJm26x#;G^@3mZ;|dWFYt&gwnDPM8)~t=eAf
zudg`2{QR%(KD|@%Ee{ca^_6~0-S+&<4k~+E?f0dL?|;S}&xbv2Qsg8LL{~SaN{@;^
z<++yL?xS5Qt`k@H59?-|)DL)HwLufnbj0PS+0{BAH<5&f(F9}zm7l8|H~MvPfgcCV
z8O*&#$j8rs*&+hqKlofAwgX{VjLI<bX8NtWts}?U(NJ;EurtL3oA>t7uND9Wtnt43
zzeu2Ncyz~wH@&@<h@UB-5rF8im~LUBqfkgFBK10egEHM+JyIib?e;sdj~EOIg>wGy
zuRgLXwacf|Lk@%$aw3*6`r`u|kKF`@B*>}(%cm-s5S&Oh;^)7%U->$>`Vfz-8`FWT
z_9vZo!s)23-9uLa*D2ikuwWTsFNg~<_*JrVMe?ismuZUFhAT-*<MH=o8~+Dtb3ZQ@
zj9cyE`QW3p^=%~QJ$SdDzFLM+8QP()cmBIqisiPAz<AiDKYv4)LY+D*ifJ04odZHw
z_vS8=Qb^@waExpU!utfDob=rntm+_2;VcjMUo;RpV;Xz5^t{Ymtny5!=LVw&(SvJ3
z=Z~ouvRDM91LgdD{SoZK*lB;%IMX=g@ngf3x=W#-H_EP1|L<j{w!E^YjYAo{OjiDU
z?TF(Z5j1H|GF+Y5Ck{>b3D@F<55F5;eYRsfE5kL$D?+vS=}3XQ)RgSApjpiaJc3I?
ze}A$`*74~-?hpDlzVL#hBl&eLleipqtXVC9F-9v$A>ma<4H+of5FxRHfM2$`z3Qi)
zA4xIET6BK5Ea4ymGbC4V@JEQ<G!d{nLD~qoF-%DSEazJ02LAs(fc8O7f4nq)cc!#{
zvhf`r$*GtS!^Qs{{$A5r;>u0B&eJ6FR*>$k>tqr*>Eiz#Km4g%oAN=AdMLd1&yf1K
z!}>P&5^fe6`k4>F?@=e(Q>gXD*#aR%BBxwi?D=x=Cz==t$?ZJ}bmN(0UnByEb8!iX
ztpI5PfWs_^tVSmL1qTXI*%LDieB$Je(Jeknso5Q<q2RSbJ{l>7Aew;Uc5APtg+&B3
z8Y`84wnUK;dNP#V>pcm+l?-G;`*s1GdFQzMdzboc$jhzM22^Yd&5j5=<omyXBus#b
z?nC|dQda6z(kNg)HMeIY#A&3qLHp|ck=3gejT_GOLc}XRUXd*>T`F7i2<uroSGE0)
zQ6|<!?h^Q6XtYDd(vs${wB0o%D?J#mp(yAo?hOSK?H~1HdF`i})P&w7^a?+~q#a&?
zQabK7j`pjxfZ;<_EyGH${g+}^D8Id(-392-5E7@l`~Iwl0wECm2?;__dFy)1<id@N
za9a+ABZ6G8<R5zm(ol1wFDqiyrax05N*~^x${~2BP_G|kTbMyg!Mg=zv&(NL>j-fi
zMJ;U8JLEA6zY}YmEdWd&;Mf8Ek{5vSaB9j_-PW8B#orn$h<pO@$~w|zlbE=GFjoP$
z9VZBGctKF_>hqDb^ypua;9SiP`9bT?g4JmzS<Y_{pX>)dQVG|g4>MlQKq8tte={>1
z%E-EMF%!fQ<q}PWx65$cT?3(G-*(?K%0xYBGRJwf;s-w-aoP4fz}%!(KqkET*x%M!
zqNcv-AS!HVHWrb)>z<p5glaJ*jA}kFc3=Kdd7f)iI(6sAua?>#z1QlSHk$&k44LBM
z9Qm>3{}lp;>brVeSy1jw;W70;>vm9ccb~ocHfii?9aPF?C<{@2=XXayMNKwyqoS`y
zW|#syNbqTjKTIRIF`rbW^t)B5?8MW4oVF^Amz@Jmc=GixF2@o_<Ov8ms0ii57NPMT
zJlZ0;hbMLi0tE86qhoLk>;47t0tVe8Vf#1W-S>;fp=ewhZ_64z##~pEUocui`CnsC
zqrJ@UsiqmhgY3-PiKxX>@=+zV<qlpXstCpq8;yz7T-QedLJdmglSmaYl`%|29_Eo!
znl4R*VtDRkcG$mZD4=gr6R;`rL^Hr(fWP39rrjxo#^PmCK7U>b#UvF4?HTY_!1ur`
zcTrxB&Ooeose2i(gFf$rEjTO`n%!%$+8D5^jaFZW?O+E6vmTvj;GhHyhLO&hcoxB~
zn2%7^P)qbfb+#e44-2P2N}%bM`{Iicv54oE`0gYQoV@KRc)EnB0Ub+b*83s-42CEz
zB+Eqp0VhFC0inVM=%X{=abu&*AcGI6T8cls;1WDP-x?UyT}%a1u`4Ij@u}{#j@)zW
zj)+j!UIpynAnJbcTRKDukQQqx;wDReuN2LHomD75`P}#+Am;?VSosY*H$mnOPfV;Y
zg+9OXLt4!sb48-6$J3%BPFxx5=Ce-(>d;;TNCWhRbiGK*=gI6iHVoE<fis<jfrg9<
z;W{ewl7S&qZ1|$!+1`9REzH8*ci_+=Iy8HbaS=Blfr_;9#@7H|xiG!4s%RWkWpKj@
z&a)+?*nm9AAge;@50Dx@3V|^w{E>Zd{a;S`kQ~CJibxvxV#{K#NO^u2_nShP&PWga
zod;?nSKk&pqL>|@CUgxH9ZpeZJxMDm&i}!x>V{`**`B_5!2>)9FB_x<o&?=0SFaMw
z$3^!#M)w>!lEgLu=b)gz$&kLu4d+rKG}4S9cu>VxvH{%GF7c`Hon~jCsbcy(vi4$>
zNDMusm<+)ptn|wRQ~=xIc)Xnap@!s%XIFNVsqCo1n5vxRYAAEON_cRs0TAO06M7U1
z&Y%yn^8TMZ8qqgz(m{QU8K=wK@=EYlO@PgxRefG=E-zGZfZ|Sd&X6%5ef_4Jqbn1Q
zh`##0TZhHK8PyMG!N;b)O>eiSVu(!GE-K1UlnvY;e-+Cg%SBQr^e)+Fj9J4m49mTv
zPN|8amgampIP!V>(uqi+{;zs=H4ToG*wDB}De?6gkcH$>3=jL`?wmZC-s!ua&VfF;
z20aKqWN4y<eymp7MSQ6y`y=U?WCcP0r=@k7?M8T57>nBV$B!T5g8~#mN@7+^L9=Vk
zP5!5&5nRmoA3wqd`vF{k`0=aCa2o#|;cY-@zCY0UE9K~pTfiZql%<ZY4Fr4u&BDGU
zec1m4MS>>%y~8fxk032WAcrO9bPpfujXjW!4x~)3*kJAtuLR{xV`A3l@wIkKRb)nc
zdpnr?O6c3CDp~ZyJA>;#ahxq7)<Nm5{Y2O^ipNZO8EP<MfFaXhC~a8u<u8PZ74BsS
z2a@&y1b%hmxn9|AQPhhur9}r1g)9?uf?AZU00i|daBr(l)xjf=y@!2<oMfh;1^|yv
zes@H`KhQ2kh|E5a21a_rvKxM-8-YYv&lwCqz+r0X?Pa7OzF2iL-Qb>-&glp<5Zcr$
zeYm0~c~v5J5bq~jfySL2t3i5J8r%cd1EB$m)2mphhcX#hX!&VrV)p_Cl{iNP0cc*m
z0<0crn!UbA!Cs03=ggzT5?_xiGMMz%JsceyW8EEvGY=p*1;c@3g)J8|A@snJ!MS8Q
z1z!eDjKha(2tbGg?%2bU&L{Gm-wxEo@LvOR)(ovByrYTa5SF3v-XQVPzf9~Fegf1e
z(8bk&0NZ{$-!vPe&*dmtwz&0`PwHUwwsS_ca~F04QKp_I{btC2@3IQw$~6=sN11w~
zy}h5aZ;oc-#V-dG&E(z8CH<XGGMwD1py2y@2C--2`4G>-!jMu8rpCg<w!dIoT*^)c
z5ncvuu%x35PfpTO(3$`QpafiaPc)-V3O~5Sil<ab4~s+QF`n1)2*G)ug5Xjy{WKe%
zKtSKX=nD`@225D@`mB-Sj@(EKO^jVP*B(BQlH&b=BmsRE{4a<KLLCdu<FYwTrza&P
z+_>t9qBsc<@<8eGH<T$|ywRNQ2+cAo*ye@uHSX=6o%cabXUbPFME1g+czLvQH5=Dx
zwy{W6b21>CnoF2gQA4=N=}^N8S(|!X546jbKY#uFiC*~<8X9~n>_S+DF5jBXO(;Sm
z05f}N?Xj|S-@@993E=jbOQ8&fLaovu^A0F`%-HZmY5M2{)#Kj)L1QjvO_9T}3;s1V
z*f2=>^OXO+Dr<IUi@Trj=O7Fg<o+ygf#|qJFM*gWL1ac8v#_23FI$6Qd6uyV&}fvE
zWPLqRnIgxBtXQ?4cgq&q^<gXMgRI+r2?-0|GS-Feo3x6Q583&><&ZN!#%5NZq1}Bd
zn9YUzUXY{js2Q>A!C#A|(4NjcM-~P)KsHx{v2j9SKp;+RN^IWlx;pb`=E&c5c)}f)
z-rGp6ASEpgkAK>n;;-~L6TN=F&MZtvonKB_s4rbu#p69DA^NveTITPp<KJM6lNEoh
z+d4;9k>I{yLpM8~5-N+OqVt5Ap&>JPQ|JDm4gBQUxR1v@^S3>+5sN1u9Fo`;pDOgp
zNv65Al{&V5MSO$czf?;9?-U5#Us<LTRU_d3noI6QQBjc@myMWfDeJP>3bllCmvS#v
z&BlJd##*LouTy!Z&c@I283Jx;r5Q1tfkK(`m(H1<YF|JZ1uqh8wk;6)>oPvws_Czj
zll4iY19D%P17Lr;5DHVNUAt0oQZbnV5LDn|hDeOPdb1>`%&{j<iZHa7-|jlGocB*c
zu;0o=c}`AF1Qo^4vCaLiGTA1(`OV{Q-V6oe55rP%YYJ$Ga$6~WMa9L8G&&Rg^LgV9
z1a|P5sVK6^%g1Yiyqr{NAhsz1edj^@5Z^}a?Io=4MHUQ!*dwHt+Va}81d3V@u(cHz
zlPFHOpG3rH3)Bs|KH_c$apR-oIFMws7x-}~<#@MmcT~-b%D-)tSt;2hACP|Aiyo7B
zhYDTo4u$?8Vl<$T+|J!dARbT+5J~bKD3wrpCO$3Qx^!vPfKHKu9ybZROBH^oK%jE&
z?*pa;Q|>Mwo*W9DpGSvHp<sMuiCBuO_)lVE_i4t9R4cQy?h=QDmv0Nwi&W*^PiM=x
z+LNB|b^j>i8c)4@@%O}Uo70)ltJK5q0F8@;t(_DHsOH`Fp)7NnTl7*};Mu_!EHgMb
zh%Qz$Q0Al-awOZ>1K`Pca{vV^o3Vgak}z1x!&5bNr==?prQuhL`A@R+4%3@pRn#hO
ztL+wKoO~zjvlE9Ji%15};HE-XGhjQP9DME*tK3<Rh-&5z%`d%B5vL!gjcqd*+W-U{
zQUv1Pe+P4%V282Yhe~{|C>B$EkPi~z9xUmr`uYlN^Gi0-tm*a!b`@5&<MR%TsUSor
zeScPCrk~S6hJ~Yh#V9b2=iR*dQ|{YE6%zk7Ra^_`hiNDUU+!luLVd8}koopnGQD_w
zu!gFH2h~|!e2UPCJX2sNaCzQ&rpJyH8@509)bMOtEYIZ5AWk75CmEmAMM^s=E)=W~
z@^H85tNn-0@dqm3V`^qCk5L`ciLPCqZL+GUN6fv7YuiUzSBn^}6{#&kG`oZDoXkZD
z0uhZSxIn@=F7jN}%!x{7xEalNULF;H2^lq}vrzC7TL7YarBMM9Owc+2yg)voKr#$S
z0P~mHyFN4E{*)x=pW{!v9-Z!bBB6Hso3n9#{U=on6~P>nJW&`7qmfQQjHSS|DFDwB
zBb!uzC;$Fdl2|TRJSezW0Wi1N;`ci@?ChXW5X)8+^+dvAPET9;dsdGBf)B4&<bk{F
z$MU-kEiAUVEh?0yXkMINELyMKY>qIbv!qYQoXF&C%R?5qvwDF{@3_3=a<x+}b3!m^
z_4u`IdPT=Ny&&h2Z?#h&hHTRzyc&>0HV49HRn~|C2cJ4Lxe3=<f~gx@#3Y&z@82H)
z6M?c%E|)s?d=a8opZEy>ybCZhz^BBCgW&$@{1pvSfaB1F9y#JOy#h@M)k3Pka9zw+
zXDD<8pa(jc;7qgoz!GrWa-C?}$KAuY;cf>Nst2l_spzDIV|Cq1eq4thTi3<&u><%)
zmvOC-fxK~!|LVw8B*8#b&=4Z+c5p||DlI)<>4usI2ZA|=Wm){yhn!KU7ExqC+64d$
z^M{@L_7{jLC|DE|&m~MCo_?O(v3l}>u&7!(e$k>4f}}q6_FJGKZarX70do^+*aMTT
zB+5WXB>-VPLOTR*7XV2^230e7p?e%7dYnrIBk}D?20@Gf>X2_XCMVn0+%i?(0oixu
zw{oHR`QF;Iaw`H<z`MT~WorIU3ot+sl2WqeH>YD26h&lf89bN>Z15PE0i+?}Dh7+k
zoj;Bl@>7aGMrx)Dp)nl*db9_YI~dbQFYv_^6h3qDSb4wGQ8d#=u~@IIu5NR5N!pNN
z1RxYLMf77N)g(1-iIf94k7@<w6a6YrjY2&-SB*jkdDT}&Y;I!Vd!kTb=REBm7kJ27
zn9!_ycFs+e?fPA2Fu{vcFs5y9-=?6;0o*N6o>Z~h55D>6*om1pXk3gMqejGuz!wS<
zWqti9wu#dq+;w#$JUl%P>htM{_z;E}C<j{96P<1q6?e4KT%K)w;yDD}sf^E@xZ>~c
z`+b185!W)b&dDvd27pQ-@*W`Z8#)oPy*o1GU!Qh(KRl43?nbE+){%{^V$f=0P2No-
z<=lsiwr7sh8gg7m!-f$X%P%`fVzxztK~7;yIOnO;KW%N=YIaY~cmb!WF7BJIPSoUx
z<*|Fdw*$IF)bI^&1opOO<IRE)hF%Co#a&daffzaowbDh?391`^Hzs;e6oL{Y<yD$d
za%t&C6l?>NCxMZ}kW?G!WKhq^yVEd@m6gE^6fjbONQeAGq72@RRG`C&^UxIV)62=t
z5FvwVBFxaqM7Q-0FXm4?FwLXK6$voOiYYwy?=;k4B(%J`p4uO24xyB+C0zhUB|m=V
z{7n0Ykt?6?N<~53w^W0Zc?P3cHF7AJ|23-=jmcNS;Tjv3IsNOzCMGmcW`pZMzhCK;
z;M6-hgC^5keXoNIY6x_XknqE$6e_!lqvE`fj-%lej9!Vn8DyEG2^M0ppfB-=ck+cn
zEn6>^`W(w};K7`uny+t3=g8Bga(>_wsy!?{xm3ReJ997$Am30|r;3?I3a;@+)E*=r
zqj~B4&9K^sesBQndFS!|Sq#QvV(RsmLFM!&5UwO$VCxtr2tv2Nm|KPhj|e@GK%8s1
z&n*IMWE>B<HM4#x<?z#!LxM!^S~&v+<hnnjrGHkTbpzzCkbP#O5+i25)#9Sx$O|s;
z07Y4vJCM>``X_79-QicVrkc9_#Vxk#mX^IY>lu_BrQ>lfPfTAGkR`p<1${os7gxC|
z!zol@FOU9cS}M7OSm^=F;eVaq@1|ht9ADt(Q}9v2pCWP&*g>udWd!myrdlu)d=Wln
z?pI<i0qnqXPC{RjZGYs0qDTY5O}L?<gtLq<ew0iSmIr$5tA*xEhayD+6b$Bv2SK}V
zI(L(a4tzIa+zm4JrQMmobIwQSzh;{3bAi3+CA7XkwffPx#1wLoZ*bXvv6)Oc%<DP`
zr$u#5P1<719FG@IpR$n18q4f3`Q=NTlcrwsw-e^(37rSd+79WWhejHEyeb_}28RGG
z9h@teH*BEAiNVr~M-#WzpQ3`;!{7@GzZ6t|c)9=@gSyAp2PC4tf>fC6TQ59>pK&MZ
zg`iMi?vWR;c-D2AYn7rt9vy652C?5;@(<dwK}<`oB7=rf9L^{S2MH1?JCqQBW*aUS
z7>8cMBSHl~VPypLVB8YcJZ$n;+`&)mrw?7fj>_zrPM+4aRcS_-&{Qmn{*4yn0qasc
z*n@tkd|6!iAveBGVV{-tboHxOpJ%i<A%*T0qtINA+_3GyWe6zq$Da=!f)`#T@5$4r
z$3mw*H@A$bpS3`gMKHe%HzO>HRvr7(_3j-adzdn>_?JS`|1M<}j4_f5Vu|d7NRuDA
z<;2rlJ$AyxQ<tpjBxWe^u+l)ShZNQ*JH&+-NKFW|M#W#J|1=UH67XXieEBY#W>;U^
ztj*v10$O5oxAp@_WTXUZdsb9*;WGWvPjw?1*FPdNz!O*NU;JD8yjLHDOP^49^Xc&o
zJCL$Ptc<&S+I}`)9YOen^hZGBzGh(poc1SNH*H0i$Mwq(?kl8(hwN2!p$jz5fTK2m
ztE_fX?4!FurH<>g2Lv&O5Ro~HeBRsz>y6bviZ96!KU5MckRA~<5Q-K3rUEv8C||X`
z65~IB`|paykXM1=Y>MLB3cg^eeiI&D$79LLHnQX5T<Nc#eP@2*2p`2cr6($RV#@Uo
z2f4U-bg#WvSBoFqHaP8}Q4+N`S&uK*ZpW>o`Q4hUT^LIeu3anl=V;i9;DR^~YWgCE
zJ5c$d;6<(C3^ghgPA|vZQz85x_=%&54q>mBRyh=uMA{AT%o@v&NRX*{Z>1t-h_Z=X
zO|pgzUR`7r5lsLUnP$O6p&*TFj8<A(+J7W@2DWdA40w1#^<4p^2;EBLK3erCo)v4?
zQi^=<AGnr)Y3G48=jQ_2jxU1DLW}K0N~^SG=-FcEUf(r$bnN;v8)Wd=wyg1S;aSEK
zG1R5@JCDpVt#0q=ppC6xH=Tu?49pQ94h0fxhaqIfwo>RL2=+CDpN%-U!ljJtJi>^b
z6$pD$#lL!WG*%;yS*@me5(7C%2KbK!1DCf>Au#k~b4Li&l!ZF~0?gq9h@#yNMQ2_g
ze^~fM<UQyL+cRf?%hd(u`+grj`okc|ntU3FR{@j2I2L&^v!3WnQmk%X2U;2zf)O`}
z)FA!qpYcKyDP{@aVj#9-GzjI~|50@wa6Rwu`~O7Qqhv-XGCIl32$g&&AtEbMWR?+9
zRwQW{Wo1{2RQAdWrBcR0B|5T7Bz2;cS@M70alZfm|2)p`=gT2|-tX7z9@ll<*WJA_
zc<}YXuP;u}Z$?uGQpYwU|KFSO$Q2q0MDQ&Ed{UBPR>a+O^y1&&h!xkQeAQ0_Q+?&9
zo^F|Ou6D>W-0k^)%!pnNyy<90HTZkd3%2~0YxKAnwz=1m;*J-axag9fCrDY$jS2fL
zD3fH|3pBGe6M>D`O{&I)2e7O2a8OwT(M*$!V($I!LUebGnme~Mywrd>C{*OR9ZH`k
z>z-u<P4i_{`r!n%77}z?|6$x^+_B>+UpeW%)st6U>Me&#%pI+hGobQZYF@zQQ3Mg@
z^Exa7$m(m5wh!#~aJoNQc1BcfuZ_O^g86TIYfDQ$(Q^Y+EoGU-k(_rWk3cH{#g~K-
z)^RCIVvq|QjJHm~0dGF+x42OnQ!sw$6Y13db%8kMb)&m(vi4mc2lC+z0LOn~U0O71
z)8C8HQyOSZp`v8<`uPXOo3)+)gxIPvbT#JTX_r-OcsLDP_jP1Rnr0*aFJEiw=_SNh
z-gC3HS_<`D6Y!y0f+v42zkM~Z(Gj?5z?{p=3T6kT_I`~=M3u%f)VhF+9d6)_Lv8m-
z!+zk#N8wq^8VuathxcWJf|)taCCRHPrx<!gkmk?N*^;ugWznMZPf4AQ=bs8ZkT~<K
z85|DixResdkF!*_8f6+kzNP}sf)9&cPD4Hp9tDh1Ie~6NXYVQ0Y2Sq5Uojz)&0(@4
z0<#bis&<dB>;+%i+2}{$(TBC$t??o)$Dm<EPFL7OUZelK&@R}ca=wV`DfaH@7%vx{
zibHaU{a}v|pCTj87Jtm~Ul|e3`NQX5<R8nsN-fq@Wqf;nh|&S;%PaMF;9H)tXXEK`
zormEnY2hz^s*)TVxHM|GBD?sDMpnc41%0%hUfDS>@KeQ4Zk=||{Oh1**Pin*WTCL&
z{#I7lv{rX5tg~S~Y3Wja3Yd$Wb}QevG@q1V=xf>nz4c)7J=Sh3r~rr?1MQ7Go-e75
zCq}(`^<=_!t<rzEe%G!y@c<K{vAAWDzfy#E<}s*)bq)BHdS8VV3GtbFzY|h=f2vZN
z-(FpU?=IQ%Gdt^suS^}V9^htd*7SiNJ~^zdTkttyhu$Nbu6ITQ`Bd9)Y><bjTivYW
z$6AIzC^Zi=|7Tf$#GBxc1d!5^byn1S*J0zpjrR!2O$OCa_Gt!@_Ik2M)T027LH`iz
zv#q1kRBY?4Lx#$bSpv-n-Gz7zkcl`_#P7NX?l*s;&6sQikOu9?H#lI~!-|<wLSCst
zLDh1W#kSnBrv09~*2K2aTRP!fSB{hAr@iW<lX1ty%1}0oIC0jAvdp>&_*@F??+D#n
zsU6xuAT0cb--%s{4<~F5>tRuH?szf_VY_G|LRWuiwd~51ClilEM$SMnCTc;Gm<ri>
z7ue1;kc<Y}I$!_o@5FImOQ*fD2C(<#lEnH<4h7a#lcce`d+q){n{>bb!s2II=I5%x
zB}qp+`g_%BaJO%RdNreabZPHjKl)0iQ?@hb%wII+!^P(ZPEL<4I_a{!B6#<Rl}3rD
zEc2KD6+CSBl5MkxYc%a=HrDLR^8BxUd%in6M>JZa{-CTh=jQ9bE0(3K9=f~t={-u_
zn=GE#7+Bp@eog3}8{l6MFbRP`>wb$49XX<`xEguu;p!{bbHrpH@uX$P9dRaAsV$Z*
zE9<-VjWRPEJn7?r((~Vc(k#5_sd0IwXPjk6?@O2Z9kmWQ=K1QugGPv{IgOW#jPDOi
zqj++z4`MwoZujJlO@`<P&%`c&1qf;y+mA0_xiX|<lh~)P)Y9|D9e?}{4zx6>v8f|-
zkFppJ%kUm^AGE;>_U3_sh1ns$AxU*msmT`?v=V>D6$36{LyWnXpRK-U&O(+A<>cjU
zV0ny*+mLczU1!vfJ@CkpWocL;dS>31o2pbU?8KDf_@krdmlorYD-*&}+QdYK{&@6E
zzv;B@W4^v)aW5Nn!kwxU_~0`#JXUN)LC1aC78dp^O7CI*9=`f&>oO4L8^;soySUW%
z@c3%lZ6!5r(zY?{I~6wFZ~E%_;^GQyu>i(nu3tx7bg`go^UbWUT9sOXMPK8}%JgZf
z7-0BVMgDlCTfl;koZMWM7~8w=mzSf*9?8?F^b)br<yD{cXZ31@26F>$!<HSJgy*FX
zCIX1j^S6J`KkR||-9Z-IEGnMmM**hl#TpzHN6Y}fA>3*A!<d23f8y7f)~H$YtmDlZ
zYbuH_HTJ9~oiuEw-hKEGM~NkyJ7Zc*&wkeJ{Wy7GY{a?xu{hH?r+j{UUGo+rVmj=w
z?AXP?0QX_Fs~#T>-KzVHs|{QCP%1O^tNN#x1)V<d>c-E=h=|vxmQnnspPxI1y==14
z93hnt?xEMNUl*HvK3H+st17#K_Y;*JPXJm^yRoJfRjPoHfF>U&SFA04J&fwqW%1(q
z^JDBkf50D8qr-6g&)V|TWHlA`$Yo<6<;n0Edpo67H{1i0`Wn+^>`iL99$%mzY{kCX
zb$E#;B_-8lM;0p<)4#t`+pf-vDRHaLVeWhbgd{ZzM|YE$h@hQmYTWjP=oDwo>c|*f
zT~>z3!`eG|^~JQa9}d~-&senR<?Fh4IoB!3NmzX~4b*y2X6&FrgJjLBEK0{}Aqf_v
zonEish5Z4_GKFi=>V3P<#l~)ok2hr+_1A^=`*+r~wN;py1ZnRyj?V9_5{3mFHhb#*
z8_FMh5vYcOf7KzJ9;9nx9hI!Pk(J`axu)nX30B!bFQ(T3pZ7SJjyxi6(?K3iOEzNS
z0{3BR`M(*Fo6Umu`)8k*CwzU?gsBR)Z6r}4U0CeEPvd@E2M@=uJEOS?5%^=5wHW3{
z@Jm4lI}mUYl+$@wP*-7tf_|sALY6q-=9kNM3yk3tFwtw<w(Y?>R@&o`1VcEAhb)Mp
zxEhO-JKvy2lO~Cs7hhP0+kj+hTygrz)V}!1GZE<%xV%NM)#KOf2=6iLwmO!rxj8pC
zfEMQtb@&K;k|M+%#qCX2qOhUi{~lQ3EHM<tsJCt5T3OZwcUKnWl0PP-MuUbbW5(Eb
zj106iXg(At8yS16hKFK%%a6-@K|*Fn%(bye*N%Kx;d$c9tjB+6W;PW^`imEzSbt`i
z<ND#}Pb*9FgQQj~_YWu-F#&%+`|nk$dx&`RP5Uh`&TdAJ;5*r1c>LO*J=T14Ezb5h
zJGlV{b;v<X-9th3$XhuaMHztO0q(NWqt0=hH_xBWDG~o@91^p3n}-}c*tX)TvUtkE
zh26xq7L#~!m_k+|YjSae5;~(KpzRnhimnCEFKf_`_%WwMcI&yK#4+6IMOIRCSyaR2
zKVxCY?R7bQ-52g&Y*4MOt=ZeT?#MF9$Nv6y<A)DV8G3Th;_78hzz(cxG@Cs6pTUa{
zk5!E8>bRita@Ux{h1s!xakDn?HNp>9N4|Cv`N~ztAAg+PYwoh}^MqS`le3q;Yj^L^
zrPH>x7X8e)cIEG<(|(kflz3q!_$5!4g#n>|>6=p7RbAtK!q0k#KoPmxkJjEO#I};J
zf4JKkW(h7@sg%3(pSIn5>v0VO9L2Zz&m{oUw^#wtKG-TZFR$$Oc*}rLCH}Eex5zp+
zA|AWctJy?kq?>t0^|gcS<^hvJ33WwNcn0dwV9GgFzP@?tkMU5YB=gnL6<gX4*1})D
z6J(3ytXbujSwGSBa;p7^rZRnW^Jeb$2fwBB&fPfrSkb;2`f5zaCNuB?riRW6Yp%R9
zJ+!S-cROxUlL}f&8Y!<WXDYTg9~UCC+Jv$?JFI(kY4hgIANPNlzhFTF_QT?qELP`i
zf`m-IUgUKDBTZo8waLSjs?XyT`@_P5I5N?;$5uBt8>Xu<tJl7Zl~3)|(&h-H#Wg`1
zFC(Ea6~OfL>n*jk5<&81bvk&w?1hy*7DTiK!3N4=drs5Z%2ErFi%<;vk?<Lb=*fTm
z2mC@isBIz$ODWrV^4PeM$RWl0xcNW-{8LA}Xgv=QY_?>qrgHsMwRDlRF?Uv{UcFUE
zTw1qmDO~|SNhCLm4;Y(d2W3o==b%(xo#@~YMC}RC`Fi_@c5T}RV%I9pDOkgL{JdhW
zvZdWGIbb_2JNEbZa4@Z>oXLX5lbPdko{a~MoT;v%<VS+{aGDXaEI|tMVoG@S;yl*=
z+Rw;nBZ~xOgYWT4-C0a>^Vzf3oHdC8?VAK#*g2T&?>O)Fm||sSU;el&)~IjZzMb#D
zX0d2b`$>~(=S)<|#DbiQk^T6ZAh7Ik$KalYR<Pe$g)8sjd%SO7Oh_G+@-lhLgdv98
zvLkexRU|9e{6=-kvmG1p>ki}*ZPW&YhT)W-n97@BT+(UO-n34?ig$bfcgR6)kbnfP
zAsfvoMrN`e#XQydEYC-=qQF~Dt4{OHODKfo(wd<@5&ep(sVTWitPLu&56I*3&)&$N
z5Mt%ovx@B>Og(={)7X?bxE1t9AHJQh-@>aXOU1!K!rk92Jm5;J8&@awpDOEi4pElZ
z5$y{-zR-N2E;nXB%>Vk>Irhs9Zb$agxywq&8#I?qT@(i%O-)ySF5C#eYL#GNr3{%u
zZ$_S6^U$aS6Xszsyov-I^of(%u^(Bd<S|OYW~K#Y!MD~KZ0Os<eEqMf8tquUL9Jun
zY3I!sFG3#e3RpBA;SDXU97S<Bl5OLnLlx-^&_G&gfyO~hve=JkPWvF5WP}wpDb$)7
zKN)HhW6Szj&m+GY2jW+X>@=B~pRbc!wb9m=F<zw0Gaw|tagEy+4f>5}*fSj{Q~16t
z^ctM;lUY9!kT+lN#RT=yqtzNT@LFGU`SxALy#kcpSZ5(q@Qr^af7IDRPU2OR4)+I7
zy7H@ZIg}=B?1ir`(~DkSyYYg{ORDoYv25{LZtnh_zW&iK=1s2|cHqEq&li<nIP0-$
z9yni63drUOYWrKDco&LZq1k<rua@?VfiRbmhXC#gc9++D@1;l}r}f&`fHlnCK|zhB
zF5=owo*40kEuPDyfw=KKzcpTKj_igMxirgBbqm(LD=(1M4JoY`=isrGA{UX9gA^p(
zX>b#$Pzq3s{nG}nDxW7iQD}_teqD2-4Q|o02AMUZqb^^)Iuo2AXnEV}+Jw5hOH*8W
ze>r)6<P!$c2Yx^G@xYs<X8LNQM!CteVj~6&#x$~W_@#A{6KslR3=Qx%z6OL{?EE!<
z={w>{tfm=pP9*R|GHU60ALlwcDo_>>bIdz7xk&{w)u8Z2TtBu~a$6l;T<*;^Z(<V{
znLf{zw@Bc_vKCUcM$VIWgJgryt(knMuPFjZvrl%LQzEOb?Re?=wUwF#XOB^}CdAl+
zhp7iBx80ewcc6zMwK3KB<XU>pDs;hc1=6g2LynbGP~eXiq#-up8!4NO+YZ(R#URxR
zCxcCxWEKgIJi+FX<G$aHchtg#T#*BCP^W(V)&CkW!<R&*xLLjkoz31JGZLM`MpQ?=
z^5~}ZZgn`lXE83jzJSO%K%ptn5=VZnaMsVdH~t=fA#A%&=gxjo%;`qB`|#tcnb=Yv
zLXa@&)U<T#uh%fx)PDOgf5OL0r&si2Neigm#hk7?@5s(<BpYnyJdCL><%utQ&9WM5
zrfVKv*+d*NcUiq1Jn5##|H={HKTVi@&F;Zg&+MOGC;l$I(&qP49^Yw(7Ay==BoG2Q
zc%pRTnc;jtgS)-JF{1M*eiWrCN}Q%hh+86>MjFrp*I!?UnuBw3BslAuYc9h<pe)rZ
z;IFUt;HmWmfX_|xGtKZsiI7`dyp<BL;0QBJVj_k>$4|^ZXfI?tw)KPG1kS3K#C-a=
zy=;Vb3VFmA5(j@mR7P{9(f+BL%BWH4L&g@CKs#|%HdAE(DMuD^Pb1u8ka$oyc%1Yw
zT~~FD4Pq_2zl_cQ`K8%M^0>#fbrr`vbR#;ab1tPhKplkS2-{tDhh5Oz##mdU0A&sI
zWnyTInt8oaSN_F+C?P1P3iNn8CU>X-7V5}cLrhFv@-{1nL|>w_^G^GnchX2e;T<#w
zpC!$d{Hl8OOYGBRdv&Ycb8<|7eQ!)J;1f7JD25?Ay6R+Vcj-iAjPuflEh}RX7!ons
zxzrfJz5)>E<4Lv&bhAs?$}2mdd0*11y#HQ(#*~eBgoJFxANkw2Z-c%}p$=YwxOYi$
zwh=kIedpR;{>oFeaUKw$O!OAROPhg7{1|(MYQePI+P?9Np0ET{nlM7x%(E?f?fW<I
zb<|`7!tY?#Q>d=7C3mL}s#_lP$c)_qtmjb4`PFGX{kpsmp6e6q8q3|?eQ_K}2zq@J
ze){8N&2}wX_#w^3D#(#Z1KEEeozlKhDH&RrTtr1VF;yaMr)(3(>3&94<#*yxQ)8|7
z!W_u*a&Q^}S!B*+U}ne37_x00UiOb#I?!VdB@GQ;ko8h7x@^5RH#1X^T)haY;WQ`4
z1AZsRXq4@0xN0x|)cXROv&7_NRla*!05)#CN{0?!^);g-Sz(JZqk~(u;^1n-`Vq<_
zy%7gUFO5aCHzHYC2f^~Q;n>9Bh`LFBg}F1h@a&2{EleTGVvAl9!%zO)8xo>Dsg|aV
z-*{9`m~|Z-=+Q_vPPn^Y{1UlRd(EXqFLLI4ZR+=*762}uBx7@UxR4(#X5GkgQffy|
zSgr&yG$`434uJ*HPx~N(=EU@%q!);iqei^}fTC{P%f_z>&pI9<yfp9hUShSyvZoDW
zPQ7oBMSGBxXz^7){+e@t|HgRcG_;rAJ%`Me)%A?3wf(*YZ`4HQedB+AX-)ib+kKxs
z9gNiZ(S*uC0<d`8(BNg&FmSZz_%2OLsN&C_Ep-Z;y<ou>9;--J<(a-&nsBdv+RgOL
z5u~^r2s!iAYPIw;X%D(Rx%TDy%5yJ@ADOZ%Er>2DoN1udtH}t&ahAccNu)gsQU{if
z2e%-W(MbAvA<~cj40iGwhYt+@4IYFJKHklXS%`@P^`25{a9X922B;LoVqx72EOoA7
z>TR)ya#`5xTenzE*A`|6n6N_WHEH@vHR2k}m(K78jSX%5$hm%4&<VX<r$K{c^vtXb
z_31qGZjZr}g~$gLzJ`ru0a;19FZOSQJH={|Mf>%;l)9?PdLAOS=u5C#4rxw39Ix2S
zu5-TiQWU#l5}Wnk4gHE4LQZk<$@682Nl87~PDtIUqjxKy=<WM(G5|jdhs+_@Xc#w=
zth=5h@S`1B2uybxyO~)NnQ=pE)mMhyx;=jRlATR7@~*C~UU6{)hX=Ji>G>)>T?78$
zpu$2KVqRwT?OE1MK?~?^XlE5wr+X0a#e~Ww>t<2mzMtmDPM(y#DzGk~)?UfUN&tg!
z3}i``Elt++f4Qot8~Y$lm+TxvdxhLwFkPxEKeP{9*uNv1zOiGsrKMZ?iQOJXCOR;J
ztQ=3o)$?iYy7v*b`t4k<uQ|^%TSHhhwsgCcljA7=Q*!Y%dwVkKzZ0)ie_D<7VuDeR
zC9jnsA^qn3-I8F$g5JZ2#-2zldsy`Eyh7EEP3lr?xxUZPtH!mY#?T<n7xtliT|#vb
zcXVyvF*UBQDAi?N{=%ijhP?xB&1}%R@2G*_rGTa2Vh*f^iI#4}#m8t`$QFp}Wmhf`
z(7<Np`S%Z0uX~}Oh+th?OVhQ3Sa=&qD3YJ{=-pfMn?`{(!^hC}7c|Y^E*-!a?F`^N
z2L}g;6?Kl3v_P-#omP%v3jJg^Ul}(m%#88hvPJo;>gUG5;l?a?GZJCPt98Eyrv$YV
z$~P%J-KJpjLZ$&`vX(E%6OyM+)u%o2G7v-?=vnEwPS8#HK7j-LCL7H86WQz@Q$)M|
z{INX5THUBuFIn<|$hn2S{=_BTT?X&UA2$zDmRQC=#j5<MZOQk}2-*_j?7-;`mtBX%
zJ!q+*46X$t!Nxx`gXT`(N^-OBgb8-WX|E3a9hJ&Nk-9UG6Fx2m$k3IA&OA4$OYvny
zH{$B%=5ydcYaqj(9v`N00lB&6saXT4uQ(@CxFexL1a3xIfy$qC-vO*G5V7x2-v;Y(
z?cfqd9Z8?ZKE=&q1sOip5u4P1Zg>u41qS)i_{hZLrQ9Q@-^;vHWP<>X33auP-$#=K
z2R){<rm}WJEmhX?wHdJV$b@<k3Rz^B%Mg()zvFe~<m9C3XZ>#5DP$2uJ^HSx1n(29
z!0mm6cT`lI^~0lq_kpD7kCoQefoV3<S{1D0fUWYTx$4lp`^Qr?=9LwJu_(+4ce(%m
z+W<6Y-zZ;ja+mtyJT$gYH2Jn&U88PMkW20Xhj(w^4mmk7i5P_+3bA@c{=T^vigIbc
z>fpE)o_A?Ksvl8FLUzklf=r^Z1`2Pis;ZiUkRy4U&d{89@BFIai#^eg#Qb~e;_GTu
zQv97HI&I>xx^eUO+!Zacl)Ex55ZLZDXz;&jznZ_ex3Blyw9L#SJH4avCGp;{L4p)V
zb!_eTAC8_r9Yl2t05UV<$Or)d0s=-HpSD>(wZCz{jpi!kC0h4_^5=r6CMP$_&$lVa
zczfD-@Bw2J{+kqAzftdB1ozAbybI^7malHq;&_!^<`QyO70<8KSj&pF>`S+1_M{<W
zwN3ky4m!F`cC#D+1UGiP*?~z(2*CM0H5HC?=G0<GCF^3H_!_RumTj=r-^eoa1`P*R
z?HK{cLEE;=-M*69QZ&Sk=o%Vm^{GR+8peVSTBGpOr@OmN)BO>aml}k7?Mv2~>(UQ-
zGmu$yq`yV+J@z1%X2n-E6Z0|O2CZsrG*6#jKY{2teE4wJB}>xptYq`j3P$rWW6yMc
z)o<Va{kjar(wYxvAq!|M?mt=jS<(sWMm%8u`FLad?yp7xAI_OG-p2mtVugW!M$&f6
zjt8qf<T3-@D)VdF3}h?UG5Z+@(SGvGiaVyk$th%_iJ73>*RN}woxCM2Z7dnExI*HS
zX+7PDFNdjv;JxVrvjYxM0JGpz;d<Pb@J(U2zOH7cd9U!Q{9rqKD=vB9QlghYY9h<D
zKoIGi)SEW-VQ^Q6@?c!dh4DYHs}Jr9Cssmxr>n1D56^Ou*`ek12^@A(<b#v1t>{VE
zEaBKWzPz?F<VP6=f;s<T#;jRKc9yY&SSUWB4opl;j0coWm;PE?dn=(`oE60&)vnl1
zf{ikB0CNmXnoWN9u5aHOk&(I4CtrBWI+p}57326?%cnI7P^G$V{s)6-Ol&%-#H*W|
zJXMwJcj8Minpp(}Mo&@%kI0*(A%2kAHKLJeuqjoy<ZydkX9tS28r%h#d4`(Vl0ys?
zv5~@Y?%diejFZzLj%R{JfB5in{>aZ<+a#7m2BJn2Q%&*KXUxb}f0(Ol4_TDW-&4+t
zwt{G7d1q`AOW157Lq8>@r8lXN)U~wq-3*-7=z8R7i9Bn{`8hKX8p*{s-kr0{D$+XY
z4IxohpK?209(#9DsH&;uBKS<E-&5su|9x=4`3a{jsvlHHDr}ncwG+SJ=+s*?`eZ||
zkPuC*ZSNDnLGxSCO@~kD=TY5F-#gphs(deRms0hxeciC&;7I$~({OUn`Ss-H$m&9T
zV#P%QaePl*-K&220f+8CGQ;DBhAdXCf}fIWEZAXB37PZuts1vy{m%Nwj~r3u8%?4I
z^M$J50VcwD@`hU)IX5+7W{mg{0kC6kp%>AdLzp03hD_8E?W*Ah>yYf2&LiAyWvGy$
zMA{QS5~eQ4k>IXjJTVRnnB{gSGKsj>x%L+q?0fLwdYDisORr3;@G-;fc4GW*0rc`U
z^q>m6$ZPv{sqWohnEU<RTmcfrH}iX09p|2e9BAKZ>`JG*HcypcURX|ab`F1b&+1Z(
zA!VOF9m2+X)+|-LSGY|Q*$5-*n{UZ>A@IPBfn$`JhU}~s<(0^mZr?VeJN~_xr=CKV
zIdM`j+3ksURI&4l=4}?o96M%C5D^9#l9mY?h2r`1=W@3^UaqWtc=*=B3!1h8p|*6X
zlF@~A<9ifVUA#Q5x)<xa^>J2{s#>-lQSgd=kr-`W8IjYMM}~50BO@Nx4;waWl!DVs
zW2B|X8bd-oyW=KXSJw106NV?>l}DyA8>>Te+c5KRGl<WrZ!0#xnU#>$f;P{Uen5jH
zyGFM|>|VAnDd=PWLlV5yY$8lqpJTyC<tRwcDp{Fo0u){$b#&tW`wiK1U8hl_CpU^o
zYD0%sbsna4>(2L=9b7{2$sSigAF85YEnLZ`Pu_d>v<UV5GKDambno6~m*v0E)M>G5
zL45g`A`?a%NR&6=<Lf(<&s(Q%-Svn8(`*6?G{jtu=E;wNI5F%a7zamwYjlk6ibX@h
zrAY_(tLke!RjoRwXD2-^Niw8`(yw7_UpO8e2w6Bf<G~fvY3fRm%OyU1*cgiTCa#fF
zesro1&8ZP%yV%XXKFIZWd*ii(D7hQ5qG}Cu(+2+IHctU3!J|_4d|O)jr!A?@cY`lJ
zjec}>Wm%_Qy?e)wFWT?0XV)%;f?ZicVoCI2-X~kP%RSiLb%v&<4slx34fnXbI>o6X
zv$CALKJiBA6j}@LF;{o@{7n(7MT&xE$$j>krAvEJq~_-5`;tr@IhImhvyx5E%~p5S
zC@=~cpx5ot0mgR|)4nS7(dMZU6FJaQp-9CDqWTRLMvq0$`_q0*C20Z97CgIj+WMh(
z4@U)yG+7XHwr^Me8ka)V&tu(3;hu*<uHaVB-dwGYH<>*N%z(#5mCrZTGmEV8((~(+
z3PxrJu^z!|U1eUoH4&|=4-i%2ALie2$S&gm)7`;umJYxUqK{TX__!RJ))?DONE6KA
z>C+AkIfGEzxUYsy+(eAr5s?nuBsmLxObx}Ku8uUs>1X$6ZNiTul2O-BUy7*{vV%+M
zM%PI?2LnHJs68_jYBJ;1`EQNo?Ky#h+m<jD4*#EvTLG)*x1^no4weNUDBGYs6673F
z?cJn%DVSWme_V_YoXUgvwP@!o#*S5&<A|oCp!{FcJRUzFFU?)uk}qFUAi<u@$@+a_
z0)>Ns1LW7Ae194fV>VusKKta?4!XJ}Po^#wRn_<?>&M?eM>|1ob9OX-CofvGLdV|<
zpKu&eF`1=sLc;<BH<VQc4<0;_zey-492pW}LSYrmQ#<K8e>I$T*$dMKNvJI4l(7ST
zMW(hW_LBIG9CB8|o^zjY4YnigY*-zB5S6@S9b%CH5>ly3v%qz6f;ylMZ))60Bi5Vp
z#|i9~;BpH_=Pas)-30@qL1OSA82Al!p9TSpzuOYYy3=3{Tm1>gf7+|nt}WtI-{FVn
zKN^uQufU|TWT*&_$Hg=y(m9`Z(UgYECRILVtlbNJwe&Z$%sSTiQGVs~4N#Bafo%dP
zD4Q!|Zh@zikn-wiSBrcSNM^YpLa~}d=$Ys>F*u8`pJA}`&V_il`gQ8$tXiQPQCk$?
zbLMoi4l_B~&4<~7T-q^Sp&#LlJ&yjQ44bK{Z&!WuqjcUtUthc{jW=?WY$a><DD~y)
zfG;McZF4xPvD}uq3Fb-E)_%*aEv+ix%tmQ7n#b;7%lfq+g~w?El7yb|_pehG_gx+C
zRd&4T&u!egZv(uyQfPR%uTS)|E{9>pEh`o%y;zf%`%WQ2Mt4;gFa-eJljr7l8PKZa
zYkZj#k7orw?qjD-+roDF_m%rIOMyWM#!>gfc2z^c9!_Omp)GMY5m7LmH@yj>;7y=^
z32ABU2yI)v;gIQ7ddd~6Rz+}W%q=)BS&Lp?3m|S6ulklhp%fmmN3UMqKt({aiHV7#
z1!>o=9bG^@?TP@ms>+rBKD*Qy*_4E2_=4n_Jz0Eq7FPj*GUrezrFM+yD>S^Y<{)CG
zzbbo+0Z(`bo4*Eld}t$zCg9l|CT>$PFKS%=@6+)GlgI1=%AYlNZqkbv*C#yqT3R}U
z+Ne6}bca*MVxxy!!B|u{vc42EnT4V2t20*UC>|6g#mRBkMq1U_ZE&T`N#ZqAWM>gV
z$g41p@3ednMIj}=C_MqT|Ab{DPLn<J!HG07?f2Z1mBJ|O#hJ2?7Ln!ltX>itDQ2nA
zh5)Vk1ddW>o_b-j<jR!>*_A6F)6Vfs1^PE#XCj3Uz2_<WIC)AFcu8V`f=$aUj*ZQ<
zX$>feNLezSlgt|7Z$o=VSa)K8NoXgCJI<pYt!GQRi546qZ@i#nj!S%ua#$_Kk^J^+
zNqN0kOYyQSEVMh>-WeiaXQ;1KnzBy7?yc6k6hJms$(3NR{=1_XFyVJvw^L#T0QU9n
zUGt`jNvCUUsQv2u5=~9bQTuwSK{86>0`yRr(bBJLZcQ}r*h8KTojIyl-9G>h8@{Ff
z<po3Or}C~vF43Uvpq7JIl>>DVpqH<{DTym9x!-C3J(e9?k~sttRH<1@Alk~@EsfxC
z5U0-sulUBgMzM8dZEXW><EC;acr0lk)VodmjdciB6ggV(V?OKx6b~~}TOIAqZN~wc
z0Ufkm5l5b#2?+ppnT+d)0J_WuT^N!WI06MZi^L~Ht*%AbAw0UombFWUaS(t>kUZFV
z*>!ftpgM1r&mubbG4sL@klWfXcXoQ+Fv%%e{WXk-$U|#NF;`Mvp7}jC#_8<&^BaC|
z8P{mj#-Lhy6k)wp&8CTxO;f0PH}am^n5=0j{WjC2tP`dOs!lMlkq;l99v1Jfr(3uM
zbRV>XBew+8mxVePsBp*}8!3IjB)F%6Jh4OTepSIdHZykj`!hHx7ANA^2ucip)dPBs
z__@O+FQ5*EY!Wq>jCzQ(KYUZZTYl$lbivr21r1o1???yy_1b9u<dakOn~9^N_V!R=
z@3!~#>z=JU7q1{Z(Qr*&{`tq58A;VC394e?iz6qAC1PnLu?`*Fhl*dltD}>yLNq0K
zmGk|&t#x18E9XO_=S8XeVWCCH<o@A#0DF5Z-(?*Q9QHd=kuI7U*OLezmFnFkRy3Bf
zt_Y>47;<lCsR~t{(1I|Hg5LQyZb#1UNC5-Ua`vnSUBYAQTEX|;B7MZ?#drI54Z1g&
zkRDDc4Y;Y_e*6Gpo?P&cwl$?F^3)~ht+Cu`K=CXR1$_Di{DZ!5wd$gQCrb{7f{Dxt
zq+MF<z>$pLaZ?jnl>cdA0mb{XUtRmx4G_=QJjPUqs!uIo!Sepp310IDHV37RvCTe~
zC1I7tmIRRQlUevVecjLHLO@Wk6NsDlsV|vLBX%)?3Z2{r7F|7fXl-?M_4PHqDaZfb
zZ&aVrvIGkBhg(~fn-Qrf6@DYz(t<=z+=)O0lt9Lmzp>V0Gwy4}K53ZVI0C}|$;&oz
zk1~1{prepS!X{7aBQAQ3#q?iQ-i3!DW?9nP;CR}y?}C=HLwdx{PB#Gz3ic{91Holy
z(3NwzgfKoc|4}Em_Zh<qCYSq*{TTgsV}&aVeya_IK=c#}da3%&4a_Jj;GARydFh>2
z#z$@SdoF!*d*b!sK*^$jq-MH?$n@l@leNDyizX8ffcd&zy9VsMT@CgZgu<S%ZTL``
z_fflsx8EjgY4tT8n;2DDUq#EKO{_P*Zc-h+X>$(z7Hk*~Zmt|LmmuiM@JJ;R5(y>T
zCr6elgBOTI$th*a`kgy>ru7W)&klz5rF+-a(;GIm)_uA%E+&j#57!(sPJ^Hkg!lDe
z+zlFjf9T<ImvIx~F?FpUeLPCt1O|y@6+BdIPyUQ`UA>6a+4$hG;jJ0UjMuCy8S3hK
zCT)8`Pf`aFW!|gB3l=0xD+`pA$7@Yx(AyWKKrXKb+)1;?{8T{4C13uX0*rC_@o6LC
zXq!PR&OAO{)}F=O{(*tMU`^G`$kX$F4$G>c=yZFe?;7grhsu^s&_8sovPx5_l7RkZ
zL#>A9bT;)P%FPT74ZktW=u@q#&3u1$hIvpV93}VM+}5@!(m2<${Lz0pC&)44cAuzh
zG=811LVyaACA~|Ro^$UN9TU?Pz)Rz|kRmZPwKfghv`3F>QHo-?a3L}cMF?u59EkDZ
z{N0cP4G~j@J2kNxI1vJpf>?|YgsMEdvTP0uMC>_BEk!c`JAlhP)3U=WmVn@b)Rq@M
zt}iWF&%B2z$I_hGOeXlco#(AV3UEr<j)Mb4i#5(s#1%P>+dEjygprXpSM7fF_@T0R
zB#}s%VI-p=VcP8)@7=5TS@G+8F|n#zr9cYUfa>AFvazW;+bzXfh6*|fHnX6=WPp(7
zJiRp3>w*ze_BxWDq`9KLf4T0LCv0c{QP#gI3THmPjM#xgW3z>ek?I-0<#aF4c6v#t
z2-0V6@u3ejg-DacP)Vpm!Y({mb-;FrZ_C-twVJ2vyq$szxJHvwk|i$PJB{Ao(XHdE
zQB2$H?KK-tw;mG-D^kOtR>EO_#iZ$8_{mW*wlyvrg&d7lQ&lws)Y8+7v>%mF7h*|9
zfPm1-KfY>*>`~qLx7s^aQ{X)|>m3@hfk16uBj;W1LG#u>##zKqW?zLTCPhb<waHu}
z6~LuhbA?Nz0BA!2FiZ%MlAIw6Ufs|}@WXslA~8tb>8Q{_tq6?f79Dk)*h1OEtz2+<
zO#%M9jU(|<J5D??c|C8K=sf6i=6D{A+bM_mK!73~Dw_*mh+TsKB8y)R62U4(+_XF^
zW#idEMxxWCqLMm4;px*U1(ru@3g&^AEr_$*LsN`iWm#ZPRMmSA9JsXP>H{$_`c3Lt
z9CsLr*aNZ(*q}H94FGkn_#7jY9{`#eJHlpnb?KNL&nP3}<eH~Woia8ZsH3uXK-tYp
zMNiL1xmPsdNX%{1rcD~eHPk&pz~TQnEK$&en?K&DXhh&P<MqN$i1nV1fx(s{_kid}
z&IAA|{Mcb>6a>ifd4nUS)>;_aKucXcVQxyj0-95C$zq~UrjgiX-k#<0?bej2@EU#L
z2<vNa_YXB=Y7HH#j-*qeSlKh*Gs?_E{gvleZ4)dpO|Nf7BFtuUA#`Nmec`SXWeAoQ
zo|}GS3VbyR&1e6v>Q?=o(O@7U8OouZ)bIDvpgBNAaOm{u(~p*&cBs8{sh7@BJNF72
z7CDuuLWYEyc)IQ1XxxY-)qlVM^dlApU8?VkR{aRKJyh$JbbI1c!fd9WiRTYT5G4`S
z+r4cS04rqAgAsQ<W~~kmS}7V3=`4Ep-Y}}uP#|^jsuc_s_QE{1IFsg|?+8m846f!u
z|0JfQ)DrzJMOhE$%r0(4Pezlg%2n@SyL@5(qp>V<C$EdP+}uJ}8x2DODc;WQ8F-G2
zd86rQG^^K?zd9Ek++{WUfOU(yb?PJ_(5(q|R_1WQMBmBDNoiq`l$F&2O^(Q12NWNa
zQxUy$<cJYBDXN#RU9_h1WY*fX-Qs>88L`uG#*Fn?Cd~X?_}KX2P;CT_*vg;!lac5o
zMjU4m%BwYH4Q0?=_*8`JiL~W>^U>~Q^?T_?JbA(bVY+wfXy=jPExJz^%KgZ=u5bn3
z;_^a@_XS`zHN9Aqq6NI2M34f4=87VNs68sgxEYeSlCrYAU)IVan&=FqP@)1WA;%1b
zzSItId&8yJ+h=~0Oy|#@i=Ae*+52+qe_DW9bRV@8v_INVHLL;nXQIZy5R@-M1uZyV
zL_m@Ko@k^=Q7-3;O#G#gW9u&EnG;c%5^!VM_Ue0M*<RR^W%&)jW24H>Yc^5DG@bYU
zQv%1>5nZi_yeL~t^|o8e{?=;ULv@vGjzC++q}Kf`a*#dZl&mGB@1ZDLw72?4KW^5%
zxn$`$eIh|y;+~upYGUYYNkv4G$rsC`oH7fEN^)!Hv@1D$ppVd&!{H~7jtL9ocUk|V
zs~eI&ug^cMVSTwGui@VZ`ZZ>CMXO17Juu!d+S`ALt`K3FnW~B&efs!tg&64*qLQvy
zS`nlVJmd`=)`XaW7wJH9XwDX1ow=4CM)rEkwUWK=!?(0t-`M1v0*YuO`I;W2liTkJ
zz9wGe2gX2aHPkvH&&Mkv!7pwMb&ZVeS8tDn<ansm-T?f-<?i~wN0e@Tg6t?(7lMu>
z+M2;}lkRS^mu^I(<G<_RVZfjSLfQwROw;GJXOx5IBZd+Lk(V!D9yEUX;Q91=FA(g}
zj@AN9!%lU^>*RoGr6ZLmrH8}fK1EDCLH~diClOwqWG0O$u23NSMk#{9(@?4n1$t1R
z*fJOIzLa+=3O27VbRSL6Mo>pdbn*S0jNNvuRvkBfd{1<Jx8E+UW;iS*Oeix`C|N`&
z3;hex_hXfrVeRRw-sgU3!52pP1fsY>&E{%%s0iqY!<;@Csz2EKuF2}fM+lFSzh&=_
zEM%451<sHz(BCqO1SzW+{{$D(vUCL-H>$}FdA^f{-;*G23NE`f<~_<>KVJ)#;^B}^
z7twKuS7Sle>9917fasbiZWG_!*(n2of^8v)UAL-&8oNz@*F#$~wi~v=JcMf@f~Q=t
zNeDI3r&hd!L4)FPek_nIOzFJGE`#RNNYR@)&Yu1FXjVfa4o@}XXx4(R*fGce2j?n@
z;3d0ke^=PQpOY_<ukE+<0Tw!YY8n|eHXUM1(<JYR>R}Tk&ZpH)uSVr>4Tc(O^T~`q
z(^0*-a^Sve*9OUgXc*rF+F4n>Sx~vpSE)3ofV&B@FDoz^caz{tMecp$h6&L|o)3gS
z_-)et`&)}rpPdD25F1D_TIbvKmZ48bC5)zra;L;uFwjyNl0X>fIs0zY6)RUtP2;_F
z>;0M^ml2tSacY>c{Z!=9qxIa2AujyX(oON{SZF->!af8(CRN{@5Lz7qB3rojXYHOw
zMz@G*A~O<jC2Z}Fm_Jb^x?$vzBaW1K#-{yrRL-2MQI(aqx(ikex<dP)-yL<J@91|=
z3+}wDW)X&xmH(6~@-XUBO=4j(6S@o8+D$MQdJ)TTK(oO+_(U=ZAx0o5bHSRa71N2u
zE-o(LzJC{Cn7kK;J_cx)*A+h!BC!y2QkGGR%21Q6g(q$=vgyg$o5We_fmm}(JJYs8
z%+UI^E35)0FsQWIEU;&X3nQ^v1Y=#e)}EjO=z&{<YVF#WzJH!7N^YsrY4aQH8}&p#
zzRhop_)8RISqsBy3BN0~nXga24-e`!J{-M~6zbq#Dc)UP?4<9dD%pmgu3J;e+X(B;
zYU$Pj9}=P&BT8W9lT21d5R}YQkrZ#I(q$q0_^EX!RBzHUCoC~G)oAhJ#S-h-J>tbn
zLV&(8a8x(C60sa3u>PAJTc5&IWCax3qD%!43-8dxrgJ$(|4g(JqQ}B`d>tg4LjeaQ
z5Yh!qD7*4137uE4ewyLpOKLWXy#tnYk}3dUY63GSgeUT~{1Y*8H(N@!4zI}<2nh?>
zrnpx1<M69r*ni5`ab@(Xzp-(lVaw$$n*@kpm48&uw$EPwI5X3c?nU+yq8r`5dv{7*
zBW30yVcuYGtRg=JW`SBL6zDZLtTS+9o_u4?0LszlFJ4S}zOu%hw@bx0m-H!UAXauj
z{5@Ts7+AKQ9i*YLy%AzC(I$)fxr#mW^1u0x3wIGpeR-Jmzg$0#!u8G4EA6w^wmi^x
zVInt8G|fmY4#E8V@6+w#(^*(p02vgOKQDW?-n)k5?QIsOPQ+md-9$`&{o<=WpT1h(
zLfe--08#j-ahuPl9HI?$A#QQ?>em;zN^ndA8z45<)4KBjviW5d1<?{+fe_4;Q(SF<
zAh{dYEuJnJS}g0eBz~gS03xnU;1-mUTng;m$!(Bs;Tuq>QVKXJ#sLjQKH?Lo%$(2S
z2!;BI_7F;&IS4~e{p|6F3PVv3En0(%{5I=ub>PyTOiy?G#GWyhiY;3d`~FRTSioov
zFRBCx>b1a7A3MCKD>alYm48a5Zd}&AAkw&oyp^$N0A|<n0vkpt>JrzDfdsYSrH54P
z*s~|fGXzJ51N|1)P%uj-Ftmq<#~{oSIF|e?ywEp|ZKs57lnzqxUcrx_K5Ye-F6Rzt
zp*<f}S7Anmmwp=ONs(LtE66L&Bw8C77^qh4AKPhXE~~T5sik3{RPUsXqq*_N4M*CY
z8A-KH*vC!ekjp=rR^+-;{D|LIKKJpN`ZkSZaBZ2ux9C6e5auy8^>}pu!X6Z4<R}EW
zY5=X_dD6r$H#YEhZx3?5x8LHn*!PrzD>;37bBAvxqER%NUo?2lO@B?Uu`pD%o-i;z
z2voS7GC)8MzX_L0vVlw9;}zs>Hxeg$Ua|Ppfu+f851hp<B87U(mbdRr1gmBW#4-Qx
zef?LIv<C(1IWxIVcn6K;t5Bq!c^{r|(mUGj<Z#426ohK`(#NT&sEBttZJP?=flE02
z&u2d3H0ktoaL2XBN2@;`7IvNxCJ-=x6LlVQw@m=d526Gl;{8eAZlrGoW0A6JQ|2!A
zns^#Z@l#DAZ1xZBK~|Pwr6EI9M9o`qm5DCq9ux}7a*o0fgXV_;<e;c}!7lJG4|7#{
zflkTch>I+f6EsY>SFa{QyHG<5tIH_dOs;j0K5zE4R%TWqsdADJPU4pj&U73fT*Ifk
zKPC|}YqIo8Wk45b1=$f!isZeT8SY8Kukyc7JQP3#4rjxqOP8!4o{U!X>b*X`a#+82
z*UK|TN^?pl+lWz%7j3Mxy}7--%<VgOis+dTqM&h4WR_?K{Sc}KGdH(BGB`nT=-inL
z^Wi&-zBeJ$k%>y`b(l;UhJvL$b^SC>vr<4TT)35nDuM45{>cjj9NrU|nSvpUs%=p_
zciyYMJJJ~Pbp$67yEEo-z`*o5@evi$f$|2WHOQlst5c_rKmtF5fVq9@YO3A`pR0Lg
zn&CWOzt5m&NnjV;85w;>;s6dI(N;HOJN+@!(Sj33y$c;ww~vv^P~U?5Yw#sApPrlj
z4;x2tyEt}WXw1-gZTnK}b@-E%0@Ttw+cKsM1#B;BVi`q&3Skndqnm+lhK!Hl6BG_B
z+Hdho!Olsu0#0FNCOcoy4v0nT?AdQUM;_AJnjg3fu9lJA7|*lk&Uq8E{WUs>3TNun
zsiY;D!eSg|e7pB}Dc{&4O&TW640yF6CJNUC0M4Mxh=LVLWn+|pJ-{0P>G!@J8{vKw
zB^1=Bx3#+3qLcfA0t1`(NlIcm^A@~y0}_+0H~+?v{l-AK`%0xT_*aI0(c8Q{m9s6=
z9-nT(q3sC*&7ey#rR?VauPfBMxGvO8w$c-!WdEr2Jp|z!6g(e9s86MhG=Bd4_fBE>
z?rjAUFRtKTP`#z!aNv}q1uU*W1&&``4ObVfDQs)go&rn-Fcdxb()TZPi99}41<teK
zSTG2`_19k&kJd2lCVdLC&x{E-g3;vGiSi!WA60T%b2E657|&-2eBp9}etsPq@`%_a
zizFBm6;B3!m-N^r_xrs9m$0mUaI@(|zTsPahTpb(Xh8NpFhIq;7HaAA9fxUsg}CZ-
zFA2>+_ZvS7{~ClLS<7Ct>h#-Ejb1KS?Em%frDtl^ieJClt($dc`t7#owkYdF#F_`U
zjIFRaJn!#%$E+51>o#HkvE5@dHfe<%iwwIs&*rUDa=lOU^@i)t+Sb0wh*?3bU3mAS
z?hw}<f8{NYfAOH(T>Fn@R}IS!7Ok9q`t?i*7+Gj^`g3ej;)SfiwoZTpCmiBKDcmy7
z%^q27Xn3p-QjPcR^?lUM>x4I{>pxKkaRmKg5Rj!HJ%ak;)ssEDZnwV-4JX#v01^*5
zps#ZaLL1ovvm1>7)F?dxv#01LN7wD>{AB$Oos^2C1C8r1d)dyXX(Xn}w=yz5tuI2*
zf*IaSXJ@OEcEYHN1fEpDO;#{QQ>%JF847OnXbyEE)4#kZbQWiM_WXq3crqwR<FyT$
z{yWUMG_wMkF&tf9{A|ywwG~?_NUZ#(=qQ8BnQ}M}_KD6SLFRtk2blX;Fdsi-&KzIH
zDUL0t*vG0Y8CB=|wD1kbVh6>rgiBN$Ah)9#{-S#s8`n`so{CO#Z~O>#Xv2%Nm76!^
z{L^#twaLftWgH#d8l-`u>$<9PSY1vMoVZ1Cuj)VI+;N15tp;fgGH@^C5^OLtC=K{l
zo%iUqW%+j)b1YEI-_ta5BJHzO2eeCpSf@VY<M!maJb!-BF4lR5vva*es!f>ZbM^3`
zaH<XL6j`<vnI5R>-BrH6zKnVdDltX?_wf0W3{LOh!Pn>7<&AhA7dED-DldG%%j`7`
zb@b0e14*g@X|RO6#9L!7F8w00u~OL8(K!~uct;QFJ(!CW()(jWi#j%&sC4*vw(CwK
zz}-Z+B^XXHY+tVgy5&Ggi7R#5It`|)_>9?lb$>so&<w~71|$xl7Phnh`Y}HD%fez0
zbv4npL5?`$g%laOu89%sO$)#rAg!76=0)>v>hR}{HmNF)d-1*XhQ@<>t6RT5P}HR2
z9nKe!<C9z-kP(9KG4X3TYLxBTPI`J!WTTj03J`mVUE5#n-y9S)Cg5xiH6XWJe~2~B
zjNXOl_f}o;=ERy1;IuN4s^lrgJJd3a=58YZ+gIJ!Ft@D_INzave=4N>9?S{E-qSE2
zq(p~VnD^Gm?!vqwD^^_2o;|1;UH-)dPtD0J`}!^vCf4?UXJouFQqa-+`=tM95g*t_
zW!bVWK|$;M8n<I6;aU<jwk5j#FAiq5Bd7=<mzb0siO3_9N6lxC7{1+Wp5AWK<=^{y
zfBzc)>pohU6tpC754bn$*stFndOgNvZ=>K12n?LK7P5cb<jK*4vdD&<3!c^zS66xJ
z|2%t^_vVc_I`9cIPuaKT8PxTtr=uUt>%>$k8B}eAl~uhE<K?fJojXj~0z({aAF6IX
zZx|{es1t#V*U&jT@9E&PLPp<>mlqy!Z>6}f;OP!}(-FnJLih9jDDz(<j{=<SD~kW(
z9o6UFM}15#K%rf`?u|WaMx2~FbY+9}$ERL0q;8u9MbSjPSv|sy0%fn>?~r42vtxU^
z5hSQU?w@As*7u-4AJXq-8phah>fUmvsC~ng>U~U1LPexX=@;V=Z^BcAM9~H^(W`u4
zP|zjshmZOMD-dl_RycTmZbl&#$+Rh~?s|rOKq-#7uOz}vV0a16sWyL*)iEc2{Nt>X
zoHTpRoE_V?jh%1o&kCCJ_|ssl(1T&}xPws{aG?Ur%IpALA-$UOo{qmi>WUhqN%EL4
z{EM?^aR-Z>*sKdTPRu04BH!2vhB~6<SkYMf0x;4}IPcMwKWLL@X?CGWHrh?Wa#K_N
z5bEaT=7zhEm@pl&0kccF90C$+36G+T|JxZF+Q<tTE?FgtPlU`;e|;LGYa<o5b!@t!
zE-M4Bl=fmrSQzilQ#MlZKzAqXQjf4BH_p7hO@~g*wes7N_sQLrdLFQB&@_KdFvFw8
zAGkB^hUe<odn=tq0ZDG21*iv2JgUmDY4yd7s5gKqAde5v(^u6-fppoeZuZ5;h3E9<
zX`P~w3E)ibc~w6^{}$Rrj%n;Y37J08OL(sV*niNQ|BdP=iHAOg7rEt|XFcjbLh%y5
z9~Oe&gb{@K6hI5YY=58m-eF<Y&=v>lR#w)fyY4<3=KdB}kP5c$yTFk{L|Gk*x>Fqs
z3*`DVj^pA6>G*V+#B+Q{jq(OIy8pm|$L#~vU-uMPqHo`n`}ao|k5dSSmy+U3XxG<P
zH|o(Nhs+p74{_~#{sEHW^#7gV*>2FN5TX~VhFwka8#1YdU2Fy)nAFvzY13pJM5df^
zTz~LmQ!mya%BRhYIPR|U`V_>5v0Fg`qm@r71L>$f&57AUvXaLq0H%=cPoC_?exo-F
zAsOHqPEj@mw?T-D#=vzDp4(ucnzU&HuCuUX8-1T>cYF@-5|RmXGZ1$0?w6vEpk>|H
zV}`fS(2eSkUjhYv$7e?J(37|Y^QKbn0v1b&>BZ$`qUfZR!=;OKLn6B19<X2BdgF~R
z{6!)m-(@zFhQst{xhA3>R_<LhchTVHZq+g}pLFTdno<0v_4(@_8|Ll1f(bZ0xTI7*
zf+UIRsBbfzGjjx8c0rNLrB@HPcSt)@ce0)H@~5@8Xc>vnN^JN(dFt5AMqhQ;e`WO_
zYGzqG-Kss@kQ9LMreX!BW#oLseMIm}4%Aa{+I5wswV8<P+@V8FbV4<1)R1qN5&gk5
zU3Tjp8ThCNPvE{t1wcH`qefe?dUYAX#GcGDQ9?X698*U}|8KsUWL}8tH+Tn6h&z~?
zk(CuiU4*NN3hd@R<muMar-$ARp0I`E%fOiuFqtFT>_;}er|5Ecb_$QAV>EnkIbTPJ
zEY0jTUv3?E%7E+uc=+_<!UNf}=M8%pI(Q#V9f)ZZkE4&vlm8nPgGiOb9UTun$r`*=
zHTy#Pk8_Pl>Ez07pn2Zh>fm4XH(5P=^k^rkn)WZ!W``UsrP{GUCkHr3W02v?v3hiE
z<uc@zhPi2eh(~6laS_qVm@#9t`czW~$oD#T?C1kby5r!%zv)G#Tg3RSNuy@wnRTF7
zW}&~}ZuAyUqJsws6hRs5trNq|{r59I>^EdXt@JZ9hGNPU;XYvY%tebH5R>1(iZ^xb
zm;9J>5PbYtf06fV8@r8t8_S6v##M-V?!Ii96CvhUrtXJYO56h;8y;3&w{9KkO0(g^
zeX}Fy-STU<_BQltDmQb)m@$*$+Ekwbo#YOT)cf(>W?0=@mUI4G`$288FJ%>;Yut>O
z!D}(J@1W-Dk-UZj%K85<d>*zmv(+Q=A`+3&@2#jdO0jg9G3Dj?Hplj2;75i|1i3sL
z8ym?h1FAj<Qy9$ULkyJ2Ly<W%ZV3B7qV3PAo7?)6Rv7jjiN<^WKWB8<B4)&C>8PW#
z9)>x5+KmZ@q?Vhsh~f_*>k=3qDP9_CH@fK1q5P_szp_8+^<GY-V@&w1)zcw=f@-w=
zrir-Dl(FVq06821{^WY|I;C||gW5$MI^@OGby@zRgGKx9r(f5I@cdB@L%W?S<=o8a
zV{M&@_qDerocVnYcAj_8$6#<a;$I09AmD@|xh}&|zd^Z*c1LDHn>KHr5k9mwvq_eC
z;DCkM#3^-r#*T*NB&O*0>9b3s)bc`cGZr<1UYf2?bm^Zv{hhvdiH8Syuh+dhcV=L*
zM<a=Y(If>sD|U4^{aID<5emSIBC5A*PQtiLq;-RZ*%xGjv1RMld%hdByJ*k%1N=@7
zsR>w_!2~%P|KL>i4@<qyTQy;t9He3gPDPH~h&6X`SFMMbTeu@Sh<$+@S@!@GDZ*sN
zH+&mu+vz5(1pB159|1BW^6Bo^%XfU542VE@nRU}!Ejc+^P(5)kpbxe>u{|v8A&tub
z&mVn24Ua@e7p&K^DvSQPDzj95_A=y}80hKSn_WOO%CI)LvvtKL<JEQ#xD?-@-&Ue2
zEy#?~M3-RmUxBCWT5UOd`0$g5o3;BZLPN*eL_GuJXay1-9v&_uITL==zyA6ua`*9Z
z?hDbDWEu|pQ`|L*XlBr<lP@;&GWSl5>6n}LYZ?3PWJJu>)sZ<J;CRMetawi>4eHE=
zKPutf=t<SjidJZ;;N#b@2?uuAA2Jw9AjwOmW_5}vmBJ7<c5hFoTD%WiUfw_&eX&9X
zOKR-a#lX-opVc=4>I?29UxIrxdSxX*3*(W&Kp6;eZ)1@V2xmuo7qsSn>cTxccMb*c
zAHkV}zyz0(;KS{ymB8DFId)`xdJT^A(kcReEG1*gH-cC$deZ5(2&U&Ui9ifwKkJ2F
z+9F*FLI37Yctf|0!|TXhspvbBK?hqQzrwO55<MGM#tO+XM0*)Sc?uXxFQ!YLK>Pj)
zHm8fr^BbNAuqp|lo`u}BM(0ma`rfH%Rp#2kg)98eZQiow2+vv1`*!d!2!Ohc8&8UB
za8mq}de8YghxYvqu5Dr2Z+|B*9V_ItJ+m*&Km2)l<2GJ_+OaqO?Qp&7N73`E%QrK%
zc4el+WLqnGJ1W=evc|EA`bjeoEdiKj%#h-x^y}A2aUCZ_Mny>-#`GYD2E_wF*<ibM
zjg9vM!}Wr9VJ!8q`#vhrO>k7G&8(Q(T>&f46p5^5MvAtPkzoDD+GMS};|Y1Zyv)-M
zVUPsT_761YXGUw#Zy0<&3jjs&X8{p~{)B?y6PK14+BWCIon~N^DO*}?03k*2i-vwT
z8p^?+jM`m#!E@$j&n0|Jo-(B;vOn0}6kZl%qTm_+P+5N!(G+Z=YE7rH6_R-PR;^(~
zl+v;?C*BuVY*$yGx?^dYsrkhyjCdv1*ms?PqmN<$0GZ?m-z@{z2PbPWZowg_{h^l2
zx*zX5i^14*5(cq3;)IZG^tmf>jfu98>&pkV%6ek4^1m0jX;TE5DEQOJ?m#f7`*z6x
z_?b7KMgl?>V9s3s|6bmQWxTwTL3<wFS+ChSXJd;CSO0YyFmT`_?CtQZu|M10Kwpn`
zqgBuD)rI#>{Z~)-I2ZCLP*`o|^!=SzFXcZiKuOrI%GwOZ$BrC#A5>t<m8E(@WYMuV
zXw}Pyc$>lbj~%ILUgxoW{Mrz506o3j4k8`2-LaH)F=lmi+RouxNKZf!F#h<&Zj{wC
z8@G<1erb`tNNp7G2CeY#poEys<$^|*H%DNL85Ga)mv!qdE){868E#=~|8a*+6%dV~
z<K6!(VnVkP)C~pndLS45yaJk>2@0*g3vSa9OUci5%Y!{oAnX%p2lC{un*j)M__VL(
z<!^|Zwu?SO@^C~H)DYIvIFCIL6Z5{N3qn!-*lBzyzS22tVVj(0ukj-bU*~)093r(F
zm(F5N=C2nkRyKtB2Hd28Yy|$`yyvhHaGgx~$Tf%ZIR~;GJF<z~6ZMCd^rgj3E)2J@
z@FTy*-Wxlb_7VpTyT<+y*8MtWhi{m;r`t|OeO7(>_YTUS`3Q1vwO|o0Z;Tt=Ird)k
zIog!tk6(SQzIiRVc?y~AB9k8>;mBY7xbR5EPEid}Y>SgH@T8Ed=nf_xPCCbBTY}jX
z9vF8hRAMF^Z!Tep%g&5IwEcckzcE#}0s(y~C|)lxOGXgc)!vdGQ7;s+<YCpiAD>?t
z${4k)$MY3f55fNte_DIt+r-?G3foF1rkt8f_ZSw|SggP(8}%;UyLT^-Vr@)p_p4WD
zw=NVAjXZG$Zws<o!iL;&qx+ZBBZEJjNp_<BN`CtE`}SuHYGDUeS^H{#l%DM_S1fL}
zYi$NZ+h&E>N^o0EO1>pIYniTH6I0<r-fXkX3n_}&P7subBgIFf(gCCYmDeuhp-QtN
zg1CC@ABx}z@=-6e>~iDGc9$GxPZ>IBI&d~@!Nj;N<AD0G1~P+;j;$DX7|>qY6yew?
z@uDxp*Q$P%5exc!+)Nvj{^-&8EBog<&6qI+U;6CX(fQmY&;z-dCr_=;QCz+<<oYT*
z`-`JsQv*?tQa^~){P?#T%E<6mJstRK@*mzx{xxar*h6b<0G<FoPS7SkxKZ`Pg=lk&
zb`JA(`^Yx?CWVrrWg?vyd$9i!Z|Zdry>+|h?>fwD^WZsGGAcp8a*+Jabmc7`)Jn1u
zA<;&<!4=U+3E`S7M~*y9lM7VIPnbU(o45nT0L2<=A4|}Jl3z)|`x7ENU7ND|-MlB=
z@8d!am0=ST)T(96F6%9!Uf$lb0}|$AcFAJQNd?d{0vn6V&t{zF2LL-NBXP$Bu;Z9x
zO?>A3c}9i2a3bOG-no679S%cAT3qQ!a|<aBba5l&>?iP`Lr5X@LOt?QgvY?tZdO1A
z1==yy+3hZd%!v<bGhm$V<(Rs|`_4<t3I9C*>ZMSMw)MY?=FXZm=)%!+`$_gvBVi`h
zp~K<MANquUzrKuM+&TNhl8V`j7F8*W0&2653IDS3^9TA<-=Xx-gupmvZ`M?F^ic1;
z*H*5uyR>NQfddErAb9>!M+W?|)vgi2uqkxF<l<ho%OD~-mKUm8m9DSZ%yjznp_3-<
z0p6F{0u$zyzE{T8Vh~gpj0$b@{B5O8xkF&N6XP04k#F16=&zHLZ&opK)*Gn=8T$cm
z%4OQzeUcWTh~a~VVpxZx)1x2#`6JPrz?30U>ht1(-ZM_w53DK+`-QX5X|1n|>9z;<
z(XkrsI{uM%ZzH1#bse0qIyr|P2o4^G9yeeir*y=~k>f9>`wTXE_WarUvL$_Pj?&iF
zhAZ`o(>5zFFYnQ_r_}E&1Cf5f8%CN$Q7nj?+~LC;7%ar=l%oASa!z9810*D%2S<6G
z)JT!%qdHyQ7aD3ke0VLiFNE10`}U2X+6BqfyXs@IDKb(|5ZQhE1Z3uG0d^BfW-M56
zVi3V3iKHD?)#8%|bO{IX5Pph%oHOfSlfU-o=Slew!%iRkhTQ<^qy9ArHK`{XpI8FJ
zV6o`k$B#kb;kh+C=i)M|QeqZeJ{`bT$;uagQxG_U{>{4-!X=N!nD*p%jC0Z73_wd8
zmneAnD5o@^RrewQ!4yasHZ#h;YsJ4dPW1`yub+ag$$lZL*6NRuj{-)ab&MU^wV!m<
z+-|8A`9{0u{_fgsV&}cgYu2=Bmyh<xj!^}iW5GLl#(CDZ5`MFtY1r;PwNnFcx}2WB
z{AuS;6w>Dr7Rf*uwSD+>9rFpGb_yhh>{#lGt;&S&@p*!u*pw0ktSKu~`S4S)i==q5
zi91*i@mmVHR2+5yCjh!0otV-)_8tl5F%D|7IT~Je2-H6rVHV#pdF&WrJ;EExd*}ZB
z$5aj5x&K@e^lJ4_8ZE%)-S0metxvJ|$wu*sYfU~}`MPM?M^Bic%wrQa6CnWotfs+a
z%ccG6ugw(E4Bj1`Mtj}a(C|ZeQ1Bcq;1XUq#xU*z0E>!&rp6m#IDj)^(5}n(9XKF4
zKe9s<k`%^ATWV=Rb=c`DRxM6VKZljhznZm`MjeVjwzFZFe8OwxKa|1Z(nR4^L#i;U
zj9!ij3aW8S)aii7jKkkpS>Q6j*w|$0K+drsktS>nr9ka2<&<J=)%Uqj`U&-aWzA9c
z{xO)<WVLJ8Rxo_ss^6kE6pU}!s3=u$$L`&Om^t5#AjsrXO9Eh5Q=`<lGiSDu%DAz+
zoJt_xH6h9AH-fj9f)yxPqe@k$;_++C{Hv>)H*Jc$@)(Xgtux4Lh|n$a{X(Ei)<pV9
zP-b&YUQSL)!fA^sUyfhM)46L1B@Jm&n05NJd)LNq-@Ti3vStLugDAg*54-lOs$vZs
z+JB&GsQ1wg^M(vre>ZqgoR^n^5c(9w5tXK#hu{MTMxq#`uFfdDni@28;_g+fwSpTK
zhK+G%F!Y8jwDV&dCUEQBxnm;!?O2U6`$y@hq%S=*ApG2-7se!-NcREFI#C@nr*MEG
ze;?Ue;v9@ir27=AhO0n{=Lv9YaqBF6a`N7;uHzZjo;dsqKzfVOweJElMCQ#R4zOBA
z;sD_Xq$6W%Z&qKuKew{t%R;@Jm5cqy_wM`C2JwUtU2rpySxjkRxJ4<g3X=e8AFMbU
z9NdiO0guxq!~o_r_|yT86EVnX{`>&?j*Oe<PxR5Tz5n(lJhrnwh}5c_8x>)znLzRj
z-L-1+<xD7m)~yftnaqJ8hxr#!8IX|%vKHBkf$Ct*852eTY2g`GD~B9<1YlKOAeEOu
zGz{AbDT&us3XCzXU|pX<86SLhY4LffE%2Q~fXg}XT+q2NbzzGpO=PPaG=X?$Qm<|g
z3AxYB<#~$+PB?{{vMlm7u*Zbqx4`gHX>89(JY``ET10YOB2-}bXPHvDd-)sit7zzu
zL*1ca?`mi$mrN=ifp(}zKXEL3ud7-EEq5O^vn+6exR+Uqgck`Vc(dH11^bQwYnKrL
z>8Prc1>GenM*1a2dx*xR6b`*nI|u=$kYL1Wh~e05w7cREWZX7l0mW@;d3mycI^){n
zxIO0k;EDF%zkQR@0dP(Wr1$VvoBvCZooz#EL{L&)SoC7QG>9o`Vrz5f{{6?G<27q1
zJZ)9A*lV*hjs5%QS9$|9Qc^T8Y~H~(@BRA`qegAXo^3ngcQcv%D0<ago4>9=w4NbO
zQl?IEN(`s}rV9q#_U5@GK-|4^gn1nm)QDlyKATp3+rV(b*|k4cp``7&_~phfwfC3i
zeyugYsKw|OBkvb;G#9<PVgGsnmF?Z-qx&UgNJ3&Jev4MTY1;eT+;CN6Bb^5pYR26R
z4CG)U33W+jsn}K`;G!2-Z((P1*|Xx}QU_<}V@s#@UNyKwhYftuxBcf|)p_|4k`g~i
z(y8#_B*iOWJg<w3?O&VFI`PX^&*v^$6c`)(xp#3MuZvl)IlyXnC$BPk3qibXn>fS(
zTds~+Xg_V*<XGnk0Xdz`K*1sVaO4+VJX1CZBD<Bg;R{mPra<~#!E&CcGh3_v&&$R5
zKud~X{OAqnA&~E$f{1KJB!7JU=untVToz7(mP!2C5T!9Z6m%jA#ULWwxMWXm6ge$A
z*^{1i4zHDFxa()@y*-9}|CxDd@v9~ekyEX6Y*_7xz%@mpU<u=J1>lcZn#?8k0yi@$
zDJuPgC22NmHer71JrPYVDSFb4C8Wnce~W`w3}L22U{*@5GnXy_5L82+rK){CzMx37
zJ*6Dj$Kjv9x^#)&;ZV=h4v`$pL@iQ{6w+Q-Uko*(-1EVJltxF7Db?boK2}T{B7diB
z*B?<MLMrnWT1M}*C#cE9zDT=3p{VMP+gooG(aK5;c>o>7!fGyhs@cXpyZNX;o`8j~
z^iTwYPM|7u5T($fQeCCGFV~DXn(kHzbgtK}+vvK6yNzxm;EZwmfgsG_vk?#eEU^nN
zw(fFg^Fa7T+E=GJbB?OEGI}T!J%;F47S5UT<?ov*=h9TCeH`5OYpp>audn?$Y}q;z
ze@toue)9-~NKW#F_z7Yaz`=H{^E0Qd+hJ4m_AT&WCje}2gso-&J_83HVE7nqIin2i
zO-!oR7xi28d~7J|v5q~?LWQ($f!RGqS}ZJ5J5R4z@~l<s)?id+ou{`r#6f<Wq4z8$
z<!Ewo)X&~4KaS{&18c9vlcrZpctor=Q7<{UV1M6*n}8Yta~>PFuO}<uVR~<ZAN~V-
z!+M(ka?)MPvbT?@2BN10xR)1YRij-fqP2{Cf6#B+eQawtR$&p8m=S4b|0QN?+rj&#
zDr4&IZT$lgb4ovb5?I!GkB#04Gh1nS#tf|yVRsGz<D9?u-ee4JVu!?V1Qg6N1cUg3
ztC}$`@hIx|`;y64nQf6d7p9VhSEPr1baCNSpooZR!F^{|&e&67u>&6WXZXzrt1ULY
z8aVU$&70wwXY;<kdh&ek{P{RjHXr@f`o5l#(dYHg8rNUdyjiosXQm^-*yR<~>G}NG
zvo{_%@T}(7R~47@uU@&ba^r_}E4#uPA{|2{(R<13<hj$k!wzspmNM~3Ntwd+YI`|!
z*DfWe$@ObiINh1Vf!y374A$)`qI=+{OW!@vZq?l|SrbiZ4iTBFdffhQ2S5#*)6)lY
zFGRDK{dU)1G*RNI3+5+Q;iTUGZi~(E{dY7ug8Gvpv>R&m$zj=?69uu6etRt{Lk{<a
ztNC|!Zrg4%z}UZrkWBz1pWs2AJspNUK19PgZJNPWqfmz1Li@M~ERn3a(<{1p<(FrR
zuTepXIfM8NI`0|(0sQ|SB`hPZf_nEFXH&=K@Z0?Sb2xCz*a5JX7|KasLd`QVu8&UJ
zqAJ&SKUE%_Q#Bd6Y~9#08=VIg-Io_;(p;SJ4ocnthtp2$!y4O?GHTDpK7&|m7z5Tt
zMw2uP96^2`K^ooFWA1#FvG+fxZY?;~RZ<j`C~AXmPDA5qG8+4sjI8hNOd&ZANLjDs
zDNnz4Vi>(nkmn1aBj?!;!|oI51Pz21ql$>;`foz5f>mNh&|bedr+geWG7S%#OSL7m
zKHRb&m6brA?qn9}!5j3^RvsT|)>IO=3>#C$O{!Q_#Z>%sJrk4Zs9qYkQLJ7)FU{=u
zJrg5tu*`Xae(ANh8@h7UDrtk3F8$;b_0E6CkqyzpSA_biD#K{8TS{gA=Js~H=gf+i
z-krc{289)!tB6mS)&8`;XAlj*cxHpoBPzx8>hkiU=JKbwG-#D$?Dt2{5S0<Xiu_P7
zant^1{CM~C>eTH~NB<8~=K+^<|F(bgM%-j%XG_D(xXFl=xS~BMBt)_+WM*|s$ZE(a
zl}k$~$|$>ZE2C0Ic8TI9krAr@`;7bd{GZqB_dKu1kGih!_wzZ&aUADy9t}JnLa9xo
z)y(4vjd&`4+#7zBRz{z*)}WJnoU-y%>e93N52o1vGq8L2!VQTsCEsurf=4#~Mm)aw
zwTvjM>11BEfU+MDyD7ZSk)?&#v9M%*OSUb7k_j?P7$UT9g*0EPdz0!7^#D|Xn9iWh
zwmhDU_2$c$J!W0=jse@3(R*}~5p-N!pu3<Wq96gsj+xZvc@9l2n`uopWw-@?Y))tW
z4Ne8d?CQkOQHMZfbeRI6Czes0|0<63s72jh)y9+KAKu-RL{~L}w{7x4w>GG6jvw#K
z&~xsa^9`C>hrADKPgxiNmfmsXD(kl!CR<d@yB+bX-)i*#MV~uesD0ra8Ic*!&{5)|
z4WYYsU52o!fDo@hh~F0Ur{=e7BVcUw=bz3Td>DX%)cRsxuxZn#eC1Yc)4TB>oyOex
zaV=zjsB&%b;zf&0K_I{Z{aRR-mz8N{2j}GHpU>SzH?&)2wd3-y%ZKK9c&D6+Evfv<
z(og-Y>{F-v9)*pjZyS}69F59Mv3lAmlw>$`sr4*h$^VvmjS(DCo|Ax&;K6cs_?IUb
zOY#O7cAu9QqlV>+bYEfSjRtScSOgJ?L2e-ZZ&3n54nBWvoQ-5w@f?`u(frN(sl1oE
zyIYNOvYo?~!JKawB~Vf7>SaeGBBV*5ckfs`(AyIhFD6UQ_KC^3d9w*U3}sc^axME=
zGiHp&yiBI2n08zg;92^iH!Zk~C*w_G?{Mm*s$a(q8G$Dj-aYy!zkm@l#pu(2xGi6f
z6~#Wd8{%AU-$(^rX4E}Ljn>>2!-`$&i>(x9W|7!l5;-M?u^K&c`GlfZjCdBnTc>4Y
z__7cIb$?#p3DDY)3Bh8CCeS;{F6GDjWO9FIhou%V>E3Nkl1G^Aq9kulFG#kHrhE^m
z_+u%!E#k<Rl<R=K)6N|)`L+@>OAv!G3WcxRC5^UGAQ$79#~139pDKVptkA{OwfjwI
zQ9*UaIXYG~K6Z3<`lb1OzxsJyT2qnmaqg9W{_)`+$vC_S%H==K<;ge?5vybGRX1xh
z7y)5-Jj7%U>Rc&**wY|_cCD+HRwK{;gYv;PwTC_Fs;wQP*dDYcxpp={8ha;0+q-|v
zp_8Fq$&PdQ3nY6C5~}|$g>hDPb{L;ABj{F)xX2+0Nu^qss)wgLHNg0<TX!R0e0i5~
ze@rWJw`4ju7#p=Cii?qIEKe~OySf^RPN~q+)a=4I$VF9Q34D5K%uNq9z_=5YG267g
z5ii)hecu(5NmA2X5<jTWQTx(ZRRjN5IZ6}hUWHb}s3BoynhIb_f9kd5K^9~9bZKM@
z#pX6Z$pLTo*NS*$X&)qAnKB}BPQ7ys6XO5g?6FtryO=LOdQ<J736%88KVqfKs;$o>
zHHxE$t^2w{pWTD~nirprj}Id{Db8BChcXlW@nFW&veO#uK3dzQJo+5vs^AqhnlRpb
z&vGElsLlH79XnEhMnVK3TaM>|xju<^^!X9cy8Wc_<7EJd;X7Zh3zKA-jNk$qujtpj
z?Luz6(yO|4yLJ<3ImsUrnWUiR@4}GE^?HW2u>_O>F?rlBkCNha|1g(KVqk5GNn&2#
zF8H)&QX5sk;kCoGovPe5$ht2%5jt)z`2ca?<=Q9X(bUKFja8FDHjE{lIC(ciMmoH6
zGpzrqyxf0%aZ6TOMVvi5`FFWHvxVwf6)s(0aj+7GjjK=c?hEP{%z!5a$}41{b70zP
zN;kDP5S-#R&kMu#qyb>j75r3=e43#K0&U){IJ(4q<>CjQo_?4+PhE$0i0KI%17E6_
zLGyAplcKFa)h#!L&_ZaxD?7zZocJ^#jpxQ(A(7ME*dCv6a9Gmhz=5YyllIS2Hgac)
zB&oux+sl=UKUj@=5c3lt8^PjBj*4Uwyx4-;*2k#Z7$~I{!cFeGCG`+4cg0UHB<re7
zcYjt`wO|dNn4(-jr>huh-SEBN4EN>BK~G0ztc62S%qZu@;gi1+-XtP2atpx+VCN{V
z6Q^DCd_g#D_UoHKR)|yzeMIy$MKE%QtRoWy0?zHLyxM1a%02*S8Gm30VV6S(YIIE6
z0~{P4xwcXDPJUe^k^lyc_YGONpCWCWJaSN@d6kXlHE23|OH=a+PgMeE%$#|ZdU-Nj
znV9i2X!>rCVSV7B0`wP@yh?<^b^du>EM<o0%sp-^4KDrsD9ElD_8}2T%+zW_eJ2DP
z%(ZB%We83vBp(&`#r<=iJ`Ir-TP>Qzy`%=<i?5t<aP>U4ie17L*lFuK>~0m?T~;hz
z8b)aE`Tp+qr7PUrV%(;UG{MGh+R;MgxpgOg><prfLJzlYM(za|4uZ7yyD-nz^x0D{
ztV%R|ZFZ}OMpE(mKJX6~v&TGYeTLCJ@3qR)6W_J(6TMcvdihdj+W;}gz$hmst~Rh9
z4g!GAZxd9O=GUG*ddR#^Q35arn+M~Ql8%C-$eW<{<H2<3jfy+^2XkmV!57ooJ$f)=
zGa@&Xeiq5wRpz?5`~whW0)RP%DGCT!oBz5+)x7vknlkFJIHl~5&TGq?6O7^lLx-V$
zVL5;iBVUP0b1a&79MuGgcVf@P_dLPb6jy9=>WAxrquivAkbksz*0haAzweR#p5-g+
zfbjJIas<kkS#o(3oOW3<MfG<IZ<HD^i~`Z3Ymc_}=R~LjzOTF%dDO~z-u;0<r3>Z*
za}&d4ff;B1-+w0pCCQ*6-AAhDN1{4)PHfI}S3984t+S3cN}W#D88(L+8{BAQ|NIMd
zpXf_qJh!1&6<G1#2Q+h(T?-&lto)`eYxvJS556m(D5&8&xrX-_KTT=$_+8*@G_E8V
zCb*ClZn?3ymriZ-)vJHF#eITrq6X@a;uw5qW<!e!u)&`)bWVKWKebj2cfp%Ggjk2Y
z<V{`;D!$r)mYAS39W)+Uim1!@nQE4^pvYi;0qCO)rki!3OcSq7E>zyD>SoT2I$Wcn
z5eYEf;n}O~x=ZY97^Y6}15h9HPB$Y>O0`pS{^X_3!cGOQbQw5O1joXD?TNBW)mP#i
zuz|66uzWknYA%5Ze6sy@1eAa<48BHDL**A)H~J4J+LLS24l-u|rYL{_VknnKj-$NY
zOJjnaS;mWNTfnet#K@W}zBU*;*1(|cUyBZIex5PG)%8u?Y1$?~qAL!MEvz~oApOhn
zXR9x<V~6*m{cc)CcE>ZI3`;>nEO$DfKjD#N4Efr5AY>|G{^R8V1lCS)VA}5wX*S#W
zrcQg30t;@JoY6U`Q7<1zUZmh!wX+C22-ag1m0VDfp;1sXlO3-3)4<w)b@ltc{a}j+
zEqc6<*VD39t9qCDB;v2f0-2X69L1xYT~nyH$Klh!+|}vD&pIt$T<X@&q%*#0i1uC8
zCx-sby&+;uJ@3&7nm92tdI@OoOoVq#Zu-Ne&cJ}+cUx01DsNfp2v%RI$-WEGwgQa`
zGT<6?#0J2{nf+1r(>`6U9W|}Pnzf1Q`vY$Lrv*5F?A`@5p@Nc1+#9qo9{|R%es;<U
zzpYzAncFeh8&1p(echNhU$Aw;=+oP&s*C~cQOW1&4)UO`k`#%W{UPi$L{m*hD$?%T
z*N@6g(cikUG&NAdl01eDn^H2BrDo&Z+;nMs1PEiQ(h8Pz0c)?fb2-HP6(v@bMRx?I
z>ydYG=|~(i0lSF~_)==WcdC#cN&Y#)HQp!AOJ=-G{5~=UOj0PqqoT$?lv0tw^XC}+
za&i0EpT10uh!;8Iv(yObXk)qc(P!s|r-0P!XVou%`r!i~*Z(z}6LrD>|3+W;Q;&VT
zoDw1E`TbM-8QJ4pfLz$Tv)rt?0&Uz2bOy6gGYQD{IQf$+>MGeMNm<?C@w=yMk!whU
zgtaeur9CfFN=(8)cKj@3z2*P<gocLN>g6L2mK|d^-&!95)1?v?^WGgzeBKlne?W4c
zb9x>GQSenFOs*8e+`Y$<=l%BG--p@}5RCEtAkf^z%<TPWWhnAaKaH-wT-)VYC+#1#
zHdA2bAaaED6R$>8tk%1*1+{>;fdX7f-O1HbptPgnj<H-9q9Zk7#-uvo&L5stR|Qc*
zZpKe6i=V*HKTr9c6K&OtcR9@S!(oqkEex#ZV-w=^;;Od@a2ZVl)tx}Gk@#nqQL(Fs
z+dZweYB|ot)U<E&87XJnmDI(Y^qzXQuE&QD9culkneMMVr}f!$-g^^JF9?N)*R!&A
zQH>O`FNc^%ch_fWN2)s1%mIt04IU3I5UoDC9|#4ke2cU9eg=Q~@Zm6ZqLkZ>*0bXn
znkxJw^)Hy|N$N@}y;%DOR$aCCaD+uj88Y$!U0V(+aJk84Bo7wTPjy-bEh^uR+P>an
zbrUaa=;h_136(r0mkNO0qd02=R*}2KVHj`WNR{od8N%8wEFE`F7wI)Y4Tp^O!@p-y
z%gdwVIN;NpLAzPg%E;ThcKfy;o9)D}=;TTB<c@JbLWK;U3K+qDxcy+RG1K<gBGjnu
zGPsA`)FxY+T{||#-XY;JRSj!@>dm<mBGf%<qNMzuTUA&aX3Pe%8no13yE{bj^~{=^
z8a;k=Ipa0Dp6?Rx3u%O3o-MzQ(k`5fNOorT*BCncnsb$rhW<#ts_a)ln8_G?d-W!_
zZr|2GWKd!sT{3eeEf4TyKss+NV4*m|E?;hY-i8BhQ!=~c`SbMzS#E0HMR#Yo8?GW1
zV9|!#q5EeA@7WVR!Vyb@;lqb3ugxWsuf!!r(eW?xU&V~bztPydBE`_V>*#~*ub+(N
zIi3(b%OCPWiq3D@Vw~9F${?opz)#W7?aNn^sOb(@B8p)Rnt<*i9Rd*3Wt@dM9x)yS
zUN{OUp=KWh`3-Dv1T#u;En1Hmkc_$s2*%Fg%M|tl{`xDDWQDv82f^`FJ)JwW?Sqbx
z4uKKMqurJp#gY_xvF6E5Y(6u6C6G5~PPAhcd!hvcGVDosYVf!+B~0%R!`fgX*Eu6s
z_}N^Q8HwNOd`Hsf^5A5c?WWyx?_B--wk97YOx@9O*d9K%0HjaX{aDB(j#}z}lLb+_
zAXPP$YKVV5!_KpiK~k7R+V6<T!t!u70i7mj39`yYTU5HnC>h7Y6Ucqk_u}pdaDtij
zrkp;0FXH8=PoLlvuGgKWQ>s4ZPz{b5pRi+2y+lGSSxKXR|C5Ga70sIMY~Osw%^NrH
zdKb6Jp7q*y?tEe@ISr>j>yX6&r!;mgsupC2*B8ih_;4M4?3{sqtd^eGoDcL6P^<Ww
z!C@{0NS4K=b!+ujyq}0Knr@w^d3lM~H$Q~@T#OVjgIXl}e$W~1@HqpJ8~h?G9D?6}
zU=%k2mK$-vPHI>b6Gu6vC=a77BZvePgU*1oGECIGITDK>75sex1%R5aa@j;Mt~6;w
z9<p?8lMA&1g0TbGTxE6H0s)?&(sKKbT_#9|WVv<>X$fCvwQP5d)KN8mE~_>kSN0AE
zD$=&I8U?^6>wQIktN-&uUBFAr<Rf#J|0YiJ1_KhBn0)wj_f104b>uKk*Zz)25T;=k
z(z|qkYeUj?%^X2Q2BvDen<m%v1ln%*J~xLOWkB4SLzZ#i&71JEXZO+1izhp#PYANZ
zYFd6<GLj&K;yy;42*$C7mNEL{vxEJ#wWTi;rl3U&g-60f!X___KF#@MGK44q6R*aK
z9t%q<F6i~VJe!hwu5;(w%^J0YqOU#Fr>)<VHEU8@)RC5$T$SNYd%cutk%tf4aqAGt
z#7(8kxRRHrMr2a^I?h@{xnq+);%AxMfH(T%F!_Yv!W_>SN<OCC!#Q6RmXtHLv#L6d
z%0S29@-$_bh`aNZBlZf92Ywqf?eC~MgSwXeXou6i`Y>AU3_NHA?UE5D8l^!lS+YRK
zo1l9ajjzh_?|o5>ka$gbT)~*45x)<PTDzYq2(f7sYnWX)cynA@w0`#>zB}p$0LMDk
z57)b}>;k%a@cH>$kSvHR6Pd)BW&y)fqu-M+^;Qh`Y2UW3z;AgMC)+k>wt=rQ6RcP)
z>EN#uO;)+`8<`H;PF>)->`C1QEd7kh`Fam~Pq0Kyo~O9iGdrfeo`tAX1hhEX=+feI
z`xU52svhCT&1HwkP9jk@>TvYkG0TV9pMh?d`82PpPn~P9X@&yB28+%M(W4;sQ!lOw
zX3$C(E*JxryuNW03A!M%g|t<QT^8<Jckb*pV8CwV49^$!m$CIm1GrlIQIbkiw|O)x
zqvl%||68@|>4hg&Y(sJk{}Fj~ehl}B46KN>o^;>3(Z5@NIM1Ff3o2p8FIRkeJ&Y}8
zIcnuqriUT0PA_~Eh+%e7(zb0TiEUTgP8W#~&>u@k?E>^oF&eN*u4l0W?*8sM_qp8l
zn}BDxQPu{WEG9X*JU%;s2s{S_Nq}wJNVrJdJ?juxBUf=}{>8aRrD(8$bb$?-U=+w-
zI>*?r^D4f7x12ilrl=(EA3u~|6qWJpS*XxV{K;K1!p|7R{BH7eeOzTZ2C{jInY_Nr
z$I|EXp2e@b3=u6#Vk^>dm+sxi#+LT;^_@|@Zr@;&`6jjvk%h`9#{Cm5&R9O+Qc74Z
zTI?G4oxWI0MSWg$O|EQIyB=M>t8&I=Odmaw$vex_#Fe%3idgTunT9xu$twdFxxK-I
z=eNdd`zU%daZiEXOw81Vny_oM?rHTvKxpbzt%zqpFQOTT)qqA7bEKZ%N+?kyB4+Jq
zH~h~P$&uhk+Akiiu6vrRs=?hxLH&GD<T$Qo(YMbG^YML)3Iu?EW)zLi57SN?gTr6{
zkPW0NkKf&V`~JPDWLVVJh;KOyi2|_`N3*~c6HQjSN>5bP)NU+v7KQg*UWw<bRVdoG
zDyn~!p-F<e5~Z<y(t_y6`l#jzPLt>mQG03IPCmz2SWePHhy0|4nY}{S7<hUP6>=HZ
z9SYGlxJ0ARVQG_iO~>5BgW#CQ81LlneUblWLP=MkPPl>F5>SU!rYM&wYXyU~i96RD
zgd3*xB{GBPvf38wX(;273!{R*O3O>Cu>A!T__RMkh$i(#O&fRa)R{ALQTpRSw713}
zuXATEtu|UB;hkvF<}JK6aPIT#e}21kW|mC`3&U2@c*!}RsDG^XAV-fKTepTG${^rZ
z^wiMcsWSUn^WryhFno!sqWTjSKxBhOE;cAjq^{r<Q%X#Mr&cx4p^EM-B^fm$Lr-0p
z53_!EZ8L8T;|Y^`ZA<?gG(CCwq?N~6QqW>X`PZ+J{A<Pfc&0HJS#=0lYi<QNhA_U_
z_BR(jN?ITo5JBzb>dtv_C0|NPOHX*z{Y;I^-)~V%ZRe4aAxNvHpyLR5HW#je>r}V;
zQsyyICeP7oo!8(+kK2O!2YfxeY8VZt%vX3-eh$i4T2EnmS?B_R!k8LE+-zTREvyz~
zBNmInGDO+X=OWm;0K6hLWs)pvvQyD31bGaDO6EjvB8;Kf4mTV1Z9O5ZKMJltnswTa
zsdm1S5-1(7iFSG(ngn+oFubW{6Wm{$@+OP`nI)MLw~x?|BBDNKS=H%YcJ>u?cs0pE
zp*$QLo5^c50!0cQxq1lq&g#E+eut_Eo+5VIIB&7HBh)$}$&r0b3e&oJd{6Fup6ffW
zszymkSx2_s3q01J3W8C{9io5qvZxDv4|Ztm;c=RX+#SUm;6o!H3DO1B$){Tp(1ZoZ
zdv7?K*CDE4IDe2kQ+de+!P7u9k+#Gmsp4YXU<rwgGh|jSEA2dMT`9+3hgqaLD~u=2
zzaID(fGU4MyY|3IC*zO8E_dtN^+i~EDNw-WCm+0DJvf(~d^dT;V%dLIl(cEnSY?wP
zJ{f5DcfxhKF)~vWUZS!JT~#gA3G=cJ*X9k0vrtOqmq!^3+s(IL+Pe2-(UFuqh>zgC
z4g;#;llsxt6aXkdMDn0h@|{QS<_l4GHl<sSd<=?|3MnLhlFT45IvvZqjf9;01wgE!
z7(!Hj0Ay8{JzK1zSMa9WQAi_+jB7Pb508hoBRu;HI49i@%r;MdGxK8sh*myfIW=?s
zd=pSLS?vY>9%o%x437k};RT?c1A91!!4HO~w=>TYtyr;9xS-8ZO$FkCqJ|VSAhaZi
zE`jGu2iOP=TJn)z%h@T#IP!_S!PP%o>aF-Y=37}bNdwqx7Ja8st)oI?Uk%!O`Bx6e
zF_}2A9u8JDyeu>JrS2bJPT)`vM_pt4PH!x(W~-?Y-1t+pYBfV@A@+=j%cvGd@(RZc
z^}%ii$EVDHJKtbC5^La>t#HjP?o$%fX6P^-LXO}LMS$7SHn%5u@WK+u<yi-C1l*`5
z_$0X4hPyGm{)&8^(bf|+a?k#c=oTdZ3!-phd3DomAKiJ!Ty>BX{}%OtcYBZ|SX_(t
z1kNsklJfNY`+ib693E2_QQ=M`+4)8HJ;Byy5m0Lk7%XEBa>KU(Y%XC`R(c5PXUCrD
z@m~>7ps?6`@Zi+&yF~zW4{`R9ZwbC-8-Fz>jXs;CCFc+g+BHhGt1^sEzq5}##>iO<
zq!*E#I>g}Co`S<ORqfxl+C|h=5ss9`<hnToD~j?>6l}s2qKA+*H)x2iQSx7Xd(n>9
z^zh=^<e0(MLs;13#3vW!!lmk}<Z;Wdwy8M*y*UAAnRiCQg~${^&$;>er?nPe_}m)u
zT<8WH?GfxyG$!;yxZcg*zjEc0V%6S`#}j+%Jf;V@O_x@IyiR6>^NW1kUKJJL-+Z%r
zR_W8iRTrzPcRo{itKORD;}P!u@%FGa<A(KgpX_ASwE3{!EfY4~aO!Ys)3H{gnr@5F
zn|sZEl;wgR+gs@Ec583cbXcD)rkC`8mKO~ivSq~uy%EQQwq;H%{rYK{S7iCROO9Xf
z7e;$*S20uhB~DVaRIThRkC#~jQJ`Au`P#oj#wG)=sAEW%u^tS9dTL=!hT@H|yhb_<
zY}ILO)<(yrb`EF@&Wu)CSSn@xEJC7Nb=BJEFFeL@dKk|xet4=EkMr6u6A?yh)U<4^
z>rpd8dt5wS?|bnj2019akDjiV4`4&+7%*_)>hM}5;of(jr#5C#WA#jvZ^oDOQLmyX
z225ZgaXmV2E;xoIEjYw9^}=Z9l%)+6s+hBhzrqm@e}#zrnX#+!kzBl3pf=!CMf$3F
z^c(yjaczx^oLdqKB6ol=Ie>|8TA}SMv)!nr6A7l$pP?{D;qZg#B(a+>A{eH~9z~W)
z*?5<T>6Yow@{bROW6GDdZ{HqBGz68T3^}uYQEmCZ4=nVY@8Q=Pph$ypX-6;uk|_$T
zY>w>%Yg4}mS-LMf11kxnE`S?KqC+`L$<TOy^r4ffg?Jlw+<fSy3UNY{DR3E*V_er<
z@3uR38pbHJ;=Ih*nHcItHRTH8Qu6lgKt8#c_?MOKK6E5zC_w<xN*J%c6v)D5{(L*1
zLr(HbEGov2DVK$lGKq#6j$L${4w8Hss}v7EyaK0}3}qbFlCnUC!Fbg(SdGVX{%|fS
z2+^HeNnp-SmF>JmRJN$;5xH*<4sJ&|2vrd8p%TRgy+r*IFFY41RZaB0cCK@Fb`A)1
z=`hG;J%5qzr%C5g2T98Qfd<a2{5>tCUDEfe+FFMZ8Eu#d#{3$4e$$`~7=Vg|Ixnc|
z>Ep*gl`4e>!$|E~hgxWc$h)QdmoXGtf`PQ1it1&Kk*4ZGNn2azwybZlo{+?jmsD1D
zrc=hXQcNC98!(X7L1ege8E9wrm10-=EpZ8d|Nb`g=zu|kdf%0%Y|w%SAI^o&k~#%i
znlP%Vtz7^>2JFd9Xa*R^yeH=e({NwS%L}Nnik%lw`KaSgMKoHNysC2rg~Y-;=voES
zq8bywgOc$QOH}hL$ywR=?rFeK=C{IEY8hEXsx_KZ@q1Tx9~lI;K}(fQU;Jo)^70K^
z8?|j0y>Nn&C{my~Td1o~LS5$X*F9qw%6AyNZ8-z9Q%KA*5jSY?-~d1IweV4lR|(&_
z^7NCZ9TumAd9+I8;|LsG$Z3wXOtb51_<7gv-5bE~g##3Y59ykrVg02CnDXDt<gcF1
z2aEXLQ0|n^b()=VSO~7dOMzGqG>u2IfBehd-i?{!frlMA@(@rCDeFegvuCo&5Z{}e
z7T`Z)x#2pMJ?)P929-rM{O;Lk&@W}{`==Kgj|LYJn?Zz!Gz=nEy|lt8?*k^)*+8G@
zM^AY8tCUic-wf5SiBi-GvTP+My1&hp^|kAYLmjcoY~pKNi)TQPW5B!viv_B5wTV-f
zop#Bt1E)#PjLf$O;!05^FosPNg5$&tY~-AE*A5#wvNHJY*y;%wEG$8=1gr?Ej`~O}
zFh-0x$l9;Fp!|H8oydRDy@ye1yP8&;Qvfm`H-MBNLe`0X7E_?M1_FH&R3?)8Vk<u_
zkOr_}PnUV~aA5z3sO9fxc^ot&T^wit55Qf*XonTX-;Ehran<kDu0vxRr@gI-6(HbZ
zM%Jf(w)XAR)XltGCfZKiOYpF9XYl&r^yzYx`b|;^uYShy7VkXXnH>RLooR5&Nhv1)
zC63nw^hHRoq!pB9CBz1z)CNcjjybqKUWWF1?ND}h@ci~l#w28VoI+D_AlEdDf`E;s
zt=1W4B%@uWqB5H}XHEGJ<|S)4i`+KF-d+l7#>5n7iia>mzO6~BiB|94J#=(p%jfsy
z=upCnl$<*N(?4$Blw<@CG?kcs`7ss1X|~n7s5w^hG^I2Src+8Z)t*YH+TW=TgJD9c
zLlaq_^V$o{B4!SJ&qx3bvo*&6NvW7WVWJT*ujIse%V=wM8wkG0_~s4ZO|caaae`b^
zd>r_pvG3;h9XV1RA#>uf&&Ay~BD)hU)A?mO!jzB_WrRln3i?xgTTrxEWDe-8zZ??H
z{{As-@eC6fj2=xKCjJZDXblDuxBdMr-V=lo<;<a975kEsp<ZvvPZTAxj5T`Utw(3r
z3pD4Z`J+9)s|c@chc4-Y@j&{$d$uJ*!?%O(Lp5Gy*41Rizp7pVhYt0rZy`r0WssIn
zm6tR(f;jTE6~-0^3JPY*xHX5lEggn@mV$E>cL{)t3>q0QZ3x%ZU<QD_@@{X8T72N$
z7-Wzk$J6ylxIa^K<JnJ<7pv@<Vq87R#6<9e%h&n@Q3se12|(MNF{hv$|C_orL+yM)
z0DWALY28U&Chjm2bmSu&st+{$4#w4=g@HgL@n_ET+uLYac!2}LQ3S2xbfYkiK8dl`
z4QjzDxG>|i3G@(~F`XUW3&d9C0a?{iCH%vOw`qWs6e4`B<D;*}oZzAnY6@x$QkwD?
zWu<~l+j1;rixEH(zhRZK5byc{Y!ex*tkNesfz!xb`UeIpWd5por%tzVFLI$pkvL2t
z484}PVC>?B3vYp5<?c#(!^Lb0${>X#gvN`Kl4y?_ak!6bdTy>iFs*Wye=_2JRs3!E
zQDQc$Q@*+>o(hK<*WvobEWGt3IqYoPn2d2-5h-21dUYeP6ab{sqoc(*>LQ2=2AE7#
z!o3Qi$A{W@mtB@zV7|GP;RY(3cuYabxB-6Qwj!CqIK?eT(a^$a<a7;&6uaZI#KUIt
zX2X`n#d%Q{b*X}oK6HI#QoWPH^ir!aR+g67kJRsES~oE%>3UAi9_sRdKm!Nl{6!jf
zwtoCn?E1dCGJiORSVX3=R#tlfxM$VC<t<S>p}9xB(Y56mqi7}wE>?bVkd5DotrBCx
z9oJRV2QdM|nG9T>s5u$W8C5kkS;12EF`m}B;O*PYjrAK7P!ID<ReBs7MVb*(7|0B<
zNdgG5Xo+PAn3(3x006IH-HXQVh*Hin+HA6TKy^x|wHJ^ax&iaafDeioAxG#aWg`<J
zsciHmK^M=GXGC&`JLSujc~%nZS3FxAB>#~Nd}3<vns!aK-*upNgg5N7+D^TZvos@s
zHDOqL&CKxE61}!~EtHHmQ)BxDRR&YqR+44MBrng3+MOS0?T-aL0nnMbeJL;@Jhjy)
z_}Bi8^3IuaG{-{wG)x9VVNo8xW-2Y+hP3_$ONVn^U9PCDo^L+Wbb|4{z@ZlCTCQi_
zR5*IB`)djf%w2*4Z`9;KU}M_v0-7*H8y^{aM!2z^mvZ%n&fkbXh|k{*yY?fg!^hQ<
z4vT7-no^Q*paF^b_!2jZhfmHfjVOQnKHEBrQhg~p@8{JT8^5qMf_KNY1fx{viP#K1
z7gbD%%F4@gMk~X`T*740P1IOosS4Uh)o*=3_a&)SOgF?OiB`KRGo88nwG2Vup$-*&
zYDI%%N6FU0Y`|dlAne0TiE@coFDh_WWM0k6`f%<ZYO%WJk6M4agA(cR>E5d#ETJ4k
zat8V*nl6rv_?|MJTxHPfHl?^w=5QWc{5yxfKsnMKj}CDA<_hhf3IAyUTDI(NWG`XS
z$8GlF#dpAj#4#Ie#YWHc+z$ryMDlX~eh?Fxn(D8kzmz^Rqvg*%KW9PjCLN>h^;G){
zU`fs+js&;ZfOF*cCFOWo>W%YercJgaGxB1i=PQM|cC@RbDkP&MDDl`W(R58@ItUjH
zG2N6}D{34SfHAc1yyoQ=TIB!(m#@t;1)G6@7`QNh5M#y<$ua0~C^f}RgPWlI5MgeM
zJf-B`<DDui0qYN+J=<1YU7emttQH?V>JXst{xyo`c6D0H9z+@bfx9}dEj@~H7$rch
z>8sxjW>8raGLWX6`PPI5t&P4xZeQO|L$<w-z2C^+E%Z#i*`*;gAF9*7Xi$kj#wFv6
zVhDG+v35Jj5(8I$e0gb23h3P$fI{JSg*Ze3P~Xzl5&4|7L1AOJxbbVnuu#OdSf99?
zsZBy5OHD@m?LX^dH5#4GfN<Cw9mGA3lf&<2!DvHd4N`0gtOpTWS!mCb;S^#1)2)8?
z+$dZC7+vgxaHlJa%s8;h?lta()*U$JG%tJo{jK{n4ksM2=*%BBMi<qMfD|4_dO@`<
zrO1qYf4D3m;na)NM&G{APwX?LD=>{Nu&_j)Ikyi^AW!)F^~hLHu{Ke)vct|%e_7VJ
zhool4e5sGiy1CdjF}kLtN|uQOu(ICM&bJyla-_15&MYeZ%oZ<emx*jXgw*3BF=X?%
zLMgs{WSbn|t6oX#D}a&2dImx7Y)Vm<#q7pEOY@sg#(m&ovG@a7kP%){5dsqmutKd4
zcyk4^T{Z^&(vE;(Th>!M@$bruD{xVyhDq_?WfUy-9-QJm;aRg->yk<FC^IqWXP$5C
zcTsRxMY{G11X2jEN1p1UA__8+_ci7uW%MZaiS1T3dfq-bBG1KgSVsM@$nfR2(%!X%
zvKIOdTGZ>D<EmA9DDu<_=K6+(IhD-Lrhwz6|3lj}<>H!QSjNM`=A@So0=S9fM^fB?
zuda79bzDjHMaoVioGfv3lQFjcIvxXJEINWNkb*48(^NNZP7wg0ugjdFv}_S7r%P8M
zwc*iOzpa=3U~<;IKa7oek51GFJEW&aA||FqbUf>&<Ei={OUHAJU*UT1*aW_p|L=|`
z#=ebV=MkQlDQn8Ud^v7ucaX#9!)KS#dSwLfay{S`Rn}0JfVDKbPXAgf>-@6$GO~LA
zL}!jJL6{NY?>7@((<Dj{45cn<h|s7x#3&|ZYKkXM&ClP|dL+IS2xgGs3zhjxBgf!j
zT?7P3yq$F;Je_%Ct7h(B%vYl=l+O0srP3#OCX2Nv|G))7y1jkg_mVKp22hI>v-(T3
zM=!IX2;>U{GeL&bT5L&vzICj&)C&xk!D0qFO_<tX9Lns%Bv=e|j{vJp`}I5FW~$lA
zE@IrDG6>=3Rsc;RqE%Gr_^#$enyOLb>D+%;6dFVZ5%o0BP0ZA!q{9B7EnXsGGDEY=
z`n3m+M>_#E$k4X=n~d&Vx~xYiPe!~ZRdk+_Q%x(YNH}w*mzLIqlD578qU{h?$f*aL
zv?v*>L~|>)kW^%@4(|8+7U!$Q6wK+v>!_JV<<wrjb}hnSs)uH7CRG+gai5-FsSDoZ
z?`QP_-3L?py-!4nw4f{}W?9`X+S<O<Cd?vIB@KCfCsfRg)=-J%9-CqXX5piFWzlXB
ztY-Or#!t_ARm%fX8jWLmkcnH7&qK)ENnB2uLl_o85_#SBVVryCh0UwKosirrb&EnN
z6)TrI+%g(*^{$e+1p$?%)>$YmWef;93W2c9Z!!yvp9TOE@aJ)ZNm!1j6B?w?#EZB@
z(>L?x&Dkv3l_jJ+SMbh$cb=^r`XcSoqXPuHcfnTexZJWsiz6qFw6rUM?uxQOD95UY
z+6<zdW&wq^`sZLm#M1w@r7$XD!U_N^RgW|(jIg3CA%ro?=gUu?RPsPABq?bKIB^)I
zKyQbnCj9>YB5Gp}i%3xw>E`|@PGpWvuyO#2S+vy(<2s#M8$uYz-23XiqV(^rE%TD5
zdKbQay#*Bppi%UfHur6fD5)gs!tV$x>~T<~7gGJCAOT8Kb)xUp&jxu9Bp_wS*yt!D
zqC^EGJi9n|kx#=n>h$jYl4NAosvVXZR{^0&Nmnov1~H>8-b7gCbN5?Y^oq6sK#OhH
z+u&3`F_dGswZ%kJ)7vdWFHw^-vq@Ebnb9BqAt;Z0MpBvAd)+wIJ6N&)gYm5_7W^G_
z5x6dWmp_;l0NY(Ch6Fc;01&Y&ez!|pyH=Tz)p$A{?;q2F`qILRMz;s&p61654U)BX
zKu)~&b^=^BS}I&DtCl}{j};Uw;%!<DR3uA=X|$?-Sr#2G%`B4^;_3`1Pq3jG+mO>d
z)PyvICycB#;k?ns7(#=fm<PDWFhxw_X~}uEH(KrV!Z|!0lu7jZB|u1ILWOaSk5AM`
zkfC#kBv``{^>O&n%0m#mVk9|$LZhR)I&h1XUJKv^j0ndpe5;JS=H2-D%OgoWbvgzp
zj0i|5MuJ-z#vV2<N+*75`HV8cuR&-zy}xU!op@IV)mwNOGSL0I+K~+^NJ73*S}D$a
zz;DTOXuCnfhE;6Uoke8(TKY`P8@UHfsaUA*NfAsWCmwuxJ2O)P2dxl>LhSynNBimO
zX;@TBquCMJ<W^l5D&os6oz3}V{5oi)4Oh1sIj^981v98fwa$Xwq{+<A$q6SCl3xgI
zjO!mkl8tV4a>)aO5kgF&-RO?YkgoV9xtQv+8~rK0J*i(ynGlKR9!t;uUA!%nw<2qy
zArSr+IG4ZdHc>Mqh%P{yYYdTVO#7gsg=qro>(4V4UJy_}z^`KG|8+K!!;#LNq}ita
zF=7B;?ht-Sx@uLOAu_hmH_1{ecTUdAXEnhxd^=!AQ#|6a8;Myqrq%PkW}^g#73&tH
zUPg}F97!$2!Pvxq@k7pyZP2tS@UFprFb|IFYwiqs2Y><tTJLffpeK?KCHyXYk3?$x
z|GmB^NTc~>bEu32DWJX~ouq@mNSZW%z@Z!p8ws6@j=N>&&Ud(kQX5i@iu)YO{piFd
z-_K&&FCzzh8=n76PDsF;w6}$KZJ5*(2`v+{{`}9Pmik~`+z$Vbo9$_OMq1RXeAcI6
zA(C;*Sav~hD7c!5u6dSvNvi#NP{P5d>r(V9Bm9$rk>VK&lXYYO@P?L_dk+5dtph#u
z3~Wy6>xr`!Hy;7b`SN{q!5G;6tyz?!GSR`|00TycBO=DaxzIFUr{IT;AAnOeQ@j@Q
zG^Rhw&qpaICVK1&u7|V(EP0^l^G1vic9!zgR&S0szatGqZXQ)M7@Jrf{CCfC#G7Ww
z5DjLc7;RG)YQ}K)MMKKq%BUaz4iphvT7m@lK7IOdnhz%pUh!_@^b4b7eM3L1W8lDV
z(7?bN08vNXI4T&859pa9J!*+`zUwN_FQ_p=^Rcr`bJQN;fJg!MX$-%L{-TUjXfSrH
zlrXJYPTs8g2I=u=KyR^egjNvm0S<~4xt=ym)|t@Vh65yUK$32r@Ef)6=TOktR{+*P
z`VxeY?AjeoUt_}rtC&>+_R7+Qy(pY1C8Uz$MoFXnOI(_Y*Y#14sTMaX(L$KD5^@JS
zh5GF0-bDdl#x{6~fwVbWAos6s_4Zr_ihpeSh5e*nyX4m~+~rv$Kj0#9d?(Rr7+v?u
z;%8$f%$CpGXRQqf4;s`^MMXpw{B~gZvu+c$rdv~c@(t41g3Ln(s{Mzfg3pHrV-dCM
z{_&h%+N$TnmTd9fFYqKcoEgmVL{&Vh)PcpsT~yvOa>n3275XqmA{HgX%EHMlF{28`
z3u<cMM4TrdXsJgS5KNfWALWE@kzP%NJ4S9?io1M0Y(`=OKcmRG(`lc+W1mbLm%*;N
zGk_2zHXv2`XZ2^B?KKU>T3@DAYhf#WbV&>O`POst61uD^$?3^q{Rg(opNd8Fd3?IG
z^mOAAO#>g@FULv_Q%b;^>?R6PZGb)F?{ev}8<%k>-%KWt*;9!`6&gI~QCaAH{0oM;
zy=+J$*t?H+6>kP{L4?PF_xyVi1@mo{sokgFfDsAR+}H`;n|etajDZ8kDlK1>mYR{-
z5taA5Upl302FO^YA<>slZmp*{Cv7)JpeGNSIw>AGgh*>Vjwx6>x0ixdARp@bsxL{D
zJZz+u=^L@W!R>CcsaD!H8vScmuZEXbAHXh}9#CeAiHN9G1<kl{VI)HVbp8>Rtumy^
zM?xZ2e&Rq6(kLf~zChOOi48M0fY$HMl&^VAqYBL0fnMn~;|P}FH6lpOvDyK?q!i^W
z>$adIAlP!}*}Wb9k7_Wy2~fiEq|Z$||D7_T_=&?p6I&OUB3{?Y<?rmt2hkoK!^UZ7
zX#Av}kh_Q`RM^CSZEF}4J4+hPY8EOn@6nXZEYXwSMRBIl>(J(?nP6~`%uY-<i0LXX
z#GQbVqdN;FiFhFw<1fPbH5xm1?Cyi$)aevz*p3DEbG!{?tTQoQmo)=45A0nvqx_#2
zmc+vry*BN(mSvQhjoI?$Us^h65$+}D{;o)`vfGvf33H=N?GY0IiNUF#yilV6m6tm0
zGXDpaWW%RVpDK)FJf=>a3KsXAmItNc^Tmskm%K0lP=hK7Ir#0^Wmvg(AT^FvQym;S
zK)NvH#w^_Iycin*I1yDaPay6(+8*a<{P**1Y7=CwzE1`Zr{bPJnGqV3z}`+&$@FHE
z;(Be=(ZM7~b|FJ4@ZVT?tTw9wXJU?18H=0H!I7(NGmL&dbGM)~A{bof$7Fo|CcGnP
znBCi22c{(-Ug_@n@2V8-I39?EEGQVX(?uIkX{XX0z%yHlRo(CxHiTm>D0sVl?u#U=
zMjebP8n_kZG!qmCHC=vqYwje~g%4A9TIxm(%Y1oh!zctXtdg-dPM6eH*is0g&)JYE
z&7h!kLYFv9Ql`o#ncZ$kL{`WEI(y?K?lB08X1mqeuvPfOt*a<%gPLj*uRV$uhrcP^
zh>Vw!YN>@}$W#_opu{AeYi;puv**wu^l7t8?%zQTU`pd9+qhA&*AaSEHk3}~a`rnD
z<Q5fWD%{hyZL^3p3S%vIs2kZki?WUcnTpCx+41|H?_b_E9*uxN|EVp61&wM;jB1&y
zm}1<r-wT8e^iLxPj47W-0AWZQGNv(VLLgrenwF+~YKjO#JMwhD>+}rdiI1d|UR947
zhL&Lp!azI_6-f%LqJeam00oFRy<6Bd0U?m9#F64d(v1`B8d^AmGHqo{h0hoXUkB8;
z9+Z~fmd+u}{QQ7`b%a)m!KkQ(x27d`GHqt#vV3zlG20+FKEx6r$6|B);C=hhVb;AJ
zsxPEpk;RxAYmNdN>*Pk^=y~U$XcVOr$+0C<_L#ZxV$5kM3hE=gz>t5s-V=bYCp^a;
zplg!I$P&oGTk;Lm-oLp_Xb=$xk%x71GssT9{?;d^p1aD^LZ~{IA1{XnZ~(AwDewh~
zFFG)`VN8Di&@fLBH%2WC!PQDU#GECZWx0ed7THR*hXi02k^?3j{QY_xdMCIQDZue!
zbIYqDp%Eo%zyZc%U4abkn8y*tB%Hh;hVZHprw?`*T)Vc3XU6j~HZa&YQ8ju7r%2Rj
zbkBE|{XiRaif8`n_MuF=5n0S9UdU8r*ASfoh-nWQR_!$fmt(4gapSIAnLQXW%BDPf
zb1qa;A<8&(zXar{q&rq~dFX)lQX=Ccp^;jX5B)cABS}GG+leMpksjTjDB=lrKpR1~
z%<7C!Zo?K)Xi3rZXwmu=rB^r9Rc#*=Sfu@D-MV#UXB~78|5WYO=P=K~bco`4YI|Us
zPlz$Nm*~=eSEuKE^M+_QfZT_v5+x&en<frZaH+sSwr4-?Q!O|l<GHxF5|RK!?w(yb
z3p7Qr5N?7vj042vlmwF0qpV|8K35(J4RzEToC`<FXc6#0=DSJzK*bXlJ{p2POe_Fd
z0V3gwwQAzSO%`J0LxoZdg<uOavpcS<bEc)7#a-*uqs5ov5j_*_|E3qC6BjQMOs~Cp
zFP{MB6DZRmvc&RQ79T+J0iuu12s8M(lQS-sS^y+g&d-kB0Yaqq7NtYiv46`3c&#ll
z-08;rmdLYbzja<58x|(WC^`yKWZ+o6vTg+CXp4wHnBMB=amlzSgA(oJ>aUB$>`dq@
z>QlbeQ8smLZ=rvQQxL9HvM&0&{?jkKXXfnsW8o_%t#W*qE$caCNK(ff+um%U{rTfr
zwfKSxSfWU8UK2GFXcVd8LjlnaQXS63s0=g%1xTNuS)IsiHJsLkvqR6WD1A{c`^_B6
zBe)!N2XP*)!Zc(R0SB1wQ5j*~mLOO_L&sd1CgGOQA22m-UdMpF;6+r$qe=YKKdpJ?
z;%vz3&6@gW?$DJVdk~S8j})Lx@^A_8hN%36AK|#GC8>VL6Lu&7x6CpFj*;l2-?_e?
zOJ_ct%PJ<<bY3!m2Naxvs!3QrA79@Bs`(zQR=|T<>Ode^>!ZPjc^{%qsuMSuuVOF+
zCCDc@OW8mN86`BaK08Vn6I&VHBp(I5lz!!7Rl~3T0Mk9kfL6dkx_C<i+I7kw>HRRx
zW{#}J4lX;U3BmdJ)N{m!tL{&p-n_ZJnf}jRD0X*aDR{jkbsLtaD5CZeA}^G;7raH>
z;UR%|WWr+-lX()pi|!xC@pAX>Y<D%o&hwC$am0z^ve}OxzL60_;ElQ56s}I7Q-N<9
zEF;TtKJe@^zQ#%GZrBc_s0YvyF<(<%X@JON4k9MxHJ!Y?s&)0J)20e(39D2C$@Twh
zi|)E@7Yz~;6Vq<o5Q{Etb)%@=^o1!y)=cE$uK%w^u^rH1yt4~X3TvJ0O4_=fVirh7
zXNZ8pe|)Q^2DwGVmw18pi}oK+ji@Q7G{|(_h7AiQqYAM{^8b6sj!E93G0U;$5>rJg
zDF&N*4IYe9cB$_0rv$9feF^doAZI4=uc`iD0c3V$6&h)7AWB}XLZ8>a(rFLo1gP3&
z+&(dJu=r~;Zor|4r_|$hg`ACp_ruCye@>Zql)uoLtg4y!FhQAPk^6??60H0MxC=Zo
z-z<XaT#+8*MqSo_(4g70Fn895@_a=AL0F;e(7NVPV1z9WcDrGLiJ*#Nk%ku=FkBhc
z<XvE7zBSgfR+$5)`zw`2jd_t`!-sjuD^jeKoa}*@WlG38>3%Fvf3pt}Gb8S-C<E6#
ztC`2}-@tbO&X57306)tYz(XgQIfA$QhO1si`Q)8{7)jt+IRE|QMmDprr3UE&CyOot
zj)o3D*H9(gjBz!YER#W5`VFa+UdGsrDJNOM%^c5I(9e-vfnvV<xb2cf^W@1lYSIMf
z<6xrQKo}Ng&$ba1L|n?CNA=Iw`izyT&7c2P#j)Yq$4ps>(199XU@kN_A~v}<OVTgo
zndq!&AUH{lIK>>;k9_hyyLXSF<6s__9<9bWw3DOt$ltkLIt4UX|5Zn{&x}xsi#2_U
zKY@U4Q`1*DAZexH_4n&%7$6JB5wXI!oaS{NrNE$O<fX_6FQvCE@}OYSRFBJmGwqBs
z@13=)Y1GAfn!GOSzccy=dp3X5+h^3w*|QB1#Um<lM!zJga;STV+f1DIa#tPmnu))%
zy?wq;oKRxGcBym>Qor%l@PTTfs(Kl4BG>=)%$)3OCknxTpCkwIC)(=2Hc4e<qsPt2
zP$UI={XxYoiy+z7gx7%9sX}~>!cGXKtF*tD?9s?iebc(i+=Qvhm%q9ul*@?}NBdER
zWVHUYliuTsXhquAywEzl&_T>zkh~?afwjugVsV(ONw~b!+k6V4FPNK9dS8dE;dkAE
zXh!+ljVihK^pv)UA!;!9pI0gP+On2~rY0Q?RBo;{giBshRiQGULW-9r&iX59a-^`u
zTNnbN5zU7Pl$TGn_$-hx0~rj?Z=l)$=o6=WSkX^d<<xF=LgN{xq0l>PW;(27pz<_Z
zQP<Tou%1L79gTf4>xitV>|}iyZH^47K)@H#^x3>xW@Pk=+8&oeunVpv2Tukl(TMbQ
z(6p_Ewv@U$>Oz<A<H<A_Q9cJXW#P0BECg1|LTwGhTR*ttC$A}!C!=>8V_}i4b0SYJ
zYu&oTSj!-BgO%j;Yy_mqO0zx7=*gvU!W#8`eaD(!<_%-n7N|G6_wTRDUqpOC+1M=O
zWn0{+nEIv|46!;jeEE96rse-eQx)|AbEoN={bsgWnaf6(rAy<{3`l|UTe#(F@lGWi
z6|M}a(PM7o{!rvF2Wu&J(EwDH*7z{bKsa&{pVFqY3=<Op(L^a*_RSmVbV{W5i$SoZ
zTbG$dqN_`8RJKms6gC0?p6{c3AzexMfUaiVvSy7LM}iFlntk#V^UOwMQqVDzs{u+&
zlYjWc3Bd^D-{HkkQ~WTo3RErnZ}2G;9Sq=4JNmPcg`XgU7>%GLu+huV!LVlr8wrLE
z9eOw}?iPRq(txGPly4Eb!1UpKNycU`WmO8y=X(G6Es%r^&0x>zvRR8W;(B1ur`|xb
zESC!spI3q%eh}LszuB=NQPX+V0wi1f&B%N6#_ss^bI`W`v;ge~cjL3uAF_!fl(j}p
z5ie~c>I0j&4mUMQ;ET6MqRR9g*GO_?Oh=9%6T&y{+_BSBcv~}NPDRKLoVj%J&TiZP
zhaiMUgc&!Ba<BtIP|%O3)78`<c}7tiNZ6E0Yr`6Q$Ht(-LP3V&K*$aG`RiTnRBc{w
z>j(EVE~DJMYliuR35_TZQ=dKSj806_#-D$t!T93qj378eg3<F$%~(br;QHvBlsAwL
zwSHLu;AgW=d1JA3$^dP`t$}%FksLW&Fnrw*M}T^vaPs5Mfuq?Kc5iMYP7uUS+W7+J
zond)UP0ga1mcc~=8s2p25*Ao;0mO<cfRC))D=B8<p4owYLD-IQ&vh!le56ufTdyA!
zha4ZWfx{dt)wH{LsHgeN2@L48IUgDl(uqtZ-odod{uX*=BdB9xqYeWc6uFH+&%gyF
zY`p+&?1i5aC+RNx+u#N>U+#lu78yWD$nh_UB$90uXF%GJ4uRCOS;Sg#SR<$9t{c&_
z<jtFpvgeQ`BjP|Nw7ei~TJ+wsw};!Pt**T43ZY6Z1$Xbyl}bE*i2H78>X(1pqP5zX
ziA~Di#d0|ZlLi16OtzT&WZZ&y8m)2l<A+Lr{3K=Vnvlde@To)%sh^D~Y%f27kOb-2
z8esrn-X8)6M>Mohj@a*p@>)z{@abqQ_@4Mv@k&5uPcddoS!!RTvO`vJ(Nc@BLJT#2
zmftlKak2M(0l{dl5RZ0X21SZk(#k$YieOV%626Ue7TiKRB!<ie`$(|*<%zqCBk+NX
z4{k5A7C}BqTs?WVaO4lQr#JMbPs+xARrETXiP|!`0;K;ZIvLxcPck|9T)SahWOX7L
zXBSC8BpiprI5tq|W!{jZ=K+06T0W95bPlI)ZaZbmYBYb+?174Bd_D^ldKnsv4<=em
zBu^rpefV(7JBRs{fo<y6-J}b%6izUp^O%6=ER`bWJ^{3~vhWP3B3S)Q%4ft_h&x3)
zNQoORT2)j%+7V2_lkr+~=nxAOun=Yvv{$wivd$(dX<1=GL5;0|?{rKD66a@~2(=H4
zEthqGc!zQtm0q?G=;Vog3>s{_k-80yKs(e=$TUeZzL+>1CZi>!rO18F4M&6Btn(<e
z9gSFAAR`gPD!R@>?N6SY&DoapwMw@L+k`+7lyi5$gcOZ;*xTDH()+YTH77BTS`DtJ
z?DOZfVLu%CmZ+h!nOQ+ME3p(X=oPJHPm(65bsz{+POQGSr}$4X<wN-(_8}7fu3Xu0
zXVj1FOyvQ>F(cH3_bX#rTMMF8!)MYbYv}2<=P?M1j_h+X%jMB*1-PAG&fX=E0vg&q
zYC5(jafz<@%h-ty@+B{$-{8st&=4pcz-_MTj@Jk=UbX6c!QK^&!$GVzBZXbQRx$xM
zI2j&Ym=5i&d3R%RccvTAm<jdC+d^F^sQlcyueGgOq14eLgh;omF#gq0T7pPra&!Xx
zEM9nT-kim72Xj8}BH!=-sLObMF~F#7TAi{uy=njcwRCh6d)t*TlC=|%E}p3ZV((ZI
z3<3g>`cMi;9d)ymF8HzqcTvHs3}sAYlGk4~XwwCo0~=k)gMfYE{A<acjO%4Z7&jX<
zIQEufn5t_4tELze61g^=>P%22)OKWZV|dQrRSyQWiYbd$PN(K~=D!y{P*i4IDP*Q0
zZ!h9%%PPDkTy@G?*};UEK;ja)@M3k<YKBC%Uc9)joxY026euuE-p0|)gMW}~v#{Th
zc~DT6{sRX}-~|d9WzlgNi4gKck>18&#3l%OZV-yEeZM!I!NLdwDH<pWSALChR#gPA
ztUtAjNYBAm`RLTmb|tTC2Y4gXro^HpzVKl!HR3W!tU?$-EoO8%^sSd#SeNfUSea0~
z|E@6cMacIJFS1cxdk{>F;U+2U;VU<RYGJCCfu<#6@RswCdd-<{pal>))Bg}Y+2#vw
zz3adMxsh?)V$7aoLOOBUg0{eZN$-kYIE^{&<(1gSuBRCLafX@Eza^``97C~fWmfvw
z5>O6MG3Sk%&65A53s<DqG_7hD3-i5gN+wt%uAu9RAewQi!Y!rI=l>U?hsp*k+bdk8
z$s9f8fwG2hF8U^(x2AgHRDpJ2Z20!yX!~hnex~a*$5LYJ_U)-po*a^Y{_fqMmoHUU
zE|w8>{uDVl)KXyjSXH&D{9dGRJ$dd<*Z$7N%7zw$pxEoLzuM4m$e`T1N<BKnS<D71
z(=56g7KO#dRT^$hV2ugsU*Kh&?<kH$23K`cb20pXRr(|DHn_?y#vCWYKa#&O2TAFe
zv-NdRLBUl3L&rB4#oUx4kJoC&?$}qe3ql!b3BTIPu(LGs$SM(Z{7DXl^_H16zO+}#
z;Ld7>CJIIFzVZtC*QLAz*}_K7=ZVUFr89K96W*6x^qju)dV2a6juDcpnyjXfAHzi?
zSpyJUJry7CMDh}qD_De`y$+_r6kxG&T~<}<_2}`>mybJTsSCZCG#KD=(3X0PWhw7E
zQjgJT#axB^*|o9w+E=@sIBqJGQol+S<l}0kipNomu30#NnB(-<kuKV)?%0Cs^M#dw
zBk0g~k>+LC1IKza<xTJ#%ZsTe17#@G#)9!kUZr;M`cZl#B5o5ijIs<+hVEFB<E7<&
z4;Z#%XYVLLAMx|+L2ZuON6J0;CQ@z@!H-D;3EG4j1|8?%`$gN|KxBOpjk`|Ykd*Xg
zp#B$^n5e+O*0cdy>DJBoc20BWe!aOT7dQm5Mj=B1M+g(ZU%CjT+)TAX(vioGH#75!
z?sFY_O(gAL1B_Q3X_B*buC!M4IjLB0muQ;hF+DDgIRz5~MB?Sf*Z!b9ddr>#n?N9V
z(`9xk`2^lfoZmnKN87hep)6oI+za@AU*}b7*b_!l0yG=-ZS=23Ue(3`>rWwl!4}~E
zTZ!`$t&+HffW@sUStgx3--y3uX>z>SB`a(F(+hbtl>tFP#z1U@SJ41US5Ih;oPK%*
z;CB5MzCq5I2U3Ih`-Mf(s-U}&MclvYW(y<hZ5xY4YU@=s0{Q0eu=^o@{t2gr3qb|D
zY9AwNQKg8~iti~3LkR@X3oTF>FfYikOnlCO%xR#f{2VbAN9s=@E6zV5s~+*fnv)8N
zY;>Tn$&KjN+~H7#Yk{&q^1$vE+eh~7+xHLBbDWlx<YRL02Y>|;yb2vdR*=B0q45V(
zKOmgdOD*G6!`)CXd{1BafaVDkJDo_wW*E1Xp=A*}Y^u|0-C?@jy47LkhPFV~#FEtS
z{0!Fgzb{B2Q(R(r7<B#;s}jJYW-`f7Mv57B$TQH`;k(W0M&Z@5gb#)rwy>;}@B$?u
z_mHaP_4I2@HhF$q<1m3_D*co|hqPRK_V4!vvEur#QSQxG;JMS4GO|0;2+EEBU;~AW
zj)4^J>T@RaE-nxv+GY(yzsg~Z*ovLT!n&<#Qs&!5ISM;%PeKuq91wGL;i9gVs&P{Z
zw)plmrDNoEP2}m2#nh@QTh&y~o$|uFfDS9TU?q(XWGq5OCN<%tTdrmId!@Rs{_woE
z5TR&i!YId>VO}pHd%ij!Uco5>s8*y~8&Woja|xU*XbYZ;*^!Gr|A5Dl4h6dwV0qTs
ziiNU-0kng%1O?YQl@WC;n!m(AhW+kLs|dO&&YMGr%8mzG#7X=Hac5$znL?fkE}rVg
zPYNIH_g-iAc^%|*BNB5ae--VIK5}F;)mKnp7{#nu=+u(cC$b8U(HEKJhCgOP)cSZu
z>bAT0?p+7r0!0s+UdWhr1QaFC8X~tCe6;1AJtT6J6m-$Mb1Xu(ktiX`W->o4qEAA0
z;rsVhQ}>!cdXML?DNN!Ocafkm0Z48<31>#GKsN47c?}3*T;h3WA<nA6*pkI7F4oZ3
z=9^@O6n$}<^KE1F<};NdM7S&fpyT(99?Xr*O}emVLZg2lH(L86#`&BAjrC68W>jC*
z%U5)uchT~()rG;XmAC3Z1qHYa3KDJp7kINDz@8WZsu2Ek)Q$SkN>3y%`1^G=^ahbm
z<D|}Gjt}5Z>JMa9vM>Zt2no!EoaSm2%6%Yof>~$PdCiB~$o_B>F5dbG;FECOk(yTa
z<G{4dVsHUy8LIZO_P`BOQufJ$5;|}JG`W0$UXiGKAP-gO8e}byt*uymQaBW%<4`ES
zr%%|3mvhmS#aHJuAcxN}u5814Z4?fYE{}<mS~7Gg{;}LSWVulF*MLNYrIio)bxlDL
z&sHp%+^7?{p+}Eu&_;@H0)4LB(ET(kD#;gqK3jR(<_ENn=m9}Qh)Wfndo3XbTkoUL
z<rW})k(IE#H4Yv8??Ebf3v25m9x1Qc{d|)jCl-&t#wr_Hlu-Qo(L#W8G=%|aPv0Pl
zZ%Ly-^p~>MlIU@HjLBCCH{NMr+O+&_ByHyfh>24$I#d@S6;;-hrboKi-;f>d5Cb-E
zHx^?V$>ve>UrbrdE;4B1$&*nnTHYk6oP+*L?3dDr50wh}BU)wV^qhDFVl)lI9#~!V
z^%8uU)u}m?l(V#%ayta!dJ=PzD)=8E_HoXvJ>qA_zggOZ2NgphFq4--TxeIp$u_}5
zKAXN$CnhBQ%=Q&H+Y(--7H8pZZR&6l(sQiG@(y{#vxq|sit4C4Gz>c#S$Pa0=4b?2
z(D1lpI2>OoDG!3ZD&eyOlmovY{mz}8992Su_3?A5vF-#Fnsx-35F&8O0Fi?3%lcKW
zp_#C`^UjRDo16QR5=H|pA6<<qmXiQ4eB;$~COpi^Nw_NLdR|@{6ez<uyxr@_7BCE6
ztBg)5Qt|>t<O}9W<rVh3vs6qPJGL&+3ilLXJ$mB)L0f;jtunqB@?)KppWF#yzj~&7
zRX3h=09Qtu%NCLb7@mYpEV6nQ!3Otk!-qR;m|fsJ&(#(5xZL2`d>a{Y1h5J0yS}Ec
zjQRMNMyNb5-jjvi-}VTOz(GH@3fIGHuf52x`Qi*#v|2A-4j@?aj%3o(bn;SBWK)-C
zL2j|6$Nv1<_nfOKD6C;tx8uepd@v(p2>(PM%5C<(dc#OoL`W6Es*Wrm7MT=6cPG*~
zxF^VE*_gn`A-hQ%5j^j)LBr20@7Wpy!PcNP`->2Pi#B`Jn{;Yg0das07@YT?-#4ri
z72Humu84<EoW4zMQi6pBb0@C^zf<%IIjW2BUUY&ud&63l2^>dbhun5@!t6$9M7;`<
zz<ZF}Y5A8|VB_iozQK)-Pe_=Fx*i(G{pYu(%81H199{4Xz0KU=FHt}DP3-JMY{RYR
zzG;J+aQX&%6q{3{guWd`2Me!)8&}K3**<>j&R$4a@Vxv81A7u1SejiGw8sT59nrWQ
zsN)nKV&3wN#dJJpy{a!xeatdxgNBJQt?Oq~gNPj1qe<d;{5eT`H6l|@1OHfd7s^;K
ziVevy5&@xZN%7(;5oDUyYDwwSkzh(P{~?kR`Vl6v<%yHWNcgXq!H{T375R~XmV=|x
z!`3PLhq4V>tPJT<kfksy-9VZ+Ic#8Zvh(x?Dspm#5Xm$#+UippT3o3t?NBO8G`erH
z+p($cc(nf1|MGtL@r>`))!#NL3qpo2sjK^VsM}%9jf(Z%>t;3?sJ7zey`7B*x(DuV
zd28b1!^18&YTEG3k)uu8?a{n;C_Mb;v(9T@L<al1Jum1u{p+J04r#+)uN~P;_4S8~
z)9=6aCOPlytiMjV+QskJ*xNsx29?1F%+<kC@vWQwW903|BqkD$G0-(b-Ih*zW#N3^
zrOdb__EWuO5pLLsq_TC#4)J(p(4Ey;f-M2*U)HZ5zT*93!GTpG*A53FMQ78nNt2fp
z3+V7Mi@DC>5AgdEiscBqTe{Jw@drpMYY@P=Wmv-Usi-_<d{PmhodyiSdK%!VK4v>B
zc<?qurdMTmAG%C&J@b;OQW3!DM?+@A);OPdLr7LpwkXZS`TxOk)ju0G3UkeiX@B>p
zLVmW<*mx~fUf%JX0oF21aoYc3^YFIfBnSG-fs_7M#>vq|P#9jNPATy;x((zeYo-`c
z(LtVus-Xn}amsV?$l)^1;m}|c+!8$w)Cp=4mB~CZ{-(TRJ`OWfsjMPhN%<uTPJBaT
zYy_eOp%yc&8*+AgtGbReGwXL|DC-HDF&-*jD#gPtval1yC_uJXVWo(?5axANwur$g
zJC(<Uoz$9(_pmpZ4NU)&ph0yVt9i)N;&#+BS~>5%QMQ~jv0nx{_CU|WxxPzF&C)FQ
zZBDS9YNo*}5S$e9fso<&fi0nTypA3DN1M&l%q8c`(Unh8g@xj8cs44I$0?)y03R}1
zC37;uRFJ_?psXrf8#;3JI4)d<iecTlT?e+TT5P`WTQeY&?f_QY-xTW}7{(r%p<OnL
zK;pZwK{h4x3}@$_lcvd?4YO?T*kwN}<cYk4j&3TZW1F3lqS+cEzW82T2LV%vhrE!M
z?b_X78MmfG(y^Q}-y;;+vX2+n(X&fl)FD%(F)#|Oy5xKLJfWR=p<p@I(UwLfXT#Ss
z;3Pr;>0q#YK*u~2H(ho}2;-m%_eWro<=bd{5P&I$wBM{+vB#=QOhm+3bS5~_-PbwP
zUL_wmNQ4YTjm0UUl&>PhMQ=ne*2YpVOaW^cf%L7S)4*o^;a;ifDu^?lKflGR<ZNvN
zMQxR|U<!UJq^&LzALyu|5tK92d=bM5+nT{Ic$t2)`T)=p^j`sjZ?VXdec-Yejjmot
z{hgXjYf>J8VZ!wPx<AC$HndCB&d4;DqqmT)<wW`-6pJS=Jmar=R{cE38)~M$amd2a
ze>Axmj5tOBBp&RYC!sVDT^W^pF}q+ILD`)+*lC34VGn<U6+BHGgny67y0qOv9B9|!
zaHIO+OgTt|Bwh=UK7*?(^Qp9}1!z~ru!)MH@XZ@v*dKXa#9kV};=7T}z$m3u5SWG%
zrk0q7^Uj5e?WyoLA9Bq695G&2CQ=Ew@UkcyjsPd|BkQ3u5vyD>mUOVx+N|WWUDtH8
zsy1uF0Yvq9Ay6i*R}FYT!@~Z(f4o{JQ<oNnG?Bd)NXwb0*ucp_wPYPN%=?XOnb6i!
ztv@+=c^~lO+3Yybo?`aXi~GZnr^`=oO&N6}rX!dW^(?oU?P>w`%g@424B~uA|E+Bk
zBRmIw73WreJ)V>8W^;UMFf~g&9YVJ$m$hq7d0$bQcN(?kABY)ZT%hRM4jodL5`w^4
zap#9nWMb3i{JK{&^*v=DS31v_AuNupH_FeiKB!_gaiaCm0M9lUw%1BKzRd-=7&61M
zW)ow>0G%QA!(~u(=!7cRRLZ3d@b<L*=I7ve;D{O{sWqis9ST{>g{l$y#Elmio$g7f
zRuUB!P8jL*fxf9%zdl=Rd;pho26+2Y;_cvhO2Uh=j^4<}CMziUQ^}n$E=zC{!zgS$
z{{>y4!nn18%gKXvZn7)!XqMxd&LdYD0(7IF>5e}|pFVMq8!O;3(GodPj3Na4P+nps
zJMI}khYt&9oZNfAO_U$VCuaJxR;6NkERTyRsO@|TH|k5ZBQ1x~o4OevZ_@y{87Vhi
z&XopqB{IDl8Tr~_c!xGdd|TlaA+ZEtqmPDr>8(5KH8bD>O2G%(Wu7=8b)KPx`K5Jh
zL5cg$di88Cmk$8hfR0VN7y`WA`%f@m;yxMBvEPV}#~rtH8fl#{HQpTFQDW<zX85ve
z9vq*t?O;<#L`JZ*tYsFMFirCNeM#GoD{O4Y)J3#)^qz4CYjF$yxJ<Tr(Ze9>HiA$|
zH&`6OD(zx~A%PY{>`^^VcPqt6fS<AlJ6)IrF-swhi@N|Y#8l@4W(F(4l>6=2@t3ad
zOm3q<T+Bz%fr@4TUmQVwNvK*<c5G*&R)*7cDQ68vE&^{P=!)|rxi=%I-%cJmNw9zp
z>UX@Pek;cM&BN>-yN!nU_i?awo@Uqpf{9_NoA`zJ78NIKw0x{$_#*V#7Vgz`2v#n(
zte#{ITn1gTzu%YX2zG#LXHy|^{c3~JFt2{hqc^kHTqZSv?@3#~Rc+=DoL6VaI-^$x
zU6xrzTlSP4_o7=y_2PIQd!@Z#kI@TKeqPyR9^K;f!q`1UzB`y=XxXvjL`YKQXzN>i
zOLl);n0bFpIq{Eiia^k&|9cIu2eZ~~TKDUj*Qi>U|2cwvG+=eNXK=_B&#J4^0s4@|
zyrMp49?G<2vg<XFW+*P|9R+r;wZJ%8SZ7w4?%BExpA<cT$X1vWpx{)YC=vS^7+0B<
zc-TYLAdT6sR8nz(U)XXu(-PV~5FyRn!oN3f-sSI~iUr(Oa4C|^?X`cV&{yy?b#g~Y
zu@0Z%z3OH`3?~Vvgg*)Ks20NZ47Q^aM=2qqH|R~f8~f890+3+7JT6{GwSIrZSmaD<
zaPf5)p#`lx@Z?O6z3YlAbAiBxh6M7UKV&%P23Ck^u%eP$XP!fBm&#<aWDuU`HN?>I
zy}2XIuf*W`BCh5_>{1UX3!{|W&O+2zko7|4@LX#N$^!5h(AsBtX;VEt?J37Eqml5z
zDN|d$`+eSr$Tjrde5`N1K}AhFYwRtD+lJmJUH+#9XxC0HxoJ2d3Xs?Mmq;dSG$n$V
zL|fDk*PT8+Dw+MAy38)X9gIa9_Ygc9eXt_kvICh}lBIBHj3vv%MR$?OS2;3p|NhnA
z%e5eKftYu3RAsCkr{CiIL>&b0SDro{wW6b+YWNJHQvfJ*)W@boaMHBYYp;i3GuhzM
z)y>0WHW6>c+VB1#o3B@2pe`z-If0=c4U|#=DQvSV;hQh^dIUNOGG#<7J)C;Lhrz9n
z(uoMZ$Vs7yo|ki^5ifA2B%F$KeJ1ks3Mfv5o)Xh&*`)`hB}Tq!y0`WXsLRp_s)a2`
zAZ8Aee9|@7My!k2#){TsPo3;F;zA?&oC|%OeVT~()>T)o(6&2%Y|pk=mR4PR)XR-t
zSp_31=Hhze;^(kd%+vF1&VY|;be0GZ7^KO1%+w0yEwk{(zZi6by7PYeRKPvBOdPYL
zm5<7@z>tvJNR>EY>5vk1sTgT#r-hY1r_dK0H8A?R)l*-nQ>#$`D~DQ7lH|c9W09L7
zw><vTscXOpOqPNZOVw5O=@X-rlV(lN+-%+e@n%<g@=-6l-|3tdZxWsZXF}m3mSGkT
z_w$aow;iyNGb<*#0dWo;rKC!jJ%PD@sa4qFz8NV4@#I$JLGl=Q*~}{&>r=hw(1RoY
zQ=3?^4$)G(QEP@Gg^~i9o5{?<RgOce8}gGxdrJpc#-^Gco8&QXKL3^$nP-glIsXSR
zHFV%L>_$097|Coz-IAYQq5tRVa?KH|znC?!SSIH(?dyEsx9Pm>fT}OCn|JTFh;Ki@
z3m?c@GGO*=y2zy)l@!0WFLg3An~I-MUc`QL4t&Zfj)<(xL|iJam?RV+p*FEgJ5?;>
zhfqUH@gsG~FAH7#5D$9{Dr*`tYOUx{pgSUv9=2`Qj(sSVJE=jKv}#Y2j?i%yj{^)&
z@j|j*S$o9MQtcKQIf?Lr>cNQ+4bd6n@vfi;Xu6fv-I*2Zu+!g3Pjkt-iweMys0n$(
z@W>koX@E*&Cr{pIFyWaa+&7bM*Lk@VNjV6<VYH&h2htJVz2xOZpL>lzZ*`+fO*M2I
zrdhag@d$^k*O`*ggE~TpZgHt#I3{36kiG{_B%ACLtrHHax{CCc=?w&-xNm8aba5g$
z%y;`uUH_5utxh)j9P{{@M#@=Hj3Bm1eA#bw*f^?$Z!}6AJ8`*$%`0HmnyeV$cXWs}
zSYQBPi6qSgAZvO~W1y)3KaG#Y0L9WGajdQ4><3Hn1`r^j`UZuP3|iqeg>iWRCAyBf
z9S6m{11TM*3LrKvVXz4;EXBMSu!DPQJDfQSP^WqC&@#qsw)*;hzw-zrZvzTKV341*
zw}K#21$^St7?=io@uNse-u!k}Mr;SdrkL{%DJ1K@1Yi_H0Pl6be94x5#U@D#5lNG%
z2QL86okTWI|9uwPfcDAa#`zy#HZ+;pGHo{_vLEjBNGf=ao};D$94m3Xy@JX_Jo71J
zk9cffv-;bIu4W-4#3GHyTM)--N;~Ov%>^|xVXlx6&ev4SY`(WbHXYJW($I&4G69Z>
z+b?O|-%sOd0XdngCw>^rd7zhg!Gn`e&SV~5f9>c7L^9>;JhzWf8ERa0(x<fO+SAUU
z36Q@kQyG%&IgbV^hLapix_n;@PAeOV#lM^v)RZubuH9;UBb!M2C^6W6ez`XF#Y7SV
z_5P%=In3An0Vd>35iC5Y_p09yE)rdflrf|*3i9SihLOM2GrwUp!^vsMyY}U80!o#e
z&4-iE4ILbkCvOj~rU(?h4-xIRsmvh%acz7+qCWntaNnURTxp$Mbu287;CB976D|}t
zVNaI9(Ya`<Pl`jB!Y+5Il_}?DB2|SRnQ&dv%86kH8dBNz%11{<Siq9{FiWLEjv-u}
z@M_#Wj71dbLP88Opj1ObGX&0B+wl>WSae6CwW2$+zIahQrwVxmY3KhRQD*{{bN;sd
z#%Pc&6lRD-v>@vsOG=><b+-`;F?Njz*&-sLXptpL%bm)SkY%ValFAen#+EfLmQ<)L
z^?t6*|9zh0c#r3K2X)`S-}ieh=XqY|HTo<OQ&a}YmrkIqf%DKofwE@J8t$O5BdirN
ziit_cM|>eZLaffcL3Igted|evUJFPO*=K>cVytqyU&E4!fK5OB{0l~$HZ=Wtc7x2~
z70Q17`aQ$wC%byhEEAJBr<M=TIob{FRxlo%g8pSilAiiVrdjFE2)dR(7*On5rfYwJ
zvr*Ak*Njr9n(fR-20^<nBLJ}bOdT`PP&YVQ!C}10Yz=?*C-5S@gD76;f*p+a*R-bk
z<v5D}kT6c*+7g9;0+_xe=!uq{TM9Gs<CfkYis%Q1>REZYoAyE+sSXjz*(MNM`DrkU
zOAQJL8b4+r`tw>Tf?w6n#<o9<6aIp$NyCebcq3YKBo?X>4#|v6Wbm_x@#RDtu=t?{
z%UaBao#Q!^N2P*f);QiaP`@GS=?lVwkr-BW$K=5wH{oqWanoi0F<oz3wM$*yvu7#;
zHd|>p)93N~478%JaO7nVl06K=e`$Hl{N+VX6F1JIlGB_R>;wH*Qd(-Kw9@3yD}pgr
zpcyTtvLPJ{3(GxJoSZgH86CfqNk%duCg-xIn}U81<=&rl-@Lhgp@F?z|Ad9*&jDkv
zQp(HB=x@ITpuyq8<!bfuV5b-}*m+Ck9PBJEDH+dh0>~Bvw@Zl6WHSmM6&D00Pty@8
z5F&*JaYw_`RPoRnSnmOAEbAR*1_(kX4_!XB{dDy<%^gt8d0yIv(UWXsdH*!c?O8_h
z*|V~J1gd9>aeafV{&KYRWWv763T=&K*`$c781c|-xKD=tFIQV^t$u&CG++B@Q}d;N
zELt?Jx3NEIUZYc|PD*zPcV?S3w>Pr0Dbe0fyNk|nxx0qNSg-@WnBak!8-s?TLDst$
z-Q(#vz90z#a}Sw^0IL_)4KC5}-t_Q*VEQ*P$cA5xb4@XZjC;n(6x|{;2{Uj(925#W
zg>eFp%kHgI@Q4Ii3}~zUX626={R;B_vgg<Q8V%bLD^w0UKY#Qp{Y6?tL@S?0+C6$S
z12E(QsstKfLGX9r!h~k2(Ri0XxegTbuNX~;7~vgEkq8@`+Q{TR-XemCfWjDkaBr|;
znitHyW#_<n_I;wZcfodsn~foFFfT8OobkIy;Vo7(7kZyq_jR;$hqrIlwBytl2qyY+
zxPM{lx&sgp@E!>W1$d0}`t3aVdqGU2JH$BaYFoS6Ttf^YbEw;8g&VcpRrJ<$Pr5h;
zk+o#IwpFO!RlW)HAb(J5$Pha>$WSY3@>lBU5A-BZ?L228lgU-c4PR0ch!P(GsUl^y
zmoi#TLHd3KvE&`YUHz+uiOd9D4<~l_$<5yCZQ69}u=6LF)pAGe{eLrdDy%NUKcJOk
zDY)_2JfhaFeIRAYGOT_P@=9M+^Wpgj@5-1ffzB5_=ZM2Tvp=JmRo(a>KAr!=EGCnT
z4!(AeAr4OEnD@)$IavK<+%~9dF6{Nw`AEh~@>FL}KA@MwILO5xX4Aj{{rH4q#*N#G
z=1Rs{`3}ELAn96%>TLuy&a<n0$3J(7vo$U47_}ErMr`t_k$IdG8CRmxH@x>`W1%Ce
z3jwM5R^m74^~MRkxxl?Ls7?JfVE?pkM(zE6M<a}6K-O^~BC!UUE-WmBo3Wp`;uY`B
zUniaZl<-Kw=%W3GcKi%OZ(UfxP#FEw_ICQ}-x)BSpQ>j56PX<PUl$D>e+e{`XZ)O!
z#K3CGPy?sqVkY$fLo2=j_=Kqc8VxTb*@|F}Sq0S<4X%1kZ3Z#!Lrv}d`RzVVof8f%
z_@EfATSDt2L->5K;*0HOtu}7lc*Dmc^>oy}ZAgVE-t@JUS7ap$N5DRHt@nSSZ`1tc
z8%w}$21l*Y`&KpW)y_y;D^v$d>|Sy=gc~Lw;)ph>blw7)J&@@W27qLnm0(O1$YRM%
zM|1t}zsHpNrwi1-Y`Yo!*-hpbLZ)hfRd0sW5WDHJG6O9~d0C0i33Uq=7%<mnbjsZ!
z(e)sZF9dit@-wx!L(BStO2BsOt6L0KjT#33_kkP)rAh5_M=IgB|3(HUH_u0MbYX4n
z0Nxamk^q_~cFLTnWC2-;Sdb8PhW`0%L)QHUxANN#0u7S+c30b$>mx`8D05abCnDC+
z(~A)%i!1F88JBf6Y1O)`@1`+7`DvQj0NzG3QaEA4jyyXxu~7j^mo`Q%f<lF8E{!Xl
ztu8>M9xI=80NF85;8ASCXh)pkYR435v3C<Op;b_qk^TDj$8%+ecz5xSpA{Ep@cL`t
zp2-ajoU({IF0DX+&{4hR%zs@xXm&6nA|{0Oy-g!~(imHyg=xP0)(Ba%i7IO*jWftV
z(&!-NNwBF^pWprpk%*!t0y<c>Mp#`k8a8yOtjJki{eCA?mb?Iw=q&nvZ3ecx-2chA
zK!AV?1BVp!*tek|Qfoin87Bz&2%oxXMQ>ymnc2K3n0Vw&eSq>9rBw%!1Uvr{_DJdm
zgh61YBIEW*vCYbDz5jQ=Us|deoKP=|WM2<f4Bc~|th_7S0kcL874nbEIx)Jrd47KW
z;Mgn0T+}>M2aN=}4g979Q2^0KF%|g}7Sq4>s&6G?Yyuergfa!e#!ucWJK7{_bEcP)
zUNB3GT<);5dY0Wh02Z+MKn*_$YrkF3%xuPtU!&5oHBnsPS##!C;9py?<krfWO<T7f
zXKgLJf|SvEIRpR@yRgI86Ko?JK~;*60TQ!@ajfAR6O~FoDn%d^e&HP`Oe)Wq%9sD;
zC43A{Rwg$Ta)a)2A`wXzGk7U(m%@q>SQ1BWmDRbT36}vBgm9hiKTPWy5uv7|R4>aw
z#^T<b)%8P13w%-#AM!(77Wq78w1ds~CU$m{0X(D#LzNF~AqsX_+E+cwhpV+{5rb&(
z8zTVXECP1^D`hAx8YVMl&dx(tj)>7?zvkmri|tBC@iBTbJ$_r8W=KF8llpIGMgvhs
z{|$?J6HfK^5mQKN&60`&8?>3UuaONvo?Qe3YuFx8@@n4v!hrcRDl}0+Z2Y+iM=xrH
zMK<u~b9i!@p~RO1LC{3R)LHiuvCqMbPqx_5%fv65F6XJK&1c}{Xqp95h_EX}f7f4)
z>OCk6*4BTo1`z9HVv<&WdD7&L*Kb&Dj8h**i#}+@^>3V6(4}L8ibY**zA>bc-QbFn
zJKcw6_EdWe*oThI9oe$rvt(Ebwy;2@69%#}x1N*Jiq={n?%|1thOcZz{6+ts$%V#f
zaZldT!8y=@wZIWFQcOH~Nw0wYRw#gqwVkY_h`h=z@QaLmzHrj1_+Ypm5J&BP{XU$S
z?iO%>p%r{aP<i)YhL#wm#R!Ybj0`>Jlbso>e@4`dVE2`j5^$uAhP#^TxuuQ}Gkw4c
z5UTc+QcO_CpZ;{z=D=90V+@^ndKv<k+@7sz;BW*Skgi3>{B;4BaT+<_-oKIPvw0+y
zXhqw!Z~r;#-TL)2W~eNF)ZSdttsp42z5gHVh+^y6z5#lYrOdjiMlBF7Db&Ex3Rq+e
zO_g{SpqszO*Ax_ylOJm2=1Qbz7ojHiPc-$=A~L804nc5kBtMY<J(f~p7*2nV2@ZBc
zlU}c?eASFW>>G&T8K1zzK&FAvjdW+q6;;w51fM&-M@rzlevBk2OFW-GO|uP@Ui$;x
zI{V13a+=hN_LhxSGk5!A!2*{f1b!J@B)$Xd$g(-~gJ_u*&oUg9R6o-4Qgn<%DKK>X
zw+mMH*gZa%!cSBp;Hh!5ZGIfKArOa@j=3ml=t_U*u;~GgEUub-SB(2*95W;&-!Mew
z+qWxMe>yw(ON*20-fT0yg@D|`#btk<okJN7`iQkPyGV8aVczK*#@2gBTB=6v|2WP3
zP9<haq6DS^m(8B&obeh~P^YEm=C-Dtrue!>jaE~YYvT6T3lG3(>6c)jQPk*7|Ld&p
z{K2A#A-o9N4H!58+h(Gk46y)Hh-Q>am0d1hD5@iUq_pcq><(EKV}rWv1S%GhJhg<M
z=dCDN&(7)BS6^pJE2O3ztx;F{5d*4pl!jzO6)08vDZA&)lu>F(!1RX?f5U$S!agq8
zi@I|XrMSp7C>RW;*h{K53&BDGXU`izR{uRftm390>Xbr<#QM`Q)WnimA-Pl@UurTp
z=jJN!ZmzR2v1YJ<Rv7nnE5WNFu5q?L{-e~@_*tQy&=ab;VN!0(ZEZ3hCXt&MBeg{o
z!B(>kTemh5`qFs+Lq_pl|J~Xoh9dxd(sO0Rx9x6!(}-0OMh4QR@{eNrr-g)80zUME
z^o0;E#Rvi@OeAtVsCIPvJSA##N8?x?p~whGmYkHIHlQvR^f*6u=e5j$Eu3M&8^vA#
z?NMl8)mZx1w~sHj0}4PCi}Js46F>uU34?;bL)`5n6rdDb7(%+t%jgrpX1`S*OLlAc
zrye<F?4ODa%6cI*MaIGkFX_c;ADRyyvtAlSBF-6%6~yu5=;8HQpm~)k?+L8}iBL~D
zm|8WQ;D3r4L?A*3e0y4HVSyU(5Q>dB+&rX=hxr#bHkEJRO`SU|THIV`&K<|l&-Y!=
zn|v(a5%uAfhAmyML4<iSWQzZ$O`G!iO9Zx?Fn(j){@XFdI-x7EVc-&EQpboZ6zCbH
zxxSY5Vo-Svi2%PZW-dvG|4!7grKJpiU(L(thm)!RPP_t<S?VRNzO?S^?_xGZJ`&3p
zBFaG4Z!jbyo(4cDvD7eD85(99_ULU<5$K*DI+9ohye>jzzYxuq;Ih<Yf8r!Vz6;~o
zlPG&IyDlRZOv5ejT+ziUysy~Hs4c#=HmAQ203G?Kqw(^2yX%J;jR%5OQD}bwWwn=X
zw<NI{E#DR5mZ0UVmLVQBPq7_rB31axmAzmx`B-vsxrcia2lL2pfy#;dB+Rvgo#MyS
zAB;*@_$F>YNa-sqr8l9kT-jG$b>4&1x<pLj-l=(C7B`vx*XWC$3As~3HI?6!@4svP
zeR#A%e7?mxtGLNYIz-BDJ$sHV)iZz<zC|>0+do#~a#Ooq|K<5eHJo#0Qzn>BGqM%t
zf_zR^n?(C)#)aY?&TtFB!)anRnieEttBckH+RUamkTnJ(U)bf4GUty!FnIH);3Fm8
z;7$Q_Z~<hhUG{Af8%p<@H8n+rAr`p8ovAP*LBnAXkx&9l7Ynp!m2oqK>n^?mN_YRY
z@HDdd+V5e}jhi={qPhVKb@;vQR4og0b6ddNi+>iYg6^mUXwGegmk@PDJKA!w%3ASc
z_a)X#161O=z#0C%GgN`wn{`Y^GN0TJUR6`~N1B@^?KuJIN1C%Jgs9iIi)xI;;F`n?
zYNK5+cl|kZH2coIGqOAU-xIcB{f889iN`Ey5eFx1Dj_Md+%%fg_yf&0?;m-`apryp
z?F7qQ3q8SG89IqTmw5_)k7^Ro?_6F|!B`#<B{1#wRuYT2&`|V&xFkMa2_lNGQ%eS4
zWTDk)mrt6=m!OxB4#`S1>gv-Z6O{5lurep(B(-h<BfN7z5Agc3`ljlXvRpbup*S=&
z9O5$GA;S@UGxaPI&_vsy=?(xbprq`k(NPjnLfP+j=lwxWRWGc^fU(7=mlu-3t<ub{
zIw`))^cN-U72@52(WX?p(5&&cf94}5m&N^%NQ7duf=Fj?`I7hh`|^XRw-jtyt#%c+
zN3gZ9qm#a3^Bbj>A8({v9iq0(r-bl>@7Q0r1CO5k?_rW^iKg}&m&Y_HwQGz(8TTU|
zb?O!K)ZExVpqg>Tf#NAc;ZCd(M0oAz2Xloy1WA<jejLE656{Q&z0$!?<DE`CG^`fm
zaB5KTE1^D+r9-N1j~(VwVm)C2<|sQvsIX=rou}q*12Y6>HYbZ&+E{h7Z?fqki31V-
z*M3wpMeWaY1^6I_%Qo(Z8T_I!@GJJsf0>xE_Q}gbCO$cQ3yLaZBKE4HvM*HJ;(two
z!mI$ThTh8A_lN}|T7mVQ3!O1y{kO@w`#e+oB3wb3Cz8q30XIg1^YVZ}NdBf;as8_g
zZ6u`duCOo*sw9{Wch0NPiQVB}FTWd>Wzn=Ok<TIxGZeh$m!vcnWylbmAi}&ZweK}n
zEV<lOQCW{|jUPoeJyO7HQeryS7S2kf#lRDQJ5Gc0rBoP1e)<Cl7`1ELl`E^O-=CBi
zi=g6_$6$$8{v$x#V*sDfvKneB$FqfIbz()O5e^KI7Taw?^&)exZ~Ja(ZEbI7{K>Z9
z^ZmMoJ|$@bt{te}S9s3Zi$L<Y`SkOPA7KdN@!p-$ki9%Jk>^o0c(0zge?o|wIjgQ@
zuZr-)4O5Qh{iE)vMo};PHqdx#$f50eBc!YV14BWEV8;slF^KU~?$-^fZJOiR;H2WZ
z6M;ON6IoZh?hM<VmMxP(GC@3H!8&-le3JT3W^Lg*fbX%<ljRXel*RLiBjacs#Rd>N
zuB;RvXrgF_E0mAO9P*y|$20j?(xk}d!s^eE`uT9baugu1Wj!$dN8WEHzdb+lJrJYp
zKcL9%2eZ#lzzjuKW)D<=c~}Bbf!z8ug$GX|ojOhgKg<}(q!vk7R&3y)H4hZi2Yxtp
zK#@EhlvJ|Ym#=bWRmF?Pk37}hz$A<Z*TfL_rq<mQ>}ycGi}-}B<PLHJp&{FTFta*P
z{8gp=duPAZ0;GY#26SG-lOaHhT!`HW$HxDnM3`f}vBXD=IE{^6N;|5EL#b>!LYD;Z
zg2{cEp~XjweFU)2-T%n{pB8|k-JMq{2vP0z^6gk$NCFp~9){PdyA%!e-ZIg&aEs3X
z@`2BW1=`cQ>Eap@Qr^gJ!<8#pYb(;12zLjm;kaw!I*sJ-$v$hIba{5*^S;W{&g^Hg
zp-fPTqm!m}Q4t9s$i~2RUzQ8TwYgcl!tdJ?X42A;qw@WqT2S{sPV?!C0R0Cb71eQf
zz?g1>Y^f{BZUSJ^Qb45aV3FtY^sH!DOL{ws1w3{3(s?oHReAX3tLOC{wqlsM8$29y
z#c4OU-OT{hg0X5zppStw5j2;}D)j|`Jo2D3-y+ny6>MSu7Ga?#_mOlHzyq>2fu9bo
zD=!`I8WoJcJCb{aNhN@Zu8^|BwKSsE!(+{3L^}c=5t)TAlb%d4Og2{0(QTvZ#J)6h
zdO6LpHj|5xpkj0*qEL~K5izE)ErQ=B;?vr!P?^$zAEONUg|j8$a+ycf=g+YOMoK1C
zDs}qI2PtcYsGw$?MZbQ<q*F0OFE$E?sba)_V8qiVtICV@3bvy?lJYxdI}3cfFon_!
zQy#I6;mMoj9@#89WC}0P$=2w)3<ju1sc>WGP>6$TXb|NPJ;EO<jGYd#+~iMoIYJT(
z1%frr`r^UB)>aH7?i(~;kyPvR!<B9wGgV8gUfVF3gd($t77P^9Fup{1qSwi38!rrH
z8A#7XPg4)_6{YJtrZ?w~vqYhHUTZdZJe-@A?HYyvfREGYnH2ndMCNPG$l}iPOKb=m
zwYZYHKFl_h+~kdnfdUbm&Qt~;8I;-cHKhUQ(`zx{%(SL0+mWF`WBhmSOh;^lk>>cT
z)4Q;BO<erw#K-xmX^OKOlN`@Gbq!(Ihq&<Xg{9p=Up>>GF66YdWvCpSRVo*s`Z`8-
z44!tH3leY^NWZSQn8wozS(}QqlMI|Q4(f?2j@10Ys(3(?CQTsA`uFR%>Rl2waAC~_
z+CrAXe9daMnS%B-GctnXz{fHX)TFL7M@6(yu<V#Ov7pPB4p!wuO@+IR3sWXM9iG44
zb*;@{NK9_s#rhN|iO1JY)1%<|^j$Ic0^*#@rv;DqJoCC}RQcD=eqYFkEu{eFXwZ0Q
ze5oLi=WxbF7)P?Zk)3_)_CSquP!KA;d-v9usQ3uAq~5NbeN3z`zI>9CF|*o%%$*^6
z3C!GiJ*_^I&|F*r-wI@mg1!#c;b;Ec<^117^h1<ptHVB?wuY_L&o3PJpPO_5P<DCa
zusdhVcP5~s0PkxpgHMDuV#_O(k$142fwth3eEWX&ips;YKP_Io1_5_2bRYBBk;o$q
ztfnrPs`~ODx3WjsyM8`XCj(&U6=uSq!TOVqSOfPxx!R~N=X--sst+KJ{ZN~_ny+7Z
zeqCXzBK@K2ymNIotE=s9WY=ww_`FJP12~f>PPKRkfM4kzzmq^ZfV@hP{p&E#9$eBj
z?_$jZBVODl?_hv5wfFA}3e)+iOgA;hRO}TLJK?!f+9E1ubbpD<M|9hKGmP0OtPL)5
zlZTu9o|rC<nB$m0gUbSl+Tc87&$8bmxo-?EW?P@P**CzCtCCi+R3ud+M`}%f68`i>
zvBp2ZZa=Y0-tg$9Cp?dMm*g_T^JyNj_wVHAubF>*DMZKvjIkwO0nHsjE{)IItHL@r
zw_-UI1-0)MS9?ENrm=qv)~29?T+V&QUI{wCGVAmpb=`2l6{>nEG7W>HPf>^3LJiQX
zDVK-pWH6|R<q>u5GM~BaHNoh6F^x%i&BEAhLfziM3!QfB&tBJ#`2;E*@s$)hQdk0-
z(%c{qMmQnyW>7v?R&NswDy+)*z`lL859eEynL*#MMMLTSYHH4fSzh()HDWj#%p{tV
z)Enj~^%bBs4vLcGxvhs9o8?TcK*c~F`kNyMM=I*$+EHWeoalEe_xCsYI>Gxv?iV9q
z+hUNGVhJFGLqSilvw62O=+1I*WhkMI45Wf!#V(Ji7P6BKu7eKf_W<7n`_$L!{&Z0M
z5z<~r18az!BS05A-R$SbDQm(hr%y4Ni6PQW5E!1nz40CwfxbiyL0KkxEmGEPL}BMg
z^*uWDBft=&=Hmj!xT$yQl+D`}`vACQ*(yod*%VYk8QrW~z;1BUrHt_qGGsKBKP^H!
z!-&J1u=@1`m5s&mWK)25ZrZCAA4V`(k1l+5>3WpTksL4B)EZ^(5d6;0N56j4C48CU
z4M&A4aX|IC2%EAYJNp>WOMS?_S<C%TTRzpwDr?Q$tT(Se@wfh)cS9F}V^YqDk<iue
zhP^)jXse!!h#Xg}cumss7@28r+qrXR42=2%=pJEmp+(1jqjz`q>xQfef^p}=Q%+$K
zI^UsQbey%-Y$3<bc{~+mTgTxmdP8<+u;QVCntXQxI!9<FW>K%=rAy*W%iruv5hnI|
z%o~WpaOwt20CoR*qhjAwgzm{k;|uQIz3V@}#V|jYvbyhj<GJtR+(X7{SWFh7^O8@A
zm5MmAtvwO4OJ#1(l^wqt`K+gw7v~a6Cx*z6{rmKsh2_k*iA7#U$F!^W@r}gs2c}H~
zj?iM%jr$&#4o?q*Gb1b02ZwV%cs82*PCAdLUh=HIb$3e6`l)vNCsw5ndak37PRUs$
z<NKSpXdwVP#S>-&c0|tO%X=h0hv6Zwu+dPge&*8Kd#`p!1pW`Sp3qJ)%S!6ms{R7`
z5bjS~FgDnU{t5Q6BSpM!Cug&!VXFbFKmlnnMX?OO^xg#53Y4k8Aa_|Eza6*5E<6S$
z@H9>f?1deT->U1Ea;|U%ejkuwleI7MFXY(qf<briY1j#xz<14jqR#M<u7QCXfdQKK
zd)9CKDv!0($Ze9=&|I%7UCJT*Y1N$kud?HU_bVpXbdkZAGS@LG4ym#4(VTbF2R?Z8
zDDBfi9Cx!=t~v~)5s)nF`{jgjny-t7sr@6$OChT%i811I?42RXN&I}VAe9%%+cVsw
z)GpHS4{&yb4n)Z+f*62CfFKvrD*=|WZUXHP+b`_4w{xNyyh>`T`~KA(<6_Qr)nl7j
z-jwXdAu>E?oi>bi^P%DaS>d@c?yr@T^6uVUx3I$quU%E0>qhPz^Ua4#F9JyJTqQMr
zmg=7RVniu?N66@{Yfqe6*dbK^=lb=Xj^U+<-3iTIG>NzK$kh(-d^}z`%R!oB)Z8I0
zH+0{=ZLGG2U7QI`C*##jU{EBQNpyx+XBhmS;V0tfQ@8Md?Tp9Dvd8Doo@plz^E0<s
zGhdc7{n+ZXY0Vmj53+Wz>}nPl|MBB;I_HLU7bVd_Oa>{o_cgLGMK3MdFJho{ASB|t
zgEy984()m)t6m!D3WDDmz=*mpZ;ZgtA0)Xqf%&Wa#jR;Y4xqAsP*5*6=g|+PeWZhK
z31aD)SlL9+F+oF=+nADJ-X|&&d|b!SD+t2DS%jh;nVT5Im}GfGE!fNz6Rmi+kIWgs
zd0SDL{UnjWZEb}r0E!AgeWl2F-@auc)*XH9Gawh1Sk@+IFdB8QQ`e)c7eI_Tg&9a5
zP<9{lhm^D!i(l00<2m*crg*YbqEWp@ro0`-Rc7EA!r!NHb?5OikdnGGHX_j?$7Gq>
zXi^X3UA-8zt6q2(l|SEE)I*?zvV9f1RR-i_@r?>-#Km4wV9vNy6blW~drIYr>dfqA
zYoAox#~r4q6T{cEw6rKnVX6UL9utxQAsBgWn*Z3VBWJ(6`ubE;THq`#lgXjUj1Y09
z`cv$4A+DiuxWc^-4gBN;6;02x6_7xhHnAch&sTl?SBPJb>w!e-^~kDyTMAI~K~87>
z-MjyM|Ef4>xp7{h%)bJ?o?G-l94w>(lOl=PEJ};RiC!z-eVKdtTl4$3UMDD&YOwR<
zoi6l_n9uD>bk}sWnD6t>%e(IT#mjF87R@m+EPm{O=mwyKyU&*6MY0PN09)`-sw@4^
z-CsXHoOYu6-J_$+cT_W^JQ4vB#<!R9>;hWaT-;lf-YTkW{rka3JF;EX{CUXJRI|89
zo-1a^6xRf?^)rckR^t@S(Qru|rO6WgB%M=Xt@&r*v?;XPRLU|Ss2X~<1o7{0yvCRO
zOIc$>M3A0{aT0W*oAs^%wB7)^yntQlk~SsV(~l6jE;?T=gIP;kzYb`AJ4zOg8KBfw
zv{sPW<2k2j<^rN}i>d6{iraMqvMEv2vtcEZM~Fc58i)jHoezwV+5tXec)9QEWV#%P
z`<rx5Or&)HZp*lTzxu?>eNR7MKuZ-2tV3U1%WyAVT|FDzSUmub|Aq7>VXIzYK$Y(*
z)<!DiEpuiS01Slb14TPS3uoXE_n~kf0HbF{I$MvobKjPt3?q43P<vA1&ql2%+_|XK
z#RLl{0l|kz1!5=<ABy)>^9=yIVggErgl?bv{x`HZ9w`7h?Vi?j4hatS9M|G&P0ei<
z3eEcNlGu!-EeHs&`{Kb7p}5owyIVrdPg(%rY3GpOV3{-`;WNzzcRyxRNhgYmIE#&X
zqah<j`7baQi3;f?hTT~@Pvhgvx3!h}pYrE6r8If{(9x&QA!lab977qf0bD1Ki)}XE
z5Q1tbwEoYx{jXWs=>K)Iw0F;RH4i5qIHyHW7b3aGlQg|n6n2%57gu_{f3oS>j8$Vs
zcBkN5^ypm6apT6(;ZmS3NDZ8#QMCL<Z?&%r>yu4pv+?9`LzDOrF7eRk1lgTKiO*)$
zxqz8cz!M1%fG6Qc(+~K65`kq-Wy^XE{~I{j(}C<s+eDJt$}CcYMY>f|H!bt+hZ>3t
zPmoP7W!U#bXG~eT%7W!KM*Y~ucEu#u@(B+zi8}IeagP8a{#0zRLF(wIGXzQ>zn~kI
zE%ZC;_~}SRJap--_gfaZvbQgk0hd!K#R0KgMq6$_$J_@Ll4JuOv}`*f7+C#vU#*)b
zKBu(J|2#IkO*2N2kv&GV?zvBPG25hAQk}~$eZBtG+LILb7dv%T?FOrgBvC^5rI11h
z34nFkvyREn@nHAI%+XSj0lQQku4eVtD@sWun3wb4<UQ&Vj!g;WHE4#>&c(Ugnfu@?
z2eERP;?f}d<L^>X0%KeZT8G2gM$J1Z<;&K}V&EV96K?tpjU0di6gf~31{XSao(zDW
z;XK=&UoxG!!-z*eSv)xiu7@wr2FmQ(N3RA0v}UsV>a**?gfP0rpK#L~&6-PkmT;FH
zGjhR!QHjU^J@WoulMb4nIdewXI}}Jrm5!?`0Md;gbj96mj?ajpLpws;Ljn_Kx8yCY
zEIO8$`hs$Uv0XzgT{l_zz?l$UT4dVB6L+t8eod7=M|2njYO4&p0<IZd`3#!Rp~l9k
z)y8k`|9x}!pT(`dxoyh4{{=KmHY|gv#K6Urue){aNY=Wxy4Ck94br|&Ailv`h#x4|
zmvn-%AM<Y;cvc2|-VQ%e{QUXGprF?9P~{OyJ;2u}(g@v{L__7v%LC`mohwWdwFOMl
zB3`W@WLf;Wjh_$!iE#iq!mzT#hg3GBwxreqaj+`YtBuw7IehbJnng(Lx3%#hFFsUt
z4>wnf>?u$t<-2GW#DxPvt-{iDQ|y|LC2f$mx$_*r&VR;nRS=1sH{#zb2a;jHS<apJ
zA37xdZG5~UMwg{;p|`7IF>7YnCm6ci!zRVlp%l(|U{vL0@P`|H3fJB{IlU9S6xk5@
zfA;s4-MdHMUsCeg85~_a`N)^FwqS5q`TMf-jj^utdMq~YQ{7)GRH-dGc8nWj4Zu^l
z`dT9Y|MKL>+H)BgM&^@#SGsnnt6lAI!o{&@U*YSg(Wli;|NY|YsBw|51bu6;4U{!T
zZB?TfHWm~FWcE3uCRBcdU!*{wG^XH;;)b9OJdGxp+$7e9C;sXIdA^LjY*NsWdL(+o
zygD1->m*kjgqo6|h6?N7G@tsZ%|{a8Ctvup8~xQR@GY2ntS3M+(t~4n?!CXcxLfzv
zRVQJRWeASSMB{6tJK)j`!NA95-8W`oZuNT)qgJZ2DVDS&Q_-AGT(IA))tWk8?_$~>
z=h`Q8nUu)xV|zC*FDvCpL0;Z~rw;~gBde*9j~6(L0Z|sE0~QesoCavxcqdlA@b~sQ
zx@3(z@RQ{$BiC*Pqmfk6I`u+LhO$SduJyDm`^X9;;3aOzH3BlA`kF*9$^y~3Lp;yr
zrWs6}vV5d><z|6tz`i!ZD98XKu|#Ush78<;=OVAZOP52BnhoL?fRdyZG&{?@2XW*!
zpwr`tM>wD5YrWREj#%|!0|T$SQNbz{d4~1tf!)K$eoFZ_z5p<YNr$2peNJF`E@~pq
zp2}uFzdMXLhs|work8=ex{%;#^_0;n^%`nlzJBF={oTQB?Z)%xS8iNk-M0n&i`YEB
zelKb217iWes+J8KC8{R!mc=UqC^U+Xuwdy`aX{k3zNSFsc4N|b_57g=<^Lvi7vCfH
z@&WVPuRla*snJniz0c~|*S}p7u>%sVB1&x;7A_qcAi;ur>2Q2<MaunE-#RvG^vrKt
zsYelWF6h~52VWDZD3VjFEBtJSa2TUdx*;r2n7;c9wTz{Wjgmr#Q|L7N`r11ou<7L&
zsq(s2K63Wg5ko2P^A7B13;{tB)AZ#rI_3O3Y{bKasHSMf*2=ZiYLBxJVDv}Aq3PSl
z#tof+XE}(i?9HLTK>qnFAAAnZA`AK}6iqAEGs}a_zXvajlKZhw9ZF~*4KbOZOxjG0
zr^4n1Vk0t<kmc}up6n|p1JupEGdCwKZD>@NI-jKrsHMbEjsj|Jd<`7H7u9?54oxGw
zNL_)@Q{Kmc1BO~nHXyr@RSfjdaSriqDd_Bt6{#A^#Km?vrZqzC8~RYwzfq{6b0C<|
z>3Mf_wzTe=L#riaK!dX5;lk3Al4tMU*`%%i4sV4iRCkmEWjll9_sDt*;uuc6al3*M
z^XV;#8GW`S)4P@D#_@$~zmy)GaJa7i-%C{&;>x}Uy)>G=^lz;;w&#BRbK~W{&jMo_
z1?WB7vOhM?`KssDY4H>8ylJ#gf6v9EiY3}@p9OF1+4SVIJsV;-7`|xxOs(n7@}QI7
zD);O6`}2=2<y93Qc9-57R$jXM<}L5Txy8!}Qt1?``d*zg#mje%eR}FTTU(WrC(G+P
zFJ8P@FmXno-@kv)3D`5?fJS4lqmhvtdD!F!#W?+BvOag8%`A}xb_p6@`u+*|jqhB$
zW>zsWT)U~Sxw)x>dZ+_7EZnL;P=3jlA7Ui~CN1OL^;7VI1H0YKvBq&qhRNoPy2t(Q
zh^ZZ=COxEn-<aUPzyd(MWC;SeEqF*Ka*{9iKK1d{jtdkg=KTC&?5sxF^HSz~n1q~`
zwq9!khvGIp1-L;vz4*Ml37W`=Zx&U0KD}Fe`k6Pqp}5OeRuLiasK3g=x9W22#EIzx
zo}8h-W<{46iHkgh-%H$Lyy3{>ebQb{n9#eHiB*S_FPr%uSt}Sa>T<Ar$Aq@gfX1SG
z<6Vna4b4b=_pm7lsyUFs##<EBjxtt;>`)axDE?*WHnxrfR0yz)Cy}_@gUT|cxx3&_
zVM$SX741L9w`OcbWqxnf%a>Cb^P}e!NwSQi|7+9Fm&g3Uxy(uZ`<q`{JL)>!3J;_P
z#9gRA+%ING=Vu#QJ5uVWBgvR@;m?^D1KYL#W#sD7^M`~Cp`n6clHN|pf#ikGmfqvl
z3l1_{3?v<9JT@ManNuiIWs#{@sKL1DOa8Ds-z+Lh+n}khcFT%DXZ6tA2wa3e0!q<_
zf~QBcEgNrDPM-otTa|5;_JORML<EEbw153_I@>@9{R6;}!w#2y{2g(vtQLYU05y{y
z8-BWjeRX5gbWIHn#&JJd{rZs%jyz4BK{(lI{^(pE5i(o0DY$j(_yms}iZ>h!R#;Y4
zfj=gOntD9GVCw4H<wNoGOGZc6kZSS>0l|4kLA;>vaaK2vGz<rlrrBPjY$3bJVMOl~
z6vS{WrBHxLmw@ee&{@54DgUh{RSl~6Y?_vsz^VZLco{7uJ;zuw!LO8X1-q?K@gD}x
zP#QcnFy!;#YOLe6!?V+fRsE<GG8iX<S^!y14Q>{n6$jcNZfGSXqG3TGKF-aperJ#y
zs(gy>xzsfP{V8oj)OfLue!R*JE*gf($;o$Lc=`LzE49H6obFrJ&Y)6>3A8W8E6NHp
zQ`R`n88vqOsLn%GtoMYztL404X1jyZ3yO9YyzA80y?u{ZL4}B0sxr{d05<;Bt5=~5
zkL<MleU@)rCCmOaLlRX@)qCg^R;c*~<3831L(wC6b|Fy$GHMdvT|b!%M`XNCFVJtm
z0G*yaW2be!r4kbxn@8*P@VrMZBM%zv;pmAK!)zw#P&~;kBuR^Lyw#|<_Ki)wP#^3i
zUn3NnKv1`AHo(ZJHNl403n(ewHcIN-bghc8D~C;d>Z~fNe6}A!sixb(A;CE@kp6`9
zOul5Lm$TxR!B8mNSj{@G*FL>A9U8jS7pnURo0<UAWGVdJyPuNl+tX#sxm^(FQ(q^r
z3z8Zf{q(#doFy|M4IGH#Uo^Ay)5<^x1LSq=-D%2p_4sJLkxZH;>-jelQx!TB;kpSo
z;>7|YrN~$v&Dq0l#u7YF6i0*$kINlrV(J5*E;4kq+)5UPghe>1H#W6hY4p@*)SAx|
zUi2t(rgTnTrDe3edzAK<_mr|5@N|cB>HXlfV;BJ$`N|tloBW^v-;AKE|D1R`tk9=^
zUFz5O!)2cY>ld?94r^>ay(_zjeH^Z39hIlCeuKbbUG_HOap(WyF^UB{MjPYZxwa0L
zj&G(P(AK*MWn3ZN>U53msE(*VV*+Cez=}69%^<8jnfLhQq^QR$wVuFVGh+p4bpwVq
zX3s)Z`f?_oX7JZ!5S3FdLXG};Zt4!^c)tNo8R(lp4M<(;dU=&81<fj!YRlWm&TdYR
z1MjypFfeCo5agK+TQ;87VKTcqvx&YidWf+0O&AMCi*K!SW?J^_0e~llpWb8wo1leV
zmFaLBDB%N|8`0V#>7sv?St9o-c})iWPYd8a21w@m*4DnZs$zCSmChGE8hY$@ebwQ5
zREAf!c3tmJ^rcq|G0q!qZE0zWUY`H??{xzM^z~}t2Mf~O*mytC#vKm0EWA5<^k_j+
zAs|~2c1X8zq(P)=^XH!*I(al^VqgwYL3$DFTpT?Wro8SaDUVlu1dZ4h66!|PUGT!|
z^5y4_Ykzk!mMI)CS4u`&s%~BpR+^AM;OK5A-8cK09-TO2(X`aw;_xThWq$6Mo+0ca
z$*9z_RS%6INHcKpg31b=s-;%(3H)%y!GpnR#khEkY_-35`o<Y+n5Q?k<71Ti`^IVO
zZRGYcfOZ8&Px?Uc_!E0y)QB{90&xWeRu#DBEDsO2_wH;HMIG}+h4^3Rc_Pkvtaz&s
z&&8ct1dt%Jt{P)hO;w?BwxjLzL}<zSUKy^V&y$IARvcm-K9|aK9DPZ@x~-GK@DrPW
z?tuav;ybOfiuV_+`9Y@sSgyTfNg!WJ_`1iBFTdIvnqRHfyg3$DBar?=4+!l*OxQxP
zAW`+kjbCKT_o788+EZ$d@D)`+LQ7d*$HTOmqOM9ebu=!{pHf54{^P8HV`JMYV`8+!
zv+q{M8d#h;dsdbvvHC69JJFd@vGuGfA_9SUwZJNWCYlthOB+r5h6DKrK>Ug1213;5
z>jhB`f@BGS3*IyzQwiN(nvG4>3-<k`X?}Qwx5WN-hOe{v8l8bH35ZTgwJ0=~ugGMg
z9V1TLwJ{%i?bg14%(FCTGFQ&rKB|(oPt(*Eyen!+lyi05<~xsxcTDu=(qzdy<!Kcp
zXeYEXeEq+7y7IEGb`lP}GAGJ1%xgUBu+?P&17z9(FbuX+=9uv3dZRdDxjuxt47A2-
z?ATw(J4ZRwYU7V}mN{_wF5GN$u1wQr&1UlZbUpNlR9!#`if9LP^Gzv3IP*Sp1~Y=Y
zNyg)eABmd%WCawrl&+wNjyh3eG*UI&%At6NfphK7oJ}MT{f3KKgOi<2Qg@g~`hxHY
zRyzUe@y3VUyCd52kt5}2(&j|9Flc(s1oKOGSXG4G4W;7CZzqh>z6FcM03|&LDpr_>
z3w9S8=<51W!CEq*1c9R9R%3!fG*o2Rb!6u<&}2WHS$PuR8fX(^&UXDw?{W}4Nwk);
z2mDGYap&o%C4fn?%|fKE^e7IVR&sF<a!lp7C+qv8rVhph{j5)QT5~(~K9>-Dirfm#
z`B*}}GSFV1ESv?eUP8Xz7u2Rx^Xl?VmoCj3fKz0H^&eqEk_K~DH4zhRrvh=xP#C>j
z9*}4J%gcB9PV?}tB5Ut5whD`hkDpRmec8bNsAd(ZnG$dLb;c@oiD-zfxR@%0dR(-<
zl9FkVG3XftJa!9)x%A$N1J?rIy?i-_(}Rl&$8g%rj4%cNRG?3;@3%K@^*RjcaX9T-
zXg1ar^KIrx$QiPkns32YHe4v$5Us93Yl5%QwQhp{!6*v!ErgGKn!^*UQ<B}4yZ*E6
zv!U_Q4#|`e6`JtG(9vN@ogHy4g(kAfI>H5JG}?CBv>g+AMguJiicWx-iKkoYo@Tzb
z2J{zV%SlPgG1KviNK>+0f%AkLyv&*r6NG1ocmMvMI!YNB*%tSuR#%W2awWdx!Jdc*
zFWn^e==5;iN((A{MC8E6N&vm*xc+{9wEZjDWd@pgN>kBmaocsrODP*?=r!e^y8H9v
z5~iuI8#ZOaqA3O=(IQdW-=Y&eHo<fd?$T5O#P{sAJ5KeR_vAN?2OW;NrHx{UdwFS|
zAIAg@XVjn}8=Cv-NYMyu!;Fl9SLk`M4IMP-<IW*H)iftPak_QvOGAHz(XGRmuVXo9
zjy=_)e6@EILP5bN%E&4B9tT7*PT|7k7h)L^KMGVK9yM35+|8n0?#Udi6%3YUJbxqz
zh43y2Dy4=7SeF{QYtv@FZ3zPe&e&J7juB8+t}K9$44@*Q+Z-F)lkyvHPH{jG2Rx=l
z$=okE+*b}SoK7qVK&?b>wdffV_Khh``!6O{;w1$vr~3wDqL-ODIb#ugP!BTy7r^I&
zk+gs4yG^@k!rvru#(ofjgr3t@^I8Aw5>WA>5#FM6rC0h<H+`9EVPQctWHCW~-8d@W
zF(g%rA25R6UJ+_{c;);SDEe6b1+%}l^Y2ex54iB(@Eo!YraVd)2FW-xNU3<Yh|5FU
z7!8TWVaDyvv+ehU?BA>HGV1W!%4RZd&6(0YcKGfTt_BHg{l3F)(^{B(Z_Fazeg(2B
zN}X+i2+I&j$=a3xlWp31KT#8Kij;vBPT0zH8#u5X+*N$E!<4eqvs|b5^sn=}!WZ_n
zt!=oWqoJZ`_GHC1t|S0^hF(3CUVzPXL|aK+C@Te}iOgu-tl4v@Oz~EN=(LT@IJrpZ
zRi1)~-T9pCuE<~>ghBDY3hp$H%*sLr3y&^xVXW05P2!wR{DxN<SFA4*URxk)u%k>_
zuKHt7J2Q@*YpUM+@cF6wOYjvJxBJ>^I_~k`%B+e(7IpI#L7j)m<|(eWh{kDDa5|X8
zF`%w;`r>(vSD6V9RG#`ZkjSX_Nn;j$80?0aq;RceDYDfRJ?b-E6B9QLbL&W;C3&M|
z9W_DdoY-vO%S@nbsz%v<C9Uogw>V|&m@%8k;raYm_#iW0hRD!IjJ3B9fw&wv>v~hj
z`V*mvW29QP0a|;Gd`FR?cRpOz&e5k&6fcyvb8OF$BurS4HT2@Np!H~n1R@*B8Fw`Q
z==0Y$adFmdXp0~h#q9wZaSf-#@U^+Gb~m00#frYyj`LLR9Vo)u9X>FA{B);VY2P~A
z-)$a+(r<&FKRwuZi_0%HH(RyGUJ$15SNyYxe(k%CNHJZqq^}$kl)kcHSf;>^nEvc{
zs5`n?(fPc5`8OS}=IXauG_cFWNqJA->C&iyOb+9+w|_dLxo=}2h`OxJw-F%$v63zU
zkO3eku|Mkq>q?2pR}QyJC(?<OQf!Ejs!5~`&!#R7snHC30`}y3U{3-wywq6ojyVlV
zxB&66EsOI#qR!7?iC;aV^}8AC^e?Xn-33}IR5saEhD;S1wd3%(5OxYdAj3irP)+f8
z_ZZ(Zq&vgq`3QKhVw~Nt1NKeOjg1HmkBsalMyGIHK=7NOiD*)KdL6$nj3o>Y_K!Dd
z4{I>ncU^Ofz7cmMnOu8Ym@?HjRPYL8MMkrzgbBy@8g=C~34<a?KPdm*)%Fj0coOz=
za!%gLXxjYefdl8|k6n7P?mj<ACWjb56n}Yu5$DI5jZGVQUW@=^wbpvs6~sWCuaPn9
z0#?}2vh`7mGHS9Q?n^*zcsuj-0B@r0eE(y6d~GcWzl>bVhIzs!9>2ZimcoS7oTrm*
zaCz+7ahPY!wcMre9u8)-YcsvN+qzF-*Mi)pP?!8oO_X`_<_s`b@i(I)wAQj#PuM}K
zC1O2b>m5TP1Eqxoeu7PE&DZ2Qj5Rg=iU0VTuZV%CJ0deKbkezVoMfuslLaAf3-3bU
z3|m{%PaZJMu#CLYx=2e$-~<KB;JLhN6s#S0fY*1Lo=M7U+AEorVD6RdCj-3kFPn{K
z%0QNEju<hmw0YErV!wNoMha#(#WNfDf|=t`W2bGQp&IZVIBJI(2V_w>LFbIuidKkb
z1rD5*H<lo}&04jJWz>sCSC(_)Mq&sieeK4LEnrrcE5EYlfc8sd0x;_~h`?i-HDpyy
zJ9Wpth*wo+HMbx3-((NApHouTUMyH@FyRNNMYk6xFM3nAF&Z7qTBg>#kZ3DDON5tM
zzoi~=B6wlhJPH?it2HBgv+RJ@oiEW-UNZjURPgccp$8HswOUt7>QWJy`$Z2yPeQoC
zX1c3zaYLlsjeAKRRbK8F+k&?*90&lJ!01SS8L87;-{9=Rgf^9rsi~>K#jF})31G}Y
z#wjFBfsVr~Dl*zOPIjWwB!A=pWy$m&bv^pI>aZcjbf~d}J-8dNkL|%-xvvXWMoRdi
znMd&>%Q`P$%fW>MVcZSnJcA9=uuInutc%QIZd7*OlakxOyD@UXMV9515)~*nfv5#t
zpn456UJ}NBov~P^P_FGU&Kiz!_YCmWf)i82r9~td66Sk&^?sJ?8;9t)pua=Fgr41L
zcxdC|Uai@cmw*8YA>&1K&?s@D=7SHQwI(?KLG>@+8Zn}DoA>L|R;*lklxxR3PC_2I
zO(D=!nfY`zVXDlSMk{j5&i0Mt^j)`fa3+BXKTo`RnLo+Iv2^FqdTNj@NVU>#<xaBl
z%?_WL-&1wV>Yu64e_!(WCdDh;CS>o)i!)747vC)MRN?(|^mh;a=jkJYvs9tCZcQlD
zbKK9baM3WoE9!y`*M@A7&rv>B!(27ech20oc*j~%=YVQ0fB$$2AY>`mQji{?XMyL5
z3y$47*Z}>>HVV)rB+!bY0Bim)*>k~Doe4L?)eQ5T9<3dBnq~<g&kW5nRgw&I2>JIk
zb^7URW9;o^01Re8#!+}OU?6Q-cd#wrIf8%1G_IRs?RK;yB(s~d2k_d&*0%%(l!p^y
zyx^i1<2*4jJ-}lOUhxZcO~Ny0Gvy?+L7*ofONO<}24abcj^DcOF=rI1QSY8_oOI}T
zxj?eXnuDdt@ScktGlmcYL*vIzDT+h`uO6r@OAAvj$t$1Mw-?YPxS~6k4S*psK0cFR
z&8mwwO!mppFYWGltv7?Y3gVmrHjN%A{{Fp#eRw3a|L8imr=+Bq>jMim_7WPLjMbM0
zmlYT?8_JKcEz>I!KP$S^>jAZ%m7hP0Q;@V%92iTjanEUO#)1k+@ln-(Mfoq?yO-oy
zY`j{>BA(wt9vJP=<a?naH~6#~l1<j*g{>I%ygvSG@qR8GnE%pGWsb_;{;!LRA?;4?
zack}fc+?6OH{5v3wYV=m|Dpv}Q6Bte*wpvPd!ZZ*Zj%@PT(P1jtBpu;VrNUEq=c*x
z+>8s3204b5t-0c)h~qe@Z5W4}(DT@-Dm@p_W7wYV%uiCYodH{B5Y(aWpAFjM<5|hW
z7-gu2saxH^9}AA3<u+?-WHK7#i>s_nBp%9|c!U16Z#eM9=woFCFjrqJYbijOj+w#F
zrU-{+H}aa`XMf{Gz>)nd6ym^NC7{Y`XZ~s+dN)PKC#Poq41i4$7#q{?A+mCw@T0Q<
z;4_mbG5;mYP}XiMSZc)}b`W*UK$<|Ly^LHW&3@XveTNRq;1d|$=`k!V;me!QkOYOg
zpNY{7@pa&v4P5qm0&Vs_76TU~xke&cLtQctcwMHg8wSa$DZ6a|nf4A}*_Y4PR@qQj
zTYyBteuo-wF#~y8O7BScwO+qI_2J@myUi%2_Aw+5csC0qYQf6xvk~<1ri||YV|MlG
zv*$mB)$X1p`UsRbh!|$#q$A4_!<@FzIS&D<KN-5LS>nRG31J0o40dor=!8I*t+a|f
zv@opzw_ujO8=-#^@rMe06mOVf*<J{x=mvQ6MOL)7!!DH9;tRqtA&oeeHF|a_i)D5!
zz92eF?+@2+jn$ID+qL{oIj{_7o}6}UhQT8cHTee2dkc}tRItCtA=SuGm>(;vBUDoi
zT!VgIBdVz2Vm6wU=)erYr+30{LqJj_G8?hgV5##<ioBuJotFAY1a^XR;0be+c9Lx$
zSBMg2do^!7eCV=x)FS;L!mKBAB}{)kt?5YJB2@^RG+b*x)zqwFPDMJx>4i&s+`wj4
zN)tw~o((q{=Xe)9ET*ZNcyLMo&aNvapx{$vg#^FQk4^?{Bz&fIgiFf21q<@n5P|;2
z@uap|KO}nMjDQ{#0lxtWFL<rnDn10hKF9BMh%oTQ1A<9rauE@#b^J?*zeujp$Bt!>
z>$>hbUk!LI+&Irr=5;uxbnY2AJW`dVReqHXLI5Gd0Uu%kvi>_a;!<~UW%;3k{u=C&
zccV6&m2!EOL@rvEGpOMj3b)RF0o%4+&C5G|YvDtqX&YY6{`Z32)vJXYNnV2nX&|3s
zVg<e36u-k<z>5w+(nhgcAr=B4g2j(nEpIT8rb=llKI`1@{z&h*`Xed$m3{nwY0?BW
zt@G=|4!$pt!G0i3#=Gn7Nbp&FD>Jjrn<61UdeDyB{zP-h!MRGM3EskDNOyk7L1MNb
zZ6X2T$;)82-ytIuLOdb4d&Cyo$YKQ(NG<r3wY;d3r)eg1d@%f0)Q6!i*dPc^3H&NM
zbc6y44mKm+P(cX-iawK9#&dc}Zzhl@+IZ1=Q6Hd>je<dPjQuF<ijX*QH;bqq*{0+^
zXO7?2txZUdC_%P2*LA$bn{qQu|7K)pcr5MvsWcE5QsO=yb6QoXKahzhTKot+mIDH!
zh>mlzP6Tiie79~LmubFHAlcF=MyX%$trCw%ul)1RBcz44N1fJz(ujkDuq&_>UJ(i=
zG6s=1WtpNF(lL~3i;c3?Kf8j18^u+d2M4f*<K)>6Nd}u3Vc{@Q16G2B%T9LXUsw9G
z%0s7ncge;b`c6Y{b>vkwhg~e+X;1tb+OMWXQ7o^fwqg&aQ$kvk>=#7~?dA|qI<zy_
zjNx+$Zp{}P=v_G*@<!jQ2Xm&|^zYx^HvQ6-e>)nlbea*T0F~-ar4MN4j@=k83cYQ1
z)$eAn5GQ6b>of_bv&hT_^<GK6rAp`NGT=A^aW5iQ*-M->^L1AW6J#ebfff6SK{9;B
zRaOS-X!rCtI1mvLVO8J4o^G|qr!1|Lqq@Nqq8?Rw6#cnOXhe1XGK8iXYwYe6S|YH}
zbZvzM?I-%I8&vd)_kn#92?}D0&u}J66?c@GxQ_;S#%X_pxiyk@kYov=+kyR*C_^NN
zGaM~o0q+;B^%XL}Fyta2G{j6<Sj*?#i?JFbSF&>pQd6`gG}{2M&Tp<+)4+0w(!rOw
zdELUZWmFHDoEVG<Ws0p8hz_SJs<TTvZfBe6EP-mb`mB9?KrKo|5EbOo%p`m|m=k~E
zgbn6|Of9h3_5hrpqS&d!fPF1!C{Ym9azWWXeI+}4J7M|98qHDIup@L9eHp2vV7Fs1
zgIMU*QTVu(>CJhKMKX^NPq;|F9h212irmA&!M-r<sH+kRsuF&NBEr9<pns3S-~|HS
z3&#i`?_Kf2uVA-p67P*t=5M%v*Go->10|_WM73dF3Odx-OJr`eV{{eB7>0Q5-D2Q$
z%kUoI+Z#7iGy!{z1FpS#{W^HpF58p7^Ts!A(die(imo&_SycP`jJ*tac42*Q`h2Ht
zy<A<m2CN+~Ia3Uz=p%O<@0mSl(4Y@hRopKv0j1=AFrS6!q0hx>bvcJeI>jP>fZ#}9
z?XAni!U-19ggc~+uBZMtNQ$4tS(>s<C>vWUH!wKy&!y9b;!p<0IEbp3!a}YNc?d)H
zlh^LYrmm{+g@4}##{+p47#sVC-=W0I^rNz8L8gddEna~kVj$#PHrZD@p0Sk>W-j>1
zDB1pf@W2icJXk|cldfy80Bx&at<)JTmGtWg<sB6jCDIo9QxVux8#2-7a$2#9a3#Y-
z*qK2{_hWvla*k6R3PTz41o+3PK*XSY%on({uxL=Y3DT4-_oaxAf2r1%apo2Pf#nYB
zDY)UlY9@X!<l9O2iUZNX++%Fj09FHB{2N6T-y+ob(qGteNC!&6#GVBU0;_b~oK~?*
zWyXpUgZW~y^QUZ2zIfnr6uYGJ$YkU{WuT%jY-ATS3!|;Aw}W}Hkl>=#@RhU=h>|Hj
zy>!B}k9}->CtR9k>Q`xbnJKJ$lr||wK@m))G?sRdDFdIPYB(sV?TO~$dIv!_j<j-Z
zrD6MNmTp`|W4okTu1UbMdtuwS#XXITCY23UTZ$_wON<cr8s%5DYx^uK%%pjgf<xB@
zqJ1_C>_9k8gIiE~fxmZxd6j8YDr3gLgJ;`~<-2v~6^MZs41h8sIKGAS$V^s2*MzZ{
zolt|bMu#B<2F?1LI$VV17xu5I?`EluH3UVJ<H##K#XhNu$h>+nh?ZeTV06iw^exU-
zQ>rj%?M~}P)vR>whP=?87cACB%q7bt4@h4FITPK?Oqq4_rZzMwV2W7wV3hz^_zKY7
zolcY>+C3ywXmH5#BBC${sx5oHn9<=2QJsi|rtGp6v!ZEz=Q3$V|D3e4+?D-YD86Qc
zGA&5S(ZLlG6GAe?JT^OXV!55C@t2WoEIYJ$dVGZ=E`uxjM1D9*jFYTQpscG{%1Z?d
z{pMjkk#brp4tn=PCUrG059XeTj{ciu%No3qRBzKLoeOI3?t|;#C^1_ZvTN69=rZwc
zzI}TaI2iMoBGn}K>+$vzKW+<7xIz0&98dVBY7OlL4d<&=>XHjzfmnrk7BbJBeCXWt
z-R7nr>pwBD&*PNIOK3*UykeZe9T*@2a5|8g>w%gwP+#PIhVOC@$WdDFTDUj9EZxdB
zs9Dsk^vf^Sp$wZncWxEa#nxID-DsM2WzP2ae*Bfqig%6nwOF)Bqx10=L>`&+<!M~O
zd7SRgxvUmmMXbL}zJF{-aPP^c9geosf?phO<Fbi5l2LncMuCgA)UqrEV}z|a?$F7Y
zb}xrQ02$%g0=v!i;<Rw&$mp_;*L);8HT6Af-f6VD2Fo63H#*2VXaWcBb$g716%7Rt
z1JyVXQ_JjGsA)YP;Y$@06{m^K%&{02Ma)?Wt4rb<M-W<g@Ayoz9*H*Iy_uOG>zP(5
z|9ya%5)qcmfR;vh<df9IbCiTgPfj{~9%dOuLhU=umD|Cjh(OqMrPR}{dbR04@_$+Y
zk;Zaene6@p13m0*;@)koBhJWK2bytb1L~Uc6dB$D_3k-hL<DCedbY~~s-T!aL%nz;
zAAp)Q_c8!H0vJ3?S^5v+h?nu`K0(<G@7D6sEvXt1n9<r@uBd5*eo~B?`Bu<0-GA&>
zK&21q*&68zUy;_H8Be?IpTYt-$2SO%1yRo&)7GyOBO|~@4kP;LgloCpY(s@|>`uCK
za@sRlv&N0D&|OEzmlM{H8D^!+5EIrs$y5PcuVKEi2-4uI0boM<HH4!qXe;0$+uB*W
z-)dc`CleifwubMS+&^&@uSOJkvM&$OqgRCIa455ViSso&a4GT<!|M%^<uH>co*hq~
zq$qm!qakO^I~$e4BpO)}CIAH{e5gtoz<ymm`%UuKuLz%j#tptFJKcHZISl5>K4EYb
zEe8Ffs3>UE>Xm)lnY$^rYF3qvIBP+&dmzUt)Sl{uuP282fV$f~OWa_9aXr~Yy$P$;
z3x5(s*;d1<Dfxu;0lb<;aS-O2lZQ!S8-ju$(z4VEYf3ubm_Xg8nlI=qML5jJ%L`~K
z&}(W|zRp1~0`V=B(8EQ#nVG4tAB03Vd_vprm-NG#w;2Azpdo<t9wa0yR!Ml4uzmi1
z(-tjQ+R+ARwwbF}dUkfUJ22^vPD5G&1A+H!WAcv~6PcBvd`V)$pQ(#UNKci4hH)E+
zO=(^!BSzDI!m6!#x&N3n@1Sq+sE%dLc5=$Z7(<jbGN46ssu-DOkbtqw!Z#(+QBfa0
ze9)%rAd*HixX0oG9yV$3*xjwsa}XVE=D(1(LG1nMjL+cHn~E_@?4-jvNM0t->@chR
z$)yYembvNK9j=A=OW040VPTj#U?NvaM(yVJT@4?2kgqI@rSCiaV+0yRB_qo#tU@OW
zD>DZKQ$S+z^3_s4=7_O~P*Hlo?Rw)o0Tqb$L7}26?akT8J&gU2`<h4fns_C7VOElB
zT_U=xn{<lec1tQdc6)xEEWd%AlsO?1$0<TTh^*n;wPk#*tzsBKdx(l*Arjk@%MI@;
z6}0=z!G|Vj|Hap1#Ywl5?F`$9+9^ArmcmR-RDY<QrikdPNJ<3M?n_s$oD2WGVCrat
z?cg{c*r0S~PIh}rRJMm7KRd)i462ZyN%~<*#A?{w`G5{8=#|9V5*~cpjvX<eF@gd6
zVT9I(7BTVowjurcH8>dJbg06HH#kqhtA$FX*O(1QKwp;jsns<pikMs^@`))lF+)fh
zI(%^eMXbUD2&+)&aucnIC6pVnK(Mk@m?aLfhLGxn=FuIN6Yq|MZ(2&TqO7beoj!fu
z9aID0-(QQt^N_kaSQvQOKd3vEIf_dw7Sm!uji+a3T57~w#gl1h>T;>U_zQ?LPAw~*
zNc+Mv;+dJ(UrVi2dn9QPbsGkv&ie=K*8u>L_aU=Ih+CPTv8x&8T6gjM>C=juq+^XB
zx<Rkf?<dzk=Lq3FER#cz9!;H}+A|q7C28*Rxdo}T4g|&z=^fn0@BMLn%1-Uqs_X6F
z$l$vRl@LAhZuVs`j5!;-0%RDIl}G(W$;TaL#pKF&zU})QvFW7R#9oCsNG-@epnEX*
zR->w_D$*~O1_0P}+-27aTvNij48c=0VbfW#JJc6lk?55(RHVXzQ<-u++<5@q#sWL_
zb(VJ%tJ!0c_-f5K`hv*HhCpP;_yO8Sk*6~nrU`vR|G!h907gfl4`kUeq(Xc_6{IZ?
z+Ix|(D!=||grtRxlAq{ig8#9ll@;aY7>aG%KlppzCtA1=;c-TBJ>9bqT?2dshBsdy
zy3~UBq~v=8$BE-Cqgkkj&wyETb{Y~F#{Wc7kW$B@r`l;u>$Q@KgtD3>K0v%!P~kAp
ze}Od<=p1<<GEEsDt!B`h)I&eOk$YNNK^atkp-~}j2!xI*RG{JUCH7RavTU0gRVXCX
zEQX)@Z#Egc<Z(x6Zn)J9q8+P+i@5r+NEktvW?)GHgeu~EV)f(HbyLf3h6#s2Vd2U8
zHw1K{G;_$Abb9q_f(HN@S$X^AQ4}Ejvi=py9dMmYI6Cd$J~`_;#?@%?PjL;2P<_23
z+EPd3%kV1sMHw*3wxFP5bn|(B?P%H@_7Lc-!VTP34^y=YbK5?-zuQvRiEW;oogY$Q
zm-Uvv$793F(W$JMUa0;}Q5a@DTI3xO<iTK1oSBh=rj=j!if{A!QhDl2#*Fc=nlLjX
zF+dD!*p|(yK)ALMK+9Uo(i7p2)j-ohdU{O>0?A#bMFw1NY*%DAZQ8Ad0O~*}G?NH3
z=T9cFu<fDectLLLP;|TApl{!v+S)3VER2L*p(L?#(sSBF&N+<_H&x6IOtY1TzAmOq
zm+?i}s3QN5)(9EIBsnvpLH&a)``;2Qg84YA3E0$Lm|)V0Q$*wO^?Ko)+ovyAupNa$
zTNbPcX-8)(4r~BNvpBIZ2np}*KNH4~V+zG9BVwqcG&*z;cmvFM7?ul^wQcjas`?3t
z0D@5dZSGzC3%I)9U;cKQi!9rb;PSIV<H<_jXnPA1-Ne=iC68n5%chCJ4J1YzHYamW
z*u^RAD7C5(87N1$OzSIB7MfmW#CmwWQWIAc6j-SB$W%i?JtsyC-N<AZAOcs;ac0Iu
zOUtWSSyqcZvf^4mJ);rX1m7m#Kma6IV}=%<<=*w9Z+gwxE5&&q-Lyhf>@pS0Zn&7{
zy+qs7o1#4VLVs&Fx2{@RT4C!Gdpg~6?o6I0w#W!l*2Fdptw*AfowIt$w9b!HTaMXk
zFf`P+B~!|bm(la!D?0jOpyTAp<Js#fJq8njKu5oTZdBCSnZlo1*ByQfYz5My7#AEm
zt*>){?>t~Vm<+1=v1NMK>TS`@C%hF8;Zvt<p{)J~G+F_WDoHym4h!UL1SD71hlPiW
zse(+s$pkrHFP88Sw*NW)60k&Y3@vzthMykS$FR1Tsos3nFHx1IGeL`?OH4sh<L4(T
zD=R4@Au&|oR>;l*E6Gp*N9qP-FXf<!Mfi=<U?GW;h7iUuwDz*_VXl`2hL%xtwx$Xn
zK<V5Q=9Nyso|K}Rswmoh_^{jQQH3mhpb2EI&_}jnQZdNSqa=%(*4M!wAZVqlQEQ()
zZ}>PD7?0}IwJOo)dvjWa_C~JLUQYwd(c#C+s0ONs<O}`@6Mk?Zvgr?F7&ez%P`I-<
zkq$y8UuDwg{}(*=EZ*>1<mY|y4_B?b5T9rdFw43|h-aU`ezQ>;lO|3SHdbx?WUtI3
z&;F(#yNXl;9{lvIbTz8P9$uYQP(n3qF9S$0Y?lX=FN<P@?TBp%IlD<KE{iNhYeV_=
z5=s%cXkgN;)LH+qYX;s4)JfYbRIvuTCP<~;_gB~6J8|`)%hjs}SD5p<O36hI8IyI{
zPY1$C<^X0~Z6y0+fprKjY7-6Ms}CR*5@!&M^R_S;7S`tqQlvit<4KLW|4_?ar5cds
zH$DF8c6lNtQ3L0#x5FU(9d%-J+mj2oLWP>uN|zscO&C=yp@FU`6s?R#8yph?(8D8_
zI#`S=P_o8<Y~k(gErwsHQ}-O(95s)?@;B##ilaZw0M-ulm6SP~)4ceT;BAND5v1Is
zRX&4a6-~FCY_U1P84oGqi}LbZ+^958cZoxD3s6M`A<|1IX)&pzvy{njB77hVG#a@o
zE2$QB`u1%_xg;zE|CDu)?(lS^lLHqn4CU6D>pR5#NyzH!Xj*`aFLxJWwLU250BjWX
zqO2sElM@R%Ofr*BjIn2R-8*UyoKGrniIU_#$;>c#Ks5iJTii*$#G-%IiCF-xj_cK;
zP{PniHt3b~G@-IX2qF!OEfzoAoRTsUYjM5%{p}SBO63Up_jkxtr=+YNEILZQnIhw-
z8GPh|1jp@Mz3^}Q`6om#AX)Qkvw0!D1_RiUTB;~=i~q6^Kd*~={!ZGMy@|mNeze|S
zKE^}d6;ZIU3+(s=)jLr-O<Ov?|5WKC@<)yul2~`xc;%OY-(RFR7jT#s9tcC&XwIwc
ziTxKEPq(Ap-#c(_D~<`{^xKKeoLPOZ<5qKL&b$idglac@ko4D}=<N@rhS~yk>l&#W
z`WheK>*Iaq#9q>uueMgjlZ)DyqrvuXUs~w_%qS-X$Q~7<8kOSTwDiz9GE9xvN{?Y8
zM<ntf3~}1u`Xl6%xN%W>$kJ7UX7Y5uK5?;ty&zGt+JN`R_Z9^#C^1c^n29mg9_&~l
z!%sOm6C;aiXq04S5daWhnZZ5*a0T08T5z7&7w0G!f#3>!KY>goQVHq<VeSR24K+)D
z5^6Sw&DpQ0RFww)Wtf~Wb9=tMIY(duXL!nA%jaJlfZ|{;h08X}sIcRlb#!y5XwC!|
zXIldTAI+A(4U(~c=ER)u-I+UQj-}Q`2dNC;2#9Q<##Vk`xQ7UNdr;}|t1#@Z8=xg7
z|457(&>5CFdw_DUXVhC>vZM>q`1AY}8Ie>$d~Heo=&&3r-%!h-Y1~E0-7LQurzHXZ
z`%oa_hV&Tf*-q8&`QlMu-wp(7&0^C;cY=&WW1b!#Zor5R?+YF4<fvdYF8~(%0fC8i
zhY$aHA{WDuqvREK<}`<C69kxJsvD!J!kNmTJQagz@ORo%m$LC;Wks7^^zYviTN1bR
zwSIgR>piBc22%4fQV<hpx5TJ<RKh4z2d)Qs$Wn`TJu<7Us-5YoCKR<-Dc}H-Wz_37
z{$iBL4d@!6scZ!VS(^9Yw6e!AAg>2tQc{#)g%CWu<``wE_ynS&fS(acjCD6QWs}V`
z!^6YJfdfeI&CiC%gqsjXmhp74Dn&FILRtXup|T?%!kV4<FytU$8t4+ObyviQQ&<zq
z^lvxW4@i_DQ9};J-(F_09nek+Yu4qNQtQfUax9TV0}CW8_%$Ym#<8}lh)&cHs4&pv
zmQb9`EHn`;<<nAmXRy!$K@ZmXP_KK3nrwS;oH=z2eFuZkRUFS<yLN4W??OF}LzOJp
zNjn`lN`T*+_2YSllu!xp_SdE@D7-8gLrj$jkytMrRwO=PuX5yt3mqZu)U2iq1}7rY
zM&?-rWDOuHkE(sujtDf2l{5uQW&bgRoGi4^b$cqSxu~5eK-wN{$XnYms2_dt=q1CS
z9gY0kYie#g@WpU1R!UTZ6a}M|OAK~U^l(V#tbTuT`t8(_lU)pkI;bAAKiY~8`6Ub@
z&KJ*i4oTLeMnq;-_bJhbY@E*NN#D?7n;2362%zBhBk1uW6yp*G5iVrDF3-0Fd_0bj
z3=JDRN4*drYXR=1W@R0VK36V8%yCzDqGAPiQVQJ(;Y@_>+Et_0yQzmAig6(y(1xPE
zbrUkdIQUh-_U)n#6zwGsUgm$v+2ezCyLbPY^g$KZvEPghJ$|h#12>hFh9jzs-%yD5
ze&Ew7a>1G@O{X(m2VNFK10w(t@NXC3Dlx7{{&6!W=QSg+R}oQ=A!&%7sAVrl)_`6U
z0nJ?A4+d*HPn|jyoEIY!k!9BU+<gjJ>iyl>MY2Csekdtg7NWrXhDAN@>#!JjPvA(d
zTzHwcERcZp^H>)Fwg<FT%ysF#@OoSLwx}KnJs@3~jrzZ$Cmj(2M)*C9jlYC>edMiD
z{umTl^`MsHHgkP97T6g`^(6GA44gv3P~<bmT9K1Gi8I7S)%E)&a*^vqZ7XZ*kfGZa
z2zMi1b$lH}xn^ZUMY+nnY;joTzrrE$tht=i|4UrnwciV9{9;;0sc`$VYEtSh>Gkey
zPElCaae)UTFR<r=WyD8c4xtzky-Mt-N<Y63`I8dPxYqelL?-#vuNR|xwkt0zN&s$=
zl>o9QcF_E`JR8}R8+Epkcx6bc0lI@7=F3I5w{Q0pY*rff;DaXcwsblQ#^f>wH1&vO
z&iM4x!{6>^cXH6Y_$2W(Y}BMhw>a^;_QDrmo4OXK0GaJ?-#+$SkuvXQZi6X+Xt|l+
z+yZWFz2f{NM7V&7N16R*Mf8N=7Cv5Jteh!xqK>dg<Rm+UExrpfb93t-nUx^1l;HyE
zKc<$JAqW+=kz!fKWekc=z9)nO=L*PzVHd2*hesZ1qN%3_DySS&gW?YNl&wtF@wSEb
z68D~6`}T<vi_jM`RH^+fjldPYAmy7igmDq45bKT9Pf6g<v$!VIC(7P!+`3ssWm!5q
zcR&Pz$srAvHjbwhdpaSR0!Nae`Aq#F)tORD9Av)*h97UwKft{h9vZ~)d`)G{56;6l
zh?YNm<!V<TCEQ~*>}O_4Pd8{m!T7xGlM~F5X9K#SObo){m5yQ0pdi#O5|G(y(IXpf
zj%}K@H+QN_)p?gCpVp+u(AR5TRDx%A=W_f&1t)+7X4xS*rB}0@G2_|rbz8KP!P3cS
zE_iS*AM`k_^`<7yqfc4kOl1RhB<uu%womORZr8(ei>;wvr1*IHR9d%YA!<g<(@3dF
zd;zffnLd+RZd}=9&52pQ^T-I`W9?}B_Zr)%-$hehx^O<_J3C9PwUClWT9H#tYnq6q
zC2wdBp->Q&vZ2A*IXRT3qkd4hSTmfD@fHV9IuE+>khNBGsanXFXsTswm2HgL^SeYY
zkct%mMBJ<(GQpp(inI=6Z%SN<q}>c@Bmrw6gR+meH^44M%!reclhb)qhz64u+%<r9
z{F{GNuww8#Zkte8G~UaZP!fKPT68H6bl`UtA3mse-LGb)-@kvGPMr=YOcFt`RgjR>
zoe28$;lt>jA^LA)1H*OgcuIC{9Tn6F|5Y}qmPBq!6`~D&LXts*hRT-#7-l|o9{4rK
zz?OD-itfEz|BtIbkLx*K|M>BYL9!)fiKtX6Ygt0JHd2;W5<)4&j1kF}s6-)3i?XDR
z7D<scA{4Skgds~}gcDgK^}Ao@obTuN{mwsgZfB_X`}KN0ujTQ0T#u{Knd2;e69h_0
zyrh7FCH_xsDUg}>%ZOCTFo~O>r?)945LFiUP#o(R)>)Z88=76PYD&N+0d8CN3|`og
zgy5ZH=mI*D)-B^~{Lj?bJ9f^W^HkN;(w99mj}{6JQT1U+c>;(t*ADASf@OZ$&BuAI
zhA$6p?AO+ATK|phVBjkM?JQ)*T-rb#ov7DiJrbX9Mc7H7Am9n23IhWJ5|EwG$r-t7
zGSFXyV6=6hoqM%|^7WDu$JehD-@p2_fO-CZLE!}g*(_!vdlV-#6qN&kar^M_7YyQw
z129=pmq92JwM~34SVu`H|6R{L{s<pwAdM(#y_moxDQeKReP@LxLsTt2+O6{Pas6Tk
zGGqgvR0J?Fan-8f#6zkB*?gUs=bJk3+SRLt9BOQgio!KE6YKzzrKl%^WmaWG6H%#`
z7<?JqFIHS5N&0m#eq#K?LJY}b4#ld$CZ_<<nGovlXeJvw!M>Jqo{o>2LXp9Ehzef(
z8PWF|Em5d}X2nKXs`<`HbVqnD^$4Db;CrZ?WU2r&A|PdW9a}WVh-<QsE~2!M>J(JO
z`Qfl=Gq`tg+CwnxPV)n9T<`JBR9DwZ)l$u}U+m_VNvY(>z98SSxr!0H$VnHNsh>-#
zm!CpEsK9qH0^ViZC9+CIz`V_;R4s7=;*U8!D0iTh*V{BDlKx)ClfWGhd@`{`=zoj2
z<uJOxNvFcXF*Exa_`g5jLW)2L1{pZTlj)k=pW1<Lz7p1ekjzLZVzBg!0m&G^cmR|6
zAhw2|^T{f>Giy+E<czlqO}8~0ggBN8&Q>FN1}y*%H92KQe6)-~_R4C(1$e$(M#Rt=
zrj`U5!}*Z;RzeKm^D~4dSmaE(Jwp0uL{ZfA0~iXu;-lKJV=ebw-ajU6S2zO~AHNJV
zN3HEcN&ufQ=K&hA@{XB9x*X}Y#RuQZOOHn7#goPcztl;JKWCBsK;CD=OwuU|p(dpo
zzgvpr+!<=G`Pkon_E_!Led^MR#(?_Lu&b`QJItq9Y|V+vo7=~;_k-dMTa0YB7zDNV
zNI#hom+Sn}cy5=gLmYw*_S}-HYB)V*?%Wb}*Bf;|pJhJTndAIw_vBtRKi&;F{^nHm
z?wfBO%-B=CW>oggH&vBEadBM$r1@H67cS=<VLPjR)63d7dlp1pl9ZTeM&z*hw8qx9
zq+PtGQvY4^L{I;4M9+B3yN<XPxlJFJfG22nL4ypG$@OG9iZ?9@1`z=Bc@(;-RWbw1
zI8i0(#U|4}W*BQ{aNVKEksA)V+c<nZK-E$%sZ~%~;HKuKk+Sqwbha=v@(vJCUCHHa
zvY|T=!jOYZs@zCeVtv&9W4)J)hWRdzURonZ&SX}8Ke7@T$o{gheFsbDg)qA4^m2h`
zBqjl%qE_fzx~fjY^yzEI&O;`&Jn!_DvTRHDk@1{o*|$v*ad&Ot<Kh$$P!@meBpwJw
z2!<53%FW6Uix=U_t9Erm*eR3@jG$pwZ`H{w7by2_*TE8}3N7_tNT447de(!VB8p9{
z|G>?xHOBdnMH%-92W?!!j6!ueieVjkloM-z4hJ=jeEj$)Vmh#nmhIXJt##t`Y1>E(
z{Q$h=C$Kb8U^^0l0DA;V1{ewnXhKYh)e21y1z6jO6Bh(T7hk$0>k270m}T&yE$3La
zCwLrnKRDt_Nl8y*V-@UEW%!@N+?l})x+;VC-~)VC-w9^=F{mPuS)@_qhwgnsW|lKx
zmuTLM8&940jOJ7~<EvhFyru85WtKbA;>k&duHyozqaePhTvBN9gu|f*;B_zzAS(o^
z7xj;>CG0RB)9?@3X(lCxEO??&L<AR0nU(*=^%S{{Tb*R)WagH&v;VeE|3qamnMwsH
zjo1KYJbwjjgVAkM|EC35iuMsCr3vOyGHxgXs`0kMXttv-6>6xuvywPC<^6P>YaI9D
zRrx4AC;?gI0p3A?9mce-Jv;$2yMFdT|D5t={chgE-da1AenKZo9;7Nc0;@)Bm1NIK
z(_G&Q^AFBAGczcC1mqDjjuOl;u0DPlHPu4h>8F1eb#)tnJeGpw*t}7?^s)Nu=~D@-
z1u=4+tbF~-6`3F5JMt;rpU=$Jte?o~L^^{PZ|<B6A=?^mJfot#1?L39B5sdqm_?RF
z3|;d4cXa(EEZZS{jTrqvn&CsPmqBp=H=Qe5QSG=R^QbU6I(LpPaFln<8rY3Ue}Vn0
z$Z^2jA=r(GsNHx;>^|lRkQPGe01Z<Yh#4%~s9VyOz#pZAr~M^8`pT6eB!iT-Kl*$S
zO&Soy5^Za{g}_6p@ooQHu;2<0ebl$#KQi;d7+Y`e{r0NR7Jx`%!$O>s-S$c&&+c<Y
zDskfENx?q>s--kx<t}0-)+kOwbs&2~Z>Nk$C0Pp==up0leG-I%D)-zm;}<MkNV2`e
zjTGS|qV(Rb347w>!zf+2mJvfe>t=g-jYR>;ifQNvTUs(ErFIMa#|ygRBh&`XrPy9l
zgHpFk$$}qR)ah2)g6us9pxuswl)s0X%o`+EBwN*;b%}-_><e0K52SLIUwh>5ze!RP
z=p87T_3wTB^GV2km(C+y$Den43eqA|&s<Ald?(P&$;e+wE?R&Pw2fHAT;?pLh8wB|
zG5ke#5*34})qZ~W1!tK+c1_19(8gpL*pra7U`}bd@#a^Md$QGY1Gm4--bUBNq!Z09
zB7GN<%)0r?col5l$-jaN;*30+3j{%xi(th@W1ItZoj~L)-^nHH7?<|>0r1F9Adw*J
ztgiHh<>J-<F9FiRMRp5ZRe~0Wj|?#(PJn`05%69!i^xY7JeP1OKZ47g8a~}pZwIp$
zm#}cMDOmfHT9ox;JCMB%V9SJ$$sZUl$PP@ZLrYLTDe|dA@N@cA5hEI~9dgM<S(SRP
zCD}%0^b_`?686cUAI-Lvvmp<u5AzL9&w8(TgZLA^NI{h7fYcl)%{J&YSWAMITATWg
z@Y-qOAK}}!&Ewbb{ly;lU+a^e>}S013oS0t0H@UEn_-zPM+@=nMOFZkRm5YKUrKU}
zbDi8r-<Gmk;bMH9Lucc;ibN>x6UAoFY2nmiA~At=Z*~qZn9J9%OB)&KDHTxJh0H5&
z$@40`3`Y9?sf=5mN}D7@THN(iq$1LSBCQ_UC?as7jNgVNwdp!$a=S9$y+Xr@p_Le@
z5%}p_?1+v@HwnyfOzlA<cNzMZCU-k_K$hJMo_i%~B~gmwGYndef^-1E&d`7H8F~<r
zO@|bxtp}<#UgCfHX!j8-#&EK52y*`wa}pQn&)U;1&`ybvtb=Y0cx&6)*Ec~+h)Oa<
z0#4%U6@OL+5vg>U{D^$<XEv%g=_|_C$k&gar(9MpaB-_vf@ce0&c|5FRF7=K=7NEh
zF{LXkK4GnF$*dhvU?iIXCME*Ekd`B<1n}rQIijVEwy`-(w$PFrsq;~)T$kp_)bGzY
z?}uu^w^uRn#}7>PR{n!#4AZAe-WfltGqc6UjmAXx(2pT9QjAauxBMmysS`2xzgG`D
z`svdr`tb`4iO`Kpo&YW0M8(1vzxe;HSb8jbgj%PR*_>^wuGc?t#_SR{pK~w6*YJMc
z{>G;crccf89&PB%YfT*_-nSUU@mrzqV{|Oo&mp562=zQlkERm}WQiGec{*_%jo&{D
zRgU5(<Ji{d00Hs|G{1%??87E9aaVsMW(+qH7mOZ2VtpLjoDww~8oi5esy4Ruf1r~w
z2>=!@$pneG3>xw}$PM3$itjO_i#9?wMuG;Elr{Pl{@@UQU{r~v2exD(@$lz_C=(~`
zAB5G>i-<me3%m_Uq>Z<d?o`}!`h~0!-vRo<@fyh&A&><>IQeLlKAOczSI3seYFfVq
z?-F%B%<%vW-_t9t>1HG-gT&w+bgsO7YPGc$05K(i4m>4aE4q9%L7ww^0mBeNU%~QM
z2Q~92f>MYmfcwFvl1XZkjVzBOaWQS(wq3hz#;eO`tX(^bsz`uIaYF!Yk6;fSJ(<nj
z2~(zELHi6RK5hxZ*aLtplGu35G{&8m6pqu6rG(r#L9h4cg(UlUx^w^cm7hO<Mq?)H
zoNT7qvKamv;RhRLB_W#HxK!=_ci;yf;f{}&!Cc6t5xy1?V0Kn=K)KZ${=5_dYWw^D
z5M?B)TKsNR0vhT>;o-h#-*5Bh&zB0HvLKZ$;qW*v;MM>#bGal+2@`%M3S$DIBr1Mh
zFarreG&2aXb*}UjYP;Rir5}aXygSIrchT~H1Bi++Ur>zzIM%GlV(_kA_YwNbgXY^P
z?H-oA_DvOq%OnCm=2gPZ5j$qjo%`v=D|v7nvX3AmY7<L4l}Ql*CF6<QNRkv}N%Z_y
zw$qZXHZMi$E#xuEdMAg;`g^#IJ_F619(T1YsrI!qQx4u1N_H8w3TZuy8+OteMWu&W
zJMXwMR|cx!KvcSS4;L4uh%iuL@x8kRX%ATD<klzzIX$NwSx%|p)I$erTL*r(o-_$F
zsf}{s(6!JSQ&@R&RDmxyvd1)<BFH|^+c`b?tTU&8sRY(@sN!xSx=&YEb&iG1Kxs@)
zM2(0#ER{hT*;)q7T>0+Zb^b*KEr-HkoGLD>6DFi!ACA3PRP|7%9LDFA`%K0n49kAd
z&C$^rU;Zw`-4YgQ4og7MXge)Wa@oEYydAik$0^fT;xJCimY(fjE5L$d;SDtlKTxbw
z1wA9(tE_G2xs6AR(SW>Gx?C)#dzV^gDp2$!t)JOMmPx@c;R!I5MkqG6*Z6SM)u`%(
z+aQM|GmwoK$2wBflXgA$5>rd|Uk&hPR})~0_k*{F>XxbaZ=UC7-{8uTdZLH7eeZK-
z4ILHhysUEecIw`?O;_{sLpDnLXOk?DXLO~sgFeA@X-&?dGxVBUk>kCmDUGFMGc-!y
z*P2Ns3Ordd1o1tFX`d7RKaQ2<*u1?Pw$gdR(KfAGT_8iE3QH|lvB@5hwR7sL=A{JC
zP0ewk3N{`yXp>TpGn5xHF^ULgM!yE@J}u)W$Yh&Xm&l33K*nL*s;vx2Qca4^#Bf$$
zyldCW+oWW;k39iF)nS3Z*~olvr9TihAfyz1lx#Tz=~#-jBeZtNnKS-z31jMRh9;t{
zW5w47sylo1SLu}oP8<`MAd%dmOWRJip>L5&k!Y&w7`S2ESinRudxOt4<(%KYxZ3Vn
z9R>{;a1PZLez^EE*f=--flbp5z*^MjZGi`|xY17yw_8r_DI-}>KvMq{1S9~c;Z#>l
z(r(BLcSDDQBE{%)O%K{18CK&X3(7<m5-FFE!)S|A!VesCn|YCE$f*}4#P;py7*5f>
za*OeP<R5V(R}TSa@dRDO5k$hbP2{*=Z49-j_XDT8$ud)hXOZWT%=yaE_t3*IG-wvL
zz?hNU0l?<t96w&@pKx{V;Uzt{s5iT`B7QFJ8MdIU(@y&6GXANF@}I^`?Z;43GBm3K
zunA)&hk{cAb7{?&zP)b*JG&mKKm9v0_6We|_Y{k0_M=>TflM<sKfd_`Mctn2mL(xj
z!Q+nw$-s8DW6*KKz<ncRLX_GC$!AB3f3kx)pczV01aq>og|?~MI$I1M;N1B2`^xTI
z4|@aZB3mH<z;ZzEjh{T~m3B|AuaZ(BVVftF11CX+cOMlU4&%KjS9q))-^@*Nf}#VE
zy+mT+^og6040i)1om_qA3nc~B&wMCUI4v>igCPloO-0g(H)#w=hgm8}qpGpNajre|
zt9w>l3&a&;Fu%bb(P7?-U1UO;SfCLW86CZmO{Q*?KR1!N8g?p`fToJxRXzeVFM1Cw
z9nQ%Z<>$}3w7VQeTaA+w5Zd)U_0M9A14&%)%{qu<=s`psm)<i&mlVl7$$D9u1?uIJ
z<KB#)7p-%FSy5R>N8u?~79+1HLdE!8QiNi)7_tEROWBm392HL*aUHVB8wp=?`<8bp
z2KZo=d_GQu?sb?1L_@v5tg5rvs5!91*e!OG`dJz1>&uea$)oCm5g;)TffL2_^gq@2
zqB)RBPcdsnk6}04)yx^i*9C3^@Q?vNa311#PR21#hJwETYC8~q!bu8@xlLA2{Yk(e
z{?xW{6*k{SQMtBv^aG%|x-R!gp0=V5*8FNB7vUB$VHP<&T!+{#1icV6bc7gPjMsQQ
z7<i8=RQA}TNXWST5GMKnfl(lIe$}S^Mona7m~p*uXiDMsL6AT|f6=r!4<dO+<!P5`
zvKwSmRw!U0POsaaCd(4cpBx%BJl_2AS$~1fL98xPHpqM;^NO0h8bX7$#$;t3tsPfn
zYa&M_byN(}NEAl>zQnIYW5!Jt2lJ>QR;v3rB4XOb{S|>4%v;nHTf6?0qC%k~$l~S*
zr2tBV9JL)iHHYc{dfc@~?--**L8z<6sj}+Pl}<y(Ci%OhztVz$0B{wZ3F&KTMWk&3
zN|wPkni!luWDx@&eQecd$d79Pc(}Z25p%%CMDAi_Aik6<dNU-;Q%1NPIou{a{mq~<
z^56&7pQd}PDH9F{@HWn5@!phSVzfhjw)wH<sXsMbrdyQ6kV6zW^^&-$bB=(b(e@rZ
z?6rrc84R}_`uAD=*2eg60UAUs(+)QPzIGRS?C66Fr$zxD*`M_BOdYbRqpIqA$k74F
z;f*GY-HKJ{x4fm(s@aP41IsjUJ6$=-2wwaC!p^QLlxiBTiGn6y53@?_12qLZQ^}6E
zn2NPAO-ad&rTXW9OGV;Hdu!-_fyHHGsUDaw6Hnpi*DJ<N!b%A17+6y)8DJl}M4M+U
zzyk2SEN5jt&vk;*&(omq@@2&1pFbxWN79baX4UhR_^BZqH@48z(-V6$Zb9VUy_1kC
zL)AnN->Yd|&1YbY(o(BU(tDq<`Ad3jDl9QbLd|0{tJl2Qv(FKzkV@!s+MiQ7+hp}h
z>m`-`&!4gzi;hB6R&U=<K$uKGX3v~V3;(xW{Ut6ijNnIM&(iSu11AjtPmK6EP{{-U
z;I+_}6MFn}_sRz%#`xVSYgP_cyTX(Onx2gO2C_#ufn2T^qUJ<GD`Z9Hh>ZXp`?_<U
z82=!DT2<?(-or@&02Zs*=;1aw_>x3zZh5Hs?cIsO2t`)hVt8^6S#c6KfAqIuH}{_Z
z@@~MYqbfnsfedh?qQyjwEmNYNMlYc>GL{EB5wW|}GZ1iCN!rdS?&!o$=&qnf6nb?)
z=@8*jFMc|Wr%f^VT$B$KB(H_+Gc@(CvT6+nomB%EPNml32#U(u98wNYMw^%dn$T(D
zcQI#7Np^dT|E*?4MFk+ARL9Vky?whyug;sYmX}E3CQB{Td;XMAC~J<%^Z;fV2meEY
zVN&k^@N7K@A8cag!DDvEM4`l{YMzb+1hgculnJ=@Y^I1F2nx({6iwf2?xztPQ|+_z
zIy66j1S4ndz_~X2K6lgrIyatsSy?bQAX14E0_+mQe?c*mm9GW^tRf7UpT4hsC#ge2
z?}gH4HiNbSzl<KW#~xyb0;Uv2y5IvzAyX3T2QrEPZjIH_k38Q`fLk(sEaMFL1tUlY
zE^3ZKjpKla*tQw{Vuzn~U>c8@^zr!G3V2ECp8>S=(#tdIidxHVj``;@dQ=hlFB{+N
z&b@nj%pT!$#GGGNZFwpVs+>*n4uOf5H7@ux7E;YR#s4zzYDYUIm?#uE*~b;009~QC
z-@v`|mHT!T5JfD5X`*#X{t}pjF^_{Uue|&F*)POB^t{bKTpAHqfTKL8e`6$=0VJDr
zo`WtU8M2cKRa?XS<BOwOa5rB-9Uy}KDC`hYjP#!V+sQrpb483>(KVo#IITk7?$^wS
zBP%!(a6rXum>pH1z}qo&yeI*ip?f0mri5$bt6kcmO;X`FK}dloq_*H~>G^gWFa9_P
zLX7|JrqusHC}nC60WbP4Ls;Ow5p)XT9G_Q^IYECEwJn7osCFX2w0JWhuaode$1kEL
z90|7%_X-u5tpC|>fs`=J`{;rr3`1K<QRy(wG3~#O!&FNMyXJwp^2(m${zEuU4ezDs
zDWjo887nF@t>Pc-5S39-%AfvUmW~`TB23*oN|s4-Z-izi@Y$A?8Ab&lh9u6s%6mO-
z?AWnZZ~n=id76Q0b;xVttOg>!gIQTp*>ZY$ZhZJQEen3Tgy02k`@<fDAw+f__C}iJ
zL=*s2j&U%*++t^YhtE3_5@g&-rWt@-WM^5Erp<5B;ot(N={q8C3P7Rke*&ct6vWA`
zfWm5vhG|EnS|G>RJ;)+o!<$;t=5C}9>d>P{f8Q+*G#1I^3U9yU?Q()Rm2z=pB{2#7
zd-<z7w{NSSI-f`h@JsVCt6(n;GdT_CzLl?5t?blkr)j6#cN!au?_~vz^4~Y5?*^;h
zgHO(wL}?-t9rztwfn-Y#7ca`SoS9EVF+92d4B$$O7OQMkV6B)bfE_?>sfk4-uQw(9
zlUugB<wsP`FcQF{9GCX$>aGVXXPj9TO&KksZ44om1nlBHG7&woOKCG*LujB`duBP6
zH!r0^#{OCJ&`q>}QB6SJzNJyAZ>Lxl-7{r=PtG0E(qL*w=+UWOyDZvi48I6QkFwE#
zbY+-sfKHA%V`5QH=v|tO=rXmdAxH|bcNNDNnNo%?7NA?img?#m_wEelGt2N1{u!bk
z1&W};JBJWi&v(!U{FDkWU24YY12O+W{>p*KalHWKlxD{1C{|(hn^btOq$%}OG9pCk
zu+2Xok$Q}vU5HQuR}~tc*^1~4PbT4)@hC_LXh{DQAGqqjT;J+>JO2L~XT%QDI78h5
z9S9|Xp&s#71Vi|2dYg_MKwAM`oqycyQ#8+DDYK&@#bH2E_EQ6DIQrOpK1^?l^hKny
z#PwuK7={oax6}nW;*Uad=?xn;EvvDiPj3-_GdHu7W{O_TFuQ<xV(`y%m@bbdz+I<N
zrvd->7)JRM*?VbenY}wux^Vt{{K-uzJ)&H|g}X2f3^ieOeFOaE1?~jxr{S`n^&A|r
z)1{(AI?|aJLZFvrGZYSt0lc4ebC_S-j{Sajbo}RTt0~zb%vRi6RYxlz8~;FyzX4jx
zwq}qC=V?EA(?<yN0A|eP@Ba2<>Q-JBc*(aQN+XVA4|vCva3`Jq{kNf^VW-n_Y6mf%
z0_ST1%*<je@YhxpViIsqkh^li{gJt$H?@Q=6t<Ge9A$_jcFFvy?38S4yBLy5H1s|S
zfnU{^zApA7%!bg(MYT`zF#nb&@;8R7cheQ8CtGWCwkYqwGS3~(J@N5(L}Oy$N|Owm
zk(PT34UrC10b2)<eJACf3Op(j1bhYnCEVF%i99L{>PdXYP}kk{*--xkVW*%zVtW2R
zbGU(C6Ha>XBudlzZV-ADpCg$ICQD%YguA3g^@>2d{nRW5N6nmwedM#)G&9w6m?k18
z&RBGNI`Av~6*U!>FfB0e&4@e|xGHV>@qXfK!8)hETa0wW51e`hfuZby<01cF1%}4p
z!mV4%TnvO?g81TcXVYM)+LI+}3awggZnqZu1wCq9nc1LYRmKOKDB!&8;5KLet}NEY
zWBM5&c(#8(UKkQFJRJotrfZ4P_pE!)mWzF6L83ii^kT|_cLco;*G-;0ee-5BbqnzJ
z+sCJ;rgr&-70>qcyhO^S*4rU<d*vXfQcc%m<Qf?v_^*(Ow8=)+O`H*xgvBd%aF~)4
z6Ya~+t$=b$GT6^(m=ojyXMr&eyHC5Pw$gjyGjvU7y$S0I&F>#+aU)@>%Tblhj6YIw
zh~qchH*Mo)O3|xJ#TB2sA(N&M9jUe71D~^9CIV1ig>yiXku}5IjMbGMp2l4W#rES5
zajs<Wy?MLt*Z2d|5Y<ah)xUpD-u}5{V0!p4-?vju4s}vh<;h6LAdZMaSCaMIZNuUX
z`ggG8s*n^^PWx1ao%l~bJXps@CA4jCwqhFqN^L>o&uxqe|8hR-7X3Gwh|m0rp)U`*
zRJ_wNMPCJ<6@750zb7%7#sQ0HOCT+$DO0x>We%>D<p-bu6gRC&hlD`j-SH<^BuBEa
zM@BUuz-c&ueRwOGU;Jzu9#e}-WTQ7gkl9sMksw&wRAguNZ44-^CKkGhBu;#<P$eI-
zyg3*^2~!lXH5PQF-kP!45!xIiYAg>6n<&{@Z<yXYtpy@Cs-0;`p}j<@^M8N><9@<T
zz=6?miY*woNDLZo-prmb%Tjcp)Dx7G9e<pJ3nV8k`RA4v6Nj5IC_qfr<6X0F;NExW
zXqd=*^1U<k80?<&&WttKyFH~V*e@&JHB6^e?RemIZRh&LL@lsXf!X-T8As3l>JM;H
zCgB;}3FxpkjYQ2-hijnqso}NfGn~?sj@@Y}NrugnevZ2$qE>byLMo8D84Qjxe^dXl
zrWOhhiO#y%9k%4OPY+$c6nwp;*758j)#wtf5#3mrJ$?H96YW)hzU!f;_W4GE2TRnL
zv@2v_g)&MY2^M6yTc|pM#>(1R651;W#>hdN?N;$UC9#1fGX#S7h=qaO%>QWt>dQUg
z;%#}%Cw<?<-2O;cWrU9t4+Gu9>Njmp7{?vF-zJG{l-=h3iq8Y(!h+T|1+c;sPBu7R
zDNr!;#Em8GOPeG}M(@*Z-Q6ZB4<0-?dUyy=N7&X;Dqy@qgb+b~xm$OOHU)ws49JFs
zU+wCvEc#jT1^~<+%uO{+Uy0CwoG-jDn*3B~mtRmJ^Vwi}2oTp%AW_Nv*9jToDka>-
z8;f}fwvrjaprQH2vXXw38geJS1RR8rm?HiM1g|13$d2PdAxh>(I=Z@u?A6YCUBgm^
ziDaKyTkq=cC!>1+MUfy?<KN6=CPd;Eby_Or6*<kqGjBugb?RNli<UA?=+L9&{{7BG
zI{LON_<`VhhF^zZr2GU~(?AD>_kwcw?rwu}lKOykr6SW#9Uj6!7Z@T<Ne)?Bz%35t
zlOOr~rVkYK4tM)41Oszgw*K`*srPV;bKaR&pNV-J_rDiJF1I}M=yKwMI2bWjod~`!
ztr~@@{jU%ioSV%-#?&J1vG*4fHkoN7{QBrQXZQ0K#zTg@r0TQkeZARhyas5S8De%R
z4f{IP<SmA>`pZ5R|A_yC6OnWD=v;)3Ry|giJhfC(avKuXeWX(IShHnE3*E&+lrw&j
zVE^P>ov4G3EfRo7^eU9Uo?gB0!TSk0M4p~Ud+Jc!-X@(=nPM{%y5pD6<_+Ou4pV^8
z!XjTfU{fopwdTxzM@T34SqpI}TUj}A4~Q4H1&Wv1n<9p~>nrS<nk=qJf$+j1IeH7*
zr1xk7l{-SpIWNCHOMo2{!AMkPYEs6H@0pZVO@kMr0buZ8R#m49VLY^HH1lbT-d*PI
ziuo#7mf;>3!?b%y-xPsYuU*>$SOh~WUgF$$qEPg%{e{FG0kl~5I+ai((*e{`xE~eH
zIK6x;qQug({;LrsS}^TK+&^DY;Z{9Aa9<2yD#}UGO(~816Cx9xcK;<7GX-A)Rs7dh
z$~o~tg%$QZR5`Lgm6Gn#hE`41@oR*2ZRb6=Pe1SxXd_v`OM$^Oi#okA(7c%KK>NbN
z#rpi_$Y2j8SO3pTc!}Z}A(JNmdDMlN%IFE3t5;T5QUl8xZ(fXJW=p3Ue5nukO=^Gr
z=FJ0~LBmPT4G6?HFmUxAVT!CYiN42`ABtE>^d=BRYocE1l8J-A9?8u$?9?WSW-Ju|
z(|d56JYEapHdYJ~5bZZJa=}v+!iS8nI(SpVW8BzOk8PE;_KWunSM1-_5zgr6!{1B4
zp6Oe9Yn|2R*_V|!SiYcc9BOKciw<+4LY7-4oTkO&!+9cI5Wxm->2}t1lS`^o_ANeJ
z*PQ17VSDpeXVNpu0hDVPVj!4F!G~qYhj4)Mv{n9^$BP~w9k1JU6<qUG>Ze(&w>CIZ
zNYC2U{JR!bA&oZ{j-`bcTUoxR@trMw^QR#`f_ZTMR=3#Mv25iq0}>!9ngP?)GJB~<
zEQ8YCw`WhwP|*+}!*Y7l{;jS|azfr5&dqh_G1sg~*2$w`m;Iqssf;7rjh{&C$C;hR
zL<4T%bTer;xGg~YNiwLla%Cy{CKwYJy7rT&roY2}4L)QeXH0EyL3me_LyrcXtpGO#
zQ50<+c|nK_fa!CLm&u{KCkXzik*aQPvt<Ds$I;+}k<i*Oci6qz&CdOLr>soIOL+aY
zkl->J9euCU)%^r+p+ybyWcLV_5+4Q`wg8|~m*6n|_V430Ti^U+oBQQ#3L_8uZgnUH
z)&-VrBSZqF&KyKfFkJNIHx_Pd1@=k~1pKG7J8a^nIb~{1y!L-Byq$LcQz=4H3Luf%
z-K-eWFuo<su%t90M}hASx}9-7m?NN8Ln_r6J$S*=tw)F7LOeyM;C=V4D<hB!vL8Ei
z$C`Zclc7)nJgcccJxi40t25=a`JaKO68VPAIDN_q42*5e-x||#OP8i$@%|(ODau7$
z96w_y{%RPN;j5P@#QAXFFsL13yz}yjsXA;yX4ur78CUQu6h!)|1VJjnV@X9%Kr~s&
zVfSejugx7_2g8%4OR2pU&+KvNU%+6q|Fx;vCrz;O!Vxlo=b8D=vUuBg?0umryhoZ1
zVw3=z4~NBHBE;HP_EGkJDI|fSbY2VjLlbacKzZ<i*JZ0QE|nUyh?F5LJsob}JAS#$
z{h~t@zL=Y0nBIl=MpGvak|$jY`sVL${o_Kr(c+gWqC8||lDGy9Iyz%;=;+m7S_1@-
zk0$bgc!|0rMs%ZxOHVeq$ie*Z@#6)8BGE~#-tm?}P}uv+%z{A8`oB3AT=T6C;eQ~h
zK(-Q^kd3`6%DQ4?T~CHjvzx{nMfNZk2@%8nW)nJh;vs5NHE?Cp5AKH-=2T&DA$AJ#
zB5^C-%rOONquG`TY<{R>t5!0OY*P}6wiXmD$~b)=5djrQRO8Q@0Ay9NCYOT$a!E-g
zg(;N=42(6mm+%dxKmJ*ll-ffENvs^%$6k4r6vIX$<b$INI*?8-V&RdRhrS3ts8vAy
zhZa0*98xExe&+E9=ia2`WcHboSk!OS{!>pkw`X3C*ODkbgoeh}vu7JjTMR>@=!3i0
zhO#x&m&Vc(iM0*+AlrY0$=7$qw@cSg+M_whNvl*rL?EoHn16Kv)GXBiGF}lhvYXDF
zR0SyRFvDI~B;`a8@n_%&8+;ylaGyFpG<{~A*iPf|fp}2<=Q^y=bl5T@dy{N#e(>)3
zY*$Dnd+cbEoZos>KqPN9S?2BSorIMs7h6<$_HJf*2pU@MyVt>zltRbP*(+lS(S&w~
z5o&$gxv6cd#2M2GC$!NZ<FUIItm^Un?&DM<G1RPmmh0g3o@X4vu?aVtOxNjtCeM~o
zV0D3{0eEp3KhdlX0<!CnMOeQ=#daKkUnNiP!{^VJxJ=b6lzg9_YeJ8A3G(iuELw+_
zL&d(MEJsyp6(-wdOq$ds4LyzCg%Z}1n4D@AIGj&Q0A^3v!qje0KyYbt3VerGZ2SwS
zKxW?&u1;QmWz=qpOWT+}vLsaWppj<!T`7l|c67KJU)Ro=6GeVS5~53B0*PWk9f8iQ
z0E`h@q7)MW2vyB5)_XC6klm(!ZC9++R=0bY@*B+>h3W<J7|NP?jLwprLxkW*a+XxA
zhHRWLD$RT9i|vKG_RC=IY!8o~_DS0;&~PfELP21|Q%pblC7|)gEHb5B9hZUqLH_D(
zNkz;sy@dCL%*qoEl1!Je%-wGR+O73~!y?m4PhL|dxg1o5n7cSXg6eFILG@sq`W~B9
z1UGo+<#QSr_6V3BlosB0=gu)ss{d3Q>Zs#Tg1_F6S-X15qA3z2_lp|Lj%84nRGpeI
z8guN=$6?5PXac4GcNnK)vw#{9l(=fEqwLkFqsnylIr5GXZiXA`%LmVnn-Ic;N6t1s
zI?8}EU%2PQW%1h4^&YO4@}atD+teL}ckLyb89Leh-EuclMtpFYqw1oqZn?qd4V4Tx
z_37)^b)}E54`zd;^n)BNk*yBDVOmvHB|Gk6s#0@JrjSEq0SoUrJ!S8{HGta1905_(
zU<`;>L_VKLM9WH5tLa@3(~8E9?vH~Ez!tmfbj|X&_sw99<mKVTY}Mv0Z!%_hyk=By
z!4XYNrY`6;kEU=XCPeA?LYTiYMjXO(xk|04w(~z1n17Hh9H1mlqZUlkHw8Fl4Mq0t
z@@t(o{+}iWoQZxU5L+1THl9WfU`*i4@GLT)M&a%MK8NSo5?$EUt4eg+qJ~A~5p_0P
zj63*;o?skTiDK{D)Q>4M`n|$trI)_Gb^0`?R3K;=-=BG#pBTq&;RZPsI`wElBZ3pk
zmEe{gNW0-ztB1_Lr9fT8N(<yfFA4RAnSD89QU0iV8Ra-Oqkio_tUBfUDDC=`rbGg7
z-zLd(jMPpmYjsfNFCOv40HSwo{Rwk#ZvM|Vk8-e=M!K3pIn=nSewVssUS6WN^Zn!P
zR0k(l^1P8healKHzkQo+O9$uYrVW?GMD!iu|2>M@Eb_;poP*|ZU!Xgc)z!Zjy}VVh
zYsAXj+eZXFq1>#`e0G}1jF{=@{bB^66$PVEhn@#nc=GLtnf_@RTZg!~yUNy<BA32#
z@tGw_2W=-!n)3JS191OU5wxFI`%)3XxqSnSKxHN_lSL>T0Y4~_@O92FXG|U`S95^w
zGd9)l9-odyfyU=?ec3Bhsm2ePKB}eHIMg_2I0<JAb_Wx#13WC{EEdZGbI5ch&(Pq^
zGz({*uprG~F#E|zG+_~_5uklj!}S!a9N0C3GR4Mp*d6)?*|*5PR~z4Ml;c?J=|51l
zUniTsnEz||@uaa9$cx%iw?x~zm_`$IM#P>yeSM<>2ntmA`{!%;lbZz@qAcU;$})xj
z2Lsv0J@Q-IqnD1(`+rJ%Vx>{X2bCMa^o`?#auK}aME32*u31zFd@Z|adY<23smk_R
z#2K1%lC~A|Xhc|n1lcgllt~?oR4^{mbBZvvmOSWlp4-N71uRlLkrI7@{^!-^&KWF*
zV&Kc6SXq|PVxeEccyV3P%_k?8Sj;i0tM|X24{ZjNgBI@Whn&d?XB!Fz4;o|JDk(W}
zj>U$HO=cr&2V{GbHGLYe2#vBQo|s|1Gt7C~y6AFn{$$(1_lo8giEqUd0O47UzX%{(
zwC$!zOn)5*?PUoHHEWmlL#i;7NiEkV1R(pEKVKO(`^b@{=}VO|qT#14tQywEjIpr^
zyM64t{&e*4&_-A*OO2&0HI^;cm3lK?8hNL5ZTM2*rFaiAHs9k@^NHSoBiP04BwuB|
z*!BsI6Ul?5J%pz=*}e3|W0xTW*%(M(kwvNuUr$2(lM=rFFaEBi7IHZq@HpZXTG1_}
zyytY}0MU1V*d>v2lkga~IJxM(T5zro+D2Tj4F4FO%|irXpK^J_b@B6rwq5$qt;E|c
zdMA>87>sDX_WSEz7^l@|4|X)Kdj)6$UC3%qhjA<W<06>k`-xsl7nFkIDJTVL7aVD@
z2r__`NxA5oK0N#g*u#}=;x_3O9erEmdjJ*bFIG3=q|1}}p4G|XS(Q#Hr#KgMKJ}IT
zF(OsL5GyCb7WG%CqklJgD;tCWke{M>GR&ls@RW^vd}1M0q?wxbhj@>@J(80nW8z3_
z$3V7wd3YpGxqb*Dtdd{GacbDc`~pb|&1q6<>gVjPml>E=bC6Ab*@L5+VQ#)?QGHQy
z!_xbyA<Y+6v<}NJ=&hskV(Z_k4YIm`y5leQ-Ck0gnh2nx%(6+6TAZ<GSlN<bcjG~W
z0FRRY$*ZmIR=5kZcw>B<sO3`1CNS5(=IdiWtL%BCL~f}|lE=@VeusJdBo23wAEhe>
zX;ZwtGagRPo<I_&{RN7MV6cw~nukM92w5-=MoZt18c0M2yfrV94O{x+DAS+4eY+(n
zDCps%k*6Rf1ma<Hkdwnr_;k<=+CyiD$#&r|$U?Rqf3miOYzu>OPQU~gn;Z-^;9X@t
z5(9k5>EEPA_lS;1a6rM%D_Gl5H*f8?XDw*OH=s9Qnbxyp9LkeEnfl>w$^EfT@Ac=G
z>bsli9*k+dn(6lLf@>Ffw+LTGoKHWk?tf3QYBN<ib*MYJoLb~qL3VP1|BoRsVnwhD
z6vLeR1&A;IuUvw}o%N$3rlg7;AcDQ1`bqzkZUe=>=GCWLQ+XCF5Y>TDN?++T=UL$f
ztHv9AJljFfEcN4Vj{32MG(LcLK-J|m#Sf^E!m2rJGBv;R6qXa4>Hi=v!^bL3PwcCU
zj2*SY{vmgoT)%#uLyDc=`*vc3&-f)BS*OQNsT90)wyHk$Kvny)vbJ)TkXm~{uP^q0
zJG!f7!1tEBcdM#2T}O!pliyJBQJ*(|u0-!4%Jxgm>~cg{Mg;nR1BZBMq*p3lx`iG@
zXeRvB#5W0gZy0e6U32}LpZUB2wlj$F+Ut`ft#Op@_>dx)Q^4QCy@y4=*pHtYi<&KD
zrW@e^DMVGn*)D>OM0tNI!&vtkIIsg>3*CVAf6JxUUfNufXOAyNw@7>>b|O@8?tqfn
zkAF_vi}8wh591IHM(w@C{sRvR<F{_q4kD!gw2Bs3A{B`h(RI?NRe{e(!dnrz7>kg<
zhIXu&%t&EotugT#NB<&eQH*|hO|rW4U*Bw{B?uMh&IM$G{lGeeU-!Z6x@MrJ{#YNM
z+}kye0Hdo20!&7wmlfC2xKj!n?s@-3j}BJ`^%z3kL%fJgNa(+yyIGzfha9~X_1|(B
z*O~DDVx6c48D^77APnSWPYzAR;(X12>yV+~TD|)8VW%6fUi_$iPS&5PspMcmN8vfS
zBPM2l)QAijE)s#rrzg$sl1{|th&Y>e5TUUiY(Kq`a_7!2)w>J?!m3TClM-<>gp!R$
zY8hRE7+r#M?HGQw1>F+ubqfep+=svY^7h+10$`vehz;{4AE68kU)-lAVS+|hdvWz%
z`JHXI^2^(*0Pp$djxHGBn_;f4AS+H7NUSX?XyxncOIIh31HjgmY_bI@gerL|xX}#7
zmLedBYcQ5++ALRH-)@OJ2@qh6G9w6z{Q+DCm8R36&tLDpNoP|vf7sCfc@~8kRAZl0
zrFqoumqrz#vEBUVBAG1&YAQ8qrp9pHFbZ79H?O0ay{1i#NqcazkEr;dbgWEPh<5UJ
z?;kVg2HJ^LmdyV#2Hp(=jP%O1YiQ|cj6Im-HC%AaDVV@&hs^=|ANEDAVsyVRx5WAN
zhS6qA`nly>b4Xp_x5#<V|7$l$*!nea;pu6`z%^aAZ0a_2&al?VEECHkrjBK5iDp@(
zVDL8S*KhVQ)9=rlg(b85ekBLeGZE`6PLZn5L7E;TfE+y5RJR{`0rrb|@977uQ=!3n
z{vflrrTIw{v`sWQ02ABF>{Z8twore{W>O!B29(_IZxp|(s=|7-1k<wh7=3~PIL+TH
ztRp;HJCr2?DG#b^>gKj0!zJhWLX#-YjjUjnsP?5(EuTyAT(5*R+Djt0P3D6G)9HdL
z&p|qa{}`2~xN&-U>7goem^Sl&$<F@r5B+rhv^c<}U5{T$3!ngirnyAr*+g8QuM)5R
zxtG-y%p0&!|HTPrh+4S0Wv+M<e5A3f;pKHrl$G~wueBn{U!!f&=O6DwtD_mLU9zYm
zKMvW(U!b)(vdC^(7=W-gS`oA@A0PWYF`@xSfI>x+7%WozbxoRz$vYelys7HU<hyt8
zvi8zwPT}w5Fo&hGM~a$?y%$rH-i*s0Vhh$V?vIcUii?*c*Wt<DT@^@6F;14b@vy4l
z$ypqbG*;5O*~*KvhM1p(xG&_wI_DnRcW@IsPSDf}adEweD-IiCI*o3!Q<kN@*k;Lw
zbs|nl)zK@pfaJa+v0%j?+CO;3-m!Pq<0kR`!v{77HAfKxu=$t6i@n;RB$}B1vnHVs
z5@{lL79H5>e=eTJT*?>rnIN<OliEk_s_ZN!s_DO2A*S@bd)qG9(Q317-{rW;!X%^F
z=M<nJw0(8Vno+sap>KY%V^OpLj@v;ELt;y+NGr;u)(wY>hYTE8Il8fq;^}=;iYt*C
zb5i)SVok$%4NC6zj*fSdTI~lyVop)?Pf}JK?vrtkz$6PlZY2hl*^jajzg7OXKvSuX
zffou3Sv`0T9LjU>znBx$6sJHm=A?u$f)@b1!>;C~5bO3xap1f|XoR;?RaKHsK*TOz
zzO4V*2$E<ra>O_$hFAC4wX2oJ@N?M(f!eE!P?}F;ib#RKB&NTj+GNZ%GA@pXr%2~=
z2~F-2tCG$n5HU~|Tg^p_4pJ*QFq+m8UXdseLXjiNSPBCX%Y9!t5)Kvg<T6*mA?f7}
zLX?!YoU}lur&LswGI&{Hpz*7nw+UtKX8OBTE7yU?Q)~3{Z7un2@x=-A5+BLlI^K>K
zJ^`54*;NlU#MkW#@qdZ0Zxv5`TiKFP_Yv-i%^oWQ4AYNer@=i6h8(r2ZW$(*S=P^=
zUf!1;mZ`R>x@|5wKzPhyz(O>T+!*5}&n=lGy~sgavUI7eu9W5ro1A1>Pu0ilTbgdK
zUI+yeBTpZA_x7zwwb1XSo~^9FT~NlXII}{|TshFr59Kc{A0i)_3gLholy_Pf94pC<
z4+#d@J2qeko3PfrkE*DzUqd@aWi?0)C18D|No15SbuRiXVNaygp#<YzLCki<hEEe*
z>fpgXz#f;ddA<8(Y!dM+V`9?{r-<GwYdl2dz_AxR0Tqd%bu+qQ;i);~+hbzBRHQo-
z&kKvCUlTi?9z7;=JJ{Q7NM8@4$NI=1ndps=H}q|-Ajk9e>zCCjps_Nc#M6mg_3l4Z
zt$=Dj_jPU3-|gUq;FiPQKKz{TG`MlvXf7|2_%;|Env}4Ln}U&pNf;cAG0a=^AosqB
zUW?|<e~DIc=K+vU8*;(U=DEje|Kng~v{qz^%Y^Jw-qCl>Sj0mr?c3YGeI-lnkohfJ
zc2vc|zne|%_o*Sw@u7$+TRz_o4`84pG#%CwY$77gbMEm)5Fm+(iw!<K2MpMbOjATp
z>B(u9G>23x;x)-}XI*^I9u^Q0jzHV=j^;%-_S6S6CA?w_lN7ls&>eZJ7&<f1NfZ^y
zK1P7?^hC7E;B#$Iuh_paRiA}J5<5D!BQa*8s8s{QIt~ekp(cy~0Ys|K8Jn`IFZKcQ
zIW|1*i_zgC87Bmmc461TZz?h2pi$sf2k3&(h~=Wf78x98FO&)a9<&!d?LMednuRoi
zMfrZ+pJ&n;Q`*HLdf`*I@Fq~eepF{r*hW;#cnjIE<mIYyL1@|M4Y{u^)GfDe*&<jw
ztQ(e<Ap#FIyYiHdJkkEp$OEhYrv*qJE7NK2u94983i-P;+?ZQM-=6}p56R*QK`Ql}
zW#(GvEJ_N9TZih-=Sr47gyh*VJY=7?XVs5M_UMeJzHM$q<wG^I5!%K7`zNFxllrdx
zGwNb-!}o@F$DcSkh=j#3y=VR*o$LTlc6;r-T2bEH0&OdKjwWTiMyjRE7SmsW{6q{7
z;}g9%Vf%w!KL!J~abCo=h8n1BiPLlHpDM=SIAzUb$h&gQVY<}Y=%sjiyht$LL}~?$
z=p1xE2j9jdSoRf;SoLWW^<B*0FK;0LH)cthD61%6&S4R2-!I+*odN^4bAfuVC5%qs
zZ-l<IGt;-AL&r&QgN^qzmaT&sZy1~})@W1}A1Nga=SJ_=7LOz#v3<$OLD2fYMhPPK
zS#q!r2#D%)y`Cf~Iw#b^vKtI2u(t93>5nJW?=-Y~n()OsvaeQdiSgx_DBZqJWeY4q
zjhA~AZu#TAi{8L3#Y2M3g50%p^U|Dx>~{E1v}vCkp6C4L^N$PJdqck*nel4(*_!gq
z@{iY+Bz*k&=+*8YyWc!|wfc}P+ZrXB3%XnnPXvN^jvM`f+J$r^-AMMVg0YYcTueoj
z8%&n0HyRu8sh3&+#Y#r$lBX|Uh9ISPXYVUps5;&$of3nlkr@Cn^0&Rdx~o>Oasw@B
z`z~Fsn1<ZqKPZp{;_BK51093Dgly|!Wnz(X7~bQ8{{*XmPg8e{o-^g3y|c5`?Ae+i
z@<EW8&j`BOBjQuqX*~JVYjHrNOHRgc!k>tNr3Utka)mZDgF(H;tV@Nxcj{c@-M}EV
z;pU23FJ`5gMP1&2-pYL9#5NSAl^Rys$joI*PYwopqh}fi9y0J0h)Rz>YwSO%UYV89
zHnKwyC_pE+WZl(dUfXOod9l>)998t(>bjX7h?T*Je&jUL1Io{0oq4`T%PQ(=rsxZS
znM(m_*#FZBC?GI0Ql(~o@b-X{tG^z)sBVdV0+$87+x?rOao8&Ly`-(ne>%FrIi2Iw
zlp+X*z5X50>6J$4rid|`WAG`(b#leH_699lv|wD~cQAZ&isa=r6<bLFRNfu1XIqa3
zjvh=HB60Vc+tJ;8g_Lj9N*joSwg+F5#{zMfgwh`8KDeb;u(b)LJ90rSB&2?-iTb^J
z!``)~G=Hv<>S`0yuYe_ZHTuD2(-_F$gsck-Q$pDEq2cH1iU>t5<Com*%U7>PK4@Ob
zPX&J|WcZwyavI5g-~N*owH!97TZUd+{qbcR0QL3gS`rx}%dgxt6LmRSAt;Zg)P)sG
zykXY5N>4(ysOwNeH)ZGG5P16ZY0K(}haOwzQ0$2mfxEbl@`KTmO@4hMdK(%R0td2i
zDU43<IiCd{{kewie8eUHU^2m|%@)bMSQW?u#~PR5?KcM$ZQs4SPwA|s(_LJiLL9N)
zqWzV3=@}XB;7Ruj0t%e`7aRZufY)JXS65zWG0A-8IBj=rWySZkRkrmYD*4HqoB?db
z2h{6J3v-=R;2IIj;@-T44#7I*CEms&>&CI>*0$D)TEPn6$~0Y_oP?&S4c8vTLl<2J
z9aMg@Q##+9Q4%X!JbBa$M6*uU3MbcY{TNN>Bi~ibQ)clWp&>oL?4ClkyLWUzTapLo
zeXF`<OD)Uc_Cfj)D+TX$a&{J}R)xJzVM$4=nkNOtblfY)rAHu^=flhf6;R21{pL+8
zfaUmS)>o@=KY)UEIlE>Uz)lFc{A&H8_$p|PmL$}}n0_3bRnVQmvRjxtY1rxm7VI?k
zRAOerh;5N_z|q0yd$cz<l%;_*z)~%%WWoc;T!)x{%su}4?c3IXPfRP0nS0zo378uc
zG=%&HCHcaqi%)I(%7gqZpT=(@RDjVIV<Vn~^&<+(eH65%4>GtZZP2YsUjO&pW-|$x
zME)}#_|eN#cBi4|j;mXL7j-DEg2krIwS18tcV`G&)Sig-I#Orn_iS%I*OEtxH@R+Z
zWa?0QNJ3a!=_+gV^J-sS?<yPJemzsAD=$rZYBkDw9oRND^-bNgbL60*Lp$RWbRJ+e
zoB;7Y+_5K0<DLxO>kL^vANw1EiT2VX2k#B$K^@M^v!Z0?BMd<1UJ-E-NU(!U#lXyO
zKuv~Tf`hu=uTLUcg=EB8JeDFDX&Jeizi{Ela4W@hOJ*1p_EB)DWb*245hHC{7Ppe^
z4)tFP8pYY1SEH5tw^}o2XJ=_X=maQq2MVBUs?xqGheT#j{95OLbabbbZUL}RVXqi*
zf*|=ESfYsIA#Qr1Wr*c|_h^kIUEBYrPO!4}X#$DzzoA<e<*<`J?m;I&U(~*VMn$Gd
zTE1?`3Y9x{48dAMwtf3`GvBm@_CJX5Ueh_RqpGUTog*7#4t}?4lf=*SmtcI9;93b4
z>-+q|Ga3+)#4~Gpj`d}JyVZf`&QmXne`e@U_l4;A@Qf?wCh0hAD|-Y%16RG_7clzZ
z2o@NxG{(OewYGi}5`8mG<uRJdPvJd<VX1L3mrd!wdvn~~1JPcJ=+yY<oapVRbTCLk
zn>CioU)Qx9M&re-=55sn$%ek2qXW*CUDr-bNeSi_JVy|FL6}}H<A-od%L$sw2>04>
zxnF2lEutvxRr(;LWyBCDkbmxGb`l&lv}_@2dy##@;BeR#Xkt{-Z56dFS5X&e>*|Vi
zXMVEc_1m`{yu2(lAOqYA*7nWm5vpu%IFJ1_R50|J<B|r}cQBvp$YFvBH)6<vYp%=Z
z=JAN`nREIDbFXBA#(b=DxhKlzqb%AaS$e^N&LPX~WZXnpantbo*GUU-`m{p>YxD=d
zeD`iEMbG%7IfL<)z(yvrZkl@4T|yia`&-CqPwA}(3>x%;2TMs~H2;<+uD%MCLLt!P
z_-x%Yjj<D%?E0oHo{KXqX9(3|IE8twoYnnwYyH~H0w`kmeF!nC-|fGt5&Kf}K7IA7
z*KJNI{~(uW3*=uYhDs#&k38Ho>S*@i?Rew)5+{o}4E=F^AL$z!N=#-_;5_GC*Wu2c
zI~}AX;lWT)PYx}UQ+kG*TnY&i7q{|=F=Us_igCRznc75ybBZ;B7FMZ#s^*s)Wh*DO
zikRcZ)vw*6tUZkSdLxJ!QkoUx($xY20x)~{jfC-1BlR8(f;@l<BZ7BSkR-8(h??N>
zgD4~k;mhg%1lq-TY#$;P(@8Rt*_opJ9OT$Oo<u}EE??5D0u{;u#+}QLOr=CACGu37
z^yfTh@>U3s)13X*%;l};>eg7B&)G5u3{IA$Mny-<gb|U#zUdIsEx4!3Ot-TaLBjTB
zWP}m%ZBve;;hx9jl?L?JI4`gL){Cb*K|71_5jv_SPu6^Fb6v4lFVT9;o7d}j$u-st
z^n@+)Qr7jYpldWj#{>ZEqFr+B;e!V<jwLZlPP8n@JEKP#_c}ExDG)dfAMst$(1bx5
z8HU(x@YEuaEb|4q+sX#O3*qSWWtR9p+W(rN!O8~II=`Emnucb18Q2hjvD9q`D%B^a
z=8n}?qY&cSoTum3=O-(hD;jKkd&X2HaPllypuYCN2tK1%&xCp7t30i)rsiu!mGG8h
zX9i+O?Wva&5C6ov&xjc}Yz*Frr7jSxq#wo-qEA<TCCpHZ1=4Mx3KFMTo^@@wZWMSn
zAj)s@TyQ!LL}wy{OMZRKt^3j}Em@#^_tq_TVMn-}ZOxR@V4&fr@80#T{kx-V0RSge
zhH@?<lH0TFo*3I?{g`zqedUSzsYa}>|7HX;A<siWMzWchmdT`?atCMUOW@}3zr34H
zdHoc=ro-xq6sfoWzzO3UJi+@9mE$VxgE7i#LX;H+tY4Hj0Nn+oR3FH#L~X4`S?mYq
zDr3TCmX^Q&dc+^WmH41)NTc$T%S3-5v&k#iDI4w}=3*;;e95|Y<Ef3JR&6-vcmf8O
zB36Z{ykHu3Kg;cmI=4#b6Uqc;^()Somv<tJ1TlAgv3l&daUP&3#y?v1Ug?YKijGMI
zDhH8O5Q(|QT0468Zb|NlvREpqKvNtXAFoaX2K`=7i40~C3==Gd!b!!(T9(TYvPA6N
zdn46MRe?~6<&|!2m-|#UIjm0rob18});{xxeeUt&;?0k7rPxZb3a&QXGI$U$0j$51
z_C$}!n4LQn6&|_uSBwz)U?ZE|@LMvBn6{60kBMI;4!KnHdNI#+2@|7uI81-XgvOa<
zG7zwh8ZvJFat)M(bk*x%)#d3Xh{lq$@)Y6?gsC>%LNP)c>C!qnPKqIk5nx^j%}YL|
zh+e~P>eO*yIxEI;Lmb+AE9)9Bpi&?+$vT>q<JxCZbIA?l92}W&<LEb(85ZNmx8!K6
zWP++}LiKnaD8ha4_`5iSvOcI4v<`-eoij2r@_UAs(Gm*aNKIZz=9cpJ-`D`4!;s}U
zpxM6|@DU?J4(}#qLiYL2mG|CzLfdf0D^Y@K7rcYgV1=*(=zG@X#nYqYnWIAE(7WJM
zOE#t?($Y6D00HVqIDDmHC8F9E80KPG9!%U!DWnM7zH_I3MCD^fdjRw#R-xY!jcQK$
zuNW)~Dw$)vd}-$$OisXxWstc>-`T;@F$kZiz5^$3Qgy(?oakl5XfGNzO?FWD>6mYd
zQdCk3gj_DWdsj{$Ly4kRKubiP)EzadJ4r73bj><STsJ#P++k!;nf&s)x%awhn2S-7
zNJ2kV-)%+5`AXwJ5$M@3-jlQ^9tAFs8SBRl+QKV9OK%&}Of6+aO=ZQWH8t(j)YK{>
zEcNh!ql@1_*ag68PmBQCcu$OgU>#~|TFDzLMqRpzs%jt2sMNW^Y!mz4)6?_MY<r;8
zu>f@!Yn$z&!xK#u4nXO%a&KL}{L6xX03-znkCh}B%r6FC+eRV#Aza&m6Ovq2)v~S=
zW(ZiV2%h_5;GEdv3m2L~q+XE802cbdqJ{n&fOYxX-MVd|Vj)HdqQ>~j)d@#3S>(jj
z>}Ia*2U^~`E%aw1DB>Mnz!ypwBaKky!Uq&j@Y+F8r|-iZdW&#Tnu#F+p_HMm)dy|z
zYfUIp+t=J)d#UWmr6-lm7JjNZ59x#{5jRR>@WSD><TvUz-HOX>EK)$($N=~FB;WCM
zv|6p{Oc77XhGw6<5q0EI84g8vsmc>5rd*%fFm(wn?MA`^*>wq&JLNnFKuMmfr6whg
z3<!N64!*aMC%&ob7!$`_Mp>7P6e=_|B#ru4lVd?mgGR5AN^ZqC?Yy}Q79i1Ub8@=Z
zUMlxGP@WR0`I*iQJrlz!69^zuwBSGp6I|c^YJ2<hVZmRU!_Pd`u$uqddKpNd;-Kxd
zAy(LNa&eoZxZ3VhmN~T@115B6B(P?bH8)IEw1Sg~Iu;b&dR_al%P)tyW;C~5_+a^!
zWv+;CK>B5HUgAoy(>jT}m;-D8K4xG@YwA|71on8I<24Te`Qu&IhCB8a2@*JVBH&)>
zDdMNJu!Hl)H=!^A4{`@;yU(<is#?{nzRaq2;{&wtXbnjc!XY3skc4`Gvx?+V=C$?o
z^rYRf<Z_4pU0bUQNGKLeI=y;ruKHrK=>9qizS)El_mlqix7lM!StHAa1a~0$<@bzm
zCBAKpj*h-|EzoJEZsh_>D7k7N!(!Nd$t{y~$oPtkaUUjlBld2`hj!1FikAV>vX=Dh
zJ2o2~7^8U({@^_|>&I{hT`)j~U1n3?NY*!$-5BhrumGT8w1QOCx5heHd6F0cpvp6Y
zll6;I=K)`!xG_R$#Oar1E8K&4QmlE(&iZ9<whw;>2WiPe7s89UkcGDmm8KZMP%X1d
zdn=FDo!U($o3R8%u3Tuju4l96&D{|ciMu#Ml6_3toZez2#VOO}e66u?8rS+8B<$L?
zneTa?dr3~bz#!6wUwxmIV*4CG=l`@xf-atq?XOErT#HeCr^);%5}lHZkxxKOs9j}s
zm+<ct_Z1P=eHDNIO$<l=jM=+}?+OjvLw#}whj3(P&(N|+9dOaDghCe}c|DFPxTk9!
zdDWaVv?+w=2-$tEGbonqe6|2YoV))44?11SZNbWE%2Ix#WCp;~A$t#?LkF*>eNl`!
zT+rCim4Z~7cUpldKoNkC7x+!c)2h&?!%;ypH5IKbKPGs)lEhmBY!{du4WUS`(RY_Z
zL$EFmjRh^$%Hs5B;L1XLdrICODAT<91bvZ!f;41v&@_PZOkk{A7MTDeETX8xSyIFf
zD~naGGEO6V?m>*S2MtoKsHgz$d9JZpS-UwQUi$y?)&K!4e`r5FNM8XZvoej?CGN|`
zDHc(H9I{7%s`&ifyUvFyOx`GwIbk`Ug7kpRSYGL~VNj61)+}}G9tFlg^psN$2c(MN
zkLbS*`29JR?}=rvBk#XaF;|S3L;%39fYCMe8h!I4%nI_TR}`nkP@5+aTp<;oX>3q-
z2qiMg5ILQ1Ah(XlLI4W3-cElcT-dK%%z6F#bsUxfph29*TkKGk?E}9$38z5mBu=dU
z+7CD4)`EQ5U-YK2mrm|iQnSetaF5<%Mr}a-xAy#==c6oKXLe*SG==#b5Cr3#i;I09
zpIFiq4E?+iRK!u9#D{R5qq5Hm#%{&e|7ZYnVuW&?NM$*JE^{j*3riO(HyhP=U?Uf?
zlE#aB4;CQkj`%5qab0q-C=>D;+2w5dV|WN7YH#)(Uo-8Pt_O6x6Q1o_A8TjqJ}r5T
z#HnJAio*f`T%bYaACWce-9+vmM3j>uJ)WIAR(kGP<E01gqOL9!mXFa(RmI;$s{Jc^
zr^jG_t<HL-i+qZeR8me!@T@X|%<&X26Y&j~1H2BD6J4M?d^=UH3pI$y*oYD0VwPX2
zsN27PJ8nc$b9-K=Pno98+z>ppnNsLm9<&+IKvpP!1LjWLzrV<IQWkT1O}QySV>Gv~
zc*iJl(uor;hvw~!_M)c{vrD8YIV?~<Ic-V><uIB`fg<E1NlzFNyd3d9_M1rv8bCaf
zrxhwjEQNMb&{S)aL>DTRp|$m<``$x`563=9g-S0veXK2cj2)bc;;F>c%l3qXo2Dx1
zdh`!yN9ncRhif0Dab)>|T3Fcg(a!Jx^VpQZq&9ebD~$T7c?&>~nBQsjAKG0KMi<qd
zqhup37cDOMsrSVduuC2)QT#oe1M}wHs5I18&y*Hp9AZPJ+HjZLUg!C;1qeM@-*Yfl
zz{kxbNCm|C>y}1ljKA~k)ZxR*%yeuxd2(gk_}^bFS>qBRb2>2HJb+j6$^9O`5~UiB
z@1e5Uo=H68##METm#yjGFp50ICWARhvg8ec;nVoPaQ||P8e>iUH~T}YhjI?OOI&FQ
zG$KQQAiytH)m5SsIY({Di?7m1ogzh?q|-ga)hL8jvJ>LsS}H)AC0<-u?hC!6toXa&
zAd(_N2dQnE&QSpQ-ALb43F~7;>=W-8)0kUe9nE0GD6gI(OYq5=9K8K%YD&r&vbLeu
z@0|Qm0FW0?T^pew!HGjqM1gwAbzB+dP=BH8h5+?|6NWCQh;p*HqOu%xjKZ|9k&(Uo
z=x+8?ri=wd;ledlI0uLV61Sf6#x`YC`!hFVed_CtVp>q#2pj{g_a1C9=Uz2HBOU_V
zC>;wQJ?cg$#r~N%mxU68+>oWAX%#gCF^KMR9cVrxGSBBN{F&yE`kxxp@bk*l1#9-~
z-5bvPea7W6r*PTO#VTE|B+S;mWi40fDJT-#%{r~lx~jM|q2#&4I|MI<0E;r_eA1=a
z!QVBW<bIu@I(FvYPad+4vxuJ(M!YkJJp_g`;QxUQ{GAT!q>I`>jIBkwCiuBPO@>-O
zG)AOM+7uRM4hbsU7)>N|3OF6B6x7#lzIG#j1!JH2Yk#WC)Nbr|-HEDX!Wq@&&Xg)e
zY4*ur{z351m#sSZ!Giq$Ta&eoKmDY7pmmR~`w5d$NO!!M#$`6gP7s6Gv45Ixdcmuc
zWylU6hkH>VvS{aakL8;z;6cQhr~dtgcE-n5_lYY%NC4M}xxA-{*eGNS`Lj`LTk5_M
z*e<8JJtYV`Lb@Y7P*5OmP<`2?3~4Wx=P?U*f8(`v;xgIU+n<N^)B57dFhLQm7)8-~
zs3h6WhqCS8GUq#gHwi6+OrcRl0tO1;L%m#VYLh1rAO(@b=!)3=AMy~=;oMMgV#e;u
z3pb0Ck{%vAhVN}Skj3V_vA(<~+vjUlT7Ys0<VGMb<`AzaZr^hFS<jCrU8ei~5wP$L
zLFoiA?%Bo$f&Q=EyeS2j&&Qs(nBo?r|6f(SvsCdNIB~PVxjPjkrC+8IoWnB*zxe<n
zKp|jCEqLOm`6e&r=zPL1rG7`eZoq63$_DjlS;=RT>Y60^7b>We^Cz$tS=Rmmb^S%!
z6+wvfZojAQ-*0n?%2Hx|Qj#|8zRf{jmOHd8>WuC{>)!C^Qcw!mh3*bHhU_M*u})DU
z*HTY=dfnVUxX0+VmaeYxkYXh)@Gi_6(*6cLDQB^5g^>=5ybkj4L2%iCrE|}f0AV#}
zj+S6%D0D@kDM`wInzf>qZy66~2~Lh8w+q)+rN)E4neG)ovrX&PPw}D`)Nguj{Ht%S
z^r!B5-o_oHUz~7`8U5t)_iq(+t)z%cG!BO`gsNC_F)(~_om2Ujshv5K8<2g0p5HLF
z*@}wCoii!ZrtnThrs1~;R#-+&E-C3?zNz*0M~dOwU9VogEOeb{mHxdNQrU@B2B;!k
zfo#OZLd~bd?zX1Qz)dz|xkkjHTTBFZ8@+Z$Kd)pUP5GS+mWvw|Kj%HUoz_^e7eMg~
z<Z2oE6ar3#k>Nn{Y;CxG24(7iAw$OUtBGG1r-)e?`ko7DUBJ%_oxhs-!U>8out(9B
z^<eaPzHme&xv!(Nq$=13IR#k}=(pPyFXpktRd|hu_l>&$PYa;qP(x3PXdsw^5G0|=
z8dsmAa|drAeW73xH3CXPgRiHkGi41Me*(w*Gv4I~|5*joh4#gal{Nwvfbu6nyQDVm
z1*yT&j3cGOrINacP~L*(Tre_NRBK8Nl%f1L`>fQ@!PlcABY%@W4`?M&0Db}SCX2=C
z_;&x+nMc~JGyIyEbdVf@AjOJ)fGNy<NlCxWoA=76hll;U4vR&2#cu$1+Q4TB%L+$w
z#Jr6h9C(P?R0M+N<9njSm`u)HfsXbF=SZC;`yOZwC^ar!zutz5^&3;qnS;YCaa#2h
z#FU(9koWb>(XH7f({;0wKFsl~yp>TDqPEql#PPwg!nyhq(s_O|oygiAmy@Hb(+^Iv
zN-#m25k^9AXT`*dx>{Xyd5Opbh}X$r4w4Z_rIftSUca8^m0nf*pQZK{2W~Io)=9gB
zV166&9~zV(zZBQx%G1@a+_9|zW^1CrRT>AHP_kxLdUA486me2p((x)NNSB8@Y$5do
zOF%-X4#j{R%SxxXzt3XLh6arCt_2=5cvQ7fKr1xmjmMD@RqwJver4XR<}2lBlW(8)
zyrl(DP>|lOv0)@fiZwNlZi^XR2!(~JTBFG<7w3c@y&q0pAa0Z3F_-5Kd?%0+*1aYj
zP9nJKGHlo|@rVDFUNQ<tF|D9A<;ErBD_A(<sQNKnOGV*6EZvIYr|um82{UKz;c0~f
zPKdwIk)uanXjte!@&Br^kQ@ai{5-~NuUkRNV_>%ns4K6Et7OGl{}R)1>v|g33C_;Z
z{Kg#k!ipu9&@vmKLyv${9>zlHJ(%CK6fu2*`>E34Dt0w7Mhzdsr@c3vs)cT1%jb80
z$1=bdmKSqE_Bc~w$oLWP(#m43XokG{?;7Pl90qJTUj$C%BBlfjef=R^U!ur;C;xO&
zAd{cET_UEokZTWQvJn=-1!TLk!jL(I!MFclHh3p<Vjn+zn8P;7IkKXT*O_hX=UiTb
zTfW$2u>TIX8^5<?OAk`)Td4CbMnyz^7eoi06<%UrDxz0~!=QaJ*pG;F6FQnpBBhnJ
zTuk%WRn2pmGqCRacViI0=Ia=h7zi-JfCYbxGe328*CLnbA9mC3(XS1}IlB2ewkPBQ
zndNZd<xahI^bP&-@fjrD&gA6e`+pW(e0E`D9B`N{{`J^mgj($$^u!c9JIyZ-gUg(2
zm#q!Gv8|*BJP$7NLo1AeztC06Qv$XsBx`PEk4&3xL+!NlL>HoP7)04=;g7H)w-LqV
zJw~mWt#F^~)BC#1gP})<dt9h3N>WRoKYh-?0Y&%8WDi&$av$DL@UESd|BlYip0ts7
zAC`xWT8!plV;+_~O=hF+zV`U>9{fj);FMqDzeSIR<9sF9Zdb=CQ@n5lh#uA7(m!GC
z4Hh|Px#T20{M)vW5P8$d$;pN5RinSfX!zMnzH6SGSsgq0kB3o%S!oC=XjIgBGs|M=
zgBBqfNlo};b6D7Ywv=8V=oC{7-lzGO*Sh-W_rbUZ&E@}E1n8A|96v<!m#p;S-aa7z
zPNQP$?6E~-#EQfBioL81zc0#SOhMr=-!b;j=|HKN!JU_BLvfh6M+Lf{|4gko4Tl^|
zgFbg&XPhuC^ZTP&rDvza>TC<>&|!!7;{&%}k~Z<N-ueehd&mlL0)SPk)Cg*|vTlue
zLO|+{{1F9n$Io2RU>B6OC9R~t0ugT!c{bl;lb8%Pl?Me5o(JnAmY4tOQD61?vu!+n
zwd>_p<Sl-JnD)ySzix>#;fnmt2pr~1LSy|#_GNwy*HNLD_7q!cfL+hV`j72|!I)$-
z>3+zD4HPFugvU6DCCf=SdZAl`Dmz9#&M8-k<rfY?#wG`4?T>dR6-%s}N&k0`VYRqF
z9=h^H-T<9tWzV|Pyp-9Km><n#tok%Q$sSvBuy!{_mD_xs)!4DdMV*fvJ}eDx?=xaU
z>S$*ti)b^Cx;d9G_4W0n^qck8kw<6~F#ia8;M@Hdb@4ziy!s$Z#X;>4^ATg+`i~fq
z@7iW-(&eMPH||ZdX3>8RL@&l!e|5X@(2XI^?<}0BiPNe=R2SRWubnr0CuCSWN@(}>
z-QUHKdY2mF^cmtuCXvHb;eeu1{)s6E56<{LLMM3B-Vu9dC4H={eZ_g3S6yBGmLN^n
z@dq>vEcE+u`#(VL`V8!+b|8Mpb|XFi$~QN=UN*eya`*qa5eAE=+s~E010bWnW68aH
z$0h{LclI^>o^Kyn_vG`u>+zQqSpWPb+6@7&ar1S&zQj+tl31P`Xw=)<CW%0Y|HT3c
zwWNR#;TFZmJ8!F@*)_7Vx@4SCN`Y~9=c6J<5363h7*Nz1d8#`ZF|`qR#Ka44oX#G7
z7|$LIg}?=iZa5tqTi)q`_tHgEQu2R({`z&E!qq{SU%q<92G#G;4VvPbGl5ZupY-QM
zFpf|W`dFuztD;ACcYe3f*Sh)}t^<9Vo@4s8{}<OJFOUr?vVKQiwJq_Wgpuv$rp-Im
z*471&YP9LKa^>19k*D6**FD+&JlHxB0WGs47x=KG3~|(=zVcjE{TbC}{+c=!kmeT}
z8#X-vq@DvaL|3H+z{7-3e$SS&BZkJAlhs1}B9MqipB@o*@FXx%NL!6CkrvQd0{<EO
zLM<@{X{R9I)hiuO(4_O&{?Lx8uFj$(@IW*uDjPWcOKy|9aR#1MR?0d_oUVkv7)N1S
z<MLu4zitJ4Y+gHf=IR+3jCU_7X`1#|-Dgp|1T;1%C=4E)cf0Bu%MT-{{Aj_MXNmoD
zG37mn0u6+dOJ>F!UWz6>B><7Z(la>6X!AAbQkt#1UG)iP4?ZIUy<!c_-$(m3hbc-I
zOn9WJ|Nn9I-*G+n{r^AyqHG5t%19}ak&FY`N{O;5$|xf%D<UJ6j24A5Gb2ewNC+t_
z$|f=@l}e(CN~!Pl?l|9<&*k?!|2faY>8RK1`FuR?<95H@Zg+Vhy_C8>9S2KCp>S|0
zc)6TZF**0=`E$#GzUSl*fBnm~wz^N7oZ(}YNNEV-=7Frti#&Dyyik&)dx;M%|AApN
zGmW71CJj5CZq|<0ReiqfU81q&BHoo5CH-*v<a73v9Z)K_;n-WGm$Uaw$=bF3tok>r
zcW=Z1Rnr|XArlf4LmyvyuP9ELZkuv;!iM7m!KloOuDZE-0?ZpI+`YZW=G)U3)>9xK
zj^-F2Q@hkRy^U}U1mvNq7CeW0x!&v?F*|$_7}_KvD4HzmjfbfJWJJk>P{c$1#Qb*V
z#+yg+x<rnqtdJ#6JNqzwtg9gKp9l+U#HR<YR#Gr*{C$7;+uYO$Z@Lx1tSXA!YG-bI
zN7=?PYR<7&94}0UA#sOlQNhpk<rlV9sI+cvnUg&^CC<DR9ZA#n10o)8?%9OeLCP>n
zDPwEvL(U!cfH?>m6UU!~A&m!?79Z`~>2%?4e`ihYtNdNMp>1@e^f_$+91>B3sIUua
zh|eTwKe9naxFMkHeWbT%Q0>ThB3(bM&i(^$53+B4YBZw-3r;`Yd@$l679BEr#2gU3
zWBU41FO?|+aZVV?r1CE`oYRDemxwvT?tS~Z{Cay1s9J{L_!P6|{_G3~Z<a8qK^|iJ
zlpj!$?2iGgk+WPYLjc*DDT7Smu{bX633L+N)v0ys@bXQTkl<vt3AuwZU%5C(Z6d_$
z2F3Zw9n{ng^sS9SONWJC?8^ee5gX$^`L_B2Yoe}#5r&dp?dg?cb!s5+CI6Z1cdg$(
z=MkuQ1DAA&SQ>QhSEtUMPrr<4U3v4oUisK|GQff4or>~@y*gTN4C;x!4fTH(>F^6X
z5h1YbfRLJn4C%+H@y270o;-Wj3qE6dpKBQVVqDN)9xVM;iJy)t<7inCEUQ|;SpdQJ
z*H-6^=-sD}5!pl>0TR27I{e^m$`c95HwzS&{{Qqyn*CB)_iIzwLnc6R`0z|#806;P
zoUPKqB@4#>ajU&?`0#tR53msHDkurMKk3yYd--HcV&aJ$$Q!(Qf;xi-$3|bA(&l-|
zpAq{sGK4A$m;$lJ6Zq^CheaW%-krq61^|%7Wo27KLl@<*CI0M`o`VnuH_{_6&h^mf
zr-It2rD;&*NSj8#@q$r#-%5v#%ietM-&nzfGm2*~033+w9rrp)V%v+nci+3hvbVeU
z=2g&@pZmFfTFix)+H^%grvD9m`|o91LU(!>|1I5TZLQeT+>ZQ#Svxa}EOWm_8y5f4
z$Kmf+)y`-Nbq|J>Me4>?|JGUXGo!XqSg(zvTZFA6+JI$rpzzMsFzqQmrlKi2<7UnL
zr9CsfeU&3kKfmI|JF@7q!=TltA740b|3c;o95HbK=B=!L)nOyBxGWXMxZ6k!_B~q~
zBV+L45$!+b6{!34=~K+L%oZ;`o9aL(IhPVZteHHvZY4S&VP+wUVDwT-jM3J^=_nfW
z*%rOOEF3)KFbBRfn#R@n5p7<w`?(3izEMzS%@<WLoPMqL;SWks_>x<A1BY%S2RWBi
zKucSv;&pt*$}YBtp_^R4<I?5A1%_Z%Ss9o+U0-l6?A))D=OR+NJlecBknjkdq%9PK
zd6Dy1tY}7Uj`~WWpkQ|=u!;yUu)v_SQK!!tyesnzi?6ZWrk-Il#hK_zGpqi~QdJ;j
zre1MSE7D6DzzmjA_I!RPVv}r*P^->;;?AEx_u%9e%gHMo?e*Rj^2S=P&^f=kOG+r@
zH>!=huV1Uu(FvCdhKE^VdFZpn^z^a_M5f#T&TRzS<6+UVHu-pSLn~|)Lp~TVrGXr|
zg<%LibFt~xP-b6Xz_Phi2rA4BTK)cWRrkW=E;K$~aI@ypa3f+h#=s(Ov3czgn#<R(
zUq2_=EgjY|D|Py00Rt(6nv+=$Ib52>u5RH@ayDRKO#zK%)06GdS@)w(8%^tYxCO<w
z`68YDYfCQ~bb)i|)vmu+%dmX`0b2nmuFsw`oM$S=SKwjx8-JG&B#maz)<BRivGP5m
zRoQDrLnVY4nJBPT7+8$4(nuGVn~w+H*pDj<dusd3IFDRmOm!qUn5wks5C_&L>P^Q_
zw>NYu@1FgdD`?TSg5bil*~;v~`?cx;I1-=ePK4RaZ14P>TS-G&R*K=YtUIZxsagrD
z_n8C&CwUM1gvjVvW44kL49a<en8c2;zW-=*UgcG=2-;Ux?^U)Rx_;HZw*^2DJUna_
zW}aF1=zuMA$=10ABzn2d4B!C94qQLaQ2W5R{+21jr|tWh(cR(Wp3lR_`Y@1}a_U!k
zU(y!S*}z`?n!Eh==%%k9`Pd!^<k?xHA8v4L8?n!sQaA{r_;~nce5gANk|1uxP{(}Y
z7^TK6Z_mV4+nY3Q*}qw2*xsJ4b9zZNs#n>;@>0*T+xx25PkLR|y<6$8*l-AJSPXEx
zC1OoUsn%`m<l?q;H7uY(LPCId7)(N8O@j$g6r<f)3(wqTk}O7PkgeApDw=BEZVe5S
z6jCre=Tp-gQYJF_+*VUPJ>c!xmdp<-Ft(6Y1rz}DfJ|&Z7E<UXS3A?qFum(-7w_I(
zv$^B<aJ@?0WhnDyfffVOmT*C+%<Y(S!c5H8Fgs1jC3a=hnVhYchJDP&Kl;!#xb(S}
zjq(0XUS3Xn{dJB$43SArZtgrpHOwLJ6Ky!m?PWJA&rDPn0Axlo0yXP2Z#5$Zc(d)1
zgKhyUDKa#cwJzvW>S8A#`TB|HMW)6~jDe;;G2ssMwT)n)FAge;ad9qEZ{2Q$>rkje
zGAQzX{Q;IIK}lxu-mhDQimm_!j384|tD<lKFmxAU2y`HxD{$m!^Eg#bi0{3n`~O`E
z;C0~o(5_t@0FH#z-g5o3kzX5+7=XucPpSwUg$N{4@XBjOQ0YeswUT<1=C=dtg9L^k
z$vvm8BQ8tCVVta}aV{+<sfT=k&kXF?*2~{N5m-;Aw=l+}G$J{vZ92p7rEW#^ENgED
z`_y-VPnTMzNDsBPuzat59yi5@058O0+o2DFKXzTx7q<mMqSt2KXWW-;-djk&xaU2C
zx9yJI(axmSi~~cC+Hv7Rk=hfjOAjFA02%EMvo`tp<413ddLnGDG&Y!X^OHts;J>>r
z^hheJv`=YkF@4dp8R;{kwU4iyiOT6@KN-HE{xBi2lO*dXfUyAy>Z{LR4?P~eb$G<o
z^t@d@g~@xDk9amMWpgjTs%dYe+F*Vw<P88&k<+B_IcJjS{PVak(M;s=QcMuyl`5Q?
z3HeWQCw7hISM@9Bl<}bTdiFFy*@26VH{Eh3H3|U+X;cq$2carc0(F1V`SC^TJxRZu
z8UD+99&8uAI2CS=X?UFmS})PV?txRb_0*~P`~1z20)|v2&1Bd@$lZ<);^;G0nk*&h
zHcU5Xd6%ac3y87CndxI&*MFkb{pe?VTXWa5BViPOPF(~a>R!_I8M***{Wu}%eN5^q
zhOjZDNWEnaYEn+?ogq7BfQ$EKKpexNfuOOvD1BIc_oJvlomC$kbh+g^)))3hKPWoV
z!t)o}Ao&$KF=L1s==F*WwbzhW&qPE#7MR4x*B2md+n7Vl?=Bv9{q60%v#|gSDHm*y
z16<6W*PrtB5e?Kk#xb3(rXCSog#zXvsMAd7#y|>vVx01)oPkF(wI~@U-~~u~jnj6(
z5nQu+^|@casO=Xhxaes!SabtE06r#7E2e69ctZD~g1r-!@y@j2E*0?%sFdOry$OBm
zL_%3$x%L*rjsYAZ2s!<vNFA``W#`<itUIz_a{loLv(OdIRUCv<b_4Jte=WMxcf3}M
zl{c8cd}B;8@0k-<<P17>MQ=vJzdj`>wZRY?j$fi8iefH`ZpQNZ6P{W4N6&MYhO<yG
z|I3%&z>vSl{87ZO16At2^N!D9D{s!`<b$7wYl4gPrr~LW7~n5V89{PeM#pKt6sPWf
z_(olPqkH=Np3pK20JvGWhXOkJIyVgyrsx?4FRUM6j`v&;B}nv%+$Wh}LBzVu_#uih
z8l0h`|6e@r=7YC@O+5ng_-?HiMl9=KlXfvPZ~lv<z^jpZeMKL7=<wmbiU?-k%Ls?d
zP?<!a{rMKOGHx!-@xC`<U&_S5tKh|{21@a;q7sk*<1wpV0Pk5To(dwK;{QI*_fKFo
z0cU>xd=K*Z%tE<lKQb6iq>5+xtzi>Uxh&%Q+M^02LN95_(uJ!PenoB>iTtVl8WyxC
z9t;mJQ2P*j<3>N~Q5Ia^MU9kz?=oPMb`=@I8lnoRrDFk0s;a>C-;t&daek7YJyZLd
z8ZpkYN&vbTFmHoi$5~H-540WeY%Y9HNjvkY62EZ)Lq1IVC1r6+m#5ioSeJ}rqDmyS
z>3P+l7XflEW881VD^kNpQp3SBXBO@{rc?Tv=i5{<#H~i=z8~mP9PmpiQrDJr6Ib)w
z0gx2@G+qHC&<~I-^x><@0H5DY!i=Vketo6>3%<e|6bE9L1%sfCd?X6efa_bn<uQg!
zV2orf*aC=U<;FjI>vz#KF+(oQrD437L}PJ?GCWA!Zid>Lc0#gCd2x|)^5L{rjXRn2
zg?MeB)npXd?*Qm*-YGqL^;!tEZy{ykf$;Ke1b2C)Y!01v$Sq_4T1wjaid06apoB3f
zVlM*RH(uMm|8kW`vA=#tpJGk6-~K_ozF@JOdeAjEJa!II09J&}lDqT9qm>=;jYHVK
zrq5o(eks!|1%3w9URrdc^RKack2i;d_z=&5&c6m@Ww8L4GW!QLaB3rXIzQe|^lJF%
zRb`hAgGZ#Zo#ht<PUZ)e$dzzPy1PD6<vj@MA^5yJB`THvmoU^nbN1{*k?oXzIKM>6
z+H$?$h4Ap0`S~sTxAnD(j*M!nUiCxi7z1T1m@pk#f<REv+CO;jq=2gEZ9V&Y_5GE9
zQS?LX)olgnecfc~%aYk^u59S#n!cNrpz%z1YzkwTgLS{`kH*J-=jOql2eGDPEmbPi
zZfiII{{+09U|;31eEICdMH#|j6Q5+NlT-*N?|9hVZ~iIm*nIN0@N0gxG<3b;?ZmM9
zY)?jv;p}Uxwsh;>{Sqe~T4@_}EdRl^t1vlvpooHcLA;HD$#O<S3OmM#VFN6jUCvEU
zBK?}WRj)y*Q_bn%8e^Mz$Hs&(?abse{Z-MK_T-M#;l2My1U@OmWU8S6->}%R)-r~q
z`xJ?r{5g2{O`VkYTr|v~456OS;~cCmbJ^wN<H2lE$TTecJiPFjO6hh6nPhmG<ikEm
zf>$SK=Ikt+kNjyAe@mJ!tUq>-89!E}l++l)*JV!cLJn{~Jvf{(qgW%1)9>d-qJb^5
z&w1w*+ToF?Ku=)apE-bvMf~cQ-VB^-`BttqV-TgaYk#&&>!pwtm~<;=r(Zbs`oFI0
zQUrN9CEa;!VL)eimRYpQ_WN6?HlWcL7aPV6A!7a3l+eOLl@l`@S{XN78GWz%0By<+
zMyBT9E(cy)ykrUPSoN4ze5S4<c)63e1@q%edgoQd#x5PQzt`k|i;GP^G!Clsx09o_
z9|amfBpyYpa32@NrK^u8o#UrwQDaGy5E5dazc=sFHou}$iI|lunJ}<5=+ejKLH!-9
z7HVRsQ^#enCyo-E!Qt?QP{C^L?A+4#VT;|6DvK+};R{14f>A{|hvaQd-ZXSQaH_Cw
zfp+dQ5RuxQL6}r}cxJ#~fV4Mj&YX^7t_n@N*zeBxM=i_v2}c4NUbuEm-N&c&#Q<Fc
zi^m5}6xDd2eU!Lo!sn;pPl9g&+tQV-7Uw4>RZxwaN-cm-UT0n1d4EYkDlK~S?70o+
zREl=itaP{3RCf59@#Lhu?w~Ex;44rO2>YIooBSmHsEW1?4_%=k_nsegZr;L$JIF>X
z-J3YCKN<`_9F&@gy#_a|`^DHST`1D++xznW+_`s8S(tMgVNX{(Imtw7L*iMASd%bF
z`X+BsGGjE{1lVF;<g44Les~z;ls3}B^~TpkX3G$L=S8Ak9m*#A1L)vRT)5!RX994G
zCRS%tT3=(I4c+w_taUgWwBGgE$9OYa#dv8LQxEuSCX`!<pZ}+n?S@l!7Z@paoWvQ?
zi(Bv$rWdZG(iTy|s=+1jK1MO+#c@W<>C~mpPmT^zlPd-&h2+;4cvuIchju1)4sD!c
zWpeCr_Z)lM;o}u!snLF%J+*C&I6cm#lw4gIe3fkz{Gt<t8iocrki4W<;1I*rYte^t
zL$-Br#Gy0iXoS82^KHb8jsx(}a*YTWDbkeyIRQ~T507fpskOO<#n#x^!4N0co2mTH
zyZL`yfUrRF4sCoxiVN=nG2$pC3{5!Ilw>V8mKW|K_MAO?)((D@bgM;U*6u}$Bb6!@
z87%Y=YW^%RQHF7K82vts0EL@}7zmhn+l&Ib?s!=#jvMuwK~J>J8-_KZxs{EiLv~C9
z|GX!(hJpfL493zOx5<J~QR~8+$>aL59@tAj3Q7;tjT>X1Up=sI-*(Q$%REEl&f_Ld
zYz~)4T5f6NY0c@2x~;{DlPXxj;1D-!t3z%*_yFMhEnv+vK;Y}m>Re>@Qu=Y>5D?Mq
z&$V#Gqf<~th%sXL1#d*Vb7y5>cO!@w8_Y6waeH!i`Pb`Z)8Ln$5I?Uyl>1^%tpWc%
zXZ40kVxf@CC?t7T+xu9>-W+<X&!Yo~HU7B`O-C99!bq9lR0ojYRUBn%t(>KmG%-$M
zeZ%(yhIGGlsjrM5x&hhL=c*i9{}1Y+zEp=o(eq9bqMP*7^x9}a$IV;Y<s^d)v2?=1
zMnJQR1AFc<*f%iwcyxE`y@ANWObnsGL(Fek<*xzg#lq;F1h&9Aqc3~4H2&(rVM=ys
zb=pv<0UY7KS}#50DqJLmM{&qu8T0dh;APCo@tMnvmHn!9gp<YZ7kV|ou{6OV*+<Yy
z+!6xSLHs?py=-M{j-H?q7xS81?QmpepH~kUt-T57fJqylM&I=I1cdJm34ACP)D#^;
zL(e(0WF;UJh)DvygM>3gH;)hZZ$h!*Ia2GBhS@UF-{Qprm>b;IgbC+2i?MKngGY0D
zzA_j(MOecXg_`UL;0Vr_4GH`bx!9B@l0M3c9Ogre3{>G-G#4I`>oNpnkczaNpPXEo
zesc>_X6#)>3dy5E>j43k@U!=KPL4&i!`o&cF%@t!JKMa)!&L}PK=8$1Q+jy6X>*l1
zmlpf~s9#pCS``mbDF2>^GOI-y<uJn8?Ht%0W6NNsGJjEs?J9?IzkKlmN7lkUBVsN8
z_BO7K>kIceeSH^?9O*uzfaGL=)I1KmGI#`yQt_?++fcRe0gFNw>Y*`Y9k)-1(n6%+
z2<`m3SnRjsBn$E(t3@dZWr^})mc-Mf`O^W$g9kDuyGJ-;<*%i}{rdGmu;91R?`Kme
zvpFjF=Jai^#|tYRh7V&fLDyf73*NS>6!eZKsFBKw435OpArr1ZNtaY9g8^uU_mHVd
z%IATxP7;pctbPA_k#JT|&>p(suu=4h6C-;aUT5*p!e41m$A5pS?->lzYRt&##p$tV
z;!K`qWN7jW_Ejbb!|?_FzAisgri19U7;A3sL9P-0IjT8^58nxDJY{$4dhSE7fl8rx
zrN9o=0`!10gp{y_+@rRzU3Q?`lSwO)Hxa6?7_(v3X+Cc)o;zOLDhSt)(q7(#TOjrd
z7%=XXWJIzOy5gUQBaOK>vRhCD@;nt_S7U^2U;^PEk2LJO?Eo~4lN4Lru{%&FAZr0w
z07NoT(W7Rcym5mhBUZyyv(-Z!tLGn9(RN03b=D}lu25aX_JR53p_)r`P)^X#-s2d^
z*TiD5*iZS>tH;M>b2YVNF<;uC#tkD}@e@#p?U6vN6mFQi1vAV+uV(P4mW=Ir{(LW*
zg&xCJ9@@QID=bZCo68vlnue^N7p5XyB)WqRR2ZK$e0LAlfp3ipaSQq`z>D>XVKLl#
zaqB=D7*ILfJqfn~_5fe~*mikA%fm*~2Iu7F1_R#SoZoQQ{)1h!j2HQOzZQQ)JDG9q
zcsTpEs|FcCSVMF{_;~Ft2rDT#%pcu>p2!|IMj8R{5+0C-*;VLHd0|Hl-}i=Q&LIGi
z^R~DBkXd>U7>~ezCfs|#(c~ecuMnO@&`OZLYEpnZ@myL~L#Hph$MtM5r@c7R$znAg
zpJb`^6~&#%QXWv_grf%V!#xS3YOtAeOr-^@E)gW|PA!1aoke1Rh&ks_@&N>-v<3um
z-(gB%7VVyB*<9r8#6$W<<eUX5l%H;bjP(~g1NLm}k{m~LIWVMb5s<g}qMB%Qd=z^Z
zDbU%7bb{x@>qz8IiJPL3R4Gli^N3N>$xbGzwS|$$#O=t@qc7M{Ksh+&{L`5&wf&(w
z`S826(3vyX`8PnXQ_E;9#__ai$b-t(2zk$;Zw5!35$(t`PZQsc{%>AYP(9=S@>J5R
zrok{WPs5?_ZqyI#d`hYBOvk4&3E~JZS4+KZTe^%uQmHnx>8vO1O@`uu(Hk%hbUB-(
z2=P5nBg{(tDOdsqaYPCBUO>>6o(e=UYy#B;e?MWpsZpmCQJ|2<4q4CZSP|X9*VD5B
zSriiQh>_OTt2Heto#4B9GrUG$GHv1hUgsKNK`*){*rW8Gi4=8n7cPY6J!>jIi6(=v
zRU$+a=Oc|dBh6uEXK8Fzxh^7@2=qX(^O?+_O8qLdeU2(#3%y=_T5e~jK%Oi$A1TjC
z`;dzEbne({(ZBN8VM=WQ3y}mYVgcAe6rkH^Ya6ZgE8@50Jgu-Uy$yR#c17m@f~;Y`
zuo8rP2t~Zr!e0}YFaK`tQ26e0gWTNO#Pp+{DS@?)3b%|lQ(E0InbzIGRCnwY^X}g_
zO+Pg)uyJHel8U{4@WGy~b>G?OPO+Zy&SKsCgFWYu4Xfxh_Wh9CBZj7VwwO}BuJBge
zg}joTndxiN)zY30%iBEMR*8A79efRqrxR3^|NPGk1G1-Bxe$8`UN6X|<yBQv%Ldk3
zHg2p+bq)n6iyxHW+OS+~qVth;ausFjCxske#wjuLERC61D!@>0n>KmzTN{-e&m|YD
z2N(rTztK$7LEo#T@{K(ndI^@Kkp>WY2|dp>wnrWg3i?Z@M3Pcn?=UH1)RZZE^L)?W
zYXDIlc~o6U9R8fAR~n(C&V`5b66;gk&}o(2-(nli%a%`o8foY)6Llk%*%zXtRd?;$
zHPjOEO3!|p=wKMV+(}A0XHl*Ji<9~f9GJ3EX?ASUc`*8|fCBM!m3#+rmt=qW7r*;&
z=_{fz#FYioFzHSVc`C#jaV+U;6sVQD07`)HK50t^*{C2{7l$H0%@LGL@e^GQsOix4
zJ$&*cCppEsp+|)ytm~5uFACLXIRL=I6gL8|h1&bY?^QRbcXuRDR#!Npm$_1T&|u$)
znQn9F=DvPi`X>9fWlaaTj?~9#`QK#OGvS%}g%arLrIsp2#fA(D86eyNqep0m!N9}m
zT?0~Hzy8E|kI<~GsWK?YqX9OhL{~f0wPE@cTifQ;?>jX|bfg*#88YF9a9a3RpR+s!
z^N}=1!$Oo!0#LLatiUs%F;C=ZtfTu(mWY%+`P9Yrkk)&jx0_6r%RAMZ>=7<(ZL%+N
z`OqPaXF?<q{wz#+C$oH^AhR;J<jK*_BQ9aa2t%lmNLhfy`Qn}M*A-qg{etjZDeMmw
zj#*YF>7VjeOc`knzWA~I)?dtJ6veZQrqTTp*r7&$FZEbVWd1+d2Uii!M#0NJ&aDwu
zNc)HkqXLhxRaL*1Ls%(E@ou#O8(}4Kst9Vt&5Ktmbw_UQLR6eDHMVP2cp&SBm$3Wj
z(SIn~{0ful3Ym+p=Wci1-Ubl}Vp2Pj^Jy(}6=mBNty`OJ*f1!q&$Yu42dO1Jp*tDj
z0A6UQ0TIU=ZJQMLe9Eeb>Plkv#QmFUR#r}hP4}}*lulq0oT2Fla{PUK?l23>q)?+R
z+f(*MIU$>pZ|ld8v*b=v12QBvvbJsu@#M!le^{rYPE{a@t^<Ti<0Ds@{V?v}*(6a|
zCu7UPwHp?;LjUVl`$r9ECENRw&8SgIunmkRs|t48>d=q^CPdqy7TN}C4=DhalLKw5
zS^?x(k-Pp%Ow4|R^J{i@$!#>@?|UY<95W~yEIS$*Wb}c$7JJIce94k-oZTI$<6}>$
z9A*5W4<MqAuAjMP@Q?|f5JiPc1ev?T(dVyHy7%ZY*TKOT6Zd*_R8EO(rELJuj|<vy
z=pc=ajGTpfBSK(g@V(N?{i9wFEzZ1W3`Lzv{?nH)4QW^8=KnBVu%gR<Yq0r8M|&fh
zxf?2~s-MHN^*l}lF)WpG^Y`zKvcP_R6<+i8i!*mj(+#M6RHScxNm=X=aPp%FH{8EP
zt6^{tZ(m=xOC1bL20>BkIXhOBwr(_7f12a_ACZra!zVe*%zv0Godd<*!qy|NL`RES
z*Q#<2QSl2P@U9DA*1&bd7IF)rlc|8|(~wrm&Cf+dR7X@Z7~RF&lm(UwENYv!ZQItW
z(QBBZKg(L^jQ+%my`^hDFr>&&I$*3av=a_O^82w;dp66WoSVSg*@O6N`dx>(&m0-4
zuv)fimG5^)1W&1bHy>+XoZPZZ)s!*P76YqxUAUN2#~1~EYR91!t*5v;I;+N<i;Seb
z9sK5k?L_Cm34kc-=y0&Vo#?C@+zQd(KQNP}9{h1TnQC7L-83kY44~2+Q-K5P(a4UZ
zdZe~^0c|f<r-gFDR(b`j!0rZU;&!9oi4~lf`z%X~y^>sBtJAZ8MiO^O6vyO7Ca#`v
z_>JK070z%;eEPH*d<F4D2FLs2SLO{o0O6qQzIQ*5Pi+v;9US7^3(y%*D)HhUOhN7F
zPB8gPT~u!}%53m6sV;F%>X1BAMft@(%ArZt)?=NUp4VluHup(DZGlc`vEGJMt<;~k
zIZR<gSbgwd^qcH1ojcDkedeEhJo43u*|TPeEhd@AIlsWple%C&_?j?cAbT-3_~K`x
za?h+?`}UJ(&H9)-rI?YK2|NJz=C8u3x_vs0+96^znl>48O6AMgQQVpSz1`B|(`KfI
z@c?HD3;GJe6`LJx!MT!hoZlyk6sN@emON$-uUy8o$=B+RXl+tZP*9omaTUKs&nGLq
zQLu8t3Zl-cUGyKE+2S-O*?JWm6VrykEs>VrIEwYG2F+T!P9v_e1j(4)Fw94^I^PS*
zs1Gz;jMR;B(m!x(P7P@`6IQl11v%!OIsqRWdVGn(V+an}bB$A@Bt1eBk|qx^=4{tX
zf6T0x#-#v<v-YSVGd=nM@!uahZ1$1%;}7+%C%RIyjcjp`&34J6{#meLgNI!|YH1<n
z@LwJDz3OWE)X1T>ut;8%{EoPlK*cL$G@zwHhquZd-0iWrid7RVUT8@=Uv_lXqr%cW
z@Tl8{voBbZnuuO9QwAf7`hLZ!H8GkZQijCWHk9eo^N)1y?D0h`4B`b&q>Qs!6WzaF
z^v^_^GQ6>AazZ}waI8mwvb!HS@^Mk(J6Jsj=?2bBIO;>cTCEbG)W~D1o{tBG8&^Yw
zI#fD?P>n#}6SD@!P0uw#lZiQSH4hf(UVRm^)_a31Rczvm)~jO8moL{>6kGalS8EWj
z@^RO|AR}el!Hj8yeC=$pq2r*{%FrZ-+WuI&Y}q}4LD|zNfm56s0EV+5DGl9}6@2=%
zG9S4?z$5W4&iA`(1t>BDh=dW)4tmyC8lGAWJ6hS;G^T%yo$n;GOd)KL=w4jvS?+)7
zwM#hIs`jv98iE2jI}25m*hJ(R=lpM+1R$7n5;tcXMV~#}5OmuqQLCXJe7G;AVbuaS
zKz=Zc(?kFwu~6O;IeU2JFp3B<Mw9hRaLxxE+m55=E1M?4s-}CI*xPmj)I@6|X&$A)
z_ruG6M3&|yns)#6A!j0o06EXv-&ZII=5p!<J9y@5AX63DpGS`)de-};N0m$T`MaX^
zlp1yM;)lOqfVjqdKXv_jTl}hIklt~G>rQ5x*^I;^G$Eiwlt+>oN6wjZY^}~)b{ce|
zJtyNdWdrJsuJH^zvUrTxREY=)`0~-^flFE`r%}n0>32~Cm6((i6P(bkKj2An_RXA+
z^b+zI9unfa?PQkO4%DVoE0gQv3Vy6~J*;Iuyu9VN(T#(Z-=YX_Nj}W?ORysT5uVg-
z15?p>VM<vKR~}xjMj+?_1SIV~efBKs`taWY1MZ}!ca)BVGFV<N0m2>FL6Gd698>2G
z9$M>XkyjD$<omsto0XMSTwFX7lms{A)SUYrKizGVL<6lkFKol7yN@LGQojf>f=@b%
zuKij1q&v&`VRks`Q4pNJzUuYMmmZ?p!;`;IPdQ;Sh37#-M{PPLRDMdR+x&{Anwd2a
z_bDVfoclpB$B9)Vaa<%Z|B28_vg;j%Co)4>B@UE2D;pD6W5?~Z9V_S)ycc3!PSBEJ
zN3u}Lb4j40#6NlR{qoDat4YTrO($~MshnJ<)Ze#fPyVI$kJOvi7fQaM>PY!1ufOd5
zb7?B@HMn6@hSp+%!*UKMGwp_cK_mfK5qL2Bl0b$1^7H4<h;otZskd*B*K4)!hqIB9
z_O~Yfxf)%Q5q6*YY%8@UIYsuSa$DTiG+w+2@<OH@0#u43q=w-|EWEf@Q#qkXXjF2_
zQ5t>rb{$Dc2Y%lhKWE6mTMG?mcjp>4t*->)C+C2K>e5f+Scb0GUJpGZm$u!!TF%-M
ztS5jJqckV8x#0*8hPu^sU}h<SnOO;(-KJ2oP7Z1Oq7K2y9l%1WMdYf4lDjCNR$-?%
zi#4D60S&LQsI!TTwx=d9R#8q!120;?(L=8|Gk75#1Jt<1mFX#HB-zAU;7L^8hwKl^
zaD95`aYqbWz<@fl+1k*Rd*ej}$bwostKVEvwaS~N&wH1@y#K&~r{E>iHi(7wsKFjz
zZsJ{3S0P+Ba4}JC3r5V0mnpj4ym@sw*9{w8tbKhDxQFOP67XW$iyT0+ACHqVm)PU;
z%+>$V0&$?0Cb9Ae?%U5;C#)!*`@TyzFV};+|G=Re(A9PSzI}BnR&~_x+<Dv24lBC5
z#i$YF5O+nbNE=K7=YfpE+2<nvgwf($%r@vsmX@!PHN`xnW@mI7{@Tcho)ZKnh125>
zSV}kDYCCeoBJM0k2#v~e2f))@_9#O2)1<eYY-5vjxTX>ttv3Uz80%4cVL&>M;fI6-
z(0r7Gw6x9X_iY-h;+-DPcuIWNAW^b)vMvc`NqO0$w*wPa4zG#*vmdvr-iO8kLu=y`
zw>2y^o2!hwk~@-G-jCtxj$494LPF-!=Y3YM)*)_WJ_<VUehL|aeLyoawyvMsuH<TT
z8<R#JX|54PbClo40$pP@Qugj%lR3`NT8LYL`f9WD*U=I79TsSo^5)GQCL5FsiA1S<
zzgKgS9EfV2&`^<k;zkPJS#-A?`Q6QDa4l`9(WtaH#Ayx2e1HYBBDIDz7=7g1%GpcP
z@l8dnAVkOmi%#4n{W=2Cq6!dOPjO>p=#qAEy$#`nR(l7cxB!R7!Jy}g=V96Bfc5RT
zsUoxFznH6lWHnf4+PPuOK^D#mbrBT}77W_V%g9>d0Lz1+s{*yF10WN#xk%z6R-Z(_
z#1fA$jAe=;sho(7{e8LHIC@RgqGEI|rjF+i*^Q&LYY|!R1)p}*gb9A>y*vDhEM3GU
zrS5$3@#Eu-PZM({GUcREnh$|VWSoq}K#VtBdMqXd%n-1An2X|49qnJ*p1}(+o0Ixk
zX0cp(JCK0y8`DX=gO2RfN-YA9lpvmzoXolLp(qmF1@}kKz@UNY<g*tpB*GzD1wVe0
zYCU41RP^Fuf#nGoh9&Gx38#X=I^8~P@D*hr6rZ`6P(lS4KMBss;<sx!OC>sG#l_-s
zBLk{mjc$Llnm)Y&ml(+96bpt{?r*(Pgp=e%E%q`O>dnfb1#nq2?11h5gL$DIi+cb=
z*bPh{qBF8sX7EB-W+pA+2O}!%zh7#cdc_~CqFe&Y;s=;C5EnRvfeC#6_3KQk`Q6e_
zfo1W0UTAnm3UmcREOuH%zQ4U$b6!<lg>B$Sh`WMc5X|1Mm?oPoDJVZ>W^Un3zS_H`
z8Fi+ZY=J26AgYO*fS~u!I$Eq!;&d>0%H|2qzI5;BRe`s;FJ?>+ZWnA2dOH$t{&h@4
zWI#im+yLxg=%$1k3%XQ=v$HcVRtHD*Q(bc~PgbJvhbUB+Ls{lLB7>v{<a7^q`n46M
zYFAZYZBnsgR8>d8bYR~2J~r1@b;6PacSU6erX(Q&n5Vk!=lsh!>qeH_3(nv3j~{o!
z7a4GS`e1eglaiPx4c&ZK%SgrK`0&jNmxEeK$zKZ!N`SU5>>mM}$Ak5?3U?lsOi2%y
zh7pHo=w16(mRaOHBR+_x1+MW>>t@SyXzJ0$3k6ktKWK@2t8-{pDbQbvCmVeV>Y?BF
z6aCR@6UF5436O+m)+zA``0?W&$>K)u4SAMUR^mv+&OK3V1IL*;pYAnkvMSX_2`<B8
zmEU7{gLR|13_(TKeE&OC!6ns|YbL2~=YP$oVvh*Pn3-`w#7`SDmj3BaB>Wh+xjlG-
z33M9S>Ll@>;tXxV7J8AyGc}ie@!}Ji54=*T+#s}Jl5}5f#0UaRz#}`C&p^*oOz`|F
z3d^hz;0uCs{CIP!310kN0vEk@{_D4&xo{XM%Q~ESVCT!mJ$8lPXV>@8HJ8f1+!D8k
zmIK&XuUvm?f?9aUC4`u*GXl34eEnJx{LO}9%6&xR;04|rJf>bN_c~m0l6?6Oh<KLo
zjaD|oo|pNbZHL~>42-!8l(1)pG%h(xx3~p7o^W79bqFwngscIzY21xbk#TVy(Ri>L
z!<{K!nqxzcPpw3Q6JOTKq>de>j`RhnnwRwOVx?6Rp59%&f`pYK*0uXPIC0vH>Er|q
z!A?Tx>TWfaT_<Wzef|g;7wpl|OcfXaPIT_TslS@mLqo*W6e6^;@j$_J%}S6|$R$?q
z{EqXII8P#LXR;?FqQr?0*Z%5N4kSf+r#)am8=RHC?R;>RD9=vIMmPbze)EQvrkX@q
zu@!~Y`#f}_rT|7jfmo`tnd|rY?*(7JAggK*AlgCyJJrNIsOoT@mjz|?xUsgNKC^gX
zwgSewtf{kA%S&@2Q5`YNHragZWL6mrgu?Ljn{T~y42`L4j#$=wW0B17U*D^&E72Uj
zra!|lHTC3B!7(vf5Y!aDh}ThrD;AsqDJNj%7~9!>Ug%l$e_Q~qXX$~RS&{)9ATvjy
z?a(!jsQiO|E0YQy=+qQC1W}k;-jjSxu5Ab;aD04|ymfqGkt))UgCW(SC5hEp+pYfA
zE%d<i$+`#sUDA>v%|BeG*!i1tE$;vH&$!Juf1aB9aHAi?-h$2iQ)2*H%0LX+S_^NM
zF5qNDL{qxMNmf=nm{ubB`!KYZm8Io&!mz`j-@+zlmX1q`tR8;B?iHLom^7&B>gwXV
z>NdTmB-)pkMVlo6D7KFh>X>`fENyY*Q**#$s6bjwOPl!wM`0%)t8;M|e_fz$igdvw
zVbS5nutTQNj~~Y`=!+9z>1_KKbo?^$r>vcId#OE5y+}=Jsy9fxl-B+1_bYC-uHeRd
z)-<XWg<M=^zs%4^!JMx=-#Ti788ns>HIvxo;%v7Tt&GSg1cK2!x(>w(aL?}Mmxqci
z`-~{NI)w20D6M0&oo4X-MZ(B^Eq#)(E}X&NNe16=V6%SP|I2OBpvpl&p6EQW-e)V2
zdNB&)KT<i{^cD6tSeX=(G+kgK6D*p=5<oI31Ea29^@Jb-S0VXTVjHJ?j+0dQ=*|1r
zo7|;Kh(V1j?GJKxk>Bw3Sr?`TzzY-Hlen94>;zc22GcA@>LcplCP0l}_x|BkVQ_l-
zZr46^iJ1^RAP$Ozv%meW#m8w6#nTe(xMB0=i^i)x!JkAx+owmH{0HmC<E<kAKyJwm
z(7UA$4kh5wYg|Iy=`pj(O19OTVZzWI)@Sa^5H@RZ8xO696I!UKh;t0*bjdq6z#2+{
zIGdUXNG!7-SAq4yn~ltQ_Dj9DodT^j%cg9u-MBHz*w|x!Ro1`Q<zVYEkB}<eZkprZ
zWvue!?RXG+d1B1~;|N@xfKTyut7AG@fH-~%ZpZHM=1M<1I`bQOl@~E9Bjw9JJ(o3p
zS)16pBerJrIv)6$6V_8gT7BUwjp(t-HS${e;p;zdor^3tu(p1;Zr?sQx?35c$S=a^
z10-h)hB&y3Q24*heOW@2EI$W4mH$;-Q8HgD5<U^!B}~K8x=yVndpx#$WlCZO{A*6S
z=hbI3KybNur+LX*dLn?jEfA?el`sb%>)bhp9V=T1xqKDyw4KZd&|rz@6^z8~eD#Cl
zbWxn&-Z*ROlqq$21|06W9HrS6jpH)7PuvWkP=8+5NaQqyW1?jP0aHH?i@CGv`Io7w
zUX0hup7bx^jK%3$Vm7$n;EZQot$+uO{4$T7TA1aTLO%?ph=odf3iX!lJ8+-@sIuR&
z&jsCi(3v-GYr0Oiwr(U?C|Xrs4+ve92utz4V_y3ChPFA-vCQ=#EXhuZLPKSvV$`)Q
z;|_LwZw_0C+%8L-Q0^{C7MogdgoH<r8WE93d~Ep?5biE~*G~*_09eGLj8UPBW5kDj
zTy6F|?BJ1(q}F}YlZpsKyUNdR$@^O|55&AdjUNIzZy*i63Ib4$XW5^OaxSS@ol}D1
zFENT5C;8WGOUsn}oFlZC;_EC$U{S9zYp?i+`ci7Lj#!Q3a+imL5OfQ}wY%gjh^4&j
zrDe*|K(Ru|VwmrEQ;V6KFZLY46irWjf5O5*&)R_F0L${3S^yA!MIXj0j;FPL-^zIg
z41bDoldZm6(xXR?_n*YW)?!|BpX?vCG^IO%<sdDac>d@HcvEZ>fcF)S(GcTTQq7w|
zAGo&6|5`GQlUo5WmsDoqQo{-bnH5p=U))@^4!-D14exc!_nExw)2Q6SBJOHUdFEYD
z1~vZ_l#mD`ypQ7-wXE!xg_YI*<=ZVNi8v)v*&*!bC)Y>uBgHQTyyQ!~o$1zXk2LOX
zU{L$+buIKQe4RTXiQq`yr$Dr0=nG=jRK2&m{<|S}0eg`-LbmK8wHKcF^T=UNiQ0xD
zfmbM)AW-80Vr<DZInoC;ot5<uvYT|<N6q#^xe9o+ZR^&%i|z(cREmNe6vd7)(X7p7
zcS$qSbkTPlVcP>a%E>JF3ALs8A~A<%OcfsOx-#eI{1_`Zy)KT&ypA^xj=WZRYwxG=
z1pDWOyvnoZ&*z3KMG(hiHb)&QI0Qd&s7pnZg@IqoqZEy@_y!!DuUYbAdo@G|B6V@f
zr4I3)&F@lxNFo9P{aY3F<D+HY$X5m=5Z}-h8F9O4uwU$zo<qcY)Vs{<wt_?1tbRTg
zk7-&&LE5AjM3FF`QePcc#k3decR<{O&bSr*2&ew#{%nBxij3MCagE_g%GiTJDJZmJ
zYl1A0r5Uut<sMT1i~W~-%;w9G1}JOpFao(zUBBZxRTDmdH)&Lyv!ID#lA|8<@=vNr
z)Nv%~KCKpJzNj?C0E!l56ooUT;r}*CfcZE1ba(75@mI%Gh7urW@dGZDAdTFzzgM9T
z#iH~wWWrSY0LMliTB(sb^<KQm->`h&@DaVHT=~kJR916!w`i-b9_5;D6WoqqKRs~7
zhf{<M>18R9Grxa-(mE&1k8!aqBa%Le8~aitG>ycxjpIi6%|v>&c*Tkb>|3czFg-GC
zQyXFQh0nN`42WSpbq?I!J@`O4=jjeUh0F&Y=nlfN!|$pC=D}3b7y;!>@9I|L{HXj*
z>7s(FK<YJ;<cP}t02}XpWCRc~#oE-g9yIdZ$Bs3l@`GV93fvF!2a6}}vj^k-#|Md1
zYw60WAHCg=6l&4b+Wc9S^MG`a7;PhnL+XqoiQ%rfTXk5)N4ATNoU9t&ITjgDtd8Sr
z%v7WY<AuDr_lbA~lxPHq$S+`7sIE8?A-p5Dppy3vZ!$|5T+Gd7{!de`S#vXq)60c;
zruM4KyL=9ZB7R_a`RliD%kF2Cz|^cf6Kw$#$Z)%=Nu&1^L`?{8>Ui|0O-{{aHzyOi
z1TO0rzn4ph<9`*9OhOrL9cA+C_${@MTq!!oex%xOycIY;17#FCaQ^R^VgSpKZ|K^-
zL0S#d6IRj##J_*vjzUqGxv*T955lQX4Ew}-@ZrNRp2LQ(c68jrLl#370mbRowxf##
zI`N>Ahl@zJGtS{Jz^+&YtRowD0NpSO9!1*###eGzzgAsMtpT+nostgIT!QNCV_P)p
zO;!k)A{0z+COG}YPHjtU!J!g}fifxp3=uXJv#%MkPTiov%&?flQ$&%k1Ok}5{tUWN
zyZ;LPZ)#0~#mr9}`*@;vQ&RRV@)^&9Qq2G^5~pxRZ7nGM)iZflENf0*9(lhT=8>{h
z5pmH)Bm)F&b3QH_gPn{dWX4ozxO^jEBBkDLbmpXQgc+)|w_7PTV5t&Q>rnSAG;3Di
zj1KGY>8tRr!=OddYzeKG&@XX6VE(QFG{ibcX1UaVJIFtOSZW);@fr3@ZK<fFb$zo2
z7*H(D2?~PLz;VArdthyGt2w|6CF0Qjl@1s}93NLOf@?18dpLZQ8Y5{$$LY4>N81j&
z9dhDCeD|Xih%y+Ev<EaQX^*&i2f_=nAFIlu(h;X%Q+0x`J2PgP5g-z`6?gkN$9jEj
zm5~dB?EU+{)!VdbKRmA|RA+l9MB2ZgxfFw2fIp^E@q`&fw_}`N8}Rw>^2i$#N4VQ1
zKYm)S`-{>C4a7`+JatMLIx5Adpp%X0X$wa&NeJByo_s^#HK0qEl3k%G1T0wRzKj>2
zYlOVQw7Ut{+@{ywmKjC79Oy`+iNJszf(U}q!kE|s`eFOgs1{m8p`<Td(7=~Mhcq)%
zaXAYu2D`;3X?;?C671~QGABA&=2-_O{;E2N0-FzCpW)uD+pb4fP8jTBAYl=Toh*qW
z&LC%GEmtGnZtN+?VU&5_K3;DHn*F78tTL9*2oCM_*MjcWgIgjEvc5%!(!)T3`1m&k
z%P`}4zBxbJ;=}f3>sp)eRJcmgx*Zwf+zhSVvN2{ZW5HS|?wFG@tJ{XGQ>6LObbt_L
z5#l6TF?u7~WlpDKPhY@j5XAD7L^e?f_9bDS#>sHM%%n8lcXyiuLLjq1CRfF5-w6i4
z`dJZ^bo}GL!~7>uBnV51tD~Z#qTut;LkhmlwD*6m>E|n}T$oLROo*KVtRV(B#&nC^
z0#Euwi0rAkjsnV)+8fZvGp&Ndw|B>nqX9TZGn-_V4V0(CwLLjx$^i%D9wc|`R&aY<
zs%s<fKckm<QzoKVUT~DpF~E#Fd|PY#Nx(8ciZYIePH$M%1|_DDrcsQI+Pry~05Jg8
z(uR<ixD0hEB`#ksn||Rcv+gDo+w@kzl%m6zlm`|luZf;i5<2w?4=8ro*Y>1W3UCI=
zP?FstV{HGpph`(Xw4To$z`IW1rj%i?G{P*d>^Eh4?+1j-{yI(QC-J1IJ$yl`H%X{4
zwF=Mnqz@N67;4fec!_?l>+)JlH00MKyE5UlW0AFkG=376Fc_sTmEN(~7oROEF2bbw
zJ4gF2#@5tmuQawsihxh;)u=7aTbUpYnc&<sSVNvMBSM+^1G*O)9u-S(rpdCwYu1|J
z15C+T{WS!7{yz*LW3w5ZgjP6u=qdg;W1<L(PQU)xuD3wVf59C*yy0Y;&1@43^Ftiy
zN%wd7Zj+gA(9x|{x;OAke*Q_f+8XM%1hUJZxZ7`hm+`fPL4m_f9cHgG*`W){4xb-c
z#FlIaUezwkFAOVA^>2Qoaj-&)c>yor!%z%#c@-3kAYX+mdonU|7l3XyCs<$s>L(?1
zQ-aW<PLp8*zVRHW)L1vJyj1--kgBv?TIG}>cBs@u$mb<qs6-3DWSMulzwZe->m*5Q
z|CRb~>(C)HCtJRMM5Vn)^H7>j@u24N3fq|UXHWK2M+#0I3@&eEv4hygEM3|HP9KrV
zn9C>{7Njb)#y4lz>ef?MmX|BoHXI##*t$oK9EttZ+9{pFP_SSQCc}F>x*ORvoOUtw
zd}MieZB04HMEa;<dAGN(h2A)^#uoI2ljII1gaTMXY>a06(qKA=%YOS%qwL@ZYWMHo
zn%VFuB3yXS!Q7z>>7O3j^=9HzpST3c>5~BU_yf^65aqTIX~rGwT?g2UhADxu*PxpB
z!Z!is7UL2?8l2VTHQrwTaYAt%bWVnLXjt46?6g3;3dhWr%316hC~=|I>|sJE%tE3U
z^uTSTHfkxME{VK&|4wRe!L0aKWP(pITN9P{X!z*KszBK^7Gs`vy8@iF^TLXu;o;%g
zK^|v8Q3<@kSG3IIY8tN7F*~OG9kSD?s{4lPXs<>wpND>L3MmKm?Op0Vi!)D)8-h46
z2&pekY5ol#jN?2hvN<IF;Rk}gc+s1jB)+f&C^P@Ij)&H@>5vaVWyNqh_EgkSiV)l^
zqtG=o-3)wV?+Qc0oqUDXN9Zb~<7oTL`taL?yg(&);{16*$8fZJrQz$)2%<R*9pFm1
z8`6G>5TEZWb8Tj?%<4q{MT*7vEGwwhp^O6lPkfn7m_13V;w{DMWCBAi+idF#zm3Wz
z3h5+X5mC!;m{fJ^(L?AtvYr4@tu#pj0^m<e6)uRI%%-7v?|0iu4<xfo*&;>TvAM)i
z`VhQvk(shodfSAe16mEUZV&G@^~#kWo3J3_amp2#a;42M@)DHbN8P9VgLx%@Y<<P)
z&`|NNg(l_V*y3^zzN9u}2ts-y!{H4ZQ^Ybofv*iea0@n32U<r6*MQ&;!xGA8D_W}^
z^!dP5QX9d8S-04<9?&CqS$Yee>Dh>gZ6wnMbLv!~ooR|dj!GkeJFubjx6vk_<3P-d
zmn~bsZMZ)XXRc>H$EnWd-CDHS0udcmR@490{tQX-UMJ@aq6dlyx&YYlI`fjA0(9sO
zN(dn(@=Pe{1tMdiBnY7_isAUf1{ahpad=mYF=J!_88)>t5u@st*f-MDbh}QK&X>I0
z-1<Jj0wnY4f%aZ#geBkH__HyJAeocF5YW=rzSG^EY@W?+k|6alEsZ|rABI!})r9BI
zqms`bO}p);$r+%(mUaZMpab6^nv>J%vvUsxS;gX=+tzlrTjqf-xwf}9)?+vpJ3k68
zYCpvkl`g6N6!JFx2Mox{aI4+UbCp7#N!;1+aKYO1DdZXN$d)tgm*A*nwa27>Phj9S
zz@Oskv<F}~a@^R-WDL1YP(kKYM1wkDdjI7B%CI`_dAHSEypeE7m&&M!^#OrzdJ5YY
zypzMnVb~(#lf#}Xpr%WsgS8lMI1>&Ok9Kut&0j?bDmf7vFZ<JT8dwF*&Ar4#$?wEF
z5#mWb|HwO80N<$lxdKJg>4GKap7V|3E&w&p|L_ZA6<K#6YAq_$1snctw+nAAp_7dn
z^RTO0$mL6yM3BhMh14096s)0tfSfoAAra~0&r%~NR#;2e7VL?i_4MYy9$Ky=GrGHh
zAgBV|&mUHEJ4cSyL|s=@I6rRaE>3><&^=gBjLs}{<4W3-wt3bX%n}TtB~8resY)Hj
znMC7v2lq9dDnhj}(TK#b8_I=@7Ga)X=S>?V^t2CFMRvW_@$&ZIQh?x<U`0Te=a^=i
ziSR-UX({Tr;$$Gk0BZvd13P}`xyiNqSc+8%3+g;9OQ%r^Y}t~qXsQnsywt;%U_Ibn
z+o-*O+#PYrk15)!=@Qm6miRU?DVVV}U482Gt6jQxPwE~9dEs)*TFgKgQwl$YnSh*l
z3e*pwS$)-;l7Zr39KxmA0WJY!Muu;tIm&ag?kX4gTLjO(xVLE<BnCTR7w`{kD2%D+
z12Vv37wwC&#o>-OD{B$S7$6P*+XZH5b1a?2NwwH}_2)4%>Vcw~n;N&Covk+{ZbBJ+
zrLnyS0jDJ8YrX1A_hh{K9JPg<b{HN1@3hN}VHo3LsWJ=~52zat)SUI`hZ|A<8H2Rs
z`x(332W^Y8OQ>6oKn{+==^+zBW#}o#9VbyR8(|G$0%JtLr=6n3_0XzNzpciLFy)Hw
zk~hpWCU|+}Nh@@Pqd+TV+6|g_5<X9K?#UqPIj%SfzB$b&lf%Z)gSvKY_2C3{36=|;
z@VM2t&tsm|06>PwZ^ku~pa+5nVCJ?i^ET#v43jH6SrGbGKEUiv4mP)IbxOT!;ID4$
zUYx!x<{{Kl0&+tPS(Y~7g{yQRLc#i7>u+EVZAb%o)JP@`q;ZL;Z%U)#*|1DyMR}eh
zGX<KePxLyJrn%EKhv1+g6eKw9MFYF`YN1?`U13#unV|$1EF#e@ym}DY#F*n#13`2Z
z4BNJ;nhZIyc1j39u(*=E3g3uME*?z@<1X=Hez&eq1@l)z*JzHC6xU>)H@i9zLS%XA
zmp-Sdl3i;m7cn7c%cC-F?W{E`YS7%FM@*pBVlP><9zDW)rPUtrIj&iIHFEE7`5zPi
zoWA_I6YL{c4mionYynE!vf5ek6NmTmCGuQ4vjx^s(F{yTVY|TlZb(A~x_Bb(gO8uz
z1NwA+vLEF$K$a1e7SvMlV)OQHH1nB}Br{R8L3WYzO$(pJ#wlrYQe&EXY!Zr;s%Ziq
zkz{|DfgN(@^G}pOU<PKct~CQ!Cha4FvT%crt^}2u9Co_SdsIu-IYksk7bD}XXV2b+
zC|MW_#Xo=E=agRi`cY-z*>mTNnQ1~48beLbJo-WF@D>*Zbzl~^<o44$%?xbgOweh5
z@k?kE*~;Y6($jwhA4cK)0vyhFUzqTvHA@Ad^*ANk`I5-@cFDW;k+VnBCu=s;)Hbtc
zNCEki7G9(wBL0O?#$|sV+qtiiO7#V1YfbBKEi(V5DLa1n(BgQ`OMG?Mlv<G=<;goF
z4TzS`rfgLcp{w!=NSefC+}rfnu`;f3{U0x~3MLO^lh>IZi`TC0FS9PHBVm*>h5@+S
z78LYhy8pocrx94!dstD}g$tf&sc0QM#oAw*kuk?JO^l`y#yGDcAc3352C=(uzPI`g
zUs_!RqbE;hUT!jx_aR%Nh)WD@9C0EL;t@k&3@2&DrN#s_vRl6V&y%7esvcI$ydT)F
z&!KTrgu+Om?ahB(pwrM}AR#oy`u8$@%V7+Z#mi*a90{$5vHx@5zyD2Fdw9^+HfQSp
z!YGUK><*A;tV>4qJZK#dgYR&DMF{okm4^V4)J5}B&RHVKEPOsdpg0y`5f+8N!;$gC
zo=TLeZQ4LFE9iB+J8IH~{B-C-qnJK1vyAR#l*Y_O);Lno$<Un7eLp5>N>EUcKsd~d
zJ5V2pdYb7N9;<7(o~Lf!>_D&^1&@ao!1|e3x)cmsDhLnh0Tj)_yIe3Vhyoe?Pad3r
zOBL<(U8s99=AhGvoAGtuE4=;KL)sLYrTBKromjoPFI4v}I8++j+G>(JWPFla-V;*6
z;9j;@mbPYqum{p7kSj%u5hWWVK{yB*Yg@g&`U@7eH_WzpZVM9}@Dwp<d{+IT%ll{O
zgH%oD!ayPWfxMg<($Y*e5e*vDRv40BliDl?n>FR<QLnA~pMwFRcLu)_WIHn}tFD<@
zVl%aOVoXIbcnVn!=p9__g6Hch(%{k}%Mc(j_SC9KFvY(#<E{GCvUS`Gbnmzs_yh~L
zUDvDSy{nUI8I_K^Qj$E>`_Y0a<8%WG)tA+AH=i)!%#ivYaGv&P2S1Z$<IMHzhrS|A
zxWaA(q#7dsAcvZN$BwN~@B4#^MYi8_^7F_3%zx$Cy<4}FL(D^Oxm51O#w-+36w-oq
z$V)}C&vMI=e>2Q1Dgi8&M#RovHEZNZMHhYj@hNZLlJ|noHc!;zRx<iR12laJ3T=oJ
z-6-IbkT`VL*AE%eayp^+gkq8#`(K=g74;3Cy7>RN08FL>sm^}BnmA%I{X!`7KOFc*
zA+U%psHFc0WL{)BbLNLVsYCN{{tN^_7Y1Z^NI`{$wx^N%Zuj)Oy!i(Bcpyay2eD_&
z%Am!^iO*9NXUR^kZ_8@feLR`)9f-f6JOm2=DZozCfNv~?)4v8j{&;U6pDCo~jE^;-
z3f+JVz5;?|?DN%fRld2-Rq*K73?9M=%iZB*fqw?m6LzB+G9Nc?XG;~86N)HTxE+%K
zjRTo<$itP_;j?R32<P{#e4dn)6o_FLFd{tpw`y&A3>LRJId(FK<rJ>~40<xC_G<_`
zAO0Mn`ke%NA4ombrBf%PIwv51=)wHxj%v-pFCaN7Ne}0@a~#2GWCQ)S%x1=82|5L0
zAl?|uZX7R%5pWJ0z`?lON!8SS@ZiJp!C5TQjca30H^8_eeo@gxpy$^Ji}e5!lhV_V
z!C*cm6r=CBI{fVT6Ktbd+`Nsm<6I8O0fELafl3S>`Xav3WFUjTACU*^?d3Iz3_gu#
z;Q3TX4ixEI&3@UkagCZZnM&7xg3oo9;at@BO$#ZE5dWC*VEw;l+#YcSaAlp_gRbi>
zcrEqZb&l8Ov$JzdAN8g&uFsbK*|@Opp@<73bOXlPFIX@MK;--T(a<5TFkdyFG2>ug
z3MI<@cl-S{!@|R-LhN@+{A9z|2_%H=<LA&KtjCwLo_j2WqqNC`bNIcgimx;p0!iVL
zGf8n4r1F(Uj%TUPk0y_lCwo{iXUPeF)StRaHYfb;LINjLA$%;Z`LhWMo^MEKs4U1}
z{)sH;422qh^&~A9=s+-XI8M8*c(EaF`wN{4FqMbawdP5e=!yhdor|;;-!g7%{*_BL
zlPZlgb(a8yt_S;Exi|<zOb9Hnw(2rjtS(J9ple=qz`*ojB$$VS$^v^^w>8?6NMaxt
zvXhbz@Rwtcbep~eINrPH{YnJm%%L}Iw3)U^mVq&p5sja$o0aZIBj4AskCAFcRK&u9
z+aj%qv##rV0P~-^+{r{L%3UzRqpLOu(2p+w2WaxlnL^2?Z<p$h`JtWu)jXW>2VV$=
z4@V7{4Wg5A<V_ZZA+D250{ku<FznoLPWhEb$Az9o+YQotZ)3GvS2vJjsZC*LcrqOn
zl7X)7=<FU}hw}CM8bt?)Z-LlBfPB(qFAJ(awgKEgx)#CK_&dvoi#|z;NtDz0qdMZn
zAZC2;-@k{g;Q^dRzZ7d&d6hRMj0y&mlE-CWK+Dj}y4lfSJpuB`;Q-C|IT`}J6N$;S
zt})S7iMLq<-H!>@=1aHyGlIb8db?B<Kij`y<?O~aW@l&tP=8D30Wm_@TWNdN%f?PZ
zU>%5u@{_qFauU!13ekc;1PU2Rl4@E%JLp3JOi}6vsiBjS%q9JTf5A17-gl<1FO7|0
zRsRvJg%ZfsERp4~Q>R`Y^`Y~%0P0krTdMHqr_7q;yZb`JTi@oHFUf5lpL^Md!bIC=
zqC+Cl2;RmfS7Rz($`g0cW3^}H0G|!`b@ymI#FT>H+ILS;4;l3eMV1y9>bs4s(kAC;
zbhuocto(wGw2mS}zt6<<3jkUO&a7md$K03HlMBlS*rT%WV&%uP^vKj0510*p@iUIj
zB!r`9h!+*>r%xlDk4)Ia%>toTQCCmR%;|K^l4hE+PROu`CzMN+=m9D^H4bLjv&u=9
zy()9|u4ipsO*X=Wt1cZaxVl@+&SHPu=QS8!-ec(>Wz;{Ee#<_@>?(@Ob2Fd-uvzFz
zfwFwg!Hw99@C&g<bq6*SJBI-SVx|ss<e>XsSn;xIFD;;OhAC5pD@9+O@At#<NO!Ng
z@iIlD$(hIWL^#A|zl>b4K2Q<6OgjH{>)9Co!)~^!19M#PNwy06;1o!iV)Q?723{r6
z2&Qexld_g0{`_dg3cp=6V?vnw_;|F+Y*x{<sIAJV9p26QN@(@F*n2mS6EKt*-fcSb
zxg!IXw^Kl5I$>d}+4T|TygX;3+y*M?2VAy`c=JPu@)ZFp5dOo5V}P(T5!u7%tW%t+
zT>=(8BjkB$>1y0hgrLqADruc(?)S?5m!3#e?{GkbT*rc#?fm;zeRgRGb7+GB?f3wq
zi*yX|(^Y|`X_5X;G?Hi6)m&k+RDW$uoB^2lW~&M))7y8eTvvTJ2jD;mO{{_v@R27K
zt5XsUn1A<wAQqE8*~~83ACM%km_hV*!V8k159hx_WQvL@ceH*@^~H4mXfIzlW1@@{
z&j;EULD8`lZp|$NwEE(_(*M&0<{~Hbd@QYgl$0=b36;*8;mKBH65JWl5rUx60oK&i
z2+B>p$d?jcmJE;Iy=zO_5dTv&u*KXj9ax9bv0@hSG-cpFYkct_BSLJs5ZnHn!~=y^
zy~(}GAm1vqEFQPIH*ohvdu8ca8UmZq`9A@B5UYc@Yf-D&yNu-em`ir1F*!+S>YS^K
zLIli?y3g9ME$EO1+J%s`7A`-2JS~wheUEK_2xZ)55}TVBGLVz*BapR;sRQ_tQ{onm
z4xOzsa5QsLc*H)1V`iBG7s)dMQNfq;BzxFFQe+RLli4Yei%{J;Qlai_Kd@Q6=aONv
zXUW(1?#WS}&(T@Ql!p+uY|tZ1sQsfx-JP(~bLQm#e{Sl;S-W!=7zKizBP;-nGhrlh
z-O;<gSf7$+X2ys#7a<Q+Fqu0rUX#!VKrB-~-WCEO)LI>R%C>(xFf-nYW>max53&Yl
zW@!uMIvAIHqWD_Ae>h6`S+gD=Zd}*pR(05k6AHp;oMFbpW&kjwnIok2SwE*>fi;Oy
zsN=9Koy@*Q!Ql{;H$6T5;IK^t#IOTAD46`vN_U(LzPL~FT8<4H5gHP*oo6L0y2#kZ
z_=yo1;ws9mY;FAsa90LpmSx*+Vk-h?w*1kWwoPS=SAC4(ChBf>omGF|{{5pFO~z)0
z)b3^})Zb0g7;%B!dQ#D*?Wwo}sbWUXB>_^X<HYxf{TX)-KP{pms8?_My5;@>_LCt6
zu;isacSp9r0)v9IVnBRnV906BG;nEJ1K8E^cD>muKi>ItGqiclV92p<$#X<a#i``D
zXN*5(DJn@#7B`9slt7F~sBlT@OUqO8<%NzkON1?|iEn#n-Hc#qJk7Ehb^NoA25YyI
z=@goAp~XtB-MnHZsN`Jr(A!X?ow}>)!d?{@e3u)`#&_z&FMf9hh@6)}GjTqP;*JjM
z<dFI=b`UKD_+^iHUZv6iMZ}OwI7W|t1{{rhi?f!D!RCQpI+=B9nAL#Vx@6S2`pUzP
zG-McdpALZ0N^<M2=S4irsASyn;TjwchMA#5TE4x=Ujcj11hS^u6{!}nYQ(oket`9J
z5z)()CcCV{N=o*@%aRy+2l+<~>7pV(rT#zpoBoIF0o*$QD1~Itb)E|<>}0m|03%5n
zHOC08#tKeJJo6Cowh&)5s?rW0)Jg_X*$EY6^9}m=h)ZAS5k!(iBYX-8CFUU>(b50%
zTIOQEK7W4pvm|?tsB8iNtTkc2|6;;XeK*E4u+6dpO1mC9U%pw=29&*N)2El+-_U39
zAVWi0EF-dKs<L})5<i1$iLL@LR@D9cRf*6n*h#(ZHUcZI%CEEd-FnQB#qeFY<08+R
zI#o11RA*IV8$sl&t7>}jSPyOO(nos>K^2ax4yVTutW9Pi1XkWfhhYP{#61Bq;v^RT
z`XysyhrzuPI#R?l5u>>4AuH&lOl2}PL{L4sVTdmXLZta6Z+{t1ZnJ#$+Iui&#Hj!v
zhUlmSv?#`bjKq#s>S$eym-6K0OWDQ-J?>ch6H^edq6m^2ld3Gb!!y_FL+dd&l>N%2
z0#Rjv0Yt6X0f(WeblFW^gm@go-0*}sM}P_H0}~xPXp+&97KE<+c%(^!0|X9X794Za
zh<w<x3{FMAiOS0*AS=GdwfFx(yP6Gjb8v*)a2kL}<kOU?iHxSGOsZvBtN4D?;{j=*
z{98s#zn!AA<eSD`+tqNT#j=K){l7Cz4=23IR~o01K>~~+RuP&&>4Jweb8oI@{S2`R
zBV85>`1G`Wy@N0E39__M$pj(5$eaC@{ws&8xftl^=upSbqgq7ASTEp_C}J37Kl!zJ
zn4tO@xAT(S4oGdqyp)SB?i5^uSe+{~fq&hb2i!DVLV>0}Xmw{H3{krI75Y|4<IdF1
z7Sh6Mr@AM&-aYkepQQ&SrW~xTtt}6Jx%1Zew)dKLvS_q&*O&#}Qj8|FG!38Jy;0kc
zf5P@$ZL__nb>iMzJM|YvWG`1=nA@-K1Ct$kUHYkS`~4^LZDrqePxHTac>8BvLGF=P
zYtO&UP8#&~XY8B{i3KH2^Pu}-j&m4{MnD@j8^SQdjQ{kMZghPn&~n`2G;RF(^*#h^
ze<<X4qP@NJlq|hB;gzkRlNqt7<|bQ~dp;3dkuQ2E!Teu0tLEVGl;W!)zC%vlw*S;?
z5;n90BTyeW`O|$&P5AdAzXk*ZNG_93k5Yyt=SM*0hD>mBihlWVCO=~e`2;yG=|2l5
z|FdDediFd`i_G>8$atMMT>xK@%8VZz3<e5k{lyiB>D;y@*k)5utG8{7V?u4xeIo*c
zJvJk+&(97b;?qt~)$r_9T3=Q*(tU{Jn-2oS)5>OV66mI63bEKA5r`!|5ESXT5d=Xl
zl7Yd6fxV2HuUy#XCt6?aJr93>z7PzK21BnO2_Kwy3=KXRLjGVw=>m+=YKFVjZL#GL
z0iMCX9RyU8ZI36$Z~40Hi=D_+kv1{(lW$|eKH$SA1Bywar@03rfx7jGqW@xa^gZ?f
zGQMbX{>quXfX?h>OX@toyAP9}uxWeCz#%HXobnG`aWeHbAKZw-W^voqqk8r+2-dsz
zqFaju*@*!U8@G*y`lh{L*d3;metv6{^U08#1EqH2<hE?kVW~Q;v^*`;MM4!lne%WL
z)G>S)&#oT5ot}WlHwr{>`+k@?rCTQTzxd;1;6cx>qt(4ljH&d2^7?C=s%qh@qUl;u
zhj9(@yH~TJajZ9zwG#PgJ%vH@@#7J~FxN*vI(n(pJ{-D-Ne>~1sS|ggq@H>{#n7_L
z`SIh%slM5v!Zr|P+63P2pbe#`U#87xZJ*N37oR^>J;$n>n<~`hw6xjwNxix$$#NT5
z#zcW0)m3j}*E+!OwhtQvG&}3&`aQVh(Xekf(at>OKl~1}@vv!0SSCo14Tu$NG|ePr
z1C0k&#pbzLdA^U2E5M`ro(jb|^qb?pI?<-SZOljPIkOYjxW-h7FhjbwGszi=Cm1of
z3yv0Z@9s!3oEi^-@h<d#h87DUNC<J2O9H4O1RM~%e^-1|cPD6x9T@YucPNkS4ny4O
z+;20};nmp>{-GXV9o74O{^2nj20PB+mN9Z>r(mCd|22WTPDJK$ym<RI6xS+-J@XeV
zFyS!Cg<|A1mq#d`j1*k_PKfB`4r|ltoA|qQJ4uX+ty!?Tt6l#opO26JtUr0`)cNd+
zVq&(B)^iPl4VKjEM)%xjN+958Kp_#X5`F@9&{s*XFXA?D8ai|+S;)1AQqrr1FW@Z?
zSecGLql0>%dCE}GNf*Wg^2!F&zKp^X0)yfCh&wy$>RuvW^Ww*Y1tq2Bxs8FPUdD8i
zK7k*CK7Rb-u@^oQ{n5ito-^ku<Ui$G>tv)$^xX?S#OWKvnDpBX6-~`&w5OF!-yT6b
z<Z7|lW}o=96c(QE+uA4xEm=p5KUzlDp6<zM2%n}Md2X6L(3xeJBYO^SdIhWe6Rhol
zOkpCp&a^YpX;eRA7I=K~uS3tLqzBPzPrABd_V7PHrk)J(8hRgGn*}kt0|!pGAFK?a
z1BBuLA*!*y>3I~$9-u7H(Ehs`b&#c+Z`e@Tz+Pp0SMPQ>#|x<uZq&&f1+GB%X`L@d
zMQIrt9>l++p?=tdm$<NTSDu1%l@u4-k!I+&&V9T0nS(Tn$s30gn)ntBBc*(WDI0e7
z?4*j3vX`!R@7|Nb>Rdi&<mzp52g2;Wm%IP4oj|c&*TSmL=HE_Y7EalXZQ_*mo3tk`
zes$&_1r@@LJ6%_Nh+c9RFhO1}?h*=2=k^lzxu}&qaNbuFFdJf7*?l$J=P}D?QX}1y
z-kN!W@lW!B*cD8jF{8q`Y*9*fXtKTokn*WhWmC%X0M7w$gQKD*ebQ;Qp#?*jT!7;o
zVwthU<hDZVLwLbR9}m+xiwE&`0)m1pSnP^^Pu5_-Zt2Ge7okN3uip0HnW;C{$>vN>
z@<6WIJVrmOUrpQByV|L3`GH~ZEL<P_2nz`@<(M7smcIf=o=w$13P=Mh`xnj(x6&7z
zrW-eIM3`@-(j!3FGl@W*5Es?-C&GBFH$tynJ4i(#QT%%KQIpU9q!&7l2bek`y=8B#
zIhSkO{*Y2kvrXQ(4X50rj^MoeQrU4m_z{We={1pY7r?7Qc3>qW(pILjx}%3xgdKj-
z(TiWyB`m{aSdtd|vqyQ^3p33Y>go^GY+VxQR+!#~Qs@2vWCcj)i!Xg#cj=yiU4gKP
z)I!|i6HN)5ws@?;XX+UdpM&`bVfo##P!%$2D>e;C&|%jxz|H!?%eH)PtXL?^b4Z|)
z?8#;DODM&a=()rhxJ{7DS-H)aM)Ehe@1K%g35BTjl%Heurrp=FnK47}OXZk!uP(W!
zs@oT<v~Gd?)+MCd&r)51H*s_w+hxT~+17|pX3sfJOJzXW8O$4FhIUu?)^0|ES`P-?
z0ybtETkPopMKyCoZDn(?$yPQ#US1Cy+@qGOGu&|NS;S1}iJ8H@J!@1<<%)K-F=e+o
zS&10a#^(QH>P*0TY}d6PGGr`eC?XLGWqgq#QHGL~iV%quuOSjbMWI3{l2ECHGDI>&
zN@Oe&LZ-@4WK5w*eZPyf*8cXf_p#RYdh7pxp8LLr^E|KfvJNuEai5d{7g+Y~TO0$4
zuyTiOYWF86@8pkJ|8<FTEbHUJ@8v;W+L3XUwj08_)zrDwoIAZ8Pip9|IC_<(M-qhq
zL$qnOy4KoOFWInZ444x=uxwKy96Mh#Rk>=-)kjE=#AD*hX|}4jXqkM93Re;;=InS5
z=jOs$Ws(FsqOtgdB1pp`<I>HWfjsRV(-Q-3yk9x3+$B`y$gM9V&YY4EBUp=>p0|~Q
zq6b7_5wod*)nMzqj%RVwdj9<4lV3$5QKa}p!;}OUglb5fT6tKVb#&@CZ0J8w|IIvS
z=c|;#K&2s}X<oJ$7CTk;?9qef;%)f)B14bTp|d|McyKtl=ezQP#CG^_R}Z%ZYa{C5
zS~?gN9?}A5N`6Y8dk{qI`0zE+HXbv^p8`ruk4O~^^Q<)s8gN99H{(K=0|eQZy+=Zf
zI8593;uuv}Pua~47lM0KC|9O)@K{&&B>oxlHAuVk_;Ka2?^QRuMNu22*Zk~(z+x`E
zB|<b5jIs^~@L^4K#)ZZ}Q}#EJqAoy`4c!^TJ42xNvZyEn{Zn=17z67Fq&w)$H0{+Z
z_WYx7M=~I9RpAXhm=EdLX%rE77U~^NwgyR@wq-_@LwpP){Nuy>Zh#>C!dc!C9zG5W
z2E?;ERNq*uw1FSh=yzti14qK2kB`<rF8S5`yqnZrpi_tM_I<rEp{+@x!-enHel)qY
zc8b#s6RUs~%G$os^Bd&y9wksmJKxwqa&QF1PHq}p8$~gP=!6&$_Wst2==h^Y=itc1
z1v@-Gr1vGhO{X3OY;MuEj<8WTv7Hz9dT&cj%^<+;f;Ht9K^j9t$97p$^(IWn^pms4
z$i}AR0~)uP*c}WX1P&wEXQ-KdvTLw);!A_>-3!xee;Z`&>J`gPVWeRfO4O1DN3jjL
ziRhl?DQ)<wlXge)>?BWb_?UkF9L`Hb$@WIx`>6Qg!#3=ym|^4M+kGtx1Nc<QoP<SN
z^S#;_UT>b?Cx8~!I^Ek#247E~{?_B{Ldt4M;y9>~v3D>9ilTwLDNr+g12Y7`zBad(
z%?RF;0|*nTTUMi8UP9cT^At^WuB>y-W#^vV_ezV~QQ8T{6h-Xs@W0#FW)n)5q7NU&
zqnY8b$1(`nc;RQrZ|S^9sZf5mDR1ZHCA6Y$N>a;S@vfaf!1T7KU}dO6aCPvGt5Y$r
zX5mi&sZ1L8@bd9_pZ{HY)ep4wK1D9$-8ldO`5^va5(4mT8~!r@fR&fReY)1r#n);s
zx+XqRLuM;QyiC;_t>fj!(jQAZ{TdF-Q8+>ZD6^>M^iE~v<)gHNvGA+1`$cK1Gkka?
zfCyslYoH|IjKGoGfHh=yBGA40?MN`Mv0YkrX{kgQ>4xTnkKb?Mll~y62mo(PYd6Jo
zy)l-9jIB(ZF=MNZo->wT{D4Ninyd_&Tf#;jvZ9#!(Jkd2FXI0J7f@w50ummtMj6%r
zoNU1G8}c9FPKFHG3p~Juc71++0MXvSqR`INE^)?ftRU2fEI)eJdj3$`ys0z7Dvpjn
z9Af+c9smCt1{1%-0ghCx;k4;Wy+$p9j>>y{qxP)S=`dvKFq@P^)wPwseoZ3BgzVTs
z%`-Wzwq`YM;Foxw>-m2Pyz?F&Rc{$+;;PG2?${Q0L*YS2TiWP0W}*NOj`1L%XyFIU
z5BZmJ6>M!I5_>la#uoQ3{rac>g2&qd=Ls)!=EVqdo||jsI&bk++z`i;-$gLRlnakh
zwPnk%_Y^zRhl1@@{d}L;YQ8ck$)vY6NBm?Qob@uCm%(g!Fl$<4d)7FaTZ1?&mk21*
za>O%7;-0sNDD4|?c}K`sCI(lr{$%6E5ac(EQt^9s^jhUkg+MV*c5V@G^Yhltc`Ct&
z;`{ofWmkk#J+j(!!LL8zw_?qcYWvU{drjRn+PCD4j~hS!HEo;IrpWfxUok+uQZpdm
zx#>}Wpzt*jO_oj~|KGuNwc^H+h{FLsz-$c0|0a~cVXdd>g^Vyp@CS9apHhXkZ`hAY
z>VTvlpB|qaWmf|d+L0#!u=Ng(%3@D{WBRD?=UIAe*2}SBB{t>GbI&l%+LDT6Oh>Qv
zXiq_u1ouJ7%&&Zh0)boBCg<dUeM|s|f($4CikNL)jeEWGi(44>!t%v`wE$1g5Smrn
zwaenbPf1%dn3#S5ln?Xli<1%#qvK*$hmIW8jyP7Z{G9ET{_uhvf9rU)Aww>N&G^L(
z<|uG|z=59jN#YnxdAEIR7nwL@oZyGiN|g-|l-Gzx=T`sF=jzjqPy3Qmq37=Ucd1Ov
zId!V(4rJUK<XU1rGkMnfk3RAy2$#WTaU5J3>y;}@4iL*AnrQm7_~dc_g0W(OsrRk!
z?^3aI19147?-Hfd%XAUf!6vlWA+u$<_NI~ThpDJ+A%`W5uL|KU0JY80(GCrliCZ$0
z;qnjNlhsrrk3QqusB#aj2Vb#-u>%ER7o@$b?oz?ABytG3oi+;<XM8x`F|!>Vzhq2!
z3%-6A&_YZGBO)U1E}es-mhwV_a&V)K-W$eD7Dsd~>*U0!9aT5%d0YDHv2oUDqo%+5
zHHsYyM6-3&J(80U30-5JyWmD8qTy@nl~m7pyl+kQwe!Lm3R&qW<MjKaGa4W^!bn7^
zDl>T{uH%+QpKlhUz{$LN=gwBrCO1&`<mai)C|G?N$Vr>}WInMUSatEYNZOWH#l@q6
zzQ_eT)Xnf@7{}W{X(WgTzUEx(EhKr`d9}oO9lIy?^Qj?WKRfSXe&(WUjau+P4%wm9
z)O{f0^)N7qesj2K)S9nK<khYq<1Q{GKaTf?(hx^_aFK4(4)E1u$W6GhY=@--Qkk%1
zNgt$23~XKO{qEF(111kAC&VNySZ%w<g?e$ul!wo=vNpr5mti`+=ES2T2r_}>Z?mmk
zCi-Ag6$Im3^W*sn{2XM`Lxx(mY}q2s1(D(qmy7;m66N2zZ6jV63>q>-wL^yqK=8a)
z{7a{~j_cST;SrvR`-sEtZ*H{`;A-^f2HfDQ;5J};&}d&CHfRC25<c&vRNphx1<qmE
zGP7IM8nG>8R>E`M24w(Y)CAWgZ}WA9e0cnrnf}YLfz-LJdMG|{oS&C)m99=5xezrn
z)!{wPjB&E8On@Dskh}&6apd<tcepDwDS}->kI@<XGpnF`;23dB3=%<Sa1uqx=0}Ts
zmwYVTAuJ2R(8*(;juarm8x17}ih9XvafN^N-S^q#5FK};nQiZY;cF_l)8(^iKs#A2
zrPHq6ZLHJ;E>T7zxtJk|*uH<tqq>JpQm!GWREUclWY-EEl^J;*GLF|b(RJ|BxTK^I
zhE)zvU*$?uO9af!$}<0(A+(5Xm5ycwsR6+1jxH`^$X-Dbl$EmiH@?6-skUx?4Webk
zt^;Z|ae-(CQ1i&j0&e3~N(<L{IaoGl@HChe64UaE5BWPdZ?6gqzu1j#6K`V%XU)){
z)!3OM^M8qEY5bo4N=$DMd2Hr~%xvV>{St#5vN)L5O6^x--U#HmG^$>wlbyM-4;xsm
zrCUsbzNLund|?*~%PDhP_tMp!MKLD+EP!CNi4;O6dZB$?@9v*p+jMjHjgP{O*r0j|
z3RLH5jcKvviWNUxvZD;l>Z_@Ec9hkxbao7ns5FaNDts{8R%9Hag;DjF(Iww$sV3Uk
zm~iB|GM!~b0DoQ&Zl?j9RfDA0w`j@8z)|r#ADoyq3d)Rq5;zOU4kIVZ)73LVzsJKs
zMMl18_v7Sb{AB@5Wonh^|M`1ED<=>Oyr7y=?%{S+s6L5mZvdJT1=N4#+#jK5wzeNU
zlC7G^&mSb%Zsx$r0mPNwj9mHlS<0#1U1rn+fYV{r6~Iqq!<=#L<Sr_ayFY-Mqcz$d
z-uL6jk5a;kA;s#|u}6;ldiYC9N?1uT>6S=M;A8YKYw}F5tIX<eWjce3)u4J2>bh6B
zGhuheM@MiGitb+K;<s(vW~TANrap}X%nP-9cXFoOY6kG_j)*`*fVFc=Iui<xJzV;O
z_KHqw1G!f=Or%v6@15W7GaeHm>d8LX9HK_CCza9INZm&J&N@q5?W^8Jmp8~NDv~0}
zLAR2gVqR{{2D7+31u5=h-j(cx8bbOoF<#N?52Q4)rbk$S^-|fU5vr~=oC2O0Y!mnj
z8Ne0hk>lPNm?rr1*+it?ySF1!#gSRTL$Jv#K_ozI=eC7{F&2ILq`%7v)<$JL#LNl}
zS34bsD#U|D;A}=|M`n3$q*Ol1Y6ui5yoP?5LbaM2a*xz^^30iQ1qD$;X1srI?&K6x
zcw}!@R+e+UOq6PK7!wDrdKuBs78%tx+Exzc>B}q#@Tv&D9MW3tDuh_ufs5J$BO-y>
z%F~Y4xv3f5GzQK`yeWZpI)|FoubmKYh^(J+YthKU54L);3loWKwVHp#0fFj@#%{)-
zs)I+^kRH{Mab=;7k=TeXltKXT(FtH6vDa!{?Vf~lgZ^H2zkkVIHyDSkGl_kD?9_)L
zAEVM<-SzjWgNIgcKHL?y5w1^GID^}FN^T!2yLzb-XETHZItTWc*<{Bs5!|tVoS>Pr
zZ(!j#&u3Hw67h!r`p^%A^8575E_vma!>deYHSv*+Y=C3oxZ;Q#`n!9kojyM3kDAyL
zb(;kA{QRoZp=}`@r9{G2W9P-?tbF2>>;B45^BRKDj(i4?F}lI6;21!C8C27$t!?_j
z<Dn69!r+ra60p~HWv%t=+n!H$hKGfXfr|%#paeioB+K02-HpC7<l_a}V42IsDP<|6
z@Ko#;Bp%`JwSxhH%I=w-1|OD+g7wpz=tl(H9(M>1ncCEHynEs-CPR|YD*%*8B}kS(
zdd4)Ji3jHH*75hlH<r#{LGqT454uSjpg~Jw95)Un8$<C2ZrwVUU?wG*qzTY<4k{8`
ztErQo2%bfm!_buqmV3fAhUyu#NC?(ig-$^s?zetgqra%?n14+bqi<;?=qbe@ThI&c
z&{%vAA)&h^Z)p*UaEzd1yWC9x6!yUHp@;-RU9_h5_Ya8!?6#o22nblSKcGQwH^1l9
zZCb2Izou?dM_ODeekE44GZ2m|OSFz|Ge$85hT&AneZR260De93VTG?AYK)uN+2UUX
z%SNM>1-AO8?})dkxA1WV;Sc?F@gDf8>(evGtef?0)w*?G1{1(t9^-aP!8y|0y3t5}
zD_Vm}+6qc};Om1=p4M)6&5fzgBb5UU13fx=;k)<m(<k|MA3=h_LR2hF6CdOYHR0z6
z+JBH`VpK4~Q*sah$7LWDT^tkix)b_ORyFA7V>he@#5Kk1*O>*s$QLkMlh|0)y-+1E
zAXS5Qi8#?YxoKQ<Y5Owm9VO{eOz1`sMFjT(_&7Z2(AMk+`G>7KYxH+TTi%*FNLFx3
zM=2*0F*Y3~QDZ>yvyN(NVpUi6{d+N|PA_V?*Y^+h)B>iAp8!>&s{S4EefEL{Td;hf
zSq!^qH)YBVfN^2CF|>3B*+{xN4YU~Xvp_n~olK)S-8<|XKRK}j>GcoBCr|;f&q(u@
zp0Wt9Ghv(IkQ2msl9j|+sJL!SbW*^l-LJ9+M4%4=Hx&PH{#}||S>X2M?BZ?y{@2Y_
z&6$!#nK~P-7utbvj*yUN<O2o(=0I2J4el0q6lP6mMe-s}Uq&GR)+;^V^N^SUzk${a
zH_^-VkkKD)m;9`lCx1xwrj9SgOs{XYLAvS=hbCweO5NPuWt)Z!V=`GP;t2E<D6p<S
zd2;?*h0lxi{3+gf5V;5LTJPM**lFsijP!$S7O{wHF${|h!x2G)XWppye*}Z9R?5E=
zqUXkg4($_A{N{~U?<4X5>ZSkw-cEoif;{&34z7b6&!S1rJM;3y`5W2U2f#Ra#L#sn
zCa>$o(FOh???$<Su)_y-894ClwNUMbJg`FI7udpteS?U<>+Xi^Y)q+xe4^^*W&<%-
zCFhD{iLOE~^&`d;NsFEv^1a5PK|!Pm=z1UgH|4ZUcgpf!#z^pH3widvNo|f+LQmle
z>C1(*z@^uAmCCeGW1E0Xagq{!u}s##c;Vz}T;JLwNFS{9obdzH<Vc%WtV%@2M2eux
z3}C=GeQ`x3U*Se}jAS8R^3mxjA%GM_<ZI+w`n4GQieW1ws!(cW0l17g^E>@^6wxkc
z=jz%Ir*blH_0cx71Qw|Rzg@qpQ(Mb+!)LnuJgRr0vOmcrB+gSqUHzuD){)3|ZQCm2
z`p49QX!K;87`2{2B0yGx>H->$Vq}1LKj5E}LW|NEQ!GsYR^WZa-3?J2>Ff+I(^DMw
zNU~)t`TF|qP}Hr{&8TPS6e9aHMiDLb(G70`Ff~IopaKq9xmf$jPlrR!e807>P%U&5
zS8=eSegN(7p4=rkOgN>q%9l-Oresu?2I?AJL(cGDTj(6%!Gy_uF|R;+x47yk{33Zs
zGIk7HLjMQ3aIv?h4SXPM0vbyJM1{<w#uhz}kB<+0=*}1Y59qC_F1rrT;fH(Ft?@CN
z5?pE1#*s}Zm*1d`9<3eR{XoPab{^<JG615>nq;sF4wuc!3!ly4S^gm9$PB^MyZyC6
zq|fz3kjs%8P;<fk$0rB+1v6LI!<R#z*#;v&j^L;?>NV;(j-(GObKbvaI!1%dQY%Z|
zyIPq1p`!&|(o$>P+G)<51ASHNNk|cXAZvRQxepB4jLfQZgxtDB6G!t*>!qLEeuE5a
zcvrn?!#Eu1(m-&%G4$Dh2P4h7K2>Xl^akg4RrkG*v{r%x{ZUZ=04mD8WCn}?GGKWH
z-F9>i+1ZL|045*J_z^SLl+`B>;a#eVlyyV$5AE4+`RQ+l7d5tQIt(E76_3g;z<3!W
zZA+gYiV@#rM2;1ud7FXAkF4>HxO?RCkq~1NY3A!r_3yEq76cG|*SgD3`}Xc#$P2DU
zUA}nXHRiWnKu<wV`oV;polrYJKS>947sXc@zas?GAg(Aj2GP`i+-L9?V3ftDXWABf
z6z8BXWwyG<)3jR;Y@HR*`yV>G;1r@zWUdDx1?zSQ4jB6lBZJX&3Xl_%e<tsyQna$R
zW<Qw{Qlg~m)bITIQQuj;sY|O>$nncbP3PRAKE3Hp=itgdNs*hse;<pb0CP@cD(J4)
zLC2f%_nFPwz??0Nh<JD&n|d0vW0}GPbPMeobU!n5J?cOaEi$@9hy+)NW8@Eoy3B0+
z?Yj@3xj6?5H!y<g>}NN)bm9y^Ktf$RtQz@)DQSRQ#|83ZV;n0JVmg^lK)I!=sd<~+
z&A~jtZIYZ)pVCUa^pK+g`iumR;6chr9ml_Jy?O=zF37oj*_Xnw--=JurA6kQydx>_
zw63A!;8RH*`0SS)d7$P%x|hL&!x@4Uq?i#s6n^n1H!BS9qA_58CZa+r>bay(hVUkS
zdUXl?6|h*6G%SfTb2wM8&)536Qw3A16OU!v7qP7+x}vzU=G0@_|3jnTzU3wpG_B)z
z!c^ovF14auDdCi$ftlc{Yjy<$BE|dnd9%>niA+_ZhBY%fL<2G)F1=&*K&L=Y71K@{
zCZ>wUDmtngViHE(Mc^PB4qh>LE@7FWrA0Ts3KgRpyU2}Ou21k=oL03_Dqzeo=`Mok
zFPCs}N%=ZpS1Q3R+Mdj;t`z|&DfmB#=!RY8?P0d({$+q((hX5e(|7NrLm6IM?M{@E
z>Qd_cJp;@a&5PlYNMh!I(7Yd*IQ#8=q}eC&hEB25mGeTYm{9h+nruupC29>C2|`Zj
zM^&SsyE{4pr^wqQqVe|Va`x_DWfM-7GI_7D8dg1TBkrAtIF;g*VnQO|spbeEKs))P
zUE!vWj@pkxWeQBdB<2PH{Rfrq_kSTi`#$nM%rvy<q+Qxg4F>wy#rYsp*oUr3X{Cv_
z_5l9`r5_MEz42mLmp3#EEF=XSv)||(pLRy(W@d<wSn}{%U3JjVaUS>aWcrOa@m)$r
zmq??9KOfw`zk2a)k%f{XVJc+H6t=+hD8i!?WpSs7eNaaUDnNEEaOmiyWBPh!!;ka@
zx<UO|iFo1P%(`0=zE;reUQ#_(h89Vt_>rm4#Z9ok>s^J04I4s*-lD9r(JLF*h><N>
zbOF~`2vMeXe`@G@3TOc($hl~&T;Q6;p#=Pw`Ne{No1Z2;z(vtLWWYn(GwOywiPzQy
zHyi}3BFT0y8A(Ls-`|aL9n6CzaDmiV{8Oa9=WnUI?QBN6m$N})!&XF$Se9NGC}I<m
zzkpl9D(&0%I;kM+v`qRirX=tq-yB@_&9OG!9(JMp9|PXY)1Cv(BTjH!b=XAqx5yw3
zP+7EdUCW<qh~#iucJG4L{o&*=YOql<8rzCKiyu1jovI1K(VRB=-V^7pZ?39r<zVwl
ze~QUF^30xFM+aSC&BK>Dg`@HZV;lWtj_v8O-`o*-5tf9L0nQ$oW!08&e+46zxCS+%
zHRrivE7j&NA#Ij7-!fP0=X#u{oLpS4ht2d3Ja+6@VeyeRxyT>nw!_N3dwjApvzo1^
zhFIUDt6cu+*-f;U$bX#q$x`e{QCmLz$d+hQ6PhCxj`bh7VOpm}$fwY`v$MP&vPgwz
zX<mB?NlUT+CTY*8sv%_0TDUNX31VrsnNvYBj<v<~So3V)2AQP+&ATcTe?^7bRO{1L
z9$RsiQ5)|^L(`;nPtlW5<2<}keo)U5m2|sN6T8^PU*OrTI`jjNW}$NP=bRXNxbNoC
zxB<{$0%6_2*Pp0GN3{j#jy}jP;--$THY_he+3i{JHuz6NGA-G)(^=Ez5IJ=bI0!V%
z6VQ96_4EAFPnPL+*4AIQl(maIkZI(Q_WbVM?G!T~QXVBl4n&PNwQD_!(JUSc;|$^x
zOm|GS5wlg=)}|W$MS?C$L$;?<xToJcIQ$_v6Wyj0gopVL>$%d61Ae1A5zLkPOJnc(
zL_jU%!62OqLRIk;c`B`;A<?e>*)}|6NWW!oCx&YDJFd_0HmFZCs56F$P=D!Ag`H(S
zLoDybxe~vbaKx-!3)!L$zLEaJYYp!bh^ZTz00QPo>{&!9DBvyS4+TJf-1owNJV=}w
zMQ_xyefw;R)^KF(G|#jDN|9{)hboQbWjlAZ3N+DfGRLzc3fBOjUs&H}`T6;c9Tr6G
z-78IL6$L`s*RR@!hEtuZ>wbBC;Z;eAKbVQ&UBq%F)vgToZuIwWNK`+73yAN04$cst
z>avCeVBgY-|9IE_Ucr~FUt7DQ8(K{Ty;;h?e|U_~S254t+`VzGmY#Ma@O!;Ur7?QH
zW2r9c_VDy!bTIef!)xflU3ELQCyJqmxkn=aaM+cCYbg?&M;h&R1_BbW;xdP?_a9}G
zJDm<^vZsbgRLm_m!5R)&$KPE#;|6>Mqacpr?Yw(8_Bs^1abo-dUkDl@2n*ooNWD<>
zi#2uyfqJvw^2P;FTe5t4*KXYoJ(;{wY<OP2yiBZk$EdMr2Y8;czIpQGM~}Y8f-<3r
z)4+)00QZ0mm}BP-O~%Fv=xf>AyLEstgaD(4^=SXF$4w-U+QG5|0JIj}&*{4%388x&
zmFpu!j{y?|iZcCYoq_huJ^w7c1^ch|VuEeooAjjxo*gNs>Al>*#5tHc2J=v{!u?y)
zu-~LN9K7tUGKGlFUv!KDNV-T$Mb!sywHKEk!g|=c+slA}2R2f6(liy64g-8#-8mN6
z2`D08(V>+`=>yL@5AwNsB{Nvh5rZ%f*Q}f6Cki$L=#ok3Sc>S1WKl6V2l;l%vSkOz
zDLK8=>}6hX?p#zH*lQVV|N2ApE(k1o&%4)!0X&<|KQli6F%smg!Hl7gnEFmnV*q*Y
zueM89Uw<yA8~sKrz;8g4B_1AEaTTHLZGtwAXjno$dhOxET|AY(kUG&ifvGyk82WHu
zg*<1=bXnfynX)*PNq{@N#ohx3cqRU(fPMwx4gZsl0G%h~j9L&s#T|4YE!mren`*yD
z3aBQT(9A*nj-o+@Qds64u!`!9V0Oup9V6EKe0L~mX?e@Q^{7Ku%(#RKa4WM$ghm}&
zIB90=KdO3H7Byu5v*b?^I5Dor0Wj{gFi%YcD&#nJmPrdw>jXx!mdPdtHeF!JeGk+_
z)6kJIZ;guqsa=->OhNqrYm;8%m4ZlO?Y+G<xFc-g7NG>$^jH1Sz)HoqyRNR)&&?LC
zC}d(N5xDp>U3EX-ro?1vUF-W!ijDxq?T4+}$?xg$(X4u)fIzf42{xWplohdz`RrLG
zV{vryiX-|53^%2=;=$_-9lB52Yk2(R18tZLxWyR8HSELKFtGbpi>-Ps$;=e#8;I~s
zLjkS!rKCmmFrzAsYKl3Pk^Im$`qLee>_Q_?DvEnO^BVA>2&XA+W$=NYZ62MV(SDUC
z-87$Rc-RaNSS!dGaq`qPFt~pG`j{fsS2%K0;eLrzQiEEQF)J8lfX?`qO+LTawZ}>M
z<Gr{hP`z^)5J8f1_`&`a7RHvApN|EN|2)#xSIU|fo*ltIqj^`z%5LUq{p^qKftTZt
z^Nm=gF!O@fZ)>g>;sHT;XmSK(nzrXL{~@(k6N@O@ZA}_CjvQQIr=Bi)Zde0mDROoj
z?;Y^3-Rxh82NSm9k;g5oE~x$8QIgxSvU2KEC<~)g+Ya3yc4T~nzy=rXoU8kzjZEkg
zhECBPsT{bYV76cgqfk9@ltLK&Gtthtbg3}(mn*+W?DW;azTq#Cn;zWrAS;UKdt&vE
zMU=}|d8)7N_MA1OCP6?TivXm5z|~_c6!-dF-)7J{y?XzCGnyJcl@kz$IIwaA`D-Jg
z!FYCRiKiBi#k7qHT7kc6t4oXob9No4{aL0QG5mo<mw7XKA`9X_6KD*=Zvw<iUD1vt
z*VWK)4@I^#uULEl2M}s+G>xXk-o7yL*f9&Fw)E!c^KmyEE0kn$Hm)KL{ZBL+0U-7m
zZ4l2=N^@xNv!9|Qw4$A&=w#?AYGhM8;suSaA6%t~!!g@9Y+dfRSd7K#wK=|SOs9wJ
zaJabp+<&zIJC?Y)?I$TECFk;tY&Y+sFd%u%!m@Q@uaEI9VYV{Bol%#>-O|$Q8t`!F
zUuM03z@|p@rh&KGwq?}aW^T)J(lEQCn)G_*7YkrYUl+m?{yRo6kxwGJg#*^t!$DDD
z%guIY0*vi!L$&54&kC&tVDHXpfzwUppo!<!*e>Xu+EciK5)S~+m7bk+hn!#PFLB<X
zD#%&58j4FoNs)iYwrp@EGw0cv)y!jP_41>cKDSAHRct7wtO#kQIBen9HHODN*}@N>
zBEFS0RsJ%^DFv4dNGOWTH|`3Fj+E`3ouypIlCIr}?IKVhm@!+u=ES>I1FmW{M!CF=
z5|4UjeB@Aj*TH)JKv756hiS)~DSLJF>plXIhLeCC+qNjK0EY#-?o2Qw+G=J;CUAkM
zx|t*_di{F6jUJS9O`K{JmzUY;)KgXW*>(UFl3R`LMj0SD28kpBHTJhU8_~zF{B#-`
zSJdSc=wIe6X*)E01g(uJ^B*YG*%LkwH6Q6Esf6~Q1D(}jazsB{+4@KtWw%drT9aa0
zf#k&n9pF3X&({MpSnRc^ysS)?aMNjg0m+`cH`w@v%zmK1BhV?Kjqlufl<T;~GI&V&
zgjr%3=a{kgXq(Y*21aun`^IJ?n3pLrkRSdT-3wQ7pPBc}Hx|e@zzMF=fw6g2H&kir
zYx{(R%`~G36A>IWkZL(UKb-z1EAB}kd@9`(gWIx95sRJ)L`bpb)C(oPnsNJ`pFTP^
zO@6;v1wf4Ruu)r!;wLmTZ}oc>&moBL?tmM#9lEkN_X%s44?*?T!gBkWXcqyuGGsOL
zllyYAM0UiGFmMAAk8!97VzvA0ZIazsOv8~uVUR>{&p^D)I8vwR5Ri&&w}4}z+M8H<
zb@<3KgwaCxB{xlB)M^tZLe__j!*=ajN|P?7+t-Z&4XlFamrzJBu^Yc-T{K=A&f`Nt
zQFk^wyve2oOav{lNbCTin7MJI&BXOQ?$&_=%<GqNc$1LR{^e8(MS-Xj?J$FzMyL`C
z2O5T5(|+zwWypUH)fS4+m&g<-*E0hXe;j~hCYnI_{YQ4o(MCfQfW`;pPKRhj=ZAi%
ztfJyI3D37zwe0eN*h(s4-eqOc^2PI&KR!z-Z*n`@mK_$9C<of?nfpetXBr?Pc0W*O
zMn5f>%#$6X{Lh+id6R{m;{CN)b?Hb~brYki*QzKR=BTPAEG?KZ=`P2>;Z!Sm&FBlg
z6I+%m&<#71l_cY%#~vKNdKeKAwNJekEn46}c#}n9L}R>Um<ig3@RCS6n#sG1*-_-?
zL(3N~akViqQ5lL?Ku}QRU!cqn_3HbS-z55uU{=6ha|Asa%{3vSXbfDGjfMp6FUltF
z&GQ!bR?6B1FnD8B>{8*&aFWza#9L@1(eThbe0}jzQUVRTv<y^#ulG-H%TR{^xZwRl
z(a_>dX9Qvnw+5#CKAaAJdo=lE{jLLUg1yN90kW9TOyht>-A8lKRl{`VC@{Gxl!oYm
z?DSNVZ)7pm!DbB=)S2|TV>sp<EsFe>Y}Y23Pk+J-=tO&gs7Bn$;3K*9=v(%JLc;-c
zeLsX~u^WUB<b@fSXeNWUv>zOT`4U<AP0X0rx8DK*$&N{G9(8ALpPK4NX@?*xm?4=o
zapI-31>WYQu-6Bn^J_Z&Wq_!2#3_sM@0VVW(qZ0u2^bOH&mS-qt<V~ZwGlW|p>PIX
zH2&oEgbCRoaGeuNUX4!q^kY;Z>JFv_jArkiTp#gKe8szH(Lzid=XZF|o+k}G7x##n
zl6mCh*wfObFotI{H-@2M^TvVC+xQ|P+~k~eBpl!|gvN`cH^*7QR-m%N4<CAR{Z6{%
zbYS%J<k_?TfdeLho$|rjWYtMui-Jqm^8zywN>r!bG0(k!e>MS6?h7po!NNvgWppDr
zEU_G*{FF0H9(80eho~tNAQ)OuQ6U!3rbrBD{|y-+?>H$sT*Qwku!c=;T{G`Ra%T1W
z20aP;h}27`&0Et3ObkGr>A(;ocY94uk*VTX`5!fJXlc8&9s_P_HSUd`RFp{A+-Mav
zwB@M!L;uRw!VTT}qcAGDsA|GbWrA7^03iz;W{um!EtOsHePc^DhZq?+oL3wHfGp?}
zR1}0-IifgOA}rY?#t~<z$R7DM2}?iGP9{Crp%<zDW`=FjZz7o2!JQOzBoeRK`qz+M
zikzY2^v1Pt0=>+Yo>O>mnxsykauiDk`mtx%HGntl84^IaL7n=lv{diW@5$X@P}$+J
zgLpUF+1Zr9uzpuXdnQ0#=qv>{qMw9B3^goz=YU`GTs-OdE)i(hRgh`H;c&R=^Vi(n
zoIOLF-r;d%{J5!lUz7G1>{LWf#nq+sc7~vYe;22GK>>svKGXd?0gu!wlNrLzn42>|
z8$?gsch+S^sPH+u_aY2EoWQ?C{?3FP6s0A<lav+{AEyEMt&QOk2qe2GzT7GUg&rwu
z2T&nN)41?Sa`0x^Kqs?Oc;M4i%o4DGS8+7;hX(B1Hrjr&QPNlGe=LoDt1+DmP(Oz5
z^36RvZVoYMF5hNpeu00cNMW%CGSe^#9p?6$2TsD(9jX|8USOL+2X$hUGc7~Mo{pWb
zGm(mV=c?XEH=%hZ9?r{8io0t)ye<DVoIwa+I;2vQARx(&L)aibBkoof=H;9D1=AM|
zbS155e>Rg^t>W10AUu;;6(%NI1QRD1@8knv!j1|4BE$<w4TKovxf1V73_^8#_MF2k
zk@y!f#3%NiRJs%md|E4e`<w9BB46QK=OtJ{#&O~9bK+{ytcG>nkQQ(JfEB(J*}FNF
z!+%@=8&FkOkN?u@B{R&BdegpF!{Z7BOOd=kHuehbzwIK&Zw~SE8stK#v_z(g7EH)c
zx>OW0w<dZV)2Ev|moZ9G0NO`s4ax1&5VvU)cGkNV-qAqscTIBec;?@b=pkL_MSeeb
zOW{eXr@M@4@hK$V%Y*}HrT~~|uZQ!Qe+*xwqGJ1ov-1os8QBDB%XA`I%D)dbXGapE
zSH<T~;snp?>dwDGL((eg^B!>_5pg%QrxZr0fo5Y#jX00GFt2a%KWs3kQrX5IK(+ho
ze97`7EQ=E!_5}#Uj#|yVB2EI}jG#L9nA<Up(Q<0YewZDke>w2{fm^m@A_<bvw{vGE
z0a-seRRdTmBQLKNNU>0Bah8o#t9%%fZ3ikKlg&r~NpKP?aID0zve((G*Wg`}mOd5&
zmp_)cO+if$M@Wn%eksUU5*J8CRrLxiiWnyXS%mJbn)v$LmJY-A01HTVk#oUkih5cM
z%`3W2UX!#8DF-&!L*FPx8l!t?m${t}Zfs~XApB5PP85snVGM-0MvMk=4P?Mf+S3&;
zYJmzR@lnwySpC*?E@Dr63<agx^Uq!?2_aeuhYlTD`tGZU6|DlI^n&Lf!ef78GrzZB
zJ!~De4s2OY4mk+Ath3eBzAeVBNJ{wCje5mRl~@iorZ-#p7~7%<_XerCttnFC7g0~!
z#w?EOj^Wc~t{y5kM@A@-W$D1$3AHVDO);iT2;LAU51=DO{UBmb`egBLf%D+G=F(<?
zoU<D4M!$m%p|8*s-|(p^kD8x1HF3r;V6F`)95HS6*7s=gA~iD=UqVg8WraRa+wO@2
z=RXjK#1vO=br~<Nt}H{M_g;O{dyaGpvS}`=%I#=NtNTr3WbumB9`sZc&6J6KZ5)np
z1Y3E32I9UAM^gUc*Sr_0gXxrL-iNs;Uxc?|>@~5!&+vskf1RyDq#KzNZUhuuHhRaC
z|4F=sALGoO?m6o!TLgiqfo(GDc&LOH11QNQ2ygkRR{yy-FPMsOEwT~{tejpQC{O6Z
zrRlI&T0u?q<jlg&$Q1h}8eMd-*fZr5ax3!4p`%B~?{Yn;2M~sA@eX747GzV(ikFb`
zhzmB-6!H8N`#6fmfdU&7zsm%Kg6{85ceUmT0@`mwqe3CB!(MIIaS8}EH}TB)by+~S
zl_(3=@3NWgiWrfJK2b>#)yd*GYU*I-HvLj<T_}FR{3#UXh^8e=CAc3i4>M;nmKm%(
z)r`RYv;mkK_j+^&P1!i+z^Trd!QCpZmyGqWimyixe;&03|A^yDamOVe&A%>OLXX!r
zs=zxut{u>Vx%-Xl(WW}54?%Q8auhy^vhJ31`zksbXQmm&w3=W_$TML=p<s1-M?;d!
zf6F-rJ}JiSfgSo4oIPvtmN9CRnKNtsX1aYn{%7kcqkC^cf_eL)FSLFV4HBk%dde{D
zrcu>4fi^>Im11snuy1CmZ%A*Ux1=ZqE4H;}?Kk&50k^~Hsr+=|v&|ygtgJzvU%SvI
z>Xoa@C#5KG3hV%-sIhLh*3bE%wFq&EjS&WEl`+>0?66}6Bx@oU7i|>dXNW}OUduN^
z*YgL=;f#V8s#0(lj;lIGJJ=Wapyb75OdQaX@ZX~WO7jv@s3S!4B}B`YAB*>BH5MJc
zH+lybvxi6G<NLVWX`d1rxmuk@L_}H!52hh~pw|&`9(853;m)8vbChi-PwvLHZ*ZU_
z+_uncYbAFHEqte#yXVgR;vCBEzL*rstTKbVO>Rd)>@l`o8Cq<~6nx6wTjE~ww=oAJ
zM}jJ_W6MBABq9u0(GX<<dmR6`Dd5Il@UV;hGs>OEMTzI`A|u<Ik+wG@_<4*MwLr*I
zVm++gfcfj`H1AmswVyVvp4;2Iow~FPyfpts6yp6Pb_a&*CgW5O5GZzBoFIZo>u1~T
z(JVpX1klo;YuDnuP8{}m6wLw_0<+O-FodBr_02olb-`^>((gg?&pbqr%32SLIC^Or
zvXau9ZGeEz<FNn9&$oA-H((PTK$2V0NUF`?v0Yvkj4|zlS{0y{`3#BAKv+;vbI6)Y
z2iE)<l4_1Y*hgAL=50)*<7cNN!Yni~vj2|~SM0G7pgYp4I}NfJKn%^GHoQ%mpq~?k
z%;&UU%>fkn@Z!wIJm%`ee|QHR_I|Qrj6O;ff_Z5-evX2(YryrBkykPRl8Ioi0^%$%
zd_}w42K3HChvvt42A?gFTmaaQzGR4ajtSkN{`o4@mhJJ>p)}SiS37wpm?T7ikWhXl
zwv5=0Dz@HX6Pp@_18IqwwYPND)ytvNl#P`TF2G3Uu7mSr15}Llj-`BSguMZLQbdd(
zWb1ih3Dc);O;yM019eyzI5}W}N0qJ8andURl9f!zm)**YL*riK=AB!Kq_3-m69^VF
z?_zRgpMOek>e)pWpo%CYGTjfRQW2B`M)iTw5-+@6yX-t}T?bx}!A)A~lH`l?P#;pg
zMUCskslHCdL=Aew;{E1xZbfzJFg)Yz7*i7p3k7@T*Ed@2zO3F`TTm+70RW5Wt}7|w
zGS`h8JaIs4Yt06^z%6OX``klSKAHwb*<KU0>*kq9_wIqp_<@d!q>xyaU19I6fQ~z`
zFwhqbmTU%KVHHKBY~K{B88%mdBHD0?XPfJrn5Y@!HBSaenv)au`&UH{rE%0#OBP*V
z&=3s(ob=!h#Q$vMSaj^p>8pPhwCQy%(X1wD>sGsp=q982(|0KJsdtXu(=fqZ*m>h!
z6wCO$7z1`SYSM(Bw=5-XfyI80_YWDKDtz<CG^cjk#Ua}^FY&2uShL5b@xt|u^EH#Y
zu5YZPJN3Z5G?%HiW_rP{R`aaX-fVx<sFU?g>xT~p?|Rw3{hAN?_a_9;_x7p$$4E2!
zUiPql7o)aaA3EXSg<ol<&n(;ve!Nf9*U@3YfVG3QKU&u!dQGZKQ+g<!pkBP-2FMh!
zBcx7k$8}$jxUOCJ?%lHWh`ZjKjg9mth(>Ny1t-#Mi5nJ#CPNIJKKreFEGxfppg}@>
znJNwNIFn1sqKJDFj2d18b|6ZMRtH-nq*}fxOJzR^PkNA{p?2@y%Cx&1(Id0kWj&b*
zyl2IHO_TSO@>tX=5y50`mS70obDcz;zIw~!);_hr2XYi7`bZe&3t?0AKJ!-KLt*K$
zena-jg>6t?y&Q;=JkNY%&6Vv1R5bz@)5D!QIsXN>W<6JqpS`Zs+Ry<Ro^&uC>glhc
zR)?xj>{iFh*Y?H?(-RJ;>~h-g=f3)mjx94e{FN(*KWA~}2}J{d?+rjXe44}h8;%L`
z#=kttVf3LCu8V{dZx@!EHX=U_y&oNJ>)Kxfc|dQ5n30aUo0e>$PeQt($OSY(*s6ZN
zLX}=qmV|)?&T)1|no-Zf;<jDbMSdLN@yGM6K~$Kco_f2?P-aeVB~8N`Hc&jlXgq4>
znyj8?v2W1Ht6!To5HqHpMk%jfzWjRMnMz<H7Mr5khl3dEzUHyj?M|<M{#>=GN7X~V
zcpnHfj-ewkgiY8LRS`FlE_NMDA6!kO-^@@MA1S$!5A!w3e4Fey8`iJi{ag|A)TzyU
zC^Bbr;5pTzZxQ-2>F1Cv+E*3mG(tH>v$EzL?SUyTgo8F~-aI8RhFvRcx}JNQbKbM&
z?5h$!{?uik7Ip2^DdWRqT_(n8PG$p7XZ!g4-X0vBv9?aV$KHO8&$7$el)5|5IoTe=
zR(eAbEW=(rV?(ZN9HsIUqM6ga^y;|<s7J&|jIfL+M)8x`)*3+@(Ts@yGyYQH;o%F0
z6kK=gEm$}8xfm~z1vgN^PdjtF2QnRo12L`}#Y(kN{8IkeN9!PU@2-$(EDk2On1C$j
zy;1IYFgDf?oPHLS7lXdCteFdgtEbzp1&hDFzA2k>K;Ffm6(L=xL4(@zi4d%3@JpF~
zXu|!&96|P%VX^Hru2*K8{u<2)wWGkHaR@^tv4z2!*ee4op0i_{TIveLV;_(d;SP{G
zL`)x$+xqsb_l$`FwUJ@#aM>;+CuT(C$88H!qN<1|=m2hhc4#;ZJ_ReN>vT8q`f>Nm
zE(cT*NZDStrL?c1rcyx5qa(lT`F>=i1s6aw5A_JZc{Sjp^kvsu9dd2XKbJkhQruDD
zmM&d<jhEYm4W|iNZ^g?IFM<(3;dyb&ipB~Gc+ZOcs)u@eOTG-^7QXg6#NXHbM}h~7
zH9hHJ7VyY9$~VvS@0z?69&9EFPR1f(;Cu#7v6?xv1qdPk>hIoe`E1#yuyEpjQQ6F~
zeOGW=_GvJbAv(@}3+_cW-$7>~tMEAXcj?k)n-6`LlWmH^S|XH4kqdqg4H`Xr#&)sq
zB18<T`LSJd&yPH|jap5=dDfdz8*tcJ<afZE;_%s?dJM)cAEfp3)SW1Lm=Wyma<8JO
zM;LP0wDSJFdtdi{ahW!<H)U|6rcF(F|C2Qz0k26K0gs~45qlK4iF$ku*azvtSa7qR
zOO_Ycvgd;rWgp2l3LNqV$x|%LE59dR*$3fttiiCo9beB~@LhaliC<qnJs$%1VC^vB
z2tQS%+Qi+L00+3~J8j)sfRP7J<w|H9Q5h^j(Ji<iLw2%6DNn~EfR#Luo3c*_fhUG-
zes7*KioF3NYcV#Y-=J`^ei5{HFMx9k#CoWx{#eYj_my|?Rbz|6>`naS=-62K9>OY=
zhBRu;pU4U)+K~~5?z6ae8~^sHWibI<Gz3FTH3rcZXd~U@MElWMq1ZY>)yAa~5ejaO
zZ{p`_@7u^CIm#{=;mgb$FX6ih?*~RO|IsR0*h5PQ{ow@hC(<*}-J9?A8Va~8zvJ`g
zZKPN2p+nmfh_2AE!&TgA`h^4(8y~NPURP~$_C?vvjl#L?wc-JuyP09hid{qt1c^x>
z8Z^=iUfVrGZ%(52<KygwA_3Wi<?6mj^U6|vK5CtTgNpY9-^fZ2PP!j(2EAPG#V>{?
zWX(Flq`Vlg%VxIoJ158zVt%HKPnTLZ^3_t<zSed1f@kMc_~&9}H+fn4Cp04%oXBEt
zE(^-5lUXaKRX;&{ZUj^%i-B-hHMX&NFmTq^+QuzfT<42DSyr|u!|@WLP`;jDNQkvd
z=<}`w2H7CaM3MO1^FPZylo=1XhWM)tlpnV??XF!n#&s)0@j#cC(KOE60`F&r6vX`q
zu?uTW{fM%sj<#NO<z^i#g(+tjX_95crk~MrYlr5K-ct-7>0I1HPcKcqtj43VoQA$5
zaUncw;EI|B%~w%Rwq9l!q29ojkw)<QAs@9*kjCK(2%MR=b#fD_urqGlXvCfhG3^&O
zNn{{&fa=^(`pjPJX1e*-wmIdXKZqk#%h{F5-=~+y#=d&mkv^OQixl8Y+gB6xH@Y7u
z!meZD4jn<^;c<0lZrh6a^-!XSY+DDEpw2iu<ZwnH87PqIZv^oM4qqJh&mU+$iPDR2
zFB>Ca$ejeGeTrL02hP7ZDUgC4xjOvW<a;pwB;QU1dFmf=9YQ>p|3+g#GHgscqAd~r
z8c4(_L)#T94Ax21q2Qe5;^I#)MRRc~dG<b@A@T=CY1b2~<m}7$#n4!6_24o@M@k9a
zAYy`xy{3b$m)9`NbWRXe1>S?<;J$AlNb1i_YpSaoA9ef{14Sb0=92`Xf15=S4Kt@T
zu#ek*%AzY60HGz2-6J$zu%og)n}Qj5=n@$9KJ%LT(pI3^Xn+Da!Tg;~M<Z_&>YB*|
zV^>yw>BK4RZk${%|45@VuTD3QNnKi0NRcCyaGvuQSuKvzxD&2nrPhx>(GJyLyZBl=
zw<DBpXqrP@>Lw~0yBW1qUO0q0TKv2KN!g=Qvgy%MOdcQ&8ZeMP1;Py+@xq!%R{_a7
zckSAMS0ltFlM4(-2L0o83@tawYa%=I_{nr2ZT9E7Dyyk27_k4*g9nOWF9OpXD!PBC
zE3yWj^xQ$GhjD6URXj>B0zxx^`s%l;@sR|{)7@P(k%2zkHbz)S^j!Ynzght6mONlt
zQp?SmGPT~>mlbOdbI!O<vcAzUVyiGi4lN&58CElk5C}GyLF1>czzFR;6{lbJmF}p{
zj5LP<UbsL3Eie5cOIKJE#gySJl6}PaMa$dClJ@Fq(yu>>Oc)rdpADQ{svqM+_fI0R
zj@;e$$~^AUwDm(61x#yKQT;Oolw$Ei9=(AuTvad-mrz&ralWNi?0&oGPGaq^Qw2d3
zCp@O@ckHH{z?K2ajOG-_)yZW`mbQ^mN75&voVI8~Hv$=qq=<*Vkt~<9uTAX}ChnEl
z5(_9poE?c<QE7-_HWtQUrR$MT&<i|#r#TN-9!67q5n_o}gh|KRcLmF0yeMB&Q&Y7#
zTNLK9Jcnt)tC*!8)(=|BNYy$PCIIy)g48Btb$V<<t;ajw%_c}@q(wIc^3k#9=l$%S
zTLHgviPdOyjAJMj;4OQj7eY34na$<^H26$?u6VWUcmkmqX2h7{n2;%w3584Cgz$lp
zGiezw%*vo42A=GstE<F6r^FEr)uZJNKbyg=0JGNv7MHgI@(Zj}$1lUNL7khwg0`aJ
zX<)fE%;#HaD}`j;{&(U#VC%`Tg??F2H}HQo(8_o}6mPmY%apzNyXfvMJ=BNx7&c6k
zf@w4mU(Scxk7d}H$r{lQyA!|b;U~#wde>p3vf>zwL}3p))yZAXxR$I(mv8`D=zjHm
z6*5GcW+hQLGq6t_|D4oKX^)>RCuI~O9Qx3w-%c^~sLcpi06<cm%CEyKVLD9Uq=C<^
zY;4w3y>t9x$Zt|~85l@-p=QwP(j_xt@iAL)6I04@q$y7ZICW5v4vX3cljRW8JTLKu
zV5UlvBYY9(el0y7uW3KllIO=)D;{cSvd$oJuOw{nd~8zU_5EYlXx1!PSn&&lRW=qB
zf2AGvqvC{4X#qb<+1J}|Kd(XNTMcS0Tza=<Io*c}w^xJ!Eflr%(6hOjTn|0=cZ}eR
z0Iy`LR6zJDtE&3(0Z6NyE=!N__J>kpOMYBSKKsv|i^O(PR>9Ht>9J4Q^3@wEo{9MQ
ztAkeXON-NgG01d2N~M>WO@ngG{<R#ykj4prubyIjO|8SeG(R{ekiI^E4Ekj=0wx@i
zxmyabOfFl>KU<KN`Gd31CM!_yU89K`(yMJb_T(T#(F}+{LN8FCT@cDX46!MeZWO@B
z4a`V%NTo^Lb$aw@!nsFe-T}CGsQO{8G)sn`h`Q@JkziSy8Ld3&j4yJ>j*OSBrxEMK
zW#s`pW^ptt3QmCSiGScARP&QpoP4E-zAqCPvW%r0Sn5SzZRSNsAwWO+8Cj;u#XmFX
z?6>b9rxE4ZhtM2`XB5$&V)pz8&oPSza^b|mm@9Uj0#RBI82-yN?=n9LHg#A(_z0sm
z_26hJb>6Mi(K3X=i5zM$qHc`hk?j{ZIbJ9&oquM<i&>!%y2pp*f18P}Ub}O#J!Mz}
z{w@4zOOrZ1!w1C)u8*HF?@uy3s%@;CS^}7al0u8KU-;_P?ByGN0)#uxn>Ws5+(MZu
zV79w1VD|<dj%dYO6+OITO{@jKazfp4mrV{JK!$I8W#Wr!0zpKJLi0x#(f7=Ct>Ce&
zEH4)CNnmteYRj6h|2)lNF_s_$NCESYC+_9uu%C9yszXEAPm9EqPM|k9DcIF4IH5UP
zW)E>2HNu91fXb+M|NiUIZk{^QE0O44&f6!z*K_xzcA0zk)afrJIF`tii0m}%HesKm
z{c|oHm%HaX?|1CHrNgB;{xZEyYT}r?R3z;MY@?21vrbc-2|+hAn4EK2v}VD>)F>Z=
z5BX1CaTSg&KfS2=DsRo=_H3jZSd^34kr&vx&G3K;(Q$DbxK`58^o(lh_UrpXsYW1d
zJ?jM%TbS0J<><H;R5@wcuYL1*T<4I4;<mB{_D{?t2<ZoqK}c=LAr(G{p7Zxt!)+qC
zF%KJw;0{x=3?LH2XzQ0Q{O~2riX+jJu14Bl5<#A`)h*@?_$GcNEo|XUJO(T7{r2&x
ztaOz+k@683tQkU^q>rN;Kp)C1JN+e+!Rrucn|V{R#~iNEVR+_qEAUd;D4|6WLFJ?h
z4qec*AM-4nd`AEwxpXj5U_ODsDfA|>G-9&91H8y`<FWI5D47&wwHskwHtF$~q)?)#
zyUb97ND4L`dA){zhpNF~<=4})Ux(@ep}tXG+%i#ZdM-^J`o(!u+rgG2Pt^TW=)^UT
zVQ1W%z=8E)`Q?S@EF1NvKWc6<3j?km>!G{Tli87+XTj4!_K|bD{T^%TtF>|rg_G3v
zLoCAk)`$BP13_7y2E#PT!Fn%=RhW12pM#+iw%=pif+Z*tsqR6LkeIY0L=-rD=ZKtx
zjx<<2iFOeeNSqc%07J=+FqELPISy@siVYIeFUrDn{-|@WUdL|Fq>!y+YI=3Km&Iyn
z<nb>c?~MTJR#+RCaW)EE>-G7&8Uqzg>Ns-J#lf3Lgyr|8Z*{(LLG4CG-HvDxHPq9W
z>5}5FGyRSHo3(48qZ8M9b|J6v>9XVO$vt;<m3_45Zv=-CX^ZIW1%+$ayuCuigwGY<
z+&6LdE^|8YAIU^~EiZ&p0X>3fq-A9;b=shq9*zJfo4?F0cm3XR*q-ZW&Ym%#|1IBp
z@*^Lako<31^`ofI&o2y2>9cnKKF*7PPGo=yEdrq3U!upAdKR71jK8}+p#_z}ntf@n
zo?ggy*Tz*y9CyihvbTQn3e70)JTX$Xbs!LB25On>u#UsmtVQX~Z<KW?;Oa?<C+tCB
z-74N%A>F!!3Xv}@&VJ{6-Xfc74<Fuv41JyGv%B-*z~g?rFxC$sY^WD8;W~%w1nL`5
zDZhmSkVVLTcP8{@B`RS@i4I;s18!vdvJQKvVH1F6S3xSYRjYosxE?UDV5Rhy0G1+{
zr^S>Lj$??@#;*Y^nv<3sfqRM(_yB4pb?P?Cigi30*<eso(vT8!Q;*{5d^t(j%vy4`
z&of3D%WbDnK5%|#^VL-I;IF_fJ&g_jKOiUNlkf8%Uv33d(fBGj&bX^%n8OtbM&d#!
zD$h*2XT<`>qQKq*6fl0GOp=B`xxF;D3Q7UXO=J$4jqcE<Qp4GV-JeSv1f#JI9~Q<3
z))4{|%$>q{78w+9l%PU6@j1L#Cbd%_daMWKK6&&YK8m}JUFgM+8vX8jx(m0&CQPBw
zykrX;nzh5|3+(+_J34mBnh|OW!WUul#M0T1{>BRves`~~!WWa=SIFzhe&f@+1`)X1
zp$!GZHY?^Xbl?AsL^h&ubTEtm+V~^?U>Ap{q1KZvqhmz{B5pFUFdL}~=+H*7Eeby!
zL15@K4J@;%R2ED+eCl)w=CEn@9ia#MrB;2LeQ9l->=7l8r1ZAXZ>st%0mS$&E6k|;
zsD!;ey~xrgC|wa-Y^5xENxLk=X$<HKz_Dw&Ysp+foe)Emj@#%vu?`NBlKbAhmRO9-
zf|7mvreE;8F7Xk#?hEN$a5egXo(VfE!$B*gwq+v47iIl$pPDU{f>sW#ojDOw1R&QP
z0o9?Xe4g;zLw2bk3b_05;b=nT(;-Hd5r(bEKtP`xq34lfZz7$_F=Gx^(bUHY_0<0R
z@5JnxzOw56{zvpGOMum7%N*T2O{ghfZrYU$#rG(0ITmZmS4<#hGW5z?&1(?T%Ix5v
z!a^IQ2{9~-E`PRLH)I+kQPi86JJLIg$9`$q*Gpk*k<Ylt>-*`99kJ7~RnlaY1=r0r
zP3U}9IwemjzuI}xyM0%Ck);buOE<}bf;2B(+Wni<V7qru1X7oVg%iUnObZWPMPp@!
zu_G!b1FUrhOu%J{n(VXN<hFWD#K;k0-NP8hS@0@1_ZS!Pi8hL^eIt2;CN%os!H30(
znivX!*k8F^+Gv71N%pvA-niIYEiJ7}t?F2DM}f|SDPrr)&SjT=QWv1xrKEAxuRZmp
z1h<99t2*tBs3VKub{#E1!3ZFCZq+wE5ov`ibknBME^hQw0y#XR6nS!@fjS`^>Xa9Y
z!(qoK1CC$p)%j_<w~UvuD5A3H@p4+|rN$9&L!fO73k&ZSmFE<+(@dXrMXchDM~~iE
z-?luG(M~6jG9+@BDU&cf9O*Gmvo#PlFugQvl(q{Otr49dA+GoJuC=8>iY6tpP7-89
z3GPLB66BDjA>A<+t<MROm4{?9o3K$6X{YKlJ|baOc39A(m>n;`q~sNRnT*8p!})6K
zzzTt8uVBWueol?F5y%U$Ls^S53@pT_?T6J=XqW-X>P)!ECLk$o2f1m%)QU4SvVv15
zSNVqWbCLeAH#X|?3rEY?T&yaUaMSru%O+(u452`ew1y)`j97a+)cqh;j!f&6_MP&Q
z5H{T_;uo)*U|f{1Qr<<&>_lV9?$GN+fhQ-yrc_o}^|M^xhf_CzF%(}O5fN_1y9>uL
zlalMkh~HXTzN=6%GMbc-rPavSQM*p=%v0Q8rnfH>iIHfEMMa*@>2M&c7wJAc!xns7
znKtJ(U*+214a&%0Q?$KmP=rI5RF6<Lx<{jXyiq{indc2^83E#~zJK8M6TlGL?OW~3
zUOfEb;(pg1SVxBLHyR^`7V32C`-)3<)^<O#wT#`Wy%#+j#1u!_^bst`L0g$*5q*a+
zS6n|-!VPlCf}`6;$M(6f%v-Y%Yb-4UShW@>%HO|P>HM>~@rfO1*!Z68yzr;v_`R%(
zHO1g*vX4`GcUqoY_6jrn&Ae_ssK3`<t_|xeDvH)pN-}AVzNd=Kw-~Q6BwHUR%(3R?
zzluCxa6Tm2Nu_gUfjYF-*c-lAdd^I153}G;HH}*8p^jn9*|~f_vVjRXl7f8Y!T2V*
z-hiPQ9AcWy2FzJe15P|+B>yV9Ey0O66;jxvd>4jb|J&NC%CgS%HR2=9@KCw`?Rk;I
zy*4oyDWMz?1il+vTYnH@cLy31vB*R1onN7;d{nJNhvuLV=Pq10JFg1p;Exy<#TRVM
zEY>!Yxa1du@w_=#uKR)QDgFRQUl*+1^K?kSa5kdihCC;8sByCDpHs!)U*JHs+nrNa
z7Im4$MJbP|pF5cPWCK5k(v-ZgRe~1BO770Lh_N%FwK{N|34EL@+Q-JALJK<9yJ{}m
z$M^1S!a>@qzT>$aMZ*<NhU}#gp$-!9(h%>PsDHr>WLNOMVXIryyhfkz;_KLi(&xBR
zK=Zb}73k$gker$Bd%A37N?KY60P24SRODBek&31*n^<jCDF>`=e^=$n4fG{fPMel>
zZy`FbwK$W-)fr_N(VS!lLLL0-j_eQi8u*|JO>0N*v|$lLq4&hSuQ+{Pe+^1UakNTZ
zQ`M4C#j3Y{APXyBK2tGv6YmZu6cFG}k5|--Va5Y~P52H;ixf6Y)b<(kfxVy}@7i4)
z(u5XRP-YC>WSs|TaQbQsS-*|LudJ&PDHMI+ne)@3Ihj~MeHlpM01R_7#X9DgC^JDm
zh-@Q3H%OE=VJ3m1VCIyvcXl-C2|`XygJDO~z8}YI<mAb1h;ci|Z&nazyqD0Ol-idF
z9(^!U$6wQl@=mswaknRTXt;bMI=hi9FQ81kOo~feedhxQhuCL|g99WfOYNF7nYXwm
z>U>H{5yB}s-iRk9<^Qv$jp7k`M!Yik(0^ClSWS;D^q+h!x)_3HXFMdC{J{Ub@Z4<g
z<>!{ZX-sC%zOQK_4sVcXOmcmyqabcaOLUGJ|F0VtZfdz>Zn(sswFB$Qb5?HEO2^05
zFc(#;kbYp`3Fgty=wTGr9{FtY^9dImu63M;I{9)u<)i%lHhp|#)feLAli+ET$(I;~
zE)98dm7P6O3qxPh=R3}yZ{{)X<9GIvam_^;fZ~pFv{ST8jJcSMmABo|4u1(JkZ9=#
zp$ENnt8o^X!iHpsVzS}a4`sR+3<GG>Pc6$l$1t4mK0dWI6FxisF1pfiZkrtb(m%uY
z)Qf~srkyT0dWxU~Jh`|`kWXlgKBONzqi*{8cRsw$??7T0gj1c6XlOtA-SUzU_z^un
zAML1WtXv>-6LiiG9z7bxF;MtI#Rxwp(GJQ$0U&@{nz}|b3HU5oPam+jrHYC%2Nh~f
zRuV@oFL*tN4<*tb@c7=VDqK+{oUN<|O_h5HGKucE0~nW@ty!`yI30f(BTQeQ43C=|
z73e-lt+GjiJm+~Zqh4+wvcD+~hYWu;gC=V~e9i8p*?k2TAMT}rib76?EE#4}g%H)b
zXV0b>ZAjP4XwQUkUN+L&gN}mft%v5a^K;-($|$Aq0LY5~<zF5$I)n)i7V~O?l*;eQ
z-kou4v7ci!L8*d{o%uV>8P};;c(h_B-kFmEH7UIXC!V3*3lDznrJG>C&X*5ME^~Th
zd7GR=f){APMwf1h^aFp%u~Om+`Ql~ZT37dmRx{dOWbk#uwX78}v^g)qNqDZ>84cE?
zG*K!HS}V{g!93;XaXtEGOW*}{g90U~E(;44*w`UuBSg)C^9PoLVVbgnh(Ly&ks>cB
z!F;}I1HW~&Cs$CBh<ur=ED%mYmUg2v)Gf{(W-krlPC)(~&HHkQ_b&B4l4E{;9R+O4
z+3#|bESq;ZYGKB466&@x7|mI(t^puMXEc<5TZP?;3R+k@W8m{M%gPpf6j!7(Glmwk
zL5{aUD5NskCSW^rF-*$|h=@WH+=Ghz=9xW>VtODpBZ{^VN(Y1t9Hj_7kt83%`vA=~
zsU2Up-DDxFxwwhabbvNZ_v&{sB0`fjfX(TwWnmR9?BV0b;exKi>Wj0SY$gR<jXiG@
z6NKHJ0L;{Nu`IuY3p{wf%bD`OYdb|>0o?}L-ks`lkbr7TvI?~UDP+Iue*QKryEM^W
zXVOg<m6kR}^#_Tfit=5~DVdWlX6nZ+H~(cAt1cac^t8QtHRCe(8V-xni|K7y9?GnP
z%)^j^pDcT35u3Z688p5z8VeYQsOhyYN6P9eekXn0)(L}&?tfX?|1iJo_2a}#n<2p)
zoM-vSynV+`oY?Mi!JloUsb0T!9a-Eog-j_jMq1ZV|BZP^ig#3}x=n6l;33N9w;>;k
z?4wz<g)kM4w9~7$H943*<-(UlRyxdEWN+DgyOM7q0*EJ`q}M;FR(N<3eaG|_vkah|
z07-n|pK%Ik!Mt*U`Oj!j9nriDf=6V4i07GE-tC*x%hiV)1$h6gP%@a2>U#Q>OSunt
z$>pX#yr>vXT=xD$)KxrbV(vO7jkq|DxI<0<@#N+rAd~F9F7_TLPxsqe_O#`fHNSrj
zkXKDZL0CH5_SK6$59>zWem*C?%_l0cjT~E0qLiff`*3DQ)WiQm`T?CS$0nmKm5V$!
zi6-A;RE<x_mM$3@4Gpaiv&Dq$ERwtQdsr6{VxBvXxo2$we1-H!x&yRXDXaFaK#2~4
z-h{7Ay+q-!4k{uoEDE+U9-bycFt2<C<qnH{4UEo>arni)lT#-U#wcw4foRzw*oVlT
zV6NT$;NimoTnaS%(S-7VO`BqpJN%{0#0Ufs!I%*(d6b%(%_uD37{D~zEi=^Q!R&l^
zt1((vJ{cHhJ*x40FE3_uPl9O6ka)I0vnzJWP{L2W#^1@w5lSE1O4;5AxlkCm(ZC@P
zHiARa%-y|wf<xk8k`>Vb=dL-8%PjgB4#ql~5Q<7ekJbBpGaL(HP1f@#d2uI9P-Czn
zKIP|+YQQ?N56yEv(e%H9mt%VjT7J2_p`dv4id5xQM~)va&Tswf16{LW>gpfOsp@UQ
zF83ke-z88G9n}cMzLcCOa!34WNXN^$6YiPkL$j()Fvp!Vn&1|l>k3A<mY#`v<|NsD
zf>EEx>U%D1JU-=QU5a|X-6d-Ic>T><-DQxPqcve#0mywBh^pO{sM{SWFZK-H^eer{
z67;9|`t9dN)0+5bv~4TatZ+<X8)kUSd&Wa-#n^`@lbs7*N+$<5@P(i8kH<$;_p>*T
zcq_DMMq%RV)?d_ARqK%wgM)JiM&C&c+Yu5HbM%+;p^4VkzM#wydEy}`1vcYlBBzO%
z;7<<sv>c=Sv4R3uxD|%AFVm}oh^$2qZp`l!3ob(4&7dajrKMQ$>DfAv2kuR8@9LEa
z=B3IUTh6;IlopU5W@tNur+IB2UoeCVAz3?t0!r&ap?3b+`;GiY0w8;8gjy%g4HDl-
z7=!xkJjS2$XkK8Q5B-_Qo1U_?KDD55!JtbUxl7`7%=A5V-57Ki#5q)ecT|mYxxdna
zgJz0A8Ed-ms0*-x98WRQK!DtV794K9GVWC`8eI`sL0|I~FM*xkIH?pSO+Kr3#P4p`
z@82!C!_W(|S%U6FFi`3}X=11|{3#nx&ADJBtGdw0d48WeVaD$2{54lvCu;v!UD(Q?
zzDWTEokq|#)y|nHH5d$Pk&som3Pea&h!To%!ye@^xP2^>buOP$8440D+_@z8X7DVV
zpS{gZk*OP+C23?ho}e~yf6tuwpu*XbQ!^ZU<AQ1IVLu+0cq5lje@1E}te!;q-|b)%
z<!6aWNiAu0c0PanAQHvOl_(6p#?VWIud@UiUVJ%<6!7lu)dOH4vjKTosc{XE_r}ev
ze_U(S2lVe>?UvHf<4g78{ijafiIgqW?VhGR$~bj;M2U~^8vlN)T};)&k&xwas%@O|
z5x9s?Ajs=w0V1JFC|;$7q9q_&a06_@#woXdPcEUP7)g!BA=2VX{najE9^D2|w-Rnz
z%zAJm5kK0}kigng01ia_hQbXn(HTf@g6#DIDvaj9R+u2KJ=bZh=6|&STuBuEm-E^@
z3N#>rGnBUukx2%OIRDiqEYl8llprT)2ys_PYJ%XPwJ28E@23bJDjyCS{oX1utfz>=
zlU5P9;4uac^heSvP^)qa9eE1bx#hHZub#Y*B(JOmq9kMbOKaoms-PfIpO?sokd0uB
zM6QpHo^{9}k%CJCV{iB3@zemF`Lg>?y{aoF8vu>dyvI~kRx-S)NN~s3Lydraok${u
zu=GTziFzik)8x^K@|CV^l0##2x78z(5g!3JNN2lDK|0%)acf;M!4WGM)fGFKf?3zi
z_qYxHxF~jk@)QjtCU6EZM*kXiz1`AH=mi`LFRil)Ggem2y$qJMGA4F#H+ztPJCVbh
zP)TqL{N5YR8t8Aby5emeWSE2{5H;(mliVLo<m3rf$=Hru*th{IieKW&A5(;%;N>A#
zYY2+D^MR}&rXh$X+g}a%@$hmKZHbe&1ASf}$4d%x?@nS2uc|C@qtVj@&&<ah6fl_V
zq>pYpIO8#N+Vne=Rij~R7?-s|Py=6~P`Om)kY`G9&SX0~FpIjPWnKIEk>FxWmXs~-
zK*kZ9<M7%U^fc&!>LIKrboY*Ox$5nRT#AQUNLEEX{juU(xgo(AbY>Q!tUuy^09Ft_
zV^S+^3CQYD_n{Wbn%~M^jbR#C%o}NOSJqSy<|RjibU_&N>er~wkd07urT+Z(khR?#
zN*O|x)SInnOzbqGbeQfDQOI0`FMbRf?b<P)QlAc91|2YX?SeN>y#BUIQwaa7JcU_^
z-U&Q{@s@@>HlyeUAM>Y96>-O#A?d0!h0PJqQH&Tja&u&w=-w(cC9+ABy7>}nB8fhP
zP3l>H4kd7%G!2A9I&85eCY+utz4nvy-d00H`Vk>q_!6QbBqc&v*I`A3<c2BBN96;)
zikU5U?-KMgoMPu@lLkGewH90oP9^DEtty}Zc3US_mO1foW^q~gXV)QmWzyidQOPts
zX89eF&Bmrf!qN&!nGOAMgE&=3K|DFHhMt%J<DT=$NAa{k%tr|HbrdX9_cI_C>2kTP
z)I4O-!}@+le%Ji^T#0#*8}>4hjhd}Ei1IA*oz~ClD)+uKBDETAoiuHlxo^D)sDmN`
zj4146l0XJ!QU?+68)yVIpme9t$awN(PlzFmT?_WFNe%+LkpUZ?V)ytBT6;k7w9tN0
z{n9gyM6Voa<a6iV!hifp-(KKGt!TJ=8SX<~b-EE;aLs~GHM-#2Raf`W3CLb^1{yXH
zY#wck#&l|whsS_^h4!3ez?jxKzkj@v|IB(sU3q>HC0}vXb{bryL+!9HY&&4STEEOH
zkNxH8EsTvb{_$$@;>8P@=tGTd__5^cFw*pO%DoemPA!#x*XK5HV)@_f<1r*ixG?ck
zL5JeGXhBEg>amngT<y&~1a_M3KYw0Bg3`c&{w!~XmGS=hBL}l<J_Jc;(%zXyN)HJ|
z9mVZez<f>=3AeCvb}w4G%F2}z=;?;YwAoEc=|&_C(C^O@XVAFJ#H14^F43rpqK<oz
z^yZ>kHyI6ON_Po1C|}dIIzA!3Mh^9?iz-ZvOLxvR|A54m{DStR5s=PH(l5eN5$7|~
zwwZ-#07e*eYf#3G9Y3Dgk}Ue6TV=+%G>jN$G$r9Y#+92OFLu#9Mj6yoS9U%P7}j~%
zFsVVscZD)xN}5H?Z*HM%f1?9JGrl22gEUK<j^fDg*|X_VdT<#x&_?q2dwZ1Hn3evt
z1yz#05FmlhBF>_FxAGo-GL{_Bkc%aFghS&jc%ALVixkbJ-?mGAXuLD5Zp<^o`Ri1r
z1m$oEXq3OaJYC`&Xak}P-5IGX*D*#j(V>B{vPqNIp9lSmLReaH@$$e~b~D^8mDhF#
z29bnbe(|CMvjL>S1yBF+%NPNqMYY}sq+|Mp<w0K;sVa(g6j~p5MJ4_s;|2}Byy<$4
zfWK_zMWe<(Y1}_HVwezC-K%Oh8ezhuRG9VFc0yyHGkN%x3PB3aD00DjQ@#7Iy4dSg
z{@$Ev)sG%^ew^OnratZE;K3<TTNiw$N#vf$A{PM^$XY#>?*HR&m+u+#j1NigEYd`=
z?mF}FYeMny7&5Xbe=#N5&+c}j!QFSu(C3t8S9SNTe1bs;duYXAT_75uCTVAgUuY%n
zehSn_crFBp(6r2QwzjocmMQb~m<x(bg+UZBRhzI12eKl%mXW|H40XUf+-m(fhn{Rv
zL0U5u&yuwmVcUOVYD_;`n^zPVV9#}ktk?RLoPO$roLNLgSY}8hi*&6RS#3xU$Fzqi
z`Jw#>xfeGbv*n_Po13hlV*Fl#xm_-l<Bjc|6w;n;5k8GjC{CQB4Pq|@8*>^6Nc?`!
zBg$-nZ)m5v%F?}X@!V=_yu@yROEl5OX3oDB<ZK~knY9C|l$!S;?xkV-_HCi<DB@Ju
zgw<65G4tne{y)0jJgn!uedA7wlqE?>5ru@ZWGhRhlr&VbOJom2lx%5HS|~zx+G(+q
zA(SG?UP@t%l0;1QUG=;!=Kej;KhJ#}_i@k6ZR-2|eBSSCInVPtFQ~AV5XlTHTGC}P
zUoRy^ab@}gngo%Z(EZDql;7fg_PumW#FV@zvp@H^7P{*9a7=4D^V*LuTa8t64KUfC
zcg<Brx9a7~CLCx|f|IMN?bD>%R}^>*%pA;U8mJel<*{(#D2wejVB%8rQ5c9gA9=9L
z&Z17BBf@NhjxaSKR-o?}Q@&||&I=DItSSZ@h3CRzi(qT0t!}?|F4k$f_%lLGKIG}|
z>BH6hhM|cd^WUtT`sybFu?O)V4sF`xuyL^*X*07u3*F|C=|mL6^s@#(Sp<v^FGkWl
z3<w@*-tTW2Jz*?6eemD;&Gvk$;F_LTyqDY0H@M1sKKprt>KGuQtFMh#<Jn2}$GJ+E
z$|8t9hb}<y^3)p!q0JXAT4W6kN_WTfN&rZjAP19<&uD;{t`8<8Zq*+}G{)<f=|&~%
z!AzT;I*v*U&dG{zi>$hOYo;g8Z`e2qoCztH1B^4()fiziKPwosHdQq>^N+(q%XB#J
zQh`7|s$#@P^XruoHj^VQZ;VD;k%~*YCu<N8kv@oclg}&y(&8=+6yyzK-Ydn16cMlv
zy_rpYUWK56CFZhZ9onT8CMp*E3!p%Zto*p;Ik+`VjjZ;-0;)9uMLqz6c{RkL9Qbh$
zk26}@6ht7KU@H|HP_yF%wE}1AOaWp4TWDUrY|2+N!wgU_A$U25eCkCl%zUnpHy~pz
zCQqEOV&&)8?MfP3uUd6sh=|i(i8w6{V;zOEur{ap-=pU&KK4ueFe%TK!UNgFpw%A@
zUzWYoMK?I4l?v8zRcFtSZW5?RU62l1h{RZhd<`w(xmaBvn1ym<eMm@SA#$j8b}W8H
zFcNN_v>{W1JKjxHdN&mCP$rmwH(;d-N=rkz&P#Tn7mzYXjxAj?53-D@O<**+QOgH|
zcEB$xa0tXmREF?>uB2=hItIzuL)Sy(CnUgrFV`f=b^!>oExUH9@MI{_GF;1lQGLyl
z>Wiau_V14ytoQJrF>A5{!7>oYaLLiLJML6<I(~zbBgiQ8O5)9LH)hO8%svEiMhZdG
z;FD6juWUL6&?VY88JCg)bTGQM0~WPK6e$!f%IQPn?zG>#cdxiaP!)p}zd8L$WB+AF
zFQrx#`3yD5EEsc_ol0e+R}SX6@v3AjmW~@F?A_x^dJ)=rDZELHPkHUbryVE*0sAz9
zr-m(*6myX^%N{)dGZBLnrVM1cHDg=CYmJcR8$2&W<^jj-Q=u779j*Ab@@y4pQ^G3$
zgJK1%;SjAG!oC79KuU-=XUlf&!T>^LqU6?|{)>jL_&x>lhy@71T8)7^D=0x_mW3*K
zPXF2x;`3W{l}H6*0kKFFV5*94w?Et`NwM3g+Bq|Au;HGVm|r~<fCTZ<cInc$K1(vn
zm8izW%WJIL2R}|Fuhh!Bo$d;vB^0%@YopQsH%5~B%}U2)TF<hiHgh$4zT73a1KJqc
z(m;gn#g$8YPH*xHV?>H?&_<In!9mYPwz$8MS#*KK5V8r6-?Lqlo6Tt&*TdKVJ-<VD
zi+;nW+HeQ)n{zl5DM4>`ZDX_a?ffXmu4qb$<1+A0YMruaTm1pFK_XL<BS<Vjel8mn
z1hM2Cf+NnEJZ~*k+XcUR;a3*vM&V-;itdyCLg-n#ZRw%7vP5L$dHHLPrly7u&b&bV
zLFl?!wP#5qWq(u-6<isGOeK$8#Hduf2xgz>0qtL*S>luwR9EdC-t}0ge<wOS=lmRe
zavKl?#hP>l!s~fIa+TKy5z>G_g>Fg)M9A2JGovsfte(wirINjuiZ2lUK{_c^rz5GS
zS?(YWHgKdsN<CR$64es4lCiSp-0&TXLtdN(VZ|~_ofN}*`4BYfNuNwZW}u-4qI~@P
zr5YN$OMotMOsFDQBXqvK^6l<X2jt1zUMWmjo|56x%^fsTWD*hu!7kt!b*`WuLrEC`
z+bs$`Dn-Ty6k<_9VU(f5s5eS~PvR=~(zoBOlNeJ_zWLKo%Pu`W*6WAqY6Ou<xc<t{
zm@|83xx0(lLBTC@FNLj)Fhw=92gydqr^e)M1#`PPAL=irtwxpzEOvrycvR&b-F5|t
z2j9*Xk{$M^0dbqb^AY36M_0ekjH1Z`x{|Z$`62Wh=Z43zrOGX2WtXXzOFR5y_gBkl
zBH&OcU7fvg{L1cn-x0trX}&!)268%&-cjCC>ge+M7f$-I^iDzHoZTPlN_i<qj?9@n
zBkZdcsfqsoDn>!a$pv(8o{M)H^O@k6vVnw&B^WwRJapj@qm4#P+lZoBRAjyT^?McM
z(ImbWr_&aV8#fjUgqv0Cw3^mFWPZ#tp<t5J!xmV(2!u<ovRL(VaY;!6jYn~DG2WK5
zH<;D8fBw_#?YAd$=#AjDA60)R0PSk<2i^`^aet8fL2mk9-e2F$o9rGBZ@`;LdN%Jt
zF>Tp#?+a^Bk>_VZNpMCRHwiu2fPugjvsZn4-$l4lR4M?dmUJl{I&=_T`kStSp$rY9
zAo-6}gbt*JY|NcH;rn9+yyx*F=i`AM=>*V3S}Dfsgd;v9A`3tYV*teCkpHBQ!nIqs
zf&n%`g=E+T<TU-&E2wr{Lm~uxLL0_~stS9h=h_ZVh<q}0;lhoyQ?n=%!KAcM4oWRc
z-7cyVqB6%W+Y&_sQvouqij&X&SsAb4_=HR2!U%ASk81eGk6ukX4Eefu4&_L5v;DVq
zUUtyd4(IS+MyJRxnD_El58##czzl5i6nVak^B@e;@%=DdXnSS{kv>bkN%_6K_DEOJ
zvokcI1eE8pv(Om$Q7Bq2mxOwNX-R|Jn6h1e?jR7^040M>rx*v%0V8vCb-k6|pa6O*
z_QZ*nU?>S0nmcI1`vJ)J%x?d3K;S~!pm`pP7Cj3)di3>2`Vx|+0BO%GUUU;2e}MIe
z{u=6CR079E;f@A#6+wF{qg61gk`_{oQ!bMPc(CFO-*ftfwj2s3TdMD7(7?6CVh)NF
zSVC{$z@4+M&S>d+kI-JmJT)Y&tk=2ODnv%Rj~$!WVcQwz6NO~u*UwrIaU^1L7S5Ck
z(o&jg{~I#v!SHoIudQA3a8G^Yq$M5B8|&*|e*N&<MbFo_?$G^ve?99<q$Xcmcz75=
zaG0NN9$%5H8mcG*D^yf(!AQyIPR=7H%5HKB4{0LNT9eELY3+?t0quIgm_yr~@|13H
z1<FaUEa17q>xU&6EiVD3k2nm;l*$8TW7-wzt0-W$`y4WuB1Wz>NAh%Ft7VVUjVGIZ
zkHp0_AU-oACkjC%ljb@r_b~Sb#VuMayqeHir*BK^QrfFepOzeDncu|MuV{|(eRDH2
zcfJ(!u2-nilZ`{l^kgIvGco`Z#B2V<e@9nmHN<(MaS(+%iq07*hMqKA(**Cl-&1Q6
zE2T|^!*ORTfB+AHfmVl#i8VoBNtBX^Z~<Dhd5+WWO|t=(;<@~ftU|fI?8qkBttxtV
zLh!lI8EJ@Ig(cg&cO(7MFNYDt*a$Gjep~a2{+!xjsl$xu*0kY`6sEOTzsQ@!?xi=-
zLF(w4-KXbIP~R6auyC<biJt!R!L3YuO<q5(tPDo=?2bbiEYQ1^NzGOR#waZPchXFl
z?N&6>9CTtx{(l&SB%~{$Eh#+`WcCmdHjrH0kt5A;k>?xzwMIt-Is(;EhRcy=w7ER2
zeYQ%?eYkgFbV^IxD#)o2?3g>b64-2PRvl`SBaJiwE2cDCxX$FtgNGkbfqbPcXz^Ff
zu3e!lQAk%=WRJf&yx{PrD+UZVF*Y8vD(@0>N)C?@_61R0H@}3^*9^G<u^pQIh`~|B
zQ?{H-P(8zxxE`%wl}V$>*&LZ>Wo||0)u}1~J%c6HIqb6V-mTOEpvnfMQyLtoam3`n
z%d_B85rJllpIZH1B?V4o+hJ=(7ZkwW6*`biF<4<JfY-NyaV6eTX<_tHED#t1lKS7l
z!C|lM_4;dozykHqGFULK0FCxC$i7J`(+#aew??jE;`hm%>9$lk>Hu=^+OQw{4qfhR
z{o~V{CmjKnq}4)1i5mP5?@_(*gwz0TmKu;ij6#vw^6PIhP0C^W`K~~Z5`B@Z&13{f
z=o@z0HA7|Jyksk7AUxx9Qvi|fxWk3_$kXS2v`102i_tduH(BS^s-*6$4fP1!`Ua64
z$z<KKb(23>ZxTF+PE*D|K?=Zw4Atr@S@FQqvqS4w-D=?U=i+tz-d=Pg@2u~?u(fN9
z?}T0FO*48FT5j(b)ja;+ZJc8&cHub|*3=|u98<C;*r+Jz)*K(Hu9U6H_yXz~gSD4O
zvRuIeo*of>Z$^12Z@GRUd~9*~#u_*foD=_?M}OCTpdJS5lcuEZ=ZCQl`vyhj7M~mg
zfhQddh6L2!LZWcxgq!3RfiN#4^iw!qqIqKg{PKnQbx&g2A7TxR8Az1OFRf*YKV<)i
ztmmjZKmeYre13l7b<;)(#g%JVoS>6!+_|$NH5G+{rL*(N+z%i*z3O^VEedw2@`Vc7
z5-6G6Bs8?y2V2W9?mv>5w(xjJ!(%h{8H;7zO@Gt#O<1$W2t6UQQv;`P)>i5RSN#VN
zL78m<S|B7KskvNKwEd9D>XwH^;!ANNwJ-<a#XlF#`KsgsMa~Z2%F*@dKtMcX;K%W`
z2EdA1zDmb|vxl8i0G*wTH1FSkt8jTZ!G~isf-v?Dvm0-ZNw#oNz%M*cnx<}lG&=h?
z#^~}1=)~vtPVFILGx{sR3xTE%R4-F$F7+0bu4vEjKN92|ZRuTf3~-}T`!cX@*t6#q
z0@S*d%T39#zrn@Jum2oGvs9n=kMD;5(cViMX0_U*?4o|Yu%}+UW=pk}?Mo9T9dB=~
zc{sMY>ZIQ84Kzo;cHgXgrLSq@X!mUU@eORkRR-udsYiFNywLG^aMhbl&fE4Gynf>S
zO?lbp%vPuaUL95@RtfrqS8a0fKa}`FcVYy&i3UV4Y@P_2`ZD0XK}M4>ib<&}I*r&c
zgV4=qJ3VQddQn^8-7<<urZ^9ohg<C4yH}t2G{G;x;{dW{rwiJJIIxD!H^exfrjNGM
zb@rM<5t`9y%*WyFu~T)IK7E|3^KLXuTyNNENTJi?k#<d;^^6WAzRXmainItD(MYN%
zsr<e2qEx7Qot^Z6YE%`TDYvs!cTYkvqhRp4*~LUoy;zelr9%tf?D(Xf8T!S0Gc$*Q
zlZ(RkBO!w<SiIuEjXQVpe%oe*P<PED=xWq=I#1rj>BzM>&XChX61)t<G=EIj4#<Mm
zOMfLQtdgwyb$=_R0J{BiCyjH<e%7M%XD4!{pdRZ|wwyY7_CvkaO28QB*vDp-&z}8S
zTlw>=lisU>Bh19pX$0adAaeo?Ox)E?aT1dfGyp;fKkQ3uD>^7@It+Q@do_NynNX9%
z2(8?CQlj`Qk{mAM!6Pl^#fum1@&>iq$`)%K@vA_~As3y=y?7RdFjr)Xrlil@n{A`K
zRxL7w%#e2uzI?iML96t8)a&HK84N|qG!O8GQr%?P&?WL6CYEHLVvyI1Esp<;V`Z>9
zkx)jUWJfT^LUnBmD=(Um06;{UHl*)@=}$D@Y9|<yw1h;HK0Ne{3U&9n446`+=P;+n
zlIdPMs-Qz(3yKaVDa`}jRZ4N&SJ!Jc@R*f%-oRyWRk6*<MFW29%tOXqLE@9*U4R=h
z99!76n5Y_nWJ5eWEuRdXBJxJaT#3F22hL72ejJtf&wn~w2IRwD51We0%&9o{3*{6e
z!r6QSadsebB=AzK?(nf9;K;z>)O=0M=FFQn`t{0HWiid;(|g_DIUBS%u|t5mYW}f8
zeFN2YeM}D6H7<Bq@opt>zK3bTY$eMnW}y?bLhUd6c2cogy|%tiSAhVpEw*}KaJ!gT
zqUL%Tc~1|&)*L|1yS!{L?Q(`pvo5%z>Y;pHip4gCuYX=eSY>{F2DG;o-TC-7yBNTW
zia%IS#orLN?fadQ`r5Ni3K3p=Jbw4#3F9}7XpK>Cj*m!WZ`%>?nIgKDH39Onsn{hO
zB54yn4Yyu+Bl0zwS!?CareHWfsh|~IxA6zZVD=P%%Hgro6%1CJD3m*N6*mV33l2`%
z!jk(;lgdk@qPe#t;Hyd3ZQ@bT2~eF_DXr7WAsvc}isZSbys{c$dXpF633$46kPe$w
zwP8I+BBhi8W#BLxaQ{11I2zdF^Vc92ziA1N2rle>G~>0<&j@5qeXch9*^hesS$<8u
zAmh3Mwv}D=A$WCmCEr}iPyPXdN{9JB)Z?=&-o+k08cBDBT5wa%pw0zUS=idQ+g{gx
z>i@I=G!5fp-n6u4$=YDlrC8*)q9;0JetQW6P2vVYcOw~-Hg4LhS(AHe34%f9HeLKs
z6G=3)LJgV1a_PU|86U6g-AXZC5fv$8jx7IaM|#VZZkm51rF-)urd0Hj+t8~&yBH&!
zmBdzhrC9TD$3D9q7#kIBF&hs$qLvbOV_~p{4|hvm6A}`VK<socX*T(;!8r?42J)F?
zTx_aqJ!+_8r>2P(+ts@lTDlAwb<eluLAaV307!rge<Yl<nxvjsY18zjp1pd|pw!oT
z_Nvx4oAYPOoD26_Zr6CH$VAMCTccTv<VpqJnp^*|d=)QUj58qPWE=9z?;pF%klCy$
z<@$ba{JLKMqDuZ_a(U^+%{y5Th!{y&MagA6Lx?|r`cI5+Rb#)`KVcx~{+c%%JXmL2
z<fX1$*KS}Ymb^$812to6JJM29%UG@2yd4~o3@&RYIAOUIBS7KjQr#z6T}Vz#yL|6n
zE55QADo{k+WrhKr?)p1b6EA-0qP>$Q@a@VWg6{F9q)3~dxmH@43oG9#vatqtA*GGE
zTT4G=5Gk#&A0W++l*0wr6v=ZfhlwPrgjn3aK-+?^1p5gCdH8PAmAW()F(vJdkb3Y4
zp|i(Y4ccS6Kp^rVzTY)*U5Yo4yv6{Z9<oVsf;3m{v;m@6hH(V$VIVw_1La-wcRMKd
zK#X_5qsyK?bv_hdMHUr-i-ha*EB<9zI*bqI{_I-R3v4|BwPfcOnP`)Ce^su#6=Ov$
zSwz9j?etH-@3LnQ=u=8pj^)cp{d52#F*PLABrr7QmDjQf&?P;j2s}C0q6lC;x~hrE
zvD7;wlzLH{VIg8QdFnp9WdZZ&Y-_&Yb^MPdl6iY>T{R$N%cQ~ydPcom2aY1ZO$L3K
za(aFMk^G*nP5c%`r$9ZG@=nU}AGgBV12zF2Zs4%UfR2}~hdRF)rB@?{|JT#*5{2<9
zo$28bPFUupv97xfmc#MpsTQq?>6A*0CXXyGY1?$<c%N%9;9~!a;3aG5eHd~0HX4Q0
zdk3=2rEd_y84*u5en6xB{8)=DYf<U(2DC-6>e=Wa(x#_Dd6$9I2s4lNb2BHW|Db!v
z%;wZpd!{X@2NjXIeQF))U8!z8DJW83Q{-P}aQ<EG4<CTmatuk*uTR&deBc@WYQAsX
zvLS3SXp%Pa0E^4(Kh~Xwn9N>te<H^qF_j@k5s<)!5P}PIZ5ENR5-3*`-&m;q9H;jX
zLC(V`Pl%xUfVO_MpV}N599oSrg8$|6GMP63`66ZU;}O6#H{Q9CMj}IB!^(wF492wd
z+%%57NQwy{(hSo+zkPYHo7kWc$OM;q?5QknN%EIG23t<}4#~@4X`%sTkUjZ}8Kef&
z3s-2UF3mk9E7B1RyZVnx%bVR7JIr?29;@TP#Qu!bYoEI+jiu6sdX&x6piLYy4dfRg
zAhf*Fbw9sa`si3Sy@d}0TJT08mqo|)*mK=zkkla^T3{8H1BFOm;8fMU1M9Lc{m*vp
z;6af}qEQkc6m#kpqHE={%UCZ^SL*Gdc0FJ~9rg}rhEs6V*CwN%hQ=Gpq?P;>Iz>Ln
zG9W|Qv_>~7+}@%`XPS}AP?}nKdY-uS8FTL|Ox(54eeoW>)k71bqsPFTF|5@f@5Y;l
z-yJo2v2v$%23hu-w-`qM`#JcXWoWXKW|!8%M=uTkVxwI*Hs~b{^MB(9`b8&36xvNu
z-O}S&*XSKFYXbEWM^uKcdjD70uwGM6%RCP3rW99ezkdv?v1^tyqxYrCWhcbl2SWy6
z&{QKmnMZy6E=Www%9ajVi8^zv+aW_$ajroJC6hKHjt8kZ@_ii{S=428A)-`}nfwC>
zrbl!$TxfO_ZwiQSae$GAH9UR>@^+CqDSTZ!Y*J4xs?9(K#h5y6#-WhLi&1kql?=vF
zQC7eQ)14%HHXY~shE0;!O*;Nn{dqVh6Y}q(W?~i~hdW0|5>l2nVA`i${7qYhyC>(2
z4)7T{|Nh~2qCO-`mva;(F%YOouJx%UX<jSTqpvDDq4;1Sz3d3(LdKa#PLk_eJ-5ev
zh&p$tYsD$!y8T+1r@dXTr<QDwqIL@8x5-Tfyqeg0i$-A_l{}&p8R}%-WF~faxGc-?
zwkRj^^8-)?57LQrS<%hCcUuum^X(a_aq!WJ-yyIQ<3v&_`_+A$w|}!Al?(inKaoD0
zytj6k+kC%}G!fPzMWQWlCL<dRa$W1E9(W2CU-)VGHVwb#v1d5vb#*_M$WDVA!=PQ1
zyy_GM$LZ`c5{g2(xTrY*<$?goXe~U3VAriEpZoZ6izk`Bf_#G@r~*PtRm2aY%nRY0
zlyQhr46aGo_4l<Iy_X_NkYY?~3Xt^|kp|<DErbaJ#Nt6Gzevum67{X<Xa&7SBp~{=
zVKHvS`wn;FVuFITkb+h3$XBCYy>bDQ2_a*Awy$P6yfvcE_PKWyDFIZ}QkHd62}~B<
zu5<(BZ%U%wHG>!yQgRCRQg7XYR*YEODATV#lK65zV^+dhBV*&MJgC$$$LYG!28TU&
z$ypAU<hHJs`cG&&>NzOy1}x6p$Iu#YNWmYMfOzN+!DLu0u?g2hsjk43ifbm`^TZ2L
z#K08u1+4ayGfvFOA!7(hN0CTwn{cEJ(-;`aNkkIX9z;WyK*DbFx^xAWfSlLfj!%)7
z*Sc?K$N!Z@SVH;Q;O97%)!*LFk$whDOpIpz{ZzLbZG3b!Qg<UcYQo<0aTsDZ<AMI2
z<<}85PQ>CYOfV@Lns$$o5;Gr@C?)Az1a-nTc;v(iKV9o!@o@mzw3>YWD8EL$_M8>;
zXX1;lLaZjuyF|nc?A=>oV{Q&qp3{U0BYmvnBjM{sVv1bHf`^WuZVtCoj?WNmLnxN1
z8qriO(d=mPptKZ;{!z=vhD{0{Ve2OrN^3qZBE0`~KkwbQwG#Y6-xxF7#qv}2arYgl
z(FC8RLXZtt6*kj?R+_W9c$Y(0+Fm;!&8Qa`(uz+7p;B$}1(Qw>ATCICPH(@h1xCB8
zdx%zTBx7#D0CO<W>wY|p<)Ez{))6U=bSesZI3du060fAR<&R+2vl*ed%o6aQvSsHY
zo(FEHju$-*&>j+%Y2!yUjGxJ0%UCxL0;0jcW{`UvsG^KMF@rzj&p%}j226MS{<I^<
z0OXnXzPoyiqo#D%%({m4QjgfYIRupMaUbhIFZC`#!J45ON}c)#dFNiEITjNGVvpJ!
zUy6{x<YU)s*5w$PcJesJ1sC%+QUbZH%jbsMI6l(pLmkT20vXn#$DiWkvc(!5UDnSG
zMil`l8kfcNnT?O5f`9vgf9fIq;skT74`<YJ6$I)ehu5w+wkNU&NrkV(MA6rKo?MBM
zNPI+Jq%hufGYbHkD9B(2k4B{BsC20C#UU3CD)__+&-6Qa-~ZX^H~de=WsiB*U;i_Y
zb9}^X3?pqz{<-k&-(m6bbSi)-_ohti7NKk1WAT$rT?DY=8vioV>O3q|oR@Kep#+o8
zy1S?Dr(_U~5eToBZKvuuJ|yo6shc%`E2lD)E`CBp%#xmu3k}A@7K8O(azC+@V>^T?
zSDulm-{gtYg30(1{tjNYtp|gt2&oR(HGZ4B%DX(Glc?lzcA<7VcH)#LzY<=$53QXT
zFbR3Y@`upE2{P=({r<}2t~7S!t_=N_pAz{_#5*}i;J8WVk#<sf5gIR}Ie8Ij6`Dfq
zn#ISE+@HDjo0ZQ#?Q~j1ev+8(0SnGxXqP*xpn!O(ys}c6`C%~zfks93CX&_CMFaf(
z{&_SQasnt<sCq#MIIOApJ;BYT+5v8Qd0}s7r*D(y&YL$2e*c;G4h0H)e=HX9fv+)i
zKSYQT5ea8RI&wjeDUJ~WCx4hiohX$hPHI70TrLoV8z@kKj$FPqqlbx!t+R8X-|gL_
z^~2*S%I+H)ml;@Z{(W4HZ2i>UN7$08VIqX^B*ssj@k)be8>EK`B|N8Tc$Cf7Se}fm
zC8p1p0mQIZ2CLEK${-)7R5C0bgQ&SBT9H_TP)i`p9PQ%}khZqj<ZXmBkq;5(FVk%{
z`1zOJNiLg$KlnTU`T6k;&~N_^J{(AXXI<62jFV+O2xXU!nQTfOlK&UQlh}_St)R~M
zH6eEK;;a2Hed=n@7N4#^7TKV#yLK1dmvsdP|7f4`T2EC0%Z5prYX>ubRysc;`Df&D
zRqIoyPB~4QWH><AnnE}nL}jb7uXF6OpKF2OP$-3STSq{b@Qjaqe{8bYVDUbT@7s~M
z1R@oXkxL*xMCc@dT@g#Ih0VrlU`+M-r$tv~uQ0rbQlmzNy1~f}iJH<|pct2(7`*FG
zHy-g=n&PS^tP{O6&Ht67KO%qQ{t_()FMqzJvvw0)05{OVO!S_!V+CsovSHWD;r<Xc
z3pC|Hp&_Pf6qS#iJZ$LArx~}QI$`5NF6M1AJ1dPS4~jUGOUDoR0Jb^Rdzy!b(f{fT
zpeOW^0T(U|0Y7X;Vjw!R(N!5O=mv^=YL=qR6-PNkLIYurq)5Sa&^%H!^DSkLMV{2;
z$)sfW(O6IN+gCD5!Z8p-U?8&E&)!dup+ls2Ipm}ndJvf*4-#tC%Qoc{(N0rKYe2YS
z!F9FPSN<K^w3Dt~0In|13Gdf?S+2WuVO{NN$(y%s{V`+VuTvQ7qP4Y2+QtD+KHPo@
zov4*1@7rIQl!PLdG%SD~Uo{W$5GEQEKKY_wMmO3FikN5vewLy={K+n<t3erUhz4ol
z=Rp$cVjlVa{Mr)FiuDl@x5n0U<;GQbMt5w^<V*dbH;lzAS`>f%<d!mI0jq@SW8V0}
zWBs$+Bkf>q*q-zS_ZorNYdi`#+Z9|~bm3%Wf<+piDbA~oIlb;}n>GR{Q_5W7i(9qW
zC=(+N(t0Z}McHt3o|r+3v<_lim#-$t3_<4~K0^Yw26_I;4;TKE&QxlXmii-Q@{Zz5
zWFFJA)<w`bBtZN!l9y<Hbka+h11K<&FJ&aCdlw;h<|zI`RnZ>%W!(MnZSBWbB`wIZ
zvdxSp$97!do|lYn5cH(YW9qKN@QK@~jr@rOKp{kzQ;N5@S@0Y#pL7Ru!OwNKr#^rQ
z*+7^6tJNB}kc%c<nzZ#uW+{u9o7AGQqJ#PV@{F7)XnW8zW~UW;^hm2ejJQk%j8mr3
zg*4-9K-&niS`IQ6pE0#_p8JVQRUfz>Lf&Ll*oiAH?&z2Q{`-Q*GIghm4H`BQEe|OL
zBwvKyREbeBF>Vzn(6pjyP)}RlJ%>HX#skL9t2SalfIR<#(eTGkK}UID3I^5j<E@tc
zLI)Bz#Hv{{Vul%<3~zHnob`SmI=xX-d=jpTI1*ZROK9f;8Z;rZg)ShwawEUph&&A+
z4Qvy{(-7?pG_q+%Bt!`~-KQSJ_E<;-P)AU|7_&NX06ow;QFN2B$JVoLdEt=Td|X=0
zv*5^M*G$y%05AXg*EiH}ouJzz+7F!Ix?tL>*Wjbo`%}(%Jj^<(J*!(1wT*&*(TbMi
zQ7r*@9bfWfSjwAy&bl+b)qUSTYl2w&F1vFAj=8$gxljy3fS5jZQfWZwChjyu=_z0(
zh9#mKhG#AN@NIm@xpsX$d#Trw80k{TRx-%})<aJ(`b*4FZHYA?rjvS37++GuV66br
zrrp{MXAVX*H5?lXfFdWnu$JP$X1efxQ(kQzhvn_3R};lh5>oy$sghxToK>4;B;2PZ
z5s!?s?41Ws7!{Qq1Rk8rmle{J=BQBD_QjNRk6`SCW)Suw*7a3*w}w2ewD;CkaF5)K
zr5V2)nHeW0$#5R<ktfq`0#VXImZDD>Th-Ob_Bvr)i2C1Ez=ZTQFc|AEm+N)uBGalU
z88#5n`NoV+8N5DkCu2eq3`K~FSLkC;gGjcP^U#F(%}B7*Y_z@se?&@S>3ONjf8$jq
z5O+U6pG70VKv8(_?!Hu!1{oGE+{m6!4ykENYtyPbvJfi|l?)3nD0^YxKoFHrcA&Gd
zRMGCP-r5Zw%@TYah;0M466&we8oPQ?yD~|IRIw9AV4w{t?{+DxY3boBEwCK(Bj_^?
z0~2#_!W*dYb!?|MS>}UlP=(1OM{8KX3LS2yK!HpEVdQ@W(ExC0BerRL|7%UL*E9$Z
zu@Xc<ROfOW)hJiBhaC4y^+yfr2#dvwMJI_p><~0-vSSVmSnfNzjq?v98>XK#$y&Xs
zt~UMQYqxI=p4Qi{!uV+fHDGc6!|R>%IYfw-!ajwJ3cMdTqOrmyPR0B&oreg}$y>oy
z#mYzXp~|WC$@uYHDp{ONBoOVGvy-Xa&rSKWfqTV+0FqYbYXo~j18BUnM}dt#l(YKY
zl2Qz>4jX-6^dxgAHkL{XzpBPe-;JfElR%`9K>e&L1%5@s7gqVEQ3h)yX5bA84ij&#
z>Ll$Xm)su>9(Phq3^8Prm^`Gz*hTBsEhO;h$c)3MPvQ${7#?q~;nV^?PcU#?AH-`k
zqeA5|>P>Jqf8z07-C*@uGK5N-d>j-xBjKklZ4md0h3LxofbwuAUObo%&%w51oQ8wp
z;&S*c6y3HI!Ke+yL!Isia-}$BWe89>q7+zf5w*a*iEJ6Rkn%(A-9Lpwu3><~5Y3Jv
ztsGSmwF=dQT-WR0htV~IG)7VF(>cIOXEVB#UAasYAH!nmV@f7drf>oN)U2os@H^lp
z!~NzXFM=SOhQE7%ss8qlZHi7-hRJ^C=ubawG#PEcu>e^JuW75;z(0e3__&YurXg8Z
zww)f51-{!|!G%<~zJ!FOlRLX_3h}*(-sFm|z3!MS_+D$H9`sSf*h#6W_C8JHwdvWm
zL;cTT0@Sy@Zhy@nO&cc{3WaoF*6{q<&Vn*cJPJ|Z2<saQoNc8$bhV30_g71xdR=g&
zUFiFRP&`h-kkJVvQ`7D7hT-^Abm-61u}A3uh23h-tXZ<!GaLil!)7(q2t}aeh6<Vr
z_V|;9hlQnhX3;U3m>gm`kPRt)!?G1C4$?TMkdK@|{rN~m0LO;tV^kHWDr|<XdY@Qb
z%8MGO)BKRfznnHl!Ee_0<rUT($}>c#d;Rw9y2^?PkLx%z+mV4Q`!8etJYfGQOl6$N
zmzoM5FhoV1j%4zqGxbM;ET^T@D&BRGAg!V7&unk%r#?>)(wGnvlW@a$8QIwdGFVf=
zh^6N>hNlIp=|3|^Dd1QdYq41S&}8l74ZNFpI_uVL+tOKEDFJNSF2+O087VQ?Uw5>p
zMwnFBO!7XnylPA;5BT(JSBx@puU?&S@jwF$Djs?2Niw=8gvjb6IFvY&<cip#7PM>9
zvS9qz6_UBm)B>MQLmq@@&u}F2?|f0>&!gf=bnDWsn=M@qMeux~y2erECt(dU)<-k$
z5u9i-QF)}NTiEwUG<HlHjLyx=yQdq>tGk|`AIB_(ArxOKp|5}D1p4bk(!(GXaUw|;
z!RIB@r#9(1mJ+BxliR$K*|V*`{rEAC?niNI%%2dSMTGtofMvChp4;Zq9c?GLe*$?T
zaz~KEc{!2peRprCDDftIr@mpq?lzdE@d+z0fR=ZM+^GiYmr9khNx2jJFw1ZFV<+p*
z=H`19Egon2#nc!^jG2{O-&r|cBT#cvSjYE2HHO2Q#49+G`I}9t0@#8k(oV;Br$Lv6
ze<xOc>+(ldmP+834lG@a1Dvzq^f%)4yU>RiYHhUf{q{cieoy}8BATESa8_rC!$o(e
z@NJqIo3`GNp%prz3Vhs!z>pr?8lE5tXYpxO+rs+mPMkE!jz>7L^@jVoM1~al#TeBo
z%2A_Ae@y(&gy;Uv(Hj(<!s88*Oyha7v8JsRd+!XdW3FSwu{RID_6OkFp25oxT9hyu
zoJf_DOb67&%hj@-nU`UIJWMlYsdvVb*5cm>r$P$v-i_se$;0PLZK|1+{=B^0l0YA}
zD2sx^2+Mjz4GFT?vjMWi(}pyZ@&^I@j+A7G9FtKGrF|1tQ(ib?E?NY|PR(581RCF;
zSz<X)U=|1Arn-~ys_7NIY!`0fA2|aC6tNT762jm>=DJ#YmLBZa?(ebPrS+;>d;0z2
zbIa#lXKfA$Xj{3_#PSq`XHMMO)0Hc!izF66WH=J;x5FBL0<zHFjI!boDrtuXu@vj+
zq{O%jArTulCeY0qHd=4_3Bz+U23{|^)rW~0jlG*&Okr_xl9ZH@`u9;BjDQra=AwDo
zM%g0>Dk9x>SJ;kfF`6av%~<KUhk3Wh1=h0KRM7%!RR0=7?+Lpvp7^<lXYHtvOpeM(
zFg1&atJ}C~S2w8+Jg!{89F*@E4)w0uS?gDI&<q;C9ju>NWQ*f3=1?OT2kSK$L|6JQ
zussOE#=8bCnZEx1Hk>$i-jKC62t@%@06shII_@41@kpUGlCr>W&0ab=D>t{S+ru~Z
z*Dax6U}pCILd|sGCNy?;`3C`WH9prxQ@dCD9!?aoAO+UT$WC6+fL2U${A%wtqqsFJ
z<vD3l;sDZtQ7m1Q{#|e7IiyBJlU67?sXbc?S&648u|#H4=sbl7<s?&kHXF7?e-Vt&
zr|&<ew&8dv#@xw6+|GW=sZ>&((ddZ18`C4d3s7XLX}5huhpE}9xsGAkvqBsoFOdV8
z1-!y}c^NsP$Qikr3|KNY!!XBF9*pd^lFZ2*)Y{tb(KVr;2EdhyjRLjERhl39*Vfaz
zf$hs)PU&|lRK|ma3PeaHi@JYX&7h!N1dm@v_Bg!}^25EBgvZM`{eZpAIIlu;v4#(-
zAct$rH+bZ+*^hBS-W#(12y8mbIUm#=fegYisj9T6m@O32KyyCP?9D(?O&Lns$KHEV
z?3%DWTek*1*7f?I7C>B<X>~ROz-_Gkp^(ACPj_M$iiyhvM^0q4d}~>h5fmiqbVNBh
z*b4PtRN6ZuAx!qaDA+v<{T39Y)O)wXiJ?_p=2Jf@D7-({v6CkJyq-!*r%=TLm`9m*
zCpua2U!~R&0GN6~ftsQA&2@EkspQH@r0C=?^XRNI>M7WJ&%UOPwzQL(nKp=r;?%tq
zY#7@p$ibu_4mk3MdPD><k=P&yNGvgi`wbI$Et&M5u5BXHYysH=j(&TV-^z5!KRPrQ
ztzTpW_9gx>qCYKj?QZUMD0l7n13{bHNHGs|BDy5VjamGy`_yZnn79jQv#jAI!96P8
z$;d33;4)*I!ZDwmqb7axe>Gus^?;SfATLG83bCqaXM9mWAds3U_aRL{O|soj+@)?7
zPh4<+MFonf)?702RmD_pJ!iLI-|4zRI?cs(gH|nvl@>LFtcOaMO%(*{Am&7mJ%c>T
zbAoXh?Z;_=&$rt2^2G}r8kM<Bd3?^`Ot;^)AxMFIV6Fy@JMB#yFhOe=_0*x6sHH%8
zXy$mhaB_X{hEODz3)BYoD&9eiNh=+=NEgX{V!&8=?=6{!rxS$Xb8>Xlds}Nw8DlI6
zA*WWRKr<>rlfan;t!I*e=(Sn|bWo(?CP8$*#8eO^P4xGtm7Isu9>uD}O-YN~q67{y
zW1WfS;dY>PiVD=#3&vR4={t*nqbT|3h{>zw*!YURlqnXyC9-iwCCozAy30n&AwKG*
z*?oDs)`fEjvrX}wlUfEz3bMz}+XF*jOrD~rWP!KLWt{MO=}hg?WNpX5Eh{3D#Df>v
zAJs_?ro=Udouj!9XwFo<ZULYRMCWjD<$>o53*wc<x`1k?KsPv+ouKQNqRB>RCd07o
zJrFZ3xIb#JVRv=kbPKHhIQ9R_U?;%ui+3Z?gSZ7|)z`HLZ<jX$t)sl<ryuZ9^LFia
zkG$9NP$mgcZ1kv=^w@}5Gw8|^LQHEK)hiS`$7!pON&T#vcaX;^OVp^(!JZ8YbW1qB
zEjny&j8E{$FJ_~r9Ckggh2U726YDlTOJwu891<XOnY0n~?<Qdm0vRqb?Cxh6#s&m=
z80;BLq@#8348kOWw7s_)t<O&OlyV0%nx+J#Qv8dKPCFOKH=gL5#nA;b7PEa>1xAC!
z>sI-h3B(zgS5Xf3IO+8KmI7$-CIW9%J|(CsJ{hY?5aU{i^{URGr9zjm_CSdaS~Pc;
zOuBYi_Xh#mEo+^Ou9mTS1nNpGRs~#oToBZC=up?r=R*`N*dz*_Ve8X0s*|pDlbITK
z`sIN&e{x(^>E>&GSFFAGvFKS2fB9-G)QNf*#FeW=#z$O(q;-ccLsZ}9;dF{#86In{
zGsvH3&q|qAq!+74$EY3!B^NUprlX*6M)~Gx2CAQCK)`g5VgdJ1*kc~cN?foWds>fd
zt1A<zMxPVTFr63y4nHupe&N#+>X%EnoZ%`YtCD!m;<v(ur$m1d**JEla=Z**{x-{I
zU92LS3P`J6d-jNMfN~C#pT;4Vk?C&r-&Q{s{(Vx<9hcM!lL{D0D>(171e77T#_);>
z{njPY0CO$KK#zPL%C^SlB6RxtbtMUqO?=i@7AVid|Ed(fUJ*Nzj_&D(B<q7Mi7*I)
zQwDDcHQ|@b1*hla9s*{(ioitde=t31h-9(li-+)XkkugsPI12mLXff0@vhbjUoq4t
z1A9~y;vj>Mq?=asnfV2ZI28K-_1C~5Lx#w#N1W?xc3hitWT;)lp-g&UMrYVGWB5Mb
zI#AZBpiyLtWJ?)pf>r<ezEVv#OUO1gZk|`(0#kaMrM2I^`Dz?4ndc{}$=EpM=Ucok
zGW1oaaYe*w&}WkwR1#HHM5@Jhq1eLy<1EG=E~!fWn*v=tLlzBaPn{naiR#=^-3k+1
zdt;9+7IamYMY%{7L8~06>2x(WS5`i;JLjxl{V?h~rOdoHVjc@9JCasFw0CjdE_x~p
zh!PtByf*$@I>&M<rmRAT6W|MVZ43;<tt>4AE~#1LnkcU@;Ar>x^lib!3FgIUa;zLq
z^V9&IS2D0AnE`%WZUG+>s3x}mR97`?mN9Iiq7CF_(H#j358@*fDB|4Ig7-`qc0PAD
zjnIgRx;PC7W$rXZekR*mNDJ@Cki>#|+c}=zpkjX7-Q9G3eSL#MLi9<$M4jy~JmWB6
zRoHnW7tOHH_WW^g+SoQaW?m`)|Jh(`)C#8D7Gdcb(!Tb_F@6g9g>;j{Nq{CPjZFuz
zSJ%;Lilr4-s2oajyzW5em0lI?uH}jdY0j8wAf*U0>Z4aTzM+5yi50aDhvO21A|&O7
zcYRaEYZXxeHKKqa(=xo80G@!$TU~rRt*z7maDeU{YnZZl^XC7G?<9aTvfOQSTG#ok
zZ$Y&<Es9^~_1ytOiui^isxch9oHH6W({8QzVQv=oT5k_l3-pj9C+pd3Uslf{<unQ0
zA|9~{)f4qtV%9_;Fw$LMq|L9xGQup>-k9D|+y?<drKaIUE1mgFvc!g_k(4{Ow)dP(
z<>?Wc+=>1&EJ^hS8>s(YN2${SB%}(l1zwXEu>_mYvVq&EKVZO)nn6|*9UcAoCIMQZ
za5@r2xnY{6dvat|5kLyDLLl{#v_3k`8>0YZn81Py*r=JdlGesx{4pFgyS#Tu@BVAa
z56~+Y<Sudy!BS-n3q`9)H}FDRf1^^CMs&8X9gbH4b9}i>y4Ym?l?Z4eBLYA^V6$aa
zQSafy30TL*o!HD?8_~!k2@f;T@aAZ7$_3zC78R_7C{kNAS%7>Md>ur3d%#2D0K=d8
z7&_^LlrvM&j_U7d$vaq5nO|nRSDNa1Mx+Gir#3--dV0*Op`e94SAng>^a=^a{RPbk
zlN4PRZf+gX=d}K=T*&(w-)0g+lG4C1xvd;>IcisA2sR(o8X<g8hz);kX`yb|0D|No
z;A~>PSX5+Gm>K~Y^4><sRrvm$gCYKyl)f@3$IK6l**0GpIE-mJ_H-Py)(RbIYdZoE
z^!1%pO`I9V_V>FTtsWE`C0fD64b=b0`}V6@XZikU1b`;cH`JYmv)QjqG=xm_V9&rM
zk;nmLDx6DA?cQwqw!Dg&v^^r8;+fjNYI3#yk&}$F3&Kl;U2tQB`qtQ!7N<{a+TGY6
zhhdp=Mp-Wsuga>bhW-|6)(qL=sHWet+YJ;c5&So*#`%g#pWQc8YvLG05iOm#s<UxM
z6g4&@G%1<=ChJX^{BgmeMNMT$8uc{zk2EKc(4MHX2br10lOH<Y_}+t$*_-u!C@~h?
z>NJX*Dkl|}vA7iq`W|?+yS<8fU)&C-Zg6H1jSz`qFI<?WvcP5*DqZRx2A<O`{^_R?
z?+pr0e<LGjUbZc@0mHEy1F9?|KzQYKx-yA8DJ>I`t@!28Hyjd5Q1IFfYzl2Cj-B9J
zNDt6H_zhOgG^0D0b_lkZV)ZS;#?-)j86J-_`qSx@W7Nryk;zm1UXGSbNgux|pcrY2
z#59aEq}t;Z;GJXjc&a)@s90;#*ocA}g@Bi>#yMJc5dg@3?>63HrO*~&>45~Cy7xaM
zAkjDxiN!{#%jg}KFwKmAq7MV9O=8!Wtf$TXCtCZGZ;A?|CVVqLL1AIqty5yl-zYx6
z36|sVZRL2vVIBzCaj45qUG$~eEeGP&2Ot^)ua2xd4|Z6r5Kva1o&E}<;1Ya<-_LiA
zrOIOcRp_ndmkF2v+~Pb&ZW5C%5xRTjbyhi1L}x@+iFaxpiZ3b3*$SFenLIL&bVN|v
zKz&ibd_4KMf&~{=Ee|--y(d*9gH<_nW};p=cfBT#>$8DDFRh-F6hMMV;A_9Vw@F^Z
z`rxN;vg$|j(l}ug#(#W3prey3r$qU0i6z>ShM3^N9|%2`e9j{c5)ImhGS%#{lfi8g
zl#D2fnzZoTj<53)hiuHX;x>|}woQrHe(bi~NoMzCq7b}9<MF5>tT#DTmuWI(5dw0!
z=0fuz-KYSc7A+K|%!XTYXK_m;L4hCise1OzWxU~(ZD5al5}~*mJ0Y4$tBtncE~jGk
zzcGY=hNlB=RLTS>RPpNdCN(J+EX?qx0dJEp)M41#(%AkBrR^c;0;yA^2}vd1!eCL2
zu!d~;y{=gtb^<i6II7@GbO2?36*MT(;TH{RY6h~)QEg2AbN=^VX_hM9i9-g^C4<au
zS?jj#+6QkC>V^t%4|n$^)&SCI7c-%OM2k1}|29i5%tjv`7r-Z5a$;eLu}Fj|Tw1yJ
z{T*+R%bU^u%7_XrS1w&4T#56c3PfxoGn3hLVr$U)_3O86z3;|%7XC{R4=y7zAE9X<
zpHQ*tiKemto|Ye?MF2p;zMP*wD)oGbO2T^1&EYHida@L47cdpas$0SSzf}tOGcBMi
zL<fbs8{L8h0z@flzSQh@{7mp443<bI5SH3P5v@TVBw)Y-BCDsoXt4K|){Pd6q=H4x
zqdoks!Ma=M5yT>zq5Q{A+R>zm`c2!Be5|*)KVaa%JaT-hnN8Tq_9yiE@NJO-A`6wK
z5aYH#d<^27lleqpBYUDjn<XDzcR!CLNb;uxSB%FOa_ra}lZ|cJ2`WVkXcba4*}*{y
zv881{JMGW)T`Nhs$oa(FeI-(cef#%k&sII^5}4}_vfhBNd4&u_2JN)9pva+XD~L8r
zOlqx0jG!P2MF;Pn>t4<d0{1oL8*#azZW5XX_l5NwkmWck$l@Py@B}q^5qa+g(;A|a
zpAW5a<j*Ik=8Y9i0yjrI+c_L$<+Sjx2H6~4aNovLx<wS*f}g>pcX_^VXDqsGPU+F<
z<1|&`yZ#1e;-Lctm;e5m_S6Q>F8AaXIVgG_R;t!X8_|SdnCx7vdvHK*KSm#f6Xj^j
ztPnFfVR{Q{Su?N7Zx*?`2v8AG49Kt=6qp<aD`CCDV16<=tAgZ7OUH`}I(U*@WcwR+
z4+lk5WX47L<N-sr>$VXU&u_lhP94cE8>A2eGz8s+BeMYtKfdTeUxpg{udGE_!qlDr
zt+^9xhcI61&ef3hNswGvxPbvw56N*U5~l@T7?&E^erLq_VxNw%YR8K|w{1;4d2b5C
z5VWEb-bjvOHzzN|lLjKJ<DBypl+ra*TS=QN7+wI~3e3-XYL|_RPfQpQfs-}m7i=(s
z8I?ZsfU1cX?z!Qu$5&+n;~vK&0R_^G!o*RcL<CHlSZs5;Q`K;gF)=}yNueiT72})Y
zuxt5ve+=McBhkz8o1o&AxQu8XCK#@%y^g5elYveFs7S>#PCa0(xpB;$HaAKJpohK+
z7$qAds2;!;T|q{r=!Ya>tSG!@P=q84QsX-F>6vEaHE0i!v|}q9ESTV(Dz#2YWzZ`L
z{BEzj<WpG0$>bJ_A`)>5QZ`%y)wO?NFfPEYIV8J<-j6u{6$Dz5DM)p;t)&RN%0N$5
zKHB>Pu7ekp2#CI|4|pg*OYP?~+<>+`W=Y6ce22Abb?@-xezF9Z_#iT37?qVn4%lTF
zsRtRLkfknega+~`_|np)OJ%RsFyHUiK00ym>?4Rt%Ae~#(6?X&vNKt+fCroaNHF{6
z5GND*v#SUg@Oue{Hr1o=M_ClY^a<v1PKVO*yAUm%)<$K@8!;YGkX4&R{HN53;}a^o
z<U*eboJ@1cBt!gScCSfc%z)5~$j+Z&{(W8+N_%$|PAK?H8}brOI1>K#oR!foC5QZ$
z`}pMX0R(oXHZ7#5PNJ%o`8^@Y38HBDO~GKqs~4~8(e!sW|0O(0-uU?O@akLX96;7S
zHo-wt9wU&7_JupN5Ll@B)4oez0gL>?wXBEjZB#`asnUZ<!xT5c8C6-kfeH}yU`9n$
zXaKLxZ)`z|Iq{?YS&w2PCOSk(O}L<wc0|LkqG>aeyXR%QV7q`Dw6csypO~Hp1TU?S
zBpigjfKH;&W1e4aP|6Guoq@N?fkA6W!Q#;Q)Ie)0Uy7KZ4Qux}s0aNzEj&sO@2R-o
zqjTMoc3O&<K=mHrfmgZd($tAqgiVHD{Qg{y^NMIK`43BmryR+98rq8cD;u0d&Q4ha
zM$b+_E1#Z$vHQ=QS+QSje_}5EMI0$L-8BT@Tl$!QBW)NI0-25T&T6>>^;;Rkj>XeC
zpT!Fvp6<TG*j4sI$=)fkv?k!9(IAhmTje0@=x`3lMhfJ%Av$2JT-t!vsJCq!Dr<as
zrUW$RlM<{Wmz(4K0YW$UPO$}n_%b>41U15xm{|tZ2QloUH1y}h3H+#~)%7?brceL=
zHVk}sV9zu6Kg>12!IgRm`QZ#|-cn%$JwvBxQ!6vjew^2YPOd=L){q<p(;|8<$x4S&
zrtq?DD1=T>hltJ_#)jC}Xmj5B4I4(T|H8j;h5lS#mALK893IOMv^!)rhkl_Fo+W)=
zt8QatQzrs#n>}&=|L|^M&*BI0sqi789RBdr6{&{%5xG<KOFIC$%q*wjx9{H(QlQ2?
zVfo67NiV5OAqNEC5?wz7JMIsX4#XRxY?;>CTztfGP$y9({})~gOE>*rco{$b$oRi@
z(?D?f0b-}V&RZ{m<;t5aSu+b4GIJ=3K%%P*`~#;<@V&zt56swP{h;x*vw8&+w-Y)w
z%~!k@Uv9jBWcdZ$Wf_^=%T{0IA-+QT0|!p@I6r@aXeWTbNvxMhl>iq@#WWQXO6kmW
z%3k4{JiA5CqhF;!n|5(^G)zIzHmX);eP}i?{}8x<V@>+*L?!rJSjQw#0Ki0}79BRx
zX-msMmnD#D%$>%2Zyl{R_(X5bW7_?E4ZA+Z9tdJ2mEkhz$FMvwb+#SS_dqJ|zaI5o
zXo30jlO0E1pO{A(4^k|Kw9vQKZimZWzix^Ih|R*VIt3D8&>+T<zlEtQp1*j(DV*FX
z*~A4<hBv+;9mCyOrtU@Gi*F*8zp_aCz*B+Y?e%^L?hkh=g)%h=S~(W2j1D;LI+35O
z%<%#vk?;USMg1B+MBqNq1JN5(K+Pmdym*-214M>dl%DU0)OYRHtuY0@K&w=AolO#3
zpP`w_!Ht~yx-B!=k3F@MIC~f$r%tb^^b7f2E*&^<0KaX~PEqL@AOECWPUgmzVaqk+
zed5H4I2*2KnT+Z={4QT)23UKz9opz%N)_?QB5Jh!uVIQc46jiM+9E8Aw7X7D*@D?a
zb|U?o#l;on2;X9t!^@SU=ds&_MnDH=X+a2(08*^3TGuLKD}SkA`p`ID#?Sepn5i<K
z8_>!tU_PQpVCQbfKUpWyQ?`ZM{w1ogvTM?HTay8MBM6RoL&}D7)Fxt@C!SC^*l;LC
zDfWK@n%^sPClKvvuj0$6n>xUQQW@aEJi<paB^Jz%Q-O2hv4XmxT8+eoNZZuTK)*8W
z9>bsl(V+lj%~aHjjrRn|rQDiTc|BTY4kW0^I!x*oK``LIB&f&`H1F{@QXI4k+&ctb
z2gvDdUPr%6=;tW&M3pVeKDbEOO{8T15Y_gL${hY*fHq+k;Uc^GuerMvFu;aNPMR$U
zmU|OQpZx!Txpr%+#sIJIK+1tHSgN;U&+<T$4{i$c(O7{7Q{T>~jE*Dqg28XMD8W!G
z7=l;i;oNzIWrE8xGtlzIuusvrPAF(h)Z+zA6l3bUv6jS?!8nPicYXQQG)hn9Y5h31
z`azqe|1}shRnDr-7)OEVG&X0?u)CGt_i2fsurxt&6b~Xe<&Bd?PY9Eh&_rijzEa5L
zY+8AlfCan|lK{nUTm1D5Mxodg56h8Lw@{?6Cmo8+pDRiik&NUkpmpeuojYZbJ>|02
zwbk(hkRgb9@9eexI;qQRfB#;QtV&h!PR6>~iATbTHB=>?+amJ1OA(`8vYM8NX{YXi
zMS<Rc6JD?GH>039XdYf9)9mCfOd-Y)IwlTwUWY*l<Y3DOcHgR@+&d%U<F~XmUvb#F
zO_<r>!P#`j^vYM@YNVdEg5eXFLzd}?c?F+3oWB$;FlKhlRLr+>(nNZdJ@=Fp57REJ
zYzd)8o{`11saJJPFva5Y@(UN-UB_XO-Lv9*L*QqBr_1Y%99+sO_+2vPhzKfJwp%hk
zv!f^9s}b}Py_1aV!Bomrr%v;#L)}NlA3Sm-g5b~j81+ZDFQ^Lenowk}*pm95R5PDc
zBV!I$uWmB2oR|9HGX>M#d-u>hCtRHR^}mJ(Oz!TUgrjuip`fI)@D4i9mi3@H2BUox
zs6Q;hfxOd|<AuDXe3wyg+JNxhm}nrE?9i^ylR-$ypMo2pzLqQ@$HvDX&Y9qhx?0Rl
zXhZ<7XHxA?%39}p#P*<;rY6n{Zr4UN@$76o@wuAfwtQ=F>h_BR3>BF7(~%u;w0JGC
zOerilmGhCzfezAIZy|+u1<D?csd{FR9O9=B2*AxaXnwnX)|+9M<1;d{Hv2U&U(rnK
zaHzAUrTwD$nhnm)vasnsV3EK2jY;t{Mvq)HqvL2z_x+`pjI~=?M)=QYa5y<RHn#1;
zO(!fhS5AMnqw4nXJt{YsHu^i})%%E>uWS2_9JKuQ!-Y+f9Ds%4ZgkpBXz2VuEdU%G
zRPI*xRCJ43D}MNWcW+{+hz?>n1qyZX3t{EC5|MDm_3ho8>I~Yltg>$1)SvKsLf$M|
zG_BAt(OrDyFm@bD0s8bqfGXVdaR^uJF2vIq=yR)?bINvXda3G(r(#%1CbQE`5eS?E
zs9d5u{O8+-Xb`rUO^6c19;5N8Z!34Y$;34;ASu$|=SEHnbki07-ND|~nyrmowwP_T
z_kEY!hKnlh3n)eOy>;T0xSQhZ6z6DocI~&moY1b^4aiZSbw}6y_;3dLlwxob4MZD{
zEK;tp*qL?T7b4dijB{;cUDd7j=a{X?*w-B8Dzt^1+apJg7_3U2a3tKJ>*Xg;VhFhX
z;I|P{ePylrZhXg?3+i$pg?wzNshauo{b*!Ep39f_c-J&_8D0<+4>GAwKkA(KZ9W-2
zYWsGV&brgGzCKlBD}f~jCL9Bx*DxOI=mADUSxXVCmt`7;bdAsmM=@GA=}K7h_&~ET
zMJG%3>)XkJ@2N+=tn=k-Q|0W;_YCH&=j4s@Qt$PsZ@+$?US2@@A+)ruuo9-Dl<&k2
ztyS|pM@%jNC=gJDegt5Cp0v}I%P1G>KHb?*01gSUZPKN+QgOe&eZMEGSvQa-A1M-e
zggdrh&UsEv#z*cN&P$*pNcz*EbSjGjuH@&3@znWv<?9jUZv~E&v2}XYJTeN)q{=p$
zWX=GU@~SRsviRSu7B}!gw@7i(P*)fK7XJ9Ny-PA@GAfJ(K()#K!APZ<!R+C!YYh}|
zoxss<z@lA6PS^MG<|>{)zl!>upxDYaMwR*JO&}8m%-Zs<I<G3Z>%*BUCuYbn`?F_P
z7{40!)p5^3RsoG*(u697n)2)Oy-N}~R}B$m%Jx#eAj1DS%N{<UZ+i*GN3e<SU9B(H
z$UaYerFWAFHCEgr2Lc-SaO};$3<^@*AhcNa{#kyDVQ;tcXAwj*m}Y>4jbxDZVYOo`
z9Kk&6ey+lRVGJ>1H-M+mYp<8i4pwbVS`gC-*8QrVn-<AbCznOG#B}*5_YOOPXoh8L
zCYm1m$}d}B;-%2!PYE_?cH4F_eQ}YjG*f<IGydGNInS02W|nidSO)Qw@n8a|wE(TL
zH@G~N&dfO4bx<n}4e4l#`WSRF3stRlF*~}I{5Z^!7`f_GwKTpzAC=%>@Qt0GQ8y~P
ztZUF!nz(AckvDfPmd)z-@9)4}jL2pS__~`3H2Qqz+ztRP{H(~{brRc@_VDFcEM{{+
zcQcJb3YZJy^~QJeG~;f=hu2@slK<1cK|`=b+Jg-g>-80{hJP#pz=K|ZUJZq^tbg^Y
z1?)1V7%Ze?e%+fJN=tb#Ru`Ah7r+Z`hoMgCHPvaIZ{4@5OELPEB}b;_@hs{-?<rhq
zRObrNH2k}w6J-wvTfDysJlo91oVd8Ib`OPk@?i^8W8+97%J%B@ip<)V(cM!LyHy(o
zZdi@j%05YhA`Cgr3s6kX0yYVrjM@TbIvQ#+EmXI#j|BtmPDar*3#}0-a>?i8EyCnN
zXG-C(A0DQ$Ga>2Er!-&-AzepMzE>O0*=iM6226qhKYy2W71TVE>y~Zzjmj~iXLH{h
zrKP+0OWuIzvSm;Ida`btnR670@FXqb+*^BcapmgetyAuX_YXps9O$XAjT^U_MP5I5
z_AJw;W0o#GUgV_IpS^_Qbqp1hSzosX4U6<>jz-ZPU39+R2OeiwdNvq9{r89X|9}=T
zm`l?hLQdsEI(meUc)~VlV=~n|_HdvOpS5Jk*a;JMB<^OY#B;@pt|(N<*YDUtDC3uG
z+GFy!%bqzx=e)QZfM7EE`i~gKjP%gEiL!ThieVCFSRJr{5jXfQbzkm6M>Ov^>?S3N
z=<GQNhSAqG9&vPHs9UyYtk0z|+y@4f&`bSRett{k_`rwTkM`&S?&Rl$UzNX4<nEXu
ztNQZO^YZczCC<VETP1KxXv?j0N?>NbzCLwle(CW}RQB~Z2DOHTV_k!6Lj)qCc(ln$
z?2<sC!dKh2XOBI^{kyksW8vU|AN<~G(|H*5?!ASAX4}4fHwj{ra=1uFD>7l?5vDsN
z*+=6E^EOKh3rX*dpt?9~=0jqHU#$Nj+&%e|?rBo;mm}zx2r(49FskFnW#pKX5-Fi1
zYvH0$U2<%*Lsu!CoNdPq=6!L%R(^OMQRHOMW#^6j+qdVU`*ODJeuj6kEhgsJNk!bb
z86bTbzcoGa>Fd|>LD1zK;-xp^UbaRIG?scY*)3}reLE!79_G=PF%YTIsulOyrsn+v
zrh0he*n!A^*4j_S6R96h;>?S%#hO_P`{G?sDDg>AL0MT@MBKwr$$C3)Oopl_07RKZ
zUd2rzr?7A<WbAIp*G@ZcjJC;+OiAg^Ef;|!q2R)Yf0iv^vz3HR)Kisd$1*iS?ECMd
zsU$zoMtmdqK=mLal3^|Z_W_y|0Lf^x$XF}lrD3!^gHJCClho)K=KxVtYw!`6wj2{z
zVhYwz80K&4Dyqtuev?(ii0MWkRE3`bv2RngSsw?-UbFkQ<K_-o{Sn=!8kP$t-aWy0
zz=XTvgU@3`u^mh!L{=J+;<Dq~#dw||m1c9s?3a3bS8g6&=lJ75>N2=Wz~ae>V`z<|
ziM!bP$%ZT<x^aG;bVsXJMeW%We*XL#%aXFKU#AIryAF`c*=N@<l=6g|yCkQS1Uuy4
zQ#b8uQ#A6!@ZD;GdYU<pS{$hV(serR6sqo-+_mi{Zqvi(%TbQidOCCLgI2)q_(f20
zRFTl$TsT2@bDQ%$|L?PXbj`fJ#x_@*V~M_$yUo!}NJv=EWn`s#XLie9e6xy%0#bql
z8OS|3g@}xo9E1_NefZ(aIXS3!@=&tV1Viz^-+auE3?PQ)$dlh>{y19tqrMeKmoi7y
zRd34q6^r2+|5&^B!d34M;5iij+v%hP@WncJG$#k#R<Cd0lQ-9nMHKRsr&k6H>TDZT
zL}@8T(;^7ly?eKFUiTe;x%LGRb$gx84?2rQdy0wr5$7aTnhxAe{vZYik)n~8VUn-F
zrJ$UW^-HJ$1bE<uhH{F~qaF_&k)6t}_&Z>J`PhEb5~9TkmU)iMwW}!PlTP{;EoMyO
z^x{XK6MR=raK;#6G+~=kphv$F?P}0EVJ+u_6bg`)oo!id7wo=h(M<p_8Ao=_@QS*y
zajF;%odTp4Q$9wuXeFF&HU6QM*+|YJ_qRgyY2>XFz1-V7mjI3=%1+nDQC#9Q02A@z
zLtb!tVM(NvW9%v2yLak|L+zoIWB3y%sa>*sdlC1>r%gasHWgL=O%68|<J^=3$#1im
zuKj}p0-41{3E_Nt-0c7IQB55E9&T!~69%A^JmfLFXv(26y1b-YumQVG7i^vK#W@=8
zL{@adG61zue!d_b<4N$SbI0B;(WIt$M?;Z90C?v8{r5gd1=O|0XR00@)NrnUpw@#)
zF+$nHGmCq8YmN$S`QiU6(7!59*ZKTy0sTP7@aN+USyY)4|0@Vz4{P~h&K-usRR3)B
z2Dv|4psX+H_<&X(idjdOxt{!hOT?zl2OrHKR<Syqz^f}QJ%|huf;-=9<t=i#sDrq2
za|nTJYd@99G!<S{(L*eVkm6)QjkFm_$qCTXRF{<Z$KHJS@}-JU3itP8{dBi!FgC%)
z>dI)N^f;_wBBx+S`y2G=fB;F{e8-M8G2F5OV?5p&iWBFd+M0DbBM3>K3O4U<+?J7R
zL}j=Pji@%veP5Q{u<TBJ$y4Ti;-I}xgUgmK9JQEggp0Q`f6S$v9~W1BknMbg9l-m8
z1S=$);;Mnj9F$!srZ#PM`d!d+R^|hMJ8)!U`B6Zdg>WO#W5~UdrhG9zO4e%CvSp`?
zkR1w$hroD7z#wu~b`X5OJ&AhHk7kvkeV4|a6GdW=i+cBoM|H3o0j?jdn{o|WOd_g%
z(pESQKhv1jqZ7!pC%OORyj*UkA&0f_{{6Y|RoM3ICYYsEsMvg5v1u*!3$X-X{>+R`
z7mU<aicp2a^JMLZTW&`$|M|~_Fpy-L<#|+@0E2~KKhgiDb*DMH4lwh8<-&Z<s}CRU
zp_Z`MO}oTFm77Jn07@tXV$@U(p0aWB6Rm`!Q_}7KZG2=SV-_tC19_Ajy+yZ~82O=K
z4eDg6J)k{FedsC#Z$g~;?9q}e0X~1yb$L8^#ici$f7c&KCvA?e_b59%u|%8mT)|={
z4wRvEOAkYTcS{U-IHr3PXYG6Y51)^efWMMU&g@@NcD4JJwGT8<cY-tuEl8L1J$A1i
z{iSp(C<FJP=|CDQ1(dzsk-0C}{6sB1m+BWC#x5dUKO~I^&?Kx#D>!V}Fr<>}k7a(h
zpJUTic%y=XD9*!4ya}Hz`_{O2%`{AWq+6bPW>Gd5uFK@Q2$U;mBn=DKgfwjz$m2$v
zSyCF6$~^ZVbMscMTj!F+k@~pP?Mdy61ECb7Df(KY_+HdGacy(2#XPCv)8z4ASddLc
zp5d=);9b%tM1VxJS;LB1L#fpmv{l_YDh+868qB?jVN()RJU*ig2G@GWC?i)HU%Fsw
zQ0itnnP>bwnp%7?x~x*)jvFvBEG#rspfP}(1#9D8@Z(clQZzuSc9>naEx$K*crHD1
zlU7|dHEY#`+Xe#-i-@SCz)qT*_;dJzyRi)*_~USL!H{b|c|eYACcW^wujP&T7@pqV
zGXGU=m$OEIGHN&6;8(qW7FOix;z9Ljx~SAqb98iH77cQ*PtVx&69}V}H%oG%k&Rxl
zqTY@3+Kf~&3(SV~bgc;UR1vbPk_v&MZ|Aq1b`<202o`i)Uq9X(E6q;d!rBqy$dTln
z4+@QrMhuf>2Kn5yqh~H>@aXXAiU1*_t4P=})CKS8U2rQ*Zj1rDNaEy<Gm0jI9{?8}
zty^hA;0tl+st@o>4wLnRG_9=2J7@o8Fmw{cmyzo!WV;4yi(2)yZtP^a-~LNCZwg!=
z-snurfceNvAeLmv6vv~{`y2$ybQw#B-(HYf?5a5?-FO0bTa1VJ7{z8RdQL`SmQu0w
z?@~NO%*oH4lam4he2WNx5qF$@v=R4KLr2E}OTF=Do{%ij#+K6~pr?bJj%l&_2}uTJ
z&<re(5#*%wypz?ZU%v__ootL}iyJD%I)*Rrf4s>`8?@h}UHkS4j)oAbooRYGWx|^?
zAPy^YH@UG<#~kKhywqz=c#UwAQTelzK3DxiJ+q)NG0gsccx0rp_pCKf4iN|Wnc;mt
z%qikqk<K{y<ES|pMH!8d7fq?mKH>X7lPf@qZ6&}E$j7XC^H^Wf8<61X4U??d@a)=?
z4fk+P>76#l#Kf%pIxUdMifeHrGDfsn_(;MV{aazOlRlbi=@Swo6Z?X0N>l-Axrb`A
zbH}rV!Xj6NbX-@4MhAnEiL*v(srmgy8-^~f-SBl6ikw_h`OvapkRl*l@rQF60Z<IJ
zco*Uu1|LX@=AkCf-t;r8;NHCvUAKvs41?Z6@vCKQcvxDR?7ifV!n2;UkX+<o@rqZ&
zL7INZz)`xdOi0fg=oiUoUw{1I8B3W$wgtjUS(^n53U!D`yX4yCcNpGT81HPQqcg3m
z`QJN6V(v2=*^~B<RVh>#pbJ}g;HOBFRMmLzIY0Q${qN;nZ!(Nh3e-vfA<9!Y99zv$
zRS$htYh_Er<%CTaM?KkI1m=<l`fV_Vbp(1Usol&%cQhl+&jq@W?+<F#=3GT2(~umW
zgFx%NJN<3>Un@2bciA_g-($?SAu*V*7)hRQhe(@jNRUxJH|;j~)A*BjS`7c`Pu)tk
z4c1;D`({XBw3%}$t&H;D$MLBZ!cFIPh(&OL(d0%^BfNT*c749bxP+0-NVgazmVq|7
zq`EZ0Ob_Oh5tVXU<!G~~jlqHnN^c)=o<spjsppP*k)*PfL2hj<oL+mwHHfb+x+EjJ
zq;_bVE+KfcU!3PwevB^M=~uJwd~EtqNHYK7Ep$+2d@)I=?4M5&4%Tn{;{A{OZZR|`
zqehSJVW>%o+I`u%Y5L6_XbhvlDBb~M+Ur&(#HXc=rWxW^h~vF;Uerwr9H_6kTy?VT
z4iGS^*M=#xQl@b))tc*2FGY~&M-dx|$T>tE!g^EWF+<jTb|5yIvnOmPd+)YW1~k{%
zViswS_7$&)8>Gdg$j%o=&~77YL`aV)RMuFMw5w=k0c$d?)ixpg{Pt|ySlK>>u1kWD
zrt63&HlXvn9c06jNFYesD0@?8)keV2Ejzc5G6D66Y$t-!-R*FdLpA=)W*{0eSsaN2
zmTP`d`4Kn2+Gxx5jSA2z&F;Iq$Wy88S^hTGW?Cj(y^*z<p-IS;cuqOW(x<F};d5<F
ze-6So>W@Eqc`L{B!q}Trz#yg^Nptfb2|sst+uqbk&q&2;cLK#enV2X#m_#&>OsoB+
zOpttam!#7xoLkkM=C~plqZMxiXl?j;HJP(3)gN@naX3;g-;`9_&UJg4^W&v0cyO`{
z?U@17(0mN87;Ukb7nAXzX`K#R6@ZTrKIj>*Qn>PxVh<hqV)+I{LMS9Oj&UwVqc0pk
zPp`q>v_5B{SvRDBDVh}sZgMf*8NX}HMOj1j*I(WG_T9?T>F;0Oj3r*l4A!bu3)Xf^
zMnk)dou}`7>#|6c?eO45G1fi0!fAZ5rL1@&O;6P~GfuS^+3nrffVTbI>{0(oe?HAP
z4+nS#Bg8!okPuOJ6;T>C{V7Y#vWJ@|p(hMYPyh5}T^6rLIXE8u&|E+o<&xIUTH!{T
zsvLI<=F$vqyggBkl_uT%9O}BH=Xb-5lBi12SJ2ztponbJyg8a@+v-Uk2^=x<+X5Io
zny_auTF$mceNmz_;&huj2UNDlit>Qi4m5L;zTMoO^zHAFN!r=eeqban9LbB7(j8ZV
zJ#=B5e#ZN&#MuWZlrRzS(ABRW1}zG1+h;+c0sMg+Pw_!6Xu2nv!fzjYxq)w)EccYS
zw{VM;Hahn?5XMN<u5v0VBoR-iZXJq|!blWflmr0E_FWcgP2@gEV@#vPrwrfFT-zP!
zhPHIW*x|J<)rK7td4~WG6d;1T^V@RG^n3wsiT5W?pLUsP|7l}bST@6cN%t<<w=b}C
zaqRYgXA*Esi{n;CX)Sx*s_lMv@L&V+OOrK0A7=4bMf64`QJ7BCW6u>sgm*P3Cy=%;
zI;DOhzov<rS_0&{Y<mFq7acNV2&&UbgZ~CLZ-k1*cv;;16)OhFYXS?EEuP#@BbVg2
z*>7SH>2r~3eWsp_8cFAqYeeUB>eMVsM(K$;-f4!D^X0%}+W7y__1<wk@BjaQCo5SY
z$%v#<$aX?ROUh~($%w3MA)%#|21Ub6G$}hWjuBEa4i(8bk}{G}Hc`F4*Sm8*-|zSG
zyL^A&e?H&0L%m+l=i_l7x7+Q0yJOKo<HtDcH4G!zhd>a4WsMwCRzjum`Q4-b6#9l9
z>ftRrcKjRseoDG)P@%o*d%{Qe!DsQAnL+BgIiW8>v$^byL7(Da-O|*Kf`yRNAZ`SN
z$s>#tK*v#ZitdMB0CK_RG+V9jF48CQZSGQLe9wHfB;hqLL_#5)reIM>6<Srzpe7qG
zxH+N)yTo6riV~Uw_;OJf5WnrEc&5wXSVivKdEKw>bLX_K+d|-t#K?wf6$0c1w@1z<
z`T%BVZt^|cmoI<D1(D|6EWvK;zI}NZIV49UI#3!A`Zhsij3QQhqFpDea7P6mlX4hN
zxK-P>lXYglP#j~n68y~VpVLN{>VEbhrIb-6#G?js9rDa?;=u_x_007BS<wv%X8Q5t
zvQgO~cU`yX(~ASl3kXJ0Tepg|6SM90w$0x#hPVgbL|RyAmcs$rIsGXSq#EE^g91bl
zKI;}6P-4=Boso9{kMfMbA~F{UT^Kbcf(*V4A)%*GQ8V>At(oEdZu<Hg^Gtt@d7~NC
zO3Si=M=Rh{?U=!QqbHd@u~;Uz#N2`Y24+n%`ob>bba%`EoQ2ighmp8|I;Y-YMJhnV
zkDqUk?P6_?WJs;|y4x_99pdpuHjGx_qXKF-myxV0qsR10B57{W)s^^e3m(Ma_Rj|q
zO-T0CTY{qTR1TPT9{Lyu2ii<m!DY}S*i}u`o2VY5Eb@Q!(d-G}UvwWe=@VCYBi1JT
zG#yBF2BSxA))cI3>#djVziz$24W<5D$q`9Qa@)*z@9SP>$>`l}UNp7%6*3%|d|Y}H
zOU8rqM9zo9Xjs&O2%;BmO*+^9UUZx+fRB49);xTetIYlXKl+~07gFQTqB*}xN6Ur!
z_22;o*$&Wzm7iaYr8A*(_zywF-*-!^QNQN9yP`D%bufsm4ZL({;vo$L{<Gk0a^Adi
zbY>D>JNkx5BjIXv;UIwZZL|(qPE57)hg#yslWh1J!{q4FH_+U#B?=<tFgo?%>)a_=
zVgYB)X3myDtWiLyQUg((NPPozDi99?-E_2}6yeA^Yxq!q?-?9T!2^m3ToSJPm&_hA
zOAH1xi)1GjbNI;+M=sOnU!@b6Smbk}C+J`~2Tf{aGy!DtYvUfKI;HE-;EFy9Kyf9V
z1%frP)1mO|RrHwqE~pml|EQlnpD3JZ$2itCTY_%~Mzx_$B0vy>qlVZ<79O4wP4yy_
zE@zBNN}p_Cw`k8WukEDHZ3oM($q+B0D#RuIjX{*0;Q!dqJ-lmK<SUp1w<{&$_pro5
zz)!pkju!R}G#Aqryqx80Q>GpCI3|>pnwo41I=iyGx!^*X3CV_t2CmbU(*7g>1yiB;
zWBk>k)8wi29TYl9VkTXAUCsOH3t8`5{c^{pi*@pepg4d4R^VJjQ)i!gL43M%bA!RO
zP_0}xzc~3m6|1ao!GGN8tt<h=jAmicVH-S_Y-=rsVF}9k8LG$jjE^$l9K|DlURgN~
zY_;&CES==RsE5>b<~9*A`;pw!lDv;gF-g92-LexEcncC~c0qx?)r|qxTo5-3gV#C-
zXNe5LAuapSqg|jPq86fr6;OgS$np*fp7awZqJ}I?NAwg!KX~_G*pA4>|Dy$%c&LT%
zc#apEvQG3<Sr~oDPAfOJQBF=fozFYCoLd!&++xeol_~lwK+Tw)=-hc<KX;Y4J`4eh
z9E`q0m)*!bMRSjPy+?ziQ{C1B{G<x~%pi(1`izCyBDh1abQLZUZDv~6#tLyFWTFn3
zbw^s{JBTAusgR8M-UBL2F0rOwh4aQCGgZPTcps%RJeBq%%@XE;HW098Em&Yfey87}
zxmUcL|2Go+zMLrogHchNcOT>xN;%H;A`j6$w)ZI+VQt+A1OU}|9vMN90jk+tJ`uKo
zI>$_S;lQRhQIFBHZ&YpVx3f`;PNGS|d?|<G($?Frw3awv&E#6z)H6p5?ZZ+C!LlYD
zh>`-O;{Krrjr=M}vAsN=zhqhsHk&UzNse;YSN}UAFB^YVs(<p<s6D?&PYVy22dTFA
zvYoc(4B!mm1qwCsX6{WzYZl9(Wp0OR31)|0S!2P_aCKmE`q`bkcdvMz-vu6f6ob)R
zdMoE+Abkyz%K1#UsW8RMnzJUO1M8*JU<r!62jpxF)&)K8%4QlGC;H86obOFBj@vlE
zGJ8rfmNVlJ-&ywfQoW*fo49q{I&_0PXNVmwGNGJfDlozPs77p>%({L1_Q0QJThzIq
zw#;e}{JOxny&2T`#rtM8WvkVS(b>WstxeN>G~Ee|g6{fz((CL4760FUOG&^6&|p1A
zLuY1qPhq2Vx_RgNYY$P(%I{}b0(jsSZ^(_Z1~t~g!Pif*r%|M7NH=dj&`@2*crk^!
z%(;*cQX-O804yFLm<lyUCL`RU0vHTg1hy|zNTLek7{@@n-aqEDkB4Q)b_wQ)XMC74
zD!(J#q%I5fB*JM~&E-0ZS{ps8dwPpLs*0Y5hO!-`05lhPS5yR;+KAP~yLUYoO#X`m
za+gk<euC6U9IcDf8pA}~e=IsPtu_J4yLo!y{6z;T`V@P2*HztQb_lNx@<1A?gsPf4
z-s-RIKVj&lnu8Z$9(6*q&=MmQSCs0GC;?(@=cc{6>r^xy%L^3bIIL66ZA*n>q4)!m
z*t&Ob1el|0P+4ci5d{k?i4OV5qFRk{_NM>hJozr~A9A8QeAWL22*{km2)I(caXL~p
zyqSonX{!!%4b@#}FGYDkZ5E~842jh)K$KQmT0%td<7Sbp+Sm5^^?pz_AaFl!kqnLQ
z*s;TQ=>?8y8#+#B=k}^W0f1@w=R6h(PKgwWf`hr)wiOwF0iq2X7DuD7D7#r4w=RkL
zGOF)qB}}<czU_h1pqia<V!wVWKqTjUkBMglV|dU;j7c`7pT-H^E~;{7;)pNB6cMsO
zoY?AMU9C-EBtA0`>GEQr5HDz-#t@|^>>P6v3l4E(fKk@#$&=-<06j4iCu|zuiv{O0
zaV=Caa$xCls^bArf_dC>S`K>vp9F&55Qu4X`ytTgPLZyHZyr5`D*Q6Hawj$W<Hu#E
zGxZ7j6lF#NK~en+F^aUK17nmjL*?TAu>oLYkZGTZ+c{6-WdYxG6N3cXuO%00&B+W_
zaCRbVdpoWfpn;a~l@tuaYrjMTnhK60m^80wlvc{$L`k!>34+`sdIB{xPq1SRPjP@@
zcL#2I8$?`?({@Lk2ZA44L#l#8Bi^9W6eS0kpx(}mFA`7yb1Zu8_>9W&9<4r1UUJ0O
zV^1}Ln31<XG|33#@v$6Y!c)+YITO<y^rV$U@NfqS*XY9|zP&wmNuLpC2zfhN&{mHe
zfAryYCG#AtOqEj8gk@*K2WtpMBSN|H7r!qbkI62U2q{N5xDmRz#oLB#e8C_<cF0<@
zCE0PhB8}peNej?@(&16e>QX)nI&j3YQNi8k)ajx=kbsNbp3O;tpFtD>y6HalLuSIn
z*zT@S;7QyVoQ(?Hk&lf-(I)eRcpgpnl0zU+q6DEqU~%stRuR)Sl~Pbri>2lp?_i9r
zy7GLL6VIL)**$NnIt>9JzgSD8E*?t<Ed?q~#}Dq@#M4LjA3t%zJZ(Z$WTbd5i$0Mw
zmrMF);;+@M0$vecJm=V@I%ij}?G1^Q_(5+4X<va+b=vcqLpWU6A%^G<G5=zqEES+3
zBeedd8ogjU^?y@%rUI*s`qZ4vZ%xl{T*$;|ii1>!$fKW}_iVxcfQ{Vs&gs`Bmd&i;
zdr>c!EMy8DTWZmP(j3aXAMz-mD}!&3QRBoDUzt#JYGBh~BK3r<d7ySr{o*{jJA;o2
zJV)tZ0Ywuhbk7Og|6PUxx!lNJT5D<=c<j-Ul9)b`R`VXKe-LJL@z5>xV|*Z1m_g_i
zj4SnFs4yNX`<ypiG$^!u{Yekl8zmE9nFf<34Vb{dP-H)NaK>q$#RNUPg6Oni%LMzq
zB{!KaqwcE@k4<oUvcLP*cf%-3z_u|_-42`ub2|F={DU0y*6rHe;8ri7twXwfnYI`f
z0F2YrEgb!WTFaJKkdcWy;_lXp>POz-%!i%Q6AL}udcO7j_1>7ef@<0@y3rfn#TWn{
zgqA}wAE&M+99EyH7b*=J-D>AA!zMYhtS5kXvL$l_Vul?M;fpM<HcnXF-K(Ts1G68g
zWAT#!P{Ar?Vn1_70k;NBfyl7(cQb^hl-Ve_T*RZ6Zw6gfbRNHwg&NE{nQ_@@jiNl0
zZ|CLBr!AMRga(KfQ^H!!9sAh_zYtY~3jm=Kvkxj?^kXf6=J{QG;!^kn#ko6>A0NMd
zoh#tlgO_<U4s*3EOH>)ZCp7`=MQ-1||L&=QR#fuxB#F#)uwp2|_zPz8y6EvJj}LnI
zQL&J8(Hc#7YnozDh!ISeX0db4vr*mAUiMslW-pf*-;dPo=4;2|;A=rS_2{>p<!18#
z>CFJ=(TmCiBBQ8iXBs5EeE<GEl;@s8_tAfo^7{7c=djk=h$@TsAao=16Vx;05vLax
z4bkn%`XFx#`1bZMy42hkg<pO`J?XzlaBl`#t)`487OsVNq{f^lDo5+PYXAl2lDT@$
zxUf@L_Zqj7?*;eo>k;j-CcvcP)`T-RPt2ro#7XVonDE^K!SF=EQi-yKH}mqkVWokH
zOqPv8sdgM3g$ELaKaJInAvz!CUnzo>kZl8`u`)U>COtJ4_7jmT6&&n_b-2ywOMp``
zQa2oP84h%~g--QS?YG#%bkpnqB<2Hw&R($K20hFIq-SLF4V6Az!CgQ~GEGYWJ8*iB
z_<!8Gb?90C#rP>=lmT7~fCLlb%pL}|kY@woNq<js=2y|N=Jd031ALBRcu>wU=<LH(
zag}G{hSd08i6bVc1@^;{YvVrOpP}@>WI%0U3iwk<sr%kM_yfQJyedIjw{0FdIfYiv
z9fNmNNqMjvEZi&Q*+<O*E2r81gGyP7Z0LiJU%pKEm5D);37-N3);QkHv-0v_NCCVW
z2+K&F=;l@m146P`x9rS)(7}L4{Q=$VyehLCto>8*9EVF3!K{!|Fq+$r9<!mTT@T_+
z`h@hNgp#dC3($oT-icFbb4$jXRtGZKVEe7g;hqt}l^=1^w{~4xQVqV?8Lr{4P}sJE
zt}Hm4wbDa$?_gaViVg&%*8i_=i`~CvJoo>r+d4Rhz)a`jQ+V1Jju`S(@Nm%kwv8G!
zf)X3-TeBviNZ>M>{;PR;<Hy<rm7$HC$EcT}HFU7HS_ksM2SFNmxEMi?aCJ?5+`?^}
z9<`3QqV_wJKmBlL3m<;=lPS!#HadEaKN%|9zgaT}5`?;H1LAo~qE}t895`B?2Rkh?
zQf@%Mz;Ga$dj9(Lbs$3MlWx##AXpfFq(nHO=V`^JPrgtt-#K*iW{JK*Gs>5=E#PNt
z>XoQ4pFCMu2;Z8I)?!ox2lShbC~C9_`vn9DuuD|GV;E&LOL#5%%#Ro8%n9J)_J*5O
z;-|%EPY$4_Kw>ZM!P}1YRv%9<$KRa?$y}IfZ}Dc(!pRBd4QR;+vGfC=n9X{-NtE?i
zL^`c|?yU~(+uuDt%L2OK&HGsvg3Px47nv25i-%fKkQ8j7)`mE0s!HD+bK!Z?2Vday
zBw{i?&$8e=eAua}N2d)2^`kn%Dq#~Tp+7HXuc?o-&ad*9FI#G8Y@}>t9JZYMLhua)
zGD!2OqAiq#1+xB}l0@!M^*XRGM54?t%Ow;jkV3R%@H}s@7KCi%5;LT~g?ld^7nor5
zXvej=x1fqeoC3(u7GJhcXVOQ`jbv7gm-YmGAqdF{YD!s4M(Rdu*<G>hL&br8D~SBt
zj!v1xqeE;bQu%7SY{0J>Koapl$yUA!tS4^Z<?`s!l%TW$js#($eJt&5`(Aiof8nA<
zqv5~BV(QuXs?6t*OxZa(U7~M<eOaD)_%HPHJf*8SIacqze8BD?7FMuzje8-7NXk+k
zVC{qNuU@{C841M6V@Nyq_f9m}jcNckMb;HjoT8a)<b|e|%0%R7^6;nwMOc(Jd)p9l
z*}LNNJ7^*A;+XI7kIf`&>tNU~Vb01bD$+g%FE`caFLA54r`dl79GJ;FEt{F&=p3rW
zD+8a1`zN1=@Ka7C<gYC(9Cm=p2m=vYM6Lq*@_3<J+AJE&wV)tUW6I_REeeV?O!R^{
z(;xASN}KI-{LF)ipy(pB;+cyo2g%0pr^o2)^+<9#_wP?kDe3X~^XGPhSLpIAyAB;X
zZPoXCBWNl`d?6`D!0BZsjSw%ZLq^bF4)UuT3e*}s#5qA=7r4~XS{5so#a<D0%5+Qr
zRBe^HS=8=QO;YvOtE>6&UsydcZu8Cu(>U)CA~K!FHJsdiX~)wG?}w3_(phIA!wDGo
zQKw8=bVaEA3fAcftoNTf2Lk8R`|m>jSb-AB6c_Cn3V{pXPZ4#k^`j&A?!ChaX>x7z
z)G1TovP8f`2%Jys>E7A?P<Nm*(8Pl&o6Ny4MN`CipF<DO-NnTbaG=fReI=-OmFP+d
zB8bZqPuMSYSpChY8ITK;SiN}N4%TZAz@ot@OgXGvKvHSDYJJbQlwsh8XAIPg0s+)v
z;wfEdJMW@SrJmftBs0SDp=&<G)A*CTQz8!8^Yw%G?wt`j-Ail~w;|w^s3Q}$Na9Ht
zHMw3+aN{q9hG(KVdxff1f1)C<0GWN+Z#wwSrFCA-_Au>2F^Uuci1ogyqGsjq=%r;c
zl1jmLVwXD#M7XX12SV7OqAw`5-ylLD3X(oJNv0*G%2?t8Iv`rM=pkX(Fdd%7n-kGJ
zTti|~(yrltrhwRlWmhD}9@&@B{#qs2&0M(fChusl_m4i3sYHu411vC>qZZaHF-U+0
z>KDGZklgf#Xm-1L95zQO(U|&~;sIh4tf4QM4OhK9F4z**G>^ZyhQbAut^2KX?1F`P
z<j)3t%Ph%VO4(RbK3svQe$*QSy`$iuP@D2~1y=r87Id>i{ZzWQyg_iwO!1@EeDaUQ
zyp+-@QFi~Lt+p3oyx8~?df>o(vs<e`;lblv=8e0j3IdRIo-=&=3!U7jeTtf3rczcg
z^nn&n$0NDLex$wJN7<pxR4^Wbn}v~hnREl<bS!`#d&lT<mRCL*3|2Dw-79OFJ0xrq
z4m(9cZnWrBOGOqAE-1NMR~Hyku-bP0=BSW)4p6}?95-VXPh!H+X;WVM?O68c@ne`H
z9X{%mgV%PX1<(lrjR^gOEE>8>x)3OXxg?Znncjanz5VCm!{snjO!6lsX3rf>5hh~-
z%*d32FaV>+LMeWNOxI}}LbV@FcI=PQVViFEra>@t1L+a$GRf^QV;Q`1PSb#;Pc;AK
z(*EVWJ|akopU|B_pw@9piYwIIAp5YW2eQ9cvPptU^A&<fsr<M*q9P+Sd_VI5NRndV
zCx^wkY;aK4FL0hen86CXwt5mXA=VrtOiU1$NFf48wr$9yU4rKc#U%lN7@lUJ?z@k9
zDHIpiCcF4p&72u8EPV8M(^*h#-oM_T!Lk;RA!mP5(pAtivB$wa0BQHg8#iy7_u6p}
zMGElnNWfs^BJv4|u^U0VMr(asCa3_c*G|OuD0Rwl*k`!*(5e=osiZ&*SB}~~FnY_a
z6RY^Y|CUiJ#2~iCwJ*4sCpn-*qab9SaBBO3ZkdmGyDWGmnA;fO6vFldn?HV1Z|`JK
zhUh`TqwY1#>?@RoOrig);Yp_Y-o-=}$OH~rdx_uM!psYh=JTQ~fUc7xbO!fzondGE
zy9`J>gCjFDCuU5>Ua4xQsj1{=I;J(%K;VgkfUPN&8)r<}5f?X>Tp{UGsvH;wVnft_
z`dID;ZN4~2?HaQ`s^uLtWW-Q4b#+VNO)7pp=MT%Na!r4|>+gJeu?^@pYJ;A4hak|N
ziR?_!6z~u+^@6=Zu|r?r{9IL;5XiiX{ZxO0%iu!o7_*a(1gLb$FSma5G8AnD5ma_9
z+qAKQG9+8g1al!CYpfefV~MUHXJ@saj1eGZIUHFW^HgK7#;FmjNW#+AG0`#c+Fc0a
z)gtu+JsYiMl|)k-2;}nY<x49vzeu)eQc&j*YnqI__0K>5EGi7KAM1hf7nGNy&hwWF
z5qwe<2~WZ26FPum?#k=Gxq?Ey;_;+++tB+gIM+$KO(AsH&w-57813ULVJi{;i*OPD
z5bITKC-wbLD!}JK6(M>Bp0tRd(@}0<WpbToF|e}#om@B6MS=<NH+DSkbxN^_YA~k9
z<OqNTTP>><h_FEig*HJOCX5(e+Y|07kq-K|0PV_<S0&PDBe5isq`_QKtq_G%Uv9no
zPp?E?OxJ+}C%$~UV=gV+Y#LAW<o>)k(VMPVaiTC?^$1%Pc>IyOcG&=f5o-_dF|W_*
zClT<&InH(e`FA?v`#tS&z)!jf0=GYNu&-YoyCOnyEayNlC8Dw+kfE!t64+U%L5K)f
zobhGASCrknE7UrFoyq$t3c!EMffQ#*ex}iA2<uWlN0SQ?61e_-fvEty{S%3gTrQn9
z9UC76Ld}Kg_-oBa9T}j6M&CZfA)N;#n*Pk%Z&PK@CG`PhxgiGEL@NDpdqxRgL`tDY
z*VopLw>-a^1yHWY==gIid+gGitU<rWx(9v69LT5X==1juT`R`hg174GzUXb7nnGc)
zzew4BJ&ZOJ`HQ&PlkJ{->U$8K9laH|S$3&GYcQ_f2+wV-E7T9hPT)!R9XL?W)O1F8
z=;$-5ZNz5j_k4|eSzw`i9a9V8{2PQ&8_X{mqYDOuVW7_RV8A5;@ut3?6<?8IlOu`j
zg`o3))N2TmJ&s$5*ML4cONQteAuqHa9S2tF0E8L-TA2hf7~Vqi5bsMDEf9(s8J?n_
z{E_EZw*d&guy2q#GRu0P<E$o)L&cc(TwSmw=F@=gmQ(d27$0!rVQNpVEc>#zbCwE-
zx~y6<@<`U{fP*X#xeGrWnCKHIOIlZ-FOuNtu!vOq;fHv53uPH7Ps}$%v8<N3E;6Ij
ziv^B@<(NxzDD6SVj)x1rZ%2kAPYNuBp#B*Y>>f|~RAmK5`BWWNZ3}due#-D6f!#oG
z<ONo|mc>$XYWY3jak#Z#;T!&MwbrEkNIyn+AzRu~1cTP9Ud#nQ5DuS1KL;&L*=`#P
zHd6!|O+DR*9rhWgtSasS2uVqac0(|A-ts+u*NYW@T{E>9vf@REW^aXyfCEd*&L?ZD
zq&(&=Rf7k^Xk2sgy+pNvpmL?SEJgjE4ET9*n9UD72S)9&RNBdCAe{_?l~}43TP^Fk
z#4{qR?4HDvg;M7=6g7$F=Q9DKWfLzCNK72ST0>~r5BB|9B6}&wtNl2(t1F*OdDp=R
zbvGGh6U@H=+@QcA;G0)=egs(*W6JP1-JPM5=>q4_+90J9TaECG)lLro|0*qa<_}sp
zAAs&^Klw-Mf@#yIr=L9eoTwI6Q}S40i|%jGWhW<0p!I2;dHn~w?3(u$q<~R&7BDe9
zpjWx1n;nIo411CIluCTQYoQPjQ+lWm(O->oKDUHzL4ZZThdn)Fl!1-Aumyw?0}8O3
zSyi@Fi6*IYZQi}RZeVD%IsN8b->TC_FVz`cp%8Gu%#a>vGju(Y`yC^-a(W%;n~@JX
z9ISHmTDR^5%QkpUqIJ*FZ5=ug^*ri!F_)$sOo?z@%++OJghIQUM@*}2U_&5OxKEW+
z;a!7<`d0?S{7MH59d-;U^TK#h9B)Ay#L<Dy>H3@#tqkwnEhw19L>8Ru#8oYg5_wrG
zu#}VQ5Z0#0@l&T>Qc5`Fc8@~gq0#Y99FCU)E*q%V((*B4Kg{DzVS=BcF6f-!UNkzC
zeUv4xv|AI7I8O}sQ%x9@`K!`Ij?1S{QA5IB02hy>c%&|D6pz^s25N!yzG#;=!xLSb
zzQxqHW~VSY$_0vbUg1VyRvt1>s2$@BmezqHgLdI#+>+ez&6{oC2e%i(;D;JGijrE3
z`2#M)h@yXLATji$@c<c9pe&GeQ*=-Vs7KD8Kd+emaU7E{6zQZtyNl~Q=w~$lT<mls
zsP33xam?s&Kd0~?($8<tBqxEQeta~4UtipeFZmQR@e1NXA^Q2w(L|B+6xCVXXA+1E
zbKqOw9b8W+rYOprz5#FjkjzB!x0&$<xnah8_R^&?IBc8psk6x|v6=x`4v2n{bsnpy
z5TcI^l5n5^1Pnf{sh0ePPZdQ=nBxLd04Pw59GXu=P^&xJ=V$(p7J%$ZCBkSQ{bB+S
zlYXNSwLjB4LX~rGX{ST`=67F#1cciuENF7Xr*WhneMIpBTFSr)Tr3FtBS^2pf<SX;
z-YkFN8cX?3Sokb!@m|{HF>yn-QARqVu(dhiy_qYLM+J*oTFlcsdk-4bnw+tzv+oao
zw2OD~PGbd*p-1wT$FNAi$=C322XnO1I^e`xkp>Rr#lhPCJh_fM!Cb!6)TsiHV+3`R
zlB036W->wIU|nNPNrwmw3xmJGGDE|{KxP9#1CuRR;!-A)D)ga_iNCh%k$lO-JpWO^
zQgrfNb#<j@O-pJMiYEtGhGtIu0JvG9<Z5a>kv7p}?BX!`d{{@;={ZP~l~D25UYNU6
zzMY_Rhmy77Zy{d!i<cCQz8_Vfs_*!J1-Lj4!E;e$x)tXA!x>9RNwFecr9>pQeERfz
z8xauvcY?`SsGvUIpX_q+^ILFZ89EMhlxS;yW9=_9HYeIH0xn@l{RB=2K*+s4I-cs!
zd^}-z4n>cgpoI%<fpUT26t~`rl7lUP$n*4>fThQV85ljZic26=D$?e;Em{Bt=0ZX_
zQE3lfeSM9~<O2R=^xcVtn8mC|*qi3loAQ*$4_PGm_`;H71JWiPX-|tf?ZTQ!vMXX$
zv6UFRdw^N59hXk7KSOZk+{ywnv$DI4CI&E4D?Z@ihRz^lJskXBLxSBT)N7i0pKb53
zAd^h<{N1~0^K$>j(TFKY$gM9+63$Yjz--lgy44%?2xSt)>b4<EcZvAqUb0PVLZOaF
z%=aNoym1A@ae<KLx^Q6_RSF?gzgMquZ`NcrI_P|=JGiqbf)Gq?`%y=)b(M;eBPcox
z@}K5KLw_Qz7^5?3UQzU3k?vVFtM4m?;_|+M4qXEES{VjA*mMgv(psz+b7F#1!&uv%
zT@S3->umpa(4C+@J+)#ix{q<Nbv0Q$&Zc{tP!EIP<_G`s^Yixox%80TyjOeEzCS<r
z?WgzAip-L#`R8Z<{p9mGm)<J@!tZLO<#4B@sTF@2Aayg0%!(r)XE6L!3c|LaP136=
zJvE3x&hN|PXx<UkBmu9A@i)6Y*=QjPtf72D*Ie4czGiNlOvyN%UEW3P(0FmqCvXcz
z?%$Beh~M4;J&Q#NX=$O<bXYLXreN)Zw;5NVINkZ3V}cuj56D3#hQLy1(O%0uH{IyZ
z`vZmSSa46D%D)kQ<mP!}GUyh|?eM{*B*qE7CtoNLH~`n!x_9%rXUu}?i*+|7uy{cj
z7#b#YnQK8+KoSbZn5)=6Te)4|@hTnuYCl3P(6YOs;T3`;NZ4-uDphtV(bQQkvL5;O
zz25!%w-z6AeqTCKh&>fCadBGAHm1wxDY?{{1qkeP#({^boHI3uuo4Q4hPRoY=Yu=j
zA-2}TwTQ_Lh*gt0w`nVooS-96!_mCN`{{wBiEQ=~e-oVOX&Hi`p`L#)@w3L+eZ(gp
zS!gfgObJ_dDdtdi;o>OB4K7cXCl2UhYZs7`qK9}!yb-Yg<_R6hTt5ikk2)uub*1gu
zyi3s#@_P;21$ewxp6Yh$LDU$hQ|rA(#)ivtJ^H&Yy3tL=V3f72_+R5!s3uX3J{qq&
z2y0;x0d((sR#p#ieoFsJ^hz>WdMJkt3^c5AO<boNoI#x?=5Yi|F=C{epxNdZY@mv}
zeDkKQuCcdT$#{Gn!2YtS4Xm8M_{ySW+?jY5GCYCTu;ppvkAtyM=YqH7UBd%rQzKMF
z6uMIV%lcxD3B$KNzEsq=yoY#s168JUv#tC-OZUrm*-gmF^R=vI;>jdtSZt$^v3kJv
zAMekU*iD<Z8FkU)upY68SY(3BJS^=9{yivp10>;(&&Q74XQ~A<BMVgBZWpv?-nKdP
zh=35hSB8YQi1114?Rh4Zu<>Yyy}(28OpZhsx(-;QQp^;_?%lC#7hYbW6x~<JQ-PtO
z+hyeoG|hqqqqHM%CF!uLMQv{|Sysp}`1zdIjwg`?4!A0<eS0x3i{_&Bk#^ZO9v%ZB
zf!=g$)G9DOv}$6X0PT?8KL|tIw-$&bFWs2UdMb9OZ@hcgp{4$B31b1fEGpQ?89?4(
zCRGzACEldD5lw+?Ut&8q?dL4Y1f;i(_K59lKj7QuaQu<wi3Y0lr@7=n8UFHbQw4&g
zPSq~!N0O3eZz{svs1YtjC@SQZQ;dSSw`Gl}CQ%(?g&U~9^+I?7J8-A?8+^EwK8+Sj
zY^1qf-A?%E$=)4QZNl=>5qH7if+4Uz?0TU0Vx`LmMt!1`3zp$swwc#H8?ZRTPs1C$
z`Dv!lKksCBn20jyt+c?Da6<n$A4^~g2X;9{RT>z5<L640K%4g(Nx$HY!1)gpYcH{i
z564FG#p{U2^T?^~Fx7^J*C@8%jUyppq?gQTHtW=x4h#i@%p2m2Jpxm2nj2|w7TDT)
zA3{bWei&q#Ha~B_!(o~E{vZbEs0visoua3wmr!Zr-9a$hpdgw0L+ERPsHr&8d5oiD
zYv7MHzrGnk<JeD|HpVmg&s(hi0KYuqT37?GNi%8w%j-wgL{@eJyJ1451Vw1UmT+`9
zxc;jA8Ef>({ar~{7S19@5E4tUY#1(cN5|+&C#AXvR)s7cA(zX*L$SMa18Oa1d1Wah
z!17ftfjs$hvwe2(4>_34Xdkj@HMD#5XhIP;h<Phx<1<&%nO&CE9JKs&{<e;;Wm8$N
zqD@D|O~5RziMmxOG=)n~wc6~$LK#ZNdrBPPg?MvrzZD^wI&}xqWwq+3WxQ9Zse_To
z6x)YP3j4h_!yOk%sjP{Le(5>i4zxI!yotrj^$VPR&P8uk4+)zwcdi~n0NG-R4)o8G
ziqUv#aULwFUr5b=ge899t6;emHnfSAy)Z;lH&M|7`l`&CZo01pR(gb1|LF!rxR0}6
z>;tPq<;~;Lav2Ns_~hjJ5byvCO=^_mfLKN~u}n!$UQS{bcTvi(EUtpp=`*^>CF^nK
znau#u??aDRL(gr8MI8Gf`ETr@sfaNAMyDzGsc1@e%XL=Df7jcd+0qbv-Q*u+h3NH#
z%hNlto?)a8#FA?$ukzvJ;RM>#j$Q?<`~cl7J1NkxhDZ2x4O|A6C{HoAY~wYt)Q3*N
zm|;oMa76sFU>agFgoG*cF~s;*E}DgpImJ!nuOWORss^60#$6SD5Ql<|C|3|272M6)
z=Y|c#dnr1IAf36Pt%?)Ia?EIYzs7|trn*^#+~HKn0+h!kzkH8TvW;Ld1W*!guaOW4
zq#D^Qg@9D3FUlD_$Jw%DV1F!^cqkL^U}p#^{rT>Uj)qRZf|E=WhNd1L9Fli;Eb?t|
zF3_=l=sMW{8O{)*ow}80MwN^TNsl0&jl5_OOW9t}E9D$00m;azyl`RYUw3+RA&kso
zJ2_kUBH2bSUWtmD&n-};)Q-(XydYlNxdcghMEo857gaAw2iim&rfwrEd)zsA=+KQd
zYt2(f$-?hen7=gQdCly%%Vp>|P8w<OtIJKX5w%?Ox#FrTPv^GHV-3@NTX+~^y@RRd
zNIqdjgykW&Hxb2wXJ<Y+>uz9VgzcqF&B1RztE}vGqPe!WX=g$P__;QAS+)1SZ@PV@
zbUCE+X5?f3o?mA7(In5+XGIECq+mo!ino7q6zkK+Q&%^65pV$(f_U5Gu8sxwN`&@+
zO%hg(JX1#NaLMt6<tn(ssG&Q)%;A#lU4VDzo`(*k2cz$hy>mK7A$7;dzVX0u1b^$3
zcm6>`%eYuy_^mE_(H+tJS<wN*R@-{U^!{1ccmjO{0Id)~@d*j&+U*4EfKC=zohsPe
zv+z$w!d0k(#btqL3S-z6zXGY(U3zA*Ddq>|Wh6<5p%|HKl1)!Q-hn){miqdc+fYx9
z+dEWbO=51X+&cq@;T$Gz?59tsk8aA$kyZTL)&WdE2T@terU&c;uMqO3CZJ{lU9;qt
z^aZ`<b`@x)jdhqbX(Tu+A9*83_1yD}otzk;1u^6${hWL59W5(ea8Bl%1p%*OG!sbR
z5U0wkr89A2SY^F<JAV^ze{}OqdUb|7qRP8nH?(VaWP(!TB0}86PvNI`=lG9=o<p3n
z1;>t=)SE{Vr)IE(2QY-#Ambz=8bLA03Xm%_sWOg)!RcMC=pSLgBodR*G7wiOji0PP
ze0cH6ZfjXC_axJ&18o#*J5n#{8>s@T1|W-I_muXDVL8(|kYbwrZ#1=+uK=?&o10Hr
zUj61Hbtz`25>OZ70ohWCC)#LtbcPW=n6%>1beprMziXS}S6AIgY<+=~WEPxuO(rTi
zjpCy%?}h(0ixFUijpE)OxIHMZ93o#-AcL4aCqUOfy_%8?sw<cmtm4!3I1d|Ig_|3c
zm1QnF1Y`yPMRXrF;nG8hIKXIz3$ppn80S*uDmnVaQRQN${DHa`<)cNi*XVPQ$s2CZ
zOX3o+Y}KGwuZ`QbwLwe5?grhAUUQ-%Zp@K|8?bB%Mpx+}cNeGNJ=GR0`WjefP>k&f
zu46pM+0}Sn=Fy|g$-M04mYoa0J?_Y~WZ@Hw4cQ)nn=irtYt;jlpG4FaRFByRD_=+4
zO$G;d<usH`d-4FeHAsa78OmggN1OCP2@aj8Vr)>LL$zqljNpG=ivM97dv#D=!AEc}
z5WiOHBjqWvYMn4q2T`3#D#oxo=CyJo@)Hi*(3c_<6s?7cL+pz;Z&cCB)G#j9%5mBw
z5unL>Z+so%O>VYLA)8Zy(4^%cMwsR1hBtUq3dEV93|N<^n7E$A^Z=Kz7Kj$JNOQ{>
zgBGP~rIX7kfJ>#V5AU2T8$$#pcuPG^ls;6U4+uL-NCm1TwuFg@l&Q8Ys8kRVwIHOg
zvewO%H5Q;znl$Owp6cmX6{!vzc2T3Ywm)xHMgll1Im9Lw>V2%M_3DC01Az}osXxKW
z?tA0_>ZMlIodULY{O!OS%3xbPniPt;+SrH(g@wBR_Fac$cdC-w!UC;=e7d~jbQMz4
zQ75j-O}G#6BYWcJ%%9(t1#>+$4qeHkSV8(1f_CC6Zl&nTv9xZ8Cs@x9cP3#I3+gJ8
z2%02}al0NrRqbv1TNzNVk!-6}p89>NL606Auo0%!Ll!Lw4Rv{+H6Lc8BPgTQU4!-F
z$)Z9wSOB9MO>c7w?<Zz<uzwtrXrfnO#j~W|L}?}Jb3}T_X%ta@G@`kHy4r7&=!DYo
z8aG6&bU{L#`|;_Gr)b|S|4fjpee|5&AJTB}&;zx`>(E!oaN;1ag<^ZVDN~r0F#sD(
zLi!~|Hc6}xrm&!D7?>;ZPieR2=q6|$#8#s7+ZrR|j`vv9t^(kl1(g;%Y~yK^Gc350
zfhDBW&5*XzUzc*f%xy<!#9+527ayGrq{El<MWWo64Mzg-@hAuR)(on++;tYk&2c}4
zFJpEMdTNYz-Lw?YB9NlF@X|L9@VTz12Gi?_9l1=oGVerObOIgj3;r*IHkAhZSm$g`
zLrIGV^%nxbd>9`az7wlqm#lv9r#mf7L(KI#`Cr~WYK@+rR=1U7Je+Y`Fltvm%bcvJ
zt=@0+-;|cxmyFGjW%N!ZIqdQPmh-3Df$!czaD7gsqgnIczhD1JadD1snAKF-%E%B5
z!N<?N%zP?NZDCNor+#?<+kU}FG$(%%XJspsQtLls*xZ6hW2;VyLc8m$#<SR+Q{QaV
zX1ZqC2FTo6NzL3%$OI)LznDXbP~WTtNfxw&l}tJSua`NnrInS<Cr_Sy?s@*k#MGb4
zniduovO`C6@QOLnxt_1{{{WZFA$15kg`K<15djq`S1YqQT*^f(97giIkSAt(-S&IV
z3v_=jr+UmHGeHNX*oFDmp%q}cgHxurth(Jm3F*pXrv|BgGX#1z5L59bv(I$Hup39b
zo>NaZrF71ivvm%pA=qNA2X_QemLWLVXh04QA}#ZZ)Y`PsOV4Q#06W)^zCivVcet4^
zS<eJ=)N!U4ExOp36B@oM>N*cyqtvWf_{c523Do=qSXxJg)hiqs-Kk~}zMg%QGwaAB
zDBehl9)f*j74Xj@iWYo968N=Tx)Hc@;BF`FDb>l9l9JA#kS}f-_HE0KBt*V5sSc<<
z@6vZ9Bqs+_g=MU1#wrGs8UDG?ODUb`pEuy0c5<0Pm%v5bdUm5-2Djnz6(tS?=bklZ
zP9Ql<r%RX8ld-2%ZuIr5^WHPaU75g<OV9qhj4#xI(USGNeAZd>=XYCOeCZ!S*=O;2
zaXpEAy}uo`IaX6wIcgOV%1W5D%aRY~hh%eHk>~B(ckXNi@sU;Gp4l1+2CC#2*)+ww
ztgHDvo?d@8l>mFBPXkUR;L(leM!bpbp|5GNZWP3{Md+8iek`_(i;J`8_A^aBi#bFJ
zQ}I!zufQ|25n+>%aPQOL7`Mk1x8js2-KLZfIAwFy@3cLZ=huVwoSMjtHih}NuB<83
zULUycJd^{iZ9Kmv=BwUB506vXPvXr+8N3-zmzg%Q)AmuM!x;W+ao_sNN^JPF_1s)F
za<5C7jl*6Sgo%_%8WSf^{(ie0NXT9(72KhVe%DM({;SKq-80xN?uOl2g*hjrKr89K
zY`+GfNF(jzsy&eyew(%`jm&5#C=yk?q3OPocQQ3Ih8>#rO&e~Y=t<-@my`|lHr?k;
zv84z76*tW5bk5rWdW_KUO<U*8JJ}%fwDtrnT*z4mL?-3|X@Pa>et^_8N<{~P%aTt+
zy}Z0055GkSageR;WO#OtEdY(M{v#eK*`sG4A3t_}!|RU$NNcdZJ@d4ukRQAO;~${c
zMl9N5DA7&<I)o+GeXo+8;%~sU2jVN>|9&>Q$3Nng>=0<ggKrxusc*_jq(@BUN;b@O
zIlnqwc?23|M;6b<6J^IO!6VDT&Muz+Tz~tafeb;$6GtuIv*tzjR~rot2WDns&??LK
zrDCxsv=>t8$~u+EIokC%<&`@EZWfYbr99!@*hAhHGB(oS^t|cQwZ!b(*2X6E4I`8<
ztEv=_7PU0nM;-eHc~BzZL0H-3DdnB;EyfY~03)~82j)%Eg`SuH3A;AZr{)JMV~wtr
ze@^2<Ir1)4ags3^7mFUv0>z6Rb4x})FZ60oMUx6^Zb!;bF|q)o;?s|u;_OToaEKuS
z@axB4grGV-CLks<(hP4O`C-nq2(roGTvs1sxLMoj)8h^vIg-NZpFCxX4bNKM{t0ZX
zxdoK>i>W^jum$G#VWA<5Ido{zhJ6H8M|n;Z*!SrcZ!%2at)X6zDj<f^(*xnyxug)t
z@uRFW2kP}da-;mSA<&*|b7y?v<mF?IWEcA}`i}97PB#=a208n6M8UjMK|g!r0?&3}
z#+at#87f4>*6nrQb{s9e8eC6_$PoDN`f0b6`1ld{-nL^oIGG+t(g^tRKfT({2SBAt
zm9^+n5P_B$z1dy_vk7ma1I7XrBEwqfn-I(w9`-N@6E}A(?xgEO{$y-&YX@tgL@>w`
z*6D1dI0BskhS{jsj!m3%S)OCZ?sEwA1a^AR$u1wXC-0goPTBcIW?!N)m60_WU>7>m
zZ|^n(a-u_m@?G{}(1t7PL9SU^AdwKR57yCwz<{JqHjs`DtvJA1Jn3I(AqII?b`(_+
z0h0Mf=lJI*Sid7%QfN${;$+;g;Rb)|WU+4nhRdR}6ovAH$&-`7Dmee_eU_<D@kpm$
z`*UzqrcpE!6De?p%rm8*qHH0$1EB;lrmyr24o;j{_;5}=H7HVyGMWZ{khIJJ$c3S)
zh`6iE8>DA)1-4Y4$}MQmN-V%DF*y_4Wgy=5w_e(=I&+{Xkx>vFOsoNQOP@Vk&s{sV
zm&nrqszQ(jT5PtSSitaEZr!fdfDj42t)s91Dt2G%G74f<q+{9C&Cl44L==H18N1-Y
zQ7tmBs8O)%58;9!Floj)1j$cIOf*mSLf9=%`2Yx_{ZqnDOz<z{qFGoHY2O_h@NL1K
z3z3m6!5m~+lwhWO$`q5wo>QTO2~5kO7SAPRtW#9#J5QU|)4kZz1tJ0bR+=xqO(Vbo
z5E+ii$DgwwpIIieHW-r0s&U!8!LAh*jZI(2-t$r^eVFNE!q8h&{b(Dibm&GEvIU_=
zW${@054srAC4;mLWITy**x<xB3Y)FC*Iv72%p{bu1T&L{1!2FpQ0iup$l_B{8Z>GY
zJTLA63U$#m3xa2+c0|Kat&J(e7c#9(?Xu)_pFlP}(8&;_Sj{BX4wt;fg5Lm!%5Rir
zcHqFEZQJe}yDUbq(oQDLfIxs9{XF+7C|BDOJ`ntr{!Hxc{w>9|fV?))K;wQvff*X$
zBQ8U3UB9l)I%AGltJ(%<Q^BiBiEYYTau<Et$sHA11q_zOU$S|G0Tn4_u)O$<HE6WJ
z1Z@N)7fq|sCEPQp5L|nn@f4IFNmkxhd;SQ@E5E~ZjN~F&!A1TQ<h5P9T|bHTi|i*)
z4hB>Z@QY3w*@E(oqV{mlZGeKV5?#7({VJ>K?%iVr0%TWX7Lv)jW)`Q&osy03RP&%`
z5bRU5y;^+%&S(NuCcLa?%t-E3Q$RMSQwz7*Ewy}uV1~LI`C2`i*=GokbC6L08}<Bf
zG2|7y`os{D#vhpId+$zDCrqeMltwE|AF51q2lS%D<qzAntDS7y25`G_?b^thRgRWp
zIpxf)%9tPqSuD033lwcNd2(CS@lGhzQE8cb?$N+M&kDSfsvsz{?Y=x~yd(GQ+4E*u
zGTO{uoZ0^{zmLbx6kfV^L&5q#*$^g<FI(NS%LMP(In=$|L7)Gv1?Y#pgzkPj`@6FF
zjoMoZG+JrevJC`kQ0W3rVjtiV-V3NE{s?~{<P~UF3d6X#;%7hn+J;rqrb4!T4N8=O
zkBT#Hv2X*MQ0GCno6nfReneM27U&64IOU(LEM?GXS>S^D1JI3Hn!#G{njbC6t;(Yw
zo}++>DmU&j;de`#E<`59lbCGWe$(lv@ba==GeFzfh|+$V7?;!iQe`*C4TvpiI@b2;
z&<YG=HUq1J=lz4aq3!EV)b-a0umXb6NXT|s!T*40qsu`Gk!3dlc<Cl?ulYljkdv;b
z|C)s!gdRlg$Iq;9C9VY!g{cP*7PZ~fuzvk`&Lcl3dEk6Pp3JWSt8!`1+{nt=F3YL`
zp)dV>TtchFc4_e`1_#;5-+|oe%Xkc!!!vMp9osSc7~+y9na|gd)k5nV=JgLttY0+!
zR63d#DwFjL#;sSh`RRT0%QD%e2U)>86ObBv&neo~y2Z>rAx7E&WTA0PE(3et_??6o
zNd}a<uo=%jt`Yiyojx=#j~Ac$P-MXSAoj=@J_sRkOMnl-={-7gg(NpZEl|o39mK^s
zr*2bC(NfNj6yk{5*{YWR8q}(<Fl6k0lsH1y)bfC?<qdu-x(yi-0LIk&IV_giTd+B3
z!I1Y8HWq~eB2g&G(!64O=VW?eflbB4Ib#@lA6Yw_nwB;T;8x6F5o!i;6vZYFI@$c6
zsWJR6q#aGER!|TNdJN=XRdOoSgrN-S=k|?#q8(W7Xk37JW0Q|@0ilKgv)1%Q0K`l4
zTMoi`m{uV;I@&QQZWG_O6t^8d#T9TBpcgwHAy~epVwjN)T~ocV#LRV$6Q`1|g5<(7
zGwJ3f{V;DokZ&eD6RaZWc*dHGlrDnv5H!?h-YoK$mE=dhUi{TnCGq~0GfTCoLx3K$
zHR6VYm&hW%`eqr<$s;DL0gCU-`~lPCVxr3-{tj9rBjd6(4(Q`@>GHsz4OmuTM5%yR
zLf>f^=7J}Rp9fX?lV?!1->y7(AWN{;<BxE8rIakBR-zo!pr<ZBXgiSXM>+ExN=Onr
z65x8I0owA?@_l~Ss260;2ly=h^yx`2swpmnZxbApvQ53ZF6#QVYl3i>)THbHbK%X(
zP2xaHq$RY$GB%99vA8HCmB)>V%&C+Dt5?9EV%{m!jRf>0B1b{F@rEmE4?_-99e95%
zCu@9QbpuyOsb*R7T6)Lm+z0pXC!9FZ3IVwCjcyeb<FcxQ%H!yia<&o{dMdME&jbnD
z2C#H`2=e|B-;4{i3M8v;$zSTnF%{cX&^p|4=uRg<wjkXKr0NMf>==@e&;>40oPo$0
zZVMM?;qJ2P^M0Ag5_FmfVZ0`erSb%0h(e*~q&kq*lRIP7+TfWDu=k9=CAbfT+-neT
z1{E*E+aCvG0W}z~ZbQ>9Yq&YGBNGHwEJP)8vq=#5JiYv?)pf;28A#wnhk*VXbmr~(
zpwrvG2Vxr5kkS(hN*H=R9=A}nX1|NOD_t^!nQ1pV^inBhJZa8`rHQ}*vZAy&y}gJJ
z#QU3Y=JTz3Iv_DXllg)LhG=06U$m!oP-3wmw^1fUf!Ak&pVBvXc~Bmd%5#Qw%0dDp
zidUo*+bF2w4<58lZIGyhYlI1*anEqSPF!@hIH?1)J7*LzU3Gm;wf@%TiGjy|S0vdK
z7wtjT8B}Y;f+>w7Lir1)!4JAzA$}48zMS$w97fq&%xu1v@K(7k{{k+N;)J3>RCi#2
zU88*H8f3hJ6UnNDyy5OxfymNaic7i?ferayfy4+|v|!Lq79_)BQud9`cB_5`R&f=m
zn3d9fxni;*Pbv%?+32j;0X!aXgYCazt1`X<fAhD}X)OIWcVGBk6dfp9&!pCS2OILN
zs%i^C2etu*egtWl(wLG@u`qHu2_DTkyIH5UchNNnGY2Di%5Ynb&KN3i3RRUkXtKP_
z&CC*R_^^ko{i@}x!d<k&2pkhM3L54zRx#Su&h_Ymxn6%2MD$X8!w2vGATKh00ST9m
zA?Z-|qf<}Ti@m-5dh-Iy&(gsNpw3aJ08d8lmO!W#I)`oUXpL#2gZaZ*Ky#V{+|<ra
zJL<IBdtnn<^MVXw77rL_Y}uvJhXF_-0>Fc)WA%#XJk|sW;NG^OGSxI$-IItUYz_i8
z!O?Lo6Jv~fD`q=S#bB->u@?x*Nyp^LuHCz-M(R-|)K#9MuqRRpP79vdg{A`Q`z!ni
zvV1(?-}>w_|Ge@CTcW|w#o3jMh|_zYb4j5RNNF_)2XxV|YR<>LCX&i2;ytII?JEtC
z3Pb8hmSZotkFm09KqqmPxVRi@tM}0dSn!J!3h)(K+GTiUe%nSOPIOgb&`gwYYZP_E
zw)dQ3PVpU$Z6aNAJQq;s(K0|?$T<<4h>(*ee*ctm{vV9HWKDBhgGW%2T^9daiJWGN
z0cFh3^Od>`i(4&OVuZq^!OqPbZ|&@Q6y6cyFH1{_hH|V%O~xcdv*;+YVLbu7^uL&F
z?a-Ab#o9Xer+ESQYy{5@AyWXR{rT6jnY5I0gJ|t>sCP$Xwz92^E$DC0zpf_taZ^E)
zMIJ(@DmzWNUn;}40J2gI$Vw*IAyuE@HuGoC{yaVDbQ^Vb@sQ&@vQ;nv*hR=eTGU2t
zvZKy9Q1DswPm&q;4(mW#Tk^3kOTR~tO|VU_;A$>ID~a8lm9`Hv@d8-*<s*Mp=s9xl
z*Da*C!v(X4w+Y@0>q%qV%IS2`Wj1?42A@S3K7V+Ro;~ZcK9QITss-U10a$pM?8+pP
z8GsrU^zNEvmKozn(81KgBoj`vAOl?E*+5Xjn&@qSMWOd3=1Bc1{Wl2doK`Kyiok+;
zFYD$_RnoXDA!1mCUdzgJK!83U-U5jwJ%Z4W>2I$Ub!19LX5gs7KM+^EKk9cfUyg=C
zwc&;?8F~3xe=_O8&{WMKW0iq=!-i?me#>H*qGK*w2)d0KKM)cD!J+f?mh%6D&K6CP
zsGwzu<<2qlHpLzr#e45T{Fu$`2}$RqsYmPS>_ot^q8{siofUO(gldc`a1$8v{*W^p
z{C7Qa8o0IRu}@p{Ffb6U3zEECVlj<MU$=a1q7PNEz1=1A*l$pUHTa5%Uh4X&Pb10G
z&{NZry}r@)V4JWLoi)qGm1#I{8!H%|Ng^A_zPc5*H!Mf~-8yTes%7H<wW-vajo5rf
z!F*{^92lw@#rd=+vIodH1yn0q+5V3vEn4KlM7aN}xrm__0dEZBc?-D*0tP~mGBEFe
zc>(k+0c{mbCgK*vNV#0}2AL(`b_v`*VIIAgxZ~V*FMeg&`akN)aiq}_M)%fBbFMH&
z1DZ5h1B7}!h@;Tt$nz~=2Q(JKrcnM_7<gr9uoM)ov92=qnNVtMXGSX~VUc`5bny=h
zQ>6pi8WrW>_fAd%>$gg#EX9J1w3zO+s@{UlWCv_uL_>ny)WZ4P$I&y<BD8cmb79ui
zjXr-yIgl~=CCDw){NC|O!dJK9x^Cq3k-bNi=Z_TP2&LQC=R2whuS6tPg%)o4>NsIS
zHVy7a^dayqRNP1!3-;`Zzlw56mc4_HoJ$(80J#v;u*UQwV?EXRD_!U(pkK`?nkfen
zddUwsmvqXoX~TM)RD<5VB|b05AyjN7DxK=zhW`n|C5nG5mVU}_ea8hOc6bh{D!e>~
z17OlNp2?Grf&2;IL$Frvw8h$U&%9WUg{k+C^-O{Kejbcc)Cx`4Di06gD5)=GZ9Kg>
zku?x}S*`WG=M*+@vJfJ=V$?*b%NZ2md8Jzh^k_C(E9r4PWBz<w0vy6Ny{X0pw1t#C
zq8|m|FIja5&=NXHrCYZH%Q9a*#RY~M;>F9Cr8``F{R#8Tzz3i$DZGE*C+}GPE78V)
zkBh}23ea)DmUOE&qgOVfN93226`2W9p);gtt)85RPb<`=$A%86p$ZFG1^C~=hPerX
zi6_fvF4Aha;SUDT{a0`7BDIIR8L(gx;Y`YW^x#+V;NetT*sD)EHY1#`G#e8d5SxI9
z-jV;aPZUf?isa^<hK5jO(v39Eu=~Q32Di%v8gwpptG-6RC3+=LtDo=Y1BFshG?ZqA
z{H$YW*qCBh=y;;FNRY^f{#Q#;%#4WtYf#7LR1ji=i(p)J)%&73C~NI_t|$#J7fo<<
zlm)Famc?TNYP^hGkYQLARaH?;wO1eRpdJLM=t^vHE&k&s%s<r`5wrI2n$}8`BE644
zh?MGjQV47&^$i<^L4ti(R~{(K=Ut`0Up>kgDHh}xlUtI5(5(qdK(QhdyIfF;rKV%_
zPu})W=(jKXT#Xo9i&41E5Of7v2kcpoE908P$KI2wOpx#Wr<x%q$xrLpJb3d44OyK_
zaV~01$Qcp-QG47gJG$2Ltt_eMq?&<_0|@+J{zQssP;4HqHDE1N=ZK^8Lj)S-w>AY;
zyWpn)Lb!dGJtQ*D5qs_L11TvYO_4awB<w~i0Udbn%&Bf<a;vRQ8Mq%v&2jW7Ag~HU
zBlSgR%tls|_D5*Ig{<NU-qlLE-GQTCSNCff*4dqyL2A9gxB#V2){PsDp)jv7=#W``
z0f|&8+>^+4$pX7il>;Cual0i7Q6-4ThC9`=Q>R|XJ2?Img#?A^m^J`6KT3l;vyON*
z1FG^oB0be=&%j8Pk%vV-K`VmjG<N7|a=XOvKC=Q;TH9*S7pim+h{L?+bWl9JdrFFj
zeQC}63e8;p+emP17e-thr%v7E;#=K-nrq2I^@)TNLQFVL2Bp9%^cHR>?(Iz-=3Ar5
zM-(2Fv21Rk2utJQ!hu9^d)c39mqAd?`NevA4JxPg$R>RmApfJTVcA>92Qe^nz8?p1
zn*g=xzr{+B5?sJc7yy=JH{@c-Yb0X|y1RC5wdYIMKAKXabG`fe*8I@7jyvN)V8huV
zwJO<Q6v<pzGi16%nuLP~!-$n-u*3V>1bnLYmZ5sWzH6;#0nDlxT$7WGopsltm+*hr
zpP8tJvtLk<A4fF7(#_;6?wrMD*M>5ul|=s=f`>EXDY{#G9<f4-11pcVHXo-<91dyE
zy)QFw2*w`>Xukna^v<1ehr`~ftRuEQ<M)VwS3qsRQ=pTX+^$vD)sj3=&d4JZ*)Th*
zX-m&ClUZEge1v)hIfCqGrQnkly`q;vY9)?TtM=+B)f{X6f_y@-Ravy?ZNs>ydf~is
z%3P_^A=|va&sQmX`=4q_G>Td&kI+OdN2WD$(@k=4FadyVaF?%NR}rTlU|-SK^M|s_
zV5`#rhI<;akpQ<UWg`61&fUh>RIS_@9NY-iukKNUa|1CSlaO2Y^KI`7Uf;**7K>l*
z7J5}zge9a3zms`Y=x>09kYZ$}ji|lE(F_K+gQIOEN-Spd<v_rY8haf%y_nlYC%gfI
zfLQH7S0#TPuIt|J*&xJnmE(^bX-2^V1u}BWdG=DmuE@Y)%Wg3piSpFZYTZBnDB8k8
z-{B<Xnbgq7ProL){$S$-$_t~dUnOLlPur?&e?<@z>P_aaZ~Xb$tcF?-siAZuysd5;
zUB?YK?A=>zgs3qEtLIb|DGqZEWF;S3Kj{pK(bU?2O#{7TS}Wn)Ip>+i-E0DoP>bO1
zb|?F^{rejdVt~VClQ9*-RmLO4Ly_r_1VAAQ`1-N8N8(epsn-wD2=K$C^hY*sQ+}9<
zs6nzD!rUlvAiK**CNi+lutB(D5-1YBf~;|ppKE^W(?uvPc$$qoE@REPLX-Jxgw(~t
zk0C?({>UBp?Q1*DrVU{dM3I6%Xp;8eY%_F^;2BR6SN7=M9SJ}KpeE?&E7ZOS;N+W9
zk>X+&NKbP)J3IMCxn99)V3Nxqiku0Je=4VNWf95|#N(W{6ukw&1|3Bv(S-FwOxSm#
z=1{Kc^t8yz+FD*>>X9SN3^xRjS5n%&d$*)8POSK#?RIQcmdK&NHXs1I98#F9iu6p@
zxOeZ~RnQf|Oeqt?zW%yiG=h)qSM#xvG#Q{p=bjI^1xi`KT_hMM*QHZ@K$Z*Hg<Q;^
z5)inQOV$hokJZTG*Rr#|;#3YOkCB{Ug}htk;Hzc;8?PhuCyA^N4)yo4SA%TD0s2H*
znERfs2cj3c`C?~TnX7y=G-xAHR3sUP`fj3NlG`gofgos8Gd9wWa^{!g^Gpj_Pn7)-
z6S|ciJDURtqRnwazCo0$i0Hb#RqNI{uZG~YR4h0zG-eipZUp$vmc}=%GoCR6DB0)d
zmjuI<ABPy0VAkt(gjt5`zda+?uA4Xp{!ec&1jK<rJhpn&Z--4A3uYC&0>X;hIRQcB
zp5QOp)WNeDIidPQpqRysa^<M6WHV7y5d)r6U61uG_?TulfbLqL8v<w_dIic)61VTY
z8NdwGb27^TyWhgBuDvVc9p@i4NK^p-m=H}U)T9fg?i;k?g$gnNcj#Ho_U#j;Nkn~*
zXJ5hLUdM!_3=bC&S5TS4JFTK_0swLydHt>4n5tU=qxiaabml5>m^Sgtl2TJgrLN7)
zrPg2mw#bMdS>$H}0om=iasf3{z?GRwKU^l;`S~eEUfR=(4$;c~Yfge-=pMQ|<3Ik^
z-0|W3K6}MbLKT7Y;rt_Y2M#lcWfRYy)%+I<*@)H#7+daq7llS(@~7|Lt*1=c<y7*e
z^zGXwz!)<8Lh#nd(?CXEIKNOMXl4JPM>O5w-7PFp8fclsC@RvBmd4R>(Q-;_0fbO9
z7Vg*YsOD0{4V9<>I=YcrQ@bHIH-#Z$<DkMVvzY!~)oxWY?>IEn6rC`WpB~Loa=$jS
z4^lgKRNT~74A`hrxXG+J!y6QMfsFgfLbA$K^NEg*^_mCQYu2n8Wz#d-dh{zBIFrQ%
z*>cdN0iya{G0beUfFa0X1kUnb-MW^KBO^%we&X(co~Y*NS6@Y~Cq5$-w(Y3#mwX&T
zK;<==(`o~`&73o*KFui|vCrhpqIc+hl{Q?tO!rU`p|c(K6VYJz<0GdAXmct^e!}r0
zB^3;4?{L2viq8b2elzNNTn|}m{_wXj+f{_wl(!&)F_()9^Ycf*wB6XbmcX5O-`>t{
z1kGJLlOI|b7y6?KlI_xhQy05i$~zPuMl{u+s+`7rtu%i!>vLkLgqjHxCS<Owp}C~F
z<(-SR3-}?6nc_<iL-#|uP-;k9d#mNKEF4a{9?u%2^gmN2RQUM1sT1xX>)KEg$VMJ?
zgcejNG>agPE=IaFg@fO6htSSyINd2qM2(8DR(+lQ2%J4QB$-aysx?(jZXuK9!>N2(
ztLG+T0Ni<`qfG$#fI%4EXfj9kB}n*ElFLV-`{%kR{C<1hDlj|ga?||=wN*mK2#Z8b
zBcFp34UjZ;Xy(5nK^cglF(jC^P<jZ@%8e7#v*FHlCD4zNv9X&#*AwbY178?+@16xX
z4H#5#-g6njv^)3|ENM3Nsq>TDA-!migxnR`5l0M-!RJH9YHHzL2nQE0UQF53Q0C&M
z^*VE7oGf+_OkPIuP#K2|GVF2`G%=V7s%O%n0Vv7-Xu>*#M-EjQUqa;hcT=1~s1-#f
zPRc@b7*si^<Q>TjRl!`Jaxgh$vlo6YO;}PoGEc@|{*}81P%Gf2H|p9AzYT(pq1MG7
zl(qDA7MjJDKyyuSl0?T@hNM8bV#tk|eLir)%cxJs`erU`j#Ucx0|={>Pa=bYd_17_
zOt1GvQd&vTC5i?Lf_qxlJ=trLc;bXZ&tu(i%P(cBG)toC%$e)S4x+AHgO`$_TCM8;
zsjv?NZfDk6_-lhen~fj8<v$iZA|OE7AS??|lexQeG>ct;#;Chcu~<@BFf1g0zz^qa
z#Z``KCK^oiFH-n2ZdY)4rOB$->*ebbr1@L9$OOQ`!}!F;L)Q6<K)~yJFSK9z`nl?F
zU%!4v{5S9MjxbbjQx44eRsIb?Mt$lMk@n*`XO4m}f#VOONk@#)%Zrl(`4qwgNv}bn
zu3<aQ=GC)jN}aZJE4);XmgVbhKT~c$yv#<1{hk5&nBV$xkrn`1fc@|jSa4LGESPMR
zLcylQa~vO?;{rn_{5ozn-Sazit@r{kLEkF=R}5348>W!wA2*BmRoIwYuf|V@))#V4
zlo$kZZIq9)3IwD$+DmqaQ9rdR?i;Sw947|h=lLdyCbrR3ege=^VHIelSp7Exw_`^z
z*4sj<2jNJ|6S4Lj5c-k-$$M!5^DhF@*w}w2=V2&WADZOC+Rrjm91s(z3l1e@3oEhL
z^D_r(UNTxhAXyG^U|?V%IGI7$;82C^-=S%3L5xG}dr#|t4XJ{@B^a1ecE@6n`=zR+
zGxZQ0=Z2J&xv@W*x=?S!c1pP{cslMdE&hyc#uY!8WD^KMF`KK+h+`v$s76Yl=EP(k
zigkmcCqdacJO4L<=Kt~?9k6KkX-9?CnIk4YtO6^AUy_@P+J;%ysNPRsJl#&GWr2Pf
zRw>>j>|xlJEy47TvdsrILNkaEP-VFZsDycr`6PMGcI^tZ#x6!E))InlPWI6Mq0Si*
z|8wy}CDft`7tH$f>-XOj?V)=B5=t_W;#R!RCgp#$0ONFaiOnN(b<gP_WkYYVdtfDB
zvQPj1;=H7WRGQM0aSmCfA>vf9&J7nY`fPe2J|YrOxHe2Pp;}g_?x)cchDs@(0E;jK
z8gcQ-u8+_#eSq5>>RaRV+RKA_8fFDi&cWWAFF&r4`UB>p6uEtyHrpCD5P@|AC1`co
zi6H<K@J-O(iBZC15^mv)qU?%#_vmpI8bi8C?57fF0Kz+UBbT9OplmcpSV2;xQEWha
z78o^JjmIvm4_2gF%*^rql&4VFC&2c}OOMV)eo%&v|H!MX9|Rp)($2t-@oP8y+%^GV
z65NHZr?}im-HN}N1Q;Hg<Q~{#zBPB~p7HzKnSBJeCe{pC&O|rxyesV!lOPEu<C4T)
z6qOB4->7Nd^A#dr1QkMQBhLog7nDn}Pcpu>0a+D!4)RW@5e8iqx67CQbGjLrdjQlS
zm2A+?sI9vEJ2`}cgvhWf%-JgIh3UMjE)1;#)(3KZE<cTJxo_&ZRfY^(l$Mq0tWG*}
z^5jW`Ce5gK;mHnVPJPXHIu7ZCiM$MZR_-+a4(xoGrLr^vqE%<@bqJ0JBPLGVR_WF%
zmns<YDTjTRAe)Je&z(CbdT4l-0J;ITNQ)A=#M_tjD?^{WA|Qv61`SpM<2#+4*9>f*
za<cx3{WJ*s$M1`v$eB$cAp!#w{-rQ*3@H1*>k>*TPe<rZU-l~YSj!BtI}E@UqquKo
zD(IF#`|>-Pq(h7rRngkzLq*=O3P6--^{@Me2k}nuW?S0EZ&2KxJxVoIo>8lKUMkI+
z9Z|&Twpr^N+Rc5fFD*}2K|xDDMXfOhw0>qCotzNz%%MgaZ`0B3m3OS_{(nMRnU4cl
z;!~%0Xx*z)fI5I=8Qv8XjXTo|3JB0ebI@{aj$HOp?LRq<@U=U!siSP@mVXMiL0-Se
zkQhg}#-^$d*f?v0uaFxoI3^9w?Mq(sy;2L&ZUAkZE6ZFn=8K;@+foV7VIZ>*{Mg&G
zw5p@*Y(#J->ov*6fYbTAC-0&0OyJxLgKBlcg@6Q3^Z}uEL&dKO1==_nNB|751}G6p
z3da4Ba~7qMDE}C7^1OyIYv5aQ9G0%QFc6uMy?tc1&tHq6mL9pCp#-X_`&A{OAHihX
zCQW6i4pkrI9P6bO=S@uGpoOTc#2~4`W37!_$I$xY))2(R93QeG;$AY3_c@P34pnl>
z)bS+^8RDZFnTa!_Ft|X-*B}0)pcl=dHi7r>n+c+iQlQ?3D{kM0bRO;-$ni(gCFHOh
z_(~U}E@`y25G?7)f@M(+ioi)|K<WF078I2bF&0L%JI5W%L=}3c#M){HL>=7e`Y7jd
z?4i^Qpq}@w{W`hk!_^jFbGPl-k%WEILx#x#X57Z~97@E14v^*$g;Nt8Byl{gj|z2_
zb+j8705!~2TA_*vb8jmebNNX~Yh+-D)c3RO*F3%_+3`8j3=00%ZvvZx#8LsNtE*Ff
zkA3!FB5nS0*2&6bDfOs0=J1=HzwEV-GMaHg6TW;T1&CqHqAbEUpK-Wo?}jUC`WL%r
zzHxj?-j@?WpBzA1E>6!LhYkSsW;nwgU{!au4vbyc`m0N!A5fb^_|Tq_fLn%G*PolM
zQeUb2fB`X;nkC^wFJ(uc9eSy0vu0^zWR)eg5SWfisX*+Fm$WEbS@x;s=Zqs2UpHxo
z6s26aut#~sbeumb4O%gW=181Q5@|WK%(>?()9208zmGuiCaxcR3aw&yQ%45}bHg4z
z9AR80j2#=E|E>DR$F9Fs(pFYM$|J%t!m)*ReC!(~VdgRRg~feM9T^{_z_b@>GcZaj
zUlWzP81fK7VnDdI;p29{sOYZNw$+eA36K|~E(&ODpl)SfNR@1$^kUznZ+VoJ9cny%
zLH6g)nq}5kb93*#L>v=LK5d@modhHNEgP@v?B&_1`O7**i<-ejZuWPN#%RnjEbH2>
zTcrIQx31eV3=7IKA~H0WjEqeVzngg5LB~jQRq_M}_0XGXcHKQPuHUKs_1ycj$>>c3
z`hWlXi|@3_4?K?k{p48rpo6=9`4%60Kr{Tqcd>a5BOIFvMTx&<B%iDZ(jZytZCF_B
zsqViPw0R)TGa`|uHczJX81JbY`2nTCLhSG+U>XQancCU(DQ_o@0Ax>~Pu^?lb2B(F
zQ1|2a?+3t=+F+9G8PnOp-rj6iY^)>N+5I%@qdhx@qSa56r^v{CMj`SAQ~tn^t6@8C
zT*Qjy%j4;p?>~I_Bc~jI%Z}KU)x^+JhT+7;n9m!=ikbFbg}CZ!vza#A4q&&CB*?)Z
zU;!kM^KykDRnpDu>_F5HzurA>-=RYqOD<VGaVil!B`E4hMn(*x_(LOp)gv+){24oz
zM%*4DNvqoG(h|OhEn9UQDQx$fgpGoeJV2S4D$|`w17z8zUXLE58LD%n&L{+MNTu>P
zH#>9>eVeM12cXWmq?!!hjdi_m{55fxwn{qNxr2#qvxp+fhlHL4IxQo#C?AqZA+;>Q
zMy}twl_Y7;z*Wz{K!r~OJ`$2$5>9w*Mzw|&k4U|BjBPGbh?9ZM;S0oS!~f_si0>fO
z7orQta0ZkB@FO6{wUnY;`B0CWumeonT6k_&*x>*HVkt@^5FRku=HNBbt_tdhK2Btb
zJYLE9oN5qkyBRaad9F%WxoVXqw`J6kl@IRTRkpH!v7>$sD*M_zMG0pn?`Vu-&(ELh
zXuy`4R(eUh$b~z+s~fCP5D<YlRf=+e7;znq7<><0gL1Kb{rz-{3^iTDvN;0GCF}BK
znO?hp|NbiLq_GHF1Xu)pE2TT%iM2tC&W`r>Et$)b4S6({<dY7jx_Y|5t-r7mlo_et
z)v&wsVfx<xB<nMo2q#~0QUqH^{4+hZwIz~X^kblzjS->2SBp;#oQUjoL=A9h$bzTv
zT70CsqhIeO9))HT8{#3W3}pWg!yf=M2?PV8t|p`MV($lxKAI||9WV#<IlhjeY{c9D
zJqF37V$Bo0$;7mfA}rv>996xk+<J6)jb)$!CmiK8QSKw>r{M-Mo=LU^6?pN_LN9yK
ze4zQv!fU9~K*tEY4g}N+c@0!SPk1++0M=7l!dZqAjzD1RQ=KH5>>kyn2UBX=&6rXP
z31o0@eU58m?}3%H;?igM7l~#>WtO0^2$08mHcbaN5yM5Xm!eWnG>I5ddvWj=;60rO
z9aWWR21Z~Ui5YFs3fDzQVFgdX#6o^A_zY#rEFJ>KM(iyw_YY}hzeKIpn2<@(&!SqT
z{H15GMwtXY-ChW78aXk-AX8xZxgHy^Qs_--kc$f%93^=(x@*mRRI$BE;|KZqN?=vo
z0Ya^!T)B7$|5vv5RIL@D0!D=*=2Pv%z%{AIj^%PkW^oDds4LJa--L-`I6n<(;^f3h
zxBPCv^@yztlW$Ug{|}jx9@q<{2R2ZMD$r+Y)aupmU^{gvLnPbdiHnf`$7-S`x1=do
zIR^ks41Z*noK(kE5!ZPcqol}LWgRsLnBd`=Wu4grzMc&4U&PXeVD8j}i4$XYfBhE{
z6hMV>)_Gd8@m?Ap_MG<0zmUa*XXEC<8-UaW+h>eq1W4MKFJHi(-G#}9N2bddIPjTT
z;&`-Sm}LVPqtpy$oPb(DN$Kg+r!a6Mh*M5Ix7)2G_6qn6Bd9!V-=9q8at<Z>P~QZ>
z2$6&J4w}_fp(c{qJUS>dqA(P-5i~Luf{7+0Px7%jsDE%@8+@1??Ey^+{w_c<Q9pl=
z-Kwn(?aeiH6`R$~)O31N_0#<P)_pFj1q(&T)5ywR`Iy!3SjRwtxqj{dM<1VIl-<qI
zT%w%<K8ZIS7~Eb{Q=5N{!{&aIyMDaNMly*<k5s*`pk_2m)6M)RCh~<mq3cE~a2D@P
z=}joII3U7@VYKyZt))LY?N0c2gVPhTrxJk}wQa$PL~7Gf<~al|!&HTSLU2-4HrFVM
zq_CzgRLs693k6>LHuf%m@j`}LpOLyjjdU@;J%*2h?3b`p7Y|*cwvavK9|?9D8DHk_
zyEU_qV8fa7d7uKi@v=*{j13WCoXqF)jTCP(`ko^dsWJt);GDs?{<LNOAXSw1B0ane
z(#@nWA9j^>>$7|VQPPT83un$9RjmJ$`uFL(QGLJ=TzUF*#^I;8S_Yh9##p9E_=MLe
zIsO-2Zywfj-najU7`r6vh{~3I%a*+&TlTS=C`-u}!cdAzS&A@&LR5;z7R?}|Y{_z2
zl4NV5EXi21Myc=PG}ryRf5-7XzV{#Zao^XK`h4E+*Xy~Q&+|N=xxr~pumXf?Qc3+6
z(<cblhnlM2$CtW*r`P2SXLQz94wX!47eL;E1QIQuko#Pw5saaMP@cMtnTiPzGEqj@
zHaJ$$_fsX8p|1yqh^HscVK!!*I;p55gUC`$tAGzk3nED)KLAgV0C)a^1rbfQvUF1<
z<mp#TR(3I^@XP^s6V6X?Q5pa2SyT517qGak%6iJgArH4sqbeaT*9t3_N(sp+JbV56
zp%<UI1ybybK}cxw;n9)cU57NU*P><1Qbiw&x0)IHTS<{}3c>z4<b0Mj{^FUe)(Ar#
z_y7MW26o;Y9^O!gAK09Z{g$cyl;XeZ^9x&UTCyuTCdL_t3>VC%`<LT**<hgcBY(5t
zMg{<wEYFy!DfIsRcLO3mu=l3iuytJ4;f{_Qm>eWTde)}>;9Y6RO?fJ19Ihu75jGR?
zK_wpX@W5dFcr;9{CFO*fsU7AVxgWsem^)FWr48)r-U-qqo+x+b)F}O4Jqe;mvS+!i
zSN-|7@W9t*tthMl0JaVPYN`fFov?L+F<zMpN(~Tz0b!|N*ZzOmSxtL??!BKnK#!4n
z&W7z|xxw%I(X90K^y~qz&n{ujPs3R`77XVJ5JEl;907eIYOKsu!)$s9ne9PsoB#EL
zE70J|p+T=Q4mX5Z$#p1;jTl7k@&{^}uOKQ0NQwq@Pu&vPedxO8mX>BTJ=%23=u3D!
zr*j9pH*A4SW_J#2n*uA%CA5|`y#DxE=@p?Uz;`>l#G%r+O<-c#aG#vI{nQz^vj2M9
zU}=LxfdDcvcuwYDz_RB#!We*V%w5=HQ!M;_(R`_jWRMg=6o&v7)p`SufXExn*bXP^
zk(QnCxYLLnz!e>s4V)6FV*3sqsx`=~FDk0~_}{^`z7zhgW7=marcoV!H<7y4N|N!;
zo%_>7m*f|MRsuUAOA#lEajgsxLPxGG*P-tgql$TsJhOc_ivAp@YL{teZt&UK2K#{L
z5}b?Ly?fszG`Hvrl~{zqa4IyL{bMIi986s`lF5k8e*29{NNUae&Zee@gyMCZ+1~DF
zoQSAL?aLY(Vsy5fwC6xm6GAqK;7Ys*em|bv8z}|yy$26QG4`?9zkSmtn^L>UPd5*w
z%tX>eR>xZ-%96Qk9st~EFR#-+qbfQApCGUuW~%)XmaRA8CaLzRRjqZ5ZVI2}T)lE-
zABFcQXg5b$b}H>^sokoTxn`p{W_y8|`(!41g`w)Kd9LN7hRndmPn?)$>iaG~AFqvg
zhLvvzGUhAmLqWN>`<0pQCnv>{XRdvHKWsoSecUYg;wGCfM{yzf9zSuEZxc>l1e+TJ
z09&@%I`|KkR@}OIQ$0gwNI{F%t%Ia?-MeQ`UzV9y_+v4JWI7JVvyi)5l+0XZlnC^p
z9>VF^J*IS+0(aU%H;=iF9Znh~qHIXg!%>~0n{`cn|9fogK7=<{@MwfvvIQ(uy$ffh
zSF>+}fyMV@b6ft&-BsAg4I#n@>4&JuJkWb4H2Q`l^{A!6Xc(bDw6*S@T-YpmN;^wT
z(bbYdkJtlh@YCeU4ilsK8|t+vcWchdR4X{C&DL4ex#?izExL9cH~Yr;I~f_HD4uU4
znq)3e3nRX#PoCH<SwCa{;lnX{@(^{sKe|&~MoMi>T`&Rwv*t+aRN0hP^trop!*7jy
z+m_VcF6qZX!04>_i=*U`^It;Vp4;Ee;-;F_uuD1!F@d7DAgiP}fbuMrsK|F=x+wV&
z5MAIC(-<ms&FP5sMzv}+y}5r-IM;m&;Sw^VXmZDPb%cv8sUMJ(%6<Y9wN>?c^;(P=
zb(mAK8}mnsUSy7e#3t2BbfB{B58K=a2pt(%8J-nGk_OP+&VfWR0k1-Ml=}%@)!OAj
z3dAm|3XE`oZHRAc-niBNa+y(Nj|SDG2J2q2Z}}kJFLW(mAcRy?e<KUV0Yzxjx_TBI
z88B>HH@2uigo0AfMADchDs+tBCrVTXWXxn&+Z{-$T%m#%JJR~k&$(Cy*sH=HiLm_`
zRj;Iss5ED7P4n*tBEr-d#mEsY#kD;RD20~v1&sfaSU{B-(s(UHLt+6=5W#?&GkU)v
zMv1`1%`Au8sPt_Ru9klN&>T_>>8|XiC3FK!32J}&HJ&z)Jj8l$gF}u<VwMq;k^5|T
z?b3TM*X=yMYu_8ziupTfM=J3x$-Q0XtkQB7DT%n*F#fmyHi;z?5~Yf;g;ak}`kb`r
zDjY;|1MioJRf@S6Fm;92Ws(4DviaR$Uy<F{Ug9#Gqf59j<FqI65{)wpBTCX!s$h;r
zYPH8qMLOnRe{B-w7qJ&w8I_sw>5sv?8@fs|*O?PJz`-GzX|&&jCG77#!FIFZZW50A
zneAtMf5HE!z7tp;r$UdcSZS|$NL4w>0d2o{HrzmpEx8&&iNu0&sAVU#z#FIpH6hCS
zHVL;voZA{P;!{F^hD18m_H)mIw|xy<{VA2l&i>J^l=zJJXZNLj!2mm{@Qb%&mxlD`
zd;w{d84t>O0#PU;;_}d4XakC$=eKoCG&%G8*A+x2wO^_}5+aTKZX)3!L--!pUb2Qu
zA(bxx(3cyb)+202n23JOX%!@DY9FNu6jLfmG@0U~@AN0F#!dP>0b46A8s>yb*a&6|
zuhVXDEv<rsdn$qkwTsK;K7ogX-O)+^cYxX#T~Fcd#@6ijV3oE7c37_m7*FT=OKZpe
zo_FafxH8BZkOL?-3XCbZ?=rk3+Q4pE8NOt@wMPr)?7<Ww<>QAA9$_Lpk`pePFt#T0
zvH)4gOkJ^zD4)XL&&M*4Z+>kNw2fBdju?>5&r`&eD*9vBGB9X|E)CRfz`LYxGFg^L
zf6#|HH5N(Lm!%~TJ$YK{z`%Ndh|iLqDRXVErH-UX;&8*`wkN1UdwIu|9Ki*ksu$+M
z1}rI>u@srt>rXIIj!p|giD(H-L@Jr@aluXIJLuTHe1&G)$M%PAUWqRtccRtR8n(He
zkW}=p5|HMAMpeLE%-dfwOg(&x=0R3BU=+Int5F06GA6)|*H{dOprD%fp4~*oq4HIf
zQ<|}6TS9RbJ5TczH|1<;Fqz{8UD3hux%vT3$iJNpZ)(`n(njqYRobxcLr$E}<!RZV
zzY^EN`~Pa2f+Yo>C|`Sr_JPCfj}b>1fYpn%J50>bAy(tfvxcZ9`Ay-KQ{>D0dYI(h
z@Z-mip36M0fdvLYAJL@6>E1M3qt?^0G{wX_!P&^>?Tf4_ob-@+N3emq0Oa=Q<x7x>
zkWN$283Oa3!S_+_wWz!xO!ZlEU`ER}Z7%W!tHTt67Xdl`)`~`<5bsFbJ`7S;96P(N
z;0vB>(!AJWqDG-Ph=aHJ*IyZ(HpY0hQmu9VaEt`SG4q)Uqgt!E>19gZf277b%bbQ%
zHianz58(%OEhZ)qZ6pz}xf%<%8M3r27Z1)@IDOi*Dg0x4g;nS>_!VF&IBX4DVpZDv
zbctGIExZ%X!lyG}J`G6)uf(st9mnEE!SP1E=#CK+Bdo{R1le5Urnsr&Bl6r$^g1=%
z%{v0N7Oe#ACJUsS1YxFs#$SGXaGZTtR2$3{*UCGPW*0oYblCN4^GM0bOqN2w6@Xa6
zF|Q=KC_!9Mf2rsiJsIO#EO!XN!%9vO6DA>zWSk$r!?Fa=`Opq(di@$pZwzEU!1m_M
z+Zh@1>!Og+yfM?=&;r^R7^@%Nnq2;yu|KuM4Py*FKQWmqTpm^N3Dlr2vu9u6<b7H2
z7xWt+x?pA~Tt8a^3bjocQeY3yf{krE`8j|JK(Mkn-RpEWWEnCoV7qKhSqf)u$inGd
z^fVCzKp);hbYquEX(H1FX4>dk0{~299issfHZxcWmO+>+i!w2!kuzp3{FX@znU4zn
z-S~il{ft8uIjOp7kqxPot0Lo36^zm1fF(N)&vJ1wz(H(F^HE}}z%sMq&eJTY008)+
zZQ|wwMqqw077m5%Dk#cM{PI3}z`<V-MKy)SSE_T^x3tNln<QRSQyN@fc7OlcFUN0V
z6b1vJGPj0L(x_Xv?Sw%!ZTbTA9Y5d;O6?6JN-KKX;VjD(>+bBuY4O7eE@((59JTJ&
z&Adg6LAhO?dGYEhF!GS6C)0bmpfbVxK8;QdOd@j0+m$icaEi7i^|M>jDSkcZu!W3z
z0zX*+mXN`rojdHi7D9Kg$o=TmE4t9R<qy72!Vblvd-oqveG406P*L63*y6+G=xh1!
zo(`4|9QI>2r_c7;!NytiMQdNzxweTv3B>Nb@N`kqWxNi$cCEuN)9w?5`re^#KT{QO
z@Qk|NQc>4hu6uiI1Du{*3b8qS5HBG~Mx&!Ep6)E9xx9{e-piNypI%LbOj4f?6dl(T
zB5wTTc%vwgO%N=$cpH)+s}uaBkK}p7NpN_%+wU>qU*tY^E9fRCHaLZ2g~s9(L41)_
zBBbCi0(60!is!*5nn)S=z<&tcTy#Rp2S6w;eZNJE;?KPFpu-gxi&1x2(||FfM@MX(
zb^3p}0FU?@<te&Q)ly_Y`Z2_4;X__}CH}uUy*#_3(UIvdHA?=RiXS$b+v;GEECbu7
zG%D{t#mQ+E0Q;s+?~Ui8tssZ>oi;7%(&5R_VvH(QssuHk`dQAuD(AqvrgDowJ#B#g
zGUIx+1Pdf#$`5PUumHx5nIXl}XmCieC+OqiVwve)zWRIDO)jWe$frVDm;)(8C>nAM
zRb_DoACGeWF4zjLzlO493co^bgS09C@;HJ}Yowai#6L+o^H){Q{lDtFJCiPKr7x~V
zib|&Q&1JgRmrsEh;89M_`)ki`4g*kF3n_xeMXWr?!U*n55B*xwdUAq^Og)efsQuiN
z{;do36s`yn+*g@Aa*RMP*20Iq-@)rTJU3|*;B?AC-7}&2o%{DgUt3;dV&cm;K+k`q
z-;J5a?kSLnHx9clu&9b(QJ*nLy!zCW#4AB_b|5@bZ~SyX+!V0=p%cA8n^!$*MvgZy
zb9+|ul!{WD!I+meS@4G^a1jWA@KXTs3DYuuC8ElsT{8nF34ZtYodO0&2PC7d(!a}c
zkyyuIlYxFY<hs1NRnSquU=7D?4X0|xL#x#%w`aZY@i&<LSD><<(8lEI)vG1W3v!|R
zVYR#-#7}V-aKI-qk<aTHNV0Q+fh-D=0By#){1xdAD4+;tg|7!zW1^hGoEa!AH9JF)
z1%km6lV(#Y<Tu021Uzd;&*i_pw)FFni5TPwJt%Iu`c`@+30Wu+n!NiKW5!iJLt;b;
z)|U+cQ%PMPUJP@T$e-CXs=P7^&oJe+v|ctC#C>w1pkGRXgd8J_8T19Rd#0jjap&4U
zRNA5qAzEQD0w&deN#i(PQFlc>$}*)6ki9q-H9+ZF|H*YvcqDNel#MfUb7WFnTy?lZ
z{Rspz$Hf^!5>$d({1fxg!z6LlArRUjT4Z;mf@{xY5b{X8%a1o>Tq7WvvTU3!PLabq
zKa--LAxr^dRfN)w-!99#73XYEZ<b9c7Dt;m1>*c&$7Q9OhQGTS0M0egEt*k6{Jg9N
zl>RZ@2OXoHmV0jR4~fz`ief-^gt8w*`Ip~*PwxMYILhz*7guzhoP;`fH48dAxCU|J
zHkOa-`yt74?J5=@)0sYc@nYbT`ia0wK5(uSec6I|v{^N%b}XS2L6#b7&(C%@E?+(i
z)FpU-kJSxefKCq8zFF;&#FVcp0`eD+uC%kpX=YcZv{NABpO=G?YH@7tWYPz5e<gE#
zZ1lhfH8C}*UE3EwcV=JImFVdDQbzF%aCP(5#GHJ`6zMK&dIiAJ&@dr<cFbc3Zf}^X
z*<Lf_&Wgb*As(qbf}vw_ibeUUth*6co|s5Tczcf`t36uMR@`~6c2xK4U2qYrO`)w7
z^ia9-2tM3oDJz+H*<$0%04aV(i&m{vdB`iVpkOItxsX|#z8W(jAxt=t|FvXP0WSwQ
zQCr$jxay-~CH~K-&AIYWaf%a<J)zN>ohtVz{V_KaCM(|sUa3l1&?j5!#}~l`{rGGb
zP$6M+(d>2tV@_`GIZEI5*o|_fo&Tj^)R<K@;;DG{T!VF)<?0NqjWIX_T&YxB&#L+@
ziaf%LI7dcuXQ0K@to+k&)3{0ccA`x~_b+`oqdv6-9cMq-wUCv>GNE9E6Q1_l3l_Qi
z?%LIW^2lalId^#Sa<2al|2_>9r-n{iw7cG(ttb*iIFTn7okTG5o%ggG7F8nr+A;P3
zhs&cDflg5-;QXGCc6n6ReMXp^{C(T^0~kJLc}Tg`k~dI_^g&!)_Kn-o^-BW)9zJDR
zI#hS8L_>B>GQrR!{_p)9ZJUFqosui!GA!1O&B01V9`Eu<k`j-KnT>3Z>ejqft0B3y
z4}}h<)OV_9w=$`XNjM>g5mud^%i;$(T8<%-kUiOY7YOW1Z&()Jadovkhd6dMVRjqw
z=byExEK=|*!1>P?6|8Il5yBzsa0|7bz<oeZVPR>xFM0dgb?ZbqWg_ato<}se$z*76
zmln<YmN(vf*^hXeos+}#{cWlSB=hD~BeKX?-1K=EgEQF~kW_3$-0JESbao1>am#}2
zGrc@RWsOaEAWW_bJqH6j1F}Fx36cs9Y$CVriVOTD7-OXwH{gT5=5<%UK$d`&qXs)d
zR=|V?HDzmQ$7x)d|45ciY>)1~>C$q%YWOkL1`NbSs)P6CK-ou%=GB%#Dj|AarhAeL
zLVP*f&~y5aY)j~qAQ#7D&1nJhcvTwr+Uy_pb_0D0^K@3S{7e^IGLs{xMF_;7tj@!a
zj%)Ss)RJoW!MykuwVTu1pl3bJS*WXJFSYW{*9PH<wcYL<ILnZ!J%c!YafP1tixyc?
z6wruPZQlG=?Cttmv;k<za8pxWYOrT7;~AHEO~QQvh9zUxn)`c?EgFsNwrQSmY5U?k
zi1qe~TM7gM5^yUt5|{#KX>+${TGz8iErk|aTLl(}Q|C)7tMZtIr<v{rd4xJmTS3@F
zvFtqO{!P;t>!j^M4I_#eg^<lb{Fqk}9%euIGw9Cdpzu5Y$vVBfHn)py2XiL$mRH}z
zLpQ$MHfxc$d1z9=2}esHXs@&jBd9RdyYf`z?W`GcM1;12!J2vmd)r}@Jz%t2HaM~8
zDLmmRX=CyH$LGot4ZPjo<!1F{bpStP-~+KiupJGX4Nn%Q2iOU1a<>jM%F^N`9!oO0
zU59WWpf&NelmUrajK^-N$LBEaB?aRkyU0GI4sMivnT{&v0siw@%o;bgvwSm_RDt%D
z-fk*sMl%BN)6$2p&I@n)`-A)UCE1(S^!FMO&Y)?sPhp<R|7ELg7=8t97$s%9WglGl
zx*J{(uz2w%&1Ng4Na}Hw8q^RNX{<habU~Uk4xcy%Xe--<X4kwN*vcx`3c_-w`0D^I
z<asIUz&5oyL=jlDzzJK8TJbM-^!UY?BeJLam0|M$K~;bQA0A<_PDRdOSd0p)ZE@3x
zi;t-NJP+p2<3jakz|+nnZ*)k)h)H<&Go64TsWlBWbMpU_d&u4uF!Eq>3XKGysjxS?
zv3L|z+OC=Z`P!2VjHt1|I$ncK?rc9o66Ll<NVw}ILq@;@WH4^Cu%y_FzO5W5z51F?
zL#RN_mR#3bRAXCMRyu_s%6n)YJWoBCG@5U@^76C@BD!+?{XgdnUJ})I8D@cuMf5aV
zIVMiZ{doHH>Gl9!d%8rgSObxdx==1?=#J#PLD+<<cKXt!K*n6jR1}gkFEL5nbfHo*
zn2)&Atf!O(qy-2aQA`q$x0FY$K(9m$wCCMuVG2AEWFJmwahP+VVk}KD`Q6B6Tl+FN
zKXzUA!BX@`0+WIF!CP}?&n~jh<WwRMZa`BudqVFo^l{dSWexMk!@yL#%#<4rLofN7
zfg~~A%dl$gxCLS#H`H`o!lL~H4rkXKOSoZ>?928$I-7P_fpGRK9rzg`3(w$tnByMu
zIcvXkZ9}Ce3ucJ^rD%$d4&7Q%4Ww5ze6cjJH6b$(;q{`=Qv-}TXg;rl?Cb}9iE>c3
z!jv&5JYLqql3WWNC}O=oUcAq|OSn2fgUyg4uZtTRZs7Pt|M;-r1^u1q1?YnW(NkyS
zknzCyA1`lhQvg}A98kBquh*8nJ0VP_hEOjHm8A6VAj!UTfHdakA-J}xHF(O)SjIA9
zzbGj1P)qO6Z=@L`ehzXC1U9@tL-*+MWAnFRD^E^p13{%qo2@NxT5oEK@`nGh@M`^N
zGiUEHHL>UTwk7i@fDk$P!G2&QLWT3?XWyY}iOZ=a_PZ%<H8_u4(K1IE6s4OjBcz9%
zv>Ya6rnkm`rMvHMGE`p;<ingu5EbLL;xHo~)PJ_rb4(JxJ0RYw-HGuAC6SP`apSh#
zoLAYJ@w(*I%mXX@F?XSc!w7w}4V~@`m6riP26a?6O+);QwA9p6zGpY?>-0XnXh`j~
zEL!*hY-LEORRvg2;57({m4T(aC85#_)#H?|hR6V{<}YUyOtZwX;jls^@PXpr_70R6
zacI?z@$b&3rEM-Mv<)<*6@etfxcNsQnH9_nd&`50(kt-Vv^LasR1-N=Kw$b8M&c5<
z^=d!)2tg_31A)vWcJap|%t%}#s2)sn8_%$yMQf${6s{lFHJhxw$lk*4Kbx8iR_MWk
z;SpuO<{p4Mn%J;YMP+tzK~A-VMyU~W7(grYA(D|)<EU_0+g(`%3gidKeZxGiNAXV8
zW50i2<KB%CoVgTCcofAFO^@-f1;a2}Mp2;6lCo#ohUp-I>C2da-D8<w%bt^%QX%T>
zwt~)#jTq({6Vgns6uR(mIppd~IjJPZz5@mX_L;?G)f_K2&={JQ>H~rresnc<rm>bc
z8MG9nqIPC!U)QZ&D{C#<9kEV4dnZPLSu&E}boap4-n@PWMuweV#d88cjQwHPK`e)6
zTy|tY)oIB+%qxFK1@}mbz<(<G(}WDq;>?)*kIdQkbgLj(rl>0&FH^LeroLk&6sKNz
z^v^$)QOzafyuHTQYYNes2i~Z8^MOxdM*gyVxg?ZOs9248dbrytld^nWyhy8-6lRt9
zO(<NheeqPz5T~ol3Y8*U%UJ<t;N`?mgHB*WLEhwOUz38DHu==hsT3LE&usF^6{+Ns
zXje<>?DIThxwWgIpc<Y#p}QmI(_9PiB(2Q6Hesby#(8<OMASioDhdnUQ%!TX_A_$i
z#rU&S4-m%bHNRHdA}D&MVvme5Nb}aMlNqr?|8HGu)Z`19CB>h6)44hESJfm7k|1a#
z*6$8MfR@RH`4q!PyBYO*CKW9|YMqog&+myWJ;Sci8Fu`y#hF`X!uNHqln)Huc6<uU
z_uCJ1@5j!w`;hpUY>DrKM~jpa^yYPXEPcDA;d}J~%pMV0mAz&4A(EMbHqt>0di!)K
z2bP~|N6(J&cL3y0x`z(wgKb(*I$^{qC%(s!g#9Bd#lj{5T;Nb@F0kj$@uNpEo^0^!
z`p!yZY(8Uuv*+p5idv}zm>T%c5k{5GwX}*94BV{_h}AV0KYw0B!RQC)hvxZ0M$RDX
z1{(sv?D!3<{{>>oa4M+fCQRwX!JAJQ)euJGm6tC*d)qg~lEkdu<O!J5|3w!s?IB$}
zjzAGmOEKJ8^UuzSL_NcNTD08!v@Xw-JsH#y1ow8Yn1zOy#9Ep`Ahx%{3Nu3zTksAv
zgW}CX)ie9>6_StiW3Yhyem>Pi2(jj=u;gWcz?Gf)FYgB{@Cx6u!(g3V=p0zuyVHQC
zjT;wP)m{q-BxwVt2yepD(qSBg-nl+;{P=G(PZwq2@(Ec-zA#Ypvc7d34TT=MayDJ2
zfzMxm^&pg<yL2h{RB)q1Oz=U!d<l)H>O*NO=0T!U0g>50uogZ0N=6tcvdqTRu9^WR
zO8EQNF8+%vP2M?>NFssG6(t)R%lWhSYng6{uoM@D)SQekO4}^Bm%U<YRiXYvCpQI9
zRV>}^#^z3x$$o?(H8RWx_QGfJx}TT|(!p45%`O&KjtvmC41q80SAU)x(BL}00oUSe
za`MxFdI%5phK;H2z3fJtS-lQ!FA2GE6V#MKoLy>q|GWeCHLoYpzHi^$e3p7?kY(LF
zNDHo3ojWt?C?f?n5(5Nwl_xCl3>_Mdmp)a?zYXI0Hy#=TbIuTm!jCNCS^HtGz(tDy
z`=NMO=}57(qTntmj<3-VTmm-0myMsEGY+am4;NQ38}{}}EIn5q*jmyB1u707@(GjS
z64|Bf&!cWaFd67;X+HmZpj%nUzBV08<TCxA+?j`okTKV2QHmI+fer5f`GzlB<pOM>
zl*Qm}z<(|mGJ5sBJPn1mS+{QEpEzdlLj?2E^tKphj>`S`BO4W8zFbEVb!LIL&Eb+p
zIyTV((R=q&TUXTvC@?%uZb72;$HBB`O%e!gC)=2m5e&geVL8YC8NHtatvP;6*s)_$
z+L%Cweopw_U`?RT8kqwBEU9HA?EvikyYboYc&=RV6vAlI%dXk60Hz{Fxx2@m2|MRD
zYnI_M&k+Kn$im^p(RJMyVGurKTf0)Cc<~rB-9ul|STPuEvN_r17S02F<SC>+No_?W
zV2J$2`XV(Q()#ky38lD@dnSOgkMX*4N}?#CnJv;J_hFq*W(W|>n>W>XC^CJZEg;v%
z5mF`Mhkhumm2x3B_`+D$O{g_l_UWHBAczqVIRN?X$OURK;X5a$cd)V&^ee>{?4?B0
zt&So^A?ZZ}RCp?U;-pFPy+P9*$)YyO<^CA`YWnFD<!2en6rN^Z)1QRM0e`{!CZNf$
zTk}S+gxp}i>W%tKQ>v{@YAxK{u4dfWObK-cJONwJd(l<eM$D#s2Vb`*-@>CP<=}9w
z;jA49-IE!x!CW&t@<-05SkgX0vqsp*cN&}{b{*bjC5c$iaonlJt?$nM^JZQ}V1=6F
z+1y!QBm<jAOw6S2<glcfKJ86K$W0PCXNieG=mK-lGnQfWgVvQf!tYRGVgr2b<TwS~
z_9FOvZN|H-ZSRC_)lIAX;aeD>JA=cZjkV<xx2`LRqDCfMf%x0cw+>6Q1(mNt-z_6M
zl8Ze*)oVqO<<0vHKNujn<bP=Gp8uv&GC1`jdt+?yzG@wmR!7b4Ra7{$5%xADWdrX{
z3z*9Y_=SG~<MATrPD`Pvr2#b}Fb~Pv37O$f4(oaNKL!TQ7uWBZUb_8cSZ~^Xv*$L{
z^z<bT0X6L@kttBkT3RFznL5?He^9-$6m|7`d7fa>s%dFGY#`ztdRY`Fq|N{uRxHOI
z&WD@Sd3mVIzq{e&|Aq27@LRv+H&g^}1oOUhd{AO=HSL`nY!_%mET9u`X7UJM!sum{
zN%+1CPSH6>?{&20iZIro)uRPRlL*o70x!QEfl6k?JsP|Ti1A->jZ>#emYwP4pA__#
zKQz!%KgMsz!bjn9005zlhfvzJCx*Pf+R^*lPd)=HjJSZa4#X(h8R%{i>9=o-G%qP0
z3U~hw(~q2_spRifRYw6<u!;;15>&9b#&bs9ao82Mnh;-}|04Tp`?72P#iLkG0ic>p
zrj^SZ&EK0|cMwVl7H0TT$!!0$Q^*T36)^8yC4!fvC467YS>Yv#5lCgm9s#FLow~d0
zvxS)VM&ZZiK)v5fPz9>13?s;)cCCJ*pYwhDM1MC+cN)gQWulLQy$MIL4XO`rZXbq9
znIj4ik{eU6acV?a#2YI&_=AHe7@D=2nmSxvv!0u$Y{g6>fPU`g%Sv+H2d!C6NC&E@
z%C;vP(#7K!FPb0Ozm?;NcaB?X1xNSypDQK9>)w>>`YY)=1xPv6Yibh1WCM+30mne@
z9)p%K3@IZ5J(hEXobroKr{DN<!H_zKyD&H>eAQTLngEIO4E$1VXH@r!sY4)KrD(4^
zuLkPm+Vm$E>8M45x^ZJz;~T$xn=QZ-gm=cU8mDpRftW0h0%3g=SAnkmd|7M3|FGm~
zCcRe<cUV0}dHf=1ZrU&YXWU(c^|XD`m&$^I(5HHtL6OE=OwEr|qMs$X3xTEpkX!?v
z6oPd_jHoG5t1n&6JGFq^!VDQN$fIXodR5~JYIH-d5VirccU!Eg<Ub6-g?f)F>&)4+
zr7D-RE$>=kgz9c0Ft@1=XwssTkOB0o$ia2+={)-_-V_Bfj9RrF<`48lXBeQ(E3;Zu
zyG731PgGut9=<<4IzXdFz8ER_o_}n$yt}5(Dk)?V1emd^O3Rg;WEs}LF(HnH$wrUx
zeyej$n#;==NneEjDj{wBoJmD?|2u!%2g-mk#Q143zYq^9id_q~2n0d!%MS3Ib^FV`
zF|moBUySLzWxoAg*uA6S7{tZeOom|qJX^5&nC`c_KnXXXa5_g->w0xLQX@S_j&l6%
z+EKg@S?lAdsa-dKdfyGnYu8RZTqgbIO&>fFFC5-p5(R3?C=#KV4`8&G-6S-s;D_b_
z^kOAS3agj-9CA7JXw1u$QQMgzfV2*+dcQsoSbz(UHEhL(vs0`l?+79vb1tjbt@|bU
z`7)NT0SHi`W&QMi@QvST$^fF|<w#h9kMOpkW7}4(WPQT2P#@4G(Zsj{Wefz@NLQfN
z)h(k9L_@2><!52-gOl*a6)InByLPQ?QTkhm$1SK-54)DWju@Lvwhpa{EVl@2*RD4X
zmKASKe&ZGOjyBdcX7zdn>Pof0bMD9Q>3(a;c+B%j_ja?srrrqVOE}c{iH+3RR;h3W
zS;DT%12@IS^?>nDyg7RSaE|v6O*c0`@?%K({Kg>Rki-D%g-JPm>n6KhN^?;m+i@M@
zTuO7`O$Bl@Jq4~YV<L*TMjxU$<4|O=W*>eu0m>1j=)|d0>mGh)DOoKFO~)Q>`;Rcu
zd!tViZyZt(i{H#ispB$t+mv4o%>gsN4HU6N*lfTADzt2py225phW<;U4&x4Q0CE5m
za91y{im(e4htvSs(%4cCJYYa?n;)F7t#y>#tC;br{@}+*ES~Rw0lKs$vdcTxJZei1
zxYJG@ds^}N35iYPCmi`7E`V^GIdy5OQ6CZcf|!68Ki?6$uTc%V|0<ly{|6z%8j`Ow
zyAw*E+IFcL<NF>BhRwDQ7U*bbAjfCu*q{KcLyF~$VQV$e;!fW?>FHBJ{!c7^RZrS-
zI*nVVFT%))zTlJ6!2kIykOc|M7(`&}%XHNBvRP&A1U+_dDOx3-JMeNTC>G$5i4N~Y
z4<Qtfb1eAwGi8P>-Ndw@CE)p`nGQ5V*$|ACCRn%k`#8jgHf~!k<GG6TiL3lBe6~ry
zsW3q3Y?G-S<<N+i+rbwvL7`cZAwJj<x=Yl;eeLa^ht-Zv`uG>!x3*;isf|nY>;`^K
zA<Tm+WdK|vM4VSOAD0eoRs-+F2loQg)yIGf08?r||80cZ0sTBU@J7cE-l^!9Oz4Uu
z_kW&v(m+%#a)Yu7K|id`x#1@1@hwIXuqdprU1@X(xLnZ}Uz#*i|AMs?lo~E!cf>>1
zFr6N9FpL{$^Y|NGj&EN*3Y86LN6C;Hs`mhj6)e?4lT}@4;xpY{V<I9}(R4uFke>K^
z?POu6y@p^YEbTI6CP(}3^Ljw*JH$xHT-h{AfJ-L#UdX=)PvePc<<@{dtirp6IRh^&
z_u<Ko2fvWlwNV$0Yr?{!FoF_fv|il@7E|5I#`-Z}4%HI+68xnG6%{%~d=WL5^ziS_
zI^(B|7$kWRXA<5K&fwc#54iTpHFO^{<{p5z^wrTpE#+$xBtiios0ys`O%((9^iX!(
z2{I5ur_ik;Uvk`WWErKFh#T$N4UbxGXqQepmW%<QK)gp-s;c0a;!apNZsJ5iSa?Zt
zCng=6*SL0Bq8|lHRQGb`kH16jrH>KNknU*aPoLNV{wmE?mzPe>g);@V5JxNT_KTQV
zM#{fZJ@Dt&e)AWKO&L%BRadyNCPN{K`&oxhxe-7{gQ?+q)g6roPi87qviRvnP5E8=
zC$KS?Bg>sq;#`VV6j-kVn$=^1Sv<N*#2LplKSDUz%l+Hqnz|A&HTI^GO*MTg22>mY
z?8b^$lvv^zsK%od-~eTVCOSN5i2GL=S{6E3mHA}Ai+rM_lM{+2-U!3bfa=p1CZt?9
zM5ETDVsOFXQe#e#oNN6zVKs#3iHDFj8_V#Tt0bZp`DZsZ9F^O=JD($IHAE|;$7Z+E
z=MC#NXI-K84`975vqKx2CwMvz-GBwdqGvz2dl%7I?D$_U{KVu2XRp3@{<H1~Q%5J>
zs;VYZE|B)nB~fo+0mCw8L=J>E6v9}g;+_t-VIZqjpr!>-1>B}bU+~M5%^YEN+Li^L
z(_oa+j7`FUM#?AF9u-e7`-tnrALF`Imtzl2k^(X0mgXI78{tqPzY134z$G~1dhQ{k
zD^?6t;Fg4(G}ksgxg`*QX@y`b*)biUNhlfD(UAy_{GRjJhyRSUz!hu!d+?eYp+KuL
z^(RfHnf9|#;#Vnw6P&EXf9v9LoZ^C#>fe^QJ-xH{(ojpLTQCVw^|kqJVp}f4N^%#S
zgS?NJ%gFqfem1nhC<xCOg`iw(pf0BU!Gg7D96=;Oj)pARGOtD3wzxz`&Vlh(rD3o7
za0I0Cli(LW5Q@A}5F&|%8aO?=RM%*gnW3s>VIi!Jx%uauiR|<JmDxTw_tS=7R~ve-
zxpKKB_0K>73*j@8J?Z^`h78EEoqr#b=og`7nvJL>=r!F!-!;wS(D?$vXwb&ACH|?l
zV9<0iCAXbe&Kj^7LI@kH`=ctHI&a<va5akj1If*{qxManyS7wsbuD~s<p^N&(4P4t
zCc!gg(UMfI7F|BR7~FC%E{U>6dvy3>?yxQmu%XE&=2I+{Y@5^r>u@-k*}uO$kofU0
zY)IH>*cWe$hBp?%kLDhLW*HhdG@DJwUfF>1<_s5u-8=G)l!zCZxn_ncug8zSci@eG
zP>@5K_h%qr;)ub`1CuCFrJ+XZ99FN<*n<<&4<vkFu<?DPY`Ofpq!S%MrPbTFM`N>^
zYWm{TP6!4VTQO*3q!l=WA~6N{L4+}?c5D+JT6w?r)0|utAAy}lKnm@IM%68%xbG*h
zEmibDG>T!wW<vLj*|XPEU&yuzlra8jfmOc;42gKPw8v`6`Is9~Qo~YR`_CW0l9T&F
zY^91Td>m%-WlgdZYpeEP=|)MaH86;X$PSca#qU>ynibFGE^09v)hoJ=Pwcrs7hI7V
z0CrwonH6-uRjn?PZaSPyD~Cm3L9KT+Z2^g%1SvWzil(H#{+B41Xrj)~OZv7N0@ZoA
zI#kyNK4_|CEX1(KD#pZ-Y7h|Dc-_mFvc5pW0xFaneCq-~O%fC{lqAUy^`&b1YV~5v
z5ThoBK~{llE0ps!AKCEegjg17-&vP(;rZn&SHR|i52wJ4>J5$%2yNos#}lj0;O4X7
z$))IlR)!^>6VgEDY!_~7NGBqnYG~hveLa7Tjm;aDW|lw#5Uq-CCaU|DY9P0DWsk)W
zK5n~>mKJI-OQhT5ae6YS4&Pp`m-jmamS)Y#q`#I{=N11K^j7=9T=C<nn5jSpnCFel
zuGctB#34MOq%mN&*!WO$F+>SxDU=$y!SAYF+xhp5>C?*sYA{Xw%QfO^QrO_$-@MrQ
zw~{zel9R#zPWti}ltY@qZ_nRfjTzW1Jk+iCl2ygDGzJ0#<kinqraYF@<OP<;-f27I
z>!u{{q4VaFAQnq4&&0F<dNmAy;^dsc)=WY%v(5(KW8PK#j9OiI7>%WNWBul^jL6B(
zk+Uez<!lds?ixb_Togy)<7-IV6V;F<k&mA~ZSvcwFhgy=r#3yu*n_!&cb@m)z!JGw
zF#b*}tTH0$ZgD3(@8q`zirMnR=M>lthHM;wEJ_OUXV6-o-idCQH4{h19hkxo_Xp_W
z!{1p{<5x=+5Y&fKKY=xy)A$qQosLCp-My8wgM+I-sHSWpfVE$;0ejwkrx5rT-}$0z
z+V*m&K{9AT^`$Lr-rgm(93o!hM2+I3G}Bj(_ju$kwghy>iWEaOlx}Eo*E8pFrs#&e
zwfSzBa%oLEcGS8&<Lzs9WW6i7d+Pm((03)(9vyzLYxHkXe(^E!GhN%8ryjz>#IkP4
zRLjcKD_8X0w0GOcqm69`4cP0l)3xuqCh11go9*rQ;Q8m29v=!r>yDoL`Qh^JH&V_!
zH`u)J`tzUi7QgQH=KYG43m52v>+$eL+kcVaz9y!CXp4rnn>w~(!&Wif18*(+akAMJ
zb2{d`Gj1mz-(AV>-e%^}quQbi`_l<bPRf{+9R*avrkwcMUJK5w>9xYq-FE79j^kL*
z23GZgPLVAB8n%9$H~uQ@5RIFgX-(rf910RMeP~SOiI#pqd+F{8QCwZoaKN7k3WHpK
zqewW<M+79<@@z_Nrp1uURB&i>i4bp+x+YlE9;X%&R;w6zFIk?ujyi+-e<dReZ6Sg{
z6Jc$f20g_IEu{{JOjA5|%&mdCh)l>&TescTv`Le1Zl^?~!Z87+RpFBju>Hn<F6?UD
z8t`><(&mjD4ScS*e^nwh{!CV*=Oz0S6N`^+Pl)*aB*}ymA1ssrB{>Mb*Ww-#Yt{^$
z8Pl=ea;e6|_U8~XThMBSya7EIz=wnIws6t$@WhDIr%h@5v7@>Oe5|DvG-Dd(36>__
zFbetl&&wxUh1n~6<!6^oSwB50?mBr_)=oH+If32|nb+g&piiGZLC`)6rxP{b{omcN
zA65oM)F7n;Rn#Md^SonKlmM*t$C~J{5^2<lKt<babrqQE2sA3}<5q%2(+y!NA=#GK
zuuXSbW3)-HejXmn{@`;V5Ot~%o+vJ}k#)=-+wNjzUWGmVDsZ{hfz!&Iwy)NdlEs9|
zhR2#yu&_1RSlUL~Hp&{qh7BE`+tr!yIr+kcK0KR7hn6G(gHRpMeBcCI?kAp^_CE2?
zXBQs(6z6Lhv$N8zuGMrbb4!nyFwfY;WLjR@d=3#-C{^(8zZUQOsWWENj0_Qx{+eew
z>1j?`o4J+;i1n}jdNDXM)#abq!|S&>GSMV~cT04e1~?4ilQqQi<!fUaGdMIXjAm>-
z1Dq+GnJqJ*1@|G3rFb{|P>#V3>|-JDOy`nGg3@~s@@2H^o(0A}1!XKy@r)4@K6Qi|
zLjx8GoSo(M*_2sbe~-q|G;vj-GT%G2&SfmL-vjTn^wH^3kS*u7+GXg&gb${PE#hIq
zZFo`p4jsPctzh&9<KAw}m^;nfyz77L1y|$7Gn`jS@%8}Md;MbYo=gb$_`=MN9{t8H
zfE4kF0i8%Tn&}YO1+b6^zfKD;`S#bz?LIzzW-ggt@1sc88c0M&mLWUTpIHAZZKH^I
z+M2^}*dJ_LxC&I0p-&B3O<U??xW?U2wSzq;WrQdzK$Cl7VgkrF3zI*znE`ph4*UUf
zy0&x$zcv}@+>3V!QLqAk0@lr=-0+5?#~{n3pjLyMw!sl&L?$kksVyn$4T{?oX*v%X
zrt7CA+4dAC9qGs3f^&~Nx&pEcK%8Q+ma#z7Rh!MwvEK&Qy&nVV0JVvXMYkR%!3zNl
zd97#A_5fxW85>7fk35VnLY4{G3&@<6_CY2!nZ1Vc-2|`DB7U+NbSL}q;}?H5Q`sjU
zT?|tQF(%D&TKO4?Q0{#3Dj`%3`rz+`&{m94|7>f#*Zx0g<NVtgJvCai((+)J_Q!BH
zUj_Ds=6y|MfB%6422A1M!i<Tst~mB_bm>%V{1W<X=^q)_lV@}2jaevg1=pw%p%FFu
z=#&?6R0(3skoJWC5GZH!*pai@AisN>l;w?|7{=hWz&Hq#GeM6Cia2AH)qW=0Hi&cr
zv{0~?oUG=1)+ZrhS$G?xvc<1={EFg@y;DPW^{7h--)n6=%JUzKWzhaamCNgDaC7|p
zcQ?Yy1qB7|Z1kJK_xTP>o)yiYo18_nCdJUAMHhHp!euoqgX<bT`K4PSwsaCV$^9MP
z`<;`HR5g(QpwyRsRFd_aZM6vt!+>_=nhoc)UHkTD!IfoQ$_B5)$Lc&<*lWeElEN>4
z9zP!W#~(FmHYZ<Uy=W;|GFDx>lrbPGqQ|`5Ej=g48v!8!KlP+(mt#!jC{)7>Cf&P7
z3r!{OC%+aFiU^0+BR9Nahz&Na^@-^tTpUGKlj@3bznU3%xdq`5xZ&nxVeVc5<8w{L
z4|%supG;=gOp@nH8EHLl(k&MQycajfhJ^NEOYa^92Za@*tY`qN`7NVNx1RZ;`uqFK
ztCW_iFONXm*63l72t&MzJLa-8ZOz)X7O001xQ6eDIV!}OwoTDTZVFV%lv{FjY=CPD
zapAXTd)%wRT~JhkJCJ8tf2EPi3%UKvECLXF>C&(LD_nuVD_XyhTabOqt~YnSFav6=
zs*|i2oYeapl2N@eG$EI+T}xIe&9S47T=z7oVb}4*J4FV{lToI72U8_zO7!O&&o6NU
zK47Bjbk+U+hrnOzUESyn!N9yEe`@fP+}r`Y;{CyAO@QDUcj&MwuTEAg?BnRWeDdlH
zIqQ(+$VjwtyLKC!r$Ak9gqj}?e#fUv55UtI!^%Dfg518~bDdy%+Zb$QND&+9d5orj
zuDNck^Gz44`?axCsA2E~62)ly7h1e$H*sPZjK~py@$|IS`7+thpWAzEnfnEpuY$n>
z4s&eeM$j(?^S0M_^&Ct{V2xH^w7zSoI!g6{!Z`rNr0bkH-==jZCOOgVju`amT|vHc
z1cG1oIyva$c+`(}nK!Q)hwH+<dnX?hCjRn%wF(Vh|3=D`%>YoFfjp`c1lU{O7nC&+
zNU?6uWs9~3k7atsP`AH<5%AsuQnpQba}5K|`BfkT`O7x>#L1H(l*gNKZM^OUiPs*Q
zaRr0YKH6SNd*<bF?eMFNzyBUef^%S3jtw-AOSILOAgByP+-2^!5m?2TKVI6WtF`qe
z(32&vAK<|aNv8XT);MgEt4or508-gO_ckyi>NcaDd_w7sckwO*GqhHXD3!j>Iz*wu
zs+S?mS_W{M@QiDQc?oIQ-^gYF6GSy<bzv}eg9Ey?*sHubr^?U3j1F${-vN_xaNR~v
zy=lu9JC7~BT6XNXxpF<LK*Hx{%CXoS&&}}kYtV8T8yWTSFu7k_+;JTbe6`tZ9NOm1
zXN;cpJ!BX}N?P9Dd}e}IVduIKe%g2J__FA<ZKT&Chz#eZv>O0&kv<}E;KYePZby!&
zA32Fh;)Y;=rD3E~ESky_=q>QJZrrWg$zc!YL5?(Mq!C5H$;jaUuz-5km{X`n2BzZu
z?lW=5Zpe`J^?NKml5y<jiBZd!cLzRhf<?hz>xvKPXBtrgv6pTu*Ls9$z(_g-J6z_`
z8EmHEpZlsim?<2hfdG+z4}P&M9OVz1nxZEO<d`aP$ByaDQ%-N>Ay=%ipd40_glij*
z^=;5eGr;K4xL2=Td6ttA_4Mq3_rH^i%K#cPdygGMIWUF>zW`mNkN9deH@2j7AMRxF
zw|wsvK5dMq4@3Xa2<qABl!6)5ca71NM_ZR0H9zfh22Ipud_@1V#kp?1ddA2pqU*0q
zM{ifbVC1-Q13XL)0Rmo$>r$hnxtW;{(C!FR-~N%QiMdP_49_%6Zt<`&tF+-&Zv+w?
zVY)YkA=w(nB;#pe(?=vcg^)1~`o}b)%xHUazoN-!EO9)6xWh$`gXPPksiX#un?DWm
zc@#ahk<BF{KRc9`hMx$zSCfg7Z0z{cAw;;?oOTk106Lp9`}H%j;aCiSe>u>>p$UEc
zG`PGM7~dg=XW&%#78`Fl3f7exmV73+nehmBmb7isB>idW)Wg3}dgB+^2uIVBe>(GL
zp1{`I>A!LE$3MQ|TQU$ZenZ8nKPP$)<a72q+5TLs@T*#34IDNAik7T!n0l1lKMvCU
zV0+h-WO5s>#U+%M`+`%O;gTr&V+TU}^{lo#xW?0`F(sRne{y~#TxcC}UiBqtgUddA
z1)Lm!Dfzwe^FL6X|2*KzNp#egeM*%H#Kr6j;AFbH%j_9ISCjG$96{3BckbL2$m7ks
zDqqPL`d!S<D;Pw?#MlGxr2J9s^@{7@W;)~d;5QvUh<a`a(YJy@2e{;$!oy4M5gq4T
zW^lf&b)}%fIRqK%%Og>_+ef8mWYmDKMs;BW2E0G`d@Y{F8d9PjI>k&B4cFj8oHIAk
zF&HmjUikCSyWJH#F^?QLbZGI7q~6T*LpE+SV_t2+>}$Ha_4QPu6Vl;Je7pU@x0+C_
zG=*#W=tRb4Fb^Ygs?)S-AHp-P?_(?5x%42%u4TKVdwU(~6F=|6=Vzr!CDigYYMkfa
zC4TA3@a@v|>(B0vn8-mQbw4iXT>MWI$`}L8iH5pwnwN3^{-7_Glj{ZbFAUw#sQXEG
zt8BnF>y+NH>MdjJfm8vE<=F%of&bttzo#AYI8ef=K$@ddB>QGbyF1K_&=vFYtB`bw
z-TovBR(NZ(q&Az<uSx)gBV%w&$HB{-c)Rk1B8@UU6nn)ZYA%T*nHQzyaNG)rdySYw
zYV_BxoeznYIDzg_j$8a!Ip~c9xZwaMfj5Or&KtME-Y>I~deac7(oi1fc}a>TGcWpz
z=;>Pl8JHhY{q{O_4X;32w)9sEKOTP73=RXmA|0Q{%M%6~yHB2+`E%VWA5TtVu0}-g
zMSQ~-OU265`_<JOH?p2z{0XtMy0y_MxeK+wMWr#eETWk~$J_^<L6rt4E1N+4tl)<K
zkMxkvXIGV#GE}Y%j58aYzEh!6B^9UwnrTz$wO+VyE76i;(UKr7L)%HcbBAuH-jDaN
z9iSg<=Uwax$8Dr(ObX9LhFYWnCJKvxeo!34brC^@HWr%_b=aygc|)?w$2Lz*%(}Eu
zZZQ3Xb0V%>3+}ycf659v1g%;oY>U9cDH||!=;~d&{+{`HJF6`<x1hX^p0Ven)=>%m
z{I_-ejnU{@(zQgZpk|1QqO6T4VwcmOzbzXVVqIVI3jQ#KV?TowXez+yRusBgji>J-
zeDgZB+HM;TKi+e5&`JTfvWKiX4dZ#Ta{kwkZnc_C_Xfp6djD)+{yQ*LKfn`W=5#Pn
zm6GVbXi8IW-?sB;yzD}cpy_n9Rr}TkcG*nrKwSEAEu{i$_?Yy7ZfxJU_9GV%bT2o|
ze#nQox7#MNEXL4qUvOV~TF1sMTC7#AOFSNJKh>H}in@$4y$Xd=2q{5WkGgY4SA3V}
z2k%mms6vFneze~RJK7i~m?&K6nGP{M+92HlWb-WVlAfGqX4VD<Cp^D&NPclQg;Nah
zRhnXk5yc}`hwQc<8N-X$mQ()H1;_y4$z|!5_?Ftwt;H%B3hAYSBT6i<W3q5zN8kl`
z-=%u>O1z%azD{Ls=ULoF)z8tL%jyD82&$~zG|)t1Y5ka2(gypnNb(GzG#kWrx1Dk8
z?pjoP<a1D%p_CmfjaC5!tK(DG2siBO<(HLW<QhyVB_?oe<jvy8v>OGlPrcDXF>F@a
zJ>Bz>H35&w5TMpCJ?Ce0sfP@>`h~@FKK%D)&6`)CEu{vGu{I70;tl@*CZX+q|H4TP
zex&?p<CwS}=t7zbW~e*8Khs_S7Rb0CK9D^n0FM%nf*|HsFi1vi+p$b53Zd|8(QtJA
zH+1lt36TZ`#_?|?_(l8Yn3(|qm`6a8oI0r1ge);$m?J@k_sg@K&4i@8OfvC*L-O8k
zMbXmOMscQyJb+!!G0&j_n%p9gv7Y>6HSNanrB;(~i>a117ef-8bRrY3pdw&F!BPg{
z&JY`<Fj_Zq!D{5UWRY@!&2+i3%snIswOIP$|MLZana?4sPKQrlqp398m3J3?`<cSD
zPGt({kuj+Wz6)Ou`sDs_q}lyDcP`efz53)e<RpnF`+OjqL7m9H`+849N}R`>CXG!f
z9%}Lj&tMZAp6S+=#R!!$`_d%48#3Pn@fvCByPq0{5?~F`vsc`@`lps5?|^ovvwPx1
z*WhKbpJ@AJJS(~_0U|bMH;p9l)@sl!`xR}E95c6FeI_fbA#khurh<Y3q{tN*DuY>%
zG~Lizdmm_;>-1jHBYNo0wY;ggX_-7Z$xh`Oqj?m!&6%jA9bDirjhi%KShk+G=nTBY
z*4v8s9H-vBTb?q3Iyl#{cU!5D3Fb&vs}ldTfQ9_okNO78NhUr#`$m`rh`0tx78nEb
z%j-3te~M2$k3TsXb$3I<=_{c>K;isB!#^0at7(TunXYM0($ji&RNc2StnLjVFyrdT
z(wy~#-y4ft<*nfhKSI?(VCai14m(5<LZVH>H&Yo>a94$7#DdiJV;>&d-Tnu@k0_wj
z;<!(=-)mm>Cty3^$v`v!)HP=R7p_R|B*4>W`L=ElHSGr>H#j>$N~Kb`nUjOTinvLX
zS`x^!B7usfGGoqmb=J2r)fFKtauV{~tJb>);Sw1L$YUf`H<iF@LLe;&e#vE+m2tRR
zGu)O579K}j2_gIlh2AE6Eq?uQ4f6^aLxc};pNax<yjBN5Ie?0@vCS(9pD>1nz#(eQ
zDi+6NI+%E8+=ONp?3@s=i;*r&H(AM~k61Q@i6kjS`*(S2&3A5uFKK9QzNbz2^P4U`
z`_&FyP=0Q6qrKe&k2afO68IX(j9Qged*;X%vjjZ@%YE=K)ASb*TgWvhvi(*!Xg@46
zwX2q+jP<x|;V1Y^rpw>E=CnEVU+3`SVe+<?xEI`FmM7v@XqVbDL}wbCV_?8V4}jJu
zOZ?IHk0(&Vfu{MOe#PPIEz~voC^>0yZ0ozPOz6VFsK)frhutX*YS}pP>pbfQ=7!X>
z6pm*wmY9l{TkF;bufGnbawhl6uv+OAZ3^`!zJ{g9dON%H!UD*8-Hq<n*4)TSJX8T<
z%<`#Mwb)i{Ob|jD)`&Hx1j_#_bse}9xXGdn&w67YqYL1JW>!DB^}ozexsEXyeUz6s
z2v~GHnVlQ^109Ouvpq^sB@Bt3L1Q@Er;i5X(<XCcU=e4U=kk>+KUwScA?pejYw#nw
zdVRIxTYN40V*aW`1q!ST>L3c*ojD!4g}|4T>P`p~Tcgip?K}-Wsg?2Yfrszd*mFDd
z5BM3<v9eY3_$PFPc6699QI2Ra2vR?e9^WZ9)wbRN&wU#%?&Q}o{u@vq6GnotXm5mS
zAz9#I36qTOW}qN7rAttj05fX0{L^ggMnCmFUK99{3#b@R%~-41t6hlrSe;%+#RL69
z!XIx~HxKHuhPkb<C^{0a;yu?XJf#IBKN4>@5tnIP7ZllUp|}N5v;#ZZTf?|luP4JI
zKXwLFw7pq2BL45j=H@GjF&~$f5W4@nqv2_R%^CPN&LS<YTgN3Et1$&POyCV^hIqEu
zx?E8INUxg5YX(v*)zd|)STXy=dl6ir$jKj7ZeLI~?5Kjrv)0<+k+f@FFPC)3Ujs&o
zgrTvK^Lx_z@}0`jbj!V#;z7a)nVC_(Ub}W}w0+ci-hwz6uxrRWWx#129~Ki@Mb(O9
zj(|?l7RZ;WKP8$3(CCXq2Aj$VN`wodY~S)LVe;Tysl}3zTx<v^fFv$+=U$|aym|Mo
zcw{yhsRL$o^(?^Npu=0jtuS#wOes`IL_g4vqtxd8=WMRJn<Ix5v^lpJ*VwEFj@I>p
zj2Rh1kAI$PQFHNP+!Z7(;4|2wpk^oC5Ki$)Y9u=3>PALq+@J4xh`(kP3Rp=x*bnOi
zTGVIAkON~g>eF55>tO4_EY%sh+oUdWdzzuzT&=9n?49vogmu-RAeuH+_M(!3z1nAH
z;P7e7-C!;%Ut|)6Gl|H|@65GpK`kqqk5hZ284Y<MA>NA`77{N=sUK!XPDDkKJ~wQ*
z(WT~Kp}ydr6veOd+q-!E2xS^|leW>x1TU}a79#aI;vP-mO7RW-hh$nw98c86@mPHj
zGef>=$-;?Pg^BYl*DE9&>ozaWgt(PYhr<tlDyT!DguTW}8eJx3-1fCN1a@rS<hi5?
zD0;eOm)b(T4QF7RbIR3{&Dck()W(4U_L<+Ng&ACqghoAsny5TJ+q!H7&Eh9cb-shC
z9ZoH4Xj0FeJ-c$v{(a8SKB(0e6;>E~KS@D`hHZ4pl(leor!tipow7UCC0+!{+*WO}
z7jZ7tO&|#c$JIoTlyeq=%-biIYfL)5?AM$I+ca-vI01n{E)@#Eq9Jn7P(Sa;v-Da8
zK?|HDfMap}^&U~&cqU|9{JMT%1l()+u^=igG{xGEitKD1<?j@RC>r+Rh0z{OF@e}8
zARy-b>02B?GNlhmy^?x2s4{d1qQ1eM(hXqnNg1OJ)SP#0cpAkYKdyN)$R8Um%WDTA
zq9DkGB7ZUHIY%uUH~+B>u^RK<*oom+>CIE`->=9g`}>Pis*6cSrtuU+@>}Af?!>D|
ztSZVjiYx|(dzhO7kE$C6IXjDrWM8oD`I05iI4Uw7<d7RQXmID@-^hZ+HwNN)3$ao*
zZy@5W#)s{MwV)-*GTgy0&(;I~X50gj64a+Gh+{bbkl;^z1=%EPq`-`YKW4jNK?glm
zdJj`rBq~Yx)%$|4RHsRlYXv3WV}2k!GuUVqnM%i<w1l>sJ?ZvzaH9^L4+{-lWweSm
zeO|9x2j5H}JYnSMOJzCI)ZduLsL8b~{1{o$$OcY-?)VToY(>379z1oV{J{w4-gAx<
zfK>molXTC4$j4i$f;?9AW*Yl0EVxOVHo?^Lu<BKbfB@z$e3J=$8^9lOqG?u`ropmd
z7zVOSUlzKdhB1VJvILsn4i8&mv^TEe<ozk;^mQ2zpTzv0b#DX1E26zr@I>Y%Zdm}P
z3J3UCJ`T-xgfQ$`^6j%CF9<QvO)A0p>$Q1R?`r+59De`p2KTZ~n<BA?*VipM>psAp
z%!l&>YlL}drcHTGc46Lx?Amp``mo~S!yruB+{M+I_WP<p>}13{<ID5$YXEpjbx&W{
z2Tbft*5rPXctwyA>%+DOkkht3uF#RiuO=|M+mU_ybmYmCb?FWN>%k5SPW##((|Ai2
zZEv5_EHa5!Qx}S0)Q2h+YMl{y0H;b52g*pm5Rb(T;RgEB3Gx5v5|Di5(ZkZACZ_+O
zf;r+<xR_g5pD{L{FYjX~SF15Jhv!JPuuCd40gla?uN_(3=yFK7&OkY*4?W{i!xvmx
zUQ--*3JrsYiC#ZqrN$Y?V81Gv#dcs-0vdV$47S*aJM1}*7#x-iT=F_`24@D}*A$q3
z>;}4CJ=w?Vj=D(gkpRP=$`TgkjP#IR3V(PdX^W?VABPHwL%G_uw|YC2$Yu_v33Z*8
zOR%77<d)Ed@X*XVbTAeH8&+nLwR=od)EUf)#17^=Nc$7**j*^MWDp3j0jk<z`je;y
zy}%GHsJz>=Av8AUi2U&B*nJrOF%&rqT$(pv65?oM8pZSERSCVhN^&J*;<EDr;_e*6
z5v}-HD&@O*eRmMoS|O*Ub{f*!WzqckXNc2E1T@XMYCu%NGSco$8B3rk{r2-Ootnwh
zo)CA{BRQKCmcpOWYojjH;?-6YPeH3`!+AGcGJ4_1QY2Lx;7IF>T_QR3n~`ApB-tmI
zys6+aR&Mz~+x6d%9z0g0dfFa7c4Q^Hq!F03!<rxFQ8`*!t5q=J+-mWs{QmtwQtWF7
z_JR)yet3~E*X>Z@GbsDo#3J?-fF^^~S~lgi6AWTt+y{$G8EQy)0&uY&C#)Ox&miI}
zJqvH+Yeu)5DZ%Y{i2XrJz~X}_cAV*QAuByTu`n963i1Zmpfsg}C29u5q$s5PY5hyw
zw$!IS;i;R`p;JdPrp?w|9^MK4mK=ScA?Zl-Aq@;Pd&38h_D{>(xRv}jtgO5LDmeV~
zR4jdz97rG(ihVbXjCMC=OMo&{UY$wEYwIcSivqjTI=Pec)8erJDw;qtidy*ajn&*m
z)CJeql%|?uzj>6^2GB^lE>--%ifCMNh|HOZ(N`R3G0-2ZMmXyO8x@J0APxt;f0R#W
z*pi~fZ@l?Yp)rsIprxq(AVuE<d{-Mv+HowZ`-}^OXHH__>r>Y)QeStzpX<hvhKI5i
z3Ckk}O>pr_8%U9?tV{8OgQhR=HRI_I6N1?(<+*r$$Dlhu$toXPEz#X!Qw%o^klCQF
z3TJW>b|S;VpMR)@2b}2Igjfj?q^8Gf#-rEL820_q^f*&UBOCJvlS^Jx@(I#FHbXi(
zLFcb=XlK>}5CEMRifqJBOSyIL{L}-+6x;x>3oe}O2Zu!qjG=_YMt-PB)Z(x>^Fnx%
zg15#WZId}|!^IXKc6O?I_Qs8p!(k(L1g>y*9tI#@x>~hiGk*v>q&f|DnUI}BEsOqO
zNjY@;u|*F@_#3UF5)XbE`l%ZPxccr3hJxRz7_45sF9(^C)@3-dvbr49f0^exMmbK@
zbQ0ZA9`>hBfm312Wv0R_$H*r(XOT4xH9f$IygiK<H^V!DVH|^1@5Mig0*;iNlPX~q
zL7mW{%{#!0wW7Zzz>j;xc!}QO0^F1%)C%Ge2x22pLj7ou$-fY7!V(n$Zgtx7O4oB_
z#kXa$YNay)GAMWv6D}qj6F%gt3M8Op_UP=PXsE&w!4_td2=`<*tsYf&gubZ;k)q;m
zL|2o7!syQw=wRNqORh$`!-DGw?)Qj8N1N-yjw#sz%5Z~td8k#@vc)Uve5G)P0vuyK
zD7=69zOXq|Uy)@XYx}>;zF9Jz?+Ham_;k5)<<z{atuUqMQ@r|!T(oofo3H0t-EW&z
zByAmy)Z)V8GRK%-)?sJsM)Wdt;t*ARY0%L5VIdtq*nb$+g5Dy}><6|e{8|6Y)wxoT
zb93aYqA@zapjJOpvNEEl15F&e&bHJP`YfqONhZrZOzSN<cKo<N)WZKPf2vsm77@JU
z{>X_Z*T26GwbB}}rl~w2xf#X9<u}Xt&;@@Dh{!^m0pNGHdy%CkgS$nt{&4?eE5vf7
zPx<Bm3Ft}yo}T&R`8~3xq@i7(g)X7tq@_O@-R-uwx-~6fhp|S=+0?}CmZ_cV0UH4t
zrAn1LWI5Vx_UtIgej9mG)D#I`D{%=hWYjRbOM}&QF~5Oj9KdHBVe0P;9Y2!L?pD!G
zbq@&i@PFrr*ycm%Y5;sh6%og4+d&s8z{)--ghO+dup*fk5&}j750v;N%wVrFyBeac
zuQwx`p}|(yHqvzOu+*D33!GNw+7qDhw(5t>1-!?=KzAG`7G|j9I#*HMfmtUFQy)$P
zlW$RyfV{MEhk?dw#{H`JVAGJ>g$0s=wcnGNC*YPlDZraah(E=;q;NXy1VJh{(N?LZ
z<vONP5V{^BbbF{E)TL(tyl7vh;@!n>d->1BE3cWkNX;rz9XEV*%AVA1EIl&>{Qa=J
zs6k$CZXb$N7L^DrWE;t$SK06IBLuh0W`W3)6Ky^{e8NeS4{_&tf3N4W%O8o9IXdO*
z);+cX@=OE!kn6A<Fi1P2OxJawQs%szQFL0|@z;yR)Rgosns6|-)(ES~%gzj(sLTa#
zQN?O~ro<Ptmg?pL0_=~!`AKHB;3oXenC?#(vv2xG`OlEZv;b9oA7~q3+~7OmR<6d}
zY<KK7e>-5GGgNP8!2%l+W=5_3UI5SK__H8~knn24n}uAI;oPo{m`Q{oz|K9t|Nh|K
z&dvW$9jO)1^TjN$jptygv8N1c^~><#{HX3eZ%AQO;#0W9rxV-!jzvLbI)(GN7w-#x
z_Y;#&p+Cq6&V1Y)K;JKSCgcNJWOF*PK~Mkf#OlCbs$wkT1K}yw*|Q_~h!?}*9Jnlb
z?>>P;$e@cKKY7$;E(Mi#HWExQ;2P>tKlnp_^DaPrfcj6byz!_Pba5wFsoS5vE}#<9
zHmWSTemyv^>*U`c`<Ja$OD>{hmp#@)k9#ayL~mXNyDfc>boX8(Sog-!`se;1>u4c^
zSFi4WynlbDAJlW&F~roHV0A8{-?}5yuhx=X4x_8Aq7_H*<mNiFZKdyXZ|rYGIi;?-
zUcYj=$YZBgk=->Z!9oJryAG-5Avhw@767bbY%oUwmC2uY?}*w<6=nW9o{0pE7L?)=
z>k3W)Su2^@i(pUmI*-On8|~0<5|h3-gm-KS>9z_NB$@WUdD53Yk?lA0XKAvixc?JU
z&3*U_x<c+}GD%h2bY<K9`@C|@p39=}V)axf$O{MHYRa^e<YPw`Yw8dRfYkQu(ox<(
zdK@9O&;ZXX-y{|W=ecarB#24C5j;{Ebh^)pnL6P!iM$bTHBf~=2rhuFwS8`fi9ipM
zPDwT?PhJjs^%^zg^#3;BtFZM59t&{9IZ#Wag6b)2j9eJbBBiPH<COFPL}HTQYQ7Ng
z(NU`aW~Wqa5^wOOjxCx~Z^?LiMjC+)5R;hnh2(V|l5yvbI2^cal?P>t?*3wwnk0}e
zD(dq`r(dO9@YAfv)l~-Ul#g0i!4RtXWt2KC7|5^{dCPP+kS49*;bCim^=?FJ)J4oj
zkG8U%r)WW0ML1jj>aW1<%*Y8el_1G&$g^w}M+6nNhMSBApL_O9J$$g=u&L2>l@Mf4
z?Dch_neQ2~-2pDcqThX8_(h0?;ubu;^7D{>t$8$>`Jqp*@9uPQE~tXJg~hqf&K;9v
z)^_vZ!y(KfU95uH3LA*vB-Z)E0Fnr>&~On)wzR>cel^rIpv@zMlGvONA`IbVDVQFs
zc6xhhatV=MpPF|6mC}PEIX&`+={!~dMt@N^l@PR_m4y%llc|t9!do9PEKY1Md_!e2
zDCJK7-2gcKIIHE&SuZ9QEEw_3fLr``h^p&y2?RjX#3EfV$0?ly^bj9JigTIDaHOH&
zXk%e11DYOmVWkji5FD1&^8Xa&c97WtJkY7Q3#d*d#I;JQet#5`7HR&OW0Qq0RX45d
za)2R@{-tnQbV0N4U4G*RP5@c@@9P;x_cK^kBO8AXx(uoTvC>19{X~iYe={;RE=`fl
z6B-C2vJJ8llOkA38%9L-A7Q%xs$AVTKcu`eC|b`B>;27-a`xk8x3yZ2AT}~4T728{
zSFWth8(`JB9n>H&2d67rnrje6V|g*&S-fcs4B?z~g<J<WwjB0TNC7_#`h1E=rnwv`
zLi!*?Q`-{D#VmtNq~?YLD%UUd$OIi(5n||L!Qin+j{~N2UExq}*<$kBp@BKQ7;ng?
zOEJD?VB(5z^*DE$j_~V+>BcttIG(Ssss+O>x(cFEFxkrqagY#J+?<#jpL_TD7zF^W
z%^5D1dGqF%Z~d_{>Bcdt+BhsIkyC2z<6V~W*gG^RY%5U<A2g-Mg?g0d1X@N#!5n=l
z!&wb>`_7$nh=HI2)q!hw_yDM%-LRpNafUsecG+?Z7xr6e$>h+BIgZZK<omxFt)g9X
zDlYmmX++WIZhQkV>d`bYatr~i;K5z2+2!wE!FQu7J#@9I7ef$zbg60tBqCYs&;;X(
z;y}^OM;V4EMFo)%`}aRu)c=Q$QuttOb%qyc=;h_b1&E-`(C!kb?`s!U92&{tvndaT
zn3m(rbgL0*ovCR71I6m~>&tgd)jHZKasbfdD*Q{?22+J!rI8)29yp@}Gt5K;0MLZ`
z8kGjMgn{n_`$#Yw*H6>~+7)d$R-cXmA6`H*kcQ=L1N6qweH;ZKkpu`Mc<<n?79@NC
z8;t<uqsZeq$Lt)3udGE==YnV`=hO4j*>z{D$LE4^2RcKg5g(jF{`EgmgCgOG<j~=<
z6W*8jNnCsU{CNPV&~=MBi)T`Y17dOh0-2H=1`x-~5XTj3@`fCW54EjYRx2%RNcQx8
zREwK6cZ4xRkJ<<ZVdPrd-o{WcU^{a|6!Q4K5eW&QdE>Uow+Gg4c{(&Q)+p0}i%p?Q
z$ZmrQLA>0oMF;+uTvDf(XIIK71z2Rv%7@fj|D>m0qUsfb0;HDDzxjD$z^K3eHDi!5
z1dmM9$}wZgQDXD>@gg(?Cp<?zK7Q9V;0f9-t>wO&5$#?ZgC3+@tAGEy8KNOEy+vXN
zYkQGBytDQ>>6(-L(9dY83b5^emj?YdV?TQzDLlD0?cDCP`t8uSB;X@alq5s8uqaIv
zGx?C)l(86nX=aEA=6)(4EJx4s3Z+1gjXYuk_5iviDb~V;?|<(8Jko8S%Yk#hENNS4
zIXBO2P|}IGW}IGeWk`|V^8Vx^sxMP@RjYAiFxVUO`XKt0QKtTlGFcGjymoowGw1Jj
zi0OMpVk$xQF%Sdq={I_6DRk?dFH`tGz5rreKyi6ObH-_qS)DtkvB93RP68bOp{`_r
zj#*$Ij~(7n;m-gz6h2IDwpgpEXjbW3KNr-Y%+d~Uo=jB$5-mAl2lqK{FCK6exD3Q@
zk*pwz$ufuxXCMzS9VtY;bi^v$bpZ&02xfFdI1^|t*Kj6e6e$K8^R;&F*><YAd5?^P
z&M`(%8UbZM%8?DOA#+V;7EHyqe{51{$3$OWg@(lmV1;V&^{*bwRJAf(l2sH~;$1)R
zMo3J)jw`;DrD);fB}2We4E`!I0f?$T4A~|h$!u&+aWh&fkslbuf(^Sd%s5N;oDXMS
zi4)+)EBo|(h}d8)TK^rr-YnW<GL%#@CK;hLl?V6H7QSlUxU3809`E8W&1B3;NCNc=
z$s5org(!*ENK-XP8EVMVLtJLFxV9!!DPiDb^MuphWKp<o>J@0bB`D&{LR;!jx`+C3
zWm7<<UzRRq%U2NX7=)6<_dSO=z9-DcmKBMn2Kv<hy_#44=E9#Ehr0&eDjOjA9JPuh
z{s1y=3=6w@%ft2IOkjB6ffR5S0<H-JvXzLF5h<>QRsfI>kKt2q4nCS>4WT6&A;_#|
zEG=!%tsiQLzQT>h{$s;*w-uKmK~s&C=bQ-90;L>npBKV>DF=kM{=#d8TxSgF&ht7^
zEG=NJVoU!H>zaIjuVu9zgeokDx4lT&n_9dk@qRKjQ=ct|R?I|<GQrI65hIyxR<5^d
zAOD660lmQA&HiqsxW^q7?w$EZY#6zgCd?j8vS3_ShvQ3PQeAdPm~J34(&f8bcS!;v
zMU^Bql&YgszQl4$^jk!ba&UNhH|#EP8X9&3>cG1TCe0_mig3b#RO`#?I+FIAkt<cp
zX)K~y8H3LEN%Yn(bLNyKDp5`dPuIALAuwoB8FNF19MqkF8GWA@Rz~|Y?B`1NA3Sh}
zSu6`PG7NL?Gc0apYGFY9<JoIX2>K0J4m!us%x{G`?rOu_UTR%p$||}r@j>*}A8ZIS
z?J#Y?^V{V?PreiI*YuC$iaO)8_K4sQ>z81Sy2e*rLJqhHZ~gn1n=o;rnlLh$7Rr!g
zK(nW<3%3WrAmYOxa;8uooieq1!+BrlFmngi0%4VwIX!ONGs3mlaL{7ln8pZ`<2X_I
zYC|-Eb6@ZUE3RF^`y0I<zkDg{_(OI5@0l`?Q#Pek)qEA)0;7(Aym3~Yb*Y$e{=j$>
z_5Inghf67SQ3BFn*kZA&V@Yiz;BRL}?|pDjgP}(WuVFOR^XjRD5r_aAi1G#&hdg$J
zX1S0o99zw$^x$Gv=BDO9n3ojS>Lv85f9+vsql()({pGC_H;6%yR0F8>sVTSRb<Kil
zU0#?ZXV;xJk3woV*P$*oiXuMwbpGpy-S{d_&_4j}{`vUFjUC;5Wsl27WMX9A$Bzkv
zIC~VC0_9}AN>`)qL`ow2mq!8SBT2w49^7L+XsaxsFi`?(h_SBNMCJ?pv_{&DLkLSw
zc`utzHXGzzQ&a*z3y=xObJl^lxDcSuQB2TjZ;EEEbRluyN=s8|moVStDA*PSDOJ;%
z#f`?^Q;P|1m)yzJ4tqWX(<lY{d6+=leYpvESMn+F2M$4$HJ-@@1)2vTPKdF-GPb(S
zBNp;8!vKQ%KFQ@~!_q$wWed!HC4oBKz4$4r2@$P;I&>slXU$qM(rf}K0&itE!a-Se
zkxMA-Wbwho)EC4-D}cyMlK4_MqQMgnL1iF;f#G*qQY5JK6hfK)t&okUS8D3C5$mL|
zM$q`-u+wl9LK;cIdL<$O82ExwLN~T7YT>n$aVUPN6)6Wu)aKUKp|9Fb;-*NA38#a#
zWFwBZDV>4umc!Uz6JI;e+@zGjpjd~7YQr5l6?4?HbOibjXUu3SD;xm-Y>t>d6y5z>
z0*h38w6h``6KA1&(ZmnE>{|iFr>e>q>)w=TG66@22UJF93mEI(yR#vG8?#xAl^hA@
z&DY8I8o)*LSQ>Yk%f>cpzmr0aVqQs7`4*@bH`>>uk~1iv{tsJc9@lf;z5gtcY-OSb
zQ8BdGr)-T>O379!*-{}YYnBLEE7>B+lA5%yWT`9>3R&BfkUd*S$QtSQJm&uX_xn8_
z-`{=TGt}qve!pJlT<1F1xel8308CnL+`K9DPq0Sps5j1BGNEAj2(s>iF2(2JT@UK(
z>I(Zd?%#hlL%SfYc*@bn!@%{xf<jmcP^}ci;)Epnrf#28c&R)=Tvt?3?jV84C30kc
zDoUdmm%PfZ2`ogOr*5~|clE!S|6WsfTt3Uq=;v3rREj>LO#-A#W=4ikFg)fvS@SzV
z2qgtuyxD*<tdbuHy|RH*AWj;beW^CiX1xH-ADMS|fOJ>+fUh!_t=z(&Auw__{h`5x
z=S6Xob>?!t3j&e;V6<S5F-u_tMGi@a%E2mnH_8C{sQ_)6Yok^eV?5A#gyqaXKZ+a6
zv*9K;LeP3`M#faue;+t7c(AeY1kK6=qehPo#c4ZbW<SM2erx><sllGUc=6@Z{D_E%
zAh_fzY)<X;UxQ{sP`1Lb#*+B|XtvP|a*m0n1eg)+-?>Eu4hxt%GQ3M&Sl0h^cVpuN
zGLN%!rzr)y{6oTdH{1_|lqHSMV9uJDH)`%&<_dq^0?k+>1GmN>9i}FZ1ip*G(E*@+
zCbg}pcCRpWEOSW&$UnFxGHWoy-Q5!PSr87Vd|_<`<~jy5vZ}*YAQ|}R-mTk4R5rg{
z-k=gEMzo{LG71X$3ej(9IVP`v@ydFz(=;-lt&K5{Q!o6(ot(vF9=`jVK&nBn2fKVm
zsxts9{$n1+F@0((U%o8=zR<ei$-l#a-cdh|=ggX=LIv>K&+f0kWRf8{Ev-8!NPamC
z+AfmM9}4KBw$R_$1A)F1Qx;VP3sci|a6P*q978w=p}akN%Hy{SpRDyoOxoyt@wvSH
z$+YZbI#kAj$dRGMBlL&U5TwH6A)4&Nlbirl9VcU1GE7DrvCMmtIQw#eRXKs}XfG}6
zyeBm^wHwK?8>Ob-i$@V(mQh3K07$xlfopzFqPN*XNl6Q}TvG+oW;agWGa83#J?e)t
z^C(}9(vA>kfajbk2XHe*c@={LjC56f$XtsU7>kN=z?OXxA8VQN8$;P}=SyAl?Mn!H
ze^6Q;WAZ*Fc4-A|%`0?Wg1AzrD9V{T8Rjr$icPb&UB*Be55cuEJxzu=M9@U%!y3tC
zdfJ6C)TtO}?BvBW>10c3TSg>e!0xwpWT|wlg3vL0iauI-s)(}Wph-1wD|iS^pksnx
zHFw<p`@TbiBC_s_Ki^co{Sc&CoqE#!;%Z1rTBgatW`a~?GuoOjHBqd4A>e_8&y3$b
z^~CYxdC&zy6d_gFCSWloWrm1)tlYK`nUGk7zt+HS;C62yEjp0Ip_j=ZL#<YVI3{Sm
zOcj%K(9To(F0y5{%zI@oWEB+8a6~f>6c{w9K^7Vqq?#C?4s_)2Q19Ko+aiM^8dz?|
z;G2RexQy9R1!^p~d#d{Nu;j70F(L8O@;3!|vEoZwm(u7>P2EbgX?VF3Fg5}R4+}<f
zYa^!z9!!`exRiZZC5fpvEdT&qG_>LI(b|Ll8HMt28&B>J5c@iG1GLd5-y4#c4S5A^
zrU<Q0{hNFD?)TImh|5Wb4O=UyWnGb9Ne`a8DC9tozh12NR}q(cN{W-H()j0$cSNBZ
zlePm6WsG4wf%d(_9$Em^QG%be-a(hL_g&JB=x<2QA`1nhOGiW+hG1f`v5~d_SDXPw
zWnr30GXH5cn0EPjw|w_I)+n!sl0%g=r0(nB-$jL>7K~CEpL&12@3|v>gI+w8v0>@C
z5!tv$f5VlD?K8!J6hK^#*rDx4lVi16&j-ZEy4H+T$R{YDGqL~<TvRsz^mc;lpcB%A
z+b4Pt2lxunOO4~Nf{UP-^1kAt$X;FW&j=@{y|4E<A47Zu5zDe}RiN;+CB09<)KEL#
zIp*Gy_TDBcT!FG6oVOqPZ``l}+HgG)8X-pDX3yb;RQ;fLv;t4})#!Cx#iTf`=$2Bn
zkjDdNo_?pUrshhwiEm?xs)U+3nFK^H#7H<IPAG~%X8AkZ%1>Pgr!Ig^+H_B++-Fgd
zaLy!R)&|t#08(=@q2TMn$K|6M`yVk=QE^al*T2=G;OWRq>ziEaedzYc`HnwRdM`+x
zvNijp-RSm*nnYMyUfO<8N4HJs(=Jzbk2NXm>UX8Ecef|qpPX^&+n_t@-H#C~t;a1s
z{Nr>LPbLH1PC$LcQT_wu)|0cH6}vjjLMIwj+7Yv#4=eu3s?_zT?zqJj*JXCMqoIc>
zdWiHd`|kG{6w$HP?UHV}nL~f_QY)CF*~TL?Y5r^o;;3HoQQL1DUzvIz$D$U?mVGWf
z+^h~*YMVZN810j?MFV^yalNq+dNC_jR~GO2Wp+9=K++eRvU7b}wb_)Hyc?b^mIysB
z|62;5iAANj#|BjEx-7%@43u`J{DH-v$dk|0U}Kzf7Q4!s7;d%Nq$`psH{&ffzTe(!
z1Cx$=6zibDR|2Z3C^gm6;jjL$Epr}BBFv-6f&tNuRoA;|s0fzAqqW7+N!w^s?>McT
zlZtCS!B&b}YGoO4(P_LRe<KYDfd+hit^WN#gg%%lYXpx@YDIQLc-M_t7bu#LmlGUj
z!UBnRk5bdd(if>Ft08ZdnJLQE^xK1BC;{0DQH7g;2U0stnW7)NJB2atR(z@r=$!1&
z3~$`9tVuAai4><1$TDvudWsK!91z<pxOey~GmE4Ni2_-9{sD+#W{`qKILbdMim_}-
zkv!UXA3Xrs1uU!ztld$1W#n2;d#A8>{|v?75L9x#PS3U@?Iz;A81aKcM39-)?Pw2>
zAY~gEYKF1RAzOM`pq&kF8cmxwFHd=}*+e!F^IQ1&hwjxJy7q#L<WUmW0%5jS+!8~p
zqtN79;BND16$^i`C`8UQz0+ZS*F>e8WY=x!+dFnu#*TZ!!bA+Uy`zyBr!b%*vl08Z
zcZDT|GXWJ?&z`wvvxN@j?RxvwU!LmbfcMwsSL%&bFF@&PuB(<?Q8D#NcK;>%?}&e{
z8qFvqaU{=&Xq+|R9f?)UBT!>rnRO<-1MAD_a2n3N-3l__-M9e7*J7kPv4+O)x(r*X
zX5mlwgA*D-I~><7?H)Z6?#<+v<3KsNS@PhrXq(S2pZ2$jnYKP@7c8_P7v-|gHZR{V
zZ};10UjNn6acIu9VJqG%Sojlv)-Ih&Kp;gNnRT^Yhh0ZgdB3uBcKBM83cKCrFfnwG
zpJ!z@>Llw|D3Ok6Zp?eKNZ*~hm>OfI@n!Y)w69T1+8j-ijhur0qoSfp7A6j0B%9PQ
z(bxE7_>slWZ2&sD)d6N%?4y4yEn}KolX?YGnUDkG119oYX~zam>UEhnFKhM0?2%S&
zKxAa((gQ1y--$yf+zrM^7oGY(9ES89I0N&=&p5Hvz>_y2odVt_{}`*mW$|ldk(JDM
zK~~Z!SkKR9<}9^VO|R)@iw#IAxV}(sw_kPG8s^CG8Kz27;t+wu*8Jn7F~yfu`s(3X
zV~pW9av+XrCfYA}a5?}jnfP1L=#kbnQkjR@<B?Q?g5-(@BDio}hlHGZR)@93E6?#E
zL~w-qw+We{8RQ(S9YQkey6}+}^1NUtR(^fAos%n#0Ezjshy@^4Nx5G#BLg`GM|yvU
zA-Y>Bi8DNk8>3udvB`o%Qx$$jGbbivYQWTaR(8JWF6Txff)i4i_;*axN?RxeoX9s)
zkpaYR_(XJE2J0fEHKjUi#w_DDiGj#d7_)DM#hR9m;ez`b0+qNVB6OlG%j!1qIw?TA
z-R9kke|SD_P#$r>&{HPvFc!EHzw<0kXi&&TD+SUlz!+@N_M7>3^YQwYo<T+boFx9h
zjH4Q@^0;e3KUy8$ARde$Id)WZ<mxflQ8vXt?7)Goy!u!e5u3C742BKU>^&u89RV`e
zs4F|!T2mN=&2IFQL9L>Mv7NGJ>UQTPqMpO_?%chxm$6f1+(s{URz!+@d|lterVdxP
z<E4S4yemmSv?vxrC}hQ6@z>XMsX3OBagj(nyzV=VQMp}30Zl)Csy^|Ey}aA2HEe{#
zu#k6fT+?#4u;Ai1F%#$Caq;4`Xc1Rr=^#`f<q&Mc-QbUw%*$+mpheuf9+yWB%M^&x
z^Zmq)RQ@%ORs*wwivDWTxmBW<p@9U3jK%AO&6vA<evp<eam{%DVEH5I&my=L)(15S
zJ;tU~q@E}K9lxwu?}h;<dCCOm6${_7WD1h18*dJPPUC!M!Ccl2aQJ{6qRSXykWzr6
z58)SuW^=rbcwtEwmA@caHtXIlngbw?#1-BqZ{XCRo$Fpr`qu7nzl@cFr^voCS^;pJ
zm!F)$G2n;BaMQ8w6XAq|L#dT|I8qti-W{HQSfR4nf^LM_iWT3~w_1ptmo*b27UP=`
zopWVf)AQ%D{?s#M<@e#79b}<xfo%LVk4HJfDDI`;l@(ROU=gR8VNO`=T+Juh3e=(4
ziN)j1<?XL&Q>9@5V700E(`rA<KV_zdBH0uwwZdD?2L1>7V1hx*K}g5Y(zj(?V#?=L
z<rB#t(zrtGVxgnzZ>|k>fSq)=VST@0p9TtTg>%WCTN57<#V+(~1+2^W*{vLE-Cfu^
ze8M?k{EcT1eXAMc)6#**vOZk9`v8&hHORZ$5^o1t5`U0DPJijR=JQa_Me#BB(E+`7
zR$dtgy5bdV;$cb>1`l8~p8P5I?P7Ez8^N<Q`+HQz8KrYmNFrp28Am6%4PBKDzt4Q`
zy!@n{ynrAJ9bocNO-na|uFO6mGI#uy&9YJjRlTuJUXBUGeu?`(05(PZ?yQ*(*NGu!
z7Did_{%4X)K72mRi;e|V*VLzhAh^`|h*l=qT*`q>P*KI{@1~DhzzO6+SZ?Y0Ezexe
zAkrfB?Snf9m-v2u-9AXE;b(2z3Okc3k`@VI1bM!~E=QNiXslBG@#ZO6m<P-y|2Ai*
zXBfzckKZl+UP@}hZuMEDYO$9AJi}u&Rb5~BQXJLzpM-H?O=W7p!Qqpg>YVTOnw>k#
zq%Lpv>lU-&?sQ6IPJsz6aIG>$DD~{sIAae-z?(MkoB$*T^TP+bx(%TWta*O8fgRSJ
z;M&PhR!yP`^LhN|Rt!Jf&%uY9SI9_$jltVX`RRHF2C|orZjG4*5-#>{zUry&EG;(}
z1b!feL-<ky%FQDE`d?t<lfJb*sDdDk+lb_Q_^)r>Uf({{5{<XS^^%fy{P~*pq3u*f
zV*t7wJY<O2&BH<E!dHl6v&dA%&kANzfDsf06_-eK0cUne!RMvwq1+JZ9ta_&bk673
z5<8e;I`uAKu@CBQVdHMyn&9b@=Ot?oh>h%($)EE1pG%i712>*#*W}DJR<;_)8N_s?
zG5!iFsx-W5MSi&(pn=XraYue04`A-#<hLM{He^WUb5|12^dkthXVD9sWOA|P3UmkS
z@C6O?(Mw8$lG+fYwkBkN)e!Lm11X-X|I&%00C(4t^o;Gk-h%~d5!bc`2k+^y*ZJh4
zMqJFKsVDkyEhZ*=69>6gVBhDvcWd%w2^ezm-@LpFUDZVO31XnM7fDG#S5sZJ+xK3$
zwf{^{hX#BsIv>Y-@z1I7mHjl+2ipBFyx0G%E%dmTp;ysA<v9;lONU9>W15yd9IC#p
zEaz>b>H6{TQnu8tt4$hWdq43CrK3pL8UJMKBsDV>jnbvant5dm0=^ah{F}RcO68)#
z5#uqt5F^Hl{wAJ3zkNV#w{~Ht$(G$htY!ToBPn7dO+?I+ZKZSxo)lIQF`6^C*zuHU
zToROt6ujaGP61#+K#z-jFI`IX>MYjzy#r~-j=d%_3`#iq{;Wd{%`Z9sT$_Nb{_v-=
zu~r7dIXI(QCctZoaW4cYCHIjj9?&CL;VK!<zo*8FVuDYm7AIYw;LOpK<!4PBHv)#M
z`532j^I5@I9je~xWUlRZVU)v3+syC8H_R|0zY%Culmk#Wj<mHcn$x!g;tI=>&JfAW
zFf<1G(*Oq5NE6!Y_q-QG!=oR@?8weL*YImA%?FvfVCG8}cn1q*JpAYTCbTI;>j4%M
zIv-e9(&t80T_RcoP%W=B4}%Ac@6GVel-3MV4bxs7WNHlB@B(1<2&9UX{!o;%TZgyK
zWJoY`2M);<qrh3LtZAVmPVsNl^VF_FxZ~z}a)Hg_4ul03VQ~#6R+&$pk42)EbFam$
zN6D%z-6vBdS}Lxn=I2>GxnfO@;5f2ctTk|L_UvXyCrx`2`F!?`eT|}Rg8(2`ha|6-
z5X(megxFpwHw9}jp~0l_IyVjWr0orR&;S@mg&Nt>x3%nLG}U^XwFv1V$$@St<)YsI
zFy{Bw_=j3VpIh?$%57+V`gXxcwop8}VN_F6u)qD}GyDGiw+&rcw)`bGE4h7!$rnM?
z_(06c9J~biAAxW7{9o5Zn8i=H8yv01kP4*E)cAKt*sjn>^$9}X#nzXTTREmQ)J<Ej
zTidX3_m*wj;($lR&4*94;p=ygX;{<K{RF}_BIzGk!0o8kb?ku1yPH*T93#LpGy<y!
zmnGQbmuHhVuiU-6AN7R|jG~1_DVc<r8H0z}v4~)2L_yI!i_@#V9=7S6_t6%*4zsrm
zaz-7@<lW$IfAE>K5zvUMmXz?^Dqz#nS4Ha?A=B&CYg@H$4F)>#;B7njc*-j3&nP3z
zil*Stt%-|3&i5CcvML>}Q`y7CY=$fu3;pD3T%i8>?cGq~st0q9^Q@9pX{ankOlV_m
zz4I3f;Ps!sd>IPQW3=G@KEhr6ew8B=|4$3h0G_qhRcohUGj3c0nu1$gk1D!rLYnjC
zWq=6<^0TU{QJ~l!#>Uy{|DHqPQbLZbqG(&nEc;N5W+-2FvYy;%{=MDIh3Fz!W<AEi
zMK5y|Uh!@+P_4rjwDVoLvIHp{)$h1@R;h*x85BU_5PhFt6>nss*#=wAdHE~bDhR28
zZea%pa|F+NDGC(j7A=JCpf4Ybyz~~Gy3K_zk83))!_`F5*T8Lf4_<oa=FvN=t;;?#
z*fRxDVgL?MV2sxITTx_;M6gx=tiHCkwu&Zn25jfhMUNF=&qA>5`~K~lEPFKaEQzzP
zb%DMJAGB~BBz#ol@fchT^bomFaY9<|faBHUKR9=<_>c(TEMWypqId+>H3#<Ywc>xt
zKSaC{4@~V_5YOad<Mrz(8Apv6u@RI-Sz1z5q{RT!)7tNGSYxA~JqYEy3qjgvZV`{f
zh8AgDYU=35>rIDBE4@X4c}Zz0OD%fCe)mKs`SinzvX$f1oXHY;g9hzIX?<`}jb{o*
zmq9u8U#8x}Q-NK3I{}b)g5wP71M1Sz<<)q=fn~lp#ZY*s?VX40TGLR!obcDK!h5je
zZW<8$^H>xZ^u@a@t11b=0%06NYRKM+PrT{RB_rp=8>tg*m!2Wk-SbO7F5{eheE<F+
zx;$I@gcaU#=sU+Tw;w}?FqAsBH*HhS*re;n0kU-%59^}+XU6o|(7l^BHP7_C6^P}M
zUb*k!%skN>5V@C9rFz{?`!jVi58Q)x9$3aPwLp7tgD+P3Lxv8uhcBtZghDH(p&%Xa
z4^y6y8h4f}Q}=8pEPFCPWp`xcSg4@5<mAbr#dF8d)+UE;1EI)OgD16%t)1iUZU_GG
zK+$O9UH=md$S><Ql*wZ-_4ew)He!HUdT#Anmf^G?yRTn#?he?RE^>`%<S<DvHn_zQ
zmsrqctGpt7Y~s#M7}998@8GcR?KUT|oT*x)Y!?TCQ+;1OU73<&Ga47YfdltYIqC8r
zDB5rMx%P;mqhn8My_BCnfhEp&f@60UL=7L$F|u*7s6C7*QdKpC%XNL!;LdFlKhm6n
zhT2@M(RDv^s3C&~7m?<vr6z-q;sJLhBzecDe)E}EE<NHlLfE`JR9cJ?v%f%3zDkAN
zGi>wxk+{`P@9#l@(7r>5T~Ii8@7&qRE(ZQ&2>(Iki6ExL?KsDfEMQ~1xJ#i6j^qEZ
zi|laf<VjmzM7(13ve%{Gz4r8N?+<d@!<eWIRo%14k4+&8;tm}e+itUk_VB{~tw!*y
zW9Ty%lgK@}+MjL?dbE>d3bSBGnRq97k{i!aCRisQpKZui7O%3D_LxCVIK5)LYQI(^
zQ0*NAquJ4uxx%(qrYG2n?UMmX4166246K5~jHW`lMce8X$+yRPQ{Qv9QOm^QnO_XN
z)YH+~fHq|u!}+CWS1k`mjfAiFud_e4TIf_g@@1e1i`yd3fhRK#hIG^xFIvQ6pW!@F
z^;6l|YnQE|S3H2(2ShxH_Y`9YHqvjqaU*R?rAqx*lMikoo=k|i&zUm;p)>z6x@H3M
zZlVxdOswdGNnC)R2eNe6|LtJ;H$I2a&@Z=`=}XGU*iAywFI6L(mXw$Gq#P_EtaS*1
z3zYa>_2$hVQH65*B?u4;BqT)JT0{TTw2vlY*woZ6P)(6P`TF(5A45{pV2X+%P?&2O
zr~T;G?g#X0l88$ZQ14+|Ow2o?IVzc=rkFG6frJ8ntru7=hVUNBJFX~x=0&EJVx^9u
zu&bq|yOAJV^yxlM5vC~uM_x-Ppai}S#B`zrW~}S4T)Y@(GgG-~W7gN4yHZvbc5z03
zWFmH#ljn{@KJ7s-*ATzfkDorxs$X(-Q$RG=G_6D6o&*2*4hYz^=@vKJ8ohVun`xY*
zrKl-R6<kOjCfltk>@pZBox=3y+#!%omLiLw0vt+HTOvtjug*RU%x#*OHpvVD<FlHY
z@f6yzl$W6#=+<l;Arg5oz4`3Tn;*q9)q71cMO?R(sm-w7ZT_mO`R4~$N#1)$M*ky+
zul*N2lXJ3Vud<`4{E4_6%AFner=ONwg}nG#bv1QiJTjKixQWK&RTXmR(ENaOy|D6i
z$sZqewer@j8FV#sn|1dX+DBBKqi4@f$X#agWc9ZEN;@KV6|EgZ_iJi(Ff2*14+1H&
zVviOutpX;fLYDSS*<yGl85GMID~#LcS%vIJ_T6qremBBgR_t#Gakrx47Tet}`E2`&
z;JAc0`HG8Rcc*a-Ii-YeRQ03gTq6A3am~bg^2+!L3CL+m@9drK*#3_{MsPk$W3Adk
z0$qgstb!Vov<`YW2<BqOT$R?gEg}8Ng9nk&yjS@T^yDUW2bgnc6#0+uE{UqdGsc{4
zIE$r+osGlc0GGYJ6M{C|;O7Ze9P}Q#_?eO>E*ug?xbY6>*7$i*=+vWtDCO{v_feyi
zJV^0%i^@yw*M_qgIA**;(zQ08UQZ|)y1r&@!-OmE5~FTmre`x|Om~<G2@#TEXoRNq
z`(E=P+lu!hac(F&+uklY5jhRNRt5MuJGI9cYAGe+$1h(JMA5xs#mSQ8E7g<(3?XEH
zzwW`_8|2(TjcGA^8P4L4o-Km|%%d|VEoE*@ty8Db5@0DfWWxu~e1dqfVVo6Jox=i&
zBr+r2$ynR1J!!~dp|KA4Tm8=`nd0L|4IsAP!WK@hSd{a#NhnrvrF6iZPEZ1egZd_h
zeyM)%-toZTDnEo5um>(HSxeg4Guo4-R1d&8;E-hU3gpjdVyk30*c)PsWAxkSk+zR|
zoAmD6tNuv8vh(L3#}*_$S4^gW?XIRgs(ZT-vUrA;BWkOmPJ|{*Pa>HQvEqV-tqdOG
zvYeFr`a$-f<kZw#C{?dKeE4s*wasQX4Z2`4I8GEnR9)dzqVE_%vYlrYno5i==6rb&
z9?<?=blx_R-G%P*n4kv}rB%<d7o^Qh_pGcRyU>tuxn-7!kozyKj#&fxbb|4;gqMw>
z+$o}FNhUiO{cC2|a>Vr(O&cq-0TlV992~e==LJgyJ~B^L1?tjwSzQ=1JkZSp{+L$Q
zNJz)o?u}gN{wg+WwhJi;D>ux0Y`s1BnkOm+0SB~BV)<mDwz}PsA)Kb!${Gwfs;>2P
z_0+H+9X1i})f0FmsPuOB<J(R7@uaC)3m1+T#R~m}dx+}(?9}P{vgryLj8}GqeK6SC
z-Jqoc<kv>9(&5sUp?5_Yd>S&Ob?3o55t=weuiX5xV?XzI;e~cx?surQnE~@c{M(nl
zz$pF-8(+rB0{|>RsY;PvXA5)T_oMp6(kHo!f~>$YcHsKE!SO20BU{PD5*c_=Ps=D*
zJ{c@g+TlIBGZ}9zB2DQH8x~ou%L0xGo=8)Pg*_<@_nR*@-(%gql-|++Bcpiu$77l=
zL$N;{M;XW7Qez;`k&<(d)PVt*p_0xwGt&kqp59S5zn}EpNT>OV&u$xP+*m?F5jFlR
zsS)Tlt%NB>{x1lct$AC37nY1dm11o?zC+#F6(2SThG$o6q9i#^1x~o3NP(ygw?Zu?
z6ZF_=H9dL^*Fh{}hcZD6{@nJf{;LbCR^uQQCNRvLOd@OlFn1xfp#yU*j6o!o*5+nO
zeB*O?(!Xcfpao@xV@jL7&!-l^9!GLgte_WWEm%-6<=?g^cCl{opF_^sd+3C}qVeEx
zVuADRV`V)+6!F+I6v1|m=Pk@J4!-eMj~;@@EG;Z-X}?+b>M+68^|4d7o^|(jr>Uka
zt*j<+&>oy!wO9JAP?p+Y1k%~+n#|=Kv+f<X>ak_S)7Xfv`97)AAOjMa`nIK?889^I
z_U?}h5}#Yf)pUqnbEn1U2TyN(ta#XaOm98CXmXjS+na2~<aV2%Z5=`bieG654@2+N
zmH`b0|AJ8Hj2b^43yKW>9UMRx&$)9)Zyk*xkX&<eHo1Qncl6V_AvG1q1_b4^Jj;`(
z7}jU;i`Dmd5uT6FuiqUJF$P3s`z>H-*<T^na*x5;mUsa?d;9i=Pxk_2*mzI$3gY{`
z5|T4>!GmzA2cTv{D-^4{uKgJzB5`c2O5;ZTaq5Ph_&-UIfDe)S%IM2vi{h+Z4dKk2
z7J(=9h79?BHqvlb73r8dUw+d71CJM_V(B91rQ@T(Qy?IDUNUjSJ-+SH(<1n(&G_*>
zxv}AZUB%|j&n>TjIC}+?*9|iD9$%2s2x7e(t$?t!W#7VO<P}&-b$AP@D|Pay1xrA6
zwh$|?I1)DAYgUmSUf(&&4Dw%&tMbF{5on|2u#lCwa{=ic6!#8)#G-|y#m(0Q&r7ne
zFMpY}@1?Ru*hLaiGBPO#d;6FS_2m5RovhHe(+%zazy3*Ac~1Mo!*@~l3|sweClDq6
zlk=!q@jvq(q7+Wzv(3x5)1{Z3NaQQVJ>2A88(UhY!~exHYZMZh*~ZG7@}4-{Bc5FW
zY*9-cR;h@C0NqdGts-PA-))q5<j79e&YD7%$qfv9wdNfBh1jP&IJLy;Nw$)L7T}-`
z#|sbQ^*pr9ZL>FCrnn%BV09_j9xxk<X8{3qP1gHYL|*wpL-7*S9KI%kp%b27DCEBH
zs#Q|LF=`lMtDCmyFv`vejHhY-vtp-QYiNdNuV3qHrW2wZPkYFG!#&h%WU6x|I~<!z
zRZB9l=dKvdyR%b59dUGGcwss3;&;)5=7zb$_{-UE*G$p?#4YuVu7*$*C`1YM8^wGp
z@921xagvWrkrQ@Gn3}v3+)bS`BVqa;-9x}h5lqCWUL8W2tqbT9wQH9-Wm*D<Xe%Yo
z2##J)x{IDiU-6@_&>M0q2-WX~<_<nku&4wAVHc3i>yO#{B)mt6wXU)8)O%MA8B^nA
z>2W+H<MOz7@83TPj-)3ikI1~DChKFLWcWqEeb3&e^${P(C3gMwcfWo~MTPpcIfq{<
z6tO4M0}juSg_DN|o3%0Nr7$_u%P~N`rCuy5yVrM*_oUS>;WP=c+dQk3GO2heItAqp
zUGsDB<Vll?pgQ!BbWq<sH(ARP?TpG=IGV7!&(Apyf*9+*zl`!k$Fewb^j+l<*ID2i
z1Z`7=H*5mU@KZNu;+78ZPXM1@o!@3$^;7gNJd{MHyE^W#LAt@hR+LdTG0-D^4nHp>
zKM>Pd(sl=DDz@0*U&ME~Z7Y`Y^yFY&yLmI7B!B>>%V^KL!bW$*YFq#g<)2g+i}xoI
zR3%Q6r*>cec5EO9Y(g*bw~lC9dJZEh3b_KIlmKJ;W9y?b@yKNBnHgCCK4ij1y&+v`
zSEd)X4{B#36X>g-=G(CDQC1tx%ip;fa&BD^Qms6n-TJk(*Jxf<^q(~{EI55UQDwcU
z)_J1S1zI+@QXCD!hVF59N7h7d#ey49VK*y<dnik?D*8)7eGSpodl2$*%_da7(2EzD
zy`y3t)oycBiU|JNMJPTF-5-5ja{T$$VxU3~Y}A-BO;u@#hE(fzy?XPe7$!-x`{m2#
z;0P5}2xqu9?G9U2yL1UAJM|5w6kG>Nbi-&s2zs<3rdp;HBQlmJi;#JAhn8j``J?-e
z$f~hLQ+^OzJH&&Hgm$PPy-y}Hoc&sDBu(t!mcIu)s*MV_@p=WQ4GS_BXzfn0qc%^G
z(etLNxL&jsVatz*|Br5^uDBk&u8c(j1K_e}ZgJtI?}aeUG-t_G7k$)Dt%MsFHxgG@
z1r&clmu4`&<>a-Eu`C){c}(<K_;UnD^y&}`&SSLabi}Uf(|N>vcvp5vKx~WB`sQ4X
z3hus8xd26nZxVyp#M?r=J2(-K#d``5N?CC$HbB^~UBuQwEaLd?;x<J)6l*Ip8s}On
zN~RWF>;HhB$0rr20^A57$hv{?#NkKU(fmp=!xH-*Vw5Np#M^~IzR=3Q9f)MUqBG;=
z$f$}>=P>cIH%GU?*yRdbyDGe&>7!#4WdI5vn7+Hg6W)NZnZj#BV?bP%Y<2yi*<tof
ze7oo_q+cT18%SHn$|cwDv7w>adee2t$FI8oq<JW^1dFEs4FO$u@8Zk3?*aoT@aELb
zVwN>;)97!$pmK><6b-W`=Fvw+K0Hn}1;^nm3!4Fai=%eLu7-NU_BW8?%}gg`_0m-Y
zPG}%A3pvFGHPu_<7#!u}(duJrFyu!5Iqdl9%<>^;nPmM#wxzG_2B(1*VkLFwM#vsk
z3H`kEqZ*G~3nn*qb+ozsy)!(yjt(>LZz`kKertkQpnoKW5EgNzF24*HKI{y>ayJgV
zkwn8(kGi_aj{FhugcWvb1;_<)yuLJSP*>?jVljB#r`7(sC2^Ze)NWIw79=t=X<!k(
zioPiFTeUB%5ha|G6?2dicY<~Pmd!hKbi!UlxHBV3%iTWcsm##0aXrK-BO)S#8q3te
zqv&8GM6laXw~A#DlWs1WZ_vF>g4H5^Gzzh9sw0M>VoHg!M!)?u%E1}@E?JKHZM6yS
zolL)pfXf1iC!sD1PEPbrf|T&z-1+^^JgH|PE9inFw#2z(O4ZY8S;(&Pu*if%#ujkf
zv=>PpZm+UgX5I*Y8)=(qw>;}u2Dx<MWv#e100o@UW@2K*c;6Bl^kUPCq%!r>;OCcO
zAgr`>WQ?a*2d3l4^+}I9MyFs46^*ofQGHN=zuc0b{{#|>E);vFEw>j&q5(nTO*ixj
zzlX+qE|FHmLrj>rl}4+~1Cl^Qxxf_bMkHrIM-%;C?i$T7#z0cFiDb{1i|hfHp(b#y
zEFkn|a1o(ICHa4G{aMU>S}~>s86?hdizBzzuH{@%)G5-mi0}0?Wg9R)kGMpIoK!Sq
zP-30f|DYE#^eR=dXv)G9kynsd=2_)Q7^(cQ2%wb}>j1fC24^Q$LX^1sx2GxxL_epL
zEk5ZzQ<^{vmN4OdL4cav0|d%w%x8e37axda*%)&$jp$RaYt&@->1Z{pUzpO#lZMgT
zvA~!V$y*iO3{pOTm@1XPOzrp?WZCxeFM>Pk-C9z}rR)HyFfphm+aTslGxNKhn(A&5
z3j#WYWUBhNezIN}@ngp^mwsP@r+~d_cnSt70oCRh+k};+yL9DF|KI74rea4ww=qb1
znn*7r5aF9MM8lRJb*{t6#ft|7Da|Q}K-xG4w-YlwY9ZEXJqxzGE0f1C3={vx`ArQm
zxQlb|t9w2c1f^sQ_(IPV<)et5D(v*rpnf&_xteY-GzhU413-z7RBwS;#RiGiLpD*0
ztQJkv#FKx_p?@c<V`Ku1uiH#jc0STD&m%}1Jowy3L7K4CSe_@0bvDRI$M#N}kYQ>e
zs4kf~aSuX0Y+9HJ?ECeUmp%UQJ;p^S@mLuglfAVz#oNXDn$M%45oqS>dhkY{HjeTA
zJ~<Q4MWTk%pk%3)tq)m~L6!B^-E)5n4JLGh%8)%{a!SZlr0%rEJXK`Nt?~{6NlMCZ
zf1F`wd2-zZ?g6FWdGZQE5Ue<M&b8|8XvES%{;GA=mK!wAL}4hR048)~X(<J7f7rU8
z@AKNq;#~?#S;_+lH*<EbKfA#mX%AYRgD6wMxauMSm3Ayu<7M)lH_RfMnWU0P8|e17
z^sH$fJ0zb=oj4J>*yTZwRyU#T$;~{jX?2*Ja4<0uzsR)#y&pUIz?fl-=?|H~DTC+{
zk5GQ>G0p03Kql7YhLx!I63sL%zyWuipXcQkap$gUY5#z=R?sn@H!p44<wwk!ep{VW
z(o5x;?k3P@3^01}pFaS1vTzyd9ZAQvvppB<&nk%<B`}1dAa3|7W|c*HM}TOeKpVmp
zX%pXAdY$tu9W@{q#FdhY?*qDPuN`~YvJF!le{cQ;Ts3$zZpMK&3^A;Wj@D+2!27Ee
z$aLBc8+JCl^`-CKNdUjkK05iJSE*Aw=nsgtO|rL~n6h-WA0c!Z6x}*b4$E_|`g9Hu
z4xMqZBbp=JWFa;Y()Lu_1gyFntIE{+e>{XcCtvbSs`|zJZGSc)mIVC#ILyeXJwkl_
z6K5y!#~;6ao2GK9cYD;d%8U+k%16Fi684`H$|P2pAOmcTse`BL9I~xwgqcH#MgfyM
zQ~V8>^F;Qwj<Xx21VOB_^%4St<dR1&<R<E$ZuRXp2Nh*_PPp;!uuhD!x;;OWN=NhC
zlTBT{RzD1v9S<_S%xy|?O78-Uj#Ue=kXcXg26RIc!oQPm#On@$IjIc&gWnXR3fWD$
z=+L9XX+4-i&c*%@0gr50tMK+3gNltFI@6}jyX<H_eE2z=hF@q9NzAMXJeP4ii2=tT
zC4w>^*%WER_JyB6CqL?KWRyAb@1!lf;0<p3rWCuYe_L3*oXmt)P8^0wcOWit<`#kd
z^5vWGX#TeP*Q!f#5Pb5#If&GUXj(SlhQ{EA7OEK-LWOm-Ol4w+C}(ucG@#a#nit(!
z<Gg<S|MuZaex(eCT_Y<}q~!Uih3!I~M$G^uYt9`+fx#)?{p*lH3;`||0!-V-I{7e|
zy;G|^hwnd~9b1lgRCavMc$~SeJ>Pd`dCk8z)xj6+S}}Lws*zx0+<Em?bS4|g2KYZr
z)ZY4a$QA?UmqDu+Awv~@F8}q4Ndnwu&YZY{p1BkJ&?YdkwRO-n=a+}lIt^MtC#M<U
zFZs)y_u|-tR3yPU?|Bs(MJ*i}pRU%`{|grk_ztFyF7-?wBvS<x&H=L`+9uoAt2=3>
zJmZ)v=-A(DyOIh{E2eMO_=y8K&u2x{OVE<t*=y>mdZNKNt~p8@Ca+23^^ebnIb}NX
zF2Mo)v4ke6->17_W+A|}!tQt3Ku9pPkP%GxUw}+=bQIjZv>Oe70lzsPrcB1^JGM%C
z#b8|vom`#+)rxX9UGN|!WE<2))Ucx5Mi-nhA&28j_>wn>9f*y~iqjxCF+wEMZzy~T
zly1WHlf3$#T37%1jlx1J)LGD|Xj)ry)JVS^5d(|ja;Owa#^xw^%7{6ts3ZyERkv%m
z{HlBZ^ZOFUQ8oq@(bKchTzjlntD{p-5BonYKz$KKpO%_(F~3xQS;2FMaWu1tB$%q$
zz4^E1;|v=y>RIs*cOD)6(cB%&y}iY8_Ti7ozDJW7{|-`uJ4_ClQH-L9G0h9eB@9}H
zsY1=1TDHV~HgFBw6>+7Nie6M=ROEqxX|xv-7&wTYjr7p#1E_<PfJ!oaBW{WOv8Tj4
zqv;kmzZU{rwAGXyb6kaMbJZA`>|<qXL7BshxCRb9|Ebkj9&5iW!Gy!D5%~StrE%_m
zW5*(!Fo>@0*NmC3+p0G*@?lB==4^8@e=&1(_jcH_>pEHu3Vv#U6)5diuy@bnAE<v&
z(jd7zXs9^5^CejdTDAP5fG!v~le^o-=!D=qr-nn*EBJFJo%776T#_^;fSKs;_-;1K
zf?M(J06A9&Ms(iZWmrebi<yMs)69qh)I{3qw{$AqbK2sQtS^1vsb99%TQSDw9l%UW
zhh5sc5Tz_e(4i7yb7+BmeB~Qw3=+A-?BWQSo;03yg~oewG0Kt$$M(AGK5Dmx|E@Cb
zytV*DA&=|yA5Avp+4*t*iQ%sEe_Wt!A|qHnnLhfjb}j0@){p>i>8sc3u@HO!E~$FX
ziM3*@cWA29?9@_{qfDR3a&F#mBh?Gc)^J%xJ;=DAef%jnBk?t*W*L>=3WqZ=dFq)<
z%Q-(X5=wG2@7@kwV=R3#oF&hW$@+U&JOVA|%Xe057{TGH6ObsaEWj(s@e<x&>dS2!
zfmNeSY4Io594(sgZ$Na{f?I@gbbfA>F$20r)#i}Cu=Q#~dnfbbhH<{$@dpkZ$gs`O
zc{GQx{(P&tY>|^`S7OwLAn{eC<hZu9Q{Bh6C`%mQ1z!7p2a;Ldao4Vebn`?=2GA9Y
zM8VR8BbZa><eI=iqBQkvluUmWGUfx_YneWtggEC{-J8B_4_KtwdNGB~5K)nXZ1n3-
ze>m4r-<Gpslc_XLRm#X7J(|H`h&3M<UM4_j8D(hZ61?5;@PPn4rWrqlCa`24j2qT`
z&dE#$W653`hD)aXa#;?@g+<%*{ba<w`7jB;gCkJ1dD|km4r-nwU;O%5E&Ie$0Yqjf
zW>H1gKlOt@XiYf+l1j4Q+Q+dNM!Fc3qwnH$7bQs3#_LOZJ-&&B3<v1M3iIG=##h#U
zTRtf#wDl&x6o-aO?Su4Bp@vckDOs=y%hEsjFKa#4?iI=S>yr4EXnS<(Yk=W;Wv};y
z({^pkmCu@aWC3~#CUabk1E&dNz$|UGhV&-p^XTz%@!DQE_2E^v_*EL2d@UCXS}6%p
zflv}oKq83P&gpbOC)mJC^q*3GenUb$6F4F1{x<}s+4u?$jV(EWBt3og54;3dWX?R4
zMyk<NL^6s%Ih{Jq)`=k)<XN(`nkkdVwclTrCjas4TV>k-17$xa@YprK!#~2QvY<Jj
z=|yR#?4mmb$_AOW%prlEcs*-szJ%+y@+;^0$qcrNDs$24C7K0l7kDW+4Q(bmVd}H4
zdT`p#|1{FDtuQ^<xvRHqipl5seq#cLu6S_9_YbZ@Sck1sCQWk1BFgdMhV6vPC?2u^
zWzesy@fLg7HlZQV7~m`%zhl8#7z&g=>!3DUq7=y`)Qbf+58jLzKgHC`&29a{obSz`
z_<xHJ0ox#fvF~ckGB5GZ;+=yXGS}G?vG5;dP~)Uebw{+}(?NSw5j}b<dD4(&s_6p;
z;aRbcQvpyMbOVP;$**{b$W-BI3dcX3K9&C5S-&45tJ*nQ`z2@rZJ$o9_mIq~GiK-n
zi4}0_M-4dGK!)wb5dn?Rp9z(v6PfvFn%58WxkE+uQNz~;Gff6DfuWgsL6zE6(k+%6
z%7JcJaoH#5(}FrP<<YY84DlVBFyZ*bJ_8SrqCDPY-F;=vy_*oh`ai#34e9$IW_4U=
zt9y~Wbtl+P_L?=z>lgMg%Pu7O-Ur2><yB#B8lC@HVOw`x#zOEw^>k9ZKEd}y8HDz6
z%>W~KzoN3TOGrivpuO;vaXQ^*9tX8nj~8Le*O|Mt;N!SGK>L(pUjrFW1<;YZXHwsx
zt;<8*%$6fpW1D#HxKv%VO;X>_q{d~{ZwtZ39C+>`5{*|h9<V@M2aW8M8dM`AKLkE1
z_8=vJMLbJyyyLtg)m?H{|H*U+`~`mz`OPJAvwr3wtpjMeOf3fcyw#|%^SX}|5Z5TB
z^`;7lnNh*(Ew#H2TUi7sQ&DB4p7=7MlCX*FQ2?ziyppW4{IN~XN=zFOoYj4*iY>}d
zK125izm~SRJMsG{D1XgTr$yA6oXp71M6aJ8=f8pkjBlv~K>{qzsk_5jmB9qCmq^UN
zetoGt!u>7%`T#t1?B_?OdC=+?2{g#gsmiw(-l`N+VwxZ`OaN(1N;r5zo!*_xC@WxX
z$U-}$K;!*g=1Zt8_}a)_)?d*u+F1C~sjhL>F(z{?$bE9tD2|V6T0IeKJ^0+P4r-LH
zU4dDDlY8=g4EG!KO>+py4MUiAUZ#rn+v<eS_G;qs@XV=CKjR11yw3uJK&C=CURin{
zpq!MPTy{^<vGaGx^t(MzsQe12%qJZ5Yt@7aL#Bd<#8s9Kq)Q}-oA`r#+2H5?<8TzX
z_G;<C+UkEYuL?hcYak#A_ras)Q4=`giaIGD&Fu$@^*9zt^YU$d$->N*`ZHg%^vP`|
z4T?@Lo4Y5}TcPZC`Q>N|)C<cxR7-ZXOB|;OlG~l4>7vkY&CeD1Po7!67!|LAj_9E$
zk4e}^RWGj<7u22Ax@mWjvGT#f5|W~i$$$>~>i!$h$wUp&nZm<p=u6_I+Obe~#%Mqv
z4#y7A7~aaT&ql825zTme5~i7j%Y)Op6lv)3P2p6;a6@MUhH+v-#Z6LyM=iT13S=;X
zXY_d5q;UZzWqPw#!Jxe;jOzPf&qL~X4tYMADJ5)gZ<3Liu2=M*RLjCG&uA%x3<CCq
z$zUT{Yh4g0VFTpR@$f+mFLLnV3TPzD6!YB44i9LR0ZdbudfS)L_M|2o-LiMHHl49N
zEdBcK7L9E-1m|2^vRi%Yp5+G?+&Q9samEKLMNNT);3}v^86{)_=>8es<JW2zn^Xg>
z7}Us<rJE#u$6tQqX}hHQ1%K9q&ydl0Vo4wx2iZx%_ya{>b5$7*f_IXN0j0=#L8W}+
z0fo_9ApRkx`lDH+Q37A^0wB1Ny5=B4!f78`{aV=aJHH(G0N@lxUtixQy3o$u4JCa|
z`-%FgAA^&)ax&|IV1_^oS2uSVG$V`anj$&d-=_;EM2f0qrw^xf{yr5;C|;cY=PnU!
z9VBv_j~}02g4Q9TuZ-pLuViJEOkGq|WZUmx|KvLB?&hGFxqfr5@@r&y1ac6U`XBFZ
zCGN1VHl>IE+-v#p7Y@^4eHhV(%}{!LZpl67?T$ojX_7SYcOBIjF+f^IfQMW$$mhGk
z+7nWIRx=`J&H@w8$+uSnVMI^OtBh6_=7>@O1aKLxI5BDt2tYz3EHrIw#O6#Ccp124
zPMM&&n;n~Wh=BqOY_76Iin&Ic>0@s2-ykUH1>Zz=Pyrq0Z~nw8yEXN;?7-r_l{~c}
z9EtI@p`k+$#XS_+;zCNb!sDZ(qt#(+s$WPFyf|}@82vEoB7TnmtyJfEDM}!gm}4*3
zhKb<}7nc$%4_Q8P0p+slw+{|IW6TB_esiRDfH`qIPOEt*J}Mb=%iF*jk`~Sr%qHKA
zO%X!JBx(m7lT081L(ZItTt(@=t|9BwvCPb{tDT{J8Trs+#AmQ8Opfr`VgiFJ%+X0V
zmSydZCGT|MpvXu+<E7(#PiT<?)zlm+Yvz-gMDEW^?#F}-!lo8*4JE;`D3V6NsfyO5
z^Wa4a(jF>aeeEfJ;3d_bjvq36aCgz2f|Oj1mFI%>1AsAx9z_cON7O=6Y^?S$N;q@G
z{%(3P@8-!~mo<%48LOtclS$Nh`SuL;>j@%*KXf0M06z$^B#>$U_Nz}6&XbCTh=rwB
zelVN?37rrnhMm&NvfD47wUEz88d=*=KWJUU76sqmQ;3t3y~Vl^0ijsvl74ntImCN2
ziU8#t&G(OTKI22KwK>~NcY}B3<+9gPnh)frZ*<f6NrzK*eNz5j_UYcnA@$c*0~N<c
z#0Od1#H7nC0;~Sl+yt-uat3C2v>Pd<b}X2BbcP~jnsf@y2VCmVwQF0Ql(5K!SQkc@
zq|UolQetW`;89Ls-jhXl@IGtFoCMe7_LbEwJM>xyHDEsf2P$WA(1!z+U4--ULr!6D
zV+y*}>#H<wUq7?c+pj^|hzT&}aW3~h9|2%|d(`l26AjmEaV^Ku4FeH2r~fRZfA@A5
zFh(MOrF_{ligC!xG`gfy#`$4v!WG#<ntJ8clK&CJ40CQ{?7mg!!73a%5X4~A>Zz9J
zYdQq3IT^Nk<j7{IyQN%5enE~t7VZeL!-Q~bxM3san4nICp1%DtDdpo<bKIC<qjTwl
zjUdXfXiR)Rp;O+nY~8}2g6I0uf9d~@QXitC%IGn)fj?>Z+Pp3WKhS|l^n_Aoj;M-p
zq8N@FRiwC>R(L<GWfc$WwbTHm24bg##*B>ln_=eQY$8EO1#8giR|9<*vHHa#+Mw*q
zp7!Vi`@jFby4Tb!MjwoN7#OtV{y`;!-Gqwc%L#Bq5BUN$38(3|SAb1?dv$dgNMG4!
z9<2$Qit!byarAozC<@nF-Qxl3L(i{$+F0#5?Nhx4WzXslCiLi8Pr7sIXkW*=he3Hc
z<fReL&YB=_znYgIk$~jns-ANj<vb%R2tY$)6R((<=?ISx0rZ3|9R$@K3%dS2yA@Kw
zIK#;M)KYTFAm*}SONYW{599BM9xgp+&LXeC{|b2hgZyl91>=Oq(VNl#YBri4H4+3`
zu5N^as58U5b!)=d@*RrW);%Y*;U#PEODg(%O+)ep4>OhIe-rA%%p&a9!Ha~=E!QY^
z(PHlU@sG5lsUn4^_<BlzCKUp$1MzpF#odP_D${FUBb;`FteAz^PS)R$UumYR7DGuW
zqr)<!dfZpquz&tN`#k&EIAu_NcK{=q>SjD<@!dA(w9*k49*l;@_%)-Flu^GT&D-v!
zek&zhdcjSbGSnYU0K{U@VtYYDd~Q+O_{7A~*-=3F&S(JAiqpDcZ<<G)9be&DM|=V1
z+B}-?6e7(i%H#jgteVaLddCYEw1KkbXaHy(SKa>~nM5bpLi#3xIg!k5U`!tIZpLvB
z=t7%5)7(T_2u4mYRDY&+iE2!iSdl*;(=uZ&Z6|#tg0m~@wb<Ti36wXr0JcKZoyW~X
zHsjC<E5G-3H}Xpvsizh9yJZu6gP_)mCj+O6`u0HI`Pzk%I~wL7iDpFXG7Q_@V0&$t
zEt%YB&>27?^O@9#NK860DFZN`V;p0Cjp7>CR^+Jrw+~@w1BPAK=l#<raT>P>z&3np
z(Q3BN!$QUqt?$n<48Adp_7GNo@Je5;vK!Gmm#u+-j>Df$0wCeJ)2a;*S~JTi2b8OJ
z?nF0PH_gR9?69>xojPJe*s&`AV+NS>q0ggF;gImc`tJXD(Z(SEjfjPhX~x<R4`lbR
zAWdp|Lb_sJKbQNr7Xp|8s%aM-u89K|3rG$-YEHyux2;K3`tH=@24148V40$EGdf#W
zZb0f5WzKavRrohhm21wN)A)Bw97`eHB!VCYB7*dxSFQ-1A78bndx$lx%MOm8bb_>W
zgxA4>k=}jOm>rQIZo-;P_FJMaHgMLb;}<QH^@ZGCf!}mqfJxpEa$$X~@hMeMmBp}h
zxUG?-y@HhpQX+4Um@y+}+RM~2Zm%}MQN>Rth+M6k=th?cTp(TH-$bKy8PJ|y^6KNL
z#b;t?7QP9GN5AQLrhe_)2cFaZDF0#d>+jH=Dn7Y68@058lC+dhW*!`FInBV!F=K(X
z^O3Fd(;R0yS57RR*n7&MlVLGy9Oh+)oz9rF+%9$Ev=p5M4vOxZc1~+(UY~a&$+dCl
zn07DfSAIXZbI8k-HnRpSiTbg7k9m(!2(l5nYWx@cdB#+G1MKBoX3V?W&Twoj>JYBU
z9fS1Ll$2aDgg+|g3lyIGE4k0vK8GHvop_ZZ(ioN8VIEGmkiaxTs6>hhEWR}4cW+y`
zIOr9fp+h^e?=ADesz<&rHQBD+k$HwW$5$R?B5C`0lkZK{EZxvfG;``jgH_&RrQiW8
zHwR2H;_UUnSO=;*d`!{jSYgsYL-uZP$wBl?+#p#v335l#PeWv4WO=D!FBS^A>cuap
zKpBQ40s7+nl@;O*2(yM`Q@2X*!A5*jS1&JF3RC|5^t3**$rEUy%BpeaA4@cx@GT;A
z<P{dCKYTF=&7#7N{JEd%Q^<`}r${*yCl9)VdAcc4fsIPGtD=67MK4=cmije}2pxGY
zaKJ1m_og&%SULfH-!Dz95K0xq7>TAEZQXmjZQ{)i+YgMZP383Coj3ozkpSJVS|__u
z|1gVwbowDBuN2`A^78TyI;HGj3yZ{r{Kp6!E@NQUj@k6swoT_|eY&6F8G8AJZ8?++
z#K;EJ?H%vu**<=Bz>cRr30M0HyN+?Tx_CAzZnkL5RH%x%Y-fXVTCbA(t;qu#EZIIS
zhk^=FFv^zNZE6c=vvZaegMchz3SEa>3gqxEQ^un`+n8Ue{af}sv>GZ+dWX7O#6!Ar
z>e_)cXx%Aj7$R*n_7>g=a~C~1n8h$bCAK!3um?oyz+`G5MOw#CFWZjgY{}9~3P;(l
z;?p_O5Je3!N!tEjzI@qvbry(vMWr{z1cPi?hXg{|(kKVlrIbWqJIc#W>irnwgP`Ex
zkwo_6Q~a+r4KSA#nnYjJU+H48N*PLzuK2*Ek*{&EmFacterbFRrrK69cV!k7s_x3H
z0hpj3o~*Ww)k><sUitVAs%H+f5=5$*C(ob9f8A<xviGx23rUt*{vKzyp3|pEjK@MN
zWK95f9X-7kV%+ofGd0L2{@=LXr_0*g#J6)ky;L01yM0~GCs#HPx~%@$J3NtKD7i7S
zArcobiXT(T6@Y9r-yOU1a)d{?fB(#d!dU)3CRDFzvc#sZ-_dn=8<=5=I-@tI*K-L-
z3}U_Td*ROP*$GZlGhI-s_^X_~YnE%vD)2=uotOD*|0ejG3G=tCPmj-%u1uAD=a)D2
zo2~n@oHo0eof;pY^zj=tWkvDMVD*xR-u^Xz4xFa}LC36Xds2>Q)oAkG4UVw`If*&;
zZ$;at{?h33_sH0Ji1CD>nelV*trK+&CvBs1@jpzIvbW&%vxX@1=<{eJggYHtQMKmR
z_m@&`E4Z?li81tT!*&m+e<H1c@PsG0e3IdxK*fyh;*{(lOHeG3ahfWb;gcpt!l0UF
z_HVkPgr?DYpju<4>_nwdL(GHF(mb@#sz=Ka4WpACbm&c@tAm225{ekNG=zT31qvJ$
zRn<mYV#Heop8^17#$>hHe$}K7iPECldHQrlR^_V*o)udIVZ`O>fq3vDxPT;hy6?Il
zkJ^;^t4O>Yus>~-^Ey;hVn@JG48Af-Fc2b_qFy`S-YV6V<`MZnZTX1X>by|<WHo;k
zlm$iy9wnERm9ftFGBK~1Hrc%mcCbI(O*crrl`gaHF!D8q=ZE>({e!3XAZFBnGvm15
z&VIDF;eq)>x{np+IV}YH0=Z(&oQbH`RrqywQ=ibQ6s2x-AQ+blGifRE0Q%M6KHVCh
zxzoOZOUXr+Uoy7K=stV%$o1$hTXnBo^!nPBD+-o&C+P?>;4FcXo|tS2nP*k0kwoFN
zK1MgpXARa211R3f!GR+Sms8h*o-X9(#!OzGb2usKJmrAvtXWNIM4dfd&R$w2-qc~&
zNO$5$AbvFP4$`&Csx+J%Xy2f?NHM0F8%<%4^23@H{Y!mN@~D{0f|9J*e%EXZ(s`~r
zT3V*@gBqZSxEIrUwp6*ZXaD{d=Cp3jKi%b6$~VPtGAq_&H}vN3wv?EKxs74|gxpP|
zBst{6T9l@dQ>%1Ctl3UAZR$1;4_=xq%%RMJiwZ{RDD){$Sj+z)^$9jvPv$!9UdvP?
z;+OfMFH%`g2$4kxaYA-IPMP}M+B)Fkh!8%Iiq}>xfC}I-WihAr5d&ZvcsJ0Fc)0WW
zb8#M`U+Bj3<d-G+<xQFp5Z!lzu9~cd*s){$e7m_LG=np$sNW=JGk@07T#3gd3%A6s
z7qi8A`L{Yz#s$*)M5A!C{l90J8E;ICrgPm?K`e%3*Vx!wP{p#+kD|6U>=hQP0CCZ<
z5Sh0Pw<UEY-Lf2qB8&jf)xDp0pj_4wBESZ+aJ$tBY8=J2N&&gEUDRT2b;ah3zNPG|
z-~tF2&ALOp?RG{+&R;Zqi5PZo+SHtWGFv|Kd^%sAc5+d4mT{~}(!!R$@1hq~vS2G0
zNgGtmOrv}drB;}Yc%^YR_;^_DjycpHAw(0CD3@&a-ie2~k8l_LK1QU#Lr?49$Eq74
zn6q3=#|f0q-#L5FCp^|gRsuxZDkVFleC&@1NgGrdzO<SF>_Eitd}WalZSP|B2oHhM
zHNi!t$JG;1d7PIs+K^qfg;dQAyzrmt*$iWbh;=`s(9`l#nKj@~g5U+8R+-cl8xuS?
zX1_P`uYE&BPMm`FiL^;yi&j;(o}r3s-SgIPt~900H%5CTIs%tP1ZSZ`2|N;EzKXvJ
z0cQ7afl6KyRWN<LjUT+jZ2m%5zYh80fe%MJ%_Z?3)J@5{lBeSL{rO&YMi*~>H=M3<
zz?dEznG{#jh6lE?w=e0mb;%DdJNM4WtAG=~`okr4D8m365==vC7&JSamS(}p#3#q}
zmLZ)KZ>H-;ULM%gW%UO|UJ}uKIYTL0p;u*91(}OIy-&7V{(Fx`(`1}VslUl}ipWYC
zCPT4gU0Iu=&+=OSy5;<%Nn~+J;Tai*3(R7bg>$D{i$nDKYTcndvCkC6Rc$6LMGTEJ
zE&p{YjX{OHv-{c0#~bX2EZ>AW`Cco?lzIDJmi?a=fbP}Jl?Lbb-o%sz)WQalImTNG
z7yuf<Xr>!M8vPt2(nAwr*o3c_R@Ad+4%u45X$k`}r{7eQ;aC!3V@0XbY+0AL56^Z|
zvwU)3VUC;ewYg`{1f1c3BcgbZ0{58aO;_m(Fi;!z^d+>rb-X>wEzyDznNeG9?>IWz
zR%|#3R|8M#EbAeL&`>m}j#q}}i(de<?HbmXo|J~+8i8&aWQgqbsOF}b=f#l%W)go2
zr$f$-kfZTI{pkV^9Fj+vqVv0R-@ZG&)MNTg$xz~}3cZUgYkIHT9~d`it0*mfddhrB
zIaRSJh`6!`b(MdYhW5wZl|H)|oosB^<Osg4Q1d9E=2H=hv3f;+jX6p$%Mq$@v*K^x
zyvbqBgO9yCZ&-XVB=QBm8hB}*Rq;OZ>IGVSkNaw%A9PYNKe=gi=QjC|w{;mdrJH30
zm1Og=w@65{SHHb1Ie?a&=s1b1_`SAAWBvgt)3H6W?*To486enHX+2#-9_=DlYld~5
z@tq9-a4%jr4@5<^1#v=NfazpeCR<y)XZ}*3uD$pAhyPr@T7%xDeF)p5@n^+ORAtQ#
z$G$1c8g=>^{RU12s#Fh#E-5=*d|OW?Vxs8DCs(>HTquhP<QXwLQ?xQT5T;1yufG(5
z&Y7B>;2XhZX_<{p{4!9<(jY<qL1rB4&cq#};bsbAMn+i%%p{=6QcXe_$|SzVB)yS2
z*oRYkVDtduK<+<lz<!&lw>ze=MM8E=Qik#*eOaxuj#&JE%u(g500icyJwoyJ?uedA
zVCVMjmMd4De)y;X)RA1>eXey|?Ra}Veh-Zryf76SI@B@7$Y!KQbg}rZ_d9&-*nRJH
zR=;e+jLK_%0p$Vva9R-L1rXcBZ=2TFg#`%wcy2`RCVH)ZYv^Cr9+>9J_}dK1{J(c^
z$@{*%zc_IL%$XWBReI8)@gl>7loVxv==${Zg|Q}4RQ>G@$5z5tj4e3EDgwTiOuG+V
z{>VC%txxP}^`}lYO?EKX30arm8M(IM9Zc0jzpu{pcN7Hlz*;IOjENlDo(chT0{0<~
zwX^>3fHJV(tjmtX<pI8cyAeQN&SzrH%e~Y3Y=Rju`Tp#W%;0SA%4Qzn0PVoQT~+Bk
zSzeMXK&#g6DC?}i=D(4hZpRZiIpD%`^tb7u1~l|gu=apDtrWc6iMm54Y$I$1FeyvZ
zA8X8Q)q^|Ic<sTJ#Ld-n+4Ok(&44)BXw#!d4<b0;g-t=baXufWP!WO+a1V4?S<j!L
z7#DsN+mRm2X8G>7Pqv^#A<mwNCCEyL8Xmk31+lMJ*#H~O0A;%Kxiy-MfN1&4-dy@w
zrTcS>_L5|T_c@Z46-Wz9S~u)>&6;^O2IF9E@(5}rIz&M3dnXp|=$rGcF>1Hj#{U*f
zhCcQPzf6cEiTu6h`*U>_^Z!sP5k$-q34D#eeI3dqnIdW>8B%~TG*C1#QnbQ3MA}9a
zU36ZlZ;!9kXs*Cq!U+2IpK>ORza>l%4WUo+(<8f$VY($B_Npj;w0e<YYy5*{g8`Ik
z>bNsbg97c7{T=ibE$zJKk4m||+vYC;<@AM^QTEU5i~=ToLQ&y-?et-whl9GWGuvA1
z7ylN?roc!dJL?x_|Lh`j6{PLfIg>}s)KyakAJT|Q8C40jv@S;X^1I%P!cPEhrE^3x
zgx>fjelKI#BYl=UU8La3>NnZ3$f$W)QYE=k_*LYFBZp3m8nPt8$85@y$wz*aIl1sV
zPZq@741e>+XzuMJ`_k4>Cp6Y>%63yXW98=S4jh<T{j{1lK;K1&Mp%tkZmab<<!hzM
z<fXvKg_)9UL9MVW9pHL?-N=QVlCOWN|CypUm^wP^UjCQYWup_bc9#7m4YS{KvC*m!
zx#D%t1-<N}w!IU_=|pC$O?myTjk^9K7+txu5Ak+@b@!6}2TVjk0I<HWFuNmnn!Pe}
z=Zh~XQQ|^=e&V?NV+sE}KEsr!k~UpH`;F<Mw|%&_!H?4`9bD?cZ6+&z;A0{S!@?8#
z<Hb!=G4$xs)?wz+>-O)TT<!IZgZCI0gY#&JYcH=IUyw?D5(vz&Ra4v&LtiQJZ;6}0
zzTTxiY|6y*yujyN3LqV(Hw0*o85NWOHc*8oKU&cenaN?4@{Y+7FcyPNw`E}g)G>8?
zAU1hQ+Ek-WsBCO&3f*oN%7_X8WzEkIR=pE{4aeX{R@%@mRRW!bSo^bYQ+f?aX=$^1
z?;RL1*t;==4=e{Ebh44+y5EJ6cia6Mi&4nI&bOk|wKhI9$HZpTD3RjRbHPgbl21er
zzJjbiX3QjG<*?7FxXKr37dm&H`$*6LN^BGYm-89$KNmv7+9XO;L2yKK=RI-2Q~;7;
z>1?yZhm%jWVUgIJ*nCNDO4>K;rtG`5l+T>$+=TZs?d9~lbE5p3p>KTGaa-O=cELh<
z&E(^c?bs8B^`9;~j?OQxxqoUS4OWx}Z*DA@8E)_BsL1aU0a#eg)mZ~51JZNqwgk*-
zePFP+4meChPx*ym<k_=+k+sh-Se6=<o4YkRyr*A!!++dR#PGFU{8dOw#6K?t)8~;T
z-wD1j*l+kbD)9bHqKwp>dc6LNOqwmyuRnp9pvZ9kqC@9E(Qat6$?-G<4H`FTBEq=e
zJ@_`2RPzE-iI^iV^YDt2-<9wkn_Al4fgP)`GfYXyzRPfmp@|c&MW`&!zpRy?1@61N
z;9c3g3DaGU&f(F~7i|s5<D$+$FSo73X-?oD%poUNKV*o>_wwa|oDav76oe9Gcq-Ub
zAJ2M!_{EN#4kM2|Kc`9e!<o@ES*S<-_G;<+%aC17fCdOj(6}?__2$!dcX%71KxJOr
z;r`@eC2i3xSm<1UuDKJOpMpENEKCA~@wS^)cxSu@1ppAB)RS(lKThsKlOJR=6EDix
zaXnqLPVC^T3l0`7QRN4(N7=1E3>ya@z<Arjv!6Ru*e#t%0|4JB1$6haS+aU?vo{cb
zuuhQZ&9$4-wC2CBJaN7b$QXzYorBjZCiEdsOsn1IeoO*vFUTVd9+1H{?437T<lfoG
zUAzcYV|L4sydgdwhkkZSjE`TR;2AM&)x^prRk2?mu4+q+WD(T-(hn34aPG4GI`8V>
zo0niqA0uZ&h=pg%nUD3Nyz*E1$(imISE-T0{gb+enWb&p_HuEXH{UdJ{)C31Al4Oc
z4xK=5c=`1Vo3Rxqy}MDGdoAzmJ9%u#D|8*15ov4qLyWPNC6Boo$#-Fv+V<sKDG4le
zLM{w4D>kZ|-tgPEvJu<A4nLe<nP{ua*VLH0EN1kl?*znwCcwbhe4vskph9Dey9P}b
zVA#S%0lP&oh(+P?JArAK->)`tsjN`(Mz%baN7m1)RCnZM@!eufblKDTCzPg(mM)d2
zM4s~wfA?bgv}xN=T~XmH_^V)#^4r0#()kK&R2jkE<dif0xL>*m({A3>4zu~QT4M_8
zIvy1si#QD@jVix*6O=WS={!Yly}6P{c%Z2k6vnbGBU)&0doX6;($Dk%VttcxvV$@s
zTXaVw&xNd!jMcq6*oMSZb?J)(uL6xv06ZfaIwftfMZ_v<Grh{=nmgJvd@QXx>ZjIg
zTHYdAbsI9|PwLY{)%pfuHXj)0FVC3`E@a>Dgw$8xp#X%-09-ILu`?<vee*Z3Q<ym+
zR&lAQ&xQs5_Bu8F(_xQ8CS(T?=(IUGE5!$%;3s{Z<%eP|iNtv@tS|=3AYGPgADce-
za4@MwYF5VYWamqTcQ_5IWd}Vwa<ONvehW2nW!5pLteta~OkFk38BzEKQ!S5=jrVc0
z#N?J@0^7d}ZHNCn_<7vAF$)^zdPu#}vgOtu?Kg_p6TCLFU;D%%Fcuts%6;a)ycW%g
zhXZoO;%Um5{Qk3?(x*%Qd$_7**yYQsS$>0i%m@5>{vJ3RKqcc*w6=Mn0|p*G%t{7x
zFi1bQT>oY+VrfcnWFEp(Z*m^Us1dcnyI+UesQw;88XcK__4#5X^{gh^@W%9zW!<!f
z&jW-x$0}gGN=!(nj^XwbO1*+A{(e>a-H0(?yo*nd8l)yY?=3N(UiV1MTK%cmiojvG
zZ_rzrA7fuFrRZ$qEfZP6*UW$C?DAo>jtslfFCWRU-+_M$Xr{J~w!JcGP)UNVt{TKz
z;Eo+T#;K)x+0%Xij=_ol+4Tpl9w|n)UIL?|kSO=qD{XT%-d1{TCT~*)N5T8T0Q}i^
z2961vFa<#rAnL5csXMknc6J4|=GeEY``8r=jI7w#XX=zkxa`@xcM}STdx!lg#?)JS
zI<i?}$fvh=|L_+ATZ@tKYHNKvT{T(tj?z?Q>rf!_uex>1b2TYUeho#6=G7F?gLTdY
zpUxwP`F?CF8z-kOJgXR<Ahk1WZfUl{4~i=-|0KV2Bcg4Ej%2THieFUmi`$o54`CEv
zW_##_5)0X}CK0*%2mF8@ddic{t3MC+{n#B94t@GrDwb>NUj487gFc+QwfO{ldkyDL
zae8gL{9{VF&UVxw0>Tl^#H&mSwnlYwrLggdfHP}Cu0I!Y^`Y;}$dQ^+VPOH(u=gxG
z%=5WXSWwVx>@CI?XS%O(K7k8*kVVW&<CABv66<Aaz#{!%?d&!6LmBlYCb3%h=jBJO
zWpyCCv@iG-JoR`4t%Nr9P)K1lp9%HNoKL6D{U3~_e=#8GM=xZ10nBRi&K`Zc#}{~G
z(bF#8z6Ifc%pFkHIiexfK_6HywdVJSbPt*TU7B$6<dCA5b?JLi$TyRz3lKb-y2<RE
zP||L8YVkyu!gL4(gjVzJWh9TP)D5#idH)2By}R!ICn9;(-I7aV`<jp1NLj%QwYdFZ
zg5{$$mvdd9h?{*j3qTL@>kU#t*q^JKxy+l22XdrtFY$l(H;*=35LI`K>H~fDfI5?9
zSVr92U<71?vp6*E+zyTYjX8gc?`v|8p+KfILEW#8ncKF4&)+`G6bZeWr8Z0F@A|Zu
zw*}i4n&(E7v{J4XWSzE-Jn$ifNh48FTGFbbJA+XSU4>l<7Pn8*!w}O~z)G%FSHCzX
z%@(jm?`h=35+;cwj4+GDj^uaE$MDc8vOisWRZ+F??s1*+0yMgjz6!^cx}z0bC`V%i
zIALS{L?<U1KgBF#dw4eUCs`Ag@l=<26)#1T%hR8`^*}^K1ba5(mTz4<hxRQ|0wOAi
z^8F>~4n?jxNc{8b<wv6J^~3N(y9nD1c9Da}6yWRCJs$xDKfNw%Nx>(R*+j`W#&7sG
zme4%0%6ii|jydXg2lX^6Or!*GTzS?!+7yKge4K*0l8^@>A<<8Er+6;-`l?LUL_)34
zz_Mif&|j=6SzZ0EN9Tg;psW88<jgRIsVhnNhP<d>rN7A;Kq(#i-_^`7;tGIy<4ENf
zpePs~v9LWmso&=w{3%(DjXc58Bw=>;cRG@D`%TUhBn|ydfByD>MX&Yy_HC{m_wdb4
z2$4Lz&I%3>>U^`fye_@`iLym&RGr=4q_!-Tc?nq$tvRCGr_Vok*~C*0S|Xba%@=P*
zI-%vBAB;eftz%YvfhoSZVA)4TX_)r9`g^BF@jlw$MTQUJHg$&4X>4iNv1-QMeZ8p8
zZ_fD3{r@rb9&kPHZy$dgGn)#jQ${3NDI<hLiD+t&QK2%6%#sxql@`kBq!QYaag2-{
z8ZwFs+1VYV$O`?R7r*=e|NkEMeLsHpIn?+2`MlrPc)ecN>!JoE_jaxKzgk>u0%6yp
zJF8AEVL^EG?yLVYPCS5cX^e~$2wqHQMOnY&dJdiv^zcaLsz{Cte7`?u)I;``@ALR}
z>{0@_kB0C2MwNq)J%>`|@m%cYKVNl5mv6JZPpV1UijG#sJ#EGF?mm9<plxgf@xi&A
zioSYE=LvSwdXua+lZfb37`99+2`xJHRAgl|4LD)k4oy6cguVyTG%z8K@g~mAqD8v=
zDD18GmpjO;D%Wmr)C)8%;!5)7NfV1v|1J!UeG`rnuX@FB+t2UJE3ugovFN-jyC|>^
zcJW^I=lF1<He$_jx+*fNO^cV$Ww{e-H}K@lP>N@c{GxmRgufYXA*+x$afizK2UQwB
zSVs5V?ZSl%ZDxf**~tfkm?Cxa@#<EpF1SLDX7*_#92D3>ADNZs>h|k5`HgEkb;Bmc
zf!CbVyjEPH9=?Gi84-th>~|sCugxMk4U@^{@vnw&rNVVVoyNH0dH$gO(Cfm>2PcZF
z#pQhVL=7S--N2_Qx54i;;5GY5s>pDj>V2ZksaY3ZeZ+8Q042d;y<sovP?V2rk@7jl
zjI>T?Q3F7kQ(ky>#Q%HxOu)v#$tnliekw85kj>?9x~L|Ey|CvmkS=Nv(hbp@1s~{i
ze33`{`xEvYXEc}JS?zP8E3gdJc27OMBaY51*i1Et@si*4b_nh(`E+6BFRKu4l<@7I
zH#V@QNe6wDF_QT;v+8haL*JILZ{NNW*IO%0UU7%wLbVrt|AE)c#Rm`m1TaImvA}oX
zexmc457$N#u@GutO*ntW_vaMfZImYD9v>TZ{RMDJz?(p)@VGb`S!r*47>cXn?A9QV
z9AVqg7VuYjMIjH2t!D5<x`&&Q7%<=*nX7waz`%i~zxkj)j9Xx<?UU&+wi9LJou`+2
z-Q^2K-c7s_J2fGszv7Q9P7pBcuJF(KY!w5jt5~U3c5IUeZ4W32%iFlzO$0M!<p50X
z)LFAp=(ol)>(TL--@~AKMVZ%l<G#X?&Ajxp7!IX=kySH9ZRQwKZ{B~i@Ra(in?r&s
z?wnpVkgP+@dhK`h%8Y`F6^>_D*CeV$dhfx~!2tau<UyM(-z?1M3BodW#9j)76<+*X
z73<XbpjYq@7l1stM3Go}$(%`AuGtfc4b3f&un~-HdAVdEHx=e{<*E(X^GyuN!J>>;
zyIlRjh!8zUUv5G4NS9#~;OqI1e(9?ZG;EYA8=(Iv+b&V{SXx^PI{@XDYn9JT-22sM
zDpZzulwvo1a_VJ6evc`?4uT}@vw?&qWQJt7gSm6AMj4g+mu>6U-k?2@rd67=LFKnk
zZx*(9R+??9aXpLCQGPq<-{7Io`Q+nn9xa;DSHCkOs&Lr1szX(%xw&`bv3Vnd%fY6Q
z{AAyK5>F;RI+q4goSTwDu{Y|Y9b6jpc^gc99>Z%{o!t)gWVH#!)54E6^Z=%i(Ugdo
z1uTQHY<4qc>VVzjb)w;mL0>`^g?l48gvye&g91kp1JjY{K}Bcv@3?r%2^GKPqQP=>
zM2S<eWc<&EE(0x;NXNKW3+64d;%IZSPvOfiQ?9T<f<2Hey05jm?G!JnG5*+b%czWp
z33v78<~2b!Q~k8umBcT*PiY;v&BW{)Y)V`hW8N|PUqhsNpiE#*J*$8y$Ld5=&S>`P
zWwM}ENc`w^TPadh0iq#3VF;-Ge{nFX3Xf1jasj}hc~;l{!JL(7kGaA{<>N17fYp52
zgG(v73AGtYtK^&sJwfaYcq-h;x>F<Hi00JO)9J;kdjAtU5!+WC-#N@u0yoIH*jhY#
z=rSi}N;4w+Zw1Aqfx!ddeW0KMc>NLxu?12F?`G<CdObwK4BxskdsVYbB@3u|jgi|E
z{@wH(BaJFqu!U>=(AVFe>Mv#3111#RVaW97>sa>$<1vUs8M31Rb5TrN&X<%}4P52v
z2-S*#ShpWt9SNLhB<Xm*(8_e3YJcvx_-6bI6?U7$!!_;xG~{!aF<&12L7q*$e{5IM
zpML2LsqKIfHD#29yOE<lejXux&yWReD+lWva}q(NTdNyJl?+x^Yzn2jo%!OyhMC<#
z*HRzMT7>9PjM#tes0yAg8Es2@Srz_^DNM5B8;js&&6<-=`4mnG1P~+z`?p4<EaC3+
zQZS}tZfm;iBGlZXpE~F>D4=u#W37~c-wu^z1U`5Q;4A7hM7HBvT##laUbJ<b!PPI~
zR;^gSccvdQ@07Kt169{%f1&`PVVH4n?5+bI^p$q~0umbRX3c6#<4j`!!=0-=y||!Y
z!-*5C7SB!Veag!HBEy!Rrw4JwD(8$D2@aG1K>ohA*2Qn6Gm#Cbbev9f57whAO}Ieu
za@@upf4QpVMbErBv97ePJ3{v&f5C?6hJFZU_HjRRNgDnlr6EVsZFONmds^HE0APy$
z_vJH|X73tTfyB3?3}Mqv{MweGHnnH;u3awJUDBcfj9;Ll&4>&LYN&tM0MoyNok@ps
zGk$lYuo0q9l_6@RZ=7{Fm#bsRE=(F3eS6tcxIiZ-aYO=CmsRbRHMb&Q`C<>8ymq{9
zHOoM&mHtQ*Qzx@2Q*K%6gq}@FP2B`Zi^2@8vuj*H^VVH901oTvsT^E`#KrfGakIr@
zs?LQ*_nj7AGuhl+MyB{RugjJUk+77Lv#@q*1`q^;U5rnZn!9d}JusbKzwFCQwK^En
z4ee_$SD!-lLP3>;&c?~SeAFw~ANGF22MR$)xx4*M7oC*MOwP=rWtA#^2bR9DU%B%5
z<x}67w3?P&)`q1z-G*^CWd8hk(xJsNx_JD!U~vrNXWTvI(+^_mgq=E2_G)wn>#NF@
zvm#M9!EctIK8IU<I}woJe&KjE!9qsW+}#g3<<C65vJD&v#}QRf`om?Syd&~JVa=TJ
zKK1R0+dEOxa0x{3s~0n+&xuP0O8j{WvQ!&29hL1kO<EzB+Y%Rdzu$cukJzn55_lm(
zt7taLt~o(C<g+lDvGZ++@2Y)E=B-&X0+-Mxpdzc+ta;@V-oRYV4o0fL7Kj;D+{8tu
zF88D*B#Ka`dgj_JriLZ?1>k;lp7P+=8blWqJzs#<kJiRykPB2D_h;DZgvZ7zq8ev@
zmjcc1;KLl)Fqu4}mH7pdH;<XJl|SrZkWbYJu=tPqqM!cE)<Y~&L+-w|GVbZ27nE=!
zw4v5#uwo0vVUGGMWqfeON`)%HYUa%1m1@WE?GTrwV-?wQ1oLT3Sx3~;xCL+uI9J`L
zRR>|9m`m<}2k1(rIADPxbj)+m$#|*{llhFd_Z-Kk4FC3&Izxt3S%ZyqAu0YHqXx7?
zJ_kmQF+D+#!C-t>nKW42Gm(JJP6!tUWmWekQIE4?WFx`>o{|30c9B?(wE}ybXw(Yf
zvunZ5?t_L5xw+c!66uh&Q!CbP^jwZjyH<N+Tc^OCqP}Utbl}mQ>1#?)e9PJ@A|4l1
zzCsRA5n9{SWVWgd^W1bcZuYy}&wo-t8Vp^J{P;xe8v`DK=q-_0aJC8Bc{y*c{GS$}
z$A}RzZ?v6;u}BtZ?l<jsH1Ga>bqYHBuXW&<B6l$9Q8FiW82TAm4#sHninHy5`@+8P
z6oQJJi}5CdXK%roA!?PkI{ego1Ork{f)n2p-5HE+437v)#E9<#w@|P%SwIKFdT&>)
z6Jr2z_KGHWC*-Zv4Z&+IVEgtf{Ti+t_-hBd_+2UcJ+&*14T(DanPnNH=`xGe-gppG
z|LCmtyfF*eg%JvC7szSGI?<~4TymKE6VW@me6F<Y4`mD%XqsVpGBqicR4*1W8J(@L
zhtWWpuiEV#dx(fZpo0`7{nFIW+W8>mU|+2YeJ$J=YLJdpQpq)Icxf1RUH18ucP?NY
z5(fH)zI`VRT$S-y|37JNVD;au+n=c%4hXFRcZfph=Jq9f6$2V`C?`^(kpuZ8c*nI3
zPW)$E+ST(|ItLMsDWhbENKug@R@yEjr$^$()Z+i-EQTH|HYY^0i|0U5zPJTJ1smqN
zZ%cB7)CMm*R`LAxUt?0S84lo5ize&KZI)GF3qe)T3<%S6mC5`fz(|GQ#AWPm47qBB
zBp9s(DEDKoeA(?$Qy9VAf}o3Uk$-y+Sx^>DL#w*R1<&pywOD>w#qBSDT^{+nx>^1r
z6miby`>Rk8W`@VD82-(^p{zX+;#l;Zd=vU(t>2|Vv-(!%@z=5t&>Ra^RILKA)!g#(
z>Fbq4fA?LF5!4~>4gwe8ILK&3?)?F&eMt*PYac~YD6Y7`Um@DGi=N$3*eCuxW4_h*
z6K5S~_k;+i%AU=mOr)AvI`dhYt&T7OQVBwIQhTPWq&I3%Iq~V$&F0YlxAC=kQ^C<~
zVcY^k#@JD^Zbj-JC?-@hS%p<zwjZ$7FJE~R1+vVTSBC4e)lP<I>r}Rtujo*Rx4GZQ
z+q}y}QUj5gPG@b6<M)H{>r?$4Fm*2e_AdQ0aQ$Y|6mNn_-NUFNj`tkwN#f?uLmakA
zsv;>1)gVJoT-I?dHqu+e3hj)IEn557%Hl-zxrU!Jl0FEMN}(vg5Qx@Cmqt_O&h0K>
zE*uz1Tnd7tHeWdo;E9>5Diwxg&}T5R$$Y(V&bLD^mK<gm%K3{I|G;CM`Hy~;Uatiy
zqrLO__N|_Z#pn3Wb_BF3z0>aZ_xLxk19Ga0>Ipi3{Sr%{WaE7E?s<~H)L)+OT}nfy
z|MNj+8x(2~;BF(gPK~(o3{%2?@iMnFdJX^qpMx~FVvb&DCNP$4t^uvWOd_$w_%Yp(
zR4uCA;*%PXn%&@~4j(x(=j?WSbidq*%#!$)bgM89n-aAV!Wp}M&=(7~xm3ZcFDwDH
z!ppQZArlFTp5f5<@7ls+ASMp2$sS>0zx?5(vUTcATnVHhCGumptC2=!{<$rsay(oA
zb|m=Nao0m`Xl4+XVwiOK<;}0h5Is;KE%c2RH)c71nd>h2+k%|YOwiLK>b5<?Fe?}I
z@~JhiBH6Sn7$kcWeix6*4AVjP*m;Z_%UnGrGGt0}fLq;2B)4RF))HLvY`eJnL2i9F
z4ZsSoKk)H{G7)S$sJ|=rutEF<635qQ=cd@gUMsk`8>x|0t0=6FwOcphE+9%1STExi
zP))6mSZc9-47;E<D%*aZFtfD}9yWBzy%tP~16#_v;YImt#Di4ed2vH1P2N87bZ>Vj
zoCP^yh-_e3YnasKNaFT1g0to6eK3{t){XB$N4%M52P0TpD^QapowLz?<8d*U;*Q(0
z&^MD|_q*5Z_ylWjc1S;UN)@YI5I9~tpI7$YckTZPJ=x}<ph-EWf3CYj%*Js~k+vgq
z#@Zp)Fi@c6kU^+-U)v5Vk*kFMlXi8ETS@0mWD{7_Q+FRuA}~v4_kx(WpH)vJBd8?O
z9n8!h`-inn7xNb5r~&zaufNxGozQ8|MWOv)fLj5lM@lcCz2iwQ_s6gQHYsC38uOMj
z|A?B;Dh4IANct8%G3)@eQ;lB^Kfcc+w%^3(XLebq{7WY+D~re>ht-=iUPkjea^-(F
zzRW~$1f7d6NHu=4Gpio9aJ%vGNer)Ps2qG8XNZz)ngsV7r;T2nj?H}k`uk}Ff8#aV
zzpVRV<D5LLZuZhV<v`UyAr{-`IgRx45w9!%hM$Y_Z*=h+aSrVVLodflm1`&g<iZmb
z4UBdhIkG+$APFzQqLoq2MBj;4{Z6Lg2%p!0gQ|B7w@8Gvf<bA~eK-~_-DZzOxPUw5
zrn1BkY7p5ui9E2ZvhDH^ug`Ct2^)aexu5ER6i8oygA_v*FOQFT&EHl+g2rMs(^0-(
z-bcS<_1$$q0V*tu*o)*Ph9UrUmYC0++B1U;q%@)H(@$GvKOT@%inW*f)uA82P;SIr
z5*s*ET4=CPv7cJI%Ek^6bWd6nKo^H2Zb8?+I}g1~L}$T5D>T@Q$^QLj_zp{*Xfb<3
zTzc!S^(YQG5B@wM^3n6>(<`-DZM#v1+n5<hxNys&f^j62G*cIT;5xN<cjiOr)c#*A
z%Mjy9fq=jXJ0w?d@EtRA+E5Wcc<_J$hdG+b>lw4#iZY6aT{nN5YTFz<Sst;+6sf<U
zsSK3KYE*m$KvWS>Y>I9zs&T+rN!?SX$Sq);0b$LVnr|<-ZIlc<Ruw#V-~Io>+Li|g
z9W~;kD_GoYmff!q+!HS6R{GoULrI)oHlI!Zx;(%^_xbUkOC}=CUjRNO7(KVoY3~Wj
zC7ChclN=k`$JF2V)13tzhSHSkTq&o^%Ix}`zD2tzT{>WBMM~3Aq-A7@+b70<cnB(v
zrK<R!xPBl&GW&e)xY>@RZelFa!fIik7?^#TbLK^=PNAup{A0I{G&KUqfq6b0+guj8
z`of_7?@)RM2Q!P99{pA9JJzkM?>+jzVfymM>2b5c7mp|DGtfDUDeUny3YAt4*^qEN
zxVUdOE-=y<`y6c>?9R|Hv9Zy46a%H!sTF(4svNUpM`CC1)^#|nKw`@3e=Qe=6)y5O
z<&-|;k}ZXQ0Fj8gtvdH)HkfLAV^!y)E7@;?6;T5G>eW+owk+ll6Nfanbh-8EFYfX9
zv17+>zLdbjVaiY6qGG)Ty8(Fti}JI2f&o*@QI6T99SZCJ3s7s#pTd~XcX9qeKg7(_
zD?@r?-I=BM<FyUaW+q#hfV_2j*+~cu)S*;azo%_@<@}e8m|p@On%}?TbBPQr>nAg=
z@1+(+kxEPBLM`JIf37cO#vtg^iHZ}ZA)*EzMgh3h=5?5OIr4eF_&2<3@cMi=_M}+g
zpj@X!i1)1xx~BUR<a7d;h<efM{iAUiSJ&0OwnN>^&j$74!vW8y{a9a54-cHVrTTo*
zHlp-lpg~wpsHeF!2Rc48Y;>Z99+#zE0a3Bhk&%eM!?^MS_oP(b*e`>uLl?(xweh<B
ziFseNsj6Gr3y>0h-(6^Dz%Q%n58f*(iAOMYl0+Gdt%2|YZGW_V;Mp5RzVu`gv4F39
zTpIlgD1|s6jOj{u-%JK)jj<7C#%;&U>g#(3|AC#;TAy|YPTm3XYth{^zMA1vCYWZ{
z47~U;`R8P1)_HCex7HTj3yO+Za=lrk4{mPzqjyy;D%t%Zjh`d}jH5$mgCodvBXdj{
zS5w-t_-P}~4$M5x63<!p*z&Ir`^V}N3!ws-TEX-s$&P0DCD&$iR#0%TF)*h?|9vQ#
zwLx(Cs}5JrtN8mjRIJ?e5c7GCXa~kU!3DB+{#VCvn*s@pzA)#)gg&zNPdnK2mKuxS
z5P1&7B;weSwQ)BOQ!R9mWiI)1q)^+mdGojy3~Z;_C=@}NVe?D9<%-x&R)RC}w-Gez
z%yFB{%rC6dY0q+P8R1y7+L!lCHzrP8ELh57Ky3c}Jl0gUZQHiZ%AC^9B2>p?L*z8T
zK2#&fq35EtmA$RMBx5wF=c)Ro?#z8#`yCo>L;FoMUhaNxxmA)SIb=l4wvZ3|>sniQ
zG5sO>3|zcO4a1i|-{F*x(t^+M80m1irSbg(wmRJ-3rVU_*DDTm*?I9S8Cy&<&;qSS
zl~C!W@cs08S8!6waMd?|{h)tFR-?%h@h$BU*Wqof?=egh&IY}lxM8Nh-E+apnP-Gq
zace>^1r<IYv)*jg8S~>~C!pXM_2IEkaz8)V%<S)HBdahF!jyYA+~}sI^;fa>y1kE5
zAMGhK7kQLQGD6;evW2ULpToa}C86>nhyub(AW3ImT6<Uu5L>61rHKD!zL(ix2Y>(V
zEXc)Ct~}UI#=TI`@t@uyHda=R045-P!V=unETnF3(s*1_s5%A@a4jbT_O~wG{cWJ#
zEql$PK5DrxZ0m53?M;QT$kam?A_UDG&<79n`6JD9R-&}?#u+Dq?Y_rGWMpI%a)b&g
z=FO<CYHDjs@7_DL2=<~EIt&&q2ZIm>y&3L<*+?V^;~t^Q!5(68of<*g6%-csdm`7}
zj&4GJOd!7s>M+Z947LwyM!tL0@cFk?x<v8DyiFkqY7+Hcp?urI^Se0vpiFA4fZlaC
z3rr-Ofu$qFaXlc8Bfej~dvpwPnDW)1r66X=iOet_zXPYsg3!#*$I#;`XqqQS+|bXc
zRio+b#a<xr{Mwt-#&p18ZrGp8(WFQ0-pw8}wK_IwMAEz;ch#pq)pEqYBPBh(7YIyG
zI{$xJLPHSmz$129y!gl64+cyV_qmphdhyJs>I|o2Js2(T#b@mU@}&u!-<>EztnBSH
z_0TC2R4pTFJ5jgogn^DgOB_L28c7YEt!}ZH)b<pJsuze<Zwk*oT(MqM)Ap}E?;gO4
z!JhGcpSs4d9n7O7u_?;jJ}CA7#Z-sE@HpQOSBLd7G>nBNKdc_jAYg}o*~-D?3Wt>N
z^jVVaFom)ADFm8v*r1rvw-uuIs(ZdxR-SO$cT#&q(*MN6u<hi*3NsUZt${eWlXDo!
zz*GPIW&L?_a*EwJhHlWJZVXi{GJW!LC+U4B%AcL|bP+(=N0vS`!nm-&v$s+FG}-&-
zGI#Dc`PJ0N1<=V|x}Ii<Hq%OhR0GlM58X{`Q+m$dUk|ZdM`h)*r`J<_jp7$QJR3*G
z4+UvGf@Xc9_wqfv<Kw46W18~7CP4QhJ#YQ>Y2>s(W~=VHvQJ|t%HJcj*76D3>@WKp
zF1!;HWgOs%xGv)k8`m@1yb!LZkh!D+j*_Zx20dP3QBkS2Ug%H^&>~sv86?L4T<O2X
z1cFR)cvl}D?d{6S$heWKBKW0;cWqAU1}kZbvxGU~6$|<`l&2NnUM7VVF!oZwJ(=X`
znR@xf_K*-Qu6K9(+8*8~|Dy4FbL{#6eOXKWl-&Llb(`n?b4!A$+2ljwLSlk;tdNfU
z?jbM2>^Rwn!!p71%Z%Gbk|F~EZEt1k#q5x$RvbSjUgi}ZyQyui^S-2AG0yh$ox69R
z5RvDPoVc04-pD9^>5a<KuP=VBL$8`$YIp{9KZn$qdv(k(E3*}AT)`*qgjyl0Hi7kK
zl;Pv4w8=Iy<*zis!>6Av!*L}|!B%OJP)hkfTSxW5PjLCMwhwD*Nf>J@47RuA$TF|D
z^o>91r!xYI0JckCTYM}Q{}MV0TsO;3XMFd6!>ZUV?T=;Im?HinCCxmy-uam;QkI$T
zhCaTh@iwgc535U<Ak#5#29LXU)^A2e{FvjnR&-KkqKYj{Y3dn!UvJY`zrjHl<ag)Y
zxXjzqlfiRwNN{CgP<>PT#=u<djo;JE{hAQZzr{-XK~w%76;sywH{L{B#KPM275a-6
z>DQr8S!&x;Q}a>Ciz!Gw|B8!4?R+SC%c&}a&nOu9E^P??mshHVwnedG3Uh+JafZ#v
z#&irVlqQVp9cke47Zip}V1SzO<I#mM^-^-XZDSb>x41c+RYnspztDfcZ4Zx%k`)TT
zJaB7>{r44Cy?uC2gCQgY7p?cZ*;A~eQB3YMqvmxYT6K2eo~bd)1A85NbH(P<3CljR
z^rI_uI*cyu)<GNR%}kgax_P>-_t7ejHcHpAU;&QrqQ3T~xZ%^#2|Dflz<UO#6$6%|
zv#R%5YNHh2#4do0YcpKI=TH@u-2aNB>tL6ETToE#`2=;2H)3W<e%6c=Z6TB=jnrB8
zGtB6ge@bxsCEM3*#^EiH`<0`fG!7JS1la2B&;+Yf>(|>&pI-i8(A<l%bs#u#Mds>_
z7BYkaoPafZ@yaMCI1xq=uKr9AR*1y>_oy{_E0yG+8G;QJ$Bq0PomJuck6X?L*%fVZ
zszc&+@D`cDg@$SLW!1W_u)!jqqW79V!r57TF4)P8$N=8m&Tu~A2?d+&6em~s>yT4t
z)kduz#34&BAFLK?WcAtT8Ynj|)`)R;u))b=P}k+azChw26z$d3Ltt!k)Kf|jbcg~%
z_$SI?fQd^0^fh9gDT)+^GTLEq8=NS<8py5)R=J<vjbTCup{~?K4pTE6Ndv<DRt{EB
zU<N|glhYL-24b1!aVA;tk;r2b0&czT>=H&BQDeBTY_&ypPO!ZAe13j&OnVpQKYqEf
zsK{JAA}RT4L>NNM5I;qIi}5|e5Bc09RWQV~g8)paL}Y|XleO2eEx$$ZeDk1l!k>(v
zdXw1I7L@`G0B$yz!5?vo*RaFdH}U56)wVuR`gGTl_JAE|wRpU_*$IU*^xfhD|Mytb
zj-*LKO%N^x1&%DVbauYFa=#(#Z5tc6U|=2TTHDE@aVFqWiM*WfhX%I`x`q7Yoc00D
z=LKY^)e{o2S)j0Vts6a8Mx}#H5Do5k%EubEF|i@6%KahpZ;yd#UREv4^n#!)n3MW^
zaz*vITNl6}c0%)a1Gik1?{3K{mqCZ)uI^Ep=w**D7C~R#g*y}skHB?1cRqgCa{6=@
zM(;q2eMG(K`EzMmNRz~#>Uh#&dE!2XN6{ZoU9JZ+hN3w6S_MO`q7Q3l^kqY`?N~@i
znRAB^&Dpilf<R8S{}1|H-XU0G`)=J(jp9z15h}9tH<g`5cJ5QXt0<pkM2vGrXLX_l
zZH?QY^unGC*qb<FYv$n3UXVqD+3-iF58j;ns%Q<UHV7C1x_MUTb~tcr5=wrf^VM;K
zJPV$A&phefR4}fvFjLNXi|$<OMvWSonVHF)F-LXQI^PKsnu;(DRUkT8j}f__#5s|$
z0voo-w2=ZXW#ub75tqwOFG>6jpnxP98U2i2vVnpO$g8Emeb&Y+zk{7{7KNr1K`J|;
zKbj%VVeA(oOPVycbf=yiMvnN{ENjUBh%e-zfQ%6DJ-c_`7@c{DE;j(#3E45D?&OFD
zQQ#F6$d5!7*0SX|$&QMrq3&A79%z%OxeOMGJ6yiEdhKE`pg}FVf1x+5_OswitseFF
zRONfiZ+(9Mcs%--&FwewyFk3d-k4=2TWUXg@+8kGQlsr@09%=ZB822RDXqfd5}pqL
z+1=*>#>nH-CM3dffz+L6kq)B_<2~P=9tnFlY?%GCDj8K}(6>$RszLKmPI6N{O1p@4
z6rY1Q*wwtu_tn}TyA1_!s6{LB`uk>YD*w&r!qci>*h3Xpx65ObTWcnyj@fVTb|lQ`
zTMJ<K^rgz0OzEkpNIzcw=fu|$L~$2j)ZYT8=>!dRU!!wVAB#^u6PcGhyPHs2L+tsa
zemFifxBl(vmy|n;8-+t-6~1|bp;Tj1$1(d}8o&6JQCP2rWc42~U?NgDJZ>r`I*&(y
zsy4pjcKvWzVj94vh+!x;92<5dG6<)~@D<um7@OQ#JH-n{=J^Q6PHVJ30;_@yjm52t
z&WDa;OM6Nm8CU~p!^e(RDW=Hv0qia*uFKFxdzwY&r0v_MfRyoGTd^k;%?`_NaC2d}
z`xp*<GOmTpK?auIRAAVo$PfTW`|zHrr@22ckAvB_YCC=U5%q0J2MND)PASHbObm<i
z2obrD(G_ZRYS^-siO+v~cOc)d9`lF6NcERh@9g}hqqs!FBUVp|+90w$h77T(`k)hS
z4sLi?^Z1-x#xqfvFrkG$DMzdih>iwdM(rn!V352~g*2Cl<4HtBW4c#hN8{?Ii$Vrt
zP6;3jp_nv}YeJp7*+KU*4_Bf#TjTbjOLscAZU5CCC8&chLe>GO-g-GIRa-~L7=K`K
z<u3L6$P^wJ76^s9lUcq;D#QF@yV#(yZq=XmHa{C0efL@N`S`&J+5rVleGOv9Z8w;)
zLn~s^oryb=x2Tv5-qmHI<7LC~S8pHDa?I&H*zNkY3QObTfuG*uMZaymt5W~Z53Zja
zaXmk2%)NEjU;H>#;e35f{PlxHRniPlJzTm{Wm>f5-H+MI-Sq>f_vAI)I$+VQd~i|J
z-+xb4cnMIPo>ZV5A3vL7=E>ED3xr%&mH8jdX;`=tpq1Xec$HqW=FKCa>JGbg&3!0*
z)Fd`lE>NF9<lD3Q+sD3MYNq59laFWDm`t9$U1h+`0^OT%>OociSo@#%Z9}ndW^ccn
zJ>JH68z05;qCDJOxog)+YWa4a+io)6(Q@p``30(=re$1<(jir?+9Ymzotawig~m)a
zGU9{q3ORw^l-{!eL(%xj>LXXZD|^ysVzQ5Tpb+ec30bWiFZe7As-S%YdTYi`4uQfq
z*?>}ma=4V^-&aQ`n15vV%t<;jW##DW1G;AZ2TbBY`<m|RD~_4^AYF~e(zRKhikS&D
zUQkk!?N<1;-H=k>{#W}`W9XxwdSFo3GO9wJR<DjF1d`Rumn{RkV-@*CSqn_Vtk|yI
zL1r5|C>%L_cpvS^TAoz(9*vrhAA50i=ccS_y86TOHf(W}&Gh^fVs|2kIAFdM4QBkB
z-VcKus&5`_N7dFcCvewea2NUUNO}5w7z$pj318gwK*xeSPTwooPpu#mV`h-zi!HC)
zYwX&Hgs(@ncH^eu=E?GnSjKF7_lJzb_TbMUdbe5qhW?HP&)pf-JZTVQwC>XmmcXy6
ztN)L3mk40O@A&d0{WWLCjodP&ZE`Q##aB$or_>Io5$Kccp!?C#wnKdVIURHN_8AkA
z3l|m_@9^27heV}AzE|1$=8Bvwuua+RIqSa`0PhC~W06R?mad#~q#WW5Em5bOZ_+B$
z#5$c`**~YXZ$wm-iGt2i-ApQ8+hJ%(WK*(<2~GjM5JY2DHa9|x1$jucm?I9E)b~@-
zl>gHL_!-HrrAGU>;~!S0oTeg*bkIEj_;2r7PY2y;!@$4$o^!dR$hls@Rxb0h?j2Q4
znwG`ueyW1%-o?J&31A-6Q<FpDjr^RB^jb`FQTkTFpUv)^j4%#Tz_xAntLqV<+@Mot
zV|Suk%Ia`469tl5AX->Ey^$|z^q($k_h8_5EtT!EYSO!F{4q|s4G-NhU;EeI$J@8}
z@bRPGHavPb`C2zsRcp?*qp5Wu{Wa})XBOSI$~oP_&69$Y1*B6sQfI!*EG{Za<d^RD
z9l(~?NFckcy>q241Uk{DSTDCq&EP?@##5VB+>v;tGg+@UquHrLhXNU=a_ax{96R!+
zspb2v>{^%QO!dGY+kMjI8Xr;4kKHnzar1Kh>US}q&iM;KQ?K-3&MZ6Y6kO+uwTBPi
z<D;~3lYlvFKeR4hRzHHEmW=78p2y{>>^sKr)O*#c2A3SSdE)Ot5xx3^lc>-qjUQi?
z(<hT{D6t%{v>!U>%7UmKM+_fc;Fb<#Fle3g^v=F-8&b6s#vN6?gYgO9|3l)}EPdq7
zvLMxP>%E$~uRuK$*hh4fG*WJ5KJ%<^4DzwQdU_E)O0&d!GAE}ouH934PX~$gI%kH?
zzDi%r$8g98&})2v0lO41BdrChKS|}qN3cK+=kvUR!YS4}d=$pL<968y@BF+`t8!G|
zlL%VW1Jhp(hI(jme!=x!=NMY>aCf);x?^#|I9tp6g`Q)s(a6c6XLDMn?Yj#+D`d12
z@l2F3n>@NE?Vo>s?O5#*9tcL@^t|I~1jz$(y4tcNRZUH;prT?oAQfK5c5~}P>E(d;
ztZ>4Pdi~XA796t{(=gRt4LOYF3?7XRGU-uUS2yqMl;sofYHF|G3D$mWc0ljZqvNO*
zWdAA#8&?cN_o=cTTay>^x+JMNbeqnZ^)$3vy?WuB)!D<-GlGpbvga6QzZ9@&^O~O@
z=XPv8Z|S2)dr4Oj94)@4B}>%$BGE>5dBITS2W>QlcsjYBP2*QomxoYco;Pf^G<VI1
zt?(!w0K&<$&Y=)5h2D{a1TkoZjiK4>+3~W=uG01SY@i@B-j4m<@0)7(vZb1Da~JVf
zwYDABJd+GOZ|&o-3`z0F^?_)$AHb^U<FV!3Dc;MOxH%pOB${l%;Wf-Us{t97nW^c)
znUhOeeGxENZ?CQHkRg$)avth*JNwDsZlYtG#2zi8LMdhmtnV=h;LP}7Oao?@9a>W+
zt2u{<Zf1RGwYHYP<V;)R;{1dln_e}j0u8xTuvot*_yo0}Ic%zsKI6pHgkxWIDafx~
zyOu5%9*u0Ecd<Uc#Mlv=$O4F)LkdNeBV)-@HNGy-xYFy7$slL>C<_u&Qi2exBmxqp
z_w;+hRes5O0N{V7zEaJ@T;1JUgjT($0<_NZum9AaQ7Tc5WB!s<>H~E96%3%Y$eI<z
zXcwq={$GcDhlk3{AHsx9=+^metZ>-sldjk)$V6lr<j-taC*D^Z5x?RjfG$RsvCzzp
z#|R!CLtuQo1q0|1d!Uqn24BsVSY~>d^=L_<hUjop)$o9)FNU`z>x)S-nEeK1Fafvh
zlo%_b#bBdjj8Bvv$-5i6cb396UElCym2h;p=+043o5_CC?MMmpu3V7`8(D=YgCvH#
zW{SKBEEUbpzwq7SGhQCvq)e9KE<+0ao#COEtiZ;CS=stCA)UqmQ_Yr)W-r6+Sk}w&
zafh>I4Mcz0$Cp+p-gkbE??hLB8FXV1jTMY-PH56c*`URD(dPjoOuocSbq)BcCZoN$
zkfv8%KqG-Yt9)_}<4|!>8na%FE-O9hJ<E#QGSD2tbOZvwy2$Fi1`D^6{i^7uT9>vg
zssg5x*C=+CR4>wS(=}M#e)p$iH+}c^e;WA)B1_my=u{)8cZWWvRouF5Tl4DScGJ_Q
z_s3?yg-(ObJwbWZs3`vwyBcE1AiND@LaO1G!N+6`<9yemQlw8CI5xsj3`Y}YT0zp3
z@m`T2C#0oa(N5ThWUm&F%>j|Hn5h9AX&2P_Q)caM{7h3nP^UWyRADUDb5*b8)5{)9
zhvAt2#goO;DoFbt-{022bd5*{uy1_qck^4tRrW_w%UZvz9*(^Y#d{uJXshom%iCnD
zbBRYlk6d6FOrjoC##SGuH=j^tiAYkjW8a?(j8Rd_Odrr+YYn5BkLw(PF7x;kME%xe
zlBVK-PMPMA|IGwx2b%m=_*TGXj<vAJD0QVO0%iV#tTnLi8y1`lx3t0wvJcIJj<YGn
z!4$xFSrZ5=zK=^v4xXc)a*si7QHQl=90Dd;Kn{cj)eg@h7$F3od;)TCk$YZp$f_q(
zvh03Rp@F?XA`>@%qK;U9NTY+6S1c(34P_9Albimo8T%nwTCf=%g{CA#wHR`PG4gaT
zc!P2)qwQ70;WL`a#490|Iftmk5<MOqLG}{f0Gr5|qC`R*w~5fh(aAUbyO_862j5v_
zYur28ts=Kz5A+zA$|gon#nBjiK5}v#)*mjc=UKL5#TLX?AU#|7ymID188=dE6|N^L
znyTTs4MuD4UgbHjzw;?2k_t{lhSl2UL4nJ@yq_yyhifMqDlyC!Ya7<S$mSjO>@Bge
zsv`JJcRFVNYRoF`nrucSZ)S()&7dfj#ZiOU8!;`DRqtID9#PK)hiZM<1feH~8v>fK
zOl(bi@GlO2%s<65ko9H)@N)<LqC1m$qdf)-r>DFdS>%a?e$b#n;$E=l);o0P#~0n%
zM4UVS@Zq_lDz+~-rI<e-tlV#pTDQJg?AVgmEKB}q045K3$Z{Cyzg{=DI&S>Vri&}-
z<CGNePuQ206^6k<;i4(y>hd108a6J5qN@3Z_%?|gB~vG-*g>1MsV3Df(9Aums=8=c
z)Q3`{gR*h}a?80qUsAv@1Q@r{9Xs)+ZOw9FU_?hN!IG@4WNp)xQd~B-GRolcyAz^f
zkVSGN!xCIldUvH7_JZh7cRoGc<NCL(9o%hsk4y|-=6#_uY6KkgAa0pfwE5##uY$Pt
zF2d^R>!;W5As8hO4g3@Ah??;tUtjF!o*4qZy2x@p@W;(n!v&`*p18z_Uo58CKq#WX
z^sRq$;vYs|s~xmxyq1wY7d<%BmG3nnYgVqDEjB}nEDK07pJZGj83q9<WsJmjY7qgm
z2*!}L(G~APc%NciFT1|beMfTOy;rWB$m^}{@~rgm-0>19@k7}&YK<QG>iz4oe&yNb
zXzRB!Ix3r|5cA-}Ig#a8ZT}n<$jiHcnp*bUspk|iHz~%A;`af9cV=Yv49n5SJj+Cl
zIDFkFU4|qE=4>q{uaOd)GYJSiZ%oyS$2G8G6Se~?pdfb#MM(kjt5gB5%_lgDu(i5(
z3BB)JBA>+cspu>WLrcjrCaecX=hG5(112hpFzH%3fwgr_&J&Mlr^H1$J;^qP`UjG%
z_=;<wFIo<;q>aA~fqo`clhL>H0a~<49L2@_lkDiic!W6U(PX5R?bqOQ-ahMhdeF(K
z1}jKO;J0%qPs)}A^lH<lO>wM2D|w?l?HD&ywgbhQ5^aeK8n);^iIUA3_mc?*Q7Cln
z9W`1!xUd&R>;;OXl~ZfV+}rsLjofb?>QJ?1Q!qgxt+ba~Lo#mZkjrBK!o<zl;>*gm
z8pfLsb;PM?6R!B&k$*Ykk_8ovIr`^*eCh@Tyr#nP{YJF06vl$#L#`hVy?AR|P6Y3#
z@8_Hd^zt>hYwUw>M;sHmu>U+^M<pUd2fF<}_1|b#@%0O#aZyrH(K+)IRfa6Rgm;f#
zqnT}pIphY6)MPCX8lNi0aq}hgo>)5jfkEL`mLWqxiTw-cK#$15lNYx4V~G$|cQepC
zG(}hThmO@eG@OPRM?59SX(7%_i~s#90zg*LOkg>O7%$$&)7H599LrWvpyYEJ+N-FD
zDGOX39*3&ptwg-VgzdbS+SYa&p}<`ckre=$*))UV^rNNKlmU@tY>cBqQeLZ(%Juz&
zZW_C_^io}~S%30xNx5oSdt-jS8J{!{bdGnn864>`gG=eIeli>&lsu)N(Wx^4ZW58X
z<<<j7%(k`Nf`G3jx#u$bU=Ab0L|#;$-DGwLM*9VvrK-!LKur6%?j5y>D3K_gZ}5<4
z!{@O6LJ(7qE^8sIGanA7E*HWCy?P)5oQ;J`Z`7(9uFytQDuzKH4Et!DVeup`3dVf*
z_f=tI^5o8C&6<GzTZ|wLA9OBDWjW&3))$z2MM&<LpVE=%E#Z#n?xG%Wf*^-rO;(an
z-}$X@CSh%9X7xA9?cU_ct+-a6Cx*}kn?P$2I~`3UQ>20%J=%GA*MwLx2%sSPW7x10
zo+Hz8c=UpvgMH5Ly0vxJO|U?1nD|fsxb!lNQC9*}s&!;akFH(1%%S1^2jBt{X&JyR
z_2F@+tCsc0cGk5{RFJQdNUduA!B<7Q%a43AOiI-D=u-Go4|H|ut_32tx{6t%&yHzZ
zunA*&qPmOXg%d9-xW8sS!f#N!IGBD-hkg)H29C^zwy1je6hO*|ty`OApw(Ss0P<gW
z=~4i&QeTE?m-s|QQ?2;`r}?zrI979x&ah#-Usq&JqqJzU0Xp!&jc;^)Sh<_Pf!bPH
z?z?eU*ZHJ(04c{5(Cj0HX8R5$1kdqm`6XoQE(hyxQz!;j4gbdXaWh;()c4>{Yd8-j
z<>(n0B=f2Y)2}flXq3{ky=|Y`dtu9g;!<r6wmo_3l=a-X2{SzlY>=I>>j#vDvBe35
z&&XF_s99D#E$HwKy^A}H{4LUu-r&LA6`E|I&nvuqd8@F>wA4qzdr#4-1sJ`<Zctj#
z;h{;O-Z9U2AEdDNym_DvELGumuLaL|L`^m@s_kf+a+oj>j^;4vk_-O&$xO_bhX)2~
zQ~UF`ksIhOwQ+DTL!|$&ms%SQqrbeDFIV1k*mKrd-$@iVpaXBNKQP@mwgWib1U94H
zI_KY@=+_p<OdDWx#~Cv^DR?4h2-v!{6x1e7cESfyYze|sajq$*?$hY~mHzzmnxW#r
z(W~EYU^>HumQfQYbYe$GY%_QIq?@1QfJ$4Lv!ET7Ja&l_DeynCFs$5ab+vy(y$0x|
zpSSPjn>Phi?3&!MeQrbBXVuk{U9$IJHxpf3ziNWP(g%N`jVLhOI(8z{Vipt$y-65F
zcucZt7x{4ug*YR>SPyX==J_kBt2-yWL5w{fLummgMrcLG6Cm5?d(nNE5;xMTTIk5~
zYkgqun6Pfj$`h!9SJ1)4ggM96WHhAdDBR#IkIDUht}}_HD1jbDG+*U|jY<%R3NZS=
zV~mJAg^+`*cD`XzXJ^1q?w$wjLweGn7gbf`*{u;iBWDpqjvy#E!9bttoz;spPj*|h
zXo}dW{*KwP7)3w`TVY^eu=s8ipq{dmKdGY^a24T4G2==poootm^A_TiFjcI)dI}g~
zKe8=#tOcvtyzf}iFi!!R(`t|{mLR}%etH=_^#c`CN3MC756azIa0a|l?s*o>Ku{o%
z6h1=92M$bkucVB%W}XG1h9v_&U%!0W2_*RH_3K^wo6u#KVg)fC!e&2bGB_wG0pv1f
z=wm@j(TRm1$JlS3QhYi3AS`4=LPGZ+Oqc;;?_eew9zM`#hdGevQG_D+Y$a1_-6ZkE
zJn#D(d*n6575UUtD3w-J;LtTPM*l!zCE#)j1*4mbORb&Xb>;Unh?E`+7v7XRxbBH5
zt%-b8;*^=LN+et3_{0ML&HMWmqg2m|{sqSPU^agIX0}yaF;rYCs5Al!BF;`elpJZW
zN5}lsBc#6F^*KS;jiyW$ktv7r>cfZef;tK+bdttp2S{Dfpt1_VjVQ(r@wNqu1ycO!
z**liXNIJOWuNi%`XRyV`!2QMsyoEoM>A#}9{2MO%x?wXskRnZbBp^_WUbmOI!U#Hr
ztaIDeUxPz$xq(ezih;k8C;R7BDxEt=(sr;a&+NIY{Q}?WhScCAswM$i&!eM&r7_o_
zJ#5iI6bbHxg=+2DviATeq^;~2Wt)UU{?|l4<6Igg0UQR*K3i<q)`oPEC)~P*#=sBR
zByXt*1QUT4)zg@LM<!RnFJ$c4(G)MA#`A$OL*b1glG*tEUl0MHU;271QxG2xW@`ty
zM&I-SlgUk+2td@Cq6%aiL-foO>pm}`yxKf$vLKf#a5UrDK0?LT{X@-OeUD9SN=97K
zgTe|Fn!)w)AZc#1Ceu1TU^09gb(qYQI-K<#Q9V4m^x!m&nV4mAz~#$QMSLo$qh!BC
z7maUqGpf$>R0VWStm6xyS|(!1+zq3CvMU{<q;Z_)&_74ZhR&Y!s>0Kv&7=4gcRSQ5
z^r;2^8HviDDo}Lbh>?OAcZ><?KadMJ9<K}v&mGj|IiWo}$q)4Q)~oIko#&-SyxYRz
zeay{dob3`g(w=8Q^b%b1q95uPkye75U|F$=wvkd>`^A>%-G~AB62|P3L7)27^Xv=7
zFW2GXD0{`_gevP(iQZjUJ%+}*u$s%WA~S>^&svOjwETILD^jW;)h!woiEW7V!W^o(
zFtlfW_=*CWz`F@xJ0~<xsl#JVm+Y7YQSf?Jq%7-mML^GYXPcCxX}TVCwA65XN*DEH
zbI!bY;C-il)W|Jws<D^DL*mU|_Bb!%iVUKYHs62xap;sGoq$Y2ix`rzgUh@!S$7)#
zvf6##m&3*1X;mCdJJ?>})84?R@8#>)(nj4VEp=gCGA-L?S~pFYXpdjEwjfYgY-?A%
z`vi3?l@}Ltn}hE3vBq~I&3du;G@oXRdX|1+-zNH}r{21#l`*PNLMTLGl31MISv$L7
z<qpLmfjZlWPm;5$yJ$?Zu+UPNebuqXckOyKU2Gq)Dy-dKw2xa1P&$@G#Gadr+zifl
z)Ylk0DyOK*MYGE;;gc?*b=c(Umf(r480X!GmggqZ#(^(?6z@_{`V{Aa1{wm!93Dt9
zC7+F)T?n@{A3vX-;?hT?rt18FB5xfLeeM4JIM4F*z9$?{vDJB!!b@JJ5|}Hi%%j4?
zyMHjuYYne9)vDf$!A;3{995mqPDge{MvjO0PvY9yz(cfDkPJxQeuxa9HDn`_8*2*5
zL)5fS$uUR@qjv5b%U`Iv`fe)+BAm(z7mW{VM?COvrKs40wf3ieaZh$K+$Lp9br-u&
z&#!ia9T2G^)q~xa;wgL`TNVRil^(BiW-%dFiUvvv%yAxE)j0+nZ*6aX5XHq!T4RU&
z4lT@mSf)a=+mn;D7I8I9Oe7UvBTYD4A=@x-(b2z&m$w;|Az*t^<(-@0DHK|Fk!e?J
zD~f24i7z(~k4Xvz7cOihm9MV%$H6)!is3E~8XKCwI~cpPQ~)YJ9GbWA-1pj6AmKMS
zc)v;=$AtRJXIC<t#W>x-C&NRj`fML7YotcfG(_TQS>0umIrbM_DW9wWg<`VG&r8Je
zLzG#3t{bH^tK@zh0{>kBmaVsR_ujpeQJvYoR-OjPK8^zC<A>{GBFSlZ!SC_uHLfY`
za4<z{@7>wh0Q)hgcq`3*;K?1c)oW53(o!{b2hYw0VAw^W<dFZRfYO}rZsT$AQKq)h
z=yRu5y_*V$H%C1w4`JCf!kRw8wA^ZsA;OAA`+y~9^sW*BpS*JjtsZ4XpUA;!NmTci
z#L3^Z$$WB_DM#QapE}|S;G!9p3f(8~jALsSZ;N*CO0LR69-$Ou)HO#T!K{}qM=jiV
zEa<G_RQpr#lQM6H6vlFi0l-a5g~hiIZ<NXf=+ZmoSJ7}f^=<x1Jc&;3dWad()3<M@
zf`ObF>F^CXzxkv|31ny+Kn@Ey8&JZ@l-e5on_l-)i`lcsl88@Uwn19y&P2a--D`1h
z`0z*9XFl{0!f-NcmpuG2H9uBhe;ooz)ad^(We10&#n@wxE&$$T`%_cR*-Z2iq9CA*
z^3IUYUcx2Q8GU)%e>7u>Qj`yJeulh|^Q#qFC1vxfkhI1Z&Y>kN0n!Yr8qSFT{wd_&
ztm)aX?Q$88`h&05j9_fXmf9g}e&Ox(blu><KuwSziW4mk(JA~jsvW#Lcjzz<a@@Qj
zH{j)u(q!Kep_lCGb|Jr}B3<j*Bay@1Q9<5Ym0Q^ih6bb>0-5HphEXOsn7S;X-^$bb
zV9un$cJfjR=3ZwiXD4dY%i};}B09$;OK?zFHzAy<mk-~n1drIxX0SCm1JCLKa$B&I
zFDfq1g8Gwh_!1fL0`<w3jfh@Ks;W9CYR0H7kFaZJ?vsD;XI83C+PII^dv@ol(z3{I
zKv^zsXdVQvl!U&)d}PxTN8~jC&5NUBxs?tiVr#;!DRU4rcRARrphFY6%3*LUoiI=^
z!5SU`soe(Eqq1<@dH5Sen_x{`vwwes%$>j~h)Q$u*3#NdEuTP8V%#rs;T!r9l)8UH
z$dKm2D#~eX2EmF-A|jh@Vr4?giIL1naM<x@N_?~>-W=zXWy=O}cel}y6=h6C&N^q#
zoDH1UBwih>&UW1MY}sT}n4s*`Dq`^{9({bhflDrWsR?$9gAEIJ{$R*l(M(Y=B}PCm
zB7Vr8e^nI>M5rl11(}THj?Q7j1$uEH_U5!<;*r;@V@qynDCSVIdz*RzC-sTI^D<B=
zUKp%+!QA@Bty?CX!Sh~!8Nao$8!>WZ6}k;Z99k1=3hU?n3oQ+_LE3VD{$k$|*(JbT
zFC8$XLAZC>#zPAu`?mvhJz{=CbFzk7pvI5G`4eIm2sRXkPE(w2^rkot=Ik*%nMc_t
z015iU^#)fG6r)VR^FO`4->O}^cB0Lp+!Es%g*iXJe`StV_v^5JJpbG5!-Vn+q1`{=
zSR^WJ`XE>S2t|5X!_UuSsDBa=VeA>Pyf?MnGPDvXcA3o!_8E1u8$bp$sK9TA=F!yI
znvhb$bpc8cF=~j9J;ghFz|670Ag~l|L;&V<)U%rU<8XFm?EH-X(*k5)V18r}LjlN#
zyKx88T?hBk9g_7IsQWhlw~7K@HoK|nyPr4g*olr!rhm~vZsI5%aMah=KTL5c_!3t?
z{^L!aMROtY!1q^Yb6;SkvT35fGu_GNv5AO31VrQ9JSL~7SG6okVH_Ww!IG*~&~Jp-
zj8EsBn<&437-}`QnbouRb3FnPTxEw^Gb6r<Lf0|hvdh^~=a_i_?J@J%wX5G%ica{`
zhP2UX!GZ3?0r*!+v6M6X8F~v#PVtTiyJ__0)E;%-T8%e8s$L24K^TJg8*_3Ae+8Jj
zcSVdIq8u~YQ;5L+C(9mf2CTOti-FWvZy(}yx3cmkB%*Ru`XZimZ|e2eY+f~<uZ#9i
zQ^7kf#deRd-F9wcu5r6Pz`dj;QOgf^(Cw}85t45A=?CP2Nv5XTdQba%=A8l)laEZg
znp;>T1Nbuct0bu!#-A!d3dxwgdm~SsT3h&Eyh6c^8#_U2C(tY$U};M!54kTAdtjA`
z@LLHS55)yyX27v5p)N{W;SU7=xH0h6b^y$1m#t~w_|g_;%sd(46Q$$9lvv20qhozq
z#}pM8>#pfvP~Wfs)cY1oC~4q#7p_L2c8lTA((>{FJ}aB7q21_;xHg=oPJM*8$>X}F
zn+A?x=2;RAP&=3nOG-MS3CVoA+!ZYvd7>yy>ky6*)P<nC!>hHEC8Fara0=|9T3c^-
zM1(P3hx-!~jmho%@xRTQfBaTM?Wa$@Ve-lcr|RO;$+ElE^=qHBO0hNPWF+%_JC@XI
z&1PR@*Mq6+nGPLC!s|npxp;9iAg+Vy6ZN?<Yo39`jK@*oSBXfI;Fv%6Ed^41y2IsC
zN|XXrC6oZuk2KD-)kz-Ue9987Q1q!2PYC3Ff=p^l>R)avo54u^L~5_rH(M5^VJ~!)
z`+2flAXqQ8&vxmJE$w_?HAFORF}c`&AZ1LG4WHgUyl$x2A@_REjzJ9JIj1LSx7PT3
zHW80@S*S19*rZe#-pQm1%sFgpo4#3SV`(`SrvfFm#J(B~F@e;p=K1zv@gm5e%jmCL
zhSkYgCx*dpA=R+XTE}`6aHW&#bEZw6+!Ngb`t8UoUwmt7pH22&woH@ff*sYz1xxE8
z7_6<V6387o+Rm@2&<hF+gXo#f`K;bqxY7wef*om}3Pa_^Y(}ZoI>r<+?!{wG-tB()
zsjg0o0K8^`tq!06D3*h-*+)h$jhgxMVZOz_;m_`bMe_bAcYD~`l|>x5;om^Qv^_K*
z^p&cc)AIFYE$Brlbhh^3!QnEQ!E)h!aD?n1R^y$7aZF9=r!@@>j)lEu9wm|yYvOMx
zbjCC(?}0`vxe}bVEd)WW6Un!>2M3F~hH45Lq9EPF!isc+sAnRNbH7p>wITD1`Dq4*
z9Ls9$=%Mq9lsxYo(W>sEXFqc$BYJa@<G5pbAm!T!RroT^&?=NxQx8<}My$bS8)@RQ
z7@+=gGEEAYzUQq&;mgK4obN{jNJN&+8elC2+jHyvc$$ec%)Z_;IF_Kp2@oAP{_pOx
zzyE!dZWK7P{<gIQ<OBD)g$YHum0KbW4rTNqhO?V&IQ#W^H?r<G&(AmgapN>mVA<R9
z|M4k6b%FGEj;4=saB(9-fh?NRifJM~D-TZ%VRC~JbzKg@k?iaQdbY!%|IVPEDe5_9
zOgw3B66K(ARoOYFr9<IhCWCmoss{u<h}Xqwd4fp8dL#l#(0Fyw>eFY))aeF%Nc|Nr
zZ%i9No7snX22~^9f1ZqQsgurAKZ<4S$#TZv5tU9rT;-i%qy9djVe<4X%}P8)vNCL>
z86lK!{7bc`t$1<U3wuB;FE#tu*GA8ajEyyqjg4iHFwanN2zgp-^ypmkxU%Js^O|y7
z6Xi8_cdV;=^2C^HIbWRt`WAbntl^5?*{lW}x*y<v+<?0K_wF4cV<`Xq%p!)Ex|0Eu
zGLWE|IYlhK1;ptv+W+UwMz4zSMi@@Sntr==CDts&1<?m)E-<h^I_@J4@za+t&E%ga
zem>_TcLAf=+TcUBQuI?FX(@bUdh+)P-}SU)zpY(uk!_6EmAhe)yLX#X7~Vp6(ReI1
ze!TwH^<Q!hAO7N24@AyRwhjVhOE6{<d>^&uO>nLP5Gxw=Np^P8bWJHd&E(M8IrA-~
z6Q(q|iShy~xG)u6hq2IU(kc?XsjIh}kDh+yIO<O+$RVlM);?`nJzUuvj#PR?AIyoC
zgd9D>7|#@n2rA#qosk`$KEC+klYnQY;oGIvgv=s#6|P7|HPwTY(j8znCgkgEHd^(v
zu&{ueJOK7`1&3&X+F6wq26j+y_okildwYuC{~wCSPr^CD%Gfxs^WG`s@)Ta91T;*E
zEiIo6+&g;RP%gax_nPL_+VMDdMNPhVy2rc)3vPnzr%<nP>11mBOzfmx?I;Ri<gC(N
zZSN2PI5qVA?W?uVRKVcKV?nEBNu}$MZ?%@fN{L#Z`b?T%Cq|hlF0(@~Ed&?op)h;Y
zotfvSQ{MYw8@4|!ZASm8y>=$^jga4#o7T5>+#VJtEi^G)MRFkX|Bj}q5j5_d6zI8K
zQY!K<U*2^`t@oqOoOq{fmw<cK-x0e>G6E~uwXXlX%iDeqbnKvNlGYvY^MS4x+teLi
zH%flJquup^v`Mc?wl`ZJp^NjRcA5PqG?>8#*0YqG4jCMs50aV!0rT{~|I%0F+&_#_
zxuEi>tPRVpn&8g=m=GfE)$CC--e0^n!_hwzDZ&PY8&E@Th6CcIRO9HR0GxlMT=QN$
z1SRb^{8*m;_1}k|->RjhrjS*#o~9EW!Ck0h=ve{t()_2>C#y^@UblKR@OT4$Kp&>5
znmiN9?wP%BCeDh{8S>Wua}`nFMzoKwUWJ?W>Je^cJKy!?wlT1-uhA7qBQ2~AA2<2I
zRL%wAdI|tr0syIXh^hgruqJ+l%PeK^djd@8eh!_@#EDz22b59n_xF5oW(2L~4MccX
z4W|Z(_>dHShyw1+qST)!kX`Ns0582(^pP!fvoc=yY)ARh9mG#hUw=R3Q;}OSq*n-s
z=H70%vnyV8lo|-<se5hHv*_Px14tQxpDpfedYwT?75Ik2e1B4sn3f2ULtIULzkCSI
z9b&b@($Wa~Ht(7H0J8T0iAhiL#qcVQXB)l5|39EGZFGA;LChX{3P1EqhqZk--UM{-
zduN?nf0g1|65H2RH5DS^pt3BetlUd4=$LQiL^scCI5hX-*8PaRq4z(6-jruYO@u@6
zK(T@Nt%w|E0tL38=*#y=uX<k!4_Zh$XP;G11Jw!kW6qp?NBg9$XD*}mQm288`c0s}
zd}d_SeGb|)`|kZNvSP{#sMwt*$vZ2#_{)t3t$y<i0)sUzohY6D<ybrBD=47R`893r
z>T3rc?FF*HV$@(Cr5Hr#7l<|(Uj#t~90^TY2H7J^6ft|-f{4|7apc~;+bJ-NZEQO6
zdRPk*z1;knz@iku321TBlK`JL=21L$<ldi0XE0{nY5u|!f-1VQe~LXjtEl9$6kUL2
zq|<Ig2gHki9fb?s)4y~ORy6kBi&sIrA<CO{?N!ky84Tk`2OuI4Q^lRJMCN>Ar<i2{
z&R}@ZZ~u~cNSn$#te&8&(l5Q7e<^H0Kv}<bYv!fC{s#vZ8QkMXj~2lIl?|DS|CxR7
zI4uQF#)QoMsJePP&9W<RUphSEjx0z7VtUMv6RUqz4<VG*f`*C}0sV|TC@PCQd^)f&
zG5>nX<L=SE&~Z&Ur$<qqfsLj2jNS_$&{o4}2l0?yveMb|4^#MKaO|CMvXF+b+)F1N
zcRaKggWrugotj7vlXevTA&g((!W_Sy>N`G%w0Oj*l61!*U6Xa=xY8m7;JhW#7|=0B
z-MJ0?jKCbp+yxq|!)rdwcXxL$Sme8L-x;dljnq|06)zSRwgjUV4HI&!oos7ay7Zmm
zm|-A|*@!Sm;&TymQ}gVy`4;Smb0Rawjp$Kj7TxEsFkPlIX>4R=rlV=!-MkN$^|m8P
zI-K;@x*Vnv#<Uw9Xc7!idR0v+qqx}V$yh#$>SBiPI6A+SWdRi=S4C<m(WAhGO@N`O
zHZy+#D<^_1SYm(|9z`4e>v)<WAN^$UOQ67i?B~C2!?eH_L;~5@gzI@b#2)40tNRWb
z)Sgr>3!c%Tf}M{uS&j6QuYSRBYBFB6Ejihj8I?9#cN#^_J{~&js7y|NYNdEvTU*=G
zZ0R<dAI5<;aV#Fe{!;@#`agU+42z<j&;iw55PXdkHjHDP6Pjq59zPppf*TLIK4zTG
zYkD`SgCJ*SKhtduGbmsfV$X&ri$NU)iX_%;>3gBy96BNrGkR<Uf7<r|sSojil-jqq
z%&e?rz=9PAy>h;xZ|qIEdJ1o~;>%AX`G2heR%D98c!B8{c0vsgbsgHu5d!<z;>um*
zPHjf7=K3H?sf>76ihkx7##xs7vUMWDHRx3f;<4_@V&aqP&_!m{@ii^mwjEH{y0~3s
zv!+e05YV1HcYVFb=`&|W8Lob>i5w(^0k)~!@gFb00Ule!hmtf)2=(q9O|6_^B1LEF
zZ#*ZD)nt0O>128zK-B54x7pnztaA73hbNbBJ1{MNDuWCwFqVkLp%u5F1HINk3{s)R
zE8Mso((Q`D#l?0SS5n<{s?VbH#DV0lZS8JU>U8A&zkUWR=;t$g%$LI&FKE(^f)$9g
zA2_+a0?2m5lm8MF=pp^QzTP<kv$T_b>E42-wxsGFWYHc9g0=s?d@~?{U?T};-QF$V
zhOPmLp7TG;Hu^*<e)#n102F6VX!lhFZGrF*nsfTCUin!9F(=WC^jmRY7Zg)01PcX?
z>*XCOwdt2>d2eOS9wVRQ^{0)BUt~R><a}wi6ohOb=<79n&!ssmT(r~|1Ij4~kf=x|
z|I%)~=m{02<>%)oV0X3lJgIj`lOe-HdjiHY#<BR=$OD?wXoID;{9n)e@#9DLUsUz`
zSzMe~FJHD-0N7Ki9&TPmM9^RMXl&!LocO-WU%6h`-SSHDhe*0uO6i?291M)__ECGV
zmv|z;EOe-YX#yq?dc%hGp@R^aJ2MeBG8X0#t>=D2liILvh0z(7aLc*p+x63o*{26k
zw)oyZR^5+*V;3;2yC>n>5QoqHg&ntOJx_}#oZ2A%bIcc!VFv}Ne_;(S)qb_(>yw`!
zm4zBQo?;CYOf}3l3WF(VOm|R>eY%vaHU1YUa|8ZCDJp#}4y}SAW{1+~Hc`ZB*o53C
zRj~K{^_)D4zx(FHTK}j7P+|K=7>G{lC>4#kG5&u`+D2ghY{}VrS-T;c`!jLrvH}zp
zhw|Ee1_&b*EIAS#a%UgU0+sikVSFaBjig8|g`;yWY>K!d&H>CMKpae@#OV&&+;}Yg
zT;G#dMTUat`zS~|&KgM^9UFSxv$t2*C%-|kk-`_3K?pE>WdN}qV3zI-u9=vSS0>Pq
zHrXJZG=V~^`4N#u2y8=#1K_nAqnlvrk8}Sl|1>$~XQk#^KD)KXiR)z#QQDWK*lbg<
zM1EfP?qNK_i<Sza(g_TdI*0bF$p*ozJdC32TpgpQ#GlS$Sav@ks{hBoCV>Y~!Ua?J
zrr0_?uK%_)`AvRbUETe>Spnj4jH75o5DWvb`%W*XJIO;hfv--#JKK}`HhG3i-DJE&
zCpkOEfwNvqd$#i2Q?S$h2?^uSvhFN=@y{8h&YeXRAZ6<rr?r`*zz<~1<jm5%=xErw
zooJ~?7#doWE&`6{qL`&c72(d)sJ9;k+2D^-_#E{1Z}&3`?U~?PNF8p%&$|6(si{2!
zH$8$#2^ytIKz3A`VzdD${`A|=pBNW+%=bFux%FCMp|nIG>CeinW9V>1umM;wNBvn(
z=@@wWw6je%z}u7MLMtA&`ttf>P1fsWdbAx$1xR~*S|<-$a80f8SQ@^0>H(jHPvSo^
zFh<bNx=|Rq>4@B^?c6EOC3B=gsi2Kl!aA(r{P_)_kX$Kz$WyJ7nxV=O3bKGY6CMy+
zcU5|lT>)>Kr+gD}dQt9GTpgKw2mxj4mG8Exh>z7<;ppPZp#f#ma7?1i>>N_*Ya92i
zRRBG;JN1m6VPMaG7(w3p$IJCVSBE)Yzsp+<txBy+4~LRQHU!KT>Z25J`j?0&G2)N1
z<U6?55VdHYtmo)G+s&8=@eRNM%9qM5z?{~ew$JH^+oY2xSSeC#YT;{F!`q2qOdzMX
z*&3*$?tn)i1~Zc9kI|qu<XskZzq6a2yWwO`a?Vo4jFH41X+z9^`axZvytc!#q*)2B
zK+$(KQz^j(U`_noyc&mBV+F`q7F0f^rY&hXRpV?9yWKwI)SW$gA8r0vgt-k*jbwHP
zaYly@78up<9~brV$LC2PDs;8XL}W(10a0tP%5j}HBzoxo(oOSb%{p!fTbap5rEqEt
zr`mUPm>o8Fs~7LO<mz~5%Is5Fh`prEM>$37G@gdF{^?1paPEUZRyc<6laom^{8yDm
zzpy7-ywXLYK$ck=l=}8-Tc14zb}E_?X?|#4=cymO$7V|tx`Z<e9lmB!2hp#5e|oHN
z75`RCVFlaT%B_^1^Ym_^;bz*XJNlhn>rPYTMa0F$-J9B^Z<sVnP;UkI?){ZH``oOA
z#k}en-shIy`=|TCEsZbaGvX^;nS{0fua`-r8`aU>3??iOiw%Q$p6e&ER1O=<2r7cr
zK2I(Snb{-!{gcs8`0!{;Cn6>84$MmE{+4Q#_B4S$2`@W$IDVmRWsFqe-TWudl7KEE
z%zA0OIo;k@7w|}$9wKb(Hf@;Jdy+O{jd=&j>~MaaRO{EE4w1P~j@1niDViT0NWb3B
z&iBpZ5A|sU(ubVP7!A1Y$^ZEGw3weuf*OkEaP8#gDdtwt!w5o5k=}Ah!G|ea_eT5B
z76g>}GTlj{Sbucd?Dq|+HvV&&NJ=!%m^|=N0LqKT3NlfDU<4A>lCys64s<;`ls7nm
zU|RxIU2gUC0ObqwE|-5#_v9Id8q4?(LH-gq?>%qY6}yNouq9IbQTPopJ9LH>iwc+=
z0N5M}?IC%`0DhY2)Eqx5o0BK9j~}0iD)cY~sZN=Uhl=_b{fP058K=!%YpxQ;#OOl2
zb}4xo2RQV;3)sVg+LIr@)h!g?31GfU$b6Khf95v|W{h-r@_>b)k({U<go%E-`7fgC
zMj7bqo1k!Mq`=9dv~Q#!8_D@X6Ohe9-_Gz}M+3-u&?fX%{c_58A7@>`1*9rid(@Y#
z6!$EWQ8oqx3fgPl%3k#I_3t9_DI3S%2Lm6>*OE=L@RVXAhC7{3T#9ak-#vUqzF+!A
zNLCO-^<9e=FqB2vp;v7?bk!P-D@ATP*Zrc+dZEE@_WtLI&{L<rEzp?eIK;r<5<XRd
z;BuO%c4%is&dxDJEUdskNh_@y#<Qo8oe1F18=I%Rx3lP6nDoN1Ig#giTNDOn&xlN$
zC_f*|gb7W8V}4(n{FWr3Y~(}VQE8-CMeT(PL=uBjN3mgWp8n#yO1wz+H8v8J3$Awq
zm&hs{tjvCm-*-5DA9kr6G4VKrN;T|>n#=uqcK0ooClisqGxf7wC|7zH@2NUpVv$BF
zuxWQJ*_Q=4VFV-$Z4{`PaEK5a{=&~n6C94ZcR)3UI(L|CQ=jWI#*|qwlphx<`b#Ja
zG49F<ZK5DTbl6f%-HLTD(j+{7@uE5Sv24QT!sqe2JE*I-A<fP|nfeE|W3UNx`Mt?+
z)9iaw!HCJsFTw5O(KKpew8y$>a>hLMZT5jJ`0TQ5b`V4MV%J9-E75=gt$KCYWwK>B
zL?u`8NNBBH&mLG}xIp&_vj`>RU}~*H<t|%3WmDGvvy38fD(5U%V1GoTvx2CS@UxMz
z2UdQ~jmSv+d(;}4Ug(6lUU_Ynot4!%;C!YlHV|bC2QxE8!L6VG0IHall9aR=++!}H
zYsUDk9h@8agE^TCcdeHHm}^(82cRN04Qz#;ziXp%XcYo#<yoJJKO(AvoKAj!H~14g
zrA%3HzApmDfczbT4i#}3V<%7uOffYF-Z169561C-;;X0%#5xR9IlNJg0+M*N93|Zj
zNQNE^4{?c<@2*5541_!*`s@b=S37_vEuK{6<by*|Ao6}uV*}l9fmRF1mkn3s>PIhM
zYH!;TKMYF~h=e(O6s@asgAe1B2B|4i1RBl{P?J2+58QQPV=~c)T?q8K=lQJ)zIS^$
zQpGErXCia%{P~|s9@0FY`^TBG6KZD6otn>&O|ogE{}`LnunnlIk%G*z!STuxG75yP
zpa(L35q-^eSA)@#*{QSd4n1Gr?CSM5`yxKOI>t<Sb~5XHedMSYaPK6Li+Op8#WhbY
zbXBC)=kHzuJit3?BVFx29;uz`Dhgn<|D8vT9xbF$*W_p0;0>uJ8d1mbUH*_$>gGRo
z0u`nP%9fGTGlxM$%e{(jF=j53JI1VVx=^Ve{tP)C0~V*VQW+N_F9lJ;;*Qfsf-81l
zMZeTYDA3skaOvskYyMqTReSJ@1Oq}AW3*RYK{f*rW%I6GYs>o_$H1;ql<j*1?8A&X
zS<Fn`U^GUT$txr!Y;+h!zTAqg3C?_QVQ-b~+5Zn+Zywh3+P!}#Q|2TgqDevsA(@j3
zNs&}&MlzFGl8O?MnS?}WkRo#`N@gXMVJkBgGNqLCyw=|L_j&$$zQ^%9e*4~=`h4E+
z>srIP&huPca4~WPw75EWy_dK5W`6Z6Ml5L6-e-MCV(}D#2G_l<RHiT=|6g()D&sKz
zs2dMjBmod&Xem#eG02Z(;svm<N%rW4P3qbyTc8_2@wZuXH<cfZj6`~R``qt{g@6Cn
zEMzyf{8#btCSeQhvPaz>)wOqS-fTqdO86d9v*C`8HWKc7v{^UF{kds=eg)yX!cde8
z3z6xx=d4*sJ-B?Eu^4{Ic(KmY?=WlSg-U^D;8Ss$%d4k7fWF7%<mCnI-8(ht!T_QH
z5BDphh?k6omRNQ>xdkezLV35gHo7<kky?Meci1vA37tXLn5Za!dPBqc$`i(oW13nt
zb#TYSlxs|oxN7`9z{CNnCeNGqq@<9jU^HNWe9EGOZBHxFo-la&VNvB8{{8>B027W-
zREw>%o0nHGoy|z}?QW*;Fo9$D?|Nn!N&h9xw#v#13<wdDp1J<~@|7z(40ayfZ$&L^
zPUnwcsqM2s{e>h&*-K7?=+7Y1{^GY^0X+EiZ!Yd|?B2F3^aTF=P4ud5i#~m2vxpl5
z=)*&2iO7(<HSWOAUH&u`0CG71J3BfI1$wNy{h5Tdk?-sZwWUife0aabS6ZbF`dg#U
zA8hb--M|aUYmIBF2%(3k?}h16V)d@#c=hhA*GYeNd@q`M%5F1m4!A6KK(xYKKh9@@
zBUssWs?}UD(jMC?qDuZ0_wR4l&ONC;H_HK=1QB(SMmjTbnx#<|3T2K-wh}HXuA~|=
zl@QBWfE0M;$`Fb!hwScqIrrVqwGQqB6GO5yz*l1iz~U=2etxHEh~wb#K8V{nE&uUj
z)-VRqcJIBnvf|Z|dueo!?p#w=ZHfmmeP#P&ZSAH~)INc#Prqu*G(_?MUGfu*OC>mS
z&Wi3;c|pkGA-{$+bJcr0&B}Eyo-i}`oM*!7E66$rlrQnyv%6!q%*4ryYJ?joQnXJ+
zsaHJJZ0Qg#&8~U|i#X%aBNc9ir^fL+@Ut0fY$P}*hh1O8d)dhDU}zzW(MJ|6-gg-Z
zoowj=(-}E>bbaBQSXphcS~t4s9elkuQYz@ze#*KN94tCrD0phj(Ok0nu3EL<&`puk
z*mij6M;fobELTQ}a{bYx<j2qX#ObW15Zw*oS@l4oHsXj7$~srHL%R<gQ(WmcX@z72
zpN}@jpMIG1B5B_!)s-Xs{W)uL^qi)qx2c=4bRCtI-JPs)qInV2q@eHHSW1w$Wo38c
z*P)M-fw!aY9)vcg{2F_&`=CFt?xI1fd!Fk(7wV}l>*}gU{Q5Gq^PSY%`c<>HL<Vo4
zJT7^+m#v1=xm!D0?lz4(K4Hk5!H+{!cNZ)@7pL!}y4f;PeNyh}F=HZ3d(Lq&$eNxu
z;z6H>c}txP`Y&zurLru)%hpS2h1t3{eO)RmNcS^MHe1pwz*&R8JH^gU2>u8HWGh=<
zZYg*{@74<VG`X8J4b5^7u_CY3J3<{(xVnXoPP9{MF*5roLQfvnD&8}ub&_d0808#d
zILo<hPoywj)cjug2#RqxTDb%0ge=QcTC@6Tw?Yn-;J+0~gbT=`(U|l!xq6xk9ms1+
z&2NMx-4xED*^AAll0Yo`A?^cR{uTurEKXR38c5-F68PT5cLwIuk3e&-O)Hz74SX2B
zWy`%ZZ;%{i1)visd3*^K1-30Fu6{tE48Hpgz0vQf+eY~PJqUeidYP4(86Yv#oZ2<D
z<z@Df)%4>H)(>Z*Te0{*FUr%^H6TKD6$hWaJ^f{_V}w<{Zvx{sD{@K{u~9xg6-S%H
z4->zAs7}lLJoEwYFy!vLNhoIWYy<UhOXaBDrhBIZ-WN8xmy9bHUz+|b&2L1W?X{jL
zm3Hmg<pthkWpQdxpR}_hP|1|&Zy5|q+Ff5C!k9)Xa>3GX^t$09=?@Gv-1jA$Hew_d
zktb%IKo@2|AJ&BPNL4o7knKl(J8sW^N&LqoRcuOjqQs<?3MJhNOkibEbBf2Q%%A1|
zGt_w3Q@DgJH;u;Y%?%bwYtgJ2cWT*HPp|3BTD~K?u-43ndAQ9HH$7sE5i}{ZVj-0p
zAar$pO>H&9VQV8;TrnQOsg$#A6oeqaIKmcB*1T}D-n4k^i{tT6;_CRVTo=%FrOW9#
zGnmko=x=R`7ZSqA@N?&kva+-LYn&J*?vZ?V8)Q_LrHBppudA(?Dyl1p{<U8(ahL@D
zB%>c?{XqEJxKjkNow2drk$ww7Zgc?a**4hDrl0+cp*&0lIOiYCoNMm>j;B4?eD%EX
zT+7-Zg=?!??u*oPdI-pAXfo<2J=~e3B)9nCJ1<T@ee1$2u`Hm2?@Q<iFPM2CDoP7T
zU>lcpbH(|U8)mWgoRZEJGsb;Pq4A#w9m@qrjfu`5?^jnlh<EPh?ta}zRV_42B?PND
z%H!*~x!8-Tr8sA2Wi=!g4LEf0FR4d{K}t=V#x9$`7+%W;scd12FnNjpVN@<FX5d|n
zELnFN$94|=7$Qp&3a0S<T6gr7UeC|>BFBA8+{T$AdTRCUYy0-n-$F(b3JSQK{VDy%
zGvb8V)%r4x7T+&=8{TL=Itwg4HE05i7r$;Gn;qb6lT^Q6Nm;l2AbfF_HiQ7zGd-N5
zv6p!cMiOG1m+p7|*eZ71<u3)%Glb|OYwo2iBQPf|{a`KHdhp8FWijQc=5;j=%S!#8
zZoGQ#+&S+^uKU`*e=d1fDiD1X(!p{e3;ca?<)4NXP6c`x2LCg0L?MM?N3cb9M`=hY
zC7up!cBH+JkDdJD;go+W_zW~1H%V+|_m{sKz|-p^Mf<pM<D~dxEOyW5*x{zwP;mOe
zF|(G}7_qA!H`f*nR4Ux#deR>;jvIJ+{`<NJpg;i55PrN+2yu95qTmX74mM{ddiVC$
zRlX4PZct%=1JPjyT3@)Mpp!{(xMakHmd?t;bAW=(u0#V)=|ZLAk1IOe8^SnpY9s35
zvaG;owBsIJbNbd~huV2v26(GdzZ#N!lJ<QmgsOx4LMOg_&7f{Q3kzT)8RBsveZCYb
zgjfpEfY|Ow4RVpY8ZaK-%Ami$#_<QRL<5k@uCA%scoMx$Jq7rETR;RG^&NHoGRdn6
zaZG$Zm>J1*@bvUcinN0<(F1x=K?J~0Mu~FEXP0?Eu%U0YkGR}%GzGNC3s(;W)`{kB
zx<uA*6GL-Ec-QLDqx8h{6@US+_&_WFRQ09a)ZMXmfGrE$X$6F}y6kUi6lJPR%oy^7
z(L6NM*NQuT%}Tj#h1!qw5ySMkyVpTj%$y^#&eVNw-}b`oHp_Cio2*UChPi?rQ2SFe
z;4opO4wBH})WdVYp#sm2aaxL-&SNw{;RUMQi0FE~_m1bN&obG33%9{Gn{H?k$LNwh
zOsrE2uB=!ngs;554hCxDJ%KLFVUsUAG;cZ6BE^yL0pfr4#cZG(<Z!2}D;Gz4hwdcA
zO|rAoojv=5`ozkbJ=|NMvFca47NeReDQQARVGO0_c)xCzr{~Wbw~wRs($&%$#lKf1
z4>ma}6Bh*`UJ|UkY9FQG+>ZKz-sBNEWDY8LBiLz)Ukt=L29Q%lL2;z;8_2Y^=ZYSN
z#l^=T<ETNrG{F{X2Q}TLix+L!*xkA{K|Y)qR8NzSmKbv!|DAAhV{C!_q)D*_KLfhV
zgalPGH4(0iBDC?Z5sA;Ym3GtBwSiWxq_Aqunmqa^xY52sS5WYR2hQa+qo_SXJ0QgW
z`Nh{}oJ^cKqhIaErCUQoqj{-0gv7X*hy~Big(xWRy~{F~5k0zhKb8BTx;XROP;2%u
zU_`nbf6=VviUFE9R_<WBibE%{H}Qw(9Je<=ej5=zNkWNvK8xL`={lV{dGc}Si~jtb
z+e`{e+HYCI)SJgMiI3?8ypZ{7kv^l75{LZn49bP)GIrd!Nze~iH8I)B!aaW}W+YJ*
zoz$4xylLQow<RTGfljO};&$>bMQj2G#4dG(N@HB9Ig6u-3qByMF>i7xQMvb<;RD*9
zSOy2bJLEtRBqaq<%Mg;I`p=r!>U5aCVn6M(#bgbKd#t5p4qgBLFzo_LA<1A+%#d(~
zU{NrZ`08o0$A<iTNa((fj{6z^bl24l<d5zP%RkAWDwMJ8zOY<<>^2XWEbGCjBoETl
zzOcNPB7SB%Mhdn%xs2~)iRT63VRG~vLYNgtA9Z`suK4BRFv~MM!Qi5qXDTPM6i<R>
z6j`IJ#w0!@*o;wV|Gc#;hhDc=uU<dvc2<lXUD_veg<f!Si=!3Op)vAH`!8wzdi>|Q
zBGcHu`;8ZC)4GJlJ2Ty7VxLRnYi2*W(**p$7-GaNOG?!ewmEN7h?jY`r728Zchb4w
zwccMND9b&`?C7y$fkbpK&YYs-LyY~vknBHyAU#KtT1IslzE;`NH-_gO2GC<l1Z`uv
zRKImD6}*xH_1_fDvf6t@IC&f3n|*eyt}DAcu!tI?*!Kb7Q^-fcdG#+iJtyGfHUO|K
z%rJi5Nc_yD73<7(mxF94Z0kw=N#K55x?wF6ajJ<+H{0!+TXRV%_HR2tfY{um>uY=Y
z?HT*{aL@3nL)mP7>q?D?!fCe2<{SdEJbsFqiJsG9^6l|16^=14;>m(3Rj+O|_C`ri
zQIcozDPqA1hIDikR@utUWa<UGs`cKx$9eR9HBLMO1sw|;kw+(0ALORIaEA&Te%!Z}
zLzgUD)|LKg2g)uwR&=tbe$?nMUQ+khm$0I8<z^Mj9~qCHAT~|nE95P{h3FZA&)j9X
zwLnjTr~|3#aMJPk*tKt;<=WvcN@E=dq`>APPN~M}l{^!bJoKx68lyikfS&x{9Q|L)
z4$2)X3zg06<^d0i=Aw({6P*9TgJ~VkHlS^eR4`nAc7;dAhaYq3ZssjLsf;VgBoIFd
z5T<e8e*c&)cd&v)Xa7M3(-uoU#=Hl+*H-@wVc%x2ua!kyS{=e4rKrls%kc+5SF{y`
z!ERnkS<99&^<Iw2f#KD!Pij@PTbDR$*9-S+hx%hCgH{G7AI<O2*dR$!wGn~Lt+}D~
z$Bw<NzA(iJsZDGCb2{XDIhu^vr7ILblRvvJOvjE_)t&?j<R``!*pI~M<WF-sZ^N^j
zY1~BGm7B3s;=Tf7vz@1z=P)RUu-uL~J%7sv;KrD?W#OuToww%pYAccVpt=vFe(?ae
zg%zuM>oU#cdWs*ULJgCPwh=5{A(jivos+Kjb9FKPhYhGhA#K!Ld5BB6FiXxaEOt(r
zdHG^4QV?dx>#9;-;He1b=+w>UH~xGA(;1A8rXfdcfKxjK<TI|`-c9+J{<Bn;*Y?5K
z-`gkN(B<yonJN_@dOX1PE(r-O{c%TWhfTt4U|PJQ>VZ=-k{`c_!B32iZ@ayBvw$Vo
z%N7QM?=}6Hl|^+s4xK0`X;d;X&fgdIgZ0z1WKS>#!283l8#AN9uS(G@5H#5X_7Q*Q
z6kG_nFP&{{ZKd^va~KTtnt>XVKw7dgezoS1Asxkn2)`2OM|3l&f+op;fFL43tLNR3
zZgVI{Im{a&8c>Obml#i>WPnPujTFNiKHmF^d5i%|GI*l^5*8`jRzXfc+#Z#X&;s)>
zJUKP!eH(1cmQ}*Wox+scoQ<7J%CD;WrbDZ>KWx%$#QMYy_dj)^7xVJ-v$!Udb^b86
z#e@Sq*xh7LI?)yrqoa&Mm~8m-YB-<DDk_scBy4fqfMjf<Y+(8{@P}z8#<t`rn7nPs
z<?Znvr|QvVPz1>D3T(p2RBhZ=SUp0(lL5lT=?k`QYlVS1Cq>-Xulm;5D>a!ri?UGm
zldy%a!R6ENR)yY1^C^zSN9LZ5Ex%jQiUQ2MRE8+Pn4IrVzqgqO&R0(OK!#9IVDQp*
z&J1l+6!(w^$2d(r2zVI$Nl~G-mbSJcBtCHk96Mog*1IJD`dfL%0&J4;W}ED=Ax^l1
zUtw+1Xj}GZ1O-XZL}EPhr%@VhM9|Oi-4}M<J;}ke63qv7Z6n?zcl^@Gf==8b5q8rd
z93EbXkr?34q7^IJS<cs^EXsg}M#q><1{8yVGbw$bhJj%=i+}agg58gyoJ>v7Zxxk$
zf10ku4vxjwwLb&1ajX2sZ-Pe`s^5VINDr@NVR*rp%&+b+=`b5d8;TT~Ei&Tti$<4|
zyq5-$T2u*EEGtoi-`$sCj~VeyFfj1uz8W8{aN%v7ox=da`)UL&1{Ax=JvPK6T<~^b
zZV~17hgHmgb_gnFhTw-8MI*o^Idoz^#DjzDxB++N7?0%49N-LD83*SNk(dYd5#K$V
z(=VG)|1+c8QnJtV&Fj~S7}W^eN{X9lV%?UXC_-rxWA?7@liS~agmO#%vs7{=6#)X5
z^OjKyit7+}R@NAqjTytL9ZRzi$NYSDIEmpOACs=XKeU3YYbslk+&oP-J8-HKybt|G
zvlA5`zlGHb8z<*$w3dAZB-EQSM43N-D=j-#UV*6_wP%5b7~)DIEZ!3R7L&+4REB3*
zsv-O5A3O*vv25{-@<|IN<E|fF>2k*KOl7yDuWzkWLdLr#N!SlkGuES_$R07eY9IMP
zq;ay8ly9Ku;)kkSsFc8a4X+K1TYc@HV>jNm2!a$sDDwLHVV+}M#=zi$rQp0ausDC~
zW)W51P{`6yx1KX&u{MlY5?%OX)J9_v5o6q;zhm`lYv!<oj+cv!WeWoC?Rnu1V%eI<
z1%J8Zk}>!PIkhi@3D%q#oxC!6%yE|6f*%AhPRz5FnqHR%3VgN=49xMab8)3OO8jEv
zS=j3E3N%(S(B!1F9s4HQ@CEuZ0iB^4L+mIun)7v<SS`^C`k(&YiwwrLxF-C#_E*v^
z&BR2A(&k6rhtiK9*#fFg!e~3HpIT_wru5^PEN2iadm>w34U3adi#8&c_yce)Pyn2>
zZpl9y4L~@$4W`a0UI#*0_x!g%g1Eu-WrjG6@V3KBjEiC4u7@1-3c%RP!tEg9WZtFh
zD4<Z%#)6L1nGJ7ef7q`+#5ios#FnphyLOfN_n*+W10ml4Y!XoY>e}BsGL9K6wsmsa
z%w${kRZN@Kk>+&Dpk*K4y%X0r6y{dhs{3itFz#!?T~RA(Ic<c8r)MBxlCEy^w~hml
zpaqjNxYB=Ix=_CpXeHK*oe<_x(i>u*ZHE3bV1eNRCDdJup;~x<KBN7BZZ`m?(xBj3
zQ{AfjjZ&?e{ixvRm{2U9>=Rd97(aGwhD;)`5j(<f69FX>c}m3$AESbQ8(-pQT(y&D
zlbaL<vc`<FtHa6?97a4%CIy^e>mkWV#EdIzt5ebodiCkEiS`Jmq!}MJT5uaB+x^e^
zu)(e~??Gc^*%a$3rs|imn%kWklw}GP?v>j%2A4EBsvwOzY15sudCN@K5Vhx;&lK8|
z^8V}%2V@z=6XLR|$>D_rnmkrfMxoG%f$AHFKaOifoxd0jGh;?Kobue4^-Jy@tOOY-
zooFfl;bdG~eFav*C=f((>D&A&u;L;3+*ih8=SS_zav#u?ft)x|AS!G)eAz#+#)t*Q
zFPwvd4e{Z?*YpNbk|QZ&J`-&P-zTN;of=+y@q;J^nL+1gBU|kaOq3`S`m+Bgs-QZY
zm>?WMwg@K{{OHCMh;I_|&TNQU=#-_MS~g}BXhGfZ6&vAKU=fstJ;-@7DQ22(3_DO%
zuDs?L4`0Bv9&8A0$@TnMUhMMefZ5<qE$K((c)`IU5=Q_K^5=^_b~IbMWC^cXT=VsN
z_N=b}>bsuiUyG48+`=u^F29d*Z}~?_#T@bT3tm*;k2nAiZ83LL>Ia4{bG{Z|a45d{
z;fD+qIny#LmjX}L1a$5k#-Y&e(W5EV=hh`<3n^|gGc#pU&2j=alLu3wTrpbQ!rysC
zjN0-}ye;uRG;7ef@zfUv-<dMR!ybp0BNSjlKNR)2nBabchXqgZg=x1EWgD2!4WC^m
zOMQG~_HiZQV=J(fR}74&<gL%%+OaVNB~r-tSDph_;Alpglhnx96n-&0eD7g%wske(
zcm`1NUb%l&VfWs>GFwJ143M}ox~T7z$FuJ3tJiyPC>=+$dG{f4F~Jw}TFvtN9Kuk9
zQT1i0%71RS{mgs%Ntq2l_Lu5d2qt|=awvPuy_Pu?|2jTuSIMZJD6leVCe=TkPK{4Y
zYH_s1dM^B}3;RBNTPaZHywGurHDj9`1v-FOp!_^k%Ze{Pn#O}l3eINpm^Vt9=rjl@
zn}`{le!F44(LM4Q-4GFcYV}c_-g!e*)T^n9-6*LC*zs=zFv|f{Yk2J!i#u2gkTzt7
zSkgkmIbAuZKVRtvg*s2V3KzMklPC4Rs*~qUXU;sH)6wh#g&{efQn~-?B<h17IPaYL
zb$=$%#73C4BPXgRI~dFoHX%Qe9@`%XkZI!nFkK&U!=r9K5*sVl@O_8h{<H>!RSZ1|
zQL-S}y-+t6gFP;-d>jbHvrHZgLPz?FUt^W+x(h0($?{K1D^^q{c0P<PiWsFZV`SD7
znLB4Lw^YnkIGUSz+}ehQUpGA*#AFV?K*_sHmoB~8yLqx%IYponG;1b<a4r@Bg34kW
zFfu|5iuN{DEj%m2A(Qa(q<jXY?5FXer#RFBr^&pFD&Xc4v2qk<I<j_w>cp9cPEDda
zzgwA?K_k+C&$cN;D8&S_3D|cPj5?SO$-Hj(dkZc+2|9f5-o`Hvf8Io$%qsb53l}I~
zUi_vJ5g8`HMmj!5wE@|0G9EwPRpJ%zO}7$A)_ktnLlewG{!vsK)N4N(3zS%H-3&&|
zu#G)Cn`NW&s#G$M2XL|2-w@d+SFW#nh{8gsMPQ#}uJvzDojGe(Oim1&fk9~HhNE;b
zP0Xr(wzrXO%tDopecc-n9sMq^(TsERy86PmMX(G#JF<OX{9@=}=6-{=p41D*j7i=r
z?StCtglb3;&6y603Qzo~eGZyDP4Z}Le|mZd%oYyTcb6`Q2hLX)_FegiiMB(qS{O3y
z-)IUs)RcqGvuxOVZ_lq4OtTE(>n!|x)WO!)A2>lo{(wk3)8~fXq0wP!RedO{><%;2
zzaN!8qQy}NNlYb=+Y~fj50@|l@d3pu3q2xoO6{_Vs$v*QNp4s6o7R0F&e%*Hb(e1)
zXP_4Mi%~1fR^Sshg@|OHG=C{vNU_EfN(_NT7I2KbVB1EO-^iv{MSg($;IWVKv_<j0
z&tzGw!-5ZUcx_PVkKhB(@CUnu`aEGTuaAQk>Ix&0nuU|mm|PV8`R0#efpuZk(lW~a
zO)^lv$!Wf%xD{|bgdW8EZ#KAlXm@5Iva3KkO$vBfVnnKu+(X=Aq)S<m;bWEb=H0u7
z)22<kc;!ko$PQf_(H%}+4w?|U)+rPIw&}{EO>%?L!lF*}7ucxvpjbj%wvEx~Nb1+O
z`yDp)pZCO&0wy@i=hJ0+k&RJNZUJ7)+p00iRH*WvTTZN!0_|&M<?J5zDgRtu)rKMl
z8bE*MER1vqY4_Rxe_Q}JKL6RRB^8g6pe;tRxjfld0~eG=(5x_TYy@QA{bxj_WAS@z
zhWKREO9gWx=^WFkx)J^;b~)D-9PvNXC%d;pmiEG7g6xrBv^B1`493yN;Mti}^iNfe
z&Du-;dngHLXeHy&AlR1|KTlp4HeY$Z0wge7V2b26@tm;O%SZC|K?DnV8y3z{h<)H&
za6yP~RJ+;C=zE`UGiKd;Ds5TkP9>#;v*N<x7BD7dTmf$Ir2El)AF!W)s73jZlzd4J
z22s_?saF`uppXc(&*tUO1^g+zeTx(ShQZ>9$V}Y_1cb(5_H?xz*kj&n?A$K0E#>m^
z&ppmn)N`d$^?G*hl*6A09_iVeTW^3u2a&+(&w3uSGf)d{!r2xFbOs5K_nzyYKO@^4
zTwOI8TZz_(x-InGo@0!{v!O(1F2C}dTu%CPgU>T%vRY;k>SzuG5L~8@YIx6Hy|PF|
zFH1|SZ_EmSPbQnaZj!TQ9rD^gRkofT7~pQBxDryRn8fmb-ac1B09Fol&fgOcZ_#wz
z9hH>-Hr!+|3qyKxonjFK-R7OQZQ>fZ;t}&{fzb$d`@)1AD4rcMHqBdn?I;%nV>o$)
z+)wSen!mMc@GWkO;(k5SB|u5dUcI)02Bg!=lAqf;s_prTJr=v$6ogG{GA^<OBuV63
zt|l9wfT01y-kjRvX!?lq39E+6uBi6oe)$5*h!GinB2q<)_cICZCf*x2eT?iisLrCP
zf=H^aCgW0>toCF#s5Z<70L+h1l5~I&Wc#A9AMsz#pb7U*eZaY3DDKZ|ZD#nw?;IAo
zf<kdB7U7r_^|;D~y4ws!^81H}!9x{ZzIx>^fE1yU-RjzL&!2>h577Vm@Jk;qZ|l21
zb{k~4cQos$KwZMIz-M=)ZUwIsyef*rM0YigitA&GqkL|2PM~xpk4;)+@F`w>{=Ajf
z{F;BX%03k?N-O4)LU>?C;aBw!3{%rlqx|RZIT?fcf|4$pc=*4wx*0Pw!hPVi)EZeB
z2Z{tVc%n3k?oOCglVhx4&78I=Yj&54?Ik;znI3;#ITZF((-dcW`#m<@5^iQ@V)a#z
zFCT>bkKkHJ&ZZi7i1v_%igpiD;H6w^Pmd(^SYqr;umn&YQ%sq#-R~cx6JiEl6~23S
zLnISF%L-dj^SG~gU7HqR2K=2BJJybg8<nuw-2fb1_c@q|<GHDeOPa0qa}krly7y=D
zSoiaikbQU(;=kNn-RPusJH@y%$^|l9V^Yj!(nMiZ?X7lDbi@!^YA{T4_;ilxV;zrP
zCkG!mfTvX}#Bf3gVvBMXP&(TCVCo(!ME@JF3^h`Uq!>MemP2+Ee2V#`-oCw%Mwzu!
z{$I42D~r}iHqh#CLK@Ctv?YO&$0shec)OLxhNj0?KV)+ex5N~q9RT@xbX^R(QHiw7
zv(4Od`t+AHb+cXu2BbVqstcESG4q-2HA4*~$B~KO1~@}JU67~G5tEA?D?*ub0eNOF
z=<hNfC{7Ig1q6ayjvC*ef}n`c!a6q5#pRb)u^ESgTRt`ujW&xe*HNr&p#A!{kzcAy
zLbyS9SA9RyJSgbKD^bJ<)JVZ%W`7~6&51_2(1DK9iJR6%hGY%>rQuc|_wQCMH|ZqL
zf4@y*h~DGdb`?QrssJaymE?7c%BRh33@m2W&-AL6)F3Pb+(PfD$@Yj6<NWV*QPSZ~
zoY)FJ<)4x!Ui9y@dhOWXICAmgq~J*fE`(|1Jpo|3|3L*_7-j`Rdt*m1MUmaf6vo=G
z5D4TC{6P+sEkD9mdHn49B=%HM9KYl;SXx`FRonXk^D@Y7>lE;j0Q!>KLst-*m03sk
z6NUSVeTxnNg`@d@g1Twxda%Bg1sgK>rF+Q%Yz&Wl=!zAAI@8B9?7lT17qOPhy|6*?
z)m2Nm9$a9KOURV^3uy%8hlmX$XrWd1@6F7!z$qU3G!I|RG>ZBr2r@XaQZ3))CTD_k
zVh*AL(fQk#7ek`n4FNSl@sIeb4_`2U)tW_g9E3qPe8~49%>={GjL{0LSW1MGN|v^g
z3D}~NM_vE0o<Q96`H*7Cgk?uxjk84zODHkxL*6hm(Yj~?UrEu$#f7{e0a5MaGqXUR
z@WqQ4rK=C#x-|%Tut2RCJ5y~aq>~xK2!Gmodgeze9PhEIU3?LFegfpm@(psal%X-v
z!M&K#!{+&0_Dx8*EYL%4()?KUwmw^<aP_~)R+s1PpRLD#t`pO~Pb~umh{S?!uQ8Jz
zQ?QLxjYT;*vOIzylmYe+Oz0f#LFJAUVSuzWFxyPWRdpd*iyTvq?&IQmXOok$Xufr8
znHr8dD_5`PDo#9^cH-<`%wrTOy4-)9eMU|uC8^$SdB@;=aQ4)Wan=;JMA;xhXS37-
z*lFAG4ICJ(XftV&qC!;d_CG&M+8{*O)TE8xnH33Bg?=MEQNsBRnnn@lnLKL6rW_H(
z65Kgv8?Rnnn-azlR2@5(uSkxX4tA^k1)=}oa9?%Wqgnq_u$tsEGXKh8l&&M>*de5b
z)GRUvARRZN<h)KW4jR5}a{FK<9)j3X@-oG6F{<z?MH3UxpaRXy*lK_WEBPLnw@hXs
z3f}pe;ztHt=OJC+?S*P__3*JkN!AEfqpO>n?ZO4$<9fE-6abCpHNQfX%7{8L7c{kE
zR0Kh<(eT5q5OncW`f8lILtYVdjEg437E+8mrL7QeUf4OfiAa;ijb=7pT?5Q#h}6TV
zr+_#zc{2?U^}@!Hs&F56!4UOheXkuiL7dEdtECY5KqzN-Q{0>+cmRKpe#sorM-~Y(
z;E|dD2I<#|iZOhV{b5gC=RG^uL@;9R%f7JheIP8se;Oo>7_Y}9v63mD)DE04%*SsE
z77Vmb?|7Zsfzh(dur%VI_>BX?b<BSlvhe}@Tk^DOT%}G5z-eC?+KqBQ^)M(tpxIP`
zA0q{%U})g-p+gIKad0@^CaRC-L$ri%v*^<F@DFZHiXnSyazBz2PIuhEkO_#T3xx-8
z-rS#8qBlp#a|Q+&aKPy|6F7lk=>)Z(&oIN;3w%UG?>5~GkkyJ|@s=5dEt@tq1!kn{
zY=5fw2`@J|>t{|MDA_@@bztxeZM&My3-GGXdVAd+y)*^c!G{{Qzf$U+i<8;9so;Om
zu6hr372^ywP@}eYs$1-)RYyuLeGjZ4n|T+^wY1r{+=R#>Cl(fa%C;%Y=r|F=GhM#<
zV=ERGiuyyE_5Vd(*($?cij3#ar+Id}2zoE#6#xJa4EfQBr;}#PCQZvBEU|4S1Qa4X
zHSInOZ3dM&5b6CBAr{S__vB1H-W`Lf)>YLh;fD{mBB)UsJT9%GSUE~5=5Tdol4}6f
zbkdQSn2p4DnX^fH=gt8i^pnPwx&=f<i57}@6+9(i6lqHkC<q5pR5-GaAul{uijPvg
zR*R*LCcuZheLsIOFoi!KO*C_YSbY12&kZkYH1l(2H4T5IxDdTT_pYNuNAtiI;<n=g
zgpmtLZ#^mpA@)!YDkf&cMp7v;nUZabG8`bq0W3=I$W{}chtrFTnbnt=9l26fR-sSe
zb!Sk)aBz6cjj_?;VoXXXT*VdSnH^zj2C9#~<uzjzS`uvhf3!*~mRNof4J@lkCY4ni
zeEU8#I}EVM@Zhm8v>A&^A9r8w{&)oyz7|C*fvB$90WgBVeTI7${_ghOyEpJm78*7c
z!TG-DT7x!hqPph$r2Fhz{fZ%rP_39?Za;J=%w^s0pc2dYx?HlE99F!Rs@_*VS?CDY
zSUmE$rKWTsx0=++cu_ENFz<@{5sgZFFi`~dR8mrMowsNoEsNY88p^dxmkb<#CNp7_
z9kgDNU_jXCK$&I^3?8UVr9X1{^7A=mx_Wv-S5{2@aqXJQuLikHi(H}G<`>0;R&*gU
z8UqiYt!|8?SJYM8xHyVFv8987Gm6E$-fREBRAZsUHl|Nn$L6*NUUi!@$Fah1Hw*{$
zqpW>j&q_!J;o1p9u=c@xK!=b+QJA>5crJsVZLn6g3=FJ}4QfMaB~BHlgLC_@`85w9
z&6QPKiY`~qGk1@|OuH;pRmj<_xscT<#KNY=8cf9+V;CY=iMfD~xM-pJ_w(P>1msKX
zh-I$~1fq0KUc9;mp;#g<t+dp<G$tM<D(n5uAElBrBcN^7+p08~*$6|PV*T^`6XWAE
z`F4h`=?ZLDC|s>Un?OAPAg4qZyb|Cla>?#pyIh&93fO{OU}$=Jx=BK1fBI6<F(J~%
zCn0OWw9hvKAATTK)hEqy?9KD<|6-ws@Z>1(*r%2CB}Z40u)K*K6_QhzZ=J<rwI^3r
z^pRa6bUTF~pHOUa<<fI<l<9!5o0yefxF;lJY)XM45F4=&>~?xYl|f%*^&5b@2L<1b
z0QWb8_w+9+tD1zSJrqo9=(;~uE?wqg`z#U%5LAYiN&~X@-n5agcjAN&lSpw<={UOM
zew4{?=p0P<UoYN%kY&om5pjcFIkYG(X3g2mY*Ho@)lG={4-c;-Wl5C@x|e-xf(sPj
zoZMXh6DLljUpU~xSV$~0s6Lf^UK|jGKA6D2dZ497jb0aMHvQ9ojM3o19Uvw_o*i%b
zq)~38qYQqKvDl}SpFX*j8&8c#y{eR8?yG&TQ7#R>CaWx{lG{{0+ZsdyAWe(r;)q|}
zUu>CXn@rkG$pCTT4OO)~An%loFn^gX3qVKyQ8IR`ol3F6PHUi-nCLSO277W~$ux%>
zDgq9(bvy1tVrPZ!_T9U);1HTQO;ZN(tj|c3G;060`~sj`U~=kOY6S7ZW+)V#9}+~y
zHCgxqLF8ttWx*9b?b%{rUtea<SS}Jo-ALJ0tS(T`FCQ$gh#re-Q$%bW-p~nW_tVo;
z>o=n8qDcmT?5oj4K~CYyHEV9bBmlX$%J!#ZgaIb7PE54Y3!Xaji~tf|;i_KP6-Z$Y
z-Ufnwsv_tMJ$nX8mvjZjif@c(<k=}ikzo>epzp|ZB0ff8P$NnFtmGi3W47kc{8h);
zxILsyk%TY~eWKO4IV)d=(B<^rGwpsQcL=KG5Gby{^KL)kK?QH#Yzo9fx#Lf<Co}E;
zCS970_w3(PbM3P!yfYVE?-BQlYP+LZz)4iRoQz`4;qBaV^79+6FK?;cL`f-~diM<U
zoT$eSA3jX<Za#t07v1;Mn>pt9Sn&a`>xE)fV-R>ZR;0rudPTcgvE<As4|j%vAY`(t
zX2jYeiXrhO;n=ydCPI5$<p3T56J)Jn!!)Q9Ri0dClq1XHAWvv%Wz4JD13^oW(u)_3
z#Zo2Lphcwdz+k9k4Chs3m?{DEx&%;sW$0DMI6EK8@kV<tT&@?Vf7dlRJIaT+0+iIf
z#;Fh@R6p<pA*nEJCO`5fp+ziOwhW)h#*8xH_w)3m8X)rz>NI3|bF$OC(L+MBymR<W
zxuC{YhlkI2o5J*Mq?!CwqU0FowBF)*LuKsBHimrz=I*ha+om;EDq3F~<x(|yaN}t%
zrQ2_CdHD?JTBAmfj<%k=$hebK0ek|bR;^%mGl~tn8Kxn9>_4e%+Ce8(iI`<(E5Alc
zZE}WA@7^uR2&xf{ROk+66pSZ4gJ$K3Hd#p0yk1-$zz^v8xMNJ*-Fx@qGX@1?I3jDh
z@l=h?U!Y%n^u&ox1U=mI+H=%18N1E(S<A>8JB<+PPpO3I{**0GmzL&4)yGm!;0aFs
zpxF1z^<=C?UuigCKoA@U#HF%CiOQ0#$87+8F)^QQGAo)1X)~Ej(Hcv60!^n6YRFMs
zG8T@1TxeZGuKJf9L$g7ZlR*UK4FSB1Cu^xs>kGUWrhVBgXmQ*-(Z8!X*<C6Lx?)3^
z!IJBxx$+3^3i3>y<9lJ0-HaI;0B7W)ppgsJF0HBT&Eag!wd2q<#X(L6n5??GJ#gbd
zcNuT-BG?e{&_^{1lNZsEio_W7Y(19`qFesU4<9x`deG|C>vKexZrZF;S|98^w25;L
zdvK&xl(9HV*bj{?Xik+%-Zcay_K%-BRmfa0dg;z?w4AG~y?CDT6bQtTks4R-udRPm
z&M6%T+yK)TvxYN*5w0?uT5`M}cO!HW*4kDD&(yvSbjkMlrrZtx(=XbyDMMAr_u%3=
z48?^$u;(~Ak3!s>F%-^4?@bc_Z<fqY{IqLxosg5jDzTs1S)vbE+EtaZFN+|itg4!M
zE95jBG3hEfL%3(Ctg3y+FkDS!Sa4!=bal<%R&+rJ#ouXibrkzTDxgH9qr+@?`Lrgk
z70upi`_iEpGHpZNn6$MW;dC}yLaui-(VlKNh{ZeqlCrw?qwkT)I3R$G^!f9zXi2QH
zHxMty&=&>@Y1EZ0Z)FjCphz|=5zP0L7>kG(@b(++3;}iPe>8%Z<>h^HmQh`XQu&GN
zP<!J=t|=}z5EBTE9Z(C!{cO*OQ3_By%*gjrsuT8K0@`kQ>vfXKc@sF+|Cj{SEE_q<
zL<F#Ul7S*81_I6ByAabQX5wNL{9?>Z=Ec-WLjBm+f3|i08(MYRr%@tV0LCQ=yy1he
zZowZaTY4!QK3+0VFP?AYk>3Y?8e-x3%3F6s(*XL~=+OMBvIYHD?W?-y;JG6S<n*|)
zOB3+t-qLBX3dciu8jLA~0!W9Lyfw-|A)O!i4e_Dh5A#ho=aFNDEgxeYxf$jSg-u_L
zkSP;5;uf6iYeUBPfM*%A8%1&>v8MHjnn8Yker#X!z(H+Uk@sJof^3ICvGpczblr23
zfo!!rZ)+0_*(LM)hiVK4WYWWZ59Ii0DJSmnv`=7zHF|w%M%(xE3{EfXrcD>-ffXJ#
z;c&P{ZK@iUQdt9cFjF6Wq->znOd>du<%-N<Xo^kWPW!fJ?_LioG<pu{s>q8ClfS?v
zN&-v-wRXpJTG8?BwVFS_`@@o_<o7fDmz^6p3j-xGQV_<bx8@>-(u6?<G?or3A_czm
zG1?DpCo>lo!W-p`$TrNaFA|{T7g1m<KRLjEMU*1$(otw6&Ma&Aj>op_kY;rj$e0il
z4IIuWfZ`_PCP|t_csFv%8Hd;J`3qJS%Eo|Z!dzrtL&2wq6etLyv(nF+6UKS4BYBr1
zI3Yf8RlyZ^e0%7^Zw3_g{|}o9=4TeHn!V++P>|L7I5+3DKnhd(qqpS%5zhi$5pub#
z1xGJvqMMc_p`?8POSP(Mupnv97@Q*24(8`~v5uWc5@wQ=i^`(Y(3RW2CFneduR?Uc
ze&<e8X)u^)t=Z|T!Ge1cn^2}o#^e=C@?(lb&@*%WkneE)+swx6nS;m^<yv`~JerEa
zIfzr5fhJmd_=yv<;UB?Ko+>-xKwwRuclQ7tmVARRPr9|re1(hCdy8z5s+pQ7w8VJX
zqYDdN_{=h}WtCEivAYG(CRe1m_97iT_=mVw!+(h)fDJgk7`$3AL;y0TZ06|9=pJ<T
z+}AOfg{Hur|G`1eK%B8ZOh*l#mp@Z%F&Gf3O14}622AguAuYm1g~ri-*g60td6(2o
z?S3z4U97|Wgv%oIG+2uJ4Bbo<3Xw<j1&@9C>61Zv;Ii3Rq=RM%r4IJQC!79S%GpAx
zS-7wj<3^SW)9y!<7#oa=u9JgOee*`e4))7oJlbDlwCB2-&x6#5tv+W{a1E!EdPhip
zO=cn?gZzLqlA{0Vl2@-rK?hKrv9n?uwHR%W+Wv?L*)U<|^c;RPRlk0>ZWb@+_L*^+
zf8O<xYEdrM>u)O?tjAB4WF?}j&BQFx!!g7#FP#Xvok8|!D!p?+u-?=O^go6>j$el2
zAhsxsO%W#qCv~C%z;sPNX8^61tfKzOfXV-KPkp*rJ<4bQ1WLZ)uNN8bI&i@0vj?jR
zloV<<)#kmdGqPiJegaY0c7PLEa`dkVKz9=J8ZBsMaKNMBkpl1^-WLX=jT!{CgBL1s
zIH(=&13QnUN9jtd)uUIhnMUKOWJO7k+x$8p%xIp6ougy-$0pPUIz%dUCO#|DiultA
zBsNnGWWKM<YzLJ87=jYBed)9zrx(etEu<uq0K}Roh+IP)JbU!+J<CKrPK}1bQbss`
zYmxGf<d5i(NBL@4hg!jZR(7lfz!T26sARR{ZmS%EF<~SBn{rrqi_G$2zk8T$bYSDP
ztZ}OQI+!YuNHyinQcZ%t=fZ^(6>dR7fFjf0&+op9A2fO+y6G4X!?1@RcEZXKDI^9$
zd5ayEiH9b3#&-F|xGkUL+4I-?>?v-ScD0b<MtuG^A)Aw8*c`TP{mv#gxj<vBt;0|d
zJoMSsNS+p&<$Yn_CeVu?#~~6*{9E-&ep(7>E$h-cw>vyIE8e6mCn_N4{Jx23)=5jb
zkdUL|U0j;1-tdvaeUTVfb{u5wIyd<*?tqQO?EmiF0D4<+0G%C|2{O_z6Sc(<#y_!~
zxj7YZ(m(clpi(uFX$uY^cmF$pO%crO+rOV>n$B-iWF$&DHGl*wrQ+AG=?K(eZuI<a
zkUs_Zh`gvXXiz&|TiYi_cb`eE@zL`vsSdD=GNS=df#S5O+c{GWR&V+S_lD`3Ttc=8
zUUtd`QrZxl`TilJGy(6KOr~dKjM5)KEi7x|nCll-JwZAmt9(A@ooH3HcKDmby_$7Q
z9+-_PDu63*q`>WesARSuE_q6T;R-^3Cr(Jq3D8|vcB#b_stEuoe_AyU5~pF`zN|x0
z&r349nVzmdDVjxTbOsAOpU=<Q(xrNus0nmSZi#nJRhPB2j*cBX9AOAZ7NVJVcscEG
z;bVH-9%^;NH?ZcaG1Fhrn5c<v-&-D;_J3S}^2evz2pGb(!c?>=r{BeQC{PTfXvh;i
zF!<`ee3}Jv-cHO+fZ_vSJX58B`~BiJ1_I>BbVBw%(q4&Rk-YnVb@=4T9wvHmYLa1i
zkAy)ev<mD02Uzf}2s$?zGC)t?3IHLGPy23Pgs$`>yqM5<z40rVZe#VchUD3onw$Sc
zzRvJzE}%ut4Z@<>)o>E#u_u?lwffc45GBsA3>oEbg7Jf6y~bAp4oss>H(GnHwXcsS
zwhjOGZ&~URkM9h`M08KnC%zRRADKS7_8RvYccIf`FxBwzLoqr4dzD9>^ygapPMw+q
zH{Lrm?23JM<Ax1Kaggz~Qnc1<&;88=>_}n;a23%~iE)dti`L2w*UM~8M`!fQA>Ger
zD%7@GzQL=uZHEqHDH2UDO{TO8GeV~5pE#{}Yp20GI4pW+D!2pUtM=(j>;f;bnd6`3
z{zj!0(4t5nX{w~8>>Wum{8#0~+djE0a|SSVE!2D2{PrJgVMArqMu82auE(x1(7=|>
zuVUR&;ZzQ*UCZ#B|7^ixET9!QP&SJeok=fXW}^+jkaRVmx*0QIk@|j=az%V_ITMOA
zras{eTS8CP?cRMX5LCN6cFMyKPh?mjnla`=DF?ov$2t@i#4!r-W=0Xlyb-bB1Bj8W
zL93DH<%O?{Wfu*B>lRyfWn!YhC)f_-5`*d-{@VU9ed#Pc=gu8ZQ~$5VGc8i{MVjAX
zmamWGCovBhgA&TsMCJIgW4I#pb98d*H@rzNZS4)*0dJ$3PC0ve&lty8*FFB4A&E@H
zdS=6IKY?4x*M?52$;alr8{wt&ddVeJkmljDPHhznJ6L8ZbMjz%eMb(n969I&Zl-kD
zd=`dkx5<;FfvoD(UUBbf9>xO#`270hXkMBI^%$)idk8Li_n41XG5_Z)&O1L|wL^#Q
zkEZi@jwK|#(2TJjxE$dJMAs75e0jo~@O`>JG;)3ILUFHG7!j#b$;tFa@3Ct2>UBTf
z03(Y)iJK-;a(ZoiE(W`q%^I+X-l(er^1z!us^-wl{c+s2B%JxM6Flb4nFeo3CZbBD
z*Xc%;CwY<{CB~yxY#NmmC?xYgUi=5YFy0nFy-D}|t~6FCrBy(axN;dynm0ejJg2|L
zn~0(`zlpSm=eP)r6z%>$9b5}bn&x^(WMb#@0=bZ4`n8PejUD>Wk|jzF&O4*#V4vt1
z*RrH*ynityAJ4&&byZD|--N#NZ#E(i^D<0NeH#NbDQ4BcAX<-2UiTg_V7G$o?fGx$
z@se@cDSBcf_%P=Gx|Cj={w2*?b_6ObgfF-~bq0NmHtE7-(MyFq+mEC%5s?CfD?0YU
z%f$Jh(m*U{y(WKZ2Qe4l#n-PJTswcHEnk|_4TaSXOkPO!P2QyfSa+9I8eIOlFN}XM
z7Z*PQx+Nv!$g1Bo2K=#b)TDCfOlwxO-bi)L&W&S?Sb0p^oO<5-V~SOg_|Kd*tEq1@
zuNcm^UG4MyP384BP?~h7I_E&0qQ>1aaP&H{&Lx3qlObetP_!e)H83^>$;z^<<*T$&
z5Wi8KiXbgR!|in7B_M;^iM}{?@B+m|2LE?G!UJNs)~mvvxks3#**iO1^G)BDmX6~*
z>-Ow9p5vq1rp@I1_-yZe0F1Yp=o~9gfh;&45+N|LDW6{cIJvEO?P;nAw!lt?v~ue^
zbc&`wD@UuHg)(4;6~Sy1^GJTVKTjxaRo_cVHA^DTncV*ZhRwejLybLU8&q9cTZIgD
z2e9kY=g&iZ^V*F6!)FYqH_z*9_JslyHwAN=v`=->jVR@p=@Koc_udPf55dHHF<*&=
z7^~rSrEKef&J_r?AT%O~v|<IC9|g4`CfZ1!*%0pa*L}8>C!am5Bgn1Czh~4FB9DKc
zc99Kz7wh5)&i|dfdUZN&VFL+S)Oh~!%OJW_naSQP|M=|cOTfXh8xyIF|HLAhH#<5w
zZ0FhBiup~V38Dfk0iV!5)h&#`B!>|WtdPxsIkk~Y!<6$pc8v)Y;rUBMy9%gevRR9H
z`!%o<c?=1HEa;n=`Oqf#7v0OJLs2($T|crwMUP*KnPZ4eL1$6)#>Lh7Y-l_gM&elc
zv|QImIXOo-VBCT>;}QV7Z7ADh6M^+XW81Q23<)eDLu{E?PgR!aGFfUz3A=-JSCK4i
zEwLQ%i}hX{4lPzf$U##$cKWn6$Osyzo0gOJ>ca)w%y){@D>pj-LiNya-*M<g-1|?c
zfK@<h>n2|QVlk4`$tA|Bf5o-8)UXuVA8G%#JZ^W6B5wzU4Sc|ZNzLguwG?#w^l|Bv
zX3-A!5D*TE)&Wn-vq!KIWUPcjemS92+>V*$c>JkR8&6!jG@8tK4!gLhf>ZJFx}CRK
zaA5f*mTU=R3M&oCh@qzu@5o+37HBA!G?)f-hABpC$6<TE0{QL0+TejtbAJe?9j`>Z
z97N-}W6Kt+6unfKt2V%7UgDx+Z*NY;`50}HBqr?m{9FBY8{mw0oF=P!%?J1nlUQ|O
z;Y4PMV7D4EZ~k;yQ>js8_w;YQKZ8Gb`jn4ptdY}o=DC?p`coA9-PxrXr=(v`wW+?!
zo(2v32AhtwQ*5d>O4lIasHH-<_Ssvz<~)ra*|^uP(?*be%crbMOx$vQu+G?rAJQ(|
zUv;Q_&DiH}57t~-*t&6SSy!MCJ)d3bS3tvHhkSi7r2O&63P>Rvt@O_B|FVT%Xj596
zU#gdWx|n-7E}L)zA)-*i2;5Q8UvC~NZFbmBbKH+X_nb2aFqBonKb67sgVM{ewvPcU
znCb0Ix_o*VY|(DCT(f2-FmDTI=<^6dgMC4pVbhRw+y=P|w(HTASltbP&wc)9qRmd4
zpB+>>%5bv^3VaWcMs{!>`=P6F{&jYs-p-J<Y;JhFd#ZD53~+Q+l5p18K(!RXoc16t
zCV`c;C_Tn8m#_dh8rOc~@50LBm2X-kGvzKQYUfxA6U-A_#uFUP6P(C2TPsj`$@_a9
zw0DmiYi1UhHCMJv3h?QPp4&k8&7SGKWg*1D_*Cky*YDq(n{VrU|915<>i)4}f-N-$
z41?PgnztEJhBzhYExB~CqL#;DEt_hXiCK`~ESy)q3NlHcIBK0tmHqv8x5LU{f_o-A
z_2I50Q&KHqva6!3JQ6r)EYdgmVL@T`9stf}r|eWxohQOiGiNe-i`k&1sK2phr4KzO
zt(Mq^11%n`wfcUa;^AY(>SSbLOGx4>?b=yLB)d23Y)<Y<oT}<4V*xKugEy*%)#B)D
zb${1ne20}1E(;VO8Sg+4^&Q%A(;YXmvp21+ttj-QVekYVy;@$5V4p6}OpH2eil(ou
z`Fvq4TL@gsPhh8K<zu4p?dMNj>R0<8&SwWQ<i5p+4z|+MX&STvsDJ85%d0|u-H(S|
z2*Hf^tP5<dx$x?@M!(S<+y=1=8FyS;ke6)LZ@TE3kOqd|J2-eJ$ke8a3R=rsAXsC8
z25*n=lWImsb&KKoZAcfvJb0ef#8l_rd&LPN8Q=P3tj7y}47&{@EhN`Vm(uIQ{E4jx
z$)%I37y7KGk7_7eFa0ULnrPf8%`uu_I(jsH>4W|*cMY5GhYRd@WqB{$(8U#74mP#j
zCOV=6Af-RHJJ@x>RAn!Oryyo1Rv-1R3W>XfiGo}Ejh}GTX6DmGV{B$J-CI9&QLlM=
z<iWZ9D-$7L-(rjzY<)t9=F9he8HM+F!VkM&N3XP;Js3(%KO8;2Kb?IzoL}2SBYVL<
zD?OHO1crSx1C7(ARrdr>Ftuo%WNDzB(jU-5lLmC={8SRw4m{Gy<hP$4_;n1D?=ciu
zyLRt(JQwzKo*wKSEpn^hyxgGRAp)52n=?VK0Nb{w)%|_`dVpVbNw@E84c$TQc(72r
zGuFCB>Md^Hx}`}m|7yO=T$+lOO9)wy()|3QqJvqZQ#QQr&r;bmb2Qhh!P7bx4eH8|
zM%TKn_Af)wV49rY)G@29e=USDbPUml?(pG<KKhtMy&1ZM+V&Bi#azK&&Sgj^yGbDm
z3Gjc{58UTq{AYIkT>D!+_q&)6lNOdHTg+F`EcUI`U`ekYxP~^7LytJ3?VWOfzIaLU
z2Qdsj<o9=#3J&+U@Y;Q7JYm+^{a1g#k9dnysNd^{mr_IdyFA{m=F#EPF-{s<`Oi|h
zOmE4*rWSE2FfaSDLB-ujoh2RheuKS+m_}(zj05n>1poW_>FG}3yn`HpF&{6gA(hkO
zC3K}<)`Vj_aMi1zb`B$q=ic8nuIpg%?vkfxyOrPo(ZSGF0is45-B4N*`LXN~=}`hJ
zgVUCvIoNr1N!Na>e|q&pZMfv~vjIhw3-MgL{ouiSUzhWE3WPFF^XJ)Fw=^C)zM{S>
z4!Y#$QEXb6D5hjI)wkEEjTaXZ9%SpYPpwp&HpG%i*+iuqiSRc4>R9F!V^Od<f(@3C
z#zgw>S6k6;KLn2^4Czc_EH%ro)%2F)hzfev{QDA@!8vvk#QULUl0d!$1rLuVWYVel
zeBWO{b>B%O+nFYO{dGYwEUAYGMb5w4EIvV$%H)mqZrYPFexiI@x`@Cq_hk}IdOKgO
zdRz!~b|<v!-SCt`xQGB;x2SM}of9R@4ei=CUn**vFSDG04Qrnw=bnSfgM<+X!(E{m
znOdkU9+_ajla4nWO@UMj?uP9H!|XidWPpNoqr&woEjvwqK%p`Lli~&WS^jl%Nd=jJ
zo&X3VKk6^P@vNB{l!UR=`L{ShM2OZAe=i(AY3yEfeol%LfimfQ5&pByHo6@eyz%%o
z*@&Q|rMB%Se#3_yH3s*HO{KtNWsl4w)wX^~CEy{?IWp;#gVoffKz7)Lb#PwwuI;E_
z?H&oPjqy~J$G?{dy%ZL(n|Ojs$#sy5p*#imxmNZ1RH7_{W-tr3oiRDtFYe^Yk!a27
z1Q&4&GnNdshE*-Xk<h~55SB+OW#A^@V40Ol;_-mZa`1~R`36XO!*J{1mmfyV0A(cO
zbztM9Q<*5;jf<B;+IMZ=2=6D+dySbZnhTYX1|$`a?veBPh3l<P1W<EA`vxL$8>I7`
zRCJ`UEXuA2qwYqgN{n*&ib$_R;7mm6IKAbo$&&B(8#4&MWiL{<@P)Ji!%(k7c2YLj
z^mN`v^XPhGY;(MfHh41N9EB$aMuYci9+r1IyjJFq&Xu0i7#0Yhn_8i1a-B>J8LYQ+
zS=*YrwEow_H5&P8SLRie=MxdI=h_IdjFr$1AC2STzRRqYi|5&|0~*64c0I!P@1OIn
zrcHS5@6x!$bi*xUDxI;nbTw>$#72LllKgrS7#Q@z#n))~Ax$6QWT_=incQXV*Lu`R
zrTHJt*X+jStF?}~lEw{pz+pbVP{idRGm70r49#8#<TaTcA`SSxMES27jk~yVXOHMN
z1rL8a_|(ba(q!<RdiXTAP5@kEK?{_VF{@Tx%2{mI>D1pyS<|bKE*8Dpw`(qnefAVW
zj{fHB;sTmkC~y+P>4Co&uEPD3nRq%UJ1ES(o$Og5$|-5QIW@fMWql@)QEV9@C!IM_
zZTda1^$&OdlaUf@Mk!@baydFKBsx=+v~zI0+nG4gB2bx>Rd{sSu5rin>*}3sMdh*y
zKgtZsNl=566%~|0>?hQamNxa&1@H_T)gZ1`(>?wR3DL67l=r5M%EVIF{ROiw`ZRyq
z^-;h4$`US!GMf5*c*Qd6%tkj1sln<`y#05=@ktr~>1I?7ZtP_I;0AL=EfGR?N9Ya7
z+k?A^+Z4Ka;}>tB1u@UdXx8Vd!p_^7CC+t1__yh?n@1~uh(Y@8--qV4b8gE@Au5+2
zrq0t?*|&*doni9;QR*>PGPQ7@!jYl{Jz^h+x3ALXqe3hUGOd?jABsjQN~a*?={(`j
z^6uE@(<IV*YU1Wy1S?1@Ef2&H0$Z`5Xu=r-CKQb(<gKJUYWRC0Q_L1PgtDJySD`Oc
z>=nwU4TfEGJtgMfdOKfHy<9D?y+5dUq~6XbM#ptMoch4x;C8j{)XCsu+Whg;FD|Ob
z1`N5C;Q5-U=kETusFpA|GS7$>g3I<f=IfNqtx)X{SVz-;rCb{b?Cg}FMu0prM;!%=
zq59VNE{abu_~gJ~6YMafax5)R{Y%rui|u>z;ou?A(#+TpoYU8#H4dVnC>-Tdfwl=(
zbyZG`;ea7V*{b5c)jZO=a$C)8(1Uj=AE(>ZiIyf%c~sGbAEQp>`5)DXwpAFRc)a=}
zfT&0y;T?AI{mjMJ40PpwD(c0h%Ag%r_@u^XD9fAjF+g;cw%=Pq`J&XkxoUiPNNR^6
z%j5G4-Pm`n61aW!(kEGT7g>tAt6y^f`9WkV?x3x0J?dmp@dkPRI)!4<Xu=Iw!^f+{
zKIWU=_O`Of7(NtFYY_uGrx`;?+s5qir7Z7sJg&ppr(0+VniZ6cRw8>J(Z3VZB|XGU
zJNJ$7j%l88RlcTKgV-KL)A5@Ps~8xmeag8D_n3#zu(ILPx;a*QZHObNI=n**elxM<
z9)U?ajJugi+3G>zcCdUY(`0Io*VHf{*7kWhqWo39_kg!c2Gb-MR1dZ3$hThkZueBp
zy?47rp1kmQ+QQU^AXXWhbLMAodP69@ZB!c`pETz}`Cvd&H^cTq8{~T{n<AucxqDp0
zfDHCXm~u$((CQz__3B)EaKZEQ6R4{xg#}{%=f#Vt!m@^C8?I2^^HGih;BDx1?6H>-
zq2gu5*INusGYp#(Co`WPns?{^{eKxj4-Ve0DKd#{X*6L(MZHBd7l+n-8BD5uGSB}V
zO_`{UQ0_K)=9_k2W>9d0G>Ac(fk&8WR#m;(CcsiubjZA01ZW-$1Pt$=)!e3&c0J%A
zq+^Cm`Fs%>z=;l<m{y=(8CvRkFNG|%d2;xtbYy!D^NX~P(d>aijQQB!z8h4VKxGgp
zrf+RHe+{+7sK&5;^KHY<T*lm4+4R$wGf}rz(`5^Bm!?|Tq-h*)sEA&V+fGhvs$r2C
zMGXMdKRU|hPnl~8l-zB+s%E?57w~NwqVUTuieC3->!5k(*LbBgY^H|E_tVmt3r~--
zt1gNP&op~w%*&UqYl-2e*)M~J<+t11@Mwjljg4~8F%9y&cp;v5u$-BOM}JgaN$J{J
z>`Y|Jdg#mrfl>q>fZh3(R;u9R0eYSFNA<C9+4#n1zz;r3VO+;n2)9OYzJtQF*aaBh
z5w-(KzG0cwFc5nP7lkXQyDZC&=anrz_~|eXMJ+kA4qBhjifd!wcBd}Gf4hjV2pH61
zT-G)op9poXewy;))B<{ggP(0#nh<H-m|oh*D@TUJ9}?!yfd)kf)QW>wVEypJ+qWYj
zWDj~i*NX-Z_A|tTp2Poq9Uajn`>&DS&L%vP9Pbnxebw!jx)cbMVB~9<F6Z}u(V(G{
z;k%NS2o!nbfnk{uAOu%g`oSNiayjZcV<yg<t;ppN88=pLQUYm~ssLDKrLR&R_8(I5
zU8sHXla#E@j@H80<GHJxxqzc5)rb9ajZJ>EkvSk(5x-~rOr!5?4wTZIYW|Gkmjfav
z9sak<gLoLAyn$C`wZC6hk0HN8=ULDRz<sLAJY38tig!qQott)r9Dox}efra@Z|^c1
z1d#>Nx^;IQlcGjiQtZ5$IimF-aLkcPNujx)xRZk!&(8a`&|s=Kxp58E)vHhL{MH3Q
z<GnHfqV;>7SBGp0JX+1_4mZ^7DkhEQVqQyCq{SVd_K$XQ7qTWJeIW(Y`qd<sFN6wb
zG~o>lG{s|aLlW$pSy*KI{o{9;GLc9@%+{N3sK$g?fkG+XYFu17+ot^G_G!G?&-BKA
zVat|JC;LV@XgX~ZE)Z0#<du;!fz;CS4>J4JYxwZa-YJ(K6keG3R7Eh<zTv?wc<L)Z
zrxa?2TYk-->N2b%1?&_@hYZY6R*jq5AF7?%k|oJGeT}CggJv*Ul-+1EU0op^vcf65
z9#3wC(^R6cafjiTa``kD@?&w@2#ZsHKl3%1hmK^FxNuE@{jw8fFpEtRZGGFnBPST>
zy(t<}el>tE^*wnnX%(cNgtvuTSx{Kab_+@gVqss%{_5?l&%VMG0_RjS`V!#|KjWhR
z8Ur_F!m>VXp7B*gUr0>XfiS}K_iX9)&gU7^WVjlRJU&Sa#%Q22nr+ilcBYAi&&?{0
zqjQ5l99q*7gpm_l*S^-Pobo6Tem>*XdgZB=ofkG7SofLV>BW{k+K@nI89y#dmDPgo
z+j)rlwd&G14*u28*?agT<hvphkNV6(pGJRqLgP7OYvOY%v$snw-B)|9SXXjPfA8II
zEV*f_@ve*13k+L<zQL#{yy0cEAo0|dmg=bFi-w9Ae2r`3x3-oixDQu9>dTieU#@3P
ziWktx?OR-YE82P;ct6vR>p*Gw!+v{@*Vb?w-am-!>C-$^!+4QGpmI_1S;sgUs?pK8
z=`eHyl_@|U$2y$49O^|L-_(6f#Z&11qw<V6KV5-3-hKEm!lY9w&`8vqVB=pmJ1$H|
z!Ao_w@>Asmy*AYFh8SKP+UXc`^=c<(QgtT_S8;BTgw4u(F*?q->eVK(N;qNb2nqGR
zUQ7nPlzPAY_hxmw_;}<0!s9I}zt(Nqc;u=}uS1QQ&`hy3nh`_(CCy6Gv1Z_+XYVZS
zR?IrvL49i@)iJ|TbR31K$nUVtZQL&Q%Ef#i&z%X+E-u#bI&eN@(<9k5+EF4URf}sY
zH#QnH=7^%TdR%&$X?B2Hdx|IjXwSMt7@c%T#Fwp8R(y{DWWu1Oms2!UND)bn52=dI
z_hw7vgXim*J`wB2Fw=GD`Roen5zy+9wyN~WFkJ87xjZ0cMY;3JRjZ;n>ha5qY5*Ph
z&sa>{d3K=UHr*w?PP$=p_(N05J5PtjH1b5=s3;pkX+X>zroW~M_BXtYoIbZGr<3qX
zaf16NJSVW1Q-dPIV~1#7xqMlcIts11yaR71i1t|`{>kSm5yNXf_0KWd%0Z0WTg#NO
zDL`RF56wiBu$=pEuS5HMKR+8h0;CYOr{jsbfs8w-l(10ibnHzwgZz<s=UzsB<&ADJ
z*WsIyl$uj|aT*z8DGj_o(z95C3cDW}SEPFxX%86CR&|UPrbX&o&A%q?=G8!+fQayN
zrn{(o&`tKbrPZ?a8YpgacOHITH<i)Vu}O0hS}u4J4QAAl?7j$h7UC&Dk-CxBdbYh>
zESSrp=;qcbt^SV-5IVzb%t3yz|Jk!=C!}?2w4M@L8&L-^d3@(EHOCXM3Dh|dXUBiy
zR=%PdTACHiSXFV1t;j*d@+rh@1K3`aN0Kmmf%}AnoMSuh84%Mvcc*`7F-O|&n&ETX
zPi;+XAJt}NW#Ogn-N&0e<B~NFR2K4_f!^7Pd|X+y9(g(v(H<S`%8ui^$3~PcKF)ur
zTfI^`x(zXN{;<00df=LkydCWDa$`D=%ilBU)Z2=Bd$`lzUeV<pnd5XO;v1<R_WBJH
zoVRbnZBN;4ZU{@J<&N4kN_7yTHjuY2!sR)!#?c#dXiO89MkW>$I+V0zqe<wgDzP-U
zc=_`8%OB`-=}fa;WRaihY^^Fdc*$5I2}mo|91dpj%ZJ2s5}+7mRoWPcKSU1Is>PeT
zxDPLk()o7!@|n>I_Ts`4s4UTvce^^ZGs4BzCa=?Qv8@j{rEtU0i%|=8m!6Mqk^D<)
zjK*3G#vNAyu7AI*j#l*u2oAJ{_Z5|~L~d>hN<Dv^?jKa1&3Z76U(YJ=RqmB)=U?#G
z0f<L~1CR08jooIWQ+D2Yn-WKGjBQja?ll=WU6`?}SBrp^J{uXdk4faqtX0}ItmEo?
z%d;Puh3BoW+O&Q1Msb%Xu0z;md3=&{(*>;0Xt~i1BgsY&DpeMPJ`To`t&K^ep5ogj
zFp0)!WeODNclB==1_uWNQmpZD&_>Y#2$WE9z&zUalXj2Sb`(fFq!m#fkDpR=!mi!M
zl<dmKz#gkF^TkK^-us5VKfdqhf-k=WU!WBHx_!$GVR}Fc68$plpDPD$el1#44n6LQ
zv(N6gch=XdzcMm&b_k@7m#8Y#Od5Uobn2RofpUTc&<GgJ-`bk8tFl^@O$}M@J!&ez
z{51^?&lD8yzdtK5DCp@={rGB6pzQ5;-{CRyF}n3Zik1x!DR7oCSaiAD5Ujnu4#=La
zz_9Bfyb@VLvpUuJqdp-qGZwz@5vDU6mJP@&@uB^SU79Q4IQJ%ydM5ecr@GY2qBX3w
z9hjTK4&>!(Td%JI9$M8g@4<PgMwPFx>2?sduY7%w-uS!<GL$?-y!?&Sw`yv5PsNdi
z8wcERW?lWoSjxDz-*`d$NVS9v82SJgTo`==167k9uK#~<(3~k6haVmsT>to_CYz6b
z{qy5tVO-<${30)QoiPfea9-*A(5>HoL-0-tcY&NQ_~NkBf@!m?A^wp{J*Bntwy5wQ
zRJxBQ?$P9ZEtt0OTXHdVqKI4M6|kp8ErE;^w63-~gO)%TL0#V#lW?@cEmxM@5w)O~
zkvjY}>IA`gDGDmSZx0Ce%MY5$H$gk4mOA^x4LH$4iwF5xd~GU0V*cfe77avb8mMet
z9`to4-6b^v?ZDRCp4UmtxhNf#O><DgqCWiXQXXzWWQAq=c+NJ`f{9B{m0@?`?o#IT
z^6uPq7h;`s92=nHet2hi*wR6SAoLR;zQ@(OG#AHf1`r9Qnzj=t0~A!pP<3!AqTZb8
zf!dErs@fp0lMjV}TCaX1C5>ov>epZtc}+9|mj1GH(N_yD&>?!W<5lg2CuM&&-`~+{
zW?JmDz`|czh2r~Qs)PZ{ZQFjWpMw)OA(L|N*c;x8z>EldW=cexcETvbHsDGp+n=0l
zQ<lUPRhY9{`=Sp_02|e=mKRJFSg$jZAzoj%>w(mJ=$YVGUL^z>=+*d9ku<(xSoP`b
zLu1Fo^WpL=d$1bW8eua+<MVPXGn7qN_IYBs-%1K&XnzR{!stVe0K}8UPyt?K3*@Hm
zhppoBHz+HnINh&)CVC!>52452sD4&40|e*i>S2VFmvHzJ?B}LL7yK6OKa{(Z`QGH;
z4M+6}m!@RoxP0v)L#BNUR`{EjdX%WJ%_QT{kQLT+%s`I*P6<F!_%scJ<eXLZ7bt~1
zIBZztg;VWt$84b0fRlQ#d^am>kZ>%%)~X}2lV%WIoSVv~;D#h-Dy}o<T`)kD9Ri3b
zBQ!QG7#PtPp#%Z_HPgoUL_fM?(0Vuv{>mGWBnWI0cYS5}BJf_Cb(S}uwTSetSUn6r
z=Bsz_rbK_SH9gh)$cN~iq6{6CcP=aFhxRLoZ#<3YTz%>|e0dx2SeFmm-&_GiKMCqB
zq;g^?ue&iv*Y|Z9OOpdo5$DfIEbV>t{GuF3&o%Tl)GW0Ax<0#{a!Y)GjC$<8bNX`6
z&7IL4HmB5~+O|p<-i*OKdDx9&qf^WqbG&A#ac2~DVa8<ub8P<UMTJhXOaNt#s)_m5
zKR@#(f~b5MGW7X>eaXYCRj)&3i*n@Y`wt#8(#rJi{Mg}&jz!pd<w<3YEfZ6Jsf(;>
zT-Vp*(4a|s$1*1Zz8E@vw0wvVV;L{c9YosH!fggULoOtj{~+=>0OEg<oaJqt6AMT8
z*zGh_WhJMA1ng0(nZ?Xh90Op)ow?k5YHSzf&;MLHYh5@I<ue0<Z6^Dk%d+qQW$jx}
z3SoiWKq{Vi_4}RvF4H(X+lE&wL5cQybgT)~%lo6R`}N;%)xQ6%=0MmW&Kb8mpPhAo
z1HAkf#W}4XkvF1py`*H9+)$?C8UoFUs|tG~BQFo|LU0GbO;<yuqE-1`{|{ep8rI|5
zhJDA9Qf8$LQ4vW*l0<_vkf}*3k;I~msVGvRXcCqNgeIksgbYa$l@KMF#}W~eP?>sv
zr?u|wc|W}G^I>iGy$1FFU)Oma!@lpwe&{440jGtw%CMspNK5o<S%Vw|mf*X!l(V5l
zFm1dHQHUE=^I_FfGM>Oo>62zQ_rcqY>~QJrfaPM>1Dosx4R)(p6v*IFpJ3HaJ)3dv
zyFoRoamRUaLUV>$RxgkQ$6?(!p!4b6@h>1f!r%+$m}oGN!-RKxVU{QCeeQaUB?{B5
z(z1#vgr7BI0X{-VLZ~n$EnAl-1biO`k}Z5J-Wm#+m$nh&Qtzq7)lAMZwQZ7{!*X7d
za<H)7FtK=f70^?Fr8H4o0h3f4;d^{L?|81O*}Ugx!zlut(QOw36NW@t527{Q@iFk>
zm4@jRr^t(9LJ1upA8mPN7D)Q;G9Rbg93nGo9$pLIH6-dvE{z&xHX42FI(6L)5H8)O
z$a>Q4&eBDUf^ILj)>}O5YskV)OAW@b{Z0gXpWL;a5*!D!f9&40y!7^MiXBcuR^wP8
zIU(q!;2b}FNVO$x6RgPDvuDd9pYLNyA-TqiodVu+_W+|fL+zl2dj6|CU>USQZ~0zM
z*B5E4ptFjpI7%?5<M`{S*-CyY<@1S*k5*M}GwSbzouphPC_At^U8=OjRX3h2J@~=%
zdeZVF)m<;B@&c-tiD6D!WfP4U+6UQtJ{P%^RAg(;_h$g)#iAWVq)VlxQ}bGH?Phy|
zn01gdds(F5a+U5sBx=!Y;4idENmU+6R_e6++;#YU4k_StS^a}153(Z&8Z&s?$nbYP
za$bZS^~YXk^ZcxByl<L6Vb}ERn{MCj!as?DO5e8&{2HDaFlW1fK5qZVQ<SM#iaGkI
z9Hb-!Zbjfw(z@}|EW_3ge3Z<y&#K=qc?_N7su(}Oi}zvxps!+Rm_Kun$^U6a@Z;U;
z3gsfCw#ypNrvGNe&$i18f=rSm%&bK(e%k3nuZYixt_5x+_A<XYG<J#hUg55XFnmq^
zeWEHI=9N}M)sK|dr_8s>Wm2qlQrwz-A$bQmKt0BiQUdap(<%DImhYgYPC9B#(km@g
zu<o(sw9^Ru(=zkpnHO$1-@nm}{_MrJfdSq1qe6$$mG%rfWdBvJZ3VJ=ffWzQ7piEk
z=pPGLIk`n+ZjbRup%!0SbtI;I^l}?c0#?OCyd(R9za4lwYw#&Jmu%zH2OsA7jaj<y
zxb0|%<;#ziMP54DTbzP3%N@7Ffd5)Qs`H?=AF{29B^J!^6BJ+6)VTGkIY&&-3|M5l
zV)3FyFa}lcI!2K@9WT%kk*qI&YXfEA?JhfDO*)DoTc6Z55rqlMzg}&0KCcGOB?+pe
zFK;4neX0igr!x)@VUTe&*Xr`O1Uh448r|0S9a(M7OKZVJUXVH3tNpyaA&0-YgodP2
z$_#GDoZ6)Rz(%uK>ps1hBoY{9dW>bn1f9o62~LDN5MGQrw{#bD9sdTpmu_Oq{fR`1
z^7^mXc?jcNoxU?Js>@*kH$=4A(v!dpsqAmv$ftJ4KfoC6nQ!Z=6*_&P9S$o6&}+z0
zrI3*y4v2MPoe)JZJi_?LSC;G6P>?{o<n@m}h#Scvn~WI>^I`6LAkPDDox5E&lID`d
zG+m913M>ZY`9SDBIe*2|X;+;Qb_Sgwc~BFT>vRb**@U4*U-^XF@#DH7u(tozkdvE!
z^tf4<u{n&rbT?VP&?Ba<QM9w;R%&{8wii(Z6Q11i(V9%*Z>0<6Y?IHK+*RznRbRe>
zZ|wN<g0bi~t}})Q3=Y;D67|`XN|eINjP^*c^z?w%j~5z%63|OD>1R>*3W+{!a(vOE
zCmA2F@(gyx$IG&<Cw^u7M&V_y9Q<>cWl-Hi;qN-fW#jBR#j)RLOjAfF6rs`ofi5>8
z0qgH>WZ=rH`fZN>6dYb4W0w8=PS5YDd1gDB*nZL~Er>cWIt-@=G8q|%HgR&@(%U+L
zzr`HEy^Jk;$J(gNF=4Qye6%TBpvM}qCYBbpAh1CBM||1ef}F#<>R6^9GfZ@CDB<o@
z=U~&-eqUN6fcB}Kkw$`CLW|+C@xXtLFmO^=o5rJv7%2!KbND%(6-P<Xx}O8ul~_QH
zAwXxwlIaPR=gAy>ih&lxQH1KtE`h&_9vT8NZ)5)`-<{)-JakNaSsU6>XJ<`s&7-lq
zcmD;x4SRRq8FEhWc{xs9QYx-J*82<zpT`bLLK*uJ6;PwQ&Dq`O;45<6D+FYy{0Jdi
zxI3%{=(WFL9PVH(EiKC9#>MUa3M))vUy#!*ONA!Jw+OIaXT;pv{0$$*im#5q^3=xP
z@eh|5Gx{GH6eRIXX8(C%+bs$g824HJWq67}(BO>H$wZndAmZ@yzaMSCW@xvrX7`lA
zDC4#{Wd?jXcp(kGPl9G=dc5xT_??<>S+^&uqlR<+`}A=iQ`9Xvka4$OKw%M+{U}ys
za1~Qyzlqr4&FLhJk-P~$TM;+R%{#tr+cvYxHDauycV(zvFMfND(+Ka#5~gU3M5To(
zq%%7_>hx3(qIsG`>vv$?vuxi?6jYRUSBB_&rX4zz2p_%UcQfYbA|Ayx3j^f{`YI$+
zuSF!JloN&D3Wnr#W;AKHTB!fmd(fRtYWZ}f+cKXrPU6dkhE-obyvZyBo$>fNsTFdF
zZZz+yqC)l?!R3aA;sEm3fQ@C#bpbGgx^IT5ofIK^Fclwh`lQnl-=1UDK_~G5Ys7ME
zaVF(yZqQoSJ-u*tK_3B%SjiQwk2`vQ{)R3rtUS3i?;ROJd3UMsVeY-V(T!%p=X-<G
zFRQoYiT;PG<1AAP;g6M<iisKF0~oqvM+tS4UqfW`U~y4HLs>)E`OUZz7Ze(ZyykvQ
zulb$`8VWl`=!UZlo}Z;)6nI~Fo`bGYKk;%WNpE5~Cq)+Jyx-gFPR`Dq$>8)~7%5dn
zR5T%|ED>ZM&9s>GACPV|jl{#qp|G>3!V0Ur$SDY-UibX|`zTr&fe0_DpSzH;Q-b<c
z+Qsqsv~Q6T%NP-DH*)G$pDfvpmR<lo$P3&ucVFyI0F(+({_XjIjM@#*2LJ<Z9Q29F
z#<O8>bya^@+u3!vIDZEX^Tc-!NAK6;3GMV|ELW@>AqOrrzUa_<eKc$!&;GBzU1-S1
zTEw`~AbI<dk1qsRla%7HoOxT6$UXJVGZ!yeB7kk`R=8vO>0@ivXHxZ?E6)Hg7aw(6
zm}zp`I7V)magtH0aiJ2$<(6{({(8?BHeUuZXe2;G9-O0}3w5UwY@x%im(A!C;Bx>#
ze^uP4Yr(EEoH<C@J(2x7ZfV!~N~o0lvJC!nLB3N%y1{1b$gO@f{6EYuiKChXgpiXv
zgf$kGx7vMU2dyL0fsBe}afB=JRhjgtu~R)W111ytcgKjqEf7!~95H%+)bKnOj~XQB
zI_cTEH%SnPiP4kv`nT>|2vG*|S1$Eu6bMCEef?_yVAWj<K*4-+e{;+kzBPgG)@!(1
z7(zvNFXP8FN{<z}wk3f-pi2oU>fW8j+@_qFu+XIOmDleoycLK#(5|ZuXEq_4p+5ut
zto9ygT}E;d<`F1z7(Eas9>GzIZ2x~D7wb*ePuVGiGfazNY|ebSa7L-**j2TO4V*-~
z@qvkR*u%iCx=pT%n#^HVUKCJ3c(UGvt4GoBusFN)QLI?2OW$WU==Z@PU=IK@6A3oi
z#JHK?d}GD<?ZbzAV`h#u5v!37*$e|4GeELI^(t2VGR=h{uw1u*P+#<wDq`lF-U<f_
zu}IpXzQy^enKx@|jvXtBc{h2EbMI9L$9r`|fr7a0l!56J#yNus`hTFWh1n?4y7mma
zI^^T!IGni`jCz66iUOWT(OcoT5&E;!=WHKw_$NvCuvi}9a2D-rcN5{QmXtCvx$-R(
zz8I&u((UV%fB-|vAhD7bIPJulkEkun@o~6!uf~KJR{?$;xN#%1rtAqmb75pM{3p_i
zg;GDA5C!(K)1cV%Py@$@Jvs<m=JsEg@#W>VfywAB#|HeO1Eq)oSS@zd`0?dm#Ya_L
z+H%^4Pn@td11+x}0ro}|;>rm4EdLoa9P}9F=v{7^-*pr#vQctg;(lw==c7SdKs{wr
z(jDU09swx#Xd%XPn->eqcXBgAkD>M5l=S7Yv$JzPo?f9FFBYWeEPv1)mF50LHTw=9
zUXmH1C3w8>WZ#A}MKMI1PQl$T%cN5mZQ-H-FbNuwb|3GO&5JT(QL+piI8azg#${`2
zUHsA$l4J31vwPn@f_RH1I?^g4{FV)T)f1`M|F@Fn#>2_?OXS0Q%gL=i88>!Re3`Jf
z;-aIe5mkR{gB)3#^OkT=5N0GEv6;_p;|D0?_M#XYx8e|mG_m>3t9BnCmb+u^23vs_
zP}JA2%iLJpn5Z7!wDPnw7!r~f;m}QAEUhAt9Mt^|8!u@9yHWI?pkonmQ1{JPtB9k%
z`$~Jn0w=zYOcr$o_hH;~|0{0|$tk*3)>FRB!om6vr!ZP`EhA3dO&k(*uB6e~)51!@
zYy|Nq$XR+u`?VSC!ch51wGT~J{ns(edyJ$15;uh1S4k;}r%!*W*x-1)Yg*VbTL$M?
zJRD5Be9ve}1IrFL=+6rhs(c=PMk$LdfVuWhF3$xeO(O<lH`G{rB?W{O7?1r^(;JWS
zJ{8L1g>a1Hx0u(@TR8gvI(}kes=JBDL|t5YLTF}BysemKB36(}tDIZ?ve4FL9arJP
zs*B6Bg!KjE;S9u0{OZG$urZ1eI@U(iu%DxkuMI%>YbCchXVt-k)bDRT;KqQwSe!gc
zy`G(~Nb6fNc=(&*^40QRRC+=5;15nD+25!5>}Hc;cjA_9Y%ZoGoXh-;8#0f_kM~NO
zw_WaLX=ytZVLS3-V*`wOAM%j^f7#^LPJ&?25!U;6OHH?DO%j(-{0My?j7#I1%J)#Q
zQYx=1+5&g^e22LKCmTZ>M8|<r)V6MlF6&nn$OnWPawJ$CdNbe^THIp_ixt?aL!#no
z1R=4dP+BtRLMGKoJ0bzxE7X}|egEdc{BeNaIwZME3dUe|BaG|_mM8MpepTt8B&*i;
z7?WRP>$^t9PqS+||I#cE5{_LB7Hd|Z_yKl0wfFf^K|#!##mGckO2t#a2@6UH;J_lO
zm8!yvwWCK)Uor?VKVmhG>;3^<1@>4_P*An*x00d19v5Kz#;DH~76aKEP7O9L{C6hZ
z<=V#OCn<$GU%C5ze%FCW)`Uf@piBJxCS}^!fOzM<zbKd^6pwjPmlsIPsI;FKH2mZY
z4u0{!RSua&P?$W1?)_}5z{_OFcKc^co5qkauXnuT<DOJhL>ym_xVORu4;^e%siyx0
zuQy$JFEo<S#__xM?~ml3*w!iL2wk`+6yJ57bn1UXt#rT*KBR9XB!D&o<U&u4A9nZ?
znp_)WG5gk@(N~TS_;z0bmYEN@<CofZJti+{B>qBLaqLXf9F(lc+m@e<xEsGJKMXYO
zU#M?5#wvIiY(k6EDfT7M5&+Qt9Y+0-PBVWqzox)|5{}LwC%jjKj}NoognUA3Ul&_Q
z0P6aMgzWx9YUa$IEzh98??v>Tb{&vVnMg-l)*9u02MtN$Art8XUboXa^NYL;hiM8`
z<h$X)WAJ=z2t(p7n#N`Tkz8J2j4FYjgKE(4?Wkq9|8H2!qZwuIOsv7f!Ae{)fD)a~
z@MUvTD4P>`8GH{;%bPDRi>Xy#)YnIlxoY@p|9b(z1-UBTYqJLxbFA9)5WytE05KYU
zEDMrv<vElDYHCGC0@g9AIuNd#l{gVqhF68O3QU7>vq{pE*m0=Sx6J6-VWAQtf(Qru
zps8lxm}%<Fd6x-kFK3nn_l&IP9Its*AO57+3K4H;)$89GpercE$3LzC-Jt|w&g$jz
zZavm<5w`M|jM5f)O6@|%HMG1tOSBDhAh-+vfq_cNbo_Y(52g=zxx)Qy4csU5I30up
zW!T;+Uk1|YLDDgi-)m7DIJ^o&;PB|hG<j-MI__FcgZ3BYF#%%lDFd<KNJ>iT^6%|N
zr4Vyc`_epljzja)FaoCv$DgL_j?$LV?B)hRb*fX;O`+iAp(;?6f+Amicj3m|!vAE1
zN2v0xj#l0FpNH2jum|DQZ_45XA<gA^8#Vsm0uVXu1KT@&S%rjBtk26FFc{^i@NYrK
z<dk{uoy=$fO6*HRk{29hGyFds6vPNLUdUaG4krZ2@QI)0_Mdo5z*BVf41LUO&M;h^
z&9h#@3}~VRnmJT4+p2zb$=oii_XV`GdM6VTDpx-iPiL+#&pct;g9SQ$g-H(p#!y2m
z#vfILO9@7T&juJm<MsXzCI0y)^ATTVl6AE5)466o6m(rL&KH0gDuT&JtHPhAIIwt9
zYRhGb7|RgK%I+o{HCb3V%71`FhrAM@AiQ7SgBFp_dEY*dvz6U`Z+P#Iph!<?LL0$X
z7%mbr#XiZQ8-#l(k6w)L9Ia<w|B1&(N$Oo$;>od}bK6#lVm;-r?f{?1j+bratxrbx
znzF;Nr~dUp)FK>>DSvnQH1&U4082|)eYz=OUPNR&=vzjC*%=@KJoD2YJG+5G5KG)-
zERt8inT3ei?BAQtTzFS=VjDKxN4}D`2{>ow^AtFE$HnV3D^3YPHS<?zZ*O#FVO0^W
zon+Z+N}ZCmI=vCU&oP#EUHqs_5OOh=AHFZx8ybjEb<6Z2S2*l`&o_X-3kNgeSeDdu
z(|bZK2C#YRwqcET0^vsN1=BweRk_jQ3ZSp9?ius42hUIffgJFgq$Uoone|ofC|_Py
zsc6VVARhX-WRkX6egzEoFMeIv>AyZD17a03!P>o9+_63cm-ipL^+-U2f;gk`YD0t2
zEbKgdux}5?1bm+Lw{Oi%yI&8C|LOYhEQhCxCxArc#mQ~`^m;0+PKSMIk|PcwBvd`a
z=Irjgxy=F6n(FF7w5F(@uHFa`u7BR%Uu*~dv#0EDwjcJRxV2v=bM6dKHcmNpPV>fK
zUT}KF<Jc6_!ajPdmBAW{-VT6#3x+70QHkiQZH&dl=Mert;bI-vn{FS)<PU0<b<g~^
zot64P#mvyGsF8dh&bpcp2m>KUSEtM@NM-ef?;1mgO3_O5LV>k)W{5RWyk+wgw8-*4
z^Dj{T3T~Kb7es})e4yZuc$;ZK*-qX@$HW?#YmP&Os@(higC3l{+xuVGC?Mz)tPM5R
z)pxfa;jbZ#YVX}c$vEdYh<PU}z6Cx{dHYbAFQ~~+KkCZ%OmHvC3H$Kz@7{q%P&S}q
z46)M)!7+)c0Ytyce$E#|faLA9bA3lv?<ifgxnilQhsV1V)y1%q>v#Fj%WJwd0VwC}
zyA82G72BLgmas=!@39+&7|ZD1ct>9h?T3X}dzIkkFnMR+HwV@UL$)9JJSM*94*kC1
zPSQ@9-}WXnwc?;9iArZxers`c4)#STqPC8E=DQ_ik!nR-J^cr>_tzc=5U!vpb!I>=
zIeu|;S`-fo0YSqw%dHy$Vt#}8ueG7-DrX#w_|`##A2;v6uC2X{c7Vp?wMw4?F;9V3
zR7UB_5V4|q)y1!|oKc2`*D8)%xu3$)^}oI*2e%z^m_gGJ6O;*pX=;kTZa9N&ePH41
ztD7xwDJBLr?U{0QE2Abg+}+blw*yvO!4#jOFsmxm@%X%d_mm5Tb-A_2F<5~*NV$I@
zMtQyo_d+<dYhHm>LVQvDSh1WEYO?AsOf71{vN8gE3(#WC*Y+F+)L^jwOL}9ykZFL0
z$IVMZ4HrRUaO)l%kvVhVa9PW$R9>QMM7mOpHs+S&8T{61a<G_>J7q9nC^s5(-+bH<
zvwI(?pePuLF9O<UQjw-Q4r+=3oMe9#e-~L3X^K4-p~_sGzsmaZ^#8Q+(vtwJ#T1N!
zQtIzHP?$7~f1&;dz5<Xrm2ZJn3YE4D=}gEOzJBf2Urz!Vi<m~d=Zq&QpHfom6UFX0
zGPdJ~wTG)bCP}}{oOVu){;wP(4jqrXp}Pa)XW7gPjza;ipb%&Aw9goA?RVZ*Xo_Tb
zQ)WaeCV$NrZNPs~%q~#z{2vX?_Y2-|&XkHXBeWiVdbBJ{tcW{R-9l5vqnK%NI{cg`
z^X}C83fs0Ia~#fFZd@z<iYjEsFQwV>RDeJ{!jjz4aT)IOT!CZjd=;uz5&X_h?nsbV
z#C(jF%kbA1+gr`O91}nc1(L!4)PC?<_0_erN;e7n;aXZ2ludx9IelHmpoxM>dN6PF
z*Ch!XJ2FAf!YSh9JIolad!&`!726TZX&jQ=R{t+|zk`)f4xZ?92%Ea31(~lulybce
zwoE!tSqw`!OKFnUNyC4|yF}-+zL|m-BcuQ?Z;mo*b%DwuMr`gqw8{?EGq+^;P%ksY
zGfT0$qVRkD!Sq87WuY?SQB2og`aHky5~ze6ZO6q)xHM1V0p6Q1w^J(5o8ls?v3}0K
zbqSo(>OGc<6xWj2@tbr+q6waijs~Im-M5=8eYUL`IdetemkJBz;7{}Wdw}vQDgC<J
zNlNvx7gN6QB;8FQz=XeJ(x8VqxG}<;@K2#j=~UsZ=y4!v?`0ena;0(xy9luKZT@6O
z`*H4tHq@@7qsBV{mN#L&`k~`D{~kk=qaKc%zJ9%=tk@!hYuB=Q1;TvLBs5XV9AQ^i
z6X}4~S_S)i{}J2uMW>y`3^)LUSZsK!nFuNeqKTlLI`WTBONl|*6^)O`;DR?aNjj0c
zxz8>ijwzuq*d`;`R8_2ngG`*Qw5ZL63YP?PdiJ^@hH%T!HWZ9{k5d@_&e72A?zn?w
z9q)1T(_l33f2jmF^{D$-ytRd>n~;!D)fV**%{&~DgX2-&FpZ+F<6za3^9erfRXQ*!
z{K7jym@fj5^7e`W+QvVfw&;LBH_&7NV{B>u%Ys(kz9MrC>H#Jm(yK04!#%*UK6pB&
z0reV>cp<^r#3FlrRj<h9Wf1%A(7;^oHp%Pqe+A?9<+=z1nlnPekW~U$BXD{(dhf4?
zAn4L6tX5#695XlxYEpy>?fwaScZ5-#V+VtTFDp7|#jTs{k1k#@Z<<KLBv{?ig^TD*
zgcChHUr3ZH8M=2o6)d9~k|R1e=Xl72o*|^YUY{>=2<Zm_=&3+|15h_$a8oMJ_ph&{
zW@W9)4DSkQeY?J8s3BGvo4Xgjo3s~UwjfkGUolRpaIjN`{iVG<Iw%6zUp;*D%)@Rg
z%JzN#moMabmHc?7`mxV;b3jJAcaGexf%n3Ls8j_RfNGGt10;z+i3Ck-=Jn(_H2~!c
zZ+yfC$ZbN9-8mFZanb$N{Gb(c%bCTu0-K+%6N6}gRyRG8RuKI}h7mxw%x*z$5c(Jv
z>wTwcK5OTJ-yGxnGq=%^T9kChH#~82NJ9RPj}yT1owDBtUii0}K}Zf&NGHv?9y(|%
z>+Yq`JKy@DBDZS=%fLhIkD8g9UQIEng^7z-beuoW|2z{f0DiNX@=DO3eba`|PaLqX
zdO6!}45O$2;wPH+zZ`$Vw*fZs<hXV^D;|BRXi%prrrA1~ukcvR@qvdN%=v2gy>1Za
zC0yyg=`n~PAq~@;8_16roTan#{@DuN5$C)ZdPdBb#2NS57quV*w5kx2zPxXos27=?
z11UZJHHTu`oT0W4uN|k1r6325LN;+xn8lMkOiI#o-tAN0@bluT|1$5r3+q-Pv1!hD
zj<RCHj<EN(Y#3*xi-FWnSq=Eh%g)R7?x7r$ew^7^>8-8~M(t1?4U|`A7tS?}+@gO0
zn-_3^CKi52&=zOQqFOyEE8^bg&zq^YbS&uE9P8Iw&Bdz7n4<r8<GK@|J3!Yb<E{7d
zA1VjmJ@?`h!ifFy!yN<<a8EzIzoEY(O*th`2?^iP(F;ARIN1zBY0gL8><Hh$eOs*J
z_yOM;m60Q7o=8~L!-(hv^pC<o7@u)62Yi2JO*h6r6Y6B9>`bHq6_RW+7{*-9H}0Eh
z3x055=C(g%?RH4aqx<wOZxw46!773%*TG^OjXs^FGNATOMB#mGX0h<xSBbF{23hv^
zBDQZY!YP4Ba)xdJ*1>Vu5G_qj<{Y$<+MhrIf8$CgoE2Er8X9wjWetB?ls|0=v1O}e
zstMU%c51>(?k*j>Fhzf}A#C|H(!HIAytoS=KQfWE_-pg80fz|y7|Z08k3M*0ecmvI
zBCkt<hC_RrTs^*AR|w@t9=w3G1!}OGiiBBe!XzULB41McP=V-<Q*vdPlc&05#YKV?
zM!XB?LXTw*>&Z9kLfg3i*e^i;LZKYY^*P%3#%0$=;Zw@COX%sF*Q0}T@#!5v3(?_#
zhgdc#fC4S8tb6wd7zOl~Gs}K-;!<C`bpwt3TTYZ)A9F&;G>Q=;^stXOnBe0ybl}bR
z{x?`M0%`)I;T;AW#aa{$KKv1mwjX@Th}=l?eak36mPHPGr*CEKRyNwwP5~9`WF}me
zq~rp9i;1<<ODjx1MH!K(fD8TKcR5N`*z~*ON|X|R2F5TQuyFao<IubKP=ko*zaCo;
z$%X;BNKm?){Mn*%vJFQ(v8gQGK^Uxem{GZZhe35Em8-FIhNn~sl%=Y&@}=V?!5Az$
zJyEHGMnr|rgeBPz2lw97-UeZrB-WDiUG(_A2k!3$Zv+FN6Lh>`-|t^Y0<F<8<sT6(
zv;S?Op<)HVcC_lA`<L_SAO9~v&##*+yZ>9r)2fi51c+Q|kTHZmB3N<gKZeC!X_Akv
zy#^55o`@#)q2iTw>dZ$(e_Vzy4+?6rdCFO@H4eim!L42jd?rPJ7UYnNf1~6wKb};C
zXs!pkh*S+`CRE6ddB3TzIWw{hc3pZMuJ`*s4;aGL<xO^(=+^+OP+5>zIQdAs7=12X
z7H34Ef+zt?LeuwpLrmzZ2tdIsx%gMWDy%+qf1Sm{iAj?AGRH??uvlVIP;*|e#=<sX
zf2LM-F-Uj?b6ZJnC)nzGy}G$4p#nuqA4qFN&tA6;w&9fdV7aR!y_>Yku>k@5m|dr$
zD7x*Xde2V5J=<@}A=+WOj@|?`agX<&Q$A?`q(WaXhI&Rau-E|kB(S~A$#q}Hbe$Id
z15cfB3jW@<j@$UOjlb&02r&ZThRC^_!sv3p7pwo5zK`XWHPj5~-nVndQJtH1m}pu*
zy~x6NWDU2C^3SmJ9!-3NTlR`6EF|G!o>*F;I<r}rkFZHq3gYAPg%IX)Rv|=%5RwR@
zpk$(msti0N;lAddK?`F9S{Zf=c`<vmYug@NXh=^#e!R<z+Xr0h5<{go+l=V3;lx=7
zMdNnU<Tl)2ps-M9OICh(n0aKEFFA?X3luIm7{7P86q=rW6)~u4Z%t{NzrQtalg;m*
zv1ZA~QTv}eojR%gWW%k$Y*s#8myl3eT)g$ba_!ExFEge!6DuqU8Jquxqv%b>*^Z26
zCd0})SX57H`m}=3iA<O8IxF?jGj<&^6Q1?Tu23xQ;ifhmZ4UhUPTtSgSJ<**LO5qw
zi6q}h*pAXI+V73qV6QIss=j{O!t6bGk@()Wf7BU_E)8fyR@-RMehyYS#Q@GTJJ_8v
zjB!1s39`bYNv>~SOLDE<QTq|?jWL53?s*^tLY%d*xqx+IWcf(ig{pMxEmYy4H5uyo
zB8-@z)jLA?v|>+Q_V@veX)>du|6q@|YTiBA&2(C~y9AW>-ByF@1q&9py5T!)j9?i)
zJi8b#tgo<7vb(t6r~S^h@B0?lg)dyP#G-!*MmJkN7u;sh)D#!vRHuuF&J`95`zYjj
zV;M@i891=2im!F!Zl)TN4{qi)knhOI$SIn=cT+fr1P4p6FKghAEn2Z+2G{T6f<B6_
z#G@!0JImbMTn1@OQCwtwGJDc?7qIvptMtl8hx<^{SL;O~HOh!?{PpWs1_*lJvp>_*
z<`x7P^kG@O(iR1qjA+Iwe$D>z+DAuMM`y5-k`f$uG6lU%+pqoi%QxRn_`zXkjZ^RU
zuD0e)*J{_CJaOVh=9mu*aAwfL9m>j@MIHEN@$|InT{mjQ!)7f2t>;kh{XeC`(Id<@
zY-aA@+MPQmosWhb)c3JG@$>p=c&Q_NoQ#I;cIHr7%9PAWZvOJ52`!IgolQfk6i&9U
zu+*F|;lj0%NkB!1P_awzv>YSZp#zrfvo|#hV?7!?dG#JmV+n93{8B)q38}ZgVqT7^
z?I_rO8+m>8roySb%5(@(2(pQHDk@a)SF6^WS*zemq7-J69hBP&dWHq_`mWdiv#Ily
zQ6^T~J|+Qx+C`+^th{qaxXxl7m%(^3zBOt~2jq{KpSQ<@34|jncJJO@RsG!bAuCFz
zsP3ve8kNo4OXrJ;H-(_U&Lp?3`P+xN9w0(v;iv9CJqM&V<KV=-9Ka6`Pg!KNhWFyU
zs_sfR8L4vp(;#+@LfcK%>}^Y1|9};p$~e;yhf3kM5vPL@?LseEx=1@bGV&0nswT}F
zzJD1;SdTzKHpRkX8?Co+sJHQ4Un`XB!cU0dNpa-Q*48nlVM>l2GGaug>IAR9mn^Bo
zv|yUSYa|X+aU2ugOe~m6qk!ru!N~#ov#!H4f7soVi>LAEN}t=$oqNI9Rb8TIL{VO5
zT@&A|T5n|APe&J*1m;AhbJjV>)1I^u*u_P*oHeVh+Kq7^;akiTlfTGz`MA7yf;L{n
zik$b^t+3ovhV0&j(`q|qa=T3D&UQ!ZdlAkC;WAfuCp^-F2HzS%;#gYtwjbJPG6waN
z6MjZl7mfyjnNp{2hEmL~AYkLZQLdY9in-xO5{Czka(RQgpo8%s{fR6FjD@_nfA@iM
zc^aYME-9qFF~=@3C@3h)DPYb#91H)MGB}xo_DTOEV&Dvj9{K#BSnGl44%4{xu^aYN
zCZlLg0h_G^z4M(?Y-dL~J%nv@IZlmGwbt$>u4aBLzH?u;tdie%-M}98*-{)xCmymH
z2)m=kK0nGQ6ASCPj0(>2+dVR$9g7LP#o(yR6J{LIS|phq<IGogzng9?`RoT~e0}=$
zs|00W7Rrx7iK!BGi1|#vw7v+c(F1+lbE$OCNq8bVzsF4!r=XH4TobwTb{<%HQ>@K!
z??aTD%;CPe&~sC~JutuBqx~WH?06=PyUm7Ej*~TqMO{b7E+y{8Vny>YBCh-7K6sBM
zqJ++82X|b_?vi+IR$PGFgU!CvGStJ?#ztC#t%R}e1$l0A)K@W2ou|#5IfV5{9#n)$
zMcQqLtkjnxmKAQCAdWUu^OM)m+eG7Ms_f9we4~(MlJBG?zS1U(ogLnTw}u)9{G7s=
z=iuF?;<k1O>fEJE>6I&6poC>V+{FHPD#GJyE>WkTP)_4}5HqnneL7ZNjHr}8dbE#d
zVu|o4Z=z;0zZ;OfLlB;8--{;ip-cIzT_Wvn-1?gccXs1>xp&{be@s<NjVyjO|5ezg
z!}7JCo6D-_`;Um<zs}%Yf>u<`6c-nxz|@`9#FTi6o$>K=H_c2IzNkc6$mKz@w}nwE
z&-3TPj8^=YZSnOd_3V(?iNiCuGdHj;-+1aYT_mpJtpLt+QVOw7&YS7a0ygnONKk$6
zuc&)25)0wNqoDdKJXa~6#lr#<<YgogTh4ya?^;Y1Oq)*HiDs~%Q~;6abMu}xsN)F4
zUdXbB-bXMEJhl{cAulRpWH+BN`)V+1A?b$aH8}JYW@ao`5Mq&4-I_<sSCRk;ER}zh
zpf;EAiOaBz(Wrg*%F$i~Sm1T}3q38|C8eZxGp6ih5PVIHw!VWSDj$8<o)>%Li^M7Y
z@eDtD_P0O~t)MTHrIV4rQ$Eyw4Yo|bt2>O;)Qr@NO2MfSTC<4_aIvPU*1xyEWQ5I%
zHZkJ8bYXe|t1o*>q^?WTm<~2PUQds3UZpTDjAg3AtNp5Hf4n#Tx$oD2RUPV!4u~AA
zlg4G*JyaW<wZ+|fT>0nR@U`#mhRKIfh9sp=ZWcc1N6OaBMnRy=1>>FEy|(!bym>kI
zcv{X1bnr`2-dWB(G=OzG?zA$gk909kBlYt=wD(T0y|MT?3M`Mi>674;%;vwhRhJXa
z;^e$Enxk}`=LN*a9ePo2AwkpI@#U~x8%md;<NIj=&ZSA^yY>X44mk|3Md}nTo9&Hp
zaeVdR!wiyq8gaS(<F+4ZKbWJ?@OQNW6QkORBbcY7cv0&;<{55sL|*6Wb5LP}vCl%%
zl>(5Us_H}~%V+FgVhtwz`MK6Dp50QAC9{KCLkAC*%XPt^1%uF72j%Pc&#yH$Hr_SQ
zvPq^W!l|#JzP^6Jp4q%@e(RJZt8&29sj9ogBN_WW_a10(7!ib5$=kLC0ORkp$BtEl
zCT3XNCPM0{C8C7M@WWNtZvBjzH~(xoazJ<gv*pRcxf<`$<U8@d7stfLns@Bj@k>G5
zuUW%t+R$3w#Xl-FvP|8AdfT)AoV0B=cdO8xO(AWRdwtG(ZVex!BJrxOZVGp`Z^ihW
z!I<UPSeEEBpMjn0>y6H7YreNM4#K^;l1z3zZxx+6_o=<HxG)=MUW#7MU@?b8OKD82
z@b@HYpT+<#=H@!^FJ8)NBw_Q5Z(t8+Yg;KZSJNRHymXg?W*P`kQcAkoh7B8>&aF-=
zADw@lLTZMDI;a4)M0XB-H?dcCDpfKH*e}7R)!Uz+_XB0Z7}@-i-M$P4#=kso`yCe=
zN{4&wbL{Kstv5-z9`}!rcu>>^i(rj_p25%Ifu(*SCX=uX9K36a$ki-e)hfc|*Zto@
z_MEXobm4r&2QOZp8m_c=x_#aD%)GcMgH^ew_CGI;njVro^6BKo+I?745NN$R*#qIA
z8f!e>fx9qdA9TN~(>wa^UGUSk)ob~&{F<dC42>yjc_iN5#Hp~y7x6U}wJ2|9vti5t
z{O0(7I%uf0R&M>}<=A>h^ZC)`AQy=oKSuSeClf@mvJn2VDx5wZboBoH2%2BJ5S-M(
z>bWVXQG1klGAm|5#V?03B(+o7^KZ0yk}I#ik(Z6R+vsq>!1q%SaE7!5MZKJ(@30t4
zjuq*0PMF(4?zD)|=>C$#E+zF(ckkTMXxtP+z|$T*de~=wN6sn$ZTOQw25Vcp>Gl4m
zt*bk-(Mvs()vx*2qzs#458SV;9De%T83=pHHCRHtV;&ZQ5y_uNh<emdCrB(Y6L<tQ
z`tRHO(ODyBIcM@rV#kghFfD@^(`7tcalk7BxkSDQ1tV89v&RAH0&}`k?oq&O&j^j}
z6blTECq_SyN0rC(J>+>HRp$UN5*IS(I>lPliRar7f73($S%pL8@%rdRB<okz)rCLK
zfkpML+!$-!jWBW-B0&2?6C1sSOEERVBV@z>{4-j<h~`FGV#K^$I|`T2U%qHoja_0$
z8)%Ct&)48}JeUCP-uBm;%9BCeZQvu+m6frA^C-P{FP08@uy<sZa8wjs(d5Y?QH8_*
zD;yY`Y!FAVEneux1q|#O_%{6%<7dJ)_bpexgV@hL)O&DRXOQh_2<mqy_MsY;?AY<O
zR%$NdtoG9?rw;B35jE%h8>-zd8^Kc5Ms7HqnVETK%h^1Wh~&?qMb$PVc9o3koHFxn
z(gv~V;M&!z!D8dF!`6wEmT7obyn6nGFP%onS!UO6^QKLcGW2s+;w4PUOD&h79P^3w
zVpHkyMx5y<7DC`97$wT-L}g2L?uIf?i=Se*>4{O>&oN;|3v<*z8lW&F5&}t+byA8^
z1BGne`p?CS2Gm-+@m3zLZRJLtDq26ds6iO8w`aBES`mY(xV})Qs($ys62Rb)C`tI$
zsUXME?qTlS)|!(0Lvok>PYbX^;frEz0#Uq_d-mna7m8E)x}EEYx<6AZ)p~ZCNA$Sb
zC>%SPycpa&qCh?I?!9{>Pj?^7N@*+!;*I8bn#C3Q$lktoEs-PF+wt5(UU}B{zVgMi
zKo6SMlcZ=9U4E7^STlT00z>wnV`n*{zg`M{xmbT|^o?4^yUe(UqEO&HGjL~2JWu_&
z=J+k)6^Qhl2{<ipx!1#?DYsG}Wgwr8IWu>uwP*-w272k6XJcm~EpfnLLu_+)Wo0Gh
z{n-any%fJz;sMN#4S9X@^J+te^ppq>4Nd=|w7t!p{UNVjyhx1Bjvu?soT_d1^#{{y
zPci6>J+zk3(2t`0&B;j><uAIJj91=~xsOjSmgNF||04mmImTTk0$VoN`(a_*-k6!K
zYM&>-z1ua<^)m{XNCEFqr|3bkmTNcsRr+vzjC0y9TG{WjbGasC+K19{Ed6~{Xeh%r
zW)gLb(6v8&XCiIpVNRqdUP>|ZtDWYm?V_ct8!KUj8B4i!XlNZRj2%?7>Z&Q^tIQ`}
zOgfjNdWpFBR;_249qc0)wDrad`EN|`<Xk^Fs`Hgkljh}aJMNSNN&1ELqjNUD7S<Q!
ztHcLJBS%J|?RS!U)TpAS79vrO4$bljZb$hV8*&|$UMa1TpPlE8aW2s*jp?NH*)N?a
zwuv5hP}58u8CMA;C8{hC>5wRM(}YzMV{`g-u=PV0Ai5aguAP*mQo88m&xMoC4PZ|0
z@BxM?D+i&Z7xw3LH3ZuVkd3!|?N&20YO&UF?<x7FIX`QnXzLI}&3E0-;mC9d5jjQ0
zDFiZsb;xw;l!VLG$+Kr~8_ki6D6&hnlxI$7ezu!I;P3r6%gSU8N}{I>zDv1e(){?;
zl5XVKxO0!pMeleZ5cDzR;HqWr?iCQ9`QMj)nWg2Duc@12s+z>d2=vT^P_*T0MNDja
ztv56C!dJZAcM=raB_h@6dA0yFkTeZ6p!}jO?o!!=XHe{h4CGt;`{$iZ86IPjlt@Xo
zlN)<6ux);w-t=Me_eR)N#?}wd;tltb$n|YZF1HS^qJ9wW;5Nl;SqC$`qunU#cCF72
zDap|C%to%JE2VEqr*MtQO=&a|{>c1&^qmhQSlU8>nHwATvIxjYlsA~%hCSw{9$+!m
zTgC@cXvou*l~Qiu0yT@qUw&c8W(M>qd{U_e=DB+@&qm5qWso{G5=)F#B$yPN;@;Qs
zC5X7FV6~T`yaK0UTyLwO;+Jx+n0ku&gH>2>WryKZpZa@hs>!Spw&6f_n0aU~Y@o5k
zH6k~uZHRaOw9Wy)TbIy9+QxreOuDiInlM>)Z*_kQQZ!2suHA5kXT0j^yz9UWKrO$$
zhjkdQcd6^5gYAsUOcTYeuD@p}<!;lElkq4|Z0EOOgKX@kx+cj|!e<2&GWjhJ5S*kl
z4W1gXZ{7hj3yWSss&OS{O)OZTc}u1^P9L(TFTA0O@LoT=a^9w9nhgP}P=rwZVcgbJ
z-L*paMH6vEpG>EJn%+5SP>+f>m!;5QC(Et($P8gD9no4kzju*`hiJT__wF6$t(hiA
zsbogT6_J+!*&&GX7nxnez2ozyk)YD(>~<YLK2p?o)S_Y#Cgfm!RNt{jj4jIOLZm<S
zk^e}KD>feRs>xG7idv5V5LTgxxYjRD0EGD9^^BN^k)O=dHiE=mD%^!}VN%9WlNz7B
z@I#;ot=H0Cx@=j~+8SP=TT$<AaHKn7AAS}EFvOtYY1U)c6jLa%H)=x@5G$Dyj~SIV
zqfw@3bgEm+&agD*sE)W47`9WUt^KETQHbHF1kx_Iv2Wvxna@TyL%`vLA%_GqL_7(C
zmZW}T>fyt(N;6jEEPwb9P92)wkqc{o1!%l&w>>Kxqite_{S7a*wABd7fD-3|c*W2f
zRv;`WEiBv&PQzl5a>QH1{!GJp3>q?ItAu*(%YQhfR5e2`3@rRqTv|G;Ak5B{gGy@Z
zA@TX!w=_6=`82n?6=A)G3J6Fzc6dkI{E4~CA6U89K$`9*sNEUxN{rLAOQem^SnRJN
zu)LEelf{w;C9@B_?A-uOAslWdat?VSsQWiCgES465F0s2sPC_uOr=lX<5Ip3JO8Ab
zQHwFGRB!qGxlPBlFnHlAQ|bq?$%DA|S^GI}XR3w8;qvk0qih}LBoP4Q9?eT-*wn)|
z4@YZTr+0S@bS6%u;wJESDBE?vEd4}n37yAOq=SQEQy&OlU3d2w-_hU%DOCLi8^7C`
zmEN5UW+8Bu*0#3B8jE+>De-G_v|^QXmUeHKNRe~2%rlJPv*LM?u6FfcEno_0CU$UI
z1rq%JZ!5`O0|(CHs)+?vynI?_?nD?%hDz_>k0ZrdNQg_sANxFTfw(Py{k28wRso0O
zi2czdtOt%=^KzqBrkrg}KIfQZWhIa$&93r<U9Plh!5i={cjl#9-xP&>C_r<$unCQc
zLT&@%F2C0AjPdL^os%Ow;v+!Tx}>7Ni3I`=TewM`Dw_(0X7+{JGQZlV=U(d_H(uMT
z*Y2NzSAZm~@SR}$S+5dLyG*CC;@x9?(X(wWQ?v)^ya5Z2R99Lb0UPdF;+dzl@mll_
z=aGjYB}8Y6)Bn$z{(ovHr;rn3ZOxRy9vgp0A3Qjdh0K=Yvjlk6E_H6kX6tUK)T|!$
ze05#yxBpp?Bq2Zw9!DLYUqpp{sOiglR9%OWpvYj!;IJB2M#XX2A58Y|tOdhDvOZZ}
z^AfgH$SBB<HdCgAO1xF{@nT!A_NY;b=nd1WayI?rjMcS-6<9!n8?#Wh^n**89?siw
zz=Frh-(4#yv2gd2zI^}wSresh8Q~<IOowcfIz^Wiw1SK9hxG0|-`!@TtF>gZ>ZllV
z@TSD0M<ay6uZl`LB*!Keccy^4h$T}LnS!R`+@?YYjKKvS0GvWxA_(~0jmb5#%!oDd
z+$S;Y^6=#1yqgaX&l)J)cY#NUk&=eyreeQ4+Ot<=CduC}s=E^548$%ky(rtM9k;qF
z=6C4Wk%?CP>MhFqv%=h%aS}mNUDg(hXVFM9K{y6*tDxmvOpH8fBMf{*nFT{Z!9S-?
zpKi*>NMi5V`?XjMO(KshaCgs0Ui2;rRWUlK_7d!^kO7UkLRLaA8-{<I?Ed3Rk<%3u
zBZb)$PqYW@bV~Uy=xYP9P*>FYB5WT+y^CJp65n<-5f;0{Kk{ihbQD0rQ6<rvNze#z
z#N+{|O)Mv*-xG6)_-?=>gmJg7!29AjC<W_`Y;`nbk3Vwgh(@s=kVEp41Kr+V*M*|h
zYS)|1)H3IwT&PQ(Ui|Q(!xJV`hAzEE>_eW2HZ_|&X<~Go7Y3%f5F;lRX17+ano!~?
zIMQq{B-MS%3qPwTUZ7nq`Z&i4G<n#UN0*_~#fU2_()}B=Dd@$f=c0g(lmL2BlWBNV
zdPn$`It}19Zf151#r~v(_yMm10rI;P{QB09wAu|<)5w8F1BMJ4A_kZ!z*!$2Nlh2+
zJ3}mCS7aE1w7r!bLW=_}Eyp78CQwVc6-TnvJh$9a<04Z#LR^_X_v}c>O$zy~#F`o~
zMlqSecMXYhQ0d%XulwvHc9(IpQ1Omd?W3reh{yf|7S%PlJ%0F*a3mn5R~wg`j|YL;
z#C=I}lbe=g^#ZK}3dsHxd*Yq$*|X;b2^0R>6sVDBuW|KFvIl@!x>Jq@;~g>Dzww{s
zw$6S3_$*+|n3!p>+l?G@rnGwd8fj?A00<WWSa)aAm|H9xz0+Fk{SuRr2=0a2-+1s5
zy;^bnCWAm_BVc(}!aPbbe@0BOJ}bF(#j`&!kXTYF_Q_htTT}t)2DP;KLV$KsGRst#
z3zzxY^mUcbyStMZq%ibv!LU3{^Y^^b*Y!g^&Tx2aA^Ta9m}g?pXuXSaOB>1wd?P7k
z)Z*?vdzui6J+dQhpV=%>^Z9&j15thcgf0^|evjU#<8G5UIf81G%hsrC;VGsr61~!M
za>k~nr5#zcl6z-Z>(lKkE4*}sm>lp$P!W<hc1A~=ihd7oVYv%WDSp$bQ0}5)lUK9t
zO2zYzXdm`il-$%$b~~qBWPNeCgcbhVRaq_qo38_Z=&f&`O_C3-(UW2OLh|i5Wt5LV
zI>VO^6|}SskjsPfN>`2w+xc(bhS1?Lm5?kJ&<z@0i^z5suURl-u%lE&Wo4oVy6QC(
zPy(Q4Ut%lm#jm0}pF=L<0<17EQ*@Wwdn56`39UKzvueJ~22n2|M2#pDn+}f5J^N8%
z-qf<PvS~jjifl=5cj^2{mjmkw$MX|YGI&gQYRR47hyrYOhE3|VtP}@Lv2908N7D6u
z{wF(+_K?+pN3KPkpu^OQ8bs`+gBW&t?nZa9WQ+wiWpEQEw~ZB9rahE~`a4G?B+6!(
zXjwQv8T=|yGZ9h;!BppN{BfqdLgTa;nV@p5`rgt^55^YFrx!|oJRsg2CN?x0j!fxK
zd{&k4IIsDGa|N^!#3PoL;Q3n<VlJ|Su>1r6g(X`h>^v>MHq%<(;nv0I22ksX)lruH
z5;C0GM=hh-#4VUk$%cRxHSUZ{iz0KeHc;cE0;|A{El;ZPk8ufT4IwM}mbF0((w<nA
z`c?5D1s2M2j4_PU5D+vX3H_~3qsNR%Y5Ua>Xj0PRfyQB6JKWp#*f3+h`<?7%{ZMTQ
zv5b|*Oo|V8tX%%>J56pCJ&rHPdHoriO)S_*;*y1|y=OI+PqF;*nJ&ngf(Y^w#sHw#
z5*$?vg%*9oKFH9XV%!+K?)QGwZDfd=#XtXf<#VQcMA0Z6ovV0>x&Hlk+CS&}Y;|pk
zzHi_Siof|ayS6349J?UqnDlz6YNXPH-c<Bg0Rh6F+OwMvh51#`ea2Hf<<(xfpqT{m
zj(GZ-kSvmxkhN6>+YI7{Z-E2>s!L2s*}{y|v)uGyV&-5pAs2Vr_COC3K@@Lps16*E
z1O~Lcl%iOSc_XG6Aj3XY&N9mOny___uC6Yju2`r)Smq+6fBbBbm_nk8{UyO#ng1BX
zYz>nv!Y+t$EY>~$>Um*VK+C6gjNm%t`=1ZL6Cf(3RHvypWGx_^IzZ+9-aw%(lx>6&
zB62Wyc9LfAz>3mdEl<L}7`3&|%Jvd2!c3Y9fx)I`mptE1cm&E{$l`J1E%155PN%tZ
z;~u!@>0lrg&S7oW@}#ly>eUVmDlvrQu<M7gBcY#=e0Jl<KJl}-JjG;Dwsm*t*Drp}
z63r~isAOKKZ)3G2<+jXIb40as<|uGJg<+8F2YVMMwvdXkK{3Ds4v{s$Ldn6wVF8Q`
z(zQZTQb?4oJA8o~We2K6W8uxh{2BpCg;nGfps;sx`U^vJQM}@4lHsE;Bf}0{NEUbV
z$-~@Aii@jxxOqFuK4lSkC4v}<lG*?26e)?$Ns8$k@djjMHZxWTjkbxeARMT<lf%7T
z?oB$qn)q#5uPh@05n0GIuvqw;T6WoP00<@Kh2-CXV#a(rBKo%0+kvZ*8B<rzuJet&
zL@j}JVmP;!;i%K)O|QcjP?q`r`aTwMoL@gLgxD<r^*n0dey7xX_wJ3i1^7U}Xs#3^
zb*`Y&YV)@pnI4*MlC|Gs$r34$)VnpxTLa&Zv{9=(?QXkh$&#AKs|w`x!;3k33LNk)
zXx6!276KgrUJyb$lM)Fy&$mg~h>3$puoGL>>DHA%k%JvHJC=A#t{hBAQpIT)E!e9O
zTR>M}<3qvsBwGAWsp;$QJKGqsdtHj9X73t863P0w<?F?YTVGbv017`1GII}VfX%gh
zzrRqLh{c|lV>`~n>xHH+1Y(s>5OeM#lPl|+KZ<!|^r;!jDs702EH%4>u1u7ZF-z6#
zzCApAv-8Mpd;oNid)ka6^&e%sNzqINQxb@!-I9j73oc18U)vpS&X|^A_U~W0@T!Xa
z`YFuqaCKCz*fUMmaL)Jd!@RthX~9(H`hfm!Er*XDmF0B^LFet;S#}D^VbT;BXq88J
z_wiaB9u-y0zrxoK@9xCR%z4#@gj@@j18-`k&%l^9jOy_vQKg01)h5}2O)J;ezIwF)
z)g?1jmf1D^`t)(7Xc7SiIOX&0vT06#4`|7IwE^0$odn5D!}G_TYjag?2KN+(2B8rV
zlR=Ckp8V#nbBX-|l2Q?0PZ_)!xeC~+XZ^hqV)P4HK%9Rqo*-hA2<dnbdXB3N1#sbF
zDkAUZF9OMBN}h}xQb(@S;vtwEz4pDscBeF}r#xg=t_#z&!EmZ{reeZQSW$DAXU8WD
zpJA0X-{ADJ`!h3F?TaW{h}KjZfpgyT4h@Wj2i^Jg)HOJ6j<SZg>tcEfbhJ{GdsubL
zp_h5Uq&kd*u)kv}@X*!KWQY!J6YuWYvSo5uH<=g<pv!V9c6KW{xqFR@*~axEUy7Y$
zP(xw}5{IAnNp2m5M4Ds4&O@Z}U5zmVubbjhR$SbXzNLD_-d3*bLb?d7z*+<E$E<)6
z*Mq|~mw(oUP&w=1L=?qfn0L+1w7OT_yT=V5`{~PDTTu;N`dvLoo3H<u1ouRCzv&px
z_(D#M*yRC{a$WzJ9YuPdb7+rX35R({o3L(>mP3l-(hNF7__JfG&dK_#<;jW>3@3}>
zITZD)n!<|~(xEKm%`(XE3$U#)&pcWTm-R2HUDt_aQ5m7A2H4Wjm7_k%3um()cv>L3
zj#h4hcD%$m4L41*^7+HW#KfQNw}x*GrO4{Qt6g|@0(*tP?xS7QZ5){@A4vPfc(rT5
z+0{NQ!q|#jQn-kit&OQ?Yb}Aq6Qr0=FsPtc?n(Tm#BP#3lzJI5S$)zbf=_KnJ&B)L
zPYNXDS0hBQ!Y#w4Zt3*#jBiA{iz1@%$&>!93yS-v=f(^|2916R&EE+?E1||k04%9L
z7hFZoS9)vcCzc`9FeMZc1+LHu%_!EZ`wceq=Iz}axFvKHAcl>66UOb5r01IjlkE1H
zD8bD!tS=|wTd&-L7P~!BWgNqZFf$r!e*m7mGAg&C8E40di0N2sY~d1U?QIboc`*{y
z#2!(?^6M(q-Vxb+runa7v96FSvN4j~t{(2fN-q)Cx_75m-rj_=Ps}S}N>U7!-w1B^
z{>k}X;;2ye6C($Cn{L-3SrA05R^)2;{##hRW3WVU_ftAcGli9Ih|@Z&#lI7FN+u%$
z-7{|006K6Uo|CX86{c?ojRK>XQ$ko8lMz3@UfD@+@j6!bf*viT5Fy0p*t~Joc}_08
z<k=sB2wmTC`;xZE)t~bfQ1yx|vHjdFJ!Fw+%|*XgJD@(!C4g+!4g|$-ioHJRB^?%S
zZ`R{<3jTc}WISNi_J2oR($K~2Xx;EEJKbZ(r~etxL?<ONb^($}DN7HD7miCXFT|8b
z>9}dBB<M*O{3h)~Z{?EMt{|opTc0U<I+DsU^)jRSHZ~O(1O2w|0WTbn^wz#tL_fEh
zKRLf-<a8FQA`#n6AwU1E*XYhy)F&gS#%h_@-C<JP8x>XbuN`qBR$mh~YB6G>{{{?3
zZTR+H`@^yoD}?>4;Jta!b~BCD{8&qhlFDwOR0S6y5$_j`(nBM;aZ&i7E&vr4xu1i%
zlZ`pv$4n5%cS6!$2(CxEad>}*;7|z0*@&hiiJB$P*<Z7iB!mapbTY9uA94Bs%JH8V
zi-@X;5_%ij!NkC}-yT1_ZpwWio9NMy?Y*!M7qgDw_cyd2*-DNWF+x~v(EAkgMTM}p
zhHliC&x(w(Bl<cd{Nn=MhpU>fPX=P(VB1b_SG}k!j5KefTTteqqnY1?x{TDnm8v67
zV=kQJYDNl}JBa=M{Wed&9MqELsle`W++e(Zc)5i{z6A>wSiL_34Q>WJMQ0Yp{i`N3
z2=8jpi_&Sm^HKZ=U*;>&DP*Z>PY%}T(W21-;!N3e=KbgYyibI|UR+}^tB{4UDH~S0
zQ;46X*Uk$ZS@DD#bNTapB_vtJ{3YD1&<o037`()+g1}Js?w!WsPV4f~`Ss_Umrx1&
z4V<eHqlzD5vuB^*efst_0asic62olsWonKJ6l!-f=PICL48ikD6i`eybNOqJW_3dy
zD)xkExGP)l5+kDq2J<r7im7n60AK5_e3E{8ykc1__GrQy7(<yeXU?SC9*%l+;IC1I
z<yWh%BwCx}7!z?g?kV0M+7NMo)DEs{g5(i}R|(L9rO!-fYr31mPuhk=uFpPwTJzhZ
zeklQZ-|ttwpbVg%4r)%-3KmgMf+p;>S6m-(Mdb7~kW8W~UDogRDU@n2X=TJRA{0cz
zeHG)IlUb+sJ;sw0C^(X;D)r}F?9XdpkMef>SOv3V>g?Q~!XU<GHM?|!NmCj*J7Yt|
zWDK~9IdEGBvI(`d-mZ#i)pJk%-6h~>qXlC+iCpH*wPFUF=HV0PxA9D*yQ9Fnn6F01
zzLfcqz0J4T{(=TyU|y+D>}+FY6-Fk4r%ahSbL5)0UpOYDd^tFRnAe*^L48EU%6bW5
zBqTN$(K(5M5nga_{rT<4uwr|Lm_wxEJ#4%rw_0>yRKAp)VhRl8)aG+(?HW$yKy()^
z&)a?<jvlX=HkgrKu=NlI!jKki>eOopiEGy48!JZFdXaR*PV-BC8YP~s2V_4V@6_98
zg%$6GFI_}oGVRv{8+o8{(poSrJqzX)C9dy>m+ONW9HX>aU%$3fEd+QIY>>^bk4$^@
zAWmu>kX(fg=)0O@B%LI(xyRFrPh6x2w2c9AC`s?%zundhH9j(X_l6ja*^Co7RiESG
zo1?(-M7hAIMf9-Uxl9z9aq|`|Umi((v1^&BW<p~t{D)3pu0lPKLXu}L#2jhUgZs7;
zLg2<E)9gnNbB_r)k#F%5leoNq9eC7qrHL_TG~@k;4}SgPth>UxPTw=C9n|_Mn_}Kn
zAz@z(pa4WGn07$S*SVi=XC7pp{4tmFYb3eJ=G4St-LBemmL_i6zP$?)!(f^~jTHm9
zP5r_2F%(-8=(R_iRh8y+=_0PdM|VL(e2Id)kzLY?TveqVJ*?(?)-moB0lVxz-E-+d
zx;hm`u!-|O-i>BOWEfBqfg)x4ytAzWy7X@<8^;cgyL(m^ps!pCySt$I=-nA)-V^AD
zBm0d*y5oZJn`dh`OON*GAYSQpg=D(bw*PZQ!FwdxGJY3K1oBNKl;oDaoumSWn@o!7
zA;F51@bX<c*99U(+C0rXtg0%5RUbpM4*pLIFi1j7u5Q{rTCJ5>oIysj>}S-_tg#{c
zK9@S?+s5Kik?RF9i88PJ4<BTLWDPNh>a{1N-bD)*7*i<L_8t0%;}FolWtu;SQVo^$
zKR0U4R(jz^1<l3E<BY;Zg^sMwM&tmQCi$!Z(7a0@ZPP@%5Wdj>^gz4qG*T&?WBl59
zO0c|#IS+S;_R%{(HD#wx8Eo^YrL%2s97B>RYXuPtWxUUDqdxeUj8ep~5GGXa;F~g;
zH#!7{v#;)Q#Tk3GLy!_pritC0Fd<uE!?30*g1k-JF>*y5QYYv4+4IaiVS0qJieZ?f
z6gx!<C#LVF6U+xm2u~?13X>mm4|fzhSA*6+uOSerNTB~NsXqr_DxLwILXD5J`FOx*
zGt$zVjZf%P?=Wmpdh=!^q*u<W=LZonyaiCtyKQC~y>q9rg!+&n=EG{{*kPYQoO0(!
zSRQyo;npDtfpxTgw-iSPxG?pK<a<mZq(HmU7YLyj9Ei;Rs2(;%I3e@osiCDys!=b3
z$@sHhJkPgr_K$?|URx!sVD4|1THc2GK?FbI!B79)Hw2?F34};NKio-Rs|e&|l~SCU
z?Vg)fKm6THu%Jza^)?Q3uUHPod`sL9;?sh~i!nP|oixZjnn?GOZ_+yZ0fMSYRN11&
z6=#Sc-gZ=AhrjrRhF;WYjBwp^-IaO^Yu-ytzIP}SL(puzU5FEzMnb%(MLRrr{Md~b
zRNMCkYw6fJa#`FbFy4bbHRhO@v<C(Y|DcZ`X*@I9(&z~0xN5r!Sc7mXreGFnJ8s$m
zC*1{v*)G0dx46Jew}SC^We8kJ>45eQ*Hx=_02?I|tr!{`E1Z=#+@h5ftGYa%wu{P`
zh){79_EJp1h*m}jB|z-3V%);KWm3)PA~AkP4cG%$EYy+<fbc~Z$*bDNwQ@x)wK-w3
zI9fGhSy8C{>lpJdTIV+Y(1nE0I+S2u<&M9C0GNbxH~OVs`cY0|Tn;pwhbl>k5h)t!
zt!Q-?Y45$GUo<B5J`QEV&jm$rcYVuUbU<O`^QQdhG;l5c-!^KpMt#6W0CE9YXt@~>
z!>NHyAWj4Ww4eQMy@t-bN+K48C%x+M%t48)4iCEhG=Fa!^3DY-R%|Esr{1b$8LTKN
zAWiMxO^p1T@$)?_CZ&SvN<+>Bkcd(ehHaW>u`jTQ>fb|8ZIIlIhW`7+ARcUnSbupv
zFUut95}Ce&#Sb_nsjJL;E6k;VHOzqd7W8R>fqcP+LOzeIlG%vv)*%ftw_^8X`8sS`
zs)mEIn9df9DQfhn#ZI=jK1ib^OC5RL#nO(JoHIu$-JT3<&c6tWV(Rva-D=ZdhM$Cm
z{bq%g?3fW$1A=+0)+cb_g<t{Mh<jkk<2K|GF{rR(FFdfDje*!S=anOd4C#pIb<Pas
zcC9~th%+c&D%Cxt6;2i+qas$7-g!Kc?wv1`$h#J0LFdk$^Ve(I+S-Z-40R;NF)2TN
zZ}<^J*h?!3FEwbDn|9}c94j`tYzKi_czLrV-9b0Ho4@Edxt=C<zKmhGl)*G%RmA~g
z*1Nm@%=06t2PH-^QMhS$dV(Ndc$E}gT}A&*<;L#Y{#x_%jF&D=FV_5!K2@xhA^U+x
zOs-Q8sn+WXZu|2{Vemix=-Tu)e%EQJ(f)~%K_MR^e|;Nf<j3Zo1#R>WI&eUV_Mn{g
zieS1g2^``x@DF!{$u3#CR2nhH@!Mv$4<9|MrU<Z1SOOO<Fa@OEF@_4Zo`l?Ffmr2w
zyZ@fNzb(JG7O!*Ok^9x`5w^P25HZPmauPf%;epQGiSv6dDrWrkTj)<?b{_kJyGAG?
zglg0an_s`Mg~bw6i0l$^tW)pY4HB!7S(mlTZ8n`?N=B@$LHt&S`=i7qOkrSk@(j*9
zJly!Rr3d{*5sjp5-g7D_Q4Xv*@0_@3y8Fby-~GXk<@8xO(AoB~()cwU#;trJj;Lgr
zh%n0^o|L488F?lmRhz8>3s{6HS}kVZeEU>Vz9HJdC3<zpxpuKTcUrwK>w||eC*lQ&
z-fUNmsvix3Z4tOB$qS~C!oj&tmqKV8QyzqEyZy%#2``g0V%kgaa$FZKwD~yN$Hyld
zt3<kJ;p@xu)@t4(apLc?zD%knQ!wO3mW=YRynlZiJ_F2g2MNwpM@Of?N@wg?084RR
z787hll;C|0^^RUMX7uRGEWtam@~QqGe#&AsEQ8+a7ZMN#uH0_WS-ivkqKGOabjCc|
zzGGMcbqk{^w!<X%_*0g56O<<^&`<g+fioL_wt7wUZ`pbO-(Dj2e7ZKni438N^<$cv
zn!?g(+O%o?^}VG<ziwr<^ZM;h<D<6Z=Nk_1J^~Oc^Uj3O_6ZY8LEe^{&hauIFHAOR
z1H>T;jf&d3W5=wd$0!~C0xoBEXJ2?PZ4;0^bCLuO?S~qRlKceUMr@18xB@*egloA4
z`blgEw46TYBx=KC{$-x-!0!79^Wcz}xNCUJU3RyWvVP%}*~NDBpW{N>LZ2>d?<B;=
zE!ADp<Oeyuy?+ZDl(JVS>f1N0dwWL`*kyLa@hQ_^hD!69PO#ESU*^wwK|U;v=LOq?
z_a=@P1_V(xqmWz0+%~{p)h@$E5@fN)=LwLXs8#ncnDa<0;~!4Sa;XX)DBYA2=V8t~
zb$L})yoS5bB3uQd8@>KZo$A?Iy{>}arZBbJb0QHk9;D(WuSoFFKxDrC;%oF;h)RSy
z0cYT)zXez#Yd`}L3;*U3Ctt+6-VGCI1iM*2y`0RD%|ME%t&H0NS3fveOmNg=`p1}J
zb!=Kho#;LDH*T1IaAF_R!QTBRVLjUq#=I9XO)PLxnJ}RrMVnBS(ZBBr>~g?*6=Q|i
zht95#e@zfJp&<2jxqcQ@f7GZ^muP(bl;U2xxK9YZUb{wQbh=ueoiVl9r{BLe2o->6
z!PuY1NrdW8-F!D>_^NSsGZwqKZ2^!<z3t}VAp^;C=H|pETzI<D3Iik|Z5Nx9CV~4#
zJjrL-&WST;?xi0Op593NCxw8X{~-U4+_v@!5lP!4BTsO}Y#L56e=bC#XSe;ju?&+y
zy*00-8G#t&EjJ(Gp4j07o52o&7dlDCI$7=JT3Uu*n!4xCLMD++VKM@mtt8TIQe}YR
z%3}AvDFqsU^e;G<^n@)Ld*b6yEq-0)0G@!P&F`&Tkw`o93CtzjE!O08C?j==9i^f{
zh6J~M`-JNvt{~-}>(ZsyezZ^t3iWlsudj2SmAsyY+8;11;)8Nu24F!nE+-h<cU0Ys
zTc?m0aAe%j$f|v;!Go70BYm=Sryj0QCET83Iv!Uyx0Gl<VS9=0@jV$59LnWl_!aJ$
za?h|)C>{>>(vJN6N<O@}q{I!u>jRV+u$7KU>Q_d|-{Lumu7f_)qE5ZG*t0*NGrrs@
z_d<O9H?;jWIJ5j=ds05<RB&1-GYTocyW<K-hBrapQ@3Y&AC8qY8fL4<Gi&k3B?IOe
z$qn5#MXcl@`bLS^AwS1%s_8l3M%A?Gd)p5mKAiOVf^w-vgiNLs07Tq~fG(QdM#wRe
zpa(rZ(eJaV+VD<MJVgQTBB{LdW}(JbAW9MLDQgPpL;t+*dA-*9_$=n-T@~Fa#RlLi
zT~GfYoM*~+*_p#$kpwlrYBzD89dQ4lU(C?mo{Df;HrwIYJ*B1_NB9*aNAFalwDREg
z6<mUL5*Lc+{>d~is2W7=hFgeiUIXTscsW}BIHczS^0pf9a;?}nDMOdl9~e0r-hH;)
zK%;;T5;^Cu6^e5)ofl>*fOW3gBrlLd(E4`NV0Lfwm=qR%7Nf8|7sb)yu7puBa}EM&
z|5$A&CjuY(xvY#%Nl8J|HAqzew18EUxI#i%a^#nAM%ul5(6#L|fMWz=O8T9>{>^jI
zVM5YEZA_*xy^&Wa(L*d}B%g#p9sXm(Y4~|6rH)sg%?5-A4;~0~n`<PmKj6x!>0y-X
z+rac*fNoZVj!fqKl?axClkI0^5yNcjXrvhqj*jf%>Ia1+;wSYJSgr)zXVM_;+HzE+
z;8L*}W1^2tO|=n6pt)+4AY%6$Zrpc&G^fGd&hN*!6~wa?oJNHcrN|1ry&6!wV(9cR
zZhGyyMK(jJ@K%E|Ax9fl*|XT?2CtsR4dqchr{V5%@|7?pg+-LVaLC_PSoG86+pZXR
zVnK@l7f9_=kU)aJWgkay)S)$hb?kfz+!&*Jhw3vxd7F3b>OqMYGw@h+<o4|^sZFS!
zWRyb2agF$`m(jJNc#LK`tgE+=&%>OjGQrG#wP)<1yt48~@`B5JBI=Oktxao$!#g@0
zUaagdU-~2Ae@umWM6Zu+Uq6M*F%@qk1<}x7U~X6p-P}LkwocvQ{2DbOMWLxo_kPCL
z#u45PD%JA95)?*aQ>)l80kNNY>+9Ihv2w##hPA@bZ=XAVKK~&n9p>18p@>F`sJQhm
z@IA~N%JK0mr?;enz-i9UQ^c`nj+1p$!NwmS&Wib1Gz8ck$7_#}UB^x?v3d&f`?~D4
zQ5p*<^dJZr?sJ0<VK>&i01NB2qj$L~`i!FleS&sO5YGBCTD?a)htiq5!d;tKynG5p
zbb>*C(YBB#FR_3IAbI&j>dnBte>2qTJ$<VbdNhRR3Sh<~5e0EFnDwXzzRQbxeBNux
z#0}p%Gv5Bn$9b!ZpIHoRZXJLI#41DDG*_TCFenSGqW&MM-aD@6zWx8tZs1I^Wu!<$
zvSlS@q@s*SL<y&iGV4681{y?3ib&H4Ng2^uq$EjEiR?nQl2KOQ`{DEXet);$_1ATs
zS7*K7uh;W=jK||~JdRCQWKZtapgH;kiVNwkCh>ho>$1z+fP^Xg#Vw)&Z5$gMY#$Tm
zX+{jzO{&i#kpR5zb=>7VeKEj`xXnreh2>lVBcd@$6$AsRTwix>Kgb+m2%+J(AXp8!
zv)7s_C%3QfW}`r}U}&oUz=2nRbMpV){wrX7TVrY)yHlIKeK=TT6mBaC!~_pCRwT6?
zHR`{{A2;*B;RJdkE$%mUK!HF`m|^^P-Fh_m_!TN}H@N9`eVi?NCApnH)2-t`D!Lcn
zC?}(t_axW08zfz(EKWnUHY2`PEV`wS0d=H+j44S2NC2o}u(*kIm=*`$x&l~UzI<7M
zTn*B~c-T%|)dIcN1#h!wmyDa1<Gy<JwAamELxhN%q-etE7oyL2Ho8oCi%L&+3mvtI
z74a1l1)&$72x3ea-}(LV0^Rdj%H|r_u6+Dh*iUyr%h+>WH8h@)lxU<7jAZc}L`ag1
z!^21!Q6BaJCu=c{{`~PtccJW2Hc-{Mzb_vw#m0b$mNcrSxeG(*^Z74eboaZ-zi-g>
zH>Y_w=P4#tl6%z9h|89wB)XPK>@1>7uYOt3<=*}K;@&M=mVid8>uQ`a`e1^)wP~*Y
zU`ZeZQ&RoWI1_aRs(2q3t*C(5+2w86@sB67;}_Sw4#|xB$+S-9@kT)ujVSjnFKs%g
zgzqbx!=x`4?%gcr#vC=~p(Lb1?PcD3&%N13GIZuM>srkGhbRHMMuFj1WaA+jS^yDe
zMT=?5W}uljx_wVF(f#P?V}UlZ67UBzE5{8xpaJ4-*HzoKCg|os4&X1Asd*lIkCpRX
zT?6Tvj`i;}&EE4-<5}D7(0ILcWxKL7N4u_Y^Y31Dc@G(_nZI&n(jC)MG|~cWN_zY1
z;Wvc}SDGm?z@~>gw(!;+3rkCi@a4fzR9HpeQU59antDCJ@s5s0jmZ`{aFdw-)X%7-
z!>&O5qWgNoYMNHj?;-i~!V>IGmEMk7`s2a7h@soiB8e;^XLO@OAtBy8Z@5DxUCX@w
z#}_PI2m$&X1E5~``Lqk*eB33jy5qLCb9V6G<jK=#&*qSGSjbXJ&(egPRdRfW3dq%X
z6kC+jTgbuWsaeiJ|3$>4UAS-=YUt#?$7|f(pZ#Ytea@UN{P7$BJr9k2eWQTLok?yy
z&(q1tf;O0#u_k5A|EFhE+|=r|E0up1vpTcp%t<7X0D;Qwr9PiApnL3S>&Rh^7;1$$
z(Cpni!E*AA4hh6I;Pu7dCJeqQbdr#Rvhh+;k+nqjXm0*ujXdW34zF@)qKL6xlzfRU
zMkhHykp~aDV}Z;?xJG+{F+S6=z-jXb#hZk#RXsVY<m1q;R}-oHDoCj2{SLe$)6h=}
zU8QTC&`GeVpi0mXn|JHzG0>?@v(Zh^|75(Ka@uPTwM74RHoOG1O}AOaJ$5x?iOv9o
z;n<s67&`s@{o|v!b<UrE_{PhoqYVd3ox;mKURvN!am{sUS6@TgaO-OK(j}_I1`nn5
z^mHLLsYx)VtWV69!9q(btG&O~KLf~!dV;#w3G&h6VB#P|Oy1!8g0SPxI~>H!@zpxg
z%61Bh8v&;~jaT&C8bbpp3RPwGfD9RTk@mEn8l{@lhQHq|f+tr+7?0ERynpsl94UdX
z+RlBKt1G=3mgHXija~>_K)(>9)^$ky+h{+xS%si~l_QAxuNL(v-z6Peg);Zd|5sK-
zoZ-i=ayOr`--<ja5sq4c#kFp~ZJ*Mz9Is9cPi}lW=6@j!-H6Hh?XMOWPm5LF8eYK$
zY$Xne>|LYK!+J6h4NK_157F=UKt2l;KQeA%$rahfi>!l?hn=O}t6@uV^v)_OI$dPn
z3M(}#mrnemv9#AsC)ydye>F4nz4lXsW$+r57c(v%?-<+lgwK+kEM>F74>?}~_pvC-
zbj)LL7rz`QsD<e{d4sNsF*Qud^G}~V>6gUkZttkE*Fz5h^=&ECC}Jk2V}d@XT^5D`
zAG}x}*Zu~IX6iv7dF{(?ftL%D2o%q~n{hw=a+P%*FD#dykR=<_jn})Q<O%p?|M22k
z6`}EL;{)E9_8rT?klmI-q~auj&An^dwYGucooBPu>lFu9>g#*u<wBY-UG02|f<<&O
za5=ZZTF@S-&srsg2~<c&*5*+%HM6|Y|9G&SPG>YsRMNfr_uu^|I?RNIrLLrvZ_UV`
zqQ>?PD4a$Kj!99cq7gp}i69dJmjx3gNduD2vbTrURNK|Pq5Hq<yV<S&+R*6d+Q|oo
zSd>o+)Si8&z4qRspx)P}UJKjU`I_IA(By5M1{lrmeB+*N^qF=>XS4!#pWS)qlv&`p
ze>ZKune^k}_)GtOta|*wb9A@bx=ok9ZMx+-ch$$mo|_-Dj^*X3<IdvQSB;j~>-`5t
z#FPM-P8qfsgHnggxaQS|$(Ek9NAz^)mlOvN9xR0xFGMWRDBJ@j;~+#6_b!Ftd;8*>
z#aI>JzCD(<@yScqV_mvw8>2{Q4QNQ>dd725WUmd;-0s>3iW3>pvxwE)Qn1Kb;AbWd
zMGuGy*hpj2VODl7Ae`=Of44>R<`wYbjh`$prPu*X(wsK+KE}JEk>tQyPFS$x=o;1c
zD5~D~&^24)b<{5q!W20Dz)v?ERea*(wdtaBs}^P@VfILy{r8OA)4UMVdGikS8)&%Y
z&6Fb6Q}>VbjnN5E8v+dG9TK93g++LfH-ka~0Y`ouyh+4L(8IC|D5Ic$W#`VFrP)Os
z*mO~My@3N$?zfJi?*b%v>a6)8@x%#V{1v4He)VdJte4fRG#)nWDc5#n+Jn@Xn8pm;
zpw_<1_exu*d2kL>q3)laPwI;8ok$ST9S-XdCOMxfK#WA5g{tQ`Vi`;2B3sSGj#eNz
z(#kc~s|B$9JE77>z4S`jrAx6fF{W|G>q#T6WFF+Yis)hLAh~WQ+8NT<R}y&y(PZzU
z?6gIK;h(*A@SA)-r80wI!#4dKR&3Kb{_x=~<eLfrHwTUN$mg(fx<*V-GwxS<0qZ#V
zq<jawgtx-4&(d!%uMWFpFp;cBk2KI!MlJ_jRPY<`qs-qA_UN9Dc&(t!$%>gPrpAh0
zFKPCpT@%)w(2X&Ff5r_?6)tdf)$3n1<Ji|@r%qA44wT?+ZMX5wYLPjTMY@zU!Kp_U
z@6thzr^@VPSvG(HOiV=lON?I8YN~eW^5F1n(+Qfo&0=soNcB0Y8qN5~J5+NdtCg!f
z>;Iv5$16YN`ok}`49RcvQ|=q|GyLmkar`Qpku?#Xjp($ta%N&LTnK-yqi${!s>-66
z%Y^UKlzq4IHYGS<HVlY+je)hgAyr&up&DrP#+jOWudMxDhTyy!Ii53kjK{YR8qUMF
zZ0`4!E@{Yvvl#WYLIL<wCC3H#eX$RQQW7GLYQ@{t`9XO(hMQk5ZBy!5hd&tk!AnSX
zP$~zFr~?FTcW?|$<FDSk*O4}xtSwCJ){N8PG3AN;l#HtYRvXdBh(?OuK#-9CMjVXM
zxyBO4EZm;x4V;aY%Xnm0Fs-J5Ys|JZ<JJs+`H>TyfwTnc;@kFTt0gb-DUX7g&rN}P
z#x@!%fjMHPhVlH3HKD!1>;m34iy<PA#fBNEzKG`TSRa|nEful~W!*6LgUC^9(+2<3
z^S$kqk2(GqbM9PNRI;b3gG2h&_U@@>bLVP+-)=ZC1xYX^bYoBF7GGYF6}R9~-TcX>
z9|m&XA!$Cn+Ykd(4`}d*DcdonW+qOb)Ff@%wcE-h6z#*_*ApA(KYrXzzkTAB;};P*
zk7IYt-6Y4t`DgAPV9zF?wE4?Lf0}R(gzP0Kw&~c@qFK!6t|zMxb58WpzVPV*;8uKH
zi;nr|i4$h145LE)w^8InOrI(}c#)Ps3jB*rw=3|~W17WqMy4N-I{^^r&4nno0kfGG
zzJI?HZU2UdkNmA!85@TGFRJ^=<<?6f<*Bn~U2y9eI~>QERznUvTGqm5K|j@#1P`P-
zqAej4IfLvuXk;Q}5$RIdzKCx)(t<-uyA)lQG89EQt-S2_lCAbA4z8hi3J)^3*)h$=
z#tU=}gK=@H6pc#J-Mib+J3^a>2Tib<-U2$?8-~zt`jM89akR0ax3kJ%#%`&70(tVr
zxKvcKQiPKE(5^4k@1k8Nc+8<gL9}%PG~#W9g@gPo>#~;Pbi1)lzaQ&uj_%*z8QTB_
zg~*tq@7B>)?Y91&^ULaN%+y(ZIk9S6Po*C|bt;IMm2qm_{1q#LIJHXIJ2lk5Nms|Q
zrrHu4LjYYyr}9$j;Y83dj@uW}!89i)M<!>4C4iE+jAtG1+X{=lu&^*`pcI}GqY!0u
zpyz2pSlCv4_7>)(Hf&O)EEuS<RgZz;X!atX`8a*d|J4FS^P8KcUQKtCIH3>Y0v+oW
z5MYs#R9sYaS!P*nn=YTqub|hOX<+DB2-|k{>{;0GXA1@#9|cQMfAMDva~pN-hl)Lg
zPGWOFWuL#;vg{6ji%8IS<!Xd>-MH>D9Q5SnGHdFJHtOoWv{AC4C%NmF$=*X}^!Sb@
zkRYLK9$c}xw8Qqt?A{<BBWdqA<)u5uw`2<&JG<PyHG(6dhkS;la69SE?%MMf5b}t1
z*u&LM;eTlnqsV}mranAo!O9UVirSOsUj)&@A#fb=b*j2K*Ul@)$-g8dQt%^A&S|i+
z4c|ZeudKyFO!gK7XUGQ-x`Yb0C$tD5iKg9UO=)8bkCxp>Q_Fppr6nYd!JvF4B_%!B
zhL%{lKO#Z~w{&!Lp1!%DVTG@3S%7JSRj9Ea9zT<`9=9+&nwZ$6u4<%4CPycl-7ZX{
zR6U4P|Hul7s;U;qp%7<3Ls~)guUS}yBh5Ad^@;C`*U7eQxeXFm0F#}aofCQ~ZKdq0
zWEhO8$;-5ka>Qt(2WTXgqB1Z-oE@zD>Kt7ZY(qrQ6-ArZJ#>5a^m_AVX@c|AlV&Pr
z=Cj}}1M~CCR%2G9A7On~MnFnSOWD(~^ve*Yr-4qQ^KYv3K;Z$TGeE;f>IF4~iXzt%
z+%F-vM~@x~U><)LTj@DgNS?*bm16&Ph1JBL*v9RYrC3t`IX`mZT1Fo|>WAWH(Dx0r
zhWD18D{ANWDRG#3-I2;oJS`@_GCfXk8#e&22t`|!b?7uYoNHj&{n1OyFaq@IhWF!5
zZM-e99Y>JMW`P{=<~HbYfkzkce=`W=WZcc%M#Ds;3=m7U9jX)r^c>4{C7#{+#h&OL
zeW`@6f=TcyFO%_wLIbWQ^k2@;pL{rIsLr#?PRae@f9Ru(xb@TtMI|NAzYnNI%e4)n
z9DFmU)P02a-S%5`b#zkyZEd5c+HR}$(e%q^UawF`_B1q{GD0zM3l)M)BtZS%L&C<F
zZ%R#>QLqv~fZtNy$a<puQB=Q_?Nr=8Fg?Y=zSl4rtmbZzVDS`fDufRTh2rG$?7Meo
z#s!Vd1?A#Fkrlb&AI*-LgnsC*{Fi+X-58!SD@V%Ttg9gBa}+NFG<il^4w8P5Db|8M
zy1dP_@^=0et@$t3WrhK~)TMdEUL*Gkv(InKcHQpEC!}o6M%UXDkKNk(d&^|LX1<e?
zH(|JTL&mxC(+iq_-faa$tsu~Eh#G_98ZElj=qOC}55I05>wPq1*dT62RZjHfF>@1%
zL78>ijzfP98!<xiE&S^XTjSrze%cHFjviWeS&ODSD=SN0cJS=+elZuuqHUG8j0~Fg
zUM4=cAy+83;G7o9Th_dVkH+(ieS-%L0`TxB7D@^8wzABy=My>_u-LZ1`SN?o0k|-4
zD*xs8-3eIG1GI=C$7^ds$D^#NAmKY`kU!cm)s||Kx|edUnkho!ZF4NyC1>%P+*mA*
zRBu(h&gUnu)M_>UjAr)hcdM+i4LmqgjYW-ZdUn8w7R05Jk3#je9p|3x?7BG_3l=Zl
zPGtIiNvkR69OkGIQf$_3wcWpezvToqUH%H!P4oqbHCnZ3(ITPO+55C=qBy&Cw)ujg
zG$=$Gw~Y<6I`U@%lu}Kmn~541j<f&Z!OKhEG6AxSw!7Hn<(z2hZ3vZRc1QYwgz%B?
zm^w6yO-kB@z`^Uy;W;!f4A9Y`G*V!oNLhq(-A6}0TS!vZcmPxGMylU{ZLsBpvBWu^
zoUHW7xJgyKK%_H3R*gNM>N3y|5G|d=oktkPwB?Tc&jH~40I}B?mUO6F@4kdhXoXBz
z5O|*f6TN?&!L}qRq^D1p$uOL(Z{@7{*_J^iCJ3#AeNkjk?%Zam5qQU$sp!-LI_AHG
zOrjL5VWNPU(7$NJO(8s`=JPU8ZKJL6t8OsNCU7?`R}05|FPd+WBo3(>xp8-Sxjm<U
z0n$3QidDLX1zpd|YK-3qr)sgWvfWAa(p<iKh=J^`B|4fuzI=I0itkT4*4JvE)Ta=t
z$713$e_zB<Bco?|XB!cwq2S#&I@oa00-$M~QAty1Tq6d{P@T*u<2(#`n}Za}V^w;;
zr5a}D&o)-eraYJoIWAA5T4z1{U}0G!8!f2yRA4-X2a<KB1dmR6cW7O>j8oz+ss&(R
zI#GC;n>Sn1IHMWUBtnE-yl70ZUyac-Rmof=U#+kUcF5Qe@mj|r`qZh`qehM58~eQ0
znLYx5^^W$-t%?S!?QBS|r_Y>OI&ID}NIv@><;t8BGb%=E$_MGo!Nk!&n@}F~hfpz@
zJv+kWU=hpW+tPvz?-P&hhTH2q+VpNlk(Q}N+5-t4iIl6Y7`Z?B;m)neV2EsaaZWM!
zfB1<RMUkLP4%7d$v}Uy9zke@Xs!0dL@CJi+FW)|7=A&R;3wEZp-T&f6gl_9*zhBqY
z;)4c77+3J%%>89@eZf-A0b7a==};zS(|8y$O5S{z>(Zqa1SnytMBT!1@tQk&PfWNb
zrlZ(BNh1E!vhUulz_}7ylDlD<+jh1b6&eyI!p#USiaj?R907sPX_){<vSqV!4Od^_
z`$Oy94(AqM#)6~=S(A<}A=YhgdiqFAi$p?CPD+^TTw>VMadUbFVhOlUuEwgc-E?Rp
z_U)NgGG=IN<Ke@VmU$gz{FE!Sd*8m?Qul(JHxc5Rt<?OnkAP0UGM||Tnh)9GNRX74
znAzH%#C!p*01l?C_OtiWd9PYJh#EbkgC9z>?mV|OnU>cn9_Ldlqa?Tt*z5*Md1!O{
zv)S|l9FzHjnv|we;w)f9MHm)5#DQbNgS0}W>&a~R-9^E7-K5n3nj9_v>0{4t-D<vF
zUo~FCtZ#4POPlF-cH1ez&!)M_Z}9m2b2xRsN9g|~64KS1H*emTbKefN_fzi36PDVL
z{BJqo8DDe)dc`BtPNL0|rFCw)x5awN>rL0mHlg$N^z{jAeTde1bzV^P%2H^d?W%Uk
z5SWeFA<UQK%O9dbmlgs$!5z@>waXtf1+ge_?HqgWc~h(Zon7C6+09mfGgz_*>F*JY
zu%*u2ciT2)E29<81ayhFq?*{<RUpt}buTwe9xH>^j+@K+T6AO*RS9`8$jcQno3vO0
zpu@3z_K0j@{Jka-jSoHf)$0$bwgva9T1?UufMi3&fo@Zp@JL__+vZtw+6=dGBUu8n
zZ|2HzidXOe>5oM({ihQxknkA{2n9z)?V|Nvf3&c9z;M>0jJ355F&W(CsNEBd4^({)
z8f83K>TFHB(~sLP8`1@?OyCbXtoaKU`a*!V1y1EMH03xk-rtfDt&H|gx3yo6Xx&@c
ztX0dFmlvfp`&1kB-C_B113-FYHO=|FGO~&Fsby~C>caXGo`wI-Go>-!fKaUaMAy|<
zKze|m=(z@yR7KFipC*=@&YeG;lEC58x}6{O!mDop(J=jOIN;-vvrD{ma+*?YcoR24
z!n|R4&;NZ1<&KPih!|~Gh!X2`blH=aF_!}Kz@Wd?cvfbgo+qEi?`<n8B4T_*&>j7Y
z58JO7IU_n@%iO~{7Jd@lY428?SrQnvso~f9S8v~5#Syh?b*W+5B|uTO1=nsEy+Yaw
z0W_rrWWm+Qs3bN?6LkyLsTSnrd110sn6km20NFf;w!Za?f19@tY_@oD)sXeqS~Ac=
znsr02Ohs9(qp`UwR{nJ11?x)rkls;I-RWI|Sg<8ycp&>9-1^+nIj&9b%7CjG@^hMe
z3G}S?xkB@X6p^~#**NC<n<cqPmKjePZq0piY{$M=HJ=;Miu*q=_{y&pJgQCCt`D7V
zPXf+D)<I9!g4tMrmuFI(5`3T}n)K;&r1iH56Qg{FszJZ-jc8eHGdeadt|?B>r=qss
zEh#ZWKqrGNr-Jlg<KM`CMNMfclNj4tUF8l+AxDOK26!ag39WmlA6?bXwgy}q?O{G{
zoX^K*F`#)0Qk!PnntXOHMKT@dGi0zF+X@CNA~VN~rB7`w8Rg;{|JOPt4T&Hrpi|ZO
zx%VQ56B=BML#9q<u@^%LvgF{i#_IR)-c4owF=>uiDeH&<%SxZk{M}}6W1EZF|I=;0
zLKryJ&TaySx;#|_Xa(TNji}d6yX__l_ADss%vVAE!1<wYpAjh>EXQv=2KHS+gKL@l
zv<@R-lwbj%jJKTi+Xtq^N=A~ICptZ=6_*g`h%%7QbNT+1WA7=eWW_BbXify?s7I5+
zX{vZIv1CXZ8A<w8LBa6TPf5GdbKv$e=j=n9)s=(y$y!oomdt!^IWyoP(@X69Qc;iv
z2r%vPO(~Uz=<Hb8&vkVKozZf3G6*_FOLiOLdwdFBB5n9Sxd`{_Rw<-09Lp5U)07vd
znnh5~;DPK9|IeI6HMP}EONAxpOj6lp$bzzwg?Hw8Pwi@72;~I(^7mT1oBRuc`-5G1
zLuKqLu9?Z2bOt4iAR}h}_n5!|5qOV%_Iv>uE@fP{dYHDk(vj~UqWOO!Kc1!QK@hU5
zUtZnTS2b@NPS4U8YF-vNta^TZac-cvi*WV{2Gz53LkO3Wy$J>U^DJ5{cbL(_Ye$bA
z8_Qf2A_5<vn$34}QjYx^w?gCXkaZ(B()vdZb8n1dXo=fABLKzPIvN*X)NS-2O%x=~
z^B!0W@+#$9(VZt_f1TsjgDIQD4zI`E>&T=0(<;We^a47}hXRWlWoK_6K!u5tMI@Gj
zt8tc5c=+)!IP%J$GYqxM$%0RxJ{2LM^l8kdRZNO)4E_$cx_YC-*lA=p>Zc2rE{&5?
z>*Y(?vq(4NhCm(5hbu^Ai1&@%Z~vFke}=lU-rw7gzBIZ$b~+1fFOT_Q9r_fLj6c(h
zh}}dcK_dr@eL}63WX?HrRMy^()bRxH1n3s<N;W$(=d#c^r056ST{JZ})yNevNL~U(
z@dD$SmpIs0_((@D9sWIshbzk5pRl`@6Qaw#XyZD4>W;EVbLU9?Py{6Y)WgL_bt_;7
z7Q%SHFaOFtXsY1(v(9MWH2>y2t^w!_4ZAHSmYZP<b^89YesM7uo}rVaz6m3Zuip6X
z+@@2kjoJZo=C9BL`9oyxqeqYYk-pTkbe7Dmbi1TPOW`^l*zhFg7_@jy&$$oms|e&f
zwx#^Fojv>hyGVoOcC%+sLbx(n47`a?*P&CbDOe^^Ui9?c4Sg1qkT70hH{y9!K#Im&
zprHbV&_nnd!sFQkh^9uh5QAqa|N8!$#Sc9UT<V!s??iUBnL739j(vFbq6{^m*-`B2
zOB@Tv?L<{U3-4B`ZdFb97nD0B+*L3EsVhBRW~;7EaZ)=4f26UrLg7KCplB0OxK095
zD6E338?+#K)^p(@q5?ada!51fS4z9<X*>lnLL(E(p?j}tmkl|<?80u?oxmf*%M;Vn
zBl+TcU`j)1s|IRpFDWf;Luqn`m)YL&2YO{G(4Aad%$K^l*6$8F56^4Dahe43f8hK^
z>_*+!uGJ<ykzsaI6xa0VY3?5cG#$*w^&skvU@;KnTI~7sX;p%=k}uNCHY-<toSB&s
z+dWgw^g0(#NnsVk78M^pSkw3@ZE5}lp2(mVuO<!@#SAyR_JQUQr{fiSqS)?bHe<$K
zg&u&;3mLhf20WzD1N^UQM-AuJ3IBc|vFqH%iBqSl28V`fk-{R&Lc_w;6cz%GN9JDe
zJn`UO&1d93ev~ndOaN1IJeLDgC!agl8?tdB<J)G|)<I;tJqQ_s5t7NscH=En)~ULB
zJ$-Rw3ZV1Z0VJ^pA)M;);c1H+R{YLq`2&4SlGTGjxww&WwcVDF9NQMBNAB%J?4ysJ
zJgH4jl3h@+bIpf`5i&GES)<mb4Xn@7@E{ADR?J4L(q7xrFRlqKBq#+XMveQzTlRxP
znK*Ct^}@nFjO%7&aVq~dKRSS3xuU9S0w8n2n)LSmH#`^ET-<b1MfBS?wzd^N(qlgT
z&<>FEi;zqyFh}#r#%~(+WR~LK{VW;iDJuJ2ft|wk@3+7u!3w)9^FLTY*I@4cIECFL
zA5+Di)E$sN+hnx0WgpiubkPHF(N1u7E8rseGhD{KwV0lfY5sS^)X+C72fqITH`ipU
zBTPqEH$+UW<~~Tdzw8e8{}b%u>fsU9iKkBWmSIH{JP$hT+KW$}!fqJfep;~?o>8GT
zRY*e;UY5I}u<8waD!Tl4xi>HqMHn|lFiZjKuUMbtPuEmeKV8-q=T(R*rN91Kxh^B@
z+z*J)>$KoqmerQpIbyff$vRntF~d8Aa)y9feG3+~g{+cecWWJe;m>!PcFy}dCk>t*
z)^Be4VUti*Q_f{>UsY}2-7H~HRcK|s|6J(VW0og->W=tFz0{^vw~^r&($b7Hd<a8#
z*o)UZ>VCSdjm=nqMn5p(!m5gRh66&ly1`TsHOqofxTv;kx3_ncVZVMWsy7-;WH+@x
zt|zY<8S`XAZ?XF@f;C;vxcwWg<T#!^t1SkHkabh?JgAaB1@2lvW}nQ|wY*5Ap;`t8
zJ14)^u^1$K5V$kJv;sVdc4rs}&3NeB^Ln{`4~t!n4R$^39ephndqR1%Qf|Qy<e>o?
zHl|DG&d46y-YO*3YAReum@;e^CdMJOkE=I<RT)Jv)9;gpV9H)!^~KlZ70$WET%leH
z!-mdR`&5{gitOHfMMe0K<(-4~?tSra5NkEYA;9Retjysq;A_l@6PEm%E1r*wi&OF<
zcRpL^wS=DgK;ZPPlh&>sERh%`?n`x}zcB9-ZPMJKsZ-T6<*t%KRxvx15WC?e=a#Y8
z$hXagF`Gv^sQ;vGm+QibR=!VVY=r$e<*J#z{eH%Mce7#4cGj%xYto0b*;|_xv*uTL
z2T(S}z?_OnZ9`uA-T1igXc}2j{<Qc9Vo3XX*hvcXaU7oEID!=07@y#{$wM4~Fg_$I
zs&Gx$;HlH5jiUsA@-)HB^!MKvzH+9FLf_;cWEf3S%JYJ$?~?)CG{s=PRS)~g|G%4{
zcH;Mok`Dhuq*zRzY_#ZR_`2nVPRT;*(4e_<6NJ$w^cuO`2sP{`VsF@(IKb%Llrbi3
z9w(N%7%P(ntWVv}Wq;E)8mJ};fONz1Uyh$Jp%)Y2gcbZ3)T+K9pMrqB3N3OVGBN%=
z1(q9J5_S?p@2!xj8*l~w?M4c~8w!_atDQyv$j^^sLmuW;vQK(G1A@bN5Lm)&qo-KZ
z(6V!vB(lwn*`4PcijCJE0rN5EX8Ek%V`m-ri_v);z|0rKVls1>39;f-ApJ80(dF7S
z+A_vnE{)$8s@|JgBAgXYvL^JFZS}*jh=}_YpFSxR0bCxs`DEVzlBEF7f=AGd_`ROk
z73fj~LGY=2l4Oum6fMwn!Lzak;ful8%aSjjK3R3bK;ZZ9A1jHS<nb0V)B$d>lee|H
zZ(no&Frt|g5naZ~q`fBONaqIQpG~Ze2<oFQ6(Z^)_urX^4t2xBXZRRg8N0!eHC7;S
zZ&CGTv*E2;9zoPj6k@*Au?h|EridF1c<{>pRg@nG3bK=&ABpnS(Xl)7%jYB45m-dM
zBgyC6QLZqVU7>Dq-@D&87J#0%PqCOd(F9x{QD~+9k@J{V4teohMvRCi;|EroVtqi^
zm)Q)~F|=p%U^x7y?X+n!Y)BdH7IrpXXDp#X0f>&)^U!OZs7~x!rb!aL$EhIKWy@Nk
z>5ZPdD1-7J1Sp$VgLL0d?4c+bitgOW;vh(yPJKoYZ^7t>vvEK3jpHe{eN_eO)Y$4Y
z6}U{sZk(N)(5BE`U%hiD<n^qRF%U33>_EEftlo&~*^h)SZQQbDCoUhH(0(RaRM-kq
zcIS~Rfd5G%(Q`Zhi{gKN@+_c#7-~D7!eQW1J|xwkPVim-*9z+Ee^DGxC5Qsfm5<s+
zJ;;OE%IiAo5t7zR3FjjSyW1&?r<~d`6#80dR-QKM^v_Y6#oXZD){%b9fI4%AEpz`)
z4o`jzeSRA`33?YdYu(@9Dja@|HDdx3N6_-8!x=B8KplMP5y+;^v}v{XKOTdVP<V>C
zTA}DwPAnI%kpfOirLX)iB@93meDrpW{ek#V_BWIV{qEK`Ky4#shHRW2)~vN<Idl+y
zG=HWQZtbD-$LVN3ZE8_b(bLxs>DQc+RXcW6q*@nf22i&`eXQGLaw^2oOglSgrsytg
zZWv9~rs?+M7Z?m+Ll#&U%NfRO___gKyK^fZ1puk2WM^8fP*hU#f?+^Pm+3+2wKXZ@
zyD}umFg8QLhwl<F3~lKwtdNk2W^K(@*S3d$XpRC&e8QOI$>w4v<HIOck}}(e>+Q`o
zW?tsI96JpDzDZk4tFyzh&eW+i>OK&eqR<2<@%Zu8psN1b@2;?~Hgp6EGP!7F)rtbP
zb9zF2Wy#lWZ_j=CC3`OO^Hq2g6L{7#&PP}Vf*(A>?$<XD?1dB0eE;!7_MiifgXoKf
zv*Uj@ap%s>TzKoP$k?DE#h^^Qkr*@wzLmK)fT!kxIo{mTVxzvtOPP#M_N-mx^<({U
zOqNI(6yItBfRtaLTI$FusSn85=^9S$%%4m=7e7l>H!N}=&eC8p1Vh{;1B?{;dQ&&A
zS1*;XrC{Rjo@{ckA-b*)a}KEMQ4)2d3%`-p*CL!S@r)BC0#y*5Xc>CT31}y{66dt^
zjq|eOo{-qmn&OnNgk@Uu!r{Y)T?RMfg=aAo7@<_xj5p#f>Ko93Rx1v-o5?%f4%o_v
z)pINBt78#bw6a5+)eNwMLA(qM2**y4%@$K489WHg^PL0UB|9+LTyWNC@y&3rtSnQ(
ztz4aL9j}3hk|RZwQfy-{%sF9RR7>iY=qKt^%JA|rC81FIuBd)O+?w-{BBJ%>F&)Z(
zpZx7)MR9T9W*^LO6o|Xu-=!gf84_`<uVYBOwt-8$&T(h<Lgi9Cp{&eXqmI#&%xD05
zKdW~TF9WF9nn&xO)NJUt2@&5o=oJ3E$DNJ;k1%nZI#r>4pmzVc))c&G14RN!b-(&c
zjMjM>r$(>>TNE{FAIq|NZvdK2(6KxB&{zr7$wE{m_$`Mn(>PP;ODTZG`%V<Aj1c&&
zQ;$EoNciaO-8Y#~Y@=6~Cge)-;Ig&<R|^1wMFWg8LH3x$&r{#uz8&P);EFs{&~tkJ
zv4X*aU!8n>Zgi9CDHDp$E%}(d;@`(flym3+<ghX1+88FP{>0(4$s71lD3}R}XUZQu
zkR&YRFZGm&uTQOi<{F4nf^XG-NW(s-l=~MvYkQLx#aPjq=2oyB#*_qyZQ7!RGc7MG
zRnflocz?oDsU1@&Oya9JOemmyjOJ@Nu8IA38VAAc+lRTQcI8`%6AEVt6K6&C;K>A>
z3>!e*!EpsJ5GyAWN+fkysG2U7l0uK^W&3nK96fn*E8sg(>TrC#gjFRMcb)1fb~#Mi
zGgun=T1P{U$08u)?wjfwF^vw36q^(6kP4>FSDDYViW-HbSs)dn%G%tA2<-wa5Bl>O
zMP2)cIG7qbG4@G+P3r4Py7%|<=4H(LHJ}#2%E6-dPbP0{=xs_H+d$c1Sg`|%o(cN}
z|1vU49&b2E={Wa5kR%aqBS^--m(D9MO{cj6&8CD$%qEoR9h*1o>^ACR&igm}`ViJ;
z`lP+xcVpntp(_VCg0=PN*G~*Wfdhu#`^ufOTC~){HHD*b7=-MKt76Yqj~)N}o@;-@
z!e)Bz8jjDBB}+JZKz|@wCR|i8k~?$@r|DgoxiFNpXLayA4EsCEhHuK>t9<!1<8_=d
zq@f2kWRQe;#Eor6g7wMfC6SLI)oK6g!vQK7h|vj<FICA@5fW^PqJmWVyuP5vYGy|3
zpWV+~31KL+l7MxoQ$u5LR5WeO#pH>zA-F46qsrI{wd^)h@K@7IEj#ToF0Xl;i6N*H
zABSnMNj_Z~mD{>KL{+V@<a6Vht0zaE|2FIV;E&%jbMFxgWk82MPv&dH_cm(h54fe~
zW8gNsfaBr7WEMC(KR;itfKK1OVs0R|lc*v(jyjK3&I6}5Cwlw?iHsS%3IGW@L-yS%
zq1hVG+#kiaj6>6Tte!V!@vW{r&G{4<Ohz0%$DjF&ap|V3BI>25xY&DjG5xzZDe^Q<
z?fRw76&jW^jb|e4hr)cR(?~HNo@D;jy?d0QeWzV9;a@+tj+ve-Y^W%%NT`3r1&$dl
zL5UNb&mN%uhOuk*>C&_k$T|`8i$fxrQ{;RJz5J<U)Md7ps(!n-w`pura!SfohI{HF
zcl;{@*$iF?$%lGqd{EcE)kBSKLQluiyi!8<A(B4o(7~^9gZ{t<$Z6`I)jcDsfwFxd
zy2|$1h))OYMbi(yRukfn9#urW?WGgcPfxFj0^q<<k95dsGEZdGdPLzXGk>)w_fZdQ
zA)o+?G^P7TLoR5o@IVwV_ntc#EH9%b)}M2(B~5Fq4`#*)pTNe1MOTPaiEGFhcaC;a
zuKNFQ>s}P0l{{3ckmd<fq8`7C8tYtnc8ItL+o0b>c%f?Q#sq`RtDvxv{o?eNi<K^-
zsQ?~A&6|*OVy8=tj>Vc8c6NV$6V79mbM;87;<8A%uT5RDN7Y*#e;|{|nIjKu?~Bc+
zya!Rt3T&?Dobm6s*8F}0II^ryP7rv)#DO}ItE7re=ruSWfdOoeD7mVVMFqieXH=nT
zO>o<0%<b$B3CSY2dK&LaPye}iYYgqO?~x;meM}t!VmcrH*zG$LLc&sjewwo~04IxH
zspfY9Z9(ouq{Bdlc%o8f$N`Sh*nZBpTc&sI=!RdL-oAN52j@daY90LuY=P1x5NTWw
zjDd)rVgpN}8kW<vVe|xsG$d}bclt_Ekt*np8I>0UoQ<DGZOjJIV~HzFC7WY5ef@TO
z|F_b+&W{?pO=-CFYBgi2$jH!CH0M-}d2kLnGEw^3&kbPq;>|-WFj(Z0avuYrmp2zP
zD2&g`_<iA6`FKO&IM<#x=Q2sT3yBl6x#73iGVnr!IKDF81|a78sqjoj?JeqVNgJd4
z969<m<^1^$*EKuvs}8ME#SB1;#44jyr*=JR|Ki09Np<*9M;|+;1QIFbvKX3CRZVqp
z*g@S-CqaX`_x1_(90PKz?9TmfUC~%h3}I2^U$ifx0A$d@H{%C#lVJpF!;-n}wqD`b
z8EvR@!_`P89XJjsJB9;$=3+#%|NTo>s(z-^dyE)yU{~G+>J%eUM8mm+2W7PbGBu-p
zM+AC#je3CE+~;FRbLO2rXX&I}yr{;lNN}z$V0^%jbO31ft0Ea$&THoG>hUs8+iiIP
z<<=jF5}4!Eu7lJXoa9Lim6qiulvmLrn87xt|NAY-)%o0))nAaOETs2ss$hg`HCT_9
zuj(p{E(u(wWa4qK04Ah7D<+l4(k~BtK=B>I<!`IdQ~?QkPhx<p`>n8ZiHV85u!Zlz
z&t$V1Ll%jNCY3GpYNm=xty*bQxb{@=qiI3N^>P{0je=$lch=L<*$qxU=)jS*8v7fz
zV~#Mc*~o+wHVJ?d@T!NPU>rv+4zkv$Q3oMXLj;Yblsy}MHqG*6qb+z_AGdnIYWovF
z25smPKOy-`i2Z}%LhSleiq)(+#4BkF5U`3C@zAZSsodPQo}TqXHir%E4Xv-xgB)s=
zu}Jo?m6UuAtop9TEnNs@8^@IrB;>aKawwKHP8jJZ_RNMq0o!o@y3;I=`Gt<d*BSKf
z+jGvjWj*OJ<@rK0tbXyNnYsT(2%QQ{vWcSpys-KYmp*#@)_4>NB^|={M=GK`8mc^q
za6kAnSYt;&B#Mmj^`iP;2%wvd3WdDm9_0D^R}`hl?K^ka3ay*{;K8NR+V!6+%a}9;
zVRLM}MdX$YJB2_-sgZ~pZxJY#zuShi%LLSTd8kYn-KPL&0KAtxR5)O~WR06D)O`M|
zg)!W7;(8nvRZ|5yOp{n&otK|4P;*m-*N-j@b!U$ZFG~w$#6qlcpOdy){T>Y&_Mqa&
z(!xIoSi?CSBtJ3XxbbTpvowCh1NparzO^Y!v+*`UeUSR*<5OS}0ZqjY4k&Uv3W(hV
zpFKRk_5;gm@f&9z$o0$HIr6|?7Dg4Gt+{YACWbP~SG7fp7J~B2BZUI<_w!p)JN!8;
z^Bo$2Pf}y+7?`^|g4#4Hdb)bN>QBCknT<_wA7{ABA>TXQbY)yYaO{PoLxIL%zy@IK
zPs$iaJy3UO!fwC+MT+%+!4{IQHyoTceN(3IBnVOr?X&<|Ipm2}KVq_;QsmMzd#7)1
z0A|p9jTFUf>{u_vLctKn36*|vlu21m$=Bhs_ivnwXgfG0L=)x928(MOImFsbUAY)H
zx8snuQFu<tj&MT7rv7*P_+R5}jvFp}^DVHwU%+l$x`LTka9^H|6tzvOR;^B{M=GZX
z7N_tW(tTv7Cvf9H@YM^K9e)p!=D%ZyWo(CG<$({P67e~eHx-BJeqNdEuf*@;bU}**
zNF2ZfzHw)D=W{a=MY5-1ncLXv$*G}R3l{C60uF|h0N+Mq_jB0?-pu$~w-I_hV^U%#
z*k}ki%bRsFZr;;ZmB#(hM?<;n$P5NB7<}kfFGX^s{E(oDh^!n3-6d>Hg3;Rl>(*Qx
zE+7<s$9QHmJy6h_lR?M}aJb;+mE83`0(%RJ+ll1IV9X|&hjlVmE2B~f7Py$K(?3j{
z`kxn$Y0x60_~tl)eRWw?|H&n5QA($LGn=f#EKd@rv?WWI3RYV2=1qA;Grzm&V|$<?
z(uPUxNhr`_j!}LJpQN_<QdB&BYJz&os%5KIlOUiw8+-+7?ajB&E-Km$pdJLE{fD*T
z=l2L>1IZ=y1X<uZSMEA5V|eX1p*Whw6h!AHwQ8rXKIr-!2Zx8J+`*>uXwVh;uH3RX
z+=yp9aIf7sc<o3l#hzUBof+rxTvg@0+Rm6^j>g-BL52sRdwC7K0#Q(fKmiCt_446E
zebti$TV-WsEsW;%D%~ejviJuE_L8RvGXsLOhocgVkL{ucgLC4WX$>Ql>Ct_EOkMo(
z;{iaLd%!?oNyS=QO+jnSn5ehT4<0<&Lq)oJ<HLsIP%(s2iQ{++hbr^{-pjsn#Y+U+
zo2-8Z9*ykKKK^ZP`hX=xJw9P}T(j2Nrv8^&drq|(lSPaJM<Ib4ps~FVfT8q15D$xu
z1Fqj^_C_L)7?GuAIgPa;3BXy7B@xW|@(+dM0AzfRw^c;9)0??_tWR_316NwhJdm>R
zper3>KK(MV_^~}^y5qf)j~!B6U2GlJvN!;zm7T7YjQ=>}AtI$Y-WO>@PMsc(YcD+r
zsATq@8q8lr6I}tEAO_S^ULLle0<(*<NL*DB-sP`}98XvnYh`uvei>D|$+&T`1<vPF
z4-#@2?0Yb>pTZhE$G`zy%g(*e<3{&KSbeLI@#U!hFcWM{Oo$qF>-`CJbEPPHOi+hb
z=n5<+Tp`f8^D(JqKdm{$x#>k`gT>d=*CV}6`1kl^+py?Dc2|R@9S_%YbDdeZG;YqE
zOSeDn`3LMbGTx<rr>Zy7sHc>&Vh@RRbg$v%`H;!fB{C}m1nGmq+W+-LhYs!9HRI(0
z#u$akz6#)sYXn$#)FE}>zdO-OBZJSyZqf+1)r%|5Y<5naI&}*<M+W|7sEx)J)Cmbq
zvoJ%))}Tuyy6AJ~+GDmQU^sOcM{hUKDDjODjFelkzP?^ZU*C)}+~>u`MkaK0WGFNr
z=Jbn)3EEUErdC!vSHA;cYD`hdlRWvTsy*cxzvr(Z2MTtM>89|x?n~zHOB>cxpFS8I
z1ddhJ@C{hD^nWi3Cw4i$UPFI8Mk!-N-L)uprM@22#k*-(3dU(1OM6RB7q@dDwJU4X
z6~tv<1R`8hh-vX(66i^aMo@;;E<yaXtO5}4@EY=!yNhK&g*MRw8Qe2W3&flN(n-wG
z6_~5mF8jUl?!X~K##2by<({yc1yb9=kW8#h6-3{#l?ge-ATq8AGS!@@Ix^xwjIS4Y
z9>6amXl#uM*;FtNDob%*mX7O>l-nbQDUgn%Hw<H~+7?3OK#d7nQeorbB>gl)pHE-B
z$XTNmd{!Wq%?;i7(5|I#5kX2F+U-b%2GJKtBO1Jz#B7;c?}Y2G9Iav_9gBrbrnIr4
zpe3s>pqy~%QjB{5XEGOXX2b@squ4qZUR#f&8Ez}m3Sm*QWpVA)lS7H(2%DZ!okZ?g
ztDe&e7H=DREw0qxV~3e5T>uzuLVCmosd2Flo&md{uEn-y<bhZ$mH3cXWfp<Sw-nE&
z{>(;UAFl|XMrEi1;6cIbT04v`uBfzh`Pacj_Z{kfYNn@QN~9k}XLI`e`Ko`n8J41;
zLF*;A267jK+;T$2MQR>s`EexL*E$M<@{?~xbttMEd0;4*kfb}&&U2Jqj5W=bc6`se
zMg0Zi{*0HM!}y?^#160_F0LpsnIiFdPZpN>SL-WBC?~|0ilZ{l+<fb_>SM=`EAt_-
z|J>kymu~}R&PLMnc?}z(PDm2i?A7Pg+GtGXxr?ihD8C7(R*x6XU>J!YKKe-IL6XBb
z0_5VMd(V&Ol89BfD5?AO`Qs<WT1^7cgI7Dx$h@O6v||?MKN%s@sSf9C)D26XESbsv
z-*-DV{)~%`Zp2aL<GOELhQ0y-c&pyl#`JsGh+U=`1sU?^gpK3(0P4-c?3Mr{gXR6S
zkLWx*a^l1egfzt0iZkR>*$E|4QHC~ohyykJtH931@Ws?`;-SFGBM%=s$diH&%b`Yl
z_Vnpxj^kcL&m#FnMgq38vUCVE2kl$?^8H&x00?wSZy+P6#qJsR2wcywl~~g<Ky9`N
z))D12QLs}nYb0Jj;?SI#nK|*{+M=1nVByG^F7+599=X-9iO+V8`OSb@<E&e^TFaaU
zJ>cn$Kh`BwPSvCk|BHa7pg=xHRU_U7xDyIP(jTBvj42?<Qn!T0beukS?oKpBqL70x
zy{*r#?_6%%v$t>ai}$!AU}a@@4u9x+%J8PL%#U_{K2eo&YXRNm@@~B_{Fu=!#?oP=
zBg6rpPuvT+AT=8|tq?^LW>Gy6!do9S`&fPU;>FH<AZ8m}jBhL!+dJVLm?V=CQ~p))
z1d?tY{PrrovR0P@Y&DtsY)u@!e(RRtMr2$G%di-r@pAS7!6d{&3@;vm;s}=!4NhIh
z{__=tK|r-!31PLHkx8_+VhhgyI)BM^tur;l^*oG_=E#ACEf5v8{Qi`b;C=hbdL;4}
zK&GP;5}M<%vZLFm&Ws^M21Vi~{LFsz@k(j`DcDc{`)vhUg&`iN_(35^Ky!BjfICs7
zi(455O-GA-4OAx*4xXsoVt{KGmy`)9bpnq$F};QtdF9EI?y#6I>&-V%a0zPx7bbq%
z9>yKa-F=WNpf3o3?Nzy1U`+?gxvHA&rE{R*8r|E2FPj1b17-BX+GYt~K`cBs{q*34
zN>W2?T=mb20JUaZ9r@72zJ7Uyg}IEWin)u7WO5&>-Xur%02bKJc3pVwIq!Z>8BFJ<
z1UtmDyFygJCaycU*dRn4OqiTK=K7PP%M8yhtQe#9RZGFA03?7@dZ{&wVOmb~n&iV*
z1%B!|O=8w>J?Rs`um?n0nPJh!Uth}Vo^9_gZd%N9ZcB7l@u7V(nKa42YQ2vEUQpak
z0dAp_uN9{q4FjfL0H^fF;)Cuzcy4d+iZReqz_S9!P=`NvxNHS?$PMqDJ`?zpKg~Fj
zFWFL}6`;2%%ngHUQFGm5bprlH5sl78rga8tGy|X!hKQD_@TJ@_Stx>y)|&7=kqwI&
zMx-`!{`&4d6AUYA&-hTM8mxP;IL7DIlrg`2W#pQMKn5A=jEA0=ZEbY>mjl}A$+Rbp
zoN{*N<Q2yaLl-b*9L7zQ^d&q5#08-+8OuZA)(AG)(5Xz+U*Fq$yLyhRgwz{1D%7p-
ze%w_yCJbT_Eh+%gs&mIaK9?(j)=E5{kf}yGP33=BR~25PF0bINh|`2>w{BwoEQbI@
zzhKeHQ>VsLcBN>H!I@fo>23`n70U$Uwr$PPZcz=g2dB%eLVlrS9{1U`U)Pi*7@uQt
zUym_kGV`in_fC7%I5F)XzU!FBTMnMol&I|s_top_>B+n;|Ev<=NEJI^#<L{UV#Hnj
zWqfBa1UYCp>|Y`G884jH$l}81506AdO%c^5ys?b}Pxs{{ucJurK&}J0N~v#tG2p=d
zhwd`LN{uQk20txR9w0{BxzBVYX@~a2m<3ZzK!oKJMO9=D60!L>sBj{U#)|j?c4AYs
zHbL@FtbD(Q5hZaO!_dtXohCRhlK(rj>VZ<W3>k9HYG^eZ&6I@lL8QRf@eJR+9(l^}
zg6F<-e^nK5Pwhvp9B(uIfm9Gu!NN(qZFG=K&3-v{Q`j*kFp46Z|9ET)Sqsn9AKOvR
zAVvgR!bhwZLwP?em=3jnF;!!-gk=6;VYeg%#9T!fSQS}(0$OQ`5L)J}#ER1MQ&akF
z*V8+xjikCH?SkJS(TFAcNFcv3pLri96TNw%vBMQ*3|tW7Df<rnrq374e6W|=Wv$1G
zpA`U{Ge8CJf5qpNi$+N5Ic-ameU`x7I|f$4!EA@!79BGUWz~c9hZJ5i%of8sPjO|y
z!`fd&6?%Ub;>Z<4Fu|D33<<g%8NuZLK(@ndco8W1y|`U6DB$tU<+!u1zW#Idjd$0V
zY@qn|aVlzPKaHMv90F~EEJI#iiHWX0x%hozK=R8xjjt=NEWFi9j{H5EC9II8%NT|R
zpQSU!(W30&UPi8nN2WMXMrnteA0iEitOMJIVdha^a*n57*b`GH!-5JP7tI*GG=Met
z=Hfl23(zq%+)hi5NO23Rg!-3XSt<4t?DJ{eee@2op9u4bvCqG8Lzy!rLiLECEUX;2
zqUwNGqvfID<DDJOE2E-zS2j)JH#3EVOhA|gVJY~;uhPr|mTm{5i;0W#eciF71G+p>
zK66$7)ZDyYjWezTP<&%qAd?#6#blY=MwhpPA(;lk7y$1^*h6L{4J*10sNe*REC@bS
z^n;i0DSV~MMhX%=@(4-78zC9K0kx%C9#-b&&3GK}?g<R0=QN?xXv)tCLQIYQBCn1a
zkMQBEdjqr|PDr@6XLwT^nm}-$WF*-cH-|FZc4F?O_M%bwyNzP0F|R3{<#J+L17)K8
zt93i=dnk+8#3@V<E-9P7Za@%1uP!#KqTr|GlV*X_Ea@A~cdwBn)2|GXbdE}j(;_vP
z1T+AAGx?ur{{A_yX+HQF?FgOwRRRF+8%RQgucrzgc>obi7gl7NlJB+~zOrYt3Jt}x
zmoJ-xh@w1*&RLGUaVM4dOar6Bq}I|+<Z!T|Cv-}Ndi+8nA)fU}$rveDV!TYE0zH_)
zx{S8HWsHnfKgCAnmeivI7u~!}^CIv!pcTyPRZap#*XfiLAAnoX?J1XPra4T@oZ`^%
zBvVC~LTD?BdAE6b1_qA~yC(SfjPt3m0K{Mo>7KVwHiDqiF<ylVV+F!a47Qs$WM+)(
zt1yx|4~hqwo+U0}N#`dcyBvo|%^8Gvy1a4V?n#dt^$l2hUx-}%eh?o3W+VBgh64la
zVQBalA-xXSGW=R={?e(!vTo#l>4v49TL7m0d0>E=hZvI~mLT~xefjVbQ$o<Jo&y+%
z#^vzBmHIR~TLeUK0m5aFD<DXNP+T}6qn3Gls9V!QuW2P6L<Wa&yx8dIx;L-pj%#q`
z^9l<gl@8Oq{WT`&aDf-FD?+>^Aw|5w?2I&yjT2i6v|<?PJ~;IrzucP2U1MZI+Vs9r
z8J23i#kw(HZ;jAB{<fj~FAWtdbCdmtb#lDDHBLu&yfS~>vShQIQ%~ma>^xRK`Pvfi
z{|?+cy<WY)ZVo78-y!O4ruXnZeCOG(tKDlY-WgwQmR@L|vZ(oo$P`1Dmk(Eey&r{W
zlqRB2YNTNT3M@&~2II`)Y&CB^oZeVQmw^YC+&>d<S-!qj|9G$es|8rQHXdJl!DYqq
zZNTf;k)k)``w>hhM|>WN>F6ewXF$lzSkUXHUKcqz0FeB$JIupGzwq0TBSC@snVJq(
zMfb~pWgTu*R#ZqXrICC|c`CYmQXNBk)NY1*P2zy2sJpRMVB^bfm}@5hK%?L{gv32r
znvU9F23NDQ;~d^uGanZZbUJ9o!&!^4gRb1QhUWg}wGl54(yZ3Pg^E_!#N={|{2K6<
zzn;dnjByF>@rFvDZ&X83&Zymhk5gu1=N*EmPv(1>X>M$S2EXHob^0Xbg&49n)(dSd
zN+hPjhm9DaV(=mm<GgKgO*c|@@gt&(m-%!s#tQZ=LsKGEofFY1-dwjEe%;Ipj$I|P
zMjEo+Bc~9NXo@}d{`{NM4#fd(30ga`TbGU<8R^p6lX(_r8FqPFvfhx!jv#CDX_%3b
zO~_1p+e63$=Q&jmV!g2J{8Y2}^7%8pz(O9#vhq}aS<At6L15tIG~La5nwp<_Q*pmw
zgl+*Z%hq)uO$psc4Nlv#W)n+inO_s83ua>JuZep|1Y&(ag)@cBx;3nq=BIg#SM=4@
zmAOi?`nV;-FDEv&nH?Iw-LAO}b{R0;`67p9CW#Psl|u|lgmjZNJJZsP@&o*)w@33t
zrd6}wcD)Z%gKY_6xpZwAZ%T?9<b)8xl$4dlj^8xD?>9zN#D9-}nC4LvGs`G-2fBd8
ze0m05s#El`1}`rU<v3y+F}-K27znEgwB&dXTR5wZVnVcNfSH-DcFfpRH8;Fupu7Jr
zIT~zPZZ~6wtd?N6&acD)e%<f_$A@dcB}M9G5t%cA643niDpTBbgxRCVYuhSD^F>%$
zL2QFIVrnOKgGn<37-j?lK<OxBA~5fT6vA5pz5v6}pfov*0-sWjNYoL~TFrX$4ZHos
zsNR1CTgVhCi9}{Ky!WZengkfXg|x&2-d1vS7({jlv5xp+a~nC3Gt51uk1s5E81<Rc
ziWR?aRq`J^FB;~rnr>}<tHVB>->Q^Niy7ei`LnhV3#ge18}mY#fWa*G2GF6SZlf7<
z=N{zaroe&Avtihsjjk*kwqMfM_UgljkrI)piXfea^Z$V^#X_ahT+C-C9T(d0sh?#T
zVXyn?Yq*&FBD))k-+_-Uf=WwDLYFz5Id|?Qp>=OZ6PL8$zN1FXjj5ux53&8Ct#p_}
zE8`zQWu>L&$UJ3D2P>1v8sehC9=;_@CgRXG`uL8AOhrXNqSH;d5Mx=u5yt)<l)oKi
zw|r2Vx!H}L9O-xrGLbBAuo*#9Byv(lZB1EY$R*&^0L3#$-$(oG8A5_D<VFf5J1}xi
z;o9I;RwwPxE-6p#3%O-5w7Crf?gGCT6zsKl^P7rV$Vh;58D7}8Py9f@-zA9rF`Jk*
zYvR~6Kfmjjj?Vkfn2nEoCvY|W)ULt1Oe|Y%9Ln<~?N@yKXxQ0o%w^ecwS9XF{+^7&
zlebh1UMI?!EMklS?iJaED+KN#fH2iQebHW*cm@%bfk{LZ08y=CP!;$$ACyjNcX`Lz
zW@gVDdUZC_YeXB(>Whg9D|ds_E#_q6o}5|gJN>?t7Jy)4Xya0z#9wBvy%MZ4mHlXz
zKiYeapo%@h%a<vl)TN~sONMJ|M)?YQUs6Bh_nd@U-YGb=TKDdSl=sNkWJnqTqq@2}
zMcO{Cp=847*w}IG9@BDpJNd)pI}>3D=7k;6)BKbJ#7LD>yDB*S0^J-NTdlbKE_XIT
z9Eq<uNWc%>YwM!KLW~YxKE|5YcVy8d)4GrUc}H(OI=q{Gd*0=4@~e<Ugp8i4k%eq~
z_oI11b(Mqf>65zOTN*WaRhHD9BgN3C%HgROL-j{azZ-IbYZkKbHjM#8M|o6Qvym3k
zPiJ4h?nf%aP2P+n4L_=8f986Jkp260J59@2(cGYK3&%5Uj%npQzIQL2vee>cl(zH4
z+1j)J8~t_Te<L^g-v#2&OV-wYLuZ|Q`t)H~<d7<0BbtuMYfmJCUsKdmIr0`#7F=zP
z@&8RKxK74vbVSz&K(yC>GeV9icEztp66P!d3l~4eF#1yeEvDSXod$<AC>j-DCK%~S
z)jO9)-Jq4`wKan@iHSCidsvLU9&oj8YD*;yGzc!WaIx#>t<Km*g^fOGILZ(P-Z9V&
z2giit0OXe?4$Q$=>#x+)wA~ik^cH~NMz?{<ey1t1sF<&bQ3X|VKIM1zmmTNX^_WeP
z+8SoFqA#}|r~xE8lqZ>jp(uyIH|$HPxWB?EDz$9+^JuG!A7i;ELgoX9Dc6qxD$>@}
zG+olk_6q5qI7l(2w=gErZ=z?ys#9hgT?pmZH!OGpP>0%wY0#fD!WH>5(xxKua4BC2
zE)4Ovh|@yAjx3T5SnuE0eEL+uBQ?!$(<WH=<K*s4?)GGEDAa3^vGIP~j&?(Sam=V0
zd-v+)L)oZ+|BYu&#ny#24PUmdMJ|`;Jlo(zpx=hRK&(f&_{<k69`7}D=suc*0Tg<M
zhwgcFkRE_1)^+rTS-s!et&xqBoJ1Br;20kP_3`#(+aD-IySu3FWmY47sKo(Jmw1ry
z2m^QR+GY7&M~{tzX7tk_lmEB|WCEVkZy+5xZ~Ecorh_~XQ10tIZQn54-X*8z9$*GU
z6pz$@BCuu5v1!w$viXe9ul=GQWa(>MIdR%ovp;uz4n7op_`>wrww2lB4iT$A-FrJj
z%j+@PB2;d99g9fXy_**Sk`U7-M~rqH>eE|GtD0UquZGy9W`)*77J-B$A3rf@6OLX(
zPGG+Tgan6njmda{mR>W2E}n8ZIp&tH+qP-LFn4!UkFOq_|2QGDH=}+;ofH5+0Skb^
z(b~y87dPj|vYU?W34eEzohN{@_wH<Feq$7ZPboBBEV?>-(nTB`%O`X(>ps#$76vFO
zD)zt)k_l4I4L_p-?S+<b(tsnxMkPin3<mz<;;hsp=rwm*`YN}QU8HQn;ADS1dFJzA
zuCN8LfedPbo&Jb>+a%bq5AT%JAbmdjsXphthguGfh{!`cL(D&>t{!H9zFml&c6XnC
zH^#YMwzyFD1~j*6)26S)*I}rTMHEc#%1=+C5=~*f99-AD*OMbr3HkEX7)!K!xsfe>
z-%!2op{k5Mc5L>`UxDfV*tqbBVXB`6=5P1+o30LG@FZgN{-~%aPEHkF0zYzqWY&?S
zk>{RtK#_qE8KfLD#_>)V)vZ(t%)H%+Mfk@cOE#k0xpN;W?>nq%Ys4HT(*mKW!K32^
zRYR?M1DJ~t%k5!2S8NKQIwC&XbUKRXG|(vtQf?54GNtMGW6pH4uZyCuws;V-Z{Lxl
zM<>4N?Bne%j#ZbpG(rqw@#g(LZN%eZt4MuVf3WQsM4tdu2Pl*6JbacgycrP@0o<T$
z5Py^GxNq6i2>R}Z-#-jd20drSz5<{~icYFk<OE{uPV$QZIe>uiPq;8Z3L=!Qgky8c
zWF{*@<F;@>Cth<0a3d?)Ce0g#d-e`;7fYn1bVPb}Y|8j5@Pz-Zut*dZdyi%Ui*nz?
z(hFy@cms+95*AP*no?HcGDYy0FM4LHlBm9<`6w>lLq|}<Q2Jzxs|@vrF<xmMIZ(At
zUuRC3NSNzsyGDB)+`ng!tn#kG0EQ|IP`rr4OrVkiUaxdf9!-)kK%Dm8{hs=Vx|W|?
z9ti9vMjAXs)BNCNe#k5Stum4tUtizyOqwox&~#@Umt_d-KJdo;k^}hf+kZpS(uU*b
zHlWy0YI5zUkC=RQnB{-{fgrwug42wMKPIOubFI&r>kUV!?s1T50`hUY$M??2SwXU<
zv4mB2)4>B5g=825?VGMzHGrgH`*#v7KTNf%nwl+TF=Yk%Yi~+KySj!M)TapTP=To1
z2l!2lkNsKb7nr_}|Ff2uLS@#kHbX#X6gr}}1;-Bd+-z#YY#2hMrgPSG8?aE3*eB(x
z6q>57G~-`WB!iVL#@F#h)-aTdgXp%SreFO1WzIkUTzr0kE>rwB88y!K1xtr|4u}gK
z6>9DA&nW-Y=k5^a=53E%?~sBWEU$9Rjdy)qL3&UXoxiDO#TbcfB9STNg?Bc&WTAN?
z9tYyASp@xu6nt`o8Rc*%L~$)11e<%m5}b7H+8p9GW^gl>R62m;z<OT3dp8VHC-d7q
z=2B0)<hN(md=j;F{>13dL?bNr!Wk@3F)(*qdiTU6>X+BDUI-S_A>AVwSwh>cU2pPS
zgy)_-IgmhbhqYRH{}BQ&ztQWbU6}-yq1L5~o~IysfIM65j?F|JC2JZ{rTaHZ1<0_S
z;$fh#uSI1A8MSwSSJ*>pYVGDzsV>l{_a8DO0eL5@=sIxn<xme85JMkrTiRP5sQ7Nl
z2r!s3T6CE`;Wfm8MncW(Cv~eBOf!3)C^CNO1wTGK8YNb=nPd1<FHj<ZcNTM=d7S1n
zvybmBn?AdaVNWa_U*avXfbvLktY;to-JEOJ5*~Im!!L_j8eJDvKC{S=)W*F+{wsQL
zngt@k847EV8_4`$^MA0NQdaba9qGZ5?mlmdYP-H;s8mwmDwr8!t50hV<_o9R7c>!{
zm>~7R60qTE<fAgiMvO9leo~Py!$+kjoBQxWUj=&O`Q!!E-IJELGN)ALgX7Gag`_U-
z&Z60Oj@tABAY!9|{nnv=joEt;iiS1X#m{fLv6;`3W_>g@8v~!P(oerOgD5Y`S1dnQ
z#}Dz7Qjr31_F;Wj@Kw~di~pzM=xPMU2Vl(y%Ow*@f&60sx4owd3ktOR_I-Ww<!yK#
zP+z4jRO(;@ak!gJPn_9``$TX}bFXX;K^fn>Fmd`Z7E9P1)3Oz<e#@3<D)_p_-uqg1
z==%hmBpC<nZGUy|cj0~=7lVFn45DSr-tQN~rHOz3s8Qz5r4v9nvT3B3JjwV^YtnR1
z9F+@N?&4j#MuzX3-bN_^Yb)uRNvc!TF3#xSrr^j)f%)TUnt0Y=9k%Y{<DKWvufMMt
zN_EkQlG}Vqrx$7*Hc{5_K(^R5uaHyQt(!G<i(nfdV|+rvbs=Y|5D+{}>SlM$*8FJ-
z743Pg4SAIm@Y7huaJ=gV5^pD9FhON#N!~=YUHQN)G&1rg0nB1&6QUB1sUEKW-$PoN
zI_hy3UAS#9J>F!LlogMRfx~=Ik`S9+2yJ`sZs|?nfUuSOMh9=(Wi=8Z8C^qAiPBSq
z?EEWNy_>1<&Kj0pdnhF~ir9r1`gNbHJIBmSvHbkXLdrJZutw?S6JfTkxZ`<TT8MzB
za7*H4!8_s13O~f1$Xz_cnDK`yDnGbX98|P?$O~=i4Jkl>3a`N{Hg|LD4|>0V;D$&{
z(IC;3ZXz3U2Riom@v1qP>2*RsEKiSWR-D1B&-y0qr4X?>Vy%IZxK`=92WMS#i5PL^
zi)LfH=FPXJbu!p<<La4fwBAHF6+zza^ppyO4v$hP?EaQz08L^eBue)M3v7CC3>(b0
zJy|X7{o#~=Q7kbI)tc$AxC<T#%=kGsAC2vC(@-t-Hhp*TVK=P#{_5?bZM@=;;NV7L
z3dYVB{9tTj$G4)wRZiC(MMZg?EQ3!&NY}rTb~J~Ekx@)~bbP2EFV$+-XM2V<L00Ch
z0fyA<mFfDf(MJ)}B2pVTyuAz!3o${V6miKRh6>KdnqdxS&9`q=G?fZcGcWRfMYRnz
z6GP~bnmEhwGw*aKrA7pQ-g(iYuU9J3UB9NclL>rKt#$*352oOxD<6ozN_6~mMY%g?
z&SWtGamL1oVjmJ2(Gd7IhGF4o;`b2m=rE<OqqYt?K$4ZES9BXsQ-WL3vCCLYhYo$x
z_G)>Dh4*8CX)8ZMjHXta*zEv~#QXBz)R5q!LZ#8Nfi)TKZEPQ7&O{hkfy8L)4B9$K
zMOzl6@DE1kE7S-_zKya4QuBWsL2lzNcw|u|Kz0IwMY{y}h0dYkyU(;EFYD(~*UR*l
zzrSTR7=f6|rcnL{pgyg%EOR<E($kwO2%Wf?x#sSJN1s?Ga##^^5uk;W07>;rZ_8_t
zyiZ1*f2@)goqkeHRn-LROsYa~R+-^sde@Ss<fvWJ;||}P(afSYq7-d+@w>O*MDv)q
z?DQq7?GDkPh&Y8$&Dj2Pu-uicQdR5wlbm~@MaMoRX<bS!$e0`Y<ADSBaA*U|9yAso
z008YQh_SegLqwkuNZvg-EQsH1mtWGC^g`+|&EKuegN6p7Aor(<Em{RI*DB`fG4Iu|
z_H-XJ7yVlMzPugPoU|jfNjFYBIrAL;>GPY?$x~Y~LwXsRA!j8JWG-74Kc6|{gh+zq
zXD^|8Z%A43ghvk_T5S9{H~uZZW)fB%q48yR?!=IIg(N(AawmT{?(<9p0u(O-j-WvZ
z<>JD}Og-KZvheu%y(uiKA2(%6l4<7<v&RL@=KTHW;@PJvBF)5gY8UFm>(5ud1ET*4
znE;_XG5zT8mUKw$C-2H4MRBC2Dr(PRBY%&nv;SM$4+v@>WhZo$3=WSueqz37Z)BBF
zghgjuCik`sufCns1+fOA>*s(R05+!ElwGdE_0fn6;$S-Y*lD2TJ3M3CF;_$4Zj<S7
z^-05H2p^sKAZ76u2?tP&@9;}{(xp?U8H!ieQV3EKGb7lxTep6mkr=*n`$3kevz=D1
zECc{R{glI1TAGkgKZ0oCDq&gsd`K0nO=x=A>sPO)W^UTZ0e{79eZF`(WE$|&g=f|Q
zSnUWXOgy^=<B5=kf~z0@kOdZ37>(3cDW$AV67Nj02ZXI*Vy8cXLYjido<9i{=*FFq
zn@Rh`9SdQoiIdLc+Jd6PW4oWd9Y26ToGrGNU%xKGM5yG%>}g9T(F^7P9q?djqbD-0
zb|bD3EhX54qLNZiKs%xVFol47#IR^;^{&I*Ox`%#Fn$eEht)>A4H@Iip1V?pcu|x4
zHMjAi1{N7T>Hr_6%voCWPTBoG$9bf!%S5=%n;Vku^teb-Dm^~BN(z0|p=Xt$5L>tH
zZHYQ*C%w$1|9(+>#nMrs{-coC^Usen*8o5$<dh7?>4r8<dz9{(VtT6~&@a?3yHmZg
zHCz&p+A!reAFC54!eI5zq_Dj!Of;DEkTA*eAA4nTPBb~6n8gZ&zNuZ?9OfKzw!)|i
z?$F{=yNrJQg&e#mctD%rBp<0%^7BRNvod@F>}wWaxF=GMYTYZ-iRcIcLGF*uIo}UI
zVlhYHKi~ueewJ)TFw^wAzN$OuueQIPf|P)i*)-9i7TpK;?{9)|guIEoFZ0bRy>|XI
zd^n>;uS%|QL03ybC_qR=Y9>pdQ2S(CwRSWiR|xsdC^ypxT^Q)yRenr=XVcrHSQ+Dm
zYXkB=p}q)wp*t#RIJTd0A(q^7reK<*yuM^=t;#0i;=^N`Tu}?u)l2HLGsBt)iM~l%
zXoSO)j=vz)Utm`>?UuqkgXbLC!;l^5U8wNLauy#TLypc!Y!8NFiiGcF)t*C#<mqF8
zK%NW$4r;5RVTEp=YQ5y-oP976pbXgpzCFBPg!;iYZT#l4gvgMnxp_Y#koHjNkeVx=
zKi8V%KXl;0wnH@)w-8daW~6G(SP!%-a%0gZFD*GbrF=e*+hE?+faw<8RfO(wga)jy
zyy;S9eq3r&PO)eqIIqE7GpS^y*Q94g-IxoggA5ATy4lIm)4MV3BCf{E9;Ziu$f+1i
zFnfLymmTNj%L}N;7cNr8GV(b9EHhkUu1!`HCrNz3X%A&J7Zs1Jb_S@VeaT;VFrL5O
z5f2lR;g@sfW@e9fLT4}RXCJqW6e0ugL^eMz_$p$vdwOqewoOtMFJ=P9baLN;Jg#ue
zrztBIp{`;HZTg*hP2J8i&rDz>1Ko)G#UHqx`Zp8Drn+%sQ%U;B%<&ZRMG;uEDnrDc
zfFr=3iMwkXsI%MM?qTmWY4YS=ID%1g?fp9w71=12_WCkI;c_nj+zHv^NcKq}`I=4^
zBMMo@xax%kLJ}Py_=d_OQJb6qRBs*_`hTc;6R@85?%f~TkU5z%lvGp-nYLkPN|T5b
zyQq|+GHnT=!4!q0RK_F~6$zQ8NFifIY*P_Qh*Bt}{;y>}=bY>RT-P~2+xY!{KJWKh
z_qx};?iK8S#o{jekDov5^|dAz(WX|hlVX$!7xG@{8?){0c$LC}JFS6f5nG!v-qq8b
zdQX`;Rg>ZjTCx0nZeMb+WugWBV=M+HLZ|0Gc|s;PcIusvjgWUTm6?-T!a7mD!@6D@
zSiNoQRuL%xXu|^&G%+@Yc>0R>>ehF~12b>m-im!9dETGufo!5OV76|*em^F)lm!_S
zQ<i7lts!f)C++<N!a9vNJzt{hhbPGm*~uzo2lz43VshDTjf?&yZR`8@r@D4`Xp3MW
z^sO15fFshPC~LIV+kfrez-%UmfOp1FItFr|ER%C{a>mJr??%7I5a$7!>FDSA*_~r%
zAwOVF0FhsI<&%egm6esGmd8C34rv&f)3N6>1QVdyc11OS3AXf5(%zSR<p~l0thL*o
zd0PSMTQ}>?F*>uBWDOdLER7MQ`smoK_Ppzau&;Rb?Aqhm7)TH2HDHCguWx;eu78hx
z*UjtOkMhAieo@S+8`W`a=&8*4u&}rn(k%h%NU)z`z$agySHKSJO~RYH<{WCj?-5od
z4}_^RITc{?6pVZgxY=0R$f!nN10CQu4}uG0qNCTNPNv~k40}z<HpQvc;=I_vs~_$R
zgrXG_W908erKMVw-(j;U0To)c3bkE}rcNEw4OIchSiJX1KB4!r`K~u|b1RabEJLIY
znf|xCZT&VNy%0JJ9q80dp~IQkbb4cPg8>o>-;TZdkTq4V%kJB4MHhOCb4#dYs;-mm
zj=Pe_xtTN)#e16mwC<VM<b!a$qBTQ#-~VCyHO?BwkONY_y98oP$_0d^Ov>nC$Q(($
zLweeUTvJ2C+W{#<JMST?{SkI?{G<OGA8fpSX6B~2V%ajSuG{YN=g{iz6(KpLF5%oi
zLcIyK*G8}gOqq1q%z;#6tM~EhS}qy$(~2Rt>j?RffyMEzp}4f~Xb*GV_J6bhy9X{H
zL7!RlG?el#aI{IfQo(KmXtasI4{n;k54^B&!=$W>Gs{U|(wk!!hd-Kd9AqRg5`Jzh
z$BlgZ))|;!^}&E2bN&7SR`!O`*<A5@aa<X39NU%9F~bK9s($;{DWrYM@{*}k80r7I
zR>q0F1H6GOrX&SH*Ydq;u+?+PtAAnym(2>KV(M%$s^Q!Gn0krAi0Jsk#s}}Guk5Fi
zP{{*m)-XG~IrC65*1}U8>|0m;z+G0oNkn1L4`E_|7yr}JIFOoz5zgqifI1b#H8l4g
zqL5$JoBVR0aUTp8`r<DIx6PC`b}kzH2csNp10F}RfmwP3%Sb!sN@asR+!Xu)?QOw&
zxc#H$O|(jw00GL?L^q*~m?&{p@(v;l`(#B$OuY}nFP~mAlZND)HKPy~qQaGaKwv#$
z?7#@_km>g0fOtdnN8Dd3y{$-j`DdskBlNqzW%0Qg+vVN`gsz-?>+apylP9Nr9RtQE
z$_M8;93)rCtPm<iLdXVSBgg!z&c-kb1c+MF&Sc+nTpQ>`lQvlz4muaJGwK|uwIMEK
zR1nIOtbdZO5ms47&`Kn)tNHogf~;Q9y%_l6Jl^X7MzMVoLp(I`d|CF!DfI0dGthmu
zD{?b)5~FP317-Dpn6`U>O$Ox%NJZOaXxAEjIGybfU?2>M_h5zDU+vo^zbg^ZB$tCN
zf=!O;Hi(ZQw{AK3&TPce0hX)j<%kV~?DJqHgZI~uty{GMcF3R<fmuN1k|ifH6@M}$
zh%;wNu<agbvP<Sc&eY5t<U7ZG=s=BNG(4%(lQEtBtExQtem6*xEUVE}Reg1A(4dH6
zu%JhI{s;bAdoJ(6z%Nt`U=&*RQ=Oe-z1mKjDrQ7Pqy^+n{j#G}zyu!5ZZ-CnB=iU3
zTf!JnC-66RvAy4Q9)${h6vNo<u8K)lL8%j+`fDu&rEH<M1c>Rsd}HEqudi=gq7D_H
zJYjN(DBCH(MAT3H2ccIpRz_Z+tVP*D5vbjDvy+<#Ef(MUngsyYS*3TQ8&P9q;o~3`
zNvvr{d5;wpTDvTx)rvb}a}ZcsnXVZ_TZxcWxNpoFhHV0KvCQoL#~&Llo9BgoXMta}
z(K9Q0<yw{R{o2M+crdrHD>T&dwiP1HpELQ{FDpDfwO_8?HGs}?5zT^(2M;V<wPbaj
za8=BAC7h4kx$`Qu-`_;GYWseZ$iBZfJ|T<8n~O@VD)LPc7kRhYt=hjydQyjyV_5?f
zroGBGM05juY&gjBl!rYfXMxy-8=KZVm&!_(<!T1Z90Wc!c$)fy+X6IV;d3{hohD!q
z4Oo+8B@_IS>7N{VJLC#)5v(Lm<AJA!LN?IV;2%{FENK|_cZB!Ye*Ly^r>N&Og2|Wb
zXT8%zg$AVId`to@1FrcGZj$$#l<3S?e{+qBdT5m;_fVUROH(v|d0g5|r$Yl?r)wQR
zr@d5tL3-H&JEvRTDk{s(k#zJ3Jh}7@up~6f0r4GIS82u~cv9HtxE*W%YB>yng-3%V
zU^r}I3h0*Q8)j(@!|g}xz-@B!jTIWflk-X@_x9UrdeS-N5yFa*EarmbKZ>kFIti;*
zt-_eif@T=aoQC(q9cT&#Ann8c<vuy}A|8Sqd|3_o?wt|qzqGwKSl}v+R&YLpR4z-}
z`OjKzD9wGI+!6jxmjXYRn72zGL)IY{-$hZ!<eJP9Q6}+!D(?(Thxok;KpctJ5_GmS
zsOYAo{rWzex7x4DEo}6M$4T2b+TfoqqPOV+x$(;SbOS3_Yp=cGx=ObXadB5lICOsH
z7)y{qq)ST1h~*GRg+EgNX!(c;fPBkxe%Uq{5@Z#(d-NzVbiR(~im+x(uPu6hE~wAM
z%?i2+d52M!L7&ku3xBLC4Io60e>22E-ac-B#a26fhG81F`Ma3G5hKJ-(!3UdLofas
zp>FY`v_WgrWb))YX1jVXU9v=62K*!Xs97c`wmsZ=4{A-}piK%3y(`<oM$M%}6zX7u
z>(1eTSSaeaIl6<6#m5gK|N7RJjX?M?o`PjlgnGuYW{*L<dBA8?RXVpab{-ci8452}
zbnc|7*HYJbK0>!WyfxY-d;eNH9G+P?5&E#Lbf?4~h>ne|dK&kUwpYgf(wO8zgEN2E
zr&;B}Z?U>A%PQ}I%r6ti<vomFA<nh*m-dD)!wm0+5X|b~YJ5$ANe+9KS)6T3Bh2mj
zIbE<xrbP5N$E=Ti&)(+CZxZLZ^oIKVB+6VirMqQ!4dd3y$QHc)H=DR(hXt>$u4g>9
zl0MvwIJ3@LT4B1hvBbxh1AGR?@+&%70+o@M*M+xTx^^{YEL%Ox8xj<5A%|Iw2Z`;b
zf4$hS=Gkfh1z=0*`n+r}Y}J&o)zAK$ADqsp3-;Cx+cT+QVNc!F_1tkOaDnt{Y8z07
z&}u2H9)Mk03~W3(d$;}$(wNiSx$6*oLXE`TO(n%TlJRkj*#j+PqSO%*9h4?b7W!=u
z`4H_7-n`sqC3*#9M%LOxurgAj0|dA@1*1KFC|^fbUP^n3KHXkYtx~scx2VZSQoi8W
z#_Q@vUB}SPHni5|?)O*F5QH=C%1jA1Ww(J5>icWNm5(TlR;>enId{-$;lkOkr{v^0
zQDlk(Dvvgxa)4TKD8!iz!MnP?pWXIwa=%T@TeP50Wo~5DTxums&Es<}hJt2H3x=dM
zwdoh2+@r@X2HHR!TelW@911Y8QB^i{u`und$(t7|GYF^z0$|Q*?Z5E6lx{E#i&@vH
zY!os^0(g;fn_%E1{m#isHDe*a_o9NPy>^JzdI%@~<Bs(l(&o^2q$ebDqyLeA%#|AV
zyh+QkL&eyHCgRhzZ>XD^Ng=2dI}LHd2kcfG6&X)@3;Dy>tO?5O7~OrW?-<~M3xO)i
zZo>@2pP~R2fjS}~JXgQjjLy8%1Jp!oqy=va6Ssk9dhUgfxrIgswE)8=8;37`HVAk~
z$}92sVW4X1yV{}jCs>KgT;Se2C@?T&&qy=N@eU)Fh3y%IBuPENMa9+&Y4j_?m1yr^
zEdoPcftv-(6P`r3C?bn1Q&H7HlT14{Q&;paTGkCd_FvE5_U!W=O{G5i{A;V4BqJN=
zlhJeO^Ns!2Y4>2buaSCn^1n=V<s*=0Xm<ZrF)AuvMfeWmHUa{ihQ(2<CeM#*25=js
zdSGcSvv6ZMF}t$d!bXx6r0q|TgrBO-D*MK4HMEy(-IXGung8j2Lx-NR?0zK82uX=l
z8O&Cq+=dan4>zR6$k>b-9l1OZ71GM5-4o^9lLAw=U<fA$$pUpjk**VNdjf`g@80f2
zu&Y^F{ycxUx<BAOwX;^#JlTNp3m`GdyVu^x$SKSf(pyr~(3qruAMbamxmZYSx;-v=
zX>VqdGj81i>h%qDqe=>+<2q#ZS7%&A?olj@ryNk;1x>%SO-WJWs!KrAxN#o0HclcM
zDrpB1IUU{HvQajO7!2DH%U?F(EfBMToQ!xS1Z;&-M}C4X#QX$U@a09OrsX~ecaew5
zb;R<Sp1V*ayj8gDs1d_oi<1|H56c$s$XpY67cf7cCxI$x4`WqIUAh?2!Wuk$_<SUN
z;<S#F5+(0uG+;ov&UMNYO*jmO6df|&2e0?LqpGv`*_l2A2DI^dsJMoGh+G-Qf(d<%
z@!F!oHS_6h)|#?tud*S3Vlr0~ahp@%oDL!S6NU!dmK_5U-G?k_hwe-yLNNN#E<VGk
zBgIY*MqDWB9FJH|!Dx}C^Ei-N1z0z^-JMcZ6Qlwc8EzBB`=vXv+r}?1Gb3XI*Ok%V
zIj=_y+P8oI<V5XZt~uj=^XN^Mg<oib#jno$b`c;#88C(h*GXMAm`OJVrs*aOI1@I4
zVWs(WCZwN-n9S;uolWPx_!NjZMHIciyKt3Ri~}76gn7VGC*M}JLE!<%A^u13hO%Uq
z?Q0=?Y{^y|kO+LeR+ZauWSu{1I_ZJ@wYGVx*&y1`-V49J_X|>mqyi-So-|x-Z(q>k
zT`tEUBqBmqNTViErwIfhEY~vpLJRd9xuI*RowDCFD4UB_-IB5AnW>d7Ev6AlRwBVA
zq{s?j&G~=eXUTX|R+yI749gD}-!{x<sSO2G4yhO2Mg~AkBqFTw_`|-tVZ;8fwFabV
z*~7$YnVqq9jxMhd+4iG2BWos@PlMjcr3XgbwRUWCSZ25QXI#6hshIM1naAW_N_J%G
zWhzc2WKRKPvuDpXbw2=TB^9aUFQG?+7#;{_<gqO%s2ERWk_kS!Y+W8qTt(Kt9te=j
zEd+jxe%9Ihu^J0<tP|%hT2wc^c`#})F^izSqLnVo=g4TXvq>x&0c2>no51Vt<_6Ay
zvOy@kl^T<PDZXuxicW~p`7r3Aun;6lNjC~mL>lz_r_LsX=;2I4m*7Zr#wSTDzBei~
zYVW6v454M*;I8!m#~BZz5q_+q2j_dDH{Qp?e2Ai(!L`Dlmq69DXN?&0;tJ}m(1rQm
z^#2r<*u_W-8?u-|7hDhaQ>bC-m0%gyiZ6Va*Duo~w3l}0C+zM)C*>+f$_D#ohU(<%
zX-(oS1E!o{$)VVk&|&ivTqCig#0G1~#P@z7XUCs$zPl4M5h=B9E99zb_W*@RJCAM_
z=VKRig-?DDk4@4OAaF5VXQ$QXFpyiwc<#Nd(x437O!&z;ZD`L_&jFGzF7We#`PTD)
zJ)>WO3QGT@#XfO*r%yx1^KXCNot@YGi2YtOh6a!pTf%{kmp&^*RUGejgBx;mXEH4{
zqUaP`U1|Lqi50{_Zqn=#(Q&Dr0S(Zf=)jD%?-u=dGA>-(`d_#*k>YT_w)Y%q>1rBv
zk23XN{GMC1>shV6>SlPX+T{xuWI7hD)m<VeqgksHJhrQ;<ry-4HhT2s^P1ULl0AQc
z;x)F_e9^IUVA8>|<z@{g?dJiO)~~;2TzdEZeLd^PkTq8xRdTM%IsQO?bKWCaDbC&@
zbf>LlLH#$SALK*ug8pRZXBU_EgHnepI&J=QZC8F$jqWZ1#^g#FAX%2~!QN$6P1C|Z
z(1Hh7`1dCjazDW{n(~5?{uDqJq)!6sYglTP{O_2&+@*=9k(@Muyxfg&Dh>`%IFFw7
z!qS)CX}`XGC;s#B{uU`ZN##qYM0U|qVS9Q<B004m?N-6?#QmP|B+RFYAZ8Dd7Vi(0
z@E5y(3-=B?PrUW<2MFV;PD~1*jV|9@7UI$f5M;irjrP|pIFW}u$yN7z(88|3Mr*{4
z{gg#|-$vMibith?*+5l(Tm1=wJUQ;v;e=1Ul;uhr$Ub6pPXqGepvV2SwZ$F&+@hyy
zrsq4Yo<y&L2H&fk=!tVKdiZmi<i+!=6KG$eW&Sz02f6VL3^`h@cafTwUT5cCpj{;d
z03{6lhDq=^oDLzOv7@<01ti2hmnjB<SIj?YDftX*JzLDgnRIdHS3n)c<N=3~!hQmr
z5ow#6xn`F@4)sKLb?lMZ4L@y?J#wNu$32grTSO;FiC}VNG5pARM3ixN;K#_hj<S~x
z2|qZ>?8^A0)Q1druy{nLZvI(x<rJR}NKdjch0-V}C)BWhBK;jGpF?noZLsYyuVoU;
zk<KKogYbmG*2-a4D`?{-l{e3&V5FUU4>{nb2sJfJH^o_7b^4Q48*MPRO}!6<5<3rS
zn`1eH>#2z{s1063l(^>{Y7C7qH#<}&LJs7fK$SN&@^(Z0kFf|xf{{1ogc|H6gd^I>
zWZd5b0%%i2-~RCbuXzV_=7nUG0-2CgLlNg6q4_nuA}#OR7u&n-5wz;*O|`sX%b+3s
zuJikhkxdzl(z;+4uKi`o1fNJ^9mz?fG=@4LHa6BI?K>zEhY4I;cK4hyXU>4tS5i~G
z6RM^o{iVYEWpuF?qG}q<8vUdSo6%WRz=Du?M2g-U@9-J00^4PpxPz8G8;1`AEiISU
zE-V4P(dAA1_T?y%i;O?SF{3G&zS}6z_r|;TfLuoN+~<R_FxNA0e%t?zUqh`5sg-{0
zjKngeFuNI9md!^ZQp!IUcMs?TeG)?xXToF%CE*<Cbpj?CRKZ?pGQ@;vE_iKHB%ND4
z8+l>jrP9NjNGPUi?>}nhgyvNubCy{TH@84kkR%ehKU9^lj59Yc7@+pGfo-(D^S1Ba
zzyA(c=il>7RS>(#VpX6Kxk5`%Pm}38a;XO+`yxN)JQC)Gd&WYB4H)(bO0y6!T;sVs
zr9FDl?3T!KIEwx7a)Rtp&@~=}wSidwpuI04Q$Q6p;#mXC*CXAf6>Vf~{VnGCXf7*y
zzXjlIvh3>^`x(F%s#t&I#}Ez9U>Q~kZ5C|w@#8i&VbIBhW$Y_GGd{X}E0R>{^Yh8C
zDleUm<@FPZWteObK6hr{3RErYO;K~Js~cMC)f2zyT2lgV-nj7(w3gt)@n0L>zkc0k
z&*RXGd-=W*iAsHS5u=J7F~p4JQiM)#%V=MhE~~3v#^B`xKI~JLZIaZxdh7jIh<GiK
zF7j9OQXCwnC@hXZxk?8Dk2(RI*6WnC92jPuX?gGH@rEye*v2T(-Tg1W)3b39PyO87
z>8>LkwliIWFr-6>8n<PG2dc)v)e}ti4PR_V@CM)}<uuO)Ak)27JG1?VKHjg=Ice9<
zcj2=G0smmyCY%Z3?gnT=+iHU`Ts0R~8hHGgg6`25uV9wQ%u+x~nS1e~SOHusTt3P0
zRoS+h<jS<F+|bkiP8;R(=)WQ#h?ancWx>&M;{S9$goSo=b@Zk@6loIB={az-mWHJ=
z-4(7LlJ@a?VP>9i64d_9+bUPtlxXRSTma`x7^Pino`b~1gC3p0t1Cw|Lmr49W5<rW
zR{1($NJJ8)EKp%!8{ehJE&5GC7jc)jEb|Bmt#+Ps9*=5tE{q5Yc=HeQ|D;ctR`ae0
zfW_`}+rx}0BYO_7jeU6AJiEjZ4H@g{O5ld@>&t~?rRGB3AQk$Tx}L1NdrR`8O2R@Q
z3w{{Vs)%cheli9-7DP%QzR=U+uQ=2-hY8&{eS_H@LW27O2f53vF%i7&MYEqXE06_+
z^9d{eK)8G6(k#H3!g3<F=lIIlhd@9A8il?lzN#RjJOCL@JMFh>pAq@WJT;(BcU2Fq
z$>yJME=>4moAqzs89>@QtVX5ff@p+m-kr`QWC&sYd&-S8h+pw0rXCo?rLyq7!W=%d
zoC|Yl2%5Km{A5T*B0mYM8!4JxT}OjY>MP*(tFp2nP$thL>)yR7Ioi`ti+e}i*E<7w
zMGXEl=L*LvRhGY=C~Q5C6di*4s8Ra}tZepR74%$w`<bPM2SvEB#*X1Ah~;_A;x^GT
z);GG#6qAh#r>}EI0eWl{5%bbb5!0igi00E80{C{s4v~d&KP>hw?Gn-pF+Xk<;^n%3
z|Na~ggFwm)&hut!aEYK~rlQo<Ba2DlB+V_TbNHUS^uN%_e}<5sfy3}ttM4s_p26Ke
zM?ZGM@5`k3`!aFtJ!XWuf+J)i1BZtw>d02QCA)-R0fYnjTIm*F`S<zrhiN`*WuXc!
zBjzu^D$~sV^z3YFj4HsKn%|rU*igpZ1%Fv!w@&e#H0{RY(}(y7*ewakD+d^(2dviJ
z_U_hK>`-I%UyDxUK3s4um)<WyX2>d(DvN8)p78fh{`RYAhLRcCrkcODhX1!3Ef1hH
ze2m^ji^-EkVj=~7+INE2h-b2MhkiIrlv$pMgN3HguZoWjyEJL^gV}(gJrd5fmTnNI
zg?&fiYo4nm-v~y!Sodlfysj?XzRZGw2*^=1eXO-o+K$8D6Zm-(=^T}rO?DT_B)I%a
zLUumaXCauFOatJoyK#8wYPB(A<_s9<uo-!vTpv!E>?4u0p{v`LTgecSkVxWL|L?!4
z`KdLGEh^!T%{{wFub80+G&Vve6NqW18cf+Y)DeoCW_K<kV-!%%mdaL!hR;Ae9TgSV
zvHlEf_l}MsLJ?UE0GU^NU*B2!@XPiy$OR_*;}xGm#2x^vuRK7~{O=+X4ZCb7$jodC
zYr~q?snnvkeI`tXSf{-%cL!!gLANAHdeX9}XF^13Z6_K87d%Uq<nocVWIP2ZC_X84
zW+6Q4iyqXAtcJf1*L`W2r^oBkjgYmP+?szei(n@QvdOJnA-Q9_c6Ef?<A_lZZRP7A
z<hXJ3W(!)ik_z|lpB?wK+X<93Olba(inr7-FgQpb93)6E;qySkDbk?#{aM-%Sh4Qh
zx$kSA!#%a7!7#9I{?eoBb|aXRo$rGThuTps<vSu1vlu3ZGy{A!DG{WkK@tXMCex;9
z3_IFJ+*&9iHzaWa62rz1r7;(cqwn$KcX`%#to;>2M%3V#gYgfuZX-9ioji4_53l}Y
zeR@-2-(3{h5qaVFz;D~4+mo8fI9KtJuoWV*VSx%Whb{oW33qCog-6@B&(?pBH)~K1
z6QCH`Y22bk3lx>9EK}Ez<d4}6anY=(<jxRLq43<%*7*FBQMK>}g9XG<lDVe@1D+qW
z&DxT~2@JXcAUf;l96KMOPqgVbcyL8hb_~@Ml}>A~vtEvK=a$c`j3?-sPcFs<4|1(C
zyZGOfloXB4c{IRH^-qR}bN=0E0cyP|_3P@2LafkD&F9xC<SK8EAY(XkL=%o$D}N@H
z76skT?B?OHbQIXU<?|O>+Zr)B|K{`O`sp{_-P{IaAI&7y6es}jp%W?=k=${1WV#qb
zcvBvYbEu}yP*LuXnlQ^XoA1NyxonB&dy(8DY{oj6aXNWOoo$WcG%>qn1_?cI4JE~`
zTZ6ki%K1N9fLn(U?hvqsFhvXyK=`S5Hn$JHIm{VwyR(g2d7Z6xba4?ruRA*?prf4J
zyh2)K1JRf$6x&>sGa(R&JkPyj{S4@o)T%w4Pj`6Ps#OEOJ@vwR82<D=3Mj^*-oc=v
zhwAPXe&!|Dl)`Y?%9TeLdtutl>Ho*dM;E7dBoO*mziz=>?d$qAa)61s`CABMHm6JR
z1zQf!f^Al$$dMT=@wP0j{t<#$jCU75Gf7#VwC%GLw8bDaM`#bRjYSsF9%->Sx&Q~`
z?Jf_e0V<6E#2t7mjihgh>VYQGCCj~&fQZ{^Gch$b0`-iN?GBS>vYv`sBd|{u#5g6+
zbf$S2-7IA{HDlg4;0N2b4YF{*46K&635p)b6&KIuUycrFa~Rcu(CNQhTwz871~;sR
z@{<;lP#4TCL%>+}s0=je%3>w4X(pvyOzsi_xaPBpt384f)G_wQKh3x=(Guz7YrxHh
z`&XX+W-Gc}``Mr*^lngsrMY0h|C6>B6HWb**YC>|H!lv3BhQrjm+9tRvO%4ZzYy~q
zVGBmB{M6sH1MO54F1P$x8uXSNDHALl1$wZXBC4k1?y!fZEk)%*e}_f=TO()`H+ShU
z0;d@%2*B17JG6KYzs3{@r$A0VD@%Wd=3OeUugVQJZ5iH-yC7<H*mY1S%=KKV8kGT4
zs*u82wv20-qN95;9jS;`jGL*_$Bzg<!t{fV96dS%<pcu{yj^V<&0onEt!B*FMIqu_
zRfEssPHwfVC9|lv3H06ra3X+xHT8RdY*M1SRN~M(MP+3|tVma#OvkZLflxJD@O}y%
zI>HQNE7@oA))DZSmo9>+7;wIMu4r7aap3&>M_48xBSkha&Z!lIIp<{~=MHZ|u0St#
zZ->?`)xa|!h+%1z13dyyB#8sxC;0lb+RvjQEBI|npHj#j%Bf3Q{e{gO9EA{U&02TC
z_e5{T5OX9F;&)GrT-E_H8w-&u#&&@L0k2S0P`<GzyC-=w0a>VMFaKlIDueC~a~V(H
z8Hix~ADbTb(NI=Yy?OWUhIB4c#}5U1k`Q2XnXO>trwKv<DzBTo<z=3pVWv%1!L)(u
zg=|q$ngA}1E7$@ag+HIi1(G>IKIcidhng}oO(uow!XVb(sf!)_9i_aCltW2awMvPP
zjO+y=BVE(O<E`Gth-W?H6XCHNS&<fkM3z!uvF*7<*+`4s=*$YXD5|OBbIND};^g;F
zQ;vq+fAz3`>y575KIA#OY--U3#&u|WI10A4IsYyR$!Wm?@!bb%Pq?GBx;-h9w}>Zg
z<zv;YUnekI!{aRC2{KjPjvijLMxggPa0vlG9B?2O6s<%hOb0Y+r}b!x6=^+=9zA>K
z#m+?ZuMPiRuDqaJ+0gK&eMqat=gzqGJ)>&udM#kljPIRJA9LNBt$*)dqo?}kLIR!l
zp6cOv*ZEifh1(oYKm7ZMYq(nA_u?O097>LzGM^qf^+avi<9o|S***Dac=Y3(CzZd}
zlvV&=66#hdD!3osxAw@4a(nCoNd-^#v^(4g3^orcMw}sreLwu^GPR`G-tm0;m0I3j
z%xRU-CyiS?vQ2mQ_1Z|E1k(NnhTOzcc?*wjm7{@c!XuGUiC_M)A0Epfr2UoKtT<;H
zr-XS)bf1jI_AAY6x<UI#bnZ9Aa>)I!3>mYAIU3IIx+i_~VA*J|Wk&DM3kJQ;yfdkq
z+m1E&gN8O+GCsEcLYkVulGh2f7=#pY*`y-_k6lqVVyrB1fB29R?H~%b-K*y~I=-I$
zoDfz&dLr&Hi7uZJKhL8Yla?hXy`lu}#45T()hnH;E#wB;RnH2k%u!lp^LLZIB#%=k
zwZpW8G>ctz;^4@K+PmO=p%r-Z)-`FO`^Kb(I00mfz5Qd>bbi?6D#EUeaFg?#!DUpq
z;=m6bLhVDbAYCaAb7o|ni?eezJwPl#=0ikD)DRVljNw3Mlg{bUi={Eg1l%+wZpDs{
z3hG+uOyJvS&I>AnFUJfwhy$!IL9o{!*2B?%fJd1@xyEKBFP}aaJUy$au4U7J^v(GC
zS3l~-Ab*Azm(dW3;4iwLP!sZnNQJreYm^|Cxz_UK30TXhLzI0SzZZ(X%E~fjAg1Pk
z0oyqXAxsR=X#j<b>X!p@#cZ?@CDZFqpJ-RFLJc{=Klq1EBK<O;xKK=l0@;m>HiORC
zPO71ZnqM<URfyTrS<L|-UcX)sHpb3E@yIEK0!04<+HGV9-*TV`-AT+$ZX$LAO-l;o
zBF9B7u(q^3485+@HXx$Dt}8AXPYpJ$iyt@b%BFR$HE6@P6{?7k15)$xt%dFzPE!NA
zJwDzY#xy?U3+|?7%=-=DYD0$6f9j0%R-^QE)8dofHD9%(46W_sc1@t3*oy7areg`+
z$RYd@CRd^#wfH<a`5IceR*k2xKcuA4c)AvaxG@gKL9GHfYWi^JzBnAQlJA)EOPAME
z#Cm~n2)Z`86y}k_#LKpUX>(a?0j?aMSFBJU2X!VTEDf#G^fah7`<8~@mV8CyM-&{i
z)wp=!%0peR3a#hip|q+aL(Ih-(-YyZd#^t<hD%%Uyw91FCt3Aby=t>DWAq{>EdO~p
z0PsEf@(!eVhvVa`vsW-?BZf?1LW9+_Rrt98!Y+8>OI;m>8=s^t%pKzIv~M*~Xq3S4
zvtn0!x3J+C3uf*@d}Lul@V2G6PgPfwlV;4nOmV|@g~NQ#G`pYELu%bUwtV_9ZB$;Y
zTCc&AE$o3WqV`60_1gr8VNbP?09eG6%qfXMKhR>~q<*<1w`I@|kT8iFo<Fj>I-u8o
z0Afk3TTnL-JhO#Dw{^eM1{oZ?k$7(-9(+S8XEbly&A@tmSg6SmksEq?4h53Ey8I>W
z4SEHXPck~rgWF=F?u2|pC;-5}-}mHs8=jR=I2TnsYN#!2h@Wv(n0-*+5G?&EST#$P
z3eh-DK-f^q63yx~9*9h2NyvjA$bv<a`%Ch=`f<4horr6+tYHEH@~ZWfGrC?!s2GU{
zptOXF9k1P%B?Ew)-?q`;zJ+^^RN><M#T*=2QFMp=O}VTDMx$VXcL9>t#0Xn%9?L?N
z0ElRf&)5#!LnC$_bp9aL^zlz+jVScKPLIw8KND0IUOI{u(I;KuzPdqf;=jS1#-V2i
zuis>}E`v3?NUY8m#3&dHB>s!~mgTObG)i0uXI1(wCh9!=4e0Nb!4Y^~9*fgtK88Z%
zn2W;~OS``BFcH8Sb@x^+_a^Jl97FdKUT^*cVaS+Q$CA^ExR`&A9-RWapk4Y-FJ76`
zLrpEK+4*W3r5?9MjY!!bb*eanP`I_;wmvSCC@=0O3>H|A3QSDp(Qjs)f-G;@RZ-W+
zkLfI(Z;f+F2{Kd%l*4g&TkM?<3b6-0W2>9Ghy&)K8%ZnoVuLImHy{DYLzfPC2+F1*
zv-48^N3f_EkC05ha<WV=^}LoIw&T-&<|`;KV+fC-dZu^p+}S1^7=y)TEob}OM>5I*
znk8~cDf$T1w5KMeCYq}%rm_q3N^ozx2IwZ<(fanmCm0RWdGg^aeWl6|`8t6snrn4t
z)Q-bb*u7mdIymF#?t<A{Ek1wdx;L{1P#Z-%V#N%ACr?hLK`42Rj(t%rLWs;CyH}3A
zcl-951^s4t`5c~2_k*e(9en2cfAeb1Mn}}w8psGU?Og~Qd@7GHTVgq~h>as%h7CL0
zs@Zh2iR)=KLt6}T%2YrvIe~Xg@{*fG*1&p9bh4BJ$VANC2Nt+2Sip>>KMFfQX<~%W
z<AfPo;Ob7Y2n=ss+c#Yn%dioDN2z{n#{QVi6H&b{FKGueCwo7DJ+iB6+aJ*+-~}{~
z<V2&-z`m(}yNz27)kOLLL{k411_F?2U1&x#SUQe&EaGwMtu4q-hLEhZ%g)(Y^Rc^8
z268mI6t2QkN^De#<s#pQyLk)RWOyJLdr87_BiwNO{~Yuz(OL(qLwaXMxS1|qT-Lt#
za#>_TNh(rel5=9+>X}{0lF+N%`}SyHhb2C@1iAndHOOpSR#dF4Qi}!ZN(BesMeoO<
zY}oG26J?x$5UKI~i&T`jxn$Bws%9(8Kc1eM94%mf+H$8q>Ky*ALd4b&)hId>MJOSj
zGEn&@IhCfsqg#^{fjg+SPJ?cVX#LLKys%-bC}F_daw%C1K}ii-myRmtx}ZlK8f4V^
z)0Jow^&$wPqp`7uYRNJDJ&mlNEe0kZ;arsS2;Ey3v}zhPgs)gpV?N%7zeK!qF~Gu%
zLTDr*iuER!cOYbJ!TR*+)2GAUrQQ)zm&PAa9OBg|anxtO&pcIGKTL=_F@2Z2@HPiq
zX-ok$8A2kV_Ye2fiW1{Trb3oIY`1<~xf{v1(<S^VC=}wCz1CwO3|2jp`xB?F`T=o#
zslN7IOd)xqGK-Fij~kqN9paaALlPZdJqG@wG*m3HWuAjp6vXk&yy8c#xEd6>BC5x$
zl;Q8IFJDH|GZ!hL>F$1tCjRY%PCWRJQi*(>3%;Y1v;Ij}D@IrfyZ0WZudn3bI*Pv*
zI=gc_`<X}n*Ak%0i(9&u+s;ts1|9;#DZk8CA8hz+|MSF-BTEZrJ<F}SCwH-+$8i5A
zky9F8CRN=_pH;P-r(><$Zu_=vYnQ&N@sXYff&&VNc__bRm-m6utERq)zRQpWFJ2sy
zh+Uh(H?kxA;K75eH#%!%|Gr@-!9`?^EVZ;rs*U6o2-QLqbs3eH-;^Tr2q`gCFXo0U
zi6bow5f0TNB#6|3v_D~S;T>g0R;oS##7xaLml$&B(?+{`5yjPVQoZ0s+NeB3@oS;{
z8ARVodDX#qeW2)ODYN(kVl(7jqfg5lJ%{WjVK{)=2Nx|`*L`VBG7PD1V3211?-54V
zMHC7XClf-{WhgH&Zecq-e%|XdyLRx|jyyrk=S4$}N<w3%acRJNWT>LBA!0z;#PG$C
z(r#uGa}GYHfzAJ5I!e^<AkH^5U7!LioX&>j<>w1(1#S;s{?1$`19^z_9(<N|O(LE!
z`4|Wx2O;!^6e^51d@#yLHhgC>4J@}UzHl2)EDQFCNCHsq50Hu%>jzOD77cP`nI_Pj
z+at4qcoJNwy^J|SP|LI14Am+!tW7=N=>9SY)ANdN6&IQL@Zm#$ftYPKt$Tl2{C>!k
z`-oq!N=mlyzenaVol=ufBS^u(oL!(r>D}yXSsLI1StXg#@%m<qgM<3S+ar+`h6w~1
zZM4FB*zn=+c<Z5hZ(`^SJleXh|2kL$Ma9kv+JXPP)$s3)b4JXKJL%w88(4E9#Ckqz
z?46oJ)L~zt4@~N=ew(LjpW2PI4f#1^apc~n#j}_eK-0KDHr1YVy#A-p&of?=F3^it
zmldJNXfQ_z`@7d!TC7P5ZQHt#-gwZ<-rni}ffu*r)4Flf9-^~rh`AKJdDEty@U*@M
zU@WK$So|a-K#Ux1XK;#|Iq~~vTf+WP?qqmx`^j+Pyhni4tPlP_g3IRrTuSpCSK3hW
z1Pjec`vY-Dp!nS{X)h(Eu;wC7xQep8sqt~azohj7)Rh_0%wAJ^40TogY@Z0Ute-P!
z$@P!x;tw9Q_dl3UgNa*6RVfW$NhP4c!ZmYX%thlubLV<tVHDdo*YlZ}xa?2+V9<yW
z$vM6n_=D}`;_3U<*SR~W#vDB=zQ#nj<YkQ|bo6OcF%W@b5jqXIZ?GfNfR8B2S>N=Q
zk1pwx?<%S&s<RG(hO$#I#AFk5dWOMC%{F`p!!v<Q#oV!0$5wy~9Y~GZ<9got%#f1k
zM5H007w()_GL$y9EGc+}3{ox|Jw<x3vQmN64JuQl;qqVSl9>tSQST8@WK(-1au@KM
z)tg&sF@x@1>X|6$T=*E&IJlSXBsK8~6(@yfO%7w(OXmKkzHT-A)m3gFdY8k11t}kC
z3<@j->DbP@l*M4eV7EMVUmUuzc)x}5ix!oLd>R^-qN&G;UnX;8J>i%!V+<~oC!AUS
z4?M95D)=U16C)#Jj7!gDj2tr-84u6A?!^Zb5)8MO*L&h4a4Rd})XEyBw-lUn;AwcB
z5KX1e&gzI4596(^TW?dY+*hLqe3Qv$vcqI`Roh->f0Rh8=^u?I*Gk4K1VnVkNu5B#
z!<H2#u$M+3j*Mzmfbe7o3oN;tVeeObmw~L6pZ>;dxn;X{GM}JyY*P6$G07tRz#iYs
z%d^ZY4s%?z=q`y7>09Emhl%yu($ajBS_Z(BhwRxy`f9qtmVeQ#k7?3;-S%8GT5>ml
zAq&07RWVFR{bQD2eR6~i!Ufu;tZPyA?2r`AOQCsojW5LdJ?Lq@kWtJyQo;$RN7LUV
zcJqVrBo9$$(%E#u^HYZ3Xg9#is`l0$ps1kzWXq-C`q5*c<ZVQ$3j*RX%Sd@@(2t-K
zVw-7XbR_SC565Ek%1=^RhWk#S72<mcg@^b&Tb`e7V|MfItRpm;w_T5kYy1e@gjEf*
zAxEm0BXljH{ZAg*6&^kbFa&ByUGr@#Fe~h$-Oq-ii4WfJ>!^?NDBD~4Po8XMM!d+P
zCqz}eZ0CeYlZumCe@7xBYENhx8Rk&z)F~5igQwUZXe6&aecHWq=Ww%MzB42EOt}}9
z%|nZ&7xD|AuHMMh4vzJ+pO<D#e;%sYyxZXRsNQzb{tJ?l@Yl~3fI*qu=fX3~_7Bo<
zK$!(HDe2s(g~+(DW2dB7DZ3aEq9=sNK$DbD9|;;%v~41NIMTV!52%`1P|zFZgNJ(+
zyvDH+UYp*H_^!at!O?S?j@<phYKK5dPjQ@;VxFVJfLRgbsEjV{+jkq3e-T?gF1^T)
zo}S0(i)n%QgaovXrck(9>n)L&(!e4?9*;O-B1SagZ$qp!`@TCeQdBdUc8!_#n~XkH
zJ{W};-MzVs7Y8w=1{4cVYp}4MHcb@YVn@SAO~`FMvaGC3jHkH$WV|g<EvIRj6XCx`
zIUJ*7fJ%f$ri2P){(x)hSzJEEM-chry1jdChK<>^iWsTPFYt^zGGrN;-zWY8D&i9k
z>Guh5S<yM5qd#)kRwdeH`aFOpCi6`4n^ghm#H);YaADcupLvCTaWnpI+GKpbQj^2U
z#U&+jy?N(bXzL5h(xKOjX5mMv5qpmGFjTA6gU^uBafh@6+~*Emx@a~Hj$@l^SKz=r
zSjJGjVqHdakg-Ze!`i!lsfV^9=JmY2$(Od90Zpz^AZXZa9yd)#SQl!HzJWV}eh$PM
zDicu)Lc<&?0Mp%-_9%GdAGZ7}<LZ+qUAe22wGxR0a!y3o`xO0<gKv!nWQI(r=G$K<
zs>{WK&p$Ev<!JX5;Ju97GT94%c@w8tNhQ#ork94Uf0gp}OZj`*W5QT3#WSZ9foS>t
z+;2-)h9=S?#!m4|n_!03&Skvb4o4Ld74?9USLfSB0|c>PY9tvyZ2aTJCrQ209tL7z
znd$p|NiD;dfQpf!67P?L<zhlqEPWZZcdu63pVB3l5s1gW$OvVSZ2b7wNzV~Y!q#{|
zBv51f^El~MNdzGyZP<`8I(??8X@c#*`^YSVWbP7k#=xMVveA@@-dAjp5iNz<u)61H
zZ`M8O<uuk9A&WBySaiOiI^?8TW7~rc!HnbU*1W{LN%^ItnQFXQoZX7a6Qj`^5ZK?8
zl}!Pz`=7Yj5KW3JdJ>AJoSBfDxDwx>b+{L33+|=;CA&@G@VcY!;E%$39h!5qBW#3A
z#{YD0J8^C#;o&jZ51~65kjh#0gee2){Ez$O_Vly{bQO~{Ifw^vA<}m7K1j{Vji7ir
zVwn+)wvcWYC_)61z)#sJMVW%YK!yMj$)LQ+uU_tsf|1p9<6lJ1P`)2Y=n=$<v~LqE
zHNOc99}LWjJXW=NoRc#b7N1qC8_`Uj!k&ws)<#qwJbFOg5ZG6Dm0{%NrT9-xg!{ov
zEC15c@mXOjZS~r2Ha0Q}#ls$!O->uy1Tjt>m{vVuOxm1%fre_BhYk#UJT2T#UMm5%
z9pTsdTzg6?zfJ4<gT|RWH)W(r_Ub@sbu4)BXaaC@9vWDcVT(&=yh!ue4|sr-?S<7(
z1`k2|Z1%=OKl#CC&fYQx!jxAV<S<r2RVdDx;f=+qj998}Fr{dQo4b1`v-Q8zTlD;>
ztd6O&2c9Y+%(MHKVFV7^iZ;ka;YGqcM}EO>N9TUjSc_@XcE(PwQRhK%*mfhCu-BgI
z;desnN<xNAvk4z||Ne<*-+dS-g)O;9M}hu}-Py8P<(Dd{um6(f6Wb-;atd9LmJa**
zZMJHB67m74ys_eZQNHHIkDJ?1w8wTCaUcEFSJz(}7oII+7DQY&dViT|16d~9<d~^Q
zd{pLpf~#0?`H<SMVd1o1fPC*sTo=!+B6A`u3T6%kJSN=^NWoCLonWxrD@OCXnf4Jw
zM;4^Qu_Ji!z)YawMLJ##MB<_)aUx&@ywhW3XimNUGQS|2N`9&+eRsi3D=UVn1L+L<
z{&Omu2M^M`nVWlRPT~H<LzvYdrh1y@vo@$@009n`bXr-THl|E;zhVYSOgm_LQo1!y
zO*1*d_%s&@^CG3-NfF<7g*CZ$RP2(_sa^iFQzA)<ZWojd_0g9U+v@30xd3}uOF;+}
z+dxT|EE`|8>QD6N(1X^WTj$5M-U8`ZUwJC-W@udBvdO_3ebv-tnHgLL#PtloE#0v|
zfINs%jF2dV(Cee&E%rTuO_L0i5gcazsrr*?SA^z$+O4-^-6k=126UX*w2`p5-2sMb
zpk$phi%n@4cZc0#VsN)C0YKJnaw)2J$E*KG3lQ6iA(?m7Ka3k8N0>^Yl2K8*=LtD0
z>0k&Mh?xb}t4g>kA|sOV76bv1Ci>2|cAB-+Y1mEqhd}TKig%kd?~ziFr&(O{V<+${
z=1Y*ZZgXgj!*EveA5hJd02osQk^Yj}%;jUsAZ6g3aRdKKpB4_F5Q_vUwi2^TdMe_y
z=uBT#)Ltl9m<Q6D(>@^!<;!?jHfdqgwX{x4M^q+94{a?`U=D;?irsd*9-JXIPDr(-
zUDx~QB~jyn0*HuN903ixss1d6qI$mv2deGq8?Bj_lOyg1oK?qDT=+mZlrT|K5t^u~
zXXnMG&f>tzx5qqw7#w7Bi0(_A#yC6io!_)!@CVoFS5zv)zBe*!1h*-&2VxS$uC=b?
zJvvdyq5@d15!7qsoab6PI%2Gc`T`4~IAVizV&K6h=U>oWKkgX~r3&z{M|xmG&imi<
zZ%jnClG^VdvJ0p+>$%sE0k-J5xPRj7M8iDK{tuFQ7LS|}vCV^)oKt3FbmP<!bLy7H
z^$SK~L|?86v9-AV*;mXMm4O~bl=m<b4*?Ruv-co=6jdEsOj+*XAw?nHVSv+$Uj%;v
zq5K#YS=MsFw<@j5_326!!>AvQuG5yubd{wT0;xJf>_ZW;1!ZaT=@gL2g^f^J|Hqgn
zs&AKx29#KL$l6l?06IRkohco*oH(&0sqKUtSy>_t<2hFsHq;vv|0tR0d&mmHfDV17
zH%8k;>Ei$$#YgIKH`}7ZCBw)tyew$r4A78Bj@bFQ#E6MG;4BoxUbqZs_``%{VK3;T
zQ`X6RF{W4XVLSGyjEdOw<mOTg>5GweN_hsy34dygwhbh3^<#D?Vg;E>9NL6Bh2$vg
zaaWm-BGxygm@jsBF-y~Gx6vL;cq*Jq){{3PSc_XS9Nl4P60WXIqC<*`fwu{u0^+`(
zzP{y$OIK2}VMoMvYu=4EvH}1_Cu8-C{Vxx{ee2f$5GbuUIarHcUh0fUgkijHh~x;f
zhmlBHSDD-IC#55OnoC5d!#Armt?5!7MA!^D@mZv8hY0f)2c<uAgy?0#(joyCNO|$%
z>Wh~jn_cGH?!ta~Y(w3Qn0|+ST7lR5sA?-(?cz6~8YCqph7X!rUui|9&HcLu_&zp9
zRT)$PB*xayiEGM6nsFCyXcj|03H`=p0Y+{l3|;i8Jr{c?{$$>O=}u0EAGI(<C(b#1
zEoJum_t5|A$0fD|L^4g%e%hN^bEX{lGXy=!NhHSPD&10#0uSWV%)kuzmaf=Xyd%)1
zi>woM!h|g$%8TgAiY{|tdR-_o9osXm(_Lz{_4FA08vNVta&+<I=Hl0%?i)#&C)f?;
z=qfCn2CV1>Xm(pcoTeqIqp_#oz<~_~?V`DUwB*xMD&O<e8fCs*4cIAsy5dnzj^d<A
zSsqVBii8ElKg-VUqxpztZ1#!Ijz~0R+M7|c)2uawroT=5K<Dg1`3cZCP1np`(GY;*
zU<(4EtYlEbKwEt;m=pU5pa$`ewsS=RMzG(vLs$#12i(K@!n<T%p)smaYwP^;1|-(o
z-!6jgcekvPy=17uSAKqx4P`y{!`j(<6W2bPX-zX+gXt!m)?|zlq?q~oiF5!Q9oGZU
zI6F!+SF~>0PzVm94u41CMOFWh#vt3VR5wjH_7stgtn@>0-H1$9OlXp}D6n-9V=uI$
zx({}0N_hhXHp`|LHB+Z828CA0Td5GTuH^#GWVn?GX#9JCd8=4Qfc;S}pFDFW7VzGP
zp~%4u2J>`oaJIAFM1R59j*laPF)$25_-;fDGEg^`s#5nLJ&l`rKt*Q-=b7RMFxDKF
z>{#aqn4|_#uG8+`4vkK~o)S`Ahk~CSB$$g3V&q6zgInC~|HNzU!Q&A5*w`h6HgiSY
z$8TUw=2a+I_p&DY_R0KF(YR{fo_Kj92t*%2d;WdF6&c640e?UuG2N{*`2X=Ct?56H
zE6+AK-|le6pEVC=bH!~~sK_}AKmG6LLQ<l1xCsRlEG&Y#WgUkMNii!7KC}kMxm|K5
z$xF&lT|Z6X(!%YST-x61AwFaX7DSk_sv_}B|6gMT8#Xm;w!wn`KhB)UI4<b3YAe=3
zij>C&07sR+*nig9S!Y3Vj}mum<@O(?@Ik@Tl1M0ek@lQ2y0h&u_^U>&&4k6A@T5!!
zbUctsD1}@0z3i?4UP--jrG{UZp=_ij1Y>M-`yLq7K_L-Oj1C~6(R`Q0uRcJ!FR=VD
zhBSK=+O&x!#(rtDGh&Cb|9@S$jt+*p{rg{KV<dfRGnLr`z0L!8`OWpq{nt=w@!}>i
z1Hh@-W_+Eo%$cTkOIL1U`%zn7E*stU&@dvPh($RZqztpmIhdpK2|Fd}<H57h$7^q}
zk~ynI|DIgWzt7`hUq^5G7C33cYN9==cx+4yUWz!%YPw-nkx^?46>jA1h~?GDURoU;
znbN`5j6JcFyc_oSc}O1Jwscmp+A&m{34g7&BiF)Gh_{q{GVWGYl_w3q04P5g)vF&*
zeuXyfj<#sQLpL+k>Va|5Iiw;nRpL>-FH9dxuJDOlk=QA$kn<%oNj4Wf;w~KX25zIa
z&dSdZr}HT#jSNy!(r^@{q#=rV=(b5{L+UM>mxgj7;ER|C^6^Be!dVi_^i$q79*vm2
z0n5oyH5D_uvK{cs5OmGPQLu63;Uh?6GTGzoY_)LWYLKDh?JzCxima}(ilnoxmquIR
zJ5e=K--x*aom=`@n($_0*X*Z|mc9?!lOFmMQX`W=;(3eq7T=NYGxyZYSncH{9ZFgY
zrHn+xEva1|K~jMzpsl3J6XQI>*VxXts@vITqGF&SzHqHe4i|{aG&n#w9CZAldPmKe
zvzHrnXrH%U<6O7|nQVp~{m0W&I`21HTxlAf%nX(E^hvEKd2AA%Pc=2Y#=JXlPQ*IE
zF@H_dv#2RgRsY4*_kI|93%<VeAo0gZ_}M_Hx8Nxr`?SVzh2^YSl!lu{*t=Uz(d4h!
zi_U}v1_vLdnP)lp9ZP50(zZkE%!xV$Z*h5br6x6#6Zt1pFD?(|G<9J%mJ{8E%-?=t
z<EBIJ-11^u0?P3Q+(5~_oZ$hpv4@aIje%~TPiD02VHAIl*cL#)4SxLY!N2y?6H)5a
z$q;CzZnqCwC6by^rWly)I;9MB<KoG3HIz$NmS@f9fP>0lHg05QvX-rFs{JB%7fa<p
z>LzC7!oI)_VN1T|i^=ry#r-Y%-Qs&w7Tw@2FtmcrVs|f}iod{k1Ox51I@l_9r6C9o
zlyz)kh=y=uE@zz`n%w|*>=G8sU(R&HgYptTDVb=k(n+n^7<sDr?OT~U<9S7$NzdC^
zx?hF6){h`}*N3zyP6pUFg3L36?;v3rIPgnS8MI${<h9)PFK4Z3@N2e&tzzByseXTb
z`Cv&J;i?HEFM1sg4xmy7yd`^}BnQ_}7Fxo`QMNEI;2r1b+C{;AW8Sp)%$Hrj4hK>~
zyuoNxz%&$&?mcJPSsn&zM`xZO%IeC<U}&98_$VZ0{E7@hV?-wtjEE#?$!LFW>hO{Z
z;ysQvL<r#$j~=~Aryh~XJI*%c)U3LH!Gbx6MC73Y+jv0<-`8kRlr}{i#Q`LG_EA+m
z^my~h@USpp<wcUrjRQ$mFw5%qb!0ODG%WK(SbLH75bne^n2(M0PFQH@+JrEFH?nRl
z=bQ=r=?Ve9u@Ga_#KZX9St|cE%mOyPrn5FlU5TX!KOVe0`)Y<zL}O}VMs@DerHNI|
z!ib#lR;uv^Xa7?DiTqHo3DM3iKe01_fNyMaX~6nTq`&4s3CM7rVXBvaFhrj9L^oWn
zCFbUx)7?1$>k<Chiyp;Wtq$}h*c^f9<bM8EBES$L&ZQ(b-CdCl8E;J7bI)4dK|wuf
z<w31uS<Fwm*Ll@g0v2SQme`#jamwG*aXJj8_|ywT&Wp23gq5y<wiZPaQ-Xa;J({W<
z;^|A&EZR134-y<&cE`_r?ge8zk4__Q%j3F@n6oh(7ZAE>RON&w0Y*%@3t`;nm9C=I
zY3`R3IpEabWkN<HNAKEocl(vDsOQ#xdB4W%WysfiuUy?4iFsbplUlG+t{BCw?7cWY
zG5pW?{?%T*PT0M)AC(j&DDM?%03qnR?K!o7nLz}kEG0%_>P)X*UCMC2`g71U<x%b0
zwiR8NKnU1*Vk>r`M+x$sKdYZ%LYfBx?c!)X#{WEoKJu@>Pn_rki$m{8c7N&r;PdZd
zpE00=)6u`O;+>D|&e7C7a@QxW>pz7Ma#aQ65@54H)7*JMTsRn+%X5EpIGrrLpB@(T
zb~iw8tKk8N#7AlSLHqUu!SJGM=#LZKTyX9=Zg)9?^3gOaaL)QeiQ)BA3lL=>v%rXQ
z3n5G<x``9+i;o()q3g;-Malvo2Gvf^ap<cQNHCZ8N$@?5h+C}K`4Cd2$O%3@?@r#l
zG`e~u=ScmVzEV>)tZ3GY0}jmr2Y{ShR%)Y>Dz5)k`#*;np|8;4OO1B6SBXQKcQ&0J
z5fOncU6>vV)l0AypKW*}{S_aqI8h>CusQ8)8n<Z=@ha=(3YMX<pU&w&lT-y-4KnQc
z^74;<SJIH`w`GEiW;!lIwQu(=OaYARJLVv9-$vsR)Gb?`s5HTbjtD;}l#+hgB)bDp
zZx$A&Kl`yiDysdo;$8^^iOgChg{IcWhPN<8hErZ%{tApCa=hYV4eMUtnp(@wTLv}~
zE$_G0WVt9z36;-Y1D{bu{*KCOkJMmEDgPChF8$JexN^Ly=tIa6GzWJ)YG!!$%o+D7
z@qEx3@1-JZLS5zp8jI6ZZ6$*(!sZcxpy*D--f1i>7JO9lW4pUn<O|wQlA^_y2rjfV
zw5f`!QlP8~0ZXx+qmhbAltsaO<OKjmPSYm7UF)uDaqGa=h#K%}7Y8IEfpC=NjD+e<
zQH}46#7ca@9DKfoXSz#$K;s1!#kXDOWNN6LPNSZqJOhO7WDJ!zTkv6wt#VWEs`nj0
zRz-_bmwK{@V@cBJ;fbwqh7$7ZO4JWLSO9R+<3(E^R&xO1ZTXsOvsN@SY?wlb_C6&p
zZWJ@i=02j84E&cdT&OPU0$LAmHeM@24+!PTj<4B4pHw*}USe)uU$=U1mb(y!v{+S!
z{T$G*UrExm(#r;B*W>uqNDX9978<wPizeIKr<uoFAy!(k;@gjcC#a>(N(azCHgR>0
z|FhFRT+$#tDavGrfdm))C1~$Y1PJk{CQyUWXvJ5%BHM0mvnFn{$YFqE`i+i!F&SUx
z#__o`=|pUr=Gqn~!7RuZs1Y%!>FnD!iCzUf9R&Wa|7w+|Sg%m{k5gBAO;AfoS?>Qw
zgXDH~_0-Nyu3!;FENE`uVzsOwA`o-N<TX1x8}e}qo(J;4bETKYIyM~I#gZ4%iu8jC
z7j!RWv>VW!Jgo6)?vsokfiK1S<F_g)!FJfvf&<`6$y0B@HgpoDPlIAD{2b*|Ci4`s
z5?yB8`QusaYr(ilI6zt}V-vO3{jWfWC>i$dz_KY|gX_%jWsT3tyMKtHsOZNgx_jJ_
zxfH&>!F{SdIeFrL3x(?bS3%N=b*_lU{iYfyDl`p`8Qxq_(QT4F!WU<XdI52izmqQw
z7~fVbfM73JBPKiJRjx!b>L6Q8V1?;YWjwlKdkX<JvxNzx>RE+kOp2nPVN9OcgTjdu
zh^EK#QN)t?ChKGWM?ws=jvPqFmUScONd;sQ&`i%9gqVhs=DoxievH><3J{AQArrvs
zkQ7ZD9H~waK_H6UaOu*|ep|N4-9&wW;rxLdf6Lpz>ACaf$q14dT(Z4XH1WG`)}s=;
z%-{$ECwDog>N7<|+Fjq-B+lW&Y^*gw4IPrt_zW5I^T_|49lQ4?&Feu-Hnn%yjwEW$
z0<SY%xM4>gMypd7v1hHiK=mzHsJx=$HD=2h_wRpBdT=Z;QC6`asylY+kq2h3ioqS4
z38Bq%Lj1BGWS2t9l`hjfEyOH4m~h)WZ#!t@cT3pf1GVF8fH<ps>Ghh$Et)}T->jLx
zN5hUCTeo7|5K3i-a6m{?1QRX>B6Fmn%8%!ydE0n9z|QVnOp*r5J=9kr8ToxQfC{Qu
zyn1!b`HZWxPRx;p706{h4=oS%g)qIeSLEHIRmW&z6SWvPR6II3KNAAxl-mf=rLP~#
zTSp~f!Zew9#?S?O^=ciPsADI0s+&y3DvO%ntmaS&?mGI6HtcJLf=Cx4T?R|OLow^b
z))4c(`puX>tEjMNPaXJr%$lkICP*>gzA3zhAKT;bUX<ny73`qji@)|bUf(QhF=10P
zBX8=sQ#LW6a+=lFh%!h9A}A#-LY{A@At=BE_cM|ze5~48yLaaoKbIjeR0pEiRXJN8
zb57)cpa7ZmrcnX%r|dcY$cHL*2ts3VG9|D;$+s5rQD{FP5INH-zV%KBUMwf(!iQ0+
z`9)ki%TGXi%$jdr2WdTtqJcYt$UYC$ijh|k8e<5vzt>IkH|tt0=J&RLXytcS)YaDh
zIl%9J(<Y|SQQ%p_JQu62$TBhFnTS}H56ei-2Husa+`xI5SmG-|Zoghoke1;Pg)*J*
zGLo&zWPeAl5F@B3TWNPT$s@ZH5&H}s+6hX<boY$kt0%gjfzf<R^FVH*sQ-A$rn~!4
zhDoZ!mp4{#&`>02)L-(g`66cx7s@0Y=aE1>`|t{@&J_Ese%nEb%M*^WD{1OB6t6P=
zZ1sm@$<wT?Bx<OfjimG$f_WYIcWYdni^eRi_;wK9uhG_^ir6b-;V|LytCufdR=lOC
zV2}ss#J(j1_Fk<vodR|G^yvr+PgtH`i>M4iI^5^a2RCUyq)&+XSlDJK^mU+xYkG2R
zJR=#X5W;`fxhLig+H&w<!R)BZkO%U9$Q$sq>8pC6(-@|y`g1AH^c=lOJ!8qWVh&Hw
zMAU+GjVAH12eDfU)F>B&?g`nzj3Ht5IlnH`L_niE7b%OqTjSiVW>cm#6C6$Tj6s*>
z=c$q}TsFj#>586{AH>|4dyS&7PntM<-W`sMr@T4<tpHFMcDg03G5U-8Y3R~|o}eh^
zTmNMP0#a_0<sfE9@VWmz1><J{aau9I|4@n+=pPCe=9|UnT*3eGKfum@NO&O&tlURr
z!6A#ko^1T#<z)#E$C4k>#2{Z3<uGL~Esgb0UK(+&a`N-D;8|(8*q&da+it_{>}+e>
z#X>^5FpVK|8s49|(jh1cMN5tD76FU~P=$+2;J0<_d;QpC_CD|#7Lb3Wcg!5ES@&al
zWzrL-S0ViyXh9xw3NT;0WhDF!{GW`A^O&;$7?4hYT`^bSpVggpvw*LRKesK~HtpO=
zKKapO9LZ#vw6oCHw=CI^xR*MKfL21}KC7>4OP5XSp+eIp*ZhvP?X?!m+^1|0r;(38
zMFfQ0U<6PJf6nY=mCkK;a(6dF!|DH98zvn{z&hgF8<1{LF~*%|YVQnVunJGlY``4}
zE5vhT=lQ_7@Lqxq(arAk>>hrY_byR3&qbjrtILf0yO2)i%o}($%>uF)i+9l=u?Is|
zU<Kxj)faEf;8MqpL;pvw$_xMi>vh}xo%W3NGa$J*!&<;LSbL>b)9s>ohU(tThnqD$
ze8UF`&jbK}o|!Q5&^Le$Q|lkD>kl1~ed;JW;xc`^o?rkE3XFkw`-JCqw61B*Cx>;e
zZ9uJmL~I>*?aGSI%^Ms~8wbXH+s5`P%67@1hj0C|Cc~vEc=d|)ehA5R9gg_a`SUX2
zr1FA^gosDmCvY*HKsl_HQC`P56uYtRgHzx(oB-C4<icHv?3KtQYwvhlfUn1UT0cWD
zB+Y**;?*2)a<}=PfxAm8!Z)sLaVwS*FOaf{x@Y9-uj&9TBMuyYnA&$DkMkC5#%L9?
ziG#U1Gk14w;E8rhBru%caGkJxkJ51(R{iM8z$r0IgVXLtj166RHsgV@>dxk1Vet^5
zrAka(T~{rxrr@_C`XSVj>UM_@^_1JsYlek6L^as?=d-*wQ7}{lwSu2RnC?aqvP>0~
z^iO8-57Vn&vt|@^paf7-(ra9H%K8ihbRvwbL0?;V@lRXwHAN6(!8Q!<q6(G$nhdv5
z8;Bd*-a(ENg34~JM$&~QAK#l2x&m}GrsZkm_eTjJgP>3!5H%SHrU3rq!gb$^r9^%{
z?Ypkx*Fv#{dK|XoH5h2imYXe%SIBB~AR2V#LhEruVVg*|N|eqrnMPkov3a->l>G}p
zmF*8LPddNuDsBy{N3)Ow=2I1_N3I^?4-4fUdevk2v>v>2kFoW1%qhZUI+BP)+xg<4
zYl&TIF$JT^<;-j`y{8xoX<nlyYIk#Bp9o%Q(w*Hk(QFvI37~KPZ<d(^MLeFEL8Bc)
zFGKX(bcbYz;GSU%BQigT#P0FqnNGFIdX$?-fV@(wAa66f)N}kukx_9&(WQue2UM@$
z#q`Ih;^~+AqWOKj$wRjf<E_FE(lQhYG%W<86^X`-KcH@RaGYvqz>+*x2!UwB?@_qZ
zqi5clp6(ad-0I8A%R+vDdZxuKuJjS7f#*JFU|#4HKu}yk=>L1KN{biLrt02%@xvoQ
zR#%R2eFCUB!Y<zW#e@faopm^XQH3`=D7;R9A9ilzdq20la~*~h|6eUYOGuLWAQ*&S
zc@T(c)kUp|kdqkVBJTlhL!+W(k1;?_ln9h+bJ;b7>dNp&i*M+hQ1%FSot(V%?3c03
zz1%KHC$-2N8QLv{)~y-x4F;<Vj3H1Ob1w_mPXEBs5V0cglZ$c<b2bzkB{&C&y6^V}
z%2xjkMTNDT*qC@Ef<+i<S(0IA_bX{ENlJ7`0DkMQb<H;1{yM*Z6)F~uVZ%C8qA{Z&
ztIP<xp?cG&H5P@hXuvUiak;+*s2dU*Di{@Keh3u#4<{!zEQ{nn5SkinUjM|g7sUgr
zjT}t=S(?UmmHW)x96)nvvoHAPics|_(nhp;3xrVrmOm^1(lmC(UjvzKq(|#h{-+gm
zD|`bVCm=A;@jpej3?tCAzJ<#1J=yAP{;xiS1#AfRiK!$0)BqCqZ$)1$hEbj|rGE?I
z0vcz0(@&ZmZIjPPkVy6k#Ig@a&MTjTji~bw-->$#owc;eg-5}Q{5dhJVc67q<~-{_
zJSt)Tih|(@q~)6W*#!R6m>7K@Y$|&SQJQ2p)hiz-`Gp%aew(h)i>}kNqZcmxt)2W(
zYFYgIc=?-P+9W#h4H;xn)c~2>P_KaSuxw8Mu`JGRA_bH`kBS!v*FS4s+=dS;xv}zD
z5!txDxB#18)1QBi*uN_(%Axq?qVR+&?@8=PqfHE?HnX+e7kfvM>9X=2)3%1~=ofZl
zoh#Im2mv2FXpfFJaE`h;p^8HUPkrIp4?8M|(hMS(bXcT^758Co@p5bQ_pr<3u<8WJ
zi=$Zahd<BLl@)ol2uoJH^l#R1j}<G79Z55lj+!7<j7@&eiVj_W=*DQ$8iO18qm(~S
zp&S8aZM!^hW(3{4xpU`Ei(dAZHG}xyV~n4S^{(EDCPf5Ntiy1Bl=TpWRe1O5bRq6g
z;1QrG;$!C=dx2k5Hk@+e>AUWy@SqeCG(It6CCTi{)sNc<l?88!1LDG8#3!n&dT7Cf
zrAU2bI}OSp$UyX<In)VN-@Y9?ld_q1m#pVPl#It&{Ih|1Rx8I19W`nnnpZ`fZHO>*
z&DgKn1tu3lvcA%*oX~=7emhb~*aKNCP7}-XqF$Ghw{KHZ_S?H1s^ZT6C$-hC@4n@U
zW95j6F<)ATC8DlfvAgqnPnLwe0lpKB#8Q@e6u>GLCbI8Md!kv?eu$H0|5j3e!7<^r
z)EOkt;x1Y9_=$}?phu|`vANirjBHPf6#U<sj>(Ysa?Rmnh%6N!Ehp{Wzh5@b%CIH6
zRC8((!tssl?3Nrz(K~&dU2ZQS3<)dE{$E$3Q~gMty)gHnCi9@n&$ruxw3q-!S>FpW
zMc{y{bx&UUqsSe{G#vz`3-nILmu((YccO<ES6l>w8(=TqeE48nT+5EFt4y$<sTA=&
zpTr-pWuOHC3-w`tsh)$+r=*AlD#E?;>+Q!{t@cql#xyX{JEFAJnu?-H%ewX;rWmSq
zfOa#4w1?@_{`f*Wew45vbPQ~-hfQcf`|Eqixv2B##8X%?B$KENhrpA1`77^HXxfPI
z&J^Q%&MP0j{Qgbu<vQ^6GX8!s>SwHB;GFam#o%MmpE#kwWSU+&5Dau2M@0<hC|i|~
z+Rx@bHFBR+A|@GZoHhod=4>CQTHSQQIIFED%g1%HKi|H6n>Nl=;>?qufA+%<^oUeJ
z(COJPvz4UqqS)a<XFY#Dn<47k(e$kaEda{&U2|0F7ozuix>m&xMo@4p70yEQS?$Lc
zA46hE4=x6MFo$6a%mU61H@VCHJG7cyYtfUPf5J(}PITcDbLS|M{7K3)pRJ7gYwZnm
zEJ8xLd-vNQGiP`1^kw%e-DtW45KavL#ece&6CV=Nfxe%ZnLfK5mD*hqHMt|#OQf2V
z=N>9iA4^Nc8j*58s8#w*F<fW-Urh6pDpGjuT^lZ6zId^5^1vg7msbUo`i0j-yD1w7
zG2D(prvRn~P0PMX@(jKn$^bu#7dyA{VZ0I904XkrK|xdE7Nw+eKU@n^Yx*sIgPxeq
z81T8bSieyoNPi7MA*}YHImye(Ns<e&AnyQ-6W3MrPuf)t)6g1kyjE@rjUIdC2;=#8
z;TJNabLls-$Rh*Aije6T2mm@P>Q)f4q?Y3b$%q*Ce1%A1L>z@~0`mH{UCOv}f#PD0
zfcQ^VdQuP3CI&+8!0^Z_@@?`x$ids5`o4u_eyfIWezL8J*<~N(eK~aL^siOrJ*PKp
z?b`<*-FNT~46bIuJ&D5r$j-Z_c(-?L*?DFrt)Heb3&ZaPJY9IvIM<S=y8yf>>$7QZ
zz5engn2xpRRmq0pD8`tAc4FOP1}Uy$4bR-32Zx)co7Ljl6K!FdWKRZKW60-lP9J~X
zLHA}ZB2nzPb|5k7(7X2z`sh5J8_Zk7xx-`zLi&-fT*%YRM5O>Ml`GcPL)e2rC-!U_
zgy4f{$>ZQ6W7a*4n@vqYhl5UFjMWq)#Z(89w?sUOgZ#(i#{g;M6V){MxV1jsvT2^V
zt#1LvtQ353Gl$SS!(YQiZ@PN$RSY>}o|_w%obP8h&c!AjO_2EN{QUV7eP!Oo<qNVq
zX~)lO2)<Ieed~u08Res^qBjPq*(tWjRGv32X8g&%gXd11q!`=k-ws1fI;hQ5%xtpK
zspa3-l&+n~>=YEPmKUoPP-XwF_VvD6Q^Qzu$5&$(-g9#Pd?2Mmx6cP^53FjySA^`7
zNvQX-Guw^Cwn-!8f0g;qrV}m4#pJFr{QB<bX`K#+EjQht*mSx<5drB?uIr=Ls_D7l
z3`mQ4e0u=Z2I%%#B^D+oS63DKwBV$kxPM0nvLF7SId(A8c)<LtWQFObm8$CMn;-(P
z;^;)SqFi<Twqfex#i9Wpj8p!>vlg2F>?X;+!mSYW+vh-JWOQ<Jd!8Eg(8{&bw~u=@
z95WLB;8jk5mwp4_NUk@*``nHmUAi;}nu?4&>5WH^>C<yp#s#N&*C=tD>6u-H_bUhQ
zMV~p-Y25Rqk1&EGJ<@iEhx_yP{%C|YutTq2LFAAL4i4!r=fMj`pF1ZzTyXGlS{wA@
zw<sUTj2!*L%3cH2)tffo*tq$|^&Ir+QOPGx7{NCJWH!^06%P~&n&HIToEI<JC<iqM
zn3{F_RmB~6+~?GIW8)SiX7TmCpcfDk9zLE@aN+|L-x+YZQpOw@>(?7rEGIX2J);cB
z(IDk-t=txgfD#`}V{#oa_awnWl68!ecm%<l*{Xl`4P;E<6>my+Qyzdpb?jIbUUYku
z;iASKI()e01Mz;;@H&;5+i*L!%(P0QN-7=ZB-TMY!-;laf>DO2F-e81*!IA1Rg>C;
z<HuudFL&+IrHGQ<>&NF_0POy&53EQhhi5G>^&EwWyFGCALx%Le5Ah|7Dm_Q_LOC*i
z-n_oO$9P?}USF{geZy4-jTxmKKW9!)xJ=Q0YEM~))5xN(3a&$yg@r^Dk#Y0p(T8sU
z!typ{Xb=s_DLRR)81Hre{(Z5*G9Gb~wcA&jUcwA?3;Hc7=5;g2`x^3S7||3S1H=36
z6!9XrKh`xL!_{DJJ=z`_nd763Bfc@U5ddVn%7Rih$%xG1$u56JxyE)JKf}^eUL9N_
z(qKmd6YW}vyWYq$%`*4)zDv(j03kK_iI#_XyNVq<zNvm@zhcF(k;a;e7n+V$I1FYK
zKWA$6S8v}ob#N$LvZCFTR~BFsO8pm3^Xec6f)JMVr8*(fi_&x3(A5(j6r*@EqAL)r
zaG9Y@|J2kmqO`R$+oIT|3n~!LU`0bNUh7ves)^J{Z`>7{*83|Q_Ra)TNCA*$uuLRV
z<cMv&RXttHRico{fUh~W{Odj%?$Q^O4@S<q`O!n6%n%w3QAH*cIBK9xR04kI_AepB
zQ()nNx#+yZBGr?-!8D}QmLy(r`x2#gPliM$ZctjE^H2&3rbeU%dGM|Z?t~CfKEqs+
z`=SkWq@_iWa9XJCwkkHMD)*f26Bv~k^eM`3CMSK&&(9ydqC$7{=pHhTMiqS$w!G))
zm2HUBpL4oJeIEYKczjs4v*lus=Y1Q_`ojks1^52-bfkn0(&x^Ih|Lu9eROr(q5zmE
zHixZSH}(!&%s-v(wJ<5N1S#Yx-(PER&01z15P$smqFMhRRsR9cb^rGN<L@MqluCP1
zk(Sb)LL!=^sYyf8P-v;l5YduK!$?|2C2bkS*`^XDA`Rti(4yscKRQ3x_ka6ex9j>`
z=jSZEy<X4fF&>Y{@i?MwSFi5Js%V)&E~Qu{46@+Th!PkIDumDA?pRD};P+F2Hud9V
zB7p<NP#Su$_(^ZS&O~kzl{Hj}xmz|p(3=oJc!~S~B;0`6@GPG8BuoL?*Dg^qJh|<6
z-1iwB)kf@^7@Nb$Ds!O?WY`>=7ul^_b#-xFtonC9yW4a)gVx8~Kb-o>J+kdPSe=uH
z(@Z4Qkm$u^A3g5KUp_v+cH<3EVC071{S6IG_;nc%n-DmR{9TRxiS_j90es}Mg>wpy
z<~p(}So#7mR)1;{aoJcucQH;!kG~q>7XswTLg=%%TTUc<O1>o(qOWNO`o>I~7nLz(
zW@CQVz$w37VvrMGmXJW{AhsT~kIrqc4H5-d7d<_Dz*v!}NdNoz<LnKD`)qC`9yC6@
zMtew4T#!XlDOPtpR!;|S{gb1A#r2h8t?_RE+Mf$J%vcG8-!Y8|zxMx_Sl$leOh7YY
zD&IRZYzTza;6EJ>-&_FBuEc$4chKKh+vCVE^=NP|S>MSQ^g-(dARm(W;FD@mTcAep
zUJ1pm`a5d!z?0|}5N*8RXTEy+T3zYm5@%--!cj6S7%7+&p4oz`2>-x)6@7<}BMGh_
z7qm_>;)Ror=32ETW;Fqb!Yh|;Sl5CdkK<``BA5&noa;~MwWUNzXBw@?XSbFz<is6d
zXmHYsYSmwL4o(oUkSxBTJ=4YstEv7bB*z>`9lR*IWPY<LcO8nZ@zcYJBYF6BXwQ7{
z`efL9!<E72+R6Sf6%Op|*d3fbp5f3y?)eM4d*}9px_55?rXnSM#f4wyc2$lWH;!Pp
znO&F#;cL>ADfLRq%o{FT_-g8_T%A!{lJ}o@@aT~*^~|Hkk28p!^wb&f!9!<V1IM|3
z;|9Na2<|_wzeajyqbIBfkd%h|!r+1a<QD?p(-WFZ(OTV%f#ER6V}k3a*|B3N-|$3U
z(%!w()#ux?p_Cf)SYo0D1N;CS7xb(c!b$EH06L+Co}vepr5|6=u%l5sNK??AxTa3S
zZeif425iWXX+x>EDf(;v*e6j}P?RF~`F_K}C~Qn^k6j{}piqSViV0b4c_d!#$f=*8
zkzI}-oOmoDfiD|`5@#C-HK4f)5)wa3KANA#T+un<|Flg0w&Bb379Zh?7?E(SgfzO?
zqSrG!r}qY3yVgfeJz?yR6~$N5`8LP2a>+#E80|?J%5aSr#lG9%)BC0|w_69^CXGK%
zLKh|a8CuFmHT8zs9NLUmB~~$=3=A4EjpBT)4bdr!9wiC)DDsesBpKW;n6raDd-zUe
zTgWH;A%&qN4bXsi!v0xmEbPZXY9<hvcq;_6m0ZL|D6I1<G?|P5XCY9nto^eQkX`IQ
z6`tVh^<XzD9(*(bS%RPqq1lp|Sh4j1&GdTubf#oHEEfShq@|K+zlLoGp2~MU(8;4c
zMU3RJyV)8h$=t5Hckg=C9`ZCUX?ZC|d*-ZJ4beLiEHcrENO%J;SvR{yl)oW_3yO`#
zFviql#w@!AE3v#(@>MEXrUke1A-?U^m`0875w6|9L(6P~srNA&e1<9lw5^!J?i5hf
zWQ2)kJx`DbbU#{v-5KciGs1?Hm6Z|Ef6p+rUXh0DF6~ezV8}cK4Kr_kY7%c5P04~&
zX%;XlUK2MfnyL-Y;^QGN<oAqp|HB#(2SA4_2HT8Fx>1mAAq-A@-H3s2FqfeRde#hJ
zRIo1gvj%h5e!R)oB%gHK=%n;EE@)Wo_>K$vw37Wq%*M+-hI?@zs&?2s#smbv_nNkK
z)9BUk-)YDhKG5~^ZLEPJR-~q5`1JXSL(jlLR2al=7Id0%Mc_1CFaZIm0Vu44drBI|
z0nKA$?k$t)rcen>trMV;DIo~%9m%>CRZ8woYSDCbvWc6u1tBzZD3R;QC>BTOa+f90
zZ)r?<3qeJpT*?2<3F}ilC$K*a$Wn*H5fS3D4>YX9LFD@!wmgEcoif%NAw=HeIcThR
zhF;t^W~`$nZw*#NsB{RU)&LPQ3d5=jZ|q0D1bl7gURj!1|J~w|g9f#v9wqT*5`B(^
z;{7p-9Qw5#rM0->K%iiBw1p(f-W?@w8x*4aZtLS;s=%3V!5xpMDG`aNjO0<WF4$)}
zhVHk+h8Boa6@*fSgC-`~@NrC<`EVI1@*nG(Oqf2sl_2GGW>542&M-mhhcko}Z-h!2
zB$mK}I<O7`C2AHo$17;n9KaG7mbi|$w=7u&MLK(KQAVve)^W8&#zi|WwtAu=y#H?g
zxx<^0CCQvAa<Ed$JD7Igm>7o$Q#&vxkcZK+-e-(h%j9!&fuO|Tp?*<OIshJxxIe%j
z)E>b>b9KC)x9Yn<m57mkuI7SHz?pk10y*p}{XcXG7}&o*%I9{}2h46MQ=qBa*%dCI
z+%amg^~{+K$YV5q_KZD?D2q`lZkg9@D(rdOZQMG`t<`S85o7t^J@IyVpAotyS_*`2
z4;@llD0xlOG}#?WWj;G}%+>8k@}OBI`*N{Xy^0nmVK9k;rwKuaCA9<nOYW+uxJ~)j
z-g81+XU+-oHZdp!9%kv444izr)ZcWFmw8M&llk;5gr~n5oT`P)CA(d&7=#*^3`PII
zuG||y;TMh8aGU^8MYNjoA^0kDWzrDAu$^6Yr+AFr+ZcMTf9~IpGw6BtWiI1BE#fQK
zYc54D$IWAp(Fr<-gnI52GpWy({Q|fzrAEDgz&dg4lIB#NkVz)v$H(VsHPqV`c<h)y
zt)3P@y9F<ZEI=dZ1I<D`!oH=r(Gjco3ad?&-_bL*doUnMDFxmc`BZ1KrQSldXw)Wh
z1S$7q#7nwyL?0qzLOOr>*M8=6bx=|mQye2nP2<2`?muUupYDzn-Fqm_Y#!*3J?2n^
zSIH2*%m=gC77myU+C1P^cc&mYcE8E#!&kYe+Sq>Km?r*M6p}LS521|0FKODL+7!Lb
zf4*;`XK=d$Rtx;E%9IOLACda7)g3WX^v(J3XkX;Ti>(pf+S>FVyI=%+Fz96(Q^3vH
zlfRIk1eEKI2*iO3joqr51keWytzD^_lFptj+w0MV6=o29BHTvb3oDmF&X9tb#SI(X
zd{)t*(O;2|>JB{^Ldq25#}Rt-j}GgM$_^xDKKQAS->{jIj}AR%ib@|1M;+NF2~a1M
zBmJfWG#iD8*b_+tqMs1uqwF@Ab8XW$s%e6(XZk$ji4z<1^m6j^{kije`n5j>G^yT2
zbs{%|%rnb!*vW*1*ZZ}tcCJ!W{*V@*ADRdv7lav3RAi)rv?^=Jo|KF!X~k2Oy>a{k
z!k#i)ajDK1Q?{a^0#mPBw=Mw1=S%HUqLDHpm6{WtJ73l}(oM|?PjA6Lj#ai+iVFIB
zZ%C%0GYVFrS)f)fee=ejHhh(9LROYJ$Y5J$`q~|g8y3Tl2U@14l)W?$-*;ELV#49z
zQ;4UZ6xns_H*y`k!zbr6Ly*^LHjj%kwti-Iwtw<R?Jq;AP_<EA07kiN{D9PkJMDVn
z>smWjA-4q$LGj+oE?f7P$hfV({95tDnNbaToozfzQ0B%=q1#rKgHIeAcp1q}tHCSh
zos6$Qa6K+|3|=UI&1!z+7fgX(>jOvh3%L1;LG0ul$Nr)xCG{9XYJ#@gjYuHLQv*qi
zh6ABrlC}YOK#K;SLS*gFZ@p;nC(*Im|DtY-L@rWZc)qt=E!6`a9$Dll!l*x`qU_P=
z)34tsMw~7`Gp`06;Lv4q8WFatfZD7|j|;-o#-8exsQ6FI(D|0HdhR=rw{_T%A+5>F
z(ktZ@6sVTeCTbi`NnBh+D-xBEP#kYIe1dr6!e)C<h+9*Akx@xwKm%RB1`Ny<6tv<x
z@N+A2mrUQbZ5tH)Xw=+c!O!;mLIyKdw}|q<9(6wn#}5M#xmZ+p_ieV-cu99#X*v#O
zj{$;D2(sPZy*W9o^0<B*_C+-BG1b*lYXFTE5k(qAn%>pN-i5x;0A^^+ke*B*a~uSN
zK{AJzOwNf<>+m<{taaAattW}=`}eLdnuhcFWG)i7{{X>kkzsn1vL-s6Id{$v+c|PG
z>N!8)-cH)u3hKvsefKGh5;lT<HW>M*y0fm|JLu{<UTFhcHB>oq@+7m#z+M_5_p`St
z18S~PbTQd&T+-so1kH`e1%!B@77#NVNPHjUC->j!d~xRDX&^3pcF9ehT_2Lpz%Nkz
z)wpZy$XUnmVI{nYtjZi=aC|yr@-rK^XwszAZOHqhL`o?g6K~H`2g1_t)$5g8Yh|Um
zf&y}#j%1IS&sk>D*pD`ayqo*_#`%OQ!gbWCQw=%E?IL_SN+_at5Dh+$oQr5$|0X37
z?$XfEzO<V2ITPYVo_M>H>nJQT>Os&7T8KnU>K<$b8>{%FS3FQvPFTs5pWwO`$4iM2
zvSSETqF}wtPYzl@Xs87TqcE$BYcQgl&YUaG?x(7%AOBVg)PTuo%d<1$E8yE;biE;j
zY<BM5vc>%TgxlQ-v^3CSs8nHd$(I^M)Lv3j06^vWS#|4n+`aa0PXmK2Y94fBzVv^k
z)DHRv2Ide0XljCa>iEj2fst!6t^<w^7qAVCFcSsY{?M?cavF<Pynil0#qQm{Xq&+8
z;DYNS=rhIkk8R+N1BQg9wKfX7WhWIP)!N$6uQl-A;+1a$!7JgHy0Esg6aNNrdR>M1
z7SgQ&uSW9MDcIi0egVjms*PQPNr~u6wP_21-j?LAMx8A?1DNJ4!<^8cw5;nVeyk&`
zx-fl7wV|TxwQ2qBn>V9u`ssG*BHxiZluP&G=f^(Z^+Wzo3vjJ=+@F7spK;+6llza?
z22EVDe7QN++LF#_*uDg4%^;l$V1neX0AU^$4`OM8C{_e+?~NAE)4k5Jiq*E73w1ho
zu1ldu`blRJQ0za6ogiWjAxad|R-u*mLp_Q#@dfTLBTl^6zNW)2C|;e^UC4Px(dN<v
zUFa+I1`a?HDNtvsQjD%;vVlqyCAUmB_G#5n`ZEv~DI%zW=Pg~jmGaJH^k}~xZcW#B
zY^YMVe;W<HZiKm}Zm-uQoQxhO{Q*tE5ZMu_iPqPT0%P)<dCE$cmpD2a)77%N4+)5d
zP~W7>dJ0x3tBSRW=KF<!0Q2cpIDJdcu5NsdyP`~?LepeQ$({cyIRb%B)Ujg$`3sZk
zfs-#SYvyHK-p)+(RcEWQV>bkAH&9@vK!uhL`zA1O$X%S1JbAgeYx_H_{#5rr=|m=T
z*3#!f6;@s9Vmj>j$&)_V?ZNuG5Q~_?bwJ!Emq_%X6;-N5nsksdFb)YJPDG56g>ZF9
zO!blU{Vn5Us7r>WCO*BLedC4>(wv>C1*0+BN9^!V#fVVZ_eRb53GvWo7nf`CkH2#C
zsF|E}LX3D2ynI-A3m`eq&@-)j%-A00dwu79lo^)~^nEf#?lNVfSbWF1CDjFMkq^U2
z$}pyia$`?V?-tclssx+}+l}1Rj`9zsO$$ES%GY;VqZNorNN6M|*_fHMFj#_7RZTk2
z|G%>FXAAThy*m8tAOB@C)fJZuQFUG3r*x!XM?^2~-4Ua%G-cG+?^bgWcdzUYj>&(c
zQ+Ic=-gg*S^{DUt-Xy^>fiX{>Jh2`6l9E-bQc5{R$LHDH;>j81n@93>ZiTj6h_A%^
zG8FsJAz}gbRLku7wauYi1nr?i+fax32ocNb2$H-|nJXT;*!{FiyA;c|h@e8WQL;<^
z!6JkJMV(wyF0arl(E{|7T`^&|3fqv-*3yZ{-V5<UoV#q<z20&q5xq(2BPt>!g(WZ<
zvG>M5^}$Uoe~{XD6gO!4r6*=sTYz;$u64oSVT}E~yy}1w7FP^fwWcLci8fu0M+EF3
z50=ybl9!s=fdfgZUaI4BW}pqi?0IYop4X?9ya_hbpN7kMc6m)>bS{quOXW;wMH?(~
z9>~1;02UBP_IB~gN}nn-&Jv(#e5G6@W5u`l%*h$y-dW8nr^wOS`Q?wH;%9}fu0DM-
z^j|Atz}v8o?Ny(Z@-4xNGpGtaF>K&KF6cEdW&dB)tOK&s;iq<{jo&*?57nCZf`Mg!
zy3{TNCl}?CnBe;py^m4dA!=SbTg6V>Ti+|kEkOI0#qK?OOrf#4a~d=RvX%;5^oGDI
zJf)C3s9r*W>Q*jr-sAx9$4sG@OpcG+XX>u;Sq=LXp^iW?wRLp7pdyhqcR(>9UeT1(
z=^zh9yOEz^jPu7B(EuCYgUIUkfZhyZymnintYjf)k%%>M!7Yvjd91mp5(@W%tRfip
zMl?y3EEs4IwNYZ2jM0OyBmZcCyFjB*Ai^IrZp|a`A%_*e53Fu<ptk#YiMgHaE%mXj
zmd3kXWkx1@@)wE*v6&$Ud<ht@LbE9Hal|=~7Mf^PUr^xF9*Q=eO+*^}8RaLc_yNdI
z;4Vh}{zKX{l`3G;zXC?+_wJp|Z(TwGLj^T>*f0miu0hQN=jq;~$MLpf`!D=`nS4)K
z3aEbM`pd_HPLYAQgwTA-TzGyxQ*tw-ZJJG*)Vy=x<O7KP`PY#5PL%t4>}7Vs|4?ml
zCK`V-6pBgKi(Wdd`~cWM{_%&=R*<XFqhs^FSTo!`;i~&-AHWT+Rej3RdY>xSyrPFc
z79YQ?awcca2i1lSmr$7N|6GxMY1C!z;YEadIo|BNO=Byo2GY+L$-ozvzI_~(JrSKt
zW=}&+PjNJL8nyh(nk}9m{-KU9^f(Zf<4o!(DJkjD*?-ekOt5Kl)i5=s8?a~ojCU<-
zocquh4Lt0G4vtEge!;UMvA)<QB9xu);4mt-)NbZXxyK%PI}^_fnog+?v1tlInrRu`
zv&k2!zG<1h8j>R^bs`_W<qEO^Qvbk#0|<*0nD+v=oNwiSb3rGZ^r$j9Fh`9h#yvy{
z-hg6{(Xs|yl)=no!5SiDRxrhx@@u4~YFf5dF7ucP(pFa8uwCz7`R%=(%*_2`udEba
z{c%Hw3F!;^(ni%)Fr(6L`0(NIw_7@#b{|!K$fNpG9WfGuz=M`s382O5n9c47P<mkC
z><QWu!vyxT-n-M>7>c36(U4dHQh&w3zq7O%uyS~b(T<D~rUY-yt`RK@w$bwvpt-GH
zY5AYNpET|rO&Ed@8eyeb&nU$dAy8krPZY#H?}O+JnpYDPo?QBT@Hvxw8N`rM7CAEO
zQhBLe#x%+Bq{o%jpXM(;O`orc&P?D}kStDL9j2K(OtUIa;MAvag_(*FM6nOnCz3DW
z(|Xz5SM@!V24cbzJjcJogrASb#u8NPptA;S=XsCQYldFJxqbL2H(0{?jGa;9cIwkd
z6Vl!`;z&X?1r(g6U^WO-=kBgoxODbm^2qDgixjmhW<P(rt^JbK*M5I%TYPOZ?S#L<
zwuc9k=m=O=QJlI_o%xvw+o<w<kOIjSB1ns-MGQhIhHOmrPd4v6thkJLQbM4_J3|bt
zWN+<+AS1HIVar&#xZS#$EL^B7aGQ;dY5Qq>JK$eL&5@^1H{s$TFE@q~SR8t8jm0Gb
z66!{inA~IEFOV83Vvls0!l{ywg_GD$s~O$mfHs79gaUx3K-YE5)pBaS2KiH<qzQ2X
zd+ncWZ0y;4;4Q8#z-aQ1wN8mmc;B*zj@1Og@7^s{bgcJ)Iws{u8$*T^LR4izkL>KC
zx3N27#6#_5WYj@mZ|EAK;gM5I+y(nZrRl}M<@pKcZ{5FdL1U+02bM;LJRarayQPHt
z9May*XV2OJG(U3cdvL;=%4unvr52@-h&N(ckAhkSi;z{ZenS&;^YbkzT!~4{=Xv2H
zkil1y7v_%Z`G>vpI?S?ESFa_fxx_z4x5t;s<Rg)b#!l)R_kRn#XvpW$@j4GX-zljv
zW*Sh90+K0ahM85od-v(bSEuexcAtClmfK8V@}se!5=x)f2X;}gLQI%VrcFCPJ20Qx
z6Te3=8Pj?5N)|sj&+A~+AZcx-{ecl1T0qZu)3MQI3hqFe88D)@weK8cDUE>DvcfKs
z>IN4NNML$na>OH5Wz#p@%CZaEU)f(`k9nhvb1CM*icU}U7-I3J%a=K%PL`;d==z;`
z@a&o|VkoKs*)*oKd_BWk^#tOhdcflGpNdt3xA1BHA7b)A2RlvT1E)Lv`@yZ2|Ce36
zCK)7u?GF;k+(`(nr0jhV%YcHR-w<_6YfoF35_0>#SRYDr$`mguc#9S<FB^h&Nwx)=
zr|)|D!m!P@Erd;>aGB?l2S;}q+FkckU2ruij<5|A5|)4_6Wbs`UG{Cyai9UrCIehF
zT0ylMrkrKKFG;}}3guSi_s^qUV20@=XI09Z14bLgJOPMUB=~k&EfGP&2jHOm;I+%L
zbL`Gbv_N@yvdWPRk++{qqXnxSzjZ!L@9bzBYJX5QAC9s62lWqIC`>b%q2P%KbMJr1
z4zPiOkKHC3u(a7c2${jgH`>F!=dPQ|X&p@ZbEk0@Nav55v~K-G_vSc0G7+$yotE?X
z4$HWhB-gLgfql3ZV&L8D->^M<Y}EH~xgULYa&oHt^Ls;|edDNTloYpa-{!CQa<@2s
zQK_kieq8*h3NuNA7-=(M#__oJJ8WiTpD{XPRC_LTc5Hlp08vOdfqwm(31&NSA}$vy
zg3pSRa^N1$BIjxD?mNS}PZ~5}KstyMbQKlu?tkt{{H8OZ@!dj&h5ZdJT0IAcvilE|
zSuugl>#i0L>|i^HN;H{~jq>uWjlvF3PfR@3W%%R!CkY)~Sxgfw)Fx3tqH39c`+NAO
z9duTmd-ZyM_Ws#TEr0+1&CAXB-mO*p8{j*#aZRLxG;3bz^U|0qU?a@o__lPknG6K6
zGT_Bl?H@c2;R`6lC}D&zpzYLeUBpHjs#+Pz<6xY|L}h39M|T;26jX<41_4u`Ur@0M
zS|E+U-MbVL!zWLh){@~XsSZK7j&EKwK!?E80#O-84}Y9T1pBea{`I|s>a5<7`-$_S
zvQK&%2_^}_?t}G*a&*z$yU@4&O|lu4PDTVlGfiF13#wh~<)TtZ$I67!xf{E?O=c;;
zWU-|<)xPQAEC@?MiYR%Q&TJ&I{H2Rq5#eN-<-gXl9`g;xye~e?6$8IAf;?!bXZ}K0
z)yL2M0fbUpn#CSD@|RZIQGCw(R(6tsZ{<(*HBP~;43%g}<>4^=0knT7<@AiVT_}GS
z7w#P)Gh|q3h#{5)Ys;;cgYcedPJz!zM_S8J^m=o(0k+^~$-n6+=YpCyt!~2nIhsIe
z-#N}ALg2-V=kT0xb8T1VavNgfXpgRP*1_{cXy9{Cb}-v5tboYog=-K$7ZmRGP0U=-
zm&Jm9j7x|&KjVcaC_B0A1$qHW%qM)9RxdY2D#uf9zvGg_jP~;v+GksJTo^e1lp)hj
zGEE7cC`<h?v^I}(dLNSW)>XhxQa`&v#$Q&x2jPX;wydo;1!kv;N@7TBV6&hnIsuP~
z+OX~1U#W!s{Vn3MU$h|5w`)GB5caJ#;Yne%JZ0(f<wtF-xqKw%QMxfowa)`;=5`Cy
zJ+rBM?CUpg&TqGwv9m|T^vBuXGOYUlerkd0hfjg&nP?Yiz~CPUFiHm}_)~omL`~uz
zN=?BP<gZCV4YP+L;rHUz7)GPg{CGA$00HDVyT1JQWjnsi0C*xPmI0Cg5<a?L8<*r;
z!h_7be*MVZ?|(RiuvDE<(gu=eaP(Cs%8mjPN3!x{XWyCD)+T|6g~;biWTYY1gxL#_
zmb#pDk$EM#zO{jgF`hOpykg0#t6_pmtE*2AyhANTL7YLXk{blk8=Bp`suAEP8^C!=
zN?cxl*mb7hwxVrDMV>O+rVJ+1g{?9nk0(!><VmXmZR|54&Vg!+s`^jQ*y&@(s?#55
z0*%VjXcD*37F04X9XI;+M)hAiqfI%tK_VO9RUls`o@IR|^8^Ht`YJxTAIx&@<s{A>
z$<#nwCJw5jwQqUrZWUNdq^@w6O6c;y7_j%-_&DQ`v14NfTtu`+EFWwz+okhgfQRYz
zb_acowSRS-pc*Z?@AKzT^l$j|xiAkhXGi43lJ=CM1xPnH)x2uSCoQARt7fL?>2D86
zOehDJBvaEhB`|Q}14ThG_(9as%Rr!a*7SNk!*r0-)!m18?Ai07$=v#0X=CX`$(2@L
zuPa+CR9TxTrbm>eNTE`;MF8@^GM`y?<q+BtWpEtmn9NG$7N*%3`PS6YviT-)j>ng(
zDsS}jBC>|)qQr^J*FB~=RM^Cn<waW|(bCYr({Xs>>&BBXZ5pcTaT^2?BKY3d1^<F=
zQUz9?Y-uozF++XfYEcuXgp75JAhgXw{71Ce?Xiylsc>#-)*Dy)l*&J2?QVL{-6^Z9
zJo%|7wk6Vk<-PbxyvPRH?PfR*lc|pn<H*Y*vZZoEa{D1Ddy1{C6tUbfN={GqLofkf
zl#qP(vGT=`Nwa5fqbVw*Vz|I|3r01c##XMci*VpkJ@+}w5*Ebn+w{Kk*gn4>SnSF9
z@u6rKOi?7EgdRXRK<eAD=%+1En$RKfzc7C>A0Xm6vr7C+Ap&VykrU~kX2d}g+=bM&
ze8<!SJZPfLyTuW@`vfr&OB2@7Omngi+%&ha74VW0cpYRoVi=fD>(53AQjlxS-f&G<
zG%c%ERW0u8NTQ?0pvX^~*N2rIlVo~;mOcxz2Q7q2@wCeAL}bx>&{UF+jbX}ViVW!V
z-2SJ}?5MBV*4tJpJq)tIK}8}*F&(8`38jKP+TqS>t4K@q_w{-Ac)Hc6{-XuoJmp0S
zML#W=K%}@L%G89A#l+?(Gdq@c=I2q|M0J_;ID6utdi<kx#1`a+h711Dl*SNac2lVI
z{O5~@3?3{j3cB!g+J|fFuTbl8!z3DWMzkrJrR+vm$(&41=TR+H4=}^fRzYc7G4=W6
z)9QM=Zie-bgH{`dJ!8yjO;z98$#!<PQwDsyb<0WuE<LC;UyKNjENp0|ofH9}OQ*|L
zU|CVP1zz1hzYdnJNm$9CI^MP5dj~6mKjV8O!UCtE7s1*Dh5Vc07R4RXo{9tJ_P>nX
z_ORtfQE}?gbT}eDhE0)`KYI>dJk|aa-+R$0zY&dz-Kb;IxeS0Y%Rgrf_PPwYl|i_t
zv;@+cdijvUvSk`b8ZfF<fGvuFtmPJ6k1#HIXG6m#Liu7_B*|RpIZ%aHU^%A#7hTF!
zpkMEwZZRQV+T{)%8sTIJ5PEjmGthlTmpU_zxy+$y>OFKyTw@=Y^yCX`_i&|%ohd2P
zWi0?`PMfxEFB)__ryF|ar56bkOVtL@{60iF5gXxzXMH^Ae=Of+n|haf@LDik>AVsY
zX6k*Pi2eKdCmjU#0^w1!g1&yt`8c#<Lm>`Mr9Y@2r8`A9!sf*e2%kTEYNcGvzRw4*
z9$$LzryH>+JX|DF(l7StF$&cdUx5f=D|InfE&0M+kXBGU`B;=n(o<5Jf&-3>kbbYJ
zCC(C<unM3?J^Cm=zw?L@?HP?-eqOT|>H!Kq;K#Bc#%UjU=<VOM|DOnKC`SJcym+N8
z)iJ(`EE_R^aMysWkX+n`V_H|>fj?dSQrt}TDDu;2Oe2BId4wf`;JD2wYC%;b;4v&f
zChy14<%Jo;%Ie%ZNoK?wUnm(-oICIPh$KPO!%$UxQ~{Ui>fFj_&Eozd0iKS}Av6+q
zn66j$dZ#=pXbaMtNlc@D$bB(@LNILoY{HoEW{9Th^Oqzgrlm#ZeHe@Mkqcc<%-v=7
zS5LD|>((Od=4(lyPTxQCr}I~=XiVk6=!zBsUm>m#w4bI{In!-VjsZ2XNG&)vAq}EW
zX^ecPX=WL;PRVNn1^qdv$xG}Yc}f^w`}FObIrt%S1DL9qC)8*TwxSYbH&Gy$ifnAp
z>?D9k`J?Hgc%#Z77X@fP9mO&W%8rjybZi9^W!EIK5zWIXd*7^~46&X&H&kR{fq|eW
zN?yHny!8)HLWN>tlHTEJz$?~`1LZLl!MAKbyTeCx7=QqJFC5wmp~4UJL5KF|_xHI~
z*~t;i^r}<#K#rarbw6UnhJnkAuLL3io)4NP8z)1<ZmIq2gOUXGx9E5fr}WwU$3w7w
zUfkc=fOX2IQr?JYo?q-{-a0CxHB7X0VgMt)j09)Q&~Eb97oBM1WF(z|fstd+-oJH=
zeoo2ml>=!^P9YJ)D(-C~sbHetP)_r`{ek7B#uCZD-Pq>89>iak&x=%ud7H`a-91Ay
zYB2qQCQuf~yC-L2Coc>3^Yw*Av(jCCuI1EK<*)&=?4px@(^S>5<_p7Z({@_S$k4C&
zv$=LQcSi2X+RErm^*h90nRiF<u0SUX`$T0mDX}qK87R;17oYcy(-U)Q$mC2aD5|nZ
z<zuMiqHz^B9$V)Y-K4ZftV{j4t_HA8mA6w$GcVgrZhlWV$am95sl%h@y4Uwf7il8G
z;7dIN9_Qzm(dz&Pn!{`hYel@6hmvEq)#<+UL4xE0H!>z6NgmBWm-zH+Vg)Je8P4%?
zAkL#=Wl&zB0OnzHU_%}$j7>+WzYq+8J`Z)Bz?@HjD0->w_u^RvnSAZ(t1Yw97_dSB
zJ-mW|(7xES3yX!hESyc7n@+rjEFQ3EAQP6o*8bF$EG^Prf}q74(p;UiCoeZlts2gt
ziSmcsuoj;|*}z5FJ#B_y0m0j_t9mBd$>D@1VmeHqs^9?_Foa(&;30|epanMkxMvsG
zc8j_!TMZEbH=?er$o+6@GaDjD0&TCIZSGH{K+W~GiCXljuRlrAXUxsCU7MmpR3l%|
ze$?4!Ugp-V-6(!6{GZGjNTr2@W6hE)s9glp^Vl)(dJj+&fjv<UWzZ#)>aG|Z&u>On
z=ctu{ZX6tXyaO^i3<P};5IA6+AQszp&F-s?_`l&6LH(%FC{dD@7Y(IU-J#yqclmva
zbb)2Xn(5@{Eq;FKcmso9FD%>(%r50EPJ)*ETZe<VU!OSgw=xHgDzM~iHnUkzp3dn|
ztsn5fu|K7WYY&qzlVvQIiFxZ)`Z?}D9C_P}L(L4cnDKUFT6TX^;`#}{w{b6y@nEMF
z9+53oguZM(F<~ndK`7otDm1M!(}>*vyg}E6&}yz@G~+>3m=%y!fubz{wR8Ghjiwjj
zmHTmXrKn!i#&oASodz5s-Ai+hU=Q4YSx&}Tg%JgbII-<lI2T?F#KGeIkhQp9ILg0g
z2(+WL7KAZo=zV|_)3UM{3RXck#!~CqL2oD*$Tn9qS2tNJZ;CL>98DupqEg?yaI-9G
z+Pd|=-g7RnyekWiks%08Zgo9Q6?q<cijS9<iT}NRpR1~pRy;SN;1>P}^&90@cFSEJ
z!|I~fW;E20VFuYC#gB&W^#iLcd|lF&v@OIuG5g)uox0ws>ppL>s@tBW8Fc<pF)==r
z@!qJMKoa<Eoj3HR+j9ZFZPliYECGkl7pbLP)}J=ODb+N+E-;+@lv9%(;NH+-`80K=
zadQF0md}j;)`<1-2XhAS-8cAZ-)fpo0X$@2eJ^82%f-9y{tv`tnNk`cCZ#)L=_ST~
z${Dqcb>CpapPVH$Y-tZ4?phY{l5&e65JZWQknp|9V6j3%IZ_YSKt?I^U#)BoWe&IM
zd2>Nk-cMEJ4;^-B-?AFjtH*4|`9J<o3(&*qTwN6}<LaT%*3AH+Hr!~`5M>O5=$b%s
z$lTV4XI+9x1|=%6opFCOwFN;z<RDbUpY9HN{^`<@Ib)IQAas;@_;ZfS3az;Z!flPi
zh)=ZD0>V?X4xDOLev=Bb33aN;f6RLT`9n-VD_*qs%4tHWR7YTvR)*eAs~0U;AiK_;
zCpO*&??eYo=y)>JAj*wmo!VA3PMiPK#N|z$eL&NU!*7Ub1sG5!yJ6!U&iYWyLWQ}O
zzp=Bm{Su@WB{VF<ohPfxxfRFT-=XJ)wp}v7%@!{H{YQUju0BjZaDKoc)Cmt#C5Q`(
zOnEL02~mxPz>y*Y8pE3|-D66ldY)7YDd*Ig54uS^FZ?6IV3B6Xc6aRG9)FnnwI}Qv
znEogs3V~&$IPpn0X7h@F_pU2<5lpKt`7Xap`$)$6awB`RnVCe8o-@uUV+52zuO~~@
zaA&dS`Ya16diE@s?vPJef`SoefyMw}r6nb4xmuUtE?&@t;XPJYW~I>j$@m9wf4hiX
z;Ykmk%y?fi;|&WbENQvw<n-OQ5uxKFy|xn$wA~meGkQF1!Pu}jSqadYFiR5|U~fT4
zLGCB0NB0z$392p(+8R*(u!FFUEanCkIMc$)u{rJHFGy6HaNU4aXX@Hg(kQkYm?$f?
zeCz04E;0}XG`TEnz9@r(dq1<Ww&o>M{uVs~8*F4Faw*poiPyr4c8HE-A_MDu-@ltt
zos~XHZ*bwl+Qg;3?wb-Oc%1~zmpxX1dLFgt5^%<}bm-IgAOQd*0nqBtDm-|1EE$Fk
zNL!e|>VO4V%{%X};lf{0K>6FbexJ(2lj|(HQ*qxs{cN~sGr7y6Gz$%#7@iF@_E);k
zv<Gc)BPu0_h;rld8cLGPqN4T)X=N4`YbQbZshD;ppVe_4D+Lqh#>K7cD$Y6DUvWcE
z3AxNvIZ1R?e-qzNo0$iZ<%P5u=f~XowVNiKagwBs%L$4UN@q6Cau>M-VZ{B%tY6pY
zC(k{ZlZsG-3*xwZxk`?E#d;x70~=6d2z@PbD8_>3BiwY}*z0Y8_B$Rp73D8zkoKvq
z9$6m`F)q>l4;BW&%Al8%Do9j|Ki<&GwGpWg@CZV(Itm#3MYn%;SBkof9i<Q6<MFez
z!D=U043}HLBqvkN&zCmX#Mo3wyCL4>G#zdYg_W3@7@{doaNEPQnlY#Zfg_0-cag$T
z8@+zFsE>Qq+jaNiI#GLf=W^8X7&kp1e2D8tZ!0A>JP-KH`7tYBvjB0Z7#AXZ*&-uP
z1k@g%XZ|OM;UrVYEDz7dOkGCafFrh{DisS5KMHx~mCTignyORih%9iGtL(L*u<5Q5
z*o>6Jz}KNuhMKCgj$HM2M8(G20K*UD)1P%a+uiGv?%>=Bf5ytJAk+2GXWHJ5jib(|
z>{$$?*I2=7ySj5X{-zKd(aB`@xrFq0w&vQJLmM$w<O>x)wb{1yop>1j7cUOscpI*(
zdO2bAljj##*9Q^dj=eOdr-dE?We}%M8cEnF25PUuIlGq#F2yG<&@2Cjog6tvu4EtP
zkh%2?TyE{<&}@BuQI4;A)!;u4#haSO0aTcEBf9a4YDHVf2^b)SpWJ*If^8+D4u;L!
zn411O>|pBVS|btkBK<tOY+Ob-PT1L$IADSa16!7mL?Z#bzSXpDXnuaY`7j>6jBA}6
zKkDGJ*?7PGNBuP$$4n_hNv#`ZE&dpbQd_7uI8I~W8o)kTcw2aFprz$aceQA6hjh?n
z7g>dlg4H?E$GCjC2qQ$mO4jfU-FcSIggkuw@y+(JbiZ)7KTlm9?v)c!LnN(ah>AxZ
z`U88{_B3t&^l9_xL!ibo;p0TGBBM>PE=gz3$kLvPmv=~r;YCWYM*GeESHW=XP~O89
zqB`Zaoa|LP!?G7xE<hqnjJF`Up^qco*M)pcT@pG7dpQ|S1q}B>)hw<Cl|#t3eaJA>
zLi1@>o!hR#iAB~j^9D{+3UgA@LE1?SFHZ(tRlY|f<OScz-Zcv2{he2nhtVl)jjw1>
zi@j8PJX&8AR4Xf$u1?hpXwkBzFxFK2qD6ux(O^<Hb?LNmB@^ZSGOEuwx#WFZNy;M9
zkp45K)flxx$h}b|!;u<EX$uy<ezw!P7N;}@kqn(b4$iVfFtOg()>2TG3UtvEiTiJx
zt3~$&GOtIJfeW=~{Sv!Nq3LA$C*(uw`z1Ws&M@HEQFv1*qF26Kv2(o!mSMi^U!h!O
z>3Z7Z)BI32xzr=*L$^Z-)+J!*1!?#;n!j{u15tj`X`=RlXvxAZVCMJ(I+_>mj;#IV
zgUk!6!DZP!+77@l@AoZ_f!z78NUhoOOXIZ?!A+uzaHQ-M=-nYdCr9K6tIago$DofG
zA(tVv_#;0>Nr`bv21j?@>;|4GcKLPV<NgkZqu;i@ZLSb~ClSRh>N{yo@+9&z8Dc_S
zFdvcg!KVivw;(mz4lM|m2@JXoaTFu%`o@25rdkvRsVl7sfXePMH+G(YX06P7Lsu;9
z6@-<vy^s{gj%+~G`nF0<IaNm7nJLDDw3!^{``|(h5Gv!pfr(NR5tjmC(g?Jsyz}MB
z7S?ufZ^4@){)=#rP9Ym?D~Y-2kXyEMUyOZU!WLYaBPnqh)QB>XXlc)plS55)g&({c
zUbf5K?&Z%A<N#S%CiV{ui@&^J){{YIJWNWdfD!dB+>ozI7L!^Gm_$}p@XL5nSY)y_
z%);ZE>Op_E+*<xSBK|l3wBsYSoA}M+_m2Tc1qToPTbuHlPrk9?SxDAnAVCSpQ}8$}
z`MbUu;9GoylIrxTS5~u_If8w>P8g#IzaDmxER8PA9}tl|wrb%7rNts!{tw>1RbjI>
zE6!Vgq<Fs5v!Li-IK7VMh*Fu)tT&|MWwZ5TgVwb`<q03#OXfWtb32i|-OFp%e0Wwm
zrbo^pEG+u*UeO5p&>2J|?|-AjPlSXP6m*#GsPpw1)yJ=$8IFwH+$P9+rNNxJVX*0a
z&#zf4m|EiFTnCbo{UY!a+g&x3CJH1-sgsuH8Ut)MpCYLh6ZVB!9<_f)0Gs%;L@Z^S
zrQ<<xE}<;=e9QpOi^zsNin(}kU+18sv=}lAhG!df{u853iv|8dOG+MCFem(h!BeY_
zzY~Z5Ai9;oHtbHq`GyOxe&X&uhMW4hytv-tZOrVjAwt%3MS2?@;@m<RiJlm=ErVb6
z_W53}*f@xW4XeaSBfs<3dMR7;+X5zlUXFrj;dP1fp9tvk^V_lxQ^sq%uHeHau}y-?
z{b*h`SrQ*Cp^?$a)g^so^6L#bqqC(w3Wf~GKz<JqAaYYhQD#~CZ#0;d-<O)Vzqx)Q
zE><xAF#cdy;SS+BNlAzXy;%a0xP7>ct8*wFXqrX0klp)RZ<;SU2Z@;$167z(kot+!
zB5{TAEAu(fOXt^zSeCa>QqF~%2vLg$>YvrbjGAM}|2v6626}?aV0z4qEhT&%$jqJ7
z$Cor9DTx|LDshZyXk|~{HLyA$niKy11xDKOQNEXVQSIL{2Iesb@JL+tUoF|c&9;xq
z)(nGpwi)!F5@P+Ity3CDL8;{@?_JET@e=q2)(Z{sq|1lDmuA)nA@WYP{HRPq7cDJQ
zfLj2F9Z+Wg9%P?|2$11dStPNcLB{48DbB6YjL<uKefi>w&t)Bs)~oUZzK60=W#Q=?
zK>D1A#zR!Tlp+B4H;~F--A!1{z?jVG=0Bo<lX@6rKP6-X4+}8qFEH9ZJg2GNE;Uk|
zOd&9NTk}rk6y1-aB%qI&ZSc(bD5vbyqFK0*jsknbb@QfshM$0a!zXIiC08{tLD~*w
z;K}U~5o2$56vmO%3?MH{A}x>n|E5zA-avNdF47?Bul@05$;nXM0qMB3_;pzI(i~Z8
z2(7<8)0i?iVOium=O!3_A57uK?eDKfSx=Cu{rBrJs%)ZgnYEv?>36+u-PFWdV$q`4
zEkhAyD|X$yE~$dEp-m>@vCHDS?+xB71Kazd)!T&czZBy@LO<;@s>2<7;aze2&K+fB
z8J{ZKd1LXNkr934`DW_lInTpJLugaCX9Bm&+5s^hiuwGuyu3ulJOK#?KOGXix%Q6`
zFCug2uZX7&h7ICLGT5N9$)%2DitV^3Q72}<E^+nN-*wZB2V^NyfN_vlG@5CDwRS#?
z8l!Slr-P8)dKFt%D@6^MK5_%q)#!EWhLAp`RycI(D;qXsbc)+b+dX-VQ%!AWvJL1N
z(mb#HSl56<JGHwr>BY<I6wp+4wkL)VrYpv3)>9z;mIdrcztf~Fq-Ay=!K2)u$oWvF
z)=Ts}wFQ?yU)Wz&+qfjL@K8X{Uab}eJ}^D0YxZs97>#Dl_jTFVvs;5F3++{(oU!d}
z6MXQWgd0b+&WvuFx4?4uw@ZhgcidEzXnykE)i=e3Z)(=A9e!+e@!|ZtBZ@ZMUw8Qa
zVt$mYj_Sj}vDjz5A7fuZHzyKTaTlO|@(LcpGRtS|yk%fB6FH7_F>JsdukA4Tg->Rw
z_>&3w!Js;;t3!#V^6PNcoU>#0i?te6OP}IXGum=E5!*x}L=4XB;wu6z((8&<AHORv
zqX3gjCzGy(to(}`c^QM-HR6V~zTb&rk+!{*D%!MP3@elyfNF{ZTS`nH&YucN)||*J
zLPQw1Pm7d)yT4rzUMQ)V+JQZJPTMrP&@3K5?RDhR$p5rT57u0SZJr06CP^G4X>5y(
z8I4nvz^6-tB6D5Hmm|T~lzuF+*7`~ET*+>Nndf(G-|qOSduOdYtw+g6Jlq)P7o`X0
zO5T~J^T15RtOB&p^TD51(D)FQ^LZX(5y1{|1^=e_JE`I1mF1g<HFE@F{dg{gPWejy
zQVKYrl+#vq9o=qc*i3Qzx1b5stc?5eKh>Ka9-|f((I*8(>iwB?JpROzP5=T_=oYkP
zQZ<lN9xi+n(TZ!mW4Y#Cq_kj2%QR#4>vZqk+k)Q@4WU?&aK8V#<xp_HUANjwn-J@d
z#-TkzN=dd9VM3EH)#H;QM&6d!@KI>Y*xMK-x;gDQU?Ogo?^^{6sjCsKm8Y6)VrvG&
zIpF57u=x1+CIBMf*dj3Hr@4Jt&Bz1AbQDS<r7`-4;E`l<0ts{p{LhycZ97s@Q@J!E
zIRQa<8E1dUJK0i95(QXd`BOT_Q3z76MUmHikc-gHf{!R5=D+;=q!}Is0MS}O``+l6
zwnSqD)}MN>)8}|<Oc6U2T-`7z#*Mw5pIE{93zNa%$FV0sn=`m-Nep|eAGsJlT6Qz1
z{+{qKKR=reuG;3O1*J42A<aP@oh_CmQ>_cu%JY`(XF?C-l8|@dHwB|;WkF16$1XjN
ztq2MVVk}`wY@JuMD-59t|GsX#EZL-dl?a27Zf2~DD>q5<7bBae!GF7N8y>d#8qFV@
z{{jG-96)T#*<Y49Qg>^#zEwM(tyC?NtFC@Wv5<w;q{u?#GXXI&)mcYJM)1oVo@RAp
z_6a+5>79`dMRD0=GVsDI1Gu2)ZC1RfPN|cOdIcada@(ect*|(SoK@ywf>jt}gSWzg
z_oM;3lLh*uJg_jHsW|iCR$d@}vYG?bA|0cVc_=iuS9bfR7HzV-<H;$u_~g}7<lL;I
zZ{;bFpF*%6$)G4Tx$;SEw=Qie4IPRS`iM+0bNB<P;R{bI#4Gv+^(7Cs{-qO90Yp$4
z%yU6dp?5X;*LnIZvjh`c5F(nrdBapXUtc)TcB{SmGR@{q#=EHGS}~jlBjbZipHAZ4
zvp*bO{6w}Zb_SlOHxPiHO%0TZj#al88!lshf6RmlE&h2>mA3@%Y#9dw4ABq~IGI*1
zkoxfYx*gDFvpB_9z5$Xj20?D{TZ@(;CC1wR10jX5ax(2h+H)vFxRb2vzCvw72-IU;
z!%fH8?=};`{drGfu{)hLCs)6V4?#t}VJO5?d*6JbN$Eg?Yyax1+AdsK8Upgd?fgxT
zaT60)cO-MjfCx;`b#P**->ne~Oxd^biye^-Y2cf?(_4UUP<x0I6^_O)dd+U^v2o;U
zdP^QUYGRLRC-KozNU)YE6%ixTZNIHIha<JM>yRO>$;kZ>*tbodOCn>v%xO-PVs1n$
z;;uMyz~eCkSJip>LEhYUJXd~xhKG{PqTfHR=zSd`b`-IN04rw*eMkdpGIS)79Io--
zhM$OB_Uu9v-ZJ&3IkhX5OikYj5a@=>pADwdP&<VrmF>A|44N_L!Z==Q-i*(GA`}gp
zQLk5#1q_;oQ2qF?_==z}>g37W=YO!M$^sa*eAQzuT?NReV0C1S`ig>!tK%j;cO4ZN
zN<bIQA&4fNYZ^d`SV2TxI_iYDm%}Bcu{hliYcypdvqT^)Hz=XRZzH8lRl}NN6+UAS
zWX_G(rzdH(EsuZDDZ1OB0QZW=8YC$nN?X{FDHSOw6X<}N2F(a9czk8uYFeNYv=;)m
z6}nu%g?dj0a%9I{-Xd*Kd#Fs=u_+j<0I+<<$5oS}#}og-<c0c`MVVx{Op+<$)WyTv
z=w@M8-95?tB_WUblQb5O=6+uw?k8BP;a7Ei`uG#w4Z?$1WFqqtkX#x=P4=T@2b}rb
zD*~8<=u3^0ecte01t>BjOFPCKK6dy1{cO60K48$I_@$mbF>SS@E(8IRKt>j-{QDt|
zi@{7qhNeYK2`r&V<0Nm#P8jr&>GyfGt@K%9`TB|AJktq>G%rnWhHpk8AHxaSab;)C
z(bihJn+SZM#A?X5Si2@GT~SBWC9CK1$nZJ5k~O2RnvVSX0B>vOe*X4t%l~=@R*0r9
zxX0Kq2$a|{O5;XE;52Pvrh%A{ld{Z?Hbu-KQ4(s142K2OERF$EtjpaJ)iLdg5G+?V
z*LIL5mU#pnM&_A*5Ow#>L!%b@KodcB3bTkxJT+t?tt~-bW~@Eh#|<STQIn^mCq@RL
z1Yvw&u#0KQ5dHL~Uv*#a+O-RSsk7~PQ!U-)hnNPUUgrbpfCcgJm^x&;=&J>`lVun~
z*d=-+q%Bw8#3cPLUV#NNppX1fO3Wk;nc<-_wWlz4wrJ9wQk)uM!7y_l8o!{sry^cF
z`q#?ZIkI2C)&Me5YLQp31~Lc>bT3*;;D=K#mx0_?UYzx#G)M>kOauv8QcKdtUeZ#j
z3kf6{)4{<(pkwFkI{ukn{{Ho0`BjkNK`jfg;4xx|W#D-#FySGjYoT<`iLq#mgv9~5
zhO64ht=6bzK~6<btK7F39<mZ8eb(a1L$S<Z4N?#RbYJeJN3}vI&`_G;M9rMz!^n+z
zA=C`Di{VVF>JWX+Dg9~&PS_|^Hz(xOn`&#~h+r*5dD45^N3CWaM<ya|y70I_H-<Y;
zu2Ol54u`!8b?}%2<;&s&fKdmbFKB1vabeE6?kir(sv~lV3ehz6-e5Cpt<h?OK%k^O
zzW2UwzkV{0!cmejXs)=zliaiM{J2OC9b@z&F943PN5=E@-elk=eg_U!U6i0}K~FfM
zC+?`sTxV^CZWJcPA83y?x4~rkQ9zj#yoebr;wBt~ZnAr`w_T(993^vvt@3(l-^5a)
zcwaX$<8DpPlI7!@7!^z{x-gP?7KEnSi1B23@a<OTN>>hsfEMo<iOMp-M-3^~7jvhz
zk1Rk^B=SObki)NrRQ@20c^oY2H)P1ZO>-jkjWC1HCi$*p(9HE?aeIJEHo!EXP*8Xr
z^z@6a23n{mQ@v23eU?1v!oyKv6kyS?sqx~Sw<4j5j$|D&p$mKKe*FA*q}gc`>jQfh
zw!Cq8<Y={KPqn*u;;p@Nv$vfkV~CiCiJ=Np#6GCwY%dpKSQ!}`TaQFlr>oXn5du*h
z3#3D08md03bNuYfErc+%vDrDP*K?c^0*T-b3~5QFBHxCtIH`S5)A<6plToSc)p6tI
zCAUKGj_7A0(NRw_Hxhw{9fnWWE~^2ZBwdOb^C`XX+c#kT=P|xW4$FFHQ@fgb_CG@m
zW-6?Gz9UPKxq|BL|Mnnj@y=h6CQc1nWNv0Q4<=yy&ZhC90RqEf!bgiIgdHKc|I)|P
zh?8VRaaj!ZI0~l(D%b1NubS1OAmXQSJ4!aDj2%0+uFjErLs1s<S`|9V6r5PMc<tP2
z6SnWUJ_-1p9r&wkml6+VP16&nT4j{3lmJE;*mVB6R3gw<_V}KPEeW9l<<C}xk#jQN
zY>qJQ$4NZZL1GzYXcWzUIX2*cOShf=*m49B1hw8+TTxnChXg6MBIGI}!lF|Hr;KEp
zWiXo>MU4!Jzd7IIjxv>oK#35Si(*ZZX^fi+)C1Wi3l?R+2V9NVa;g;t&$cZCP4>~0
zJ*`<Q+V%X;pW=C2Gt_whoc}>fv=Gxr{C>E+ejtFDSqPPRS=7b~&w&9pzgXbsBOcrw
z8d+Tm{%c5cnc|Qa#EWKdJAjIYA91$5|B2C1i9&ml?jAI^J1M^|+5c?&7?bPAkJ}vR
zpg#JvNpixU0rR=Zoz|S*vxH(@Xfs2AAm(pvf7Yp>6#R0xL8eSlYH9gWkvUMpN=s0<
z!)z+ISbiWlX}_oQu510TS9@^8QVLUw&0rG6X*q_(V`dZ5fl0lw5*1?|w9=xO$-#9$
zrOdjM0rUKvh&L5Cc3X*J6WmBhNb?HJ;99d#iO9A%+2HFGej%Qv3VKA`oqtc-#tTg~
zFuY&75(hPZA&!>?|KKoYaDimg+0u|Lm%!GTr4>a3KcHXV%tU|_uyjw@9tYGz4UZ@z
zQWFuR%sYT<l|P8h`VhV6|Fi(=A2;OnYTg@D6RwJ;Y0jw`{m4;bv?J${ObSG_wve*b
zaOV!n!loT*oBR=MQVs$OS;rbC?*!W=aIUK*8Q&0zIu!=eua*Fhlvl=>@JR=RjVC3i
zqWZ_sJo0k#isv0>Uvf=n0DIkL=G#WWg%E{wJ~i(`i7p>Ph9!9Ze7~0E)mq|{igaoo
z3xg=*y3WlKkP_;+5+4S5!_NzYf3z8}R7=1zF$1Mm<YAdJ@^ZCwX0YwRBzoa~#oAl|
zJ4H$1kZpuUQvRWP+E&&LYvA=Tun#6)$G|s=+z>(F*CMw<E}$Zk_Vp|{fJik(HaE+l
zCAuO^eh-cLs=<Vzg3^~BPX#Z7f{;;po|@hiQX<9#{#iIIWD@hNWmiL+HK&C{fjOV%
zM1Z4LtDc0ISa%xhT0Eq`3qZf=fI@A|<DbZ26pI^WZ0tnURWdm(@<jbT?^_IlB)kr*
zf>T-`0?RafAm5Ma6i1Sxa}lF6QgK1ZWNb(W2n@sMjQDcELrRT#ssG?SG36I#hFv*-
zRmT9}QW(#6KeTi=g#o{bv9<%ukh;7T{;+lYhLW^8;)?)bMn{~Q`e6bgfT)fH@_FOD
z>Z(`j%um*&&N@QQ7JJxy!*{Eg8YSiQ`_t}CIHV7CK_)j{kRQT(E2o!X)S7Zf5UP{v
zw(pn`$qu1V3a_*qH|ntiW=iUJY#@rCvwfC5tcl(4MuIQ9>UAd^o|r@ZMmxS9@G@}F
zXV-<3-)wfdI7@V-0$qaAtr+&7%pnS%M*M8(Kly-=oCYkFYAeQTRF!_;&fVm25O&cP
zn95Ge%TIhx9EKg6&$kgh+{bpE9>O*Hu((x?m^JSzT?iLhC<TFwfReT_i!XL91olAN
zhbmL95~NKr6X6;M=f7U#<A~5hk)vY0b?Fg_(46c7mPx<`u%k?a4F}SuUH;ARBv5`G
z0&ktJvDfoBHK*Y^u59|<1_v6Md^vYgp^C-M5K%>edV-^vIuo~rxq|;F|9HAhz>8Jy
zUp%rUI?pIu*Jx|>JM+tZ&6JmE{<cCZDL!?QB!JesKMx8F6!Gue@H)$GVQL^^AGGKX
zV|#9vsUCS6yzHnI0lUJ&MssO^a(##}_9Wa+gJv7)deHD8zp2E74QcW`BBbPD%yn+N
z_qS4JzO56#2@~}m9c4U7I88{J7$!?Rsy%sN0u2Y}9r=?@fs4IgHEO@jYuDYrHRD|M
z5FdR7$d7m+ex14Kz+7PG$i&3^-?MM|il~w(B-dR&4-i(rLxrfn85zGpG16xCNi<&w
zrqDGYApf}LIf8=gWc5!7Z#-(M>OmN#ON4+{mu*|7g`T6N*sE_Ubx2*tKPbO7!R~%9
zA5ydb8|f#Fs<sJYX08LvB2`eDiH!>Yj0>%X7^cFji=Llw8U@+@C2>64t;OUH2`2~W
zhWi1%HyG$hNhWFtCj9!&ISk-Oz7XWH>|9$x&FL>eqoiXObvKncb&S0+HKAFGNiy+A
zX@;9$^z~ehhme!5@1HgoT@s^TG?n!lHx6wRF{;ORr{XIYbFR&e_MMArQmm!XP=lhB
zQ19}An%#VzV}<Ta!~%te$J!t*$pE5Y`i_u3e^^LP(;K??Zv4LtdExSI{SHsHe~bi>
zXH0hpnSaJB-|u9-+<3b|srRcM?WU?1TS~M{9z$;SNRWv`kWV2mf_qzBpU86%btJM8
zs9>v!&Xa>3Sw#$eC$4PLD@sCibBi7SkF5{fXG~JkB<+3yD)sAsUgWjNX5Kt)EJ9Nw
z#&2JG1*TtovM7nYLqhH~&Oh#~+5CFLXl{we#q#NM!PNvya4O56hV?Vj5o{C!Nk6Fr
zrlU@e#N0>L7{xfnBYj{8^NGsO^zvn3&W(Xif2<27fi2ZERV7%8wt|nsg4bx1mR9_H
z(enH?mLPO+&8|gM;$oa4wmsDSz93y&?~LolAr$2VQ;rhDQp)-d5m1<<P3+DH|3L_o
z9y;e>+)g04s#mvN5X5PkGK?DlWR|PGx6=gXY*uJQ!#kcjmwU>Pe5EXC&!eOIE>s)d
z(s<AsiWjb60H}G90LThBw-0lvk7$zXbcww#Rf7Dn_<C^%h{xuPgwSZ*aZfgH3ujKU
z5x+zl$J+E)tNtgiL7;lNy~VLy6>ImvhYnHt0|`-0Oxl{&`e&BPw1^Ct;d7P#^9NU-
zG3R^seJgQQ@Fbj;(!ikpa~KvfrexK{y{N;1x|8OmEAa$yf^5x;XRDwupQnUHfzB4u
z*L{hR1Z)W_f|Jto15}^77ikd~!u67Q1+?HF9o|1VTOZ!U5o7)sx5h|aIl%c9FZ)i}
z%#J(J*U~-{c-l^(AX2Bhax6^gHR|n&I4G`0{+UnvewKooJ@G6Vn%?@F5hMAbyeY9V
zhRPA!KUsp4ZwLt%NDZtra%8Q)Qy09BK|%#*A+LV|v3jj!qcz%kd<S}7Vip2hal{4t
zYQ}0XQ$!I8kE<(f3Y+GGMjX!{j3^YSP}F?ne6vMME|CY)SxE|Xaf9ddB;?@{*LRP^
zbwoI95SCVnBj=?l5Mq=fNn3PfU^7|Q%6P^9M0L`_F7wr#|I1nP)ti40VTR+nZr#?U
zo&r)8o^LGqSS(WEO+<5^ogHV=Z{Sp^Tr{RIpeLSsL^nQB8nI8aZQCB(n<p#ZfB>bV
zkV{!;eXLe?m5UV`=26_nvz&sPw{AU9v2OAIcMwj#W2u@XHj?!VeiNA(0hgOSXO4o$
z7{Y-U)`s`!oZVzSLFqbCSUSiZ8z&b<jjAuG85clMMDnHCYi~{6XWhdOZf1KZDo#Uu
zotd_l0X%1m7~fg0uF1xW8egS#>0soc3K?KtVLp0vDOi#0QcYeyc^Y1%0N+tORv<IG
zm<pOjwFRy7z@k|o<8w|Wm%1U6XD_@-kFxw%Ky=cIQ1*(05;kNe=H^>ImLaWaFT!ig
z_Zz>Ti?#whgEKpy#dBm1Q>6Bp-MUd=G>|-kY6H!Y#Cwll)lGO6l70B}QCNN}(6)I}
z#jdypBfkE5WL!*)4|rA?^IHV;m$%DG{KXQD<S15)=z!%UFd1e-=T8f0e<g)L#q7Sm
z>+L(6g`+}y2Lxq7Tx9@2g8h1<@ydbrKKkLeM{~Lkn(U5#=XLv)@Hf<8GBF`qC~*=*
zJ3=9*k?{T1?Uu41uCZk|mm9BEVZap(4JO;DWZr}y!QH9ZG{GhZHMt0x=*t&~Dn;5W
zpvEs(M~%p7ZT3W0N5^F3WNX{b|BDFM&Qpod1n{cs5K>3GxSXC|WT|_H2O$<EFae0U
z0^Scct)Pt&V*;S22Dmj64Ynd_6v;Zpv;%0ZP*X-8)oJcMt;TVjD)$@&D)gt$=PB=?
z7^HkqZDOkI{ymwCCkqIW5t&z@GwjIvyiT=GwVip^;;$?O?v8~&2yE4<S3Go?Q+~X^
zEOFLFZw`HfqHR3^ECi;-REx+J!h`lo&0j%OVLVcNTxxUv04$GMy0kmoJ=5*ts3Kyy
z(%mEVu*GFK$&498&&00Y<cazA_8F`CZndvJLT_m}xF3UiTxiSk-rmqqWmqSR%OlCH
zASAO*BmcVapY&=vATzape)eV<LtX>GN!6m#H>)mc{FpV8C$G#JVH^yqOY<!TR##W2
zp-hpTC?F`Dk_Cuu=aF+{fDJ_V*4mB01B9tg3@=qa9ru7~Gm2T+hK;#lT1JL<@3SXt
zehI`QO?K}SypYfFCdf+Sq$)3a(^uc>07xHzvoV2}_}Yq93gGysK@y7Z4j9>K(4g=^
z5yM93F(unWT-})jFr1&EJRE;-4&{{P@0t!0%7wSP#3y_^(b@+mc|;|r83alx3s8Ql
zeapaQeNU|$DuVPl`jmgCsYycUDpis|TGZ0Hv141NI1Fe_w<HQ<<QGetP1BIH1^S!`
zYWZG2cptk`sAVNrQN3WiMN_l8)p3srsPPprDzUfkP0m|S03op7|K8f{?3pt{R@{jg
z6q<X9ngIGN?yP^`f626BSck7i9UxfqrIe!4q|)F=CxU2Bdh`ouYKqsI1{8r;=<EpQ
z&84Q6E#DLoXu>x+z7EM+g(?V49_ltH@;4{2F$F(wDw1@pP@tuXTA~?7yr45%d%GBk
zinxpv|H@1P3_0B@rdwpT*?S%_0y#f0LDk<st9Un3^CLy$0iMh^8vklAcGk_9R})t~
z89k-Yp?lOg6z0euNH->y^607dO<c0?M(Ij1zymP`+AD=OaJE?5SNJjlGnN(GD)l_6
znPXs|OfTR0bsmJ4ohD1EXxPcu`0Dzv88nLpA*1tl0YQ@HwzHnxarUNr+Uu!EIBv!k
z7XH1zcC*?&<z6es1~D<VlP-yVMeI{^QAn8Q*M5213}X1*7luUO{W}m@{Ygqft#gq0
zrOvkB_7UP)Ms-1o&bIecO5!ufDS~Q9ZXA2a(MSLC^|wNjIQkq5pq0*h2q+8eyb=*K
zZF^9W>(7jFFdU%q%!aVZD?Vqge$!;wQjwMMO&2d{(QiI$%zRPZ<DX-X@1i8L-?eeA
zCSUyb7tMtb^fIT$pMV=L0{818NI!}Iz?{!+fF9o>Ns^?c1<A`PlT>x~4qVnI#x3Fu
zp-n7b$XNokI=Iyv;&Tl7peSYOyuE^_bpr*3X=!=l)hiz#ANFb}3poU7&DCAp>o(Yh
zjEi`BdanOCdCr_hG*vL9woCd9!hF=!)O*r_w57Sx^*|x-{`@_V6|rFaXAW5Xq7bXx
zXx`8yI9DsjA=({GN|qZG8onDnYE)fpu$_FqEjf|RYRlHBuPe!jDjzSSAQ1#kSgBVk
z;T_XUR|+B`Zv_#NC}%R=kLbyazAz;m=~nSQbanmsTJ^7eKi9@4CJHYDENKs5Cr~fv
zPEJQu)zNgY5c7(vvnKuN;SkE&kEq*z^Z?t14vy%W45^Z#WuzKF23S^9aFe@lm4}0N
zeMl)dRTkj35CITJN-r-5^OaCKp~{6@)}5FSn*1rd<7TkF@bkBnrwlR;_~&a(z~srX
zgGaR3YF}5#*<_RCMbt@5L6~s}mf1AxgMdwVG87j7@npVP;5dv-ZUI)S+_+^}3VXkr
zG7|e&zl>_<7aNeU{#ZDyg|0cpMrcsbDEeITY5AGYS_-l9BM$g+6`yBG(MfNM{J-_J
z$W_2OsFMN@^<1Q?ql{r2G}wws&E{_8%3@EwEqDI_aT%hICSSs1cOPwGp?;+Fl2P{+
zL(iN)pAD~$J}$F-^!|<mkoohOAN~Bg7*bw5R}pjR=u}<{Ekt|5u@;SIb@Ox9+|ef?
z+Eb}_WEwW$SF7=@N9dhs8hhA(_io#(=a=2e-ocO_fq{6`p^?82_GKbuW6Kbgj7rC*
zeJ6s4@i?-;rNtd^_~t(c-j5kC{z9nS8bMD<%Q>?UO(=pP;Ui+)YAks{5|Qym5Wxf(
zS_y5gb9VGn>x++)^#=qLvjna9UsLPa#50Dr42V<i`w5~$nSkspYieXo3xdFj$y81d
zvC@x%ig=Q)naLIQC?!U%oquLJ!z?S|0#ai7F98)7AVua6sq4rWS_a{EuMQ;YYsMY5
z`Y&zd{&=6~o2!z$ACu-r1XKC2vJO1t;Y+r{i@}Z<_{q(2Zx_{v4d2jQQcpNrl=dLy
z0-}fjoaUeGB?c3Pr}YgTuspJJ{{wdA`ea=L*dmV=sUsn&2m|#Yd(110HvefS>Xox+
z9jGr;m|B;S8bk$-aBVT?7~t=bq>@Vk6-7KzI_%d2<q)$T9?LEygi>OQOo0AVjMYf~
z)9>5fBzOP^0$aK*|5={f`PAHN9YFnlf4H}So{mqfexvVaPy`Y7pXjM^r*!4oHP<ZQ
z4*)Uq?tPhZ@gr+(Tu{`BFvjuD{%<|HbxVg=#8tQ+LMXcSsWqD@S#am|g5i~cND&0C
zs42g4WjJJm%!W#R%6crD#fP50%iHq`ctVC(SvYX-=TmOKNae*ffJ=BBtQr-Pf{#nu
ze6!5X?(x&Uzo)r59KcaY)C=74lf&nB9I^iT&-IXOB(rsczVj|c-GC(R`Q6Cr`S;JQ
zdj9w9_PzLJ@3C43NGLh*(ln%{rF}dU1N`of%tEv!2t=mV6!V{=KBXMtxVA&<!s09A
zur^<x98Jic{(Rr?{Xbl~z|fI&YCk;)p<Cj^S<s#dqJi3>&w=eDyRTjYwH{->Edy7b
zCn1lzh^R$sEph#IESjIWMLcIfQWhj9Xanm*rnlxMX43h~beC76o^f6%k8EbLV|w|=
zAmnBqe}3)jtr6|3DfJ4KW^n#deQO&U4iXPL!_t{n6jhOkU>PK$N&mF$8L*S#rcGO$
z&i2(rvMMY#kqZzpgTDoRS8yb;#tutQ5U1eh!_D#zbAF3cHwGaV+WO3SuX9YlfHPzN
zG7{duvPrLF2Fz{2-JE)z;SPjS3S&6QEcb>{uJj(Ax^=Szx(%e3wv?1+vn%t}Dp?jD
zi2fJ{<^{tVorDjwP;3V-Noqejk|S<`A?yTTjDG+l0ipws^TkyFZOuqote%~)`S~Cd
zNI+#pAZqA}!92}QSPCq<k^r*w7RJ3>@7{~AxKGyV*l{9Lar7mP%g!+wqN-R`no%#y
zDgQbnc0lr~&cjVrb00s}gR^T^zPI)qr3~W7v6KP6-!{Ia1`RxY+T~!OM(e)5B*RB*
zgP{u!lX&{>kB>V1{4je#h0#><ly#Ed-6%Wo+cRNrn<dxJl9EhS(U+mk;(_Q@IuQW7
zFemd8Bx(VwfFtNej=+{ZHmrD>h@}9$-d@0kos6xXVS4mI^l0@}FRrVZs_JlD&2Z~g
zXj6w=PfPPuXcG=F$@3HWq5#PJv+Q7eaL#Gk&WH#*2f00Ay3`DGhD|v0bFR|pMPqga
zWUQv+`;6U^0H2zQmo%9#xwXEUHcnihDRGx%G|&`_1XV>99A9w?V7`3T1&B`<(1#r%
zZ<&!#ND!I?1%!$d6`EA{#YS$wXB8C{F^#K=E>xQfsLQXJ_;tvqxxb9AMa9RDXNI)m
z>c+_<_1^7TLg-Ug$m;Ub=g#Ru&?zfq<9A{fdGaP@$W5}sKST~Spq#7b^;J}w@-d1R
zzd|Ini?h~LAq%v>7H`>p>G0vhBRA_Q0$AxBA3EbvXlI(6==k`e$c=xTAmSI$;cq*!
z0|hYiYd47|qu-7AKpAEU8OMt?q-j<!blERrum{H{ceR;0^Oj=~!jGM__5Ef}&Y|)M
zpdfzx<ZM^jCsyckY$-DgI{_5>PVGHn#6g8N0XR7Cl$4Z8o(LZe=S2K)d9iBaM6HC5
z;d}P%1fh5U=-3I3IljX1zc$JPQ=ti2gWRlOt#82n&tspV@($u`X>zh(l$03L6BdMY
z=}*}<L9rchi4<fRb~rz@-H;4-tsTkW{|}CiZ=2%KKS2M=ru>%gYnvK<snI>Kbp0lv
zuqHYN*R-qCDX71^%M0R{7GErTGD-DK^ApQuBPS7E+`buu4t_uQ6j8l1RLrSWxk=r)
zGF_1nnNjLtA9HZdf~aaeHbZd-{6SfEA(lLdrs;J1z^2<#yaJJ%0FYfjZ-`EB6bEqK
z_*UbNL+J}MQTgQy)#>E0!-prX|59#3>bw)a$QSre$y3_Y%BKVNv0IBV_-kodKdUP{
z)1_#0!kQKAeU4(d3p_@rc8&bO3RT@E-{c&rDRyq(KB;UVbf0f#>2~5~{)M}EWd>~7
zq7w6D)635rXpzp{UC9djlG$Tmi}VPXofUu2kd7})ajsbTRA5c5>Yu42E)MZ!dFP%p
zdt)Wo@WR7*?P}6~RlUC3mfHrdd}YyK)6_ZDuUB1M06G4WP<7=uO2z8g{bsl=Ju&St
z2J8k?+L)>7EC9;CqGD~TIs@Lkj`4+A%fk+jS~kP!mhG;0Stti}6l=#H_w~4HywutG
z&af=8ZHkVJG=^&(r&{y0<SARLy8q1EgLBw!WFuP;xd(sWIBi;fo7Gb-3fh>xHMCxH
z^p;BQisv22@9h(H>tix(`A%S&%0ESC7f*a}e#PA4Yg{`u#VYb{asHNutxdtUiX)f3
zTOa&&nWnB;a%gA0Hf9?=JjT$Fx1HjnX-YQ{Kro$=G|wc)N$mj%ZSCFo@n47U(T<Ia
zYX$(>R7>l+V-XucBoIP5wT|!M2zA(nN6h-5J(vl`KmM-RU7~?eYi>jhbrZn?o-1qV
z)S*l?pw>+IyrsES()CwA4)vKk(g4>S0+<}UD_J=!R#Z39;#p_St$5eT;C^oxHU&A@
zFI+fUp^5T#=ia^lxOa&<l8`WglzZ1bSnmyrh?f|xbfS^yQD|-Um_%U-oL&%;tDW)d
zN71C@+OgF+Z^Boecv~|%d~clD9H0ewQFT}(M0cfx3>hXaJiY$_S-ljrBLKTTO2#K4
znOg}lVE39ZmGg%+=)oBlWjhx1;$w@Z=x_hkLYJM@!Q$mdH$82J`=O?r3BEFCRADoo
zP+|c#AXC#&-;{77R{Q^`I`4p<`?u|XCCRSrh{(vy$|x&EN=CMX6t0vNB~fWn86{<9
zrIMM9gb+oAL_-o1GV2mW6s~$+r|Y`!=Xw6Rf4^J5`hGv3_xl{jc^t=y7gC$pXVZrn
z8W!{6IRvjVc3RMP)mKom51fCs8;k0MNcTje2fs<%Pj*=-wf#Jo{=^sKNdP|C76vkE
zdVJ4gO<F1BpAObFm)OW892S0kKbxCgnx(R@jI@%%8>AecA3kK|{7?COnnuim6btrr
zSnKSptdPDFBwT!;B~iWjE<y>Wi!2qIUOe07(<~(D+-Bg4=>;okreqio2BmPH_q4e}
zM)wLKE#UMo%2GgHu^$kA3rNqxWy`GJYsBW|_3GL4<g8W=0zXfVn*QVB%6~}HE=ywj
zPBY$f`X@a5ECL|znEQTQq_lXAcgQ;}I|v4%Zo_0&F`D7B*cK{y@Q?S+pmE|B-$YWf
zZbHBYH#dFVV`rC^q?;Ib$N-02xAF7Si@iQqYA9rVC^uS3!TB4ldg8prbswJ;SAFOA
zH=h6RjsPg(kY7G8FIm%Df95oUp!Gk>#NZcw!VyasG`)iM0<7j$S@qZ^Y(%ixS74HG
z9hMjdJt+m<5YaAr2%n6%17?a^lD!kD#G|&S?r!EF7Bf4+Sl@?%89=DqssuaB+Q~Ti
zXLo(q%dx!p>k`O(ygvN0($_8DqA`x%K*ot!W6QQm*{&tDAYdDqY2C5}_TvQzMz3tp
zw`+SMtM9Ni??hz*k|9G8;Iu7NM;Ejv>Qa&@Ge@;E92Z*5E>C!o1ahjUMe6F-wudz4
zf4gGRAiTx1I=UzO%e)_)M5JB{;VA(H2}y>c$@Z;}>$JzGX6cFU9dhm%4xw9X|8Oy!
zg}1Dutvxy-vrEbytYPR*L^UBcci{NJuCI1R?v*(yHIE2cm~W>69g74C33+ow&xj$a
zx)>NFK7My9?e*#_s*M}_!RM!IY#Xb^ViTzFRGnM16DMZN5Fa$Am}<lxhVp_mvBvX?
z%QW&KbqN7bbV$_cZ+@+VUyDFX<Aa^D7bY42l}1#q|JqEbeW)6B4~Q4X6F&$Yl*g8D
zHvrd(&^d0{@ovJlg)0vMr=I7LlDRJW17~Wo!j1+NG-(s{wxTL2<V=OfN*XYr;ZyDp
z;Z;g<bh*L7Czl$TpDa1i0A;sA=%-#KlXs7x2T;5$E1Uo6>*W{=j!$gDe2)vi0}{_G
z<&8>v+QHa`pd#8UAzahMijSvoD_gXfUOIc%#2qq$ne~{tgE%9!8Mve|z?eUgmn?tg
z>GH8gQZ3z^E<u?;UtY7E39H;8<}PXUg|t525NclhIQ457E;tcj%P*cidS6|=;M>rX
za|jIz1!79E_0yao)sVC{j0(|R7JOLm15oJ$pHehU5cz=o7a8uHJvY(0hxiR*o*;%V
zA>n981W|=Z+8@McoWuFCH0@CKZlXjINt86;B4VZOEC_o1=ETX9uc@83<!wN=M?`vX
zwZD%UGjbr)Mc4Y~4FyEmhAaGncE;fA=P=B<M#Bu{L(sy{*ZZ`iqEJ=<qXaUm@a84b
znc}hMBc$}?WTWFN{aUFo2$qQ*5u~bO{df;OG)Dj^rUW=vn$us0FgYmo=nxp`K((c$
zfa$t$ScAMrSw-{1#xtg11)RDN$9_Gf*c2v~SmiB9a$negUhW{oji;@zXozVDw1j6)
z$|OrA86yK;K}sqJ(rIC^_U`}y2wU!^I0a+!zN^4acS{e3jGO5c1(axkts9bfehX*`
zyyn!i5H>jo$@lMXTWKe1HK-MW(M7q8+E}v<^bIjckX!^V5$ijZC;)n1*xLUS8OQ#`
zwPC`xztq2G0uC+|hY;@6?yRHkWKeWtbedAqp>NW*Nm>B8fgTZHu|`+%<mpqCj^brC
zBk52`h&Nb$UAPQ!7Z%Rp?1Is;E#b{y(`E0x1`|SPgl{ruu7hv<Ibj1LQK(J*_})D?
zV*FV8JZ^Q`b1KxHMW>b>FCqMFukJZHf-%JBtDoP#f1khiM7QmCr|wBS|2X<caGk23
z)}Ls=#8e7j*&|?;kOpH19;O44MdWd($v_+@J(;%(cL-@<e!m_MZddL--fNo26}DJl
zS|}n&3Qx$cb3c2OmYN22UEe;>0(lA~EOMu9^b2rk(V~h?Ol86OcD9V`kn5!bo!@X&
zj@f$@do@~x0VD0Q8K$nH=^N*G{sftJyoH4yqyX`w!j8G&vR!pfuIHEDdGKJ#>G{x=
z561NxMYtF5Z@>~dX-!jDn;p^{Q&1!WLT51t5DzMWu>dn54rVy4(H-5+WPdnsnKrNi
zhgB}Qm`h3Af=m!UEMAs0Z-GO^-kS?rNB`{prU*I5GoZsit7RHZ@xG-2=!&A|(ipX|
z4I2LQX>4FTQ%M1PXY}2<YG`}0A?i5FQ=AlLTjV>(a!|ofy`jggeAn0s>8?KpNsK=H
zC)KMFFLcm;S*t9>X0bh?`X)Qs-os;&!y`&Tc;LW_wjao3R3^oaz8{FmY$1G5)%!39
zN88VR$cC1A{lJ9i%T1^sg?yD1R9W-S2JeTjyTTKu=VY!^;n91HDlAHyMT>6#IH%CY
z&6xuxzztKwbI3^3{`&a#(%|J!ZxXp_fM+C?v5E_56r;n4`7W~hg@ZqHpUdRg(9v~9
zjp~TCfMg;FdES7HGq0T8hkTfn1W)qTvu9WDb!17f!H<Fc`Z2)#+qJcF&;2<p)S7LV
z1hye8JK7jBb?kZkx5sba=P<RXH`C*5SFiO_A9M2h%emDT<*bejes!Z53&)#yoQVT6
z9B)Jh-{uwG3*E7c=!jRn(zI#01{YePQh`vw4Ht@@tP&7D4lQnMxl=$Rrx6mPI|>h`
zvN9E>&B@+NC#astuc@rmN!J(=<iK=4m_l*j)UCH(y~G_K9ZfG;QUta%aOx~I0NitU
zi-=O|GQOi|DZ*hJiQ^)#GtB`rTTSBs_V7=0pZo!fgS2i@pvmH3yqe?hoxUGtQ*IaN
zMu(hMGQ%9IIsMD7yMuIJaVFb+ewLOcDmS@vT>njx{o^&3t1Z{0A`qu35#%#C748^k
zdHC?*RjWe}Ty`J_Lx}h=;HwhMKGBje>|e;wF(`L)4s_enVAuPwq!Iq(EPePJJwn#L
zf1t$#>ho1YeFNtYUZhM6LpzG2a*uhr41R<)fqGJGlwNxDYh_B-^M-#;E2F~P5)H~x
zNDhER4LCzGTO)xK1epY$xVQK{@SPukn9MbVc1Nfz2pZR48zl3fflCT@W4HJGMDUdg
z-AwFh(i|CD*g;VGrtGA%9JeY8Y}JMhU;jF|YuTUxr3HKTwT68|)0GArtK@*u_6F1w
zvSN}9!bZPFAQ?%)clCt-gI(0hahKUYFP@1ETPu@P`{6G^2aIuT&|yo*8CUMXk~7*B
z$AXZ^vuAhwSjloZ5%y3k30IyGBQ!z<Ob_&gO`vg0jw9^Mkg^-5<2FiYah`?+@&1!5
z375fGGM-tAbxkfple@MY$p`1rj~F0UT9}X+!7O6jM%s<H+NhG3cWPxTRFC|aHvNj9
znrtZN>s0-&9tbqN4T$x{=U_(1pgrvf@qbG4<u!(Bmogn>-vb2!Vvu-;J#J_n2D0lY
z^Oq|MYVogGx^&L_hr2S~reLl;gn#*mlA%Y=g!@A(?IK48AFX)*<<r9`G9wfQS;Urk
z*@KTS!(`^KmoaBSAX*N3Br*#+AjOo$ivuC!N(mEwru1pd$l!A^wGT_Oid8=pUL9iB
zB=Tl{fu1a32Gqo2YDRSULS*s6Xp-oDZqAGopSQOkra{6<hpE-(Q~@Pu{E9-W-Vf_M
zd-@bRMoo}F`Ben6bmm58<OyJ*CCgl*srHdic!yXO39lFcHX<tO*1F{<ofz^4Q!{yy
zvPIDV<65Za*V3kVwm01lizu~SCuIsZeBs3!Um85r@=92p)3z)!JTzVtS`s541@9bV
ztJi|kCyY^nebA$uP$l)>i~;~1ce48Ycv5y}fYD{?Hp+_CSjZ&UsUAdgvV*vuSLJ~f
zXHJsGh6?<I>%>I%<cWsxKir8U!VYGW3B_MhX;}lI=k-9QVYnrWUW--EeL+FgAb#u=
z&OsOR`-K2{0{DQ_G)Fg3QT_F=1Rcxmvf6wAk1;9lM|pXtSgVVjVO(u{?7=!0kZv3i
zeJDC6!p(rAu0s#j;?6q2xJ9H=rM9JW$?x6hb-EK-+_m15SOj_joJ<O8-oCwsV6!x2
zRU>ytAW99T5)a|T+1l8QMmw4PQWJ{DqGX?X+ukhw@csv9Jd|clLlI4&eS<5cA2>u*
z)E|%(J=PtP`CXcayAXrMBjsFKL~IO&kFTy!R%B;oX#;7*uDPH1{S^2T+>_1_dv%!X
z-==KByXEVP1?0s8SRwi<w0YETNMqML8Z~Sfz#WWBpymf^Tomi(aB9}9-S_%)XBsFd
z?8e~J82};6a_ZF1*wwzF19<}?fIH46xE&!BU-|nkCRpg7Sg~y-Wl1Pg$*))A9)|00
zMG&?F;fESijn^MOj3>K}2I()UT$2f$##J+!JUJNior5r<w%k83ER;Fc<9$~&ZaiGc
z%HQTISAJf<vglE8VB&y-!`5sDpjTHcqMUp~Rn%qBpfKl;Ihz#PsC?xUEut|HL=K#I
z2OZE3upe~+3UOWK#*Br`uBv!lQeqD8-V6%687Nu<#d-3{dBUQ>B{ys{VuSlLu)kOP
z9$?eK<9Vced$$c6n&UCOe&vEt{)DVvpj6KJz$GE-!DH#pAK&))?IlJF0~m?rz=qnn
zZ{OXu?ay6g$`pD0_;`VZPAvtt85h+4?(7i@u}Pl{eN6B*-iz&qLo;R<URmR>(54Hq
zjXp&9n1dyb&c!6CI=$Jtsg_ncb^9@X5&RXP9DAQ@o(J%4K=(2MrK#vb*L|+HiN!Fw
zXj0$&8g{TYGC#OlZ@_?^@Ob0_2xP=ary!_HD_I{xb$yo@UJ%qdfqA~z{g>k!W4PrB
zGKNlnq(0+(vugBSeSLGcxsn%q^1MFjZXb7eLCT4kAO0fd&KgoxBt1)=(cI1H#e;!L
zO`v75?I4_4Po0>ko;W1zfJk5dHoEmQ`ICwrG@A6=(LgNwNRaC2YQU*e*S2R(?)2$9
z1o}l}9eMJkIYnZxFQLvY1`+~KT_63h1+0z%Xg1PH*YhU0^Xu!xsWTim<7tgYDQ4#8
zc4c%L9HBwyE?sJUXLb?)2AU~zSAz$%h=GtGic0o??qV7HqTVv6pVzPQVselet|r&Y
zyak?qJ8L@#F@n~IydRi*xTqFu+|>|RDUtVRUSjUj1%i1KheanJdSavUhPr-~b8()a
z;}nLw-d#^S-mB4`jIM0ccv(0dHd#gC6X1)ycMAtNPP9|2s7%{Z()T=0$6FCU93l(t
zfYSgDn4wuZYY)j|C*?5l$&{AQ^Y|4(GaYju1qF8W=)H?SHEZz#&-owhN@i>16$hM9
z$p-P)P*gfttUS)lN@?^PO<R(P8L=UNvtt+6Yx)dwA_&oDm`4L<ex*ggi8ZLaU5(#F
zm`+O{pKjY0$IIomt;D`SUGaugu<cPPeMkXjL7clh;L`KU3I_Z+chS)%;I_BcZX4J9
zc4aYyf!D8I88Njq1KA2ZcI?<43&jQME1bc5e{uR)X;%}-^M^syRdEMgYCIgfXCb%E
zSFGsE;XIu`ar^XJSco)d9x?!8r1!yTD;r|cIthy-K`8~Gq)66Ka7H)%Kc~*Q#?E|E
zYFe5PeiFBDN2e{fy6CWpI_(un6w$_2MXu#8vHn8F194aU*q5a*v|u?dTr)8wq6j=s
z-ykR;?@<yJ4@CgX#M@0%hwRFDz_7S63}?`+ad3yBQo?ROS%*LoC`=LNUwV}*sWPdA
zWWo2g{E-ywlo#yQNL}|S#+I|Q4vo7E|7j+6^k1`jwJ1=%w^jCmu12Q$>anky*H*FI
zts0oY1`VO?BLbu%dEa&@&>}yH&jI6BC|jfA-HSoEzW`l`e{!=1?M%tifUHPrjyvs#
zLlwn~!=HV{luwD@L-*`qLtt{VKC!v{Nq8m$5~k0bHwW524|QFJgQJ6k=Ma47oiDoW
zy>FG<M#>&G{J<WbUYrE4R*C`Ax^?m3yv1)<4YlWZ00-4U@FWskr)FdB=wGyZZQ60d
zQRp2r3N9tQx3TN*(p$f>nC~U~Ww-SmxL_%v7gOVOO8QkWFw;uEP5_vbR`ME7;k1fX
z>*pV|ol0%kpFG=s*lNFX;mjb%;W>eK;@#O37cO#i+)CF%suU{spXxp&T$y~TxXB2k
z-MmxOP=x8R0?p4WolDJ<MunS=TgAB2srMr$+|TcWwiX-#jZ-70!vT~jjFOtj*!d3z
zK1)v=0^V9{q+WvsMk<V=!xhrpzZ{nFaG>^ovbQ}-ts#$O-jYL;MMg_HE(WksGCcNz
zNZaDk`k;Ww65qc4C!ZVZe&&(o#0R9hx+Dk#y`hklr~=y&)NyY(<dtJt6b{{n0jF@r
z`5egB)M+eC$=a;DXqFHa(1my=(kwud&5T{?%L33GOY3RDlR*Z`FxH<+5BwF=>x?^h
zJ+{<>;mWbQ6uOG=<IjyRuKbKsG2e+XWk0J+Jpz&X&@Vt?A572Ea2cX1>v)GebDQEB
zJJER1D`Eq6C*MiPx7@?D(r&;lbh?!KvJ)2CWJ*<=WsbQqO#}mmVUB>H)Zc;JYXrE;
z^S2wSl@~_)z3`@2oxKD9YDzD37P_v(C0R;qWaRCYYZ+#5za^a;-vURh>KqoMQZd~I
zT(DWbd^=C{>*B_q@}6kewgA%EGJ&FBn!wo?-2#HLwkM83yXEd60uBjTpJD+!1yP4L
zGQj`P2yln<S`$u#eI3EcV%q`Z^<*TZ%-JMhm7V{v8u@qKzI!ILGuia0_MGc`C;fMy
zYi}+%<}u^(oxNEx19lJgpVV{FvJhRr7E%3-zc+rpO+Rhzvb$%-_uAP%CnY{0GOOqG
z>E=DnvtN8}cKGM^&$CaiIb3$(+TmdTjRr1-dL2%#dEjw9ZtI``&q4+eykI4;P9dg<
zD1d19WZB@!&DxbK&GX;hphP4k9Q|ALU^3Vfuo%dMzTerjxs_Z40J*~cev|k=a&n2D
z!b2(>I_4+|@k6r-&99j<Kug@g@XRJPJ>B>2qJ)w)GMf`x95-(rC{%E$`U237R)SHY
zu^-LcqR{E`YF49j+mtta|J#TJ@gYd(EN1;gMG?<UpE=W(d9~;q3eTx_8bYZ7<bp^|
znO0D!>0J0tn9L_esTYZ76+lhJn?>)ab!DTo2qwbvlUQ&<O{V~&yyv)8mH{yEXTiD#
zhD9H;9B*v+5tPtQ9Rb?#gW6W?vLj90YiGigg{@P~#bN+FnpNo9M=PtxLY9_@O99U(
zOSt*~m`)Aw`{&Q~4Rh5a%iy?zJf-m|h+W?b?5IrzHxU$3H2l<IK#0d6u7A<9{5?_=
z(eXn~6WH()g{XJM)<OMv+EaRT8xn-<yM+=~=;S9ZY*|dS&1;ua76rq6x>r&@5GDZQ
z4w1eK{DWWp-8!>7Ok*7nm}tIB_{Nn}3bnZ(^Mp=Hu^AoT*QiO3_Rj@8Wi;w_IrlOJ
z;uJPVVGciedBG!X`#Z{($us862?X{MYIy6u*23JUUQl8(fZu##aRYrud$2I3R2c5A
z68~-bYauOSwJ^c8{gG*N=9qO0(6Dwao7Fip&BRm(Cd+6Cd;6PI;ByPLdt$A}ag4%{
z9>T<1Cxh1$06AY`>Dtk=st%Zfm>3m?JUxn;8=aBOx!D*sL?cxcIv?W~W;Fi51GjLK
zIJLQvk9`w5a^#b@aJpPJxE)AS3Im=GL1W#;c;VsWj9*n%Udc8#9Ko>1u`F1j>4xQN
zymX$W)DMDJBft3gWr*F!Wq%AE0WH=gJQxHTCe65hz~DiHgp7^?R$M1Ackk4%wCHIu
zLK3<PSsTQf&Vn)n@`uQ=;Dk+_H*`#NTl_xZC&L!1eVr^@7R5c8a*&$7E_-y$s~x8K
zs5wXe^cX}zen>w+>F|nmkTA3X%h1;;T|Dmrc8e_zEmxy;KUa3y!t<8EL^XBK!3q))
zq@?pFqJ2b4%1w}+)QmNe0E~9+azu(F^YB%4Ost+jsi@a*>OUKyNH|tr*N7}OGdGWf
zn_bq%z0=^qt>~}X(EAFXj$BpDe3gT+i3nd<etC?hNxjJ|B!sWkl!qZ(O2i@+${yx;
zcg@S1rr4enzrT$*oRsN~vAesoE79Bs%1)uBpT<6I^C_>`0sR5l2DHVGL1O~i<Y=3#
zMiXA-@_d}wjMT|9RRP|^`)+u%T=fOegXMJ72ic_fHBizY7Fhu7i|1QI_=C8(jG-EM
zxoW8F>LVvMr2?P~%huYeMv`A`bD?1T#EGf@@ejdYL~&hafBOc%PFPn^sfM3G@UfI8
zt~r2H<R8W@#W)hA$s7nLRQ5tQgE^%&vd&RXDBn8%^xpa-C#rcc!g}c0YJ}(SHuQ$f
ztX?P1L>j@O7NkDDl=32Bqc(04{bsT(bwY^8LlVs-_BKg{&l(`hlko&}w=J*3l#SGs
zvj;=IN+Yd`#^=zyD8z(PQc$dmLDr#p{;dhLs#snKYGPp@{RHq=9sX0njb2+*eJIfH
z=(lOyZg69%77>;JSzIx=ZQ_2AwtaDvNUrZu=Yxx|{^Ud5S?@No8xm@mDv5SkJz1Rq
z^;3pdlr17D1ewImN_C=6hox#Q+v8WsaPPKPow{N?2NLiKXbXLnPNspD1wvBh-IrZT
zTk(!lI4<gK+Ng>I;nUMyWP?BpwXVmfu<^FqyFYjH&-=!UVKj_AtP7X_OayKfZ3~7%
z4FG@AqMUDE5{m~i#Sl6K+2`zSb!v{abz@go*VD7lDKU6-PFFXl@THV92D@SbZojhy
z%LWY|oFlItxf8>M(I8z6wOQXKB9{=e1b4&<ErFzm@6!%P7bA7;vg_Ay)ur7sbz8o0
z7JN}m8ijI<npVs6A8H6C#q#DReAveHqlaSm$>tBPH|Oih$xy-{+7B+FaCYJUMd@~`
z1sRYv(&CK{<-Zwc#X5HEym)(cf~(up9mZ<B<)VT3J}M4-UizxBHC6nr#X6U1VEH$z
z={w;S6OH%-Z0^;mXfkrTCVCX+m%7j1adPW(xI-M(>UrVY^k+nf`b~@_#di!C&N*G9
zC*mv7J?6WJ;mQI%*#ir`X@F5!FaoMAZ+<M|_Y!f08V(dn@P<(uZ=v2Yp-y}1=1xuK
zxSzqamDzxVfF%zPHQ}dZ#zA=)uhpWv0!704h5kyQH|caSGT*~8dke35tGs48x0s6N
zX!)ucMH_{wiI01m;p<jioz!amx^-A_wIiamzT5ikZxm5=nQa@Rc=P<Ha#mt-{8I+x
zLV_n&=V*;R4$<h3`4IjfvO1iP5n|PBT-IOYM6v3W{~z~%`lXJg|Kkh5pz<bgX4&k{
zdYw8Qndd*oN-Q)bO}`yt$&^!^X&8|2&q<85h0rQ&Xr?{(S86B?6j}M&J$b;O)wuJ2
zjrODvLEZCk#&%}Vvds{7CEPBJhuwZxgo;L**eSjY*;ifVoVTO~WKqVttBw!ww-VqQ
zIgPG`xxDY?xy+LQceG)Xz0d#2=60Ej0V4wqZ-1X3WzGT#HBHSem_!Uk;jCq94`oX>
z%kmP!@&++#xvOHSU?Vg4%^30>Z!g*QoOocm_CAsg=C(V3%k!6GeeJ1&=|jZN%e++M
z5xfW^mJb&8H?SaHL(P*#c3_d>FUM&PU{?dYkB>p=18Mmev4;n(aEh!zAp6i}*s+Km
zOD_LCds^>%nN}aR<QIUI)g5;<Vx6^2X9-@cK-`#xG>=Oa(jZbfpE|*(@1NIBef!Dt
zmN9ckhPq&BH<^U>m^3baH;g<6zT({PJzH-#)fp3YX?))-no?iBqKnH|X7gZAVva}l
z%i==UA^*xhELqZxp^5^Awj8<lxy}J`6BzZO&3fy2ij@Bfdx_AGNBE24=K&Gn?Zr)n
z5cy>N1m$YZ;|Q}K%9by4!`<djRC}9X6o%3nh+Mu5Q>^Uk8(bUamZSF4qo);Pfj%AA
z&{z|EukLrF<AEfm%s-MirnKCpt?Hxw)Piv>$ePybSSA-XcXo7QTzn+D;AE7zEYJqY
zhCYBHsenYR#7&#>-TDq2IbejSe{Aqc#F|tjteoOH`muQ@QKvyYwj}@03*||mpHZPV
zmlvwOt3f1BnpB6+-A(Z~Cj0=vU*z^KfqZ1@;&SoMHPg=HQKU;mq^}a<4L1;k%o`eA
zVRk?*ZM3)Ki4GM<QeeJF76sp~aQ8~Tv&GG)A?LuTwM6IxX=&qzd;Z>gs`)wQ$~s^z
z{tR?qbDvto=sZnfrIJ{t^XbI)FtONu24O|+F{4hbGk2E_?VOsGr3SF%wQE;Ps1`E+
zf|TQ3Hrr4216GI-8ANF<n#G?#e^S+m*uOB_WD>~B<QFF2*^9{GogCx-v$}dAXtlIm
zyv{kex?!IpZUB-36WV7E`G>D#pCJ<b3o6<0bEs_NG8c#=Hw~7o8F+HpNk^#4mEr4+
zK$^Wsv9{Du9DdV`^vwJBBTk*l$SVy*mkHT?bi~Y08eG~GQ{1$S*$8^L>DzkB%GiN4
zWJ22FxUmMc@jz)EiF_4T_jjfpVrl)cW$Tm3B*bmjNKZ5yVRZDwi9m1x^rNzfC;G%b
zB_PUo&s4GzwVa*Z+uTv(kp@PC94k?cz*g8wX?P13x6sj<oC)CUdaWtIwUUCD(vj6F
zvMzvvUS!L+Z<~lMIwVhLQ=OV-;AUW^A^KlGwSdIN5TzJ~EoM?N2<Lx6jcMCu?5gdA
z=MPkG4ZLwo*o4*fnOQLwd;8V7QCnjOU~un3yDztYT)BMNhJ!D75+F~ZQ_>w&!n6j$
z7yA&@c_&E1DrzOMJ46Y_j;3V36@_(xDn}7+>?=xOX@wa&-F&r5xujc+w)}k|=I3am
zid%{zXnVyFDq@eVto+2>$d_O&dv*yb(y+u1qZgJP4a`HI4nS`eh20;_#OU}H7}!#l
zJ$tTgg(n6$_iIcG7{}JzpBXc#^^HbUCx8^^*k4mSd@#VPjK=9MKAnuEu%%v1VH?e}
zy?=_V6%-I!i51rwR4_SAVUj0)l})eqZ3!c>2}g@LMSa>Iii~v-x=nZhx{j)#SYAlP
z_l@2(xwaJ}ZYk%$DEfgx9a%A@_##(?ftgR~4_|B##xC`h1un9z2v)_EnV}Jf&Q4Op
zAbJzq4dGskLlWF{ZIqlW6CDkB_aP|%$ar7fTA-73hAuWhAVg`AZZV^RpA%uIS>8k(
z5~R%Pul#_VC4ZWVwtUev&GIXhB|y(1$=b@Z#I(!W+Jbj&CB64c5}I^LD5b3PpCUR0
zmJwdhfR;hym^}Ki8ynGWkNs^%?}EJ`ORgdRc(Lxg(8(m6C`x(FNUbg`V_Bsb6SG<F
zu&^cR7on2-KwlGEg?@tvizi}Xw%>g6WJzf$<Uxz2g*@a}NF}6Ui|_ko>Gf+6tzaga
zP;h-0YjFr+Vv_x7<yi<R7`ui%ZVZsHiJyAwzn21D5izmXJDN+ep5W7JQ>bzgqX&g*
z<C~xW%#1j5rsi-uBX&!+uAyvOn_o+cUBwa|k^Jue@0C+&3gZkvZ^OUCS;|DqoX#5~
zWfU#UKbpb;k!^jjgoTS#HdJXl2KwNqIh!X@@C@)S*$Dn1tAlu{#X^RH8zolDuD!h<
zU0L%NmFMcp5eqCWz0nR#d#a7Kek0+6?X$S&pz)}Af=V`20`gKF%wdH0!n$*jAOiXZ
z{=LP8czc7-BX+Skc8(_QF}hOg&|y;buY1ZXMS@Oq8`g1m>$Qa7aWvosyPp~{-p85k
zN5SSEKK7?DVk0dDJYT5kGwOd|Ij9$}&N`oIi7z}Wg$)BJYJ@k5-Lls<R;i07>Lv)G
zs8-&*dzYhiA{7#n^pJn*uT2Vh5Y#@>jL{9th6yC5lU;j{F@Z^fL$WMrCe#R&$65kr
zrY5d~j_jha=51ec)cSr&q^P`oalbg~;ypQ3r8|rWCR&#B=gww&A_h9Jz<nTy7CKD<
zAovyDhS?=}ou%ihZia^N7-M1{pL{rZ;>3CwSrhp2Y#6(G`9ci%_!It=DxT%#6v8P)
zO}>o%4}BP#svtTz>|89=Cqb+FwBx-ivKBhN+dqsF8LJbvyN8Zm{sRW{IED)56DG(8
zZ0-)3H$Fti^fhN9>>tDMefwl#In8-w^r3zt38!OXdu$W7h%s*GhY#?Bb*l!QICY&`
zrH*3M?=N+`?o-H~Jm3b|mb+NLK}my*E!D916o;E$1bJ7*F(ri<mAvEvR(%$04Ax^q
zGlsPr-|MDFGGuQ8ULc-x^bl04dAlns{9cNo6_c)gN<}I>N-?_O@A~tlbF@sm;9FEz
zu~e<=<(){r6@q+anyFfv{E6`g4&1L?U%j!Ew24Yh7KSoMx>usHTnGCR=!b$V0j$^$
zb22+dHW8&3+K;H~mVQ+SxYrB|<^4m`5QER-v9U)DTXpJ8Qt|>36-z(r2&xdp{>*O8
zm%C~A?;q0r*foL2*uMw+dYaWGTt0C5#t`FZ{F$?Jan2p-`8$AUnx$3m<}sI&-(NOR
zcO35C+ysoT;N*=3EFhZQyOr1&kv4%0riPE5A}d|#N{bHMxqytDSQvb2^9x*DUZQ7N
zhwA96qtw@t0t*qY!v^KiGl=?G>jls)Fmrt@+GQdEKGgJv=Y~r5)Iic;uUaZ~KcHe3
z!x!0qHQ>{sxxHI8qRhk@^GNievr=H8^RuzBQQ-2(LC(@Lix@QI#&wTh35EJ}Rtm3*
z29b-d53ePerqW4%2+HnDvqz8YM}><wS7QaN@MK1>SjCB@Yk2bte^{<EM=xvBS%_6A
zIO&Y~iGSng&%uN?S(;O3Z(@irRTy&?-YbtXw<6}+=AE1&%u(X;xHZ1Vk59_zcAV<I
zPRo|NcGtC6&JH1ObXo;2K7J|QMAHA09MY)nB!(<q9$5(~&yT<*t5>CZA;m7u$a(T4
z08(yCQc85T|76TdIzcg!qK=nNIchTVf`;s_ZU~WaHp&M9RmETm82p&w?kQ#z-dIl@
z)h~YiT9(R_GW~NB6>N;|O3xQkSpjpR<tCJw_>6?Eob;k%g70y%=VVQjxdTIfP$ujh
z>eQLK5cPT2^SyEojr7<;3%rnTTJ(E3A(vim)x`%(A#A|IPe&p4be=EwS*;KFkSxQ2
zIl*xO5yqjau&kS*me#@DX05cCYbv3jQfu8holnHJ(V|yvpJqVU0pFIrl}v5ST-$r=
z(_FwCoAUknEWis2&_zmlt)XSVX0}PEArvoZ;m=#1+7-U?<?3hJJ#}=93o>7V6AyQ<
z+A%1gp%~kU<*QcIM3zG#ZjOMdOV2k3{VfPe{VyL!SgQCMtr=5Oft@JbUzV0}7vgLR
zQBUME@P@pkpr#1rj&!Znt9Jm(B1+D&u8orri^|qlx|q-(>V~tOocgzEy!lSjtVvU3
z)u=_YuJ*=q$r-)+6KMdZ>qrSj_z=dasEXV?B3<}&PRz8Zj%}zw*+LfG)gKrR`kWsL
zHhVQcLQVsa5_yK;mUkD~(vXYWv7u(C&cJg7Dk)&dVq#hjD%i*IK;U;8E%7dU+uVdw
zRZNPIzxw4Q-mG1q_pn*!CLbx4#h8{>L6#ZP*z>pjm<AR0r$`q^m`fJ>j*MBcqHKsT
zD#LFsxgaJDB1M%v!|-Kse(OO5BVV8?oWFh-KAeZ~4L<W(W&1rzT%2T6VmBe`>5PBR
z1jkfBK8jTF9Hfr|pb|$zS&v5h!BB&qnT!6ta6S1T-r`>Xr8Bf*W_FVH?C)mH7j`?r
zLR@Q@JS7&ZcA>1Mk@L#AWr;2ZC%Tx^hx*A5IDh~8%s(k`MaU1dmS|T#0$M+@!>LgF
zDS*H|&AsAX!w5e|yQhMp+5YOo?3oOzRQ6}e4jFN11oV;=Lyu3ei7@O?1VgoRa}&4T
zm?401!`3w+B+8_T(jYW#N+(;ka?svX9QbL7(h|X&G;SfDMZ23a(-OiVOxq7ZV^q%)
zj{bB8>DneOsy~iZ4Fk#p=fM~+pnE05!|mibTL^T*f8%tlTdno_nJ2p{(1_Zhf7ol_
z(v!#4Nk=DlVZI*c0$C`t?xx%@O5|)$it2QDk|O4pS`h-L&`*U-7&I;*KmdENTgp8@
zDqVCDXMsD>6E%UI>73qtJg^BqO3jhG>z<l3ckWhF(V^$g2#As?!!fd*KwWr|tM~6%
zd25;O;S=o7+uCgbLp2_-xUPl8YU9!A!<MMl9Z#J&;T;;<9CS^V)ZIU5xM!zh!;}9S
z`Pp%r2?Vue?+t<UFsB#tFifv!E}66sw%{Ag;0-||o_@PXJ^v}On~^H+;)5zYj8su;
z4dR*M^CrVXLbXEnJIT5(aVy~RDiB!w2LDiuyuM;ENt)QkcfvNSs$fGO`U@l=F>gQD
zRdCf(p+1VLmwjJ$l#ua@mo`%I^(HjRjbjGE$=WR7`Z?twQLz)o=Zv7vU^)Zc|G>2y
zzghw%j|1k!ZMJT!t(!pfXD)B2HiL;ORo87|{nL3-SB%1XQgMpO9XZr^&P1Of%14a8
zQ8;3-uLhZ=4wE5SAPE1#7{KX6P&YMR3B~gy*TzStTU&3#b-?@9E7@5rNr2~M=DS->
z6B`x~&Q)-Xz(sSk{Pha)Y6RTx&WOXTn_A9G=wt2|>TOrEpo0@%E0|vb>+4qh9jK-Y
z3?zG&3)*d<5|ze~frMz|g&=QhyC|!#7Uu@RvI+&h0Pv74wZ8kT#1umG8dtAw@V5?*
z*vvXcX|yO*1yhx-lZ1W_+x-d;3+KJE0t;fPxcf3b{xjlZ!zq$^o$mXd>9SOv1AFXS
zy&s}Lk*V;D7l+P=XF?34fZYVeYs&n&ZMt^rMt|6x0`2wHmey?OnKE-`jG+p7Q<<zz
zSAWsLXR#yoRuroG+Uj*+73408$juBUDA1>^9$^F^ISk%<%H6vsW*ja;rVIY^k|y!f
z3bn=k+C0Gmgf5Fu9X?q9&cnU^qvqvzQC-MFb3a%_iFRtrlRZ9;hAq&Uv^Kl<%#3up
z$h@3>KN)z6V<Z?I@7;^FG90s;%vb<QiTxz1cUvE}Ht?Z|qs|wyIs7wYDy!Y?mmkFn
zje1iy6Y$oHuhyO7BPJ?2yS~r>f#?g5lZ_w~=geC;5Z<dO%fZz94Hz&62pYieLs04^
zv1rRv&ZfaIZ)aj>Ydi9n+vG2LBtJ1DEo-x&MZ0z)7=KMgCTCAjS(LVS@aoc<7y;iV
zWNA_hF$n<J|6|<@M;Ih|Hi-DJ0G->QSFE!)^ZhW3XM5{khoO~~zji5K6snZ3Zt^Zb
zQ7|G)n-`_pe$77a?WAlDmvQprjN1L=Vu&k*(e1l?G*TXc0CgLgL5CuSX_@pn)%vU^
zV@*{9*>|ZI<FCGa2)0JguWx8Ayal3~cvF#=67AGGo6xet{19b)KYXiYxjQjG>`X@U
zdPrM_&(T{6XFl|!CUF7@)$6T!Z+@RiO6u_MFtShXnW_di$SN{UHs83`{o};bvQ!FH
zqAt_|clY5-oBnfHYM~b|k|q}AN*4#r#rt~ZF%Nrg5CR)UdlbDt%icdLC^&NBgjtsw
z=3%zXyTp%{8s(GQ@!!)JfiQj+B0m=({{6>*QRMtjH6yDJ@tB_0dOFt*!?YY6MiMIP
z+@0pFB+j=Pvcme*s2dc?IB<!n*k2u8*;0x?jV66*?GTO4qhjaPuicoRxhE`4oTd;|
zNx8}J<QzT-;>LdSnDI(DDq_(^>VKFt>&82n3b$cO36KEyacx!QvkAm?*t23BDZzm<
zD=I3=7gxxsgBQlZ{1FFY8aGq35evWHYBuU6R-fYCDBD@7lXJBKSF(O#jlR(!dOx|d
zT_(^86Xe9z-@HWq+EE1by!1i(9<}=OO?ks6a0g+c)&ZGV^w(dqq->qYpXSXoTVrp?
z*()!sV{bHL=1i5r`<rl$WsJw0AIGfn&(9oJ?KfnIDf5TI{#BEJFBt*XCFNs>4*<{^
zj)cZ@bE;fM{{=P^vNrSImAcYAy@$+vEH@WI$t|P;cdZP<`|q<53I)MSmI6L3GMNJn
zT&0PoAIQj;ZwAUM8Ly_GKtPir$iC1i7}n&1Z1*R~-==D`(!}s(8|L2rJg%Gr7X5_2
zm{VCHym#VOYUtt53}=kk5G6=WT%T><KNkh_&f$Y^)9YSJX;v{YDvlf^ExK7O=pI<>
zs|!QUQSB*{GH4owx&dJ~%z8o=jI_>>j&A&}n6N)7DAjf$Yzpy%EBT4NyCi6?|11|j
zGoqZl970|vc04gaaW;*d&c6#ofGOV}V6(rk{UzFGrf<@ya2aJ?c>eyO++W#f%XA{)
zrz69BcB^cok9s&V2}4}wN!u)3-`3?<QvBBQzh%Veg8E0$Xx@Mf|Hx%X7JL#De{R&Y
za4U@OfeaBY?xXyC$)OafFF#fur$*fbY+8J&$g{ZQW`M3HEiecRxnt~{iQPiYXg17P
z{Yr8ckX4!m7)?}V6l_{6x(6gd_eL=o)nx*IUfNSQ7E`7MzwASJ1JQZSsf>TeG%JO)
zkG(;Y|Ar@gG>M#m9<=+D97h_>ppKy*`P19!D#gNnfYc!l$5d|(nOREN&+8`zI;ZOx
z1OVgG;@b~9p7v0hD!PSYvaPtC)8Mr__-wH1E48+58?@S5kG?T6O0Dx2IeG$wBC6IB
zRube2S+FRU*%XJack~1G+JUmr=+g~t2N<dN+kn+jvb-8T-5j&NU7-Ajuoo4K`;Xfn
zy_bNLfH}ASburVVjFT^gFp#R>a^Ad&u7i?hARMM=CGZp1l5P4?e;CinTtW<l#FvIw
ziEdn<WkP+y8`K6alpqjb#veG`?gRVWLLW!XK?Ho0IFlAe5kE+rdzvwcN%N{xm#=8{
z;`z@#m_gyg5;5=8d|HuL@874-_<A1&jo8s*nzH$P4=bPE%;f|agMfy7*%#t`mR4YQ
za)(%iL&Cm(v_D%I4gpIlXk(N4pRwt+4h0&g(!7N3ZVXqR%*Lph-nN(+blAf}NEZnS
z*c?0hFH`MgHThqFR625@vjHANp{)bukf9rlYew3##7I_%NLO+2;JgXGA9?saGILoc
zfegJ9Lts?qN8$&^i7G|BU;c$2+R;ihCj5wtK3t%%y!L~aJ=y5lRDD6ZO+S31R5;eM
zY7ezpr&|BoW-ByJwr<%XfLMWYHXu3q{Ocm)hDIZJn2Lx`mGj_-5_tR>{i;jP0zC}@
zq&LKw2A@h#1%0F4WHc9|lD)PkN@gZBSy%{&a0DusG;V@%bIB5m)wQ<WT_j7YsfuC@
z8y4{aZ<1Glo9l3QT-%3y=T|W}{&T@`uxP}a<L5f1jIZCKQ$N_pbrjTMAI~~=!1@lV
z6#nL|j$fRaV$b#xX$gcAMo~X){tf<t=024dL*=3yH#v)K*ea9(0c=d?KVfO0gi({^
zVG4(aK>xzY1foHc(f}So(j2|i$^1QzpbRJPIsC+q@aa=c(pgyEvd8Wh4lIb7RB=HB
zxPUfku**LNRm{Lw9EMV)p^9Skf(0ELtN8BJ|C%|(b;Gw0-hwo+!3Z9aEFu`@R-=dA
zCZhm{uivtkh!&J4l>ICjGlGcEF9`#(j&zob@;tIOYuyD-5s+%>(rm53V>N|)#TQ=)
zZ2T7I^v=qoC2($Q>r1lfOyHz?k2#$HPZG<k7w`68;P;8Y))#084@VLy#1fHd&eYu@
z5nSv^871q9KWAs3-t8h@vFj>JS|SM-3riW6A^sN!0jW$OLCV~pF$gq>;=~5)s5cl6
za-@4fa5qU^5N9kM6S0NLQSEYr<IXs2c+syO^<VFgEg#f>BGc5F(^`l=mZOf#cO4iB
ze6|lkw})Jw)4ynVgY73(vM~=>y=IOVV_by-Tf?Fw`4i2}X}Rh$AP?rJZ7E*XRabOn
zrsr34afT_8TuG6m{ZypzeNMf(e(l;>wyp|^fML^yj313Vt%uPdyZOWyrA*iT6*#g$
z7xK{Xi)5r6&D(p0SYpbwX;B=x2qs9DAk2quHIMHMckCv<4VzD%bns8Q^B-e^u;0(-
z*w_E%0w9TD%;NmyVqk6fhz)Bq90I9Qr&|4DFed(H%mZ~}CwyrJy2q42m4?HY3L3Ow
z8<ciAh*Bk>7-3j@8;4F24W@oHkL(L$h%vbgBfD14zqZbs8P4F?am!<=+tCQ^tgMK|
z0x_8LCHA_If}GQ<PeMgZTB<f<>eMl{HUB^^z3meFu0f=Lqb#MPXo3EHdr0oo>Qtz|
zwEce60|}+2bOtitS+{=u>by3&_$#biw~ig(bvyqujI56N0ij8f1ZY^Ij>}%+iVo`<
zgv7_;;DZ^tcJT=o>AJ*C%17d6UB2r*2dM8Lz$fNCJi<XHFLN}$6r>ZLL}|<LY*YKN
z*T%Ig)c)B?g78RKQA2+x^LvD}f_4B%%1QxnT)*?@D@e`H?g3~)n)E_tBRyXADVO7%
zKJB4H+mI)#ii1aiv-Sgv>ako+A2DZibeA~;i<;6F3l|UgL5=|)kd%MOymbMOPR?7f
zKQy#1x$ifdxUJvI1rXIB?cW(kb*(6!?g5Z3Iu9Du0vkjTu9I$@s=h3Q`rwthL<02i
zhuRL|?M%jg)bBNf7-6MpjI)jpl89nROAx|_4|_6MwF4j{I-qPVUp+BOfMk7>2M;-p
z&znPM4BEe)5R{{}No@*XD-B`U+2wbY%exA{p$&~~{O_Bv-wbPhmg;euWw`Q2MI{sQ
zy?ABHL!ym761{}XCnldrwpLe|-a+Ceji%7^@Cb$J4vKVVy>a9%RQ19ZW8{amAUu1W
zm-qzT)m*x8bmeDvQkjS=`M$)vR*<WR-{<Go7;@3%W}&fF0ONAjVkmAnYxPDJK8dmQ
zvFC4-CCfAPZioTC#AGlc-SN8C)aQW$R?eAorBGj7T6wQ5VF*3dTkOK2jh(|<{L$mb
zt7lBelF@)THiFrXU3>2nHUBEuxg-m(yNha$-3`)KXj57e)Wm6%5lw#t66U4Am&LF{
zWNY!W-xmSs0Bvh*r)3N0KxPvU&3pulll}<k{?v_eNChZkzkK;J`hRP|E&NicA~;B5
zB}`s^QgJ1-Neoz9QS3%uxzH>)3!tkn-^Jx05&bnM(+2Di>&Ga=pwSVDMzm3_1aMud
zw)_}Ps7MLP%{~-ixc!WG?edgYdGYF>rbB!e!5Z?1NxbC|3(KU`$|T+X(B?ZCD%k=6
z5o{sWZ9<UkHMw>cIf<3b7ES#tSn#V(Og0(Z$fN$!#$Bxha%Os@QQhMm%t0CXak<CW
zHRvcYRslsJ_+1yjh%MW;3A<d^ZNzA`Ph$nr6)e_#R%XH`Y!z9cw~hAQj=UYeNW10+
zyh%H%@7ee_bPY8DM{Pz$z>3CjA7?*pa+!b+;MW3-$jp#xg=A#1gRTIjvl^5>W~#!)
z<dP&NhL_pLM<yD5gO{^c-?0@CM~_nlr`@g(cZ>SxnQR>;YDwQ*rdyOcxw%Q55=|)r
zEulg)@kh_HW7_)#at@d+U)pfpeV~?>7Di+O_MbBNZ@384Yplc1Ck(3ypO13x+~0b*
z&?geaRRAw$2k6Qg0AVKTsJnL|Tu@!eihF^;tD8hYKdJipQ@lUbnmZOf^S9{sb?dYp
zxUFrWZJZPBnb4pi(6i#DgVixVKa-3^HyD=`ZN+2~lAbqEKgh-NiuTCe%Kk0bv?zty
zQ!nnM4@=A@Owi$PlAu5;TO9X&Mkg;kAmJ+y-W#u!Crw`6){zF=4>lyM!82H1edGR;
z3m=0_dT}zuUgl4jGM;0c%zG*S`f!vn%B7v_l|SoGR(qSer5dRA^xR8L$riFUl94;j
z%@#5#1N)Ht8m$PL+0%P!H*XvwW_>M~xZ5vn+%ol6#O)vOgpCn+N9W%^cJ!!BM1;UH
z$27A$WJp;a0Anzhs5BbDjVIZy=%Ml_833u#&9m;}!tNm_KZ>I?&y!b;$B=(Q``g{6
zQsl`65(Syv#$SEF-IDT|5VrromlpkzunJYy!s0gYu~5il+aPi`_$4OvQ!R6HbA_hJ
z6%jWU5MCvhuc19jKOE>Ir~f#y?%THypkx6}1DEJYK>>5#y~1B$HmmTzr5-S2$?qrH
zR#T>Aoj-p%7LI}-!?O8>-<e9y)?<?HaHhlcc&+g5d`hjv2?_QVM7N9?T6`3l21?Nw
z6!gxZ^(aT!<6w>AS0K8aK?7=oN!@a1_=<My%i!yDuKw*+h1I7wEQVHntpi|6^KmUb
zw^LT5@?OYKeL5pc5($eDNl7)Mg3(<!fZAV$h0*0evndwvr|8wF0;1#3U_P|*apnz=
zU$T-2icA{i|2dCeYf&>q0`45v-#c>M7X=mQW~@d*(8Y4t{6cv+Ll-flCr69_b=gq&
zSiq3sOVuW_vGdB(zo%=oZe1TcQWULXqyXIVW$UQ?vEJ9NxnJ!bFp{bXFyy^~G5i<q
zMm@$ak_JubYq{28lhix_r0GSiUKm@mzMI@%2a+1&vngw}UjIVbJu&8&M>3_TRrnt2
zgDv#SI+$q>+N@EOcg^V&sw`*IBQnC2)nd>~FJHZytL0yHSeR7U!dYzW^0X^4lQ%76
z@Ip&fbrE%V%X%;htgM=pwQ#BAh>P)A$jB?V^~73}y4eQmm8`b7>LAGw8JJXfsUKC1
z`cuRIhr*@NZ!E<BhpIq|uJQl3=pxX<xAUW4+xk2{lz*qEv3#t(o=Te-mXejVW9RzX
zR%&W8hpUJzYscXi&<pK_3SKkL=}TLBI;!R6=hyd5w$J|@Lo|bMS<LmQ0vyh!BPyxe
zP&Afk4aMgr?9qP49_uShHc?HinU?{D9xUS)wX@p*r_CK%KxPL#BrBAe7s%d?M4j@M
z<Ryx-o1|@~i#O?RY6dP0R^y~L5oW09^u*7jebZxwxg&0*<ABdYu#SzT)EG*cLp=DI
zn$9K^IYTRKHCov9YXexGPS|ww>;o~3?-H}P(48dCz*z>X!d?d(1LgFG^GNN4Em2c;
zs#9B-d)`<p@BkjGF9~pOR6e_YvHi0E91M*BV*-`^O-YF?^_8&7mK>61gyB^G;w7o>
zv|wF-3?@!*MzbOo!;<tC_G<%0r8v<j9^jBERU3Si7?+0}IuyiVm)e{QCWY|Wz`z7x
zE#p5NrsN^v?PM|5RyaDci5{clO~m5KO%v2p?t&#O`g}_ddoieN!byZmQRoy<dp9$)
zYw6p-wO_w}y+!NKA2V`oG3Is%+$C*>4_?VOn8MR1Jh|xD8tRZTq7#sxY%S9_7^Iv(
zYWC>Xt*D6$+R>ro<<NfUDld!f8cq;4q;<#hf(OOg^K%T9<iKieS2N=2<LQ;cRkfOw
zVK8)P{D$=r5%`vlBfa*RlgHRNnAH*YG?QxLm`_254ZXOcNY-f$cdJll&=75CeyV(~
zuRXW`N2zFV+`c%<HwK<g|NL|jD+mg+MOHtDK=_Qn1>$_*O+Jk{YYFf5%;CvQmf-w1
zgtO_-ZrHBXRc0`@q4qHh-^BD%tQpJ3yF0#0*(651V(1D26?OUY-m>u~^-nTQrT)M}
zt_j%_v$k!2<@1G72zyr!-8_RcI`t8(s`p!iS3Wsghgh}1<3NP}?%gx}k$s6DE6b_@
zNW5VpGG$}`R!b^XFfyYI<;8Hx83iZj<eWd6{EgB-e$k31^qF9yO2R1sTKW)l>k{R>
zCHTbB;v>u>V4XQp2;6hnG5~-~aDxBZ5Qs4!gB~3r&_26pTSMHDAv4a;`E9AZRN-@b
zKY3u}KFP@FNMZdNo*1QY){TuDMdC;Ug-j-$!1o`0VoR>Z@(@<FGG6p9YZKoK`^W7^
zloxY*EXg+*du3@IHLj<k@|u`6lvRMd=?_81zb7DRYnwDWeu9U`h%?q##tc^1aQ7B8
zjp=4xQZwLsgkeM4Agh=V+!wv$io9C2MDs0s%f8@oXU7|k{TW_T;&7T3XHb<l!R`od
zuHi#?uX|}lVG8kS?uyYA9l@Ya0RsjNlJ%fMxM|+JE^z<=iqMg(wfz{SVvqeDG<lV@
z-9kbqeC_57fg|AKG!;se?9l>1N@g4l6>XyHfte?eCV@*Y5Gl~(`<E8`*sr-&NZy8G
zx*e#JUI}E-)0b=m$}{d`I}aJV11Aa(+9j4^HwBU=Xq}S2{-+J1q!4qH_wRKeDfMo(
zl@s<5!5bZiINreo<7!WG?GjnH1>RP$&q;#;81Gi^$8aqf@%yXwxtpmV#ma}tmfpyb
zC}N=oFx%aJs#NV!&Z9@sY;>pvW2jnI=uQz2*Djm)39TX$_8Zig+hIMXWl@&wR>?(*
zg3>5q-gfJ2whY{vVlBj?L~04crVC2&VpU98ukb;m1;tg^{)_d;9^}!}URchZ+o)S;
zkEyi@B<AC1&Ws~x?N2&WT^&xzJS!hflNOe){qP_-Q=;~b0qL@@%Gr>xL~O-15hMo;
zU3L%Rj7EsvY-$#ma1RCEn~19sKWExOR_I+=u3BfYy}c^+bx3$;IFQ@LJOq>jh%3gh
zY57KaO=xzJ^PrOiGKE{M7xJ=^^o6R^V{MMe-ax5C$S%-bCw|!PqMVG8sVtlLv#)dQ
z-&JMrNdj${+sFR29urSEfcUQipN<bGah4|X^87j`YM%sjMPSTyn6zvMYZj4_&!tPQ
z8Q<D33_Wn5F+*{4hj}cVg(WrI?Ug4<LKgW*qnO`HFt<$r6SATqF)H2);-KP7;kPDr
z>-x@|tkwrKXKSihrBM{m)jUI8QT_UC%TXsmP`T#)ummzMg}mNQP*OA)T`NTbz@0!<
zH$!*D?PJl=Ua7W5F#H*7SjV1gr4Iyi83z`|&vhAJW9G>bQ*K6y&750|$~aKa*<Mxa
zV^!J@I=p#ID4tI=WIs;@vpcw+=zT;Lc_wb`6yXS<_%-JE7g{DA=llRStMGV$+=F-=
z1f5PSnPF$H!i)M5se21L{o1Ad*vD|R&s9n;A^`Sg7FKJ%oO<{E<n$Z0Vo7miUD@r)
z;BNlVtwew#hC_d(fsZ<ccYlfI7uB<no`j)3E1$W)if{5w;`)`7##zP$su`n-pmwSw
z)}WSdOaFS=?Q1vMdy2K;V#{R_Ry+{o3f15C@l<AHg9&yYn8BZO`?@5jjro)qw+rFN
zuT46Q#}z+b4my(HHn&^y28OYuP@P`y0@sRVvUEm3GGPD8(EF6@-jE0|=^|<{EdXx%
zl(qXOH*NlCE_-Z*Ai_70m3<5TxkfUwC1lOMvij)w!+&>4ie-Q#ACaO(jTJ8}l9nAH
z5~_$tvILIaMtu3<%Pa(R5JpI0w(bm|4?^mc0Y>qOiJGM2up#dHSJ9yfzY<9D(4*GQ
zqG|@xWDcb_Wm>QO?c&-tR>?FQ`In827ck)GNz>K?2ojz-!PpYeNo?Ppen&Yw?kcZQ
zR-=SYyGEQf;rJ|GX@8+$8IgpjqWZ0yFSR)Yc~Ebi!Gm`X@4iyljsl}nb)*tNR?+v<
zG7cB?i(#l>M4~ol2K6wm`gLj}Fr9^e3Oc)Uveg?=b6M+-m)P(`qkYz?c%1ne(^Zpc
zVX%`y^j(M3W&ZEnQp6g3bV=9**Z9->H{$UBU*#oMd$`C-<psW$==@QM=?p9_)<q)X
ziM`ddh@HV=AVv>F)ls^`v7yF%{QwZ~Hi$Ql$Hg6sKXbek(W8VWfHo?*26<t>;+A@j
zK+%yG6PI!4PQ;??*P!XjGbVvcjsJN=a}&&fR>5?Hh$2hD8AkaK?%@nVbRR%uU29_%
zd65qZZrEjN6InVZLK(OsqIscH-<dYWr#sE3NsQ4q*w&^zZ|qp^{7~=MlV^i22t{W6
z97;^7{=o6Fv^Hrggh8yJ-WF$F_k89}Fvn#BqS&GlM*Yf$DtrC6K@9kM!Mtggs9<4z
z+GU38YaIwuGa+Qa$C8~4%nuvYuV0_*DuPT)X^s#SF@dQspw8aCEPxkcinD2y90i1X
zx=YorgUQ3GLjY%Nbp9b^3^K)Ti%(Tskg)vzSsK@dt*O9B<51NIK~u%IJX8NG+*2<w
z9gsNWxOI4@4?D!2KHa5B<N~r`GY-n3K|M6vw84f$8Nz);^dWjw;een#h72UE_MM4Z
zcd5~-|I@kg<vgt@j-0cp#%yq0S)o8MY{WYU^4;;Sb*I%d&$7&fSc}hM^rG;;9EB<k
zTlN;hY~2$>P~gDi<PW?%b-0*vi$D1LpC3hG)}b#at<hOctCMM#w4C|8wD)4!!1=Eo
z{^Ht-Lzzo-h;4LSLTaP(n;UaMk0HEB5n%4HPqiS&=3a(z8v?FOTfsE|<K5P38Qsok
z5XrfI^Q$)3XFM*uOyk8FSujbe-y?-<l~xTg3VT*r!PC0QXr_nZO(W;w!-iea8{B#n
zr7a_Vu#!~qU0nTUJkL@aH83v|kT{}KpKL33Dk`)!nnY%9KVoHNC43(E9)YAgX1@$_
zHkYmQQ{!wJGpK{mY3|zM5ZX=^T1<bk{?1PZ?kB5VZr||luV&&X!*~+-n~`mkhk#xr
z|KPuTsrhF^(lS9W|7IoREgEKNh!cy|6nq1!!?P?L1EPL=A)R7IAYXChf4;4oRqVe?
zjxmViI_v0&;*)8Z9Jqz(QUwme0*q!Eie{a``?pigB}O@Q1<L2*gq^mM$^@9QHn)rE
zCT_SdRR^B(Bv2KgJ0x)Ff5b02OMVX?7C(m<04@D{p8i+tgU+5k>qYt}X&u%()3-}=
zlN*0io((@ZxUoX~Qw12JO=hV$0zty4+zF}o^$i<>NdTD3B4~<AlIWJQ@ne$Va6(TO
z*)v^^A9iZQIcvIIrTv*=n=hCw${W`wP4Yp<#D7DUz=VZGN5_y6p#>!sXgeV5B$I<Y
z1+B~v-@235Z#4L-_KMq-Ds8czVRESjvR|3`5I>vRhl$mIw$#6ZoP$dIKSkO@O$(jQ
zou58e``!m%1~2>y4;(lk62N;U4GoAh6fF=>E5Ch%Mm6^F{jaLN$*{rYc5_d*0<<^!
z<h|?rB(;e$n=<+a8}|cfIh3398CpIgdE0$zUBmP5%(b!_V`^F-G}9kO&VT3yYfg8(
zi#Ks(o+g@0dIM+ESNp)IDU&Go>heh;4J6Yko7w3muR+6&7Nd1Z53&8*3>^@gDuK^k
z+rRDwOH|CMkJQYWJSFbTnWn;RLpqnUI%}KuhjAboNwP0Z;qKv(_MfJW(6Z{y9d$W&
z+)B}y3(pUPV@AfuN>Z&Ln4mu~!#Z^epp#-0zFEi+2noep8CV8W3iZ_guW<YP;`+aZ
z+mOQSr+qkh%uT)bwsD<oDeGosT7=74<f6mC|FRd76m&oIr_X67{@51)0l$BCYeZ~v
z@U)d!wcZ$N^o_p<-Yd;Fy2Tp?3(tVwE$-R8y!Ib(2k}CVnRM{p1xM+mC;-9+Pb@_l
zOD_N^Nye(Wr!sm8NFhp8)ZBvfVZ~p1xbpUUMwGJcQf6Wh;t3NGh8o#TFJ8RJ`sfa@
zus3s&*H-;7$MQqo6;e#|Qo@j@Q%doT<wZ$So~Sl#82Rm~$uBq>swTe2X&E5PLRXW;
zV2l(JK9=%YYcH&*ApptUgeK}W+5a%@Z#I#*cF^90%JsEt@wnm_+<ft3{>x@REyu!q
zp;TGEBI#EL5-R(hcB)u*K%JS!9TT-Vou~Q!lhtFtZZAyu-LVgD8sxNDO(JnO0cbe#
zO;JC)oT7aSJFi&ALv6*gsay4}!!*J$+`=q0JmJ$cmb1;E83~zO2Ew`;X(yW<y&y`V
z$63W*8sS726zpsNy^Db#kknp_n5@AvjIsqtq?No0^71jr*xi`W>-qCzcUXN&-6#r3
za01$cokiBWqGSB!Is;$PUx*&x@ZJzy<n54;leoKv)~og-Lcn$QVnQZ$jDY%JE$7$?
zQK7Wkeh9b_%echCTx0^w1I3LS?T_FZmdK?9^FSvn9t6A`)R?MoGUNEH_a0|#{9P5&
zz4R@{N+1g3`0s+u0Q?Jtni!>e@ZF5#wY&H23xrUKk4qCv%i7@U8-lm?sI67hl+54V
z*Q!O&U1K(l-x+ht+<bMf&I^YujxC(MY;E)6gnNr;wVPR{vD$1v&w0B}gza+PrMvUZ
zi|rFH?JMf&Sy}ivHsk(*eILKN5C2|X<ym_F{WTT+f$y)4`s|wXSCL*V*!iMkC8jcG
zVv1$`aj?*?8e?fXB8Y_;*$;vsxe0Zb#+dQk(1gCn^s$2A+5BO)!e{0TOw%&6=XJdT
zPn7u?%|g=b9j0IQ5bHsrDSDNd;mJ#QIIumP7xS#Y*Y3Gc8<}lS5tYKwYn0nIpb7rx
zViwR~`TJo;>=@~zRxeTkBhHJ)8h`it<kQ0WlVMB@(rm(iMz1U;8-ypRIT+A0Yf52z
zIHtmIAwSoz7o$~Z-vyC3GxFEKyRstt(watF0r1yc^VR+0dH<TW=eSmbaCng+f|OUY
zt*l-H<V-hxef)9L$b&sRGao!qQD9M*nDL&W`xux7Y!iL-R$tXYd~^{?(pAl7v5NGx
z|H29IbSpj$YW_Nd&*it`nmZ8*zPKcGj_)h_eEG&OrY3A*<Lf{ea1bi<`d_wX%w#j*
z55&1|-QD+qH)gIYBd5WgmmJS}DI?a?lnhnQ-rOQU!~HXiGNoMaEt8HFU;UgUoy3*4
z>D`&0Yz4o<-J%2UOlGryqQ`^As(KT#WXqpGE4)V8E{u+7iq_T-$-<KZl?3M#wg)s4
z;eHU=PXs;ggohr(`uF3#rH5kSUh=Mxj?9I{R0X}?u%v{Dt28&#0-;ehw$XDa|2nZP
zV=Br`n+wxj{>K+Uz)FP|fHo5<BS{};tgBxic3ZP%AXG^=^%*uo_QK4-x<|L#xULg+
z%NAY$@pm5*Wop8sl5{36BvFoQ#xSQubSUd~Dd<G?QZjzbO3}*0ea6RgA%-lFNT+HA
zeh{h!7w{$3F8}BaU*h3F0eLuyRqyt%9GWzE`#97*x{OvvZFtVnL!q#l6zw#;ZuT(h
zE8V_*V+_Xmi!Z8>oB1`e<uxd-_OsJh-a3$s5mX?mtNet(bcV`Q=>#Fg_HnnErqFkd
zoZDsugPisT&Z-Q-Qh5l&4$W0_IyKsv;M4I_+T>M-fRUx}#~&^Qh~#*;&(24EKS1v9
zXP*_ZV&35=S6%h&2Wh4cS*7+ok1BZZI8Q1g5R%*Y(3MjQDA%vw=>7=3*I#Aj+@N}q
zn6!#P4bp1tMt$k7Mc_)0@MgV+QCkM?D9YQQ36C&nXbNdkoV0<bWUi3s6z~u{nQ^cm
zFixJOY8?%Ab&)%WUDI^aP62Djds8Gb4%C^_deqv_FPe}|gth|wKRvyZ0wRpS&EjSk
zzJLF)kter&xWbVdeJmHROMh}+3Ql1R)sWOg8E9tvw$;@1xw}Z(N<;zzIvX9!t@d2D
z5I97txfQJgY6wd*sHE`m-+2+4e;^uB)IFPel{V@Lr4n&DX73id4R2Pt+#dd=#>WG0
z6{PSZa9+uI;E({Ye_beWpQo6x2|f{YT<E`tO5c}2gXIqUp~MO;K3I<Wtu8PQ9e8<O
zjMrnIOB9q0Rc~P=Uow8gI7$a6jG)B!1eS&3;H38%MUJ;OP<-y~w@`^wvI>yl-ioFN
zhr4M|;_~!gRXrsSFr`K{`TK7tq07q=MmEQY>rnBqfS}x*oD|qF$|v`qBKgX$w$Dkw
zf=V}e@e4X`+aCuy0rY#0W|<TW`hN57-3E148r#pZ!8awVEHR8{BBkrfq-quNk#%Mt
z)uf*#z0O!)%0;WionacDTz)aIS(A<<+Y^-~B1597TCFo}7FlbwiAi*>mdVwxPv>*s
zsnnC7J-eFWsCKQAVwnL3z)aNgZNFih$Qm{t<gwW1eLA)GJ2IM{v?UZNIWQ7*c_*Nq
zw+aij_~6sib=D6>g)Z)Xd3&pcf6ZwTF^gzhP8O>zfWonvIZ%#K*oS_!0enT7=@f={
z9<BC#bVDk^?&GygynnO~L?hFLDJ1<Ej$MAdg$}Tys7++5N>$DvX^r!>?ndyxI>CGZ
zn-b=Z@L2Gx_!HB>{a^n5w@`^>VYW!m$St@s91r?##uedt{QW&f7C(`=R~^;S-k&*+
zkVAbvl#m8ilFAkQ!U%F_XOq4k;gJfrU5NZ}-UyHsO-39G!*A=RYX3aKZxNLWOWM1?
z|N8xV8vQH$+`HK>fCwV{1m9)NLtCnv_VaG^5@QXZHvkrHhYcLK>82%4)c?X-qQ88}
zN%7@O^tfDX46GNCZQq7r738ZPT81tZ#l*W~#`~KlraXG|Z7aF)C64r@SjJq3dvUO`
zb8^Pm*+t!K*}IIj+tNuB|NmGS9hwW<htK{gEpyh4832MQwAxg3qWLGBKHU;Cw~+<U
zT*xCrXCd+r&&*uOCxbCKGzqT#NFM5)y>1=Yc_&35?NpsLYrg8O4QbVa;R;<+$(M4T
zZQ)bZb}d>c^W|4-jZuicATzUx;J$1fl<ZC<jo%*f8GLW4btgZRko_^^Iceu?=HSp%
zW=n9%nQpv7&cH$PrANEsY4W8BHD?>}ritFVoCNH*#NmogFZ8f}ogI{nifCWm?1iXD
zr2L27IohR#PnDvFTGy(lytZ-{Cwcc&tM}q_w<Z1B2*Z?Gw_ce~;#uB}5fch&m}mk-
z+e8cD&@S6t?SSaqp$^NORDdsBliAoe-m|8GxkqK*EP)JQSc`UBqzcRx-QDa&GYupu
zr|Yo+W1oI>;vhjo!~WhVI5pGi&~^iBWw=F&lg#21;&ZgYq)YMh!;14KZIFk=+kl6@
zs{Hj>?x}Otx#-c~jNvK`*D5|Oy_2cw@0wqq+b_5Z5;@+&0^ivtV!OC2`?Qt|-a1+K
zgXB)=>+f>5j@gS!4*zE?*SF&G{E7rV-L!K}5xumyelr1S$1i5W7}a}%Onup#xvRV)
zmVrCa{6DEn8-c>k2H%t&IzmM1)2!SLig8_qsDNL0Imi$rh#6zVl`CyQEy7yQy~j3@
zaZ!Ylc7Oq?6c7;XyhRFVXc&bek#a*;5y6iSrdbAgif_5MqIAR575MqSHTOOafD2+w
zk_ndGc96}%b>OB;<B=DV7(1|DBn13q22xk8wSS_0cu9_{dgb4dAI(0huUf`N;#;CH
z0<Q5L7bT7dGP<MR2twq4@!9WOEZ5F2oNz}<4XO#HJfpD8B|r@~5$8}ZB9<LX{+`>~
z(&wcqmLg-OX`7R~*zXQy1i!&OB|}Z>GrKWHo<;9WMpPcnOiLVB++npUZH(KdHYs{^
z*h@!7s|xK^+)a`4lZar{B9Px4mp0;i7orBwu-z9LzcE<XzztNOtOo@IA>^Y@axocm
zN6ZZw_&~4}ms13MYHDiQQ=+O>Ux{s%_|XB8(+?3Fgp{?QWk1(Tr&JU~GQrY%6&id0
zD1MvAqwIdIR$RE4KYwsG$g@nGh&hC!s={?JqHJPsC)8KG9&VXyNjc-F76COA$i6(d
z^jsxN#q6tV`%oAeJ{lW$LBbz%vf=JkYP{EU29ZNOgY+6SYvvDUla$*-Z=Fs}I>B+s
zisv^;KWGh}e;>9#0=1>e!AT-|b@%XaB7EK3I+B(`36CcPts#!@*|2Ovx*)#YSob%m
zfDhwLY4)u%jNK1We8{ALaox!%=ch2%WdpPfciE>MY4D(a&4?9;l5Jj6Rtce$L7+HP
zP!T{0kZn$2OFSa^8f_Yn3)Zb@%{jAL_?cs~Y00B2+PvBn?gY!}x8ObU3jB#ky!%0m
zfF*zZ<(q2j;&%Ht-6WS4*?w@}5r<wLVv-|6NFfwmS>2V_xcSke>4GRC1t>Qi73Z4p
zt9NoOfR6}1IvH=CqV;wwS~4`gG>i3V24xi$PiQoHB;)`mf=ty8FD9cA5npm@r<;D<
zjS+zCsCaUH!w}%4<3YyGQ-H|Z>P>cj0%2C5!9Dq%Rh6{sMJgY@%BY8iqCX4|o=+g3
z4w9yJ&z@T-^@|zyN@Af-+s=*%poh3mjuawwLhnl7%q6dPMn|Pn8(~FJC-T#FA|DvC
zqCF{re&O3H@qDC<2F;VMh+zObLE7P=7xvEfLIGpKk88c{$tVEEB0y@|)lq!Iotym=
zOwBF3sgN+S+ar?bhJ4G2lLy{0-E?VpW^B+y=uEgh9(z`VGkFNuvNL!i1l~yD$sa0G
zUHU0UT}|!gu1YkZ$VdGllrE%_7~W@XQ`G%*=gf#;P8CdQ-M{&BrdylP;egAFRtr9R
zq`}nSN0<!BL=&#ItcKf~*-|bZbxb)IZ?%h#5j<dF9a)3JZA~W!*$K%D#bB^*Krt?K
zR!SSLFXGq9dq`MT-~+4SWU)JDS+k$PubmYqqEV5Tz~D_-S=5xTCKE*VWSN<L^i|4b
z!hiCxlBts;Woc3!ap<{xesH-PHIg`{a23c6-fZxgqIDtz;!_rN&Jnu{IOQEb{^ZQo
zMW*KpmZ4{mya^5Vpy%*pH^x%}fQ#7*)h*5NO|m!mv@l97EG$O;T4!c<w`uLOPRh5)
zigmo=8i}wQ%ApdpK&jFNx+cnV7NL;H$<wl3woKOTaG$o9=+65N?NRhYJXUGa=>{fo
zsk+yTH1QV(nULOD13Kk-FCD+;SB%GhxyW(D727)Es#YbZ`rmHIn`m&fxWfh+*P{y2
zLeKZp=DsN8Ihn#Np#6J=a-zl2E`Ix<o&Zacyn{Xe`I*dAfaYM)^v*`ZNOCP&wGwSO
z4JTt26FfH-k97jGl8w&*a91x*!dVc2<>4-;G+ePwXu^7^{Sz!^3gibdZ_2YAIu2it
zoe#DiX5C=`t};?WQz(vw^{~gFV~G0KPk=(8erIAGd+SwKRdI0|QoUHu*+@+$vIq`$
zQuVubXIjpQ=fs0yC5zi0-pCM^cG@l)DPlNjKyjNx?kJcW2T!a9c$<RSQ@sHNMHy&#
z{W!R>w4_8V=gu6?xOeZQF}dMO?&ML()#_l~`Eqs7*VC|lt(P#mg#eygsAWa1#L1qX
z{_*VNGbud%TRXc>c=~_XdK0i5*S78d)-sf_Xc@~qgk>mG-G!25Ci6<h%od7DC~2Tn
zO2!CLWG)#pL>g4)Rzf4CkfM?dA@%)^tmoVQ|84u8?RnpKy_V|ky3X?$_I*G0gVJs0
zOiX<LE8UoImU(%W#odllNkb>Y_UBJ8mYjT?_uOkkp0lf{kJFWVng{owlu;h`LnI-l
zYRnK4m&24ZPBIneaK?Sv%!qa390j02zTdFF{Un=-Bsp>hen5G}#WD^e|DMFaQz){j
z)32xcpTlT7DvQrX$fmk8p-x95BQ+Rc66)N@$VdoHULooMyG`!HOg<h2ZsXY1b9m@P
z%g+=THeXvfk(0GO-+90rGAU>>bLReH9S_AU6m&d`NKnx;q3U;f1Vj(6JCA(Ro<BV8
zm%56s1G3Q^wGPF4<(YTJfmcdL&AYPVnfYy5?@RpjrCSHZ!d>spVxy1-Z7@+pv>>B!
zBs(#3=W|X=?z~Z-+7E3%ixy<#W1YhjlL3Au!yH+PAeq8t^i_w2*q_sWiBGN8_^-p+
z<PFR%1mw);twwTMFfzdrX3J#zhI@AH$`1-EW~`UPAUZp-XC=*%{PO__4$qbJDz>fS
z#5HVg%wE6<8MXj{v@H>B9!if`($RIx*cbSMNbo`mr4JRonT?X+hkf$IQdDdBW-UC)
z;}J9Dy?K+EHu2KX>C^}?mR=N>vgn52e46=+b);Gva)^fm?+Y)IV*!IaZ=}O<N{=q6
z9i_B}NomKd6-XLH^G07ms+(kgs44BbIb)rSePS?hBr1Xv>-K-kIx{qo{}*j5jM8-w
zq>Xl35*#ZxqEx1u^t@Bx;QEeNhH&JM@N<*w9{LZj_M#Q3b#0=IuDklR!_p*=rAwA9
z#1><YG6g1I4ax+u_nC42J#Kg=F60%7%`mek39{r1+Jy;MjuSISH`0P5?s;u^1#X<Q
z{)MUdm~rxHljmb}8^~B4nZliE8%$VyiyiBxE~b`KnccA%D`V&j8S?_F2e43znI~DH
zi}wEQ{j#pE>44<io1UC|?*_<LKBl&o;|_{BgtET5)YWW6LUQCr2FmPne=(+LBXPm_
zjjh+*D-h=#5(O3rwG9Kk#D>6K@0K%EXN%7sRj@T90KnPH+L@WEPqV<x3?i8xLYxPg
zQ^j$nHBK)^4>)2Cgg&i~soq6_AuG@+x(erCthtWCE<)40p3yEc;3}j1>|;6;YNL7E
zP8}aT4-S<~&;Vh{q$>TcFtuP2%3JLTkimp2`c4rB?-Nxs5`9xnPx@nsUU$AmTp&d^
zX%MrSnh`t`HC(;=?sW({e!=c}N1m&MqSzUKSotRki)rS~EkPFW9NPx{C|3AP1(MJn
z@eG+S@TDrNc<sb-1XKdm)K+drr7A<sMKQ)2(p=)=vS#pOJ8?CJL$QDtKs9@&z^*m$
z8D*c$>8Cho)s$WP4%vj|UR|W;ZphPleVqMzXyOoTT>Uff2&gr9!JAhDiuLI@!tE=y
zh(h$L7~bC9`(?Wys8<4?hF08<3s#X>7~xmEEMOjY5sQ#UUAlx$3@#w{37NW?h9Z1q
z*BjC-$;be()B@B$<a1$533;I4o=iRMPv5s^PhFqH&Ow(v?vil7hZ$dH7##_pc(#(@
zbx}VtL9E~)lfjNF+nd-0F=<T*^`t(cTx*D|h512O`1oCY_o(O$7|??EB)vY++c43k
z(PCrq7x5q{LDg-hU~gAJg7K!%0p(MOj|*oFm`a4!i;{I({i1A?p-@=!nnY`aO&VHS
zjgcq9Rk%((xo&vJRBP$0`uA5Sj-WS_`37_|CYw8`?-6%$m|KWr@o{Loqdp=;PSL{$
z58gY>^d)SH7trD%RdBPoo=CZD>$J+`Pp}PSMr4&nb5c7E=L8ZqsQ{=)P+6XKu>Kc)
zeDqV3JwY!5>teI1LXZ$3aLPWZ=EP@9mKlTx7gBm>-~)ncIWe+y0nVJRCr*gdplwOk
zAaoyV7tL|I%4v|3f|JXZQK11l##!O4)RdqhzBq(y8GL;fkR`+Sh)o@zTl`HYLp!J4
zen3AeVj={k-k(g^Sxq#rVrMu85Bp-*&(`8Y5UBk))>^}y0*m#v-@bpJ{q+F7c6fq+
z+Q0uU8?riv*-2=3F&m`C5(@~Foy_fg|6S<y9Tw`R(V|6xrRy@H$uTUuP&U~tb`Dv`
zE=!!Dn;{QIe}PTJw&Ky+Pf}G<X@t>j*`F?WN+~4n(`%c!d0I9q_H5k7jaD@dGd0*<
zk<@_lnGbF>ZtPeU#r67sjpXI4a`VOxkkuH9k2D_Q0ZE)h)@j1TIO92^mk)N!>x$R{
z)+!$mnw|ncL+>xk%e8BbnKe00PhkQ-MLzD-YwXxFUjDL?2YO#90bmIWZO@J|UR8s;
zR6YkqpFD3~KfCB`x)s|u_y6qLz5A}t7JWA`<1gdy{Ow~<vDzDJkBFVJskYJs+$=w6
zO-!fg4Qk<fLxv<nF^WU6cndKGtQ})9Ry}7CKM6cmc0dD|&;xHlQ0F<y)nPi|4a%#`
z^Me>*yK|-d6ZaWnr&GPjH4zjTjLSEAn-bh_k74K2r5z6vCLtYVdYbYEmboNmIK~kS
zR65+q*j-#$JFv=@wK2=<^WFu%6-HrWg9ys2d`79L*y7jcI;WS6c!ew)YnV`e1QAWP
zPEVfV){u`21S8{eJSxMS%z(;^93!+R^9f`k5kRYMW`EoPIhu5~G@X~Ty<%5^S{(k7
zGXPvj%5Ey)&cUf00M@h>9wClS+zV+)ar5ybY7*_dKo8{vQZZLCt2bw^ITr;C2{(X$
z+6|dEeR@6457TD|sXAi%M)sDJhd)JTc<i3^vJTf@eA$d{jAZ4{uRv`m^$cTNGPCzA
zAZGNGDHlz5$8ocdojH?Lq;j5GTtqTZO<fXItz^Df4CMKN()$sCL?dbB{6iA}LaXfa
zbIV0zyFXBC)~nG-R4u-!5~J+<+uPaQ5sb5S>$~fNo~XLD5Yax+e8Y!<-w_B297YaE
zBG$=Sv*4`Z8EkCd*v-EWV+e$5vEu=%7-g^JR@wQJ+U~sB=L=eHJ?*~iEdQc&_wHe<
z(uehI{^lGQh4`<}Y1`rJqanE+QRIj{mAkv?$r}UJM=m9f#c}@OA4t(+atk9>{w}r4
znNW?o{G-T{F?M0Ipb7FaSPreSa~b?a3Y*n`dc9;{pDbO<a{P|m4K<j_+_^^}77p?y
z!jZ`GzGoKK-0n9GA(jRjZP1f`|2JIXV&e-M%6AZB2KyDO0D<RH7fCkZKW9Q?LH2-%
zM6;Qm@&>~L5F{D@rooxhx4DR`XuBbJI->8fTY0B*+;Gd9VH3uWXS&~=NOT4xL?V>T
zY{1repqvqLk>!?53+hjq@|Cva$dPoU!;lcGUic|RdnlrDYNcy|zLou$kK(+jIyFe0
zfu33R>JmPmopy1VCY#Oy61GV>hQ>;3_DnqgSLHYn{c&Oxzz#NG0S8=67tmpd2`cIp
z=zeA+&z_In6Evsj`kanuLPJeQJ*;R0UJQNxipE-uJa`7r0*0Lp)gH;9YxKam)q-VX
zwncEc(cHgM1<0Rkf9?A91+aBOnF`j3%Mjgx%-n<qCm0;NVyM@%y?Rqr1L7o-V*Zd+
zl)&>8r4@Is*4Gbn*7^V+8xC&m==dln$7+7VkuER{7}&^o38VPOluc9XfmN_gXYT%&
zDH=mfDQM-EQ5UY=aY((j)ONF}?L<04c;rRL(|{5tB<c$K-u%r@qJ?Z6L<jZrXu%Bg
z2|<IKP>3WF&~%qS=}J|0D50lX$k5-tzt}0sK}=1hk?3J~U+w-FX8EB6MR|a$KFyS@
zpFwJ5`#}rkCP#AW)rKSc&AH*hOJkAo7VGPlkm@3?^>z5^0$Cta<f36<OoTqEH$ZyN
zp6ci-Bsns#FSCSB0MQ+WuEsKqwDj(C;08H~kjZpw0!*I?6$A(4p#+rZQcHiSFi<M<
zNdojONDpS8G%Pn8IdVP<I6<lzt&gexv9fQsZm0gmLQTxb7$6cdSlG-Zmrnb2vynsJ
zX26m>NNf@L3$7S2Y&mF(&^#&8?GFS6nL;j2eX&9Y1;ro%6K<8%ITHin{TfYh<(JWs
z5i?FQPE!6WtsfdZLV(CLn>2niYx-6juCAu?k<$!NEz33FaHwI#1Pnm0q~Umj13ojg
zN8Veh<<e&GKdnJv2*8ASS$=t@i}RD@h9ig1c)F3<p^2?DMMVQo!SLXl2ameBokL8E
z_AnL*5NN>_2!mceYC`9B&{^pNF2|JaygmDsAjVw3BY%3)ImAP4;Uy-EssVcZxbF*C
z*=1xf+~ngQ)RjUGAd(JM-d_sp`wC807RwMRh;1Q0KxtU(F<mtpHlo>yurL`smPuH|
zL1PJi@A^;aIQHXtywYf2Y`%nad`9V{&S(L1A@X#5#}#aWG&F|r2JwMX5IzT}4s(zu
zY@p!0uhZ#d;&c#>ghz8><Chh1ck?+7sAoczElp(X961{-whViUxei~&R+jafN&wqo
z#7$<;hW4|HacTpnXSE?kcJ&Nd^D;IyHK1T+qY#P_X(OOX2XI5eIQ@>43X@X)rdG!^
zNoIeE7_@&WJ^c5ArZSien3#5Y-A<L%Z^)bZ%_}p9ThIMbtu(F<`=1uzXBpo4l4gz^
zN_qLRJ?P{es&ieJ>Z+z|rm!6)o;xh~7?P0Pr42@i5=At50B0hjm+p$Pa$0ip*630t
z>TKMol$mGj-FW>|DElY{ZVa>!jb`jccjM=G6L%bFu!W~4njq3%!4$oGYmd`FEuap9
z3c&lw>RF(c{`i1!OxG`WH($>ixlI1W&=}(_z&P-URsaTK`a%^rOsBs{%lALN=cAI!
z6O)NAE5in<gTRJqc5uBA7XYyWvX@AqMW`vMUb%dE9N1x&^C|>l0_6%ROhf{;$*124
z?xX$-Is=aMdFe{Q+ep<^J1He6pIZ~{;uvxRGN~1B;N$})DpDKDgprh;8}^;}@@+^_
z$6i`eBPy)=sS`lAaxOs2{?h@72m<8it>x9(Zh142&wxf=b0}%6$V2TSo17%p5M(S4
zmEHnz2N_w&?U%`9ut0HPz#yZ(c%pNbQvi2xSyRK&g)Zr+vZ;w(L*d$HAdZ0{KJ6E0
z&krD+N>3$DPXWt@NOY#^I+|7_vFhta#!toigKAxT1^hHeXx!N^_146bvYQ&8B+0pL
z3@3eT0?a9-2OSb9B8dKPtNP{p)9FtVnA5*ewJDmdFuaD>S$&6M?1y+<b=B2}j|n!h
zvfQJvu*XyDvyw5MJc^tSv?WS6_P^apPG+Rwm5+aFdV1NE1{S@Pp`U`VYD5Aw1y@n(
zEOFmLZy|CuBZEQ`rY-xc(6=KL{c=hBLFPY$iGVD2;753JO<IJ6yw-EOP{9a2Lr4@F
z7&at+dtp#1NFOyc7k39(H7p%Rb%u?NxH8aRj=T4rhS+dU$1G$ZQ7Uio=m;8j&#R_+
z6f{hKJ-v9kQ_%vz#ZJ~fX-d@~Q*0P+O|{JE#V8S3_*!(dOjDDB7|5v)$j@W|y^;;y
zYfQihj7%H)&&>H*0guMs)KRZzob<5bbe%uy%K{#FKDN%7&7J$w+~4|A=8GFmQ!V%)
z+rq+@MAuL`GHj7mx)KE<F8j$GbWy=FaVr2R&cSiu92kQ<UHyWaJfC2Q&N7~aA%p6;
zU`gG>AWCn_gzMEg9-Q+OR&&YvINx?dno?Q_#C`-1a}-E23$)AXxce!a4GbJXj|;dM
zelB?DP6Zu}4EaJMqTRXX{BtmZs(ZIPg(Nd9<4SwZ-t)RVLm^nu%1UP)S5f*ABbnvB
zHP<{-TCko>jE9XLncB>yAcatI!d+PfCIVLkaoW$UG*#7FyVNspHh}W$Ovn0XQkM;s
z4u#2EWFH;PLgugySt-`O^oClqX_+-ZczHW+sMJ7O^rHrwIQao)%9-thMwZtkE2BXP
z1r_Cx@b+I6U7;|%F=*~E&}QU3^k&7M+6K2^W5Es2Y8-fm^BV;3T5Wxk&fXKL#F0bq
z;VPj)#TJ1vAz=uPCGTKis-~BN2?dwnM++91*za+Wp<h(VAF{9dFD<-`5SG9xfziJB
zsej9pXe0$w79^P>yK>{S!Eqb7zW>eih&LE{_Dq-Z^YlBMPxQa)D1yso%(R=!@Ps+_
zA;|RD%&i}wl0k3tLc44jp8V+1`BmozwQ2UKUHmMD6kytuWxxB|x83`vM0^=lA#RX_
z$uk9)sSqbc+g2b7kV`4T63}ot{m3rm@G-iY)o^?>E&VNg44iiy-rGhSPvaSb=O+t)
z;?Oi?69*dAS2Gw5+!gTQt#G&Iu?o}@e!C@&nccE=)86ZH3|7^I3Ht%ygRDjz-DB|`
zfAMv*a`^DuC4oS$qORm8ySurKxO#HomuV<%3GM_ISI`;c19INDUsvrL{Q~3Gd6bcp
z)0k9u>_}kxZmB6?(q6sG?ctNC;vTmJ2^YK!O{g1TDynbD>)fWPX#$;7B#9jzzox(f
zuzXk!sN!L<=G(CO7|9qtu*V|*5Grzvr%VXP+3EZH%oZsaswm%ozN*`xJ%%oX>>FuF
z-w$*cJ9D1%R!S&YLtQ+&ZtC*dLRO|dDYKvHI*NiC?+5-1DsWu&+-^>rJO+wa+nZ-C
z$Q0rnM*}Q8&!WOsaZ?w4Fp5k0e|1ZTdyRPT=uycGR~>#urd?+a^TiNHcuI^t3o5hR
z!uVw{7Kr5~ivZnTE1Z;HFs4B&26|#{y9|3kq~ip5Wz{UWKBSorXU=wLquWfN7!)G{
z);_byB6z&s(279EF+c*s%;JKD3*CrVQDwJSe+Zl|d&S@(?*%?+Pm|IJkd$K9onb^~
z{KngNjai2%k6k47IL~MzURyTkG?DL;z{I^E$M^L(Ev9@DII6=N57EL2DawP*Lo8@D
z*1Rf+#Kx5VqqNfEo1Zu+aySq+jD+2PW~+Sd*<te*B>R$zFEyDkr##oTLXcn5h!nCQ
z5J1zCD%phRE{*{zX<#C@w-ihM8|RvtVq!OmCohwP%m(lU#KJ4iYlLw`-G}aC2S{G{
zTM~c$9ix7JxUz(!h@<oC(4f93>9TK(nlXJk!nO9XKUGqn_w2<A3lScU9ovu;iX8WD
zcdv<#SlKXDbo9iDdK6~zfe6IhG-GlMCBSLFj4)_Yy93QT{|2=4?pn$|F*P+;mQ0{H
zZ_33KB3s5?n4QsI+tf{cq-eA$${Dm3a5m5R)yw3Ae_;?=@mD&|H6p-~nf|OS={`lb
z!e5kBVSR9(+9hh2n;XA0q+mU%Y#7%AWs6uVQbEe%U8K4Fo&~6ej1yFIKWr;jYncT}
z*DaZ@hd86J$9S-LV56s1wfh3-wU;~$jNAK#MqC^ns(`4ad!(?qm)k6EKuvqY2v#N!
zc8K|6s%tV?49FQ95sfXJ8TvzA+$)hbm-_fqvkfBGJb9y%$~)&Z*si)+1*n0*SV6=N
zKi6+GXg&;ULTcX^Ro<=Yg>dZxS;fkJAfUY5qB*7KyOb-_%=Tz{#dPR59GdICVY1Ws
zm90``*z#ndw!zx25In4yQEj_p8yrXog$XvMlCdaDM+Z1HONZmesA?hQc;GN+Wp!1>
zB*N|vrrpH^iS9d59xi6*_Q#v5LGVG$h$QR29(TSGL#BuOqGP&UA8ZpA&@-aZYmcpr
zxhho0?|<}|);Er?7UJcc)%9J#nItAR@M+BX+9S~I!g*dy<Y9PXHN`Eai4?b#+YP{f
z#Cr}m4;jm)%)H#YzcUDu`6XmsAxQ8-S2jPCj(~=Y7|)Un+6DNvtqjWvgbSyDB5naj
zj#eqJ-oE{sSvF+QAXym{to{8j8d^;2PoKY=XMH%6f(e<9)asJ`8C7`EsP7#PId`K!
zPUW1~`51%o_D3+llxx@MSK!;XOZ3`Wd5JSFdi;{-ZN-HXtdlZR78=R?7o8V6aKW!U
zcQyCO6T{@^5%X#iADOZ->{Vu=Ew}?vW(eYD;ynMQ;!hNt9_%4xg;5U!)zTYO!W10+
z9X`y0c61V(Kt_wiikTF;$?8}0PFA&tRVo!eQseeUfyFvTO9@ou%N#6JAlQsbI(I!)
zUHx;73_#L#Tb1eM6%}Fgpd;R-Y?>;bR@m3=U0+IbTCVG>K2%Y>-p$zHwg#{!HaE8e
z=Ub{h@HxrHSW`_J)*bb(0{hideGd=N)zx5@WYzolxaCwHl*eoR%RchT>rnE7O02s%
zZpiTbuU_B9VwrbD1TY2A+wZWK2}ZFaKio@wZ$Lm%dC+Vs4}hJq_P+j8u&;(ONU7)>
zqUg_fF5RK59g~j%;LSdl1{e|c^=Ph;4GL1r3H!(ue)Z<fmsCIPp=R*8jBLuRBZece
z3zO&1?Z6W2olG&1<)>)ZV|b0D@@xK0J98$->JhzWu^yt;E{z(f!}^j`|KdQeAB#*<
z@GBYe02Y-6?Y8_Q88r|6Db1Olt!;UfZ3Va_PfIjS2&05&=KssXYe80>3VI=h3%PGq
zy|5P>=HX4g9ZRBhA2Zc+*w?<DBE*`+Cy7+{8QfS2y_*LJFI@48ZPcbNU+w2osx!_M
z{NYDW=)P{<PDGV|Qtaeb@Nt{@EsmT8pCz6efNI#Frj=Axo$4L&OToGyU#xOOoKD7~
zi<CWaFr~E~24n)QiTD2|n26j?SwF55RR9CCOZK<_i8S%wB0D1b0tOd_IA)3(-G<wO
zgl)F^Jxx@jo`=;7?tP)`;k2;Qv6ChNvMr8|Kp=v#0V@CM&>&;gxZPC907}P#kB@Sq
zq;3Pe$i|I!!Vb}DqWbe%t>N1{W2Apt)}Ik4XXN>78@5FH0X)`T=G-XsrfP4GfaGAC
zbKp|LOO!J<h<+r3!%V+!GCXcwZJj_-BOeWk74(9T!Z^>7P&#M@{g!w;+}O16EazPc
z`QGiu$|$+4E;wRz065{G5Lyo(o=dL!8&Z7jdG}?EmJ6)|{(%VQvi+N4+1t#FkX@zY
z>S6s%prt*5XjqZuTC5X%8F+)v`{PX?osTi&Uh~#OM=2s>pq>|{+eWB%z^GEHDF7ed
z@VkK9QxPYj+4MrbDVsI8lA+2eCn=Dd3Fp8Id}blD{q!w%#aGTvmwu0h^kQ-Z4PZ6e
z{PHf~K~b)>^iqjMXdws-ZXb=|fYCL1!lN!=iJ|03TBuWg2`pRqY(ga~QG|mlSp_mH
zj(Z?+0B0Au030LSoL2SjKNLg**hXn(7sfF~niB9RN@WB>DT+%Ro*pzX3#2Br%Kb~e
zPrG(O{;Re2?%CtPj2>#ds#Ld0dCt18DaW$yFXIbP^}zrr58H|+(D0>O3r$6zK5+Sy
z9*tJiyoaLuPdy|WX|WPvB0%1L^A;`8zxC>$*bcxE-uWbFvksjeDt@z*!w1N6dpo5z
z*sD}3kfSn2+^K*63+96#bn@~;n?+-Acj>$#j(?A{dHb*pr(*L*d&F;Gajo07by#+>
zZQN~GOQF{38!WW99?hVbHx5me)kP2+fTw4=XpFoXpkm?HZ}0y7rt~a4%W3Avd?`%i
z%V;6d(+EbvM9w&#ygZ>vqZ<AS0;5Boc#OGWEaVYseEeKh*Cgq2i>k-0z2kH<6O8O(
zu-H>`FfakRs?Emx^f#r)Vt;CU%qeaUZ84n_CCl;v{=K0AWMgq|ZZMI(3+)$4vG4jp
z-!=JtgffDYmT82jD2J=hQQ4PGYhWRx57VdHzdz*m0dA9l!2SaV9#`J)VUcMzkORk5
zQLXP4<3cn3F;TA>M5hA6a*R24;1T-F<I3hK+^Jah5dzu&H=^<^KzRbGFKs{)8tCi8
zHq@dx5a3VW>{tyB2%%x-U$*Q)BTn~-Ika7Z6@fM_d3@+zx$WDWi|nbDCW~&5R%lxC
zt5Ytm6gZY&Z8xNb>3nHSK!7n_8wpy&=s}&|OgfrbnF2T;``KDt{CK*@dWHYFgu3Yt
zJixFYxA+rDbg22P9?{}`O^x3}yD9qscw-%Y#n7O}{Q5eZvA(O$CBOvC2tDeN(hYoq
zTg|VnHYYBF=SU6g0mi}~IDgH60|VQYMIlI~+~Id2v)uvYWytpWx-NTx(?+|V+9^j>
zVRy}#RRx+r#X=nm|48LVZBmyLiUGx&CDYv0g|tJP`Nllj%X|Cw@^i*}5*NNAe+1_&
zdYY5tOJOdKW2l%kZhU(;6v(5!Oi4E!xry#kpSG8{jT_IE2NPDSy5;Wt-=T!-z0{{*
zlZ0e3(jaY7(g{8BETFO}x*_-oot}C0F(dI@VPWeI5OS;twiLEe4YB`F1-i*#STi0o
zbDr;aA8w@Tmj3_hxPTmG0lW~PC+vNEd@L+2?_UXLUuR_Np&RY|tMg!dRABT`l2q8I
zn@wbo)*nHS-a5Lz6hCuLMjj)|2rB{Cm=PU?_)7+9nri2!H4;LG9yI>j@U&@m8bh5b
z`^#QgbRB^F1&AEP8R>#u(G;;CU232jcMN#}tPCeIj>|N@`|je=R{Mj3e7I?%_vSw`
z0m4Zwp@&+wdUX<Q|0zF}Jm>Y7x#!Ge#60k?5%o1$k-ES}U%PzG&|}8a#*aT&vUE{u
zh?!Qd&YdPQ)o)*{i8Q|Fv~)sq>@cLP49~?=3sD=g^U6%ds~FGWKO7h_&Zf&+X&7}S
z_A?P-)z-!IEjgQ&BZsgc(#iJW4c=mUy9Nj`oiEQ0q?L!c9iH`i1ZqLy<6@jQMMo4C
z7P@>gBC@hOT+A3ifulPdnnXI4B@e(;qex5SBO7qPW`1X(!Kg|^Zh;I|rY4v!Wce(v
zBn)I<GS2OHCOmu_n8h<))uv+K4Mr!^>6rx#$Ya+h5-`En!JfoK2eeRN$UXZydL(eG
zWXP+TawG4$;)5j%E7D^!9*!Zt@nKQQJT#B?Z&B5cvQPZ^IAo{%MoeZ*T+G(RE0-B-
zG4>#GoUzuZoBY4y`YogUQ_Uc1Ir^JpyeuJuKflx9td3%Cl9su#^6<pJ8)!;Fhwq^j
zbga|!X6kNdypfx%ZqQ){3=JhI){{jwAYccJXVtBv5a|O-ZaVV|RNfRV2(}uMW_Ts<
zpB&_vlGnCEG<c@PtVb+BdbC}<%0$*bfc?sR?KJaOr=PbQj9l?;#zBOSvCvXBpI(n4
zz}qaEK$PHqGo~D2n*8l^txQ7JCQVDO40+x+ggEqiV=D{x2q0wSv&QlsVCZBs2~wX6
zxVuPRr>noiQIzFj&;IhrYXjRUJjB9<DzwGo@T|RkrNFW)R(NxnnUnaF&J>;WE_w?v
z-MtYFTTuJpRaTB>ukX;gY)fAG{9GJskvC2oGJEcOHKaHF>BgwM+GC%gk~VZ6yp(uG
z!TC`0j<MJBD|+{?Xa+xIRl!@1tt}7_V+}a9ifEI3FNv5}zYWo=37{n9g~;(}8YyQ|
zQmY^c<TaV6f7p)DN$gU*yf;_3oI#yUwiC_zmA~dWe-W-5ZBgpiL4XC)IMV2K=rex7
zrA&R+<1~nfCN*{FGx$#pjkt@8AINYlclPmcHE$B0=oer$i5>N^AA%dl$ZUs8_4fw<
z7X^#k!j^GNOqsZmfJeS!)>ib+&nCHdxr_Kt?8Ycroj)&aqu`^n!B6#f>6Qm$Dtr^i
zhYP#m5C`3zKmz6bHEvYjmOhD>mLCVN46eGqrceFD)a)`tgURxdMV<BKq;pv3IW-%r
z8ca_siaA8-!h_<L+jCmk1GV46_cNzXso&7(^#VzQtSl2KgvOXtOFo^K!Fo-hTA3E3
z`ygA0jT!Bn?&ABJel7Q^k2J?9MpTfJRL~In^A{P<c)Q#B8F3kiQ3kOPgrN63M%PUH
zQ1;}}Ll`+pY|$nOJy8wFX1Z(74^LC43l#*DWhxd|&5t!Y2%@e~u>R|Dz!&k{kO4R0
zMzJ+De_r?H`knjs?k)KkxS?LXt?hqRzb?C7LuF~9s5L|+J^j{#(jkd89=A^vT*|}M
zak`)aW)KQ;cM%vM&)BnagKFGUNLtQ*?Yh|CB(33`rwL_EI}DTMyboFC0|TRyJ*Z=!
zK21QOYh~RQSqGq1DCleu0{4wz-BTmz6#)y}?|Heb?4$l?RB)O90R|gI*A5;HR51n4
zLC7Jl>3l50ta7d58y(70ut}h-S?w^H%;15zh-DM=Mhj{s1DOu>!e~Y2ly=VMH{*FN
zB%aFl62LX{Ba<dA!lsCtR|FiK^WYM#o&W`qoi>9~kV^fFBf!@hFkIQ%q%g+EH|vGb
zKH?9GDB!B<IHjELU*E25{<X1+BsXHZFBp=z5z#!qbx+?(rWZ30bST?^=Ve0zqgK+@
zqnQR}3)LC)jf!x$ibW^(`+kaZ+yF)(bC9S2D9|PI@Vx1s@pqi4RBK+h0b|7T$y+6*
z4F(PwQgPgU85a_R`k$%gpSbH_ccaMtkAsK%6H5=i-=JDbR)mM?TJUDmQPKm|aA#fv
zF;~nGl+8_SwtjTV>gq8T2tUQ4O0^-048p(|oe-rV2<J5Okf)T&HZpmNmB_`?V>N?7
zNREevg<QMV8dDW|&=bn$sisYEI3f~=O97ose=OnFTD#@-rZ~jOc?->$Bu=FM496qn
zk1+LL11`&rNpGmnau}h(WD<u0*iD`gb(_=zr~KmAfxI_RU>Scdd*xxokFsBrrnx@D
zFsmcJts&l^EuH2W-2zo1W3BB$I183FH4*k4=PK3luBZ65*>tc&PW9{DS1z}(ZROe}
zaNlHZlo;;xX%=Bwa7Rch*=9ikNh~+=nBRhUMO{VWt!<wv*|f^;jM`e`kTDc`edgd3
zAIAc0G9ZIyZ8X$}kcdpzBYUvl(1g+-zV;PZmYC<wSBC5b>%*MXAZo+5+zp#HS#yT*
z(l}yl7bf8ml>tWMeFkoQlGAI{KKfX&ZqhX3JsBjYh7idxc$Zl8NuHz(Fqt^96!D**
zz&2b0<|8kx$sGn#Cd;{phQuChCrAVdl3IH{W?&*t1QQy5O^hylk-*RthcAw#{@|h2
zsVch^$kKuAZ?lKA_4e{Q3P`Hju;Gt)N}8P&y$5nVh5G?q9e!iMxSelazh+s7g0x%G
zaAi#&;8I#SBJL;vZoa$6jd5wHG{2wOZJ25=R6}p|RsZ~RN0#g2$;0_Kg;PP#Pi0qB
zzI!|CSp~r37rDIZ6u^d2Pjz%iRrB?BOI|fID}S**SLOmBpx$h3>K2WnVe;(R<0zQb
z>56!>g7V?;C!-~Zc~1M8sau)KAn#|2?kJyLcWT5`jqvdQndM9Es5b3?T7UqZOZW>3
zsU{nRm17O5-(|frquQd1h8(9o92$tN6vn$-Nz$?ghv=o+xUr0lJxf(p;Yk1#)T#iu
zhwNv94V9ka;>Ayw{1@vT5UYaZQT8=6xu1X?pYH|e#)qTyqaqVw4nOI%U&1;{QJ|Uk
z4h!aj9?N7kvH8eK!-+@@44;{3I_6$Ee)1k1IQI!dt#S5yn$Bhf46Nb;10jClKR;v+
z5XWzVwsdi~ZvAT2VE~i=a`*6m0!oaf3otmiUA?LJCo>SmkHNa;+LWA!y=j7Fj!(Q@
zz{?vs#U)XN%2Ic67A@B4uz2Ol?DM1vtPhir&tITOZ~vlC&}_@xW?wyYE6$T?8h{D`
z6gS{oO-ueB!o|rKEs9g+h1lB@D^|3qq{f$=E$A3$85OfRR14jejNcHP5g;ju*787r
z9dW;D%n%L-n5ia4+w$G*=^wIh+!-`vhzyp^Vi_b#6}~oQcVTzmjo(TE9o7ghMno4h
znyi#%|GEV$KxvDw?-K_h*)z<<59Ki-^=0W#cJ!|JnF}x8;nr33AhL;GQD&YxmZ!(O
zg`}AW6Skt8qXZH22rk!;ce)fP&=!?Uzz%<RN9Wvsde}48>RMui4k+9DKLs`eVhd`0
z@MO>3Y4bJuJyciIE+uf;v+N7rnz=3`o<~n$TX=}@zu51B!>2?|=;|?l91Eu)lqp3i
zw?E1v5#H0s2mNlxGXI9s*yy|S2=!^58Ni#j5$h2`&ndsS{ldxf#zdV0$Y>6s{4BsR
zoaR&%i@@ab{9b&=I88*fIM!Leir-3(|M5Dpzgym5Fwkq!(V@_3oDHc3bb&R)9j15m
z^5ga-FqNXXdHZxQ5M+&Y+2e#24{K^%hfmt%wd?$;W%I^tJ>L0Z#NH9A343n&U-3$P
zIRE~UD~l(qosLXe7I6OZ>B!5f=cmL^8=1AKraCY<#(G(rLE*5%&zr4grhoZ9@Z0s=
zl!*r448HxkF)xA-F1y<}72;sGVZ-+!9oi9yfvf#A`#pd9RFG2bjW=&1Eud-xH@a`9
zne-W1$(+OqpaO8&LWP3{X9Rv2Cyc_laVw{rhwvBvF!ucG5W_}pfI1-U_wDw~*bS70
zXNhPL8S{+#FaRYmT{Sp`U_kV3vwvmql^9^D2<Aah&TaM3;*c)+P5K&6C~xh2-}!~z
z03ZeXXNEu&{;=f(v`@c)7nbo>ih=&xZ-Qip7F8(4-Q|_T5rA!xVH>;2ue;G$vFCi2
zXD{^<tenL32W*oW&wWMu=NGbU1GC#Y!kh5>9`H-3Af6K?DxRHMqoEPdFX>ToQc?(z
z1Z5UaOk|8iY1z06RdY5n_9<#Fx*{ZnHThQEI@R@17Z!tqAJ4xIsya083YX|yWWj5I
z=VLH;dBM4}$^Vp40fB*cBfpfClwh^$Lr6?2{}jyL3YE&jYtNtll#O}7PPK}CJw3Eu
zElxFc_fSW%6aV~qOF-rc4o!cJr{@JidOJnA<QEAR>4q$aNV7QQun~t2{KvLZT`U9=
z<+aIjCKmbOn~`8=<Xx<eJgp(pdT1T~>zCew{zae#sv?;emQgU^Os;x)&Yq@coTcPj
zzWknDWA6mjPAKgXS&TB-($bsTjwbr!m)9M=SM+&#_FRbaCXkoxv~KA&*pwTBG7uta
z8=Wi>EZMGWcoq%;+@~0&M)Ej9h&UvZ7CNG2WjLjze?f-M%dWTvGmk3@UBcEjMk@HQ
z-mq9<p%&WHh-rkcwl%j&9Ad|VQ#N{ZX}ko9|NOb?%*sjlW+jh`aw?seWnmuAW0W;9
zQeQKtALy45_*K&@3=RbTT7ou{v<6xA#-RPeEjE_=$};Ecx(2B=ex}8$@OfZackFxz
z&n9dFBV;~NqxMjPZu11mf;YPTexf5nN3nmQ50L=^NWU)Xp?7+Ioics88I3+aUuKqR
z`t-C<Kcn8952FMgori3RpFdwYCHmR(=VBsETW(}{@fohbbc`I|W$BygO2w=OJXRgb
zeaTd1!^%RfJyc!Ut7ql4q5vdIO6F&LJl5{e44I7}ABjhMjP~;C>;L+v@#963ge7Ln
zt0g(tD`pnFoyW;wqo#QE!vBijH)I0e;p3yAI}9<>Su2S3sDqzuH!bOkP61yc>7&Iy
zE)tQF%g>^d!TM3*q--qrn@*jY7BQ^f16+lXzS4BA{8UbHtJqTg>t_M~BU<}eGgb@A
zLe)<f|28T9-9Fp~fLZphnHQ0jUooNOW#c_AZ;)c*2oK|}P|(~khoA7^!P!XTLm@h)
z25VodiXo_AzCJ$d?9PMavL2$2LfU*TrOX~su4>KMpC3+1)P+^)e*0V51e@QDu)5wH
z>7Oa(@Vp7yp{Krv)C<u}`R=seu#fsGu^hpg=K^pl-ytT!uAEBOn1L_KtjhdH-{>@K
z%3cm7KdKOl1p7$~IMs9_?nd;|J@C4AqYgF(L7+gp9P6Hc1}Gcw$JwIekH0ah$U_&-
zK$`UK`~{w?F|4L)Cn;C3@_9&KL7k)h_4qF!{&FH=(-%WE6+qTs=F|(J`2pK+PA`wA
z?8EYJy@<A;&*$6D{C?f|ve2~$94)vEI6KMtZ1LxxwWX^_+Yv-Ye{1o3->W1{EFkFH
zW=5|?8C+||!+S(vOn`V6{>#Fxa9wgHjIzu-11xk*3$WaSM)XyJrzr&t!EJ~3y~-EN
z!>~$gCA)3+6zNRBemWMgN*YXuvX!h42WU%%ZZ&+}MB~svz!TABYP-J|qq~}4WiG;>
zu+Enw+S0x>N02f)fl-&tR@@{!HYS{D%`2=J=v`Lgn@z(jIuDrxk%2Qr1_Xj@i9reQ
z^Yn3Uz{}#B4b+i)W!M)N#tycik|tn@bE`<50D}xJ?jwkC5i6cKZpaHpn;h*hXtoXo
zYJJ*A$t|GKTKDdH{2p+Yk%Q$Q?z7stu7yQvQa@P8h!}#C?8Hb7kGR>HDMAhxwomhw
z4WF^gbtq!}Kd35^meywl4;qUFFtIy!Tk3e{4+E={g#=K1TJtcYT_^f;h5$i8GZ#d(
zQ@sJ2;i~S2Kub@1YyKAQlr=+*GE%n1<zP>WgtYKu(>xP?KAS$xv*P<gBTlI{Ag(ys
ziEse@725|Nwc5Hn_dOV)>;sSmR$-x+52B$E;|(%R0uM+wXTkv-@H4Zw5pNT$frNLh
z`kXdN>`cW@nLN7ga<;Zv9b<|kx~JQJb8MMN6=g09!eqmbm~V&|uyF9=syk#z;piwz
zHrKZ0&s);ANbnGABVySAZBKEYT|GVZ&28xeq3ld)Z#W}^aLe9qT2wuW|5xOGQZe(g
z9<A<8C|$n1sOijyGXass<NxQzga^VG$`~`Z7H#R+pbjqJhd{=%L4w?~ID1S47`3cJ
z63a}KS*R2V1NZkiPjwS5Ggs1sX908Tju2C3zIsf$iI1X&ILnhwNZ`~BiFRG13_#_;
z0v%&|SJKr*0yGdUDceKl{8VxiWUn^IG^Wqa0y7X%I;i=|`dwt3B>f%GXD0)LHW0ej
z$|;v%pj^dZfeRtyn4FCReowoDK+l`7GtXm~^ABSytDDmgSI$0r^JdlAfG@e9HUyD8
z*%qz}o+(ulswWMK=_n)Z01g*ypE?W6BEyrVd?8r#JH}MT@DGHS+dryrGhrgCe^Vd~
z^NYH#sOzNQr?jABX6~kbUhu*!mkwz_syUUn0UkPa{XD6xEqEq!_WkE;TG9eKmfjMV
zJt`*0Pq+GiS;bW+f8GJ2?hi&UW5`G+cWlkOnRPgL;cYIIEF&&z{d9<3(UW>qERWi6
z%0A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

literal 0
HcmV?d00001

diff --git a/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
index 34eb32812..49b4f06c8 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
@@ -24,14 +24,6 @@ ibc-client-tendermint = { workspace = true }
 # cosmwasm dependencies
 cosmwasm-std          = { workspace = true }
 
-[dev-dependencies]
-cosmwasm-vm           = { workspace = true }
-hex                   = { version = "0.4.2" }
-ibc-testkit           = { workspace = true }
-ibc-client-tendermint = { workspace = true }
-tendermint            = { workspace = true }
-tendermint-testgen    = { workspace = true }
-
 [features]
 default = ["std"]
 std = [
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs b/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
index cbed3ebe5..4a4a642f0 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/lib.rs
@@ -13,6 +13,3 @@
 
 pub mod client_type;
 pub mod entrypoint;
-
-#[cfg(test)]
-pub mod tests;
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 55546cf8c..2d4e5bc0d 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -29,18 +29,23 @@ tracing           = { version = "0.1.40", default-features = false }
 typed-builder     = { version = "0.18.0" }
 
 # ibc dependencies
-ibc       = { workspace = true, features = ["std"] }
-ibc-proto = { workspace = true }
+ibc                      = { workspace = true, features = ["std"] }
+ibc-proto                = { workspace = true }
+ibc-client-cw            = { workspace = true }
+ibc-client-tendermint-cw = { workspace = true }
 
 # cosmos dependencies
 tendermint         = { workspace = true }
 tendermint-testgen = { workspace = true }
 
 [dev-dependencies]
-env_logger         = "0.11.0"
-rstest             = { workspace = true }
+env_logger         = { version = "0.11.0" }
 tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
 test-log           = { version = "0.2.13", features = ["trace"] }
+hex                = { version = "0.4.2" }
+rstest             = { workspace = true }
+cosmwasm-vm        = { workspace = true }
+cosmwasm-std       = { workspace = true }
 
 [features]
 default = ["std"]
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index 05ff95440..c46c81343 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -492,3 +492,22 @@ impl From<MockConsensusState> for MockClientState {
         Self::new(cs.header)
     }
 }
+
+#[cfg(test)]
+mod test {
+    #[cfg(feature = "serde")]
+    #[test]
+    fn test_any_client_state_to_json() {
+        use ibc::primitives::proto::Any;
+
+        use super::{MockClientState, MockHeader};
+
+        let client_state = MockClientState::new(MockHeader::default());
+        let expected = r#"{"typeUrl":"/ibc.mock.ClientState","value":"CgQKAhABEIDIr6Al"}"#;
+        let json = serde_json::to_string(&Any::from(client_state)).unwrap();
+        assert_eq!(json, expected);
+
+        let proto_any = serde_json::from_str::<Any>(expected).unwrap();
+        assert_eq!(proto_any, Any::from(client_state));
+    }
+}
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs b/ibc-testkit/tests/cosmwasm/fixture.rs
similarity index 94%
rename from ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
rename to ibc-testkit/tests/cosmwasm/fixture.rs
index 8961f10f1..946f9ac66 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/fixture.rs
+++ b/ibc-testkit/tests/cosmwasm/fixture.rs
@@ -1,24 +1,24 @@
 use std::time::Duration;
 
 use cosmwasm_std::{from_json, Deps, DepsMut, Empty, Response, StdError, StdResult};
+use ibc::clients::tendermint::client_state::ClientState as TmClientState;
+use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
+use ibc::clients::tendermint::types::Header;
+use ibc::core::client::types::{Height, Status};
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::Timestamp;
 use ibc_client_cw::types::{
     CheckForMisbehaviourMsgRaw, ContractError, ExportMetadataMsg, GenesisMetadata, InstantiateMsg,
     MigrationPrefix, QueryMsg, QueryResponse, StatusMsg, UpdateStateMsgRaw,
     UpdateStateOnMisbehaviourMsgRaw, VerifyClientMessageRaw,
 };
 use ibc_client_cw::utils::AnyCodec;
-use ibc_client_tendermint::client_state::ClientState as TmClientState;
-use ibc_client_tendermint::consensus_state::ConsensusState as TmConsensusState;
-use ibc_client_tendermint::types::Header;
-use ibc_core::client::types::{Height, Status};
-use ibc_core::host::types::identifiers::ChainId;
-use ibc_core::primitives::Timestamp;
+use ibc_client_tendermint_cw::entrypoint::TendermintContext;
 use ibc_testkit::fixtures::clients::tendermint::ClientStateConfig;
 use tendermint::Time;
 use tendermint_testgen::{Generator, Validator};
 
 use super::helper::{dummy_checksum, dummy_sov_consensus_state, mock_env_with_timestamp_now};
-use crate::entrypoint::TendermintContext;
 
 /// Test fixture
 #[derive(Clone, Debug)]
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs b/ibc-testkit/tests/cosmwasm/helper.rs
similarity index 91%
rename from ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
rename to ibc-testkit/tests/cosmwasm/helper.rs
index 45b5137b0..666a7e83f 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/helper.rs
+++ b/ibc-testkit/tests/cosmwasm/helper.rs
@@ -2,8 +2,8 @@ use std::str::FromStr;
 
 use cosmwasm_std::testing::{mock_env, mock_info};
 use cosmwasm_std::{coins, Env, MessageInfo, Timestamp as CwTimestamp};
-use ibc_client_tendermint::types::ConsensusState;
-use ibc_core::primitives::Timestamp as IbcTimestamp;
+use ibc::clients::tendermint::types::ConsensusState;
+use ibc::core::primitives::Timestamp as IbcTimestamp;
 use tendermint::Hash;
 
 pub fn dummy_msg_info() -> MessageInfo {
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs b/ibc-testkit/tests/cosmwasm/mod.rs
similarity index 96%
rename from ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
rename to ibc-testkit/tests/cosmwasm/mod.rs
index 9c302f1f2..413981236 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/tests/mod.rs
+++ b/ibc-testkit/tests/cosmwasm/mod.rs
@@ -5,13 +5,12 @@ use std::time::Duration;
 
 use cosmwasm_std::from_json;
 use cosmwasm_std::testing::{mock_dependencies, mock_env};
+use fixture::Fixture;
+use ibc::core::client::types::{Height, Status};
 use ibc_client_cw::types::{
     ContractResult, MigrateClientStoreMsg, MigrationPrefix, VerifyClientMessageRaw,
 };
-use ibc_core::client::types::{Height, Status};
-
-use crate::entrypoint::sudo;
-use crate::tests::fixture::Fixture;
+use ibc_client_tendermint_cw::entrypoint::sudo;
 
 #[test]
 fn test_cw_create_client_ok() {
diff --git a/ibc-testkit/tests/mod.rs b/ibc-testkit/tests/mod.rs
index 1f32c1d98..8b6f6bf3e 100644
--- a/ibc-testkit/tests/mod.rs
+++ b/ibc-testkit/tests/mod.rs
@@ -8,3 +8,4 @@
 )]
 pub mod applications;
 pub mod core;
+pub mod cosmwasm;

From dc116daa5e9df73b2f39b063463adc551020314e Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 30 Apr 2024 17:40:58 +0200
Subject: [PATCH 164/182] imp(ibc-client): rm `TryFrom<Error = ClientError>`
 restriction (#1204)

* rm concrete Error type

* update ibc-core

* update tm client

* update cw-context

* Convertible in reverse direction

* update code

* use Convertible<Any>

* rm redundant bound

---------

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 ibc-clients/cw-context/src/api.rs             |  8 +++++--
 .../cw-context/src/context/client_ctx.rs      | 12 ++++++++--
 .../cw-context/src/context/custom_ctx.rs      |  7 +++++-
 ibc-clients/cw-context/src/context/mod.rs     | 24 +++++++++++++++----
 ibc-clients/cw-context/src/handlers.rs        |  9 +++++--
 ibc-clients/cw-context/src/utils/codec.rs     |  7 +++---
 .../src/client_state/execution.rs             | 24 +++++++++++--------
 .../src/client_state/misbehaviour.rs          | 11 +++++----
 .../src/client_state/update_client.rs         | 18 ++++++++------
 .../src/client_state/validation.rs            | 18 ++++++++------
 .../ics02-client/context/src/client_state.rs  | 11 +++------
 .../context/src/consensus_state.rs            |  9 ++-----
 ibc-core/ics02-client/context/src/context.rs  |  6 ++---
 .../ics02-client/src/handler/create_client.rs |  7 ++++--
 .../src/handler/conn_open_ack.rs              |  7 ++++--
 .../src/handler/conn_open_try.rs              |  7 ++++--
 ibc-core/ics25-handler/src/entrypoint.rs      |  9 +++++++
 17 files changed, 127 insertions(+), 67 deletions(-)

diff --git a/ibc-clients/cw-context/src/api.rs b/ibc-clients/cw-context/src/api.rs
index cdab7a745..dfcbe7ce9 100644
--- a/ibc-clients/cw-context/src/api.rs
+++ b/ibc-clients/cw-context/src/api.rs
@@ -8,7 +8,11 @@ use crate::context::Context;
 /// Enables users to integrate their implemented light client by introducing
 /// their client state and consensus state types into the generic [`Context`]
 /// object.
-pub trait ClientType<'a>: Sized {
+pub trait ClientType<'a>: Sized
+where
+    <Self::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <Self::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     type ClientState: ClientStateExecution<Context<'a, Self>> + Clone;
-    type ConsensusState: ConsensusStateTrait + Into<Any> + TryFrom<Any, Error = ClientError>;
+    type ConsensusState: ConsensusStateTrait;
 }
diff --git a/ibc-clients/cw-context/src/context/client_ctx.rs b/ibc-clients/cw-context/src/context/client_ctx.rs
index acb45c311..414217590 100644
--- a/ibc-clients/cw-context/src/context/client_ctx.rs
+++ b/ibc-clients/cw-context/src/context/client_ctx.rs
@@ -16,7 +16,11 @@ use crate::api::ClientType;
 use crate::context::CONSENSUS_STATE_HEIGHT_MAP;
 use crate::utils::AnyCodec;
 
-impl<'a, C: ClientType<'a>> ClientValidationContext for Context<'a, C> {
+impl<'a, C: ClientType<'a>> ClientValidationContext for Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     type ClientStateRef = C::ClientState;
     type ConsensusStateRef = C::ConsensusState;
 
@@ -83,7 +87,11 @@ impl<'a, C: ClientType<'a>> ClientValidationContext for Context<'a, C> {
     }
 }
 
-impl<'a, C: ClientType<'a>> ClientExecutionContext for Context<'a, C> {
+impl<'a, C: ClientType<'a>> ClientExecutionContext for Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     type ClientStateMut = C::ClientState;
 
     fn store_client_state(
diff --git a/ibc-clients/cw-context/src/context/custom_ctx.rs b/ibc-clients/cw-context/src/context/custom_ctx.rs
index 36fe86393..54829d8e4 100644
--- a/ibc-clients/cw-context/src/context/custom_ctx.rs
+++ b/ibc-clients/cw-context/src/context/custom_ctx.rs
@@ -6,13 +6,18 @@ use ibc_core::client::types::Height;
 use ibc_core::handler::types::error::ContextError;
 use ibc_core::host::types::identifiers::ClientId;
 use ibc_core::host::types::path::ClientConsensusStatePath;
+use ibc_core::primitives::proto::Any;
 use ibc_core::primitives::Timestamp;
 
 use super::Context;
 use crate::api::ClientType;
 use crate::types::HeightTravel;
 
-impl<'a, C: ClientType<'a>> ExtClientValidationContext for Context<'a, C> {
+impl<'a, C: ClientType<'a>> ExtClientValidationContext for Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         let time = self.env().block.time;
 
diff --git a/ibc-clients/cw-context/src/context/mod.rs b/ibc-clients/cw-context/src/context/mod.rs
index 1000f837c..ea8518297 100644
--- a/ibc-clients/cw-context/src/context/mod.rs
+++ b/ibc-clients/cw-context/src/context/mod.rs
@@ -33,7 +33,11 @@ pub const CONSENSUS_STATE_HEIGHT_MAP: Map<'_, (u64, u64), Empty> =
 
 /// Context is a wrapper around the deps and env that gives access to the
 /// methods under the ibc-rs Validation and Execution traits.
-pub struct Context<'a, C: ClientType<'a>> {
+pub struct Context<'a, C: ClientType<'a>>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     deps: Option<Deps<'a>>,
     deps_mut: Option<DepsMut<'a>>,
     env: Env,
@@ -43,7 +47,11 @@ pub struct Context<'a, C: ClientType<'a>> {
     client_type: std::marker::PhantomData<C>,
 }
 
-impl<'a, C: ClientType<'a>> Context<'a, C> {
+impl<'a, C: ClientType<'a>> Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     /// Constructs a new Context object with the given deps and env.
     pub fn new_ref(deps: Deps<'a>, env: Env) -> Result<Self, ContractError> {
         let client_id = ClientId::from_str(env.contract.address.as_str())?;
@@ -303,7 +311,11 @@ pub trait StorageRef {
     fn storage_ref(&self) -> &dyn Storage;
 }
 
-impl<'a, C: ClientType<'a>> StorageRef for Context<'a, C> {
+impl<'a, C: ClientType<'a>> StorageRef for Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     fn storage_ref(&self) -> &dyn Storage {
         match self.deps {
             Some(ref deps) => deps.storage,
@@ -319,7 +331,11 @@ pub trait StorageMut: StorageRef {
     fn storage_mut(&mut self) -> &mut dyn Storage;
 }
 
-impl<'a, C: ClientType<'a>> StorageMut for Context<'a, C> {
+impl<'a, C: ClientType<'a>> StorageMut for Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     fn storage_mut(&mut self) -> &mut dyn Storage {
         match self.deps_mut {
             Some(ref mut deps) => deps.storage,
diff --git a/ibc-clients/cw-context/src/handlers.rs b/ibc-clients/cw-context/src/handlers.rs
index 024d8e08a..fdf9c3ed2 100644
--- a/ibc-clients/cw-context/src/handlers.rs
+++ b/ibc-clients/cw-context/src/handlers.rs
@@ -1,5 +1,6 @@
 use cosmwasm_std::{to_json_binary, Binary};
 use ibc_core::client::context::prelude::*;
+use ibc_core::client::types::error::ClientError;
 use ibc_core::host::types::path::ClientConsensusStatePath;
 use ibc_core::primitives::proto::Any;
 use prost::Message;
@@ -13,12 +14,16 @@ use crate::types::{
     VerifyUpgradeAndUpdateStateMsg,
 };
 
-impl<'a, C: ClientType<'a>> Context<'a, C> {
+impl<'a, C: ClientType<'a>> Context<'a, C>
+where
+    <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
+    <C::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
+{
     /// Instantiates a new client with the given [`InstantiateMsg`] message.
     pub fn instantiate(&mut self, msg: InstantiateMsg) -> Result<Binary, ContractError> {
         let any = Any::decode(&mut msg.client_state.as_slice())?;
 
-        let client_state = C::ClientState::try_from(any)?;
+        let client_state = C::ClientState::try_from(any).map_err(Into::into)?;
 
         let any_consensus_state = Any::decode(&mut msg.consensus_state.as_slice())?;
 
diff --git a/ibc-clients/cw-context/src/utils/codec.rs b/ibc-clients/cw-context/src/utils/codec.rs
index f31d9ab2f..dc662ecff 100644
--- a/ibc-clients/cw-context/src/utils/codec.rs
+++ b/ibc-clients/cw-context/src/utils/codec.rs
@@ -7,13 +7,14 @@ use prost::Message;
 pub trait AnyCodec {
     fn decode_any_vec<C>(data: Vec<u8>) -> Result<C, ClientError>
     where
-        C: TryFrom<Any, Error = ClientError>,
+        C: TryFrom<Any>,
+        <C as TryFrom<Any>>::Error: Into<ClientError>,
     {
         let raw = Any::decode(&mut data.as_slice()).map_err(|e| ClientError::Other {
             description: e.to_string(),
         })?;
 
-        C::try_from(raw)
+        C::try_from(raw).map_err(Into::into)
     }
 
     fn encode_to_any_vec<C>(value: C) -> Vec<u8>
@@ -24,4 +25,4 @@ pub trait AnyCodec {
     }
 }
 
-impl<T> AnyCodec for T where T: TryFrom<Any, Error = ClientError> + Into<Any> {}
+impl<T> AnyCodec for T where T: TryFrom<Any> + Into<Any> {}
diff --git a/ibc-clients/ics07-tendermint/src/client_state/execution.rs b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
index 7e844b21c..5d4fadde5 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/execution.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/execution.rs
@@ -15,7 +15,8 @@ impl<E> ClientStateExecution<E> for ClientState
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<E::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     fn initialise(
         &self,
@@ -93,12 +94,12 @@ pub fn initialise<E>(
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
 {
     let host_timestamp = ExtClientValidationContext::host_timestamp(ctx)?;
     let host_height = ExtClientValidationContext::host_height(ctx)?;
 
-    let tm_consensus_state = ConsensusStateType::try_from(consensus_state)?;
+    let tm_consensus_state: ConsensusStateType = consensus_state.try_into()?;
 
     ctx.store_client_state(
         ClientStatePath::new(client_id.clone()),
@@ -138,7 +139,8 @@ pub fn update_state<E>(
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<E::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     let header = TmHeader::try_from(header)?;
     let header_height = header.height();
@@ -237,10 +239,10 @@ pub fn update_on_upgrade<E>(
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
 {
     let mut upgraded_tm_client_state = ClientState::try_from(upgraded_client_state)?;
-    let upgraded_tm_cons_state = ConsensusStateType::try_from(upgraded_consensus_state)?;
+    let upgraded_tm_cons_state: ConsensusStateType = upgraded_consensus_state.try_into()?;
 
     upgraded_tm_client_state.0.zero_custom_fields();
 
@@ -317,7 +319,8 @@ pub fn prune_oldest_consensus_state<E>(
 where
     E: ClientExecutionContext + ExtClientValidationContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<E::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     let mut heights = ctx.consensus_state_heights(client_id)?;
 
@@ -330,7 +333,8 @@ where
             height.revision_height(),
         );
         let consensus_state = ctx.consensus_state(&client_consensus_state_path)?;
-        let tm_consensus_state = consensus_state.try_into()?;
+        let tm_consensus_state: ConsensusStateType =
+            consensus_state.try_into().map_err(Into::into)?;
 
         let host_timestamp =
             ctx.host_timestamp()?
@@ -380,7 +384,7 @@ pub fn update_on_recovery<E>(
 where
     E: ExtClientExecutionContext,
     E::ClientStateRef: From<ClientStateType>,
-    E::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<E::ConsensusStateRef>,
 {
     let substitute_client_state = ClientState::try_from(substitute_client_state)?
         .inner()
@@ -401,7 +405,7 @@ where
     let host_timestamp = E::host_timestamp(ctx)?;
     let host_height = E::host_height(ctx)?;
 
-    let tm_consensus_state = ConsensusStateType::try_from(substitute_consensus_state)?;
+    let tm_consensus_state: ConsensusStateType = substitute_consensus_state.try_into()?;
 
     ctx.store_consensus_state(
         ClientConsensusStatePath::new(
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 6750a44eb..79d2b6ea9 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -28,13 +28,14 @@ pub fn verify_misbehaviour<V, H>(
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
     H: MerkleHash + Sha256 + Default,
 {
     misbehaviour.validate_basic::<H>()?;
 
     let header_1 = misbehaviour.header1();
-    let trusted_consensus_state_1 = {
+    let trusted_consensus_state_1: ConsensusStateType = {
         let consensus_state_path = ClientConsensusStatePath::new(
             client_id.clone(),
             header_1.trusted_height.revision_number(),
@@ -42,11 +43,11 @@ where
         );
         let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
-        consensus_state.try_into()?
+        consensus_state.try_into().map_err(Into::into)?
     };
 
     let header_2 = misbehaviour.header2();
-    let trusted_consensus_state_2 = {
+    let trusted_consensus_state_2: ConsensusStateType = {
         let consensus_state_path = ClientConsensusStatePath::new(
             client_id.clone(),
             header_2.trusted_height.revision_number(),
@@ -54,7 +55,7 @@ where
         );
         let consensus_state = ctx.consensus_state(&consensus_state_path)?;
 
-        consensus_state.try_into()?
+        consensus_state.try_into().map_err(Into::into)?
     };
 
     let current_timestamp = ctx.host_timestamp()?;
diff --git a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
index e715643fb..ec5d88c36 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/update_client.rs
@@ -22,7 +22,8 @@ pub fn verify_header<V, H>(
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
     H: MerkleHash + Sha256 + Default,
 {
     // Checks that the header fields are valid.
@@ -41,9 +42,10 @@ where
                 header.trusted_height.revision_number(),
                 header.trusted_height.revision_height(),
             );
-            let trusted_consensus_state = ctx
+            let trusted_consensus_state: ConsensusStateType = ctx
                 .consensus_state(&trusted_client_cons_state_path)?
-                .try_into()?;
+                .try_into()
+                .map_err(Into::into)?;
 
             header.check_trusted_next_validator_set::<H>(
                 &trusted_consensus_state.next_validators_hash,
@@ -107,7 +109,8 @@ pub fn check_for_misbehaviour_on_update<V>(
 ) -> Result<bool, ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     let maybe_existing_consensus_state = {
         let path_at_header_height = ClientConsensusStatePath::new(
@@ -120,7 +123,8 @@ where
     };
 
     if let Some(existing_consensus_state) = maybe_existing_consensus_state {
-        let existing_consensus_state = existing_consensus_state.try_into()?;
+        let existing_consensus_state: ConsensusStateType =
+            existing_consensus_state.try_into().map_err(Into::into)?;
 
         let header_consensus_state = ConsensusStateType::from(header);
 
@@ -138,7 +142,7 @@ where
             if let Some(prev_cs) = maybe_prev_cs {
                 // New header timestamp cannot occur *before* the
                 // previous consensus state's height
-                let prev_cs = prev_cs.try_into()?;
+                let prev_cs: ConsensusStateType = prev_cs.try_into().map_err(Into::into)?;
 
                 if header.signed_header.header().time <= prev_cs.timestamp() {
                     return Ok(true);
@@ -154,7 +158,7 @@ where
             if let Some(next_cs) = maybe_next_cs {
                 // New (untrusted) header timestamp cannot occur *after* next
                 // consensus state's height
-                let next_cs = next_cs.try_into()?;
+                let next_cs: ConsensusStateType = next_cs.try_into().map_err(Into::into)?;
 
                 if header.signed_header.header().time >= next_cs.timestamp() {
                     return Ok(true);
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index 73349d1ec..aca62f5e5 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -21,7 +21,8 @@ use crate::client_state::{verify_header, verify_misbehaviour};
 impl<V> ClientStateValidation<V> for ClientState
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     /// The default verification logic exposed by ibc-rs simply delegates to a
     /// standalone `verify_client_message` function. This is to make it as
@@ -93,7 +94,8 @@ pub fn verify_client_message<V, H>(
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
     H: MerkleHash + Sha256Trait + Default,
 {
     match client_message.type_url.as_str() {
@@ -163,7 +165,8 @@ pub fn check_for_misbehaviour<V>(
 ) -> Result<bool, ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     match client_message.type_url.as_str() {
         TENDERMINT_HEADER_TYPE_URL => {
@@ -190,19 +193,20 @@ pub fn status<V>(
 ) -> Result<Status, ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
+    <ConsensusStateType as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     if client_state.is_frozen() {
         return Ok(Status::Frozen);
     }
 
-    let latest_consensus_state = {
+    let latest_consensus_state: ConsensusStateType = {
         match ctx.consensus_state(&ClientConsensusStatePath::new(
             client_id.clone(),
             client_state.latest_height.revision_number(),
             client_state.latest_height.revision_height(),
         )) {
-            Ok(cs) => cs.try_into()?,
+            Ok(cs) => cs.try_into().map_err(Into::into)?,
             // if the client state does not have an associated consensus state for its latest height
             // then it must be expired
             Err(_) => return Ok(Status::Expired),
@@ -237,7 +241,7 @@ pub fn check_substitute<V>(
 ) -> Result<(), ClientError>
 where
     V: ExtClientValidationContext,
-    V::ConsensusStateRef: Convertible<ConsensusStateType, ClientError>,
+    ConsensusStateType: Convertible<V::ConsensusStateRef>,
 {
     let ClientStateType {
         latest_height: _,
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index abe496e2f..e6becbf58 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -10,17 +10,14 @@ use ibc_core_host_types::path::Path;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 
-/// Convenient trait to decode a client state from an [`Any`] type and obtain a
-/// handle to the local instance of [`ClientState`].
-pub trait ClientStateDecoder: Into<Any> + TryFrom<Any, Error = ClientError> {}
-
-impl<T> ClientStateDecoder for T where T: Into<Any> + TryFrom<Any, Error = ClientError> {}
+use crate::context::{ClientExecutionContext, ClientValidationContext};
+use crate::Convertible;
 
 /// `ClientState` methods needed in both validation and execution.
 ///
 /// They do not require access to a client `ValidationContext` nor
 /// `ExecutionContext`.
-pub trait ClientStateCommon: ClientStateDecoder {
+pub trait ClientStateCommon: Convertible<Any> {
     /// Performs basic validation on the `consensus_state`.
     ///
     /// Notably, an implementation should verify that it can properly
@@ -206,8 +203,6 @@ where
     ) -> Result<(), ClientError>;
 }
 
-use crate::context::{ClientExecutionContext, ClientValidationContext};
-
 /// Primary client trait. Defines all the methods that clients must implement.
 ///
 /// `ClientState` is broken up in 3 separate traits to avoid needing to use
diff --git a/ibc-core/ics02-client/context/src/consensus_state.rs b/ibc-core/ics02-client/context/src/consensus_state.rs
index 7d1bfcb77..556486c67 100644
--- a/ibc-core/ics02-client/context/src/consensus_state.rs
+++ b/ibc-core/ics02-client/context/src/consensus_state.rs
@@ -1,22 +1,17 @@
 //! Defines the trait to be implemented by all concrete consensus state types
 
-use ibc_core_client_types::error::ClientError;
 use ibc_core_commitment_types::commitment::CommitmentRoot;
 use ibc_primitives::prelude::*;
 use ibc_primitives::proto::Any;
 use ibc_primitives::Timestamp;
 
-/// Convenient trait to decode a consensus state from an [`Any`] type and obtain
-/// a handle to the local instance of [`ConsensusState`].
-pub trait ConsensusStateDecoder: Into<Any> + TryFrom<Any, Error = ClientError> {}
-
-impl<T> ConsensusStateDecoder for T where T: Into<Any> + TryFrom<Any, Error = ClientError> {}
+use crate::Convertible;
 
 /// Defines methods that all `ConsensusState`s should provide.
 ///
 /// One can think of a "consensus state" as a pruned header, to be stored on chain. In other words,
 /// a consensus state only contains the header's information needed by IBC message handlers.
-pub trait ConsensusState: Send + Sync + ConsensusStateDecoder {
+pub trait ConsensusState: Send + Sync + Convertible<Any> {
     /// Commitment root of the consensus state, which is used for key-value pair verification.
     fn root(&self) -> &CommitmentRoot;
 
diff --git a/ibc-core/ics02-client/context/src/context.rs b/ibc-core/ics02-client/context/src/context.rs
index 8f7b4922a..972ec547e 100644
--- a/ibc-core/ics02-client/context/src/context.rs
+++ b/ibc-core/ics02-client/context/src/context.rs
@@ -153,11 +153,11 @@ pub trait ExtClientExecutionContext: ExtClientValidationContext + ClientExecutio
 
 impl<T> ExtClientExecutionContext for T where T: ExtClientValidationContext + ClientExecutionContext {}
 
-/// General-purpose helper converter enabling `TryInto` and `From` conversions
+/// General-purpose helper converter enabling `TryFrom` and `Into` conversions
 /// primarily intended between an enum and its variants. This usually used by
 /// standalone functions as a trait bound allowing them to obtain the concrete
 /// local type from the enum containing that concrete type as its variant, like
 /// when enum `AnyConsensusState` contains the Tendermint `ConsensusState`.
-pub trait Convertible<C, E>: TryInto<C, Error = E> + From<C> {}
+pub trait Convertible<C>: TryFrom<C> + Into<C> {}
 
-impl<T, C, E> Convertible<C, E> for T where T: TryInto<C, Error = E> + From<C> {}
+impl<T, C> Convertible<C> for T where T: TryFrom<C> + Into<C> {}
diff --git a/ibc-core/ics02-client/src/handler/create_client.rs b/ibc-core/ics02-client/src/handler/create_client.rs
index 4a4148251..4cb3d34f2 100644
--- a/ibc-core/ics02-client/src/handler/create_client.rs
+++ b/ibc-core/ics02-client/src/handler/create_client.rs
@@ -8,10 +8,12 @@ use ibc_core_handler_types::error::ContextError;
 use ibc_core_handler_types::events::{IbcEvent, MessageEvent};
 use ibc_core_host::{ClientStateMut, ClientStateRef, ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
+use ibc_primitives::proto::Any;
 
 pub fn validate<Ctx>(ctx: &Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <ClientStateRef<Ctx> as TryFrom<Any>>::Error: Into<ClientError>,
 {
     let MsgCreateClient {
         client_state,
@@ -26,7 +28,7 @@ where
 
     let client_val_ctx = ctx.get_client_validation_context();
 
-    let client_state = ClientStateRef::<Ctx>::try_from(client_state)?;
+    let client_state = ClientStateRef::<Ctx>::try_from(client_state).map_err(Into::into)?;
 
     let client_id = client_state.client_type().build_client_id(id_counter);
 
@@ -51,6 +53,7 @@ where
 pub fn execute<Ctx>(ctx: &mut Ctx, msg: MsgCreateClient) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
+    <ClientStateMut<Ctx> as TryFrom<Any>>::Error: Into<ClientError>,
 {
     let MsgCreateClient {
         client_state,
@@ -63,7 +66,7 @@ where
 
     let client_exec_ctx = ctx.get_client_execution_context();
 
-    let client_state = ClientStateMut::<Ctx>::try_from(client_state)?;
+    let client_state = ClientStateMut::<Ctx>::try_from(client_state).map_err(Into::into)?;
 
     let client_type = client_state.client_type();
     let client_id = client_type.build_client_id(id_counter);
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
index 4e76a493a..a0630ef33 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_ack.rs
@@ -1,6 +1,7 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenAck`.
 
 use ibc_core_client::context::prelude::*;
+use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenAck;
 use ibc_core_connection_types::msgs::MsgConnectionOpenAck;
@@ -11,12 +12,13 @@ use ibc_core_host::types::identifiers::ClientId;
 use ibc_core_host::types::path::{ClientConsensusStatePath, ClientStatePath, ConnectionPath, Path};
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
-use ibc_primitives::proto::Protobuf;
+use ibc_primitives::proto::{Any, Protobuf};
 use ibc_primitives::ToVec;
 
 pub fn validate<Ctx>(ctx_a: &Ctx, msg: MsgConnectionOpenAck) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     let vars = LocalVars::new(ctx_a, &msg)?;
     validate_impl(ctx_a, &msg, &vars)
@@ -29,6 +31,7 @@ fn validate_impl<Ctx>(
 ) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     ctx_a.validate_message_signer(&msg.signer)?;
 
@@ -46,7 +49,7 @@ where
     let client_val_ctx_a = ctx_a.get_client_validation_context();
 
     let client_state_of_a_on_b =
-        Ctx::HostClientState::try_from(msg.client_state_of_a_on_b.clone())?;
+        Ctx::HostClientState::try_from(msg.client_state_of_a_on_b.clone()).map_err(Into::into)?;
 
     ctx_a.validate_self_client(client_state_of_a_on_b)?;
 
diff --git a/ibc-core/ics03-connection/src/handler/conn_open_try.rs b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
index d7eb9592f..e85828e7e 100644
--- a/ibc-core/ics03-connection/src/handler/conn_open_try.rs
+++ b/ibc-core/ics03-connection/src/handler/conn_open_try.rs
@@ -1,5 +1,6 @@
 //! Protocol logic specific to processing ICS3 messages of type `MsgConnectionOpenTry`.;
 use ibc_core_client::context::prelude::*;
+use ibc_core_client::types::error::ClientError;
 use ibc_core_connection_types::error::ConnectionError;
 use ibc_core_connection_types::events::OpenTry;
 use ibc_core_connection_types::msgs::MsgConnectionOpenTry;
@@ -12,12 +13,13 @@ use ibc_core_host::types::path::{
 };
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_primitives::prelude::*;
-use ibc_primitives::proto::Protobuf;
+use ibc_primitives::proto::{Any, Protobuf};
 use ibc_primitives::ToVec;
 
 pub fn validate<Ctx>(ctx_b: &Ctx, msg: MsgConnectionOpenTry) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     let vars = LocalVars::new(ctx_b, &msg)?;
     validate_impl(ctx_b, &msg, &vars)
@@ -30,13 +32,14 @@ fn validate_impl<Ctx>(
 ) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     ctx_b.validate_message_signer(&msg.signer)?;
 
     let client_val_ctx_b = ctx_b.get_client_validation_context();
 
     let client_state_of_b_on_a =
-        Ctx::HostClientState::try_from(msg.client_state_of_b_on_a.clone())?;
+        Ctx::HostClientState::try_from(msg.client_state_of_b_on_a.clone()).map_err(Into::into)?;
 
     ctx_b.validate_self_client(client_state_of_b_on_a)?;
 
diff --git a/ibc-core/ics25-handler/src/entrypoint.rs b/ibc-core/ics25-handler/src/entrypoint.rs
index 1de98b062..3c271a9bb 100644
--- a/ibc-core/ics25-handler/src/entrypoint.rs
+++ b/ibc-core/ics25-handler/src/entrypoint.rs
@@ -9,7 +9,9 @@ use ibc_core_channel::handler::{
 use ibc_core_channel::types::msgs::{
     channel_msg_to_port_id, packet_msg_to_port_id, ChannelMsg, PacketMsg,
 };
+use ibc_core_client::context::{ClientExecutionContext, ClientValidationContext};
 use ibc_core_client::handler::{create_client, update_client, upgrade_client};
+use ibc_core_client::types::error::ClientError;
 use ibc_core_client::types::msgs::{ClientMsg, MsgUpdateOrMisbehaviour};
 use ibc_core_connection::handler::{
     conn_open_ack, conn_open_confirm, conn_open_init, conn_open_try,
@@ -20,6 +22,7 @@ use ibc_core_handler_types::msgs::MsgEnvelope;
 use ibc_core_host::{ExecutionContext, ValidationContext};
 use ibc_core_router::router::Router;
 use ibc_core_router::types::error::RouterError;
+use ibc_primitives::proto::Any;
 
 /// Entrypoint which performs both validation and message execution
 pub fn dispatch<Ctx>(
@@ -29,6 +32,9 @@ pub fn dispatch<Ctx>(
 ) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
+    <<Ctx::V as ClientValidationContext>::ClientStateRef as TryFrom<Any>>::Error: Into<ClientError>,
+    <<Ctx::E as ClientExecutionContext>::ClientStateMut as TryFrom<Any>>::Error: Into<ClientError>,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     validate(ctx, router, msg.clone())?;
     execute(ctx, router, msg)
@@ -45,6 +51,8 @@ where
 pub fn validate<Ctx>(ctx: &Ctx, router: &impl Router, msg: MsgEnvelope) -> Result<(), ContextError>
 where
     Ctx: ValidationContext,
+    <<Ctx::V as ClientValidationContext>::ClientStateRef as TryFrom<Any>>::Error: Into<ClientError>,
+    <Ctx::HostClientState as TryFrom<Any>>::Error: Into<ClientError>,
 {
     match msg {
         MsgEnvelope::Client(msg) => match msg {
@@ -121,6 +129,7 @@ pub fn execute<Ctx>(
 ) -> Result<(), ContextError>
 where
     Ctx: ExecutionContext,
+    <<Ctx::E as ClientExecutionContext>::ClientStateMut as TryFrom<Any>>::Error: Into<ClientError>,
 {
     match msg {
         MsgEnvelope::Client(msg) => match msg {

From 51453ab65d306418cc67b43d20a817d2b479d055 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 30 Apr 2024 17:57:56 +0200
Subject: [PATCH 165/182] chore(deps): ibc-proto `0.44.0` and tendermint
 `0.36.0` (#1206)

* update ibc-proto and tendemrint

* compile tests

* update cargo lockfiles

* downgrade msrv to 1.71.1

zeroize 1.8 with MSRV 1.72 is yanked

* ignore patterns for depbot

* changelog entry

* ignore cw-storage-plus

* use consistent cargo-toml

* taplo for toml fmt

* nit

* Align cargo.toml entries

* put multiline description in separate section

* format toml

* exclude tendermint cw contract from publishing

---------

Signed-off-by: Rano | Ranadeep <ranadeep@informal.systems>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 ...12-update-ibc-proto-and-tendermint-deps.md |   4 +
 .github/dependabot.yml                        |  15 ++
 .github/workflows/code-quality.yaml           |   8 +-
 .github/workflows/rust.yaml                   |   2 +-
 Cargo.toml                                    | 158 +++++++++---------
 Makefile                                      |   7 +-
 ci/cw-check/Cargo.lock                        |  55 +++---
 ci/cw-check/Cargo.toml                        |  28 ++--
 ci/no-std-check/Cargo.lock                    |  43 ++---
 ci/no-std-check/Cargo.toml                    |  28 ++--
 clippy.toml                                   |   2 +-
 ibc-apps/Cargo.toml                           |  25 +--
 ibc-apps/ics20-transfer/Cargo.toml            |  37 ++--
 ibc-apps/ics20-transfer/types/Cargo.toml      |  61 +++----
 ibc-apps/ics721-nft-transfer/Cargo.toml       |  35 ++--
 ibc-apps/ics721-nft-transfer/types/Cargo.toml |  85 +++++-----
 ibc-clients/Cargo.toml                        |  27 +--
 ibc-clients/cw-context/Cargo.toml             |  25 +--
 ibc-clients/ics07-tendermint/Cargo.toml       | 102 +++++------
 .../ics07-tendermint/cw-contract/Cargo.toml   |  18 +-
 ibc-clients/ics07-tendermint/types/Cargo.toml |  79 ++++-----
 ibc-clients/ics08-wasm/types/Cargo.toml       |  53 +++---
 ibc-core/Cargo.toml                           |  91 +++++-----
 ibc-core/ics02-client/Cargo.toml              |  71 ++++----
 ibc-core/ics02-client/context/Cargo.toml      |  65 +++----
 ibc-core/ics02-client/types/Cargo.toml        |  73 ++++----
 ibc-core/ics03-connection/Cargo.toml          |  61 +++----
 ibc-core/ics03-connection/types/Cargo.toml    |  79 ++++-----
 ibc-core/ics03-connection/types/src/events.rs |  10 +-
 ibc-core/ics04-channel/Cargo.toml             |  91 +++++-----
 ibc-core/ics04-channel/types/Cargo.toml       |  91 +++++-----
 .../ics04-channel/types/src/events/mod.rs     |  10 +-
 ibc-core/ics23-commitment/types/Cargo.toml    |  65 +++----
 ibc-core/ics24-host/Cargo.toml                |  99 +++++------
 ibc-core/ics24-host/cosmos/Cargo.toml         | 113 ++++++-------
 ibc-core/ics24-host/types/Cargo.toml          |  37 ++--
 ibc-core/ics25-handler/Cargo.toml             |  89 +++++-----
 ibc-core/ics25-handler/types/Cargo.toml       | 109 ++++++------
 ibc-core/ics26-routing/Cargo.toml             |  55 +++---
 ibc-core/ics26-routing/types/Cargo.toml       |  67 ++++----
 ibc-data-types/Cargo.toml                     | 115 ++++++-------
 ibc-derive/Cargo.toml                         |   6 +-
 ibc-primitives/Cargo.toml                     |  45 ++---
 ibc-query/Cargo.toml                          |  45 +++--
 ibc-testkit/Cargo.toml                        |  88 +++++-----
 ibc-testkit/src/fixtures/core/client/mod.rs   |   6 +-
 ibc/Cargo.toml                                |  73 ++++----
 taplo.toml                                    |   7 +
 48 files changed, 1303 insertions(+), 1255 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md
 create mode 100644 taplo.toml

diff --git a/.changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md b/.changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md
new file mode 100644
index 000000000..849ca0ac6
--- /dev/null
+++ b/.changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md
@@ -0,0 +1,4 @@
+- Update `ibc-proto` to v0.44.0 and `tendermint` dependencies to v0.36.0.
+  ([\#1212](https://github.com/cosmos/ibc-rs/issues/1212))
+- Revert Rust minimum supported version to `1.71.1`.
+  ([\#1206](https://github.com/cosmos/ibc-rs/pull/1206))
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 321a36376..33ee6a971 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -7,11 +7,26 @@ updates:
     directory: "/"
     schedule:
       interval: "weekly"
+    ignore:
+      - dependency-name: "tendermint*"
+      - dependency-name: "ibc*"
+      - dependency-name: "cosmwasm*"
+      - dependency-name: "cw*"
   - package-ecosystem: "cargo"
     directory: "ci/no-std-check"
     schedule:
       interval: "weekly"
+    ignore:
+      - dependency-name: "tendermint*"
+      - dependency-name: "ibc*"
+      - dependency-name: "cosmwasm*"
+      - dependency-name: "cw*"
   - package-ecosystem: "cargo"
     directory: "ci/cw-check"
     schedule:
       interval: "weekly"
+    ignore:
+      - dependency-name: "tendermint*"
+      - dependency-name: "ibc*"
+      - dependency-name: "cosmwasm*"
+      - dependency-name: "cw*"
diff --git a/.github/workflows/code-quality.yaml b/.github/workflows/code-quality.yaml
index c9e11b972..307efeee0 100644
--- a/.github/workflows/code-quality.yaml
+++ b/.github/workflows/code-quality.yaml
@@ -10,7 +10,7 @@ jobs:
       FD_VERSION: 9.0.0
     steps:
       - name: Checkout
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
 
       - name: Whitestapace lints
         run: bash ci/code-quality/whitespace-lints.sh
@@ -19,3 +19,9 @@ jobs:
         uses: crate-ci/typos@v1.19.0 # NOTE: Newer versions detect false positives. Test locally before upgrading.
         with:
           config: ./.github/typos.toml
+
+      - uses: actions-rust-lang/setup-rust-toolchain@v1
+      - uses: baptiste0928/cargo-install@v3
+        with:
+          crate: taplo-cli
+      - run: taplo fmt --check
diff --git a/.github/workflows/rust.yaml b/.github/workflows/rust.yaml
index 8e2a0a008..e6e522820 100644
--- a/.github/workflows/rust.yaml
+++ b/.github/workflows/rust.yaml
@@ -136,7 +136,7 @@ jobs:
     timeout-minutes: 30
     env:
       CARGO_MSRV_VERSION: 0.16.0-beta.20
-      MSRV: 1.72
+      MSRV: 1.71.1
     strategy:
       matrix:
         param:
diff --git a/Cargo.toml b/Cargo.toml
index fc9a7c5ad..462ea8d72 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -2,91 +2,91 @@
 resolver = "2"
 # members sorted by publishing order to `crates.io`
 members = [
-    "ibc-derive",
-    "ibc-primitives",
-    "ibc-core/ics24-host/types",
-    "ibc-core/ics26-routing/types",
-    "ibc-core/ics23-commitment/types",
-    "ibc-core/ics02-client/types",
-    "ibc-core/ics03-connection/types",
-    "ibc-core/ics04-channel/types",
-    "ibc-core/ics25-handler/types",
-    "ibc-core/ics02-client/context",
-    "ibc-core/ics24-host",
-    "ibc-core/ics26-routing",
-    "ibc-core/ics02-client",
-    "ibc-core/ics03-connection",
-    "ibc-core/ics04-channel",
-    "ibc-core/ics25-handler",
-    "ibc-core",
-    "ibc-clients/ics07-tendermint/types",
-    "ibc-clients/ics07-tendermint",
-    "ibc-clients/ics08-wasm/types",
-    "ibc-clients/cw-context",
-    "ibc-clients/ics07-tendermint/cw-contract",
-    "ibc-clients",
-    "ibc-apps/ics20-transfer/types",
-    "ibc-apps/ics20-transfer",
-    "ibc-apps/ics721-nft-transfer/types",
-    "ibc-apps/ics721-nft-transfer",
-    "ibc-apps",
-    "ibc-core/ics24-host/cosmos",
-    "ibc-data-types",
-    "ibc",
-    "ibc-query",
-    "ibc-testkit",
+  "ibc-derive",
+  "ibc-primitives",
+  "ibc-core/ics24-host/types",
+  "ibc-core/ics26-routing/types",
+  "ibc-core/ics23-commitment/types",
+  "ibc-core/ics02-client/types",
+  "ibc-core/ics03-connection/types",
+  "ibc-core/ics04-channel/types",
+  "ibc-core/ics25-handler/types",
+  "ibc-core/ics02-client/context",
+  "ibc-core/ics24-host",
+  "ibc-core/ics26-routing",
+  "ibc-core/ics02-client",
+  "ibc-core/ics03-connection",
+  "ibc-core/ics04-channel",
+  "ibc-core/ics25-handler",
+  "ibc-core",
+  "ibc-clients/ics07-tendermint/types",
+  "ibc-clients/ics07-tendermint",
+  "ibc-clients/ics08-wasm/types",
+  "ibc-clients/cw-context",
+  "ibc-clients/ics07-tendermint/cw-contract",
+  "ibc-clients",
+  "ibc-apps/ics20-transfer/types",
+  "ibc-apps/ics20-transfer",
+  "ibc-apps/ics721-nft-transfer/types",
+  "ibc-apps/ics721-nft-transfer",
+  "ibc-apps",
+  "ibc-core/ics24-host/cosmos",
+  "ibc-data-types",
+  "ibc",
+  "ibc-query",
+  "ibc-testkit",
 ]
 exclude = [
-    "ci/cw-check",
-    "ci/no-std-check",
+  "ci/cw-check",
+  "ci/no-std-check",
 ]
 
 [workspace.package]
 version      = "0.52.0"
 license      = "Apache-2.0"
 edition      = "2021"
-rust-version = "1.72"
+rust-version = "1.71.1"
 readme       = "README.md"
 repository   = "https://github.com/cosmos/ibc-rs"
-authors      = ["Informal Systems <hello@informal.systems>"]
+authors      = [ "Informal Systems <hello@informal.systems>" ]
 
 [workspace.dependencies]
 # external dependencies
-base64              = { version = "0.21", default-features = false }
-borsh               = { version = "0.10", default-features = false }
-displaydoc          = { version = "0.2", default-features = false }
-prost               = { version = "0.12", default-features = false }
-derive_more         = { version = "0.99.17", default-features = false, features = ["from", "into", "display", "try_into"] }
-rstest              = "0.18.2"
-schemars            = { version = "0.8.15" }
-sha2                = { version = "0.10.8", default-features = false }
-serde               = { version = "1.0", default-features = false }
-serde_json          = { package = "serde-json-wasm", version = "1.0.1", default-features = false }
-subtle-encoding     = { version = "0.5", default-features = false }
+base64          = { version = "0.21", default-features = false }
+borsh           = { version = "0.10", default-features = false }
+displaydoc      = { version = "0.2", default-features = false }
+prost           = { version = "0.12", default-features = false }
+derive_more     = { version = "0.99.17", default-features = false, features = [ "from", "into", "display", "try_into" ] }
+rstest          = { version = "0.18.2" }
+schemars        = { version = "0.8.15" }
+sha2            = { version = "0.10.8", default-features = false }
+serde           = { version = "1.0", default-features = false }
+serde_json      = { package = "serde-json-wasm", version = "1.0.1", default-features = false }
+subtle-encoding = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc                         = { version = "0.52.0", path = "./ibc", default-features = false }
-ibc-core                    = { version = "0.52.0", path = "./ibc-core", default-features = false }
-ibc-clients                 = { version = "0.52.0", path = "./ibc-clients", default-features = false }
-ibc-apps                    = { version = "0.52.0", path = "./ibc-apps", default-features = false }
-ibc-primitives              = { version = "0.52.0", path = "./ibc-primitives", default-features = false }
-ibc-testkit                 = { version = "0.52.0", path = "./ibc-testkit", default-features = false }
+ibc            = { version = "0.52.0", path = "./ibc", default-features = false }
+ibc-core       = { version = "0.52.0", path = "./ibc-core", default-features = false }
+ibc-clients    = { version = "0.52.0", path = "./ibc-clients", default-features = false }
+ibc-apps       = { version = "0.52.0", path = "./ibc-apps", default-features = false }
+ibc-primitives = { version = "0.52.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit    = { version = "0.52.0", path = "./ibc-testkit", default-features = false }
 
-ibc-derive                  = { version = "0.7.0", path = "./ibc-derive" }
+ibc-derive = { version = "0.7.0", path = "./ibc-derive" }
 
-ibc-core-client             = { version = "0.52.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection         = { version = "0.52.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel            = { version = "0.52.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host               = { version = "0.52.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler            = { version = "0.52.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router             = { version = "0.52.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-core-client     = { version = "0.52.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection = { version = "0.52.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel    = { version = "0.52.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host       = { version = "0.52.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler    = { version = "0.52.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router     = { version = "0.52.0", path = "./ibc-core/ics26-routing", default-features = false }
 
-ibc-client-cw               = { version = "0.52.0", path = "./ibc-clients/cw-context", default-features = false }
-ibc-client-tendermint       = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-client-tendermint-cw    = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
+ibc-client-cw            = { version = "0.52.0", path = "./ibc-clients/cw-context", default-features = false }
+ibc-client-tendermint    = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-client-tendermint-cw = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
 
-ibc-app-transfer            = { version = "0.52.0", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer        = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-app-transfer     = { version = "0.52.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
 ibc-core-client-context     = { version = "0.52.0", path = "./ibc-core/ics02-client/context", default-features = false }
 ibc-core-client-types       = { version = "0.52.0", path = "./ibc-core/ics02-client/types", default-features = false }
@@ -102,25 +102,25 @@ ibc-client-wasm-types       = { version = "0.52.0", path = "./ibc-clients/ics08-
 ibc-app-transfer-types      = { version = "0.52.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
 ibc-app-nft-transfer-types  = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
-ibc-proto = { version = "0.43.0", default-features = false }
+ibc-proto = { version = "0.44.0", default-features = false }
 
 # cosmos dependencies
-tendermint                       = { version = "0.35.0", default-features = false }
-tendermint-light-client          = { version = "0.35.0", default-features = false }
-tendermint-light-client-verifier = { version = "0.35.0", default-features = false }
-tendermint-proto                 = { version = "0.35.0", default-features = false }
-tendermint-rpc                   = { version = "0.35.0", default-features = false }
-tendermint-testgen               = { version = "0.35.0", default-features = false }
+tendermint                       = { version = "0.36.0", default-features = false }
+tendermint-light-client          = { version = "0.36.0", default-features = false }
+tendermint-light-client-verifier = { version = "0.36.0", default-features = false }
+tendermint-proto                 = { version = "0.36.0", default-features = false }
+tendermint-rpc                   = { version = "0.36.0", default-features = false }
+tendermint-testgen               = { version = "0.36.0", default-features = false }
 
 # cosmwasm dependencies
 ### Note: Kept at the following version to match the CosmWasm module version
 ### used by chains supporting the wasm-enabled version of ibc-go v7.3
 ### (This is the min version of `ibc-go` that supports `08-wasm` light clients)
-cosmwasm-schema    = { version = "1.5.4" }
-cosmwasm-std       = { version = "1.5.4" }
-cosmwasm-vm        = { version = "1.5.4" }
-cw-storage-plus    = { version = "1.2.0" }
+cosmwasm-schema = { version = "1.5.4" }
+cosmwasm-std    = { version = "1.5.4" }
+cosmwasm-vm     = { version = "1.5.4" }
+cw-storage-plus = { version = "1.2.0" }
 
 # parity dependencies
-parity-scale-codec = { version = "3.6.5", default-features = false, features = ["full"] }
-scale-info         = { version = "2.10.0", default-features = false, features = ["derive"] }
+parity-scale-codec = { version = "3.6.5", default-features = false, features = [ "full" ] }
+scale-info         = { version = "2.10.0", default-features = false, features = [ "derive" ] }
diff --git a/Makefile b/Makefile
index ee1a28e72..7947b9501 100644
--- a/Makefile
+++ b/Makefile
@@ -8,7 +8,7 @@ install-tools: ## Install development tools including nightly rustfmt, cargo-hac
 	rustup component add rustfmt --toolchain nightly
 	cargo install cargo-hack
 	cargo install cargo-release
-	cargo install typos-cli
+	cargo install typos-cli taplo-cli
 
 lint: ## Lint the code using rustfmt, clippy and whitespace lints.
 	cargo +nightly fmt --all --check
@@ -16,6 +16,7 @@ lint: ## Lint the code using rustfmt, clippy and whitespace lints.
 	cargo clippy --all-targets --no-default-features
 	typos --config $(CURDIR)/.github/typos.toml
 	bash ./ci/code-quality/whitespace-lints.sh
+	taplo fmt --check
 
 check-features: ## Check that project compiles with all combinations of features.
 	cargo hack check --workspace --feature-powerset --exclude-features default
@@ -36,10 +37,10 @@ test: ## Run tests with all features and without default features.
 	cargo test --all-targets --no-default-features
 
 check-release: ## Check that the release build compiles.
-	cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive
+	cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive --exclude ibc-client-tendermint-cw
 
 release: ## Perform an actual release and publishes to crates.io.
-	cargo release --workspace --no-push --no-tag --exclude ibc-derive --allow-branch HEAD --execute
+	cargo release --workspace --no-push --no-tag --exclude ibc-derive --exclude ibc-client-tendermint-cw --allow-branch HEAD --execute
 
 build-tendermint-cw: ## Build the WASM file for the ICS-07 Tendermint light client.
 	@echo "Building the WASM file for the ICS-07 Tendermint light client"
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index db9237c00..e8a733fce 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -577,9 +577,9 @@ dependencies = [
 
 [[package]]
 name = "hashbrown"
-version = "0.14.3"
+version = "0.14.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
+checksum = "e5274423e17b7c9fc20b6e7e208532f9b19825d82dfd615708b70edd83df41f1"
 
 [[package]]
 name = "hex"
@@ -891,9 +891,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.43.0"
+version = "0.44.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af781637b107aa33042426c9d17b181ced05ae97b1d88dba50f40f19ad44e36f"
+checksum = "66080040d5a4800d52966d55b055400f86b79c34b854b935bef03c87aacda62a"
 dependencies = [
  "base64 0.22.0",
  "bytes",
@@ -955,7 +955,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "168fb715dda47215e360912c096649d23d58bf392ac62f73919e831745e40f26"
 dependencies = [
  "equivalent",
- "hashbrown 0.14.3",
+ "hashbrown 0.14.5",
 ]
 
 [[package]]
@@ -1024,17 +1024,6 @@ version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
-[[package]]
-name = "num-derive"
-version = "0.4.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.60",
-]
-
 [[package]]
 name = "num-traits"
 version = "0.2.18"
@@ -1261,9 +1250,9 @@ dependencies = [
 
 [[package]]
 name = "schemars"
-version = "0.8.16"
+version = "0.8.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45a28f4c49489add4ce10783f7911893516f15afe45d015608d41faca6bc4d29"
+checksum = "7f55c82c700538496bdc329bb4918a81f87cc8888811bd123cf325a0f2f8d309"
 dependencies = [
  "dyn-clone",
  "schemars_derive",
@@ -1273,14 +1262,14 @@ dependencies = [
 
 [[package]]
 name = "schemars_derive"
-version = "0.8.16"
+version = "0.8.17"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c767fd6fa65d9ccf9cf026122c1b555f2ef9a4f0cea69da4d7dbc3e258d30967"
+checksum = "83263746fe5e32097f06356968a077f96089739c927a61450efa069905eec108"
 dependencies = [
  "proc-macro2",
  "quote",
  "serde_derive_internals",
- "syn 1.0.109",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1299,9 +1288,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.198"
+version = "1.0.199"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9846a40c979031340571da2545a4e5b7c4163bdae79b301d5f86d03979451fcc"
+checksum = "0c9f6e76df036c77cd94996771fb40db98187f096dd0b9af39c6c6e452ba966a"
 dependencies = [
  "serde_derive",
 ]
@@ -1335,9 +1324,9 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.198"
+version = "1.0.199"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e88edab869b01783ba905e7d0153f9fc1a6505a96e4ad3018011eedb838566d9"
+checksum = "11bd257a6541e141e42ca6d24ae26f7714887b47e89aa739099104c7e4d3b7fc"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1346,13 +1335,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive_internals"
-version = "0.26.0"
+version = "0.29.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "85bf8229e7920a9f636479437026331ce11aa132b4dde37d121944a44d6e5f3c"
+checksum = "330f01ce65a3a5fe59a60c82f3c9a024b573b8a6e875bd233fe5f934e71d54e3"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 1.0.109",
+ "syn 2.0.60",
 ]
 
 [[package]]
@@ -1476,9 +1465,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint"
-version = "0.35.0"
+version = "0.36.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43f8a10105d0a7c4af0a242e23ed5a12519afe5cc0e68419da441bb5981a6802"
+checksum = "8b50aae6ec24c3429149ad59b5b8d3374d7804d4c7d6125ceb97cb53907fb68d"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -1503,14 +1492,12 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.35.0"
+version = "0.36.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff525d5540a9fc535c38dc0d92a98da3ee36fcdfbda99cecb9f3cce5cd4d41d7"
+checksum = "46f193d04afde6592c20fd70788a10b8cb3823091c07456db70d8a93f5fb99c1"
 dependencies = [
  "bytes",
  "flex-error",
- "num-derive",
- "num-traits",
  "prost",
  "prost-types",
  "serde",
diff --git a/ci/cw-check/Cargo.toml b/ci/cw-check/Cargo.toml
index 86af97be6..fdb27f2cd 100644
--- a/ci/cw-check/Cargo.toml
+++ b/ci/cw-check/Cargo.toml
@@ -1,25 +1,25 @@
 [package]
 edition = "2021"
-name = "cw-check"
+name    = "cw-check"
 version = "0.1.0"
 
 [lib]
-crate-type = ["cdylib", "rlib"]
+crate-type = [ "cdylib", "rlib" ]
 
 [dependencies]
-ibc-apps = { path = "../../ibc-apps", default_features = false, features = ["serde", "parity-scale-codec"] }
-ibc-core = { path = "../../ibc-core", features = ["serde", "parity-scale-codec", "schema"] }
-cosmwasm-std = { version = "1.5.4", default-features = false }
+ibc-apps        = { path = "../../ibc-apps", default_features = false, features = [ "serde", "parity-scale-codec" ] }
+ibc-core        = { path = "../../ibc-core", features = [ "serde", "parity-scale-codec", "schema" ] }
+cosmwasm-std    = { version = "1.5.4", default-features = false }
 cosmwasm-schema = { version = "1.5.4", default-features = false }
-serde_json =  { package = "serde-json-wasm", version = "^1.0.1", default-features = false }
-thiserror = { version = "^1.0", default-features = false }
+serde_json      = { package = "serde-json-wasm", version = "^1.0.1", default-features = false }
+thiserror       = { version = "^1.0", default-features = false }
 
 [profile.release]
-lto = true
-codegen-units = 1
-debug = false
+lto              = true
+codegen-units    = 1
+debug            = false
 debug-assertions = false
-opt-level = "s"
-overflow-checks = true
-panic = "abort"
-rpath = false
+opt-level        = "s"
+overflow-checks  = true
+panic            = "abort"
+rpath            = false
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 8b98fa57e..381a663b8 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -1120,9 +1120,9 @@ dependencies = [
 
 [[package]]
 name = "hashbrown"
-version = "0.14.3"
+version = "0.14.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "290f1a1d9242c78d09ce40a5e87e7554ee637af1351968159f4952f028f75604"
+checksum = "e5274423e17b7c9fc20b6e7e208532f9b19825d82dfd615708b70edd83df41f1"
 
 [[package]]
 name = "hermit-abi"
@@ -1551,9 +1551,9 @@ dependencies = [
 
 [[package]]
 name = "ibc-proto"
-version = "0.43.0"
+version = "0.44.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "af781637b107aa33042426c9d17b181ced05ae97b1d88dba50f40f19ad44e36f"
+checksum = "66080040d5a4800d52966d55b055400f86b79c34b854b935bef03c87aacda62a"
 dependencies = [
  "base64 0.22.0",
  "borsh",
@@ -1624,7 +1624,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "168fb715dda47215e360912c096649d23d58bf392ac62f73919e831745e40f26"
 dependencies = [
  "equivalent",
- "hashbrown 0.14.3",
+ "hashbrown 0.14.5",
 ]
 
 [[package]]
@@ -1862,17 +1862,6 @@ version = "0.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
-[[package]]
-name = "num-derive"
-version = "0.4.2"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ed3955f1a9c7c0c15e092f9c887db08b1fc683305fdf6eb6684f22555355e202"
-dependencies = [
- "proc-macro2",
- "quote",
- "syn 2.0.60",
-]
-
 [[package]]
 name = "num-format"
 version = "0.4.4"
@@ -2497,9 +2486,9 @@ checksum = "92d43fe69e652f3df9bdc2b85b2854a0825b86e4fb76bc44d945137d053639ca"
 
 [[package]]
 name = "serde"
-version = "1.0.198"
+version = "1.0.199"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9846a40c979031340571da2545a4e5b7c4163bdae79b301d5f86d03979451fcc"
+checksum = "0c9f6e76df036c77cd94996771fb40db98187f096dd0b9af39c6c6e452ba966a"
 dependencies = [
  "serde_derive",
 ]
@@ -2524,9 +2513,9 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.198"
+version = "1.0.199"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e88edab869b01783ba905e7d0153f9fc1a6505a96e4ad3018011eedb838566d9"
+checksum = "11bd257a6541e141e42ca6d24ae26f7714887b47e89aa739099104c7e4d3b7fc"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3067,9 +3056,9 @@ checksum = "55937e1799185b12863d447f42597ed69d9928686b8d88a1df17376a097d8369"
 
 [[package]]
 name = "tendermint"
-version = "0.35.0"
+version = "0.36.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "43f8a10105d0a7c4af0a242e23ed5a12519afe5cc0e68419da441bb5981a6802"
+checksum = "8b50aae6ec24c3429149ad59b5b8d3374d7804d4c7d6125ceb97cb53907fb68d"
 dependencies = [
  "bytes",
  "digest 0.10.7",
@@ -3096,9 +3085,9 @@ dependencies = [
 
 [[package]]
 name = "tendermint-light-client-verifier"
-version = "0.35.0"
+version = "0.36.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "35678b66e819659617c2e83f9662b8544425694441990c07137904a07872d871"
+checksum = "4216e487165e5dbd7af79952eaa0d5f06c5bde861eb76c690acd7f2d2a19395c"
 dependencies = [
  "derive_more",
  "flex-error",
@@ -3109,14 +3098,12 @@ dependencies = [
 
 [[package]]
 name = "tendermint-proto"
-version = "0.35.0"
+version = "0.36.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "ff525d5540a9fc535c38dc0d92a98da3ee36fcdfbda99cecb9f3cce5cd4d41d7"
+checksum = "46f193d04afde6592c20fd70788a10b8cb3823091c07456db70d8a93f5fb99c1"
 dependencies = [
  "bytes",
  "flex-error",
- "num-derive",
- "num-traits",
  "prost",
  "prost-types",
  "serde",
diff --git a/ci/no-std-check/Cargo.toml b/ci/no-std-check/Cargo.toml
index 07dd884ac..ce66a2e6f 100644
--- a/ci/no-std-check/Cargo.toml
+++ b/ci/no-std-check/Cargo.toml
@@ -1,24 +1,24 @@
 [package]
-name = "no-std-check"
-version = "0.1.0"
-edition = "2021"
+name     = "no-std-check"
+version  = "0.1.0"
+edition  = "2021"
 resolver = "2"
 
 [dependencies]
-ibc = { path = "../../ibc", default-features = false, features = ["serde"] }
-ibc-proto = { version = "0.43", default-features = false, features = [
+ibc = { path = "../../ibc", default-features = false, features = [ "serde" ] }
+ibc-proto = { version = "0.44", default-features = false, features = [
   "parity-scale-codec",
   "borsh",
   "serde",
 ] }
-tendermint = { version = "0.35", default-features = false }
-tendermint-proto = { version = "0.35", default-features = false }
-tendermint-light-client-verifier = { version = "0.35", default-features = false, features = ["rust-crypto"] }
+tendermint = { version = "0.36", default-features = false }
+tendermint-proto = { version = "0.36", default-features = false }
+tendermint-light-client-verifier = { version = "0.36", default-features = false, features = [ "rust-crypto" ] }
 
-sp-core = { version = "32.0", default-features = false, optional = true }
-sp-io = { version = "34.0", default-features = false, optional = true }
+sp-core    = { version = "32.0", default-features = false, optional = true }
+sp-io      = { version = "34.0", default-features = false, optional = true }
 sp-runtime = { version = "35.0", default-features = false, optional = true }
-sp-std = { version = "14.0", default-features = false, optional = true }
+sp-std     = { version = "14.0", default-features = false, optional = true }
 
 # The indirect dependency `syn` 2.0.4 has a bug that causes
 # compilation errors in `tendermint`. This is fixed in 2.0.5.
@@ -26,6 +26,6 @@ sp-std = { version = "14.0", default-features = false, optional = true }
 syn = ">=2.0.5"
 
 [features]
-panic-handler = []
-use-substrate = ["sp-core", "sp-io", "sp-runtime", "sp-std"]
-substrate-std = ["sp-core/std", "sp-io/std", "sp-runtime/std", "sp-std/std"]
+panic-handler = [  ]
+use-substrate = [ "sp-core", "sp-io", "sp-runtime", "sp-std" ]
+substrate-std = [ "sp-core/std", "sp-io/std", "sp-runtime/std", "sp-std/std" ]
diff --git a/clippy.toml b/clippy.toml
index 24256e918..76e4dff64 100644
--- a/clippy.toml
+++ b/clippy.toml
@@ -7,4 +7,4 @@ disallowed-types = [
 disallowed-methods = [
     "std::time::Duration::as_secs_f64",
 ]
-msrv = "1.72"
+msrv = "1.71.1"
diff --git a/ibc-apps/Cargo.toml b/ibc-apps/Cargo.toml
index a6fe583b3..6ef3c6ac6 100644
--- a/ibc-apps/Cargo.toml
+++ b/ibc-apps/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "applications", "token-transfer"]
+keywords     = [ "blockchain", "cosmos", "ibc", "applications", "token-transfer" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement various
     IBC applications, enabling smooth integration of IBC business logic into any blockchain system.
 """
@@ -21,25 +22,25 @@ ibc-app-transfer     = { workspace = true }
 ibc-app-nft-transfer = { workspace = true, optional = true, features = [ "std", "serde", "schema", "borsh", "parity-scale-codec" ] }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-app-transfer/std",
-    "nft-transfer",
+  "ibc-app-transfer/std",
+  "nft-transfer",
 ]
 serde = [
-    "ibc-app-transfer/serde",
+  "ibc-app-transfer/serde",
 ]
 schema = [
-    "ibc-app-transfer/schema",
-    "serde",
-    "std",
+  "ibc-app-transfer/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-app-transfer/borsh",
+  "ibc-app-transfer/borsh",
 ]
 parity-scale-codec = [
-    "ibc-app-transfer/parity-scale-codec",
+  "ibc-app-transfer/parity-scale-codec",
 ]
 nft-transfer = [
-    "ibc-app-nft-transfer"
+  "ibc-app-nft-transfer",
 ]
diff --git a/ibc-apps/ics20-transfer/Cargo.toml b/ibc-apps/ics20-transfer/Cargo.toml
index 4d54f2bf6..b904e0902 100644
--- a/ibc-apps/ics20-transfer/Cargo.toml
+++ b/ibc-apps/ics20-transfer/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20"]
+keywords     = [ "blockchain", "cosmos", "ibc", "transfer", "ics20" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-20 Fungible Token Transfer
     application logic and re-exports essential data structures and domain types from
     `ibc-app-transfer-types` crate.
@@ -19,7 +20,7 @@ all-features = true
 
 [dependencies]
 # external dependencies
-serde_json =  { workspace = true, optional = true }
+serde_json = { workspace = true, optional = true }
 
 # ibc dependencies
 ibc-core               = { workspace = true }
@@ -29,28 +30,28 @@ ibc-app-transfer-types = { workspace = true }
 subtle-encoding = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-app-transfer-types/std",
-    "ibc-core/std",
-    "serde_json/std",
+  "ibc-app-transfer-types/std",
+  "ibc-core/std",
+  "serde_json/std",
 ]
 serde = [
-    "ibc-app-transfer-types/serde",
-    "ibc-core/serde",
-    "serde_json"
+  "ibc-app-transfer-types/serde",
+  "ibc-core/serde",
+  "serde_json",
 ]
 schema = [
-    "ibc-app-transfer-types/schema",
-    "ibc-core/schema",
-    "serde",
-    "std",
+  "ibc-app-transfer-types/schema",
+  "ibc-core/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-app-transfer-types/borsh",
-    "ibc-core/borsh",
+  "ibc-app-transfer-types/borsh",
+  "ibc-core/borsh",
 ]
 parity-scale-codec = [
-    "ibc-app-transfer-types/parity-scale-codec",
-    "ibc-core/parity-scale-codec",
+  "ibc-app-transfer-types/parity-scale-codec",
+  "ibc-core/parity-scale-codec",
 ]
diff --git a/ibc-apps/ics20-transfer/types/Cargo.toml b/ibc-apps/ics20-transfer/types/Cargo.toml
index 7afb599eb..f967ce8f7 100644
--- a/ibc-apps/ics20-transfer/types/Cargo.toml
+++ b/ibc-apps/ics20-transfer/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "transfer", "ics20"]
+keywords     = [ "blockchain", "cosmos", "ibc", "transfer", "ics20" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-20 Fungible Token Transfer data structures and
     domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
     applicability to facilitate development and integration across diverse IBC-enabled projects.
@@ -22,7 +23,7 @@ all-features = true
 borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
-primitive-types = { version = "0.12.2", default-features = false, features = ["serde_no_std"] }
+primitive-types = { version = "0.12.2", default-features = false, features = [ "serde_no_std" ] }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 uint            = { version = "0.9", default-features = false }
@@ -32,44 +33,44 @@ ibc-core  = { workspace = true }
 ibc-proto = { workspace = true }
 
 ## parity dependencies
-parity-scale-codec = { workspace = true , optional = true }
-scale-info         = { workspace = true , optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [dev-dependencies]
-serde_json  = { workspace = true }
-rstest      = { workspace = true }
+serde_json = { workspace = true }
+rstest     = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "serde/std",
-    "serde_json/std",
-    "displaydoc/std",
-    "uint/std",
-    "primitive-types/std",
-    "ibc-core/std",
-    "ibc-proto/std",
+  "serde/std",
+  "serde_json/std",
+  "displaydoc/std",
+  "uint/std",
+  "primitive-types/std",
+  "ibc-core/std",
+  "ibc-proto/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-core/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core/borsh",
-    "ibc-proto/borsh"
+  "dep:borsh",
+  "ibc-core/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core/parity-scale-codec",
-    "ibc-proto/parity-scale-codec"
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-apps/ics721-nft-transfer/Cargo.toml b/ibc-apps/ics721-nft-transfer/Cargo.toml
index aaba18862..f1146b970 100644
--- a/ibc-apps/ics721-nft-transfer/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["cosmos", "ibc", "nft", "transfer", "ics721"]
+keywords     = [ "cosmos", "ibc", "nft", "transfer", "ics721" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-721 Non-Fungible Token Transfer
     application logic and re-exports essential data structures and domain types from
     `ibc-app-nft-transfer-types` crate.
@@ -26,28 +27,28 @@ ibc-app-nft-transfer-types = { workspace = true }
 ibc-core                   = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-app-nft-transfer-types/std",
-    "ibc-core/std",
-    "serde_json/std",
+  "ibc-app-nft-transfer-types/std",
+  "ibc-core/std",
+  "serde_json/std",
 ]
 serde = [
-    "ibc-app-nft-transfer-types/serde",
-    "ibc-core/serde",
-    "serde_json"
+  "ibc-app-nft-transfer-types/serde",
+  "ibc-core/serde",
+  "serde_json",
 ]
 schema = [
-    "ibc-app-nft-transfer-types/schema",
-    "ibc-core/schema",
-    "serde",
-    "std",
+  "ibc-app-nft-transfer-types/schema",
+  "ibc-core/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-app-nft-transfer-types/borsh",
-    "ibc-core/borsh",
+  "ibc-app-nft-transfer-types/borsh",
+  "ibc-core/borsh",
 ]
 parity-scale-codec = [
-    "ibc-app-nft-transfer-types/parity-scale-codec",
-    "ibc-core/parity-scale-codec",
+  "ibc-app-nft-transfer-types/parity-scale-codec",
+  "ibc-core/parity-scale-codec",
 ]
diff --git a/ibc-apps/ics721-nft-transfer/types/Cargo.toml b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
index 8b7d27b91..b520aebdc 100644
--- a/ibc-apps/ics721-nft-transfer/types/Cargo.toml
+++ b/ibc-apps/ics721-nft-transfer/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["cosmos", "ibc", "transfer", "nft", "ics721"]
+keywords     = [ "cosmos", "ibc", "transfer", "nft", "ics721" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-721 Non-Fungible Token Transfer data structures and
     domain types, as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal
     applicability to facilitate development and integration across diverse IBC-enabled projects.
@@ -19,15 +20,15 @@ all-features = true
 
 [dependencies]
 # external dependencies
-borsh           = { workspace = true, optional = true }
-base64          = { workspace = true, features = ["alloc"] }
-derive_more     = { workspace = true }
-displaydoc      = { workspace = true }
-http            = { version = "1.0.0" }
-mime            = { version = "0.3.17" }
-schemars        = { workspace = true, optional = true }
-serde           = { workspace = true, optional = true }
-serde_json      = { workspace = true }
+borsh       = { workspace = true, optional = true }
+base64      = { workspace = true, features = [ "alloc" ] }
+derive_more = { workspace = true }
+displaydoc  = { workspace = true }
+http        = { version = "1.0.0" }
+mime        = { version = "0.3.17" }
+schemars    = { workspace = true, optional = true }
+serde       = { workspace = true, optional = true }
+serde_json  = { workspace = true }
 
 # ibc dependencies
 ibc-core               = { workspace = true }
@@ -35,48 +36,48 @@ ibc-proto              = { workspace = true }
 ibc-app-transfer-types = { workspace = true }
 
 ## parity dependencies
-parity-scale-codec = { workspace = true , optional = true }
-scale-info         = { workspace = true , optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [dev-dependencies]
-rstest      = { workspace = true }
+rstest = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "serde/std",
-    "serde_json/std",
-    "base64/std",
-    "displaydoc/std",
-    "http/std",
-    "ibc-core/std",
-    "ibc-proto/std",
-    "ibc-app-transfer-types/std",
+  "serde/std",
+  "serde_json/std",
+  "base64/std",
+  "displaydoc/std",
+  "http/std",
+  "ibc-core/std",
+  "ibc-proto/std",
+  "ibc-app-transfer-types/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core/serde",
-    "ibc-proto/serde",
-    "ibc-app-transfer-types/serde",
+  "dep:serde",
+  "ibc-core/serde",
+  "ibc-proto/serde",
+  "ibc-app-transfer-types/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std",
-    "ibc-app-transfer-types/schema",
+  "dep:schemars",
+  "ibc-core/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
+  "ibc-app-transfer-types/schema",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core/borsh",
-    "ibc-proto/borsh",
-    "ibc-app-transfer-types/borsh",
+  "dep:borsh",
+  "ibc-core/borsh",
+  "ibc-proto/borsh",
+  "ibc-app-transfer-types/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
-    "ibc-app-transfer-types/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
+  "ibc-app-transfer-types/parity-scale-codec",
 ]
diff --git a/ibc-clients/Cargo.toml b/ibc-clients/Cargo.toml
index 1f1e35812..0ab910b3c 100644
--- a/ibc-clients/Cargo.toml
+++ b/ibc-clients/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "applications", "tendermint"]
+keywords     = [ "blockchain", "cosmos", "ibc", "applications", "tendermint" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement
     various IBC light clients, enabling smooth integration with IBC-enabled blockchains.
 """
@@ -21,24 +22,24 @@ ibc-client-tendermint = { workspace = true }
 ibc-client-wasm-types = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-client-tendermint/std",
-    "ibc-client-wasm-types/std",
+  "ibc-client-tendermint/std",
+  "ibc-client-wasm-types/std",
 ]
 serde = [
-    "ibc-client-tendermint/serde",
-    "ibc-client-wasm-types/serde",
+  "ibc-client-tendermint/serde",
+  "ibc-client-wasm-types/serde",
 ]
 schema = [
-    "ibc-client-tendermint/schema",
-    "ibc-client-wasm-types/schema",
-    "serde",
-    "std"
+  "ibc-client-tendermint/schema",
+  "ibc-client-wasm-types/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-client-tendermint/borsh",
+  "ibc-client-tendermint/borsh",
 ]
 parity-scale-codec = [
-    "ibc-client-tendermint/parity-scale-codec",
+  "ibc-client-tendermint/parity-scale-codec",
 ]
diff --git a/ibc-clients/cw-context/Cargo.toml b/ibc-clients/cw-context/Cargo.toml
index 95132d252..7cb2ef06f 100644
--- a/ibc-clients/cw-context/Cargo.toml
+++ b/ibc-clients/cw-context/Cargo.toml
@@ -6,9 +6,10 @@ license      = { workspace = true }
 repository   = { workspace = true }
 rust-version = { workspace = true }
 version      = { workspace = true }
-keywords     = ["ibc", "light-client", "CosmWasm", "ICS-08"]
+keywords     = [ "ibc", "light-client", "CosmWasm", "ICS-08" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Contains types and implementations that are needed to integrate a light client, built using ibc-rs,
     into CosmWasm contract. It functions as a library, allowing users to import the ready-made `Context`
     object that is generic across light clients, introduce their concrete client type and integrate
@@ -19,22 +20,22 @@ description  = """
 # external dependencies
 derive_more = { workspace = true }
 prost       = { workspace = true }
-serde       = { workspace = true, features = ["derive"] }
+serde       = { workspace = true, features = [ "derive" ] }
 
 # ibc dependencies
 ibc-core              = { workspace = true }
-ibc-client-wasm-types = { workspace = true, features = ["cosmwasm"] }
+ibc-client-wasm-types = { workspace = true, features = [ "cosmwasm" ] }
 
 # cosmwasm dependencies
-cosmwasm-schema       = { workspace = true }
-cosmwasm-std          = { workspace = true }
-cw-storage-plus       = { workspace = true }
+cosmwasm-schema = { workspace = true }
+cosmwasm-std    = { workspace = true }
+cw-storage-plus = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "prost/std",
-    "serde/std",
-    "ibc-core/std",
-    "ibc-client-wasm-types/std",
+  "prost/std",
+  "serde/std",
+  "ibc-core/std",
+  "ibc-client-wasm-types/std",
 ]
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index f7da34cae..e9983c8ec 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -1,14 +1,14 @@
 [package]
-name         = "ibc-client-tendermint"
-version      = { workspace = true }
-authors      = { workspace = true }
-edition      = { workspace = true }
+name = "ibc-client-tendermint"
+version = { workspace = true }
+authors = { workspace = true }
+edition = { workspace = true }
 rust-version = { workspace = true }
-license      = { workspace = true }
-repository   = { workspace = true }
-readme       = "./../README.md"
-keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-description  = """
+license = { workspace = true }
+repository = { workspace = true }
+readme = "./../README.md"
+keywords = [ "blockchain", "consensus", "cosmos", "ibc", "tendermint" ]
+description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-07 Tendermint Client logic
     and re-exports essential data structures and domain types from `ibc-client-tendermint-types` crate.
 """
@@ -22,60 +22,60 @@ derive_more = { workspace = true }
 serde       = { workspace = true, optional = true }
 
 # ibc dependencies
-ibc-client-tendermint-types      = { workspace = true }
-ibc-core-client                  = { workspace = true }
-ibc-core-commitment-types        = { workspace = true }
-ibc-core-host                    = { workspace = true }
-ibc-core-handler-types           = { workspace = true }
-ibc-primitives                   = { workspace = true }
+ibc-client-tendermint-types = { workspace = true }
+ibc-core-client             = { workspace = true }
+ibc-core-commitment-types   = { workspace = true }
+ibc-core-host               = { workspace = true }
+ibc-core-handler-types      = { workspace = true }
+ibc-primitives              = { workspace = true }
 
 # cosmos dependencies
 tendermint                       = { workspace = true }
-tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
+tendermint-light-client-verifier = { workspace = true, features = [ "rust-crypto" ] }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "serde/std",
-    "ibc-client-tendermint-types/std",
-    "ibc-core-client/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
+  "serde/std",
+  "ibc-client-tendermint-types/std",
+  "ibc-core-client/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-client-tendermint-types/serde",
-    "ibc-core-client/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "dep:serde",
+  "ibc-client-tendermint-types/serde",
+  "ibc-core-client/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "ibc-client-tendermint-types/schema",
-    "ibc-core-client/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-client-tendermint-types/schema",
+  "ibc-core-client/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-client-tendermint-types/borsh",
-    "ibc-core-client/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-client-tendermint-types/borsh",
+  "ibc-core-client/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "ibc-client-tendermint-types/parity-scale-codec",
-    "ibc-core-client/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-client-tendermint-types/parity-scale-codec",
+  "ibc-core-client/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
index 49b4f06c8..8c5c35733 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/cw-contract/Cargo.toml
@@ -6,14 +6,15 @@ license      = { workspace = true }
 repository   = { workspace = true }
 rust-version = { workspace = true }
 version      = { workspace = true }
-keywords     = ["ibc", "light-client", "ics07", "tendermint", "CosmWasm"]
+keywords     = [ "ibc", "light-client", "ics07", "tendermint", "CosmWasm" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     The ICS-08 CosmWasm contract implementation of the ICS-07 Tendermint light client.
 """
 
 [lib]
-crate-type = ["cdylib", "rlib"]
+crate-type = [ "cdylib", "rlib" ]
 
 [dependencies]
 # ibc dependencies
@@ -22,13 +23,12 @@ ibc-client-cw         = { workspace = true }
 ibc-client-tendermint = { workspace = true }
 
 # cosmwasm dependencies
-cosmwasm-std          = { workspace = true }
+cosmwasm-std = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core/std",
-    "ibc-client-cw/std",
-    "ibc-client-tendermint/std",
+  "ibc-core/std",
+  "ibc-client-cw/std",
+  "ibc-client-tendermint/std",
 ]
-
diff --git a/ibc-clients/ics07-tendermint/types/Cargo.toml b/ibc-clients/ics07-tendermint/types/Cargo.toml
index 2eae85a94..d52a1f260 100644
--- a/ibc-clients/ics07-tendermint/types/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "tendermint", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "tendermint", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-07 Tendermint Client data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -32,7 +33,7 @@ ibc-proto                 = { workspace = true }
 
 # cosmos dependencies
 tendermint                       = { workspace = true }
-tendermint-light-client-verifier = { workspace = true, features = ["rust-crypto"] }
+tendermint-light-client-verifier = { workspace = true, features = [ "rust-crypto" ] }
 tendermint-proto                 = { workspace = true }
 
 # parity dependencies
@@ -44,49 +45,49 @@ serde_json     = { workspace = true }
 tendermint-rpc = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "serde_json/std",
-    "ibc-core-client-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "serde/std",
+  "serde_json/std",
+  "ibc-core-client-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "ibc-core-client-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "ibc-core-client-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-clients/ics08-wasm/types/Cargo.toml b/ibc-clients/ics08-wasm/types/Cargo.toml
index db986dc74..57c73e78b 100644
--- a/ibc-clients/ics08-wasm/types/Cargo.toml
+++ b/ibc-clients/ics08-wasm/types/Cargo.toml
@@ -1,14 +1,15 @@
 [package]
-name = "ibc-client-wasm-types"
+name         = "ibc-client-wasm-types"
 version      = { workspace = true }
 authors      = { workspace = true }
 edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "wasm", "ics08"]
+keywords     = [ "blockchain", "cosmos", "ibc", "wasm", "ics08" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-08 Wasm Light Client data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -16,10 +17,10 @@ description  = """
 
 [dependencies]
 # external dependencies
-base64          = { workspace = true , features = ["alloc"] }
+base64          = { workspace = true, features = [ "alloc" ] }
 displaydoc      = { workspace = true }
-serde           = { workspace = true , optional = true }
-cosmwasm-schema = { workspace = true , optional = true }
+serde           = { workspace = true, optional = true }
+cosmwasm-schema = { workspace = true, optional = true }
 
 # ibc dependencies
 ibc-core-client     = { workspace = true }
@@ -32,31 +33,31 @@ rstest     = { workspace = true }
 serde_json = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client/std",
-    "ibc-core-host-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "base64/std",
-    "serde/std"
+  "ibc-core-client/std",
+  "ibc-core-host-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "base64/std",
+  "serde/std",
 ]
 serde = [
-    "ibc-core-client/serde",
-    "ibc-core-host-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
-    "dep:serde"
+  "ibc-core-client/serde",
+  "ibc-core-host-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
+  "dep:serde",
 ]
 schema = [
-    "ibc-core-client/schema",
-    "ibc-core-host-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "ibc-core-client/schema",
+  "ibc-core-host-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 cosmwasm = [
-    "cosmwasm-schema",
-    "schema"
+  "cosmwasm-schema",
+  "schema",
 ]
diff --git a/ibc-core/Cargo.toml b/ibc-core/Cargo.toml
index 4eed1c18e..eebb12318 100644
--- a/ibc-core/Cargo.toml
+++ b/ibc-core/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "core"]
+keywords     = [ "blockchain", "cosmos", "ibc", "core" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, re-exports a comprehensive set of libraries that implement IBC core (TAO)
     modules, facilitating seamless integration of IBC core business logic into any blockchain system.
 """
@@ -28,56 +29,56 @@ ibc-derive                = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client/std",
-    "ibc-core-connection/std",
-    "ibc-core-channel/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host/std",
-    "ibc-core-router/std",
-    "ibc-core-handler/std",
-    "ibc-primitives/std",
+  "ibc-core-client/std",
+  "ibc-core-connection/std",
+  "ibc-core-channel/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host/std",
+  "ibc-core-router/std",
+  "ibc-core-handler/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client/serde",
-    "ibc-core-connection/serde",
-    "ibc-core-channel/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-router/serde",
-    "ibc-core-handler/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client/serde",
+  "ibc-core-connection/serde",
+  "ibc-core-channel/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-router/serde",
+  "ibc-core-handler/serde",
+  "ibc-primitives/serde",
 ]
 borsh = [
-    "ibc-core-client/borsh",
-    "ibc-core-connection/borsh",
-    "ibc-core-channel/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-router/borsh",
-    "ibc-core-handler/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client/borsh",
+  "ibc-core-connection/borsh",
+  "ibc-core-channel/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-router/borsh",
+  "ibc-core-handler/borsh",
+  "ibc-primitives/borsh",
 ]
 schema = [
-    "ibc-core-client/schema",
-    "ibc-core-connection/schema",
-    "ibc-core-channel/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-router/schema",
-    "ibc-core-handler/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client/schema",
+  "ibc-core-connection/schema",
+  "ibc-core-channel/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-router/schema",
+  "ibc-core-handler/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-core-client/parity-scale-codec",
-    "ibc-core-connection/parity-scale-codec",
-    "ibc-core-channel/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-router/parity-scale-codec",
-    "ibc-core-handler/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client/parity-scale-codec",
+  "ibc-core-connection/parity-scale-codec",
+  "ibc-core-channel/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-router/parity-scale-codec",
+  "ibc-core-handler/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics02-client/Cargo.toml b/ibc-core/ics02-client/Cargo.toml
index 7c6340022..7502b6a25 100644
--- a/ibc-core/ics02-client/Cargo.toml
+++ b/ibc-core/ics02-client/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "light-client"]
+keywords     = [ "blockchain", "cosmos", "ibc", "light-client" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains the implementation of ICS-02 Client Semantics and
     re-exports essential data structures and domain types from `ibc-core-client-types` crate.
 """
@@ -25,46 +26,46 @@ ibc-core-handler-types    = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client-types/std",
-    "ibc-core-client-context/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
+  "ibc-core-client-types/std",
+  "ibc-core-client-context/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client-types/serde",
-    "ibc-core-client-context/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-client-context/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 borsh = [
-    "ibc-core-client-types/borsh",
-    "ibc-core-client-context/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-client-context/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 schema = [
-    "ibc-core-client-types/schema",
-    "ibc-core-client-context/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client-types/schema",
+  "ibc-core-client-context/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-client-context/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-client-context/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics02-client/context/Cargo.toml b/ibc-core/ics02-client/context/Cargo.toml
index e4eb8db05..9085da29e 100644
--- a/ibc-core/ics02-client/context/Cargo.toml
+++ b/ibc-core/ics02-client/context/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc"]
+keywords     = [ "blockchain", "cosmos", "ibc" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintaind by `ibc-rs`, contains essential APIs to interface with the host chain's store,
     enabling smooth client state transitions. Additionally, provides necessary traits for
     implementing custom IBC light clients.
@@ -34,43 +35,43 @@ ibc-primitives            = { workspace = true }
 tendermint = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "subtle-encoding/std",
-    "ibc-core-client-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "subtle-encoding/std",
+  "ibc-core-client-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
+  "tendermint/std",
 ]
 serde = [
-    "ibc-core-client-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 borsh = [
-    "ibc-core-client-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 schema = [
-    "ibc-core-client-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics02-client/types/Cargo.toml b/ibc-core/ics02-client/types/Cargo.toml
index de5f7b656..bc11d449c 100644
--- a/ibc-core/ics02-client/types/Cargo.toml
+++ b/ibc-core/ics02-client/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "client", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "client", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-02 Client Semantics data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -36,49 +37,49 @@ ibc-proto                 = { workspace = true }
 tendermint = { workspace = true }
 
 # parity dependencies
-parity-scale-codec  = { workspace = true, optional = true }
-scale-info          = { workspace = true, optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "subtle-encoding/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "serde/std",
+  "subtle-encoding/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "ibc-core-host-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
-    "dep:serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
+  "dep:serde",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core-host-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core-host-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics03-connection/Cargo.toml b/ibc-core/ics03-connection/Cargo.toml
index c43f93c8e..7cea316c2 100644
--- a/ibc-core/ics03-connection/Cargo.toml
+++ b/ibc-core/ics03-connection/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "connection"]
+keywords     = [ "blockchain", "cosmos", "ibc", "connection" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-03 Connection Semantics and
     re-exports essential data structures and domain types from `ibc-core-connection-types` crate.
 """
@@ -24,41 +25,41 @@ ibc-core-handler-types    = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-host/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
+  "ibc-core-client/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-host/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "ibc-core-client/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-core-client/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "ibc-core-client/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics03-connection/types/Cargo.toml b/ibc-core/ics03-connection/types/Cargo.toml
index 07091d845..39ecc8485 100644
--- a/ibc-core/ics03-connection/types/Cargo.toml
+++ b/ibc-core/ics03-connection/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "connection", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "connection", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-03 Connection Semantics data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -41,50 +42,50 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "subtle-encoding/std",
-    "serde/std",
-    "ibc-core-client-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "subtle-encoding/std",
+  "serde/std",
+  "ibc-core-client-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core-client-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core-client-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics03-connection/types/src/events.rs b/ibc-core/ics03-connection/types/src/events.rs
index 1c2879852..08f64d9e1 100644
--- a/ibc-core/ics03-connection/types/src/events.rs
+++ b/ibc-core/ics03-connection/types/src/events.rs
@@ -393,11 +393,17 @@ mod tests {
             assert_eq!(t.kind, t.event.kind);
             assert_eq!(t.expected_keys.len(), t.event.attributes.len());
             for (i, e) in t.event.attributes.iter().enumerate() {
-                assert_eq!(e.key, t.expected_keys[i], "key mismatch for {:?}", t.kind);
+                assert_eq!(
+                    e.key_str().unwrap(),
+                    t.expected_keys[i],
+                    "key mismatch for {:?}",
+                    t.kind
+                );
             }
             for (i, e) in t.event.attributes.iter().enumerate() {
                 assert_eq!(
-                    e.value, t.expected_values[i],
+                    e.value_str().unwrap(),
+                    t.expected_values[i],
                     "value mismatch for {:?}",
                     t.kind
                 );
diff --git a/ibc-core/ics04-channel/Cargo.toml b/ibc-core/ics04-channel/Cargo.toml
index 3f61d5092..1ad973cc1 100644
--- a/ibc-core/ics04-channel/Cargo.toml
+++ b/ibc-core/ics04-channel/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "channel"]
+keywords     = [ "blockchain", "cosmos", "ibc", "channel" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-04 Channel & Packet Semantics and
     re-exports essential data structures and domain types from `ibc-core-channel-types` crate.
 """
@@ -27,56 +28,56 @@ ibc-core-router           = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client/std",
-    "ibc-core-connection/std",
-    "ibc-core-channel-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host/std",
-    "ibc-core-handler-types/std",
-    "ibc-core-router/std",
-    "ibc-primitives/std",
+  "ibc-core-client/std",
+  "ibc-core-connection/std",
+  "ibc-core-channel-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host/std",
+  "ibc-core-handler-types/std",
+  "ibc-core-router/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client/serde",
-    "ibc-core-connection/serde",
-    "ibc-core-channel-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-core-router/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client/serde",
+  "ibc-core-connection/serde",
+  "ibc-core-channel-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-core-router/serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "ibc-core-client/schema",
-    "ibc-core-connection/schema",
-    "ibc-core-channel-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-core-router/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client/schema",
+  "ibc-core-connection/schema",
+  "ibc-core-channel-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-core-router/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-core-client/borsh",
-    "ibc-core-connection/borsh",
-    "ibc-core-channel-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-core-router/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client/borsh",
+  "ibc-core-connection/borsh",
+  "ibc-core-channel-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-core-router/borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "ibc-core-client/parity-scale-codec",
-    "ibc-core-connection/parity-scale-codec",
-    "ibc-core-channel-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-core-router/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client/parity-scale-codec",
+  "ibc-core-connection/parity-scale-codec",
+  "ibc-core-channel-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-core-router/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics04-channel/types/Cargo.toml b/ibc-core/ics04-channel/types/Cargo.toml
index 55aee47f5..0ee9080c9 100644
--- a/ibc-core/ics04-channel/types/Cargo.toml
+++ b/ibc-core/ics04-channel/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "channel", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "channel", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-4 Channel Semantics data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -43,56 +44,56 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "sha2/std",
-    "serde/std",
-    "subtle-encoding/std",
-    "ibc-core-client-types/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "sha2/std",
+  "serde/std",
+  "subtle-encoding/std",
+  "ibc-core-client-types/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core-client-types/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core-client-types/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics04-channel/types/src/events/mod.rs b/ibc-core/ics04-channel/types/src/events/mod.rs
index 443119b3e..ee83a4028 100644
--- a/ibc-core/ics04-channel/types/src/events/mod.rs
+++ b/ibc-core/ics04-channel/types/src/events/mod.rs
@@ -1246,12 +1246,18 @@ mod tests {
             assert_eq!(t.kind, t.event.kind);
             assert_eq!(t.expected_keys.len(), t.event.attributes.len());
             for (i, e) in t.event.attributes.iter().enumerate() {
-                assert_eq!(e.key, t.expected_keys[i], "key mismatch for {:?}", t.kind);
+                assert_eq!(
+                    e.key_str().unwrap(),
+                    t.expected_keys[i],
+                    "key mismatch for {:?}",
+                    t.kind
+                );
             }
             assert_eq!(t.expected_values.len(), t.event.attributes.len());
             for (i, e) in t.event.attributes.iter().enumerate() {
                 assert_eq!(
-                    e.value, t.expected_values[i],
+                    e.value_str().unwrap(),
+                    t.expected_values[i],
                     "value mismatch for {:?}",
                     t.kind
                 );
diff --git a/ibc-core/ics23-commitment/types/Cargo.toml b/ibc-core/ics23-commitment/types/Cargo.toml
index 905689347..27ce743c6 100644
--- a/ibc-core/ics23-commitment/types/Cargo.toml
+++ b/ibc-core/ics23-commitment/types/Cargo.toml
@@ -1,14 +1,15 @@
 [package]
-name = "ibc-core-commitment-types"
+name         = "ibc-core-commitment-types"
 version      = { workspace = true }
 authors      = { workspace = true }
 edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "commitment", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "commitment", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-23 Vector Commitments data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -20,55 +21,55 @@ all-features = true
 [dependencies]
 # external dependencies
 borsh           = { workspace = true, optional = true }
-derive_more     = { workspace = true, features = ["as_ref"] }
+derive_more     = { workspace = true, features = [ "as_ref" ] }
 displaydoc      = { workspace = true }
 schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
 
 # ibc dependencies
-ibc-proto       = { workspace = true }
-ibc-primitives  = { workspace = true }
-ics23           = { version = "0.11", default-features = false, features = ["host-functions"] }
+ibc-proto      = { workspace = true }
+ibc-primitives = { workspace = true }
+ics23          = { version = "0.11", default-features = false, features = [ "host-functions" ] }
 
 # parity dependencies
-parity-scale-codec  = { workspace = true, optional = true }
-scale-info          = { workspace = true, optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [dev-dependencies]
 rstest = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "subtle-encoding/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "ics23/std",
+  "displaydoc/std",
+  "serde/std",
+  "subtle-encoding/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "ics23/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
-    "ics23/serde",
+  "dep:serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
+  "ics23/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-proto/json-schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-proto/json-schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-proto/borsh",
-    "ibc-primitives/borsh",
+  "dep:borsh",
+  "ibc-proto/borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics24-host/Cargo.toml b/ibc-core/ics24-host/Cargo.toml
index c3e56f554..c97fb7324 100644
--- a/ibc-core/ics24-host/Cargo.toml
+++ b/ibc-core/ics24-host/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "host"]
+keywords     = [ "blockchain", "cosmos", "ibc", "host" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains essential top-level traits designed for the seamless integration
     of host chains, facilitating access to the host's storage, the efficient retrieval of states and
     metadata crucial for the execution of any IBC datagrams.
@@ -19,9 +20,9 @@ all-features = true
 
 [dependencies]
 # external dependencies
-derive_more      = { workspace = true }
-displaydoc       = { workspace = true }
-subtle-encoding  = { workspace = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+subtle-encoding = { workspace = true }
 
 # ibc dependencies
 ibc-core-client-types     = { workspace = true }
@@ -37,57 +38,57 @@ ibc-primitives            = { workspace = true }
 rstest = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "subtle-encoding/std",
-    "ibc-core-client-types/std",
-    "ibc-core-client-context/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-channel-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
+  "displaydoc/std",
+  "subtle-encoding/std",
+  "ibc-core-client-types/std",
+  "ibc-core-client-context/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-channel-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client-types/serde",
-    "ibc-core-client-context/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-channel-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-client-context/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-channel-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "ibc-core-client-types/schema",
-    "ibc-core-client-context/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-channel-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client-types/schema",
+  "ibc-core-client-context/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-channel-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "ibc-core-client-types/borsh",
-    "ibc-core-client-context/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-channel-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-client-context/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-channel-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-channel-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-channel-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics24-host/cosmos/Cargo.toml b/ibc-core/ics24-host/cosmos/Cargo.toml
index e9c2e73e6..50e06f273 100644
--- a/ibc-core/ics24-host/cosmos/Cargo.toml
+++ b/ibc-core/ics24-host/cosmos/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "tendermint"]
+keywords     = [ "blockchain", "cosmos", "ibc", "tendermint" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains Cosmos-specific helper traits and implementations
     to facilitate IBC integration, ensuring proper interaction with modules/components
     beyond the IBC modules on host chains.
@@ -19,7 +20,7 @@ all-features = true
 
 [dependencies]
 # external dependencies
-borsh           = { workspace = true, optional = true}
+borsh           = { workspace = true, optional = true }
 derive_more     = { workspace = true }
 displaydoc      = { workspace = true }
 serde           = { workspace = true, optional = true }
@@ -46,66 +47,66 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "sha2/std",
-    "subtle-encoding/std",
-    "ibc-core-client-types/std",
-    "ibc-core-client-context/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
+  "displaydoc/std",
+  "serde/std",
+  "sha2/std",
+  "subtle-encoding/std",
+  "ibc-core-client-types/std",
+  "ibc-core-client-context/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-client-tendermint/serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-client-context/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-client-tendermint/serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-client-context/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "ibc-client-tendermint/schema",
-    "ibc-core-client-types/schema",
-    "ibc-core-client-context/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "ibc-client-tendermint/schema",
+  "ibc-core-client-types/schema",
+  "ibc-core-client-context/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-client-tendermint/borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-client-context/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-client-tendermint/borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-client-context/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-client-tendermint/parity-scale-codec",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-client-tendermint/parity-scale-codec",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics24-host/types/Cargo.toml b/ibc-core/ics24-host/types/Cargo.toml
index ec2d6ed1f..80c1efb2b 100644
--- a/ibc-core/ics24-host/types/Cargo.toml
+++ b/ibc-core/ics24-host/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "host", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "host", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-24 Host Requirements data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -29,35 +30,35 @@ serde       = { workspace = true, optional = true }
 ibc-primitives = { workspace = true }
 
 # parity dependencies
-parity-scale-codec  = { workspace = true, optional = true }
-scale-info          = { workspace = true, optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [dev-dependencies]
 rstest     = { workspace = true }
 serde_json = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "ibc-primitives/std",
+  "displaydoc/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-primitives/serde",
+  "dep:serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-primitives/borsh",
+  "dep:borsh",
+  "ibc-primitives/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-primitives/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics25-handler/Cargo.toml b/ibc-core/ics25-handler/Cargo.toml
index af7589735..43dcf44ed 100644
--- a/ibc-core/ics25-handler/Cargo.toml
+++ b/ibc-core/ics25-handler/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "handler"]
+keywords     = [ "blockchain", "cosmos", "ibc", "handler" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, exposes IBC handler entry points for an integrated IBC core modules.
     These entry points are responsible for processing incoming IBC messages, performing validation,
     and execution logic by invoking the appropriate module handler.
@@ -28,55 +29,55 @@ ibc-core-host             = { workspace = true }
 ibc-primitives            = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-core-client/std",
-    "ibc-core-connection/std",
-    "ibc-core-channel/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host/std",
-    "ibc-core-router/std",
-    "ibc-core-handler-types/std",
-    "ibc-primitives/std",
+  "ibc-core-client/std",
+  "ibc-core-connection/std",
+  "ibc-core-channel/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host/std",
+  "ibc-core-router/std",
+  "ibc-core-handler-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-core-client/serde",
-    "ibc-core-connection/serde",
-    "ibc-core-channel/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host/serde",
-    "ibc-core-router/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-primitives/serde",
+  "ibc-core-client/serde",
+  "ibc-core-connection/serde",
+  "ibc-core-channel/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host/serde",
+  "ibc-core-router/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-primitives/serde",
 ]
 borsh = [
-    "ibc-core-client/borsh",
-    "ibc-core-connection/borsh",
-    "ibc-core-channel/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host/borsh",
-    "ibc-core-router/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-core-client/borsh",
+  "ibc-core-connection/borsh",
+  "ibc-core-channel/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host/borsh",
+  "ibc-core-router/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-primitives/borsh",
 ]
 schema = [
-    "ibc-core-client/schema",
-    "ibc-core-connection/schema",
-    "ibc-core-channel/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host/schema",
-    "ibc-core-router/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-client/schema",
+  "ibc-core-connection/schema",
+  "ibc-core-channel/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host/schema",
+  "ibc-core-router/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-core-client/parity-scale-codec",
-    "ibc-core-connection/parity-scale-codec",
-    "ibc-core-channel/parity-scale-codec",
-    "ibc-core-host/parity-scale-codec",
-    "ibc-core-router/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-client/parity-scale-codec",
+  "ibc-core-connection/parity-scale-codec",
+  "ibc-core-channel/parity-scale-codec",
+  "ibc-core-host/parity-scale-codec",
+  "ibc-core-router/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics25-handler/types/Cargo.toml b/ibc-core/ics25-handler/types/Cargo.toml
index 853e43c39..8e5154493 100644
--- a/ibc-core/ics25-handler/types/Cargo.toml
+++ b/ibc-core/ics25-handler/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "handler", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "handler", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-25 Handler Interface data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -44,65 +45,65 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "subtle-encoding/std",
-    "ibc-core-client-types/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-channel-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-router-types/std",
-    "ibc-primitives/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "serde/std",
+  "subtle-encoding/std",
+  "ibc-core-client-types/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-channel-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-router-types/std",
+  "ibc-primitives/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-channel-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-router-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-channel-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-router-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core-client-types/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-channel-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-router-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core-client-types/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-channel-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-router-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-channel-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-router-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-channel-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-router-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-channel-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-router-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-channel-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-router-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-core/ics26-routing/Cargo.toml b/ibc-core/ics26-routing/Cargo.toml
index 482bf719d..cf809acf1 100644
--- a/ibc-core/ics26-routing/Cargo.toml
+++ b/ibc-core/ics26-routing/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "routing"]
+keywords     = [ "blockchain", "cosmos", "ibc", "routing" ]
 readme       = "./../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, contains necessary traits to implement the routing and callback functionality
     (IBC router module) used for connecting the application layer to the transport layer of an IBC enabled chain.
 """
@@ -29,38 +30,38 @@ ibc-core-host-types    = { workspace = true }
 ibc-core-router-types  = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "subtle-encoding/std",
-    "ibc-primitives/std",
-    "ibc-core-channel-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-router-types/std",
+  "displaydoc/std",
+  "subtle-encoding/std",
+  "ibc-primitives/std",
+  "ibc-core-channel-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-router-types/std",
 ]
 serde = [
-    "ibc-primitives/serde",
-    "ibc-core-channel-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-router-types/serde",
+  "ibc-primitives/serde",
+  "ibc-core-channel-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-router-types/serde",
 ]
 borsh = [
-    "ibc-primitives/borsh",
-    "ibc-core-channel-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-router-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-core-channel-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-router-types/borsh",
 ]
 schema = [
-    "ibc-core-channel-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-router-types/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-core-channel-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-router-types/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-core-channel-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-router-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-core-channel-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-router-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/ibc-core/ics26-routing/types/Cargo.toml b/ibc-core/ics26-routing/types/Cargo.toml
index e9691d43a..71acf4bee 100644
--- a/ibc-core/ics26-routing/types/Cargo.toml
+++ b/ibc-core/ics26-routing/types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc", "routing", "types"]
+keywords     = [ "blockchain", "cosmos", "ibc", "routing", "types" ]
 readme       = "./../../README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, encapsulates essential ICS-26 Routing Module data structures and domain types,
     as specified in the Inter-Blockchain Communication (IBC) protocol. Designed for universal applicability
     to facilitate development and integration across diverse IBC-enabled projects.
@@ -27,9 +28,9 @@ serde           = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
 
 # ibc dependencies
-ibc-core-host-types    = { workspace = true }
-ibc-primitives         = { workspace = true }
-ibc-proto              = {workspace = true }
+ibc-core-host-types = { workspace = true }
+ibc-primitives      = { workspace = true }
+ibc-proto           = { workspace = true }
 
 # cosmos dependencies
 tendermint = { workspace = true }
@@ -39,41 +40,41 @@ parity-scale-codec = { workspace = true, optional = true }
 scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "serde/std",
-    "subtle-encoding/std",
-    "ibc-primitives/std",
-    "ibc-core-host-types/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "displaydoc/std",
+  "serde/std",
+  "subtle-encoding/std",
+  "ibc-primitives/std",
+  "ibc-core-host-types/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-primitives/serde",
-    "ibc-core-host-types/serde",
-    "ibc-primitives/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-primitives/serde",
+  "ibc-core-host-types/serde",
+  "ibc-primitives/serde",
+  "ibc-proto/serde",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-primitives/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-primitives/borsh",
+  "ibc-proto/borsh",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-core-host-types/schema",
-    "ibc-primitives/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-core-host-types/schema",
+  "ibc-primitives/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-data-types/Cargo.toml b/ibc-data-types/Cargo.toml
index 30bc92a2c..da618570d 100644
--- a/ibc-data-types/Cargo.toml
+++ b/ibc-data-types/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc"]
+keywords     = [ "blockchain", "cosmos", "ibc" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, delineates standard data structures and domain types of the Inter-Blockchain Communication (IBC) protocol.
     Designed for universal application, enabling diverse projects across IBC ecosystem to build using a shared language.
 """
@@ -30,70 +31,70 @@ ibc-client-wasm-types       = { workspace = true }
 ibc-primitives              = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-app-transfer-types/std",
-    "ibc-core-client-types/std",
-    "ibc-core-connection-types/std",
-    "ibc-core-channel-types/std",
-    "ibc-core-commitment-types/std",
-    "ibc-core-host-types/std",
-    "ibc-core-router-types/std",
-    "ibc-core-handler-types/std",
-    "ibc-client-tendermint-types/std",
-    "ibc-client-wasm-types/std",
-    "ibc-primitives/std",
+  "ibc-app-transfer-types/std",
+  "ibc-core-client-types/std",
+  "ibc-core-connection-types/std",
+  "ibc-core-channel-types/std",
+  "ibc-core-commitment-types/std",
+  "ibc-core-host-types/std",
+  "ibc-core-router-types/std",
+  "ibc-core-handler-types/std",
+  "ibc-client-tendermint-types/std",
+  "ibc-client-wasm-types/std",
+  "ibc-primitives/std",
 ]
 serde = [
-    "ibc-app-transfer-types/serde",
-    "ibc-core-client-types/serde",
-    "ibc-core-connection-types/serde",
-    "ibc-core-channel-types/serde",
-    "ibc-core-commitment-types/serde",
-    "ibc-core-host-types/serde",
-    "ibc-core-router-types/serde",
-    "ibc-core-handler-types/serde",
-    "ibc-client-tendermint-types/serde",
-    "ibc-client-wasm-types/serde",
-    "ibc-primitives/serde",
+  "ibc-app-transfer-types/serde",
+  "ibc-core-client-types/serde",
+  "ibc-core-connection-types/serde",
+  "ibc-core-channel-types/serde",
+  "ibc-core-commitment-types/serde",
+  "ibc-core-host-types/serde",
+  "ibc-core-router-types/serde",
+  "ibc-core-handler-types/serde",
+  "ibc-client-tendermint-types/serde",
+  "ibc-client-wasm-types/serde",
+  "ibc-primitives/serde",
 ]
 borsh = [
-    "ibc-app-transfer-types/borsh",
-    "ibc-core-client-types/borsh",
-    "ibc-core-connection-types/borsh",
-    "ibc-core-channel-types/borsh",
-    "ibc-core-commitment-types/borsh",
-    "ibc-core-host-types/borsh",
-    "ibc-core-router-types/borsh",
-    "ibc-core-handler-types/borsh",
-    "ibc-client-tendermint-types/borsh",
-    "ibc-primitives/borsh",
+  "ibc-app-transfer-types/borsh",
+  "ibc-core-client-types/borsh",
+  "ibc-core-connection-types/borsh",
+  "ibc-core-channel-types/borsh",
+  "ibc-core-commitment-types/borsh",
+  "ibc-core-host-types/borsh",
+  "ibc-core-router-types/borsh",
+  "ibc-core-handler-types/borsh",
+  "ibc-client-tendermint-types/borsh",
+  "ibc-primitives/borsh",
 ]
 schema = [
-    "ibc-app-transfer-types/schema",
-    "ibc-core-client-types/schema",
-    "ibc-core-connection-types/schema",
-    "ibc-core-channel-types/schema",
-    "ibc-core-commitment-types/schema",
-    "ibc-core-host-types/schema",
-    "ibc-core-router-types/schema",
-    "ibc-core-handler-types/schema",
-    "ibc-client-tendermint-types/schema",
-    "ibc-client-wasm-types/schema",
-    "ibc-primitives/schema",
+  "ibc-app-transfer-types/schema",
+  "ibc-core-client-types/schema",
+  "ibc-core-connection-types/schema",
+  "ibc-core-channel-types/schema",
+  "ibc-core-commitment-types/schema",
+  "ibc-core-host-types/schema",
+  "ibc-core-router-types/schema",
+  "ibc-core-handler-types/schema",
+  "ibc-client-tendermint-types/schema",
+  "ibc-client-wasm-types/schema",
+  "ibc-primitives/schema",
 ]
 parity-scale-codec = [
-    "ibc-app-transfer-types/parity-scale-codec",
-    "ibc-core-client-types/parity-scale-codec",
-    "ibc-core-connection-types/parity-scale-codec",
-    "ibc-core-channel-types/parity-scale-codec",
-    "ibc-core-commitment-types/parity-scale-codec",
-    "ibc-core-host-types/parity-scale-codec",
-    "ibc-core-router-types/parity-scale-codec",
-    "ibc-core-handler-types/parity-scale-codec",
-    "ibc-client-tendermint-types/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-app-transfer-types/parity-scale-codec",
+  "ibc-core-client-types/parity-scale-codec",
+  "ibc-core-connection-types/parity-scale-codec",
+  "ibc-core-channel-types/parity-scale-codec",
+  "ibc-core-commitment-types/parity-scale-codec",
+  "ibc-core-host-types/parity-scale-codec",
+  "ibc-core-router-types/parity-scale-codec",
+  "ibc-core-handler-types/parity-scale-codec",
+  "ibc-client-tendermint-types/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
 cosmwasm = [
-    "ibc-client-wasm-types/cosmwasm",
+  "ibc-client-wasm-types/cosmwasm",
 ]
diff --git a/ibc-derive/Cargo.toml b/ibc-derive/Cargo.toml
index 90abcab43..cf7ce7cbf 100644
--- a/ibc-derive/Cargo.toml
+++ b/ibc-derive/Cargo.toml
@@ -11,6 +11,6 @@ description = "Maintained by `ibc-rs`, macros implementations of #[derive(Client
 proc-macro = true
 
 [dependencies]
-syn = "2"
-proc-macro2 = "1"
-quote = "1"
+syn         = { version = "2" }
+proc-macro2 = { version = "1" }
+quote       = { version = "1" }
diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index c00344252..b322e3fab 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "cosmos", "ibc"]
+keywords     = [ "blockchain", "cosmos", "ibc" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, furnishes essential types and traits universally
     utilized in the implementation of diverse IBC modules, encompassing
     core functionalities, clients, and applications.
@@ -34,35 +35,35 @@ ibc-proto = { workspace = true }
 tendermint = { workspace = true }
 
 # parity dependencies
-parity-scale-codec  = { workspace = true, optional = true }
-scale-info          = { workspace = true, optional = true }
+parity-scale-codec = { workspace = true, optional = true }
+scale-info         = { workspace = true, optional = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "displaydoc/std",
-    "prost/std",
-    "serde/std",
-    "ibc-proto/std",
-    "tendermint/std",
-    "time/std",
+  "displaydoc/std",
+  "prost/std",
+  "serde/std",
+  "ibc-proto/std",
+  "tendermint/std",
+  "time/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc-proto/json-schema",
-    "serde",
-    "std"
+  "dep:schemars",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "dep:parity-scale-codec",
-    "dep:scale-info",
-    "ibc-proto/parity-scale-codec",
+  "dep:parity-scale-codec",
+  "dep:scale-info",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-query/Cargo.toml b/ibc-query/Cargo.toml
index 7d71d7424..531629343 100644
--- a/ibc-query/Cargo.toml
+++ b/ibc-query/Cargo.toml
@@ -1,14 +1,14 @@
 [package]
-name         = "ibc-query"
-version      = { workspace = true }
-authors      = { workspace = true }
-edition      = { workspace = true }
+name = "ibc-query"
+version = { workspace = true }
+authors = { workspace = true }
+edition = { workspace = true }
 rust-version = { workspace = true }
-license      = { workspace = true }
-repository   = { workspace = true }
-readme       = "README.md"
-keywords     = ["blockchain", "cosmos", "ibc", "rpc", "grpc"]
-description  = """
+license = { workspace = true }
+repository = { workspace = true }
+readme = "README.md"
+keywords = [ "blockchain", "cosmos", "ibc", "rpc", "grpc" ]
+description = """
     Maintained by `ibc-rs`, contains essential IBC query types, utility functions and
     gRPC service implementations for the IBC core.
 """
@@ -16,30 +16,29 @@ description  = """
 [dependencies]
 # external dependencies
 displaydoc = { version = "0.2", default-features = false }
-schemars   = { workspace = true , optional = true }
+schemars   = { workspace = true, optional = true }
 serde      = { workspace = true, optional = true }
 tonic      = { version = "0.11" }
 
 # ibc dependencies
 ibc       = { workspace = true }
-ibc-proto = { workspace = true, features = ["server"] }
+ibc-proto = { workspace = true, features = [ "server" ] }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc/std",
-    "ibc-proto/std",
+  "ibc/std",
+  "ibc-proto/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc/serde",
-    "ibc-proto/serde",
+  "dep:serde",
+  "ibc/serde",
+  "ibc-proto/serde",
 ]
 schema = [
-    "dep:schemars",
-    "ibc/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std",
+  "dep:schemars",
+  "ibc/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
-
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 2d4e5bc0d..3962bbb83 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -1,14 +1,14 @@
 [package]
-name         = "ibc-testkit"
-version      = { workspace = true }
-authors      = { workspace = true }
-edition      = { workspace = true }
+name = "ibc-testkit"
+version = { workspace = true }
+authors = { workspace = true }
+edition = { workspace = true }
 rust-version = { workspace = true }
-license      = { workspace = true }
-repository   = { workspace = true }
-readme       = "README.md"
-keywords     = ["blockchain", "consensus", "cosmos", "ibc", "tendermint"]
-description  = """
+license = { workspace = true }
+repository = { workspace = true }
+readme = "README.md"
+keywords = [ "blockchain", "consensus", "cosmos", "ibc", "tendermint" ]
+description = """
     Maintained by `ibc-rs`, serves as a versatile library that provides essential abstractions
     and implementations, fulfilling a dual role of enabling rigorous integration testing for
     the `ibc-rs` implementation while also aiding host chains in addressing a broad spectrum
@@ -17,19 +17,19 @@ description  = """
 
 [dependencies]
 # external dependencies
-borsh             = { workspace = true, optional = true }
-derive_more       = { workspace = true }
-displaydoc        = { workspace = true }
-parking_lot       = { version = "0.12.1", default-features = false }
-schemars          = { workspace = true, optional = true }
-serde             = { workspace = true, optional = true }
-serde_json        = { workspace = true, optional = true }
-subtle-encoding   = { workspace = true }
-tracing           = { version = "0.1.40", default-features = false }
-typed-builder     = { version = "0.18.0" }
+borsh           = { workspace = true, optional = true }
+derive_more     = { workspace = true }
+displaydoc      = { workspace = true }
+parking_lot     = { version = "0.12.1", default-features = false }
+schemars        = { workspace = true, optional = true }
+serde           = { workspace = true, optional = true }
+serde_json      = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+tracing         = { version = "0.1.40", default-features = false }
+typed-builder   = { version = "0.18.0" }
 
 # ibc dependencies
-ibc                      = { workspace = true, features = ["std"] }
+ibc                      = { workspace = true, features = [ "std" ] }
 ibc-proto                = { workspace = true }
 ibc-client-cw            = { workspace = true }
 ibc-client-tendermint-cw = { workspace = true }
@@ -40,43 +40,43 @@ tendermint-testgen = { workspace = true }
 
 [dev-dependencies]
 env_logger         = { version = "0.11.0" }
-tracing-subscriber = { version = "0.3.17", features = ["fmt", "env-filter", "json"] }
-test-log           = { version = "0.2.13", features = ["trace"] }
+tracing-subscriber = { version = "0.3.17", features = [ "fmt", "env-filter", "json" ] }
+test-log           = { version = "0.2.13", features = [ "trace" ] }
 hex                = { version = "0.4.2" }
 rstest             = { workspace = true }
 cosmwasm-vm        = { workspace = true }
 cosmwasm-std       = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "serde/std",
-    "tracing/std",
-    "tracing-subscriber/std",
-    "serde_json/std",
-    "ibc/std",
-    "ibc-proto/std",
-    "tendermint/std",
+  "serde/std",
+  "tracing/std",
+  "tracing-subscriber/std",
+  "serde_json/std",
+  "ibc/std",
+  "ibc-proto/std",
+  "tendermint/std",
 ]
 serde = [
-    "dep:serde",
-    "ibc/serde",
-    "ibc-proto/serde",
-    "serde_json",
+  "dep:serde",
+  "ibc/serde",
+  "ibc-proto/serde",
+  "serde_json",
 ]
 schema = [
-    "dep:schemars",
-    "ibc/schema",
-    "ibc-proto/json-schema",
-    "serde",
-    "std",
+  "dep:schemars",
+  "ibc/schema",
+  "ibc-proto/json-schema",
+  "serde",
+  "std",
 ]
 borsh = [
-    "dep:borsh",
-    "ibc/borsh",
-    "ibc-proto/borsh",
+  "dep:borsh",
+  "ibc/borsh",
+  "ibc-proto/borsh",
 ]
 parity-scale-codec = [
-    "ibc/parity-scale-codec",
-    "ibc-proto/parity-scale-codec",
+  "ibc/parity-scale-codec",
+  "ibc-proto/parity-scale-codec",
 ]
diff --git a/ibc-testkit/src/fixtures/core/client/mod.rs b/ibc-testkit/src/fixtures/core/client/mod.rs
index a536d778c..6f2f3d841 100644
--- a/ibc-testkit/src/fixtures/core/client/mod.rs
+++ b/ibc-testkit/src/fixtures/core/client/mod.rs
@@ -96,14 +96,16 @@ mod tests {
             assert_eq!(t.expected_keys.len(), t.event.attributes.len());
             for (i, e) in t.event.attributes.iter().enumerate() {
                 assert_eq!(
-                    e.key, t.expected_keys[i],
+                    e.key_str().unwrap(),
+                    t.expected_keys[i],
                     "key mismatch for {:?}",
                     t.event_kind
                 );
             }
             for (i, e) in t.event.attributes.iter().enumerate() {
                 assert_eq!(
-                    e.value, t.expected_values[i],
+                    e.value_str().unwrap(),
+                    t.expected_values[i],
                     "value mismatch for {:?}",
                     t.event_kind
                 );
diff --git a/ibc/Cargo.toml b/ibc/Cargo.toml
index bc7d9c2ba..1005db2a0 100644
--- a/ibc/Cargo.toml
+++ b/ibc/Cargo.toml
@@ -6,9 +6,10 @@ edition      = { workspace = true }
 rust-version = { workspace = true }
 license      = { workspace = true }
 repository   = { workspace = true }
-keywords     = ["blockchain", "consensus", "cosmos", "ibc"]
+keywords     = [ "blockchain", "consensus", "cosmos", "ibc" ]
 readme       = "README.md"
-description  = """
+
+description = """
     Maintained by `ibc-rs`, serves as a top-level library that contain a comprehensive set of
     Inter-Blockchain Communication (IBC) implementations, re-exporting data structures and
     implementations of various IBC core, clients and applications from the `ibc-core`,
@@ -20,49 +21,49 @@ all-features = true
 
 [dependencies]
 # ibc dependencies
-ibc-apps              = { workspace = true }
-ibc-clients           = { workspace = true }
-ibc-core              = { workspace = true }
-ibc-core-host-cosmos  = { workspace = true }
-ibc-derive            = { workspace = true }
-ibc-primitives        = { workspace = true }
+ibc-apps             = { workspace = true }
+ibc-clients          = { workspace = true }
+ibc-core             = { workspace = true }
+ibc-core-host-cosmos = { workspace = true }
+ibc-derive           = { workspace = true }
+ibc-primitives       = { workspace = true }
 
 [features]
-default = ["std"]
+default = [ "std" ]
 std = [
-    "ibc-apps/std",
-    "ibc-clients/std",
-    "ibc-core/std",
-    "ibc-core-host-cosmos/std",
-    "ibc-primitives/std",
+  "ibc-apps/std",
+  "ibc-clients/std",
+  "ibc-core/std",
+  "ibc-core-host-cosmos/std",
+  "ibc-primitives/std",
 ]
 borsh = [
-    "ibc-apps/borsh",
-    "ibc-clients/borsh",
-    "ibc-core/borsh",
-    "ibc-core-host-cosmos/borsh",
-    "ibc-primitives/borsh",
+  "ibc-apps/borsh",
+  "ibc-clients/borsh",
+  "ibc-core/borsh",
+  "ibc-core-host-cosmos/borsh",
+  "ibc-primitives/borsh",
 ]
 serde = [
-    "ibc-apps/serde",
-    "ibc-clients/serde",
-    "ibc-core/serde",
-    "ibc-core-host-cosmos/serde",
-    "ibc-primitives/serde",
+  "ibc-apps/serde",
+  "ibc-clients/serde",
+  "ibc-core/serde",
+  "ibc-core-host-cosmos/serde",
+  "ibc-primitives/serde",
 ]
 schema = [
-    "ibc-apps/schema",
-    "ibc-clients/schema",
-    "ibc-core/schema",
-    "ibc-core-host-cosmos/schema",
-    "ibc-primitives/schema",
-    "serde",
-    "std"
+  "ibc-apps/schema",
+  "ibc-clients/schema",
+  "ibc-core/schema",
+  "ibc-core-host-cosmos/schema",
+  "ibc-primitives/schema",
+  "serde",
+  "std",
 ]
 parity-scale-codec = [
-    "ibc-apps/parity-scale-codec",
-    "ibc-clients/parity-scale-codec",
-    "ibc-core/parity-scale-codec",
-    "ibc-core-host-cosmos/parity-scale-codec",
-    "ibc-primitives/parity-scale-codec",
+  "ibc-apps/parity-scale-codec",
+  "ibc-clients/parity-scale-codec",
+  "ibc-core/parity-scale-codec",
+  "ibc-core-host-cosmos/parity-scale-codec",
+  "ibc-primitives/parity-scale-codec",
 ]
diff --git a/taplo.toml b/taplo.toml
new file mode 100644
index 000000000..edaa7882b
--- /dev/null
+++ b/taplo.toml
@@ -0,0 +1,7 @@
+include = [ "taplo.toml", "**/Cargo.toml" ]
+
+[formatting]
+align_entries       = true
+compact_arrays      = false
+array_auto_expand   = false
+array_auto_collapse = false

From 941f9b939ecceaaf5f13c65d500b444dfafef5ba Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 30 Apr 2024 13:01:09 -0400
Subject: [PATCH 166/182] chore(deps): update rstest requirement from 0.18.2 to
 0.19.0 (#1213)

* chore(deps): update rstest requirement from 0.18.2 to 0.19.0

Updates the requirements on [rstest](https://github.com/la10736/rstest) to permit the latest version.
- [Release notes](https://github.com/la10736/rstest/releases)
- [Changelog](https://github.com/la10736/rstest/blob/master/CHANGELOG.md)
- [Commits](https://github.com/la10736/rstest/compare/v0.18.2...v0.18.2)

---
updated-dependencies:
- dependency-name: rstest
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>

* update Cargo.toml

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

---------

Signed-off-by: dependabot[bot] <support@github.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Cargo.toml b/Cargo.toml
index 462ea8d72..184204497 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -57,7 +57,7 @@ borsh           = { version = "0.10", default-features = false }
 displaydoc      = { version = "0.2", default-features = false }
 prost           = { version = "0.12", default-features = false }
 derive_more     = { version = "0.99.17", default-features = false, features = [ "from", "into", "display", "try_into" ] }
-rstest          = { version = "0.18.2" }
+rstest          = { version = "0.19" }
 schemars        = { version = "0.8.15" }
 sha2            = { version = "0.10.8", default-features = false }
 serde           = { version = "1.0", default-features = false }

From 30a295cc959a9ac84a4ec9aa88e9fb0be2fe1c4a Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Tue, 30 Apr 2024 13:34:02 -0400
Subject: [PATCH 167/182] chore(deps): update time requirement from >=0.3.0,
 <0.3.35 to >=0.3.0, <0.3.37 (#1214)

Updates the requirements on [time](https://github.com/time-rs/time) to permit the latest version.
- [Release notes](https://github.com/time-rs/time/releases)
- [Changelog](https://github.com/time-rs/time/blob/main/CHANGELOG.md)
- [Commits](https://github.com/time-rs/time/compare/v0.3.0...v0.3.36)

---
updated-dependencies:
- dependency-name: time
  dependency-type: direct:production
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 ibc-primitives/Cargo.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ibc-primitives/Cargo.toml b/ibc-primitives/Cargo.toml
index b322e3fab..0afd83407 100644
--- a/ibc-primitives/Cargo.toml
+++ b/ibc-primitives/Cargo.toml
@@ -26,7 +26,7 @@ displaydoc  = { workspace = true }
 prost       = { workspace = true }
 schemars    = { workspace = true, optional = true }
 serde       = { workspace = true, optional = true }
-time        = { version = ">=0.3.0, <0.3.35", default-features = false }
+time        = { version = ">=0.3.0, <0.3.37", default-features = false }
 
 # ibc dependencies
 ibc-proto = { workspace = true }

From 87ec77040b31e699319bf51dc07a5d83766a9a23 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Thu, 2 May 2024 13:33:21 +0200
Subject: [PATCH 168/182] fix(ibc-core): reject packets with no timeouts in
 `send_packet_validate` (#1205)

* correct name

* add test for packet with no timeout

* ensure packet timeout is set

* rename var

* fix test compile

* packet without timeout should fail

---------

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 .../ics04-channel/src/handler/send_packet.rs  |  4 ++++
 .../src/fixtures/core/channel/packet.rs       |  8 +++----
 .../tests/core/ics04_channel/send_packet.rs   | 23 +++++++++++++++++++
 ibc-testkit/tests/core/router.rs              |  5 ++--
 4 files changed, 34 insertions(+), 6 deletions(-)

diff --git a/ibc-core/ics04-channel/src/handler/send_packet.rs b/ibc-core/ics04-channel/src/handler/send_packet.rs
index f1c6c29b5..895ad9457 100644
--- a/ibc-core/ics04-channel/src/handler/send_packet.rs
+++ b/ibc-core/ics04-channel/src/handler/send_packet.rs
@@ -30,6 +30,10 @@ pub fn send_packet_validate(
     ctx_a: &impl SendPacketValidationContext,
     packet: &Packet,
 ) -> Result<(), ContextError> {
+    if !packet.timeout_height_on_b.is_set() && !packet.timeout_timestamp_on_b.is_set() {
+        return Err(ContextError::PacketError(PacketError::MissingTimeout));
+    }
+
     let chan_end_path_on_a = ChannelEndPath::new(&packet.port_id_on_a, &packet.chan_id_on_a);
     let chan_end_on_a = ctx_a.channel_end(&chan_end_path_on_a)?;
 
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
index b33e1b2a4..a4e0ca36e 100644
--- a/ibc-testkit/src/fixtures/core/channel/packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -84,7 +84,7 @@ mod tests {
 
         let proof_height = 10;
         let default_raw_packet = dummy_raw_packet(proof_height, 1000);
-        let raw_packet_no_timeout_or_timestamp = dummy_raw_packet(10, 0);
+        let raw_packet_no_timeout_timestamp = dummy_raw_packet(10, 0);
 
         let mut raw_packet_invalid_timeout_height = dummy_raw_packet(0, 10);
         raw_packet_invalid_timeout_height.timeout_height = Some(RawHeight {
@@ -101,8 +101,8 @@ mod tests {
             Test {
                 // Note: ibc-go currently (July 2022) incorrectly rejects this
                 // case, even though it is allowed in ICS-4.
-                name: "Packet with no timeout of timestamp".to_string(),
-                raw: raw_packet_no_timeout_or_timestamp.clone(),
+                name: "Packet with no timeout timestamp".to_string(),
+                raw: raw_packet_no_timeout_timestamp.clone(),
                 want_pass: true,
             },
             Test {
@@ -225,7 +225,7 @@ mod tests {
                 name: "Missing both timeout height and timestamp".to_string(),
                 raw: RawPacket {
                     timeout_height: None,
-                    ..raw_packet_no_timeout_or_timestamp
+                    ..raw_packet_no_timeout_timestamp
                 },
                 want_pass: false,
             }
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index acd58417a..15d3c82f4 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -4,6 +4,7 @@ use core::time::Duration;
 use ibc::core::channel::handler::send_packet;
 use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State};
 use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::timeout::TimeoutHeight;
 use ibc::core::channel::types::Version;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
@@ -84,6 +85,13 @@ fn send_packet_processing() {
 
     let client_height = Height::new(0, client_raw_height).unwrap();
 
+    let packet_with_no_timeout: Packet = {
+        let mut packet: Packet = dummy_raw_packet(10, 10).try_into().unwrap();
+        packet.timeout_height_on_b = TimeoutHeight::no_timeout();
+        packet.timeout_timestamp_on_b = Timestamp::none();
+        packet
+    };
+
     let tests: Vec<Test> = vec![
         Test {
             name: "Processing fails because no channel exists in the context".to_string(),
@@ -136,6 +144,21 @@ fn send_packet_processing() {
             packet: packet_timeout_one_before_client_height,
             want_pass: false,
         },
+        Test {
+            name: "Packet without height and timestamp timeout".to_string(),
+            ctx: context
+                .clone()
+                .with_client_config(
+                    MockClientConfig::builder()
+                        .latest_height(client_height)
+                        .build(),
+                )
+                .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
+                .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
+                .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into()),
+            packet: packet_with_no_timeout,
+            want_pass: false,
+        },
         Test {
             name: "Packet timeout due to timestamp".to_string(),
             ctx: context
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index a946222ae..0c00926c6 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -157,6 +157,7 @@ fn routing_module_and_keepers() {
 
     let msg_transfer_no_timeout_or_timestamp = MsgTransferConfig::builder()
         .packet_data(packet_data.clone())
+        // Timestamp::from_nanoseconds(0) and Timestamp::none() are equivalent
         .timeout_timestamp_on_b(Timestamp::from_nanoseconds(0).unwrap())
         .build();
 
@@ -348,13 +349,13 @@ fn routing_module_and_keepers() {
         Test {
             name: "Transfer message no timeout".to_string(),
             msg: msg_transfer_no_timeout.into(),
-            want_pass: true,
+            want_pass: false,
             state_check: None,
         },
         Test {
             name: "Transfer message no timeout nor timestamp".to_string(),
             msg: msg_transfer_no_timeout_or_timestamp.into(),
-            want_pass: true,
+            want_pass: false,
             state_check: None,
         },
         //ICS04-close channel

From 534a4655285e1e9f36d0cc48bca17e840e64a778 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 3 May 2024 18:24:58 +0200
Subject: [PATCH 169/182] imp(ibc-testkit): revamp mock testing framework
 (#1109)

* imp(testkit): Mock IBC context with `basecoin-store` types  (#1068)

* non empty default CommitmentPrefix

* update ibc mock client types

* fix tests for updated mock types

* generalize MockContextConfig::into

* rm clone from MockContext

* add with_{client,consensus}_state

* add blocks_since in utils.rs

* client takes host timestamp by default

* refactor relayer context test

* fix few tests

* add ibc-query and basecoin-store deps

* add basecoin-store in mock ibc context

* refactor for updated mock ibc context

* imp timeout test

* public git commit as dep source

* fix spelling

* update MockClient types

* fix failing tests

* rm unused utils and deps

* fix cargo doc lint

* use ibc host paths in mock context

* rm redundant curly brackets

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* imp(ibc-testkit): generalize `Host` for `MockContext` (#1107)

* fix semantic conflict

* happy clippy

* fix next_consensus_state impl

* update prev_consensus_state impl

* use self.block_time over const

* use constant timestamp over dynamic now

* add new host impls

* changes to ibc-testkit

* rm deprecated methods

* refactor tests

* public fields for tm block params

* forged client header update test

* add todo comment

* minor refactor

* refactor tests

* builder type for light client state

* minor refactor

* refactor tests

* code opt

* rename host structs

* renamings

* refactor tendermint host

* mv year_2023 to utils

* refactor the new tests

* test malicious adjacent header update

* fix tests

* add changelog

* rm unused chain_revision_number

* add doc string for year_2023

* rename to query_latest_block

* feat(ibc-testkit): revamp `MockContext` with chain capabilities (#1135)

* imp: impl ctxs on MockIbcStore

* fix: set update_meta whenever build light client

* imp: generate_client_state should take latest_height

* imp: remove unnecessary latest_client_states method

* refactor: migrate host relevant fields/methods

* fix: get back validate_self_client

* imp: bring context types up under src

* rm default for CommitmentPrefix

* rm default height and timestamp impl for TestBlock

* default MockStore

* AnyClient and AnyConsensus state in MockIbcStore

* at least one consensus state when bootstrapping light client

* revision number in MockIbcStore

* advance height in MockIbcStore

* sync host and ibc store advance in conext

* add host params to build host

* update host trait

* convenient type generics for host associated types

* update MockHost

* return existing block header with correct timestamp

* update TendermintHost

* update MockGenericContext impl

* update mock context building

* add implied trait bounds

* refactor method

* rm redundant imports and impl

* call advance_block on context

* update MockContext tests

* rm ClientStateCommon

* use HostParams to build a host

* rm using max_history_size

* update few tests

* ignore failing tests

* clippy::use_self

* clippy::flat_map_option

* clippy::cloned_instead_of_copied

* clippy::redundant_clone

* clippy::redundant_type_annotations

* clippy::as_underscore

* disable slow testcase

* prune old host consensus state

* prune host consensus history in fixture

* enable ignored test

* return client_id in fixture

* fix and enable failing test

* avoid Arc and Mutex

* fix doc build

* refactor host trait and impls

* into over Self::from

* fix msrv

* explicit relative or global path for pub use

* clippy::map_identity

* clippy::inconsistent_struct_constructor

* clippy::std_instead_of_core

* use commitment_root for block generation

* rename consensus_states to host_consensus_states

* use basecoin proof specs

* update tests

* imp: add history() under TestHost

* chore: add docstring for some of methods under TestHost

* update TestHost trait

* update MockHost and TendermintHost

* add MockGenericContext::generate_genesis_block

* update MockContextConfig

* update tests

* update remaining tests

* rm comments and rename test

* rm HostParams

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* imp(ibc-testkit): Tendermint proof verifications via integration test (#1146)

* test tmclient proof verification

* use ClientStateConfig directly

* rm MockClientConfig

* use basecoin store proofspec as default

* update tests

* use merkle storage in MockContext

* fix ProofSpecs size

* refactor MockIbcStore to perform begin_block and end_block

* simpler proof verification test

* use ValidationContext::commitment_prefix()

* nits

* refactor host related trait method

* tendermint host client integration test with proof verification

* rm raw test

* use typed relayer

* add todo for channel integration test

* core over std

* be semantically correct

* add comment for TypedRelayer

* integration test for all pairs

* fix semantic bug

* renames

* add channel management

* channel creation in RelayerContext

* add channel creation in integration test

* add test for channel close

* query client_id from connection and channel

* ibc_store_mut

* utils functions for packet relay

* add packet relay integration test

* add comments

* optimize integration utils functions

* serde feature for integration tests

* rm redundant chain_id

* sync clock only on a

* add comment

* imp: place router under MockGenericContext

* nit: add docstring for router

* nits

* rm redundant lint filters

* imp: ditch RelayerContext

* nit: simplify build_client_update_datagram

* refactor integration tests

* add doc strings for TypedRelayerOps

* doc strings for RelayerContext

* mv client_update_ping_pong to tests dir

* rename main_store to multi_store

* update TestHost trait

* update mock and tendermint hosts

* update relayer functions

* nits

* renames and comments

* add comments for return values in relayer ops

* imp: simplify into_header

---------

Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>

* rm prune_block_till

* apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* rename context structs

* add MockContext and TendermintContext

* update with MockContext and TendermintContext

* MockContextConfig to TestContextConfig

* update comments with new namings

* add util methods for StoreGenericTestContext

* fix failing client recovery tests

* increase default trusting period of MockClientState

* fallible ProofSpecs conversion

* update with new ClientStateConfig

* use ExtClientValidationContext

* fix links in doc comments

* fix import order

* fix semantic conflicts

* Convertible over ConsensusStateConverter

* rm ConsensusStateConverter

* ibc-query as workspace deps

* update Convertible

* fix failing test

* update changelog entry

* add comments

* rm absolute import

* use expect over comment for safety

* infallible try_into

* update method names

* add unused variable names

* rm redundant TendermintBlock wrapper type

* add comments

* update docstrings

* rm should never fail comment

* update adr

* fix compilation

* fix failing test

* docs: ADR-009 to revamp testing framework (#1157)

* draft adr 009

* update adr-009

* apply suggestions from pr review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* use numbers list for sub-proposal titles

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* links to validation and execute context

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* apply suggestion from pr review

* add links to impls

* update comment

* markdown format

* update adr

* use TestContext

* update comment

* apply suggestions from code review

Co-authored-by: Sean Chen <seanchen11235@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

* markdown format

* update method names

* fix cargo doc error

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Signed-off-by: Rano | Ranadeep <ranadeep@informal.systems>
Co-authored-by: Farhad Shabani <farhad.shabani@gmail.com>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 .../improvements/1044-introduce-host-trait.md |    3 +
 Cargo.toml                                    |    1 +
 .../architecture/adr-005-handlers-redesign.md |    3 -
 docs/architecture/adr-009-revamp-testkit.md   |  349 +++++
 ibc-core/ics24-host/src/context.rs            |    3 -
 ibc-testkit/Cargo.toml                        |    4 +
 ibc-testkit/src/context.rs                    |  612 ++++++++
 .../src/fixtures/applications/transfer.rs     |    4 +-
 .../src/fixtures/clients/tendermint.rs        |   53 +-
 ibc-testkit/src/fixtures/core/channel/mod.rs  |   23 +-
 .../src/fixtures/core/channel/packet.rs       |    2 +-
 ibc-testkit/src/fixtures/core/client/mod.rs   |    6 +-
 .../src/fixtures/core/connection/mod.rs       |    9 +-
 ibc-testkit/src/fixtures/core/context.rs      |  161 +--
 ibc-testkit/src/fixtures/mod.rs               |    6 +-
 ibc-testkit/src/hosts/block.rs                |  260 ----
 ibc-testkit/src/hosts/mock.rs                 |   97 ++
 ibc-testkit/src/hosts/mod.rs                  |  158 ++-
 ibc-testkit/src/hosts/tendermint.rs           |  240 ++++
 ibc-testkit/src/lib.rs                        |    2 +
 ibc-testkit/src/relayer/context.rs            |  568 +++++---
 ibc-testkit/src/relayer/integration.rs        |  170 +++
 ibc-testkit/src/relayer/mod.rs                |    5 +
 ibc-testkit/src/relayer/utils.rs              | 1001 +++++++++++++
 .../testapp/ibc/clients/mock/client_state.rs  |   44 +-
 .../ibc/clients/mock/consensus_state.rs       |   17 +-
 .../src/testapp/ibc/clients/mock/header.rs    |   20 +-
 .../testapp/ibc/clients/mock/misbehaviour.rs  |    4 +-
 ibc-testkit/src/testapp/ibc/clients/mod.rs    |   32 +-
 .../src/testapp/ibc/core/client_ctx.rs        |  362 ++---
 ibc-testkit/src/testapp/ibc/core/core_ctx.rs  |  869 ++++++++----
 .../src/testapp/ibc/core/router/mod.rs        |    2 +-
 .../src/testapp/ibc/core/router/types.rs      |    2 +-
 ibc-testkit/src/testapp/ibc/core/types.rs     | 1086 +++------------
 ibc-testkit/src/utils/mod.rs                  |   17 +
 .../tests/core/ics02_client/create_client.rs  |  108 +-
 .../tests/core/ics02_client/recover_client.rs |  208 ++-
 .../tests/core/ics02_client/update_client.rs  | 1240 ++++++++++++-----
 .../tests/core/ics02_client/upgrade_client.rs |   25 +-
 .../core/ics03_connection/conn_open_ack.rs    |   76 +-
 .../ics03_connection/conn_open_confirm.rs     |   44 +-
 .../core/ics03_connection/conn_open_init.rs   |   26 +-
 .../core/ics03_connection/conn_open_try.rs    |   44 +-
 .../core/ics04_channel/acknowledgement.rs     |   54 +-
 .../core/ics04_channel/chan_close_confirm.rs  |   32 +-
 .../core/ics04_channel/chan_close_init.rs     |   32 +-
 .../tests/core/ics04_channel/chan_open_ack.rs |   56 +-
 .../core/ics04_channel/chan_open_confirm.rs   |   44 +-
 .../core/ics04_channel/chan_open_init.rs      |   22 +-
 .../tests/core/ics04_channel/chan_open_try.rs |   30 +-
 .../tests/core/ics04_channel/recv_packet.rs   |   57 +-
 .../tests/core/ics04_channel/send_packet.rs   |   67 +-
 .../tests/core/ics04_channel/timeout.rs       |  113 +-
 .../core/ics04_channel/timeout_on_close.rs    |   37 +-
 ibc-testkit/tests/core/router.rs              |   43 +-
 ibc-testkit/tests/cosmwasm/fixture.rs         |    4 +-
 56 files changed, 5717 insertions(+), 2840 deletions(-)
 create mode 100644 .changelog/unreleased/improvements/1044-introduce-host-trait.md
 create mode 100644 docs/architecture/adr-009-revamp-testkit.md
 create mode 100644 ibc-testkit/src/context.rs
 delete mode 100644 ibc-testkit/src/hosts/block.rs
 create mode 100644 ibc-testkit/src/hosts/mock.rs
 create mode 100644 ibc-testkit/src/hosts/tendermint.rs
 create mode 100644 ibc-testkit/src/relayer/integration.rs
 create mode 100644 ibc-testkit/src/relayer/utils.rs
 create mode 100644 ibc-testkit/src/utils/mod.rs

diff --git a/.changelog/unreleased/improvements/1044-introduce-host-trait.md b/.changelog/unreleased/improvements/1044-introduce-host-trait.md
new file mode 100644
index 000000000..d8b95983e
--- /dev/null
+++ b/.changelog/unreleased/improvements/1044-introduce-host-trait.md
@@ -0,0 +1,3 @@
+- [ibc-testkit] Replace `HostBlock` and `HostType` enums with a `Host` trait to
+  eliminate manual delegations by utilizing monomorphization.
+  ([\#1044](https://github.com/cosmos/ibc-rs/issues/1044))
diff --git a/Cargo.toml b/Cargo.toml
index 184204497..c879eca85 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -80,6 +80,7 @@ ibc-core-channel    = { version = "0.52.0", path = "./ibc-core/ics04-channel", d
 ibc-core-host       = { version = "0.52.0", path = "./ibc-core/ics24-host", default-features = false }
 ibc-core-handler    = { version = "0.52.0", path = "./ibc-core/ics25-handler", default-features = false }
 ibc-core-router     = { version = "0.52.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-query           = { version = "0.52.0", path = "./ibc-query", default-features = false }
 
 ibc-client-cw            = { version = "0.52.0", path = "./ibc-clients/cw-context", default-features = false }
 ibc-client-tendermint    = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
diff --git a/docs/architecture/adr-005-handlers-redesign.md b/docs/architecture/adr-005-handlers-redesign.md
index 855a2b668..e808f2892 100644
--- a/docs/architecture/adr-005-handlers-redesign.md
+++ b/docs/architecture/adr-005-handlers-redesign.md
@@ -421,7 +421,6 @@ trait ExecutionContext {
 
     /// Called upon client creation.
     /// Increases the counter which keeps track of how many clients have been created.
-    /// Should never fail.
     fn increase_client_counter(&mut self);
 
     /// Called upon successful client update.
@@ -452,7 +451,6 @@ trait ExecutionContext {
 
     /// Called upon connection identifier creation (Init or Try process).
     /// Increases the counter which keeps track of how many connections have been created.
-    /// Should never fail.
     fn increase_connection_counter(&mut self);
 
     fn store_packet_commitment(
@@ -514,7 +512,6 @@ trait ExecutionContext {
 
     /// Called upon channel identifier creation (Init or Try message processing).
     /// Increases the counter which keeps track of how many channels have been created.
-    /// Should never fail.
     fn increase_channel_counter(&mut self);
 
     /// Ibc events
diff --git a/docs/architecture/adr-009-revamp-testkit.md b/docs/architecture/adr-009-revamp-testkit.md
new file mode 100644
index 000000000..8bf5af3e2
--- /dev/null
+++ b/docs/architecture/adr-009-revamp-testkit.md
@@ -0,0 +1,349 @@
+# ADR 009: Revamp IBC integration test framework
+
+## Changelog
+
+- 04-03-2024: Initial draft
+
+## Context
+
+The current framework in the IBC testkit uses
+[existing types and injects state and/or dependencies
+manually](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/tests/core/ics02_client/update_client.rs#L574-L578).
+Sometimes, it uses
+[semantically incorrect data as mock data](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/testapp/ibc/core/types.rs#L320).
+Because of this, tests with customizable steps and fixed fixtures became ad-hoc
+and unmaintainable.
+
+To overcome this, we need to improve our test framework such that it allows:
+
+- testing different implementations and traits.
+- composition of succinct tests with useful `util` methods.
+- validating code paths that were not easily testable before, i.e. Merkle proof
+  generation.
+- simulating a more realistic IBC workflow, using real IBC and relayer
+  interfaces.
+
+## Decision
+
+The main goal of this proposal is to create a test framework that is modular and
+closer to a real blockchain environment. This should also make the existing
+tests more succinct and readable. Instead of bootstrapping the mock data that
+tests use, we should use valid steps to generate it - so that we know the exact
+steps to reach a state to reproduce in a real environment.
+
+To achieve this, we have broken down the proposal into sub-proposals:
+
+### 1. Adopt a Merkle store for the test framework
+
+The current framework uses `HashMap` and `HashSet` to store data. This works for
+many test scenarios, but it fails to test proof-sensitive scenarios. Because of
+this, we don't have any connection, channel handshake, or packet relay tests
+that cover the Tendermint light client.
+
+We generalize
+[`MockContext`](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/testapp/ibc/core/types.rs#L103)
+to use a Merkle store which is used for IBC Context's store. For concrete or
+default implementations, we can use the IAVL Merkle store implementation from
+`informalsystems/basecoin-rs`.
+
+### 2. Modularize the host environment
+
+Currently, we are using `Mock` and `SyntheticTendermint` variants of the
+[`HostType`](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/hosts/block.rs#L33-L36)
+enum as host environments. To manage these two different environments, we also
+introduced
+[`HostBlocks`](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/hosts/block.rs#L72-75)
+for encapsulating the possible host variants that need to be covered by
+`ibc-testkit`.
+
+However, this creates friction in the case when we need to add new host
+variants. It creates the same problem that the `ibc-derive` crate was designed
+to solve for `ClientState` and `ConsensusState` types, namely: dispatching
+methods to underlying variants of a top-level enum. But, a concrete
+`MockContext` will always have a unique `HostType` and its corresponding
+`HostBlocks`. So we can refactor `HostTypes` and `HockBlocks` with a generic
+`TestHost` trait that maintains its corresponding types e.g. `Block` types, via
+associated types. Finally, we generalize the `MockContext` once more to use this
+`TestHost` trait instead of a concrete enum variant.
+
+This `TestHost` trait should be responsible for generating blocks, headers,
+client, and consensus states specific to that host environment.
+
+```rs
+/// TestHost is a trait that defines the interface for a host blockchain.
+pub trait TestHost: Default + Debug + Sized {
+    /// The type of block produced by the host.
+    type Block: TestBlock;
+
+    /// The type of client state produced by the host.
+    type ClientState: Into<AnyClientState> + Debug;
+
+    /// The type of block parameters to produce a block.
+    type BlockParams: Debug + Default;
+
+    /// The type of light client parameters to produce a light client state.
+    type LightClientParams: Debug + Default;
+
+    /// The history of blocks produced by the host chain.
+    fn history(&self) -> &Vec<Self::Block>;
+
+    /// Commit a block with commitment root to the blockchain, by extending the history of blocks.
+    fn commit_block(
+        &mut self,
+        commitment_root: Vec<u8>,
+        block_time: Duration,
+        params: &Self::BlockParams,
+    );
+
+    /// Generate a block at the given height and timestamp, using the provided parameters.
+    fn generate_block(
+        &self,
+        commitment_root: Vec<u8>,
+        height: u64,
+        timestamp: Timestamp,
+        params: &Self::BlockParams,
+    ) -> Self::Block;
+
+    /// Generate a client state using the block at the given height and the provided parameters.
+    fn generate_client_state(
+        &self,
+        latest_height: &Height,
+        params: &Self::LightClientParams,
+    ) -> Self::ClientState;
+}
+
+/// TestBlock is a trait that defines the interface for a block produced by a host blockchain.
+pub trait TestBlock: Clone + Debug {
+    /// The type of header that can be extracted from the block.
+    type Header: TestHeader;
+
+    /// The height of the block.
+    fn height(&self) -> Height;
+
+    /// The timestamp of the block.
+    fn timestamp(&self) -> Timestamp;
+
+    /// Extract the header from the block.
+    fn into_header(self) -> Self::Header;
+}
+
+/// TestHeader is a trait that defines the interface for a header
+/// submitted by relayer from the host blockchain.
+pub trait TestHeader: Clone + Debug + Into<Any> {
+    /// The type of consensus state can be extracted from the header.
+    type ConsensusState: ConsensusState + Into<AnyConsensusState> + From<Self> + Clone + Debug;
+
+    /// The height of the block, as recorded in the header.
+    fn height(&self) -> Height;
+
+    /// The timestamp of the block, as recorded in the header.
+    fn timestamp(&self) -> Timestamp;
+
+    /// Extract the consensus state from the header.
+    fn into_consensus_state(self) -> Self::ConsensusState;
+}
+```
+
+### 3. Decoupling IbcContext and Host environment
+
+Currently, `MockContext` implements the top-level
+[validation](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-core/ics25-handler/src/entrypoint.rs#L45)
+and
+[execution](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-core/ics25-handler/src/entrypoint.rs#L112)
+contexts of `ibc-rs`, as opposed to the more granular contexts of each of the
+individual handlers. It contains other host-specific data e.g. `host_chain_id`,
+`block_time` - that are not directly relevant to the IBC context. If we think of
+`MockContext` as a real blockchain context, the `MockContext` represents the
+top-level runtime; it contains `MockIbcStore`, which is a more appropriate
+candidate to implement the validation and execution contexts for than the
+`MockContext` itself.
+
+With this, the `MockContext` contains two decoupled parts - the host and the IBC
+module.
+
+### 4. Chain-like interface for `MockContext`
+
+With the above changes, we can refactor the `MockContext` to have
+blockchain-like interfaces.
+
+The `MockContext` should have `end_block`, `produce_block`, and `begin_block` to
+mimic real blockchain environments, such as the Cosmos-SDK.
+
+```rs
+impl<S, H> MockContext<S, H>
+where
+    S: ProvableStore + Debug,
+    H: TestHost,
+{
+    // Access ibc module store
+    pub fn ibc_store_mut(&mut self) -> &mut MockIbcStore<S>;
+
+    // Advance the first block height.
+    pub fn advance_genesis_height(&mut self, genesis_time: Timestamp);
+    // Routine procedures at the beginning of a block
+    // Just after committing last block state.
+    pub fn begin_block(&mut self);
+    // Advance the current block height.
+    pub fn advance_block_height(&mut self, block_time: Duration);
+    // Routine procedures at the end of a block
+    // Just before committing current block state.
+    pub fn end_block(&mut self);
+}
+```
+
+### 5. ICS23 compatible proof generation
+
+With the new proof generation capabilities, we can now test the Tendermint light
+clients. But we need our proofs to be ICS23 compatible. ICS23 expects the IBC
+store root to be committed at a commitment prefix at a top-level store in the
+host environment.
+
+For this, we add an extra store in `MockContext` where the `MockIbcStore`
+commits its storage root at its
+[commitment prefix](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/testapp/ibc/core/core_ctx.rs#L127-L129)
+key.
+
+So the `MockContext` is finalized as:
+
+```rs
+pub struct MockContext<S, H>
+where
+    S: ProvableStore + Debug,
+    H: TestHost
+{
+    pub main_store: S,
+    pub host: H,
+    pub ibc_store: MockIbcStore<S>,
+}
+```
+
+Now the `MockIbcStore` can generate proofs that contain the proofs in its store
+and commitment prefix. But it has to know the proofs of its commitment prefix of
+the previous heights.
+
+So we add an extra store in `MockIbcStore` to store the proofs from previous
+heights. This is similar to storing `HostConsensusState`s of previous heights.
+
+```rs
+#[derive(Debug)]
+pub struct MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
+    ...
+    /// Map of host consensus states.
+    pub host_consensus_states: Arc<Mutex<BTreeMap<u64, AnyConsensusState>>>,
+    /// Map of proofs of ibc commitment prefix.
+    pub ibc_commiment_proofs: Arc<Mutex<BTreeMap<u64, CommitmentProof>>>,
+}
+```
+
+The storing of the IBC store root at the IBC commitment prefix happens in the
+`end_block` procedure. `produce_block` commits the main store, produces a block
+with its latest root, and pushes the block to the blockchain. The storing of
+proofs and host consensus states happens in the `begin_block` of the
+`MockContext`.
+
+### 6. Integration Tests via `RelayerContext`
+
+With all the above changes, we can now write an integration test that tests the
+IBC workflow - client creation, connection handshake, channel handshake, and
+packet relaying for any host environment that implements `TestHost`.
+
+This can be done by reading the
+[IBC events](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/testapp/ibc/core/types.rs#L95)
+from `MockIbcStore` and creating and sending the IBC messages via
+[`MockContext::deliver`](https://github.com/cosmos/ibc-rs/blob/v0.51.0/ibc-testkit/src/testapp/ibc/core/types.rs#L696).
+
+### Miscellaneous
+
+To achieve blockchain-like interfaces, we removed `max_history_size` and
+`host_chain_id` from `MockContext`.
+
+- `max_history_size`: We generate all the blocks till a block height. This gives
+  us reproducibility. If we need to prune some older block data, we use a
+  dedicated `prune_block_till` to prune older blocks. This makes our tests more
+  descriptive about the assumption of the test scenarios.
+- `host_chain_id`: The IBC runtime does not depend on `host_chain_id` directly.
+  The `TestHost` trait implementation is responsible for generating the blocks
+  with the necessary data.
+
+Also to minimize verbosity while writing tests (as Rust doesn't support default
+arguments to function parameters), we want to use some parameter builders. For
+that, we can use the [`TypedBuilder`](https://crates.io/crates/typed-builder)
+crate.
+
+## Status
+
+Proposed
+
+## Consequences
+
+This ADR pays the technical debt of the existing testing framework.
+
+### Positive
+
+Future tests will be more readable and maintainable. The test framework becomes
+modular and leverages Rust's trait system. `ibc-rs` users may benefit from this
+framework, which allows them to test their host implementations of `ibc-rs`
+components.
+
+### Negative
+
+This requires a significant refactoring of the existing tests. Since this may
+take some time, the parallel development on the `main` branch may conflict with
+this work.
+
+## References
+
+This work is being tracked at
+[cosmos/ibc-rs#1109](https://github.com/cosmos/ibc-rs/pull/1109).
+
+The following provides the concrete implementations of the proposed changes:
+
+#### MockIbcStore
+
+The modified `MockIbcStore` with Merkle store lives at
+[`testapp/ibc/core/types.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/testapp/ibc/core/types.rs#L43-L96).
+
+#### TestHost
+
+The Rust trait lives at
+[`hosts/mod.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/mod.rs#L27).
+The `Mock` and `Tendermint` host implementations live in
+[`hosts/mock.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/mock.rs#L30)
+and
+[`hosts/tendermint.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/tendermint.rs#L42)
+respectively.
+
+#### Renaming `MockContext` to `StoreGenericTestContext`
+
+There was confusion about what is a _Test_ component and what is a _Mock_
+component. We have `MockContext` with `MockClient` and `TendermintClient`.
+
+To avoid this confusion, we renamed `MockContext` to `StoreGenericTestContext`.
+This means that going forward all our general frameworks and traits should have
+`Test` in their name. But a dummy concrete implementation of these traits may
+have `Mock` in their name.
+
+#### StoreGenericTestContext
+
+[`StoreGenericTestContext`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/context.rs#L34-L52)
+is actually what is described as `MockContext` in the ADR. For convenience, we
+defined `TestContext` to have a concrete store implementation -
+[`MockStore`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/context.rs#L55-L56).
+
+```rs
+// A mock store type using basecoin-storage implementations.
+pub type MockStore = RevertibleStore<GrowingStore<InMemoryStore>>;
+
+pub type TestContext<H> = StoreGenericTestContext<MockStore, H>;
+```
+
+With this, we can now define `MockContext` which uses `MockStore` and `MockHost`
+and `TendermintContext` which uses `MockStore` and `TendermintHost`.
+
+```rs
+pub type MockContext = TestContext<MockHost>;
+pub type TendermintContext = TestContext<TendermintHost>;
+```
diff --git a/ibc-core/ics24-host/src/context.rs b/ibc-core/ics24-host/src/context.rs
index b390d6b83..612768a32 100644
--- a/ibc-core/ics24-host/src/context.rs
+++ b/ibc-core/ics24-host/src/context.rs
@@ -151,7 +151,6 @@ pub trait ExecutionContext: ValidationContext {
 
     /// Called upon client creation.
     /// Increases the counter which keeps track of how many clients have been created.
-    /// Should never fail.
     fn increase_client_counter(&mut self) -> Result<(), ContextError>;
 
     /// Stores the given connection_end at path
@@ -170,7 +169,6 @@ pub trait ExecutionContext: ValidationContext {
 
     /// Called upon connection identifier creation (Init or Try process).
     /// Increases the counter which keeps track of how many connections have been created.
-    /// Should never fail.
     fn increase_connection_counter(&mut self) -> Result<(), ContextError>;
 
     /// Stores the given packet commitment at the given store path
@@ -233,7 +231,6 @@ pub trait ExecutionContext: ValidationContext {
 
     /// Called upon channel identifier creation (Init or Try message processing).
     /// Increases the counter which keeps track of how many channels have been created.
-    /// Should never fail.
     fn increase_channel_counter(&mut self) -> Result<(), ContextError>;
 
     /// Emit the given IBC event
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 3962bbb83..0ab0ed09e 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -33,6 +33,10 @@ ibc                      = { workspace = true, features = [ "std" ] }
 ibc-proto                = { workspace = true }
 ibc-client-cw            = { workspace = true }
 ibc-client-tendermint-cw = { workspace = true }
+ibc-query                = { workspace = true }
+
+# basecoin dependencies
+basecoin-store = { git = "https://github.com/informalsystems/basecoin-rs", rev = "8496b3f" }
 
 # cosmos dependencies
 tendermint         = { workspace = true }
diff --git a/ibc-testkit/src/context.rs b/ibc-testkit/src/context.rs
new file mode 100644
index 000000000..74d141f2e
--- /dev/null
+++ b/ibc-testkit/src/context.rs
@@ -0,0 +1,612 @@
+use core::fmt::Debug;
+use core::time::Duration;
+
+use basecoin_store::context::ProvableStore;
+use basecoin_store::impls::{GrowingStore, InMemoryStore, RevertibleStore};
+use ibc::core::channel::types::channel::ChannelEnd;
+use ibc::core::channel::types::commitment::PacketCommitment;
+use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::client::context::{ClientExecutionContext, ClientValidationContext};
+use ibc::core::client::types::Height;
+use ibc::core::connection::types::ConnectionEnd;
+use ibc::core::entrypoint::{dispatch, execute, validate};
+use ibc::core::handler::types::error::ContextError;
+use ibc::core::handler::types::events::IbcEvent;
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId, Sequence};
+use ibc::core::host::types::path::{
+    ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath, ConnectionPath,
+    SeqAckPath, SeqRecvPath, SeqSendPath,
+};
+use ibc::core::host::{ExecutionContext, ValidationContext};
+use ibc::primitives::prelude::*;
+use ibc::primitives::Timestamp;
+
+use super::testapp::ibc::core::types::{LightClientState, MockIbcStore};
+use crate::fixtures::core::context::TestContextConfig;
+use crate::hosts::{HostClientState, MockHost, TendermintHost, TestBlock, TestHeader, TestHost};
+use crate::relayer::error::RelayerError;
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+use crate::testapp::ibc::core::router::MockRouter;
+use crate::testapp::ibc::core::types::DEFAULT_BLOCK_TIME_SECS;
+
+/// A context implementing the dependencies necessary for testing any IBC module.
+#[derive(Debug)]
+pub struct StoreGenericTestContext<S, H>
+where
+    S: ProvableStore + Debug,
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<MockIbcStore<S>>,
+{
+    /// The multi store of the context.
+    /// This is where the IBC store root is stored at IBC commitment prefix.
+    pub multi_store: S,
+
+    /// The type of host chain underlying this mock context.
+    pub host: H,
+
+    /// An object that stores all IBC related data.
+    pub ibc_store: MockIbcStore<S>,
+
+    /// A router that can route messages to the appropriate IBC application.
+    pub ibc_router: MockRouter,
+}
+
+/// A mock store type using basecoin-storage implementations.
+pub type MockStore = RevertibleStore<GrowingStore<InMemoryStore>>;
+/// A [`StoreGenericTestContext`] using [`MockStore`].
+pub type TestContext<H> = StoreGenericTestContext<MockStore, H>;
+/// A [`StoreGenericTestContext`] using [`MockStore`] and [`MockHost`].
+pub type MockContext = TestContext<MockHost>;
+/// A [`StoreGenericTestContext`] using [`MockStore`] and [`TendermintHost`].
+pub type TendermintContext = TestContext<TendermintHost>;
+
+/// Returns a [`StoreGenericTestContext`] with bare minimum initialization: no clients, no connections, and no channels are
+/// present, and the chain has Height(5). This should be used sparingly, mostly for testing the
+/// creation of new domain objects.
+impl<S, H> Default for StoreGenericTestContext<S, H>
+where
+    S: ProvableStore + Debug + Default,
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<MockIbcStore<S>>,
+{
+    fn default() -> Self {
+        TestContextConfig::builder().build()
+    }
+}
+
+/// Implementation of internal interface for use in testing. The methods in this interface should
+/// _not_ be accessible to any ICS handler.
+impl<S, H> StoreGenericTestContext<S, H>
+where
+    S: ProvableStore + Debug,
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<MockIbcStore<S>>,
+{
+    /// Returns a immutable reference to the IBC store.
+    pub fn ibc_store(&self) -> &MockIbcStore<S> {
+        &self.ibc_store
+    }
+
+    /// Returns a mutable reference to the IBC store.
+    pub fn ibc_store_mut(&mut self) -> &mut MockIbcStore<S> {
+        &mut self.ibc_store
+    }
+
+    /// Returns a immutable reference to the IBC router.
+    pub fn ibc_router(&self) -> &MockRouter {
+        &self.ibc_router
+    }
+
+    /// Returns a mutable reference to the IBC router.
+    pub fn ibc_router_mut(&mut self) -> &mut MockRouter {
+        &mut self.ibc_router
+    }
+
+    /// Returns the block at the given height from the host chain, if exists.
+    pub fn host_block(&self, target_height: &Height) -> Option<H::Block> {
+        self.host.get_block(target_height)
+    }
+
+    /// Returns the latest block from the host chain.
+    pub fn query_latest_block(&self) -> Option<H::Block> {
+        self.host.get_block(&self.latest_height())
+    }
+
+    /// Returns the latest height of client state for the given [`ClientId`].
+    pub fn light_client_latest_height(&self, client_id: &ClientId) -> Height {
+        self.ibc_store
+            .client_state(client_id)
+            .expect("client state exists")
+            .latest_height()
+    }
+
+    /// Advances the host chain height to the given target height.
+    pub fn advance_block_up_to_height(mut self, target_height: Height) -> Self {
+        let latest_height = self.host.latest_height();
+        if target_height.revision_number() != latest_height.revision_number() {
+            panic!("Cannot advance history of the chain to a different revision number!")
+        } else if target_height.revision_height() < latest_height.revision_height() {
+            panic!("Cannot rewind history of the chain to a smaller revision height!")
+        } else {
+            // Repeatedly advance the host chain height till we hit the desired height
+            while self.host.latest_height().revision_height() < target_height.revision_height() {
+                self.advance_block_height()
+            }
+        }
+        self
+    }
+
+    /// Advance the first height of the host chain by generating a genesis block.
+    ///
+    /// This method is exactly the same as [`Self::advance_genesis_height`].
+    /// But it bootstraps the genesis block by height 1 and `genesis_time`.
+    ///
+    /// The method starts and ends with [`Self::end_block`] and [`Self::begin_block`], just
+    /// like the [`Self::advance_block_height_with_params`], so that it can advance to next height
+    /// i.e. height 2 - just by calling [`Self::advance_block_height_with_params`].
+    pub fn advance_genesis_height(&mut self, genesis_time: Timestamp, params: &H::BlockParams) {
+        self.end_block();
+
+        // commit multi store
+        let multi_store_commitment = self.multi_store.commit().expect("no error");
+
+        // generate a genesis block
+        // this is basically self.host.produce_block() but with
+        // block height 1 and block timestamp `genesis_time`.
+        let genesis_block =
+            self.host
+                .generate_block(multi_store_commitment, 1, genesis_time, params);
+
+        // push the genesis block to the host
+        self.host.push_block(genesis_block);
+
+        self.begin_block();
+    }
+
+    /// Begin a new block on the context.
+    ///
+    /// This method commits the required metadata from the last block generation
+    /// and consensus, and prepares the context for the next block. This includes
+    /// the latest consensus state and the latest IBC commitment proof.
+    pub fn begin_block(&mut self) {
+        let consensus_state = self
+            .host
+            .latest_block()
+            .into_header()
+            .into_consensus_state()
+            .into();
+
+        let ibc_commitment_proof = self
+            .multi_store
+            .get_proof(
+                self.host.latest_height().revision_height().into(),
+                &self
+                    .ibc_store
+                    .commitment_prefix()
+                    .as_bytes()
+                    .try_into()
+                    .expect("valid utf8 prefix"),
+            )
+            .expect("no error");
+
+        self.ibc_store.begin_block(
+            self.host.latest_height().revision_height(),
+            consensus_state,
+            ibc_commitment_proof,
+        );
+    }
+
+    /// End the current block on the context.
+    ///
+    /// This method commits the state of the IBC store and the host's multi store.
+    pub fn end_block(&mut self) {
+        // commit ibc store
+        let ibc_store_commitment = self.ibc_store.end_block().expect("no error");
+
+        // commit ibc store commitment in multi store
+        self.multi_store
+            .set(
+                self.ibc_store
+                    .commitment_prefix()
+                    .as_bytes()
+                    .try_into()
+                    .expect("valid utf8 prefix"),
+                ibc_store_commitment,
+            )
+            .expect("no error");
+    }
+
+    /// Commit store state to the current block of the host chain by:
+    /// - Committing the state to the context's multi store.
+    /// - Generating a new block with the commitment.
+    /// - Adding the generated block to the host's block history.
+    pub fn commit_state_to_host(&mut self, block_time: Duration, params: &H::BlockParams) {
+        // commit the multi store
+        let multi_store_commitment = self.multi_store.commit().expect("no error");
+        // generate a new block and add it to the block history
+        self.host
+            .commit_block(multi_store_commitment, block_time, params);
+    }
+
+    /// Advances the host chain height by ending the current block, producing a new block, and
+    /// beginning the next block.
+    pub fn advance_block_height_with_params(
+        &mut self,
+        block_time: Duration,
+        params: &H::BlockParams,
+    ) {
+        self.end_block();
+        self.commit_state_to_host(block_time, params);
+        self.begin_block();
+    }
+
+    /// Convenience method to advance the host chain height using default parameters.
+    pub fn advance_block_height(&mut self) {
+        self.advance_block_height_with_params(
+            Duration::from_secs(DEFAULT_BLOCK_TIME_SECS),
+            &Default::default(),
+        )
+    }
+
+    /// Returns the latest height of the host chain.
+    pub fn latest_height(&self) -> Height {
+        let latest_ibc_height = self.ibc_store.host_height().expect("Never fails");
+        let latest_host_height = self.host.latest_height();
+        assert_eq!(
+            latest_ibc_height, latest_host_height,
+            "The IBC store and the host chain must have the same height"
+        );
+        latest_ibc_height
+    }
+
+    /// Returns the latest timestamp of the host chain.
+    pub fn latest_timestamp(&self) -> Timestamp {
+        self.host.latest_block().timestamp()
+    }
+
+    /// Returns the timestamp at the given height.
+    pub fn timestamp_at(&self, height: Height) -> Timestamp {
+        self.host
+            .get_block(&height)
+            .expect("block exists")
+            .timestamp()
+    }
+
+    /// Bootstraps the context with a client state and its corresponding [`ClientId`].
+    pub fn with_client_state(mut self, client_id: &ClientId, client_state: AnyClientState) -> Self {
+        let client_state_path = ClientStatePath::new(client_id.clone());
+        self.ibc_store
+            .store_client_state(client_state_path, client_state)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps the context with a consensus state and its corresponding [`ClientId`] and [`Height`].
+    pub fn with_consensus_state(
+        mut self,
+        client_id: &ClientId,
+        height: Height,
+        consensus_state: AnyConsensusState,
+    ) -> Self {
+        let consensus_state_path = ClientConsensusStatePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        self.ibc_store
+            .store_consensus_state(consensus_state_path, consensus_state)
+            .expect("error writing to store");
+
+        self
+    }
+
+    /// Generates a light client for the host by generating a client
+    /// state, as well as generating consensus states for each
+    /// consensus height.
+    pub fn generate_light_client(
+        &self,
+        mut consensus_heights: Vec<Height>,
+        client_params: &H::LightClientParams,
+    ) -> LightClientState<H> {
+        let client_height = if let Some(&height) = consensus_heights.last() {
+            height
+        } else {
+            consensus_heights.push(self.latest_height());
+            self.latest_height()
+        };
+
+        let client_state = self
+            .host
+            .generate_client_state(&client_height, client_params);
+
+        let consensus_states = consensus_heights
+            .into_iter()
+            .map(|height| {
+                (
+                    height,
+                    self.host_block(&height)
+                        .expect("block exists")
+                        .into_header()
+                        .into_consensus_state(),
+                )
+            })
+            .collect();
+
+        LightClientState {
+            client_state,
+            consensus_states,
+        }
+    }
+
+    /// Bootstrap a light client with ClientState and its ConsensusState(s) to this context.
+    pub fn with_light_client<RH>(
+        mut self,
+        client_id: &ClientId,
+        light_client: LightClientState<RH>,
+    ) -> Self
+    where
+        RH: TestHost,
+    {
+        self = self.with_client_state(client_id, light_client.client_state.into());
+
+        for (height, consensus_state) in light_client.consensus_states {
+            self = self.with_consensus_state(client_id, height, consensus_state.into());
+
+            self.ibc_store
+                .store_update_meta(
+                    client_id.clone(),
+                    height,
+                    self.latest_timestamp(),
+                    self.latest_height(),
+                )
+                .expect("error writing to store");
+        }
+
+        self
+    }
+
+    /// Bootstraps a IBC connection to this context.
+    ///
+    /// This does not bootstrap any light client.
+    pub fn with_connection(
+        mut self,
+        connection_id: ConnectionId,
+        connection_end: ConnectionEnd,
+    ) -> Self {
+        let connection_path = ConnectionPath::new(&connection_id);
+        self.ibc_store
+            .store_connection(&connection_path, connection_end)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps a IBC channel to this context.
+    ///
+    /// This does not bootstrap any corresponding IBC connection or light client.
+    pub fn with_channel(
+        mut self,
+        port_id: PortId,
+        chan_id: ChannelId,
+        channel_end: ChannelEnd,
+    ) -> Self {
+        let channel_end_path = ChannelEndPath::new(&port_id, &chan_id);
+        self.ibc_store
+            .store_channel(&channel_end_path, channel_end)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps a send sequence to this context.
+    ///
+    /// This does not bootstrap any corresponding IBC channel, connection or light client.
+    pub fn with_send_sequence(
+        mut self,
+        port_id: PortId,
+        chan_id: ChannelId,
+        seq_number: Sequence,
+    ) -> Self {
+        let seq_send_path = SeqSendPath::new(&port_id, &chan_id);
+        self.ibc_store
+            .store_next_sequence_send(&seq_send_path, seq_number)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps a receive sequence to this context.
+    ///
+    /// This does not bootstrap any corresponding IBC channel, connection or light client.
+    pub fn with_recv_sequence(
+        mut self,
+        port_id: PortId,
+        chan_id: ChannelId,
+        seq_number: Sequence,
+    ) -> Self {
+        let seq_recv_path = SeqRecvPath::new(&port_id, &chan_id);
+        self.ibc_store
+            .store_next_sequence_recv(&seq_recv_path, seq_number)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps a ack sequence to this context.
+    ///
+    /// This does not bootstrap any corresponding IBC channel, connection or light client.
+    pub fn with_ack_sequence(
+        mut self,
+        port_id: PortId,
+        chan_id: ChannelId,
+        seq_number: Sequence,
+    ) -> Self {
+        let seq_ack_path = SeqAckPath::new(&port_id, &chan_id);
+        self.ibc_store
+            .store_next_sequence_ack(&seq_ack_path, seq_number)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Bootstraps a packet commitment to this context.
+    ///
+    /// This does not bootstrap any corresponding IBC channel, connection or light client.
+    pub fn with_packet_commitment(
+        mut self,
+        port_id: PortId,
+        chan_id: ChannelId,
+        seq: Sequence,
+        data: PacketCommitment,
+    ) -> Self {
+        let commitment_path = CommitmentPath::new(&port_id, &chan_id, seq);
+        self.ibc_store
+            .store_packet_commitment(&commitment_path, data)
+            .expect("error writing to store");
+        self
+    }
+
+    /// Calls [`validate`] function on [`MsgEnvelope`] using the context's IBC store and router.
+    pub fn validate(&mut self, msg: MsgEnvelope) -> Result<(), ContextError> {
+        validate(&self.ibc_store, &self.ibc_router, msg)
+    }
+
+    /// Calls [`execute`] function on [`MsgEnvelope`] using the context's IBC store and router.
+    pub fn execute(&mut self, msg: MsgEnvelope) -> Result<(), ContextError> {
+        execute(&mut self.ibc_store, &mut self.ibc_router, msg)
+    }
+
+    /// Calls [`dispatch`] function on [`MsgEnvelope`] using the context's IBC store and router.
+    pub fn dispatch(&mut self, msg: MsgEnvelope) -> Result<(), ContextError> {
+        dispatch(&mut self.ibc_store, &mut self.ibc_router, msg)
+    }
+
+    /// A datagram passes from the relayer to the IBC module (on host chain).
+    /// Alternative method to `Ics18Context::send` that does not exercise any serialization.
+    /// Used in testing the Ics18 algorithms, hence this may return a Ics18Error.
+    pub fn deliver(&mut self, msg: MsgEnvelope) -> Result<(), RelayerError> {
+        self.dispatch(msg)
+            .map_err(RelayerError::TransactionFailed)?;
+        // Create a new block.
+        self.advance_block_height();
+        Ok(())
+    }
+
+    /// Returns all the events that have been emitted by the context's IBC store.
+    pub fn get_events(&self) -> Vec<IbcEvent> {
+        self.ibc_store.events.lock().clone()
+    }
+
+    /// Returns all the logs that have been emitted by the context's IBC store.
+    pub fn get_logs(&self) -> Vec<String> {
+        self.ibc_store.logs.lock().clone()
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use ibc::core::client::context::consensus_state::ConsensusState;
+
+    use super::*;
+    use crate::hosts::{HostConsensusState, MockHost, TendermintHost};
+    use crate::testapp::ibc::core::types::DefaultIbcStore;
+
+    #[test]
+    fn test_mock_history_validation() {
+        pub struct Test<H: TestHost>
+        where
+            H: TestHost,
+            HostConsensusState<H>: ConsensusState,
+            HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+        {
+            name: String,
+            ctx: TestContext<H>,
+        }
+
+        fn run_tests<H>(sub_title: &str)
+        where
+            H: TestHost,
+            HostConsensusState<H>: ConsensusState,
+            HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+        {
+            let cv = 0; // The version to use for all chains.
+
+            let tests: Vec<Test<H>> = vec![
+                Test {
+                    name: "Empty history, small pruning window".to_string(),
+                    ctx: TestContextConfig::builder()
+                        .latest_height(Height::new(cv, 1).expect("Never fails"))
+                        .build(),
+                },
+                Test {
+                    name: "Large pruning window".to_string(),
+                    ctx: TestContextConfig::builder()
+                        .latest_height(Height::new(cv, 2).expect("Never fails"))
+                        .build(),
+                },
+                Test {
+                    name: "Small pruning window".to_string(),
+                    ctx: TestContextConfig::builder()
+                        .latest_height(Height::new(cv, 30).expect("Never fails"))
+                        .build(),
+                },
+                Test {
+                    name: "Small pruning window, small starting height".to_string(),
+                    ctx: TestContextConfig::builder()
+                        .latest_height(Height::new(cv, 2).expect("Never fails"))
+                        .build(),
+                },
+                // This is disabled, as now we generate all the blocks till latest_height
+                // Generating 2000 Tendermint blocks is slow.
+                // Test {
+                //     name: "Large pruning window, large starting height".to_string(),
+                //     ctx: TestContextConfig::builder()
+                //         .latest_height(Height::new(cv, 2000).expect("Never fails"))
+                //         .build(),
+                // },
+            ];
+
+            for mut test in tests {
+                // All tests should yield a valid context after initialization.
+                assert!(
+                    test.ctx.host.validate().is_ok(),
+                    "failed in test [{}] {} while validating context {:?}",
+                    sub_title,
+                    test.name,
+                    test.ctx
+                );
+
+                let current_height = test.ctx.latest_height();
+
+                // After advancing the chain's height, the context should still be valid.
+                test.ctx.advance_block_height();
+                assert!(
+                    test.ctx.host.validate().is_ok(),
+                    "failed in test [{}] {} while validating context {:?}",
+                    sub_title,
+                    test.name,
+                    test.ctx
+                );
+
+                let next_height = current_height.increment();
+                assert_eq!(
+                    test.ctx.latest_height(),
+                    next_height,
+                    "failed while increasing height for context {:?}",
+                    test.ctx
+                );
+
+                assert_eq!(
+                    test.ctx
+                        .host
+                        .get_block(&current_height)
+                        .expect("Never fails")
+                        .height(),
+                    current_height,
+                    "failed while fetching height {:?} of context {:?}",
+                    current_height,
+                    test.ctx
+                );
+            }
+        }
+
+        run_tests::<MockHost>("Mock Host");
+        run_tests::<TendermintHost>("Synthetic TM Host");
+    }
+}
diff --git a/ibc-testkit/src/fixtures/applications/transfer.rs b/ibc-testkit/src/fixtures/applications/transfer.rs
index 35e71fac0..dfd16a5e0 100644
--- a/ibc-testkit/src/fixtures/applications/transfer.rs
+++ b/ibc-testkit/src/fixtures/applications/transfer.rs
@@ -26,7 +26,7 @@ pub struct MsgTransferConfig {
 
 impl From<MsgTransferConfig> for MsgTransfer {
     fn from(config: MsgTransferConfig) -> Self {
-        MsgTransfer {
+        Self {
             port_id_on_a: config.port_id_on_a,
             chan_id_on_a: config.chan_id_on_a,
             packet_data: config.packet_data,
@@ -67,7 +67,7 @@ pub struct PacketDataConfig {
 
 impl From<PacketDataConfig> for PacketData {
     fn from(config: PacketDataConfig) -> Self {
-        PacketData {
+        Self {
             token: config.token,
             sender: config.sender,
             receiver: config.receiver,
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index f96ad0e6b..47b885a52 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -1,6 +1,7 @@
 use core::str::FromStr;
 use core::time::Duration;
 
+use basecoin_store::avl::get_proof_spec as basecoin_proof_spec;
 use ibc::clients::tendermint::client_state::ClientState as TmClientState;
 use ibc::clients::tendermint::types::error::{Error as ClientError, Error};
 use ibc::clients::tendermint::types::proto::v1::{ClientState as RawTmClientState, Fraction};
@@ -15,6 +16,7 @@ use ibc::core::commitment_types::specs::ProofSpecs;
 use ibc::core::host::types::identifiers::ChainId;
 use ibc::core::primitives::prelude::*;
 use tendermint::block::Header as TmHeader;
+use typed_builder::TypedBuilder;
 
 /// Returns a dummy tendermint `ClientState` by given `frozen_height`, for testing purposes only!
 pub fn dummy_tm_client_state_from_raw(frozen_height: RawHeight) -> Result<TmClientState, Error> {
@@ -64,9 +66,8 @@ pub fn dummy_raw_tm_client_state(frozen_height: RawHeight) -> RawTmClientState {
     }
 }
 
-#[derive(typed_builder::TypedBuilder, Debug)]
+#[derive(TypedBuilder, Debug)]
 pub struct ClientStateConfig {
-    pub chain_id: ChainId,
     #[builder(default = TrustThreshold::ONE_THIRD)]
     pub trust_level: TrustThreshold,
     #[builder(default = Duration::from_secs(64000))]
@@ -74,9 +75,8 @@ pub struct ClientStateConfig {
     #[builder(default = Duration::from_secs(128_000))]
     pub unbonding_period: Duration,
     #[builder(default = Duration::from_millis(3000))]
-    max_clock_drift: Duration,
-    pub latest_height: Height,
-    #[builder(default = ProofSpecs::cosmos())]
+    pub max_clock_drift: Duration,
+    #[builder(default = vec![basecoin_proof_spec(); 2].try_into().expect("no error"))]
     pub proof_specs: ProofSpecs,
     #[builder(default)]
     pub upgrade_path: Vec<String>,
@@ -84,23 +84,30 @@ pub struct ClientStateConfig {
     allow_update: AllowUpdate,
 }
 
-impl TryFrom<ClientStateConfig> for TmClientState {
-    type Error = ClientError;
-
-    fn try_from(config: ClientStateConfig) -> Result<Self, Self::Error> {
-        let client_state = ClientStateType::new(
-            config.chain_id,
-            config.trust_level,
-            config.trusting_period,
-            config.unbonding_period,
-            config.max_clock_drift,
-            config.latest_height,
-            config.proof_specs,
-            config.upgrade_path,
-            config.allow_update,
-        )?;
-
-        Ok(TmClientState::from(client_state))
+impl Default for ClientStateConfig {
+    fn default() -> Self {
+        Self::builder().build()
+    }
+}
+
+impl ClientStateConfig {
+    pub fn into_client_state(
+        self,
+        chain_id: ChainId,
+        latest_height: Height,
+    ) -> Result<TmClientState, ClientError> {
+        Ok(ClientStateType::new(
+            chain_id,
+            self.trust_level,
+            self.trusting_period,
+            self.unbonding_period,
+            self.max_clock_drift,
+            latest_height,
+            self.proof_specs,
+            self.upgrade_path,
+            self.allow_update,
+        )?
+        .into())
     }
 }
 
@@ -146,7 +153,7 @@ pub fn dummy_ics07_header() -> Header {
 
     // Build a set of validators.
     // Below are test values inspired form `test_validator_set()` in tendermint-rs.
-    let v1: ValidatorInfo = ValidatorInfo::new(
+    let v1 = ValidatorInfo::new(
         PublicKey::from_raw_ed25519(
             &hex::decode_upper("F349539C7E5EF7C49549B09C4BFC2335318AB0FE51FBFAA2433B4F13E816F4A7")
                 .expect("Never fails"),
diff --git a/ibc-testkit/src/fixtures/core/channel/mod.rs b/ibc-testkit/src/fixtures/core/channel/mod.rs
index 96834609e..5f12f7b88 100644
--- a/ibc-testkit/src/fixtures/core/channel/mod.rs
+++ b/ibc-testkit/src/fixtures/core/channel/mod.rs
@@ -10,22 +10,23 @@ mod recv_packet;
 mod timeout;
 mod timeout_on_close;
 
-pub use acknowledgement::*;
-pub use chan_close_confirm::*;
-pub use chan_close_init::*;
-pub use chan_open_ack::*;
-pub use chan_open_confirm::*;
-pub use chan_open_init::*;
-pub use chan_open_try::*;
 use ibc::core::channel::types::proto::v1::{
     Channel as RawChannel, Counterparty as RawCounterparty,
 };
 use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
 use ibc::primitives::prelude::*;
-pub use packet::*;
-pub use recv_packet::*;
-pub use timeout::*;
-pub use timeout_on_close::*;
+
+pub use self::acknowledgement::*;
+pub use self::chan_close_confirm::*;
+pub use self::chan_close_init::*;
+pub use self::chan_open_ack::*;
+pub use self::chan_open_confirm::*;
+pub use self::chan_open_init::*;
+pub use self::chan_open_try::*;
+pub use self::packet::*;
+pub use self::recv_packet::*;
+pub use self::timeout::*;
+pub use self::timeout_on_close::*;
 
 /// Returns a dummy `RawCounterparty`, for testing purposes only!
 /// Can be optionally parametrized with a specific channel identifier.
diff --git a/ibc-testkit/src/fixtures/core/channel/packet.rs b/ibc-testkit/src/fixtures/core/channel/packet.rs
index a4e0ca36e..9e213826f 100644
--- a/ibc-testkit/src/fixtures/core/channel/packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/packet.rs
@@ -31,7 +31,7 @@ pub struct PacketConfig {
 
 impl From<PacketConfig> for Packet {
     fn from(config: PacketConfig) -> Self {
-        Packet {
+        Self {
             seq_on_a: config.seq_on_a,
             port_id_on_a: config.port_id_on_a,
             chan_id_on_a: config.chan_id_on_a,
diff --git a/ibc-testkit/src/fixtures/core/client/mod.rs b/ibc-testkit/src/fixtures/core/client/mod.rs
index 6f2f3d841..508fe0e3b 100644
--- a/ibc-testkit/src/fixtures/core/client/mod.rs
+++ b/ibc-testkit/src/fixtures/core/client/mod.rs
@@ -5,10 +5,10 @@ mod msg_update_client;
 mod msg_upgrade_client;
 
 #[cfg(feature = "serde")]
-pub use msg_create_client::*;
+pub use self::msg_create_client::*;
 #[cfg(feature = "serde")]
-pub use msg_update_client::*;
-pub use msg_upgrade_client::*;
+pub use self::msg_update_client::*;
+pub use self::msg_upgrade_client::*;
 
 #[cfg(test)]
 mod tests {
diff --git a/ibc-testkit/src/fixtures/core/connection/mod.rs b/ibc-testkit/src/fixtures/core/connection/mod.rs
index 5b8388147..3460a3f10 100644
--- a/ibc-testkit/src/fixtures/core/connection/mod.rs
+++ b/ibc-testkit/src/fixtures/core/connection/mod.rs
@@ -3,16 +3,17 @@ mod conn_open_confirm;
 mod conn_open_init;
 mod conn_open_try;
 
-pub use conn_open_ack::*;
-pub use conn_open_confirm::*;
-pub use conn_open_init::*;
-pub use conn_open_try::*;
 use ibc::core::commitment_types::proto::v1::MerklePrefix;
 use ibc::core::connection::types::proto::v1::Counterparty as RawCounterparty;
 use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::primitives::prelude::*;
 use typed_builder::TypedBuilder;
 
+pub use self::conn_open_ack::*;
+pub use self::conn_open_confirm::*;
+pub use self::conn_open_init::*;
+pub use self::conn_open_try::*;
+
 #[derive(TypedBuilder, Debug)]
 #[builder(build_method(into = RawCounterparty))]
 pub struct CounterpartyConfig {
diff --git a/ibc-testkit/src/fixtures/core/context.rs b/ibc-testkit/src/fixtures/core/context.rs
index a886777e7..99304f0e0 100644
--- a/ibc-testkit/src/fixtures/core/context.rs
+++ b/ibc-testkit/src/fixtures/core/context.rs
@@ -1,127 +1,100 @@
-use alloc::sync::Arc;
-use core::cmp::min;
-use core::ops::{Add, Sub};
+use alloc::fmt::Debug;
 use core::time::Duration;
 
+use basecoin_store::context::ProvableStore;
+use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::types::Height;
-use ibc::core::host::types::identifiers::ChainId;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::Timestamp;
-use parking_lot::Mutex;
-use tendermint_testgen::Validator as TestgenValidator;
 use typed_builder::TypedBuilder;
 
-use crate::hosts::block::{HostBlock, HostType};
-use crate::testapp::ibc::core::types::{MockContext, MockIbcStore, DEFAULT_BLOCK_TIME_SECS};
+use crate::context::StoreGenericTestContext;
+use crate::hosts::{HostClientState, TestBlock, TestHost};
+use crate::testapp::ibc::core::router::MockRouter;
+use crate::testapp::ibc::core::types::{MockIbcStore, DEFAULT_BLOCK_TIME_SECS};
+use crate::utils::year_2023;
 
-/// Configuration of the `MockContext` type for generating dummy contexts.
+/// Configuration of the [`StoreGenericTestContext`] type for generating dummy contexts.
 #[derive(Debug, TypedBuilder)]
-#[builder(build_method(into = MockContext))]
-pub struct MockContextConfig {
-    #[builder(default = HostType::Mock)]
-    host_type: HostType,
-
-    #[builder(default = ChainId::new("mockgaia-0").expect("Never fails"))]
-    host_id: ChainId,
+#[builder(build_method(into))]
+pub struct TestContextConfig<H>
+where
+    H: TestHost,
+{
+    #[builder(default)]
+    host: H,
 
     #[builder(default = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS))]
     block_time: Duration,
 
-    // may panic if validator_set_history size is less than max_history_size + 1
-    #[builder(default = 5)]
-    max_history_size: u64,
+    #[builder(default = year_2023())]
+    latest_timestamp: Timestamp,
 
-    #[builder(default, setter(strip_option))]
-    validator_set_history: Option<Vec<Vec<TestgenValidator>>>,
+    #[builder(default)]
+    block_params_history: Vec<H::BlockParams>,
 
     #[builder(default = Height::new(0, 5).expect("Never fails"))]
     latest_height: Height,
-
-    #[builder(default = Timestamp::now())]
-    latest_timestamp: Timestamp,
 }
 
-impl From<MockContextConfig> for MockContext {
-    fn from(params: MockContextConfig) -> Self {
-        assert_ne!(
-            params.max_history_size, 0,
-            "The chain must have a non-zero max_history_size"
-        );
-
+impl<S, H> From<TestContextConfig<H>> for StoreGenericTestContext<S, H>
+where
+    S: ProvableStore + Debug + Default,
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<MockIbcStore<S>>,
+{
+    fn from(params: TestContextConfig<H>) -> Self {
         assert_ne!(
             params.latest_height.revision_height(),
             0,
             "The chain must have a non-zero revision_height"
         );
 
-        // Compute the number of blocks to store.
-        let n = min(
-            params.max_history_size,
-            params.latest_height.revision_height(),
+        // timestamp at height 1
+        let genesis_timestamp = (params.latest_timestamp
+            - (params.block_time
+                * u32::try_from(params.latest_height.revision_height() - 1).expect("no overflow")))
+        .expect("no underflow");
+
+        let mut context = Self {
+            multi_store: Default::default(),
+            host: params.host,
+            ibc_store: MockIbcStore::new(
+                params.latest_height.revision_number(),
+                Default::default(),
+            ),
+            ibc_router: MockRouter::new_with_transfer(),
+        };
+
+        // store is at height 0; no block
+
+        context.advance_genesis_height(genesis_timestamp, &Default::default());
+
+        // store is at height 1; one block
+
+        context = context.advance_block_up_to_height(
+            params
+                .latest_height
+                .sub(params.block_params_history.len() as u64)
+                .expect("no error"),
         );
 
+        for block_params in params.block_params_history {
+            context.advance_block_height_with_params(params.block_time, &block_params);
+        }
+
         assert_eq!(
-            params.host_id.revision_number(),
-            params.latest_height.revision_number(),
-            "The version in the chain identifier must match the version in the latest height"
+            context.host.latest_block().height(),
+            params.latest_height,
+            "The latest height in the host must match the latest height in the context"
         );
 
-        let next_block_timestamp = params
-            .latest_timestamp
-            .add(params.block_time)
-            .expect("Never fails");
-
-        let history = if let Some(validator_set_history) = params.validator_set_history {
-            (0..n)
-                .rev()
-                .map(|i| {
-                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                    // where N = now(), BT = block_time
-                    HostBlock::generate_block_with_validators(
-                        params.host_id.clone(),
-                        params.host_type,
-                        params
-                            .latest_height
-                            .sub(i)
-                            .expect("Never fails")
-                            .revision_height(),
-                        next_block_timestamp
-                            .sub(params.block_time * ((i + 1) as u32))
-                            .expect("Never fails"),
-                        &validator_set_history[(n - i) as usize - 1],
-                        &validator_set_history[(n - i) as usize],
-                    )
-                })
-                .collect()
-        } else {
-            (0..n)
-                .rev()
-                .map(|i| {
-                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                    // where N = now(), BT = block_time
-                    HostBlock::generate_block(
-                        params.host_id.clone(),
-                        params.host_type,
-                        params
-                            .latest_height
-                            .sub(i)
-                            .expect("Never fails")
-                            .revision_height(),
-                        next_block_timestamp
-                            .sub(params.block_time * ((i + 1) as u32))
-                            .expect("Never fails"),
-                    )
-                })
-                .collect()
-        };
+        assert_eq!(
+            context.host.latest_block().timestamp(),
+            params.latest_timestamp,
+            "The latest timestamp in the host must match the latest timestamp in the context"
+        );
 
-        MockContext {
-            host_chain_type: params.host_type,
-            host_chain_id: params.host_id.clone(),
-            max_history_size: params.max_history_size,
-            history,
-            block_time: params.block_time,
-            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-        }
+        context
     }
 }
diff --git a/ibc-testkit/src/fixtures/mod.rs b/ibc-testkit/src/fixtures/mod.rs
index af14cadb9..f6b51ef46 100644
--- a/ibc-testkit/src/fixtures/mod.rs
+++ b/ibc-testkit/src/fixtures/mod.rs
@@ -6,15 +6,15 @@ use alloc::fmt::Debug;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::primitives::prelude::*;
 
-use crate::testapp::ibc::core::types::MockContext;
+use crate::testapp::ibc::core::types::DefaultIbcStore;
 pub enum Expect {
     Success,
     Failure(Option<ContextError>),
 }
 
-#[derive(Clone, Debug)]
+#[derive(Debug)]
 pub struct Fixture<M: Debug> {
-    pub ctx: MockContext,
+    pub ctx: DefaultIbcStore,
     pub msg: M,
 }
 
diff --git a/ibc-testkit/src/hosts/block.rs b/ibc-testkit/src/hosts/block.rs
deleted file mode 100644
index 526ca1784..000000000
--- a/ibc-testkit/src/hosts/block.rs
+++ /dev/null
@@ -1,260 +0,0 @@
-//! Host chain types and methods, used by context mock.
-
-use core::str::FromStr;
-
-use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
-use ibc::clients::tendermint::types::proto::v1::Header as RawHeader;
-use ibc::clients::tendermint::types::{Header, TENDERMINT_HEADER_TYPE_URL};
-use ibc::core::client::types::error::ClientError;
-use ibc::core::client::types::Height;
-use ibc::core::host::types::identifiers::ChainId;
-use ibc::core::primitives::prelude::*;
-use ibc::core::primitives::Timestamp;
-use ibc::primitives::proto::{Any, Protobuf};
-use ibc::primitives::ToVec;
-use tendermint::block::Header as TmHeader;
-use tendermint::validator::Set as ValidatorSet;
-use tendermint_testgen::light_block::TmLightBlock;
-use tendermint_testgen::{
-    Generator, Header as TestgenHeader, LightBlock as TestgenLightBlock,
-    Validator as TestgenValidator,
-};
-
-use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
-use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::testapp::ibc::clients::AnyConsensusState;
-
-/// Defines the different types of host chains that a mock context can emulate.
-/// The variants are as follows:
-/// - `Mock` defines that the context history consists of `MockHeader` blocks.
-/// - `SyntheticTendermint`: the context has synthetically-generated Tendermint (light) blocks.
-/// See also the `HostBlock` enum to get more insights into the underlying block type.
-#[derive(Clone, Debug, Copy)]
-pub enum HostType {
-    Mock,
-    SyntheticTendermint,
-}
-
-#[cfg_attr(feature = "serde", derive(serde::Serialize))]
-#[derive(Clone, Debug, PartialEq, Eq)]
-pub struct SyntheticTmBlock {
-    pub trusted_height: Height,
-    pub trusted_next_validators: ValidatorSet,
-    pub light_block: TmLightBlock,
-}
-
-impl SyntheticTmBlock {
-    pub fn header(&self) -> &TmHeader {
-        &self.light_block.signed_header.header
-    }
-}
-
-impl From<SyntheticTmBlock> for Header {
-    fn from(light_block: SyntheticTmBlock) -> Self {
-        let SyntheticTmBlock {
-            trusted_height,
-            trusted_next_validators,
-            light_block,
-        } = light_block;
-        Self {
-            signed_header: light_block.signed_header,
-            validator_set: light_block.validators,
-            trusted_height,
-            trusted_next_validator_set: trusted_next_validators,
-        }
-    }
-}
-
-/// Depending on `HostType` (the type of host chain underlying a context mock), this enum defines
-/// the type of blocks composing the history of the host chain.
-#[cfg_attr(feature = "serde", derive(serde::Serialize))]
-#[derive(Clone, Debug, PartialEq, Eq)]
-pub enum HostBlock {
-    Mock(Box<MockHeader>),
-    SyntheticTendermint(Box<SyntheticTmBlock>),
-}
-
-impl HostBlock {
-    /// Returns the height of a block.
-    pub fn height(&self) -> Height {
-        match self {
-            HostBlock::Mock(header) => header.height(),
-            HostBlock::SyntheticTendermint(light_block) => Height::new(
-                ChainId::from_str(light_block.header().chain_id.as_str())
-                    .expect("Never fails")
-                    .revision_number(),
-                light_block.header().height.value(),
-            )
-            .expect("Never fails"),
-        }
-    }
-
-    pub fn set_trusted_height(&mut self, height: Height) {
-        match self {
-            HostBlock::Mock(_) => {}
-            HostBlock::SyntheticTendermint(light_block) => light_block.trusted_height = height,
-        }
-    }
-
-    pub fn set_trusted_next_validators_set(&mut self, trusted_next_validators: ValidatorSet) {
-        match self {
-            HostBlock::Mock(_) => {}
-            HostBlock::SyntheticTendermint(light_block) => {
-                light_block.trusted_next_validators = trusted_next_validators
-            }
-        }
-    }
-
-    /// Returns the timestamp of a block.
-    pub fn timestamp(&self) -> Timestamp {
-        match self {
-            HostBlock::Mock(header) => header.timestamp,
-            HostBlock::SyntheticTendermint(light_block) => light_block.header().time.into(),
-        }
-    }
-
-    /// Generates a new block at `height` for the given chain identifier and chain type.
-    pub fn generate_block(
-        chain_id: ChainId,
-        chain_type: HostType,
-        height: u64,
-        timestamp: Timestamp,
-    ) -> HostBlock {
-        match chain_type {
-            HostType::Mock => HostBlock::Mock(Box::new(MockHeader {
-                height: Height::new(chain_id.revision_number(), height).expect("Never fails"),
-                timestamp,
-            })),
-            HostType::SyntheticTendermint => HostBlock::SyntheticTendermint(Box::new(
-                Self::generate_tm_block(chain_id, height, timestamp),
-            )),
-        }
-    }
-
-    /// Generates a new block at `height` for the given chain identifier, chain type and validator sets.
-    pub fn generate_block_with_validators(
-        chain_id: ChainId,
-        chain_type: HostType,
-        height: u64,
-        timestamp: Timestamp,
-        validators: &[TestgenValidator],
-        next_validators: &[TestgenValidator],
-    ) -> HostBlock {
-        match chain_type {
-            HostType::Mock => HostBlock::Mock(Box::new(MockHeader {
-                height: Height::new(chain_id.revision_number(), height).expect("Never fails"),
-                timestamp,
-            })),
-            HostType::SyntheticTendermint => {
-                let light_block = TestgenLightBlock::new_default_with_header(
-                    TestgenHeader::new(validators)
-                        .height(height)
-                        .chain_id(chain_id.as_str())
-                        .next_validators(next_validators)
-                        .time(timestamp.into_tm_time().expect("Never fails")),
-                )
-                .validators(validators)
-                .next_validators(next_validators)
-                .generate()
-                .expect("Never fails");
-
-                HostBlock::SyntheticTendermint(Box::new(SyntheticTmBlock {
-                    trusted_height: Height::new(chain_id.revision_number(), 1)
-                        .expect("Never fails"),
-                    trusted_next_validators: light_block.next_validators.clone(),
-                    light_block,
-                }))
-            }
-        }
-    }
-
-    pub fn generate_tm_block(
-        chain_id: ChainId,
-        height: u64,
-        timestamp: Timestamp,
-    ) -> SyntheticTmBlock {
-        let validators = [
-            TestgenValidator::new("1").voting_power(50),
-            TestgenValidator::new("2").voting_power(50),
-        ];
-
-        let header = TestgenHeader::new(&validators)
-            .height(height)
-            .chain_id(chain_id.as_str())
-            .next_validators(&validators)
-            .time(timestamp.into_tm_time().expect("Never fails"));
-
-        let light_block = TestgenLightBlock::new_default_with_header(header)
-            .generate()
-            .expect("Never fails");
-
-        SyntheticTmBlock {
-            trusted_height: Height::new(chain_id.revision_number(), 1).expect("Never fails"),
-            trusted_next_validators: light_block.next_validators.clone(),
-            light_block,
-        }
-    }
-
-    pub fn try_into_tm_block(self) -> Option<SyntheticTmBlock> {
-        match self {
-            HostBlock::Mock(_) => None,
-            HostBlock::SyntheticTendermint(tm_block) => Some(*tm_block),
-        }
-    }
-}
-
-impl From<SyntheticTmBlock> for AnyConsensusState {
-    fn from(light_block: SyntheticTmBlock) -> Self {
-        let cs = TmConsensusState::from(light_block.header().clone());
-        cs.into()
-    }
-}
-
-impl From<HostBlock> for AnyConsensusState {
-    fn from(any_block: HostBlock) -> Self {
-        match any_block {
-            HostBlock::Mock(mock_header) => MockConsensusState::new(*mock_header).into(),
-            HostBlock::SyntheticTendermint(light_block) => {
-                TmConsensusState::from(light_block.header().clone()).into()
-            }
-        }
-    }
-}
-
-impl Protobuf<Any> for HostBlock {}
-
-impl TryFrom<Any> for HostBlock {
-    type Error = ClientError;
-
-    fn try_from(_raw: Any) -> Result<Self, Self::Error> {
-        todo!()
-    }
-}
-
-impl From<HostBlock> for Any {
-    fn from(value: HostBlock) -> Self {
-        fn encode_light_block(light_block: SyntheticTmBlock) -> Vec<u8> {
-            let SyntheticTmBlock {
-                trusted_height,
-                trusted_next_validators,
-                light_block,
-            } = light_block;
-
-            RawHeader {
-                signed_header: Some(light_block.signed_header.into()),
-                validator_set: Some(light_block.validators.into()),
-                trusted_height: Some(trusted_height.into()),
-                trusted_validators: Some(trusted_next_validators.into()),
-            }
-            .to_vec()
-        }
-
-        match value {
-            HostBlock::Mock(mock_header) => (*mock_header).into(),
-            HostBlock::SyntheticTendermint(light_block) => Self {
-                type_url: TENDERMINT_HEADER_TYPE_URL.to_string(),
-                value: encode_light_block(*light_block),
-            },
-        }
-    }
-}
diff --git a/ibc-testkit/src/hosts/mock.rs b/ibc-testkit/src/hosts/mock.rs
new file mode 100644
index 000000000..266f69f53
--- /dev/null
+++ b/ibc-testkit/src/hosts/mock.rs
@@ -0,0 +1,97 @@
+use alloc::vec::Vec;
+
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::Timestamp;
+use typed_builder::TypedBuilder;
+
+use super::{TestBlock, TestHeader, TestHost};
+use crate::testapp::ibc::clients::mock::client_state::MockClientState;
+use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::testapp::ibc::clients::mock::header::MockHeader;
+
+#[derive(TypedBuilder, Debug)]
+pub struct MockHost {
+    /// Unique identifier for the chain.
+    #[builder(default = ChainId::new("mock-0").expect("Never fails"))]
+    pub chain_id: ChainId,
+    /// The chain of blocks underlying this context.
+    #[builder(default)]
+    pub history: Vec<MockHeader>,
+}
+
+impl Default for MockHost {
+    fn default() -> Self {
+        Self::builder().build()
+    }
+}
+
+impl TestHost for MockHost {
+    type Block = MockHeader;
+    type ClientState = MockClientState;
+    type BlockParams = ();
+    type LightClientParams = ();
+
+    fn history(&self) -> &Vec<Self::Block> {
+        &self.history
+    }
+
+    fn push_block(&mut self, block: Self::Block) {
+        self.history.push(block);
+    }
+
+    fn generate_block(
+        &self,
+        _commitment_root: Vec<u8>,
+        height: u64,
+        timestamp: Timestamp,
+        _params: &Self::BlockParams,
+    ) -> Self::Block {
+        MockHeader {
+            height: Height::new(self.chain_id.revision_number(), height).expect("Never fails"),
+            timestamp,
+        }
+    }
+
+    fn generate_client_state(
+        &self,
+        latest_height: &Height,
+        _params: &Self::LightClientParams,
+    ) -> Self::ClientState {
+        MockClientState::new(self.get_block(latest_height).expect("height exists"))
+    }
+}
+
+impl TestBlock for MockHeader {
+    type Header = Self;
+
+    fn height(&self) -> Height {
+        self.height
+    }
+
+    fn timestamp(&self) -> Timestamp {
+        self.timestamp
+    }
+
+    fn into_header_with_trusted(self, _trusted_block: &Self) -> Self::Header {
+        self
+    }
+}
+
+impl From<MockHeader> for MockConsensusState {
+    fn from(block: MockHeader) -> Self {
+        Self::new(block)
+    }
+}
+
+impl TestHeader for MockHeader {
+    type ConsensusState = MockConsensusState;
+
+    fn height(&self) -> Height {
+        self.height
+    }
+
+    fn timestamp(&self) -> Timestamp {
+        self.timestamp
+    }
+}
diff --git a/ibc-testkit/src/hosts/mod.rs b/ibc-testkit/src/hosts/mod.rs
index a863eaad2..426b69066 100644
--- a/ibc-testkit/src/hosts/mod.rs
+++ b/ibc-testkit/src/hosts/mod.rs
@@ -1 +1,157 @@
-pub mod block;
+pub mod mock;
+pub mod tendermint;
+
+use core::fmt::Debug;
+use core::ops::Add;
+use core::time::Duration;
+
+use ibc::core::client::context::consensus_state::ConsensusState;
+use ibc::core::client::types::Height;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::Any;
+
+pub use self::mock::MockHost;
+pub use self::tendermint::TendermintHost;
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
+
+pub type HostClientState<H> = <H as TestHost>::ClientState;
+pub type HostBlock<H> = <H as TestHost>::Block;
+pub type HostBlockParams<H> = <H as TestHost>::BlockParams;
+pub type HostLightClientParams<H> = <H as TestHost>::LightClientParams;
+pub type HostHeader<H> = <HostBlock<H> as TestBlock>::Header;
+pub type HostConsensusState<H> = <HostHeader<H> as TestHeader>::ConsensusState;
+
+/// TestHost is a trait that defines the interface for a host blockchain.
+pub trait TestHost: Default + Debug + Sized {
+    /// The type of block produced by the host.
+    type Block: TestBlock;
+
+    /// The type of client state produced by the host.
+    type ClientState: Into<AnyClientState> + Debug;
+
+    /// The type of block parameters to produce a block.
+    type BlockParams: Debug + Default;
+
+    /// The type of light client parameters to produce a light client state.
+    type LightClientParams: Debug + Default;
+
+    /// The history of blocks produced by the host chain.
+    fn history(&self) -> &Vec<Self::Block>;
+
+    /// Returns true if the host chain has no blocks.
+    fn is_empty(&self) -> bool {
+        self.history().is_empty()
+    }
+
+    /// The latest height of the host chain.
+    fn latest_height(&self) -> Height {
+        self.latest_block().height()
+    }
+
+    /// The latest block of the host chain.
+    fn latest_block(&self) -> Self::Block {
+        self.history().last().cloned().expect("no error")
+    }
+
+    /// Get the block at the given height.
+    fn get_block(&self, target_height: &Height) -> Option<Self::Block> {
+        self.history()
+            .get(target_height.revision_height() as usize - 1)
+            .cloned() // indexed from 1
+    }
+
+    /// Add a block to the host chain.
+    fn push_block(&mut self, block: Self::Block);
+
+    /// Commit a block with commitment root to the blockchain, by extending the history of blocks.
+    fn commit_block(
+        &mut self,
+        commitment_root: Vec<u8>,
+        block_time: Duration,
+        params: &Self::BlockParams,
+    ) {
+        let latest_block = self.latest_block();
+
+        let height = TestBlock::height(&latest_block)
+            .increment()
+            .revision_height();
+        let timestamp = TestBlock::timestamp(&latest_block)
+            .add(block_time)
+            .expect("Never fails");
+
+        let new_block = self.generate_block(commitment_root, height, timestamp, params);
+
+        // History is not full yet.
+        self.push_block(new_block);
+    }
+
+    /// Generate a block at the given height and timestamp, using the provided parameters.
+    fn generate_block(
+        &self,
+        commitment_root: Vec<u8>,
+        height: u64,
+        timestamp: Timestamp,
+        params: &Self::BlockParams,
+    ) -> Self::Block;
+
+    /// Generate a client state using the block at the given height and the provided parameters.
+    fn generate_client_state(
+        &self,
+        latest_height: &Height,
+        params: &Self::LightClientParams,
+    ) -> Self::ClientState;
+
+    fn validate(&self) -> Result<(), String> {
+        // Check that headers in the history are in sequential order.
+        let latest_height = self.latest_height();
+        let mut current_height = Height::min(latest_height.revision_number());
+
+        while current_height <= latest_height {
+            if current_height != self.get_block(&current_height).expect("no error").height() {
+                return Err("block height does not match".to_owned());
+            }
+            current_height = current_height.increment();
+        }
+        Ok(())
+    }
+}
+
+/// TestBlock is a trait that defines the interface for a block produced by a host blockchain.
+pub trait TestBlock: Clone + Debug {
+    /// The type of header can be extracted from the block.
+    type Header: TestHeader;
+
+    /// The height of the block.
+    fn height(&self) -> Height;
+
+    /// The timestamp of the block.
+    fn timestamp(&self) -> Timestamp;
+
+    /// Extract the IBC header using the target and trusted blocks.
+    fn into_header_with_trusted(self, trusted_block: &Self) -> Self::Header;
+
+    /// Extract the IBC header only using the target block (sets the trusted
+    /// block to itself).
+    fn into_header(self) -> Self::Header {
+        self.clone().into_header_with_trusted(&self)
+    }
+}
+
+/// TestHeader is a trait that defines the interface for a header
+/// submitted by relayer from the host blockchain.
+pub trait TestHeader: Clone + Debug + Into<Any> {
+    /// The type of consensus state can be extracted from the header.
+    type ConsensusState: ConsensusState + Into<AnyConsensusState> + From<Self> + Clone + Debug;
+
+    /// The height of the block, as recorded in the header.
+    fn height(&self) -> Height;
+
+    /// The timestamp of the block, as recorded in the header.
+    fn timestamp(&self) -> Timestamp;
+
+    /// Extract the consensus state from the header.
+    fn into_consensus_state(self) -> Self::ConsensusState {
+        Self::ConsensusState::from(self)
+    }
+}
diff --git a/ibc-testkit/src/hosts/tendermint.rs b/ibc-testkit/src/hosts/tendermint.rs
new file mode 100644
index 000000000..a3b8af534
--- /dev/null
+++ b/ibc-testkit/src/hosts/tendermint.rs
@@ -0,0 +1,240 @@
+use core::str::FromStr;
+
+use ibc::clients::tendermint::client_state::ClientState;
+use ibc::clients::tendermint::consensus_state::ConsensusState;
+use ibc::clients::tendermint::types::proto::v1::Header as RawHeader;
+use ibc::clients::tendermint::types::{Header, TENDERMINT_HEADER_TYPE_URL};
+use ibc::core::client::types::Height;
+use ibc::core::host::types::identifiers::ChainId;
+use ibc::core::primitives::prelude::*;
+use ibc::core::primitives::Timestamp;
+use ibc::primitives::proto::Any;
+use ibc::primitives::ToVec;
+use tendermint::block::Header as TmHeader;
+use tendermint::validator::Set as ValidatorSet;
+use tendermint_testgen::light_block::TmLightBlock;
+use tendermint_testgen::{
+    Generator, Header as TestgenHeader, LightBlock as TestgenLightBlock,
+    Validator as TestgenValidator,
+};
+use typed_builder::TypedBuilder;
+
+use crate::fixtures::clients::tendermint::ClientStateConfig;
+use crate::hosts::{TestBlock, TestHeader, TestHost};
+
+/// A host that produces Tendermint blocks and interfaces with Tendermint light clients.
+#[derive(TypedBuilder, Debug)]
+pub struct TendermintHost {
+    /// Unique identifier for the chain.
+    #[builder(default = ChainId::new("mock-0").expect("Never fails"))]
+    pub chain_id: ChainId,
+    /// The chain of blocks underlying this context.
+    #[builder(default)]
+    pub history: Vec<TmLightBlock>,
+}
+
+impl Default for TendermintHost {
+    fn default() -> Self {
+        Self::builder().build()
+    }
+}
+
+impl TestHost for TendermintHost {
+    type Block = TmLightBlock;
+    type BlockParams = BlockParams;
+    type LightClientParams = ClientStateConfig;
+    type ClientState = ClientState;
+
+    fn history(&self) -> &Vec<Self::Block> {
+        &self.history
+    }
+
+    fn push_block(&mut self, block: Self::Block) {
+        self.history.push(block);
+    }
+
+    fn generate_block(
+        &self,
+        commitment_root: Vec<u8>,
+        height: u64,
+        timestamp: Timestamp,
+        params: &Self::BlockParams,
+    ) -> Self::Block {
+        TestgenLightBlock::new_default_with_header(
+            TestgenHeader::new(&params.validators)
+                .app_hash(commitment_root.try_into().expect("infallible"))
+                .height(height)
+                .chain_id(self.chain_id.as_str())
+                .next_validators(&params.next_validators)
+                .time(timestamp.into_tm_time().expect("Never fails")),
+        )
+        .validators(&params.validators)
+        .next_validators(&params.next_validators)
+        .generate()
+        .expect("Never fails")
+    }
+
+    fn generate_client_state(
+        &self,
+        latest_height: &Height,
+        params: &Self::LightClientParams,
+    ) -> Self::ClientState {
+        let client_state = ClientStateConfig::builder()
+            .trusting_period(params.trusting_period)
+            .max_clock_drift(params.max_clock_drift)
+            .unbonding_period(params.unbonding_period)
+            .proof_specs(params.proof_specs.clone())
+            .build()
+            .into_client_state(
+                self.chain_id.clone(),
+                self.get_block(latest_height)
+                    .expect("block exists")
+                    .height(),
+            )
+            .expect("never fails");
+
+        client_state.inner().validate().expect("never fails");
+
+        client_state
+    }
+}
+
+impl TestBlock for TmLightBlock {
+    type Header = TendermintHeader;
+
+    fn height(&self) -> Height {
+        Height::new(
+            ChainId::from_str(self.signed_header.header.chain_id.as_str())
+                .expect("Never fails")
+                .revision_number(),
+            self.signed_header.header.height.value(),
+        )
+        .expect("Never fails")
+    }
+
+    fn timestamp(&self) -> Timestamp {
+        self.signed_header.header.time.into()
+    }
+
+    fn into_header_with_trusted(self, trusted_block: &Self) -> Self::Header {
+        let mut header = TendermintHeader::from(self.clone());
+        header.set_trusted_height(trusted_block.height());
+        header.set_trusted_next_validators_set(trusted_block.validators.clone());
+        header
+    }
+}
+
+#[derive(Debug, TypedBuilder)]
+pub struct BlockParams {
+    pub validators: Vec<TestgenValidator>,
+    pub next_validators: Vec<TestgenValidator>,
+}
+
+impl BlockParams {
+    pub fn from_validator_history(validator_history: Vec<Vec<TestgenValidator>>) -> Vec<Self> {
+        validator_history
+            .windows(2)
+            .map(|vals| {
+                Self::builder()
+                    .validators(vals[0].clone())
+                    .next_validators(vals[1].clone())
+                    .build()
+            })
+            .collect()
+    }
+}
+
+impl Default for BlockParams {
+    fn default() -> Self {
+        Self::builder()
+            .validators(vec![
+                TestgenValidator::new("1").voting_power(50),
+                TestgenValidator::new("2").voting_power(50),
+            ])
+            .next_validators(vec![
+                TestgenValidator::new("1").voting_power(50),
+                TestgenValidator::new("2").voting_power(50),
+            ])
+            .build()
+    }
+}
+
+/// This wrapper type is needed to implement
+/// [`From`] traits [`Header`] to foreign types.
+#[derive(Debug, Clone)]
+pub struct TendermintHeader(Header);
+
+impl TendermintHeader {
+    pub fn set_trusted_height(&mut self, trusted_height: Height) {
+        self.0.trusted_height = trusted_height
+    }
+
+    pub fn set_trusted_next_validators_set(&mut self, trusted_next_validator_set: ValidatorSet) {
+        self.0.trusted_next_validator_set = trusted_next_validator_set
+    }
+
+    pub fn header(&self) -> &TmHeader {
+        &self.0.signed_header.header
+    }
+}
+
+impl TestHeader for TendermintHeader {
+    type ConsensusState = ConsensusState;
+
+    fn height(&self) -> Height {
+        Height::new(
+            ChainId::from_str(self.0.signed_header.header.chain_id.as_str())
+                .expect("Never fails")
+                .revision_number(),
+            self.0.signed_header.header.height.value(),
+        )
+        .expect("Never fails")
+    }
+
+    fn timestamp(&self) -> Timestamp {
+        self.0.signed_header.header.time.into()
+    }
+}
+
+impl From<TendermintHeader> for Header {
+    fn from(header: TendermintHeader) -> Self {
+        header.0
+    }
+}
+
+impl From<TendermintHeader> for ConsensusState {
+    fn from(header: TendermintHeader) -> Self {
+        header.0.signed_header.header.into()
+    }
+}
+
+impl From<TmLightBlock> for TendermintHeader {
+    fn from(block: TmLightBlock) -> Self {
+        let trusted_height = block.height();
+
+        let TmLightBlock {
+            signed_header,
+            validators: validator_set,
+            ..
+        } = block;
+
+        let trusted_next_validator_set = validator_set.clone();
+
+        // by default trust the current height and validators
+        Self(Header {
+            signed_header,
+            validator_set,
+            trusted_height,
+            trusted_next_validator_set,
+        })
+    }
+}
+
+impl From<TendermintHeader> for Any {
+    fn from(value: TendermintHeader) -> Self {
+        Self {
+            type_url: TENDERMINT_HEADER_TYPE_URL.to_string(),
+            value: RawHeader::from(value.0).to_vec(),
+        }
+    }
+}
diff --git a/ibc-testkit/src/lib.rs b/ibc-testkit/src/lib.rs
index b2f737471..f4326ba1d 100644
--- a/ibc-testkit/src/lib.rs
+++ b/ibc-testkit/src/lib.rs
@@ -15,7 +15,9 @@ extern crate alloc;
 #[cfg(feature = "std")]
 extern crate std;
 
+pub mod context;
 pub mod fixtures;
 pub mod hosts;
 pub mod relayer;
 pub mod testapp;
+pub mod utils;
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index 852f91bd3..232fb6074 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -1,231 +1,359 @@
-use ibc::core::client::context::ClientValidationContext;
-use ibc::core::client::types::Height;
-use ibc::core::handler::types::error::ContextError;
-use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::types::path::ChannelEndPath;
 use ibc::core::host::ValidationContext;
-use ibc::core::primitives::prelude::*;
-use ibc::core::primitives::Signer;
-
-use crate::testapp::ibc::clients::AnyClientState;
-use crate::testapp::ibc::core::types::MockContext;
-/// Trait capturing all dependencies (i.e., the context) which algorithms in ICS18 require to
-/// relay packets between chains. This trait comprises the dependencies towards a single chain.
-/// Most of the functions in this represent wrappers over the ABCI interface.
-/// This trait mimics the `Chain` trait, but at a lower level of abstraction (no networking, header
-/// types, light client, RPC client, etc.)
-pub trait RelayerContext {
-    /// Returns the latest height of the chain.
-    fn query_latest_height(&self) -> Result<Height, ContextError>;
-
-    /// Returns this client state for the given `client_id` on this chain.
-    /// Wrapper over the `/abci_query?path=..` endpoint.
-    fn query_client_full_state(&self, client_id: &ClientId) -> Option<AnyClientState>;
-
-    /// Temporary solution. Similar to `CosmosSDKChain::key_and_signer()` but simpler.
-    fn signer(&self) -> Signer;
+use ibc::primitives::Signer;
+
+use crate::context::TestContext;
+use crate::hosts::{HostClientState, TestHost};
+use crate::relayer::utils::TypedRelayerOps;
+use crate::testapp::ibc::core::types::DefaultIbcStore;
+
+/// A relayer context that allows interaction between two [`TestContext`] instances.
+pub struct RelayerContext<A, B>
+where
+    A: TestHost,
+    B: TestHost,
+    HostClientState<A>: ClientStateValidation<DefaultIbcStore>,
+    HostClientState<B>: ClientStateValidation<DefaultIbcStore>,
+{
+    ctx_a: TestContext<A>,
+    ctx_b: TestContext<B>,
 }
 
-impl RelayerContext for MockContext {
-    fn query_latest_height(&self) -> Result<Height, ContextError> {
-        ValidationContext::host_height(self)
+impl<A, B> RelayerContext<A, B>
+where
+    A: TestHost,
+    B: TestHost,
+    HostClientState<A>: ClientStateValidation<DefaultIbcStore>,
+    HostClientState<B>: ClientStateValidation<DefaultIbcStore>,
+{
+    /// Creates a new relayer context with the given [`TestContext`] instances.
+    pub fn new(ctx_a: TestContext<A>, ctx_b: TestContext<B>) -> Self {
+        Self { ctx_a, ctx_b }
     }
 
-    fn query_client_full_state(&self, client_id: &ClientId) -> Option<AnyClientState> {
-        // Forward call to Ics2.
-        self.client_state(client_id).ok()
+    /// Returns immutable reference to the first context.
+    pub fn get_ctx_a(&self) -> &TestContext<A> {
+        &self.ctx_a
     }
 
-    fn signer(&self) -> Signer {
-        "0CDA3F47EF3C4906693B170EF650EB968C5F4B2C"
-            .to_string()
-            .into()
+    /// Returns immutable reference to the second context.
+    pub fn get_ctx_b(&self) -> &TestContext<B> {
+        &self.ctx_b
     }
-}
 
-#[cfg(test)]
-mod tests {
-    use ibc::clients::tendermint::types::client_type as tm_client_type;
-    use ibc::core::client::context::client_state::ClientStateCommon;
-    use ibc::core::client::types::msgs::{ClientMsg, MsgUpdateClient};
-    use ibc::core::client::types::Height;
-    use ibc::core::handler::types::msgs::MsgEnvelope;
-    use ibc::core::host::types::identifiers::ChainId;
-    use ibc::core::primitives::prelude::*;
-    use tracing::debug;
-
-    use super::RelayerContext;
-    use crate::fixtures::core::context::MockContextConfig;
-    use crate::hosts::block::{HostBlock, HostType};
-    use crate::relayer::context::ClientId;
-    use crate::relayer::error::RelayerError;
-    use crate::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
-    use crate::testapp::ibc::core::router::MockRouter;
-    use crate::testapp::ibc::core::types::MockClientConfig;
-
-    /// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
-    /// context, assuming that the latest header on the source context is `src_header`.
-    pub(crate) fn build_client_update_datagram<Ctx>(
-        dest: &Ctx,
-        client_id: &ClientId,
-        src_header: &HostBlock,
-    ) -> Result<ClientMsg, RelayerError>
-    where
-        Ctx: RelayerContext,
-    {
-        // Check if client for ibc0 on ibc1 has been updated to latest height:
-        // - query client state on destination chain
-        let dest_client_state = dest.query_client_full_state(client_id).ok_or_else(|| {
-            RelayerError::ClientStateNotFound {
-                client_id: client_id.clone(),
-            }
-        })?;
-
-        let dest_client_latest_height = dest_client_state.latest_height();
-
-        if src_header.height() == dest_client_latest_height {
-            return Err(RelayerError::ClientAlreadyUpToDate {
-                client_id: client_id.clone(),
-                source_height: src_header.height(),
-                destination_height: dest_client_latest_height,
-            });
-        };
-
-        if dest_client_latest_height > src_header.height() {
-            return Err(RelayerError::ClientAtHigherHeight {
-                client_id: client_id.clone(),
-                source_height: src_header.height(),
-                destination_height: dest_client_latest_height,
-            });
-        };
-
-        // Client on destination chain can be updated.
-        Ok(ClientMsg::UpdateClient(MsgUpdateClient {
-            client_id: client_id.clone(),
-            client_message: (*src_header).clone().into(),
-            signer: dest.signer(),
-        }))
-    }
-
-    #[test]
-    /// Serves to test both ICS-26 `dispatch` & `build_client_update_datagram` functions.
-    /// Implements a "ping pong" of client update messages, so that two chains repeatedly
-    /// process a client update message and update their height in succession.
-    fn client_update_ping_pong() {
-        let chain_a_start_height = Height::new(1, 11).unwrap();
-        let chain_b_start_height = Height::new(1, 20).unwrap();
-        let client_on_b_for_a_height = Height::new(1, 10).unwrap(); // Should be smaller than `chain_a_start_height`
-        let client_on_a_for_b_height = Height::new(1, 20).unwrap(); // Should be smaller than `chain_b_start_height`
-        let num_iterations = 4;
-
-        let client_on_a_for_b = tm_client_type().build_client_id(0);
-        let client_on_b_for_a = mock_client_type().build_client_id(0);
-
-        let chain_id_a = ChainId::new("mockgaiaA-1").unwrap();
-        let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
-
-        // Create two mock contexts, one for each chain.
-        let mut ctx_a = MockContextConfig::builder()
-            .host_id(chain_id_a.clone())
-            .latest_height(chain_a_start_height)
-            .build()
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_b.clone())
-                    .client_id(client_on_a_for_b.clone())
-                    .latest_height(client_on_a_for_b_height)
-                    .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
-                    .build(),
-            );
-        // dummy; not actually used in client updates
-        let mut router_a = MockRouter::new_with_transfer();
-
-        let mut ctx_b = MockContextConfig::builder()
-            .host_id(chain_id_b)
-            .host_type(HostType::SyntheticTendermint)
-            .latest_height(chain_b_start_height)
-            .build()
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_chain_id(chain_id_a)
-                    .client_id(client_on_b_for_a.clone())
-                    .latest_height(client_on_b_for_a_height)
-                    .build(),
-            );
-        // dummy; not actually used in client updates
-        let mut router_b = MockRouter::new_with_transfer();
-
-        for _i in 0..num_iterations {
-            // Update client on chain B to latest height of A.
-            // - create the client update message with the latest header from A
-            let a_latest_header = ctx_a.query_latest_header().unwrap();
-            let client_msg_b_res =
-                build_client_update_datagram(&ctx_b, &client_on_b_for_a, &a_latest_header);
-
-            assert!(
-                client_msg_b_res.is_ok(),
-                "create_client_update failed for context destination {ctx_b:?}, error: {client_msg_b_res:?}",
-            );
-
-            let client_msg_b = client_msg_b_res.unwrap();
-
-            // - send the message to B. We bypass ICS18 interface and call directly into
-            // MockContext `recv` method (to avoid additional serialization steps).
-            let dispatch_res_b = ctx_b.deliver(&mut router_b, MsgEnvelope::Client(client_msg_b));
-            let validation_res = ctx_b.validate();
-            assert!(
-                validation_res.is_ok(),
-                "context validation failed with error {validation_res:?} for context {ctx_b:?}",
-            );
-
-            // Check if the update succeeded.
-            assert!(
-                dispatch_res_b.is_ok(),
-                "Dispatch failed for host chain b with error: {dispatch_res_b:?}"
-            );
-            let client_height_b = ctx_b
-                .query_client_full_state(&client_on_b_for_a)
-                .unwrap()
-                .latest_height();
-            assert_eq!(client_height_b, ctx_a.query_latest_height().unwrap());
-
-            // Update client on chain A to latest height of B.
-            // - create the client update message with the latest header from B
-            // The test uses LightClientBlock that does not store the trusted height
-            let mut b_latest_header = ctx_b.query_latest_header().unwrap();
-
-            let th = b_latest_header.height();
-            b_latest_header.set_trusted_height(th.decrement().unwrap());
-
-            let client_msg_a_res =
-                build_client_update_datagram(&ctx_a, &client_on_a_for_b, &b_latest_header);
-
-            assert!(
-                client_msg_a_res.is_ok(),
-                "create_client_update failed for context destination {ctx_a:?}, error: {client_msg_a_res:?}",
-            );
-
-            let client_msg_a = client_msg_a_res.unwrap();
-
-            debug!("client_msg_a = {:?}", client_msg_a);
-
-            // - send the message to A
-            let dispatch_res_a = ctx_a.deliver(&mut router_a, MsgEnvelope::Client(client_msg_a));
-            let validation_res = ctx_a.validate();
-            assert!(
-                validation_res.is_ok(),
-                "context validation failed with error {validation_res:?} for context {ctx_a:?}",
-            );
-
-            // Check if the update succeeded.
-            assert!(
-                dispatch_res_a.is_ok(),
-                "Dispatch failed for host chain a with error: {dispatch_res_a:?}"
-            );
-            let client_height_a = ctx_a
-                .query_client_full_state(&client_on_a_for_b)
-                .unwrap()
-                .latest_height();
-            assert_eq!(client_height_a, ctx_b.query_latest_height().unwrap());
-        }
+    /// Returns mutable reference to the first context.
+    pub fn get_ctx_a_mut(&mut self) -> &mut TestContext<A> {
+        &mut self.ctx_a
+    }
+
+    /// Returns mutable reference to the second context.
+    pub fn get_ctx_b_mut(&mut self) -> &mut TestContext<B> {
+        &mut self.ctx_b
+    }
+
+    /// Creates a light client of second context on the first context.
+    /// Returns the client identifier of the created client.
+    pub fn create_client_on_a(&mut self, signer: Signer) -> ClientId {
+        TypedRelayerOps::<A, B>::create_client_on_a(&mut self.ctx_a, &self.ctx_b, signer)
+    }
+
+    /// Creates a light client of first context on the second context.
+    /// Returns the client identifier of the created client.
+    pub fn create_client_on_b(&mut self, signer: Signer) -> ClientId {
+        TypedRelayerOps::<B, A>::create_client_on_a(&mut self.ctx_b, &self.ctx_a, signer)
+    }
+
+    /// Updates the client on the first context with the latest header of the second context.
+    pub fn update_client_on_a_with_sync(&mut self, client_id_on_a: ClientId, signer: Signer) {
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            client_id_on_a,
+            signer,
+        )
+    }
+
+    /// Updates the client on the second context with the latest header of the first context.
+    pub fn update_client_on_b_with_sync(&mut self, client_id_on_b: ClientId, signer: Signer) {
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            &mut self.ctx_b,
+            &mut self.ctx_a,
+            client_id_on_b,
+            signer,
+        )
+    }
+
+    /// Creates a connection between the two contexts starting from the first context.
+    /// Returns the connection identifiers of the created connection ends.
+    pub fn create_connection_on_a(
+        &mut self,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) -> (ConnectionId, ConnectionId) {
+        TypedRelayerOps::<A, B>::create_connection_on_a(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            client_id_on_a,
+            client_id_on_b,
+            signer,
+        )
+    }
+
+    /// Creates a connection between the two contexts starting from the second context.
+    /// Returns the connection identifiers of the created connection ends.
+    pub fn create_connection_on_b(
+        &mut self,
+        client_id_on_b: ClientId,
+        client_id_on_a: ClientId,
+        signer: Signer,
+    ) -> (ConnectionId, ConnectionId) {
+        TypedRelayerOps::<B, A>::create_connection_on_a(
+            &mut self.ctx_b,
+            &mut self.ctx_a,
+            client_id_on_b,
+            client_id_on_a,
+            signer,
+        )
+    }
+
+    /// Creates a channel between the two contexts starting from the first context.
+    /// Returns the channel identifiers of the created channel ends.
+    pub fn create_channel_on_a(
+        &mut self,
+        conn_id_on_a: ConnectionId,
+        port_id_on_a: PortId,
+        conn_id_on_b: ConnectionId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) -> (ChannelId, ChannelId) {
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<A, B>::create_channel_on_a(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            client_id_on_a,
+            conn_id_on_a,
+            port_id_on_a,
+            client_id_on_b,
+            conn_id_on_b,
+            port_id_on_b,
+            signer,
+        )
+    }
+
+    /// Creates a channel between the two contexts starting from the second context.
+    /// Returns the channel identifiers of the created channel ends.
+    pub fn create_channel_on_b(
+        &mut self,
+        conn_id_on_b: ConnectionId,
+        port_id_on_b: PortId,
+        conn_id_on_a: ConnectionId,
+        port_id_on_a: PortId,
+        signer: Signer,
+    ) -> (ChannelId, ChannelId) {
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<B, A>::create_channel_on_a(
+            &mut self.ctx_b,
+            &mut self.ctx_a,
+            client_id_on_b,
+            conn_id_on_b,
+            port_id_on_b,
+            client_id_on_a,
+            conn_id_on_a,
+            port_id_on_a,
+            signer,
+        )
+    }
+
+    /// Closes a channel between the two contexts starting from the first context.
+    pub fn close_channel_on_a(
+        &mut self,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        let conn_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(&port_id_on_a, &chan_id_on_a))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let conn_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(&port_id_on_b, &chan_id_on_b))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<A, B>::close_channel_on_a(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            client_id_on_a,
+            chan_id_on_a,
+            port_id_on_a,
+            client_id_on_b,
+            chan_id_on_b,
+            port_id_on_b,
+            signer,
+        )
+    }
+
+    /// Closes a channel between the two contexts starting from the second context.
+    pub fn close_channel_on_b(
+        &mut self,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        signer: Signer,
+    ) {
+        let conn_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(&port_id_on_b, &chan_id_on_b))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let conn_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(&port_id_on_a, &chan_id_on_a))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<B, A>::close_channel_on_a(
+            &mut self.ctx_b,
+            &mut self.ctx_a,
+            client_id_on_b,
+            chan_id_on_b,
+            port_id_on_b,
+            client_id_on_a,
+            chan_id_on_a,
+            port_id_on_a,
+            signer,
+        )
+    }
+
+    /// Sends a packet from the first context to the second context.
+    /// The IBC packet is created by an IBC application on the first context.
+    pub fn send_packet_on_a(&mut self, packet: Packet, signer: Signer) {
+        let conn_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_a,
+                &packet.chan_id_on_a,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let conn_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_b,
+                &packet.chan_id_on_b,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<A, B>::send_packet_on_a(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            packet,
+            client_id_on_a,
+            client_id_on_b,
+            signer,
+        )
     }
 }
diff --git a/ibc-testkit/src/relayer/integration.rs b/ibc-testkit/src/relayer/integration.rs
new file mode 100644
index 000000000..85df3cd9c
--- /dev/null
+++ b/ibc-testkit/src/relayer/integration.rs
@@ -0,0 +1,170 @@
+use core::str::FromStr;
+
+use ibc::apps::transfer::handler::send_transfer;
+use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
+use ibc::apps::transfer::types::packet::PacketData;
+use ibc::apps::transfer::types::PrefixedCoin;
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::handler::types::events::IbcEvent;
+use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
+use ibc::primitives::Timestamp;
+
+use crate::context::TestContext;
+use crate::fixtures::core::signer::dummy_account_id;
+use crate::hosts::{HostClientState, TestHost};
+use crate::relayer::context::RelayerContext;
+use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
+use crate::testapp::ibc::core::types::DefaultIbcStore;
+
+/// Integration test for IBC implementation.
+/// This test creates clients, connections, channels, and sends packets between two [`TestHost`]s.
+/// This uses [`DummyTransferModule`] to simulate the transfer of tokens between two contexts.
+pub fn ibc_integration_test<A, B>()
+where
+    A: TestHost,
+    B: TestHost,
+    HostClientState<A>: ClientStateValidation<DefaultIbcStore>,
+    HostClientState<B>: ClientStateValidation<DefaultIbcStore>,
+{
+    let ctx_a = TestContext::<A>::default();
+    let ctx_b = TestContext::<B>::default();
+
+    let signer = dummy_account_id();
+
+    let mut relayer = RelayerContext::new(ctx_a, ctx_b);
+
+    // client creation
+    let client_id_on_a = relayer.create_client_on_a(signer.clone());
+    let client_id_on_b = relayer.create_client_on_b(signer.clone());
+
+    // connection from A to B
+    let (conn_id_on_a, conn_id_on_b) = relayer.create_connection_on_a(
+        client_id_on_a.clone(),
+        client_id_on_b.clone(),
+        signer.clone(),
+    );
+
+    assert_eq!(conn_id_on_a, ConnectionId::new(0));
+    assert_eq!(conn_id_on_b, ConnectionId::new(0));
+
+    // connection from B to A
+    let (conn_id_on_b, conn_id_on_a) = relayer.create_connection_on_b(
+        client_id_on_b.clone(),
+        client_id_on_a.clone(),
+        signer.clone(),
+    );
+
+    assert_eq!(conn_id_on_a, ConnectionId::new(1));
+    assert_eq!(conn_id_on_b, ConnectionId::new(1));
+
+    // channel from A to B
+    let (chan_id_on_a, chan_id_on_b) = relayer.create_channel_on_a(
+        conn_id_on_a.clone(),
+        PortId::transfer(),
+        conn_id_on_b.clone(),
+        PortId::transfer(),
+        signer.clone(),
+    );
+
+    assert_eq!(chan_id_on_a, ChannelId::new(0));
+    assert_eq!(chan_id_on_b, ChannelId::new(0));
+
+    // close the channel from A to B
+    relayer.close_channel_on_a(
+        chan_id_on_a.clone(),
+        PortId::transfer(),
+        chan_id_on_b.clone(),
+        PortId::transfer(),
+        signer.clone(),
+    );
+
+    // channel from B to A
+    let (chan_id_on_b, chan_id_on_a) = relayer.create_channel_on_b(
+        conn_id_on_b,
+        PortId::transfer(),
+        conn_id_on_a,
+        PortId::transfer(),
+        signer.clone(),
+    );
+
+    assert_eq!(chan_id_on_a, ChannelId::new(1));
+    assert_eq!(chan_id_on_b, ChannelId::new(1));
+
+    // send packet from A to B
+
+    // generate packet for DummyTransferModule
+    let packet_data = PacketData {
+        token: PrefixedCoin::from_str("1000uibc").expect("valid prefixed coin"),
+        sender: signer.clone(),
+        receiver: signer.clone(),
+        memo: "sample memo".into(),
+    };
+
+    // packet with ibc metadata
+    // either height timeout or timestamp timeout must be set
+    let msg = MsgTransfer {
+        port_id_on_a: PortId::transfer(),
+        chan_id_on_a: chan_id_on_a.clone(),
+        packet_data,
+        // setting timeout height to 10 blocks from B's current height.
+        timeout_height_on_b: relayer.get_ctx_b().latest_height().add(10).into(),
+        // not setting timeout timestamp.
+        timeout_timestamp_on_b: Timestamp::none(),
+    };
+
+    // module creates the send_packet
+    send_transfer(
+        relayer.get_ctx_a_mut().ibc_store_mut(),
+        &mut DummyTransferModule,
+        msg,
+    )
+    .expect("successfully created send_packet");
+
+    // send_packet wasn't committed, hence produce a block
+    relayer.get_ctx_a_mut().advance_block_height();
+
+    // retrieve the send_packet event
+    let Some(IbcEvent::SendPacket(send_packet_event)) = relayer
+        .get_ctx_a()
+        .ibc_store()
+        .events
+        .lock()
+        .iter()
+        .rev()
+        .nth(2)
+        .cloned()
+    else {
+        panic!("unexpected event")
+    };
+
+    // create the IBC packet type
+    let packet = Packet {
+        port_id_on_a: send_packet_event.port_id_on_a().clone(),
+        chan_id_on_a: send_packet_event.chan_id_on_a().clone(),
+        seq_on_a: *send_packet_event.seq_on_a(),
+        data: send_packet_event.packet_data().to_vec(),
+        timeout_height_on_b: *send_packet_event.timeout_height_on_b(),
+        timeout_timestamp_on_b: *send_packet_event.timeout_timestamp_on_b(),
+        port_id_on_b: send_packet_event.port_id_on_b().clone(),
+        chan_id_on_b: send_packet_event.chan_id_on_b().clone(),
+    };
+
+    // continue packet relay starting from recv_packet at B
+    relayer.send_packet_on_a(packet, signer);
+}
+
+#[cfg(test)]
+mod tests {
+    use super::*;
+    use crate::hosts::{MockHost, TendermintHost};
+
+    // tests among all the `TestHost` implementations
+    #[test]
+    fn ibc_integration_test_for_all_pairs() {
+        ibc_integration_test::<MockHost, MockHost>();
+        ibc_integration_test::<MockHost, TendermintHost>();
+        ibc_integration_test::<TendermintHost, MockHost>();
+        ibc_integration_test::<TendermintHost, TendermintHost>();
+    }
+}
diff --git a/ibc-testkit/src/relayer/mod.rs b/ibc-testkit/src/relayer/mod.rs
index c2c641829..5c70430ef 100644
--- a/ibc-testkit/src/relayer/mod.rs
+++ b/ibc-testkit/src/relayer/mod.rs
@@ -1,2 +1,7 @@
 pub mod context;
 pub mod error;
+pub mod utils;
+
+// `ibc::apps::transfer::handler::send_transfer` requires `serde`
+#[cfg(feature = "serde")]
+pub mod integration;
diff --git a/ibc-testkit/src/relayer/utils.rs b/ibc-testkit/src/relayer/utils.rs
new file mode 100644
index 000000000..9d4c96bd6
--- /dev/null
+++ b/ibc-testkit/src/relayer/utils.rs
@@ -0,0 +1,1001 @@
+use alloc::string::String;
+use core::marker::PhantomData;
+use core::time::Duration;
+
+use ibc::core::channel::types::acknowledgement::Acknowledgement;
+use ibc::core::channel::types::channel::Order;
+use ibc::core::channel::types::msgs::{
+    ChannelMsg, MsgAcknowledgement, MsgChannelCloseConfirm, MsgChannelCloseInit, MsgChannelOpenAck,
+    MsgChannelOpenConfirm, MsgChannelOpenInit, MsgChannelOpenTry, MsgRecvPacket, MsgTimeout,
+    MsgTimeoutOnClose, PacketMsg,
+};
+use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::Version as ChannelVersion;
+use ibc::core::client::context::client_state::ClientStateValidation;
+use ibc::core::client::context::ClientValidationContext;
+use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient, MsgUpdateClient};
+use ibc::core::connection::types::msgs::{
+    ConnectionMsg, MsgConnectionOpenAck, MsgConnectionOpenConfirm, MsgConnectionOpenInit,
+    MsgConnectionOpenTry,
+};
+use ibc::core::connection::types::version::Version as ConnectionVersion;
+use ibc::core::connection::types::Counterparty as ConnectionCounterParty;
+use ibc::core::handler::types::events::IbcEvent;
+use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
+use ibc::core::host::types::path::{
+    AckPath, ChannelEndPath, ClientConsensusStatePath, ClientStatePath, CommitmentPath,
+    ConnectionPath, ReceiptPath,
+};
+use ibc::core::host::ValidationContext;
+use ibc::primitives::Signer;
+use ibc_query::core::context::ProvableContext;
+
+use crate::context::TestContext;
+use crate::hosts::{HostClientState, TestBlock, TestHost};
+use crate::testapp::ibc::core::types::{DefaultIbcStore, LightClientBuilder, LightClientState};
+
+/// Implements IBC relayer functions for a pair of [`TestHost`] implementations: `A` and `B`.
+/// Note that, all the implementations are in one direction: from `A` to `B`.
+/// This ensures that the variable namings are consistent with the IBC message fields,
+/// leading to a less error-prone implementation.
+///
+/// For the functions in the opposite direction, use `TypedRelayerOps::<B, A>` instead of TypedRelayerOps::<A, B>`.
+#[derive(Debug, Default)]
+pub struct TypedRelayerOps<A, B>(PhantomData<A>, PhantomData<B>)
+where
+    A: TestHost,
+    B: TestHost,
+    HostClientState<A>: ClientStateValidation<DefaultIbcStore>,
+    HostClientState<B>: ClientStateValidation<DefaultIbcStore>;
+
+impl<A, B> TypedRelayerOps<A, B>
+where
+    A: TestHost,
+    B: TestHost,
+    HostClientState<A>: ClientStateValidation<DefaultIbcStore>,
+    HostClientState<B>: ClientStateValidation<DefaultIbcStore>,
+{
+    /// Creates a client on `A` with the state of `B`.
+    /// Returns the client identifier on `A`.
+    pub fn create_client_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        signer: Signer,
+    ) -> ClientId {
+        let light_client_of_b = LightClientBuilder::init()
+            .context(ctx_b)
+            .build::<LightClientState<B>>();
+
+        let msg_for_a = MsgEnvelope::Client(ClientMsg::CreateClient(MsgCreateClient {
+            client_state: light_client_of_b.client_state.into(),
+            consensus_state: light_client_of_b
+                .consensus_states
+                .values()
+                .next()
+                .expect("at least one")
+                .clone()
+                .into(),
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::CreateClient(create_client_b_event)) =
+            ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        let client_id_on_a = create_client_b_event.client_id().clone();
+
+        assert_eq!(
+            ValidationContext::get_client_validation_context(ctx_a.ibc_store())
+                .client_state(&client_id_on_a)
+                .expect("client state exists")
+                .latest_height(),
+            ctx_b.latest_height()
+        );
+
+        client_id_on_a
+    }
+
+    /// Advances the block height on `A` until it catches up with the latest timestamp on `B`.
+    pub fn sync_clock_on_a(ctx_a: &mut TestContext<A>, ctx_b: &TestContext<B>) {
+        while ctx_b.latest_timestamp() > ctx_a.latest_timestamp() {
+            ctx_a.advance_block_height();
+        }
+    }
+
+    /// Updates the client on `A` with the latest header from `B`.
+    pub fn update_client_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        client_id_on_a: ClientId,
+        signer: Signer,
+    ) {
+        let trusted_height_of_b = ctx_a
+            .ibc_store()
+            .get_client_validation_context()
+            .client_state(&client_id_on_a)
+            .expect("client state exists")
+            .latest_height();
+
+        let trusted_block_of_b = ctx_b
+            .host
+            .get_block(&trusted_height_of_b)
+            .expect("block exists");
+
+        let target_height_of_b = ctx_b.latest_height();
+
+        let target_block_of_b = ctx_b.host_block(&target_height_of_b).expect("block exists");
+
+        let msg_for_a = MsgEnvelope::Client(ClientMsg::UpdateClient(MsgUpdateClient {
+            client_id: client_id_on_a.clone(),
+            client_message: target_block_of_b
+                .into_header_with_trusted(&trusted_block_of_b)
+                .into(),
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::UpdateClient(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// Updates the client on `A` with the latest header from `B` after syncing the timestamps.
+    ///
+    /// Timestamp sync is required, as IBC doesn't allow client updates from the future beyond max clock drift.
+    pub fn update_client_on_a_with_sync(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        client_id_on_a: ClientId,
+        signer: Signer,
+    ) {
+        TypedRelayerOps::<A, B>::sync_clock_on_a(ctx_a, ctx_b);
+        TypedRelayerOps::<A, B>::update_client_on_a(ctx_a, ctx_b, client_id_on_a, signer);
+    }
+
+    /// `A` initiates a connection with the other end on `B`.
+    /// Returns the connection identifier on `A`.
+    pub fn connection_open_init_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) -> ConnectionId {
+        let counterparty_b = ConnectionCounterParty::new(
+            client_id_on_b.clone(),
+            None,
+            ctx_b.ibc_store().commitment_prefix(),
+        );
+
+        let msg_for_a = MsgEnvelope::Connection(ConnectionMsg::OpenInit(MsgConnectionOpenInit {
+            client_id_on_a: client_id_on_a.clone(),
+            counterparty: counterparty_b,
+            version: None,
+            delay_period: Duration::from_secs(0),
+            signer: signer.clone(),
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::OpenInitConnection(open_init_connection_event)) =
+            ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        open_init_connection_event.conn_id_on_a().clone()
+    }
+
+    /// `B` receives the connection opening attempt by `A` after `A` initiates the connection.
+    /// Returns the connection identifier on `B`.
+    pub fn connection_open_try_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        conn_id_on_a: ConnectionId,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) -> ConnectionId {
+        let proofs_height_on_a = ctx_a.latest_height();
+
+        let client_state_of_b_on_a = ctx_a
+            .ibc_store()
+            .client_state(&client_id_on_a)
+            .expect("client state exists");
+
+        let consensus_height_of_b_on_a = client_state_of_b_on_a.latest_height();
+
+        let counterparty_a = ConnectionCounterParty::new(
+            client_id_on_a.clone(),
+            Some(conn_id_on_a.clone()),
+            ctx_a.ibc_store().commitment_prefix(),
+        );
+
+        let proof_conn_end_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_a,
+                &ConnectionPath::new(&conn_id_on_a).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let proof_client_state_of_b_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_a,
+                &ClientStatePath::new(client_id_on_a.clone()).into(),
+            )
+            .expect("client state exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let proof_consensus_state_of_b_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_a,
+                &ClientConsensusStatePath::new(
+                    client_id_on_a.clone(),
+                    consensus_height_of_b_on_a.revision_number(),
+                    consensus_height_of_b_on_a.revision_height(),
+                )
+                .into(),
+            )
+            .expect("consensus state exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        #[allow(deprecated)]
+        let msg_for_b = MsgEnvelope::Connection(ConnectionMsg::OpenTry(MsgConnectionOpenTry {
+            client_id_on_b: client_id_on_b.clone(),
+            client_state_of_b_on_a: client_state_of_b_on_a.into(),
+            counterparty: counterparty_a,
+            versions_on_a: ConnectionVersion::compatibles(),
+            proof_conn_end_on_a,
+            proof_client_state_of_b_on_a,
+            proof_consensus_state_of_b_on_a,
+            proofs_height_on_a,
+            consensus_height_of_b_on_a,
+            delay_period: Duration::from_secs(0),
+            signer: signer.clone(),
+            proof_consensus_state_of_b: None,
+            // deprecated
+            previous_connection_id: String::new(),
+        }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::OpenTryConnection(open_try_connection_event)) =
+            ctx_b.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        open_try_connection_event.conn_id_on_b().clone()
+    }
+
+    /// `A` receives `B`'s acknowledgement that `B` received the connection opening attempt by `A`.
+    /// `A` starts processing the connection on its side.
+    pub fn connection_open_ack_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        conn_id_on_a: ConnectionId,
+        conn_id_on_b: ConnectionId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) {
+        let proofs_height_on_b = ctx_b.latest_height();
+
+        let client_state_of_a_on_b = ctx_b
+            .ibc_store()
+            .client_state(&client_id_on_b)
+            .expect("client state exists");
+
+        let consensus_height_of_a_on_b = client_state_of_a_on_b.latest_height();
+
+        let proof_conn_end_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_b,
+                &ConnectionPath::new(&conn_id_on_b).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let proof_client_state_of_a_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_b,
+                &ClientStatePath::new(client_id_on_b.clone()).into(),
+            )
+            .expect("client state exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let proof_consensus_state_of_a_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proofs_height_on_b,
+                &ClientConsensusStatePath::new(
+                    client_id_on_b.clone(),
+                    consensus_height_of_a_on_b.revision_number(),
+                    consensus_height_of_a_on_b.revision_height(),
+                )
+                .into(),
+            )
+            .expect("consensus state exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_a = MsgEnvelope::Connection(ConnectionMsg::OpenAck(MsgConnectionOpenAck {
+            conn_id_on_a: conn_id_on_a.clone(),
+            conn_id_on_b: conn_id_on_b.clone(),
+            client_state_of_a_on_b: client_state_of_a_on_b.into(),
+            proof_conn_end_on_b,
+            proof_client_state_of_a_on_b,
+            proof_consensus_state_of_a_on_b,
+            proofs_height_on_b,
+            consensus_height_of_a_on_b,
+            version: ConnectionVersion::compatibles()[0].clone(),
+            signer: signer.clone(),
+            proof_consensus_state_of_a: None,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::OpenAckConnection(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `B` receives the confirmation from `A` that the connection creation was successful.
+    /// `B` also starts processing the connection on its side.
+    pub fn connection_open_confirm_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        conn_id_on_a: ConnectionId,
+        conn_id_on_b: ConnectionId,
+        signer: Signer,
+    ) {
+        let proof_height_on_a = ctx_a.latest_height();
+
+        let proof_conn_end_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proof_height_on_a,
+                &ConnectionPath::new(&conn_id_on_a).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_b =
+            MsgEnvelope::Connection(ConnectionMsg::OpenConfirm(MsgConnectionOpenConfirm {
+                conn_id_on_b: conn_id_on_b.clone(),
+                proof_conn_end_on_a,
+                proof_height_on_a,
+                signer: signer.clone(),
+            }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::OpenConfirmConnection(_)) = ctx_b.ibc_store().events.lock().last()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// A connection is created by `A` towards `B` using the IBC connection handshake protocol.
+    /// Returns the connection identifiers of `A` and `B`.
+    pub fn create_connection_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) -> (ConnectionId, ConnectionId) {
+        let conn_id_on_a = TypedRelayerOps::<A, B>::connection_open_init_on_a(
+            ctx_a,
+            ctx_b,
+            client_id_on_a.clone(),
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        let conn_id_on_b = TypedRelayerOps::<A, B>::connection_open_try_on_b(
+            ctx_b,
+            ctx_a,
+            conn_id_on_a.clone(),
+            client_id_on_a.clone(),
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(
+            ctx_a,
+            ctx_b,
+            client_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::connection_open_ack_on_a(
+            ctx_a,
+            ctx_b,
+            conn_id_on_a.clone(),
+            conn_id_on_b.clone(),
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::connection_open_confirm_on_b(
+            ctx_b,
+            ctx_a,
+            conn_id_on_b.clone(),
+            conn_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(ctx_a, ctx_b, client_id_on_a, signer);
+
+        (conn_id_on_a, conn_id_on_b)
+    }
+
+    /// `A` initiates a channel with port identifier with the other end on `B`.
+    /// Returns the channel identifier of `A`.
+    pub fn channel_open_init_on_a(
+        ctx_a: &mut TestContext<A>,
+        conn_id_on_a: ConnectionId,
+        port_id_on_a: PortId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) -> ChannelId {
+        let msg_for_a = MsgEnvelope::Channel(ChannelMsg::OpenInit(MsgChannelOpenInit {
+            port_id_on_a,
+            connection_hops_on_a: [conn_id_on_a].to_vec(),
+            port_id_on_b,
+            ordering: Order::Unordered,
+            signer,
+            version_proposal: ChannelVersion::empty(),
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::OpenInitChannel(open_init_channel_event)) =
+            ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        open_init_channel_event.chan_id_on_a().clone()
+    }
+
+    /// `B` receives the channel opening attempt by `A` after `A` initiates the channel.
+    /// Returns the channel identifier of `B`.
+    pub fn channel_open_try_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        conn_id_on_b: ConnectionId,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        signer: Signer,
+    ) -> ChannelId {
+        let proof_height_on_a = ctx_a.latest_height();
+
+        let proof_chan_end_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proof_height_on_a,
+                &ChannelEndPath::new(&port_id_on_a, &chan_id_on_a).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        #[allow(deprecated)]
+        let msg_for_b = MsgEnvelope::Channel(ChannelMsg::OpenTry(MsgChannelOpenTry {
+            port_id_on_b: PortId::transfer(),
+            connection_hops_on_b: [conn_id_on_b].to_vec(),
+            port_id_on_a: PortId::transfer(),
+            chan_id_on_a,
+            version_supported_on_a: ChannelVersion::empty(),
+            proof_chan_end_on_a,
+            proof_height_on_a,
+            ordering: Order::Unordered,
+            signer,
+
+            version_proposal: ChannelVersion::empty(),
+        }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::OpenTryChannel(open_try_channel_event)) =
+            ctx_b.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        open_try_channel_event.chan_id_on_b().clone()
+    }
+
+    /// `A` receives `B`'s acknowledgement that `B` received the channel opening attempt by `A`.
+    /// `A` starts processing the channel on its side.
+    pub fn channel_open_ack_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        let proof_height_on_b = ctx_b.latest_height();
+
+        let proof_chan_end_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proof_height_on_b,
+                &ChannelEndPath::new(&port_id_on_b, &chan_id_on_b).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_a = MsgEnvelope::Channel(ChannelMsg::OpenAck(MsgChannelOpenAck {
+            port_id_on_a,
+            chan_id_on_a,
+            chan_id_on_b,
+            version_on_b: ChannelVersion::empty(),
+            proof_chan_end_on_b,
+            proof_height_on_b,
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::OpenAckChannel(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `B` receives the confirmation from `A` that the channel creation was successful.
+    /// `B` also starts processing the channel on its side.
+    pub fn channel_open_confirm_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        chan_id_on_a: ChannelId,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        let proof_height_on_a = ctx_a.latest_height();
+
+        let proof_chan_end_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proof_height_on_a,
+                &ChannelEndPath::new(&PortId::transfer(), &chan_id_on_a).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_b = MsgEnvelope::Channel(ChannelMsg::OpenConfirm(MsgChannelOpenConfirm {
+            port_id_on_b,
+            chan_id_on_b,
+            proof_chan_end_on_a,
+            proof_height_on_a,
+            signer,
+        }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::OpenConfirmChannel(_)) = ctx_b.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `A` initiates the channel closing with the other end on `B`.
+    /// `A` stops processing the channel.
+    pub fn channel_close_init_on_a(
+        ctx_a: &mut TestContext<A>,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        signer: Signer,
+    ) {
+        let msg_for_a = MsgEnvelope::Channel(ChannelMsg::CloseInit(MsgChannelCloseInit {
+            port_id_on_a,
+            chan_id_on_a,
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::CloseInitChannel(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `B` receives the channel closing attempt by `A` after `A` initiates the channel closing.
+    /// `B` also stops processing the channel.
+    pub fn channel_close_confirm_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        let proof_height_on_a = ctx_a.latest_height();
+
+        let proof_chan_end_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proof_height_on_a,
+                &ChannelEndPath::new(&PortId::transfer(), &chan_id_on_b).into(),
+            )
+            .expect("connection end exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_b = MsgEnvelope::Channel(ChannelMsg::CloseConfirm(MsgChannelCloseConfirm {
+            port_id_on_b,
+            chan_id_on_b,
+            proof_chan_end_on_a,
+            proof_height_on_a,
+            signer,
+        }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::CloseConfirmChannel(_)) =
+            ctx_b.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// A channel is created by `A` towards `B` using the IBC channel handshake protocol.
+    /// Returns the channel identifiers of `A` and `B`.
+    #[allow(clippy::too_many_arguments)]
+    pub fn create_channel_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        client_id_on_a: ClientId,
+        conn_id_on_a: ConnectionId,
+        port_id_on_a: PortId,
+        client_id_on_b: ClientId,
+        conn_id_on_b: ConnectionId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) -> (ChannelId, ChannelId) {
+        let chan_id_on_a = TypedRelayerOps::<A, B>::channel_open_init_on_a(
+            ctx_a,
+            conn_id_on_a.clone(),
+            port_id_on_a.clone(),
+            port_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        let chan_id_on_b = TypedRelayerOps::<A, B>::channel_open_try_on_b(
+            ctx_b,
+            ctx_a,
+            conn_id_on_b.clone(),
+            chan_id_on_a.clone(),
+            port_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(
+            ctx_a,
+            ctx_b,
+            client_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::channel_open_ack_on_a(
+            ctx_a,
+            ctx_b,
+            chan_id_on_a.clone(),
+            port_id_on_a.clone(),
+            chan_id_on_b.clone(),
+            port_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::channel_open_confirm_on_b(
+            ctx_b,
+            ctx_a,
+            chan_id_on_a.clone(),
+            chan_id_on_b.clone(),
+            port_id_on_b,
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(ctx_a, ctx_b, client_id_on_a, signer);
+
+        (chan_id_on_a, chan_id_on_b)
+    }
+
+    /// A channel is closed by `A` towards `B` using the IBC channel handshake protocol.
+    #[allow(clippy::too_many_arguments)]
+    pub fn close_channel_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        client_id_on_a: ClientId,
+        chan_id_on_a: ChannelId,
+        port_id_on_a: PortId,
+        client_id_on_b: ClientId,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        TypedRelayerOps::<A, B>::channel_close_init_on_a(
+            ctx_a,
+            chan_id_on_a.clone(),
+            port_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b,
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::channel_close_confirm_on_b(
+            ctx_b,
+            ctx_a,
+            chan_id_on_b,
+            port_id_on_b,
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(ctx_a, ctx_b, client_id_on_a, signer);
+    }
+
+    /// `B` receives a packet from an IBC module on `A`.
+    /// Returns `B`'s acknowledgement of receipt.
+    pub fn packet_recv_on_b(
+        ctx_b: &mut TestContext<B>,
+        ctx_a: &TestContext<A>,
+        packet: Packet,
+        signer: Signer,
+    ) -> Acknowledgement {
+        let proof_height_on_a = ctx_a.latest_height();
+
+        let proof_commitment_on_a = ctx_a
+            .ibc_store()
+            .get_proof(
+                proof_height_on_a,
+                &CommitmentPath::new(&packet.port_id_on_a, &packet.chan_id_on_a, packet.seq_on_a)
+                    .into(),
+            )
+            .expect("commitment proof exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_b = MsgEnvelope::Packet(PacketMsg::Recv(MsgRecvPacket {
+            packet,
+            proof_commitment_on_a,
+            proof_height_on_a,
+            signer,
+        }));
+
+        ctx_b.deliver(msg_for_b).expect("success");
+
+        let Some(IbcEvent::WriteAcknowledgement(write_ack_event)) =
+            ctx_b.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        write_ack_event.acknowledgement().clone()
+    }
+
+    /// `A` receives the acknowledgement from `B` that `B` received the packet from `A`.
+    pub fn packet_ack_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        packet: Packet,
+        acknowledgement: Acknowledgement,
+        signer: Signer,
+    ) {
+        let proof_height_on_b = ctx_b.latest_height();
+
+        let proof_acked_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proof_height_on_b,
+                &AckPath::new(&packet.port_id_on_b, &packet.chan_id_on_b, packet.seq_on_a).into(),
+            )
+            .expect("acknowledgement proof exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_a = MsgEnvelope::Packet(PacketMsg::Ack(MsgAcknowledgement {
+            packet,
+            acknowledgement,
+            proof_acked_on_b,
+            proof_height_on_b,
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::AcknowledgePacket(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `A` receives the timeout packet from `B`.
+    /// That is, `B` has not received the packet from `A` within the timeout period.
+    pub fn packet_timeout_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        packet: Packet,
+        signer: Signer,
+    ) {
+        let proof_height_on_b = ctx_b.latest_height();
+
+        let proof_unreceived_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proof_height_on_b,
+                &ReceiptPath::new(&packet.port_id_on_b, &packet.chan_id_on_b, packet.seq_on_a)
+                    .into(),
+            )
+            .expect("non-membership receipt proof exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_a = MsgEnvelope::Packet(PacketMsg::Timeout(MsgTimeout {
+            next_seq_recv_on_b: packet.seq_on_a,
+            packet,
+            proof_unreceived_on_b,
+            proof_height_on_b,
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::TimeoutPacket(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// `A` receives the timeout packet from `B` after closing the channel.
+    /// That is, `B` has not received the packet from `A` because the channel is closed.
+    pub fn packet_timeout_on_close_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &TestContext<B>,
+        packet: Packet,
+        chan_id_on_b: ChannelId,
+        port_id_on_b: PortId,
+        signer: Signer,
+    ) {
+        let proof_height_on_b = ctx_b.latest_height();
+
+        let proof_unreceived_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proof_height_on_b,
+                &ReceiptPath::new(&port_id_on_b, &chan_id_on_b, packet.seq_on_a).into(),
+            )
+            .expect("non-membership receipt proof")
+            .try_into()
+            .expect("value merkle proof");
+
+        let proof_close_on_b = ctx_b
+            .ibc_store()
+            .get_proof(
+                proof_height_on_b,
+                &ChannelEndPath::new(&port_id_on_b, &chan_id_on_b).into(),
+            )
+            .expect("channel end data exists")
+            .try_into()
+            .expect("value merkle proof");
+
+        let msg_for_a = MsgEnvelope::Packet(PacketMsg::TimeoutOnClose(MsgTimeoutOnClose {
+            next_seq_recv_on_b: packet.seq_on_a,
+            packet,
+            proof_unreceived_on_b,
+            proof_close_on_b,
+            proof_height_on_b,
+            signer,
+        }));
+
+        ctx_a.deliver(msg_for_a).expect("success");
+
+        let Some(IbcEvent::ChannelClosed(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        else {
+            panic!("unexpected event")
+        };
+    }
+
+    /// Sends a packet from an IBC application on `A` to `B` using the IBC packet relay protocol.
+    pub fn send_packet_on_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        packet: Packet,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) {
+        // packet is passed from module
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        let acknowledgement =
+            TypedRelayerOps::<A, B>::packet_recv_on_b(ctx_b, ctx_a, packet.clone(), signer.clone());
+
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(
+            ctx_a,
+            ctx_b,
+            client_id_on_a,
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<A, B>::packet_ack_on_a(
+            ctx_a,
+            ctx_b,
+            packet,
+            acknowledgement,
+            signer.clone(),
+        );
+
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b,
+            signer.clone(),
+        );
+    }
+}
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
index c46c81343..4352ac22f 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/client_state.rs
@@ -44,7 +44,7 @@ impl MockClientState {
     pub fn new(header: MockHeader) -> Self {
         Self {
             header,
-            trusting_period: Duration::from_secs(10),
+            trusting_period: Duration::from_secs(64000),
             frozen: false,
         }
     }
@@ -108,13 +108,13 @@ impl TryFrom<RawMockClientState> for MockClientState {
 
 impl From<MockClientState> for RawMockClientState {
     fn from(value: MockClientState) -> Self {
-        RawMockClientState {
+        Self {
             header: Some(value.header.into()),
             trusting_period: value
                 .trusting_period
                 .as_nanos()
                 .try_into()
-                .expect("no error"),
+                .expect("no overflow"),
             frozen: value.frozen,
         }
     }
@@ -144,23 +144,13 @@ impl TryFrom<Any> for MockClientState {
 
 impl From<MockClientState> for Any {
     fn from(client_state: MockClientState) -> Self {
-        Any {
+        Self {
             type_url: MOCK_CLIENT_STATE_TYPE_URL.to_string(),
             value: Protobuf::<RawMockClientState>::encode_vec(client_state),
         }
     }
 }
 
-pub trait ConsensusStateConverter:
-    TryInto<MockConsensusState, Error = ClientError> + From<MockConsensusState>
-{
-}
-
-impl<C> ConsensusStateConverter for C where
-    C: TryInto<MockConsensusState, Error = ClientError> + From<MockConsensusState>
-{
-}
-
 pub trait MockClientContext {
     /// Returns the current timestamp of the local chain.
     fn host_timestamp(&self) -> Result<Timestamp, ContextError>;
@@ -202,7 +192,7 @@ impl ClientStateCommon for MockClientState {
         _proof_upgrade_consensus_state: CommitmentProofBytes,
         _root: &CommitmentRoot,
     ) -> Result<(), ClientError> {
-        let upgraded_mock_client_state = MockClientState::try_from(upgraded_client_state)?;
+        let upgraded_mock_client_state = Self::try_from(upgraded_client_state)?;
         MockConsensusState::try_from(upgraded_consensus_state)?;
         if self.latest_height() >= upgraded_mock_client_state.latest_height() {
             return Err(UpgradeClientError::LowUpgradeHeight {
@@ -238,7 +228,8 @@ impl ClientStateCommon for MockClientState {
 impl<V> ClientStateValidation<V> for MockClientState
 where
     V: ClientValidationContext + MockClientContext,
-    V::ConsensusStateRef: ConsensusStateConverter,
+    MockConsensusState: Convertible<V::ConsensusStateRef>,
+    <MockConsensusState as TryFrom<V::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     fn verify_client_message(
         &self,
@@ -288,13 +279,13 @@ where
             return Ok(Status::Frozen);
         }
 
-        let latest_consensus_state = {
+        let latest_consensus_state: MockConsensusState = {
             match ctx.consensus_state(&ClientConsensusStatePath::new(
                 client_id.clone(),
                 self.latest_height().revision_number(),
                 self.latest_height().revision_height(),
             )) {
-                Ok(cs) => cs.try_into()?,
+                Ok(cs) => cs.try_into().map_err(Into::into)?,
                 // if the client state does not have an associated consensus state for its latest height
                 // then it must be expired
                 Err(_) => return Ok(Status::Expired),
@@ -323,8 +314,9 @@ where
 impl<E> ClientStateExecution<E> for MockClientState
 where
     E: ClientExecutionContext + MockClientContext,
-    E::ClientStateRef: From<MockClientState>,
-    E::ConsensusStateRef: ConsensusStateConverter,
+    E::ClientStateRef: From<Self>,
+    MockConsensusState: Convertible<E::ConsensusStateRef>,
+    <MockConsensusState as TryFrom<E::ConsensusStateRef>>::Error: Into<ClientError>,
 {
     fn initialise(
         &self,
@@ -332,7 +324,7 @@ where
         client_id: &ClientId,
         consensus_state: Any,
     ) -> Result<(), ClientError> {
-        let mock_consensus_state = MockConsensusState::try_from(consensus_state)?;
+        let mock_consensus_state: MockConsensusState = consensus_state.try_into()?;
 
         ctx.store_client_state(ClientStatePath::new(client_id.clone()), (*self).into())?;
         ctx.store_consensus_state(
@@ -362,7 +354,7 @@ where
         let header = MockHeader::try_from(header)?;
         let header_height = header.height;
 
-        let new_client_state = MockClientState::new(header);
+        let new_client_state = Self::new(header);
         let new_consensus_state = MockConsensusState::new(header);
 
         ctx.store_consensus_state(
@@ -410,8 +402,8 @@ where
         upgraded_client_state: Any,
         upgraded_consensus_state: Any,
     ) -> Result<Height, ClientError> {
-        let new_client_state = MockClientState::try_from(upgraded_client_state)?;
-        let new_consensus_state = MockConsensusState::try_from(upgraded_consensus_state)?;
+        let new_client_state = Self::try_from(upgraded_client_state)?;
+        let new_consensus_state: MockConsensusState = upgraded_consensus_state.try_into()?;
 
         let latest_height = new_client_state.latest_height();
 
@@ -460,7 +452,7 @@ where
         let host_timestamp = ctx.host_timestamp()?;
         let host_height = ctx.host_height()?;
 
-        let mock_consensus_state = MockConsensusState::try_from(substitute_consensus_state)?;
+        let mock_consensus_state: MockConsensusState = substitute_consensus_state.try_into()?;
 
         ctx.store_consensus_state(
             ClientConsensusStatePath::new(
@@ -503,7 +495,7 @@ mod test {
         use super::{MockClientState, MockHeader};
 
         let client_state = MockClientState::new(MockHeader::default());
-        let expected = r#"{"typeUrl":"/ibc.mock.ClientState","value":"CgQKAhABEIDIr6Al"}"#;
+        let expected = r#"{"typeUrl":"/ibc.mock.ClientState","value":"CgQKAhABEICAkMrSxg4="}"#;
         let json = serde_json::to_string(&Any::from(client_state)).unwrap();
         assert_eq!(json, expected);
 
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
index dec5e9431..c637d26e5 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/consensus_state.rs
@@ -6,9 +6,7 @@ use ibc::core::primitives::Timestamp;
 use ibc::primitives::proto::{Any, Protobuf};
 
 use crate::testapp::ibc::clients::mock::header::MockHeader;
-use crate::testapp::ibc::clients::mock::proto::{
-    ConsensusState as RawMockConsensusState, Header as RawMockHeader,
-};
+use crate::testapp::ibc::clients::mock::proto::ConsensusState as RawMockConsensusState;
 pub const MOCK_CONSENSUS_STATE_TYPE_URL: &str = "/ibc.mock.ConsensusState";
 
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
@@ -20,7 +18,7 @@ pub struct MockConsensusState {
 
 impl MockConsensusState {
     pub fn new(header: MockHeader) -> Self {
-        MockConsensusState {
+        Self {
             header,
             root: CommitmentRoot::from(vec![0]),
         }
@@ -40,7 +38,7 @@ impl TryFrom<RawMockConsensusState> for MockConsensusState {
         let raw_header = raw.header.ok_or(ClientError::MissingRawConsensusState)?;
 
         Ok(Self {
-            header: MockHeader::try_from(raw_header)?,
+            header: raw_header.try_into()?,
             root: CommitmentRoot::from(vec![0]),
         })
     }
@@ -48,11 +46,8 @@ impl TryFrom<RawMockConsensusState> for MockConsensusState {
 
 impl From<MockConsensusState> for RawMockConsensusState {
     fn from(value: MockConsensusState) -> Self {
-        RawMockConsensusState {
-            header: Some(RawMockHeader {
-                height: Some(value.header.height().into()),
-                timestamp: value.header.timestamp.nanoseconds(),
-            }),
+        Self {
+            header: Some(value.header.into()),
         }
     }
 }
@@ -83,7 +78,7 @@ impl TryFrom<Any> for MockConsensusState {
 
 impl From<MockConsensusState> for Any {
     fn from(consensus_state: MockConsensusState) -> Self {
-        Any {
+        Self {
             type_url: MOCK_CONSENSUS_STATE_TYPE_URL.to_string(),
             value: Protobuf::<RawMockConsensusState>::encode_vec(consensus_state),
         }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/header.rs b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
index a861ac311..804db7ab0 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/header.rs
@@ -42,21 +42,25 @@ impl TryFrom<RawMockHeader> for MockHeader {
     type Error = ClientError;
 
     fn try_from(raw: RawMockHeader) -> Result<Self, Self::Error> {
-        Ok(MockHeader {
+        Ok(Self {
             height: raw
                 .height
-                .and_then(|raw_height| raw_height.try_into().ok())
-                .ok_or(ClientError::MissingClientMessage)?,
-
-            timestamp: Timestamp::from_nanoseconds(raw.timestamp)
-                .map_err(ClientError::InvalidPacketTimestamp)?,
+                .ok_or(ClientError::Other {
+                    description: "missing height".into(),
+                })?
+                .try_into()?,
+            timestamp: Timestamp::from_nanoseconds(raw.timestamp).map_err(|err| {
+                ClientError::Other {
+                    description: err.to_string(),
+                }
+            })?,
         })
     }
 }
 
 impl From<MockHeader> for RawMockHeader {
     fn from(value: MockHeader) -> Self {
-        RawMockHeader {
+        Self {
             height: Some(value.height.into()),
             timestamp: value.timestamp.nanoseconds(),
         }
@@ -108,7 +112,7 @@ impl TryFrom<Any> for MockHeader {
 
 impl From<MockHeader> for Any {
     fn from(header: MockHeader) -> Self {
-        Any {
+        Self {
             type_url: MOCK_HEADER_TYPE_URL.to_string(),
             value: Protobuf::<RawMockHeader>::encode_vec(header),
         }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
index 15ea17a40..ff4664da4 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mock/misbehaviour.rs
@@ -38,7 +38,7 @@ impl TryFrom<RawMisbehaviour> for Misbehaviour {
 
 impl From<Misbehaviour> for RawMisbehaviour {
     fn from(value: Misbehaviour) -> Self {
-        RawMisbehaviour {
+        Self {
             client_id: value.client_id.to_string(),
             header1: Some(value.header1.into()),
             header2: Some(value.header2.into()),
@@ -70,7 +70,7 @@ impl TryFrom<Any> for Misbehaviour {
 
 impl From<Misbehaviour> for Any {
     fn from(misbehaviour: Misbehaviour) -> Self {
-        Any {
+        Self {
             type_url: MOCK_MISBEHAVIOUR_TYPE_URL.to_string(),
             value: Protobuf::<RawMisbehaviour>::encode_vec(misbehaviour),
         }
diff --git a/ibc-testkit/src/testapp/ibc/clients/mod.rs b/ibc-testkit/src/testapp/ibc/clients/mod.rs
index 1f7e364c6..05fe539da 100644
--- a/ibc-testkit/src/testapp/ibc/clients/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/clients/mod.rs
@@ -1,5 +1,8 @@
 pub mod mock;
 
+use alloc::fmt::Debug;
+
+use basecoin_store::context::ProvableStore;
 use derive_more::From;
 use ibc::clients::tendermint::client_state::ClientState as TmClientState;
 use ibc::clients::tendermint::consensus_state::ConsensusState as TmConsensusState;
@@ -8,26 +11,43 @@ use ibc::clients::tendermint::types::{
     TENDERMINT_CLIENT_STATE_TYPE_URL, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
 };
 use ibc::core::client::types::error::ClientError;
+use ibc::core::client::types::Height;
 use ibc::core::primitives::prelude::*;
 use ibc::derive::{ClientState, ConsensusState};
 use ibc::primitives::proto::{Any, Protobuf};
 
+use super::core::types::MockIbcStore;
 use crate::testapp::ibc::clients::mock::client_state::{
     MockClientState, MOCK_CLIENT_STATE_TYPE_URL,
 };
 use crate::testapp::ibc::clients::mock::consensus_state::{
     MockConsensusState, MOCK_CONSENSUS_STATE_TYPE_URL,
 };
-use crate::testapp::ibc::core::types::MockContext;
 
 #[derive(Debug, Clone, From, PartialEq, ClientState)]
-#[validation(MockContext)]
-#[execution(MockContext)]
+#[validation(MockIbcStore<S: ProvableStore + Debug>)]
+#[execution(MockIbcStore<S: ProvableStore + Debug>)]
 pub enum AnyClientState {
     Tendermint(TmClientState),
     Mock(MockClientState),
 }
 
+impl AnyClientState {
+    pub fn latest_height(&self) -> Height {
+        match self {
+            Self::Tendermint(cs) => cs.inner().latest_height,
+            Self::Mock(cs) => cs.latest_height(),
+        }
+    }
+
+    pub fn is_frozen(&self) -> bool {
+        match self {
+            Self::Tendermint(cs) => cs.inner().is_frozen(),
+            Self::Mock(cs) => cs.is_frozen(),
+        }
+    }
+}
+
 impl Protobuf<Any> for AnyClientState {}
 
 impl TryFrom<Any> for AnyClientState {
@@ -57,13 +77,13 @@ impl From<AnyClientState> for Any {
 
 impl From<ClientStateType> for AnyClientState {
     fn from(client_state: ClientStateType) -> Self {
-        AnyClientState::Tendermint(client_state.into())
+        Self::Tendermint(client_state.into())
     }
 }
 
 impl From<ConsensusStateType> for AnyConsensusState {
     fn from(consensus_state: ConsensusStateType) -> Self {
-        AnyConsensusState::Tendermint(consensus_state.into())
+        Self::Tendermint(consensus_state.into())
     }
 }
 
@@ -73,8 +93,6 @@ pub enum AnyConsensusState {
     Mock(MockConsensusState),
 }
 
-impl Protobuf<Any> for AnyConsensusState {}
-
 impl TryFrom<Any> for AnyConsensusState {
     type Error = ClientError;
 
diff --git a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
index cc7c29b30..8c7bd8dd2 100644
--- a/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/client_ctx.rs
@@ -1,3 +1,7 @@
+use core::fmt::Debug;
+
+use basecoin_store::context::{ProvableStore, Store};
+use basecoin_store::types::Height as StoreHeight;
 use ibc::core::client::context::{
     ClientExecutionContext, ClientValidationContext, ExtClientValidationContext,
 };
@@ -5,14 +9,16 @@ use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::Height;
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, PortId};
-use ibc::core::host::types::path::{ClientConsensusStatePath, ClientStatePath};
+use ibc::core::host::types::path::{
+    ClientConsensusStatePath, ClientStatePath, ClientUpdateHeightPath, ClientUpdateTimePath, Path,
+};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::Timestamp;
 use ibc::primitives::prelude::*;
 
+use super::types::MockIbcStore;
 use crate::testapp::ibc::clients::mock::client_state::MockClientContext;
 use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
-use crate::testapp::ibc::core::types::MockContext;
 
 pub type PortChannelIdMap<V> = BTreeMap<PortId, BTreeMap<ChannelId, V>>;
 
@@ -27,7 +33,10 @@ pub struct MockClientRecord {
     pub consensus_states: BTreeMap<Height, AnyConsensusState>,
 }
 
-impl MockClientContext for MockContext {
+impl<S> MockClientContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         ValidationContext::host_timestamp(self)
     }
@@ -37,7 +46,10 @@ impl MockClientContext for MockContext {
     }
 }
 
-impl ExtClientValidationContext for MockContext {
+impl<S> ExtClientValidationContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
         ValidationContext::host_timestamp(self)
     }
@@ -46,19 +58,31 @@ impl ExtClientValidationContext for MockContext {
         ValidationContext::host_height(self)
     }
 
+    /// Returns the list of heights at which the consensus state of the given client was updated.
     fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError> {
-        let ibc_store = self.ibc_store.lock();
-        let client_record =
-            ibc_store
-                .clients
-                .get(client_id)
-                .ok_or_else(|| ClientError::ClientStateNotFound {
-                    client_id: client_id.clone(),
-                })?;
-
-        let heights = client_record.consensus_states.keys().copied().collect();
-
-        Ok(heights)
+        let path = format!("clients/{}/consensusStates", client_id)
+            .try_into()
+            .map_err(|_| ClientError::Other {
+                description: "Invalid consensus state path".into(),
+            })?;
+
+        self.consensus_state_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::ClientConsensusState(consensus_path)) = path.try_into() {
+                    Some(consensus_path)
+                } else {
+                    None
+                }
+            })
+            .map(|consensus_path| {
+                Ok(Height::new(
+                    consensus_path.revision_number,
+                    consensus_path.revision_height,
+                )?)
+            })
+            .collect::<Result<Vec<_>, _>>()
     }
 
     fn next_consensus_state(
@@ -66,33 +90,32 @@ impl ExtClientValidationContext for MockContext {
         client_id: &ClientId,
         height: &Height,
     ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
-        let ibc_store = self.ibc_store.lock();
-        let client_record =
-            ibc_store
-                .clients
-                .get(client_id)
-                .ok_or_else(|| ClientError::ClientStateNotFound {
-                    client_id: client_id.clone(),
-                })?;
-
-        // Get the consensus state heights and sort them in ascending order.
-        let mut heights: Vec<Height> = client_record.consensus_states.keys().copied().collect();
-        heights.sort();
-
-        // Search for next state.
-        for h in heights {
-            if h > *height {
-                // unwrap should never happen, as the consensus state for h must exist
-                return Ok(Some(
-                    client_record
-                        .consensus_states
-                        .get(&h)
-                        .expect("Never fails")
-                        .clone(),
-                ));
+        let path = format!("clients/{client_id}/consensusStates").into();
+
+        let keys = self.store.get_keys(&path);
+        let found_path = keys.into_iter().find_map(|path| {
+            if let Ok(Path::ClientConsensusState(path)) = path.try_into() {
+                if height
+                    < &Height::new(path.revision_number, path.revision_height).expect("no error")
+                {
+                    return Some(path);
+                }
             }
-        }
-        Ok(None)
+            None
+        });
+
+        let consensus_state = found_path
+            .map(|path| {
+                self.consensus_state_store
+                    .get(StoreHeight::Pending, &path)
+                    .ok_or_else(|| ClientError::ConsensusStateNotFound {
+                        client_id: client_id.clone(),
+                        height: *height,
+                    })
+            })
+            .transpose()?;
+
+        Ok(consensus_state)
     }
 
     fn prev_consensus_state(
@@ -100,150 +123,139 @@ impl ExtClientValidationContext for MockContext {
         client_id: &ClientId,
         height: &Height,
     ) -> Result<Option<Self::ConsensusStateRef>, ContextError> {
-        let ibc_store = self.ibc_store.lock();
-        let client_record =
-            ibc_store
-                .clients
-                .get(client_id)
-                .ok_or_else(|| ClientError::ClientStateNotFound {
-                    client_id: client_id.clone(),
-                })?;
-
-        // Get the consensus state heights and sort them in descending order.
-        let mut heights: Vec<Height> = client_record.consensus_states.keys().copied().collect();
-        heights.sort_by(|a, b| b.cmp(a));
-
-        // Search for previous state.
-        for h in heights {
-            if h < *height {
-                // unwrap should never happen, as the consensus state for h must exist
-                return Ok(Some(
-                    client_record
-                        .consensus_states
-                        .get(&h)
-                        .expect("Never fails")
-                        .clone(),
-                ));
+        let path = format!("clients/{client_id}/consensusStates").into();
+
+        let keys = self.store.get_keys(&path);
+        let found_path = keys.into_iter().rev().find_map(|path| {
+            if let Ok(Path::ClientConsensusState(path)) = path.try_into() {
+                if height
+                    > &Height::new(path.revision_number, path.revision_height).expect("no error")
+                {
+                    return Some(path);
+                }
             }
-        }
-        Ok(None)
+            None
+        });
+
+        let consensus_state = found_path
+            .map(|path| {
+                self.consensus_state_store
+                    .get(StoreHeight::Pending, &path)
+                    .ok_or_else(|| ClientError::ConsensusStateNotFound {
+                        client_id: client_id.clone(),
+                        height: *height,
+                    })
+            })
+            .transpose()?;
+
+        Ok(consensus_state)
     }
 }
 
-impl ClientValidationContext for MockContext {
+impl<S> ClientValidationContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     type ClientStateRef = AnyClientState;
     type ConsensusStateRef = AnyConsensusState;
 
     fn client_state(&self, client_id: &ClientId) -> Result<Self::ClientStateRef, ContextError> {
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => {
-                client_record
-                    .client_state
-                    .clone()
-                    .ok_or_else(|| ClientError::ClientStateNotFound {
-                        client_id: client_id.clone(),
-                    })
-            }
-            None => Err(ClientError::ClientStateNotFound {
+        Ok(self
+            .client_state_store
+            .get(StoreHeight::Pending, &ClientStatePath(client_id.clone()))
+            .ok_or(ClientError::ClientStateNotFound {
                 client_id: client_id.clone(),
-            }),
-        }
-        .map_err(ContextError::ClientError)
+            })?)
     }
 
     fn consensus_state(
         &self,
         client_cons_state_path: &ClientConsensusStatePath,
     ) -> Result<AnyConsensusState, ContextError> {
-        let client_id = &client_cons_state_path.client_id;
         let height = Height::new(
             client_cons_state_path.revision_number,
             client_cons_state_path.revision_height,
-        )?;
-        match self.ibc_store.lock().clients.get(client_id) {
-            Some(client_record) => match client_record.consensus_states.get(&height) {
-                Some(consensus_state) => Ok(consensus_state.clone()),
-                None => Err(ClientError::ConsensusStateNotFound {
-                    client_id: client_id.clone(),
-                    height,
-                }),
-            },
-            None => Err(ClientError::ConsensusStateNotFound {
-                client_id: client_id.clone(),
+        )
+        .map_err(|_| ClientError::InvalidHeight)?;
+        let consensus_state = self
+            .consensus_state_store
+            .get(StoreHeight::Pending, client_cons_state_path)
+            .ok_or(ClientError::ConsensusStateNotFound {
+                client_id: client_cons_state_path.client_id.clone(),
                 height,
-            }),
-        }
-        .map_err(ContextError::ClientError)
+            })?;
+
+        Ok(consensus_state)
     }
 
+    /// Returns the time and height when the client state for the given
+    /// [`ClientId`] was updated with a header for the given [`Height`]
     fn client_update_meta(
         &self,
         client_id: &ClientId,
         height: &Height,
     ) -> Result<(Timestamp, Height), ContextError> {
-        let key = (client_id.clone(), *height);
-        (|| {
-            let ibc_store = self.ibc_store.lock();
-            let time = ibc_store.client_processed_times.get(&key)?;
-            let height = ibc_store.client_processed_heights.get(&key)?;
-            Some((*time, *height))
-        })()
-        .ok_or(ClientError::UpdateMetaDataNotFound {
-            client_id: key.0,
-            height: key.1,
-        })
-        .map_err(ContextError::from)
+        let client_update_time_path = ClientUpdateTimePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        let processed_timestamp = self
+            .client_processed_times
+            .get(StoreHeight::Pending, &client_update_time_path)
+            .ok_or(ClientError::UpdateMetaDataNotFound {
+                client_id: client_id.clone(),
+                height: *height,
+            })?;
+        let client_update_height_path = ClientUpdateHeightPath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        let processed_height = self
+            .client_processed_heights
+            .get(StoreHeight::Pending, &client_update_height_path)
+            .ok_or(ClientError::UpdateMetaDataNotFound {
+                client_id: client_id.clone(),
+                height: *height,
+            })?;
+
+        Ok((processed_timestamp, processed_height))
     }
 }
 
-impl ClientExecutionContext for MockContext {
+impl<S> ClientExecutionContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     type ClientStateMut = AnyClientState;
 
+    /// Called upon successful client creation and update
     fn store_client_state(
         &mut self,
         client_state_path: ClientStatePath,
         client_state: Self::ClientStateRef,
     ) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        let client_id = client_state_path.0;
-        let client_record = ibc_store
-            .clients
-            .entry(client_id)
-            .or_insert(MockClientRecord {
-                consensus_states: Default::default(),
-                client_state: Default::default(),
-            });
-
-        client_record.client_state = Some(client_state);
+        self.client_state_store
+            .set(client_state_path, client_state)
+            .map_err(|_| ClientError::Other {
+                description: "Client state store error".to_string(),
+            })?;
 
         Ok(())
     }
 
+    /// Called upon successful client creation and update
     fn store_consensus_state(
         &mut self,
         consensus_state_path: ClientConsensusStatePath,
         consensus_state: Self::ConsensusStateRef,
     ) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        let client_record = ibc_store
-            .clients
-            .entry(consensus_state_path.client_id)
-            .or_insert(MockClientRecord {
-                consensus_states: Default::default(),
-                client_state: Default::default(),
-            });
-
-        let height = Height::new(
-            consensus_state_path.revision_number,
-            consensus_state_path.revision_height,
-        )
-        .expect("Never fails");
-        client_record
-            .consensus_states
-            .insert(height, consensus_state);
-
+        self.consensus_state_store
+            .set(consensus_state_path, consensus_state)
+            .map_err(|_| ClientError::Other {
+                description: "Consensus state store error".to_string(),
+            })?;
         Ok(())
     }
 
@@ -251,39 +263,36 @@ impl ClientExecutionContext for MockContext {
         &mut self,
         consensus_state_path: ClientConsensusStatePath,
     ) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-
-        let client_record = ibc_store
-            .clients
-            .entry(consensus_state_path.client_id)
-            .or_insert(MockClientRecord {
-                consensus_states: Default::default(),
-                client_state: Default::default(),
-            });
-
-        let height = Height::new(
-            consensus_state_path.revision_number,
-            consensus_state_path.revision_height,
-        )
-        .expect("Never fails");
-
-        client_record.consensus_states.remove(&height);
-
+        self.consensus_state_store.delete(consensus_state_path);
         Ok(())
     }
 
+    /// Delete the update metadata associated with the client at the specified
+    /// height.
     fn delete_update_meta(
         &mut self,
         client_id: ClientId,
         height: Height,
     ) -> Result<(), ContextError> {
-        let key = (client_id, height);
-        let mut ibc_store = self.ibc_store.lock();
-        ibc_store.client_processed_times.remove(&key);
-        ibc_store.client_processed_heights.remove(&key);
+        let client_update_time_path = ClientUpdateTimePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        self.client_processed_times.delete(client_update_time_path);
+        let client_update_height_path = ClientUpdateHeightPath::new(
+            client_id,
+            height.revision_number(),
+            height.revision_height(),
+        );
+        self.client_processed_heights
+            .delete(client_update_height_path);
         Ok(())
     }
 
+    /// Called upon successful client update. Implementations are expected to
+    /// use this to record the time and height at which this update (or header)
+    /// was processed.
     fn store_update_meta(
         &mut self,
         client_id: ClientId,
@@ -291,13 +300,26 @@ impl ClientExecutionContext for MockContext {
         host_timestamp: Timestamp,
         host_height: Height,
     ) -> Result<(), ContextError> {
-        let mut ibc_store = self.ibc_store.lock();
-        ibc_store
-            .client_processed_times
-            .insert((client_id.clone(), height), host_timestamp);
-        ibc_store
-            .client_processed_heights
-            .insert((client_id, height), host_height);
+        let client_update_time_path = ClientUpdateTimePath::new(
+            client_id.clone(),
+            height.revision_number(),
+            height.revision_height(),
+        );
+        self.client_processed_times
+            .set(client_update_time_path, host_timestamp)
+            .map_err(|_| ClientError::Other {
+                description: "store update error".into(),
+            })?;
+        let client_update_height_path = ClientUpdateHeightPath::new(
+            client_id,
+            height.revision_number(),
+            height.revision_height(),
+        );
+        self.client_processed_heights
+            .set(client_update_height_path, host_height)
+            .map_err(|_| ClientError::Other {
+                description: "store update error".into(),
+            })?;
         Ok(())
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index 4901b2d2c..386a83efb 100644
--- a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -1,70 +1,78 @@
 //! Implementation of a global context mock. Used in testing handlers of all IBC modules.
 
-use core::ops::Add;
+use core::fmt::Debug;
 use core::time::Duration;
 
-use ibc::core::channel::types::channel::ChannelEnd;
+use basecoin_store::context::{ProvableStore, Store};
+use basecoin_store::types::Height as StoreHeight;
+use ibc::core::channel::types::channel::{ChannelEnd, IdentifiedChannelEnd};
 use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
 use ibc::core::channel::types::error::{ChannelError, PacketError};
-use ibc::core::channel::types::packet::Receipt;
+use ibc::core::channel::types::packet::{PacketState, Receipt};
+use ibc::core::client::context::consensus_state::ConsensusState;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
+use ibc::core::commitment_types::merkle::MerkleProof;
 use ibc::core::connection::types::error::ConnectionError;
-use ibc::core::connection::types::ConnectionEnd;
+use ibc::core::connection::types::{ConnectionEnd, IdentifiedConnectionEnd};
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::IbcEvent;
-use ibc::core::host::types::identifiers::{ConnectionId, Sequence};
+use ibc::core::host::types::identifiers::{ClientId, ConnectionId, Sequence};
 use ibc::core::host::types::path::{
-    AckPath, ChannelEndPath, ClientConnectionPath, CommitmentPath, ConnectionPath, ReceiptPath,
+    AckPath, ChannelEndPath, ClientConnectionPath, CommitmentPath, ConnectionPath,
+    NextChannelSequencePath, NextClientSequencePath, NextConnectionSequencePath, Path, ReceiptPath,
     SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use ibc::core::host::{ExecutionContext, ValidationContext};
+use ibc::core::host::{ClientStateRef, ConsensusStateRef, ExecutionContext, ValidationContext};
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::{Signer, Timestamp};
+use ibc::primitives::ToVec;
+use ibc_proto::ibc::core::commitment::v1::MerkleProof as RawMerkleProof;
+use ibc_query::core::context::{ProvableContext, QueryContext};
 
-use super::types::MockContext;
-use crate::testapp::ibc::clients::mock::client_state::MockClientState;
-use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
-use crate::testapp::ibc::clients::AnyConsensusState;
+use super::types::{MockIbcStore, DEFAULT_BLOCK_TIME_SECS};
+use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 
-impl ValidationContext for MockContext {
+impl<S> ValidationContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     type V = Self;
-    type HostClientState = MockClientState;
-    type HostConsensusState = MockConsensusState;
+    type HostClientState = AnyClientState;
+    type HostConsensusState = AnyConsensusState;
 
     fn host_height(&self) -> Result<Height, ContextError> {
-        Ok(self.latest_height())
+        Ok(Height::new(
+            *self.revision_number.lock(),
+            self.store.current_height(),
+        )?)
     }
 
     fn host_timestamp(&self) -> Result<Timestamp, ContextError> {
-        Ok(self
-            .history
-            .last()
-            .expect("history cannot be empty")
-            .timestamp()
-            .add(self.block_time)
-            .expect("Never fails"))
+        let host_height = self.host_height()?;
+        let host_cons_state = self.host_consensus_state(&host_height)?;
+        Ok(host_cons_state.timestamp())
     }
 
     fn client_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().client_ids_counter)
+        Ok(self
+            .client_counter
+            .get(StoreHeight::Pending, &NextClientSequencePath)
+            .ok_or(ClientError::Other {
+                description: "client counter not found".into(),
+            })?)
     }
 
-    fn host_consensus_state(&self, height: &Height) -> Result<MockConsensusState, ContextError> {
-        let cs: AnyConsensusState = match self.host_block(height) {
-            Some(block_ref) => Ok(block_ref.clone().into()),
-            None => Err(ClientError::MissingLocalConsensusState { height: *height }),
-        }
-        .map_err(ContextError::ClientError)?;
-
-        match cs {
-            AnyConsensusState::Mock(cs) => Ok(cs),
-            _ => Err(ClientError::Other {
-                description: "unexpected consensus state type".to_string(),
-            }
-            .into()),
-        }
+    fn host_consensus_state(
+        &self,
+        height: &Height,
+    ) -> Result<Self::HostConsensusState, ContextError> {
+        let consensus_states_binding = self.host_consensus_states.lock();
+        Ok(consensus_states_binding
+            .get(&height.revision_height())
+            .cloned()
+            .ok_or(ClientError::MissingLocalConsensusState { height: *height })?)
     }
 
     fn validate_self_client(
@@ -78,8 +86,9 @@ impl ValidationContext for MockContext {
             .into());
         }
 
-        let self_chain_id = &self.host_chain_id;
-        let self_revision_number = self_chain_id.revision_number();
+        let latest_height = self.host_height()?;
+
+        let self_revision_number = latest_height.revision_number();
         if self_revision_number
             != client_state_of_host_on_counterparty
                 .latest_height()
@@ -98,7 +107,7 @@ impl ValidationContext for MockContext {
             ));
         }
 
-        let host_current_height = self.latest_height().increment();
+        let host_current_height = latest_height.increment();
         if client_state_of_host_on_counterparty.latest_height() >= host_current_height {
             return Err(ContextError::ConnectionError(
                 ConnectionError::InvalidClientState {
@@ -114,179 +123,140 @@ impl ValidationContext for MockContext {
         Ok(())
     }
 
-    fn connection_end(&self, cid: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
-        match self.ibc_store.lock().connections.get(cid) {
-            Some(connection_end) => Ok(connection_end.clone()),
-            None => Err(ConnectionError::ConnectionNotFound {
-                connection_id: cid.clone(),
-            }),
-        }
-        .map_err(ContextError::ConnectionError)
+    fn connection_end(&self, conn_id: &ConnectionId) -> Result<ConnectionEnd, ContextError> {
+        Ok(self
+            .connection_end_store
+            .get(StoreHeight::Pending, &ConnectionPath::new(conn_id))
+            .ok_or(ConnectionError::ConnectionNotFound {
+                connection_id: conn_id.clone(),
+            })?)
     }
 
     fn commitment_prefix(&self) -> CommitmentPrefix {
+        // this is prefix of ibc store
+        // using a dummy prefix as in our mock context
         CommitmentPrefix::try_from(b"mock".to_vec()).expect("Never fails")
     }
 
     fn connection_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().connection_ids_counter)
+        Ok(self
+            .conn_counter
+            .get(StoreHeight::Pending, &NextConnectionSequencePath)
+            .ok_or(ConnectionError::Other {
+                description: "connection counter not found".into(),
+            })?)
     }
 
-    fn channel_end(&self, chan_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError> {
-        let port_id = &chan_end_path.0;
-        let channel_id = &chan_end_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .channels
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(channel_end) => Ok(channel_end.clone()),
-            None => Err(ChannelError::ChannelNotFound {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::ChannelError)
+    fn channel_end(&self, channel_end_path: &ChannelEndPath) -> Result<ChannelEnd, ContextError> {
+        Ok(self
+            .channel_end_store
+            .get(
+                StoreHeight::Pending,
+                &ChannelEndPath::new(&channel_end_path.0, &channel_end_path.1),
+            )
+            .ok_or(ChannelError::MissingChannel)?)
     }
 
     fn get_next_sequence_send(
         &self,
         seq_send_path: &SeqSendPath,
     ) -> Result<Sequence, ContextError> {
-        let port_id = &seq_send_path.0;
-        let channel_id = &seq_send_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_send
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextSendSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
+        Ok(self
+            .send_sequence_store
+            .get(
+                StoreHeight::Pending,
+                &SeqSendPath::new(&seq_send_path.0, &seq_send_path.1),
+            )
+            .ok_or(PacketError::ImplementationSpecific)?)
     }
 
     fn get_next_sequence_recv(
         &self,
         seq_recv_path: &SeqRecvPath,
     ) -> Result<Sequence, ContextError> {
-        let port_id = &seq_recv_path.0;
-        let channel_id = &seq_recv_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_recv
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextRecvSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
+        Ok(self
+            .recv_sequence_store
+            .get(
+                StoreHeight::Pending,
+                &SeqRecvPath::new(&seq_recv_path.0, &seq_recv_path.1),
+            )
+            .ok_or(PacketError::ImplementationSpecific)?)
     }
 
     fn get_next_sequence_ack(&self, seq_ack_path: &SeqAckPath) -> Result<Sequence, ContextError> {
-        let port_id = &seq_ack_path.0;
-        let channel_id = &seq_ack_path.1;
-
-        match self
-            .ibc_store
-            .lock()
-            .next_sequence_ack
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-        {
-            Some(sequence) => Ok(*sequence),
-            None => Err(PacketError::MissingNextAckSeq {
-                port_id: port_id.clone(),
-                channel_id: channel_id.clone(),
-            }),
-        }
-        .map_err(ContextError::PacketError)
+        Ok(self
+            .ack_sequence_store
+            .get(
+                StoreHeight::Pending,
+                &SeqAckPath::new(&seq_ack_path.0, &seq_ack_path.1),
+            )
+            .ok_or(PacketError::ImplementationSpecific)?)
     }
 
     fn get_packet_commitment(
         &self,
         commitment_path: &CommitmentPath,
     ) -> Result<PacketCommitment, ContextError> {
-        let port_id = &commitment_path.port_id;
-        let channel_id = &commitment_path.channel_id;
-        let seq = &commitment_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_commitment
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(commitment) => Ok(commitment.clone()),
-            None => Err(PacketError::PacketCommitmentNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
+        Ok(self
+            .packet_commitment_store
+            .get(
+                StoreHeight::Pending,
+                &CommitmentPath::new(
+                    &commitment_path.port_id,
+                    &commitment_path.channel_id,
+                    commitment_path.sequence,
+                ),
+            )
+            .ok_or(PacketError::ImplementationSpecific)?)
     }
 
     fn get_packet_receipt(&self, receipt_path: &ReceiptPath) -> Result<Receipt, ContextError> {
-        let port_id = &receipt_path.port_id;
-        let channel_id = &receipt_path.channel_id;
-        let seq = &receipt_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_receipt
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(receipt) => Ok(receipt.clone()),
-            None => Err(PacketError::PacketReceiptNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
+        Ok(self
+            .packet_receipt_store
+            .is_path_set(
+                StoreHeight::Pending,
+                &ReceiptPath::new(
+                    &receipt_path.port_id,
+                    &receipt_path.channel_id,
+                    receipt_path.sequence,
+                ),
+            )
+            .then_some(Receipt::Ok)
+            .ok_or(PacketError::PacketReceiptNotFound {
+                sequence: receipt_path.sequence,
+            })?)
     }
 
     fn get_packet_acknowledgement(
         &self,
         ack_path: &AckPath,
     ) -> Result<AcknowledgementCommitment, ContextError> {
-        let port_id = &ack_path.port_id;
-        let channel_id = &ack_path.channel_id;
-        let seq = &ack_path.sequence;
-
-        match self
-            .ibc_store
-            .lock()
-            .packet_acknowledgement
-            .get(port_id)
-            .and_then(|map| map.get(channel_id))
-            .and_then(|map| map.get(seq))
-        {
-            Some(ack) => Ok(ack.clone()),
-            None => Err(PacketError::PacketAcknowledgementNotFound { sequence: *seq }),
-        }
-        .map_err(ContextError::PacketError)
-    }
-
+        Ok(self
+            .packet_ack_store
+            .get(
+                StoreHeight::Pending,
+                &AckPath::new(&ack_path.port_id, &ack_path.channel_id, ack_path.sequence),
+            )
+            .ok_or(PacketError::PacketAcknowledgementNotFound {
+                sequence: ack_path.sequence,
+            })?)
+    }
+
+    /// Returns a counter of the number of channel ids that have been created thus far.
+    /// The value of this counter should increase only via the
+    /// `ChannelKeeper::increase_channel_counter` method.
     fn channel_counter(&self) -> Result<u64, ContextError> {
-        Ok(self.ibc_store.lock().channel_ids_counter)
+        Ok(self
+            .channel_counter
+            .get(StoreHeight::Pending, &NextChannelSequencePath)
+            .ok_or(ChannelError::Other {
+                description: "channel counter not found".into(),
+            })?)
     }
 
+    /// Returns the maximum expected time per block
     fn max_expected_time_per_block(&self) -> Duration {
-        self.block_time
+        Duration::from_secs(DEFAULT_BLOCK_TIME_SECS)
     }
 
     fn validate_message_signer(&self, _signer: &Signer) -> Result<(), ContextError> {
@@ -298,46 +268,452 @@ impl ValidationContext for MockContext {
     }
 }
 
-impl ExecutionContext for MockContext {
+/// Trait to provide proofs in gRPC service blanket implementations.
+impl<S> ProvableContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
+    /// Returns the proof for the given [`Height`] and [`Path`]
+    fn get_proof(&self, height: Height, path: &Path) -> Option<Vec<u8>> {
+        self.store
+            .get_proof(height.revision_height().into(), &path.to_string().into())
+            .map(|path_proof| {
+                let ibc_commitment_proof = self
+                    .ibc_commiment_proofs
+                    .lock()
+                    .get(&height.revision_height())
+                    .expect("proof exists")
+                    .clone();
+
+                RawMerkleProof::from(MerkleProof {
+                    proofs: vec![path_proof, ibc_commitment_proof],
+                })
+            })
+            .map(|p| p.to_vec())
+    }
+}
+
+/// Trait to complete the gRPC service blanket implementations.
+impl<S> QueryContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
+    /// Returns the list of all client states.
+    fn client_states(&self) -> Result<Vec<(ClientId, ClientStateRef<Self>)>, ContextError> {
+        let path = "clients".to_owned().into();
+
+        self.client_state_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::ClientState(client_path)) = path.try_into() {
+                    Some(client_path)
+                } else {
+                    None
+                }
+            })
+            .map(|client_state_path| {
+                let client_state = self
+                    .client_state_store
+                    .get(StoreHeight::Pending, &client_state_path)
+                    .ok_or_else(|| ClientError::ClientStateNotFound {
+                        client_id: client_state_path.0.clone(),
+                    })?;
+                Ok((client_state_path.0, client_state))
+            })
+            .collect()
+    }
+
+    /// Returns the list of all consensus states of the given client.
+    fn consensus_states(
+        &self,
+        client_id: &ClientId,
+    ) -> Result<Vec<(Height, ConsensusStateRef<Self>)>, ContextError> {
+        let path = format!("clients/{}/consensusStates", client_id)
+            .try_into()
+            .map_err(|_| ClientError::Other {
+                description: "Invalid consensus state path".into(),
+            })?;
+
+        self.consensus_state_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::ClientConsensusState(consensus_path)) = path.try_into() {
+                    Some(consensus_path)
+                } else {
+                    None
+                }
+            })
+            .map(|consensus_path| {
+                let height = Height::new(
+                    consensus_path.revision_number,
+                    consensus_path.revision_height,
+                )?;
+                let client_state = self
+                    .consensus_state_store
+                    .get(StoreHeight::Pending, &consensus_path)
+                    .ok_or({
+                        ClientError::ConsensusStateNotFound {
+                            client_id: consensus_path.client_id,
+                            height,
+                        }
+                    })?;
+                Ok((height, client_state))
+            })
+            .collect()
+    }
+
+    /// Returns the list of heights at which the consensus state of the given client was updated.
+    fn consensus_state_heights(&self, client_id: &ClientId) -> Result<Vec<Height>, ContextError> {
+        let path = format!("clients/{}/consensusStates", client_id)
+            .try_into()
+            .map_err(|_| ClientError::Other {
+                description: "Invalid consensus state path".into(),
+            })?;
+
+        self.consensus_state_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::ClientConsensusState(consensus_path)) = path.try_into() {
+                    Some(consensus_path)
+                } else {
+                    None
+                }
+            })
+            .map(|consensus_path| {
+                Ok(Height::new(
+                    consensus_path.revision_number,
+                    consensus_path.revision_height,
+                )?)
+            })
+            .collect::<Result<Vec<_>, _>>()
+    }
+
+    /// Returns all the IBC connection ends of a chain.
+    fn connection_ends(&self) -> Result<Vec<IdentifiedConnectionEnd>, ContextError> {
+        let path = "connections".to_owned().into();
+
+        self.connection_end_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::Connection(connection_path)) = path.try_into() {
+                    Some(connection_path)
+                } else {
+                    None
+                }
+            })
+            .map(|connection_path| {
+                let connection_end = self
+                    .connection_end_store
+                    .get(StoreHeight::Pending, &connection_path)
+                    .ok_or_else(|| ConnectionError::ConnectionNotFound {
+                        connection_id: connection_path.0.clone(),
+                    })?;
+                Ok(IdentifiedConnectionEnd {
+                    connection_id: connection_path.0,
+                    connection_end,
+                })
+            })
+            .collect()
+    }
+
+    /// Returns all the IBC connection ends associated with a client.
+    fn client_connection_ends(
+        &self,
+        client_id: &ClientId,
+    ) -> Result<Vec<ConnectionId>, ContextError> {
+        let client_connection_path = ClientConnectionPath::new(client_id.clone());
+
+        Ok(self
+            .connection_ids_store
+            .get(StoreHeight::Pending, &client_connection_path)
+            .unwrap_or_default())
+    }
+
+    /// Returns all the IBC channel ends of a chain.
+    fn channel_ends(&self) -> Result<Vec<IdentifiedChannelEnd>, ContextError> {
+        let path = "channelEnds".to_owned().into();
+
+        self.channel_end_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::ChannelEnd(channel_path)) = path.try_into() {
+                    Some(channel_path)
+                } else {
+                    None
+                }
+            })
+            .map(|channel_path| {
+                let channel_end = self
+                    .channel_end_store
+                    .get(StoreHeight::Pending, &channel_path)
+                    .ok_or_else(|| ChannelError::ChannelNotFound {
+                        port_id: channel_path.0.clone(),
+                        channel_id: channel_path.1.clone(),
+                    })?;
+                Ok(IdentifiedChannelEnd {
+                    port_id: channel_path.0,
+                    channel_id: channel_path.1,
+                    channel_end,
+                })
+            })
+            .collect()
+    }
+
+    /// Returns all the packet commitments associated with a channel.
+    fn packet_commitments(
+        &self,
+        channel_end_path: &ChannelEndPath,
+    ) -> Result<Vec<PacketState>, ContextError> {
+        let path = format!(
+            "commitments/ports/{}/channels/{}/sequences",
+            channel_end_path.0, channel_end_path.1
+        )
+        .try_into()
+        .map_err(|_| PacketError::Other {
+            description: "Invalid commitment path".into(),
+        })?;
+
+        self.packet_commitment_store
+            .get_keys(&path)
+            .into_iter()
+            .filter_map(|path| {
+                if let Ok(Path::Commitment(commitment_path)) = path.try_into() {
+                    Some(commitment_path)
+                } else {
+                    None
+                }
+            })
+            .filter(|commitment_path| {
+                self.packet_commitment_store
+                    .get(StoreHeight::Pending, commitment_path)
+                    .is_some()
+            })
+            .map(|commitment_path| {
+                self.get_packet_commitment(&commitment_path)
+                    .map(|packet| PacketState {
+                        seq: commitment_path.sequence,
+                        port_id: commitment_path.port_id,
+                        chan_id: commitment_path.channel_id,
+                        data: packet.as_ref().into(),
+                    })
+            })
+            .collect::<Result<Vec<_>, _>>()
+    }
+
+    /// Returns the acknowledged packets associated with a channel.
+    ///
+    /// Takes a sequence list as an argument.
+    /// If the list set is empty, it returns all acknowledged packets.
+    fn packet_acknowledgements(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<PacketState>, ContextError> {
+        let collected_paths: Vec<_> = if sequences.len() == 0 {
+            // if sequences is empty, return all the acks
+            let ack_path_prefix = format!(
+                "acks/ports/{}/channels/{}/sequences",
+                channel_end_path.0, channel_end_path.1
+            )
+            .try_into()
+            .map_err(|_| PacketError::Other {
+                description: "Invalid ack path".into(),
+            })?;
+
+            self.packet_ack_store
+                .get_keys(&ack_path_prefix)
+                .into_iter()
+                .filter_map(|path| {
+                    if let Ok(Path::Ack(ack_path)) = path.try_into() {
+                        Some(ack_path)
+                    } else {
+                        None
+                    }
+                })
+                .collect()
+        } else {
+            sequences
+                .into_iter()
+                .map(|seq| AckPath::new(&channel_end_path.0, &channel_end_path.1, seq))
+                .collect()
+        };
+
+        collected_paths
+            .into_iter()
+            .filter(|ack_path| {
+                self.packet_ack_store
+                    .get(StoreHeight::Pending, ack_path)
+                    .is_some()
+            })
+            .map(|ack_path| {
+                self.get_packet_acknowledgement(&ack_path)
+                    .map(|packet| PacketState {
+                        seq: ack_path.sequence,
+                        port_id: ack_path.port_id,
+                        chan_id: ack_path.channel_id,
+                        data: packet.as_ref().into(),
+                    })
+            })
+            .collect::<Result<Vec<_>, _>>()
+    }
+
+    /// Returns the unreceived IBC packets associated with a channel and sequences.
+    ///
+    /// Takes a sequence list as an argument.
+    fn unreceived_packets(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<Sequence>, ContextError> {
+        // QUESTION. Currently only works for unordered channels; ordered channels
+        // don't use receipts. However, ibc-go does it this way. Investigate if
+        // this query only ever makes sense on unordered channels.
+
+        Ok(sequences
+            .into_iter()
+            .map(|seq| ReceiptPath::new(&channel_end_path.0, &channel_end_path.1, seq))
+            .filter(|receipt_path| {
+                self.packet_receipt_store
+                    .get(StoreHeight::Pending, receipt_path)
+                    .is_none()
+            })
+            .map(|receipts_path| receipts_path.sequence)
+            .collect())
+    }
+
+    /// Returns all the unreceived IBC acknowledgements associated with a channel and sequences.
+    ///
+    /// Takes a sequence list as an argument.
+    /// If the list is empty, it Returns all the unreceived acks.
+    fn unreceived_acks(
+        &self,
+        channel_end_path: &ChannelEndPath,
+        sequences: impl ExactSizeIterator<Item = Sequence>,
+    ) -> Result<Vec<Sequence>, ContextError> {
+        let collected_paths: Vec<_> = if sequences.len() == 0 {
+            // if sequences is empty, return all the acks
+            let commitment_path_prefix = format!(
+                "commitments/ports/{}/channels/{}/sequences",
+                channel_end_path.0, channel_end_path.1
+            )
+            .try_into()
+            .map_err(|_| PacketError::Other {
+                description: "Invalid commitment path".into(),
+            })?;
+
+            self.packet_commitment_store
+                .get_keys(&commitment_path_prefix)
+                .into_iter()
+                .filter_map(|path| {
+                    if let Ok(Path::Commitment(commitment_path)) = path.try_into() {
+                        Some(commitment_path)
+                    } else {
+                        None
+                    }
+                })
+                .collect()
+        } else {
+            sequences
+                .into_iter()
+                .map(|seq| CommitmentPath::new(&channel_end_path.0, &channel_end_path.1, seq))
+                .collect()
+        };
+
+        Ok(collected_paths
+            .into_iter()
+            .filter(|commitment_path: &CommitmentPath| -> bool {
+                self.packet_commitment_store
+                    .get(StoreHeight::Pending, commitment_path)
+                    .is_some()
+            })
+            .map(|commitment_path| commitment_path.sequence)
+            .collect())
+    }
+}
+
+impl<S> ExecutionContext for MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
     type E = Self;
 
     fn get_client_execution_context(&mut self) -> &mut Self::E {
         self
     }
 
+    /// Called upon client creation.
+    /// Increases the counter which keeps track of how many clients have been created.
     fn increase_client_counter(&mut self) -> Result<(), ContextError> {
-        self.ibc_store.lock().client_ids_counter += 1;
+        let current_sequence = self
+            .client_counter
+            .get(StoreHeight::Pending, &NextClientSequencePath)
+            .ok_or(ClientError::Other {
+                description: "client counter not found".into(),
+            })?;
+
+        self.client_counter
+            .set(NextClientSequencePath, current_sequence + 1)
+            .map_err(|e| ClientError::Other {
+                description: format!("client counter update failed: {e:?}"),
+            })?;
+
         Ok(())
     }
 
+    /// Stores the given connection_end at path
     fn store_connection(
         &mut self,
         connection_path: &ConnectionPath,
         connection_end: ConnectionEnd,
     ) -> Result<(), ContextError> {
-        let connection_id = connection_path.0.clone();
-        self.ibc_store
-            .lock()
-            .connections
-            .insert(connection_id, connection_end);
+        self.connection_end_store
+            .set(connection_path.clone(), connection_end)
+            .map_err(|_| ConnectionError::Other {
+                description: "Connection end store error".to_string(),
+            })?;
         Ok(())
     }
 
+    /// Stores the given connection_id at a path associated with the client_id.
     fn store_connection_to_client(
         &mut self,
         client_connection_path: &ClientConnectionPath,
         conn_id: ConnectionId,
     ) -> Result<(), ContextError> {
-        let client_id = client_connection_path.0.clone();
-        self.ibc_store
-            .lock()
-            .client_connections
-            .insert(client_id, conn_id);
+        let mut conn_ids: Vec<ConnectionId> = self
+            .connection_ids_store
+            .get(StoreHeight::Pending, client_connection_path)
+            .unwrap_or_default();
+        conn_ids.push(conn_id);
+        self.connection_ids_store
+            .set(client_connection_path.clone(), conn_ids)
+            .map_err(|_| ConnectionError::Other {
+                description: "Connection ids store error".to_string(),
+            })?;
         Ok(())
     }
 
+    /// Called upon connection identifier creation (Init or Try process).
+    /// Increases the counter which keeps track of how many connections have been created.
     fn increase_connection_counter(&mut self) -> Result<(), ContextError> {
-        self.ibc_store.lock().connection_ids_counter += 1;
+        let current_sequence = self
+            .conn_counter
+            .get(StoreHeight::Pending, &NextConnectionSequencePath)
+            .ok_or(ConnectionError::Other {
+                description: "connection counter not found".into(),
+            })?;
+
+        self.conn_counter
+            .set(NextConnectionSequencePath, current_sequence + 1)
+            .map_err(|e| ConnectionError::Other {
+                description: format!("connection counter update failed: {e:?}"),
+            })?;
+
         Ok(())
     }
 
@@ -346,14 +722,9 @@ impl ExecutionContext for MockContext {
         commitment_path: &CommitmentPath,
         commitment: PacketCommitment,
     ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_commitment
-            .entry(commitment_path.port_id.clone())
-            .or_default()
-            .entry(commitment_path.channel_id.clone())
-            .or_default()
-            .insert(commitment_path.sequence, commitment);
+        self.packet_commitment_store
+            .set(commitment_path.clone(), commitment)
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
@@ -361,28 +732,18 @@ impl ExecutionContext for MockContext {
         &mut self,
         commitment_path: &CommitmentPath,
     ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_commitment
-            .get_mut(&commitment_path.port_id)
-            .and_then(|map| map.get_mut(&commitment_path.channel_id))
-            .and_then(|map| map.remove(&commitment_path.sequence));
+        self.packet_commitment_store.delete(commitment_path.clone());
         Ok(())
     }
 
     fn store_packet_receipt(
         &mut self,
-        path: &ReceiptPath,
-        receipt: Receipt,
+        receipt_path: &ReceiptPath,
+        _receipt: Receipt,
     ) -> Result<(), ContextError> {
-        self.ibc_store
-            .lock()
-            .packet_receipt
-            .entry(path.port_id.clone())
-            .or_default()
-            .entry(path.channel_id.clone())
-            .or_default()
-            .insert(path.sequence, receipt);
+        self.packet_receipt_store
+            .set_path(receipt_path.clone())
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
@@ -391,32 +752,14 @@ impl ExecutionContext for MockContext {
         ack_path: &AckPath,
         ack_commitment: AcknowledgementCommitment,
     ) -> Result<(), ContextError> {
-        let port_id = ack_path.port_id.clone();
-        let channel_id = ack_path.channel_id.clone();
-        let seq = ack_path.sequence;
-
-        self.ibc_store
-            .lock()
-            .packet_acknowledgement
-            .entry(port_id)
-            .or_default()
-            .entry(channel_id)
-            .or_default()
-            .insert(seq, ack_commitment);
+        self.packet_ack_store
+            .set(ack_path.clone(), ack_commitment)
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
     fn delete_packet_acknowledgement(&mut self, ack_path: &AckPath) -> Result<(), ContextError> {
-        let port_id = ack_path.port_id.clone();
-        let channel_id = ack_path.channel_id.clone();
-        let sequence = ack_path.sequence;
-
-        self.ibc_store
-            .lock()
-            .packet_acknowledgement
-            .get_mut(&port_id)
-            .and_then(|map| map.get_mut(&channel_id))
-            .and_then(|map| map.remove(&sequence));
+        self.packet_ack_store.delete(ack_path.clone());
         Ok(())
     }
 
@@ -425,15 +768,11 @@ impl ExecutionContext for MockContext {
         channel_end_path: &ChannelEndPath,
         channel_end: ChannelEnd,
     ) -> Result<(), ContextError> {
-        let port_id = channel_end_path.0.clone();
-        let channel_id = channel_end_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .channels
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, channel_end);
+        self.channel_end_store
+            .set(channel_end_path.clone(), channel_end)
+            .map_err(|_| ChannelError::Other {
+                description: "Channel end store error".to_string(),
+            })?;
         Ok(())
     }
 
@@ -442,15 +781,9 @@ impl ExecutionContext for MockContext {
         seq_send_path: &SeqSendPath,
         seq: Sequence,
     ) -> Result<(), ContextError> {
-        let port_id = seq_send_path.0.clone();
-        let channel_id = seq_send_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_send
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
+        self.send_sequence_store
+            .set(seq_send_path.clone(), seq)
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
@@ -459,15 +792,9 @@ impl ExecutionContext for MockContext {
         seq_recv_path: &SeqRecvPath,
         seq: Sequence,
     ) -> Result<(), ContextError> {
-        let port_id = seq_recv_path.0.clone();
-        let channel_id = seq_recv_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_recv
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
+        self.recv_sequence_store
+            .set(seq_recv_path.clone(), seq)
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
@@ -476,30 +803,36 @@ impl ExecutionContext for MockContext {
         seq_ack_path: &SeqAckPath,
         seq: Sequence,
     ) -> Result<(), ContextError> {
-        let port_id = seq_ack_path.0.clone();
-        let channel_id = seq_ack_path.1.clone();
-
-        self.ibc_store
-            .lock()
-            .next_sequence_ack
-            .entry(port_id)
-            .or_default()
-            .insert(channel_id, seq);
+        self.ack_sequence_store
+            .set(seq_ack_path.clone(), seq)
+            .map_err(|_| PacketError::ImplementationSpecific)?;
         Ok(())
     }
 
     fn increase_channel_counter(&mut self) -> Result<(), ContextError> {
-        self.ibc_store.lock().channel_ids_counter += 1;
+        let current_sequence = self
+            .channel_counter
+            .get(StoreHeight::Pending, &NextChannelSequencePath)
+            .ok_or(ChannelError::Other {
+                description: "channel counter not found".into(),
+            })?;
+
+        self.channel_counter
+            .set(NextChannelSequencePath, current_sequence + 1)
+            .map_err(|e| ChannelError::Other {
+                description: format!("channel counter update failed: {e:?}"),
+            })?;
+
         Ok(())
     }
 
     fn emit_ibc_event(&mut self, event: IbcEvent) -> Result<(), ContextError> {
-        self.ibc_store.lock().events.push(event);
+        self.events.lock().push(event);
         Ok(())
     }
 
     fn log_message(&mut self, message: String) -> Result<(), ContextError> {
-        self.ibc_store.lock().logs.push(message);
+        self.logs.lock().push(message);
         Ok(())
     }
 }
diff --git a/ibc-testkit/src/testapp/ibc/core/router/mod.rs b/ibc-testkit/src/testapp/ibc/core/router/mod.rs
index 6629c0e08..faaf47994 100644
--- a/ibc-testkit/src/testapp/ibc/core/router/mod.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/mod.rs
@@ -1,4 +1,4 @@
 mod context;
 mod types;
 
-pub use types::*;
+pub use self::types::*;
diff --git a/ibc-testkit/src/testapp/ibc/core/router/types.rs b/ibc-testkit/src/testapp/ibc/core/router/types.rs
index 00aff346f..b48cd7fbd 100644
--- a/ibc-testkit/src/testapp/ibc/core/router/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/types.rs
@@ -8,7 +8,7 @@ use ibc::core::router::types::module::ModuleId;
 
 use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
 
-#[derive(Default)]
+#[derive(Debug, Default)]
 pub struct MockRouter {
     pub router: BTreeMap<ModuleId, Arc<dyn Module>>,
 
diff --git a/ibc-testkit/src/testapp/ibc/core/types.rs b/ibc-testkit/src/testapp/ibc/core/types.rs
index 7e365c49c..a1296cf6a 100644
--- a/ibc-testkit/src/testapp/ibc/core/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/types.rs
@@ -1,779 +1,200 @@
 //! Implementation of a global context mock. Used in testing handlers of all IBC modules.
 
 use alloc::sync::Arc;
-use core::cmp::min;
 use core::fmt::Debug;
-use core::ops::{Add, Sub};
-use core::time::Duration;
 
-use ibc::clients::tendermint::client_state::ClientState as TmClientState;
-use ibc::clients::tendermint::types::TENDERMINT_CLIENT_TYPE;
+use basecoin_store::context::{ProvableStore, Store};
+use basecoin_store::impls::SharedStore;
+use basecoin_store::types::{BinStore, JsonStore, ProtobufStore, TypedSet, TypedStore};
 use ibc::core::channel::types::channel::ChannelEnd;
 use ibc::core::channel::types::commitment::{AcknowledgementCommitment, PacketCommitment};
-use ibc::core::channel::types::packet::Receipt;
+use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::types::Height;
 use ibc::core::connection::types::ConnectionEnd;
-use ibc::core::entrypoint::dispatch;
 use ibc::core::handler::types::events::IbcEvent;
-use ibc::core::handler::types::msgs::MsgEnvelope;
-use ibc::core::host::types::identifiers::{
-    ChainId, ChannelId, ClientId, ClientType, ConnectionId, PortId, Sequence,
+use ibc::core::host::types::identifiers::{ConnectionId, Sequence};
+use ibc::core::host::types::path::{
+    AckPath, ChannelEndPath, ClientConnectionPath, ClientConsensusStatePath, ClientStatePath,
+    ClientUpdateHeightPath, ClientUpdateTimePath, CommitmentPath, ConnectionPath,
+    NextChannelSequencePath, NextClientSequencePath, NextConnectionSequencePath, ReceiptPath,
+    SeqAckPath, SeqRecvPath, SeqSendPath,
 };
-use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::Timestamp;
-use ibc::core::router::router::Router;
+use ibc_proto::google::protobuf::Any;
+use ibc_proto::ibc::core::channel::v1::Channel as RawChannelEnd;
+use ibc_proto::ibc::core::client::v1::Height as RawHeight;
+use ibc_proto::ibc::core::connection::v1::ConnectionEnd as RawConnectionEnd;
+use ibc_proto::ics23::CommitmentProof;
 use parking_lot::Mutex;
-use tendermint_testgen::Validator as TestgenValidator;
 use typed_builder::TypedBuilder;
 
-use super::client_ctx::{MockClientRecord, PortChannelIdMap};
-use crate::fixtures::clients::tendermint::ClientStateConfig as TmClientStateConfig;
-use crate::fixtures::core::context::MockContextConfig;
-use crate::hosts::block::{HostBlock, HostType};
-use crate::relayer::error::RelayerError;
-use crate::testapp::ibc::clients::mock::client_state::{
-    client_type as mock_client_type, MockClientState, MOCK_CLIENT_TYPE,
-};
-use crate::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
+use crate::context::{MockStore, TestContext};
+use crate::fixtures::core::context::TestContextConfig;
+use crate::hosts::{HostClientState, TestBlock, TestHeader, TestHost};
 use crate::testapp::ibc::clients::mock::header::MockHeader;
 use crate::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 pub const DEFAULT_BLOCK_TIME_SECS: u64 = 3;
 
-/// An object that stores all IBC related data.
-#[derive(Clone, Debug, Default)]
-pub struct MockIbcStore {
-    /// The set of all clients, indexed by their id.
-    pub clients: BTreeMap<ClientId, MockClientRecord>,
-
-    /// Tracks the processed time for clients header updates
-    pub client_processed_times: BTreeMap<(ClientId, Height), Timestamp>,
-
-    /// Tracks the processed height for the clients
-    pub client_processed_heights: BTreeMap<(ClientId, Height), Height>,
-
-    /// Counter for the client identifiers, necessary for `increase_client_counter` and the
-    /// `client_counter` methods.
-    pub client_ids_counter: u64,
-
-    /// Association between client ids and connection ids.
-    pub client_connections: BTreeMap<ClientId, ConnectionId>,
-
-    /// All the connections in the store.
-    pub connections: BTreeMap<ConnectionId, ConnectionEnd>,
-
-    /// Counter for connection identifiers (see `increase_connection_counter`).
-    pub connection_ids_counter: u64,
-
-    /// Association between connection ids and channel ids.
-    pub connection_channels: BTreeMap<ConnectionId, Vec<(PortId, ChannelId)>>,
-
-    /// Counter for channel identifiers (see `increase_channel_counter`).
-    pub channel_ids_counter: u64,
-
-    /// All the channels in the store. TODO Make new key PortId X ChannelId
-    pub channels: PortChannelIdMap<ChannelEnd>,
+pub type DefaultIbcStore = MockIbcStore<MockStore>;
 
-    /// Tracks the sequence number for the next packet to be sent.
-    pub next_sequence_send: PortChannelIdMap<Sequence>,
-
-    /// Tracks the sequence number for the next packet to be received.
-    pub next_sequence_recv: PortChannelIdMap<Sequence>,
-
-    /// Tracks the sequence number for the next packet to be acknowledged.
-    pub next_sequence_ack: PortChannelIdMap<Sequence>,
-
-    pub packet_acknowledgement: PortChannelIdMap<BTreeMap<Sequence, AcknowledgementCommitment>>,
-
-    /// Constant-size commitments to packets data fields
-    pub packet_commitment: PortChannelIdMap<BTreeMap<Sequence, PacketCommitment>>,
-
-    /// Used by unordered channel
-    pub packet_receipt: PortChannelIdMap<BTreeMap<Sequence, Receipt>>,
-
-    /// Emitted IBC events in order
-    pub events: Vec<IbcEvent>,
-
-    /// Logs of the IBC module
-    pub logs: Vec<String>,
-}
-
-/// A context implementing the dependencies necessary for testing any IBC module.
+/// An object that stores all IBC related data.
 #[derive(Debug)]
-pub struct MockContext {
-    /// The type of host chain underlying this mock context.
-    pub host_chain_type: HostType,
-
-    /// Host chain identifier.
-    pub host_chain_id: ChainId,
-
-    /// Maximum size for the history of the host chain. Any block older than this is pruned.
-    pub max_history_size: u64,
-
-    /// The chain of blocks underlying this context. A vector of size up to `max_history_size`
-    /// blocks, ascending order by their height (latest block is on the last position).
-    pub history: Vec<HostBlock>,
-
-    /// Average time duration between blocks
-    pub block_time: Duration,
-
-    /// An object that stores all IBC related data.
-    pub ibc_store: Arc<Mutex<MockIbcStore>>,
-}
-
-#[derive(Debug, TypedBuilder)]
-pub struct MockClientConfig {
-    #[builder(default = ChainId::new("mockZ-1").expect("no error"))]
-    client_chain_id: ChainId,
-    #[builder(default = ClientId::new("07-tendermint", 0).expect("no error"))]
-    client_id: ClientId,
-    #[builder(default = mock_client_type())]
-    client_type: ClientType,
-    latest_height: Height,
-    #[builder(default)]
-    consensus_state_heights: Vec<Height>,
-    #[builder(default = Timestamp::now())]
-    latest_timestamp: Timestamp,
-
-    #[builder(default = Duration::from_secs(64000))]
-    trusting_period: Duration,
-    #[builder(default = Duration::from_millis(3000))]
-    max_clock_drift: Duration,
-    #[builder(default = Duration::from_secs(128_000))]
-    unbonding_period: Duration,
-}
-
-/// Returns a MockContext with bare minimum initialization: no clients, no connections and no channels are
-/// present, and the chain has Height(5). This should be used sparingly, mostly for testing the
-/// creation of new domain objects.
-impl Default for MockContext {
-    fn default() -> Self {
-        MockContextConfig::builder().build()
-    }
-}
-
-/// A manual clone impl is provided because the tests are oblivious to the fact that the `ibc_store`
-/// is a shared ptr.
-impl Clone for MockContext {
-    fn clone(&self) -> Self {
-        let ibc_store = {
-            let ibc_store = self.ibc_store.lock().clone();
-            Arc::new(Mutex::new(ibc_store))
-        };
-
-        Self {
-            host_chain_type: self.host_chain_type,
-            host_chain_id: self.host_chain_id.clone(),
-            max_history_size: self.max_history_size,
-            history: self.history.clone(),
-            block_time: self.block_time,
-            ibc_store,
-        }
-    }
+pub struct MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
+    /// chain revision number,
+    pub revision_number: Arc<Mutex<u64>>,
+
+    /// Handle to store instance.
+    /// The module is guaranteed exclusive access to all paths in the store key-space.
+    pub store: SharedStore<S>,
+    /// A typed-store for next client counter sequence
+    pub client_counter: JsonStore<SharedStore<S>, NextClientSequencePath, u64>,
+    /// A typed-store for next connection counter sequence
+    pub conn_counter: JsonStore<SharedStore<S>, NextConnectionSequencePath, u64>,
+    /// A typed-store for next channel counter sequence
+    pub channel_counter: JsonStore<SharedStore<S>, NextChannelSequencePath, u64>,
+    /// Tracks the processed time for client updates
+    pub client_processed_times: JsonStore<SharedStore<S>, ClientUpdateTimePath, Timestamp>,
+    /// A typed-store to track the processed height for client updates
+    pub client_processed_heights:
+        ProtobufStore<SharedStore<S>, ClientUpdateHeightPath, Height, RawHeight>,
+    /// A typed-store for AnyClientState
+    pub client_state_store: ProtobufStore<SharedStore<S>, ClientStatePath, AnyClientState, Any>,
+    /// A typed-store for AnyConsensusState
+    pub consensus_state_store:
+        ProtobufStore<SharedStore<S>, ClientConsensusStatePath, AnyConsensusState, Any>,
+    /// A typed-store for ConnectionEnd
+    pub connection_end_store:
+        ProtobufStore<SharedStore<S>, ConnectionPath, ConnectionEnd, RawConnectionEnd>,
+    /// A typed-store for ConnectionIds
+    pub connection_ids_store: JsonStore<SharedStore<S>, ClientConnectionPath, Vec<ConnectionId>>,
+    /// A typed-store for ChannelEnd
+    pub channel_end_store: ProtobufStore<SharedStore<S>, ChannelEndPath, ChannelEnd, RawChannelEnd>,
+    /// A typed-store for send sequences
+    pub send_sequence_store: JsonStore<SharedStore<S>, SeqSendPath, Sequence>,
+    /// A typed-store for receive sequences
+    pub recv_sequence_store: JsonStore<SharedStore<S>, SeqRecvPath, Sequence>,
+    /// A typed-store for ack sequences
+    pub ack_sequence_store: JsonStore<SharedStore<S>, SeqAckPath, Sequence>,
+    /// A typed-store for packet commitments
+    pub packet_commitment_store: BinStore<SharedStore<S>, CommitmentPath, PacketCommitment>,
+    /// A typed-store for packet receipts
+    pub packet_receipt_store: TypedSet<SharedStore<S>, ReceiptPath>,
+    /// A typed-store for packet ack
+    pub packet_ack_store: BinStore<SharedStore<S>, AckPath, AcknowledgementCommitment>,
+    /// Map of host consensus states
+    pub host_consensus_states: Arc<Mutex<BTreeMap<u64, AnyConsensusState>>>,
+    /// Map of older ibc commitment proofs
+    pub ibc_commiment_proofs: Arc<Mutex<BTreeMap<u64, CommitmentProof>>>,
+    /// IBC Events
+    pub events: Arc<Mutex<Vec<IbcEvent>>>,
+    /// message logs
+    pub logs: Arc<Mutex<Vec<String>>>,
 }
 
-/// Implementation of internal interface for use in testing. The methods in this interface should
-/// _not_ be accessible to any Ics handler.
-impl MockContext {
-    /// Creates a mock context. Parameter `max_history_size` determines how many blocks will
-    /// the chain maintain in its history, which also determines the pruning window. Parameter
-    /// `latest_height` determines the current height of the chain. This context
-    /// has support to emulate two type of underlying chains: Mock or SyntheticTendermint.
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockContextConfig::builder().build()` instead"
-    )]
-    pub fn new(
-        host_id: ChainId,
-        host_type: HostType,
-        max_history_size: u64,
-        latest_height: Height,
-    ) -> Self {
-        assert_ne!(
-            max_history_size, 0,
-            "The chain must have a non-zero max_history_size"
-        );
-
-        assert_ne!(
-            latest_height.revision_height(),
-            0,
-            "The chain must have a non-zero revision_height"
-        );
+impl<S> MockIbcStore<S>
+where
+    S: ProvableStore + Debug,
+{
+    pub fn new(revision_number: u64, store: S) -> Self {
+        let shared_store = SharedStore::new(store);
 
-        // Compute the number of blocks to store.
-        let n = min(max_history_size, latest_height.revision_height());
+        let mut client_counter = TypedStore::new(shared_store.clone());
+        let mut conn_counter = TypedStore::new(shared_store.clone());
+        let mut channel_counter = TypedStore::new(shared_store.clone());
 
-        assert_eq!(
-            host_id.revision_number(),
-            latest_height.revision_number(),
-            "The version in the chain identifier must match the version in the latest height"
-        );
+        client_counter
+            .set(NextClientSequencePath, 0)
+            .expect("no error");
 
-        let block_time = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
-        let next_block_timestamp = Timestamp::now().add(block_time).expect("Never fails");
-        MockContext {
-            host_chain_type: host_type,
-            host_chain_id: host_id.clone(),
-            max_history_size,
-            history: (0..n)
-                .rev()
-                .map(|i| {
-                    // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                    // where N = now(), BT = block_time
-                    HostBlock::generate_block(
-                        host_id.clone(),
-                        host_type,
-                        latest_height.sub(i).expect("Never fails").revision_height(),
-                        next_block_timestamp
-                            .sub(Duration::from_secs(DEFAULT_BLOCK_TIME_SECS * (i + 1)))
-                            .expect("Never fails"),
-                    )
-                })
-                .collect(),
-            block_time,
-            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
-        }
-    }
+        conn_counter
+            .set(NextConnectionSequencePath, 0)
+            .expect("no error");
 
-    /// Same as [Self::new] but with custom validator sets for each block.
-    /// Note: the validator history is used accordingly for current validator set and next validator set.
-    /// `validator_history[i]` and `validator_history[i+1]` is i'th block's current and next validator set.
-    /// The number of blocks will be `validator_history.len() - 1` due to the above.
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockContextConfig::builder().build()` instead"
-    )]
-    pub fn new_with_validator_history(
-        host_id: ChainId,
-        host_type: HostType,
-        validator_history: &[Vec<TestgenValidator>],
-        latest_height: Height,
-    ) -> Self {
-        let max_history_size = validator_history.len() as u64 - 1;
+        channel_counter
+            .set(NextChannelSequencePath, 0)
+            .expect("no error");
 
-        assert_ne!(
-            max_history_size, 0,
-            "The chain must have a non-zero max_history_size"
-        );
-
-        assert_ne!(
-            latest_height.revision_height(),
-            0,
-            "The chain must have a non-zero revision_height"
-        );
-
-        assert!(
-            max_history_size <= latest_height.revision_height(),
-            "The number of blocks must be greater than the number of validator set histories"
-        );
-
-        assert_eq!(
-            host_id.revision_number(),
-            latest_height.revision_number(),
-            "The version in the chain identifier must match the version in the latest height"
-        );
-
-        let block_time = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
-        let next_block_timestamp = Timestamp::now().add(block_time).expect("Never fails");
-
-        let history = (0..max_history_size)
-            .rev()
-            .map(|i| {
-                // generate blocks with timestamps -> N, N - BT, N - 2BT, ...
-                // where N = now(), BT = block_time
-                HostBlock::generate_block_with_validators(
-                    host_id.clone(),
-                    host_type,
-                    latest_height.sub(i).expect("Never fails").revision_height(),
-                    next_block_timestamp
-                        .sub(Duration::from_secs(DEFAULT_BLOCK_TIME_SECS * (i + 1)))
-                        .expect("Never fails"),
-                    &validator_history[(max_history_size - i) as usize - 1],
-                    &validator_history[(max_history_size - i) as usize],
-                )
-            })
-            .collect();
-
-        MockContext {
-            host_chain_type: host_type,
-            host_chain_id: host_id,
-            max_history_size,
-            history,
-            block_time,
-            ibc_store: Arc::new(Mutex::new(MockIbcStore::default())),
+        Self {
+            revision_number: Arc::new(Mutex::new(revision_number)),
+            client_counter,
+            conn_counter,
+            channel_counter,
+            client_processed_times: TypedStore::new(shared_store.clone()),
+            client_processed_heights: TypedStore::new(shared_store.clone()),
+            host_consensus_states: Arc::new(Mutex::new(Default::default())),
+            ibc_commiment_proofs: Arc::new(Mutex::new(Default::default())),
+            client_state_store: TypedStore::new(shared_store.clone()),
+            consensus_state_store: TypedStore::new(shared_store.clone()),
+            connection_end_store: TypedStore::new(shared_store.clone()),
+            connection_ids_store: TypedStore::new(shared_store.clone()),
+            channel_end_store: TypedStore::new(shared_store.clone()),
+            send_sequence_store: TypedStore::new(shared_store.clone()),
+            recv_sequence_store: TypedStore::new(shared_store.clone()),
+            ack_sequence_store: TypedStore::new(shared_store.clone()),
+            packet_commitment_store: TypedStore::new(shared_store.clone()),
+            packet_receipt_store: TypedStore::new(shared_store.clone()),
+            packet_ack_store: TypedStore::new(shared_store.clone()),
+            events: Arc::new(Mutex::new(Vec::new())),
+            logs: Arc::new(Mutex::new(Vec::new())),
+            store: shared_store,
         }
     }
 
-    /// Associates a client record to this context.
-    /// Given a client id and a height, registers a new client in the context and also associates
-    /// to this client a mock client state and a mock consensus state for height `height`. The type
-    /// of this client is implicitly assumed to be Mock.
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockClientConfig::builder().build()` instead"
-    )]
-    pub fn with_client(self, client_id: &ClientId, height: Height) -> Self {
-        // NOTE: this is wrong; the client chain ID is supposed to represent
-        // the chain ID of the counterparty chain. But at this point this is
-        // too ingrained in our tests; `with_client()` is called everywhere,
-        // which delegates to this.
-        let client_chain_id = self.host_chain_id.clone();
-
-        self.with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(client_chain_id)
-                .client_id(client_id.clone())
-                .latest_height(height)
-                .build(),
-        )
-    }
-
-    /// Similar to `with_client`, this function associates a client record to this context, but
-    /// additionally permits to parametrize two details of the client. If `client_type` is None,
-    /// then the client will have type Mock, otherwise the specified type. If
-    /// `consensus_state_height` is None, then the client will be initialized with a consensus
-    /// state matching the same height as the client state (`client_state_height`).
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockClientConfig::builder().build()` instead"
-    )]
-    pub fn with_client_parametrized(
-        self,
-        client_id: &ClientId,
-        client_state_height: Height,
-        client_type: Option<ClientType>,
-        consensus_state_height: Option<Height>,
-    ) -> Self {
-        // NOTE: this is wrong; the client chain ID is supposed to represent
-        // the chain ID of the counterparty chain. But at this point this is
-        // too ingrained in our tests; `with_client()` is called everywhere,
-        // which delegates to this.
-        let client_chain_id = self.host_chain_id.clone();
-
-        self.with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(client_chain_id)
-                .client_id(client_id.clone())
-                .latest_height(client_state_height)
-                .client_type(client_type.unwrap_or_else(mock_client_type))
-                .consensus_state_heights(
-                    vec![consensus_state_height.unwrap_or(client_state_height)],
-                )
-                .build(),
-        )
-    }
-
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockClientConfig::builder().build()` instead"
-    )]
-    pub fn with_client_parametrized_with_chain_id(
-        self,
-        client_chain_id: ChainId,
-        client_id: &ClientId,
-        client_state_height: Height,
-        client_type: Option<ClientType>,
-        consensus_state_height: Option<Height>,
-    ) -> Self {
-        self.with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(client_chain_id)
-                .client_id(client_id.clone())
-                .latest_height(client_state_height)
-                .client_type(client_type.unwrap_or_else(mock_client_type))
-                .consensus_state_heights(
-                    vec![consensus_state_height.unwrap_or(client_state_height)],
-                )
-                .build(),
-        )
-    }
-
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockClientConfig::builder().build()` instead"
-    )]
-    pub fn with_client_parametrized_history(
-        self,
-        client_id: &ClientId,
-        client_state_height: Height,
-        client_type: Option<ClientType>,
-        consensus_state_height: Option<Height>,
-    ) -> Self {
-        let client_chain_id = self.host_chain_id.clone();
-        let current_consensus_height = consensus_state_height.unwrap_or(client_state_height);
-        let prev_consensus_height = current_consensus_height
-            .sub(1)
-            .unwrap_or(client_state_height);
-        self.with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(client_chain_id)
-                .client_id(client_id.clone())
-                .latest_height(client_state_height)
-                .client_type(client_type.unwrap_or_else(mock_client_type))
-                .consensus_state_heights(vec![prev_consensus_height, current_consensus_height])
-                .build(),
-        )
-    }
-
-    #[deprecated(
-        since = "0.50.0",
-        note = "Please use `MockClientConfig::builder().build()` instead"
-    )]
-    pub fn with_client_parametrized_history_with_chain_id(
-        self,
-        client_chain_id: ChainId,
-        client_id: &ClientId,
-        client_state_height: Height,
-        client_type: Option<ClientType>,
-        consensus_state_height: Option<Height>,
-    ) -> Self {
-        let current_consensus_height = consensus_state_height.unwrap_or(client_state_height);
-        let prev_consensus_height = current_consensus_height
-            .sub(1)
-            .unwrap_or(client_state_height);
-        self.with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(client_chain_id)
-                .client_id(client_id.clone())
-                .latest_height(client_state_height)
-                .client_type(client_type.unwrap_or_else(mock_client_type))
-                .consensus_state_heights(vec![prev_consensus_height, current_consensus_height])
-                .build(),
-        )
-    }
-
-    pub fn with_client_config(self, client: MockClientConfig) -> Self {
-        let cs_heights = if client.consensus_state_heights.is_empty() {
-            vec![client.latest_height]
-        } else {
-            client.consensus_state_heights
-        };
-
-        fn blocks_since(a: Height, b: Height) -> Option<u64> {
-            (a.revision_number() == b.revision_number()
-                && a.revision_height() >= b.revision_height())
-            .then(|| a.revision_height() - b.revision_height())
-        }
-
-        let (client_state, consensus_states) = match client.client_type.as_str() {
-            MOCK_CLIENT_TYPE => {
-                let blocks: Vec<_> = cs_heights
-                    .into_iter()
-                    .map(|cs_height| {
-                        let n_blocks = blocks_since(client.latest_height, cs_height)
-                            .expect("less or equal height");
-                        (
-                            cs_height,
-                            MockHeader::new(cs_height).with_timestamp(
-                                client
-                                    .latest_timestamp
-                                    .sub(self.block_time * (n_blocks as u32))
-                                    .expect("never fails"),
-                            ),
-                        )
-                    })
-                    .collect();
-
-                let client_state = MockClientState::new(
-                    MockHeader::new(client.latest_height).with_timestamp(client.latest_timestamp),
-                );
-
-                let cs_states = blocks
-                    .into_iter()
-                    .map(|(height, block)| (height, MockConsensusState::new(block).into()))
-                    .collect();
-
-                (client_state.into(), cs_states)
-            }
-            TENDERMINT_CLIENT_TYPE => {
-                let blocks: Vec<_> = cs_heights
-                    .into_iter()
-                    .map(|cs_height| {
-                        let n_blocks = blocks_since(client.latest_height, cs_height)
-                            .expect("less or equal height");
-                        (
-                            cs_height,
-                            HostBlock::generate_tm_block(
-                                client.client_chain_id.clone(),
-                                cs_height.revision_height(),
-                                client
-                                    .latest_timestamp
-                                    .sub(self.block_time * (n_blocks as u32))
-                                    .expect("never fails"),
-                            ),
-                        )
-                    })
-                    .collect();
-
-                let client_state: TmClientState = TmClientStateConfig::builder()
-                    .chain_id(client.client_chain_id)
-                    .latest_height(client.latest_height)
-                    .trusting_period(client.trusting_period)
-                    .max_clock_drift(client.max_clock_drift)
-                    .unbonding_period(client.unbonding_period)
-                    .build()
-                    .try_into()
-                    .expect("never fails");
-
-                client_state.inner().validate().expect("never fails");
-
-                let cs_states = blocks
-                    .into_iter()
-                    .map(|(height, block)| (height, block.into()))
-                    .collect();
-
-                (client_state.into(), cs_states)
-            }
-            _ => panic!("unknown client type"),
-        };
-
-        let client_record = MockClientRecord {
-            client_state: Some(client_state),
-            consensus_states,
-        };
-
-        self.ibc_store
-            .lock()
-            .clients
-            .insert(client.client_id, client_record);
-        self
-    }
-
-    /// Associates a connection to this context.
-    pub fn with_connection(
-        self,
-        connection_id: ConnectionId,
-        connection_end: ConnectionEnd,
-    ) -> Self {
-        self.ibc_store
+    fn store_host_consensus_state(&mut self, height: u64, consensus_state: AnyConsensusState) {
+        self.host_consensus_states
             .lock()
-            .connections
-            .insert(connection_id, connection_end);
-        self
+            .insert(height, consensus_state);
     }
 
-    /// Associates a channel (in an arbitrary state) to this context.
-    pub fn with_channel(
-        self,
-        port_id: PortId,
-        chan_id: ChannelId,
-        channel_end: ChannelEnd,
-    ) -> Self {
-        let mut channels = self.ibc_store.lock().channels.clone();
-        channels
-            .entry(port_id)
-            .or_default()
-            .insert(chan_id, channel_end);
-        self.ibc_store.lock().channels = channels;
-        self
-    }
-
-    pub fn with_send_sequence(
-        self,
-        port_id: PortId,
-        chan_id: ChannelId,
-        seq_number: Sequence,
-    ) -> Self {
-        let mut next_sequence_send = self.ibc_store.lock().next_sequence_send.clone();
-        next_sequence_send
-            .entry(port_id)
-            .or_default()
-            .insert(chan_id, seq_number);
-        self.ibc_store.lock().next_sequence_send = next_sequence_send;
-        self
-    }
-
-    pub fn with_recv_sequence(
-        self,
-        port_id: PortId,
-        chan_id: ChannelId,
-        seq_number: Sequence,
-    ) -> Self {
-        let mut next_sequence_recv = self.ibc_store.lock().next_sequence_recv.clone();
-        next_sequence_recv
-            .entry(port_id)
-            .or_default()
-            .insert(chan_id, seq_number);
-        self.ibc_store.lock().next_sequence_recv = next_sequence_recv;
-        self
-    }
-
-    pub fn with_ack_sequence(
-        self,
-        port_id: PortId,
-        chan_id: ChannelId,
-        seq_number: Sequence,
-    ) -> Self {
-        let mut next_sequence_ack = self.ibc_store.lock().next_sequence_send.clone();
-        next_sequence_ack
-            .entry(port_id)
-            .or_default()
-            .insert(chan_id, seq_number);
-        self.ibc_store.lock().next_sequence_ack = next_sequence_ack;
-        self
-    }
-
-    pub fn with_height(self, target_height: Height) -> Self {
-        let latest_height = self.latest_height();
-        if target_height.revision_number() > latest_height.revision_number() {
-            unimplemented!()
-        } else if target_height.revision_number() < latest_height.revision_number() {
-            panic!("Cannot rewind history of the chain to a smaller revision number!")
-        } else if target_height.revision_height() < latest_height.revision_height() {
-            panic!("Cannot rewind history of the chain to a smaller revision height!")
-        } else if target_height.revision_height() > latest_height.revision_height() {
-            // Repeatedly advance the host chain height till we hit the desired height
-            let mut ctx = self;
-            while ctx.latest_height().revision_height() < target_height.revision_height() {
-                ctx.advance_host_chain_height()
-            }
-            ctx
-        } else {
-            // Both the revision number and height match
-            self
-        }
+    fn store_ibc_commitment_proof(&mut self, height: u64, proof: CommitmentProof) {
+        self.ibc_commiment_proofs.lock().insert(height, proof);
     }
 
-    pub fn with_packet_commitment(
-        self,
-        port_id: PortId,
-        chan_id: ChannelId,
-        seq: Sequence,
-        data: PacketCommitment,
-    ) -> Self {
-        let mut packet_commitment = self.ibc_store.lock().packet_commitment.clone();
-        packet_commitment
-            .entry(port_id)
-            .or_default()
-            .entry(chan_id)
-            .or_default()
-            .insert(seq, data);
-        self.ibc_store.lock().packet_commitment = packet_commitment;
-        self
-    }
-
-    /// Accessor for a block of the local (host) chain from this context.
-    /// Returns `None` if the block at the requested height does not exist.
-    pub fn host_block(&self, target_height: &Height) -> Option<&HostBlock> {
-        let target = target_height.revision_height();
-        let latest = self.latest_height().revision_height();
-
-        // Check that the block is not too advanced, nor has it been pruned.
-        if (target > latest) || (target <= latest - self.history.len() as u64) {
-            None // Block for requested height does not exist in history.
-        } else {
-            Some(&self.history[self.history.len() + target as usize - latest as usize - 1])
-        }
-    }
-
-    /// Triggers the advancing of the host chain, by extending the history of blocks (or headers).
-    pub fn advance_host_chain_height(&mut self) {
-        let latest_block = self.history.last().expect("history cannot be empty");
-        let new_block = HostBlock::generate_block(
-            self.host_chain_id.clone(),
-            self.host_chain_type,
-            latest_block.height().increment().revision_height(),
-            latest_block
-                .timestamp()
-                .add(self.block_time)
-                .expect("Never fails"),
-        );
-
-        // Append the new header at the tip of the history.
-        if self.history.len() as u64 >= self.max_history_size {
-            // History is full, we rotate and replace the tip with the new header.
-            self.history.rotate_left(1);
-            self.history[self.max_history_size as usize - 1] = new_block;
-        } else {
-            // History is not full yet.
-            self.history.push(new_block);
-        }
-    }
-
-    /// A datagram passes from the relayer to the IBC module (on host chain).
-    /// Alternative method to `Ics18Context::send` that does not exercise any serialization.
-    /// Used in testing the Ics18 algorithms, hence this may return a Ics18Error.
-    pub fn deliver(
+    pub fn begin_block(
         &mut self,
-        router: &mut impl Router,
-        msg: MsgEnvelope,
-    ) -> Result<(), RelayerError> {
-        dispatch(self, router, msg).map_err(RelayerError::TransactionFailed)?;
-        // Create a new block.
-        self.advance_host_chain_height();
-        Ok(())
-    }
-
-    /// Validates this context. Should be called after the context is mutated by a test.
-    pub fn validate(&self) -> Result<(), String> {
-        // Check that the number of entries is not higher than window size.
-        if self.history.len() as u64 > self.max_history_size {
-            return Err("too many entries".to_string());
-        }
-
-        // Check the content of the history.
-        if !self.history.is_empty() {
-            // Get the highest block.
-            let lh = &self.history[self.history.len() - 1];
-            // Check latest is properly updated with highest header height.
-            if lh.height() != self.latest_height() {
-                return Err("latest height is not updated".to_string());
-            }
-        }
-
-        // Check that headers in the history are in sequential order.
-        for i in 1..self.history.len() {
-            let ph = &self.history[i - 1];
-            let h = &self.history[i];
-            if ph.height().increment() != h.height() {
-                return Err("headers in history not sequential".to_string());
-            }
-        }
-        Ok(())
+        height: u64,
+        consensus_state: AnyConsensusState,
+        proof: CommitmentProof,
+    ) {
+        assert_eq!(self.store.current_height(), height);
+        self.store_host_consensus_state(height, consensus_state);
+        self.store_ibc_commitment_proof(height, proof);
     }
 
-    pub fn latest_client_states(&self, client_id: &ClientId) -> AnyClientState {
-        self.ibc_store.lock().clients[client_id]
-            .client_state
-            .as_ref()
-            .expect("Never fails")
-            .clone()
+    pub fn end_block(&mut self) -> Result<Vec<u8>, <SharedStore<S> as Store>::Error> {
+        self.store.commit()
     }
 
-    pub fn latest_consensus_states(
-        &self,
-        client_id: &ClientId,
-        height: &Height,
-    ) -> AnyConsensusState {
-        self.ibc_store.lock().clients[client_id]
-            .consensus_states
-            .get(height)
-            .expect("Never fails")
-            .clone()
-    }
-
-    pub fn latest_height(&self) -> Height {
-        self.history
-            .last()
-            .expect("history cannot be empty")
-            .height()
-    }
-
-    pub fn ibc_store_share(&self) -> Arc<Mutex<MockIbcStore>> {
-        self.ibc_store.clone()
-    }
-
-    pub fn query_latest_header(&self) -> Option<HostBlock> {
-        let block_ref = self.host_block(&self.host_height().expect("Never fails"));
-        block_ref.cloned()
-    }
-
-    pub fn get_events(&self) -> Vec<IbcEvent> {
-        self.ibc_store.lock().events.clone()
+    pub fn prune_host_consensus_states_till(&self, height: &Height) {
+        assert!(height.revision_number() == *self.revision_number.lock());
+        let mut history = self.host_consensus_states.lock();
+        history.retain(|h, _| h > &height.revision_height());
+        let mut commitment_proofs = self.ibc_commiment_proofs.lock();
+        commitment_proofs.retain(|h, _| h > &height.revision_height());
     }
+}
 
-    pub fn get_logs(&self) -> Vec<String> {
-        self.ibc_store.lock().logs.clone()
+impl<S> Default for MockIbcStore<S>
+where
+    S: ProvableStore + Debug + Default,
+{
+    fn default() -> Self {
+        // Note: this creates a MockIbcStore which has MockConsensusState as Host ConsensusState
+        let mut ibc_store = Self::new(0, S::default());
+        ibc_store.store.commit().expect("no error");
+        ibc_store.store_host_consensus_state(
+            ibc_store.store.current_height(),
+            MockHeader::default().into_consensus_state().into(),
+        );
+        ibc_store.store_ibc_commitment_proof(
+            ibc_store.store.current_height(),
+            CommitmentProof::default(),
+        );
+        ibc_store
     }
 }
 
@@ -784,8 +205,10 @@ mod tests {
     use ibc::core::channel::types::error::{ChannelError, PacketError};
     use ibc::core::channel::types::packet::Packet;
     use ibc::core::channel::types::Version;
+    use ibc::core::host::types::identifiers::{ChannelId, PortId};
     use ibc::core::primitives::Signer;
     use ibc::core::router::module::Module;
+    use ibc::core::router::router::Router;
     use ibc::core::router::types::module::{ModuleExtras, ModuleId};
 
     use super::*;
@@ -793,145 +216,6 @@ mod tests {
     use crate::fixtures::core::signer::dummy_bech32_account;
     use crate::testapp::ibc::core::router::MockRouter;
 
-    #[test]
-    fn test_history_manipulation() {
-        pub struct Test {
-            name: String,
-            ctx: MockContext,
-        }
-        let cv = 1; // The version to use for all chains.
-
-        let mock_chain_id = ChainId::new(&format!("mockgaia-{cv}")).unwrap();
-
-        let tests: Vec<Test> = vec![
-            Test {
-                name: "Empty history, small pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .max_history_size(2)
-                    .latest_height(Height::new(cv, 1).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "[Synthetic TM host] Empty history, small pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .host_type(HostType::SyntheticTendermint)
-                    .max_history_size(2)
-                    .latest_height(Height::new(cv, 1).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "Large pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .max_history_size(30)
-                    .latest_height(Height::new(cv, 2).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "[Synthetic TM host] Large pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .host_type(HostType::SyntheticTendermint)
-                    .max_history_size(30)
-                    .latest_height(Height::new(cv, 2).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "Small pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .max_history_size(3)
-                    .latest_height(Height::new(cv, 30).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "[Synthetic TM host] Small pruning window".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .host_type(HostType::SyntheticTendermint)
-                    .max_history_size(3)
-                    .latest_height(Height::new(cv, 30).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "Small pruning window, small starting height".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .max_history_size(3)
-                    .latest_height(Height::new(cv, 2).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "[Synthetic TM host] Small pruning window, small starting height".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .host_type(HostType::SyntheticTendermint)
-                    .max_history_size(3)
-                    .latest_height(Height::new(cv, 2).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "Large pruning window, large starting height".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id.clone())
-                    .max_history_size(50)
-                    .latest_height(Height::new(cv, 2000).expect("Never fails"))
-                    .build(),
-            },
-            Test {
-                name: "[Synthetic TM host] Large pruning window, large starting height".to_string(),
-                ctx: MockContextConfig::builder()
-                    .host_id(mock_chain_id)
-                    .host_type(HostType::SyntheticTendermint)
-                    .max_history_size(50)
-                    .latest_height(Height::new(cv, 2000).expect("Never fails"))
-                    .build(),
-            },
-        ];
-
-        for mut test in tests {
-            // All tests should yield a valid context after initialization.
-            assert!(
-                test.ctx.validate().is_ok(),
-                "failed in test {} while validating context {:?}",
-                test.name,
-                test.ctx
-            );
-
-            let current_height = test.ctx.latest_height();
-
-            // After advancing the chain's height, the context should still be valid.
-            test.ctx.advance_host_chain_height();
-            assert!(
-                test.ctx.validate().is_ok(),
-                "failed in test {} while validating context {:?}",
-                test.name,
-                test.ctx
-            );
-
-            let next_height = current_height.increment();
-            assert_eq!(
-                test.ctx.latest_height(),
-                next_height,
-                "failed while increasing height for context {:?}",
-                test.ctx
-            );
-
-            assert_eq!(
-                test.ctx
-                    .host_block(&current_height)
-                    .expect("Never fails")
-                    .height(),
-                current_height,
-                "failed while fetching height {:?} of context {:?}",
-                current_height,
-                test.ctx
-            );
-        }
-    }
-
     #[test]
     fn test_router() {
         #[derive(Debug, Default)]
@@ -1158,3 +442,63 @@ mod tests {
         ];
     }
 }
+
+pub struct LightClientState<H: TestHost> {
+    pub client_state: H::ClientState,
+    pub consensus_states:
+        BTreeMap<Height, <<H::Block as TestBlock>::Header as TestHeader>::ConsensusState>,
+}
+
+impl<H> Default for LightClientState<H>
+where
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+{
+    fn default() -> Self {
+        let context = TestContext::<H>::default();
+        LightClientBuilder::init().context(&context).build()
+    }
+}
+
+impl<H> LightClientState<H>
+where
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+{
+    pub fn with_latest_height(height: Height) -> Self {
+        let context = TestContextConfig::builder()
+            .latest_height(height)
+            .build::<TestContext<_>>();
+        LightClientBuilder::init().context(&context).build()
+    }
+}
+
+#[derive(TypedBuilder)]
+#[builder(builder_method(name = init), build_method(into))]
+pub struct LightClientBuilder<'a, H>
+where
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+{
+    context: &'a TestContext<H>,
+    #[builder(default, setter(into))]
+    consensus_heights: Vec<Height>,
+    #[builder(default)]
+    params: H::LightClientParams,
+}
+
+impl<'a, H> From<LightClientBuilder<'a, H>> for LightClientState<H>
+where
+    H: TestHost,
+    HostClientState<H>: ClientStateValidation<DefaultIbcStore>,
+{
+    fn from(builder: LightClientBuilder<'a, H>) -> Self {
+        let LightClientBuilder {
+            context,
+            consensus_heights,
+            params,
+        } = builder;
+
+        context.generate_light_client(consensus_heights, &params)
+    }
+}
diff --git a/ibc-testkit/src/utils/mod.rs b/ibc-testkit/src/utils/mod.rs
new file mode 100644
index 000000000..80eb0bad4
--- /dev/null
+++ b/ibc-testkit/src/utils/mod.rs
@@ -0,0 +1,17 @@
+use ibc::primitives::Timestamp;
+use tendermint::Time;
+
+/// Returns a `Timestamp` representation of beginning of year 2023.
+///
+/// This is introduced to initialize [`StoreGenericTestContext`](crate::context::StoreGenericTestContext)s
+/// with the same latest timestamp by default.
+/// If two [`StoreGenericTestContext`](crate::context::StoreGenericTestContext)
+/// are initialized using [`Time::now()`], second one will have a greater timestamp than the first one.
+/// So, the latest header of the second context can not be submitted to first one.
+/// We can still set a custom timestamp via [`TestContextConfig`](crate::fixtures::core::context::TestContextConfig).
+pub fn year_2023() -> Timestamp {
+    // Sun Jan 01 2023 00:00:00 GMT+0000
+    Time::from_unix_timestamp(1_672_531_200, 0)
+        .expect("should be a valid time")
+        .into()
+}
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/ibc-testkit/tests/core/ics02_client/create_client.rs
index 447af33fd..3f8bd4bc8 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/create_client.rs
@@ -1,3 +1,4 @@
+use basecoin_store::impls::InMemoryStore;
 use ibc::clients::tendermint::types::{
     client_type as tm_client_type, ConsensusState as TmConsensusState,
 };
@@ -6,26 +7,33 @@ use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::error::ClientError;
 use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient};
 use ibc::core::client::types::Height;
+use ibc::core::commitment_types::error::CommitmentError;
 use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::msgs::MsgEnvelope;
+use ibc::core::host::types::identifiers::ClientId;
+use ibc::core::host::types::path::{ClientConsensusStatePath, NextClientSequencePath};
 use ibc::core::host::{ClientStateRef, ValidationContext};
+use ibc_query::core::context::ProvableContext;
+use ibc_testkit::context::{MockContext, TendermintContext};
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
 };
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
 };
 use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
+use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::{DefaultIbcStore, LightClientBuilder, MockIbcStore};
 use test_log::test;
 
 #[test]
 fn test_create_client_ok() {
-    let mut ctx = MockContext::default();
+    let mut ctx = DefaultIbcStore::default();
     let mut router = MockRouter::new_with_transfer();
     let signer = dummy_account_id();
     let height = Height::new(0, 42).unwrap();
@@ -49,7 +57,8 @@ fn test_create_client_ok() {
 
     assert!(res.is_ok(), "execution happy path");
 
-    let expected_client_state = ClientStateRef::<MockContext>::try_from(msg.client_state).unwrap();
+    let expected_client_state =
+        ClientStateRef::<DefaultIbcStore>::try_from(msg.client_state).unwrap();
     assert_eq!(expected_client_state.client_type(), client_type);
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
@@ -58,7 +67,7 @@ fn test_create_client_ok() {
 fn test_tm_create_client_ok() {
     let signer = dummy_account_id();
 
-    let mut ctx = MockContext::default();
+    let mut ctx = DefaultIbcStore::default();
 
     let mut router = MockRouter::new_with_transfer();
 
@@ -85,7 +94,8 @@ fn test_tm_create_client_ok() {
 
     assert!(res.is_ok(), "tendermint client execution happy path");
 
-    let expected_client_state = ClientStateRef::<MockContext>::try_from(msg.client_state).unwrap();
+    let expected_client_state =
+        ClientStateRef::<MockIbcStore<InMemoryStore>>::try_from(msg.client_state).unwrap();
     assert_eq!(expected_client_state.client_type(), client_type);
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
@@ -94,7 +104,7 @@ fn test_tm_create_client_ok() {
 fn test_invalid_frozen_tm_client_creation() {
     let signer = dummy_account_id();
 
-    let ctx = MockContext::default();
+    let ctx = DefaultIbcStore::default();
 
     let router = MockRouter::new_with_transfer();
 
@@ -111,12 +121,94 @@ fn test_invalid_frozen_tm_client_creation() {
         signer,
     );
 
-    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope.clone());
+    let res = validate(&ctx, &router, msg_envelope);
 
     assert!(matches!(
         res,
         Err(ContextError::ClientError(ClientError::ClientFrozen { .. }))
     ))
 }
+
+#[test]
+fn test_tm_create_client_proof_verification_ok() {
+    let client_id = ClientId::new("07-tendermint", 0).expect("no error");
+    let client_height = Height::new(0, 10).expect("no error");
+
+    let ctx_tm = TestContextConfig::builder()
+        .latest_height(client_height)
+        .build::<TendermintContext>();
+
+    let ctx_mk = MockContext::default().with_light_client(
+        &client_id,
+        LightClientBuilder::init().context(&ctx_tm).build(),
+    );
+
+    let client_validation_ctx_mk = ctx_mk.ibc_store().get_client_validation_context();
+
+    let (AnyClientState::Tendermint(tm_client_state),) = (client_validation_ctx_mk
+        .client_state(&client_id)
+        .expect("client state exists"),)
+    else {
+        panic!("client state is not valid")
+    };
+
+    let latest_client_height = tm_client_state.latest_height();
+    let consensus_state_path = ClientConsensusStatePath::new(
+        client_id.clone(),
+        latest_client_height.revision_number(),
+        latest_client_height.revision_height(),
+    );
+
+    let AnyConsensusState::Tendermint(tm_consensus_state) = client_validation_ctx_mk
+        .consensus_state(&consensus_state_path)
+        .expect("consensus_state exists")
+    else {
+        panic!("consensus state is not valid")
+    };
+
+    let next_client_seq_path = NextClientSequencePath;
+    let next_client_seq_value = client_validation_ctx_mk
+        .client_counter()
+        .expect("counter exists");
+
+    assert_eq!(
+        next_client_seq_value, 0,
+        "client counter is not incremented"
+    );
+
+    let proof = ctx_tm
+        .ibc_store()
+        .get_proof(ctx_tm.latest_height(), &next_client_seq_path.clone().into())
+        .expect("proof exists")
+        .try_into()
+        .expect("value merkle proof");
+
+    let root = tm_consensus_state.inner().root();
+
+    // correct value verification
+    tm_client_state
+        .verify_membership(
+            &ctx_tm.ibc_store().commitment_prefix(),
+            &proof,
+            &root,
+            next_client_seq_path.clone().into(),
+            serde_json::to_vec(&next_client_seq_value).expect("valid json serialization"),
+        )
+        .expect("successful proof verification");
+
+    // incorrect value verification
+    assert!(matches!(
+        tm_client_state
+            .verify_membership(
+                &ctx_tm.ibc_store().commitment_prefix(),
+                &proof,
+                &root,
+                next_client_seq_path.into(),
+                serde_json::to_vec(&(next_client_seq_value + 1)).expect("valid json serialization"),
+            )
+            .expect_err("proof verification fails"),
+        ClientError::Ics23Verification(CommitmentError::VerificationFailure)
+    ));
+}
diff --git a/ibc-testkit/tests/core/ics02_client/recover_client.rs b/ibc-testkit/tests/core/ics02_client/recover_client.rs
index e99098d65..28f1de076 100644
--- a/ibc-testkit/tests/core/ics02_client/recover_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/recover_client.rs
@@ -1,27 +1,28 @@
 use core::time::Duration;
 
+use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::handler::recover_client;
 use ibc::core::client::types::msgs::{ClientMsg, MsgCreateClient, MsgRecoverClient};
-use ibc::core::client::types::Height;
-use ibc::core::entrypoint::{execute, validate};
+use ibc::core::client::types::{Height, Status as ClientStatus};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::host::ValidationContext;
-use ibc::core::primitives::{Signer, Timestamp};
+use ibc::core::primitives::Signer;
+use ibc_testkit::context::{MockContext, TendermintContext};
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
+use ibc_testkit::hosts::{TestBlock, TestHost};
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
 };
 use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
-use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
-use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
+use ibc_testkit::testapp::ibc::core::types::DEFAULT_BLOCK_TIME_SECS;
 use rstest::*;
 
 struct Fixture {
-    ctx: MockContext,
+    ctx: TendermintContext,
     subject_client_id: ClientId,
     substitute_client_id: ClientId,
     signer: Signer,
@@ -41,50 +42,70 @@ fn setup_client_recovery_fixture(
     substitute_trusting_period: Duration,
     substitute_height: Height,
 ) -> Fixture {
-    let mut ctx = MockContext::default();
-    let mut router = MockRouter::new_with_transfer();
-    let signer = dummy_account_id();
+    let mut ctx = TendermintContext::default();
+
+    // create a ctx_b
+    let ctx_b: MockContext = TestContextConfig::builder()
+        .latest_height(substitute_height)
+        .build();
 
-    let subject_timestamp = (Timestamp::now() - subject_trusting_period).unwrap();
+    let signer = dummy_account_id();
 
-    // Create the subject client state such that it will be in an expired state by initializing it with
-    // a timestamp that is of duration `subject_trusting_period` in the past
-    let subject_client_state =
-        MockClientState::new(MockHeader::new(subject_height).with_timestamp(subject_timestamp))
-            .with_trusting_period(subject_trusting_period);
+    let subject_client_header = ctx_b
+        .host
+        .get_block(&subject_height)
+        .expect("block exists")
+        .into_header();
 
-    // Create the subject client
     let msg = MsgCreateClient::new(
-        subject_client_state.into(),
-        MockConsensusState::new(MockHeader::new(subject_height).with_current_timestamp()).into(),
+        MockClientState::new(subject_client_header)
+            .with_trusting_period(subject_trusting_period)
+            .into(),
+        MockConsensusState::new(subject_client_header).into(),
         signer.clone(),
     );
 
-    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+    let subject_msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
     let client_type = mock_client_type();
-    let subject_client_id = client_type.build_client_id(ctx.client_counter().unwrap());
+    let subject_client_id = client_type.build_client_id(ctx.ibc_store().client_counter().unwrap());
 
-    validate(&ctx, &router, msg_envelope.clone()).expect("create subject client validation");
-    execute(&mut ctx, &mut router, msg_envelope).expect("create subject client execution");
+    ctx.dispatch(subject_msg_envelope)
+        .expect("create subject client execution");
 
-    // Create the substitute client
-    let substitute_client_state =
-        MockClientState::new(MockHeader::new(substitute_height).with_current_timestamp())
-            .with_trusting_period(substitute_trusting_period);
+    let substitute_client_header = ctx_b
+        .host
+        .get_block(&substitute_height)
+        .expect("block exists")
+        .into_header();
 
     let msg = MsgCreateClient::new(
-        substitute_client_state.into(),
-        MockConsensusState::new(MockHeader::new(substitute_height).with_current_timestamp()).into(),
+        MockClientState::new(substitute_client_header)
+            .with_trusting_period(substitute_trusting_period)
+            .into(),
+        MockConsensusState::new(substitute_client_header).into(),
         signer.clone(),
     );
 
-    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+    let substitute_msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let substitute_client_id =
+        client_type.build_client_id(ctx.ibc_store().client_counter().unwrap());
 
-    let substitute_client_id = client_type.build_client_id(ctx.client_counter().unwrap());
+    ctx.dispatch(substitute_msg_envelope)
+        .expect("create substitute client execution");
 
-    validate(&ctx, &router, msg_envelope.clone()).expect("create substitute client validation");
-    execute(&mut ctx, &mut router, msg_envelope).expect("create substitute client execution");
+    let subject_client_trusted_timestamp =
+        (subject_client_header.timestamp() + subject_trusting_period).expect("no error");
+
+    // Let the subject client state expire.
+    while ctx.latest_timestamp() <= subject_client_trusted_timestamp {
+        ctx.advance_block_height();
+    }
+
+    // at this point, the subject client should be expired.
+    // and the substitute client should be active or expired according
+    // to the fixture arguments
 
     Fixture {
         ctx,
@@ -96,8 +117,8 @@ fn setup_client_recovery_fixture(
 
 #[rstest]
 fn test_recover_client_ok() {
-    let subject_trusting_period = Duration::from_nanos(100);
-    let substitute_trusting_period = Duration::from_secs(3);
+    let subject_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
+    let substitute_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS) * 10;
     let subject_height = Height::new(0, 42).unwrap();
     let substitute_height = Height::new(0, 43).unwrap();
 
@@ -113,47 +134,70 @@ fn test_recover_client_ok() {
         substitute_height,
     );
 
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&subject_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &subject_client_id)
+            .expect("no error"),
+        ClientStatus::Expired
+    );
+
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&substitute_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &substitute_client_id)
+            .expect("no error"),
+        ClientStatus::Active
+    );
+
     let msg = MsgRecoverClient {
         subject_client_id,
         substitute_client_id,
         signer,
     };
 
-    let res = recover_client::validate(&ctx, msg.clone());
-
-    assert!(res.is_ok(), "client recovery validation happy path");
-
-    let res = recover_client::execute(&mut ctx, msg.clone());
+    recover_client::validate(ctx.ibc_store_mut(), msg.clone())
+        .expect("client recovery execution happy path");
 
-    assert!(res.is_ok(), "client recovery execution happy path");
+    recover_client::execute(ctx.ibc_store_mut(), msg.clone())
+        .expect("client recovery execution happy path");
 
     // client state is copied.
     assert_eq!(
-        ctx.client_state(&msg.subject_client_id).unwrap(),
-        ctx.client_state(&msg.substitute_client_id).unwrap(),
+        ctx.ibc_store()
+            .client_state(&msg.subject_client_id)
+            .unwrap(),
+        ctx.ibc_store()
+            .client_state(&msg.substitute_client_id)
+            .unwrap(),
     );
 
     // latest consensus state is copied.
     assert_eq!(
-        ctx.consensus_state(&ClientConsensusStatePath::new(
-            msg.subject_client_id,
-            substitute_height.revision_number(),
-            substitute_height.revision_height(),
-        ))
-        .unwrap(),
-        ctx.consensus_state(&ClientConsensusStatePath::new(
-            msg.substitute_client_id,
-            substitute_height.revision_number(),
-            substitute_height.revision_height(),
-        ))
-        .unwrap(),
+        ctx.ibc_store()
+            .consensus_state(&ClientConsensusStatePath::new(
+                msg.subject_client_id,
+                substitute_height.revision_number(),
+                substitute_height.revision_height(),
+            ))
+            .unwrap(),
+        ctx.ibc_store()
+            .consensus_state(&ClientConsensusStatePath::new(
+                msg.substitute_client_id,
+                substitute_height.revision_number(),
+                substitute_height.revision_height(),
+            ))
+            .unwrap(),
     );
 }
 
 #[rstest]
 fn test_recover_client_with_expired_substitute() {
-    let subject_trusting_period = Duration::from_nanos(100);
-    let substitute_trusting_period = Duration::from_nanos(100);
+    // twice of DEFAULT_BLOCK_TIME_SECS to make sure the substitute client is expired as well
+    let subject_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS) * 2;
+    let substitute_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
     let subject_height = Height::new(0, 42).unwrap();
     let substitute_height = Height::new(0, 43).unwrap();
 
@@ -169,21 +213,38 @@ fn test_recover_client_with_expired_substitute() {
         substitute_height,
     );
 
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&subject_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &subject_client_id)
+            .expect("no error"),
+        ClientStatus::Expired
+    );
+
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&substitute_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &substitute_client_id)
+            .expect("no error"),
+        ClientStatus::Expired
+    );
+
     let msg = MsgRecoverClient {
         subject_client_id,
         substitute_client_id,
         signer,
     };
 
-    let res = recover_client::validate(&ctx, msg);
-
-    assert!(res.is_err(), "expected client recovery validation to fail");
+    recover_client::validate(ctx.ibc_store(), msg)
+        .expect_err("expected client recovery validation to fail");
 }
 
 #[rstest]
 fn test_recover_client_with_matching_heights() {
-    let subject_trusting_period = Duration::from_nanos(100);
-    let substitute_trusting_period = Duration::from_secs(3);
+    let subject_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS);
+    let substitute_trusting_period = Duration::from_secs(DEFAULT_BLOCK_TIME_SECS) * 10;
     let subject_height = Height::new(0, 42).unwrap();
     let substitute_height = Height::new(0, 42).unwrap();
 
@@ -199,13 +260,30 @@ fn test_recover_client_with_matching_heights() {
         substitute_height,
     );
 
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&subject_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &subject_client_id)
+            .expect("no error"),
+        ClientStatus::Expired
+    );
+
+    assert_eq!(
+        ctx.ibc_store()
+            .client_state(&substitute_client_id)
+            .expect("substitute client state exists")
+            .status(ctx.ibc_store(), &substitute_client_id)
+            .expect("no error"),
+        ClientStatus::Active
+    );
+
     let msg = MsgRecoverClient {
         subject_client_id,
         substitute_client_id,
         signer,
     };
 
-    let res = recover_client::validate(&ctx, msg);
-
-    assert!(res.is_err(), "expected client recovery validation to fail");
+    dbg!(recover_client::validate(ctx.ibc_store(), msg))
+        .expect_err("expected client recovery validation to fail");
 }
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 20828b529..9dbc49030 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -1,13 +1,15 @@
+use core::fmt::Debug;
 use core::str::FromStr;
 use core::time::Duration;
 
+use basecoin_store::context::ProvableStore;
 use ibc::clients::tendermint::client_state::ClientState;
 use ibc::clients::tendermint::types::proto::v1::{ClientState as RawTmClientState, Fraction};
 use ibc::clients::tendermint::types::{
     client_type as tm_client_type, ClientState as TmClientState, Header as TmHeader,
     Misbehaviour as TmMisbehaviour,
 };
-use ibc::core::client::context::client_state::{ClientStateCommon, ClientStateValidation};
+use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::context::ClientValidationContext;
 use ibc::core::client::types::msgs::{ClientMsg, MsgUpdateClient};
 use ibc::core::client::types::proto::v1::Height as RawHeight;
@@ -22,9 +24,15 @@ use ibc::core::host::ValidationContext;
 use ibc::core::primitives::Timestamp;
 use ibc::primitives::proto::Any;
 use ibc::primitives::ToVec;
-use ibc_testkit::fixtures::core::context::MockContextConfig;
+use ibc_testkit::context::{MockContext, TendermintContext, TestContext};
+use ibc_testkit::fixtures::clients::tendermint::ClientStateConfig;
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
-use ibc_testkit::hosts::block::{HostBlock, HostType};
+use ibc_testkit::hosts::tendermint::BlockParams;
+use ibc_testkit::hosts::{
+    HostClientState, MockHost, TendermintHost, TestBlock, TestHeader, TestHost,
+};
+use ibc_testkit::relayer::error::RelayerError;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
     client_type as mock_client_type, MockClientState,
 };
@@ -32,9 +40,12 @@ use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
 use ibc_testkit::testapp::ibc::clients::mock::misbehaviour::Misbehaviour as MockMisbehaviour;
 use ibc_testkit::testapp::ibc::clients::AnyConsensusState;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::{
+    DefaultIbcStore, LightClientBuilder, LightClientState, MockIbcStore,
+};
 use rstest::*;
 use tendermint_testgen::Validator as TestgenValidator;
+use tracing::debug;
 
 struct Fixture {
     ctx: MockContext,
@@ -45,11 +56,9 @@ struct Fixture {
 fn fixture() -> Fixture {
     let client_id = ClientId::new("07-tendermint", 0).expect("no error");
 
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
+    let ctx = MockContext::default().with_light_client(
+        &client_id,
+        LightClientState::<MockHost>::with_latest_height(Height::new(0, 42).unwrap()),
     );
 
     let router = MockRouter::new_with_transfer();
@@ -95,16 +104,16 @@ fn test_update_client_ok(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let res = validate(&ctx, &router, msg_envelope.clone());
+    let res = validate(&ctx.ibc_store, &router, msg_envelope.clone());
 
     assert!(res.is_ok(), "validation happy path");
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok(), "execution happy path");
 
     assert_eq!(
-        ctx.client_state(&msg.client_id).unwrap(),
+        ctx.ibc_store.client_state(&msg.client_id).unwrap(),
         MockClientState::new(MockHeader::new(height).with_timestamp(timestamp)).into()
     );
 }
@@ -120,14 +129,22 @@ fn test_update_client_with_prev_header() {
     let height_1 = Height::new(0, 43).unwrap();
     let height_2 = Height::new(0, 44).unwrap();
 
-    let mut ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_chain_id(chain_id_b.clone())
-            .client_type(tm_client_type())
-            .client_id(client_id.clone())
-            .latest_height(latest_height)
-            .build(),
-    );
+    let ctx_b = TestContextConfig::builder()
+        .host(
+            TendermintHost::builder()
+                .chain_id(chain_id_b.clone())
+                .build(),
+        )
+        .latest_height(latest_height)
+        .build::<TendermintContext>();
+
+    let mut ctx = MockContext::default()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init().context(&ctx_b).build(),
+        )
+        .ibc_store;
+
     let mut router = MockRouter::new_with_transfer();
 
     fn build_msg_from_header(
@@ -136,13 +153,18 @@ fn test_update_client_with_prev_header() {
         target_height: Height,
         trusted_height: Height,
     ) -> MsgEnvelope {
-        let mut tm_block = HostBlock::generate_tm_block(
-            chain_id,
-            target_height.revision_height(),
-            Timestamp::now(),
-        );
-
-        tm_block.trusted_height = trusted_height;
+        let mut tm_block = TendermintHost::builder()
+            .chain_id(chain_id)
+            .build()
+            .generate_block(
+                Vec::new(),
+                target_height.revision_height(),
+                Timestamp::now(),
+                &Default::default(),
+            )
+            .into_header();
+
+        tm_block.set_trusted_height(trusted_height);
 
         let msg = MsgUpdateClient {
             client_id,
@@ -187,8 +209,8 @@ fn test_update_client_with_prev_header() {
 /// Tests that the Tendermint client consensus state pruning logic
 /// functions correctly.
 ///
-/// This test sets up a MockContext with host height 1 and a trusting
-/// period of 3 seconds. It then advances the state of the MockContext
+/// This test sets up a `TendermintContext` with host height 1 and a trusting
+/// period of 3 seconds. It then advances the state of the `TendermintContext`
 /// by 2 heights, and thus 6 seconds, due to the DEFAULT_BLOCK_TIME_SECS
 /// constant being set to 3 seconds. At this point, the chain is at height
 /// 3. Any consensus states associated with a block more than 3 seconds
@@ -204,26 +226,31 @@ fn test_consensus_state_pruning() {
 
     let client_id = tm_client_type().build_client_id(0);
 
-    let mut ctx = MockContextConfig::builder()
-        .host_id(chain_id.clone())
-        .host_type(HostType::SyntheticTendermint)
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id.clone()).build())
+        .latest_height(client_height)
+        .build::<TendermintContext>();
+
+    let mut ctx = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id).build())
         .latest_height(client_height)
         .latest_timestamp(Timestamp::now())
-        .max_history_size(u64::MAX)
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id.clone())
-                .client_id(client_id.clone())
-                .latest_height(client_height)
-                .client_type(tm_client_type())
-                .trusting_period(Duration::from_secs(3))
+        .build::<TendermintContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .params(
+                    ClientStateConfig::builder()
+                        .trusting_period(Duration::from_secs(3))
+                        .build(),
+                )
                 .build(),
         );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let start_host_timestamp = ctx.host_timestamp().unwrap();
+    let start_host_timestamp = ctx.ibc_store.host_timestamp().unwrap();
 
     // Move the chain forward by 2 blocks to pass the trusting period.
     for _ in 1..=2 {
@@ -231,9 +258,10 @@ fn test_consensus_state_pruning() {
 
         let update_height = ctx.latest_height();
 
-        ctx.advance_host_chain_height();
+        ctx.advance_block_height();
 
-        let mut block = ctx.host_block(&update_height).unwrap().clone();
+        let block = ctx.host_block(&update_height).unwrap().clone();
+        let mut block = block.into_header();
 
         block.set_trusted_height(client_height);
 
@@ -245,8 +273,8 @@ fn test_consensus_state_pruning() {
 
         let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-        let _ = validate(&ctx, &router, msg_envelope.clone());
-        let _ = execute(&mut ctx, &mut router, msg_envelope);
+        let _ = validate(&ctx.ibc_store, &router, msg_envelope.clone());
+        let _ = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
     }
 
     // Check that latest expired consensus state is pruned.
@@ -256,8 +284,14 @@ fn test_consensus_state_pruning() {
         expired_height.revision_number(),
         expired_height.revision_height(),
     );
-    assert!(ctx.client_update_meta(&client_id, &expired_height).is_err());
-    assert!(ctx.consensus_state(&client_cons_state_path).is_err());
+    assert!(ctx
+        .ibc_store
+        .client_update_meta(&client_id, &expired_height)
+        .is_err());
+    assert!(ctx
+        .ibc_store
+        .consensus_state(&client_cons_state_path)
+        .is_err());
 
     // Check that latest valid consensus state exists.
     let earliest_valid_height = Height::new(1, 2).unwrap();
@@ -268,11 +302,15 @@ fn test_consensus_state_pruning() {
     );
 
     assert!(ctx
+        .ibc_store
         .client_update_meta(&client_id, &earliest_valid_height)
         .is_ok());
-    assert!(ctx.consensus_state(&client_cons_state_path).is_ok());
+    assert!(ctx
+        .ibc_store
+        .consensus_state(&client_cons_state_path)
+        .is_ok());
 
-    let end_host_timestamp = ctx.host_timestamp().unwrap();
+    let end_host_timestamp = ctx.ibc_store.host_timestamp().unwrap();
 
     assert_eq!(
         end_host_timestamp,
@@ -294,7 +332,7 @@ fn test_update_nonexisting_client(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(res.is_err());
 }
@@ -306,30 +344,33 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let mut ctx = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(update_height)
+        .build::<TendermintContext>();
+
+    let mut ctx = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
-                .latest_height(client_height)
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
                 .build(),
         );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b)
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(update_height)
-        .build();
-
     let signer = dummy_account_id();
 
-    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    let block = ctx_b.host_block(&update_height).unwrap();
+    let mut block = block.into_header();
     block.set_trusted_height(client_height);
 
     let latest_header_height = block.height();
@@ -340,16 +381,16 @@ fn test_update_synthetic_tendermint_client_adjacent_ok() {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let res = validate(&ctx, &router, msg_envelope.clone());
+    let res = validate(&ctx.ibc_store, &router, msg_envelope.clone());
     assert!(res.is_ok());
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
     assert!(res.is_ok(), "result: {res:?}");
 
-    let client_state = ctx.client_state(&msg.client_id).unwrap();
+    let client_state = ctx.ibc_store.client_state(&msg.client_id).unwrap();
 
     assert!(client_state
-        .status(&ctx, &msg.client_id)
+        .status(&ctx.ibc_store, &msg.client_id)
         .unwrap()
         .is_active());
 
@@ -362,68 +403,74 @@ fn test_update_synthetic_tendermint_client_validator_change_ok() {
     let client_height = Height::new(1, 20).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let mut ctx_a = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
-        .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            // client state initialized with client_height, and
-            // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .latest_height(client_height)
-                .client_type(tm_client_type())
-                .build(),
-        );
-
-    let mut router_a = MockRouter::new_with_transfer();
-
     let ctx_b_val_history = vec![
-        // First two validator sets are default at client creation
-        //
         // validator set of height-20
         vec![
             TestgenValidator::new("1").voting_power(50),
             TestgenValidator::new("2").voting_power(50),
         ],
+        // next validator set of height-20
         // validator set of height-21
         vec![
-            TestgenValidator::new("1").voting_power(50),
-            TestgenValidator::new("2").voting_power(50),
+            TestgenValidator::new("1").voting_power(34),
+            TestgenValidator::new("2").voting_power(66),
         ],
+        // next validator set of height-21
         // validator set of height-22
+        // overlap maintains 1/3 power in older set
         vec![
-            TestgenValidator::new("1").voting_power(30),
-            TestgenValidator::new("2").voting_power(70),
+            TestgenValidator::new("1").voting_power(1),
+            TestgenValidator::new("4").voting_power(99),
         ],
-        // validator set of height-23
+        // next validator set of height-22
         vec![
             TestgenValidator::new("1").voting_power(20),
             TestgenValidator::new("2").voting_power(80),
         ],
     ];
 
-    let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+    let block_params = BlockParams::from_validator_history(ctx_b_val_history);
+
+    let update_height = client_height.add(block_params.len() as u64 - 1);
+
+    assert_eq!(update_height.revision_height(), 22);
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b.clone())
-        .host_type(HostType::SyntheticTendermint)
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
         .latest_height(update_height)
-        .max_history_size(ctx_b_val_history.len() as u64 - 1)
-        .validator_set_history(ctx_b_val_history)
-        .build();
+        .block_params_history(block_params)
+        .build::<TendermintContext>();
+
+    let mut ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
+        .latest_height(Height::new(1, 1).unwrap())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            // remote light client initialized with client_height
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
+                .build(),
+        );
+
+    let mut router_a = MockRouter::new_with_transfer();
 
     let signer = dummy_account_id();
 
-    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
-    block.set_trusted_height(client_height);
+    let mut block = ctx_b.host_block(&update_height).unwrap().into_header();
 
-    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-        _ => panic!("unexpected host block type"),
-    };
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
 
+    block.set_trusted_height(client_height);
     block.set_trusted_next_validators_set(trusted_next_validator_set);
 
     let latest_header_height = block.height();
@@ -434,61 +481,151 @@ fn test_update_synthetic_tendermint_client_validator_change_ok() {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope.clone());
     assert!(res.is_ok());
 
-    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    let res = execute(&mut ctx_a.ibc_store, &mut router_a, msg_envelope);
     assert!(res.is_ok(), "result: {res:?}");
 
-    let client_state = ctx_a.client_state(&msg.client_id).unwrap();
+    let client_state = ctx_a.ibc_store.client_state(&msg.client_id).unwrap();
     assert!(client_state
-        .status(&ctx_a, &msg.client_id)
+        .status(&ctx_a.ibc_store, &msg.client_id)
         .unwrap()
         .is_active());
     assert_eq!(client_state.latest_height(), latest_header_height);
 }
 
+// TODO(rano): refactor the validator change tests to use a single test function
+
 #[rstest]
-fn test_update_synthetic_tendermint_client_validator_change_fail() {
+fn test_update_synthetic_tendermint_client_wrong_trusted_validator_change_fail() {
     let client_id = tm_client_type().build_client_id(0);
     let client_height = Height::new(1, 20).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let ctx_a = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let ctx_b_val_history = vec![
+        // validator set of height-20
+        vec![
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ],
+        // next validator set of height-20
+        // validator set of height-21
+        vec![
+            TestgenValidator::new("1").voting_power(45),
+            TestgenValidator::new("2").voting_power(55),
+        ],
+        // next validator set of height-21
+        // validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(30),
+            TestgenValidator::new("2").voting_power(70),
+        ],
+        // next validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(20),
+            TestgenValidator::new("2").voting_power(80),
+        ],
+    ];
+
+    let block_params = BlockParams::from_validator_history(ctx_b_val_history);
+
+    let update_height = client_height.add(block_params.len() as u64 - 1);
+
+    assert_eq!(update_height.revision_height(), 22);
+
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(update_height)
+        .block_params_history(block_params)
+        .build::<TendermintContext>();
+
+    let ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            // client state initialized with client_height, and
-            // [{id: 1, power: 50}, {id: 2, power: 50}] for validator set and next validator set.
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .latest_height(client_height)
-                .client_type(tm_client_type())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            // remote light client initialized with client_height
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
                 .build(),
         );
 
     let router = MockRouter::new_with_transfer();
 
+    let signer = dummy_account_id();
+
+    // next validator set from height-20
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
+
+    // next validator set from height-21
+    let mistrusted_next_validator_set = ctx_b
+        .host_block(&client_height.increment())
+        .expect("no error")
+        .next_validators
+        .clone();
+
+    // ensure the next validator sets are different
+    assert_ne!(
+        mistrusted_next_validator_set.hash(),
+        trusted_next_validator_set.hash()
+    );
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().into_header();
+
+    // set the trusted height to height-20
+    block.set_trusted_height(client_height);
+    // set the trusted next validator set from height-21, which is different than height-20
+    block.set_trusted_next_validators_set(mistrusted_next_validator_set);
+
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
+
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a.ibc_store, &router, msg_envelope);
+
+    assert!(res.is_err());
+}
+
+#[rstest]
+fn test_update_synthetic_tendermint_client_validator_change_fail() {
+    let client_id = tm_client_type().build_client_id(0);
+    let client_height = Height::new(1, 20).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
     let ctx_b_val_history = vec![
-        // First two validator sets are default at client creation
-        //
         // validator set of height-20
         vec![
             TestgenValidator::new("1").voting_power(50),
             TestgenValidator::new("2").voting_power(50),
         ],
-        // incorrect next validator set for height-20
+        // next validator set of height-20
         // validator set of height-21
         vec![
-            TestgenValidator::new("1").voting_power(45),
-            TestgenValidator::new("2").voting_power(55),
+            TestgenValidator::new("1").voting_power(90),
+            TestgenValidator::new("2").voting_power(10),
         ],
+        // next validator set of height-21
         // validator set of height-22
+        // overlap doesn't maintain 1/3 power in older set
         vec![
-            TestgenValidator::new("1").voting_power(30),
-            TestgenValidator::new("2").voting_power(70),
+            // TestgenValidator::new("1").voting_power(0),
+            TestgenValidator::new("4").voting_power(90),
+            TestgenValidator::new("2").voting_power(10),
         ],
         // validator set of height-23
         vec![
@@ -497,37 +634,248 @@ fn test_update_synthetic_tendermint_client_validator_change_fail() {
         ],
     ];
 
-    let update_height = client_height.add(ctx_b_val_history.len() as u64 - 2);
+    let block_params = BlockParams::from_validator_history(ctx_b_val_history);
+
+    let update_height = client_height.add(block_params.len() as u64 - 1);
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b.clone())
-        .host_type(HostType::SyntheticTendermint)
+    assert_eq!(update_height.revision_height(), 22);
+
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
         .latest_height(update_height)
-        .max_history_size(ctx_b_val_history.len() as u64 - 1)
-        .validator_set_history(ctx_b_val_history)
-        .build();
+        .block_params_history(block_params)
+        .build::<TendermintContext>();
+
+    let ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
+        .latest_height(Height::new(1, 1).unwrap())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            // remote light client initialized with client_height
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
+                .build(),
+        );
+
+    let router_a = MockRouter::new_with_transfer();
 
     let signer = dummy_account_id();
 
-    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().into_header();
+
     block.set_trusted_height(client_height);
+    block.set_trusted_next_validators_set(trusted_next_validator_set);
 
-    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-        _ => panic!("unexpected host block type"),
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
     };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
+
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope);
+
+    assert!(res.is_err());
+}
+
+#[rstest]
+fn test_update_synthetic_tendermint_client_malicious_validator_change_pass() {
+    let client_id = tm_client_type().build_client_id(0);
+    let client_height = Height::new(1, 20).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let ctx_b_val_history = vec![
+        // First two validator sets are default at client creation
+        //
+        // validator set of height-20
+        vec![
+            TestgenValidator::new("1").voting_power(50),
+            TestgenValidator::new("2").voting_power(50),
+        ],
+        // validator set of height-21
+        // next validator set of height-20
+        vec![
+            TestgenValidator::new("1").voting_power(34),
+            TestgenValidator::new("2").voting_power(66),
+        ],
+        // validator set of height-22
+        // next validator set of height-21
+        vec![
+            TestgenValidator::new("4").voting_power(90),
+            TestgenValidator::new("2").voting_power(10),
+        ],
+        // next validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(20),
+            TestgenValidator::new("2").voting_power(80),
+        ],
+    ];
+
+    let mut block_params = BlockParams::from_validator_history(ctx_b_val_history);
+
+    if let Some(block_param) = block_params.last_mut() {
+        // forged validator set of height-22
+        block_param.validators = vec![TestgenValidator::new("1").voting_power(100)];
+    }
+
+    let update_height = client_height.add(block_params.len() as u64 - 1);
+
+    assert_eq!(update_height.revision_height(), 22);
+
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(update_height)
+        .block_params_history(block_params)
+        .build::<TendermintContext>();
+
+    let mut ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
+        .latest_height(Height::new(1, 1).unwrap())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            // remote light client initialized with client_height
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
+                .build(),
+        );
+
+    let mut router_a = MockRouter::new_with_transfer();
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().into_header();
 
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
+
+    block.set_trusted_height(client_height);
     block.set_trusted_next_validators_set(trusted_next_validator_set);
 
+    let latest_header_height = block.height();
     let msg = MsgUpdateClient {
         client_id,
         client_message: block.into(),
         signer,
     };
+    let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
+
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope.clone());
+    assert!(res.is_ok());
+
+    let res = execute(&mut ctx_a.ibc_store, &mut router_a, msg_envelope);
+    assert!(res.is_ok(), "result: {res:?}");
+
+    let client_state = ctx_a.ibc_store.client_state(&msg.client_id).unwrap();
+    assert!(client_state
+        .status(&ctx_a.ibc_store, &msg.client_id)
+        .unwrap()
+        .is_active());
+    assert_eq!(client_state.latest_height(), latest_header_height);
+}
+
+#[rstest]
+fn test_update_synthetic_tendermint_client_adjacent_malicious_validator_change_fail() {
+    let client_id = tm_client_type().build_client_id(0);
+    let client_height = Height::new(1, 21).unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    let ctx_b_val_history = vec![
+        // validator set of height-21
+        vec![
+            TestgenValidator::new("1").voting_power(34),
+            TestgenValidator::new("2").voting_power(66),
+        ],
+        // next validator set of height-21
+        // validator set of height-22
+        vec![
+            TestgenValidator::new("4").voting_power(90),
+            TestgenValidator::new("2").voting_power(10),
+        ],
+        // next validator set of height-22
+        vec![
+            TestgenValidator::new("1").voting_power(20),
+            TestgenValidator::new("2").voting_power(80),
+        ],
+    ];
+
+    let mut block_params = BlockParams::from_validator_history(ctx_b_val_history);
+
+    if let Some(block_param) = block_params.last_mut() {
+        // forged validator set of height-22
+        block_param.validators = vec![TestgenValidator::new("1").voting_power(100)];
+    }
+
+    let update_height = client_height.add(block_params.len() as u64 - 1);
 
+    assert_eq!(update_height.revision_height(), 22);
+
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(update_height)
+        .block_params_history(block_params)
+        .build::<TendermintContext>();
+
+    let ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
+        .latest_height(Height::new(1, 1).unwrap())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            // remote light client initialized with client_height
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
+                .build(),
+        );
+
+    let router_a = MockRouter::new_with_transfer();
+
+    let signer = dummy_account_id();
+
+    let mut block = ctx_b.host_block(&update_height).unwrap().into_header();
+
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
+
+    block.set_trusted_height(client_height);
+    block.set_trusted_next_validators_set(trusted_next_validator_set);
+
+    let msg = MsgUpdateClient {
+        client_id,
+        client_message: block.into(),
+        signer,
+    };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx_a, &router, msg_envelope);
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope);
 
     assert!(res.is_err());
 }
@@ -539,34 +887,33 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
     let update_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
-    let mut ctx = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(update_height)
+        .build::<TendermintContext>();
+
+    let mut ctx = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
-                .latest_height(client_height)
-                .consensus_state_heights(vec![
-                    client_height.sub(1).expect("no error"),
-                    client_height,
-                ])
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height.sub(1).expect("no error"), client_height])
                 .build(),
         );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b)
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(update_height)
-        .build();
-
     let signer = dummy_account_id();
 
-    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    let block = ctx_b.host_block(&update_height).unwrap();
+    let mut block = block.into_header();
     let trusted_height = client_height.clone().sub(1).unwrap();
     block.set_trusted_height(trusted_height);
 
@@ -579,16 +926,16 @@ fn test_update_synthetic_tendermint_client_non_adjacent_ok() {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let res = validate(&ctx, &router, msg_envelope.clone());
+    let res = validate(&ctx.ibc_store, &router, msg_envelope.clone());
     assert!(res.is_ok());
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
     assert!(res.is_ok(), "result: {res:?}");
 
-    let client_state = ctx.client_state(&msg.client_id).unwrap();
+    let client_state = ctx.ibc_store.client_state(&msg.client_id).unwrap();
 
     assert!(client_state
-        .status(&ctx, &msg.client_id)
+        .status(&ctx.ibc_store, &msg.client_id)
         .unwrap()
         .is_active());
 
@@ -604,61 +951,52 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
     let ctx_b_chain_id = ChainId::new("mockgaiaB-1").unwrap();
     let start_height = Height::new(1, 11).unwrap();
 
-    let mut ctx_a = MockContextConfig::builder()
-        .host_id(ctx_a_chain_id)
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(ctx_b_chain_id).build())
+        .latest_height(client_height)
+        .build::<TendermintContext>();
+
+    let mut ctx_a = TestContextConfig::builder()
+        .host(MockHost::builder().chain_id(ctx_a_chain_id).build())
         .latest_height(start_height)
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(ctx_b_chain_id.clone())
-                .client_id(client_id.clone())
-                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
-                .latest_height(client_height)
-                .consensus_state_heights(vec![start_height])
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([start_height])
                 .build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(ctx_b_chain_id)
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(client_height)
-        .build();
-
     let signer = dummy_account_id();
 
-    let block = ctx_b.host_block(&client_height).unwrap().clone();
+    let block = ctx_b.host_block(&client_height).unwrap();
+    let mut block = block.into_header();
 
     // Update the trusted height of the header to point to the previous height
     // (`start_height` in this case).
     //
-    // Note: The current MockContext interface doesn't allow us to
+    // Note: The current `TestContext` interface doesn't allow us to
     // do this without a major redesign.
-    let block = match block {
-        HostBlock::SyntheticTendermint(mut theader) => {
-            // current problem: the timestamp of the new header doesn't match the timestamp of
-            // the stored consensus state. If we hack them to match, then commit check fails.
-            // FIXME: figure out why they don't match.
-            theader.trusted_height = start_height;
-
-            HostBlock::SyntheticTendermint(theader)
-        }
-        _ => block,
-    };
+
+    // current problem: the timestamp of the new header doesn't match the timestamp of
+    // the stored consensus state. If we hack them to match, then commit check fails.
+    // FIXME: figure out why they don't match.
+
+    block.set_trusted_height(start_height);
 
     // Update the client height to `client_height`
     //
-    // Note: The current MockContext interface doesn't allow us to
+    // Note: The current `TestContext` interface doesn't allow us to
     // do this without a major redesign.
     {
         // FIXME: idea: we need to update the light client with the latest block from
         // chain B
-        let consensus_state: AnyConsensusState = block.clone().into();
+        let consensus_state: AnyConsensusState = block.clone().into_consensus_state().into();
 
-        let HostBlock::SyntheticTendermint(tm_block) = &block else {
-            panic!("unexpected host block type");
-        };
+        let tm_block = &block;
 
         let chain_id = ChainId::from_str(tm_block.header().chain_id.as_str()).unwrap();
 
@@ -696,14 +1034,9 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
             ClientState::from(client_state).into()
         };
 
-        let mut ibc_store = ctx_a.ibc_store.lock();
-        let client_record = ibc_store.clients.get_mut(&client_id).unwrap();
+        ctx_a = ctx_a.with_client_state(&client_id, client_state);
 
-        client_record
-            .consensus_states
-            .insert(client_height, consensus_state);
-
-        client_record.client_state = Some(client_state);
+        ctx_a = ctx_a.with_consensus_state(&client_id, client_height, consensus_state);
     }
 
     let latest_header_height = block.height();
@@ -715,19 +1048,18 @@ fn test_update_synthetic_tendermint_client_duplicate_ok() {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg.clone()));
 
-    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope.clone());
     assert!(res.is_ok(), "result: {res:?}");
 
-    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    let res = execute(&mut ctx_a.ibc_store, &mut router_a, msg_envelope);
     assert!(res.is_ok(), "result: {res:?}");
 
-    let client_state = ctx_a.client_state(&msg.client_id).unwrap();
+    let client_state = ctx_a.ibc_store.client_state(&msg.client_id).unwrap();
     assert!(client_state
-        .status(&ctx_a, &msg.client_id)
+        .status(&ctx_a.ibc_store, &msg.client_id)
         .unwrap()
         .is_active());
     assert_eq!(client_state.latest_height(), latest_header_height);
-    assert_eq!(client_state, ctx_a.latest_client_states(&msg.client_id));
 }
 
 #[rstest]
@@ -739,39 +1071,43 @@ fn test_update_synthetic_tendermint_client_lower_height() {
 
     let chain_start_height = Height::new(1, 11).unwrap();
 
-    let ctx = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
-        .latest_height(chain_start_height)
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id.clone())
-                .client_type(tm_client_type()) // The target host chain (B) is synthetic TM.
-                .latest_height(client_height)
+    let ctx_b = TestContextConfig::builder()
+        .host(
+            TendermintHost::builder()
+                .chain_id(ChainId::new("mockgaiaB-1").unwrap())
+                .build(),
+        )
+        .latest_height(client_height)
+        .build::<TendermintContext>();
+
+    let ctx = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
                 .build(),
+        )
+        .latest_height(chain_start_height)
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init().context(&ctx_b).build(),
         );
 
     let router = MockRouter::new_with_transfer();
 
-    let ctx_b = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaB-1").unwrap())
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(client_height)
-        .build();
-
     let signer = dummy_account_id();
 
     let block_ref = ctx_b.host_block(&client_update_height).unwrap();
 
     let msg = MsgUpdateClient {
         client_id,
-        client_message: block_ref.clone().into(),
+        client_message: block_ref.into_header().into(),
         signer,
     };
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
     assert!(res.is_err());
 }
 
@@ -795,7 +1131,7 @@ fn test_update_client_events(fixture: Fixture) {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
     assert!(res.is_ok());
 
     let ibc_events = ctx.get_events();
@@ -804,8 +1140,9 @@ fn test_update_client_events(fixture: Fixture) {
         ibc_events[0],
         IbcEvent::Message(MessageEvent::Client)
     ));
+
     let IbcEvent::UpdateClient(update_client_event) = &ibc_events[1] else {
-        panic!("unexpected event variant");
+        panic!("UpdateClient event is expected")
     };
 
     assert_eq!(update_client_event.client_id(), &client_id);
@@ -815,21 +1152,25 @@ fn test_update_client_events(fixture: Fixture) {
     assert_eq!(update_client_event.header(), &header.to_vec());
 }
 
-fn ensure_misbehaviour(ctx: &MockContext, client_id: &ClientId, client_type: &ClientType) {
+fn ensure_misbehaviour<S: ProvableStore + Debug>(
+    ctx: &MockIbcStore<S>,
+    client_id: &ClientId,
+    client_type: &ClientType,
+) {
     let client_state = ctx.client_state(client_id).unwrap();
 
     let status = client_state.status(ctx, client_id).unwrap();
     assert!(status.is_frozen(), "client_state status: {status}");
 
     // check events
-    let ibc_events = ctx.get_events();
+    let ibc_events = ctx.events.lock();
     assert_eq!(ibc_events.len(), 2);
     assert!(matches!(
         ibc_events[0],
         IbcEvent::Message(MessageEvent::Client),
     ));
     let IbcEvent::ClientMisbehaviour(misbehaviour_client_event) = &ibc_events[1] else {
-        panic!("unexpected event variant");
+        panic!("ClientMisbehaviour event is expected")
     };
     assert_eq!(misbehaviour_client_event.client_id(), client_id);
     assert_eq!(misbehaviour_client_event.client_type(), client_type);
@@ -849,13 +1190,13 @@ fn test_misbehaviour_client_ok(fixture: Fixture) {
     let client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let msg_envelope = msg_update_client(&client_id);
 
-    let res = validate(&ctx, &router, msg_envelope.clone());
+    let res = validate(&ctx.ibc_store, &router, msg_envelope.clone());
     assert!(res.is_ok());
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
     assert!(res.is_ok());
 
-    ensure_misbehaviour(&ctx, &client_id, &mock_client_type());
+    ensure_misbehaviour(&ctx.ibc_store, &client_id, &mock_client_type());
 }
 
 #[rstest]
@@ -866,13 +1207,11 @@ fn test_submit_misbehaviour_nonexisting_client(fixture: Fixture) {
 
     let msg_envelope = msg_update_client(&ClientId::from_str("nonexistingclient").unwrap());
 
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
+    let ctx = MockContext::default().with_light_client(
+        &client_id,
+        LightClientState::<MockHost>::with_latest_height(Height::new(0, 42).unwrap()),
     );
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
     assert!(res.is_err());
 }
 
@@ -884,13 +1223,11 @@ fn test_client_update_misbehaviour_nonexisting_client(fixture: Fixture) {
 
     let msg_envelope = msg_update_client(&ClientId::from_str("nonexistingclient").unwrap());
 
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
+    let ctx = MockContext::default().with_light_client(
+        &client_id,
+        LightClientState::<MockHost>::with_latest_height(Height::new(0, 42).unwrap()),
     );
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
     assert!(res.is_err());
 }
 
@@ -903,44 +1240,56 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
     let misbehaviour_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
+    // Create a mock context for chain-B
+    let ctx_b = TestContextConfig::builder()
+        .host(
+            TendermintHost::builder()
+                .chain_id(chain_id_b.clone())
+                .build(),
+        )
+        .latest_height(misbehaviour_height)
+        .build::<TendermintContext>();
+
     // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-    let mut ctx_a = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let mut ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .client_type(tm_client_type())
-                .latest_height(client_height)
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .consensus_heights([client_height])
                 .build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
 
-    // Create a mock context for chain-B
-    let ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b.clone())
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(misbehaviour_height)
-        .build();
-
     // Get chain-B's header at `misbehaviour_height`
     let header1: TmHeader = {
-        let mut block = ctx_b.host_block(&misbehaviour_height).unwrap().clone();
+        let block = ctx_b.host_block(&misbehaviour_height).unwrap();
+        let mut block = block.into_header();
         block.set_trusted_height(client_height);
-        block.try_into_tm_block().unwrap().into()
+        block.into()
     };
 
     // Generate an equivocal header for chain-B at `misbehaviour_height`
     let header2 = {
-        let mut tm_block = HostBlock::generate_tm_block(
-            chain_id_b,
-            misbehaviour_height.revision_height(),
-            Timestamp::now(),
-        );
-        tm_block.trusted_height = client_height;
+        let mut tm_block = TendermintHost::builder()
+            .chain_id(chain_id_b)
+            .build()
+            .generate_block(
+                Vec::new(),
+                misbehaviour_height.revision_height(),
+                Timestamp::now(),
+                &Default::default(),
+            )
+            .into_header();
+        tm_block.set_trusted_height(client_height);
         tm_block.into()
     };
 
@@ -951,11 +1300,11 @@ fn test_misbehaviour_synthetic_tendermint_equivocation() {
     };
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope.clone());
     assert!(res.is_ok());
-    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    let res = execute(&mut ctx_a.ibc_store, &mut router_a, msg_envelope);
     assert!(res.is_ok());
-    ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
+    ensure_misbehaviour(&ctx_a.ibc_store, &client_id, &tm_client_type());
 }
 
 #[rstest]
@@ -965,30 +1314,44 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
     let misbehaviour_height = Height::new(1, 21).unwrap();
     let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
 
+    let ctx_b = TestContextConfig::builder()
+        .host(
+            TendermintHost::builder()
+                .chain_id(chain_id_b.clone())
+                .build(),
+        )
+        .latest_height(client_height)
+        .build::<TendermintContext>();
+
     // Create a mock context for chain-A with a synthetic tendermint light client for chain-B
-    let mut ctx_a = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
-        .latest_height(Height::new(1, 1).unwrap())
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .client_type(tm_client_type())
-                .latest_height(client_height)
+    let mut ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
                 .build(),
+        )
+        .latest_height(Height::new(1, 1).unwrap())
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init().context(&ctx_b).build(),
         );
 
     let mut router_a = MockRouter::new_with_transfer();
 
     // Generate `header1` for chain-B
     let header1 = {
-        let mut tm_block = HostBlock::generate_tm_block(
-            chain_id_b.clone(),
-            misbehaviour_height.revision_height(),
-            Timestamp::now(),
-        );
-        tm_block.trusted_height = client_height;
+        let mut tm_block = TendermintHost::builder()
+            .chain_id(chain_id_b.clone())
+            .build()
+            .generate_block(
+                Vec::new(),
+                misbehaviour_height.revision_height(),
+                Timestamp::now(),
+                &Default::default(),
+            )
+            .into_header();
+        tm_block.set_trusted_height(client_height);
         tm_block
     };
 
@@ -997,12 +1360,17 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
     let header2 = {
         let timestamp =
             Timestamp::from_nanoseconds(Timestamp::now().nanoseconds() + 1_000_000_000).unwrap();
-        let mut tm_block = HostBlock::generate_tm_block(
-            chain_id_b,
-            misbehaviour_height.revision_height(),
-            timestamp,
-        );
-        tm_block.trusted_height = client_height;
+        let mut tm_block = TendermintHost::builder()
+            .chain_id(chain_id_b)
+            .build()
+            .generate_block(
+                Vec::new(),
+                misbehaviour_height.revision_height(),
+                timestamp,
+                &Default::default(),
+            )
+            .into_header();
+        tm_block.set_trusted_height(client_height);
         tm_block
     };
 
@@ -1015,11 +1383,11 @@ fn test_misbehaviour_synthetic_tendermint_bft_time() {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx_a, &router_a, msg_envelope.clone());
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope.clone());
     assert!(res.is_ok());
-    let res = execute(&mut ctx_a, &mut router_a, msg_envelope);
+    let res = execute(&mut ctx_a.ibc_store, &mut router_a, msg_envelope);
     assert!(res.is_ok());
-    ensure_misbehaviour(&ctx_a, &client_id, &tm_client_type());
+    ensure_misbehaviour(&ctx_a.ibc_store, &client_id, &tm_client_type());
 }
 
 #[rstest]
@@ -1035,30 +1403,45 @@ fn test_expired_client() {
 
     let trusting_period = Duration::from_secs(64);
 
-    let mut ctx = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(client_height)
+        .latest_timestamp(timestamp)
+        .build::<TendermintContext>();
+
+    let mut ctx = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
         .latest_timestamp(timestamp)
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .latest_height(client_height)
-                .client_type(tm_client_type())
-                .latest_timestamp(timestamp)
-                .trusting_period(trusting_period)
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .params(
+                    ClientStateConfig::builder()
+                        .trusting_period(trusting_period)
+                        .build(),
+                )
                 .build(),
         );
 
-    while ctx.host_timestamp().expect("no error") < (timestamp + trusting_period).expect("no error")
+    while ctx.ibc_store.host_timestamp().expect("no error")
+        < (timestamp + trusting_period).expect("no error")
     {
-        ctx.advance_host_chain_height();
+        ctx.advance_block_height();
     }
 
-    let client_state = ctx.client_state(&client_id).unwrap();
+    let client_state = ctx.ibc_store.client_state(&client_id).unwrap();
 
-    assert!(client_state.status(&ctx, &client_id).unwrap().is_expired());
+    assert!(client_state
+        .status(&ctx.ibc_store, &client_id)
+        .unwrap()
+        .is_expired());
 }
 
 #[rstest]
@@ -1073,52 +1456,57 @@ fn test_client_update_max_clock_drift() {
 
     let max_clock_drift = Duration::from_secs(64);
 
-    let ctx_a = MockContextConfig::builder()
-        .host_id(ChainId::new("mockgaiaA-1").unwrap())
+    let mut ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(client_height)
+        .latest_timestamp(timestamp)
+        .build::<TendermintContext>();
+
+    let ctx_a = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(ChainId::new("mockgaiaA-1").unwrap())
+                .build(),
+        )
         .latest_height(Height::new(1, 1).unwrap())
         .latest_timestamp(timestamp)
-        .build()
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_chain_id(chain_id_b.clone())
-                .client_id(client_id.clone())
-                .latest_height(client_height)
-                .client_type(tm_client_type())
-                .latest_timestamp(timestamp)
-                .max_clock_drift(max_clock_drift)
+        .build::<MockContext>()
+        .with_light_client(
+            &client_id,
+            LightClientBuilder::init()
+                .context(&ctx_b)
+                .params(
+                    ClientStateConfig::builder()
+                        .max_clock_drift(max_clock_drift)
+                        .build(),
+                )
                 .build(),
         );
 
     let router_a = MockRouter::new_with_transfer();
 
-    let mut ctx_b = MockContextConfig::builder()
-        .host_id(chain_id_b.clone())
-        .host_type(HostType::SyntheticTendermint)
-        .latest_height(client_height)
-        .latest_timestamp(timestamp)
-        .max_history_size(u64::MAX)
-        .build();
-
-    while ctx_b.host_timestamp().expect("no error")
-        < (ctx_a.host_timestamp().expect("no error") + max_clock_drift).expect("no error")
+    while ctx_b.ibc_store.host_timestamp().expect("no error")
+        < (ctx_a.ibc_store.host_timestamp().expect("no error") + max_clock_drift).expect("no error")
     {
-        ctx_b.advance_host_chain_height();
+        ctx_b.advance_block_height();
     }
 
     // include current block
-    ctx_b.advance_host_chain_height();
+    ctx_b.advance_block_height();
 
     let update_height = ctx_b.latest_height();
 
     let signer = dummy_account_id();
 
-    let mut block = ctx_b.host_block(&update_height).unwrap().clone();
+    let block = ctx_b.host_block(&update_height).unwrap();
+    let mut block = block.into_header();
     block.set_trusted_height(client_height);
 
-    let trusted_next_validator_set = match ctx_b.host_block(&client_height).expect("no error") {
-        HostBlock::SyntheticTendermint(header) => header.light_block.next_validators.clone(),
-        _ => panic!("unexpected host block type"),
-    };
+    let trusted_next_validator_set = ctx_b
+        .host_block(&client_height)
+        .expect("no error")
+        .next_validators
+        .clone();
 
     block.set_trusted_next_validators_set(trusted_next_validator_set);
 
@@ -1130,6 +1518,166 @@ fn test_client_update_max_clock_drift() {
 
     let msg_envelope = MsgEnvelope::from(ClientMsg::from(msg));
 
-    let res = validate(&ctx_a, &router_a, msg_envelope);
+    let res = validate(&ctx_a.ibc_store, &router_a, msg_envelope);
     assert!(res.is_err());
 }
+
+/// Builds a `ClientMsg::UpdateClient` for a client with id `client_id` running on the `dest`
+/// context, assuming that the latest header on the source context is `src_header`.
+pub(crate) fn build_client_update_datagram<H: TestHeader, Dst: TestHost>(
+    dest: &TestContext<Dst>,
+    client_id: &ClientId,
+    src_header: &H,
+) -> Result<ClientMsg, RelayerError>
+where
+    HostClientState<Dst>: ClientStateValidation<DefaultIbcStore>,
+{
+    // Check if client for ibc0 on ibc1 has been updated to latest height:
+    // - query client state on destination chain
+    let dest_client_latest_height = dest.light_client_latest_height(client_id);
+
+    if src_header.height() == dest_client_latest_height {
+        return Err(RelayerError::ClientAlreadyUpToDate {
+            client_id: client_id.clone(),
+            source_height: src_header.height(),
+            destination_height: dest_client_latest_height,
+        });
+    };
+
+    if dest_client_latest_height > src_header.height() {
+        return Err(RelayerError::ClientAtHigherHeight {
+            client_id: client_id.clone(),
+            source_height: src_header.height(),
+            destination_height: dest_client_latest_height,
+        });
+    };
+
+    // Client on destination chain can be updated.
+    Ok(ClientMsg::UpdateClient(MsgUpdateClient {
+        client_id: client_id.clone(),
+        client_message: src_header.clone().into(),
+        signer: dummy_account_id(),
+    }))
+}
+
+/// Serves to test both ICS-26 `dispatch` & `build_client_update_datagram` functions.
+/// Implements a "ping pong" of client update messages, so that two chains repeatedly
+/// process a client update message and update their height in succession.
+#[rstest]
+fn client_update_ping_pong() {
+    let chain_a_start_height = Height::new(1, 11).unwrap();
+    let chain_b_start_height = Height::new(1, 20).unwrap();
+    let client_on_b_for_a_height = Height::new(1, 10).unwrap(); // Should be smaller than `chain_a_start_height`
+    let client_on_a_for_b_height = Height::new(1, 20).unwrap(); // Should be smaller than `chain_b_start_height`
+    let num_iterations = 4;
+
+    let client_on_a_for_b = tm_client_type().build_client_id(0);
+    let client_on_b_for_a = mock_client_type().build_client_id(0);
+
+    let chain_id_a = ChainId::new("mockgaiaA-1").unwrap();
+    let chain_id_b = ChainId::new("mockgaiaB-1").unwrap();
+
+    // Create two mock contexts, one for each chain.
+    let mut ctx_a = TestContextConfig::builder()
+        .host(MockHost::builder().chain_id(chain_id_a).build())
+        .latest_height(chain_a_start_height)
+        .build::<MockContext>();
+
+    let mut ctx_b = TestContextConfig::builder()
+        .host(TendermintHost::builder().chain_id(chain_id_b).build())
+        .latest_height(chain_b_start_height)
+        .latest_timestamp(ctx_a.timestamp_at(chain_a_start_height.decrement().unwrap())) // chain B is running slower than chain A
+        .build::<TendermintContext>();
+
+    ctx_a = ctx_a.with_light_client(
+        &client_on_a_for_b,
+        LightClientBuilder::init()
+            .context(&ctx_b)
+            .consensus_heights([client_on_a_for_b_height])
+            .build(),
+    );
+
+    ctx_b = ctx_b.with_light_client(
+        &client_on_b_for_a,
+        LightClientBuilder::init()
+            .context(&ctx_a)
+            .consensus_heights([client_on_b_for_a_height])
+            .build(),
+    );
+
+    for _i in 0..num_iterations {
+        // Update client on chain B to latest height of A.
+        // - create the client update message with the latest header from A
+        let a_latest_header = ctx_a.query_latest_block().unwrap();
+        let client_msg_b_res = build_client_update_datagram(
+            &ctx_b,
+            &client_on_b_for_a,
+            &a_latest_header.into_header(),
+        );
+
+        assert!(
+                client_msg_b_res.is_ok(),
+                "create_client_update failed for context destination {ctx_b:?}, error: {client_msg_b_res:?}",
+            );
+
+        let client_msg_b = client_msg_b_res.unwrap();
+
+        // - send the message to B. We bypass ICS18 interface and call directly into
+        // `TestContext` `recv` method (to avoid additional serialization steps).
+        let dispatch_res_b = ctx_b.deliver(MsgEnvelope::Client(client_msg_b));
+        let validation_res = ctx_b.host.validate();
+        assert!(
+            validation_res.is_ok(),
+            "context validation failed with error {validation_res:?} for context {ctx_b:?}",
+        );
+
+        // Check if the update succeeded.
+        assert!(
+            dispatch_res_b.is_ok(),
+            "Dispatch failed for host chain b with error: {dispatch_res_b:?}"
+        );
+
+        assert_eq!(
+            ctx_b.light_client_latest_height(&client_on_b_for_a),
+            ctx_a.latest_height()
+        );
+
+        // Update client on chain A to latest height of B.
+        // - create the client update message with the latest header from B
+        // The test uses LightClientBlock that does not store the trusted height
+        let mut b_latest_header = ctx_b.query_latest_block().unwrap().clone().into_header();
+
+        let th = b_latest_header.height();
+        b_latest_header.set_trusted_height(th.decrement().unwrap());
+
+        let client_msg_a_res =
+            build_client_update_datagram(&ctx_a, &client_on_a_for_b, &b_latest_header);
+
+        assert!(
+                client_msg_a_res.is_ok(),
+                "create_client_update failed for context destination {ctx_a:?}, error: {client_msg_a_res:?}",
+            );
+
+        let client_msg_a = client_msg_a_res.unwrap();
+
+        debug!("client_msg_a = {:?}", client_msg_a);
+
+        // - send the message to A
+        let dispatch_res_a = ctx_a.deliver(MsgEnvelope::Client(client_msg_a));
+        let validation_res = ctx_a.host.validate();
+        assert!(
+            validation_res.is_ok(),
+            "context validation failed with error {validation_res:?} for context {ctx_a:?}",
+        );
+
+        // Check if the update succeeded.
+        assert!(
+            dispatch_res_a.is_ok(),
+            "Dispatch failed for host chain a with error: {dispatch_res_a:?}"
+        );
+        assert_eq!(
+            ctx_a.light_client_latest_height(&client_on_a_for_b),
+            ctx_b.latest_height()
+        );
+    }
+}
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
index c9bdadab5..015bf8921 100644
--- a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/upgrade_client.rs
@@ -1,5 +1,5 @@
 use ibc::clients::tendermint::types::client_type;
-use ibc::core::client::context::ClientValidationContext;
+use ibc::core::client::context::{ClientValidationContext, ExtClientValidationContext};
 use ibc::core::client::types::error::{ClientError, UpgradeClientError};
 use ibc::core::client::types::msgs::{ClientMsg, MsgUpgradeClient};
 use ibc::core::client::types::Height;
@@ -8,15 +8,17 @@ use ibc::core::handler::types::error::ContextError;
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::path::ClientConsensusStatePath;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::clients::tendermint::{
     dummy_tendermint_header, dummy_tm_client_state_from_header,
 };
 use ibc_testkit::fixtures::core::client::dummy_msg_upgrade_client;
 use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::clients::{AnyClientState, AnyConsensusState};
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 
 enum Ctx {
     Default,
@@ -33,15 +35,13 @@ fn msg_upgrade_client_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<Msg
     let client_id = mock_client_type().build_client_id(0);
 
     let ctx_default = MockContext::default();
-    let ctx_with_client = ctx_default.clone().with_client_config(
-        MockClientConfig::builder()
-            .client_id(client_id.clone())
-            .latest_height(Height::new(0, 42).unwrap())
-            .build(),
+    let ctx_with_client = MockContext::default().with_light_client(
+        &client_id,
+        LightClientState::<MockHost>::with_latest_height(Height::new(0, 42).unwrap()),
     );
     let ctx = match ctx_variant {
-        Ctx::Default => ctx_default,
-        Ctx::WithClient => ctx_with_client,
+        Ctx::Default => ctx_default.ibc_store,
+        Ctx::WithClient => ctx_with_client.ibc_store,
     };
 
     let upgrade_height = Height::new(1, 26).unwrap();
@@ -96,13 +96,14 @@ fn upgrade_client_execute(fxt: &mut Fixture<MsgUpgradeClient>, expect: Expect) {
         }
         Expect::Success => {
             assert!(res.is_ok(), "{err_msg}");
-            let ibc_events = fxt.ctx.get_events();
+            let ibc_events = fxt.ctx.events.lock();
             assert!(matches!(
                 ibc_events[0],
                 IbcEvent::Message(MessageEvent::Client)
             ));
+
             let IbcEvent::UpgradeClient(upgrade_client_event) = &ibc_events[1] else {
-                panic!("unexpected event variant");
+                panic!("UpgradeClient event is expected")
             };
             let plan_height = Height::new(1, 26).unwrap();
 
@@ -152,7 +153,7 @@ fn upgrade_client_fail_low_upgrade_height() {
         msg_upgrade_client_fixture(Ctx::WithClient, Msg::LowUpgradeHeight);
     let expected_err: ClientError = UpgradeClientError::LowUpgradeHeight {
         upgraded_height: Height::new(0, 26).unwrap(),
-        client_height: fxt.ctx.latest_height(),
+        client_height: fxt.ctx.host_height().unwrap(),
     }
     .into();
     upgrade_client_validate(
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 654c894c1..37733b60c 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -1,5 +1,6 @@
 use core::str::FromStr;
 
+use basecoin_store::impls::{GrowingStore, InMemoryStore, RevertibleStore};
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
 use ibc::core::connection::types::error::ConnectionError;
@@ -13,11 +14,13 @@ use ibc::core::host::types::identifiers::{ChainId, ClientId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::ZERO_DURATION;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_ack;
-use ibc_testkit::fixtures::core::context::MockContextConfig;
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::{LightClientState, MockIbcStore};
 use test_log::test;
 
 enum Ctx {
@@ -58,36 +61,45 @@ fn conn_open_ack_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenAck> {
     conn_end_open.set_state(State::Open); // incorrect field
 
     let ctx_default = MockContext::default();
-    let ctx_new = MockContextConfig::builder()
-        .host_id(ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap())
+    let ctx_new = TestContextConfig::builder()
+        .host(
+            MockHost::builder()
+                .chain_id(
+                    ChainId::new(&format!("mockgaia-{}", latest_height.revision_number())).unwrap(),
+                )
+                .build(),
+        )
         .latest_height(latest_height)
-        .build();
+        .build::<MockContext>();
     let ctx = match ctx {
-        Ctx::New => ctx_new,
-        Ctx::NewWithConnection => ctx_new
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(proof_height)
-                    .build(),
-            )
-            .with_connection(conn_id, default_conn_end),
-        Ctx::DefaultWithConnection => ctx_default
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(proof_height)
-                    .build(),
-            )
-            .with_connection(conn_id, default_conn_end),
-        Ctx::NewWithConnectionEndOpen => ctx_new
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(proof_height)
-                    .build(),
-            )
-            .with_connection(conn_id, conn_end_open),
+        Ctx::New => ctx_new.ibc_store,
+        Ctx::NewWithConnection => {
+            ctx_new
+                .with_light_client(
+                    &client_id,
+                    LightClientState::<MockHost>::with_latest_height(proof_height),
+                )
+                .with_connection(conn_id, default_conn_end)
+                .ibc_store
+        }
+        Ctx::DefaultWithConnection => {
+            ctx_default
+                .with_light_client(
+                    &client_id,
+                    LightClientState::<MockHost>::with_latest_height(proof_height),
+                )
+                .with_connection(conn_id, default_conn_end)
+                .ibc_store
+        }
+        Ctx::NewWithConnectionEndOpen => {
+            ctx_new
+                .with_light_client(
+                    &client_id,
+                    LightClientState::<MockHost>::with_latest_height(proof_height),
+                )
+                .with_connection(conn_id, conn_end_open)
+                .ibc_store
+        }
     };
 
     Fixture { ctx, msg }
@@ -142,7 +154,7 @@ fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect
             assert!(res.is_err(), "{err_msg}");
         }
         Expect::Success => {
-            let ibc_events = fxt.ctx.get_events();
+            let ibc_events = fxt.ctx.events.lock();
             assert!(res.is_ok(), "{err_msg}");
             assert_eq!(ibc_events.len(), 2);
 
@@ -156,7 +168,7 @@ fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect
             let IbcEvent::OpenAckConnection(conn_open_try_event) = event else {
                 unreachable!()
             };
-            let conn_end = <MockContext as ValidationContext>::connection_end(
+            let conn_end = <MockIbcStore<RevertibleStore<GrowingStore<InMemoryStore>>> as ValidationContext>::connection_end(
                 &fxt.ctx,
                 conn_open_try_event.conn_id_on_a(),
             )
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
index ba0e4479f..dc21dadef 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
@@ -11,10 +11,12 @@ use ibc::core::host::types::identifiers::ClientId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::ZERO_DURATION;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::connection::dummy_conn_open_confirm;
 use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use test_log::test;
 
 enum Ctx {
@@ -38,7 +40,7 @@ fn conn_open_confirm_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenConfirm> {
         State::Init,
         client_id.clone(),
         counterparty,
-        ValidationContext::get_compatible_versions(&ctx_default),
+        ValidationContext::get_compatible_versions(&ctx_default.ibc_store),
         ZERO_DURATION,
     )
     .unwrap();
@@ -47,23 +49,25 @@ fn conn_open_confirm_fixture(ctx: Ctx) -> Fixture<MsgConnectionOpenConfirm> {
     correct_conn_end.set_state(State::TryOpen);
 
     let ctx = match ctx {
-        Ctx::Default => ctx_default,
-        Ctx::IncorrectConnection => ctx_default
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(Height::new(0, 10).unwrap())
-                    .build(),
-            )
-            .with_connection(msg.conn_id_on_b.clone(), incorrect_conn_end_state),
-        Ctx::CorrectConnection => ctx_default
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(Height::new(0, 10).unwrap())
-                    .build(),
-            )
-            .with_connection(msg.conn_id_on_b.clone(), correct_conn_end),
+        Ctx::Default => ctx_default.ibc_store,
+        Ctx::IncorrectConnection => {
+            ctx_default
+                .with_light_client(
+                    &client_id,
+                    LightClientState::<MockHost>::with_latest_height(Height::new(0, 10).unwrap()),
+                )
+                .with_connection(msg.conn_id_on_b.clone(), incorrect_conn_end_state)
+                .ibc_store
+        }
+        Ctx::CorrectConnection => {
+            ctx_default
+                .with_light_client(
+                    &client_id,
+                    LightClientState::<MockHost>::with_latest_height(Height::new(0, 10).unwrap()),
+                )
+                .with_connection(msg.conn_id_on_b.clone(), correct_conn_end)
+                .ibc_store
+        }
     };
 
     Fixture { ctx, msg }
@@ -94,7 +98,7 @@ fn conn_open_confirm_execute(fxt: &mut Fixture<MsgConnectionOpenConfirm>, expect
             assert!(res.is_err(), "{err_msg}");
         }
         Expect::Success => {
-            let ibc_events = fxt.ctx.get_events();
+            let ibc_events = fxt.ctx.events.lock();
             assert!(res.is_ok(), "{err_msg}");
             assert_eq!(ibc_events.len(), 2);
 
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
index 76c974892..1a9218e24 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
@@ -7,13 +7,15 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::connection::{
     dummy_msg_conn_open_init, msg_conn_open_init_with_counterparty_conn_id,
     msg_conn_open_with_version,
 };
 use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use test_log::test;
 
 enum Ctx {
@@ -31,7 +33,7 @@ enum Msg {
 fn conn_open_init_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConnectionOpenInit> {
     let msg_default = dummy_msg_conn_open_init();
     let msg = match msg_variant {
-        Msg::Default => msg_default.clone(),
+        Msg::Default => msg_default,
         Msg::NoVersion => msg_conn_open_with_version(msg_default, None),
         Msg::BadVersion => {
             msg_conn_open_with_version(msg_default, Some("random identifier 424242"))
@@ -41,13 +43,15 @@ fn conn_open_init_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConn
 
     let ctx_default = MockContext::default();
     let ctx = match ctx_variant {
-        Ctx::WithClient => ctx_default.with_client_config(
-            MockClientConfig::builder()
-                .client_id(msg.client_id_on_a.clone())
-                .latest_height(Height::new(0, 10).unwrap())
-                .build(),
-        ),
-        _ => ctx_default,
+        Ctx::WithClient => {
+            ctx_default
+                .with_light_client(
+                    &msg.client_id_on_a,
+                    LightClientState::<MockHost>::with_latest_height(Height::new(0, 10).unwrap()),
+                )
+                .ibc_store
+        }
+        _ => ctx_default.ibc_store,
     };
 
     Fixture { ctx, msg }
@@ -82,7 +86,7 @@ fn conn_open_init_execute(
             assert!(res.is_err(), "{err_msg}")
         }
         Expect::Success => {
-            let ibc_events = fxt.ctx.get_events();
+            let ibc_events = fxt.ctx.events.lock();
 
             assert!(res.is_ok(), "{err_msg}");
 
@@ -127,7 +131,7 @@ fn conn_open_init_no_context() {
 fn conn_open_init_no_version() {
     let mut fxt = conn_open_init_fixture(Ctx::WithClient, Msg::NoVersion);
     conn_open_init_validate(&fxt, Expect::Success);
-    let expected_version = ValidationContext::get_compatible_versions(&fxt.ctx.clone());
+    let expected_version = ValidationContext::get_compatible_versions(&fxt.ctx);
     conn_open_init_execute(&mut fxt, Expect::Success, expected_version);
 }
 #[test]
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
index e5e718e5b..e466b403d 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
@@ -6,11 +6,13 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_try;
-use ibc_testkit::fixtures::core::context::MockContextConfig;
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::{DefaultIbcStore, LightClientState};
 use test_log::test;
 
 enum Ctx {
@@ -26,13 +28,10 @@ enum Msg {
 }
 
 fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConnectionOpenTry> {
-    let max_history_size = 5;
+    let retained_history_size = 5;
     let client_cons_state_height = 10;
     let host_chain_height = Height::new(0, 35).unwrap();
-    let pruned_height = host_chain_height
-        .sub(max_history_size + 1)
-        .unwrap()
-        .revision_height();
+    let pruned_height = host_chain_height.sub(retained_history_size + 1).unwrap();
 
     let msg = match msg_variant {
         Msg::Default => dummy_msg_conn_open_try(
@@ -43,26 +42,33 @@ fn conn_open_try_fixture(ctx_variant: Ctx, msg_variant: Msg) -> Fixture<MsgConne
             client_cons_state_height,
             host_chain_height.increment().revision_height(),
         ),
-        Msg::HeightOld => dummy_msg_conn_open_try(client_cons_state_height, pruned_height),
+        Msg::HeightOld => {
+            dummy_msg_conn_open_try(client_cons_state_height, pruned_height.revision_height())
+        }
         Msg::ProofHeightMissing => dummy_msg_conn_open_try(
             client_cons_state_height - 1,
             host_chain_height.revision_height(),
         ),
     };
 
-    let ctx_new = MockContextConfig::builder()
-        .max_history_size(max_history_size)
+    let ctx_new = TestContextConfig::builder()
         .latest_height(host_chain_height)
-        .build();
+        .build::<MockContext>();
     let ctx = match ctx_variant {
-        Ctx::Default => MockContext::default(),
-        Ctx::WithClient => ctx_new.with_client_config(
-            MockClientConfig::builder()
-                .client_id(msg.client_id_on_b.clone())
-                .latest_height(Height::new(0, client_cons_state_height).unwrap())
-                .build(),
-        ),
+        Ctx::Default => DefaultIbcStore::default(),
+        Ctx::WithClient => {
+            ctx_new
+                .with_light_client(
+                    &msg.client_id_on_b,
+                    LightClientState::<MockHost>::with_latest_height(
+                        Height::new(0, client_cons_state_height).unwrap(),
+                    ),
+                )
+                .ibc_store
+        }
     };
+
+    ctx.prune_host_consensus_states_till(&pruned_height);
     Fixture { ctx, msg }
 }
 
@@ -95,7 +101,7 @@ fn conn_open_try_execute(fxt: &mut Fixture<MsgConnectionOpenTry>, expect: Expect
 
             assert_eq!(fxt.ctx.connection_counter().unwrap(), 1);
 
-            let ibc_events = fxt.ctx.get_events();
+            let ibc_events = fxt.ctx.events.lock();
 
             assert_eq!(ibc_events.len(), 2);
 
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
index 7ac747dc5..1afd22fe1 100644
--- a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
+++ b/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
@@ -2,7 +2,6 @@ use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State}
 use ibc::core::channel::types::commitment::{compute_packet_commitment, PacketCommitment};
 use ibc::core::channel::types::msgs::{MsgAcknowledgement, PacketMsg};
 use ibc::core::channel::types::Version;
-use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
 use ibc::core::connection::types::version::Version as ConnectionVersion;
@@ -13,11 +12,12 @@ use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_acknowledgement;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 use test_log::test;
 
@@ -37,10 +37,9 @@ fn fixture() -> Fixture {
     let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
 
     let client_height = Height::new(0, 2).unwrap();
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .latest_height(client_height)
-            .build(),
+    let ctx = MockContext::default().with_light_client(
+        &ClientId::new("07-tendermint", 0).expect("no error"),
+        LightClientState::<MockHost>::with_latest_height(client_height),
     );
 
     let router = MockRouter::new_with_transfer();
@@ -74,9 +73,9 @@ fn fixture() -> Fixture {
         ConnectionState::Open,
         default_client_id.clone(),
         ConnectionCounterparty::new(
-            default_client_id.clone(),
+            default_client_id,
             Some(ConnectionId::zero()),
-            CommitmentPrefix::empty(),
+            CommitmentPrefix::try_from(vec![0]).expect("no error"),
         ),
         ConnectionVersion::compatibles(),
         ZERO_DURATION,
@@ -90,8 +89,8 @@ fn fixture() -> Fixture {
         msg,
         packet_commitment,
         conn_end_on_a,
-        chan_end_on_a_unordered,
         chan_end_on_a_ordered,
+        chan_end_on_a_unordered,
     }
 }
 
@@ -103,7 +102,7 @@ fn ack_fail_no_channel(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -124,10 +123,9 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
         ..
     } = fixture;
     let ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_channel(
             PortId::transfer(),
@@ -138,7 +136,7 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -148,7 +146,6 @@ fn ack_success_no_packet_commitment(fixture: Fixture) {
 
 #[rstest]
 fn ack_success_happy_path(fixture: Fixture) {
-    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
     let Fixture {
         ctx,
         router,
@@ -159,11 +156,10 @@ fn ack_success_happy_path(fixture: Fixture) {
         client_height,
         ..
     } = fixture;
-    let mut ctx: MockContext = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+    let ctx = ctx
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_channel(
             PortId::transfer(),
@@ -177,18 +173,10 @@ fn ack_success_happy_path(fixture: Fixture) {
             msg.packet.seq_on_a,
             packet_commitment,
         );
-    ctx.get_client_execution_context()
-        .store_update_meta(
-            default_client_id,
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-            Height::new(0, 4).unwrap(),
-        )
-        .unwrap();
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -223,7 +211,7 @@ fn ack_unordered_chan_execute(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok());
 
@@ -260,7 +248,7 @@ fn ack_ordered_chan_execute(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok());
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
index 14b358702..f3491f9ca 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
@@ -11,18 +11,20 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_confirm;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 
 #[test]
 fn test_chan_close_confirm_validate() {
     let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
     let default_context = MockContext::default();
-    let client_consensus_state_height = default_context.host_height().unwrap();
+    let client_consensus_state_height = default_context.ibc_store.host_height().unwrap();
 
     let conn_end = ConnectionEnd::new(
         ConnectionState::Open,
@@ -53,22 +55,20 @@ fn test_chan_close_confirm_validate() {
     .unwrap();
 
     let context = default_context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id.clone())
-                .latest_height(client_consensus_state_height)
-                .build(),
+        .with_light_client(
+            &client_id,
+            LightClientState::<MockHost>::with_latest_height(client_consensus_state_height),
         )
         .with_connection(conn_id, conn_end)
         .with_channel(
             msg_chan_close_confirm.port_id_on_b.clone(),
-            msg_chan_close_confirm.chan_id_on_b.clone(),
+            msg_chan_close_confirm.chan_id_on_b,
             chan_end,
         );
 
     let router = MockRouter::new_with_transfer();
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -81,7 +81,7 @@ fn test_chan_close_confirm_execute() {
     let client_id = mock_client_type().build_client_id(24);
     let conn_id = ConnectionId::new(2);
     let default_context = MockContext::default();
-    let client_consensus_state_height = default_context.host_height().unwrap();
+    let client_consensus_state_height = default_context.ibc_store.host_height().unwrap();
 
     let conn_end = ConnectionEnd::new(
         ConnectionState::Open,
@@ -112,22 +112,20 @@ fn test_chan_close_confirm_execute() {
     .unwrap();
 
     let mut context = default_context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id.clone())
-                .latest_height(client_consensus_state_height)
-                .build(),
+        .with_light_client(
+            &client_id,
+            LightClientState::<MockHost>::with_latest_height(client_consensus_state_height),
         )
         .with_connection(conn_id, conn_end)
         .with_channel(
             msg_chan_close_confirm.port_id_on_b.clone(),
-            msg_chan_close_confirm.chan_id_on_b.clone(),
+            msg_chan_close_confirm.chan_id_on_b,
             chan_end,
         );
 
     let mut router = MockRouter::new_with_transfer();
 
-    let res = execute(&mut context, &mut router, msg_envelope);
+    let res = execute(&mut context.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok(), "Execution success: happy path");
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
index 00ee8cdab..63fd30d65 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
@@ -11,11 +11,13 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_close_init;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 
 #[test]
 fn test_chan_close_init_validate() {
@@ -50,26 +52,24 @@ fn test_chan_close_init_validate() {
 
     let context = {
         let default_context = MockContext::default();
-        let client_consensus_state_height = default_context.host_height().unwrap();
+        let client_consensus_state_height = default_context.ibc_store.host_height().unwrap();
 
         default_context
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(client_consensus_state_height)
-                    .build(),
+            .with_light_client(
+                &client_id,
+                LightClientState::<MockHost>::with_latest_height(client_consensus_state_height),
             )
             .with_connection(conn_id, conn_end)
             .with_channel(
                 msg_chan_close_init.port_id_on_a.clone(),
-                msg_chan_close_init.chan_id_on_a.clone(),
+                msg_chan_close_init.chan_id_on_a,
                 chan_end,
             )
     };
 
     let router = MockRouter::new_with_transfer();
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -110,26 +110,24 @@ fn test_chan_close_init_execute() {
 
     let mut context = {
         let default_context = MockContext::default();
-        let client_consensus_state_height = default_context.host_height().unwrap();
+        let client_consensus_state_height = default_context.ibc_store.host_height().unwrap();
 
         default_context
-            .with_client_config(
-                MockClientConfig::builder()
-                    .client_id(client_id.clone())
-                    .latest_height(client_consensus_state_height)
-                    .build(),
+            .with_light_client(
+                &client_id,
+                LightClientState::<MockHost>::with_latest_height(client_consensus_state_height),
             )
             .with_connection(conn_id, conn_end)
             .with_channel(
                 msg_chan_close_init.port_id_on_a.clone(),
-                msg_chan_close_init.chan_id_on_a.clone(),
+                msg_chan_close_init.chan_id_on_a,
                 chan_end,
             )
     };
 
     let mut router = MockRouter::new_with_transfer();
 
-    let res = execute(&mut context, &mut router, msg_envelope);
+    let res = execute(&mut context.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok(), "Execution happy path");
 
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
index 8c3140910..e4250dd83 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
@@ -12,11 +12,13 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::primitives::*;
 use ibc::core::router::types::module::ModuleId;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_ack;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 use test_log::test;
 
@@ -90,11 +92,9 @@ fn chan_open_ack_happy_path(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
@@ -105,7 +105,7 @@ fn chan_open_ack_happy_path(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(res.is_ok(), "Validation happy path")
 }
@@ -125,11 +125,9 @@ fn chan_open_ack_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
@@ -138,9 +136,9 @@ fn chan_open_ack_execute_happy_path(fixture: Fixture) {
             chan_end_on_a,
         );
 
-    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg.clone()));
+    let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = execute(&mut context, &mut router, msg_envelope);
+    let res = execute(&mut context.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok(), "Execution happy path");
 
@@ -167,11 +165,9 @@ fn chan_open_ack_fail_no_connection(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_channel(
             msg.port_id_on_a.clone(),
@@ -181,7 +177,7 @@ fn chan_open_ack_fail_no_connection(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -202,17 +198,15 @@ fn chan_open_ack_fail_no_channel(fixture: Fixture) {
         ..
     } = fixture;
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_a, conn_end_on_a);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -242,11 +236,9 @@ fn chan_open_ack_fail_channel_wrong_state(fixture: Fixture) {
     )
     .unwrap();
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_a, conn_end_on_a)
         .with_channel(
@@ -257,7 +249,7 @@ fn chan_open_ack_fail_channel_wrong_state(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
index c97338f2e..0b399aa40 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
@@ -11,11 +11,13 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId};
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_confirm;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 use test_log::test;
 
@@ -87,18 +89,16 @@ fn chan_open_confirm_validate_happy_path(fixture: Fixture) {
     } = fixture;
 
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), chan_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(res.is_ok(), "Validation happy path")
 }
@@ -118,18 +118,16 @@ fn chan_open_confirm_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), chan_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = execute(&mut context, &mut router, msg_envelope);
+    let res = execute(&mut context.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok(), "Execution happy path");
 
@@ -158,17 +156,15 @@ fn chan_open_confirm_fail_no_channel(fixture: Fixture) {
         ..
     } = fixture;
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -198,18 +194,16 @@ fn chan_open_confirm_fail_channel_wrong_state(fixture: Fixture) {
     )
     .unwrap();
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b)
         .with_channel(msg.port_id_on_b.clone(), ChannelId::zero(), wrong_chan_end);
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
index a76f34d03..844af3d65 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
@@ -8,10 +8,12 @@ use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::ConnectionId;
 use ibc::core::host::ValidationContext;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_init;
 use ibc_testkit::fixtures::core::connection::dummy_msg_conn_open_init;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::{DefaultIbcStore, LightClientState};
 use rstest::*;
 use test_log::test;
 
@@ -46,11 +48,9 @@ fn fixture() -> Fixture {
     .unwrap();
 
     let ctx = default_ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_a.clone())
-                .latest_height(client_height)
-                .build(),
+        .with_light_client(
+            &client_id_on_a,
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_a);
 
@@ -63,7 +63,7 @@ fn chan_open_init_validate_happy_path(fixture: Fixture) {
         ctx, router, msg, ..
     } = fixture;
 
-    let res = validate(&ctx, &router, msg);
+    let res = validate(&ctx.ibc_store, &router, msg);
 
     assert!(res.is_ok(), "Validation succeeds; good parameters")
 }
@@ -76,7 +76,7 @@ fn chan_open_init_validate_counterparty_chan_id_set(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(ChannelMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -93,11 +93,11 @@ fn chan_open_init_execute_happy_path(fixture: Fixture) {
         ..
     } = fixture;
 
-    let res = execute(&mut ctx, &mut router, msg);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg);
 
     assert!(res.is_ok(), "Execution succeeds; good parameters");
 
-    assert_eq!(ctx.channel_counter().unwrap(), 1);
+    assert_eq!(ctx.ibc_store.channel_counter().unwrap(), 1);
 
     let ibc_events = ctx.get_events();
 
@@ -114,7 +114,7 @@ fn chan_open_init_execute_happy_path(fixture: Fixture) {
 fn chan_open_init_fail_no_connection(fixture: Fixture) {
     let Fixture { router, msg, .. } = fixture;
 
-    let res = validate(&MockContext::default(), &router, msg);
+    let res = validate(&DefaultIbcStore::default(), &router, msg);
 
     assert!(
         res.is_err(),
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
index e9b121dba..3a43d0dfb 100644
--- a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
+++ b/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
@@ -10,11 +10,13 @@ use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ClientId, ConnectionId};
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_chan_open_try;
 use ibc_testkit::fixtures::core::connection::dummy_raw_counterparty_conn;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::client_type as mock_client_type;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 use test_log::test;
 
@@ -83,15 +85,13 @@ fn chan_open_try_validate_happy_path(fixture: Fixture) {
     } = fixture;
 
     let ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
-    let res = validate(&ctx, &router, msg);
+    let res = validate(&ctx.ibc_store, &router, msg);
 
     assert!(res.is_ok(), "Validation success: happy path")
 }
@@ -110,19 +110,17 @@ fn chan_open_try_execute_happy_path(fixture: Fixture) {
     } = fixture;
 
     let mut ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .client_id(client_id_on_b.clone())
-                .latest_height(Height::new(0, proof_height).unwrap())
-                .build(),
+        .with_light_client(
+            &client_id_on_b,
+            LightClientState::<MockHost>::with_latest_height(Height::new(0, proof_height).unwrap()),
         )
         .with_connection(conn_id_on_b, conn_end_on_b);
 
-    let res = execute(&mut ctx, &mut router, msg);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg);
 
     assert!(res.is_ok(), "Execution success: happy path");
 
-    assert_eq!(ctx.channel_counter().unwrap(), 1);
+    assert_eq!(ctx.ibc_store.channel_counter().unwrap(), 1);
 
     let ibc_events = ctx.get_events();
 
@@ -141,7 +139,7 @@ fn chan_open_try_fail_no_connection(fixture: Fixture) {
         ctx, router, msg, ..
     } = fixture;
 
-    let res = validate(&ctx, &router, msg);
+    let res = validate(&ctx.ibc_store, &router, msg);
 
     assert!(
         res.is_err(),
@@ -161,7 +159,7 @@ fn chan_open_try_fail_no_client_state(fixture: Fixture) {
     } = fixture;
     let ctx = ctx.with_connection(conn_id_on_b, conn_end_on_b);
 
-    let res = validate(&ctx, &router, msg);
+    let res = validate(&ctx.ibc_store, &router, msg);
 
     assert!(
         res.is_err(),
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
index a11a90837..df946f1e3 100644
--- a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/recv_packet.rs
@@ -2,7 +2,6 @@ use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State}
 use ibc::core::channel::types::msgs::{MsgRecvPacket, PacketMsg};
 use ibc::core::channel::types::packet::Packet;
 use ibc::core::channel::types::Version;
-use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
 use ibc::core::connection::types::version::Version as ConnectionVersion;
@@ -13,13 +12,13 @@ use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::{dummy_msg_recv_packet, dummy_raw_msg_recv_packet};
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
-use ibc_testkit::relayer::context::RelayerContext;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 use test_log::test;
 
@@ -42,7 +41,7 @@ fn fixture() -> Fixture {
 
     let router = MockRouter::new_with_transfer();
 
-    let host_height = context.query_latest_height().unwrap().increment();
+    let host_height = context.latest_height().increment();
 
     let client_height = host_height.increment();
 
@@ -66,7 +65,7 @@ fn fixture() -> Fixture {
         ConnectionCounterparty::new(
             client_id.clone(),
             Some(ConnectionId::zero()),
-            CommitmentPrefix::empty(),
+            CommitmentPrefix::try_from(vec![0]).expect("no error"),
         ),
         ConnectionVersion::compatibles(),
         ZERO_DURATION,
@@ -96,7 +95,7 @@ fn recv_packet_fail_no_channel(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -114,16 +113,14 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
         chan_end_on_b,
         client_height,
         host_height,
-        client_id,
         ..
     } = fixture;
 
     let packet = &msg.packet;
-    let mut context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+    let context = context
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_b)
         .with_channel(
@@ -136,7 +133,7 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
             packet.chan_id_on_b.clone(),
             1.into(),
         )
-        .with_height(host_height)
+        .advance_block_up_to_height(host_height)
         // This `with_recv_sequence` is required for ordered channels
         .with_recv_sequence(
             packet.port_id_on_b.clone(),
@@ -144,19 +141,9 @@ fn recv_packet_validate_happy_path(fixture: Fixture) {
             packet.seq_on_a,
         );
 
-    context
-        .get_client_execution_context()
-        .store_update_meta(
-            client_id,
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-            Height::new(0, 5).unwrap(),
-        )
-        .unwrap();
-
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -198,17 +185,16 @@ fn recv_packet_timeout_expired(fixture: Fixture) {
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg_packet_old));
 
     let context = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_b)
         .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_b)
         .with_send_sequence(PortId::transfer(), ChannelId::zero(), 1.into())
-        .with_height(host_height);
+        .advance_block_up_to_height(host_height);
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -228,17 +214,16 @@ fn recv_packet_execute_happy_path(fixture: Fixture) {
         ..
     } = fixture;
     let mut ctx = context
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_b)
         .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_b);
 
     let msg_env = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_env);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_env);
 
     assert!(res.is_ok());
 
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
index 15d3c82f4..3a2bace44 100644
--- a/ibc-testkit/tests/core/ics04_channel/send_packet.rs
+++ b/ibc-testkit/tests/core/ics04_channel/send_packet.rs
@@ -15,8 +15,10 @@ use ibc::core::connection::types::{
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_packet;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::hosts::MockHost;
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use test_log::test;
 
 #[test]
@@ -30,8 +32,6 @@ fn send_packet_processing() {
         want_pass: bool,
     }
 
-    let context = MockContext::default();
-
     let chan_end_on_a = ChannelEnd::new(
         State::Open,
         Order::Unordered,
@@ -45,9 +45,9 @@ fn send_packet_processing() {
         ConnectionState::Open,
         default_client_id.clone(),
         ConnectionCounterparty::new(
-            default_client_id.clone(),
+            default_client_id,
             Some(ConnectionId::zero()),
-            CommitmentPrefix::empty(),
+            CommitmentPrefix::try_from(vec![0]).expect("no error"),
         ),
         ConnectionVersion::compatibles(),
         ZERO_DURATION,
@@ -95,18 +95,16 @@ fn send_packet_processing() {
     let tests: Vec<Test> = vec![
         Test {
             name: "Processing fails because no channel exists in the context".to_string(),
-            ctx: context.clone(),
+            ctx: MockContext::default(),
             packet: packet.clone(),
             want_pass: false,
         },
         Test {
             name: "Good parameters".to_string(),
-            ctx: context
-                .clone()
-                .with_client_config(
-                    MockClientConfig::builder()
-                        .latest_height(client_height)
-                        .build(),
+            ctx: MockContext::default()
+                .with_light_client(
+                    &ClientId::new("07-tendermint", 0).expect("no error"),
+                    LightClientState::<MockHost>::with_latest_height(client_height),
                 )
                 .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
                 .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
@@ -116,12 +114,10 @@ fn send_packet_processing() {
         },
         Test {
             name: "Packet timeout height same as destination chain height".to_string(),
-            ctx: context
-                .clone()
-                .with_client_config(
-                    MockClientConfig::builder()
-                        .latest_height(client_height)
-                        .build(),
+            ctx: MockContext::default()
+                .with_light_client(
+                    &ClientId::new("07-tendermint", 0).expect("no error"),
+                    LightClientState::<MockHost>::with_latest_height(client_height),
                 )
                 .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
                 .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
@@ -131,12 +127,10 @@ fn send_packet_processing() {
         },
         Test {
             name: "Packet timeout height one more than destination chain height".to_string(),
-            ctx: context
-                .clone()
-                .with_client_config(
-                    MockClientConfig::builder()
-                        .latest_height(client_height)
-                        .build(),
+            ctx: MockContext::default()
+                .with_light_client(
+                    &ClientId::new("07-tendermint", 0).expect("no error"),
+                    LightClientState::<MockHost>::with_latest_height(client_height),
                 )
                 .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
                 .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
@@ -146,12 +140,10 @@ fn send_packet_processing() {
         },
         Test {
             name: "Packet without height and timestamp timeout".to_string(),
-            ctx: context
-                .clone()
-                .with_client_config(
-                    MockClientConfig::builder()
-                        .latest_height(client_height)
-                        .build(),
+            ctx: MockContext::default()
+                .with_light_client(
+                    &ClientId::new("07-tendermint", 0).expect("no error"),
+                    LightClientState::<MockHost>::with_latest_height(client_height),
                 )
                 .with_connection(ConnectionId::zero(), conn_end_on_a.clone())
                 .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a.clone())
@@ -161,11 +153,10 @@ fn send_packet_processing() {
         },
         Test {
             name: "Packet timeout due to timestamp".to_string(),
-            ctx: context
-                .with_client_config(
-                    MockClientConfig::builder()
-                        .latest_height(client_height)
-                        .build(),
+            ctx: MockContext::default()
+                .with_light_client(
+                    &ClientId::new("07-tendermint", 0).expect("no error"),
+                    LightClientState::<MockHost>::with_latest_height(client_height),
                 )
                 .with_connection(ConnectionId::zero(), conn_end_on_a)
                 .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a)
@@ -178,7 +169,7 @@ fn send_packet_processing() {
     .collect();
 
     for mut test in tests {
-        let res = send_packet(&mut test.ctx, test.packet.clone());
+        let res = send_packet(&mut test.ctx.ibc_store, test.packet.clone());
         // Additionally check the events and the output objects in the result.
         match res {
             Ok(()) => {
@@ -187,7 +178,7 @@ fn send_packet_processing() {
                         "send_packet: test passed but was supposed to fail for test: {}, \nparams {:?} {:?}",
                         test.name,
                         test.packet.clone(),
-                        test.ctx.clone()
+                        test.ctx
                     );
 
                 let ibc_events = test.ctx.get_events();
@@ -208,7 +199,7 @@ fn send_packet_processing() {
                     "send_packet: did not pass test: {}, \nparams {:?} {:?} error: {:?}",
                     test.name,
                     test.packet.clone(),
-                    test.ctx.clone(),
+                    test.ctx,
                     e,
                 );
             }
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/ibc-testkit/tests/core/ics04_channel/timeout.rs
index 05036636a..240ddd4a8 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout.rs
@@ -13,23 +13,25 @@ use ibc::core::entrypoint::{execute, validate};
 use ibc::core::handler::types::events::{IbcEvent, MessageEvent};
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::host::ExecutionContext;
+use ibc::core::host::types::path::ClientConsensusStatePath;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 
 struct Fixture {
     ctx: MockContext,
     pub router: MockRouter,
+    client_id: ClientId,
     client_height: Height,
     msg: MsgTimeout,
     packet_commitment: PacketCommitment,
     conn_end_on_a: ConnectionEnd,
     chan_end_on_a_ordered: ChannelEnd,
     chan_end_on_a_unordered: ChannelEnd,
-    client_id: ClientId,
 }
 
 #[fixture]
@@ -37,19 +39,19 @@ fn fixture() -> Fixture {
     let client_id = ClientId::new("07-tendermint", 0).expect("no error");
 
     let client_height = Height::new(0, 2).unwrap();
-    let ctx = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .latest_height(client_height)
-            .build(),
+    let ctx = MockContext::default().with_light_client(
+        &ClientId::new("07-tendermint", 0).expect("no error"),
+        LightClientState::<MockHost>::with_latest_height(client_height),
     );
 
     let client_height = Height::new(0, 2).unwrap();
 
     let router = MockRouter::new_with_transfer();
 
+    // in case of timeout, timeout timestamp should be less than host's timestamp
+    let timeout_timestamp = ctx.latest_timestamp().nanoseconds() - 1;
     let msg_proof_height = 2;
     let msg_timeout_height = 5;
-    let timeout_timestamp = Timestamp::now().nanoseconds();
 
     let msg = MsgTimeout::try_from(dummy_raw_msg_timeout(
         msg_proof_height,
@@ -84,7 +86,7 @@ fn fixture() -> Fixture {
         ConnectionCounterparty::new(
             client_id.clone(),
             Some(ConnectionId::zero()),
-            CommitmentPrefix::empty(),
+            CommitmentPrefix::try_from(vec![0]).expect("no error"),
         ),
         ConnectionVersion::compatibles(),
         ZERO_DURATION,
@@ -94,13 +96,13 @@ fn fixture() -> Fixture {
     Fixture {
         ctx,
         router,
+        client_id,
         client_height,
         msg,
         packet_commitment,
         conn_end_on_a,
         chan_end_on_a_ordered,
         chan_end_on_a_unordered,
-        client_id,
     }
 }
 
@@ -113,13 +115,12 @@ fn timeout_fail_no_channel(fixture: Fixture) {
         client_height,
         ..
     } = fixture;
-    let ctx = ctx.with_client_config(
-        MockClientConfig::builder()
-            .latest_height(client_height)
-            .build(),
+    let ctx = ctx.with_light_client(
+        &ClientId::new("07-tendermint", 0).expect("no error"),
+        LightClientState::<MockHost>::with_latest_height(client_height),
     );
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -136,12 +137,13 @@ fn timeout_fail_no_consensus_state_for_height(fixture: Fixture) {
         chan_end_on_a_unordered,
         conn_end_on_a,
         packet_commitment,
+        client_id,
         ..
     } = fixture;
 
     let packet = msg.packet.clone();
 
-    let ctx = ctx
+    let mut ctx = ctx
         .with_channel(
             PortId::transfer(),
             ChannelId::zero(),
@@ -155,9 +157,19 @@ fn timeout_fail_no_consensus_state_for_height(fixture: Fixture) {
             packet_commitment,
         );
 
+    let consensus_state_path = ClientConsensusStatePath::new(
+        client_id,
+        msg.proof_height_on_b.revision_number(),
+        msg.proof_height_on_b.revision_height(),
+    );
+
+    ctx.ibc_store
+        .delete_consensus_state(consensus_state_path)
+        .expect("consensus state exists");
+
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
             res.is_err(),
@@ -174,7 +186,6 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
         chan_end_on_a_unordered,
         conn_end_on_a,
         client_height,
-        client_id,
         ..
     } = fixture;
 
@@ -190,11 +201,10 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
 
     let packet = msg.packet.clone();
 
-    let mut ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+    let ctx = ctx
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_channel(
@@ -209,17 +219,9 @@ fn timeout_fail_proof_timeout_not_reached(fixture: Fixture) {
             packet_commitment,
         );
 
-    ctx.store_update_meta(
-        client_id,
-        client_height,
-        Timestamp::from_nanoseconds(5).unwrap(),
-        Height::new(0, 4).unwrap(),
-    )
-    .unwrap();
-
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
             res.is_err(),
@@ -248,7 +250,7 @@ fn timeout_success_no_packet_commitment(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -266,17 +268,15 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
         conn_end_on_a,
         packet_commitment,
         client_height,
-        client_id,
         ..
     } = fixture;
 
     let packet = msg.packet.clone();
 
-    let mut ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+    let ctx = ctx
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_channel(
@@ -291,18 +291,9 @@ fn timeout_unordered_channel_validate(fixture: Fixture) {
             packet_commitment,
         );
 
-    ctx.get_client_execution_context()
-        .store_update_meta(
-            client_id,
-            client_height,
-            Timestamp::from_nanoseconds(1000).unwrap(),
-            Height::new(0, 5).unwrap(),
-        )
-        .unwrap();
-
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(res.is_ok(), "Good parameters for unordered channels")
 }
@@ -317,17 +308,15 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
         conn_end_on_a,
         packet_commitment,
         client_height,
-        client_id,
         ..
     } = fixture;
 
     let packet = msg.packet.clone();
 
-    let mut ctx = ctx
-        .with_client_config(
-            MockClientConfig::builder()
-                .latest_height(client_height)
-                .build(),
+    let ctx = ctx
+        .with_light_client(
+            &ClientId::new("07-tendermint", 0).expect("no error"),
+            LightClientState::<MockHost>::with_latest_height(client_height),
         )
         .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a_ordered)
@@ -338,17 +327,9 @@ fn timeout_ordered_channel_validate(fixture: Fixture) {
             packet_commitment,
         );
 
-    ctx.store_update_meta(
-        client_id,
-        client_height,
-        Timestamp::from_nanoseconds(1000).unwrap(),
-        Height::new(0, 4).unwrap(),
-    )
-    .unwrap();
-
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&ctx, &router, msg_envelope);
+    let res = validate(&ctx.ibc_store, &router, msg_envelope);
 
     assert!(res.is_ok(), "Good parameters for unordered channels")
 }
@@ -380,7 +361,7 @@ fn timeout_unordered_chan_execute(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok());
 
@@ -418,7 +399,7 @@ fn timeout_ordered_chan_execute(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = execute(&mut ctx, &mut router, msg_envelope);
+    let res = execute(&mut ctx.ibc_store, &mut router, msg_envelope);
 
     assert!(res.is_ok());
 
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
index 39a4c306a..a454261fd 100644
--- a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
+++ b/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
@@ -2,7 +2,6 @@ use ibc::core::channel::types::channel::{ChannelEnd, Counterparty, Order, State}
 use ibc::core::channel::types::commitment::{compute_packet_commitment, PacketCommitment};
 use ibc::core::channel::types::msgs::{MsgTimeoutOnClose, PacketMsg};
 use ibc::core::channel::types::Version;
-use ibc::core::client::context::ClientExecutionContext;
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
 use ibc::core::connection::types::version::Version as ConnectionVersion;
@@ -12,11 +11,12 @@ use ibc::core::connection::types::{
 use ibc::core::entrypoint::validate;
 use ibc::core::handler::types::msgs::MsgEnvelope;
 use ibc::core::host::types::identifiers::{ChannelId, ClientId, ConnectionId, PortId};
-use ibc::core::host::ExecutionContext;
 use ibc::core::primitives::*;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::core::channel::dummy_raw_msg_timeout_on_close;
+use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{MockClientConfig, MockContext};
+use ibc_testkit::testapp::ibc::core::types::LightClientState;
 use rstest::*;
 
 pub struct Fixture {
@@ -33,10 +33,9 @@ fn fixture() -> Fixture {
     let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
 
     let client_height = Height::new(0, 2).unwrap();
-    let context = MockContext::default().with_client_config(
-        MockClientConfig::builder()
-            .latest_height(client_height)
-            .build(),
+    let context = MockContext::default().with_light_client(
+        &ClientId::new("07-tendermint", 0).expect("no error"),
+        LightClientState::<MockHost>::with_latest_height(client_height),
     );
     let router = MockRouter::new_with_transfer();
 
@@ -68,9 +67,9 @@ fn fixture() -> Fixture {
         ConnectionState::Open,
         default_client_id.clone(),
         ConnectionCounterparty::new(
-            default_client_id.clone(),
+            default_client_id,
             Some(ConnectionId::zero()),
-            CommitmentPrefix::empty(),
+            CommitmentPrefix::try_from(vec![0]).expect("no error"),
         ),
         ConnectionVersion::compatibles(),
         ZERO_DURATION,
@@ -98,7 +97,7 @@ fn timeout_on_close_fail_no_channel(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_err(),
@@ -123,7 +122,7 @@ fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
 
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
@@ -133,8 +132,6 @@ fn timeout_on_close_success_no_packet_commitment(fixture: Fixture) {
 
 #[rstest]
 fn timeout_on_close_success_happy_path(fixture: Fixture) {
-    let default_client_id = ClientId::new("07-tendermint", 0).expect("no error");
-
     let Fixture {
         context,
         router,
@@ -144,7 +141,7 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
         chan_end_on_a,
         ..
     } = fixture;
-    let mut context = context
+    let context = context
         .with_channel(PortId::transfer(), ChannelId::zero(), chan_end_on_a)
         .with_connection(ConnectionId::zero(), conn_end_on_a)
         .with_packet_commitment(
@@ -154,19 +151,9 @@ fn timeout_on_close_success_happy_path(fixture: Fixture) {
             packet_commitment,
         );
 
-    context
-        .get_client_execution_context()
-        .store_update_meta(
-            default_client_id,
-            Height::new(0, 2).unwrap(),
-            Timestamp::from_nanoseconds(5000).unwrap(),
-            Height::new(0, 5).unwrap(),
-        )
-        .unwrap();
-
     let msg_envelope = MsgEnvelope::from(PacketMsg::from(msg));
 
-    let res = validate(&context, &router, msg_envelope);
+    let res = validate(&context.ibc_store, &router, msg_envelope);
 
     assert!(
         res.is_ok(),
diff --git a/ibc-testkit/tests/core/router.rs b/ibc-testkit/tests/core/router.rs
index 0c00926c6..5bc657702 100644
--- a/ibc-testkit/tests/core/router.rs
+++ b/ibc-testkit/tests/core/router.rs
@@ -1,3 +1,5 @@
+use core::ops::Add;
+
 use ibc::apps::transfer::handler::send_transfer;
 use ibc::apps::transfer::types::error::TokenTransferError;
 use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
@@ -20,6 +22,7 @@ use ibc::core::host::types::path::CommitmentPath;
 use ibc::core::host::ValidationContext;
 use ibc::core::primitives::prelude::*;
 use ibc::core::primitives::Timestamp;
+use ibc_testkit::context::MockContext;
 use ibc_testkit::fixtures::applications::transfer::{
     extract_transfer_packet, MsgTransferConfig, PacketDataConfig,
 };
@@ -33,13 +36,13 @@ use ibc_testkit::fixtures::core::connection::{
     dummy_msg_conn_open_ack, dummy_msg_conn_open_init, dummy_msg_conn_open_init_with_client_id,
     dummy_msg_conn_open_try, msg_conn_open_try_with_client_id,
 };
+use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::testapp::ibc::applications::transfer::types::DummyTransferModule;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::MockClientState;
 use ibc_testkit::testapp::ibc::clients::mock::consensus_state::MockConsensusState;
 use ibc_testkit::testapp::ibc::clients::mock::header::MockHeader;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::MockContext;
 use test_log::test;
 
 #[test]
@@ -87,14 +90,23 @@ fn routing_module_and_keepers() {
     let upgrade_client_height_second = Height::new(1, 1).unwrap();
 
     // We reuse this same context across all tests. Nothing in particular needs parametrizing.
-    let mut ctx = MockContext::default();
+    let mut ctx = TestContextConfig::builder()
+        // a future timestamp, so that submitted packets are considered from past
+        // not more than 5 secs, as later dummy_raw_msg_timeout_on_close(*, 5) is used
+        .latest_timestamp(
+            Timestamp::now()
+                .add(core::time::Duration::from_secs(4))
+                .unwrap(),
+        )
+        .build::<MockContext>();
 
     let mut router = MockRouter::new_with_transfer();
 
+    let header = MockHeader::new(start_client_height).with_current_timestamp();
+
     let create_client_msg = MsgCreateClient::new(
-        MockClientState::new(MockHeader::new(start_client_height).with_current_timestamp()).into(),
-        MockConsensusState::new(MockHeader::new(start_client_height).with_current_timestamp())
-            .into(),
+        MockClientState::new(header).into(),
+        MockConsensusState::new(header).into(),
         default_signer.clone(),
     );
 
@@ -156,7 +168,7 @@ fn routing_module_and_keepers() {
         .build();
 
     let msg_transfer_no_timeout_or_timestamp = MsgTransferConfig::builder()
-        .packet_data(packet_data.clone())
+        .packet_data(packet_data)
         // Timestamp::from_nanoseconds(0) and Timestamp::none() are equivalent
         .timeout_timestamp_on_b(Timestamp::from_nanoseconds(0).unwrap())
         .build();
@@ -181,7 +193,7 @@ fn routing_module_and_keepers() {
 
     // First, create a client..
     let res = dispatch(
-        &mut ctx,
+        &mut ctx.ibc_store,
         &mut router,
         MsgEnvelope::Client(ClientMsg::CreateClient(create_client_msg.clone())),
     );
@@ -318,12 +330,13 @@ fn routing_module_and_keepers() {
             msg: MsgEnvelope::Packet(PacketMsg::Ack(msg_ack_packet.clone())).into(),
             want_pass: true,
             state_check: Some(Box::new(move |ctx| {
-                ctx.get_packet_commitment(&CommitmentPath::new(
-                    &msg_ack_packet.packet.port_id_on_a,
-                    &msg_ack_packet.packet.chan_id_on_a,
-                    msg_ack_packet.packet.seq_on_a,
-                ))
-                .is_err()
+                ctx.ibc_store
+                    .get_packet_commitment(&CommitmentPath::new(
+                        &msg_ack_packet.packet.port_id_on_a,
+                        &msg_ack_packet.packet.chan_id_on_a,
+                        msg_ack_packet.packet.seq_on_a,
+                    ))
+                    .is_err()
             })),
         },
         Test {
@@ -404,8 +417,8 @@ fn routing_module_and_keepers() {
 
     for test in tests {
         let res = match test.msg.clone() {
-            TestMsg::Ics26(msg) => dispatch(&mut ctx, &mut router, msg).map(|_| ()),
-            TestMsg::Ics20(msg) => send_transfer(&mut ctx, &mut DummyTransferModule, msg)
+            TestMsg::Ics26(msg) => dispatch(&mut ctx.ibc_store, &mut router, msg),
+            TestMsg::Ics20(msg) => send_transfer(&mut ctx.ibc_store, &mut DummyTransferModule, msg)
                 .map_err(|e: TokenTransferError| ChannelError::AppModule {
                     description: e.to_string(),
                 })
diff --git a/ibc-testkit/tests/cosmwasm/fixture.rs b/ibc-testkit/tests/cosmwasm/fixture.rs
index 946f9ac66..8e8403342 100644
--- a/ibc-testkit/tests/cosmwasm/fixture.rs
+++ b/ibc-testkit/tests/cosmwasm/fixture.rs
@@ -89,11 +89,9 @@ impl Fixture {
         // Setting the `trusting_period` to 1 second allows the quick
         // client expiry for the tests.
         let tm_client_state: TmClientState = ClientStateConfig::builder()
-            .chain_id(self.chain_id.clone())
             .trusting_period(Duration::from_secs(1))
-            .latest_height(self.trusted_height)
             .build()
-            .try_into()
+            .into_client_state(self.chain_id.clone(), self.trusted_height)
             .expect("never fails");
 
         let tm_consensus_state = dummy_sov_consensus_state(self.trusted_timestamp);

From 4ea4dcb863efa12f5628a05588e2207112035e4a Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 3 May 2024 18:32:18 +0200
Subject: [PATCH 170/182] imp(ics-07): simplify `ClientType` impl in cw
 contract (#1202)

* impl TryFrom

* simplify Tendermint ClientType impl

* add comment

* rm Clone bound

* Implement From<ConsensusState>

* Remove unneeded dependency

* Format cargo.toml file

* nit

* update gh workflow titles

---------

Signed-off-by: Rano | Ranadeep <ranadeep@informal.systems>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 .github/workflows/upload-cw-clients.yaml      |  4 +-
 ibc-clients/cw-context/src/api.rs             |  2 +-
 ibc-clients/cw-context/src/context/mod.rs     |  2 +-
 ibc-clients/cw-context/src/handlers.rs        |  6 ++-
 .../cw-contract/src/client_type.rs            | 53 +------------------
 .../cw-contract/src/entrypoint.rs             | 12 +----
 .../ics07-tendermint/src/consensus_state.rs   |  6 +++
 ibc-core/ics02-client/types/src/error.rs      |  8 +++
 8 files changed, 25 insertions(+), 68 deletions(-)

diff --git a/.github/workflows/upload-cw-clients.yaml b/.github/workflows/upload-cw-clients.yaml
index 224d54bec..6ee12e7e4 100644
--- a/.github/workflows/upload-cw-clients.yaml
+++ b/.github/workflows/upload-cw-clients.yaml
@@ -1,4 +1,4 @@
-name: Upload CosmWasm clients as Github workflow artifact
+name: Upload precompiled CosmWasm clients
 on:
   pull_request:
     paths:
@@ -36,7 +36,7 @@ concurrency:
 
 jobs:
   upload-tendermint-cw-client:
-    name: Compile and upload Tendermint CosmWasm client
+    name: Upload precompiled Tendermint CosmWasm client
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
diff --git a/ibc-clients/cw-context/src/api.rs b/ibc-clients/cw-context/src/api.rs
index dfcbe7ce9..0788520cc 100644
--- a/ibc-clients/cw-context/src/api.rs
+++ b/ibc-clients/cw-context/src/api.rs
@@ -13,6 +13,6 @@ where
     <Self::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
     <Self::ConsensusState as TryFrom<Any>>::Error: Into<ClientError>,
 {
-    type ClientState: ClientStateExecution<Context<'a, Self>> + Clone;
+    type ClientState: ClientStateExecution<Context<'a, Self>>;
     type ConsensusState: ConsensusStateTrait;
 }
diff --git a/ibc-clients/cw-context/src/context/mod.rs b/ibc-clients/cw-context/src/context/mod.rs
index ea8518297..4c483e946 100644
--- a/ibc-clients/cw-context/src/context/mod.rs
+++ b/ibc-clients/cw-context/src/context/mod.rs
@@ -298,9 +298,9 @@ where
         client_state: C::ClientState,
     ) -> Result<Vec<u8>, ClientError> {
         let wasm_client_state = WasmClientState {
-            data: C::ClientState::encode_to_any_vec(client_state.clone()),
             checksum: self.obtain_checksum()?,
             latest_height: client_state.latest_height(),
+            data: C::ClientState::encode_to_any_vec(client_state),
         };
 
         Ok(Any::from(wasm_client_state).encode_to_vec())
diff --git a/ibc-clients/cw-context/src/handlers.rs b/ibc-clients/cw-context/src/handlers.rs
index fdf9c3ed2..4b4798d1e 100644
--- a/ibc-clients/cw-context/src/handlers.rs
+++ b/ibc-clients/cw-context/src/handlers.rs
@@ -138,13 +138,15 @@ where
                         substitute_client_state.latest_height().revision_height(),
                     ))?;
 
+                let substitute_client_state_any = substitute_client_state.into();
+
                 self.set_subject_prefix();
-                client_state.check_substitute(self, substitute_client_state.clone().into())?;
+                client_state.check_substitute(self, substitute_client_state_any.clone())?;
 
                 client_state.update_on_recovery(
                     self,
                     &self.client_id(),
-                    substitute_client_state.into(),
+                    substitute_client_state_any,
                     substitute_consensus_state.into(),
                 )?;
 
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs b/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
index dde85427b..001657220 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/client_type.rs
@@ -1,12 +1,6 @@
 use ibc_client_cw::api::ClientType;
 use ibc_client_tendermint::client_state::ClientState;
 use ibc_client_tendermint::consensus_state::ConsensusState;
-use ibc_client_tendermint::types::{
-    ConsensusState as ConsensusStateType, TENDERMINT_CONSENSUS_STATE_TYPE_URL,
-};
-use ibc_core::client::types::error::ClientError;
-use ibc_core::derive::ConsensusState as ConsensusStateDerive;
-use ibc_core::primitives::proto::Any;
 
 /// A unit struct that represents the Tendermint client type.
 #[derive(Clone, Debug)]
@@ -14,50 +8,5 @@ pub struct TendermintClient;
 
 impl<'a> ClientType<'a> for TendermintClient {
     type ClientState = ClientState;
-    type ConsensusState = AnyConsensusState;
-}
-
-#[derive(Clone, Debug, ConsensusStateDerive)]
-pub enum AnyConsensusState {
-    Tendermint(ConsensusState),
-}
-
-impl From<ConsensusStateType> for AnyConsensusState {
-    fn from(value: ConsensusStateType) -> Self {
-        AnyConsensusState::Tendermint(value.into())
-    }
-}
-
-impl TryFrom<AnyConsensusState> for ConsensusStateType {
-    type Error = ClientError;
-
-    fn try_from(value: AnyConsensusState) -> Result<Self, Self::Error> {
-        match value {
-            AnyConsensusState::Tendermint(state) => Ok(state.into_inner()),
-        }
-    }
-}
-
-impl From<AnyConsensusState> for Any {
-    fn from(value: AnyConsensusState) -> Self {
-        match value {
-            AnyConsensusState::Tendermint(cs) => cs.into(),
-        }
-    }
-}
-
-impl TryFrom<Any> for AnyConsensusState {
-    type Error = ClientError;
-
-    fn try_from(raw: Any) -> Result<Self, Self::Error> {
-        match raw.type_url.as_str() {
-            TENDERMINT_CONSENSUS_STATE_TYPE_URL => {
-                let cs = ConsensusState::try_from(raw)?;
-                Ok(AnyConsensusState::Tendermint(cs))
-            }
-            _ => Err(ClientError::UnknownConsensusStateType {
-                consensus_state_type: raw.type_url,
-            }),
-        }
-    }
+    type ConsensusState = ConsensusState;
 }
diff --git a/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs b/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
index b496c97c1..e01e796b9 100644
--- a/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
+++ b/ibc-clients/ics07-tendermint/cw-contract/src/entrypoint.rs
@@ -1,6 +1,4 @@
-use cosmwasm_std::{
-    entry_point, Binary, Deps, DepsMut, Env, MessageInfo, Response, StdError, StdResult,
-};
+use cosmwasm_std::{entry_point, Binary, Deps, DepsMut, Env, MessageInfo, Response};
 use ibc_client_cw::context::Context;
 use ibc_client_cw::types::{ContractError, InstantiateMsg, QueryMsg, SudoMsg};
 
@@ -16,25 +14,19 @@ pub fn instantiate(
     msg: InstantiateMsg,
 ) -> Result<Response, ContractError> {
     let mut ctx = TendermintContext::new_mut(deps, env)?;
-
     let data = ctx.instantiate(msg)?;
-
     Ok(Response::default().set_data(data))
 }
 
 #[entry_point]
 pub fn sudo(deps: DepsMut<'_>, env: Env, msg: SudoMsg) -> Result<Response, ContractError> {
     let mut ctx = TendermintContext::new_mut(deps, env)?;
-
     let data = ctx.sudo(msg)?;
-
     Ok(Response::default().set_data(data))
 }
 
 #[entry_point]
-pub fn query(deps: Deps<'_>, env: Env, msg: QueryMsg) -> StdResult<Binary> {
+pub fn query(deps: Deps<'_>, env: Env, msg: QueryMsg) -> Result<Binary, ContractError> {
     let ctx = TendermintContext::new_ref(deps, env)?;
-
     ctx.query(msg)
-        .map_err(|e| StdError::generic_err(e.to_string()))
 }
diff --git a/ibc-clients/ics07-tendermint/src/consensus_state.rs b/ibc-clients/ics07-tendermint/src/consensus_state.rs
index d923ebb73..e87778f37 100644
--- a/ibc-clients/ics07-tendermint/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/src/consensus_state.rs
@@ -43,6 +43,12 @@ impl ConsensusState {
     }
 }
 
+impl From<ConsensusState> for ConsensusStateType {
+    fn from(value: ConsensusState) -> Self {
+        value.0
+    }
+}
+
 impl Protobuf<RawTmConsensusState> for ConsensusState {}
 
 impl TryFrom<RawTmConsensusState> for ConsensusState {
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 0783c906b..9eb5c51da 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -1,5 +1,7 @@
 //! Defines the client error type
 
+use core::convert::Infallible;
+
 use displaydoc::Display;
 use ibc_core_commitment_types::error::CommitmentError;
 use ibc_core_host_types::error::IdentifierError;
@@ -113,6 +115,12 @@ impl From<&'static str> for ClientError {
     }
 }
 
+impl From<Infallible> for ClientError {
+    fn from(value: Infallible) -> Self {
+        match value {}
+    }
+}
+
 #[cfg(feature = "std")]
 impl std::error::Error for ClientError {
     fn source(&self) -> Option<&(dyn std::error::Error + 'static)> {

From 4eba9e107144eb153831a65b5956ae45b5d9cd56 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Fri, 10 May 2024 16:53:11 +0200
Subject: [PATCH 171/182] imp(testkit): integration test for packet timeout
 (#1215)

* use basecoin rev

* rm RevertibleStore and GrowingStore use

* add packet timeout integration test

this verifies non-membership proofs

* reorder imports

* add timeout_packet_on_channel_close_on_a in utils

* add timeout_packet_on_channel_close_on_a in context

* test for packet timeout on channel close

* use correct event type

* validate packet events

* rm dbg

* add send_packet_via_dummy_transfer_module_on_a method

* use the new method

* add changelog entry

* update doc links

* fix link in doc-strings

* fix for serde feature

* basecoin main branch

* fix unused imports

* cargo format

* fix link in doc-strings

* fix method names and comments
---
 ...17-fix-packet-timeout-on-closed-channel.md |   2 +
 docs/architecture/adr-009-revamp-testkit.md   |  14 +-
 .../src/handler/timeout_on_close.rs           |   2 +-
 ibc-testkit/Cargo.toml                        |   2 +-
 ibc-testkit/src/context.rs                    |   4 +-
 ibc-testkit/src/relayer/context.rs            | 191 +++++++++++++++++-
 ibc-testkit/src/relayer/integration.rs        | 156 +++++++-------
 ibc-testkit/src/relayer/mod.rs                |   5 +-
 ibc-testkit/src/relayer/utils.rs              |  89 +++++++-
 .../tests/core/ics02_client/recover_client.rs |   2 +-
 .../core/ics03_connection/conn_open_ack.rs    |   5 +-
 11 files changed, 374 insertions(+), 98 deletions(-)
 create mode 100644 .changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md

diff --git a/.changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md b/.changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md
new file mode 100644
index 000000000..e98541b39
--- /dev/null
+++ b/.changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md
@@ -0,0 +1,2 @@
+- [ibc-core] Fix proof verification for `PacketTimeout` on a closed channel.
+  ([\#1217](https://github.com/cosmos/ibc-rs/issues/1217))
diff --git a/docs/architecture/adr-009-revamp-testkit.md b/docs/architecture/adr-009-revamp-testkit.md
index 8bf5af3e2..9f4541638 100644
--- a/docs/architecture/adr-009-revamp-testkit.md
+++ b/docs/architecture/adr-009-revamp-testkit.md
@@ -304,16 +304,16 @@ The following provides the concrete implementations of the proposed changes:
 #### MockIbcStore
 
 The modified `MockIbcStore` with Merkle store lives at
-[`testapp/ibc/core/types.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/testapp/ibc/core/types.rs#L43-L96).
+[`testapp/ibc/core/types.rs`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/testapp/ibc/core/types.rs#L43-L96).
 
 #### TestHost
 
 The Rust trait lives at
-[`hosts/mod.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/mod.rs#L27).
+[`hosts/mod.rs`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/hosts/mod.rs#L27).
 The `Mock` and `Tendermint` host implementations live in
-[`hosts/mock.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/mock.rs#L30)
+[`hosts/mock.rs`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/hosts/mock.rs#L30)
 and
-[`hosts/tendermint.rs`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/hosts/tendermint.rs#L42)
+[`hosts/tendermint.rs`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/hosts/tendermint.rs#L42)
 respectively.
 
 #### Renaming `MockContext` to `StoreGenericTestContext`
@@ -328,14 +328,14 @@ have `Mock` in their name.
 
 #### StoreGenericTestContext
 
-[`StoreGenericTestContext`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/context.rs#L34-L52)
+[`StoreGenericTestContext`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/context.rs#L34-L52)
 is actually what is described as `MockContext` in the ADR. For convenience, we
 defined `TestContext` to have a concrete store implementation -
-[`MockStore`](https://github.com/cosmos/ibc-rs/blob/feat/refactor-testkit/ibc-testkit/src/context.rs#L55-L56).
+[`MockStore`](https://github.com/cosmos/ibc-rs/blob/main/ibc-testkit/src/context.rs#L55-L56).
 
 ```rs
 // A mock store type using basecoin-storage implementations.
-pub type MockStore = RevertibleStore<GrowingStore<InMemoryStore>>;
+pub type MockStore = InMemoryStore;
 
 pub type TestContext<H> = StoreGenericTestContext<MockStore, H>;
 ```
diff --git a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
index 0aa5a4027..8366a5d26 100644
--- a/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
+++ b/ibc-core/ics04-channel/src/handler/timeout_on_close.rs
@@ -109,7 +109,7 @@ where
         client_state_of_b_on_a
             .verify_membership(
                 prefix_on_b,
-                &msg.proof_unreceived_on_b,
+                &msg.proof_close_on_b,
                 consensus_state_of_b_on_a.root(),
                 Path::ChannelEnd(chan_end_path_on_b),
                 expected_chan_end_on_b.encode_vec(),
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 0ab0ed09e..7887a30f1 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -36,7 +36,7 @@ ibc-client-tendermint-cw = { workspace = true }
 ibc-query                = { workspace = true }
 
 # basecoin dependencies
-basecoin-store = { git = "https://github.com/informalsystems/basecoin-rs", rev = "8496b3f" }
+basecoin-store = { git = "https://github.com/informalsystems/basecoin-rs", rev = "2dd5b95" }
 
 # cosmos dependencies
 tendermint         = { workspace = true }
diff --git a/ibc-testkit/src/context.rs b/ibc-testkit/src/context.rs
index 74d141f2e..7af55cc7d 100644
--- a/ibc-testkit/src/context.rs
+++ b/ibc-testkit/src/context.rs
@@ -2,7 +2,7 @@ use core::fmt::Debug;
 use core::time::Duration;
 
 use basecoin_store::context::ProvableStore;
-use basecoin_store::impls::{GrowingStore, InMemoryStore, RevertibleStore};
+use basecoin_store::impls::InMemoryStore;
 use ibc::core::channel::types::channel::ChannelEnd;
 use ibc::core::channel::types::commitment::PacketCommitment;
 use ibc::core::client::context::client_state::ClientStateValidation;
@@ -53,7 +53,7 @@ where
 }
 
 /// A mock store type using basecoin-storage implementations.
-pub type MockStore = RevertibleStore<GrowingStore<InMemoryStore>>;
+pub type MockStore = InMemoryStore;
 /// A [`StoreGenericTestContext`] using [`MockStore`].
 pub type TestContext<H> = StoreGenericTestContext<MockStore, H>;
 /// A [`StoreGenericTestContext`] using [`MockStore`] and [`MockHost`].
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index 232fb6074..43f2a612f 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -306,9 +306,11 @@ where
         )
     }
 
-    /// Sends a packet from the first context to the second context.
+    /// Sends a packet from the first context to the second context by
+    /// submitting on receive packet on the second context.
+    ///
     /// The IBC packet is created by an IBC application on the first context.
-    pub fn send_packet_on_a(&mut self, packet: Packet, signer: Signer) {
+    pub fn submit_packet_on_b(&mut self, packet: Packet, signer: Signer) {
         let conn_id_on_a = self
             .ctx_a
             .ibc_store()
@@ -347,7 +349,7 @@ where
             .client_id()
             .clone();
 
-        TypedRelayerOps::<A, B>::send_packet_on_a(
+        TypedRelayerOps::<A, B>::submit_packet_on_b(
             &mut self.ctx_a,
             &mut self.ctx_b,
             packet,
@@ -356,4 +358,187 @@ where
             signer,
         )
     }
+
+    /// Times out a packet from the first context to the second context by
+    /// waiting for timeout period and then sending timeout packet on first context.
+    ///
+    /// The IBC packet is created by an IBC application on the first context.
+    pub fn timeout_packet_from_a(&mut self, packet: Packet, signer: Signer) {
+        let conn_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_a,
+                &packet.chan_id_on_a,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let conn_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_b,
+                &packet.chan_id_on_b,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<A, B>::timeout_packet_from_a(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            packet,
+            client_id_on_a,
+            client_id_on_b,
+            signer,
+        )
+    }
+
+    /// Timeouts a packet from the first context on the second context by closing the
+    /// corresponding channel is closed and then sending a timeout packet on the first context.
+    ///
+    /// The IBC packet is created by an IBC application on the first context.
+    pub fn timeout_packet_from_a_on_channel_close(&mut self, packet: Packet, signer: Signer) {
+        let conn_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_a,
+                &packet.chan_id_on_a,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let conn_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .channel_end(&ChannelEndPath::new(
+                &packet.port_id_on_b,
+                &packet.chan_id_on_b,
+            ))
+            .expect("connection exists")
+            .connection_hops()[0]
+            .clone();
+
+        let client_id_on_a = self
+            .ctx_a
+            .ibc_store()
+            .connection_end(&conn_id_on_a)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        let client_id_on_b = self
+            .ctx_b
+            .ibc_store()
+            .connection_end(&conn_id_on_b)
+            .expect("connection exists")
+            .client_id()
+            .clone();
+
+        TypedRelayerOps::<A, B>::timeout_packet_from_a_on_channel_close(
+            &mut self.ctx_a,
+            &mut self.ctx_b,
+            packet,
+            client_id_on_a,
+            client_id_on_b,
+            signer,
+        )
+    }
+
+    /// Submit a
+    /// [`DummyTransferModule`](crate::testapp::ibc::applications::transfer::types::DummyTransferModule)
+    /// packet on the first context.
+    ///
+    /// Requires `serde` feature because of [`ibc::apps::transfer::handler::send_transfer`].
+    #[cfg(feature = "serde")]
+    pub fn send_dummy_transfer_packet_on_a(
+        &mut self,
+        chan_id_on_a: ChannelId,
+        signer: Signer,
+    ) -> Packet {
+        use ibc::apps::transfer::handler::send_transfer;
+        use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
+        use ibc::apps::transfer::types::packet::PacketData;
+        use ibc::core::handler::types::events::IbcEvent;
+        use ibc::primitives::Timestamp;
+
+        use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
+
+        // generate packet for DummyTransferModule
+        let packet_data = PacketData {
+            token: "1000uibc".parse().expect("valid prefixed coin"),
+            sender: signer.clone(),
+            receiver: signer.clone(),
+            memo: "sample memo".into(),
+        };
+
+        // packet with ibc metadata
+        // either height timeout or timestamp timeout must be set
+        let msg = MsgTransfer {
+            port_id_on_a: PortId::transfer(),
+            chan_id_on_a: chan_id_on_a.clone(),
+            packet_data,
+            // setting timeout height to 10 blocks from B's current height.
+            timeout_height_on_b: self.get_ctx_b().latest_height().add(10).into(),
+            // not setting timeout timestamp.
+            timeout_timestamp_on_b: Timestamp::none(),
+        };
+
+        // module creates the send_packet
+        send_transfer(
+            self.get_ctx_a_mut().ibc_store_mut(),
+            &mut DummyTransferModule,
+            msg,
+        )
+        .expect("successfully created send_packet");
+
+        // send_packet wasn't committed, hence produce a block
+        self.get_ctx_a_mut().advance_block_height();
+
+        // retrieve the send_packet event
+        let Some(IbcEvent::SendPacket(send_packet_event)) = self
+            .get_ctx_a()
+            .ibc_store()
+            .events
+            .lock()
+            .iter()
+            .rev()
+            .nth(2)
+            .cloned()
+        else {
+            panic!("unexpected event")
+        };
+
+        // create the IBC packet type
+        Packet {
+            port_id_on_a: send_packet_event.port_id_on_a().clone(),
+            chan_id_on_a: send_packet_event.chan_id_on_a().clone(),
+            seq_on_a: *send_packet_event.seq_on_a(),
+            data: send_packet_event.packet_data().to_vec(),
+            timeout_height_on_b: *send_packet_event.timeout_height_on_b(),
+            timeout_timestamp_on_b: *send_packet_event.timeout_timestamp_on_b(),
+            port_id_on_b: send_packet_event.port_id_on_b().clone(),
+            chan_id_on_b: send_packet_event.chan_id_on_b().clone(),
+        }
+    }
 }
diff --git a/ibc-testkit/src/relayer/integration.rs b/ibc-testkit/src/relayer/integration.rs
index 85df3cd9c..145ed5004 100644
--- a/ibc-testkit/src/relayer/integration.rs
+++ b/ibc-testkit/src/relayer/integration.rs
@@ -1,25 +1,18 @@
-use core::str::FromStr;
-
-use ibc::apps::transfer::handler::send_transfer;
-use ibc::apps::transfer::types::msgs::transfer::MsgTransfer;
-use ibc::apps::transfer::types::packet::PacketData;
-use ibc::apps::transfer::types::PrefixedCoin;
-use ibc::core::channel::types::packet::Packet;
 use ibc::core::client::context::client_state::ClientStateValidation;
-use ibc::core::handler::types::events::IbcEvent;
 use ibc::core::host::types::identifiers::{ChannelId, ConnectionId, PortId};
-use ibc::primitives::Timestamp;
 
 use crate::context::TestContext;
 use crate::fixtures::core::signer::dummy_account_id;
 use crate::hosts::{HostClientState, TestHost};
 use crate::relayer::context::RelayerContext;
-use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
 use crate::testapp::ibc::core::types::DefaultIbcStore;
 
-/// Integration test for IBC implementation.
-/// This test creates clients, connections, channels, and sends packets between two [`TestHost`]s.
-/// This uses [`DummyTransferModule`] to simulate the transfer of tokens between two contexts.
+/// Integration test for IBC implementation. This test creates clients,
+/// connections, channels between two [`TestHost`]s.
+///
+/// If `serde` feature is enabled, this also exercises packet relay between [`TestHost`]s. This uses
+/// [`DummyTransferModule`](crate::testapp::ibc::applications::transfer::types::DummyTransferModule)
+/// to simulate the transfer of tokens between two contexts.
 pub fn ibc_integration_test<A, B>()
 where
     A: TestHost,
@@ -91,67 +84,82 @@ where
     assert_eq!(chan_id_on_a, ChannelId::new(1));
     assert_eq!(chan_id_on_b, ChannelId::new(1));
 
-    // send packet from A to B
-
-    // generate packet for DummyTransferModule
-    let packet_data = PacketData {
-        token: PrefixedCoin::from_str("1000uibc").expect("valid prefixed coin"),
-        sender: signer.clone(),
-        receiver: signer.clone(),
-        memo: "sample memo".into(),
-    };
-
-    // packet with ibc metadata
-    // either height timeout or timestamp timeout must be set
-    let msg = MsgTransfer {
-        port_id_on_a: PortId::transfer(),
-        chan_id_on_a: chan_id_on_a.clone(),
-        packet_data,
-        // setting timeout height to 10 blocks from B's current height.
-        timeout_height_on_b: relayer.get_ctx_b().latest_height().add(10).into(),
-        // not setting timeout timestamp.
-        timeout_timestamp_on_b: Timestamp::none(),
-    };
-
-    // module creates the send_packet
-    send_transfer(
-        relayer.get_ctx_a_mut().ibc_store_mut(),
-        &mut DummyTransferModule,
-        msg,
-    )
-    .expect("successfully created send_packet");
-
-    // send_packet wasn't committed, hence produce a block
-    relayer.get_ctx_a_mut().advance_block_height();
-
-    // retrieve the send_packet event
-    let Some(IbcEvent::SendPacket(send_packet_event)) = relayer
-        .get_ctx_a()
-        .ibc_store()
-        .events
-        .lock()
-        .iter()
-        .rev()
-        .nth(2)
-        .cloned()
-    else {
-        panic!("unexpected event")
-    };
-
-    // create the IBC packet type
-    let packet = Packet {
-        port_id_on_a: send_packet_event.port_id_on_a().clone(),
-        chan_id_on_a: send_packet_event.chan_id_on_a().clone(),
-        seq_on_a: *send_packet_event.seq_on_a(),
-        data: send_packet_event.packet_data().to_vec(),
-        timeout_height_on_b: *send_packet_event.timeout_height_on_b(),
-        timeout_timestamp_on_b: *send_packet_event.timeout_timestamp_on_b(),
-        port_id_on_b: send_packet_event.port_id_on_b().clone(),
-        chan_id_on_b: send_packet_event.chan_id_on_b().clone(),
-    };
-
-    // continue packet relay starting from recv_packet at B
-    relayer.send_packet_on_a(packet, signer);
+    #[cfg(feature = "serde")]
+    {
+        use ibc::core::handler::types::events::IbcEvent;
+
+        {
+            // ------------------------
+            // send packet from A to B
+            // ------------------------
+
+            let packet =
+                relayer.send_dummy_transfer_packet_on_a(chan_id_on_a.clone(), signer.clone());
+
+            // continue packet relay; submitting recv_packet at B
+            relayer.submit_packet_on_b(packet, signer.clone());
+
+            // retrieve the ack_packet event
+            let Some(IbcEvent::AcknowledgePacket(_)) = relayer
+                .get_ctx_a()
+                .ibc_store()
+                .events
+                .lock()
+                .last()
+                .cloned()
+            else {
+                panic!("unexpected event")
+            };
+        }
+
+        {
+            // --------------------------
+            // timeout packet from A to B
+            // --------------------------
+
+            let packet =
+                relayer.send_dummy_transfer_packet_on_a(chan_id_on_a.clone(), signer.clone());
+
+            // timeout the packet on B; by never submitting the packet to B
+            relayer.timeout_packet_from_a(packet.clone(), signer.clone());
+
+            // retrieve the timeout_packet event
+            let Some(IbcEvent::TimeoutPacket(_)) = relayer
+                .get_ctx_a()
+                .ibc_store()
+                .events
+                .lock()
+                .last()
+                .cloned()
+            else {
+                panic!("unexpected event")
+            };
+        }
+
+        {
+            // ------------------------------------------------
+            // timeout packet from A to B; using closed channel
+            // ------------------------------------------------
+
+            let packet =
+                relayer.send_dummy_transfer_packet_on_a(chan_id_on_a.clone(), signer.clone());
+
+            // timeout the packet on B; close the corresponding channel
+            relayer.timeout_packet_from_a_on_channel_close(packet.clone(), signer.clone());
+
+            // retrieve the timeout_packet event
+            let Some(IbcEvent::TimeoutPacket(_)) = relayer
+                .get_ctx_a()
+                .ibc_store()
+                .events
+                .lock()
+                .last()
+                .cloned()
+            else {
+                panic!("unexpected event")
+            };
+        }
+    }
 }
 
 #[cfg(test)]
diff --git a/ibc-testkit/src/relayer/mod.rs b/ibc-testkit/src/relayer/mod.rs
index 5c70430ef..961de7885 100644
--- a/ibc-testkit/src/relayer/mod.rs
+++ b/ibc-testkit/src/relayer/mod.rs
@@ -1,7 +1,4 @@
 pub mod context;
 pub mod error;
-pub mod utils;
-
-// `ibc::apps::transfer::handler::send_transfer` requires `serde`
-#[cfg(feature = "serde")]
 pub mod integration;
+pub mod utils;
diff --git a/ibc-testkit/src/relayer/utils.rs b/ibc-testkit/src/relayer/utils.rs
index 9d4c96bd6..7987f9ca3 100644
--- a/ibc-testkit/src/relayer/utils.rs
+++ b/ibc-testkit/src/relayer/utils.rs
@@ -10,6 +10,7 @@ use ibc::core::channel::types::msgs::{
     MsgTimeoutOnClose, PacketMsg,
 };
 use ibc::core::channel::types::packet::Packet;
+use ibc::core::channel::types::timeout::TimeoutHeight;
 use ibc::core::channel::types::Version as ChannelVersion;
 use ibc::core::client::context::client_state::ClientStateValidation;
 use ibc::core::client::context::ClientValidationContext;
@@ -949,14 +950,14 @@ where
 
         ctx_a.deliver(msg_for_a).expect("success");
 
-        let Some(IbcEvent::ChannelClosed(_)) = ctx_a.ibc_store().events.lock().last().cloned()
+        let Some(IbcEvent::TimeoutPacket(_)) = ctx_a.ibc_store().events.lock().last().cloned()
         else {
             panic!("unexpected event")
         };
     }
 
     /// Sends a packet from an IBC application on `A` to `B` using the IBC packet relay protocol.
-    pub fn send_packet_on_a(
+    pub fn submit_packet_on_b(
         ctx_a: &mut TestContext<A>,
         ctx_b: &mut TestContext<B>,
         packet: Packet,
@@ -998,4 +999,88 @@ where
             signer.clone(),
         );
     }
+
+    /// Times out a packet from an IBC application on `A` to `B` after waiting timeout period.
+    pub fn timeout_packet_from_a(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        packet: Packet,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) {
+        // packet is passed from module
+
+        let TimeoutHeight::At(timeout_height) = packet.timeout_height_on_b else {
+            panic!("timeout height is set")
+        };
+
+        // progress `B`'s block height to the timeout height.
+        // packet is timed out at the timeout height + 1
+        while ctx_b.latest_height() <= timeout_height {
+            ctx_b.advance_block_height();
+        }
+
+        // update client on `A` with the latest header from `B`.
+        TypedRelayerOps::<A, B>::update_client_on_a_with_sync(
+            ctx_a,
+            ctx_b,
+            client_id_on_a.clone(),
+            signer.clone(),
+        );
+
+        // timeout the packet on `A`.
+        TypedRelayerOps::<A, B>::packet_timeout_on_a(ctx_a, ctx_b, packet.clone(), signer.clone());
+
+        // `A` has progressed; update client on `B` with the latest header from `A`.
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b,
+            signer.clone(),
+        );
+    }
+
+    /// Times out a packet from an IBC application on `A` to `B` after closing the channel.
+    pub fn timeout_packet_from_a_on_channel_close(
+        ctx_a: &mut TestContext<A>,
+        ctx_b: &mut TestContext<B>,
+        packet: Packet,
+        client_id_on_a: ClientId,
+        client_id_on_b: ClientId,
+        signer: Signer,
+    ) {
+        // packet is passed from module
+
+        // close the channel on `A`.
+        TypedRelayerOps::<A, B>::close_channel_on_a(
+            ctx_a,
+            ctx_b,
+            client_id_on_a.clone(),
+            packet.chan_id_on_a.clone(),
+            packet.port_id_on_a.clone(),
+            client_id_on_b.clone(),
+            packet.chan_id_on_b.clone(),
+            packet.port_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        // timeout the packet on `A`.
+        TypedRelayerOps::<A, B>::packet_timeout_on_close_on_a(
+            ctx_a,
+            ctx_b,
+            packet.clone(),
+            packet.chan_id_on_b.clone(),
+            packet.port_id_on_b.clone(),
+            signer.clone(),
+        );
+
+        // `A` has progressed; update client on `B` with the latest header from `A`.
+        TypedRelayerOps::<B, A>::update_client_on_a_with_sync(
+            ctx_b,
+            ctx_a,
+            client_id_on_b,
+            signer.clone(),
+        );
+    }
 }
diff --git a/ibc-testkit/tests/core/ics02_client/recover_client.rs b/ibc-testkit/tests/core/ics02_client/recover_client.rs
index 28f1de076..f40f15f52 100644
--- a/ibc-testkit/tests/core/ics02_client/recover_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/recover_client.rs
@@ -284,6 +284,6 @@ fn test_recover_client_with_matching_heights() {
         signer,
     };
 
-    dbg!(recover_client::validate(ctx.ibc_store(), msg))
+    recover_client::validate(ctx.ibc_store(), msg)
         .expect_err("expected client recovery validation to fail");
 }
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
index 37733b60c..8860e3227 100644
--- a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
+++ b/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
@@ -1,6 +1,5 @@
 use core::str::FromStr;
 
-use basecoin_store::impls::{GrowingStore, InMemoryStore, RevertibleStore};
 use ibc::core::client::types::Height;
 use ibc::core::commitment_types::commitment::CommitmentPrefix;
 use ibc::core::connection::types::error::ConnectionError;
@@ -20,7 +19,7 @@ use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::{Expect, Fixture};
 use ibc_testkit::hosts::MockHost;
 use ibc_testkit::testapp::ibc::core::router::MockRouter;
-use ibc_testkit::testapp::ibc::core::types::{LightClientState, MockIbcStore};
+use ibc_testkit::testapp::ibc::core::types::{DefaultIbcStore, LightClientState};
 use test_log::test;
 
 enum Ctx {
@@ -168,7 +167,7 @@ fn conn_open_ack_execute(fxt: &mut Fixture<MsgConnectionOpenAck>, expect: Expect
             let IbcEvent::OpenAckConnection(conn_open_try_event) = event else {
                 unreachable!()
             };
-            let conn_end = <MockIbcStore<RevertibleStore<GrowingStore<InMemoryStore>>> as ValidationContext>::connection_end(
+            let conn_end = <DefaultIbcStore as ValidationContext>::connection_end(
                 &fxt.ctx,
                 conn_open_try_event.conn_id_on_a(),
             )

From 2367cb9b90fbfb4f848b83d5d2a421f81f37e7bd Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Fri, 10 May 2024 12:42:51 -0500
Subject: [PATCH 172/182] docs: add readme to cw-contract crate (#1219)

* Add readme to cw-contract crate

* Add readme to cw-contract crate

* Fix broken links in adr 009

* update ibc-client-tendermint-cw README

* Improve cw-contract readme

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../ics07-tendermint/cw-contract/README.md    | 71 +++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 ibc-clients/ics07-tendermint/cw-contract/README.md

diff --git a/ibc-clients/ics07-tendermint/cw-contract/README.md b/ibc-clients/ics07-tendermint/cw-contract/README.md
new file mode 100644
index 000000000..d306e9707
--- /dev/null
+++ b/ibc-clients/ics07-tendermint/cw-contract/README.md
@@ -0,0 +1,71 @@
+# `ibc-client-tendermint-cw` crate
+
+This crate showcases how to reuse an `ibc-rs` light client as a
+[CosmWasm contract](https://github.com/cosmos/ibc/blob/main/spec/client/ics-008-wasm-client/README.md)
+utilizing the `ibc-client-cw` crate.
+
+The `ibc-client-cw` crate exposes the requisite types and traits needed to reuse
+the `ibc-rs` light clients. Notably, it offers a
+[`ClientType`](https://docs.rs/ibc-client-cw/latest/ibc_client_cw/api/trait.ClientType.html)
+trait, which requires two associated types: `ClientState` and `ConsensusState`.
+These types take any type that implement the
+[`ClientStateExecution`](https://docs.rs/ibc-core/latest/ibc_core/client/context/client_state/trait.ClientStateExecution.html)
+and
+[`ConsensusState`](https://docs.rs/ibc-core/latest/ibc_core/client/context/consensus_state/trait.ConsensusState.html)
+traits from the `ibc-core` crate.
+
+For example, to reuse the existing
+[`ibc-client-tendermint`](https://docs.rs/ibc-client-tendermint/latest/ibc_client_tendermint/):
+
+```rs
+use ibc_client_cw::api::ClientType;
+use ibc_client_tendermint::client_state::ClientState;
+use ibc_client_tendermint::consensus_state::ConsensusState;
+
+#[derive(Clone, Debug)]
+pub struct TendermintClient;
+
+impl<'a> ClientType<'a> for TendermintClient {
+    type ClientState = ClientState;
+    type ConsensusState = ConsensusState;
+}
+```
+
+Once the `ClientType` trait is implemented, the `ibc-client-cw` crate can be
+used to complete the entry points for the CosmWasm contract:
+
+```rs
+use cosmwasm_std::{entry_point, Binary, Deps, DepsMut, Env, MessageInfo, Response};
+use ibc_client_cw::context::Context;
+use ibc_client_cw::types::{ContractError, InstantiateMsg, QueryMsg, SudoMsg};
+
+pub type TendermintContext<'a> = Context<'a, TendermintClient>;
+
+#[entry_point]
+pub fn instantiate(
+    deps: DepsMut<'_>,
+    env: Env,
+    _info: MessageInfo,
+    msg: InstantiateMsg,
+) -> Result<Response, ContractError> {
+    let mut ctx = TendermintContext::new_mut(deps, env)?;
+    let data = ctx.instantiate(msg)?;
+    Ok(Response::default().set_data(data))
+}
+
+#[entry_point]
+pub fn sudo(deps: DepsMut<'_>, env: Env, msg: SudoMsg) -> Result<Response, ContractError> {
+    let mut ctx = TendermintContext::new_mut(deps, env)?;
+    let data = ctx.sudo(msg)?;
+    Ok(Response::default().set_data(data))
+}
+
+#[entry_point]
+pub fn query(deps: Deps<'_>, env: Env, msg: QueryMsg) -> Result<Binary, ContractError> {
+    let ctx = TendermintContext::new_ref(deps, env)?;
+    ctx.query(msg)
+}
+```
+
+The above snippets compile into a fully working CosmWasm contract that implements the
+Tendermint IBC light client.

From 97165b1e0014d0bab389c4aebd71e3c10d617114 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Mon, 13 May 2024 15:45:07 -0500
Subject: [PATCH 173/182] Release v0.53.0 (#1223)

* Add 0.53 summary to changelog.md

* Revert "Add 0.53 summary to changelog.md"

This reverts commit 9618fa07bb7df6d3f8e7a80ba954f7d90bbdb674.

* Add 0.53 summary to changelog.md

* Bump ibc crate versions

* Run taplo format

* Rebuild cw-check Cargo.lock file

* use basecoin-store release

* add missing changelog

* nit on summary.md

* add the other bug

* update changelog

* fix english article

* update no-std-check cargo lockfile

* update dep graph png

* update release md

* fix indent

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .../1198-reject-packets-without-timeouts.md   |   2 +
 ...17-fix-packet-timeout-on-closed-channel.md |   0
 .../improvements/1044-introduce-host-trait.md |   0
 .../improvements/1109-revamp-ibc-testkit.md   |   3 +
 .../1203-rm-error-type-restriction.md         |   3 +
 ...12-update-ibc-proto-and-tendermint-deps.md |   0
 .changelog/v0.53.0/summary.md                 |  22 ++
 CHANGELOG.md                                  |  50 ++++
 Cargo.toml                                    |  64 ++--
 RELEASES.md                                   |  22 +-
 ci/cw-check/Cargo.lock                        | 218 ++++++--------
 ci/no-std-check/Cargo.lock                    | 282 ++++++++----------
 docs/dev-deps-graph.png                       | Bin 901189 -> 990364 bytes
 ibc-testkit/Cargo.toml                        |   2 +-
 14 files changed, 343 insertions(+), 325 deletions(-)
 create mode 100644 .changelog/v0.53.0/bug-fixes/1198-reject-packets-without-timeouts.md
 rename .changelog/{unreleased => v0.53.0}/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md (100%)
 rename .changelog/{unreleased => v0.53.0}/improvements/1044-introduce-host-trait.md (100%)
 create mode 100644 .changelog/v0.53.0/improvements/1109-revamp-ibc-testkit.md
 create mode 100644 .changelog/v0.53.0/improvements/1203-rm-error-type-restriction.md
 rename .changelog/{unreleased => v0.53.0}/improvements/1212-update-ibc-proto-and-tendermint-deps.md (100%)
 create mode 100644 .changelog/v0.53.0/summary.md

diff --git a/.changelog/v0.53.0/bug-fixes/1198-reject-packets-without-timeouts.md b/.changelog/v0.53.0/bug-fixes/1198-reject-packets-without-timeouts.md
new file mode 100644
index 000000000..969081559
--- /dev/null
+++ b/.changelog/v0.53.0/bug-fixes/1198-reject-packets-without-timeouts.md
@@ -0,0 +1,2 @@
+- [ibc-core] Reject IBC packets without height and timestamp timeout.
+  ([\#1198](https://github.com/cosmos/ibc-rs/issues/1198))
diff --git a/.changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md b/.changelog/v0.53.0/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md
similarity index 100%
rename from .changelog/unreleased/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md
rename to .changelog/v0.53.0/bug-fixes/1217-fix-packet-timeout-on-closed-channel.md
diff --git a/.changelog/unreleased/improvements/1044-introduce-host-trait.md b/.changelog/v0.53.0/improvements/1044-introduce-host-trait.md
similarity index 100%
rename from .changelog/unreleased/improvements/1044-introduce-host-trait.md
rename to .changelog/v0.53.0/improvements/1044-introduce-host-trait.md
diff --git a/.changelog/v0.53.0/improvements/1109-revamp-ibc-testkit.md b/.changelog/v0.53.0/improvements/1109-revamp-ibc-testkit.md
new file mode 100644
index 000000000..58dd859e8
--- /dev/null
+++ b/.changelog/v0.53.0/improvements/1109-revamp-ibc-testkit.md
@@ -0,0 +1,3 @@
+- [ibc-testkit] Major refactor of the `ibc-testkit` via
+  [ADR-09](https://github.com/cosmos/ibc-rs/blob/main/docs/architecture/adr-009-revamp-testkit.md).
+  ([\#1109](https://github.com/cosmos/ibc-rs/issues/1109))
diff --git a/.changelog/v0.53.0/improvements/1203-rm-error-type-restriction.md b/.changelog/v0.53.0/improvements/1203-rm-error-type-restriction.md
new file mode 100644
index 000000000..1e95230f6
--- /dev/null
+++ b/.changelog/v0.53.0/improvements/1203-rm-error-type-restriction.md
@@ -0,0 +1,3 @@
+- [ibc-core] Replace fixed `ClientError` associated type restriction with an
+  `Into<ClientError>` trait bound.
+  ([\#1203](https://github.com/cosmos/ibc-rs/issues/1203))
diff --git a/.changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md b/.changelog/v0.53.0/improvements/1212-update-ibc-proto-and-tendermint-deps.md
similarity index 100%
rename from .changelog/unreleased/improvements/1212-update-ibc-proto-and-tendermint-deps.md
rename to .changelog/v0.53.0/improvements/1212-update-ibc-proto-and-tendermint-deps.md
diff --git a/.changelog/v0.53.0/summary.md b/.changelog/v0.53.0/summary.md
new file mode 100644
index 000000000..03a7d24eb
--- /dev/null
+++ b/.changelog/v0.53.0/summary.md
@@ -0,0 +1,22 @@
+This release overhauls the `ibc-testkit` crate such that it is now able to:
+
+- simulate more realistic IBC workflows by utilizing real IBC and relayer
+  interfaces (as opposed to mocked versions)
+- validate code paths that were not easily testable beforehand, such as Merkle
+  proof generation
+- compose tests in a much more succinct and readable fashion
+
+Note that the drastic changes made to `ibc-testkit`'s structs and types are
+breaking changes.
+
+For more information and background context on the changes to `ibc-testkit` and
+the rationale behind the overhaul, please refer to [ADR 009][adr-009].
+
+This release also includes two fixes. One is to reject packets without height
+and timestamp timeout. The other is to correct the proof verification logic for
+a `PacketTimeout` due to a closed channel, which was verifying an incorrect
+field. It also bumps the minimum-supported version of `ibc-proto` to 0.44, and
+the version of `tendermint` to 0.36. Note that the minimum-supported Rust
+version was reverted back to 1.71.1.
+
+[adr-009]: https://github.com/cosmos/ibc-rs/blob/main/docs/architecture/adr-009-revamp-testkit.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 772427d3b..2d5326ac7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,55 @@
 # CHANGELOG
 
+## v0.53.0
+
+*May 13, 2024*
+
+This release overhauls the `ibc-testkit` crate such that it is now able to:
+
+- simulate more realistic IBC workflows by utilizing real IBC and relayer
+  interfaces (as opposed to mocked versions)
+- validate code paths that were not easily testable beforehand, such as Merkle
+  proof generation
+- compose tests in a much more succinct and readable fashion
+
+Note that the drastic changes made to `ibc-testkit`'s structs and types are
+breaking changes.
+
+For more information and background context on the changes to `ibc-testkit` and
+the rationale behind the overhaul, please refer to [ADR 009][adr-009].
+
+This release also includes two fixes. One is to reject packets without height
+and timestamp timeout. The other is to correct the proof verification logic for
+a `PacketTimeout` due to a closed channel, which was verifying an incorrect
+field. It also bumps the minimum-supported version of `ibc-proto` to 0.44, and
+the version of `tendermint` to 0.36. Note that the minimum-supported Rust
+version was reverted back to 1.71.1.
+
+[adr-009]: https://github.com/cosmos/ibc-rs/blob/main/docs/architecture/adr-009-revamp-testkit.md
+
+### BUG FIXES
+
+- [ibc-core] Reject IBC packets without height and timestamp timeout.
+  ([\#1198](https://github.com/cosmos/ibc-rs/issues/1198))
+- [ibc-core] Fix proof verification for `PacketTimeout` on a closed channel.
+  ([\#1217](https://github.com/cosmos/ibc-rs/issues/1217))
+
+### IMPROVEMENTS
+
+- [ibc-testkit] Replace `HostBlock` and `HostType` enums with a `Host` trait to
+  eliminate manual delegations by utilizing monomorphization.
+  ([\#1044](https://github.com/cosmos/ibc-rs/issues/1044))
+- [ibc-testkit] Major refactor of the `ibc-testkit` via
+  [ADR-09](https://github.com/cosmos/ibc-rs/blob/main/docs/architecture/adr-009-revamp-testkit.md).
+  ([\#1109](https://github.com/cosmos/ibc-rs/issues/1109))
+- [ibc-core] Replace fixed `ClientError` associated type restriction with an
+  `Into<ClientError>` trait bound.
+  ([\#1203](https://github.com/cosmos/ibc-rs/issues/1203))
+- Update `ibc-proto` to v0.44.0 and `tendermint` dependencies to v0.36.0.
+  ([\#1212](https://github.com/cosmos/ibc-rs/issues/1212))
+- Revert Rust minimum supported version to `1.71.1`.
+  ([\#1206](https://github.com/cosmos/ibc-rs/pull/1206))
+
 ## v0.52.0
 
 *April 26, 2024*
diff --git a/Cargo.toml b/Cargo.toml
index c879eca85..161996e4d 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -42,7 +42,7 @@ exclude = [
 ]
 
 [workspace.package]
-version      = "0.52.0"
+version      = "0.53.0"
 license      = "Apache-2.0"
 edition      = "2021"
 rust-version = "1.71.1"
@@ -65,43 +65,43 @@ serde_json      = { package = "serde-json-wasm", version = "1.0.1", default-feat
 subtle-encoding = { version = "0.5", default-features = false }
 
 # ibc dependencies
-ibc            = { version = "0.52.0", path = "./ibc", default-features = false }
-ibc-core       = { version = "0.52.0", path = "./ibc-core", default-features = false }
-ibc-clients    = { version = "0.52.0", path = "./ibc-clients", default-features = false }
-ibc-apps       = { version = "0.52.0", path = "./ibc-apps", default-features = false }
-ibc-primitives = { version = "0.52.0", path = "./ibc-primitives", default-features = false }
-ibc-testkit    = { version = "0.52.0", path = "./ibc-testkit", default-features = false }
+ibc            = { version = "0.53.0", path = "./ibc", default-features = false }
+ibc-core       = { version = "0.53.0", path = "./ibc-core", default-features = false }
+ibc-clients    = { version = "0.53.0", path = "./ibc-clients", default-features = false }
+ibc-apps       = { version = "0.53.0", path = "./ibc-apps", default-features = false }
+ibc-primitives = { version = "0.53.0", path = "./ibc-primitives", default-features = false }
+ibc-testkit    = { version = "0.53.0", path = "./ibc-testkit", default-features = false }
 
 ibc-derive = { version = "0.7.0", path = "./ibc-derive" }
 
-ibc-core-client     = { version = "0.52.0", path = "./ibc-core/ics02-client", default-features = false }
-ibc-core-connection = { version = "0.52.0", path = "./ibc-core/ics03-connection", default-features = false }
-ibc-core-channel    = { version = "0.52.0", path = "./ibc-core/ics04-channel", default-features = false }
-ibc-core-host       = { version = "0.52.0", path = "./ibc-core/ics24-host", default-features = false }
-ibc-core-handler    = { version = "0.52.0", path = "./ibc-core/ics25-handler", default-features = false }
-ibc-core-router     = { version = "0.52.0", path = "./ibc-core/ics26-routing", default-features = false }
-ibc-query           = { version = "0.52.0", path = "./ibc-query", default-features = false }
+ibc-core-client     = { version = "0.53.0", path = "./ibc-core/ics02-client", default-features = false }
+ibc-core-connection = { version = "0.53.0", path = "./ibc-core/ics03-connection", default-features = false }
+ibc-core-channel    = { version = "0.53.0", path = "./ibc-core/ics04-channel", default-features = false }
+ibc-core-host       = { version = "0.53.0", path = "./ibc-core/ics24-host", default-features = false }
+ibc-core-handler    = { version = "0.53.0", path = "./ibc-core/ics25-handler", default-features = false }
+ibc-core-router     = { version = "0.53.0", path = "./ibc-core/ics26-routing", default-features = false }
+ibc-query           = { version = "0.53.0", path = "./ibc-query", default-features = false }
 
-ibc-client-cw            = { version = "0.52.0", path = "./ibc-clients/cw-context", default-features = false }
-ibc-client-tendermint    = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
-ibc-client-tendermint-cw = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
+ibc-client-cw            = { version = "0.53.0", path = "./ibc-clients/cw-context", default-features = false }
+ibc-client-tendermint    = { version = "0.53.0", path = "./ibc-clients/ics07-tendermint", default-features = false }
+ibc-client-tendermint-cw = { version = "0.53.0", path = "./ibc-clients/ics07-tendermint/cw-contract", default-features = false }
 
-ibc-app-transfer     = { version = "0.52.0", path = "./ibc-apps/ics20-transfer", default-features = false }
-ibc-app-nft-transfer = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
+ibc-app-transfer     = { version = "0.53.0", path = "./ibc-apps/ics20-transfer", default-features = false }
+ibc-app-nft-transfer = { version = "0.53.0", path = "./ibc-apps/ics721-nft-transfer", default-features = false }
 
-ibc-core-client-context     = { version = "0.52.0", path = "./ibc-core/ics02-client/context", default-features = false }
-ibc-core-client-types       = { version = "0.52.0", path = "./ibc-core/ics02-client/types", default-features = false }
-ibc-core-channel-types      = { version = "0.52.0", path = "./ibc-core/ics04-channel/types", default-features = false }
-ibc-core-connection-types   = { version = "0.52.0", path = "./ibc-core/ics03-connection/types", default-features = false }
-ibc-core-commitment-types   = { version = "0.52.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
-ibc-core-host-cosmos        = { version = "0.52.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
-ibc-core-host-types         = { version = "0.52.0", path = "./ibc-core/ics24-host/types", default-features = false }
-ibc-core-handler-types      = { version = "0.52.0", path = "./ibc-core/ics25-handler/types", default-features = false }
-ibc-core-router-types       = { version = "0.52.0", path = "./ibc-core/ics26-routing/types", default-features = false }
-ibc-client-tendermint-types = { version = "0.52.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
-ibc-client-wasm-types       = { version = "0.52.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
-ibc-app-transfer-types      = { version = "0.52.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
-ibc-app-nft-transfer-types  = { version = "0.52.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
+ibc-core-client-context     = { version = "0.53.0", path = "./ibc-core/ics02-client/context", default-features = false }
+ibc-core-client-types       = { version = "0.53.0", path = "./ibc-core/ics02-client/types", default-features = false }
+ibc-core-channel-types      = { version = "0.53.0", path = "./ibc-core/ics04-channel/types", default-features = false }
+ibc-core-connection-types   = { version = "0.53.0", path = "./ibc-core/ics03-connection/types", default-features = false }
+ibc-core-commitment-types   = { version = "0.53.0", path = "./ibc-core/ics23-commitment/types", default-features = false }
+ibc-core-host-cosmos        = { version = "0.53.0", path = "./ibc-core/ics24-host/cosmos", default-features = false }
+ibc-core-host-types         = { version = "0.53.0", path = "./ibc-core/ics24-host/types", default-features = false }
+ibc-core-handler-types      = { version = "0.53.0", path = "./ibc-core/ics25-handler/types", default-features = false }
+ibc-core-router-types       = { version = "0.53.0", path = "./ibc-core/ics26-routing/types", default-features = false }
+ibc-client-tendermint-types = { version = "0.53.0", path = "./ibc-clients/ics07-tendermint/types", default-features = false }
+ibc-client-wasm-types       = { version = "0.53.0", path = "./ibc-clients/ics08-wasm/types", default-features = false }
+ibc-app-transfer-types      = { version = "0.53.0", path = "./ibc-apps/ics20-transfer/types", default-features = false }
+ibc-app-nft-transfer-types  = { version = "0.53.0", path = "./ibc-apps/ics721-nft-transfer/types", default-features = false }
 
 ibc-proto = { version = "0.44.0", default-features = false }
 
diff --git a/RELEASES.md b/RELEASES.md
index 06d94af6b..17353e95b 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -25,17 +25,19 @@ Our release process is as follows:
    the root `Cargo.toml` as well, and push these changes to the release PR.
    - If you released a new version of `ibc-derive` in step 3, make sure to
         update that dependency.
-   - Verify that there is no dev-dependency among the workspace crates,
-     except `ibc-testkit`. This is important, as `cargo-release` ignores
-     dev-dependency edges. You may use `cargo-depgraph`:
-      ```sh
-      cargo depgraph --all-features --workspace-only --dev-deps | dot -Tpng > graph.png
-      ```
+   - Verify that there is no dev-dependency among the workspace crates. This is
+     important, as `cargo-release` ignores dev-dependency edges. You may use
+     `cargo-depgraph`:
+     ```sh
+     cargo depgraph --all-features --workspace-only --dev-deps | dot -Tpng > graph.png
+     ```
      The command will generate a graph similar to this:
-     ![alt test](docs/dev-deps-graph.png)
-     The blue lines indicate dev dependencies; there should only be one blue line
-     referring to the `ibc-testkit` dependency. So the above example would result
-     in an unsuccessful release.
+     ![alt test](docs/dev-deps-graph.png) The dev dependencies are colored with
+     blue arrows. Currently, there are no blue arrows, i.e. there is no dev
+     dependency among the IBC crates. It is advised to avoid any dev dependency
+     because of release order complicacy (except maybe inside `ibc-testkit`, as
+     it is the top crate that depends on `ibc` crate and no other crate depends
+     on it).
    - In order to resolve such a situation, the dev dependencies other than `ibc-testkit`
      can be manually released to crates.io first so that the subsequent crates that
      depend on them can then be released via the release process. For instructions
diff --git a/ci/cw-check/Cargo.lock b/ci/cw-check/Cargo.lock
index e8a733fce..508b87196 100644
--- a/ci/cw-check/Cargo.lock
+++ b/ci/cw-check/Cargo.lock
@@ -15,9 +15,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.82"
+version = "1.0.83"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f538837af36e6f6a9be0faa67f9a314f8119e4e4b5867c6ab40ed60360142519"
+checksum = "25bdb32cbbdce2b519a9cd7df3a678443100e265d5e25ca763b7572a5104f5f3"
 
 [[package]]
 name = "arrayref"
@@ -33,9 +33,9 @@ checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "autocfg"
-version = "1.2.0"
+version = "1.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1fdabc7756949593fe60f30ec81974b613357de856987752631dea1e3394c80"
+checksum = "0c4b4d0bd25bd0b74681c0ad21497610ce1b7c91b1022cd21c80c6fbdd9476b0"
 
 [[package]]
 name = "base16ct"
@@ -51,9 +51,9 @@ checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
 [[package]]
 name = "base64"
-version = "0.22.0"
+version = "0.22.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9475866fec1451be56a3c2400fd081ff546538961565ccb5b7142cbd22bc7a51"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
 [[package]]
 name = "base64ct"
@@ -136,9 +136,9 @@ dependencies = [
 
 [[package]]
 name = "cc"
-version = "1.0.95"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d32a725bc159af97c3e629873bb9f88fb8cf8a4867175f76dc987815ea07c83b"
+checksum = "099a5357d84c4c61eb35fc8eafa9a79a902c2f76911e5747ced4e032edd8d9b4"
 
 [[package]]
 name = "cfg-if"
@@ -160,9 +160,9 @@ checksum = "f7144d30dcf0fafbce74250a3963025d8d52177934239851c917d29f1df280c2"
 
 [[package]]
 name = "cosmwasm-crypto"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e6b4c3f9c4616d6413d4b5fc4c270a4cc32a374b9be08671e80e1a019f805d8f"
+checksum = "dd50718a2b6830ce9eb5d465de5a018a12e71729d66b70807ce97e6dd14f931d"
 dependencies = [
  "digest 0.10.7",
  "ecdsa",
@@ -174,18 +174,18 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-derive"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c586ced10c3b00e809ee664a895025a024f60d65d34fe4c09daed4a4db68a3f3"
+checksum = "242e98e7a231c122e08f300d9db3262d1007b51758a8732cd6210b3e9faa4f3a"
 dependencies = [
  "syn 1.0.109",
 ]
 
 [[package]]
 name = "cosmwasm-schema"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "8467874827d384c131955ff6f4d47d02e72a956a08eb3c0ff24f8c903a5517b4"
+checksum = "7879036156092ad1c22fe0d7316efc5a5eceec2bc3906462a2560215f2a2f929"
 dependencies = [
  "cosmwasm-schema-derive",
  "schemars",
@@ -196,9 +196,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-schema-derive"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f6db85d98ac80922aef465e564d5b21fa9cfac5058cb62df7f116c3682337393"
+checksum = "0bb57855fbfc83327f8445ae0d413b1a05ac0d68c396ab4d122b2abd7bb82cb6"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -207,9 +207,9 @@ dependencies = [
 
 [[package]]
 name = "cosmwasm-std"
-version = "1.5.4"
+version = "1.5.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "712fe58f39d55c812f7b2c84e097cdede3a39d520f89b6dc3153837e31741927"
+checksum = "78c1556156fdf892a55cced6115968b961eaaadd6f724a2c2cb7d1e168e32dd3"
 dependencies = [
  "base64 0.21.7",
  "bech32",
@@ -359,7 +359,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -546,9 +546,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.14"
+version = "0.2.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "94b22e06ecb0110981051723910cbf0b5f5e09a2062dd7663334ee79a9d1286c"
+checksum = "c4567c8db10ae91089c99af84c68c38da3ec2f087c3f82960bcdbf3656b6f4d7"
 dependencies = [
  "cfg-if",
  "libc",
@@ -598,7 +598,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -607,7 +607,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -622,14 +622,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-core"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -644,7 +644,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -658,7 +658,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -679,7 +679,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -691,7 +691,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -706,7 +706,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -724,7 +724,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -740,7 +740,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -751,7 +751,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -770,7 +770,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -784,7 +784,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -806,7 +806,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -823,7 +823,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -836,7 +836,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -849,7 +849,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -870,12 +870,12 @@ version = "0.7.0"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
 name = "ibc-primitives"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -895,7 +895,7 @@ version = "0.44.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "66080040d5a4800d52966d55b055400f86b79c34b854b935bef03c87aacda62a"
 dependencies = [
- "base64 0.22.0",
+ "base64 0.22.1",
  "bytes",
  "flex-error",
  "ics23",
@@ -1008,9 +1008,9 @@ dependencies = [
 
 [[package]]
 name = "libc"
-version = "0.2.153"
+version = "0.2.154"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd"
+checksum = "ae743338b92ff9146ce83992f766a31066a91a8c84a45e0e9f21e7cf6de6d346"
 
 [[package]]
 name = "memchr"
@@ -1026,9 +1026,9 @@ checksum = "51d515d32fb182ee37cda2ccdcb92950d6a3c2893aa280e540671c2cd0f3b1d9"
 
 [[package]]
 name = "num-traits"
-version = "0.2.18"
+version = "0.2.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "da0df0e5185db44f69b44f26786fe401b6c293d1907744beaa7fa62b2e5a517a"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
 dependencies = [
  "autocfg",
 ]
@@ -1047,9 +1047,9 @@ checksum = "c08d65885ee38876c4f86fa503fb49d7b507c2b62552df7c70b2fce627e06381"
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.9"
+version = "3.6.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "881331e34fa842a2fb61cc2db9643a8fedc615e47cfcc52597d1af0db9a7e8fe"
+checksum = "306800abfa29c7f16596b5970a588435e3d5b3149683d00c12b699cc19f895ee"
 dependencies = [
  "arrayvec",
  "byte-slice-cast",
@@ -1059,11 +1059,11 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.9"
+version = "3.6.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
+checksum = "d830939c76d294956402033aee57a6da7b438f2294eb94864c37b0569053a42c"
 dependencies = [
- "proc-macro-crate 2.0.2",
+ "proc-macro-crate",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1071,9 +1071,9 @@ dependencies = [
 
 [[package]]
 name = "paste"
-version = "1.0.14"
+version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
+checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
 
 [[package]]
 name = "pin-project-lite"
@@ -1116,29 +1116,18 @@ dependencies = [
 
 [[package]]
 name = "proc-macro-crate"
-version = "1.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
-dependencies = [
- "once_cell",
- "toml_edit 0.19.15",
-]
-
-[[package]]
-name = "proc-macro-crate"
-version = "2.0.2"
+version = "3.1.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b00f26d3400549137f92511a46ac1cd8ce37cb5598a96d382381458b992a5d24"
+checksum = "6d37c51ca738a55da99dc0c4a34860fd675453b8b36209178c2249bb13651284"
 dependencies = [
- "toml_datetime",
- "toml_edit 0.20.2",
+ "toml_edit",
 ]
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.81"
+version = "1.0.82"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d1597b0c024618f09a9c3b8655b7e430397a36d23fdafec26d6965e9eec3eba"
+checksum = "8ad3d49ab951a01fbaafe34f2ec74122942fe18a3f9814c3268f1bb72042131b"
 dependencies = [
  "unicode-ident",
 ]
@@ -1155,15 +1144,15 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.4"
+version = "0.12.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "19de2de2a00075bf566bee3bd4db014b11587e84184d3f7a791bc17f1a8e9e48"
+checksum = "9554e3ab233f0a932403704f1a1d08c30d5ccd931adfdfa1e8b5a19b52c1d55a"
 dependencies = [
  "anyhow",
  "itertools",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -1220,15 +1209,15 @@ dependencies = [
 
 [[package]]
 name = "ryu"
-version = "1.0.17"
+version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e86697c916019a8588c99b5fac3cead74ec0b4b819707a682fd4d23fa0ce1ba1"
+checksum = "f3cb5ba0dc43242ce17de99c180e96db90b235b8a9fdc9543c96d2209116bd9f"
 
 [[package]]
 name = "scale-info"
-version = "2.11.2"
+version = "2.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7c453e59a955f81fb62ee5d596b450383d699f152d350e9d23a0db2adb78e4c0"
+checksum = "eca070c12893629e2cc820a9761bedf6ce1dcddc9852984d1dc734b8bd9bd024"
 dependencies = [
  "cfg-if",
  "derive_more",
@@ -1238,11 +1227,11 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.11.2"
+version = "2.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "18cf6c6447f813ef19eb450e985bcce6705f9ce7660db221b59093d15c79c4b7"
+checksum = "2d35494501194174bda522a32605929eefc9ecf7e0a326c26db1fdd85881eb62"
 dependencies = [
- "proc-macro-crate 1.3.1",
+ "proc-macro-crate",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1250,9 +1239,9 @@ dependencies = [
 
 [[package]]
 name = "schemars"
-version = "0.8.17"
+version = "0.8.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f55c82c700538496bdc329bb4918a81f87cc8888811bd123cf325a0f2f8d309"
+checksum = "fc6e7ed6919cb46507fb01ff1654309219f62b4d603822501b0b80d42f6f21ef"
 dependencies = [
  "dyn-clone",
  "schemars_derive",
@@ -1262,14 +1251,14 @@ dependencies = [
 
 [[package]]
 name = "schemars_derive"
-version = "0.8.17"
+version = "0.8.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "83263746fe5e32097f06356968a077f96089739c927a61450efa069905eec108"
+checksum = "185f2b7aa7e02d418e453790dde16890256bbd2bcd04b7dc5348811052b53f49"
 dependencies = [
  "proc-macro2",
  "quote",
  "serde_derive_internals",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -1288,9 +1277,9 @@ dependencies = [
 
 [[package]]
 name = "serde"
-version = "1.0.199"
+version = "1.0.201"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c9f6e76df036c77cd94996771fb40db98187f096dd0b9af39c6c6e452ba966a"
+checksum = "780f1cebed1629e4753a1a38a3c72d30b97ec044f0aef68cb26650a3c5cf363c"
 dependencies = [
  "serde_derive",
 ]
@@ -1324,13 +1313,13 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.199"
+version = "1.0.201"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "11bd257a6541e141e42ca6d24ae26f7714887b47e89aa739099104c7e4d3b7fc"
+checksum = "c5e405930b9796f1c00bee880d03fc7e0bb4b9a11afc776885ffe84320da2865"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -1341,14 +1330,14 @@ checksum = "330f01ce65a3a5fe59a60c82f3c9a024b573b8a6e875bd233fe5f934e71d54e3"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
 name = "serde_json"
-version = "1.0.116"
+version = "1.0.117"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3e17db7126d17feb94eb3fad46bf1a96b034e8aacbc2e775fe81505f8b0b2813"
+checksum = "455182ea6142b14f93f4bc5320a2b31c1f266b66a4a5c858b013302a5d8cbfc3"
 dependencies = [
  "itoa",
  "ryu",
@@ -1363,7 +1352,7 @@ checksum = "6c64451ba24fc7a6a2d60fc75dd9c83c90903b19028d4eff35e88fc1e86564e9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -1454,9 +1443,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.60"
+version = "2.0.63"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "909518bc7b1c9b779f1bbf07f2929d35af9f0f37e47c6e9ef7f9dddc1e1821f3"
+checksum = "bf5be731623ca1a1fb7d8be6f261a3be6d3e2337b8a1f97be944d020c8fcb704"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -1508,29 +1497,29 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.59"
+version = "1.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f0126ad08bff79f29fc3ae6a55cc72352056dfff61e3ff8bb7129476d44b23aa"
+checksum = "579e9083ca58dd9dcf91a9923bb9054071b9ebbd800b342194c9feb0ee89fc18"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.59"
+version = "1.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d1cd413b5d558b4c5bf3680e324a6fa5014e7b7c067a51e69dbdf47eb7148b66"
+checksum = "e2470041c06ec3ac1ab38d0356a6119054dedaea53e12fbefc0de730a1c08524"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
 name = "time"
-version = "0.3.34"
+version = "0.3.36"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c8248b6521bb14bc45b4067159b9b6ad792e2d6d754d6c41fb50e29fefe38749"
+checksum = "5dfd88e563464686c916c7e46e623e520ddc6d79fa6641390f2e3fa86e83e885"
 dependencies = [
  "deranged",
  "num-conv",
@@ -1548,9 +1537,9 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.17"
+version = "0.2.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ba3a3ef41e6672a2f0f001392bb5dcd3ff0a9992d618ca761a11c3121547774"
+checksum = "3f252a68540fde3a3877aeea552b832b40ab9a69e318efd078774a01ddee1ccf"
 dependencies = [
  "num-conv",
  "time-core",
@@ -1558,26 +1547,15 @@ dependencies = [
 
 [[package]]
 name = "toml_datetime"
-version = "0.6.3"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7cda73e2f1397b1262d6dfdcef8aafae14d1de7748d66822d3bfeeb6d03e5e4b"
-
-[[package]]
-name = "toml_edit"
-version = "0.19.15"
+version = "0.6.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
-dependencies = [
- "indexmap",
- "toml_datetime",
- "winnow",
-]
+checksum = "3550f4e9685620ac18a50ed434eb3aec30db8ba93b0287467bca5826ea25baf1"
 
 [[package]]
 name = "toml_edit"
-version = "0.20.2"
+version = "0.21.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "396e4d48bbb2b7554c944bde63101b5ae446cff6ec4a24227428f15eb72ef338"
+checksum = "6a8534fd7f78b5405e860340ad6575217ce99f38d4d5c8f2442cb5ecb50090e1"
 dependencies = [
  "indexmap",
  "toml_datetime",
@@ -1646,5 +1624,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
diff --git a/ci/no-std-check/Cargo.lock b/ci/no-std-check/Cargo.lock
index 381a663b8..f16deb620 100644
--- a/ci/no-std-check/Cargo.lock
+++ b/ci/no-std-check/Cargo.lock
@@ -96,9 +96,9 @@ dependencies = [
 
 [[package]]
 name = "anyhow"
-version = "1.0.82"
+version = "1.0.83"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f538837af36e6f6a9be0faa67f9a314f8119e4e4b5867c6ab40ed60360142519"
+checksum = "25bdb32cbbdce2b519a9cd7df3a678443100e265d5e25ca763b7572a5104f5f3"
 
 [[package]]
 name = "ark-bls12-377"
@@ -249,9 +249,9 @@ checksum = "96d30a06541fbafbc7f82ed10c06164cfbd2c401138f6addd8404629c4b16711"
 
 [[package]]
 name = "autocfg"
-version = "1.2.0"
+version = "1.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f1fdabc7756949593fe60f30ec81974b613357de856987752631dea1e3394c80"
+checksum = "0c4b4d0bd25bd0b74681c0ad21497610ce1b7c91b1022cd21c80c6fbdd9476b0"
 
 [[package]]
 name = "backtrace"
@@ -288,9 +288,9 @@ checksum = "9d297deb1925b89f2ccc13d7635fa0714f12c87adce1c75356b39ca9b7178567"
 
 [[package]]
 name = "base64"
-version = "0.22.0"
+version = "0.22.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9475866fec1451be56a3c2400fd081ff546538961565ccb5b7142cbd22bc7a51"
+checksum = "72b3254f16251a8381aa12e40e3c4d2f0199f8c6508fbecb9d91f575e0fbb8c6"
 
 [[package]]
 name = "base64ct"
@@ -484,9 +484,9 @@ dependencies = [
 
 [[package]]
 name = "cc"
-version = "1.0.95"
+version = "1.0.97"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d32a725bc159af97c3e629873bb9f88fb8cf8a4867175f76dc987815ea07c83b"
+checksum = "099a5357d84c4c61eb35fc8eafa9a79a902c2f76911e5747ced4e032edd8d9b4"
 
 [[package]]
 name = "cfg-if"
@@ -622,7 +622,7 @@ checksum = "f46882e17999c6cc590af592290432be3bce0428cb0d5f8b6715e4dc7b383eb3"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -676,7 +676,7 @@ checksum = "d65d7ce8132b7c0e54497a4d9a55a1c2a0912a0d786cf894472ba818fba45762"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -719,7 +719,7 @@ checksum = "487585f4d0c6655fe74905e2504d8ad6908e4db67f744eb140876906c2f3175d"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -743,7 +743,7 @@ dependencies = [
  "proc-macro2",
  "quote",
  "regex",
- "syn 2.0.60",
+ "syn 2.0.63",
  "termcolor",
  "toml 0.8.12",
  "walkdir",
@@ -891,7 +891,7 @@ dependencies = [
  "prettier-please",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -906,9 +906,9 @@ dependencies = [
 
 [[package]]
 name = "fiat-crypto"
-version = "0.2.8"
+version = "0.2.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "38793c55593b33412e3ae40c2c9781ffaa6f438f6f8c10f24e71846fbd7ae01e"
+checksum = "28dea519a9695b9977216879a3ebfddf92f1c08c05d984f8996aecd6ecdc811d"
 
 [[package]]
 name = "fixed-hash"
@@ -1003,7 +1003,7 @@ checksum = "87750cf4b7a4c0625b1529e4c543c2182106e4dedc60a2a6455e00d212c489ac"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -1049,9 +1049,9 @@ dependencies = [
 
 [[package]]
 name = "getrandom"
-version = "0.2.14"
+version = "0.2.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "94b22e06ecb0110981051723910cbf0b5f5e09a2062dd7663334ee79a9d1286c"
+checksum = "c4567c8db10ae91089c99af84c68c38da3ec2f087c3f82960bcdbf3656b6f4d7"
 dependencies = [
  "cfg-if",
  "libc",
@@ -1197,7 +1197,7 @@ dependencies = [
 
 [[package]]
 name = "ibc"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-apps",
  "ibc-clients",
@@ -1209,7 +1209,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-app-transfer-types",
  "ibc-core",
@@ -1218,7 +1218,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-app-transfer-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1231,14 +1231,14 @@ dependencies = [
 
 [[package]]
 name = "ibc-apps"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-app-transfer",
 ]
 
 [[package]]
 name = "ibc-client-tendermint"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "ibc-client-tendermint-types",
@@ -1254,7 +1254,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-tendermint-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "displaydoc",
  "ibc-core-client-types",
@@ -1270,7 +1270,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-client-wasm-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "base64 0.21.7",
  "displaydoc",
@@ -1283,7 +1283,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-clients"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-client-tendermint",
  "ibc-client-wasm-types",
@@ -1291,7 +1291,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1306,7 +1306,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel-types",
  "ibc-core-client",
@@ -1320,7 +1320,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-channel-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1338,7 +1338,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-client-context",
  "ibc-core-client-types",
@@ -1350,7 +1350,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-context"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1365,7 +1365,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-client-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1380,7 +1380,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-commitment-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1393,7 +1393,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-client",
  "ibc-core-connection-types",
@@ -1404,7 +1404,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-connection-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1420,7 +1420,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "ibc-core-channel",
  "ibc-core-client",
@@ -1434,7 +1434,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-handler-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1453,7 +1453,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1470,7 +1470,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-cosmos"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1492,7 +1492,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-host-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1502,7 +1502,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1515,7 +1515,7 @@ dependencies = [
 
 [[package]]
 name = "ibc-core-router-types"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1533,12 +1533,12 @@ version = "0.7.0"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
 name = "ibc-primitives"
-version = "0.52.0"
+version = "0.53.0"
 dependencies = [
  "derive_more",
  "displaydoc",
@@ -1555,7 +1555,7 @@ version = "0.44.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "66080040d5a4800d52966d55b055400f86b79c34b854b935bef03c87aacda62a"
 dependencies = [
- "base64 0.22.0",
+ "base64 0.22.1",
  "borsh",
  "bytes",
  "flex-error",
@@ -1710,9 +1710,9 @@ checksum = "e2abad23fbc42b3700f2f279844dc832adb2b2eb069b2df918f455c4e18cc646"
 
 [[package]]
 name = "libc"
-version = "0.2.153"
+version = "0.2.154"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9c198f91728a82281a64e1f4f9eeb25d82cb32a5de251c6bd1b5154d63a8e7bd"
+checksum = "ae743338b92ff9146ce83992f766a31066a91a8c84a45e0e9f21e7cf6de6d346"
 
 [[package]]
 name = "libsecp256k1"
@@ -1833,7 +1833,7 @@ dependencies = [
  "sp-io",
  "sp-runtime",
  "sp-std",
- "syn 2.0.60",
+ "syn 2.0.63",
  "tendermint",
  "tendermint-light-client-verifier",
  "tendermint-proto",
@@ -1847,11 +1847,10 @@ checksum = "2bf50223579dc7cdcfb3bfcacf7069ff68243f8c363f62ffa99cf000a6b9c451"
 
 [[package]]
 name = "num-bigint"
-version = "0.4.4"
+version = "0.4.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "608e7659b5c3d7cba262d894801b9ec9d00de989e8a82bd4bef91d08da45cdc0"
+checksum = "c165a9ab64cf766f73521c0dd2cfdff64f488b8f0b3e621face3462d3db536d7"
 dependencies = [
- "autocfg",
  "num-integer",
  "num-traits",
 ]
@@ -1883,9 +1882,9 @@ dependencies = [
 
 [[package]]
 name = "num-traits"
-version = "0.2.18"
+version = "0.2.19"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "da0df0e5185db44f69b44f26786fe401b6c293d1907744beaa7fa62b2e5a517a"
+checksum = "071dfc062690e90b734c0b2273ce72ad0ffa95f0c74596bc250dcfd960262841"
 dependencies = [
  "autocfg",
 ]
@@ -1936,9 +1935,9 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec"
-version = "3.6.9"
+version = "3.6.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "881331e34fa842a2fb61cc2db9643a8fedc615e47cfcc52597d1af0db9a7e8fe"
+checksum = "306800abfa29c7f16596b5970a588435e3d5b3149683d00c12b699cc19f895ee"
 dependencies = [
  "arrayvec",
  "bitvec",
@@ -1951,11 +1950,11 @@ dependencies = [
 
 [[package]]
 name = "parity-scale-codec-derive"
-version = "3.6.9"
+version = "3.6.12"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "be30eaf4b0a9fba5336683b38de57bb86d179a35862ba6bfcf57625d006bde5b"
+checksum = "d830939c76d294956402033aee57a6da7b438f2294eb94864c37b0569053a42c"
 dependencies = [
- "proc-macro-crate 2.0.0",
+ "proc-macro-crate 3.1.0",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -1997,9 +1996,9 @@ dependencies = [
 
 [[package]]
 name = "paste"
-version = "1.0.14"
+version = "1.0.15"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "de3145af08024dea9fa9914f381a17b8fc6034dfb00f3a84013f7ff43f29ed4c"
+checksum = "57c0d7b74b563b49d38dae00a0c37d4d6de9b432382b2892f0574ddcae73fd0a"
 
 [[package]]
 name = "pbkdf2"
@@ -2063,7 +2062,7 @@ dependencies = [
  "polkavm-common",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2073,7 +2072,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8ba81f7b5faac81e528eb6158a6f3c9e0bb1008e0ffa19653bc8dea925ecb429"
 dependencies = [
  "polkavm-derive-impl",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2095,7 +2094,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "22020dfcf177fcc7bf5deaf7440af371400c67c0de14c399938d8ed4fb4645d3"
 dependencies = [
  "proc-macro2",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2120,25 +2119,6 @@ dependencies = [
  "toml 0.5.11",
 ]
 
-[[package]]
-name = "proc-macro-crate"
-version = "1.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7f4c021e1093a56626774e81216a4ce732a735e5bad4868a03f3ed65ca0c3919"
-dependencies = [
- "once_cell",
- "toml_edit 0.19.15",
-]
-
-[[package]]
-name = "proc-macro-crate"
-version = "2.0.0"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e8366a6159044a37876a2b9817124296703c586a5c92e2c53751fa06d8d43e8"
-dependencies = [
- "toml_edit 0.20.7",
-]
-
 [[package]]
 name = "proc-macro-crate"
 version = "3.1.0"
@@ -2150,9 +2130,9 @@ dependencies = [
 
 [[package]]
 name = "proc-macro2"
-version = "1.0.81"
+version = "1.0.82"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3d1597b0c024618f09a9c3b8655b7e430397a36d23fdafec26d6965e9eec3eba"
+checksum = "8ad3d49ab951a01fbaafe34f2ec74122942fe18a3f9814c3268f1bb72042131b"
 dependencies = [
  "unicode-ident",
 ]
@@ -2169,15 +2149,15 @@ dependencies = [
 
 [[package]]
 name = "prost-derive"
-version = "0.12.4"
+version = "0.12.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "19de2de2a00075bf566bee3bd4db014b11587e84184d3f7a791bc17f1a8e9e48"
+checksum = "9554e3ab233f0a932403704f1a1d08c30d5ccd931adfdfa1e8b5a19b52c1d55a"
 dependencies = [
  "anyhow",
  "itertools 0.12.1",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2251,22 +2231,22 @@ dependencies = [
 
 [[package]]
 name = "ref-cast"
-version = "1.0.22"
+version = "1.0.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c4846d4c50d1721b1a3bef8af76924eef20d5e723647333798c1b519b3a9473f"
+checksum = "ccf0a6f84d5f1d581da8b41b47ec8600871962f2a528115b542b362d4b744931"
 dependencies = [
  "ref-cast-impl",
 ]
 
 [[package]]
 name = "ref-cast-impl"
-version = "1.0.22"
+version = "1.0.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "5fddb4f8d99b0a2ebafc65a87a69a7b9875e4b1ae1f00db265d300ef7f28bccc"
+checksum = "bcc303e793d3734489387d205e9b186fac9c6cfacedd98cbb2e8a5943595f3e6"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2334,9 +2314,9 @@ dependencies = [
 
 [[package]]
 name = "rustc-demangle"
-version = "0.1.23"
+version = "0.1.24"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d626bb9dae77e28219937af045c257c28bfd3f69333c512553507f5f9798cb76"
+checksum = "719b953e2095829ee67db738b3bfa9fa368c94900df327b3f07fe6e794d2fe1f"
 
 [[package]]
 name = "rustc-hex"
@@ -2355,15 +2335,15 @@ dependencies = [
 
 [[package]]
 name = "rustversion"
-version = "1.0.15"
+version = "1.0.16"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "80af6f9131f277a45a3fba6ce8e2258037bb0477a67e610d3c1fe046ab31de47"
+checksum = "092474d1a01ea8278f69e6a358998405fae5b8b963ddaeb2b0b04a128bf1dfb0"
 
 [[package]]
 name = "ryu"
-version = "1.0.17"
+version = "1.0.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "e86697c916019a8588c99b5fac3cead74ec0b4b819707a682fd4d23fa0ce1ba1"
+checksum = "f3cb5ba0dc43242ce17de99c180e96db90b235b8a9fdc9543c96d2209116bd9f"
 
 [[package]]
 name = "same-file"
@@ -2376,9 +2356,9 @@ dependencies = [
 
 [[package]]
 name = "scale-info"
-version = "2.11.2"
+version = "2.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7c453e59a955f81fb62ee5d596b450383d699f152d350e9d23a0db2adb78e4c0"
+checksum = "eca070c12893629e2cc820a9761bedf6ce1dcddc9852984d1dc734b8bd9bd024"
 dependencies = [
  "bitvec",
  "cfg-if",
@@ -2390,11 +2370,11 @@ dependencies = [
 
 [[package]]
 name = "scale-info-derive"
-version = "2.11.2"
+version = "2.11.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "18cf6c6447f813ef19eb450e985bcce6705f9ce7660db221b59093d15c79c4b7"
+checksum = "2d35494501194174bda522a32605929eefc9ecf7e0a326c26db1fdd85881eb62"
 dependencies = [
- "proc-macro-crate 1.3.1",
+ "proc-macro-crate 3.1.0",
  "proc-macro2",
  "quote",
  "syn 1.0.109",
@@ -2402,9 +2382,9 @@ dependencies = [
 
 [[package]]
 name = "schnellru"
-version = "0.2.1"
+version = "0.2.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "772575a524feeb803e5b0fcbc6dd9f367e579488197c94c6e4023aad2305774d"
+checksum = "6b0cf7da6fc4477944d5529807234f66802fcb618fc62b9c05bedca7f9be6c43"
 dependencies = [
  "ahash 0.8.11",
  "cfg-if",
@@ -2480,15 +2460,15 @@ dependencies = [
 
 [[package]]
 name = "semver"
-version = "1.0.22"
+version = "1.0.23"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "92d43fe69e652f3df9bdc2b85b2854a0825b86e4fb76bc44d945137d053639ca"
+checksum = "61697e0a1c7e512e84a621326239844a24d8207b4669b41bc18b32ea5cbf988b"
 
 [[package]]
 name = "serde"
-version = "1.0.199"
+version = "1.0.201"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "0c9f6e76df036c77cd94996771fb40db98187f096dd0b9af39c6c6e452ba966a"
+checksum = "780f1cebed1629e4753a1a38a3c72d30b97ec044f0aef68cb26650a3c5cf363c"
 dependencies = [
  "serde_derive",
 ]
@@ -2513,20 +2493,20 @@ dependencies = [
 
 [[package]]
 name = "serde_derive"
-version = "1.0.199"
+version = "1.0.201"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "11bd257a6541e141e42ca6d24ae26f7714887b47e89aa739099104c7e4d3b7fc"
+checksum = "c5e405930b9796f1c00bee880d03fc7e0bb4b9a11afc776885ffe84320da2865"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
 name = "serde_json"
-version = "1.0.116"
+version = "1.0.117"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "3e17db7126d17feb94eb3fad46bf1a96b034e8aacbc2e775fe81505f8b0b2813"
+checksum = "455182ea6142b14f93f4bc5320a2b31c1f266b66a4a5c858b013302a5d8cbfc3"
 dependencies = [
  "itoa",
  "ryu",
@@ -2541,7 +2521,7 @@ checksum = "6c64451ba24fc7a6a2d60fc75dd9c83c90903b19028d4eff35e88fc1e86564e9"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2736,7 +2716,7 @@ checksum = "48d09fa0a5f7299fb81ee25ae3853d26200f7a348148aed6de76be905c007dbe"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -2856,7 +2836,7 @@ dependencies = [
  "proc-macro-crate 3.1.0",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -3039,9 +3019,9 @@ dependencies = [
 
 [[package]]
 name = "syn"
-version = "2.0.60"
+version = "2.0.63"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "909518bc7b1c9b779f1bbf07f2929d35af9f0f37e47c6e9ef7f9dddc1e1821f3"
+checksum = "bf5be731623ca1a1fb7d8be6f261a3be6d3e2337b8a1f97be944d020c8fcb704"
 dependencies = [
  "proc-macro2",
  "quote",
@@ -3123,22 +3103,22 @@ dependencies = [
 
 [[package]]
 name = "thiserror"
-version = "1.0.59"
+version = "1.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "f0126ad08bff79f29fc3ae6a55cc72352056dfff61e3ff8bb7129476d44b23aa"
+checksum = "579e9083ca58dd9dcf91a9923bb9054071b9ebbd800b342194c9feb0ee89fc18"
 dependencies = [
  "thiserror-impl",
 ]
 
 [[package]]
 name = "thiserror-impl"
-version = "1.0.59"
+version = "1.0.60"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "d1cd413b5d558b4c5bf3680e324a6fa5014e7b7c067a51e69dbdf47eb7148b66"
+checksum = "e2470041c06ec3ac1ab38d0356a6119054dedaea53e12fbefc0de730a1c08524"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -3153,9 +3133,9 @@ dependencies = [
 
 [[package]]
 name = "time"
-version = "0.3.34"
+version = "0.3.36"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "c8248b6521bb14bc45b4067159b9b6ad792e2d6d754d6c41fb50e29fefe38749"
+checksum = "5dfd88e563464686c916c7e46e623e520ddc6d79fa6641390f2e3fa86e83e885"
 dependencies = [
  "deranged",
  "num-conv",
@@ -3172,9 +3152,9 @@ checksum = "ef927ca75afb808a4d64dd374f00a2adf8d0fcff8e7b184af886c3c87ec4a3f3"
 
 [[package]]
 name = "time-macros"
-version = "0.2.17"
+version = "0.2.18"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7ba3a3ef41e6672a2f0f001392bb5dcd3ff0a9992d618ca761a11c3121547774"
+checksum = "3f252a68540fde3a3877aeea552b832b40ab9a69e318efd078774a01ddee1ccf"
 dependencies = [
  "num-conv",
  "time-core",
@@ -3225,28 +3205,6 @@ dependencies = [
  "serde",
 ]
 
-[[package]]
-name = "toml_edit"
-version = "0.19.15"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "1b5bb770da30e5cbfde35a2d7b9b8a2c4b8ef89548a7a6aeab5c9a576e3e7421"
-dependencies = [
- "indexmap",
- "toml_datetime",
- "winnow 0.5.40",
-]
-
-[[package]]
-name = "toml_edit"
-version = "0.20.7"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "70f427fce4d84c72b5b732388bf4a9f4531b53f74e2887e3ecb2481f68f66d81"
-dependencies = [
- "indexmap",
- "toml_datetime",
- "winnow 0.5.40",
-]
-
 [[package]]
 name = "toml_edit"
 version = "0.21.1"
@@ -3268,7 +3226,7 @@ dependencies = [
  "serde",
  "serde_spanned",
  "toml_datetime",
- "winnow 0.6.7",
+ "winnow 0.6.8",
 ]
 
 [[package]]
@@ -3290,7 +3248,7 @@ checksum = "34704c8d6ebcbc939824180af020566b01a7c01f80641264eba0999f6c2b6be7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -3492,7 +3450,7 @@ dependencies = [
  "once_cell",
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
  "wasm-bindgen-shared",
 ]
 
@@ -3514,7 +3472,7 @@ checksum = "e94f17b526d0a461a191c78ea52bbce64071ed5c04c9ffe424dcb38f74171bb7"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
  "wasm-bindgen-backend",
  "wasm-bindgen-shared",
 ]
@@ -3649,9 +3607,9 @@ dependencies = [
 
 [[package]]
 name = "winnow"
-version = "0.6.7"
+version = "0.6.8"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14b9415ee827af173ebb3f15f9083df5a122eb93572ec28741fb153356ea2578"
+checksum = "c3c52e9c97a68071b23e836c9380edae937f17b9c4667bd021973efc689f618d"
 dependencies = [
  "memchr",
 ]
@@ -3667,22 +3625,22 @@ dependencies = [
 
 [[package]]
 name = "zerocopy"
-version = "0.7.32"
+version = "0.7.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "74d4d3961e53fa4c9a25a8637fc2bfaf2595b3d3ae34875568a5cf64787716be"
+checksum = "ae87e3fcd617500e5d106f0380cf7b77f3c6092aae37191433159dda23cfb087"
 dependencies = [
  "zerocopy-derive",
 ]
 
 [[package]]
 name = "zerocopy-derive"
-version = "0.7.32"
+version = "0.7.34"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "9ce1b18ccd8e73a9321186f97e46f9f04b778851177567b1975109d26a08d2a6"
+checksum = "15e934569e47891f7d9411f1a451d947a60e000ab3bd24fbb970f000387d1b3b"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
 
 [[package]]
@@ -3702,5 +3660,5 @@ checksum = "ce36e65b0d2999d2aafac989fb249189a141aee1f53c612c1f37d72631959f69"
 dependencies = [
  "proc-macro2",
  "quote",
- "syn 2.0.60",
+ "syn 2.0.63",
 ]
diff --git a/docs/dev-deps-graph.png b/docs/dev-deps-graph.png
index 7386f9cf27fcdb5a5eefe27d37266d4c1c51af56..f5b0e05ccd6e178d4737360889e22d090e3ac04e 100644
GIT binary patch
literal 990364
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%0A8iU~po>
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
bcUE>uW)^H<UX@TF!^f!;Y6>~>M!x?KtYGoP

literal 901189
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
z%0A2B9ODmi47gTEgYHLOQQn}DTL7%<d)@^pEwkDeBk!qnYt01~x?k3m&$(e2N8T;6
zw>e|lBBz(0_Zoasg-wS@Sfp&2TWPd;E!S5pKRBeRm^Or2N6vxm!1O;7fke{o2~|?j
za8e<a66lx^4W?XbHJWK8Jf1KtN5JL|jVcyk=tA<baCFLCz9YW_nMp8i<~x0|F=rNw
z1u}CIUNgSvD`c-3z84FA>PG<&$~ncj?4K9?ZVP@(eIW+FVWIuQfu2^~SoZBzLIarV
zIwVnPXlG99T2x#-*ss?=+YcSG^6V}8?0O$lD(?7W5F++|oZ37Z?bZfs7oF|!zNkoz
zdkrZSn~>mMl1VcnBemlA%vLKLw`6HWcKWf(An-7FNit#sqH3qET|G{EbBb<WVB}6R
z3q{(Wr-J$v6cn)a&I3eefc6P90bz*8wp?L{+*3Fh%JSa?6eDO@wB9RoQ#s7sAYP|0
zz_FB>oSXhG)lLu@2MYUj|3xDM6PiQ>Ves(};M}k-R}KOg%xpOF@4s69_*(Mdc?emk
zD=rF~*WIad+3xM_mbma3$3fUcKnPY!Y{9Hy@2U+-B}2bqT_!g+02YVP2=pu8%0y3=
ztzR>;TOK-MDVw0FWpjcMDR8RGjlK?NLXGs;xW|cW%dxx`E-p>?)Dl*Dco(dMrQBVx
z(#{THnXi31mb0VS!b(hwyZb})Cktt6chCTGeMEX8>j038SS>F$vAF5$7kJX~F^{(s
z@~cLLS<3)7=+)ymBvMLHWa(*dFQK=@7V**57ei#^gK$W<E@l;oIKPLNU(rllO&tfy
zhoZAHy_6Va^Lk|dvuN3#EgSi$M1X9&V^cu?0q$Vk%_#>!vQ!NXqs!W>RrcYVLai6h
zT0dp(*YW~$AvQR*CGCgzQDw$Ft$4(JdTe5h5Xsb+R%LD&#$^|;J_&E6ebM+bWBX3O
z)(@qN6x5Q}-O=OnHSqbN;-<^08amK*$MruCpkRU%5&535uhik3V*RN0iNT`(0Gdil
zIdijr*bTrvS<H=V<ORSQme(|#W~=jYQjZDH8`wDY=ST@*1=lh=>ER!-B3Q%rUydK&
z!}`H6L%`atO|wljD+}KqqnrAJ-_OZ*zyYunG>acUzB2WTX_i-)_!I6M*dQaf%@9IA
z_eN2@=H}PJzT0Dm-)==5K~z#-7E;kHi2XktvIqfp3>l~~;$5p>A@g#-C!PhLstgZZ
zXFi3hR$KvAuH>z>!Mm~tdQ-?UAHc`Ww$`eB)Jp=vTaqf@x8p0_s;+?IjH=lI=uyC3
z5M5rV!KtsZ;ELi$99QJ(fem9WFAe%~TOBjkmR?hgPSN25Uyo1D8%JL!ifaNHXsa(5
zPgi^UDiXaIw4pYQ+Vom0O}Jr3h|o_fz_MihVp@PsLxoV{5DZv37Vyg<)c1g9OYi%5
zvbOn>C2!Xs9`8)cMv@WLzx*W>_wtvpS!Nt7yVQy^P>aP@9lZt)Nw+4Hz<BdlYLb}x
z^;<LDVmom{d=aP;bf0L57@itwN2|~v(K%4)^gW)h4Jz1L-=<@lZWcDe&VnaXEd;#?
zM<!1$mBN>y+`70J`7OoRAFXs8zZTO<O|bmSn&bY%o4m?XW`eCLe<G<Q@-M0Yfdv?0
z1jGFUH?^dTHe*2`1t^!=Z@l^PD|oZyp(y(&I~ZU=wbLw&4YI#x2GH;31BU^-E><?Q
zmYpZEU6zHQM3sfgi9Yy&l*2H~fEGplQsu<6Vz(1pt&+;gkctTEDB*Wgu|yOvgk>|N
zUGRN^d5Qd&DKPP7M>nB{_>+~_hgTU;r1e4nBF<s5f-Nj`a?O9v1RxU$si_+B-l&MA
z-XV6Z8TOWNM)97vc8Yh1j`wbPMEv$d(Ei$6e@q0AlTkZh59GuCz;Z$YP~ifZE>gBP
zD{pMsacub^8uN`)&S^7TvxO)sB1kM~L^7HdkRc<81cPLxtbu;<ElI7ic$II+W(Qj=
zn$_c@*BeaLZs3zB;0qKXT$~q!TMH2U!F(-Mw(Vvt)4vF0-zJ-xn@imeS+>LFq!7Op
z%y_<TC$qB3rZ`%U=-7pU2cCOPcyh%hWIS4I7KQ>nRu)%1oKityOxJ!XyM&n-C_&lA
z#aPRAjgsDUAhHUE6ylSOpVInkDyeu^;ESlM9r^+Zvb3G#vw@k%E^%k1{-gax)Gf4J
z_!2GZB5HF<=1egcfZbco3C?#WtjInSkY(M~Ir^abwnI%x^g{3b#-|q`4zNmzZ6dfM
zogO{^0lz0J$Psb$>a6#=zwZ}pp9sA%O8Unq@yoOa!{+I{zdL7S9l0ZdsB%Oq7p_ea
zPh2{27BC#WcySl-PyBg}irC@xLOy8e22-UoT_m1#{6_{N;h5!b!{IuoPS_K2$`94Z
zpUk68XsI<NhkCU!N1YMIS0{rv#}f}_1Pj!DiO+DTewsN$Ub}^6H)Gmab&Q~+JwKg>
zXb^cNIV*6$(uvjuZa^3tZ-$*(b98Apog<i?)aS;AS$`bF|3QQ+`@>of-)z*S)ys_2
zOf^bHPfkxgF|Jiu!G#^@YQ$AmDrFuu-B^7zI)Q#>7K-XNZQhf!04R`~%;&pcVmjh%
za_gznrV_fu`EQQ)NHn&>r4a*EDo;lH5<D(mx+ME9q&@>!(6`O6OHYt}xr{nh)aF=a
zt$Lg&)T1vlH`$0;q+=9HBSlyGsHIo^1`VWQ7m>IqxfAW?J$e3o+l31@XXge(Xegh0
z$>2Dvy+(Fy$eV#O5es$RZN)Peh7h*m`XPuF?>uSL*xm>}>4&9=!%h$pcy`ss@oG^N
zPjYSqh@(d4k5dr=?7cETPfs*&qFW;{fiPPAy+0cba=Gl5LcQlS$l3bt&Q9WCgWT+X
zlrxBAOBrP0X=Ym1eXikLdM!0I*c`e8%j%;XG~q(NFK<WDO<gpS<H+pM9q<(~fyk;j
zbM)xH`ArtA;-@{1a^@xLQ@qepnE7Zr8dH@XI(%5<+?DLl2G2lp2@dSW*np3J%EO0s
z70QK2LUhJ%VKPmYjipxnoR)nHvj<rVfl?R52Q9D;GBp{cgZ5Y|LFBL6AcBfA>y~#D
znq9UTdrUt&1Ep*o>a9h}C+i#G0*EXW*MY}&no$zH@ogu1OHoNO5k#bDmgck3h*w+n
zwGw-}|7<z+_4SYPIf|BP26KQ$tXfq<Ho8SUOQZYi**8LnH<hvYO4ANt9%aDxdYJ(z
zE`7+H7XEL=Ha#}T0u>?^My%d1k5=>pzasLQ?{4KwdEi3?T8MCb7V8W5r#X*-Dc}d4
z?_0aM=WJ4HBf&_3U5&AaD$@BU6$v^nWz5l5_^2Ev(2JiF4ZIm2xu8{h1k^H#hx$p1
zdKA)nB*+KLx_e&*$fSK1y9}xw+5BVhGP4vsTSl|Qw+C}W*I|D<p<(2tEMU(RnW+WU
znb?a^=3Bqt{Ov=gJNKQQcXOVl?!}HcIkcePGIVNSp^!ZQ0v<~U%DCWKq~E6)u|!j*
znIND=I5<9exyDsPFX+Vrig2sH{RtUG;9t_(mvnx3l%A1CZHyK}up=C_fEOAOLx9k)
zZX8b4@h<C1Z`daNz<p$y{4frvDKCr3<niXmEX5oL0A5IFFeF(W3xr7b;#s~fUo)}U
zyB^KG3;$KI_^Q#odAvw&KIWOoMP_$}mEpbneLd7A$TM!+>Rq#!%sh)wiQ-!rRfsgo
zn2;FJqf@waV#JU<x)pwe`McYj4h?x`yLibGwtk#?w6zTy12h=2$Rj8xj2aaFIhNjY
z0S<?PJ78}_5dFuthX3tx;>6-0JvBGrOKDFzj!TpcQ-E-OEOC8Dxh=b|WNr~cq;c1u
zvR91EHaiCpRJ`^CBWpE9w;#EbTL^)}7iWtzBL_*0&=q+cZZvZP0fS|nS^$VcA8Wv;
zG--KdX@%(9sPhMCZ_n4|VI?8dXtzeOf$<RY=Ll-zn1K-{UG$FR#@Bb1Hzf}fas*Qe
z^n0>|&p3)RH`{+IC6AbFQu?uL=x)?6hmnYUE*pQY!98XR%nyI+MJXCqaQQA55;c4!
z_Ld^;vpcke(L6Q2Vg7x~%LDqFS>(w4H58Sec4$H;kB(5CXc3U&kD%a~cu3zBZURk=
z%gmF%K=vK3wR_OhJEZOlgm4QOGqr1crVUhxgcGce#cmd~T~^b>A<07l_=~d}>7CyW
zI5pn@zL5X>Xhyizb}%PlRdH(4ivF0ShBdp`!+?+^*lGH`r*wu{k?p#IU$8Iz*qp{X
zN8%SoigH@cJEA$Rl-N8#A<TYpA|Qkr2^H#ffSuD5{C(IjLEOfw$}(pLW>ZuRqDB+O
zo(JsvTZo>UQ_V{u-LMqeEJ&|Bngb>{86ZZB%7q8YWQiU9t#kP;$ngavEt&rUH%qZo
zq@o9$-XJxlOPcb2;CG%7rPoo)-0|iM+QG|+nWh*Oh>0W0#5m^T<c8IfP&Xrlc>Zry
zA|t`b^(LA>o;ptk(If=kzb}P3V|y3uYq0JR6%VQ_E|Cf{j;PY$bZXpI^iaO*uU5~c
zWb&k;0Se5xF^|Sbo(ndm@%(w_jWWNH78U_5pZt1&8*{CSd|u4W=|hV9KY~+))Wqgv
zk#g)M0ra_Ewu}4J)(0nVxzx1h?u*<t%|hwRv{l{u^+zB$<6(L7>|rm7;3D?H$;;(i
z%yL&9GmAa*$FMMmo>Xi(sb6y$MpvO~7leu&+#2&^N=GqF06l?g^DXkyOkD3+;N9Kq
z*El%fpd{tw^8+Zi1PZ-;c@Gta{$e6EV^H44_M2BUrP2g_Se<iC-fLrR<(|2*A&wLO
zL$rATtS?m)v55Gk(A7Z9ILYibmCdTnR$LSQ{CSvR6%C$7^Ru35_y4B_XznJh5w#5Z
zcUK1PkWp19I!M`$WQdaQ*;}ishXimAxpsbc-?H-DrXgG&H;iAvV{N_^KO5Z2VBIcC
zW4`j`!jqL)O#wUD2m0jkYjI+%mG!eTGct_%cCsxNT^v%cX0Wee)`L!S3q+YG*Nl9^
z`pxDX;ql2Kj$WKa6h73)4KaK`e0^n8FrQu2ROAm&5e`0h;Iq{Ghd~jPduxV|ave?=
zlMtjpM`0dSwuug00=;0DNJlR^*J#%%>G<Ockwv5&Of4F@xJU3l@eM=rCHshUwNH+r
zm$m9$%S$qtq<px^+B@W0KZ<kC3qg9kxrQT_JRWS_Aw7y9Q;d+PLV;uc32MCuEn;%|
z6iqX=og5Z%(P8o50%gN5HAC4lB_0$)J#oA#XvA57Uskno<JYH){?<(NuUqp$KXLsq
zr^?vfFV@s`J$NvyRjZc}8u50=m%M<&<X*`PPnyNG$G}l=;-dWGwbn;37S_e$=}hkG
zEByAbBqSBL$6F+Ua)lx|!ET_pCkbP7`irk1iu{Y8;e$XMh5e_f&6i#(HPv<Z?y1(U
zPhjqtXWYtL+?-zh-2%HdS^s5jo}3iE>*@aLIUOyr<^^GAPPc#*Ym{y~o&3qGVY+06
zgCTbmw9Y;-y@+BMzDiHq{X8|RO!SksT@x3^;rop1anY>v`M^<}RB_d!zpCw;nkSmd
z#%O>|(b1tw6!x&x*}1AxgSTn=yBYQX2*04)vrHIOw0XYpDBx>zFyt1;ANueM_P1#i
z<y?`1JQ+$4IRCR$2T*lcrxz~tv7KQRgjl4VaNK+`i8e*LH<7hV(WRd&n@fZ<jf!GI
zAvJ!fcZhxwzp5N2euo2ooi9+|NS#2hAroi+e=ax5o@VzWlK(7|JrtG3>LY3;3PD36
zOmikbe1Iq})3M?NyLIHyi>V9ZFPQ?Q)vUW>L~AqM?J-#vMkne2p^BF%x5fT&di4l~
znFCvL<73itsy{d6zUbBO*=ddv*J?2Q_%qYbvTWW1z$A5I56wvw`n6lniH$gOjX<;m
zlx37_vNeC$h`Z}|SZ~Bpg!?K)p~Lw#L?tmp2IS)D$V@YJJSK$V>3wx&Zq-|mcpc_C
zfdvov#b5gIt;`={KwttYh*2=Ra!7Y;_r&^#l;#U_+48D3;w!Y+*LQkvNC_TZcrQ2o
z8<OoLN<dL21E(ZlWFaoBmiznEE=&QKtcOXggfTv<Rd2;H$6#0_B&gd(#)#aL`NS0!
zx#r*)`~<<TU~(GJbiSHw`BI!WWm1!QdrHXtfE!0yyh#*W{4?e!g(iiAymc^ue{ydh
zor-jdNk`5lzt2=DL?OIuQBMph(`+p-Gwy2l{&^ELJLAp2cc=GL<Yj%Yi#=RcCe){2
zM-TBn!>W0{(%bkxos!_eJQc3pLgtIX$UO-V!cE7#q`(u0PeU(>3SLw{QnnLo7Awbk
z5<)!q8V;)pkW~geJPHhvE(^Pf$%88;MVfBUv3Zn{-X{qiNMnz*^jZu2*IG^w&`e2m
zzniv}%rCH7*b5;i_=kmLL(qS@8vyC7441hag6gR?KdhYAvo`4v<61(^fBG~6dLk`V
zr@gp#(e@Aa54_DPOs1&l-aa}km9aDM4UmjToMQyf5g9JxT(%%*mj0@6r|lFYGf6zu
z7BKmjKw0Z3m;p}`3LL&<-))nL!28Asa#@_RyXDpCGiH>sUI>f|{ankyrXge&{K&-`
zT`aGeY^L)0g9;OL)LJ<=2xZqRnt54-ggUG#XGF7QOFeC${7#$`ae^f(;J%qt-1!~Q
zhZxF%cr$d)P|$0eDKGh?+c~M$-#@*<YkskEVl<GFH873%TA6<xz97D?Fx6b+1pb=A
z#cfBYOr9))P+H$aJIx~l=={V~nO;ypku=+b&)Av8q)Y+VLFOpZY-0poQdmXTK|=0V
zJz=V5q6QC~%>QokkiTpbc*87ZQxGCaV+-iAr8I;HA<{jLv}Y#?9>~2W4>`sGv0p?&
zcY{Bpp#xG`KtvaJP-&M$A`N%Vr+S4bM11DhZ8{$h3d0*yG#jM4%+Z|mJx4o$(~(S0
zkWB_K<@Lc~;}9mod@bYqK$nWAK$?YPykrKrR|-;|m~0ZEz?UNuK?H~ga1*~cA`(AR
zg$Wv~TO0S%jW(;yd2!*q_DKAU#QvNsvSZcXqAeqQ(sGgZU(vryl^78b5!-4|gL?Hk
z;VJ{t4=lQz-;y_w_$t9u4$~2rNxb=IXPSmk@o6u-<3yLP+DXN>ygT<pyd!9~Yy}Np
zeIG*49cUJD5r$i_Hus~}+1MDbU8@H_ckJw0A1q8re@1uk!3WG1%be4vm-}ojp~Rr3
z+)6mZ!NV}8i8?3}D4%*@Y7t>Vymyk7(`8==vR)y}sqXbJZtM6XXNQkpL3I?3`a(j3
zSn;IfRtgg#1T5Fv=-bcZ2o}uLya9{EjfwRh)CH=fR<Yv}(|%HL0X={$$pU#`y;~2z
zh~OhfnsNqUHf){x2x@tWU7xbz=3(&g;36HBG9HYuE@CeWR3T@ML?X*sAz9st7z@DE
z!6cU|dzsm*N;}b$JEU0Vsxw4P(x?Z-CW-(eGA6sO;6pOd1BfWgAku6dWus0xyH&)a
zKsMm@r`S~1_sRd8iie)j__vBjc2v+F>~kn8%H!In-rBVOGeMh<g28iUH_i1DvG18T
zuLGRAtj0rX+yv<-goc}Xe88Xs)0hqw#F)>UxTVe?M1(Yu7$%xM>97`3Ez*+*goQ0R
ztMqEhqa&oMxP;y#NW!As`Q}o{0Ft~k@)k^OOs@;UNHhg_Bs+h4b9Wx2bqop3hlm8P
zYf4|xZg`6+Pmw+mVidm(9FE@$C=i1Tf(;FtEVdldvX#9ilF|&Kd&|FOZQ%~-YJ2tp
zwk$_Kfz*EOq8ehRz^a0G0pi#$YGTrra|pywD0Tx?+s@hMJIX3Yz7Ch21gf$Pj*dsk
zG2%`&$+`5q(ZU#Z=u$EetwZ$R0Q1tiQvS|^(J)4N1!gO<BXDP-)QF^8fXrq_XcGWa
z`>xY8vrx%r^iYNf=~n{%I@@q#Y}jlK(H=r6DLsTt8GxG0{21J}c;%9`agV)cXXRaN
z!&yk2%KsVwjzCkZ%HI@QZl1>cfhi>OPI$7St#eJ)y6HtF1`>v}Ac0PtL90oI1Ev^3
zk2V2*5fGfqg^`#S+n!z#na7)lwr0>K^KJPj@K$LhQHkj9D#8m(I)1v`I_Se>kdxAy
zE+`38GUVp>0_+d0<%m-@EuestC;;{b{yT~mLUaf8=iZq2aMEV~RfSc_D0Z#I&Qndn
z{2G3QR~_j0>BWE34MZqn&A{(h9Y18~LIl6!wpdNP+nzFM8&roNLHsJxs1XLFhw!+0
z(+K+I4^*`H9+djn-t|xijuLT)Y(uBC$n0eJ!wMOK%xTn?))}LS{DA6O?FKZfN^6qF
z4HE4FfI{+fjjkLLK`c}3554Y&4h@k>964h{^)CnM!x&&8@9AxB|1p=AvOdo-+(DcJ
zUwwC*>m5=#j^-9T7vrf1cA7EM{$EsC+i0(gv;GQS%CmQ;p-N9bq2nErQAVs5(3xNa
zHsFdB@(;!l#SdCWl_DeKWc>;nF7e5R8-)XnBlhsF@5`b1_kV|C9o@G#ExHV7K<H8K
zw*Y#+ek7FMPnLsn^aRHak4Wi92$J?ye13^6z&~~a+b5<`amrYK0mcQQw51%0Wc_hg
zw{z~q9^9Z-1hr>1yY$PXluJWXco;j0d5s$RB$b^$bt;b}F3VL2Kcci{if!zC@4eDo
z;LXAW=m71lOaE8sgAUAJv&Nr@j6iQXJp4y`l$Jh&hpm6A`B}Gu#&Xr>Td%sIV-Cd4
zM&`P>=Asmsu=;FxxF326T$gr4L_e5~w+YFaE*OfxE9lwxi@kd#Zsy1&0fFMO?+x`3
z%M;;LOE`nCu7m9>r)0p|V}Y$?D4i~(wu@~zn=V#nc(qC#hY}?PYLHFd^wx4VApI^I
zU#`d5L2s7;$SANMV3Vu@tNEE*Bieu?MU6$#L~#(_(yRFhQE!ExGq;$QT)XKSv(JD3
z-C3mLbb`_q<O5(a$sZ4Q0w;`(5dN)kUbMcBbj3r+`r7tF0g)nh4t6)43@N?D$c0J;
z^a?AVhG3G76e1u48xzQaD=H3RqrLVWx6q6@TGO`Y5fqX26p~f+$0Xlb7>P>Uk9>M)
zm~&f7hgUz;o(OXc10}0hW~RR}=hzF$jyeI&j;?6!!@?-WLJo3QJ$RORV2+~y0PvJ7
zCL;m7kRnITR@5@==>VG=GkSFGXi?R*=hxU`NKtef>vJkH@x?>GDLn+H=CX@e2*Hda
z?z4Z3b9E+bCuN*x{}s)E3{(gkh@C6LGQR!hhQdtNsY*M2)j;Gq5G2xlX!z)or`XE2
zK$*0@obfJNK7{;w7&cx$(<L7yfvDJw`tL|1HG`9ca&eqwQ;r)HPQuftn#2VOB(a4l
zXKvS28;azgXTc{H=uQ;MY2~fSblUv#s;?toU?I%~q?yZmrxeRCuHgdwchIf)g?CdG
zRZrN?o%<g#F(Bop*uLN#!x<4?k5|Mzn?{Q7LD|uj{@9$oPIb1#u1`Oy<Go2rCrWXK
zcc|~zFxM#+8!ba6s?Ywg{`7dA(W63ajZZeknUR0s+Jj0d1cg)D7kgkHuB*K@f|nq(
zU-XhVn21BI@KqT1<?*XIek;}Hky6a5l9s~?rf5E^D;&q3lvcTz9JHSJB$DSLd=9^)
zSe1aOUyu4q*+QN*%Qd<j#|<yX1P4FC`S1QcMtiYP+1zZ<S+s8O)+V?Dh?fC$q^t?T
zE`p?@|A8rkRee8`O<rd>e&+@+5L$@RdUrNaL|9P{w|p{U5?)5hL*{g=d4zVDqI${Y
z_bL(DmzTE?QKB4E3P}ihS<Xc(6X^H6Gu%2t`F6NLEO#)3O5#>Fa!Q>8AI-Z6^h@pT
zp)N`ksgb0<ym`~o+4Bkt8vaRocEPvwdoGQf^%of!BNH`(gly2E;Yf?rY0rhM!-Jyl
zISS>5rgo{ad8lk?1h9f2IRtTX^5n?|BINfw(4hMI_7a|tJa#%Ns4#;Y?Qc(IcP@4A
z0l&CbLR*-)*N>x$W#tN0(k^g5uwBvmApH$1P>6!_`iu)>8jbAfz3?hYRz~8v3f5rw
zvMqup6fRqI!obzy=12@NvUi5cZvy#4Gy$(Sv(S7dprLeiAdR%YX)kZP_>&eE;H4!S
zDJa@x1{E>zLW%=g6;ldB#5b}>)iT@E!U-Mu6r-&zy*~K~vCdOL5hTGCQHg%cTXY;0
z>02n3ZJhd;gd&QScS;2>`4xf7N3zENi5J~i;VP1HBt;;Paa24)7*dSsY46D20$CwO
zft;{4X$4^Y`ZNB8ewZNpV5esj&GUJcI8EH)DTw)op`l?+o3vlJQ0H8;6%#fpjlUU6
zkv3SaGxO9cl}rCI^hsP1`EJ)t##*9!o!z!=l+WQ&-`jMm%XyYD+cXQy^CUwlUx>M!
zfXuSux=NUGL_abFZ`JO>{V|X~j20vlNNDP|0Oks{M389BIjBoxB)EY%4FjBUWQl5j
zgoWznqpTC#O+4;mf%hXRfUrhRj&94~jf~96vUR9%{TnTBW0oNhN1AS>8$~dxRv|4a
z4*NA}-1x%gUmNATlK#dgzbej^T|U%77FJdd_kPJZ&u|9*ojVFwLB7fs#!jZ&`XBOL
zxWA^_ujfl?``O=UI%CE@s@dN7fWSj>TkZt21%&q?fq|I9K-T!=pJNFjgj0gtLpx3H
zW*?tKUdI{((-$<#Z(8kGtb7vLjq`;nWK~S}xYgQ428D}JgCx@fUO;dV7W(lJzyQNJ
zV#N&EWX2?^xNNf~hH>65m@pDW0nZbtISlm5{X=vfhtg3^I#w^_rrB=|;jCL52cZ<K
zi#CWt!}gzBAifN47Y2oHKD}?dmzOAE|C1KW+WT55zfXuIKhp!+r)&4_Vpsz2EFIY-
ztH6+q9(-U$mYrT0Dj<npg9k6!bOhBtr77yZkO}^mz#ycOBK^q<2@V;6Q~r0q0pdxH
z$G;bV2KwM0u$^%<$Yj}hzOL^<oJDyzq+SSLaK2a7(<e{zgMy1TNmM}5utw>{@Ue{R
z(N~WEDg%xF^5Ulw?L5U-y|C6+P_JNbBJmXOADI-xdvLz8Wug?bf((I;(lfe>vF(fK
z26T|(!bplN^0F#Ku*e^PnQbr9(c<vA^9#vLlv5vyWmt=Nhz?0y$>{|%iHVN5LKb{C
zJhK7D&XiG3^gt;UX>%!yaH(*kAPPBl%r*5dgmhMYM()E_@O#R-3G_g&V7VgoS1|o*
zhN|z@@<aZ=uI~Qg;*vc6%~8u9j4y$(Cox|`Kv}2SiB~JuC{jie?jZ1mi2$vkNt>@+
zxSK=v&T+$;XO2Y~Rfqw>$vP3|(f>?Xvgl-#*6?e#=cp*-pt#!vyZw8l@KE}Zshb^;
zJc~9LZca2-q;-VHTOll@_dxq2WGbDks6u7#7?PSXm{<q}ScLKBVLE3H|E~}(6Z>IL
z&jvCpAZY_#j#is7mMlr-)yv*e;OUZ|Wuv9-1W}R_m<%TJ2Epd-{_<Xty0eq1&Cjo^
z7}XSfgImW@iLb?3Mn&Ri-yQ%h>uG8~lq*uB=;<xobOf_O#w1+QD>u>@0CGu5hgo+#
z=rv|K_0gR|fkzHqxrv#Jd=MTK6(^E2)(DmeWCQWPgXiJ$C6_rWFVKD6o##p{vrVRf
z>{3v-$jJBO)hqIRnufqBh~Amrz~=q)J{*>-D_xl1jYV-FEIm^igHJ4a3Fs|*jQQ8r
z98UT8U=}FTZMTD5iZ%;~Uv~b%%G6UJ($c0>kph{iJY1FT*-R<z3F%C+Cl0wZLZzpN
zLch_w+BiL|S}IH#e(u6^0#$~eySIk;BF0g~b*W&8<85V}fOxnC`bl^f+I?wf38u2x
zebgl~Pw0gUJI}r^U+H=ZqMm<G2>C-H@&bghttXmY@x-RFm04EJFYN()-B%puONYFC
zI`UU2kCWJsKSsju=6E}0x;X9<@tjik4j>;2gP(k~vTi@^AUYc8jGqxPDfg_$&Gze%
zqyJpwo8lcdCv;F&#i5F<b@wC0Uyhe*_pWD{gf7Hov`><4fnbCJ2S=0XJwPcz5Wt0~
z7)F2w7Twh}i#(8b#4N0`c^~yRb3`LWiljMf$m5Edchmskzf{2A7i?V-O)<vQ)XB)~
zUBV@^8B`A2pCF!W?NOI|%xMxv4C;YinMAolhSG!r;OU&-Jf2vBKwf|CkP28FW}0A3
z@0Gn2f)u2roF&6zsx191BOE~dNbDXbT`sxAgn-bLfGXT91L&<gxNgZ7O)}h?xq*T^
z<oe1e;vL{?(oxn22ZEjG&N%Ap-E1=p!xa?Wi}lA;aJ5CWK=c=w21~ntGRsKq7|J&x
zlDpm*Ga5T^>W_GaS8S@QHb}f9TP`5pnSjtp)R!Rv86QhYDLcEap5QVLA6m<%SYQZ9
zgCd{DI&Q`2Oi;5lVDCE3wBIH2DIH1r^KACn$R;MCRXCegv-i*A9Q~n~>GQ2_oH)OL
z_Hy?=*>ws*Hi?4BgKr9SAHiZYIBwhXe@p=-t5=+a2d)MB=-i%AdoN$UL}_|JtExN2
z4kB8W0gsN|La7re&#iawg5(Y^9uP7ZatLRF)KyPA;u*Cli;zYG`<KMOjyw>Qo}In6
zD(`LNw&2`$<;Cmn`^%y-HMQ+cr+bRw8V6i3A;rHaZKx6(&>{-(2-PezeY`-b=2*JJ
zS9dhcY}@uxKjAnQVX?xp<NdRQPg`0LRyn96a}Z6(gTx^tRADtEm!)<FJ&)|v^Ghbu
z3ZYD7_K4DX8>g2x@{XJ@$~DHBv_5h?#3+sX;0a{Pm$&o(Q`6-h@n_erDYW*Ot5Z?f
zbWI@+WgE?n>3LXbFEuBa2JVyfWjqb!iiD4+**||5Y!Vk)nfAsq)Y;`r2NIIR587n3
zch55dN^c8LN{9c+?CJ={jTFeVW?agqWQQbF`w;jY-FFDF;a$%40cjQoDXaQO?}{}f
zWvS%3+235ifw%|pILMs;`9>@crH<lgP??+L<~BS<3ygb)c-HW9wnay8x|B_&SU^)P
zHM|@YT0YwzI)CssiH!}GE-f7V!Z9I&Iu(>9;mYclA~$Q;&<)|YEPI3XTDy48=JM;t
zdx8pX*Q>**8n}c23>YdvJoeW<Jw`TvK<>5dYjrnc=^Ek!SlmE|t%a9aQ2McC^jCOo
z^zy|%kJ<ft)^_bk(kbWg^P>?zQ~b&0iRemZJ5OCb&L1E{xHZP!Y}hRj(cNP4(xoEj
z!xuW4q!9^qo>cK5*x#0a5Kw*guQumy9S}%p@q?D~LtiS23k$y`ZYX>HPujuYW2esv
z*te(WRN7%zG98fZ=Ez?ziofc*{Z9*U@{bDzOMmQJ^X8h<cRg%2d?<xG>+4^$%|_Cb
zRJMQ5o{r25lYtZp3Ux8I22!7AueY+u;78RgP5>(P!I%<OG1X0hl|=tbL2!zJD(P2=
z&&lkX6;B{3x^R5!7j1(<ZXE^Z*>Xp^-=o}v-Jd;;JaIj}aGziA3EIgqC$6u`-u>zl
zkP^XHB=wA7RxUAr^!EAk;#*^hJ~F+}fZu=BD{{=0Mm4xbHld<Lzh8E?r*-be#|FO+
zJt_EBvz(poXr1NFu%bTmRjzdbuSeK;a<f7_dtbtOCuUUo+05M@a>}JsjV)^lKkZmk
z(QWqZ*$V}?YaFF8M)8<z*VwPc@!P{qTD5LHnwL2e(ZLuZM)X(N28~MRE_`Fg9={)W
zr>K+YO(~|C!)};nt8-=oKV+Phm6aEXk+tESMeSxDlC_NKt3?3)=U>K9gV90n#24hk
z&<A8vH3bNI!dK@OBkr<fjBUbJUi7FevSV6g*l|eeE-SCx0qzoaYNsEcw+DRLkckpY
zGVgT&x=Yy{oED0%7`=?U7c&ohla{gz&{?0=XOA8=rnQ5l{mC)A%gs69mwKF<$Q=v=
z-F~|%fB$_i(jKFt3CzndPm-U}cKpw8KeGuE%$6<O&4u8zwRi$cu$I#`c&MNOBTY<P
zaVZKwi)O3S=@LI+JK+rnV;a?&oJ(~w=*8t}-NVCw;+9E>8-dbz47$3R>2K{R;a(Hj
zMcR)B=QwA35sfLF?hJYoLRClT?}dwgkqm<r9c2pR@3Q^#Hg^K>u=@L~!K$JCs;O%9
z(6OoH`F#6A#y{>-Q@w~T`3@eNWXk=D%KQpPPLA$?0bLMPA1CsQZzh5KYURtzCz7Ej
zcUgpv3gCvYaeWlawMJ4=-=)!0>*N7$w3E20uDHYL6*pQ%M}F-tRA5~w5xenuUdsbO
zHAyVI?09qKn(i#Oc)|ds$`-5ZYq!$<?4}iLp;*L4KL2u?`jh;Wf32SLru3K?<nO?<
zfjSKQZnz{l<>{WVwP-0c6tDT=JF=grr|$--*-81Zn?`FFns;@o;I%(KFAq6+(wuHy
zO##uBR$RCY@$qX)pW_tuP`&#Y4m*)~vnKJW{bf2Ze#-65hu^PUH+5aaRJi#b^iJIY
z2#%8g7lB$y3-v%PvkX}c;*f2;Fh)(rXutWPI~5@IE;r8d*3by;pxoOolN37v%36##
zxVh%vocHTi`t{CLZXS5z^s4M2SM?EyFU+B=OldDrg{Y~is&=GI898g#wduoGPA!{`
zbG{j}3UkFywlC>1=p@g8Vc79(w!Q~Kdl%m69vna2p6Y>t%cm4<<St(?KlCZBd=sA&
zCz7)h{FnPs+~JC1_J62)@3@}#|NlRGlVn9?loTQ}94aMBO0trf6+(lI1`!oyB%4%1
zk&KK&A<9ZxMn;HARFY9zzw6yO@89S0{rvO(oO7tx>-l^<?&Eg5-EVg&1idQ_C*vs2
z&O1Y&urRyaoYV9z7cO5`=brQ&I&|9c!j<(SYRoL3Cg{A)%&Z(k_UtwMVJA0(Kb2n^
zcNyh2j!u&~vCgq<SaU5|jNokn1=H7NV+Z%v(b-8=C}Tgg6Nbze9Y9;=um`yhY)}(6
z5`vb7+<W3CubwO#p7jbD)e!|Xc<AM+ABu|1B}xGLyo@jLL`khC*df(|I_I|Muwe%>
zpFekYN%5>KFYUo*CUx1|@ch}w_C(kE3Z;y1JI<WgPTN`1kfW>XO2_LE<-2LuoVvCC
ztv76#n`8HV`{{o+Qity*H8_9zIX64Tp6<lkt*V@zG6U54{DPg7R`)$M=T+|~>uaj?
z;IMj7rR2DOV1{v5hmIXvgDW^uNet<=U@91z1Q-Mw%-2qH$d2(v0OIu1UAbGW@`Lea
zW^Kr$$NDvWH$+wSXuD=RPM@50W9@F#zD{_;p9~wc43^u-*7k^i!x!UGz3WlKO?x&R
z8zH{mr-wEv701dx(1z#qF~nT0JLhAIq9JsrPk6X`9eqM3mrZC$%IG1Z^2$;w5lAmt
zb8}yp#Vc1@fD8P%XGfDVo<lz#G_Tvo;KQ+_+Rsw_p1STBl6GC3V4VPLl9Fd7c-)-Q
z!2j$07}^w0e!N?(V<*hKLeHIhTV6Z!lDXOFF=jK+CN3sk*gd)Gk^J?~!9(ApI#V#z
zM6SAy%_&c2HxJ&haW~9Vx^pg9+?aQPowq=IRojyX|L)ArcSRoEcWzu#ZSmKyujjw@
zv@0B*jf2R2tfsHU_q*!;Wwn-`-a%n{>5Ul-Z|j6Kn{s#^pHjwVCL}MJY7*=5c<&W}
zwd@NO2@OKc7cT$Y;n|_whgSo-npZr#^7a0CL{x+}O7TOw3m;;W-Zv^Eb3;(-!P=WO
z@b2V^4jo>U-|Rc{ilV|tvaNqk<um6e{`q_71mqm)r>F{t)Dg>$<X@@g&~M#I%e{a;
zyFpphS76Y!7h2Q>ytt2GYjci{Xno>OCxggZCFLI_+lLPRS+k2VJ<Y=FE$G4N&e64P
z;$3mKUybz8qAK8O$PCdoE34X*L=aMHXFaFC%R@n#kBxGFD7EHbsz5Ti3<^{7(HMKt
zzymiN2pD_$cvO$P+CN`(ctCcTr7ur)`nP>`c5@qxON4k`Bi6&w>kg*;fFiP<pk|%t
zlNr(&adhPA1VrDn;DQQ-O+$^F!ijrD%tkVhFM`rl-DXw7FTW?8_FZv`Pk+8g9%ms9
zYxt9PZkrVAvh<8*r6KZt5%_J{GOX6|H3$kVL872@@$Du9>j+FEypS~SteRjmCts~_
zgp9kFf2&P?do+2><>cCWp8m6xjdu?*yV$e$p35tCr>CSFuGY5i;gGRDB0m1)(agT~
z8DldvdZsy<^=_@y+i>AB6RYQYOot_mF5X#!mBQmAxAQC3u6>>S>2ZG9p*GHoo~#T0
zo!o(EH4dkoty`0H{Qm=2Z!=j=>5Pq(?L^aH3Xi|5mG}1xAJKFULz>NWX5V1anQ4A3
zEt2@^yr?=j0zQvzFaucbzEW9~P;G<_*^^7V5Hez7pxEOxL?m-QDgDN$G=qPjLwxth
zmT;d;@)!Plf5o-&Ha2l-C6CzS&P11j0<<e_ih_c03J_GxyCuGT8$Yj-sznu40;+C)
zp!4A0*C>Hy01}`-XXF!#NDiYR3VH>7`d0-pq*tgtmd_xXA(PZ#zrvhJkG;R&EU!(Q
zWRz^}u?UZdG<0)Amt&^3nZz}?%G3E3x}cgLdR2uUwKX{h4yQ(_i%AKG83a<bMa~HH
zKG=%^YQFBjn4cwLcLjY?w=5S|U~`bmrOI(kDs#iPayCGR>MGE@RO@{Dbczfl1uxqE
zVokR(lawi17({AF3%_8|q7U%UG75WO!lFc+&II!1*`=v&UNWZs=NFIdlk#Q<*D3Bg
zEk4=5IfK$tt3#OlOnFgzGyc|tk^VQQ&FkNxMWq9fLyKJTl~dqnKl}C%!~qW?`0Vo+
zB@Lo~_tp={xs|ZGG0qVVaV=$*k@t{{g#gx_tzb}j+IB2Om&#q{*4wn%EG#G+?sW2x
zurKdJ^6Hs!zE4#*s`*?oN7zn_#EB86PIOn)5CJ+5y8@x1wM*iMu068%bn@K(BLBhR
zTy{%>zuto{yMSHo_mjJq43yD8)SGO0Xh|)zSy~?ayU3i_v;`Eez3VF4OS-*w?R}Qw
z=}38Gn<`XUd^>YYgu4m`K=Q{p!JmRiF1!r7)1BO!+yC0A#h~ZRm5W8Ch>X7EUY){O
zy(9Ahs8+--H#fOON8S3=pLz3ii;<U@P+I)$9>teM*|_wh>n^sb8>1x&A2D__Yd+yb
zaw#TIY*{BZS>#cG!d~X4P^Zu1vEf|)?$zt6yL0;sJt$iefGgp8Zt)pqkt*nIy6Vn%
zEWFla0lFCA9~rssVpjX0@DnFw(+kQw87v|V;G4PZaLo-4iOiP+L>xy-<&ykf8|ezN
zZDrsWnboKm{(EIY^;TdLadVfa4x>;$JV6bD6_=~1k31Nx5-@S^2o@l+lQ+9Pm`&J$
zn~3}vkeK{R<F}mdTv|}KgJzVp%Es@B`htth$@|!D;?8A+1xl9N5b-K2lq%ybLuz7?
zq%%)hdN?>1?<>0B(eAd4CdPYIH*LLprH)?2nKSkD6B8EO1^-jHa#bbs2i<gZY7<k}
z9gVn9t*Ng5(>!gJ^Q%F>J97g(4qfh@llmwsKQnXGYG>zVgSO#?Kti~{jv+ko6VV+4
zRNmv7CcG@J^vwA)|1>@Qkn1}Y<`Pi_-oOX66{s~6hD|;$TW}NDL8N%7F6;j6xOdtp
z&zj~OQ<fl0*GY1M@Y%xb*_*Vr!hF#lh=<9WNr$kMY_zc~x6bViUM|b?2KDF_oqD9R
zcEa;Lb}feL3Ur2e#yd3h!_Ze%zhB&aFw*>Juc+YKgwcfi+IiRioK&v8`5^Mb*Bft7
zDd>6ByG0Wyix{i$J99C4Kb=yD>R1GI)Xl2oj{-)J;45V+8{|DA@o4+*jXh|1?57PK
zK6vX5yPl1`v^gYyU1}I5SigQfTC@3=c19$eS@-^qcMDgo)>Q+M&&eEv7#)yW`ZH#q
zZoYTP<POanijEmQ|JT>CZG@=fp|E{(2lzS%uzcsAX7_*giW(-aas^+$IR9gYRWp#|
z&y-m=t3qMIFx14KSL|g4v-b5JpXl9vMblQTOlZpVgYV{DWr@yQdd<I{kGaV+UB0^!
zhegoS_f4RUU&i*&V53YgC&NCJ@A6B4WUimra{;gmpolyKs>;&K!(s$L9<cK5NXEiG
z09m*N2M5a_ZF%`xq>+grE)p*|)&&8^gJk}T-hDIk3y20{*K`lKJ(pF?@3{s-&=IBo
zWb|9$RSX-1h+L%11p$V#?@|r11j*q;<!c0DBB`Z!_n|S1Pt{p6Zqt%42)@K-96%|F
z|CxD1rBwpd-h6(SOc>+5lKMQh;$=~Mjp1($Bg=KWs-o#v1I1gt`sdc%ujD+>7vdHN
z_l}(G$<R5JLMfxp)%+gTt=s#<!C56ab?P-7bTB%8SLlVDOQ1<Mx|gk;Q$u3U9{KRh
zdFj&NnjHXXvWJ(N>m6~7r&=A-IDZ4d2u+0vlFP$yOl~C{EkTSR5_sxiLbCqxY4Nh9
z7Dh%6QC!$JYo0H1&hzu{HHCOJL|%vH7_)~JSMP=V-GV`%*36~RBrCP-HKn;P9`~L&
zJJ{3MEMV~K`<4l_xFmtEz7@uPZ>HyQ^)Z#J$Vsln#x`+NHDpkdO#r~Z+~Za<NwIaS
z{CLp(wY4?>psTpOKzF>Orop%Sl!LF_FE#lduv@M1xiswg0JFuV61>z4H)0;mgCati
zKPPcMsw%e$<E!X$H3h<lC2_0x-hh*iHl+27?QQC(bpQ?#F9Hbi>1<vWT@7Fh^Ox`7
zyIqodd@I>DQz7Np+VW_+0~u%eGK0d6DfYLk+V@c<8H?Tlm;?AW5%D`ro@hm$=gEN~
zi_2)zIscc>`eK-cD1qStCUYii?=k`dZuuw#;*qAw|1dNwBdt)}wHZa=jm<$@U`$JU
zcl1OoBhj+%BsCkf&*)89{!@>9QZvt2+v9s#*%&lP{h7$!+H71=5HJp~i>R5z1M0v5
ze5J2^zH{qWByk89RK_TIeRvKe2R1uQmNP~aL@&-B%q0TPy0`QYhc@6a%-+VhD%+58
z>H(8V3EQ`9!@6}sz6%G#O|pNWrisI0MT(Q}-RRHHqB^05M$xHhY1ZFkC4WqCHS(C}
z`hcCU#GqvV{^b3sKYo^UdgZ)n3B)m_nnV*k7{t7Vw~%wBmI_VGw#a3T@cCXD58iUv
z{WT<(?7gMhbsOmFzR52(c3ofv?Y>OF$shAb<?@U9!T*2iYkyuUyZCzjMDwDI;7^Kx
zQZRmkdGoQwTXFP`O6tp%HKXCZ=ES>g3JIBasj>it+%TN)Wy%UN={+?BZTVdc9)_)-
zSoNzgOB;>QZ4}?sb)-q(4<F{!NB;QoycOQYGK0nYVhgV5jpK4lUxR#z)d9&gE^Lsm
zvd@)SRl|ljM+#&ZnVSAL;%Dj<%}#h+;h9w%wW>1q`=jWu8S7Om%2hjb@ZtQ<17veC
zsSti1#2yb!oI*CDR+`Tjkh3CloKRt+(x?4KUS}UOv#){TYh(OXz0_>RQKJGIG1uNl
z5PZNdv^PWIiVzI+M=3y+{7p~2^d?G<ZUY9iW@rcz26e;|*9JX|Dtke@!`*;Z%BNsR
zTP$h?Ve&g>Kb7%y-j?iWiK&K4lzDYQn7+&q2_ydpB)7`_>ptB<gN&$B#qxnwV91wb
zxl5MW!JO-^t(ZoY9&G=fEAD`_xA>0?CD&(sxZUX4WCX~WYpDBMr8`b@pR{UnNkSo=
z{21~ZQq*@Qec~(l`al~?bQDvNlR#+zSYTjdv>{pa?4Z_7kvP9#ab(nta%!svl%gW3
zMWiA!Y;+!Js@uzJQ8kO`3D#HK3&q>iB7Y#WeUur%4cQ+T9|hHakKSndr9~~?Oj;5~
zDN7edJ+<db^Z599xd+sN5<h3QjN=!}INa+U$r4_KA>?l&tuu5zGM4b)4F?!PjJS{I
z<YlF&8~!W)SvzV!I8KM=W48}?XyOMztWZ9$Z4f7H<%)n(Xk%y#7}XX4kt{9f_Rl}6
z0ELk3w@Ll7GX{8Nu--K1onI)WFmLhm^72}_!efVzj|g^=K{k0;yKg2((BZ{N0Ltks
z8>B*z!CleKi6{}A&SJzjXYI+=DXVLXtY(QKeon%W8_xz`HFr+k6j(jGwxb5r5*<@H
z52;mc(rdSg=JtI|ZX%)6XWW)B1Bsj2YG+?<?aD<#e)PDVkeNe%I$f%Sd27kBYEjm)
zQ>QVrW*z;Ny2gB-?m<S?(FHepGwE7C)>lo?Xv5={{k?1o+$sxu@PsR>39az_2XzBU
zzHarA@taP+Ykk7bdGfmW+Ah74=S>XI9zDXtt)$X{Co}UXdx|>&B_<-#l5?cM?@i+V
z=}%G?h8-My=m-nDk|~F>_y2t55gZZg{$!_ncG}JyT6+n1L@E1Jt7ycGAi?*9QpB{4
zgDek;cwUYbK&QAZao4XSQ{G&Bt$x~jC=`7oqb<c9ZWz1ggZ^3f$XO8xH>KIAQKLA!
zRSgsh`Ij!q?_z)bs5G(6B(n5oIKdQ@ayUCjhmL-9|Ne0WOE~5ey*j6z-~=qCr`k)B
z`oxT>d&PI};&Js$&F~#Fh`n~r5;8Rt$UB1I9@k^_bmHI%Qu)2oU-XmV3YI(q+f+sr
zj8S>7a<^RpdmqNTA7AG<L#q)00drK6Z{Oae+rR%ir?@NHTt=n#?N3ebGxbbTM<mgM
zalR<t@*#x!ja|w+hOhg+;L<A|yA@s?ZsYEaCTl4xX#Mlg(JRe4$9ws(3$e8fe172>
z9fUUfTPBJu9Lb&_nlH1nt(rI7?BwVeLVPa>$PB@3?2ro4G5qxDaWv&Sqn-Ef+h-Lv
z)<2YZ83D;3|KyDdV8BU+LB_f^&ptZL(Mzdq+wh;4FN0}0ty*=QQs^{^JKO1LZ;S})
z>a%9@scQHe5h1Gg?Q4!?z^7Q#JexX2y?b{<^<KTo7RD1lC-K;<k^j!g`@(SiYKGe5
zA7|~|cdWf9<9KKn#@0Cw+YtdOYl)&AZZ`xOh$gttQk-EjnMpZ~lpodUlooQf!=Tm1
z)#0UaRy(T(9^PO}T)vFOTqHqaFGDi&7$3428}V}+#A|Kw?SRLzRFET4NGIK5XEmTH
zZWfvS*U;3Trcf*!IT;t$@Uv$p)H%+c@}S^giw2DvP3FNVD=Y;O$s|@EdUFz};$=SI
zJ1(ZC6vu_~Z6Mk-YW=~Oah^T=`czJS`CIf+<EwEz8tvvuAm+6zV+?Hu2f9<<29s#<
zdb6vRcV&yxWP*T<BAjNz)DjKJAtn^2uzdDwiNQY}vrMit$<bh=Y`ja&|8R<*vlOO#
zFD(-r%EuPHy;*tqc}vKGNP4D08Xuzx-jks%!bT)npo-@G5OLFZKLqhm^ohgX&fXP}
zLVZ%9VF6<hn7l9e<|ya&w)Vy4rE~lp9{D%t&+o-rufawYl8k)jlp}h9tkycYug?ra
zI)=hiWrKds{)E(WFIw{k8*K<<KOs*Fff6&3?`tY#!bC^VglcJMYz1BqQ?Nw7fW!Ai
zl{fiS*{5pN?<cRsM+~@Odv1}QBSohvxA#|S6u_>vzP`dj2M2TC?b|2A;qS$m^izJm
z2`}oK`j`!o3HBC0=M))l_*1Prbm%GhM6S)xEh%(v-CNP2$GA<JX;WG1<!i&V@4dPG
zPg5*d)mD|Y;s9KxL^cK3CN+iWbxS({HK@hTA0B<E*lzxAcD4R(bE?0+L~8!3Cheux
zkRkhu$EgMo8)ZLBz*Sk1qe+B4m(KuaNQdTIZv_wX4+!{sRR(luz7$)PzFHr}W}1`#
zJ<-3T>J+90=@xVzCM9i+jEZu|noe=D7gTuvp3;2)&L+L08NxLE3BUAvQ+WX?N?D;0
zU?t{p*DhTqLj74`)RA+fpuI9Gr%d{u-Ylru^f-AL^{8C^a7Zv*f-+e7z_Phh9QHBx
z%a%<BoC;G<q%iM|eVFO==?A|5`gKx$j2WPl6(on7_8z4LXj1o5LSM#$%Ep<}*IPwa
z1VP9F${v2!#|0np1{^y^*WOIZ_6G=g`1<t`t7+3#4qK_Qg!&lbOPe=%CZw_db7mNG
z3J>2H#v-hV4sUN9)Nvl{{VM++**SviIEi0nzM|~U&t-*ZiTcKEOns0`N<9q@RhwRd
zlCeq9p+ngpen;MToN1Nv&$i%&QRmL(mB*HS*Q@T6Oz|7RkFWh!jr7Bc$}$r$;546H
zi|xP<N;|zWf&I>;@`}LzNNe!mpZix70$Rmjuo6lB*h`~jk^g?byl-9IJ-XmJ3YMV2
znZOGXC{VjzK|bQ(ny=`ADCL+$tv3TaA|b%)>f>zaTdY|$)vTG3=hi2715bJU9A+D>
zo_yit6$gigexawqDhp}e7|BqTV8PccUC_njUDBv<&D*0qoUiN0AYo5WOA9HQew6=?
zPuEf10Rut+vQJMuI(!n9&IxM4i9!4JegDVe|2f;bx}jKc8vJ**KkHd2*0(_ZF8jJg
zX-=DXoXSaDv6wA7Fv7JT{r{WRz9Og+SV)`^S&hKTUA#%|D>)e*Cb)~bNc4@=Q&7Zr
zsWn8{5f`?)1K^@DUCXeyqmbLxYt-`NdMWM|6aXu(jT$m^hK)^kR8aV;$c|n{ep(^P
zL4O<bGP#%;PO!Sv4KauRrv;$Y(CxaX=@sf0nFkcx<x4N4X0LdJp$N1ibkGMY!?&Md
z0WX<7u2<V{*&jxpZ*2G-&?=%FWV$}fkm+yTf?qL0BdRCn6jni}<2LdApE1rnyH&EG
zsBK#j)>8M6AfA(vFr1Nr3$#@CSnNK=^=wNSGRNbTwQ$3Uzv2axwr33SUC>WTkPFy9
z63GYkY1YdJw~4xdrW07KQLGswf)&j5q8>f2Cw8>|NvAmN0Rgc^zDyVK8Dw2!Tv&{d
z&^&SjIB4{lS?6ufssYJLu?ar&*KhQ(o^0u)b6nU@PcOFXzSa(3<g;Tk*t>Ux##Jm-
z?!cGMyy52Lyc3W0yV6^+Cn(ghjy}K~ScpUE2K(8ImPX_qOH94Uqjsu#y{_WOp@&e~
z8)1}>Q%9PQno8S9m5V^b-sy1CuhyGy>jMEjW!_XEKO%qB2Bnb~F&$t*0Asg@i#4OL
z+!M@4l;c=QiYE`CIWLQ0@cQ%Sz3<wEjp>_sP8qxQ)fT1({RO5!odWfDXm&Jt(ZuRP
z$7{3A0_@D$%h_Ck6<S+CJT~5*D=S#JH}4;eth(h-Q5TRS4n_YNlw8$gDi6b^H7Jr4
zi2yYHvbsocP!Pp#BS&^-WT=4FHAlB~{WM+BH;12&)=zi4?x=6@O*U%%2ayZ#D$;%|
zi6^@D3GK*_5|MNbB#;m++-~NDPL612P_>6l--GccIu2O~!deBH*e7$xg<amjvG+y~
zl>DmfqP`12vP0gOYXJB>1i;Ttz#%gJ4yb6}uG`-I`+I;713|3(-F5yj@z&y{$|okP
zMRiH#Y;&(TqaO^1za>cKpPs&uNd|?DWWm`c9}e^N45&7vJ?kkOBU6&aWC)&6In{M{
z<Xemqhb}@v01~To)omrD5FxLn;DvROl?N0~Z!Totgpm+8R>lJpsfMn7k9%!Hy-xeb
zo}476ocry%cZUrdoJj@~PU$C{`<6j2mch<6|A9BepMZlIN}bBhz^qUsYF+twnnDV}
zUJXKRSrP67rH+`OElpYYh>2lHOJ(N}lTBD$mAQ@bXy=1x?i971_3C$Pi~}5FiK0Md
z>?slbVOr7Omzrxb>QrttmI`8i2&z1~@5R;&pe~tj65kmnDHU+Hl>HNYa3;8y|GMDc
zcE)8Bx=980wBa7~W|D`WvX4^zw7mgtRp?$uU^Oaho-@_~SvJ77;=sX!2AniLr8iT6
z(7rN<4nT(BzKL6FU6wb>o;Pmqn*nS6{vxX@#UFyz1QIBCRR{2lENZ{nCyyFh{G$-g
zY~*Sa@z^HD$1-po<W;VY%QP#tjZye;hh$qf-<2Vn4ArPNOUE~2SQE)mN?_eICNB6y
zj_$Uz=lAbG>u<p51KsWaR(OE)Fn66b^i>zE<wb}++H;h-eS=1aQ^r#5a3PW|=crSA
zfW7pf9nj7#-9yxZvODx<A}lqx-tGFgC#`5K1kcaOL*bPK-zd9GWVD`=ai#NB5lta7
z+{CQUJJ5ZX<Pd3{zEPNol#NJ??SNR~7X)M#XSTOw%B~fk3z3@A={62@L?(<G9>WTV
zrfO5ATO1qOM3zURQmk252qG~J!4(n|if5&U?pnq-=vNTl6a?HIN@B)M>coh#*X_`8
z!iC+zri4s=l2Zf(HW#Z1nesxGH1g;&L5?Xe_&aNdxB6DH!QD#DRM8yUc>_>snS|-s
z@!(32Uq8Q06I&s`13n77?DAXXYiDofht6junrt;etz_bQq@8xZezF=3)KoSd$VNjz
znB_w{p|9@jpSF9r5Bh6~H>0cKo2kgJx|`~9H}|(Vs^Q>7z6k7<OBXaBs{uSt#_)51
zcaD?08E*+;eG@;5!S55B8X3eG07llWeH(rG{)n+&YUQjpYYd-2*J?}=fY=Qv&&0Kl
zS3Q~r2}wLKv53&eWuCbum*nm~bMC;7F#v+X1i)KH8UPcwQDPz`{2cJSnB(Pad!Eyx
z&E0dnssDo~CT8_OZ?VJsB|vhcWo<$eDA*V<?0*_?+5Ic+GiC?i0<WqY9mtdI6&!eR
zp}RKQ(r*6zbd9D)Qlr#VZ{TMSz8-~GSe)FqSyv&>ZAx;Ee>{b?Tu3xzi4uYP77C|w
zU7f4TvtycIVk0K@K%y3|oo#@dx~r)v@M=V8&aP1wvCFC<*O)aS@f+7OrY7TqV4Ki#
z1pz<nG3qU~2LvLjdG<Glk5E!jLjo^M#i>(^!_3^)Sj)9!>VomwCVrs>0rik{+A?EH
zL4wfP_<G^P>Va}%aQ%8SAUm9MJ{Ow#04tcO7YYK(>akaw!sa-ll>DJdnXcFKlQ&HH
zd$1U57UMs8TG7#vQgk>Xag_;3%IX(Pg0U0Fe2mpwNSfQ&zSQ9lu={g+@vy#oFm_|{
zEpNT^$hB<NYy+UaEjW12_S&Pvtu_@vQ~(3&yY5&dD{<8hrBB+KBl}(HTEu8`NFIk(
zsu!7{q0U7w(hKhn*{20uDRUOt*@u+9m5e$~n>zJb@%2xEe^cEQNNvU@yf9^<&aWdg
ze>koVaQt9&!@Y7}@!I;0z&2Fk`kFJ!D+lwHQraR!c6X@!c!}k~wG~|voQZJ~0;cls
zpPIcX&GtvS9kBmE^qgaX8O05b#DVA03ca#zlvcuD^_Z-=o*56wD48Rpbdz1Sp9997
z;bRh0Z?o}MJXijd^Y)<nTbDnV6-ElT=$a3|*%xf)`hCp0b$WCBPHgw{6BJnnVK^HO
z7dP*q>J%>)0zXV@Goz5Uvk*O&Qh8RD)Yj<Gkz&l+AATcU^^AEXKq7+z@_axdpor2{
zKhyE<m4SpE9R}1T{WUn8a&m-{$Tz{<#Am_9r1dc5rem=(!K>WZRas#pJu<E)jX87T
zCnk#n-|SvH5saJn>XN+VDm-#4E(;{wc(wf-zA~9DqGuLI9IJ_k2CYYv%kE<5i+4vF
zD2`5?e}S21FRo!2%or8tI07ZS2={pt^*|yz532Hd#2*S|Py5Hb<3<z(wiC4uP)TGP
zZCb*6P!M=3uV;M&#UBt#UBrzGmfdOL4S*E3i^;Gdg@)8Lu-B5y=ndx5PS(9_+R{KV
zAs|!}z4DdHh9ght?^SCYKmXF-bB}aHX1CGLGT$z11I5%BUGSUMO<KAXWw!-~7Bh1=
zq>!j6^SHjP9S-qmU|PlCltm!oBt?w;OKl&0aW^{R>{%m9*<@AOKbv-Gv4wExXY?4Y
zO`~ksdMEZuaiw7zRGp=A1J+ize3cRbk0E>^#R_82l)x3sI3S$3?YDFuL@|fQm81tF
z)L>15-dnG5NOn7Fsj{kmsWeXvk%WQr0cN&%6O|o`&{-%1s*`)<#Dah^+9YC1iyq*t
zWEoUHbpszL-@nt@V49_+EKtW`QRYvv1>i`Spg)wW#`KQFg}J&1V{W#huT_V}f;%wj
z_iKnDxt|5;GV1eYk_v`*O`x-cte0JOM~+Nz?Rm@!haW-(0j4jN0i@Rl>=GD4Mcfi5
zp1`0hvXXw}&2<l{VUeGW?38c}d67)`l&x#*wPb@#e285mV80ANym9oP6luvf5qk=7
z6)2+CFbXuRn;$G7<b_VjZQrh)lUu#DGlkSZi*m)cZrUHaRm*A}AP%x+reXfSOUcSV
z4FJ^hCvVB#dSG3lws@VT3`0?$CEmLip6HUH;S+G;;zcDQ+uy_DH4}d9TY0G+g<$^S
zlAZWE&>o6!31GPxu+S(UvQp|Rj_uU6^GH1{-t6P(!oVsfOrQ(#tp3@aGlU0S6Sfk{
zEEQ*8HSUtlvdlRPa%0|cSOUK=EpdyiFPHz^PP3tSj>#XS-cQ2*WEHyu@bp4(e>t(O
z9|{>Ilwjhs1*5S}*Mz)_E@dOqgt7&0D}*^f9E*(b>DMcWR@sCw>$;vt+4=|9xjT2T
z_5N4PWW--vH>7<+hmIZRp(J5W^ysZVQRb&;L}Y7%NC;@og<+saN>e?PB2LV-#Gqcg
z7`X%hj_Yx`@#fnKsPTENjv$iajR3;vmWsTj1;GOS%JvfHt8JOtgDGr(y8FF9-6w$z
z$ruu#Vdw~@REV3#nei)kO18$16xnP$xCocziaMKb-vTfc*Ln=x%a(VMbtOG}ep_C(
z{={ZY14aLJ;6&mvhYX|H^4p^nP$O(kSu_T-Z;)Q;g1C2R9K{Uq+#CIwwzjXkH8q-S
zWd*sNsj;GAl#XIsaAUnD28#7>Ql3iC<g8vTN4R<!*@;Z*3ULQCNMqZY;#waiwAijt
zM|L@((b&*3bEsuE7NZ#`+9CjCBW(3p9i=ragpj!5^r<NdZD_~ML}C@rhdP;vQE1M(
zaP2faBtxnR7n2@7bDkl4Ama!VO7nGqJ+WZ7c=i~(#tacdGKFEq1<Bj%rcu>W1>DKZ
z+<PXsX;bQWG#WBx0TV;zQhU<!2iTX3$;VittsPnq@wofk#EmF|vYJr0b+Pj*GE7qw
zv&Z<mwm}4QkJhDPm*4NTFAaWRu^<C%)bK(vIxhZrW$vekL7en$V0tFr_li{ME`WpZ
zCLOT$+guUr&~J+Q&6~9PHb4V1xF`O)s0=|7Lq??Q90pnuP97_Ij!4<+-bKvhlegz%
zuDKxMV(=;#mn}e1)cT(TzPBJ^NZ~}mw*`43PNL(8D0nBy*2()?-A4|=LR0K{ut}|3
zF~b^*U+|P9tWa=NN($8DgMa%~G!tI%`+}<V<PhW(y|jH4>!(TCEVv5btGeZ^N44yX
z=uCXEoHFGe>K`E@Iqid8T7Npp6UM-2jZfV)fHwp9k^D1(tH!u*(yVx`&o14oNRp6$
zz>M$9O}@e25efvcUE-`jEN-S0&4skVQ0&w#*Ot8+du;$x<$SeA+>XHd>$c*MoKC=m
zL}UC!n^7o2gAG=0-`dNZ@|XEjp$;8kehUf<KTxtr!8;XW@%o2TlDNrf7`LDb;QcFu
zdWMd$IXtOW<;i%H(f>A5KkKH^E_0D6H+FD9yeL`ZK9OY`@#g5}Xe3mc8tcr8%PekY
zjKD*-BalA1wn6!2Gp0{RAA0PRnZ1+jr00y(t6kGty+P<`SLS_W5fM*O3`mev-~Fjq
zfM)B~qD!o%+kwvT=KC$<OrC?(ibD<+G$pEZmhuk$OjMZhdH!vvD1(PM4!EqxC@Eq}
zBi<hag|f;p{_&UG+<J6ylsK>*S4<&$Ia(x|UAL;un>K5f3&<l}qf91i1imbu+Jj@E
z4`m@*ch|jZR&r2f$_cyeO}xr9)%-^E9<rUA)3J?u%*mY+#T_d5+l}p_P6vQxb?cK1
zNjaS~{qDezh;<;bt?}#p1UlLO<HF_OP$A2AjfzSM)XPC%NAK2hlG>p?d(t)b?Qb-$
z5w&Y$1#$1eRJ$qlME?#uf>+FBz6=hG*@G~kk{9r|vI7d#nM`|&S`+Nt&2*yTmgA=r
zx}<k`Vqe?5x1xGuFC7^G;v;`xTx!W0j8tYwXc#m|8LQgc&>X9n#~*c~r_Gu8SLxs#
zY|`)ni?u^|uDar&U1&8}jo5?`eJFnA;tSkE8y-I5(5*8Gx01$hDxi%8>$=T>p%{@B
zHt=J%s?!vu>gCb%o@?_ee|m@F8H8TO;(A|YA$y>V8Uyp8CHc1S2~4X@M8bT#9W0r~
zkcso_CQk79g5fxJui@(D7b=zgMQi4<-cqK~0=oRu6gcLbzs@-H<NSY{K%ANK^>^{E
zY{gx`*-|XZsXWAQ1$5+dfV!flpBK%Y>{Y6*2(G=2p#ZLJrmlU?A%zule;Jd206rG&
z#5n#AE{XW|GVlEEvu)8PMqyDHZ2g<R!Y8qJOhy_pd{7_{A5%_E3y&YRrO&|BuFSM2
zf^E%XkefRbm+K}H4!n89I)ipP<!33w=VH2YEa7)Ce3inkg?UYw-V##)gxfOG&9(a+
z@Rw;NuG76r`vwUnUXR3S3e>}=oSz5hlpue!$PejcJc&2L-6DB7`0xc~Wg~ZgXso&W
za|cK}ng;w^T2d%Tqc7z;m_*rt0S1a*piGScdEp6<k7#P~w{I#J6B3w?7QJlsWW#`9
zL*SWUL-hk6+@(}ncVN#uSxzK~5;PMn$R>JD#6fB2`uVh04dkLoO^tY*@9}qqEA~b_
z%+CQD=L<*pz*7vp?f~AUpbzJCrX!hE)?TB3qQ}2VYr?_dM2A0E(QdT1a^F6EK041Y
zo(Z7|^dg2H@qJHa5xZ!Q-UB(vfg#gI8#f5$UVOTids^)bHbpjnD}BaeFEB^P4@9Zv
zxX{)>MD4WUYD0#!qe=-I5upDW9Ux;-q@n*7C?rxBjd4|}tg09&mPDkqTwwj8Un^yd
zN$`G=j@qa9Joa{%thaMv?HY|&{>#oqzQicmSG94Y0<x9|C`mb%Qdluv@+zfiZz{k9
zgm*HJ1|}$*y5QnZjz}NMvHO-#TbY1()`&y$Jei8k0JZn?<Z2ymtimnCfM7Gct`ey8
z7uOtnQ1#Y>(22`cDF1z9A96~5gw%BuH@S?=B1-8S_cmPxdTeh04&sV2CofDyhCKTL
zba-)LtG4`w^wPYyZR^pycN69v?SJG;=4bCU@fxN=CV;6g1b+<FFkd=ts9u};rC&%)
z_4s4)vlgFd_BX)fiz^ZEH@}r?hkszWPoI`qoGrn#o46S?EcIj-h=~zz9PYqdF@P|c
zd;Pkik=gYB<1%=IawV7)={|Jm{^BKdrBWfLbzc4Y(c{NP=!UO(I8_3HQ@DRBJm4k0
z2?Qk+gTtCvCC!Y{$NO-osp7A^G)zO^AnT-ut^3|HXT*ADe%?`hxgEU}PQNdPOq1I8
zB!E+wUD>`c4~zY47n|SbV2k2~aFt8#B7j!=^vf-%p#GDqIATs3m)p2A_X(A@0MKHk
z!7Hbwd2^xsTuh8I2&LdmDCd*XOj|n~q!FVd+D0WlU%XTJk<V9pAR)d-U2_3@mWxMb
zG!yA1-XV2wE)`{&*oIQ~-~N}LaWPpsnD>unfo1EXh+$*sC#fz)-5i%&H5VEj%U>a7
z#PcQVf@fvX&;<(@hJYNO$*q}I-C}G}xX)oVpE+&1c9r#YcC-_S#lr@hRV!ViHw1T1
z=4i>KlBJ*%Gy+TB<OLJsh;vse`~60?BdSc&<>!Dqtp&X?GMPGaW-|*53n|WdHZ5{a
zX*MNCh=G}q2gv=njEwv%E+2CEi}nkcgI}=yhU3Tk7IzqFBI>Jmv1mV;h{GoO`~GBf
zLWUf9mYm3TS_&AE^Vv=q|ILpIgOJBMN7=Gq#|W4F4yupO0b>=T7J*>WJxc_FQ~;CT
zdgja-{W-_;uI_Uw+fY?L;Q94!?eN-!?v>Sgh1a}p!C(>8$W-sk2h{deeuD%NHYs~S
zNCBbg0%8SGEn}(V7Mz1$2R%=l0(H$V+ZXA5ZmQM0w=ZY;az))VrXJ9@#Kdi0LSrgk
zYE+Zm!C%2_^R4b&u|o|YJ5FSATBlBCuAMg}f-qv~i(nl1whjW9+ko(;bbxVTrN+P{
zAX5S{K=FxNfs4t9P8xx}q*O7wl^<H@_>Rr#UOWwxp&p90i-{VvBZqIbk7<PgJ8wwV
zATkDz3y6j5iK#GN0!#N+{B()OMhlb6bPI@R_=qP%sYh0c>E4MG@GJFfRW~4%5M?=K
ze(dmK&#dURlb95}q}SL>aXFZ#bfx0eN(GYb^nd*j50SCzG2ku)ZkCbhzbYIC=8{{P
z66+$VARu63p!UzkK)Vk|$V>=U0m#wN0xKG|L4x(|$LGmt1?!Y29M)#~pe0luCbe}~
zxUu%nkKRlZW}RQEV4!&S_rJyNeyKUpb#-37v$7-MOh5pxr<lgz=JFy>C(@-SxStpY
zKs@X|c(4hIF3PP<GgbW6Y)tvr{AJuk?~?0RVVJU2{l<d^ld%;(k~=?2Y!^y$g3pxY
z;6Y4h;jqYFQv^GL^HK3thbOaghDKh1JOL)DrJBJQoSl8s=AGxt+KT+HVsy*`(-yrv
z%TqWtX!p7BF^^MyVK~{vz3RsD8)QS`*xF8h$)h}~8Y=)_{rNNi+@Vw4C27AHXq{P_
zeMGzx0Q>l`MWL@$bp$Y?r=ajP2C3ZIyrUPfbFl4+WjhON`-upX5l}?Z>8idZ#8$?>
zw!x5zM=<o2!_Nc2fwC`#{_>6G38PhGVI-M^80PfR=hmDXMQ^ST6<I4Y6f&4V|6^Mc
zbKio{UAH#=!as-b;sf`>&_94F1u0(uYN&QN)+S_-=SeW+TS1U4rYXxB571!97q5cj
zVwr*Djy9(rR+SrfDc0&7WoL)T#zFff_)(vWlMGetrs-`@9Y20NQQ1eOLx-oTo9!^2
zCQ&W${Wz6cPu8m=F$eY+L<E1TP{g?6+x-`nAE#*4gQ0>Q;_ON-C~X(DPDn(An4N%Y
zVB;J0KF{yjvtIOSHR4}@lIO&ThN*vxo3)}5kR=`H)gN9S;DAQ}XNJjed6S@ivUn)F
zy#C6p+RCWeH>D$cnw2GN?3)XXL$kO+Dsifn|562<YO<wbLBGv6p6&T`tgNhTW@d}P
zHo#B_UdLUZ8JWdbrxuPX&VGh>>{);oDS^q}=nWb`!S$IFZ>u)qy_K@~K88^Lg1?7G
zIm=FORL+kxwr57Elbbp97@e((xd~i?*mV+LICsH~jO-`k`?;BaNyvv(6fSE;(lR0C
zae`>hKQVe)e_Qu~|I-5OJM}2;%4*SI!(a?q@wzcYA}#+rvX4vhhd4A$f~3GKprJHC
zflv@&)an0W3ZjZ*t}lDuPihyMFI&?W7bJNRJwyS`1P5}r0AlIi_KN7rr~$DD$zQds
z10Z_@0-?_%XUY0Ax;%5&BP-dvZAj<VtX&@k<4Lxip5yd`P$oZnZH`_44qTP)szyyh
z>mf!>WSmJTbQxT@>AV2=n4(P(70E@MVxBC@1`<KuvVFl1o;<+~xFK|7Brej#$o_){
zofy$HnMzs>@ovM-2CmARWXU8*w^z!dM0Cp__tJXP%yCM^jE_K5xBR!tRQJU{$mi)t
zj;Q%037-vKgG5u{F7eC2vIrRu?g|~KkX=lAHV$pUyENZcpl15;6S*z|_~AI9D@;~y
z;WbbMiiwTr87NFabHo9Zl;^m*i`P(^7!G{@WzYKbnR%r->IrsB)fGEAn$ir_ooY7W
z9!*M^rjV%{q3TI{GR1|{QDl}`*Q<k%^czt7=}~)u5x8!)M@N&hz9g%~1?}DYj-nAn
zCqKK%yFZ3$P&Kj@T=r{lwZtiyaBN_1?yp@I^9-n0pewRXc1a#yTFT{y$^?^<j6sJv
zNO?gX=%J_AQQWjvZZ5q~2~<Y`6?0#YuR!Rcody7Wk7iW0_;Ort;+{AkBd?o_hcAd?
z;HLwJ=(zj_FMBqZp>ioU0Xx{qdVX<gmnHW0X?U(cQ>g^B`FU@L>QUM!;L`q!pLCu+
zW5#<9Q^JpRF`zA&s^6yZc(5#02MwY(G68Js@D((1?HquNL?6_SK-yuH+c0GJf5rM|
z+ks#z-tXi$TpDWOnz-u%*iv|W4ygYwCpD2y-y6FtQk49{b32yJo41L9FnF=xFTowZ
zAhK>|)F|z*%v8~68@JG#Mmd-BE{5WS<fN;y85tSai?yUG83R*HNh_;HlZVbIn+!rs
ze9eBnA!r}cFq4G~)xnnv0`6R(Y28$HG$ez<Mx30a41>aKQ5&^VHv=D68H6EOQ|5Xz
zn};M5gyeNWzAYde(?w2h8jZU=eEfKM+Ar$gCDUg-2EL;iNoM%w=_!k@v+wq399mD9
z;Oav?M(+|*Y^@f(KP17Y8QXN2H$<!>Riv!6LeO;{$NcXa=l!_}iQ#7ZMR>tbfPkP#
z;HgP89)&789Q&8G5YA5cU|9cq6y6t>W@+_5_;`-i+@;$&f5QsnzkPi<kns%1pYwA#
zC1CrT5J@;WOfbL*rM1BQo>irdo+qEv;g_!&OVcYMiR3L#UFh;+)>uzqjUre40@F2+
z6B+x$WDPtDi0$Y^&bh{a62B%`v=Z`}0KW9yLuRV|IiqT{*~?3%X=N)U`ENJ7nE;vt
zc5Gq~nuhtIEl66coc2Ep&?m1#B_qyEWSL2SAV_9y=JAgX7t5oG8sz_bAjaph2a?^~
z#pCK40}zm9lhES!N6$*^xN>bH4gJj)l?TgL3%Lu1Pid5~Xt@620|zA1aL5Qfcez#X
z^77cUq>rEczj}az^N7Uw_YLvq;Bbp|8v3H}5$zP_f_unF94JK{iX-s@(Y9j>u_IKB
zH@k@1Th(B{WTQ6R$H}>^1~lidin7H}nleF1r;uxwQP(e&jV@DU!>6<(oEkCXs$z8#
zP;72RRRZx;>X@Q<{XvX3pb)a3JhXguX5BQ#%HHu~)>1$-?CnQ1WUpL(ao!xZ&y|Kb
zq&x$C5-ioz^z=XB%eK+8!-41i%1~?kVf3(dMea-^@kGSrObm%-^C`+(Uo7v+x^**9
zEP~MPNIXlvba+yOCiWHjiuF^4oTSGYIr>8H9z8bm45X=-4?ua>7_fs$s_!ndy*4l|
zBrT*6&0sPl<$D|_VMT1yNDJ2>rqHFcYZC&&ORz$wLV>-Qw#$cE)zj+vFg3N2!nyc5
z3=xgu-weQ}@|^$pt3b4!N4a&NIvP3a7k9EbNa6h_Pm(AX;U%^ZA@9KO^90_%ykWi$
zbXo@cxa4Aj?iQRd0FQgr184PhdH@uZv|Ig41($z<*4hI;R|}gN&9vHB!ZH^<=R85b
zLC|~N3o#e8jA%*W-Vo@BJCde4{+&Nm5RCVW>#jOd9srG<f4TfzzpIayf$JkNs)s&>
z?yvXU<#qpMN%#=5jEs&sG&0gJEZKwgDtv?_PV@bA@2CYp!qgb$6&2`>jYY!*ye%>i
zB26;ov-n!M_6dM7*`=OmuR%~IaEK*5BbqW_@@BWn^0zlS@~x7ow_|mWkrN2iYuBIi
zDXu$-7T!`h>l;GLofL@xtwY@=vbJ0TD79Ht%9Wy@;*ku}iGdr_4XO@$AS`thC@cQt
zRZ?OrY=p#2kB`3pyw+V0dx*;4Q_;XRYSid86EJdJd50x6*J^9sxTH+2K`Y`a-uAym
zas0w&F6_}QDT$}txplT*qBhu}1pL%PN56@^6oIWE;P${Aon|Hf){usbPVsZ#2=2mF
z3$zdPZpVFRKu;XdKt`mD2D_mwlTrKx>&}OQf{ZJ_96IhPZuyK+z{3Ih0tUjQjivay
zfFJKz&trHpEASkTyC>|5-setG8eHL8&fpJih;aBcp77f*5Ke&_%aopC6t0Z*6ddxl
zmOWDw)b873nsYHQh;N&RqjpoC(%-S_;^LM}TJS`6>NvNFdQK53uY?l+9?EVRUq%sf
z@}5~UP~Sp^Tx5YdwIdL*n4^n{E;;XS@0C1|0=x6kf+xsB_!HCi_lxHh!`NnL&6*=f
zFq}O$+7I_vP+z^LT?Gu0Er~+Xk#`{2S#FuKUy4eZ_@xY1R95cUf7WIG_&icOB|V5&
z1QAMBS|q<ZjJYK}6u)%jgnJ`?nmu;5+B<vZ%>OMclzA5RK&(@ZPU*zvW0JIEP1QQ?
zFw$vr$vUJ>i9alWnTuRh_VbR}y-7{GPoL$QPE_<70BWBDdVa&}ZZpU7b-a5gSb)wq
zYl_+SEG#F*LB+1~?ri`sSbw32p@!x8jHw_~w{Wn6;btCjGkP1$cZ^)mE|Q>3#QJ!$
z&LKqJ-BAHi1b2X0p?)cl;=p;NSgVr}uU+YR1|LUSMU}T@jx#}P?fWXG5LphV06=Kt
zJVP1p$M_s|VLeI^W}S`5Gc?Mt+=u=aF#_bJ&{X^ooB_?h<liEfDd=NR5MSW|4FhSH
zSQ^=4%iQumKef@7Fh8{o*zq<F0E?X|<z%h;f8A6}OpL645~?{VY3$r5D+l$0nkP0p
zM6UWi?Z4KtxI^FcF2j9r{S$o;r8RPyt`wgFw)}v!lcgNEF$k6OBte|f$*?r>2&>eE
zf&#)7>=c1ydiup#N1L@<fUls8CkgT)3IQ~X`JQ8F-pkoZ(Vsbyv7WQ7t$Ae21{l4X
zW@VLb*&z;1JG2m%AIvic9x>_G*lQV_F=gPN#QdATd<2KQJ&;UNj-^}q`cT<3PrHe(
zO`iuM{)Ye}(2Vg5)oe(=qbT#Ga6^35A2qLZAjBw$&&KBpC<LTp=7h`kcrx-9!aI|B
znf*p|y$bsJs#ggh8lnH&5a&Bb+rX@fW{!#HThG^dZ`tyn5==lPI!all1+bdBzum$M
z(`m%-Q6Mq<l$;T3!vH};KAUtdNEc+JK%_vqEADY_=s=fVdUVez+u#TAjbJFgZF&jH
za{0+r)!Vqq2n54ec%X9D75Rd);+n9{WUdN$8iiil7u~N=i^_&AETqZkiClJug%)9)
z*PV3D`QEyFcbdf<3#tPtH+i_5M#Nv9LM)TpK<1m^x_6E)2~I?3sC2yf8oYD8;<09p
zXeP<1O}{RiVbYy;jiygjIkLG21mf>uUy+UT@^qGAAoYAzSgJAMz(znXj5D0Nz1ayi
zS+TyRKW7Q!6ffvoX~BqY)K1-yt5fetI7NL#sC)-)->K8#HE-0<y`|l2p{lBi6;*d^
zW(nzFq9+GW{@25sQ&gRpiUIF-3dM|Fe&uZu8;f32ltxw6zjH=z2qvQZC;bvR2P07u
zvk`1SSltiQTSt!<VV<|bm(kzuxFjk2e7EG~h?%2`O4D}R8<4M9@g}<srM5-9%rk9B
z=O)q(5~2wfedH>z1aHb}Nht`4s06SB7gNVK7H1NXfGPb~NlDp@q{8j<jWziH2ynn*
z^sl*rIFYZF_xa(>`Xx8rE8Bsr2-r+@Tw43$dg{iLEo-W4S6W)fwA}j4ziz0{u%_Lc
zUQ=ti^hjHiptz<1S0XN(o^@Dx)}g`7Gih30Sxe708-D9rlYW*)Gn$@O8*|3%wdOF(
zBi}rqqMUrYy1!D(+#6k<eLV8$O3#l+w1ZRON$F8!TO9?>0oI>Py1HUkh@GENs7iNr
zb#H3TXMWGyUQp9g@{J+J`5|_Sir()TM70qz^~_7)EgH1s^z=PQFemTo6Z*X)3(b*@
zRegV?!<ERO%2IA>?BD09@6uC%Tw#`)WQRqFM;{|zrIpxgy3qemt?hlUC4lVyHaea~
z*@Mw`&9ToIGw0+r%|izcjHAe>xq)=<9%Skp5b&(LB6I2B9QWU<)B;F>#^xqRYa;4}
z=fRt`?eK?Ym+dpQ0@7MVM;2iq8AY#qWm%rtK!ZVW1l_Q)gxu!1KW6Y-OMABe0H*V3
z1j|2c*I|Ix`>A7OTdHgHZVw=GM3W6d=WRGC{A5W))>3ks{i`c|=}YJ>nyE%)V<jgk
z4?gE0q7@p_WBW&~plG84-a<s5=5*)K8St&g%wJKwO?_qm!u-%6g9z)3v?pX<V`6yZ
z*Qx$jb38if+YX##oOx#2PDIc>m6}i^%D!|%le%*m{T{UZg=LTE)m*oer~)`kbLu^)
zF@L3<x4l^i8sL~EX?4-?jH>)P5V$~;(a?6N5R^!Z_#SdMsauxywV2{u^7bEG`5afT
z?z^ri&@|jIxo%BwA6U53aL;EUV;VVnEg4*jm%7MuF+34g^6lH%VaYmJ@<dH7E52Sb
zf8M;?6u9NA<pm)%3bA~8#bKuZvFM8<-T&-`m{nQrUbGM;8B<jgFIR4ude3VKtliSf
zhbWR3=yp`{t<MJqE|I0q+|tEpE&ttbb%%*^?8x(}`_)S}BdiBu=oVx;fcfER)6NdG
zZVS3hwjYQ*Nrt4bDB!9D=^pQfVt`VDv|g6&h8aWV`gXh5;9nf|u~|D9s`pHM<soE%
z<jOd1P;XSl$2NG6>@@1$dU)ixo{<KuO0(5|_Gt5T#kRgiHW%sKhPxI|0Gn>`2)(*2
z>!L^mZ;^fIgf+{;JzK`Dr6%N~u=3<F%ZYt(r+@<JJlthm!IJK~lQ0QjA&dp3Bf$XT
zdo$lC%v$S=^}G`|wrKg}ef$WZIjN}M*Z7HO$3emt;{s-AVlZvm)f37ptPbH{eI_d@
z`ECISTJo_oK(c&s-jddc_bk~~#I#uJ`l9&qhMC}*rq!KU(YSP`qI*XDG`Kf{s|iNx
zz=C&f-wx5u&C<lY?C);6PfpLG=jgZ`SsGqG(3I!LY|eXZUXq_Y2|ytf5+<xCA-^ND
zrDRriFvtnlWylp`TD`;$QIt+q1;NTvQ`xPiBA?{kbnnGQe|}_Gpao+bdt8BLTV0?b
zDi`|~=h;Ux#I3gaH#<5e6inAqY!*7j!g0I{GZpASy~rUUJ<?8$ZzI0=gc)wyxo@TX
z_LtXPqZ{t2p2<Axps9-PxYdD;s(V|a*#Z(0L>MNq&-C*fnNC2`)}%#?dxYKg?f0uB
z46m8Oyy4pXqptk4Jhlz=>fiso>CMsc5o%f!6{G%i8Rd4LT#61XpKnADwDju>3UZ<A
z1v>XNx&s9$dq)JC1U-)WHTf&#A^s@_{&DfYbh-ABkMrRvUH0n6x|SSM%Lor1xy}$#
zmR3+xU^%&2E-ojy@Z_O}zD8cQ{qkWHW0q!N!_tZ#*L?o`?j%zZVu)3Q0CIqcygaRG
zE^TijkZ&Ar<r@^#mKgw~%DadIhlZ}4ZQl{?Bkud^a9p0B?9gDEjXLEMxs&kMJ@CQ#
z^XJuY5d?98LEp50|Fj2{rwv2iLBX_3INMLjchJN>K7K~sCpAEoh(zo@-Ywn%b@dS>
zzhvhilT<Qn&9@4*)Qo(c(l+f3C|h$dUYMbsxVJI5J4P!APwIXygLaRz8@}eN4_kmy
zNimTiE?PLS8_+KR)fy&iUrldkG{-eDd?YhfLNPvjHq|a!Ih{5^b}n%WS<qxrFiahb
zk6otWN1zKAG?)+Dvuj*W=49etC->FTnh(Oqq*7}|#pAc{9_kfj`jQSO=t$M8$SK-v
z#(QL~xEgDIzQvU9C1u$7j)WM_4<FqFI#Db>Is9!HyQIc$FmC##`wMhs?Z~J<1z}pX
z&Ngl3yLlTL0LehVu>PBsH|KV@y|Hi#<MUUq4u!>CjNG5`s>&eaWs^Q<Ma|rgtCi4v
z@#P<yjjH-Kh6bZ))xb&7<UfA+rpeDnI=s5F5T3D$TVQAsah{`0(7lbZPdO$+WI{A=
zV+*FMH*e8`#mQ~B1Uu*<@F*AOQSgG$sb{<c?t)StL^scw!>%#fFxhGKYIWwrsUlj0
zS9$_BnrWo(&*DJ}${u0~E;N?HO)NsFSJ_s!6GuoTRn-)VTDcH3?3^kq_o?R|2+{uN
z6RYYrifL%quBp`O-T^;#qOZ@M$6@4Je1KN!2>!qmqz0I7r+qgtFmU&yPlU1az;&Xl
zM^%82nqB7UNrM-Cm`AA%uM|}p974l#=FR$b<%=Dz57{2Xy+p)(+**sjEU?(Zg~l8o
zGNkaZbOd;)1W;6hrS%*%Xs;lV&dwzCu@TlEK7A4%`@+SGp*&cdN80HD$jBhD?%?es
zzJ(k(#^7SC24bAFp9rMO^z-wH+H`d%rz=K{Ma;JA!2(IbAgzosP-BeM2)x;U{Aira
z@!HxayHUw*@9S=-usH?OO&6<Ddws=)L#0iOdn!%ojpjnuhag4^3A-U+8pwJn8+Q0)
zQ!aj(WbKX|;JDRapoMvWq=ygvz?4Kc782%bq+$oLY!&el1e=?ri_tj9$qa{6YC$K}
z{^Zow?B|*-bCD89S$f2d9qqp!Fl<VQLK#M7Fu6c8`Xkn&{Acnl+gpOc8gyk`x$EfJ
zd3M#bI1&yR@S9TcxrJ54UP`WMrxnlig*_ngdjT2m|Dz{EpClSOyJZ6ot^s?m3UBY5
zwRA8b6}`P&3c&mN<E9PlOYG#s3toL?WllfRK?D^p*~>?C{zrxxaCx+UK3dM*VlBwg
zlK4uI4^hR1pWS-KoD@z0qK=S(nhRAyc}0FO+m%9zd4|bnc8{v9a)u_<bNsO7=_IWQ
zkbnd}i6s!4aKQIJecu!D(vX2#Iu##K;3lfZKSsj{CKBW1MN{=W&Ayv*QQY8BYES}9
zDHtXqQ4*B)vOETTWw~aS9c2&cXk54zOgL)Ug{=6LD&o^8Vcj^0Bn-L;mB}44ws5O6
zXtu<xh&GlFA5NKTn7m$m3T|9c1Fo5(K6}4$E$~Vr+BVLPM)&Ss0FKiN)-oz$5^mLP
z_c(f;kK!HPZ@)7`7JE&@kH5-{`NT9gl|dF#nGer@6i!!6NlA(Nwi<cWG1=WG!;Bn8
z(bDqO=_Eua2Xn!A$^cPz&6yJnRsqf+#xjU|r7vc7Pq}FW3L6*+>zB`+C%q(nO3Wfp
zK~QPX2cZUjyZ%d*X)2gqJ3=V~H-*c(_TnaY0WB;2@uN>{{&jRBvIBO4#)i-B_t7B9
z^WWaCuaa66HO~WDoLHb7h9s1Rn}(l`O-S2r)cv-IVj0_K2EsewyAFLNB~u^;I1sL*
zlatbNtDUE--n##u1#@G%VgbEXZhn5RiQa9qGy%T&%T7p?sGS}|x)pFlgJvzP)(Y?K
z)6Syavjqk}(5??&TAd{eN>{IrYL~MMSV*05Zopd+HprHhu&^H76rHR=uYnNatG=7X
zR~BDi>gf0ug3sBxOv^F1dLbIa$tRnH0zrhapK!{2b^93rmepTQ23bYi#SNYw{1Pih
z9Ty&K2PL*6byVdJ@HS9v&&H~!viF#Vi@f*XgsuP8Yy`YB`Hyk2q%5IdX+!lzKD@j>
zK6^Pq0MJ54iFs#Op9-jCm>hXQU?j9rz|=~^{gUXfl>m&Oa%9U9KJ=uusRh$1p0+ng
z(~2aVRsH!AEpy4-kP8r224&PuN{WiNbP}qpLVjQ6?Wye^hnY@r!;I=M1S8RXWY}#N
zG9Zw@-Q#)=vQMuM)y%Qrl?bcA!=cExjIf^H?Z;q2yhvU2&{S5NAoxd)9JwXnrzs$T
zEJ})=HDJ#4>G$b9wDb-Zm~&x8*Tn^qsY5ffM^0U}G1!xxg68I8U7~=BL8KmpJ-hfL
zRS5`Rxy$tlB8Dbuk$}B{fVVeq-h4Xg;R&X+YHNNc#Nf$jz0>pMAcn_g9vb4{N2vmS
zu#m0=wgY`=tB+24kZ*Y9`y*Icg~a~KiZ>4-kUN5w5!Ir82A*Gb5gDj7^HfZfq`hD^
zkYnEdzWnvI-CU9zrE$jy^x0r*B9x&eyKIxfGY55|gvt$?nE_yPm+;3(jQNAObv(B8
zy;xKdSvI4kClq<F^)~FOWY2Pk)_fM(%42A<t}m`=U_bf@KEN(@4rWePeID@)yYcmI
zzg{lp)9d0$%FKubPcyP;ukr4JDF`Q;0LX)a(7wrHEbz8S^L1xp8l>@g($CEr;eX^3
z35Hz#?10x2bSzx;h&A_)e)t?hk|7Gne1#zERuOKWDjg6<P^*ms_LGu2=*YDy#DIur
zeVz`O9VxYimQP_p0Zh}orDZB*o}BfY{VOa(Ec-iT52EEs#NlW5x{yiMj-%Pbj8JG^
z`ib!jzL^ya%bH5|HH&`?cb`PLyPKnbbN!Uu{5a+U_;oUC!x%ml_h65fY1^5toycP#
z%;X{gLW?}MVBFyB#lbyv?$rOE7Qj6TiC4_Utu~qn6d2NxSsg0Wi8QeS{jfJ(xlf?H
zCJE?t&oXRCbL!>!Qq~wCENDmlN44?Dy>o>1Lx@nov4DmdH?PgF;dh?SS}JRP$MxiX
zd;m>047mk>2~H+4h!&EXiINL_z}?=jSIPnrCW>VVp6Gh9ygJUqBC1Ex0d0KV&Zv%K
zid)+@s;d4B4!~848k70npo$KZs<;zx0bi4s#hRK2{HO627QLW2Bdl$5J@e=^umPXy
zuj4b;$cUIdJw)k(B7<r7c&D>9ee&}2+jQ#m2!4M$9wmTENl5V_32*doF$jGjLn+{#
z4|p%Yf1mhX|Fz+i%@{Y4vAAi=s%pQ4)*@z6h_wwMx^S@>1Y=^Q?~;z?Bo&H}pu%SA
z^9^E_B1Qs!J_>A#H0%)tgPC6lHL3fjGAcXKoAZF_r$Uw5P}*b*I>!flcBpRL-+or5
zEfpV^pCxT4o=!3~)(S!aZ%hs+7lbm=KE=uSY(W;aDQ4x}pdPt%^tgg7Gf}qpX_`@Y
zf8hvt^nh^lNnc>>gqqI(thX*$5{+d{;Lv>+Wf)_?fOSRpHeTdDGPoO^q-<1ORkh^#
zIaQ8eo8hLh)Y?=}EKfTHNJ&d9GE_hp#9N=6?L7L=h9R;DhT<n{Y4#He)L0fY({&q~
zRP4VvQLzDBZyptY`0NWarYN^J0?T|tsWpRE5Y*|?HQnobG?kl5V-L-ChezZcFgdEN
zg*rP{Fm`Lk1Y8Rm8U~|7cjuy0Y=`2fkaFYV+bPz1XqHG1QdB|P3MdoOBWt=Cx>Jf*
zeM@Xb)Vub<J`^<l9=aT`)7yTYwCC-q<84`jB7F_K_(H-7HSU<FBavUhO>QK%Uwoas
z_V*iCs_OUX=2RZRddZs*nvh9uMzq0rz&^q#Mi>O&%HZ)H!_$D|<WiLpp5_e43?%*w
z4&bjcxI5D0R;_j}EgeB@B4cE(`_$gX-`{`Tm#C{T-@Us`s^In<IeL`savFX5oPBHz
z<KJhW&K%kICr^(MlgF-v_c;CtQN<inU-jtqeznycCG!GJo7EWjpiqv?T78-(dykG5
zs%X^+Yd<<bO8t9S->};z)LM%^|2F?X<^>|P(QN@6aEWo4qlgU;HEE;43Y%z~$vYHp
zW&<&c87(Ld3Z^}z1KBSdVkcXuHg8Vs6g>;g!T}I$Ka%7}KuG!pGIuMGgO@x~Dp0nD
z@O%qzlvdEH!qRRF_V^Q_lnyYNt%<3R>)UlE1s#G;{;9g6t>hcoAjs61GUfBjOQ$&I
zQERO%mM`xE(gw#+hnQ2UVKO))-hIPfQ+3FIliX#R{||Y2Q@@*g?mm4IyqzkK=uGx)
zArpTbaq^>K!4jP*hnj@q#~FPjX;K#k05hZK1e0Z!QNOQ)Z8i;8;;mTC8WizRya}u#
zdg|$Q#9Eeyvj-oZ5QbiDBTtaY)F*ompU?6o8sVrPv1jsGwpS*idVTbxGk<~WZM0y)
ziG5b~CfE&uE`bmGa?UQH6?gP@R;OToPYLt!dP%&9MMX<kFfQvYp+c?-OSk(9Aj$(X
zjId_@(Yn~K3$xDf#1ht-TTMFYy8Z1}05+(=gYvTIp)TS~OOW0=K?CKjWx?9P0oXQ>
z;TQ8D2Rju-;|xW>%VUaI(66PLnkTI6!!6FY>E$!E6`zoX?i<k;H+p4*oG@tOC)CIH
zIbgm%KAO)5NFfjyIN4jHT-*sS+xXk|)9Jls#f$TsaAQZ<a}R_u7F|3O;_AW4gDMVQ
z9ukY{hf;qbUJh<$DMO_~AwP%M1=)-p+mPt)UetaLfZhY1i}rw^f+<KpeBjRjie&76
zrLD2;StP{#D)bKMl+RATP?smbk<wdTDC7_?Z_cC7XSxKL3KJS>eDL}WKx5(e9y}Od
zpjm5mLunKmC&ps;1bySuh4SLmGnBCzAHaZVV&Z0MmDV)bC`ZScne`xFP>K^vL03Nv
zvP?6>;7Wv1cu^U_#hPv{wDwMSaqJj3=rG%aZm=X~H@UGcpT`k3HApcT7@<h9Zrd?+
zAebt6m;xCPj{Nui4dz<?`kkBF!a}j;=&YVfS(;iwe&7XDAGJD2h#&&*1q{B3_6B}k
zY*s-m+YCQ+x;a@<tVpQiNGWpb7U&*Knzqx|$k2J!D*dRbVN=iGuRj0Q#yaF8w5i%I
zG41!BR9g@5?muxZ>UQxK8T{cxHRt>Rg)t$TAlL!WmRK2!#kf3glzcJEo(GV>zdz^|
zER<SEk9`L@KP5MRcM(a$@P`RNU|R_$x@{k3UtMWIAc}l*r~=;>0<o7(lm-w06#xk1
zR5%o|R|hV?ghV|g*Lnjoi7^_1j%*JHa6d@@#Jwa0UU{6HjS!Mx&ELF4h_cG*-`+mS
zv!<*ozao`iD5%q`SBE*>RM;D7QI0RWvrG%$P0ExfU@}_*LI(p88%0<<{V13OY*4@`
z&D*zciAL9~p6IkQI@1cm2@#Db#SV`49OV>id%h26M@)FQ>Q1!@!?_96jFyF;vjL<}
zTSx8*ieQdc{y>naH|QO$&tecoPFq*b2eZBQxKYGj^sN!aHqhKr*S8_G1(NWoveh4I
zEOg{?4n23Y-KpNqN_YzQKRE#;R(!pbiXGsWPFG(li2L-vH9F-Ho7T%Hk)7E^z#I8Y
z*i=6eeF#|4cgKze<W?!vkzIWk-~mpeu~QBGs9-Oq;dfAa5e~^boSl9%nvCZ1GT1W~
zMvX&^D$tMq(}Rr|L<$okDDe%GH-XE+Z75Q_s@#pT%!p9Lb!N7_iR<FW2>{4LRUU5R
zD-u1pwGAADq~vxMW#`NTkDWP0jRbe|S#}$PKgU{(Ky{+~vmw33L39C35zPg4vzgFG
z$#>}`nsOoV9KBAD>!}nZKsL1nCp9E&?_nYmkTrFRx5cQ6ErRJp%^d1~E=p-iOX^7=
zFu4aT3A%&V!JIicrq?HFC{1Zc3=lR4&O+t~z`8N~wLTcS#J*`Lyi&}HH#T<pBhha9
z&(J9;DM^Lq8}z5-R3uw2K-$DN0K5(yU@?FjZwAcDJ7C%(SlV7}^<WDtc#)Kz%sct;
z=J$VI$CD%(_YF_K!FTyqbTx;7e3$eY`SHij>;-9|#;9xlmU?x<HS8&o_*?lj$KbQ<
znc7b5@&q*R6g=}^OcGHWyDYX4ih>Ha#*TAlrmljYDOxXbci)P9YzB;?raDu~(}_GB
zSvup#deTaMhQ(+qmgvVNo3m1wv7m6X10xYRF{~TS(utpCDr`3i3=I2O<})Z6#1N3@
zFIZYrZg*Rw!%8AGz|tkg@16ef1o?v&4(5H|{E>PIL2A>ch8ltFvp1s+?l5psbMS9i
zGhwuFFa@y37-b+*6S;N_2x<+AnE7KTmANRCDail`#q$+xy_xD6TjV+4lDtk&-`D;b
z5Vv%pO})K%r0;Wc%d(Xoa(a+JEr2r=L~{MlrPSJY!MlMDlM)lh*j|>kBCH#%*Hg*&
z>7<xKD#aT=pUt$%ftT5D!b~uXJui+eSLeYO=Ou2X50J)<hMFmQ;l~3Xh$T0f2nb0A
zBe*CiCIGHbIDj_2<9VOkmuO>jXFJ<}F{Io%>W>diDN--7^9N1!BBy<Oq?4c)_+ZJ?
z<F`9?MY$-oM5OiY%U5KyNh|0>LBTl4XL`@~B9RGCce**Ynq6sVVZgdAi{fqh_>ns~
zSCbPw+`$;U1FY=tPP5)U?!*9+gfU<dC%CC<_#KtOO9iY35|!PYpl~Owdh<mLP1*!)
z5<8eKU2xzZ$bqgY3$A7RqPeBzuC=%4Sm)yZu>&wnpg{5HS+j;422x)?WlFZ!>626a
zMstM8|8|QPpW2<<<TF(nzQ2*y+Afioc--u({<}-Wt+WBAbpXBf4^9}nXwk{1rKVBP
z$1#NChfxQ0X5S_-`Ro3Z`ts#LbOprrnAT=tKt?jN102W%6{L7~m!7Rf4k^Sd*o?%w
zyKS>oxBxSC`;MmhXYnPd0s3qm_bQ&rK?Yz^)eDPHdVbiV4=a0g;%_~C$oTM8&+3De
zRgg2HgQd7fXj6aObmx>~{~Tu8nv%1Zi*ghyTT%*&_i^A`9U1PVZ?d@=kalC8Gn$&d
z9`WZEElNF>0!Lkn=y`LiQHl$kC(@D3;G)6x_d+UQn_5D!eQ>A(==$$W%8$F?z;qG=
zp^(KOg-=25tC`j<^Xb!X-gbpwzD%~Z?&)#iT3sQh8#g}Ai<E8<$=lVdt`XCGrw*nY
z<!uR6)Q7Mp`^6XlLa|4|UZdUhFk(X6ey6BAq#k4>m<x6fRYVHeX~58-(RV*inFBq}
z677i6g)hZ+xuBr@&i-o;zmUAuwcqowSsIm0e@eAwNBf5Mf+kdbPEwF*xRioGN%Z3n
z9zX6gqe;o9Pu|vA_cAko1bsUF_3LuSpev^z;|@6UdxJw1vwX1ah9Rf-bQ;UfLiW7X
z;h=@DuR>2rq-@>HJ4my8ciEyt8)51fa&KYU_lN9)M^YxMc&1u>Z|7^2?Mj<LJu&%=
zM)dZQUELv+thL%I`JNa%YY+ohuys^#vY~{LI9h#7{B>LgP3kyk*|Qz8R2)c^;)Yc+
z-KoH+A80{gThReJA&x-~CT<J>tzPYnbF3BnvS~|4$HK0SZZ5jY?;pqeA5e=!zJYU1
z$3aVW5hxZR!X*@6@Tgu7r~`)mfvo3NS#(vlKM)o^U>v-3Y2?#MIpa)Bw$ac`jU8Op
zwzp5+=pzrUr^tpQY#pTdy0P}c+Sb?n4q{^@xu1C<W(#KYv0bvuTI&<#vyh;osH7I-
zywBGBfJO$wvb{i7be*#|B-)<%hvtGof&F~X8{Y?`&OW;!E}Op5tf@t)-?G=&2GBq(
zq%5Mj)GrtogoOseqq&?`6UZ#i$3pT7+{m=teBB{K@=)X2=v^6iopI^=L=D)`MYN|x
zH|zCVsnP)_JF!A*MxM?diir$}5db+qRG73TGGMBH*q>3+L}~=l<$yI2$zkkgZ+QG6
zH7b18Or7;<972Di?qX$*kYgvuNPG=k&Nhw3;})yWQ#8!c?nkc8pWT5LOh%76fS^+c
z_fM>eMP1BYhH(v|5u<+anxK)(qi1$PmtW*~vBr!s>^3SY4*`-X*jCe+F>sZTxzm#u
zOr#^b@*E+2h+h<#;{L)3hwcqVVgNGALKo4^^7F8~6~zxdIPf%ux3KxJ(u0;}o__oi
z3aNKHBjbhtA75_*)^pyr|6}ai$PyxwEhI{jY?Xu-DugCQDU~HlwkAR%QdvsMl6Dm(
z%3j$jgdz!JvV;~4Q6rIluglEb|Nn9Pj^lS9&+$CZ+)RDHpU?Y!E$4Y&=M`m@AXXhR
zoIt{U1rG&Z(nk4hEQ8ZhGm4r5x-i!BE?87WL8Q+bpB;@Xl8T@kyK(}gb%Px8^^g3R
z@Aj1^?+D%oxTzCtO+>fDlebjI;p4oyerxlMRQDM35}1y(K2e;P6^Io%vO+l?Oa8pj
z1#p4u-GAE6W6pXW<(HwYjCr?66x*`x1}PFJ+&6GQN7qBZ<e(^BE~(YUZE>mEdgEos
z-v}d<WSb>gVB^4n!Bp8$I}}x`+}<S~BaM#$EySoK8^Ff&$JgK7GknbkK;HTAz!-q5
zpa`bMwY}gm_40N1k-P+iSi0UnF40SCFME36Y>B5oa%HV?DZr}`zcX)nKKWEfRut_l
zDg~OhdnXr6Tw&tWMH})9$Auf5>uzJ$Ef28&Y#YYA-OjHA{sjV;y*`8hnMoz#;`JXy
zHW5h<f;ttCr#7Y<p{1{0T?eqV|E7zMRW3=3-d>j}%dWeoC{@#Le8hQbV|~r+NJJH+
zKXQxM$;(Iqb)T<c<UQ9t=z<zKXeNfQT(br|WET+43xukKjlnhF>0PN#fbjgYvKkim
zK6vDa$T0Z+loxDY$^o)l|M7WaN)aHzU<e685fRbQcF->GA2hwHTDQ-DMC-N40>D4^
zkqs#4eS?DXdyLvKvjv`Ojn<WJYr^A2usFEyUO#V>iL@Aal?391AUILi<UwMwjRu<3
zjhE(i%5t!Crq`qewkN|<{dD>0Zc!tCvsju)_Z=DSGK&#6ve&oS25DgLU@efxtO#^u
zpzRV&iBOa&DZ<+GPTVuU%D5ll?rV8;ka+cTHb@BoPnK$(`G0gaoX~<|hOc(3J`fdN
zK}w;A3Faeex)i8D7H>5hkaXYv)DQF!$SR*xP!6qGMay)3%d!1Pp?HZtMyfAPoGn3|
zw->g8+V1$C(v*1@_fxU4<TFmG>S7FR(}iUFtZBejCoVeMt$y}(lB#98Fea3Rf{*#q
zk@1Hj=)i>q@?X}}0>})+c)Z*tN=v-C|A8N6(<OaA9nh@Ag1#MHckZ5a4>U*MjzsF0
z0e*nfietuHbhA%H+dBr)=W9vhdONLU5D81cDm06yiBqBD;}|<cQL~B$lNJh{y^Kzw
z{@l#rHkoFtCxqkm>oL?b?nQ~S!rDYNVq#|zzuacZ%oP-;zmBh!(RJCLt)%U;i5h*~
z#H^i4NZ*K6{YO3ffq@i2q8i5#WRe5wQgUfD2TH;sLaa{RyMN8G@|p5GtF7}$EC@jc
z6_o<J<mFFjxXl<&EuZu&=;Qjj>V*9>9(oP6Nt4MZ5RE8G<m2>i|5kYneqp~RqrEvB
zXDhUcDvCIKSQ#pVZ4+XHGu!j#ohMJi`Kdk6+uo%uF#WN9MV|*OjK#%7&ibN=4aT%s
zRE2WZnQWC-9iCY1vM6A?+)`CE%G1D2n!;xUSDRLFIs_{hNl|Zq4piD^aPG_%E5mdR
z(muhdixC{C<=5At_7;Of_^LA)7@!1~(Hxj+c?pQiC?KvQT;gvC%lU2bq>xDoGqqN{
zysnhB41rpPplqC73P4#wz!%^O2z^iAYPw%t>Sv)*{_S0vz98Y0A^c#dG$eQmqv?TM
z0Wi{p;P0Gys{L8F&KnhpY?NzAY~P0}oq0~n!6Dl2CAQ@*?npN#NJqeBF|F^Js*)%x
z>yFJFjP&6SZoV$}qMD%#=>y<Hbs2DYAb}HrcW+8&oisfG%CjZVzX7*Ky*E8N#j$Af
zKj1qWA5?C!pr!QWdISVo4)Q#Yr7+9e8}Z6*G72$$a9@5d)+8n<?$Dyf0l<KV?)g`A
zQ~JZ*vKm-Grgh58ZvcIyuetlO$jg1O9}}XJ9f$0}6*2Yn>B1YSTW5NWNK2z&?;#4F
zBjbdmaCvm{#p2#c@$tE6DI~tY!M)<Li-1Qo20cexP2FJ{zwVCL{P{-<EbT1zY$*q)
z#zf`5Vd5u&iU85sUdd1FjR@f8bss>9oujIghLf;F=SR;$)rIZ=EGH*5Eo~ubUfv*Y
zWEEsXX2XwfCJ`+M)(Ns{zoDiJO=K+1f|F;m*#L2fA~lQbSUQE^Q-6!Vi^(3e&d4IR
zxI8@Gomv51`u+69vuWYPmW7<zMQ>Tv9jDZ8voiR*+_@_tKC)1S=$Q22vp44tl?5Sx
zC+#$skTXz)PGKJlb1+*%|1}UPC{PD{lWFTn4p}MHL-CaMsVX)jiR$8+M<cX~ku$=>
zv)aeW7j{5h0NJ^F9b$AAt{z<XXh*9eI}&lMKzXsTE2uFs*SX7^nhO~wVg2S!nTgD-
z|NA$Y;Y647=bsrl_1+0ffiz@!9=H@y{W_l=S&ytU`TrzjBwE=R%2n>W?<U>$OAf5W
zc(u+u0VnYXrf;nJ!#%5tajg-!N|vlIQ$`gq)S$tRrs?~atcIa8)=!&xkyA|OmL6*^
zWEH>H>4)v$U^*&d&`mmV)A~a)7dP*sF_?S$f#YiiQPH0NGJ%9+1Jp{8GrbiRUd@7d
zS*XbGJ!fNwUS=mQoy-bG*nF95Ao{YX*7#uv3ahgw<9iZEOZ4g@vgK){o;;}!n8(xs
zTA5onva@|D7X>LmRYalBFz?>Ohlh&1tQ53w^vYK)(Z7ifmdcf``33<}dt)-vGGOkd
z0bUo!BalIcOdy~2!m(8ary800%ZiFYba_I#9dyrJ0Mx-n53O4-Le2B%75-_e2!Oe?
zr3C-TnS<B=_<mk-M(7bv2s-dtZns?5w}~RK#epl$a^5Msi`YEek%;ZYqiMKcah&|K
zU_s<L=giiN|Gc2Xo6o*_bqi5)*7?0_SI1kZVUlsJun<w`p}i3yFVpYOdcFG88JXar
zRY!|(+%~^Ar<X5ho9WdZrVY?n=g`SD6^~N;3Iz<$kyP}07?8KD;3O}LA12i*c`5Q~
zgLef{gCdI~`isZAM|=2q0MiqB<mq+cpCOCrdQD2sJ~^}0lm?35NM(O|`3pm011RlJ
z7oYX(an7#2pC2M1E#Fz`am&7nMy7nbF=D?3e>0rrxrlZ0X*_%bW4pu-_1o#R{{3LP
zLBmkMoIc%GP0f!i=7_KhfSY*Nf|j!%8$@`a&~N+PG?h~lZNT7AXC#fBq*YsHWAIZO
znHbY_@SZ7*Ghe%Wxe=94iFd;WO86<$r{~f^Ga~beg!lR1(hiLR+J@TNT9>8$FAbQ-
zv(o2?{di3WLCzjQoaRKcR!@~qHe}>u>rU`oclpGKGVBu~R^ev@u$aB&SaSr)o&OP3
z{!8fL-3JSqHuCXjcoaOvw^3$AVzM2w$`6HPD!y<cJ&zvMH*4q50NzCr%9TU2c%DJp
z0hmt$Ps4@AL+mV)?T{jNXQwX3o(vXp%g7y|S}z~;w+yJxnskq2;d)8UMu3%vdAT_`
zRupIN+e8U&O31UBw`<r55|tLf0gD%c%mxhkvVy~JnJ^Prc)`-8cTfkS?9`96XgNMT
zyQJg@?}%!**_|rykh3aGBIZ#bk6!+KlcH6KIUNoNzzhBx(eU#czrWSY9#ymWkGkiT
zIZ)^*Y{Vr8<&8|CZVjCIejEi66X&w65$_C2=A$@I2%%4lO=EZyBN9gEk~>bwPrpJj
zCp<Tc^`eJdT(|u{Edcl8_4sMX1x9bE(+2;hlAk`rzC6KPbUWBXMy1lNJ_dQzrMlv)
z4(Q)Mc44B+`ZKO{pR?<1R_<9N1OW%A;FOao&?Qq(4{ogZf9kpz)O^k<5PMKZ#~E7v
zf2>9^VhZ4^tu<+;x?kpFA_f>AHg~&lZ$N`RthV#Gr9#w+(<2ww-Rn5vTSd_*{RP=c
z+$~9J_+FU;T5|QBDfWn69cVp)HDr$w>!Zrg71{B}06T9e6WG)-xm<S`#I;~<|La8i
z_b=elI#5vo2vT2j`5fKcc0%V;yOO>32jd?-5oBo*b}e+bpG$uK5K>tmmpBz~a`uLE
z+gmG7nmI|1EMhM{E|23C7CM|PD7AqeX<B5UGGwAoM^wYWq?41Eg=nmqy_$RI0N}vs
z68iz*5%RVJT1}e`K|BI=VFpDQ!i6k+vY!6)*dvf=IA~`OUF51BMIX-E?U^$3b!YDz
zIKW&iuxuI~AHSW?4bv;DUxEJtM;@ceMhxII^ZT<;ln!3xS6V3fhAAn-ME0R~WJ=76
zl)*b`hSRR*CcoR_LU5;P1{JjHo7?FsDNZn4I#Md3ow$gL>pI<(_R7YYq))XF?Dnj>
zAwpew{t(ZCt?768SG0GZ^Abv*|0dDQGWAk3%i2YEyr46WcDfHA1&-5!0<Y(oHM>wc
zWmT_uX<lC$%}JI)DT*%HQ3;WfbUWX4HL|6A2x%dg$E<nxeBbo(>tEz!$|Sl6Eb0Iv
zq*^di?K5c5)T7takuCHPw-|fx`qjQc9E%|cBd>77x??B;2br+$vW+ZL;j*2Cvs&?_
zx*?y$MhEG=v`{VYLpwOiGSC?tvq6bwJO`ocsK-apSz$Dp=e3I)A+s4gK6*6)=YakV
zBlSUfiH0b7&8f=4)Oq{}UPR?0h9VlFp>?)MZ)AYec638%?ZsC~D1Lv1(m}?vV)=3v
zVlnJSOJ&m}lu{g0*M!-(nQSOZgP*~_eJXE7Tz5D}09^DXSNWXO!BU2wS9M%{27nB)
zF?nzA{O+v%F*P~5@_bK3u|!;^nsVu{|1VKHiJXo=<clLloQ`Q)`T9R8@8I<T!{V%y
zTpt`$z=~6$+}%c#x5bG#!rg1bX>SI@yM<(&3K7jl0e$4igsLuj*5|!w44H}eWrvYf
zTp8=91frtRIvTrBXExAvYhNLT#mg5wQ$jGUlTE~paNaSC#e#rU;A#ph&&zqAgQyA7
zEo{}Ka<!13V)&@mz;wM)nsykL^D*D3A2EQWH=Rp|DxKBtwtbV5jY5*>gpr@hj&Ei>
zZpgSlN@k=)Fg;Vs*MU6NKZ|nV?sW&}@b!;kH)iv7@3T$JyBejZzlk{|vOhdDCB#$Y
zJ>~7o_2*zI4XeVt5xu<_w8F3huoa+9fJlapQW`hgRgy8Ea22aEOeTEEL-B%P>aFij
zp)M>Tg=|hdG(0uR6q^I`0+&Y+)#7O%2iY0)D|wL83q|P1PoHq(+s$-p>AQF8(~b^_
zMh$|%atZ@$Zs|%u=Cj8?q;_GzfKe)@ORx(_TG%CH%4yk~N-3O=*M;`q8;c=T1V;kR
z3Ihbw3NusJ-CxLTEE?H2;D{acOhT%>&$=Q<2q%2XWDtL7GHVSOq@t;%ju{jPMx+Co
zVp#~RNZ<NbdXP8Rid*`Hh0W5i17bji1{rLTkrKk>-mtK#Ojl@ywMD$^J#R9m^@AXo
z9H`L2TVo!qfA;%_ag<F%zQ5l7vMA~0hrPqBl8U5U2MiUtEtgA^HcfB;Lx!)TQ&NO>
zE~$M)q=`yOVo$PN|9(l2=``455l!+pix_{Hw1B>s5_|9<Uz1p?74^pz$0EOkTw@c#
zRNhy*XEKd3<rV!ZHZGJeFfc|m$tEU8vy1xx;UIn(pr;oOy1(b(K~rvnN$jbZrf%e@
zxTg%#0A4nv+q<RQqOvimsq2^c7&*WWphzU!F?2(yz2F1qE%j$Dz|HUUDT0{a{&El*
zes;|#C%)cL8Wn2y7f?(Kks6U*C<cbSuW<sV6-7K@YSz1MenwFyoTpx_HyrBG*1)fs
zC6T=k4dnm?GaQ~)%CROC<KhhVl34ik!fJnRpC-`YPrO2kb41xtJ*!^d>N39e`7g57
z8v_i4)(#xJz98)YH^wxn#30#E$uJ#@Uy!J`N_EJ*kP_NJ+kZgIsWrkI1-+fdqK7~~
z2?K6_LCJPT3FSNALqs2xy3%pw;v!2A#0yPdQ_|q%;9y8O`<Nx#v4=mewn=x(ruMjT
z=g!d2tJ<|~TV5C+q_Q|6NO{aQcosyB%#&YQF?9bqhfGf;l;gbVm!wKi+1ZDd%r(h=
zT|vt3h%Jqe&%}fyW$)gJPXkp;e{6SPm)P|=<i}H&0<5it9SEEKG6O=fJqUqh4{%YM
z&Fk%2ye4YigwD<d$IssTz5!zbN3s~w&`)$;r&p93GZJ%yMhbEE#@C;(Z*jRZGk%&f
zq);w3#8;&I_G)ouWo4)?C=XE`iHHv19OV~NL1JkmvtU*&Yd(HdtFbX5)QWfz;MQcr
zooqID@PlTryK_m`pn4K>L(rJp+AHtG3J8idy>ft!m)BS(&-!P-C<fz3P;T#KuMtn|
zIL+=4Qi3bU1);E%Or&m;=7(Rqv=$&qeW&>rYN1Y$`wq{iv+~l*jxNynylQG}l94Iy
zjbcK={#|%bSelRdGe09$L-u9Dv!B{Z8?uJL$;)NNB@$q_%Ux@P#x!f_&5}Q+ZrvLm
zj(jYvK+~uRJtc~Z`;hgZ4Oc;osPE}vEX!TGynOrClsCuR{F1PUgIG7wkPJeRjNgt-
zdm*V7wLE~xB%&nO*d#BNl_^ZZUE#;LVAUFX81$uRS=V89T%%a)<j@vBhgApTU(*&J
zs-LKG@L*T$aCoS)g;x4>=&XLzDih)u9-sht!JCpuK;|WcZ8nTl3)`#Ku?UT?1_E&2
zoK%qXJ&Pcjox)#Pg>^FOJ<jtwe?4)v0ck2)B<18_3G)#7_lk=bktRY`W<pfM2-D>Z
zWKEs89jtl36G{lpT*%%RV3Yc>R<m}5Br&1d<XA!YSAIq4;wG-^>*>}>Lp>2Lh&Y+K
zsgl~BRdE|@WVIWJi#gXv6zIg8E_zlWSZ~OUAe<qmKXrSbvWTAJ;|DUQ;tUj{ZhNi+
zNX<rA29x^HDLXJ(y#mB2%ULN*Y)0q8m$z!urZ0<-Fwy`Chzt4rU?CAjhiAHwYJoCw
zFGayzb_Ak?6M~Ezf`YIUwG~`WT~;r2GmA%tnMrpcVq9_mKqSc9+HY2kSU|!z(&G^D
zT?BX_mofwRv<y+pI21HOf5duTLOVp4285~9xqJ7i{93YQZhk()u$TAhRHjb?<qfl*
zK8i6|b-(=vkheFr3xs-wPLNWEF+p@mFR3hQ>+0NM+Nyb;Ca}xo7LQ;eYFCr`OASLe
zgEYfBx=;>JZRNpIRGCV`ABM*_;YV#>W@Z6$@O;97*lKF42Mp&iSGad^w<j{%0Gbah
zdarVQ8jCmm;N$M`IwGU}nhJX%#3Wi4-j(cG6JW=2)*O0YVU;MM=KXo9Xf|!>R5P>d
ztg$n#aNC9&f|ReU=P{ogBUlfQhwwOLgPs@TAaG?bXg8b~LJ09(MjXG$^%nrUka4)k
z=$3~6pe~k4McDM-V<rMJWG-R3|Jx@-HdBfo>gSx|;!x0?$kH9Rj?wPXQX^-%3X{S_
zm<&r1<*Ej3Ic5w?@&=lU!~Xf<Z|*PNz1zhD85~j>(0}hJ^9~toy8u&C8srBdb_CGp
z)7>#2X4cLze2f-LOxCGEsOr_wj}T{a$u2e(`z#@yf=F?4FBwmSPUZ>WVWA#o6*&~_
zBA(0x@aI-DHrDd{2<wt9<+S9c6um@~@Le?~lz7BKW*H<g*Tfunsdb??JD{=x(n$y%
zA(8+BGV3ab@S!w3jt^eMrI1U5&P~|3TS}t-<om<jOVte%>POfFPb;4P^2uuwX$()q
ztNPw#n{m^TJ4?F-vI@q^!HzEaT%-*nfU{k=d*)YT^+{RAoGz2h<-A`dF^d3ThA<)v
z>>qpg^5vtpGj2_qH5*4#O7?#g-SYmxzHBe8+e3A5if}9&4@^z3;p@Wb0A^1~{mfKB
zIDLw2hliXrtvU3i<o6(eZ#JLI`RlV{SEI$BKlG-<GyKVkLGBGg6ixTrQaS1VIP|le
z!I1MRb<eN-GBhsn2Qr3vR;`y36K{q(qA2nayTv18!4>_oe$<&Rwog;YID`rv5Kl%8
z8tP7y56ETLXs@KhM_LsLX##MXVbMg^o+1n2u!aM3?}YwfycB4(F{B;DD%C6158ULI
z6P>J+iln9gLyIMYO6a%|2pgBHMVSPLh1~?Imw{N&Oz`2-($a}M#;t*I3cRdqP}uy=
z;IHTD3Pdwa@95HJZcQk*z#JT+nrQ0`bjiqDmT2bX=PzPwnkZg+_l_``kOi@nfvSR<
z46^<F%!8_Ks{aIj#87?rOxYS}Ig~L{z&2UrMd2qc1qY)8TAQR{<7dw%T#`~)8FHJh
zE^L(hk=kc7W=41ES}9x}PmT{NLdd4gnq_>-sXI8pkF3|kB}PRFD3RQl_}()XARW)d
z+o-o;sV(^yl4FNu)*2SLmV!Hqypm;G5S_pyyLyh^i)Oh+tW`ot@q3~4*bmPbSx(SA
zYyKEYAoQXNt1G8dPT&^gw{73gd0<!@((~8Kq!bEdr*I|N+^Dj#alBHJeb#smmNO4h
zCQo(8j9G<)AVH@U)CF@}Bbd!4@?Ap*qI1UiG<lDPebqnn8UmKVqVXS>SGDQlP{LD0
z7XCfGuuup6hipw|K;<UjP1+Bod4*mzMYDN*GFC;DSr4u=<otedB8HI`>R4bIDxhvk
zN~pQrG#I&r*(A0x3?(&=*tA20q^2$aotL7MNgv>|uVgvXj2{`75bSS<wSppwt(%wO
z-S9*HCBkv^)3W35I~gIpW8i2U!g{QBkB}p0SBBq9lmQ$rvwtTe9o%nx;88}*zud?s
z&E*P{0c7AZ92H9GTeRICwDdK+0*fQS$j_;t<kbvvT^sexOWYyh0=yS=JjQ({83HA5
zhqnYArkaZ*tjP<dNkVhC9`jEcM8jCCDj|!YgBpS|#{3#ov8<uR#{9htPr09JJ@=l`
zl$HvHOFIQ$x60`l5Zi5*{k;t?6-Eh*T#_7J7e|fVHh5d^-lP3z>S&v6>5w|$x<;QV
zs;YUHyuHUxe^WfuP;11^u&_hLt6yJua{EyJ`ss&8pFZ?$mA4wU8;lVuJ#BSzP*0{b
z0Sw)DKduz|zSb-Ap5nPvN^wz9TSV;-*i=miTu2(M06ao#a2>KvD(-p?Nj0s-;*ua8
zBZg_J){Wg)cd+~#^_m($D4r<glrCxPmbie#7wOb*?#~A5bZ!)m@CqyD`=~@Km#ANL
zNSzb#0^paGtP_Fm7V5Qj-1Yg-VgA`#Ex9bQl-J$gTlF-Pv1bA?!9QkH$vPh(#i^tt
z=V4~u6Uf>7z#AD`wjjw@{JHj7EMuon*n17999Nn;$FrEUYQpkINXZ$L$*xFRS$S`@
zc+a0ndVbbj>&qQ0j>(_7xE#B;@%%+f@RuvkYjd6AqRY*(Aj&}e_W)0d@Cn}I3s-0-
z`X4U5fBy!mU<fxedg6E@Y=(XL5p+b#6E+?q*d8lhk&Z8C-0ID03YK&UAiAbOJKP2j
z8x~JaDC8)aPN=W$)W2Up?RC2<lUu#>om)BzHdN2ET8&b|A3>X;%tz~WjK*x%mFaZI
zPSrZhGL&q`&a;=_2^eQ#V$z!Z>zl-0g3rIm-{Wls=0$N(?FHoI@Ffv)VW5=5p&bIc
zX&NT2TC}PQ^){Vf@b2B0*C?DA2<#C~Ck`kc2A7B<nkDitbUJ}UJLqT;dm{;J_c+E0
zFxanXUwIJ}+L}9e?TX=V-N)XboOlw03roL_Xg@oxW@eCK(1cT`_TrpSPGuUfpFU+T
zZ-}P7;MWP?EmFP#@Y%*Yy*apevkQ-RC~8y+Sra}ievE@U`e*N2{r8Bb-fS2GNzid=
zl86R+jAg)&-)fQM8Q|nM8keNqjNZ!NF>Ez)(Gn1cMCHro?_->q;P7x0P~0e>_EBFy
zow;*|0%7sI_9eNw+o_pc!C17>q_9dohKz+?t#9fa+vt{Q7dqi|pu#y*-Q!0>b)Ttx
zK)ik_$R9wj#znilC;e~-V#506Y0X2T83W}P&N`S3C`k`^f_-zQ{fLms{!dt4Q&PC5
z*F$(E@C@Irdg(2-x0E-?3ap?mfuUw_am)`4H%Mw?yP@vQL3bCZlQjN4=P?R9vK=%h
zGkbyd==5K@OApO1n5(|uKsGS2zkQ_3NS(J0pR225IC^@(vR~`!?h}%ZacB7Mw>-4>
zD?*33PzYj4If<I^D6@+U=}|(DOjVvVcfg>2{kGDCIkEhi_B*5g?>~lh-kF)`<HCbn
zao#pVU3m@fBHGSwBj-`>g7N;<uIeHYCFIv}@7t{$xf~uIL!5nZk@AZ>_wGHN+?obQ
z<XQVM((Z3r?c!FH*hNBxXZPt{3CQ8e8Bc_9<?;p!rk^{rVV13}nH)%VZGl#F?$INu
zNS9K{=(?g`_)c=?J@93efLlc416l97f08YWE3mH_{sbh5UFQc`kaDm5Tj$ok!5j|;
zxJD@JF5e_ypKM8$|DgQaNNa?b(U>39fuS9|baY#OSs^V;IecfVsJ?lv2?$rGj_8&o
z|0ur^Ep~;PF#@1na?5Ee*aq8J_KV{I*1BE0SUg#^FTT`s+zmj(8oZ<EwDtkMrZ0KC
zmvMD5kp$qu#(4)GAyYv1)2PWh?l5}w{JF*3Iigl$TtGH(Gns!MEkuu@Yq@wEaL23$
zo4pT;YQMgL=?p7p=eURaPKP^gE~ok%#B&f}QxrWAo7Y`tzb=TU7W3z>DOHDSbZ8mA
zbh8U)Qp&)?s87v#9}iFo+RzzIGBUED5BL++wdgJ3TVt?9ptbA7%D@mlbA@C#9&23h
zEjL-@9SvcfWzn?q!-tf)?Z=NCX+5Lqlc-5;JRvH~!?a$9Ogd`TwM&I5CEB<Rbq|iU
zF&d$z_2~6$^QSN!k^y+0tbq(-j9^foK3Dp+QAx2qZ%Bm^2Uzd2;Rv<hl84#jjf^nz
z0k26wZKb{ZxqjmD<4m#iqiE^YuDjNCl>t9ww(`y0!=_9iIL{t{37UB_>v=#Crvc_T
z>$Q%4)WlNJKQ<kt*Aga-pSz0}Hx#&1C}EMVFdFDd`HAviCu*YufjRfDE>6iXmd}Dd
z&w`~6F3h+-h%@g&L|9_owfmeqlkpY%d3(SQIjeEhl@_E9_-@NpD`JvgUgq-SvAXZ>
z;pVtG^R)ay0AdPt&2HYf@iWk&IXVy+HHskK7gaMwRWzSQQ@Jb_K+%<E-h*L_a81YN
zL+vvU!HZ925o^Ku&jUmAVnrKAS6jNT**`*@-)!6&cygzuiX-NiYZiHjYH#4{R8W^l
zocpDD+X7GZGx`szrEw#zx*)GWhcXsWv9lEQ6?4qr&__Xl4?_kTBSbr)B7Dg+Ta8dm
zi<}lMDkOxvQiZ+3WQg`=(X+xI6FEdv`*jo>QU1U`wI?{B{C>Qd{y2s@yP6&$=TtX;
z)N}=a|E}mZ-&Ou<^L)8(zs{{)Vatt-<flmsz-cRh<Eh|=v>mu4lX(Xo;~tp`<#ftl
zqTD;mVJjqOsUb7k>F+-X9U1i=k|}MMsBqwSW$Y@%Hw3Xu8V!!|@9O*u10gd!@#e8x
z{|ue;ZYH<hGcuX9K_|Y6C9+?>Nj#=Nuny5=$9+bsnoqinu6_?X(YaTzlA}x4jqOz$
z@ipAa)pd|C0@QBDxcu^%^oX*IC|XhI<9)Y>+=c2w?mhtEeffKIHR7*9(H1E_ISkwu
z{+eBmD(uo-RSU2YB5kr|Q=30q0kxh8Mh{5D3Rf+F4|ZcdqaGpFfLTrJv^YflfY?Yt
zj)=+{74U=tJok=GTE@?hWfG*aAo7=a;2fe&q<|R!JQf$Nqm(c+ac-=c*gi(nX;o^5
zRI$feJSZ%Y9g^p_AefQ>Bmy8Jt66R#m}e~P1DeWf<x~jHdhPwQ-L}ac!bjX@)IiPd
zwcAPOQTy$C^xre3>7FUqJ=$ids3IZ_spuAPH#l&@jCkuLA+%)FuR?9WKpmYfm_0Pv
ze$4=MnnxTKc>O*giUw^b0Ci)~HlRhECU#ZKQMZmJuy3BD-aH~-oTznswkJ)yWqd$6
z^YO{zl!{CFlm?spWcd4VuESNxC~*LT3Z?!M#P<2yxBdtMqP@gK%f~9gh}3@h^-3n^
z0?_=qjT1KYoUI0^P4$6OFT_*_De$a#P5f^QxH<Jro5*lCb2&=%n|N*(uD^uebq599
zj1#tds83u~`*8tHu$b+M8Fb+arFrCKZXeCq@zApE$&5ZW+F{g$IKqrtd&cG}rZk@z
zX|XB4tS?Ho3bjU?xE)vd*BJ~E9YNuWwss&7d?s#7jz{O{)zIJ_6i7$WU%xM2y0jfy
z4Zmy$QM*<64LE`2KB6P~u?{<oL>lJT5(u_KYhTDC#-9^Dj|kI%Re=`Z$uTk+o$+M?
znik!j(=zOSzwV$(`FFf%Bdx2xk(fSM|Ix!A>&Z*77w}6yGY3zi#wy&?_7-tW--rTY
zzR#Jrf1DkLz~`{BiBmW3W2A*z2W91Ue7}$D#xj@9B+d)q>GWkY?Cjc~w{6eI6~`$^
zh#fO}#Iu(NVV(*r0iabJQo9*OcA%Hy=Buc7Pyk?2>D;=HqJN)#H)+yjN(_=>_Fs;a
zBF|Tz*W2)H!7e`VuC>oLgjRI3VZC!>g%`*P7wQFRUGx7>3((p$h;NLy7*O%A42v#+
zFvZPkzMge7J#x=;w#n0Keg#5OQ59Q2Pc!FQX4gSRpTBs~m~VmPq5HeC2F4oz1{(vy
zk%t%PO*_5Nq-Ipy%m$~yyI$9d3>2b1&tuns8M8O^`Ax;GABkjtB#l~gg%<<~v&ous
z(X^nlY8IO3JEh-MT0%MHS12kKdiVZyv;HPpkBJ(g#c%WU6!YfL5w{~esi@x3Y{-9E
zPEU%KcShL;?p6CHn=h+n>9TUi7pe7rjd`~`I%kAo&m<%(mOq^H7!CmtJe2tuKk-VV
zfwq~aAHV`%Vzp8qr+WC-wjiB)0jV3lt>HDjDl2<?XyDMH?T~WnQ;6{ZJbI;s({~bY
zW6oC1*%pf%07;QgKM7QyLN+Y$ftrL8oDU7vI=`e7G0RO5-2$^*zi^ZJDU|Mf$75{x
z6-@+#!Df>aULX~bsYYZ-%eg6WrQI&k<f)=AV=X36$)u>OlX&vq`M_s53H2&x#a5#$
zzdIZK#IBW}c1N;B_PAw-%2%(Ns@}h}j8P1bu9p-v=KCcXijIfiue8+g9TE;av;uKk
zRLYt_VJpS-od(4Ey^X{(-DTrio|g=rVL{_vA&aC8jCM_b=cWz~3B<?6DM$SzduKiR
z`S8OApw!bjx5+@Qvjavi0l_=F6VYYatAq);%|@bxC*(Aj86;3C`wR6*&4oY3dC72a
z$f-_m8eX84gUQ;&7#B5?_&dUHwgEB@Z(`9as0BDBc36!FV%O>H{2?x1a(nbPC=OOr
z+r;V?%dRGFrQjx95qM5#y`2w7x|bX;8okr$93grq2>F)W(ico|Lh1f`An?ILBvwo@
zL=~2ueD!MKa@|ADpVt!d!krC|fLqA8Z`obtILD#{&I~M#_?IAlJrG#9B+RNlU{H~F
zSZhb!Oz`=&9TaeUy6X`<;F_YJ(&#h#!A>r+>=TV?w0e%_0Nx)<WPf4R!F*^6Ftrz$
z6q)5ZR50lBD?A1sMO#s`k%@m(yQMW3tPu6-iO&ZZ-pnTHuP(_4sw#kmIh?!TDw=~U
zWuM#C`5)RQ#>%=q18=T=VPbC1)oBux>jO@R{1$T=n-A|{5Zh~n`h)0>a<~;rUDZQw
zbaoT6WQUebYtb5>n6aO5h23vQUP<w{#Yg$#oW|&4&AHp?ieyI(NSsb<eKRpeyIl5J
zUW$*#rg01^Qzx`jHT3XEyIDWxLFmlEzPQWSwJxi9Pb-F;kA1u6@0Kl{v6g=A<5#aW
zTQ={fguDD=`AJ&buFH~+EJsy)<;8Nyp&lGm$a%lbF*&pcO{n6*xe3zrWQ`QAu#ktR
zFH<Aar!Ts6`70op%>4teD!o2bivtlpHXSK|8h?D|a2HAVrrc6SR}5x&*;-mQW?Bch
zY(AZ6`LnDEWD38Ql$?p0&OpbqMw3^BhT<r-4wpmd1`##g31VshsyE?F?t@@N@PUve
zoAb*is_xNtZJe5_;Ga#aI@#xJkKyw-y{Xl92H}So<8~Jwa_1#OuLZF<+f#WAmnWB6
zK;LK`WAWYVd)`iCzyqdY0mKSm;bocU;K0iAU}J@2v^5m-AH}K@ESMvl!#>a+@6YSu
zJ0o`;OxQKJs$CH>UO7hu4{4PF)*t3A{9W<0eBdyz$25aNm{m+MuY~Duq#!01dI2N6
ze|V)W{lj{CLfhi75sNUIZZSS0Wo|-2x7OLh&9`jYgwLg^96NVJY+a8Ti49s^a+Z71
ze6<A&Fw1qZTC(}r9>+FDbGJEz=5|9cU#J-#Kzc_7u+G!-Dg%8SWO0%&Or4|0=Ii}&
zE_b0}o_T!^u=G0Wn5ra3me4Sb8;RvRW}@_-{NrZwCa*%q?+<@L+PZ_CC*@<?ccKf8
z4pp5y@gu5p#2hlM;Gky`eSYQZoo}ALfBCWr3X_zVB{Yfrc3BK$zWdY~AZ``a!^7^<
z(HO-$uEEEMR9KtEsy*XD3)wz$new=1yhh$fgk0hRz$B&I%fb~Nf9E@S2229yVSuL*
z3MHzBXf~I380B8F6;y<qS!h{V{iSp;mZeoqv?h*3xhpET!%dT7>&y!9Q@zeV;*KCj
zEF!<6&@c}!SU0ol)>{j;j3!UMcK0qJ5CMl$v&e0a0%~X~KK}jpHU?R+86Ugm-2v-T
zcV;Aewr@eQ7hW+Uzqs=pb~Uu37Q04UAzP6(Lfa4qdj-Xx&!5o7C{%r}m1Dx23mc^+
znq@Z;(Yh>90>YIM-3s02OmwU{FlOyCpR>Q028?2fVT|#V2j}n;|5$AA{em$}eIRbG
zMAIgX#l(w#l4X2nOC0Ahv<^~EG?_?WwOXT2QxQiuZr^s3SVq1kqD3Na%y)NB868B}
zzrwWg!`IJyXnmcD&b-+<+rQeBU4MfUZufef6Qpj(D_feG<<74-8WYphDxovVVHb>B
z07VM-bmJQR3hFhvYz2JprgP_X$Mw@P1CVEYtvQ*JUk|1m@MgqYPy`7b&@pk*+P}xm
z^ma6<v5&i25R^ju;gk3Jp<cq{;M8VO#sF$g-NWVAGFZpKT|?@sx-;t8<)Wf4XmaIw
zoSv(9W#*q5zjy8J^|3J`IsRfB##o+*m};la$#KBNf>)DVb&<OY<VCl~-51-3Vd|Y8
zbs(05h#NRKL<PDYv|F|;`QEUlHEV(EIA1P`WhWUs!gup3+aMuA2npAiZnwK|Cq81M
zIEm)yH7U8Ux{c9R3hGL28B*iS6g>~@VLt1-BE|<?_)$-4)vtX*7kvB3xE`DbezfuL
zKUk7_4fuA!vSoqfAT8ziE4)V>8;Q=1iD8T-JKyUw0rd_gqH(HiCD?qQ4lO@|b&XuF
zuqE{z(|vy|oz((B1patx#$VqU#ln)TGrCq4RZ(n_B;3#BzM+FdIMq7LtT_tS&H9a0
zWrHf+>#LRLuPAPP_=afpZ;kR1ygF<7H<TL-oSnBp5;hOofJZTxb+e!LJcFc$i-c&z
zsJzF`VPSJm_#SCc-$r%xyVGX1i2PBHZce5S8#YdZpSYb$U`yU>RdzqKPQm=ZU0u+V
z-h6i;m&HD3m9e#@jV)-IQ2l`#N%B?zl@VH3MHN*E{zzP}k=>QXZqA?<Bepcz+=!l+
zN}qMTOJb^TpJTf&%<xeQH5}ViI__YQPd2gK`N}zd>8n}*5<;on?e;Ta9{9{TM9>3)
z_g}F&h4lzcA#;$Z&%3lv!DuVE*S-ohb&SeaorY{(s5STWhNaAfj-hG5PieK%<P+A{
z@Cl-bdN4!lnngxyA(H%B5=K+Jo-K0W+;io=DWBLp{J%iEZKGGl=euK&t?C^3QflrC
zB)oFTX0^QCe5Or)AF+=at{nSV03k9vx(!y%BCv~^vAK)?dQuPV3nSWFFnXY53E0?b
zgyImEF~BIKm+X&-kma}pcbP#soj;yMMFu`!#Gj+X9?La`UqKAn{I*Q{^hSGUNFFLD
z*+^1o87>R5K}UGIEvO*a8>ZK0_-7UwmsYU__3nUaU+vjb^8E8xz5FK|(S_A|jX$&G
zvDJsAkh*~sygvD5rF`xOt_>;op{bnLrzV~MhR8^=D-|zI&5jD)cAq$eQsLp+qw7^W
zoH)!&YQou*Mrg_7`~CcXNdzk2eC@@2A^|1xSwvS?xX36!MdV5UcV7xwM5h`V$D1v+
z^Tsxl(weqtfvamPehP71M&b8ZDQ#oB6o?lC{nX^V_9$ZmK<MFhcM}P)g=Stf0^!f%
z;YIVye6GDXip5q<ujwbOCsG8Jlw=wg7gR>nc{J{?D*pMyb}1_={(b-b`mwz@z41X4
z{Ov^g@w{qXEy>$0V_vM)6#@X7oOH#?Q*LK*r=kMt+@*`oy5A<+Ib>4f5aTe<4R<_3
zZ>yzc6`xEml^y<NBhnS)dGBOwgO~rnrm35&Yr^P($dAxQw^iNKlEY2;O}~UChGy-w
z_mGAz&oakB=ygAM?v{W~H273pR0d1Qe`x;~?{C<c^A}}gIS^#6*T&PotuKw>VB=`#
z2LxU*)_V25YE0Ftckf!yXTVCm8Mwxk(yHMsjX3P@67~`F_6o**_=##1TFz-8^8VA^
zwf$OqfstSY^Z}=?>`tbw>zk|Scd9K0d0X{WhVPs<C@z_pkBUM{c*A?d15IWBSRV=(
zKnnuJm8Va8BF!H*FFYVyYhh8>-jxn)7wNsRwlV(>O&B+E+42?Dfa#39IeVl`<;=MN
zbdRsEo<T2noXgHn#zu2+p=GxjbLX}SF`4D)`~|Sa?wr0h;sJ!>ev!fYC=ovv&9<)?
zI}N8+WLk4mzA1L?>WC^xmW+Z7dz5@h5)<P3Ca1zY(G1b;`?XZvb3^UIJ9`%5LM!>C
zq@-9Me$cjva#=;up9=h5s^jE+2ge?@PEzRAD^QGIm1D1<6~Gp>C7Pn>O9c-eAy|}3
z4ai7SIlFx3TGK)?%8*5F)MAQ8TSdJr*CcUDUIE8LjNEv^gbIf0TPToNf93HI#w2_f
zYS#Sq;m^|k9a|CVnlrzAXYYre?c?n_1;PukaiXzC=(qcZ)7o$Ue9Q3Olh#HESpKl_
zpO)l5vE7P6FDvuyiKoOx2!x`i#DyS0?=9C}=&LJ^I``Il)j&mm@nku12F`03K!0SJ
z(UXgqY0L6#)Pk331dO%<tu8>gDCozuc?WTGYwv5=m_c5U1A_tkx=-p_4rXDlaLiU?
z`yBOc7HV4~A|l>Atxi<6aE!H1>eF!tOJ|-e8QA(x*oYS7DYM)HWHoKEO}ygK*7}!M
zuV44k(4b0+v=9?UE#)0dY&JmxtW%QZvX}~<p2c{~=tvvJCdT7+f;FA^NN_BZ?S70m
zqXyebKn81A{IS!(@J=%lvovGthRs-TBeyta>OS-X1?mHfPySaT>;(km=IyQMc04QL
zNb39Y@|Flh&saQYDh|B9$sTc9o%R-aNi7EemsoS={(Y+sdz>NBw|vR!I@uoTFyve9
zt9{c8I0qSTmbC_ZBYcW9xX{vLBx6{R`K2_pbnZXbf%8oX{EVgb3C+{VZU?@yu$p!7
zU;a9Po%Y?*egg(PTpacl<WtsP%JxlT<861pod`nzxqy<}{M4}h3n0sSgJQQrh=Nt5
ze}(R9sv94$K6pL1-G^^h_d$V&KDyENYgd^5U8ZH)XK;uKD8|o@K+Ohd{wnmc%&E+o
zy?El^S6cLD^>%i@)}0RCr=_X+q<q}wL=L+KnY#ktX~QU1UtS6LsdjjqT>wEcTxhmG
z$*%REoJ}w(psKlD%IE=zZ={&wIdzAxy|_&5LsY%7;%_=xa)i$Q;FKi&nFrfPL3Adp
zT0%mB9@BXkVLSvhf!;1WD;7M37{)@{9Xyh&_-zB{$Ut{kpj$BFD%J_4KN*RKE=@*V
zy9bT<D0EyM{Ii+BZLDyG(+N6;<<l_VaxmR&>U=c7tuV|HJJ9A|>Q})7lAS4$L9g68
zZ~jp~w(5&2KcY3(PtY^_>g^nX^ZBrMSeA{9!!GmJ1tu((qOSSKvV#%IzO#O%2(D!$
zdp<Q7MYbSfW|OsA(v@vS_QH^UY-p9NoC6~-cTyjK)>ob#fs64n;K3p{U!93704N!2
z>jOnHFXY<g1OMR&6USx3CN~`)5rkXbjtaG1$C5I4o2o1N7wN;S#51HF=Xml51CiSp
zrG5S8&3%fm>CBPGp#(!ap)iiE6&35$hsxqSfO9qAQekDp&;hsoN*2chy^l~1%1#XB
z91}1&&<M;_Ro%cr6%^+F_FEwo@*v#$=>8`PCEToeb2$=7IxpVc!0HrMVfp>IHtG};
zrdH5DgAhhmsOiZbk@~U;4UzDpFi?(qfd=b@0wTZTVr<5AQ=}OA3iBew24e3|kf}(t
zHTRw%DvCn-aPE4V;{;ap(&fx9+dv2vmb04mh@cv=6nt+lJ*%VRU-ayo_A2*FRn4)T
z+z*;I8OS0Y!l>I*O{&56l?W?q%J2CI9s}0usAm<;<Vp<VoCOplJMznBfEb7*<0pz9
zm(Fv*<fs=X@s8Rv?+yykz4yuHbV*aIDVwdZa1b;XLH#jEc0{WJFpC)w$3QRW+Kc7F
zP6+aaQ(vzQXdyiqlms1)qW37|zLj$bJ*OO>AnyQpDSX7D_Q2D=)Nih61BHeKeuQKZ
z^y(-;vXxqA@n8@lw=nhKZGN(_v5+)CB8H!TZv?|?1U}*U`fq$``w;*69!Z}!HgdtC
z^?GTQQgA*-cj6jo`<H*{RFbkQV$F6+DXAcuyLhzmUw^Y^9Xd0HHFzIj(QZhd@xar!
z5@6)o)PU)z;K1ze0T-k{$>eqLBWeyME`zy9!>rDeZ<s*&g$)jiTY}=zffNu{%Q+*}
zU@#_Ar$&PN>;pM@_-!yND3Mcb;o`a?*+I&qcI)QNNb2=HK0ZD_dd(asE(&mjE?`n=
z3vYH5X#|zb9>lLm5iHT`xDfJ!@%#Zq0)d_Eka_^86BCf3nO0VYya6G5APAU*K@fpI
z+kvSYQ`pZopblrIsT!d(IHF;J*JRIj0UxU(U{uL`@IVn!145}rTHNsH{LobF1$eQ>
z&<Qa!2fG5gAbp$4?1O_|xWOD`vodZMW0hc+^Nkpg!29;>o|FJ#A}SZOR+aZ-+fWY#
zGKx2e8OC_1q&w*y9pNh{lI90OIbo+cd0*y0)HlbUh*Xq%dNSA#G}MBxi?WYJTGzT=
z3m$x9$9t7qS{-=O1fWO2bd*`cswj?SdYch#aIniP+ybpNjB`x&pyWv9jR@?0+N%nc
z1OG)>V2(qPD>A9o8XKVJ8>=Rs-sb?fNV|dKk=>I?#l%$H;)@plmBTuVarEs1LYYmz
zcaw}ylM{1x?z1@AmJIZU%vOh7#YigK2qqglTX}!H(gML%ao!w|ciGQ&;w%cBo)oKM
zzyhyUb1JLOb8eY~_2<)EMIzi4ejRf5MSATUVZBa+Zm6ypjo7I|*L*Nl4o|K5Pqbg_
zmXqEDmfz52hnW=@SKi%-eaf2Cw#yPU>^FYx&kU7pJ&TL(7C;*jg&j!1$c-FSqM+nK
zRYUGHU0t`YM@k740>T9aO`bES8_gKBBV|5V+^>XqrnW||*O;h70t#Kz@TzJZ)q>Y+
zT>w&J+Mc(z?Mo;{5#0M&s2#sYn>m4hA$j#Xrh7AUKHaa*x_ihyqh|k+2Biy_Y8xF6
zil8N-yf&Mx?FPctP9{L-&P^!#8x917A^FIRdT(k~flSN>@G~(um=y5Wb(Faw%IkYn
z5@u-H2x%gp`xj@<_$ykY=&*i>Nq@c@4YwdHm}-@-|4>%ef?hmzPForyz6uDx^Ox}#
zHTZ<ve0`h!bkB_*?go1-jVn<WK0F=Trz@=<uuG8vO$_}A@>P%*dJfMC1AAN~b?^(C
z;5~ZSE+_BKon{K%%@@6b$e}Qo0p8@*^h(2(O@~pzKF59seMoAAPut)@MbF4tp$WsU
zm%_5NgMDBqZ$4tO%EVy{+ZY8j{f&d%S+vuBEy2!^nI-iiCJJRlA5F_Ga>TCZ&Geys
zLEry_e_yW*-oIZ<*+1L!3UF!VrDJE1EOxjzB((30q#|k#!*%P<#pzz~Jb#IAy~S_W
zvalnF_-V{~aVMShc22{>r0s+WS+g}p+^tJte;FeMk(_oFRlbaV!pxDb26veiKp=fQ
zG_}&kc_S~KdDE*h7dSen3>_mq!^p22=WcroB1Kt2CHL>5$iAcLl{6XAT&~;mM5u;N
zv!bqd(Y#Ouv`?M0L_2%`sAW$#0TKR_ATsJ`a#>Bhom;6?vvN({OdA`S1^oW3p}u#a
z<*pnE3*7Mv%fCS?81fM4G(e!}wqWysx_Z1HSHXSM$s5V)w#|M3?u$EbReI7fZyN%}
zjFlB@!6q4>d9e7?Vj6TN`)$hRP%!0?3hx1t*|Zt-cCc(H^p4aI_WMW)Sow8WR0bu)
zwY<EfyG<-9Fv!7Y9@)1*&TyI7on9i&sc5~<mwY0_xU@E8IQ_-*=l=tKaE^%HFu|Ld
zeO}!}l@2cZFBPqgoWagF5;dxHS+Nz}@&WU<tCqBB+622SS#JCPZ&M9s%?hy_5f+Z@
z@G@_VsI&O*cFjQ?=ae;_?Z|diX(80@E*+>)J8mOWR7koXm~FizJ<p!DBDZ4uWX#zn
zKPVdvR62C?da)KFnp?u`G2_I)q|VtzGUBkhGa=EKpo`4;RCZ+Z+rgFYW(hy?W_Ej0
z#U|PvoZ(3Ch972=7j%Y&eD#xs6!&wcA;JQ$xE=kcEoF)Z;}RtSvjL3+%tp*{otjGC
zI0)YNxAqMV!^~3Kn$SyLcUW=aEZ$qKsPfv??bU;=C-4_{-no%MTNTylF%gtevKWU}
z=cW)SuUD?Xn}To_3u7m%X1&JuMvqQ3z$e}y`okBzo*OGv#QtH8Vw+|?AYTocU6DtW
zW1?f8oE@N!8<}&ry$9OYXW))tz}-swt9@($_y*p7`YIjfqk=I%V?WUvQknjY&&+7F
zzUrRm(v0MK4nkv1)rekAQ+d({yhhp}B4C{2z=Q0;^XNkG;5>eJ*_Y$t8^2dgCM@ez
zjHj001sm(gEDi~ZFk_6xC}JY4T8^;VG}fvW(Ft`o*fuX7Sg*Nvrq)kkAvJ`(P0zY7
ze}%T2J1_FWx2g&Ldd-?NCI`zl0c72mEDqVs-mKP$?)z-cI)I?&MVpr+99^xr{YOTR
zw@4Qb&;iip0O;(X_H-L(jMSq_y7}N2uz(XO)0ic1!(dnk1*8Pxct$&dQN!G~Rc~d(
zn~<*m@nYwv`Hli%9M*ZWF_1jCbxzegAam3!jNo<MsekbI1<_~d6Sx4IWa{^n=Z-!y
zL&Vnz@az)7O`~O2!GeUNnkAMj1ZuyQv>pssIP2}bLKW0lVF9yno;~pO+`%%9l#-mn
zvosjMJD|w2dfqDG!K>D4VDru4Gcmx_zWL>e`uqPeiWA3V$|`8|qL37{9hUziUL2_B
zjK}?P>im#FgErG*Q!HWm0T{7@Dq8A-nHjJ4aeJK=9UQ$~Z#xvpnnT9bGi=;{%k&c9
zFdc`tc^;rv=-2Og1nPSJy*>T&e_DWQHNTeBS5yQ~P{qj;;EZu6jo;!urlQK|(2P|-
z6k9eGOdCeI$I>h|$s#J?Pd&S*c!sS{w`rF!)2+i{g)Xhd{kQv_%UZS+ln{4fh`_8^
z_20JZ!f0>>%3?3Y6m#>X)%D$(9qS1HNB0;_fym!(K6lf4q_4zVT9WM*Y5}Oy#!!81
zNA|iA{yVO8c=D-J9Z7EtpQ#g6ucH2d90*UV{qcdhxF8yfKD3J99Zadp5*Nf%)wj&3
zEP+z^_!Bun21dkxLmm)u1kkZ<=7>FgXrh%+e=xroJGXV6Q?n>OWV=d>b$l3P!7qJZ
zze@5S0qZ~WL;I-9-u{Qq+a|{)RnUp0yp7Oz$AWeH>@^PczwaqW*LWasiASP;ipST$
z2RNCx_Khm};thZcIH_Zr)28W`u6kRYot#_`$7h0=whu9BMv7N8<RO9Szuhoi4D;yH
zP<C*=dBuG?x5f@Le*Lr}>!yk9X*zP`uEv$8Eh(Xe^1-trHO0P>`2SMZRX9bd&k#!)
z@i+tCXkhV<KFS0zT1r6~oPe^owzS+#Q{YJR;Hg}Uqz1{Ur}B*1+zyb?a@H^UwPYL&
z#z*Ve)X8-#Mc4z<PJQ#vq@VHS|Ap53Rja8cfnsFI3Zb><|3WJeMzQNi?Y!ZncIIGY
z=?ef3@`L7Mekp1S+GW6hNl1sHlT?eokzjjg4v#?G$sc+igc(Flx>~6L_D1M&3c4*m
zJ|xL@KiY&6%c2oJ5Ld%NEa+LPP&h@Vr3F{$8Ur0H3!gd)V1xI)?tOYOhlBLGCpb9f
z%d$Z%;t(AK1WAoni4ZUZ7T`~$0ew&%4lAv6;CKM#8qd(a>mVLm`0NS8fp=_6dX#`O
zy@{91WRwz)15W)qqY8x{JqQ>(fDdY=;npsHPcJg<)Q-(v9NxeFVZ)n6<mV#FzU<L6
z2l3o5J=^CV8~C?&2-(8NuWeL;xM0a(A5L-xM$n>HX#Y-90}-YB3>ne}91QFi1qyWd
zKUfDu8clZdxyP2>mMsq0i4m$@2Yf9$W8}%qflp2b*^2|6SYgB#$8CUQ(^h@sJ}rLt
zmV-?LrK5*g#^>=PMtt^Fee`5wVw>ed)zvEx#oSE%gP<vvmnY87PAcL-413?%-qv;(
zs$STzmcBBjwaHKR*h1IgYBZpJ+24G6%3cj*Haw~3Bp6&KGai0}0aG0}F5{tUL00eW
z;JIk6sI9o-6zbH*lL0sPjZ1zb;55Z>E^qPi%Yp{+5rzjp5Ez+GSiPE)6PNS0hky5?
zeLdd4d-weHYbT3{x$WrH@>DvstgcfEJ$$&Gs@8$2=jgz4>ARmp4pSwG)P%Zc5mF|0
zgoqvv+T3~NJWKPC{}r(@rHg4ZrQ2bn>w&<lx~MyEKq9J7#L4=^?2VDPv^2O7V($Lp
z?b|jKPl!g7raH%;R+>$3g%FM@>g2gQFKV_9m~(u#ctR^`*v@&olxZ_V<gOk{6R=k0
zAFk583}+1`NE|P=xy;BIXhfpOW?a4p=5Sjo)NH=7my>!AGqqOK2N{%P-N*Jy$>|zX
zRQ93ruc3lL+iDaq)=bXI@;;oOw~enO$~RI#+qfjVnp3mhbqzi~o3c{YaSCe%2+bJ&
z)RYe)#6MOfwU8MsfHTh?#Si{uWg76^*j~Sqce&&adL3zEo3X3O`E+&Nvx|ngxw)gh
zZTZIXE}5;V=+^uLbA~FaV6<oiw$VPky!Pvat$^ZjGx{rBK|caM>jO88@2bJZHNz)~
zf)E)GYq_9|?B-}4&U-y_-TH^%!)9SxlSWWL9Dj2L_8$7j^mN4R4H2V(>&>qm>4SvK
zKwn?~glQfo@brx&+@oCdC1-zAX5Th@&6Md2V;?#aKsNiG#EwiU%XI40%|@#C%*+zU
zXHri?TcO!V4%%Lz0?UGogqnq5wB1P6fN`>bpQs;4l%y|+rS4xSHr$3baT>T=%N<u7
z*^SJ3e7x#P1D6li@%G|l@Q;?LEhhkecZ9HU%&oG5rWLb}1V3!DQp+xRUifEMxh7hR
zjKFWyC|58Nt1?zd&xk8Ix5DS1S-^Wa>Zea%qp1Ceoo-y|$;zAmi>0@!W@VfTh_sD&
zQ2H;5_M!Pf{Ha;_T6a!*Qexs37QYe{>6;J|2K?kA=ctbp9T5C^qxRc<sP1uV2z<Zo
zs+$%vf~#B;w~V3SkO)+5f=*Z`Em*W@cC_OQasS1K54@1hpbc&_Ck*a%HZ?P&Q}w;4
zadB^GXba%*HS3#?OE`9H6Fav++)HiTC$Nx#M~q^CyN>&Uhs~#xPe7D4DZ38mvRPAl
zZUIO^EDz@vhC(O%_&r({aNLt^?nWdbg18;lEC7m?W8>h7&YvI6OkK8}?tLrTddev}
zchBnb&0G<mJv}ie*@P;Y9NqWZqWiR1TzR%I`8jWRA<9^zt;Ej}%GpO}t*si3UNL$!
zg(Xr*(NZF><;a_Ny@z&Z0frn{=?W8#z6mQtAb}#6!!dJLU*r-Y?vUMN(Z4v;Wm<O{
znK<wiYqpANH!z}s%(8OUPy68xdrAh(sF2MLIrpoI{<O%T*2E)0jIH^U^Y!BHjX^Bx
zHzj_DN|AXNTpG8c^NIv8Bfs%KqL!o67g1r(fOf#OO{MpK^YtO732l4ob^s|gz{W4`
z;2;IYFq@NS+598L2_tM`7bnYk9#2=&T!`GEMNsZF!rLS7_^ijUwJ5+WyDn+hYiu`U
zZO(eer@1G-D0ePnP72{84rSji{Gksmz`fd3;{T8X^qZrV#SG6+uUaA4fK>QZm8jm0
zivvI3{bpe>y1BNZ@65>=>7TpUgf1#4xH8Mkw@*)dAd_vp60xl_Ue&GR|03o|EUCzf
zBb0rL{Lqw2Y*bLNjQ-p&ua@DLktUG}{xw<@RC6*sSD!eG;#@^TW7^wP>RbaO#%q6n
zaRw^H0ObTNB7cpJsQEqflVtL4SVR<Rri~;%$mWXoMv;>R8KU{KyYQ-n@Fm+G|J7R@
z&|MKV&D3rqyDeI_YIV=^_eRj91~`6@u3B&?xWD|C3hlVer<c}uGTO@P(Ny+zT1XvL
z!0_6gj%S}}>{G{8{;t0#Wy>~XdOm)X4mDPn|LA~1n&oq|PtQ}TK}fq589c*xyXvl9
zNM-`11C~7F<L#p^=q4uEdndIqbkgb$z`<>6p}K|Qg_8|=PpY<8)4c?BE#8769VWk0
z9bc9L28gkgs>Hmm+nmc3B*V$+=J8j(8@@fW30Or93UB_LN?2#3H%168n{Jt{=r^8o
z1gc|x;r7~j)bw%l^Lcs<z#1Y?F<3Z4NBrVI@%}ivR4ztHNHbr<&17xf)8Y%yn>TA_
zpsoluq_e)yJpcspS70MtGkLm#r$929e|c5e8#e<6%=@A(VHRLJ%lbgu+rAm0ob*G;
ze#S00=e?G_B4)Xoy5tl@M^1X%9wysmw1(&b=z|x1OiyUQ{1f?#2LW(!AaJ1v<!1|3
zLlcvocDWlkiS$?k;1W0oGkz$s0`QOfj#O<sl22{d=5ZjeURBv$0cUET`~3PSKil}m
zf5CJ31~0}C@iys(qUGJIXITjlD4(->=m3BQu(0(<)#7LwuTri1;Hb5xXZ!8I$%*UD
z;%<rNUK@ek%g<loWJktDpA5eY2IPwWc^Z~1GJ=HRNrd>Pj_nmx;i9hm^y1ne)Sc$C
zxQAl$9wjZT(D*1IBrW9tr!Dm4Qz9)aY;B*mIa`B)whRV~8pI8o@U?|3FE59Wpt+m<
zc0(^_miVI>qOlc-ij0R<BP77?GSvFpgKX45gP5<umU#++&izyUTQ}0IHgQ{zSR*ig
zg|6%X+D*$cNsJ%v9MCL{{W6p(1)-4ymX_fK=CcbBkP1;i+_nC&L6-Rt#Y2LFJ4EEW
zFMq?ywqm?sJ&U%%tuPr26qZ89TNXb&-aIJYog!!<CRFrpaY%Kvl(#!A<c?Ek2g<|{
z&xIJueBEZWUqjBGV6+H{;eD`fS1{6QBoQMGUcTweq?Zu)7ZC0<;=e-__E|?Fkg73M
z<pO4b7pu~0`)%s9*IX!hNHS9?7<=KK@TWYB1nPh^Oy8C8??d`wHFat$A#I@E%fa_u
z((1Xg_vyWewT>RZDKg~=3cCjdlRPWx_ykm357=z~a=C7e(r0*1VK%7!qIkT8<f;Uy
zS8W{klrRhP-L`GylhS)MN(%L|2r{?eA|RI@rg?|QZwSYhU<&1JyI!RnmT<?HAL#6E
zf?*5TexaVHh}F)8E8mLZVcDLbF_hKzXbbfbVAYI2($10?ETf)gxyLX#>y4x<5c|D6
zy$`EEyY)7H*OduTS|X=~3k!gBiDEl=N;hD5#3TZKB#K)-(yatZg(VV*fC#SU3=$~3
z%9K?TG(t_8_JS8Qfa3W{X7TH8K6@5H&{Wdto8&4-7*uK^^>rM-`#zv6H`0Q4O6I%A
zJaGkDA;>&yF%zoG_x>>v9_F1+*Z}cm=NZMKGudsS7K6vawv1&_zHn(W^e6{y`h@zJ
z;#9K4G=gg^)zZGxr%&7E{)h*a75e%F)h_j@5uA%0WVTHy$@FPuX1ht;0NA(ynVOTC
zBF+#RfY@gL5&2iDtJ1LrspIOa>F9*;Ji6VS?^k(z*!M-*YK2`g>lT`Hd3Aja@;@0E
zC>6^kz2-?fpd;<OjrTg|toWT1`MCcrbNzp`O*E4_e>%(>+y#Ia`b0}X6io=AkffhD
zyM61{=RAW#&+q8>*uHbt?h94aHeeTOAwrb`QHe=8w+#2Cml#TghSt2*{S2xhUr-7r
z0`GWq-lvVIm6&qIAlDc}5vF7)@0nI+y|~qfWwXIrR8&tK`GrTcoxvtL9=F>$hlVd`
z0*6=fyh_O*K^HGO&!g>rh2I%sN0iaHSI~CKRwngc#eNwEmrr>O0_uZQXn@J%@8o@h
ze~^Ae6Es=@4=WG}wk9A?0+Q<C<mJd#i>?2tIW9b2Gh9Z*=@lR4UtNtWKAGszDJOrs
z+@Vz9C}BZDScB%=eIWoM#z%l^3!R)QmU>g!Pvnm&X4rz%Omz!+kgq28oPTMYa7Xv5
zbD{C63GagXG|(=_MQE)~{ISG?)N<#;kH^Z|?3yp!T=<W$CH$}JMG-Il5yX+7Jnqi4
zw%!I4Dl)A|3lK{*q<v^_$Z+9VN%|_X1$e7rAK}=!bkhFwx{zH0Zg`!pSn{wZ^S3QQ
zQ(4$?nXWr5&~Z0K>#qz1;f#ua4^8%Ez?g=*;w;2{>U<r8ejPWLXBAKVIgYXLfy^q<
z6J!+>&Fd|{h3+RK=-XOhiGUfwiA5EK<8e<4Zr@q0%;r%c;%3_n6X<u(vLY&U)s_Fp
z=nn`=LF0K9TB(hq`uv3r+jbrMyYA}jvsdP)&QY&(pX|#Vgay$#EbywE11iom7RJeh
z@oKg!@Tv_66lu(OK&39!>t$+6tPysYk)EEhadCSYZ;`AfbRx65ku<s^l=nEjf-P>P
zfB4UF0JdiEhBiUopfaBM&(GlW#1okTZhnH5g|aJ}|8(xuX(Ah@9_UTn5E2@SJ3_sY
zkZ&0m3c81L`7rlY26FIY46P#LOGz||ssPlwGQ*r&aVaSTZm3*#VgbwUW$YjT(-l%x
z?fs>=|L@3qZH2<yXC<xJ5egw!l8*%2Q|akNPuc&b3#1!O8#&VDcFuhncSS^4s5!^@
zHjxhF>ED@LQ>6f@{PW@{YDJ4_)9$wUB9KM~HItCEaNr9ry*)6fbme*ShRnvNp{n9}
zbWLCS$9|dJ1^)5;vlz@pA2TbPwR)p;{+rV0*k^owb5KU}Jz@r&Wsdq*etx_-Q7C7t
ztkCVrXN-jkJDf8}LnDrw`aY<_F)|0&%t!_!F)sM@@#9f8eiZQ4%c;rWh^MG4zD*wy
zsjs3EX)#5@7w@+Kl*$z|4;fik0;@cK;ey+Rspv>8%jz){cpmcMPrCukv^F})eYx@j
zTb;`9V_nVQwL!Aw=kgKt`Hc(R-KWboj(d}PyIydC+CC_S17R}_+sAO0aMHB7j(>)l
zD3rGBZHD1Bj-DEmi6jYQIUi`9xcZ&He*3nM9l!h^`6pCZlUD_T$@B}&8^k;)Wm!2N
zxSD|idG$-#GK0;%DXoZ%WDDFNL$uVqO7Gos9gM|M0AB$5PJIMYQMe+>7-eB<+xrx;
zq7+DZ*K_GHk&{p)NhpkqK9GjWxDY@=rs6pm(<lpNK6_0~KV@vS0|CAbNN%iVznDzq
zDu)b-BwUrRwvB37qdcBzQ8{DW_9+^ng~u$T%RxHi-oP+wRR;dmj!5r~7NDD0J5Y@o
z!*R{m!{@-ENJwNQa3!`u`|<H|J$jaI_MSiFM!QZ$mM<2&nN`$|&_U(YRN)2OEHI|#
zJ4*k5g|+GFI`BOE*1mMq3FO80MWxL66J7j7YE-m%IUef!_gtW+_mf@3DK%^8JK<5>
z#%+Y4;g`i1ok27%EGDd@&WLL)rcS&2X)w}<Ul<t!l8AmEohpSlfHmuI(J4%QizI`D
zkXDj;{J3oB!YExumDZfSW=GS~(jI<03oB%x>_wB|ha@!S;p0y{WU;YE6rHxQZCz)q
z#ip}rt)iQHCt5MdxR>z&h1Cjgzmofa(WK$><tHtVlm^VBjG}y_G<g2*9UQZD+4__|
zGKopu|Mys{7Enk6d_CLPLw2d@P1{!|qBpMWSkWA*HNOdXj63`+pEEb}^CvU;PSXkq
z0M(^4ukIf>243#olpQ?=OqkGHroWKx%CA!0!oUlEK~~sMHZ>1Ak8}XkAFAX9<V#IS
z@&%t`<1faaniJ4x_;8D)_E994T1v5+BV`Z}vMW*4iD+11R($+qQnhDK*%`io_fHYK
z%p&w8<3L9d4e0zmV|G^yur~9q7Id8a@Bh*1a5J5|cFj5&L2<{hoM_OKlamFM-nEPT
zcP#blFL~PY@QEWvgI~`{ck4p!X@fM3t0o4hC~adeUFs=%HL)8c?*nQN#g<MPQc%!m
znRjw7Rz9T(zj~DS2J1RG`gl|b+^OnSXzc2d&cx;Mh#(kc5x5JIlJ&H!PTP$(jI?;(
zfYxJ$W?VzVW&06_r{AAyQqixEV#vHb^B$(P|LvW_tp#}ty6>MAIA-qlt2TwFf>+sW
zcTjFV#A(7Ko9*W6zXkTcuV&e*XlMENAN8pdKF{+H9Pww!+pp`^jU68m_AN8H`1Z6_
z=RSO?&wNl+<jSVDV60eI_cU&7V^wc%n%Lkr=-j#u^a%xQa?xk^w7GL^Xxy8nHNMC7
z)57LAi)vd;Jh<`b(Sf(!%sPDn(Zcpab|TPCy~4o>Qo%OYq4RTU`D)tR8BEtrfei-n
znIsdy#i<9J-@KlhH)`nX>Xof-)onZrrrn3j;_EePC%*k;n@lUU#PVOZh>(mkF~s9`
z&PUWnS~@z+PhVdhtSGQ#(@lURJ;pxFdtFxa;K4C!$bO3c_Ct;fa=?W@mXk_#;R41J
zgOUn2g5))Sklw6FzCD8HS<2Q=rd?j@H7~pxOd15s#$3P;(@C*akj@IX&xI|bbP>%?
zM^%rmZ!+1K8}{&Mf4hO^;YO5rPLnnj=~A}i^*)28krlKSwz;m_#N~x9E>kEJ-{_g_
zdw{^!hUts+Kg2bQ`U)_14_FG8K30~Nkq7{hXQ;BuI>j(AhrUA|pZL+NT)nzK4~1v?
zfN>e|L8<@X-5?VwMY?wxB$_&DlJ5h)IOh(8B-!Rperuz!H&MyW#M(BF*xxB4A9Du(
z=6C8>Ce(t=A=rtgYuXzZH=wZ!Yp+*&c=T%oFdgUFWdgP<7Wny2jkOXd1bXy+q%@#F
zKH;9Oo0YnC+s!9#<!eY-<q;S&ozf3Q<*c!vUuL%<4y!Udf4{hRV6ULbu%&S%)zfW)
zOB9GsY4}btq8x>P+&y}ZbAb<Dq0QUXr~nA(e4y1ZG3o)YP0d=-e;ws6zAXH0s~hf<
z-^?QF4#e^~cEjYu<Zfvf)*a%{_L{`XA>-xJ)*2%b177K}`_xxJIvL^Td5MQiu&VvG
z9zzp;#Pu)oPVXF0Uq@z%!v1-8X6E?C^R3%it30`#+Qf3(V$5h{{cp14aPxw^X<iL~
z*(kDDm``py*-?o>l3hrjCkmR@_$WzY22&kfx^`Wq9N^kqOo$sXQv7?$pI?wIHWAHc
zO7SDwG}T6}$Eo$gum$!5k=`-ztj-Dwk-LA{iqlEE!P{Qnr&qm+A2s*peBh^P405PK
zFZl+9Vt0bUv=n%JKlz$GX(J=?dD7C>K7OX#g>&Z)fKE>N?YDz;%Wj80FuBrnlXxPX
z%(bvbWD$*Uc!jc$Yos{waI>3k!VA)s;^BDVlulKj7DjB_)*Rg@dtT-op6+6c-yH-Y
z?_&DYLB9oZjP@XE`PXIWd|;sq-O^N3Q-ARtT^&3i9^f5IiH2KCc^mHPEmyOy2|AlM
zGBj$)9XeK4JzJNw3dt?qL*F-g%$R+1)Z>sLj9SwNF>3rJzg@Yd3PHJjWgzaNDvv+z
z{4pF=Xv_pukW1(0=JqMe9}m$~>(6p6skB_^Vzt3sr2~AGeH7C~5hFscMA70{BBtSz
z>>;O!OHfhZ*E1SN*?jtG7e9&7#!2)<DXSZw_%O+6nBAqL_#Awys)__6xjDwyq~G4P
znd@H9lYRAIk1@%~)4(GfeV3$5%`G)(v1Vl~Cjd3@qe&^P|7IwW^B;5KggN35%SV-+
zZZ|NQ*g7F8skrX+#bk<CG34cuy&Y%F=i)4DX=?TvA2GejX1Vt?nuCV_AGY2*uIIk}
z|9{(Lr;^B-B*_Y8WF-+9r_z#?gpxwYCaV;RqL9@P4V5jVGAc4E$|fXHk?awD?}zKU
zKEHo{*X{i0I#25Te!ZU0V?2(><8jRSwD|W=pA|rK*YfkXQ?6tacQ5^4+|~H?<us70
zm5og-$j<44*Pg-l>)iY0D4DfO{(@9NHkSA_I~>Sn%dS+MatYkr%n`;M-F?h&%=qy-
zA!E!O92^d%r2MNL@@Btr>zjp7K@}Tkw*NPv@KnvJ3G~lnu(t2kD4R)@#js)B-W|*N
z9~WR4GI<Nsa@cp>iLB?(LFDZ0eL5nCx>8xeHGgTGJ6Kl0NJK?-sigU>)TSEGrA~@M
ztnkFZt4<``%QWwUi0I0Z6tvUOxI+grcc>jj&>XOb&6}O(gCrz<o!R?Jp-j_Y$|!Hk
zi2*go;!c}qC0C8b*qbYs-K^b3$<O^HgNp5xPMF2q)6S$|4qpNKiKDMJ_LPr?{YFr;
z=FQ(iNg(>FP_Kw5jX(_dEhF}UT!pfJlgNfYkht~K{a_I_bMfNOgT1RQotzHTEQi^m
ztB|+KYodzj!txr9@~azDYkwW&81s53Q__Wnho^h5ven8pY<s#}tDr4gVqg}vKA7kG
zt_s!9kDy=IW}dJ!-rzBJ?u{)*Xedl+<#>>$6kqde2IJ2stMCe#JUex-i+eD^^|9Tb
zVMazq*YDj6=Sn+O)OB!jnn)2Ngb1TI=cG6K?>@0n9C~@?;8jO}_$Q%Y-H<&yLY}hN
zYZ0t|VtO*=e!ektv?yUB6G0@pf`M!M_<T9rF~z0)HR)JIU40DmA#GPzS6lT29e5hA
zFk0pfS~`^M=D>w9r~!N`oRa|<%R0m^>r70*`It7+=wPRH*lJ<_0o*tFVj3D6ugc3U
z`tI3UF=ngssY5^ahFjMbSsA{rn2Q?)VNYnjL4BPUWh<HO9mIoMaElX96L^gSyhmtO
zk_f}Y)z~|_oj3smknGw=X*)|`IeEaTuk5DiyN;cA_{U&cfa+yw13Ib*SEEkc(vWK5
zXOjt=2iYgVH@%A=5T|+r2#px+a9*s-y!o>hRH$Lf%KCW>rYDfSUzL<x@!7dl82-e#
z5%CSW_TKW_dCA>&eP>>q+sLfy$+?kKJ2No?FY98=QQ-KdA0KJ!`ja7T9QEA3+0z{k
zKwQyagRUG4R>0SMrMcMw)>uc2XN8CFYlAMI=2OsM)DuV?OiY{`)L<(Yl<;zUV&;8I
z>TbdPKyApp6Xd|crPSh?+U_&2wL8>BIdBZ@Tc^k`RqOL<(-&y&Sj1I3g#=a{hj8?5
zt?+ny{>$8~1+{;2%03Bpxfsm$ezt3a=<$mzr>%1bKopxAMcN6SUm3OS)YUmJ{aJ(|
zr+E3YW!u-SyEJvnh~m$KUlotLG)_lZe6t|959wHS`rNZKDyw`*m3)Rx7}z)+DLV`e
zo{hgIG?bl?)xWG>b|^kx*wWE3%qP*u?9X;}@JI4K8HX)?*>)Vr<=AR2N{V5;KoK%O
z{OL1irvOmp9?7V9dFyfv3DPq?J;zg8RSu3<7R2Gy>C>uf3Vvnawie1`OFBCo*dx$P
zTe$Ia+}*cxi?IzlG3#z^7laNBBdHq-K<V=i>{UD3rKp%Am=Yd++{u{%X}{_ptH>u|
zcgj4P{4ap^!i%Ym!Wby`zUA)Oy1jdE!!1gRK0`ypYdJZa_Al`21Sr_e*w|rB=`8#L
z#%PC}3Mj49E=!gIy)7?KuTIBzq^=35=ogKZ=*V7GR6O3k?DSW-AV2D4kySzt9&}D>
z+1ELBLDY!-R_8uK3k_w1$xsaHEA*=N@!~`M{r&IsP7uo=+VoH?%$eQaVG9YULoj)K
z3?{9gp>Gvc%(UROF^0{j0uI}L{;McE%FD|u%`{>Rc!r-jlc9fKWixKGfY2mzDztk(
zQB8iZZ(J<2KWaY%Rl9!%ky5ACtA96KTD!vT_k|0|e9A4uk0bUROAo)I>xEmW)un`|
zd^!P{W@&aMv0GFXn3B8!f_KdEydzHreFt^(=j;~IweNIux#3tcr#K$vg710#a>8GN
z2{kx7Qr?BZn)-#Vax`2l0et!CG01IyEIbC?ef~71KeJvKEAHgyON|MMW~PhF2xdm%
zy&Dv7FWN@6L16_CEzbKfm)w#e1;+q~sIH2c9v&pEVWfg7)prIT<!q8zA3k`n{mhyE
zfmtsHBwxEycoXkP@QF;Htt+M=Yvje9s9W7o4*>w)gA^LFNz+#SQDZt}$Y??RJs(7#
z8pJqYjI(n__U%jp8Xhth0BQBtLTD2Q6_nDQV`t4x=67)cLx5=UmRz8@$?`<FweQ`~
z@(hQ~*~?aoFCGOsk+Qqbf$&$fOREf;T`AOp_^!w&@dWQMxJ8%Z1+R4@2FtQTR7PH8
zMpR3I4Cs<e`ZO1?nE!{LAZ@8||3q7gTHKEbhuCF1n$H~gm5%Gp+qW01(=%%Sv{zs<
z>zr~N`9T5I(h9f4rjsX6#s^mzMAS1^I6f@?ZVE$|>F3Eut2=9Ji+F7n<o=*go7S=j
znflKa8a#`EUl`vW?1mObmb79IzSH<$g1FGoAO?bqLIi<}D>7MGFG5FK01{%nZ7w8P
z414G?x*STr$hnRNz(AwC@AY&Ce+q&~_}cJ)20|m?#eB$q$K~a$2QV4yjL{MNPch>L
zSkxHQ=aaMO^TC$IPlH&CPe&$P1!CYwF9E~xdlpag4!U0HLJeEL{uuZolS)>3wc*#4
z8i(IOl?EC3rLaH)178>i-yztF$dWSL4;-H!Pq^BUb1*(=OA}}cuN8Bh1z#(tzylU<
zHWq$3n$N$(jp7DOqB9jst+PpSaf;S1G?37i%*ipGV`r*oLC+9Ep(w`i{)z?@Agda^
zUkc$DsM!TZk*N9*qJfSWFl2(THDc=2_M~w6_l)Limc^K8Wl|WhvAOA<@e)eeeC@)k
zlPNYq74UoC{{2x&Nz<xw!k{@QI2BjsegnMijN+RvDaZVu)f>h8fMrFgkWrwvEO__G
zh;~!KBnYSv^{masMFzL*@NnP@$=Wc!Xy>6rH9?V{<=lKWOYA0iokBGB*=c;^_U&wl
z^RjP>{?NZ-;H}$KMEG?z!+j0nQeD6mHqwq{1HsDqHqpE#2=|fr*6kj)`uv^Oftxp*
zdVBW)&2+j@MLjo~=fh}GRzmV#W@N6dBYKU63;QxLX-@FsYRzL7|AB>K)46Iwf#6vA
zqo`Y;xy42ObrPY^k55;Un38^(&qZTWDZQJEhxq)l#OIi4>%-58;$me6)TE`auf*vS
z_74Ow27rL6mwe0)*8%NfS=46804^}e1}^`o!_+01K%>qa!?sb)p70}aac`0uJwGsH
zd0ihLANM(Pisn9{FhPmk-*Co$v14J-oXUbWWQ*QxOXNR@Y|$5k?zxY5g@p+Vc(>sk
ztC-iG0lY|8)~I|(o74v_RB}n$4nrd&?3J5&K1pqjfY7qs5!G`iX6Bp0JEs#&IchSy
zm8F|ZB!r^_7~s>9J>1m;@oWU2i`-av`Y!%$isy#)?)JswtPZ$UeqrHN23C+6zImK2
z`}9Md`h?-eagQSX|5#bPfJ-t8;aTU{+0U|X-I6s*-vNBLLv{dfmfu4Wk_mjlEdKC{
z)dO7qY$Mx>rcS8g`~@&LM{_F;DEm+W#iD{qrDKj|0Pq>23s!AfJGG+bv}3!p2qt$U
zv13$(HUC;78NrCCVKQ=Lz0BdoyTX3|j*X3ju*L=a@bBbJ5ps}mL=xv&R-xSLwcaIS
zKLwkngarm;q>hTk9rD2&LDs}O2A3WdN~~jo7Q;CdXwVzuEJy510RQ!1y#izqsj1&!
z9S~_ey}T}!)h^Qaq}~$N1@aHoj}Jf%qGDnME06w<IhbI4Z0k^>J3`4M7guEB^!y^p
zViwR4mIKxK<S`8o{}8?%D@E4>r@Ul0)d-3O7`9uP(!s>_)=YW0VtI%2gF4=&T_mVp
z;%}!0-#H3&TEDyP(X~L!LL#GcmWizDlmVf5+lz*mQWloa<VQn@R9SpXd_P(|KUmxo
z#w0coqrlO`F~{A*LsmC3NvK0idH(wK;Zs9ySyIz7H{61@yc1E4Lo^ad9N+G9!Py4Q
zKH17oM9yG<b0v3B|I5kO(=O3e`o~)`q^x}R?p*MtQ;OafChF?wXaR;Ye1lb^jmOMJ
z?4FnOjo%|X6uGZK{Gb;A?tUzQKy<xD*u*%ghy~F7)_X>O2Ilu@YF4pwd#}GtEl$?}
z9jA-G&p!W6`?0{s#}8Hv$i=I!%h82RvbPsA0`Jh1!zjh%v;by#YnJZs&n1zdJ!FVu
z{3mh!=e(@9?~yIv04PA-H907Y=>$i(A#6Odglv`4gQ!)MDkq6=E^4{h*C{Q!x0<E$
z0tTKe9HkEnBvu*w6xrC><?ua%m|(z?Xvm{C2WV*Bs#RusRsT9LsK9Y9^M1GQ+_{lg
zt<01$Q;=StQ)=Qx!Hw@q_l>lDGa}gJ&fRV?m0+FF7HYhOnz2s&H>Ylmjr#ZZCj<##
zO{#y+s!J?nwEwVf7?Ks*xGP*OfQtDYQedxBp?JJ9FBpPmH>3K3Dt3+$5gI%N=X29|
zxj+sfOFM>H#0IH`xoA{^`=~>R!2PL-c7l(~=W$G|vZ)bd<blAk12U|uxJhmn0S5?{
zxB}A<IVARq1P96Fwa6YJO#ceMb-Jic4#w18oQWvj9UUEy5jeyUkQWQ4U}kHphM8j%
z5GwZg>dkaIyd1188%Hux48dS0CGQ*V+mT6%Nb&DiM_dHrdrl3yDI}!zearG!FpwXd
zbZZHH=9cmC`&P_P!+T7ri%$Ef!)YaYG*zNMRnb+Yk?pS&=Y<dihqVclM2o$g<iP`}
z*;y>No(d8Y(-o$x^dGXM?igQ53<Pv_8=6LaNXoEzHcJp@a-0y;L`TW2>6S-UKYy2J
z6PP<@3&EO+A<XUMl2htOO?JBM*0?_N#DHEqt{60DO7Bn0(wUPhKc7cT$Xtgtl@`Q<
zie=;LQCP@wceLx*a&s?pY>v&n-wVIL%kWcWhBM8zxDI6TqF#N9Ihrei_Ts5CVZsD<
zsHJzR)~K9y=@%0WaW`aCD$6gZe?+ap!wqC?Q=blX-|M4EKpnEXm_2|aFNUkRspPPP
z6Qi>cED50u+1Y;^>kb^w&I>}~?fKx?h&2rkv(lGPhvV~l&LX=7T$#Up?EZ1Gl~sbK
z-Q>w_Ory5no%Ncd9+{jREL$Y{8r+%+F$+ZA55;a>_#~?<%BD;pg<_K<u983yGJ~f|
zfkBxKlC82YA|5JqOI|k&V?t1LTwG&n<i<)$GaAfO5<bH4+L|_a*qRZWBp`Dq{1`hj
z2;IQALz{N1VxZBADXlapBlr>Qt-#}LRJxfRRRl<WX;*tZxhZr?r+xFdtYkK~ic|Bk
zHYqu|1u7rHN+X7gSwzxfAj%zvtx}iTnF$Jy1jt|$M}t&19wNz=&&?(e-~gIY(^Opa
zrJ9qKoy4j8KYzdRVz#+OAoP{7+o(6~lqz^X$7!ymSR!$Ky!?}6oc3{8uJKa?jMUBe
za6l0TtgT5se_nRQP)i&gV?KiI9YF|x$L|{$QlaN#<>0Vc3UqS8C8%Dh!FON5$!W~A
zU1+~JnXue)8<B>s4f|A|4~QmrxnADbWH-1rK{T=O9KB-$)*s#6Ke#ROS`pju?L+qL
z38d~a)lt59dTiE(Uc`0GWyH~rsm2CIrVPkh(Gr4GtNSlcgjX%AAE1EPv(ptW>Q$dZ
zYJRE#eVa{=VctdI`4<?5m=-{g((c-|5p-KIa|~hzkqL;Vs(eQA9}bCBIM4;^@Nkef
zh%yf1PO5M1u=}msb+NQ<RKPstGH!b=Plu_znDs3ml0YPf=sV^J-f$KP6NXzRdIM^R
zOAGH*`~#Cq3>0!0_;W5Wt}WVSoI0h#4xtfHt>F9-*FO)K$KEf=qJWyN7;@n!IEwbD
z^k4xs_53IE5m%+M96>h6#lA{ug1(C#D-~L~g;N+yv$Y@)tkD%t;sb8q+-XnBN7~u7
zC2QlY#{Id3GG9tiAxf)mUWlL7+z0p=puG^oN1VVEB#;eoa(EY6e;ylh4LY*_N|vCz
zKx5#bzcdcDl0OG@G2vr1D)A1Sq)}Ap6u0c9Z3H|*ZZ#b@t|{bkQ|em`39ztuQB_qO
zX{x(=^=d|rCyPIvHo%FS1xu=^n1NBdq4?R(5*5(w5!xZsc|_kUPv+%gluRvQl&Tl(
zl3EB|xDx#cq|jOkU#ot;J@WDW8hHGGa7F1=0Nves++gTTr{?0};gI+aOV5_^)|+`A
zG19CR6s#i+flQYs_QBnwghUjw)FFAC%h0<gTDRs1G^afzOm$>e<~m3nqNk$WyKS32
zC!ShMbZIDEl4A<5gSTwEd2>ABIj}-+0*GZtk;Qs>1<~2M5O!$uBqaDn1s%oj2z1t;
zSH!e%XJ2#D2oJk}g-9~?=8eiprb-N9QjIhbLs0!$@57%HBE^k}T3wzBdV40rqU!y7
z%H!|B*Xsir2P2fGR9)-&u=hh8I(!`$=Ca$v#@6;F1>4aLdNGT84-TJ3nZW!6SDhT#
zn$q+_4(~jC_`!;R@%6}Ws3x_@9JH3-UvBAr3~C*B<Pya&^_Gv*?5%SiB~)lROsjUE
zKry|ya>Qr${j{W`+6~an;8Yxv2`jQ92t?X3XJsP$3LNq7qh)sOdLkk~jB}o(dJ{pR
zO~jh!pxW4IqGdu8mj3Jg;F;j8-+vk!7_8+xP>piRiEw_*UwERhcE99)rL<>k+(<~P
z`ISDnk59cfVrTpgB&%E1`_yGLO;+7zwfQ3Gx2(=WPlvsd3&wjGiDuDJK1(e$h#4Z+
z5HOsi_yIi1)ZDxg+@wr$k0=&o&yHx~IK^;t&ILdA1ag{AoeL}MZ{0%eV-^4O__@fW
zq#*P}E%>eCOLSxkY)5}U3yOP@X8>!x!HR<y>@t1&S{{T>*RGujF({VMFj2}YRd{~;
z_-kl|wnIOd5@|e2gZ}+r8!KHgRH6lxv<kv_iR@p^q?gY51^NO!a{3E93nMbc_aisX
zQkAZ99_4tno<h7zNE*eD)_tSF%!a^ne8m?J7C>o$Wo#ntP@M>WI1*2h2j><Ysrhyn
z97Jj!O750Sdz7wUJJn2TNTd=}+Kt3w7CcdmA#vD{3IEq;DfM}D4=%18AU1S|dg-N%
z<xbO9P|no>w@NNC94n-XZ{Idi(MuBVGA^90sylji$&11&hQ`Q+9F%|Wp6!EFa3hq0
z|H!qrpE5-jp6B1WgV*8}@jJ$sjvChQ)_r9gYilhwyGdeg(Zb)p$7ncr;4s-fhW=D4
zu}6-SFi_6{=Mi*7JXR{k^i&>P@20`{)9;^M+=9@C6EepTeK8d*&t9A?fjqeRlro}{
zzWwj{KF#m*g(-pLQON5gt`osnHXguxV|cniGsJRj`DT-YLsvGOHtp%(I!1Oy80kdZ
zVfBHEKqg?52s8W{l4r7WQ1%eQ6uMvS#Qe~Y$1t5kSgHR~cQ(+pBopq*kz;)jXcZj!
z_aFJalyzcSOGAwGDbV3vZB^bI;tG^Q33Lph1RWVaerwtTU*IUQr*j*nO@VZDoYCaD
zNH0vJ$^fvTj-CN#V6i`s<&;!Tqh`<6MIgT!-Jxja$iTOvKP?`2jFPejqEO?eO;?t_
zY|Qj~`PutKcD8LbrdGHLdZOxdthQI{K(m4Hhat{v6j*==P0%;}@%_8F8<C6W6)rzG
zZ1rY2_x0<OGn;en`J_4E6_}Oz)4p79y64ZdRtY`+)|Tf*S42T@jN7?y*lG;`Dn^|8
z2rae}r$$oN3sv*No4J6Da?_tYc_KZL{P;$VuF&$*b*!b_LpHCMvA|qMS#-CoN|a@W
z$KXV7)f}t_E9qk&hIyOm#d#7VJGI;MIuQdl3evTRg#o6(Jd}Xvh@mfN2`=*^qT=JP
z``lEkz=%5)^$y&s)L^T*@V!4)ZRgg!g73pzL6gn4svJdxn*PYBc(PY#95>yfyyrXw
zn`T@D3FlxA4Yz$eF*%OLj^BmTVm?%Byieu!lc7YNQg&o6-spJ!k(d4X2pSNHH;&i6
z!WOEBZY{4E+>%C1$U(dpfi$QhUm06%$@<%%hL6{+r{Gk-xO&6%GF<fB!A}sM?(aFg
z*pxC9lCCtnSK!irfGFnzf&b&}<;Y2AOdGZLc)4-Fy|X5#KqI+-6V7bV`|z(_C<7Z;
z02L6-O`Jelk7GFX$*;wCbsbNPX-B4ywIUNjv>0!anv!D-YSDCT0=t<`S)$a<LLBfw
zV;d15_6=RB#=vqtlPrl<thYXTyM!Csg0siNJ&+dQgYyq&E+)iS27UO*Gc4V3^1g&A
zdQ*>5Vilb+_)I5yolR?g|1^5^L|0drJc{qCXny1cVrxjKjRL?ZSeP~!BuHFCU9rHO
zKQw-pr)M)3J+qNeq!288Fkw~Q0_b~Rf1f%4V!x4-s|~(DJ`sHIeu#=cx>p^Y`aGx0
zIKu7hpGT%{)uzn`zN{D{bB^Uy!^9DxF{*+l06?U6VMpO561#ouL#HL)GhhN;DHLpz
z4s!!%LR{+=(s_}xi&owgZWW8wL6+gv<>%+GO-f2ilhyTKmQ}xOz@Za08%Q_|OUc97
z99>>pr(VL)CEhS61#2S=e7Swi&>37uR`c+j8i8$ZZ9kv|?e%w(849m@5af>UcpNkn
zuSm&2)D3c$<%f|9pwJZ@J%2#|F_aYX(uJgip@l1*J_E=zHFe$m2Q$qPybM3OI_zz%
z^8PbT#e;f=8+Mt<2IG{((Xv&$c1>tnz~o<20p-y8seIRSP}4SrQAuJoV7Z~_EO7<N
z<cv?BG2^n&5Q*53s4}S!D044?KzQSRfc9>YX5uKOb<M6=ckkS}9@V5l-@Y%6l|Hpt
zd9G#^DTbP;^hVy)DN`gmLFRdFtbNyne4Rsu7ecQ?Wj18h_g1oLm1176x5<o%U2yvK
z(@Z`SXDMvl?=*<!n~VBPsQf>?C=&%hBJ{v7`~aTy`Tf)OC<sy(J9>K3j1Xy?^`Bq4
z^Ldy5aRHv)Y;mH$B`J9X)=`KyHe?S1F6GFJXUa>O6At3`;sF5KYz41NG51Ad>a=N^
zm?BVdiAyKXa~-lo7I_PFAuCJ=E)SaO;BX?Z#o^JQn&PP@izq-24xDVWnRRZQ_t4(+
z)8{=kCPQ|@Y0SsgZaqAvEBX1Y=s=Ubr_u=WwmV@#!x<7!dy#KJ%Z_XvdS(dqa~31)
z1|%8j7MY#CG7h~=*CzR4H$Gg{H>!PSQ?arsO2IN+nJkbr1T6xQBK&M+#QTB@L~7Wk
zP4Ry0-J@qu)xJwtr&Vg@8h7f~Y;s!$Z*nau(g=U>u1hl}5XkK+-tVKOxdOx`nCtl6
z26gD-*gd=f;h_vIgb0Q8BVH(fK^a=`Cs^HrBj8oW?81EizoVVbEo?yCtG_KL@l(m{
z2vLw=`7)i*AqXPLf&E__Scg*b=l8Dw78fAiV4-8SPvO#Rxx3sXcpe~6_t=B6fuqry
zWQaHW(EHvIa{UFRmgbxzAmAx6@JdcjBeD;5YZ=^z8MHWJvI(wTk(NQ&;e~xb0euCp
zMMe=Ac-8xZ1Ml^`M$1>MFr`&Z-$qIx%&<=&`P!yCET`ZhN_iutDTx~3=qgd&{;Z9^
zOGJ?TJ{;W%-=n!PK=M(su~|Mx)wca@Ptgwb;GNT+y1XI<YK2*dxdk|#IJkc-EhD?-
z`V2X|j%uOQZ!~3^j0j*7=sBnF_6hbH1~o+`{pu>d8&jEx%1d{tgP`XB!}DHM(gapX
z@2ZX({~zo^Yi>gI9g}_r9nyN@)^vgC+5Oz!%jxhu@dC%YhgQ7<(fx}?35DqQ|2XCb
zbG~ezJ*|j^G_L~C!x&@!f@f4l*9ZGz?V-jslVV3wuCnra#xM=@ET{4;805GdY<F`i
zBox{x!84gX%-r!NIX}UsJ7%@)1aFI(jTz)Jzy`qz03jA=ri>zP%Dbl0DqoymfI^fi
zPC8(4+4_7&>{HsZCC75cqwwnw9;nl{s3T#LfRC5QBF(WbxKlI&A9LX`et9%}z<_UI
z>nHtJCC?SasHFGTs^V?9D`_(x<7YD~qAIuj5ED0?jO()d{Ibt)LedNtBj{R2jPKqy
z>0;%dAM*u5B*QI0Z6)h~1*I1g01AKNk1MP*)_RO$U5x-QKn*WpYZCr5iQiBH{UmQO
z!V-GOhJUVbq^E4Uw$udH0+Uz;=F^0DDLkM{$#!CTXm56<;V=|Mi|J^-x~mt1(?^dU
z0arq=Op-_l?@cx+0})>K=`fKlQ1Ed^1taj7|A41<2Z~l20Y7eZ#nDF_Z|)n^hLJdX
zD)Q&%s21z;-O1JR=jkY=RAX;f69M^d-O6G<U;xrSK&{Yi=FI0D1>luR?XA8zbB_eN
zlY)k^$rV`ExLz`DT!#?oeziKYDVSr;D7pM-yqh&^ChojIe)}rytD3=uk$U~<g>M$S
zy7|x1=e)ccr3d;T4}<vAlE|dRZs=$G^LHOEnH5z4??=FF#oDuH&!)xL5|MM7>?toS
z9ARy4e&n_*lmYQexW44VRxCBJ5aL1Gm7M8)VUtt(s&<k%pwu@Z^?^=Ar>5G!ox*5p
z8`+s6v-|2^hh3PW$|#6DcW-$yJ%CtR=qSr9Yktk+<51qIgEgMSelGs}`LluaP{?Sh
z3ngB##xj^b_rG1UMU_6*#ew{2TkD)OOMw`-b!?6(JKp-ytK^CI?%v(ecJmrqP7XFl
zpdP-cVCFY`(q?yuC5|~Ph}go57q&B2V>!r6^c{@01W?4TI+%yqZJ^hU!%<P|i1ja6
zKrFQpx5c@tX{QKfI9~#v5v&r6%Kilzl*PY*a+k5?2GtVR7<>bfmM&m4J7i6bIxmcK
z>W5ETRFq5SA)!AD?%Y`q<X)lm$c!DD(fq!EfB=Pp7QP-+zc)pRZF8<i_ye=C*0VAF
z6&i_;k86LW^=bZ%lqwAYjtC5ROuW6Tr}i$#E)d3BKLTV6pl*8DNCuDU$PqYG{%L7L
zL_ubMZebTuE75g5C$Rrzx2HHsDAz`L3t7P*Yemz4%z=q;UYfGby(v^}L3VJ!6n9?e
zO5#|!b?eq+s3zqu0Iy~7x*zKF>br86w3EQNqG5(0ao^j6aY6%F9s=%j{Ty>%jOQm4
zj>Y*ynh8d11AYGtA*A_1oI9~TQ+GCGE-@$M`qwiz&pA8K&dO>%4T=Eqc*#lDrD~NW
z)O<s`@NKnAkK_-4&exoM@Mx%2e=mrL#letv6X3~}8K*o)R3NvNMz-^xvjot(E>lHL
zqN|K#0s4^(=J_05szhn5e%OJuTCzB>uYY_X11ABw84NR0l-)8!_l+o47^MaBrM)#n
z=4e3|UT!Dgq^ypGW7~+ymI%dPQhXiNN(}_t$V4-l_)g2=U|soh;w{)b=!hZJ5(RI{
z-Ll#I!qzOLU>@WO81Nn6Z+vrusEcD&>tyBRlwj#^3KGwi-r2WN%s{RIL6d#VbCR~W
z1vKV|=TIEsksvkuu-bRSe>1+PojkO2-d?hY5t<8`%rZAnQB#w-0dG(MBAAGm%j#>@
z4o>r}O}EN+i;zu-z}d~|!?Gy5=GHuZ9>F7!8v{O%3Q2;IOemo_gzVpci#y~7{)X#?
z(z$`rARFI73NZBDLLr3PZv&WGvY(@FXu4SHAiyA0Z(@XizWh|c?H%B|a6T{>dp`Hu
z({qa&3Csm{3ox6XJZ-R)+)PqFeEw_(SAulAefRFh?Chc>X7N|V26IbaXoViFYc;28
zlQhBhuiGtz44X+sBzR8n4x{EcqMCCn87hCX3+`R>ZTaLwu(@MBA6rvBUT->*!Hqdm
z-h1DFiGQ+SOyt53*lD}~pJ7wi2q*<SJ<3miLX<ojvf9db-@FKTA|_#m+O5X)E_qZ|
zPB2)HGR>K#QOp~W{L#ZPwH0J1Q}{PRe}EP>ogPql2u!0$f-UFIuR7bYVupq@^$DJ~
z0u_OG<^m6iXPMl1N>u22iz&!QGZhdMF6BT-H2*v&+!FamK#V;XoRc=f)O3AK-GMDz
zZoB_JFE8(J69q2;eQPGKn;b2uKiCydcpXKwgQ{P;HIq-KSu<GkH@~vi&t5$0OVqFh
z>8n=?4nT`b`^s@PKb>{H*%gBcw-}EHf$iS7;IG@Y>&PBzC+EFzjI4c-;XC}|i`TQq
z>ZycI(tBm>Z>oqSbu7{x`PSi1MT%HY9wEalqRc8c)7=qb-$STSR(5tmC8lgAIAr-4
zjuvV?MDB17E^}@;W_4g+VSKH8zd&7EUr$d<!5YzD*}op2nlqB!oN=F0DJ%~G+YT^1
zU?my{NKozoU(GejNM^$I<H;S0iV|_7SpPPN)zL?*&d?#BBdpqAH)a)mlNQ`xAPXp8
z&`DU`smon{#D2M?>|NJq)?bSS*jfM4t0&NG&Y3&+E}c;6*{8UxaFE-zZ@+`f(xiS}
zi0IZxDvm9`apQ)_BM|6a&Yl@@mgYzd1%=c|k(wGjxi=l9a9GI;!e*3<$!3sU7529-
z*Z%o7ysil)k!|jGo=G7c29g5UoMUx&benY`yd3F;u+U&|J8fAup$bE8XhN(D-N-Or
zXoU0(O%!}aQG|?zHOqy$xU718MXJ&)SJ#mU`W$oIs|n^!6byO?xbNc`?Kpk<^m;2J
zUyhcpg2p#t^q%=hI3ei8fAHEHN_@R5N`BF@K&exd*KpKUemUR^xF$jqDp93X*0uI$
zJlnC;U4ND1=pR%~@E9X_I>H)fuGd(BXg>6>(8L06jAPDB53xm*jikx0h2m-mW0GIc
z=DwxIQ_iBOU?60Ub#{hjT%(6YbcOx+=3tED=;p-TxiajN2UIzr{V`gtw!@R2<KYo%
zq7?~f-*ENp3=*0d*qHDE8g47<AWBpE=s9qI>aP`R1Q@XvKYCqB8~lIN_k@+JNmu#Q
zy4P4WzcnbR+mIpqiaZQM&la`q|J1f!vnz&8kWT>a->sA#YuX`NFx-gY*;F{x2Q8q@
zVyqWQUn=-Mp&opn#Shy3`n6#Q1XXS@ox0!|w59i&_>Js+p`p$F5vP(h?P-Ikf9}m3
z9KaWBPi={EeA$NVKK=X4O&4GlKt%TFnE^EkJ&$&@|G={U%|f1}9>3(;C+G;F8kbxZ
zs;Pu`+794&GSuxlao=BG5A1Cmg62cS!^4@D)x<KSRED_hjTEZa$H!=V1;dfaAa7Tp
zVA}qlHdsL{_xg~=XQX28$+S!H-K||2D9Q_{Py-jezS(}Tvtc7ChykK$+~6UI+obH~
z!?D>M0GWwA!x(KTss)H}JGlDr&Os1kxPcp`<z+A?)^EV338&^g?-_))8*R%r?v%g;
zlu3@}2`2^2A!t&i3LMCP^Kbc2@c%D|?mxC@eoIf4L?E`In%bIHF>TMEaW*#S834|H
zb}!zhdfIEUth>NP=`T?LBlxwx=f})-cQ5p){rRUqrS~YZEQ(&m(4iMs1X=DEFrNdf
z^v^EKqb#6uq_XARQy#UXd=~7L*V6$74yC|Qw0BFSr(*E;pQgt1bl7YO(>$(b^y8O&
zc50xfo<Rlx7Rj=6UY+H$Z}cKc^zT1^Ml*%sD`v~v1)QR0&K=%z_u=@|RCO`a5dtTh
zAE<zY>m<M*H3(I33ua`{W?RZo51Xr1bAI?Q!$Xpkyn$+{TkOh}lNn$5i?0B68`(I&
zs3?o{=>6&S1Zt`7r5A|oTl*q)QWpQhL5p-{IUkcf7n)O4`i|x+kNhRQJuByLE&Efm
zd_zWIzh-t^(mr$U=m>rZKUa7j+@OXud5nT&u|ln**(F0a@eyO10N01iBRmHg<<Oam
zA{3O}DtyB1XYavU6d$tdwIzcC(2d&P@*{JYD84uGz;?{&QCqfdy$TQk6ESIf_2R{g
z$$ty@^k$<*;ZxL7Xqz<epoo)Gz9mBwl4&M$4rWm{V<sN1?lI*=eOmW{3twGpUzK<L
z`X#VFp&BsIE5S%5;qG@Hihz1fQ>-RiN~s5?%_^XZu*XL55>%9=nBkQ(s!PwLco9-7
zT5*AYMpPBU6~WxubNY(I=PrQFvZYSelnE_`VUMG^hXJE(3`Xm5Bt&us_ctG19@0zg
zPMy|OESnGvyNFv&-yU7KoPbX9L%+I?=}ZY<SqPtOf4yLmq((*b0atEuaTO2>h$A)F
zI*HryA0C_vUqTjLLAH^K1iZEt^Dl642zDl<0)hiAh{v>6MUKb2yxyBkvXfCJ-pPAw
z`gh#cb@-q~HQ&8u%4`+?Iq6r!`t_ef4*&Z)Uaxw*2HKqv_l}`n7ZPFLJ(Xd<kOQmr
zcG}8EkUkgM$cCB=9t_oia{9R4?f^%m4%v9_g2My$$E~>g$@XpyN)&t62M|&g{QBx8
zgigjlA1i?b#8-hji^psCZj{6PM_>8nGJJtH@hf-bENpvfzM?u|()h!zm<r@L9|V{x
zZONr66Y@%LtUl}ca6Mhiz0WEc+4RI>f=62;&=r^$4i@#PGa374)U37yTRE*g4UsWr
zo^f6i1?|=-qDz?75G-tiA(NcEopDaRG=Vry45LS3j^2_n*_(=rD?EJaI(B6=<UQdt
zAcRRr05r;xOzI>loRUlW`B0mJ=H$cXT3ex4gxr4<LJi3ELqQR}HO=3`Y4?7U-)R+-
zIV5<Ofhwen0<)HxE}9$2)*j+ij2Ffe_IFXnh<$X|gR9mPBQD|U3iyJ%Tt`Gzf&lxe
zEtKk3pbi0u`_G<?_5Mb5qL&yHQRjo6Uj+)0`W+#fY^hPT>eK9QrJPc>x2v;WPlz2b
zdR>_ZRn|Rv_+>`VQB$_OINZcDaJhdyAdD^wp}aDW*m@Z&JW;(fdTy<dJ>%??<{Oq7
zYs8qqEscVV4Y6L-hqP$0^561Ki6LDXSA;9lyw63_7qn6suff4Bd(}BZ&&iIjyR$f2
z!StpK+BYJ1v?8q(<xHhyw>b_mN#AP0$iz%XX<GK)IgSi*4&nWhcBYwdd8s_apMn`u
z(cDU?E~3L!RgDdZOL@z7Q+AriX1@c09jhOfTbyz0=1pkwcZn<IL(1AZuNr|+@=M^2
zQ?0~9{Io~WW_;&dF~NBCAM&;+0KQ;IsF*}eC3Q{Dha=4>>U7bY(o=hVJ~z(7g0a}v
z@e?Ls`?!s=2d}k51&a&^fV>)F<Be>ELiCzXhjT;)3v_Zw0r;Iltf*^3Mbn8_Om)QW
zf$zD>`QS;Nk&TPn-=^#BcX4RYq%72o$x5tH{zMG>{Lt-SYX#mn;l=MOD#kH^6Z-^N
zkP*+ruD@0y_mBR}h6`EC$O5<{d`Q`_AW|<Ud?4QKGkW(8<!pIz#&Cud+n~74A()89
z7z9dNJDQj0L9(wC$rG~T@=`16=u8441AM&$IPiwlUkKfnMkTTOWcuOpy?qnY9cTRU
z%A4x*2^rH49z+ubnxDVMQ+RxIQHZUG_Rq4V6wM`#6|%t|f=~6moAV#_huucA-Z-;+
z&OmO22uH+Wg6c#Q?L;W4`8O11kuf99)m9i1z#WFFX-A6<&>GBVAp;&}3K*K4JnwW~
zwXYAAYxcK~yQ)&Sjginh83`A4A9s@l^(Q7SQf>{mV2gAJ%xip}o$U`M<FxY6o@^U?
z`!TeDjl_V0O2h&H{bTG)pT&#gM0CnB2wHU3XWR_la7yGahY}OTqr%ZV{vPOd95vER
zFRuxlQdr3eVCN#)f~2>ZP>y15t5BIymz}nDbR17r&wVJ(ScIp-t8qDQvuEoM9m#ML
zjZwa69)`8uC1MwLK9Ypw2_Tt8ShG1eIQg#k8vpn$|0nv`m6Adjx{DuAV+EOF8?Z^1
z&#9%49+x)-s_7>L+g=Q)l@+!Fb57Y)NPYZg2GRnWiEi{)74}=#Q-$0aP`rv?KU=OU
z1r9>t5xnsdV}~tYaB^2x@Oam}OQ#a4YXWWCN8=OH$3s9!`ufqPxAqO%0mRWhsZ|+8
z9P+l2#B}s)BPp-vuS%}<0?oKu_9@KiYOdaWMqnt?3Ltc7XS@S7ki*Xj^xe?(IrHT)
zFdyf;-yERSq)8`+{>G~2Pt#ZL<tFWkh)_P5cLavID3RiMXtuw4PdTxXj?k+3+W3BF
z;mrVP#88#o|7mnrIW28ByI3t54ag=F=y|EZS%IWE8mE4%AujEEy$nlaqLm27p?+}f
zjMQxVm{F;T{uET_)vNibM~_y9t<Q&wh1`vs!1L#Wv2W(8M@B81a6;45*X+<=Y;%V5
zRX{<T?Xy)a1?jt4?YF^|84aRWtXQ#_5{3i6da_olR*Ik8&wzkyPoM5L(+*j6kcmn9
z*VUgVcs!a9-M|nEg5B44l<rW0WS|`o;7)7xv96_dGzAA@T-9?IF5Cs@E&T;qpfarP
z&7ZS>&R_TD@qx1uuWMNw!-X2O&@BBHB~2Wu;bUzE52x;=#NzFwP^tx8MT*L<@UXBD
z_7$hKx{W}I^2wc-V`jFKwIR%9Q!4GAx&kWGkaq@D4zF3`>szbw>CaRzC9~pJ{A#i7
z0oynPWMEu19P2t_{*F6JJt3ovppCU?w|BV>+Cpa7f#k}!FucS%0ppk0w6*qhag=8E
zeclY7&HVbmJ)@)f@<awD8thr5g`Ujx<i7V#-JU&zX!xX62JEGjKm8`>aVYs-&c!+t
zt=`85plK%VlCHfz7f)}aJ6>z<+zPdoHKTQRSfVgQT;4_@Yhy&-IN?OQhIc>yPaCQX
zz)*mtNcY-#&tQQuJ}WU+8|kCh3RZK^^5!!N<18I>CIu{wH96Jg;va|gzzQ^$<=r(6
z)DL$N+e!$UmOQj33R$T`=Na*Ngzn+@a#{ZiS0pCxpvbN%AHU>-{c)!?YtqINGwVc>
zQSZ;W31m76C|R}jzfmM21}3|Cb_H)16`xzQNxm|gdZa;mSnqWlzNY5U60&F~iuwp+
zACDNfnJWK+s*vEAF5Cec9W#0I4n~|&+uzS*s3p6eb8p?UF}Y(0avTcQN*FtL`xmdg
zfVVJ*IW^Z%ekJ(bTY`7d`?EOM+$k)aSv;$_4}Y8Nq*pcUd-9S3HXuaQ%&41KoAYe{
zrlQ@owe@@t+?`V#xY6vZ`c!|t**E&C^c&gku<4aO)tBZRZP%}J#lY~Wh~tLMc1(My
zdqb;PuJXfv*;buZtwPnp!po|*{aCU_d*|)9$xpUbEWG7&K5uz(-ekAigTAfKc$RWD
zXu=-dHid=&#D@t_3Hf8(CB1$55=-Ysncq%DMQ2Il<w4MV0OEH-<68CM`MS~H!T=n}
zQEVAA9z1w58CT&xYt|@=Gu$Qn=;|JRQq_%O`Y;(Gux?_6Cxv$n0%gBo%aV&@*SULF
zmwajvjT>M$?~Ip=PV&ova|Se7%T&I*_rd!<BUU~wA+yCNCEd!*%v6314|lwRx~2cv
zh2)m{lcFa*XLwRSlNY*xf@vS*Hdb`!0Fx|&D>Q#!V2_I?pMMljo$}S$G5<&9O4_`V
zIoPb8pH@(}fZWi3?!B#GfmXjgsW)*TN-jTx+Jzyc#a17DiHeHP_Q;DRu$($`#`gEK
z++R*LhZ{tzGP)WSXm%NPYS6nFhN~TnJa%Sh`?e>9!yyTUUH%#w@|*JVT)xd@-5sqJ
zD2N^c+O1f&4Cm{GR0mtPZEI_MW{g5$jLAn@xZT{{Y4Ofoz-@w0&++uUNh(v)G=B%c
zs*c5U#BK<xlPQ=qE_#?x5DRx1>oE~d==BajB9^*jfailu=vJ*1yLwKweftn}eDt32
zG`a(9f2JF~<%xX$_U#C#mi>VhMTzEY?Ra0It!+8V>){DMbiZ%ZJvylc*f!^=yMT1y
zv~8Ugm9=C1D4UjxPPG3Y7oeWPf8)lq@1M$ig(F!vu65gjVYM}j))351b0#&7x7NQF
z>K^9B>#MJ&R&L!IO)ptO#n^w0b^PWFn{f|`n|%@2P^UNc+D0pptw4W&2uY~!bWBTu
z{1<!spNyajS<g(dm(OF6#A5eu{lQ6s+w~i*SzYMCPsZnTe%jHq#>~wRiUsE_q~0@U
znlZ~@NS%@Jj*`ulCU;M0sJ8v+ke?_-_JdAQ;_(-)^;A3tFIh<dq3%qj4m!Q{+Yq2@
z1kUNEuJmn|@zy73))K~Qve~Y1OA#<aR|O0lTla&}<+xSsVg?d3Ubh75lK$d-`Y(WA
zZ6@dviI=^dxjsTyUq2x?y#<9#+$6oY#6;knseK0yOdY*%!`+=QqmOZv;LFB4WF%5+
z^aa&o(ADMq>mkmq94skiJTVae#o}xKLYsq3DBrz%_rHrmRj^0N?C#yW-F93b2vW!9
zpVkUMLZ|ZG;z)M<c(>~Lbl54Y9jiBwBFOcw{)F0cr~S({Aj!Q|0y>J*iqi_uPlxwh
zyVKO{VC}_=^J;Yl(Y3TyGCMM1?`Ta;&7yZ@TZTD@UpVzkZ7K?=ItJ`Y(|JftQ*LuH
z?czn}Hw*Xd-#<aoq3_Hwdk)-y^yxlt-b6(ugt>EDo_4=raw;wkv?O@(!i9Gp45O{q
z3mJnLXdZXuFuDIFG@4Wlp5Rn%=Vi|T9dUPYi8_DG)7||V<r3{zl-z6<dVB|P*|NjK
zOrOjW%Mr@%+R{cgu*Aj0Tmi*ysyQkNX687R4GahS>gbrI9hf>w^`9yg-{HH)=oDfx
z1K9zNbvuk!j9WZKZbDz|b}ORGn0s~VH54}{qnD`zDe4GJvh<dPD14LKu%8yvRJ?TC
zGsXbcb~I5izfU29nf*vWl#R2eR=^K=LA5joi88bY7~!GRe7<w8XoVP{AZWZ6Rn`iZ
zy()Q359=y`J%?n(KPtF)FS&JIz3)|3R`&LKi<<@QxIR;{md1JAjsS%Sg4v<c`tSXq
zdTWgynCC5Kx}uO3%@r571aZ=+B}>law;ts&>BvOQt^W+~Nb8lw9g$ws^I4jhri=!T
z62cX*yUCl~MfX7bgaBTC21bQqZAggax$HFH5N0zrFFecDkY3>L#UQR}xVX2=Y>5uT
zVC7fO$|vXA&~%DL`7yd?!2|>+VaieehMv_yLRt)stk7ezAQ4X7nAqMO?p<un6Bq6-
z@zCbRvb<mAi75+McE~IJ8k7^~oH2~0vK;^BvI||B_Sd&Ya+hA9nqr1i)Mq+1LLCJ&
z5s&M=6CTlC<U<d|gsnZ#BOBbsFW9<^;k+m6pazU;a%k<Vkrl=86S3ZuK}&wMp$HiO
z<}&fBS__)mM6;{`6~7s94O7Nop=>{U_Dr_rnvNXl7i`-Fr$9B~?bC2k>n#;q&7kb-
zZ2KXr%W#{ureY8yW6FCe&Mi^A)^FJGCEc@V+$cJ<cHJmI(V<kvTtXms%nw;5b4+QQ
zT~Ry4r8zf?_Ca|khZf-G1z1r}!65p><=^ZZk);zHxbW|szYF(=C4cYmjZxP)&+fyV
z<`hI{jr;T#qO$_*wf6EEI<f&+W2QW=-MeDSd%J3YI!>hM_eA|hWMEz5v$>xt%FCnq
z*0Wah;*R8SB0jJ;<2f@5L3H^oU;Xo}J|Vmc0%q&1rDfv!OQ=oEboTAvZ**o`c@M-+
z#1c_Lh&ZEl=h2zGC(txFY2rEG2Lo=tzcxrB?>`G;#kCXz&v_icZCAkx{xWMx?%2@D
zh83IpL1y#Ma?)kZ_`-8(xlU&zxZhCPAuKgy8eslrphs(LR4EU|@|>9v;93s!O`+IP
zLD)=NH^!cPbV*(Zox7|G@JVaKG!+7aXyz$U1cAmy9;yX8PXz3;8C7UUFdySSKUw*;
zas<E#0+>T*KJ5+biAb9N0q~fTB>JG_!CkAaw3?!FFq(VsIl67N;Wy0I%f<-UfZYF=
zUh#VpEKmWjC(lN4T4Y;<uy#3losdUjkh~5K7}%>{aJLoNJli@owV&E{8RFdMJi)K-
zq#Me9rtKjqNlCM~*=eX?t{Cs-_c25_w7R}luL{RetFWl8!P97Ca3_}grY6Qwa!sKA
z+;zkG!qKF-pWW~PH8ZPUx^NJ}tvIZVxVhxvog~o}7lCR|;)EJIult{)c{gwN__U13
zs;xkVe6W0ToEq$wLPF5O8^uhS`vQ!BKGip&wLp4U^>XVU4K3tYlGLbFnLXiRWO2Hx
zgtt>alYw~rYR^y{?t3x>OTO1<(ZYr5jLP`!7COofQ>Iu(P5OW|4&lOcBs4|mhg%l4
zY1=l3D|4KUG%u~DrJ!3H3%||*n<;8)kgYUU>E<6V^g!|ig)6E5jbQA+!r&k79HX;%
z!Gh<sH*(Wu!zo_JefJz4f1@LV&3-+4j4$eAt{<kX@bdENw(ACVg^ux>&oh8mShX7f
zCpGNMznx@>SdfO1vhnDkBiCC*(;#$K;FP(WDJsdI>^d#bH4r@d;xX%AC!M~fvX&Fk
zRQj>1@0fW!XZAPh#OD^#w0@FAHf$IfcyKsFOn4m2O2*H8XdDnetG4v5mP7bNtCaIq
ztbZYMunXC_<Di9yuJ&h4a}TQA)x6CY7<c)ne?13g9`@!c-sWR@UVpe5DYqPt_8lB>
z_|T#J%a_;F-xj`E!}6+M_m=jg4{-(CBKyTz>x0UU<%~z{*%NQP4j-YrphbY!J8zU)
z>xVUK(!_<H@!ai3fo6FQ7greZ+7c_j)j$N8q#a^_!R{M9Ra<-eYmD^IpF3x%yQ3gC
zw>)V|Q1p35d2alYFpF7%s;xI~TS^Rbx)4E1JK_#cl^K=U_V?kGq@H&UHQCg>z3tmy
z$#Jy33sHaaaw5&Nqkw=o3%3dC0rx}AY;KdOonP2oOaR(ydH(!)CC!-Z8$gdBy>H*W
zn*e{S{LLH4VV8i7hC9Fc>bS$W@SY0yHsO<T-pVMGQ@W~eu9q&Pb!e(NvM1t|AIQ_2
zXpSt|yi1)Y(#Cjmz$-A7H}Bu~THGuoE?1P!ZF@OhW7%$exFyq+pk*^oHe^BDE3_ZC
z2}#?n;&+l4UjuD{EzF6Ev1v*dUW#1TuKW!8Wt_ei_H4(ftX<vbgvi33lZH~fc8%D*
z+hFkEsc-aR9nx0~I(_QY1L%wJm&o4X5Ppo(4WbV7TV_(ZQ)^z8Q987eqs|%Wqn&&q
zek8;WEqX_qj+H*Aw0Duz+q^1yj&&x{6rpJ2WVbXrF+Ai0yj%OT^QN6)mjN)lX-<59
ziihuf@8c+cIi`#;v~cFw7;NJLF@Tf!lJC}Q@y>-?*ewf%tWG`-F9af0W2-Q1T+L#w
z#sXnd&%gZjiVxO~8_NHg(PR{xd;2<T6&+%bc$b!qkl3on$XTMOB1iXJyj7!Wf|A*m
zro#`eZoUH7?>l!+T>W-ksH5l<5+0LCwG>j=LnSis{ZZN$>dI%o(%T2WozIzYV8|YY
zg^Cd~iTqo)Cioo0PElFG!<jmxlH~x(3Qefjxa5*`!fCH&fWi3n#qOoGf`ao$Zt>%a
zufts~Z)}^KGM=A=#}lzur*^Pyy-ecgCweqofS1pCZ})Tn=D5tJP>Gc`-S+A0*TdoA
zwt=PzxD<y|t=JANvm3e#gqc_r_P`mUH*&-8xy7GO>Yp?z6tDDq_cVr@i+33H8iS~b
zuD{}x5LhjLak;_!2gf%^T_gP>$Mq!PJ)y2nP4U7HG!G>LBuP_Qnj6-vWlJ|lM;w!F
z4lQ9`&S&Xz@#00lU@I=Wt)+gLbfTu_@!QdW{`~PnA|EfY^6rtAODi9A`ZIi511doS
zkZR7+;zf&M&{fyT2aY7>HB(a3x0CUiAwA3weE$>E4_co=i&DVrB4(|x%oqY7yd2WX
zMC7bUaO-DMzXgtpiuQQniv)07%6*#woGUlL3_69*swyf_x~~u?P8~a@rC0(s0&n{T
zY(A%-sl<mggFcozM_(>#&%x^L$^H8b?V^4rgHjudffEwO&R+t7u*>Yqd)EA`E(!uK
zwYJ$uHvPQfaQFOs1z90J19s}ur%&;{8b=~ov2x|EpCh^_{9&H>wyG+Rf}oAU%hQvB
z=Z5c}ALeh|ZNlkK(N#?<KSPpbD00lP#Oq0F2yGcM7#s5;r{_?V@hdr$R!|}C;)h7`
z>GH$bt%ING2zo@IQY$uVv7hVt&gc^))?S10(x)J!mpt&w*VmQLfsKs)yI+t)is=(#
zLbPu))<6~hXrIyC@JBgoY`yK=LGtl8D#v{djVpt$l%DRbZ2keqi=+$!nZHH5*HrU}
zgUlOX7d@aTtUH~o!JV?|*;~QFw&TQ{qVydmq+^PUczqRByI#u*Xo2F790A52EO+PB
z$&-^+H$Hm&crqVZN9R!Pgch>e3k+a6hJR5p?&FbveEIT4db_Z*CZCBF9grQ=$-jMj
z;_1Fu1k`{2Jd@UOAtPgoQXPl`_A_Q3=fiyhz_(G|Xv9Ere1poAm5z{L_^;RK6cDlO
z;wT)saN$CNx;K<QIjD8Go<Z0bSPkuuQ5FNqgyR$zFq3a9&64sYuvlz+oPMrcS@dV=
zyGL2z1#J|oSFKVfjbrK+r`wxxjUP3{R$T57sc=ruVR&x$dd<_-C`NJt9MV24BJ;s_
zUI?SZkt&!nW&gf?-w9gbZ<p=~2^m3SkpAiRV0dz`5YkX&Ut6fT%g%NkRlPYGG?i9A
z=)D`g^3Llsi_$kZK^IPe6(~U#w(&l=XHTCzai2dwkFy`|)RJ(4scR%99~z-S*h4gI
z)Tm$IzE-Yn{+LDYnu6eYR^KUMH62f{`mxX=)(TODl4fbpkm8<%Qo!PLn|aZH9>0Fr
zB8s_!p*TtL_Uvq0IUKldnwOxI6@_!#;WKBJguPGQyJN={lBm9l63b^ye7ta-rVu%r
zJ1wzQpwnwebw}8LYwYh(cu4h7B5OZ-(3M;E+I5nWCc)JiQxBFt#f*2QXci~aD`Q8M
zR`XPpP2$VuIq9{+3e2ERW8*}pY3N_%s71NPjUx7(<8w#3x;w%tt`pFpsf{pA24S2P
z<r-jS^9a0J9e)HG=GKa-EO=n)t^S3=pg7n}Gq`c%xD!QfXT@4|JD~0x41I%VH16qF
z-9}9rz|NrQDr!B!OWKM%?d)xkIJw0?#T&qinqx}Fn$;w0>eC(Ub!@E{8`p!edoIQR
z#|e#T@F)Vk=+R<8ULQ3rfmJkxB*ym8sYxYjw4NGN{8PJijpFc#PgP$%J;4I%i**#}
z{w^jh8pRo776E#83$qx63C@Uc)5Jgqwo>Z=RB`eq$6KeLX+PEGBTT=7%a^0GSM~ly
zLH_;r;HpVDk8-$uU-WzKwPWYbt7P)r(uFoTYKp@9_sfufsH>^jmUg{RR#tYB{+>lE
zXY(x$bqx(qJxOd3kXtpuI3PV2IA5sicFBe~d0eIW5C3KQy`rNywh~7EglQT&Ljd>V
zad)@OPY50#@yz!)qs8za$5YPFhd*vHE$9Y#J>wlWCcVAUhQZF>73}<Ik;Ft~ketG0
zB!dCvH>b2~5KT_=gckklOU03b-`i&rq7!d5c#As$nDRczUl<tZvP9|uEN|%U6fV|Z
z26=!(2o{2)+&;L0KzZ4GoocG<^{UM&_ii8`06a;U*>6XKrfRJeWjFV9rZS*Mb_!Ir
z2SEU){XF{M_2|t&oqfK&dz?diaQFK4u|>zvk(l5v>hUuVhgYpZNzG4It(-rNN)f9V
zc&N!X?^8SR0E8bUE4jJTR@x!Q2p0SLxlIggGEUplX9gb-K_w+xPfkV_C%uVg%p<6P
z&!GUY5Y==IJV@>_|Ez)+m+D>+Js=|BBrD$K3e}r4YJNE=N+$($^dEj+{{yC$@o+4f
z93k^fm_fAK7#t;9Mvb>Etcz6IPTdJP;LsGpQK7xd+A-E`RNJ<MQpJ|aI}}2Uw_bi!
zHk#z^W_-?ZBK{*>dFJ(;zcH25N1vch>M&rQWBlXSc?a|8)x+lwfsSc$?!n}avbUS!
z)~U<j*78P_17C$rTTCgY-l4-yD4MMlKw|AUR$UI}J+7oiCZ$Hw6U4Xq&ZygraX`@G
z5_<btpa({M+Ye)64)cnR{36N53Cy9QFh1t|>e5_QrmG<W(pu}6V$XFINFwcomZ|k=
z>VgFT(sVvyXJ)>Atc&fRlHYn-2g5#nqD-Tv3#f72Nw{x>Jh~QD<IN7t6c*CE0wQ)J
zpZuW1Pg^+UNQ4ek4~~>1{^Q3xDWqk1_Ur(`j^c&w)&p!b&*beJ)Oqo%zJUP&%ieuE
zRqpw>`&^UkvHN^evr$F&$vWS;cVXv~QcbMKgjs4C6LK`#wW}sOX*~TGuNtaiy1(dx
z-#cv}$}+BN*RkVm#LWcQg!5}P+P6<sGGR#TK6maoIz+A~GXc6(N}uzEmuG~;>09ZC
zK|g#2M~~uZy;b}n`iYE;jC{-7%7^o!czA~W`o$1YGbT6IVpkATKp8&(S<~P&S<CVU
z#!yEmZOY%ps<(a5v!Zm)F<K*JS?{?&4L;3p<|$a1(jSuJIRbZzi!*W$Hf<f~R7Oc+
zbG~5g^3|AP)Sx!o7;Nc9JN%Ir4ph91dHkH&vk#Y#9tyIGkIuQvIrV7~;ukhw^K1#}
zKzFTG(>2a|t&+xSb^t5Ir(>`Z7l3pWTRlrXaXr4qyUtutwMmDay@;urX-=!ag#FN5
z`1<)-S$@<x%;k7FX$xMg&o403*iK?$dLZ2y(>0k;dV4QV+_C|xc^-7E<U%iS<)M!m
z>nB%>c`4YokJ;ocU@7+)E?7*AmPQV=G51N)AwX9u8Gb;NnYIi6?&`ccHdlFR@hK^J
zbab!6_WNPhB(2!#-iy?6qGmf(km^*%m?x>RG}`@|LLt*>ZQIS?kTd5(TJUD-4`gr{
z#~#8H9oHp~bEm#OMm4$@ya)5rUIV-y=`7x-(R=97{S>vH`H|}qDi+V_x6Lp7z=4Sf
z9Ox9R-{@(4!kmyP5Z&iy4mIyG$$LlW49*Rv+~w<AtmR))`&z4R4FCFDhh-Jy<HEal
z6Z=;+1t{=j1Q^sKdI%EiItGIVO?jhd6k)IRbBQ!Tly@H2zwh$-^@p|+vZ=%Mw-$F6
z|E(wD5tFgZaDwYEJwTcv_+VYIy5RBp)vFJT+Mci-#FuXG5ANx%eA@>{r}VSwWa-^D
zpXap*u~H40D-}~2LCb-EU+PS<JiRMCJexONz3HDdt&BHYz^20T-Fi;d@N$^%*O1qR
za5C#>0*A}RoN?s2g>{<tdef*#Kxk$y+!}X$na?@ihHDx$afxWkA)r0X@bw*0`<`Al
zk}n%sR>YDdf=zZx`cDg=N)U+a;BN+ohC88qub<T>uux_y^c6<0JKQ1N$wtzqnlWNC
zJ)KfC%%aOQM@Rca+n#kJd2Rdm?`IOzPE#}K-uqj;<XNP&qW%ZsUXofyDPq^8Y=1GR
z??d0=gzaT(CZCSMPq6cWMhbNe4PNrpH|iP;CmJf?EFRAsYo^$~XHOGuyObYA!MuIO
z$2g7olgNZm22y^RVTeF-Q0O3<)ua7ZGfo)OoZE^gmJ*T<sEcA_B&#0)l_&8rQ!iW)
zaTpa~BbeFw-rchVuAVW&>MvZ4XdrBE8W9g-)kw{PLeX%IK|%vPh$&fHP#$$Lwc@4S
zSnP}TfN(Q#@Zb`lD5<llBsSsH^c>2BziE^SY6Qc54xiK5YS#dW@q2OYpGH7Z82VlO
zoX*TT6JEcN=pfpec(ub>x4wu_8a4#@pXODf_Nlsh9U(}(F_|<buCAHE>sGAwt^M5=
zzK-2*M;siv7FT6~AJj8AqBEeiyrKOQv!G=krsE*T7SOS-56wz<L_}=nO4g^N7)c8S
z54h9fLmFaNzy}lM@fkRC_$@_o3l}V2%y!k@Sa6}E-xwSS+=!EeLdbAbHlz8i3(s|6
zsP!G3kCn)>B2ws~fZ^*nQ2DKI#KJeMt@+fF?6VGhQ1t$$4EE6nJ;$qyl3mbk(j$&A
z%S-LEv$G#?JJ@O#AU064N|#!_ds$#wlzbpMUGgo`+2DNd!dzUa6d$OX7-5(hJtn<G
zrKGgvneL8=2!Ftq1X;lS0)$?0VS$M`)JkMM6}_a{+~>x8J|Va<QZhQ<J5<Ce1h6`E
z=%<7CW1EIRl#A3}<mm(pk$*y*!I*5U&v1%cyn~ye{*x_R_<ARt@7eL>7LOC4&tkU2
z{8-IcX>IMZmgzrUx9>6aOf!LJS*DjC;-t@Tfbb~xCd8-u#6xJY|6M_Cnv+<7eYQ7L
zTJdI}vk@atMp%(Yj%-?5yt*x=QWi)$#u)b9?oY=T5bAdm&WX5gy*miZw|{>SD76U1
zFuq(7`<~nSScK~Qs*Sv}HUO03{{-^QdgAq*qzt3`^UUV&A{kz}bm>Lx{fdP41ZI*F
z5SoP?cC?Y+z!XKk^D%Y{b$^yN2tB*ZXBc{k-@V4lZ8xr6i|dn;5+RaJ1(TuuZ3hf<
z?t`)2l)BSpzwS6YBTrgLs?acy>}aWlup|I_PL7OROHDzO*v2?_Y6>X?*URjl1znY!
zls@co9lZtZtT_<8|E5h_PX3r1M`Bup!N97r{Yx9Kr2sxcd4g^>sCMuD1e+~PHhcIy
zW*-my(5k-M&=8MSFrCdf|I!AHd;4N&mQk*0m<b*r<TGWT=a(&;Vt?1vNXVkdplSL<
zS!g-gq975fU_oA9%9C+!y{Dbui5cB^3k$2c2SD*!D;NgE-}BxgoDbG~X|%gwkBo?3
zhXq|uhksGg?6rsu<vey(JbL($pR$d4lE$rWD^64A$yir>rHi-KXRU)}?D>fz*igtw
z@>1W%FM#Ky+5mZPZ{%?`GBQ&C>F-n?6XH)9obTPcH(|p%x|oCwBM7)84~MAV^&2z*
zU6nah%EzbqTXxwTol`XjYNqPoskU{GZ-|RKpFguv0oDm8SjDjF`-iB}*}k^kOJC7?
zq*tp$R4Zi!lsY3zY0alw1H@=~ui+ficxwxVz|YuEt^87+#kGw9*m_B@TMjFIwwqgG
z^+O`DIo?5EK7Uqk)k<rzN@#78NM;QLY$ev4<}8ngR!ZMW{@cqEfW=Fe%x38D-6?tm
zn0N_4OBzb!L4z#+5;mA;VpxUvaNE{^fL4bVxlz6HRKXik?ge|#XWwpX8fCXttJ1Qz
z|7-C-E<pA-n^n!qSxR62z+?J!6Mh28K5$&lmS<wQO11oaeS@YOgQNQs+!*9t$nT?X
z1AUk21gY2#IOiCT>ePu7R!O?JMor*0-QL|t%xNH&jEH>=Wl(+ik5@Y^o*sEqgyv@e
z=Opa>JHNUGT(Z^*MAnC^r$_Y1xQNP8$}x(s9Fk^Z%@`{Zh|S(v?L1E4BUAS|#O#g1
z+R8-(X*Ge|q<kp9v6t1=_N%NmApc?Je}|Qq3PzeEd1j-{%nGl~u%svDB<(u?j@MfT
z9BBLcILK{6;j362)XFO=7JVr%GBsa*2?XsS%aBg*_he3Y2pbWgFTF5}w=Z8_#+~8x
z)}AXYDVH;9K8~X-O?Eh);JEG9_3Kgi1eGp4_h=D~!35Vv-wAq0#_QgFqwJvbkdM*J
z;Z)p{ZQax3teE%yUq=&{-Q)V?X}Bz`2NMO5Z?&sOvMI0^tJMFMk{^5nK0%mOWc5*0
z;|y=lgC5O{eScPe?3gi;j=lH|F-R1cF>DMr`<Rh;ibGNqYRd$%zIavK!Gy2#I0x0i
zY?G!$VFGFYwrkdn7;XWn&JF23Z_^g3YVSH9NDg401y}1@TKYuA*DXLy20i5?9C43-
zE*JtdojQBA_ubWPl$DoZKEh|*&FHm~Ri6A{o3;yJUpzo(3hWH(>H7)}qk5Y*oqK)i
zp&a&-mVY*2!k%5bx-M1$k30b|$gF4<%bD}Noe&j$xIEJ?*6KQVT@%fu>~4B`)A6jp
zmVmL)97-*~a0M3~hor6>)~}bJ`(}CVfc+bjyHQcZnrXkFCNw;=t+3Eq%5&fjYV(AQ
zK*wHg_V&BKPwBp*Lgn9u31iz#J~DofRY`ciyxX^5LzpCDIrVZ*7htlKDu!%nM;96w
z+!>~rd>5eua8U&tCAatm|I3Bo`_U<XZpNo&o#0MRZ<p5u*E*4-d$`T>^duKI1N89=
z3>+J@yjO}V>A6=Q=LVRdC`?XIO_->Y&;s^ur(HMr#~T}Gk;VcL31MISWvI7iP@N}~
z{xB<Yrgg^iSiHT(PYymT&Uf9hQWeRncoYCPQ&JpN9(UT-45$K=YbX2H$@YwQ&xH@a
zK(6JH6~tL~_8E0_JFT`tfp>t;g3!<w{|wv8xYq@6-(#vSLe9ogtKc^(_KEOwWR}kW
zWRjkW2u^06XxpNz*?f^>5unjbn=pQb!CkU&sMEjywxp@LBm#6l({*&%aXlYHlQLke
zTtf{&dYt??RbepmS}Rd>ikUT{?;_)`Cvoj%Ol<c)=OISO&z^M@Ll=T7vf9n8@yW!z
zg4r1I6`|wTrTuGuNUct7&ke6jOZ|`-5qg`0jkYxoeN!vGb{s8n8xof^ndT$n6$1?e
zgfk3-O=Es_4HS=8np%{+@uR=lgc*50XoV?&SQ{W1S||R@SPM}OEd$`t?<uNL&c#-#
zv5=>VZkt7VlTw_9Vm49_t&$9<!DkOuSDgoe5(jJ?5(?l@OHj1v6-CS92c#0kF~^^*
ztE|Y4>KyNvdNpl~&Ye^Ado#q70`+k<3RCx0zBDHPb!4-AS%%OjmBlj*bLYc|74IB^
z>L|oLYiq+d&S!FqZ+$gN8rH(8$>bVIqS1jVItfjr)C6HIVO&53*xGO$9kiG<z%CZ;
z2yRoY4F5fj;WZlOM)J(a&rN_=C}&+@hcH7|Hg*aU<tkqhivnfxj@TeDU2)-LixB|c
zxE8U>pn#>uWl3W}`m+cR$Kj1JH|yxUs@gAdIR#!HmNE;Yg(BLz;sFU8D0G0h2$Aul
za291=jWWxRrBlFL%$P&sj308eMKK3NuB182i$-Jn-o4!yZ|#dK%oT<m+o`j;-a5Lv
zLe>yvFB%5M?MV(TIw;r-QjqHHO3xliJP?%&EsVHtAb^~d>Gp9U9hW;gzWhFBd1#Hh
ztzN!dp&YvEYa>u_h!!1#I}UY-@4CZC&K1TJGVuq_aG_)!Nf_e4>MvFas=(1eo+dR%
z6V1}3C0Owqy5}n(uD`r=XpD7}12~6K`iZ!MRiX-Rxs<^8cvNehY1qA&+S9b<{lNI^
zFtBLGa(FIp(btP-zke#hri(pOznVTCj++mn77gKg-CZW?8qlo;%olvjS9eA>CVFtH
zXusfSD<s7<ewVN?qW-<}CY|)Z3EGbM>SC)THy8e*N9dlo8lgcj3oD^M6{!!W_Vefx
z3bGeZmlltLbJ9vp?eLjZI*?x4i^maX)An&{mUy>Q{p;xHxL5kTdiO2}>)8%NmL0q7
zN(}Cd=>W+shx$q^w4lIZ&wp~X$`89PP%(DnEG_*S+%Q}olr+bFRzfRbk7oe3z+z$h
zx#E6Hp0GI_a>ElDWEt`6692GgzO}1^Dr1a|(ecSHbx{-%28fLzqkBysj=wg}7CE3=
z3y}4gjUFuq{{%bE?Rt(9w*nWht`C0AAm+;EJuZ*fAbe*?-{5++F<5gBbO1j<(V~E=
z$&ADy!CXdaTY!uss-)0fZW({Rb(=OZ_X3f(o#&5;`5~9V`o=P7s^WiKelKYYc)e||
zSrQ*a(06;L%c8XeQ++`{A&zUfi{1R&(U6%r;qq+Ln3l}w6gS4Y4h%nk{ykkFrpP+(
z;WRjZUB-#_ybIm$wU1H!iXS|-e#e36hphgo!mZB1Xzl}<bxRxj?s0UDU|3?dBL=TL
zOzEyzG$)=Nv=m~TgciFw)9~cbvTjT&u&D@!emaABmRK{@zr{q>m9E1S4^?JrM;ExV
z4WxsZJqb69(-g9Oy8_P**&~5<$|YK1=SQig)}K(ZY|sHwwceq^LfWkePx*Y-MXh>w
z?p%*C0w5Mnp!b@Vq*az>ZO&QMPE&J#-+%IM%<QY)zWuHrXRuKtx8|;zsvmZl9+~Qm
z{Y=^H`-z;Sm%B5`Sghsw-gL%67LVP~{zD4<YZ>Y0))|X4?lBFh8G<AR91;?C?o@#s
z7il)aohm8tID|Iq29ewVx$Wf#gMuamX3Y9)t%)A1F*i!tc=MZDF=vLaAe~Lq$4>4)
zCfE3XN*Hjd{4#G1#^y4}9jB`<+g@1Wg&>>W%?hE9SWTPeEURD~t600tq?@vhGFY<w
zRPK-|8!{P{Yyu|H#<Z8AE?x>(fi~)ZoJGZK{=2_Wbc49q#_Ov+P4(_f8kdlTF=gZ<
z)h%jE>-atl-2HM(_ADPXmxlA7Ire<0ua8LxFXt+RjNXfPD)U!(F3mxCr<MFV0j-Mq
z?s-|+rp!ze*-Qx+Ad@p<Fe`Vb{@^Xg6E<V7OZzlJnF!^6@94w!+q#5Vi1noi;?QXZ
zJW_JO<_h=AwaoV~=jHwT?%+sK5R;<CqZ_+Tha}gwa~U}T0TuNPhbO|)hv%eV#^Mrb
zxJlB>Y=#`<0`f!Ljmt0o=!NC;TI3?Gtfi2x&5#B*2J8Gky50n;=lyN}%`9`s5H^(}
znTl*PB}0=T6`~?aWuB+V5Gq1SDO2+((ST5iNM%UMkhz4+2`SWh-S+Q)&N^$I^Q`qe
z&;IQn_5FT6@Ao}i*L7cap9b^im$tQu0=eEzD7s31666Li++c<n{5SuhTsW-j&`i8j
z&kX%Gj7f(~;)@LMF|~Vz5`pIo!0a9$|FO&dBlu8q>eb0nP^H4$%8_goB1*8eYft5m
zF1&?%3Gr7ZwrjqXHz1Z_fMWG_<^VBN0sGqt%6Ddhso#Bk0vQAv;o)VdmV(S>_r;4N
zfDL#et-OyW-OkIC3_z{x!E{EC;louBJJd4*>Ix&hivydilqMmGe3DFZym*y|;j)XU
z41!5>6#4mGAv2gaA1dBzG}+D99!urF;jJ2CpCeW=9KtKNZ?_U~c*4G}p1jj$2jevH
zh#tr77Pl|1tytyYGDWYd!(2{%^l);!$)c8#Bi_c*eYYY*PJlNC#nxPZ?lGV;IbEF8
z;JUVymgEz4CFjfCrai?`yNO_Xn>K~H)zu=<OE`G#Lg+!hwk$(H8-iG`Gs{-Rdd#BH
zI&coUk%?58$C1oY-xmErzyJ4EIy%Ol&G0NK$teI7$oRH`);_`YPx`5?-)7zEkmSF1
z_EV16RQtsHmDf%JN5xu}93L>5d0&e)6<cc8MX}n(UfG&y=Awr4m`dt6deDiCx=P!s
z5&hTVPbn@w6ukq|S{qr;s9U(l4Xv8R(~10X%ann%oaUq0vuyG`NPEjD>cX_uc8nGp
zFtROrS{5J%qd|OoKfa5^gfZumlbH%_B!bt^UZ)i4)3M?OLHSz`Y$&g~+HttYL3i|W
zwA@>nHNRwD-^G|?CBTcitsjEr!(-giT^wD^hEUsJG8h+eb^qI2Y^(}JJpe7*;bKQG
z!}_wyTLJ-HW+|svemz%)#W4A8?Fz^1nXEYTmV-d$+XTZ$DZ98fmMcAPE<6TA1;%(4
z1&ndOo&d)p)#Y-}h^&x!P9X1d#`Pq-(#6c_@Zp&b{#KYEO@Ls3Sz4-oqeU8xeJODw
zo1*Xlj?4esII<par_U&pHSLs@8_|ppb}kT!!-n#Mt;>qg;tFzyJk;fVu|G#*_Uzf%
z#fZ17OXtd2G7XQ41qYu{pUJD_<S_okME9vP{p)iHG9iIaJLGjBLdvi-mGU*Z=As|x
zHg`cHC*Mm_7<hdPes74nXCJ92#hI9d%WU@^2@n+1$`?)t@vHeChLE5~&5!2)Y}Qi>
zO0g~$Rj`CKP=8+Nr5|S~BydbKU(;k1B?9MFro=IZ5ZIGil=>*feWAHdPnlbmHA2$U
zP;`WzwRc!kO~ou70pqyo6ISm);CR_fSz9*0hlCZ*v~MC!@9kEhVitn;oCiX_U=TUw
z*1PNaJ02gp!XRbw7Z6E`(&of{K`fayr-Hdcu6+6GmBq&+2S9K#rNG!fx~3`M)OFrq
z!<;X_t0t;iCHL@@aD^u)2b!(X=4nwEE?%5bU3t}V+Jp&>=`~Jnd_IQng!88YTY^xx
zUMA$xgo&_~q#b9I`I6A^1(REuPN7-Y^Wy2!ZFO~zHZxGZnlZPV`_(;>uFnSyl4=`C
zz5*f}v3P)k!8-HAQ2lXpd47{jOs20fGUfj&yN!1Jc{=MOWwqrrCufv;^PHTTqPhX|
zja_==@Zrl?F|B!g^XAE{&Gjy4Wi<qK61(F+C(pmAcx0cwuz9z*3vZfFIPuZl+W#?$
zlTLCg=saxi-xKd$??k_Y4Qt&x-Y@uJ^JIha&pMmIdzc`OxiG(jvT}?{w%^(PZ?a=s
zTx%3}XYI_*XNUfHw7sz8!QG?;9k_|2_jiFpvp$wQSXfc|%#qnoSxQBKlSM*JyG{J&
zMrBnYrmzh24OqHBi@M@G<|+k4EVYH-Q?R|b)(q9;S%k>|DM``MXed?wMOy-nsMxJE
z9&L<X{TEcJ0wj4(B82E5r3J`Feh`H_JOULI2-k_FA*G&!d!zP($t8sU-#{ct{QmsA
z#wl)fTk5}n>o9q`bjgxiV7vhvE(yCtS3GUTrGJ?cH{@!;Hb8i308rm8E)F85Zhw6v
zFAv@DKx$4C1z58MGiN@WUGen0*>B1`5#Vy+4j(%ffBy`qsbP#oE>R_J%^b9W^lZGk
zsqv);U(v2BZe^_4{MW;t8^G1;zd#+Jr(2suJCaK~QVG-*g%XN!38ql4qSg9>L`UVh
z+Zula6FkmD`2LZbew@r-Vd%1&+5@x<BrJ*U0_@bm+`OQRw;l^qg*GO1xlEq5YSiW$
zKk)BC{rdK06~U64U%v(o7?6;)8P^-=t_i>uqLcc6>3VNcF>E`&Z6gjYQ<+u-df!}L
zWf1~2o=C%nMS?c9=FWZ7=ZVgfSyyCKVb`*<+9=Gox0lzGW=^|WPB?tILZqD})=$ML
z@4d5o*Pi?ZZT1K!A%wL`3ZSPC>B4J%{#;H4$*i49^JdKsA38LiAD{B7qo<+6s=C_E
zNDD=cvE6|j_Zpy}w{H&m8;kN^`#n8Fh_OfX7EMsVfI&yOStC@N5<q1s+x4t0l(-(8
z5Y%8{hH9z`{GhvV!IYkG@-u#INX_+!1?KrqSMw3=7MQ8QL^UH6HG<gw1_jGqT}Pb_
z1doo4-@NNTkPg6#GGY6PUt4A~3q1(g0R_S<%8Jfy+KlCSGGq3I`bhLtOuCI#(5TH>
zpvzB81ZiY6r-bSpY3?l%Hxj)8i}cogdXmGD9Hgnq(icx|d%K$Q`yli2q2##Ik`niQ
z=8hEK{1=-(W^f0XRrDi*Di2Tecm*)1xE1C>YUR#=byzPr#5^|c*Cw8c4=#7?-KmF=
z$){hx)ML+{et-isq$}VH!ig^VI?pyDHBwcm<?|X$#Blr0hHr0`K=Opg2gZZ$sW7}d
zTYP+|OPSp|N!#UVe-|RLX}2lN!Mo#(5z+A+sx-TrYu`3Nn>M@*ju1Vlq{}d@y$&52
zy5c|a_0q>@x!)T2QwSdq^#P1FpD{P81a!6zzd=_}tk6S-UvKtX1kRLdEDM;iWIo_%
zBIo-zC#Pu0>m)ckeUg;-USu<qh?%EmB~4H-&A3TpX5lLmH>SQ!1PVu!rmh}lo@B8`
z^kksDOw_H%Vk4x~V{lK@4V;6MHW!B=;^5KFI#qg$stmQwz@bBD?$BCv3g8+s=`_wi
z#Mvvjw3w;Ak-$yisX!AEm7q)p@c?K|3?^D#1e8R-dr-a=D1H74<MXc7y2vJ~AwipU
zi?{-<X>m$%Ug+0$BKFuhyqO^$Y@!4p^q;=DAN^8^K%7t!tr(GKXi!rD$vPO(K~C^*
zvf+A0LIP~(*aAHQU@}{09`akwCwejR)JI6AnWHp4{XUo+XAko=3s#5Zbh_Zj>^bd=
znSH4r?CtHn{#3?MVgI{!HAU1(CPs&;q<|a|w?Gyy+996P5u!iZMY((TJFsp6nwpwV
z&dlGPzrun~V&G}`wK%dhfLDuFts<e7_>q<mMle;xoR{j5f2JnkE%=N9UgEw)N}7jk
zDsxdKN_pVS-i4sP*1tiqH<AI>;md!LAXmYU%>ix@sT2z)o{=}>qitd)Gsh`&tOzgA
zYi6O^n~abS3cU6XV)>?HN1m|T$y$Sq#Lgx$jb#1lE7V+rRZi;C^0rgp+0uhG)Bdyz
zt)wMC;0axf;@G1td!D8<XtVWU;P{@gC3ri-(px5Z?P=baA!)miFwem>>k^<#AjT0g
zE~!74D};thjn8G0zgVthOia1SIXcBvz)ub;?`2S9s)pn6eJXlhg4qq<WlU+$SftGs
zyk+4hVj!E$`v=HmF7wdeDl6lBu4y`8uVsink$3F9F2u;xG@Pg(K=E^*1t`bj&h!t3
z@QbqOQ#5m(=wMgk)d<<vm+LEUkK+x|gsgpvW#5{!-K*Sp?-qS|cYO99I(+XZHlAo5
z&f?vH7@vZIc;{9&pC-KFXHAP^$iQ_txGPiVta;g4fx|Qmk{l%dlHSu13{E~|ApxPX
zLI{RzEupl*{x_Glx@b9`uRoN{u_5ydo$R+ku0=a-drN7ESp&G@#PqLQ2%*@XzDCtk
zjnkuC+lFJQ4v38bG)Aw%jB|h63_{_?r535jv!NF!_3U$kw|g87&PY^6J$^k0_adG=
z;$zT+xU9AVs2IsC9(E+N!L0oh9)=sW<0o65eq(oxfl;XgxXb8orXB0@fQrX#ee+hW
z94Roo`wx7ATc-RlMt{9C9P{Sm=1>UTUOwzRAxy%rWHXpH#K6KA!8*FQb+u4ttNB+F
zoBVAVcED@?H1T%v-Oxsa3(Gh40X#*z!WQx!z^ILg|EBb;qP1fB7-xt9Cr7Hq{=?01
zUb@tFe!|uE9fSA8?xJ02tANe1+UoXq>xKbS*SoaZ-j(A^<w*K2ayp$mm19BeKnEc~
zBi6i0KQryoIl?=Jgk36v?D1h3$=2%$!z;X6kX`6Bdz4e6X~K>4j!1TKkB)6;Pb3N>
zJ0g;tTE0QjFe5+#7y2<kt03xQUGEfj7I2E1rVj?JYy}@wXuEiZl4J%`&A1NF12_td
zKw6Ng@3JeJ1l{h^fz(70mF08-@T0NG8o3~z6VTzMbXdg;E#N}|YfOE7_?iSIq7HY$
z_~U%vS70ldpqh&oeE7;t$#msC5OFG<I*BwIwsG0hoCj1oQ<+bKvapYOd2T8<2t(7i
zBq0Taf9*&}CLd3YWK|Ch-&FNR@AU2_H3~rn607mt>rNF11m#DV*dHry<+v{^TFB?o
zB)~+Y2}i4-*lnV$DdsPrzl_eG)+d~BtygksrKRtI1D6@4S<Z|u0|WbK_UIGap^teF
z3=WLY(^V$j8NDeaZy^K&g?2R+!B_s*Y7GVc#UU6Z-avhgr*YD<OZMV`j-n-p&MxC_
z>3Fqi)%^S2NJ<ZAJVh~uycg9ii6-Vu*>!s2RG>m+`$;f_v1O&`nX-s|-XD@QCrz64
zf+nRJy!Q-8E_T&(v}^J%nTjWm$?nf|y}XuVHh%L!d(v=h>Kxk$ua%f)P9Z$XAizwU
z50EQIb>=sIzTr)``oZ+k3`<l)@;QB|OAYFe#TH15$i%6aq{t-EMi1Xgk;VbxryuXC
zW8aWj-D?!j$Y~GKd@B!6pEQod!MH&lu(jytSLl~K{(9W5s2>Ueq8fU;QR+j79%cY(
zfK6FaVg0+zdhUlmkTcEsv{Lt9sAj}7M9^%FyeZ(w5fgGBVg!`o@tXa02DD|hUTSI!
zRuhw0#Ayb0xX;MDg)6Uz#v;2Jo6=%4@z$iTN&A2PvDI>`Ltn%I{Mm@5n|^*#t#|3H
z$;>m1z@Q}Zf48@40-dZW^zmPUa_1|zYYx!0M+Z9}MCqu(QW(f2xy#&pgj%974O>|0
zyTHn-1A{tK(3X69loVC)<A{$>CfR5u<{mEH)&cGi2a6^}rJ}fGX3Zsh{$&8<M+Bpk
z{j;Z02K>it%XmK#M{0`FF-dzyysIB<5E5PSxk2cIJ^S`W!iiGc6MRe~%wyht{hvgh
z`8C5AewH&T4tlLjJqjY)a4eerqLp5}ssU-sJE8Mj_iV#%cy=_5!p>_%b)2AY5!vX#
z|Iq^I*HdmbK4SHc{`)EReHHqAAF<<tY>lR@>^OWv%6BSa6u*HG0dK;MeC1|QWLus)
z!Q20W<6B#)O0FE~;BkD!x_!{GzmXyY@{-`FFYtZQN#3O(O8F4O+d<|DQ2eK0&)l*K
zKn&~^phi=a|6zT3+B3>&v3EF=6PoZ9cuFEahXMh|j9)*=$}`Mb6%`dB#En3lhy0{d
zw{HFZX);F4Nl`uoL*C1z0hK~c?R>I7i4F}bdVotQ<9EWShf~JkoiL+pUq=Y4aU6Le
zeQ9RNI*~*>R%RI~VCS&!oom3%hn8!pNBOaHsWUn3ylczxuN7ow9z0FH68aP>dH(K}
z_cOFNc0t-Ja%ILXmw4B@o&0&!bEr?8OQ(OALRNI!xleWDb+lAt8R`mH8W1AHI0C&D
z&PQUqK{r!&$N(K85D(xxrU#B9)We@n2q6jGm@p_PkRI#zqRK9dh>L4Z5qti^g%Z9w
z&eyU&Q&y2-GdT}Nxf6F#)=8|k@Co8OAYW4?NDDs8msf&zWnvrdG!&9g_G};s%%`cs
z?;>{8I1mchER(1BoitJ)AN9F66V(icr7^{cX)*L50=@|PnLkZILF^m&Xpk;rns$qr
z10T*vwQR^mz~2!ZP4;wR+qRVqc$uvQkg^8Z7ID<)SKt<9!v=Jcxbzr5J_p<><LKac
zG8xsK?_Q{T${^%2#Q>W;w{kmU9d6nSuY)0*`08W77`tXM&>8@p&;@n-(<)o-DS7w2
zYKi*VMn3kTY7=~(_3aT2=9RhCt8L5s9$G5%6B6_^Ri1b1>v{d3!Cv+ols<S&sHYTR
zoV3k8tjgB^dH3qXG1E?;8R(aqu;|pbM^6Xcx$?<x)$vMK>trX@duO%BLBPSnXWhLk
zP1|z9JXCNsB32fj&P8Qo8Z_9GuY`?MgOIXZcMM8Mao2fAcx3c~T54~7a8gT<mQE-h
z%XMTo*KgJl?4|Ytf|7M`vK=V-rph?LI0|<_TU08RAh8B;=Ca5eoQR7D1?pU!Tt548
zB2!|R+|Xj5VOa&AW!9zjI*{}mq8>c3qG!m0VFkr;q)5g@Gl2Boy!JSe6C?OiOxH_E
zP;t}VoLm<H&xvZGX}>V50}T9tR@1Lh7Pg}$#R!Pd3YzFnwh?NWlt4SmuIBvo&6{8g
zP*^Ehr+Z8~#8&B>;9wjYVZ12-cZ<@eTQ@TbzfOal+7LY!f)xU1o4x*ZV#K=sTy371
z(d#99JUsl$FeVURak3yKYwVimgjryGe;y)X-%C2%;+CyjXQNOB6PM!X{>jep1oof>
zoO{^^82BOT?DUN-+oP$n!8wUmLm$H@DoAc14zOZl$Q=sNXl@Lt1b&vy{DBl_;Qx@M
zJN-4vVAD+*m_iCzkmz87w;2N`orRtN#v##TPHMHVCMC8$?lC+}#TG4k0um76#5>p2
zv|;VXF>I3?&#((WR@SUVMml=eboFSO$2kx|B(hiHr=~$(jIMF^eui+IpI%70>|#i_
zHC6rk^6|A}Scvt4A+h)`6^*I1H4>Ko#)tuyN|8!3+I&UPHXI3v9hgSUa?(2F$n%Vj
zi8;e4SV)A$Fu`#VICHu}A_`~222TMY<WsgcTcD=4#+@Poi-Q|{JJvB?Lka>EdwqZR
z{Wy)~e>IFfjGTz=VJp_G>32^bCC+X-w3|yKrAkArMrhmo@eEc$2u%P-Z;xo{MBUJx
zAd2})|8`5d8$i;ZaQ&)C|08y++sk{GQHmhtV&TEF;W~4v{Y3J+V(r>U!Uz_&hZs4j
z1paE?FTMa*3EsRBhLtohVPxK-Q)0M@8iY!G!A6@j*279#hM<A{(OuMWE+r*8gyX=L
z#b=jjC#^-`VggaXGN2(8{<@3K#R@x1J%=2^kB<!*o&`N6@t8MxGUeDip#_VJ+hQij
z4edPI^?d$8Lzmvj1PI~Y)GyQL%()4!mxBxrnNd4y>lFTtDNGGy7TTSajD{dFb%Haa
z(PhIU{P<*)&RAr|6{gdGip2(Tmxae)0p{i}TsULV{$ZbU0S!CzA;`vz#x>&|>wlNM
zi0tv=${-%w5o|r$o%7S9SFddPB6olD`LMk_ARc-*4qCVg58=z_tqJsea4-yw%?Bsq
ztM}>pP+QLfo7Du@uQ|Pns;vwSpY7phS1=cnb}uWDWrLzKNw2M0G`i-kI?F11YiVWT
zWW|BdW&ICv-}%Y;CpX&#icdQ7=b!kUy~S4U(8r0;BaD8XVFwzsodhe3xIhP<_{|`_
z=2Y;Aj7-4|#zc1m-{8}6b;SvjnR1%sY1606>KS_8#*C0^wEMP5$YaDEZGj2sZt>C-
z`0EMkPja+^EO!(p#xdrzV}1a4SQb8G(7PYjo7u3nsEN3#Oqn9+|GAA<Da*oSmr_WG
zDkZus4&>B?XxyKK_Yw-G9$00#G=@NfK-xpS0tLB~KT0l=Jq}@E)8}v3HgwTs`i5S7
zx6A{OS(^2WGOj>2O0Gj$5F8n)nS6AkT&8OFqRvWP8If;pSlgPjk8#+vd2aTpjYUCM
z`tl{KeJ34ie$vHwMB;w<xnw`%(zkDKkhYi#Ow2crJ<8Q7VXzi>cc;JkGNKw*G~MX_
zKpHfXyApOgt1(gun8~wv#UwTRQ!DYPthm<EZXj$_;E~OSF8`pT{VPAXcySdHW9P5Y
zI9O1sC0Ojf3e@C`byjMFE1x%2-sf2Y{9NS(kDfWjp&GzM<|`5DY>%1^CY+yv?4zwB
z(!MphCt<3xrFQ_#%V8{mE1Xi?R9xOU32(6=p<&prVn&iV109{6J<-v#6J;t}p?1nR
zHxF)_<`Vydqz`Ve<RK=PeP&%m-;fLp1v*{&;zf_7wQ)NrK2X_U8P}Z50h@sta2Ixq
zm@%Ojo>QlH?C{}EkfTOupoDsY@OCm%)9VV}B>9c`08}F2fM0khI;g3!ud1}JeB>q`
zbc!rEX44*^4<rk+<7Uhbgz^gElZf0C5dFq3?(qko7ICP8#kxz?Q_CV&X)!c@#cGl9
zq->;9s6bXkSvGZ)n2V55UqbYyd|F@r;>B1BB;-5>CQ9y<0Qg7q$ksJ&-MSYz0#Qan
z`oq(zuu1*qH!gbcz-^gt)Zrd|%#W~>-g0N-yM$N><{RRrw7x<OW?=A=;`Y>&Sa9El
zQ*&mtAmuI7^ZKamz#oU}`1e#Z_k~4LV~h+vs=>H%ski`9*t2AHC27{hWI209-hdNc
zrynM^RMKOne?Kl;nu(1}#+jlFqlAP1^B@6`uybzTjs%Y8xHsWa@^<mBj`y#c{*-|>
z_(ay-t_)nmz!=AbTly7uQ*JQ|)B~E`{X?0O)!X*tUD2N7qc+KZ$iEm<&At>V0nsn+
zVbnqv37mGBvF0nL;4I0LMIbUJ0~4;N_jm6+%4kxmlC`~eD9A82S8Z4<K$!ud&-lf`
zfPjgJH;A~hEsS=Gs!~4SxyY41t<@1GLWq#9anT9oOBk5Mn&Z~bAJ9-!Gx)OQNX=w&
z2)9c{>e=3<?=(#9_ogY2QRN`QVMfC=^^Vqq9@NWLf@+kMl*G<iU^xgY8GHjt54-Zs
z``jYq$(|G*nt@5oN~+{*Tp+l#xJq`x8uK`L<*x}xx`WygU<yZ)k<PPJ0q;jx&4cWN
zp^WoDKSVfU1%R=Wr<$dlMlKMX>vCcne?eA(QB)A;FX?!tkKEOw^Y#lDhPz?=vS>g2
zmkyvB5X!URBQk&#vCCi?^O<G?7Q}&BH^37679!Y&_om7%A{u8gDreQR$Cjq_GLr59
zE!af53lRrrcOHOC%JrsPR1KEc?7+VO8AY^Gw%8fsvABy7zMHlC7y-6N#KA((DX()Z
z#dQFpf!KGW@Nhgs6a*N|7JP3OpIpibqC~icJp<i5M@BYyG3|+KPv~`jwI5Yg3mN?)
zv&f1(=|Ylw`l#Fn$whnchJYpkTE<sc^pVR|oMvU^$j7>QeALC_z3P_ZDPL%+3Jz8f
zl$bjT2@f|U&*-rD7m>%faaUbFcUQ#F0Y{UgY-@yJpemT7QRcd+nM}F=Gb)H`EOYuk
z+GyrF!#H$ycF(O>b!#XFME{I-^@xg!A`JV%gYrEh%3i|x<oa#%<IpjGLa8V++Jb^B
zmoIM>b>hiO@4(~c;pc@grR3GCzw(^u<Ip-%PSDQ@uiUW6{5f|@P6TB^3G>kC?>T}|
z&|O3-LeF*D7bZY9q%1lz#%(m!jmF54mnK^zw^52&ii>b2+Kb%2^tS{N(~V2Tu!rj4
za8Qsgj5Ru5i+;rdiLny|wO|w=g|t_MCr)qpuIuRJ1c#!Y_1v>Zogq}2dG6e684!hw
zi_7XyPXa02L&Cy#FdISPuJ^<C(nw=t<6OOs{^uqWSin<JR-wJJTNKCOPjB34LqoS?
z^GaFRTU$GfH$X`@)!f{GC8wA$>+k!R;=}Y9Au${1bsqz3G|rhk(W#<><cK3cyA21y
zlw=s?#{x&kuY@OEg0=qlqV{|f86M%X7iiGCFl9;SAzRs~(Ea=4Hq!Q1u-YMZLd;#X
zNYZ2~S2gYJvdsWBY_HVf?@>}J_KUKuWMd@vSaa8{q8|8zN$ItLp=m@ReX53)sTfib
z<s!GtVHm}-+kvtQK7+hLm>x<hXPRE@?16KVte!4*ZOQ~nB;*uA!vf~HL&^$GcrW^V
zZ%M_Rq;}T(JUk}p$>1mN65Y{jU^4v74s(eHp)`;*WE^m^eM~jrFGs+W(S6>7=BQEK
z=(pHwfb?xkuj%%j<!W?Lf6ehXeINw8a^rabmx{ivfvvo-?sNaQ-nQk7vuKv)W2E4*
z%bb*gpGX$)D8)|G*oX_LRvoE+VJsShC(9B93P%U)wR7%cJ)=OPM2B-3#v(4ou=t1+
z!GPoR3xT9*E6pWv-{=x#w>_o8Zqwqv5y?F<N@z!W>No2mRYVj42Y@r@q?sz^$xA+?
z01a3Z5S68kL-B_AHXqC35RLj@GV1>97jYzq94vp)-u^y8c~D{Oo^ynC5aXAW?Czso
zZ}52@F`$OWIU9)fQDWT>3O~-v$4)F<qZHQx*%QH{7Zl${Cf5=F6&+4q4n@J-_Y`Ew
zd>{wf<?R9U68fM8p>1m{`#f`UJejwhJg^@?FvkLMM$e?mb!$XKLOe%ztZeONic~>1
zawP=nGdZ%&?N<N)WoME~fagr`fs=Dm5Awy)@8@!d8)fXT&!cHVxn0Ir`u?>}ttWAn
z%?_nyW!K2C6owNyo|t^n?aG=y0v7wq0>njIp!c>N@VB3W98bP5mJ4w|{_OE6T#b&(
z)7!fY5+4eFFU7+b9<8opKKVjH1w;?ti&D9i=8p!_Wcaku*jo?i4v^(e@;)v;(%^;c
z$_PZ11*S5Vw}EgBP&Dl3B5oydbOO)MWu=f~<fllU7<WJQx|wO-ty>y;dX^Vh`r%jo
zr|e^b${4!{fR^69d$SShqVA&c<FBne7jWuYMg2!Y{t)<n!oSFl5*hh?_RRLcrYkfL
zvPEI{?k2FsB?x;&i_hoe#NOuJI_C%1qb#BsnQ<{aXzT{Ze3AocPP!vXZHJq|tZIz@
ze!PoMP&RX(D<HD@e<&iyIt?qjLhPyrGF+5(*k-fjh=-3K`}+8(POcxLDhC$|m9dej
zFIVO2c|iXif(W8_uzNqk)#TPGk|p<Wrqi%Pc=yZr04<WslGI!4A~?syC_w3d(wW|o
zJ1wjr%1k2WLYgy!Jj(4DM{IA%XJv3utf>??HR==2IC9VE>xYjU#_j`wK-eXQj(kJV
zrh7yP=UJr`K>m;Qi}(-x_`H?Avj7v3vr2Qb?Bf&JvP6lgF>F|8Fo(djgeuwQF0((B
zfSD~-7;JorCr=sAjs~$A*E-d$ZZx#rLPEq~EYTqN<rt$f>zkaci$cMNqA?LJaSKN6
znPUbeBx1_I0#JPm3%{GA$ALXBB#&}NCcf6N0q~&V(4}GVoz>(Wdt`8JX-XS@$Y_(E
zCkP`&>uw^H)MZi$BGM+43KT%k)Z+qd?G;prfk-s*)@hT_-SC+)BnGepAFL_swf>EC
zM)<Yj=a+f>Q8lw}N7%_qv7;AT*9)SA3>>3ch|>lq8=vTi@?hv4*o~s|tFrU(p=PEs
z>!5}S;@$<!B(h8-yx4fVRWHsu&v5`#pL>zno!L<7nAy0}_|9`)Qi|r?rLwq^H3nU~
z_D%My3SE7m%AuVTvpQT~ex&rX4BA_3Dp@dDOH>SrXnq?N79J<vXiTXhcaYjdGM?P`
z#q-Ze2qS>0^+Nj?+VrBNguNz%+(wYX=AB*~0iMqw23e@e)cSR?GdI6NnwLpkOjbq#
zYAGA8lHH8guX72Glan93T?I075*nTzB>F+&)rs}KanH@woi=W~@J)|$tc<GsHUB%o
z%*-1Bxpb5^4EMJSwB7Rt5A?%_d-t1l+|SRDvYVh=VE#IyhS@7}@xk=7-+rBB!jo>F
z0O%VzhqN3T9-ajyvlsYb?u6`u#E;6IM?6nXEA;!N%S6IBKHG*3)w+3k*KY@O<n&Rb
zy>sn7%`B2~8?-eMS5T<nS%_nyvrn!~x<&mVf`g6&Y+sSq0HecTzL*CUMJ+6gfRra^
zpWBDZF=^TJ(Ny1YmSI!*smsZ^x)bs_wZ11#OabPjYS*UkLG2wE=4COAR!t1T$Xf&P
z1`a8+=mO?K*jbLDyF6Q(>RWELmED<fW-8NNn(F<GFK>q|pmXTsI+?zjrU!@_kUL&a
zv4t`U$Q`Mv!)SngHk4m|r#WWK3G{Q!<X$0U@ARKuhRLKL5;AZI1_r61NG0-`|MGiD
zrKXyixeisml*q74E0A;G%px$CQ-}D893upmvMd{k2^vV_g)NbC4Pq?QS?wrWv51S>
z=aO%7VP~D5s~@<p%u6P&d4jG{Z>$;-du7)s*%yn>exz-}1COpTjOYT2)$J}y2bnv>
zKlCy<=LT%^!RqG13elT3jg32h{;-^RU_8LI+v3#~ecTHbus*CN8@l!aHs*!jA_k*S
z!GG%oF;dq#$qytwlw8hx0Z}??T09aNrr5Y^YsXDi2{M-DbHJs*FsPDD@Vo)1didy(
z4kd$2>VW=QS~3ZQip8IK&SqP>D#wg+WsnsWjXP%D>xS4I^7E5rr_umXsh5KRKpEoz
zKJI{#Cao)rTv^2J&E6)uR;CQaCEI!UTaw~iQ2UfczKtGXMfg1Z7+Bi9vrA^<(VoeI
zCd*z;F4M{f;*Zmyaf=sFuiJa};1Yz!#qFV%6anOqKW<IM+l`<mR)hv7S^>loAYISB
zdwc%Z2-EbT#Es;^i3F3WL@C_w-bI(vgd6~JYgqbF8^LNKHg>cc#v*HBc!QXbFs*!&
zAPc#<v9=BSH`Ryh1(x-jyp^Sj_ZPhx3BStE%DdE`I6#(M0ZSuKfKfO14Gn&e@LWtv
zr%x?lfG~44n+Oh4#l*ZEM24-YjC+sxjixLjVG#~52s*}ES{@?a1w-fjNnITu8EF;s
zKApDNId`GC`N6_3ox67*@Mn~kmM2@NxXp;v`d8NQjXXfaOxlexF*&^MZT>c@l2RxS
z*fZImjyn#LFBh%UUoJs!F7~HQ_Zwt7g->NSXhZrXzuGCb&mx0^r$+r6{!Rs{lu!#;
zQek?Ng$vHCw2f<08a1F6K-_-~(5m9ww^tOgj3FGQ_R_(S_+)%Mg-C<ic+<h$TIQ~9
zF;RB~+U4DcH7ju8r`%z3T8XBeK8K_d!Con{Fnu~zpZ_U166=L^9n|y!sG#P}pMRB!
z4~d=J&Uh4W_b@`I_?DTa{FU$Y=p5;hy+FvC_Z$DJP8xv~%a_lk6;&P`HD`wteKYi6
zDF<qM>+@FrKpJGky*Mk7jeyYyQ&tF6#iyI#q-A+qHgGVqi2p%HYvZ&CdL;pK(fl;)
zH{Q@Nd{>(;UGn%(;blV8?V+ocOy6aQX<zN>Q<^F&`ULHlwVb}b^N}6FMkFCFCdX#J
z%JH?^bc`yQIpF4ZPK<GTKbk7(IskSflYfS9`q7usBqrwVzUYTi441Iu#LzISi*Mn(
z=DaW(Rewqtfk!ysf+n%|DthhJjR+?wJF`&)QZe8EX{1MEewq0I=E!8GDKL2hSb+=*
z1O#+M7UySlB!cU^f<A#jwV>dU3OzoCm1(+7|9_eeG|`uC`r5sGUayV|T>AR;b!Mp<
zgxr3!O4a;dsvd_Y=T~&aV3nX-vZGksIgyONL=)eWHDGXS#8!9i{NAEkH(R}IO5o|l
ztLt3}il<cqTy19IyLCHAZ;=d}5$u=~F>-w4ALI^~3JVPez%sx7H|i=#D!^6ugX*=x
z3LX_s7DZXZB5KXq*PB`gHC16D2B;0VlT4-2FFC73@7vdkcF)<{SoM^rWE!TBi67ex
z)kFeJzY{ef$Q*^g6Aqo=jqR+Bk1??kgcRGj*I0182Cy%(!$bH@+P6(%sTy1|aQ=2(
zyW)k{oah_fzdAwo!vY2aS-lW{7}MPzH!d<U!K%I7F5V|dRwFljb!RSIH-WW>1Ll8o
zeKhyyyR%ghg`KJscNLTsEuk*ov_$P^+=Lr5y!R*6o{EjNj&$pROs4M7XE$lbXko~g
zq`)EA+I-wJrNghOzD(ke#I7pk$1}&TC!IEYALUip&)7Qzt+xikc}N*jh)r2lXLvVC
z(n-B^rRb$0C-`GeeHkER)v8L}2dl_AzuDyOKooa!aaoD)&+wuXKY-n&sj5<>Ri>Xs
zw<W7m84}g<ZDD;cZi`1@Ysy*HU&&@&TniE=PrhH>FtPpr(E@Dlf(5UvF<`3G)=BGo
z5Oka_x-B-7^-XTC)B_V{`VI2)v-SIJPU$Cyhr0uqB~lpRJ~A`HATEeOF}yu;Aun7^
zosZ<sMfb>2rycHKZG0$+IczZLaV{>ghbQ-HLp6iHv>!kMzl#c9kBNs)`?`-2?>pp(
z2GlZSVJw^S@R2o4avG&dMa>0)sET+kJF28=h1VyQ95|lMy}yGj{~A@!v*J$(hh(Q0
z4NL61b5mc|0s!~<X{d~F4%6N|E-DCsvW1CR&mKLtq5+g`((<nGb>n<S(j{7^e+C-C
zC~Z6~D4!n&@nmk5R&zKA#b(Xam~C-1aw393&Ty{!-h2OpQs^Ff%0RO@eS7x~rsiBz
zGP-IUlX9}vNBAC0IcPZWrF{)2l#R6#t<;R+71~Hjxpo5aB2F7mUF8sN8-A)15d`})
zB_a~94lNyk{Dfs)FJ8SeT(BTK`S)+Kr}m#=Qvhd!=8qgTicbY{BH5;2$1zU%!Pa)y
zUfYl~r38_Ak9qSl1qF!MHAi(lH3(L8Vh7G=5~1Tq6`2nsorB_l*(VlP)s05rwujMU
zAADQ;{nGAN{nN$yXF<5=K7^-<QA}RVZV?;xmfm`S=Hsq1kOKcP7jcEWQ!aYbe(`ez
zp1pUkl!l@OzEV!ZQufio0!i&8N|1P8Q4i7M=A(p>41!Mup%*qSElE+E*;5c|h-~+Z
z7dIU;wc0p?{$wC7WBNN9b2AE~U(NQZ8Hct0;897*t~Ej?(GrgyZEHQ`5A`<=Cw?22
zkdLPR*Bo2-PopJESb}5X#)YF$Fc%o!0egAiUyyA(xrS)c_ud4GSoXx}(^gyn{4$w7
zhO-`Vfnzb|{NA<XJ4#xab_bf&L2$vm4i^cm{d1bxaSC^b+<O6ELo}x-D<9hET&xsx
z7)>kW*i8m#1c;&Nbij7Pa&7;<@l9Wsmunrnc^I37v}Gx$PtQfTp?v%*@|bEEJb7p2
zKunE-?@taDKU2;LT{I7@r;d)&&vkt-6*jcqn9(Chf4qyD7{zrN(t>uJ9@KnMhVP*W
zUYZOKwiw#(0R5hypWjf%l|*Zmr&LcGFt7(BW8+XxsPgE9IXik^X88UJ-DBVww=IV}
zPxhC!ZS3q6krG6eGs?NkP(1qB(g=%1VRnzXQ!IcM-P*dzMhIIe^eHFE;*w`8T@s!C
zAG}Bu4$Qwb>o+Z2g#$8n)~wEO9yIE3e}?+{+o(T;ctQ0mdh*`A-^MQqL|=e4x1hT%
zbMv5;wo!t^rc!=}6<66&+bUAcivK&oAaiwLV@XAz83No>b_&P@RFh$qJJkvlTSkAd
zOps@QE23rMiP#=mT8dZ}F;DMc<uaOKKdMHS1l*xmSy14pMM4&iWX^@vMw%a)kQ4KK
zp^9?D(~6DBRRo$hR8!|KUWAU=LBQkD?nO)lm72b;IG4XJA{<Hn!&dF0^s?~T=yPEL
zO*C4K2vBKa5P4HG=`27s%(??22C!qPDFx4?+yKwn5;X*b_xzSW7X~{ERLUWu+TTX|
zgC0%b32V(>g$ua#(#ZjUVY}c>3!7f~{QQsuhYnq1<A%@@yqowRt6%;6xgG@?J-t_t
z2ic#mGJ|-FFM#{T0q2X#o%O>)Lt&YfRrFEMWwqbZ`9*no4p)|Qc=AWv=<d1vS&-Nc
z6rM^=em*zg5pYEye%c_;fq+_FKPxZN6WG4{%2PkSe3^?sJVU^;05kK>5s{72t`cSy
zNbdS69);b2h7e5jq+7Pu{o~NUDJE4H<eHO85s-T+9oU$~_QBxLthJIdn%8Y<S@hs+
z+7kOM^wg`}lsk{Ids_Q0bvBuWJV+nc%f@!dMmF#iq;KBjcj!<=MqbHLM0gcJ+e9)9
z&9odYlMKUrqhRQQe&LrvBWz@5*6-Y$O&c0dZq#V!xupp)?RprxNZ*V-sBF-HL)(kq
zjK2R+s?K1DXE;e`V<d(HV5cc^bmm@GAa*>9NgQurP@g|m26gi7^K)EUfBVud=2<MV
zM29a#p{+^dTX}h5NI)P~<M(zhgbe+%sI8LEx=hq$95`NMCRNJ&_+jmXIVzO3yCh(f
zhW(|Y5Q2l!z3QKFZDLdiKH`TuJNuyaU=M`0^GH&@uNsHw3>pM=c7V~2=KUfHAmWeH
zAo?CY>;bNyzcRKfG#pZ^+tPSTi%fp$42a2xO`-ueG;~p-MHc!VnGIa!BwqFZ`bPNY
zzl4sVPaid$Drom;4!lur(RgtapuaOYf4%$m4JWLKdly<Ie!BKzlUcL=#)gCTX`pfV
z4csDBH`M!=3Ud&9Iw)7f;lp&|5;Zt_T7dwgy|ZDEDXMk5v~Sh2r32b3fek)A876Tl
zFnRVde7=H6m|fAqQ5<Od4w(^eeT_%OoP1%ELlJQv{03dIgM4~nJVl!J(`U)f_eAz`
z@80yr@7}da_$Pr4ZaQeH{?jIqd!GI5c40+nV~jF}q0r<P)TEia7#c#pU6Y!E=NVVH
zyt|T8CT|kaJ06$AB(R|+C9h7?eENozQ?Pm}+!mdxu)wG@xDi}dhQDS6-Y+(GzVL!l
zn7C^X7Kjbr%*aSPRjvO09a;S&*p~p&JUYv`^2MNlH;)c$2baxA^YkUZHroM`WP)P=
zGSvhdrc;;53U7270_z3oGoar$eq%&Tj3>|%>=6YaMoBx6SRGcF*@#yC3~(V_LwESz
zhqzOKCAG7@KU<82Xw#%g66->zVS4)j70|>;Z-+Ugs4_rf(7(wlLmf!VtSon)j74$N
zzCM%i!S6=Z>VU>o=GeB+I0^;N*&6*DO`PtD7n<f(lg!LE$A@nkuTjV(Qf{aAV`|=p
z>F&Dv@1ZH5aa-B>AYeei=m80SzvA{ETKL0tdfV4=7Z&(zuMR0I&b!x&!L0^RRYD|j
z85qq8i;VnnzvmPUjfjm)LY0&xVBjG+WlP<kbr>HU9=&-uc#PjHt!mnEBw|99lN$+B
zQ*p^9!x<nlpnj0<?(>|dD1*0-sr|V_OwEydQLnfob~a76QjX9lu^Y0(-`@l8If%iy
zy`3#MXkQk!QSxam$_qhJU}%9c-v4=X9;jV9lF1Fb-M8w1;2(Aayb9`}>7-t3ZzEli
zOjMDotYU~IkpWsN0O*9aK1Cw<5iU&pnyrl^JTW?f0g;0X_6S-wY<i^WODKpnC2lji
zbcT8%cLDE@`&%fd2!~1VUjbkR^G{6$Ooj>1re0S)Cw-(gZI1?+Bl4^GW(lS+{14N#
zp#X^>4bDbgz<bFjnrUZH8%wbu1IkO5*nIpf&jv)A%wzuXSAWsjkiG`8rEu-1Ct8R1
z6*D`ZnU}Xm>SYLCal4T*ezI0YW?7yB!i$^Kq~)yKf#L9*<+)Z>-U_wzYi<oO-Qq$T
zcnKf%Eq-Zkb$`yaXkY8b<$KE{1qAw`rHcrRf=R(JcJ3W_1pN!N%T9O)=<|_owOuLs
zceU!~MafUf#s8q|m@QptnM6QA^6m4zTe}!H0{1}X7=`i2JUHdUAYej}pCp{h`G9-L
zDJ*mlV?^$S2ozz{?lQvXzxOi>jSu(u_77E|EJ*u1_>kgq4a2j*(VI6O)A<Y*u?M6M
z2(1(9H@hVcx$LVwot!KNzW6e#9PuiD`EnZ{j^Lmiw1fW=m9L~qI<b|w$dun<XT;?U
zhf<t$!;OL?cIATx7Y5!jH)Hph7dYHXQYJ#IN7zPyP#ffJT!`bsHCixH3m?;oacc@r
zF00c>LNTgLjvh!(9xN3yQp3*UXq)$$X4p}%AY*Jq0N=vBJlD#~vIz_p(C8k{_;O19
ziuLBLH$3`MJ>=ehy=eH&_hn^ed54E<>$>`n{#>@@4tN`#V{TtqbrQ}c|F_jEzrKl6
z3Ho<gt##;|JgpNv3E#*~{<Y62`m1V2I4oR<J*F`PbKsf{k8N!hIyj`=w?&^xI~|48
zz93^t`JDj?Wv^ZV+iCK#p_XK4IHWYp0Xn?UsHiI2&*KckFTn3-<G5KoMi<VWR&jdy
zyJivXI@_IEJk8u3mBfYBYGHwak2cMi&cab%^_LTMzjsqa=|GpTzP<KY_TJc@qedM&
zeR?3h2RBhB4N0_6+|Gs3vbA=con3c00j6e100)fhqC6&<y+D40wZ<{Qp8>3;9|_S=
z+y{h<_X2_;19ET&NOxIs0+8?SuU21zBdxho*RH?spAKo(GL&GV&R_>Wsfndp;_yfK
z9C4b}b#$gVY3U;LItB`pgi=?unluvBvOBoMD}tvfFyG9UpjYtKD2rgF8i16oLi|me
zE2BQd-f=JotcT)~3a*iL<cRe?S~bpy4D>!}m|0Mni^u}ICI85xMkF2vXhep>Q6y@(
z{&=(y%o2!ocKqj;6d1(PQdoLOuedeO2P82#NPT`CmDaUZ@x};Gu2Ae}@-+ksLuEuC
z@*?ftUNrF4$Wc*p2uqbxyZ%sMpeJvTd_%gl)^z-1KJEsfn20G`Sk(S)v6GS*g%2;t
zcBcxwhu%ySNp$23!cQ-4_s>83xY&&CfJ8Ll#yD?h)yQy8#sU<}GSu1qXn%F{F=*ym
z0r$z{0z`=~{?P^9e>V$lJ^cX9wtzG*S+_u5&Fd60e)L|#o7@=MC9d>Bv|MW(6Dy(4
zMEJ?+qz8{JKIq$h)JAu@WQfOwG-O4IcdE*O7^Oii4yYpGIyZAdgH0pM6!WB8>XfTI
zu?#B}Taf0F2~B0s$^Qqpbh1i~NJF3#(H|wLK%SS5hAX#ea~T!_SI|gIUBI|(f<hfo
zQip`hI}|jAs!Ws!>gwZM2A@*w%X&Qu#kS1pfvWHHS2s6$=6|yK-P!+u<-FvI#Fv#z
zBJUI!-uk-t_<$p$OdcdGbxR2!DK=PBr%sK|e>>~A;x`-b&)tJcnDaE)vZZ#>M?EIr
zsAJM}ypu!6&zhAwXWUwZHq5=vxwPJggtHPVL;+A_58Nln9a^EXW6u&iJf=d5Fk-qD
z<daE8#AiE(t$K~KLU?PH$G3BH)c{TqxrkE@I}mVihypN|HD5t(icwS;TV|kW8VPYC
zZU_Wv>@2mN>}D~aMMQ)hW4Rh<Q9*pLn30H4EX0|Xf4DoQhxx)si4M(iT$;~G!1BR!
z-iW&0P+))`3&8WxWd(qF7QiYHhVRhnxcjSL$#`~~w#KG7`;TUy!5*Y7KQJC9)u+Fo
z?}Zh1r;+Oi4zRrx-LAn0t~5mMDrhLVirlU+T61vP4z$n^#Us+|YBzzgO7HczCVtn0
zqaZQ}6rL1Dw34_tbRvg>1YOgwww~my^_Ho=mA=aC9(7_1q}!kGGXg(SFBODeaI3A}
z4GsVm#VfkPrnJqQ|F~SNwqa~l<b{+=$~P5$;>XKyvWyI6tz4%|XS5B{Cy6A)ZN%(i
z9$fzC!BbPQ;UJUdF&_5bV&PuKx&#<@4!R>la_}s~&VX6PwzNwWpVWX>!yo;NTNCg+
zu+lXsy#=8OqkV7#Ak~O6kCZEz{3)9eVjWDd;Fl(R|I<XRNcL!p-yQ8a9F|4-8_nUv
zt*!glk_&Nx@&g&3i}#k9wWNB8L%&Ebpu7@pBJ7oSP>}T@=ePj?u}PQ^L33TDC6Wyl
z-a5@Jcd?TLjzJ^?<aGIvd0X7z>u~Qd7(4dzh=9E(U06dM@%j$M+;T`}(HPJbP$>Vs
zKUAB0l`N3WVk2W5rR8~J7eN#sj~lT4vWNykHX$V^gTA*6SLHHJ*rERWZKtys(6!(A
zxWe^M3GJ)btkJ;{j8O~}6ui0Eejhv4nhmdE12iPYYf2bBN7L)s*}LnpagwqDgi|xQ
ztIrGw8cl#?>Q302aK)gAF}-^B^fS7TzK_}}+O$hQ>*NC}ee8x<`k%sdCgL&IQ`0Lw
z@2iW}hV`oytGsek&n<fJ$=mZqL}PO7rK%yD{1@)p-2GTWe-4%Ih<$#xCpMuiN32Id
zJJr(i8fdRbr(6HCmjh|~LqpB{5VRI0-Ay9)dQ?%6>(r6E`I;G(dKTO*<UJtutLS#6
z`JpKUhTyZwjF0nhCl0&A%FpDRTf9lu#WkZp5rd}&4R#ox`!$*pYmRk?+OoD4oSA}6
zy9?S@MEKqSIk={{K<zspp}yP=)b_V{+SLr<y8By%Ni9c36>~r5wOZW?^UudRU7ofI
zg`+-`5ESld-=+3#P{00Lazm<y!J;lOlR}--E7S0*CLc9UVuvzE$`Hj`{D<&OcC?Kg
ztbm!emI{<G6J>0H<h0YD{@py=bKgGyNFxEoA;wTi?GyR)b?>;O9mCgnqwmtCIzwiL
zn7v}r{?_>KnVH@C*S{M}<n6gd3~_o;2DRxfYKLZGX2ayY>bPAfRA)MT)+fdRT#MUq
zpU2scC2KIq#6f=WuplHQknaz9C6ni=jB}s>kg-v8rY}?OETK^rXD6<EF9dNhzQ=Sj
zYHPHKuCM7BbdA<f3>u(Lpy`!~i3U6CN?4u=umGQSXvkFn0dIJ=L|cmm(aq52i(C@n
z2J#4ZDm<=`ctkBJPM*h}RkW7d0Si3eEc00j1~HG!NCriZxpn3A>@j}u#3U80#4{ON
z03IU*I{!DNU_S0G?Ho!&$=@HIXPltQMqucUY?rW~GJ2G?6S^sOVFs@5@s-(!Ov)yw
zS%=g>r#WBkSa142?&RxcX3ud*oWkp)!zwENcjoW|vt1hZ>vm&vMM)!t?wh|Uf!knc
zxeHlTV?eU<txGreue9+6ae}C5AZtmPq9JXgr<<G-r05{SA0%jje($}QWQN454ZIMT
zAefVniazcjU@akVv<#{VR}62%^XES_8!}I1CzRzC#GVS2$g-zbWz{E$n=Hy?YkmFj
zcUpJW&$7*3SYFAsvRzbKwEB*h`Dkihwsr1I?z_=UcjFc(uZ1x>$s<P>zKRJCw^-_C
zW4Y?{vr%A*nl@6jP|0=1_M8Lb@ZS_ueDNAj4_B$jap5>5U=NKTKzno0@hq<7bLT4$
z^CC((_e~iTf)j!=48;aZ^W(40dDk+$>ATOsmGZzljdmScSAEAV*0scz0*D!)-t!yE
z$O0gx0xQMK|6Iv)oLccrKRmr{$Bw<?!^=K=;D&hTA9U#|NF_Nqbls#L!q#DFhN&k-
zWIbkz#v%Y3Mh50HZ+>41O60g;K|WGwPSf;$$BtNf(+LS)CEOPcsMJ|#1tE7Wf9?H8
z^(QU;qx8)qh!}AlcRdWs;!)twI4$+qAg-aB<#;+-YBxH^6{rNba5}jBg496u+0UIj
zbz#A;cQVBw({kLImEAu-z4$LQjckftws;{3$efF7#dy-$c|I%|KYRi;2{fX}^*L7e
zl81wSFzePR?fO?%$GO$j{@0|UuBegxg<TRF-W?=19q1`whskgx$UPS_|G=MoNr)6b
zI{(=kz~2M6{9Z5c2gZ6LHPe3jnr`th8U$3I5q23{bf;D)Or~QdF;ugLTD!>q*s*Q^
zi`0w8n#J$hQ8<7UdC|GAVlSagYi#bz;pXXKC7;8SBf1y>C~v&<4@2TN%^k+O{ENnG
z9>vO>bl22^Y!7ZF@~{YvQpQGr93udF0O6a+Jm1ZmEF8GAsfz_U;QaEJ^=0-03|O#5
zw55o-rp=g<;P<I!AM?LRvq8u`5RRXQueV;(Om>N&{1OArUcI7R0;jfRmW|6ny&bTj
z#1#UK`|ftDsR~=q@pb!>Fz-!S&-{SAE4$fsfcFAP-sO8;$|-f9Nn(CWywb$!ok*QT
z8EEZxs(-v!2MTpwO#aGed&rf#n)%G{%j^Pck9cjI>HT;p(U`quGaIG0%DpjdJ9o}O
zq=Mklf#V}~d`?CVhX*^i<pK6$t<&|MLH9c#lrWk+c}u^v$}+<{1s~y0m^U~W7&t4^
z8*IYg=&J>O2Am1to(E@Hoiq*47DkJ_bvAB^&KabmQ<36#uj;PVg-dhp+gMtrTzCDP
zH;$;mOa_<nD%DUb;$7qs1r6&&+5m*l{8&SsI4=*^-u!Dx1ax}KY0LTdKVe-^(ahQD
zcpZ@e#{{_Bf3WJ{QKP!inLxd=MmS(~xl|M3^E>?YF_<PQBT}L$;Klg>Bu@9~6hMAD
zI2`Ek;^;=c5j_GmUZdJHH^vmkBT(T0U;zaq8}t3aaW%EXp7=;YasoPtWrBB1C-ZyJ
z(dHqOzB8UAD+eUqkoxMMv`q`5H~7l2S$E;=sr(+z>Vo>nSihJ?PWLg8brsAXK1$nk
zjxh#rLp6OPBTqOP8E+6ciI2s0A89MORrDqavP@$)B|k)S%8+4WA#T?CLL7i&f-1cs
zHWv&wq9PV-1yv87d`IiZ8+Ejqt*lPXF=As`>i$K}&N@q<427}&bA2txa2$zvm<%d?
zgoTl|j;oDtshQA~J05|xGVOzc<9B8a$#D?`l4A4bzg`UKGmes#X4Vzg6Kt~-LqpQP
zqVJX=0o0x_6GG^ajKDNktXkz8m~$rbAXZOgF*=Tx;?8Ai`hey@q%6cQS=ih;x*-GL
zBK-sfprFfcaxMwe3MpOCyDbQfOUHusIvp@Qu4rpr*_Ek08ZLB(%l*o4-*_npV18MR
zF+gu`E37-O_cZpj=uR7C|MSaB0Zd73uhZ=8IHQv$c_c6R&4FX@@I-1G>y3B*PAiNH
zY;}qkZZds*X=&*hI6fj1P)F{EPBWf!xe;gW;PqhGcTJQzjFp*c_G!vXQxusAZBuDn
zLV5`=H(}+ytF)5>3Q;U98>u-XE6?F22qltVRi8<H`ZiBsMgvoyogXJmm=MYi9gay>
zy?7Nb0tP*9FPs=qy(AL0hWplFaBm8=j@2uu<4#D@zcN0pOB{~^i~J!)M-x*1j}~A_
zu}sKmn&tg(9-?2G!BH>(s$@=YCOSFLtET;8TF~xvB>5@#vae6s2w-I4<kWY-%cM)@
zWdpi&%`>TFz#@v&jfwJDmnS!G+-P(2ZMACSI|YfKBD5YQd=1e$4!oW)y-J_E#%MYU
znrt3t#g8AFa5q$IlYD=%h;1UV<bC0<4l&(nS_HokT%OY^)s3uzVG@}TUS0`HESu{C
z50>*i)!6bZ(lnxMcup`E{^VDk2W$=&;Fv;eGJdYY%OXXEv6>P4G@zGnnrpvRL<Qm#
zt*#<~(WZXN$(m*^05hJ<UId^y7boOOUX2LbLNtnIBJqcBuZMaKElL{Ils_=QgTUOU
zYwF>V1L*$j(dl0kb~u$^%cXF3(45*EWNQbG1&qPBL8MN(*NeqYyevo?>-@sP1!U6D
zc4<Ks-@jkGd2_D_pJbRuMg)Cyoey&4*`(NzX&|U4IOx!2&(ke+?^(TiDht3fsL^*u
z#_<sbF?Iou`{nvthAMN=P{`=Pv!9nxA;(m|<%$bQZWNc4oGhfx=kQUe-r$E%!~dUq
z7uQGZ<Iyz31RVNwvR(B+Ff=I%$ZV=(#&qYmiwug(_1^X1X5t(~k?Z%O88qyc7od8M
zhj1*ZaQQeF!Ffkan+)*AU!t7<nfZ}^+n-YV;L)RhTbtyfHNe@ON387&oJ9V{Jp89^
z!W2`}SCqjrZ_9QUY(ye7GEDYADp`^6sgiv?d@0X}2n_}`Hby-F5opWow_ev@KYwE0
zh;d3Y(yy=o-hXv<WBoHDp=pt=JY<dr$xs-9L*~nY<nCb#T`~MygWhI3a~LorSc5BT
zp?Lk|-8d`gCJ1~Wnd^UIMZk&+xj!&q>Ur$N%d#@dm+OL)`~J?GkPqAlXuj1g?+R{%
zmcu=Mt?cu5x8GXvmVhGxE1W&@?1O<)Uh_NT^+9i;Zcm*YaS6{iS)l>4!1XoAQw6+4
z2twG(J$Yi}hWcZf{^vyaZK*Q$O=j?@=jpHO<gmywB<9Id8R4ey4{h*}YEb6yIa|x(
z9nEF4yI<s5e@$2abAFMV*avIk8*C@amSuCGpLZFm`PjZ`-?3vx(Fd(XVPe6IT?Enw
zpP-<c``_ap_iUT9=<`L$QV1*#`r|6w2MeyQ{aY5ZW-W*5oQldyupM`vEV)|RK=1<*
za8Q=tuinz$=RzL$T3pPA;`z<ED777?#qD7upb3$ExF0yshN?)^H0U}3ok@ZcS_t*U
zZVq$je!2bUUZUWs5^$+h3ZQHwO#?-q{`^;s8teo!jpdtB!}J89f$5(*XU<;6v$(Uq
z&&K%K=FwJ}nKtR5w4pUjuP7@>PQ9txWSYeOdBN<%IG7W2?AHveM_D+A`c?_ZyDak4
z9*Y6sV+>)X&**-mOUqEgTNy<WfY~%hwVn1<);CX#IYBuzTxXmEdL8i~#Zv6So@BJ*
zR$rtO;e1v^CaTC(5`8TbWa3u-zZ<*&{X7HYoJSEQpl3#M;zO#lpEnQsV9hZj{g{4|
z?-2;jID9!KI{F64(6gXU_hGjs+1i#3<9vUqtn^j!;6~vGp#>0NUU~P(O?5yWCMeo<
z>7qSpr6n(wu1e@=I&sTiwc~3w`u5!mBP@|iZZH1`sMkVV4ye>&GYg%^g~(i?rs-Vn
z335}b3u)3-<H!db-5HZT?((AW<Aa^eBXW18udmonzz{VlZJk4CT>n*Q^{824kux7X
znx(1LaX^>f;%bR>6o{zc+r)~lwpEP#Tw|1+q8Oe|`$M(>E9`u9Y5JX*kHzH8H&?N1
zShD1!%a$eyvUm$U7?3%tAMpeoxT3^Rd<l39JN;+8ha3LeQ(C8Zp{<3Fx@bN7Qw_o*
z8C2qd@v*fJEw39wt@f5C1eIVU;nHyYc=Ufc;0mZ5UZFEaXQ&`QJ)fBl_!+8PK|H|`
zZ~QK<!fI27m1#-9Nwx2t1#0H#Q3vG^AEfi4@L7{+?29}DwD>%ZukW|`9y|!?c5q8w
zAKmT#D!q-(+H($4HXfC>g$FGY{`^{)y#x6NZPf{=@C(A_AgD0yqhX;upw}G#fRbvL
z+&2i)sPo<8kMXUo4!@l>+~YA0VnOU1qHCs2SvGi6Zoyl&@s94DnWWb3b68nXM5y^!
zH3#aqtIwZzM{g3Nm0Z|nu9K4o6QF=K4D2NvC#*9xjNKuA!YJrDeSBKJasz5K$rk)l
zOk-q#KIp7n&`+D71MIr6?3WX)jP6_TpJ5xm_N3ByO~dp?N|m}Z>z>V<Hm9y?jD=Eo
zAFqP;<vp7A?xwXpczd_`AFg|7p6#@$kzV&O&AU#6gA6sS279!$C~VYFzoEXxMxQ=r
z<(p@%t*Y9caqP3&_}nXf2PV8pZQcCplMStD<em(x>Z+*dx%R<(5B2E8#Fc|od%xMZ
z%lLSB@Y{dDlI7aQ#>I&oov`j>V}4>Tl={z~73yMwu~w_WKFS}Q3HG*q^Hq^Xe%z!<
zO_AY^xHS1<{kxoP*-%G8R(@}X^5v*UqmfJ-QWj98-{>Fp81dIUMp{K33!})t$)?QP
z?eBko>m$1@_%<jKbgxs#otc|iKQRwdIoK%x&KwL*9mNX(7ZB%ml)tL2#7opM;m1Jw
z_3>m&KpJbC{&bN*MosAJoRjv~)NDi`wR%KNJfdp;D)T7WgjCc(EN5y&Ud_C9t0g2K
z`W}rf&-rKg2tdGj0p}idllde5th%1wp_LysJ@N1ZglGarBAytklNjp1OrI)|352j7
zojY2o*%{uZ-&ws<S6ej(bA1IAR!=`MIyyf1t`l~b{qQ%q`?2=0sU}?6JQo))y2G`p
z-T5fQ<Cf4}^Up1MmvH*gVz8v{h{Cez+hix|KY^LI7wBRlyU1W*aq+Mx#l=AzzvO4X
z%({TF>R6bppBv1~S~6m}4J;VVNe`5M;2A9D0)jru_UZnyKUM)-3A12tAIFK6eG>5M
z2DY}xKYXoek2j_aWKo{9pdw!U^nx<1(T7zh>cMj^U$tr+T_demgXz=nEv?F#JCN38
zH}#+6-7f>|(hVIPG!)vjUY<JtC1v5fxpVWwmPS5t{ryu3kU2`z{)_w&S?eLb$_SRI
zJy<4q>_g&4cX({<>C>~_b9nA_{A%vO@K0IqSr4tS_5AtuM-1|7U)8s;v%~yh?Th_m
zYA>TFlZo&2V}|E2C&tl-((vqzUdt$m-KM?BN&8KJ=X|)_pE&zUHYlX{3xN1%4H}{8
ztJru)y~aDX0n*@-#<2a#S&MEBv*2JNk}@nEx@%?K-ixf#Zc13g1V;7A$W)u*k86(K
zvmS?Po>{kBD%lZ9@h4W;R^8vQBp5JxC!|bUwV_K@pV0QOu2GO>ymNf|Y!3^5p#k}w
z4NbM2v~+399~Hr$XUy1*92YKa;?Pg4_SO6Ja5WG|K?)s<vJA%JH8OzB(j5@dvuB_?
zYbEcO6z`ZEB~ytz+xV?IdQPJuCJ0dtzqfBca#zlR63(75bMuxh+s{ct+`H{VVoeKZ
z5d#ih#=v18On_?Ua@j<<7SW}o0SQA?U{vj^`zR;bZ0p_2wuXRxtMQj#YAqT!;7dx@
z{=y#J12(OuhzB^}n>#o9pp9_?L>2x#y<bp%s$cZ0*C<<O5eaQU0KZrN?mUd53IB=!
zP&9u{Xn|#v6HS%J&>DDF9~;LE@kkm+*5dhE_nogBNWZuX(JIB&J;&};N|GSJz)&FH
z@x8zup*dwL!h=OXs>q{IHKAtR&9)Nw{FgwzeB%--q1QP>Mo70yr+$Xv6mCw&gL6|V
zv|6oYEs=;NuwgHFw__hBab&v}^cWMdE8^`7s=1}(m^+S1XBI!w#n7oEC65Rk&eg<4
zM{k84gToPJ;qk)tyu-eB>0RkXZMNjUXJsK-UWO<}#>8aYefZD=_^bqrXL)$1AqH(9
zujNu8$ZWdqE@(3<+N<zX#2MO>Y;c@kMJpaWmuN2<874a!jZjCgu)K-)zI}~%WNr-#
zQhC{m2l{wnH;<WpJD|nf2Mbe5&pLNtC&B6X)fiKmrmyW^`fqM-E+&xEj*i?Q6OwWs
zDtLe2VifIArpd~N<E$Q_5t{$<%1*mEyRX@+vipVFQ5F+WKyfZbIDn>QV4$hOR!UFU
z2_o7yAThaeTM<C<6AWse%U~scT1XPToFhGR^YT_8@s{69hJJ`~I@$YC!kuFnXtrtJ
ze(`tP<UtlzR*1L40-KH)G^ia<50zgN1ulBqP{pM>Yu(yyKRbcIE!!#ilO@DgSz_`?
zBPEA4IB?<Zt{}lFCRNp4&uFY$WVU`5mfDMnbY^?fX|tFuo#HV7{R$DQ9@L;DTYebl
zWbT=nJg4A$<$PiT#IdSsWtU!`H&}HqDBt&&_PTZ*JMLzvQe;d}Ui1FF!<Vu;*K+mK
zYpWPzElg1|BAS%q?RG0G7(}Fj0<yGbv|@(%C#y}-++;rWO9LXE7{$qmBlI@ybGs86
zmwVkEKCwNEhWB%_<`K4UnKr($>z1QB;vsOl-JErP=Rj8U$;KxVN$);=T!sY7Oe?Gd
z<7xH2ln<H>pvAUkB;Gri*&t1XL`L3ENKn@5{c|T>Hj=isU~STMo(AkLxb}Lph*a4J
zs>owl5TF}8l;V>y((N+c)>+s6!^*}Z>7sW4HZl3Gs;++T<@aJ`4|aFRRYWQ!J4-g0
z_YMR|F_=ERope%<BEB?)=aA(Xzz+>dvZN3|)%AjO=+|K40BA|sh<B8R^Mg4Nq4xz-
zMlitm<hqi9I6(LybwX~njb;~3u!y@7^FCC<zBGi!L%VIe$ANzkcQl+zz(5{<Q19Kl
zDK|uL9F%OE!f%rVAh~x;2z$w8%S!PBK;{o-beec)5z6BIEZ%F)DfVm7SW$NGh*pFW
z>VfKR!w!3PlC1fcq0g`1`FF^WE7z_y0$yDYJ$<fw<3>%I$dWdpl_>n5eyovf{O#LZ
zXJ=3N(bX~gIeI0Ok>XB$?tQsrmiYkulzEvVI@tejZcdJBRwxEXQV-GHAt7lA35E5V
zBJVW3d1!BI*|5#zqu6{Xb-!bOCP>ksTi33^SU;?d85xzHE_MwPl5x;z%B!ckolmg(
zqg$LB1sK)<dD1SZuWsOK*8zl2^T|i6U$NH>luIUNKeQggMRC-74;ZlQWkb}eo+ucv
zl$l|hN%k`=^~mQXsA_3FT0DZgOxW3tx+T5lown}ULt7_D$z~RKAaOb{igyT>5QccH
zBhyOt_FQ|H)auePEH%2qVaXxKVlDmWFJKoY|9iMU<e~EqW66mx+q1>K2kBOp&C(U&
zjkk+YVAN>VUELaNBjO^jYaqjcK&;|UIUhIN1p!5x{0M0jF(VLz%*s7#Q*PfmpJ6p)
z#<{mM=FGVi_{E&FIc`@ARkg>%45kb@(o)mc^ZNA(Y!_&ED(K_2vkmHcB`?-iJFebW
zxoumuvsWFHGJ1b|Wth^jLx;09RqtXiPoF&b)N{A=Z%s(;Uw(X?P1(?x#j%;J=#u@-
z!4aJb5nd+jU((ELAO7v`Xz0Mo)mR!NfrM9$YSZJ69q$I9v=spjx4^9kTqt3G{umvG
zl^Ve170N$Oa6Ry6ST-6?C9<A-Z@<!qeKj=3&$+sM#L@ko2kmOR-F)f+g&mof!Ma!A
z7TT#(Cy}lG84_|bs+u(a<!c$bQ^Nx`xm&N?2gL_$qZW7+(PBL(lfFr;R#4?#n*RQ*
zcAG{D2(5;)-5HSRX`h4L#aTf{><%BEv{q{**7E-#R9Ij8dl)d5l-4ov@v>$PWM%w#
z{U2)2T`OBciiktdS}pps_9F=|jmh6oY7M<7h+QR3KX*Z~Ns}f+hYp=vlI7`_AKqLl
zU-0SpXFd2k;)zG91SNAxYK=S>Wam`T&!pqB5DSr;EItHlA-1+8ILi+~@dP!ra{sW~
z$c|)8N~98~ii*@92Rn5ea>N@@qf}}c;H%TXnv<)1$VearN@~|AQteS4$;iu^)U?SY
zdcGMuGNuAc>l+w^&i?c9Sy~q&oNU{h@?;yGvAa;Dpbkv-zWr7Mq1;`VJmwu-wkvc5
zMn61ciAo=BZG12lsH_rATx4eT<>+b&<Yi_2(E4!rhCQn}_r3pBJ4lqiLhA+(vX8I=
z$TAjSi4cti$u5XqN}P?0+cwRhyxt*6n!zNzjdsA``1iN*LKG=T1T}U;V3DD#-?q7Z
zVoYm9IZTS}{~VT>I=^dzUB*7-^kW&VT0Eo+<{k<PlFE#XVgkFUu6zG?XEUh-fyAU^
zGjBO2sRHv*oqzdL7oBn0{*0`#;`xQq;6PDjgHf`)$ZV~1+I9ja=SntHmn@_k5Jn9)
z^yQU2rJcBzY`bPJ+8gx1Jf|K(BpdFnc%m7Ptf-U417In<LvM=stMu2&)~vR8?CnBc
z0Fqba1z%pEOFG%XPPVq6^17aH<Rg^?&N;wK!VO{N)TX4z(usHE;?f*<X<oPC`I7Nj
zz$`=BZO{!gJw3B;e)+c!zivEbAxFNw-SEU)08{6xM{q!0wReTS?MldDszJP4jwl)o
zvp+*cav2jVO8ls-;P!uZQ6?F5%2|<XYGkBO!06PXG4iq=6jHQ(a*3Zj=}O&`O|f)w
z)a{}!RQ)B?u2<<Tm00RSzT`!P#m0IqU$Zptkt?i!gDZ2qwucUoh#`p<ZK>?h1l5V&
z<h_)WX@%%djk(AV=8a|B8Iw(!IFv+tUUn5h+G*S*(302_^p06q?Wunk{d@<;q7V^&
zvhw*Y#|B;RHc-tirDJ1IlY@cCvDdihXDh@e;J{d3kj9g84OCeBK{-|FJ^#zF8yoIB
zux&z^D%6$)nS5AaC9);pWN71?BQ7&d9UL2596KAa%WxupMyGCWz(&Fd6T?Q$>Z4Da
zLza_bg+#xd-T^*<rd0Y;JUQR49{zImb>~Z79l$X=@FL|Ayep3E7;>+CCUf30m>>y)
zEktjv+@R2rat)WULi&p>?Z%u43KAj;z`vC8^J&{BRGyibtD=-)M&RSw%C^2aq7MY8
zWauDua>5DhaP{<326)|X(v}v|ol$I9v3<0><CtyuaBz6Tb8`uO$&WT1RqvDn@&(d<
zqkoE>EN{dXuEgztpI<{>phRa%6l~VyiuP9O*%6pbGAsJIsn*tz=*=a$LXKOwE^LDD
z+ji<8uvSGp4L&?cZHEI%c+u6r4ef*2E>2|6hl_{6HHL(S)<^X#mmR>b4m6mUm~(H^
zyWCu3Oj)inRSZ%1+USIh1ETt&XaX4LG<E6Lpq`5NE^u6RYC3JJlUoA<9&A<mJ(wDV
zwX8&kY!o(`3v?A#otU#xeKwu1gV1=8YBXkLeBWqKgO7Y{FVvz+l3?&j6Ia~hqo$X8
z<R__@+_>+4ocAd;0;Q0ryU1y|TfyKD+!gmyM~dCIt2gecxzOk90^PvqlP5o{HXX5W
z(?`W&k6kFz+bAi$%&FTM`uPA0+R>^Y+G}T!Plv*h(WmvoT4vzj!S1l#5VUjW&K)>c
zv*pxpQ@D^#D|$_A8U$_#rmS#6(+2nP`Fsp&Y%v;wqXlRdQwpB;Rcv6F^*RWr+oq}w
zBs9Uy<#ppeknCt|=E)=zBB1|^tT%z`d2QSNi&Umm5;9dv8Ol6`B!vc*$dD2V8A6dU
zNkmDAjFm!3C3B*PQj)eIqMfl4C1d8<`#J6VUH^Bj|Fiabp8MH1_4|Fl*L4oZah%7g
zr__$-vc(6xVL1hKZWXe37P(G6=uyhfqjn=yw5~(E_D6LA5HR4RUF#m~&{RhRpT{9d
z?zzNV=5`5Qm=eAInCYPvx)1**>{To{4sk6<FkdhoWsfX_70aU~0|!q7+&sJDQx~*A
z%6azj0Gr<4-sQAZzn-tY`j*MGhN$Nbvm)<KJr%z2#?84JdvAI7p#(j6`m`1)Xsu|A
z`cNO}W!Y!v-M*~}K%C}!AA1WacIjVVKUO;Cn%;;EbN!*mifyR0D+o6T|7NC^X3{W7
zTCUqiGbm1Pbh(b9)=Yb5X{BoG=rp2&gs98q*|p3XUaZLARS#4cQnyg2t$|d&`Th6c
zK=iUrY43xP`QEh3zraabz&LO-*lytPC3aVT{{FSHRqNIu&$1%$(b3nGks<tH(z4m>
zlga^_jRp9(HBz7g2!-jpOo)^j$o7Z6Si?nWkmI;scpIvct<>q0z}YIMmfgMSv+?=r
zCp>*wWlZenlo;qg<<p<QWtobBVe!nHp%E+Fn8nJ#i}b=kZ6l{o?<mMMKpxJf;VVM_
zG@u)#76}0&m5!KK37@rUi_exH`%N-haSC^+ck|V+7`n7R#^i=p-V}-p{r#=!ODJ;o
z<9L6^4E+zl$a>_6kzHaK<IV*ymhHv2=hVCff}Vym1x0HJ_%>zqz3v_Qv7fE~pf_ik
zY;y>Iy5+~&JG55o*N=$HKB`xr(vkv($<B6whtfF_po?qYo_W6Ho8gIBlTCNG?O!A)
z5_dz&pN&0;ax7p7;<}dHyLaIH`L={O+D()1^SYjNC&uz)(lSGOwQ7P>PkNiu$2#Ne
z2U$BhjT=X1QX-t_GHps)Are{QrK}*Mn-py8S~0n%&XiQiqP82&8yacvTY1|B?;4CE
z!@itn7KNECyBJxZDL;w(K=H%I1#SMS6f<ab)QEK11KZ1V52X_VPT9P24E#H+un~nc
zRXu8&c5+FPL@)-Y%(Ta<DF=rQ>v`)e$~)#lHxb&9aHwKJ{wV0y`;W>oHkbLNw3ND2
zd+lijj|lG>L^ZJ8{YFqV4;|OGH-6W?wrp@fA~-(E95UQs?>@8q)__kVWiA^o^|Q40
zF@vrOk<3;4Qe!b-C@uy9H=Ganwv9xp1l|m=GZLyU$z&sPHskMR-LxB1zpd+ik5oTq
z(xip}q)-pSM`J)t*44`zmo1e5;ajY=T)Q=H)(qbnDQ)ljpQb;~L7E$S_07I@6gfO+
zLNR2DirHxgfB(L`BGnvkY$p+cHo>CMa+%lMxj(E`nsFF-U@SQnLD1h@$j|G+K%HQj
zh{%Evm~Zh3Z$5N2)TwHtMuI+FA)qfeReI4>4t7=5I&_XX4<2MqUOOpf+y((%@L774
z5?<(K2~~T@BW@e3#B~*HtXLOt2+LB>q|&8}7Omxt;s#cnX7=4o`frhhGV!ei<NJE4
zn$^SLE8G`M*|YMi`x&<KiQcR_A6@j`fyaFwpKmRVEJ)K-+>$*%t=d58L)0P~u$8o#
zeW&J}dhy^v;GFe3^I;s+Odd)t#!MBETMNt#xcA1{<Dq4r`9`<sAvxCdyeF?al$=~v
z@n`Jp*`1L`ha>9BA%UUNf9rg~N8mDy9F#a6jFLT_{iK~WwX49@w0Mr!KL6-Vj`}xa
zK?g~+oCJ|lG1X7wH-j27?5Qb!I{7cTLJDy)IouPO{;B+$di3ZO>OWbd$q>rc^G2)M
zY`)dIOP5ACw}asa5du-!j&XIppW<{fE!3a%%re^Zljdc?6zkoZ)@u)qsD5P$80;8e
zo#d-aI(JT<xr!xb*rKWv<noZU#~(Y^OiyqB_y$KjG`9yPr$2vhlYe^b;$0+#nfgvQ
zN(Fe1yO9d_Bn7;nFG)$FFQVby>Nc=}bv1V#@>cpJy>0dYXq27A&77${pmjuAh%c9T
z=0LfFW(HI8fZ(s^_5P2&VBJzM2r%elIS3~F=XNs(4|n&`ubNeNt@dBOd|;5H!w&{b
zpr`X_+r~_pvYEI+njTKQfWR>yqpzuqc83*mO?1gQ|Ds`mQCr7IoV0{YEa+w(2@FA}
z0<RvzkTRK59kRR)f7zN3ORg<6on=AC+>?nez?KRoYTav}hSwWo7OTd46VM0l<i+g~
zU&A1XrEcL#d+o{<*mZweS_EWoBw+A6d~9K#b-}jSzO0`W6X-~8LaMS5Ot{~ya7r7e
zCR$Vs@8AuWJS_nKkgn~donZqJa3EL3NMO#1S2V>aXNJ)!W~qsTy&P81mz5_=X7=@;
zr9X~d6HgFj$|~{-&H&AbW-_x~w+~_Y{GRbk1)60xmb^?cT$%sIDPRq9a{SO+&@l;@
zbF68rMFlsLD9q_YS+rZTsO|#<@fvDQ0H6rSsl}<sqyq))M6+d;@#GJ=b0Pz?RO%E#
zx03z2{C}6&a&Ra2{pdoCC<QvB0#mUiq(#urN|;gsjxJ~kmn3Y|3O)`pW<@j!$623>
zq=IuWVo7qsC0}R!qejA)J-)cQ88?V$sQyOQF8f?*=ze~ghJ-31zr2eNOgWmp+G*0H
zFj;fUJTC^E!5sBYj{BN0iH3!DGd`c!uB*Fbj1L&4x1QDzSQh$G*Pl~>p8@kjH>5vo
zwt$PSsKB4SUU`_he1Br1yn%i0)puSjUWU6Ua*(fBFq~jCd*8>#??#rK#~Vcw0zPYz
zCx87OMRkYKRuJfz1vn4ak#}U2bwsUrUt{kjOZw^E`{5RJ{Sg;A+I`TevUz+X3r;J~
zOm}YS*Uk5oB0c;*&vV>8kfBFF&h#!H=XrZu`1qJqJfB2=34E<)ea4O!&eAg2yKSV=
zJDb6I8e4C_Sd0XsPijU&f>IOZgZcdgI;E|InejI}ihXItBU{_}_!{H5f>DdIw$~4$
zisf*JH8kcB;mKo})jSQ%G?E>ZmOl$kl&^zb#q6Hp<%OGvgWG~d>*4{duD@B%uLrDF
z;(Sq2ppj8!jq@7jbEsQ-`q!3BiI_C2M=P%U+)o3T(5V-FeLe4hPv#msu^(fl)NGY>
z{A7b*J^;F0*%l5t>RjEi(MEGyau4Dh*@!w-U=MQdu7|&jv;Uz>@<kB^*#m;AtRzS&
zb=UvM)qS8;p3Lhk`|!LeJzHi;0XbG->a1BR%<P+<JNd2+OeQl<)}Z&4OogT!jKsW@
zT9E0IoS;2Dz4@bHI^^5!fJ%5~wUEssVs7{!=o8Rj=}+GL00<T$muimqoeR&yUEJ<I
z=a?`=w6n6H-DD?i?li1+iLG-cXc?g%L)=xt9LVcJXGH}lm=W|$sF#=Bn?=0>v%|xb
z;XvSgPk1L$1alzqo^4DHM=dGKtHHvn%g%JZ|D67JH%>l)YHT2J+!*=;V=L5<mGa}q
z)_q`L>oW1~I6BbzVGZ}#cY>^!*%a!{#de_uGf%NTqX{RPsZ;+s?hb875-WsYeWvqW
zf3aCRX}7r6z9`WYO{$7OKVS!t3e@4~gR*4p^_jyt&eTEcym2|qdU9?l1PB34-Qfk`
zuCa-UVJEYNO8bd!!G{mmwEV$VjZ3JAPoUo!|0u7snIp9u2(0)}p^7I(O+~LMsBd_<
z-Ni*epEW>QCV(vp0Pb7}CI#Rv<>AeIAWGr19(8qC2;Reg$_L|p_d4TAB`E3OmAU~K
zQZXAP`CH7bY~o_4fhb^j-lFg3y!!tS>q1X*nb>%o;x~J*Hx*<M&wqS__=jresc~=^
zp5vl$zsz_Uc8m-hDoB-f;)Ji`Yn|DPt!v75F7%^yrE?BO-^15-%{zm>Qyjsm8pwyd
zNGlkdEYoNLi4eY&p;GDN3d-?2a1&anN2?|@t?}U5WWIH`PSG@jGnss6MQsRwx_Ic)
zr$1kPm?1w5X(&}EX>A>EALb!*<ZmM_t#*k}N-)0ET*JVV>&#GUEqmLwOBYSc0T_sI
zUWS7yQq&qua2!_bYaXYNt6_I2F>!xprp~3LMOzOX@H{ow$Ds{A<f&i&<((rd=S`>z
z<As`pTbX<Rz77KUwX_4c(5(#kbGE^whd*|0-(DX+xcpAl&U>Fn13OQ;HiA-z@$PWI
zCU$4FB3!aVOj$}^oI@Aa1V;00hfeF!3b)|(WLE$a)O8Xwvok$jE}*<pLDVNVwk+}E
zN-__X#uf?O%#uUF^pWX;yLUs<(tI-Zb!E2TJ9b4+MU##@%ZFxGAiV&qY);ucKELs*
zNR)QMIZ^c$5S<H6lO~ksm6%g<0r`0Cy7P7qrp!Q<Dx2&~xK`E^I(O|VvS__NSXK|G
zSppN7I(@q6PGA<7mZfcb(z>Uo66O|bL47hNE@2!BF_aE__I!?dOqrravnM?tVdzDn
zGiG%%vQsJZDxg6tyxMRe$Y<-O_Q6hzzay*-xn8u444XKgXfos<P%uHiB<oTu`t-A~
z)2289=3N}O346ESV2Oi|BO%4YE57I#K%6JQvh);?Mp=EmpX0`dfTx@)20MY5?^ZyF
z3w;b$)H_~z0Bh=GBmsoJ5@JQBJF^V34{!!(9oQ8xl3Jd7FygF7^xnOi2axC#nO9e_
z6k7xn`n~pzIJp1(`IvwE->A~YpW2~uGuE6kY}W{^fzUCgXX+3OQk)d4+!RTs99W3s
z??L{1afh&^)+;7nk34_$@L>f7iS#rT<HzsZefZ$fqiXc^;v%v@>5P<^tUTkvuN8RK
z{^4oHfEg|C00zSSskVu0XU%E$SoNs|M`xvf)-T~Sej@hy_tdOr(7dR#HxhTz)f_3E
z3ynCEEDC3bp8Afy^1kM4x=~`HO|tx$W1=9|#(V0w-(Dz7Sny8Xgkb(%!p(gLhU}j;
z+4JV-b^D}FqVSZRjIeL=v9HfuoA24TxfeVOsAr?Nq2GbPb=`W0uvwV461qm9ZluX)
z&s3aUMoFTnw!dxUENsdveqV`*kDuCj*sRHxH}3`B+wrmsBpc=HQ!oVZonQtOlYWqm
zyZD@2<JajR*e{*!xjoD5`NA}*v6^{fowhbuo8!IYarJyS)#1|oibd1959S3LQFqMz
z-YkGdf|a6`!IX9rQ9_<B4A^=o#6u3T8@Yz>ex98@Z=MwyN8ZOnyM@^^XUxzDo)6?h
zemXO%6-c)C(oH>$j8vppLJdr5tVAXhq0gg7?FgqYTuR5%)jg&F_GO|EKd#0celgy_
zl(GT;@uc0$FRx$}C|{)Om)k5jK1Dm-yVLXw28$~58Vaq&`Njw9jo;9AnxWY%J_$j*
z?AQ0c%(G{m?-@Al#qC7V<WUV4nug30@c_uAaEfs)>y|_b@=Ght?0)+mKkT)cZ)4Mm
zDso)@FoEWP<Cw{l!+Cq6<w3})zK2$)E#!%C4kT+z@gMp2(;zjaw*t2^*%?a(0Q7O0
znDM~v4|xxW=6|BA6(`3bl$nmLokW|y{R;`*gI9iTg07MGZiV7aWFZ)i5-%(lm$(`X
zu`V6(KXC$VOa+34fThhRySOv}D-o`h$Fy+a!b_C2bTQXT-zxI&MX$+f^~R{CZa)j8
zvXD_55fU+c^J+Z2<ai)kE6VAldw1^LyCT5WrUw;7NNKQ1B&en0C%E<hZuZbL8gfal
zHSbxV*yLoJn4)jRJ<lTzgTvE{xiL9Q&3EzQb&-){GR!;7oim4yD1`4M?tIP8uUvyz
z%<W=eJ3OUELQ5kz>xq&;7%YzTuPe#H4|ar3UIxSDFnH_y>ycYK<_V5ZDRUgpJzyGv
z8E{J-o7AcKM{Od^ZV+*TEhgm6sK4fa;i-o~@aKSE5$m1}+tIFo-A}Mp`83umxYml=
z;SG?D2&x1+G!c(uygtef9u19|p2kzg&^phz;M=~AOX`^q9K}}76qlAxWIHN|j}v3t
z;w>9a6c9$Abnv?Fb<b8!;GhrEGhX(fiUA+C9k9t)>MSZw4yBB#a0fMSL@TIPU#I`K
zj4Ipv;1DMkkwoa>&-e7pshu?LPC-U>|Gq2FnjXKB)0g&U?nwQz2OH;i=;>*7EN-=k
zQ9#l4Ssl6YT|$ipJ2!bsk1hY=zHluHaaVH9mv$^AkDWQQ<l?zb2Wu|k43*wl0TZT<
zH>Oi3II)}vN;2$&`N$?I2?-@HdLH3z07x9b@KFF`3ErJdm-IE;L9EuXRJdkR?^nPd
z9&b<Nu;|CN0l|=6#M-=JhR6!W1l&&wHX3kwFC1BU9sbAchZQ^WrE{VD1+)Zqk-bJG
zR*6%*=s%Z1Uop>Wy`=N6y->U2&Vb56gyLn-ns{^n;}Oy$@OaAKc~qM^yxthFA5r0f
zr!e&P@}BZHMX8$H&Z-k|6Y}gnE3vl%4!D)m=Dom6vTX$H)h4V+XOvhwVR&f)vh<{3
zS8kZ`cg?o@l?%>wWk{c4Mxn&GK@IoI#q~Jbc8NA!ANCG9)Tawhypk+SG>D9ief0c$
zjPXCvlz@Yu-S&%zMNb@;fO0<9EHRe_<^V?eL_QT?-@2K(u?Q{bLu5~$aOrh{@k$3{
zH(Z}N{m<`TqP8PbmZlB(_&BK0D;LEo*e!E4s$y!x)DGy<>4GgGM*$euGGSK9#Ns93
zcWy5Hp$Z+UNTraV*7^-)M&vR~C_%Z&%9TIVj%9%Oa;L;d$NljVj|y_OR7%voYw4h-
z@o~I%mCORivmh<&>8$$p-jIVNM!1$e=6HJEe%ahYP@qijK05Rbth9e}u(`&78}3rN
z;Su3z<)anLuDOP?&ycc$$EQGi|GOFM`9Gp3dE#i<1=T~R-&K9)S2Qr%`+iYf2xp1@
zbC5wcaif4oR0q$6(z+5Q2@l89@$Hl(^u7g~TKASg23#dC-@l*vV3m|qsG#8x@)4~q
zcbZWk5;NWtlV}-J9?V=FG~(bi9z1VEEXxsP-}NaS4aUvbLBIUChXp$CR$CfverlA_
zD(b_KJ?Imp`VyQ51J1|E{;6<sEf$|K{92V)<;QB2V6bF$eMcGt&wp639-K23Er#Sd
zx|p;p=`zu5YrAn_gLaq`5&HM$UtHuixNKfO%0v1uVPmOFmvk(jJeM?yKSTl76$8;V
zyh0hp&U=qi=1b@PwE{e1cX$>Pa+v~OGEi$(tNAT+sL6qa5wy0T=BB6Z_|RgY<uZpp
z=l>&rjgxvb%3hx{6=Bse7e#L&#m{%=5aYf$-Y7^K?;opfn5Z&HE5$N}#k83-l}C;&
zm>;n^u)Y7yM`w-BE%bQ0@W}-3+tTIwYTFBCjsQKnID-qbP9*_;3!oo@itovjEv$K5
z93$9bQBh;6XK5Buw=@EiJz1o)P?BsPou*WtUb}7|lSNx}ThyL8{TmLhzXOfEE?%45
zrAPas9_XzxR=@zP6|t2{r<VIG>J#R=>j`6&@g&d=21r;tDs%CqhjA4-91+Blwzac{
zUHuUFyj+adfxv$C(`GO|IJg_gUbOWE_#5dQ8Q5I6^>R+men<N`Yy-N&Ge5qtB3HWz
z+ku52o{uIHpFa1Sf>`QY!r~{dJ)j+HIGIA8Qr&*6IdhhATE;|`MOyr~5`R4Y<1rXD
zw6x2ff4ujE>L!nKCO?jho$)=eY8E$?x#87<(x~Gj1DDN^^ZoWq@4jxtC%(d;K2GqP
zKQQb!JEOjWNb{$}&(`$IQ{ZT_0kif?m&H<tG>;qf>)TnjeMnPX&crh?!{>9}ivu?_
zxBDZ@rKo(Fb<XqJfXzoP(*o2RJ^J>2mVEpWRD=9C%R3?p5~9&*$F3V)eR2i{&SuH`
zks~YS4bo~Sog)-mN6(tX#6+NQB^<tPdp3En!Z;Rn64Eu$8O5(vwt25d<vk)=T<$%l
zcf<&3VAUDe+htkIlahdop5O{q<#PQMuIKy=MccA<YY^x9L;SVwvKmHs1;+a>oV<|j
zzz9DhXEMkrW+EgWk$l|BWDeaVFYaNzTd)k4qpq5qnLqmHKtSf~iz9?C5Mx@N3LVqg
z>$^YSoJ=K`>JUTAEQA+nlbfg7-*NMR?aeV>a(|TDRO{=<{=XjPZ=c-ln#M}Mk?DN1
zj9Sx1r%m3?D@xy<m2UVh;m(V%bacKoxAc%TNL2}Y|N74K7nG5gC_PT#(}(VPo4cBI
zhj<K{?zVby&rJ!AYqIJv?EMd`Jk<(lh(w6$ZL*unLRVJR0G%qFep~M-q*w1#^$^MM
z2&EhZa20r>Teo#lQCgrjN?3m)vcY0Le)!WKFel`(>oFGRwoKc6)dfF0O6d8|m9BkD
zIdo_}KCg9Nf6%_jERD!?n{_aUGiyN6DsoaB^0sS+k8%1qe9FbZrYJpFU)4+o0pU*A
z31GQoQvIE<ng~#o022(dq5_LR{Y5K^k5E&n#vzhkx$v?gQEZWrs@5)9-A+4{ZO5(o
zGbVI$Hm#kW_eCv_9qh}N!4uTbP)jvPb=YUBRR9+l71<S#p0AHvr*t2lbO$wyjP}dY
zD6d`YVi;C@3~nfg$QNq-FV93&6Kr=wvLmsZ9bNSK-)#TML!H844xreXT8Gmj-3STM
z>(V9Vx;fV;gpd7{1dcF5Jjq1D3eI)G?9xT3jmp*cBZt|%nK&Ix5Sb`fS+EH%Ltc}W
zwmrVDmgX8nj2`C_KZ3D%`z1E+hiIrMIR9>N;zOYVp9YB_=$6O8AE;Pc2pWY$h%feo
zrq(sSZB<#Gqk#&A;A(o8*$K4uV<8Eq^WV2~-OyX3%fNx>o?J<b`~Rek8z95R#<jel
zKwKqg@jqOg5C#v?oJdQG%t$>PC16foUc%*`i%2Qx1{>(9Hf`K^I7BQTJJiMyI!Ly*
zHG5lOB-7Ru=sW!0RE`~B8igcLJd8PFJ(j=sg2(?b_%TK~8pzle)LEFpTXIkGhQGM!
zzS4Zbg@#;Rm;>D2nzEyzt$BdVDqe6MJ{b&6+9!dvFh|Gsw9I79Ji0x2G8JjKzkYpp
z{Pr0Z*2oNT9hQ?HuYLaB<^M+*CG1($t@__NMZbERn56B=GOTX(!|i9`w=zhPZ=Lo4
zIc2-kjOyPcACCXQzOJBz1g~Az``Wg2Bwt8aXNI^YJl|7eb9~I<&+p&+Ri287zG)rP
zPGgDRULvmJTgOS=v;p4MLvkEIJ4Fe13BuT{#g3va_)in)6**!O<-a~3GJ2T#>vO7p
z;m=m)T5k<LkOX^Z#T8`*5zYDVfa_q30O8b?p<l#UO4cv-0TQcBr!U^Jry2D&sv#ZH
zz8Lh969MrMuPDNe$<0M5!zJ@xG&q&7H9B%Grw#45VxPEI@4xvTfl;0QbOtgaA=D{|
z|5IME994X#DU0S_8oWIzzLhumM~1e9&E;8dK;kc_wB(afp{x(j`?mhTtgj3jlOBQz
z9Q#HekFOaF>msNWOvueErDomKO-xN?g4-9L4g%_XucuyqG|8NWj!4E4CVK6<++5_c
z7`-tuhGrt{mEVd8kHBvYDE;y&tE5?5GVqreyFmk#<G=RbctFp1s3twP90{^*+JwXX
zA-!TEZIk*YPHbdtFINwbW)#*Ea3FO}b|N<VBB&sJX7nnN4HMJ3={1GUtX``>YgV<x
zNX;c1;J0v9Z%+v!D+M!4R0^i`Vf2NG(|lf@(|^bo5SV0s7)T+Ax++dvfbl^nHMgv@
z!^=T54rPXQO8?1*#f|zb&b-Kx)To28PSi#?<F!jgL1u^8x6y!gz?|a6g%OB$boi-4
zJG#Bi%mo9id-G@zvmSfZEeS`tD0E4&^YwlM8*bgXQ?}Mg6b=1=gwq$-CG*#zfK(@#
zV-fgX7#x|OUSd<9(61vSBOnG=O#-OH6x8cE;`zdo=&9&u@NwxFV?*i%%$5ttSPPdu
zw_VAN8%K){)V>i!x<O;@a%nB#wElhhAgQJ;orp|aNpL3iQzVIV7VVVyGz_ZhQW%!}
zTzj>jX9d`pYO%{)eTq$YlujRFjl)o|gFH={G6m^M$A>jvt&P8PZ>Qo|xSK^qcn)Me
ztF<~<EQ6>&VSthFPdPP%U@`SnnS0>z>tWBHAyYiQsM>)t+LOP<zh8H1J5SwX;F)cr
z9imm)AoD9^BEckZ*ymruk8P0w)@RRPWkM&;0xXh|8=z6T9^^Zl$S=*0AtJX4>+wu=
z$e_x~!r6RDg#RYrH8nK!+y;<K!oo%ZUZPb;3N`O;1Ff%BN?kBX4jr7Im$%nCz4xAf
zW}5B;Z1h<C?$xHVV?i7M)t`p9nnXWH3y*bzo}pm_V)q7gV`$y3nx;LVgr<AYAt5jb
z_BrVM+jcdljp{vfo6L32XuTti3){WPLgVkvcqt-|B2aLGV9M{<E4X60p=z<AN$cD8
znofN?{a-DBw86xS*XcbE;D}VYuOD?58P<xh&Ay6;ym~prxII858CV$tbR#mddNnA?
zH@n)cD{)7&-YvwD>Jck*?G}Jatrw*ZQbDYi1kz(U9ra!l;C*Z?6CD#)N#PyA2)yV$
z$iM4(7eJB~&!3NIIQ-i>2G{ijLhCTJ6Di&X3<X2c`}W}pHA7@<jGRdAUpLP_{c^oA
z3epO5&3zfl+BYx89`0I@BwQ*m!6G^=yTWLU>`MW>RomU#jv*t`SOFd53OA=-TcxU(
zM*aE~{#Lwh>&>YKUo71G{CYvLYIH8r*t4)%-lsnQO$x|bN6uK3b`jDzf>9%a#j)$=
zw8_vbcMq2CrGpG&n>s?B6`v~p;7<$%9Yk!X`{%-ze9sCnG5A?SrGwO`bd^CUR_dm(
z0HQqEuGLVc=H>Z-!IV>La?lL3650!;D@&WjC|Lw$Oe(=22O;_`OQg7H(tGAVLD)4z
z8#K1DDMYmlt-!h)1Xy~yy77D3bPmtYB?;0Hyjjwq7cj7>$kE{okA>Aj3s&yok5!)=
zbb=>Txs<<K_o}S7%mVU146g(u6r*l|q@(Xy12wi}#n7*70C9xRp*O-PE)QU%&@}8o
zivi8<owYtlm=t6P@&kr~hbUG(0BqDF6pd>ZuaS;XE~)^M2=n#QwKv`vJ7tQ)*(U&S
z3j9_nqA)$ee}QSWQhV>5umuRNmEOJBpN1jEsjDO2lrm3e@OE1Dv{Pjg647jE;MvZc
z=ro`Lo~LeB9{?Yc#&CoXh}T|>xB8jll8P>%9fv^NJ_rC(EyJW~)8rj2>Uo{F^vm=9
zCZ^X(FHA)Y&^_=K+6SBAQ1Bb55%t`g{09k&-0|}E+gfU9tl_FqoC#;kzmriP$_(gS
z(7YF8ibqa(IJl^&Xbiyi%?>63HdQuBcL2?Yhq|Aw&|c2*=@&j{0X#H$+iS)Q#eltT
zB|F#7niUco({FLjE%UdVEe{qSXFs<5N@?gRfxk!C1)>IJo<*FFIj`o+v-f}PMRZvP
zWtZCXHbRMY;qi13)LMJpH!M7A4JgsMu15n8A-?#yI4a1D{ceR^6IGM$-Hif0kYphB
z^Vw)osBX}Yi47ERt=5uw{vYsj(~$fB{>vQWq0x0q<~G0Px@d4|aWT;TvSV+JkaYo4
z1Euf}JY$aM2{C2@`N+L{w*}PZIQ_;AtcMygS|jTnk@^T#K-8K>0~XaI>ZU}0hCgJ=
z?WEm{U0B{XC2FGCO}w$vppvN{Zts#VCdWE1w*8N?qQ|23c-6B1L{Mj`W{3`q3pIgF
zlQD?s=%=&+hFLLFI&wdln-KdY^wT3K3bu)WScqu)k8hs+2GgfB$p15jm`)8#KgJ}d
zbeRyZA#mXcP$8xn-QSYGH1O*?MK;U`v&Xq~?G`s^sVQyCgNSq<wCuhUinx8U#@8w@
z;?G7{%JvVgRHN0-CGR8kc;Tz(K^D~*@{dL{^gv9jgtt2Vy6}r)>+{R%>QQgVU?yzA
zUyX*%5Vcr`zk{1N1k2l}u;tcYV!xtI>rvJ3YVURxnhVIBd^#-pPdKOwfJa6q{#DAf
zb`vkG=u07~Tz+TWaj0U^P4UJ1%ece*c4Rr_h!ORv;1Ot`SLa)t0FD!Da%N#i@CDJr
zTMV#E@6>~z`Euvv$&Of;(w;S?UCNj^p6zB-ePZHF@xAJPgY=7IIpFBTG~yn_*eLOk
zg7`RGeRv}gB^eoww7TOMGeCoE^+<E0{|^3J{KTZY=Vs3CRCTC)wP?RfE{Dwxpj!|K
zchV%ApZmCpgbud;JhESyqcQcPzoN@Z-qB@h8UhKUAGsv$$^HdzN8<y*G-e|PYYA5P
zRGj&~l0QM+=6$MzL&<rhI?`x}L`Phk!t;ZPyOe>M<Ip{|<B6|Fbi8D>BkQ})j(kzH
z@Zrk=J>Nd8d&}Vv)rIyC8R&+Nv~+S(rxn@2FCpTeKstv9ql~r^tDhBC&jush;68Xz
z<@13ud$4iinb3I)sM5jJ8~Yl+v#Bcdt(({V%>|yr-Iv{OJbAUK?m5NTrKvsMJzDx?
z7~?`NYm#DO+;+vh`eF7^{|m{H9m;J)po$@HSz?{IT#Is^Vu+K?SdrH*tKz2j7b#-+
zZD`(xGuLBIiLrjYeUq)Oq~09eXycnp1K;|2s4Of<SadOtB_2Ik@-#E}>dgk*Vr<mC
zSj#O?gMKe_P7R!@u$^St9-!cS?cwz8(#Ah@c(K?l$g#jQ<A+g!V$_Gs)UclCp99@5
z!vljb846x-5P=M#5)suJP&H&L-%J$=jlo|4B7}X!%O#g%7wW43Y+>8#S`uC`d|x$k
zhjj1-q+@#6CN#TPw}`gWkj@0mi&4n>f$YZI_xVxhHKL41gNo4M()if@-*wnf08uL=
zH&|aGK$+!s&aVN|B@1--7x(Br)PPG+f)x^hOH}BE-{J~{l!e+~mO}qG)gS-0Ufcb;
z1v@r1w<`+!QK345+3@B1#w-8)9zs~BSyF_^)h=>(b7OFB9Wgk)Yy+D0K+NeG&N%tt
z)9DdXA4TYd026<9E$M|e2cZ=cd5j_c+x0<}Y_n@s(v)BduZS$ZamFP0U-NIre*<#M
zU@Xoj^)R5wZt>xh0kyW+wXwHSFhx;cvgJv7RGVbHVVXjX=P=m9vany;o>j=YqeHXi
z6_qhY`Ipeek}Cq$)^tEvc{Px^pk3I$+<&gnj!u~_Ep*wiHxJy|*9EYL?j(HSzS$HF
zHY5oDnWZZuV1khjPD7Ew*`4!wp&|XY=oU!iNZ=(gYj#ci8bc1DL06Bg<FCs2G)jHF
z@}-Lx&-*-eE5I#K$=9}9A|kA5A^8lx4y9<F5h2!PCdsfOnM;q25Zvu+=fWLlJ1#Ds
zq9tN4P#KIkwjgX0r7H}K0QxAQ73a=<sc4udm^wEQ&FH0;mTdEOW;<_7Q8I4X;@J30
z5QnQWdO`Lu4g<X8gI9mG!JI~px8A+_=3&9K{aHUR1)_vyu+25P?g`L^$m{R}xRv;O
zC1Px4GW_YzKdS}=`-SV!ls5EL$+)`q!wSd*a!ekfW(+<wAg0qHcV7RF&8mDpY5e$m
z-8SzVKEZllJ72{#f@RdDQyqQi64EwKCpd1P+tTNz!ufgp^ib0x*m5>yP@3XZTp#FX
z=m+()`s{NaGe(gY6F`>X)Fli`9viR+gJH`aS7yh&Wl$t+Q9k1*s<ZMavHL8tuL`|o
zY<yJ+v~~5r5+EYu;{G-&)zxA-0ylcSQ-R!J<Uvx6{Owt6PrXIF{q;sjSN;e`jp-yk
zE6UbHd8k;@iL4$~4e1Qq)X)J-h!>&1oLyXe^y;-^X=vffduIQ`b1F1-TDBB*7bA!A
zHDm~=U%x|2)3mhelkt@0B8pEcVObzOsjnXWnBC~NEW#twipv9>c2|NvSp{|L$aAN*
zu~ecduTGFQ&cME*8Ly)(v=sO^VnrtlPm)5mhEV7dpuS)Ktq?cU%$}4&4fXoU+0Xs?
zQE+vXLqT*MPA%&Oum7u$(3XmWgMZa@gMjG=w)5r6d4*Q%d_dFj0t*|ZyV;vDOeLmf
zW3?l)SAJ3B==qGuV47h%ZLWwCC%az+Sd*c1dRJ5c_Y+tB)D$0~p{vb7UncuMdfD*z
zkGDeuetjxk2GitWf1JE|naHlXzZez-qmT7)E@;KKsz*5N?Gv_O=EsbD^mz>bj}Q^6
zNUU2nRC%-?2#AT|?sAcl49e6ZonXR0OP((|ejXoB43?=8<7fH!M8Gs7p2>XVEwgYx
z->&{6QehCh=!WX}nl`~Sa^}SjfE<8>Onyg&p7<4`(QyRtRh3_s&%nv#h<?u)*;xY@
zcjL{9V-OuZrR0a*fZo4CJl2CLq8pNHhJPs5Yj1)U-g&n4ta~i>RhCwDt#x#Ai;GVb
z#br?L%b*+IH}o^u1I{5L6ySm8P29i>b96iSvbI+6Jh|8`S~SYP5LMZnCX95M*2scU
zh=#s{s&h;-RHN<?-ya-pqh{n8+1#4XFS-bpP_-7yl@)GJJdECLq%ISvPe2nQj{vD~
z5B@a|UD<C*)Z7=lfqaG3M|L7Gvf36gmCC!$F0&Bc$_xP$KQw2qEp+MN%hA2aOtPL<
z71C+3J)ed(xqFI<fkA@%7iWbbD`KCtr?jSBsIT`PP23Q@&sF@NUq5CxACAYa62z=%
zq_|?@7pd`Q3bz<&hOJR2udm^xuMjK=u`0~5bZqoo%Kf4r9lC@yn-&)@ZOUcUh7J2R
zU+(vKEWgIbVa2y?1EL&~GHTm4T0FYEFwDOLKi2Ws5JVAj4QT2rzW<s2_WZ%UnScKL
zF=#kkYsOo{dM7ok@+<3Q1gE~aFnMHp`i}7z=a{6W1=c=Z`F4nJvvI`g)7^$CS!(O8
zYdv$@lMcV%3~8uj)nuJ-hw6vJHRr!s^~m_#%euhq8~a@D`$hLgE--*iI3m7fK1p_v
zK_j><YybEmeCj2F5I~B|bFv!O=C0uwi@+YXck}YVn;~Qsonm&6N(^#7tP^Hc&vaMg
zPTOrdt)4YwMr2xfL&d03mzB($s^XcbyZs`0_L-6svAxsKsRIWMY9nr0q6Wp|nBqM$
ztQvfQMW=)NiKH+waYlqsd34c}qoWKg`BNe`2i(;I&%`f}CP46aU`Zx^HgF)4GcjG=
zIAR?<G-Qx?!$COpq~S!2nvrrV{kd#eP;SyHh)9r{8Ko^m>1LLn2#cu`m1K#!*<Q_y
z&*}92{l$suxQca^gnzv3m3E}IEcE5)tS$8F7xp!9#xS?tKAXlL8XZRW$iAm$sIKzh
z$6VYU!lz>?%nqaiP(By;M$&17Xi5fTN~18Un9PJ@!`hswm+szmanSkn@#B$ncMmXi
z{D@@mk=}K}j|(6^Ql6rK=^U_{`XwedR)cE+w2|m@up7Jnf=3zTf*$L5eRIK3EC`7q
zj`M4PX!=|;yQmdr6^stux$Vx;rxz_=Y!Fh6XKLR)>y{*s+lW^|eemCjIM!p~pIW<Z
zua@VDR`4kQ;sr=qrwXMbdKCiLu@B!IfW`1{r$}>qYew7@VU3(^f!G0j@yl)4e#-`?
zcVK8M_`(T;U0bZNP*71(;Y${U#c<p4ZP;a3b%9<?EKL;BZR4Pm)f<I)WA8364lY9{
zKa{)mly3f0*+=D&o7G^Zo6o<nO}c{&dYr5@=hGAjIE->{eA$%r&On+Y4y{Eer$yf@
zqyIdxJ!-Yp)up=qn}LOCv}`%@%^lWmzauh<f`z^ldF-wS$C!019hftsoAy(bzARE4
z0FYTxQ*-#^_s&(x3mP4M<>lj(b~>jy7-B*<wz4X7qLE`z5{or=nts{<T19E9*rz4^
zknDQe-D`$zTK|I8-=4J$wbF-yvrEo>h{qnzi@hX}g5iziM1p)NoR}!puBi7>MEbow
zxAKdrOi=B2nmBz>9RY0`!sAaVHeGh)g1B|lwySviAbqY1kF;sih!rLt8Wbq%s!D#d
z<E&QtmzAa*3e+?SZ($gyIh1B2wJ?VHT$v=3Od@lfo+ow(#CqS|hwcD*xX#e&WjkMT
zyQ2EGu-U(^93sA<S?rY2@1jN-sE1iK8XDbQV{pS0+m}5q(Yzso90B84crv5mx6vUa
zChRg>N}eM5N~bT0C_hjI<Z3$gIvX)0eO#=4xURD3@cn*ShjNT9p0*2jaw-YI4upo_
z-Lk>_Z)XL=gq!Gc7M^oE_p~19qVxCDtX)*uAgv)2fq>e!FV2_T61alG1nxn8GE|xj
za?$DUcQVen&aomnq2~!<z7Pvq`$KCqXD3~c<RIqd=SMc&Pr4b2PJoX6>Y_T%R{zj>
z!rpzvZvG1YuPlPbw7xxS4Rh(OJ8K+mef!*^Spq>Y;ppt&*<?LDg$yVVBCa?N{gqJb
z=W4>W5$H%mN5|Df*LqUG3EeL0s@Pkv`5&m!)Op-=XE!(5b14wl#b2MJQ;NoPA(z+R
zRg~6qV0@yiYnL%`YD4Ij6w@SYLE!P{Y|vJ1gROTWg^c%p5~;JPd{B-JsNRRNgkscq
z7&te8du)`i0p}$>yKHhe`<RQkfAyc=<#o%NZnN#g$H77$C!T3Q{I(w1`jRFA0^}`r
ze&G|*V0)p#9cx6fn*l9`b<-B6i4Q`jp@K;q3n#XWxL7t8jhR6B{96%+GK2Nt@XH1B
zMRNhjCN=^9J|fviebY7S><n=w7dH(;V1P>-#}gAb$<brNCYZ4)<g8V$Wq?S!=H}UZ
z|G7Hz6uM8Dmk0?K;S6xz)yPNA$y!tqN5@#~ddAOWvw)EdsBpPLiWq=k%FuQDytP?O
za)KF;Iy%4dYykDV=nW1({W!vEyy`029)8g+JkUPAD%(D<^%M3ZK#im%WW&CpFTeV_
z6v~tNE!$2bi_Rpyy_Xi9>q-;4i9-4*m@B_BsnMB)XJaNe;;(ffZ72q~H}W3NTH|mT
zDTUOMp>zIyMP;RwM~q&ekw0d=x*0)O?SI8vQwn)fge=*)yEzOLWE#FMv^X*@gFJF<
zZMFEG%DdzIQU+87ij<j=5%FxGQ%Z2|EEqQ)Fu@}Z-Zk4Q`f<YBr=zpkYr_>Ap1vv-
z_KGyM2{`)R?18{#G81;=h73ZKRqiNy7JRv4>vkvOsFiV2GDk#E*DJz@Nxcs2f*RKQ
z!5I_gHufJqI%Rs}FTk3NWm@Q}BfDuv?C2Xf#p*!PxGo|1O|!l%cl_%n%4^-a`}*u0
zRl|ZN@O<a5*_o>QT=E?}d-d!&TRVA*|C)lQIe6MIp>yPp?-aX`QJ0>OIQcF!Z^VQN
zH%~vGVw#piglPr1${T+N2?WKLl9`}AocvPOWzdiz?d&^kj}fu|o;@~=;```CL_H7F
zzJ1cCoMA&_#i#>gbT>C$Hn=@+`D$F=iF$hLG{bgZN?Mf;u<cfxq^~&6rFxEsB|$s=
zq6>yC1Q>epHHBW+4EJfu=m(Jn`k6fn!<d?42viND%@*@Q-fM*Ci*SCA`gc?)@AnOj
zRM$~gw`jOuODk<RXU7fg0HVChTt)FAGPK(%t|Zqhf5ch##Nt}qypxX)FvPf-DUvPH
zAzNFIDfrSw#wm6qlxOZ`4K^Ho|6P$iQN2MB(oG(hB+8~^#vYXY)krrh2%EO;3Xje~
zZX@%_APS!7gNP2rTWu3t4O!8L!c`rv4Z{$ZT_v8&KGn96WKV|gGACBrn-*hQ&MrX*
zDpNQNGUa+TqjQv<OQ;URa{XmjF_BK5&e|sP%5ZIA{kEd%t_Q|xYsu-w$zzSgKnNl5
z?028~8c?u^zJS*HuRF|$5iCOLz)+#Ab%VkyJ~hknV@+{=zJAm3Dv{ehz#7n}O))gF
zjqb|d9l#28QIqrWP`Ha0nXhm<xA||l77^@0lF1(d1peUi@(Un7$Z*O9hon0v*rs((
zOJo%?ut+O&Ww9gJ0|_+4^;#LXRF;A%Y}{_uy2<*OiRTHWOm!T(e;&qiA~q3tK;P_M
z_K&g=5E2rPzSp{7%yOCc(B@pqq3d)5yuh@mUmGWOV~@6`%;I25E|UlK)+j&>uEiXD
z&#2p6=T58K_a8aZ1f}@)xsHD*$pq+U9!<t;n7$CQs-j{Ig!9wYe|~hpHG3TZMM~z+
znbu?N6n#`_3ZzUH`wLY0N|;Xo4E^U%rMi0cpP7+o$93Qmh!Rq$SMr^lqMjK4zJD^8
z4<dSSQ0ie6Ka4P7Jm56D;2boeghfQ!sfmtEcz1I>txDU{KtZ(3NOcM9M|_{yA}QUl
zqS-t)>J9^}Xwhg3p4mvzSErx8nKBeDA6#J7<5b2<0m548=o}zZ;Ltk^w27W@*r7Qa
z^F68ChU=<t4clkA-^oEs4^i#*xmjufI_sFKI&^#qgPKSXxf$n5ADo`O7C<KCZ7~GH
ze-o=0N4=RhJGi>E7qpLPUKn?EIkP$f3pxfdec3UH2d_+*2~8VbQ#-y5=LI@gba0}U
zC*pI!kCcD-c6Xg)S+$$#uEBAz7Y2y~NvSe~eeK#tElVc<qd)qZSbs<&vOg|RcDZvg
z_4mBmg5s0v)lFTtuMDeZa=+?{$=aMC450`_Ae2|tOh8|m8W+<)1eCYf&dUQxSymL)
zIP$-{f8NblE0;@z8A?Z$*(6SvyNOtS9Bu_S&k^<Hfx;b$!4R7K`ze`k&Wy|R>`5#|
zRx?}ntKWTgT2;)!#1gGnuah~MgPcolaJPFhswee;?2%e~G<8aFjTp?Ku4S|~BlKQ-
zNa9#C|6E>O8<R09C*(Aoz@$txeJNv{iOMqe!&D#~%Vd|}Im4Y9N+)`Wj~kXKPW}S{
zu(Y(gSa#W=-?uL<MFa{I^f+!SSD+zq?sXzPJ)fs9I`oht;mA(_XCAXPNr_-eS5O?V
zlG$6IO%NAl(Tj^Aj&9iDlujUz(zXBj<#Az!P~Rkx$cCq^R<4+F+WEQPISJ;Fe2lKx
zxW7s>q9J4MAy<kkHi+QHB5ERWlDxWz84o1^e!J|jB;Qf}(`u}|FjC0Z7EC;jF?Ljl
zn?FDA$`v7wNO%&Z9UN}V+Lg+<C}cR~&biWK$YqfI4)3Ntq4`WEztBHgI^REf<j6Wo
zf0UI~_tWqN>0dZ(3Fh9i(`|0lO3)!d(c$i|@{&rD@sOK}U98MWWG;U3KELSji|1oW
z%f&3ec2<2&2?T7~W@=ZREqqrVKKpL|+IDf#rJHyh+7|*fE-vn2;01zq+V8<xz&4yT
zY3&AT+`M!9_SKIjOyt0pmm050(Qj~CkMJ$Y1zdMC#Zft+45!)ZB6~}D`z)x_f}~0@
z9s5E65(1O}ol?KW1%7YHuL!wt;X=$m7Q_K=Q?I)}=1w|3Rgq!X_~U&CzU%yn<!(Fe
zo3ghUok|Zx{x-HdTo8Nwdv1}DxF(yGGCrVa9_M&yg{U)Sh<tK36&GLfnUWoGRaWnC
z{}c4T{@(q6wE*30PLKJY$r6b{q$;Q&LLS&0EUsc%W`3oP${6TXyi1S{Z;x9|Gm;iO
z3y`1D3W15wQwupKN5$+KaZp@9<W$rBVVxn8kf|8if!ojRXK6cDrY~zsk981x%oJr~
zu{@*<|CfP9>Bi8hbZXK6%hQNVU3JwS+#X>QvX*YyHau0fzn{52-XOB`oIeg%{qlS_
zyjlcEVmm6yTfJ64@Z`j9z4~_ex_F*^pdmvpxaQw{{`t?&qG#J4L{nIF`l{JEzMFRV
z;DV%LZ$8Uf%xLeQ@o7v`7CB03jYSZ^$EZYSI9Nr9Ilow44$5tP6=yANZ7j{(avKUb
zSSaU0h<j*^;;EupCDIZX>BbP&+K+OWf;=$)>Xa|pc)x&g0@^l_tx|L<F8<54Y^9@N
z8bv_u{!ao9*81%o!c@r`QV+8P8_+UY6GUu@^2O{+2Tjr>h0T38eea5f2dI%nKi6Zb
zMS983=hsjeAjMhB2S`60-Bv$Rm6TU=FRcv|9I3T_Iy=DbKfZa?h9oX75duqyeG^$6
zzo7FecH(Rt?`<iQIN~3T7LAU2J;W2Y(30@~L56lHIU7COChY@rm!Q+O$4p=bP*E?#
zg%iXuD*I=ONMtyxa?z`{X-w_~G6sWdjhJ2pLa+qLV0+Ejxz(C}pi#?~ySkedegjoo
z-=uXtzz7k;qiR;nNccqRQei?*fsq}nY18zOo`j*q6-P5rsi}P%`eIV}FTUw5e?4H4
z?d1m#+CaRgH##6x@WzexAUX)rGQGt&$J$FLza^|7TuB>Bw_~5P&?|f5$wLLZt@+S3
zj<XLDtn}m9(VJ6Rnz7f(j|#h!VaJE(mp7+ROusSwU@`n-1kU~VLG*E+F?tL5@>Db!
z)Z5%@_A-o(byd@_G%oJ-n^83M{Tnz-e7yApwP}}v6dBB)Gp4l3oJ!=v%=4MCD7z`?
z&CkLDfr;deK7BCHaa3z0iu9zUS>d(if)_)P4y+sdc^1lmfyXG}%a){*-Tmr$&-J-@
zt@=Y9g$1+R^_fo)%Qo8E9xN=U8SzAZhv|c}{~p`5>ehU>M&JP)+wl)J6u($3vn}lD
z{NClnG<Y3~rR5Pn#+Ps3{g6_QG+lTh5PQmA=@)Cww>czDhxiZ-L8+eNI!nFIzUo_;
z-~sQ>nRzPbX`QZCqi3J@Z@m961N<iwSGcGaHvhW#!a3^lD_V}qYxRtlZ6r)Ikit!_
z5nVb&M@rulr)n7pvf8)|q*j!G%zh=j+nqrCnTQI9Ma!cSUv-Y8tdKSr+5~menUtd0
zS|k{DWe+>lwt<q;R8D|ulP2@}-fq0BC?7&h$PYM>jB6jVyW400@$+4*BkCOnab>J~
z+<9v)lZedFIQvdxO>-tQ8v!s2`m|1~EGCaGwTbC2JKKE>REhU<11HPpJAHl~#i9eo
zNCZ#xUUX(`t1&h;Ro-w}Oc_BSLV3mvF)e=caL=oE<rNi*xFMi#NnV)RW+x||DX?wM
z#ywj-0>83X`Sjrfv%je+cJ%e$mJ0{870DAjWko~_m|O?PAP+muGstCbN5)&}#PP+&
zOD2M^eh&)#68t@QI@fJl>e<JSN*LiY0lyT5)5A>v)G<f9-nFBvKo&ji*|i;@+`x_#
zmbgbaK*50+qVwyF5yY^&&y05<Qx|j|ned-iqw{x)%3WlX_>i3{G*sw2LExUIZTbZj
zJWb!*IO=aj5hqK~#bbYBx1Da$zNo;75As78mjG`dG>8o<Aw?`BkxWFnK9KnVJi}0_
z^}m+?9P1lVh0@&)C(pJCST(vuzv$6ZN-!F}Lb?+pbP*o2;KO+g)%IL_$Cb1;l*+{?
zrjO(*p0W-bIl4jQsC5Jw!NrgOjx}DQ5T~>mwphle{4>vrDuIke20d}5PxrDJ6GnGl
z1zjV`YRaqnL6+ZS_W&qTqx@7l5_TtCbWL4>2=d*xfOE_7ubIWDoV!ERa(*+{_jB3n
zc})<-lvh<5lx}m?u+onKS{33T_OSTBfrw3`5X5@SYjQO>0E}1S{hx$inG`Ye22P~d
zoH}#nh{wwqnrMl-YVxDyHyNqx!3cmrg(B&y3Y>tq3IG#Y-;Q)EjCV;-*Vzs^YGGp8
z;@9_E5b8&Np1HvN!6lY56&AKUxqa>0;i-?Glr{if;WhjX0t+5nK`z7Ohz%n)08kPs
z`ELLIA->Y2z*-)8_XRjzwC^ldbLsB;l~mBG@0=*Ny)%5=&Ms6Ww1j}H6Kn>wRYS15
zmgliS>%~x&NaHDY%n*4Fv@zH=r!x6f0DuKOx&5zh-MjxeQeJk{eGm!gkb_?mbw7D-
z$H`{@phG6^VD6T-Fq*;(yiwd&#%IKNd&{!6pWmwEzJjJ<C6PpeYC`nqN{zQ0=n5GQ
z!{y>W<={4iW@w#2KPsprO&o$!Yz#VjnOSz}xNRq&22yYuW)4`2_-$MD__piFv4;Up
zRRN&6dZ3H)&$j^nH`pRF6&VT{+}_c&>3N#BgoifvCvT#c!1+Gq<J^FVVHn<^q!=|O
zD@8S$+y`QC?&;c;unQ;SR3a08*F7C6H6S&xxG--i==j7gW@zC)yUqtYI*xr#Rqth1
z11Qb<RV7*?3T?7&bPQbNIQK40#W$x;eM-41B*f7v7d8S0dt%BgQ-Fq%84IOp1Pj=Y
ze1h(kPJfc@_Hm;ghM!G)^Yc_^83$3UuY9SjtTott#7<?81;b7wZlrn;=w8GTGfERR
z1q&iWY46f+q(EsR`vuSeXN_N4r^}!O{g=4Taib^zP8k7QLp)0XeE0DV;YEWDsA?{(
z_>|Hqv|il(JgB`&gslkcc5Sy)%`sqvA?mExgQ(^$M_laVzs*8F@)91g@@o(fCPw+B
zHC5YCUqwZQz2qHCp0}Db3GiEvG@*=YK`2qeH{3Tz;TA>q;+OZDVs0ar{@&ik0wD5|
zpQ2m_zaRgp)9GbswblcE+%pcp^<puNy9#&y$2^_uWN`L!Z(`<<;xjbA($z4EaHTtN
z;G{P*k6Y>I$TSoh#vXhAnd7;U5*LNV2A*zbw@$=u0uTW3%7HfHbk(mm^@AFr3serz
z*PqeD`pJwGPbTdCCPY86L6n<cULM4Jm+03`Jk_grEo6R7_>chei+l6#>>sY88e%Em
z6VqIir*T78u1A~WtZL|bCF67BLf9-Zke0~W);!?sjUSIWR-!|h_ZLW@U$y9_eUNy~
zLs*OQ9nR-!98$Ta=liBNjz8JoKTONix}LG`qFt8DImZw2g_p^GK#8q!an1g->C;D0
zN6j|-%(fq*?_><jRb?a(jQK)kbX>nZZTbM_3Ej(hlQ2p>T5Zw^u`j=qy)9?zI6LKI
z5qn*4)qmg1+b1mUWYJ07nNi@Ps()#)Os7?=!#_uCvCs{oA_a^y|54UAy`=8B0|GWa
zs+fJCesRA0tdA-qE3)i{bG@GKPC^#OO*zbJy3V*p<Y_AscJM0s24t`l(-+~0$m&O5
z7o-xI<+q9bY_=9XyVkCVQCy}9#Pt?oS1=M<gd#SICAql=Tz-4RJE@_+1rOk#gz`PH
zv7^m9O);`^n)CwRv?;D_6c@piNzAYzE^Gqv1HiEDb`n3vY;jF|ZrYKdpgV2VR7msX
ze&?zjEz4(~m?;10ClL*C9i;cpA6b3>8@%K<%V+~)2a#hCm0=!6pfRMoWI{-Z7C}K2
zswkaEu5>B&z<a?l`(?eo@Ezgj8r00&)?SS>U$v1kjw(ThuIl%pLU~eqbQXHxl2}QY
zM7=AB0MKNw<^0P|Z1Azg;k8bdV|r5$7eIrWWE?y6)lZb^g2Ph+OVFk!@K^Uc%r+nT
z_PgGG#_w7L8^3#@T!~BZR)Wa;#!Ih>!yk>nfWV&vhzv(+{i1A9vy%*1<=B$&;=-%z
zLMMTE_>$PiQ%)i?PtHu3xdp5qz_x78{paL4C#Qh+mg<a_@Ipc!zU3(3q7zOvEDO&o
zeze0+i<w%sgNJL`(XG@GE$N%+C}r+|50EgCeYoGt!q>|P8aEJ&XjL9oqR)cSGAW7k
zyNop%_PM7BRtvFD-K3A(8cCFDi(yA)xrj^&;(07?a_lm)oi%4FPdyTuTx!iQ)eHU?
zmUmTGUC4w87fp6D8d~p6d5M-%##Ctf$NIDeGaKMnr7AvK;M~sZ_7{5#vOpag@$x1b
z8AN@IhS_AlrGS@(kPicRQw7wOdOK`~9W18Ryl3EQS^fOEC^<Rre#cUilOuy~z(dxd
z+mkB4ONz5U@c_{ODSxl;p(pi%&@ZFMz&J3BFm#X)#yZeuG>8u>HB+*s!vfrtEj}$x
z-M-eA+=L#WP7(R3I8$)g0D%j`IaQfezulHF1e*H6Y|fngy=18WQSDzpwwsQC(<tDY
ztxWTo%#UBVNbpLy8HuZ)L_DNT{KDxJUn1>8u<+4kbrK<&`EYSa-Z3%VlNJOiBa+v;
zGA{@Hie-S@GS=s0EVD(OjVM-~A3`+pH!N^mW@cz^3(KJ!2(F~|<@PSo<(;D|XVYY}
zYTB&fK7O_stNxD{f`u;0n&P6X8Fq_pY;=@?<JA(2y=j82$++7G%=d06y)C8KNTSNA
z7Wpl}&qYy2JyL<BoVQp&c_9c7x$SV~;2ko=E0$(JRF{eNb6$1Z-v!|qEy=UZy;C|h
zymn@lin*cU_#uzCj@D!b&zi5}a@IxbI=;}(Fo~ANTHF5onX`fu<nFUjFLHh|;-lXl
z<39d-?OICNwL&q{?6rrYHevVZ)5~|o^0N!S@DY?{vafgVvBs-hX$hzw-<%I^_0hp#
z4eP|Ea-*AJwn$O;iAxU96{}Ma>w34)H<oTez;kRSB^6S*4(F92SFCvXGMun1mTIKJ
zs1oa8!^U*Y(=CLDVhKkhHqFSkVG&Pt`E<O+dnm3-SaGa6#`|}^zLV1v@ZoxYS-_yK
zsd)fSvK<EASJ>ytba)7IjlSPkRUOl`8rW8i)=)g71HL?3dhLka4AGM^Q!#={Hhhrr
zDl7_=)!K%#aBeCn9reeU&RA=+4S~x{)2@t`MS$2zlxC<Fl4HAr(>7>e;}h(SLAjf|
zJBmGzr`L}Gl1>Amz!hQV!<YPlWnbR3V<_%w!WVLa^G<!!%xhDY0f`wd=yn~0Yv@ag
zf*JMar4I%-lT{*|(w-PvDtma?C7e8|iM?Mw)k`tpEP_OldBBnZP_KdI-D3(7Ub@1l
z$a$O*^eHH9>YejwwwMym=jm0HmpfJaqo%Jwg(2-LeRyJzV)~m!NPo`fehG(|XQ*2i
zMnMdJdwer}ZTGHSFJpt`i(qJ!fu`6f5qnpqe-oo@D!i`qh9B!9?(MMkTOYXgHCc?C
z7hdpVeRrf(P)W-G5`g-g7R$I3V9Ih{samSTt1jQOBD}5m@}?>6p)@kXR1~Y9J&Sx{
zW);1nQn~9po3^h@lACk*Z^1f)m5Lb{a0Y!o)oIM&(W<RCc52fmy3>Q_`z-f~w;Lvk
zK>4{q984(H<MlLYKe!d2%L+E@;;18&;6J2;lfnh(w7AiijyB`xp|TLo9ZUIkWCvKQ
zTP|{Uy-o}hI~wZ9Mq>vn3L?tsTx+GjCL`m^1oyYe0IDDvke9yfmPPe&cjcsr(bUQ$
zbkovD@%=(i-(^RZCtzNL)3l=JEEB-+uAT@-*uLYk>!6mbdcvkgyjp0xWOF$*2hOi0
zBStrzy-`|VP-`&_$MPh5M9W}|2j=*6z*|1&nP1`Ci2w&oS&!RpKBEI#ys;+-SjXyZ
z?qF^d&?v<6+@Ej-TwXs-D%-wn-kdr2kEmD{o>_V9dxq<$q;4)Ve5{9F|K}gADPvPG
zOWIx-HRy}(jY;G#UF~r6=xk*)F<O&(_G~=IEbYyY3&6L4Z^QnBs>HN`ii@nx0K)-9
zJ*?yFILI2whEssrfsmin^1e7%aZW@D!a=Bca&f5t(D)X;(H8-<i0g2QY2u{ZXMU8>
z%`p9`;Ba66-s;3aKPKu$vq%*utHp{@gN-;=k*YLCVIqL8#OrO_ZtIWubh2!o*hYZR
z7m)H@+&AC;M$dF&^`AgU#lE&1$B(r%(3F+&B1<EPtVih&hdNW%GWHDky3lLp%zn0$
zEttq^wDFK5ca;hC%%yKPfBd)@?quA`1t3P~pv5E8ENM`~5X*rl47g&v1#1AeAjg)$
zYy#NCJVY<|o1}57E02pO`t|_Aq}UbuzO0k!VNLo^3Jx*15V*E;83&1_i>(o5S0Mxo
z0m6|o;O^ZW=l`YnTgupAAMaR-IFt8>o?t~%*m%DGFvR!lFkll)`^+V;zvsUMa=FYt
z3xN)3x-1w=LR$!yF_LCF?ZqYZf?tKVSpH$=|J=K{;Pz=Rw~sQIn7Oz!*moGbBFUrO
z-RByrO343%u+bn8WiN}48coDvXCN8I0!%MCIgHw?l4Ve-rL!J8QwhpDphI(=+s3ON
z%oZ>2DQ7xj+_Vo!y$*n{68|rA;&uAo<yfggPYB>omX^UI3Wl`^PK~v$85-X9?o(4!
za|t_caPMHs0O3kWRx@LlSdHn;6Oe`owj>OMQ@8~>a}<JJgI3^p;o99h>)bguXzZKU
zYz5jB{3gdmZ`s;MYxGGI*K=;Bduk@Rx!HHJ?u^H^8ps~MC|<Zb=4V+IMPDpdu?$Uy
zpxtOKze6%9QL*Z`KLC>`pCkT0E$AKU&HCkIgZ)8dUb_EbL^G5hwB}}Y|7gXpa5zL5
znLAENJk9r^tLWvs128`~H~7{3TZk%v8dDCx-?@es0bE4%@0{wC%$Q^1jw&<g*f+ex
zMHj9}j043l2Mql{?fY??Y1G(BupTU=lHYm>cw|Rrfd1?goxW}VYYtY}v={pBZOsd`
zY-WtRKOnyvtd><`YX1#7*9V=)E08P7KQ#B-w|omQhia{Q%%p|=nWg=E_wLvsIy$=O
z!u)yjj%<rAymkoZT^tD*Rs^#pwU;j(!0YB8SiGuP*758fk+D`tt-?6ceASZ_cv^uN
zJU!n}TFzoZO_J3A%mHN{v;<%4goLe{#tQTpl%yJJYHG6E23HsYIbiOSE;on5Hp-tR
zenh^I{Y{eg8DW#D*aa*G8M5M|u1cWT)0Q*<06~Ewb`sJ^kw|VOId%{QlHfJcz0_)U
z-mAb7ks1zO@mQ_%-gZ_QQ7|&xM}{FR?i!|d5pz^oQ$ia5myyJ4n>$`~RUZwC2nfo0
z><F$^msHaotc#vQE^N-MJKkL5{0G`5Vweb!Ct`6b;?%jbwt=QH-~ym8-UZv*ytLsg
zp}KwtXme)w$Ekng%CV>1G(zK8<52U!pRJhN$7f{BvfEPNBLqWy#UkvdskJ=ggg&gO
zb^(&zPrvIGJ_#0&YHsVndkj@Dn*Z(YY-b7r8sW>tR&<34$6UwHO&}<X=>x}51|LBi
z&)@sT)(+u1I9^gCL2F3>RJg<pG4)_aBSt+Er&ySwLLwlp2kS}StvG?0!H=#VcXQ<O
z<>zvj*DTI-vvVbOp%9b0ju#}l`q~S>nd)%XMueMB{>MUN|IO?zMb9cR56>kONW1Ym
zYovw@=yTBJWQSZFih4nevXCqV)-5rP-amXpCAI#$k00|6SckLDG*8(kd#))Bk+deV
z8_G(5Oze!A3QS-s#NABNRMxsw{h?SSO5WZ`!R%jzownSsPGo_klO-I;=L@U(f2qH#
z&eIJ^;Y@IQ7D#_CQf_p6Rpna=O=w9Jw>qjBY6gUUEZ%ASF=OV}0CVx5B*c`%C~@$4
z+v}Jv<9NvOQ;W%yqqPQ|I(bqI6P*o=68v~8$YW%Ii+<$cE32NA%DrHyo2rf5PdX&y
ziGC84aqq*&l=EV%#%Ch*xLo^`iB+Beu_EXoRxd>4c=OFM4|YL<&`zfaM;`5Up|l-u
z51nnF)X(n)CEztxDR-dMkwv^R)JiBp#D{v_hy>Wr`?lX)FEmuDct<ccv3+juDJ|#N
z4%~~`{Cc%^wy(GR9!fVR>KZ(2w-CLivEkW2Z~<jq=VjL%==Qnx|MmP;@naOK$`vei
zw*Q(<XD`sct83s6b;sgf6ud?aZc0c2G6V}QRc#%$Z1frbf$wH_@bvapmDs>NM-Tvh
z;kRXm^{t)nhLA-@X`CTqU9JeaTw!6L8Tt0$oflQJrt`!33s8a*{{eKEOkP6{0uRjo
zI@8QI)~R39K5WK0Y8Y_WK`C!wh@iQD0=XrA_0M=@2ZZrCy0nW54z`?qe)XUBa5cF+
zz{s6DmEnwJ;*a})h1ZUhqJ!R+ybhUeMfsQbCTEo%L7QkVW`DSpH0A+P6O3Owu1h{D
zyfuv5Ad*oQCHL$h9wq|wjrRC&F^iyXBiy?r5+;RM?Bz8ocD{YT{(v)});$-NTi_Gs
z3SM9qVBUdyPGf$BjFN0nyrLJ2dPGGJyqogZGBEf+Lkrad_MJ}MR}j+^L8z!c8;#sN
zG~lZ`bUdeiLTz~rcxF6ONt~fh#tg9ixhXt6wbSNnXF~k^{nHlNUS;qH9AhI*P8XM|
z#w2o-A-SL@Qiw|1^U2kL3E0QktGX_&Fr)cW0B7%1x;Gmg3{5~<=?Yc=hJj$KkXhNX
zoy)Yt%WmTyU06B6H2F|xeeG}_6+P)yuhTT$@B3B`)Vm9iCpKoBpPG{7I}?r#WmBMd
zfl*bzeAp=F=HICrNP7RhLs|8C@1q#o!Hky9p48MD5s~ah1j89y-Sz8Y#dkz<j%@1A
zdj(T_$Sn%9vOIL&SO7+^=s6o5MbL_s0bBu{dg_FFr;zE{Rd2iS;ycVIQ8)6#wa3eL
zjIJTyvF+nm%c7s0;s1e9=wm3WiAFN(T0XYxL{L{s%t+^!b!XF`)cB;J+S%?mivsW4
zL|t``=2p!S^zj21@WANZhemgD>)>VRi1=PEJ6Falm`!lzuw<f{Bn(+lk`bo&*gwAY
zf3*O@*v6-(PCgiAy2G~cb<y?fA!L0g<8`sI?I<gcetgZeY(Chmz^j6gE;hSBtPT&S
zoPB@SW&_8e?BT7IkTE<aheKO6-tPv<wpD4#X21lO01u7oa4}iNA7GrjLu}+I1F4S$
zy6rvd28zUZpc5Gd%l`HG!T2G^N6IR1fU-VlFnwVwMd$f5*2(zDy~h{k)EaFm*xp7L
z+G)bvm)>aKsCNTC5886TKmKrR)~j)!KBfG5qLA<ND9omKE}MTAY=+?4THraj{TBQ2
zMpZ0%8=c*0rNg1Lw5E)~3xsI$XvQ-~ffIM{=0=}=TzY%Xpbj?n_6F7^DVoN<uWzzM
z);96SAD;VD2KBvCzXG_fDSB2<fyR53M$~Rs%Wc@>hRk7WdmeMlptKFnvt8T%VFz#$
z5@TZRd*i*vLjGrD^hXW`+67#<w}rI894XPJp`J_5j2XYy$v6*ecOkwg7;YxmgkHDR
zusU_>lq_Bqf%bp_6I=Ty$1qzj9`iB*2-<`OAj$zW2#o)@&x3w|ZWHAylV)Tg2hOb!
z1<8><pUMHVWZ^Q>O8=bgLJ1rgKkOq-vq;+0$44lMg&F-D#*Znd!>b9b=+(pu5Sy8_
zh3%O$pt}$N3*b@k94-ZD=~b&!0K*5+87*Y`AYT*3vM{D?TYbV57YI@8F_T>F0`*WN
zN_7L;ClmUKTim=(l`&Hk8LjFIE8FPt<Hzvm!8{>C(#t4|fhYlFtQ3uj)`;J4|NL%-
zS7vjl^f{}Jfs2B>?KtVftM%9nM%#IF#u5l@!8wSo)FGH=9=h@^w9OHh1(}Bu5)eQH
z#bnfuo-nE5X+Ehphw<RN$<#c|I}|49dM+Gww@sc$?;h(8%$zgl?!MSqVLRZO_+fID
zsdvFf`RFM<TTkqFeas&9f*7<2vJz#F?F<qKnUy_jY<$qO_2}Lpf0xX+q<@_&rshI{
z{Q3RMmw`Z+T^}Za#YsEItFOSNiKH#i2n{mk38!_wB&CV0ost*R@TYW{vUP#7Osa9Y
z^~rH?TyIuBzIE%k>wTlh_QpTX8zz`Imo&33U>e=AGM&#$jJs;GcI%M2%?Ho$=*{W^
z-#^vdqnwI`6e5LZ-UOJ({miQR@Qr+gnE2?<&2s?Lkq9zUf4QV2O3NbkTHLj>3&yb>
z3J~eqXkJ^@bWe5DSceTD?VR{q5VmYok8B(Iob{ZmR{c75G|^D(4+!SxhTRhrV%x;K
z%9DOzc^t>e>HG;;u&hBcTn^lad?T2NE-`Uz*t}Cb{b)&i`;9mKcsk<A2CiiC=IjwY
zu(ljYX>!n^KLM@oLNK-wZ38+aWGw*~*7`<8I7?p*Lnd7zk^t>R@dFsjrfGng%DCEn
zkC@6zi_Hv>I9$5yx>G~&{o7X4*HKY41G5qE3-Cl*Kln&7v2gio|21sCC-bASqS#o=
zDs1PalbT`OWb%hrKXT8W<kKqzgkb`*v72eel-C_*gtW5krq{lC%PS4f8K7~-HG>vg
z7LFP2Dv3m>A~JG>2BOl$9sS^u3H>zI?B)XLMvfx%qA8kiu5kr|8^6kvkTig&RXfpQ
z2^LS!FP5f#k3L|*C}7ou<!u@^+ITMrbt`o4SvOOtH*uJvKpPuuY`&_Q8q1|gC=|XS
z<GSpyyRT<;3qZNo?8!ua>N&sUxRd(cRGHBMBU@7^^Pab@9Tr+uyjOWW1BqLQzJC3h
z_1f{3Cf;qS^oR$pqqB8y??)w4X1inSV5|*B6`s=ba;T>hp$vv|dT!}v`#QvCA-r0S
ztE`AQG_<y+MvRwnrb+YP0|SFJT+Du{PKRe_)1}J1=l2`&P7TR>T#~shf@`EK2mK|+
z^e<c4h*2f*R55mth2C69nhpRNv`xqFCbr$NbEkg){u!>hNk`%fDi-2fqPNRnRMH)`
zq>c`p(AD<W=`&{z1*^KY<_=b!5OW-adzcO(GlRDteP-D%pV4Xowh{eN`th+LwsHBl
z7s~1W+2+SO*UrDAsk^x>^n-3?&&c04qaFm9dpLX_hh@2l?Kf>2Rk3}Uy+MGON_igc
z^>)|zapQs*+3(nKxWi9__H3u{n}YDb`L}_RQzfd*PqS2BpBazN4tb%><BQ(|a4s0F
zzJX>#D6Mh~QsH_c$Ic!27QvRc?BrzXC=}jVI99YZk`P(uMc)>r{o;vJpSBVY5nk0{
z6ydV#_B@&C3jA3&@-Mcz>PsvfQs4hW(|N%4ytjS)Zzm)vBSJ<}Rw<)MT8L;<b`hoQ
z?9o)BjASIEC@L8(BwLb|6*5AZWv@c?yf5c|?$<f@ImbDw|L^x5*Y#PKcq2jJ%vp3y
zGcR7csE@DGW}R?aU^%d1n$+nV)7Dw1#DQ)|<^p}rCC()Qq&C_n$^pl`AQ>6)51ij;
zv!4nQ(G)P^1#UWl{AK&JBJ>>@GiI5T@_%!Bb)6e)hx5W+XLg|}9p!k>`64hEXmirt
z=B7B|MfpSD;{4DsaCFN<RF394QL95k1x6E%G7yzw&xDf;_l@^JH<hIE;L)QC5K_tC
zjmAhDAma|v&oF*()0Nq^U*U)TPrj)gZSxc_334CKW5a28$vfj5K6QQ?-A#C&hos)I
z=#^)`VwcnlEuRsYJ_bv|_S#mLcVlyx5K~q=8q9(=7l`*@p31>{zjkgzuQ2Xg=x>hJ
z0dv1`m6E|S2&1rseks7MzyvIf=iWuxR*;ogeOrCB#i#Dwx;bnsb(<7kt3^c5K|cQ`
z^@RBrk5Xy_&L(48cJAC6_m~~_$-2%QXrGF>7emP(+&HZFq7UPx=R#+b_Qf<f;q6WL
zy0<t*CZo=ii<n~*9pQ@&F&2fS=eAofek_?xD5-86do&Srb+Z}gce-j?=CtN5Q9yu&
z&LKU7u79$q!H!H0jL2S>U;x!~Kxe6IjG4x%p8Cz|?5;nH2rkP>lXgF@(N`m_?ItfG
zbw+BNcEx9|K2&ppV-Pb&nQLuA@_afjELz}9;e{3obnn!VWARCc>H_~x&DSoC+gE-<
zX=B}occV`1=x7nYA@{WP$n^Wifd2Hl2D@s#7|r7OoFy7q%7U(s@)w~S<Cla`VoKJ?
zf@<~eIuy>7;ixIjq>S)xA;IJ1sh`6lDa1c#xE|z{gt3U9S*+FEx^_La+`PwB`Y%|3
z$GyI|Zo~t@s^6S7BL>G`xb#Mh%;Q`2=sCp^K3SxPRQ?8JX%IJZ%;euRCEDyfS||y+
zmTyZV=IZZueKiv`rf_U=UCzq9+v^`T@+xdt=M-a?k;T6^f)#Pyc;fuB9j6nBu%Otd
zokF5mX@Q<m-a%&%BVrmUV7IN~8N9=VD)hKQBy*sL9rGOA0yDcscAPm(APunvQrZ!$
zY##h1q)H8NNCDW++KoO;v~?#2ql|1FiDiQ~G;@6Yxt<jWw*-!0+sowR3)BYZD)w`N
zjK#V~Ud=@6!Q;adn`oeGrQ-qTg8iaWwW6UC56-S#DwM=mR<h<G$m?&t8alT7C3qDf
zW<-V$^1?=*=UtH2gaZv4c*GRtwmYutL|<I<maePFF>l)J$<2FIXlZFx3{tY#h$3vU
znzubvJg?uksHfT*$kimH0wM8f)=(BPupL~-u1Z|L1Ojh=<4wFTdWREz)6xxt2wM;S
zSi^K$CCy0J{e?jf!rG%06|n_6;x?ItA4ZJ!_{*n7cyUpuQ`oB)FP;&^EOCUu>tOf+
zuu5epuPzZGB;qoctz&zISWHQ~y}#qpk^d<JUsU$JHS4%f`E)zSVgS(IcugpOIA_!I
zo{aG>xNCHIU*7=^9aNp0H?NiF_jtwf<tbY2FONb)VD~{MC0%uG9xoLzOyW(7FYR1B
zs`GNS!k^1mW|g(_=-ov7a_o*Bd#UhV%<uR;dRQI5H-+g8@I#g`@3l78r-A(nz<x->
zA8>|?o>*IA<?FGN>6K)B8PbT3g~N5rqu^(kFV8*S_p{agy;LTpqzgMe(3X$`3pc>G
z=bWf=W=Sjo_683|UXLZn_E+V{NrzQttE;Dj=D^3wkQ)~W#UPF@Pv(<iMvs4S)25WC
zDRz4n$s8enz<P5!hw2*t6*r+MnPeCN1qG&sSV;^NT|2);rq$b(*3TCB_B<S&sL=qQ
z%fQbls=0G~oW&&pxKC&0!Iz@Kz1wn{R%<-&z)ExI=BV@Ri(ZQE!2ZC7hdq0*9Hsj5
z^J4P6?A?0+h7jB19o#io&;$%^k`$`gu%<=&`{514w|q~3Uk=bJ1yS_-WoS3}FSNUE
zQDqc|_qa3cd^rvX1rp(1?6**FY7^LXaT<V_G*Dm~8Z2QCtUiab-{DWS1}#;GAh9G3
z3F_}|LUg6BuDc%f0xPFM-&v2t@xhAqpVKHZebzs>d#e54&a-l%r{=9>(4eH9QPLr_
zlB=}aD#_1+-3zYY#DeyGV(#Kw9it01l@l~(xzP5=z(j<AC*D#AvjICNlHu(nUji5j
zx$2BNNlg@c($gJ#`mNnCkh5I&&1Tp4cqp(@@yEPPxa_;o;%h|gLNl;$Il^~yoy91*
zu5?*iaJoeOaLgcv8$6sz=}EmM&g->#Q}JlS<WssKXs(0l^O9anP=bpgHx0KUFtO7#
zW6(>n7SXZGTro-j?!a5AV|t0!OF~?;KD4q6MEWGq*^gTnJv$DFQ@vib{Pg2x4c9y+
zSA%lmP01-!u<ywp9%Mq#m##WF=zBcHg7mm74#`oH2#cAH!86^P(@f1v-f1;&vEA@p
z7oES4$3x)qsHTE>xB2<|AI?lq-ksLv?MBrjGe`XBybA(!%!rXOoEK!wWMvscwG_Ng
zpXX<pv|KNNj0O5s#v8G_0R1`ISa5Q{UB0Z?dbP{?t}K$_#dqj01&%KqtyF7se--pL
z4}7!Zlr*)p>~u_;tJN^tL`*`cQ|;5~<gJ4Nkean_y@p3o%26nmP51&~Kv;RA^XReg
zY=clAk?7KO!u_U!*AE0kIp1_}bpS#Z?iyRv{fp5SkfQDG`}lY>2wWM6s6KJ%EIr-t
zJrj8;v@H!OhOk;6vsUutt#K)d!v%NSXq>|bayln^`uIc;%OR-)5cpQ0H>qt35Uh~J
z?ZxRl8GjX*%SBpB_b0DEC4%_;PtrYdZPhYvfjxVwmZ}#t2BFKEC<*j<=eOSWp@ABx
zGjiL_XDzkKcjvl$X0mg$nqQn;)0H{SdZcGrKu$k~>s$>E82x1it}$4T^+-$OsiBIJ
z9@c%FME`LKC&%1pXKP`DPc6=Fxo-XX!}ImVQB<+qKQZUdgWbwz8d_(}&>=(OyR!<#
zEeJd;xtg0VQ~Si|gl~z7VMcg2-wX`H%z;qZILzusuO0RSnBsTB^^*{6hYrn(tk46L
z<aU=`L>iUTyf-cF@2ii7DoRM`2)4%`ENDl?f4t9k_rcmmDXFPkS;3pz1djfF52H`G
zRf11KC++!{BjSwzbk?DDZP91)SiKk#LbAW6{$BbYB6OvTZ-LI7X3anUq^oKH+o@Ng
zrW~=QfNKV+VG{{3WWPq{e8B6DsW5zGLs3t0mg95?5<?FMfa976I%;d^Gz3X7+uf96
zt>@NM`?^f9h+cLWubQw=%m$)k0LJ~tJ))i0S=D#n!Jptkk|Y3nDAWa@nWpcAw9uS=
zOY~yPW8WZWX@CL6$1vgDRA1l6KJ`t(prsYEDb6ULIk4T~hu>>a|DGsx>bv5YPeP8~
z;Bgi@)7cmqLXOQ-(+#^I_tt>H!RG>C|K<L{hXi3TnJk=rjeY$5p7`XH8X3`Ohm-vO
zpCu{`y<11BY^W9{d4u$X0Mwx2tdAaBK+<vLve>HBrmo*R`|<Hwd}auJiN%)*m%DdQ
zidG5UGoxf6G!njKx;-cVZg!d-_e|qokInYoPOtJA;#-ng*t{}T!s~i$V)-VswYLjJ
z(k7Bnww2tF2yd=TwBCCMF@<ca!PTGYNU{WMmdn<C3rzgWLqMfv5QX^tVJO{SUXJ39
zmwsoPk+&dLbKv%U_C1*{|Hv4(Km>ejr2{!_|5bK6!zQR%#T0o+UK%h&|K(Lj9Jh>V
z4%=}-V0Q|S!|qXRUJ(#_dnfn)y!q<Oj#OppL%Fg7{>SoBD(bxMgArdh3Rm#aTTVJD
z9o5!A7g-6UC3;PEg^TOe`)V2*E<HY5wt#}+x}MjLDoUCi<`kfhE2`U0=>2-T3-eis
zM@SNa4!GJy7ncY8|Ggz{R`W7D3P14-P~gQL<&FcwRn7lYSHIZB!@vLgm4SAcPS>t-
zH>WwOr0I<T7{OhI+>5_SkDN|RT%2?&Gt;?Sw_O}Q=xfA(*%d-4+1XZk7qmQeswHnc
z>rV(CaqgaOYt#~G)9PV1f2p?LJ@uMHbNDH2=4mNcdHn}CH1xLgniPc@;Ox_<XU^U4
zx^bAOQsqO-?ZWU}z7WdsPhy9lsd>Zc8vOX0&X2+A7H)p)r)gW6l`box<Rn$P^O>*H
z&eXW<9L1AE0To0JM@x$A3kYGICptOBXJ&35D3qpCRYuZ%UY&YRC*s*fOlLNUX;5MT
zoi{J#2Y&NGCqfGE1zB}W-V&wvJGb2PKYDpyK+ixTmIee6saKcAOy)n+5y-4R;IJ>1
zR*tzT-SC4TA8ufDl$?etWbYlD4`DRU<w{}ynaqtZn!?4LoLKPzT-g&cqeSy#%f3b=
zJg5(8*xHEkA}~2Jp%vPTb!-5ef(Y~6ojVzMjo&0trMJVn{v6pCS5SQl*9O2b2*xKP
zI)M>MX|b9h3wzl%XrN{`oA5)kHZUwMEs<i$<XdQ&{pFk7jVM}VaGy+G<N1`r2VTDv
z?Xw{@Z|1#&=cv<q1DWv_&RDN&A%S$e(5+I<i4+k$D5d9coQ+k_X#9nSp%(bte%WiS
z7I|4`J}+7{rRA2AWpiCrkJKs;)!h;vbKpTE52K0Wx(~M>viH8`UW18t>(&fPI5Bx`
z6KCgjHuX-9nXhpqQ0ewEx5;h`3qLkp)u%XdjZ*iQ%XhsVNRi*?wP~M|^Sxf@zW(FE
z)Asw)(Ufx@hf5>5-w1n~gOLTxxn<E5<8k5~<49(D@EI4AcaFO1%89djS1v1R*v+ST
zxSGX=n3#G5?bTl+v?P%O2s_6F`ySR2V=hIhT-1^7P0Q*!?HrMu@H@`q1T8cw&^1{1
z7rI%$K5-?{;Ld$CpHe!5Xb3mHxBcNuRvkB@fZ1ht|Ef|xSUDU07KaT0hztfI22GaL
zm)(NJ*W2i%yLl19%0T!OTyZN8^nGvi>7H>{L^28hf+z&tcXj_R|M70SV}m~Pn`9q3
z5&(A1p>u9xaO<u&FQE{p<O$OVGch&oXFJI5+)1llBi$$1*q__yz124Hdy6H8_m^>X
zaDfDxD`2iE!N?s8&M!OK?NJxChSV1zulqW`L0^5aQIFk)VQ@C6M8u{sQDgs-f$e~t
z#5%<pCy)~dnw;rk_s7YvkWgWip;M+$Z$J`IwyFg{<fA0h_4NB1VUD`jRg;~SNo?hU
z@?gqKr0ZxV?O@{!lDdfAPsWb$739_vnHXT7_`mLFL%mjXt{ORfxWli(^_}gyTyLzL
z+`TIE=+Qtfa?7?6HeErqfOc)@f#}&pLGKcF_u1Y1d3`|Ixp#_YWtemwjn@;cd6rGr
z!fX@8zP@v(`+tNANj?6q_U!d164vH`+WGqViKVwy>(<={tm_kW^VK)gsgA{C7F~B(
z&PD6wzJ9Jj7I+H`0o1_diL<xW^1izw{WB>_XZik;5Dyk7_c`#_^o+)c(ZqxS@@zo+
zgN3oBP#IqR_u1>(MUB+CfMEd`%?*A*n~^Z=oL2qkbRZ9HExBtq7Y5&cfn=$aU4(Zr
zHO10<3;!rLk(~FeM;V07=S(4bC7%{RyT#hiS9_hA%$?W6wrR0$jZVGVwfJI<xKahf
z1N87-=Mx);fjof{P>h9$=iL(*-^LF~q_T`2Kl^-+DC=5$51pkeSD#=-pa&vDhLpMI
z;S}Gu@Bd;J!3)Ax{i&Fw=dZihUROP$e6mTml;%ZubyR_gfQkK78#q`fMYSKSvT9Y0
z&8byLwapQgA+NqO!~br*K=ZT8>r#T}9!`BXc@e_Sfy6NZ&?+Dmrc9l>?}h7rUH5V>
zwNoZGs4+vQTv$DXZG_~E`t8@AKQ6{BJ?{NrUWI;b5kv~GVYd5l`6pd<+d)#pa%M^H
zma4_(wwC%%NbIGO;sZI)`*|C?A50`~dkRAjMN<p3haOr&fwHo)Y!5Y~qY(9>FqHIu
zDb<?ecbx4*lm(7@Y<5Gr>bN27$#$fT8J2i^>B(O6|6POJgi3X53n>aR0Ap4=(0up{
zH@-Rl9gv}GTtWY(K)cvsM2vxuO*9r!QKPafM%&D>cl%as|2Bes2pc8AmXvFx?=%yg
zE|h}|X+flV^eSVi^w$i14|Rf<>c@(4EjDnJ6^X;bwbh*sex9h-WL|-m7PyWQ6Jtdo
ziWW%pZg63Q-ny4%ROf`7wXQsM#rvd&wYW$Ks5pG@xsyv}ok$tai$hl;Cj|_oTc001
zt)4gaL_<FG1JU}>$R;j9rk6YLN7g*$xeCz(%=<Jo&O{F1yeApysnh+6UEKR*HS|jz
z@p2cLu@F5z9}D%@rrC`giA}~n^?3GxoQHIJ9kEFP_KDGN=|A}j>7x-iU(ic+0AJ!?
z**>+zsl_3H-s;?cSuEoJuIN3RfEv2P@?XhhCK#q154x0>CqV%nRL??efcILXN)}(O
zm>!nhtQ~3*Z&Vjem-w0hy2WA4(M_Sh{7XSsfx9XEhW`HBP46WlGm);NAaT~R&5$7y
z;KPf*yl5y8I(cZxCi`5k0;MzUy5snq1r4E{FD`nz;(m8SrQBYTeIKLr6)&(v%;DH~
zE@^#BRmT57n2Pk1?6kGqp(!T&Y^HF?iO~QczA49X^|w2t{Tw^{Or9LTtMg^58$8!V
zgrA>LbN3yaKWe52+q>$+$&aFN!rqW#(iZR_{(!>EdD%;qKF`w3Gj#&BqjgScx3!{h
z4g?kTyuELD``omLVwN@g`6Ak8QMW(#SS}g(Jkc+u<%#i8Adar%H*MY=f}V-xBEyov
zuWdgp5|az3Y-D5;{Sc3f_Oe5ORdObQw;F(-)~6eio*snBXVZ#VBje)YQ1MJ~2^(VC
zWb^X>*8;@bYX;yg@}SnD`0ags{H(O|_Vu@qMB@-dVRz)d*|>3!yt=KX#{Jii@%o9U
zGJ5c}RbJE|7~*@@F>kNYYI@z-%Y0rb(=^=f<>y7u{UokkD(4*u6Li(d#!ij6oB=L|
z?Ay2e2P+gxKcn_&>*<A8ZcG4jDN6Dg(;YpIUdu|h=)w&a{%pw3Iy&hu*;{g8@D~}p
z`r~vX1%%Azi+e{NWol()q+Le!EbiqkSCOy%i+(5Y>C()x6PEm~9w2&2xxG*%9_)}Q
zvV*~^%*1Ak^OQSs;mz^zr&*<iBqixp)>>EAu9IHs@NeETXFhuMxGnR7KLH`h#51B$
zFJUEVleX7YC%S0F-Q=-8^F9d!wrkhK7!UAFs?LRThT2&aW-lyh4Q5mP^&D!xT$2;a
zuS_*e^rLKcnfr}7x9GL&{D#m~<&)Z8HGW+Sz_c!jm_^Ey^w&;)n!9B0g4xQ>r+#2&
zoise)P*rQ|@1j8Fqrsg!%&R}GesjY^d%*Vc`L$$y-B1f}R|?u^+#r%Xz>OvPGt`EX
zO2VdSzx>Roc%#mw+7S6QH1&<A&oC(lNu!WV5zcG$K`AQ9E}M4ljD$WFE3PoqC^?0M
zb_sKtt@(X7?f%TUFRy4Y<)I#pq3h4!Z>!I;g~ZZC^(a^hRIO`~wy`qth3EO=5)CSP
zUgR)-^D?z*L2=~Z6+|oUyqM@UZVq~ZwJDY}U11YdXrRwi4JVs#wurZXsC%u>s5MrO
zFEeP~H0$j_EvL}5>F|qS&kXO=ZPs#=izctfMBU3T=RyB9A#u{@&iy*GhqkBvkr96!
z$X@mKiQ|WcP$s10jHQqg=Qkcl?nlY{q7M2@8jB3A8{e}fkayboz%#rtm+Hg(2pvOI
zWjG8fx8U(T8-!g*zU?-l4INTd>DpeJ2Irf0h4G~ZvH_12CRRnuM0dr+=*!Vd7zZyy
zf0Y|G;=XrlSy(w>RO5BQ`^`H{uD6T7ZrRde$Ds*8<9ts%OsH(EImaqWw{vJ?XHl3l
zYW$=htczaM_?WylMJE=vZq+KY{B9YXEJ@tSpC=x`R|@AYreghe9M)D`+7wmAMqAI0
zTQuIQcX)!X``okPNl9K#@7+&<{tltY77pJfjN`Sn;r7OC_WA){Umu%LwIb5XW6B1m
zlxvml$N18ux1ZxYn~Sb}AdoBsy=2$}!%-IF!w3LY5$q6MRvvhCOnn{p>OGf22HbHN
zNs5%IAExF}JCKHd`*2KCsz>HOs)_K5!=7eQg|I`PtzANnR5t&pUp_UWG{D*#Pz~`q
zldTVT{)UOOD8fu*EfOY-i;woTu5al#YL{^g7c>j1Bf%dJhYXHsP=eSm0hwHuO0IXq
z4_olPv55qt$Abu4N2?HuahM9fL#Ix`E4V?E793X2J++l&vp{BfEsLB>UXc9FsVQ-0
zoa{UPe4dfY73!+^g>g<gFdA~P(<;o-<8i#PTpNjfoz?)eYh-p;niDssYesSycA&lm
zJ0Hr$47?)LE(%^?l4EXL=i7d@0dc}Rf)r;XMWSompk*z1>@uow)UJUIxgaSL%XNG8
z%4bm@^}4Ppaht4lsTs#rPd;Z8Ig#~3;9wgu=d@}S-hO3Oyg}+rLjc}?lQH=#TQ-PV
zImOaPU8EKO7oNZnz`<3Fe}8x|v<f}!r>8Z4TS9T!upR_XWYotVyTKz<V9)0FCWtnd
zS;LgyPX7JXxw5=HXt}m*-Fm;jg&EiUz;+*l?{sTsF$Z(%@*l<1+h^`vBtyytE~j_*
zy}LBF&N|PbFmNe<#&fWA>0&+H{FlrZWR-B+T7p2~TD;ctFheQ%$N(_XPh&86ho#H-
zKT@RV;1l(!hOH?@dJ|~09B29636U1wQ$R2zMv(}We;Rw%-g7De$q4KaUBGdt9bMp~
zZs~gelCg2b&R;B9-(LmjAEacZQ?IREm!(<tX7Bp3Eejw1NY!Z-*tJtBV^?HgA}fzS
z_z{3BL>J4mAJTKHCFLJD$?#_d3%2Mh59;4`l*VVB=%`aY6AH6``IcHXQx3&weCYFl
zEx;S|=B3|OG<)@jx?Msf&>t@Rc}1n{n$ev@<Hn9XkU8Ng>;h%A%s!WVEJU&PZr#;w
zJ(*+`E+mZv7m*|+ltlNsk_8j3V;97D1L+N(r8SziaAEeQn-SY3<`s$|kWa>K#m|@N
zJ|q^4J`yRO0YN;eozHsI9V0ctkt2JG_mo6msePVR>B*5Ub`1P+1`IoAjf?X~w=*Jy
zgP%|DP2Xm3V11n9B5QY_yvvslxYbPZRW2F&tRSxGs}(jjs~uD3t&WX4F|2b?VBnCn
z*NI(}2DL`eo?<s`l2h#O@~Eu|SNGF_qVYZW;$3o;+sl#qn_orJJdpws({>2ZiUgbR
zUFl=@f+cf`ontqM#TKL=p<`CWxtr`Ie-a!ckj;!Il}`pxl7e^^zYVm6L@Z*c6UxDF
zzwY&2bhBjbj7Z*{+{04o9EgaV<DTd|NwgfD(LVRd?F|J}h1p;@43UH4AL)dK#BI9a
z;`W*oN*?0#7V(xmWt<!gf^2j0ijDv*LOw|{FMwjU`-rkB7gj$Piy2fFj<7I*@ngl!
zI<sV@KF#(m4w5fSEd~K)l$c-B$K#?BtfD6<2S`_N$_3I))oq(!=&yILvufJ#%fJS;
zI(6FH^n<-*jwAVmi$2iw;V3`$Uwyf&NSu3Wle)JH`HeS{lIjJ}mNrB3+LZ*AaPS5c
zhzVFh#n!}d7p}&!TXUe7#Dz^1jwuzkjGLadb#5g&15@(4j5O%iZ@Sh>XKfXawv_^r
z5CJk7hK{0l&xbGSwv8kPMfCU~4Vx=+SIk*SekHVEDWHn+p`l7cV6>=0%?_+g+H1yb
zN5y%tlLH#SijfzU^r5TJG4Ty+oftpywex!fod0<+d}9~3Tb~~>5FW;@-)J2>Q$=69
zlViJkO*qr4LE#nWt-FeFf4epq?G+p0AKMkySj%L=fzpAg!%%q3xy}3}{Du3HlBDn8
zgNXW^&${`cKja=~J~pXtiNjo$XJur}RG&MX6IV%FJQjG?V7r=1)w6r~mxk{z@6Xhf
z##FRakP^Pj5X6DbKiN0exy3{Sk5mrAj`Z}LT>?UF*t&I0+Tsl->N7Wu(*}C=Jh7LE
zvt-fHxt^Wa54ran^FUkmmMt0Y7TyDx6j_3EZ2rEPW8%h)9edei1=Vj+|5mHfj&oyx
zY6!%)z~5iy$^rB8v!5?6cJtl^1<u8Wsb~L!GdJ&<_R=UEK4nV$?aznfa!%zq7RPTI
za!V_w8vv!tt0HH2O^!1pRnzV~>f`-RV+8uI-?127yWmN1eaBc=!7hPAj&}PHi4e=f
z<NS^3Te!L6En-~*#`nyp_67C0s%+lc;DA-fTI=&Atwjvu;C~&Ea&u_eu=2;{da85g
zpQ51R*59BJVq<MBzGEl}bebUctuY$k?f7Vg?W0%F(!r2cpk^tS4g>h{gjVM92g`c>
z7g{$gO_{ER4eWu3LzKVlv7;PcuKVlwZaP^^O(uos?p1#WNN}<7`{_=czJUPtGOrf_
za~{>FyWd_D;*X?x11P*0P^%6m;(HyuCy(nmuw7GnH)%03W<GoMN+vCOV1-Iiv3tq+
zEu=z~nCm?9BKqogPC|;Etz1^>0BifQPqMSSr|k!hzWOH)_h0eLNc4^T_NFDS{;C$D
z{hJIH8R<H7gtboe^R>NBpQXC{bZ7KnaRt7cj!NjGdMs;%y5h*&$Y^BSbVF=H$=afo
z!_yYw7^V_-Auu_)o8%Ti^n+*0tAG4BH)30+wy8G%Tr2lahVIs@$fqJ8IjYOr*T@hc
z1FWen$|Rbx<exkeFFlSPe|IwqT1XTZkiv(vbnKQ1w$Z2&JMnyy_jIdWAM14bgtEeZ
z-sh>eGrs;@&MTChFW`*{ISV8RrQ+Fka8v5(v}b$!hV@Lk`=XU~-T=Rr6g?1R?(J{j
zUhTGKsKz8#QgLNt909DoqKKi}?*k#7shod|;55bLdZ~zILWz#>_4Q@8L;%guu_Z^<
z5?_9Sy%G%*wOGBd3l3^t%`G;s^!zviv912;lpAh`zx<9J|AR}`(b18XHVR)cH*Ch$
zu3frl)3+<28AX+e=DRr<h%_lX79ZM1A_mAfd|UPtcA*zP;>)9Vz@ON52ani0d~-uh
zQ1&O(UUzEf4k!S0S<~}&(Eq;6EHz|(K+9N>oW~t0sEeeG+SL>~EO>tK-4(Y-%k!21
zGKgq()|s4TJ$MdKFlW9_OiL_@9!>@L%<X4Z&XS1TE`Lw=NtkCHzn?OZ%hPR2*FL+O
zE$@5Le46doBpg;UNDqJ%FQPb@sH){aVc#nh;NJaBO+6X9QbjC~l#Ki%&A4UWEhqeh
zCx;IkHo0EBBqdN5K@8qPS0}?XF>1&lDrYU7P{-LQLd7=^DmJ_*{y-eAa}Sx(xHeBj
zAk;tm%Qv_;2~m}Dl3eTaHGeAy(}cC)=U7c1GM$xrtncwVaCUPTA|^l)o!cypS<R3Z
z3LpGGc4GYTIq^kF{Xe59lH^LPrX*XGa_v!4I{J^*yKvz`9ftY-b3YLaAsrxHU(K^`
z$9wD)ZyF8=3AKECpq><sp1JyY%k8vUfC@F)l=Pc>o)PGNM*YGlc!l+V!kDzz_e^3(
zv~LJ+<>q7SA8hmV_t~<~lfAuvjvDiWHpta})2>}NB95?RWIi1<`Ts*rD$97=5+=e1
z6Gn~$FKNfr+xCWcKB}#8Ug+Ub_m;#`aHWZm7Lu^~>+YJ6EnDs_Yu`vY^tKU%S{d8g
zoW=2Iz}PWV)D`ba3;HkqvUs4Be!A*Gg%Xj9N8yOdE~L{Ml~gWr<|AzYTa?H!ES-jm
z;AU!K@S=m_alUzUtQRHZ({7zX3-|5Zwb>@`>{$g-83NkP-A?Diedem)(Qeo<fmme*
z^3k!^4qZ6D(Y3{Ty_{%~k)YJ|IC?zdcaKiG!^uSFJP;v)M8RTrK|(#HtZifE#9D|n
z<=B!z4!CD5k>g!5DuJ<nmzgjlEyw6e%<IJc`}MQ@xmba#ZT;5Z*>KdG_NrepiFe{I
zw6Wn>)WF*)a{hKq08$AHrh7e0R;c)pkS}AX9sFSX$z-m#sr7cO``xKi$<*=3wimYk
z?Dewp+85&iLu${q{z^Y8LkA(Y*<{4&HTh2-BYA-bw>dd{E4b#QzT)(H#UXNy=%Ozm
zlu$_c3iDJTq^7L>Gs(%_{nw~lUK6Z#LuMJ5{O+b~s^2uF*%~Wjl}v{?oS);%0v^6v
zH&VxQg7;VET<+doczXIo{n7dngESs3s?WCl;eH_(>D7gQ*J`PLA3N`pNLxV2#td)5
zppmO3jTnn5P$NhGHb%R#iEpKi>j#&2p#M^qYqBXl<8jg)^_6)w*k3LVZNDM}^7uT6
zJ0X#G-^bqe5!Q_o`{DAXKgEtlbdaP%(s83jif0QlX!&0hiM$fX1sNO5l1`gg=l;~%
z4raU8L)GpDC*Ib7ZbyuTkM!PEk#RehTI<{UM=fd8hB6v5)y}Dl+8UY84rD0WfPcd2
z%8!T3k2tR;JRHzShBHXe1D$9U3NVQcbqPx{1PGIjBnL3}r=P}|xdJ!djr^r-)rX9q
z2SdKm%!3?xXKoA$Q9U^Bm<kNMC2g8!V$_yllz1X?k)fV+uso$m_uWvW50A}W&)I)J
zC(c>V8rdMG33M7!nVCkAm)e~=)j`sDa08yVCS+^aRxneT2=3g7IWltxhIBEMNtVB1
zl-;^#Q(0?L9uR$Ao6LjN0~G4YFM~H0Ooe>SBWTKH`o`(gs4~aC9%Z(>FlqYhc_(E0
z+7nZ3p*Z_#?C9`>Sfi^_Otx;vvgUM0y69W(lDA-Y%$;L>tl@qYG8aZ-M}#kCn&p8v
z(YF&A*}iyx^KOdlKVET{P+on;Pypmu#)w%fknD<2O>+I87!wqVIzRGJ=MZz9Xl>{y
zv4a8?hjGC%oi@PapnYr?iX0^s6&W7RadggX*`b0+)y2QtUjt3zCULoV8zuof52sov
z=MrrB=k=?qE#D3*%bAWQIxWD4FKuSlPC`1kFvJJNBY#Hwz$HZ43=RKp<)O)teaK)O
z-!}Ii;JE(>rp^cbPq!H5m4l~cr`PR8eS&U)it}%e%HITOR`7a)rKtS&ZS0V)oo)-r
z2zm18M<0*TuTCW>?s681qQ7SgGD`B$oRSzjSfP+K`d+825{8F5ac7ZqGG&4b7{1$n
z=T`$;sH@9pG>v(Nch-H%1{EUt)Az~`GO|cCJGjU7)*u&3T%sIl<{Z?X7;@a14-a|d
z7@E=e+FZv4i9JY`VKrsdF1+&9M{Pi#{FoDmr%hzt$JEz%X|ecrt&y7-QIAD&P3x{P
zZ%%6b|5`-yD|n_<oz!Grzu$2@kE{L|V-cTeCk|BhhjfQDQi};W!3QC84d5#qV}HP&
z)8qE=IEy7M=bdPKa?wX%kUkH6O|kYwBC&l=6o`l=8J1|R^{Gt&%L$UXy`We$d%YQW
zf&NOeBT`h-hR<;PjzmcV211frvFlH!X0~%%u~+J58R;&o3|K>gf*=}fkl?EFGl`*1
zs8MO@X|qyPMkGoMuqatkJ^ai2MxBpnEJ)0rmQD@DE(^CsGD5-96X6cRc27HB_L-Y7
zMI-#)77sHr?!d*{J695GFnPv|2QzBt5x?^cOErTU?72s~&>026G<IUxj&zFXxl+nE
zj0KmTGHsg6{$&Pv-?m5G7=G;=A5uJK(pK?BIk8xE#>!V)om+#Zi}m=Am?Zq3-Y{Ut
zj&YVB^+GL{j3zh`)mQ-ZLzf}Nzc*mOH!&-EanCJ!oU>()RcKh4Ow&Rz*jT0Az+nwu
zJGl1%M#WcSiFjt_cpLaYjtFX4G1}9p0q};Q<T^9|H$MQ|{H)+zp7|<rWKu@VygXr#
zeff1dmLvQkak1uaSGn4qKXzsL=e(9K7k9D2J{FyGb#x386Apl)q}V?&Iz^Kx`s%G$
z#ndR7E0QV&t1Bv2csiM^=blkl)q)EIc(M7~JpOCX{jK9C!$uP_@Zc>4N8js9saH*}
zhc}!lw?A~nq)F{r>!RcUV$uJ?B{#Lf)ZV3bm(rq}EdWBcKzqWj>fw5K3yDm$=Tqo1
zQ3;FT?)0zn)J0w^Q-{YDgwLf@9(%NFpX+g>Z7wG3-c7q6-@NLPgA2bMz4V|(*D^s?
z*uAJ|i@%<agAQ@A`BuEiTAgLgv2)Pe$>CXnl9~QmGw#5Y?jTBIJ+){DY=gJ3;brP7
zC$;`{r{yGAPkwr5)XXbko5+)*3M@q^E{KM}{V>u(REDSmgUe)inp^3T!84z~cu{xg
z(EJu}FO2}NXv~35JZs<o(UaJpU_!A%pW{O06$K*#^S_al*$`q{ur9nFDJJSMQl@fT
z^5o<ip$$9=5cwHbTbWD>=fn{rwsjvb33>ge8n&G27@ONb^2xzYBw|Kx965}VEoZ31
z&IGXiOX<2`dF!37{xSl9bOtyxd-N<rO)xgd%m#r<UBXCo_V*VaS)A0+d{zj2-5Nw>
zujaARt(>m;yG&0tksh#b{oRF!Zw<-p8+c&Nnt}#J%Sfz8u$JI((SSz{Sd~xF7#pMH
z7&CCmm%426U=V0z{ZA6K47WRH2?Y!O?(epJ<Z7HS9)NZ(j)TTDD0`!hRtdX-IA2}2
zc9kL%-U>ymsPDO~=AEcM_1LPSV&KCKGGj-&UIA{wC5}DpuA^={0W&n^*ci<P3s6xr
zY44u*idX$Q(;l{K7sYe#Yx-vE?Ob$E!CWmumQoFKRgvm(|LsI|1@Kpcc>AgwFG;5m
zyh8+Oyo-aazRBwcR#ehPAxXt-A-e;j=6|YlOzaM}FaMy~Ead=cWxB9CokG&)oReR^
zoeT*)`?OoGMuSPc??3<x()lAJHVJ&;!Mm1eIDplpCRSHB*NaIwa%97x58Mu1WK<dF
zxYF2fD+qXsr{+15kzq-dDbl{oCN!XVr!x9tOD1MGRbv6WE4|~5hg&?8w!d^Q@38Gk
zw+}O8553Q*{CWNE<`27m?!0RhK78&j)ZuFfm2BQpudKfNPSwqGeeXfKk$-{up)SG+
z29^m-GlO|ke|9<QZg!Q9N-Rvc;w8sPE(#!Jn9m2-vN)Od*VuLQ+a!h}nX?rf91J4w
zNIQLW!COZWVNk8*3lXJTU1td-YWD1>QM_A9eNkwMl8SE4MJv|UzF@*P@Ew`)`aJdU
zY4JD$a=0|J2`*z+2+ShahQd6x#hQ8j+lon_gHe9Bydik+A(SIU@yY6Z0Q96vtfdQ(
zDuS)QD>-%2x>48i3tSm8iGtJ6<7_~!6cxxDL@6QW9S&q?IO@gRdvjZcf`cb6y-%~X
zhMvrmh=A`UHh$s(0|A1y9wx1pBw(#;H%OCumb|FDrcb81H#Z*ef_Q)lJN-4^!)gfR
ziQho#P8ya~hfO$X{^h~ctM{BuXido?X(QYrr6^**Khdyl?(nnP!MQ0(%_N-%OZW*t
zgBbU?Gw0%lreU&#v*4J|n#CB|eWN^fTnbPPl6@lrPzD(j+?TegKcuZWSSI&Xs#Y8T
z-JU~-Wc&n=`z&oI5;#i&7jJS2fBIQn*-q)ny+`j*SWV`n70D>p^AZm&jU7^|%fN6*
z%4Vb#NeB&3&wt`zlFjMPbcveb_Tj4Bz)205ftC{a>{kDUC^;1+C0A3DlfhQgzXlwu
zT@JWT{~%Ue+wX7QzU4(V|BqTi0&B(6s<<h^cx0XH1<`=mxvJ7N7AV)-{`Q^~cKjFf
z2JHBii*STbPHZ^wBm*kW|Li%pYew$a?yIqH@(W<+9b#;szKu&!TAv@xx&c@O%s`cB
z#o;XZO3akByKpEz{#?!+!=O>Ga``{Z{jOETYRTOaS4``7mkX=QbZ6@ZF4jXIu^S~d
zwZeIz*Sg=`%AEDpl`)zrfYyIh+W+j|N9EW$)0FJ&h0V2kD8Kw8i7*V2akQ-x9n`WP
z>-;ZdFI?U8)BkG${?n^Tuv9mvB<Y+e#o&bM0PK8jCvf%!5x-Gh34kXkJ)pSu)~jw|
zHyMN@p^1K@oXq2$b$Ie3przD4SZ*J?8CZYhZZj>;35hI2(C?z<xYoMo)-tqHRR|R3
zB9;()l-O+t*ZeH3ymH{SrbBV>RC+O9RZAi*1L#ZG&-+vCH8(S<Cx9Fm_MHXf>FK|}
zW^zFs5SoB;i2$1mf`v#%88Ac9lw|dI`*4zDreLX+UWCk|Ak-ZmY-m5Psbz!zer^ic
z-kwdkx3+_T7?w(PgDU5##uQAI=y$q<QxyXVog;n)%i8#les@CvR@pSYY02O(jH`Z(
z)9gAb?kpJ*&!PTms$UQGOE23!yw73Ya2@TsTrZFY$dx1x09~4rrR9aDDWlmS0Bycu
zPub%{2!xuPv~h4A@$zdvz<TV?`9;4k-fdfUxGB0;v1QVGpvhPb%BBtFz_&9e9$J50
z^1IucsR6lT`!2}^B$E#q)pkG-hfG$1uZH@S-!LErqy7^=A$6d%IS<Gx>2e5P08j6A
zDD-)_bcYsdCf*WjzhBOsdE<OCu#g`mTtH&21;JfBaN^E8SL+=3yyWD6?h@*iDKln-
z^Nm@r|7(8IqMLW^!^GT1IO(a)N~1@co#UMyg}hsBQnyJ|LaL`{uIreg6XG0O(^97l
zDv3Ch9P`@cSlh3*N<$dlN>?q7CKr+?52TgR4Eqd?i3L*)Q9z_8j9FuKUfB>e?${~a
zJEc#%cnmDiSNR8owDdwA?yr{j?l|7-<T|G*c2G^0q~T}`=~HTF^Q^nt8Xxs#dWZJv
zhA>unc0#A&@kUKhUEo7rj6_82`OsvY0PiGb6L?iYlujEGpxE;lNxgmc=FR2Pvn!JN
zP@sR`6dQXbV#r?PTTILCxpgg<MMiKVf`H1J8W!%cckd*X1oBjwq~sEIyR(QO*g^k#
zc4ERY;Cv1KHS&=mzC39u5$_7+fl&nSd2JL0v$AVe?a+)#DH1;t8=attA@o`#J2*`1
z-^7LhRG?HdBwygX|MGgZjb#Yk1<-aOaj`#j?BBl?|KtjIw;!#b(4=CL6l#aGRzb!k
zp2#KaUT2vyLz@QhIJh_dLzgggT)LZe_UHu8uv1A8xa;c6_TN;=if#-G5NTLmfk280
z5P4MXn#&*c_&0`-_!x;<6ZxUnoz}1#!K&vM-ayOgN#GK%P?Z(`;90j-T>Nt|Q~Vgz
z>BgxQzZVAIv-EDOw|nqvBt{Zzc)fhlH!}m{{Hnp~=wAVZkDom0c|F!xD0m)?$S_69
zB$Ymg(RND&gU!SpO{5+2%qcK#cJ1mgx<f+tnQ?}f4jwM1Zan^oa}_fy{1&p@<tC9(
z_gfV{BmC~M?LILV%=J^XS*g83#^fQs69XY(2hBK0L^buPjLDp9AuJdOw_YR6FkzU@
z;|A656AHqAD2_zMMyPCC_i25zpS8r@M**hauI^dodaWHgd|DLYZ=u8<in*7jk1-3A
zGu(@3y(6HPlw%O$e2OX7E2%0KL@KO+bK<s<Td2aI+ifI{Zb##BmeO?ywTl77-~W4k
z|EE(QJ4!_&Au8nPL13OAGigOACY>VhHW9DWa^^cf`6*}C_?|;ouKa6iz3bYqYuOt2
z)AX+yOpP*_|E@{n#t-Iq;f6r4gv3~Gm4RFs+Nw%pkM2iFjF?H|==5<0%l6opg#Jh2
zO776WRe$4ph=PM+?vYvX!-wao!sXIs1_Gs6TP>~RHtje#n@g&?o}Myzq)gZ50TY!Y
z;=U=cGY>Mon<KAzGr5^^Vhe;1QnHlM0j8)V4i_`01aopZ%Vab1Nh0VV=0dcHftK$3
z0wt~RXgFi#m`9YIqH?%6{>!T4wD8t8HuXjIfMb05w_8I|GYt{6kM329W0)wCRHRSO
z16qKj$tMEPVBx#5vLWzF`W<aLxs5VcgwUgW87b5FIYp=>q63a!zLf*w`KFxy>p;`w
zhjxw`%~tUXh^?Doxc%V6s4CpziUY^YojY!P#-(?WTDm-Ir5_(a_84=e{XbaEj8wHy
zRaXze4JF=erN)h&{fFs=ss<q@mf!@m#d~Z|w<%ha)~$#1$->(|AYU}aa>|n3+hRSd
zBLjhTnAo_Mw#$NVM3KTQH*?A}{ugVsg+5(aJ@7d`WmszJ%;<Zg<1?KZzr5Bh!;28x
zEQh-B{_$y9#db%}_@!OHQc!RXEWxc-$?w}V2BO0f4b7D+=NV??=FnwN_u9_tziQdf
zJLRlC)^OB1#n{SAc&`ZHXK<M+ZOFkf2iGYzSLl~Gse2ekZByV+R6KiMGwjlmsAe;i
z>((Yc8R97T+K+91y*m!^a<dtDS*d@UHhJ?Exq}J;&J=q(N4Th;&@<WW+Vymg?%l1x
zBme%Y=q2hKY6V)9Ayg6ItbtI%*hr7K*Yfj!bg1b%U02$36jZpf-YuCHm6p)K3BW$6
zIOpKixL$c55t4e3O&QT}HzzC8HGeGi<Od_+8_gdfB%=7HWsoFE)=@-d0F`y@YU(I)
zt$>W47u7eZ6mWcU4?s#)y~`++=mW_mDmiAa>u;qO^Ka7Gz$Noi7d1ssotHlC>Jh>`
zrMaT<nbx4aW4R4Q=gQyj`yrldgkX!(8lu%y*42;gibOrVmf`bwl0>F*SYP5`l_)G|
zqEwTE^`}6ma!kl72KPGReMd(M9O*(ReM!wZ4?i;(B`2o!eMOD5D=Zk(q}r@mASwE&
zdK7#tNl9tZee9m}sE8yPI4+p=jopKrVn6)fF>kZF@b#H7nszoF+@CIJDC8w)7(zDp
z!{28zUR+%O7FK;5&UwhgAn^hNqA4M(;7WAX+H~av?)>O`V;F2h(<Fm9xV`Fs>TB1t
z&nHQamBAt4cZlFaeC|iCSrf>3J*l7e-}U?GKAPoAxi0?=ERF$a786@{{TT>I3L+ps
zy#9gT<*A3IAvk~DqAkYVxpU`Y`PgQ*V(Ctk=Yx%ssF&Mf6bF^CWdGC3aj2~(SdCPJ
z_T20elTO9Psd6qt#caWoE3bP|vN|P=3<U8)i6dW`#lOm4OW`x<kWhJ0LNchSs%mjt
z(}j(t>_UN0Ycg|PvPsIgErqW$v_kRuoEjx^OPLO+_!oCVna^YpK`Ah_$uK1f2fC3l
zn$A^+J}PA#LY#}FHhQ01OQpL1u0x3QH~ucK_~ud)g6;z{G(lpkvp&!Qf7yF4ry-Bt
zoq0Z|zl3f;hmr-=6p*va=Qk%yYp0wkIhNN~fAHYl8Xt<nV8$h5@}N@FD$~#bpN=`{
z1eXp%5!<9<*8$zjo)<U&Go=8gAh{N{AKd8OqFr;J5o_YP^*+HHl+VDZrlS#{b4wkZ
zIb&L@A)eFJ^EO84DtFg7hJ-QoxRdKdR|nmO)$ijPninKy=KRtq8>2qSFn`V5k$y_8
z3=+AgC`rgULVvD**O(A}EHAXlZt-alr;3+f3&VXh3cF?a<$bLG_0N>?0|L)j=PFVj
z@1R|OWrtRhyj8c)T|51o^lEA^@nAC0dG1^(mu0jPJC}w_r+x3CoVnKnc|ngQGI{pX
zOYGE7_b082hm7SWMObx~#!tkr6c0`f<|!xclFcVsA4G@H=^H6&iy-a@%|1o|Sw0-Z
zPX1$iNNFvtHU*$`D8i~>Qn?mu+z3+C)qio1I=4r{yk5L|bu9+&jlgNiCUNzr@t=n<
ze~c1F^~Cr?<#S>~I2Bc~))2LAiR5c9zofyO=7SSY#nRl7n{SICIk|j;W{ksLn~fO1
zRJV^zDyOjmHoD9hy^Xl)^u8J!8C`}fO}#c4s;`zgrk@Izr`+_`5Lgviv;3&zRf*j)
zWWHYgrwd2GTC8V|_Ie^cq5(afik@d`0(e|T^IVae3kX)r{Pgb+rVC35#|%GpYS7PL
z6^GY^g*7-z@POhn>!)}cIO!TR9mOXX^@4rWp*`r_apRkvXR;QhjbX4Z83Uu~DlF(-
zFEcRNidyb6MUj$r2sgn7L{H5Xo%{FSM)9epAa*!b3I?#XAa3uCVwe?Ijcjnjn2dc!
z!er}^dr(&~fIa%Tva&1pV@Q74Mh2>F0Jhmk{6;etd_q!^4Z+km?)}lOz&PMCU=@?G
zI`H4}8xaLz?ka6iG(;)+`|<h>8Z<{%Q9FQ2P`-*Pr(ErT>WWD<DF#Wg2WAy>33yDI
zGDNWfbnM7g1lfj^yXm0J=~SW#X=!#`pwMti%rkAoz{}2x%jlCUGJA!ns<mo049j%*
z*zP*=W5YaUtz4v+LE>uZix=M}Rvg$w)se7&|4_5PRh~F64wugXYRvyVvCoVhc9&@q
zl@#+ZxXH{+`LlL_?}H<O6JAZ2+syIn_tQPH+@J@v72%|K8uaa}qfiRFpsgrL<)l|7
ze7{m}e9y{L72dNFlUAVa?9_2%cn@&Ht}x5K5cZuZ%6(fCM9_Nh%7NoR*{s<ucJe0^
zn@2+pJxGT_PUrT>rtOFZTH5jN&qv4BbHc6b!NuCy&~Q@^c9IVIv##<d<aq~9Pha$0
z+B5)G-CJZlMTs$z&a9y8?&TI7sfZt^LKVCq77z_k?)^oP@H3-GHZ0(0D_HgSYx{JN
zSwrr*(&x|5Wp`63?Jn#p!6zVY9pOB*m;HFB%_Z3dW*|jnH@B}db6a)f<%+piKFn`l
zu$4$I!)WThXzrCw@MQ-~oRt%cNRhNfK9%}@l5Y<Lo|_xD?Z1JF#1IWCvn}>O$Tnt_
zUsnV|7au>4lYhhI@&!3<G{6!~Pw9-lwedX_6c%=cGP-!}+Bz2Ku%hQix(x5?z#%x5
z<QKnJYhz<#tR<m_KJ_xa_W|=GYJh6{R@MBK9Zwef20Sp_%DUC4ALN&~1XE2!IU8?e
zNX_s9tJgupGdh89{{H#>^kjx}GZIkKS+h$IPiijT3J#$&x!dQCJyC-n(U!DZz}6S^
zz9}mET|S?#eTyMsK6yHLkY3PahNxOVR)ljT)-vbZuu{^Vio9eh2GDmV97kQanV_c9
z@BJ#tDj{AjMQMM2WSgOM>B9-4(GJ-lP7aUe7A0m?G<EV@U$F7tEhTWv)*|oHI&XSZ
z_7yP4$!i#@MkzKxb|3vp>gI5T?x47z8~jsES6%y|-auvLFs+X!hXMlwU9txu&??0%
zG;^e}!;^GkdFlpivfrPZ8;6D}SPm%*rR~t(M2B<))LEsZJ-hv{B}<p;rHy%X8X-n=
zyzq(V_DzD{F)ef1*QKG=_JuPZW_mln84`aWyz-RS&Az{92OdaxFdx6>#gdX;D{2lM
zFY!M$Ti>rmC)HE%_CG7n)Yw6KU5QvyGF12N%a?f(>J{!QnZ?@0z|;RFZTQ9O*CXNk
zH*iy=e;vKkB(d}IgNI1%kJhl%+rpyKZP;l$&KfH+@l!Wv-`no$;4p-#2y57obTQh5
zNXqOd**0JhDJBDzLlbJFv>ZmTd_xr#9kkz_kxl4`eOXAEj`j^2G%!R&laBF74i_dw
z4B>t&Ubvoh{?LRa|AM1s>a7IpeZZ|&9aL2n7YX1NgVR*T6v}?&wg0!&4e94SrcWP=
zrPD>rHhAxhc6e89u758d21Y?#Vu#N^e(3Ptk(X^^T-l}#8}^jnbT_(wrOX|6Nzgf(
z+FNH<t%@^Uq|$!Hw~Z+md{mQ0?^a>Rmgs@l<NfEB*4?owG0OuU3A>ahm7>t368^#+
zaC7t5n)S%kMZ^!#=gINdf9W?}iDE_igHk5dB)9%vj%*P(h!32)Dm!JxKf9q}?Z7<`
zzpXO<f0Vi?2Jn@0n2BtsCRW@Jp}Ry#*ocM>5nBBx3r9$7I^QG=MTy<?$Bhqki%G?6
zDh%(l_aA4m&PDblv$YVAX+tvs*-YPB$;=lZ-n7c+RB#9VPf^7S{0;thCgvW1b-R@{
ze-_C-U-Rq!nFpI=cvtlm*jq(h3X&=6POj-X3IcEmy&RNc*W}?%1B3jd;3n@3*^+e>
zNSMNQ-e-!o!razY8Lp|;o+0;EwEUj7w`YFL@RlaL>xHHi30_-gE9s1i3r9WcNlohO
z{t_h&^Cw%fgd#1`C~$Ep6r_$yhyg^z(5X{9gG4%3oEESOgonfY0ipW>#<N$A9+(-m
z1WuL#H`17*qmbFrJ5siCzRU)&OAGhdap&}kWde#Q>|Y<({JQk%?T6hV7GNGa5UEAW
zAumhZs#Hw!O<)aj{?e#yzA@CY!`7?MiSiNA8YxIc15eJ5LOLUJt=SY8sZDur!RyU_
zDG>y6o@jrBRte>*-PCP6MI)8%qOqK=^MBTA1qr}n5V7jmOzM3)YaDx=-4~eblVpPY
zQoSC<Awwj>DUQS;N?&V<sswkK%;Pd!@oO?~m-dLdac#<lMEi$z#Xw6kc@!SIA8re0
z3gU^+P7roc*)TWhNMSo&mu{G61T?g;kOWrhD~R7xOcPRN4_es7JmdFt21<m|6p3n$
zTSP`P^(HXVC9J4}Xa<M{YGt;(zvO4L_%B?#WP=G^56({XbPPd|C&Y?-Mu{1^e*JnR
zbu9pD<cndfs(QPB_Yp2SsW2tg9WV-WtL8d-=e@jo8Jdcx@BsCI6nDe8(#b$McxAc8
zu&ml!feV-nazFJDqMacW-=J{c-OuRIAIiin_UoY`#~!I2_pfMycf1y7N=R7P{c*V?
zy!+Ej?A+33;NspqK1oz&ODSAJ_14{#O9Co2==OB(K9ao-`JZ9~VDfT(J07EMC&e=e
zL52PM*?%DE6ai$+`>gsJsnvXbTMf_VN_AaIC)YRZ7STh~<H;h2rzR!-<7Y<5PX?1=
ze97s~PnqhSb@l7wfifZkh3)ZWl|6~N4P`0IcqH4aE`MkB4ob$EVDkPdpW_)c7<ZXu
z4ARl1*|x&BUYFfYy!~X5Icce#wbW1<G-WYQaB35;>v3@A_>c2X%^u;mg(8*mMZgkh
z3fa&=K$dJjst>GnsR!@0D!f|<2dogLp`i|QXLPd1OCgb?6eS{V1bGvmxXhyxRU7$x
zDVCVJn}j210>t8f)QE+rPcy=YgJWug=|B}iKp;jx3rH&Sw5eCy@s9ynS^hgeT8cQM
z2eYI84QT}@5O#yUN^~n+bj&VS=FTTfA&9yfQS%-oVC5USZSFf1&PaloM5Ur-;!K^<
z3Kh^L((K5DU&EM1ar(@5DLmRn4WLRWHcrJ0oTE_YjTr@si>Ho!0zteieO-)919d-T
z_u*GP1?iVG6QsXz>#}l{5d5B_29tRq;;{oH;D9^HslPzp6uWOSd0>*=NUa!(WC6Kj
zib<wdAYdu(yrfY(BY?L&sqG#xXBt5FQci=csl*{3om!wKA>FjKWWt7~SSGNkZ9B2K
zm{>Xf^-F5giXIlZ@PAanWj@x<-$AvY;XL?KzC-=TJ*U(F(^HnS4L0?jL&R-EAkbha
z9g~IcF7G-CS>W2tp0ulTzzC2%_OVX^q=3%v<?I@%Q|FWG<9OYi$ssb8!T3_XQX7mC
zHR-b^GzKKnTa#@3=}?*b)3C0_JJ&xHs)W@UEN3RDvg9?MII$$Hg3|#3!Gnhn?|Dzc
zH7xU+1erTi{iV^;Z*Kyzoui3JZnvyBSMm~Y+KcX#A1i@^FGXbyhpt*$*7ZY;{39z?
z9IEuox;~Hols*?hQ7EjH3}l3wu?Cc8U!qw<ecA{Mt-!X)%@uMtLj1P|)yrp~lcw)U
zznx&6?1g8Xtze}<2lWOH9C*aH*buHZr|9V&N8PlY>;b*n_LrIwE3!r_cR%xML9mc}
z{ELtXS;%^&>(whk*lOWj0@f($Z&aJdSJjxI><r)s!jmr;7K*YeQ2wJJHmG~Em)7Z}
zoS66tCLs92bECyc<}SjzfRa9!laAyP?*BuZwby;=ckS$b>cHn*YN!A%@oyt(|Gw=k
zoT2-DznijE;IU3QP22WYFr7puc%ewm-@kihO8F7Zy3`ml6;wh@Wk8x&yOg)(<uX}D
z)}II<1h_}+@N>w#ak70tu+D=TeP;aCd2}J%mO`0;=_HkZG7G1?VGf%ogK+=FME+;3
z>9l9>-e6jFy{~N^4#~t>jG+1)wR*Y6bUTiP=YT=jAH8qB@4HA)^TVfqDRa!{qeL~|
z+10%R42)3297eae-su!LV?8N@eIG`0Vba336<&oVI@K4GXx6>&GHFIt3EO^J=0seE
zio4~nD&D-25v4qzy)2Z2M?_sER3KY#$3PvIPSFKs{fj0|h?=>=g9a(}$8zUm-I-gF
zFZ&-6J^i##Mt$dn+fD<31D~)>zu#CvOFWc#Z_}G|kXOl!UX}J{>+t5Dy1%k-KdFFd
zkk1i_K)<&C#$<I{{ry?l#s1*C-*?VklUHgo;iLDC?=9e_uw2AXI<u0)qJjK2wqBgs
z3Qg{=CgnlsHw20PceforJUiI$SehDC2h_qdN*?ix0qTgHjnbA;#bI9aA-7t^IGr2Q
zvoVz}P#k|SeQTiU^?yyz-ALePk~ISCG*&UV4+#t<$3MRpxF^7&pfaR`?@a2FWFM=I
zf=gdYGvvt7hxSF!m#Y$4CRgew@EHrrA=#OKX&P>y&bEbC5W}!wk91kL4oxtH6_bcG
zx=Kg?#eP9v`l|IxlD__=7COfu?c(XX;~9Fv%O2xDwh6wqS`rJu%2gLD2^xm~)U!pM
zMR`UuE#oHGeV@pyYr}<{=Gy<Z>)YatuBf0saXd@i3zt==MX!nLh~mi_yLK7vsnl`Y
z^Lf1L;&0>S8F<UIjZXA*H?F>Z@#5~x%vp%N$y?N19&lY0r9eLMNDQ0gJb9(8U6-;s
z4>`{fpCUa3A~r?Z4tmViY^-pJTOwJ2*gJAQ6M<AID5QW3irG7liVhg9qF}thp-hfD
z<WlX6YJSzbCrbu8|E_89sb%O47u)blx-)m|i*!v_?~yQTZHwDFW30VTSXcOsc0YW(
z$NOaGEq(pM`@XkYyJE!fAO3Mq+gDCMo!K$&-0z=@`#&9Q{{LElYo19zZ^SLxd3r+r
z_OE|)pAKFDp00{LK|<#Rfn$5rQ3ydp-zv_9fSSm`Tv@LdMQ+`^`6AEdC~2hsi|}Hn
z$<&MIFJHP;Y`;=7h*-EBiyP@ZeHB$Z$6cveasTeJtD7S?HDoLZXDDL&)IY6belGh{
z{j<+1(`j1P@<<SofdwNoTG8*$`WpjQ{&0t71W&0&V_sd;>&jI^PM0qq$jVk!-*1?M
z*<aQtqOp}Zy$BuP1Y1q2U##)W)g-m<;rV}GX|x^(pu~(Y;{*3t?2#eE2HktGzIfVi
z_l1)d`Z8HaIs<+pJYb)$j)xu@{AbDN{DbYABQzmQ4ebW9$h9ECn#DaY^d6hL*Z`@_
zlRcXK?`EO4=X*;jjtSL*av#7ujGJA?3!!D4aVw$TBZG$8gK?$F@NK?^^Bcvlzkil-
zjH9bkJ-aH}|4PK5Wn542tzS+CAtm~oP}@RDJ7&!3Rz{Gr6d4kB0){DGE!aGH7>E){
z`#5xKjc3S)hiJ%DfFr4cw$=O@w&G&%#*kNGs47a?NRsLn9o^jSjeb|SZ>hOKTRvBP
z_5_b$DpYMb&MAhHZ4MqX_<j*0zcnrXE9kAMkP;7~oIC+0x3eKWSEe05zU}=m|0Mq6
zMk>{veZ!kyI(s%?&HDAzO*ffe!M;Xz`o+u{w}QxPolN%J74G(QtyFiuLTkKnHbaN*
zFZoahn4<kSyk>iolYd_S%I>?y2S2?8`*S4AJ^9OPEcqc6?a8i}+MmF}UnhW&ndDpV
zl~Y(3UdU+IAz_$bda+@4nUN+?&bo|@`H7PTllEF)u@_S%+;8ZVR;y2NxZR;G#^V+W
zG1jCH1IN7JIY&Z2)vQ3tbPZ)!D@9`kR=(bJg}+|D{!_k!KF*ETD?Qhxf`T>M*_M3>
z_|XB1=W7nYf`};Kykas?;x>BIuTN!Q6(gS_&%CEdFrdB5+VvL7ZX^^_E5$Xo$98_&
zOHZHfzIE>&^Mg1`reW_rM>N*jTSZ0F6uptskF>J7IQvvTGqb-ZYig{A4()?Qavdok
z^Er>6{#rNb&nbS(M!15;ic0__YoemOM(sAc&TcbQY(pl~n_S&0ojZlq<yo9O)5xa#
zeEln8l#$d%+u;`a5HvIm#PB-0Bb@ODF~9n4iiydCdFaFBi|JIdtq4W(;=Uf~;Bc!~
zO_LaG^InuVdVhXBbhfuYdu^LRFyoyXW(dkyrfP9|Z_404n!gQxqmN#flA>29fH3rF
z9J%>iJ+aT{ooKA^;yArV<GFHs#hAe#+gvrM;QDN=c*Xz6tQ_q}B*HXyWNVPAOTg_#
z-M>3nS=G$|OYwq57K=rv&Ydr!Ff;&snM%`>50szXNzLN#B>Kaz?4MUG)oTFZ7ZB$d
za5k+&UVGu?JXyVe3zx$N*o+vl_UMr#lL5)MA)5|6fl*U_<FAjgsunAqXb|R;cyy__
zcsq||3fj~{#pGBc@AKSfeW<wBQ6V)~S9gA%8=>mBio_oS*4njzT6MOu471Ce$AKjG
z0UEOzJ9gVqbi=rq9z=ESP1Dhe(0|r?STi*>kIr4Xv_^0LiU;NLYgWkJf!eF5Y;#W;
zlr|Ry>jmy$13Fa<Qmda%NYoY=EZrj`?iz~dk!cKUw^wik+voyNw#hh9EcNz@Rg1VR
zCsQX0vP0puR?2+7<NL8LJc-p*1XIvM6B;wcRE6!PnTaw)*fm_m$)8ZJ>HhswIf)K8
z@%&d{uCYfwWCBFWw*mAzVnks<tTdg!9l44H@*^7g)T4gNDRi@N0A;*ondm_-=A(_8
zO)%3_6UN)*WI?5MM10Icno*MbbJ3(|kRX~M3oK74J7P+H94^^P`~^TdVmg--C;zZG
zXwRBbbm^t-OS?YOpYx>^^?`BDrsFxQ4i^=C%eWs!@Brm>*uH&JLtl%d2ALyAXa@*5
zu)fs^2_A`+Y<8w-5T5p&u84HqL-V%wU^&O(m}7OhES+S>wGsqL1>!fC$$W@*(__O_
zzpOC+*=O%jtqlFLp(pgdem!l_Hbcw+ScfDd0TZap(%E*;$uQ2&7D!<ZN@7j@Ne!n>
zupl{l4ogQ)a2~w$IEaX`*wo|Z$o5pbt*fD~-l1>bEl=xZzMEUji5*$v4kiey@Yl}4
z;plnKawTge?KA87k--r#(zKQ_L?Y(qXeNRw_{fpo^qVqG?r$0xx{-hAhWY_hTA>Q>
zfb0iE|NEC}UEmUZ*Mnzi<_I@jC(!4@lAgl=T0&@%CAWp0Fyl#%F(e(oqZYoz@_oHJ
z)LnY9`aTvBrV#`{qL_nO;kw5t;G3V)44-%a+Zj)*eDAoytJ<N?^fYzdDK^|)1DDk1
zxnA2nSSBBz73#`(UbZ$!Q5d8zyG#f-Q8wZaGF|x2oOM$iHO8BpYAj-lRm&ZTfqoDL
zq`hx-rf;zt%7B=aL=V(|$o!(j!YXP2c?z5lV~k6hKB4;tI?V%f^YPsgq}QcOJ%|NS
zc%o*HM~%6#v!flecB@||7!neUoWXU;qccl)A3wf0tLD8}5xBkf7#0~fYqn8OqsH0B
zzh>f9=Pq~FPi&*6R(r{kpR<+yu5i6uV+&uI^XKFHwNyPd7UnST`Y}$bp&=oYtE)cG
zC`!=~_neE1OLnJb7Ukxire0$%t)J)e>h&P444+AG>BL<$2Jk?V0oD@mepu}_Q$%vv
z7^34WQAQGRioX?jxeZ5uC|D<#Lzs?T>=CV)4fPKrA_c*t#Ipgv=LD(pe1@x2)JTZJ
z6y}7TcA(dw$VXC4*Sv0Ui_=nDrWiEQ4p9nXCN>j^5-haez-nS{52G!zKyXMgFIPUg
zA`$rVus6Mb5VFDjS!rnyiuyA6@9&5D8-dXwkdPBZdSePD<6rY%lJq21H{wCoT_`67
z+?*(p#4wHj)zh@&Puo*^s`UaSj}ib;IzQ^T=kMP)p*_s@EDFco^o$yife06Ag2}Nn
zgG)WCl{(63=Do&(Gg9NrbY$8DEy{p%=&_5VbmqXoNa{FVPMiy(d*Yj3q;jU0Y>-{%
za)q)=rnmktCBipfJ4Dsd(miuVAPaByuIa5_?fCHQKexUW-z4Q*YxpjKA!u&CjB~p>
zj@T{9P~ZDV-HP0x)w~FfP*uFylu8*|Yg8Qz2N8q=7J#9$J_i=_9)CZ%kJb|V^0BBp
z4Y$BnPoaFk4tbW(eJjO9UzWtMy%zZgk=PWRBVVT(-4@rC2nKwIs_6<N&7C7Ubv_oR
zx_G{ZU=>uOjhi&l?$P7=!jTr5ajcK!EVdoz3)9DqAK#X6%7BP^d;Sx?ROhpfUH-O<
zP_-ELavC`|?0R-{^*EXi{zLa{--h_QxUxJcjH*5C%NyGcD-(&im;kx<)5d(C(0=er
z8E-@4oH8Lx;)sHmja;bxi~@#f)>nHeYoIE@07G|#Nvf*-s2kcr@g*AJwPjxC2a?&5
z37aFhfJ%G1u6x>H_bi`Ko|L$PWjv^$5Y!R<Vz-<GC(H-P62w%_3Cf}VFc|*Zt5uM{
zLFB2+Vb0Q&NF4Ca?&GpYKFjy99X9M4=%S#syp09~$H=2qO0LzzJ<}W(g!++zmeqIe
zdrh6HI6L~}kL86NcU+ThFDw6CCMZgbfh^mi%RlNC@gqnAvoxB&e%*8Lr)x2+>?>)t
zqO+iR-Z9G*_lx{g^1%oXk^vGD%IN%h5k(<)<~b15qtdTUJoRg9{xB->tl%iO!E`%y
z84xJRY!v&v$!Vr)6<01@YVaQr55qeIsoqTlp|VD~4e|T!^EA~qMygeIGH<uY<<_qs
ziWWm5qF#L8PkSh0Hf~II9XgBe;c}tuGh)+9JA)ZOpbB#iMy?=M%j-q;U7VcuKHaY5
zy^phxGrKX5tudvYr|GD~<$tSNqtTP*-~HIECd?XSx5azkS?cCdIgY!Xl%hJ+5(4=n
zj(*uPl+iZvsJMNHc8+nLUGqJA#;w|%<^klDA<_BFGO0g5-kQ>ez_9;0O6X}sdpKj1
zFAwf06`-U6u{*8MMaY_>yvg3%P*$akKE(oooUM-pg42di#t1+l^X-059@Z^jD`Qxz
zhizVlf?nygx*><yE<|)e+~6-?{`nH}jN?g>GNywGCz8+f>W7?_qOfh%x^>ZmzV)sH
zX&aC@CK-NUjXbUCrfS;z0>zk30sQGg%>-&l0e_$eDtgB}lc+#pYv6F1w1I(d!~0<&
z8*DvVt$wexZ}lyMir3WDwRov=G=X1Bu+^iDV<n=7%lJzpi{PLjAm_`yESNAP6;I@#
zF8efB?pI_U{1kolr3FpOp2N%7nU-Wk1VhEGTx69Co3Y9&7r~^ES|A8HuSO_6U-r4Q
zo+$Kqd!p0w&HtIm;Vo7a4l4`RjRY77k{0<P=OJH6$_o;OB>+imSCkjHw?l|2zcpa)
zAeY&VtZMB69>QK5%5^OnXN)x!Jrlr|r>T1+(Ln$1@$1(mSw|{AT2U_eK9a!30}_ak
zn!b*(KtPFjG9GXQ%V{d%aByXkI?Q_D^+r(PH2kJ}fDI?1r(m-($hkPmQc3$ozZi{B
z26Z^=s{Sbn|Cz3m;L`ei3_5jcJVYY*%-zK(CT9S&eekK{&v3dRYLr2@G6-ew_$R}Z
zw0&jD32l-vn04#dw;+p1Uee*}gZ7C@IYrGK+mAoBR0Bh#D18AIir!r6wVzTGofDd5
zv{hX6%Jl64+Lo)uR?7$FCY)}nqg}fPK3@S)*mY!aQkd&i4?ubboUHh(uXxEY;W_<5
zV8r@|iWGS{&jByv^)Ds7(lTfM4G7`NF*kXmfQB-!34CEjae5cIFS(FE54||k+uJxN
zp&Ms2U-cXoT>MV(aR<yNh3V_+(pEQ+d~Zl)(b8h^_i+wIslOeelG+(vXSP`<n{`r2
z37?kfQxx$&{6#<GaQ%zmQ=w3#beS^mniEbCYN^mTXY=_-N$m${I(OrS3es3VqfW0O
z6;#;$|AHV1i{ui6RBVENh}{?ResOJ~DA2YL8qtXxv-i}?stAcZX+qxIOKbD!^J#6+
zXO2z@6ho1D4#2utYPA>rHfw}>O`k3p-{2K~{x;VLFKkZJ&h*%{m6zwCUsvJ+f@nTu
zlihV#tJUW~UXCD0;q;X9!gpxLkPSB46fykNmw5Z4<eEa%;(`yhN+XyQ(5!j$3%!1I
zujvms0qdanyJITJJ4!vbHlnqVlZFD#f(LbVnfb8ykFsXAY}>Z23^bQ(jBEP;h<X#S
zocHbh|B*_>7EwfGiY+2#sL+56o6LzysZDKUN@Z+PNHP=05QUJCAwyD0GAD#oDmEo5
zA&S)Rwb<YP|6J!f*FM|O^L#$<_geS5*S+pFf8+^o6fBU2Z+sg!Q&(R@rwrYa*o}~J
zfL#s;`^;=PDS{NjNLvuU>R0IweN>-`{smg4IQbgf29r6KJPP4g_)~sXnCXju{LgQ|
z^j<w_K>pVUrO623QetF_jd#|dKe+va$kH$^l71lpTYAmji}Zu1jONIZ<T+BZ9fbh1
zv20YqP7F^Fy^G?QOpMR1C`xt4PQLDZ8{18g{9=j>$7Da<rfHx_g|Ow!8z1X&KJXt6
zl_-VuIidSyS+49{q)XZq+6U03#xcK?m?#Zs+)<#zWvkAi!-sG9oHsM(stF(kk_XV`
z7YiTA{zHK4`6D$)p-+)J#J~aiZg6#D82yt@iFSo{g`3(MtIA7*w-o0G##Dc2<)deJ
zE~U^(UR6e*qMvVfWczhg-qCQ-RDR1Z81Dkorb@+B{c#rSRO`QfRR#(*MyCBs%1Dbu
zyi9YqQVC4t*V8~wIP5h8MHAW2=!R}lt#Eg;baQpBj($ZNuZf<E$R)%7-kT*n&1*HQ
zw`e`vvi1~*1o^(`Z9%<f=v^gr$<~3ThvBMJw{F<5A+5+89i8y!-H7yB?Ssl+)^i=;
z4zT2EfhR8`V2rGN+<XM=#<0T(VTG#RY(7qee6`sRhl1LPA5r5di|mxLuqNL!?fP|@
zB&hrLjl7EOKnlVW>6y{<#n)s1m7tc^et&VaK+J#eeF<Ar^%56RkH12o@yqs=(v0_l
zk;UbSwT62+3w&ka>S=>8nI9-oo?YOuVFRul?;JjQ&7a_GbP%#q^7+}>>cUL(`ippg
z$G3J?vJy)O6oJkCYbzVEtt1>RhYK#V66a->f|Nzk3+)pQA3%0%z;*nh^0GPi{xtwy
zq_gDSwZJtAPUL%~s=GhIUziVy&95+2W*>-zL#F!OShd_j$H+N5YriO`VJ-ao{9B((
znkQ|y%d42gagh05;K^bV7d>x5)YdvGob~59IaVA?a9_;UPr*;NM79pNnUTS`pt9m2
zC##7{PvqUT87EGhX!bVI%6hIa4wAExD!(QzG+Pp7%`+AEO)8Wk&QSHIH|q4CQK1I_
zFf7r)(7$yd-g`&Y#(!C<a*#^9_L<-6!P!|^$3MDrY)w3095gg&X+3I<_(f6|*!56d
z&DbZ73Jq$f<%w6JxQ^M|%a$K%r&hP3dRveBsimvi48K>xauYs`_9fS}v)3Q?pZ8P`
zbIPn%Yw?nyv-Jw(H3<DCaIP<8P%Rq}WC6wgjssgZD<5n78%V*_-b7CQe>F9CZvM#F
z7Cn3RBy5F%hN&SpQa2QmFBlVYF`u!Y9b5)*=OM@$gh&RcOVL1Q^`?(WAd@;9=_!i|
zvsfU&gUJjjjXky&&CuIm)U9h*>6y#8n>d^D1LUp+PZ?Iz;&U=YR7B6#>#wn+nvwec
zORh4ZCaZi%^*p8dcn3)R&JC8<KNaM!ioMxOK7n|!Iy*b#nD0{a=}og!#{D~8z;ay*
zSdi>$_UF-PzwYl@vuQSmzV(%WN0)|K_bkTaMx1;Ir?Q!o2hBZ|6-*@iPhr+wI(OFV
z)G1JsH*<(&Lyx}C8max+$HJmMQ6;j#VXSDad82-*vh6teb$2$I!GxtarF5qNoQS}L
zT%^GaHJC$a8wt%}VGR}X)+8L0-0V);H{i!oz&519?$y0}u!*W{?IrEYKsu9L>Q6Ec
z0LMh7Pa3tM>nH7SqO@w#tz>o)L8OQrpSvsjyva+lkP3>h*|i?KR>c-Mwy3{DERco2
z93mIyBV{8x){eRHbB9yHpPBc}uxW?EZDe%`0hLt<$5lUv%$!Y}o`oi+Z@+%BoB?0d
z%_#E<QN-9VrI@p+`xfblF}Oc(-aM)1z-@8}K-N7q(k}os?34Y5@Z|#G>7od}l4><3
zjet>FcjnBZBR2P@U06e3(HB#DS#e!&J6w^%g?~u6)Ol~yQ|%>76)^)7yH&sxql6SR
zoq|o4Nq?1_$y)o3JPq;x=WiaacLXPJ#9MHs1sem#j~Qc)m7n4u=&-d}0G2m<ookO{
z0tDl>>s#=a@3Fs^M1}0#+YTJrZg^TCo#49X)ese(&CU1Le|DpvVKU&rla&CcY9dN=
zb<2XJmFs}&b?*uK2CY{4IVoP?^APBvWd#m-2ErFNZhDEID)_eH@Z$=Z`<OCyDprb{
zfEMDXPh3_ob2V^Kr^8t*m}taxCWRD?t8w7;Wl!3u4<m{fzI!M9D&b%Jm?)&us3yeq
zBjI%mt^UuICMp1iGPV~rBFqKmjOUO1CpLBCP8~W;+zGKg<|8)}6B)YM?WSIANtmGk
z{bfLcH3W@FHArBX(ZDhfCFsW{vPFt;Rzx;JFC)_nLXn{_nSP&ry8#@+G>lSdLqxec
zQ~A2nQ+mjuSlDFvUXy>6I&7X+bQuZDly}NTefw%a%B|VG`}xAzW5<ur06pR%^+MGv
zo-?=(>=wxM4#T%uv@m`#6l?HzUB|6=<EQl<I52~=AkEbTw-(p`cRDd*XL8c=&(O~^
zsh#Ll*Tz>6R{zxwp7gAr_1sJnyDW0}zm@j5KBW2_o_qWL{Sox8ky!j64@yZXkOVo2
zDtb>AQJ&G=zGcjxblxGh(4B8(NQacmiT+r>Z_AdC_e*?XYh+NFl#H2aZ3aKPB=52@
zEAXc0b)g{6W>@+~dEp~Re$GfsUQxBdLgyOgi8%B!&49Q?g<B2tF>LD8og3;JcT$p(
zEwMO|TnI~c2w*pV<SXs93tpUW4BIF?F40eB{}Q6JHvnE<fpR5yBi*b~SCipR1`p5a
zZdO~b>ZI31;p*xtwon`)7xoi?vy1rs%x~%CX3bUp?RCxfUCX0=O~FYW6O1r1H>>ms
zjc_C8@&{oKM?RJzcJjKV#Roqj=cEJ29hLQ!Q0ZxiB3R}!t1P7ltv>pyv^-{^j+MQj
z;p@8uZ&`7aM_bTp{f71H4-$H>drd9V(}8CKU)A|sgC3QHiAPUzQg17<BxXjnAzDek
z*3zU3B@ld&A!9x`P-T#Ui{8DP-X%ldTG<J>libiFr#CEh{iTyD_rN&Q;y6S&=RVdc
zX|d{wf53O)_{83G^@nRPgQP6pGtkl>zr34_jv}GU)X^LnPMQelVA}dNO{>T9{GlAr
z=vQi;7x6|R`0MkP9{zT;|E%sGP_LCud#VM$v}ODDG!h<=u3F^~|G(K+>j8uxRW3gj
zTd{V)uGVXYGGS0Z<O+YB2_5>N4M690ZhWvSwqw*<cnA$GOSXB|%z+10-R$*7eHf)W
zhK$)R>ceR9$l4jHi=iqQ#Z2Wlf5ff$ASh~nMi-@HsoLvzwdKT!8Oa`Fch_56I{oJ#
zl&yEoaxNV&sg?Na5#Ne&0vkXKq>l!y&OSP>ornU(T9y9IL+b2aPFGsN$Opih=2j~2
zBEMklu?P<^@fa7qNRW#9uR#{xsP}=9089A-LX!IZTmcPr;(;+*>f_h22>zHjd}qzf
zz!E{&efl^b_uS=uSjWWU;lkNWMqlULaC~mvF*<ehC(4E0LskxuVjbH>KGglwUr7VS
z?1&J)m-sAWnU}nZ|KR=RY#K2tTzcKs*4GC{&%3)IKK`{&P|p8p0pe?oK9XE(Penq4
zwzhc&C>yZ*_>kZyzU27b#_oTdnwhkL4?hc5r|Q*@EE-{X_|hUZ!T)ar=a76VDMbh{
zQu)DC`N31)B+iM@HNM-?{O$&ewrd+GD4e3mHMMR>Xf*MW4BA`JEh$-b0K6Cg9fwA$
zGUNJ4hOA&Z;mr87YdM@0==39Hei?qNGBNOxiHh~8)ogvYMdvGfLqIxi-V+y5<%-4w
zibB>!&;ym`7S!wXyHnc9BY_U%k_jCqjXKC{(rFV=-i#@hekUgG_ohxvLvjM827b22
z%Nzqm5e^YC*3*T2P4E<JWAX7|kWVznU<%OOWCZ-nu;GC~TZaM0E7F2+9Bba`IJ85h
z1UVK+y*`T&EX&{7$0Cgmta-0IP(Mxwelx8M87Uo3|3M6c&3>+u5curu?7!GlZ?~*`
zrAidM0sV-nM-uRgUr!R3oS(eYlcP;DH6$*sY@z2!4OvzJEi0f;n(;pEt=0Z{D1Ooa
z#!jSfB$o4*h8c}cL-|&j-{PaNlHesA3_cd9<(>^{P2nw<>@|qn?)$fa)@tT$)&?SX
zq&$SM4#xrvq5T=%_c25LYS#l=QxHFk)ECf1RF+;7yA44klPcRE*QCfTXti=zAI0i#
z<+{o927F9*n=?ILkX-%ZoFVJd4wdHwYdi|r;oY#ec|^~G)+T(yrfHVHGZBvT8KCRb
zH%rLxf54>8m@rc99}U@m>yoO3^w9;FBwCDl)2|seWtuu&#=>YOJ?)o$p7seTRP;nL
z=|y<y%cgh%cqk%b+|-YsxA}H|g9u&9${4&}M?DlxfR_!a^kyiVb+S%QH=a-8kO@K5
zhGNMhVEoCG9c3QgWB7y=pW*};7uOrPxDj(OGJRvWr=B0HOw@4k^ps5tVss|_EajWc
zruNfgrqlEmbtwTw9C>6@+J3*G^k_?u&u^4P^LLDP8#Hk25Y<Gtb<*b)NLj)RWqs9(
z5d$`7q>*X_?n|*pE&q#OQH`aXB2#A|V>^TcB(xrTQ$ow^gI7I!rgHF&x+7+k;tQ#$
z_wM)p$??Yn`IqK<XlTVSDkYvbA|@0AYCf@*qvO6Z`-0YJN<jPcwe-jzzX_jonlMHS
z@&^4%?^{j!&d#{qk#dfyE&C5M{8DAr25p?aO#UovVhOox!m_B*xD$;Fk#+^?6t+!C
zAw?K=4h(e2nnWDJEHUMBG>p)?NC-Gd0}2pbNJSzFUpUjdV>Z!+5K|?(MOJVwj6D?;
zHW?-u5Efb*onTTqER@Ocs~c6HwcYt7+~!B_Xo^*FMHPEZs@$8jhpDYMsTwV4Red^a
z4x)0p-hHuaKu+99XtcgRrcI~qA^?~JA<IqK0nkhyEY;hwq)+4NE6VB&35BvqS8nu^
zV-tn%=6jd+%D`koHgNst4oNL{>|CZk(Rc{&5?>kHkYc}!mL{NWGIa9J_wWL2jAaK>
z{zA`n<Dju*!a_XcX|7O(1(%IFtRr4KxFRIDX*?={g`8GXCAl2D7%yUgoSZDvuCu0+
zN|;5gxww1x?j{${Dhb4wRkd7|36LN(q0TU<QWr`8$o}Q_?_CTG!Zzguw<f4hU9p-H
zicL7`aECyTBAz>ai<3u|W(%cF+v-0J9wk@_>z%|$5?CcBD_@d29^XX<z--Zf@|Wp#
zi)(Ci6ncODIepeFS)~->Ist%Jx_g{jr*KR5XNWkYLNViM3$d!CU8|%(;w6)*RB4#W
zz4mQbhBt$*0l)nLT>v3O`!-#JYLHhD_rO^C9Gt5_L>a^*l;fOM`_t{xc0{0#=ZU=L
zrVHJVEKFvv#U>0T0!hAVpGI2Wrn#M-zokWql1vIi#DHQYY(6O*Kl}DFYfs8`K{3Jp
zmpSGw4d8b~qbuQ}p=whxu;W(U_c^(uh}J23svEqYzO(PNqDoS2|3{4NP;)l!F*Jz(
zgEWucugV+3jXtqw@bZ4-92r}v^Fp;9$oK>r;RpV<q)NEho4^sjD@l|*GL#Sh82fe1
z4FcD(6DM48x{!6pCoVKg!0OeF;+4dCokwRxR!Qixb*>zEPC?Elt5MNM@L#|qAo7|%
z4uPP_BJCW(YY+_HJGPk2K>|yR9|nh6&-%-?^{iSuLg-`iy;>!5_Q3xS>V;m(euC+d
zHeYLPS)0RKS2C(JUVE;r(v!Re_EAVbhZb3j-HV@+sa|UbBNB~5wm~~ggmQ8`Ajac$
zx2pApio;R(W7y#B+qPAIV>6EM@Du}&9zU+B5C<osh1h#Z8F1&099K9LK;atV6nb$r
zDoL$x8{wavdj0||)<<lvM~s`!_g)9NO|F5k|0li&b)G@*-sz+(X`vv^6fC}F+qM&r
zn=<7XK<2XDH%PRDI16ZiVBOdBXnLQGxs2HH3xQO)Q8-76gpf<KmSRf%p6Srz^~Wr~
z)Wi1ALP{@c7aZz<@DC5ZXdZLqNGgmBL;h>{moj%l%0H(Y)><4O;W~spqk#!|aOA-T
z-S@_8XUUEz86V`lrxIyci7=^qJ{<{bsrUtT@+2?REr)D8v5+4pK0LH0@A}(PEQt9B
zLA^okMYBXiY|=Mig6ZeuvKsnX@H9MDG-AUp^xKbC1J;G*K&K-NJ`ieM{{B0d#<Da|
zm?$JoR863hDkERqt~8Q1o?Ah97PDdugqi6x*jhPg^XBHHCz<8KSPJ=RfY!0CI@?*@
zekgW&O)gxMxD5Hn0mtiK{rl{7!PF^Jbn=(Bu^u%735LvNLodi1WNZvdF|bPA4Mtza
zC783r#Qh`ItPCfs0xo6S0tTw>%D!d&>rc~wqr#ZWojzZCIoD1f@aZQbVy&<ECGeZi
zo;_RZP!pATHUm-IlpD02!r4dAf|4@XG_wi2ka&aDU5f5LICn=o0ILO=z~M>ts!*Z1
zc$D}7K9o$05kv|}y!7wX)+ABP7-V!s0*8o(xJzJjoT;Z*B)3Cg8XOtf(a`ad0)7_R
z8SO`*+$Gz?H{`Y$-Eg={l(T37@m>(dgOTo8d6yQ`i<k%&mfceT4gvLuwM<^9&qQD&
zhLIpe7k77ohfz|RX0%*Jtuu&aTw+MTZ6KP@Vq`Ge@Wt_73l}aV4T^&!B*U@nOrdsG
z;|eTEksFroe~KDLOgZ_pjTF_@m0hF<Mye7&9*g{!6uQVIjyU_Q`mqPBV2%G8jkxTW
zst)Kgq>oJw7wE=Am9ue+ekTv4IT;`MqzZSEED$Wx*Ky+x9XXQjGu&F)njB8T6h%A5
zrz=QuN{aP~UUawjW+m+Gt?2EnOu?`LiuT+k$T_R3@_chfD%*|R)ZPlNNakZ0j<wr7
z9n2{!+2}b4t;>W2)nr}8Uf|VQN~d`>qw?=$W)^EN+m+nMf7Mvrv`PB)LvRUN!|$yh
zRGsug7FGjQdX=|D29iMksR*8H84P6owGWFC_T9OoE7dIKwkYC1R^Y^%g%{Wg=dsko
z-tTy1g2(vbs)(ZIv*-5d$U7L-7yai|!Ik(}^VwaV5Q8e1Nmy}L=2m^4=iutvnJGyn
zUJk>hnoZMOc-T-XGJLXTuFEK8&DQJvM&ddwOg%_L8iEi%b0>6p!!iCfM#l3X;juC?
zja@y@H>GbNgUa!tDJ)W98EOHkXYJlI28W*vL^iU+N9b-mYsAZB+qOw@tB<0$n)6^^
zDEj&^o1_-j>jM~UO)K!P4`)e1ofnEL8NUGkD;Fk*tw%sYmt`1H#{Wu^)f!bR;tCls
z`wr^HU;>^f`l=T6`oSm<>W^j8QJ^k87}D$Tq^Rg<yv{^G0M#u-167W62QgSFJ^aJG
zQ`HE#d09FlTYUMkvYI8SK5FZe1JL|@_+1uC9jcc%IEI-R%#VGZCN<k6dwVsGSuKUD
zm~xY_1<qr_5VkYuGSdZIq=ty6<alslWVa%oNm9egcOqXq7GEA!_I+ZJd(97!Huj^R
z3%ZciU}EadR!_FG+m$|~ORz@gQFk6(zUFJtu2J(^-)mLg+7l>jI4Ixib|C(gJw>?x
zoN>?WAU2@%!_ondhfdRTh)nO>6toNL*^oI01ygpig9}#5XxT>>*%-p|oSC*Ny|$xe
zWM0KDYaYHJd^!3N3fu`mVE89(E8Bgz#UZ7vNHL})Nc`HoM{f+qcJ-R?>EMf&ln){f
zl2!*(Oc>prC5Pa+Eshu@Em=K*oQ`5QYgFJExS<<l3h5<ZUHwA~g6;;NmzH_`jGC*&
zN`@L$sSp_Ga*r+x_zTjfl%|@fMlrptiOxs)w3#U2O4d>YKtPG%p=_7|%lco6BTbyg
zDqMu%u$r+u-9a0u5YuP}$5#0zh<pHoN!l8S5Qc|MyVbn%SMTFG@#8<yJ6tLzwN05z
zrTH^?owD^cc!Z$j`nq<UGy(i{9-$~u@!az<xgPaNyGyd6Qry@E9@ASKgRX2HK<_M<
z001=`N>J{CsVZ$DAvQSolVb`(gndT(NE=IrR*)hFQKuc`tB9V8dJ;>U4J7cV)Ac8L
zfw}O2tbKevlaJNJ=?r`kglD3&mfxLQw;o>drLr!lzM^IV!9ehCebi9=m1fSYODuLg
zU${xbdaf1=RPc$BDxC^LR)mVN=hbD4!wnDDqf<<7bN<6FCdc3)rH|UCuZu!v^temU
z-dC2siJ3217se3*P3>p*D>H{ZCt)Px_`IkvrGe;;SSBHJ3OjdBUGx3Xdul*?mV$!d
zWg=0a!iAxRjuU9(xWH<NR0)|^C@4krXCg_=%~EFjP8yW=nb~)>{xh;oqb=B2Q**mc
zeMLGxzJ#q*s3jcLa#W{Y0)<!Q69NSl2*qCM#Q`s2_=P!!W`+JvLwIxkX8nEw|3yuM
zQZ_dG{t!&Q=v9g1r@VzET~}GdB-#-&6@y4S4Nq)cNC!~5au7i2pi>s5%$T*KyVK$B
z|Na2zNsS^Y02WHzTtV8h06igktJ%kMN)IvloKmvl>p3Ovro-vvWBS2rr|7VY?ggC0
zyj(Ei7P%mp3J0VWJsB<Ofx*;HP~bQdfN9t8FHj%K)szMcy<2PO{P$g(A3yNBGO0iN
z-o55_#}xmJ<g=YKKjojkTi}bVS}Pl(t%i1gFPX=<w9{J=jsz1XT5*uaOqKe5PW!8n
zxqP|frcFBqKZ(MNor&ud9xTaR(k<?pf6y3^LIcrF?AHXgGRuw-T2atd=mJEk$MCsu
zGvs!<25ezgX9|KV7Bh38XBcRhaZIW9Xl&A9YQSG3I%1)lJv`KYONo^NnhZB6<3>pT
zm`!ONNtH5^1Pn)(8%|Xw!GiiNjPHVQ(gpl*a%0by%0v?3u6@e$8lzHTBGR?!dWgs4
zqs`!_Ln!MQ(AO3JF#ecyh(S!*C8Hk8@F<sGczC#dzZou~)-4yKE~*<;stB$-E2QNL
zgO^S~Q7C9#lMvV<^>Vy=FLdLDG&pePm=-(g5qqb&t~mR7CtV6ie_bhI9wQkI=~=>`
z(O6Wz1t%>VC&kMfaS<CL{(~L7b^FsJ<1{Aa(xfe7`44SbOSF+-*9_Vy@2es<|LfrF
z8}+BN@{AlgKk77KdY<hb{3P_O?MIOufs=S0>=u(zs$UZI#0#~fru%MZ7mtvZ$UnrA
zk>ONX-o(%)ucqflZRT~`j<U7Ivh(J^^aF1q{~9-LM9tlyZ`3XPmlhCSd)@?beEN%!
z@{6Qi?dPP%cD4upaXd&05+Ts}F#NJ#Cy#M6`*h_u&zn82JIQ7d>Qz9A6)h)#y0pv1
z5cleR9IohTz2fo+@)xR(J3v-E2o6BaZbRuM8aQ5ySmmzSv13Z_4^H{aEJ<FH`Du))
zNkm=s^*?D(1zTJPbgcgV<&c*_=Pk!9&u^g3w^^*zWw$ib3z9>a)(S4O@2`(OO8Qcu
zc7=j`gg-Sx`>uCyKd-EOJrV_%7$u4PjJlO8-Uze`4XR#IkStB7#i%=^Do1c7fAGM8
znc+)^8MON+^K~Uc-jN~Lkaw0A3a_BDB&$oE$~f2_RyU^N`Ku6KUetmp3N7-VQU^mv
zHef?_&tjN`hLF7+C7Ldit8|aM@n#Vd2UDC7kY%eNU9ASpXEwwChgi`GdWs(-DtxT7
zsgA;#OFyf-RU=S~yC}RWsZezA)cDG14@+0rjsJO4VM1`@jw$NejqK5_TY80`jmkkl
z>!){*yUWxYw_Ge{X?x2nB|3^cfcd4T`f5}J;;Cz4SO<`l$t>7|hspl_@S>uoCkREA
zzwl;(Omn0q@^v`E(#vA8Mx7Tob`(bnI1VhUuAo?NE88|;WXP?Skf;Fi+RF0TA(8yU
z(#6}Te|N50T|Tu=3nNl2GYga5vNk_Rqz&T{Y}hIIOb@nULoQ2F1h&d7Jz+~a|C})?
zYN@cl+$}?Z_6medo-6FA4x=P?k9Dr|VdtcOhU$THLlHC*j7TJ!n435~7CVw(zbonv
zQ~~d~X0MmWj47i_)q85h9VNnv1{DFGOawYQI`+kW2OZLGatmmd+|U|-1s@+Dl>bEw
zFKj=R3FMLFC#o%es_fa7g3H5Wl$)~wqX-I_h5;}l$ZmocfoKzv%f~(G)4}31Z-miz
zRdK3=U+c@+))_-SJ8TA~et5-uo+MjJN`->AG-}M4>kxtpSwY2(nr1(-ZU_%r7+hSn
zV)wbBT#$;3T&q%d;{z>qsi8zI!|h~t;jC`xnZqZ;c3`I^!=$7anUZ_{ybUxkANpvY
zXN`{s6G4P#C-lkuCf@_bbAF&j2a`E`X<o3%i6C1f8)$1!D_RWu6;R*A5-mB+F1pdO
zy?|K|#<!x-`B5-OTeq=ZFAc!qG*$m^moW?^W`C*ZqGh~;i9+iUBaYY&HAlfHo0<Si
zAGuZ%o5jMF?Y9&Z)hLab#_XeS_++5P`>!?L&oV#V+2DEY**kh++ia3F$$FmLCn8+k
zf(9Nn>ApZ+c)iC1(<5hR=o?1d{X`!|?a#?LRZ}_>X&Z?F8$SykQ5pCwt1c*2)*L!i
z<l8Q7XYZyx-mCtk&Lf_yl4m&DDjy4sgw}(6B6_WbVc@JDJaJ;i>BOL2;^jdV*}=kZ
zBa#0#Ww}%)ly@ZBnvjE%zu|0495+7sYl`0Yy>KMb$q}}K!b1d2+;Bt{V}Eyf&Y(pG
zC%Z5|Ex!gUl$#~u-6q&Da0&&M$P0qblKw3P!dczZGne57ELvKQm+ZI^l*!>>;^oBZ
zRM~+7r<MUv;DXH{UporXbpL((xP`M}ON%J6(rNBCP=E)ShDf6hR{Yv~#KB|%-;Xp;
zE;D-@uUH@YXZCD&cWG|R{*Mi<4NfF=^zH;rNM_+h-+%<*q1<7LCF71wqF9=M0wq{T
z6J_jJWCwxd*GCb}f~Q#Xm%#KlL{K0)K8lqP)Y?#OBf`Eb%O+vC5QA2JyZY4e2mkfe
zV&iZKa3%TU=l4nzAZB_hx&^ECf{x?XBI;7-30s41G0&j2V#GR2S*Zgd-T&o%GoFYX
zF6fbuD2fL&5y5DorHq~;vEY7wGT-;mbY#_=;^Jv13XK_9+`Az1O_=#z3qya3#OA*^
zyDdDeVH501Ci|6Mf405N9qy#x#fEIc8^I-imluYp4sC7A`u2UXQ-Gth<on@<Bq79a
z;xV{>XlpJ`hK1IS)<L`S{cAp{C`61x(a*sO{lzjg;Vdp1v`^J|>$+KOD2aACH`O6g
z!D65;X(xvoY%9nRwp2V|C<*3|)IV%9A<&~4j!rjangpBTrfvEv<ozJB)VY^V&T$mp
zRB|HMNU*Z(KBM#u|LW>MnFp3$L;t9uLQFK!>KtT7rdRjaj(lLoMZze{3L)$G?D%J>
zhy|0AQ~unaiA~hhQsBK%&xqJgjQ%fd;Yi&&Ef&PI&}abYDqL{UAgRleONB_GBp@P|
z@w*fb<`GpcnWnyc!_CMXr2gU;1Qiun?pKG!1tnKB2wSRYm;!KB=_v9Gz1k+c6Uyl|
z7BAA-+)QiaP}tYtDXAQBdc}Xx2c>#ur&D`G-K;=yHJ=epalW3SspHJxUKVR7Q1HXa
z7L*MgrroJ=r>b#WJDK$$A&7}8z(fpw;A+=%kv}iwDfIukhm0=!DCm{0BTmx#6c;C$
zRB_s1Eq46?<{f7YcWOL4e`vDdmtOUbP{Q@s|7kmV^zBHkRl9yJBvXWcHD5}R)<3rP
zOUPLj-`^VU;yyR;W@a|}=zM51c-p_nsb()|6sQ1%w|^;$5z)43`x&8XFg0yU>wUuH
z$-__&;{o~ysE!%IE}(3#vBYP13$Bd>i^60tv7udbId5S(1|dxeW4pd3yzR!E2ZzpI
zy;-vnFgpJm;K`YL)1>$z`Ns++*YizdN5vgf%F@wdh6p_eZXJz;<L7Eh9qQt@9%0oh
zp_<SvLw-I)Ujz)lPNh!gd47hQtlSb0cc^oj0+a(Q=E%~C<ciPFh}Gsv6ux<*!h6a~
z^c5Eb(Q}F<JUV*vkv@F8$+Q0XCzOt?sKaPUEa)3MoxFHWL~l&^K{P8BCXZ-EAu7DF
zLdZnf`%PHmR1tt={~0%S>h}*Y088IJQt7uUb<6*00jMz6U@m;&+o6PfxGn--3FgS+
zo&9U_Y3mHo)&DgJxyK|s8Q*~}G+Ob+<Jaiw`rs$+c(C%b@zju2<M8~hC`!;hhd}b@
zR_YwC2-oZ7tfs>jxB95d^G(V(+h{D|TA$m!OXE>B${&V+mC=2OqM2)u`nnS5%m86B
z&`R?2mWA6oZ`icytu}FjEB=s=Chij!rKhm=A}5}T&y35Yr7w7v$jmWqPKrt=_sB+1
z$R?&n8i3MZJBD#(?l^b;=jByXP`b=!b$nxpe;61M%b>t|N5t43Rx-S<Gi|`?qLKL)
z2pzUYL^M)}CGU<MPX-n{&n|Z15`=$!(VLQSTBL>lO#nuvXoin{h9?M|)kYdU06Q5X
zXtP$9m~#l>+td902|5qa8PqN9prR7eWW>Q{%Nxw%*I!;+9Y#GM_Xr^*m6gbNvY5Q5
zZ#t!iYWAZ?C%y(dSeJGImUWX#@7ii}kt`qtkpV0jY?|QwXb3hZ;;&8n6X)&?RG@Aw
z>5+yW8B<eBOO-Pw224l{+6<WAMk+!&sV29wwJsC^qXuCZh{P`pED)4dB>9%|#rjC1
zVkfruwC9A&fa2pV(<gJfdz;qpj<x_p*)T!jrcel3NnS~z##0CdPTVY_ZDNsk6U`c+
z2&H&Y&(&Y~czu}+6fogvc=5aW#4zx?s#Mwg2H|ng;fuL-LkdX&i7<$4UVqKSk)<%$
z!?++j03<!F_Lyj`b4Ap{{MBqnQA3of1m7(^UYb=?7FF-P<7;c+-{8~8E^5i;-)p=(
z^`KL&OmQR7AbF56>;e&|*09U$kUb!h6I=f{L}5y2C4)L#-lk+>@kwV(FT5b4`A{-r
z6ekXyuMLFQT$euYH~${$+saN8?@ITY4C?XP5Osw-eZKhTu%YHyP2_i${QO;aKN&Ob
zJGy30L-M=Y={|pruCe&~VDO2!_b==ATHRZt2-MKiH(t}$)2(4>+4Gy4U2W&~GYNHm
z^tOK=Pc!%at39XrkN)4a0k>D4em8g8-lLx1OS|45bH=#M{EPvq%h37W_qeCm*hEQ3
zLrvK_+2Ya4o{a-jZ)&A|JNI<@x4c;MeFj@jl@IyxA<m_tHv4T_kbK))n#MQ3*bAe=
z@{q<sdRjd=?UI{F!Xezm=*ySevRgrQO#_9fDKXVx{Qj&bWv&c~esg?~aA3y{0m{?%
zKXP(|8Dw_bWB&Xbh+Y<#z36W;U;x(U3I$FlTOkKIVzS!|97}z8$V&6Zwsp!;zHN?7
z3N83q?pyshvMx9^)e0P0$b^)L9Gvpcn+`iNsfhi1UFxbcEUaT5AHo^P`NxZA@a1p2
znQvI}_utA)?LNnAPu3_X)23ujWBkyXu9O3g`Bzoa_@R|qBRdwcCT}=p8+;{wrNBlV
zS81T(x^(<p34Hj+`wRUvomW+=99aIg?bXVg?f!jeqoKT5ds)e$b%kYR;mwCuD-<8Y
z7p`i^@T(j)MIm;y_=BowZZyMbp#hsA2fkd^FmvdS4<|S6M~6x3x>{fN<Dzd%-}MD`
zUoTdtHunpl(c2-p=KjKxPUW55;C|4u96Nb(_|&PbmzwEHnzFO=`RhT6vehcnxqj5-
zy*$N#U%t$NmF1?K!OK^ctE<M@y?;`JNtY(<dBDum?(Z>~8{4-2z`lKBzfDoL>NN)4
zJtm#MMu5qb@-|D~zn?W=Z>LsGWXl%x#VndEUM)>y>|%wLF*hn<g4t;3&`l6VK!q;d
zyEoz;i9(Jx_O%|GOK>^JDkxZ}{ch+~r#QPb*Z4D@%*Mk=xN2AMuX?mH%qf1NY^8A{
z-)-sAR!K=oKHnS@sxWFOS!$M0H)T!5rP+9Ud}$x5r{)^SCn<ZR{$y_d84eDZWnhN(
z$FV6r`JFThb3EA%90Kr=;eT8P=zC&JBnpDx!jfH%P4=X_TKW186k`-xS28RB$n)^@
z49S_V3ZKj5xMt8CB0Hl<a6hLOm|5NXYn0xK2)cWzy!C(r>?9>uiK1Fw$mYSHZbgMg
zcGT5PU)RxZeR5sZX_=Mg7>S;H@Xs%gsiJ(mKRd3)<Px|e+sR~f2dF`8wj41cec#P-
zy?tmS28hEV;syD5Fcpii`=L3cD^8Eg2EW{qi%RX4L&0|~;&vs+M~75!C9HRMwIKTy
zwLg;U&9RKa8>*?I`hoAYHC(>e5E_brj1DVhD>yBe&5z4)A=%1)sPErb0CO^{FUjN(
zw9cHQ{QMNx_`<}3pN4fG*I5+8EoZ3rxmsAN-@+?+O3!q@=q5<k_Cr^-(F#)mZ_4f>
z1e$^5#%Tk$>S?u4Xjo3Uq)dX?v2$k;?!Y&|G}=cj-}=P24lrwCmHXnwhp40TRSs^_
z-9nK2cb|>MjVSkJ%i0j*g%Qqr_%J}kxQGVee?ETwD)M@|5_00G%v2GpCC0tJ{botx
zvg)^Q=PdQ{QBvSB$z&MhX=>+kSY+)lmi@NhHtCYexeS?f{Ct>i@$krjnyZ!s>9oAB
z!SV7{KbO<=vg03Eu^pe%1e0&1mx(LTSUVI@ItqN`pa5n8DXbf1;;bQCr@_xxzIEmy
z>k+!F<LuaqVi{*=9_JORn$WO;f?2}w{Lk=9R+y@D;>2ViGt>RszQ0UM^E^zjlWyke
z=_zX6pcepY<3`!I`<PFA2oDI-m}uS6>Yh@|^;ZITC0Bob&6Pj|c&fbBWpklL-D?YG
z6pKrb-f!D)Pt$q=*vF?13lAkGwi6lo&4JefPy1EH(j#5O@w!R2uEb_i$T&=WyJ{tk
zK>I(z$tj!{w{PgL=^>c}py2+P(y;lU3$_*S->31CWhOhC>4notUv+@-jt^G^>8(%C
zBxbrvl~Yw!r3lb=Ue!Y4n+Vnw9}-bc=i6TNuSoj#vFfzHF5w+2)p%&RjF`NAdvo8I
zVs-2Z1kn=EjB9^Z_-Az4Jopu->0;>Xg)K<Rd01eLZKczqMNz4K%Ns#%t5&s_zrT)E
zsf8?{xmi*oV{03`A6TYDWnaI|Z`7R;rM9i>UuI{kY`?9Xvi!*o&(QGjZh^h6H2!Lm
zG;=c-Ij6A+r_3eZ9;eOqNJPy8-<DlkL(vk255$AEU%2Nq=7MO70<Cr%^q8isl-fSB
za)0W?FQz*SCmTkLFV(23tlYD;(AdmOXVuVx5$>ZnHod$rS@}-B>_4V!%eQ~ue_g4k
zp|<blk0qZ?wgeK6{ES(!N|)i!M(1-3Cm)|eW6vdb#q#B1_R2#!Gb66=p0V;{v*(6D
z!P7Ajjt})3)U7PUl+8cQnt2zsP3#b77Y5Bdz++o1^H7YnDM1sl<eW<6)~#DE-%0`K
zJ3NMKcqtkWcUnK`_zfbFZ!OP%#LAWC;ymbnV7V$GqzB_wPWe|&F=<sIL&%Bpl5xGX
zf!8XV;R!YC_RIF;#*P(ZH?oHqpk?Le&eOISWAw#1hO-s9`fFQxZL%^8FeM!YnbM|m
z>;wV2;3qMuC`5Z^3cgVvZ)lD$)K0EefhTi%^6T8(ZnyAipu|X)V=Dq8X0B*VSKVXo
zTqT95B)P?D4hxgsEd9}uI3sohN{{!*)P=N%K4)5t{O6x{Wsx`9AIhFv$ss*RG+^WT
zpXEv4W=<OzdP$|1mbwfkmX^+4#RRLz!i6JISjs^`C`cXkV9dR-8aE;qMaJE^GiDX0
zs}qh-;n}6o)%*Bl@^~CBuUrZBRWV%qaC&W`+sMO+duUz9Yz){O78b4M6r{JS>+9FA
zg`lPJDI#XLBFAg1+OqU5CBk<9f0GF4V?>v}d-t-xGWD696^6iM;J|Z##PRyhCnONN
zl{gVFg7ID|_gTOb8Cl>M`L#DZ$RFW0(z`j9J(rZ_VWRVPMOyF4J$F9zFu8X@rTS5W
z?!SAD5U>HGx>`deV7teWk>!sJE@4Yb!)Qyix|N1<(Ig1<gHw9SQsjucyumPn8C#(6
z?PU|_!HX9oM*O^T`Lb2lmR7yAj5EeNbbm<Tp@U%PadDws@G<`W7T<sT$a?lHL)F3S
zn_0r9$R(Ha3_TkuXcjzAVg<GuFwJGaUh?fM6CLvRW`06~6O<4b=);YTj;sG{zI0k_
zHjgU>4D?|P){<XV3{eDR78_^HCy&N<*VliP;uCaf%@)h09b7KVn207Tx%N#Tai3(w
zAaq@a6>37FFuksQf1C}0_@#gS>Z_k0m|t2^)sq2C34<~>%gH~r;J{t(Rti+wZu=cx
zTKUi$xW8h+aAL$~i$yVrol_89$Fp`tveb+?EjeqDdE!sUq^cH*8!jVhu({u-?U8J&
ze04nLz;(99ZJ=(N7O4dKh$>`(W4dwX;5E$f3p04(*-SaEAxO{_qAnpHRVLT}NVdJ`
zOj1U6@R9vQnbo_;53W=ejSBx+Zmc+R@uD^jSsC7e2f1|EzoOT0er1A#Lm0=BIV7u?
z$HFN>^fE^Rtyy`s#<|P-kQ=vdsY#{JZ~BmXvH6Om1KkW(RmD2*H%XbtI8R>%N$dEO
z4dvwvc*!i?v;zY<L}V7ruCm|Uhr9QwheJ3Wf9<cVTuh3L;{ISO1fm}9<z)<B;$4dT
zpI(x_>YF=pP0jkYX$tnaU~UJw-%hO<c8bts?!KM$gjnIyzrIno|32$=d5_@>fZMs$
zM(rKv|G3}zWxA^oki^NtB1lgyXweN1lNXIGX7_80?_qvFhi7O+2g+HcE(d=yKDfPe
zA$DjUiyHEf2M7FRwCHL?eD8$2KOj|~N4lLb5drC?#Kg4u1J12x!5f3w2NM(bmUX9-
z&s#iaKr28>@4x>(Z18f|a;t?4`(TzbtGn`>Qc_P!#F{+KmMynXNH94BE7iAC$s{8c
zz4bM!jfWSvWx{tENUE|tu|m}L?Cn@a=!gfKp-4@<vfS$?b`h1hi@K3GWyvE2eh0tm
zS(FiY>fFt~@6~pn{Zf8S`lMG96JbIEVXHwo?Bi}#S66px!P}q!uP$aXzSCjwFReQq
zkMP5sz6p3lfFNq$jrYIa$FEX-<7QUCThtj{1IBmO(@V*|FZk`@lc!Hz;me5wlwQ^O
z6@KfS>pn$H=($r700SaTSo}&$4|~Sh83@@O>-@7x=8$iB8#giMC?iuAKi`dCR(d?<
z?WZXV_TXGC8{k(B?Z{?<0Q+7(-rLu=WsTsXl82o*eMJ<!XY6~~vv-pVR9U#Dx#5^1
z9jm-%O;sBT<BhqOD;n1}9Xg2BA)R5lryf@RBax$89-6?LY1c9|xUrRI`aw3P&R@;4
zEP*sxF>x9ug9behaUZ6kY~<gjV@EcxUGOTIzhD6lYwBy)t!uFAU6VVFjW7SRU_trG
z$oFlUs-C}ialDz9wwHi*Ufk#mIGDufQ}+RFFCNS@(cx+3dR9DdYqtO6<Q}cIHSAB|
zGdlfn?ggI~$(!OU@^++QKtx+>yK8}G3~2pHhLl|q@iXFl9vpB?N=}YEqBCe^{(wii
zOx*s&nNl^-GT=8&65m-v?fDcvjTELhP<LTr?6c<l<znw9AxitklIq8`3|uloPvg?7
z-d?72&h1H>M&EaP@WH$xm(lzY0Cz8Xnqa6Ec3U}I?`_+z8v8To-2Vz6D=U&30WEQD
zFWfq^L#hl)ckEbE`u2WXMiV{^zI?2TTqRO{3IKxIU++GAkP7ZZY%Jlik>KYYJMadd
zpXz(~r6->6a;Bi-Ua=F3%ZivG4c<`PFQs(B9#s^o*FNvBD9kOW8^Gak%%4wqR~bET
zo&lIxU^P@ZLDxUExqtOAtzV25ZTX@Y&dg!Y+}vF8J7C-tlgULk89#C|{nlErpMmtv
z!2h1dUYA?r(6~YBUD%E4f47ex^}#svpSg3by}kRR;}Z`dwBNJnIaAK0FxT9CXk^7N
zP<I$Z-qi`BjzJ)p$8)K^GwoWC1pUriZ)K0$*MjGo-rUS4`R<z~OMQLMt&0NiC<Ue%
ze#%d9>xYvUNz`y?7rsr6iuSXY_#zfRV%^+^tgMLy3#?UN+U|yl3MJo7ADO`BIx(0c
zmt4XO(p*b>SjD{-CdS5^RE}Pc;?qqF?+yR*=l0tRO8s8<_;h~%W(MUvh7!MAXZ9OB
zc;m~LGkfeD<8wMa{VE^lt<v0;y4W(zHhk(>yOP=wn2^(Nj04f`(r4Ny&l?Zc?UKJg
z)RGWZ*kkmkZ{OTqZBIRKGL*4Vc)nTP6&K2Wkdn@5`YmaA(X@q!6d41%cK!R2UKwgM
zeWm?ntKYa<#b&=4QhdHQ*QuMWOi)li@P&Lb%^{*VHRC%^2(q^%c{Y%7O*SiC{q}OD
zc%_pJ0w88xA^*{Gb*J=q%D-V6=#^Pp6218hojnZ7VJD5;vuGwy8<=$jz#%Qw?Cfmm
zYHqaY;^iW0XgoMdQY)Iq+xHT40`z`p;TMVZ-TgT?GBUb=g2mk{dv5x(YhU|ct$r1T
zxO|ECb|HFN5qXhq$k3voLqK}R@k6Rwtvq9(6;`>XW356kV0X_SR3xu3;$4^OvO6oh
z23QYNtjzPuEIJY~^MCIr@9EDlZo209!GY*&UnhNgxmP=A>h%MpuYLIP0UhPU;h;^|
zER5j@E=E&?yhnQ&1zl3PRPa1cago9a(;hd@AFcEZ&Ywk}=!ikS14b5gzqrwBbHloB
z_ZGMETk@GSv~)b-!AOM-tSo8sDY(dmL<sJtJKn2E&1}%1^<TgGNM%mF<`XpGL6#{D
zpY-9!k5BI1sbtF5bq|yy83F6N_r6c=kLv2N?1A4OWA7_R=-Tfppn<vXc=yRiCjHaB
zRg=bz7nfGw?#+gIx=Krm_Ozgq7&^aV_MFM2?L`0Ah2`_+hrJ#W?g_r%^K{Cv)6b&W
z><H3?{*djDWA%rT=h#-wCP`kHg9RL0W6R4=4q!GTFK562pW8Es9n}mNb7aykON`ZI
zv&raJ<I7htH>)56YezP-((r1~c(`^O$N4_9XLlP~`*9eslUAr;s?9^bwn1?q2S+Le
zT4FZ*o}LB<tksfj?vmpoBE$mwukVNWt9u~v5|=iS=D=d{r3AN$2NJ!{PNt?g+4mg@
zP^zd^iilOhav=sn%*I+-)!6I}{C%~h(~@VHME2oECt5Kx_j1+eajSm5cg|p!(66`v
zPr-QXa3*f*-Y3_o3mta2Z04%U5v$NN(YLy@ant8wi~6?0h-KyHmn|vETIm17p|-G*
zMGDo!=7QR{1F=}>K>09n^5iw*dGrfNbs*MqIz}=;gkIrYr$$zJN^>vhpg5jo`xAfw
zLo+8bZe{u9j5k4}bJrc(WO$Hp|M1<?`A!*|MrW*xV%O3&1GON%qk%sjyy^Vna)m>#
z{j&1JT?YFG8Taq+ebah^q2Eh8k2|`XHNUQ0v7$3C=h0%WWz2`dNAIg90Fp7$84;aj
zd1O+2$*`Sc(x38);&X>`!mJNzFsB7=yv|b35)ZAtkfiRX)s>ZWb_|#5Q*EsN<MTn|
zL#zV{QM=kJD^N;mGzqbFdkLhnhdV>3krv`UQbReuFNyDQ6I1x>qpR+J{qeuF{QUgm
zyB|+)+^pG!Fz;_)zaChecwt8G6)RVE+B)hXB?Et>c_)rUI@7og1+ea165&ADXA|oc
z^pH8?ZvQ+w^z8i}dprH@@!xEF?mTNY(2`<fZ|EE#*Y0Jz_G&i?F&x@1NUvP0tA<m`
z^9>^`zL#_%lIm-%X8Wdg`0JzTuBmJXvmaa}HitC9<QhZ5a*bzxnpns(hI`FEb6|Md
zP<1l(D6pQIs#|@B`?86RjsfuK74O%5z?Z!GeD(;3l7Oe1+RNkV&l#?yo_Ni<Fck_{
zpwEh=4hV8ZYsgB^a8B2fM?PYp1-HY=Nxol#7py5XO=RVFUnS0FN4S+`ufqp^6k5&V
zd)8*hr&_O^$w|^2V9e$^9idtA_Gei1CG7H{bsd5PR%teNO$AXemf>M$fEZ4&!H{s-
z;0_$Jcr0qUKV7<Ydvhvb-Kzp(X1O8Yf~zBXUIr{4<e8Cur;qGV{BRGHfMD07N6&tr
ze_;HdJIB0Lym<NYL3=BNNYl-%I2Ixf+P3Zb80so=(X760cHf!|B43tve3z-sl^;KT
zjBn{}GkiE3o!Rbp<{45I{Sh5n3a7ft9ZvP<&z~3ntv22Har@p$SESatcWG+(@!>XU
z?e#ntzkO@EeMw@_>gcTXlz7LcocJ@Q-=2*_Vj5n%y0BGPI*?g3efGT)G=pGr*JKtK
zEZM8o6Pj+UBvg>4{eI10ou;Y@LnAZYqo$Ytgoz#T+e*tL#oS7xY0LG7En$_V{-e($
z1kYNVXe-*pf-VXC%;5TFt*Z2L9hLFG&sJ^vgb6T@S9VAiF!fU9nx^ss7UPekNI5Yz
zR`eXw%7lhod;0Y0Fo!FPwv0Ja9a&$~QU8YOwf3XMTMW3NEepg~f6Es^gZ9N8gz36P
z1*^ZoVyG-ks?wrov{vRAk5B1L)y=|=YDu0bZARxdR#vKIZ+C_-z-n)Y*PKq|ndvn7
z&$y;<Fkh@Qa5j%r(w$hb*A~?O?AT%D2cwAdYpS<F0Zg&8i@I_}hYn8=SW#r}Ailwn
zZjWuAQMk9yP4$3x4N7&fWKIBMto2mSQRmNp*|a+0ZNIu9*l_IohgdTwg`mq_-GB38
z&du}eT4A&M=<<D!O_!RzDp8*6@Pfk=69M`o&R{~)kBW=-h3F%}O(%zC8$ER*+RRgK
z<QunWquJ7g`Nw^1<Upu*jI+CYDs+?U_}tl>p557_W|8h%xy|-l7qy@>>2`Uh{rWAL
z93S)A%&Ye&d=++kEv_3IEP2o8R3!L}@<(h)B~UGSHQrY3N~`Ds2CYcZ2PgD+e$e;9
zhzl_>>yl#Hqm1KtK%*jaz^2)}Q;%lLx~sV!1<tf^jkjO);kl9c+6lcwAA~b4B4CCr
znsHHQm^@f#w*L>Fk~PpcOy)zaAe<BC=LB){yIHJoj?I1**5_IZ$3g-<^*LR>XuL$|
zGImKV>2(=`{#SN^17e6mRN5$bWF*1t4ts^-nYme_-$l)J^k*2X6qmlTghuqsLZdx+
zU@JCmgl18?Q^S2ocvoI-!+DlH#c;!WJ46FRY@%D>@Zww2>*&as$Ftz+r70lF4<_>>
z&b$37hyWQ!)QJ;KaKkV{I3t1&8j<pc1;dos2JP;~bCtbJ0<kgWp{QpyiEyJbD@rj0
z2(;*)@jt`5pHQnlTc@?Ew*|rYKKH9P({iXxa%+FpbI<XQFX5S4hfF9H>WXy<91S6*
z0LHNT3I(zP4g6&(vUy4*1zoN#;g<g*_eqO?{AJGd@f*%`<IHLG<7)vx$XHZF)SnP&
zkjXxG+o#*`LdiQ~Xa?s-dqb~Plbn9GJ6lY-{(oA4OI=zuxm~$kZ+*9rERWz+7rILq
z4f1}jE9;k0b;*0*?fHz{^Ff-jY?_7_UBASZty<kEeK7ohuiKXY-TpghM%-FQ!*w>%
zfs>90PdfhhU69h0o~>aOCKtIAyCK8&(n<)iF50%z#y#Ht;H2YZG4&AZ1~4N>CN+lF
zhuvp$4pGd!cs!~Wc2Cg>dLBB|bHqVTuHj$<zGFKwl@hz~*r~14zkmO+mJ{vmFO{?(
z*jq~-yYz6##VOOKN#_#E2*0ga<pbzuVIbz~J=tl4^`R7`7jo$2<?@>d9CRaRRZNB-
zYHYJG$R;{9vcA^67A8B``j91}C7u<Zbb_;U^K&^Hp<Y^PYvXJ6x2^dj0n$p6Z-g5{
znIU`)jhm6MkIG67__}f~h*3G7=K%GCYd@wvd|x$C_uiwIFE@eg<^IrGEYuyWSq$|j
zG(pduO(^;?LoIh&m^NuP!zMzjQ>T4o4MwU<U)cx!|MO1URw_nlTwKF<LeMYK89~=8
zPTG9Sod2*LZc+EIoZI4caBo=kH=Gql7~k5er}k>WLA%)LwT|>df7F$gmRj=<WQGQ-
z{?v*0{<-ud=_s>g8QD%oq$yNT4Jm~Vzi!qJ^x=?+uon!oJu2^V!o4T?#>k!a74an2
zk7!W*)pY;k7><B#%(>i6UO&z!*}a%)eA%qoVeV>tKZlF9xsM78EdEjGtTX;*>+D>x
z_sWVT?;$m>3=ivTX4WL!#&~q$al6<u<%3N^uG=0~Q&6Hv1CYTDBG!LQDh@;DRwa{K
z`6-E6?Me&N4A9lAV&xN)j(<?~U@;J<W_`M=zEU`6{deC`uVpC5-D#N}h-1Vky(>3L
zDk?^LdiLhQ(qU-^b5B(#1UGs!R+~SLTAVlK_!O~DlZpyKD_4<Kwk}jDf^ZnQlJWm(
z10TPE$`j8Lv`2)HVeanT>Hhq3m4&iI6(h@!)8~#$t*#y<oV;+OgO-+Pu==XQ@_$<(
z<FYi2c#SQQv>bT@omz(CQ5b-%Pgn#L$%s!+4OQXcnqS|$@LK4znJb&|S^&4AfQ9&i
z6Zvn)*dMGpJDdB~-Qq`E$!ZYV1xxD%XiubtL?+Gi?tYNQo4_mdyfSS<C09{e8POR?
zBitAa#$tlHeViRKV(Fqg*W8&#oB#DMGQf&9JhRthTTv7=L1ZZ9D^Ei@QfOfon7M5H
zg^?W75YZAV^>&T{qXI4Xhv{2Kb)|`-kfH|LkDO2oPnCmcShjyXojn)+dR<+epB;Y&
zt4S3?0CE5*b}EtGWA$UUf@lt~sj3mkBr6D(l+*AVYX<<gDKtROfYKEi1p|f3ywr|A
z1TU|Dr>ImXd~IW26P;#6Aacitgl0{f?tAp^vCnkEU%o{P<#@fz)4Tqdzsodj;tkVw
zvx-;!rF&+Gdv0pO$wKM-Y&x1}YT9nFOXApGT77OG^K~h;(n+X@o6?im_;;=d(iw6p
zPddN)>7Ok_dwkumw|=>L<KYo~X+VgMMjZa|ZV;g$A3p<2H*xis)IeWhvA1#YM)DLF
z^5D^<s=v{M%ho~xJp9g*K$8zD(J{9BuLHS-??p`@LkA3CbEJ6lOS~r+>v9fc#KO7$
z`!sksQbI%F;-@8lpDLquG6ullkPIbLAfRQZvG2y9x2TU1Dnrgk{97W?v?IGDTL}Ca
zu%th1FS4VNJXZR$BH)08Aa=pPiv^xk_dW&i1~j$$Bz<Xlt^Q|4!R^PpWn^u_%$b`Q
zN|bU<DX{QV2me3Wyc;ZZIidL4wGPP5f0YJz?nv`;%e+=r_cRtfY#E^^p@q<l`^k&T
z`R0B{d(`dMQ@h?Dr4Kh_e2s3eon!X&c+BdE%bN%J)w7p}!JyQ?`{jfVAxIs{^7t_P
zAeA6iCS=30c^0k7a)qC3?$w9`EXBW!oZHx_0;kb&tRDEX=dV*@P*Sx*tKh-q)22^N
zD`Vo;D=S1)&kDES7O>|^oE9ilil6H9Vza|}vFm95*~X+57U~(0UuVQUUEs%%=8M@j
z(Oa9jdfCuwkw4$2&8-dRW<%S8-)vvMC_b096|Djx${?@*4WG6Hj|J@YT{@_WwQH7o
zF3&U<Jk*VNely$D{mzlO6K*)2o7%HAbfH(>lwXPa-mIx{cDbI|px#sc8z%l-10Cx_
zTZZKFV5qNmhdtOx82{QSut(~a+kXp-^R=R2GvWWbhe>DLRleo>b~JE}f1Z7RpXR+e
z#<E64IT{lXWd%?A6>^eP-ewpx1VE+4OGi$PJpJsoc-bufBqq=yqF+T>Lv4$0_3s6{
zQB8&2T>aID0#$y?%jLzopycbW@h-^CmQg55xrDme+AxB*eIO}D!1L|Dt(kn1ZE5@*
zlBOG~ldeNMtGQaq5@iCMrT+F#cx-bvBqmx98y3%KKg|Ppw5$c~*p8+>b6Eq6+M?z$
z`QQBOzxlu3Ic+AqN@8s1R75e#n=R@F38aL(itLb=X~Y$f4@XQF3hm3+ubnvqNK$Fi
zq#=@k%5cmd8?^hGeJ?F>p-13-l0uhH?aGFYOT`CP3M(smNteFpY3Nj^cgUMuOZ{^r
z&j>IGDB<t4rjWi8r+LgXcs?S2LMSHw>U>n>nQ}5=qXF4=vEE}EwI!R~&gbZ=gF`+H
zL^sf8tp0YVVmBsUfqOv1&El8Uty?E}I!L51`^QT`taE9&a>gLvj1}X@XCCe`)38%&
z*4F#+9dvbvoL2dZU!O^jPV*m~a2pge1WEHs{fis-`X=0)_+>#@+@i;JS8umIH9p1X
zfTrJz2YrUeq|*vx)a>5#BFasaJI~9~_N2v}TYlw0-pl^xFq+%uorvB(7j(8~A{0bd
zy}%wttxmaZ)ts;-Dh06fwjb9&VT5M!@$9*K=Dmdp5EFJNRGQ!6p(B_qP4rMcdohh#
zM<yv`(q7UT5fJdlaG9htKuG+n9<|dqH2vcbkvCM+vj8!vqu<Z-um36MM-;l?J%zK`
z_XOnJsUE9W4?*HX(~*?8+vPl?Bb>yp1OEupdpm@LHEQhG8-zF3HK{YDz3ThB7}1WR
z5P<#SBHw;m0R?B@>n6A;9)rz4zs-xcXIOM2)5skcUaNWQG-!LD8tKzitgcvD{q*9s
zkbwoOG=Vj~WzWO*kdUA(1o}&P!$NX2DuL3Xh7e#wkYl69t~yAz=nbrcd4EMGUcNBD
zk5w>1(Dm|C8CQY@hK3)jF{ZMDy3K1dp!zo}C=3pHalgZYcHQnGbR>zRd7^X>`*QF-
zIfM>R8(rNHKsaKUF-QLQ?}yvoJ(lDmZA8wy*V7!jlTB!(x~9#WH>{raFOPb#0r_#h
zj<)v5%y!fQ>s3PI3>*kQJH{NzzdGiKt8L`m3opvA+~Eh(k0#WClcZ9jdWIh}y^v!V
zlNzgRb+7;A5vR>>#*QDDnZ3VRt8=sUjXn%?NZ5T%J=~@XKi@uU?u8FS=k|OyzPxTj
z8Xv}VnVDDhzq{~&h@bse&GfxF^XF8=0RJ}~*yO!H*I{v7Oic0Nc?suMka)qwRj)bb
z&n=ZEy4sMe-}=~t#ZlYSJnZvgy$>7)kJNU_{qwC$ckbA+#iJ-vI9<}&tQMu=;o;Jk
zveY}Hx$zX+2}V1dZr-%%LF#~tYd;L<&YLHj8Q2UC$ur1%#A6SWUfb#zZjm8DZVeW8
zEUXG(V)Ufr<(70q$fQyABREm5QM(A+gqA}3X);<Qe<9r%N!la}u6BIYH$1<XGh+hW
z<we#R;l0rmZba-(>npGFGu`QBHE$v+?--me6f$e(ig!oM{qCjP0t$cQ%y97v06h~;
zB_>I0NmsW_;MLU|uJH#cM#MA_b*waHV6W2VUO3yMH~bcF+I-!*z3IvLrCt7bQVKoQ
zeQu#{|0c2ll`&1tL$V_Dzo}KG3uv?l<jlWGKN?I~_O%QMfmQsUVG$A9C@{zeUiI%P
zD%>ALk2$i<dpA?wQfJ+~Y5S+*jp~Wtq|;5iyyICOyHmDnmM*&9V!_LaO<U{e+)>`Y
zZ_ql;5@`<G*!1hvxZAQ8%0`o+hKvRcQbWaa=ujulBV4%KqD30;nj)OBi=ADCtdm$p
zLuQtT$9mJ1OFqL6JRaSjtSN33*l!Hzdymiw=?5?E`k5RmrthCW53{rk$k*#<xNS&}
z9v)d6T3#-mm7tWl=fURi@Nq9XMrK~rTxJ%wL|aYygV|XPrwPT|a?DPc{Sk1!b(eyB
zhaAu)zNmK-@Z7BN@K6U=K9j&3a6d;yRt%vL=)`?CU2qD8n)RWF+2i(Wj@8$cd(DXy
z{hi!vdjAv;6Y+^>5CLr5nLqMsPUV{)-VBqmJm<hppqv6bfR>tJ*haKOX7bmkA@AS4
zOXWOGoId^6q&wk2GzG$fEXXf4IqL~$k63nWU)Bdqr<k3Ef{L$y3&%}Azo7<5?7no_
zqo)?p62_GZauzG2m%Td@!F*OQ5nXnG^N?tr3Z6sIV(5HrBkO<;CMD^nL?}IuiS*ME
zGMx{7{p)gcUY+^*#Ikp~3zIn*kH=et3z4_q_hl+%o?pi1%Wd``&Opbvr^k8V+Mz>-
z5E?baQRa+W#vkVKeNj<yltiW?!bBpxOrcN;d{DM*kI0CwH@x$qYMLqQ9b~K-UIb20
zI(f7|5H<qBcZ})w{@=4@CLC<>x7FuAmscn`U&#R7jNhQL^l8zX_wUui(y282jb7C=
z;w}Y5UlS8nnvDIj(1AA|LL6~gUcu>Ca~&|~W}2DimPMaIe%qDJjl*9_u}2nbwq8$7
zY0kN}^n~eVP<EVr5IWG?OjmR6l7{h@o?RN`W2<~3d#;g*iSoIe!EY)l*Z%Xh)Guv{
zTM0~)<`N>g@JAG1VE2*0yI3!4+Xa5dZDyJ$&dfVG_RarFOM*&!UCWQ}rSJR1VK!j!
zQA$&XMpGSp%c)%wSK1XiZ#t28u<6KwQx~MD7C%gSqLT1Sz}RwqOD}7bJ2Yd2Ghp9=
zYyl%t(87>*J<KzH<~Xcv98t7n5RzQlWBUd#Z^^mMAm7150ApmwAPQ^Y%Luys$(gN+
zS0xgr@H-4QJ<EEf4q#$li;SQ`VEh(Y210#}cx_{@3A-e_93^Q=WQ1K3djZ)^jIRve
z_STNvP2u6vi9L4uwEG(d)_9CW75Rw#Z3g0fxp{M@(_nK1S506n#Kr^7>rDTj-VAAa
zKmBngNuL(iYf+Xdgs~|2@$#Dt27v=bDM8)nwYrH<n{XRp<H2E~V*{a;msD!C)8F2h
z%13xZ$hd}(K@{5L-Dp}4bj+PTHGi@GNSIyh1x<ywkIyS<7emJboXJcd^12LaQG(UJ
ztkR}|uh*?x$giq&pG&_zBEaEqW7`5O9si}pN?`;vvLsreV+B3hsvHp7^WO39+!nAe
z9tKiwG8qKaW6((S24}4L*u}QyOH+RR*Xgr9<gzJR4*ah&_ro%7C6@v8VZ(H2Y({#z
z7&2mp)77UFXZNj2LgmfLrXgDkA=>u1_S<uG<J9E*?@JdI3`@v*w<)XCcy(_RlO5k*
z&R=xZ_TKp(JMWC%bYfHI%ssnMkZsV;xOX}yZyrB+`=mY#^v`?m(+(YeIGoaV_qr{X
zJ1%wMp^7)3Q6VhXp~vq;N=d@g%9_bwCwObxKwn!3L3y#o_d>rQ6+45^gVwlYWV#!A
z)pUnh82j+nP5_X!=+O&4XlC4}&%zhCiqeA|4aKPDBidjYwc;u8KGI>~W&V>^)82AX
zflBi=Dhu5m!9JBdN)5*U=ZuZ`Y}!@rx_9mOXURAH>x%uagL62dw$an)Y(QAaP~P)n
z&M*YT<Wzo%=q4@AB}+beUbqOY#s^zg7}!WZi52u`C^mR~(h(<%U-UkCM6Q$+Kq4%p
z)kxYAqcOsl)TOW~qH!*7G9zwRV+-B<Lc~W6l4fQ;t-|q(NJL<pbzz1;2P#;B2F$kM
zg7$u!&Y%$*%Co|Ziy2W6a`MQe+sct-E^0vi?f;A!*^yQsM1V*|Df#Z*pV>>xE$8g)
zUTcTo@k><$ZMFMR=;Ocp8KuUI)rY1NO9jDx5qGEmd)3o{u?W6bvv~W#qm^|uHD#y8
zl|JZ+^c-=YQTzVm$DU!kXT;6<ocH9Z)k)U+Zd(-W)#SD6*hTSWd8;VW;luXq-EFC-
zmoYEM-UWHHE9aQc$5Gy1N)Jtc`@3DGk6EUYo@a8of#bzV->Rx+|8an@_E*20MFYlm
z|9HN2k(mJv)a|D<Q$B<ofRuqB?p#!6L7~Tz2A5~<8Bx^OrwSYwFSSEkYsF7B$n(ze
zna)3WeQ%|v{AD?Z+P<rtJp<%E(U|x0-hM68qsXIR3d(p*jxBgFdrH@qm#<v*3L^iI
zXUbls&>IuW2Oc^})fLNAI(o9c#9O&mGjzCX_clo|@?;H#=qgZ5i;Fa~IILdoq!s3r
z_sTqjwkMffQY@|JrZ5wfQUB2l2)CLnTv*Yz>@LXa!iDVe)t(+60l;bG!wlS^%g#`~
zOc(L*cjGl~oNUv+eX#V$hUWhP-(>4H3ynSv!$oAyUy}U}t3IYWlui*=pUA!FOUXp|
znD{qn^TaNXj-jZ0fPuMYn}6ZGuuZ39W7qJbm_m{3fq!#nGqV@j<GQXlolSaVrUs<|
z|D{iN`SIwkEqPF9D-5ZCNQN}%*mB4;cvHH5C1qtHum}VoyHk##1hq4NuAaja-}v08
zgPE5>eCy~%e?+cG^4sRM(OAZEG&E9_Bjr8f1c;Fay(QTOjt|-W>TgkTch9-ynP0q@
zm3`CbYyRRZxYu<vD%>d=z#)ivoW`5ZQqyiU&!GB4Ma8-?zi!n=o9O(Z@cz5cY}eel
z$mmQ$(0GSV9>B7&2fOvu9DvopN%Ex;8XSZ@9v5b4U07hEV+5Pa6&voyan#=)n!P{N
z!rLr=od4cN6v^Bdbay^gxvhP+HT?HOTR`H>({RRa-|QTnVjkyY>pDMsU&T9Fdd0bX
z;q~IrY}cDVt@v}z_EN`EYaRu_ykud`_yyTcQ=_v6wO(o4?bHSDFXwyzTRxf^b}6h#
zQ9t2Qa=A4bI5ip#7@)d!)ZfJm(5225#zW2_L_cd7_jr84%@6WOgbPRq8JFG@?FOP6
zVqepJpSeNz`By<YAQ*-Cqe|QP!Gk%EF>r0G-d(#1b%T(^|7pCUE?f|9RZgJr60A}Z
zA;HrhZ(cf_k|m2IWyN!MBV%JR%*A%hlAo8pyQQ*GH`IYWXZqF5j=BCI=hfS{1IpHn
zw6**nDh_;!Sc2(#^T$y17&MfG4TNeCaSaerW_tvq(LF>M*!zD49ldVj7ARm4?S%9(
zsVPWDm#Ajs7@`8(qS{77oy{$cp*}!j!}PZsH8@sQi<yXn1#(TOJ#=_-c%W{;^?NQI
z<4aL+Q{Bi6KT#DAGAW~k04CTO4t4<Z<t#SXZ@(`r)NNxTvD|CpMf+ZpeU^l*UEA;3
zeZ+;-7BFy1owuryRjm&#viZh{M{6Djc~rVp$ES=fx!u^pblM~b?NzjvVEDNQB0lBw
z@TW+`_wL*DXf<hMcNBz+M=tUy+i$347n^N;WYV}R<u5jjJlb;ObHm7YRXh1COfn5M
zD0&;We#pYLG;l$9l;zj=nZ~sAd5~axPuKT)lIHH0sgIvM^L_CQ!Izd(^7}Hes(86D
z_uI>yCyV!-dlJS&_Gvyi|4G)H?fZsEcOyqC)|Y*$yBYQr^GUI87xO?8gMv!(tk<*K
zckeowyt=(d?aQS}fVf|6>t%iiAHNfYyx3Qu#u|abfVmC;iFjZ!extARCODc4duqYg
zeQXL&zY&Gwp9nfYZSk1Gi4D*<1XsQNZBVa@9#DjXFdc%xu}ffHLKZ6G$RP|bz8Ch_
zR+%yfQc}N7PfZ~a&%W2%RF_L}KOuodNKMOZpwl<RgbkqqFSo5&NhLyq%wxfVwdt;b
z#4K7@el>TUUonJ-p8rpo>DY4aVl#jlfArX?Q#N2TTE2vq=}T+*AdKq@v3BWC@($Pn
zG3VtPM9zsG#t&LNc-q>K=nXLep&{yAT4PM3EygPq^riTkTy!~b0Jp)!ERtd;E%bRz
z>81ZIC_Ske_I~)kmCIzo2J$tiv#`kXt&h?E6t+UltT%2vueqF^&pC}P++W<DJz($t
z4MSTuQQ>pN#!l&J-r@w-9yBrR&G{di7!A4p-Ib0MtPw?pW8Z%LT#HL?XPb5(?|vFW
z_7^Xf@mq@u+?#!U3;y<_<Im*1&zslkjje|9I?b1hI}dg+I&kj$*oehddvVK4^K;8>
z@^xRf`<0Ecjg*xieoi!3>#lhEZYgo=ya7-nJKW~=;n`kqUjFmrf3L5Y94s)sSo-$e
zd`s27=d9XpLYta$_wHR4_g|!6|518l?#+WzVnlk+;}RM>ho<xt`)3Y_dF9_$R;f{K
z|9qUEf4{x)<>T~MK`k`Wg<HeRKx_kf?_p!Amzl$Df^DBpEXd2-c$8^|^XF6MUI@x8
z7F;4zDEq4fy^rd;#QX8WFexM%62T4X290<K`~OGPn}9>P{{Q1DC8;cl7A<7R5+x}T
z$G%1llD&i?BwGljC{oEV_9c4=St5Id>}0QOkzLA~DEYsh&iQ<=-~U{$Inu<K=YH<{
z{eEq4#EsoYwMYye2NeOHV8EvLcVwdl_=WD$te#QkpX7hu6h8bU@mMINnOlbG=;&~$
z$vbH9-3)}{fpWSmbm-22*w-lB2TcF>*UQos^}^+n=^o|ay<A4ZFMsV(IfdbqP(u<O
z>b3F}F>!MmXsasV^(L%N5XurY3_56aR{g&!5|&EtJpGL5&uwREtaj6X#rsYh`*`hp
zAd}cs2%rWUW}?mf<x#sLcKm;RO8&OHn70ij&8wfF6HK!m(xcB?y>z2|p#4cM*~!F2
zL->kOxk2cS^B#&o;v-xg9V1G|obD!k9q+#S*v`FsrIMzPo;cysIeK~b+&Alq4}8@g
z1t<O83Z|YWD4#+rI(Y80cTE1egHeqRgPNJ&Tvlky)DM87isk;{_}pQz8Tl$Ki%e>4
z8jj-FJ1~#*U#H`nE224FP;6t5z5ILEXpQCJ9biBuk`6YrHC;anRJ^aRPjFK&j!ICV
zh^9qG{Zp;brf^%i9uEQmwt+9|6aBG5)5ANWgmSmv)foM}3*aNRtzzQ9MA`rJ>Hd^>
z4W$-dzm@2t@Tis=GeS7>$GPXXI)_xWpQLy}(|D9*^q~X1FwQ^%DYur-U|#osT7a{r
zZvase_vwg;8<acfF8?Kw4hRbe6e?mI;QoULp#qNCmPk&GzA%rRLX;}&X$S{9w2K4_
z{%@@Yzal*noY)K8JPFw=P+S7&LMJB&O9PfWw0>)7a4ZnUyM_jNq$Q*`C$GCIg&Sa|
zirwS|7gd!RQKZ<a{?1_mJ%;x86z>rih{P%TL${rF`K#9p@ly~VkcY^_=^b+=mts~I
z!Xh^)Cd`E7FJkcE>aSa?j98#QYc)Lw+cW9_!V&TxX!Oe)topIDp>V`06f`)A<w;;H
z$oLTaNS6aihM>eBc*+SwBLo6OM{)M7%sTSMP!Zj4v4+qlXLpx(SSg_W#qUD6Y0-T>
zMG=gDNgSEz9Z^dNpl*N+m3MK=o&C1{sopVdRn;2Xch-ngkpWMP8O4c(Yi!yS1LPM=
z@p(`WG%Xh{ytY037?X9dArmy`za}C$h=|BJs3Fv8>*!@JAJ9Is>k%RLfaD{+1N$#b
z2>8UhP&MfeOqAPNfeaoFOobf@47$H_0K`9p{v#m)cHr@y8wo}Jfmc_bUJBQkhhX-z
z_U~;dAuBlzuRpwnnrbMd<+Zly5gdCp924S;@&-pn)r}ok9VE7SHPHgM!%gJXJX(SK
zkPz(s_(2@F4o!I;kG5GhDSlOH5a#%v6s3^WZym0f5Z)T~x+T!5=-`j>5PBck<)+vT
z-Q@wf<)OKz#eLd$_wQNVd-M=~FYb4Lr7VZInMiDss1v59rv9F_#w9fpju1yekV<gg
zAhL)NLrx>Og^G(lI;<UiQAa<A!-Y5_0Yu{W-Y+C%OG!UaW$=dqtv~id7}9ervF>&s
z;%D>!coVao?!hkuBZ=?{-Dm$2vIHIhrL-_yS;Sq0?eJf{2Q6_3N72XQr{Ts(akSsE
zb*m!MmZF2MV$EW-%&2^xDwFr*(o*xS$0jQiy1CBGPLM9a1SWCv<jkk5Sp#t8#&X{#
z24TVi04;8rp7e9qVXE#lAmbArS1PA|L7Dg#McNDQvH$?JL|T`Qjt^lgMyElH&?6iv
z=x8Cqd?H7Gz3Wx@uN0sUlTGa_4*V#1e|fw;on=_~RwCvgR}4xPyA-bR69x6y3BYoR
z#HC;@ZF2{8geskYX;a!{ghKHs-Wz+VGWt@F5yTRerZdmIzoU5sz5xc^?_`J7G4x=-
z??9#dyWC*yfWU%BYB)-<P-0Z7PCQV^r{A17RKF5*g+|I<jg(04k&^KDZ8PDwBO|-H
z14kX_@|_-dlSXz&y|+j2gGR&e$b#D`{DL^}wprVA2>|rR#(0ugTaolpa~BB^&f4Cz
z2@)f0I)A_Jz_XS#ay;s4I!F}bETZ#+BPIMM?_vaq+3D#Qy;qy!Kc%>hG<=x}J9+uc
znJ3Ygct_u3t3PZRKIImbz}tJbhvS>E3(s4P%ac9oPft>P+rsyE<%8I6{VYSU!ggx`
z5-a%IR134y5jF+X$bkJX;$(F``vEwE|Da+kdPyLxDC5kBQTU8~`?i4wtPKjU+{d<=
zg7aYug^4ge6+RR@ew+{>0Sv*BLR0p&X0S3o%1#u1QB*>6#wUmq5If;#VlWYuA4GKd
zOMPN8B4L%rLSrNxljw?@TqR4+rB?y$`*;)H*auj`MA`HYigS2i5z`IxgrnG_fPmP=
z?*cMRKXA4{WoW6i1Q9bD?~kX>IAd_)$?qk1Z~ZE`RdJ*Imr=<=r-Ad<_$Y&)AQ~+8
ze2gcjA|TPOjqU^3FBdpNr?FHUtyUS})AfdS7X<z#sOz951LtPeG6RKP!r9i!sH4%p
zkRHwpfjf+hAC~jK5yvw6Ol$|uW3SNQV#$6zZglC=0q}SqZfHT1O!VDUYE?2kvkaXI
zSfB<(3W7wmEt#%UJw*JM5ugh5F7c|-Ilbt~F}(8oSg^R?(7xRxXiP@NqjbT*SI=>r
zYyffvP@a=%<N1L~YLDdTPvWRf?^lPtoe%?D5hWDccc733glMbVbww2Z|BK!B>paki
zgni*1mE8rFa02HJHk_f?>Y${0TK6+(T!`1^=Ox{xS>2^>aT1f)-)_{c@DqzZZL^wn
zSt8nMw?>2bHtSyIJt_HXpNE%-bu4q|7=-=DYxs$azey&R|2!b^cc>t_<5Ip{ZF?jB
z5>O7B`rM*~*Fg@}&TJh`8O7RKakf+gW+(fk^74MmS@zF{J+4R3rcAk^|5>I*!?AI2
zE75VNfLZZH#ScW@OZ*Y?d5QW6H4EXV16H!_F_Cq^$$9Z?Pvyjd8xLD4oR@gRiEIRb
zcr+%?mED^Z#jhKyt3UKNkh(>b;BXe<8DUrQ3Jb&OIaYrECQ{|(69}sW#=QY?D{;PX
z)yBr$v;`!H99JOfR0dRyui-W!jz%oT{_HCkqc!d$x#1*x7UAZ1a(ZL+@-3bRr=PQJ
zLR7kdf&)|K?_rpf_y7wp@F}e+M*1~K3}PpLeog?00s+$E7bCzv;w<jF`Tf+$SM(B?
zB^3Y)5R8Rm=alP@kC$f(%2#YY(GB-3NTEX|7@TwGI-ds|?Sf3XH~+S5LJKif9F564
zRFP<`fbHCeTY-?<q2vuq=wwl&7LWfC@0hW<rPSWl^#z)ohV3!GqOblkAY#O@0vwj5
zpzM{f?WmfwxIWe9bOpKlz+kc;3kbbM(gg<~GAPC_x8W_FUsxb~KYOYn&etFcL{F`m
zQS0bB$ovy)mQzQf#a}@icEV|o)AQy|52%*!oc{^#Yh<u?OZ<!ISlgY)nfe2Xjcv)j
z`0bWgVOBdw*~GfN5-VHHGrc2jsJ(C%kZl@IW(_TS6~-UmeYWR#P#5$|$t$tZ6RXW1
zPqnEVGcYoy-1OB$=Xc@oj;CFd1o@WGQWK@SWy3lL!(j@K^=RQ$v4R!tK@BLnqjbcN
z>vX?0y16H`yC|Dr_h^qu10u;D8sIoC{^sDQ-N8U*5bYQd5A*1}N_3sS!ih9OA9#Fp
z0?GCpaSwg2zi*#!`xxdXhIfbNY*Dij2_v9BVV4$}xq|9vo0x*4A{U9Yo`_k39ph~a
z+7j^_6D3C2AqWo{Bqan<4lDT`;8{S%L6%{5FgDg3^CL!CT}L@{r?iQ%81(DmHw6|~
z!$BB8AmR4xAEvq6c;m6L@$ES&2m2%(RD;LMm$q!PAOa51snF68Isyp&*G?yO!wPk<
zDONgQwZAW%PKDe#zM5KGlwOpc_Wj%V)q5AW{v&=*u5#i08kxsF3jb8@JVxuZW}VD>
zJ!dxEf0#@!_D*w$oUhcOtz5@_LE$|8#eWJ}cZ}eED@(~ro5;j}lZ(~A%Y?64TsAu8
zae8qM-u?uUT#?+qhOe2w+vjX>bGaJiU+aII5Fqs_=b?bz8L87eK_`BExOBZkM|S`j
zH}mnz+i%S^9={H<_zRJ21L2*TJ_4FcT?YMlry*h=gtrR2_ZubY<+D*Y`dm+ZFPRJD
z(0HJzxthoF&*Jy~Yft<v1XkJzD{)1D3OBQM>p|2#I=jXYbdw<=^_$CV=770yqlikj
zU(5(On?^h0q29cxW{_EewU|GUXfqMNE23$%&8U({t`n^(F){QUzh~44M<8sBIy%Q}
z&YNi({dtZU#--H>x$ROJln(nxN6$WDk_{2Fc#{z<q-%d(=*Y9M$MNrHxpqC`iq=TC
zZ)s&uC95WCLK+gN{H!d`AomI19D>3C)^dicr#a!2O7HT2V_T5kI)>~|yW(El0;-RL
z$fNjEntM^Nt<pi(I~4=}z{Z5>Jik55`Mrcjy#)>Q^yu$byh$uEzn#}+cj7reoqWPs
z5_3R6z$JTomX<4o%;KKwmzfi92M*)dG0hH(P)cJQs`$Q0a7Lcx`@H`7hvc9d?zD0&
zw)sAs|CU)Q@hK&Ws!EyHFc5velOh*0wS>RTeDBVE2sMvS;m#Y8C2OyEmUG&4d|%X5
zGiW5;*jsnQ8IwCU>is^$MB=9NlP9!yVv^o{MNaAbTIKCpTS)Z$CTW)(9CAP12&8!|
zKC%OifZ+Uy@Fq$vcTrK%W|H>s2_&Va-4Ej;hXo9SxMKHtihA@O;ixC5-RaqS;V-!I
z1omHIEG%aI;r3$bcaIap!CH2$D!g%}r5;TMyj_KbU}O{9EKfvh;O0yF@@!uhptxCv
z<FX@x$ZjC8q5v877ay(dB%)u9L|nDQqB2Fw8<I$Wjwwk$NQrS%ZCvzXbf*z6`^m+z
zl@3447#1y#n_sh!etMkSEVUb8I%dmEi$!j6F5ZKW)oI4n+mo5aTfg60{dKu4H@AVX
zq8i?uda2A4<TCw+j<EZb%%!whmdv-R{k1<6!qX3B9w!O;EVl435WZGG!MvrsUs}^Z
zb1N^K#7f&k&)BY2PyXPIb>%YjdM>JgY7HWFuV3FDW)xT5t_By;#oUh<azAQYsS5d#
ziy)>{-=@w`nx!-TDZC~ajS^aQvia~rUJKL(P!^?KAD{nXhUd>d+xX0F@Cs%%a|Yrq
za#s2Mo{AX8;s#L#gKyR6g56fBnUMAvXWfVipb=+Pr3xxIQdo;|Unq0OFMqUV8?f6!
z6I_DXh#m9RV(BBoY!1sw8$-El9{BQk1WG8hH;}9`YqR3Z%rkR7YoTiZDB%F5%wqAy
zw;TjwiBH}RypYfZvD8sWZm{=x(mDn!B$hj>*^L|SZfG(7l;Il#9XI|!e09lv1HHEK
zf%}S?^Bsn5_KgR+qy!rLo-fs9k4C=R_k$Ushlx85`m&I@h$NtVo85hGlZU89g%D;E
zB-raWB3~$0uWWlIP(CU;`OEw`sg3+mf+iz0<w!fMgrouG-d2RP8?0EBfW9NRJCv{;
zWm$j(Asyx~<me-tTUl+wvDQ}ELYT-=^-ZYdz>R)aG)*mlfhrl%XhD1vl7AU4v&(4o
zjVBr@X9*TtQ<9lC+L1ER9QqtkZQQ3}WS<ew>`<((u3p0-81Od*2=ecjn&USmV_ZLK
z$cAhqbnb|p;Nj)Pj^l&+?!%Nb&I%$CWjzhYjh^c-x~E)-eG>Apbn^h*QG|Bcwt!fk
zf>P67j15<I6QN*(2lg%b?z$ln4JkGfMXE!~=1GQVtB&&PN$Yx7Ty+2D5L-dm49#-&
z5F;6N>(A29jx5h(Hhrk@C4YU*Ro%1);S(?>*?lV<9YpK*?pOb+r|SNC4wY~Lo|QHX
zrbFGGLgV&qJXWICj0IFAl+biUd=iY<spWhM%1(ubh|3zzD^EeQb_KHDhB{{^**=B6
zwyJkhT+a(LUOi?~R%yp4oe~-^AS%cxQ!!wtk=-VE>&N^&t04O|l5<2cxSfVEH}-()
zE%qrJqeX07Tt4i-gNfCryNv^?@1hcy8+^8Tk~FqJnNu5}OY>&R;b4x_s4I;)S=c=B
zWyF4J)+2Q1sUyYh_EUmwWrtb$FBvyTCjB5~=bpEx3N$Z%iu*x|3t}qm#lRtm>Yi!q
z88!LKbA?4k$qTYUwjHL=!{&bxTWX+kC3(K#exn5x6xvhddw?lHvC(IBrIUA;8eh|B
z(J~QY+IUbVoI|2@ul)Pqiz;IetG^(fR8Dl4g5+K$K{l<$vw=5<V+8y%3$eoQC2FYj
z2jjt*+O83f#<E=mJ3cu7sOkd<p2xN-6Z}N)z^+GW+!fFo4iKsotXG}z>yeH3P-86E
z8L+qO8yGO&^g0l&k&v6KRqM(%GSySK4ZH-+R#kBT1ZnNdsOqj)GAmtx$QjGvGJV{t
zCVnsI6Cu^Ig<)UKiMSC^BGPaK^AH*ca6xk8%h)^-@?_Je&;y*D2yy$%#kdY{FIk>Q
zCnAt?J_<%eMp6&EVIv)cQxW>1sS?}%v9V_|Z@2U5l9jy1MKZZ5FAECx{TSutWT+*~
z)_()Nq~OE<f@F$n7^nkq<`(q1F<{&pZueJ%4+N&a>|6ct!VqW#%Dd?gmjVXvFbIXU
z+`KHZlUV&OlNkk{9VG%AEv|#n{t|ID^No_!Y@kBu#=i=)cz+>T6O-5h&eM8&;i|S$
zPyokxE?Y`2k0lU5E5tW;J=d!TfLT=GOnCqyx$x(`PnLL0mPesV+A{oZ<iN_&t{-~6
zcZchL7^+Mt?eh?AyT6goOSYEe5WYVo-P;-o_T*IUK9-r0oGC61MXo^0?!m=hTZTW)
zQ5`~sST{9}xj>mdG$lXVt|fITJM7{fjg+<*8E&m9QW-@>`qY@wb*8c##U+_)xntj_
z-T+tDmOM;38Lhz!mvTqI-$$41x4hxvxrZ*YP56I4x5<HYX=FmJm4~zNefP^htG<QT
z7W9wIsXega9J<Bga8hiwnSAAg<fGJ_TqP_te4OA=6l9abC!)IumSAw^6@MvaW?&cc
z0vmaZ!%rUWM|9h9buUnusQ;2~c-a442`a4Lp3-;~Tlmt8+Ee{wM2tdZ6n-MbAFtOi
zZog^`M?&b%<I)`c#W#d$1effmvd=f{f2cY*h5%@2l4xnt1b;Fsal|E_EiFG|8Sek6
zwpImhp3C|tTf4VSXIfwEKyp)~T3rKP6X94Tl4!Jgf!;i6w4gq8Z9l7Y5pf}e#0vI8
z>F->CQxoHCCTbJNf2zJOrY90(jQ9&(v6TJ!ot`}T8}>tZ+jLDlwzC^KGG`V|@MEte
zj$oSGm@D%cqKqi#^7PcyH$=1KKEPlSHgi)NLffAWm!<9^dce?Qp@Ud;Xbc^de;sAV
zX83#b)*s%o<&Lbiuk%C-Xo!gcgny675rg_d>PL3K!0)-{YVpx11U5}9^_ht<3U<zG
z9wnl|5W|CtHRDfH&@U^|UF+>$7)HdbO-pH*t9O#!YD#is6L8zg$e3=m)k2kz`6}Bf
zOhdX*(9P^$HLDu4l&nYcSEW3ziL!W;o1foFUKZ3*S59f$km}&*nD_K2U-VMCNJ^U@
zD9j4y@zfZL0X)n3ojpH7SqqceZ)PsNL^m82Podgre`ORn$R$HP)>R*@R+r?yb%Z=x
zs2Vd#YILAVcBv&aCk_<`yEo~~8mdM|s>O6qIRi_jsvh*9nfOi@zIP*S`|satPV%i+
zdB<8P!m;%L>QwF1D%!#O9BT_nt@hZ@M8f5{S<a4HU@JkkGD=KxYVdMwITPwi41joZ
zfeDY;&F%%CUpW@IlsHsWKTNia#L<qs93?K4l2&^prAId8KEGPVJF=^3LBDL(z=!PJ
zXF8Iekzsy#3$g#ztlqzKkdwhTW;wAw0U|8ja<_Wk<wHJZ6{twe&W_jHX=(;UTtoZ3
z;o`jSfyb|jsX*|Mp{`utbGHg@?nZD2gu5T=dG*~P+WQN-A9Z$~bNUU@faQ+NtgP5v
z8xG8jK!F%nL_{1Cu@lIoyYpuM<CEV`aNPPmbK={pFViuLB}DR#$&2|H(45Nc%G`Xz
z(eWAG8boZWvQb%ecc#2h*woV7`v?f6;Jifx1EIlhl3pcdm#R@^sUi~a1IXRHS$y#i
zIt@aB_-gts!{y&GI5t-oOjeV)=c~?mE+9}&8hh%NHV6m)wn3;TD@1oHpk&41lb@Bm
zQeGg87ztaq-j8eaPgnO`Vf$zC>&Jw>rfYrLq(_&l_l?-RT=shK`$Kh9WvNvMKV&=h
zAEkzP>hH^PU6z_j+|iO4tg-jrF)^_;hpcw_v*W0THig&-pK}Y;=+7hvTsty6l62DU
z^X=gPp`i%<XYD0@eu5aNWHxZPzuvyrfT1?#T-dfRs>~9@FYzu{6tVtLSB)5rOlcoh
zJ9J~~iy?9G-%LAQ9UZl6>$#5me-#u-juNnc>>DMH=>guF;kt=U%G`If`OU-MUGu34
zd2``R61$oKd+JfvO?<U_O+IkOpn#{nD??KBZ{N9*_OpE<GGbE`HAIdp?`HP9VQsDc
zG6*{ui5|j7zH!}8TG;8h0?#CMl9G;cY-Oifb8Mv5e*2<_5vQ}x+7v@!B*Y;<bOTzP
z3x}VLFl@NXUz?kgLw<?TzF1-+H_*43F~^5q?MkYJ^z#DR%?XA)Xr)PNsuIDDKq~LA
zNNdly^z45;Q7x<4IE$LJrA1J3!&<NPeL+<+LWK#4#X{-B-&_4<<^q<Yc-7EHjkn<u
z5pQwEZdOUiD*sdTDTW9y`tU-A^ms4w0~m~*^9u^PM5>&ieT68Q#%?<FkG*Zg$p<2|
zG=u@p5E^NQ(w$~|U19XSUP}snHUl5VR>aPwsv6f2N?pkMT&7N_hc(VO19)m)>K8%p
zg_ohK(Q$G`iD$MTW$AlU(rf{*ULUK#8GRMrCHYEnrAldfT3W=9#c%4QW<!-jM*}q-
zYz&TIo<JIRGr0(2Ez4BnqrE@EYf^FdSv(GYvS;7EYIyW;e*<sq$iq8dX?jG5Kfm4n
zD@FdYP<7^wxHC2OZu^=3K}{6jCVN4nn)U2vm*c}^vsm}>2(I707c5?u_{vhk=xJK6
zw9j4(ldZXNmuuelO!DduZI%`JUEBQBHS1YFwpzKWyl3?~9nv+*IdtZU!&|`%s)NZ<
z`|O1tJ${@vr_^*zr8n5Awovd+^z(GqHTq`imUCQsb*tNo+AXQ?#vLV?H~GvaU#}~w
z?csWx6|5eM@(ml5%>i`TfyxK<9KhzICq`(vuVO;lo^g?syaH413zq9zAK!WN)Jl_U
zT3;oqwGTHw_IQHM!m8uGh_;MTDFCM*r+0%Gt317ULybi)u)=VjM|IQKU2cz)x=Gjb
zfPE7S#bd&Pp9;^YZc}9g;8<!U+a{l6m4xN&&(e8x0he#wSj@Xrh#>5!YOTlSDDj~a
zhRy2^fI_H0o9cd`XE7m7s;(mah*;B82CD7;l0~p-tUpb!p3+84XC@ApB2?FZCutYo
z$XXr-lCG_i;I?)gbspm{halE~jq$&=tX<I|2JeqRxr2IX5b>HmjTQn$!M(`eVvllc
zRdFauN@T+BgSKX(>|;lV52l?ZU_ul4IsBY*w}T8E>XEiKHVVkNLQx1<%XCL<mUhv<
z2YU4^-Bvtv;>|Q!GmBS^F_0V4N1`|qg0L}<0G4RGm*jSLC$mzb$(0kVn|8iy%u&Ii
z!OfEW^#Na(tpZ;2Y=V?wLtc2zVfzyEV)!iLM1LW{s>%M_tQ>zdJS93srNOqGw*(b8
za;k;nyV3@O3aP&ysQ>(3qwEzSc@22prhl#AL$yax;YV;@P55Dh+R&q?yI9Acvp!I%
zX+UK!Bpkn!Gxt$Vxc%drB`#A(p*32X9l=8l=xKqNEElp!_$TG$ux!0Ar_vmEM%k~4
zOVHn!w@YkJ`~W#+V^mJlg~J<*do!0e7loNT&ul5IO9)+d%O<}l<aUdrj8|!VSyd-$
zBhJdr>(9!D>>x@xN~}B=3U3|8RqQ}i?$mmUi2ExwD=a+FB29WlFB1~vJm`zxn;S6F
z5$&;3Ba0>Y0{9}IjvNvY&>B<&Rzgu)m<j(QD;};+WFc*^B!&PJumO&y9^2y>e_*4$
z`_#m<1Ps|+R^ZHo#4&BEvwH;XWe0oE5{qG1hC#K-4PnlMzCyzCOs5E_1f((H6XUaV
z#TmHU_SG6x-IE+PoXprs-uL#}Fi8~`72%Udp!?<*7X?zgrkpQfJ41|~!quzkMWf?i
z=A3$C!om*sL?-pOv|Rkj99S`MMw%-}b#2D8XJMgJB--1m%7Gf*asnUQRM$R|=i0z&
zptQGSg6pzSVVjj9Iep%yk>or=kxJUe+%XaJ-BE&SD6y^9fyXkeiaT(Gzu7=t->OVQ
zc*@ww=yWaK*R9OC!KO}Igq__%d}TG5lAZ^P2(joO8fIvS8wx>6$!yZ4x*x-8)xpCV
ztw%CikEzMDcH(OfIL=v1Bnw{CsLs<je!P#<;WXb`$J7<~Nx@^a`A=wUItnP`560^Y
zRY&Lw>1r1AD=!r4)_BNN_G6uq4U<mSddPf2{^K)>_ptF<b$X}IPdUCi7o*ur%?!0R
zP5z%2V3G26d~WIU;;(@j7byKV+bEh{D13KcmeWZ%_1UvCewlyQhIa!mb`Cv7?jRNL
z0Xr+#l)?gW*5n<M_ELkDjW_^}$^jh(skwEs)gAcF#17w|MBbw#f({X94ccZx?Yh8{
z9BmCs7x<Tjf883}=0^)>@Me}wsS*rvTv#vt#H7v!0plou&KesV&;J4pnC{&Isa={U
z#I?8Ynv8HbwVypP5_XB0!%5I-1k!=#{<CxO<rSA;Rk26~UENShVPh{iM4H#O1*5@A
zx*7UTAN+gkw`_{9XF$`5l!q@~bbB%8N%w3$&gl=<VgM)bixIIUm>?eg<&e>*^SxQ~
zH#^a&Zee_s#Bn|IW~cifUo&_2p6MHrLSEnCgoQN4st=OnihjEhdDoCTyt!U_dmBis
zBW^a};z#Ag=PC>xbQ`XYIQF@d&B|<qEe!m7^G)+}v0>TkZ%Rva9Z^%E&KR0L)Jr}T
z9L7(v!ubR7)xIbU*bHn)elIR6>TM<xK37^|oJBd8`20mM?F|eZ5*EJS|NVZiEn4`y
z-Bb7Khws!6!?);FF>o7Ay+riAuE|5HKU-7AE0ThB#lBa#CtcESJV4>$ob!qj=F0Z_
z$zvZWbVjYHgxli5W?oXG!tEfZ2UmC}+16-=rui#0F)~LcaTh7SFB;?6<U>;;pinPP
z>f#FgW){uW;^%m1GDIr;R^n7x*64kH%ev*nMpXl$4JsG5_{gU9s@x2oEX>RPXaCby
z{UqXas{T@|cMrk%IC-8V(PDS;<-%rQXZL=;`dBXlLASJ;IXS(QnK;V0@0+<Y(pnF-
zDb3Lb<a{6bgNuq|CFi-%Ll;R~zArV?P^WJ;=S`}#5jv8xgHMU&WWVPx8zPmNz^af8
zqd|Hs0o3&6OFm2Oq5}bvEHL2sE8anJy8N|kS;MXbp61jOCgtWLBje~A7aB%)LAmaU
z@Y`Xv8%y@?sP#N*h30O}MfRJysqdZbExvj4CJ~DszTbA?1_qm69a&hToq4tN>-`wd
zn903`L|JNF8eu-JZ2Y`3n5@u@x+9A5`}3h1vRN}UfR@sqvp>bil2fEiGUuBNRj&9X
zYV3q=I5JR_+~7R=Nq0r!+}JDj;%n$7>z7wqWjAI6Yv;dSB`G+oCb~<<ytDe<JElj9
zM6-)sKC_prqVmg338~9QEK)Vz5w)~LG%&OYrAx2hd`I8HYAv=K8!JBf>P*;g(2EAD
zCT;Fd555y)%jb9bT-!WL&AB%DA2|^r!bVz<#_;udH_#nbDQj5NPpuD)h^KE5RB=ci
z6iphhx?A&RR{HV0!V6Kgiq_cF_j;R;28t@Y4Zi7}mx06NeuWpVvHV5LTlW1#hl9%-
zycJhhxdnb8x!Mje7f_$>R?Sjv<+MBOqh0qv&2k0^*fS`?Ef%V#2Wqe_N$e#A(1@pi
ziIK<$!00!W8`!kdmu$p#6G{)TocKpXHA-Zp5(Cb5?{4{5`bG$1KN}ws<oYqB>OA@N
ztF}qV1jSzHi0-llw@j1aw-r<$=VHUVrxbAx@#|b;6Jlo=cie?KA!PQMxQBM7O?qZh
zl8?!Y#-ptAq3jki!ND43`*wxhs##kiaCT%lTjtWGFD0j3n#@E%4OU~RcJymf^o97I
zlGpB~A?TRpl*0bLK8=A}I~|^-M#Bvk77>wSc;iTpSzMQ6oZQ}X4<ru^J`DB`wQMD7
zKiB!$uZ1kaq#1?p^NIEDNCt~ITUaB{7577_-`Jxc{7t%ivx}sZO(|DHjq|YTbOUva
zuNLQW4#)fT=>V?~w*=qN{#}n?-IiaO=11lQFf~^ItUBTPDxGRPLHrrlfbgOk8h0#u
zmZ*jxJmuB;!d_b^lS9}uP&lc6YE41<)(1<jX(o|a<vXP5%rPEH1o!3%zi^8F!O?P|
zEI%gRQD>}%I~%XQE*=lF-|9D=%+NY}JVn{AN-$P9Flg<<;A_F(b&Q^kDj6f9=Pego
zyVf^d5w&8HJP_z>Ze^XVT+EVcpHDuXbZBxCBYcUqA?OKoTh@XqoAl27{1du{k#?cd
z{!gFWK7>3W8Vu~zz{uLmA_J7r2*(8nRDY2{OWJp-wX-w1Ox;ie`fO4sG2pSFKzC0C
z76}$t0*Li9YuiWX;-JLXvSkZ0++_&yZDeH2hY!A3HiYvE5rV+vA(MS0^R=f?%Lx$*
zWRE4MTi9hEOU^1oFMBTOF|4MWpw=*SymJk=-K@5f(tZBZJuNL>C?Tj9xP~Vcr1T5z
zlVlY2ztO*PShK!mc>Vg8-^565=rl(eX;IADywaT*k3F{*d4-cD$q`Tt=>73kya$<v
z_L63C?_(HdurI~EeCZTHTLc&U!uuG(J@Q~09EBXMQeyV=nXk*>Msmcq>ssv6jUrdd
zg7YpMhF4>g90J@>!}}qGqlBE|nDqMviOqlKj{{wvey`FryVP<=DOX7|$>;>B#=;8I
zW)s4kW=A+h7-&evG~YL!FVZH}F8Uzj?TAi{7(n4Ja2G&0_@f1LEO>(60G3j%63icZ
zz8z%H|M5X6Ba@6DJRf#0MnQmcRY&DgY;(%Jt5#OQuXMDu)`iw5RqhD9N;4Fltai~`
zkhY53fGtAIU@~x0KDB{+Nu*ygNk}u??K-DOa!oMJrew<rdo&beo3qPB?c&FdC4IYl
zZmMvHd}VN1O+_pFl5Xg2g;(t<-PU3i_Rht<FO2V3#Ic<CsDbe_#Ns)J&epr(B$yF?
zCkR#9aR>9eYI#e~t(yjDPR$8dn@`WmlD1a+bid-F-0U+Q{&A2@aqVYpY%(~#@~{Yy
z14ZO#dU%w&8P$0m;++o`&kYmsaA=LvNxkS$jwqCq&R-8FK1PSK9T>9qq==fD+wuP4
z2mY|LDyt-nWTMukrZ}A7Xrm<?Sy|cIj)Vq~WO0UM_pEP`rEdW!qP6G|P@O=|&)|N)
zBovn!>RGVdQcpC_wMWre=9ra!rSth!K^Leizm;R(zT+DyBG3fdJ~?2%b9|Kl+Exzt
zF<m`9@r-R=hr6zV(0p{W)R<<8)NYzmJ8u}~qa{FpEHsS2O^vVKctT3=baQBg)l1E)
zuXkN{X*q1<Ogf`n)OvsPYM+bbW8gAK36!H8nQ|`X{3sOJ$o5i-`IwOqJ9t2%j1WaR
zKd|7Y<E96cbgkFzWiPM(@4Aas|HUdH{0jFB$i$<4?6MYjl&=)M;2GtZwq5&F>hzy;
ztRD|`i8A*-PaZcd=*T0tY&%TyI1|f5f9G7AW6SA3&itaMX^*>}W?@*vV<B|zLEs&=
za3CrQ(}F&-BGcB3!%_SH-4C8r(crMCiAPRbJGt`xFPsDS=)Q58EAyuc{Ty#2YRHq}
zqEyw37cTrm|8j)#15Y4AFn}j*sdp_kCfxhDusAr0!I#h=0l-W?ot2uZ_q5bthei6M
zj;=27cl-ASqzg|X{%mt?bk5e&q3k{YMuZc|U+9=nX!}dJB-Qx%btC#wY8=!Id%C}<
z<OHh>vB*FXD(!J<=dk`5cZoDSxpoY-NBcVU&%IX_gw~)>_UQZ8g7Pn9u^kzWM1h;0
zUjM{!V)0iCR9yd-w+Tr}>xpqW*p|QnfZt&6b#fQy8h=vM&evvUNa0*q;$E*c($bx=
zlUWOFIOhzR%$*eEt?XgAZ|nUEBpmS%v|9C~u@=YJ@wHkB%?E3^nixF~9Cu4g;dZUd
z*M*vI#ZHUGRX)C>N-tMAouOcaJWp0V(j`^vJU;kb$|&Dt)v&=biS_<QJ^it_)EEt3
z*%0HV^P#8ZMOx}#sYZmk8V8ooyE2e$C*nV-^9cx`np6~v)ETZZcaw-dR~r_tuDGDk
z5Ztagt_e;lT7$q(2V`IM+UmGL2v6iE2!*N{>Gs+#iUyWp<se-Ne31BkzUC+7aLv@B
zV5jlXKk5g0KIXj7`>4;@M#nB}&q(=^%6qK-loCaFxG%9kYsiy#>Rh?-gJ8i$&2&c%
z*H!X+g$pXLg7Ym%YyF=Hsx%aNM`?10eCKGijA-TkZ}|)pwMNaw(~^62QzI!k9}#|!
zLxCWPMO#56?<jjsndds?lnbFQZvOMxrt1kqE&{Z0%qWEZJinPs>ha^p{4Fh3uP_`9
zsFJ{%Rx6jX`b8mDx80N9zMZpC_wK=!<v3yYI)_+H30Q4$XEq`kO(SI+4p`7UsDaWR
z)rDr`3y7=bkJeh|;yQ+|rs)1<LQaI(XtcwGX%UD7p|G=Z!Li-Ad-DcDS_7M^j=tVd
z8X|3>5!mZI_ybX7j;=?x$>gC`f+mFbTluOdF`g7rbTJi&@+@$$!}A=H8Y?2yy8cP|
z{7tNS!ZHTIgLuE~$|oCY-657|f0(+!FKB<m@wbEfJ$?%MtaLg9vmdooRz0g-$xEKk
z6QnoBs%)}A)+&afeqL}xdXu*O72w}UIDYuffz$kogG#{itBq-eb@}WLUl%Uvj~%T!
zE+sB*`HJVf$A%;x$B2}!&Q7xaelxH0&xYzvJE_7Mg*z;`4A#(PbwN&mu(z%E*Wqo!
z=U71`1V)IFCP7H($ezL)f|i73lFOQhg&wE6JXc`6&(XPs4neCXvxs>dF+?BdZe2U5
zsF~1ie%XkljU;L$wytmciv`zBwV!-wt&No13a%yly6_~0t@+~moWX3iAn5m@4X^i$
zs99b%(nk>E#4Qe^%;3fCEn8f4joVTJt7_wV5=QLx`G$&Px6gfwYpU3{=5JX7WPZ>K
z$h_Id3#8NfwLv4ZKQNmYmB+*yCm~A_)=elaT#f7d_VRzUMxF5B=Lv}QAXOrDPP8q|
zMmZN7kpeogIIzsH6{+S?TWwnpEjYHS^CZZh4OCP(C#Kn!r1JUmI$FNFqt3;FwPxCd
ziD1I-R(3<fOq3{vg?jXA6#XtN30w^Y(zkb}*_LZlg#t0hIgKs_lU(;-!ncmYUIK|8
z!KV{LV{~+0zP@QT6k7h9M7YWfp}>Rgir-QX{jEQlwuQ(KC*sCEm)m0B+7{p~|1uZ5
zDv5~wGQEBw2TG0}%@iu;oM_zdxIZ-35TrwxgBLmTCG1+N^Ldni?%%)PA%bg&@iK4@
zDPFpiAhXs8_Yr>l`yRMc|Lix5JL2zilqx|-N9Pbimq(FMW0pYK4$Kh&P1?&N>g#LV
zXH%`yJMtUMBtt*&<tU=KQb`C@ro~Z?-3@p#5;UK=oem{q5C!_2ltYmLXf0x!5eAkb
z-wx~=F>2HXzO2c)2R;1s>0Eg%vJZU)lNfZ1cHm+8g^=xdJXPq%ctz2LBqC*$eDJzM
z^7&e_+n_EVCB#s8!F9nbN1kg9Fmu$-*tXE&JN1TC9z*wnlM;+AE);pyY?WkmTK*Wb
zCc4j#%L)4`+<hPN{5lUxJha{iU5>X%c|Rk-CgASgM^rR}EIrFjRK&dgp#e1n*~h&v
zGHiQQrq(?i4e2wUcQ`A3LydaG>qgt!HJ8$2jh*%Sc}@-Fd=N9-%q2N7I%r)(wcqkS
zi`^}<z|F*{D0t2ni9d5P*J4}mEzHSgwk$7kP8pP6n;4CW5_Y>8dbQ|JpS{rdVq^Gz
zn{(w^wH}(+M(y{W_p4YgJg_Lf!tumGKBO_UNd-0b-xWPZ6iZCofYPZxWOXIe)?qg!
z#xs{fT6tnh&8fUU0Eq)SIi>meY`C<l!OzpuMCQ}e(-|XYL*VbSDp%m5&Xz1sL*AMv
ztTW~OOZ1}lJ&f+#@?}|)EOCvG)6d<<%zS6(^+H1w)?jn^{S;ND=s}V3hvyRIZDmJi
zXa1E>hCq<PUnj})e_56r$F+n~hd(a;<x3s<T&|#|l!xxsdv1J=U0sSDurDMMV|(l>
zwjfRK^x1kclaVp&0bimT15ZxpIpc2v7-#p;G-56GG)vB@t9*yw!Vd<TsHA>EEvI}q
zn0DN7?U<qQ$yp=zg);FaeHOJwm89joVTy~9;5qWBIyba%ah7~T5=T|W=UpTrpQ<qv
znTWFl{da=n9Xyp_mN~tSvibAv6zOsi8j7=mRt<HL?Bhhw`aIL>3|d;(XQz<Y0Nj{l
zfk_L`S|>y@)nc;Gt5b_&0VXQPEK!Ce_Xe;WYy8DcPEn4*Q2~}Pgp%T`JZl&6q{7Eg
z*6fIVqEPZ!MUi0=LvYdUB*sZfh|sn1@sK65v%f-U`uxRHdo<Zq9S7w1bq=!{4YHh7
zFu5T#qbkq7QhI7HBalLwSHWMHx8C2f0)Q_wl&hikGEZ!%JI}0Z&1KGN1L;nmCoAlF
zO7go3d27r3ybn~%{s1AR_aKUFYs4-ds^#SUF*%r4e{MQX$Yf$VE`+U%FWBs4&_JQS
zaQzcu+pWhw7KRPT=~Y`NNwG)%G*lIFOszko$n)>g!bH!1WP*Wa2A&r@cZTN_$}vdv
zk(_19Cji!!q&zYBOphlcElu{{;KlZef~q<IoM7fQoBBBx(WKr$71vg_zq5+j!8E;N
zKIxoudrukCS2j<nne}2@g#cVL$cg)`oTf$4{Q|;_n4Yf1HI6Y2sg-JhQS9po`pP%l
zyZ|S&Tz6o*Nv>crV?jYdbKSb`tC@v=L(!ndgSZeFh)~J2?C&}0)uRyFJ-P9BXLP?a
zMuaRDe=A~OJT=c0rIEs!p$Ao|NTTUly7fVZ=KYPMKE}(vs%wE|MsC|_4P`L84WjS_
zJOOvp)BKFAEJgyzTsH6P2Ngz`flwLXPWrFLz~1-}y&g{8X0^g)9}BQGgtUP5o#_!O
zEgx5+j!5Fh`;-&mnop6+1I!<03w-b|o%NPgxjhdWz^!!RgPOR}DLpM(<&QrIzMz?)
z34hi6sr+)CN*m0;clKbng+^-Lu4dBh2%mfIq|VC{hR@n1&KOFh>5QACcR}K*R~Fbn
zKgXwcDDetcgZ%#R?-x&*=Q6o1KkZp3pBemx*EA!hj;Blb)G;k%c0a9<pvjo$S=xG#
zeDE>r{Ly6g(~?)ut>j}#Hf$aa^9|m)dBc_!MA|V~go=#V_Y}Q;p7M1~TaxO^cUmLg
zPU$wo+OVRh8N8P!rZBU}L1e@_x}u0C<JJhC$op;0_vAlo4*QmJ(XD$orxE(bF<W0+
zb0O~^qs*q4r_E;KW7(IN67k@gl43k^byVazKF?W}a7a2e*)6tPTIzjwA-BoIsDGd5
zf^!CM@x<tT&#kq~^ZWLWji!4x)kw^{>ZM@_^S}F_xF`WL)JO(tMm3PmLZD!<NzTna
zLN6kZaxgL?g3XD(NS@1UVBjM9^VBj&KsNU@%v91T_uV#G0uca#Cb6~fo?P5}ipvEA
zZ2<hs8am4yk~E*QQ6J|PFm2Z$XCUbOK0DBro0tR;ZGC<|F+>i;Mg<^3$S?9ft7K7v
z&p(&95~A9W0@;E>h{-R5&A0yK4qQwIQY#W($(Is!2TO4$aLbtC90GqjcV`R<DR$j9
z1q0(LvG>}>8zSFb$^B>t;V60wg3f~BK}$BKZCqO=93<U;Z3RKSq2qwjDQY<FGNh%x
zlulTvwD064D%Z~=((dll&vqx;ohntApQoo+AT<Rq`__5s-}NNR#{mJO>VCo3(_23;
zWinG}!2u9R1E}j`LbXqfv)EC;;Sm)PQT@D4BJ&XnzFa-|gqEn*1Su&I5%QVe*(|&K
zcS7|55SK+=p(J<;q?xKRC8wOLK|@2s6n79#duY(|)aUY+f7O);|Jx&|YHZqYSM|&$
zto`d6bsPN+Cl}ndkTd=)9gcQbddi?(Bx=s~a(>PzRN9eGp8bX6_@=`TINcs3^)>mc
zGz*TD9Nb_e(z2e}<2-w|Jja@cIU$=T@2F;0Hkh^^b&6Bi7bBn=cx2cisQDi$Vawxg
zk%2$BawzWixL6w#MN2#%4(GOL9UXQOZ?b<ld?I3-xWWi?i_$0WyfrIFO_VJtvf?Il
zAvrN0)w5Yg4*1xM1s!2mi{w&#K;`vk4!)d|DMyuH++J!lQgj?O<Fbc(D6i95@@h+v
zrzZ7gil<5Ycb{cfxf#m;R;Auv;!u84;SG@N39pi(qTnyL6lq5`I6+u=NiQ){2u_#O
z_QRzh_3zD8y=!j|9(Xl2J2pLi7z$HjyPwV2C~m>ARY}8DH1<4y+t%v)XF<{3b8N-X
z={O`yBb<i6L-Vn&<lf`lmE#~Z?(RP@mHyvwsjF8jz@}Uu3RH@R%tof}6fX-sd;sTF
z6I=TWuEn}N30C9kFmHt-X;-VBQ<MfTHcvv|{CDyL{J*wL8hoJN9A)N-sd7M7AH&<L
zPhV9v-4fu*iY}QIZWHY;$W^eF%ki(oD03&*#t`byTer$tq!Ht(W1p?Zk(QC6V+4E-
zjhJ9kGc*?pdR8x=FzJmQ^B`!k(PL{~u<@?*qQUOXvGqRiz6_;R!?tlz;tyW9=Ts-u
zxmmz@tHuYLHOW#!gZDxbaWr^O=+JwZL8$!vIRVz?z7!n0D1IjB4&o6`X#}68{m$ap
z$F~pPhdRy8II*xq3e=z|G0+Qh@eZ?y&ecX>jRSE}In8yaZd8sfMs7RjoJx41S@6eT
z5ytICn_A479oEJOMU0Ib7172s1TMQRT=eif#jMV*Jb!VelufJf;*#Wiv!>KFqfHdc
zT+U1SNlqbmIHbkD&AN`?2`~&DnhW_N92>dupCU8v)fC?_?$}uOZ&ln^_cjeCE*)Dj
zj6VH<x?|L;@1uKj#lo%bik)*Fa^?5JV3!F#KbN!2xOLN^^!{JOg8{>#laX)jvlrhO
zawU5<*S!>4i4gCe<ofS`hJ1bV-=#)U$0P_=<wg-pZk9JlZUikoVSlP!%s<h>OIsq4
zr?G8;PLn}JBs_{IK;JL1@LmSf^>$UEEgSA)M$j4hYp80`$6LLMk2h`F_RwM-vpqOf
zA}NeOI<Vewjw3yWsNN~TXj|+bkkRmApTNDH=6)SE16*VjkWUlID%C_mprg|frACLI
z8Pu^NXgs1ThUdbv0^f*~(KcX5#M7h2=`y)>s_bW#@Y~4+6oD3?<%kZL&;uiHLnOgT
za-m)8#N_kb2NB2j2JEIhYpiWwo(9+_W7^Wj(a6`a?1K0Kti}<e4g5Nv8jc$)e-6CF
z$@QrJ`|*uuxMrZLCplW=>R}H9c+0m&VeeDi3l;gS2bjil;x}@*StSWcFQe!9{dMsd
z#OXw&hP4<&N?U5HoY&p1lguItY)_^*_UvgCu&etKS#{gccZi!SNI9F!v99#>u>EPZ
ziM&s@9PW&ovIekkE80)LBPpm*HKn~j_k;Hf!*2U$4axIIw()6cevPQj=MbtHy-XUR
zqG#$nvTc?c99jncu4_^!8pIx0z3MMsU6YWfdH34tE^a9lM*D&f+}n8RsriG>#moWK
z9RcfZkGE1?V;e^EbUsBd{fW<NlPuTU5h>tBE;o)$(q8$!<{@9sNTTkF;gMJ^i<Tq(
zHzS&J!^?QX_su(7+E$F*yr-wp9(ru`%+vQd%Z1ukKDtv<T=nK$k4KJ8Z9klEGw1qr
zm5KPfmFMqsa`~KC{yS;G=E)J7Hg6_1c|&aZ8?LttQX)*cMssB=nF5s*V)9glwqGY}
z9t)xrG6ep^SF<kF)Qr3{0Lk5o3H&=7H>uE3>=%n9`P&w*?-bJvr9&@?st)?~-Gl}y
zIuCUgwvaQjsfktF-F8elN<jRST*pgyR|e|qXE_~|^9N;#GaIRX&qHQUbF;vmUImh7
zW`Ob5tFd8FVbJx0rI{h7I%BR9QopyYZ!y2qXi?GZ`Qs=N14U#U6V3?9)!%cNrY7XJ
zr=Zt)x6rH4cS>?DgOWlVM~ccH*a#we!qt9TTU$p_+YbgZK=MvKA@#2S6*ZX-izJ(W
zDt7}^9T1>CoBf)jeu6_NtcI5ymuURJ_sfFYfZd7U_S8__f{)hlQ=spFkRAOm9@97q
zgAWSJ?`Jx*)>1)Xz2x5JJnuT}X1LIZM1zL>;92836>yqV7XGfc=vN&jGFZZKC{Qn4
zU^|h}auC%nSD<oBtCwVADBYjg!(~ri^9`zJ&+ThsjZ{6}J=fSNVZU-pY?}qe^mq`<
zo7}?8r2R~jrm;fewN5hZNsigNp&J*j?v~KJKtr>uPeoov`;O3T-GUr@==0>-1>I!x
zT)l-$Ps0%o2dVPKf^Kl~ncU6<{{KUpKdF^E<$MxcW6sCt5j>_+c4zcij+kUFplm>)
z{^T7;KsD6O9ioLJ^==L0E=T#=q_#Dzc84Vi<UYSbIvCMir1wfRODnct&|^60nA3QD
z$<)Y{NI7r#sRouTDz`Q1lflX%^ANwrwK+>=@u8Dq<=5iO=Tu@w%r77HYJDg~nxHRz
zJuhafq1aULe91HTnqKZRz5iD5|1DD{*@nL@vB>2y6`OP8HiZ)5%~4jD-=%3^OZ_5(
zg#6>zT2mzr83DK|CP3q^HH*wuowmj-P<FfCIn+wezE-Y08>o~dYUk=&s2aU3PWx6y
zNlDL(26vuFRlgCmEd&<@&<<jCBIyDl(&%{FX9CG}RfCQa9iD1+Hm6TNQa!XiyuAm|
zlAcu0A7T<Zqv!Nph0=mVCCp_cOpEhvno3Y)6UJbmIJBjezprMM-XmfW7^Qz7wiYw!
zqYM?+P-iVko@}a1!F01ll{?{JvEyS&**sZ$_Z&j1bXdB+%n+@z{C-y#p|!krXWE%%
z_#hmM)?kl5{4b!9B;SN)ocaQqL@28O|DpYcI8l4q0J?$hsdFqLe<cKp643+_EP@7E
z`>nSx8_Eq;&%-H4*ksX(t&@Mv9ETBFe0(zOB9ME_#+_+-J8Iao=y<(SFl{0yUMMw;
zBxrQ5#pjU2a)?k<xI&nrxkh8Gk5GDpLPV(0-7(Aa7OC=@@$JK`4y_?Vw&6)aMn7At
z1atFr)ZemS2tFIaQuHFR;8gAzz8oiDyi-b<4zJ(*2-QdlROdlKq!USXK=Axd)o!RK
zi3zK~6c<B9hG+i}!iu#s>e(NyCmcFSwXpYm@`LdVDM;!;laYeFzeKvix+9l%nQH_I
zC`O2e)`~IcTBO#wYlJsTzjn!7+h(qsYiJ?WmGOf*RL#FVKg@Ejw8t>(s*sP0fGVHf
zwY{<Fu8d9}lcp2a{69;~VlCk4jhy~$u2+QVgSZYL$2Rr43e~^L6mho4AL2#stmHA`
z&z7aAdPv2_eJyStCA=3oIGB{+h9eqLl|v@uJ%#^pv*(`Rub?#XeWCQEFc{hkGSDA^
zxU@C_aFb_wznyhMR_%3E&Cr18k^&UoM`V1VG+H3-(i>e(2O<mNG5!%fD?wSmfB!_a
zY<qU&MDsqCpLuU#bHTdZABtAAWaiy&g=^_ulT`>Ru=_PtkdT~gp-3750CxS8Wy-+2
z-PbBFOU>;h#u@xXJkUePfj<+XE4Nc~UakhCS3Po9%5tH^t3c#I05N49qVi7<JBhh1
zghOFsAYZSfS(n@^DG6!5_oQr&mv5v-iWarz<zL{1zvVP-f}_MEgzY1kBi@ILc?a+f
zRDM0S1)N50qjRbACtRO>w>trw1D5EKW5?D*y=Eq-vaZogg#VOA<|@~^36@Ko^52-R
zD`zg*@7ZRl@@);*F+X|M%^R>y=}5!B!YmwA`+D3l&4c=7O@pMRecZ^Q{2ur02JMaE
zweGpuTj$&@{H%{$B)yFY+P3EEMN2cY%Kd{trC})oPDq@xV*8~BpUnI<Q$B#w&P*h=
zsT{Z=T$9IyRLVr2*B5hLUPrgOfpS$B3(WAY*?Hr(wh6ZGu6-~{>__lUm6A$p@YNU`
z>MZew4E1$&!54(v)_L7lRcGUC7vyE5@HD0dR4E7fv<ft~Ch92~PYkKPZX*32j<9vo
zSlc;zEpz-_D&^ew%NkTshUMD}FDoaEpECTq?IdzF(<4l+VXAY&J$pH}%DsuEEy*NZ
z%$EAhs!aEMw28&eT`z>njT-)hHCGw_lKUSzh>k>0U(nFQ7>hNLhT<(2$#>GC&=Hy@
zvRKD(D>Mf1h3zt{vpexnn_tI~D@xL(EvR>h^I~dFs;d$B576xQ4fUmBB_qDS1c9<s
zCFS)S$Acd=PjzS{*UG7vYG=p%0nojr+6Hs!2$2>h(g+46db_LS|5r0&djx8Pdzjfz
z{xI+~9QxQlo5y~lTO2I=^{oOE0s}DhoQXHePPTRu5*HZ1&&A`+ql5otd}pXjv|2;A
zgzlsoH_JV`Az~fY((^{$*3uAPkLioT#&CvF+6G|7xOeHXIM3)L#hq`so-{*dPf3h&
z<CNEDT~Z#}xHEJSb8MmChh*bU+qk?)xM-qva+@V}S^UV6i%*XE044x(I@G&YWtWpg
z^n^ZdY&Py$o}jaLQsH0)cY<RNMK0Fo`@X)dk&PQb{^sits#4MwRr}b7ni?9ryhT?c
zq{YQkGk4!UBHkw0+MpmpI&Adka6NC4i)k58L=wA7On$_16O{pX`cMlQ#ZcY(#pWBO
zZ1#R<lhk8tB^pSdGDfz4RMAWd&OZ#m^Sq$NiSP39Ay*5OAECS97bl0NI<}BUy85f#
zHR{EA#|DRFFXevRO#h~J?|hyb&4fg<$u+a0yctv!Iw6Lcw{o`TwjcDX;(DsKn_7N=
zW=Eo0;OjNd=8bc?El7{IpR_r`tvtdX8zV6DL6xcDn33k0{I~AL+aqk*Hm}dEJb$IA
zP_W?1q|&;=<WZKv%Lc*H+Rtfa(kC;hqE|xPy~gc{cSug|?!~?7KWwSzZKUWLMg`AA
zow0l=eNHy1<In%vVFIbHvG<~nC;l(E|E;fhMsrVrTSnNDn(Jq4>XmcPOd3k68ZLQ0
z5im`SIn2WsLoRay`vn}qs@&mp(EO3`kV($+ovwD)-|FS&$iL860MGr2!p|4`RPZNl
z8V>g}e*#v21`u&T_BECkp+?R-38Dn<3655`t-57DUS<ts7Jt*9ALasOk@;$HljNVD
zU)Gz~$oig0s>i5#HR?u<B(iEN?Nj;FD&GXQXLUh0Xu<SCex6CCV%(81M7K+nau+9h
zs2Z@J)sa7P%IUpDZmLK_?&&ygWmxI@a1`&zH0MgGdr{bsEz~fURorV^;Z!%}ygTG{
z5_v=1=}=utZDO2}+MRU4(8=XcVV~2&aW*`mtQ$C3U!#*2G{FiFnH1%1Rfz;ua@e{!
zkHI0nS2m8}VPV)Lw`xio%I>&)xys9LCKq<SOY*1_#gF~;7yuDp383rad2*mp673+0
zI4EwSrInD$OBoZ0e^p~hSt}S@P!sn0%}qOu8|llZ8w%O(<35!e*5y$9sH!YR(^+uD
zX@9}*^Is<mxoc&!*d_8Ayr_pa4rz!q96J>{f0>#YcCCo&8+OetliOXOMWo+RAdvY*
z2x;!LiLKxB|7%8x3$1$hf7jXG45RO~wA!Ld?$?Mx!448NP+2~y)lZaf?L8q0<p-4D
z0#;X~7RI6Ue_c$zqZ~SGe9ru!zs#-A8Pcr67U%aCL6Qo#R6pc9mF@?ZgNiHU@>^ge
zIxm=9*9?C-B>hmIp(aO{r1M9D&HoK9$qa~Ls^h`x)*fkXfE!KXqa0A;?3pd15uBtv
zAqLHP&L`~qyBfw$^F07faA)lqDfyE2dckJ4b891v^MQJ$&z)wMH~)z8+gr@2GaI72
zl3??N`PWcydGnNdOWw8|woQsUWp}2oi$umz)p=FJpuJXS<i?Ts6wW$NHIqsMnh=qU
z#NrW3tv&rKa@tK!W@f!7L%MtJR~$Jl6eRY%KH4~|Yrn$-^+S`?g_<IHW40E(_n|@8
zY0?gbw+SyaZ#{8vY}}@`r&Hm_2K$t7{W!H(ZdR#FJv%u#1V8+^>{f1~9u~A-&Er&P
z9<G~DooGQ`-jGM>nYS0?a9IQX`Bq7G;4+IFA7SZ~&AenV7PjsGsbAoW`36@UjtLH)
zf3uj~W$GvswT6^4B%Dhc>mS}x%e-i0-Etr3Rr?E}Jl3O<?8^E<@Ioa`3h?tEM%+h&
zybx@xjuNL5SjKQi{vG-NgcQ@-x7|K6^$norJ7NSV;>h=g8ru5}=Rjv$g%R%$@QgN*
z6;(vzpZXh+K+SSrFI+OcHpXp&kI?rb|3Ujs4UBojWSP&A{l9sLzxg|b{#(%`EXpZ1
zlTc?&_ph$>|9p463@Xeu#56x-AXl4*8r_4AipWAobb?R!)VoosMR7TU<KKT_Je{wm
z$AlI-F(3|}Yrys4OD><>HKmpkt%@Or!gLZ&4ErEruZi$%8au3=r%>5r@e(CDal~Nq
z#XxTC%JTsS$|Y!3*Fxzf409gI!;|3ZldSyBGg%lQ*OU=jm&{->ve*>*;uR|ct8diF
zSmoLoL&0Q`cex6jZ#3Y>0P^o@e(H1YrC?2Ry+!W5OL}M)9J#Io>wS}VHtxgC0-eGk
z!}HXDCWSa}naIXu)r`^j_fkWYP5!v(?zrgxzZ(yiR048s+=FB$>=Ttwe3-QTs|;H|
zMEP3i$aWf1bSib<7-s6pe^A=%N(*m~TT3?&*Qg(FjPKE=6A5Ou<`6Z#8c&X##yh^D
zf2rw4up>POYm{x-l7%EP2q4>h3nMR{@3NMdZoY<wa9sR1JBuJ=VpqOizP_^1bqUCL
zNRrl?&o}#j?X@i$=RqbokuObX93Y%~go29r9z;q4F`Ho!wWmDNp5YC6^xbo@m>By>
zm`m^~D_>-k<5Eq-K)wehu1oXHzPr`?ZgC)>lW5%kOy8IOjBKMSBD?@ba3UYZg@~8I
zgyNB&Md+f+e-)Si?fyYmy)qQ4Um`LX9GXwD6P8G0mx1-vOlQoVzce?}Nc<-7j}l|(
z-51hLs*ZIT-o;?korw2Hnc25GvyX^EWZt~tI$qu&yuDS8$NL`=FGknc)x7r3Soq}_
zY|mcoChpf2<DWs!h}Q1*-JDRp#2_<q2Z^}tn4mT$b}%W?|FoAwaj!yF_ki7yAg?uv
zqEh%v_WYiGd@qg8owF$1TIzjMXzQ^p!n)xD<b&KFw{z*%4w>>Pa$~@boAUot*AbiT
z#_*E_|A9+iyPq$8?v2Una@U<Z&w?wZ#uJ04Q#Cy{!Fa_7aTN_s0K|_f-wO~a;J*5+
zzxtZzT%={z7DmP|@F@Sqcu@cm@677|*WR^%Lz##1cgVIymqY7vR!zHSt=6rRwp`LE
zY|d(z<fuJo6}9BBim^l*l9a7en~+$Qaw;SgVwC%>+Ck1v3dtn~t;#jVrLmu9Xt%}g
zU$A~~&dfXW&ilUK@ArA0@AEvL&j%H>BM=a7J-NEN2s?n|02;TQ&`x6*2ft^&L|oGQ
z$j+v<M1Ex!uaJhFRxXCE`IES+=XfR-$fM}p>H5?J1Sw*`0#D;yy8s2@qidVB;i@+Y
zGq6W%!W5p4!dEL2f?GGIQ3lm^QZz3rw&1g&9*mTXd~c2UA{Ij(FHiT~U4S)+BxUrN
zgorL4t{+xsS^&4^D|S>4tbz7V^}3!iHP`dhz<GXugB!E(L;<qA@#F29ECv|cHH5F#
zXljD^s38afxHy3m2Aw}48M_6le3-zt$oTQk5Hg4&IHt^ZclYbA^=wjL#Dx=MrsI%4
z)+X_f1VK3)1?trSj{h*F(q$-6dh9CgeT`*7-Zn$z6IRLs@PMWe(SISe)JH<e(0fab
zFn6^|%NRtt(-6bNsDHB}%2`0_+;#Z}4K5z&P;>AqmUEZ<RBbdDF|?6rOEFqrVTR5*
z1{pDzkmRQ#In#m}$71ZSNiqa_vR+$4vg$pepK1v?;^IZu-R><rs1tmoB=IK3n*m9=
zO>yAEH_MEX$2TVVQ}){~OZSHKpf}nMyuNZK7#`DPpmKFxhKoEc*hU}WxBmSPG`Yky
zf`aBGBG&Njps){P&thN_Iuf!qRoEl<EqlQTH4nk5R5J<~=#b=aZ-?pA6v@NgPSWI|
z*?k4%!`$nn8DJ+srupOj0xlpvgxJZHTr7`%#le-d`WTZm1;_(fF?!Zk$^B$4`0Wv!
z71E!<K!_6$jcPJ6pX;9ZxuLe!Wh9_r?^(A|{jL2wEPu1rjC_#StvwWY_{i}j8hVl)
z%>(gDdHSKZKaLM3n#wT%x5_hUKQMq;TZQ)sNe0pS=YScv4R=^ByT~LMg|>w3<eH(N
z=SuNKnw-9Q*dVsvGnK5Ogbkr`<8q=hnx>gxdZ{Ee!e)DjfP!IQB1|A!+e3n;{zMH3
zZ|7p&Ub7WdVA71CTDKwxT38c)4Lmd$k`t4<tl_5N0)tKjIR<b^XeR9R80!qdVxpNq
z@(VYCZBReZe#Xk;tfV`=kh3=z2}x$I-FD#gPNnli+WxO@KOwFdt&#oN*!YM+jd_w-
zKv1D;9(|lsQ&*R?(=l^T)r|tS)Rw&eFZ}9)zixv(1bq*hTJrf{2r1D35IoJZ-Ouj$
z5~l}#q}Ov|$P-PZOfX?lvEHT2OrV?7?(hUX$GdofXkAoi3`g1{JAK$zNKlo&sGM+3
zZSJ{8c?V*9LV8r(VNjU7^Lwm5(AezD6)E$?rR;4bUD!jCpdB$Mn}ULYi|6<p^kU^2
z=Nv+W*1+qaxL@!l)wAjWXN1R@YND$^Iqh}cfOQ^*H!gDc@0!WG8_oD~*Sk51;%cm)
z5%$IE4Cn<Egy>Hqj)4l$Z13X@WyY6NtU)b-(84XDmI6c$s$_*oGLPH`6)ENyxT5+(
zxB)Tgu@H$0LHmRK1VzvlP-)zj;+DZfa!Uvj23vvE@nI5wJcN!d?Db*?R9Qu}+a1X}
zBC%sGgLae>B0kB(`ViNIaYCVC+DU>5Uc@qmHIKb%F)U|-bG@C-`j6l(+iyh0tUQLU
z-bS)=t)WUCqPH^_qRxUCY23HiTNUz*N7udP%QC$JM~Nb6gtV%SyLEWzz9DuQZpl2&
z7Q6V-CBWu|ZCMdYX4$=-JTyvdVz}f}<ZXzb1;kkM<Epmx2IlWvS%7ug_5*utk|Y7~
zf~|l9PvGBmIgDX&zq%5UqePAtoNi8St5-{F82baJF`zq@kI?QW5Md;!$OO}688mvy
zVq5emyBU6o6usmMn>}-TTrc=4BhAkx5+d}sZ2~r3#47>w4YxwgwdHzB+OOI1@Kh=w
zG3=%A0tL-YNVx^|N5(H-{Gk&__|fVM6Rn??*KY-QMN5{@x)e|P>hBzjnP%O2*)5mM
z`j=*&b7<Dw_in>_Ehher`cb<Zg@tT{C8U^%%C5)+ophjzF0-{<DtAs`?{$GjtPfdU
zq*7(!Hy6qrF3L;1rVKa~C~z->aXx8;kc*9t=k0!33M@Zn4&~EsS0i%4G(ftH@Uqa@
zL)(bP-b5tdNS<o5Uhb7EqL~959$PYpa+0Cp8XHh`h12h^76ML#a$N)vk$1UZ52^AI
zb}YfQMZMGlku-J-(5i$RI_8Gp7rjeNk$%rigSPPFm-6{6>HE%HeUw3<t56fSah5Ak
zleP=tfGWx!un$4OlqtkEo@5r_0aXGrXMSt(RvDdDHq!SM5TiNx*4p#`xSpaMU^mNW
z_06Yd@63?`Y^Lne<kbHE;5!pH?MY;mdFc&)AkE9@xWZzbIodR5+DGW6&c?~8GE`?d
z;>Q<eo-(tXFM4^l$J)3ZU8klx{NK;^OpRP-Sm0%Y;8_k#PO?h9$^FVKR{&Z%)&D$b
l&79U7-1M)f4zF*UV5J<kAItJc3TN>5^;gywX=Y9#e*#9)L#zM*

diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 7887a30f1..9d64c492b 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -36,7 +36,7 @@ ibc-client-tendermint-cw = { workspace = true }
 ibc-query                = { workspace = true }
 
 # basecoin dependencies
-basecoin-store = { git = "https://github.com/informalsystems/basecoin-rs", rev = "2dd5b95" }
+basecoin-store = { version = "0.1.0" }
 
 # cosmos dependencies
 tendermint         = { workspace = true }

From 86a0ee0d7c245592307b9bd7659bab05526cc136 Mon Sep 17 00:00:00 2001
From: Rano | Ranadeep <ranadeep@informal.systems>
Date: Tue, 14 May 2024 15:09:46 +0200
Subject: [PATCH 174/182] Release v0.53.0 (#1224)

* exclude ibc-primitives

* format release md

* add context for rate-limit

* fix cargo release dry run check

* update on release md
---
 Makefile    | 10 +++++++--
 RELEASES.md | 65 ++++++++++++++++++++++++++++++++++-------------------
 2 files changed, 50 insertions(+), 25 deletions(-)

diff --git a/Makefile b/Makefile
index 7947b9501..fd1f04070 100644
--- a/Makefile
+++ b/Makefile
@@ -37,10 +37,16 @@ test: ## Run tests with all features and without default features.
 	cargo test --all-targets --no-default-features
 
 check-release: ## Check that the release build compiles.
-	cargo release --workspace --no-push --no-tag --no-publish --exclude ibc-derive --exclude ibc-client-tendermint-cw
+	cargo release --workspace --no-push --no-tag \
+		--exclude ibc-derive \
+		--exclude ibc-primitives \
+		--exclude ibc-client-tendermint-cw
 
 release: ## Perform an actual release and publishes to crates.io.
-	cargo release --workspace --no-push --no-tag --exclude ibc-derive --exclude ibc-client-tendermint-cw --allow-branch HEAD --execute
+	cargo release --workspace --no-push --no-tag --allow-branch HEAD --execute \
+		--exclude ibc-derive \
+		--exclude ibc-primitives \
+		--exclude ibc-client-tendermint-cw
 
 build-tendermint-cw: ## Build the WASM file for the ICS-07 Tendermint light client.
 	@echo "Building the WASM file for the ICS-07 Tendermint light client"
diff --git a/RELEASES.md b/RELEASES.md
index 17353e95b..9e260ab10 100644
--- a/RELEASES.md
+++ b/RELEASES.md
@@ -24,7 +24,7 @@ Our release process is as follows:
 4. Bump the versions of all crates to the new version in their Cargo.toml and in
    the root `Cargo.toml` as well, and push these changes to the release PR.
    - If you released a new version of `ibc-derive` in step 3, make sure to
-        update that dependency.
+     update that dependency.
    - Verify that there is no dev-dependency among the workspace crates. This is
      important, as `cargo-release` ignores dev-dependency edges. You may use
      `cargo-depgraph`:
@@ -38,41 +38,60 @@ Our release process is as follows:
      because of release order complicacy (except maybe inside `ibc-testkit`, as
      it is the top crate that depends on `ibc` crate and no other crate depends
      on it).
-   - In order to resolve such a situation, the dev dependencies other than `ibc-testkit`
-     can be manually released to crates.io first so that the subsequent crates that
-     depend on them can then be released via the release process. For instructions
-     on how to release a crate on crates.io, refer [here](https://doc.rust-lang.org/cargo/reference/publishing.html).
-5. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
+   - In order to resolve such a situation, the dev dependencies other than
+     `ibc-testkit` can be manually released to crates.io first so that the
+     subsequent crates that depend on them can then be released via the release
+     process. For instructions on how to release a crate on crates.io, refer
+     [here](https://doc.rust-lang.org/cargo/reference/publishing.html).
+5. Beware of [crates-io rate limit][cargo-release-rate-limit]. It is 5 for
+   publishing new crates and 30 for publishing existing crates. But the number
+   of our crates has reached 31. So we publish a leaf crate, `ibc-primitives`
+   manually and release the rest of the 30 crates via CI.
+   - Release `ibc-primitives` by running:
+   ```sh
+   cargo release -p ibc-primitives --no-push --no-tag --allow-branch main --execute
+   ```
+   - Validate the number of crates that need to be released via CI, it can not
+     be more than 30.
+   - There should be a 10 minutes delay between the release of `ibc-primitives`
+     and the release of the rest of the crates on CI.
+   - If new crates are added, we need to recompute the set of crates that we
+     want to release via CI. The rest must be released manually.
+6. Run `cargo doc -p ibc --all-features --open` locally to double-check that all
    the documentation compiles and seems up-to-date and coherent. Fix any
    potential issues here and push them to the release PR.
-6. Mark the PR as **Ready for Review** and incorporate feedback on the release.
+7. Mark the PR as **Ready for Review** and incorporate feedback on the release.
    Once approved, merge the PR.
-7. Checkout the `main` and pull it with `git checkout main && git pull origin main`.
-8. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
+8. Checkout the `main` and pull it with
+   `git checkout main && git pull origin main`.
+9. Create a signed tag `git tag -s -a vX.Y.Z`. In the tag message, write the
    version and the link to the corresponding section of the changelog. Then push
    the tag to GitHub with `git push origin vX.Y.Z`.
    - The [release workflow][release.yaml] will run the `cargo release --execute`
-   command in a CI worker.
-9. If some crates have not been released, check the cause of the failure and
-   act accordingly:
+     command in a CI worker.
+10. If some crates have not been released, check the cause of the failure and
+    act accordingly:
     1. In case of intermittent problems with the registry, try `cargo release`
-      locally to publish any missing crates from this release. This step
-      requires the appropriate privileges to push crates to [crates.io].
+       locally to publish any missing crates from this release. This step
+       requires the appropriate privileges to push crates to [crates.io].
     2. If there is any new crate published locally, add
-      [ibcbot](https://crates.io/users/ibcbot) to its owners list.
-    3. In case problems arise from the source files, fix them, bump a new
-      patch version (e.g. `v0.48.1`) and repeat the process with its
-      corresponding new tag.
-10. Once the tag is pushed, wait for the CI bot to create a GitHub release,
-    then update the release description and append:
-   `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
+       [ibcbot](https://crates.io/users/ibcbot) to its owners list.
+    3. In case problems arise from the source files, fix them, bump a new patch
+       version (e.g. `v0.48.1`) and repeat the process with its corresponding
+       new tag.
+11. Once the tag is pushed, wait for the CI bot to create a GitHub release, then
+    update the release description and append:
+    `[📖CHANGELOG](https://github.com/cosmos/ibc-rs/blob/main/CHANGELOG.md#vXYZ)`
 
 ### Communications (non-technical) release pipeline
 
-- Notify the communications team about the pending release and prepare an announcement.
-- Coordinate with other organizations that are active in IBC development (e.g., Interchain) and keep them in the loop.
+- Notify the communications team about the pending release and prepare an
+  announcement.
+- Coordinate with other organizations that are active in IBC development (e.g.,
+  Interchain) and keep them in the loop.
 
 All done! 🎉
 
 [crates.io]: https://crates.io
 [release.yaml]: https://github.com/cosmos/ibc-rs/blob/main/.github/workflows/release.yaml
+[cargo-release-rate-limit]: https://github.com/crate-ci/cargo-release/blob/4b09269/src/steps/mod.rs#L214-L268

From 587350073d2a649d154f67e309b10c6ff5d28f4a Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Tue, 21 May 2024 10:55:12 -0500
Subject: [PATCH 175/182] fix(ics-23): Auto-derive `serde::Serialize` for
 `CommitmentPrefix` (#1230)

* Auto-derive serde::Serialize for CommitmentPrefix

* Add changelog entry
---
 .../1229-auto-derive-ser-commitment-prefix.md        |  2 ++
 ibc-core/ics23-commitment/types/src/commitment.rs    | 12 +-----------
 2 files changed, 3 insertions(+), 11 deletions(-)
 create mode 100644 .changelog/unreleased/breaking-changes/1229-auto-derive-ser-commitment-prefix.md

diff --git a/.changelog/unreleased/breaking-changes/1229-auto-derive-ser-commitment-prefix.md b/.changelog/unreleased/breaking-changes/1229-auto-derive-ser-commitment-prefix.md
new file mode 100644
index 000000000..4b022abf2
--- /dev/null
+++ b/.changelog/unreleased/breaking-changes/1229-auto-derive-ser-commitment-prefix.md
@@ -0,0 +1,2 @@
+- [ics23] Auto-derive `serde::Serialize` for `CommitmentPrefix`.
+  ([\#1229](https://github.com/cosmos/ibc-rs/issues/1229))
diff --git a/ibc-core/ics23-commitment/types/src/commitment.rs b/ibc-core/ics23-commitment/types/src/commitment.rs
index 25f4ca579..bc0707d9c 100644
--- a/ibc-core/ics23-commitment/types/src/commitment.rs
+++ b/ibc-core/ics23-commitment/types/src/commitment.rs
@@ -141,7 +141,7 @@ impl<'a> TryFrom<&'a CommitmentProofBytes> for MerkleProof {
     feature = "borsh",
     derive(borsh::BorshSerialize, borsh::BorshDeserialize)
 )]
-#[cfg_attr(feature = "serde", derive(serde::Deserialize))]
+#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, PartialEq, Eq, Hash)]
 pub struct CommitmentPrefix {
@@ -183,13 +183,3 @@ impl fmt::Debug for CommitmentPrefix {
         }
     }
 }
-
-#[cfg(feature = "serde")]
-impl serde::Serialize for CommitmentPrefix {
-    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
-    where
-        S: serde::Serializer,
-    {
-        format!("{self:?}").serialize(serializer)
-    }
-}

From 5d1492dbaea05d0342859e89075d2aaf2ee9684d Mon Sep 17 00:00:00 2001
From: tom <hj1557986@gmail.com>
Date: Thu, 23 May 2024 00:56:17 +0800
Subject: [PATCH 176/182] chore: fix grammar in doc comments (#1222)

* chore: Remove duplicate words

* bunch of grammar fixes

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
Co-authored-by: Sean Chen <seanchen11235@gmail.com>
---
 ibc-apps/ics20-transfer/src/context.rs           |  8 ++++----
 ibc-apps/ics20-transfer/types/src/denom.rs       |  8 ++++----
 ibc-apps/ics20-transfer/types/src/error.rs       |  4 ++--
 ibc-apps/ics20-transfer/types/src/lib.rs         |  4 ++--
 ibc-apps/ics721-nft-transfer/src/context.rs      |  8 ++++----
 ibc-apps/ics721-nft-transfer/types/src/class.rs  |  4 ++--
 ibc-apps/ics721-nft-transfer/types/src/error.rs  |  2 +-
 ibc-apps/ics721-nft-transfer/types/src/lib.rs    |  4 ++--
 ibc-clients/cw-context/src/context/mod.rs        |  6 +++---
 ibc-clients/cw-context/src/lib.rs                |  4 ++--
 ibc-clients/ics07-tendermint/src/client_state.rs |  2 +-
 .../src/client_state/misbehaviour.rs             |  2 +-
 .../src/client_state/validation.rs               |  4 ++--
 ibc-clients/ics07-tendermint/types/src/error.rs  |  6 +++---
 .../types/src/trust_threshold.rs                 |  2 +-
 .../ics02-client/context/src/client_state.rs     |  6 +++---
 ibc-core/ics02-client/types/src/error.rs         |  2 +-
 ibc-core/ics02-client/types/src/height.rs        |  2 +-
 .../ics02-client/types/src/msgs/misbehaviour.rs  |  2 +-
 .../ics02-client/types/src/msgs/update_client.rs |  2 +-
 .../ics03-connection/types/src/connection.rs     |  8 ++++----
 ibc-core/ics03-connection/types/src/error.rs     |  4 ++--
 .../types/src/msgs/conn_open_ack.rs              |  4 ++--
 .../types/src/msgs/conn_open_confirm.rs          |  2 +-
 ibc-core/ics03-connection/types/src/msgs/mod.rs  |  2 +-
 ibc-core/ics03-connection/types/src/version.rs   |  2 +-
 ibc-core/ics04-channel/types/src/channel.rs      |  8 ++++----
 ibc-core/ics04-channel/types/src/commitment.rs   |  4 ++--
 ibc-core/ics04-channel/types/src/error.rs        |  4 ++--
 .../types/src/msgs/acknowledgement.rs            |  2 +-
 .../types/src/msgs/chan_open_try.rs              |  2 +-
 ibc-core/ics04-channel/types/src/packet.rs       |  2 +-
 .../cosmos/src/upgrade_proposal/context.rs       |  2 +-
 .../cosmos/src/upgrade_proposal/handler.rs       |  2 +-
 .../cosmos/src/validate_self_client.rs           |  6 +++---
 ibc-core/ics24-host/src/context.rs               |  4 ++--
 .../ics24-host/types/src/identifiers/chain_id.rs |  2 +-
 .../types/src/identifiers/client_type.rs         |  2 +-
 ibc-core/ics24-host/types/src/validate.rs        |  8 ++++----
 ibc-core/ics25-handler/src/lib.rs                |  2 +-
 ibc-core/ics25-handler/types/src/lib.rs          |  2 +-
 ibc-core/src/lib.rs                              |  2 +-
 ibc-data-types/src/lib.rs                        |  4 ++--
 .../client_state/traits/client_state_common.rs   |  2 +-
 ibc-primitives/src/traits/proto.rs               |  2 +-
 ibc-primitives/src/types/timestamp.rs            |  6 +++---
 ibc-primitives/src/utils/mod.rs                  |  2 +-
 ibc-query/src/core/channel/query.rs              |  6 +++---
 ibc-query/src/core/channel/service.rs            |  6 +++---
 ibc-query/src/core/client/types/request.rs       |  2 +-
 ibc-query/src/lib.rs                             |  2 +-
 ibc-query/src/types.rs                           | 12 ++++++------
 ibc-testkit/src/context.rs                       | 14 +++++++-------
 .../src/fixtures/core/channel/acknowledgement.rs |  2 +-
 .../src/fixtures/core/channel/recv_packet.rs     |  2 +-
 ibc-testkit/src/fixtures/core/channel/timeout.rs |  2 +-
 .../fixtures/core/channel/timeout_on_close.rs    |  2 +-
 ibc-testkit/src/hosts/mod.rs                     |  2 +-
 ibc-testkit/src/relayer/context.rs               | 16 ++++++++--------
 ibc-testkit/src/relayer/error.rs                 |  4 ++--
 ibc-testkit/src/relayer/utils.rs                 |  2 +-
 ibc-testkit/src/testapp/ibc/core/core_ctx.rs     |  4 ++--
 ibc-testkit/src/testapp/ibc/core/router/types.rs |  2 +-
 ibc-testkit/src/utils/mod.rs                     |  6 +++---
 .../tests/core/ics02_client/update_client.rs     |  2 +-
 ibc-testkit/tests/cosmwasm/helper.rs             |  4 ++--
 ibc/src/lib.rs                                   |  2 +-
 67 files changed, 134 insertions(+), 134 deletions(-)

diff --git a/ibc-apps/ics20-transfer/src/context.rs b/ibc-apps/ics20-transfer/src/context.rs
index c427d4ad6..8c22ad386 100644
--- a/ibc-apps/ics20-transfer/src/context.rs
+++ b/ibc-apps/ics20-transfer/src/context.rs
@@ -21,7 +21,7 @@ pub trait TokenTransferValidationContext {
 
     /// Validates that the tokens can be escrowed successfully.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// escrow validation.
     fn escrow_coins_validate(
         &self,
@@ -50,7 +50,7 @@ pub trait TokenTransferValidationContext {
 
     /// Validates the sender account and the coin input before burning.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// burn validation.
     fn burn_coins_validate(
         &self,
@@ -70,7 +70,7 @@ pub trait TokenTransferValidationContext {
 pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
     /// Executes the escrow of the tokens in a user account.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// escrow execution.
     fn escrow_coins_execute(
         &mut self,
@@ -99,7 +99,7 @@ pub trait TokenTransferExecutionContext: TokenTransferValidationContext {
 
     /// Executes burning of the tokens in a user account.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// burn execution.
     fn burn_coins_execute(
         &mut self,
diff --git a/ibc-apps/ics20-transfer/types/src/denom.rs b/ibc-apps/ics20-transfer/types/src/denom.rs
index 8ac632fea..4bd30f60c 100644
--- a/ibc-apps/ics20-transfer/types/src/denom.rs
+++ b/ibc-apps/ics20-transfer/types/src/denom.rs
@@ -90,7 +90,7 @@ impl TracePrefix {
     /// it returns a tuple of the removed [`TracePrefix`] and the substring after the prefix.
     ///
     /// If the substring is empty, it returns `None`.
-    /// Otherwise the substring starts with `/`. In that case,
+    /// Otherwise, the substring starts with `/`. In that case,
     /// the leading `/` is stripped and returned.
     ///
     /// If the string does not start with a [`TracePrefix`], this method returns `None`.
@@ -174,7 +174,7 @@ impl TracePath {
     /// [`TracePath`] and the substring after the [`TracePath`].
     ///
     /// If the substring is empty, it returns `None`.
-    /// Otherwise the substring starts with `/`. In that case,
+    /// Otherwise, the substring starts with `/`. In that case,
     /// the leading `/` is stripped and returned.
     ///
     /// If the string does not contain any [`TracePrefix`], it returns the original string.
@@ -273,7 +273,7 @@ impl PrefixedDenom {
     }
 }
 
-/// Returns true if the denomination originally came from the sender chain and
+/// Returns true if the denomination originally came from the sender chain, and
 /// false otherwise.
 ///
 /// Note: It is better to think of the "source" chain as the chain that
@@ -305,7 +305,7 @@ pub fn is_sender_chain_source(
     !is_receiver_chain_source(source_port, source_channel, denom)
 }
 
-/// Returns true if the denomination originally came from the receiving chain and false otherwise.
+/// Returns true if the denomination originally came from the receiving chain, and false otherwise.
 pub fn is_receiver_chain_source(
     source_port: PortId,
     source_channel: ChannelId,
diff --git a/ibc-apps/ics20-transfer/types/src/error.rs b/ibc-apps/ics20-transfer/types/src/error.rs
index 7bd938408..a394eb77d 100644
--- a/ibc-apps/ics20-transfer/types/src/error.rs
+++ b/ibc-apps/ics20-transfer/types/src/error.rs
@@ -43,7 +43,7 @@ pub enum TokenTransferError {
     MalformedTrace(String),
     /// trace length must be even but got: `{len}`
     InvalidTraceLength { len: u64 },
-    /// invalid amount error: `{0}`
+    /// invalid amount: `{0}`
     InvalidAmount(FromDecStrErr),
     /// invalid token
     InvalidToken,
@@ -75,7 +75,7 @@ pub enum TokenTransferError {
     UnknownMsgType { msg_type: String },
     /// invalid coin string: `{coin}`
     InvalidCoin { coin: String },
-    /// decoding raw bytes as UTF8 string error: `{0}`
+    /// decoding raw bytes as UTF-8 string error: `{0}`
     Utf8Decode(Utf8Error),
     /// other error: `{0}`
     Other(String),
diff --git a/ibc-apps/ics20-transfer/types/src/lib.rs b/ibc-apps/ics20-transfer/types/src/lib.rs
index 9ef3e8413..2e5df5bf0 100644
--- a/ibc-apps/ics20-transfer/types/src/lib.rs
+++ b/ibc-apps/ics20-transfer/types/src/lib.rs
@@ -46,8 +46,8 @@ pub const PORT_ID_STR: &str = "transfer";
 /// ICS20 application current version.
 pub const VERSION: &str = "ics20-1";
 
-/// The successful string used for creating an acknowledgement status,
-/// equivalent to `base64::encode(0x01)`.
+/// The successful string, used for creating an acknowledgement status.
+/// It is equivalent to `base64::encode(0x01)`.
 pub const ACK_SUCCESS_B64: &str = "AQ==";
 
 use ibc_core::channel::types::acknowledgement::StatusValue;
diff --git a/ibc-apps/ics721-nft-transfer/src/context.rs b/ibc-apps/ics721-nft-transfer/src/context.rs
index 34fec88dd..ede6ee898 100644
--- a/ibc-apps/ics721-nft-transfer/src/context.rs
+++ b/ibc-apps/ics721-nft-transfer/src/context.rs
@@ -67,7 +67,7 @@ pub trait NftTransferValidationContext {
     /// Validates that the tokens can be escrowed successfully.
     ///
     /// The owner of the NFT should be checked in this validation.
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// escrow validation.
     fn escrow_nft_validate(
         &self,
@@ -109,7 +109,7 @@ pub trait NftTransferValidationContext {
     /// Validates the sender account and the coin input before burning.
     ///
     /// The owner of the NFT should be checked in this validation.
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// burn validation.
     fn burn_nft_validate(
         &self,
@@ -153,7 +153,7 @@ pub trait NftTransferExecutionContext: NftTransferValidationContext {
 
     /// Executes the escrow of the NFT in a user account.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// escrow execution.
     fn escrow_nft_execute(
         &mut self,
@@ -187,7 +187,7 @@ pub trait NftTransferExecutionContext: NftTransferValidationContext {
 
     /// Executes burning of the NFT in a user account.
     ///
-    /// `memo` field allows to incorporate additional contextual details in the
+    /// `memo` field allows incorporating additional contextual details in the
     /// burn execution.
     fn burn_nft_execute(
         &mut self,
diff --git a/ibc-apps/ics721-nft-transfer/types/src/class.rs b/ibc-apps/ics721-nft-transfer/types/src/class.rs
index ff1293f89..4e55056d6 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/class.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/class.rs
@@ -92,7 +92,7 @@ impl PrefixedClassId {
     }
 }
 
-/// Returns true if the class ID originally came from the sender chain and false otherwise.
+/// Returns true if the class ID originally came from the sender chain, and false otherwise.
 pub fn is_sender_chain_source(
     source_port: PortId,
     source_channel: ChannelId,
@@ -101,7 +101,7 @@ pub fn is_sender_chain_source(
     !is_receiver_chain_source(source_port, source_channel, class_id)
 }
 
-/// Returns true if the class ID originally came from the receiving chain and false otherwise.
+/// Returns true if the class ID originally came from the receiving chain, and false otherwise.
 pub fn is_receiver_chain_source(
     source_port: PortId,
     source_channel: ChannelId,
diff --git a/ibc-apps/ics721-nft-transfer/types/src/error.rs b/ibc-apps/ics721-nft-transfer/types/src/error.rs
index 7651e7cb7..94c230add 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/error.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/error.rs
@@ -86,7 +86,7 @@ pub enum NftTransferError {
     DecodeRawMsg { reason: String },
     /// unknown msg type: `{msg_type}`
     UnknownMsgType { msg_type: String },
-    /// decoding raw bytes as UTF8 string error: `{0}`
+    /// decoding raw bytes as UTF-8 string error: `{0}`
     Utf8Decode(Utf8Error),
     /// other error: `{0}`
     Other(String),
diff --git a/ibc-apps/ics721-nft-transfer/types/src/lib.rs b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
index 7a55e1368..6992c98f0 100644
--- a/ibc-apps/ics721-nft-transfer/types/src/lib.rs
+++ b/ibc-apps/ics721-nft-transfer/types/src/lib.rs
@@ -45,8 +45,8 @@ pub const PORT_ID_STR: &str = "nft-transfer";
 /// ICS-721 application current version.
 pub const VERSION: &str = "ics721-1";
 
-/// The successful string used for creating an acknowledgement status,
-/// equivalent to `base64::encode(0x01)`.
+/// The successful string, used for creating an acknowledgement status.
+/// It is equivalent to `base64::encode(0x01)`.
 pub const ACK_SUCCESS_B64: &str = "AQ==";
 
 use ibc_core::channel::types::acknowledgement::StatusValue;
diff --git a/ibc-clients/cw-context/src/context/mod.rs b/ibc-clients/cw-context/src/context/mod.rs
index 4c483e946..40a027528 100644
--- a/ibc-clients/cw-context/src/context/mod.rs
+++ b/ibc-clients/cw-context/src/context/mod.rs
@@ -23,7 +23,7 @@ use crate::utils::AnyCodec;
 
 type Checksum = Vec<u8>;
 
-/// - [`Height`] can not be used directly as keys in the map,
+/// - [`Height`] cannot be used directly as keys in the map,
 /// as it doesn't implement some cw_storage specific traits.
 /// - Only a sorted set is needed. So the value type is set to
 /// [`Empty`] following
@@ -31,8 +31,8 @@ type Checksum = Vec<u8>;
 pub const CONSENSUS_STATE_HEIGHT_MAP: Map<'_, (u64, u64), Empty> =
     Map::new(ITERATE_CONSENSUS_STATE_PREFIX);
 
-/// Context is a wrapper around the deps and env that gives access to the
-/// methods under the ibc-rs Validation and Execution traits.
+/// Context is a wrapper around the deps and env that provides access
+/// to the methods under the ibc-rs Validation and Execution traits.
 pub struct Context<'a, C: ClientType<'a>>
 where
     <C::ClientState as TryFrom<Any>>::Error: Into<ClientError>,
diff --git a/ibc-clients/cw-context/src/lib.rs b/ibc-clients/cw-context/src/lib.rs
index b1f72df01..4db776cdf 100644
--- a/ibc-clients/cw-context/src/lib.rs
+++ b/ibc-clients/cw-context/src/lib.rs
@@ -1,10 +1,10 @@
 //! Contains types and implementations that are needed to integrate a light
-//! client, built using ibc-rs, into CosmWasm contract. This crate functions as
+//! client, built using ibc-rs, into a CosmWasm contract. This crate functions as
 //! a library, allowing users to import the ready-made `Context` object that is
 //! generic across light clients, introduce their concrete client type and
 //! integrate their assembled context into the CosmWasm contract's entrypoint.
 //! NOTE: To utilize the CosmWasm contract developed using this library, hosting
-//! environments must support CosmWasm module and be using one the versions of
+//! environments must support the CosmWasm module and be using one of the versions of
 //! `ibc-go` that supports the `08-wasm` proxy light client.
 
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
diff --git a/ibc-clients/ics07-tendermint/src/client_state.rs b/ibc-clients/ics07-tendermint/src/client_state.rs
index d1b3e1ab6..0adb68f22 100644
--- a/ibc-clients/ics07-tendermint/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state.rs
@@ -27,7 +27,7 @@ pub use misbehaviour::*;
 pub use update_client::*;
 pub use validation::*;
 
-/// Newtype wrapper around the `ClientState` type imported from the
+/// Newtype wrapper around the `ClientState` type, imported from the
 /// `ibc-client-tendermint-types` crate. This wrapper exists so that we can
 /// bypass Rust's orphan rules and implement traits from
 /// `ibc::core::client::context` on the `ClientState` type.
diff --git a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
index 79d2b6ea9..65fd175c5 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/misbehaviour.rs
@@ -16,7 +16,7 @@ use tendermint_light_client_verifier::Verifier;
 
 use crate::types::Header;
 
-/// Determines whether or not two conflicting headers at the same height would
+/// Determines if two conflicting headers at the same height would
 /// have convinced the light client.
 pub fn verify_misbehaviour<V, H>(
     ctx: &V,
diff --git a/ibc-clients/ics07-tendermint/src/client_state/validation.rs b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
index aca62f5e5..116b84dd8 100644
--- a/ibc-clients/ics07-tendermint/src/client_state/validation.rs
+++ b/ibc-clients/ics07-tendermint/src/client_state/validation.rs
@@ -137,8 +137,8 @@ where
 /// 1 - fork:
 /// Assumes at least one consensus state before the fork point exists. Let
 /// existing consensus states on chain B be: [Sn,.., Sf, Sf-1, S0] with
-/// `Sf-1` being the most recent state before fork. Chain A is queried for a
-/// header `Hf'` at `Sf.height` and if it is different than the `Hf` in the
+/// `Sf-1` being the most recent state before the fork. Chain A is queried for
+/// a header `Hf'` at `Sf.height` and if it is different from the `Hf` in the
 /// event for the client update (the one that has generated `Sf` on chain),
 /// then the two headers are included in the evidence and submitted. Note
 /// that in this case the headers are different but have the same height.
diff --git a/ibc-clients/ics07-tendermint/types/src/error.rs b/ibc-clients/ics07-tendermint/types/src/error.rs
index 4376e902e..c4e25e094 100644
--- a/ibc-clients/ics07-tendermint/types/src/error.rs
+++ b/ibc-clients/ics07-tendermint/types/src/error.rs
@@ -52,7 +52,7 @@ pub enum Error {
     MissingUnbondingPeriod,
     /// negative max clock drift
     NegativeMaxClockDrift,
-    /// missing latest height
+    /// missing the latest height
     MissingLatestHeight,
     /// invalid raw header error: `{0}`
     InvalidRawHeader(TendermintError),
@@ -79,7 +79,7 @@ pub enum Error {
     VerificationError { detail: Box<LightClientErrorDetail> },
     /// Processed time or height for the client `{client_id}` at height `{height}` not found
     UpdateMetaDataNotFound { client_id: ClientId, height: Height },
-    /// The given hash of the validators does not matches the given hash in the signed header. Expected: `{signed_header_validators_hash}`, got: `{validators_hash}`
+    /// The given hash of the validators does not match the given hash in the signed header. Expected: `{signed_header_validators_hash}`, got: `{validators_hash}`
     MismatchValidatorsHashes {
         validators_hash: Hash,
         signed_header_validators_hash: Hash,
@@ -91,7 +91,7 @@ pub enum Error {
     },
     /// headers block hashes are equal
     MisbehaviourHeadersBlockHashesEqual,
-    /// headers are not at same height and are monotonically increasing
+    /// headers are not at the same height and are monotonically increasing
     MisbehaviourHeadersNotAtSameHeight,
 }
 
diff --git a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
index 07f2bbb70..830bba74d 100644
--- a/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
+++ b/ibc-clients/ics07-tendermint/types/src/trust_threshold.rs
@@ -12,7 +12,7 @@ use tendermint::trust_threshold::TrustThresholdFraction;
 /// [`TrustThreshold`] defines the level of trust that a client has
 /// towards a set of validators of a chain.
 ///
-/// A trust threshold is represented as a fraction, i.e., a numerator and
+/// A trust threshold is represented as a fraction, i.e., a numerator
 /// and a denominator.
 /// A typical trust threshold is 1/3 in practice.
 /// This type accepts even a value of 0, (numerator = 0, denominator = 0),
diff --git a/ibc-core/ics02-client/context/src/client_state.rs b/ibc-core/ics02-client/context/src/client_state.rs
index e6becbf58..974d9b43b 100644
--- a/ibc-core/ics02-client/context/src/client_state.rs
+++ b/ibc-core/ics02-client/context/src/client_state.rs
@@ -27,7 +27,7 @@ pub trait ClientStateCommon: Convertible<Any> {
     /// Type of client associated with this state (eg. Tendermint)
     fn client_type(&self) -> ClientType;
 
-    /// Latest height the client was updated to
+    /// The latest height the client was updated to
     fn latest_height(&self) -> Height;
 
     /// Validate that the client is at a sufficient height
@@ -36,7 +36,7 @@ pub trait ClientStateCommon: Convertible<Any> {
     /// Verify the upgraded client and consensus states and validate proofs
     /// against the given root.
     ///
-    /// NOTE: proof heights are not included as upgrade to a new revision is
+    /// NOTE: proof heights are not included, as upgrade to a new revision is
     /// expected to pass only on the last height committed by the current
     /// revision. Clients are responsible for ensuring that the planned last
     /// height of the current revision is somehow encoded in the proof
@@ -205,7 +205,7 @@ where
 
 /// Primary client trait. Defines all the methods that clients must implement.
 ///
-/// `ClientState` is broken up in 3 separate traits to avoid needing to use
+/// `ClientState` is broken up into 3 separate traits to avoid needing to use
 /// fully qualified syntax for every method call (see ADR 7 for more details).
 /// One only needs to implement [`ClientStateCommon`], [`ClientStateValidation`]
 /// and [`ClientStateExecution`]; a blanket implementation will automatically
diff --git a/ibc-core/ics02-client/types/src/error.rs b/ibc-core/ics02-client/types/src/error.rs
index 9eb5c51da..08c6d2114 100644
--- a/ibc-core/ics02-client/types/src/error.rs
+++ b/ibc-core/ics02-client/types/src/error.rs
@@ -97,7 +97,7 @@ pub enum ClientError {
     Ics23Verification(CommitmentError),
     /// misbehaviour handling failed with reason: `{reason}`
     MisbehaviourHandlingFailure { reason: String },
-    /// client specific error: `{description}`
+    /// client-specific error: `{description}`
     ClientSpecific { description: String },
     /// client counter overflow error
     CounterOverflow,
diff --git a/ibc-core/ics02-client/types/src/height.rs b/ibc-core/ics02-client/types/src/height.rs
index db809591a..96eda4c92 100644
--- a/ibc-core/ics02-client/types/src/height.rs
+++ b/ibc-core/ics02-client/types/src/height.rs
@@ -158,7 +158,7 @@ pub enum HeightError {
     },
     /// attempted to parse an invalid zero height
     ZeroHeight,
-    /// the height(`{raw_height}`) is not valid format, this format must be used: \[revision_number\]-\[revision_height\]
+    /// the height(`{raw_height}`) is not a valid format, this format must be used: \[revision_number\]-\[revision_height\]
     InvalidFormat { raw_height: String },
 }
 
diff --git a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
index fc13aa91f..0b4031fe5 100644
--- a/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
+++ b/ibc-core/ics02-client/types/src/msgs/misbehaviour.rs
@@ -28,7 +28,7 @@ pub const SUBMIT_MISBEHAVIOUR_TYPE_URL: &str = "/ibc.core.client.v1.MsgSubmitMis
 pub struct MsgSubmitMisbehaviour {
     /// client unique identifier
     pub client_id: ClientId,
-    /// misbehaviour used for freezing the light client
+    /// misbehaviour, used for freezing the light client
     pub misbehaviour: ProtoAny,
     /// signer address
     pub signer: Signer,
diff --git a/ibc-core/ics02-client/types/src/msgs/update_client.rs b/ibc-core/ics02-client/types/src/msgs/update_client.rs
index ace553b40..df79446ef 100644
--- a/ibc-core/ics02-client/types/src/msgs/update_client.rs
+++ b/ibc-core/ics02-client/types/src/msgs/update_client.rs
@@ -13,7 +13,7 @@ pub const UPDATE_CLIENT_TYPE_URL: &str = "/ibc.core.client.v1.MsgUpdateClient";
 
 /// Represents the message that triggers the update of an on-chain (IBC) client
 /// either with new headers, or evidence of misbehaviour.
-/// Note that some types of misbehaviour can be detected when a headers
+/// Note that some types of misbehaviour can be detected when the headers
 /// are updated (`UpdateKind::UpdateClient`).
 #[cfg_attr(
     feature = "borsh",
diff --git a/ibc-core/ics03-connection/types/src/connection.rs b/ibc-core/ics03-connection/types/src/connection.rs
index 444a27548..e2c027dbd 100644
--- a/ibc-core/ics03-connection/types/src/connection.rs
+++ b/ibc-core/ics03-connection/types/src/connection.rs
@@ -488,7 +488,7 @@ impl State {
         }
     }
 
-    /// Parses the State out from a i32.
+    /// Parses the State out from an i32.
     pub fn from_i32(s: i32) -> Result<Self, ConnectionError> {
         match s {
             0 => Ok(Self::Uninitialized),
@@ -502,13 +502,13 @@ impl State {
         }
     }
 
-    /// Returns whether or not this connection state is `Open`.
+    /// Returns if this connection state is `Open`.
     pub fn is_open(self) -> bool {
         self == State::Open
     }
 
-    /// Returns whether or not this connection with this state
-    /// has progressed less or the same than the argument.
+    /// Returns if this connection with this state
+    /// has progressed less than or the same as the argument.
     ///
     /// # Example
     /// ```rust,ignore
diff --git a/ibc-core/ics03-connection/types/src/error.rs b/ibc-core/ics03-connection/types/src/error.rs
index bdd7e1299..478b2d537 100644
--- a/ibc-core/ics03-connection/types/src/error.rs
+++ b/ibc-core/ics03-connection/types/src/error.rs
@@ -69,12 +69,12 @@ pub enum ConnectionError {
     },
     /// invalid client state: `{reason}`
     InvalidClientState { reason: String },
-    /// not enough blocks elapsed, current height `{current_host_height}` is still less than earliest acceptable height `{earliest_valid_height}`
+    /// not enough blocks elapsed, current height `{current_host_height}` is still less than the earliest acceptable height `{earliest_valid_height}`
     NotEnoughBlocksElapsed {
         current_host_height: Height,
         earliest_valid_height: Height,
     },
-    /// not enough time elapsed, current timestamp `{current_host_time}` is still less than earliest acceptable timestamp `{earliest_valid_time}`
+    /// not enough time elapsed, current timestamp `{current_host_time}` is still less than the earliest acceptable timestamp `{earliest_valid_time}`
     NotEnoughTimeElapsed {
         current_host_time: Timestamp,
         earliest_valid_time: Timestamp,
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
index 417e99d4d..dc3056b2a 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_ack.rs
@@ -21,9 +21,9 @@ pub const CONN_OPEN_ACK_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnectionO
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenAck {
-    /// ConnectionId that chain A has chosen for it's ConnectionEnd
+    /// ConnectionId that chain A has chosen for its ConnectionEnd
     pub conn_id_on_a: ConnectionId,
-    /// ConnectionId that chain B has chosen for it's ConnectionEnd
+    /// ConnectionId that chain B has chosen for its ConnectionEnd
     pub conn_id_on_b: ConnectionId,
     /// ClientState of client tracking chain A on chain B
     pub client_state_of_a_on_b: Any,
diff --git a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
index ec4bcce7c..e18821d57 100644
--- a/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/conn_open_confirm.rs
@@ -19,7 +19,7 @@ pub const CONN_OPEN_CONFIRM_TYPE_URL: &str = "/ibc.core.connection.v1.MsgConnect
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 #[derive(Clone, Debug, PartialEq, Eq)]
 pub struct MsgConnectionOpenConfirm {
-    /// ConnectionId that chain B has chosen for it's ConnectionEnd
+    /// ConnectionId that chain B has chosen for its ConnectionEnd
     pub conn_id_on_b: ConnectionId,
     /// proof of ConnectionEnd stored on Chain A during ConnOpenInit
     pub proof_conn_end_on_a: CommitmentProofBytes,
diff --git a/ibc-core/ics03-connection/types/src/msgs/mod.rs b/ibc-core/ics03-connection/types/src/msgs/mod.rs
index 406001e36..d3be3dcf6 100644
--- a/ibc-core/ics03-connection/types/src/msgs/mod.rs
+++ b/ibc-core/ics03-connection/types/src/msgs/mod.rs
@@ -6,7 +6,7 @@
 //!
 //! One departure from ICS3 is that we abstract the three counterparty fields (connection id,
 //! prefix, and client id) into a single field of type `Counterparty`; this applies to messages
-//! `MsgConnectionOpenInit` and `MsgConnectionOpenTry`. One other difference with regards to
+//! `MsgConnectionOpenInit` and `MsgConnectionOpenTry`. One other difference with regard to
 //! abstraction is that all proof-related attributes in a message are encapsulated in `Proofs` type.
 //!
 //! Another difference to ICS3 specs is that each message comprises an additional field called
diff --git a/ibc-core/ics03-connection/types/src/version.rs b/ibc-core/ics03-connection/types/src/version.rs
index 2979e2622..a4446d113 100644
--- a/ibc-core/ics03-connection/types/src/version.rs
+++ b/ibc-core/ics03-connection/types/src/version.rs
@@ -112,7 +112,7 @@ impl Display for Version {
 /// selects the first version with a version identifier that is supported by the
 /// counterparty. The returned version contains a feature set with the
 /// intersection of the features supported by the source and counterparty
-/// chains. If the feature set intersection is nil then the search for a
+/// chains. If the feature set intersection is nil, the search for a
 /// compatible version continues. This function is called in the `conn_open_try`
 /// handshake procedure.
 ///
diff --git a/ibc-core/ics04-channel/types/src/channel.rs b/ibc-core/ics04-channel/types/src/channel.rs
index c8350805c..d551c441f 100644
--- a/ibc-core/ics04-channel/types/src/channel.rs
+++ b/ibc-core/ics04-channel/types/src/channel.rs
@@ -314,7 +314,7 @@ impl ChannelEnd {
 
     /// Checks if the `connection_hops` has a length of `expected`.
     ///
-    /// Note: Current IBC version only supports one connection hop.
+    /// Note: The current IBC version only supports one connection hop.
     pub fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
         verify_connection_hops_length(&self.connection_hops, 1)
     }
@@ -554,13 +554,13 @@ impl State {
         }
     }
 
-    /// Returns whether or not this channel state is `Open`.
+    /// Returns if this channel state is `Open`.
     pub fn is_open(self) -> bool {
         self == State::Open
     }
 
-    /// Returns whether or not the channel with this state
-    /// has progressed less or the same than the argument.
+    /// Returns if the channel with this state
+    /// has progressed less than or the same as the argument.
     ///
     /// # Example
     /// ```rust,ignore
diff --git a/ibc-core/ics04-channel/types/src/commitment.rs b/ibc-core/ics04-channel/types/src/commitment.rs
index 1f1fc464c..8066b13b6 100644
--- a/ibc-core/ics04-channel/types/src/commitment.rs
+++ b/ibc-core/ics04-channel/types/src/commitment.rs
@@ -42,7 +42,7 @@ impl From<Vec<u8>> for PacketCommitment {
     }
 }
 
-/// Acknowledgement commitment to be stored
+/// Acknowledgement of commitment to be stored
 #[cfg_attr(
     feature = "parity-scale-codec",
     derive(
@@ -106,7 +106,7 @@ pub fn compute_ack_commitment(ack: &Acknowledgement) -> AcknowledgementCommitmen
 
 /// Helper function to hash a byte slice using SHA256.
 ///
-/// Note that computing commitments with anything other than SHA256 will
+/// Note that computing commitments with anything apart from SHA256 will
 /// break the Merkle proofs of the IBC provable store.
 fn hash(data: &[u8]) -> [u8; 32] {
     use sha2::Digest;
diff --git a/ibc-core/ics04-channel/types/src/error.rs b/ibc-core/ics04-channel/types/src/error.rs
index 9fb77c7c0..2b7b760ef 100644
--- a/ibc-core/ics04-channel/types/src/error.rs
+++ b/ibc-core/ics04-channel/types/src/error.rs
@@ -1,4 +1,4 @@
-//! Defines the main channel, port and packet error types
+//! Defines the main channel, port, and packet error types
 
 use displaydoc::Display;
 use ibc_core_client_types::{error as client_error, Height};
@@ -101,7 +101,7 @@ pub enum PacketError {
     PacketReceiptNotFound { sequence: Sequence },
     /// The stored commitment of the packet `{sequence}` is incorrect
     IncorrectPacketCommitment { sequence: Sequence },
-    /// implementation specific error
+    /// implementation-specific error
     ImplementationSpecific,
     /// Undefined counterparty connection for `{connection_id}`
     UndefinedConnectionCounterparty { connection_id: ConnectionId },
diff --git a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
index e37fa6300..a93f7a622 100644
--- a/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/acknowledgement.rs
@@ -25,7 +25,7 @@ pub struct MsgAcknowledgement {
     pub acknowledgement: Acknowledgement,
     /// Proof of packet acknowledgement on the receiving chain
     pub proof_acked_on_b: CommitmentProofBytes,
-    /// Height at which the commitment proof in this message were taken
+    /// Height at which the commitment proof in this message was taken
     pub proof_height_on_b: Height,
     pub signer: Signer,
 }
diff --git a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
index 4b1d54384..c6cbd918b 100644
--- a/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
+++ b/ibc-core/ics04-channel/types/src/msgs/chan_open_try.rs
@@ -41,7 +41,7 @@ pub struct MsgChannelOpenTry {
 impl MsgChannelOpenTry {
     /// Checks if the `connection_hops` has a length of `expected`.
     ///
-    /// Note: Current IBC version only supports one connection hop.
+    /// Note: The current IBC version only supports one connection hop.
     pub fn verify_connection_hops_length(&self) -> Result<(), ChannelError> {
         verify_connection_hops_length(&self.connection_hops_on_b, 1)
     }
diff --git a/ibc-core/ics04-channel/types/src/packet.rs b/ibc-core/ics04-channel/types/src/packet.rs
index 0017e0518..5caeb4eb3 100644
--- a/ibc-core/ics04-channel/types/src/packet.rs
+++ b/ibc-core/ics04-channel/types/src/packet.rs
@@ -129,7 +129,7 @@ impl Packet {
     /// event is timed-out relative to the current state of the
     /// destination chain.
     ///
-    /// Checks both for time-out relative to the destination chain's
+    /// Checks for time-out relative to the destination chain's
     /// current timestamp `dst_chain_ts` as well as relative to
     /// the height `dst_chain_height`.
     ///
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
index 925ab547f..056bd4e46 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/context.rs
@@ -22,7 +22,7 @@ pub type UpgradedConsensusStateRef<T> =
 pub trait UpgradeValidationContext {
     type V: ClientValidationContext;
 
-    /// Returns the upgrade plan that is scheduled and not have been executed yet.
+    /// Returns the upgrade plan that is scheduled and has not been executed yet.
     fn upgrade_plan(&self) -> Result<Plan, UpgradeClientError>;
 
     /// Returns the upgraded client state at the specified upgrade path.
diff --git a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
index 2b76c089f..8c7ee72cf 100644
--- a/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
+++ b/ibc-core/ics24-host/cosmos/src/upgrade_proposal/handler.rs
@@ -11,7 +11,7 @@ use crate::upgrade_proposal::{UpgradeClientProposal, UpgradeExecutionContext, Up
 ///
 /// It clears both IBC client and consensus states if a previous plan was set.
 /// Then it will schedule an upgrade and finally set the upgraded client state
-/// in upgrade store.
+/// in the upgrade store.
 pub fn execute_upgrade_client_proposal<Ctx>(
     ctx: &mut Ctx,
     proposal: UpgradeProposal,
diff --git a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
index 72974ab75..7064fdcd8 100644
--- a/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
+++ b/ibc-core/ics24-host/cosmos/src/validate_self_client.rs
@@ -132,16 +132,16 @@ pub trait ValidateSelfClientContext {
         Ok(())
     }
 
-    /// Returns the host chain id
+    /// Returns the chain id of the host
     fn chain_id(&self) -> &ChainId;
 
     /// Returns the host current height
     fn host_current_height(&self) -> Height;
 
-    /// Returns the host proof specs
+    /// Returns the proof specs of the host
     fn proof_specs(&self) -> &ProofSpecs;
 
-    /// Returns the host unbonding period
+    /// Returns the unbonding period of the host
     fn unbonding_period(&self) -> Duration;
 
     /// Returns the host upgrade path. May be empty.
diff --git a/ibc-core/ics24-host/src/context.rs b/ibc-core/ics24-host/src/context.rs
index 612768a32..da858968d 100644
--- a/ibc-core/ics24-host/src/context.rs
+++ b/ibc-core/ics24-host/src/context.rs
@@ -150,7 +150,7 @@ pub trait ExecutionContext: ValidationContext {
     fn get_client_execution_context(&mut self) -> &mut Self::E;
 
     /// Called upon client creation.
-    /// Increases the counter which keeps track of how many clients have been created.
+    /// Increases the counter, that keeps track of how many clients have been created.
     fn increase_client_counter(&mut self) -> Result<(), ContextError>;
 
     /// Stores the given connection_end at path
@@ -230,7 +230,7 @@ pub trait ExecutionContext: ValidationContext {
     ) -> Result<(), ContextError>;
 
     /// Called upon channel identifier creation (Init or Try message processing).
-    /// Increases the counter which keeps track of how many channels have been created.
+    /// Increases the counter, that keeps track of how many channels have been created.
     fn increase_channel_counter(&mut self) -> Result<(), ContextError>;
 
     /// Emit the given IBC event
diff --git a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
index 38a61f5af..ecd2702cf 100644
--- a/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/chain_id.rs
@@ -44,7 +44,7 @@ impl ChainId {
     /// based on their requirements.
     ///
     /// If the chain identifier is in the {chain name}-{revision number} format,
-    /// the revision number is parsed. Otherwise, revision number is set to 0.
+    /// the revision number is parsed. Otherwise, the revision number is set to 0.
     ///
     /// ```
     /// use ibc_core_host_types::identifiers::ChainId;
diff --git a/ibc-core/ics24-host/types/src/identifiers/client_type.rs b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
index 847f46452..8f0547aa4 100644
--- a/ibc-core/ics24-host/types/src/identifiers/client_type.rs
+++ b/ibc-core/ics24-host/types/src/identifiers/client_type.rs
@@ -32,7 +32,7 @@ impl ClientType {
         validate_client_type(client_type).map(|()| Self(client_type.into()))
     }
 
-    /// Constructs a new [`ClientId`] with this types client type and given
+    /// Constructs a new [`ClientId`] with this type of client type and given
     /// `counter`.
     ///
     /// This is equivalent to `ClientId::new(self.as_str(), counter)` but
diff --git a/ibc-core/ics24-host/types/src/validate.rs b/ibc-core/ics24-host/types/src/validate.rs
index 8346ff912..75e3494ef 100644
--- a/ibc-core/ics24-host/types/src/validate.rs
+++ b/ibc-core/ics24-host/types/src/validate.rs
@@ -90,7 +90,7 @@ pub fn validate_client_type(id: &str) -> Result<(), Error> {
 
 /// Default validator function for Client identifiers.
 ///
-/// A valid client identifier must be between 9-64 characters as specified in
+/// A valid client identifier must be between 9-64 characters, as specified in
 /// the ICS-24 spec.
 pub fn validate_client_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
@@ -99,7 +99,7 @@ pub fn validate_client_identifier(id: &str) -> Result<(), Error> {
 
 /// Default validator function for Connection identifiers.
 ///
-/// A valid connection identifier must be between 10-64 characters as specified
+/// A valid connection identifier must be between 10-64 characters, as specified
 /// in the ICS-24 spec.
 pub fn validate_connection_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
@@ -110,7 +110,7 @@ pub fn validate_connection_identifier(id: &str) -> Result<(), Error> {
 
 /// Default validator function for Port identifiers.
 ///
-/// A valid port identifier must be between 2-128 characters as specified in the
+/// A valid port identifier must be between 2-128 characters, as specified in the
 /// ICS-24 spec.
 pub fn validate_port_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
@@ -119,7 +119,7 @@ pub fn validate_port_identifier(id: &str) -> Result<(), Error> {
 
 /// Default validator function for Channel identifiers.
 ///
-/// A valid channel identifier must be between 8-64 characters as specified in
+/// A valid channel identifier must be between 8-64 characters, as specified in
 /// the ICS-24 spec.
 pub fn validate_channel_identifier(id: &str) -> Result<(), Error> {
     validate_identifier_chars(id)?;
diff --git a/ibc-core/ics25-handler/src/lib.rs b/ibc-core/ics25-handler/src/lib.rs
index 203c98c2f..783e8e628 100644
--- a/ibc-core/ics25-handler/src/lib.rs
+++ b/ibc-core/ics25-handler/src/lib.rs
@@ -7,7 +7,7 @@
 //! an error, the runtime is expected to rollback all state modifications made
 //! to the context (e.g. [`ExecutionContext`](ibc_core_host::ExecutionContext))
 //! while processing `M`. If the transaction containing `M` consists of multiple
-//! messages, then typically the state modifications from all messages is
+//! messages, then typically the state modifications from all messages are
 //! expected to be rolled back as well.
 #![no_std]
 #![forbid(unsafe_code)]
diff --git a/ibc-core/ics25-handler/types/src/lib.rs b/ibc-core/ics25-handler/types/src/lib.rs
index 60d03ad14..c30845afc 100644
--- a/ibc-core/ics25-handler/types/src/lib.rs
+++ b/ibc-core/ics25-handler/types/src/lib.rs
@@ -1,4 +1,4 @@
-//! Encapsulates essential data structures facilitating the seamless
+//! Encapsulates essential data structures, facilitating the seamless
 //! interaction between an implemented IBC module using ibc-rs and the
 //! underlying host blockchain.
 #![no_std]
diff --git a/ibc-core/src/lib.rs b/ibc-core/src/lib.rs
index da0deda7a..30d04e384 100644
--- a/ibc-core/src/lib.rs
+++ b/ibc-core/src/lib.rs
@@ -75,7 +75,7 @@ pub mod derive {
     /// - `#[execution(<YourClientExecutionContext>)]`
     ///
     /// The argument to the `validation` or `execution` attributes may contain
-    /// lifetimes or generic types and even that types might be bounded by
+    /// lifetimes or generic types, and even that types might be bounded by
     /// traits. For instance:
     ///
     /// - `#[validation(Context<S>)]`
diff --git a/ibc-data-types/src/lib.rs b/ibc-data-types/src/lib.rs
index 6056d869e..ab9ffd8b2 100644
--- a/ibc-data-types/src/lib.rs
+++ b/ibc-data-types/src/lib.rs
@@ -1,7 +1,7 @@
 //! Re-exports data structures of various specifications within the
 //! Inter-Blockchain Communication (IBC) protocol. Designed for universal
-//! application, enabling diverse projects across IBC ecosystem to build using a
-//! shared language.
+//! application, enabling diverse projects across the IBC ecosystem to
+//! build using a shared language.
 #![no_std]
 #![forbid(unsafe_code)]
 #![cfg_attr(not(test), deny(clippy::unwrap_used))]
diff --git a/ibc-derive/src/client_state/traits/client_state_common.rs b/ibc-derive/src/client_state/traits/client_state_common.rs
index 56bfe9349..bac320ff8 100644
--- a/ibc-derive/src/client_state/traits/client_state_common.rs
+++ b/ibc-derive/src/client_state/traits/client_state_common.rs
@@ -138,7 +138,7 @@ pub(crate) fn impl_ClientStateCommon(
 ///
 /// `enum_name`:     The user's enum identifier (e.g. `HostClientState`)
 /// `enum_variants`: An iterator of all enum variants (e.g. `[HostClientState::Tendermint, HostClientState::Mock]`)
-/// `fn_call`:       The tokens for the function call. Fully-qualified syntax is assumed, where the name for `self`
+/// `fn_call`:       The tokens for the function call. Fully qualified syntax is assumed, where the name for `self`
 ///                  is `cs` (e.g. `client_type(cs)`).
 ///
 /// For example,
diff --git a/ibc-primitives/src/traits/proto.rs b/ibc-primitives/src/traits/proto.rs
index 686350b2d..54dc35846 100644
--- a/ibc-primitives/src/traits/proto.rs
+++ b/ibc-primitives/src/traits/proto.rs
@@ -5,7 +5,7 @@ use ibc_proto::Protobuf;
 
 use crate::prelude::*;
 
-/// Types that implement this trait are able to be converted to
+/// Types that implement this trait can be converted to
 /// a raw Protobuf `Any` type.
 pub trait ToProto<P>: Protobuf<P>
 where
diff --git a/ibc-primitives/src/types/timestamp.rs b/ibc-primitives/src/types/timestamp.rs
index 7023c948e..40b72c2eb 100644
--- a/ibc-primitives/src/types/timestamp.rs
+++ b/ibc-primitives/src/types/timestamp.rs
@@ -89,8 +89,8 @@ impl scale_info::TypeInfo for Timestamp {
 /// - If the left timestamp is strictly after the right timestamp, the result is `Expired`.
 /// - Otherwise, the result is `NotExpired`.
 ///
-/// User of this result may want to determine whether error should be raised,
-/// when either of the timestamp being compared is invalid.
+/// Users of this result may want to determine whether an error should be raised,
+/// when either of the timestamps being compared is invalid.
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[derive(PartialEq, Eq, Copy, Clone, Debug, Hash)]
 pub enum Expiry {
@@ -140,7 +140,7 @@ impl Timestamp {
     /// Computes the duration difference of another `Timestamp` from the current one.
     /// Returns the difference in time as an [`core::time::Duration`].
     /// Returns `None` if the other `Timestamp` is more advanced
-    /// than the current or if either of the `Timestamp`s is not set.
+    /// than the current, or if either of the `Timestamp`s is not set.
     pub fn duration_since(&self, other: &Self) -> Option<Duration> {
         match (self.time, other.time) {
             (Some(time1), Some(time2)) => time1.duration_since(time2).ok(),
diff --git a/ibc-primitives/src/utils/mod.rs b/ibc-primitives/src/utils/mod.rs
index b61030b5d..576e377cf 100644
--- a/ibc-primitives/src/utils/mod.rs
+++ b/ibc-primitives/src/utils/mod.rs
@@ -1,4 +1,4 @@
-//! Contains various internally-used utilities.
+//! Contains various internally used utilities.
 pub mod pretty;
 
 pub use pretty::*;
diff --git a/ibc-query/src/core/channel/query.rs b/ibc-query/src/core/channel/query.rs
index 19875c78f..793ce5700 100644
--- a/ibc-query/src/core/channel/query.rs
+++ b/ibc-query/src/core/channel/query.rs
@@ -212,7 +212,7 @@ where
 }
 
 /// Queries for the packet commitment associated with a channel by the given
-/// sequence, channel and port ids
+/// sequence, channel, and port ids
 pub fn query_packet_commitment<I>(
     ibc_ctx: &I,
     request: &QueryPacketCommitmentRequest,
@@ -269,7 +269,7 @@ where
 }
 
 /// Queries for the packet receipt associated with a channel by the given
-/// sequence, channel and port ids
+/// sequence, channel, and port ids
 pub fn query_packet_receipt<I>(
     ibc_ctx: &I,
     request: &QueryPacketReceiptRequest,
@@ -304,7 +304,7 @@ where
 }
 
 /// Queries for the packet acknowledgement associated with a channel by the
-/// given sequence, channel and port ids
+/// given sequence, channel, and port ids
 pub fn query_packet_acknowledgement<I>(
     ibc_ctx: &I,
     request: &QueryPacketAcknowledgementRequest,
diff --git a/ibc-query/src/core/channel/service.rs b/ibc-query/src/core/channel/service.rs
index 9c4f7fa26..561778bc7 100644
--- a/ibc-query/src/core/channel/service.rs
+++ b/ibc-query/src/core/channel/service.rs
@@ -128,7 +128,7 @@ where
             .into_response()
     }
 
-    /// Returns all the acknowledgements if sequences is omitted.
+    /// Returns all the acknowledgements if sequences are omitted.
     async fn packet_acknowledgements(
         &self,
         request: Request<QueryPacketAcknowledgementsRequest>,
@@ -137,7 +137,7 @@ where
             .into_response()
     }
 
-    /// Returns all the unreceived packets if sequences is omitted.
+    /// Returns all the unreceived packets if sequences are omitted.
     async fn unreceived_packets(
         &self,
         request: Request<QueryUnreceivedPacketsRequest>,
@@ -145,7 +145,7 @@ where
         query_unreceived_packets(&self.ibc_context, &request.try_into_domain()?)?.into_response()
     }
 
-    /// Returns all the unreceived acknowledgements if sequences is omitted.
+    /// Returns all the unreceived acknowledgements if sequences are omitted.
     async fn unreceived_acks(
         &self,
         request: Request<QueryUnreceivedAcksRequest>,
diff --git a/ibc-query/src/core/client/types/request.rs b/ibc-query/src/core/client/types/request.rs
index 99e5f61a7..1cc5e4769 100644
--- a/ibc-query/src/core/client/types/request.rs
+++ b/ibc-query/src/core/client/types/request.rs
@@ -220,7 +220,7 @@ impl From<RawUpgradedClientStateRequest> for QueryUpgradedClientStateRequest {
 #[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
 #[cfg_attr(feature = "schema", derive(schemars::JsonSchema))]
 pub struct QueryUpgradedConsensusStateRequest {
-    /// Height at which the chain is scheduled to halt for upgrade.
+    /// The height at which the chain is scheduled to halt for upgrade.
     pub upgrade_height: Option<Height>,
     /// The height at which to query the upgraded consensus state. If not
     /// provided, the latest height should be used.
diff --git a/ibc-query/src/lib.rs b/ibc-query/src/lib.rs
index 504298398..710654c94 100644
--- a/ibc-query/src/lib.rs
+++ b/ibc-query/src/lib.rs
@@ -4,7 +4,7 @@
 //! Therefore, some ready-to-use Query structs for each layer of the client,
 //! connection, and channel have been implemented and exposed by this crate.
 //!
-//! The provided structs includes blanket implementation of their corresponding
+//! The provided structs include blanket implementation of their corresponding
 //! gRPC service traits, if the host implements the following _context_ traits:
 //! - [`ValidationContext`](ibc::core::host::ValidationContext)
 //! - [`ProvableContext`](crate::core::context::ProvableContext)
diff --git a/ibc-query/src/types.rs b/ibc-query/src/types.rs
index 147307a98..bc1ff1975 100644
--- a/ibc-query/src/types.rs
+++ b/ibc-query/src/types.rs
@@ -13,12 +13,12 @@ pub struct PageRequest {
     /// querying the next page most efficiently. Only one of offset or key
     /// should be set.
     pub key: Vec<u8>,
-    /// offset is a numeric offset that can be used when key is unavailable.
-    /// It is less efficient than using key. Only one of offset or key should
-    /// be set.
+    /// offset is a numeric offset that can be used when the key is unavailable.
+    /// It is less efficient than using the key.
+    /// Only one of offset or key should be set.
     pub offset: u64,
-    /// limit is the total number of results to be returned in the result page.
-    /// If left empty it will default to a value to be set by each app.
+    /// limit is the total number of results to be returned to the result page.
+    /// If left empty, it will default to a value to be set by each app.
     pub limit: u64,
     /// count_total is set to true  to indicate that the result set should include
     /// a count of the total number of items available for pagination in UIs.
@@ -70,7 +70,7 @@ pub struct PageResponse {
     /// query the next page most efficiently. It will be empty if
     /// there are no more results.
     pub next_key: Vec<u8>,
-    /// total is total number of results available if PageRequest.count_total
+    /// total is the total number of results available if PageRequest.count_total
     /// was set, its value is undefined otherwise
     pub total: u64,
 }
diff --git a/ibc-testkit/src/context.rs b/ibc-testkit/src/context.rs
index 7af55cc7d..4380de474 100644
--- a/ibc-testkit/src/context.rs
+++ b/ibc-testkit/src/context.rs
@@ -83,7 +83,7 @@ where
     H: TestHost,
     HostClientState<H>: ClientStateValidation<MockIbcStore<S>>,
 {
-    /// Returns a immutable reference to the IBC store.
+    /// Returns an immutable reference to the IBC store.
     pub fn ibc_store(&self) -> &MockIbcStore<S> {
         &self.ibc_store
     }
@@ -93,7 +93,7 @@ where
         &mut self.ibc_store
     }
 
-    /// Returns a immutable reference to the IBC router.
+    /// Returns an immutable reference to the IBC router.
     pub fn ibc_router(&self) -> &MockRouter {
         &self.ibc_router
     }
@@ -139,7 +139,7 @@ where
 
     /// Advance the first height of the host chain by generating a genesis block.
     ///
-    /// This method is exactly the same as [`Self::advance_genesis_height`].
+    /// This method is same as [`Self::advance_genesis_height`].
     /// But it bootstraps the genesis block by height 1 and `genesis_time`.
     ///
     /// The method starts and ends with [`Self::end_block`] and [`Self::begin_block`], just
@@ -366,7 +366,7 @@ where
         self
     }
 
-    /// Bootstraps a IBC connection to this context.
+    /// Bootstraps an IBC connection to this context.
     ///
     /// This does not bootstrap any light client.
     pub fn with_connection(
@@ -381,7 +381,7 @@ where
         self
     }
 
-    /// Bootstraps a IBC channel to this context.
+    /// Bootstraps an IBC channel to this context.
     ///
     /// This does not bootstrap any corresponding IBC connection or light client.
     pub fn with_channel(
@@ -429,7 +429,7 @@ where
         self
     }
 
-    /// Bootstraps a ack sequence to this context.
+    /// Bootstraps an ack sequence to this context.
     ///
     /// This does not bootstrap any corresponding IBC channel, connection or light client.
     pub fn with_ack_sequence(
@@ -479,7 +479,7 @@ where
 
     /// A datagram passes from the relayer to the IBC module (on host chain).
     /// Alternative method to `Ics18Context::send` that does not exercise any serialization.
-    /// Used in testing the Ics18 algorithms, hence this may return a Ics18Error.
+    /// Used in testing the Ics18 algorithms, hence this may return an Ics18Error.
     pub fn deliver(&mut self, msg: MsgEnvelope) -> Result<(), RelayerError> {
         self.dispatch(msg)
             .map_err(RelayerError::TransactionFailed)?;
diff --git a/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs b/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
index 299278789..ac09a89e0 100644
--- a/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
+++ b/ibc-testkit/src/fixtures/core/channel/acknowledgement.rs
@@ -7,7 +7,7 @@ use super::{dummy_proof, dummy_raw_packet};
 use crate::fixtures::core::signer::dummy_bech32_account;
 
 /// Returns a dummy `RawMsgAcknowledgement`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
+/// The `height` parametrizes the proof height as well as the timeout height.
 pub fn dummy_raw_msg_acknowledgement(height: u64) -> RawMsgAcknowledgement {
     dummy_raw_msg_ack_with_packet(dummy_raw_packet(height, 1), height)
 }
diff --git a/ibc-testkit/src/fixtures/core/channel/recv_packet.rs b/ibc-testkit/src/fixtures/core/channel/recv_packet.rs
index 0faeff71a..57403a69e 100644
--- a/ibc-testkit/src/fixtures/core/channel/recv_packet.rs
+++ b/ibc-testkit/src/fixtures/core/channel/recv_packet.rs
@@ -27,7 +27,7 @@ pub fn dummy_msg_recv_packet(
 }
 
 /// Returns a dummy `RawMsgRecvPacket`, for testing purposes only! The `height`
-/// parametrizes both the proof height as well as the timeout height.
+/// parametrizes the proof height as well as the timeout height.
 pub fn dummy_raw_msg_recv_packet(height: u64) -> RawMsgRecvPacket {
     let timestamp = Timestamp::now().add(Duration::from_secs(9));
     RawMsgRecvPacket {
diff --git a/ibc-testkit/src/fixtures/core/channel/timeout.rs b/ibc-testkit/src/fixtures/core/channel/timeout.rs
index 960dd4d57..97719aafd 100644
--- a/ibc-testkit/src/fixtures/core/channel/timeout.rs
+++ b/ibc-testkit/src/fixtures/core/channel/timeout.rs
@@ -5,7 +5,7 @@ use super::{dummy_proof, dummy_raw_packet};
 use crate::fixtures::core::signer::dummy_bech32_account;
 
 /// Returns a dummy `RawMsgTimeout`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
+/// The `height` parametrizes the proof height as well as the timeout height.
 pub fn dummy_raw_msg_timeout(
     proof_height: u64,
     timeout_height: u64,
diff --git a/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
index 2fc633160..165d0299f 100644
--- a/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
+++ b/ibc-testkit/src/fixtures/core/channel/timeout_on_close.rs
@@ -5,7 +5,7 @@ use super::{dummy_proof, dummy_raw_packet};
 use crate::fixtures::core::signer::dummy_bech32_account;
 
 /// Returns a dummy `RawMsgTimeoutOnClose`, for testing purposes only!
-/// The `height` parametrizes both the proof height as well as the timeout height.
+/// The `height` parametrizes the proof height as well as the timeout height.
 pub fn dummy_raw_msg_timeout_on_close(height: u64, timeout_timestamp: u64) -> RawMsgTimeoutOnClose {
     RawMsgTimeoutOnClose {
         packet: Some(dummy_raw_packet(height, timeout_timestamp)),
diff --git a/ibc-testkit/src/hosts/mod.rs b/ibc-testkit/src/hosts/mod.rs
index 426b69066..86b17cc54 100644
--- a/ibc-testkit/src/hosts/mod.rs
+++ b/ibc-testkit/src/hosts/mod.rs
@@ -30,7 +30,7 @@ pub trait TestHost: Default + Debug + Sized {
     /// The type of client state produced by the host.
     type ClientState: Into<AnyClientState> + Debug;
 
-    /// The type of block parameters to produce a block.
+    /// The type of block parameter to produce a block.
     type BlockParams: Debug + Default;
 
     /// The type of light client parameters to produce a light client state.
diff --git a/ibc-testkit/src/relayer/context.rs b/ibc-testkit/src/relayer/context.rs
index 43f2a612f..9ea3bd196 100644
--- a/ibc-testkit/src/relayer/context.rs
+++ b/ibc-testkit/src/relayer/context.rs
@@ -34,22 +34,22 @@ where
         Self { ctx_a, ctx_b }
     }
 
-    /// Returns immutable reference to the first context.
+    /// Returns an immutable reference to the first context.
     pub fn get_ctx_a(&self) -> &TestContext<A> {
         &self.ctx_a
     }
 
-    /// Returns immutable reference to the second context.
+    /// Returns an immutable reference to the second context.
     pub fn get_ctx_b(&self) -> &TestContext<B> {
         &self.ctx_b
     }
 
-    /// Returns mutable reference to the first context.
+    /// Returns a mutable reference to the first context.
     pub fn get_ctx_a_mut(&mut self) -> &mut TestContext<A> {
         &mut self.ctx_a
     }
 
-    /// Returns mutable reference to the second context.
+    /// Returns a mutable reference to the second context.
     pub fn get_ctx_b_mut(&mut self) -> &mut TestContext<B> {
         &mut self.ctx_b
     }
@@ -359,8 +359,8 @@ where
         )
     }
 
-    /// Times out a packet from the first context to the second context by
-    /// waiting for timeout period and then sending timeout packet on first context.
+    /// Times out a packet from the first context to the second context by waiting
+    /// for the timeout period and then sending a timeout packet to the first context.
     ///
     /// The IBC packet is created by an IBC application on the first context.
     pub fn timeout_packet_from_a(&mut self, packet: Packet, signer: Signer) {
@@ -412,8 +412,8 @@ where
         )
     }
 
-    /// Timeouts a packet from the first context on the second context by closing the
-    /// corresponding channel is closed and then sending a timeout packet on the first context.
+    /// Timeouts a packet from the first context to the second context by closing the
+    /// corresponding channel is closed and then sending a timeout packet to the first context.
     ///
     /// The IBC packet is created by an IBC application on the first context.
     pub fn timeout_packet_from_a_on_channel_close(&mut self, packet: Packet, signer: Signer) {
diff --git a/ibc-testkit/src/relayer/error.rs b/ibc-testkit/src/relayer/error.rs
index 2e5c368c8..20a995461 100644
--- a/ibc-testkit/src/relayer/error.rs
+++ b/ibc-testkit/src/relayer/error.rs
@@ -8,13 +8,13 @@ use ibc::core::host::types::identifiers::ClientId;
 pub enum RelayerError {
     /// client state on destination chain not found, (client id: `{client_id}`)
     ClientStateNotFound { client_id: ClientId },
-    /// the client on destination chain is already up-to-date (client id: `{client_id}`, source height: `{source_height}`, dest height: `{destination_height}`)
+    /// the client on the destination chain is already up-to-date (client id: `{client_id}`, source height: `{source_height}`, dest height: `{destination_height}`)
     ClientAlreadyUpToDate {
         client_id: ClientId,
         source_height: Height,
         destination_height: Height,
     },
-    /// the client on destination chain is at a higher height (client id: `{client_id}`, source height: `{source_height}`, dest height: `{destination_height}`)
+    /// the client on the destination chain is at a higher height (client id: `{client_id}`, source height: `{source_height}`, dest height: `{destination_height}`)
     ClientAtHigherHeight {
         client_id: ClientId,
         source_height: Height,
diff --git a/ibc-testkit/src/relayer/utils.rs b/ibc-testkit/src/relayer/utils.rs
index 7987f9ca3..cd3c5f0a3 100644
--- a/ibc-testkit/src/relayer/utils.rs
+++ b/ibc-testkit/src/relayer/utils.rs
@@ -621,7 +621,7 @@ where
         };
     }
 
-    /// `A` initiates the channel closing with the other end on `B`.
+    /// `A` initiates the channel closing, with the other end on `B`.
     /// `A` stops processing the channel.
     pub fn channel_close_init_on_a(
         ctx_a: &mut TestContext<A>,
diff --git a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
index 386a83efb..d650cccd1 100644
--- a/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
+++ b/ibc-testkit/src/testapp/ibc/core/core_ctx.rs
@@ -647,7 +647,7 @@ where
     }
 
     /// Called upon client creation.
-    /// Increases the counter which keeps track of how many clients have been created.
+    /// Increases the counter, that keeps track of how many clients have been created.
     fn increase_client_counter(&mut self) -> Result<(), ContextError> {
         let current_sequence = self
             .client_counter
@@ -699,7 +699,7 @@ where
     }
 
     /// Called upon connection identifier creation (Init or Try process).
-    /// Increases the counter which keeps track of how many connections have been created.
+    /// Increases the counter, that keeps track of how many connections have been created.
     fn increase_connection_counter(&mut self) -> Result<(), ContextError> {
         let current_sequence = self
             .conn_counter
diff --git a/ibc-testkit/src/testapp/ibc/core/router/types.rs b/ibc-testkit/src/testapp/ibc/core/router/types.rs
index b48cd7fbd..739c0ba4f 100644
--- a/ibc-testkit/src/testapp/ibc/core/router/types.rs
+++ b/ibc-testkit/src/testapp/ibc/core/router/types.rs
@@ -12,7 +12,7 @@ use crate::testapp::ibc::applications::transfer::types::DummyTransferModule;
 pub struct MockRouter {
     pub router: BTreeMap<ModuleId, Arc<dyn Module>>,
 
-    /// Maps ports to the the module that owns it
+    /// Maps ports to the module that owns it
     pub port_to_module: BTreeMap<PortId, ModuleId>,
 }
 
diff --git a/ibc-testkit/src/utils/mod.rs b/ibc-testkit/src/utils/mod.rs
index 80eb0bad4..774c4076c 100644
--- a/ibc-testkit/src/utils/mod.rs
+++ b/ibc-testkit/src/utils/mod.rs
@@ -1,13 +1,13 @@
 use ibc::primitives::Timestamp;
 use tendermint::Time;
 
-/// Returns a `Timestamp` representation of beginning of year 2023.
+/// Returns a `Timestamp` representation of the beginning of year 2023.
 ///
 /// This is introduced to initialize [`StoreGenericTestContext`](crate::context::StoreGenericTestContext)s
 /// with the same latest timestamp by default.
 /// If two [`StoreGenericTestContext`](crate::context::StoreGenericTestContext)
-/// are initialized using [`Time::now()`], second one will have a greater timestamp than the first one.
-/// So, the latest header of the second context can not be submitted to first one.
+/// are initialized using [`Time::now()`], the second one will have a greater timestamp than the first one.
+/// So, the latest header of the second context cannot be submitted to first one.
 /// We can still set a custom timestamp via [`TestContextConfig`](crate::fixtures::core::context::TestContextConfig).
 pub fn year_2023() -> Timestamp {
     // Sun Jan 01 2023 00:00:00 GMT+0000
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/ibc-testkit/tests/core/ics02_client/update_client.rs
index 9dbc49030..d5f19f8eb 100644
--- a/ibc-testkit/tests/core/ics02_client/update_client.rs
+++ b/ibc-testkit/tests/core/ics02_client/update_client.rs
@@ -1562,7 +1562,7 @@ where
 
 /// Serves to test both ICS-26 `dispatch` & `build_client_update_datagram` functions.
 /// Implements a "ping pong" of client update messages, so that two chains repeatedly
-/// process a client update message and update their height in succession.
+/// process a client update message and update their height in sequence.
 #[rstest]
 fn client_update_ping_pong() {
     let chain_a_start_height = Height::new(1, 11).unwrap();
diff --git a/ibc-testkit/tests/cosmwasm/helper.rs b/ibc-testkit/tests/cosmwasm/helper.rs
index 666a7e83f..f1c9ad74b 100644
--- a/ibc-testkit/tests/cosmwasm/helper.rs
+++ b/ibc-testkit/tests/cosmwasm/helper.rs
@@ -25,8 +25,8 @@ pub fn dummy_sov_consensus_state(timestamp: IbcTimestamp) -> ConsensusState {
     )
 }
 
-/// Returns a mock environment with the current timestamp. This is define to use
-/// for testing client expiry and other time-sensitive operations.
+/// Returns a mock environment with the current timestamp. This is defined
+/// to be used for testing client expiry and other time-sensitive operations.
 pub fn mock_env_with_timestamp_now() -> Env {
     let mut env = mock_env();
     let now_nanos = IbcTimestamp::now().nanoseconds();
diff --git a/ibc/src/lib.rs b/ibc/src/lib.rs
index 66b64d168..a6e22ba20 100644
--- a/ibc/src/lib.rs
+++ b/ibc/src/lib.rs
@@ -79,7 +79,7 @@ pub mod derive {
     /// - `#[execution(<YourClientExecutionContext>)]`
     ///
     /// The argument to the `validation` or `execution` attributes may contain
-    /// lifetimes or generic types and even that types might be bounded by
+    /// lifetimes or generic types, and even that types might be bounded by
     /// traits. For instance:
     ///
     /// - `#[validation(Context<S>)]`

From 01506d4c9275760c5437f8e6af23771b77927e12 Mon Sep 17 00:00:00 2001
From: cario-dev <152556479+cario-dev@users.noreply.github.com>
Date: Thu, 23 May 2024 12:36:48 +0200
Subject: [PATCH 177/182] ci(deps): upgrade `checkout` action to version with
 `node20` (#1225)

* upgrade checkout action to version with node20

* dependabot entry for github actions

---------

Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .github/dependabot.yml                     |  4 ++++
 .github/workflows/audit.yaml               |  2 +-
 .github/workflows/coverage.yaml            |  2 +-
 .github/workflows/markdown-link-check.yaml |  2 +-
 .github/workflows/no-std.yaml              |  4 ++--
 .github/workflows/rust.yaml                | 14 +++++++-------
 6 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/.github/dependabot.yml b/.github/dependabot.yml
index 33ee6a971..0e2e3b557 100644
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -30,3 +30,7 @@ updates:
       - dependency-name: "ibc*"
       - dependency-name: "cosmwasm*"
       - dependency-name: "cw*"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
diff --git a/.github/workflows/audit.yaml b/.github/workflows/audit.yaml
index 2c8286bfc..a0d2ca210 100644
--- a/.github/workflows/audit.yaml
+++ b/.github/workflows/audit.yaml
@@ -8,7 +8,7 @@ jobs:
     name: Security Audit
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Cache cargo bin
         uses: actions/cache@v1
         with:
diff --git a/.github/workflows/coverage.yaml b/.github/workflows/coverage.yaml
index bd234f66b..3a0d2728b 100644
--- a/.github/workflows/coverage.yaml
+++ b/.github/workflows/coverage.yaml
@@ -41,7 +41,7 @@ jobs:
     name: Code Coverage
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - name: Install Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
diff --git a/.github/workflows/markdown-link-check.yaml b/.github/workflows/markdown-link-check.yaml
index 6a2932200..b95f1c746 100644
--- a/.github/workflows/markdown-link-check.yaml
+++ b/.github/workflows/markdown-link-check.yaml
@@ -9,7 +9,7 @@ jobs:
   md-link-check:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: markdown-link-check
         uses: gaurav-nelson/github-action-markdown-link-check@1.0.15
         with:
diff --git a/.github/workflows/no-std.yaml b/.github/workflows/no-std.yaml
index 27ba597bf..03919ddda 100644
--- a/.github/workflows/no-std.yaml
+++ b/.github/workflows/no-std.yaml
@@ -30,7 +30,7 @@ jobs:
     name: Check no_std panic conflict
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -42,7 +42,7 @@ jobs:
     name: Check no_std substrate support
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: nightly-2024-02-24
diff --git a/.github/workflows/rust.yaml b/.github/workflows/rust.yaml
index e6e522820..e1053e897 100644
--- a/.github/workflows/rust.yaml
+++ b/.github/workflows/rust.yaml
@@ -51,7 +51,7 @@ jobs:
   nightly_fmt:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: nightly # Since fmt uses unstable features for organizing imports
@@ -64,7 +64,7 @@ jobs:
   clippy_all_features:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -77,7 +77,7 @@ jobs:
   clippy_no_default_features:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -90,7 +90,7 @@ jobs:
   doc_all_features:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -102,7 +102,7 @@ jobs:
   doc_no_default_features:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -115,7 +115,7 @@ jobs:
     runs-on: ubuntu-latest
     timeout-minutes: 30
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           toolchain: stable
@@ -146,7 +146,7 @@ jobs:
           ]
     runs-on: ${{ matrix.param.os }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Download cargo-msrv
         uses: dsaltares/fetch-gh-release-asset@master

From 124fb4a63fc7d8a5dd3fb8210333dab61bc17a61 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 23 May 2024 06:47:15 -0400
Subject: [PATCH 178/182] chore(deps): bump crate-ci/typos from 1.19.0 to
 1.21.0 (#1234)

* chore(deps): bump crate-ci/typos from 1.19.0 to 1.21.0

Bumps [crate-ci/typos](https://github.com/crate-ci/typos) from 1.19.0 to 1.21.0.
- [Release notes](https://github.com/crate-ci/typos/releases)
- [Changelog](https://github.com/crate-ci/typos/blob/master/CHANGELOG.md)
- [Commits](https://github.com/crate-ci/typos/compare/v1.19.0...v1.21.0)

---
updated-dependencies:
- dependency-name: crate-ci/typos
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>

* fix false positive

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
---
 .github/typos.toml                  | 4 ++++
 .github/workflows/code-quality.yaml | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/.github/typos.toml b/.github/typos.toml
index fc71242c0..800f45933 100644
--- a/.github/typos.toml
+++ b/.github/typos.toml
@@ -1,3 +1,7 @@
 [default.extend-words]
 # for serde serialization
 ser = "ser"
+
+[default]
+# random string
+extend-ignore-re = [ "[0-9A-Za-z+/]{20,}" ]
diff --git a/.github/workflows/code-quality.yaml b/.github/workflows/code-quality.yaml
index 307efeee0..0254773d2 100644
--- a/.github/workflows/code-quality.yaml
+++ b/.github/workflows/code-quality.yaml
@@ -16,7 +16,7 @@ jobs:
         run: bash ci/code-quality/whitespace-lints.sh
 
       - name: Spell Check with Typos
-        uses: crate-ci/typos@v1.19.0 # NOTE: Newer versions detect false positives. Test locally before upgrading.
+        uses: crate-ci/typos@v1.21.0
         with:
           config: ./.github/typos.toml
 

From fba5da792d8ca271f06b0a0544b44a067cef85c9 Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 23 May 2024 06:52:53 -0400
Subject: [PATCH 179/182] chore(deps): bump codecov/codecov-action from 3 to 4
 (#1235)

Bumps [codecov/codecov-action](https://github.com/codecov/codecov-action) from 3 to 4.
- [Release notes](https://github.com/codecov/codecov-action/releases)
- [Changelog](https://github.com/codecov/codecov-action/blob/main/CHANGELOG.md)
- [Commits](https://github.com/codecov/codecov-action/compare/v3...v4)

---
updated-dependencies:
- dependency-name: codecov/codecov-action
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/coverage.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/coverage.yaml b/.github/workflows/coverage.yaml
index 3a0d2728b..60346fe1f 100644
--- a/.github/workflows/coverage.yaml
+++ b/.github/workflows/coverage.yaml
@@ -53,7 +53,7 @@ jobs:
       - name: Generate code coverage
         run: cargo llvm-cov nextest --all-features --lcov --output-path lcov.info
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v4
         with:
           files: lcov.info
           token: ${{ secrets.CODECOV_TOKEN }}

From 26797675782f23cf1768b4cc6d4d2e8aa53ab65d Mon Sep 17 00:00:00 2001
From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com>
Date: Thu, 23 May 2024 06:53:36 -0400
Subject: [PATCH 180/182] chore(deps): bump actions/cache from 1 to 4 (#1236)

Bumps [actions/cache](https://github.com/actions/cache) from 1 to 4.
- [Release notes](https://github.com/actions/cache/releases)
- [Changelog](https://github.com/actions/cache/blob/main/RELEASES.md)
- [Commits](https://github.com/actions/cache/compare/v1...v4)

---
updated-dependencies:
- dependency-name: actions/cache
  dependency-type: direct:production
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
---
 .github/workflows/audit.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/audit.yaml b/.github/workflows/audit.yaml
index a0d2ca210..b4f1f3118 100644
--- a/.github/workflows/audit.yaml
+++ b/.github/workflows/audit.yaml
@@ -10,7 +10,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - name: Cache cargo bin
-        uses: actions/cache@v1
+        uses: actions/cache@v4
         with:
           path: ~/.cargo/bin
           key: ${{ runner.os }}-cargo-audit-v0.11.2

From 2378cd4ba45094b8ed856ff7dba5f1d0882f59ae Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Thu, 23 May 2024 08:23:10 -0500
Subject: [PATCH 181/182] Move `ibc-testkit` integration tests into
 `tests-integration` directory (#1233)

* Move ibc-testkit tests into tests-integration directory

* Fix include_str paths

* Remove unnecessary dependencies from ibc-testkit

* Remove unnecessary dev-dependencies from ibc-testkit

* Add ibc-testkit/serde to serde dependency

* Format ibc-testkit cargo.toml

* Remove unnecessary serde feature from tests-integration crate

* Fix typos

* Move json test data into ibc-testkit

* Move some tests around

* Cargo fmt check

* Gate tests behind serde feature

* Switch doc_comment to doc attribute

* Remove doc-comment dependency

* Move client state unit tests back to ibc-clients

* Add comment about internal crates

* Move test_serialization_roundtrip function to utils

* Assert that serialized string matches json input

* Change serde_json -> dep:serde_json

* Remove features section from cargo.toml

* Remove unused imports

* taplo fmt

* Add features section back to cargo.toml

* update readme and crate description

* format toml

* disable features

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>

---------

Signed-off-by: Rano | Ranadeep <ranadip.bswas@gmail.com>
Co-authored-by: Ranadeep Biswas <mail@rnbguy.at>
Co-authored-by: Rano | Ranadeep <ranadeep@informal.systems>
---
 Cargo.toml                                    |  3 +
 ibc-clients/ics07-tendermint/Cargo.toml       | 17 +++---
 .../types/src/client_state.rs                 | 44 --------------
 .../types/src/consensus_state.rs              | 25 --------
 ibc-query/Cargo.toml                          | 17 +++---
 ibc-testkit/Cargo.toml                        | 20 ++-----
 .../data/json/signed_header.json              |  0
 .../src/fixtures/clients/tendermint.rs        |  5 +-
 ibc-testkit/src/utils/mod.rs                  | 25 ++++++++
 tests-integration/Cargo.toml                  | 57 +++++++++++++++++++
 tests-integration/README.md                   |  3 +
 tests-integration/src/lib.rs                  |  1 +
 .../tests/applications/mod.rs                 |  0
 .../tests/applications/nft_transfer.rs        |  0
 .../tests/applications/transfer.rs            |  0
 .../clients/ics07_tendermint/client_state.rs  | 23 ++++++++
 .../ics07_tendermint/consensus_state.rs       | 23 ++++++++
 .../tests/clients/ics07_tendermint/mod.rs     |  2 +
 tests-integration/tests/clients/mod.rs        |  1 +
 .../tests/core/ics02_client/create_client.rs  |  8 ++-
 .../tests/core/ics02_client/mod.rs            |  0
 .../tests/core/ics02_client/recover_client.rs |  0
 .../tests/core/ics02_client/update_client.rs  |  0
 .../tests/core/ics02_client/upgrade_client.rs |  0
 .../core/ics03_connection/conn_open_ack.rs    |  0
 .../ics03_connection/conn_open_confirm.rs     |  0
 .../core/ics03_connection/conn_open_init.rs   |  0
 .../core/ics03_connection/conn_open_try.rs    |  0
 .../tests/core/ics03_connection/mod.rs        |  0
 .../core/ics04_channel/acknowledgement.rs     |  0
 .../core/ics04_channel/chan_close_confirm.rs  |  0
 .../core/ics04_channel/chan_close_init.rs     |  0
 .../tests/core/ics04_channel/chan_open_ack.rs |  0
 .../core/ics04_channel/chan_open_confirm.rs   |  0
 .../core/ics04_channel/chan_open_init.rs      |  0
 .../tests/core/ics04_channel/chan_open_try.rs |  0
 .../tests/core/ics04_channel/mod.rs           |  0
 .../tests/core/ics04_channel/recv_packet.rs   |  0
 .../tests/core/ics04_channel/send_packet.rs   |  0
 .../tests/core/ics04_channel/timeout.rs       |  0
 .../core/ics04_channel/timeout_on_close.rs    |  0
 .../tests/core/mod.rs                         |  0
 .../tests/core/router.rs                      |  0
 .../tests/cosmwasm/fixture.rs                 |  0
 .../tests/cosmwasm/helper.rs                  |  0
 .../tests/cosmwasm/mod.rs                     |  0
 .../tests/data/json/client_state.json         |  0
 .../tests/data/json/client_state_proof.json   |  0
 .../tests/data/json/consensus_state.json      |  0
 .../data/json/consensus_state_proof.json      |  0
 .../tests/mod.rs                              |  1 +
 51 files changed, 169 insertions(+), 106 deletions(-)
 rename ibc-testkit/{tests => src}/data/json/signed_header.json (100%)
 create mode 100644 tests-integration/Cargo.toml
 create mode 100644 tests-integration/README.md
 create mode 100644 tests-integration/src/lib.rs
 rename {ibc-testkit => tests-integration}/tests/applications/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/applications/nft_transfer.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/applications/transfer.rs (100%)
 create mode 100644 tests-integration/tests/clients/ics07_tendermint/client_state.rs
 create mode 100644 tests-integration/tests/clients/ics07_tendermint/consensus_state.rs
 create mode 100644 tests-integration/tests/clients/ics07_tendermint/mod.rs
 create mode 100644 tests-integration/tests/clients/mod.rs
 rename {ibc-testkit => tests-integration}/tests/core/ics02_client/create_client.rs (96%)
 rename {ibc-testkit => tests-integration}/tests/core/ics02_client/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics02_client/recover_client.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics02_client/update_client.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics02_client/upgrade_client.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics03_connection/conn_open_ack.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics03_connection/conn_open_confirm.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics03_connection/conn_open_init.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics03_connection/conn_open_try.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics03_connection/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/acknowledgement.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_close_confirm.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_close_init.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_open_ack.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_open_confirm.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_open_init.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/chan_open_try.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/recv_packet.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/send_packet.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/timeout.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/ics04_channel/timeout_on_close.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/core/router.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/cosmwasm/fixture.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/cosmwasm/helper.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/cosmwasm/mod.rs (100%)
 rename {ibc-testkit => tests-integration}/tests/data/json/client_state.json (100%)
 rename {ibc-testkit => tests-integration}/tests/data/json/client_state_proof.json (100%)
 rename {ibc-testkit => tests-integration}/tests/data/json/consensus_state.json (100%)
 rename {ibc-testkit => tests-integration}/tests/data/json/consensus_state_proof.json (100%)
 rename {ibc-testkit => tests-integration}/tests/mod.rs (92%)

diff --git a/Cargo.toml b/Cargo.toml
index 161996e4d..9d7ab0302 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -35,6 +35,9 @@ members = [
   "ibc",
   "ibc-query",
   "ibc-testkit",
+
+  # internal crates that are not published
+  "tests-integration",
 ]
 exclude = [
   "ci/cw-check",
diff --git a/ibc-clients/ics07-tendermint/Cargo.toml b/ibc-clients/ics07-tendermint/Cargo.toml
index e9983c8ec..93cab56a6 100644
--- a/ibc-clients/ics07-tendermint/Cargo.toml
+++ b/ibc-clients/ics07-tendermint/Cargo.toml
@@ -1,13 +1,14 @@
 [package]
-name = "ibc-client-tendermint"
-version = { workspace = true }
-authors = { workspace = true }
-edition = { workspace = true }
+name         = "ibc-client-tendermint"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
 rust-version = { workspace = true }
-license = { workspace = true }
-repository = { workspace = true }
-readme = "./../README.md"
-keywords = [ "blockchain", "consensus", "cosmos", "ibc", "tendermint" ]
+license      = { workspace = true }
+repository   = { workspace = true }
+readme       = "./../README.md"
+keywords     = [ "blockchain", "consensus", "cosmos", "ibc", "tendermint" ]
+
 description = """
     Maintained by `ibc-rs`, contains the implementation of the ICS-07 Tendermint Client logic
     and re-exports essential data structures and domain types from `ibc-client-tendermint-types` crate.
diff --git a/ibc-clients/ics07-tendermint/types/src/client_state.rs b/ibc-clients/ics07-tendermint/types/src/client_state.rs
index 474aa32f5..bcd42a525 100644
--- a/ibc-clients/ics07-tendermint/types/src/client_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/client_state.rs
@@ -365,50 +365,6 @@ impl From<ClientState> for Any {
     }
 }
 
-#[cfg(all(test, feature = "serde"))]
-pub(crate) mod serde_tests {
-    use serde::de::DeserializeOwned;
-    use serde::Serialize;
-    use tendermint_rpc::endpoint::abci_query::AbciQuery;
-
-    pub fn test_serialization_roundtrip<T>(json_data: &str)
-    where
-        T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
-    {
-        let parsed0 = serde_json::from_str::<T>(json_data);
-        assert!(parsed0.is_ok());
-        let parsed0 = parsed0.unwrap();
-
-        let serialized = serde_json::to_string(&parsed0);
-        assert!(serialized.is_ok());
-        let serialized = serialized.unwrap();
-
-        let parsed1 = serde_json::from_str::<T>(&serialized);
-        assert!(parsed1.is_ok());
-        let parsed1 = parsed1.unwrap();
-
-        assert_eq!(parsed0, parsed1);
-    }
-
-    #[test]
-    fn serialization_roundtrip_no_proof() {
-        let json_data = include_str!(concat!(
-            env!("CARGO_MANIFEST_DIR"),
-            "/../../../ibc-testkit/tests/data/json/client_state.json"
-        ));
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-
-    #[test]
-    fn serialization_roundtrip_with_proof() {
-        let json_data = include_str!(concat!(
-            env!("CARGO_MANIFEST_DIR"),
-            "/../../../ibc-testkit/tests/data/json/client_state_proof.json"
-        ));
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-}
-
 #[cfg(test)]
 mod tests {
     use super::*;
diff --git a/ibc-clients/ics07-tendermint/types/src/consensus_state.rs b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
index e48b016c3..bc4e675c8 100644
--- a/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
+++ b/ibc-clients/ics07-tendermint/types/src/consensus_state.rs
@@ -147,28 +147,3 @@ impl From<Header> for ConsensusState {
         Self::from(header.signed_header.header)
     }
 }
-
-#[cfg(all(test, feature = "serde"))]
-mod tests {
-    use tendermint_rpc::endpoint::abci_query::AbciQuery;
-
-    use crate::serde_tests::test_serialization_roundtrip;
-
-    #[test]
-    fn serialization_roundtrip_no_proof() {
-        let json_data = include_str!(concat!(
-            env!("CARGO_MANIFEST_DIR"),
-            "/../../../ibc-testkit/tests/data/json/consensus_state.json"
-        ));
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-
-    #[test]
-    fn serialization_roundtrip_with_proof() {
-        let json_data = include_str!(concat!(
-            env!("CARGO_MANIFEST_DIR"),
-            "/../../../ibc-testkit/tests/data/json/consensus_state_proof.json"
-        ));
-        test_serialization_roundtrip::<AbciQuery>(json_data);
-    }
-}
diff --git a/ibc-query/Cargo.toml b/ibc-query/Cargo.toml
index 531629343..38ec2e048 100644
--- a/ibc-query/Cargo.toml
+++ b/ibc-query/Cargo.toml
@@ -1,13 +1,14 @@
 [package]
-name = "ibc-query"
-version = { workspace = true }
-authors = { workspace = true }
-edition = { workspace = true }
+name         = "ibc-query"
+version      = { workspace = true }
+authors      = { workspace = true }
+edition      = { workspace = true }
 rust-version = { workspace = true }
-license = { workspace = true }
-repository = { workspace = true }
-readme = "README.md"
-keywords = [ "blockchain", "cosmos", "ibc", "rpc", "grpc" ]
+license      = { workspace = true }
+repository   = { workspace = true }
+readme       = "README.md"
+keywords     = [ "blockchain", "cosmos", "ibc", "rpc", "grpc" ]
+
 description = """
     Maintained by `ibc-rs`, contains essential IBC query types, utility functions and
     gRPC service implementations for the IBC core.
diff --git a/ibc-testkit/Cargo.toml b/ibc-testkit/Cargo.toml
index 9d64c492b..1ce60b37c 100644
--- a/ibc-testkit/Cargo.toml
+++ b/ibc-testkit/Cargo.toml
@@ -25,15 +25,12 @@ schemars        = { workspace = true, optional = true }
 serde           = { workspace = true, optional = true }
 serde_json      = { workspace = true, optional = true }
 subtle-encoding = { workspace = true }
-tracing         = { version = "0.1.40", default-features = false }
 typed-builder   = { version = "0.18.0" }
 
 # ibc dependencies
-ibc                      = { workspace = true, features = [ "std" ] }
-ibc-proto                = { workspace = true }
-ibc-client-cw            = { workspace = true }
-ibc-client-tendermint-cw = { workspace = true }
-ibc-query                = { workspace = true }
+ibc       = { workspace = true, features = [ "std" ] }
+ibc-proto = { workspace = true }
+ibc-query = { workspace = true }
 
 # basecoin dependencies
 basecoin-store = { version = "0.1.0" }
@@ -43,20 +40,13 @@ tendermint         = { workspace = true }
 tendermint-testgen = { workspace = true }
 
 [dev-dependencies]
-env_logger         = { version = "0.11.0" }
-tracing-subscriber = { version = "0.3.17", features = [ "fmt", "env-filter", "json" ] }
-test-log           = { version = "0.2.13", features = [ "trace" ] }
-hex                = { version = "0.4.2" }
-rstest             = { workspace = true }
-cosmwasm-vm        = { workspace = true }
-cosmwasm-std       = { workspace = true }
+hex    = { version = "0.4.2" }
+rstest = { workspace = true }
 
 [features]
 default = [ "std" ]
 std = [
   "serde/std",
-  "tracing/std",
-  "tracing-subscriber/std",
   "serde_json/std",
   "ibc/std",
   "ibc-proto/std",
diff --git a/ibc-testkit/tests/data/json/signed_header.json b/ibc-testkit/src/data/json/signed_header.json
similarity index 100%
rename from ibc-testkit/tests/data/json/signed_header.json
rename to ibc-testkit/src/data/json/signed_header.json
diff --git a/ibc-testkit/src/fixtures/clients/tendermint.rs b/ibc-testkit/src/fixtures/clients/tendermint.rs
index 47b885a52..aaa49a5d7 100644
--- a/ibc-testkit/src/fixtures/clients/tendermint.rs
+++ b/ibc-testkit/src/fixtures/clients/tendermint.rs
@@ -117,7 +117,7 @@ pub fn dummy_tendermint_header() -> tendermint::block::Header {
 
     serde_json::from_str::<SignedHeader>(include_str!(concat!(
         env!("CARGO_MANIFEST_DIR"),
-        "/tests/data/json/signed_header.json"
+        "/src/data/json/signed_header.json"
     )))
     .expect("Never fails")
     .header
@@ -147,7 +147,7 @@ pub fn dummy_ics07_header() -> Header {
     // Build a SignedHeader from a JSON file.
     let shdr = serde_json::from_str::<SignedHeader>(include_str!(concat!(
         env!("CARGO_MANIFEST_DIR"),
-        "/tests/data/json/signed_header.json"
+        "/src/data/json/signed_header.json"
     )))
     .expect("Never fails");
 
@@ -174,7 +174,6 @@ pub fn dummy_ics07_header() -> Header {
 
 #[cfg(all(test, feature = "serde"))]
 mod tests {
-
     use ibc::primitives::proto::Any;
     use rstest::rstest;
 
diff --git a/ibc-testkit/src/utils/mod.rs b/ibc-testkit/src/utils/mod.rs
index 774c4076c..94163e32e 100644
--- a/ibc-testkit/src/utils/mod.rs
+++ b/ibc-testkit/src/utils/mod.rs
@@ -1,4 +1,6 @@
 use ibc::primitives::Timestamp;
+#[cfg(feature = "serde")]
+use serde::{de::DeserializeOwned, Serialize};
 use tendermint::Time;
 
 /// Returns a `Timestamp` representation of the beginning of year 2023.
@@ -15,3 +17,26 @@ pub fn year_2023() -> Timestamp {
         .expect("should be a valid time")
         .into()
 }
+
+/// Utility function that asserts that the given JSON input can be
+/// serialized into and deserialized from the specified type `T`.
+#[cfg(feature = "serde")]
+pub fn test_serialization_roundtrip<T>(json_data: &str)
+where
+    T: core::fmt::Debug + PartialEq + Serialize + DeserializeOwned,
+{
+    let parsed0 = serde_json::from_str::<T>(json_data);
+    assert!(parsed0.is_ok());
+    let parsed0 = parsed0.expect("should not fail");
+
+    let serialized = serde_json::to_string(&parsed0);
+    assert!(serialized.is_ok());
+    let serialized = serialized.expect("should not fail");
+    assert_eq!(serialized, json_data);
+
+    let parsed1 = serde_json::from_str::<T>(&serialized);
+    assert!(parsed1.is_ok());
+    let parsed1 = parsed1.expect("should not fail");
+
+    assert_eq!(parsed0, parsed1);
+}
diff --git a/tests-integration/Cargo.toml b/tests-integration/Cargo.toml
new file mode 100644
index 000000000..26877042b
--- /dev/null
+++ b/tests-integration/Cargo.toml
@@ -0,0 +1,57 @@
+[package]
+name        = "tests-integration"
+version     = "0.1.0"
+authors     = { workspace = true }
+license     = { workspace = true }
+edition     = { workspace = true }
+repository  = { workspace = true }
+readme      = "README.md"
+keywords    = [ "blockchain", "consensus", "cosmos", "ibc", "tendermint" ]
+publish     = false
+description = "Integration tests using `ibc-testkit` and the other IBC crates."
+
+[dependencies]
+# external dependencies
+serde           = { workspace = true, optional = true }
+serde_json      = { workspace = true, optional = true }
+subtle-encoding = { workspace = true }
+tracing         = { version = "0.1.40", default-features = false }
+
+# ibc dependencies
+ibc                         = { workspace = true }
+ibc-core-client-types       = { workspace = true }
+ibc-core-commitment-types   = { workspace = true }
+ibc-client-cw               = { workspace = true }
+ibc-client-tendermint-cw    = { workspace = true }
+ibc-client-tendermint-types = { workspace = true }
+ibc-core-host-types         = { workspace = true }
+ibc-primitives              = { workspace = true }
+ibc-query                   = { workspace = true }
+ibc-testkit                 = { workspace = true }
+
+# basecoin dependencies
+basecoin-store = { version = "0.1.0" }
+
+# cosmos dependencies
+tendermint         = { workspace = true }
+tendermint-testgen = { workspace = true }
+
+[dev_dependencies]
+cosmwasm-std   = { workspace = true }
+hex            = { version = "0.4.2" }
+rstest         = { workspace = true }
+test-log       = { version = "0.2.13", features = [ "trace" ] }
+tendermint-rpc = { workspace = true }
+
+[features]
+default = [ "std" ]
+std = [
+  "serde/std",
+  "serde_json/std",
+  "ibc/std",
+  "ibc/serde",
+  "ibc-testkit/serde",
+  "tendermint/std",
+  "dep:serde",
+  "dep:serde_json",
+]
diff --git a/tests-integration/README.md b/tests-integration/README.md
new file mode 100644
index 000000000..cc6ec8863
--- /dev/null
+++ b/tests-integration/README.md
@@ -0,0 +1,3 @@
+Integration tests that make use of the types exposed by `ibc-testkit`. These
+tests also depend upon the other IBC crates. They live in a separate crate, that
+is not meant to be published, to avoid circular dependencies.
diff --git a/tests-integration/src/lib.rs b/tests-integration/src/lib.rs
new file mode 100644
index 000000000..7913c79d6
--- /dev/null
+++ b/tests-integration/src/lib.rs
@@ -0,0 +1 @@
+#![doc = include_str!("../README.md")]
diff --git a/ibc-testkit/tests/applications/mod.rs b/tests-integration/tests/applications/mod.rs
similarity index 100%
rename from ibc-testkit/tests/applications/mod.rs
rename to tests-integration/tests/applications/mod.rs
diff --git a/ibc-testkit/tests/applications/nft_transfer.rs b/tests-integration/tests/applications/nft_transfer.rs
similarity index 100%
rename from ibc-testkit/tests/applications/nft_transfer.rs
rename to tests-integration/tests/applications/nft_transfer.rs
diff --git a/ibc-testkit/tests/applications/transfer.rs b/tests-integration/tests/applications/transfer.rs
similarity index 100%
rename from ibc-testkit/tests/applications/transfer.rs
rename to tests-integration/tests/applications/transfer.rs
diff --git a/tests-integration/tests/clients/ics07_tendermint/client_state.rs b/tests-integration/tests/clients/ics07_tendermint/client_state.rs
new file mode 100644
index 000000000..9e2e3ece4
--- /dev/null
+++ b/tests-integration/tests/clients/ics07_tendermint/client_state.rs
@@ -0,0 +1,23 @@
+#[cfg(all(test, feature = "serde"))]
+mod tests {
+    use ibc_testkit::utils::test_serialization_roundtrip;
+    use tendermint_rpc::endpoint::abci_query::AbciQuery;
+
+    #[test]
+    fn serialization_roundtrip_no_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/data/json/client_state.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+
+    #[test]
+    fn serialization_roundtrip_with_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/data/json/client_state_proof.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+}
diff --git a/tests-integration/tests/clients/ics07_tendermint/consensus_state.rs b/tests-integration/tests/clients/ics07_tendermint/consensus_state.rs
new file mode 100644
index 000000000..564bb4715
--- /dev/null
+++ b/tests-integration/tests/clients/ics07_tendermint/consensus_state.rs
@@ -0,0 +1,23 @@
+#[cfg(feature = "serde")]
+mod tests {
+    use ibc_testkit::utils::test_serialization_roundtrip;
+    use tendermint_rpc::endpoint::abci_query::AbciQuery;
+
+    #[test]
+    fn serialization_roundtrip_no_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/data/json/consensus_state.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+
+    #[test]
+    fn serialization_roundtrip_with_proof() {
+        let json_data = include_str!(concat!(
+            env!("CARGO_MANIFEST_DIR"),
+            "/tests/data/json/consensus_state_proof.json"
+        ));
+        test_serialization_roundtrip::<AbciQuery>(json_data);
+    }
+}
diff --git a/tests-integration/tests/clients/ics07_tendermint/mod.rs b/tests-integration/tests/clients/ics07_tendermint/mod.rs
new file mode 100644
index 000000000..620c017de
--- /dev/null
+++ b/tests-integration/tests/clients/ics07_tendermint/mod.rs
@@ -0,0 +1,2 @@
+pub mod client_state;
+pub mod consensus_state;
diff --git a/tests-integration/tests/clients/mod.rs b/tests-integration/tests/clients/mod.rs
new file mode 100644
index 000000000..cc3da1b01
--- /dev/null
+++ b/tests-integration/tests/clients/mod.rs
@@ -0,0 +1 @@
+pub mod ics07_tendermint;
diff --git a/ibc-testkit/tests/core/ics02_client/create_client.rs b/tests-integration/tests/core/ics02_client/create_client.rs
similarity index 96%
rename from ibc-testkit/tests/core/ics02_client/create_client.rs
rename to tests-integration/tests/core/ics02_client/create_client.rs
index 3f8bd4bc8..4e5dd9e77 100644
--- a/ibc-testkit/tests/core/ics02_client/create_client.rs
+++ b/tests-integration/tests/core/ics02_client/create_client.rs
@@ -16,9 +16,9 @@ use ibc::core::host::types::path::{ClientConsensusStatePath, NextClientSequenceP
 use ibc::core::host::{ClientStateRef, ValidationContext};
 use ibc_query::core::context::ProvableContext;
 use ibc_testkit::context::{MockContext, TendermintContext};
-use ibc_testkit::fixtures::clients::tendermint::{
-    dummy_tendermint_header, dummy_tm_client_state_from_header,
-};
+#[cfg(feature = "serde")]
+use ibc_testkit::fixtures::clients::tendermint::dummy_tendermint_header;
+use ibc_testkit::fixtures::clients::tendermint::dummy_tm_client_state_from_header;
 use ibc_testkit::fixtures::core::context::TestContextConfig;
 use ibc_testkit::fixtures::core::signer::dummy_account_id;
 use ibc_testkit::testapp::ibc::clients::mock::client_state::{
@@ -63,6 +63,7 @@ fn test_create_client_ok() {
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
 
+#[cfg(feature = "serde")]
 #[test]
 fn test_tm_create_client_ok() {
     let signer = dummy_account_id();
@@ -100,6 +101,7 @@ fn test_tm_create_client_ok() {
     assert_eq!(ctx.client_state(&client_id).unwrap(), expected_client_state);
 }
 
+#[cfg(feature = "serde")]
 #[test]
 fn test_invalid_frozen_tm_client_creation() {
     let signer = dummy_account_id();
diff --git a/ibc-testkit/tests/core/ics02_client/mod.rs b/tests-integration/tests/core/ics02_client/mod.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics02_client/mod.rs
rename to tests-integration/tests/core/ics02_client/mod.rs
diff --git a/ibc-testkit/tests/core/ics02_client/recover_client.rs b/tests-integration/tests/core/ics02_client/recover_client.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics02_client/recover_client.rs
rename to tests-integration/tests/core/ics02_client/recover_client.rs
diff --git a/ibc-testkit/tests/core/ics02_client/update_client.rs b/tests-integration/tests/core/ics02_client/update_client.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics02_client/update_client.rs
rename to tests-integration/tests/core/ics02_client/update_client.rs
diff --git a/ibc-testkit/tests/core/ics02_client/upgrade_client.rs b/tests-integration/tests/core/ics02_client/upgrade_client.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics02_client/upgrade_client.rs
rename to tests-integration/tests/core/ics02_client/upgrade_client.rs
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs b/tests-integration/tests/core/ics03_connection/conn_open_ack.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics03_connection/conn_open_ack.rs
rename to tests-integration/tests/core/ics03_connection/conn_open_ack.rs
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs b/tests-integration/tests/core/ics03_connection/conn_open_confirm.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics03_connection/conn_open_confirm.rs
rename to tests-integration/tests/core/ics03_connection/conn_open_confirm.rs
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_init.rs b/tests-integration/tests/core/ics03_connection/conn_open_init.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics03_connection/conn_open_init.rs
rename to tests-integration/tests/core/ics03_connection/conn_open_init.rs
diff --git a/ibc-testkit/tests/core/ics03_connection/conn_open_try.rs b/tests-integration/tests/core/ics03_connection/conn_open_try.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics03_connection/conn_open_try.rs
rename to tests-integration/tests/core/ics03_connection/conn_open_try.rs
diff --git a/ibc-testkit/tests/core/ics03_connection/mod.rs b/tests-integration/tests/core/ics03_connection/mod.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics03_connection/mod.rs
rename to tests-integration/tests/core/ics03_connection/mod.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/acknowledgement.rs b/tests-integration/tests/core/ics04_channel/acknowledgement.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/acknowledgement.rs
rename to tests-integration/tests/core/ics04_channel/acknowledgement.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs b/tests-integration/tests/core/ics04_channel/chan_close_confirm.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_close_confirm.rs
rename to tests-integration/tests/core/ics04_channel/chan_close_confirm.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_close_init.rs b/tests-integration/tests/core/ics04_channel/chan_close_init.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_close_init.rs
rename to tests-integration/tests/core/ics04_channel/chan_close_init.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs b/tests-integration/tests/core/ics04_channel/chan_open_ack.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_open_ack.rs
rename to tests-integration/tests/core/ics04_channel/chan_open_ack.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs b/tests-integration/tests/core/ics04_channel/chan_open_confirm.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_open_confirm.rs
rename to tests-integration/tests/core/ics04_channel/chan_open_confirm.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_init.rs b/tests-integration/tests/core/ics04_channel/chan_open_init.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_open_init.rs
rename to tests-integration/tests/core/ics04_channel/chan_open_init.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/chan_open_try.rs b/tests-integration/tests/core/ics04_channel/chan_open_try.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/chan_open_try.rs
rename to tests-integration/tests/core/ics04_channel/chan_open_try.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/mod.rs b/tests-integration/tests/core/ics04_channel/mod.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/mod.rs
rename to tests-integration/tests/core/ics04_channel/mod.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/recv_packet.rs b/tests-integration/tests/core/ics04_channel/recv_packet.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/recv_packet.rs
rename to tests-integration/tests/core/ics04_channel/recv_packet.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/send_packet.rs b/tests-integration/tests/core/ics04_channel/send_packet.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/send_packet.rs
rename to tests-integration/tests/core/ics04_channel/send_packet.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout.rs b/tests-integration/tests/core/ics04_channel/timeout.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/timeout.rs
rename to tests-integration/tests/core/ics04_channel/timeout.rs
diff --git a/ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs b/tests-integration/tests/core/ics04_channel/timeout_on_close.rs
similarity index 100%
rename from ibc-testkit/tests/core/ics04_channel/timeout_on_close.rs
rename to tests-integration/tests/core/ics04_channel/timeout_on_close.rs
diff --git a/ibc-testkit/tests/core/mod.rs b/tests-integration/tests/core/mod.rs
similarity index 100%
rename from ibc-testkit/tests/core/mod.rs
rename to tests-integration/tests/core/mod.rs
diff --git a/ibc-testkit/tests/core/router.rs b/tests-integration/tests/core/router.rs
similarity index 100%
rename from ibc-testkit/tests/core/router.rs
rename to tests-integration/tests/core/router.rs
diff --git a/ibc-testkit/tests/cosmwasm/fixture.rs b/tests-integration/tests/cosmwasm/fixture.rs
similarity index 100%
rename from ibc-testkit/tests/cosmwasm/fixture.rs
rename to tests-integration/tests/cosmwasm/fixture.rs
diff --git a/ibc-testkit/tests/cosmwasm/helper.rs b/tests-integration/tests/cosmwasm/helper.rs
similarity index 100%
rename from ibc-testkit/tests/cosmwasm/helper.rs
rename to tests-integration/tests/cosmwasm/helper.rs
diff --git a/ibc-testkit/tests/cosmwasm/mod.rs b/tests-integration/tests/cosmwasm/mod.rs
similarity index 100%
rename from ibc-testkit/tests/cosmwasm/mod.rs
rename to tests-integration/tests/cosmwasm/mod.rs
diff --git a/ibc-testkit/tests/data/json/client_state.json b/tests-integration/tests/data/json/client_state.json
similarity index 100%
rename from ibc-testkit/tests/data/json/client_state.json
rename to tests-integration/tests/data/json/client_state.json
diff --git a/ibc-testkit/tests/data/json/client_state_proof.json b/tests-integration/tests/data/json/client_state_proof.json
similarity index 100%
rename from ibc-testkit/tests/data/json/client_state_proof.json
rename to tests-integration/tests/data/json/client_state_proof.json
diff --git a/ibc-testkit/tests/data/json/consensus_state.json b/tests-integration/tests/data/json/consensus_state.json
similarity index 100%
rename from ibc-testkit/tests/data/json/consensus_state.json
rename to tests-integration/tests/data/json/consensus_state.json
diff --git a/ibc-testkit/tests/data/json/consensus_state_proof.json b/tests-integration/tests/data/json/consensus_state_proof.json
similarity index 100%
rename from ibc-testkit/tests/data/json/consensus_state_proof.json
rename to tests-integration/tests/data/json/consensus_state_proof.json
diff --git a/ibc-testkit/tests/mod.rs b/tests-integration/tests/mod.rs
similarity index 92%
rename from ibc-testkit/tests/mod.rs
rename to tests-integration/tests/mod.rs
index 8b6f6bf3e..d9b64093d 100644
--- a/ibc-testkit/tests/mod.rs
+++ b/tests-integration/tests/mod.rs
@@ -7,5 +7,6 @@
     rust_2018_idioms
 )]
 pub mod applications;
+pub mod clients;
 pub mod core;
 pub mod cosmwasm;

From dcf8c36caeff886734505cedabd5e6e8171c2808 Mon Sep 17 00:00:00 2001
From: Sean Chen <seanchen11235@gmail.com>
Date: Fri, 24 May 2024 15:59:22 -0500
Subject: [PATCH 182/182] chore(deps): Enable `derive` feature of
 `parity-scale-codec` (#1238)

* Update parity-scale-codec depdendency in cargo.toml

* Run taplo format
---
 Cargo.toml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Cargo.toml b/Cargo.toml
index 9d7ab0302..b2555e275 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -126,5 +126,5 @@ cosmwasm-vm     = { version = "1.5.4" }
 cw-storage-plus = { version = "1.2.0" }
 
 # parity dependencies
-parity-scale-codec = { version = "3.6.5", default-features = false, features = [ "full" ] }
-scale-info         = { version = "2.10.0", default-features = false, features = [ "derive" ] }
+parity-scale-codec = { version = "3.6.5", default-features = false, features = [ "derive" ] }
+scale-info         = { version = "2.10.0", default-features = false }