ibc-integration

README

Language	Code Coverage
Java
Rust

IBC-Integration

The Inter-Blockchain Communication protocol (IBC) is an end-to-end, connection-oriented, stateful protocol for reliable, ordered, and authenticated communication between heterogeneous blockchains arranged in an unknown and dynamic topology. xCall, a standard for generic cross-chain messaging along with IBC provides dynamic and coherent solution for inter-connected dapps.

Additional information on how IBC works can be found here. and xCall spec is defined here

Table of Content

• IBC INTEGRATION
• Table of Content
  • About
  • Installation
  • Getting Started
    • Prerequiste
    • Running the tests

About

Installation

This project uses git submodules. Use the following command to clone the repository.

git clone --recurse-submodules https://github.com/icon-project/IBC-Integration

To update submodules, run the following command,

git submodule init
git submodule update --remote

Getting Started

Terminologies used in this project.

• ibc packet
• ibc message
• openInit
• openTry
• openAck
• openConfirm

Available Integrations

• ICON
• Archway

Project Structure

Directory	Description
/contracts/cosmwasm-vm	Includes contracts for cosmwasm based chains
/contracts/evm	Includes contracts for evm based chains
/contracts/javascore	Includes contracts for ICON chain
/docs	Documentation
/libraries/rust	Common rust libraries used across multiple integrations
/proto	Proto files used for IBC
/resources	Static resources in project. For example images, bin files, etc
/scripts	Scripts to automate task in project, for example build scripts, deploy scripts.
/test	Test Framework and Test Suite including e2e test and functional test
/utils	Utilities used for build, setup, CI/CD

Testing

Integration Testing

go test -v ./test/integration --args -config=<path to config.json>

E2E Testing

go test -v ./test/e2e --args -config=<path to config.json>