Skip to content

IBC modules and relayer - Formal specifications and Rust implementation

License

Notifications You must be signed in to change notification settings

octopus-network/hermes

This branch is 28 commits ahead of, 313 commits behind informalsystems/hermes:master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

3d6aa59 · Jan 30, 2024
Nov 29, 2023
Nov 9, 2023
Nov 9, 2023
Jan 30, 2024
Nov 9, 2023
Nov 14, 2022
Nov 29, 2023
Oct 19, 2023
Jan 3, 2024
Sep 12, 2023
Oct 20, 2023
Mar 3, 2020
Nov 29, 2023
Apr 26, 2023
Dec 27, 2023
Dec 13, 2023
Mar 20, 2020
Nov 8, 2023
Jul 19, 2023
Jul 17, 2023
May 25, 2020
Nov 9, 2023
Nov 8, 2023
Nov 9, 2023

Repository files navigation

Hermes IBC relayer

Cosmos ecosystem

Build Status Integration tests Apache 2.0 Licensed Rust Stable Rust 1.70+

Rust implementation of an Inter-Blockchain Communication (IBC) relayer.

This project comprises primarily of 6 crates:

  • ibc-relayer provides an implementation of an IBC relayer, as a library.
  • ibc-relayer-cli is a CLI (a wrapper over the ibc-relayer library), comprising the hermes binary.
  • ibc-chain-registry provides functions to fetch data from the chain registry and automatically generate chain configuration for Hermes.
  • ibc-telemetry is a library for use in the Hermes CLI, for gathering telemetry data and exposing that in a Prometheus endpoint.
  • ibc-relayer-rest is a library for use in the Hermes CLI, for exposing a REST API to inspect the state of the relayer.
  • ibc-test-framework provides the infrastructure and framework for writing end-to-end (E2E) tests that include the spawning of the relayer together with Cosmos full nodes.

See the table below for more details.

⚠️ The ibc and ibc-proto crates have been moved to their own repositories.

The repository also includes TLA+ specifications.

Status

Crate name Type Version Docs
ibc-relayer-cli bin: hermes IBC Relayer CLI Crate IBC Relayer CLI Docs
ibc-relayer lib IBC Relayer Crate IBC Relayer Docs
ibc-chain-registry lib Chain Registry Crate Chain Registry Docs
ibc-relayer-rest lib IBC Relayer REST Crate IBC Relayer REST Docs
ibc-telemetry lib IBC Telemetry Crate IBC Telemetry Docs
ibc-test-framework lib IBC Test Framework Crate IBC Test Framework Docs

Requirements

The crates in this project require Rust 1.70.0.

Hermes Guide

We have a comprehensive guide at hermes.informal.systems.

Contributing

IBC is specified in English in the cosmos/ibc repo. Any protocol changes or clarifications should be contributed there.

This repo contains the TLA+ specification and Rust implementation for the IBC modules and relayer. If you're interested in contributing, please comment on an issue or open a new one!

See also CONTRIBUTING.md.

Versioning

We follow Semantic Versioning, though APIs are still under active development.

Resources

License

Copyright © 2023 Informal Systems Inc. and Hermes authors.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use the files in this repository except in compliance with the License. You may obtain a copy of the License at

https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

IBC modules and relayer - Formal specifications and Rust implementation

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Rust 95.1%
  • Shell 2.3%
  • Python 1.7%
  • TLA 0.5%
  • CSS 0.4%
  • Nix 0.0%