AnteHandler v3

The AnteHandler chains together several decorators to ensure the following criteria are met for app version 3:

  • The tx does not contain any messages that are unsupported by the current app version. See MsgVersioningGateKeeper.
  • The tx size is not larger than the application's configured versioned constant MaxTxBytes.
  • The tx does not contain any extension options.
  • The tx passes ValidateBasic().
  • The tx's timeout_height has not been reached if one is specified.
  • The tx's memo is <= the max memo characters where MaxMemoCharacters = 256.
  • The tx's gas_limit is > the gas consumed based on the tx's size where TxSizeCostPerByte = 10.
  • The tx's feepayer has enough funds to pay fees for the tx. The tx's feepayer is the feegranter (if specified) or the tx's first signer. Note the feegrant module is enabled.
  • The tx's gas price is >= the network minimum gas price where NetworkMinGasPrice = 0.000001 utia.
  • The tx's count of signatures <= the max number of signatures. The max number of signatures is TxSigLimit = 7.
  • The tx's gas_limit is > the gas consumed based on the tx's signatures.
  • The tx's signatures are valid. For each signature, ensure that the signature's sequence number (a.k.a nonce) matches the account sequence number of the signer.
  • The tx's gas_limit is > the gas consumed based on the blob size(s). Since blobs are charged based on the number of shares they occupy, the gas consumed is calculated as follows: gasToConsume = sharesNeeded(blob) * bytesPerShare * gasPerBlobByte. Where bytesPerShare is a global constant (an alias for ShareSize = 512) and gasPerBlobByte is a versioned constant that can be modified through hard forks (the DefaultGasPerBlobByte = 8).
  • The tx's total blob share count is <= the max blob share count. The max blob share count is derived from the maximum valid square size. The max valid square size is the minimum of: GovMaxSquareSize and SquareSizeUpperBound.
  • The tx does not contain a message of type MsgSubmitProposal with zero proposal messages.
  • The tx is not an IBC packet or update message that has already been processed.

In addition to the above criteria, the AnteHandler also has a number of side-effects:

  • Tx fees are deducted from the tx's feepayer and added to the fee collector module account.
  • Tx priority is calculated based on the smallest denomination of gas price in the tx and set in context.
  • The nonce of all tx signers is incremented by 1.