From a4808362416028f204e367bac5e8917d2d1cf0e7 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Mon, 30 Oct 2023 14:55:20 -0600 Subject: [PATCH 1/5] update git submodule --- .gitmodules | 2 +- beacon-apis | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.gitmodules b/.gitmodules index 81aceec..6c65ba1 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,3 +1,3 @@ [submodule "beacon-apis"] path = beacon-apis - url = git@github.com:ethereum/beacon-APIs.git + url = https://github.com/ethereum/beacon-apis diff --git a/beacon-apis b/beacon-apis index ea56687..197ecff 160000 --- a/beacon-apis +++ b/beacon-apis @@ -1 +1 @@ -Subproject commit ea5668708f2c6717fd2934c9a0b82b6705818a2e +Subproject commit 197ecffae2b813d94797184ae50387589c601fe7 From cee0d5f280411889a00e0e1c85bdb29367db3046 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Mon, 30 Oct 2023 14:50:29 -0600 Subject: [PATCH 2/5] updates to drop blinded blobs --- apis/builder/blinded_blocks.yaml | 9 +- apis/builder/header.yaml | 2 + builder-oapi.yaml | 9 +- .../execution_payload_and_blobs_bundle.json | 16 +- .../deneb/signed_blinded_beacon_block.json | 195 ++++++++++++++++ .../deneb/signed_blinded_block_contents.json | 212 ------------------ examples/deneb/signed_builder_bid.json | 12 +- specs/deneb/builder.md | 64 ++---- types/deneb/bid.yaml | 10 +- types/deneb/blobs_bundle.yaml | 14 -- 10 files changed, 248 insertions(+), 295 deletions(-) create mode 100644 examples/deneb/signed_blinded_beacon_block.json delete mode 100644 examples/deneb/signed_blinded_block_contents.json diff --git a/apis/builder/blinded_blocks.yaml b/apis/builder/blinded_blocks.yaml index d355353..1ab2779 100644 --- a/apis/builder/blinded_blocks.yaml +++ b/apis/builder/blinded_blocks.yaml @@ -10,8 +10,7 @@ post: must return an error response (400) with a description of the validation failure. - After Deneb, this endpoint will additionally accept `SignedBlindedBlobSidecars`, and return - with additional unblinded blobs in response. + After Deneb, this endpoint will additionally return the associated blobs in the response. tags: - Builder parameters: @@ -22,7 +21,7 @@ post: name: Eth-Consensus-Version description: "Version of the block being submitted" requestBody: - description: A `SignedBlindedBeaconBlock` before Deneb, or `SignedBlindedBlockContents` after Deneb. + description: A `SignedBlindedBeaconBlock`. required: true content: application/json: @@ -30,14 +29,14 @@ post: oneOf: - $ref: "../../builder-oapi.yaml#/components/schemas/Bellatrix.SignedBlindedBeaconBlock" - $ref: "../../builder-oapi.yaml#/components/schemas/Capella.SignedBlindedBeaconBlock" - - $ref: "../../builder-oapi.yaml#/components/schemas/Deneb.SignedBlindedBlockContents" + - $ref: "../../builder-oapi.yaml#/components/schemas/Deneb.SignedBlindedBeaconBlock" examples: bellatrix: $ref: "../../builder-oapi.yaml#/components/examples/Bellatrix.SignedBlindedBeaconBlock" capella: $ref: "../../builder-oapi.yaml#/components/examples/Capella.SignedBlindedBeaconBlock" deneb: - $ref: "../../builder-oapi.yaml#/components/examples/Deneb.SignedBlindedBlockContents" + $ref: "../../builder-oapi.yaml#/components/examples/Deneb.SignedBlindedBeaconBlock" responses: "200": diff --git a/apis/builder/header.yaml b/apis/builder/header.yaml index 1fd0c42..2411dc8 100644 --- a/apis/builder/header.yaml +++ b/apis/builder/header.yaml @@ -9,6 +9,8 @@ get: the builder MUST return a 204 response. If the request is invalid, then the builder MUST return an error response (400) with a description of the validation failure. + + After Deneb, return the KZG commitments for any associated blobs attached to the execution payload. tags: - Builder parameters: diff --git a/builder-oapi.yaml b/builder-oapi.yaml index af72fc3..21d46e3 100644 --- a/builder-oapi.yaml +++ b/builder-oapi.yaml @@ -69,8 +69,8 @@ components: $ref: "./beacon-apis/types/capella/block.yaml#/Capella/SignedBlindedBeaconBlock" Capella.SignedBuilderBid: $ref: "./types/capella/bid.yaml#/Capella/SignedBuilderBid" - Deneb.SignedBlindedBlockContents: - $ref: "./beacon-apis/types/deneb/block_contents.yaml#/Deneb/SignedBlindedBlockContents" + Deneb.SignedBlindedBeaconBlock: + $ref: "./beacon-apis/types/deneb/block.yaml#/Deneb/SignedBlindedBeaconBlock" Deneb.SignedBuilderBid: $ref: "./types/deneb/bid.yaml#/Deneb/SignedBuilderBid" Deneb.ExecutionPayloadAndBlobsBundle: @@ -95,10 +95,9 @@ components: $ref: "./examples/capella/execution_payload.json" Capella.SignedBuilderBid: $ref: "./examples/capella/signed_builder_bid.json" - Deneb.SignedBlindedBlockContents: - $ref: "./examples/deneb/signed_blinded_block_contents.json" + Deneb.SignedBlindedBeaconBlock: + $ref: "./examples/deneb/signed_blinded_beacon_block.json" Deneb.ExecutionPayloadAndBlobsBundle: $ref: "./examples/deneb/execution_payload_and_blobs_bundle.json" Deneb.SignedBuilderBid: $ref: "./examples/deneb/signed_builder_bid.json" - diff --git a/examples/deneb/execution_payload_and_blobs_bundle.json b/examples/deneb/execution_payload_and_blobs_bundle.json index 095bab6..d3ab864 100644 --- a/examples/deneb/execution_payload_and_blobs_bundle.json +++ b/examples/deneb/execution_payload_and_blobs_bundle.json @@ -15,7 +15,7 @@ "timestamp": "1", "extra_data": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "base_fee_per_gas": "1", - "blob_gas_used" : "1", + "blob_gas_used": "1", "excess_blob_gas": "1", "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "transactions": [ @@ -31,10 +31,16 @@ ] }, "blobs_bundle": { - "commitments": ["0x8dab030c51e16e84be9caab84ee3d0b8bbec1db4a0e4de76439da8424d9b957370a10a78851f97e4b54d2ce1ab0d686f"], - "proofs": ["0xb4021b0de10f743893d4f71e1bf830c019e832958efd6795baf2f83b8699a9eccc5dc99015d8d4d8ec370d0cc333c06a"], - "blobs": ["0x24564723180fcb3d994104538d351c8dcbde12d541676bb736cf678018ca4739"] + "commitments": [ + "0x8dab030c51e16e84be9caab84ee3d0b8bbec1db4a0e4de76439da8424d9b957370a10a78851f97e4b54d2ce1ab0d686f" + ], + "proofs": [ + "0xb4021b0de10f743893d4f71e1bf830c019e832958efd6795baf2f83b8699a9eccc5dc99015d8d4d8ec370d0cc333c06a" + ], + "blobs": [ + "0x24564723180fcb3d994104538d351c8dcbde12d541676bb736cf678018ca4739" + ] } } } -} \ No newline at end of file +} diff --git a/examples/deneb/signed_blinded_beacon_block.json b/examples/deneb/signed_blinded_beacon_block.json new file mode 100644 index 0000000..8a68a96 --- /dev/null +++ b/examples/deneb/signed_blinded_beacon_block.json @@ -0,0 +1,195 @@ +{ + "value": { + "message": { + "slot": "1", + "proposer_index": "1", + "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "body": { + "randao_reveal": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", + "eth1_data": { + "deposit_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "deposit_count": "1", + "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "graffiti": "0xdeadbeefc0ffeedeadbeefc0ffeedeadbeefc0ffeedeadbeefc0ffeedeadbeef", + "proposer_slashings": [ + { + "signed_header_1": { + "message": { + "slot": "1", + "proposer_index": "1", + "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "body_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + }, + "signed_header_2": { + "message": { + "slot": "1", + "proposer_index": "1", + "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "body_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + } + } + ], + "attester_slashings": [ + { + "attestation_1": { + "attesting_indices": [ + "1" + ], + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", + "data": { + "slot": "1", + "index": "1", + "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "source": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "target": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + } + } + }, + "attestation_2": { + "attesting_indices": [ + "1" + ], + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", + "data": { + "slot": "1", + "index": "1", + "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "source": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "target": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + } + } + } + } + ], + "attestations": [ + { + "aggregation_bits": "0x01", + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", + "data": { + "slot": "1", + "index": "1", + "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "source": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "target": { + "epoch": "1", + "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + } + } + } + ], + "deposits": [ + { + "proof": [ + "0xeeffb6c21a01d3abf09cd6c56e5d48f5ea0fc3bb0de906e3beea3e73776329cb", + "0x601c3b24a99d023224d50811bed19449890febb719a31d09ac414c4632f3c0ba", + "0xbb5e485e0a366e16510de33731d71204ad2fe0f7c600861fc2ac4685212c34e3", + "0x0006964745296a3e6ebf3954a1541e73205f1eefaddfc48ca9dc856bf159bca2", + "0x2c6020f1f9712b89f59550aec05b7c23cb1b113762399c0ca5b8fdd2fa85ce57", + "0x1c15634783e1d9d2cb969da66fd72cafca5026191d911b83211318d183c5ea59", + "0xdfbdf99a1fde57899df1545be1f91bc8a8a9f46c4bac619e28e92aff276de41f", + "0xfe9b0f0c05fde6bd26ce63d394058844ad4451f70b6d2547f49c5c2a5c7891a1", + "0x165f84ee467d18dbafdb07275dc42fb988ab696b0a7ad94c52f4d7a27144b994", + "0x506d86582d252405b840018792cad2bf1259f1ef5aa5f887e13cb2f0094f51e1", + "0xecdbe5e5056b968aa726a08f1aa33f5d41540eed42f59ace020431cf38a5144e", + "0xc4498c5eb1feeb0b225a3f332bdf523dbc013a5b336a851fce1c055b4019a457", + "0xb7d05f875f140027ef5118a2247bbb84ce8f2f0f1123623085daf7960c329f5f", + "0x8a9b66ad79116c9fc6eed14bde76e8f486669e59b0b5bb0c60a6b3caea38b83d", + "0x267c5455e4806b5d0ad5573552d0162e0983595bac25dacd9078174a2766643a", + "0x27e0c6357985de4d6026d6da14f31e8bfe14524056fec69dc06d6f8a239344af", + "0xf8455aebc24849bea870fbcef1235e2d27c8fd27db24e26d30d0173f3b207874", + "0xaba01bf7fe57be4373f47ff8ea6adc4348fab087b69b2518ce630820f95f4150", + "0xd47152335d9460f2b6fb7aba05ced32a52e9f46659ccd3daa2059661d75a6308", + "0xf893e908917775b62bff23294dbbe3a1cd8e6cc1c35b4801887b646a6f81f17f", + "0xcddba7b592e3133393c16194fac7431abf2f5485ed711db282183c819e08ebaa", + "0x8a8d7fe3af8caa085a7639a832001457dfb9128a8061142ad0335629ff23ff9c", + "0xfeb3c337d7a51a6fbf00b9e34c52e1c9195c969bd4e7a0bfd51d5c5bed9c1167", + "0xe71f0aa83cc32edfbefa9f4d3e0174ca85182eec9f3a09f6a6c0df6377a510d7", + "0x31206fa80a50bb6abe29085058f16212212a60eec8f049fecb92d8c8e0a84bc0", + "0x21352bfecbeddde993839f614c3dac0a3ee37543f9b412b16199dc158e23b544", + "0x619e312724bb6d7c3153ed9de791d764a366b389af13c58bf8a8d90481a46765", + "0x7cdd2986268250628d0c10e385c58c6191e6fbe05191bcc04f133f2cea72c1c4", + "0x848930bd7ba8cac54661072113fb278869e07bb8587f91392933374d017bcbe1", + "0x8869ff2c22b28cc10510d9853292803328be4fb0e80495e8bb8d271f5b889636", + "0xb5fe28e79f1b850f8658246ce9b6a1e7b49fc06db7143e8fe0b4f2b0c5523a5c", + "0x985e929f70af28d0bdd1a90a808f977f597c7c778c489e98d3bd8910d31ac0f7", + "0xf7ed070000000000000000000000000000000000000000000000000000000000" + ], + "data": { + "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a", + "withdrawal_credentials": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "amount": "1", + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + } + } + ], + "voluntary_exits": [ + { + "message": { + "epoch": "1", + "validator_index": "1" + }, + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + } + ], + "sync_aggregate": { + "sync_committee_bits": "0x01", + "sync_committee_signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + }, + "execution_payload_header": { + "parent_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "fee_recipient": "0xabcf8e0d4e9587369b2301d0790347320302cc09", + "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "receipts_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "logs_bloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", + "prev_randao": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "block_number": "1", + "gas_limit": "1", + "gas_used": "1", + "timestamp": "1", + "extra_data": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "base_fee_per_gas": "1", + "blob_gas_used": "1", + "excess_blob_gas": "1", + "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "transactions_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", + "withdrawals_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" + }, + "bls_to_execution_changes": [ + { + "message": { + "validator_index": "1", + "from_bls_pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a", + "to_execution_address": "0xabcf8e0d4e9587369b2301d0790347320302cc09" + }, + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + } + ], + "blob_kzg_commitments": [ + "0xa94170080872584e54a1cf092d845703b13907f2e6b3b1c0ad573b910530499e3bcd48c6378846b80d2bfa58c81cf3d5" + ] + } + }, + "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" + } +} diff --git a/examples/deneb/signed_blinded_block_contents.json b/examples/deneb/signed_blinded_block_contents.json deleted file mode 100644 index cefbd04..0000000 --- a/examples/deneb/signed_blinded_block_contents.json +++ /dev/null @@ -1,212 +0,0 @@ -{ - "value": { - "signed_blinded_block": { - "message": { - "slot": "1", - "proposer_index": "1", - "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "body": { - "randao_reveal": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", - "eth1_data": { - "deposit_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "deposit_count": "1", - "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "graffiti": "0xdeadbeefc0ffeedeadbeefc0ffeedeadbeefc0ffeedeadbeefc0ffeedeadbeef", - "proposer_slashings": [ - { - "signed_header_1": { - "message": { - "slot": "1", - "proposer_index": "1", - "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "body_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - }, - "signed_header_2": { - "message": { - "slot": "1", - "proposer_index": "1", - "parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "body_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - } - } - ], - "attester_slashings": [ - { - "attestation_1": { - "attesting_indices": [ - "1" - ], - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", - "data": { - "slot": "1", - "index": "1", - "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "source": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "target": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - } - } - }, - "attestation_2": { - "attesting_indices": [ - "1" - ], - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", - "data": { - "slot": "1", - "index": "1", - "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "source": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "target": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - } - } - } - } - ], - "attestations": [ - { - "aggregation_bits": "0x01", - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505", - "data": { - "slot": "1", - "index": "1", - "beacon_block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "source": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "target": { - "epoch": "1", - "root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - } - } - } - ], - "deposits": [ - { - "proof": [ - "0xeeffb6c21a01d3abf09cd6c56e5d48f5ea0fc3bb0de906e3beea3e73776329cb", - "0x601c3b24a99d023224d50811bed19449890febb719a31d09ac414c4632f3c0ba", - "0xbb5e485e0a366e16510de33731d71204ad2fe0f7c600861fc2ac4685212c34e3", - "0x0006964745296a3e6ebf3954a1541e73205f1eefaddfc48ca9dc856bf159bca2", - "0x2c6020f1f9712b89f59550aec05b7c23cb1b113762399c0ca5b8fdd2fa85ce57", - "0x1c15634783e1d9d2cb969da66fd72cafca5026191d911b83211318d183c5ea59", - "0xdfbdf99a1fde57899df1545be1f91bc8a8a9f46c4bac619e28e92aff276de41f", - "0xfe9b0f0c05fde6bd26ce63d394058844ad4451f70b6d2547f49c5c2a5c7891a1", - "0x165f84ee467d18dbafdb07275dc42fb988ab696b0a7ad94c52f4d7a27144b994", - "0x506d86582d252405b840018792cad2bf1259f1ef5aa5f887e13cb2f0094f51e1", - "0xecdbe5e5056b968aa726a08f1aa33f5d41540eed42f59ace020431cf38a5144e", - "0xc4498c5eb1feeb0b225a3f332bdf523dbc013a5b336a851fce1c055b4019a457", - "0xb7d05f875f140027ef5118a2247bbb84ce8f2f0f1123623085daf7960c329f5f", - "0x8a9b66ad79116c9fc6eed14bde76e8f486669e59b0b5bb0c60a6b3caea38b83d", - "0x267c5455e4806b5d0ad5573552d0162e0983595bac25dacd9078174a2766643a", - "0x27e0c6357985de4d6026d6da14f31e8bfe14524056fec69dc06d6f8a239344af", - "0xf8455aebc24849bea870fbcef1235e2d27c8fd27db24e26d30d0173f3b207874", - "0xaba01bf7fe57be4373f47ff8ea6adc4348fab087b69b2518ce630820f95f4150", - "0xd47152335d9460f2b6fb7aba05ced32a52e9f46659ccd3daa2059661d75a6308", - "0xf893e908917775b62bff23294dbbe3a1cd8e6cc1c35b4801887b646a6f81f17f", - "0xcddba7b592e3133393c16194fac7431abf2f5485ed711db282183c819e08ebaa", - "0x8a8d7fe3af8caa085a7639a832001457dfb9128a8061142ad0335629ff23ff9c", - "0xfeb3c337d7a51a6fbf00b9e34c52e1c9195c969bd4e7a0bfd51d5c5bed9c1167", - "0xe71f0aa83cc32edfbefa9f4d3e0174ca85182eec9f3a09f6a6c0df6377a510d7", - "0x31206fa80a50bb6abe29085058f16212212a60eec8f049fecb92d8c8e0a84bc0", - "0x21352bfecbeddde993839f614c3dac0a3ee37543f9b412b16199dc158e23b544", - "0x619e312724bb6d7c3153ed9de791d764a366b389af13c58bf8a8d90481a46765", - "0x7cdd2986268250628d0c10e385c58c6191e6fbe05191bcc04f133f2cea72c1c4", - "0x848930bd7ba8cac54661072113fb278869e07bb8587f91392933374d017bcbe1", - "0x8869ff2c22b28cc10510d9853292803328be4fb0e80495e8bb8d271f5b889636", - "0xb5fe28e79f1b850f8658246ce9b6a1e7b49fc06db7143e8fe0b4f2b0c5523a5c", - "0x985e929f70af28d0bdd1a90a808f977f597c7c778c489e98d3bd8910d31ac0f7", - "0xf7ed070000000000000000000000000000000000000000000000000000000000" - ], - "data": { - "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a", - "withdrawal_credentials": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "amount": "1", - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - } - } - ], - "voluntary_exits": [ - { - "message": { - "epoch": "1", - "validator_index": "1" - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - } - ], - "sync_aggregate": { - "sync_committee_bits": "0x01", - "sync_committee_signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - }, - "execution_payload_header": { - "parent_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "fee_recipient": "0xabcf8e0d4e9587369b2301d0790347320302cc09", - "state_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "receipts_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "logs_bloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000", - "prev_randao": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "block_number": "1", - "gas_limit": "1", - "gas_used": "1", - "timestamp": "1", - "extra_data": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "base_fee_per_gas": "1", - "blob_gas_used" : "1", - "excess_blob_gas": "1", - "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "transactions_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "withdrawals_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" - }, - "bls_to_execution_changes": [ - { - "message": { - "validator_index": "1", - "from_bls_pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a", - "to_execution_address": "0xabcf8e0d4e9587369b2301d0790347320302cc09" - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - } - ], - "blob_kzg_commitments": [ - "0xa94170080872584e54a1cf092d845703b13907f2e6b3b1c0ad573b910530499e3bcd48c6378846b80d2bfa58c81cf3d5" - ] - } - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - }, - "signed_blinded_blob_sidecars": [ - { - "message": { - "block_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "index": "0", - "slot": "1", - "block_parent_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", - "proposer_index": "1", - "blob_root": "0x24564723180fcb3d994104538d351c8dcbde12d541676bb736cf678018ca4739", - "kzg_commitment": "0x8dab030c51e16e84be9caab84ee3d0b8bbec1db4a0e4de76439da8424d9b957370a10a78851f97e4b54d2ce1ab0d686f", - "kzg_proof": "0xb4021b0de10f743893d4f71e1bf830c019e832958efd6795baf2f83b8699a9eccc5dc99015d8d4d8ec370d0cc333c06a" - }, - "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" - } - ] - } -} \ No newline at end of file diff --git a/examples/deneb/signed_builder_bid.json b/examples/deneb/signed_builder_bid.json index 3675e5e..7bb7957 100644 --- a/examples/deneb/signed_builder_bid.json +++ b/examples/deneb/signed_builder_bid.json @@ -16,21 +16,19 @@ "timestamp": "1", "extra_data": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "base_fee_per_gas": "1", - "blob_gas_used" : "1", + "blob_gas_used": "1", "excess_blob_gas": "1", "block_hash": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "transactions_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2", "withdrawals_root": "0xcf8e0d4e9587369b2301d0790347320302cc0943d5a1884560367e8208d920f2" }, - "blinded_blobs_bundle": { - "commitments": ["0x8dab030c51e16e84be9caab84ee3d0b8bbec1db4a0e4de76439da8424d9b957370a10a78851f97e4b54d2ce1ab0d686f"], - "proofs": ["0xb4021b0de10f743893d4f71e1bf830c019e832958efd6795baf2f83b8699a9eccc5dc99015d8d4d8ec370d0cc333c06a"], - "blob_roots": ["0x24564723180fcb3d994104538d351c8dcbde12d541676bb736cf678018ca4739"] - }, + "blob_kzg_commitments": [ + "0xa94170080872584e54a1cf092d845703b13907f2e6b3b1c0ad573b910530499e3bcd48c6378846b80d2bfa58c81cf3d5" + ], "value": "1", "pubkey": "0x93247f2209abcacf57b75a51dafae777f9dd38bc7053d1af526f220a7489a6d3a2753e5f3e8b1cfe39b56f43611df74a" }, "signature": "0x1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505cc411d61252fb6cb3fa0017b679f8bb2305b26a285fa2737f175668d0dff91cc1b66ac1fb663c9bc59509846d6ec05345bd908eda73e670af888da41af171505" } } -} \ No newline at end of file +} diff --git a/specs/deneb/builder.md b/specs/deneb/builder.md index 11a27cf..5b45ee7 100644 --- a/specs/deneb/builder.md +++ b/specs/deneb/builder.md @@ -8,10 +8,6 @@ - [Introduction](#introduction) - [Containers](#containers) - [New containers](#new-containers) - - [`BlindedBlobsBundle`](#blindedblobsbundle) - - [`BlindedBlobSidecar`](#blindedblobsidecar) - - [`SignedBlindedBlobSidecar`](#signedblindedblobsidecar) - - [`SignedBlindedBlockContents`](#signedblindedblockcontents) - [`BlobsBundle`](#blobsbundle) - [`ExecutionPayloadAndBlobsBundle`](#executionpayloadandblobsbundle) - [Extended containers](#extended-containers) @@ -29,45 +25,6 @@ This is the modification of the builder specification accompanying the Deneb upg ### New containers -#### `BlindedBlobsBundle` - -```python -class BlindedBlobsBundle(Container): - commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK] - proofs: List[KZGProof, MAX_BLOB_COMMITMENTS_PER_BLOCK] - blob_roots: List[Root, MAX_BLOB_COMMITMENTS_PER_BLOCK] -``` - -#### `BlindedBlobSidecar` - -```python -class BlindedBlobSidecar(Container): - block_root: Root - index: BlobIndex - slot: Slot - block_parent_root: Root - proposer_index: ValidatorIndex - blob_root: Root - kzg_commitment: KZGCommitment - kzg_proof: KZGProof -``` - -#### `SignedBlindedBlobSidecar` - -```python -class SignedBlindedBlobSidecar(Container): - message: BlindedBlobSidecar - signature: BLSSignature -``` - -#### `SignedBlindedBlockContents` - -```python -class SignedBlindedBlockContents(Container): - signed_blinded_block: SignedBlindedBeaconBlock - signed_blinded_blob_sidecars: List[SignedBlindedBlobSidecar, MAX_BLOBS_PER_BLOCK] -``` - #### `BlobsBundle` Same as [`BlobsBundle`](https://github.com/ethereum/consensus-specs/blob/dev/specs/deneb/validator.md#blobsbundle) in Deneb consensus specs. @@ -89,7 +46,7 @@ Note: `SignedBuilderBid` is updated indirectly. ```python class BuilderBid(Container): header: ExecutionPayloadHeader # [Modified in Deneb] - blinded_blobs_bundle: BlindedBlobsBundle # [New in Deneb] + blob_kzg_commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK] # [New in Deneb] value: uint256 pubkey: BLSPubkey ``` @@ -117,3 +74,22 @@ class BlindedBeaconBlockBody(Container): bls_to_execution_changes: List[SignedBLSToExecutionChange, MAX_BLS_TO_EXECUTION_CHANGES] blob_kzg_commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK] # [New in Deneb] ``` + +## Building + +Builders provide bids as the have in prior forks. + +Relays have a few additional duties. + +### Bidding + +After a relay has verified the execution payload (including any blobs) is correctly constructed, the relay **MUST** additionally return any `KZGCommitments` for those blobs +in the `SignedBuilderBid`. + +### Revealing the `ExecutionPayload` + +#### Blinded block processing + +Relays verify signed blinded beacon blocks as before, with the additional requirement +that they must construct `SignedBlobSidecar` objects with the KZG commitment inclusion +proof before gossiping the blobs alongside the unblinded block. diff --git a/types/deneb/bid.yaml b/types/deneb/bid.yaml index 87d1d57..9315ef1 100644 --- a/types/deneb/bid.yaml +++ b/types/deneb/bid.yaml @@ -7,9 +7,13 @@ Deneb: header: $ref: "../../beacon-apis/types/deneb/execution_payload.yaml#/Deneb/ExecutionPayloadHeader" description: "`ExecutionPayloadHeader` to use in block proposal." - blinded_blobs_bundle: - $ref: "./blobs_bundle.yaml#/Deneb/BlindedBlobsBundle" - description: "`BlindedBlobsBundle` to use in block proposal." + blob_kzg_commitments: + type: array + items: + $ref: '../../beacon-apis/types/primitive.yaml#/KZGCommitment' + minItems: 0 + maxItems: 6 + description: "the `KZGCommitment`s for the associated blobs for this `header`" - $ref: '../bellatrix/bid.yaml#/Bellatrix/BuilderBidCommon' SignedBuilderBid: diff --git a/types/deneb/blobs_bundle.yaml b/types/deneb/blobs_bundle.yaml index 2752db8..152665a 100644 --- a/types/deneb/blobs_bundle.yaml +++ b/types/deneb/blobs_bundle.yaml @@ -15,20 +15,6 @@ Deneb: minItems: 0 maxItems: 6 - BlindedBlobsBundle: - allOf: - - $ref: '#/Deneb/BlobsBundleCommon' - type: object - description: "A blobs container with the SSZ root of the blobs rather than the full blobs." - properties: - blob_roots: - type: array - items: - $ref: "../../beacon-apis/types/primitive.yaml#/Root" - minItems: 0 - maxItems: 6 - - BlobsBundle: allOf: - $ref: '#/Deneb/BlobsBundleCommon' From 9a2c1865628e54565b37e9d526d069faf6c65253 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Sun, 5 Nov 2023 13:14:02 -0700 Subject: [PATCH 3/5] use "fully SSZ" `BlobsBundle` defn to support SSZ transport --- specs/deneb/builder.md | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/specs/deneb/builder.md b/specs/deneb/builder.md index 5b45ee7..38e606a 100644 --- a/specs/deneb/builder.md +++ b/specs/deneb/builder.md @@ -27,7 +27,12 @@ This is the modification of the builder specification accompanying the Deneb upg #### `BlobsBundle` -Same as [`BlobsBundle`](https://github.com/ethereum/consensus-specs/blob/dev/specs/deneb/validator.md#blobsbundle) in Deneb consensus specs. +```python +class BlobsBundle(container): + commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK] + proofs: List[KZGProof, MAX_BLOB_COMMITMENTS_PER_BLOCK] + blobs: List[Blob, MAX_BLOB_COMMITMENTS_PER_BLOCK] +``` #### `ExecutionPayloadAndBlobsBundle` From 0534b9cb5faaff15ec0a3c0a7765ad53d21977ce Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Mon, 6 Nov 2023 07:51:44 -0700 Subject: [PATCH 4/5] drop unneeded type `BlobsBundleCommon` --- types/deneb/blobs_bundle.yaml | 22 ++++++++-------------- 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/types/deneb/blobs_bundle.yaml b/types/deneb/blobs_bundle.yaml index 152665a..2804db3 100644 --- a/types/deneb/blobs_bundle.yaml +++ b/types/deneb/blobs_bundle.yaml @@ -1,29 +1,23 @@ Deneb: - BlobsBundleCommon: + BlobsBundle: type: object + description: "The `BlobsBundle` object from the CL Deneb spec" properties: - commitments: + blobs: type: array items: - $ref: '../../beacon-apis/types/primitive.yaml#/KZGCommitment' + $ref: "../../beacon-apis/types/primitive.yaml#/Blob" minItems: 0 maxItems: 6 - proofs: + commitments: type: array items: - $ref: '../../beacon-apis/types/primitive.yaml#/KZGProof' + $ref: '../../beacon-apis/types/primitive.yaml#/KZGCommitment' minItems: 0 maxItems: 6 - - BlobsBundle: - allOf: - - $ref: '#/Deneb/BlobsBundleCommon' - type: object - description: "The `BlobsBundle` object from the CL Deneb spec" - properties: - blobs: + proofs: type: array items: - $ref: "../../beacon-apis/types/primitive.yaml#/Blob" + $ref: '../../beacon-apis/types/primitive.yaml#/KZGProof' minItems: 0 maxItems: 6 From 1d07b236159a27d59c9c952a4043c1b7db332bb1 Mon Sep 17 00:00:00 2001 From: Alex Stokes Date: Wed, 8 Nov 2023 15:03:06 +0100 Subject: [PATCH 5/5] updates --- specs/deneb/builder.md | 2 +- types/deneb/bid.yaml | 2 +- types/deneb/blobs_bundle.yaml | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/specs/deneb/builder.md b/specs/deneb/builder.md index 38e606a..488e884 100644 --- a/specs/deneb/builder.md +++ b/specs/deneb/builder.md @@ -28,7 +28,7 @@ This is the modification of the builder specification accompanying the Deneb upg #### `BlobsBundle` ```python -class BlobsBundle(container): +class BlobsBundle(Container): commitments: List[KZGCommitment, MAX_BLOB_COMMITMENTS_PER_BLOCK] proofs: List[KZGProof, MAX_BLOB_COMMITMENTS_PER_BLOCK] blobs: List[Blob, MAX_BLOB_COMMITMENTS_PER_BLOCK] diff --git a/types/deneb/bid.yaml b/types/deneb/bid.yaml index 9315ef1..f9ce13c 100644 --- a/types/deneb/bid.yaml +++ b/types/deneb/bid.yaml @@ -12,7 +12,7 @@ Deneb: items: $ref: '../../beacon-apis/types/primitive.yaml#/KZGCommitment' minItems: 0 - maxItems: 6 + maxItems: 4096 description: "the `KZGCommitment`s for the associated blobs for this `header`" - $ref: '../bellatrix/bid.yaml#/Bellatrix/BuilderBidCommon' diff --git a/types/deneb/blobs_bundle.yaml b/types/deneb/blobs_bundle.yaml index 2804db3..682449d 100644 --- a/types/deneb/blobs_bundle.yaml +++ b/types/deneb/blobs_bundle.yaml @@ -8,16 +8,16 @@ Deneb: items: $ref: "../../beacon-apis/types/primitive.yaml#/Blob" minItems: 0 - maxItems: 6 + maxItems: 4096 commitments: type: array items: $ref: '../../beacon-apis/types/primitive.yaml#/KZGCommitment' minItems: 0 - maxItems: 6 + maxItems: 4096 proofs: type: array items: $ref: '../../beacon-apis/types/primitive.yaml#/KZGProof' minItems: 0 - maxItems: 6 + maxItems: 4096