Auth

Important

Terra’s auth module inherits from Cosmos SDK’s auth module. This document is a stub and covers mainly important Terra-specific notes about how it is used.

Terra’s Auth module extends the functionality from Cosmos SDK’s auth module with a modified ante handler, which applies basic transaction validity checks, such as signatures, nonces, and auxiliary fields. This module also defines a special vesting account type that handles the logic for token vesting from the Luna presale.

Gas Fee

Like all transactions on the Terra blockchain, MsgSend and MsgMultiSend incur gas fees. These fees are determined by a validator’s minimum gas price and the complexity of the transaction. More complex transactions incur higher fees. Gas fees are specified by the sender when a transaction is outbound. For more information on how gas is calculated, see fees.

Parameters

The subspace for the Auth module is auth.

type Params struct {
	MaxMemoCharacters      uint64 `json:"max_memo_characters" yaml:"max_memo_characters"`
	TxSigLimit             uint64 `json:"tx_sig_limit" yaml:"tx_sig_limit"`
	TxSizeCostPerByte      uint64 `json:"tx_size_cost_per_byte" yaml:"tx_size_cost_per_byte"`
	SigVerifyCostED25519   uint64 `json:"sig_verify_cost_ed25519" yaml:"sig_verify_cost_ed25519"`
	SigVerifyCostSecp256k1 uint64 `json:"sig_verify_cost_secp256k1" yaml:"sig_verify_cost_secp256k1"`
}

MaxMemoCharacters

The maximum permitted number of characters in the memo of a transaction.

  • type: uint64

  • default: 256

TxSigLimit

The maximum number of signers in a transaction. A single transaction can have multiple messages and multiple signers. Because the sig verification cost is generally higher than other operations, the number of signers is limited to 100.

  • type: uint64

  • default: 100

TxSizeCostPerByte

The cost per byte used to compute the gas consumption of a transaction. TxSizeCostPerByte * txsize.

  • type: uint64

  • default: 10

SigVerifyCostED25519

The gas cost for verifying ED25519 signatures.

  • type: uint64

  • default: 590

SigVerifyCostSecp256k1

The gas cost for verifying Secp256k1 signatures.

  • type: uint64

  • default: 1000