Skip to main content

Chain Parameters

XYZ Chain modules are configured with specific parameters that govern the blockchain’s behavior. These parameters can be modified through governance proposals.

Staking Parameters

Controls validator operations and delegation.
ParameterValueDescription
unbonding_time14 days (1,209,600s)Time to unbond staked tokens
max_validators100Maximum active validators
max_entries7Max unbonding/redelegation entries
historical_entries10000Historical entries for IBC
bond_denomuxyzToken used for staking
min_commission_rate5% (0.05)Minimum validator commission

Query Staking Params

xyzd query staking params --node tcp://localhost:26657
unbonding_time: 1209600s
max_validators: 100
max_entries: 7
historical_entries: 10000
bond_denom: uxyz
min_commission_rate: "0.050000000000000000"

Slashing Parameters

Defines penalties for validator misbehavior.
ParameterValueDescription
signed_blocks_window10,000Blocks to track signing
min_signed_per_window5% (0.05)Minimum signing required
downtime_jail_duration10 minutes (600s)Jail time for downtime
slash_fraction_double_sign5% (0.05)Slash for double signing
slash_fraction_downtime1% (0.01)Slash for downtime

Slashing Scenarios

Double Signing

Signing two different blocks at the same height results in:
  • 5% slash of staked tokens
  • Permanent tombstone (can’t rejoin validator set)

Downtime

Missing more than 95% of blocks in a window results in:
  • 1% slash of staked tokens
  • 10 minute jail (can unjail after)

Query Slashing Params

xyzd query slashing params --node tcp://localhost:26657

Governance Parameters

Controls proposal and voting mechanics.
ParameterValueDescription
min_deposit10 XYZ (10,000,000 uxyz)Minimum deposit for proposal
max_deposit_period2 days (172,800s)Time to reach min deposit
voting_period2 days (172,800s)Duration of voting
quorum33.4% (0.334)Minimum participation
threshold50% (0.5)Yes votes needed to pass
veto_threshold33.4% (0.334)NoWithVeto to reject

Governance Process

Proposal Created


  ┌─────────────────┐
  │  Deposit Period │  ◀── 2 days to reach 10 XYZ
  │    (2 days)     │
  └────────┬────────┘
           │ (deposit reached)

  ┌─────────────────┐
  │  Voting Period  │  ◀── Validators & delegators vote
  │    (2 days)     │
  └────────┬────────┘


  ┌─────────────────┐
  │    Tallying     │
  └────────┬────────┘

     ┌─────┴─────┐
     ▼           ▼
  PASSED      REJECTED

Query Governance Params

xyzd query gov params --node tcp://localhost:26657

Distribution Parameters

Controls reward distribution.
ParameterValueDescription
community_tax2% (0.02)Tax sent to community pool
withdraw_addr_enabledtrueAllow custom withdraw address

Reward Flow

Transaction Fees


┌──────────────────┐
│   Distribution   │
│     Module       │
└────────┬─────────┘

    ┌────┴────┐
    ▼         ▼
Community   Validators
  Pool      & Delegators
  (2%)         (98%)

Mint Parameters (ZERO INFLATION)

Critical: XYZ Chain has zero inflation. The mint module is effectively disabled.
ParameterValueDescription
mint_denomuxyzDenomination to mint
inflation0Current inflation rate
inflation_min0Minimum inflation
inflation_max0Maximum inflation
inflation_rate_change0Inflation change rate
goal_bonded0Target bonded ratio
blocks_per_year6,311,520Expected blocks/year

Verify Zero Inflation

xyzd query mint inflation --node tcp://localhost:26657
Expected output:
0.000000000000000000
All mint parameters are set to zero, ensuring no new tokens are ever created. Validator rewards come entirely from transaction fees.

Crisis Parameters

Controls the invariant checking mechanism.
ParameterValueDescription
constant_fee1,000 XYZFee to trigger invariant check
The crisis module allows anyone to halt the chain if a critical invariant is violated (e.g., total supply mismatch). The high fee prevents abuse.

Wasm Parameters

Controls CosmWasm smart contract operations.
ParameterValueDescription
code_upload_accessEverybodyWho can upload contracts
instantiate_default_permissionEverybodyWho can instantiate
max_wasm_code_size800 KBMaximum contract size

Query Wasm Params

xyzd query wasm params --node tcp://localhost:26657
code_upload_access:
  permission: Everybody
  addresses: []
instantiate_default_permission: Everybody

IBC Parameters

Inter-Blockchain Communication configuration.
ParameterValueDescription
allowed_clientsAllSupported IBC clients
max_expected_time_per_block30sBlock time for timeouts

Active IBC Channels

# List all channels
xyzd query ibc channel channels --node tcp://localhost:26657

# List connections
xyzd query ibc connection connections --node tcp://localhost:26657

Modifying Parameters

Parameters can be modified through governance proposals:
# Create parameter change proposal
xyzd tx gov submit-proposal param-change proposal.json \
  --from my-key \
  --chain-id xyz-testnet-1

# Example proposal.json
{
  "title": "Update Min Commission Rate",
  "description": "Increase minimum validator commission to 10%",
  "changes": [
    {
      "subspace": "staking",
      "key": "MinCommissionRate",
      "value": "0.100000000000000000"
    }
  ],
  "deposit": "10000000uxyz"
}
Parameter changes require passing a governance vote. The voting period is 2 days and requires 33.4% quorum.