Parameters

GET /network/parameters

status: stable

Returns the set of network parameters for the current epoch.

Responses

  • 406 application/json

    Not Acceptable

    Hide response attributes Show response attributes object
    • message string Required

      May occur when providing an invalid 'Accept' header.

    • code string Required

      Value is not_acceptable.

  • 200 application/json

    Ok

    Hide response attributes Show response attributes object
    • genesis_block_hash string(hex) Required

      The hash of a block

      Minimum length is 64, maximum length is 64.

    • blockchain_start_time string(iso-8601-date-and-time) Required
    • slot_length object Required

      Additional properties are allowed.

      Hide slot_length attributes Show slot_length attributes object
      • quantity number Required

        Minimum value is 0.0.

      • unit string Required

        Value is second.

    • epoch_length object Required

      Additional properties are allowed.

      Hide epoch_length attributes Show epoch_length attributes object
      • quantity integer Required

        Minimum value is 0.

      • unit string Required

        Value is slot.

    • security_parameter object Required

      Additional properties are allowed.

      Hide security_parameter attributes Show security_parameter attributes object
      • quantity integer Required

        Minimum value is 0.

      • unit string Required

        Value is block.

    • Additional properties are allowed.

      Hide active_slot_coefficient attributes Show active_slot_coefficient attributes object
      • quantity number Required

        Minimum value is 0, maximum value is 100.

      • unit string Required

        Value is percent.

    • decentralization_level object Required

      Additional properties are allowed.

      Hide decentralization_level attributes Show decentralization_level attributes object
      • quantity number Required

        Minimum value is 0, maximum value is 100.

      • unit string Required

        Value is percent.

    • desired_pool_number integer Required

      Minimum value is 0.

    • eras object Required

      If and when each era started or will start.

      The object is keyed by era names. The values either describe the epoch boundary when the era starts (can be in the future or in the past), or are null if not yet confirmed on-chain.

      If you need to know the current era, see the node_era field of GET /network/information.

      Due to complications with our current tooling, we cannot mark the era names as required, but the keys are in fact always present.

      Additional properties are allowed.

      Hide eras attributes Show eras attributes object
      • byron object | null

        Additional properties are allowed.

        Hide byron attributes Show byron attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • shelley object | null

        Additional properties are allowed.

        Hide shelley attributes Show shelley attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • allegra object | null

        Additional properties are allowed.

        Hide allegra attributes Show allegra attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • mary object | null

        Additional properties are allowed.

        Hide mary attributes Show mary attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • alonzo object | null

        Additional properties are allowed.

        Hide alonzo attributes Show alonzo attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • babbage object | null

        Additional properties are allowed.

        Hide babbage attributes Show babbage attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
      • conway object | null

        Additional properties are allowed.

        Hide conway attributes Show conway attributes object | null
        • epoch_number integer Required

          An epoch is a time period which is divided into slots.

          Minimum value is 0.

        • epoch_start_time string(iso-8601-date-and-time) Required
    • The maximum number of collateral inputs that can be used in a single transaction.

      Minimum value is 0.

    • The minimum required amount of collateral as a percentage of the total transaction fee.

      Minimum value is 0.

    • The maximum size of a serialized TokenBundle. The concept was added in Mary where it was hard-coded to 4000 bytes. In Alonzo it was made an updateable protocol parameter (_maxValSize).

      Additional properties are allowed.

      Hide maximum_token_bundle_size attributes Show maximum_token_bundle_size attributes object
      • quantity number Required

        Minimum value is 0.

      • unit string Required

        Value is byte.

    • The price of time unit and memory unit used for calculating a fee of a script execution.

      Additional properties are allowed.

      Hide execution_unit_prices attributes Show execution_unit_prices attributes object
GET /network/parameters
curl \
 --request GET 'https://localhost:8090/v2/network/parameters'
Response examples (406)
{
  "message": "string",
  "code": "not_acceptable"
}
Response examples (200)
{
  "genesis_block_hash": "3c07030e36bfffe67e2e2ec09e5293d384637cd2f004356ef320f3fe6c52041a",
  "blockchain_start_time": "2019-02-27T14:46:45Z",
  "slot_length": {
    "quantity": 10.0,
    "unit": "second"
  },
  "epoch_length": {
    "quantity": 42000,
    "unit": "slot"
  },
  "security_parameter": {
    "quantity": 1337,
    "unit": "block"
  },
  "active_slot_coefficient": {
    "quantity": 42,
    "unit": "percent"
  },
  "decentralization_level": {
    "quantity": 42,
    "unit": "percent"
  },
  "desired_pool_number": 100,
  "eras": {
    "byron": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "shelley": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "allegra": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "mary": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "alonzo": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "babbage": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    },
    "conway": {
      "epoch_number": 14,
      "epoch_start_time": "2019-02-27T14:46:45Z"
    }
  },
  "maximum_collateral_input_count": 3,
  "minimum_collateral_percentage": 42,
  "maximum_token_bundle_size": {
    "quantity": 4000,
    "unit": "byte"
  },
  "execution_unit_prices": {
    "step_price": 42.0,
    "memory_unit_price": 42.0
  }
}