Signed exit transactions

To ensure an extra level of security for our customers, this endpoint may be used to generate a pre-signed exit transaction.

As Opus is a non-custodial solution our customers will hold ownership of their withdrawal credentials and thereby own the funds. When spinning up validators via /stake endpoint, customers sign a deposit txn to confirm the deposit of 32 ETH per validator. To participate in the Ethereum consensus, Chorus One generates and holds the signing keys. Please refer to our key management blog to learn more about our key management practices.

To exit a validator on the Ethereum network the following process is required:

• generating a signed exit transaction (this is to be signed with the signing key)

• propagate the signed exit transaction to the Ethereum Network

Our /unstake endpoint facilitates the above two steps. For further information on how exiting a validator works on Ethereum, read our Ethereum unstake 101 blog article.

For security reasons and to empower our customers, we’ve added an extra layer of protection. After creating a validator, customers may use the /signed-exit-transaction endpoint to generate a pre-signed exit transaction. Customers can exit their validators at their chosen time by simply propagating the transaction to an Ethereum Beacon Node. We recommend storing the pre-signed exit transaction safely such that it is protected from misuse.

Pregenerate signed exit transaction for previously created validators via OPUS API, customers can opt-in to encrypt the response with a PGP public key shared previously.

POSThttp://localhost:8080/api/v1/signed-exit-transactions

Body

application/json

public_keysarray of string

Array of public signing key, if empty returns all validators

Response

200400404

OK

Body

application/json

exit_transactionsarray of string

fork_version*string

hex encoded current fork version of the beacon_chain (at the time of this request)

Request

JavaScriptCurl

const response = await fetch('http://localhost:8080/api/v1/signed-exit-transactions', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "exit_transactions": [
    "example signature data:\n{\n  \"exit\":{\n    \"message\":{\n      \"epoch\":\"38878\",\n      \"validator_index\":\"125689\"\n    },\n    \"signature\":\"0x84f21a5156596e3028e22e\n      7cc7de56a550734994171dde6fdd6cf\n      98edbe5ada2124f9a974be2b73b2f1c99\n      fab03324a1f90338c5ea5a73bb3c53598\n      e276502ac17f37062d4bc84f1c3d714e3\n      b33f48e6c34dec961e638ffd48e21d734fec0fdc\"\n  }\n}\n"
  ],
  "fork_version": "text"
}