Create an ETH consolidation request

post

https://your-protect-instance.example.com/api/rest/v1/requests/outgoing/eth/consolidate

Consolidate ETH validators per EIP-7251. With two different validators, the source's stake is merged into the target and the source is exited; the target must already have 0x02 (compounding) credentials and may belong to a different address than the source. With the same validator as source and target, it is upgraded from 0x01 to 0x02 credentials, without moving stake or exiting.

Body Params

fromAddressId

string

required

The ID of the address that owns the source validator.

sourceEthValidatorID

string

required

The internal ID of the source validator to consolidate from. Must belong to 'fromAddressId' and have 0x01 or 0x02 credentials.

targetEthValidatorID

string

required

The internal ID of the target validator to consolidate into. Must have 0x02 credentials and may belong to a different address. Or set it to the same value as 'sourceEthValidatorID' to upgrade that validator from 0x01 to 0x02 instead.

comment

string

A reconciliation note included in the request history.

externalRequestId

string

Identifier for the request in the user's system. This must be unique.

gasLimit

string

A target gas limit for the request. If not provided, one will be automatically computed.

gasPriceLimit

string

A hard limit for the gas price for the request. If not provided, one will be automatically computed.

contractFeeLimit

string

Max fee in wei paid to the EIP-7251 consolidation contract's dynamic anti-spam mechanism. Leave empty to use the default fee, which is sufficient in almost all cases.

Responses

200A successful response.

400Bad Request: indicates that the server cannot or will not process the request due to something that is perceived to be a client error (for example, malformed request syntax, invalid request message framing, or deceptive request routing)

401Unauthorized: indicates that the client request has not been completed because it lacks valid authentication credentials for the requested resource

403Forbidden: indicates that the server understands the request but refuses to authorize it

404Not Found: indicates that the server cannot find the requested resource

500Internal Server Error: indicates that the server encountered an unexpected condition that prevented it from fulfilling the request

503Service Unavailable: indicates that the server is not ready to handle the request.

defaultAn unexpected error response.