@lodestar/state-transition 1.43.0 → 1.44.0-dev.1d0e0b9081

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/lib/block/processDepositRequest.d.ts +3 -11
  2. package/lib/block/processDepositRequest.d.ts.map +1 -1
  3. package/lib/block/processDepositRequest.js +27 -35
  4. package/lib/block/processDepositRequest.js.map +1 -1
  5. package/lib/block/processParentExecutionPayload.d.ts.map +1 -1
  6. package/lib/block/processParentExecutionPayload.js +4 -3
  7. package/lib/block/processParentExecutionPayload.js.map +1 -1
  8. package/lib/lightClient/spec/index.d.ts +22 -0
  9. package/lib/lightClient/spec/index.d.ts.map +1 -0
  10. package/lib/lightClient/spec/index.js +58 -0
  11. package/lib/lightClient/spec/index.js.map +1 -0
  12. package/lib/lightClient/spec/isBetterUpdate.d.ts +23 -0
  13. package/lib/lightClient/spec/isBetterUpdate.d.ts.map +1 -0
  14. package/lib/lightClient/spec/isBetterUpdate.js +66 -0
  15. package/lib/lightClient/spec/isBetterUpdate.js.map +1 -0
  16. package/lib/lightClient/spec/processLightClientUpdate.d.ts +12 -0
  17. package/lib/lightClient/spec/processLightClientUpdate.d.ts.map +1 -0
  18. package/lib/lightClient/spec/processLightClientUpdate.js +80 -0
  19. package/lib/lightClient/spec/processLightClientUpdate.js.map +1 -0
  20. package/lib/lightClient/spec/store.d.ts +45 -0
  21. package/lib/lightClient/spec/store.d.ts.map +1 -0
  22. package/lib/lightClient/spec/store.js +56 -0
  23. package/lib/lightClient/spec/store.js.map +1 -0
  24. package/lib/lightClient/spec/utils.d.ts +47 -0
  25. package/lib/lightClient/spec/utils.d.ts.map +1 -0
  26. package/lib/lightClient/spec/utils.js +197 -0
  27. package/lib/lightClient/spec/utils.js.map +1 -0
  28. package/lib/lightClient/spec/validateLightClientBootstrap.d.ts +4 -0
  29. package/lib/lightClient/spec/validateLightClientBootstrap.d.ts.map +1 -0
  30. package/lib/lightClient/spec/validateLightClientBootstrap.js +22 -0
  31. package/lib/lightClient/spec/validateLightClientBootstrap.js.map +1 -0
  32. package/lib/lightClient/spec/validateLightClientUpdate.d.ts +5 -0
  33. package/lib/lightClient/spec/validateLightClientUpdate.d.ts.map +1 -0
  34. package/lib/lightClient/spec/validateLightClientUpdate.js +88 -0
  35. package/lib/lightClient/spec/validateLightClientUpdate.js.map +1 -0
  36. package/lib/slot/upgradeStateToGloas.d.ts.map +1 -1
  37. package/lib/slot/upgradeStateToGloas.js +35 -29
  38. package/lib/slot/upgradeStateToGloas.js.map +1 -1
  39. package/lib/stateView/beaconStateView.d.ts +8 -3
  40. package/lib/stateView/beaconStateView.d.ts.map +1 -1
  41. package/lib/stateView/beaconStateView.js +15 -4
  42. package/lib/stateView/beaconStateView.js.map +1 -1
  43. package/lib/stateView/interface.d.ts +1 -1
  44. package/lib/stateView/interface.d.ts.map +1 -1
  45. package/lib/util/index.d.ts +1 -0
  46. package/lib/util/index.d.ts.map +1 -1
  47. package/lib/util/index.js +1 -0
  48. package/lib/util/index.js.map +1 -1
  49. package/lib/util/pendingDepositsLookup.d.ts +40 -0
  50. package/lib/util/pendingDepositsLookup.d.ts.map +1 -0
  51. package/lib/util/pendingDepositsLookup.js +84 -0
  52. package/lib/util/pendingDepositsLookup.js.map +1 -0
  53. package/lib/util/shuffling.d.ts +6 -5
  54. package/lib/util/shuffling.d.ts.map +1 -1
  55. package/lib/util/shuffling.js +13 -15
  56. package/lib/util/shuffling.js.map +1 -1
  57. package/package.json +12 -7
  58. package/src/block/processDepositRequest.ts +29 -47
  59. package/src/block/processParentExecutionPayload.ts +4 -3
  60. package/src/lightClient/spec/index.ts +101 -0
  61. package/src/lightClient/spec/isBetterUpdate.ts +94 -0
  62. package/src/lightClient/spec/processLightClientUpdate.ts +119 -0
  63. package/src/lightClient/spec/store.ts +106 -0
  64. package/src/lightClient/spec/utils.ts +317 -0
  65. package/src/lightClient/spec/validateLightClientBootstrap.ts +39 -0
  66. package/src/lightClient/spec/validateLightClientUpdate.ts +145 -0
  67. package/src/slot/upgradeStateToGloas.ts +43 -45
  68. package/src/stateView/beaconStateView.ts +15 -4
  69. package/src/stateView/interface.ts +1 -1
  70. package/src/util/index.ts +1 -0
  71. package/src/util/pendingDepositsLookup.ts +105 -0
  72. package/src/util/shuffling.ts +17 -15
