Skip to main content
Version: v1

Consensus Module

The ZIGChain Consensus Module is based on the Cosmos SDK - Consensus Module but with the specific parameters that you can find in the Consensus Parameters section.

Consensus Parameters

The Consensus module in ZIGChain is configured with the following parameters:

⚠️ These values may change via governance proposals. Always confirm using the CLI or API.

ParametersTestnet ValueMainnet Value
abci
block.max_bytes5,000,0005,000,000
block.max_gas100,000,000100,000,000
evidence.max_age_duration48h0m0s (2 days)504h0m0s (21 days)
evidence.max_age_num_blocks100,000604,800
evidence.max_bytes1,048,5761,048,576
validator.pub_key_typesed25519ed25519
version

Parameters Overview

abci

Description: Specifies the Application Blockchain Interface (ABCI) configuration, which handles communication between the blockchain's application and consensus layers.

Default: {}


block.max_bytes

Description: Maximum block size in bytes. This defines how much data (transactions, evidence, etc.) can be included in a single block.

Default: 5,000,000

Note: Increasing this value allows more transactions per block but can slow down block propagation and potentially impact consensus efficiency.


block.max_gas

Description: Maximum gas allowed per block.

Example: If the max_gas is 200,000 and the average transaction consumes 1,000 gas, a block can include up to 200 transactions.

Default: 100,000,000

Note: Setting a lower gas limit can prevent resource overload but might reduce throughput during high activity.


evidence.max_age_duration

Description: Maximum age of evidence duration in time. Should correspond with the unbonding period or similar to avoid Nothing-At-Stake attacks.

Default: 504h


evidence.max_age_num_blocks

Description: Maximum age of evidence in blocks. Calculated as MaxAgeDuration / {average block time}.

Default: 604,800


evidence.max_bytes

Description: Maximum number of evidence committed in a single block.

Default: 1,048,576


validator.pub_key_types

Description: Defines the cryptographic key types allowed for validators' public keys.

Default: ed25519


version

Description: Indicates the version of the consensus module or protocol in use.

Default: {}


Consensus CLI Quick Sheet

Get the consensus parameters:

zigchaind query consensus params \
--chain-id zigchain-1 --node https://public-zigchain-rpc.numia.xyz

References