Client
The tx raw
commands can be used to create and update the on-chain IBC clients.
Table of Contents
Create Client
Use the create-client
command to create a new client.
USAGE:
hermes tx raw create-client <OPTIONS>
DESCRIPTION:
Create a client for source chain on destination chain
POSITIONAL ARGUMENTS:
dst_chain_id identifier of the destination chain
src_chain_id identifier of the source chain
Example
Create a new client of ibc-1
on ibc-0
:
hermes tx raw create-client ibc-0 ibc-1
{
Success: CreateClient(
CreateClient(
Attributes {
height: Height { revision: 0, height: 43 },
client_id: ClientId(
"07-tendermint-0",
),
client_type: Tendermint,
consensus_height: Height { revision: 1, height: 32 },
},
),
)
}
A new client is created with identifier 07-tendermint-0
Update Client
Use the update-client
command to update an existing client with a new consensus state.
Specific update and trusted heights can be specified.
USAGE:
hermes tx raw update-client <OPTIONS>
DESCRIPTION:
Update the specified client on destination chain
POSITIONAL ARGUMENTS:
dst_chain_id identifier of the destination chain
dst_client_id identifier of the client to be updated on destination chain
FLAGS:
-H, --target-height TARGET-HEIGHT
-t, --trusted-height TRUSTED-HEIGHT
Example
Update the client on ibc-0
with latest header of ibc-1
hermes tx raw update-client ibc-0 07-tendermint-0
Success: UpdateClient(
UpdateClient {
common: Attributes {
height: Height { revision: 0, height: 110 },
client_id: ClientId(
"07-tendermint-0",
),
client_type: Tendermint,
consensus_height: Height { revision: 1, height: 109 },
},
header: Some(
Tendermint(
Header {...},
),
),
},
)
The client with identifier 07-tendermint-0
has been updated with the consensus state at height 1-273
.