@@ -0,0 +1,317 @@
1
+ import {PublicKey} from "@chainsafe/blst";
2
+ import {BitArray} from "@chainsafe/ssz";
3
+ import {ChainForkConfig} from "@lodestar/config";
4
+ import {
5
+ BLOCK_BODY_EXECUTION_PAYLOAD_DEPTH as EXECUTION_PAYLOAD_DEPTH,
6
+ BLOCK_BODY_EXECUTION_PAYLOAD_INDEX as EXECUTION_PAYLOAD_INDEX,
7
+ FINALIZED_ROOT_DEPTH,
8
+ FINALIZED_ROOT_DEPTH_ELECTRA,
9
+ ForkName,
10
+ ForkSeq,
11
+ NEXT_SYNC_COMMITTEE_DEPTH,
12
+ NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA,
13
+ isForkPostElectra,
14
+ } from "@lodestar/params";
15
+ import {
16
+ BeaconBlockHeader,
17
+ LightClientFinalityUpdate,
18
+ LightClientHeader,
19
+ LightClientOptimisticUpdate,
20
+ LightClientUpdate,
21
+ Slot,
22
+ SyncCommittee,
23
+ isElectraLightClientUpdate,
24
+ ssz,
25
+ } from "@lodestar/types";
26
+ import {byteArrayEquals, verifyMerkleBranch} from "@lodestar/utils";
27
+ import {computeEpochAtSlot, computeSyncPeriodAtSlot} from "../../util/epoch.js";
28
+ import type {LightClientStore, SyncCommitteeFast} from "./store.js";
29
+
30
+ export const GENESIS_SLOT = 0;
31
+ export const ZERO_HASH = new Uint8Array(32);
32
+ export const ZERO_PUBKEY = new Uint8Array(48);
33
+ export const ZERO_SYNC_COMMITTEE = ssz.altair.SyncCommittee.defaultValue();
34
+ export const ZERO_HEADER = ssz.phase0.BeaconBlockHeader.defaultValue();
35
+ /** From https://notes.ethereum.org/@vbuterin/extended_light_client_protocol#Optimistic-head-determining-function */
36
+ const SAFETY_THRESHOLD_FACTOR = 2;
37
+
38
+ export function sumBits(bits: BitArray): number {
39
+ return bits.getTrueBitIndexes().length;
40
+ }
41
+
42
+ /**
43
+ * Util to guarantee that all bits have a corresponding pubkey.
44
+ */
45
+ export function getParticipantPubkeys<T>(pubkeys: T[], bits: BitArray): T[] {
46
+ // BitArray.intersectValues() checks the length is correct.
47
+ return bits.intersectValues(pubkeys);
48
+ }
49
+
50
+ function deserializePubkeys(pubkeys: SyncCommittee["pubkeys"]): PublicKey[] {
51
+ return pubkeys.map((pk) => PublicKey.fromBytes(pk, true));
52
+ }
53
+
54
+ function serializePubkeys(pubkeys: PublicKey[]): SyncCommittee["pubkeys"] {
55
+ return pubkeys.map((pk) => pk.toBytes());
56
+ }
57
+
58
+ export function deserializeSyncCommittee(syncCommittee: SyncCommittee): SyncCommitteeFast {
59
+ return {
60
+ pubkeys: deserializePubkeys(syncCommittee.pubkeys),
61
+ aggregatePubkey: PublicKey.fromBytes(syncCommittee.aggregatePubkey, true),
62
+ };
63
+ }
64
+
65
+ export function serializeSyncCommittee(syncCommittee: SyncCommitteeFast): SyncCommittee {
66
+ return {
67
+ pubkeys: serializePubkeys(syncCommittee.pubkeys),
68
+ aggregatePubkey: syncCommittee.aggregatePubkey.toBytes(),
69
+ };
70
+ }
71
+
72
+ export function getSafetyThreshold(maxActiveParticipants: number): number {
73
+ return Math.floor(maxActiveParticipants / SAFETY_THRESHOLD_FACTOR);
74
+ }
75
+
76
+ export function getZeroSyncCommitteeBranch(fork: ForkName): Uint8Array[] {
77
+ const nextSyncCommitteeDepth = isForkPostElectra(fork)
78
+ ? NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA
79
+ : NEXT_SYNC_COMMITTEE_DEPTH;
80
+
81
+ return Array.from({length: nextSyncCommitteeDepth}, () => ZERO_HASH);
82
+ }
83
+
84
+ export function getZeroFinalityBranch(fork: ForkName): Uint8Array[] {
85
+ const finalizedRootDepth = isForkPostElectra(fork) ? FINALIZED_ROOT_DEPTH_ELECTRA : FINALIZED_ROOT_DEPTH;
86
+
87
+ return Array.from({length: finalizedRootDepth}, () => ZERO_HASH);
88
+ }
89
+
90
+ export function isSyncCommitteeUpdate(update: LightClientUpdate): boolean {
91
+ return (
92
+ // Fast return for when constructing full LightClientUpdate from partial updates
93
+ update.nextSyncCommitteeBranch !==
94
+ getZeroSyncCommitteeBranch(isElectraLightClientUpdate(update) ? ForkName.electra : ForkName.altair) &&
95
+ update.nextSyncCommitteeBranch.some((branch) => !byteArrayEquals(branch, ZERO_HASH))
96
+ );
97
+ }
98
+
99
+ export function isFinalityUpdate(update: LightClientUpdate): boolean {
100
+ return (
101
+ // Fast return for when constructing full LightClientUpdate from partial updates
102
+ update.finalityBranch !==
103
+ getZeroFinalityBranch(isElectraLightClientUpdate(update) ? ForkName.electra : ForkName.altair) &&
104
+ update.finalityBranch.some((branch) => !byteArrayEquals(branch, ZERO_HASH))
105
+ );
106
+ }
107
+
108
+ export function isZeroedHeader(header: BeaconBlockHeader): boolean {
109
+ // Fast return for when constructing full LightClientUpdate from partial updates
110
+ return header === ZERO_HEADER || byteArrayEquals(header.bodyRoot, ZERO_HASH);
111
+ }
112
+
113
+ export function isZeroedSyncCommittee(syncCommittee: SyncCommittee): boolean {
114
+ // Fast return for when constructing full LightClientUpdate from partial updates
115
+ return syncCommittee === ZERO_SYNC_COMMITTEE || byteArrayEquals(syncCommittee.pubkeys[0], ZERO_PUBKEY);
116
+ }
117
+
118
+ export function isValidMerkleBranch(
119
+ leaf: Uint8Array,
120
+ branch: Uint8Array[],
121
+ depth: number,
122
+ index: number,
123
+ root: Uint8Array
124
+ ): boolean {
125
+ if (branch.length !== depth) {
126
+ return false;
127
+ }
128
+
129
+ return verifyMerkleBranch(leaf, branch, depth, index, root);
130
+ }
131
+
132
+ export function normalizeMerkleBranch(branch: Uint8Array[], depth: number): Uint8Array[] {
133
+ const numExtraDepth = depth - branch.length;
134
+
135
+ return [...Array.from({length: numExtraDepth}, () => ZERO_HASH), ...branch];
136
+ }
137
+
138
+ export function upgradeLightClientHeader(
139
+ config: ChainForkConfig,
140
+ targetFork: ForkName,
141
+ header: LightClientHeader
142
+ ): LightClientHeader {
143
+ const headerFork = config.getForkName(header.beacon.slot);
144
+ if (ForkSeq[headerFork] >= ForkSeq[targetFork]) {
145
+ throw Error(`Invalid upgrade request from headerFork=${headerFork} to targetFork=${targetFork}`);
146
+ }
147
+
148
+ // We are modifying the same header object, may be we could create a copy, but its
149
+ // not required as of now
150
+ const upgradedHeader = header;
151
+ const startUpgradeFromFork = Object.values(ForkName)[ForkSeq[headerFork] + 1];
152
+
153
+ switch (startUpgradeFromFork) {
154
+ // biome-ignore lint/suspicious/useDefaultSwitchClauseLast: We want default to evaluate at first to throw error early
155
+ default:
156
+ throw Error(
157
+ `Invalid startUpgradeFromFork=${startUpgradeFromFork} for headerFork=${headerFork} in upgradeLightClientHeader to targetFork=${targetFork}`
158
+ );
159
+
160
+ case ForkName.altair:
161
+ // biome-ignore lint/suspicious/noFallthroughSwitchClause: We need fall-through behavior here
162
+ case ForkName.bellatrix:
163
+ // Break if no further upgradation is required else fall through
164
+ if (ForkSeq[targetFork] <= ForkSeq.bellatrix) break;
165
+
166
+ // biome-ignore lint/suspicious/noFallthroughSwitchClause: We need fall-through behavior here
167
+ case ForkName.capella:
168
+ (upgradedHeader as LightClientHeader<ForkName.capella>).execution =
169
+ ssz.capella.LightClientHeader.fields.execution.defaultValue();
170
+ (upgradedHeader as LightClientHeader<ForkName.capella>).executionBranch =
171
+ ssz.capella.LightClientHeader.fields.executionBranch.defaultValue();
172
+
173
+ // Break if no further upgradation is required else fall through
174
+ if (ForkSeq[targetFork] <= ForkSeq.capella) break;
175
+
176
+ // biome-ignore lint/suspicious/noFallthroughSwitchClause: We need fall-through behavior here
177
+ case ForkName.deneb:
178
+ (upgradedHeader as LightClientHeader<ForkName.deneb>).execution.blobGasUsed =
179
+ ssz.deneb.LightClientHeader.fields.execution.fields.blobGasUsed.defaultValue();
180
+ (upgradedHeader as LightClientHeader<ForkName.deneb>).execution.excessBlobGas =
181
+ ssz.deneb.LightClientHeader.fields.execution.fields.excessBlobGas.defaultValue();
182
+
183
+ // Break if no further upgradation is required else fall through
184
+ if (ForkSeq[targetFork] <= ForkSeq.deneb) break;
185
+
186
+ // biome-ignore lint/suspicious/noFallthroughSwitchClause: We need fall-through behavior here
187
+ case ForkName.electra:
188
+ // No changes to LightClientHeader in Electra
189
+
190
+ // Break if no further upgrades is required else fall through
191
+ if (ForkSeq[targetFork] <= ForkSeq.electra) break;
192
+
193
+ // biome-ignore lint/suspicious/noFallthroughSwitchClause: We need fall-through behavior here
194
+ case ForkName.fulu:
195
+ // No changes to LightClientHeader in Fulu
196
+
197
+ // Break if no further upgrades is required else fall through
198
+ if (ForkSeq[targetFork] <= ForkSeq.fulu) break;
199
+
200
+ case ForkName.gloas:
201
+ // No changes to LightClientHeader in Gloas
202
+
203
+ // Break if no further upgrades is required else fall through
204
+ if (ForkSeq[targetFork] <= ForkSeq.gloas) break;
205
+ }
206
+ return upgradedHeader;
207
+ }
208
+
209
+ export function isValidLightClientHeader(config: ChainForkConfig, header: LightClientHeader): boolean {
210
+ const epoch = computeEpochAtSlot(header.beacon.slot);
211
+
212
+ if (epoch < config.CAPELLA_FORK_EPOCH) {
213
+ return (
214
+ ((header as LightClientHeader<ForkName.capella>).execution === undefined ||
215
+ ssz.capella.ExecutionPayloadHeader.equals(
216
+ (header as LightClientHeader<ForkName.capella>).execution,
217
+ ssz.capella.LightClientHeader.fields.execution.defaultValue()
218
+ )) &&
219
+ ((header as LightClientHeader<ForkName.capella>).executionBranch === undefined ||
220
+ ssz.capella.LightClientHeader.fields.executionBranch.equals(
221
+ ssz.capella.LightClientHeader.fields.executionBranch.defaultValue(),
222
+ (header as LightClientHeader<ForkName.capella>).executionBranch
223
+ ))
224
+ );
225
+ }
226
+
227
+ if (
228
+ epoch < config.DENEB_FORK_EPOCH &&
229
+ (((header as LightClientHeader<ForkName.deneb>).execution.blobGasUsed &&
230
+ (header as LightClientHeader<ForkName.deneb>).execution.blobGasUsed !== BigInt(0)) ||
231
+ ((header as LightClientHeader<ForkName.deneb>).execution.excessBlobGas &&
232
+ (header as LightClientHeader<ForkName.deneb>).execution.excessBlobGas !== BigInt(0)))
233
+ ) {
234
+ return false;
235
+ }
236
+
237
+ return isValidMerkleBranch(
238
+ config
239
+ .getPostBellatrixForkTypes(header.beacon.slot)
240
+ .ExecutionPayloadHeader.hashTreeRoot((header as LightClientHeader<ForkName.capella>).execution),
241
+ (header as LightClientHeader<ForkName.capella>).executionBranch,
242
+ EXECUTION_PAYLOAD_DEPTH,
243
+ EXECUTION_PAYLOAD_INDEX,
244
+ header.beacon.bodyRoot
245
+ );
246
+ }
247
+
248
+ export function upgradeLightClientUpdate(
249
+ config: ChainForkConfig,
250
+ targetFork: ForkName,
251
+ update: LightClientUpdate
252
+ ): LightClientUpdate {
253
+ update.attestedHeader = upgradeLightClientHeader(config, targetFork, update.attestedHeader);
254
+ update.finalizedHeader = upgradeLightClientHeader(config, targetFork, update.finalizedHeader);
255
+ update.nextSyncCommitteeBranch = normalizeMerkleBranch(
256
+ update.nextSyncCommitteeBranch,
257
+ isForkPostElectra(targetFork) ? NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA : NEXT_SYNC_COMMITTEE_DEPTH
258
+ );
259
+ update.finalityBranch = normalizeMerkleBranch(
260
+ update.finalityBranch,
261
+ isForkPostElectra(targetFork) ? FINALIZED_ROOT_DEPTH_ELECTRA : FINALIZED_ROOT_DEPTH
262
+ );
263
+
264
+ return update;
265
+ }
266
+
267
+ export function upgradeLightClientFinalityUpdate(
268
+ config: ChainForkConfig,
269
+ targetFork: ForkName,
270
+ finalityUpdate: LightClientFinalityUpdate
271
+ ): LightClientFinalityUpdate {
272
+ finalityUpdate.attestedHeader = upgradeLightClientHeader(config, targetFork, finalityUpdate.attestedHeader);
273
+ finalityUpdate.finalizedHeader = upgradeLightClientHeader(config, targetFork, finalityUpdate.finalizedHeader);
274
+ finalityUpdate.finalityBranch = normalizeMerkleBranch(
275
+ finalityUpdate.finalityBranch,
276
+ isForkPostElectra(targetFork) ? FINALIZED_ROOT_DEPTH_ELECTRA : FINALIZED_ROOT_DEPTH
277
+ );
278
+
279
+ return finalityUpdate;
280
+ }
281
+
282
+ export function upgradeLightClientOptimisticUpdate(
283
+ config: ChainForkConfig,
284
+ targetFork: ForkName,
285
+ optimisticUpdate: LightClientOptimisticUpdate
286
+ ): LightClientOptimisticUpdate {
287
+ optimisticUpdate.attestedHeader = upgradeLightClientHeader(config, targetFork, optimisticUpdate.attestedHeader);
288
+
289
+ return optimisticUpdate;
290
+ }
291
+
292
+ /**
293
+ * Currently this upgradation is not required because all processing is done based on the
294
+ * summary that the store generates and maintains. In case store needs to be saved to disk,
295
+ * this could be required depending on the format the store is saved to the disk
296
+ */
297
+ export function upgradeLightClientStore(
298
+ config: ChainForkConfig,
299
+ targetFork: ForkName,
300
+ store: LightClientStore,
301
+ signatureSlot: Slot
302
+ ): LightClientStore {
303
+ const updateSignaturePeriod = computeSyncPeriodAtSlot(signatureSlot);
304
+ const bestValidUpdate = store.bestValidUpdates.get(updateSignaturePeriod);
305
+
306
+ if (bestValidUpdate) {
307
+ store.bestValidUpdates.set(updateSignaturePeriod, {
308
+ update: upgradeLightClientUpdate(config, targetFork, bestValidUpdate.update),
309
+ summary: bestValidUpdate.summary,
310
+ });
311
+ }
312
+
313
+ store.finalizedHeader = upgradeLightClientHeader(config, targetFork, store.finalizedHeader);
314
+ store.optimisticHeader = upgradeLightClientHeader(config, targetFork, store.optimisticHeader);
315
+
316
+ return store;
317
+ }
@@ -0,0 +1,39 @@
1
+ import {ChainForkConfig} from "@lodestar/config";
2
+ import {isForkPostElectra} from "@lodestar/params";
3
+ import {LightClientBootstrap, Root, ssz} from "@lodestar/types";
4
+ import {byteArrayEquals, toHex} from "@lodestar/utils";
5
+ import {isValidLightClientHeader, isValidMerkleBranch} from "./utils.js";
6
+
7
+ const CURRENT_SYNC_COMMITTEE_INDEX = 22;
8
+ const CURRENT_SYNC_COMMITTEE_DEPTH = 5;
9
+ const CURRENT_SYNC_COMMITTEE_INDEX_ELECTRA = 22;
10
+ const CURRENT_SYNC_COMMITTEE_DEPTH_ELECTRA = 6;
11
+
12
+ export function validateLightClientBootstrap(
13
+ config: ChainForkConfig,
14
+ trustedBlockRoot: Root,
15
+ bootstrap: LightClientBootstrap
16
+ ): void {
17
+ const headerRoot = ssz.phase0.BeaconBlockHeader.hashTreeRoot(bootstrap.header.beacon);
18
+ const fork = config.getForkName(bootstrap.header.beacon.slot);
19
+
20
+ if (!isValidLightClientHeader(config, bootstrap.header)) {
21
+ throw Error("Bootstrap Header is not Valid Light Client Header");
22
+ }
23
+
24
+ if (!byteArrayEquals(headerRoot, trustedBlockRoot)) {
25
+ throw Error(`bootstrap header root ${toHex(headerRoot)} != trusted root ${toHex(trustedBlockRoot)}`);
26
+ }
27
+
28
+ if (
29
+ !isValidMerkleBranch(
30
+ ssz.altair.SyncCommittee.hashTreeRoot(bootstrap.currentSyncCommittee),
31
+ bootstrap.currentSyncCommitteeBranch,
32
+ isForkPostElectra(fork) ? CURRENT_SYNC_COMMITTEE_DEPTH_ELECTRA : CURRENT_SYNC_COMMITTEE_DEPTH,
33
+ isForkPostElectra(fork) ? CURRENT_SYNC_COMMITTEE_INDEX_ELECTRA : CURRENT_SYNC_COMMITTEE_INDEX,
34
+ bootstrap.header.beacon.stateRoot
35
+ )
36
+ ) {
37
+ throw Error("Invalid currentSyncCommittee merkle branch");
38
+ }
39
+ }
@@ -0,0 +1,145 @@
1
+ import {PublicKey, Signature, fastAggregateVerify} from "@chainsafe/blst";
2
+ import {ChainForkConfig} from "@lodestar/config";
3
+ import {
4
+ DOMAIN_SYNC_COMMITTEE,
5
+ FINALIZED_ROOT_DEPTH,
6
+ FINALIZED_ROOT_DEPTH_ELECTRA,
7
+ FINALIZED_ROOT_INDEX,
8
+ FINALIZED_ROOT_INDEX_ELECTRA,
9
+ GENESIS_SLOT,
10
+ MIN_SYNC_COMMITTEE_PARTICIPANTS,
11
+ NEXT_SYNC_COMMITTEE_DEPTH,
12
+ NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA,
13
+ NEXT_SYNC_COMMITTEE_INDEX,
14
+ NEXT_SYNC_COMMITTEE_INDEX_ELECTRA,
15
+ } from "@lodestar/params";
16
+ import {LightClientUpdate, Root, isElectraLightClientUpdate, ssz} from "@lodestar/types";
17
+ import type {ILightClientStore, SyncCommitteeFast} from "./store.js";
18
+ import {
19
+ ZERO_HASH,
20
+ getParticipantPubkeys,
21
+ isFinalityUpdate,
22
+ isSyncCommitteeUpdate,
23
+ isValidLightClientHeader,
24
+ isValidMerkleBranch,
25
+ isZeroedHeader,
26
+ isZeroedSyncCommittee,
27
+ sumBits,
28
+ } from "./utils.js";
29
+
30
+ export function validateLightClientUpdate(
31
+ config: ChainForkConfig,
32
+ store: ILightClientStore,
33
+ update: LightClientUpdate,
34
+ syncCommittee: SyncCommitteeFast
35
+ ): void {
36
+ // Verify sync committee has sufficient participants
37
+ if (sumBits(update.syncAggregate.syncCommitteeBits) < MIN_SYNC_COMMITTEE_PARTICIPANTS) {
38
+ throw Error("Sync committee has not sufficient participants");
39
+ }
40
+
41
+ if (!isValidLightClientHeader(config, update.attestedHeader)) {
42
+ throw Error("Attested Header is not Valid Light Client Header");
43
+ }
44
+
45
+ // Sanity check that slots are in correct order
46
+ if (update.signatureSlot <= update.attestedHeader.beacon.slot) {
47
+ throw Error(
48
+ `signature slot ${update.signatureSlot} must be after attested header slot ${update.attestedHeader.beacon.slot}`
49
+ );
50
+ }
51
+ if (update.attestedHeader.beacon.slot < update.finalizedHeader.beacon.slot) {
52
+ throw Error(
53
+ `attested header slot ${update.signatureSlot} must be after finalized header slot ${update.finalizedHeader.beacon.slot}`
54
+ );
55
+ }
56
+
57
+ // Verify that the `finality_branch`, if present, confirms `finalized_header`
58
+ // to match the finalized checkpoint root saved in the state of `attested_header`.
59
+ // Note that the genesis finalized checkpoint root is represented as a zero hash.
60
+ if (!isFinalityUpdate(update)) {
61
+ if (!isZeroedHeader(update.finalizedHeader.beacon)) {
62
+ throw Error("finalizedHeader must be zero for non-finality update");
63
+ }
64
+ } else {
65
+ let finalizedRoot: Root;
66
+
67
+ if (update.finalizedHeader.beacon.slot === GENESIS_SLOT) {
68
+ if (!isZeroedHeader(update.finalizedHeader.beacon)) {
69
+ throw Error("finalizedHeader must be zero for not finality update");
70
+ }
71
+ finalizedRoot = ZERO_HASH;
72
+ } else {
73
+ if (!isValidLightClientHeader(config, update.finalizedHeader)) {
74
+ throw Error("Finalized Header is not valid Light Client Header");
75
+ }
76
+
77
+ finalizedRoot = ssz.phase0.BeaconBlockHeader.hashTreeRoot(update.finalizedHeader.beacon);
78
+ }
79
+
80
+ if (
81
+ !isValidMerkleBranch(
82
+ finalizedRoot,
83
+ update.finalityBranch,
84
+ isElectraLightClientUpdate(update) ? FINALIZED_ROOT_DEPTH_ELECTRA : FINALIZED_ROOT_DEPTH,
85
+ isElectraLightClientUpdate(update) ? FINALIZED_ROOT_INDEX_ELECTRA : FINALIZED_ROOT_INDEX,
86
+ update.attestedHeader.beacon.stateRoot
87
+ )
88
+ ) {
89
+ throw Error("Invalid finality header merkle branch");
90
+ }
91
+ }
92
+
93
+ // Verify that the `next_sync_committee`, if present, actually is the next sync committee saved in the
94
+ // state of the `attested_header`
95
+ if (!isSyncCommitteeUpdate(update)) {
96
+ if (!isZeroedSyncCommittee(update.nextSyncCommittee)) {
97
+ throw Error("nextSyncCommittee must be zero for non sync committee update");
98
+ }
99
+ } else {
100
+ if (
101
+ !isValidMerkleBranch(
102
+ ssz.altair.SyncCommittee.hashTreeRoot(update.nextSyncCommittee),
103
+ update.nextSyncCommitteeBranch,
104
+ isElectraLightClientUpdate(update) ? NEXT_SYNC_COMMITTEE_DEPTH_ELECTRA : NEXT_SYNC_COMMITTEE_DEPTH,
105
+ isElectraLightClientUpdate(update) ? NEXT_SYNC_COMMITTEE_INDEX_ELECTRA : NEXT_SYNC_COMMITTEE_INDEX,
106
+ update.attestedHeader.beacon.stateRoot
107
+ )
108
+ ) {
109
+ throw Error("Invalid next sync committee merkle branch");
110
+ }
111
+ }
112
+
113
+ // Verify sync committee aggregate signature
114
+
115
+ const participantPubkeys = getParticipantPubkeys(syncCommittee.pubkeys, update.syncAggregate.syncCommitteeBits);
116
+
117
+ const signingRoot = ssz.phase0.SigningData.hashTreeRoot({
118
+ objectRoot: ssz.phase0.BeaconBlockHeader.hashTreeRoot(update.attestedHeader.beacon),
119
+ domain: store.config.getDomain(update.signatureSlot - 1, DOMAIN_SYNC_COMMITTEE),
120
+ });
121
+
122
+ if (!isValidBlsAggregate(participantPubkeys, signingRoot, update.syncAggregate.syncCommitteeSignature)) {
123
+ throw Error("Invalid aggregate signature");
124
+ }
125
+ }
126
+
127
+ /**
128
+ * Same as BLS.verifyAggregate but with detailed error messages
129
+ */
130
+ function isValidBlsAggregate(publicKeys: PublicKey[], message: Uint8Array, signature: Uint8Array): boolean {
131
+ let sig: Signature;
132
+ try {
133
+ sig = Signature.fromBytes(signature, true);
134
+ } catch (e) {
135
+ (e as Error).message = `Error deserializing signature: ${(e as Error).message}`;
136
+ throw e;
137
+ }
138
+
139
+ try {
140
+ return fastAggregateVerify(message, publicKeys, sig);
141
+ } catch (e) {
142
+ (e as Error).message = `Error verifying signature: ${(e as Error).message}`;
143
+ throw e;
144
+ }
145
+ }
@@ -1,12 +1,12 @@
1
1
  import {SLOTS_PER_HISTORICAL_ROOT} from "@lodestar/params";
