@lodestar/state-transition 1.39.0 → 1.40.0-dev.3be9500fa9

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 (90) hide show
  1. package/lib/block/isValidIndexedAttestation.d.ts +4 -5
  2. package/lib/block/isValidIndexedAttestation.d.ts.map +1 -1
  3. package/lib/block/isValidIndexedAttestation.js +9 -10
  4. package/lib/block/isValidIndexedAttestation.js.map +1 -1
  5. package/lib/block/processAttestationPhase0.d.ts.map +1 -1
  6. package/lib/block/processAttestationPhase0.js +1 -1
  7. package/lib/block/processAttestationPhase0.js.map +1 -1
  8. package/lib/block/processAttesterSlashing.d.ts +3 -2
  9. package/lib/block/processAttesterSlashing.d.ts.map +1 -1
  10. package/lib/block/processAttesterSlashing.js +3 -3
  11. package/lib/block/processAttesterSlashing.js.map +1 -1
  12. package/lib/block/processBlsToExecutionChange.d.ts +3 -1
  13. package/lib/block/processBlsToExecutionChange.d.ts.map +1 -1
  14. package/lib/block/processBlsToExecutionChange.js +7 -11
  15. package/lib/block/processBlsToExecutionChange.js.map +1 -1
  16. package/lib/block/processProposerSlashing.d.ts +5 -2
  17. package/lib/block/processProposerSlashing.d.ts.map +1 -1
  18. package/lib/block/processProposerSlashing.js +7 -5
  19. package/lib/block/processProposerSlashing.js.map +1 -1
  20. package/lib/cache/epochCache.d.ts +8 -28
  21. package/lib/cache/epochCache.d.ts.map +1 -1
  22. package/lib/cache/epochCache.js +40 -180
  23. package/lib/cache/epochCache.js.map +1 -1
  24. package/lib/cache/epochTransitionCache.d.ts +5 -12
  25. package/lib/cache/epochTransitionCache.d.ts.map +1 -1
  26. package/lib/cache/epochTransitionCache.js +4 -14
  27. package/lib/cache/epochTransitionCache.js.map +1 -1
  28. package/lib/cache/stateCache.d.ts.map +1 -1
  29. package/lib/cache/stateCache.js +1 -2
  30. package/lib/cache/stateCache.js.map +1 -1
  31. package/lib/epoch/processProposerLookahead.d.ts.map +1 -1
  32. package/lib/epoch/processProposerLookahead.js +3 -6
  33. package/lib/epoch/processProposerLookahead.js.map +1 -1
  34. package/lib/index.d.ts +1 -1
  35. package/lib/index.d.ts.map +1 -1
  36. package/lib/index.js +1 -1
  37. package/lib/index.js.map +1 -1
  38. package/lib/rewards/blockRewards.d.ts +2 -1
  39. package/lib/rewards/blockRewards.d.ts.map +1 -1
  40. package/lib/rewards/blockRewards.js +3 -2
  41. package/lib/rewards/blockRewards.js.map +1 -1
  42. package/lib/rewards/syncCommitteeRewards.d.ts.map +1 -1
  43. package/lib/rewards/syncCommitteeRewards.js +10 -11
  44. package/lib/rewards/syncCommitteeRewards.js.map +1 -1
  45. package/lib/signatureSets/blsToExecutionChange.d.ts +1 -2
  46. package/lib/signatureSets/blsToExecutionChange.d.ts.map +1 -1
  47. package/lib/signatureSets/blsToExecutionChange.js +2 -2
  48. package/lib/signatureSets/blsToExecutionChange.js.map +1 -1
  49. package/lib/types.d.ts +1 -1
  50. package/lib/types.d.ts.map +1 -1
  51. package/lib/util/epochShuffling.d.ts +1 -34
  52. package/lib/util/epochShuffling.d.ts.map +1 -1
  53. package/lib/util/epochShuffling.js +1 -1
  54. package/lib/util/epochShuffling.js.map +1 -1
  55. package/lib/util/index.d.ts +1 -2
  56. package/lib/util/index.d.ts.map +1 -1
  57. package/lib/util/index.js +1 -2
  58. package/lib/util/index.js.map +1 -1
  59. package/lib/util/shuffling.d.ts +58 -0
  60. package/lib/util/shuffling.d.ts.map +1 -0
  61. package/lib/util/shuffling.js +175 -0
  62. package/lib/util/shuffling.js.map +1 -0
  63. package/package.json +7 -7
  64. package/src/block/isValidIndexedAttestation.ts +17 -12
  65. package/src/block/processAttestationPhase0.ts +2 -1
  66. package/src/block/processAttesterSlashing.ts +16 -4
  67. package/src/block/processBlsToExecutionChange.ts +13 -14
  68. package/src/block/processProposerSlashing.ts +21 -11
  69. package/src/cache/epochCache.ts +52 -214
  70. package/src/cache/epochTransitionCache.ts +9 -34
  71. package/src/cache/stateCache.ts +1 -2
  72. package/src/epoch/processProposerLookahead.ts +3 -7
  73. package/src/index.ts +0 -2
  74. package/src/rewards/blockRewards.ts +6 -3
  75. package/src/rewards/syncCommitteeRewards.ts +10 -13
  76. package/src/signatureSets/blsToExecutionChange.ts +2 -3
  77. package/src/types.ts +1 -0
  78. package/src/util/epochShuffling.ts +2 -43
  79. package/src/util/index.ts +1 -2
  80. package/src/util/shuffling.ts +234 -0
  81. package/lib/util/calculateCommitteeAssignments.d.ts +0 -12
  82. package/lib/util/calculateCommitteeAssignments.d.ts.map +0 -1
  83. package/lib/util/calculateCommitteeAssignments.js +0 -26
  84. package/lib/util/calculateCommitteeAssignments.js.map +0 -1
  85. package/lib/util/shufflingDecisionRoot.d.ts +0 -20
  86. package/lib/util/shufflingDecisionRoot.d.ts.map +0 -1
  87. package/lib/util/shufflingDecisionRoot.js +0 -76
  88. package/lib/util/shufflingDecisionRoot.js.map +0 -1
  89. package/src/util/calculateCommitteeAssignments.ts +0 -43
  90. package/src/util/shufflingDecisionRoot.ts +0 -81
