latestOpenAPI 3.0.02026-08-138371125.7 KB

707a88e0b355

Cluster Lock

Get current peer info for a cluster lock

Returns current-state peer rows from Mongo peer_info keyed by lock_hash (identity fields by default). Does not require the lock to exist in clusterlocks; returns an empty array when no peer_info rows match. Client-only stubs with null lock_hash are included when their cluster_hash matches the lock hash prefix. Pass client-details=true to include BN/VC/EL/Charon versions. Optional filters: node-index, operator-address. Note: until the data-pipelines peer_key/stub merge fix is deployed, the same Charon peer name may appear twice (a thin client stub with null node_index and a full identity row).

get/lock/{lockHash}/peer-info

Path parameters

lockHashstring required

Lock hash used to look up peer_info rows (and stub cluster_hash prefix).

Query parameters

client-detailsstring

Example:true

When true, include nested client_details (beacon, validator, execution, charon).

node-indexstring

Example:0

Filter to a single peer by node index (integer or numeric string).

operator-addressstring

Example:0x7a82E643B0c8AE619f71d9667559180c33c92277

Filter to a single peer by operator address (any EIP-55 casing).

Response

Array of peers for the lock

peerstring nullable

peer_nicknamestring nullable

node_indexinteger nullable

operator_addressstring nullable

peer_info_last_updated_atstring date nullable

last_checked_atstring date-time nullable

Example response

[
  {
    "peer": "affectionate-fish",
    "peer_nickname": "DSRV",
    "operator_address": "0x7a82E643B0c8AE619f71d9667559180c33c92277",
    "peer_info_last_updated_at": "2026-08-03"
  }
]