Skip to content
On this page

Generate Deposit Transactions for Validators

[POST]/funding_transactions

EndpointDescription
https://eth-api.everstake.one/api/v1/eth2_staking/funding_transactionsThis method generates an unsigned deposit transaction for the specified number of validators. If there aren’t any available validators, the response will contain a null raw transaction. This method is an integral part of the Eth2 staking process and aids users in preparing their deposit transactions conveniently.

Request Parameters

ParameterTypeDescription
funding_addressstringThe Ethereum funding address.
withdrawal_addressstringThe Ethereum withdrawal address.
validators_countintegerThe number of validators.
eth2_network_namestringThe network name, denoting testnet (goerli) or mainnet (mainnet).

Request Example

json
{
    "funding_address": "0xBe000000000000000000000000000000000000b9",
    "withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
    "validators_count": 1,
    "eth2_network_name": "mainnet"
}

RequestcURL

bash
curl -X 'POST' \
'https://eth-api.everstake.one/api/v1/eth2_staking/funding_transactions' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"funding_address": "0xBe000000000000000000000000000000000000b9",
"withdrawal_address": "0xE40F80618324C814cD444434670a44ba4583aE38",
"validators_count": 1,
"eth2_network_name": "mainnet"

Response Details

ParameterTypeDescription
data:idintegerUnique identifier of the validator.
data:typestringThe type of object, which is "validator" for this endpoint.
data:attributesobjectContains attributes of the validator including unique ID, public key, amount, position name, status, etc.
data:relationships:position:dataobjectContains information about the associated staking position.
data:meta:raw_transactionobjectContains details about the raw transaction, such as the sender’s address (from), receiver’s address (to), value of the transaction, and data.
linksobjectContains pagination links based on page[size] and page[number]. Includes self, current, next, last, and prev.

Response Example

json
{
  "data": [
    {
      "id": "31",
      "type": "validator",
      "attributes": {
        "id": 31,
        "pubkey": "d1ef8d468ef53d82368d2026e321ab2c6d44f44c33b7b9f22369bf6dcf37fb0208f82dd6b485325ce1bbf5aec7ad45bb",
        "name": "string",
        "withdrawal_credentials": "010000000000000000000000fc438e6cc4b230eb5bfaae1337c3f5da2b9140f1",
        "amount": 32000000000,
        "signature": "aab7e3b41689fced6c3437a6bc5caf471ed319b94ad2642c47c5f641d5e3a046432171d47d48cd7a3e8a323939d4976c1315ad4dae134c421214673ddff9105ef1bb7f79c1babc6cd9c31428d5e44472164e9c9fccfd10fb9768c0855b194f49",
        "deposit_data_root": "b2f5083221d6b61f2237af155c07c746f6a75c7d24dfe418106efdf87e9b9422",
        "deposit_message_root": "026cbefa013e03a3d81592b7a5f6205773c12a6f7674529e497e9a4eb2df2d44",
        "deposit_cli_version": "1.2.0",
        "fork_version": "00000000",
        "eth2_network_name": "goerli",
        "status": "funding_requested",
        "status_synced_at": "2023-01-14T16:00:14.459Z",
        "fee_recipient_address": "0x781462762B706AA7c1DA71FBA1a545724928b81f"
      },
      "status_history": [
        {
          "status": "funding_requested",
          "changed_at": "2023-01-14T16:00:14.459Z"
        }
      ],
      "relationships": {
        "position": {
          "data": {
            "id": "13",
            "type": "position"
          }
        }
      }
    }
  ],
  "links": {
    "self": "string",
    "current": "string"
  },
  "meta": {
    "from": "0xBe000000000000000000000000000000000000b9",
    "to": "0x2f9bCa3Ab411Bd26f78B69d12A8DaF0Effb3C516",
    "value": "32000000000000000000",
    "data": "0x4f498c73000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001e0000000000000000000000000000000000000000000000000000000000000030000000000000000000000000000000000000000000000000000000000000005200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000006038313964353230333235313539313433393232323934306139393163663739333466656231383334373534656133613034343962393339656266313166643965323831373636663966386334626532616332383165313138633635383231383500000000000000000000000000000000000000000000000000000000000000606134343635346163306461613136613465366636313836653437333961383436386533613662633639663364666364643264393863353966336135363736363133373236343066303661303033303833663632623065376561613335386661300000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000000403031303030303030303030303030303030303030303030306261623033653739626334363564363137326231623535326237636363646536646339653139623700000000000000000000000000000000000000000000000000000000000000403031303030303030303030303030303030303030303030306261623033653739626334363564363137326231623535326237636363646536646339653139623700000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000012000000000000000000000000000000000000000000000000000000000000000c061613034633330613537643565343630623939666239306264353863323461363961643434333465383933383833343132333866613565323865623830623630663335633433623761336262376332653464616362353965306264336336636531333632333365383263356164343331636536363061393566393962396437373230393332313462363338656466316137376263656365373639656636336432363732376135626639643636633536373763353733623030336263326134343600000000000000000000000000000000000000000000000000000000000000c0386363613363363839323662636435633761383561626538393161323961653131626139343138323065623638663339633862633665393035396339666134363862373564643464613437336534653161636263663362343538383165373864306235346564366664643936623461303632363233633034623736383732313532313039303234666663366635663030313466393936366161376537653562613738313863333037613363353161626664653736396161303433386136663063000000000000000000000000000000000000000000000000000000000000000200f2e67348479dcada2cca326f4353d929c1861dff713802738b2116ec29dba6f0ed88b0a11faba6377686b1ec2184e78afbcf96a69f43c0127c9ce1f2798834"
  }
}