README.md

ibc-solidity

IBC implementations in Solidity.

IBC compatibility: v4

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

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

Features

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

Documents

• Architecture Overview
• Learn how to develop an IBC Module
• IBFT 2.0 Light Client spec

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

IBC relayer support

• yui-relayer: An IBC relayer for heterogeneous chains
• ethereum-ibc-relay-chain: A relay-chain module for EVM-compatible chains
• ethereum-ibc-relay-prover: A relay-prover module for Ethereum sync committee

Related projects

• A demo of trustless bridge
  • between Harmony and Cosmos(Tendermint): https://github.com/datachainlab/harmony-cosmos-bridge-demo
  • between Celo and Cosmos: https://github.com/ChorusOne/celo-cosmos-bridge
• A demo of bridge between Cosmos(ibc-go) and Ethereum using IBC and LCP: https://github.com/datachainlab/cosmos-ethereum-ibc-lcp

For Developers

Unit test

$ make test

E2E test

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

$ make network-e2e

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.3/tests/cases/eth2eth
• https://github.com/datachainlab/yui-relayer-build/blob/v0.3/.github/workflows/v0.3-eth2eth.yml

solidity-protobuf

To generate the proto encoders and decoders in solidity from proto files, you need to use the code generator solidity-protobuf

Currently, v0.1.0 is required.

If you edit the proto definitions, you should execute the following command:

$ make SOLPB_DIR=/path/to/solidity-protobuf proto-sol

Maintainers

• Jun Kimura