Cardano · Schema

Proposal Parameters

BlockchainCryptocurrencyProof-of-StakeSmart ContractsWeb3

Properties

Name Type Description
id string Governance Action Identifier (CIP-0129)
tx_hash string Off-chain metadata of a proposal with a specific transaction hash
cert_index integer Off-chain metadata of a proposal with a specific transaction cert_index
parameters object
View JSON Schema on GitHub

JSON Schema

proposal-parameters.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://cardano.blockfrost.io/schema/proposal_parameters",
  "title": "Proposal Parameters",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Governance Action Identifier (CIP-0129)"
    },
    "tx_hash": {
      "type": "string",
      "description": "Off-chain metadata of a proposal with a specific transaction hash"
    },
    "cert_index": {
      "type": "integer",
      "description": "Off-chain metadata of a proposal with a specific transaction cert_index"
    },
    "parameters": {
      "type": "object",
      "properties": {
        "epoch": {
          "type": "integer",
          "example": 225,
          "description": "Epoch number",
          "nullable": true
        },
        "min_fee_a": {
          "type": "integer",
          "example": 44,
          "description": "The linear factor for the minimum fee calculation for given epoch",
          "nullable": true
        },
        "min_fee_b": {
          "type": "integer",
          "example": 155381,
          "description": "The constant factor for the minimum fee calculation",
          "nullable": true
        },
        "max_block_size": {
          "type": "integer",
          "example": 65536,
          "description": "Maximum block body size in Bytes",
          "nullable": true
        },
        "max_tx_size": {
          "type": "integer",
          "example": 16384,
          "description": "Maximum transaction size",
          "nullable": true
        },
        "max_block_header_size": {
          "type": "integer",
          "example": 1100,
          "description": "Maximum block header size",
          "nullable": true
        },
        "key_deposit": {
          "type": "string",
          "example": "2000000",
          "description": "The amount of a key registration deposit in Lovelaces",
          "nullable": true
        },
        "pool_deposit": {
          "type": "string",
          "example": "500000000",
          "description": "The amount of a pool registration deposit in Lovelaces",
          "nullable": true
        },
        "e_max": {
          "type": "integer",
          "example": 18,
          "description": "Epoch bound on pool retirement",
          "nullable": true
        },
        "n_opt": {
          "type": "integer",
          "example": 150,
          "description": "Desired number of pools",
          "nullable": true
        },
        "a0": {
          "type": "number",
          "example": 0.3,
          "description": "Pool pledge influence",
          "nullable": true
        },
        "rho": {
          "type": "number",
          "example": 0.003,
          "description": "Monetary expansion",
          "nullable": true
        },
        "tau": {
          "type": "number",
          "example": 0.2,
          "description": "Treasury expansion",
          "nullable": true
        },
        "decentralisation_param": {
          "type": "number",
          "example": 0.5,
          "description": "Percentage of blocks produced by federated nodes",
          "nullable": true
        },
        "extra_entropy": {
          "type": "string",
          "nullable": true,
          "example": null,
          "description": "Seed for extra entropy"
        },
        "protocol_major_ver": {
          "type": "integer",
          "example": 2,
          "description": "Accepted protocol major version",
          "nullable": true
        },
        "protocol_minor_ver": {
          "type": "integer",
          "example": 0,
          "description": "Accepted protocol minor version",
          "nullable": true
        },
        "min_utxo": {
          "type": "string",
          "example": "1000000",
          "description": "Minimum UTXO value",
          "nullable": true
        },
        "min_pool_cost": {
          "type": "string",
          "example": "340000000",
          "description": "Minimum stake cost forced on the pool",
          "nullable": true
        },
        "cost_models": {
          "additionalProperties": true,
          "type": "object",
          "nullable": true,
          "example": {
            "PlutusV1": [
              197209,
              0
            ],
            "PlutusV2": [
              197209,
              0
            ]
          },
          "description": "Cost models parameters for Plutus Core scripts in raw list form"
        },
        "price_mem": {
          "type": "number",
          "nullable": true,
          "example": 0.0577,
          "description": "The per word cost of script memory usage"
        },
        "price_step": {
          "type": "number",
          "nullable": true,
          "example": 7.21e-05,
          "description": "The cost of script execution step usage"
        },
        "max_tx_ex_mem": {
          "type": "string",
          "nullable": true,
          "example": "10000000",
          "description": "The maximum number of execution memory allowed to be used in a single transaction"
        },
        "max_tx_ex_steps": {
          "type": "string",
          "nullable": true,
          "example": "10000000000",
          "description": "The maximum number of execution steps allowed to be used in a single transaction"
        },
        "max_block_ex_mem": {
          "type": "string",
          "nullable": true,
          "example": "50000000",
          "description": "The maximum number of execution memory allowed to be used in a single block"
        },
        "max_block_ex_steps": {
          "type": "string",
          "nullable": true,
          "example": "40000000000",
          "description": "The maximum number of execution steps allowed to be used in a single block"
        },
        "max_val_size": {
          "type": "string",
          "nullable": true,
          "example": "5000",
          "description": "The maximum Val size"
        },
        "collateral_percent": {
          "type": "integer",
          "nullable": true,
          "example": 150,
          "description": "The percentage of the transactions fee which must be provided as collateral when including non-native scripts"
        },
        "max_collateral_inputs": {
          "type": "integer",
          "nullable": true,
          "example": 3,
          "description": "The maximum number of collateral inputs allowed in a transaction"
        },
        "coins_per_utxo_size": {
          "type": "string",
          "nullable": true,
          "example": "34482",
          "description": "Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."
        },
        "coins_per_utxo_word": {
          "type": "string",
          "nullable": true,
          "example": "34482",
          "deprecated": true,
          "description": "Cost per UTxO word for Alonzo. Cost per UTxO byte for Babbage and later."
        },
        "pvt_motion_no_confidence": {
          "type": "number",
          "nullable": true,
          "description": "Pool Voting threshold for motion of no-confidence. New in 13.2-Conway."
        },
        "pvt_committee_normal": {
          "type": "number",
          "nullable": true,
          "description": "Pool Voting threshold for new committee/threshold (normal state). New in 13.2-Conway."
        },
        "pvt_committee_no_confidence": {
          "type": "number",
          "nullable": true,
          "description": "Pool Voting threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."
        },
        "pvt_hard_fork_initiation": {
          "type": "number",
          "nullable": true,
          "description": "Pool Voting threshold for hard-fork initiation. New in 13.2-Conway."
        },
        "dvt_motion_no_confidence": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for motion of no-confidence. New in 13.2-Conway."
        },
        "dvt_committee_normal": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for new committee/threshold (normal state). New in 13.2-Conway."
        },
        "dvt_committee_no_confidence": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for new committee/threshold (state of no-confidence). New in 13.2-Conway."
        },
        "dvt_update_to_constitution": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for update to the Constitution. New in 13.2-Conway."
        },
        "dvt_hard_fork_initiation": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for hard-fork initiation. New in 13.2-Conway."
        },
        "dvt_p_p_network_group": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for protocol parameter changes, network group. New in 13.2-Conway."
        },
        "dvt_p_p_economic_group": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for protocol parameter changes, economic group. New in 13.2-Conway."
        },
        "dvt_p_p_technical_group": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for protocol parameter changes, technical group. New in 13.2-Conway."
        },
        "dvt_p_p_gov_group": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for protocol parameter changes, governance group. New in 13.2-Conway."
        },
        "dvt_treasury_withdrawal": {
          "type": "number",
          "nullable": true,
          "description": "DRep Vote threshold for treasury withdrawal. New in 13.2-Conway."
        },
        "committee_min_size": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "Minimal constitutional committee size. New in 13.2-Conway."
        },
        "committee_max_term_length": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "Constitutional committee term limits. New in 13.2-Conway."
        },
        "gov_action_lifetime": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "Governance action expiration. New in 13.2-Conway."
        },
        "gov_action_deposit": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "Governance action deposit. New in 13.2-Conway."
        },
        "drep_deposit": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "DRep deposit amount. New in 13.2-Conway."
        },
        "drep_activity": {
          "type": "string",
          "nullable": true,
          "format": "word64type",
          "description": "DRep activity period. New in 13.2-Conway."
        },
        "pvtpp_security_group": {
          "type": "number",
          "nullable": true,
          "deprecated": true,
          "description": "Pool Voting threshold for security-relevant protocol parameters changes. Renamed to pvt_p_p_security_group."
        },
        "pvt_p_p_security_group": {
          "type": "number",
          "nullable": true,
          "description": "Pool Voting threshold for security-relevant protocol parameters changes."
        },
        "min_fee_ref_script_cost_per_byte": {
          "type": "number",
          "nullable": true
        }
      },
      "required": [
        "min_fee_a",
        "min_fee_b",
        "max_block_size",
        "max_tx_size",
        "max_block_header_size",
        "key_deposit",
        "pool_deposit",
        "e_max",
        "n_opt",
        "a0",
        "rho",
        "tau",
        "decentralisation_param",
        "extra_entropy",
        "protocol_major_ver",
        "protocol_minor_ver",
        "min_utxo",
        "min_pool_cost",
        "cost_models",
        "price_mem",
        "price_step",
        "max_tx_ex_mem",
        "max_tx_ex_steps",
        "max_block_ex_mem",
        "max_block_ex_steps",
        "max_val_size",
        "collateral_percent",
        "max_collateral_inputs",
        "coins_per_utxo_size",
        "coins_per_utxo_word",
        "pvt_motion_no_confidence",
        "pvt_committee_normal",
        "pvt_committee_no_confidence",
        "pvt_hard_fork_initiation",
        "dvt_motion_no_confidence",
        "dvt_committee_normal",
        "dvt_committee_no_confidence",
        "dvt_update_to_constitution",
        "dvt_hard_fork_initiation",
        "dvt_p_p_network_group",
        "dvt_p_p_economic_group",
        "dvt_p_p_technical_group",
        "dvt_p_p_gov_group",
        "dvt_treasury_withdrawal",
        "committee_min_size",
        "committee_max_term_length",
        "gov_action_lifetime",
        "gov_action_deposit",
        "drep_deposit",
        "drep_activity",
        "pvtpp_security_group",
        "pvt_p_p_security_group",
        "min_fee_ref_script_cost_per_byte"
      ]
    }
  },
  "required": [
    "id",
    "tx_hash",
    "cert_index",
    "parameters"
  ]
}