/ibc-apps

IBC applications and middleware for Cosmos SDK chains.

Primary LanguageGoApache License 2.0Apache-2.0

ibc-apps

IBC-APPS Header

IBC applications and middleware for Cosmos SDK blockchains

🌌 Why have an ibc-apps repo?

Early IBC work started in the ibc-go repo. As the repo grew, the need arose to parallelize the work among many teams.

The ibc-apps repo is meant to be an easily discoverable, navigable, central place for modules and middleware.

🌌🌌 Who's it for?

IBC-Apps is for:

  • Core ibc-go contributors; it frees them from having to maintain IBC Apps,

  • Publishers of ibc apps, so their apps can be easily found, and

  • Everyone who uses IBC and wants to benefit from the full range of its capabilities.

🌌🌌🌌 What is it?

What is IBC?

The Inter-Blockchain Communication Protocol (IBC) is a protocol to handle the authentication and transport of data between two blockchains. IBC requires a minimal set of functions, specified in the Interchain Standards (ICS). These specifications do not limit the network topology or consensus algorithm, so IBC can be used with a wide range of blockchains or state machines. The IBC protocol provides a permissionless way for relaying data packets between blockchains, unlike most trusted bridging technologies. The security of IBC reduces to the security of the participating chains.

IBC solves a widespread problem: cross-chain communication. This problem exists on public blockchains when exchanges wish to perform swaps. The problem arises early in the case of application-specific blockchains, where every asset is likely to emerge from its own purpose-built chain. Cross-chain communication is also a challenge in the world of private blockchains, in cases where communication with a public chain or other private chains is desirable.

Cross-chain communication between application-specific blockchains in Cosmos creates the potential for high horizontal scalability with transaction finality. These design features provide convincing solutions to well-known problems that plague other platforms, such as transaction costs, network capacity, and transaction confirmation finality.

What is an IBC App?

IBC apps can be split into two categories - modules and middleware.

IBC Modules are self-contained applications that enable packets to be sent to and received from other IBC-enabled chains. IBC application developers do not need to concern themselves with the low-level details of clients, connections, and proof verification.

IBC Middleware are self-contained modules that sit between core IBC and an underlying IBC application. This allows developers to customize lower-level packet handling. Multiple middleware modules can be chained together.

🌌🌌🌌🌌 How to Use this repo

If you'd like to include software in this repo, please see contributing.

🌌🌌🌌🌌🌌 Bonus Content

Hello World

An example IBC app

Maintained Branches

Branch Name IBC-Go
main v7
release/v6 v6
release/v5 v5
release/v4 v4

List of Apps

Name Type Example Stakeholders Description
Async Interchain Query Module Link Strangelove Interchain Queries enable blockchains to query the state of an account on another chain without the need for ICA auth.
IBC Hooks Module Link Osmosis The IBC hooks module is an IBC middleware that enables ICS-20 token transfers to initiate contract calls.
Packet Forward Middleware Middleware Link Strangelove Middleware for forwarding IBC packets.

Ecosystem Apps

Modules and middleware developed by other awesome teams in the ecosystem:

Name Type Stakeholders Description
Interchain KV Queries Module Ingenuity An application that enables on chain querying of another IBC enabled chains state without the need for the chain being queried to implement the application.
query Module Defund Labs An application that enables on chain querying of another IBC enabled chains state without the need for the chain being queried to implement the application. Similar to the interchain-queries application in the row above but without callbacks.
NFT Transfer (ICS 721) Module Bianjieai An application that enables cross chain NFT transfer.
CosmWasm NFT Transfer (ICS 721) WASM Contract Public Awesome (Stargaze), Ark Protocol An application that enables cross chain NFT transfer. CosmWasm implementation of the above, written in Rust.
recovery Middleware Evmos Middleware enabling the recovery of tokens sent to unsupported addresses.
ibc-rate-limit Middleware Osmosis Labs Middleware that limits the in or out flow of an asset in a certain time period to minimise the risks of cross chain token transfers. This is implemented as a middleware wrapping ICS20 with the rate limiting logic implemented by cosmwasm contracts.
Interchain Atomic Swap WASM Contract Side Labs An application that facilitates inter-blockchain peer-to-peer asset swaps.
Interchain Liquidity WASM Contract Side Labs An application that splits the state of a weighted liquidity pool between two chains, enabling inter-blockchain automated asset swaps.