@aztec/p2p 0.0.1-commit.b655e406 → 0.0.1-commit.c0b82b2

package/dest/config.js

@@ -1,11 +1,13 @@
-import { booleanConfigHelper, floatConfigHelper, getConfigFromMappings, getDefaultConfig, numberConfigHelper, pickConfigMappings, secretStringConfigHelper } from '@aztec/foundation/config';
-import { Fr } from '@aztec/foundation/fields';
+import { booleanConfigHelper, getConfigFromMappings, getDefaultConfig, numberConfigHelper, percentageConfigHelper, pickConfigMappings, secretStringConfigHelper } from '@aztec/foundation/config';
+import { Fr } from '@aztec/foundation/curves/bn254';
 import { dataConfigMappings } from '@aztec/kv-store/config';
-import { FunctionSelector } from '@aztec/stdlib/abi';
+import { FunctionSelector } from '@aztec/stdlib/abi/function-selector';
 import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { chainConfigMappings } from '@aztec/stdlib/config';
+import { chainConfigMappings, sharedSequencerConfigMappings } from '@aztec/stdlib/config';
+import { batchTxRequesterConfigMappings } from './services/reqresp/batch-tx-requester/config.js';
 import { p2pReqRespConfigMappings } from './services/reqresp/config.js';
 import { txCollectionConfigMappings } from './services/tx_collection/config.js';
