@aztec/stdlib 0.0.1-commit.5476d83 → 0.0.1-commit.59e663cd

package/dest/p2p/checkpoint_attestation.d.ts

@@ -0,0 +1,81 @@
+import { SlotNumber } from '@aztec/foundation/branded-types';
+import { Buffer32 } from '@aztec/foundation/buffer';
+import type { Fr } from '@aztec/foundation/curves/bn254';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import { Signature } from '@aztec/foundation/eth-signature';
+import { BufferReader } from '@aztec/foundation/serialize';
+import type { ZodFor } from '../schemas/index.js';
+import { ConsensusPayload } from './consensus_payload.js';
+import { Gossipable } from './gossipable.js';
+import { TopicType } from './topic_type.js';
+export declare class CheckpointAttestationHash extends Buffer32 {
+    constructor(hash: Buffer);
+}
+/**
+ * CheckpointAttestation
+ *
+ * A validator that has attested to seeing all blocks in a checkpoint
+ * will produce a checkpoint attestation over the checkpoint header.
+ */
+export declare class CheckpointAttestation extends Gossipable {
+    /** The payload of the message, and what the signature is over */
+    readonly payload: ConsensusPayload;
+    /** The signature of the checkpoint attester */
+    readonly signature: Signature;
+    /** The signature from the checkpoint proposer */
+    readonly proposerSignature: Signature;
+    static p2pTopic: TopicType;
+    private sender;
+    private proposer;
+    constructor(
+    /** The payload of the message, and what the signature is over */
+    payload: ConsensusPayload, 
+    /** The signature of the checkpoint attester */
+    signature: Signature, 
+    /** The signature from the checkpoint proposer */
+    proposerSignature: Signature);
+    static get schema(): ZodFor<CheckpointAttestation>;
+    generateP2PMessageIdentifier(): Promise<Buffer32>;
+    get archive(): Fr;
+    get slotNumber(): SlotNumber;
+    /**
+     * Lazily evaluate and cache the signer of the attestation
+     * @returns The signer of the attestation, or undefined if signature recovery fails
+     */
+    getSender(): EthAddress | undefined;
+    /**
+     * Lazily evaluate and cache the proposer of the checkpoint
+     * @returns The proposer of the checkpoint
+     */
+    getProposer(): EthAddress | undefined;
+    getPayload(): Buffer;
+    toBuffer(): Buffer;
+    static fromBuffer(buf: Buffer | BufferReader): CheckpointAttestation;
+    static empty(): CheckpointAttestation;
+    static random(): CheckpointAttestation;
+    getSize(): number;
+    toInspect(): {
+        payload: {
+            header: {
+                lastArchive: `0x${string}`;
+                blockHeadersHash: `0x${string}`;
+                blobsHash: `0x${string}`;
+                inHash: `0x${string}`;
+                epochOutHash: `0x${string}`;
+                slotNumber: SlotNumber;
+                timestamp: bigint;
+                coinbase: `0x${string}`;
+                feeRecipient: `0x${string}`;
+                gasFees: {
+                    feePerDaGas: bigint;
+                    feePerL2Gas: bigint;
+                };
+                totalManaUsed: bigint;
+            };
+            archive: `0x${string}`;
+        };
+        signature: `0x${string}`;
+        proposerSignature: `0x${string}`;
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9hdHRlc3RhdGlvbi5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3AycC9jaGVja3BvaW50X2F0dGVzdGF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM3RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFHcEQsT0FBTyxLQUFLLEVBQUUsRUFBRSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDekQsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDaEUsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQzVELE9BQU8sRUFBRSxZQUFZLEVBQXFCLE1BQU0sNkJBQTZCLENBQUM7QUFJOUUsT0FBTyxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbEQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDMUQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRTdDLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUU1QyxxQkFBYSx5QkFBMEIsU0FBUSxRQUFRO0lBQ3JELFlBQVksSUFBSSxFQUFFLE1BQU0sRUFFdkI7Q0FDRjtBQUVEOzs7OztHQUtHO0FBQ0gscUJBQWEscUJBQXNCLFNBQVEsVUFBVTtJQU9qRCxpRUFBaUU7YUFDakQsT0FBTyxFQUFFLGdCQUFnQjtJQUV6QywrQ0FBK0M7YUFDL0IsU0FBUyxFQUFFLFNBQVM7SUFFcEMsaURBQWlEO2FBQ2pDLGlCQUFpQixFQUFFLFNBQVM7SUFiOUMsT0FBZ0IsUUFBUSxZQUFvQztJQUU1RCxPQUFPLENBQUMsTUFBTSxDQUF5QjtJQUN2QyxPQUFPLENBQUMsUUFBUSxDQUF5QjtJQUV6QztJQUNFLGlFQUFpRTtJQUNqRCxPQUFPLEVBQUUsZ0JBQWdCO0lBRXpDLCtDQUErQztJQUMvQixTQUFTLEVBQUUsU0FBUztJQUVwQyxpREFBaUQ7SUFDakMsaUJBQWlCLEVBQUUsU0FBUyxFQUc3QztJQUVELE1BQU0sS0FBSyxNQUFNLElBQUksTUFBTSxDQUFDLHFCQUFxQixDQUFDLENBUWpEO0lBRVEsNEJBQTRCLElBQUksT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUV6RDtJQUVELElBQUksT0FBTyxJQUFJLEVBQUUsQ0FFaEI7SUFFRCxJQUFJLFVBQVUsSUFBSSxVQUFVLENBRTNCO0lBRUQ7OztPQUdHO0lBQ0gsU0FBUyxJQUFJLFVBQVUsR0FBRyxTQUFTLENBWWxDO0lBRUQ7OztPQUdHO0lBQ0gsV0FBVyxJQUFJLFVBQVUsR0FBRyxTQUFTLENBV3BDO0lBRUQsVUFBVSxJQUFJLE1BQU0sQ0FFbkI7SUFFRCxRQUFRLElBQUksTUFBTSxDQUVqQjtJQUVELE1BQU0sQ0FBQyxVQUFVLENBQUMsR0FBRyxFQUFFLE1BQU0sR0FBRyxZQUFZLEdBQUcscUJBQXFCLENBT25FO0lBRUQsTUFBTSxDQUFDLEtBQUssSUFBSSxxQkFBcUIsQ0FFcEM7SUFFRCxNQUFNLENBQUMsTUFBTSxJQUFJLHFCQUFxQixDQUVyQztJQUVELE9BQU8sSUFBSSxNQUFNLENBRWhCO0lBRUQsU0FBUzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztNQU1SO0NBQ0YifQ==

package/dest/p2p/checkpoint_attestation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint_attestation.d.ts","sourceRoot":"","sources":["../../src/p2p/checkpoint_attestation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAqB,MAAM,6BAA6B,CAAC;AAI9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,qBAAa,yBAA0B,SAAQ,QAAQ;IACrD,YAAY,IAAI,EAAE,MAAM,EAEvB;CACF;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,UAAU;IAOjD,iEAAiE;aACjD,OAAO,EAAE,gBAAgB;IAEzC,+CAA+C;aAC/B,SAAS,EAAE,SAAS;IAEpC,iDAAiD;aACjC,iBAAiB,EAAE,SAAS;IAb9C,OAAgB,QAAQ,YAAoC;IAE5D,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAyB;IAEzC;IACE,iEAAiE;IACjD,OAAO,EAAE,gBAAgB;IAEzC,+CAA+C;IAC/B,SAAS,EAAE,SAAS;IAEpC,iDAAiD;IACjC,iBAAiB,EAAE,SAAS,EAG7C;IAED,MAAM,KAAK,MAAM,IAAI,MAAM,CAAC,qBAAqB,CAAC,CAQjD;IAEQ,4BAA4B,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEzD;IAED,IAAI,OAAO,IAAI,EAAE,CAEhB;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED;;;OAGG;IACH,SAAS,IAAI,UAAU,GAAG,SAAS,CAYlC;IAED;;;OAGG;IACH,WAAW,IAAI,UAAU,GAAG,SAAS,CAWpC;IAED,UAAU,IAAI,MAAM,CAEnB;IAED,QAAQ,IAAI,MAAM,CAEjB;IAED,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,qBAAqB,CAOnE;IAED,MAAM,CAAC,KAAK,IAAI,qBAAqB,CAEpC;IAED,MAAM,CAAC,MAAM,IAAI,qBAAqB,CAErC;IAED,OAAO,IAAI,MAAM,CAEhB;IAED,SAAS;;;;;;;;;;;;;;;;;;;;;;MAMR;CACF"}

package/dest/p2p/{block_attestation.js → checkpoint_attestation.js}

@@ -1,30 +1,32 @@
 import { Buffer32 } from '@aztec/foundation/buffer';
-import { keccak256, tryRecoverAddress } from '@aztec/foundation/crypto';
+import { keccak256 } from '@aztec/foundation/crypto/keccak';
+import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
 import { Signature } from '@aztec/foundation/eth-signature';
 import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
 import { z } from 'zod';
+import { CheckpointProposal } from './checkpoint_proposal.js';
 import { ConsensusPayload } from './consensus_payload.js';
 import { Gossipable } from './gossipable.js';
 import { SignatureDomainSeparator, getHashedSignaturePayloadEthSignedMessage } from './signature_utils.js';
 import { TopicType } from './topic_type.js';
-export class BlockAttestationHash extends Buffer32 {
+export class CheckpointAttestationHash extends Buffer32 {
     constructor(hash){
         super(hash);
     }
 }
 /**
- * BlockAttestation
+ * CheckpointAttestation
  *
- * A validator that has attested to seeing the contents of a block
- * will produce a block attestation over the header of the block
- */ export class BlockAttestation extends Gossipable {
+ * A validator that has attested to seeing all blocks in a checkpoint
+ * will produce a checkpoint attestation over the checkpoint header.
+ */ export class CheckpointAttestation extends Gossipable {
     payload;
     signature;
     proposerSignature;
-    static p2pTopic = TopicType.block_attestation;
+    static p2pTopic = TopicType.checkpoint_attestation;
     sender;
     proposer;
-    constructor(/** The payload of the message, and what the signature is over */ payload, /** The signature of the block attester */ signature, /** The signature from the block proposer */ proposerSignature){
+    constructor(/** The payload of the message, and what the signature is over */ payload, /** The signature of the checkpoint attester */ signature, /** The signature from the checkpoint proposer */ proposerSignature){
         super(), this.payload = payload, this.signature = signature, this.proposerSignature = proposerSignature;
     }
     static get schema() {
@@ -32,10 +34,10 @@ export class BlockAttestationHash extends Buffer32 {
             payload: ConsensusPayload.schema,
             signature: Signature.schema,
             proposerSignature: Signature.schema
-        }).transform((obj)=>new BlockAttestation(obj.payload, obj.signature, obj.proposerSignature));
+        }).transform((obj)=>new CheckpointAttestation(obj.payload, obj.signature, obj.proposerSignature));
     }
     generateP2PMessageIdentifier() {
-        return Promise.resolve(new BlockAttestationHash(keccak256(this.signature.toBuffer())));
+        return Promise.resolve(new CheckpointAttestationHash(keccak256(this.signature.toBuffer())));
     }
     get archive() {
         return this.payload.archive;
@@ -49,26 +51,28 @@ export class BlockAttestationHash extends Buffer32 {
    */ getSender() {
         if (!this.sender) {
             // Recover the sender from the attestation
-            const hashed = getHashedSignaturePayloadEthSignedMessage(this.payload, SignatureDomainSeparator.blockAttestation);
+            const hashed = getHashedSignaturePayloadEthSignedMessage(this.payload, SignatureDomainSeparator.checkpointAttestation);
             // Cache the sender for later use
             this.sender = tryRecoverAddress(hashed, this.signature);
         }
         return this.sender;
     }
     /**
-   * Lazily evaluate and cache the proposer of the block
-   * @returns The proposer of the block
+   * Lazily evaluate and cache the proposer of the checkpoint
+   * @returns The proposer of the checkpoint
    */ getProposer() {
         if (!this.proposer) {
-            // Recover the proposer from the proposal signature
-            const hashed = getHashedSignaturePayloadEthSignedMessage(this.payload, SignatureDomainSeparator.blockProposal);
+            // Create a temporary CheckpointProposal to recover the proposer address.
+            // We need to use CheckpointProposal because it has a different getPayloadToSign()
+            // implementation than ConsensusPayload (uses serializeToBuffer vs ABI encoding).
+            const proposal = new CheckpointProposal(this.payload.header, this.payload.archive, this.proposerSignature);
             // Cache the proposer for later use
-            this.proposer = tryRecoverAddress(hashed, this.proposerSignature);
+            this.proposer = proposal.getSender();
         }
         return this.proposer;
     }
     getPayload() {
-        return this.payload.getPayloadToSign(SignatureDomainSeparator.blockAttestation);
+        return this.payload.getPayloadToSign(SignatureDomainSeparator.checkpointAttestation);
     }
     toBuffer() {
         return serializeToBuffer([
@@ -79,13 +83,13 @@ export class BlockAttestationHash extends Buffer32 {
     }
     static fromBuffer(buf) {
         const reader = BufferReader.asReader(buf);
-        return new BlockAttestation(reader.readObject(ConsensusPayload), reader.readObject(Signature), reader.readObject(Signature));
+        return new CheckpointAttestation(reader.readObject(ConsensusPayload), reader.readObject(Signature), reader.readObject(Signature));
     }
     static empty() {
-        return new BlockAttestation(ConsensusPayload.empty(), Signature.empty(), Signature.empty());
+        return new CheckpointAttestation(ConsensusPayload.empty(), Signature.empty(), Signature.empty());
     }
     static random() {
-        return new BlockAttestation(ConsensusPayload.random(), Signature.random(), Signature.random());
+        return new CheckpointAttestation(ConsensusPayload.random(), Signature.random(), Signature.random());
     }
     getSize() {
         return this.payload.getSize() + this.signature.getSize() + this.proposerSignature.getSize();

package/dest/p2p/checkpoint_proposal.d.ts

@@ -0,0 +1,167 @@
+import { BlockNumber, IndexWithinCheckpoint, SlotNumber } from '@aztec/foundation/branded-types';
+import { Buffer32 } from '@aztec/foundation/buffer';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import type { EthAddress } from '@aztec/foundation/eth-address';
+import { Signature } from '@aztec/foundation/eth-signature';
+import { BufferReader } from '@aztec/foundation/serialize';
+import { type SigningContext } from '@aztec/validator-ha-signer/types';
+import type { L2BlockInfo } from '../block/l2_block_info.js';
+import { CheckpointHeader } from '../rollup/checkpoint_header.js';
+import { BlockHeader } from '../tx/block_header.js';
+import { TxHash } from '../tx/index.js';
+import type { Tx } from '../tx/tx.js';
+import { BlockProposal } from './block_proposal.js';
+import { Gossipable } from './gossipable.js';
+import { SignatureDomainSeparator } from './signature_utils.js';
+import { SignedTxs } from './signed_txs.js';
+import { TopicType } from './topic_type.js';
+export declare class CheckpointProposalHash extends Buffer32 {
+    constructor(hash: Buffer);
+}
+export type CheckpointProposalOptions = {
+    /**
+     * Whether to include the tx objects along with the block proposal.
+     * Dramatically increases size of the payload but eliminates failed reexecutions due to missing txs.
+     */
+    publishFullTxs?: boolean;
+    /**
+     * Whether to generate an invalid checkpoint proposal for broadcasting.
+     * Use only for testing.
+     */
+    broadcastInvalidCheckpointProposal?: boolean;
+};
+/** Data for the last block included in a checkpoint proposal */
+export type CheckpointLastBlockData = {
+    /** The per-block header for the last block in the checkpoint */
+    blockHeader: BlockHeader;
+    /** Index of this block within the checkpoint (should be the last index, e.g., numBlocks - 1) */
+    indexWithinCheckpoint: IndexWithinCheckpoint;
+    /** The sequence of transactions in the last block */
+    txHashes: TxHash[];
+    /** The tx in the last block (optional, for DA guarantees) */
+    txs?: Tx[];
+};
+/** Last block included in a checkpoint proposal */
+export type CheckpointLastBlock = Omit<CheckpointLastBlockData, 'txs'> & {
+    /** The proposer's signature over the block data (separate from checkpoint signature) */
+    signature: Signature;
+    /** The signed transactions in the last block (optional, for DA guarantees) */
+    signedTxs?: SignedTxs;
+};
+/**
+ * A checkpoint proposal is created by the leader of the chain for the last block in a checkpoint.
+ * It includes the aggregated checkpoint header that validators will attest to, plus optionally
+ * the last block's info for nodes to re-execute. This marks the completion of a slot's worth of blocks.
+ */
+export declare class CheckpointProposal extends Gossipable {
+    /** The aggregated checkpoint header for consensus */
+    readonly checkpointHeader: CheckpointHeader;
+    /** Archive root after this checkpoint is applied */
+    readonly archive: Fr;
+    /** The proposer's signature over the checkpoint payload (checkpointHeader + archive) */
+    readonly signature: Signature;
+    /** Optional last block info, including its own signature for BlockProposal extraction */
+    readonly lastBlock?: CheckpointLastBlock | undefined;
+    static p2pTopic: TopicType;
+    private sender;
+    constructor(
+    /** The aggregated checkpoint header for consensus */
+    checkpointHeader: CheckpointHeader, 
+    /** Archive root after this checkpoint is applied */
+    archive: Fr, 
+    /** The proposer's signature over the checkpoint payload (checkpointHeader + archive) */
+    signature: Signature, 
+    /** Optional last block info, including its own signature for BlockProposal extraction */
+    lastBlock?: CheckpointLastBlock | undefined);
+    generateP2PMessageIdentifier(): Promise<Buffer32>;
+    get slotNumber(): SlotNumber;
+    get blockNumber(): BlockNumber;
+    /** Convenience getter for txHashes from lastBlock */
+    get txHashes(): TxHash[];
+    /** Convenience getter for txs from lastBlock */
+    get txs(): Tx[] | undefined;
+    /**
+     * Extract a BlockProposal from the last block info.
+     * Uses inHash from checkpointHeader.contentCommitment.inHash
+     */
+    getBlockProposal(): BlockProposal | undefined;
+    toBlockInfo(): Omit<L2BlockInfo, 'blockNumber'>;
+    /**
+     * Get the payload to sign for this checkpoint proposal.
+     * The signature is over the checkpoint header + archive root (for consensus).
+     */
+    getPayloadToSign(domainSeparator: SignatureDomainSeparator): Buffer;
+    static createProposalFromSigner(checkpointHeader: CheckpointHeader, archiveRoot: Fr, lastBlockInfo: CheckpointLastBlockData | undefined, payloadSigner: (payload: Buffer32, context: SigningContext) => Promise<Signature>): Promise<CheckpointProposal>;
+    /**
+     * Lazily evaluate the sender of the proposal; result is cached.
+     * If there's a lastBlock, also verifies the block proposal sender matches the checkpoint sender.
+     * @returns The sender address, or undefined if signature recovery fails or senders don't match
+     */
+    getSender(): EthAddress | undefined;
+    getPayload(): Buffer<ArrayBufferLike>;
+    toBuffer(): Buffer;
+    static fromBuffer(buf: Buffer | BufferReader): CheckpointProposal;
+    getSize(): number;
+    static empty(): CheckpointProposal;
+    static random(): CheckpointProposal;
+    toInspect(): {
+        checkpointHeader: {
+            lastArchive: `0x${string}`;
+            blockHeadersHash: `0x${string}`;
+            blobsHash: `0x${string}`;
+            inHash: `0x${string}`;
+            epochOutHash: `0x${string}`;
+            slotNumber: SlotNumber;
+            timestamp: bigint;
+            coinbase: `0x${string}`;
+            feeRecipient: `0x${string}`;
+            gasFees: {
+                feePerDaGas: bigint;
+                feePerL2Gas: bigint;
+            };
+            totalManaUsed: bigint;
+        };
+        archive: `0x${string}`;
+        signature: `0x${string}`;
+        lastBlock: {
+            blockHeader: {
+                lastArchive: `0x${string}`;
+                state: {
+                    l1ToL2MessageTree: `0x${string}`;
+                    noteHashTree: `0x${string}`;
+                    nullifierTree: `0x${string}`;
+                    publicDataTree: `0x${string}`;
+                };
+                spongeBlobHash: bigint;
+                globalVariables: {
+                    chainId: number;
+                    version: number;
+                    blockNumber: BlockNumber;
+                    slotNumber: SlotNumber;
+                    timestamp: bigint;
+                    coinbase: `0x${string}`;
+                    feeRecipient: `0x${string}`;
+                    feePerDaGas: number;
+                    feePerL2Gas: number;
+                };
+                totalFees: bigint;
+                totalManaUsed: bigint;
+            };
+            indexWithinCheckpoint: IndexWithinCheckpoint;
+            txHashes: `0x${string}`[];
+            signature: `0x${string}`;
+        } | undefined;
+    };
+    /**
+     * Returns a copy of this proposal without lastBlock info, as a CheckpointProposalCore.
+     * Used when the lastBlock has been extracted and stored separately.
+     */
+    toCore(): CheckpointProposalCore;
+}
+/**
+ * A checkpoint proposal without the lastBlock info.
+ * Used when the lastBlock has been extracted and handled separately as a BlockProposal.
+ * This type makes it clear that lastBlock and getBlockProposal() are not available.
+ */
+export type CheckpointProposalCore = Omit<CheckpointProposal, 'lastBlock' | 'getBlockProposal' | 'toCore'>;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2hlY2twb2ludF9wcm9wb3NhbC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3AycC9jaGVja3BvaW50X3Byb3Bvc2FsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxXQUFXLEVBQUUscUJBQXFCLEVBQUUsVUFBVSxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDakcsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBR3BELE9BQU8sRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNwRCxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUNoRSxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDNUQsT0FBTyxFQUFFLFlBQVksRUFBcUIsTUFBTSw2QkFBNkIsQ0FBQztBQUM5RSxPQUFPLEVBQVksS0FBSyxjQUFjLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUVqRixPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUU3RCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUNsRSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDcEQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ3hDLE9BQU8sS0FBSyxFQUFFLEVBQUUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUN0QyxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDcEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBQzdDLE9BQU8sRUFDTCx3QkFBd0IsRUFHekIsTUFBTSxzQkFBc0IsQ0FBQztBQUM5QixPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0saUJBQWlCLENBQUM7QUFDNUMsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRzVDLHFCQUFhLHNCQUF1QixTQUFRLFFBQVE7SUFDbEQsWUFBWSxJQUFJLEVBQUUsTUFBTSxFQUV2QjtDQUNGO0FBRUQsTUFBTSxNQUFNLHlCQUF5QixHQUFHO0lBQ3RDOzs7T0FHRztJQUNILGNBQWMsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN6Qjs7O09BR0c7SUFDSCxrQ0FBa0MsQ0FBQyxFQUFFLE9BQU8sQ0FBQztDQUM5QyxDQUFDO0FBRUYsZ0VBQWdFO0FBQ2hFLE1BQU0sTUFBTSx1QkFBdUIsR0FBRztJQUNwQyxnRUFBZ0U7SUFDaEUsV0FBVyxFQUFFLFdBQVcsQ0FBQztJQUN6QixnR0FBZ0c7SUFDaEcscUJBQXFCLEVBQUUscUJBQXFCLENBQUM7SUFDN0MscURBQXFEO0lBQ3JELFFBQVEsRUFBRSxNQUFNLEVBQUUsQ0FBQztJQUNuQiw2REFBNkQ7SUFDN0QsR0FBRyxDQUFDLEVBQUUsRUFBRSxFQUFFLENBQUM7Q0FDWixDQUFDO0FBRUYsbURBQW1EO0FBQ25ELE1BQU0sTUFBTSxtQkFBbUIsR0FBRyxJQUFJLENBQUMsdUJBQXVCLEVBQUUsS0FBSyxDQUFDLEdBQUc7SUFDdkUsd0ZBQXdGO0lBQ3hGLFNBQVMsRUFBRSxTQUFTLENBQUM7SUFDckIsOEVBQThFO0lBQzlFLFNBQVMsQ0FBQyxFQUFFLFNBQVMsQ0FBQztDQUN2QixDQUFDO0FBRUY7Ozs7R0FJRztBQUNILHFCQUFhLGtCQUFtQixTQUFRLFVBQVU7SUFNOUMscURBQXFEO2FBQ3JDLGdCQUFnQixFQUFFLGdCQUFnQjtJQUVsRCxvREFBb0Q7YUFDcEMsT0FBTyxFQUFFLEVBQUU7SUFFM0Isd0ZBQXdGO2FBQ3hFLFNBQVMsRUFBRSxTQUFTO0lBRXBDLHlGQUF5RjthQUN6RSxTQUFTLENBQUM7SUFmNUIsT0FBZ0IsUUFBUSxZQUFpQztJQUV6RCxPQUFPLENBQUMsTUFBTSxDQUF5QjtJQUV2QztJQUNFLHFEQUFxRDtJQUNyQyxnQkFBZ0IsRUFBRSxnQkFBZ0I7SUFFbEQsb0RBQW9EO0lBQ3BDLE9BQU8sRUFBRSxFQUFFO0lBRTNCLHdGQUF3RjtJQUN4RSxTQUFTLEVBQUUsU0FBUztJQUVwQyx5RkFBeUY7SUFDekUsU0FBUyxDQUFDLGlDQUFxQixFQUdoRDtJQUVRLDRCQUE0QixJQUFJLE9BQU8sQ0FBQyxRQUFRLENBQUMsQ0FFekQ7SUFFRCxJQUFJLFVBQVUsSUFBSSxVQUFVLENBRTNCO0lBRUQsSUFBSSxXQUFXLElBQUksV0FBVyxDQUs3QjtJQUVELHFEQUFxRDtJQUNyRCxJQUFJLFFBQVEsSUFBSSxNQUFNLEVBQUUsQ0FFdkI7SUFFRCxnREFBZ0Q7SUFDaEQsSUFBSSxHQUFHLElBQUksRUFBRSxFQUFFLEdBQUcsU0FBUyxDQUUxQjtJQUVEOzs7T0FHRztJQUNILGdCQUFnQixJQUFJLGFBQWEsR0FBRyxTQUFTLENBYzVDO0lBRUQsV0FBVyxJQUFJLElBQUksQ0FBQyxXQUFXLEVBQUUsYUFBYSxDQUFDLENBVzlDO0lBRUQ7OztPQUdHO0lBQ0gsZ0JBQWdCLENBQUMsZUFBZSxFQUFFLHdCQUF3QixHQUFHLE1BQU0sQ0FFbEU7SUFFRCxPQUFhLHdCQUF3QixDQUNuQyxnQkFBZ0IsRUFBRSxnQkFBZ0IsRUFDbEMsV0FBVyxFQUFFLEVBQUUsRUFDZixhQUFhLEVBQUUsdUJBQXVCLEdBQUcsU0FBUyxFQUNsRCxhQUFhLEVBQUUsQ0FBQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxjQUFjLEtBQUssT0FBTyxDQUFDLFNBQVMsQ0FBQyxHQUNoRixPQUFPLENBQUMsa0JBQWtCLENBQUMsQ0FpQzdCO0lBRUQ7Ozs7T0FJRztJQUNILFNBQVMsSUFBSSxVQUFVLEdBQUcsU0FBUyxDQW1CbEM7SUFFRCxVQUFVLDRCQUVUO0lBRUQsUUFBUSxJQUFJLE1BQU0sQ0FxQmpCO0lBRUQsTUFBTSxDQUFDLFVBQVUsQ0FBQyxHQUFHLEVBQUUsTUFBTSxHQUFHLFlBQVksR0FBRyxrQkFBa0IsQ0FxQ2hFO0lBRUQsT0FBTyxJQUFJLE1BQU0sQ0FtQmhCO0lBRUQsTUFBTSxDQUFDLEtBQUssSUFBSSxrQkFBa0IsQ0FFakM7SUFFRCxNQUFNLENBQUMsTUFBTSxJQUFJLGtCQUFrQixDQU9sQztJQUVELFNBQVM7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O01BY1I7SUFFRDs7O09BR0c7SUFDSCxNQUFNLElBQUksc0JBQXNCLENBRS9CO0NBQ0Y7QUFFRDs7OztHQUlHO0FBQ0gsTUFBTSxNQUFNLHNCQUFzQixHQUFHLElBQUksQ0FBQyxrQkFBa0IsRUFBRSxXQUFXLEdBQUcsa0JBQWtCLEdBQUcsUUFBUSxDQUFDLENBQUMifQ==

package/dest/p2p/checkpoint_proposal.d.ts.map

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

package/dest/p2p/checkpoint_proposal.js

@@ -0,0 +1,229 @@
+import { BlockNumber, IndexWithinCheckpoint } from '@aztec/foundation/branded-types';
+import { Buffer32 } from '@aztec/foundation/buffer';
+import { keccak256 } from '@aztec/foundation/crypto/keccak';
+import { tryRecoverAddress } from '@aztec/foundation/crypto/secp256k1-signer';
+import { Fr } from '@aztec/foundation/curves/bn254';
+import { Signature } from '@aztec/foundation/eth-signature';
+import { BufferReader, serializeToBuffer } from '@aztec/foundation/serialize';
+import { DutyType } from '@aztec/validator-ha-signer/types';
+import { MAX_TXS_PER_BLOCK } from '../deserialization/index.js';
+import { CheckpointHeader } from '../rollup/checkpoint_header.js';
+import { BlockHeader } from '../tx/block_header.js';
+import { TxHash } from '../tx/index.js';
+import { BlockProposal } from './block_proposal.js';
+import { Gossipable } from './gossipable.js';
+import { SignatureDomainSeparator, getHashedSignaturePayload, getHashedSignaturePayloadEthSignedMessage } from './signature_utils.js';
+import { SignedTxs } from './signed_txs.js';
+import { TopicType } from './topic_type.js';
+// REFACTOR(palla): Use a branded type instead of a subclass of Buffer32
+export class CheckpointProposalHash extends Buffer32 {
+    constructor(hash){
+        super(hash);
+    }
+}
+/**
+ * A checkpoint proposal is created by the leader of the chain for the last block in a checkpoint.
+ * It includes the aggregated checkpoint header that validators will attest to, plus optionally
+ * the last block's info for nodes to re-execute. This marks the completion of a slot's worth of blocks.
+ */ export class CheckpointProposal extends Gossipable {
+    checkpointHeader;
+    archive;
+    signature;
+    lastBlock;
+    static p2pTopic = TopicType.checkpoint_proposal;
+    sender;
+    constructor(/** The aggregated checkpoint header for consensus */ checkpointHeader, /** Archive root after this checkpoint is applied */ archive, /** The proposer's signature over the checkpoint payload (checkpointHeader + archive) */ signature, /** Optional last block info, including its own signature for BlockProposal extraction */ lastBlock){
+        super(), this.checkpointHeader = checkpointHeader, this.archive = archive, this.signature = signature, this.lastBlock = lastBlock;
+    }
+    generateP2PMessageIdentifier() {
+        return Promise.resolve(new CheckpointProposalHash(keccak256(this.signature.toBuffer())));
+    }
+    get slotNumber() {
+        return this.checkpointHeader.slotNumber;
+    }
+    get blockNumber() {
+        if (!this.lastBlock) {
+            throw new Error('Cannot get blockNumber without lastBlock');
+        }
+        return this.lastBlock.blockHeader.getBlockNumber();
+    }
+    /** Convenience getter for txHashes from lastBlock */ get txHashes() {
+        return this.lastBlock?.txHashes ?? [];
+    }
+    /** Convenience getter for txs from lastBlock */ get txs() {
+        return this.lastBlock?.signedTxs?.txs;
+    }
+    /**
+   * Extract a BlockProposal from the last block info.
+   * Uses inHash from checkpointHeader.contentCommitment.inHash
+   */ getBlockProposal() {
+        if (!this.lastBlock) {
+            return undefined;
+        }
+        return new BlockProposal(this.lastBlock.blockHeader, this.lastBlock.indexWithinCheckpoint, this.checkpointHeader.inHash, this.archive, this.lastBlock.txHashes, this.lastBlock.signature, this.lastBlock.signedTxs);
+    }
+    toBlockInfo() {
+        if (!this.lastBlock) {
+            throw new Error('Cannot get blockInfo without lastBlock');
+        }
+        return {
+            slotNumber: this.slotNumber,
+            lastArchive: this.lastBlock.blockHeader.lastArchive.root,
+            timestamp: this.lastBlock.blockHeader.globalVariables.timestamp,
+            archive: this.archive,
+            txCount: this.lastBlock.txHashes.length
+        };
+    }
+    /**
+   * Get the payload to sign for this checkpoint proposal.
+   * The signature is over the checkpoint header + archive root (for consensus).
+   */ getPayloadToSign(domainSeparator) {
+        return serializeToBuffer([
+            domainSeparator,
+            this.checkpointHeader,
+            this.archive
+        ]);
+    }
+    static async createProposalFromSigner(checkpointHeader, archiveRoot, lastBlockInfo, payloadSigner) {
+        // Sign the checkpoint payload with CHECKPOINT_PROPOSAL duty type
+        const tempProposal = new CheckpointProposal(checkpointHeader, archiveRoot, Signature.empty(), undefined);
+        const checkpointHash = getHashedSignaturePayload(tempProposal, SignatureDomainSeparator.checkpointProposal);
+        const checkpointContext = {
+            slot: checkpointHeader.slotNumber,
+            blockNumber: lastBlockInfo?.blockHeader?.globalVariables.blockNumber ?? BlockNumber(0),
+            dutyType: DutyType.CHECKPOINT_PROPOSAL
+        };
+        const checkpointSignature = await payloadSigner(checkpointHash, checkpointContext);
+        if (!lastBlockInfo) {
+            return new CheckpointProposal(checkpointHeader, archiveRoot, checkpointSignature);
+        }
+        const lastBlockProposal = await BlockProposal.createProposalFromSigner(lastBlockInfo.blockHeader, lastBlockInfo.indexWithinCheckpoint, checkpointHeader.inHash, archiveRoot, lastBlockInfo.txHashes, lastBlockInfo.txs, payloadSigner);
+        return new CheckpointProposal(checkpointHeader, archiveRoot, checkpointSignature, {
+            blockHeader: lastBlockInfo.blockHeader,
+            indexWithinCheckpoint: lastBlockInfo.indexWithinCheckpoint,
+            txHashes: lastBlockInfo.txHashes,
+            signature: lastBlockProposal.signature,
+            signedTxs: lastBlockProposal.signedTxs
+        });
+    }
+    /**
+   * Lazily evaluate the sender of the proposal; result is cached.
+   * If there's a lastBlock, also verifies the block proposal sender matches the checkpoint sender.
+   * @returns The sender address, or undefined if signature recovery fails or senders don't match
+   */ getSender() {
+        if (!this.sender) {
+            const hashed = getHashedSignaturePayloadEthSignedMessage(this, SignatureDomainSeparator.checkpointProposal);
+            const checkpointSender = tryRecoverAddress(hashed, this.signature);
+            // If there's a lastBlock, verify the block proposal sender matches
+            if (checkpointSender && this.lastBlock) {
+                const blockProposal = this.getBlockProposal();
+                const blockSender = blockProposal?.getSender();
+                if (!blockSender || !blockSender.equals(checkpointSender)) {
+                    return undefined; // Sender mismatch - fail
+                }
+            }
+            // Cache the sender for later use
+            this.sender = checkpointSender;
+        }
+        return this.sender;
+    }
+    getPayload() {
+        return this.getPayloadToSign(SignatureDomainSeparator.checkpointProposal);
+    }
+    toBuffer() {
+        const buffer = [
+            this.checkpointHeader,
+            this.archive,
+            this.signature
+        ];
+        if (this.lastBlock) {
+            buffer.push(1); // hasLastBlock = true
+            buffer.push(this.lastBlock.blockHeader);
+            buffer.push(this.lastBlock.indexWithinCheckpoint);
+            buffer.push(this.lastBlock.signature);
+            buffer.push(this.lastBlock.txHashes.length);
+            buffer.push(this.lastBlock.txHashes);
+            if (this.lastBlock.signedTxs) {
+                buffer.push(1); // hasSignedTxs = true
+                buffer.push(this.lastBlock.signedTxs.toBuffer());
+            } else {
+                buffer.push(0); // hasSignedTxs = false
+            }
+        } else {
+            buffer.push(0); // hasLastBlock = false
+        }
+        return serializeToBuffer(buffer);
+    }
+    static fromBuffer(buf) {
+        const reader = BufferReader.asReader(buf);
+        const checkpointHeader = reader.readObject(CheckpointHeader);
+        const archive = reader.readObject(Fr);
+        const signature = reader.readObject(Signature);
+        const hasLastBlock = reader.readNumber();
+        if (hasLastBlock) {
+            const blockHeader = reader.readObject(BlockHeader);
+            const indexWithinCheckpoint = IndexWithinCheckpoint(reader.readNumber());
+            const blockSignature = reader.readObject(Signature);
+            const txHashCount = reader.readNumber();
+            if (txHashCount > MAX_TXS_PER_BLOCK) {
+                throw new Error(`txHashes count ${txHashCount} exceeds maximum ${MAX_TXS_PER_BLOCK}`);
+            }
+            const txHashes = reader.readArray(txHashCount, TxHash);
+            let signedTxs;
+            if (!reader.isEmpty()) {
+                const hasSignedTxs = reader.readNumber();
+                if (hasSignedTxs) {
+                    signedTxs = SignedTxs.fromBuffer(reader);
+                }
+            }
+            return new CheckpointProposal(checkpointHeader, archive, signature, {
+                blockHeader,
+                indexWithinCheckpoint,
+                txHashes,
+                signature: blockSignature,
+                signedTxs
+            });
+        }
+        return new CheckpointProposal(checkpointHeader, archive, signature);
+    }
+    getSize() {
+        let size = this.checkpointHeader.toBuffer().length + this.archive.size + this.signature.getSize() + 4; /* hasLastBlock flag */ 
+        if (this.lastBlock) {
+            size += this.lastBlock.blockHeader.getSize() + 4 /* indexWithinCheckpoint */  + this.lastBlock.signature.getSize() + 4 /* txHashes.length */  + this.lastBlock.txHashes.length * TxHash.SIZE + 4 /* hasSignedTxs flag */  + (this.lastBlock.signedTxs ? this.lastBlock.signedTxs.getSize() : 0);
+        }
+        return size;
+    }
+    static empty() {
+        return new CheckpointProposal(CheckpointHeader.empty(), Fr.ZERO, Signature.empty());
+    }
+    static random() {
+        return new CheckpointProposal(CheckpointHeader.random(), Fr.random(), Signature.random(), {
+            blockHeader: BlockHeader.random(),
+            indexWithinCheckpoint: IndexWithinCheckpoint(Math.floor(Math.random() * 5)),
+            txHashes: [
+                TxHash.random(),
+                TxHash.random()
+            ],
+            signature: Signature.random()
+        });
+    }
+    toInspect() {
+        return {
+            checkpointHeader: this.checkpointHeader.toInspect(),
+            archive: this.archive.toString(),
+            signature: this.signature.toString(),
+            lastBlock: this.lastBlock ? {
+                blockHeader: this.lastBlock.blockHeader.toInspect(),
+                indexWithinCheckpoint: this.lastBlock.indexWithinCheckpoint,
+                txHashes: this.lastBlock.txHashes.map((h)=>h.toString()),
+                signature: this.lastBlock.signature.toString()
+            } : undefined
+        };
+    }
+    /**
+   * Returns a copy of this proposal without lastBlock info, as a CheckpointProposalCore.
+   * Used when the lastBlock has been extracted and stored separately.
+   */ toCore() {
+        return new CheckpointProposal(this.checkpointHeader, this.archive, this.signature);
+    }
+}