@@ -2,14 +2,13 @@ import {PublicKey} from "@chainsafe/blst";
2
2
  import {BeaconConfig} from "@lodestar/config";
3
3
  import {DOMAIN_BLS_TO_EXECUTION_CHANGE, ForkName} from "@lodestar/params";
4
4
  import {capella, ssz} from "@lodestar/types";
5
- import {CachedBeaconStateAllForks} from "../types.js";
6
5
  import {ISignatureSet, SignatureSetType, computeSigningRoot, verifySignatureSet} from "../util/index.js";
7
6
 
8
7
  export function verifyBlsToExecutionChangeSignature(
9
- state: CachedBeaconStateAllForks,
8
+ config: BeaconConfig,
10
9
  signedBLSToExecutionChange: capella.SignedBLSToExecutionChange
11
10
  ): boolean {
12
- return verifySignatureSet(getBlsToExecutionChangeSignatureSet(state.config, signedBLSToExecutionChange));
11
+ return verifySignatureSet(getBlsToExecutionChangeSignatureSet(config, signedBLSToExecutionChange));
13
12
  }
14
13
 
15
14
  /**
package/src/types.ts CHANGED
@@ -23,4 +23,5 @@ export type {
23
23
  BeaconStateFulu,
24
24
  BeaconStateGloas,
25
25
  BeaconStatePhase0,
26
+ ShufflingGetter,
26
27
  } from "./cache/types.js";
@@ -9,54 +9,13 @@ import {
9
9
  TARGET_COMMITTEE_SIZE,
10
10
  } from "@lodestar/params";
11
11
  import {Epoch, RootHex, ValidatorIndex, ssz} from "@lodestar/types";
12
- import {GaugeExtra, Logger, NoLabels, intDiv, toRootHex} from "@lodestar/utils";
12
+ import {intDiv, toRootHex} from "@lodestar/utils";
13
13
  import {BeaconStateAllForks} from "../types.js";
14
14
  import {getBlockRootAtSlot} from "./blockRoot.js";
15
15
  import {computeAnchorCheckpoint} from "./computeAnchorCheckpoint.js";
16
16
  import {computeStartSlotAtEpoch} from "./epoch.js";
17
17
  import {getSeed} from "./seed.js";
18
18
 
19
- export interface ShufflingBuildProps {
20
- state: BeaconStateAllForks;
21
- activeIndices: Uint32Array;
22
- }
23
-
24
- export interface PublicShufflingCacheMetrics {
25
- shufflingCache: {
26
- nextShufflingNotOnEpochCache: GaugeExtra<NoLabels>;
27
- };
28
- }
29
- export interface IShufflingCache {
30
- metrics: PublicShufflingCacheMetrics | null;
31
- logger: Logger | null;
32
- /**
33
- * Gets a cached shuffling via the epoch and decision root. If the state and
34
- * activeIndices are passed and a shuffling is not available it will be built
35
- * synchronously. If the state is not passed and the shuffling is not available
36
- * nothing will be returned.
37
- *
38
- * NOTE: If a shuffling is already queued and not calculated it will build and resolve
39
- * the promise but the already queued build will happen at some later time
40
- */
41
- getSync<T extends ShufflingBuildProps | undefined>(
42
- epoch: Epoch,
43
- decisionRoot: RootHex,
44
- buildProps?: T
45
- ): T extends ShufflingBuildProps ? EpochShuffling : EpochShuffling | null;
46
-
47
- /**
48
- * Gets a cached shuffling via the epoch and decision root. Returns a promise
49
- * for the shuffling if it hs not calculated yet. Returns null if a build has
50
- * not been queued nor a shuffling was calculated.
51
- */
52
- get(epoch: Epoch, decisionRoot: RootHex): Promise<EpochShuffling | null>;
53
-
54
- /**
55
- * Queue asynchronous build for an EpochShuffling
56
- */
57
- build(epoch: Epoch, decisionRoot: RootHex, state: BeaconStateAllForks, activeIndices: Uint32Array): void;
58
- }
59
-
60
19
  /**
61
20
  * Readonly interface for EpochShuffling.
62
21
  */