2
2
  import {ssz} from "@lodestar/types";
3
- import {toHex} from "@lodestar/utils";
4
- import {isValidDepositSignature} from "../block/processDeposit.js";
3
+ import {toPubkeyHex} from "@lodestar/utils";
5
4
  import {applyDepositForBuilder} from "../block/processDepositRequest.js";
6
5
  import {getCachedBeaconState} from "../cache/stateCache.js";
7
6
  import {CachedBeaconStateFulu, CachedBeaconStateGloas} from "../types.js";
8
7
  import {initializePtcWindow, isBuilderWithdrawalCredential} from "../util/gloas.js";
9
8
  import {isValidatorKnown} from "../util/index.js";
9
+ import {PendingDepositsLookup} from "../util/pendingDepositsLookup.js";
10
10
 
11
11
  /**
12
12
  * Upgrade a state from Fulu to Gloas.
@@ -48,6 +48,7 @@ export function upgradeStateToGloas(stateFulu: CachedBeaconStateFulu): CachedBea
48
48
  stateGloasView.currentSyncCommittee = stateGloasCloned.currentSyncCommittee;
49
49
  stateGloasView.nextSyncCommittee = stateGloasCloned.nextSyncCommittee;
50
50
  stateGloasView.latestExecutionPayloadBid.blockHash = stateFulu.latestExecutionPayloadHeader.blockHash;
51
+ stateGloasView.latestExecutionPayloadBid.gasLimit = BigInt(stateFulu.latestExecutionPayloadHeader.gasLimit);
51
52
  stateGloasView.latestExecutionPayloadBid.executionRequestsRoot = ssz.electra.ExecutionRequests.hashTreeRoot(
52
53
  ssz.electra.ExecutionRequests.defaultValue()
53
54
  );
@@ -86,66 +87,63 @@ export function upgradeStateToGloas(stateFulu: CachedBeaconStateFulu): CachedBea
86
87
 
87
88
  /**
88
89
  * Applies any pending deposits for builders to onboard builders during the fork transition
89
- * Spec: https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.2/specs/gloas/fork.md#new-onboard_builders_from_pending_deposits
90
+ * Spec: https://github.com/ethereum/consensus-specs/blob/v1.7.0-alpha.8/specs/gloas/fork.md#new-onboard_builders_from_pending_deposits
90
91
  */