+import { txFileStoreConfigMappings } from './services/tx_file_store/config.js';
 export const DEFAULT_P2P_PORT = 40400;
 export const p2pConfigMappings = {
     p2pEnabled: {
@@ -23,6 +25,11 @@ export const p2pConfigMappings = {
         description: 'The frequency in which to check for new L2 blocks.',
         ...numberConfigHelper(100)
     },
+    slotCheckIntervalMS: {
+        env: 'P2P_SLOT_CHECK_INTERVAL_MS',
+        description: 'The frequency in which to check for new L2 slots.',
+        ...numberConfigHelper(1000)
+    },
     debugDisableColocationPenalty: {
         env: 'DEBUG_P2P_DISABLE_COLOCATION_PENALTY',
         description: 'DEBUG: Disable colocation penalty - NEVER set to true in production',
@@ -205,15 +212,12 @@ export const p2pConfigMappings = {
         description: 'The list of functions calls allowed to run in setup',
         printDefault: ()=>'AuthRegistry, FeeJuice.increase_public_balance, Token.increase_public_balance, FPC.prepare_fee'
     },
-    maxTxPoolSize: {
-        env: 'P2P_MAX_TX_POOL_SIZE',
-        description: 'The maximum cumulative tx size of pending txs (in bytes) before evicting lower priority txs.',
-        ...numberConfigHelper(100_000_000)
-    },
-    txPoolOverflowFactor: {
-        env: 'P2P_TX_POOL_OVERFLOW_FACTOR',
-        description: 'How much the tx pool can overflow before it starts evicting txs. Must be greater than 1',
-        ...floatConfigHelper(1.1)
+    maxPendingTxCount: {
+        env: 'P2P_MAX_PENDING_TX_COUNT',
+        description: 'The maximum number of pending txs before evicting lower priority txs.',
+        // Worst case scenario: Uncompressed public/private tx is ~ 156kb
+        // This implies we are using ~156MB of memory for pending pool
+        ...numberConfigHelper(1_000)
     },
     seenMessageCacheSize: {
         env: 'P2P_SEEN_MSG_CACHE_SIZE',
@@ -235,15 +239,10 @@ export const p2pConfigMappings = {
         description: 'Number of auth attempts to allow before peer is banned. Number is inclusive',
         ...numberConfigHelper(3)
     },
-    dropTransactions: {
-        env: 'P2P_DROP_TX',
-        description: 'True to simulate discarding transactions. - For testing purposes only',
-        ...booleanConfigHelper(false)
-    },
     dropTransactionsProbability: {
         env: 'P2P_DROP_TX_CHANCE',
-        description: 'The probability that a transaction is discarded. - For testing purposes only',
-        ...floatConfigHelper(0)
+        description: 'The probability that a transaction is discarded (0 - 1). - For testing purposes only',
+        ...percentageConfigHelper(0)
     },
     disableTransactions: {
         env: 'TRANSACTIONS_DISABLED',
@@ -255,9 +254,31 @@ export const p2pConfigMappings = {
         description: 'Whether to delete transactions from the pool after a reorg instead of moving them back to pending.',
         ...booleanConfigHelper(false)
     },
+    debugP2PInstrumentMessages: {
+        env: 'DEBUG_P2P_INSTRUMENT_MESSAGES',
+        description: 'Alters the format of p2p messages to include things like broadcast timestamp FOR TESTING ONLY',
+        ...booleanConfigHelper(false)
+    },
+    fishermanMode: {
+        env: 'FISHERMAN_MODE',
+        description: 'Whether to run in fisherman mode: validates all proposals and attestations but does not broadcast attestations or participate in consensus.',
+        ...booleanConfigHelper(false)
+    },
+    broadcastEquivocatedProposals: {
+        description: 'Broadcast block proposals even when a conflicting proposal for the same slot already exists in the pool (for testing purposes only).',
+        ...booleanConfigHelper(false)
+    },
+    minTxPoolAgeMs: {
+        env: 'P2P_MIN_TX_POOL_AGE_MS',
+        description: 'Minimum age (ms) a transaction must have been in the pool before it is eligible for block building.',
+        ...numberConfigHelper(2_000)
+    },
+    ...sharedSequencerConfigMappings,
     ...p2pReqRespConfigMappings,
+    ...batchTxRequesterConfigMappings,
     ...chainConfigMappings,
-    ...txCollectionConfigMappings
+    ...txCollectionConfigMappings,
+    ...txFileStoreConfigMappings
 };
 /**
  * Gets the config values for p2p client from environment variables.

package/dest/enr/generate-enr.d.ts

@@ -14,4 +14,4 @@ export declare function createNodeENR(peerId: PeerId, multiAddrUdp: Multiaddr |
     versions: ComponentsVersions;
 };
 export declare function printENR(enr: string, log: LogFn): Promise<void>;
-//# sourceMappingURL=generate-enr.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZ2VuZXJhdGUtZW5yLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZW5yL2dlbmVyYXRlLWVuci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssRUFBRSxLQUFLLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUNuRCxPQUFPLEVBQUUsS0FBSyxXQUFXLEVBQW9CLE1BQU0sc0JBQXNCLENBQUM7QUFDMUUsT0FBTyxLQUFLLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUVuRSxPQUFPLEtBQUssRUFBRSxNQUFNLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUNoRCxPQUFPLEVBQUUsS0FBSyxTQUFTLEVBQWEsTUFBTSx5QkFBeUIsQ0FBQztBQUNwRSxPQUFPLEVBQUUsR0FBRyxFQUFFLFdBQVcsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBTXRELE9BQU8sRUFBRSxHQUFHLEVBQUUsQ0FBQztBQUVmLHdCQUFzQiwwQkFBMEIsQ0FDOUMsVUFBVSxFQUFFLE1BQU0sRUFDbEIsS0FBSyxFQUFFLE1BQU0sRUFDYixnQkFBZ0IsRUFBRSxNQUFNLEVBQ3hCLFNBQVMsRUFBRSxNQUFNLEdBQ2hCLE9BQU8sQ0FBQztJQUFFLEdBQUcsRUFBRSxXQUFXLENBQUM7SUFBQyxNQUFNLEVBQUUsTUFBTSxDQUFBO0NBQUUsQ0FBQyxDQWEvQztBQUVELHdCQUFnQixhQUFhLENBQzNCLE1BQU0sRUFBRSxNQUFNLEVBQ2QsWUFBWSxFQUFFLFNBQVMsR0FBRyxTQUFTLEVBQ25DLFlBQVksRUFBRSxTQUFTLEdBQUcsU0FBUyxFQUNuQyxXQUFXLEVBQUUsV0FBVyxFQUN4QixjQUFjLEVBQUUsTUFBTSxHQUNyQjtJQUFFLEdBQUcsRUFBRSxXQUFXLENBQUM7SUFBQyxRQUFRLEVBQUUsa0JBQWtCLENBQUE7Q0FBRSxDQWlCcEQ7QUFFRCx3QkFBc0IsUUFBUSxDQUFDLEdBQUcsRUFBRSxNQUFNLEVBQUUsR0FBRyxFQUFFLEtBQUssaUJBWXJEIn0=

package/dest/enr/index.d.ts

@@ -1,2 +1,2 @@
 export * from './generate-enr.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9lbnIvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxtQkFBbUIsQ0FBQyJ9

package/dest/errors/attestation-pool.error.d.ts

@@ -0,0 +1,7 @@
+export declare class AttestationPoolError extends Error {
+    constructor(message?: string);
+}
+export declare class ProposalSlotCapExceededError extends AttestationPoolError {
+    constructor(message?: string);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXR0ZXN0YXRpb24tcG9vbC5lcnJvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Vycm9ycy9hdHRlc3RhdGlvbi1wb29sLmVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLHFCQUFhLG9CQUFxQixTQUFRLEtBQUs7SUFDN0MsWUFBWSxPQUFPLENBQUMsRUFBRSxNQUFNLEVBRzNCO0NBQ0Y7QUFFRCxxQkFBYSw0QkFBNkIsU0FBUSxvQkFBb0I7SUFDcEUsWUFBWSxPQUFPLENBQUMsRUFBRSxNQUFNLEVBRzNCO0NBQ0YifQ==

package/dest/errors/attestation-pool.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attestation-pool.error.d.ts","sourceRoot":"","sources":["../../src/errors/attestation-pool.error.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,OAAO,CAAC,EAAE,MAAM,EAG3B;CACF;AAED,qBAAa,4BAA6B,SAAQ,oBAAoB;IACpE,YAAY,OAAO,CAAC,EAAE,MAAM,EAG3B;CACF"}

package/dest/errors/attestation-pool.error.js

@@ -0,0 +1,12 @@
+export class AttestationPoolError extends Error {
+    constructor(message){
+        super(message);
+        this.name = 'AttestationPoolError';
+    }
+}
+export class ProposalSlotCapExceededError extends AttestationPoolError {
+    constructor(message){
+        super(message);
+        this.name = 'ProposalSlotCapExceededError';
+    }
+}

package/dest/errors/reqresp.error.d.ts

@@ -25,4 +25,4 @@ export declare class CollectiveReqRespTimeoutError extends Error {
 export declare class InvalidResponseError extends Error {
     constructor();
 }
-//# sourceMappingURL=reqresp.error.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVxcmVzcC5lcnJvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Vycm9ycy9yZXFyZXNwLmVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFDSCxxQkFBYSw2QkFBOEIsU0FBUSxLQUFLO0lBQ3RELGNBRUM7Q0FDRjtBQUVEOzs7O0dBSUc7QUFDSCxxQkFBYSw2QkFBOEIsU0FBUSxLQUFLO0lBQ3RELGNBRUM7Q0FDRjtBQUVEOzs7Ozs7O0dBT0c7QUFDSCxxQkFBYSxvQkFBcUIsU0FBUSxLQUFLO0lBQzdDLGNBRUM7Q0FDRiJ9

package/dest/errors/reqresp.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reqresp.error.d.ts","sourceRoot":"","sources":["../../src/errors/reqresp.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;;CAIvD;AAED;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;;CAIvD;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAI9C"}
+{"version":3,"file":"reqresp.error.d.ts","sourceRoot":"","sources":["../../src/errors/reqresp.error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,cAEC;CACF;AAED;;;;GAIG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,cAEC;CACF;AAED;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,cAEC;CACF"}

package/dest/errors/tx-pool.error.d.ts

@@ -0,0 +1,8 @@
+import type { TxPoolRejectionError } from '../mem_pools/tx_pool_v2/eviction/interfaces.js';
+/** Error thrown when a transaction is not added to the mempool. */
+export declare class TxPoolError extends Error {
+    readonly reason: TxPoolRejectionError;
+    readonly data: TxPoolRejectionError;
+    constructor(reason: TxPoolRejectionError);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHgtcG9vbC5lcnJvci5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2Vycm9ycy90eC1wb29sLmVycm9yLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sZ0RBQWdELENBQUM7QUFFM0YsbUVBQW1FO0FBQ25FLHFCQUFhLFdBQVksU0FBUSxLQUFLO2FBR1IsTUFBTSxFQUFFLG9CQUFvQjtJQUZ4RCxTQUFnQixJQUFJLEVBQUUsb0JBQW9CLENBQUM7SUFFM0MsWUFBNEIsTUFBTSxFQUFFLG9CQUFvQixFQUl2RDtDQUNGIn0=

package/dest/errors/tx-pool.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tx-pool.error.d.ts","sourceRoot":"","sources":["../../src/errors/tx-pool.error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAE3F,mEAAmE;AACnE,qBAAa,WAAY,SAAQ,KAAK;aAGR,MAAM,EAAE,oBAAoB;IAFxD,SAAgB,IAAI,EAAE,oBAAoB,CAAC;IAE3C,YAA4B,MAAM,EAAE,oBAAoB,EAIvD;CACF"}

package/dest/errors/tx-pool.error.js

@@ -0,0 +1,9 @@
+/** Error thrown when a transaction is not added to the mempool. */ export class TxPoolError extends Error {
+    reason;
+    data;
+    constructor(reason){
+        super(reason.message), this.reason = reason;
+        this.name = 'TxPoolError';
+        this.data = reason;
+    }
+}

package/dest/index.d.ts

@@ -6,6 +6,7 @@ export * from './enr/index.js';
 export * from './config.js';
 export * from './mem_pools/attestation_pool/index.js';
 export * from './mem_pools/tx_pool/index.js';
+export * from './mem_pools/tx_pool_v2/index.js';
 export * from './msg_validators/index.js';
 export * from './services/index.js';
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguZC50cyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNoRSxZQUFZLEVBQUUsTUFBTSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFFaEQsY0FBYywwQkFBMEIsQ0FBQztBQUN6QyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsZ0JBQWdCLENBQUM7QUFDL0IsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyx1Q0FBdUMsQ0FBQztBQUN0RCxjQUFjLDhCQUE4QixDQUFDO0FBQzdDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYywyQkFBMkIsQ0FBQztBQUMxQyxjQUFjLHFCQUFxQixDQUFDIn0=

package/dest/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC"}

package/dest/index.js

@@ -5,5 +5,6 @@ export * from './enr/index.js';
 export * from './config.js';
 export * from './mem_pools/attestation_pool/index.js';
 export * from './mem_pools/tx_pool/index.js';
+export * from './mem_pools/tx_pool_v2/index.js';
 export * from './msg_validators/index.js';
 export * from './services/index.js';

package/dest/mem_pools/attestation_pool/attestation_pool.d.ts

@@ -1,95 +1,152 @@
-import type { BlockAttestation, BlockProposal } from '@aztec/stdlib/p2p';
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import type { AztecAsyncKVStore } from '@aztec/kv-store';
+import { BlockProposal, CheckpointAttestation, type CheckpointProposalCore } from '@aztec/stdlib/p2p';
+import { type TelemetryClient } from '@aztec/telemetry-client';
+/** Result of trying to add an item (proposal or attestation) to the pool */
+export type TryAddResult = {
+    /** Whether the item was added */
+    added: boolean;
+    /** Whether the exact item already existed */
+    alreadyExists: boolean;
+    /** Count of items for the position. Meaning varies by method:
+     *  - tryAddBlockProposal: proposals at (slot, indexWithinCheckpoint)
+     *  - tryAddCheckpointProposal: proposals at slot
+     *  - tryAddCheckpointAttestation: attestations by this signer for this slot */
+    count: number;
+};
+export declare const MAX_CHECKPOINT_PROPOSALS_PER_SLOT = 5;
+export declare const MAX_BLOCK_PROPOSALS_PER_POSITION = 3;
+/** Maximum attestations a single signer can make per slot before being rejected. */
+export declare const MAX_ATTESTATIONS_PER_SLOT_AND_SIGNER = 3;
+/** Public API interface for attestation pools. Used for typing mocks and test implementations. */
+export type AttestationPoolApi = Pick<AttestationPool, 'tryAddBlockProposal' | 'getBlockProposal' | 'tryAddCheckpointProposal' | 'getCheckpointProposal' | 'addOwnCheckpointAttestations' | 'tryAddCheckpointAttestation' | 'deleteOlderThan' | 'getCheckpointAttestationsForSlot' | 'getCheckpointAttestationsForSlotAndProposal' | 'hasBlockProposalsForSlot' | 'isEmpty'>;
 /**
- * An Attestation Pool contains attestations collected by a validator
+ * Pool for storing attestations and proposals collected by a validator.
  *
- * Attestations that are observed via the p2p network are stored for requests
+ * Attestations and proposals observed via the p2p network are stored for requests
  * from the validator to produce a block, or to serve to other peers.
  */
-export interface AttestationPool {
+export declare class AttestationPool {
+    private store;
+    private log;
+    private metrics;
+    private checkpointAttestations;
+    private checkpointProposals;
+    private checkpointProposalsForSlot;
+    private blockProposals;
+    private blockProposalsForSlotAndIndex;
+    private checkpointAttestationsPerSlotAndSigner;
+    constructor(store: AztecAsyncKVStore, telemetry?: TelemetryClient, log?: import("@aztec/foundation/log").Logger);
+    private poolStats;
+    /** Returns whether the pool is empty. */
+    isEmpty(): Promise<boolean>;
+    private getProposalKey;
+    private getAttestationKey;
+    /** Returns range bounds for querying all attestations for a given slot. */
+    private getAttestationKeyRangeForSlot;
+    /** Returns range bounds for querying all attestations for a given (slot, proposalId). */
+    private getAttestationKeyRangeForProposal;
+    /** Creates a key for the per-signer-per-slot attestation index. Uses padded slot for lexicographic ordering. */
+    private getSlotSignerKey;
+    /** Number of bits reserved for indexWithinCheckpoint in position keys. */
+    private static readonly INDEX_BITS;
+    /** Maximum indexWithinCheckpoint value (2^10 - 1 = 1023). */
+    private static readonly MAX_INDEX;
+    /** Creates a position key for block proposals: (slot << 10) | indexWithinCheckpoint. */
+    private getBlockPositionKey;
     /**
-     * Adds new block proposal to the pool
+     * Attempts to add a block proposal to the pool.
+     *
+     * This method performs validation and addition in a single call:
+     * - Checks if the proposal already exists (returns alreadyExists: true if so)
+     * - Checks if the position has reached the proposal cap (returns added: false if so)
+     * - Adds the proposal if validation passes
+     *
+     * @param blockProposal - The block proposal to add
+     * @returns Result indicating whether the proposal was added and duplicate detection info
      */
-    addBlockProposal(blockProposal: BlockProposal): Promise<void>;
+    tryAddBlockProposal(blockProposal: BlockProposal): Promise<TryAddResult>;
+    /** Gets the count of block proposals for a given position (slot, indexWithinCheckpoint). */
+    private getBlockProposalCountForPosition;
+    private addBlockProposal;
     /**
-     * Get block proposal by it's ID
+     * Get block proposal by its ID.
      *
      * @param id - The ID of the block proposal to retrieve. The ID is proposal.payload.archive
      *
      * @return The block proposal if it exists, otherwise undefined.
      */
     getBlockProposal(id: string): Promise<BlockProposal | undefined>;
+    /** Checks if any block proposals exist for a given slot (at index 0). */
+    hasBlockProposalsForSlot(slot: SlotNumber): Promise<boolean>;
     /**
-     * Check if a block proposal exists in the pool
+     * Attempts to add a checkpoint proposal to the pool.
      *
-     * @param idOrProposal - The ID of the block proposal or the block proposal itself to check. The ID is proposal.payload.archive
+     * This method performs validation and addition in a single call:
+     * - Checks if the proposal already exists (returns alreadyExists: true if so)
+     * - Checks if the slot has reached the proposal cap (returns added: false if so)
+     * - Adds the proposal if validation passes
      *
-     * @return True if the block proposal exists, false otherwise.
-     */
-    hasBlockProposal(idOrProposal: string | BlockProposal): Promise<boolean>;
-    /**
-     * AddAttestations
+     * Note: This method only handles the CheckpointProposalCore. If the original
+     * CheckpointProposal contains a lastBlock, the caller should extract it via
+     * getBlockProposal() and add it separately via tryAddBlockProposal().
      *
-     * @param attestations - Attestations to add into the pool
+     * @param proposal - The checkpoint proposal core to add
+     * @returns Result indicating whether the proposal was added and duplicate detection info
      */
-    addAttestations(attestations: BlockAttestation[]): Promise<void>;
+    tryAddCheckpointProposal(proposal: CheckpointProposalCore): Promise<TryAddResult>;
+    private addCheckpointProposal;
     /**
-     * DeleteAttestation
+     * Get checkpoint proposal by its ID.
      *
-     * @param attestations - Attestations to remove from the pool
-     */
-    deleteAttestations(attestations: BlockAttestation[]): Promise<void>;
-    /**
-     * Delete Attestations with a slot number smaller than the given slot
-     *
-     * Removes all attestations associated with a slot
+     * Returns a CheckpointProposalCore (without lastBlock info) since the lastBlock
+     * is extracted and stored separately as a BlockProposal when added.
      *
-     * @param slot - The oldest slot to keep.
+     * @param id - The ID of the checkpoint proposal to retrieve (proposal.archive)
+     * @return The checkpoint proposal core if it exists, otherwise undefined.
      */
-    deleteAttestationsOlderThan(slot: bigint): Promise<void>;
+    getCheckpointProposal(id: string): Promise<CheckpointProposalCore | undefined>;
     /**
-     * Delete Attestations for slot
-     *
-     * Removes all attestations associated with a slot
-     *
-     * @param slot - The slot to delete.
+     * Adds own checkpoint attestations to the pool.
+     * Skips validations on number of checkpoint attestations stored for the given slot.
      */
-    deleteAttestationsForSlot(slot: bigint): Promise<void>;
+    addOwnCheckpointAttestations(attestations: CheckpointAttestation[]): Promise<void>;
     /**
-     * Delete Attestations for slot and proposal
+     * Get all checkpoint attestations for a given slot.
      *
-     * Removes all attestations associated with a slot and proposal
-     *
-     * @param slot - The slot to delete.
-     * @param proposalId - The proposal to delete.
+     * @param slot - The slot to query
+     * @return CheckpointAttestations
      */
-    deleteAttestationsForSlotAndProposal(slot: bigint, proposalId: string): Promise<void>;
+    getCheckpointAttestationsForSlot(slot: SlotNumber): Promise<CheckpointAttestation[]>;
     /**
-     * Get all Attestations for all proposals for a given slot
-     *
-     * Retrieve all of the attestations observed pertaining to a given slot
+     * Get checkpoint attestations for slot and given proposal.
      *
      * @param slot - The slot to query
-     * @return BlockAttestations
+     * @param proposalId - The proposal to query
+     * @return CheckpointAttestations
      */
-    getAttestationsForSlot(slot: bigint): Promise<BlockAttestation[]>;
+    getCheckpointAttestationsForSlotAndProposal(slot: SlotNumber, proposalId: string): Promise<CheckpointAttestation[]>;
     /**
-     * Get Attestations for slot and given proposal
-     *
-     * Retrieve all of the attestations observed pertaining to a given slot
+     * Delete all pool data (attestations, proposals) older than the given slot.
      *
-     * @param slot - The slot to query
-     * @param proposalId - The proposal to query
-     * @return BlockAttestations
+     * @param oldestSlot - The oldest slot to keep.
      */
-    getAttestationsForSlotAndProposal(slot: bigint, proposalId: string): Promise<BlockAttestation[]>;
+    deleteOlderThan(oldestSlot: SlotNumber): Promise<void>;
     /**
-     * Check if a specific attestation exists in the pool
+     * Attempts to add a checkpoint attestation to the pool.
+     *
+     * This method performs validation and addition in a single call:
+     * - Checks if the attestation already exists (returns alreadyExists: true if so)
+     * - Checks if this signer has reached the per-signer attestation cap for this slot
+     * - Adds the attestation if validation passes
      *
-     * @param attestation - The attestation to check
-     * @return True if the attestation exists, false otherwise
+     * @param attestation - The checkpoint attestation to add
+     * @returns Result indicating whether the attestation was added, existence info, and count of
+     *          attestations by this signer for this slot (for equivocation detection)
      */
-    hasAttestation(attestation: BlockAttestation): Promise<boolean>;
-    /** Returns whether the pool is empty. */
-    isEmpty(): Promise<boolean>;
+    tryAddCheckpointAttestation(attestation: CheckpointAttestation): Promise<TryAddResult>;
+    private getSignerAttestationCountForSlot;
 }
-//# sourceMappingURL=attestation_pool.d.ts.map
+/** Creates an AttestationPool backed by a temporary store for testing. */
+export declare function createTestAttestationPool(telemetry?: TelemetryClient): Promise<AttestationPool>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXR0ZXN0YXRpb25fcG9vbC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL21lbV9wb29scy9hdHRlc3RhdGlvbl9wb29sL2F0dGVzdGF0aW9uX3Bvb2wudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUF5QixVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUlwRixPQUFPLEtBQUssRUFBRSxpQkFBaUIsRUFBcUMsTUFBTSxpQkFBaUIsQ0FBQztBQUM1RixPQUFPLEVBQ0wsYUFBYSxFQUNiLHFCQUFxQixFQUVyQixLQUFLLHNCQUFzQixFQUM1QixNQUFNLG1CQUFtQixDQUFDO0FBQzNCLE9BQU8sRUFBRSxLQUFLLGVBQWUsRUFBc0IsTUFBTSx5QkFBeUIsQ0FBQztBQUluRiw0RUFBNEU7QUFDNUUsTUFBTSxNQUFNLFlBQVksR0FBRztJQUN6QixpQ0FBaUM7SUFDakMsS0FBSyxFQUFFLE9BQU8sQ0FBQztJQUNmLDZDQUE2QztJQUM3QyxhQUFhLEVBQUUsT0FBTyxDQUFDO0lBQ3ZCOzs7bUZBRytFO0lBQy9FLEtBQUssRUFBRSxNQUFNLENBQUM7Q0FDZixDQUFDO0FBRUYsZUFBTyxNQUFNLGlDQUFpQyxJQUFJLENBQUM7QUFDbkQsZUFBTyxNQUFNLGdDQUFnQyxJQUFJLENBQUM7QUFDbEQsb0ZBQW9GO0FBQ3BGLGVBQU8sTUFBTSxvQ0FBb0MsSUFBSSxDQUFDO0FBRXRELGtHQUFrRztBQUNsRyxNQUFNLE1BQU0sa0JBQWtCLEdBQUcsSUFBSSxDQUNuQyxlQUFlLEVBQ2IscUJBQXFCLEdBQ3JCLGtCQUFrQixHQUNsQiwwQkFBMEIsR0FDMUIsdUJBQXVCLEdBQ3ZCLDhCQUE4QixHQUM5Qiw2QkFBNkIsR0FDN0IsaUJBQWlCLEdBQ2pCLGtDQUFrQyxHQUNsQyw2Q0FBNkMsR0FDN0MsMEJBQTBCLEdBQzFCLFNBQVMsQ0FDWixDQUFDO0FBRUY7Ozs7O0dBS0c7QUFDSCxxQkFBYSxlQUFlO0lBMEJ4QixPQUFP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

package/dest/mem_pools/attestation_pool/attestation_pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attestation_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/attestation_pool/attestation_pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9D;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEjE;;;;;;OAMG;IACH,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzE;;;;OAIG;IACH,eAAe,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;OAIG;IACH,kBAAkB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;OAMG;IACH,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;;OAMG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;;;;;;OAOG;IACH,oCAAoC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtF;;;;;;;OAOG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAElE;;;;;;;;OAQG;IACH,iCAAiC,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAEjG;;;;;OAKG;IACH,cAAc,CAAC,WAAW,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhE,yCAAyC;IACzC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"attestation_pool.d.ts","sourceRoot":"","sources":["../../../src/mem_pools/attestation_pool/attestation_pool.ts"],"names":[],"mappings":"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"}