Migrating from v7.2 to v7.3

This guide provides instructions for migrating to version v7.3.0 of ibc-go.

There are four sections based on the four potential user groups of this document:

• Migrating from v7.2 to v7.3
  • Chains
  • IBC Apps
  • Relayers
  • IBC Light Clients

Note: ibc-go supports golang semantic versioning and therefore all imports must be updated on major version releases.

Chains

• No relevant changes were made in this release.

IBC Apps

A set of interfaces have been added that IBC applications may optionally implement. Developers interested in integrating their applications with the callbacks middleware should implement these interfaces so that the callbacks middleware can retrieve the desired callback addresses on the source and destination chains and execute actions on packet lifecycle events. The interfaces are PacketDataUnmarshaler, PacketDataProvider and PacketData.

Sample implementations are available for reference. For transfer:

• PacketDataUnmarshaler,
• PacketDataProvider
• and PacketData.

For 27-interchain-accounts:

• PacketDataUnmarshaler,
• PacketDataProvider
• and PacketData.

Relayers

• No relevant changes were made in this release.

IBC Light Clients

06-solomachine

Solo machines are now expected to sign data on a path that 1) does not include a connection prefix (e.g ibc) and 2) does not escape any characters. See PR #4429 for more details. We recommend NOT using the solo machine light client of versions lower than v7.3.0.