OBobol
DV Exit

Push Distributed Validator partial signed exit message

Changed on

This endpoint saves partial signed exit messages. Every partial_exits[].public_key must be a distributed_public_key of the lock (matched case-insensitively). epoch and validator_index are uint64 decimal strings.

The API keeps exactly one exit per validator pubkey: the first accepted partial exit fixes its epoch and validator_index, and later partial exits for that pubkey from any operator must use the same values or are rejected with 400. To change the epoch, every operator must first delete their partial exit. A pubkey whose exit is stored under a different lock hash is rejected with 409.

post/v1/exp/partial_exits/{lockHash}

Request

  • Base URL
    https://api.obol.tech
  • Auth
    none declared

Path parameters

lockHashstring required

The lockHash of the cluster which the validator belongs to

Request body

share_idxnumber required
signaturestring required

Example request

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

Response

success message

Changes

  • c545dd14c211Revision changes
    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

  • 5eee8e5f5216Revision changes
    • breaking

      added the pattern ^0x[0-9a-fA-F]{130}$ to the request property

    • breaking

      added the pattern ^0x[0-9a-fA-F]{192}$ to the request property ///

    • warning

      the request property's min was set to 1.00

    • warning

      changed the pattern of the request property // from ^(0x|0h)?[0-9A-F]+$ to ^0x[0-9a-fA-F]{96}$