DV Exit

Retrieve Distributed Validator threshold aggregated signed exit msg

get
/exp/exit/{lockHash}/{shareIdx}/{validatorPubkey}

This endpoint is used to retrieve validator exit message

Authorizations
Path parameters
validatorPubkeystringRequired

The distributed_public_key in a cluster lock.

shareIdxanyRequired

Represents the cluster operatorIndex+1.

lockHashanyRequired

The cluster lockHash.

Responses
200

The DV signed exit message

application/json
Responseany of
objectOptional
get
/exp/exit/{lockHash}/{shareIdx}/{validatorPubkey}
GET /exp/exit/{lockHash}/{shareIdx}/{validatorPubkey} HTTP/1.1
Host: api.obol.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{}

Retrieve Distributed Validator threshold aggregated signed exit msg

get
/v1/exp/exit/{lockHash}/{shareIdx}/{validatorPubkey}

This endpoint is used to retrieve validator exit message

Authorizations
Path parameters
validatorPubkeystringRequired

The distributed_public_key in a cluster lock.

shareIdxanyRequired

Represents the cluster operatorIndex+1.

lockHashanyRequired

The cluster lockHash.

Responses
200

The DV signed exit message

application/json
Responseany of
objectOptional
get
/v1/exp/exit/{lockHash}/{shareIdx}/{validatorPubkey}
GET /v1/exp/exit/{lockHash}/{shareIdx}/{validatorPubkey} HTTP/1.1
Host: api.obol.tech
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{}

Retrieve validators exit status

get
/exp/exit/status/{lockHash}

It shows data of operators who have signed and who have not

Path parameters
lockHashstringRequired

The cluster lockHash.

Query parameters
pagenumberRequired
limitnumberRequired
operatorAddressstringRequired

The operatorAddress.

validatorPubkeystringRequired

The pubkey in a cluster lock.

Responses
200

The exit status data

application/json
Responseany of
objectOptional
get
/exp/exit/status/{lockHash}
GET /exp/exit/status/{lockHash}?page=1&limit=1&operatorAddress=text&validatorPubkey=text HTTP/1.1
Host: api.obol.tech
Accept: */*
{}

Retrieve validators exit status

get
/v1/exp/exit/status/{lockHash}

It shows data of operators who have signed and who have not

Path parameters
lockHashstringRequired

The cluster lockHash.

Query parameters
pagenumberRequired
limitnumberRequired
operatorAddressstringRequired

The operatorAddress.

validatorPubkeystringRequired

The pubkey in a cluster lock.

Responses
200

The exit status data

application/json
Responseany of
objectOptional
get
/v1/exp/exit/status/{lockHash}
GET /v1/exp/exit/status/{lockHash}?page=1&limit=1&operatorAddress=text&validatorPubkey=text HTTP/1.1
Host: api.obol.tech
Accept: */*
{}

Retrieve validators exit status summary

get
/exp/exit/status/summary/{lockHash}

It shows data of operators who have signed and the count of validators ready to exit

Path parameters
lockHashstringRequired

The cluster lock hash.

Responses
200

The exit summary data

application/json
Responseany of
get
/exp/exit/status/summary/{lockHash}
GET /exp/exit/status/summary/{lockHash} HTTP/1.1
Host: api.obol.tech
Accept: */*
{
  "operator_exits": {
    "0x000000000000000000000000000000000000dea1": 5,
    "0x000000000000000000000000000000000000dead": 10
  },
  "ready_exits": 2
}

Retrieve validators exit status summary

get
/v1/exp/exit/status/summary/{lockHash}

It shows data of operators who have signed and the count of validators ready to exit

Path parameters
lockHashstringRequired

The cluster lock hash.

Responses
200

The exit summary data

application/json
Responseany of
get
/v1/exp/exit/status/summary/{lockHash}
GET /v1/exp/exit/status/summary/{lockHash} HTTP/1.1
Host: api.obol.tech
Accept: */*
{
  "operator_exits": {
    "0x000000000000000000000000000000000000dea1": 5,
    "0x000000000000000000000000000000000000dead": 10
  },
  "ready_exits": 2
}

Push Distributed Validator partial signed exit message

post
/exp/partial_exits/{lockHash}

This endpoint saves partial signed exit messages.

Path parameters
lockHashstringRequired

The lockHash of the cluster which the validator belongs to

Body
share_idxnumberRequiredExample: 42
signaturestringRequired
Responses
201

success message

No content

post
/exp/partial_exits/{lockHash}
POST /exp/partial_exits/{lockHash} HTTP/1.1
Host: api.obol.tech
Content-Type: application/json
Accept: */*
Content-Length: 256

{
  "partial_exits": [
    {
      "public_key": "0x8b69c67720c909423d7edc5d3a7554e1d1e50f6d7d5f8d18548d68daf424e536afba8b31fbd15df1970ba4af4a7d944c",
      "signed_exit_message": {
        "message": {
          "epoch": "162304",
          "validator_index": "42"
        },
        "signature": ""
      }
    }
  ],
  "share_idx": 42,
  "signature": ""
}

No content

Push Distributed Validator partial signed exit message

post
/v1/exp/partial_exits/{lockHash}

This endpoint saves partial signed exit messages.

Path parameters
lockHashstringRequired

The lockHash of the cluster which the validator belongs to

Body
share_idxnumberRequiredExample: 42
signaturestringRequired
Responses
201

success message

No content

post
/v1/exp/partial_exits/{lockHash}
POST /v1/exp/partial_exits/{lockHash} HTTP/1.1
Host: api.obol.tech
Content-Type: application/json
Accept: */*
Content-Length: 256

{
  "partial_exits": [
    {
      "public_key": "0x8b69c67720c909423d7edc5d3a7554e1d1e50f6d7d5f8d18548d68daf424e536afba8b31fbd15df1970ba4af4a7d944c",
      "signed_exit_message": {
        "message": {
          "epoch": "162304",
          "validator_index": "42"
        },
        "signature": ""
      }
    }
  ],
  "share_idx": 42,
  "signature": ""
}

No content

Last updated

Was this helpful?