#ibc #cosmos #blockchain #data-structures #wasm-client #wasm #ics08

no-std ibc-client-wasm-types

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.

4 releases (breaking)

0.53.0 May 14, 2024
0.52.0 Apr 26, 2024
0.51.0 Mar 26, 2024
0.50.0 Jan 24, 2024

#290 in Magic Beans

Download history 89/week @ 2024-02-04 56/week @ 2024-02-18 103/week @ 2024-02-25 56/week @ 2024-03-03 36/week @ 2024-03-10 127/week @ 2024-03-17 202/week @ 2024-03-24 251/week @ 2024-03-31 396/week @ 2024-04-07 450/week @ 2024-04-14 1485/week @ 2024-04-21 1165/week @ 2024-04-28 1037/week @ 2024-05-05 1338/week @ 2024-05-12 1176/week @ 2024-05-19

4,795 downloads per month
Used in 8 crates (3 directly)

Apache-2.0

170KB
3.5K SLoC

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

[!TIP] The pre-compiled CosmWasm contract for ibc-client-tendermint-cw is available as Github workflow artifacts at Actions tab. They can be downloaded during a Github workflow using actions/download-artifact@v4 action.

ICS-08: WASM Proxy Light Client

CosmWasm Integration

  • ibc-client-cw: 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 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!

Contributing

IBC is specified in English in the cosmos/ibc repo. Any protocol changes or clarifications should be contributed there.

If you're interested in contributing, please take a look at the CONTRIBUTING guidelines. We welcome and appreciate community contributions!

Dependencies

~15MB
~306K SLoC