The Global Fee module manages network-wide minimum gas prices and fee bypass mechanisms for certain transaction types.

​
Parameters

ParameterTypeDescription
minimum_gas_pricesDecCoin[]Network-wide minimum gas prices
bypass_min_fee_msg_typesstring[]Message types that can bypass minimum fees
max_total_bypass_min_fee_msg_gas_usageuint64Maximum gas usage for bypass transactions

​
Key Parameter Details

​
minimum_gas_prices

  • Multiple denominations accepted alternatively
  • Must be sorted by denomination
  • No duplicate denominations or zero amounts

​
bypass_min_fee_msg_types

Default bypass message types (IBC protocol messages):
  • /ibc.core.channel.v1.MsgRecvPacket - IBC packet reception
  • /ibc.core.channel.v1.MsgAcknowledgement - IBC acknowledgement
  • /ibc.core.client.v1.MsgUpdateClient - IBC client updates
  • /ibc.core.channel.v1.MsgTimeout - IBC packet timeout
  • /ibc.core.channel.v1.MsgTimeoutOnClose - IBC timeout on close

​
max_total_bypass_min_fee_msg_gas_usage

  • Prevents abuse of bypass mechanism
  • Default value: 1,000,000 gas units

​
Queries

​
QueryParams

Retrieve the current module parameters. Response:
  • params: Current Global Fee parameters

​
Messages

​
MsgUpdateParams

Update module parameters through governance. Message Type: /gaia.globalfee.v1beta1.MsgUpdateParams Authority Required: Governance only Fields:
  • authority: Governance authority address
  • params: New module parameters

​
Key Concepts

  • Minimum Gas Prices: Network-wide minimum fees for all transactions
  • Fee Bypass: Certain message types can bypass minimum fees (defaults to IBC protocol messages)
  • Gas Limits: Bypass transactions have gas usage limits
  • Query-Only: Users can only query current parameters
  • Governance Updates: Parameters can only be updated through governance proposals