Incremental Staking (Top-ups)

1. Create an increment request.
2. Check the status of the request.
3. Sign and broadcast the transaction.

​

1. Create increment request

The flow applies only to active validators using the 0x02 type of withdrawal credentials.

1. Prepare id that is an arbitrary UUID. Generate it in one of the following ways:
   • Online UUID Generator
   • uuid npm package
2. Send a POST request to /api/v1/eth/staking/direct/increment-request/create. Example request:
   bash

   curl --request POST \
     --url https://api.p2p.org/api/v1/eth/staking/direct/increment-request/create \
     --header 'Content-Type: application/json' \
     --header 'Authorization: Bearer <token>' \
     --data '{
       "id": "f293e499-9188-4e01-8e7c-621038967b06",
       "pubkeys": [
      "0xffC08FcD7cFeF5c70fB2b0e1f2A8EaA690AaE2bDFfa5dBEc4dEef31DcC0B19eB1f9Cebe3E2fe9eefBD9a1BDF6FD89b39"
    ],
       "amountPerValidator": "10000000000",
       "withdrawalAddress": "0x338EF19fA2eC0fc4d1277B1307a613fA1FBbc0cb"
   }'
   
   • id — arbitrary UUID. You can later use that UUID to check the status of the top-up operation.
   • pubkeys — list of validators’ public keys.
   • amountPerValidator — amount of tokens to stake in Gwei per validator.
   • withdrawalAddress — withdrawal address for the validators.
   Example response:
   JSON

   {
     "error": null,
     "result": true
   }
   

​

2. Check request status

curl --request GET \
  --url https://api.p2p.org/api/v1/eth/staking/direct/increment-request/status/f293e499-9188-4e01-8e7c-621038967b06 \
  --header 'accept: application/json'
  --header 'Authorization: Bearer <token>'

{
    "error": null,
    "result": {
        "id": "f293e499-9188-4e01-8e7c-621038967b06",
        "status": "ready",
        "withdrawalAddress": "0x338EF19fA2eC0fc4d1277B1307a613fA1FBbc0cb",
        "amountPerValidator": "1000000000",
        "pubkeys": [
            "0xffC08FcD7cFeF5c70fB2b0e1f2A8EaA690AaE2bDFfa5dBEc4dEef31DcC0B19eB1f9Cebe3E2fe9eefBD9a1BDF6FD89b39"
        ],
        "depositData": [],
        "incrementTxs": [
            {
                "serializeTx": "0x02f901d983088bb0808404521e85847d276925839896809400000000219ab540356cbb839cbe05303d7705fa880de0b6b3a7640000b901a422895118000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120bd3d5b43a2f35b2c8ab809dcdaf619ab1a068d944e02359e5b6cd1eb5c69daea0000000000000000000000000000000000000000000000000000000000000030a3ee378399d9eb0aa126594965866e8785033005709e2816c3969963d99cdce11ee6b0ff3c6410aca6b1cb2e820b28420000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200200000000000000000000005419e9924ecd177418639cdce74cc3929c1472e80000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000c0",
                "to": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
                "gasLimit": "10000000",
                "data": "0x22895118000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000120bd3d5b43a2f35b2c8ab809dcdaf619ab1a068d944e02359e5b6cd1eb5c69daea0000000000000000000000000000000000000000000000000000000000000030a3ee378399d9eb0aa126594965866e8785033005709e2816c3969963d99cdce11ee6b0ff3c6410aca6b1cb2e820b28420000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200200000000000000000000005419e9924ecd177418639cdce74cc3929c1472e80000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
                "value": "1000000000000000000",
                "chainId": 560048,
                "type": 2,
                "maxFeePerGas": "2099734821",
                "maxPriorityFeePerGas": "72490629"
            }
        ],
        "createdAt": "2023-08-24T08:14:50.455Z"
    }
}

• id — arbitrary UUID of the top-up request.
• status — current status of the top-up request:
  • init — request is created.
  • processing — request is in progress.
  • ready — backend has the deposit data for the top-up request.
  • cancel — something went wrong, and the deposit data was not created.
• withdrawalAddress — withdrawal address for the validators.
• pubkeys — list of validators’ public keys.
• amountPerValidator — amount of tokens to stake in Gwei per validator.
• depositData for each validator:
  • pubkey — validator public key.
  • signature — validator signature.
  • depositDataRoot — SHA-256 hash of the SSZ-encoded depositData object. Used as a protection against malformed input.
  • withdrawalCredentials— withdrawal address credentials, passed in the expected format by the Ethereum deposit smart contract.
  • amount — amount of ETH, denominated in Gwei, that is being deposited.
  • depositMessageRoot — cryptographic hash of the Merkle tree’s root, ensuring the integrity and authenticity of the deposit data.
  • forkVersion — version of the network fork that the deposit is intended for. It helps in aligning the deposit with a specific version of the protocol.
  • eth2NetworkName — name of the Ethereum 2.0 network where the deposit is made.
  • depositCliVersion — version of the deposit command-line interface (CLI) tool that was used to generate the deposit data.
• incrementTxs — list of serialized transaction payloads to increment the validator stake.
  • serializeTx — serialized unsigned transaction.
  • to — recipient address for this transaction.
  • gasLimit — maximum gas limit for this block.
  • data — transaction data.
  • value — amount this transaction is sending in Wei.
  • chainId — chain ID this transaction is authorized on, as specified by EIP-155.
  • type — EIP-2718 type of this transaction envelope.
  • maxFeePerGas — maximum price per unit of gas this transaction will pay for the combined EIP-1559 block’s base fee and this transaction’s priority fee in Wei.
  • maxPriorityFeePerGas — price per unit of gas in Wei, which is added to the EIP-1559 block’s base fee. This added fee is used to incentivize miners to prioritize this transaction.
• createdAt — timestamp of the transaction in the ISO 8601 format.

​

3. Sign and broadcast transaction