{"id":19270115,"url":"https://github.com/hyperledger-labs/yui-ibc-solidity","last_synced_at":"2025-09-12T10:42:50.395Z","repository":{"id":37662173,"uuid":"338277568","full_name":"hyperledger-labs/yui-ibc-solidity","owner":"hyperledger-labs","description":"IBC in Solidity","archived":false,"fork":false,"pushed_at":"2025-02-28T17:47:34.000Z","size":3277,"stargazers_count":143,"open_issues_count":15,"forks_count":63,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-12T16:58:52.211Z","etag":null,"topics":["cosmos","ethereum","hyperledger-besu","ibc","solidity"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hyperledger-labs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-12T09:46:36.000Z","updated_at":"2025-03-17T16:26:09.000Z","dependencies_parsed_at":"2023-09-24T17:55:30.490Z","dependency_job_id":"68736b32-8db5-4e38-b3e6-19fbc101efd6","html_url":"https://github.com/hyperledger-labs/yui-ibc-solidity","commit_stats":null,"previous_names":["datachainlab/ibc-solidity"],"tags_count":52,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperledger-labs%2Fyui-ibc-solidity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperledger-labs%2Fyui-ibc-solidity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperledger-labs%2Fyui-ibc-solidity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hyperledger-labs%2Fyui-ibc-solidity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hyperledger-labs","download_url":"https://codeload.github.com/hyperledger-labs/yui-ibc-solidity/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582905,"owners_count":22095518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cosmos","ethereum","hyperledger-besu","ibc","solidity"],"created_at":"2024-11-09T20:23:26.222Z","updated_at":"2025-05-16T18:07:06.671Z","avatar_url":"https://github.com/hyperledger-labs.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003ch1\u003eibc-solidity\u003c/h1\u003e\n\u003c/div\u003e\n\n![banner](docs/img/IBC-solidity-cover.svg)\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Version\" src=\"https://img.shields.io/github/tag/hyperledger-labs/yui-ibc-solidity.svg\"\u003e\n  \u003ca href=\"https://github.com/hyperledger-labs/yui-ibc-solidity/blob/main/LICENSE\"\u003e\n    \u003cimg alt=\"License: Apache-2.0\" src=\"https://img.shields.io/github/license/hyperledger-labs/yui-ibc-solidity.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/hyperledger-labs/yui-ibc-solidity/actions/workflows/test.yml\"\u003e\n    \u003cimg alt=\"Test\" src=\"https://github.com/hyperledger-labs/yui-ibc-solidity/actions/workflows/test.yml/badge.svg\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://pkg.go.dev/github.com/hyperledger-labs/yui-ibc-solidity?tab=doc\"\u003e\n    \u003cimg alt=\"GoDoc\" src=\"https://godoc.org/github.com/hyperledger-labs/yui-ibc-solidity?status.svg\" /\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n[IBC](https://github.com/cosmos/ibc) implementations in Solidity.\n\n**IBC compatibility:** [v8](https://github.com/cosmos/ibc-go/releases/tag/v8.2.0)\n\nThis is available not only for Ethereum and Hyperledger Besu, but also for Polygon PoS and other EVM-compatible chains.\n\nDISCLAIMER: This project is still under development and has not been audited.\n\n## Features\n\n- Implementation of [ICS](https://github.com/cosmos/ibc/tree/master/spec/core)\n- Implementation of [ICS-20](https://github.com/cosmos/ibc/tree/master/spec/app/ics-020-fungible-token-transfer)\n- [ERC-20 Token Transfer](./contracts/apps/20-transfer/ICS20TransferBank.sol)\n\n## Documents\n\n- [Architecture Overview](./docs/architecture.md)\n- [Learn how to develop an IBC Module](https://labs.hyperledger.org/yui-docs/yui-ibc-solidity/)\n- [IBFT 2.0 Light Client spec](./docs/ibft2-light-client.md)\n\n## Supported Light Client\n\nYou can deploy a Light Client that implements [the ILightClient interface](./contracts/core/02-client/ILightClient.sol) to [integrate with ibc-solidity](./docs/architecture.md#light-client).\n\nHere are some such examples:\n- [Tendermint ZK Light Client](https://github.com/datachainlab/tendermint-zk-ibc)\n- [QBFT/IBFT2.0 Light Client](./contracts/clients/qbft/QBFTClient.sol)\n- [LCP(TEE) Client](https://github.com/datachainlab/lcp-solidity)\n- [Localhost Client](./contracts/clients/LocalhostClient.sol)\n\n## IBC relayer support\n\n- [yui-relayer](https://github.com/datachainlab/yui-relayer): An IBC relayer for heterogeneous chains\n- [ethereum-ibc-relay-chain](https://github.com/datachainlab/ethereum-ibc-relay-chain): A relay-chain module for EVM-compatible chains\n- [ethereum-ibc-relay-prover](https://github.com/datachainlab/ethereum-ibc-relay-prover): A relay-prover module for Ethereum sync committee\n- [besu-ibc-relay-prover](https://github.com/datachainlab/besu-ibc-relay-prover): A relay-prover module for Hyperledger Besu's QBFT and IBFT 2.0 consensus\n\n## Related projects\n\n- A demo of trustless bridge\n    - between Harmony and Cosmos(Tendermint): https://github.com/datachainlab/harmony-cosmos-bridge-demo\n    - between Celo and Cosmos: https://github.com/ChorusOne/celo-cosmos-bridge\n- A demo of bridge between Cosmos(ibc-go) and Ethereum using IBC and LCP: https://github.com/datachainlab/cosmos-ethereum-ibc-lcp\n\n## For Developers\n\n### Unit test\n\n```sh\n$ make test\n```\n\n### E2E test\n\nLaunch two Hyperledger Besu chains(ethereum-compatible) with the contracts deployed with the following command:\n\n```sh\n$ make network-qbft\n```\n\nAfter launch the chains, execute the following command:\n\n```\n$ make e2e-test\n```\n\n### E2E-test with IBC-Relayer\n\nAn example of E2E with IBC-Relayer([yui-relayer](https://github.com/hyperledger-labs/yui-relayer)) can be found here:\n- https://github.com/datachainlab/ibft2-relay-prover/tree/main/e2e\n- https://github.com/datachainlab/yui-relayer-build/tree/v0.4/tests/cases/eth2eth\n- https://github.com/datachainlab/yui-relayer-build/blob/v0.4/.github/workflows/v0.4-eth2eth.yml\n\n### solidity-protobuf\n\nTo generate the proto encoders and decoders in solidity from proto files, you need to use the code generator [solidity-protobuf](https://github.com/datachainlab/solidity-protobuf)\n\nCurrently, [v0.1.0](https://github.com/datachainlab/solidity-protobuf/tree/v0.1.0) is required.\n\nIf you edit the proto definitions, you should execute the following command:\n```\n$ make SOLPB_DIR=/path/to/solidity-protobuf proto-sol\n```\n\n## Maintainers\n\n- [Jun Kimura](https://github.com/bluele)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperledger-labs%2Fyui-ibc-solidity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhyperledger-labs%2Fyui-ibc-solidity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhyperledger-labs%2Fyui-ibc-solidity/lists"}