Params
This document is relevant only for fungible token transfers over channels on v1 of the ICS-20 protocol.
Parameters
The IBC transfer application module contains the following parameters:
Name | Type | Default Value |
---|---|---|
SendEnabled | bool | true |
ReceiveEnabled | bool | true |
The IBC transfer module stores its parameters in its keeper with the prefix of 0x03
.
SendEnabled
The SendEnabled
parameter controls send cross-chain transfer capabilities for all fungible tokens.
To prevent a single token from being transferred from the chain, set the SendEnabled
parameter to true
and then, depending on the Cosmos SDK version, do one of the following:
- For Cosmos SDK v0.46.x or earlier, set the bank module's
SendEnabled
parameter for the denomination tofalse
. - For Cosmos SDK versions above v0.46.x, set the bank module's
SendEnabled
entry for the denomination tofalse
usingMsgSetSendEnabled
as a governance proposal.
Doing so will prevent the token from being transferred between any accounts in the blockchain.
ReceiveEnabled
The transfers enabled parameter controls receive cross-chain transfer capabilities for all fungible tokens.
To prevent a single token from being transferred to the chain, set the ReceiveEnabled
parameter to true
and then, depending on the Cosmos SDK version, do one of the following:
- For Cosmos SDK v0.46.x or earlier, set the bank module's
SendEnabled
parameter for the denomination tofalse
. - For Cosmos SDK versions above v0.46.x, set the bank module's
SendEnabled
entry for the denomination tofalse
usingMsgSetSendEnabled
as a governance proposal.
Doing so will prevent the token from being transferred between any accounts in the blockchain.
Queries
Current parameter values can be queried via a query message.
// proto/ibc/applications/transfer/v1/query.proto
// QueryParamsRequest is the request type for the Query/Params RPC method.
message QueryParamsRequest {}
// QueryParamsResponse is the response type for the Query/Params RPC method.
message QueryParamsResponse {
// params defines the parameters of the module.
Params params = 1;
}
To execute the query in simd
, you use the following command:
simd query ibc-transfer params
Changing Parameters
To change the parameter values, you must make a governance proposal that executes the MsgUpdateParams
message.
// proto/ibc/applications/transfer/v1/tx.proto
// MsgUpdateParams is the Msg/UpdateParams request type.
message MsgUpdateParams {
// signer address (it may be the address that controls the module, which defaults to x/gov unless overwritten).
string signer = 1;
// params defines the transfer parameters to update.
//
// NOTE: All parameters must be supplied.
Params params = 2 [(gogoproto.nullable) = false];
}
// MsgUpdateParamsResponse defines the response structure for executing a
// MsgUpdateParams message.
message MsgUpdateParamsResponse {}