README
¶
IBC-Solidity
IBC implementations in Solidity.
IBC compatibility: v4.0.0
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
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:
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
Development and Testing
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
For Developers
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
Directories