How cosmos/ibc-go works
Main Components
a) Core IBC Layer:
• Client Module (02-client)
• Connection Module (03-connection)
• Channel Module (04-channel)
• Port Module (05-port)
• Commitment Module (23-commitment)
• Host Module (24-host)
b) Applications Layer:
• Transfer Module (ICS-20)
• Interchain Accounts Module (ICS-27)
c) Middleware Layer:
• Fee Middleware (ICS-29)
• Callbacks Middleware
d) Light Clients:
• Tendermint Client (07-tendermint)
• Solo Machine Client (06-solomachine)
• Localhost Client (09-localhost)
• Wasm Client (08-wasm)
┌─────────────────────────── Applications Layer ───────────────────────────┐
• ┌─────────────┐ ┌────────────────────┐ ┌──────────────┐ │
• Transfer │ │ Interchain Accounts│ │ Custom Apps │ │
• ┘ └────────────────────┘ └──────────────┘ │
• Middleware Layer ───────────────────────────┤
• ┌─────────────┐ ┌────────────────────┐ │
• Fee │ │ Callbacks │ │
• ┘ └────────────────────┘ │
• Core Layer ──────────────────────────────┤
• ┌─────────────┐ ┌────────────────┐ ┌────────────┐ │
• Client │ │ Connection │ │ Channel │ │
• ┘ └────────────────┘ └────────────┘ │
• ┌─────────────┐ ┌────────────────┐ ┌────────────┐ │
• Port │ │ Commitment │ │ Host │ │
• ┘ └────────────────┘ └────────────┘ │
• Light Clients ─────────────────────────────┤
• ┌─────────────┐ ┌────────────────┐ ┌────────────┐ │
• Tendermint │ │ Solo Machine │ │ Localhost │ │
• ┘ └────────────────┘ └────────────┘ │
• ┘
Connection Flow Representation
• Packet flow between modules
• Authentication and verification paths
• State transitions
• Cross-chain communication patterns
Additional Elements
Include:
• Version information (current: v7, v8, v9 support)
• Key interfaces between components
• State storage indicators
• External integration points
Implementation Details
Show:
• Keeper interfaces
• Message handling flows
• Protocol handshake sequences
• Proof verification paths
• State management patterns