User-facing CLI to clear packets

[adizere]

Crate

ibc-relayer-cli

Problem Definition

Currently, Hermes operators need to specify two separate tx raw commands to achieve complete packet clearing of a given path, specifically:

• hermes tx raw packet-recv <OPTIONS>
• hermes tx raw packet-ack <OPTIONS>

This is clumsy for two reasons: (1) because tx raw is not meant to be user-facing, yet operators have no other way to achieve packet clearing, and (2) because operators need two separate commands both of which are notoriously complex due to the many positional arguments that these commands expect.

Proposal

This is a relayer operator suggestion.

We should provide a single CLI that unifies the two raw packet-recv + raw packet-ack commands.

Just like we have a "packet setup" user-facing commands, we should also have "packet clearing" commands.

Concretely: add a CLI

• hermes clear packets

with the following specification --

POSITIONAL ARGUMENTS:
    dst_chain_id              identifier of the destination chain
    src_chain_id              identifier of the source chain
    src_port_id               identifier of the source port
    src_channel_id            identifier of the source channel

The new CLI should act similarly to packet-recv and packet-ack commands, and should perform packet clearing in both directions of the given channel.

Acceptance Criteria

• one new user-facing CLI, hermes clear packets with the semantics described above

---

For Admin Use

• Not duplicate issue
• Appropriate labels applied
• Appropriate milestone (priority) applied
• Appropriate contributors tagged
• Contributor assigned/self-assigned