FIfireblocks
Staking

Consolidate staking positions (ETH validator consolidation)

Consolidates the source staking position into the destination, merging the balance into the destination and closing the source position once complete. Both positions must be from the same vault account (i.e. same withdrawal credentials). On chain, this translates into a consolidation transaction, where the source validator is consolidated into the destination validator. Supported chains: Ethereum (ETH) only. Endpoint Permission: Owner, Admin, Non-Signing Admin, Signer, Approver, Editor. Note: This endpoint is currently in beta and might be subject to changes.

post/staking/chains/{chainDescriptor}/consolidate

Request

Path parameters

chainDescriptor'ETH' | 'ETH_TEST6' | 'ETH_TEST_HOODI' required

Protocol identifier for the staking operation (e.g., ETH).

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

sourceIdstring uuid required

Id of the source position to merge from

destinationIdstring uuid required

Id of the destination position to merge into

feestring

Represents the fee for a transaction, which can be specified as a percentage value. Only one of fee/feeLevel is required.

feeLevel'LOW' | 'MEDIUM' | 'HIGH'

Represents the fee level for a transaction, which can be set as slow, medium, or fast. Only one of fee/feeLevel is required.

txNotestring

The note to associate with the merge transaction.

Example request

{
  "sourceId": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d",
  "destinationId": "f3432f4-34d1-43495-a8ee-jfdjnfj34i3",
  "txNote": "Merging stake for optimization",
  "feeLevel": "MEDIUM"
}

Response

Merge request accepted and created.

idstring required

The unique identifier of the merge position (the id of the destination position)

Example response

{
  "id": "b70701f4-d7b1-4795-a8ee-b09cdb5b850d"
}

Changes

No recorded changes to this operation across all 1 revision of this API.