Practical overview
When it fits
Use it when developing Solidity applications that need IBC core or ICS-20 functionality and can integrate an appropriate light client and relaying components.
Who it is for
- Solidity developers adding IBC messaging to applications on EVM-compatible chains.
- Teams building IBC-style fungible-token transfers for ERC-20 assets.
- Integrators connecting Cosmos and EVM chains with a light client and relayer.
Documented uses
- Add IBC-compatible cross-chain messaging to Solidity contracts.
- Implement ICS-20 transfers using ERC-20 tokens.
- Connect a chain-specific light client through ILightClient.
- Develop a relayer-connected bridge between Cosmos and an EVM-compatible chain.
Requirements & limits
The repository is public and licensed under Apache-2.0.
- The repository states compatibility with IBC v8.
- Integration requires a light client implementing ILightClient; the repository lists several examples.
- Relayer support is provided through separately identified projects and modules.
- The README describes the project as under development and unaudited.
- Solidity protobuf code generation requires the separate solidity-protobuf tool, with version 0.1.0 specified.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Run the local QBFT end-to-end test
Launch two Hyperledger Besu chains with the contracts deployed, then run the project’s end-to-end test.
Before you start
- A checkout of the ibc-solidity repository.
- The repository’s documented Make targets.
Steps
From the repository, run the command below to launch two Hyperledger Besu chains with the contracts deployed.
make network-qbftAfter the chains launch, run the command below.
make e2e-test
Expected outcome
The documented QBFT end-to-end test is executed against the launched chains.
Guide limitations
- The project is under development and has not been audited.
- The instructions do not describe test coverage or guarantee a successful run.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 14 October 2026
- Original website title
- hyperledger-labs/yui-ibc-solidity · Official homepage title · retained in its source language

