Sign in
latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

Cluster Lock

Retrieve a Distributed Validator Cluster Lock Object

This endpoint is used to retrieve a cluster lock object.

get/v1/lock/{lockHash}

Path parameters

lockHashstring required

The lock_hash calculated for a cluster lock.

Query parameters

validatorsboolean

Set to false to omit distributed_validators and receive a validator_count field instead. Intended for lazy-loading very large clusters via GET /lock/{lockHash}/validators.

Response

The cluster lock object

OR

Example response

{
  "cluster_definition": {
    "name": "My Obol Cluster",
    "uuid": "0194FDC2-FA2F-FCC0-41D3-FF12045B73C8",
    "version": "v1.8.0",
    "num_validators": 5,
    "threshold": 3,
    "dkg_algorithm": "default",
    "fork_version": "0x00001020",
    "config_hash": "0x2204ba6c238ed2d6a8ff951d4513db993c8d6f8860468391342649bf735a87d7",
    "timestamp": "2022-07-19T18:19:58+02:00",
    "deposit_amounts": [
      "8000000000",
      "16000000000",
      "8000000000"
    ],
    "definition_hash": "0xb656f5a4a5537b5817d6bcf735d043f17f5aff568b1a7ec9102a9f687bd4510c",
    "fee_recipient_address": "0x000000000000000000000000000000000000dead",
    "withdrawal_address": "0x000000000000000000000000000000000000dead",
    "consensus_protocol": "qbft",
    "target_gas_limit": 36000000,
    "compounding": true
  },
  "signature_aggregate": "0x85650c30ec29a3703934bf50a28da102975deda77e758579ea3dfe4136abf752",
  "lock_hash": "0xd2880980169ee4a0000f23feb8fad9a6c70f38312956fe67aa89e118f5b0e048"
}