Product Overview

Why are we building Hermes?

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 functionality is currently implemented in Hermes?

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 is Hermes implemented?

• 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.

Tech debt

• Architecture issues: label:relayer-next
• Implementation issues: label:bug,code-hygiene.

Planned work

• For internal use only: https://github.com/informalsystems/strategy/blob/main/2023/interchain-ibc.md.
• Project board.

Onboarding material

• If you are a Hermes user: Checkout the user guide
• If you are a external contributor seeking to develop Hermes feature or fork: See these excellent tutorials on IBC.
• If you are an Informal employee: See here.
• Contributor guideline: contributing.md

Contact information

• 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: Please get in touch with us at hello@informal.systems.