v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

Ethereum

Generate a Signed Voluntary Exit Message

Generates a voluntary exit message, but does not broadcast it to the network. Instead, the signed message is returned as part of the response. You can use the Native Ubiquity API for Ethereum to broadcast the message.

An exit message can be generated shortly after staking, once the validator shows a status on the consensus layer, typically within 7 hours after paying the deposit.
Broadcasting or executing the exit is only possible after the validator reaches active status and has completed the activation queue.

Note: The validator must remain active for a minimum of 256 epochs, or approximately 27 hours, as per the Ethereum protocol rules.

get/v1/ethereum/{network}/signed-voluntary-exit

Path parameters

network'mainnet' | 'hoodi' required

Ethereum network

Query parameters

show_fork_versionboolean

When this parameter is set to true, the response will include the field fork_version indicating the fork version constant for the currently active fork.

The fork versions values are unique for each network and each fork. As an example, here is the constants preset file for Mainnet: https://github.com/ethereum/consensus-specs/blob/dev/configs/mainnet.yaml

validator_indexinteger

Validator index

Example:25

validator_public_keystring hex

Public Key of an asymmetric key-pair.

Example:0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c

Validator public key

epochinteger

Earliest epoch when voluntary exit can be processed. If not provided the earliest possible epoch will be fetched from the network.

Example:1001

Response

Ethereum exit validator transaction response

signaturestring hex required

Ethereum signature

fork_versionstring required

A hex-encoded Ethereum fork version value.

Example response

{
  "message": {
    "validator_pubkey": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c",
    "validator_index": "25",
    "epoch": "1001"
  },
  "signature": "0x22895118000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120087fed394b43849eebef1e88873cd9efdbe33136656e5148e659b8b2f33625d40000000000000000000000000000000000000000000000000000000000000030b81748644e23c4d950f9dd709f3eb73d5eacd9657997e1d9dde7c4ebd8a6519ecb9d0a7fb603d3b68e023278f9650122000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020010000000000000000000000c509bb854c526af4cee5e037089f7aa8e091d8870000000000000000000000000000000000000000000000000000000000000060b36b79b4b206c0310472c117fa40c05342b5dc3e89f98f42c9da3ce6450d4c603cad55248017fd4eca3ab277cca64569193e4d487f5b2ea78a2bcdc81926c313c05842a3af318967a775783bba22519e8b8886587efa99aa7dab5784f792b187",
  "fork_version": "0x03000000"
}