Ethereum Network Stake Intent

network

• Type: string
• Enum: Required
• Allowed Values: mainnet, hoodi

validator_type

• Type: string
• Enum: Defaults to 0x01
• Allowed Values: 0x01, 0x02
• Description: Type of validator to create (0x01 for standard, 0x02 for Pectra)

stakes

• Type: array of objects
• Required: Length between 1 and 250
• Description: Stakes for the Ethereum protocol.

stakes*

• Type: object
• Description: Details of an individual Ethereum Stake request.

amount

• Type: string
• Required: Yes
• Format: ^[1-9]\d{10,}$
• Description: Amount of ETH (denominated in Gwei).

withdrawal_address

• Type: string
• Required: Yes
• Format: ^0x[a-fA-F0-9]{40}$
• Description: Hex-encoded Ethereum account or smart contract address.

quantity

• Type: int32
• Restrictions: ≥ 1
• Description: Number of validators to create that will share the same withdrawal credentials.

fee_recipient

• Type: string
• Format: ^0x[a-fA-F0-9]{40}$
• Description: An Ethereum address to receive transaction fees from published blocks.

ADD object

plan_id

• Type: string
• Description: This feature enables you to stake to validators from the specified plan(s). When no plan id is specified, validators across all plans that match the API route will be available for staking. If it is a shared plan, you can stake to validators on a shared node from the specified plan.

Idempotency-Key

• Type: uuid
• Description: The unique idempotency key for this request.

HTTP Status Codes

• 200: Created
• 400: Invalid request.
• 401: Header 'X-API-Key' missing.
• 500: Internal server error.
• 503: Insufficient validators available to process Stake Intent request.

Example Curl Request

curl --request POST \
    --url 'https://svc.blockdaemon.com/boss/v1/ethereum/mainnet/stake-intents?validator_type=0x01' \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --data '{"stakes":[]}'