@aztec/stdlib 5.2.0-nightly.20260807 → 5.2.0-nightly.20260809

package/dest/block/l2_block_stream/interfaces.d.ts

@@ -1,4 +1,5 @@
 import type { BlockNumber } from '@aztec/foundation/branded-types';
+import type { BlockHeader } from '../../tx/block_header.js';
 import type { L2Block } from '../l2_block.js';
 import type { CheckpointId, L2BlockId, L2TipId, L2Tips, LocalL2Tips } from '../l2_block_source.js';
 /** Provides the current chain tips. Implemented by world-state, l2-tips-store, and AztecNode. */
@@ -62,13 +63,14 @@ export type L2BlockStreamEvent = /** Emits blocks added to the chain. */ {
     blocks: L2Block[];
 } | /**
  * Reports the new proposed tip of the chain. Emitted once per sync pass when the source's proposed tip differs
- * from the pre-pass local one (downloads, a prune, or a thin tip movement). Carries only the block id; in block
- * mode the corresponding payloads arrive via preceding `blocks-added` events, while in tips-only mode this is the
- * sole signal that the proposed tip moved. Consumers that only track the proposed tip can ignore `blocks-added`
- * entirely and anchor on this event instead.
+ * from the pre-pass local one (downloads, a prune, or a thin tip movement). In block mode the corresponding
+ * payloads also arrive via preceding `blocks-added` events, while in tips-only mode this is the sole signal that
+ * the proposed tip moved. Consumers that only track the proposed tip can ignore `blocks-added` entirely and
+ * anchor on this event instead.
  */ {
     type: 'chain-proposed';
     block: L2BlockId;
+    header: BlockHeader;
 } | /**
  * Reports a new checkpointed tip. Emitted at most once per sync pass when the source's checkpointed tip
  * leads the local one. Carries only the block + checkpoint ids; consumers that need the full checkpoint
@@ -106,4 +108,4 @@ export type L2TipsStore = L2BlockStreamEventHandler & L2TipsProvider & Pick<L2Bl
      */
     recordBlockHashes(blocks: L2BlockId[]): Promise<void>;
 };
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2Jsb2NrL2wyX2Jsb2NrX3N0cmVhbS9pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBRW5FLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzlDLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVuRyxpR0FBaUc7QUFDakcsTUFBTSxXQUFXLGNBQWM7SUFDN0IsU0FBUyxJQUFJLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztDQUNuQztBQUVEOzs7R0FHRztBQUNILE1BQU0sTUFBTSxjQUFjLEdBQUc7SUFBRSxNQUFNLEVBQUUsV0FBVyxDQUFDO0lBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxDQUFBO0NBQUUsQ0FBQztBQUVwRTs7O0dBR0c7QUFDSCxNQUFNLE1BQU0sY0FBYyxHQUFHO0lBQzNCLFFBQVEsRUFBRSxjQUFjLENBQUM7SUFDekIsWUFBWSxDQUFDLEVBQUU7UUFBRSxLQUFLLEVBQUUsY0FBYyxDQUFDO1FBQUMsVUFBVSxFQUFFLFlBQVksQ0FBQTtLQUFFLENBQUM7SUFDbkUsTUFBTSxFQUFFO1FBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQTtLQUFFLENBQUM7SUFDbEMsU0FBUyxFQUFFO1FBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQTtLQUFFLENBQUM7Q0FDdEMsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVcsOEJBQThCO0lBQzdDLFNBQVMsSUFBSSxPQUFPLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDckMsY0FBYyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQztDQUM3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLFVBQVUsRUFBRSxjQUFjLEdBQUcsU0FBUyxFQUFFLFdBQVcsRUFBRSxTQUFTLEdBQUcsT0FBTyxDQVczRztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQU83RTtBQUVELGdEQUFnRDtBQUNoRCxNQUFNLFdBQVcseUJBQXlCO0lBQ3hDLHNCQUFzQixDQUFDLEtBQUssRUFBRSxrQkFBa0IsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDbEU7QUFFRCxNQUFNLE1BQU0sa0JBQWtCLEdBQzFCLHVDQUF1QyxDQUFDO0lBQ3RDLElBQUksRUFBRSxjQUFjLENBQUM7SUFDckIsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFDO0NBQ25CLEdBQ0Q7Ozs7OztHQU1DLENBQUM7SUFDQSxJQUFJLEVBQUUsZ0JBQWdCLENBQUM7SUFDdkIsS0FBSyxFQUFFLFNBQVMsQ0FBQztDQUNsQixHQUNEOzs7O0dBSUMsQ0FBQztJQUNBLElBQUksRUFBRSxvQkFBb0IsQ0FBQztJQUMzQixLQUFLLEVBQUUsU0FBUyxDQUFDO0lBQ2pCLFVBQVUsRUFBRSxZQUFZLENBQUM7Q0FDMUIsR0FDRDs7Ozs7OztHQU9DLENBQUM7SUFDQSxJQUFJLEVBQUUsY0FBYyxDQUFDO0lBQ3JCLEtBQUssRUFBRSxTQUFTLENBQUM7SUFDakIsWUFBWSxFQUFFLE9BQU8sQ0FBQztJQUN0QixNQUFNLEVBQUUsT0FBTyxDQUFDO0NBQ2pCLEdBQ0QsZ0NBQWdDLENBQUM7SUFDL0IsSUFBSSxFQUFFLGNBQWMsQ0FBQztJQUNyQixLQUFLLEVBQUUsU0FBUyxDQUFDO0lBQ2pCLFVBQVUsRUFBRSxZQUFZLENBQUM7Q0FDMUIsR0FDRCxnRUFBZ0UsQ0FBQztJQUMvRCxJQUFJLEVBQUUsaUJBQWlCLENBQUM7SUFDeEIsS0FBSyxFQUFFLFNBQVMsQ0FBQztJQUNqQixVQUFVLEVBQUUsWUFBWSxDQUFDO0NBQzFCLENBQUM7QUFFTixNQUFNLE1BQU0sV0FBVyxHQUFHLHlCQUF5QixHQUNqRCxjQUFjLEdBQ2QsSUFBSSxDQUFDLDhCQUE4QixFQUFFLGdCQUFnQixDQUFDLEdBQUc7SUFDdkQ7Ozs7T0FJRztJQUNILGlCQUFpQixDQUFDLE1BQU0sRUFBRSxTQUFTLEVBQUUsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDdkQsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2Jsb2NrL2wyX2Jsb2NrX3N0cmVhbS9pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBRW5FLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzVELE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQzlDLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxXQUFXLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUVuRyxpR0FBaUc7QUFDakcsTUFBTSxXQUFXLGNBQWM7SUFDN0IsU0FBUyxJQUFJLE9BQU8sQ0FBQyxXQUFXLENBQUMsQ0FBQztDQUNuQztBQUVEOzs7R0FHRztBQUNILE1BQU0sTUFBTSxjQUFjLEdBQUc7SUFBRSxNQUFNLEVBQUUsV0FBVyxDQUFDO0lBQUMsSUFBSSxDQUFDLEVBQUUsTUFBTSxDQUFBO0NBQUUsQ0FBQztBQUVwRTs7O0dBR0c7QUFDSCxNQUFNLE1BQU0sY0FBYyxHQUFHO0lBQzNCLFFBQVEsRUFBRSxjQUFjLENBQUM7SUFDekIsWUFBWSxDQUFDLEVBQUU7UUFBRSxLQUFLLEVBQUUsY0FBYyxDQUFDO1FBQUMsVUFBVSxFQUFFLFlBQVksQ0FBQTtLQUFFLENBQUM7SUFDbkUsTUFBTSxFQUFFO1FBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQTtLQUFFLENBQUM7SUFDbEMsU0FBUyxFQUFFO1FBQUUsS0FBSyxFQUFFLGNBQWMsQ0FBQTtLQUFFLENBQUM7Q0FDdEMsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCxNQUFNLFdBQVcsOEJBQThCO0lBQzdDLFNBQVMsSUFBSSxPQUFPLENBQUMsY0FBYyxDQUFDLENBQUM7SUFDckMsY0FBYyxDQUFDLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUMsQ0FBQztDQUM3RDtBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLG1CQUFtQixDQUFDLFVBQVUsRUFBRSxjQUFjLEdBQUcsU0FBUyxFQUFFLFdBQVcsRUFBRSxTQUFTLEdBQUcsT0FBTyxDQVczRztBQUVEOzs7OztHQUtHO0FBQ0gsd0JBQWdCLGNBQWMsQ0FBQyxLQUFLLEVBQUUsY0FBYyxFQUFFLE1BQU0sRUFBRSxNQUFNLEdBQUcsT0FBTyxDQU83RTtBQUVELGdEQUFnRDtBQUNoRCxNQUFNLFdBQVcseUJBQXlCO0lBQ3hDLHNCQUFzQixDQUFDLEtBQUssRUFBRSxrQkFBa0IsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUM7Q0FDbEU7QUFFRCxNQUFNLE1BQU0sa0JBQWtCLEdBQzFCLHVDQUF1QyxDQUFDO0lBQ3RDLElBQUksRUFBRSxjQUFjLENBQUM7SUFDckIsTUFBTSxFQUFFLE9BQU8sRUFBRSxDQUFDO0NBQ25CLEdBQ0Q7Ozs7OztHQU1DLENBQUM7SUFDQSxJQUFJLEVBQUUsZ0JBQWdCLENBQUM7SUFDdkIsS0FBSyxFQUFFLFNBQVMsQ0FBQztJQUNqQixNQUFNLEVBQUUsV0FBVyxDQUFDO0NBQ3JCLEdBQ0Q7Ozs7R0FJQyxDQUFDO0lBQ0EsSUFBSSxFQUFFLG9CQUFvQixDQUFDO0lBQzNCLEtBQUssRUFBRSxTQUFTLENBQUM7SUFDakIsVUFBVSxFQUFFLFlBQVksQ0FBQztDQUMxQixHQUNEOzs7Ozs7O0dBT0MsQ0FBQztJQUNBLElBQUksRUFBRSxjQUFjLENBQUM7SUFDckIsS0FBSyxFQUFFLFNBQVMsQ0FBQztJQUNqQixZQUFZLEVBQUUsT0FBTyxDQUFDO0lBQ3RCLE1BQU0sRUFBRSxPQUFPLENBQUM7Q0FDakIsR0FDRCxnQ0FBZ0MsQ0FBQztJQUMvQixJQUFJLEVBQUUsY0FBYyxDQUFDO0lBQ3JCLEtBQUssRUFBRSxTQUFTLENBQUM7SUFDakIsVUFBVSxFQUFFLFlBQVksQ0FBQztDQUMxQixHQUNELGdFQUFnRSxDQUFDO0lBQy9ELElBQUksRUFBRSxpQkFBaUIsQ0FBQztJQUN4QixLQUFLLEVBQUUsU0FBUyxDQUFDO0lBQ2pCLFVBQVUsRUFBRSxZQUFZLENBQUM7Q0FDMUIsQ0FBQztBQUVOLE1BQU0sTUFBTSxXQUFXLEdBQUcseUJBQXlCLEdBQ2pELGNBQWMsR0FDZCxJQUFJLENBQUMsOEJBQThCLEVBQUUsZ0JBQWdCLENBQUMsR0FBRztJQUN2RDs7OztPQUlHO0lBQ0gsaUJBQWlCLENBQUMsTUFBTSxFQUFFLFNBQVMsRUFBRSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztDQUN2RCxDQUFDIn0=

