@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.
- package/lib/block/processDepositRequest.d.ts +3 -11
- package/lib/block/processDepositRequest.d.ts.map +1 -1
- package/lib/block/processDepositRequest.js +27 -35
- package/lib/block/processDepositRequest.js.map +1 -1
- package/lib/block/processParentExecutionPayload.d.ts.map +1 -1
- package/lib/block/processParentExecutionPayload.js +4 -3
- package/lib/block/processParentExecutionPayload.js.map +1 -1
- package/lib/lightClient/spec/index.d.ts +22 -0
- package/lib/lightClient/spec/index.d.ts.map +1 -0
- package/lib/lightClient/spec/index.js +58 -0
- package/lib/lightClient/spec/index.js.map +1 -0
- package/lib/lightClient/spec/isBetterUpdate.d.ts +23 -0
- package/lib/lightClient/spec/isBetterUpdate.d.ts.map +1 -0
- package/lib/lightClient/spec/isBetterUpdate.js +66 -0
- package/lib/lightClient/spec/isBetterUpdate.js.map +1 -0
- package/lib/lightClient/spec/processLightClientUpdate.d.ts +12 -0
- package/lib/lightClient/spec/processLightClientUpdate.d.ts.map +1 -0
- package/lib/lightClient/spec/processLightClientUpdate.js +80 -0
- package/lib/lightClient/spec/processLightClientUpdate.js.map +1 -0
- package/lib/lightClient/spec/store.d.ts +45 -0
- package/lib/lightClient/spec/store.d.ts.map +1 -0
- package/lib/lightClient/spec/store.js +56 -0
- package/lib/lightClient/spec/store.js.map +1 -0
- package/lib/lightClient/spec/utils.d.ts +47 -0
- package/lib/lightClient/spec/utils.d.ts.map +1 -0
- package/lib/lightClient/spec/utils.js +197 -0
- package/lib/lightClient/spec/utils.js.map +1 -0
- package/lib/lightClient/spec/validateLightClientBootstrap.d.ts +4 -0
- package/lib/lightClient/spec/validateLightClientBootstrap.d.ts.map +1 -0
- package/lib/lightClient/spec/validateLightClientBootstrap.js +22 -0
- package/lib/lightClient/spec/validateLightClientBootstrap.js.map +1 -0
- package/lib/lightClient/spec/validateLightClientUpdate.d.ts +5 -0
- package/lib/lightClient/spec/validateLightClientUpdate.d.ts.map +1 -0
- package/lib/lightClient/spec/validateLightClientUpdate.js +88 -0
- package/lib/lightClient/spec/validateLightClientUpdate.js.map +1 -0
- package/lib/slot/upgradeStateToGloas.d.ts.map +1 -1
- package/lib/slot/upgradeStateToGloas.js +35 -29
- package/lib/slot/upgradeStateToGloas.js.map +1 -1
- package/lib/stateView/beaconStateView.d.ts +8 -3
- package/lib/stateView/beaconStateView.d.ts.map +1 -1
- package/lib/stateView/beaconStateView.js +15 -4
- package/lib/stateView/beaconStateView.js.map +1 -1
- package/lib/stateView/interface.d.ts +1 -1
- package/lib/stateView/interface.d.ts.map +1 -1
- package/lib/util/index.d.ts +1 -0
- package/lib/util/index.d.ts.map +1 -1
- package/lib/util/index.js +1 -0
- package/lib/util/index.js.map +1 -1
- package/lib/util/pendingDepositsLookup.d.ts +40 -0
- package/lib/util/pendingDepositsLookup.d.ts.map +1 -0
- package/lib/util/pendingDepositsLookup.js +84 -0
- package/lib/util/pendingDepositsLookup.js.map +1 -0
- package/lib/util/shuffling.d.ts +6 -5
- package/lib/util/shuffling.d.ts.map +1 -1
- package/lib/util/shuffling.js +13 -15
- package/lib/util/shuffling.js.map +1 -1
- package/package.json +12 -7
- package/src/block/processDepositRequest.ts +29 -47
- package/src/block/processParentExecutionPayload.ts +4 -3
- package/src/lightClient/spec/index.ts +101 -0
- package/src/lightClient/spec/isBetterUpdate.ts +94 -0
- package/src/lightClient/spec/processLightClientUpdate.ts +119 -0
- package/src/lightClient/spec/store.ts +106 -0
- package/src/lightClient/spec/utils.ts +317 -0
- package/src/lightClient/spec/validateLightClientBootstrap.ts +39 -0
- package/src/lightClient/spec/validateLightClientUpdate.ts +145 -0
- package/src/slot/upgradeStateToGloas.ts +43 -45
- package/src/stateView/beaconStateView.ts +15 -4
- package/src/stateView/interface.ts +1 -1
- package/src/util/index.ts +1 -0
- package/src/util/pendingDepositsLookup.ts +105 -0
- 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 {
|
|
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.
|
|
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
|
|
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 =
|
|
103
|
+
const pubkeyHex = toPubkeyHex(deposit.pubkey);
|
|
104
104
|
|
|
105
|
-
// Deposits for existing validators stay in pending queue
|
|
106
|
-
if (isValidatorKnown(state, validatorIndex)
|
|
107
|
-
|
|
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
|
-
//
|
|
112
|
-
//
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
if (
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
deposit
|
|
121
|
-
deposit
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
)
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
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
|
-
|
|
133
|
-
//
|
|
134
|
-
//
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
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 =
|
|
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
|
|
427
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|