Stake ETH

post

https://your-protect-instance.example.com/api/rest/v1/requests/staking/eth_stake

This endpoint will begin the process of staking on an ethereum address

Body Params

fromAddressId

string

required

the ID of the address to stake

amount

string

the amount (in wei) to stake. For '0x01' validators it must be a multiple of 32 ETH. For '0x02' validators any amount in [32, 2048] ETH is accepted; top-ups require at least 1 ETH and the validator's combined balance must stay under 2048 ETH.

provider

object

required

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.

comment

string

A reconciliation notes can be given when initiating a request and this will be included in transaction history.

externalRequestId

string

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

withdrawalCredentialType

string

Ethereum withdrawal credential type. Accepted values: "0x01" (deprecated, legacy, rewards above 32 ETH are swept and do not compound), "0x02" (Pectra upgrade, rewards auto-compound, max effective balance 2048 ETH, only this should be used). Defaults to "0x01" for figment and "0x02" for p2p. p2p only supports "0x02".

ethValidatorID

string

Only in case of top-ups specify the validatorId to top-up. If no validator is specified a new one is created instead. Top-ups are only compatible with "0x02" withdrawal credentials validators.

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.