Ethereum API Overview

Learn all about Blockdaemon's Ethereum Staking API.

The Blockdaemon Staking API enables custodians and crypto-savvy traders to use a standardized and trusted API. This automates transaction signing and enables the scaling of the solution over time.

Our Ethereum API enables you to completely outsource the operation of Ethereum validators while retaining full custody of the withdrawal address for the validators you create. Blockdaemon maintains a pool of pre-provisioned validators, ensuring immediate API responses. Clients can swiftly obtain and sign staking transactions within milliseconds. A single transaction can create up to 250 validators, offering both convenience and substantial gas cost reductions.

Supported Networks

The Staking API supports the following Ethereum networks:

  • Mainnet
  • Goerli/Prater
  • Sepolia

User Journey

In this section, we present a typical user journey when interacting with the Ethereum Staking API:

  1. Account Setup
  2. Staking ETH
  3. Accruing Rewards
  4. Withdrawing Your Funds by Exiting Validators

1. Account Setup

As you create your Staking API account, you'll provide an Ethereum address serving as the fee recipient and withdrawal address for all created validators. Additional preferences, such as MEV provider choice, data center selection for where the Ethereum nodes will run, pool size of pre-provisioned validators, and staking plan preference (static or dynamic), may also be specified.

2. Staking ETH

Staking your funds by creating validators is initiated through the Post Stake Intent endpoint. The endpoint returns an unsigned transaction requiring you to sign and broadcast it to the network by the account providing the funds for staking. Utilizing the Blockdaemon Batch Deposit contract, a single transaction can create multiple Ethereum validators, achieving significant gas cost savings.

Obtaining a launchpad deposit file (optional)

If you prefer to execute deposits through the official Ethereum Launchpad website or through direct interaction with the validator deposit smart contract, you can obtain a standard launchpad deposit data file using the Generate an Ethereum Launchpad Deposit File endpoint.

It's important to note that using a Launchpad deposit file would require you to sign and broadcast a separate deposit transaction for each validator created. This approach is less convenient and more costly compared to the Blockdaemon batch deposit contract.

3. Accruing Rewards

Revenue from validation, transaction fees, and MEV commission is automatically and continuously transferred to your specified withdrawal address, eliminating the need for user intervention. If desired, Blockdaemon can notify you when sufficient funds have accumulated for the creation of additional Ethereum validators to help you achieve the most efficient auto-compounding for your staking investment.

4. Withdrawing Your Funds by Exiting Validators

Utilize the Exit Ethereum Validator endpoint to generate and broadcast the exit transaction to the network.

The Generate a Signed Voluntary Exit Message endpoint generates the exit transaction but does not broadcast it to the network. Instead, the signed exit transaction is returned as part of the response.

Example Code