@lodestar/state-transition 1.41.0-dev.21f758891e → 1.41.0-dev.241ad7952a

package/lib/stateView/beaconStateView.d.ts

@@ -0,0 +1,160 @@
+import { CompactMultiProof } from "@chainsafe/persistent-merkle-tree";
+import { ByteViews } from "@chainsafe/ssz";
+import { BeaconConfig } from "@lodestar/config";
+import { BeaconBlock, BlindedBeaconBlock, BuilderIndex, Bytes32, Epoch, ExecutionPayloadBid, ExecutionPayloadHeader, Root, RootHex, SignedBeaconBlock, SignedBlindedBeaconBlock, Slot, SyncCommittee, ValidatorIndex, capella, electra, fulu, gloas, phase0, rewards } from "@lodestar/types";
+import { Checkpoint, Fork } from "@lodestar/types/phase0";
+import { VoluntaryExitValidity } from "../block/processVoluntaryExit.js";
+import { EffectiveBalanceIncrements } from "../cache/effectiveBalanceIncrements.js";
+import { EpochTransitionCacheOpts } from "../cache/epochTransitionCache.js";
+import { RewardCache } from "../cache/rewardCache.js";
+import { CachedBeaconStateAllForks } from "../cache/stateCache.js";
+import { SyncCommitteeCache } from "../cache/syncCommitteeCache.js";
+import { SyncCommitteeWitness } from "../lightClient/types.js";
+import { StateTransitionModules, StateTransitionOpts } from "../stateTransition.js";
+import { EpochShuffling } from "../util/epochShuffling.js";
+import { IBeaconStateView } from "./interface.js";
+export declare class BeaconStateView implements IBeaconStateView {
+    readonly cachedState: CachedBeaconStateAllForks;
+    private readonly config;
+    private _fork;
+    private _latestBlockHeader;
+    private _currentSyncCommittee;
+    private _nextSyncCommittee;
+    private _previousEpochParticipation;
+    private _currentEpochParticipation;
+    private _latestExecutionPayloadHeader;
+    private _latestBlockHash;
+    private _historicalSummaries;
+    private _pendingPartialWithdrawals;
+    private _pendingConsolidations;
+    private _pendingDeposits;
+    private _proposerLookahead;
+    private _executionPayloadAvailability;
+    private _latestExecutionPayloadBid;
+    constructor(cachedState: CachedBeaconStateAllForks);
+    get slot(): number;
+    get fork(): Fork;
+    get epoch(): number;
+    get genesisTime(): number;
+    get genesisValidatorsRoot(): Root;
+    get eth1Data(): phase0.Eth1Data;
+    get latestBlockHeader(): phase0.BeaconBlockHeader;
+    get previousJustifiedCheckpoint(): Checkpoint;
+    get currentJustifiedCheckpoint(): Checkpoint;
+    get finalizedCheckpoint(): Checkpoint;
+    getBlockRootAtSlot(slot: Slot): Root;
+    getBlockRootAtEpoch(epoch: Epoch): Root;
+    getStateRootAtSlot(slot: Slot): Root;
+    getRandaoMix(epoch: Epoch): Bytes32;
+    get previousEpochParticipation(): Uint8Array;
+    get currentEpochParticipation(): Uint8Array;
+    getPreviousEpochParticipation(validatorIndex: ValidatorIndex): number;
+    getCurrentEpochParticipation(validatorIndex: ValidatorIndex): number;
+    get latestExecutionPayloadHeader(): ExecutionPayloadHeader;
+    /**
+     * Cross-fork accessor for the execution block hash of the most recently included payload.
+     * Pre-gloas: reads from latestExecutionPayloadHeader.blockHash.
+     * Gloas+: reads the dedicated latestBlockHash field (EIP-7732).
+     */
+    get latestBlockHash(): Bytes32;
+    /**
+     * The execution block number of the most recently included payload.
+     * Named payloadBlockNumber (not latestBlockNumber) to mirror ExecutionPayloadHeader.blockNumber pre-gloas.
+     * Only available from bellatrix through fulu — not tracked on BeaconState in gloas+ (EIP-7732).
+     */
+    get payloadBlockNumber(): number;
+    get historicalSummaries(): capella.HistoricalSummaries;
+    get pendingDeposits(): electra.PendingDeposits;
+    get pendingDepositsCount(): number;
+    get pendingPartialWithdrawals(): electra.PendingPartialWithdrawals;
+    get pendingPartialWithdrawalsCount(): number;
+    get pendingConsolidations(): electra.PendingConsolidations;
+    get pendingConsolidationsCount(): number;
+    get proposerLookahead(): fulu.ProposerLookahead;
+    get executionPayloadAvailability(): boolean[];
+    get latestExecutionPayloadBid(): ExecutionPayloadBid;
+    getBuilder(index: BuilderIndex): gloas.Builder;
+    canBuilderCoverBid(builderIndex: BuilderIndex, bidAmount: number): boolean;
+    /**
+     * Return the index of the validator in the PTC committee for the given slot.
+     * return -1 if validator is not in the PTC committee for the given slot.
+     */
+    validatorPTCCommitteeIndex(validatorIndex: ValidatorIndex, slot: Slot): number;
+    getShufflingAtEpoch(epoch: Epoch): EpochShuffling;
+    get previousDecisionRoot(): RootHex;
+    get currentDecisionRoot(): RootHex;
+    get nextDecisionRoot(): RootHex;
+    getShufflingDecisionRoot(epoch: Epoch): RootHex;
+    getPreviousShuffling(): EpochShuffling;
+    getCurrentShuffling(): EpochShuffling;
+    getNextShuffling(): EpochShuffling;
+    get previousProposers(): ValidatorIndex[] | null;
+    get currentProposers(): ValidatorIndex[];
+    get nextProposers(): ValidatorIndex[];
+    getBeaconProposer(slot: number): ValidatorIndex;
+    computeAnchorCheckpoint(): {
+        checkpoint: phase0.Checkpoint;
+        blockHeader: phase0.BeaconBlockHeader;
+    };
+    get currentSyncCommittee(): SyncCommittee;
+    get nextSyncCommittee(): SyncCommittee;
+    get currentSyncCommitteeIndexed(): SyncCommitteeCache;
+    get syncProposerReward(): number;
+    getIndexedSyncCommitteeAtEpoch(epoch: Epoch): SyncCommitteeCache;
+    get effectiveBalanceIncrements(): EffectiveBalanceIncrements;
+    getEffectiveBalanceIncrementsZeroInactive(): EffectiveBalanceIncrements;
+    getBalance(index: number): number;
+    getValidator(index: ValidatorIndex): phase0.Validator;
+    getValidatorsByStatus(statuses: Set<string>, currentEpoch: Epoch): phase0.Validator[];
+    get validatorCount(): number;
+    get activeValidatorCount(): number;
+    getAllValidators(): phase0.Validator[];
+    getAllBalances(): number[];
+    get isExecutionStateType(): boolean;
+    isExecutionEnabled(block: BeaconBlock | BlindedBeaconBlock): boolean;
+    get isMergeTransitionComplete(): boolean;
+    getExpectedWithdrawals(): {
+        expectedWithdrawals: capella.Withdrawal[];
+        processedBuilderWithdrawalsCount: number;
+        processedPartialWithdrawalsCount: number;
+        processedBuildersSweepCount: number;
+        processedValidatorSweepCount: number;
+    };
+    get proposerRewards(): RewardCache;
+    computeBlockRewards(block: BeaconBlock, proposerRewards?: RewardCache): Promise<rewards.BlockRewards>;
+    computeAttestationsRewards(validatorIds?: (ValidatorIndex | string)[]): Promise<rewards.AttestationsRewards>;
+    computeSyncCommitteeRewards(block: BeaconBlock, validatorIds: (ValidatorIndex | string)[]): Promise<rewards.SyncCommitteeRewards>;
+    getLatestWeakSubjectivityCheckpointEpoch(): Epoch;
+    getVoluntaryExitValidity(signedVoluntaryExit: phase0.SignedVoluntaryExit, verifySignature?: boolean): VoluntaryExitValidity;
+    isValidVoluntaryExit(signedVoluntaryExit: phase0.SignedVoluntaryExit, verifySignature: boolean): boolean;
+    getFinalizedRootProof(): Uint8Array[];
+    getSyncCommitteesWitness(): SyncCommitteeWitness;
+    getSingleProof(gindex: bigint): Uint8Array[];
+    createMultiProof(descriptor: Uint8Array): CompactMultiProof;
+    computeUnrealizedCheckpoints(): {
+        justifiedCheckpoint: phase0.Checkpoint;
+        finalizedCheckpoint: phase0.Checkpoint;
+    };
+    get clonedCount(): number;
+    get clonedCountWithTransferCache(): number;
+    get createdWithTransferCache(): boolean;
+    isStateValidatorsNodesPopulated(): boolean;
+    loadOtherState(stateBytes: Uint8Array, seedValidatorsBytes?: Uint8Array): IBeaconStateView;
+    serialize(): Uint8Array;
+    serializedSize(): number;
+    serializeToBytes(output: ByteViews, offset: number): number;
+    serializeValidators(): Uint8Array;
+    serializedValidatorsSize(): number;
+    serializeValidatorsToBytes(output: ByteViews, offset: number): number;
+    hashTreeRoot(): Uint8Array;
+    stateTransition(signedBlock: SignedBeaconBlock | SignedBlindedBeaconBlock, options: StateTransitionOpts, { metrics, validatorMonitor }: StateTransitionModules): IBeaconStateView;
+    processSlots(slot: Slot, epochTransitionCacheOpts?: EpochTransitionCacheOpts & {
+        dontTransferCache?: boolean;
+    }, modules?: StateTransitionModules): IBeaconStateView;
+    processExecutionPayloadEnvelope(signedEnvelope: gloas.SignedExecutionPayloadEnvelope, verify: boolean): void;
+}
+/**
+ * Create BeaconStateView for historical state regen, no need to sync pubkey cache there.
+ */
+export declare function createBeaconStateViewForHistoricalRegen(config: BeaconConfig, stateBytes: Uint8Array): IBeaconStateView;
+//# sourceMappingURL=beaconStateView.d.ts.map

package/lib/stateView/beaconStateView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beaconStateView.d.ts","sourceRoot":"","sources":["../../src/stateView/beaconStateView.ts"],"names":[],"mappings":"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"}