@@ -164,7 +123,7 @@ export async function computeEpochShufflingAsync(
164
123
  };
165
124
  }
166
125
 
167
- function calculateDecisionRoot(state: BeaconStateAllForks, epoch: Epoch): RootHex {
126
+ export function calculateDecisionRoot(state: BeaconStateAllForks, epoch: Epoch): RootHex {
168
127
  const pivotSlot = computeStartSlotAtEpoch(epoch - 1) - 1;
169
128
  return toRootHex(getBlockRootAtSlot(state, pivotSlot));
170
129
  }
package/src/util/index.ts CHANGED
@@ -5,7 +5,6 @@ export * from "./attesterStatus.js";
5
5
  export * from "./balance.js";
6
6
  export * from "./blindedBlock.js";
7
7
  export * from "./blockRoot.js";
8
- export * from "./calculateCommitteeAssignments.js";
9
8
  export * from "./capella.js";
10
9
  export * from "./computeAnchorCheckpoint.js";
11
10
  export * from "./deposit.js";
@@ -20,7 +19,7 @@ export * from "./interop.js";
20
19
  export * from "./loadState/index.js";
21
20
  export * from "./rootCache.js";
22
21
  export * from "./seed.js";
23
- export * from "./shufflingDecisionRoot.js";
22
+ export * from "./shuffling.js";
24
23
  export * from "./signatureSets.js";
25
24
  export * from "./signingRoot.js";
26
25
  export * from "./slot.js";
@@ -0,0 +1,234 @@
1
+ import {ForkName, ForkSeq, SLOTS_PER_EPOCH, isForkPostFulu} from "@lodestar/params";
2
+ import {
3
+ Attestation,
4
+ CommitteeIndex,
5
+ Epoch,
6
+ IndexedAttestation,
7
+ Root,
8
+ Slot,
9
+ ValidatorIndex,
10
+ electra,
11
+ } from "@lodestar/types";
12
+ import {LodestarError} from "@lodestar/utils";
13
+ import {CachedBeaconStateAllForks} from "../cache/stateCache.js";
14
+ import {getBlockRootAtSlot} from "./blockRoot.js";
15
+ import {computeStartSlotAtEpoch} from "./epoch.js";
16
+ import {EpochShuffling} from "./epochShuffling.js";
17
+
18
+ /**
19
+ * Returns the block root which decided the proposer shuffling for the current epoch. This root
20
+ * can be used to key this proposer shuffling.
21
+ *
22
+ * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
23
+ * It should be set to the latest block applied to this `state` or the genesis block root.
24
+ */
25
+ export function proposerShufflingDecisionRoot(fork: ForkName, state: CachedBeaconStateAllForks): Root | null {
26
+ const decisionSlot = proposerShufflingDecisionSlot(fork, state);
27
+ if (state.slot === decisionSlot) {
28
+ return null;
29
+ }
30
+ return getBlockRootAtSlot(state, decisionSlot);
31
+ }
32
+
33
+ /**
34
+ * Returns the slot at which the proposer shuffling was decided. The block root at this slot
35
+ * can be used to key the proposer shuffling for the current epoch.
36
+ */
37
+ function proposerShufflingDecisionSlot(fork: ForkName, state: CachedBeaconStateAllForks): Slot {
38
+ // After fulu, the decision slot is in previous epoch due to deterministic proposer lookahead
39
+ const epoch = isForkPostFulu(fork) ? state.epochCtx.epoch - 1 : state.epochCtx.epoch;
40
+ const startSlot = computeStartSlotAtEpoch(epoch);
41
+ return Math.max(startSlot - 1, 0);
42
+ }
43
+
44
+ /**
45
+ * Returns the block root which decided the attester shuffling for the given `requestedEpoch`.
46
+ * This root can be used to key that attester shuffling.
47
+ *
48
+ * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
49
+ * It should be set to the latest block applied to this `state` or the genesis block root.
50
+ */
51
+ export function attesterShufflingDecisionRoot(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Root | null {
52
+ const decisionSlot = attesterShufflingDecisionSlot(state, requestedEpoch);
53
+ if (state.slot === decisionSlot) {
54
+ return null;
55
+ }
56
+ return getBlockRootAtSlot(state, decisionSlot);
57
+ }
58
+
59
+ /**
60
+ * Returns the slot at which the proposer shuffling was decided. The block root at this slot
61
+ * can be used to key the proposer shuffling for the current epoch.
62
+ */
63
+ function attesterShufflingDecisionSlot(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Slot {
64
+ const epoch = attesterShufflingDecisionEpoch(state, requestedEpoch);
65
+ const slot = computeStartSlotAtEpoch(epoch);
66
+ return Math.max(slot - 1, 0);
67
+ }
68
+
69
+ /**
70
+ * Returns the epoch at which the attester shuffling was decided.
71
+ *
72
+ * Spec ref: https://github.com/ethereum/beacon-APIs/blob/v2.1.0/apis/validator/duties/attester.yaml#L15
73
+ *
74
+ * Throws an error when:
75
+ * - `EpochTooLow` when `requestedEpoch` is more than 1 prior to `currentEpoch`.
76
+ * - `EpochTooHigh` when `requestedEpoch` is more than 1 after `currentEpoch`.
77
+ */
78
+ function attesterShufflingDecisionEpoch(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Epoch {
79
+ const currentEpoch = state.epochCtx.epoch;
80
+
81
+ // Next
82
+ if (requestedEpoch === currentEpoch + 1) return currentEpoch;
83
+ // Current
84
+ if (requestedEpoch === currentEpoch) return Math.max(currentEpoch - 1, 0);
85
+ // Previous
86
+ if (requestedEpoch === currentEpoch - 1) return Math.max(currentEpoch - 2, 0);
87
+
88
+ if (requestedEpoch < currentEpoch) {
89
+ throw Error(`EpochTooLow: current ${currentEpoch} requested ${requestedEpoch}`);
90
+ }
91
+ throw Error(`EpochTooHigh: current ${currentEpoch} requested ${requestedEpoch}`);
92
+ }
93
+
94
+ // Copied from lodestar-api package to avoid depending on the package
95
+ export interface AttesterDuty {
96
+ validatorIndex: ValidatorIndex;
97
+ committeeIndex: CommitteeIndex;
98
+ committeeLength: number;
99
+ committeesAtSlot: number;
100
+ validatorCommitteeIndex: number;
101
+ slot: Slot;
102
+ }
103
+
104
+ export function calculateCommitteeAssignments(
105
+ epochShuffling: EpochShuffling,
106
+ requestedValidatorIndices: ValidatorIndex[]
107
+ ): Map<ValidatorIndex, AttesterDuty> {
108
+ const requestedValidatorIndicesSet = new Set(requestedValidatorIndices);
109
+ const duties = new Map<ValidatorIndex, AttesterDuty>();
110
+
111
+ const epochCommittees = epochShuffling.committees;
112
+ for (let epochSlot = 0; epochSlot < SLOTS_PER_EPOCH; epochSlot++) {
113
+ const slotCommittees = epochCommittees[epochSlot];
114
+ for (let i = 0, committeesAtSlot = slotCommittees.length; i < committeesAtSlot; i++) {
115
+ for (let j = 0, committeeLength = slotCommittees[i].length; j < committeeLength; j++) {
116
+ const validatorIndex = slotCommittees[i][j];
117
+ if (requestedValidatorIndicesSet.has(validatorIndex)) {
118
+ duties.set(validatorIndex, {
119
+ validatorIndex,
120
+ committeeLength,
121
+ committeesAtSlot,
122
+ validatorCommitteeIndex: j,
123
+ committeeIndex: i,
124
+ slot: epochShuffling.epoch * SLOTS_PER_EPOCH + epochSlot,
125
+ });
126
+ }
127
+ }
128
+ }
129
+ }
130
+
131
+ return duties;
132
+ }
133
+
134
+ /**
135
+ * Return the indexed attestation corresponding to ``attestation``.
136
+ */
137
+ export function getIndexedAttestation(
138
+ epochShuffling: EpochShuffling,
139
+ fork: ForkSeq,
140
+ attestation: Attestation
141
+ ): IndexedAttestation {
142
+ const {data} = attestation;
143
+ const attestingIndices = getAttestingIndices(epochShuffling, fork, attestation);
144
+
145
+ // sort in-place
146
+ attestingIndices.sort((a, b) => a - b);
147
+ return {
148
+ attestingIndices: attestingIndices,
149
+ data: data,
150
+ signature: attestation.signature,
151
+ };
152
+ }
153
+
154
+ /**
155
+ * Return indices of validators who attestested in `attestation`
156
+ */
157
+ export function getAttestingIndices(epochShuffling: EpochShuffling, fork: ForkSeq, attestation: Attestation): number[] {
158
+ if (fork < ForkSeq.electra) {
159
+ const {aggregationBits, data} = attestation;
160
+ const validatorIndices = getBeaconCommittee(epochShuffling, data.slot, data.index);
161
+
162
+ return aggregationBits.intersectValues(validatorIndices);
163
+ }
164
+ const {aggregationBits, committeeBits, data} = attestation as electra.Attestation;
165
+
166
+ // There is a naming conflict on the term `committeeIndices`
167
+ // In Lodestar it usually means a list of validator indices of participants in a committee
168
+ // In the spec it means a list of committee indices according to committeeBits
169
+ // This `committeeIndices` refers to the latter
170
+ // TODO Electra: resolve the naming conflicts
171
+ const committeeIndices = committeeBits.getTrueBitIndexes();
172
+
173
+ const validatorsByCommittee = getBeaconCommittees(epochShuffling, data.slot, committeeIndices);
174
+
175
+ // Create a new Uint32Array to flatten `validatorsByCommittee`
176
+ const totalLength = validatorsByCommittee.reduce((acc, curr) => acc + curr.length, 0);
177
+ const committeeValidators = new Uint32Array(totalLength);
178
+
179
+ let offset = 0;
180
+ for (const committee of validatorsByCommittee) {
181
+ committeeValidators.set(committee, offset);
182
+ offset += committee.length;
183
+ }
184
+
185
+ return aggregationBits.intersectValues(committeeValidators);
186
+ }
187
+
188
+ /**
189
+ * Return the beacon committee at slot for index.
190
+ */
191
+ export function getBeaconCommittee(epochShuffling: EpochShuffling, slot: Slot, index: CommitteeIndex): Uint32Array {
192
+ return getBeaconCommittees(epochShuffling, slot, [index])[0];
193
+ }
194
+
195
+ /**
196
+ * Return a Uint32Array[] representing committees validator indices
197
+ */
198
+ export function getBeaconCommittees(
199
+ epochShuffling: EpochShuffling,
200
+ slot: Slot,
201
+ indices: CommitteeIndex[]
202
+ ): Uint32Array[] {
203
+ if (indices.length === 0) {
204
+ throw new Error("Attempt to get committees without providing CommitteeIndex");
205
+ }
206
+
207
+ const slotCommittees = epochShuffling.committees[slot % SLOTS_PER_EPOCH];
208
+ const committees = [];
209
+
210
+ for (const index of indices) {
211
+ if (index >= slotCommittees.length) {
212
+ throw new ShufflingError({
213
+ code: ShufflingErrorCode.COMMITTEE_INDEX_OUT_OF_RANGE,
214
+ index,
215
+ maxIndex: slotCommittees.length,
216
+ });
217
+ }
218
+ committees.push(slotCommittees[index]);
219
+ }
220
+
221
+ return committees;
222
+ }
223
+
224
+ export enum ShufflingErrorCode {
225
+ COMMITTEE_INDEX_OUT_OF_RANGE = "SHUFFLING_ERROR_COMMITTEE_INDEX_OUT_OF_RANGE",
226
+ }
227
+
228
+ type ShufflingErrorType = {
229
+ code: ShufflingErrorCode.COMMITTEE_INDEX_OUT_OF_RANGE;
230
+ index: number;
231
+ maxIndex: number;
232
+ };
233
+
234
+ export class ShufflingError extends LodestarError<ShufflingErrorType> {}
@@ -1,12 +0,0 @@
1
- import { CommitteeIndex, Slot, ValidatorIndex } from "@lodestar/types";
2
- import { EpochShuffling } from "./epochShuffling.js";
3
- export interface AttesterDuty {
4
- validatorIndex: ValidatorIndex;
5
- committeeIndex: CommitteeIndex;
6
- committeeLength: number;
7
- committeesAtSlot: number;
8
- validatorCommitteeIndex: number;
9
- slot: Slot;
10
- }
11
- export declare function calculateCommitteeAssignments(epochShuffling: EpochShuffling, requestedValidatorIndices: ValidatorIndex[]): Map<ValidatorIndex, AttesterDuty>;
12
- //# sourceMappingURL=calculateCommitteeAssignments.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"calculateCommitteeAssignments.d.ts","sourceRoot":"","sources":["../../src/util/calculateCommitteeAssignments.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,cAAc,EAAE,IAAI,EAAE,cAAc,EAAC,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AAGnD,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB,EAAE,MAAM,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,cAAc,EAC9B,yBAAyB,EAAE,cAAc,EAAE,GAC1C,GAAG,CAAC,cAAc,EAAE,YAAY,CAAC,CAyBnC"}
@@ -1,26 +0,0 @@
1
- import { SLOTS_PER_EPOCH } from "@lodestar/params";
2
- export function calculateCommitteeAssignments(epochShuffling, requestedValidatorIndices) {
3
- const requestedValidatorIndicesSet = new Set(requestedValidatorIndices);
4
- const duties = new Map();
5
- const epochCommittees = epochShuffling.committees;
6
- for (let epochSlot = 0; epochSlot < SLOTS_PER_EPOCH; epochSlot++) {
7
- const slotCommittees = epochCommittees[epochSlot];
8
- for (let i = 0, committeesAtSlot = slotCommittees.length; i < committeesAtSlot; i++) {
9
- for (let j = 0, committeeLength = slotCommittees[i].length; j < committeeLength; j++) {
10
- const validatorIndex = slotCommittees[i][j];
11
- if (requestedValidatorIndicesSet.has(validatorIndex)) {
12
- duties.set(validatorIndex, {
13
- validatorIndex,
14
- committeeLength,
15
- committeesAtSlot,
16
- validatorCommitteeIndex: j,
17
- committeeIndex: i,
18
- slot: epochShuffling.epoch * SLOTS_PER_EPOCH + epochSlot,
19
- });
20
- }
21
- }
22
- }
23
- }
24
- return duties;
25
- }
26
- //# sourceMappingURL=calculateCommitteeAssignments.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"calculateCommitteeAssignments.js","sourceRoot":"","sources":["../../src/util/calculateCommitteeAssignments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAC,MAAM,kBAAkB,CAAC;AAcjD,MAAM,UAAU,6BAA6B,CAC3C,cAA8B,EAC9B,yBAA2C;IAE3C,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IAEvD,MAAM,eAAe,GAAG,cAAc,CAAC,UAAU,CAAC;IAClD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,eAAe,EAAE,SAAS,EAAE,EAAE,CAAC;QACjE,MAAM,cAAc,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,gBAAgB,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,GAAG,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC;YACpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrF,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC5C,IAAI,4BAA4B,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;oBACrD,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE;wBACzB,cAAc;wBACd,eAAe;wBACf,gBAAgB;wBAChB,uBAAuB,EAAE,CAAC;wBAC1B,cAAc,EAAE,CAAC;wBACjB,IAAI,EAAE,cAAc,CAAC,KAAK,GAAG,eAAe,GAAG,SAAS;qBACzD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -1,20 +0,0 @@
1
- import { ForkName } from "@lodestar/params";
2
- import { Epoch, Root } from "@lodestar/types";
3
- import { CachedBeaconStateAllForks } from "../types.js";
4
- /**
5
- * Returns the block root which decided the proposer shuffling for the current epoch. This root
6
- * can be used to key this proposer shuffling.
7
- *
8
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
9
- * It should be set to the latest block applied to this `state` or the genesis block root.
10
- */
11
- export declare function proposerShufflingDecisionRoot(fork: ForkName, state: CachedBeaconStateAllForks): Root | null;
12
- /**
13
- * Returns the block root which decided the attester shuffling for the given `requestedEpoch`.
14
- * This root can be used to key that attester shuffling.
15
- *
16
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
17
- * It should be set to the latest block applied to this `state` or the genesis block root.
18
- */
19
- export declare function attesterShufflingDecisionRoot(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Root | null;
20
- //# sourceMappingURL=shufflingDecisionRoot.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"shufflingDecisionRoot.d.ts","sourceRoot":"","sources":["../../src/util/shufflingDecisionRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAiB,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAC,KAAK,EAAE,IAAI,EAAO,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,yBAAyB,EAAC,MAAM,aAAa,CAAC;AAItD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI,CAM3G;AAaD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAMlH"}
@@ -1,76 +0,0 @@
1
- import { isForkPostFulu } from "@lodestar/params";
2
- import { getBlockRootAtSlot } from "./blockRoot.js";
3
- import { computeStartSlotAtEpoch } from "./epoch.js";
4
- /**
5
- * Returns the block root which decided the proposer shuffling for the current epoch. This root
6
- * can be used to key this proposer shuffling.
7
- *
8
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
9
- * It should be set to the latest block applied to this `state` or the genesis block root.
10
- */
11
- export function proposerShufflingDecisionRoot(fork, state) {
12
- const decisionSlot = proposerShufflingDecisionSlot(fork, state);
13
- if (state.slot === decisionSlot) {
14
- return null;
15
- }
16
- return getBlockRootAtSlot(state, decisionSlot);
17
- }
18
- /**
19
- * Returns the slot at which the proposer shuffling was decided. The block root at this slot
20
- * can be used to key the proposer shuffling for the current epoch.
21
- */
22
- function proposerShufflingDecisionSlot(fork, state) {
23
- // After fulu, the decision slot is in previous epoch due to deterministic proposer lookahead
24
- const epoch = isForkPostFulu(fork) ? state.epochCtx.epoch - 1 : state.epochCtx.epoch;
25
- const startSlot = computeStartSlotAtEpoch(epoch);
26
- return Math.max(startSlot - 1, 0);
27
- }
28
- /**
29
- * Returns the block root which decided the attester shuffling for the given `requestedEpoch`.
30
- * This root can be used to key that attester shuffling.
31
- *
32
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
33
- * It should be set to the latest block applied to this `state` or the genesis block root.
34
- */
35
- export function attesterShufflingDecisionRoot(state, requestedEpoch) {
36
- const decisionSlot = attesterShufflingDecisionSlot(state, requestedEpoch);
37
- if (state.slot === decisionSlot) {
38
- return null;
39
- }
40
- return getBlockRootAtSlot(state, decisionSlot);
41
- }
42
- /**
43
- * Returns the slot at which the proposer shuffling was decided. The block root at this slot
44
- * can be used to key the proposer shuffling for the current epoch.
45
- */
46
- function attesterShufflingDecisionSlot(state, requestedEpoch) {
47
- const epoch = attesterShufflingDecisionEpoch(state, requestedEpoch);
48
- const slot = computeStartSlotAtEpoch(epoch);
49
- return Math.max(slot - 1, 0);
50
- }
51
- /**
52
- * Returns the epoch at which the attester shuffling was decided.
53
- *
54
- * Spec ref: https://github.com/ethereum/beacon-APIs/blob/v2.1.0/apis/validator/duties/attester.yaml#L15
55
- *
56
- * Throws an error when:
57
- * - `EpochTooLow` when `requestedEpoch` is more than 1 prior to `currentEpoch`.
58
- * - `EpochTooHigh` when `requestedEpoch` is more than 1 after `currentEpoch`.
59
- */
60
- function attesterShufflingDecisionEpoch(state, requestedEpoch) {
61
- const currentEpoch = state.epochCtx.epoch;
62
- // Next
63
- if (requestedEpoch === currentEpoch + 1)
64
- return currentEpoch;
65
- // Current
66
- if (requestedEpoch === currentEpoch)
67
- return Math.max(currentEpoch - 1, 0);
68
- // Previous
69
- if (requestedEpoch === currentEpoch - 1)
70
- return Math.max(currentEpoch - 2, 0);
71
- if (requestedEpoch < currentEpoch) {
72
- throw Error(`EpochTooLow: current ${currentEpoch} requested ${requestedEpoch}`);
73
- }
74
- throw Error(`EpochTooHigh: current ${currentEpoch} requested ${requestedEpoch}`);
75
- }
76
- //# sourceMappingURL=shufflingDecisionRoot.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"shufflingDecisionRoot.js","sourceRoot":"","sources":["../../src/util/shufflingDecisionRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAc,EAAE,KAAgC;IAC5F,MAAM,YAAY,GAAG,6BAA6B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,6BAA6B,CAAC,IAAc,EAAE,KAAgC;IACrF,6FAA6F;IAC7F,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;IACrF,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAgC,EAAE,cAAqB;IACnG,MAAM,YAAY,GAAG,6BAA6B,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IAC1E,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,SAAS,6BAA6B,CAAC,KAAgC,EAAE,cAAqB;IAC5F,MAAM,KAAK,GAAG,8BAA8B,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,8BAA8B,CAAC,KAAgC,EAAE,cAAqB;IAC7F,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC;IAE1C,OAAO;IACP,IAAI,cAAc,KAAK,YAAY,GAAG,CAAC;QAAE,OAAO,YAAY,CAAC;IAC7D,UAAU;IACV,IAAI,cAAc,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1E,WAAW;IACX,IAAI,cAAc,KAAK,YAAY,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9E,IAAI,cAAc,GAAG,YAAY,EAAE,CAAC;QAClC,MAAM,KAAK,CAAC,wBAAwB,YAAY,cAAc,cAAc,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,MAAM,KAAK,CAAC,yBAAyB,YAAY,cAAc,cAAc,EAAE,CAAC,CAAC;AACnF,CAAC"}
@@ -1,43 +0,0 @@
1
- import {SLOTS_PER_EPOCH} from "@lodestar/params";
2
- import {CommitteeIndex, Slot, ValidatorIndex} from "@lodestar/types";
3
- import {EpochShuffling} from "./epochShuffling.js";
4
-
5
- // Copied from lodestar-api package to avoid depending on the package
6
- export interface AttesterDuty {
7
- validatorIndex: ValidatorIndex;
8
- committeeIndex: CommitteeIndex;
9
- committeeLength: number;
10
- committeesAtSlot: number;
11
- validatorCommitteeIndex: number;
12
- slot: Slot;
13
- }
14
-
15
- export function calculateCommitteeAssignments(
16
- epochShuffling: EpochShuffling,
17
- requestedValidatorIndices: ValidatorIndex[]
18
- ): Map<ValidatorIndex, AttesterDuty> {
19
- const requestedValidatorIndicesSet = new Set(requestedValidatorIndices);
20
- const duties = new Map<ValidatorIndex, AttesterDuty>();
21
-
22
- const epochCommittees = epochShuffling.committees;
23
- for (let epochSlot = 0; epochSlot < SLOTS_PER_EPOCH; epochSlot++) {
24
- const slotCommittees = epochCommittees[epochSlot];
25
- for (let i = 0, committeesAtSlot = slotCommittees.length; i < committeesAtSlot; i++) {
26
- for (let j = 0, committeeLength = slotCommittees[i].length; j < committeeLength; j++) {
27
- const validatorIndex = slotCommittees[i][j];
28
- if (requestedValidatorIndicesSet.has(validatorIndex)) {
29
- duties.set(validatorIndex, {
30
- validatorIndex,
31
- committeeLength,
32
- committeesAtSlot,
33
- validatorCommitteeIndex: j,
34
- committeeIndex: i,
35
- slot: epochShuffling.epoch * SLOTS_PER_EPOCH + epochSlot,
36
- });
37
- }
38
- }
39
- }
40
- }
41
-
42
- return duties;
43
- }
@@ -1,81 +0,0 @@
1
- import {ForkName, isForkPostFulu} from "@lodestar/params";
2
- import {Epoch, Root, Slot} from "@lodestar/types";
3
- import {CachedBeaconStateAllForks} from "../types.js";
4
- import {getBlockRootAtSlot} from "./blockRoot.js";
5
- import {computeStartSlotAtEpoch} from "./epoch.js";
6
-
7
- /**
8
- * Returns the block root which decided the proposer shuffling for the current epoch. This root
9
- * can be used to key this proposer shuffling.
10
- *
11
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
12
- * It should be set to the latest block applied to this `state` or the genesis block root.
13
- */
14
- export function proposerShufflingDecisionRoot(fork: ForkName, state: CachedBeaconStateAllForks): Root | null {
15
- const decisionSlot = proposerShufflingDecisionSlot(fork, state);
16
- if (state.slot === decisionSlot) {
17
- return null;
18
- }
19
- return getBlockRootAtSlot(state, decisionSlot);
20
- }
21
-
22
- /**
23
- * Returns the slot at which the proposer shuffling was decided. The block root at this slot
24
- * can be used to key the proposer shuffling for the current epoch.
25
- */
26
- function proposerShufflingDecisionSlot(fork: ForkName, state: CachedBeaconStateAllForks): Slot {
27
- // After fulu, the decision slot is in previous epoch due to deterministic proposer lookahead
28
- const epoch = isForkPostFulu(fork) ? state.epochCtx.epoch - 1 : state.epochCtx.epoch;
29
- const startSlot = computeStartSlotAtEpoch(epoch);
30
- return Math.max(startSlot - 1, 0);
31
- }
32
-
33
- /**
34
- * Returns the block root which decided the attester shuffling for the given `requestedEpoch`.
35
- * This root can be used to key that attester shuffling.
36
- *
37
- * Returns `null` on the one-off scenario where the genesis block decides its own shuffling.
38
- * It should be set to the latest block applied to this `state` or the genesis block root.
39
- */
40
- export function attesterShufflingDecisionRoot(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Root | null {
41
- const decisionSlot = attesterShufflingDecisionSlot(state, requestedEpoch);
42
- if (state.slot === decisionSlot) {
43
- return null;
44
- }
45
- return getBlockRootAtSlot(state, decisionSlot);
46
- }
47
-
48
- /**
49
- * Returns the slot at which the proposer shuffling was decided. The block root at this slot
50
- * can be used to key the proposer shuffling for the current epoch.
51
- */
52
- function attesterShufflingDecisionSlot(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Slot {
53
- const epoch = attesterShufflingDecisionEpoch(state, requestedEpoch);
54
- const slot = computeStartSlotAtEpoch(epoch);
55
- return Math.max(slot - 1, 0);
56
- }
57
-
58
- /**
59
- * Returns the epoch at which the attester shuffling was decided.
60
- *
61
- * Spec ref: https://github.com/ethereum/beacon-APIs/blob/v2.1.0/apis/validator/duties/attester.yaml#L15
62
- *
63
- * Throws an error when:
64
- * - `EpochTooLow` when `requestedEpoch` is more than 1 prior to `currentEpoch`.
65
- * - `EpochTooHigh` when `requestedEpoch` is more than 1 after `currentEpoch`.
66
- */
67
- function attesterShufflingDecisionEpoch(state: CachedBeaconStateAllForks, requestedEpoch: Epoch): Epoch {
68
- const currentEpoch = state.epochCtx.epoch;
69
-
70
- // Next
71
- if (requestedEpoch === currentEpoch + 1) return currentEpoch;
72
- // Current
73
- if (requestedEpoch === currentEpoch) return Math.max(currentEpoch - 1, 0);
74
- // Previous
75
- if (requestedEpoch === currentEpoch - 1) return Math.max(currentEpoch - 2, 0);
76
-
77
- if (requestedEpoch < currentEpoch) {
78
- throw Error(`EpochTooLow: current ${currentEpoch} requested ${requestedEpoch}`);
79
- }
80
- throw Error(`EpochTooHigh: current ${currentEpoch} requested ${requestedEpoch}`);
81
- }