91
92
  function onboardBuildersFromPendingDeposits(state: CachedBeaconStateGloas): void {
92
- // Track pubkeys of new validators to keep their deposits pending
93
- const validatorPubkeys = new Set<string>();
94
-
95
93
  // Track pubkeys of new builders added when applying deposits
96
94
  const builderPubkeys = new Set<string>();
97
95
 
98
- const remainingPendingDeposits = ssz.electra.PendingDeposits.defaultViewDU();
96
+ const pendingDeposits = ssz.electra.PendingDeposits.defaultViewDU();
97
+ const pendingDepositsLookup = PendingDepositsLookup.buildEmpty();
98
+
99
99
  for (let i = 0; i < state.pendingDeposits.length; i++) {
100
100
  const deposit = state.pendingDeposits.getReadonly(i);
101
101
 
102
102
  const validatorIndex = state.epochCtx.getValidatorIndex(deposit.pubkey);
103
- const pubkeyHex = toHex(deposit.pubkey);
103
+ const pubkeyHex = toPubkeyHex(deposit.pubkey);
104
104
 
105
- // Deposits for existing validators stay in pending queue
106
- if (isValidatorKnown(state, validatorIndex) || validatorPubkeys.has(pubkeyHex)) {
107
- remainingPendingDeposits.push(deposit);
105
+ // Deposits for existing validators stay in the pending queue
106
+ if (isValidatorKnown(state, validatorIndex)) {
107
+ pendingDeposits.push(deposit);
108
+ pendingDepositsLookup.add(deposit, pubkeyHex);
108
109
  continue;
109
110
  }
110
111
 
111
- // If the pubkey is associated with a builder that was created in a previous iteration
112
- // or it is a builder deposit, try to apply the deposit to the new/existing builder
113
- const isExistingBuilder = builderPubkeys.has(pubkeyHex);
114
- const hasBuilderCredentials = isBuilderWithdrawalCredential(deposit.withdrawalCredentials);
115
- if (isExistingBuilder || hasBuilderCredentials) {
116
- const buildersLenBefore = state.builders.length;
117
- applyDepositForBuilder(
118
- state,
119
- deposit.pubkey,
120
- deposit.withdrawalCredentials,
121
- deposit.amount,
122
- deposit.signature,
123
- deposit.slot
124
- );
125
- // Track newly added builders for subsequent iterations
126
- if (!isExistingBuilder && state.builders.length > buildersLenBefore) {
127
- builderPubkeys.add(pubkeyHex);
112
+ // `applyDepositForBuilder` can mutate the state and add a builder to the registry, so
113
+ // the set of builder pubkeys must be recomputed each iteration. `builderPubkeys` stands
114
+ // in for the spec's `[b.pubkey for b in state.builders]`: `state.builders` starts empty
115
+ // at the fork, so every builder is one added in a previous iteration of this loop.
116
+ if (!builderPubkeys.has(pubkeyHex)) {
117
+ // Deposits for non-builders stay in the pending queue. If there is a valid pending
118
+ // deposit for a new validator with this pubkey, keep this deposit in the pending
119
+ // queue to be applied to that validator later.
120
+ if (!isBuilderWithdrawalCredential(deposit.withdrawalCredentials)) {
121
+ pendingDeposits.push(deposit);
122
+ pendingDepositsLookup.add(deposit, pubkeyHex);
123
+ continue;
124
+ }
125
+ if (pendingDepositsLookup.hasPendingValidator(state.config, pubkeyHex)) {
126
+ pendingDeposits.push(deposit);
127
+ pendingDepositsLookup.add(deposit, pubkeyHex);
128
+ continue;
128
129
  }
129
- continue;
130
130
  }
131
131
 
132
- // If there is a pending deposit for a new validator that has a valid signature, track the
133
- // pubkey so that subsequent builder deposits for the same pubkey stay in pending (applied to
134
- // the validator later) rather than creating a builder. Deposits with invalid signatures are
135
- // dropped here since they would fail in apply_pending_deposit anyway.
136
- if (
137
- isValidDepositSignature(
138
- state.config,
139
- deposit.pubkey,
140
- deposit.withdrawalCredentials,
141
- deposit.amount,
142
- deposit.signature
143
- )
144
- ) {
145
- validatorPubkeys.add(pubkeyHex);
146
- remainingPendingDeposits.push(deposit);
132
+ const buildersLenBefore = state.builders.length;
133
+ // TODO GLOAS: handle 20k 1ETH deposits on time
134
+ // there is a note in the spec https://github.com/ethereum/consensus-specs/pull/5227
135
+ applyDepositForBuilder(
136
+ state,
137
+ deposit.pubkey,
138
+ deposit.withdrawalCredentials,
139
+ deposit.amount,
140
+ deposit.signature,
141
+ deposit.slot
142
+ );
143
+ if (state.builders.length > buildersLenBefore) {
144
+ builderPubkeys.add(pubkeyHex);
147
145
  }
148
146
  }
149
147
 
150
- state.pendingDeposits = remainingPendingDeposits;
148
+ state.pendingDeposits = pendingDeposits;
151
149
  }
@@ -423,16 +423,27 @@ export class BeaconStateView implements IBeaconStateViewLatestFork {
423
423
  throw new Error(`PTC committees are not available for epoch=${epoch}`);
424
424
  }
425
425
  /**
426
- * Return the index of the validator in the PTC committee for the given slot.
427
- * return -1 if validator is not in the PTC committee for the given slot.
426
+ * Return all positions of the validator in the PTC committee for the given slot.
427
+ *
428
+ * `compute_ptc` samples by effective balance and may place the same validator at multiple
429
+ * positions, so a validator can have more than one index. Returns an empty array if the
430
+ * validator is not in the PTC for the given slot.
431
+ *
432
+ * Spec: gloas/fork-choice.md#new-on_payload_attestation_message
428
433
  */
429
- getIndexInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number {
434
+ getIndicesInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number[] {
430
435
  if (this.config.getForkSeq(this.cachedState.slot) < ForkSeq.gloas) {
431
436
  throw new Error("PTC committees are not supported before Gloas");
432
437
  }
433
438
 
434
439
  const ptcCommittee = (this.cachedState as CachedBeaconStateGloas).epochCtx.getPayloadTimelinessCommittee(slot);
435
- return ptcCommittee.indexOf(validatorIndex);
440
+ const indices: number[] = [];
441
+ for (let i = 0; i < ptcCommittee.length; i++) {
442
+ if (ptcCommittee[i] === validatorIndex) {
443
+ indices.push(i);
444
+ }
445
+ }
446
+ return indices;
436
447
  }
437
448
 
438
449
  // Shuffling and committees
@@ -253,7 +253,7 @@ export interface IBeaconStateViewGloas extends IBeaconStateViewFulu {
253
253
  getBuilder(index: BuilderIndex): gloas.Builder;
254
254
  canBuilderCoverBid(builderIndex: BuilderIndex, bidAmount: number): boolean;
255
255
  getEpochPTCs(epoch: Epoch): Uint32Array[];
256
- getIndexInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number;
256
+ getIndicesInPayloadTimelinessCommittee(validatorIndex: ValidatorIndex, slot: Slot): number[];
257
257
  /**
258
258
  * Clone the state and apply parent execution payload effects.
259
259
  * Used during block production and prepareNextSlot so that withdrawals and