Ethereum

Post Stake Intent

Changed on Nov 3, 2026

Reserves one or more available validators and returns an unsigned transaction. Supports 0x01 withdrawal address types. The validators will remain reserved for 90 days or until the returned transaction is signed and confirmed in the network. Blockdaemon reserves the right to free any allocated resources if the transaction is not confirmed in time.

A single transaction can create up to 250 validators through the use of the Blockdaemon batch deposit contract which delivers over 50% reduction in gas fees when compared to submitting individual transactions for each deposit.

To complete the staking process, you must sign an Ethereum transaction with a data field set to match the returned unsigned_transaction property of the response. The recipient of the transaction must be set to the contract_address property of the response. The account signing the transaction must have the sufficient balance to create the requested number of validators and this amount must be provided as the value of the signed transaction.

post/v1/ethereum/{network}/stake-intents

Request

Base URL
https://svc.blockdaemon.com/boss
URL
https://svc.blockdaemon.com/boss/v1/ethereum/{network}/stake-intents
Auth
API key in header X-API-KEY

Request body

plan_idstring

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 to stake to validators on a shared node from the specified plan.

Example request

{
  "stakes": [
    {
      "amount": "32000000000",
      "withdrawal_address": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
      "fee_recipient": "0x93247f2209abcacf57b75a51dafae777f9dd38bc"
    }
  ],
  "plan_id": "plan_Wgx98Rbi8nQuL9ddn3mTk1"
}

Response

Created

stake_intent_idstring base58 required

Unique idenifier for a group of stakes.

customer_idstring required

Unique identifier for a customer

plan_idstring

protocol'ethereum' required

Ethereum protocol

network'mainnet' | 'hoodi' required

Ethereum network

Example response

{
  "stake_intent_id": "stake_intent_Wgx98Rbi8nQuL9ddn3mTk1",
  "customer_id": "SatoshiNakamoto-xUYJbPw9hw",
  "plan_id": "plan_Wgx98Rbi8nQuL9ddn3mTk1",
  "ethereum": {
    "stakes": [
      {
        "stake_id": "stake_Wgx98Rbi8nQuL9ddn3mTk1",
        "amount": "32000000000",
        "validator_public_key": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c",
        "withdrawal_credentials": "0x0092c20062cee70389f1cb4fa566a2be5e2319ff43965db26dbaa3ce90b9df99",
        "fee_recipient": "0x93247f2209abcacf57b75a51dafae777f9dd38bc"
      }
    ],
    "contract_address": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
    "unsigned_transaction": "0x22895118000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120087fed394b43849eebef1e88873cd9efdbe33136656e5148e659b8b2f33625d40000000000000000000000000000000000000000000000000000000000000030b81748644e23c4d950f9dd709f3eb73d5eacd9657997e1d9dde7c4ebd8a6519ecb9d0a7fb603d3b68e023278f9650122000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020010000000000000000000000c509bb854c526af4cee5e037089f7aa8e091d8870000000000000000000000000000000000000000000000000000000000000060b36b79b4b206c0310472c117fa40c05342b5dc3e89f98f42c9da3ce6450d4c603cad55248017fd4eca3ab277cca64569193e4d487f5b2ea78a2bcdc81926c313c05842a3af318967a775783bba22519e8b8886587efa99aa7dab5784f792b187\n",
    "estimated_gas": 1001,
    "expiration_time": 1689939023
  }
}

Changes

Nov 3, 20262c09b3ef4f99 Revision changes
- breaking
  the response's property type changed from string to integer, and format from no format to int32 for status
- breaking
  the response's property type changed from string to integer, and format from no format to int32 for status
- breaking
  the response's property type changed from string to integer, and format from no format to int32 for status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status

Operation history