package/dest/block/l2_block_stream/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnG,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,UAAU,EAAE,YAAY,CAAA;KAAE,CAAC;IACnE,MAAM,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;IAClC,SAAS,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO,CAW3G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO7E;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,kBAAkB,GAC1B,uCAAuC,CAAC;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB,GACD;;;;;;GAMC,CAAC;IACA,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;CAClB,GACD;;;;GAIC,CAAC;IACA,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,GACD;;;;;;;GAOC,CAAC;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,GACD,gCAAgC,CAAC;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,GACD,gEAAgE,CAAC;IAC/D,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,WAAW,GAAG,yBAAyB,GACjD,cAAc,GACd,IAAI,CAAC,8BAA8B,EAAE,gBAAgB,CAAC,GAAG;IACvD;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEnG,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,cAAc,CAAC;QAAC,UAAU,EAAE,YAAY,CAAA;KAAE,CAAC;IACnE,MAAM,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;IAClC,SAAS,EAAE;QAAE,KAAK,EAAE,cAAc,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;IACrC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,EAAE,WAAW,EAAE,SAAS,GAAG,OAAO,CAW3G;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO7E;AAED,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,kBAAkB,GAC1B,uCAAuC,CAAC;IACtC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB,GACD;;;;;;GAMC,CAAC;IACA,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;CACrB,GACD;;;;GAIC,CAAC;IACA,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,GACD;;;;;;;GAOC,CAAC;IACA,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB,GACD,gCAAgC,CAAC;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,GACD,gEAAgE,CAAC;IAC/D,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEN,MAAM,MAAM,WAAW,GAAG,yBAAyB,GACjD,cAAc,GACd,IAAI,CAAC,8BAA8B,EAAE,gBAAgB,CAAC,GAAG;IACvD;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvD,CAAC"}

