Generate validator consolidation intent
Changed onGenerates a signed intent message to consolidate validator balances by transferring funds from a source validator to a target validator. This operation enables balance consolidation and can also upgrade withdrawal credentials from Type 1 (0x01) to Type 2 (0x02).
Consolidation Types:
- Type 1 to Type 2: Upgrades a validator from regular withdrawals (0x01) to compounding (0x02)
- Type 1 to Type 2: Consolidates funds from a Type 1 validator to an existing Type 2 validator
- Type 2 to Type 2: Consolidates funds between two Type 2 (compounding) validators
Key Notes:
- Upgrading from Type 1 to Type 2 is permanent and irreversible.
- After Type 2 upgrade:
- Max effective balance (MaxEB) increases to 2048 ETH.
- Partial withdrawals become available for balances above 32 ETH.
- Processing may take several days to complete across consensus and execution layers.
- Consolidation transfers the entire balance from source to target validator.
Prerequisites:
- Source validator must be active or eligible.
- Target validator must be active and valid.
- Source validator must not already use Type 2 withdrawal credentials (for Type 1 to Type 2 upgrades).
- No conflicting pending operations (e.g., exits, withdrawals).
Costs & Timing:
- Consolidation requires on-chain transaction; gas fees apply and execution may take hours or days.
Request
- Base URLhttps://svc.blockdaemon.com/boss
- URLhttps://svc.blockdaemon.com/boss/v1/ethereum/{network}/consolidation-intents
- AuthAPI key in header X-API-KEY
Request body
Example request
{
"source_validator": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c",
"target_validator": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c"
}Response
Intent created successfully
Example response
{
"customer_id": "SatoshiNakamoto-xUYJbPw9hw",
"ethereum": {
"source_validator": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c",
"target_validator": "0xa1d1ad0714035353258038e964ae9675dc0252ee22cea896825c01458e1807bfad2f9969338798548d9858a571f7425c",
"contract_address": "0x00000000219ab540356cBB839Cbe05303d7705Fa",
"unsigned_data": "0x91eb7c6836583b3f019eeffd4d0663a996d75f61f93567bd38fa36a78e2f57eb9ba338cbb338a55ccf94171cc9895c400000032000000000"
}
}Changes
- breaking
the
response's property type changed fromstringtointeger, and format from no format toint32for status - breaking
the
response's property type changed fromstringtointeger, and format from no format toint32for status - breaking
the
response's property type changed fromstringtointeger, and format from no format toint32for 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
- breaking