Incentivize an ICS 20 transfer packet
Register the counterparty payee
All incentivization fees are paid to accounts on the chain from where the IBC packets originate. To ensure that the relayer that delivers the MsgRecvPacket
on the destination chain is correctly compensated, the counterparty payee address (i.e. the account address of the relayer on the source chain) needs to be registered on the destination chain. Throughout this tutorial the source chain is chain1
and the destination chain is chain2
, therefore we need to register the account address of the relayer on chain chain1
(RLY_CHAIN1
) on chain chain2
(where the relayer has the account address RLY_CHAIN2
):
simd tx ibc-fee register-counterparty-payee transfer channel-0 $RLY_CHAIN2 $RLY_CHAIN1 \
--from $RLY_CHAIN2 \
--chain-id chain2 \
--keyring-backend test \
--home ../../gm/chain2 \
--node http://localhost:27010
Once the above command succeeds, then we can verify which counterparty payee is registered on chain chain2
for account RLY_CHAIN2
:
simd q ibc-fee counterparty-payee channel-0 $RLY_CHAIN2 --node http://localhost:27010
counterparty_payee: cosmos1vdy5fp0jy2l2ees870a7mls357v7uad6ufzcyz
We see that the counterparty payee address matches what we expected (i.e. the RLY_CHAIN1
address). In this tutorial we are going to send only one packet from chain chain1
to chain chain2
, so we only need to register the counterparty payee on chain chain2
. In real life circumstances relayers relay packets on both directions (i.e. from chain chain1
to chain2
and also viceversa), and thus relayers should register as well on chain chain1
the counterparty payee address to be compensated for delivering the MsgRecvPacket
on chain chain1
.
Multi-message transaction with single MsgPayPacketFee
message
We first generate (not execute) an IBC transfer transaction (again 1000samoleans
from VALIDATOR_CHAIN1
to VALIDATOR_CHAIN2
):
simd tx ibc-transfer transfer transfer channel-0 $VALIDATOR_CHAIN2 1000samoleans \
--from $VALIDATOR_CHAIN1 \
--chain-id chain1 \
--keyring-backend test \
--home ../../gm/chain1 \
--node tcp://localhost:27000 \
--generate-only > transfer.json
Then we prepend a MsgPayPacketFee
, sign the transaction and broadcast it. Please note that jq
is used to manipulate the transaction JSON file, making it a multi-message transaction. In practice, this multi-message transaction would be built using a gRPC or web client, for example, a web-based wallet application could fulfill this role. Note also that the signer
field uses the address of VALIDATOR_CHAIN1
.
jq '.body.messages |= [{"@type":"/ibc.applications.fee.v1.MsgPayPacketFee","fee": {"recv_fee": [{"denom": "samoleans", "amount": "50"}], "ack_fee": [{"denom": "samoleans", "amount": "25"}], "timeout_fee": [{"denom": "samoleans", "amount": "10"}]}, "source_port_id": "transfer", "source_channel_id": "channel-0", "signer": "cosmos18phmkrpnn6gmpzscf6hnf5zpv06sygxc6f2v92" }] + .' transfer.json > incentivized_transfer.json
simd tx sign incentivized_transfer.json \
--from $VALIDATOR_CHAIN1 \
--chain-id chain1 \
--keyring-backend test \
--home ../../gm/chain1 \
--node tcp://localhost:27000 > signed.json
simd tx broadcast signed.json \
--home ../../gm/chain1 \
--node tcp://localhost:27000
We wait for the relayer to relay the packet, and then we query the balance of account VALIDATOR_CHAIN2
on chain chain2
and see that it has indeed received an equivalent amount of vouchers for the 1000samoleans
sent by VALIDATOR_CHAIN1
:
simd q bank balances $VALIDATOR_CHAIN2 --node http://localhost:27010
balances:
- amount: "1000"
denom: ibc/27A6394C3F9FF9C9DCF5DFFADF9BB5FE9A37C7E92B006199894CF1824DF9AC7C
- amount: "100000000"
denom: samoleans
- amount: "99000000"
denom: stake
pagination:
total: "3"
We check as well the balance for account VALIDATOR_CHAIN1
on chain chain1
:
simd q bank balances $WALLET_1 --node http://localhost:16657
./simd q bank balances $VALIDATOR_CHAIN1 --node http://localhost:27000
balances:
- amount: "99998925"
denom: samoleans
- amount: "99000000"
denom: stake
pagination:
total: "2"
An amount of 1075samoleans
has been deducted, which is what we expected: 1000samoleans
have been transferred to VALIDATOR_CHAIN2
and 75stake
have been paid for the receive and acknowledgment fees. The timeout fee has been refunded to VALIDATOR_CHAIN1
and the relayer address RLY_CHAIN1
should have gained 75samoleans
for submitting the MsgRecvPacket
and the MsgAcknowledgement
messages.