package/dest/block/l2_block_stream/l2_block_stream.d.ts

@@ -43,6 +43,7 @@ export declare class L2BlockStream {
     private downloadBlocks;
     private areBlockHashesEqualAt;
     private getBlockHashFromSource;
+    private getHeaderFromSource;
     private emitEvent;
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfYmxvY2tfc3RyZWFtLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX2Jsb2NrX3N0cmVhbS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFNQSxPQUFPLEVBQWtCLEtBQUssYUFBYSxFQUFtQyxNQUFNLHVCQUF1QixDQUFDO0FBQzVHLE9BQU8sRUFFTCxLQUFLLHlCQUF5QixFQUM5QixLQUFLLDhCQUE4QixFQUVwQyxNQUFNLGlCQUFpQixDQUFDO0FBRXpCLHdHQUF3RztBQUN4RyxNQUFNLE1BQU0sbUJBQW1CLEdBQUcsSUFBSSxDQUFDLGFBQWEsRUFBRSxXQUFXLEdBQUcsY0FBYyxHQUFHLFdBQVcsQ0FBQyxDQUFDO0FBRWxHLHNGQUFzRjtBQUN0RixNQUFNLE1BQU0sb0JBQW9CLEdBQUc7SUFDakMsY0FBYyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3hCLFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNuQixhQUFhLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDdkIsa0hBQWtIO0lBQ2xILGFBQWEsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN4QiwySEFBMkg7SUFDM0gsaUJBQWlCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDNUI7Ozs7O09BS0c7SUFDSCxRQUFRLENBQUMsRUFBRSxPQUFPLENBQUM7Q0FDcEIsQ0FBQztBQUVGLHVIQUF1SDtBQUN2SCxxQkFBYSxhQUFhO0lBTXRCLE9BQU8sQ0FBQyxhQUFhO0lBQ3JCLE9BQU8sQ0FBQyxTQUFTO0lBQ2pCLE9BQU8sQ0FBQyxPQUFPO0lBQ2YsT0FBTyxDQUFDLFFBQVEsQ0FBQyxHQUFHO0lBQ3BCLE9BQU8sQ0FBQyxJQUFJO0lBVGQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQWlCO0lBQ2hELE9BQU8sQ0FBQyxTQUFTLENBQVM7SUFDMUIsT0FBTyxDQUFDLFVBQVUsQ0FBUztJQUUzQixZQUNVLGFBQWEsRUFBRSxtQkFBbUIsRUFDbEMsU0FBUyxFQUFFLDhCQUE4QixFQUN6QyxPQUFPLEVBQUUseUJBQXlCLEVBQ3pCLEdBQUcseUNBQXFDLEVBQ2pELElBQUksR0FBRSxvQkFBeUIsRUFheEM7SUFFTSxLQUFLLFNBR1g7SUFFWSxJQUFJLGtCQUVoQjtJQUVNLFNBQVMsWUFFZjtJQUVEOzs7O09BSUc7SUFDVSxJQUFJLGtCQUloQjtJQUVELFVBQWdCLElBQUksa0JBd0luQjtZQVNhLGNBQWM7WUFtRWQscUJBQXFCO0lBd0NuQyxPQUFPLENBQUMsc0JBQXNCO1lBT2hCLFNBQVM7Q0FleEIifQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfYmxvY2tfc3RyZWFtLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svbDJfYmxvY2tfc3RyZWFtL2wyX2Jsb2NrX3N0cmVhbS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFRQSxPQUFPLEVBQWtCLEtBQUssYUFBYSxFQUFtQyxNQUFNLHVCQUF1QixDQUFDO0FBQzVHLE9BQU8sRUFFTCxLQUFLLHlCQUF5QixFQUM5QixLQUFLLDhCQUE4QixFQUVwQyxNQUFNLGlCQUFpQixDQUFDO0FBRXpCLHdHQUF3RztBQUN4RyxNQUFNLE1BQU0sbUJBQW1CLEdBQUcsSUFBSSxDQUFDLGFBQWEsRUFBRSxXQUFXLEdBQUcsY0FBYyxHQUFHLFdBQVcsQ0FBQyxDQUFDO0FBRWxHLHNGQUFzRjtBQUN0RixNQUFNLE1BQU0sb0JBQW9CLEdBQUc7SUFDakMsY0FBYyxDQUFDLEVBQUUsTUFBTSxDQUFDO0lBQ3hCLFNBQVMsQ0FBQyxFQUFFLE1BQU0sQ0FBQztJQUNuQixhQUFhLENBQUMsRUFBRSxNQUFNLENBQUM7SUFDdkIsa0hBQWtIO0lBQ2xILGFBQWEsQ0FBQyxFQUFFLE9BQU8sQ0FBQztJQUN4QiwySEFBMkg7SUFDM0gsaUJBQWlCLENBQUMsRUFBRSxPQUFPLENBQUM7SUFDNUI7Ozs7O09BS0c7SUFDSCxRQUFRLENBQUMsRUFBRSxPQUFPLENBQUM7Q0FDcEIsQ0FBQztBQUVGLHVIQUF1SDtBQUN2SCxxQkFBYSxhQUFhO0lBTXRCLE9BQU8sQ0FBQyxhQUFhO0lBQ3JCLE9BQU8sQ0FBQyxTQUFTO0lBQ2pCLE9BQU8sQ0FBQyxPQUFPO0lBQ2YsT0FBTyxDQUFDLFFBQVEsQ0FBQyxHQUFHO0lBQ3BCLE9BQU8sQ0FBQyxJQUFJO0lBVGQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxjQUFjLENBQWlCO0lBQ2hELE9BQU8sQ0FBQyxTQUFTLENBQVM7SUFDMUIsT0FBTyxDQUFDLFVBQVUsQ0FBUztJQUUzQixZQUNVLGFBQWEsRUFBRSxtQkFBbUIsRUFDbEMsU0FBUyxFQUFFLDhCQUE4QixFQUN6QyxPQUFPLEVBQUUseUJBQXlCLEVBQ3pCLEdBQUcseUNBQXFDLEVBQ2pELElBQUksR0FBRSxvQkFBeUIsRUFheEM7SUFFTSxLQUFLLFNBR1g7SUFFWSxJQUFJLGtCQUVoQjtJQUVNLFNBQVMsWUFFZjtJQUVEOzs7O09BSUc7SUFDVSxJQUFJLGtCQUloQjtJQUVELFVBQWdCLElBQUksa0JBMkpuQjtZQVFhLGNBQWM7WUF1RWQscUJBQXFCO0lBd0NuQyxPQUFPLENBQUMsc0JBQXNCO0lBTzlCLE9BQU8sQ0FBQyxtQkFBbUI7WUFVYixTQUFTO0NBZXhCIn0=

package/dest/block/l2_block_stream/l2_block_stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_block_stream.ts"],"names":[],"mappings":"AAMA,OAAO,EAAkB,KAAK,aAAa,EAAmC,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EAEpC,MAAM,iBAAiB,CAAC;AAEzB,wGAAwG;AACxG,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;AAElG,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2HAA2H;IAC3H,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,uHAAuH;AACvH,qBAAa,aAAa;IAMtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAE3B,YACU,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE,oBAAyB,EAaxC;IAEM,KAAK,SAGX;IAEY,IAAI,kBAEhB;IAEM,SAAS,YAEf;IAED;;;;OAIG;IACU,IAAI,kBAIhB;IAED,UAAgB,IAAI,kBAwInB;YASa,cAAc;YAmEd,qBAAqB;IAwCnC,OAAO,CAAC,sBAAsB;YAOhB,SAAS;CAexB"}
+{"version":3,"file":"l2_block_stream.d.ts","sourceRoot":"","sources":["../../../src/block/l2_block_stream/l2_block_stream.ts"],"names":[],"mappings":"AAQA,OAAO,EAAkB,KAAK,aAAa,EAAmC,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EAEpC,MAAM,iBAAiB,CAAC;AAEzB,wGAAwG;AACxG,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,cAAc,GAAG,WAAW,CAAC,CAAC;AAElG,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAAG;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kHAAkH;IAClH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,2HAA2H;IAC3H,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,uHAAuH;AACvH,qBAAa,aAAa;IAMtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,IAAI;IATd,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAE3B,YACU,aAAa,EAAE,mBAAmB,EAClC,SAAS,EAAE,8BAA8B,EACzC,OAAO,EAAE,yBAAyB,EACzB,GAAG,yCAAqC,EACjD,IAAI,GAAE,oBAAyB,EAaxC;IAEM,KAAK,SAGX;IAEY,IAAI,kBAEhB;IAEM,SAAS,YAEf;IAED;;;;OAIG;IACU,IAAI,kBAIhB;IAED,UAAgB,IAAI,kBA2JnB;YAQa,cAAc;YAuEd,qBAAqB;IAwCnC,OAAO,CAAC,sBAAsB;IAO9B,OAAO,CAAC,mBAAmB;YAUb,SAAS;CAexB"}

package/dest/block/l2_block_stream/l2_block_stream.js

@@ -2,6 +2,7 @@ import { BlockNumber } from '@aztec/foundation/branded-types';
 import { AbortError } from '@aztec/foundation/error';
 import { createLogger } from '@aztec/foundation/log';
 import { RunningPromise } from '@aztec/foundation/running-promise';
+import { BlockHash } from '../block_hash.js';
 import { makeL2BlockId } from '../l2_block_source.js';
 import { localBlockIdDiffers } from './interfaces.js';
 /** Creates a stream of events for new blocks, chain tips updates, and reorgs, out of polling an archiver or a node. */ export class L2BlockStream {
@@ -63,6 +64,12 @@ import { localBlockIdDiffers } from './interfaces.js';
             }
             // Baseline for the chain-proposed event; captured before the local store mutates during the pass.
             const prePassProposed = localTips.proposed;
+            // In tips-only mode there is no download loop to supply the chain-proposed event's header, so it must be
+            // fetched. Start the read now so it runs in parallel with the walk-back below.
+            const prefetch = this.opts.tipsOnly && localBlockIdDiffers(prePassProposed, sourceTips.proposed) ? {
+                hash: sourceTips.proposed.hash,
+                header: this.getHeaderFromSource(sourceTips.proposed.hash)
+            } : undefined;
             // Walk back to find a reorg, floored at the local finalized tip (a legitimate reorg can never reach it, since
             // finalized means the proving tx is itself L1-finalized). Seed the cache with ONLY the proposed tip: a stale
             // tier seed at a reorged height equals the local old-fork hash, faking agreement and stopping the walk above the
@@ -122,18 +129,28 @@ import { localBlockIdDiffers } from './interfaces.js';
                 pruned = true;
             }
             // Pass atomicity: a prune mid-download leaves the source unable to serve the planned blocks, so the snapshot's
