Create Validators

Creates new 0x01 validators and returns a staking transaction to stake ETH

Notes:

• Once set, the withdrawal address of a validator cannot be changed.
• Maximum 250 validators can be created per request.
• If you are restaking via Eigenlayer, your withdrawal address is set to your EigenPod address.
• Depending on how you plan to sign the staking transaction we provide 3 transaction formats in the response See the guide.

0x01 Validators 0x02 Validators (Pectra)

Parameters:

• network
  string
  enum
  required
  The network on which validators will be created.
  Allowed: mainnet, hoodi

• validators_count
  integer
  required
  The number of validators that need to be created.

• withdrawal_address
  string
  required
  An ETH wallet address used for the withdrawals credentials of the validators. This is the address that will receive consensus rewards and unstaked ETH after exiting.

• funding_address
  string
  An ETH wallet address that holds the ETH to be staked and that will sign the staking transaction. If not specified, withdrawal_address will be used.

• fee_recipient_address
  string
  An ETH wallet address that will receive the execution layer rewards. If not specified, withdrawal_address will be used.

• region
  string
  enum
  The geographic region where the validator will be created.
  Allowed: ca-central-1, eu-west-1

• credentials_prefix
  string
  enum
  Prefix to use for withdrawal_credentials. Defaults to '0x01'.
  Allowed: 0x01

Responses:

201 Created validators

data

• id
  string
  A unique UUID for the validator.
• index
  integer | null
  Validator's onchain index
• network
  string
  enum
  Allowed: mainnet, hoodi
• pubkey
  string
  The pubkey for the validator. Prefixed with 0x.
• withdrawal_address
  string
• status
  string
  The current status of the validator.
• withdrawal_credentials
  string
  Withdrawal credentials for the validator funds to be withdrawn upon exit.
• fee_recipient_address
  string
  The fee recipient address that receives Execution Layer fees. For Figment-operated validators only.
• net_fee_payout_address
  string
  The net payout address that receives the customer's share of Execution Layer fees. For Figment-operated validators only.
• region
  string
  The geographic region in which the validator operates. For Figment-operated validators only.

deposit_data

• data for funding the validator.

status_history

• details of the status history.

status_estimates

• estimates for the validator.

on_demand_exit

• details of the on-demand exit.

exit_message

• details of the exit message.

staking_request

• balance information for the validator.

Example Request:

curl --request POST \
     --url https://api.figment.io/ethereum/validators \
     --header 'accept: application/json' \ 
     --header 'content-type: application/json' \ 
     --header 'x-api-key: your-api-key-here' \ 
     --data '{
  "network": "mainnet"
}'

Example Response:

{
  "data": [
    {
      "network": "hoodi",
      "pubkey": "0x8fc7b098767d6b45f431ac820f6884f6f74bbebee4e6f30456bbcf48a280248307a8260f2913a27c076f2f0c64c67aad",
      "status": "provisioned",
      "withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "withdrawal_credentials": "0x010000000000000000000000e40f80618324c814cd444434670a44ba4583ae38",
      "net_fee_payout_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "fee_recipient_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "region": "ca-central-1",
      "deposit_data": {
        "deposit_data_root": "0xfd997ecea9711498990181f0e3f8426b1c9528e61a8fbcc999db5fb3b3d6ca4b",
        "deposit_message_root": "0xae8ccf82724a48014e7f694c3ee329210e435059d73a4fa4da2bcd825ced381e",
        "fork_version": "0x01017000",
        "signature": "0x802bec470e333c380a0c530361e76cfa27f662a411d993a663aa080070601411aae1263ccbd8f812199b1fff091e20fc0b7e793c1d0313d36d27040588d578fd8b6029be264cf79533132d1df0d40dc9ce5ba159fe4c936e9c4b4c9bf2988a29",
        "figment_signature": "0x308188024200e8a18a258b03149255a0fc4a62a6c51b99ce38c8a33b91b57d76ca1f37484a18d1efa2c2bc6182ad284ff8aad076248f27af179c0b86a6542fa67185aa1cc9f50e02420147dacbaf9cdae0638d44b824f199d9f8047d5eb9ae4ee3dfe9d1860ba7582ac4be464d46647d7ed3adac83789ec88f2b6d4ac426d90126076589291d83735c63a3",
        "deposit_cli_version": "2.7.0",
        "amount": 32000000000
      },
      "status_history": {
        "events": [
          {
            "status": "provisioned",
            "changed_at": "2024-02-22T14:14:07.848Z"
          }
        ]
      },
      "status_estimates": {
        "estimated_active_at": null,
        "estimated_exit_at": null,
        "estimated_withdrawal_at": null
      },
      "on_demand_exit": {
        "requested_at": null,
        "approved_at": null,
        "submitted_at": null,
        "request_id": null
      },
      "exit_message": null,
      "staking_request": {
        "id": "f9764269-ddb8-451f-9f81-fd460e3e2f14",
        "created_at": "2024-02-22T14:14:07.848Z"
      }
    }
  ],
  "meta": {
    "staking_request": {
      "id": "f9764269-ddb8-451f-9f81-fd460e3e2f14",
      "created_at": "2024-02-22T14:14:07.848Z",
      "amount_wei": "32000000000000000000",
      "withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "network": "hoodi",
      "region": "ca-central-1"
    },
    "staking_transaction": {
      "from": "0xE40F80618324C814cD444434670a44ba4583aE38",
      "to": "0xA627f94a8F94E4713d38F52aC3a6377B0a111d47",
      "amount_wei": "32000000000000000000",
      "contract_call_data": "0x4f498c730000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000308fc7b098767d6b45f431ac820f6884f6f74bbebee4e6f30456bbcf48a280248307a8260f2913a27c076f2f0c64c67aad00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000020010000000000000000000000e40f80618324c814cd444434670a44ba4583ae38000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000060802bec470e333c380a0c530361e76cfa27f662a411d993a663aa080070601411aae1263ccbd8f812199b1fff091e20fc0b7e793c1d0313d36d27040588d578fd8b6029be264cf79533132d1df0d40dc9ce5ba159fe4c936e9c4b4c9bf2988a290000000000000000000000000000000000000000000000000000000000000001fd997ecea9711498990181f0e3f8426b1c9528e61a8fbcc999db5fb3b3d6ca4bc0",
      "max_gas_wei": "1328940220021646"
    }
  }
}