IBC-Solidity

IBC implementations in Solidity.

This is available not only for Ethereum and Hyperledger Besu, but also for Polygon PoS and other blockchains that supports EVM.

NOTE: This is yet pre-beta non-production-quality software.

Features

• Implementation of ICS
• Implementation of ICS-20
• ERC-20 Token Transfer

Documents

Please see here.

In addition, a tutorial is here.

Supported Light Client

You can deploy a Light Client that implements the IClient interface to integrate with IBC-Solidity.

Here are some such examples:

• IBFT 2.0 Light Client
• Tendermint Light Client
• Mock Client

Related projects

• A demo of trustless bridge between Harmony and Cosmos(Tendermint): https://github.com/datachainlab/harmony-cosmos-bridge-demo
• A demo of trustless bridge between Celo and Cosmos: https://github.com/ChorusOne/celo-cosmos-bridge

Development and Testing

Launch two Besu chains(ethereum-compatible) with the contracts deployed with the following command:

# If NO_GEN_CODE is empty, setup-script will generate a proto3 marshaler in solidity
$ NO_GEN_CODE=1 ./scripts/setup.sh testtwochainz

After launch the chains, execute the following command:

$ make e2e-test

E2E-test with IBC-Relayer

An example of E2E with IBC-Relayer(yui-relayer) can be found here:

• https://github.com/datachainlab/yui-relayer-build/tree/v0.2/tests/cases/tm2eth
• https://github.com/datachainlab/yui-relayer-build/blob/v0.2/.github/workflows/v0.2-tm2eth.yml

For Developers

To develop this project, you need the code generator solidity-protobuf to generate encoders and decoders in solidity from proto files.

Currently, you need to use this version.

Maintainers

• Jun Kimura