-            // tier tips may reference blocks the consumer never saw — skip tier reconciliation in that case. Tips-only mode
-            // has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
-            if (!this.opts.tipsOnly && !await this.downloadBlocks(latestBlockNumber, sourceTips)) {
-                return;
-            }
+            // tier tips may reference blocks the consumer never saw — downloadBlocks aborts the pass in that case.
+            // Tips-only mode has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
+            const deliveredProposedHeader = this.opts.tipsOnly ? undefined : await this.downloadBlocks(latestBlockNumber, sourceTips);
             // End-of-pass reconciliation: chain-proposed fires against the pre-pass baseline (a post-prune re-read would
             // equal the source tip and suppress it), then the tiers highest-to-lowest so the finalized <= proven <=
             // checkpointed <= proposed invariant holds mid-pass.
             if (localBlockIdDiffers(prePassProposed, sourceTips.proposed)) {
+                const availableHeader = prefetch?.hash === sourceTips.proposed.hash ? await prefetch.header : deliveredProposedHeader;
+                const header = availableHeader ?? await this.getHeaderFromSource(sourceTips.proposed.hash);
+                if (header === undefined) {
+                    // Abort the pass rather than skip just this event: the later tier events must not get ahead of a
+                    // proposed tip the consumer never received. Nothing advanced, so the next pass retries.
+                    this.log.warn(`No header for the proposed tip; aborting this sync pass`, {
+                        blockNumber: sourceTips.proposed.number,
+                        blockHash: sourceTips.proposed.hash
+                    });
+                    throw new AbortError();
+                }
                 await this.emitEvent({
                     type: 'chain-proposed',
-                    block: sourceTips.proposed
+                    block: sourceTips.proposed,
+                    header
                 });
             }
             const reconcileTips = pruned ? await this.localData.getL2Tips() : localTips;
