Skip to content

Product Overview

Jump to bottom
Adi Seredinschi edited this page Dec 6, 2022 · 20 revisions

Why

We build Hermes towards fulfilling Informal's Vision of creating a secure, sustainable and scalable Interchain serviced by the Cosmos Hub. Our contribution is towards solving the problem that existing infrastructure is fragile and cannot support 10x growth in networks or traffic.

What

Hermes is an IBC relayer. It is a central element of our mandate to build and operate robust node and relaying software to power the Interchain. The functionality consists of production-grade relaying software serving the full suite of IBC protocol standards, among them:

  • ICS07 (Tendermint light client)
  • ICS20 (Fungible Token Transfer)
  • ICS27 (Interchain Accounts)
  • ICS28 (Cross-Chain Validation)
  • ICS29 (Relayer Incentivisation Mechanism)

How

  • Architecture: For a high-level architectural description, see architecture.md.

    • We use Architecture Decision Records (ADRs) to track major decisions on how the Hermes software is evolving. See here all our ADRs.

  • QA: Our testing regimen comprises 2 levels:

    1. We have integration tests covering various network binaries and with numerous test cases: https://github.com/informalsystems/hermes/tree/master/tools/test-framework
    2. We provide support to networks who test with Hermes in their CI/CD, for example Gaia E2E tests or Osmosis E2E tests.

  • Security: There are no established security practices specifically for Hermes. Please direct your security reports to the IBC-go repository or see the "Who" section below.

    • Note: The disclosure log documents problems we have uncovered while specifying and implementing Hermes. Some of the cases recorded there might have been fixed.

Who

Product owner: Adi Seredinschi @adizere.

  • If you are a Hermes user:
    • Please find a community of Hermes users on the IBC Gang Discord server here.
  • For general inquiries with Informal

Tech debt

  • Architecture issues: label:relayer-next
  • Implementation issues: [label:bug,code-hygiene][https://github.com/informalsystems/hermes/issues?q=is%3Aopen+is%3Aissue+label%3Abug%2Ccode-hygiene]

Onboarding material

  • Contributor guideline: contributing.md
  • If you are a external contributor seeking to develop Hermes feature or fork:
    • For feature requests or submitting a bug, we actively maintain and triage the issues in this repository, so that would be the best place.
    • The present Wiki and the Discussions in this repository are a place to start if you're looking for development help.
    • See also these excellent tutorials on IBC
  • If you are an Informal employee, see here
Clone this wiki locally