engine_forkchoiceUpdatedV1
Updates the forkchoice state
Params
(2)1. Forkchoice state (required)
headBlockHash
stringMatch pattern:
^0x[0-9a-f]{64}$
safeBlockHash
stringMatch pattern:
^0x[0-9a-f]{64}$
finalizedBlockHash
stringMatch pattern:
^0x[0-9a-f]{64}$
2. Payload attributes
timestamp
stringMatch pattern:
^0x([1-9a-f]+[0-9a-f]{0,15})|0$
prevRandao
stringMatch pattern:
^0x[0-9a-f]{64}$
suggestedFeeRecipient
stringMatch pattern:
^0x[0-9,a-f,A-F]{40}$
Result
(Response object)payloadStatus
Payload statusstatus
stringSet of possible values is restricted to VALID, INVALID, SYNCING
Allowed values:
VALIDINVALIDSYNCING
latestValidHash
stringMatch pattern:
^0x[0-9a-f]{64}$
validationError
stringpayloadId
stringMatch pattern:
^0x[0-9a-f]{16}$
Errors
Code | Message |
---|---|
-38002 | Invalid forkchoice state |
-38003 | Invalid payload attributes |