@@ -166,11 +183,10 @@ import { localBlockIdDiffers } from './interfaces.js';
         }
     }
     /**
-   * Downloads every block from the post-prune cursor through the source's proposed tip, emitting `blocks-added`
-   * events. The return value gates tier-cursor advancement (pass atomicity): tier tips may only be reconciled when
-   * the plan that backs them ran to the proposed tip.
-   * @returns `true` if the plan completed (caught up, or delivered the proposed tip with a matching hash); `false` if
-   * the source no longer has a promised block, or served a fork at the proposed height mid-pass.
+   * Delivers every block from the agreed-on point through the advertised proposed tip as `blocks-added` events,
+   * aborting the pass when the source's own answers prove that tip is no longer real.
+   * @returns The delivered tip's header, so the caller can avoid a re-fetch; undefined when there was nothing to
+   * download (already at the tip, or startingBlock past it).
    */ async downloadBlocks(latestBlockNumber, sourceTips) {
         // The post-prune cursor: the highest block number both sides agree on. Block downloads resume from here.
         let nextBlockNumber = latestBlockNumber + 1;
@@ -199,12 +215,12 @@ import { localBlockIdDiffers } from './interfaces.js';
             if (blocks.length === 0) {
                 // The source no longer has a block the snapshot promised: the snapshot is provably stale, so report the plan
                 // incomplete and skip reconciliation this pass.
-                this.log.warn(`Block source returned no blocks for a promised range; skipping reconciliation this pass`, {
+                this.log.warn(`Block source returned no blocks for a promised range; aborting this sync pass`, {
                     from: nextBlockNumber,
                     limit,
                     sourceProposed: sourceTips.proposed.number
                 });
-                return false;
+                throw new AbortError();
             }
             await this.emitEvent({
                 type: 'blocks-added',
@@ -214,21 +230,22 @@ import { localBlockIdDiffers } from './interfaces.js';
             nextBlockNumber = lastDeliveredBlock.number + 1;
         }
         if (lastDeliveredBlock === undefined) {
-            // Loop never ran: caught up before the plan started, or startingBlock past the tip (A-1061). Trivially complete.
-            return true;
+            // Loop never ran (caught up before the plan started, or startingBlock past the tip, see A-1061), so nothing
+            // was downloaded that could disprove the snapshot.
+            return undefined;
         }
-        // Complete iff the block delivered at the proposed height carries the snapshot's proposed hash; a different hash
-        // means a same-height fork swap happened mid-pass, so the snapshot is stale.
+        // The block delivered at the proposed height must carry the snapshot's proposed hash; a different hash means a
+        // same-height fork swap happened mid-pass, so the snapshot is stale.
         const deliveredHash = (await lastDeliveredBlock.hash()).toString();
         if (deliveredHash !== sourceTips.proposed.hash) {
-            this.log.warn(`Delivered proposed-block hash differs from snapshot; skipping reconciliation this pass`, {
+            this.log.warn(`Delivered proposed-block hash differs from snapshot; aborting this sync pass`, {
                 blockNumber: lastDeliveredBlock.number,
                 deliveredHash,
                 snapshotHash: sourceTips.proposed.hash
             });
-            return false;
+            throw new AbortError();
         }
-        return true;
+        return lastDeliveredBlock.header;
     }
     /**
    * Returns whether the source and local agree on the block hash at a given height.
@@ -280,6 +297,16 @@ import { localBlockIdDiffers } from './interfaces.js';
             number: blockNumber
         }).then((d)=>d?.header.hash()).then((hash)=>hash?.toString());
     }
+    getHeaderFromSource(hash) {
+        return this.l2BlockSource.getBlockData({
+            hash: BlockHash.fromString(hash)
+        }).then((data)=>data?.header).catch((err)=>{
+            this.log.error(`Failed to read header for block`, err, {
+                blockHash: hash
+            });
+            return undefined;
+        });
+    }
     async emitEvent(event) {
         this.log.debug(`Emitting ${event.type} (${event.type === 'blocks-added' ? event.blocks.length : event.type === 'chain-checkpointed' ? event.checkpoint.number : event.block.number})`);
         await this.handler.handleBlockStreamEvent(event);

package/dest/block/test/l2_tips_store_test_suite.d.ts

@@ -1,3 +1,3 @@
 import type { L2TipsStore } from '../l2_block_stream/index.js';
 export declare function testL2TipsStore(makeTipsStore: () => Promise<L2TipsStore>): void;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV90ZXN0X3N1aXRlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svdGVzdC9sMl90aXBzX3N0b3JlX3Rlc3Rfc3VpdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBZ0JBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRS9ELHdCQUFnQixlQUFlLENBQUMsYUFBYSxFQUFFLE1BQU0sT0FBTyxDQUFDLFdBQVcsQ0FBQyxRQSt2QnhFIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibDJfdGlwc19zdG9yZV90ZXN0X3N1aXRlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYmxvY2svdGVzdC9sMl90aXBzX3N0b3JlX3Rlc3Rfc3VpdGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBaUJBLE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBRS9ELHdCQUFnQixlQUFlLENBQUMsYUFBYSxFQUFFLE1BQU0sT0FBTyxDQUFDLFdBQVcsQ0FBQyxRQW13QnhFIn0=

package/dest/block/test/l2_tips_store_test_suite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"l2_tips_store_test_suite.d.ts","sourceRoot":"","sources":["../../../src/block/test/l2_tips_store_test_suite.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,QA+vBxE"}
+{"version":3,"file":"l2_tips_store_test_suite.d.ts","sourceRoot":"","sources":["../../../src/block/test/l2_tips_store_test_suite.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,QAmwBxE"}

package/dest/block/test/l2_tips_store_test_suite.js

@@ -3,6 +3,7 @@ import { times } from '@aztec/foundation/collection';
 import { Fr } from '@aztec/foundation/curves/bn254';
 import { GENESIS_CHECKPOINT_HEADER_HASH, L2Block } from '@aztec/stdlib/block';
 import { Checkpoint, L1PublishedData, PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
+import { BlockHeader } from '@aztec/stdlib/tx';
 import { expect } from 'vitest';
 import { GENESIS_BLOCK_HEADER_HASH } from '../block_hash.js';
 export function testL2TipsStore(makeTipsStore) {
@@ -121,7 +122,8 @@ export function testL2TipsStore(makeTipsStore) {
             block: {
                 number: BlockNumber(5),
                 hash: new Fr(500).toString()
-            }
+            },
+            header: BlockHeader.empty()
         });
         const tips = await tipsStore.getL2Tips();
         expect(tips.proposed).toEqual({
@@ -138,14 +140,16 @@ export function testL2TipsStore(makeTipsStore) {
             block: {
                 number: BlockNumber(4),
                 hash: new Fr(400).toString()
-            }
+            },
+            header: BlockHeader.empty()
         });
         await tipsStore.handleBlockStreamEvent({
             type: 'chain-proposed',
             block: {
                 number: BlockNumber(9),
                 hash: new Fr(900).toString()
-            }
+            },
+            header: BlockHeader.empty()
         });
         // Both recorded heights resolve; the heights between them were never seen and stay undefined.
         expect(await tipsStore.getL2BlockHash(4)).toEqual(new Fr(400).toString());
@@ -164,7 +168,8 @@ export function testL2TipsStore(makeTipsStore) {
             block: {
                 number: BlockNumber(9),
                 hash: new Fr(900).toString()
-            }
+            },
+            header: BlockHeader.empty()
         });
         // Record sparse witnesses at heights below the tip (e.g. a consumer materializing per-height state).
         await tipsStore.recordBlockHashes([

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aztec/stdlib",
-  "version": "5.2.0-nightly.20260807",
+  "version": "5.2.0-nightly.20260809",
   "type": "module",
   "inherits": [
     "../package.common.json",
@@ -92,13 +92,13 @@
   },
   "dependencies": {
     "@aws-sdk/client-s3": "^3.892.0",
-    "@aztec/bb.js": "5.2.0-nightly.20260807",
-    "@aztec/blob-lib": "5.2.0-nightly.20260807",
-    "@aztec/constants": "5.2.0-nightly.20260807",
-    "@aztec/ethereum": "5.2.0-nightly.20260807",
-    "@aztec/foundation": "5.2.0-nightly.20260807",
-    "@aztec/l1-artifacts": "5.2.0-nightly.20260807",
-    "@aztec/noir-noirc_abi": "5.2.0-nightly.20260807",
+    "@aztec/bb.js": "5.2.0-nightly.20260809",
+    "@aztec/blob-lib": "5.2.0-nightly.20260809",
+    "@aztec/constants": "5.2.0-nightly.20260809",
+    "@aztec/ethereum": "5.2.0-nightly.20260809",
+    "@aztec/foundation": "5.2.0-nightly.20260809",
+    "@aztec/l1-artifacts": "5.2.0-nightly.20260809",
+    "@aztec/noir-noirc_abi": "5.2.0-nightly.20260809",
     "@google-cloud/storage": "^7.15.0",
     "axios": "^1.15.1",
     "json-stringify-deterministic": "1.0.12",

package/src/block/l2_block_stream/interfaces.ts

@@ -1,5 +1,6 @@
 import type { BlockNumber } from '@aztec/foundation/branded-types';
 
+import type { BlockHeader } from '../../tx/block_header.js';
 import type { L2Block } from '../l2_block.js';
 import type { CheckpointId, L2BlockId, L2TipId, L2Tips, LocalL2Tips } from '../l2_block_source.js';
 
@@ -81,13 +82,14 @@ export type L2BlockStreamEvent =
     }
   | /**
    * Reports the new proposed tip of the chain. Emitted once per sync pass when the source's proposed tip differs
-   * from the pre-pass local one (downloads, a prune, or a thin tip movement). Carries only the block id; in block
-   * mode the corresponding payloads arrive via preceding `blocks-added` events, while in tips-only mode this is the
-   * sole signal that the proposed tip moved. Consumers that only track the proposed tip can ignore `blocks-added`
-   * entirely and anchor on this event instead.
+   * from the pre-pass local one (downloads, a prune, or a thin tip movement). In block mode the corresponding
+   * payloads also arrive via preceding `blocks-added` events, while in tips-only mode this is the sole signal that
+   * the proposed tip moved. Consumers that only track the proposed tip can ignore `blocks-added` entirely and
+   * anchor on this event instead.
    */ {
       type: 'chain-proposed';
       block: L2BlockId;
+      header: BlockHeader;
     }
   | /**
    * Reports a new checkpointed tip. Emitted at most once per sync pass when the source's checkpointed tip

package/src/block/l2_block_stream/l2_block_stream.ts

@@ -3,6 +3,8 @@ import { AbortError } from '@aztec/foundation/error';
 import { createLogger } from '@aztec/foundation/log';
 import { RunningPromise } from '@aztec/foundation/running-promise';
 
+import type { BlockHeader } from '../../tx/block_header.js';
+import { BlockHash } from '../block_hash.js';
 import type { L2Block } from '../l2_block.js';
 import { type L2BlockId, type L2BlockSource, type LocalL2Tips, makeL2BlockId } from '../l2_block_source.js';
 import {
@@ -100,6 +102,13 @@ export class L2BlockStream {
       // Baseline for the chain-proposed event; captured before the local store mutates during the pass.
       const prePassProposed = localTips.proposed;
 
+      // In tips-only mode there is no download loop to supply the chain-proposed event's header, so it must be
+      // fetched. Start the read now so it runs in parallel with the walk-back below.
+      const prefetch: ProposedHeaderPrefetch | undefined =
+        this.opts.tipsOnly && localBlockIdDiffers(prePassProposed, sourceTips.proposed)
+          ? { hash: sourceTips.proposed.hash, header: this.getHeaderFromSource(sourceTips.proposed.hash) }
+          : undefined;
+
       // Walk back to find a reorg, floored at the local finalized tip (a legitimate reorg can never reach it, since
       // finalized means the proving tx is itself L1-finalized). Seed the cache with ONLY the proposed tip: a stale
       // tier seed at a reorged height equals the local old-fork hash, faking agreement and stopping the walk above the
@@ -169,17 +178,29 @@ export class L2BlockStream {
       }
 
       // Pass atomicity: a prune mid-download leaves the source unable to serve the planned blocks, so the snapshot's
-      // tier tips may reference blocks the consumer never saw — skip tier reconciliation in that case. Tips-only mode
-      // has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
-      if (!this.opts.tipsOnly && !(await this.downloadBlocks(latestBlockNumber, sourceTips))) {
-        return;
-      }
+      // tier tips may reference blocks the consumer never saw — downloadBlocks aborts the pass in that case.
+      // Tips-only mode has no download plan (the snapshot is one atomic getL2Tips read), so it always reconciles.
+      const deliveredProposedHeader = this.opts.tipsOnly
+        ? undefined
+        : await this.downloadBlocks(latestBlockNumber, sourceTips);
 
       // End-of-pass reconciliation: chain-proposed fires against the pre-pass baseline (a post-prune re-read would
       // equal the source tip and suppress it), then the tiers highest-to-lowest so the finalized <= proven <=
       // checkpointed <= proposed invariant holds mid-pass.
       if (localBlockIdDiffers(prePassProposed, sourceTips.proposed)) {
-        await this.emitEvent({ type: 'chain-proposed', block: sourceTips.proposed });
+        const availableHeader =
+          prefetch?.hash === sourceTips.proposed.hash ? await prefetch.header : deliveredProposedHeader;
+        const header = availableHeader ?? (await this.getHeaderFromSource(sourceTips.proposed.hash));
+        if (header === undefined) {
+          // Abort the pass rather than skip just this event: the later tier events must not get ahead of a
+          // proposed tip the consumer never received. Nothing advanced, so the next pass retries.
+          this.log.warn(`No header for the proposed tip; aborting this sync pass`, {
+            blockNumber: sourceTips.proposed.number,
+            blockHash: sourceTips.proposed.hash,
+          });
+          throw new AbortError();
+        }
+        await this.emitEvent({ type: 'chain-proposed', block: sourceTips.proposed, header });
       }
 
       const reconcileTips = pruned ? await this.localData.getL2Tips() : localTips;
@@ -222,13 +243,15 @@ export class L2BlockStream {
   }
 
   /**
-   * Downloads every block from the post-prune cursor through the source's proposed tip, emitting `blocks-added`
-   * events. The return value gates tier-cursor advancement (pass atomicity): tier tips may only be reconciled when
-   * the plan that backs them ran to the proposed tip.
-   * @returns `true` if the plan completed (caught up, or delivered the proposed tip with a matching hash); `false` if
-   * the source no longer has a promised block, or served a fork at the proposed height mid-pass.
+   * Delivers every block from the agreed-on point through the advertised proposed tip as `blocks-added` events,
+   * aborting the pass when the source's own answers prove that tip is no longer real.
+   * @returns The delivered tip's header, so the caller can avoid a re-fetch; undefined when there was nothing to
+   * download (already at the tip, or startingBlock past it).
    */
-  private async downloadBlocks(latestBlockNumber: BlockNumber, sourceTips: LocalL2Tips): Promise<boolean> {
+  private async downloadBlocks(
+    latestBlockNumber: BlockNumber,
+    sourceTips: LocalL2Tips,
+  ): Promise<BlockHeader | undefined> {
     // The post-prune cursor: the highest block number both sides agree on. Block downloads resume from here.
     let nextBlockNumber = latestBlockNumber + 1;
 
@@ -258,12 +281,12 @@ export class L2BlockStream {
       if (blocks.length === 0) {
         // The source no longer has a block the snapshot promised: the snapshot is provably stale, so report the plan
         // incomplete and skip reconciliation this pass.
-        this.log.warn(`Block source returned no blocks for a promised range; skipping reconciliation this pass`, {
+        this.log.warn(`Block source returned no blocks for a promised range; aborting this sync pass`, {
           from: nextBlockNumber,
           limit,
           sourceProposed: sourceTips.proposed.number,
         });
-        return false;
+        throw new AbortError();
       }
       await this.emitEvent({ type: 'blocks-added', blocks });
       lastDeliveredBlock = blocks.at(-1)!;
@@ -271,22 +294,23 @@ export class L2BlockStream {
     }
 
     if (lastDeliveredBlock === undefined) {
-      // Loop never ran: caught up before the plan started, or startingBlock past the tip (A-1061). Trivially complete.
-      return true;
+      // Loop never ran (caught up before the plan started, or startingBlock past the tip, see A-1061), so nothing
+      // was downloaded that could disprove the snapshot.
+      return undefined;
     }
 
-    // Complete iff the block delivered at the proposed height carries the snapshot's proposed hash; a different hash
-    // means a same-height fork swap happened mid-pass, so the snapshot is stale.
+    // The block delivered at the proposed height must carry the snapshot's proposed hash; a different hash means a
+    // same-height fork swap happened mid-pass, so the snapshot is stale.
     const deliveredHash = (await lastDeliveredBlock.hash()).toString();
     if (deliveredHash !== sourceTips.proposed.hash) {
-      this.log.warn(`Delivered proposed-block hash differs from snapshot; skipping reconciliation this pass`, {
+      this.log.warn(`Delivered proposed-block hash differs from snapshot; aborting this sync pass`, {
         blockNumber: lastDeliveredBlock.number,
         deliveredHash,
         snapshotHash: sourceTips.proposed.hash,
       });
-      return false;
+      throw new AbortError();
     }
-    return true;
+    return lastDeliveredBlock.header;
   }
 
   /**
@@ -342,6 +366,16 @@ export class L2BlockStream {
       .then(hash => hash?.toString());
   }
 
+  private getHeaderFromSource(hash: string): Promise<BlockHeader | undefined> {
+    return this.l2BlockSource
+      .getBlockData({ hash: BlockHash.fromString(hash) })
+      .then(data => data?.header)
+      .catch(err => {
+        this.log.error(`Failed to read header for block`, err, { blockHash: hash });
+        return undefined;
+      });
+  }
+
   private async emitEvent(event: L2BlockStreamEvent) {
     this.log.debug(
       `Emitting ${event.type} (${
@@ -359,6 +393,9 @@ export class L2BlockStream {
   }
 }
 
+/** A speculative proposed-tip header read, tagged with the hash it targets so a moved tip is detectable. */
+type ProposedHeaderPrefetch = { hash: string; header: Promise<BlockHeader | undefined> };
+
 class BlockHashCache {
   private readonly cache: Map<number, string> = new Map();
 

package/src/block/test/l2_tips_store_test_suite.ts

@@ -10,6 +10,7 @@ import {
   type L2TipId,
 } from '@aztec/stdlib/block';
 import { Checkpoint, L1PublishedData, PublishedCheckpoint } from '@aztec/stdlib/checkpoint';
+import { BlockHeader } from '@aztec/stdlib/tx';
 
 import { expect } from 'vitest';
 
@@ -132,6 +133,7 @@ export function testL2TipsStore(makeTipsStore: () => Promise<L2TipsStore>) {
     await tipsStore.handleBlockStreamEvent({
       type: 'chain-proposed',
       block: { number: BlockNumber(5), hash: new Fr(500).toString() },
+      header: BlockHeader.empty(),
     });
 
     const tips = await tipsStore.getL2Tips();
@@ -145,10 +147,12 @@ export function testL2TipsStore(makeTipsStore: () => Promise<L2TipsStore>) {
     await tipsStore.handleBlockStreamEvent({
       type: 'chain-proposed',
       block: { number: BlockNumber(4), hash: new Fr(400).toString() },
+      header: BlockHeader.empty(),
     });
     await tipsStore.handleBlockStreamEvent({
       type: 'chain-proposed',
       block: { number: BlockNumber(9), hash: new Fr(900).toString() },
+      header: BlockHeader.empty(),
     });
 
     // Both recorded heights resolve; the heights between them were never seen and stay undefined.
@@ -165,6 +169,7 @@ export function testL2TipsStore(makeTipsStore: () => Promise<L2TipsStore>) {
     await tipsStore.handleBlockStreamEvent({
       type: 'chain-proposed',
       block: { number: BlockNumber(9), hash: new Fr(900).toString() },
+      header: BlockHeader.empty(),
     });
 
     // Record sparse witnesses at heights below the tip (e.g. a consumer materializing per-height state).